Contents
Navigation
Home User Reference Other Resources


The QTPlgVideoOutputImage class provides you with services for manage the output of still images on an external device (i.e a video recorder or a camera).
You will find general informations about video ouput component reading the documentation of the super class.





The QTPlgVideoOutputImage class constructors are called when you create a new instance of the class, while the ˜QTPlgVideoOutputImage 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 first video output component available to the current system. If no video output component can be found, the class instance will and you should get rid of it; otherwise, the properties of the class will be initialized to the default settings of the video output component found
(other as QTPlgVideoOutputImage)
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 video output component 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
(component as )
The new class instance will try to open a connection to the video output component specified by the component parameter; you can obtain a list of all of the currently installed video output components by using the method of the module, passing to it the appropriate . If the connection succeeds, the properties of the class will be initialized to the default settings of the selected video output component

specifies the image to display onto the external device associated to the selected video output component. If the natural image dimensions do not fit into the display area defined by the video output component, the image will be automatically scaled and centered to fit this rectangle. You can obtain detailed informations about the graphics world used by the video output component by inspecting the parameters of the class property

()
use this method to display the onto the external device associated to the selected video output component. Remember to start an output session by using the method before trying to display the image. Once obtained exclusive access to the video hardware controlled by the selected video output component, you should view your image drawed onto the external video display everytime you call this method. When you have done, you release access to the video hardware controlled by the video output component calling the routine
returns nothing. Check the class property for errors