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_metadataWriteImageMetadataWriteImageMetadatawrite_image_metadata schreibt die Informationen in
TagValueTagValueTagValuetagValuetag_value unter den Tags TagNameTagNameTagNametagNametag_name in die Datei
FileNameFileNameFileNamefileNamefile_name. Dabei können TagValueTagValueTagValuetagValuetag_value und TagNameTagNameTagNametagNametag_name
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'"tiff""tiff""tiff""tiff" und 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff".
Dabei wird eine Dateiendung .tif vorausgesetzt.
Eine Auflistung der unterstützten Tag-Namen TagNameTagNameTagNametagNametag_name und
dazugehörigen Datentypen von TagValueTagValueTagValuetagValuetag_value findet sich unter
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_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
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 zu schreibenden 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"
TagValueTagValueTagValuetagValuetag_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.
FileNameFileNameFileNamefileNamefile_name (input_control) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der Bilddatei.
Dateiendung:
.tif, .tiff
Ergebnis
Kann TagValueTagValueTagValuetagValuetag_value für die angegebenen Parameter erfolgreich geschrieben
werden, dann liefert der Operator write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadatawrite_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_imagewrite_imageWriteImageWriteImagewrite_image
Nachfolger
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata
Modul
Foundation