class ColorCaster
ColorCaster is the interface used to cast basic color values. Currently supported material color value types are Ambient, Diffuse and Specular + Shininess.
Properties
| Property | Description |
|---|
| DestMaterialId | The DestMaterialId object. If set, only the parts of the destination map that. To disable, set to -1. |
| MappingImage | The MappingImage object. The MappingImage object contains the mapping between the Geometry and SourceGeometry objects. |
| OutputFilePath | The OutputFilePath file path, where the output image will be placed. Note that the extension will be appended the file path if it differs from the OutputImageFileFormat set in the caster settings object. Either OutputImage or OutputFilePath must be set. If OutputImage is set, then OutputFilePath is ignored. |
| OutputImage | The OutputImage object that will receive the image. The current contents of the image will be removed, and the image will be written to the Colors field of the ImageData object. Either OutputImage or OutputFilePath must be set. If OutputImage is set, then OutputFilePath is ignored. |
| SourceMaterials | The SourceMaterials object. The SourceMaterials object contains all materials of the the source geometry. The source geometry must have a "MaterialIds" field that indices the material table. |
| SourceTextures | The SourceTextures object. The SourceTextures object contains all textures of the the source geometry. |
Methods
| Method | Description |
|---|
| Clear | Clear all internal states of the object. This will NOT clear the parameters set in the object. |
| GetClass | Get the name of the ColorCaster class. |
| GetColorCasterSettings | The color caster settings object. |
| GetLastCastingWasSkipped | If SkipCastingIfNoInputChannel is set to true, and the last processing skipped, the LastCastingWasSkipped will be set to true. The initial value before the first process will be set to false. |
| GetMaterialCasterSettings | The settings object. |
| GetPercentDone | Returns the current progress of the processing as a value between 0 and 100. |
| IsA | Returns true if ColorCaster is a or is a descendant of the class named as the type parameter. |
| IsNull | Returns true if the ColorCaster object is invalid. |
| RunProcessing | Runs the processing the object is designed for. |
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 spColorCaster, and if this is the case, returns the object cast into spColorCaster. |
Properties details
DestMaterialId
The DestMaterialId object. If set, only the parts of the destination map that. To disable, set to -1.
Syntax
SetDestMaterialId parameters
| Type | Name | Min | Max | Description |
|---|
rid | value | | | The value to which DestMaterialId will be set. |
GetDestMaterialId return value
Type: rid
Syntax
SetDestMaterialId parameters
| Type | Name | Min | Max | Description |
|---|
rid | value | | | The value to which DestMaterialId will be set. |
GetDestMaterialId return value
Type: rid
Syntax
SetDestMaterialId parameters
| Name | Type | Min | Max | Description |
|---|
| value | int | | | The value to which DestMaterialId will be set. |
GetDestMaterialId return value
Type: int
MappingImage
The MappingImage object. The MappingImage object contains the mapping between the Geometry and SourceGeometry objects.
Syntax
SetMappingImage parameters
| Type | Name | Min | Max | Description |
|---|
| MappingImage | value | | | The mapping image to which MappingImage will be set. |
GetMappingImage return value
Type: MappingImage
Syntax
SetMappingImage parameters
| Type | Name | Min | Max | Description |
|---|
| MappingImage | value | | | The mapping image to which MappingImage will be set. |
GetMappingImage return value
Type: MappingImage
Syntax
SetMappingImage parameters
| Name | Type | Min | Max | Description |
|---|
| value | MappingImage | | | The mapping image to which MappingImage will be set. |
GetMappingImage return value
Type: MappingImage
OutputFilePath
The OutputFilePath file path, where the output image will be placed. Note that the extension will be appended the file path if it differs from the OutputImageFileFormat set in the caster settings object. Either OutputImage or OutputFilePath must be set. If OutputImage is set, then OutputFilePath is ignored.
Syntax
SetOutputFilePath parameters
| Type | Name | Min | Max | Description |
|---|
const char * | value | | | The string to which OutputFilePath will be set. |
GetOutputFilePath return value
Type: spString
Syntax
SetOutputFilePath parameters
| Type | Name | Min | Max | Description |
|---|
string | value | | | The string to which OutputFilePath will be set. |
GetOutputFilePath return value
Type: string
Syntax
SetOutputFilePath parameters
| Name | Type | Min | Max | Description |
|---|
| value | str | | | The string to which OutputFilePath will be set. |
GetOutputFilePath return value
Type: str
OutputImage
The OutputImage object that will receive the image. The current contents of the image will be removed, and the image will be written to the Colors field of the ImageData object. Either OutputImage or OutputFilePath must be set. If OutputImage is set, then OutputFilePath is ignored.
Syntax
SetOutputImage parameters
| Type | Name | Min | Max | Description |
|---|
| ImageData | value | | | The image data to which OutputImage will be set. |
GetOutputImage return value
Type: ImageData
Syntax
SetOutputImage parameters
| Type | Name | Min | Max | Description |
|---|
| ImageData | value | | | The image data to which OutputImage will be set. |
GetOutputImage return value
Type: ImageData
Syntax
SetOutputImage parameters
| Name | Type | Min | Max | Description |
|---|
| value | ImageData | | | The image data to which OutputImage will be set. |
GetOutputImage return value
Type: ImageData
SourceMaterials
The SourceMaterials object. The SourceMaterials object contains all materials of the the source geometry. The source geometry must have a "MaterialIds" field that indices the material table.
Syntax
SetSourceMaterials parameters
| Type | Name | Min | Max | Description |
|---|
| MaterialTable | value | | | The material table to which SourceMaterials will be set. |
GetSourceMaterials return value
Type: MaterialTable
Syntax
SetSourceMaterials parameters
| Type | Name | Min | Max | Description |
|---|
| MaterialTable | value | | | The material table to which SourceMaterials will be set. |
GetSourceMaterials return value
Type: MaterialTable
Syntax
SetSourceMaterials parameters
| Name | Type | Min | Max | Description |
|---|
| value | MaterialTable | | | The material table to which SourceMaterials will be set. |
GetSourceMaterials return value
Type: MaterialTable
SourceTextures
The SourceTextures object. The SourceTextures object contains all textures of the the source geometry.
Syntax
SetSourceTextures parameters
| Type | Name | Min | Max | Description |
|---|
| TextureTable | value | | | The texture table to which SourceTextures will be set. |
GetSourceTextures return value
Type: TextureTable
Syntax
SetSourceTextures parameters
| Type | Name | Min | Max | Description |
|---|
| TextureTable | value | | | The texture table to which SourceTextures will be set. |
GetSourceTextures return value
Type: TextureTable
Syntax
SetSourceTextures parameters
| Name | Type | Min | Max | Description |
|---|
| value | TextureTable | | | The texture table to which SourceTextures will be set. |
GetSourceTextures return value
Type: TextureTable
Methods details
Clear
Clear all internal states of the object. This will NOT clear the parameters set in the object.
Syntax
Parameters
Clear takes no parameters.
Syntax
Parameters
Clear takes no parameters.
Syntax
Parameters
Clear takes no parameters.
GetClass
Get the name of the ColorCaster 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
GetColorCasterSettings
The color caster settings object.
Syntax
Parameters
GetColorCasterSettings takes no parameters.
Return value
Type: ColorCasterSettings
Syntax
Parameters
GetColorCasterSettings takes no parameters.
Return value
Type: ColorCasterSettings
Syntax
Parameters
GetColorCasterSettings takes no parameters.
Return value
Type: ColorCasterSettings
GetLastCastingWasSkipped
If SkipCastingIfNoInputChannel is set to true, and the last processing skipped, the LastCastingWasSkipped will be set to true. The initial value before the first process will be set to false.
Syntax
Parameters
GetLastCastingWasSkipped takes no parameters.
Return value
Type: bool
Syntax
Parameters
GetLastCastingWasSkipped takes no parameters.
Return value
Type: bool
Syntax
Parameters
GetLastCastingWasSkipped takes no parameters.
Return value
Type: bool
GetMaterialCasterSettings
The settings object.
GetPercentDone
Returns the current progress of the processing as a value between 0 and 100.
Syntax
Parameters
GetPercentDone takes no parameters.
Return value
Type: real
Syntax
Parameters
GetPercentDone takes no parameters.
Return value
Type: float
Syntax
Parameters
GetPercentDone takes no parameters.
Return value
Type: float
IsA
Returns true if ColorCaster 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 ColorCaster 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 ColorCaster 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 ColorCaster is, or is a descendant of. |
Return value
Type: bool
IsNull
Returns true if the ColorCaster 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
RunProcessing
Runs the processing the object is designed for.
Syntax
Parameters
RunProcessing takes no parameters.
Syntax
Parameters
RunProcessing takes no parameters.
Syntax
Parameters
RunProcessing takes no parameters.
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 spColorCaster, and if this is the case, returns the object cast into spColorCaster.
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
Object | object | | | Object to cast. |
Return value
Type: ColorCaster
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
Object | object | | | Object to cast. |
Return value
Type: ColorCaster
Syntax
Parameters
| Name | Type | Min | Max | Description |
|---|
| object | Object | | | Object to cast. |
Return value
Type: ColorCaster
