Saving Images And Videos; Saving And Loading Single Frames; Capturing Avis - THORLABS DCU223x Operation Manual And Sdk

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()
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()
369
isavi_ExitAVI()
362
isavi_OpenAVI()
371
isavi_CloseAVI()
360
isavi_GetAVIFileName()
The following settings should also be done prior to starting the recording.
isavi_SetFrameRate()
isavi_SetImageQuality()
isavi_SetImageSize()
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()
377
isavi_AddFrame()
359
isavi_StopAVI()
378
With these functions, you can query additional information on the ongoing recording.
isavi_GetAVISize()
isavi_GetnCompressedFrames()
367
isavi_GetnLostFrames()
isavi_ResetFrameCounters()
Events can be used to get signalled when a frame was added.
isavi_DisableEvent()
isavi_EnableEvent()
isavi_ExitEvent()
isavi_InitEvent()
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).
© 2013 Thorlabs GmbH
149
149
function you can save the image data of the current image memory to a BMP, PNG
264
Initializes the AVI interface.
Terminates and closes the AVI interface.
Opens an AVI file for capturing.
Closes an AVI file.
Returns the name of the current AVI file.
364
Sets the frame rate of the AVI video.
374
Sets the compression level/image quality of the AVI video.
375
Sets the size and offset of the input image memory.
376
Starts AVI recording.
Adds a compressed image to the AVI file.
Stops AVI recording.
Returns the size of the current AVI file.
366
Returns the number of frames in the current AVI file.
Returns the number of frames that have been discarded so far.
368
Resets the counters for discarded and saved frames to 0.
373
Disables a AVI event.
360
Enables a AVI-Event.
361
Turns off AVI event handling.
363
Turns on AVI event handling.
370
4 Programming (SDK)
149