Move2DShapeRHandle

導入

v3.0

カテゴリ

レンダリング

詳細

ベジェ 2D シェイプ上のポイントの右ハンドルを移動し、シェイプに合うよう調整します。 このコマンドは、ベジェ シェイプ上の任意の 2 点間の線上をクリック アンド ドラッグしてハンドルを取得し、右ハンドルを調整する操作に相当します。

注: Move2DShapePoint コマンドを使用して、シェイプ上のポイントを移動することもできます。

スクリプト構文

Move2DShapeRHandle( [Shape], [index], [x], [y] );

パラメータ

パラメータ タイプ 詳細
Shape 文字列 ハンドルを移動するシェイプのパラメータ パス名

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

注: 現在の選択が有効なシェイプでないと、エラーが発生します。

index Long 操作するポイントのインデックスを指定

デフォルト値:この引数に対する値が指定されていない場合、シェイプの 1 番目のポイントの右ハンドルが移動されます。

x ダブル ハンドルの、X 軸上の新しい位置を指定

デフォルト値: 0

y ダブル ハンドルの、Y 軸上の新しい位置を指定

デフォルト値: 0

VBScript の例

'
' This example demonstrates how to set a garbage matte mask for a 
' ColorCorrect operator in the FxTree and then use the bezier handles
' to refine it.
'
' Create a new FxTree 
set oTree = CreateFxTree()
' Get the projects path for the current system
sPath = InstallationPath( siProjectPath )
set oClip = CreateImageClip( sPath & "\Pictures\noIcon.pic", "NewClip" )
' Use the clip to create a new image clip operator
set oOperator = AddImageClipFxOp( oTree, oClip )
' Add a Color Correct operator to the same tree
set oCCOp = AddFxOp( oTree, "Color Correct" )
' Connect the two operators
ConnectFxOp oOperator, oCCOp, "1" 
' Since the ConnectFxOp command does not return the new operator,
' you need to get it from the OperatorCollection on the FxTree object
for each oMember in oTree.FxOperators
        if oMember.Name = "ColorCorrect" then
                set oGBMatteOp = oMember
                exit for
        end if
next
' Adjust the HSV Offset and Gain levels so you can see the 
' results of the color correction
SetValue oGBMatteOp.FullName & ".MasterHueShift," _
                & oGBMatteOp.FullName & ".MasterOffset," _
                & oGBMatteOp.FullName & ".MasterGain", _
                Array(0, 0.820731514055631, 0.852844886888196)
' Add the 2D shape (mask shape) to the GarbageMatte and reshape it so you can see
' the shape when you open the Fx Viewer with the ColorCorrect operator selected
set oRotospline = Add2DShape( oGBMatteOp & ".GarbageShapes", "Bezier" )
Move2DShapePin oRotospline, 124.333333333333, 145.166666666667
aPointPositions = Array(56, 207, 196, 170, 179, 85, 132, 142, 108, 105, 75, 162)
Add2DShapePointArray oRotospline, aPointPositions
' Move the right handle of the first point and the left handle of the second
' point to create an arc on the top part of the shape
Move2DShapeRHandle oRotospline, , 15.0845123157596, 50.9829157526202
Move2DShapeLHandle oRotospline, 1, 15.0845123157597, 50.9829157526202

関連項目

Add2DShape Insert2DShapePoint Move2DShapePoint Move2DShapeLHandle Delete2DShapePoint