imageenio.pas

·ImageEn 2.3.0 ImageEn一组用于图像处理、查看和分析的Delphi控件。能够保存几种图像格式

Read-only

<FM>Example<FC>

// this return the frame count of 'pages.tiff' without load the TIFF
ImageEnView1.IO.ParamsFromFile('pages.tiff');
ImageCount:=ImageEnView1.IO.Params.TIFF_ImageCount;
!!}
    property TIFF_ImageCount: integer read fTIFF_ImageCount write SetImageCount;

{!!
<FS>TIOParamsVals.TIFF_PhotometInterpret

<FM>Declaration<FC>
property TIFF_PhotometInterpret: <A TIOTIFFPhotometInterpret>;

<FM>Description<FN>
Photometric interpretation.

!!}
    property TIFF_PhotometInterpret: TIOTIFFPhotometInterpret read fTIFF_PhotometInterpret write fTIFF_PhotometInterpret;

{!!
<FS>TIOParamsVals.TIFF_PlanarConf

<FM>Declaration<FC>
property TIFF_PlanarConf: integer;

<FM>Description<FN>
Planar configuration.

!!}
    property TIFF_PlanarConf: integer read fTIFF_PlanarConf write fTIFF_PlanarConf;

{!!
<FS>TIOParamsVals.TIFF_XPos

<FM>Declaration<FC>
property TIFF_XPos: integer;

<FM>Description<FN>
X top-left position of the original scanned image.

!!}
    property TIFF_XPos: integer read fTIFF_XPos write fTIFF_XPos;

{!!
<FS>TIOParamsVals.TIFF_YPos

<FM>Declaration<FC>
property TIFF_YPos: integer;

<FM>Description<FN>
Y top-left position of the original scanned image.

!!}
    property TIFF_YPos: integer read fTIFF_YPos write fTIFF_YPos;

{!!
<FS>TIOParamsVals.TIFF_DocumentName

<FM>Declaration<FC>
property TIFF_DocumentName: string;

<FM>Description<FN>
Specifies the document name field of a TIFF image format.

<FM>Example<FC>

ImageEnView1.IO.Params.TIFF_DocumentName:='Sanremo';
ImageEnView1.IO.Params.TIFF_ImageDescription:='The city of the flowers';
ImageEnView1.IO.SaveToFile('Italy.tif');
!!}
    property TIFF_DocumentName: string read fTIFF_DocumentName write fTIFF_DocumentName;

{!!
<FS>TIOParamsVals.TIFF_ImageDescription

<FM>Declaration<FC>
property TIFF_ImageDescription: string;

<FM>Description<FN>
Specifiy the image description field of a TIFF image format.

<FM>Example<FC>

ImageEnView1.IO.Params.TIFF_DocumentName:='Sanremo';
ImageEnView1.IO.Params.TIFF_ImageDescription:='The city of the flowers';
ImageEnView1.IO.SaveToFile('Italy.tif');
!!}
    property TIFF_ImageDescription: string read fTIFF_ImageDescription write fTIFF_ImageDescription;

{!!
<FS>TIOParamsVals.TIFF_PageName

<FM>Declaration<FC>
property TIFF_PageName: string;

<FM>Description<FN>
Page name field in a TIFF image format.

!!}
    property TIFF_PageName: string read fTIFF_PageName write fTIFF_PageName;

{!!
<FS>TIOParamsVals.TIFF_PageNumber

<FM>Declaration<FC>
property TIFF_PageNumber: integer;

<FM>Description<FN>
Page number.

!!}
    property TIFF_PageNumber: integer read fTIFF_PageNumber write fTIFF_PageNumber;

{!!
<FS>TIOParamsVals.TIFF_PageCount

<FM>Declaration<FC>
property TIFF_PageCount: integer;

<FM>Description<FN>
Number of pages in a TIFF file.

!!}
    property TIFF_PageCount: integer read fTIFF_PageCount write fTIFF_PageCount;

{!!
<FS>TIOParamsVals.TIFF_Orientation

<FM>Declaration<FC>
property TIFF_Orientation:integer;

<FM>Description<FN>
The TIFF_Orientation is the orientation of the original image. ImageEn adjusts automatically the image if Params.TIFF_EnableAdjustOrientation is True.

Allowed values:
<TABLE>
<R> <H>Value</H> <H>Description</H> </R>
<R> <C>1</C> <C>The 0th row represents the visual top of the image, and the 0th column represents the visual left-hand side.</C> </R>
<R> <C>2</C> <C>The 0th row represents the visual top of the image, and the 0th column represents the visual right-hand side.</C> </R>
<R> <C>3</C> <C>The 0th row represents the visual bottom of the image, and the 0th column represents the visual right-hand side.</C> </R>
<R> <C>4</C> <C>The 0th row represents the visual bottom of the image, and the 0th column represents the visual left-hand side.</C> </R>
<R> <C>5</C> <C>The 0th row represents the visual left-hand side of the image, and the 0th column represents the visual top.</C> </R>
<R> <C>6</C> <C>The 0th row represents the visual right-hand side of the image, and the 0th column represents the visual top.</C> </R>
<R> <C>7</C> <C>The 0th row represents the visual right-hand side of the image, and the 0th column represents the visual bottom.</C> </R>
<R> <C>8</C> <C>The 0th row represents the visual left-hand side of the image, and the 0th column represents the visual bottom.</C> </R>
</TABLE>

Support for orientations other than 1 is not a baseline TIFF requirement.

Read-only
!!}
    property TIFF_Orientation: integer read fTIFF_Orientation write SetTIFF_Orientation;

{!!
<FS>TIOParamsVals.TIFF_EnableAdjustOrientation

<FM>Declaration<FC>
property TIFF_EnableAdjustOrientation:boolean;

<FM>Description<FN>
When TIFF_EnableAdjustOrientation is True, ImageEn rotates loaded images as specified in the TIFF file. (default value is False).
!!}
    property TIFF_EnableAdjustOrientation: boolean read fTIFF_EnableAdjustOrientation write fTIFF_EnableAdjustOrientation;

{!!
<FS>TIOParamsVals.TIFF_LZWDecompFunc

<FM>Declaration<FC>
property TIFF_LZWDecompFunc: <A TTIFFLZWDecompFunc>;

<FM>Description<FN>
LZW decompression function. You can also set global variable DefTIFF_LZWDecompFunc to specify this function once for all TImageEnIO components.

<FM>Example<FC>
...
uses TIFLZW;
...

ImageEnView1.IO.Params.TIFF_LZWDECOMPFUNC:=TIFFLZWDecompress;
ImageEnView1.IO.Params.TIFF_LZWCOMPFUNC:=TIFFLZWCompress;
!!}
    property TIFF_LZWDecompFunc: TTIFFLZWDecompFunc read fTIFF_LZWDecompFunc write fTIFF_LZWDecompFunc;

{!!
<FS>TIOParamsVals.TIFF_LZWCompFunc

<FM>Declaration<FC>
property TIFF_LZWCompFunc:<A TTIFFLZWCompFunc>;

<FM>Description<FN>
TIFF_LZWCompFunc  is the LZW compression function.
You can also set global variable DefTIFF_LZWCompFunc to set this function once for all TImageEnIO components.

<FM>Example<FC>

...
uses TIFLZW;
...

ImageEnView1.IO.Params.TIFF_LZWDecompFunc:=TIFFLZWDecompress;
ImageEnView1.IO.Params.TIFF_LZWCompFunc:=TIFFLZWCompress;
!!}
    property TIFF_LZWCompFunc: TTIFFLZWCompFunc read fTIFF_LZWCompFunc write fTIFF_LZWCompFunc;

{!!
<FS>TIOParamsVals.TIFF_JPEGQuality

<FM>Declaration<FC>
property TIFF_JPEGQuality:integer;

<FM>Description<FN>
TIFF_JPEGQuality is a quality factor, from 1 to 100 for TIFF compressed as JPEG.
High values produce better image quality but require more disk space.
!!}
    property TIFF_JPEGQuality: integer read fTIFF_JPEGQuality write fTIFF_JPEGQuality;

{!!
<FS>TIOParamsVals.TIFF_JPEGColorSpace

<FM>Declaration<FC>
property TIFF_JPEGColorSpace:<A TIOJPEGColorSpace>;

<FM>Description<FN>
Specifies the desired color space for the Jpeg included in a TIFF file.

<FM>Example<FC>
ImageEnView.IO.Params.TIFF_JPEGColorSpace:=ioJPEG_RGB;
ImageEnView.IO.Params.TIFF_Compression:=ioTIFF_JPEG;
ImageEnView.IO.SaveToFile('output.tif');
!!}
    property TIFF_JPEGColorSpace: TIOJPEGColorSpace read fTIFF_JPEGColorSpace write fTIFF_JPEGColorSpace;

{!!
<FS>TIOParamsVals.TIFF_FillOrder

<FM>Declaration<FC>
property TIFF_FillOrder: integer;

<FM>Description<FN>
TIFF_FillOrder specifies the logical order of bits within a byte.
1 = pixels are arranged within a byte such that pixels with lower column values are stored in the higher-order bits of the byte.
2 = pixels are arranged within a byte such that pixels with lower column values are stored in the lower-order bits of the byte.
!!}
    property TIFF_FillOrder: integer read fTIFF_FillOrder write fTIFF_FillOrder;

{!!
<FS>TIOParamsVals.TIFF_ZIPCompression

<FM>Declaration<FC>
property TIFF_ZIPCompression:integer;

<FM>Description<FN>
Specifies the compression level to be used when compression is ioTIFF_ZIP.
0 = fastest
1 = normal (default)
2 = max
!!}
    property TIFF_ZIPCompression:integer read fTIFF_ZIPCompression write fTIFF_ZIPCompression;

{!!
<FS>TIOParamsVals.TIFF_ByteOrder

<FM>Declaration<FC>
property TIFF_ByteOrder:<A TIOByteOrder>;

<FM>Description<FN>
Specifies the byte order of the last loaded image.
This property is readonly, because ImageEn uses always ioLittleEndian when saves TIFF.

ioBigEndian byte order is used by Motorola and PowerPC (non Intel Macintosh), while ioLittleEndian is used by Intel processors.

This function is useful, for example, in <A InsertTIFFImageFile> and <A InsertTIFFImageStream> because this function just merges the two tiff images, without decoding them. If the images have different byte order the resulting TIFF is un-readable.
!!}
    property TIFF_ByteOrder:TIOByteOrder read fTIFF_ByteOrder write fTIFF_ByteOrder;

    // GIF

{!!
<FS>TIOParamsVals.GIF_Version

<FM>Declaration<FC>
property GIF_Version: string;

<FM>Description<FN>
GIF_Version can be 'GIF89a' or 'GIF87a'.

!!}
    property GIF_Version: string read fGIF_Version write fGIF_Version;

{!!
<FS>TIOParamsVals.GIF_ImageIndex

<FM>Declaration<FC>
property GIF_ImageIndex: integer;

<FM>Description<FN>
The index (from 0) of the image.

!!}
    property GIF_ImageIndex: integer read fGIF_ImageIndex write SetImageIndex;

{!!
<FS>TIOParamsVals.GIF_ImageCount

<FM>Declaration<FC>
property GIF_ImageCount:integer;

<FM>Description<FN>
GIF_ImageCount specifies the image count of the last GIF loaded.

Read-only

<FM>Example<FC>

// this return the frame count of 'animated.gif' without load the GIF
ImageEnView1.IO.ParamsFromFile('animated.gif');
ImageCount:=ImageEnView1.IO.Params.GIF_ImageCount;
!!}
    property GIF_ImageCount: integer read fGIF_ImageCount write SetImageCount;

{!!
<FS>TIOParamsVals.GIF_XPos

<FM>Declaration<FC>
property GIF_XPos: integer;

<FM>Description<FN>
GIF_XPos is the top-left X coordinate where the frame will be shown.

!!}
    property GIF_XPos: integer read fGIF_XPos write fGIF_XPos;

{!!
<FS>TIOParamsVals.GIF_YPos

<FM>Declaration<FC>
property GIF_YPos: integer;

<FM>Description<FN>
GIF_YPos is the top-left Y coordinate where the frame will be shown.

!!}
    property GIF_YPos: integer read fGIF_YPos write fGIF_YPos;

{!!
<FS>TIOParamsVals.GIF_DelayTime

<FM>Declaration<FC>
property GIF_DelayTime: integer;

<FM>Description<FN>
GIF_DelayTime is the time (in 1/100 s) the frame remains shown.

!!}
    property GIF_DelayTime: integer read fGIF_DelayTime write fGIF_DelayTime;

{!!
<FS>TIOParamsVals.GIF_FlagTranspColor

<FM>Declaration<FC>
property GIF_FlagTranspColor: boolean;

<FM>Description<FN>
If True, the GIF_TranspColor color is valid (the image has a transparency color).
Note: when the image contains an alpha channel (transparency channel) this property is handled automatically.

<FM>Example<FC>

ImageEnView1.IO.Params.GIF_FlagTranspColor:=True;
ImageEnView1.IO.Params.GIF_TranspColor:=CreateRGB(0,0,0);  // black is the transparent color
!!}
    property GIF_FlagTranspColor: boolean read fGIF_FlagTranspColor write fGIF_FlagTranspColor;

{!!
<FS>TIOParamsVals.GIF_TranspColor

<FM>Declaration<FC>
property GIF_TranspColor: <A TRGB>;

<FM>Description<FN>
GIF_TranspColor is the transparency color (If <A TIOParamsVals.GIF_FlagTranspColor> is True).

This color should exist in the image.

!!}
    property GIF_TranspColor: TRGB read fGIF_TranspColor write fGIF_TranspColor;

{!!
<FS>TIOParamsVals.GIF_Interlaced

<FM>Declaration<FC>
property GIF_Interlaced: boolean;

<FM>Description<FN>
If True, the image is interlaced.

!!}
    property GIF_Interlaced: boolean read fGIF_Interlaced write fGIF_Interlaced;

{!!
<FS>TIOParamsVals.GIF_WinWidth

<FM>Declaration<FC>
property GIF_WinWidth: integer;

<FM>Description<FN>
GIF_WinWidth is the width of the window where GIF is shown.

!!}
    property GIF_WinWidth: integer read fGIF_WinWidth write fGIF_WinWidth;

{!!
<FS>TIOParamsVals.GIF_WinHeight

<FM>Declaration<FC>
property GIF_WinHeight: integer;

<FM>Description<FN>
GIF_WinHeight is the height of the window where GIF is shown.

!!}
    property GIF_WinHeight: integer read fGIF_WinHeight write fGIF_WinHeight;

{!!
<FS>TIOParamsVals.GIF_Background

<FM>Declaration<FC>
property GIF_Background: <A TRGB>;

<FM>Description<FN>
GIF_Background is the background color of the GIF.

This color should exist in the image.

!!}
    property GIF_Background: TRGB read fGIF_Background write fGIF_Background;

{!!
<FS>TIOParamsVals.GIF_Ratio

<FM>Declaration<FC>
property GIF_Ratio: integer;

<FM>De