Values handles are:

1 for black/white

2..7 for colormapped bitmap (from 4 to 256 colors)

8 for colormapped or true color

Specifies compression method.

Only 16 or 256 color bitmap can be saved with RLE compression.

BMP file can have 32 bits per pixel.

This property controls how interpret the extra byte in the 32 bit word.

When BMP_HandleTransparency is true the extra byte is interpreted as alpha channel, otherwise it is just discarded (ignored).

This means that when a 32-bit bitmap is displayed in IEvolution, the transparent color is not used and the image is displayed without transparency if the BMP_HandleTransparency property is False. If the BMP_HandleTransparency property is true then the image is displayed with transparency.

Specifies the next input/output data format.

ASCII text values must be separated by one o more non-alpha characters (#13, #10, #32...).

If you set this property to True before load a file which contains EXIF information, the image will be automatically orientated.

This property also sets JPEG_EnableAdjustOrientation and TIFF_EnableAdjustOrientation.

Brightness of taken subject, unit is APEX. To calculate Exposure(Ev) from BrigtnessValue(Bv), you must add SensitivityValue(Sv).

Ev=Bv+Sv Sv=log2(ISOSpeedRating/3.125)

ISO100:Sv=5, ISO200:Sv=6, ISO400:Sv=7, ISO125:Sv=5.32.

Defines Color Space.

DCF image must use sRGB color space so value is always "1".

If the picture uses the other color space, value is "65535":Uncalibrated.

This tag indicates the direction of contrast processing applied by the camera when the image was shot.

0 = Normal

1 = Soft

2 = Hard

Date/Time of image was last modified. Data format is "YYYY:MM:DD HH:MM:SS".

If clock has not set or digicam doesn't have clock, the field may be filled with spaces.

In usual, it has the same value of DateTimeOriginal

Date/Time of image digitized.

Usually, it contains the same value of EXIF_DateTimeOriginal.

Data format is "YYYY:MM:DD HH:MM:SS".

If clock has not set or digicam doesn't have clock, the field may be filled with spaces.

In the Exif standard, this tag is optional, but it is mandatory for DCF.

Date/Time of original image taken.

This value should not be modified by user program.

Data format is "YYYY:MM:DD HH:MM:SS".

If clock has not set or digicam doesn't have clock, the field may be filled with spaces.

In the Exif standard, this tag is optional, but it is mandatory for DCF.

Exif version number.

If the picture is based on Exif V2.1, value is "0210".

This tag indicates the exposure mode set when the image was shot. In auto-bracketing mode, the camera shoots a series of frames of the same scene at different exposure settings.

0 = Auto exposure

1 = Manual exposure

2 = Auto bracket

This tag indicates the degree of overall image gain adjustment.

0 = None

1 = Low gain up

2 = High gain up

3 = Low gain down

4 = High gain down

Indicates the GPS DOP (data degree of precision).

An HDOP value is written during two-dimensional measurement, and PDOP during three-dimensional measurement.

Indicates the geodetic survey data used by the GPS receiver.

If the survey data is restricted to Japan, the value of this tag is 'TOKYO' or 'WGS-84'.

Indicates the GPS satellites used for measurements.

This tag can be used to describe the number of satellites, their ID number, angle of elevation, azimuth, SNR and other information in ASCII notation.

The format is not specified.

If EXIF_HasEXIFData is True, the loaded image contains EXIF information tags.

If you want to maintain the original EXIF info, set EXIF_HasEXIFData to False, before saving.

Sets EXIF_ISOSpeedRatings property.

CCD sensitivity equivalent to Ag-Hr film speedrate.

"0" for all values means "unspecified".

Gets EXIF_ReferenceBlackWhite property.

Shows reference value of black point/white point. In case of YCbCr format, first 2 show black/white of Y, next 2 are Cb, last 2 are Cr. In case of RGB format, first 2 show black/white of R, next 2 are G, last 2 are B.

"-1" for all values means "unspecified".

This tag indicates the direction of saturation processing applied by the camera when the image was shot.

0 = Normal

1 = Low saturation

2 = High saturation

This tag indicates the type of scene that was shot. It can also be used to record the mode in which the image was shot. Note that this differs from the scene type (SceneType) tag.

0 = Standard

1 = Landscape

2 = Portrait

3 = Night scene

This tag indicates the direction of sharpness processing applied by the camera when the image was shot.

0 = Normal

1 = Soft

2 = Hard

This tag indicates the distance to the subject.

0 = unknown

1 = Macro

2 = Close view

3 = Distant view

Some of digicam can take 2.30 pictures per second, but DateTime/DateTimeOriginal/DateTimeDigitized tag can't record the sub-second time.

SubsecTime tag is used to record it.

For example, DateTimeOriginal = "1996:09:01 09:15:30", SubSecTimeOriginal = "130", Combined original time is "1996:09:01 09:15:30.130"

Some of digicam can take 2.30 pictures per second, but DateTime/DateTimeOriginal/DateTimeDigitized tag can't record the sub-second time.

SubsecTime tag is used to record it.

For example, DateTimeOriginal = "1996:09:01 09:15:30", SubSecTimeOriginal = "130", Combined original time is "1996:09:01 09:15:30.130"

Some of digicam can take 2.30 pictures per second, but DateTime/DateTimeOriginal/DateTimeDigitized tag can't record the sub-second time.

SubsecTime tag is used to record it.

For example, DateTimeOriginal = "1996:09:01 09:15:30", SubSecTimeOriginal = "130", Combined original time is "1996:09:01 09:15:30.130"

This tag indicates the white balance mode set when the image was shot.

0 = Auto white balance

1 = Manual white balance

Specifies Windows XP image rating. This is shown in properties of jpeg/tiff file under Windows XP.

Allowed values from 0 up to 5.

-1 means not available.

Sets EXIF_PrimaryChromaticities property.

Defines chromaticity of the primaries of the image. If the image uses CCIR Recommendation 709 primaries, the values are '640/1000,330/1000,300/1000,600/1000,150/1000,0/1000'.

"-1" for all values means "unspecified".

Sets EXIF_ReferenceBlackWhite property.

Shows reference value of black point/white point. In case of YCbCr format, first 2 show black/white of Y, next 2 are Cb, last 2 are Cr. In case of RGB format, first 2 show black/white of R, next 2 are G, last 2 are B.

"-1" for all values means "unspecified".

Sets EXIF_WhitePoint property.

Same as EXIF_ISOSpeedRatings (0x8827) but data type is unsigned rational.

Only Kodak's digicam uses this tag instead of EXIF_ISOSpeedRatings.

Sets EXIF_YCbCrCoefficients property.

When the image format is YCbCr, this value shows a constant to translate it to RGB format. Usually values are '0.299/0.587/0.114'.

"-1" for all values means "unspecified".

You have to set this property just before load an image which could contain a thumbnail (like EXIF thumbnail).

If you set True the thumbnail will be loaded. If no thumbnail is present the full image will be loaded.

GIF_Background is the background color of the GIF.

This color should exist in the image.

GIF_TranspColor is the transparency coolor (If GIF_FlagTranspColor is true).

This color should exist in the image.

0.0 specifies the lowest possible fidelity rendition and 1.0 specifies the highest fidelity, which for Microsoft HD Photo results in mathematically lossless compression.

The default value is 0.9.

Setting this parameter to true enables mathematically lossless compression mode and overrides the IOParams.HDP_ImageQuality parameter setting.

The default value is false.

ImageIndex specifies the index of next page to load. You have to specify this property just before methods like LoadImage.

This property is valid for all file formats (TIFF, GIF, DCX, etc..) and sets also other properties like TIFF_ImageIndex, GIF_ImageIndex, etc..

IEImagingAnnotations contains the (Wang) imaging annotations loaded (or to save) from a TIFF.

Using IEImaingAnnotations object you can create new objects, copy to a IEAnnotations (as vectorial objects), copy from a IEAnnotations (from vectorial objects) or just draw on the bitmap.

Some formats (BMP, ICO, CUR), if stored as resources (in EXE, DLL, etc...), do not contain some headers.

If you set IsResource=true, these headers are not expected allowing to load correctly the image.

Specifies the compression rate to apply. Allowed values from 0 to 1, where 1 is no compression (lossless mode).

Sample value: 0.015

Specifies the amount to reduce image size when loading (in order to load faster).

Maximum value depends on the encoded image. Generally, it will be less than 6.

-1 = Auto-Calculate: Reduce to approximately Width and Height

0 = no reduction

1 = reduce to 1/2 (2^1)

2 = reduce to 1/4 (2^2)

3 = reduce to 1/8 (2^3)

4 = reduce to 1/16 (2^4)

etc...

Default is 0

Specifies the horizontal subsampling when using YCbCr color space.

Alllowed values: 1 for non subsampling, 2 for double subsampling (halves horizontal Cb and Cr channel size).

It is suggested to use YCbCr and at least horizontal subsampling when compressing big images, due to the reduced memory requirements.

Reduction of resulting file size is detectable when lossless compression is used (J2000_Rate = 1).

This property only works when ielib.dll or ievision.dll is present.

Default is 1.

Specifies the horizontal subsampling when using YCbCr color space.

Alllowed values: 1 for non subsampling, 2 for double subsampling (halves horizontal Cb and Cr channel size).

It is suggested to use YCbCr and at least horizontal subsampling when compressing big images, due to the reduced memory requirements.

Reduction of resulting file size is detectable when lossless compression is used (J2000_Rate = 1).

This property only works when ielib.dll or ievision.dll is present.

Default is 1

Specifies the croma subsampling, influencing the jpeg output quality.

This property is valid only when JPEG_ColorSpace=YCbCr.

Contains the denominator of the scale used to load last jpeg image.

It is used only when JPEG_Scale=AutoCalc.

PDF_PaperHeight specifies the paper height in Adobe PDF points (1 point=1/72 of inch).

Default values are width=595 and height=842 (A4 format).

Common values are:

PDF_PaperWidth x PDF_PaperHeight

A0 2380x3368

A1 1684x2380

A2 1190x1684

A3 842x1190

A4 595x842

A5 421x595

A6 297x421

B5 501x709

letter (8.5"x11") 612x792

Legal (8.5"x14") 612x1008

ledger (17"x11") 1224x792

11"x17" 792x1224

PDF_PaperWidth specifies the paper width in Adobe PDF points (1 point=1/72 of inch).

Default values are width=595 and height=842 (A4 format).

Common values are:

PDF_PaperWidth x PDF_PaperHeight

A0 2380x3368

A1 1684x2380

A2 1190x1684

A3 842x1190

A4 595x842

A5 421x595

A6 297x421

B5 501x709

letter (8.5"x11") 612x792

Legal (8.5"x14") 612x1008

ledger (17"x11") 1224x792

11"x17" 792x1224

PNG_Compression changes how much time PNG-compressor spends on trying to compress the image data.

This property accept values from 0 (no compression) to 9 (best compression).

PS_PaperHeight specifies the paper height in PostScript points (1 point=1/72 of inch).

Default values are width=595 and height=842 (A4 format).

Common values are:

PS_PaperWidth x PS_PaperHeight

A0 2380x3368

A1 1684x2380

A2 1190x1684

A3 842x1190

A4 595x842

A5 421x595

A6 297x421

B5 501x709

letter (8.5"x11") 612x792

Legal (8.5"x14") 612x1008

ledger (17"x11") 1224x792

11"x17" 792x1224

PS_PaperWidth specifies the paper width in PostScript points (1 point=1/72 of inch).

Default values are width=595 and height=842 (A4 format).

Common values are:

PS_PaperWidth x PS_PaperHeight

A0 2380x3368

A1 1684x2380

A2 1190x1684

A3 842x1190

A4 595x842

A5 421x595

A6 297x421

B5 501x709

letter (8.5"x11") 612x792

Legal (8.5"x14") 612x1008

ledger (17"x11") 1224x792

11"x17" 792x1224

If true specifies that we want load the RAW in half size. After you set this property to speed-up loading.

The default is False.

This method resets all EXIF fields. This is useful to remove EXIF info from your files.

However if you want remove all metadata information from the jpegs we suggest to call ResetInfo instead of ResetEXIF.

RemoveIsolatedPixels removes all groups of PixelCount isolated pixels.

This can be used to reduce the size of images.

Gets EXIF_ISOSpeedRatings property.

CCD sensitivity equivalent to Ag-Hr film speedrate.

"0" for all values means "unspecified".

Gets EXIF_PrimaryChromaticities property.

Defines chromaticity of the primaries of the image. If the image uses CCIR Recommendation 709 primaries, the values are '640/1000,330/1000,300/1000,600/1000,150/1000,0/1000'.

"-1" for all values means "unspecified".

Gets EXIF_WhitePoint property.

Same as EXIF_ISOSpeedRatings (0x8827) but data type is unsigned rational.

Only Kodak's digicam uses this tag instead of EXIF_ISOSpeedRatings.

Gets EXIF_YCbCrCoefficients property.

When the image format is YCbCr, this value shows a constant to translate it to RGB format. Usually values are '0.299/0.587/0.114'.

"-1" for all values means "unspecified".

Specifies the byte order of the last loaded image.

This property is readonly, because IEvolution uses always LittleEndian when saves TIFF.

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

This function is useful, for example, in InsertTIFFImageFile 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.

Specified the tile number to load when loading a tiled TIFF file.

-1 (default) means "load all tiles".

IEImage adjustes automatically the image if IOParams.TIFF_EnableAdjustOrientation is true.

Allowed values:

1 = The 0th row represents the visual top of the image, and the 0th column represents the visual left-hand side.

2 = The 0th row represents the visual top of the image, and the 0th column representsthe visual right-hand side.

3 = The 0th row represents the visual bottom of the image, and the 0th column represents the visual right-hand side.

4 = The 0th row represents the visual bottom of the image, and the 0th column represents the visual left-hand side.

5 = The 0th row represents the visual left-hand side of the image, and the 0th column represents the visual top.

6 = The 0th row represents the visual right-hand side of the image, and the 0th column represents the visual top.

7 = The 0th row represents the visual right-hand side of the image, and the 0th column represents the visual bottom.

8 = The 0th row represents the visual left-hand side of the image, and the 0th column represents the visual bottom.

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

A TIFF can contains several pages. You can load image or paramters from a page using TIFF_ImageIndex (or just ImageIndex).

Each page can contain sub images, like a tree, so you can load a specific sub page using TIFF_SubIndex.

This is useful for example to load an embedded Jpeg from a DNG (camera raw format), that is located at first page and second sub index.

Updates EXIF thumbnail with the content of current image.

You should call this method just before save a jpeg to make thumbnail consistent with saved image.

Returns Adobe XMP info loaded from Jpeg, TIFF and PSD file formats.

Adobe XMP is a XML coded string according to Adobe XMP specification updated to January 2004.

IEvolution doesn’t parse the XMP-XML string, so to read single tags you have to write code to parse the XML string.

XMP_Info is also saved back to Jpeg, TIFF and PSD file formats.