SetValue

導入

v1.0

詳細

Parameter 値を設定して、古い値(変更前のパラメータ値)を戻します。GetValue の逆の機能を持つこのコマンドは、シーン内のほぼすべてのパラメータの値を変更できるため、非常に強力です。

ユーザがプロパティ ページを変更するたびに、スクリプト ヒストリに SetValue コールが記録されます。 スクリプト ヒストリから簡単なスクリプトを編集し、反復タスクの自動化を容易に行うことができます。

SetValue の強力なワイルドカード機能により、1 度のコールで多数のパラメータを設定できます。 ただし、SetValueを呼び出すとスクリプトヒストリに記録されるため、オブジェクトモデルを使用して値を変更するほうが簡単な場合があります。Parameter.Valueを参照してください。

詳細については、GetValue コマンドの説明を参照してください。

スクリプト構文

SetValue( Target, Value, [Time] );

パラメータ

パラメータ タイプ 説明
Target 文字列 設定するパラメータリスト

デフォルト値: 現在選択されている値

Value パラメータ依存 新しいパラメータ値。
Time Integer 値を設定するフレーム。

デフォルト値: 現在のフレーム。

VBScript の例

' The following uses SetValue to set various parameters 

' on some scene elements

NewScene

' Create a sphere and change the wireframe color to red

' This demonstrates we can use SetValue for object properties.

CreatePrim "Sphere", "MeshSurface"

DeselectAll

MakeLocal "sphere.display", siNodePropagation

SetValue "sphere.display.wirecol", 15

CreatePrim "Circle", "NurbsCurve"

CreatePrim "Circle", "NurbsCurve"

CreatePrim "Circle", "NurbsCurve"

CreatePrim "Circle", "NurbsCurve"

' Set the radius of all circles to 1

' This demonstrates we can use SetValue in a bulk-edit fashion.

SetValue "circle*.circle.radius", 1

' Set the radius of "circle" to 2, and the radius of "circle1" to 3

' This demonstrates we can use SetValue with an array of values.

SetValue "circle.circle.radius,circle1.circle.radius", ARRAY(2, 3)

' Hide the grid in all views, for all cameras (except scene camera)

' This demonstrates we can use SetValue for cameras, views, etc.

SetValue "Views.*.*.camvis.gridvis", False 

' Change current frame to 30 

' This demonstrates we can use SetValue for playback settings

	SetValue "PlayControl.Current", 30.000

関連項目

GetValue ToggleValue