Go to: Synopsis. Return value. Flags. Python examples.

Synopsis

shadingGeometryRelCtx([offCommand=string], [onCommand=string], [shadingCentric=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

shadingGeometryRelCtx is undoable, queryable, and editable.

This command creates a context that can be used for associating geometry to shading groups. You can put the context into shading-centric mode by using the -shadingCentric flag and specifying true. This means that the shading group is selected first then geometry associated with the shading group are highlighted. Subsequent selections result in assignments.

Specifying -shadingCentric false means that the geometry is to be selected first. The shading group associated with the geometry will then be selected and subsequent selections will result in assignments being made.

Return value

stringName of the context created.

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

Flags

offCommand, onCommand, shadingCentric
Long name (short name) Argument types Properties
shadingCentric(s) boolean createqueryedit
shading-centric mode.
onCommand(onc) string createqueryedit
command to be issued when context is turned on
offCommand(ofc) string createqueryedit
command to be issued when context is turned on

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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

cmds.shadingGeometryRelCtx()