|
- Correspondence between tags and constants
- Managing errors
ImageInfoModify (Function) In french: ImageInfoModifie Modifies the value of an Exif tag for the image used. Remarks: - The Exif (EXchangeable Image File) information is included in the image file. This standard defines a set of tags used to store information about the image: date, width, orientation, camera model, shutter speed, distance, exposure time, ...
- If the specified Exif tag does not exist for the image used, this tag is added to the image.
- Some specific tags (the "Offsets" for instance) cannot be modified. In this case, the modification is ignored (<Result> = False).
ImgPath is string = "C:\My Images\MyImage.JPG"
// Modify the copyright
// This tag exists. The current type of this tag will be used
ImageInfoModify(ImgPath, imgCopyright, "PC Soft " + Today())
// Save the modification
ImageInfoSave(ImgPath)
// Close the image file
ImageInfoClose(ImgPath)
// Modify the comments of the JPEG image
// displayed in the "IMG_MyImageControl" control
// The "imgComment" tag will be added if it does not exist.
// The "ExifString" type will be automatically deduced
// from the string containing the comments
ImageInfoModify(IMG_MyImageControl, imgComment, "Coral Reef")
// Save the modification
ImageInfoSave(IMG_MyImageControl, "C:\Diving\Coral1.JPG")
ImgPath is string = "C:\My Images\Dog1.JPG"
// Modify the focal
// If this tag does not exist, the value of the focal
// will be saved as a signed rational
// If this tag exists, the current type of this
// tag will be used
ImageInfoModify(ImgPath, imgFAperture, 2.8, ExifRational)
// Save the modification
ImageInfoSave(ImgPath)
// Close the image file
ImageInfoClose(ImgPath)
Syntax
<Result> = ImageInfoModify(<Image> , <Tag> , <New value> [, <Type of Tag>])
<Result>: Boolean - True if the modification was performed,
- False otherwise.
<Image>: Character string (with or without quotes) Image to use. This image can correspond to:- an image file (JPEG format): specify the name and the full (or relative) path of the file. A UNC path can be used.
In this case, the file must be closed by ImageInfoClose. - an image displayed in an Image control: specify the name of the Image control. If this image is not in JPEG format, this image will be automatically converted to this format during its backup (ImageInfoSave or dSaveImageJPEG).
- an image (JPEG format) found in an image memo: specify this image memo.
- an image (JPEG format) found in a binary string: specify this binary string.
<Tag>: Constant or integer Tag whose value must be modified. This tag can correspond to:- an integer given by ImageInfoList.
- a WLanguage constant. See "Correspondence between tags and constants" for more details.
<New value>: Type of the value of the tag to modify New value for the specified tag. <Type of Tag>: Optional integer constant Type in which the value of the tag will be saved: | | | ExifBinary | Binary string | | ExifString | ASCII character string | | ExifInteger4 | Signed 4-byte integer | | ExifUInteger1 | Unsigned 1-byte integer | | ExifUInteger2 | Unsigned 2-byte integer | | ExifUInteger4 | Unsigned 4-byte integer | | ExifRational | Signed rational | | ExifURational | Unsigned rational |
If the modified tag already exists for the image used, this parameter will be ignored and the current type of the modified tag will be used.If the modified tag does not exist for the image used, we advise you to specify the tag type. Otherwise, the default type will be automatically deduced from <New Value>. Remarks Correspondence between tags and constants The table below presents the correspondence between tags and WLanguage constants. | | | | Tag | WLanguage constant | Value |
|---|
| 37510 | imgComment | Character string
Comments about the image | | 37122 | imgCompression | Real
Compression of the image in bits/pixel | | 33432 | imgCopyright | Character string
Image Copyright | | 306 | imgDate | Date
Date and time of the image in YYYY:MM:DD HH:MM:SS format | | 270 | imgDescription | Character string
Image description | | 37382 | imgSubjectDistance | Real
Distance from the subject in meters | | 37380 | imgExposureBias | Real
Exposure bias in APEX | | 37385 | imgFlash | Integer
Status of the flash during the shot: - 0: Flash off.
- 1: Flash on.
- 5: Flash on and light not detected.
- 7: Flash on and light detected.
| | 928 | imgHeight | Integer
Height of image in pixels | | 672 | imgWidth | Integer
Width of image in pixels | | 305 | imgRecordingSoftware | Character string
Name of the software that was used to record the image. | | 37386 | imgFocalLength | Real
Focal length in millimeters. | | 37379 | imgBrightness | Real
Brightness of the image in APEX. | | 271 | imgDeviceMark | Character string
Mark of the camera that took the photo. | | 272 | imgDeviceModel | Character string
Model of camera that took the photo. | | 37383 | imgMeteringMode | Integer
Metering mode: - 0: unknown.
- 1: average.
- 2: average centered.
- 3: point.
- 4: multipoint.
- 5: pattern.
- 6: partial.
- 7 to 254: reserved.
- 255: other.
| | 37500 | imgManufacturerNote | Character string
Name of the camera manufacturer | | 274 | imgOrientation | Integer
Orientation of the image: - 1 to 4: landscape.
- 5 to 8: portrait.
| | 37378 | imgAperture | Real
Aperture in APEX. | | 33437 | imgFAperture | Real
Focal | | 37381 | imgMaxAperture | Real
Maximum aperture in APEX | | 34850 | imgExposureProgram | Integer
Exposure mode used during the shot:- 0: undefined.
- 1: manual.
- 2: normal.
- 3: priority to aperture.
- 4: priority to speed.
- 5: creation.
- 6: action.
- 7: close-up portrait without background.
- 8: landscape.
- 9 to 255: others.
| | 282 | imgXResolution | Real
Horizontal resolution of the image | | 283 | imgYResolution | Real
Vertical resolution of the image | | 37384 | imgLightSource | Integer
Light source for the image: - 0: unknown.
- 1: daylight.
- 2: fluorescent.
- 3: tungsten.
- 17: standard light A.
- 18: standard light B.
- 19: standard light C.
- 20: D55.
- 21: D65.
- 22: D75.
- 23 to 254: reserved.
- 255: other.
| | 33434 | imgExposureTime | Real
Exposure time | | 296 | imgResolutionUnit | Integer
Unit for the horizontal and vertical resolution of the image: - 2: inches.
- 3: centimeters.
| | 36864 | imgEXIFVersion | Character string
Version of Exif information | | 65536 | imgThumbnail | Binary string
Thumbnail corresponding to the image | | 37377 | imgShutterSpeed | Real
Shutter speed in APEX |
Other tags are also available. These unlisted tags are specific to some types of cameras or correspond to custom tags. ImageInfoModify returns no error code. To find out whether an error was generated by this function, use the ErrorOccurred variable. To find out the error details, use ErrorInfo.
This page is also available for…
|
|
|
| |
| Click [Add] to post a comment |
|
| |
|
| |
| |
| |
| |
| |
| |
| | |
| |