ImageEn, unit iexBitmaps

TIOParams


Declaration

TIOParams = class;


Description

Provides access to the properties and meta-data of an image or video file, such as compression type, EXIF, text comments, bits per sample, samples per pixel, etc.
The properties for this class are set when loading an image or can be retrieved (without loading of the image) using LoadFromFile (excluding save-only formats, such as PDF, PS, etc).
You can modify these properties before saving your image (naturally this is only relevant to formats which ImageEn can save, which excludes EMF, WMF, CUR, etc).


Examples

// Convert a PNG to JPEG at 90% quality
ImageEnView1.IO.LoadFromFile('D:\image.png');
ImageEnView1.IO.Params.JPEG_Quality := 90;
ImageEnView1.IO.SaveToFile('D:\output.jpg');

// Save a TIFF with CMYK
ImageEnView1.IO.LoadFromFile('D:\image.tif');
ImageEnView1.IO.Params.TIFF_PhotometInterpret := ioTIFF_CMYK;
ImageEnView1.IO.SaveToFile('D:\image-cmyk.tif');

// Set color-mapped 256 colors
ImageEnView1.IO.Params.BitsPerSample := 8;
ImageEnView1.IO.Params.SamplesPerPixel := 1;

ImageEnView1.IO.Params.TIFF_Compression := ioTIFF_G4FAX;
ImageEnView1.IO.Params.BitsPerSample := 1;
ImageEnView1.IO.Params.SamplesPerPixel := 1;
ImageEnView1.IO.SaveToFile('D:\output.tif');

ImageEnView1.IO.Params.TIFF_Compression := ioTIFF_JPEG;
ImageEnView1.IO.Params.TIFF_JPEGQuality := 85;



General Methods and Properties


General
Public Property  BitsPerSample
Public Property  ColorMapCount
Public Property  ColorMap
Public Property  DefaultICCProfile
Public Property  Dict
Public Property  Dpi
Public Property  DpiX
Public Property  DpiY
Public Property  FileName
Public Property  FileTypeStr
Public Property  FileType
Public Property  Height
Public Property  ImageCount
Public Property  ImageDelayTime
Public Property  ImageEnAnnot
Public Property  ImageInfoStr
Public Property  ImagingAnnot
Public Property  InputICCProfile
Public Property  IsResource
Public Property  NativePixelFormat
Public Property  OutputICCProfile
Public Property  OriginalHeight
Public Property  OriginalWidth
Public Property  SamplesPerPixel
Public Property  Width

Loading Directives
Public Property  AutoScaleImport
Public Property  EnableAdjustOrientation
Public Property  GetMetaData
Public Property  GetThumbnail
Public Property  ImageIndex
Public Property  LoadToHeight
Public Property  LoadToWidth
Public Method  OptimizeLoadingParams

Property Storage Handling
Public Method  AdjustGPSCoordinates
Public Method  Assign
Public Method  ContainsInfo
Public Method  Create
Public Method  LoadFromFile (load stored paramaters)
Public Method  LoadFromStream (load stored paramaters)
Public Method  Read (load paramaters of an image)
Public Method  ReadFrom (Read from TListView, etc.)
Public Method  ResetEXIF
Public Method  ResetInfo
Public Method  SaveToFile (store paramaters)
Public Method  SaveToStream (store paramaters)
Public Method  SetDefaultParams
Public Method  SupportsInfo
Public Method  UpdateEXIFThumbnail
Public Method  WriteTo (Output to TListView, TStrings, etc.)

Meta-Data Methods and Properties


General EXIF Tags (for JPEG, TIFF, PNG and RAW)
Public Property  EXIF_HasEXIFData
Public Property  EXIF_Artist
Public Property  EXIF_Bitmap
Public Property  EXIF_CompressedBitsPerPixel
Public Property  EXIF_Copyright
Public Property  EXIF_DateTime
Public Property  EXIF_DateTime2
Public Property  EXIF_DateTimeOriginal
Public Property  EXIF_DateTimeOriginal2
Public Property  EXIF_DateTimeDigitized
Public Property  EXIF_DateTimeDigitized2
Public Property  EXIF_ExifImageHeight
Public Property  EXIF_ExifImageWidth
Public Property  EXIF_ExifVersion
Public Property  EXIF_ImageDescription
Public Property  EXIF_ImageUniqueID
Public Property  EXIF_InteropIndex
Public Property  EXIF_InteropVersion
Public Property  EXIF_ResolutionUnit
Public Property  EXIF_Software
Public Property  EXIF_UserCommentCode
Public Property  EXIF_UserComment
Public Property  EXIF_XResolution
Public Property  EXIF_XResolution2
Public Property  EXIF_YResolution
Public Property  EXIF_YResolution2

Photographic EXIF Tags (for JPEG, TIFF, PNG and RAW)
Public Property  EXIF_ApertureValue
Public Property  EXIF_ApertureValue2
Public Property  EXIF_BodySerialNumber
Public Property  EXIF_BrightnessValue
Public Property  EXIF_CameraOwnerName
Public Property  EXIF_ColorSpace
Public Property  EXIF_Contrast
Public Property  EXIF_DigitalZoomRatio
Public Property  EXIF_ExposureBiasValue
Public Property  EXIF_ExposureIndex
Public Property  EXIF_ExposureMode
Public Property  EXIF_ExposureProgram
Public Property  EXIF_ExposureTime
Public Property  EXIF_ExposureTime2
Public Property  EXIF_FileSource
Public Property  EXIF_FlashPixVersion
Public Property  EXIF_Flash
Public Property  EXIF_FNumber
Public Property  EXIF_FNumber2
Public Property  EXIF_FocalLength
Public Property  EXIF_FocalLengthIn35mmFilm
Public Property  EXIF_FocalPlaneResolutionUnit
Public Property  EXIF_FocalPlaneXResolution
Public Property  EXIF_FocalPlaneYResolution
Public Property  EXIF_GainControl
Public Property  EXIF_Gamma
Public Property  EXIF_ISOSpeedRatings
Public Property  EXIF_LensMake
Public Property  EXIF_LensModel
Public Property  EXIF_LensSerialNumber
Public Property  EXIF_LightSource
Public Property  EXIF_Make
Public Property  EXIF_MakerNote
Public Property  EXIF_MaxApertureValue
Public Property  EXIF_MaxApertureValue2
Public Property  EXIF_MeteringMode
Public Property  EXIF_Model
Public Property  EXIF_Orientation
Public Property  EXIF_PrimaryChromaticities
Public Property  EXIF_ReferenceBlackWhite
Public Property  EXIF_RelatedSoundFile
Public Property  EXIF_Saturation
Public Property  EXIF_SceneCaptureType
Public Property  EXIF_SceneType
Public Property  EXIF_SensingMethod
Public Property  EXIF_Sharpness
Public Property  EXIF_ShutterSpeedValue
Public Property  EXIF_ShutterSpeedValue2
Public Property  EXIF_SubjectArea
Public Property  EXIF_SubjectDistanceRange
Public Property  EXIF_SubjectDistance
Public Property  EXIF_SubjectLocationX
Public Property  EXIF_SubjectLocationY
Public Property  EXIF_SubsecTimeDigitized
Public Property  EXIF_SubsecTimeOriginal
Public Property  EXIF_SubsecTime
Public Property  EXIF_WhiteBalance
Public Property  EXIF_WhitePoint
Public Property  EXIF_YCbCrCoefficients
Public Property  EXIF_YCbCrPositioning

GPS EXIF Tags (for JPEG, TIFF, PNG and RAW)
Public Property  EXIF_GPSVersionID
Public Property  EXIF_GPSLatitude
Public Property  EXIF_GPSLatitude_Str
Public Property  EXIF_GPSLatitudeRef
Public Property  EXIF_GPSLatitudeDegrees
Public Property  EXIF_GPSLatitudeMinutes
Public Property  EXIF_GPSLatitudeSeconds
Public Property  EXIF_GPSLongitude
Public Property  EXIF_GPSLongitude_Str
Public Property  EXIF_GPSLongitudeRef
Public Property  EXIF_GPSLongitudeDegrees
Public Property  EXIF_GPSLongitudeMinutes
Public Property  EXIF_GPSLongitudeSeconds
Public Property  EXIF_GPSAltitudeRef
Public Property  EXIF_GPSAltitude
Public Property  EXIF_GPSTimeStampHour
Public Property  EXIF_GPSTimeStampMinute
Public Property  EXIF_GPSTimeStampSecond
Public Property  EXIF_GPSSatellites
Public Property  EXIF_GPSStatus
Public Property  EXIF_GPSMeasureMode
Public Property  EXIF_GPSDOP
Public Property  EXIF_GPSSpeedRef
Public Property  EXIF_GPSSpeed
Public Property  EXIF_GPSTrackRef
Public Property  EXIF_GPSTrack
Public Property  EXIF_GPSImgDirectionRef
Public Property  EXIF_GPSImgDirection
Public Property  EXIF_GPSMapDatum
Public Property  EXIF_GPSDestLatitudeRef
Public Property  EXIF_GPSDestLatitudeDegrees
Public Property  EXIF_GPSDestLatitudeMinutes
Public Property  EXIF_GPSDestLatitudeSeconds
Public Property  EXIF_GPSDestLongitudeRef
Public Property  EXIF_GPSDestLongitudeDegrees
Public Property  EXIF_GPSDestLongitudeMinutes
Public Property  EXIF_GPSDestLongitudeSeconds
Public Property  EXIF_GPSDestBearingRef
Public Property  EXIF_GPSDestBearing
Public Property  EXIF_GPSDestDistanceRef
Public Property  EXIF_GPSDestDistance
Public Property  EXIF_GPSDateStamp

Windows EXIF Tags (for JPEG, TIFF, PNG and RAW)
Public Property  EXIF_XPAuthor
Public Property  EXIF_XPComment
Public Property  EXIF_XPKeywords
Public Property  EXIF_XPRating
Public Property  EXIF_XPSubject
Public Property  EXIF_XPTitle

IPTC Tags (for JPEG and TIFF)
Public Property  IPTC_Info
Public Method  IPTC_Photoshop
Public Method  ReadIPTCField
Public Method  WriteIPTCField
Public Method  ClearIPTCField

Adobe XMP Info (for JPEG, TIFF, PNG and PSD)
Public Property  XMP_Info


Format-Specific Properties

Adobe PDF
Public Property  PDF_Author
Public Property  PDF_Compression
Public Property  PDF_Creator
Public Property  PDF_CreateDate
Public Property  PDF_FileVersion
Public Property  PDF_ImageOptions
Public Property  PDF_Keywords
Public Property  PDF_ModifyDate
Public Property  PDF_PageMargin
Public Property  PDF_PaperHeight
Public Property  PDF_PaperWidth
Public Property  PDF_PaperLayout
Public Property  PDF_PaperSize
Public Property  PDF_Producer
Public Property  PDF_Subject
Public Property  PDF_Title

Adobe PSD
Public Property  PSD_HasPremultipliedAlpha
Public Property  PSD_HasMergedImage
Public Property  PSD_LargeDocumentFormat
Public Property  PSD_LoadLayers
Public Property  PSD_ReplaceLayers
Public Property  PSD_SelectLayer

AVI
Public Property  AVI_FrameCount
Public Property  AVI_FrameDelayTime

BMP
Public Property  BMP_Compression
Public Property  BMP_HandleTransparency
Public Property  BMP_Version

BmpRaw (not for camera Raw files)
Public Property  BMPRAW_DataFormat
Public Property  BMPRAW_ChannelOrder
Public Property  BMPRAW_HeaderSize
Public Property  BMPRAW_Planes
Public Property  BMPRAW_RowAlign

Camera Raw (Camera Digital Images)
Public Property  RAW_AutoAdjustColors
Public Property  RAW_AutoBright
Public Property  RAW_BlueScale
Public Property  RAW_Bright
Public Property  RAW_Camera
Public Property  RAW_FourColorRGB
Public Property  RAW_Gamma
Public Property  RAW_GammaToeSlope
Public Property  RAW_GetEmbeddedJpeg
Public Property  RAW_EmbeddedJpegLoading
Public Property  RAW_EmbeddedJpegMinHeight
Public Property  RAW_EmbeddedJpegMinWidth
Public Property  RAW_FallbackToEmbeddedJpeg
Public Property  RAW_GetExifThumbnail
Public Property  RAW_HalfSize
Public Property  RAW_Highlight
Public Property  RAW_Interpolation
Public Property  RAW_OutputColorSpace
Public Property  RAW_QuickInterpolate
Public Property  RAW_RedScale
Public Property  RAW_UseAutoWB
Public Property  RAW_UseCameraWB
Public Property  RAW_UserWhiteBalance

Cursors
Public Property  CUR_Background
Public Property  CUR_ImageIndex
Public Property  CUR_XHotSpot
Public Property  CUR_YHotSpot

Dicom
Public Property  DICOM_Compression
Public Property  DICOM_ContainsImage
Public Property  DICOM_FrameTime
Public Property  DICOM_J2000Rate
Public Property  DICOM_JPEGQuality
Public Property  DICOM_Range
Public Property  DICOM_Tags
Public Property  DICOM_WindowCenter
Public Property  DICOM_WindowCenterOffset
Public Property  DICOM_WindowWidth

GIF
Public Property  GIF_Action
Public Property  GIF_Background
Public Property  GIF_Comments
Public Property  GIF_DelayTime
Public Property  GIF_FlagTranspColor
Public Property  GIF_ImageCount
Public Property  GIF_ImageIndex
Public Property  GIF_Interlaced
Public Property  GIF_Ratio
Public Property  GIF_RAWLoad
Public Property  GIF_TranspColor
Public Property  GIF_Version
Public Property  GIF_WinHeight
Public Property  GIF_WinWidth
Public Property  GIF_XPos
Public Property  GIF_YPos

Icons
Public Property  ICO_Background
Public Property  ICO_BitCount
Public Property  ICO_Format
Public Property  ICO_ImageIndex
Public Property  ICO_Sizes

IEN (ImageEn native image format with layers)
Public Property  IEN_Compression
Public Property  IEN_Description
Public Property  IEN_GetThumbnail
Public Property  IEN_LayerCount
Public Property  IEN_SaveAsVersion
Public Property  IEN_StoreBackground
Public Property  IEN_Version

JPEG
Public Property  JPEG_ColorSpace
Public Property  JPEG_DCTMethod
Public Property  JPEG_CromaSubsampling
Public Property  JPEG_EnableAdjustOrientation
Public Property  JPEG_GetExifThumbnail
Public Property  JPEG_MarkerList
Public Property  JPEG_OptimalHuffman
Public Property  JPEG_Progressive
Public Property  JPEG_Quality
Public Property  JPEG_Scale_Used
Public Property  JPEG_Scale
Public Property  JPEG_Smooth
Public Property  JPEG_WarningCode
Public Property  JPEG_WarningTot

JPEG 2000
Public Property  J2000_ColorSpace
Public Property  J2000_Quality
Public Property  J2000_Rate
Public Property  J2000_Reduce
Public Property  J2000_ScalableBy
Public Property  J2000_SubSamplingH
Public Property  J2000_SubSamplingV

MediaFile (AVI, MPEG, WMV, etc)
Public Property  MEDIAFILE_FrameCount
Public Property  MEDIAFILE_FrameDelayTime

Heif, WebP and Microsoft HD Photos/JPEG XR (WDP/JXR/HDP)
Public Property  HDP_ImageQuality
Public Property  HDP_Lossless

PNG
Public Property  PNG_Background
Public Property  PNG_Chunks
Public Property  PNG_Compression
Public Property  PNG_Filter
Public Property  PNG_Interlaced
Public Property  PNG_TextKeys
Public Property  PNG_TextValues

PostScript (PS)
Public Property  PS_Compression
Public Property  PS_PaperHeight
Public Property  PS_PaperWidth
Public Property  PS_PaperSize
Public Property  PS_Title

Scalable Vector Graphics (SVG)
Public Property  SVG_ImageCompression
Public Property  SVG_TagCount
Public Property  SVG_Title

Targa (TGA)
Public Property  TGA_AspectRatio
Public Property  TGA_Author
Public Property  TGA_Background
Public Property  TGA_Compressed
Public Property  TGA_Date
Public Property  TGA_Descriptor
Public Property  TGA_Gamma
Public Property  TGA_GrayLevel
Public Property  TGA_ImageName
Public Property  TGA_XPos
Public Property  TGA_YPos

TIFF
Public Property  TIFF_BigTIFF
Public Property  TIFF_ByteOrder
Public Property  TIFF_Compression
Public Property  TIFF_DocumentName
Public Property  TIFF_EnableAdjustOrientation
Public Property  TIFF_GetTile
Public Property  TIFF_FillOrder
Public Property  TIFF_ImageCount
Public Property  TIFF_ImageDescription
Public Property  TIFF_ImageIndex
Public Property  TIFF_NewSubfileType
Public Property  TIFF_JPEGColorSpace
Public Property  TIFF_JPEGQuality
Public Property  TIFF_Orientation
Public Property  TIFF_PageCount
Public Property  TIFF_PageName
Public Property  TIFF_PageNumber
Public Property  TIFF_PhotometInterpret
Public Property  TIFF_PhotoshopImageResources
Public Property  TIFF_PhotoshopImageSourceData
Public Property  TIFF_PlanarConf
Public Property  TIFF_SubIndex
Public Property  TIFF_StripCount
Public Property  TIFF_XPos
Public Property  TIFF_YPos
Public Property  TIFF_ZIPCompression

Windows Images (such as HEIF/HEIC, DirectDraw Surface, etc)
Public Property  WIC_CodecInfo

Other Formats
Public Property  PCX_Compression
Public Property  PCX_Version
Public Property  PXM_Comments



See Also

TImageEnIO.Params
TIEBitmap.Params
TIEMultiBitmap.Params
TImageEnMIO.Params