HALCON 25.11.0.0 / HALCON Operator-Referenz / Matrix / Datei
KlassenKlassen | | Operatoren

read_matrixT_read_matrixReadMatrixReadMatrixread_matrix (Operator)

Name

read_matrixT_read_matrixReadMatrixReadMatrixread_matrix — Einlesen eine Matrix von einer Datei.

Signatur

read_matrix( : : FileName : MatrixID)

Herror T_read_matrix(const Htuple FileName, Htuple* MatrixID)

void ReadMatrix(const HTuple& FileName, HTuple* MatrixID)

void HMatrix::HMatrix(const HString& FileName)

void HMatrix::HMatrix(const char* FileName)

void HMatrix::HMatrix(const wchar_t* FileName)   ( Nur Windows)

void HMatrix::ReadMatrix(const HString& FileName)

void HMatrix::ReadMatrix(const char* FileName)

void HMatrix::ReadMatrix(const wchar_t* FileName)   ( Nur Windows)

static void HOperatorSet.ReadMatrix(HTuple fileName, out HTuple matrixID)

public HMatrix(string fileName)

void HMatrix.ReadMatrix(string fileName)

def read_matrix(file_name: str) -> HHandle

Beschreibung

read_matrixread_matrixReadMatrixReadMatrixread_matrix liest eine Matrix, die mit write_matrixwrite_matrixWriteMatrixWriteMatrixwrite_matrix geschrieben wurde, aus der Datei FileNameFileNameFileNamefileNamefile_name ein. Die Dateiendung für die Matrix ist in HALCON 'mtx'. Das Dateiformat kann binär oder ASCII sein. Jede Zeile der Datei enthält eine Zeile der Matrix mit einer Anzahl von Spalten. Die Spalten sind durch Leerzeichen oder Tabulatoren getrennt. Jede Zeile muss dieselbe Anzahl an Spalten beinhalten. Leere Zeilen werden ignoriert.

Die eingelesenen Ergebnisse werden in der generierten Matrix Matrix gespeichert. Es wird das Matrix Handle MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id dieser Matrix zurückgegeben. Zugriff auf die Elemente der Matrizen ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixget_full_matrix möglich.

Ausführungsinformationen

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

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

Name der Datei.

Dateiendung: .mtx

MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (output_control)  matrix → HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix Handle.

Ergebnis

Ist der Dateiname korrekt, dann liefert read_matrixread_matrixReadMatrixReadMatrixread_matrix den Wert 2 ( H_MSG_TRUE) . Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixget_full_matrix

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 25.11.0.0 Copyright © 1996-2025 MVTec Software GmbH