Add2DShapePoint

導入

v3.0

カテゴリ

レンダリング

詳細

2D シェイプ(マスク シェイプ)に、ポイントを 1 つ追加します。

このコマンドと Insert2DShapePoint コマンドは、Add2DShapePoint がシェイプの作成時にオリジナルのポイント セットを定義するために使用するコマンドであるのに対し、Insert2DShapePoint は作成された既存のシェイプにポイントを追加する際に使用するコマンドである点が異なります。

注: ポイントは、Add2DShapePoint または Add2DShapePointArray コマンドのいずれかを使用して追加することができます。

スクリプト構文

oLong = Add2DShapePoint( [Shape], x, y );

戻り値

新しいポイントのインデックスを Long の値で戻します。

パラメータ

パラメータ タイプ 詳細
Shape 文字列 ポイントを定義するシェイプのパラメータ パス名

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

注: 現在の選択が有効なリストでないと、エラーが発生します。

x ダブル 新しいポイントの X 軸上の位置を指定
y ダブル 新しいポイントの Y 軸上の位置を指定

VBScript の例

'
' This example demonstrates how to set a garbage matte mask for a 
' ColorCorrect operator in the FxTree.
'
' 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 
set oRotospline = Add2DShape( oGBMatteOp & ".GarbageShapes", "Polygon" )
Move2DShapePin oRotospline, 122.571428571429, 141.285714285714
Add2DShapePoint oRotospline, 89, 192
Add2DShapePoint oRotospline, 169, 174
Add2DShapePoint oRotospline, 182, 99
Add2DShapePoint oRotospline, 128, 64
Add2DShapePoint oRotospline, 153, 124
Add2DShapePoint oRotospline, 88, 152
Add2DShapePoint oRotospline, 49, 184

関連項目

Add2DShape Add2DShapePointArray Insert2DShapePoint Delete2DShapePoint