- Generated by
1.14.0
|
3ds Max C++ API Reference
|
#include "assert1.h"#include "maxheap.h"#include "coreexp.h"#include "strbasic.h"#include "maxtypes.h"#include "notifyParams.h"Macros | |
| #define | DEFINE_NOTIFY_CODE(notifyCodeName, codeVal, callParamType) |
| Macro to define a notification code and associated type, and register it for GetNotifyParam. | |
| #define | NOTIFY_UNITS_CHANGE 0x00000001 |
| Sent if the user changes the unit setting. | |
| #define | NOTIFY_TIMEUNITS_CHANGE 0x00000002 |
| Sent if the user changes the time format setting. | |
| #define | NOTIFY_VIEWPORT_CHANGE 0x00000003 |
| Sent if the user changes the viewport layout. | |
| #define | NOTIFY_SPACEMODE_CHANGE 0x00000004 |
| Sent if the user changes the reference coordinate system. | |
| #define | NOTIFY_SYSTEM_PRE_RESET 0x00000005 |
| Sent before 3ds Max system is reset. | |
| #define | NOTIFY_SYSTEM_POST_RESET 0x00000006 |
| Sent after 3ds Max system is reset. | |
| #define | NOTIFY_FILE_POST_SAVE_OLD 0x00000011 |
| Sent after an old version file is saved. | |
| #define | NOTIFY_SELECTIONSET_CHANGED 0x00000012 |
| Sent after the selection set has changed. | |
| #define | NOTIFY_POST_RENDER 0x00000015 |
| Sent after rendering has finished. | |
| #define | NOTIFY_PRE_IMPORT 0x00000018 |
| Sent before a file is imported. | |
| #define | NOTIFY_PRE_EXPORT 0x0000001B |
| Sent before a file is exported. | |
| #define | NOTIFY_PRE_PROGRESS 0x0000001F |
| Sent before the progress bar is displayed. | |
| #define | NOTIFY_POST_PROGRESS 0x00000020 |
| Sent after the progress bar is finished. | |
| #define | NOTIFY_MODPANEL_SEL_CHANGED 0x00000021 |
| Sent when the modify panel focuses on a new object because of opening the Modify panel or changing selection. | |
| #define | NOTIFY_RENDPARAM_CHANGED 0x00000023 |
| Sent when the common renderer parameters have changed via the render dialog. | |
| #define | NOTIFY_FILELINK_BIND_FAILED 0x0000002A |
| Sent if a File Link Bind fails. | |
| #define | NOTIFY_FILELINK_DETACH_FAILED 0x0000002B |
| Sent if a File Link Detach fails. | |
| #define | NOTIFY_FILELINK_RELOAD_FAILED 0x0000002C |
| Sent if a File Link Reload fails. | |
| #define | NOTIFY_FILELINK_ATTACH_FAILED 0x0000002D |
| Sent if a File Link Attach fails. | |
| #define | NOTIFY_FILELINK_PRE_BIND 0x00000030 |
| Sent before a File Link Bind. | |
| #define | NOTIFY_FILELINK_POST_BIND 0x00000031 |
| Sent after a successful File Link Bind. | |
| #define | NOTIFY_FILELINK_PRE_DETACH 0x00000032 |
| Sent before a File Link Detach. | |
| #define | NOTIFY_FILELINK_POST_DETACH 0x00000033 |
| Sent after a successful File Link Detach. | |
| #define | NOTIFY_FILELINK_PRE_RELOAD 0x00000034 |
| Sent before a File Link Reload (partial, full, or dynamic) | |
| #define | NOTIFY_FILELINK_POST_RELOAD 0x00000035 |
| Sent after a successful File Link Reload (partial, full, or dynamic) | |
| #define | NOTIFY_FILELINK_PRE_ATTACH 0x00000036 |
| Sent before a File Link Attach. | |
| #define | NOTIFY_FILELINK_POST_ATTACH 0x00000037 |
| Sent after a successful File Link. | |
| #define | NOTIFY_SCENE_POST_DELETED_NODE 0x00000045 |
| Node just removed from scene. | |
| #define | NOTIFY_SEL_NODES_POST_DELETE 0x00000047 |
| Selected nodes just deleted. | |
| #define | NOTIFY_NODES_POST_DELETE 0x000000CF |
| Nodes just deleted. | |
| #define | NOTIFY_SYSTEM_SHUTDOWN 0x00000049 |
| 3ds Max is about to exit, (system shutdown starting) | |
| #define | NOTIFY_SYSTEM_STARTUP 0x00000050 |
| 3ds Max just went live | |
| #define | NOTIFY_SYSTEM_SHUTDOWN2 0x00000052 |
| Last broadcast before exit, after the scene is destroyed. | |
| #define | NOTIFY_ANIMATE_ON 0x00000053 |
| Sent when Animate UI mode is activated. | |
| #define | NOTIFY_ANIMATE_OFF 0x00000054 |
| Sent when Animate UI mode is de-activated. | |
| #define | NOTIFY_COLOR_CHANGE 0x00000055 |
| Sent by the system when one or more custom colors have changed. | |
| #define | NOTIFY_PRE_EDIT_OBJ_CHANGE 0x00000056 |
| Sent just before the current edit object is about to change. | |
| #define | NOTIFY_POST_EDIT_OBJ_CHANGE 0x00000057 |
| Sent just after the current edit object changes. | |
| #define | NOTIFY_LIGHTING_UNIT_DISPLAY_SYSTEM_CHANGE 0x0000005C |
| Sent when lighting unit display system is changed. | |
| #define | NOTIFY_RADIOSITY_PLUGIN_CHANGED 0x00000060 |
| Sent when the radiosity plugin is changed (a new one is assigned) | |
| #define | NOTIFY_MANIPULATE_MODE_OFF 0x00000063 |
| Sent when manipulate mode ends. | |
| #define | NOTIFY_MANIPULATE_MODE_ON 0x00000064 |
| Sent when manipulate mode starts. | |
| #define | NOTIFY_PRE_NOTIFYDEPENDENTS 0x0000006C |
| Sent before NotifyDependents from outside the recursion. | |
| #define | NOTIFY_POST_NOTIFYDEPENDENTS 0x0000006D |
| Sent after NotifyDependents from outside the recursion. | |
| #define | NOTIFY_TIMERANGE_CHANGE 0x00000070 |
| Sent after the animate time range has been changed. | |
| #define | NOTIFY_FILELINK_POST_RELOAD_PRE_PRUNE 0x00000085 |
| Sent after all of the new objects for a reload have been created. | |
| #define | NOTIFY_BY_CATEGORY_DISPLAY_FILTER_CHANGED 0x00000092 |
| Sent AFTER object categories were marked to be hidden/unhidden. | |
| #define | NOTIFY_CUSTOM_DISPLAY_FILTER_CHANGED 0x00000093 |
| Sent AFTER custom display filters have been activated/deactivated. | |
| #define | NOTIFY_MXS_STARTUP 0x0000009B |
| Sent by MAXScript during its initialization. | |
| #define | NOTIFY_MXS_POST_STARTUP 0x0000009C |
| Sent by MAXScript when it has completed its initialization. | |
| #define | NOTIFY_MXS_SHUTDOWN 0x000000A7 |
| Sent when MAXScript has been shut down. | |
| #define | NOTIFY_D3D_PRE_DEVICE_RESET 0x000000A8 |
| This is sent by the D3D GFX (Dx9) when a device reset is going to happen. | |
| #define | NOTIFY_D3D_POST_DEVICE_RESET 0x000000A9 |
| This is sent by the D3D GFX (Dx9) when a device reset has happened. | |
| #define | NOTIFY_TOOLPALETTE_MTL_SUSPEND 0x000000AA |
| Used to suspend material change tracking in VIZ. | |
| #define | NOTIFY_TOOLPALETTE_MTL_RESUME 0x000000AB |
| Used to resume material change tracking in VIZ. | |
| #define | NOTIFY_POST_SCENE_RESET 0x000000BD |
| Sent just after deleting all refs in existing scene. | |
| #define | NOTIFY_SELECTION_LOCK 0x000000D0 |
| Sent when selection lock is triggered. */. | |
| #define | NOTIFY_SELECTION_UNLOCK 0x000000D1 |
| Sent when selection unlock is triggered. */. | |
| #define | NOTIFY_OS_THEME_CHANGED 0x000000D7 |
| Sent after OS theme has been changed. | |
| #define | NOTIFY_ACTIVE_VIEWPORT_CHANGED 0x000000D8 |
| Sent when the current active viewport is changed. | |
| #define | NOTIFY_PRE_MAXMAINWINDOW_SHOW 0x000000DB |
| NOTIFY_PRE_MAXMAINWINDOW_SHOW is being sent when main window of 3ds Max is about to show. | |
| #define | NOTIFY_POST_MAXMAINWINDOW_SHOW 0x000000DC |
| NOTIFY_POST_MAXMAINWINDOW_SHOW is being sent immediately after the main window of 3ds Max is shown. | |
| #define | NOTIFY_PRE_APP_FRAME_THEME_CHANGED 0x000000E2 |
| Sent before the application theme is changed via IColorManager::SetAppFrameColorTheme(). | |
| #define | NOTIFY_APP_FRAME_THEME_CHANGED 0x000000E3 |
| Sent when the application theme is changed via IColorManager::SetAppFrameColorTheme(). | |
| #define | NOTIFY_PRE_WORKSPACE_COLLECTION_CHANGE 0x000000E7 |
| Sent before the collection of system workspaces is about to change. | |
| #define | NOTIFY_POST_WORKSPACE_COLLECTION_CHANGE 0x000000E8 |
| Sent after the collection of system workspaces has changed. | |
| #define | NOTIFY_KEYBOARD_SETTING_CHANGED 0x000000E9 |
| Sent after keyboard short-cut setting file(*.kbd) has changed. | |
| #define | NOTIFY_MOUSE_SETTING_CHANGED 0x000000EA |
| Sent after mouse setting file has changed. | |
| #define | NOTIFY_APP_ACTIVATED 0x000000ED |
| Called when the main application window is activated. | |
| #define | NOTIFY_APP_DEACTIVATED 0x000000EE |
| Called when the main application window is deactivated. | |
| #define | NOTIFY_PLUGINS_PRE_SHUTDOWN 0x000000F3 |
| Sent during shutdown immediately before DllDesc::CallShutdown is called on all plugin dlls. | |
| #define | NOTIFY_PLUGINS_PRE_UNLOAD 0x000000F4 |
| Sent during shutdown immediately before DllDesc::Unload is called on all plugin dlls. | |
| #define | NOTIFY_POST_NODE_SELECT_OPERATION 0x000000FC |
| Sent after the system Node Selection Processor has finished selecting nodes. | |
| #define | NOTIFY_WELCOMESCREEN_DONE 0x000000FE |
| Sent once initial welcome screen is done (either it did not show or it has been closed). | |
| #define | NOTIFY_PLAYBACK_START 0x000000FF |
| #define | NOTIFY_PLAYBACK_END 0x00000100 |
| #define | NOTIFY_SCENE_EXPLORER_NEEDS_UPDATE 0x00000101 |
| Sent if the scene explorer needs to refresh its display. | |
| #define | NOTIFY_FILE_POST_OPEN_PROCESS_FINALIZED 0x00000102 |
| Sent at the very end of the load sequence, note that any animatables created by the scene load may have been deleted by this point. | |
| #define | NOTIFY_FILE_POST_MERGE_PROCESS_FINALIZED 0x00000103 |
| Sent at the very end of the merge sequence, note that any animatables created by the scene merge may have been deleted by this point. | |
| #define | NOTIFY_PRE_PROJECT_FOLDER_CHANGE 0x00000104 |
| Sent before project folder is changed. | |
| #define | NOTIFY_POST_PROJECT_FOLDER_CHANGE 0x00000105 |
| Sent after project folder is changed. | |
| #define | NOTIFY_PRE_MXS_STARTUP_SCRIPT_LOAD 0x00000106 |
| Sent immediately before MAXScript loads its startup scripts. stdscripts will have already been read. | |
| #define | NOTIFY_SYSTEM_SHUTDOWN_CHECK 0x00000108 |
| Sent when potentially starting to shut 3ds Max down, before checking for things that can cancel the shutdown, such as scene dirty or ExitMAXCallback callback object returning false. | |
| #define | NOTIFY_SYSTEM_SHUTDOWN_CHECK_FAILED 0x00000109 |
| Sent if system shutdown was cancelled. | |
| #define | NOTIFY_SYSTEM_SHUTDOWN_CHECK_PASSED 0x0000010A |
| Sent if system shutdown was not cancelled. and system shutdown is about to start. | |
| #define | NOTIFY_COLOR_MANAGEMENT_PRE_CHANGE 0x0000010F |
| Sent before the system color management settings changed, this includes mode changes, system-wide gamma setting or changes to color config. | |
| #define | NOTIFY_CUI_MENUS_INVALID 0x00000113 |
| : Sent before menu structure is modified (for example before loading a mnxb file) The intent is to use this notification to clear any storage related to menu structure to avoid keeping dangling pointers NotifyInfo::callParam is nullptr | |
| #define | NOTIFY_CUI_MENUS_VALID 0x00000114 |
| : Sent after menu structure is modified (for example after loading a mnxb file) The intent is to use this notification to perform any additional ui updates after new menus are loaded NotifyInfo::callParam is nullptr | |
| #define | NOTIFY_CUI_QUAD_MENUS_INVALID 0x00000115 |
| : Sent before quad menu structure is modified (for example before loading a qmnxb file) The intent is to use this notification to clear any storage related to menu structure to avoid keeping dangling pointers NotifyInfo::callParam is nullptr | |
| #define | NOTIFY_CUI_QUAD_MENUS_VALID 0x00000116 |
| : Sent after quad menu structure is modified (for example after loading a qmnxb file) The intent is to use this notification to perform any additional ui updates after new menus are loaded NotifyInfo::callParam is nullptr | |
| #define | NOTIFY_INTERNAL_USE_START 0x70000000 |
Asset Tracking System Notifications | |
These notification bracket ATS traversal of the entire scene (or ReferenceTarget hierarchy, in the case of a general retarget action) and repath any assets that should be repathed.
| |
| #define | NOTIFY_ATS_PRE_REPATH_PHASE 0x000000B3 |
| Sent before the ATS traversal starts. | |
| #define | NOTIFY_ATS_POST_REPATH_PHASE 0x000000B4 |
| Sent after the ATS traversal completes. | |
Bitmap Proxy System Notifications | |
Any specific operation during which proxies should be disable can be surrounded by these notifications. This method of disabling proxies is different from actually disabling the bitmap proxies through the proxy manager; these notifications do not actually result in re-loading of any bitmaps. Rather, the Bitmap Texture will only load the high-res image when it is asked to, which makes the process efficient.
| |
| #define | NOTIFY_PROXY_TEMPORARY_DISABLE_START 0x000000B5 |
| #define | NOTIFY_PROXY_TEMPORARY_DISABLE_END 0x000000B6 |
New Scene Options | |
| #define | PRE_NEW_NEW_ALL 0x1 |
| All objects are deleted, including their animation data. | |
Typedefs | |
| template<NotifyCode code> | |
| using | notify_param_t = typename notify_param_helper<code>::type |
| Helper type alias to assign a param type to a notification code. | |
| using | NOTIFYPROC = void (*)(void* param, NotifyInfo* info) |
Functions | |
| template<NotifyCode code, NotifyCode... more_codes> | |
| notify_param_t< code > | GetNotifyParam (NotifyInfo *info) |
| ! | |
| CoreExport int | RegisterNotification (NOTIFYPROC proc, void *param, NotifyCode code) |
| CoreExport int | UnRegisterNotification (NOTIFYPROC proc, void *param, NotifyCode code) |
| CoreExport int | UnRegisterNotification (NOTIFYPROC proc, void *param) |
| CoreExport void | BroadcastNotification (NotifyCode code) |
| It is not recommended to use this function directly. | |
| CoreExport void | BroadcastNotification (NotifyCode code, void *callParam) |
| It is not recommended to use this function directly. | |
| template<NotifyCode code> | |
| void | BroadcastNotification () |
| template<NotifyCode code> | |
| void | BroadcastNotification (notify_param_t< code > callParam) |
Variables | |
| constexpr NotifyCode | NOTIFY_SYSTEM_PRE_NEW = 0x00000007 |
| Sent before a new scene is requested. | |
| constexpr NotifyCode | NOTIFY_SYSTEM_POST_NEW = 0x00000008 |
| Sent after a new scene requested has been serviced. | |
| constexpr NotifyCode | NOTIFY_FILE_PRE_OPEN = 0x00000009 |
| Sent before a file is opened. NotifyInfo::callParam is a pointer to type FileIOType. | |
| constexpr NotifyCode | NOTIFY_FILE_POST_OPEN = 0x0000000A |
| Sent after a file is opened successfully. | |
| constexpr NotifyCode | NOTIFY_FILE_PRE_MERGE = 0x0000000B |
| Sent before a file is merged. | |
| constexpr NotifyCode | NOTIFY_FILE_PRE_SAVE = 0x0000000D |
| Sent before a file is saved (NotifyInfo::callParam is a pointer to a string (MCHAR *) of the file name). | |
| constexpr NotifyCode | NOTIFY_FILE_POST_SAVE = 0x0000000E |
| Sent after a file is saved (NotifyInfo::callParam is a pointer to a string (MCHAR *) of the file name). | |
| constexpr NotifyCode | NOTIFY_FILE_OPEN_FAILED = 0x0000000F |
| Sent after a file open fails. NotifyInfo::callParam is a pointer to type FileIOType. | |
| constexpr NotifyCode | NOTIFY_FILE_PRE_SAVE_OLD = 0x00000010 |
| Sent before an old version file is saved. | |
| constexpr NotifyCode | NOTIFY_BITMAP_CHANGED = 0x00000013 |
| Sent after a bitmap is reloaded. | |
| constexpr NotifyCode | NOTIFY_PRE_RENDER = 0x00000014 |
| Sent before rendering starts. | |
| constexpr NotifyCode | NOTIFY_PRE_RENDERFRAME = 0x00000016 |
| Sent before rendering each frame. | |
| constexpr NotifyCode | NOTIFY_POST_RENDERFRAME = 0x00000017 |
| Sent after rendering each. | |
| constexpr NotifyCode | NOTIFY_POST_IMPORT = 0x00000019 |
| Sent after a file is imported successfully. | |
| constexpr NotifyCode | NOTIFY_IMPORT_FAILED = 0x0000001A |
| Sent if a file import fails or is cancelled. | |
| constexpr NotifyCode | NOTIFY_POST_EXPORT = 0x0000001C |
| Sent after a file is exported successfully. | |
| constexpr NotifyCode | NOTIFY_EXPORT_FAILED = 0x0000001D |
| Sent if a export fails or is cancelled. | |
| constexpr NotifyCode | NOTIFY_NODE_RENAMED = 0x0000001E |
| These kinds of notifications are sent when the name of a target has been changed. | |
| constexpr NotifyCode | NOTIFY_RENDER_PREEVAL = 0x00000039 |
| Sent before the renderer starts evaluating objects; NotifyInfo::callParam is a pointer to TimeValue. | |
| constexpr NotifyCode | NOTIFY_NODE_CREATED = 0x0000003A |
| Sent when a node is created (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_NODE_LINKED = 0x0000003B |
| Sent when a node is linked (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_NODE_UNLINKED = 0x0000003C |
| Sent when a node is unlinked (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_NODE_HIDE = 0x0000003D |
| Sent when a node is hidden (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_NODE_UNHIDE = 0x0000003E |
| Sent when a node is unhidden (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_NODE_FREEZE = 0x0000003F |
| Sent when a node is frozen (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_NODE_UNFREEZE = 0x00000040 |
| Sent when a node is unfrozen (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_NODE_PRE_MTL = 0x00000041 |
| Node is about to get a new material (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_NODE_POST_MTL = 0x00000042 |
| Node just got a new material (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_SCENE_ADDED_NODE = 0x00000043 |
| Node just added to scene (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_SCENE_PRE_DELETED_NODE = 0x00000044 |
| Node just removed from scene (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_SEL_NODES_PRE_DELETE = 0x00000046 |
| selected nodes will be deleted. (NotifyInfo::callParam is a pointer to Tab<INode*>) | |
| constexpr NotifyCode | NOTIFY_NODES_PRE_DELETE = 0x000000CE |
| Nodes will be deleted. (NotifyInfo::callParam is a pointer to const INodeTab) | |
| constexpr NotifyCode | NOTIFY_WM_ENABLE = 0x00000048 |
| Sent when main window gets an WM_ENABLE (BOOL enabled) | |
| constexpr NotifyCode | NOTIFY_PLUGIN_LOADED = 0x00000051 |
| A plug-in was just loaded. (NotifyInfo::callParam is a pointer to DllDesc). | |
| constexpr NotifyCode | NOTIFY_RADIOSITYPROCESS_STARTED = 0x00000058 |
| Sent when radiosity processing is started. | |
| constexpr NotifyCode | NOTIFY_RADIOSITYPROCESS_STOPPED = 0x00000059 |
| Sent when radiosity processing is stopped, but not done. | |
| constexpr NotifyCode | NOTIFY_RADIOSITYPROCESS_RESET = 0x0000005A |
| Sent when radiosity processing is reset. | |
| constexpr NotifyCode | NOTIFY_RADIOSITYPROCESS_DONE = 0x0000005B |
| Sent when radiosity processing is complete. | |
| constexpr NotifyCode | NOTIFY_BEGIN_RENDERING_REFLECT_REFRACT_MAP = 0x0000005D |
| Sent when starting to render a reflect/refract map. | |
| constexpr NotifyCode | NOTIFY_BEGIN_RENDERING_ACTUAL_FRAME = 0x0000005E |
| Sent when starting to render the full frame. | |
| constexpr NotifyCode | NOTIFY_BEGIN_RENDERING_TONEMAPPING_IMAGE = 0x0000005F |
| Sent when starting to render a tone-mapping image. | |
| constexpr NotifyCode | NOTIFY_SCENE_UNDO = 0x00000061 |
| Sent on scene undo (NotifyInfo::callParam is a pointer to a string (MCHAR*) with the undo entry name). | |
| constexpr NotifyCode | NOTIFY_SCENE_REDO = 0x00000062 |
| Sent on scene redo (NotifyInfo::callParam is a pointer to a string (MCHAR*) with the redo entry name). | |
| constexpr NotifyCode | NOTIFY_PRE_MIRROR_NODES = 0x00000069 |
| Sent before a mirror operation begins. | |
| constexpr NotifyCode | NOTIFY_POST_MIRROR_NODES = 0x0000006A |
| Sent after a mirror operation ends. | |
| constexpr NotifyCode | NOTIFY_NODE_CLONED = 0x0000006B |
| Sent after a node is cloned but before theHold.Accept(..) (NotifyInfo::callParam is a pointer to the node). | |
| constexpr NotifyCode | NOTIFY_MTL_REFADDED = 0x0000006E |
| Sent by Mtl::RefAdded(). NotifyInfo::callParam is a Mtl pointer. | |
| constexpr NotifyCode | NOTIFY_MTL_REFDELETED = 0x0000006F |
| Sent by Mtl::FefDeleted(). NotifyInfo::callParam is a Mtl pointer. | |
| constexpr NotifyCode | NOTIFY_PRE_MODIFIER_ADDED = 0x00000071 |
| Sent before a modifier is added to an object. | |
| constexpr NotifyCode | NOTIFY_POST_MODIFIER_ADDED = 0x00000072 |
| Sent after a modifier is added to an object. | |
| constexpr NotifyCode | NOTIFY_PRE_MODIFIER_DELETED = 0x00000073 |
| Sent before a modifier is deleted from an object. | |
| constexpr NotifyCode | NOTIFY_POST_MODIFIER_DELETED = 0x00000074 |
| Sent after a modifier is deleted from an object. | |
| constexpr NotifyCode | NOTIFY_PRE_NODES_CLONED = 0x00000086 |
| Sent before each set of clones is created. | |
| constexpr NotifyCode | NOTIFY_POST_NODES_CLONED = 0x00000087 |
| Sent after each set of clones is created. | |
| constexpr NotifyCode | NOTIFY_SYSTEM_PRE_DIR_CHANGE = 0x00000089 |
| Sent before a system path changes. | |
| constexpr NotifyCode | NOTIFY_SYSTEM_POST_DIR_CHANGE = 0x0000008A |
| Sent after a system path has changed. | |
| constexpr NotifyCode | NOTIFY_SV_SELECTIONSET_CHANGED = 0x0000008C |
| Schematic view notification. | |
| constexpr NotifyCode | NOTIFY_SV_DOUBLECLICK_GRAPHNODE = 0x0000008D |
| Schematic view notification. | |
| constexpr NotifyCode | NOTIFY_PRE_RENDERER_CHANGE = 0x0000008E |
| Sent before the renderer changes. | |
| constexpr NotifyCode | NOTIFY_POST_RENDERER_CHANGE = 0x0000008F |
| Sent after the renderer changes. | |
| constexpr NotifyCode | NOTIFY_SV_PRE_LAYOUT_CHANGE = 0x00000090 |
| Sent before a schematic view layout change is made. | |
| constexpr NotifyCode | NOTIFY_SV_POST_LAYOUT_CHANGE = 0x00000091 |
| Sent after a schematic view layout change is made. | |
| constexpr NotifyCode | NOTIFY_LAYER_CREATED = 0x00000094 |
| Sent after a layer is added to layer manager. | |
| constexpr NotifyCode | NOTIFY_LAYER_DELETED = 0x00000095 |
| Sent before layer is removed from layer manager; NotifyInfo::callParam is a pointer to ILayer. | |
| constexpr NotifyCode | NOTIFY_NODE_LAYER_CHANGED = 0x00000096 |
| NotifyInfo::callParam is a pointer to LayerChange. | |
| constexpr NotifyCode | NOTIFY_TABBED_DIALOG_CREATED = 0x00000097 |
| Sent when a tabbed dialog is created. | |
| constexpr NotifyCode | NOTIFY_TABBED_DIALOG_DELETED = 0x00000098 |
| Sent when a tabbed dialog is deleted. | |
| constexpr NotifyCode | NOTIFY_NODE_NAME_SET = 0x00000099 |
| Sent by BaseNode::SetName. | |
| constexpr NotifyCode | NOTIFY_HW_TEXTURE_CHANGED = 0x0000009A |
| Sent by the Material Editor when the "use texture in hardware shader" button is pressed. | |
| constexpr NotifyCode | NOTIFY_ACTION_ITEM_HOTKEY_PRE_EXEC = 0x0000009D |
| Sent before an action item is executed via a keyboard shortcut (hotkey). NotifyInfo::callParam is ActionItem*. | |
| constexpr NotifyCode | NOTIFY_ACTION_ITEM_HOTKEY_POST_EXEC = 0x0000009E |
| Sent after an action item is executed via a keyboard shortcut (hotkey). NotifyInfo::callParam is ActionItem*. | |
| constexpr NotifyCode | NOTIFY_CLASSDESC_REPLACED = 0x000000AC |
| Provides a notification that a ClassDesc is being replaced by another one. | |
| constexpr NotifyCode | NOTIFY_CLASSDESC_LOADED = 0x000000B0 |
| Sent after a ClassDesc was successfully loaded from a plugin dll. | |
| constexpr NotifyCode | NOTIFY_TOOLBARS_PRE_LOAD = 0x000000B1 |
| This provides a notification that a toolbar configuration is being loaded, prior to load. | |
| constexpr NotifyCode | NOTIFY_TOOLBARS_POST_LOAD = 0x000000B2 |
| This provides a notification that a toolbar configuration is being loaded, after the load. | |
| constexpr NotifyCode | NOTIFY_FILE_CHECK_STATUS = 0x000000B7 |
| Allows a plugin to query the system for the status of the file before max saves the max scene file. | |
| constexpr NotifyCode | NOTIFY_MODPANEL_SUBOBJECTLEVEL_CHANGED = 0x000000BA |
| Sent when the sub-object level changes in the modify panel. | |
| constexpr NotifyCode | NOTIFY_FAILED_DIRECTX_MATERIAL_TEXTURE_LOAD = 0x000000BB |
| Sent when a bitmap fails to load in the DirectX Shader Material. | |
| constexpr NotifyCode | NOTIFY_ANIM_LAYERS_ENABLED = 0x000000BE |
| Sent just after animation layers are enabled on some nodes in the scene. | |
| constexpr NotifyCode | NOTIFY_ANIM_LAYERS_DISABLED = 0x000000BF |
| Sent just after animation layers are disabled on some nodes in the scene. | |
| constexpr NotifyCode | NOTIFY_ACTION_ITEM_PRE_START_OVERRIDE = 0x000000C0 |
| Sent just before an action item is overridden and IActionItemOverride::StartOveride is called. | |
| constexpr NotifyCode | NOTIFY_ACTION_ITEM_POST_START_OVERRIDE = 0x000000C1 |
| Sent just after an action item is overridden and after IActionItemOverride::StartOveride is called. | |
| constexpr NotifyCode | NOTIFY_ACTION_ITEM_PRE_END_OVERRIDE = 0x000000C2 |
| Sent just before an action item finishes it's override and IActionItemOverride::EndOverride is called. | |
| constexpr NotifyCode | NOTIFY_ACTION_ITEM_POST_END_OVERRIDE = 0x000000C3 |
| Sent just after an action item finishes it's override and after IActionItemOverride::EndOverride is called. */. | |
| constexpr NotifyCode | NOTIFY_PRE_IMAGE_VIEWER_DISPLAY = 0x000000D2 |
| Sent when an image viewer (including the rendered frame window) is opened, before it becomes visible. */. | |
| constexpr NotifyCode | NOTIFY_POST_IMAGE_VIEWER_DISPLAY = 0x000000D3 |
| Sent when an image viewer (including the rendered frame window) is opened, after it becomes visible. */. | |
| constexpr NotifyCode | NOTIFY_IMAGE_VIEWER_UPDATE = 0x000000D4 |
| Sent by an image viewer (or the rendered frame window) to request that its custom rollouts update their UI. */. | |
| constexpr NotifyCode | NOTIFY_CLASSDESC_ADDED = 0x000000DD |
| Provides a notification that a new ClassDesc is being registered. | |
| constexpr NotifyCode | NOTIFY_OBJECT_DEFINITION_CHANGE_BEGIN = 0x000000DE |
| NOTIFY_OBJECT_DEFINITION_CHANGE_BEGIN is sent immediately before object instances are updated to a new object definition. | |
| constexpr NotifyCode | NOTIFY_OBJECT_DEFINITION_CHANGE_END = 0x000000DF |
| NOTIFY_OBJECT_DEFINITION_CHANGE_END is sent immediately after object instances are updated to a new object definition. | |
| constexpr NotifyCode | NOTIFY_MTLBASE_PARAMDLG_PRE_OPEN = 0x000000E0 |
| Sent when a MtlBase is about to show its UI with Associated parameter rollouts when being edited in a material editor. | |
| constexpr NotifyCode | NOTIFY_MTLBASE_PARAMDLG_POST_CLOSE = 0x000000E1 |
| Sent when a MtlBase has finished its editing in the material editor and the UI with Associated parameter rollouts have been closed. | |
| constexpr NotifyCode | NOTIFY_PRE_VIEWPORT_DELETE = 0x000000E4 |
| Sent before a viewport is deleted. It usually occurs when removing a view tab. | |
| constexpr NotifyCode | NOTIFY_PRE_WORKSPACE_CHANGE = 0x000000E5 |
| Sent before a CUI workspace is about to change NotifyInfo::callParam is a pointer to a string (MCHAR*), containing the name of the workspace the CUI is changing to. | |
| constexpr NotifyCode | NOTIFY_POST_WORKSPACE_CHANGE = 0x000000E6 |
| Sent after a CUI workspace has changed NotifyInfo::callParam is a pointer to a string (MCHAR*), containing the name of the workspace the CUI has changed to. | |
| constexpr NotifyCode | NOTIFY_TOOLBARS_PRE_SAVE = 0x000000EB |
| This provides a notification that a toolbar configuration is being saved, prior to save. | |
| constexpr NotifyCode | NOTIFY_TOOLBARS_POST_SAVE = 0x000000EC |
| This provides a notification that a toolbar configuration is being saved, after the save. | |
| constexpr NotifyCode | NOTIFY_VIEWPORT_SAFEFRAME_TOGGLE = 0x000000F2 |
| Called after the safe frame has been toggled on/off for the viewport. | |
| constexpr NotifyCode | NOTIFY_CUI_MENUS_POST_LOAD = 0x000000F5 |
| Called after a menu file has been loaded and the menu bar updated. | |
| constexpr NotifyCode | NOTIFY_LAYER_PARENT_CHANGED = 0x000000F6 |
| Sent after the parent of a layer was changed. | |
| constexpr NotifyCode | NOTIFY_ACTION_ITEM_EXECUTION_STARTED = 0x000000F7 |
| Sent when an action item starts executing. | |
| constexpr NotifyCode | NOTIFY_ACTION_ITEM_EXECUTION_ENDED = 0x000000F8 |
| Sent when an action item finished executing. | |
| constexpr NotifyCode | NOTIFY_INTERACTIVE_PLUGIN_INSTANCE_CREATION_STARTED = 0x000000F9 |
| Sent when the user starts creating a plug-in instance. | |
| constexpr NotifyCode | NOTIFY_INTERACTIVE_PLUGIN_INSTANCE_CREATION_ENDED = 0x000000FA |
| Sent when the user ends creating a plug-in instance. | |
| constexpr NotifyCode | NOTIFY_PRE_VIEWPORT_TOOLTIP = 0x000000FD |
| Sent before viewport tooltip pops. NotifyInfo::callParam is a INode* to the tip node. | |
| constexpr NotifyCode | NOTIFY_FILE_POST_MERGE3 = 0x0000010B |
| Sent after a file is merged. | |
| constexpr NotifyCode | NOTIFY_ACTIVESHADE_IN_FRAMEBUFFER_TOGGLED = 0x0000010C |
| Sent when ActiveShade in the frame buffer is toggled on/off. | |
| constexpr NotifyCode | NOTIFY_PRE_ACTIVESHADE_IN_VIEWPORT_TOGGLED = 0x0000010D |
| Sent before ActiveShade in the viewport is toggled on/off. | |
| constexpr NotifyCode | NOTIFY_POST_ACTIVESHADE_IN_VIEWPORT_TOGGLED = 0x0000010E |
| Sent after ActiveShade in the viewport is toggled on/off. | |
| constexpr NotifyCode | NOTIFY_COLOR_MANAGEMENT_POST_CHANGE = 0x00000110 |
| Sent after the system color management settings are changed, this includes mode changes, system-wide gamma setting or changes to color config. | |
| constexpr NotifyCode | NOTIFY_COLOR_MANAGEMENT_POST_CHANGE2 = 0x00000111 |
| Sent right after the NOTIFY_COLOR_MANAGEMENT_POST_CHANGE notification, signaling that all entities listening to the NOTIFY_COLOR_MANAGEMENT_POST_CHANGE notification has finished responding to it. | |
| constexpr NotifyCode | NOTIFY_CUI_REGISTER_QUAD_MENUS = 0x00000112 |
| NotifyInfo::callParam is a pointer to the ICuiQuadMenuManager loading the menu structure. | |
| constexpr NotifyCode | NOTIFY_CUI_MENUS_PRE_LOAD = 0x00000117 |
| : Sent before menu structure is loaded NotifyInfo::callParam is a string (MCHAR*) containing the path of the file that will be loaded | |
| constexpr NotifyCode | NOTIFY_CUI_QUAD_MENUS_PRE_LOAD = 0x00000118 |
| : Sent befoe quadmenu structure is loaded NotifyInfo::callParam is a string (MCHAR*) containing the path of the file that will be loaded | |
| constexpr NotifyCode | NOTIFY_CUI_QUAD_MENUS_POST_LOAD = 0x00000119 |
| : Sent after quadmenu structure is loaded NotifyInfo::callParam is a string (MCHAR*) containing the path of the file that has been loaded | |
| constexpr NotifyCode | NOTIFY_CUI_REGISTER_MENUS = 0x00000120 |
| Sent when the standard menu structure is loaded. | |
Scene State Notifications | |
All the SceneState notifications have NotifyInfo::callParam as a const MCHAR* with the SceneState name except for NOTIFY_SCENESTATE_RENAME | |
| constexpr NotifyCode | NOTIFY_SCENESTATE_PRE_SAVE = 0x0000009F |
| Sent before a Scene State is saved. | |
| constexpr NotifyCode | NOTIFY_SCENESTATE_POST_SAVE = 0x000000A0 |
| Sent after a Scene State is saved. | |
| constexpr NotifyCode | NOTIFY_SCENESTATE_PRE_RESTORE = 0x000000A1 |
| Sent before a Scene State is restored. | |
| constexpr NotifyCode | NOTIFY_SCENESTATE_POST_RESTORE = 0x000000A2 |
| Sent after a Scene State is restored. | |
| constexpr NotifyCode | NOTIFY_SCENESTATE_DELETE = 0x000000A3 |
| Sent after a Scene State is deleted. | |
| constexpr NotifyCode | NOTIFY_SCENESTATE_RENAME = 0x000000A4 |
| Sent after a Scene State is renamed. | |
File I/O Notifications | |
All contain NotifyInfo::callParam that points to a NotifyFileProcessParam. | |
| constexpr NotifyCode | NOTIFY_FILE_PRE_OPEN_PROCESS = 0x000000AD |
| constexpr NotifyCode | NOTIFY_FILE_POST_OPEN_PROCESS = 0x0000008B |
| constexpr NotifyCode | NOTIFY_FILE_PRE_SAVE_PROCESS = 0x000000AE |
| constexpr NotifyCode | NOTIFY_FILE_POST_SAVE_PROCESS = 0x000000AF |
Named Selection Sets Notifications. | |
The following notifications will be broadcast whenever any operation has been done to a named selection set.
Sent when a Named selection set is created either in the UI, or via maxscript. | |
| constexpr NotifyCode | NOTIFY_NAMED_SEL_SET_CREATED = 0x000000B8 |
| NotifyInfo::callParam is a pointer to a string (const MCHAR*) of the name of the created named set. | |
| constexpr NotifyCode | NOTIFY_NAMED_SEL_SET_DELETED = 0x000000B9 |
| Sent when a Named selection set is deleted either in the UI, or via maxscript. | |
| constexpr NotifyCode | NOTIFY_NAMED_SEL_SET_RENAMED = 0x000000BC |
| Sent when a Named selection set name is changed, either in the old UI, or via maxscript. | |
| constexpr NotifyCode | NOTIFY_NAMED_SEL_SET_PRE_MODIFY = 0x000000CA |
| The following notification will be sent when the node set of a named selection set begins to be changed. | |
| constexpr NotifyCode | NOTIFY_NAMED_SEL_SET_POST_MODIFY = 0x000000CB |
| The following notification will be sent when the node set of a named selection set has been changed. | |
Node Property Change Notifications | |
NotifyInfo::callParam is a pointer to the list of nodes (INodeTab*) that is about to change or has changed. | |
| constexpr NotifyCode | NOTIFY_PRE_NODE_GENERAL_PROP_CHANGED = 0x00000075 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_POST_NODE_GENERAL_PROP_CHANGED = 0x00000076 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_PRE_NODE_GI_PROP_CHANGED = 0x00000077 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_POST_NODE_GI_PROP_CHANGED = 0x00000078 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_PRE_NODE_MENTALRAY_PROP_CHANGED = 0x00000079 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_POST_NODE_MENTALRAY_PROP_CHANGED = 0x00000080 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_PRE_NODE_BONE_PROP_CHANGED = 0x00000081 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_POST_NODE_BONE_PROP_CHANGED = 0x00000082 |
| Sent after an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_PRE_NODE_USER_PROP_CHANGED = 0x00000083 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_POST_NODE_USER_PROP_CHANGED = 0x00000084 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_PRE_NODE_RENDER_PROP_CHANGED = 0x000000C4 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_POST_NODE_RENDER_PROP_CHANGED = 0x000000C5 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_PRE_NODE_DISPLAY_PROP_CHANGED = 0x000000C6 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_POST_NODE_DISPLAY_PROP_CHANGED = 0x000000C7 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_PRE_NODE_BASIC_PROP_CHANGED = 0x000000C8 |
| Sent before an INode's bone property is changed. | |
| constexpr NotifyCode | NOTIFY_POST_NODE_BASIC_PROP_CHANGED = 0x000000C9 |
| Sent before an INode's bone property is changed. | |
Custom Attributes Notifications | |
These notifications are sent after a custom attribute is added or removed from a custom attribute container.
| |
| constexpr NotifyCode | NOTIFY_CUSTOM_ATTRIBUTES_ADDED = 0x000000D5 |
| Sent after a custom attribute is added to an Animatable. | |
| constexpr NotifyCode | NOTIFY_CUSTOM_ATTRIBUTES_REMOVED = 0x000000D6 |
| Sent after a custom attribute is removed from an Animatable. | |
Material Library File Notifications | |
| #define | NOTIFY_MATLIB_PRE_OPEN 0x00000024 |
| Sent before loading a material library. | |
| #define | NOTIFY_MATLIB_PRE_SAVE 0x00000026 |
| Sent before saving a material library. | |
| #define | NOTIFY_MATLIB_POST_SAVE 0x00000027 |
| Sent after saving a material library. | |
| #define | NOTIFY_MATLIB_PRE_MERGE 0x00000028 |
| Sent before merging a material library. | |
| #define | NOTIFY_MATLIB_POST_MERGE 0x00000029 |
| Sent after merging a material library. | |
| constexpr NotifyCode | NOTIFY_MATLIB_POST_OPEN = 0x00000025 |
| Sent after loading a material library. | |
XRef System Notifications | |
These notices typically surround Merge notices | |
| #define | NOTIFY_SCENE_XREF_PRE_MERGE 0x00000065 |
| Sent before an XRef scene is merged. | |
| #define | NOTIFY_OBJECT_XREF_PRE_MERGE 0x00000067 |
| Sent before an XRef object is merged. | |
| #define | NOTIFY_OBJECT_XREF_POST_MERGE 0x00000068 |
| Sent after an XRef object is successfully merged. | |
| constexpr NotifyCode | NOTIFY_SCENE_XREF_POST_MERGE = 0x00000066 |
| Sent after an XRef scene is successfully merged (NotifyInfo::callParam is a INode* pointer to the scene XRef tree). | |
Undo/Redo Notifications | |
| #define | NOTIFY_SCENE_POST_UNDO NOTIFY_SCENE_UNDO |
| Sent to make the previous undo notification more explicit, and match the PRE_UNDO. | |
| #define | NOTIFY_SCENE_POST_REDO NOTIFY_SCENE_REDO |
| Sent to make the previous undo notification more explicit, and match the PRE_UNDO. | |
| constexpr NotifyCode | NOTIFY_SCENE_PRE_UNDO = 0x000000A5 |
| Sent before an Undo starts. | |
| constexpr NotifyCode | NOTIFY_SCENE_PRE_REDO = 0x000000A6 |
| Sent before a Redo starts. | |
| using NOTIFYPROC = void (*)(void* param, NotifyInfo* info) |
| CoreExport int RegisterNotification | ( | NOTIFYPROC | proc, |
| void * | param, | ||
| NotifyCode | code ) |
| proc | The callback function called when the event occurs |
| param | A pointer to a parameter which will be passed to the callback function |
| code | Specifies which notification to register. See System Notification Codes. |
| CoreExport int UnRegisterNotification | ( | NOTIFYPROC | proc, |
| void * | param, | ||
| NotifyCode | code ) |
| proc | The callback function called when the event occurs. |
| param | This parameter must be identical to the param sent into RegisterNotification(). This function will only unregister a callback if this parameter equals the param sent in to the RegisterNotification() function. |
| code | Specifies which notification to unregister. See System Notification Codes |
| CoreExport int UnRegisterNotification | ( | NOTIFYPROC | proc, |
| void * | param ) |
| proc | The callback function called when the event occurs. |
| param | A pointer to a parameter which will be passed to the callback function. |
| CoreExport void BroadcastNotification | ( | NotifyCode | code | ) |
It is not recommended to use this function directly.
Consider using the templated version of this function for improved type safety
| code | Specifies which notification to broadcast. See System Notification Codes |
| CoreExport void BroadcastNotification | ( | NotifyCode | code, |
| void * | callParam ) |
It is not recommended to use this function directly.
Consider using the templated version of this function for improved type safety
| code | Specifies which notification to broadcast. See System Notification Codes |
| callParam | This parameter is passed to the callback. |
|
inline |
| code | Specifies which notification to broadcast. See System Notification Codes |
|
inline |
| callParam | This parameter is passed to the callback. |
1.14.0