write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadata (Operator)
Name
write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadata — Write metadata of image files.
Signature
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)
(Windows only)
Description
The operator write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadata saves the information in
TagValueTagValueTagValueTagValuetagValue with the tag TagNameTagNameTagNameTagNametagName into the file
FileNameFileNameFileNameFileNamefileName.
In doing so, TagValueTagValueTagValueTagValuetagValue and TagNameTagNameTagNameTagNametagName can be single values
or tuples of values.
The parameter FormatFormatFormatFormatformat specifies, in which format
the metadata is to be written.
This operators supports for FormatFormatFormatFormatformat the TIFF metadata
formats tiff and bigtiff.
A file extension .tif is expecteded.
A list of the supported tag names for TagNameTagNameTagNameTagNametagName and the according
data types for TagValueTagValueTagValueTagValuetagValue is given in read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadata.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
FormatFormatFormatFormatformat (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Graphic format.
Default value:
'tiff'
"tiff"
"tiff"
"tiff"
"tiff"
Suggested values: 'tiff'"tiff""tiff""tiff""tiff", 'bigtiff'"bigtiff""bigtiff""bigtiff""bigtiff"
TagNameTagNameTagNameTagNametagName (input_control) tuple → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name of the tag to be written in the image file.
Default value:
'tiff_image_description'
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
"tiff_image_description"
Suggested values: '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)
Value of the tag to be written in the image file.
FileNameFileNameFileNameFileNamefileName (input_control) filename.write → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name of image file.
File extension: .tif, .tiff
Result
If TagValueTagValueTagValueTagValuetagValue can be correctly written for the specified parameters
the operator write_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadata returns the value 2 (H_MSG_TRUE).
Otherwise an exception is raised. In this case, an extended error
information, as e.g., the causative tag, may be set and can be queried with
the operator get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfo.
Possible Predecessors
write_imagewrite_imageWriteImageWriteImageWriteImage
Possible Successors
read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadata
Module
Foundation