V-Ray for Maya
vray objectProperties
This page provides information how to use the vray objectProperties command in MEL.
Last updated 19 September 2025
This page provides information how to use the vray objectProperties command in MEL.
Overview
With the vray objectProperties command you can create, assign or remove object properties from objects. These commands correspond to the Create > V-Ray > Object Properties menu, V-Ray shelf, and V-Ray menu.
Syntax
The vray objectProperties runs without flags. Instead, valid arguments need to be given in strings:
<code><span class="line"><span>vray objectProperties [add_single | add_multiple | remove | remove_sub | showInAE | assign_existing] <PROPERTY TYPE> <NODE NAME> <force></span></span></code>
Action | Description |
|---|
Action | Description |
|---|---|
add_single | Applies single object properties node to the selected object(s). |
add_multiple | Applies multiple object properties nodes to the selected objects. |
remove | Removes object properties from selection. It does not delete the object property node itself. |
remove_sub | Removes object properties from selection and sub-hierarchy. It does not delete the object property node itself. |
showInAE | Switches the focus of the Attribute Editor tab to show the object property node of the selected object. |
assign_existing | Assigns an existing object property node to the selected object. |
Command Argument | Description |
|---|
Command Argument | Description |
|---|---|
PROPERTY TYPE | Valid property types are the following strings: VRayObjectProperties |
NODE NAME | Specifies the name of an existing node when assign_existing is used. |
force | Force creates an empty object properties node when the selection is empty. |
Examples
Apply single object property node (of node type VRayObjectProperties) to the selected object(s):
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "add_single"</span></code>
Apply multiple object properties nodes (of node type VRayObjectProperties) to the selection (one property per node in the selection):
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "add_multiple"</span></code>
Apply multiple object properties nodes (of node type VRayDisplacement) to the selection (one property per node in the selection):
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "add_multiple" "VRayDisplacement"</span></code>
Remove object properties (of node type VRayObjectProperties) from selection:
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "remove"</span></code>
Remove object properties (of node type VRayDisplacement) from selection:
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "remove" "VRayDisplacement"</span></code>
Remove object properties (of node type VRayObjectProperties) from selection and sub-hierarchy:
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "remove_sub"</span></code>
Force create an empty object properties node:
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "add_single" "force"</span></code>
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "add_multiple" "force"</span></code>
Create and apply a single object property node to the selection:
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray "objectProperties" "add_single" "VRayObjectProperties"</span></code>
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray "objectProperties" "add_single" "VRayLightMesh"</span></code>
Switches focus on the Attribute Editor tab of the object property node connected to the selected object:
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "showInAE" "VRayObjectProperties"</span></code>
Assign an existing object property node to the selected object:
<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray objectProperties "assign_existing" "VRayDisplacement" "pCylinder1_vrayDisplacement"</span></code>