read_image_metadataread_image_metadataReadImageMetadataReadImageMetadata (Operator)
Name
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadata — Einlesen von Metadaten einer Bilddatei.
Signatur
Beschreibung
Der Operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadata liest die Metadaten der Datei
FileNameFileNameFileNameFileNamefileName und gibt die Information unter TagValueTagValueTagValueTagValuetagValue zurück.
Dabei spezifiziert TagNameTagNameTagNameTagNametagName einen einzelnen Tag oder ein Tuple 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 und bigtiff.
Dabei wird eine Dateiendung .tif vorausgesetzt.
Die folgenden Tags sind lesbar:
TagNameTagNameTagNameTagNametagName |
Datentyp von TagValueTagValueTagValueTagValuetagValue
|
|
'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
|
TagNameTagNameTagNameTagNametagName 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 TagNameTagNameTagNameTagNametagName 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 TagNameTagNameTagNameTagNametagName 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 → HTupleHTupleHtuple (string) (string) (HString) (char*)
Grafikformat.
Defaultwert:
'tiff'
"tiff"
"tiff"
"tiff"
"tiff"
Wertevorschläge: 'tiff'"tiff""tiff""tiff""tiff", 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff"
TagNameTagNameTagNameTagNametagName (input_control) tuple → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name des einzulesenden Metadaten-Eintrags.
Defaultwert:
'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"
FileNameFileNameFileNameFileNamefileName (input_control) filename.read → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name der Bilddatei.
Dateiendung: .tif, .tiff
TagValueTagValueTagValueTagValuetagValue (output_control) tuple → HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Wert des eingelesenden Metadaten-Eintrags.
Ergebnis
Kann TagValueTagValueTagValueTagValuetagValue für die angegebenen Parameter erfolgreich gelesen
werden, dann liefert der Operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadata 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_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfo abgefragt werden kann.
Vorgänger
write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadata
Nachfolger
read_imageread_imageReadImageReadImageReadImage
Modul
Foundation