v3.0
Rotates the 2D shape (mask shape). This is the scripting equivalent of
selecting the shape, clicking on the Rotate tool (in the ColorCorrect
property editor), and then dragging any of the handles on its bounding box
to make the object rotate.
Note: You may want to change where the center, or pin, of the shape appears
before scaling it. For example, if you move the pin to the left of the shape
and then rotate it, the shape pivots from the left. To move the pin of the
shape, use the Move2DShapePin command.
Set2DShapeRotation( [Shape], angle ); |
| Parameter | Type | Description |
|---|---|---|
| Shape | String |
Parameter path name for the shape you are scaling. Default Value:
Current selection. |
| angle | Double | Specifies the new angle of the rotation. |
' ' This example demonstrates how to set a garbage matte mask for a ' ColorCorrect operator in the FxTree, scale it, change the position ' of its center and then rotate it around the new center. ' ' 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", "Polygon" ) Move2DShapePin oRotospline, 114.75, 143 Add2DShapePoint oRotospline, 44, 194 Add2DShapePoint oRotospline, 65, 78 Add2DShapePoint oRotospline, 116, 138 Add2DShapePoint oRotospline, 169, 84 Add2DShapePoint oRotospline, 180, 207 Add2DShapePoint oRotospline, 153, 137 Add2DShapePoint oRotospline, 114, 172 Add2DShapePoint oRotospline, 77, 134 ' Make the shape a little smaller Scale2DShape oRotospline, 0.875486381322957, 0.784615384615384 ' Pivot the shape on its bottom right corner Move2DShapePin oRotospline, 154.75, 69 Set2DShapeRotation oRotospline, -50.6836714968651 |