Contents
Navigation
Home User Reference Other Resources


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
returns nothing. Check the class property for errors
()
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
returns nothing. Check the class property for errors
dlgBuildList(effectComponent as QTPlgComponent)
(effectComponent as )
use this method to display the parameters dialog for the component specified by the effectComponent only
returns nothing. Check the class property for errors
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