The UMSImageWindowMClass metaclass is an Ultimedia Services Version 2 feature and does not apply to Ultimedia Services Version 1.2.1.
This class inherits from the UMSClass class. This object creates UMSImageWindow objects based on the display and image format needed.
To learn more about the UMSImageWindowMClass class, see:
For introductory information, see MetaClass Objects.
Create an UMSImageWindow object based on the display specified in x_disp.
in Display *x_disp | A display pointer for use with X11. |
A pointer to an UMSImageWindow object | If no error is found. |
A NULL pointer to UMSImageWindow | If an error is found including but not limited to: a bad x_disp, a malloc() failure |
Create an UMSImageWindow object based on the display specified in x_disp, and the desired image source. If an ImageWindow is successfully instantiated, return a pointer to the ImageWindow or else return a NULL. If there no hardware assist, then instantiate a base ImageWindow object (provided the format is one X understands). If there is hardware assist, attempt to match the desired format (listed in sequence in order of precedence) with the list that the hardware supports. When a match is found, return the pointer to the device-specific image window. If the call fails, the return code and extra information is returned by the method.
Error Codes |
---|
For certain Error Codes, more specific information can be obtained from the error_string parameter.
Return Values | |
---|---|
A pointer to an UMSImageWindow object | If no error is found.
A NULL pointer is returned if an image window could not be created for any reason. The error value is then set. |
Create an UMSImageWindow object based on the display specified in x_disp, the desired image source, and a window id. If an ImageWindow is successfully instantiated, return a pointer to the ImageWindow or else return a NULL. If there no hardware assist, then instantiate a base ImageWindow object (provided the format is one X understands). If there is hardware assist, attempt to match the desired format (listed in sequence in order of precedence) with the list that the hardware supports. When a match is found, return the pointer to the device-specific image window. If the call fails, the return code and extra information is returned by the method.
A pointer to an UMSImageWindow object If no error is found. A NULL pointer is returned if an image window could not be created for any reason. The error value is set.
For introductory information, see MetaClass Objects.