ImageEn, unit imageenio

TImageEnIO.InsertToFileTIFF

TImageEnIO.InsertToFileTIFF


Declaration

function InsertToFileTIFF(const FileName: WideString): integer;


Description

Insert the current image into a TIFF file at the position specified by ImageIndex. The file must exist.
FileName is the file name including extension.
Returns the number of images inside the file after the insertion, or 0 on failure.

Note:
Only Intel Byte Order is supported (TIFF_ByteOrder=ioLittleEndian). If the file is Big-Endian, the method will fail with the result of 0. To support ioBigEndian, use InsertTIFFImageFile.
InsertToFileTIFF is much faster than InsertTIFFImageFile, but only supports Intel Byte Order (TIFF_ByteOrder=ioLittleEndian)


Example

// Create a multi-image TIFF from images into two ImageEnViews
ImageEnView1.IO.SaveToFile('D:\multi.tif');  // create with a single image
ImageEnView2.IO.Params.ImageIndex := 1;      // prepare to insert as second image
ImageEnView2.IO.InsertToFileTIFF('D:\multi.tif');


See Also

InsertToStreamTIFF
LoadFromFileTIFF
SaveToFileTIFF
ReplaceFileTIFF
TIFF_ImageIndex
TIFF_ImageCount
DeleteTIFFImGroup
DeleteTIFFIm
Global Image Methods