Contents
Navigation
Home User Reference Other Resources


The QTPlgNewTextTrack class lets you add text tracks to a movie.







The QTPlgNewTextTrack class constructors are called when you create a new instance of the class, while the ˜QTPlgNewTextTrack 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 , trackBox as , [timeScale as integer])
use this constructor to create a new text 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 text samples added to the track reside in memory as well. You specify the characteristics of the text samples to be added to the track by setting the of the params object as appropriate. You specify the text track bounds by using the trackBox 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 . Furthermore, you can specify the preferred time scale by using the optional timeScale parameter; if you omit this parameter a default time scale of 600 will be used

establishes the color for highlighting text. This color will be used if the hilite parameter of the class method is set to true
specifies the duration of a single sample expressed in media’s time scale (the time scale is always set to 600). You can change this value during an editing session as well
allows you to specify a target track that must be associated to the text track; if this property is set to a valid value, then the text track becomes a chapter track

(params as )
use this method to modify the characteristics of the samples text to be added to the track. You can use this method during an editing session as well
returns nothing. Check the class property for errors
(sample as string, hilite as boolean, [nTimes as integer=1])
use this function to add text (specified by the sample parameter) to the track; the text will be stored using the MacRoman encoding scheme. The characteristics of the sample text are determined by the properties of the you have passed to the or you have modified by using the class method; you can change the sample properties by calling such a method just before adding a new sample. Use the hilite parameter to determine if the added text sample must be hilited as well; if this parameter is set to true, the text sample will be hilighted with the color specified by the class property. Finally, the optional nTimes parameter specifies how many samples of this type must be added to the media
returns nothing. Check the class property for errors