ogsRender

Go to: Synopsis. Return value. Keywords. Flags. MEL examples.

Synopsis

ogsRender [-activeMultisampleType string] [-activeRenderOverride string] [-activeRenderTargetFormat string] [-availableFloatingPointTargetFormat] [-availableMultisampleType] [-availableRenderOverrides] [-camera string] [-currentFrame] [-currentView] [-enableFloatingPointRenderTarget boolean] [-enableMultisample boolean] [-frame float] [-height uint] [-layer name] [-noRenderView] [-width uint]

ogsRender is NOT undoable, queryable, and editable.

Return value

In query mode, return type is based on queried flag.

Keywords

Flags

Long name (short name)	Argument types	Properties
-activeMultisampleType(-mst)	string
Query the current active multisample type.
-activeRenderOverride(-cro)	string
Set or query the current active render override.
-activeRenderTargetFormat(-fpt)	string
Query the current active floating point target format.
-availableFloatingPointTargetFormat(-afp)
Returns the names of available floating point render target format.
-availableMultisampleType(-amt)
Returns the names of available multisample type.
-availableRenderOverrides(-aro)
Returns the names of available render overrides.
-camera(-cam)	string
Specify the camera to use. Use the first available camera if the camera given is not found.
-currentFrame(-cf)
Render the current frame.
-currentView(-cv)
When turned on, only the current view will be rendered.
-enableFloatingPointRenderTarget(-efp)	boolean
Enable/disable floating point render target.
-enableMultisample(-ems)	boolean
Enable/disable multisample.
-frame(-f)	float
Specify the frame to render.
-height(-h)	uint
The height flag pass the height to the ogsRender command. If not used, the height is taken from the render globals settings.
-layer(-l)	name
Render the specified legacy render layer. Only this render layer will be rendered, regardless of the renderable attribute value of the render layer. The layer name will be appended to the output image file name. The specified render layer becomes the current render layer before rendering, and remains as current render layer after the rendering. This argument uses legacy render layers as this command does not recognize the newer renderSetup render layer system introduced in Maya 2016.
-noRenderView(-nrv)
When turned on, the render view is not updated after image computation
-width(-w)	uint
The width flag pass the width to the ogsRender command. If not used, the width is taken from the render globals settings.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

// Create a poly sphere.
polySphere;

// Render it
# It will try to save the image with format according
# to the file name saved in render globals.
ogsRender -w 480 -h 270
ogsRender -w 480 -h 270