8

Command-Line Rendering Switches 209
On/Off Command-Line Switches
Manyoftheswitchesyou’llusearesimpleon/off
toggles, such as the -rfw: or -renderFields:
switches. If you prefer, instead of using a 1 or 0
to designate their st ates, you can also use Tr ue or
Fal se. For example, to render a scene to a specified
file type and display the Rendered Frame Window,
your command line might look like this;
“c:\progr a m fi les\autodesk\3dsmax 8\
3dsm axcmd” -out putNam e=“c:\progr a m
files\autodesk\3dsmax8\renderoutput\
myImage.jp g ” -rfw =tru e “c:\p ro gra m
files\autodesk\3dsmax8\scenes\myscene.max”
Basic Options
Switch Effect
-?
Displays a list of these switches in the
DOS window.
-x
Shows a list of example command
lines.
-v: #
Sets the verbosity level, where # is
an integer from 0 (least verbose) to 5
(most verbose).
@ command_file
or -cmdFile:
command_file
Pointstoaseparatefilecontaining
command-line options.
-preset:
<filename> or
-rps:
<filename>
Uses a render preset file where
<filename> isthenameofthepreset
file.
-sceneState:
<scene-state-
name>
Loads the specified scene state file
before rendering the image.
-batchRender
Renders all enabled tasks in the Batch
Render dialog.
-batchRender:
<batch-render-
name>
Renders batch renders in the file
named
batch-render-name .
-preRenderScript:
<filename> or
-script:
<filename>
Uses a pre-render script w here
<filename> is the name of the script
file.
-postRenderScript:
<filename>
Uses a post-render script where
<filename> is the name of the script
file.
Switch Ef fect
-workPath:
<pathname>
Root location for job data folders.
-pathFile:
<pathname>
Path configuration file (MXP format).
-bitmapPath:
<pathname>
(obsolete) Provides an extra bitmap
path. Multiple paths can be entered
and UNC naming conventions can be
used.
-xrefPath:
<pathname>
(obsolete) Lets you specify extra XRef
paths. Multiple paths can be entered
and UNC naming conventions can be
used.
-split: <strips,
overlap>
Split render; num ber of strips, ove rlap
amount.
-dateFormat :
<dateformat>
Specifies a date format to be
used in message timestamp, at
verbosity level 5. Defaults to
locale-depe n de nt form at. For details,
use the
3dsmaxcmd -x option.
-timeFormat :
<timeformat>
Specifies a time format to be used
in message timestamp, at verbosity
level 5. Defaults to locale-dependent
format and 24– hour clock. For details,
use the
3dsmaxcmd -x option.
Render Parameters
Note: Any command-line switches that are on/off
toggles can be switched by entering either 1, 0, on
or off.
Switch Effect
-outputName: <filename>
or -o: <filename>
Sets an output file name and
format.
-camera: <string> or
-cam:
<string>
Specifies a camera name.
-width: <integer> or
-w:
<integer>
Sets the output width in
pixels.
-height: <integer> or
-h:
<integer>
Sets the output height in
pixels.
-pixelAspect: <number> Sets the pixel aspect ratio.
-start: <integer>
Sets the rendering sequence
start frame.
-end <integer> Sets the rendering sequence
end f rame.