mvGetTrackLayer(3dm)

NAME
     mvGetTrackLayer, mvSetTrackLayer - set/get the layer of a track


SYNOPSIS
     #include <dmedia/moviefile.h>

     DMstatus mvSetTrackLayer( MVid track, int layer );
     int mvGetTrackLayer( MVid track );


DESCRIPTION
     The ``layer'' value (a signed integer) of a track determines its
     rendering order with respect to other tracks.  For visual tracks (e.g.
     image tracks), tracks with smaller (ie, more negative) ``layer'' value
     are rendered on top of (possibly obscuring) tracks with bigger (ie, more
     positive) ``layer'' value.  For aural tracks (e.g. audio tracks), this
     value is ignored during rendering.


     If a there is more than one track in a single layer, the tracks are
     rendered in an order determined by the track index (see
     mvFindTrackByIndex(3dm)).  When new tracks are created, by default, they
     are assigned to layer 0.

     mvSetTrackLayer sets the layer value of the track to be layer.

     mvGetTrackLayer returns the layer value of the track.


SEE ALSO
     mvRenderToOpenGL(3dm).