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
(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