TImageEnIO.SaveToFileWIC

Declaration

procedure SaveToFileWIC(const FileName: WideString; FileType: TIOFileType);

Description

Saves the current image to a file using TIEWICWriter.
Set FileType to a WIC supported encoder, e.g. ioDDS or ioJPEG.

Note:
◼Relevant formats can saved losslessly by enabling Lossless. Otherwise the quality can be specified using ImageQuality
◼Some WIC formats require installation of a codec from the Microsoft store
◼See WIC_Save_FileTypes for a list of WIC supported saving types
◼If an internal save error is encountered Aborting will return True. Saving issues due to insufficient write permissions and disk write failures will raise an exception.
◼To abort while saving set Aborting to True

Examples

// Save an image to a DirectDraw Surface stream using WIC
ImageEnView1.IO.SaveToFileWIC( 'D:\Image.dds', ioDDS );

// Save an image to a JPEG stream using WIC
ImageEnView1.IO.SaveToFileWIC( 'D:\Image.jpeg', ioJPEG );

Heif Size Comparisons

ImageEnView1.IO.LoadFromFile( 'D:\Alpha.png' );   // Original PNG - 335KB


ImageEnView1.IO.Params.ImageQuality := 1.0;
ImageEnView1.IO.SaveToFileWIC( 'D:\Image100.Heif' );  // 85KB


ImageEnView1.IO.Params.ImageQuality := 0.9;
ImageEnView1.IO.Params.Lossless     := False;
ImageEnView1.IO.SaveToFileWIC( 'D:\Image90.Heif' );   // 68KB


ImageEnView1.IO.Params.ImageQuality := 0.7;
ImageEnView1.IO.SaveToFileWIC( 'D:\Image70.Heif' );   // 40KB


ImageEnView1.IO.Params.ImageQuality := 0.5;
ImageEnView1.IO.SaveToFileWIC( 'D:\Image50.Heif' );   // 21KB


ImageEnView1.IO.Params.ImageQuality := 0.2;
ImageEnView1.IO.SaveToFileWIC( 'D:\Image20.Heif' );   // 7KB


ImageEnView1.IO.Params.ImageQuality := 0.01;
ImageEnView1.IO.SaveToFileWIC( 'D:\Image01.Heif' );   // 3KB

See Also

◼SaveToStreamWIC
◼LoadFromFileWIC
◼WIC_Save_FileTypes

---