class GeometryDataCasterSettings

GeometryDataCasterSettings is the interface used to manage settings for GeometryDataCaster

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.
GeometryDataFieldIndex	The GeometryDataFieldIndex setting, which specifies what field index to cast in the GeometryDataCaster, for fields where it is applicable (TexCoords, Tangents, Bitangents and Colors). The setting is ignored for other field types.
GeometryDataFieldType	The GeometryDataFieldType setting, which specifies what field type to cast in the GeometryDataCaster.
MappingInf	The inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
MappingInfA	Property the inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
MappingInfB	The inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
MappingInfG	The inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
MappingInfR	The inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
MappingSup	The Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
MappingSupA	Property the Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
MappingSupB	The Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
MappingSupG	The Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
MappingSupR	The Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.
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.
OutputPixelFormat	The output pixel format
UseMultisampling	Enable or disable multisampling.

Methods

Method	Description
GetBoolParameter	Get a named parameter boolean value.
GetClass	Get the name of the GeometryDataCasterSettings 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.
GetIntParameter	Get a named parameter integer value.
GetStringParameter	Get a named parameter string value.
GetUIntParameter	Get a named parameter unsigned integer value.
IsA	Returns true if GeometryDataCasterSettings is a or is a descendant of the class named as the type parameter.
IsNull	Returns true if the GeometryDataCasterSettings 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 spGeometryDataCasterSettings, and if this is the case, returns the object cast into spGeometryDataCasterSettings.

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

// Setter
void SetDilation( unsigned int value );

// Getter
unsigned int GetDilation();

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: 10

Syntax

// Setter
void SetDilation(uint value);

// Getter
uint GetDilation();

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: 10

Syntax

# Setter
None SetDilation(value: int)

# Getter
int GetDilation()

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: 10

DitherType

The type of dithering to use when creating the output object.

Syntax

// Setter
void SetDitherType( Simplygon::EDitherPatterns value );

// Getter
Simplygon::EDitherPatterns GetDitherType();

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

// Setter
void SetDitherType(EDitherPatterns value);

// Getter
EDitherPatterns GetDitherType();

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

# Setter
None SetDitherType(value: EDitherPatterns_*)

# Getter
EDitherPatterns_* GetDitherType()

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

// Setter
void SetFillMode( Simplygon::EAtlasFillMode value );

// Getter
Simplygon::EAtlasFillMode GetFillMode();

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

// Setter
void SetFillMode(EAtlasFillMode value);

// Getter
EAtlasFillMode GetFillMode();

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

# Setter
None SetFillMode(value: EAtlasFillMode_*)

# Getter
EAtlasFillMode_* GetFillMode()

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

GeometryDataFieldIndex

The GeometryDataFieldIndex setting, which specifies what field index to cast in the GeometryDataCaster, for fields where it is applicable (TexCoords, Tangents, Bitangents and Colors). The setting is ignored for other field types.

Syntax

// Setter
void SetGeometryDataFieldIndex( unsigned int FieldIndex );

// Getter
unsigned int GetGeometryDataFieldIndex();

SetGeometryDataFieldIndex parameters

Type	Name	Min	Max	Description
unsigned int	FieldIndex	0	UINT_MAX	Value the field index for the selected field type, if applicable. Allowed max value depend on the field type selected.

GetGeometryDataFieldIndex return value

Type: unsigned int

Default: 0

Syntax

// Setter
void SetGeometryDataFieldIndex(uint FieldIndex);

// Getter
uint GetGeometryDataFieldIndex();

SetGeometryDataFieldIndex parameters

Type	Name	Min	Max	Description
uint	FieldIndex	0	UINT_MAX	Value the field index for the selected field type, if applicable. Allowed max value depend on the field type selected.

GetGeometryDataFieldIndex return value

Type: uint

Default: 0

Syntax

# Setter
None SetGeometryDataFieldIndex(FieldIndex: int)

# Getter
int GetGeometryDataFieldIndex()

SetGeometryDataFieldIndex parameters

Name	Type	Min	Max	Description
FieldIndex	int	0	UINT_MAX	Value the field index for the selected field type, if applicable. Allowed max value depend on the field type selected.

GetGeometryDataFieldIndex return value

Type: int

Default: 0

GeometryDataFieldType

The GeometryDataFieldType setting, which specifies what field type to cast in the GeometryDataCaster.

Syntax

// Setter
void SetGeometryDataFieldType( Simplygon::EGeometryDataFieldType FieldType );

// Getter
Simplygon::EGeometryDataFieldType GetGeometryDataFieldType();

SetGeometryDataFieldType parameters

Type	Name	Min	Max	Description
EGeometryDataFieldType	FieldType			The field type to set. Specified in the GeometryDataFieldTypes enum.

GetGeometryDataFieldType return value

Type: EGeometryDataFieldType

Default: Coords

Key	Value	Comment
Coords	0	Per-vertex coordinate data, xyz values (3 items per tuple)
TexCoords	1	Per-corner texture coords data, uv values (2 items per tuple)
Normals	2	Per-corner vertex normals data, xyz values (3 items per tuple)
Tangents	3	Per-corner vertex tangent data, xyz values (3 items per tuple)
Bitangents	4	Per-corner vertex bitangent data, xyz values (3 items per tuple)
Colors	5	Per-corner vertex color data, rgba values (4 items per tuple)
TriangleIds	6	Per-triangle triangle ids, id values, not interpolated. (1 item per tuple)
MaterialIds	7	Per-triangle material ids, id values, not interpolated. (1 item per tuple)

Syntax

// Setter
void SetGeometryDataFieldType(EGeometryDataFieldType FieldType);

// Getter
EGeometryDataFieldType GetGeometryDataFieldType();

SetGeometryDataFieldType parameters

Type	Name	Min	Max	Description
EGeometryDataFieldType	FieldType			The field type to set. Specified in the GeometryDataFieldTypes enum.

GetGeometryDataFieldType return value

Type: EGeometryDataFieldType

Default: Coords

Key	Value	Comment
Coords	0	Per-vertex coordinate data, xyz values (3 items per tuple)
TexCoords	1	Per-corner texture coords data, uv values (2 items per tuple)
Normals	2	Per-corner vertex normals data, xyz values (3 items per tuple)
Tangents	3	Per-corner vertex tangent data, xyz values (3 items per tuple)
Bitangents	4	Per-corner vertex bitangent data, xyz values (3 items per tuple)
Colors	5	Per-corner vertex color data, rgba values (4 items per tuple)
TriangleIds	6	Per-triangle triangle ids, id values, not interpolated. (1 item per tuple)
MaterialIds	7	Per-triangle material ids, id values, not interpolated. (1 item per tuple)

Syntax

# Setter
None SetGeometryDataFieldType(FieldType: EGeometryDataFieldType_*)

# Getter
EGeometryDataFieldType_* GetGeometryDataFieldType()

SetGeometryDataFieldType parameters

Name	Type	Min	Max	Description
FieldType	EGeometryDataFieldType			The field type to set. Specified in the GeometryDataFieldTypes enum.

GetGeometryDataFieldType return value

Type: EGeometryDataFieldType

Default: Coords

Key	Value	Comment
EGeometryDataFieldType_Coords	0	Per-vertex coordinate data, xyz values (3 items per tuple)
EGeometryDataFieldType_TexCoords	1	Per-corner texture coords data, uv values (2 items per tuple)
EGeometryDataFieldType_Normals	2	Per-corner vertex normals data, xyz values (3 items per tuple)
EGeometryDataFieldType_Tangents	3	Per-corner vertex tangent data, xyz values (3 items per tuple)
EGeometryDataFieldType_Bitangents	4	Per-corner vertex bitangent data, xyz values (3 items per tuple)
EGeometryDataFieldType_Colors	5	Per-corner vertex color data, rgba values (4 items per tuple)
EGeometryDataFieldType_TriangleIds	6	Per-triangle triangle ids, id values, not interpolated. (1 item per tuple)
EGeometryDataFieldType_MaterialIds	7	Per-triangle material ids, id values, not interpolated. (1 item per tuple)

MappingInf

The inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingInf( const real *vec_realInputDataPtr );

// Getter
spRealData GetMappingInf();

SetMappingInf parameters

Type	Name	Min	Max	Description
RealData	vec	-REAL_MAX,-REAL_MAX,-REAL_MAX,-REAL_MAX	REAL_MAX,REAL_MAX,REAL_MAX,REAL_MAX	The minimum value for each channel (RGBA, 4 values).

GetMappingInf return value

Type: RealData

Default: 0,0,0,0

Syntax

// Setter
void SetMappingInf(float[] vec);

// Getter
RealData GetMappingInf();

SetMappingInf parameters

Type	Name	Min	Max	Description
float[]	vec	-REAL_MAX,-REAL_MAX,-REAL_MAX,-REAL_MAX	REAL_MAX,REAL_MAX,REAL_MAX,REAL_MAX	The minimum value for each channel (RGBA, 4 values).

GetMappingInf return value

Type: RealData

Default: 0,0,0,0

Syntax

# Setter
None SetMappingInf(vec: float)

# Getter
spRealData GetMappingInf()

SetMappingInf parameters

Name	Type	Min	Max	Description
vec	float	-REAL_MAX,-REAL_MAX,-REAL_MAX,-REAL_MAX	REAL_MAX,REAL_MAX,REAL_MAX,REAL_MAX	The minimum value for each channel (RGBA, 4 values).

GetMappingInf return value

Type: float

Default: 0,0,0,0

MappingInfA

Property the inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingInfA( real value );

// Getter
real GetMappingInfA();

SetMappingInfA parameters

Type	Name	Min	Max	Description
real	value	-REAL_MAX	REAL_MAX	The minimum value for the alpha channel.

GetMappingInfA return value

Type: real

Default: 0

Syntax

// Setter
void SetMappingInfA(float value);

// Getter
float GetMappingInfA();

SetMappingInfA parameters

Type	Name	Min	Max	Description
float	value	-REAL_MAX	REAL_MAX	The minimum value for the alpha channel.

GetMappingInfA return value

Type: float

Default: 0

Syntax

# Setter
None SetMappingInfA(value: float)

# Getter
float GetMappingInfA()

SetMappingInfA parameters

Name	Type	Min	Max	Description
value	float	-REAL_MAX	REAL_MAX	The minimum value for the alpha channel.

GetMappingInfA return value

Type: float

Default: 0

MappingInfB

The inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingInfB( real value );

// Getter
real GetMappingInfB();

SetMappingInfB parameters

Type	Name	Min	Max	Description
real	value	-REAL_MAX	REAL_MAX	The minimum value for the blue channel.

GetMappingInfB return value

Type: real

Default: 0

Syntax

// Setter
void SetMappingInfB(float value);

// Getter
float GetMappingInfB();

SetMappingInfB parameters

Type	Name	Min	Max	Description
float	value	-REAL_MAX	REAL_MAX	The minimum value for the blue channel.

GetMappingInfB return value

Type: float

Default: 0

Syntax

# Setter
None SetMappingInfB(value: float)

# Getter
float GetMappingInfB()

SetMappingInfB parameters

Name	Type	Min	Max	Description
value	float	-REAL_MAX	REAL_MAX	The minimum value for the blue channel.

GetMappingInfB return value

Type: float

Default: 0

MappingInfG

The inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingInfG( real value );

// Getter
real GetMappingInfG();

SetMappingInfG parameters

Type	Name	Min	Max	Description
real	value	-REAL_MAX	REAL_MAX	The minimum value for the green channel.

GetMappingInfG return value

Type: real

Default: 0

Syntax

// Setter
void SetMappingInfG(float value);

// Getter
float GetMappingInfG();

SetMappingInfG parameters

Type	Name	Min	Max	Description
float	value	-REAL_MAX	REAL_MAX	The minimum value for the green channel.

GetMappingInfG return value

Type: float

Default: 0

Syntax

# Setter
None SetMappingInfG(value: float)

# Getter
float GetMappingInfG()

SetMappingInfG parameters

Name	Type	Min	Max	Description
value	float	-REAL_MAX	REAL_MAX	The minimum value for the green channel.

GetMappingInfG return value

Type: float

Default: 0

MappingInfR

The inferior/minimum value of field values to map onto the image data range (0->1). The minimum value will be represented by 0 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingInfR( real value );

// Getter
real GetMappingInfR();

SetMappingInfR parameters

Type	Name	Min	Max	Description
real	value	-REAL_MAX	REAL_MAX	The minimum value for the red channel.

GetMappingInfR return value

Type: real

Default: 0

Syntax

// Setter
void SetMappingInfR(float value);

// Getter
float GetMappingInfR();

SetMappingInfR parameters

Type	Name	Min	Max	Description
float	value	-REAL_MAX	REAL_MAX	The minimum value for the red channel.

GetMappingInfR return value

Type: float

Default: 0

Syntax

# Setter
None SetMappingInfR(value: float)

# Getter
float GetMappingInfR()

SetMappingInfR parameters

Name	Type	Min	Max	Description
value	float	-REAL_MAX	REAL_MAX	The minimum value for the red channel.

GetMappingInfR return value

Type: float

Default: 0

MappingSup

The Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingSup( const real *vec_realInputDataPtr );

// Getter
spRealData GetMappingSup();

SetMappingSup parameters

Type	Name	Min	Max	Description
RealData	vec	-REAL_MAX,-REAL_MAX,-REAL_MAX,-REAL_MAX	REAL_MAX,REAL_MAX,REAL_MAX,REAL_MAX	The maximum value for each channel (RGBA, 4 values).

GetMappingSup return value

Type: RealData

Default: 1,1,1,1

Syntax

// Setter
void SetMappingSup(float[] vec);

// Getter
RealData GetMappingSup();

SetMappingSup parameters

Type	Name	Min	Max	Description
float[]	vec	-REAL_MAX,-REAL_MAX,-REAL_MAX,-REAL_MAX	REAL_MAX,REAL_MAX,REAL_MAX,REAL_MAX	The maximum value for each channel (RGBA, 4 values).

GetMappingSup return value

Type: RealData

Default: 1,1,1,1

Syntax

# Setter
None SetMappingSup(vec: float)

# Getter
spRealData GetMappingSup()

SetMappingSup parameters

Name	Type	Min	Max	Description
vec	float	-REAL_MAX,-REAL_MAX,-REAL_MAX,-REAL_MAX	REAL_MAX,REAL_MAX,REAL_MAX,REAL_MAX	The maximum value for each channel (RGBA, 4 values).

GetMappingSup return value

Type: float

Default: 1,1,1,1

MappingSupA

Property the Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingSupA( real value );

// Getter
real GetMappingSupA();

SetMappingSupA parameters

Type	Name	Min	Max	Description
real	value	-REAL_MAX	REAL_MAX	The maximum value for the alpha channel.

GetMappingSupA return value

Type: real

Default: 1.0

Syntax

// Setter
void SetMappingSupA(float value);

// Getter
float GetMappingSupA();

SetMappingSupA parameters

Type	Name	Min	Max	Description
float	value	-REAL_MAX	REAL_MAX	The maximum value for the alpha channel.

GetMappingSupA return value

Type: float

Default: 1.0

Syntax

# Setter
None SetMappingSupA(value: float)

# Getter
float GetMappingSupA()

SetMappingSupA parameters

Name	Type	Min	Max	Description
value	float	-REAL_MAX	REAL_MAX	The maximum value for the alpha channel.

GetMappingSupA return value

Type: float

Default: 1.0

MappingSupB

The Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingSupB( real value );

// Getter
real GetMappingSupB();

SetMappingSupB parameters

Type	Name	Min	Max	Description
real	value	-REAL_MAX	REAL_MAX	The maximum value for the blue channel.

GetMappingSupB return value

Type: real

Default: 1.0

Syntax

// Setter
void SetMappingSupB(float value);

// Getter
float GetMappingSupB();

SetMappingSupB parameters

Type	Name	Min	Max	Description
float	value	-REAL_MAX	REAL_MAX	The maximum value for the blue channel.

GetMappingSupB return value

Type: float

Default: 1.0

Syntax

# Setter
None SetMappingSupB(value: float)

# Getter
float GetMappingSupB()

SetMappingSupB parameters

Name	Type	Min	Max	Description
value	float	-REAL_MAX	REAL_MAX	The maximum value for the blue channel.

GetMappingSupB return value

Type: float

Default: 1.0

MappingSupG

The Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingSupG( real value );

// Getter
real GetMappingSupG();

SetMappingSupG parameters

Type	Name	Min	Max	Description
real	value	-REAL_MAX	REAL_MAX	The maximum value for the green channel.

GetMappingSupG return value

Type: real

Default: 1.0

Syntax

// Setter
void SetMappingSupG(float value);

// Getter
float GetMappingSupG();

SetMappingSupG parameters

Type	Name	Min	Max	Description
float	value	-REAL_MAX	REAL_MAX	The maximum value for the green channel.

GetMappingSupG return value

Type: float

Default: 1.0

Syntax

# Setter
None SetMappingSupG(value: float)

# Getter
float GetMappingSupG()

SetMappingSupG parameters

Name	Type	Min	Max	Description
value	float	-REAL_MAX	REAL_MAX	The maximum value for the green channel.

GetMappingSupG return value

Type: float

Default: 1.0

MappingSupR

The Superior/maximum value of field values to map onto the image data range (0->1). The maximum value will be represented by 1 in the image. Note that the mapping is only used for real value fields, not id-based fields, which cannot be scaled accurately.

Syntax

// Setter
void SetMappingSupR( real value );

// Getter
real GetMappingSupR();

SetMappingSupR parameters

Type	Name	Min	Max	Description
real	value	-REAL_MAX	REAL_MAX	The maximum value for the red channel.

GetMappingSupR return value

Type: real

Default: 1.0

Syntax

// Setter
void SetMappingSupR(float value);

// Getter
float GetMappingSupR();

SetMappingSupR parameters

Type	Name	Min	Max	Description
float	value	-REAL_MAX	REAL_MAX	The maximum value for the red channel.

GetMappingSupR return value

Type: float

Default: 1.0

Syntax

# Setter
None SetMappingSupR(value: float)

# Getter
float GetMappingSupR()

SetMappingSupR parameters

Name	Type	Min	Max	Description
value	float	-REAL_MAX	REAL_MAX	The maximum value for the red channel.

GetMappingSupR return value

Type: float

Default: 1.0

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

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

// Getter
spString GetMaterialChannel();

SetMaterialChannel parameters

Type	Name	Min	Max	Description
const char *	value			The input material channel name.

GetMaterialChannel return value

Type: spString

Default: nullptr

Syntax

// Setter
void SetMaterialChannel(string value);

// Getter
string GetMaterialChannel();

SetMaterialChannel parameters

Type	Name	Min	Max	Description
string	value			The input material channel name.

GetMaterialChannel return value

Type: string

Default: null

Syntax

# Setter
None SetMaterialChannel(value: str)

# Getter
str GetMaterialChannel()

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

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

// Getter
spString GetOpacityChannel();

SetOpacityChannel parameters

Type	Name	Min	Max	Description
const char *	value			The desired material channel.

GetOpacityChannel return value

Type: spString

Default: Opacity

Syntax

// Setter
void SetOpacityChannel(string value);

// Getter
string GetOpacityChannel();

SetOpacityChannel parameters

Type	Name	Min	Max	Description
string	value			The desired material channel.

GetOpacityChannel return value

Type: string

Default: Opacity

Syntax

# Setter
None SetOpacityChannel(value: str)

# Getter
str GetOpacityChannel()

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

// Setter
void SetOpacityChannelComponent( Simplygon::EColorComponent value );

// Getter
Simplygon::EColorComponent GetOpacityChannelComponent();

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

// Setter
void SetOpacityChannelComponent(EColorComponent value);

// Getter
EColorComponent GetOpacityChannelComponent();

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

# Setter
None SetOpacityChannelComponent(value: EColorComponent_*)

# Getter
EColorComponent_* GetOpacityChannelComponent()

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

// Setter
void SetOutputDDSCompressionType( Simplygon::EDDSCompressionType value );

// Getter
Simplygon::EDDSCompressionType GetOutputDDSCompressionType();

SetOutputDDSCompressionType parameters

Type	Name	Min	Max	Description
EDDSCompressionType	value			The desired DDS compression type.

GetOutputDDSCompressionType return value

Type: EDDSCompressionType

Default: NoCompression

Key	Value	Comment
NoCompression	-1
BC1	0
BC2	1
BC3	2
BC4	3
BC5	4

Syntax

// Setter
void SetOutputDDSCompressionType(EDDSCompressionType value);

// Getter
EDDSCompressionType GetOutputDDSCompressionType();

SetOutputDDSCompressionType parameters

Type	Name	Min	Max	Description
EDDSCompressionType	value			The desired DDS compression type.

GetOutputDDSCompressionType return value

Type: EDDSCompressionType

Default: NoCompression

Key	Value	Comment
NoCompression	-1
BC1	0
BC2	1
BC3	2
BC4	3
BC5	4

Syntax

# Setter
None SetOutputDDSCompressionType(value: EDDSCompressionType_*)

# Getter
EDDSCompressionType_* GetOutputDDSCompressionType()

SetOutputDDSCompressionType parameters

Name	Type	Min	Max	Description
value	EDDSCompressionType			The desired DDS compression type.

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

OutputImageFileFormat

File format for output texture.

Syntax

// Setter
void SetOutputImageFileFormat( Simplygon::EImageOutputFormat value );

// Getter
Simplygon::EImageOutputFormat GetOutputImageFileFormat();

SetOutputImageFileFormat parameters

Type	Name	Min	Max	Description
EImageOutputFormat	value			The desired file format.

GetOutputImageFileFormat return value

Type: EImageOutputFormat

Default: PNG

Key	Value	Comment
BMP	0
DDS	1
JPEG	2
PNG	3
TGA	4
TIFF	5

Syntax

// Setter
void SetOutputImageFileFormat(EImageOutputFormat value);

// Getter
EImageOutputFormat GetOutputImageFileFormat();

SetOutputImageFileFormat parameters

Type	Name	Min	Max	Description
EImageOutputFormat	value			The desired file format.

GetOutputImageFileFormat return value

Type: EImageOutputFormat

Default: PNG

Key	Value	Comment
BMP	0
DDS	1
JPEG	2
PNG	3
TGA	4
TIFF	5

Syntax

# Setter
None SetOutputImageFileFormat(value: EImageOutputFormat_*)

# Getter
EImageOutputFormat_* GetOutputImageFileFormat()

SetOutputImageFileFormat parameters

Name	Type	Min	Max	Description
value	EImageOutputFormat			The desired file format.

GetOutputImageFileFormat return value

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

OutputPixelFormat

The output pixel format

Syntax

// Setter
void SetOutputPixelFormat( Simplygon::EPixelFormat value );

// Getter
Simplygon::EPixelFormat GetOutputPixelFormat();

SetOutputPixelFormat parameters

Type	Name	Min	Max	Description
EPixelFormat	value			The desired value to which OutputChannels will be set.

GetOutputPixelFormat return value

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

// Setter
void SetOutputPixelFormat(EPixelFormat value);

// Getter
EPixelFormat GetOutputPixelFormat();

SetOutputPixelFormat parameters

Type	Name	Min	Max	Description
EPixelFormat	value			The desired value to which OutputChannels will be set.

GetOutputPixelFormat return value

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

# Setter
None SetOutputPixelFormat(value: EPixelFormat_*)

# Getter
EPixelFormat_* GetOutputPixelFormat()

SetOutputPixelFormat parameters

Name	Type	Min	Max	Description
value	EPixelFormat			The desired value to which OutputChannels will be set.

GetOutputPixelFormat return value

Type: EPixelFormat

Default: R8G8B8A8

Key	Value	Comment
EPixelFormat_R8G8B8A8	0	RGBA color channels with 8 bit depth per color channel
EPixelFormat_R8G8B8	1	RGB color channels with 8 bit depth per color channel
EPixelFormat_R8	2	R color channel with 8 bit depth per color channel
EPixelFormat_R16G16B16A16	3	RGBA color channels with 16 bit depth per color channel
EPixelFormat_R16G16B16	4	RGB color channels with 16 bit depth per color channel
EPixelFormat_R16	5	R color channel with 16 bit depth per color channel

UseMultisampling

Enable or disable multisampling.

Syntax

// Setter
void SetUseMultisampling( bool value );

// Getter
bool GetUseMultisampling();

SetUseMultisampling parameters

Type	Name	Min	Max	Description
bool	value			The desired value of the flag.

GetUseMultisampling return value

Type: bool

Default: true

Syntax

// Setter
void SetUseMultisampling(bool value);

// Getter
bool GetUseMultisampling();

SetUseMultisampling parameters

Type	Name	Min	Max	Description
bool	value			The desired value of the flag.

GetUseMultisampling return value

Type: bool

Default: true

Syntax

# Setter
None SetUseMultisampling(value: bool)

# Getter
bool GetUseMultisampling()

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

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

GetClass

Get the name of the GeometryDataCasterSettings 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

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

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 GeometryDataCasterSettings 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 GeometryDataCasterSettings 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 GeometryDataCasterSettings 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 GeometryDataCasterSettings is, or is a descendant of.

Return value

Type: bool

IsNull

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

Syntax

static spGeometryDataCasterSettings SafeCast( spObject object );

Parameters

Type	Name	Min	Max	Description
Object	object			Object to cast.

Return value

Type: GeometryDataCasterSettings

Syntax

static spGeometryDataCasterSettings SafeCast(spObject object);

Parameters

Type	Name	Min	Max	Description
Object	object			Object to cast.

Return value

Type: GeometryDataCasterSettings

Syntax

@staticmethod
spGeometryDataCasterSettings SafeCast(object: spObject)

Parameters

Name	Type	Min	Max	Description
object	Object			Object to cast.

Return value

Type: GeometryDataCasterSettings