v1.5
カスタム パラメータの定義を編集します。 スキップされた引数は、変更されないままで残ります。
プロキシ パラメータについては、このコマンドを使用してパラメータ名と推奨範囲を調整できますが、マスタ パラメータは影響されません。 ただし、プロキシ パラメータの Min および Max 属性は、マスタ パラメータの Min 値および Max 値と同じである必要があります。
EditParameterDefinition( [InputObj], [ParamName], [VarType], [MinValue], [MaxValue], [SuggMin], [SuggMax], [ScriptName], [Description] ); |
| パラメータ | タイプ | 説明 |
|---|---|---|
| InputObj | 文字列 |
カスタム パラメータのリスト。 デフォルト値： マーク パラメータ |
| ParamName | 文字列 | カスタム パラメータの名前。 カスタム パラメータ名は、シーン Explorer に表示されます("Show script names"が有効でない場合)。 |
| VarType | siVariantType |
(旧バージョンのコマンド)この引数を指定しても無視されます。 デフォルト値: 0 |
| MinValue | Double | パラメータの最小値 |
| MaxValue | Double | パラメータの最大値 |
| SuggMin | Double | パラメータの推奨最小値(UI コントロール用) |
| SuggMax | Double | パラメータの推奨最大値(UI コントロール用) |
| ScriptName | 文字列 | パラメータ名のスクリプト バージョン。 文字列の中にスペースを含むことはできません。 |
| Description | 文字列 | より長い、パラメータ名の説明的バージョン。 この名前は、オブジェクトの確認時にプロパティ ページに表示されます。 |
'
' This example creates a new custom property set and a new
' parameter on a dummy null and then changes its definition.
' The parameter information is logged to the Script Editor
' History Pane so you can see what has changed.
'
' Create a null to hold the new custom property set
set oDummy = GetPrim( "Null" )
' Add custom property set called Emotions to the dummy
AddProp "Custom_parameter_list", , , "Emotions"
' Add custom parameter Happiness to the Emotions property set
SIAddCustomParameter "null.Emotions", "Happiness", _
siDouble, 0.000, 0.000, 1.000, , 5, 0.000, 1.000
' What does it look like before editing the definition?
printParamInfo oDummy.Properties( "Emotions" ).Parameters(0)
' Update the minimum and maximum values of Happiness
EditParameterDefinition oDummy & ".Emotions.Happiness", , , _
-100, 100, -100, 100
' What does it look like afterwards?
printParamInfo oDummy.Properties( "Emotions" ).Parameters(0)
' Convenience function--saves time and typing
function printParamInfo( in_parameter )
LogMessage in_parameter & " information:"
LogMessage "-------------------------------------"
LogMessage vbTab & "Default value: " & vbTab & vbTab & in_parameter.Default
LogMessage vbTab & "Description: " & vbTab & vbTab & in_parameter.Description
LogMessage vbTab & "Is " & in_parameter.ScriptName & " marked?: " & vbTab & in_parameter.Marked
LogMessage vbTab & "SuggestedMin value: " & vbTab & in_parameter.SuggestedMin
LogMessage vbTab & "SuggestedMax value: " & vbTab & in_parameter.SuggestedMax
LogMessage vbTab & "Actual Min value: " & vbTab & in_parameter.Min
LogMessage vbTab & "Actual Max value: " & vbTab & in_parameter.Max
LogMessage vbTab & "ScriptName: " & vbTab & vbTab & in_parameter.ScriptName
LogMessage vbTab & "Value Type: " & vbTab & vbTab & in_parameter.ValueType & " (" & TypeName( in_parameter ) & ")"
LogMessage vbTab & "Actual Value: " & vbTab & vbTab & in_parameter.Value
end function
' Output of above script:
' ...before editing the parameter definition:
'INFO : "null.Emotions.Happiness information:"
'INFO : "-------------------------------------"
'INFO : " Default value: 0"
'INFO : " Description: Happiness"
'INFO : " Is Happiness marked?: False"
'INFO : " SuggestedMin value: 0"
'INFO : " SuggestedMax value: 1"
'INFO : " Actual Min value: 0"
'INFO : " Actual Max value: 1"
'INFO : " ScriptName: Happiness"
'INFO : " Value Type: 5 (Parameter)"
'INFO : " Actual Value: 0"
'
' ...afterwards:
'INFO : "null.Emotions.Happiness information:"
'INFO : "-------------------------------------"
'INFO : " Default value: 0"
'INFO : " Description: Happiness"
'INFO : " Is Happiness marked?: False"
'INFO : " SuggestedMin value: -100"
'INFO : " SuggestedMax value: 100"
'INFO : " Actual Min value: -100"
'INFO : " Actual Max value: 100"
'INFO : " ScriptName: Happiness"
'INFO : " Value Type: 5 (Parameter)"
'INFO : " Actual Value: 0" |