class MappingImageSettings

Settings for the Simplygon mapping classes These settings control the properties of the mapping image that will be generated in the current simplification processor (reducer/remesher etc). The mapping image will be used when casting a new texture on the simplified geometry. In the settings object, the user is able to set the dimensions of the image (width/height) as well as whether the LOD should have new texture coordinates and some parameters for how they should be generated and all other settings regarding the mapping image.

Properties

Property	Description
AllowTransparencyMapping	If true, the remeshing processor will allow mapped transparency in the generated mapping image. This allows material casting where gaps filled by the remeshing processor will be cast as transparent.
ApplyNewMaterialIds	If true, and also generating one or more mapping images for material casting, the material IDs in the process geometry will be updated to reflect the new, not yet cast output materials. This means the output scene will be temporarily invalid before the materialtable has been updated to reflect the new changes.
AutomaticTextureSizeMultiplier	Texture dimension length multiplier for the automatic texture size.
ForcePower2Texture	If automatic_texture_size is enabled, then force the texture sizes to be a power of 2.
GenerateMappingImage	If set, the aggregation processor, reduction processor, or remeshing processor will create a mapping image that maps triangles on the reduced geometry back to triangles on the original geometry. The texture is insert into the MappingImage object. The image data will contain two fields: * RidArray, "TriangleIds", TupleSize:1, The id of the triangle * UnsignedShortArray, "BarycentricCoords", TupleSize:2, Items A & B of the barycentric coordinate on the triangle. The user can control the size of the mapped texture using the values MappingTextureWidth and MappingTextureHeight.
GenerateTangents	If true, generates a new tangent space fields at position specified by TexCoordLevel, based on the vertex normals and texture coordinates. Tangent space fields will always be created if missing, and GenerateMappingImage is enabled. If GenerateTexCoords is enabled, new tangents will always be generated.
GenerateTexCoords	If true, generates a new texcoords field at the position specified by TexCoordLevel. Will be ignored and always generate texcoords if none are available in the Geometry if GenerateMappingImage is enabled.
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.
MaximumLayers	The maximum number of layers in the mapping image. If a remeshed geometry has a lot of transparent triangles, use a higher number to be able to find intersections on the inside of parts of the geometry. This setting only has effect in the remeshing, when running reduction the number of layers is always 1.
OnlyParameterizeInvalidUVs	If enabled, will aggregate all the valid original UVs. If there are invalid original UVs, those parts will receive new parameterized UVs.
OutputMaterialCount	The number of output mapping images that are to be generated. If this is set to more than 1, the material mapping also needs to be set.
ReplaceMappingImages	Whether to replace already existing mapping images in the scene.
TexCoordGeneratorType	Determines which method to use when generating the texture coordinates. Parameterizer generate from scratch based on the geometry. ChartAggregator generate based on the original texture coordinates.
TexCoordLevel	The texture coordinate level used for mapping image and texture generation. If the TexCoordName has been set, the TexCoordLevel is not used.
TexCoordName	The texture coordinate level name used for mapping image and texture generation. If new UVs are created, they will replace the old coordinates in the texture channel with the TexCoordName. If no texture level with this name exists. It will be created. If the TexCoordName is not set, the TexCoordLevel (index) will be used instead.
UseAutomaticTextureSize	The UseAutomaticTextureSize flag. If true, then texture sizes will be computed for the reduced mesh depending on its pixel size on screen.
UseFullRetexturing	If set, all original texcoord sets are replaced by a single new one which will be used for the mapping image. This means the output scene will be temporarily invalid before the materialtable has been updated to reflect the new changes. This flag has no effect on the remeshing, which always does a full retexturing.

Methods

Method	Description
GetBoolParameter	Get a named parameter boolean value.
GetChartAggregatorSettings	The settings for the chart aggregator.
GetClass	Get the name of the MappingImageSettings class.
GetDoubleParameter	Get a named parameter floating point value.
GetErrorString	Returns a string describing the error that was found the last time ValidateSettings was performed.
GetInputMaterialSettings	Get the input material settings for the given index.
GetIntParameter	Get a named parameter integer value.
GetOutputMaterialSettings	Get the output material settings for the given index.
GetParameterizerSettings	The settings for the parameterizer.
GetStringParameter	Get a named parameter string value.
GetUIntParameter	Get a named parameter unsigned integer value.
IsA	Returns true if MappingImageSettings is a or is a descendant of the class named as the type parameter.
IsNull	Returns true if the MappingImageSettings object is invalid.
SetBoolParameter	Set a named parameter boolean value.
SetDoubleParameter	Set a named parameter floating point value.
SetIntParameter	Set a named parameter integer value.
SetStringParameter	Set a named parameter string value.
SetUIntParameter	Set a named parameter unsigned integer value.
SetValidateParameterNames	Set if parameter names should be validated or not. Parameters that previously do not exist will generate and error if validation is enabled and be allowed if validation is disabled.
ToJSON	Get settings as JSON for debugging purposes.
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 spMappingImageSettings, and if this is the case, returns the object cast into spMappingImageSettings.

Properties details

AllowTransparencyMapping

If true, the remeshing processor will allow mapped transparency in the generated mapping image. This allows material casting where gaps filled by the remeshing processor will be cast as transparent.

Syntax

// Setter
void SetAllowTransparencyMapping( bool value );

// Getter
bool GetAllowTransparencyMapping();

SetAllowTransparencyMapping parameters

Type	Name	Min	Max	Description
bool	value			The desired value of AllowTransparencyMapping.

GetAllowTransparencyMapping return value

Type: bool

Default: false

Syntax

// Setter
void SetAllowTransparencyMapping(bool value);

// Getter
bool GetAllowTransparencyMapping();

SetAllowTransparencyMapping parameters

Type	Name	Min	Max	Description
bool	value			The desired value of AllowTransparencyMapping.

GetAllowTransparencyMapping return value

Type: bool

Default: false

Syntax

# Setter
None SetAllowTransparencyMapping(value: bool)

# Getter
bool GetAllowTransparencyMapping()

SetAllowTransparencyMapping parameters

Name	Type	Min	Max	Description
value	bool			The desired value of AllowTransparencyMapping.

GetAllowTransparencyMapping return value

Type: bool

Default: false

ApplyNewMaterialIds

If true, and also generating one or more mapping images for material casting, the material IDs in the process geometry will be updated to reflect the new, not yet cast output materials. This means the output scene will be temporarily invalid before the materialtable has been updated to reflect the new changes.

Syntax

// Setter
void SetApplyNewMaterialIds( bool value );

// Getter
bool GetApplyNewMaterialIds();

SetApplyNewMaterialIds parameters

Type	Name	Min	Max	Description
bool	value			The desired ApplyNewMaterialIds flag.

GetApplyNewMaterialIds return value

Type: bool

Default: true

Syntax

// Setter
void SetApplyNewMaterialIds(bool value);

// Getter
bool GetApplyNewMaterialIds();

SetApplyNewMaterialIds parameters

Type	Name	Min	Max	Description
bool	value			The desired ApplyNewMaterialIds flag.

GetApplyNewMaterialIds return value

Type: bool

Default: true

Syntax

# Setter
None SetApplyNewMaterialIds(value: bool)

# Getter
bool GetApplyNewMaterialIds()

SetApplyNewMaterialIds parameters

Name	Type	Min	Max	Description
value	bool			The desired ApplyNewMaterialIds flag.

GetApplyNewMaterialIds return value

Type: bool

Default: true

AutomaticTextureSizeMultiplier

Texture dimension length multiplier for the automatic texture size.

Syntax

// Setter
void SetAutomaticTextureSizeMultiplier( real value );

// Getter
real GetAutomaticTextureSizeMultiplier();

SetAutomaticTextureSizeMultiplier parameters

Type	Name	Min	Max	Description
real	value	0	REAL_MAX	The desired multiplier.

GetAutomaticTextureSizeMultiplier return value

Type: real

Default: 1.0

Syntax

// Setter
void SetAutomaticTextureSizeMultiplier(float value);

// Getter
float GetAutomaticTextureSizeMultiplier();

SetAutomaticTextureSizeMultiplier parameters

Type	Name	Min	Max	Description
float	value	0	REAL_MAX	The desired multiplier.

GetAutomaticTextureSizeMultiplier return value

Type: float

Default: 1.0

Syntax

# Setter
None SetAutomaticTextureSizeMultiplier(value: float)

# Getter
float GetAutomaticTextureSizeMultiplier()

SetAutomaticTextureSizeMultiplier parameters

Name	Type	Min	Max	Description
value	float	0	REAL_MAX	The desired multiplier.

GetAutomaticTextureSizeMultiplier return value

Type: float

Default: 1.0

ForcePower2Texture

If automatic_texture_size is enabled, then force the texture sizes to be a power of 2.

Syntax

// Setter
void SetForcePower2Texture( bool value );

// Getter
bool GetForcePower2Texture();

SetForcePower2Texture parameters

Type	Name	Min	Max	Description
bool	value			The desired flag.

GetForcePower2Texture return value

Type: bool

Default: false

Syntax

// Setter
void SetForcePower2Texture(bool value);

// Getter
bool GetForcePower2Texture();

SetForcePower2Texture parameters

Type	Name	Min	Max	Description
bool	value			The desired flag.

GetForcePower2Texture return value

Type: bool

Default: false

Syntax

# Setter
None SetForcePower2Texture(value: bool)

# Getter
bool GetForcePower2Texture()

SetForcePower2Texture parameters

Name	Type	Min	Max	Description
value	bool			The desired flag.

GetForcePower2Texture return value

Type: bool

Default: false

GenerateMappingImage

If set, the aggregation processor, reduction processor, or remeshing processor will create a mapping image that maps triangles on the reduced geometry back to triangles on the original geometry. The texture is insert into the MappingImage object. The image data will contain two fields: * RidArray, "TriangleIds", TupleSize:1, The id of the triangle * UnsignedShortArray, "BarycentricCoords", TupleSize:2, Items A & B of the barycentric coordinate on the triangle. The user can control the size of the mapped texture using the values MappingTextureWidth and MappingTextureHeight.

Syntax

// Setter
void SetGenerateMappingImage( bool value );

// Getter
bool GetGenerateMappingImage();

SetGenerateMappingImage parameters

Type	Name	Min	Max	Description
bool	value			The desired GenerateMappingImage flag.

GetGenerateMappingImage return value

Type: bool

Default: false

Syntax

// Setter
void SetGenerateMappingImage(bool value);

// Getter
bool GetGenerateMappingImage();

SetGenerateMappingImage parameters

Type	Name	Min	Max	Description
bool	value			The desired GenerateMappingImage flag.

GetGenerateMappingImage return value

Type: bool

Default: false

Syntax

# Setter
None SetGenerateMappingImage(value: bool)

# Getter
bool GetGenerateMappingImage()

SetGenerateMappingImage parameters

Name	Type	Min	Max	Description
value	bool			The desired GenerateMappingImage flag.

GetGenerateMappingImage return value

Type: bool

Default: false

GenerateTangents

If true, generates a new tangent space fields at position specified by TexCoordLevel, based on the vertex normals and texture coordinates. Tangent space fields will always be created if missing, and GenerateMappingImage is enabled. If GenerateTexCoords is enabled, new tangents will always be generated.

Syntax

// Setter
void SetGenerateTangents( bool value );

// Getter
bool GetGenerateTangents();

SetGenerateTangents parameters

Type	Name	Min	Max	Description
bool	value			The desired GenerateTangents flag.

GetGenerateTangents return value

Type: bool

Default: false

Syntax

// Setter
void SetGenerateTangents(bool value);

// Getter
bool GetGenerateTangents();

SetGenerateTangents parameters

Type	Name	Min	Max	Description
bool	value			The desired GenerateTangents flag.

GetGenerateTangents return value

Type: bool

Default: false

Syntax

# Setter
None SetGenerateTangents(value: bool)

# Getter
bool GetGenerateTangents()

SetGenerateTangents parameters

Name	Type	Min	Max	Description
value	bool			The desired GenerateTangents flag.

GetGenerateTangents return value

Type: bool

Default: false

GenerateTexCoords

If true, generates a new texcoords field at the position specified by TexCoordLevel. Will be ignored and always generate texcoords if none are available in the Geometry if GenerateMappingImage is enabled.

Syntax

// Setter
void SetGenerateTexCoords( bool value );

// Getter
bool GetGenerateTexCoords();

SetGenerateTexCoords parameters

Type	Name	Min	Max	Description
bool	value			The desired GenerateTexCoords flag.

GetGenerateTexCoords return value

Type: bool

Default: false

Syntax

// Setter
void SetGenerateTexCoords(bool value);

// Getter
bool GetGenerateTexCoords();

SetGenerateTexCoords parameters

Type	Name	Min	Max	Description
bool	value			The desired GenerateTexCoords flag.

GetGenerateTexCoords return value

Type: bool

Default: false

Syntax

# Setter
None SetGenerateTexCoords(value: bool)

# Getter
bool GetGenerateTexCoords()

SetGenerateTexCoords parameters

Name	Type	Min	Max	Description
value	bool			The desired GenerateTexCoords flag.

GetGenerateTexCoords return value

Type: bool

Default: false

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.

Syntax

// Setter
void SetInputMaterialCount( unsigned int value );

// Getter
unsigned int GetInputMaterialCount();

SetInputMaterialCount parameters

Type	Name	Min	Max	Description
unsigned int	value	0	SG_MAXIMUM_MAPPING_IMAGE_INPUT_MATERIAL_COUNT	The number of inputs.

GetInputMaterialCount return value

Type: unsigned int

Default: 0

Syntax

// Setter
void SetInputMaterialCount(uint value);

// Getter
uint GetInputMaterialCount();

SetInputMaterialCount parameters

Type	Name	Min	Max	Description
uint	value	0	SG_MAXIMUM_MAPPING_IMAGE_INPUT_MATERIAL_COUNT	The number of inputs.

GetInputMaterialCount return value

Type: uint

Default: 0

Syntax

# Setter
None SetInputMaterialCount(value: int)

# Getter
int GetInputMaterialCount()

SetInputMaterialCount parameters

Name	Type	Min	Max	Description
value	int	0	SG_MAXIMUM_MAPPING_IMAGE_INPUT_MATERIAL_COUNT	The number of inputs.

GetInputMaterialCount return value

Type: int

Default: 0

MaximumLayers

The maximum number of layers in the mapping image. If a remeshed geometry has a lot of transparent triangles, use a higher number to be able to find intersections on the inside of parts of the geometry. This setting only has effect in the remeshing, when running reduction the number of layers is always 1.

Syntax

// Setter
void SetMaximumLayers( unsigned int value );

// Getter
unsigned int GetMaximumLayers();

SetMaximumLayers parameters

Type	Name	Min	Max	Description
unsigned int	value	0	UINT_MAX	The desired number of layers in the mapping image.

GetMaximumLayers return value

Type: unsigned int

Default: 3

Syntax

// Setter
void SetMaximumLayers(uint value);

// Getter
uint GetMaximumLayers();

SetMaximumLayers parameters

Type	Name	Min	Max	Description
uint	value	0	UINT_MAX	The desired number of layers in the mapping image.

GetMaximumLayers return value

Type: uint

Default: 3

Syntax

# Setter
None SetMaximumLayers(value: int)

# Getter
int GetMaximumLayers()

SetMaximumLayers parameters

Name	Type	Min	Max	Description
value	int	0	UINT_MAX	The desired number of layers in the mapping image.

GetMaximumLayers return value

Type: int

Default: 3

OnlyParameterizeInvalidUVs

If enabled, will aggregate all the valid original UVs. If there are invalid original UVs, those parts will receive new parameterized UVs.

Syntax

// Setter
void SetOnlyParameterizeInvalidUVs( bool value );

// Getter
bool GetOnlyParameterizeInvalidUVs();

SetOnlyParameterizeInvalidUVs parameters

Type	Name	Min	Max	Description
bool	value			The new flag.

GetOnlyParameterizeInvalidUVs return value

Type: bool

Default: false

Syntax

// Setter
void SetOnlyParameterizeInvalidUVs(bool value);

// Getter
bool GetOnlyParameterizeInvalidUVs();

SetOnlyParameterizeInvalidUVs parameters

Type	Name	Min	Max	Description
bool	value			The new flag.

GetOnlyParameterizeInvalidUVs return value

Type: bool

Default: false

Syntax

# Setter
None SetOnlyParameterizeInvalidUVs(value: bool)

# Getter
bool GetOnlyParameterizeInvalidUVs()

SetOnlyParameterizeInvalidUVs parameters

Name	Type	Min	Max	Description
value	bool			The new flag.

GetOnlyParameterizeInvalidUVs return value

Type: bool

Default: false

OutputMaterialCount

The number of output mapping images that are to be generated. If this is set to more than 1, the material mapping also needs to be set.

Syntax

// Setter
void SetOutputMaterialCount( unsigned int value );

// Getter
unsigned int GetOutputMaterialCount();

SetOutputMaterialCount parameters

Type	Name	Min	Max	Description
unsigned int	value	1	SG_MAXIMUM_MAPPING_IMAGE_OUTPUT_MATERIAL_COUNT	The number of outputs.

GetOutputMaterialCount return value

Type: unsigned int

Default: 1

Syntax

// Setter
void SetOutputMaterialCount(uint value);

// Getter
uint GetOutputMaterialCount();

SetOutputMaterialCount parameters

Type	Name	Min	Max	Description
uint	value	1	SG_MAXIMUM_MAPPING_IMAGE_OUTPUT_MATERIAL_COUNT	The number of outputs.

GetOutputMaterialCount return value

Type: uint

Default: 1

Syntax

# Setter
None SetOutputMaterialCount(value: int)

# Getter
int GetOutputMaterialCount()

SetOutputMaterialCount parameters

Name	Type	Min	Max	Description
value	int	1	SG_MAXIMUM_MAPPING_IMAGE_OUTPUT_MATERIAL_COUNT	The number of outputs.

GetOutputMaterialCount return value

Type: int

Default: 1

ReplaceMappingImages

Whether to replace already existing mapping images in the scene.

Syntax

// Setter
void SetReplaceMappingImages( bool value );

// Getter
bool GetReplaceMappingImages();

SetReplaceMappingImages parameters

Type	Name	Min	Max	Description
bool	value			The new value.

GetReplaceMappingImages return value

Type: bool

Default: true

Syntax

// Setter
void SetReplaceMappingImages(bool value);

// Getter
bool GetReplaceMappingImages();

SetReplaceMappingImages parameters

Type	Name	Min	Max	Description
bool	value			The new value.

GetReplaceMappingImages return value

Type: bool

Default: true

Syntax

# Setter
None SetReplaceMappingImages(value: bool)

# Getter
bool GetReplaceMappingImages()

SetReplaceMappingImages parameters

Name	Type	Min	Max	Description
value	bool			The new value.

GetReplaceMappingImages return value

Type: bool

Default: true

TexCoordGeneratorType

Determines which method to use when generating the texture coordinates. Parameterizer generate from scratch based on the geometry. ChartAggregator generate based on the original texture coordinates.

Syntax

// Setter
void SetTexCoordGeneratorType( Simplygon::ETexcoordGeneratorType value );

// Getter
Simplygon::ETexcoordGeneratorType GetTexCoordGeneratorType();

SetTexCoordGeneratorType parameters

Type	Name	Min	Max	Description
ETexcoordGeneratorType	value			The TexCoordGeneratorType value to use.

GetTexCoordGeneratorType return value

Type: ETexcoordGeneratorType

Default: Parameterizer

Key	Value	Comment
Parameterizer	0	Texture coordinates are generated from scratch based on the geometry.
ChartAggregator	1	Texture coordinates are generated based on the original texture coordinates.

Syntax

// Setter
void SetTexCoordGeneratorType(ETexcoordGeneratorType value);

// Getter
ETexcoordGeneratorType GetTexCoordGeneratorType();

SetTexCoordGeneratorType parameters

Type	Name	Min	Max	Description
ETexcoordGeneratorType	value			The TexCoordGeneratorType value to use.

GetTexCoordGeneratorType return value

Type: ETexcoordGeneratorType

Default: Parameterizer

Key	Value	Comment
Parameterizer	0	Texture coordinates are generated from scratch based on the geometry.
ChartAggregator	1	Texture coordinates are generated based on the original texture coordinates.

Syntax

# Setter
None SetTexCoordGeneratorType(value: ETexcoordGeneratorType_*)

# Getter
ETexcoordGeneratorType_* GetTexCoordGeneratorType()

SetTexCoordGeneratorType parameters

Name	Type	Min	Max	Description
value	ETexcoordGeneratorType			The TexCoordGeneratorType value to use.

GetTexCoordGeneratorType return value

Type: ETexcoordGeneratorType

Default: Parameterizer

Key	Value	Comment
ETexcoordGeneratorType_Parameterizer	0	Texture coordinates are generated from scratch based on the geometry.
ETexcoordGeneratorType_ChartAggregator	1	Texture coordinates are generated based on the original texture coordinates.

TexCoordLevel

The texture coordinate level used for mapping image and texture generation. If the TexCoordName has been set, the TexCoordLevel is not used.

Syntax

// Setter
void SetTexCoordLevel( rid value );

// Getter
rid GetTexCoordLevel();

SetTexCoordLevel parameters

Type	Name	Min	Max	Description
rid	value	-1	INT_MAX	The desired texture coordinate level.

GetTexCoordLevel return value

Type: rid

Default: 0

Syntax

// Setter
void SetTexCoordLevel(rid value);

// Getter
rid GetTexCoordLevel();

SetTexCoordLevel parameters

Type	Name	Min	Max	Description
rid	value	-1	INT_MAX	The desired texture coordinate level.

GetTexCoordLevel return value

Type: rid

Default: 0

Syntax

# Setter
None SetTexCoordLevel(value: int)

# Getter
int GetTexCoordLevel()

SetTexCoordLevel parameters

Name	Type	Min	Max	Description
value	int	-1	INT_MAX	The desired texture coordinate level.

GetTexCoordLevel return value

Type: int

Default: 0

TexCoordName

The texture coordinate level name used for mapping image and texture generation. If new UVs are created, they will replace the old coordinates in the texture channel with the TexCoordName. If no texture level with this name exists. It will be created. If the TexCoordName is not set, the TexCoordLevel (index) will be used instead.

Syntax

// Setter
void SetTexCoordName( const char * value );

// Getter
spString GetTexCoordName();

SetTexCoordName parameters

Type	Name	Min	Max	Description
const char *	value			The TexCoord level name.

GetTexCoordName return value

Type: spString

Default: nullptr

Syntax

// Setter
void SetTexCoordName(string value);

// Getter
string GetTexCoordName();

SetTexCoordName parameters

Type	Name	Min	Max	Description
string	value			The TexCoord level name.

GetTexCoordName return value

Type: string

Default: null

Syntax

# Setter
None SetTexCoordName(value: str)

# Getter
str GetTexCoordName()

SetTexCoordName parameters

Name	Type	Min	Max	Description
value	str			The TexCoord level name.

GetTexCoordName return value

Type: str

Default: None

UseAutomaticTextureSize

The UseAutomaticTextureSize flag. If true, then texture sizes will be computed for the reduced mesh depending on its pixel size on screen.

Syntax

// Setter
void SetUseAutomaticTextureSize( bool value );

// Getter
bool GetUseAutomaticTextureSize();

SetUseAutomaticTextureSize parameters

Type	Name	Min	Max	Description
bool	value			The desired flag.

GetUseAutomaticTextureSize return value

Type: bool

Default: false

Syntax

// Setter
void SetUseAutomaticTextureSize(bool value);

// Getter
bool GetUseAutomaticTextureSize();

SetUseAutomaticTextureSize parameters

Type	Name	Min	Max	Description
bool	value			The desired flag.

GetUseAutomaticTextureSize return value

Type: bool

Default: false

Syntax

# Setter
None SetUseAutomaticTextureSize(value: bool)

# Getter
bool GetUseAutomaticTextureSize()

SetUseAutomaticTextureSize parameters

Name	Type	Min	Max	Description
value	bool			The desired flag.

GetUseAutomaticTextureSize return value

Type: bool

Default: false

UseFullRetexturing

If set, all original texcoord sets are replaced by a single new one which will be used for the mapping image. This means the output scene will be temporarily invalid before the materialtable has been updated to reflect the new changes. This flag has no effect on the remeshing, which always does a full retexturing.

Syntax

// Setter
void SetUseFullRetexturing( bool value );

// Getter
bool GetUseFullRetexturing();

SetUseFullRetexturing parameters

Type	Name	Min	Max	Description
bool	value			The desired UseFullRetexturing flag.

GetUseFullRetexturing return value

Type: bool

Default: false

Syntax

// Setter
void SetUseFullRetexturing(bool value);

// Getter
bool GetUseFullRetexturing();

SetUseFullRetexturing parameters

Type	Name	Min	Max	Description
bool	value			The desired UseFullRetexturing flag.

GetUseFullRetexturing return value

Type: bool

Default: false

Syntax

# Setter
None SetUseFullRetexturing(value: bool)

# Getter
bool GetUseFullRetexturing()

SetUseFullRetexturing parameters

Name	Type	Min	Max	Description
value	bool			The desired UseFullRetexturing flag.

GetUseFullRetexturing return value

Type: bool

Default: false

Methods details

GetBoolParameter

Get a named parameter boolean value.

Syntax

bool GetBoolParameter( const char * name );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.

Return value

Type: bool

Syntax

bool GetBoolParameter(string name);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.

Return value

Type: bool

Syntax

bool GetBoolParameter(name: str)

Parameters

Name	Type	Min	Max	Description
name	str			Parameter name.

Return value

Type: bool

GetChartAggregatorSettings

The settings for the chart aggregator.

Syntax

spChartAggregatorSettings GetChartAggregatorSettings();

Parameters

GetChartAggregatorSettings takes no parameters.

Return value

Type: ChartAggregatorSettings

Syntax

spChartAggregatorSettings GetChartAggregatorSettings();

Parameters

GetChartAggregatorSettings takes no parameters.

Return value

Type: ChartAggregatorSettings

Syntax

spChartAggregatorSettings GetChartAggregatorSettings()

Parameters

GetChartAggregatorSettings takes no parameters.

Return value

Type: ChartAggregatorSettings

GetClass

Get the name of the MappingImageSettings class.

Syntax

spString GetClass();

Parameters

GetClass takes no parameters.

Return value

Type: spString

Syntax

string GetClass();

Parameters

GetClass takes no parameters.

Return value

Type: string

Syntax

str GetClass()

Parameters

GetClass takes no parameters.

Return value

Type: str

GetDoubleParameter

Get a named parameter floating point value.

Syntax

double GetDoubleParameter( const char * name );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.

Return value

Type: double

Syntax

double GetDoubleParameter(string name);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.

Return value

Type: double

Syntax

float GetDoubleParameter(name: str)

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

spString GetErrorString();

Parameters

GetErrorString takes no parameters.

Return value

Type: spString

Syntax

string GetErrorString();

Parameters

GetErrorString takes no parameters.

Return value

Type: string

Syntax

str GetErrorString()

Parameters

GetErrorString takes no parameters.

Return value

Type: str

GetInputMaterialSettings

Get the input material settings for the given index.

Syntax

spMappingImageInputMaterialSettings GetInputMaterialSettings( unsigned int index );

Parameters

Type	Name	Min	Max	Description
unsigned int	index	0	SG_MAXIMUM_MAPPING_IMAGE_INPUT_MATERIAL_COUNT	Input index

Return value

Type: MappingImageInputMaterialSettings

Syntax

spMappingImageInputMaterialSettings GetInputMaterialSettings(uint index);

Parameters

Type	Name	Min	Max	Description
uint	index	0	SG_MAXIMUM_MAPPING_IMAGE_INPUT_MATERIAL_COUNT	Input index

Return value

Type: MappingImageInputMaterialSettings

Syntax

spMappingImageInputMaterialSettings GetInputMaterialSettings(index: int)

Parameters

Name	Type	Min	Max	Description
index	int	0	SG_MAXIMUM_MAPPING_IMAGE_INPUT_MATERIAL_COUNT	Input index

Return value

Type: MappingImageInputMaterialSettings

GetIntParameter

Get a named parameter integer value.

Syntax

int GetIntParameter( const char * name );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.

Return value

Type: int

Syntax

int GetIntParameter(string name);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.

Return value

Type: int

Syntax

int GetIntParameter(name: str)

Parameters

Name	Type	Min	Max	Description
name	str			Parameter name.

Return value

Type: int

GetOutputMaterialSettings

Get the output material settings for the given index.

Syntax

spMappingImageOutputMaterialSettings GetOutputMaterialSettings( unsigned int index );

Parameters

Type	Name	Min	Max	Description
unsigned int	index	0	SG_MAXIMUM_MAPPING_IMAGE_INPUT_MATERIAL_COUNT	Output index

Return value

Type: MappingImageOutputMaterialSettings

Syntax

spMappingImageOutputMaterialSettings GetOutputMaterialSettings(uint index);

Parameters

Type	Name	Min	Max	Description
uint	index	0	SG_MAXIMUM_MAPPING_IMAGE_INPUT_MATERIAL_COUNT	Output index

Return value

Type: MappingImageOutputMaterialSettings

Syntax

spMappingImageOutputMaterialSettings GetOutputMaterialSettings(index: int)

Parameters

Name	Type	Min	Max	Description
index	int	0	SG_MAXIMUM_MAPPING_IMAGE_INPUT_MATERIAL_COUNT	Output index

Return value

Type: MappingImageOutputMaterialSettings

GetParameterizerSettings

The settings for the parameterizer.

Syntax

spParameterizerSettings GetParameterizerSettings();

Parameters

GetParameterizerSettings takes no parameters.

Return value

Type: ParameterizerSettings

Syntax

spParameterizerSettings GetParameterizerSettings();

Parameters

GetParameterizerSettings takes no parameters.

Return value

Type: ParameterizerSettings

Syntax

spParameterizerSettings GetParameterizerSettings()

Parameters

GetParameterizerSettings takes no parameters.

Return value

Type: ParameterizerSettings

GetStringParameter

Get a named parameter string value.

Syntax

spString GetStringParameter( const char * name );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.

Return value

Type: spString

Syntax

string GetStringParameter(string name);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.

Return value

Type: string

Syntax

str GetStringParameter(name: str)

Parameters

Name	Type	Min	Max	Description
name	str			Parameter name.

Return value

Type: str

GetUIntParameter

Get a named parameter unsigned integer value.

Syntax

unsigned int GetUIntParameter( const char * name );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.

Return value

Type: unsigned int

Syntax

uint GetUIntParameter(string name);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.

Return value

Type: uint

Syntax

int GetUIntParameter(name: str)

Parameters

Name	Type	Min	Max	Description
name	str			Parameter name.

Return value

Type: int

IsA

Returns true if MappingImageSettings is a or is a descendant of the class named as the type parameter.

Syntax

bool IsA( const char * type );

Parameters

Type	Name	Min	Max	Description
const char *	type			Name of the class to check if MappingImageSettings is, or is a descendant of.

Return value

Type: bool

Syntax

bool IsA(string type);

Parameters

Type	Name	Min	Max	Description
string	type			Name of the class to check if MappingImageSettings is, or is a descendant of.

Return value

Type: bool

Syntax

bool IsA(type: str)

Parameters

Name	Type	Min	Max	Description
type	str			Name of the class to check if MappingImageSettings is, or is a descendant of.

Return value

Type: bool

IsNull

Returns true if the MappingImageSettings object is invalid.

Syntax

bool IsNull();

Parameters

IsNull takes no parameters.

Return value

Type: bool

Syntax

bool IsNull();

Parameters

IsNull takes no parameters.

Return value

Type: bool

Syntax

bool IsNull()

Parameters

IsNull takes no parameters.

Return value

Type: bool

SetBoolParameter

Set a named parameter boolean value.

Syntax

bool SetBoolParameter( const char * name , bool value );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.
bool	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetBoolParameter(string name, bool value);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.
bool	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetBoolParameter(name: str, value: bool)

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

bool SetDoubleParameter( const char * name , double value );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.
double	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetDoubleParameter(string name, double value);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.
double	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetDoubleParameter(name: str, value: float)

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

bool SetIntParameter( const char * name , int value );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.
int	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetIntParameter(string name, int value);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.
int	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetIntParameter(name: str, value: int)

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

bool SetStringParameter( const char * name , const char * value );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.
const char *	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetStringParameter(string name, string value);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.
string	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetStringParameter(name: str, value: str)

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

bool SetUIntParameter( const char * name , unsigned int value );

Parameters

Type	Name	Min	Max	Description
const char *	name			Parameter name.
unsigned int	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetUIntParameter(string name, uint value);

Parameters

Type	Name	Min	Max	Description
string	name			Parameter name.
uint	value			New value for parameter.

Return value

Type: bool

Syntax

bool SetUIntParameter(name: str, value: int)

Parameters

Name	Type	Min	Max	Description
name	str			Parameter name.
value	int			New value for parameter.

Return value

Type: bool

SetValidateParameterNames

Set if parameter names should be validated or not. Parameters that previously do not exist will generate and error if validation is enabled and be allowed if validation is disabled.

Syntax

void SetValidateParameterNames( bool validate );

Parameters

Type	Name	Min	Max	Description
bool	validate			Flag indicating if validation is performed or not.

Syntax

void SetValidateParameterNames(bool validate);

Parameters

Type	Name	Min	Max	Description
bool	validate			Flag indicating if validation is performed or not.

Syntax

None SetValidateParameterNames(validate: bool)

Parameters

Name	Type	Min	Max	Description
validate	bool			Flag indicating if validation is performed or not.

ToJSON

Get settings as JSON for debugging purposes.

Syntax

spString ToJSON();

Parameters

ToJSON takes no parameters.

Return value

Type: spString

Syntax

string ToJSON();

Parameters

ToJSON takes no parameters.

Return value

Type: string

Syntax

str ToJSON()

Parameters

ToJSON takes no parameters.

Return value

Type: str

ValidateSettings

Validates the current settings values.

Syntax

bool ValidateSettings();

Parameters

ValidateSettings takes no parameters.

Return value

Type: bool

Syntax

bool ValidateSettings();

Parameters

ValidateSettings takes no parameters.

Return value

Type: bool

Syntax

bool ValidateSettings()

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

static bool IsClassA( const char * type );

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

static bool IsClassA(string type);

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

@staticmethod
bool IsClassA(type: str)

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 spMappingImageSettings, and if this is the case, returns the object cast into spMappingImageSettings.

Syntax

static spMappingImageSettings SafeCast( spObject object );

Parameters

Type	Name	Min	Max	Description
Object	object			Object to cast.

Return value

Type: MappingImageSettings

Syntax

static spMappingImageSettings SafeCast(spObject object);

Parameters

Type	Name	Min	Max	Description
Object	object			Object to cast.

Return value

Type: MappingImageSettings

Syntax

@staticmethod
spMappingImageSettings SafeCast(object: spObject)

Parameters

Name	Type	Min	Max	Description
object	Object			Object to cast.

Return value

Type: MappingImageSettings