|
Interfaces > Core Interfaces > objXRefs |
The objXRefs Core Interface provides MAXScript access to the XRef Object feature.
Methods:
<maxObject>objXRefs.addNewXRefObject <filename>fname <string>objname <integer>flags
The merge behavior is controlled by the bits set in the flags parameter:
- 1 - Add as proxy (Bit: 1)
- 2 - Drop (ignore) modifiers (Bit: 2)
- 4 - Merge modifiers (Bit: 3)
- 8 - Merge manipulators (Bit: 4)
Duplicate material names action:
-
256 - Prompt (Bit: 9)
-
512 - Use Scene Material (Bit: 10)
-
1024 - Use Merged Material (Bit: 11)
-
2048 - Merge material and automatically rename them (Bit: 12)
Reparent action:
-
4096 - Prompt (Bit: 13)
-
8192 - Always Reparent (Bit: 14)
-
16384 - Never Reparent (Bit: 15)
The default behavior (flags = 0) is :
- XRef the modifiers
- XRef the manipulators
- when duplicate material names are encountered use the option specified by objXrefMgr.dupMtlNameAction (which defaults to Merge and Rename)
- Always Reparent
<integer>objXRefs.getNumXRefObjects <filename>fname
Returns the number of object XRefs contained in the file
<maxObject>objXRefs.getXRefObject <filename>fname <index>index
Returns the Nth XRef'ed object contained in the specified file
<integer>objXRefs.getNumFiles()
Returns the number of files that contain object XRefs
<filename>objXRefs.getFileName <index>index
Returns the file name of the Nth file that contains object XRefs
<boolean>objXRefs.reloadFile <filename>fname
Returns true if successful and false otherwise.
<boolean>objXRefs.isFileUnresolved <filename>fname
Returns true if successful and false otherwise.
<boolean>objXRefs.isFileDisabled <filename>fname
Returns true if successful and false otherwise.
<array>objXRefs.getAllXRefObjects()
Returns an array of all XRef Objects present in the current scene.
<integer>objXRefs.getEmptyXRefRecCount()
Returns the number of empty XRefs.
Available in 3ds Max 8 and higher.