The QTPlgNewEffectTrack class lets you add effects track to a movie.
→
The QTPlgNewEffectTrack class constructors are called when you create a new instance of the class, while the ˜QTPlgNewEffectTrack 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 ,
[timeScale as integer])
use this constructor to create a new effect 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 effect sample added to the track reside in memory as well. You specify the effect type, its configuration, and the
video characteristics of the effect sample to be added by setting the
of the
params object as appropriate. If the
and
properties of the
params object do not define a valid track bounds, they are initialized using the
, if
applicable; if this temptative fails as well, 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
(timeRange as
)
you can use this method with effects that don’t require a source, such as the fire or cloud effect; you can add
such a effects anywhere in a movie. Just use the
of the
timeRange object to set the offset and duration of the effects track to the part
of the movie where you want the effect to appear. If there is already an active video track at that point
in the movie, you control the interaction between the video track and the effects track in the usual ways:
putting one track in front of the other (changing the
property),
using an alpha channel to allow one track to be partly visible through the other (working with the
and
media
properties), and so on.
(source as ,
timeRange as
)
you can use this method with effects that require a source, such as a blur filter; such a effects steal the output of
the track specified by the source parameter by using an input map.
The source ’s output is sent to the effects track, and the effect component acts as a special
kind of codec to convert the video into the desired effect.
If you want to apply a filter effect to the whole source track, pass nil into the
timeRange parameter. If you want to apply a filter effect to part of the
source track, set the
and
properties of the
timeRange object as appropriate. The new effects track is put in front of
the source track
(source1 as ,
source2 as ,
duration as integer)
you can use this method with effects that requires two sources, such as a wipe transition; such a effects require
some forethought when setting up the source tracks but the plugin will do the job for you. Simply choose the
source tracks by using the source1 and source2 parameters and specify the
duration of the effects track by the duration parameter; the transition will be applied
between the frames of the source2 track that overlap those at the end of the
source1 track by the duration of the transition (that is the value of the
duration parameter)