The QTPlgExportMovie class provides QTPlugin developers with a simple interface to access the services provided by the QuickTime’s movie exporter components. This components allows you to export data to non–movie formats; for example, you can save a QuickTime movie’s sound track as an AIFF file, using the component appropriate to this operation. The class uses the Component Manager to open and close a connection to the component; QTPlugin developers do not worry about it, cause the QTPlgExportMovie takes care about the details of opening and closing a connection to the exporter component selected.
You can use the class to obtain export parameters from the user (or set them by yourself) and to manage the process of exporting the image. You can follow several ways to control the different steps involved into the exporting process.
The simplest way is to use the standard export dialog box. The dialog box presents a consistent interface to the user; the QTPlgExportMovie eliminates the need for you to worry about the details of managing this dialog box. Once you have collected the parameter information from the user, you can use the class to instruct the component to export the selected movie or track. Again, the class manages the details for you.
Alternatively, you can use the properties the class provides you with to examine or modify the parameters to be used during the export. This way allows you to perform the process of exporting the image without using any user interface. Though, as the configuration of exporter components is, usually, a complex task involving to deal with a great number of parameters, the settings you can programmatically change are far from to be complete; so your first choice should be to display a dialog for the user to configure movie exporter settings, if applicable
Anyway, whatever way you follow, the class allows you to store the compression parameters you have set into files and restore them later.
→
The QTPlgExportMovie class constructors are called when you create a new instance of the class, while the ˜QTPlgExportMovie 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 requirements for more details.
The class provides you with the following initializer methods:
()
This is the default constructor. The new class instance will try to open a connection
to the AVI movie exporter; if the connection succeeds, the properties of the class will
be initialized to the default settings of this component
(other as QTPlgExportMovie)
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)
The new class instance will try to open a connection
to the movie exporter registered into the file settings specified by the
fSettings parameter; if the connection succeeds, 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 parameter
(exporterID as string)
The new class instance will try to open a connection to the movie exporter defined by the exporterID parameter;
this parameter is a four char ASCII code that identifies the
of the movie exporter you want to
connect to. As a convenience, the class defines the
of some of the most common
movie exporters provided by QuickTime.
If the connection succeeds, the properties of the class will be initialized to the default settings of the selected movie exporter
(component as )
The new class instance will try to open a connection to the movie exporter specified by the component parameter;
you can obtain a list of all of the currently installed movie exporters by creating a new instance of the
class passing to the
constructor the appropriate
.
If the connection succeeds, the properties of the class will be initialized to the default settings of the selected movie exporter
specifies the target movie for the export operation
specifies the current video settings that will be applied when exporting video data
specifies the current sound settings that will be applied when exporting audio data
specifies if the fastForInternet property of the selected exporter component will be enabled. Note that not all of the
exporter components feature this property
(source as ,
tmSel as ,
dst as folderitem)
you can use this method to convert the data coming from the source specified by the source parameter and
store it into the file specified by the dst parameter. If the destination file already exists, it will be overwritten
by the new one. The data source can be either a
or a
class instance
You can specify to convert either the entire movie or track or just a movie or track segment by setting thetmSel parameter as appropriate; setting this parameter to nil indicates that you want to
export the entire movie or track source. The values of the tmSel object
must be expressed in
movie’s time scale
You can specify to convert either the entire movie or track or just a movie or track segment by setting the
specifies the quicktime avi exporter component subtype implemented by APPLE
specifies the quicktime mpg4 exporter component subtype
specifies the quicktime aiff exporter component subtype
specifies the quicktime aifc exporter component subtype
specifies the quicktime wave exporter component subtype