class
OpacityCasterSettings
OpacityCasterSettings is the interface used to manage settings for an opacity caster. IMPORTANT: Make sure to set the OpacityChannel setting to the channel you want to cast, since this caster bakes opacity rather than the channel set in the MaterialChannel setting like most other casters.
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. |
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. |
MaterialChannel | The name of the input material channel to cast. Existing user channels of any arbitrary name in the input materials can be cast. |
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. |
OpacityChannelComponent | The component in the opacity channel to use as opacity value. |
OutputDDSCompressionType | DDS compression if output format is DDS. |
OutputImageFileFormat | File format for output texture. |
OutputOpacityType | The opacity type determines how the opacity channel of this material should be saved. To make (0.0->1.0) map to (transparent-opaque), use 'Opacity'. To make (0.0->1.0) map to (opaque-transparent), use 'Transparency' |
OutputPixelFormat | The output pixel format |
OutputSRGB | If set, output textures are exported in sRGB format. Input texture format is determined by the flag in the corresponding texture node in the material definition. |
UseMultisampling | Enable or disable multisampling. |
Methods
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 spOpacityCasterSettings, and if this is the case, returns the object cast into spOpacityCasterSettings. |
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
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 |
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
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
OpacityChannelComponent
The component in the opacity channel to use as opacity value.
Syntax
SetOpacityChannelComponent parameters
Type | Name | Min | Max | Description |
EColorComponent | value | | | The desired component in the opacity material channel to use as opacity value. |
GetOpacityChannelComponent return value
Type: EColorComponent
Default: Red
Key | Value | Comment |
Red | 0 | Red color component |
Green | 1 | Green color component |
Blue | 2 | Blue color component |
Alpha | 3 | Alpha color component |
Syntax
SetOpacityChannelComponent parameters
Type | Name | Min | Max | Description |
EColorComponent | value | | | The desired component in the opacity material channel to use as opacity value. |
GetOpacityChannelComponent return value
Type: ``````
Default: Red
Key | Value | Comment |
Red | 0 | Red color component |
Green | 1 | Green color component |
Blue | 2 | Blue color component |
Alpha | 3 | Alpha color component |
Syntax
SetOpacityChannelComponent parameters
Name | Type | Min | Max | Description |
value | EColorComponent | | | The desired component in the opacity material channel to use as opacity value. |
GetOpacityChannelComponent return value
Type: EColorComponent
Default: Red
Key | Value | Comment |
EColorComponent_Red | 0 | Red color component |
EColorComponent_Green | 1 | Green color component |
EColorComponent_Blue | 2 | Blue color component |
EColorComponent_Alpha | 3 | Alpha color component |
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 | |
OutputOpacityType
The opacity type determines how the opacity channel of this material should be saved. To make (0.0->1.0) map to (transparent-opaque), use 'Opacity'. To make (0.0->1.0) map to (opaque-transparent), use 'Transparency'
Syntax
SetOutputOpacityType parameters
Type | Name | Min | Max | Description |
EOpacityType | value | | | The new opacity type. |
GetOutputOpacityType return value
Type: EOpacityType
Default: Opacity
Key | Value | Comment |
Opacity | 0 | The level of transparency is defined from 0.0->1.0, where 0.0 is fully transparent and 1.0 is fully opaque. |
Transparency | 1 | The level of transparency is defined from 1.0->0.0, where 1.0 is fully transparent and 0.0 is fully opaque. |
Syntax
SetOutputOpacityType parameters
Type | Name | Min | Max | Description |
EOpacityType | value | | | The new opacity type. |
GetOutputOpacityType return value
Type: ``````
Default: Opacity
Key | Value | Comment |
Opacity | 0 | The level of transparency is defined from 0.0->1.0, where 0.0 is fully transparent and 1.0 is fully opaque. |
Transparency | 1 | The level of transparency is defined from 1.0->0.0, where 1.0 is fully transparent and 0.0 is fully opaque. |
Syntax
SetOutputOpacityType parameters
Name | Type | Min | Max | Description |
value | EOpacityType | | | The new opacity type. |
GetOutputOpacityType return value
Type: EOpacityType
Default: Opacity
Key | Value | Comment |
EOpacityType_Opacity | 0 | The level of transparency is defined from 0.0->1.0, where 0.0 is fully transparent and 1.0 is fully opaque. |
EOpacityType_Transparency | 1 | The level of transparency is defined from 1.0->0.0, where 1.0 is fully transparent and 0.0 is fully opaque. |
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 |
OutputSRGB
If set, output textures are exported in sRGB format. Input texture format is determined by the flag in the corresponding texture node in the material definition.
Syntax
SetOutputSRGB parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired sRGB flag. |
GetOutputSRGB return value
Type: bool
Default: false
Syntax
SetOutputSRGB parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired sRGB flag. |
GetOutputSRGB return value
Type: bool
Default: false
Syntax
SetOutputSRGB parameters
Name | Type | Min | Max | Description |
value | bool | | | The desired sRGB flag. |
GetOutputSRGB return value
Type: bool
Default: false
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
GetBoolParameter
Get a named parameter boolean value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: bool
GetClass
Get the name of the OpacityCasterSettings 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
GetDoubleParameter
Get a named parameter floating point value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: double
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: double
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: float
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
GetIntParameter
Get a named parameter integer value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: int
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: int
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: int
GetStringParameter
Get a named parameter string value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: spString
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: string
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: str
GetUIntParameter
Get a named parameter unsigned integer value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
Return value
Type: unsigned int
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
Return value
Type: uint
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
Return value
Type: int
IsA
Returns true if OpacityCasterSettings 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 OpacityCasterSettings 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 OpacityCasterSettings 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 OpacityCasterSettings is, or is a descendant of. |
Return value
Type: bool
IsNull
Returns true if the OpacityCasterSettings 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
SetBoolParameter
Set a named parameter boolean value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
bool | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
bool | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | bool | | | New value for parameter. |
Return value
Type: bool
SetDoubleParameter
Set a named parameter floating point value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
double | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
double | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | float | | | New value for parameter. |
Return value
Type: bool
SetIntParameter
Set a named parameter integer value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
int | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
int | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | int | | | New value for parameter. |
Return value
Type: bool
SetStringParameter
Set a named parameter string value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
const char * | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
string | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | str | | | New value for parameter. |
Return value
Type: bool
SetUIntParameter
Set a named parameter unsigned integer value.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | name | | | Parameter name. |
unsigned int | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
string | name | | | Parameter name. |
uint | value | | | New value for parameter. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
name | str | | | Parameter name. |
value | int | | | New value for parameter. |
Return value
Type: bool
ToJSON
Get settings as JSON for debugging purposes.
Syntax
Parameters
ToJSON takes no parameters.
Return value
Type: spString
Syntax
Parameters
ToJSON takes no parameters.
Return value
Type: string
Syntax
Parameters
ToJSON takes no parameters.
Return value
Type: str
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 spOpacityCasterSettings, and if this is the case, returns the object cast into spOpacityCasterSettings.
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: OpacityCasterSettings
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: OpacityCasterSettings
Syntax
Parameters
Name | Type | Min | Max | Description |
object | Object | | | Object to cast. |
Return value
Type: OpacityCasterSettings