write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadata (Operator)
Name
write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadata — Schreiben von Metadaten in eine Bilddatei.
Signatur
void WriteImageMetadata(const HTuple& Format, const HTuple& TagName, const HTuple& TagValue, const HTuple& FileName)
static void HImage::WriteImageMetadata(const HString& Format, const HTuple& TagName, const HTuple& TagValue, const HString& FileName)
static void HImage::WriteImageMetadata(const char* Format, const HTuple& TagName, const HTuple& TagValue, const char* FileName)
static void HImage::WriteImageMetadata(const wchar_t* Format, const HTuple& TagName, const HTuple& TagValue, const wchar_t* FileName)
(Nur Windows)
Beschreibung
Der Operator write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadata schreibt die Informationen in
TagValueTagValueTagValueTagValuetagValue unter den Tags TagNameTagNameTagNameTagNametagName in die Datei
FileNameFileNameFileNameFileNamefileName. Dabei können TagValueTagValueTagValueTagValuetagValue und TagNameTagNameTagNameTagNametagName
einzelne Werte oder Tupel von Werten sein.
Der Parameter FormatFormatFormatFormatformat gibt an, in welchem Format die Metadaten
geschrieben werden sollen.
Der Operator unterstützt für FormatFormatFormatFormatformat die TIFF
Metadatenformate tiff und bigtiff.
Dabei wird eine Dateiendung .tif vorausgesetzt.
Eine Auflistung der unterstützten Tag-Namen TagNameTagNameTagNameTagNametagName und
dazugehörigen Datentypen von TagValueTagValueTagValueTagValuetagValue findet sich unter
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadata.
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 zu schreibenden 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"
TagValueTagValueTagValueTagValuetagValue (input_control) tuple → HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Wert des zu schreibenden Metadaten-Eintrags.
FileNameFileNameFileNameFileNamefileName (input_control) filename.write → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name der Bilddatei.
Dateiendung: .tif, .tiff
Ergebnis
Kann TagValueTagValueTagValueTagValuetagValue für die angegebenen Parameter erfolgreich geschrieben
werden, dann liefert der Operator write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadata 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_imagewrite_imageWriteImageWriteImageWriteImage
Nachfolger
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadata
Modul
Foundation