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


editRenderLayerAdjustment([attributeLog=boolean], [layer=name], [nodeLog=boolean], [remove=boolean])

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

editRenderLayerAdjustment is undoable, queryable, and NOT editable.

This command is used to create, edit, and query adjustments to render layers. An adjustment allows different attribute values or connections to be used depending on the active render layer.

Return value

intNumber of adjustments applied
string[]Query: List of plugs adjustments to layer

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




createRenderLayer, editRenderLayerGlobals, editRenderLayerMembers


attributeLog, layer, nodeLog, remove
Long name (short name) Argument types Properties
layer(lyr) name createquery
Specified layer in which the adjustments will be modified. If not specified the active render layer will be used.
remove(r) boolean create
Remove the specified adjustments from the render layer. If an adjustment is removed from the current layer, the specified plug will revert back to it's master value determined by the default render layer.
attributeLog(alg) boolean query
Output all adjustments for the specified layer sorted by attribute name.
nodeLog(nlg) boolean query
Output all adjustments for the specified layer sorted by node name.

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

# Create two adjustments for layer1
cmds.editRenderLayerAdjustment( 'lambert1.color', 'lambert1.diffuse', layer='layer1' )
# Result : 2
# List all the adjustments to renderlayer1
cmds.editRenderLayerAdjustment( 'layer1', query=True, layer=True )
# Result : lambert1.color lambert1.diffuse
# Create adjustments for the current render layer
cmds.editRenderLayerAdjustment( 'lambert1.color' )
# Result : 1
# Remove one adjustment from the current render layer
cmds.editRenderLayerAdjustment( 'lambert1.color', remove=True )
# Result : 1
# Query the current layer for the list of adjustments
cmds.editRenderLayerAdjustment( query=True, alg=True )
# castsShadows         nurbsSphereShape1.castsShadows
#                      pPlaneShape1.castsShadows
#                      pSphereShape1.castsShadows
# instObjGroups        pCylinderShape1.instObjGroups[0]
# motionBlurByFrame    defaultRenderGlobals.motionBlurByFrame
# receiveShadows       nurbsSphereShape1.receiveShadows
#                      pPlaneShape1.receiveShadows
#                      pSphereShape1.receiveShadows
# shadingSamples       defaultRenderQuality.shadingSamples