Start » Filter Reference » Image » Image IO » SaveImage_Asynchronous

SaveImage_Asynchronous

Basic

Module: FoundationLite

Saves an image to a file in the background thread.

Name Type Range Description
Input value
 inThreadQueueSize Integer 1 - Number of incoming frames that can be buffered before the thread is able to process them
Input value
 inImage Image An image to be saved
Input value
 inImageFileFormat ImageFileFormat* If Nil the format will be chosen on the basis of extension
Input value
 inFile File Path to a file
Input value
 inIgnoreErrors Bool If false the error will be reported as soon as the filter instance is again executed

Description

The operation saves an image to file encoded in one of the standard image file formats. Currently the filter supports the following formats:

  • BMP (*.bmp)
  • JPEG (*.jpg, *jpeg)
  • PNG (*.png),
  • PNM (*.pbm, *.pgm, *.ppm, *.pnm),
  • TIFF (*.tif, *.tiff).

Because of the limitations of the standard image formats, the filter is capable of saving three-channel images of UInt8 pixel type for all formats, and UInt16 for supported formats only (PNG, TIFF). To alter the format of an image one can use the filters contained in the Image Conversions category.

The inImageFileFormat input can be used to explicitly select the file format to be used. When inImageFileFormat is set to Auto the recognition of the desired image file format is based on the extension of the file being written, so it is essential that the extension is present and accurate. When extension of the file is not specified, it will be appended according to inImageFileFormat.

If the selected file does not exist, it will be created on filter execution. If the selected file does exist, it will be overwritten.

It is also possible to save images using the general SaveObject filter, which uses internal AVS data format to store any data, that can be later loaded using corresponding LoadObject filter.

Remarks

This filter is executed in the background thread. Execution errors may be reported with a delay or ignored. Stopping of the program may be delayed, because of waiting for background work to complete.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Unsupported pixel type in SaveImage_Asynchronous.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of SaveImage filter group.

See Also

  • LoadImage – Loads a single image from a file.