Add2DShapePoint

導入

v3.0

詳細

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

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

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

スクリプト構文

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

戻り値

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

パラメータ

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

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

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

x Double 新しいポイントの X 軸上の位置を指定
y Double 新しいポイントの 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