IOParams class contains input/output parameters for image file formats

Namespace: HiComponents.IEvolution
Assembly: IEvolution2 (in IEvolution2.dll) Version: 10.0.0.0

Syntax

         
 C#  Visual Basic  Visual C++ 
public class IOParams
Public Class IOParams
public ref class IOParams

Members

            
 All Members  Fields   Properties   Methods  
 Public

 Protected
 Instance

 Static 
 Declared

 Inherited
 XNA Framework Only 

 .NET Compact Framework Only 

 MemberDescription
AVI_FrameCount
Specifies how many frames contains last loaded AVI file
AVI_FrameDelayTime
AVI_FrameDelayTime is the time in milliseconds the image will be showed on playing.
BitsPerSample
Bits number each sample has.

Values handles are:

1 for black/white

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

8 for colormapped or true color

BMP_Compression

Specifies compression method.

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

BMP_HandleTransparency

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.

BMP_Version
Specifies version of the BMP file
BMPRAW_ChannelOrder
Specifies the channels order for a RAW file. It can be RGB or BGR and it is valid only for color images.
BMPRAW_DataFormat

Specifies the next input/output data format.

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

BMPRAW_HeaderSize
Specifies the header size in bytes. The header will be bypassed.
BMPRAW_Planes
Specifies how channels are disposed.
BMPRAW_RowAlign
Specifies the row align in bits.
CUR_Background
CUR_Background is the background color where to merge loaded image. Applications should set this property before load images.
CUR_ImageIndex
The index (from 0) of the image. A CUR file can contains multple images inside.
CUR_XHotSpot
The hot spot point of the cursor image.
CUR_YHotSpot
The hot spot point of the cursor image.
DCX_ImageIndex
Specifies the image index (0=first page) to load for a DCX file.
DICOM_Compression
The compression used for a DICOM file.
DICOM_ContainsImage
Returns true if the DICOM contains tags only (no image). Default: True
DICOM_Info
Contains DICOM information object
DICOM_J2000Rate
Specifies the compression rate to use when saving a DICOM file as JPEG 2000. Allowed values are from 0 to 1, where 1 is no compression (lossless mode).
DICOM_JPEGQuality
Specifies the quality factor (ranging from 1 to 100) to use when saving a DICOM file as a lossy JPEG. Higher values improve image quality but require more disk space.
DICOM_Range
Specifies how to handle the pixels visibility range.
DICOM_RescaleIntercept
DICOM_RescaleSlope
DICOM_WindowCenter
Undocumented
DICOM_WindowCenterOffset
Returns the calculated offset of the window center.
DICOM_WindowWidth
Undocumented
Dict
Contains a dictionary of additional properties.
DpiX
DpiX is the number of horizontal dots (pixels) per inch of the image.
DpiY
DpiY is the number of vertical dots (pixels) per inch of the image.
EnableAdjustOrientation

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.

Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
EXIF_ApertureValue
The actual aperture value of lens when the image was taken. Unit is APEX. To convert this value to ordinary F-number (F-stop), calculate this value's power of root 2 (=1.4142). For example, if the ApertureValue is '5', F-number is 1.41425 = F5.6.
EXIF_Artist
Specifies the EXIF artist.
EXIF_BrightnessValue

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.

EXIF_ColorSpace

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.

EXIF_CompressedBitsPerPixel
The average compression ratio of JPEG (rough estimate)
EXIF_Contrast

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

0 = Normal

1 = Soft

2 = Hard

EXIF_Copyright
Shows copyright information
EXIF_DateTime

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

EXIF_DateTimeDigitized

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.

EXIF_DateTimeOriginal

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_DigitalZoomRatio
This tag indicates the digital zoom ratio when the image was shot. If the numerator of the recorded value is 0, this indicates that digital zoom was not used.
EXIF_ExifVersion

Exif version number.

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

EXIF_ExposureBiasValue
Exposure bias(compensation) value of taking picture. Unit is APEX(EV).
EXIF_ExposureIndex
Same as ISOSpeedRatings(0x8827) but data type is unsigned rational. Only Kodak's digicam uses this tag instead of ISOSpeedRating.
EXIF_ExposureMode

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

EXIF_ExposureProgram
Exposure program that the camera used when image was taken
EXIF_ExposureTime
Exposure time (reciprocal of shutter speed). Unit is second.
EXIF_FileSource
Indicates the image source. Value "3" means the image source is digital still camera.
EXIF_Flash
The flash type
EXIF_FlashPixVersion
Stores FlashPix version. If the image data is based on FlashPix formar Ver.1.0, value is "0100".
EXIF_FNumber
The actual F-number(F-stop) of lens when the image was taken.
EXIF_FocalLength
Focal length of lens used to take image. Unit is millimeter.
EXIF_FocalLengthIn35mmFilm
This tag indicates the equivalent focal length assuming a 35mm film camera, in mm. A value of 0 means the focal length is unknown. Note that this tag differs from the FocalLength tag.
EXIF_FocalPlaneResolutionUnit
Unit of FocalPlaneXResoluton/FocalPlaneYResolution.
EXIF_FocalPlaneXResolution
Pixel density at CCD's position. If you have MegaPixel digicam and take a picture by lower resolution(e.g.VGA mode), this value is re-sampled by picture resolution. In such case, FocalPlaneResolution is not same as CCD's actual resolution.
EXIF_FocalPlaneYResolution
Pixel density at CCD's position. If you have MegaPixel digicam and take a picture by lower resolution(e.g.VGA mode), this value is re-sampled by picture resolution. In such case, FocalPlaneResolution is not same as CCD's actual resolution.
EXIF_GainControl

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

EXIF_GPSAltitude
Indicates the altitude in meters.
EXIF_GPSDateStamp
GPS date.
EXIF_GPSDestBearing
Indicates the bearing to the destination point. The range of values is from 0.00 to 359.99.
EXIF_GPSDestBearingRef
Indicates the reference used for giving the bearing to the destination point. 'T' denotes true direction and 'M' is magnetic direction.
EXIF_GPSDestDistance
Distance to destination.
EXIF_GPSDestLatitude
Indicates the latitude of the destination point.
EXIF_GPSDestLongitude
Indicates the longitude of the destination point.
EXIF_GPSDOP

Indicates the GPS DOP (data degree of precision).

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

EXIF_GPSImgDirection
Indicates the direction of the image when it was captured.
EXIF_GPSLatitude
Indicates the latitude.
EXIF_GPSLongitude
Indicates the longitude.
EXIF_GPSMapDatum

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'.

EXIF_GPSMeasureMode
Indicates the GPS measurement mode. '2' means two-dimensional measurement and '3' means three-dimensional measurement is in progress.
EXIF_GPSSatellites

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.

EXIF_GPSSpeed
Indicates the speed of GPS receiver movement.
EXIF_GPSStatus
Indicates the status of the GPS receiver when the image is recorded. 'A' means measurement is in progress, and 'V' means the measurement is Interoperability.
EXIF_GPSTimeStampHour
Indicates the time as UTC (Coordinated Universal Time).
EXIF_GPSTimeStampMinute
Indicates the time as UTC (Coordinated Universal Time).
EXIF_GPSTimeStampSecond
Indicates the time as UTC (Coordinated Universal Time).
EXIF_GPSTrack
Indicates the direction of GPS receiver movement. The range of values is from 0.00 to 359.99.
EXIF_GPSTrackRef
Indicates the reference for giving the direction of GPS receiver movement. 'T' denotes true direction and 'M' is magnetic direction.
EXIF_GPSVersionID
Indicates the version of GPSInfoIFD.
EXIF_HasEXIFData

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.

EXIF_ImageDescription
Describes the image
EXIF_ImageHeight
Height of the main image
EXIF_ImageUniqueID
This tag indicates an identifier assigned uniquely to each image. It is recorded as an ASCII string equivalent to hexadecimal notation and 128-bit fixed length.
EXIF_ImageWidth
Width of the main image
EXIF_ISOSpeedRatings(Int32)

Sets EXIF_ISOSpeedRatings property.

CCD sensitivity equivalent to Ag-Hr film speedrate.

"0" for all values means "unspecified".

EXIF_LightSource
Light source, actually this means white balance setting.
EXIF_Make
The manufacturer of the recording equipment. This is the manufacturer of the DSC, scanner, video digitizer or other equipment that generated the image.
EXIF_MakerNote
EXIF_MakerNote contains maker specific information. Unfortunately there is a standard for this tag, then we a general handler which read the IFD (when present) of the maker note.
EXIF_MaxApertureValue
Maximum aperture value of lens. You can convert to F-number by calculating power of root 2 (same process of ApertureValue).
EXIF_MeteringMode
Exposure metering method.
EXIF_Model
Shows model number of digicam
EXIF_Orientation
The orientation of the camera relative to the scene, when the image was captured
EXIF_ReferenceBlackWhite(Int32, Double)

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".

EXIF_RelatedSoundFile
If this digicam can record audio data with image, shows name of audio data.
EXIF_ResolutionUnit
Unit of XResolution/YResolution
EXIF_Saturation

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

EXIF_SceneCaptureType

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

EXIF_SceneType
Indicates the type of scene. Value "1" means that the image was directly photographed.
EXIF_SensingMethod
Shows type of image sensor unit. "2" means 1 chip color area sensor, most of all digicam use this type.
EXIF_Sharpness

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

0 = Normal

1 = Soft

2 = Hard

EXIF_ShutterSpeedValue
Shutter speed by APEX value. To convert this value to ordinary 'Shutter Speed'; calculate this value's power of 2, then reciprocal. For example, if the ShutterSpeedValue is '4', shutter speed is 1/(24)=1/16 second.
EXIF_Software
Shows firmware(internal software of digicam) version number
EXIF_SubjectDistance
Distance to focus point, unit is meter.
EXIF_SubjectDistanceRange

This tag indicates the distance to the subject.

0 = unknown

1 = Macro

2 = Close view

3 = Distant view

EXIF_SubsecTime

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"

EXIF_SubsecTimeDigitized

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"

EXIF_SubsecTimeOriginal

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"

EXIF_UserComment
EXIF_UserComment is a tag to write keywords or comments on the image besides those in EXIF_ImageDescription, and without the character code limitations of the EXIF_ImageDescription tag.
EXIF_WhiteBalance

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

0 = Auto white balance

1 = Manual white balance

EXIF_XPAuthor
Specifies Windows XP image author. This is shown in properties of jpeg/tiff file under Windows XP.
EXIF_XPComment
Specifies Windows XP image comment. This is shown in properties of jpeg/tiff file under Windows XP.
EXIF_XPKeywords
Specifies Windows XP image keywords. This is shown in properties of jpeg/tiff file under Windows XP.
EXIF_XPRating

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.

EXIF_XPSubject
Specifies Windows XP image subject. This is shown in properties of jpeg/tiff file under Windows XP.
EXIF_XPTitle
Specifies Windows XP image title. This is shown in properties of jpeg/tiff file under Windows XP.
EXIF_XResolution
Display/Print resolution of image. Default value is 1/72inch, but it has no mean because personal computer doesn't use this value to display/print out.
EXIF_YCbCrPositioning
When image format is YCbCr and uses 'Subsampling' (cropping of chroma data, all the digicam do that), defines the chroma sample point of subsampling pixel array.
EXIF_YResolution
Display/Print resolution of image. Default value is 1/72inch, but it has no mean because personal computer doesn't use this value to display/print out.
FileFormat
FileType is the last loaded/saved file type.
FileFormatDescription
Returns a textual description of the file type contained in FileType property and other file format specific properties.
FileName
File name of the last loaded or saved image.
Finalize()()()()
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
GetEXIF_PrimaryChromaticities(Int32)

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".

GetEXIF_ReferenceBlackWhite(Int32)

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".

GetEXIF_WhitePoint(Int32)

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.

GetEXIF_YCbCrCoefficients(Int32)

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".

GetHashCode()()()()
Serves as a hash function for a particular type.
(Inherited from Object.)
GetProperty(String)
Gets a property using its string representation.
GetThumbnail

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.

GetType()()()()
Gets the Type of the current instance.
(Inherited from Object.)
GIF_Background

GIF_Background is the background color of the GIF.

This color should exist in the image.

GIF_DelayTime
GIF_DelayTime is the time (in 1/100 s) the frame remains showed.
GIF_HasTransparentColor
If True the GIF_TransparentColor color is valid (the image has a transparency color).
GIF_ImageCount
Specifies the image count of the last GIF loaded.
GIF_ImageIndex
The index (from 0) of the image.
GIF_Interlaced
If true the image is interlaced.
GIF_Ratio
Aspect ratio. Width/Height = (Ratio+15)/64
GIF_TransparentColor

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

This color should exist in the image.

GIF_Version
GIF_Version can be GIF89a or GIF87a
GIF_WinHeight
GIF_WinHeight is the height of the window where GIF is showed.
GIF_WinWidth
GIF_WinWidth is the width of the window where GIF is showed.
GIF_XPos
GIF_XPos is the top-left X coordinate where the frame will be showed.
GIF_YPos
GIF_YPos is the top-left Y coordinate where the frame will be showed.
HDP_ImageQuality

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.

HDP_Lossless

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

The default value is false.

Height
The last loaded image height
ICO_Background
ICO_Background is the background color where to merge loaded image. Applications should set this property before load images
ICO_Format
Specifies the compression for ICO file format. Default is : ICOFormat.ICO (uncompressed)
ICO_ImageIndex
The index (from 0) of the image. An ICO file can contains multple images inside.
ImageCount
ImageCount returns the number of page/images/frames founds inside the last loaded file. This property is valid for all file formats.
ImageIndex

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..

ImagingAnnotations

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.

IPTC_Info
Contains IPTC information object
IsResource

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.

J2000_Quality
Specifies the resulting quality of the compressed image. This is an alternative way to specify the resulting file size and image quality other than J2000_Rate. Setting a value less than 100 actually disables J2000_Rate action. Default: 100
J2000_Rate

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

Sample value: 0.015

J2000_Reduce

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

J2000_SubSamplingH

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.

J2000_SubSamplingV

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

JPEG_ColorSpace
Specify the saved/loaded color space.
JPEG_CromaSubsampling

Specifies the croma subsampling, influencing the jpeg output quality.

This property is valid only when JPEG_ColorSpace=YCbCr.

JPEG_DCTMethod
Specify the DCT method.
JPEG_EnableAdjustOrientation
If you set this property to True before load a Jpeg which contains EXIF information, the image will be automatically orientated.
JPEG_GetExifThumbnail
Setting this property to True means that you want a thumbnail instead of the full image. This works only if a thumbnail is present in EXIF fields.
JPEG_Markers
Contains JPEG markers
JPEG_OptimalHuffman
Specifies if jpeg compressor have to use an optimal huffman table (more compression), instead standard table.
JPEG_OriginalHeight
JPEG_OriginalHeight specifies the original height when the jpeg image is scaled (using JPEG_Scale).
JPEG_OriginalWidth
JPEG_OriginalWidth specifies the original width when the jpeg image is scaled (using JPEG_Scale).
JPEG_Progressive
Specifies if this is a progressive jpeg.
JPEG_Quality
Quality factor, from 1 to 100. The higher the value, the better the image quality, and the larger resultant memory needed.
JPEG_Scale
Description JPEG_Scale defines the sizes of loaded JPEG image. This proprety affects the loading speed.
JPEG_Smooth
Smoothing factor (0 is none, 100 is max). If JPEG_Smooth is not zero, the jpeg compressor smooth the image before compress it. This improves compression.
JPEG_UsedScale

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

It is used only when JPEG_Scale=AutoCalc.

JPEG_WarningCode
JPEG_WarningCode is the last warning code encountered during loading a Jpeg.
JPEG_WarningTot
JPEG_WarningTot is the count of all warnings encountered during loading a Jpeg. We suggest to use Aborting to see if the image is corrupted.
Load(Stream)
Loads input/output parameters.
Load(String)
Loads input/output parameters.
MEDIAFILE_FrameCount
Specifies the number of frames of last loaded media file (using OpenMediaFile).
MEDIAFILE_FrameDelayTime
MEDIAFILE_FrameDelayTime is the time in milliseconds the image will be shown on playing.
MemberwiseClone()()()()
Creates a shallow copy of the current Object.
(Inherited from Object.)
OriginalHeight
OriginalWidth specifies the original height when an image is scaled during loading.
OriginalWidth
OriginalWidth specifies the original width when an image is scaled during loading.
PCX_Compression
PCX_Compression is the compression type for PCX image format.
PCX_Version
PCX version (5 is the default).
PDF_Author
Specifies the name of the person who created the document.
PDF_Compression
PDF_Compression specifies the compression filter for an Adobe PDF file.
PDF_Creator
Specifies the name of the application that created the original document.
PDF_Keywords
Specifies the keywords associated with the document.
PDF_PaperHeight

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

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

PDF_Producer
Specifies the name of the application that converted the image to PDF.
PDF_Subject
Specifies the subject of the document.
PDF_Title
Specifies the PDF document’s title.
PNG_Background
Specifies the background color of the image.
PNG_Compression

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).

PNG_Filter
Set the filter to apply. This can have a significant impact on the size and encoding speed and a somewhat lesser impact on the decoding speed of an image.
PNG_Interlaced
If true the image is interlaced.
PS_Compression
PS_Compression specifies the compression filter for a PostScript file.
PS_PaperHeight

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

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

PS_Title
PS_Title specifies the title of the PostScript file.
PSD_LoadLayers
If true discards the merged image and load only separated layers. If false (default) loads only the merged image.
PSD_ReplaceLayers
If true current layers are replaced by the content of PSD file, otherwise the PSD file content is append to existing layers.
RAW_AutoAdjustColors
If True ImageEn applies an algorithm to adjust image colors. This works only when the RAW file contains an EXIF thumbnails with correct colors, because IEvolution gets right colors from the thumbnail.
RAW_Bright
This property specifies the brightness value used when loading the RAW.
RAW_Camera
Returns the camera descriptor.
RAW_ExtraParams
Specifies extra parameters for external raw plugins (dcraw).
RAW_Gamma
This property specifies the gamma used when loading the RAW.
RAW_GetEmbeddedJpeg
If enabled, ImageEn will load the embedded JPEG if it exists. Many RAW formats include an embedded JPEG for a quick preview image. If there is no embedded JPEG, the full size raw image will be loaded.
RAW_HalfSize

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.

RAW_QuickInterpolate
If True uses quick, low-quality color interpolation. Default True.
RAW_UseAutoWB
If True uses automatic white balance. Default False.
RAW_UseCameraWB
If True uses camera white balance, if possible. Default False.
ResetEXIF()()()()

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.

ResetInfo(Int32)

RemoveIsolatedPixels removes all groups of PixelCount isolated pixels.

This can be used to reduce the size of images.

RstAnnotations
Clears annotations
RstDicomTags
Resets DICOM tags
RstEXIF
Clears EXIF info
RstICC
Resets ICC profiles
RstIPTC
Cleras IPTC info
RstJPEGMarkers
Clear jpeg markers. Resets DICOM_Tags and DICOM position info
RstOtherTextMeta
Clears GIF_Comments, PNG_TextKeys, PNG_TextValues, TIFF_DocumentName, TIFF_ImageDescription, TIFF_PageName, TGA_Author, TGA_Descriptor, TGA_ImageName, PXM_Comments
RstXMP
Clears XMP info
SamplesPerPixel
Samples for each pixel. This property can be only 1 for colormapped images or 3 for true color image.
Save(Stream)
Saves input/output parameters.
Save(String)
Saves input/output parameters.
SetEXIF_ISOSpeedRatings(Int32, Int32)

Gets EXIF_ISOSpeedRatings property.

CCD sensitivity equivalent to Ag-Hr film speedrate.

"0" for all values means "unspecified".

SetEXIF_PrimaryChromaticities(Int32, Double)

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".

SetEXIF_WhitePoint(Int32, Double)

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.

SetEXIF_YCbCrCoefficients(Int32, Double)

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".

SetProperty(String, String)
Sets a property using its string representation.
SetToDefaultValues()()()()
Restores default parameters.
TGA_AspectRatio
TGA_AspectRatio contains the pixel aspect ratio (pixel width/height) of the TGA image
TGA_Author
TGA_Author contains the author name of the TGA file.
TGA_Background
TGA_Background contains the image background (or transparency) color.
TGA_Compressed
Set TGA_Compressed property to true to compress TGA image (RLE compression).
TGA_Descriptor
TGA_Descriptor contains the descriptor of the TGA file.
TGA_Gamma
TGA_Gamma contains the gamma value of the TGA image
TGA_GrayLevel
If TGA_GrayLevel is true the image will be saved as gray levels.
TGA_ImageName
TGA_ImageName contains the image name of the TGA file.
TGA_XPos
TGA_XPos is the top-left X coordinate where the image will be showed (not used by IEImage).
TGA_YPos
TGA_YPos is the top-left Y coordinate where the image will be showed (not used by IEImage).
TIFF_ByteOrder

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.

TIFF_Compression
Specifies the compression type for TIFF image format.
TIFF_DocumentName
The name of the document from which this image was scanned.
TIFF_EnableAdjustOrientation
When TIFF_EnableAdjustOrientation is true IEImage rotates loaded image as specified in the TIFF file. (default true).
TIFF_GetTile

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

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

TIFF_ImageCount
Specifies the image count of the last TIFF loaded.
TIFF_ImageDescription
A string that describes the subject of the image.
TIFF_ImageIndex
TIFF_ImageIndex is the index (from 0) of the image.
TIFF_JPEGQuality
TIFF_JPEGQuality is a quality factor, from 1 to 100 for TIFF compressed as JPEG. The higher the value, the better the image quality and the larger amount of memory needed.
TIFF_Orientation
The orientation of the original image.

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.

TIFF_PageCount
Number of pages in TIFF file.
TIFF_PageName
The name of the page from which this image was scanned.
TIFF_PageNumber
The page number of the page from which this image was scanned.
TIFF_PhotometInterpret
Specifies the photometric interpretation
TIFF_PlanarConf
Specifies how the components of each pixel are stored.
TIFF_SubIndex

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.

TIFF_XPos
X top-left position of the original scanned image.
TIFF_YPos
Y top-left position of the original scanned image.
TIFF_ZIPCompression
Specifies the compression level to be used when compression is TIFF_ZIP.
ToString()()()()
Returns a string that represents the current object.
(Inherited from Object.)
UpdateEXIFThumbnail()()()()

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.

Width
The last loaded image width
XMP_Info

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.

Inheritance Hierarchy

System..::..Object
  HiComponents.IEvolution..::..IOParams

See Also