Contents
Navigation
Home User Reference Other Resources


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.
returns nothing. Check the class property for errors
(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
returns nothing. Check the class property for errors
(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)
returns nothing. Check the class property for errors