'Maya'

 
'Command Line Rendering'
by
Peter Stratton



Introduction:

This tutorial is geared towards Maya users with little or no experience working in the Windows Shell.  It was written to help students in a class I was in to help them better understand how to launch batch renders from the command line, and how to create batch scripts to execute a number of separate file renders automatically. 

Command line rendering allocates more system resources to the render processes than if one were to render with Maya open.  Additionally, in an environment using a license and a server (such as in most universities and large businesses) there are often more users than there are licenses!  So, in addition to being less efficient and more unstable, batch rendering from within Maya locks up a license unnecessarily.  All in all, unless it's for a preview, it's better to render with Maya closed!

Step 1:

Make sure you have set up a “project file” in Maya.  This step should have been done at the very start of an assignment, but it can technically be done at anytime.  To set up a project up go to: File > Project > New (Fig.01).

(Fig01)

You will then get the New Project dialogue box (Fig.02). Click the “Use Defaults” button at the bottom and specify the name of the project and the location where you'd like it stored.  Don't use any spaces or funny characters in your scene names or filenames – it's just easier in the long run if you don't!

(Fig02)

For the remainder of this tutorial I'm going to use the project name “MidTerm”.  The location of the MidTerm project is going to be G:\DIGM211\MidTerm.  To find your file path, navigate to your project and look at the file path box in the explorer window (Fig.03).With your project set, any files you save while working within the project will be stored in their proper folders.  This is priceless!  Maya does most of the work for you, but what you need to do before you start rendering animations is to go into the “images” folder of your project and MAKE INDIVIDUAL FOLDERS FOR EACH AND EVERY CAMERA AND/OR SHOT YOU ARE GOING TO RENDER!

(Fig03)




Step 2:

OK, so you are working in a project, you have your camera moves, animations, lighting, and texturing all ready for a batch render.  While it's possible to batch render from within Maya, this approach is incredibly inefficient.  In reality, rendering anything other than previews in Maya is inefficient.  The reason for this is that the Renderer and Maya are actually separate programs.  So by rendering with Maya open you are going to be needlessly clogging your systems memory.  On large scenes there is often no other alternative than rendering from the Command Line.  As your work in Maya progresses you might end up working on scenes that can take 5-10+ minutes to simply OPEN.  Rendering from the command line allows you to render whatever you specify without ever opening Maya. 

The easiest way to begin Command Line rendering is to, from within Maya, open the scene you want to render and set all the render settings to how you'd like them.  I.e.:

File Name Prefix:  I recommend using the camera name you are rendering from (you are using dedicated cameras for rendering, right?)  

Frame/Animation ext:  name.#.ext, or name_#.ext

Image Format:  LOSSLESS FORMATS ONLY (EXR, Targa or Tiff generally)

Start Frame:  Whatever frame in the timeline you want the animation render to start

End Frame:  Whatever frame in the timeline you want the animation render to end

By Frame:  1 usually; 2 is sometimes used if you want to render every other frame for a preview

Frame Padding:  How many number spaces are in the .ext of the frame render names.  Let’s say you have 350 frames you want to render – use 3 for the frame padding.  That way the files will then start with frame number 001 and end at frame 350.  Compositing programmes will be sure to understand the numbering this way.

Renderable Camera:  BE SURE TO SET THIS TO THE RIGHT CAMERA FOR THE ANIMATION!

  1. Alpha Channel (mask) checked – on – if you are going to composite
  2. Depth Channel (zDepth) checked – on – if you are going to do depth of field, etc. in post-production
And finally, set the Render quality levels for whatever Renderer you want to use.  Save your scene after the render settings are all perfect.

Step 3:

Take a deep breath and close Maya.  The rest of this tutorial is going to assume you are working on a Windows machine. 

Go to Start > Run (Fig.04)

(Fig04)

You will get a little dialogue box – type “cmd” in it and click OK (Fig.05). This will open your Command Prompt.  If you are on a Mac you can open a terminal window; UNIX users open a shell window – it's all basically the same thing (with different syntax) (Fig.06).


(Fig05)
(Fig06 - Click to Enlarge)

My project's file path (if you'll recall) is: G:\DIGM211\MidTerm.  So, as you can see from the Command Prompt in Fig.06, we are in the C:\ drive.  To change drives, type the drive letter followed by a colon and hit Enter.  For me: “G:” (Fig.07). Type “dir” to list the contents of whichever drive you are in (Fig.08).

(Fig07 - Click to Enlarge)
(Fig08 - Click to Enlarge)

Page 1

Discuss this Tutorial in our Forums here!


To keep up with the latest Tutorials and Interviews on 3DTotal, sign-up to the free
Bi-monthly Newsletter Here!