Schematic View API
 
 
 

There currently are three interfaces into the schematic view objects. IGraphObjectManager, IGraphNode, and IGraphRef. IGraphObjectManager represents an instance of a schematic view window and provides methods for adding nodes and node pointers, refreshing the schematic view, accessing filter bits and updating and controlling the various editors within 3ds Max in ways that are not surfaced in the general interface. IGraphNode represents a node in the schematic view graph and provides a few methods for querying information about the node. Finally, IGraphRef represents a node pointer and, currently, has no methods. Each of these three interfaces is described in greater detail below.

In addition to the three schematic view interfaces, there is a set of methods in Animatable that can be overridden, all or in part, to specialize the behavior of the schematic view nodes which represents the Animatable object. Most of these methods are appropriately implemented for the various abstract base classes from which plug-in developers derive their classes. In most cases, there is no need for the plug-in developer to override any of these methods. All of the schematic view Animatable methods are prefixed by Sv. In addition to the "Sv" methods, there are a half dozen or so "Sv" prefixed functions in Animatable which are called to perform various schematic view related tasks. They are implemented in Animatable instead of IGraphNode because they are more closely associated with the Animatable than with the graph node or because they are called in places where the IGraphNode and IGraphObjectManager interfaces are not available.

Taken as a whole, the three interfaces (IGraphObjectManager, IGraphNode, and IGraphRef) along with the "Sv" Animatable methods and functions represent the majority of the complete schematic view API.

In general, the IGraphObjectManager, IGraphNode, and IGraphRef interfaces are not accessible to plug-ins outside of the scope of the Animatable "Sv" methods and should not be cached by the plug-in.