XRef_Material : Material

XRef_Material - superclass: material; super-superclass:MAXWrapper - 8:6 - classID: #(657198411, 1126842699)

Instances of this class are used to XRef materials from external .MAX files.Available in 3ds Max 8 and higher.

Constructors:

XRef_Material ... XRefmaterial ...

Properties:

<XRef_Material>.enableOverride     BooleanClass    default: false   --  boolean

NEW in 3ds Max 2016: Get/set the state of the "Enable" checkbox.

   

<XRef_Material>.overrideMaterial     Standardmaterial    default: Material #67:Standard   --  material; Override_Material; SubAnim

NEW in 3ds Max 2016: Get/set the Override Material

   

<XRef_Material>.nested BooleanClass default: false -- bool;

Contains true if the XRef material is nested, false otherwise.

Read-only.

   

<XRef_Material>.srcFileName UndefinedClass default: undefined -- filename;

Contains the source file name.

Read-only.

   

<XRef_Material>.srcItemName UndefinedClass default: undefined -- string;

Contains the name of the source item.

Read-only.

   

<XRef_Material>.unresolved BooleanClass default: true -- bool;

Contains true if the XRef is unresolved, false otherwise.

Read-only.

   

<XRef_Material>.xrefRecord UndefinedClass default: undefined -- Interface;

Contains the XRef record Interface.

Read-only.

   

XRef_Material interfaces:

Interface:IXRefItem

Properties:

<XRef_Material>.srcFileName : filename : Read

Contains the source file name.

Read-only.

   

<XRef_Material>.srcItemName : string : Read

Contains the name of the source item.

Read-only.

   

<XRef_Material>.xrefRecord : Interface : Read

Contains the XRef record Interface.

Read-only.

   

<XRef_Material>.unresolved : bool : Read

Contains true if the XRef is unresolved, false otherwise.

Read-only.

   

<XRef_Material>.nested : bool : Read

Contains true if the XRef is nested, false otherwise.

Read-only.

   

Methods:

<maxObject><XRef_Material>.GetSrcItem resolveNested:<bool> 

resolveNested default value: false

Returns the source item object of the XRef Material.

If the object is being referenced from nested files (in other words, the object is referenced from a Max file containing an XRef of the object from another file instead of the actual object) and resolveNested is set to true, nested XRef files will be resolved.

   

<DWORD><XRef_Material>.GetParentItems <&maxObject array>parentItems 

parentItems is Out parameter

Returns an array of parent items in the by-reference Out parameter.

   

<DWORD><XRef_Material>.GetRootItems <&maxObject array>rootItems 

rootItems is Out parameter

Returns an array of root items in the by-reference Out parameter.

   

<DWORD><XRef_Material>.GetChildItems <&maxObject array>childItems 

childItems is Out parameter

Returns an array of child items in the by-reference Out parameter.

   

<void><XRef_Material>.GetNodes <&node array>xrefNodes 

xrefNodes is Out parameter

Returns an array of XRef nodes in the by-reference Out parameter.

   

Interface:IXRefMaterial

Methods:

<material><XRef_Material>.GetSourceMaterial <bool>resolveNestedXRef

Returns the source material object. If resolveNestedXRef is set to true, nested XRef files will be resolved.