PFTrack Documentation Node Reference  

Edit Camera

UI

The Edit Camera node can be used to manually edit a camera path, or import additional data files that specify camera position, orientation and focal length. Cameras may be edited manually after a camera solve, or before a camera solve in order to provide a hint to the solver.

Focal length information can be imported via XML or ASCII text. Camera position, rotation and focal length can be imported via XML, AutoDesk FBX or Alembic formats.

Controls

Import

Import Focal: Display a file dialog for importing either an XML or ASCII text file containing camera focal length information (see below for file formats).

Import Camera: Display a file dialog for importing either an XML, Autodesk FBX 2010 or Open Alembic file containing camera position, rotation and focal length. When importing an FBX file, a take can be selected if the file provides more than one. A frame offset can also be applied to the animation keys stored in the take before importing.

Camera

Translate: The X, Y and Z translation parameter for the camera at the current frame.

Rotate: The X, Y and Z Euler rotation angles (measured in degrees) for the camera at the current frame

Focal length: The current camera focal length. Enabling the Variable focal option will allow focal length to be adjusted independently in each frame.

Field of view: The current horizontal and vertical field of view, measured in degrees.

Sensor size: The current sensor/film back width and height.

Pixel aspect: The current pixel aspect ratio.

Lock roll: When the Edit mode is set to either Fly or Pin Trackers, enabling this option will lock the camera roll (Z rotation) at its current value and prevent it from being adjusted.

Lock focal: When the camera has a variable focal length and Edit mode is set to Pin Trackers, enabling this option will prevent the focal length from being adjusted.

Transform

Edit mode: The transformation mode with which to edit the camera. Look-at displays a camera look-at point that can be adjusted in a Viewer window. Both the camera and look-at point can be adjusted by clicking and dragging with the left mouse button in a Viewer window. Holding the Ctrl key will allow both the camera and look-at point to be adjusted at the same time.

Translate, Rotate and Scale modes will display a manipulator widget. When Fly mode is set, the transformation can be adjusted in the Cinema window by holding the Alt/Option key and using the left, middle or right mouse buttons to rotate, scale and translate accordingly. Finally, Pin Trackers mode can be used to drag a solved (or surveyed) tracker into position in the Cinema window. As multiple trackers are pinned in one frame, the camera position and/or rotation will be updated to better match the pin positions. The Shift+D keyboard shortcut will remove a pin whilst hovering the mouse over a pin. Pinned trackers can be highlighted by ensuring either Show Names or Show Info is enabled.

Transform origin: Specify whether transformations will be applied around the current camera position or the ground-plane origin. This option is only available when Edit mode is set to Translate, Rotate, Scale or Fly.

Remove Key: Remove the current keyframe from the camera path. This will mean camera motion is now interpolated between nearby keyframes.

Smooth Path: Use a smooth Bezier curve will be used to interpolate between camera keyframes as they are adjusted.

Display

Show Ground: When enabled, the ground plane will be displayed

Show Horizon: When enabled, the horizon line will be displayed

Show Names: When enabled, pinned tracker names will be displayed in the Cinema window when Edit mode is set to Pin Trackers.

Show Info: When enabled, pinned tracker positions will be displayed in the Cinema window when Edit mode is set to Pin Trackers.

Example ASCII text import

Here is an Example ASCII text file for focal length import, containing pairs of frame number and focal length in millimeters:

40 19.7964
41 19.8052
42 19.8132
43 19.8309
44 19.8362

Example XML import

Here is an example XML file for camera import. This is the same format as generated during export by the XML export script.

Note that the same XML file format is used for both focal length import and full camera import, although in the former case, the and elements are ignored.

<xml>
<pfcamera>

<coordinateSystem>right</coordinateSystem>
<upVector>y</upVector>
<rotationOrder>xyz</rotationOrder>

<pixelAspect>1</pixelAspect>
<filmBack>36 28.8 mm</filmBack>
<frameSize>720 576</frameSize>

<focalLength frame='1'>68.0922 mm</focalLength>
<focalLength frame='2'>68.0922 mm</focalLength>
<focalLength frame='3'>68.0922 mm</focalLength>
<focalLength frame='4'>68.0922 mm</focalLength>

<translation frame='1'>3 1.5 -4</translation>
<translation frame='2'>3.00037 1.49942 -3.99822</translation>
<translation frame='3'>3.00036 1.49882 -3.99569</translation>
<translation frame='4'>3.00037 1.49816 -3.99315</translation>

<rotation frame='1'>174.289 36.8699 180</rotation>
<rotation frame='2'>174.191 36.6584 179.915</rotation>
<rotation frame='3'>174.049 36.5137 179.785</rotation>
<rotation frame='4'>173.904 36.4209 179.699</rotation>

</pfcamera>
</xml>

Default Keyboard Shortcuts

Keyboard shortcuts can be customised in the Preferences.

Look-at Shift+A
Translate Shift+T
Rotate Shift+R
Scale Shift+S
Fly Shift+F
Pin Trackers Shift+P
Origin Camera Shift+O
Origin Ground Shift+G
Remove Key Shift+V
Remove Pin Shift+D
Smooth Path Shift+Z
Lock Roll Shift+L
Lock Focal Shift+C
Show Ground Ctrl+G
Show Horizon Ctrl+H
Show Names Ctrl+N
Show Info Ctrl+I
Show Frustum Ctrl+F

-----

FBX is registered trademarks of Autodesk Inc. in the USA and other countries.

Alembic is trademark of and copyright 2009-2015 Lucasfilm Entertainment Company Ltd. or Lucasfilm Ltd. All rights reserved. Industrial Light & Magic, ILM and the Bulb and Gear design logo are all registered trademarks or service marks of Lucasfilm Ltd. Copyright 2009-2015 Sony Pictures Imageworks Inc. All rights reserved.