| On this page |
このノードは、ポイントの位置や法線方向に基づいて、またはその両方に基づいて画像の一部をキーイングします。 このノードには、ポイント平面および/または法線平面が必要です。
Geokeyは、Bright COPのような色補正COPで使用できるマスクを生成することにより、ポイントライトおよび無限のソースから照明をシミュレーションすることができます。 また、ポイントやデプス情報が存在する場合、最前面または最背面のオブジェクトを切り抜くことができます。
Overloading VEX Parameters ¶
This operator is implemented in VEX, which supports parameter overloading. If the first input has a plane which matches an operation parameter’s channel name, the input plane will be used as the parameter’s value, effectively overriding it. The overloaded parameter is then evaluated from the plane on a per-pixel basis.
eg. If the input COP has the following planes:
C{r,g,b}
A
fogdensand it is fed into a VEX Fog COP, the fog density will be determined at each pixel by the fogdens plane, since the Fog Density parameter’s channel name matches the 'fogdens' channel name.
パラメータ ¶
Geokey ¶
Key Operation
Distance from Point
指定したポイントから一定の距離内にあるピクセルすべてをキーイングします(ポイント平面が必要)。
Normal Direction
指定した法線と同じ方向を向いた法線を持つピクセルすべてをキーイングします(法線平面が必要)。
Angle from Point
指定したポイントを指す法線を持つピクセルすべてをキーイングします(ポイント平面と法線平面が必要)。
Distance & Angle
From Pointで指定したポイントを指す法線を持つピクセルすべてを一定の距離内でキーイングします(ポイント平面法線平面が必要)。
Clip Plane
片側のクリップ平面にあるすべてのピクセルをキーイングします(ポイント平面が必要)。
Point Origin
'Distance from Point'、'Angle From Point'および'Distance & Angle'で、キーイングの基準になる3Dポイント。
Point Distance
キーイングを停止するポイントからの距離。
Distance Dropoff
距離半径後のドロップオフ領域のサイズ。
Normal Direction
キーイングの基準になる法線方向。
Normal Deviation
指定した法線の許容誤差となる角度。
Normal Dropoff
Normal Deviationの後の減衰の度合い。
Rolloff
Normal Dropoff領域のドロップオフ形状。
Clipping Plane
クリップ平面の方向。
Clip Plane Normal
ユーザ定義のクリップ平面の法線。
Clip Plane Origin
このポイントを通過するようにクリップ平面を動かします。
Supersample
1方向のピクセル毎にサンプリングされるサブピクセルの数(2つのサンプル： 4ピクセル、3つのサンプル：9ピクセル)。 サブサンプルを増やすと、パフォーマンスは下がりますが、エッジがきれいになります。
Discard Keyed Region
オンの場合、キーイングした領域は破棄されます。オフの場合、キーイングした領域のみが維持されます。
Mask ¶
A mask can be chosen to limit the effect of the operator to areas defined by the mask. The mask can be taken from the mask input (side input) or from the first input itself.
Effect Amount
If no mask is present, this blends the output with the input by a constant amount (0 = all input, 1 = all output).
If a mask is present, this amount multiplies the mask.
Operation Mask
Selects the mask plane to use as a mask from the mask input. The mask can be selected from:
A mask can be a component of a plane or an entire plane. If a vector plane is supplied as a mask, its components are multiplied by the images' components.
Scalar Mask ('A', 'C.r')
C.r = I.r * M C.g = I.g * M C.b = I.b * M
Vector Mask ('C')
C.r = I.r * M.r C.g = I.g * M.g C.b = I.b * M.b
First Input
Useful for masking the operation to the image’s own alpha plane.
Mask Input
Selects the mask from the side mask input.
Off
Turns off masking, without requiring disconnection of the mask input (useful for temporarily disabling the mask).
Resize Mask to Fit Image
If the mask image is a different resolution than the output image, turning on this parameter will scale the mask to the output image’s resolution.
If this node is changing constantly, and the mask is not, it is somewhat faster to put a Scale COP down to do the resize for the mask image. Otherwise, the scale will occur every time this node cooks.
Invert Mask
Inverts the mask so that all fully 'masked' portions become unmasked. This saves you from inserting an Invert COP after the node with the mask.
Scope ¶
Plane Scope
Specifies the scope for both the RGB components of Color, Alpha, and other planes. The (C)RGBA mask only affects Color components and Alpha. 'C' will toggle all the RGB components.
For planes other than Color and Alpha, the plane name (plus component, if applicable) should be specified in the string field. The pulldown menu can be used to select planes or components present in this node.
A plane is specified by its name. A component is specified by both its plane and component name. The '*' wildcard may be used to scope all extra planes. Any number of planes or components can be specified, separated by spaces.
Examples:
P N.x N.y P N Pz
Frame Scope ¶
Frame Scope
Allows scoping of specific frames in the frame range. This is in addition to the plane scope (so a plane at a certain frame must be both plane scoped and frame scoped to be modified).
All Frames
All frames are scoped.
Inside Range
All frames inside a subrange are scoped.
Outside Range
All frames outside a subrange are scoped.
Even Frames
Even numbered frames are scoped.
Odd Frames
Odd numbered frames are scoped.
Specific Frames
A user-defined list of frames are scoped.
Frame Range
For Inside/Outside range, this parameter specifies the subrange of the sequence to scope (or unscope). This can be edited in Timeline viewer mode (⌃ Ctrl + 2 in viewer).
Frame Dropoff
For Inside/Outside Range, this parameter specifies certain number of frames before and after to slowly ramp up to scoped. The operation will be blended with its input to 'ease in' or 'ease out' the scoping effect over a number of frames. This can be edited in Timeline viewer mode (⌃ Ctrl + 2 in viewer).
Non-scoped Effect
For unscoped frames, this sets the blend factor between the input and modified images. Normally this is zero (use the input image). By setting this to a non-zero value, you can make unscoped frames be 'slightly' unscoped. The value can vary between 0 (unscoped) and 1 (scoped).
Frame List
The frame list for 'Specific Frames'. Frame numbers should be separated by spaces.
Automatically Adjust for Length Changes
If the sequence range changes, enabling this parameter will adjust the subrange and frame dropoff lengths to fit the new range.
ローカル変数 ¶
L
Sequence length
S
Start of sequence
E
End of sequence
IL
Input sequence length
SR
Sequence frame rate
NP
Number of planes in sequence
W,H
Width and height of image
I
Image index (0 at start frame)
IT
Image time (0 at start frame)
AI
Current plane array index
PI
Current plane index
PC
Num of channels in current plane
CXRES
Composite Project X resolution
CYRES
Composite Project Y resolution
CPIXA
Composite Project pixel aspect ratio
CDEPTH
Composite Project raster depth
CBP
Composite Project black point
CWP
Composite Project white point
Examples ¶
GeokeyBasics Example for Geokey compositing node
このサンプルでは、3D情報を使ってマットやローカル修正用に画像の一部を抽出する方法を説明しています。 このサンプルでは、Geokey COPを使用しています。
