Parameter

Object Hierarchy | 関連する C++クラス:Parameter

継承

SIObject

パラメータ

導入

v1.5

詳細

オブジェクトの属性を定義するパラメータ値です(例:twist オペレータの角度パラメータやライトのカラーなど)。パラメータ(プロパティとも呼ばれる)は、パラメータセット(Cone.kine.ltransfo.pos.posx?Iposx)の「原子」エレメントであり、その値により対象物の動作が決まります。

注:パラメータセット(プロパティセット)はパラメータのコレクションです。その値により、見た目、動作が決定されるほか、単にシーン内エレメントに関する情報を提供することもあります。パラメータセット(スクリプト用の Property オブジェクト)には、ビューポートに表示されるオブジェクトのビジュアル面を定義するパラメータ、時間などのモーション情報を提供するパラメータ、メソッド固有の操作の実行制御用に内部で使用されるパラメータなどがあります。

ユーザインターフェイスでは、ほとんどのパラメータセットのパラメータをプロパティエディタから編集し、アニメートさせることができます。関連付けられているパラメータは、通常プロパティエディタ内のプロパティページに表示されます。

オブジェクトモデルでは、Parameter オブジェクトは ParameterCollection のメンバであり、ProjectItem.Parameters を使用して取得できます。また、CustomProperty オブジェクトを使用して、カスタム定義パラメータを作成できます(CustomProperty.AddParameter および CustomProperty.AddParameter2 を参照)。

Softimage で通常のパラメータを表す他に、このオブジェクトは ArrayParameterShaderParameterProxyParameter など多数の特殊化の基本クラスになります。

詳細については、Softimage ユーザ ガイドの「オブジェクト階層」を参照してください。

メソッド

AddCustomOp AddExpression AddFCurve AddFCurve2
AddScriptedOp AddScriptedOpFromFile AnimatedParameters Connect
ConnectFromFile ConnectFromFile2 ConnectFromPreset ConnectFromPreset2
ConnectFromProgID ConnectFromProgID2 Disconnect Enableオペレータ
GetInstanceValue GetValue2オペレータ IsAnimated IsClassOfオペレータ
IsEqualToオペレータ IsLockedオペレータ IsSupportedInstanceValue PutValue2オペレータ
SetCapabilityFlagオペレータ SetInstanceValue SetLock Showオペレータ
UnSetLock      
       

プロパティ

Animatableオペレータ Application Capabilitiesオペレータ Categories
Defaultオペレータ Descriptionオペレータ FullNameオペレータ HasInstanceValue
Help Keyableオペレータ LockLevelオペレータ LockTypeオペレータ
Marked Maxオペレータ Minオペレータ Model
Nameオペレータ NestedObjects Origin OriginPath
OriginalValueオペレータ OverridenObject OverridingObject Parametersオペレータ
Parent Parent3DObject ReadOnlyオペレータ ScriptNameオペレータ
Source Sources SuggestedMaxオペレータ SuggestedMinオペレータ
Tagsオペレータ Typeオペレータ Valueオペレータ ValueTypeオペレータ

1. VBScript の例

' 

' This example shows how to loop through all parameters on the object

'

NewScene , false

' Access Parameters Directly Off the Object

Set oRoot = Application.ActiveProject.ActiveScene.Root

Set oCube =  oRoot.AddGeometry("Cube", "MeshSurface", "MyCube")

' Print the names of all parameter exposed by the cube object

For Each oParameter In oCube.Parameters

	LogMessage oParameter.ScriptName & " = " & oParameter.Value

Next

' Expected results:

'INFO : "Name = MyCube"

'INFO : "blendweight = 1"

'INFO : "active = True"

'INFO : "posx = 0"

'INFO : "posy = 0"

'INFO : "posz = 0"

'INFO : "rotx = 0"

'INFO : "roty = 0"

'INFO : "rotz = 0"

'INFO : "quatw = 1"

'INFO : "quatx = 0"

'INFO : "quaty = 0"

'INFO : "quatz = 0"

'INFO : "sclx = 1"

'INFO : "scly = 1"

'INFO : "sclz = 1"

'INFO : "sclorix = 0"

'INFO : "scloriy = 0"

'INFO : "scloriz = 0"

'INFO : "cnsscl = True"

'INFO : "cnsori = True"

'INFO : "cnspos = True"

'INFO : "affbyscl = True"

'INFO : "affbyori = True"

'INFO : "posxmaxactive = False"

'INFO : "posxminactive = False"

'INFO : "posymaxactive = False"

'INFO : "posyminactive = False"

'INFO : "poszmaxactive = False"

'INFO : "poszminactive = False"

'INFO : "rotxmaxactive = False"

'INFO : "rotxminactive = False"

'INFO : "rotymaxactive = False"

'INFO : "rotyminactive = False"

'INFO : "rotzmaxactive = False"

'INFO : "rotzminactive = False"

'INFO : "siscaling = True"

'INFO : "rotorder = 0"

'INFO : "subdivu = 1"

'INFO : "subdivv = 1"

'INFO : "subdivbase = 1"

'INFO : "length = 8"

2. VBScript の例

' 

' This example demonstrates how to get at individual parameters; if you change the value of

' a parameter you want to access through the UI, you can get its name to use in your script.

' For example, toggling the View Visibility parameter of a torus logs the following message 

' to the Script Editor History pane:

'

'		SetValue "torus.visibility.viewvis", False

'

NewScene , false

' 

' 	How to Access Parameters (the Long Way)

' 

' First get the camera (Camera object)

Set oCamera = ActiveSceneRoot.FindChild( , "camera" )

' Underneath the camera are its properties (Properties returns the PropertyCollection)

Set oProps = oCamera.Properties

' Once you have all the property sets (PropertyCollection) you can specify the one you 

' want (the Property object is returned)

Set oVis = oProps( "visibility" )

' Now you have a single Property (property set), so you need to get all the 

' parameters for that property set (Parameters returns the ParameterCollection)

Set oParams = oVis.Parameters

' Again you choose the single parameter you want from the collection (the 

' Parameter object is returned)

Set oViewVis = oParams( "viewvis" )

' 

' How to Get Parameter Values

' 

' And once you have a single Parameter object, you can get it's value...

bOldValue = oViewVis.Value

LogMessage "Parameter originally was set to " & oViewVis.Value

' 

' How to Set Parameter Values

' 

' ...or set it...

oViewVis.Value = not(bOldValue)

LogMessage "Parameter has been changed to " & oViewVis.Value

' 

' How to Access Parameters (the Short Way)

' 

' ...and you can make as many shortcuts as you like, so...

oCamera.Properties("visibility").Parameters("viewvis").Value = not(bOldValue)

LogMessage "Parameter is back to " & oViewVis.Value

' Expected result:

'INFO : "Parameter originally was set to False"

'INFO : "Parameter has been changed to True"

'INFO : "Parameter is back to True"

関連項目

ParameterCollection ProjectItem.Parameters Property CustomProperty CustomProperty.AddParameter CustomProperty.AddParameter2 ProjectItem