HALCON Website / HALCON Operator-Referenz / Datei / Bilddaten
KlassenKlassen | | Operatoren

read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata (Operator)

Name

read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataread_image_metadata — Einlesen von Metadaten einer Bilddatei.

Signatur

read_image_metadata( : : Format, TagName, FileName : TagValue)

Herror read_image_metadata(const char* Format, const char* TagName, const char* FileName, char* TagValue)

Herror T_read_image_metadata(const Htuple Format, const Htuple TagName, const Htuple FileName, Htuple* TagValue)

void ReadImageMetadata(const HTuple& Format, const HTuple& TagName, const HTuple& FileName, HTuple* TagValue)

static HTuple HImage::ReadImageMetadata(const HString& Format, const HTuple& TagName, const HString& FileName)

static HTuple HImage::ReadImageMetadata(const char* Format, const HTuple& TagName, const char* FileName)

static HTuple HImage::ReadImageMetadata(const wchar_t* Format, const HTuple& TagName, const wchar_t* FileName)   (Nur Windows)

static void HOperatorSet.ReadImageMetadata(HTuple format, HTuple tagName, HTuple fileName, out HTuple tagValue)

static HTuple HImage.ReadImageMetadata(string format, HTuple tagName, string fileName)

def read_image_metadata(format: str, tag_name: str, file_name: str) -> Union[int, float, str]

Beschreibung

Der Operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadataread_image_metadata liest die Metadaten der Datei FileNameFileNameFileNameFileNamefileNamefile_name und gibt die Information unter TagValueTagValueTagValueTagValuetagValuetag_value zurück. Dabei spezifiziert TagNameTagNameTagNameTagNametagNametag_name einen einzelnen Tag oder ein Tupel von Tags, für welche die jeweilige Information gelesen werden soll. Der Parameter FormatFormatFormatFormatformatformat gibt an, in welchem Format die Metadaten vorliegen.

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.

Die folgenden Tags sind lesbar:
TagNameTagNameTagNameTagNametagNametag_name Datentyp von TagValueTagValueTagValueTagValuetagValuetag_value
'tiff_aperture_value'"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""tiff_copyright" String
'tiff_date_time'"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""tiff_exposure_time" Gleitkommazahlen
'tiff_image_description'"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""tiff_light_source" Ganzzahl
'tiff_make'"tiff_make""tiff_make""tiff_make""tiff_make""tiff_make" String
'tiff_software'"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 TagNameTagNameTagNameTagNametagNametag_name 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""tiff_tags_supported_for_reading" für TagNameTagNameTagNameTagNametagNametag_name 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""tiff_tags_supported_for_writing". Beide Strings dürfen nur als Einzelwerte für TagNameTagNameTagNameTagNametagNametag_name verwendet werden.

Ausführungsinformationen

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 einzulesenden 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", '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_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""tiff_tags_supported_for_writing"

FileNameFileNameFileNameFileNamefileNamefile_name (input_control)  filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name der Bilddatei.

Dateiendung: .tif, .tiff

TagValueTagValueTagValueTagValuetagValuetag_value (output_control)  tuple → HTupleUnion[int, float, str]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Wert des eingelesenen Metadaten-Eintrags.

Ergebnis

Kann TagValueTagValueTagValueTagValuetagValuetag_value für die angegebenen Parameter erfolgreich gelesen werden, dann liefert der Operator read_image_metadataread_image_metadataReadImageMetadataReadImageMetadataReadImageMetadataread_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_image_metadatawrite_image_metadataWriteImageMetadataWriteImageMetadataWriteImageMetadatawrite_image_metadata

Nachfolger

read_imageread_imageReadImageReadImageReadImageread_image

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 22.11.4.0 Copyright © 1996-2025 MVTec Software GmbH
Follow us on