ImageEn, unit iexBitmaps

TIOParams.RAW_GetEmbeddedJpeg

TIOParams.RAW_GetEmbeddedJpeg


Declaration

property RAW_GetEmbeddedJpeg: Boolean;


Description

If enabled, ImageEn will load the embedded JPEG if it exists. Many RAW formats include an embedded JPEG for a quick preview image. If there is no embedded JPEG, the full size raw image will be loaded.
When RAW_GetEmbeddedJpeg is used, the size is guaranteed to be no smaller than RAW_EmbeddedJpegMinWidth x RAW_EmbeddedJpegMinHeight. You can also speed up loading by setting RAW_EmbeddedJpegLoading = ierlScaled.
It is also used to load a preview image when using TIEWICReader (if one is available)

Note: RAW_GetEmbeddedJpeg is only used if CameraRawEngine=ieenDLL or ieenWIC.

Default: False (Specified by IOParamDefaults)


Demo

Demo  Demos\InputOutput\CameraRaw\CameraRaw.dpr
Demo  Demos\InputOutput\IEViewPerformance\Performance.dpr


Raw Loading Speed

ImageEn offers four properties to improve loading speed for RAW images:
 RAW_GetExifThumbnail
 RAW_GetEmbeddedJpeg
 RAW_EmbeddedJpegLoading
 RAW_HalfSize

Example usage:

// Load the full size RAW
ImageEnView.IO.Params.RAW_GetExifThumbnail := False;
ImageEnView.IO.Params.RAW_GetEmbeddedJpeg := False;
ImageEnView.IO.Params.RAW_HalfSize := False;

// Load the half size RAW
ImageEnView.IO.Params.RAW_GetExifThumbnail := False;
ImageEnView.IO.Params.RAW_GetEmbeddedJpeg := False;
ImageEnView.IO.Params.RAW_HalfSize := True;

// Load the embedded JPEG (loading a half size raw if there is no embedded JPEG)
ImageEnView.IO.Params.RAW_GetExifThumbnail := False;
ImageEnView.IO.Params.RAW_GetEmbeddedJpeg := True;
ImageEnView.IO.Params.RAW_HalfSize := True;

// Load the thumbnail (will automatically fall back to the embedded JPEG if there is no thumbnail)
ImageEnView.IO.Params.RAW_GetExifThumbnail := True;
ImageEnView.IO.Params.RAW_GetEmbeddedJpeg := True;
ImageEnView.IO.Params.RAW_HalfSize := True; // In case there is no EXIF thumbnail or embedded JPEG



Example

// Fastest loading of a RAW image at no smaller than 800x600
ImageEnView1.IO.Params.RAW_GetEmbeddedJpeg       := True;
ImageEnView1.IO.Params.RAW_EmbeddedJpegLoading   := ierlScaled;
ImageEnView1.IO.Params.RAW_EmbeddedJpegMinWidth  := 800;
ImageEnView1.IO.Params.RAW_EmbeddedJpegMinHeight := 600;
ImageEnView1.IO.LoadFromFile('C:\CRW_0001.CRW');


See Also

 OptimizeLoadingParams
 RAW_EmbeddedJpegLoading
 RAW_EmbeddedJpegMinWidth
 RAW_EmbeddedJpegMinHeight