Move3D
Function
This is function allows you to do perspective changes by rotating and visually
moving the image in depth. It is similar in behavior to the Move2D
function.
Some parameters, like zPan, will have no effect unless you change the fieldOfView parameter to a value greater than 0. The angle of the Z axis is controlled, as in Move2D, by the angle parameter. There is no shearing, but by rotating the image in Y or X, and keeping the fieldOfView at 0, you can get orthagonal shearing effects.
Parameters
|
Type
|
Defaults
|
Function
|
x,y,zPan |
float
|
0, 0, 0 | x, y, and z Pan values. zPan will have no effect unless you change the fieldOfView value to be greater than 0. |
x, y, zAngle |
float
|
0, 0, 0 | The rotation angles around the X, Y, and Z axis. |
aspectRatio |
float
|
1 | The aspectRatio of the image. Useful when you are working with a Global aspectRatio and anamorphic frames and you are doing a rotation. |
x,y,zScale |
float
|
1, 1, 1 | Scaling on the x, y, and z axis. |
x,yFilter |
string
|
"default", "default" | Jump to Filter Types |
transformOrder |
string
|
"trsx" |
The order the transform is executed, with t = translate By default, this is set to "trs". For those of you trying to transfer camera setups from 3D applications, note that this is the order transforms are pushed onto the matrix and that rotations are applied in the order x, z, y. |
inverseTransform |
int
|
0 |
This inverts the transform. This can quickly convert tracking data to stabilization data. |
fieldOfView |
float
|
0 | This designates the vertical field of view and affects the appearance of perspective shift. When this is 0, the view is considered to be orthogonal, with increasing perspective changes done when you combine zPan, angleX, and angleY with a higher fieldOfView. |
motionBlur |
float
|
0 | Motion Blur quality level. 0 means no blur, whereas 1 represents standard filtering. For more speed, use less than 1. This value gets multiplied by the Global Parameter motionBlur. |
shutterTiming |
float
|
.5 | Shutter length. 0 means no blur, whereas 1 represent a whole frame of blur. Note that standard camera blur is 180 degrees, or a value of .5. This value gets multiplied by the Global Parameter shutterTiming. |
shutterOffset |
float
|
0 | This is the offset from the current frame at which the blur is calculated. Default is 0, previous frames are less than 0. |
useReference |
int
|
0 |
Applies the transform to the image or doesn't. If it doesn't, and you have animated values, it will apply a motion blur to the image, but not actually move it. This is good for adding blur to plates. See the Fan Tutorial for an example. 0 = Move image |
referenceFrame |
int
|
time | This is used for stabilization. Usually, this is set to "time", i.e., in reference to itself. However, if you have toggled inverseTransform to 1, you are doing stabilization, with the assumption that any animation you have applied matches up to the source animation. Setting the reference frame will lock the movement in to a specific frame. |
Synopsis
image Move3D( image, float xPan, float yPan, float zPan, float angle, float angleX, float angleY, float aspectRatio, float xScale, float yScale, float zScale, float xCenter, float yCenter, float zCenter, const char * xFilter, const char * yFilter, const char * transformationOrder, int inverseTransform, float fieldOfView, float motionBlur, float shutterTiming, float shutterOffset, int useReference, float referenceFrame );
Script
image = Move3D( image, xPan, yPan, zPan angle, angleX, angleY, aspectRatio, xScale, yScale, zScale xCenter, yCenter, zCenter, "xFilter", "yFilter", "transformOrder", inverseTransform, fieldOfView, motionBlur, shutterTiming, shutterOffset, useReference, referenceFrame );
Command Line
shake -move3d xPan yPan zPan angle aspectRatio etc....