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

Synopsis

stereoCameraView [-activeComponentsXray boolean] [-activeCustomEnvironment string] [-activeCustomGeometry string] [-activeCustomLighSet string] [-activeCustomOverrideGeometry string] [-activeCustomRenderer string] [-activeOnly boolean] [-activeShadingGraph string] [-activeSupported] [-activeView] [-addObjects string] [-addSelected] [-allObjects boolean] [-backfaceCulling boolean] [-bluePencil boolean] [-bufferMode string] [-bumpResolution uint uint] [-camera string] [-cameraName string] [-cameraSet string] [-cameraSetup] [-cameras boolean] [-capture string] [-captureSequenceNumber int] [-centerCamera string] [-colorMap] [-colorResolution uint uint] [-control] [-controlVertices boolean] [-cullingOverride string] [-default] [-defineTemplate string] [-deformers boolean] [-dimensions boolean] [-displayAppearance string] [-displayLights string] [-displayMode string] [-displayTextures boolean] [-docTag string] [-dynamicConstraints boolean] [-dynamics boolean] [-editorChanged script] [-exists] [-filter string] [-filteredObjectList] [-fluids boolean] [-fogColor float float float float] [-fogDensity float] [-fogEnd float] [-fogMode string] [-fogSource string] [-fogStart float] [-fogging boolean] [-follicles boolean] [-forceMainConnection string] [-grid boolean] [-hairSystems boolean] [-handles boolean] [-headsUpDisplay boolean] [-height] [-highlightConnection string] [-hulls boolean] [-ignorePanZoom boolean] [-ikHandles boolean] [-imagePlane boolean] [-interactive] [-interactiveBackFaceCull boolean] [-interactiveDisableShadows boolean] [-isFiltered boolean] [-jointXray boolean] [-joints boolean] [-leftCamera string] [-lights boolean] [-lineWidth float] [-locators boolean] [-lockMainConnection] [-lowQualityLighting boolean] [-mainListConnection string] [-manipulators boolean] [-maxConstantTransparency float] [-maximumNumHardwareLights boolean] [-modelPanel string] [-motionTrails boolean] [-nCloths boolean] [-nParticles boolean] [-nRigids boolean] [-noUndo boolean] [-nurbsCurves boolean] [-nurbsSurfaces boolean] [-objectFilter script] [-objectFilterList script] [-objectFilterListUI script] [-objectFilterShowInHUD boolean] [-objectFilterUI script] [-occlusionCulling boolean] [-panel string] [-parent string] [-pivots boolean] [-planes boolean] [-pluginObjects string boolean] [-pluginShapes boolean] [-polymeshes boolean] [-queryPluginObjects string] [-removeSelected] [-rendererDeviceName] [-rendererList] [-rendererListUI] [-rendererName string] [-rendererOverrideList] [-rendererOverrideListUI] [-rendererOverrideName string] [-resetCustomCamera] [-rigRoot string] [-rightCamera string] [-sceneRenderFilter string] [-selectionConnection string] [-selectionHiliteDisplay boolean] [-setSelected] [-shadingModel int] [-shadows boolean] [-smallObjectCulling boolean] [-smallObjectThreshold float] [-smoothWireframe boolean] [-sortTransparent boolean] [-stateString] [-stereoDrawMode] [-strokes boolean] [-subdivSurfaces boolean] [-swapEyes] [-textureAnisotropic boolean] [-textureCompression boolean] [-textureDisplay string] [-textureEnvironmentMap boolean] [-textureHilight boolean] [-textureMaxSize int] [-textureMemoryUsed] [-textureSampling int] [-textures boolean] [-transpInShadows boolean] [-transparencyAlgorithm string] [-twoSidedLighting boolean] [-unParent] [-unlockMainConnection] [-updateColorMode] [-updateMainConnection] [-useBaseRenderer boolean] [-useColorIndex boolean] [-useCustomBackground boolean] [-useDefaultMaterial boolean] [-useInteractiveMode boolean] [-useRGBImagePlane boolean] [-useReducedRenderer boolean] [-useTemplate string] [-userNode string] [-viewColor float float float float] [-viewObjects] [-viewSelected boolean] [-viewType] [-width] [-wireframeBackingStore boolean] [-wireframeOnShaded boolean] [-xray boolean] objects [editorName]

stereoCameraView is undoable, queryable, and editable.

Create, edit or query a model editor.

Note that some of the flags of this command may have different settings for normal mode and for interactive/playback mode. For example, a modelEditor can be set to use shaded mode normally, but to use wireframe during playback for greater speed. Some flags also support having defaults set so that new model editors will be created with those settings.

This is the main command for creating stereo editors. This commands only acts as an interface to the actual viewport. It is derived off of MPxModelEditorCommand. This command manages the set of stereo rig tools.

Return value

stringthe name of the editor.

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

Related

camera

Flags

activeComponentsXray, activeCustomEnvironment, activeCustomGeometry, activeCustomLighSet, activeCustomOverrideGeometry, activeCustomRenderer, activeOnly, activeShadingGraph, activeSupported, activeView, addObjects, addSelected, allObjects, backfaceCulling, bluePencil, bufferMode, bumpResolution, camera, cameraName, cameraSet, cameraSetup, cameras, capture, captureSequenceNumber, centerCamera, colorMap, colorResolution, control, controlVertices, cullingOverride, default, defineTemplate, deformers, dimensions, displayAppearance, displayLights, displayMode, displayTextures, docTag, dynamicConstraints, dynamics, editorChanged, exists, filter, filteredObjectList, fluids, fogColor, fogDensity, fogEnd, fogMode, fogSource, fogStart, fogging, follicles, forceMainConnection, grid, hairSystems, handles, headsUpDisplay, height, highlightConnection, hulls, ignorePanZoom, ikHandles, imagePlane, interactive, interactiveBackFaceCull, interactiveDisableShadows, isFiltered, jointXray, joints, leftCamera, lights, lineWidth, locators, lockMainConnection, lowQualityLighting, mainListConnection, manipulators, maxConstantTransparency, maximumNumHardwareLights, modelPanel, motionTrails, nCloths, nParticles, nRigids, noUndo, nurbsCurves, nurbsSurfaces, objectFilter, objectFilterList, objectFilterListUI, objectFilterShowInHUD, objectFilterUI, occlusionCulling, panel, parent, pivots, planes, pluginObjects, pluginShapes, polymeshes, queryPluginObjects, removeSelected, rendererDeviceName, rendererList, rendererListUI, rendererName, rendererOverrideList, rendererOverrideListUI, rendererOverrideName, resetCustomCamera, rigRoot, rightCamera, sceneRenderFilter, selectionConnection, selectionHiliteDisplay, setSelected, shadingModel, shadows, smallObjectCulling, smallObjectThreshold, smoothWireframe, sortTransparent, stateString, stereoDrawMode, strokes, subdivSurfaces, swapEyes, textureAnisotropic, textureCompression, textureDisplay, textureEnvironmentMap, textureHilight, textureMaxSize, textureMemoryUsed, textureSampling, textures, transpInShadows, transparencyAlgorithm, twoSidedLighting, unParent, unlockMainConnection, updateColorMode, updateMainConnection, useBaseRenderer, useColorIndex, useCustomBackground, useDefaultMaterial, useInteractiveMode, useRGBImagePlane, useReducedRenderer, useTemplate, userNode, viewColor, viewObjects, viewSelected, viewType, width, wireframeBackingStore, wireframeOnShaded, xray
Long name (short name) Argument types Properties
-activeComponentsXray(-acx) boolean queryedit
Turns on or off Xray mode for active components.
-activeCustomEnvironment(-ace) string edit
Specifies a path to an image file to be used as environment map. It is only enabled when a valid scene render filter is specified.
-activeCustomGeometry(-acg) string queryedit
Specifies an identifier for custom geometry to override the geometry to display. It is only enabled when a valid scene render filter is specified.
-activeCustomLighSet(-acl) string queryedit
Specifies an identifier for the light set to use with a scene render filter. It is only enabled when a valid scene render filter is specified.
-activeCustomOverrideGeometry(-aog) string queryedit
Specifies an identifier for an override on the custom geometry for a scene render filter.
-activeCustomRenderer(-acr) string queryedit
Specifies an identifier for custom renderer to use when a valid scene render filter is also specified.
-activeOnly(-ao) boolean queryedit
Sets whether only active objects should appear shaded in shaded display.
-activeShadingGraph(-asg) string queryedit
Specifies the shading graph to use to override material display. Only enabled when a valid scene render filter is specified.
-activeSupported(-ams) query
True if the viewer is capable of drawing in active mode which takes advantage of the graphics card's built-in stereoscopic support. This includes support for shutter glasses and stereo support in clone mode.
-activeView(-av) queryedit
Sets this model editor to be the active view. Returns true if successful. On query this flag will return whether the view is the active view.
-addObjects(-aob) string edit
This flag causes the objects contained within the selection connection to be added to the list of objects visible in the view (if viewSelected is true).
-addSelected(-as) edit
This flag causes the currently active objects to be added to the list of objects visible in the view (if viewSelected is true).
-allObjects(-alo) boolean queryedit
Turn on/off the display of all objects for the view of the model editor. This excludes NURBS, CVs, hulls, grids and manipulators.
-backfaceCulling(-bfc) boolean queryedit
Turns on or off backface culling for the whole view. This setting overrides the culling settings of individual objects. All objects draw in the view will be backface culled. When backface culling is turned on, surfaces becomes invisible in areas where the normal is pointing away from the camera.
-bluePencil(-bp) boolean createqueryedit
Define whether the blue pencil should be added or not
-bufferMode(-bm) string queryedit
Deprecated: this is not supported in Viewport 2.0. Sets the graphic buffer mode. Possible values are "single" or "double".
-bumpResolution(-brz) uint uint queryedit
Set the resolution for "baked" bump map textures when using the hardware renderer. The default value is 512, 512 respectively.
-camera(-cam) string queryedit
Change or query the name of the camera in model editor.
-cameraName(-cn) string createedit
Set the name of the panel's camera transform and shape. The shape name is computed by appending the string "Shape" to the transform name. This flag may not be queried.
-cameraSet(-cst) string createqueryedit
Name of the camera set
-cameraSetup(-cs) query
Based on the model editor name passed in will returns a string list containing camera setups. A camera setup can contain one or more cameras which are associated with each other. Camera setups are defined as pairs of consecutive strings in the list. Each pair is comprised of: a string which identifies an active camera, and a string which defines a script to set up a given active camera. As many pairs of strings can be returned as the number of active cameras. If nothing is returned then it is assumed that no set up is required to activate a given camera.
-cameras(-ca) boolean queryedit
Turn on/off the display of cameras for the view of the model editor.
-capture(-cpt) string queryedit
Perform an one-time capture of the viewport to the named image file on disk.
-captureSequenceNumber(-csn) int queryedit
When a number greater or equal to 0 is specified each subsequent refresh will save an image file to disk if the capture flag has been enabled. The naming of the file is: {root name}.#.{extension} if the name {root name}.{extension} is used for the capture flag argument. The value of # starts at the number specified to for this argument and increments for each subsequent refresh. Sequence capture can be disabled by specifying a number less than 0 or an empty file name for the capture flag.
-centerCamera(-ccm) string query
Only available in query mode: returns the current center camera of this view.
-colorMap(-cm) query
Queries the color map style for the model panel. Possible values are "colorIndex" and "rgb".
-colorResolution(-crz) uint uint queryedit
Set the resolution for "baked" color textures when using the hardware renderer. The default value is 256, 256 respectively.
-control(-ctl) query
Query only. Returns the top level control for this editor. Usually used for getting a parent to attach popup menus. Caution: It is possible for an editor to exist without a control. The query will return "NONE" if no control is present.
-controlVertices(-cv) boolean queryedit
Turn on/off the display of NURBS CVs for the view of the model editor.
-cullingOverride(-cov) string queryedit
Set whether to override the culling attributes on objects when using the hardware renderer. The options are:
  • "none" : Use the culling object attributes per object.
  • "doubleSided" : Force all objects to be double sided.
  • "singleSided": Force all objects to be single sided.
The default value is "none".
-default(-d) queryedit
Causes this command to modify the default value of this setting. Newly created model editors will inherit the values. This flag may be used with the -interactive to set default interactive settings.
-defineTemplate(-dt) string create
Puts the command in a mode where any other flags and arguments are parsed and added to the command template specified in the argument. They will be used as default arguments in any subsequent invocations of the command when templateName is set as the current template.
-deformers(-df) boolean queryedit
Turn on/off the display of deformer objects for the view of the model editor.
-dimensions(-dim) boolean queryedit
Turn on/off the display of dimension objects for the view of the model editor.
-displayAppearance(-da) string queryedit
Sets the display appearance of the model panel. Possible values are "wireframe", "points", "boundingBox", "smoothShaded", "flatShaded". This flag may be used with the -interactive and -default flags. Note that only "wireframe", "points", and "boundingBox" are valid for the interactive mode.
-displayLights(-dl) string queryedit
Sets the lighting for shaded mode. Possible values are "selected", "active", "all", "default", "none".
-displayMode(-dm) string createqueryedit
Defines the display mode for this view. Some modes are available only for certain types of graphics hardware. Valid values are:
  • active: uses the graphics card's built-in stereoscopic mode is available
  • leftEye: displays only the view from the left camera.
  • rightEye: displays only the view from the rigth camera.
  • centerEye: displays only the view from the center camera.
  • anaglyph: displays both left and right cameras, filtered using red and blue
  • anaglyphLum: same as anaglyph, except the luminance is computed before the red and blue filtering
  • interlace: displays an interlaced view of left and right cameras
  • checkerboard: Same as interlace, except a checkerboard pattern is used to mix both images
  • freeview: displays both left and right images, half size next to each other
  • freeviewX: same as freeview, except left and right cameras are swapped
-displayTextures(-dtx) boolean queryedit
Turns on or off display of textures in shaded mode
-docTag(-dtg) string createqueryedit
Attaches a tag to the editor.
-dynamicConstraints(-dc) boolean queryedit
Turn on/off the display of dynamicConstraints for the view of the model editor.
-dynamics(-dy) boolean queryedit
Turn on/off the display of dynamics objects for the view of the model editor.
-editorChanged(-ec) script createqueryedit
An optional script callback which is called when the editors options have changed. This is useful in a situation where a scripted panel contains a modelEditor and wants to be notified when the contained editor changes its options.
-exists(-ex) create
Returns whether the specified object exists or not. Other flags are ignored.
-filter(-f) string createqueryedit
Specifies the name of an itemFilter object to be used with this editor. This filters the information coming onto the main list of the editor.
-filteredObjectList(-fol) query
For model editors with filtering on (either using an object filter, or isolate select), this flag returns a string list of the objects which are displayed in this editor. Note that this list does not take into account visibility (based on camera frustum or flags), it purely captures the objects which are considered when rendering the view.
-fluids(-fl) boolean queryedit
Turn on/off the display of fluids for the view of the model editor.
-fogColor(-fcl) float float float float queryedit
The color used for hardware fogging.
-fogDensity(-fdn) float queryedit
Determines the density of hardware fogging.
-fogEnd(-fen) float queryedit
The end location of hardware fogging.
-fogMode(-fmd) string queryedit
This determines the drop-off mode for fog. The possibilities are:
  • "linear" : linear drop-off
  • "exponent" : exponential drop-off
  • "exponent2" : squared exponential drop-off
-fogSource(-fsc) string queryedit
Set the type of fog algorithm to use. If the argument is "fragment" (default) then fog is computed per pixel. If the argument is "coordinate" then if the geometry has specified vertex fog coordinates, and the OpenGL extension for vertex fog is supported by the graphics system, then fog is computed per vertex.
-fogStart(-fst) float queryedit
The start location of hardware fogging.
-fogging(-fg) boolean queryedit
Set whether hardware fogging is enabled or not.
-follicles(-fo) boolean queryedit
Turn on/off the display of follicles for the view of the model editor.
-forceMainConnection(-fmc) string createqueryedit
Specifies the name of a selectionConnection object that the editor will use as its source of content. The editor will only display items contained in the selectionConnection object. This is a variant of the -mainListConnection flag in that it will force a change even when the connection is locked. This flag is used to reduce the overhead when using the -unlockMainConnection , -mainListConnection, -lockMainConnection flags in immediate succession.
-grid(-gr) boolean queryedit
Turn on/off the display of the grid for the view of the model editor.
-hairSystems(-hs) boolean queryedit
Turn on/off the display of hairSystems for the view of the model editor.
-handles(-ha) boolean queryedit
Turn on/off the display of select handles for the view of the model editor.
-headsUpDisplay(-hud) boolean queryedit
Sets whether the model panel will draw any enabled heads up display elements in this window (if true). Currently this requires the HUD elements to be globally enabled.
-height(-h) query
Return the height of the associated viewport in pixels
-highlightConnection(-hlc) string createqueryedit
Specifies the name of a selectionConnection object that the editor will synchronize with its highlight list. Not all editors have a highlight list. For those that do, it is a secondary selection list.
-hulls(-hu) boolean queryedit
Turn on/off the display of NURBS hulls for the view of the model editor.
-ignorePanZoom(-ipz) boolean queryedit
Sets whether the model panel will ignore the 2D pan/zoom value to give an overview of the scene.
-ikHandles(-ikh) boolean queryedit
Turn on/off the display of ik handles and end effectors for the view of the model editor.
-imagePlane(-imp) boolean queryedit
Turn on/off the display of image plane for the view
-interactive(-i) queryedit
Causes this command to modify the interactive refresh settings of the view. In this way it is possible to change the behavior of the model editor during playback for improved performance.
-interactiveBackFaceCull(-ibc) boolean createqueryedit
Define whether interactive backface culling should be on or not
-interactiveDisableShadows(-dis) boolean createqueryedit
Define whether interactive shadows should be disabled or not
-isFiltered(-if) boolean query
Returns true for model editors with filtering applied to their view of the scene. This could either be an explicit object filter, or a display option such as isolate select which filters the objects that are displayed.
-jointXray(-jx) boolean queryedit
Turns on or off Xray mode for joints.
-joints(-j) boolean queryedit
Turn on/off the display of joints for the view of the model editor.
-leftCamera(-lcm) string query
Only available in query mode: returns the current left camera of this view.
-lights(-lt) boolean queryedit
Turn on/off the display of lights for the view of the model editor.
-lineWidth(-lw) float queryedit
Set width of lines for display
-locators(-lc) boolean queryedit
Turn on/off the display of locator objects for the view of the model editor.
-lockMainConnection(-lck) createedit
Locks the current list of objects within the mainConnection, so that only those objects are displayed within the editor. Further changes to the original mainConnection are ignored.
-lowQualityLighting(-lql) boolean queryedit
Set whether to use "low quality lighting" when using the hardware renderer. The default value is false.
-mainListConnection(-mlc) string createqueryedit
Specifies the name of a selectionConnection object that the editor will use as its source of content. The editor will only display items contained in the selectionConnection object.
-manipulators(-m) boolean queryedit
Turn on/off the display of manipulator objects for the view of the model editor.
-maxConstantTransparency(-mct) float queryedit
Sets the maximum constant transparency. Setting this value remaps constant transparency values from the range [0.0, 1.0] to the range [0.0, maxConstantTransparency]. All transparency values are shifted linearly to the new range, so a fully transparency object (transparency 1.0) would appear with a transparency of maxConstantTransparency in the viewport, allowing highly transparent objects to be made visible. This flag only affects constant (non-textured) transparent objects.
-maximumNumHardwareLights(-mhl) boolean createqueryedit
Define whether the hardware light maximum should be respected or not
-modelPanel(-mp) string create
Allows the created model editor to be embedded in the named model panel. Intended for use with custom model editors created via the API (i.e. the flag would be used on the derived MPxModelEditorCommand), though the flag may also be used on the base modelEditor command to restore a default Maya model editor to the panel. Note that the model editor previously owned by the panel is deleted.
-motionTrails(-mt) boolean queryedit
Turn on/off the Motion Trail display in the Viewport.
-nCloths(-ncl) boolean queryedit
Turn on/off the display of nCloths for the view of the model editor.
-nParticles(-npa) boolean queryedit
Turn on/off the display of nParticles for the view of the model editor.
-nRigids(-nr) boolean queryedit
Turn on/off the display of nRigids for the view of the model editor.
-noUndo(-nud) boolean edit
This flag prevents some viewport operations (such as isolate select) from being added to the undo queue.
-nurbsCurves(-nc) boolean queryedit
Turn on/off the display of nurbs curves for the view of the model editor.
-nurbsSurfaces(-ns) boolean queryedit
Turn on/off the display of nurbs surfaces for the view of the model editor.
-objectFilter(-obf) script queryedit
Set or query the current object filter name. An object filter is required to have already been registered.
-objectFilterList(-ofl) script query
Return a list of names of registered filters.
-objectFilterListUI(-ofu) script query
Return a list of UI names of registered filters.
-objectFilterShowInHUD(-ofs) boolean queryedit
Sets whether or not to display the object filter UI name in the heads up display when an object filter is active. This string is concatenated with the camera name.
-objectFilterUI(-obu) script query
Query the current object filter UI name. The object filter is required to have already been registered.
-occlusionCulling(-ocl) boolean queryedit
Set whether to enable occlusion culling testing when using the hardware renderer. The default value is false.
-panel(-pnl) string createquery
Specifies the panel for this editor. By default if an editor is created in the create callback of a scripted panel it will belong to that panel. If an editor does not belong to a panel it will be deleted when the window that it is in is deleted.
-parent(-p) string createqueryedit
Specifies the parent layout for this editor. This flag will only have an effect if the editor is currently un-parented.
-pivots(-pv) boolean queryedit
Turn on/off the display of transform pivots for the view of the model editor.
-planes(-pl) boolean queryedit
Turn on/off the display of sketch planes for the view of the model editor.
-pluginObjects(-po) string boolean editmultiuse
Turn on/off the display of plug-in objects for the view. It depends on the plug-in implementation whether to respect this flag.
-pluginShapes(-ps) boolean edit
Turn on/off the display of plug-in shapes for the view. It depends on the plug-in implementation whether to respect this flag.
-polymeshes(-pm) boolean queryedit
Turn on/off the display of polygon meshes for the view of the model editor.
-queryPluginObjects(-qpo) string query
Query the on/off state of plug-in objects display for the view. To set the on/off state, use -pluginObjects instead.
-removeSelected(-rs) edit
This flag causes the currently active objects to be removed from the list of objects visible in the view (if viewSelected is true).
-rendererDeviceName(-rdn) query
Query for the name of the draw API used by the Viewport 2.0 renderer for a 3d modeling viewport. The possible return values are "VirtualDeviceGL" if Maya is set to use "OpenGL - Legacy" for Viewport 2.0, "VirtualDeviceGLCore" if Maya is set to use "OpenGL - Core Profile" (either Compatibility or Strict) for Viewport 2.0, or "VirtualDeviceDx11" if Maya is set to use DirectX for Viewport 2.0. If the renderer for the 3d modeling viewport is not Viewport 2.0, an empty string will be returned.
-rendererList(-rls) query
Query for a list of the internal names for renderers available for use with the 3d modeling viewport. The default list contains at least "vp2Renderer", if supported. See rendererName for more details on these renderers. Any plug-in viewport renderers will also appear in this list.
-rendererListUI(-rlu) query
Query for a list of the UI names for renderers available for use with the 3d modeling viewport. The default list consists of the UI name for "vp2Renderer", if it is supported. Any plug-in viewport renderer's UI names will also appear in this list. This list and the list returned from rendererList have a 1:1 correspondance.
-rendererName(-rnm) string queryedit
Set or get the renderer used for a 3d modeling viewport. The name provided should be an internal name of a renderer. The 'rendererList' flag can be used to query for a list of available names. The default renderer is "vp2Renderer": Viewport 2.0.
-rendererOverrideList(-rol) query
Query for a list of the internal names for renderer overrides for a 3d viewport renderer. Currently only the "Viewport 2" renderer supports renderer overrides.
-rendererOverrideListUI(-rou) query
Query for a list of the UI names for renderer overrides for a 3d viewport renderer. Currently only the "Viewport 2" renderer supports renderer overrides.
-rendererOverrideName(-rom) string queryedit
Set or get the override used for a 3d viewport renderer. The name provided should be the internal name for an override. The 'rendererOverrideList' flag can be used to query for a list of available names. Currently only the "Viewport 2" renderer supports renderer overrides. Setting an empty string will unset any currently active override.
-resetCustomCamera(-rcc) edit
When specified will reset the camera transform for the active custom camera used for a scene render filter. It is only enabled when a valid scene render filter is specified.
-rigRoot(-rr) string createqueryedit
Defines the rig root associated with this view.
-rightCamera(-rcm) string query
Only available in query mode: returns the current right camera of this view.
-sceneRenderFilter(-srf) string queryedit
Specifies the name of a scene render filter
-selectionConnection(-slc) string createqueryedit
Specifies the name of a selectionConnection object that the editor will synchronize with its own selection list. As the user selects things in this editor, they will be selected in the selectionConnection object. If the object undergoes changes, the editor updates to show the changes.
-selectionHiliteDisplay(-sel) boolean queryedit
Sets whether the model panel will draw any selection hiliting on the objects in this window.
-setSelected(-ss) edit
This flag causes the currently active objects to be the only objects visible in the view (if viewSelected is true).
-shadingModel(-sml) int createqueryedit
Shading model to use
-shadows(-sdw) boolean queryedit
Turn on/off the display of hardware shadows in shaded mode.
-smallObjectCulling(-soc) boolean createqueryedit
Define whether small object culling should be enabled or not
-smallObjectThreshold(-sot) float createqueryedit
Threshold used for small object culling
-smoothWireframe(-swf) boolean queryedit
Turns on or off smoothing of wireframe lines and points
-sortTransparent(-st) boolean queryedit
This flag turns on/off sorting of transparent objects during shaded mode refresh. Normally, objects are sorted according to their origin in camera space but when this flag is turned off they will be drawn according to their (depth-first traversal) order in the scene graph. This is a global flag that affects all model editors.
-stateString(-sts) query
Query only flag. Returns the MEL command that will create an editor to match the current editor state. The returned command string uses the string variable $editorName in place of a specific name.
-stereoDrawMode(-sdm) createqueryedit
If this flag is used then set stereo draw mode
-strokes(-str) boolean queryedit
Turn on/off the display of Paint Effects strokes for the view
-subdivSurfaces(-sds) boolean queryedit
Turn on/off the display of subdivision surfaces for the view of the model editor.
-swapEyes(-se) createqueryedit
Swap the display of the left and right cameras. The left camera becomes the right draw pass and the right camera becomes the left draw pass.
This flag is intended for advanced users, for situations where the hardware uses the opposite left/right convention.
-textureAnisotropic(-ta) boolean queryedit
Set whether to perform anisotropic texture filtering. Will work only if the anisotropic texture filtering extension is supported in OpenGL on the graphics system.
-textureCompression(-tcp) boolean createqueryedit
Defines whether texture compression should be used or not
-textureDisplay(-td) string queryedit
Set the type of blending to use for textures. The blend is performed between the destination fragment and the texture fragment. The source is usually the material color. Argument options are: "modulate" : multiply the destination and texture fragment "decal" : overwrite the destination with the texture fragment
-textureEnvironmentMap(-tem) boolean createqueryedit
If true then use a texture environment map
-textureHilight(-th) boolean queryedit
Set whether to show specular hilighting when the display is in shaded textured mode.
-textureMaxSize(-tms) int queryedit
Set maximum texture size for hardware texturing. The integer value must be a power of 2. Recommended values are 128 or 256. If the value specified is larger than the OpenGL maximim textures size for the graphics hardware it will be clamped to the OpenGL size. If many large textures are used in a scene reducing this value improves performance. On Impact texture memory is pinned in RAM so using large textures can cause reliability and performance problems. Again reducing this value will help. Software rendering does not use this value.

This flag is obsolete as of Maya 6.5. The maxTextureResolution/mtr argument on the displayPref command should be used instead.

-textureMemoryUsed(-tmu) query
Returns the total number of bytes used by all texture maps. This is typicly width*height*channels for all texture objects in the scene If the texture is mip mapped all mip map levels are included in the total though not never more than two level will be in use at one time
-textureSampling(-ts) int queryedit
Set the type of sampling to be used for texture display. The argument can be either:
  • 1 : means to perform point sample
  • 2 : means to perform bilinear interpolation (default)
-textures(-tx) boolean queryedit
Turn on/off the display of texture objects for the view
-transpInShadows(-tis) boolean queryedit
Set whether to enable display of transparency in shadows when using the hardware renderer. The default value is false.
-transparencyAlgorithm(-tal) string queryedit
Set the transparency algorithm. The options are:
  • 1) "frontAndBackCull" : Two pass front and back culling technique.
  • 2) "perPolygonSort" : Draw transparent polygons in back-to-front order technique.
transparency pptions 1) and 2) are supported by the hardware renderer. Options 1) is supported by the interactive modeling viewports. The default value is "frontAndBackCull".
-twoSidedLighting(-tsl) boolean queryedit
Turns on or off two sided lighting. This may be used with the -default flag.
-unParent(-up) createedit
Specifies that the editor should be removed from its layout. This cannot be used in query mode.
-unlockMainConnection(-ulk) createedit
Unlocks the mainConnection, effectively restoring the original mainConnection (if it is still available), and dynamic updates.
-updateColorMode(-ucm) edit
Using this flag tells the model panel to check which color mode it should be in, and to switch accordingly. This flag may be used to update a model panel after a camera image plane has been added or removed.
-updateMainConnection(-upd) createedit
Causes a locked mainConnection to be updated from the orginal mainConnection, but preserves the lock state.
-useBaseRenderer(-ubr) boolean queryedit
Set whether to use the "base" renderer when using the hardware renderer and in "interactive display mode" (-useInteractiveMode) The default value is false.
-useColorIndex(-uci) boolean queryedit
Sets whether the model panel will attempt to use color index mode when possible. Color index mode can provide a performance increase for point, bounding box, and wireframe display modes. This may be used with the -default flag.
-useCustomBackground(-ucb) boolean createqueryedit
When set to true, instead of using the standard background, draw a solid background using the viewColor.
-useDefaultMaterial(-udm) boolean queryedit
Sets whether the model panel will draw all the shaded surfaces using the default material as opposed to using the material(s) currently assigned to the surfaces.
-useInteractiveMode(-ui) boolean queryedit
Turns on or off the use of the special interaction settings during playback. This flag may be used with the -default flag.
-useRGBImagePlane(-ip) boolean queryedit
Sets whether the model panel will be forced into RGB mode when there is an image plane attached to the panel's camera.
-useReducedRenderer(-urr) boolean createqueryedit
Set true if using the reduced renderer
-useTemplate(-ut) string create
Forces the command to use a command template other than the current one.
-userNode(-un) string queryedit
Allows the user to associate a node name with the modelEditor. The value is automatically updated in the event the node is deleted or renamed.
-viewColor(-vc) float float float float createqueryedit
Specifies the background color for the stereoscopic model editor. The default value is black which provides optimal stereoscopic viewing. This only applies if 'useCustomBackground' is on (which is the default).
-viewObjects(-vo) query
Returns the name (if any) of the objectSet which contains the list of objects visible in the view if viewSelected is true and the list of objects being displayed does not come from the active list.
-viewSelected(-vs) boolean queryedit
This flag turns on/off viewing of selected objects. When the flag is set to true, the currently active objects are captured and used as the list of objects to view.
-viewType(-vt) query
Returns a string indicating the type of the model editor. For the default model editor, returns the empty string. For custom model editor types created via the API, returns the same string as is returned via the method MPx3dModelView::viewType().
-width(-w) query
Return the width of the associated viewport in pixels.
-wireframeBackingStore(-wbs) boolean queryedit
Sets whether a backing store is used to optimization the drawing of active objects. This mode can provide a performance increase in wireframe mode for certain scenes.
-wireframeOnShaded(-wos) boolean queryedit
Sets whether the model panel will draw the wireframe on all shaded objects (if true) or only for active objects (if false).
-xray(-xr) boolean queryedit
Turns on or off Xray mode. This may be used with the -default flag.
Common model editor flags

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 window with a model editor and some buttons that
//    change the editor's display of objects in the scene.
//
string $window = `window`;
string $form = `formLayout`;
string $editor = `modelEditor`;
string $column = `columnLayout -adjustableColumn true`;

//    Create some buttons that will alter the display appearance of
//    objects in the model editor, eg. wireframe vs. shaded mode.
//
button -label "Wireframe"
    -command ("modelEditor -edit -displayAppearance wireframe " + $editor);
button -label "Points"
    -command ("modelEditor -edit -displayAppearance points " + $editor);
button -label "Bounding Box"
    -command ("modelEditor -edit -displayAppearance boundingBox " + $editor);
button -label "Smooth Shaded"
    -command ("modelEditor -edit -displayAppearance smoothShaded " + $editor);
button -label "Flat Shaded"
    -command ("modelEditor -edit -displayAppearance flatShaded " + $editor);

//    Set up the window layout attachments.
//
formLayout -edit
    -attachForm    $column "top"    0
    -attachForm    $column "left"   0
    -attachNone    $column "bottom"
    -attachNone    $column "right"
    -attachForm    $editor "top"    0
    -attachControl $editor "left"   0 $column
    -attachForm    $editor "bottom" 0
    -attachForm    $editor "right"  0
    $form;

//    Create a camera for the editor.  This particular camera will
//    have a close up perspective view of the centre of the ground plane.
//
string $camera[] = `camera -centerOfInterest 2.450351
    -position 1.535314 1.135712 1.535314
    -rotation -27.612504 45 0
    -worldUp -0.1290301 0.3488592 -0.1290301`;

//    Attach the camera to the model editor.
//
modelEditor -edit -camera $camera[0] $editor;

//    Put an object in the scene.
//
cone;

showWindow $window;

//    The following two examples assume a custom model editor command
//    defined via the MPxModelEditorCommand API class, named 'myEditor'.
//

//    Create a custom editor, and use it as the model editor of Maya's
//    default modelPanel4 (the perspective view).
//
myEditor -modelPanel modelPanel4;

//    Restore the default model editor.
//
modelEditor -modelPanel modelPanel4;
//
//		The following example shows usage of the render override flags
//		with model panel 'modelPanel4'
//
modelEditor -q -rol modelPanel4;	// Query for non-UI names for any render overrides
modelEditor -q -rou modelPanel4;	// Query for UI names for any render overrides
modelEditor -q -rom modelPanel4;	// Query for any active override
modelEditor -e -rom "myOverride" modelPanel4; // Set active override to 'myOverride' if it exists
modelEditor -e -rom "" modelPanel4;	// Clear out the active override

modelEditor -e -rnm "base_OpenGL_Renderer" modelPanel4; // Set the renderer used for a 3d modeling viewport
modelEditor -q -rnm modelPanel4;	// Query for the renderer used for a 3d modeling viewport
modelEditor -q -rdn modelPanel4;	// Query for device name for current renderer.

// Test if the panel exists
stereoCameraView -query -exists "StereoPanel"