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