ImageEn, unit iexBitmaps

TIEBitmap.SaveToFile

TIEBitmap.SaveToFile


Declaration

function SaveToFile(const FileName: string; ImageFormat: TIOFileType = ioUnknown): boolean;


Description

Saves the image to a file (in any format supported by the TImageEnIO class).
You can specify the ImageFormat. When saving to a file, or ioUnknown for the type to be determined by the file extension (e.g. ioJPEG for 'Image.jpeg')
Returns true on success.

Note:
TIEBitmap only supports saving of a single frame image. To load and save images containing multiple frames, use TIEMultiBitmap
For legacy reasons, SaveToFile() is an alias of Write()


Examples

var
  bmp: TIEBitmap;
begin
  bmp := TIEBitmap.Create();
  bmp.LoadFromFile( 'D:\input.jpg' );
  bmp.SaveToFile( 'D:\output.webp' );
  bmp.Free();
end;

Which is the same as...
with TIEBitmap.Create( 'D:\input.jpg' ) do
begin
  SaveToFile( 'D:\output.webp' );
  Free();
end;

Also the same as...
var
  bmp: TIEBitmap;
  io: TImageEnIO;
begin
  bmp := TIEBitmap.Create();
  io := TImageEnIO.CreateFromBitmap( bmp );
  io.LoadFromFile( 'D:\input.jpg' );
  io.SaveToFile( 'D:\output.webp' );
  io.Free();
  bmp.Free();
end;

// Convert an SVG file to JPEG at max size of 1000x1000 (will be adjusted to maintain aspect ratio)
var
  bmp: TIEBitmap;
begin
  bmp := TIEBitmap.Create();
  try
    bmp.Params.LoadToWidth  := 1000;
    bmp.Params.LoadToHeight := 1000;
    bmp.Params.AutoScaleImport := True;
    bmp.LoadFromFile( 'D:\Input.svg' );
    bmp.Params.JPEG_Quality := 90;
    bmp.SaveToFile( 'D:\Output.jpg' );
  finally
    bmp.Free();
  end;
end;


See Also

SaveToStream
LoadFromFile
Filename
IO