Track View Nodes

You can access and modify controllers in the Global Tracks and Video Post sections in Track View, and create new named global tracks. Among other things, these can be used to provide keyframeable parameters in your scripted utilities.

There are also methods associated with the Track View window. These methods are described in Track View.

MAXTVNode : Value is the class whose instances represent track view global track nodes. Each MAXTVNode can contain any number of MAXTVNodes or animation controllers. The MAXTVNodes and controllers within a MAXTVNode are shown as properties of the MAXTVNode, so you can navigate through the nesting using property access. A MAXTVNode does not store animation data, but rather acts as a container that can store one or more MAXTVNode or animation controller.

There are three track view nodes that you can access through global variables: the root node to which you can add new custom tracks, the existing Global Tracks node which provides access to the global track controllers, and the Video Post tracks node which provides access to any video post controllers. These nodes are also accessible as properties on the root node.

Constructor

trackViewNodes 

Global variable containing the top-level World or root node in Track View. This variable is read-only.

globalTracks 

Global variable containing the top-level Global Tracks node in Track View. This variable is read-only.

videoPostTracks 

Global variable containing the top-level Video Post Track View node. This variable is read-only.

newTrackViewNode [ <maxtvnode> ] <name_string> [#hidden] 

If the <maxtvnode> argument is supplied, adds a sub-track node to it. If not, creates a new 'top-level' track in the Track View. If the optional #hidden flag is supplied, the node is not visible in the Track View.

Properties

<maxtvnode>.name String 

The track view node name as it appears in Track View.

The sub-tracks and sub-controllers for a track view node are also shown as properties of the track view node. For example, the additional default properties for global trackViewNodes are:

TrackViewNodes.Global_Tracks MAXTVNode 
TrackViewNodes.Video_Post MAXTVNode 

The additional default properties for global globalTracks are:

GlobalTracks.float float_list controller 
GlobalTracks.point3 point3_list controller 
GlobalTracks.position position_list controller 
GlobalTracks.rotation rotation_list controller 
GlobalTracks.scale scale_list controller 
GlobalTracks.Block_Control block_control controller 

Methods

deleteTrackViewNode [ <parent_maxtvnode> ] <maxtvnode> 

Deletes the given node from the supplied parent or the top-level if the parent is not specified.

addTrackViewController <maxtvnode> <controller> <name> 

Adds the sub-controller to the given Track View node.

deleteTrackViewController <maxtvnode> <controller> 

Deletes the controller from the given Track View node.

EXAMPLES

   -- access a video post track
   videoPostTracks.glow.size = 5
   -- set up some visible tracks for some keyframeable parameters in a rollout panel
   my_tracks = newTrackViewNode "Grinner"
   happy_ctrl = bezier_position ()
   addTrackViewController my_tracks happy_ctrl "Happy"
   ...
   -- plant keyframes in rollout spinner handler if the animate button is on
   rollout grinner ...
   (
   ...
   on happy changed val do
   (
   ...
   happy_ctrl.value = [x, y, z]
   ...
   )
   ...
   )
   -- add a new float controller to the global tracks float controller list
   globalTracks.float.controller.available.controller = bezier_float ()