Apple Shake 4 - Manual (Page 96)

96 Chapter 2 Setting a Script’s Global Parameters
defaultViewerAspectRatio
This value corrects the aspect ratio of the image displayed by the Viewer to account for
images using nonsquare pixels. The defaultViewerAspectRatio parameter is for display
only, and has no effect on rendered output.
Changing any format subparameter sets the format pop-up menu to Custom. If there’s
a particular custom format that you use frequently, you can add it to the Format pop-
up list. For more information on adding entries to the format pop-up menu, see
“
Customizing the Format Pop-Up Menu ” on page 96.
defaultBytes
Sets the default bit rate for Shake-generated images. The defaultBytes parameter has
no effect on images that are read in via FileIn nodes, nor does it affect the rendered
output from your script.
viewerZoom
The zoom level applied to the Viewer. This value has no effect on the output resolution
of your script.
viewerAspectRatio
When set to formatDefault, this parameter scales the X axis of the Viewer by the
defaultViewerAspectRatio parameter, located within the format subtree. When this
parameter is set to custom, you can change it to whatever value you want. This is
usually used to compensate for the nonsquare pixel ratios of video. For anamorphic
film frames, you typically use the proxyRatio to scale down the Viewer’s Y axis.
renderControls
These parameters affect how Shake renders material processed by the currently open
script.
fieldRendering
When fieldRendering is set to 0, progressive scan/full frames are rendered. When set to
1, the odd field takes precedence, meaning it is the first line at the top. For more
information on setting up your script to render fields properly, see “
The Basics of
Processing Interlaced Video ” on page 191.
Customizing the Format Pop-Up Menu
You can create your own formats in a startup.h file. In $HOME/nreal/include/startup,
add a line in the following format:
DefFormatType(“Name”, defaultWidth, defaultHeight, defaultAspect,
defaultViewerAspectRatio, framesPerSecond, fieldRendering)
For example:
DefFormatType(“NTSC (D1 4:3)”, 720, 486, 1/.9f, 0.9f, 29.97,0);