is_SaveImage

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Syntax

INT is_SaveImage (HIDS hCam, const IS_CHAR* File)

Description

Achtung

This function is obsolete and should not be used anymore. We recommend to use the is_ImageFile() function instead (see also Obsolete functions).

is_SaveImage() saves an image in bitmap (*.BMP) 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).

Hinweis

In Direct3D mode, overlay data is not saved.

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.

Return values

IS_FILE_WRITE_OPEN_ERROR	File cannot be opened for writing or reading.
IS_INVALID_CAMERA_HANDLE	Invalid camera handle
IS_INVALID_MEMORY_POINTER	Invalid pointer or invalid memory ID
IS_INVALID_PARAMETER	One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode.
IS_NO_SUCCESS	General error message
IS_NOT_SUPPORTED	The camera model used here does not support this function or setting.
IS_OUT_OF_MEMORY	No memory could be allocated.
IS_SEQUENCE_BUF_ALREADY_LOCKED	The memory could not be locked. The pointer to the buffer is invalid.
IS_SUCCESS	Function executed successfully

Related functions

•is_ImageFile()

•is_GetImageMem()

•is_SetImageMem()

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.

Home > C: Programming > Obsolete functions >	History back Previous chapter Next chapter Print
is_SaveImage