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
|
Es gilt zu beachten, dass der Operator einen Fehler wirft, wenn für den
angegebenen Tag 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