write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadatawrite_image_metadata (Operator)
Name
write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadatawrite_image_metadata — 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_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadatawrite_image_metadata schreibt die Informationen in
TagValueTagValueTagValueTagValuetagValuetag_value unter den Tags TagNameTagNameTagNameTagNametagNametag_name in die Datei
FileNameFileNameFileNameFileNamefileNamefile_name. Dabei können TagValueTagValueTagValueTagValuetagValuetag_value und TagNameTagNameTagNameTagNametagNametag_name
einzelne Werte oder Tupel von Werten sein.
Der Parameter FormatFormatFormatFormatformatformat gibt an, in welchem Format die Metadaten
geschrieben werden sollen.
Der Operator unterstützt für FormatFormatFormatFormatformatformat die TIFF
Metadatenformate 'tiff'"tiff""tiff""tiff""tiff""tiff" und 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff""bigtiff".
Dabei wird eine Dateiendung .tif vorausgesetzt.
Eine Auflistung der unterstützten Tag-Namen TagNameTagNameTagNameTagNametagNametag_name und
dazugehörigen Datentypen von TagValueTagValueTagValueTagValuetagValuetag_value findet sich unter
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadataread_image_metadata.
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
FormatFormatFormatFormatformatformat (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Grafikformat.
Defaultwert:
'tiff'
"tiff"
"tiff"
"tiff"
"tiff"
"tiff"
Wertevorschläge: 'tiff'"tiff""tiff""tiff""tiff""tiff", 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff""bigtiff"
TagNameTagNameTagNameTagNametagNametag_name (input_control) tuple → HTuplestrHTupleHtuple (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"
"tiff_image_description"
Wertevorschläge: '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"
TagValueTagValueTagValueTagValuetagValuetag_value (input_control) tuple → HTupleUnion[int, float, str]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Wert des zu schreibenden Metadaten-Eintrags.
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der Bilddatei.
Dateiendung: .tif, .tiff
Ergebnis
Kann TagValueTagValueTagValueTagValuetagValuetag_value für die angegebenen Parameter erfolgreich geschrieben
werden, dann liefert der Operator write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadatawrite_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_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info abgefragt werden kann.
Vorgänger
write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image
Nachfolger
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadataread_image_metadata
Modul
Foundation