This is an utility class that allows you to set up the parameters of a record session performed by instances of the class.
The QTPlgRecordContext class constructors are called when you create a new instance of the class, while the ˜QTPlgRecordContext 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 QTPlgRecordContext object is valid if the property is set with a valid instance of the class. As, when creating an instance of this class by using the , neither the is set to nil, then the class property will be false; in this case, it is lecit to continue to use the class. Though, the instance should be valid when used to set up the record session parameters of class instances.
The class provides you with the following initializer methods:
()
The default constructor. The class properties are initialized in the following way:
0 | |
0.0 | |
false | |
true | |
false | |
false | |
nil |
(other as QTPlgRecordContext)
This is the copy constructor. The properties of the object to be copied will be used to initialize the
new class instance properties
limits the duration, expressed in seconds, of a record operation. By default, there is no time limit on a record operation.
If you do not set a limit, a record operation will run until it exhausts the Operating System resources or you
stop the record. Memory and disk space are the two major limiting factors
specifies the maximum offset, expressed in kilobytes, for data written to a specified file during an acquisition of data
specifies if the recorded data will be stored in memory until the recording process is complete. Then, the recorded data
will be written to the location specified by the
property. Also, setting this property to
true prevents the sequence grabber component from using temporary memory during the record operation.
This technique provides better performance than recording directly to the disk, but it limits
the amount of data you can record. This property and the
property are mutually exclusive
specifies if the recorded video must be written to a movie file on disk; if this property is set to
true the data are written to the file as they are recorded
This property and the
property are mutually exclusive
determines if to add the recorded data to the data fork of the movie file specified by
the property.
By default, the grabber deletes the movie file and
creates a new file containing one movie and its movie resource.
If this property is set to true, the recorded data will be appended to the data
fork of the movie file and a new movie resource will be created in that file.
determines if the the new movie resource will be added to the movie file
specified by the property.
If this property is set to true, a new movie resource will be created and added to the movie file.
If you want to create cross–platform movie
files you should let this property set to its default value of false
specifies the destination data reference for a record operation