Exclude attributes from locked references

MEL procedure for excluding individual attributes

This example shows you how to create your own MEL procedure to specify which attributes to exclude from the file referencing lock operation. The MEL procedure provided in this example is the same procedure that is distributed with Maya.

1. Create a MEL file using a text editor, and name the MEL file: getLockReferenceExcludedAttributes.mel.
2. Add the following text to the file, ensuring you follow the exact syntax:

   global proc string[] getLockReferenceExcludedAttributes()
   {
   // Return a string array containing a list of attributes
   // to be skipped during locking of a referenced file. The
   // listed attributes locked state will remain the same as
   // in the referenced file.
   string $lockReferenceExcludedAttributes[];
   $lockReferenceExcludedAttributes[0] = "visibility";
   return $lockReferenceExcludedAttributes;
   }
   

   Add or remove any $lockReferenceExcludedAttributes[n] lines as necessary to specify the attributes to exclude using the same syntax as in the above example. Ensure that the array indices [n] are consecutive.

3. Save the MEL file and place it in your Maya script path.

   If you named the MEL file exactly the same as the default one that is distributed with Maya, the Lock option uses this new customized script for locking file references the next time Maya starts.

For more information on sourcing MEL scripts and working with MEL procedures in general, see MEL and Expressions.

MEL procedure for excluding attributes by node type

This example shows you how to create your own MEL procedure to specify which attributes get excluded by node type. The MEL procedure provided in this example is the same procedure that is distributed with Maya.

1. Create your MEL file using your favorite text editor, and name the MEL file: getLockReferenceExcludedNodeTypes.mel.
2. Add the following text to the file, ensuring you follow the exact syntax:

   global proc string[] getLockReferenceExcludedNodeTypes()
   {
   // Return a string array containing a list of node types // whose attributes should be skipped during locking of a // referenced file.
   string $lockReferenceExcludedNodeTypes[];
   $lockReferenceExcludedNodeTypes[0] = "lightLinker";
   $lockReferenceExcludedNodeTypes[1] = "displayLayerManager";
   $lockReferenceExcludedNodeTypes[2] = "displayLayer";
   $lockReferenceExcludedNodeTypes[3] = "renderLayerManager";
   $lockReferenceExcludedNodeTypes[4] = "renderLayer";
   return $lockReferenceExcludedNodeTypes;
   }
   

   Add or remove any $lockReferenceExcludedNodeTypes[n] lines as necessary to specify the attributes by node type using the same syntax as in the above example. Ensure that the array indices [n] are consecutive.

3. Save the MEL file and place it in your Maya script path.

   If you named the MEL file the same as the default one that is shipped with Maya, the Lock option uses this new customized script for locking file references the next time Maya starts.

For more information on sourcing MEL scripts and working with MEL procedures in general, see the MEL and Expressions guide.

Related topics

• Locking a file reference
• Lock file references