The QTPlgEffectDialog class provides QTPlugin developers with a simple interface to manage the effects parameters and access to the standard parameters dialog box. Provided that the requirements are met, this class features the class method as well.
Also, the class property provides you with
a simple mechanism to test the selected configuration with your own images.
The class allows you to store the effect parameters you have set into files and restore them later.
→
The QTPlgEffectDialog class constructors are called when you create a new instance of the class, while the ˜QTPlgEffectDialog 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. A QTPlgEffectDialog object is valid if it has been allocated a valid container (a class instance) to store the effect settings choosen; you can control this by examining the class property
The class provides you with the following initializer methods:
()
This is the default constructor. The list of effects is set to an empty list and the
and
class properties are both initialized to
–1;
you can use the overloaded versions of the
class method to setup the list of
the currently installed effects components. This list will be displayed into the standard parameters dialog box
(other as QTPlgEffectDialog)
This is the copy constructor. The properties of the object to be copied will be used to initialize the
new class instance properties
(fSettings as folderitem)
you can use this version of the class constructor to initialize the properties of the class with the settings
in the file
specified by the fSettings
specifies the active effect settings
indicates the minimum number of sources that an effect must have to be added to the list. If this property is set to
–1, no minimum has been specified. You can specify the minimum number of sources by using the
appropriate overloaded versions of the
class method
[Deprecated]: since version 6.5 of the plugin this property is deprecated
and will be removed from a future plugin version; use the
class property instead
indicates the maximum number of sources that an effect must have to be added to the list. If this property is set to
–1, no maximum has been specified. You can specify the minimum number of sources by using the
appropriate overloaded versions of the
class method
[Deprecated]: since version 6.5 of the plugin this property is deprecated
and will be removed from a future plugin version; use the
class property instead
indicates the minimum and maximum number of sources that an effect must have to be added to the list.
To include every effects component into the list simply set to –1 both the
and the
properties. The range specified will be used by the
class method. Alternatively,
you can specify the minimum and maximum number of sources by using the
appropriate overloaded versions of the class method.
Though the suggested approach is to set the range of requested effect sources and, then, call the
class method
use this property to change the images that are used in the preview window of the standard parameters dialog box.
QuickTime provides default images but you may wish, for example, to use thumbnail images taken from your application instead.
The i ranges from 0 to 1
returns a data presentation context appropriate to the current
. If the
and
values of the
property are not set to some valid value before
requesting the data presentation context, the class
instance will use the default value of 128 for both
and
(minSources as integer, maxSources as integer)
use this method to create a list of the currently installed effects components. You can specify both the minimum
and maximum number of sources that an effect must have to be added to the list by using the minSources and
maxSources parameters. To include every effects component into the list simply set to –1 both
these parameters
()
use this method to create a list of the currently installed effects components. You can specify both the minimum
and maximum number of sources that an effect must have to be added to the list by using the
class property
(effectComponent as
)
use this method to display the parameters dialog for the component specified by the effectComponent only
you can obtain a list of all of the currently installed effects components by creating a new instance of the
class passing to the
constructor the appropriate