class DisplacementCasterSettings
DisplacementCasterSettings is used to store the settings for a displacement caster
Properties
| Property | Description |
|---|
| Dilation | The Dilation value. Where applicable, such as colors and normals, the caster will fill empty pixels surrounding filled pixels with values mixed from the filled ones. This setting sets how many pixels to fill outside the original filled pixels. |
| DistanceScaling | All the delta values are divided by this value before storing them into an image. |
| DitherType | The type of dithering to use when creating the output object. |
| FillMode | The fill mode determines what to do with the pixels that remain unfilled after both the casting and dilation has been performed. Options are: None = Do not fill remaining pixels Interpolate = linearly interpolate the closest samples NearestNeighbor = use the closest available pixel value without interpolation. |
| GenerateScalarDisplacement | If set to true, the size of the displacement vector components in the direction of the interpolated normal are stored in the displacement map, instead of the displacement vectors. |
| GenerateTangentSpaceDisplacement | If set, the displacement vectors are transformed into the destination object tangent space. |
| MaterialChannel | The name of the input material channel to cast. Existing user channels of any arbitrary name in the input materials can be cast. |
| NormalMapTexCoordLevel | The texture coordinate level to use for the tangent space displacement vectors. |
| OpacityChannel | The name of the input opacity channel to use for combining layers in most casters and casting opacity in the opacitycaster. User channels of any arbitrary name can be used. |
| OutputDDSCompressionType | DDS compression if output format is DDS. |
| OutputImageFileFormat | File format for output texture. |
| OutputPixelFormat | The output pixel format |
| UseMultisampling | Enable or disable multisampling. |
Methods
| Method | Description |
|---|
| GetClass | Get the name of the DisplacementCasterSettings class. |
| GetErrorString | Returns a string describing the error that was found the last time ValidateSettings was performed. |
| IsA | Returns true if DisplacementCasterSettings is a or is a descendant of the class named as the type parameter. |
| IsNull | Returns true if the DisplacementCasterSettings object is invalid. |
| ValidateSettings | Validates the current settings values. |
Static methods
| Method | Description |
|---|
| IsClassA | Returns true if the class is a or is a descendant of the class named as the type parameter. |
| SafeCast | SafeCast makes sure the input object is of a class that can be cast into spDisplacementCasterSettings, and if this is the case, returns the object cast into spDisplacementCasterSettings. |
Properties details
Dilation
The Dilation value. Where applicable, such as colors and normals, the caster will fill empty pixels surrounding filled pixels with values mixed from the filled ones. This setting sets how many pixels to fill outside the original filled pixels.
Syntax
SetDilation parameters
| Type | Name | Min | Max | Description |
|---|
unsigned int | value | 0 | 1000 | The value to which Dilation will be set. |
GetDilation return value
Type: unsigned int
Default: 0
Syntax
SetDilation parameters
| Type | Name | Min | Max | Description |
|---|
uint | value | 0 | 1000 | The value to which Dilation will be set. |
GetDilation return value
Type: uint
Default: 0
Syntax
SetDilation parameters
| Name | Type | Min | Max | Description |
|---|
| value | int | 0 | 1000 | The value to which Dilation will be set. |
GetDilation return value
Type: int
Default: 0
DistanceScaling
All the delta values are divided by this value before storing them into an image.
Syntax
SetDistanceScaling parameters
| Type | Name | Min | Max | Description |
|---|
real | value | 0 | REAL_MAX | The desired DistanceScaling value. |
GetDistanceScaling return value
Type: real
Default: 1.0
Syntax
SetDistanceScaling parameters
| Type | Name | Min | Max | Description |
|---|
float | value | 0 | REAL_MAX | The desired DistanceScaling value. |
GetDistanceScaling return value
Type: float
Default: 1.0
Syntax
SetDistanceScaling parameters
| Name | Type | Min | Max | Description |
|---|
| value | float | 0 | REAL_MAX | The desired DistanceScaling value. |
GetDistanceScaling return value
Type: float
Default: 1.0
DitherType
The type of dithering to use when creating the output object.
Syntax
SetDitherType parameters
| Type | Name | Min | Max | Description |
|---|
| EDitherPatterns | value | | | The desired value of the DitherType to use. |
GetDitherType return value
Type: EDitherPatterns
Default: FloydSteinberg
| Key | Value | Comment |
|---|
| NoDither | 0 | Use no dithering |
| FloydSteinberg | 1 | Use Floys-Steinberg dithering |
| JarvisJudiceNinke | 2 | Use Jarvis, Judice, and Ninke dithering |
| Sierra | 3 | Use Sierra-3 (three row) dithering |
Syntax
SetDitherType parameters
| Type | Name | Min | Max | Description |
|---|
| EDitherPatterns | value | | | The desired value of the DitherType to use. |
GetDitherType return value
Type: ``````
Default: FloydSteinberg
| Key | Value | Comment |
|---|
| NoDither | 0 | Use no dithering |
| FloydSteinberg | 1 | Use Floys-Steinberg dithering |
| JarvisJudiceNinke | 2 | Use Jarvis, Judice, and Ninke dithering |
| Sierra | 3 | Use Sierra-3 (three row) dithering |
Syntax
SetDitherType parameters
| Name | Type | Min | Max | Description |
|---|
| value | EDitherPatterns | | | The desired value of the DitherType to use. |
GetDitherType return value
Type: EDitherPatterns
Default: FloydSteinberg
| Key | Value | Comment |
|---|
| EDitherPatterns_NoDither | 0 | Use no dithering |
| EDitherPatterns_FloydSteinberg | 1 | Use Floys-Steinberg dithering |
| EDitherPatterns_JarvisJudiceNinke | 2 | Use Jarvis, Judice, and Ninke dithering |
| EDitherPatterns_Sierra | 3 | Use Sierra-3 (three row) dithering |
FillMode
The fill mode determines what to do with the pixels that remain unfilled after both the casting and dilation has been performed. Options are: None = Do not fill remaining pixels Interpolate = linearly interpolate the closest samples NearestNeighbor = use the closest available pixel value without interpolation.
Syntax
SetFillMode parameters
| Type | Name | Min | Max | Description |
|---|
| EAtlasFillMode | value | | | The mode to which the fill mode will be set. |
GetFillMode return value
Type: EAtlasFillMode
Default: Interpolate
| Key | Value | Comment |
|---|
| Interpolate | 0 | linearly interpolate the closest samples |
| NearestNeighbor | 1 | use the closest available pixel value without interpolation |
| NoFill | 2 | Do not fill remaining pixels |
Syntax
SetFillMode parameters
| Type | Name | Min | Max | Description |
|---|
| EAtlasFillMode | value | | | The mode to which the fill mode will be set. |
GetFillMode return value
Type: ``````
Default: Interpolate
| Key | Value | Comment |
|---|
| Interpolate | 0 | linearly interpolate the closest samples |
| NearestNeighbor | 1 | use the closest available pixel value without interpolation |
| NoFill | 2 | Do not fill remaining pixels |
Syntax
SetFillMode parameters
| Name | Type | Min | Max | Description |
|---|
| value | EAtlasFillMode | | | The mode to which the fill mode will be set. |
GetFillMode return value
Type: EAtlasFillMode
Default: Interpolate
| Key | Value | Comment |
|---|
| EAtlasFillMode_Interpolate | 0 | linearly interpolate the closest samples |
| EAtlasFillMode_NearestNeighbor | 1 | use the closest available pixel value without interpolation |
| EAtlasFillMode_NoFill | 2 | Do not fill remaining pixels |
GenerateScalarDisplacement
If set to true, the size of the displacement vector components in the direction of the interpolated normal are stored in the displacement map, instead of the displacement vectors.
Syntax
SetGenerateScalarDisplacement parameters
| Type | Name | Min | Max | Description |
|---|
bool | value | | | The desired GenerateScalarDisplacement flag. |
GetGenerateScalarDisplacement return value
Type: bool
Default: false
Syntax
SetGenerateScalarDisplacement parameters
| Type | Name | Min | Max | Description |
|---|
bool | value | | | The desired GenerateScalarDisplacement flag. |
GetGenerateScalarDisplacement return value
Type: bool
Default: false
Syntax
SetGenerateScalarDisplacement parameters
| Name | Type | Min | Max | Description |
|---|
| value | bool | | | The desired GenerateScalarDisplacement flag. |
GetGenerateScalarDisplacement return value
Type: bool
Default: false
GenerateTangentSpaceDisplacement
If set, the displacement vectors are transformed into the destination object tangent space.
Syntax
SetGenerateTangentSpaceDisplacement parameters
| Type | Name | Min | Max | Description |
|---|
bool | value | | | The desired GenerateTangentSpaceDisplacement flag. |
GetGenerateTangentSpaceDisplacement return value
Type: bool
Default: true
Syntax
SetGenerateTangentSpaceDisplacement parameters
| Type | Name | Min | Max | Description |
|---|
bool | value | | | The desired GenerateTangentSpaceDisplacement flag. |
GetGenerateTangentSpaceDisplacement return value
Type: bool
Default: true
Syntax
SetGenerateTangentSpaceDisplacement parameters
| Name | Type | Min | Max | Description |
|---|
| value | bool | | | The desired GenerateTangentSpaceDisplacement flag. |
GetGenerateTangentSpaceDisplacement return value
Type: bool
Default: true
MaterialChannel
The name of the input material channel to cast. Existing user channels of any arbitrary name in the input materials can be cast.
Syntax
SetMaterialChannel parameters
| Type | Name | Min | Max | Description |
|---|
const char * | value | | | The input material channel name. |
GetMaterialChannel return value
Type: spString
Default: nullptr
Syntax
SetMaterialChannel parameters
| Type | Name | Min | Max | Description |
|---|
string | value | | | The input material channel name. |
GetMaterialChannel return value
Type: string
Default: null
Syntax
SetMaterialChannel parameters
| Name | Type | Min | Max | Description |
|---|
| value | str | | | The input material channel name. |
GetMaterialChannel return value
Type: str
Default: None
NormalMapTexCoordLevel
The texture coordinate level to use for the tangent space displacement vectors.
Syntax
SetNormalMapTexCoordLevel parameters
| Type | Name | Min | Max | Description |
|---|
rid | value | 0 | UINT_MAX | The desired NormalMapTextureLevel value. |
GetNormalMapTexCoordLevel return value
Type: rid
Default: -1
Syntax
SetNormalMapTexCoordLevel parameters
| Type | Name | Min | Max | Description |
|---|
rid | value | 0 | UINT_MAX | The desired NormalMapTextureLevel value. |
GetNormalMapTexCoordLevel return value
Type: rid
Default: -1
Syntax
SetNormalMapTexCoordLevel parameters
| Name | Type | Min | Max | Description |
|---|
| value | int | 0 | UINT_MAX | The desired NormalMapTextureLevel value. |
GetNormalMapTexCoordLevel return value
Type: int
Default: -1
OpacityChannel
The name of the input opacity channel to use for combining layers in most casters and casting opacity in the opacitycaster. User channels of any arbitrary name can be used.
Syntax
SetOpacityChannel parameters
| Type | Name | Min | Max | Description |
|---|
const char * | value | | | The desired material channel. |
GetOpacityChannel return value
Type: spString
Default: Opacity
Syntax
SetOpacityChannel parameters
| Type | Name | Min | Max | Description |
|---|
string | value | | | The desired material channel. |
GetOpacityChannel return value
Type: string
Default: Opacity
Syntax
SetOpacityChannel parameters
| Name | Type | Min | Max | Description |
|---|
| value | str | | | The desired material channel. |
GetOpacityChannel return value
Type: str
Default: Opacity
OutputDDSCompressionType
DDS compression if output format is DDS.
Syntax
SetOutputDDSCompressionType parameters
GetOutputDDSCompressionType return value
Type: EDDSCompressionType
Default: NoCompression
| Key | Value | Comment |
|---|
| NoCompression | -1 | |
| BC1 | 0 | |
| BC2 | 1 | |
| BC3 | 2 | |
| BC4 | 3 | |
| BC5 | 4 | |
Syntax
SetOutputDDSCompressionType parameters
GetOutputDDSCompressionType return value
Type: ``````
Default: NoCompression
| Key | Value | Comment |
|---|
| NoCompression | -1 | |
| BC1 | 0 | |
| BC2 | 1 | |
| BC3 | 2 | |
| BC4 | 3 | |
| BC5 | 4 | |
Syntax
SetOutputDDSCompressionType parameters
GetOutputDDSCompressionType return value
Type: EDDSCompressionType
Default: NoCompression
| Key | Value | Comment |
|---|
| EDDSCompressionType_NoCompression | -1 | |
| EDDSCompressionType_BC1 | 0 | |
| EDDSCompressionType_BC2 | 1 | |
| EDDSCompressionType_BC3 | 2 | |
| EDDSCompressionType_BC4 | 3 | |
| EDDSCompressionType_BC5 | 4 | |
File format for output texture.
Syntax
Type: EImageOutputFormat
Default: PNG
| Key | Value | Comment |
|---|
| BMP | 0 | |
| DDS | 1 | |
| JPEG | 2 | |
| PNG | 3 | |
| TGA | 4 | |
| TIFF | 5 | |
Syntax
Type: ``````
Default: PNG
| Key | Value | Comment |
|---|
| BMP | 0 | |
| DDS | 1 | |
| JPEG | 2 | |
| PNG | 3 | |
| TGA | 4 | |
| TIFF | 5 | |
Syntax
Type: EImageOutputFormat
Default: PNG
| Key | Value | Comment |
|---|
| EImageOutputFormat_BMP | 0 | |
| EImageOutputFormat_DDS | 1 | |
| EImageOutputFormat_JPEG | 2 | |
| EImageOutputFormat_PNG | 3 | |
| EImageOutputFormat_TGA | 4 | |
| EImageOutputFormat_TIFF | 5 | |
The output pixel format
Syntax
| Type | Name | Min | Max | Description |
|---|
| EPixelFormat | value | | | The desired value to which OutputChannels will be set. |
Type: EPixelFormat
Default: R8G8B8A8
| Key | Value | Comment |
|---|
| R8G8B8A8 | 0 | RGBA color channels with 8 bit depth per color channel |
| R8G8B8 | 1 | RGB color channels with 8 bit depth per color channel |
| R8 | 2 | R color channel with 8 bit depth per color channel |
| R16G16B16A16 | 3 | RGBA color channels with 16 bit depth per color channel |
| R16G16B16 | 4 | RGB color channels with 16 bit depth per color channel |
| R16 | 5 | R color channel with 16 bit depth per color channel |
Syntax
| Type | Name | Min | Max | Description |
|---|
| EPixelFormat | value | | | The desired value to which OutputChannels will be set. |
Type: ``````
Default: R8G8B8A8
| Key | Value | Comment |
|---|
| R8G8B8A8 | 0 | RGBA color channels with 8 bit depth per color channel |
| R8G8B8 | 1 | RGB color channels with 8 bit depth per color channel |
| R8 | 2 | R color channel with 8 bit depth per color channel |
| R16G16B16A16 | 3 | RGBA color channels with 16 bit depth per color channel |
| R16G16B16 | 4 | RGB color channels with 16 bit depth per color channel |
| R16 | 5 | R color channel with 16 bit depth per color channel |
Syntax
| Name | Type | Min | Max | Description |
|---|
| value | EPixelFormat | | | The desired value to which OutputChannels will be set. |
Type: EPixelFormat
Default: R8G8B8A8
| Key | Value | Comment |
|---|
| EPixelFormat_R8G8B8A8 | 0 | RGBA color channels with 8 bit depth per color channel |
| EPixelFormat_R8G8B8 | 1 | RGB color channels with 8 bit depth per color channel |
| EPixelFormat_R8 | 2 | R color channel with 8 bit depth per color channel |
| EPixelFormat_R16G16B16A16 | 3 | RGBA color channels with 16 bit depth per color channel |
| EPixelFormat_R16G16B16 | 4 | RGB color channels with 16 bit depth per color channel |
| EPixelFormat_R16 | 5 | R color channel with 16 bit depth per color channel |
UseMultisampling
Enable or disable multisampling.
Syntax
SetUseMultisampling parameters
| Type | Name | Min | Max | Description |
|---|
bool | value | | | The desired value of the flag. |
GetUseMultisampling return value
Type: bool
Default: true
Syntax
SetUseMultisampling parameters
| Type | Name | Min | Max | Description |
|---|
bool | value | | | The desired value of the flag. |
GetUseMultisampling return value
Type: bool
Default: true
Syntax
SetUseMultisampling parameters
| Name | Type | Min | Max | Description |
|---|
| value | bool | | | The desired value of the flag. |
GetUseMultisampling return value
Type: bool
Default: true
Methods details
GetClass
Get the name of the DisplacementCasterSettings class.
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: spString
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: string
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: str
GetErrorString
Returns a string describing the error that was found the last time ValidateSettings was performed.
Syntax
Parameters
GetErrorString takes no parameters.
Return value
Type: spString
Syntax
Parameters
GetErrorString takes no parameters.
Return value
Type: string
Syntax
Parameters
GetErrorString takes no parameters.
Return value
Type: str
IsA
Returns true if DisplacementCasterSettings is a or is a descendant of the class named as the type parameter.
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
const char * | type | | | Name of the class to check if DisplacementCasterSettings is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
string | type | | | Name of the class to check if DisplacementCasterSettings is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Name | Type | Min | Max | Description |
|---|
| type | str | | | Name of the class to check if DisplacementCasterSettings is, or is a descendant of. |
Return value
Type: bool
IsNull
Returns true if the DisplacementCasterSettings object is invalid.
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
ValidateSettings
Validates the current settings values.
Syntax
Parameters
ValidateSettings takes no parameters.
Return value
Type: bool
Syntax
Parameters
ValidateSettings takes no parameters.
Return value
Type: bool
Syntax
Parameters
ValidateSettings takes no parameters.
Return value
Type: bool
Static methods details
IsClassA
Returns true if the class is a or is a descendant of the class named as the type parameter.
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
const char * | type | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
string | type | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Name | Type | Min | Max | Description |
|---|
| type | str | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
SafeCast
SafeCast makes sure the input object is of a class that can be cast into spDisplacementCasterSettings, and if this is the case, returns the object cast into spDisplacementCasterSettings.
