read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata (Operator)
Name
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata — Einlesen von Metadaten einer Bilddatei.
Signatur
Beschreibung
Der Operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata liest die Metadaten der Datei
FileNameFileNameFileNamefileNamefile_name und gibt die Information unter TagValueTagValueTagValuetagValuetag_value zurück.
Dabei spezifiziert TagNameTagNameTagNametagNametag_name einen einzelnen Tag oder ein Tupel von
Tags, für welche die jeweilige Information gelesen werden soll.
Der Parameter FormatFormatFormatformatformat gibt an, in welchem Format die Metadaten
vorliegen.
Der Operator unterstützt für FormatFormatFormatformatformat die TIFF
Metadatenformate 'tiff'"tiff""tiff""tiff""tiff" und 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff".
Dabei wird eine Dateiendung .tif vorausgesetzt.
Die folgenden Tags sind lesbar:
TagNameTagNameTagNametagNametag_name |
Datentyp von TagValueTagValueTagValuetagValuetag_value
|
|
'tiff_aperture_value'"tiff_aperture_value""tiff_aperture_value""tiff_aperture_value""tiff_aperture_value" |
Gleitkommazahlen |
|
'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" |
Gleitkommazahlen |
|
'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" |
Ganzzahl |
|
'tiff_make'"tiff_make""tiff_make""tiff_make""tiff_make" |
String |
|
'tiff_software'"tiff_software""tiff_software""tiff_software""tiff_software" |
String
|
Es gilt zu beachten, dass der Operator einen Fehler wirft, wenn für den
angegebenen Tag
TagNameTagNameTagNametagNametag_name kein Wert gesetzt ist.
Alle lesbaren Tags können mit dem 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" für TagNameTagNameTagNametagNametag_name abgerufen
werden, alle schreibbaren Tags mit dem 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". Beide Strings dürfen nur als
Einzelwerte für TagNameTagNameTagNametagNametag_name verwendet werden.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
FormatFormatFormatformatformat (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Grafikformat.
Default:
'tiff'
"tiff"
"tiff"
"tiff"
"tiff"
Wertevorschläge:
'tiff'"tiff""tiff""tiff""tiff", 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff"
TagNameTagNameTagNametagNametag_name (input_control) tuple → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name des einzulesenden Metadaten-Eintrags.
Default:
'tiff_image_description'
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
Wertevorschläge:
'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"
FileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der Bilddatei.
Dateiendung:
.tif, .tiff
TagValueTagValueTagValuetagValuetag_value (output_control) tuple → HTupleUnion[int, float, str]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Wert des eingelesenen Metadaten-Eintrags.
Ergebnis
Kann TagValueTagValueTagValuetagValuetag_value für die angegebenen Parameter erfolgreich gelesen
werden, dann liefert der Operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata den Wert 2 (
H_MSG_TRUE)
.
Andernfalls wird eine Fehlerbehandlung durchgeführt.
In diesem Fall kann vom Interface eine zusätzliche Fehlerinformation, wie
z.B. der verursachende Tag, gesetzt werden,
die mit get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info abgefragt werden kann.
Vorgänger
write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadatawrite_image_metadata
Nachfolger
read_imageread_imageReadImageReadImageread_image
Modul
Foundation