class
ShadingCustomNode
CustomNode describes a custom shading node in a shading network. The output is produced based on customizable user specified operations. The custom node has a user specified amount of input parameters. Use SetInputCount() to specify the number of inputs. The user has to assign and implement event handlers (called observers) for the custom node to be able to evaluate to colors. See CustomNodeExample and API documentation for further explanations and code samples.
Properties
Property | Description |
InputCount | The number of inputs for this custom node. |
Methods
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 spShadingCustomNode, and if this is the case, returns the object cast into spShadingCustomNode. |
Properties details
The number of inputs for this custom node.
Syntax
Type | Name | Min | Max | Description |
unsigned int | value | | | The number of inputs for this custom node. |
Type: unsigned int
Syntax
Type | Name | Min | Max | Description |
uint | value | | | The number of inputs for this custom node. |
Type: uint
Syntax
Name | Type | Min | Max | Description |
value | int | | | The number of inputs for this custom node. |
Type: int
Methods details
GetClass
Get the name of the ShadingCustomNode 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
GetDefaultParameterAlpha
The default parameter values.
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be fetched. |
Return value
Type: real
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be fetched. |
Return value
Type: float
Syntax
Parameters
Name | Type | Min | Max | Description |
parameter_id | int | | | The id of the input to be fetched. |
Return value
Type: float
GetDefaultParameterBlue
The default parameter values.
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be fetched. |
Return value
Type: real
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be fetched. |
Return value
Type: float
Syntax
Parameters
Name | Type | Min | Max | Description |
parameter_id | int | | | The id of the input to be fetched. |
Return value
Type: float
GetDefaultParameterGreen
The default parameter values.
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be fetched. |
Return value
Type: real
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be fetched. |
Return value
Type: float
Syntax
Parameters
Name | Type | Min | Max | Description |
parameter_id | int | | | The id of the input to be fetched. |
Return value
Type: float
GetDefaultParameterRed
The default parameter values.
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be fetched. |
Return value
Type: real
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be fetched. |
Return value
Type: float
Syntax
Parameters
Name | Type | Min | Max | Description |
parameter_id | int | | | The id of the input to be fetched. |
Return value
Type: float
The default node inputs.
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | input_id | | | The id of the input to be fetched. |
Return value
Type: ShadingNode
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | input_id | | | The id of the input to be fetched. |
Return value
Type: ShadingNode
Syntax
Parameters
Name | Type | Min | Max | Description |
input_id | int | | | The id of the input to be fetched. |
Return value
Type: ShadingNode
Get color value from node input index.
Syntax
Parameters
Type | Name | Min | Max | Description |
unsigned int | value | | | Index of node inputs. |
Return value
Type: ShadingColor
Syntax
Parameters
Type | Name | Min | Max | Description |
uint | value | | | Index of node inputs. |
Return value
Type: ShadingColor
Syntax
Parameters
Name | Type | Min | Max | Description |
value | int | | | Index of node inputs. |
Return value
Type: ShadingColor
GetParameterCount
The input count.
Syntax
Parameters
GetParameterCount takes no parameters.
Return value
Type: unsigned int
Syntax
Parameters
GetParameterCount takes no parameters.
Return value
Type: uint
Syntax
Parameters
GetParameterCount takes no parameters.
Return value
Type: int
Get if the parameter is inputable. If true, a different node can be set as this parameters value. If false, the parameter can only be set manually and not through a node input.
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | param_id | | | The id of the parameter to be checked. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | param_id | | | The id of the parameter to be checked. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
param_id | int | | | The id of the parameter to be checked. |
Return value
Type: bool
GetParameterName
The name of a parameter.
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to fetch the name of. |
Return value
Type: spString
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to fetch the name of. |
Return value
Type: string
Syntax
Parameters
Name | Type | Min | Max | Description |
parameter_id | int | | | The id of the input to fetch the name of. |
Return value
Type: str
IsA
Returns true if ShadingCustomNode 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 ShadingCustomNode 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 ShadingCustomNode 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 ShadingCustomNode is, or is a descendant of. |
Return value
Type: bool
IsNull
Returns true if the ShadingCustomNode 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
SetCustomShaderCode
Set custom shader code from OnShadingCustomNodeGenerateShaderCode observer method.
Syntax
Parameters
Type | Name | Min | Max | Description |
const char * | value | | | Custom shader code. |
Syntax
Parameters
Type | Name | Min | Max | Description |
string | value | | | Custom shader code. |
Syntax
Parameters
Name | Type | Min | Max | Description |
value | str | | | Custom shader code. |
SetDefaultParameter
The default parameter values.
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be set. |
real | r | | | The value of red to which the default input will be set. |
real | g | | | The value of green to which the default input will be set. |
real | b | | | The value of blue to which the default input will be set. |
real | a | | | The value of alpha to which the default input will be set. |
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | parameter_id | | | The id of the input to be set. |
float | r | | | The value of red to which the default input will be set. |
float | g | | | The value of green to which the default input will be set. |
float | b | | | The value of blue to which the default input will be set. |
float | a | | | The value of alpha to which the default input will be set. |
Syntax
Parameters
Name | Type | Min | Max | Description |
parameter_id | int | | | The id of the input to be set. |
r | float | | | The value of red to which the default input will be set. |
g | float | | | The value of green to which the default input will be set. |
b | float | | | The value of blue to which the default input will be set. |
a | float | | | The value of alpha to which the default input will be set. |
The default node inputs.
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | input_id | | | The id of the input to be set. |
ShadingNode | input_node | | | The node to be set as input. |
Return value
Type: bool
Syntax
Parameters
Type | Name | Min | Max | Description |
rid | input_id | | | The id of the input to be set. |
ShadingNode | input_node | | | The node to be set as input. |
Return value
Type: bool
Syntax
Parameters
Name | Type | Min | Max | Description |
input_id | int | | | The id of the input to be set. |
input_node | ShadingNode | | | The node to be set as input. |
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 spShadingCustomNode, and if this is the case, returns the object cast into spShadingCustomNode.
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: ShadingCustomNode
Syntax
Parameters
Type | Name | Min | Max | Description |
Object | object | | | Object to cast. |
Return value
Type: ShadingCustomNode
Syntax
Parameters
Name | Type | Min | Max | Description |
object | Object | | | Object to cast. |
Return value
Type: ShadingCustomNode