read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata (算子名称)

名称

read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata — Read metadata from image files.

参数签名

read_image_metadata( : : Format, TagName, FileName : TagValue)

描述

该算子 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, 该算子 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 (input_control) string → (string)

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 → (string)

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 → (string)

Name of image file.

File extension: .tif, .tiff

TagValueTagValueTagValueTagValuetagValuetag_value (output_control) tuple → (string / integer / real)

Output tag value read from the image file.

结果

If TagValueTagValueTagValueTagValuetagValuetag_value can be correctly read for the specified input parameters 该算子 read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadataread_image_metadata 返回值 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 该算子 get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info.

可能的前置算子

write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadatawrite_image_metadata

可能的后置算子

read_imageread_imageReadImageReadImageReadImageread_image

模块

Foundation

算子列表