read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata (Operator)
Name
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata — Read metadata from image files.
Signature
Description
The operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadataread_image_metadata reads the metadata of the file
FileNameFileNameFileNameFileNamefileNamefile_name and returns the information in TagValueTagValueTagValueTagValuetagValuetag_value.
With TagNameTagNameTagNameTagNametagNametag_name you specify, for which single tag or tuple of tags
you want to retrieve the information.
The parameter FormatFormatFormatFormatformatformat specifies, in which format the metadata is
encoded.
This operators supports for FormatFormatFormatFormatformatformat the TIFF metadata
formats 'tiff'"tiff""tiff""tiff""tiff""tiff" and 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff""bigtiff".
The file extension .tif is expected.
The following tags are readable:
TagNameTagNameTagNameTagNametagNametag_name |
TagValueTagValueTagValueTagValuetagValuetag_value data type
|
|
'tiff_aperture_value'"tiff_aperture_value""tiff_aperture_value""tiff_aperture_value""tiff_aperture_value""tiff_aperture_value" |
double |
|
'tiff_copyright'"tiff_copyright""tiff_copyright""tiff_copyright""tiff_copyright""tiff_copyright" |
string |
|
'tiff_date_time'"tiff_date_time""tiff_date_time""tiff_date_time""tiff_date_time""tiff_date_time" |
string |
|
'tiff_exposure_time'"tiff_exposure_time""tiff_exposure_time""tiff_exposure_time""tiff_exposure_time""tiff_exposure_time" |
double |
|
'tiff_image_description'"tiff_image_description""tiff_image_description""tiff_image_description""tiff_image_description""tiff_image_description" |
string |
|
'tiff_light_source'"tiff_light_source""tiff_light_source""tiff_light_source""tiff_light_source""tiff_light_source" |
integer |
|
'tiff_make'"tiff_make""tiff_make""tiff_make""tiff_make""tiff_make" |
string |
|
'tiff_software'"tiff_software""tiff_software""tiff_software""tiff_software""tiff_software" |
string
|
Note, the operator returns an error in case the tag specified by
TagNameTagNameTagNameTagNametagNametag_name has no value set.
You can retrieve all readable tags with the string
'tiff_tags_supported_for_reading'"tiff_tags_supported_for_reading""tiff_tags_supported_for_reading""tiff_tags_supported_for_reading""tiff_tags_supported_for_reading""tiff_tags_supported_for_reading" for TagNameTagNameTagNameTagNametagNametag_name as well as
retrieve all writable tags with the string
'tiff_tags_supported_for_writing'"tiff_tags_supported_for_writing""tiff_tags_supported_for_writing""tiff_tags_supported_for_writing""tiff_tags_supported_for_writing""tiff_tags_supported_for_writing". Each of both strings can be used
only as single value for TagNameTagNameTagNameTagNametagNametag_name.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
FormatFormatFormatFormatformatformat (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Graphic format.
Default:
'tiff'
"tiff"
"tiff"
"tiff"
"tiff"
"tiff"
Suggested values:
'tiff'"tiff""tiff""tiff""tiff""tiff", 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff""bigtiff"
TagNameTagNameTagNameTagNametagNametag_name (input_control) tuple → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the tag to be written in the image file.
Default:
'tiff_image_description'
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
Suggested values:
'tiff_image_description'"tiff_image_description""tiff_image_description""tiff_image_description""tiff_image_description""tiff_image_description", 'tiff_make'"tiff_make""tiff_make""tiff_make""tiff_make""tiff_make", 'tiff_software'"tiff_software""tiff_software""tiff_software""tiff_software""tiff_software", 'tiff_date_time'"tiff_date_time""tiff_date_time""tiff_date_time""tiff_date_time""tiff_date_time", 'tiff_copyright'"tiff_copyright""tiff_copyright""tiff_copyright""tiff_copyright""tiff_copyright", 'tiff_exposure_time'"tiff_exposure_time""tiff_exposure_time""tiff_exposure_time""tiff_exposure_time""tiff_exposure_time", 'tiff_aperture_value'"tiff_aperture_value""tiff_aperture_value""tiff_aperture_value""tiff_aperture_value""tiff_aperture_value", 'tiff_light_source'"tiff_light_source""tiff_light_source""tiff_light_source""tiff_light_source""tiff_light_source", 'tiff_tags_supported_for_reading'"tiff_tags_supported_for_reading""tiff_tags_supported_for_reading""tiff_tags_supported_for_reading""tiff_tags_supported_for_reading""tiff_tags_supported_for_reading", 'tiff_tags_supported_for_writing'"tiff_tags_supported_for_writing""tiff_tags_supported_for_writing""tiff_tags_supported_for_writing""tiff_tags_supported_for_writing""tiff_tags_supported_for_writing"
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of image file.
File extension:
.tif, .tiff
TagValueTagValueTagValueTagValuetagValuetag_value (output_control) tuple → HTupleUnion[int, float, str]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Output tag value read from the image file.
Result
If TagValueTagValueTagValueTagValuetagValuetag_value can be correctly read for the specified input
parameters the operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadataread_image_metadata returns the value 2 (
H_MSG_TRUE)
.
Otherwise an exception is raised. In this case, an extended error
information, as e.g., the causative tag, may be set and can be queried with
the operator get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info.
Possible Predecessors
write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadatawrite_image_metadata
Possible Successors
read_imageread_imageReadImageReadImageReadImageread_image
Module
Foundation