EasyManuals Logo

THORLABS DCC1645C User Manual

THORLABS DCC1645C
530 pages
To Next Page IconTo Next Page
To Next Page IconTo Next Page
To Previous Page IconTo Previous Page
To Previous Page IconTo Previous Page
Page #409 background imageLoading...
Page #409 background image
© 2013 Thorlabs GmbH
4 Programming (SDK)
407
4.5.23 is_SaveImageEx
USB 2.0
USB 3.0
USB 2.0
USB 3.0
Syntax
INT is_SaveImageEx (HIDS hCam, const IS_CHAR* File, INT fileFormat, INT Param)
Description
Attention
This function is obsolete and should not be used anymore. We recommend to use the is_ImageFile()
function instead (see also Obsolete functions ).
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).
Notes
You can save images with a bit depth of more than 8 bit in the PNG format. 12 bit formats are converted into 16
bit.
In Direct3D mode, overlay data are 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.
fileFormat
Specifies the output format of the file.
IS_IMG_BMP
Bitmap format
IS_IMG_JPG
JPEG format
IS_IMG_PNG
PNG format
Param
When you use IS_IMG_JPG or IS_IMG_PNG 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_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
264
379

Table of Contents

Other manuals for THORLABS DCC1645C

Questions and Answers:

Question and Answer IconNeed help?

Do you have a question about the THORLABS DCC1645C and is the answer not in the manual?

THORLABS DCC1645C Specifications

General IconGeneral
BrandTHORLABS
ModelDCC1645C
CategorySecurity Camera
LanguageEnglish

Related product manuals