Contents
Navigation
Home User Reference Other Resources


Sprites were introducted in QuickTime 2.5 and have since been enhanced in later versions of QuickTime.

The metaphor of a sprite animation as a theatrical play is used, in which sprite tracks are characterized as the boundaries of the stage and a sprite world or a as the stage itself. To extend the metaphor, you may want to think of sprites as actors performing on that stage.

Each sprite has that describe its location and appearance at a given time. During an animation sequence, modifying the sprite’s properties causes it to change its appearance and move around the screen. Sprites may be mixed with still–image graphics to produce a wide variety of effects while using relatively little memory.

The QTPlugin provides the developers with the Sprite Framework to add sprite–based animation to their applications. The Sprite Framework, which is a set of classes, handles all the tasks necessary to compose and modify sprites, their backgrounds and properties, in addition to transferring the results to the screen or to an alternate destination.

The QTPlgNewSpriteTrack class is part of the Sprite Framework and lets you add a sprite track to a .







The QTPlgNewSpriteTrack class constructors are called when you create a new instance of the class, while the ˜QTPlgNewSpriteTrack class destructor, is called automatically when the class is no more in use. Also, you can invoke the class destructor by setting the instance of the class to nil.

Once a new class instance is returned, it is good practice to check the class property to be sure that the new object can be used. See the validity conditions for more details.


The class provides you with the following initializer methods:
(m as , params as , bounds as , [timeScale as integer])
use this constructor to create a sprite track and add it to the movie specified by the m; if the movie specified has been created in memory (see the of the class), the sprite samples added to the track reside in memory as well. You specify the characteristics of the sprite samples to be added to the track by setting the of the params object as appropriate. You specify the sprite track bounds by using the bounds parameter; if you set this parameter to nil, the track bounds are set to the , if applicable; if any temptative to assign valid bounds to the track fail, the resulting class instance will be . Finally, you can specify the desired time scale by setting the optional parameter timeScale; omitting to set this parameter will cause the default value of 600 to be used

(data as , duration as integer)
use this function to add sprite media samples (specified by the data parameter) to the track. The type of sprites contained into the data parameter is determined by the type of object; if you pass a class instance then the sprites will be considered key frame samples. To add ovverride sprite samples, pass a class instance instead
returns nothing. Check the class property for errors