This is the callback object used to perform the [de]selection via Animatable:: SvGetMultiSelectCallback().
Schematic view supports multiple selection. When the user selects a set of objects in the schematic view and then "transfers" that selection set to the rest of max (either by having "synchronize selection" on or by manually moving the selection out), there are a number of ambiguities that can arise. For example, some of the objects in the schematic view cannot be selected in the viewports, material editor, or modifier stack. Another example: the material editor only supports one active material/map but many materials and maps can be selected simultaneously in the schematic view. The "MultiSelectCallback" system exists order to handle these cases and to handle selection synchronization between SV and future editors in 3ds Max. When the schematic view attempts to synchronize selection by moving the SV selection set to the "outside" world, it follows this procedure:
- First SV calls SvGetMultiSelectCallback() on all the visible SV nodes to "collect" MultiSelectCallback objects. Objects that want to synchronize their selection state with the schematic view (not a common or trivial operation – this is really more associated with adding a new editor in 3ds Max rather than adding new plug-in) return a pointer to a static instance of a MultiSelectCallback derived object. There is only one instance of a MultiSelectCallback per editor. Furthermore, if an editor displays objects of many classes, all the classes should override SvGetMultiSelectCallback() to return the same MultiSelectCallback instance. This implies that, as far as the schematic view is concerned, there is never more than one primary editor class associated with any particular object class (currently, viewports for nodes, material editor for materials and maps and the modifier panel for modifiers). For example, here is the code in BaseNode that returns the MultiSelectCallback instance for nodes (this is the MultiSelectCallback used for viewports):
{
private:
bool clear;
BaseNodeTab selNodeTab;
BaseNodeTab deselNodeTab;
};
static BaseNodeMSelCB baseNodeMSelCB;
{
return &baseNodeMSelCB;
}
- For each selection class (unique MultiSelectCallback instance), the schematic views calls "Begin()". This is the spot where any "pre-selection" preparation takes place. The order that the MultiSelectCallback instances are called in is determined by their priority. The priority is returned by the "Priority()" method. MultiSelectCallback's with a higher priority (lower value) are called before those with a lower priority (higher value). For example, here is the Begin associated with the viewports:
{
this->clear = clear;
if (clear)
GetActiveSelSet()->Clear(FALSE);
selNodeTab.Resize(0);
deselNodeTab.Resize(0);
}
- For each of objects in the schematic view whose selection state is changing, the object's MultiSelectCallback instance is retrieved (again) and the "Select" method is called. Here is where the actual selection/de-selection work can take place. I say "can" because, in practice, the select method usually just collects all the objects to be selected and all the objects to be deselected into lists which are then processed in the "End()" method. This is simply for performance – it is often more efficient to set the selection state of a group of objects all at once. Here's the "Select()" method from BaseNode:
{
BaseNode *baseNode = (BaseNode *) gNode->
GetAnim();
if (isSelected) {
if (!baseNode->IsRootNode() && !baseNode->IsFrozen()
&& !baseNode->IsHidden())
selNodeTab.AppendNode(baseNode, FALSE);
}
else {
if (baseNode->Selected())
deselNodeTab.AppendNode(baseNode, FALSE);
}
}
- Finally, for each selection class (unique MultiSelectCallback instance), the schematic views calls "End()". This is the spot where any "post-selection" operations take place. For example, here is the "End()" for the BaseNode (viewports):
{
if (selNodeTab.Count() > 0 || deselNodeTab.Count() > 0) {
if (selNodeTab.Count() > 0)
GetActiveSelSet()->SelectMultiple(selNodeTab, FALSE);
if (deselNodeTab.Count() > 0)
GetActiveSelSet()->DeselectMultiple(deselNodeTab, FALSE);
theHold.Accept(getResMgr().getString(IDS_SV_SELECT, appInst));
}
else {
if (clear)
}
}
- See also
- Animatable
|
| static UtilExport void * | operator new (size_t size) |
| | Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown. More...
|
| |
| static UtilExport void * | operator new (size_t size, const std::nothrow_t &e) |
| | Standard new operator used to allocate objects if there is insufficient memory, NULL will be returned. More...
|
| |
| static UtilExport void * | operator new (size_t size, const char *filename, int line) |
| | New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More...
|
| |
| static UtilExport void * | operator new (size_t size, int block_type, const char *filename, int line) |
| | New operator used to allocate objects that takes the type of memory, filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More...
|
| |
| static UtilExport void * | operator new (size_t size, const std::nothrow_t &e, const char *filename, int line) |
| | New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, NULL will be returned. More...
|
| |
| static UtilExport void * | operator new (size_t size, unsigned long flags) |
| | New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, an exception will be thrown. More...
|
| |
| static UtilExport void * | operator new (size_t size, const std::nothrow_t &e, unsigned long flags) |
| | New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, NULL will be returned. More...
|
| |
| static UtilExport void * | operator new[] (size_t size) |
| | New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
|
| |
| static UtilExport void * | operator new[] (size_t size, const std::nothrow_t &e) |
| | New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
|
| |
| static UtilExport void * | operator new[] (size_t size, const char *filename, int line) |
| | New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
|
| |
| static UtilExport void * | operator new[] (size_t size, int block_type, const char *filename, int line) |
| | New operator used to allocate arrays of objects. More...
|
| |
| static UtilExport void * | operator new[] (size_t size, const std::nothrow_t &e, const char *filename, int line) |
| | New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
|
| |
| static UtilExport void * | operator new[] (size_t size, unsigned long flags) |
| | New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
|
| |
| static UtilExport void * | operator new[] (size_t size, const std::nothrow_t &e, unsigned long flags) |
| | New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
|
| |
| static UtilExport void | operator delete (void *ptr) |
| | Standard delete operator used to deallocate an object If the pointer is invalid, an exception will be thrown. More...
|
| |
| static UtilExport void | operator delete (void *ptr, const std::nothrow_t &e) |
| | Standard delete operator used to deallocate an object If the pointer is invalid, nothing will happen. More...
|
| |
| static UtilExport void | operator delete (void *ptr, const char *filename, int line) |
| | Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
|
| |
| static UtilExport void | operator delete (void *ptr, int block_type, const char *filename, int line) |
| | Delete operator used to deallocate an object that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
|
| |
| static UtilExport void | operator delete (void *ptr, const std::nothrow_t &e, const char *filename, int line) |
| | Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More...
|
| |
| static UtilExport void | operator delete (void *ptr, unsigned long flags) |
| | Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
|
| |
| static UtilExport void | operator delete (void *ptr, const std::nothrow_t &e, unsigned long flags) |
| | Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, nothing will happen. More...
|
| |
| static UtilExport void | operator delete[] (void *ptr) |
| | Standard delete operator used to deallocate an array of objects If the pointer is invalid, an exception will be thrown. More...
|
| |
| static UtilExport void | operator delete[] (void *ptr, const std::nothrow_t &e) |
| | Standard delete operator used to deallocate an array of objects If the pointer is invalid, nothing will happen. More...
|
| |
| static UtilExport void | operator delete[] (void *ptr, const char *filename, int line) |
| | Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
|
| |
| static UtilExport void | operator delete[] (void *ptr, int block_type, const char *filename, int line) |
| | Delete operator used to deallocate an array of objects that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
|
| |
| static UtilExport void | operator delete[] (void *ptr, const std::nothrow_t &e, const char *filename, int line) |
| | Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More...
|
| |
| static UtilExport void | operator delete[] (void *ptr, unsigned long flags) |
| | Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
|
| |
| static UtilExport void | operator delete[] (void *ptr, const std::nothrow_t &e, unsigned long flags) |
| | Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
|
| |
| static UtilExport void * | operator new (size_t size, void *placement_ptr) |
| | Placement new operator. More...
|
| |
| static UtilExport void | operator delete (void *ptr, void *placement_ptr) |
| | Placement delete operator. More...
|
| |
| static UtilExport void * | aligned_malloc (size_t size, size_t alignment) |
| | Allocates memory on a specified alignment boundary. More...
|
| |
| static UtilExport void * | aligned_realloc (void *ptr, size_t size, size_t alignment) |
| | Reallocates memory on a specified alignment boundary. More...
|
| |
| static UtilExport void | aligned_free (void *ptr) |
| | Frees a block of memory that was allocated with aligned_malloc/aligned_realloc. More...
|
| |
Inheritance diagram for MultiSelectCallback: