THORLABS DCU223x User Manual

© 2013 Thorlabs GmbH
4 Programming (SDK)
149
4.2.5 Saving Images and Videos
Using the uc480 API, you can
Save and load single frames
Capture an AVI frame sequence
4.2.5.1 Saving and Loading Single Frames
With the is_ImageFile() function you can save the image data of the current image memory to a BMP, PNG
or JPG file, and load saved image data into an image memory.
4.2.5.2 Capturing AVIs
The functions of the uc480_tools.dll enable you to save images captured with the DCxCamera as sequences
to an AVI file. In order to reduce the file size, the single frames are stored in the AVI container using an adjustable
JPEG compression. It is possible to extract single frames from the AVI file.
AVI Capture Workflow
First initialize the AVI interface and then create a empty AVI file.
isavi_InitAVI()
Initializes the AVI interface.
isavi_ExitAVI()
Terminates and closes the AVI interface.
isavi_OpenAVI()
Opens an AVI file for capturing.
isavi_CloseAVI()
Closes an AVI file.
isavi_GetAVIFileName()
Returns the name of the current AVI file.
The following settings should also be done prior to starting the recording.
isavi_SetFrameRate()
Sets the frame rate of the AVI video.
isavi_SetImageQuality()
Sets the compression level/image quality of the AVI video.
isavi_SetImageSize()
Sets the size and offset of the input image memory.
Once the AVI file has been created, captured images are placed in a buffer. Then, the images are compressed and
added to the AVI file which is stored on the hard disk. These operations are not performed in the same thread as
the capturing process. If you capture more images while a compression or write operation is in progress, the new
images will be discarded.
isavi_StartAVI()
Starts AVI recording.
isavi_AddFrame()
Adds a compressed image to the AVI file.
isavi_StopAVI()
Stops AVI recording.
With these functions, you can query additional information on the ongoing recording.
isavi_GetAVISize()
Returns the size of the current AVI file.
isavi_GetnCompressedFrames()
Returns the number of frames in the current AVI file.
isavi_GetnLostFrames()
Returns the number of frames that have been discarded so far.
isavi_ResetFrameCounters()
Resets the counters for discarded and saved frames to 0.
Events can be used to get signalled when a frame was added.
isavi_DisableEvent()
Disables a AVI event.
isavi_EnableEvent()
Enables a AVI-Event.
isavi_ExitEvent()
Turns off AVI event handling.
isavi_InitEvent()
Turns on AVI event handling.
Supported color formats
The supported input color formats are RGB32, RGB24, Y8 and raw Bayer. The output file will always be in RGB24
format, regardless of the input data format. You can adjust the size of the images to be stored by defining a freely
selectable area of interest (AOI).
149
149
264
369
362
371
360
364
374
375
376
377
359
378
366
367
368
373
360
361
363
370

THORLABS DCU223x Specifications

General

Brand	THORLABS
Model	DCU223x
Category	Security Camera
Language	English