class PipelineSettings
PipelineSettings is the interface used to manage settings for a pipeline
Properties
| Property | Description |
| CascadedRunMode | Set run mode to use for cascaded child pipelines. |
| EmbedReferences | Set flag to control if output file formats that support embedding referenced resources (like textures) should do so. |
| OutputMaterialName | The name of the output material. If the output material count is greater than one, an index separated with an underscore will be appended to the material names, such that MyMaterial becomes MyMaterial_0, MyMaterial_1 and so on. |
| SimplygonBatchPath | The path for the batch tool used when executing pipelines in a new/distributed process. This should be the path to the directory where the SimplygonBatch executable is located. If the tool is in the system path this setting should be an empty string. |
| TextureOutputPath | The path where the pipeline will save any created textures from material casters. A relative path will be treated as relative to the scene file output path if the pipeline is executed with scene file paths (RunSceneFromFile), or from the current working directory if the pipeline is executed with a scene object (RunScene). The directory must exist, it will not be created. |
Methods
| Method | Description |
| GetClass | Get the name of the PipelineSettings class. |
| GetErrorString | Returns a string describing the error that was found the last time ValidateSettings was performed. |
| IsA | Returns true if PipelineSettings is a or is a descendant of the class named as the type parameter. |
| IsNull | Returns true if the PipelineSettings object is invalid. |
| 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 spPipelineSettings, and if this is the case, returns the object cast into spPipelineSettings. |
Properties details
CascadedRunMode
Set run mode to use for cascaded child pipelines.
Syntax
SetCascadedRunMode parameters
| Type | Name | Min | Max | Description |
| EPipelineRunMode | value | | | Run mode for cascaded child pipelines. |
GetCascadedRunMode return value
Type: EPipelineRunMode
Default: RunInThisProcess
| Key | Value | Comment |
| RunInThisProcess | 0 | Run the pipeline in this process |
| RunInNewProcess | 1 | Run the pipeline in a new process using the batch executor tool |
| RunDistributedUsingSimplygonGrid | 2 | Run the pipeline distributed using SimplygonGrid |
| RunDistributedUsingIncredibuild | 3 | Run the pipeline distributed using IncrediBuild |
Syntax
SetCascadedRunMode parameters
| Type | Name | Min | Max | Description |
| EPipelineRunMode | value | | | Run mode for cascaded child pipelines. |
GetCascadedRunMode return value
Type: ``````
Default: RunInThisProcess
| Key | Value | Comment |
| RunInThisProcess | 0 | Run the pipeline in this process |
| RunInNewProcess | 1 | Run the pipeline in a new process using the batch executor tool |
| RunDistributedUsingSimplygonGrid | 2 | Run the pipeline distributed using SimplygonGrid |
| RunDistributedUsingIncredibuild | 3 | Run the pipeline distributed using IncrediBuild |
Syntax
SetCascadedRunMode parameters
| Name | Type | Min | Max | Description |
| value | EPipelineRunMode | | | Run mode for cascaded child pipelines. |
GetCascadedRunMode return value
Type: EPipelineRunMode
Default: RunInThisProcess
| Key | Value | Comment |
| EPipelineRunMode_RunInThisProcess | 0 | Run the pipeline in this process |
| EPipelineRunMode_RunInNewProcess | 1 | Run the pipeline in a new process using the batch executor tool |
| EPipelineRunMode_RunDistributedUsingSimplygonGrid | 2 | Run the pipeline distributed using SimplygonGrid |
| EPipelineRunMode_RunDistributedUsingIncredibuild | 3 | Run the pipeline distributed using IncrediBuild |
EmbedReferences
Set flag to control if output file formats that support embedding referenced resources (like textures) should do so.
Syntax
SetEmbedReferences parameters
| Type | Name | Min | Max | Description |
bool | value | | | Embed flag. |
GetEmbedReferences return value
Type: bool
Default: false
Syntax
SetEmbedReferences parameters
| Type | Name | Min | Max | Description |
bool | value | | | Embed flag. |
GetEmbedReferences return value
Type: bool
Default: false
Syntax
SetEmbedReferences parameters
| Name | Type | Min | Max | Description |
| value | bool | | | Embed flag. |
GetEmbedReferences return value
Type: bool
Default: false
OutputMaterialName
The name of the output material. If the output material count is greater than one, an index separated with an underscore will be appended to the material names, such that MyMaterial becomes MyMaterial_0, MyMaterial_1 and so on.
Syntax
SetOutputMaterialName parameters
| Type | Name | Min | Max | Description |
const char * | value | | | Output material name. |
GetOutputMaterialName return value
Type: spString
Default: SimplygonCastMaterial
Syntax
SetOutputMaterialName parameters
| Type | Name | Min | Max | Description |
string | value | | | Output material name. |
GetOutputMaterialName return value
Type: string
Default: SimplygonCastMaterial
Syntax
SetOutputMaterialName parameters
| Name | Type | Min | Max | Description |
| value | str | | | Output material name. |
GetOutputMaterialName return value
Type: str
Default: SimplygonCastMaterial
SimplygonBatchPath
The path for the batch tool used when executing pipelines in a new/distributed process. This should be the path to the directory where the SimplygonBatch executable is located. If the tool is in the system path this setting should be an empty string.
Syntax
SetSimplygonBatchPath parameters
| Type | Name | Min | Max | Description |
const char * | value | | | Path where SimplygonBatch executable is located. |
GetSimplygonBatchPath return value
Type: spString
Default: $SIMPLYGON_9_PATH
Syntax
SetSimplygonBatchPath parameters
| Type | Name | Min | Max | Description |
string | value | | | Path where SimplygonBatch executable is located. |
GetSimplygonBatchPath return value
Type: string
Default: $SIMPLYGON_9_PATH
Syntax
SetSimplygonBatchPath parameters
| Name | Type | Min | Max | Description |
| value | str | | | Path where SimplygonBatch executable is located. |
GetSimplygonBatchPath return value
Type: str
Default: $SIMPLYGON_9_PATH
TextureOutputPath
The path where the pipeline will save any created textures from material casters. A relative path will be treated as relative to the scene file output path if the pipeline is executed with scene file paths (RunSceneFromFile), or from the current working directory if the pipeline is executed with a scene object (RunScene). The directory must exist, it will not be created.
Syntax
SetTextureOutputPath parameters
| Type | Name | Min | Max | Description |
const char * | value | | | Path where created textures will be saved. |
GetTextureOutputPath return value
Type: spString
Default: nullptr
Syntax
SetTextureOutputPath parameters
| Type | Name | Min | Max | Description |
string | value | | | Path where created textures will be saved. |
GetTextureOutputPath return value
Type: string
Default: null
Syntax
SetTextureOutputPath parameters
| Name | Type | Min | Max | Description |
| value | str | | | Path where created textures will be saved. |
GetTextureOutputPath return value
Type: str
Default: None
Methods details
GetClass
Get the name of the PipelineSettings class.
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: spString
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: string
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: str
GetErrorString
Returns a string describing the error that was found the last time ValidateSettings was performed.
Syntax
Parameters
GetErrorString takes no parameters.
Return value
Type: spString
Syntax
Parameters
GetErrorString takes no parameters.
Return value
Type: string
Syntax
Parameters
GetErrorString takes no parameters.
Return value
Type: str
IsA
Returns true if PipelineSettings is a or is a descendant of the class named as the type parameter.
Syntax
Parameters
| Type | Name | Min | Max | Description |
const char * | type | | | Name of the class to check if PipelineSettings 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 PipelineSettings 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 PipelineSettings is, or is a descendant of. |
Return value
Type: bool
IsNull
Returns true if the PipelineSettings object is invalid.
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
ValidateSettings
Validates the current settings values.
Syntax
Parameters
ValidateSettings takes no parameters.
Return value
Type: bool
Syntax
Parameters
ValidateSettings takes no parameters.
Return value
Type: bool
Syntax
Parameters
ValidateSettings takes no parameters.
Return value
Type: bool
Static methods details
IsClassA
Returns true if the class is a or is a descendant of the class named as the type parameter.
Syntax
Parameters
| Type | Name | Min | Max | Description |
const char * | type | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Type | Name | Min | Max | Description |
string | type | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Name | Type | Min | Max | Description |
| type | str | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
SafeCast
SafeCast makes sure the input object is of a class that can be cast into spPipelineSettings, and if this is the case, returns the object cast into spPipelineSettings.
Syntax
Parameters
| Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: PipelineSettings
Syntax
Parameters
| Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: PipelineSettings
Syntax
Parameters
| Name | Type | Min | Max | Description |
| object | Object | | | Object to cast. |
Return value
Type: PipelineSettings