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

Synopsis

editRenderLayerAdjustment [-attributeLog] [-layer name] [-nodeLog] [-remove]

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

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

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

Keywords

renderLayer

Related

createRenderLayer, editRenderLayerGlobals, editRenderLayerMembers

Flags

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) 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) query
Output all adjustments for the specified layer sorted by attribute name.
-nodeLog(-nlg) 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 be used more than once in a command.

MEL examples

// Create two adjustments for layer1
editRenderLayerAdjustment -layer layer1 lambert1.color lambert1.diffuse;
// Result : 2
// List all the adjustments to renderlayer1
editRenderLayerAdjustment -q -layer layer1;
// Result : lambert1.color lambert1.diffuse
// Create adjustments for the current render layer
editRenderLayerAdjustment lambert1.color;
// Result : 1
// Remove one adjustment from the current render layer
editRenderLayerAdjustment -remove lambert1.color;
// Result : 1
// Query the current layer for the list of adjustments
editRenderLayerAdjustment -q -alg;
// castsShadows         nurbsSphereShape1.castsShadows
//                      pPlaneShape1.castsShadows
//                      pSphereShape1.castsShadows
// instObjGroups        pCylinderShape1.instObjGroups[0]
// motionBlurByFrame    defaultRenderGlobals.motionBlurByFrame
// receiveShadows       nurbsSphereShape1.receiveShadows
//                      pPlaneShape1.receiveShadows
//                      pSphereShape1.receiveShadows
// shadingSamples       defaultRenderQuality.shadingSamples