3ds Max C++ API Reference
Object Xref Options

The following represent options governing how scene entities are xrefed. More...

Macros

#define XREF_AS_PROXY   (1<<0)
 The xref objects are created as proxies. More...
 
#define XREF_XREF_MODIFIERS   0
 Modifiers will be part of the xrefed object, i.e. More...
 
#define XREF_DROP_MODIFIERS   (1<<1)
 Modifiers will not be xrefed at all, i.e. More...
 
#define XREF_MERGE_MODIFIERS   (1<<2)
 Modifiers will be merged, i.e modifiers will be accessible in the main scene's modifier panel, but won't get update on subsequent updates of the xrefed objects. More...
 
#define XREF_MERGE_MANIPULATORS   (1<<3)
 Manipulators will be merged rather than xrefed. More...
 
#define XREF_SELECT_NODES   (1<<5)
 The xrefed nodes are added to the current selection set. More...
 
#define XREF_MERGE_CONTROLLERS   (1<<6)
 Controllers will be merged rather than being xrefed. More...
 
#define XREF_MERGE_MATERIALS   (1<<7)
 Materials will be merged rather than xrefed. More...
 
#define XREF_TRACKS_XREF   (1<<8)
 Controllers will not be merged, will be xrefed. More...
 
#define XREF_TRACKS_LOCAL   (1<<9)
 Controllers will not be merged, will be local. More...
 
#define XREF_MERGE_MERGE_DUPLICATEMATCHINGLAYERS   (1<<10)
 duplicate matching Layers without an identical parent hierarchy when merging. More...
 

Detailed Description

The following represent options governing how scene entities are xrefed.

Note that some of these options should not be combined. For example, modifiers should either be xrefed, merged or dropped, but not xrefed and dropped in the same time.

See also
IObjXRefManager8::AddXRefItemsFromFile, Interface7::ConvertFlagedNodesToXRefs

Macro Definition Documentation

◆ XREF_AS_PROXY

#define XREF_AS_PROXY   (1<<0)

The xref objects are created as proxies.

◆ XREF_XREF_MODIFIERS

#define XREF_XREF_MODIFIERS   0

Modifiers will be part of the xrefed object, i.e.

modifiers won't be accessible in the main scene's modifier panel, but will be updated on subsequent updates of the xrefed objects

◆ XREF_DROP_MODIFIERS

#define XREF_DROP_MODIFIERS   (1<<1)

Modifiers will not be xrefed at all, i.e.

the non-modified version of the source objects are xrefed

◆ XREF_MERGE_MODIFIERS

#define XREF_MERGE_MODIFIERS   (1<<2)

Modifiers will be merged, i.e modifiers will be accessible in the main scene's modifier panel, but won't get update on subsequent updates of the xrefed objects.

◆ XREF_MERGE_MANIPULATORS

#define XREF_MERGE_MANIPULATORS   (1<<3)

Manipulators will be merged rather than xrefed.

◆ XREF_SELECT_NODES

#define XREF_SELECT_NODES   (1<<5)

The xrefed nodes are added to the current selection set.

◆ XREF_MERGE_CONTROLLERS

#define XREF_MERGE_CONTROLLERS   (1<<6)

Controllers will be merged rather than being xrefed.

◆ XREF_MERGE_MATERIALS

#define XREF_MERGE_MATERIALS   (1<<7)

Materials will be merged rather than xrefed.

◆ XREF_TRACKS_XREF

#define XREF_TRACKS_XREF   (1<<8)

Controllers will not be merged, will be xrefed.

It means inheriting the source controller.This status can be switched to local, but not merged.

◆ XREF_TRACKS_LOCAL

#define XREF_TRACKS_LOCAL   (1<<9)

Controllers will not be merged, will be local.

It means supporting locally editing and reloading.This status can be switched to xrefed, but not merged.

◆ XREF_MERGE_MERGE_DUPLICATEMATCHINGLAYERS

#define XREF_MERGE_MERGE_DUPLICATEMATCHINGLAYERS   (1<<10)

duplicate matching Layers without an identical parent hierarchy when merging.