AddParameter3 (CustomProperty)
Description
Adds a new custom parameter to the custom property. This version is a simplified version of CustomProperty.AddParameter2.
The most commonly-used siCapabilities flags, siAnimatable and siReadOnly, are exposed directly as optional arguments.
Most parameters can be specified with this method. However you should consider using CustomProperty.AddParameter or CustomProperty.AddParameter2 if the parameter needs a UI range, specific classification flags, or a user name.
Scripting Syntax
CustomProperty.AddParameter3( ScriptName, ValueType, [DefaultValue], [Min], [Max], [Animatable], [ReadOnly] )
C# Syntax
Parameter CustomProperty.AddParameter3( String in_ScriptName, siVariantType in_ValueType, Object in_DefaultValue, Object in_Min, Object in_Max, Boolean in_bAnimatable, Boolean in_bReadOnly );Parameters
|
Parameter |
Type |
Description |
|
ScriptName |
Name of the custom parameter. This argument specifies both the Parameter.ScriptName and SIObject.Name. It should not contain spaces. |
|
|
ValueType |
Type of the custom parameter. The recommended types are siString, siBool, siInt4, siUByte, and siFloat. (See Parameter.ValueType) |
|
|
DefaultValue |
Default value of the custom parameter. A default value for a numerical values including boolean is 0, the string default is "". (See Parameter.Default) |
|
|
Min |
Minimum value of the custom parameter. siString and siBool types do not require a Min value. For all other numerical type the default will be minimum value possible for the type for example all unsigned values will have a min=0. (See Parameter.Min) |
|
|
Max |
Maximum value of the custom parameter. siString and siBool types do not require a Max value. For all other numerical type the default will be minimum value possible for the type for example the maximum value for siUByte is 255. (See Parameter.Max) |
|
|
Animatable |
Specify that the parameter should support animation. This argument is ignored for string parameters, which do not support animation. It is possible to override this setting on a particular instance of a parameter via Parameter.Animatable. Default Value: true |
|
|
ReadOnly |
Specify that the user cannot change the value of this Parameter. A read-only parameter can still be changed via scripting (see Parameter.Value) It is possible to override this setting on a particular instance of a parameter via Parameter.ReadOnly. Default Value: false |
Return Value
The newly created Parameter object.
See Also
Autodesk Softimage v7.5