ShaderParamDefContainer.AddParamDef operator

Introduced

v9.0 (2011)

Categories

ICE Shaders

Description

Adds a ShaderParamDef to this container.

Warning: You must specify any characteristics such as display name, capabilities, value range, etc. for this parameter definition on the ShaderParamDefOptions object before calling this method.

Scripting Syntax

oReturn = ShaderParamDefContainer.AddParamDef( in_ParameterName, in_ParameterType, in_Options );

Return Value

ShaderParamDef or ShaderStructParamDef

Parameters

Parameter Type Description
in_ParameterName String The registered name for the new parameter. On an instance of this parameter definition (ShaderParameter), this value is will be returned when you call the Parameter.ScriptName property.

To set the label you see in the UI for this parameter, use the ShaderParamDefOptions.SetLongName method.

To set the ShaderParamDef.DisplayName, use the ShaderParamDefOptions.SetShortName method.
in_ParameterType String or siShaderParameterDataType The type of shader parameter to create. If a string is passed, it can refer to either the string version of any of the siShaderParameterDataType values or a custom data type that has been registered with XSIApplication.RegisterShaderCustomParameterType.
in_Options ShaderParamDefOptions Options for this shader parameter definition. Use the XSIFactory.CreateShaderParamDefOptions method to create the options as a ShaderParamDefOptions object.

See Also

ShaderParamDefContainer.AddArrayParamDef Adding Parameter Definitions