You are here: User Guide > NukeX > Tracking with PlanarTracker > Placing an Image on the Planar Surface

Placing an Image on the Planar Surface

When you’ve tracked a planar surface on your footage, you might want to place an image on it. To do this:

1.   Make sure you’re on the reference frame you’ve drawn the roto shape on, and select the PlanarTrackLayer you want to use in the Create New Track dropdown on top of the Viewer.
2.   Check show plane and correct plane on the properties panel to make your planar surface visible and to enable modifying it. You can also click the corresponding buttons above the Viewer.
3.   A rectangle indicates your planar surface in the Viewer. If the rectangle is very large, you can click the Resize Planar Surface to Image button in the Viewer.
4.   Drag the corners of the rectangle to cover the area over which you want to place an image. Click the Show grid lines button in the Viewer to use a guide grid in positioning your rectangle. This shows grid lines corresponding with the current plane and it helps with realigning your plane.

Planar surface with a grid on a roto shape.
5.   Scrub in the timeline to make sure the planar surface sticks to the area you want. You can adjust it:

in the reference frame to change the planar surface over the whole footage. This way you’re adjusting the actual dimensions of the planar surface rectangle. The rectangle appears in yellow.

in other frames to change the planar surface in the current frame and its adjacent frames. This way you’re correcting small drifts in the planar surface rectangle without changing its real dimensions. The rectangle appears in blue.

6.   The values in the transform matrix show how your plane has warped from the reference frame to the current frame. Adjust them in the Curve Editor by right-clicking over the matrix and selecting Curve Editor....

NOTE:  While you can drag the matrix to another node’s matrix to easily use the values elsewhere, you shouldn’t try to drag a 4 by 4 matrix on a 3 by 3 matrix as doing that might have unexpected results.

7.   When you’re happy with the planar surface rectangle, you can add a CornerPin node to help you place an image on the plane. Click the Create CornerPin2D Node dropdown in the Viewer (or use the Export dropdown in the properties panel) and select the type of corner pinning you want to use:

relative - to warp the image according to the relative transform between the current frame and the reference frame. The image remains unchanged in the reference frame. You can also pick the baked version of the relative CornerPin node. A baked node has the keyframe values copied from PlanarTracker, rather than having them expression linked.

absolute - to use the to and from controls to place the image exactly within the selected plane. This may skew the image throughout the footage. This attaches and automatically sets its format to the dimensions of any currently selected node. You can also pick the baked version of the absolute CornerPin node. A baked node has the keyframe values copied from PlanarTracker, rather than having them expression linked.

stabilize - to apply an inverse transform on the image, which effectively locks the image in its place and stabilizes it in the footage. This type of corner pinning is most useful for drift corrections and making sure your tracking results are reliable. You can also select Tracker to create a baked Tracker node for further reducing jitter. You can also pick the baked version of the stabilize CornerPin node. A baked node has the keyframe values copied from PlanarTracker, rather than having them expression linked.

8.   Make sure the footage and the image have the same format and attach the image you want to place in your footage in the CornerPin node’s input. You also need to make sure the from coordinates match the image you're trying to place. You can click the set input button in the CornerPin node to do that for you. If you create an absolute CornerPin and you have the node of your image selected, CornerPin is automatically hooked up to the image and the from coordinates are set.
9.   Create a Merge node and attach the CornerPin node to its A input, and the footage to the B input. Now, when you attach your Viewer in the Merge node output, the transform is applied. See the figure below for an example of a node tree that you might get when placing an image on a planar surface.

Placing an image on a planar surface.

Adjusting the Planar Surface with the Four-Corner Output Controls

Instead of modifying the coordinates of your planar surface corners in the Viewer, you can also use the four-corner output controls:

1.   Adjust the track result coordinates of the planar surface, shown as a blue rectangle outside of the reference frame:

bottom left - the x and y values of the bottom left corner.

top left - the x and y values of the top left corner.

top right - the x and y values of the top right corner.

bottom right - the x and y values of the bottom right corner.

2.   Under Planar surface are the actual planar surface coordinates, shown as a yellow rectangle in the reference frame. Adjust:

bottom left - the x and y values of the bottom left corner.

top left - the x and y values of the top left corner.

top right - the x and y values of the top right corner.

bottom right - the x and y values of the bottom right corner.

3.   If you correct the planar surface in different frames, PlanarTracker turns those to keyframes. You can browse them backwards and forwards with the corrected keyframes buttons.