Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_SaveImageMemEx

uEye Camera Manual Version 3.80

is_SaveImageMemEx

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

GigE

Syntax

INT is_SaveImageMemEx (HIDS hCam,  const IS_CHAR* File,
char* pcMem, int nID,
INT fileFormat, INT Param)

Description

is_SaveImageMemEx() saves an image in bitmap (*.BMP), Jpeg (*.JPG), or PNG format to a file. The images are read out from the specified 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). JPEG files are always saved with a color depth of 8 or 24 bits.

Hinweis

You can save images with a bit depth of more than 8 bit in the PNG format.

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..

pcMem

Pointer to the image memory

nID

Image memory ID

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

is_SaveImage()
is_SaveImageEx()
is_SaveImageMem()
is_LoadImage()
Is_LoadImageMem()
is_GetImageMem()
is_SetImageMem()

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


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com