read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata (算子)
名称
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata — 从图像文件中读取元数据。
签名
描述
算子 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。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
FormatFormatFormatFormatformatformat (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Graphic format.
默认值：
'tiff'
"tiff"
"tiff"
"tiff"
"tiff"
"tiff"
建议值：
'tiff'"tiff""tiff""tiff""tiff""tiff", 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff""bigtiff"
TagNameTagNameTagNameTagNametagNametag_name (输入控制) tuple → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the tag to be written in the image file.
默认值：
'tiff_image_description'
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
建议值：
'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 (输入控制) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of image file.
File extension:
.tif, .tiff
TagValueTagValueTagValueTagValuetagValuetag_value (输出控制) 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.
结果
If TagValueTagValueTagValueTagValuetagValuetag_value can be correctly read for the specified input
parameters the operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadataread_image_metadata 返回值 2 ( H_MSG_TRUE )。否则将抛出异常。 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。
可能的前趋
write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadatawrite_image_metadata
可能的后继
read_imageread_imageReadImageReadImageReadImageread_image
模块
基础