CameraShake

Adds simulated camera shake to a sequence using random changes in amplitude, rotation, scale, and so on. Also includes shutter controls to produce motion blur.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The sequence to which the camera shake is applied.

Control (UI)

Knob (Scripting)

Default Value

Function

CameraShake Tab

amplitude

amplitude

10

Sets the size (pixels) of the shake.

rotation

rotation

0

Sets the maximum rotation (degrees) around the cs_center.

scaling

scaling

0

Sets the maximum scale fluctuation.

frequency

frequency

0.5

Sets the lowest frequency (cycles per frame) of the shake.

octaves

octaves

2

Adds higher frequency to the camera shake, in addition to the basic shake, producing a more random shake.

seed

seed

0

Sets the seed used to create the random shake pattern. You can change this number to produce a slightly different pattern.

You can copy this seed to other CameraShake nodes to copy the shake motion.

Randomize Seed

randomize_seed

N/A

Click to create a random seed for the shake pattern.

fixed scale

scale

1

Scales the sequence to ensure the edges of the image don’t enter the frame during extreme camera shake.

center xy

cs_center

N/A

The center of the camera shake scale and rotation.

filter

filter

Cubic

Select the filtering algorithm to use when remapping pixels from their original positions to new positions. This allows you to avoid problems with image quality, particularly in high contrast areas of the frame (where highly aliased, or jaggy, edges may appear if pixels are not filtered and retain their original values).

Impulse - remapped pixels carry their original values.

Cubic - remapped pixels receive some smoothing.

Keys - remapped pixels receive some smoothing, plus minor sharpening (as shown by the negative -y portions of the curve).

Simon - remapped pixels receive some smoothing, plus medium sharpening (as shown by the negative -y portions of the curve).

Rifman - remapped pixels receive some smoothing, plus significant sharpening (as shown by the negative -y portions of the curve).

Mitchell - remapped pixels receive some smoothing, plus blurring to hide pixelation.

Parzen - remapped pixels receive the greatest smoothing of all filters.

Notch - remapped pixels receive flat smoothing (which tends to hide moire patterns).

Lanczos4, Lanczos6, and Sinc4 - remapped pixels receive sharpening which can be useful for scaling down. Lanczos4 provides the least sharpening and Sinc4 the most.

clamp

clamp

disabled

When using filters that employ sharpening, such as Rifman and Lanczos, you may see a haloing effect. If necessary, check clamp to correct this problem.

crop

black_outside

disabled

When disabled, the outside area is filled with the outermost pixels of the image sequence.

When enabled, this renders as black pixels outside the image boundary, making it easier to layer the element over another.

Note:  This control also adds a solid alpha covering the input image area if no alpha is present.

motionblur

motionblur

1

Sets the number of motion blur samples. A value of 1 should produce reasonable results for most sequences.

Increase the value to produce more samples for higher quality, or decrease it to shorten the processing time. The higher the value, the smoother the result.

shutter

shutter

0.5

Enter the number of frames the shutter stays open when motion blurring. For example, a value of 0.5 corresponds to half a frame. Increasing the value produces more blur, and decreasing the value less.

shutter offset

shutteroffset

centered

This value controls how the shutter behaves with respect to the current frame value. It has four options:

centred - center the shutter around the current frame. For example, if you set the shutter value to 1 and your current frame is 30, the shutter stays open from frame 29,5 to 30,5.

start - open the shutter at the current frame. For example, if you set the shutter value to 1 and your current frame is 30, the shutter stays open from frame 30 to 31.

end - close the shutter at the current frame. For example, if you set the shutter value to 1 and your current frame is 30, the shutter stays open from frame 29 to 30.

custom - open the shutter at the time you specify. In the field next to the dropdown menu, enter a value (in frames) you want to add to the current frame. To open the shutter before the current frame, enter a negative value. For example, a value of - 0.5 would open the shutter half a frame before the current frame.

shuttercustomoffset

0

If the shutter offset control is set to custom, this field is used to set the time that the shutter opens by adding it to the current frame. Values are in frames, so -0.5 would open the shutter half a frame before the current frame.