class
Parameterizer
Computes texture coordinates for arbitrary geometry.
Properties
Property | Description |
AutomaticTextureSizeMultiplier | Set/Get a texture dimension length multiplier for the automatic texture size. |
FeatureFlagsMask | The FeatureFlagsMask. Any edge that has one of the flags present as a feature edge, will have the edge forced as a parameterization feature. |
ForcePower2Texture | If automatic_texture_size is enabled, then force the texture sizes to be a power of 2. |
GutterSpace | The minimum number of pixels between charts for mapping image index 0. Use SetGutterSpaceForImageIndex to set for another mapping image index. |
InputMaterialCount | The number of input materials used in the original geometry for mapping to multiple output materials. This needs to be set before you can set any specific in-out material mapping. 0 signifies that no in-out material mapping is used, ie. the process will produce one resulting mapping image. |
LargeChartsImportance | Only used when computing new UVs. The importance value for trying to have as large and few charts as possible. The closer the value is to 1, the slower it is. Having 0 means no extra focus will be put on reducing the number of charts. Having value 1 means maximum focus will be put on reducing the number of charts and thereby increasing the size of the charts. |
MaxStretch | The maximum allowed texture stretch. Range 0->1. |
Name | The name of the Parameterizer object. (Inherited from Object) |
OutputMaterialCount | The number of output mapping images that are to be generated. Setup the mapping between input and output materials with SetInputOutputMaterialMapping. |
TextureHeight | The height of the texture to use for mapping image index 0. Use SetTextureHeightForImageIndex to set for another mapping image index. |
TextureWidth | The width of the texture to use for mapping image index 0. Use SetTextureWidthForImageIndex to set for another mapping image index. |
UseAutomaticTextureSize | The automatic_texture_size flag. If true, then texture sizes will be computed for the reduced mesh depending on its pixel size on screen. |
UseVertexWeights | If UseVertexWeights is enabled, the weights help determine the UV charts and their UV area. |
UseVisibilityWeights | If UseVisibilityWeights is enabled, the weights help determine the UV charts and their UV area. |
Methods
Method | Description |
AddObserver | Adds a user-defined observer object to the interface, that will receive events from the interface. (Inherited from Object) |
GetClass | Get the name of the Parameterizer class. (Inherited from Object) |
GetGutterSpaceForImageIndex | The minimum number of pixels between charts. |
GetInputOutputMaterialMapping | The previously set material mapping for matId. |
GetTextureHeightForImageIndex | The height of the texture to use. |
GetTextureWidthForImageIndex | The width of the texture to use. |
IsA | Returns true if Parameterizer is a or is a descendant of the class named as the type parameter. (Inherited from Object) |
IsNull | Returns true if the Parameterizer object is invalid. (Inherited from Object) |
IsSameObjectAs | Returns true if the Parameterizer object is valid. (Inherited from Object) |
NonNull | Returns true if the Parameterizer object is valid. (Inherited from Object) |
Parameterize | Executes the parameterization of the geometry. |
PrintInfo | Prints the content/info of the Parameterizer object to the log. (Inherited from Object) |
RemoveObserver | Removes a previously added observer object. (Inherited from Object) |
SetGutterSpaceForImageIndex | The minimum number of pixels between charts. |
SetInputOutputMaterialMapping | The material mapping for inMaterialId, meaning what material of the generated LOD inMaterialId will be baked into. Both InputMaterialCount and OutputMaterialCount need to be set for this mapping to work, and all original materials need to be mapped to an existing output id. |
SetTextureHeightForImageIndex | The height of the texture to use. |
SetTextureWidthForImageIndex | The width of the texture to use. |
Static methods
Method | Description |
IsClassA | Returns true if the class is a or is a descendant of the class named as the type parameter. (Inherited from Object) |
SafeCast | SafeCast makes sure the input object is of a class that can be cast into spParameterizer, and if this is the case, returns the object cast into spParameterizer. (Inherited from Object) |
Properties details
AutomaticTextureSizeMultiplier
Set/Get a texture dimension length multiplier for the automatic texture size.
Syntax
SetAutomaticTextureSizeMultiplier parameters
Type | Name | Min | Max | Description |
real | value | | | The desired multiplier. |
GetAutomaticTextureSizeMultiplier return value
Type: real
Syntax
SetAutomaticTextureSizeMultiplier parameters
Type | Name | Min | Max | Description |
float | value | | | The desired multiplier. |
GetAutomaticTextureSizeMultiplier return value
Type: float
Syntax
SetAutomaticTextureSizeMultiplier parameters
Name | Type | Min | Max | Description |
value | float | | | The desired multiplier. |
GetAutomaticTextureSizeMultiplier return value
Type: float
FeatureFlagsMask
The FeatureFlagsMask. Any edge that has one of the flags present as a feature edge, will have the edge forced as a parameterization feature.
Syntax
SetFeatureFlagsMask parameters
Type | Name | Min | Max | Description |
unsigned int | value | | | The mask to which FeatureFlagsMask will be set. |
GetFeatureFlagsMask return value
Type: unsigned int
Syntax
SetFeatureFlagsMask parameters
Type | Name | Min | Max | Description |
uint | value | | | The mask to which FeatureFlagsMask will be set. |
GetFeatureFlagsMask return value
Type: uint
Syntax
SetFeatureFlagsMask parameters
Name | Type | Min | Max | Description |
value | int | | | The mask to which FeatureFlagsMask will be set. |
GetFeatureFlagsMask return value
Type: int
ForcePower2Texture
If automatic_texture_size is enabled, then force the texture sizes to be a power of 2.
Syntax
SetForcePower2Texture parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired flag. |
GetForcePower2Texture return value
Type: bool
Syntax
SetForcePower2Texture parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired flag. |
GetForcePower2Texture return value
Type: bool
Syntax
SetForcePower2Texture parameters
Name | Type | Min | Max | Description |
value | bool | | | The desired flag. |
GetForcePower2Texture return value
Type: bool
GutterSpace
The minimum number of pixels between charts for mapping image index 0. Use SetGutterSpaceForImageIndex to set for another mapping image index.
Syntax
SetGutterSpace parameters
Type | Name | Min | Max | Description |
unsigned int | value | | | The desired value to which GutterSpace will be set. |
GetGutterSpace return value
Type: unsigned int
Syntax
SetGutterSpace parameters
Type | Name | Min | Max | Description |
uint | value | | | The desired value to which GutterSpace will be set. |
GetGutterSpace return value
Type: uint
Syntax
SetGutterSpace parameters
Name | Type | Min | Max | Description |
value | int | | | The desired value to which GutterSpace will be set. |
GetGutterSpace return value
Type: int
The number of input materials used in the original geometry for mapping to multiple output materials. This needs to be set before you can set any specific in-out material mapping. 0 signifies that no in-out material mapping is used, ie. the process will produce one resulting mapping image.
Syntax
Type | Name | Min | Max | Description |
unsigned int | value | | | The number of outputs. |
Type: unsigned int
Syntax
Type | Name | Min | Max | Description |
uint | value | | | The number of outputs. |
Type: uint
Syntax
Name | Type | Min | Max | Description |
value | int | | | The number of outputs. |
Type: int
LargeChartsImportance
Only used when computing new UVs. The importance value for trying to have as large and few charts as possible. The closer the value is to 1, the slower it is. Having 0 means no extra focus will be put on reducing the number of charts. Having value 1 means maximum focus will be put on reducing the number of charts and thereby increasing the size of the charts.
Syntax
SetLargeChartsImportance parameters
Type | Name | Min | Max | Description |
real | value | 0 | 1 | The desired large charts importance value. |
GetLargeChartsImportance return value
Type: real
Syntax
SetLargeChartsImportance parameters
Type | Name | Min | Max | Description |
float | value | 0 | 1 | The desired large charts importance value. |
GetLargeChartsImportance return value
Type: float
Syntax
SetLargeChartsImportance parameters
Name | Type | Min | Max | Description |
value | float | 0 | 1 | The desired large charts importance value. |
GetLargeChartsImportance return value
Type: float
MaxStretch
The maximum allowed texture stretch. Range 0->1.
Syntax
SetMaxStretch parameters
Type | Name | Min | Max | Description |
real | value | 0 | 1 | The desired value to which MaxStretch will be set. |
GetMaxStretch return value
Type: real
Syntax
SetMaxStretch parameters
Type | Name | Min | Max | Description |
float | value | 0 | 1 | The desired value to which MaxStretch will be set. |
GetMaxStretch return value
Type: float
Syntax
SetMaxStretch parameters
Name | Type | Min | Max | Description |
value | float | 0 | 1 | The desired value to which MaxStretch will be set. |
GetMaxStretch return value
Type: float
Name
The name of the Parameterizer object. (Inherited from Object)
Syntax
SetName parameters
Type | Name | Min | Max | Description |
const char * | name | | | New name of the object. |
GetName return value
Type: spString
Syntax
SetName parameters
Type | Name | Min | Max | Description |
string | name | | | New name of the object. |
GetName return value
Type: string
Syntax
SetName parameters
Name | Type | Min | Max | Description |
name | str | | | New name of the object. |
GetName return value
Type: str
OutputMaterialCount
The number of output mapping images that are to be generated. Setup the mapping between input and output materials with SetInputOutputMaterialMapping.
Syntax
SetOutputMaterialCount parameters
Type | Name | Min | Max | Description |
unsigned int | value | 1 | SG_MAXIMUM_PARAMETERIZER_OUTPUT_MATERIAL_COUNT | The number of outputs. |
GetOutputMaterialCount return value
Type: unsigned int
Syntax
SetOutputMaterialCount parameters
Type | Name | Min | Max | Description |
uint | value | 1 | SG_MAXIMUM_PARAMETERIZER_OUTPUT_MATERIAL_COUNT | The number of outputs. |
GetOutputMaterialCount return value
Type: uint
Syntax
SetOutputMaterialCount parameters
Name | Type | Min | Max | Description |
value | int | 1 | SG_MAXIMUM_PARAMETERIZER_OUTPUT_MATERIAL_COUNT | The number of outputs. |
GetOutputMaterialCount return value
Type: int
TextureHeight
The height of the texture to use for mapping image index 0. Use SetTextureHeightForImageIndex to set for another mapping image index.
Syntax
SetTextureHeight parameters
Type | Name | Min | Max | Description |
unsigned int | value | | | The new output texture height. |
GetTextureHeight return value
Type: unsigned int
Syntax
SetTextureHeight parameters
Type | Name | Min | Max | Description |
uint | value | | | The new output texture height. |
GetTextureHeight return value
Type: uint
Syntax
SetTextureHeight parameters
Name | Type | Min | Max | Description |
value | int | | | The new output texture height. |
GetTextureHeight return value
Type: int
TextureWidth
The width of the texture to use for mapping image index 0. Use SetTextureWidthForImageIndex to set for another mapping image index.
Syntax
SetTextureWidth parameters
Type | Name | Min | Max | Description |
unsigned int | value | | | The texture width. |
GetTextureWidth return value
Type: unsigned int
Syntax
SetTextureWidth parameters
Type | Name | Min | Max | Description |
uint | value | | | The texture width. |
GetTextureWidth return value
Type: uint
Syntax
SetTextureWidth parameters
Name | Type | Min | Max | Description |
value | int | | | The texture width. |
GetTextureWidth return value
Type: int
UseAutomaticTextureSize
The automatic_texture_size flag. If true, then texture sizes will be computed for the reduced mesh depending on its pixel size on screen.
Syntax
SetUseAutomaticTextureSize parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired flag. |
GetUseAutomaticTextureSize return value
Type: bool
Syntax
SetUseAutomaticTextureSize parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired flag. |
GetUseAutomaticTextureSize return value
Type: bool
Syntax
SetUseAutomaticTextureSize parameters
Name | Type | Min | Max | Description |
value | bool | | | The desired flag. |
GetUseAutomaticTextureSize return value
Type: bool
UseVertexWeights
If UseVertexWeights is enabled, the weights help determine the UV charts and their UV area.
Syntax
SetUseVertexWeights parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired flag. |
GetUseVertexWeights return value
Type: bool
Syntax
SetUseVertexWeights parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired flag. |
GetUseVertexWeights return value
Type: bool
Syntax
SetUseVertexWeights parameters
Name | Type | Min | Max | Description |
value | bool | | | The desired flag. |
GetUseVertexWeights return value
Type: bool
UseVisibilityWeights
If UseVisibilityWeights is enabled, the weights help determine the UV charts and their UV area.
Syntax
SetUseVisibilityWeights parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired flag. |
GetUseVisibilityWeights return value
Type: bool
Syntax
SetUseVisibilityWeights parameters
Type | Name | Min | Max | Description |
bool | value | | | The desired flag. |
GetUseVisibilityWeights return value
Type: bool
Syntax
SetUseVisibilityWeights parameters
Name | Type | Min | Max | Description |
value | bool | | | The desired flag. |
GetUseVisibilityWeights return value
Type: bool
Methods details
AddObserver
Adds a user-defined observer object to the interface, that will receive events from the interface. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
Observer | observer | | | Observer is the object that will receive events. |
Return value
Type: rid
Syntax
Parameters
Type | Name | Min | Max | Description |
Observer | observer | | | Observer is the object that will receive events. |
Return value
Type: int
Syntax
Parameters
Name | Type | Min | Max | Description |
observer | Observer | | | Observer is the object that will receive events. |
Return value
Type: int
GetClass
Get the name of the Parameterizer class. (Inherited from Object)
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
GetGutterSpaceForImageIndex
The minimum number of pixels between charts.
Syntax
Parameters
Type | Name | Min | Max | Description |
unsigned int | id | | | The output material id. |
Return value
Type: unsigned int
Syntax
Parameters
Type | Name | Min | Max | Description |
uint | id | | | The output material id. |
Return value
Type: uint
Syntax
Parameters
Name | Type | Min | Max | Description |
id | int | | | The output material id. |
Return value
Type: int
The previously set material mapping for matId.
Syntax
Parameters
Type | Name | Min | Max | Description |
unsigned int | inMaterialId | | | Is input material id. |
Return value
Type: int
Syntax
Parameters
Type | Name | Min | Max | Description |
uint | inMaterialId | | | Is input material id. |
Return value
Type: int
Syntax
Parameters
Name | Type | Min | Max | Description |
inMaterialId | int | | | Is input material id. |
Return value
Type: int
GetTextureHeightForImageIndex
The height of the texture to use.
Syntax
Parameters
Type | Name | Min | Max | Description |
unsigned int | id | | | The output material id. |
Return value
Type: unsigned int
Syntax
Parameters
Type | Name | Min | Max | Description |
uint | id | | | The output material id. |
Return value
Type: uint
Syntax
Parameters
Name | Type | Min | Max | Description |
id | int | | | The output material id. |
Return value
Type: int
GetTextureWidthForImageIndex
The width of the texture to use.
Syntax
Parameters
Type | Name | Min | Max | Description |
unsigned int | id | | | The material id of the output material. |
Return value
Type: unsigned int
Syntax
Parameters
Type | Name | Min | Max | Description |
uint | id | | | The material id of the output material. |
Return value
Type: uint
Syntax
Parameters
Name | Type | Min | Max | Description |
id | int | | | The material id of the output material. |
Return value
Type: int
IsA
Returns true if Parameterizer is a or is a descendant of the class named as the type parameter. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | type | | | Name of the class to check if Parameterizer 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 Parameterizer 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 Parameterizer is, or is a descendant of. |
Return value
Type: bool
IsNull
Returns true if the Parameterizer object is invalid. (Inherited from Object)
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
IsSameObjectAs
Returns true if the Parameterizer object is valid. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to compare with. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to compare with. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
object | Object | | | Object to compare with. |
Return value
Type: bool
NonNull
Returns true if the Parameterizer object is valid. (Inherited from Object)
Syntax
Parameters
NonNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
NonNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
NonNull takes no parameters.
Return value
Type: bool
Parameterize
Executes the parameterization of the geometry.
Syntax
Parameters
Type | Name | Min | Max | Description |
GeometryData | geom | | | The geometry which is to be parameterized. |
RealArray | arr | | | Will contain the completed parameterization. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
GeometryData | geom | | | The geometry which is to be parameterized. |
RealArray | arr | | | Will contain the completed parameterization. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
geom | GeometryData | | | The geometry which is to be parameterized. |
arr | RealArray | | | Will contain the completed parameterization. |
Return value
Type: bool
PrintInfo
Prints the content/info of the Parameterizer object to the log. (Inherited from Object)
Syntax
Parameters
PrintInfo takes no parameters.
Syntax
Parameters
PrintInfo takes no parameters.
Syntax
Parameters
PrintInfo takes no parameters.
RemoveObserver
Removes a previously added observer object. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | observerId | | | ObserverId is the id returned by AddObserver when the observer was added. |
Syntax
Parameters
Type | Name | Min | Max | Description |
int | observerId | | | ObserverId is the id returned by AddObserver when the observer was added. |
Syntax
Parameters
Name | Type | Min | Max | Description |
observerId | int | | | ObserverId is the id returned by AddObserver when the observer was added. |
SetGutterSpaceForImageIndex
The minimum number of pixels between charts.
Syntax
Parameters
Type | Name | Min | Max | Description |
unsigned int | id | | | The output material id. |
unsigned int | value | | | The desired value to which GutterSpace will be set. |
Syntax
Parameters
Type | Name | Min | Max | Description |
uint | id | | | The output material id. |
uint | value | | | The desired value to which GutterSpace will be set. |
Syntax
Parameters
Name | Type | Min | Max | Description |
id | int | | | The output material id. |
value | int | | | The desired value to which GutterSpace will be set. |
The material mapping for inMaterialId, meaning what material of the generated LOD inMaterialId will be baked into. Both InputMaterialCount and OutputMaterialCount need to be set for this mapping to work, and all original materials need to be mapped to an existing output id.
Syntax
Parameters
Type | Name | Min | Max | Description |
unsigned int | inMaterialId | | | Is input material id. |
int | OutMaterialId | | | The output material id. |
Syntax
Parameters
Type | Name | Min | Max | Description |
uint | inMaterialId | | | Is input material id. |
int | OutMaterialId | | | The output material id. |
Syntax
Parameters
Name | Type | Min | Max | Description |
inMaterialId | int | | | Is input material id. |
OutMaterialId | int | | | The output material id. |
SetTextureHeightForImageIndex
The height of the texture to use.
Syntax
Parameters
Type | Name | Min | Max | Description |
unsigned int | id | | | The output material id. |
unsigned int | value | | | The new output texture height. |
Syntax
Parameters
Type | Name | Min | Max | Description |
uint | id | | | The output material id. |
uint | value | | | The new output texture height. |
Syntax
Parameters
Name | Type | Min | Max | Description |
id | int | | | The output material id. |
value | int | | | The new output texture height. |
SetTextureWidthForImageIndex
The width of the texture to use.
Syntax
Parameters
Type | Name | Min | Max | Description |
unsigned int | id | | | The output material index. |
unsigned int | value | | | The new output texture width. |
Syntax
Parameters
Type | Name | Min | Max | Description |
uint | id | | | The output material index. |
uint | value | | | The new output texture width. |
Syntax
Parameters
Name | Type | Min | Max | Description |
id | int | | | The output material index. |
value | int | | | The new output texture width. |
Static methods details
IsClassA
Returns true if the class is a or is a descendant of the class named as the type parameter. (Inherited from Object)
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 spParameterizer, and if this is the case, returns the object cast into spParameterizer. (Inherited from Object)
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: Parameterizer
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: Parameterizer
Syntax
Parameters
Name | Type | Min | Max | Description |
object | Object | | | Object to cast. |
Return value
Type: Parameterizer