Animatable flags are generally meant to be used in enumerations of Animatable instances where each instance must be visited only once. More...

Macros
#define	A_DERIVEDOBJ_DONTDELETE (1<<9)
	When the last modifier is deleted form this derived object, don't delete the derived object.

#define	A_COMPONENT_LOCKED (1<<19)
	Needed for CompositeBase and its children.

#define	A_TVNODE_DONTRESACLECONTROLLERS (1 << 5)
	Don't call RescaleWorldUnits on sub-controllers.

#define	A_CHANGE_PARENTS_DONE (1<<17)
	Used internally.

#define	A_REFMAKER_REFS_CHECKED (1<<18)
	Used internally.

#define	A_DEPENDENCY_TEST (1<<26)
	Used to test for a dependency.

#define	A_LOCK_TARGET (1<<27)
	Ref target isn't deleted when dependents goes to 0 if this flag is set.

Atmospheric flags
#define	A_ATMOS_DISABLED (1<<5)
	The atmosphere effect is disabled.

#define	A_ATMOS_OBJECTXREF (1<<6)
	Not used anywhere.

#define	A_ATMOS_SCENEXREF (1<<7)
	An atmospheric scene xref.

Tone Operator flags
#define	A_TONEOP_DISABLED (1<<5)
	The exposure control is disabled.

#define	A_TONEOP_PROCESS_BG (1<<6)
	The exposure control proceses the background.

#define	A_TONEOP_INDIRECT_ONLY (1<<7)
	Only processes indirect lights only.

Object flags
#define	A_OBJ_CREATING (1<<5)
	The object is being created. It doesn't want to snap to itself.

#define	A_OBJ_LONG_CREATE (1<<6)
	Persists throughout the whole creation process as opposed to A_OBJ_CREATING which gets cleared as as the object is added to the scene.

#define	A_OBJ_BEING_EDITED (1<<7)
	The object is being created. It doesn't want to snap to itself.

Modifier flags
#define	A_MOD_DISABLED (1<<5)
	The modifier is disabled.

#define	A_MOD_BEING_EDITED (1<<6)
	The modifer is deleted.

#define	A_MOD_USE_SEL (1<<7)
	No longer used - use sub-ob selection.

#define	A_MOD_DISABLED_INVIEWS (1<<8)
	Modifier is disabled in viewports only.

#define	A_MOD_DISABLED_INRENDER (1<<9)
	Modifier is disabled in renderer only.

Modapp flags
#define	A_MODAPP_DISABLED (1<<5)
	Used internally.

#define	A_MODAPP_SELECTED (1<<6)
	parent node is selected

#define	A_MODAPP_DISPLAY_ACTIVE (1<<7)
	Used internally.

#define	A_MODAPP_DYNAMIC_BOX (1<<8)
	Used internally.

#define	A_MODAPP_RENDERING (1<<9)
	Render begin turns this on and render end turns it off.

Control flags
#define	A_ORT_MASK 7
	Used internally.

#define	A_ORT_BEFORESHIFT 5
	Uses bits 5,6 and 7 to store ORT.

#define	A_ORT_AFTERSHIFT 8
	Uses bits 8,9 and 10 to store ORT.

#define	A_CTRL_DISABLED (1<<11)
	Used internally.

#define	A_ORT_DISABLED (1<<19)
	Indicates that the ORT is disabled.

Inode flags
#define	A_INODE_IK_TERMINATOR (1<<5)
	Terminates the top of an IK chain.

#define	A_INODE_IK_POS_PINNED (1<<6)
	The position is pinned.

#define	A_INODE_IK_ROT_PINNED (1<<7)
	The rotation is pinned.

#define	A_INODE_CLONE_TARGET (1<<8)
	Terminates the top of an IK chain.

#define	A_INODE_IN_UPDATE (1<<9)
	Used internally only.

#define	A_INODE_IN_UPDATE_TM (1<<10)
	Flag is set if it's updating it's TM. Don't Call GetNodeTM if it is.

Paramblock2 flags
#define	A_PB2_POSTLOADCALLBACK (1<<5)
	Set when a Paramblock2 has added itself to the PostLoadCallback used so we dont add multiple copies to the array.

Flags for Hold and Restore logic
For "lazy holding" to avoid multiple holding.
#define	A_HELD (1<<12)
	Typically a plug-in would not hold unless this flag was not set.

#define	A_SET (1<<13)
	Similar to A_HELD except is used by controllers.

#define	A_IS_DELETED (1<<14)
	Used internally.

#define	A_BEING_AUTO_DELETED (1<<15)
	Used internally.

Reserved for superclass use
#define	A_SUPERCLASS1 (1<<20)

#define	A_SUPERCLASS2 (1<<21)

Reserved for use by plugins
These flags are not persisted with the max file, thus they should only be used as temporary storage. It is highly recommended that plugin code clears the flag it wishes to use before starting to set it on Animatable instances.
#define	A_PLUGIN1 (1<<22)

#define	A_PLUGIN2 (1<<23)

#define	A_PLUGIN3 (1<<24)

#define	A_PLUGIN4 (1<<25)

General work flags
These flags can be used by both 3ds Max and plugins. These flags are not persisted with the max file, thus they should only be used as temporary storage. It is highly recommended that plugin code clears the work flag it wishes to use before starting to set it on Animatable instances.
#define	A_WORK1 (1<<28)

#define	A_WORK2 (1<<29)

#define	A_WORK3 (1<<30)

#define	A_WORK4 (1<<31)

Values for Animatable extended flags.
Reserved for future internal use See also Animatable::SetAFlagEx(DWORD mask) Animatable::ClearAFlagEx(DWORD mask) Animatable::TestAFlagEx(DWORD mask)
#define	A_EX_ANIMATABLE_FILE_SAVE_LOCKED (1<<0)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B00 (1<<0)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B01 (1<<1)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B02 (1<<2)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B03 (1<<3)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B04 (1<<4)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B05 (1<<5)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B06 (1<<6)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B07 (1<<7)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B08 (1<<8)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B09 (1<<9)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B10 (1<<10)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B11 (1<<11)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B12 (1<<12)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B13 (1<<13)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B14 (1<<14)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B15 (1<<15)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B16 (1<<16)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B17 (1<<17)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B18 (1<<18)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B19 (1<<19)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B20 (1<<20)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B21 (1<<21)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B22 (1<<22)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B23 (1<<23)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B24 (1<<24)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B25 (1<<25)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B26 (1<<26)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B27 (1<<27)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B28 (1<<28)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B29 (1<<29)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B30 (1<<30)
	Animatable is being used in a scene file save and is locked.

#define	A_EX_RESERVED_B31 (1<<31)
	Animatable is being used in a scene file save and is locked.

Values for Animatable::aflag
The following flags are bits of the aflag data member of class Animatable. See methods Animatable::ClearAFlag(), Animatable::SetAFlag() and Animatable::TestAFlag() to work with these flags.
#define	A_EVALUATING 1
	Used Internally.

#define	A_NOTIFYDEP (1<<1)
	Used Internally.

#define	A_DEPENDENTS_BEING_ENUMERATED (1<<2)
	Used Internally.

#define	A_ANIMATABLE_FILE_LOAD_LOCKED (1<<3)
	Animatable is being used in a scene file load and is locked.

#define	A_OBJECT_REDUCED (1<<4)
	Used Internally.

Detailed Description

Animatable flags are generally meant to be used in enumerations of Animatable instances where each instance must be visited only once.

The Animatable flags are in general not persisted, nor copied between instances of class Animatable. Many of these flags are for internal use only.

Unique Animatable bit flag values can be requested via Animatable::RequestFlagBit(). Plugins are encouraged to use this mechanism over the older General Animatable work flags, or the Animatable plugin flags.

Macro Definition Documentation

◆ A_ATMOS_DISABLED

#define A_ATMOS_DISABLED (1<<5)

The atmosphere effect is disabled.

◆ A_ATMOS_OBJECTXREF

#define A_ATMOS_OBJECTXREF (1<<6)

Not used anywhere.

◆ A_ATMOS_SCENEXREF

#define A_ATMOS_SCENEXREF (1<<7)

An atmospheric scene xref.

◆ A_TONEOP_DISABLED

#define A_TONEOP_DISABLED (1<<5)

The exposure control is disabled.

◆ A_TONEOP_PROCESS_BG

#define A_TONEOP_PROCESS_BG (1<<6)

The exposure control proceses the background.

◆ A_TONEOP_INDIRECT_ONLY

#define A_TONEOP_INDIRECT_ONLY (1<<7)

Only processes indirect lights only.

◆ A_OBJ_CREATING

#define A_OBJ_CREATING (1<<5)

The object is being created. It doesn't want to snap to itself.

◆ A_OBJ_LONG_CREATE

#define A_OBJ_LONG_CREATE (1<<6)

Persists throughout the whole creation process as opposed to A_OBJ_CREATING which gets cleared as as the object is added to the scene.

◆ A_OBJ_BEING_EDITED

#define A_OBJ_BEING_EDITED (1<<7)

The object is being created. It doesn't want to snap to itself.

◆ A_MOD_DISABLED

#define A_MOD_DISABLED (1<<5)

The modifier is disabled.

◆ A_MOD_BEING_EDITED

#define A_MOD_BEING_EDITED (1<<6)

The modifer is deleted.

◆ A_MOD_USE_SEL

#define A_MOD_USE_SEL (1<<7)

No longer used - use sub-ob selection.

◆ A_MOD_DISABLED_INVIEWS

#define A_MOD_DISABLED_INVIEWS (1<<8)

Modifier is disabled in viewports only.

◆ A_MOD_DISABLED_INRENDER

#define A_MOD_DISABLED_INRENDER (1<<9)

Modifier is disabled in renderer only.

◆ A_MODAPP_DISABLED

#define A_MODAPP_DISABLED (1<<5)

Used internally.

◆ A_MODAPP_SELECTED

#define A_MODAPP_SELECTED (1<<6)

parent node is selected

◆ A_MODAPP_DISPLAY_ACTIVE

#define A_MODAPP_DISPLAY_ACTIVE (1<<7)

Used internally.

◆ A_MODAPP_DYNAMIC_BOX

#define A_MODAPP_DYNAMIC_BOX (1<<8)

Used internally.

◆ A_MODAPP_RENDERING

#define A_MODAPP_RENDERING (1<<9)

Render begin turns this on and render end turns it off.

◆ A_DERIVEDOBJ_DONTDELETE

#define A_DERIVEDOBJ_DONTDELETE (1<<9)

When the last modifier is deleted form this derived object, don't delete the derived object.

◆ A_ORT_MASK

#define A_ORT_MASK 7

Used internally.

◆ A_ORT_BEFORESHIFT

#define A_ORT_BEFORESHIFT 5

Uses bits 5,6 and 7 to store ORT.

◆ A_ORT_AFTERSHIFT

#define A_ORT_AFTERSHIFT 8

Uses bits 8,9 and 10 to store ORT.

◆ A_CTRL_DISABLED

#define A_CTRL_DISABLED (1<<11)

Used internally.

◆ A_ORT_DISABLED

#define A_ORT_DISABLED (1<<19)

Indicates that the ORT is disabled.

◆ A_INODE_IK_TERMINATOR

#define A_INODE_IK_TERMINATOR (1<<5)

Terminates the top of an IK chain.

◆ A_INODE_IK_POS_PINNED

#define A_INODE_IK_POS_PINNED (1<<6)

The position is pinned.

◆ A_INODE_IK_ROT_PINNED

#define A_INODE_IK_ROT_PINNED (1<<7)

The rotation is pinned.

◆ A_INODE_CLONE_TARGET

#define A_INODE_CLONE_TARGET (1<<8)

Terminates the top of an IK chain.

◆ A_INODE_IN_UPDATE

#define A_INODE_IN_UPDATE (1<<9)

Used internally only.

◆ A_INODE_IN_UPDATE_TM

#define A_INODE_IN_UPDATE_TM (1<<10)

Flag is set if it's updating it's TM. Don't Call GetNodeTM if it is.

◆ A_PB2_POSTLOADCALLBACK

#define A_PB2_POSTLOADCALLBACK (1<<5)

Set when a Paramblock2 has added itself to the PostLoadCallback used so we dont add multiple copies to the array.

◆ A_COMPONENT_LOCKED

#define A_COMPONENT_LOCKED (1<<19)

Needed for CompositeBase and its children.

Note: CompositeBase derives from ShapeObject)

◆ A_TVNODE_DONTRESACLECONTROLLERS

#define A_TVNODE_DONTRESACLECONTROLLERS (1 << 5)

Don't call RescaleWorldUnits on sub-controllers.

◆ A_HELD

#define A_HELD (1<<12)

Typically a plug-in would not hold unless this flag was not set.

Then set it once it has held something, then clear it once EndHold() is called on the RestoreObj. This will keep it from putting multiple restore objects in one cycle. See Undo/Redo for more details.

◆ A_SET

#define A_SET (1<<13)

Similar to A_HELD except is used by controllers.

◆ A_IS_DELETED

#define A_IS_DELETED (1<<14)

Used internally.

Deleted but kept around for UNDO

◆ A_BEING_AUTO_DELETED

#define A_BEING_AUTO_DELETED (1<<15)

Used internally.

To prevent AutoDelete from being re-entered.

◆ A_CHANGE_PARENTS_DONE

#define A_CHANGE_PARENTS_DONE (1<<17)

Used internally.

Used by FileLink for replacing Acad controllers, and is used on controllers.

Note: Nothing else should use it.

◆ A_REFMAKER_REFS_CHECKED

#define A_REFMAKER_REFS_CHECKED (1<<18)

Used internally.

Used to flag that at least one reference has been set on a refmaker, and that the refmaker's references were checked at that time to make sure they were all NULL.

◆ A_SUPERCLASS1

#define A_SUPERCLASS1 (1<<20)

◆ A_SUPERCLASS2

#define A_SUPERCLASS2 (1<<21)

◆ A_PLUGIN1

#define A_PLUGIN1 (1<<22)

◆ A_PLUGIN2

#define A_PLUGIN2 (1<<23)

◆ A_PLUGIN3

#define A_PLUGIN3 (1<<24)

◆ A_PLUGIN4

#define A_PLUGIN4 (1<<25)

◆ A_DEPENDENCY_TEST

#define A_DEPENDENCY_TEST (1<<26)

Used to test for a dependency.

◆ A_LOCK_TARGET

#define A_LOCK_TARGET (1<<27)

Ref target isn't deleted when dependents goes to 0 if this flag is set.

Setting this flag will keep an item from being deleted when you delete a reference to it. For example, if you need to swap references for two items. For instance, say you have two nodes and two objects and you want to swap the object reference of the nodes. If you simply call ReplaceReference() on one node with the other node's object, the old object will get deleted because nothing else is referencing it anymore. By setting this flag temporarily you can keep it from being deleted and perform the swap.

◆ A_WORK1

#define A_WORK1 (1<<28)

◆ A_WORK2

#define A_WORK2 (1<<29)

◆ A_WORK3

#define A_WORK3 (1<<30)