Home > C: Programming > Function Descriptions > | History back Previous chapter Next chapter Print |
is_SaveImageEx |
uEye Camera Manual Version 3.80
is_SaveImageEx
USB 2.0 GigE |
USB 2.0 GigE |
Syntax
INT is_SaveImageEx (HIDS hCam, const IS_CHAR* File,
INT fileFormat, INT Param)
Description
is_SaveImageEx() saves an image in bitmap (*.BMP), Jpeg (*.JPG), or PNG format to a file. The images are read out from the current image memory. The bitmap is stored with the color depth that was used when allocating the image memory (in DIB mode) or that was set for the current color mode (in Direct3D mode).
|
|
Input Parameters
hCam |
Camera handle |
File |
Pointer to a string containing the BMP filename You can either pass an absolute or a relative path. If NULL is passed, the "Save as" dialog will be displayed. |
fileFormat |
Specifies the output format of the file. |
IS_IMG_BMP |
Bitmap format |
IS_IMG_JPG |
JPEG format |
Param |
When you use IS_IMG_JPG to specify the file format, you can set the quality by specifying a value between 1 and 100 for Param. If Param=0, the system uses the default quality (75). If you use IS_IMG_BMP, Param does not take effect. |
Return Values
IS_SUCCESS |
Function executed successfully |
IS_NO_SUCCESS |
General error message |
IS_INVALID_PARAMETER |
Invalid file format or invalid JPEG quality value |
Related Functions