PlotShape

導入

v1.0

詳細

オブジェクトのシェイプをシェイプ アニメーションでプロットします。

注: このコマンドは、出力引数を使用します。C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。このため、状況に応じた適切な回避策を実行する必要があります。

スクリプト言語の場合、このコマンドは出力引数を取得するために使用できる ISIVTCollection を戻します。

C# の場合は、XSIApplication.ExecuteCommand メソッドを使用してこのコマンドを呼び出すことができます。ExecuteCommand は、出力引数を C# の System.Object (出力引数の Array を含む)にパック化します(詳細については、「C# からのコマンドの呼び出し」を参照)。

スクリプト構文

PlotShape( [InputObj], [Name], [StartFrame], [EndFrame], [StepFrame], [ApplyKeys], [Mode], [Content], [RefMode], [SingleSource], [KeyList], [ClipList] );

パラメータ

パラメータ タイプ 説明
InputObj 文字列 プロットされるシェイプを持つオブジェクトのリスト

デフォルト値: 現在の選択

Name 文字列 シェイプ ソース名のプリフィックス
StartFrame Double 最初にプロットするフレーム
EndFrame Double 最後にプロットするフレーム
StepFrame Double 各キー間のステップ
ApplyKeys Boolean True を設定すると、プロットされたキーがオブジェクトに適用されます。
Mode siShapeInstanceMode シェイプがどのようにインスタンス化されるかを決定します。

デフォルト値: siShapeBlendedWeightMode

Content siShapeContent 球に保存するデフォーメーションを決定します。

デフォルト値: siShapeContentUseConstructionMode

RefMode siShapeReferenceMode 作成されたシェイプ キーのリファレンス モード

デフォルト値: siShapeLocalReferenceMode

SingleSource Boolean True の場合は、デフォーメーションが単一シェイプのソースに保存されます。

デフォルト値: True

KeyList XSICollection 作成されたシェイプ キーのリスト。
ClipList XSICollection 作成されたシェイプ クリップのリスト。

VBScript の例

'

' This example creates an animated deformation (twist on a torus).

' Then, it replaces the animation by 4 shapes, placed at regular

' intervals. The twist op is completely replaced by shapes,

' with a similar result.

'

' The shapes created by the plotting operation are written to the log.

'

' Set up a twist deformation on a torus

NewScene , false

CreatePrim "Torus", "MeshSurface"

SetValue "torus.polymsh.geom.subdivu", 24

SetValue "torus.polymsh.geom.subdivu", 40

SetValue "torus.polymsh.geom.subdivv", 24

ApplyOp "Twist", "torus", 3, siPersistentOperation

SaveKey "torus.polymsh.twistop.angle", 1, 90

SetValue "PlayControl.Key", 50

SetValue "PlayControl.Current", 50

SetValue "torus.polymsh.twistop.angle", -90

SaveKey "torus.polymsh.twistop.angle", 50, -90

SetValue "PlayControl.Current", 1

' Plot the animation in shapes, from frame 0 to 50, in steps of 10 frames

Dim CreatedClips, CreatedShapes

PlotShape "torus", "twisted", 1, 50, 10, True, siShapeMixedWeightMode, siShapeContentAllDeforms, _ 

	siShapeAbsoluteReferenceMode, false, CreatedShapes, CreatedClips

' We can now delete the twist, and we will still have a similar result from the 5 shapes

DeleteObj "torus.polymsh.twistop"

for i = 0 to CreatedClips.Count-1

	Application.LogMessage "Created shape: " & CreatedShapes(i)

next

'This example outputs the following information to the Script Editor in Softimage: 

'

''INFO : Created shape: torus.polymsh.cls.twisted.twisted1

'INFO : Created shape: torus.polymsh.cls.twisted.twisted2

'INFO : Created shape: torus.polymsh.cls.twisted.twisted3

'INFO : Created shape: torus.polymsh.cls.twisted.twisted4

'INFO : Created shape: torus.polymsh.cls.twisted.twisted5