read_image_metadataread_image_metadataReadImageMetadataReadImageMetadata (Operator)
Name
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadata — Read metadata from image files.
Signature
Description
The operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadata reads the metadata of the file
FileNameFileNameFileNameFileNamefileName and returns the information in TagValueTagValueTagValueTagValuetagValue.
With TagNameTagNameTagNameTagNametagName you specify, for which single tag or tuple of tags
you want to retrieve the information.
The parameter FormatFormatFormatFormatformat specifies, in which format the metadata is
encoded.
This operators supports for FormatFormatFormatFormatformat the TIFF metadata
formats tiff and bigtiff.
The file extension .tif is expected.
The following tags are readable:
TagNameTagNameTagNameTagNametagName |
TagValueTagValueTagValueTagValuetagValue data type
|
|
'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" |
string |
|
'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" |
double |
|
'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" |
integer |
|
'tiff_make'"tiff_make""tiff_make""tiff_make""tiff_make" |
string |
|
'tiff_software'"tiff_software""tiff_software""tiff_software""tiff_software" |
string
|
TagNameTagNameTagNameTagNametagName 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" for TagNameTagNameTagNameTagNametagName 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". Each of both strings can be used
only as single value for TagNameTagNameTagNameTagNametagName.
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
FormatFormatFormatFormatformat (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Graphic format.
Default value:
'tiff'
"tiff"
"tiff"
"tiff"
"tiff"
Suggested values: 'tiff'"tiff""tiff""tiff""tiff", 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff"
TagNameTagNameTagNameTagNametagName (input_control) tuple → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name of the tag to be written in the image file.
Default value:
'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_make'"tiff_make""tiff_make""tiff_make""tiff_make", '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_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_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_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"
FileNameFileNameFileNameFileNamefileName (input_control) filename.read → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name of image file.
File extension: .tif, .tiff
TagValueTagValueTagValueTagValuetagValue (output_control) tuple → HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Output tag value read from the image file.
Result
If TagValueTagValueTagValueTagValuetagValue can be correctly read for the specified input
parameters the operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadata 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_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfo.
Possible Predecessors
write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadata
Possible Successors
read_imageread_imageReadImageReadImageReadImage
Module
Foundation