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

write_matrixT_write_matrixWriteMatrixWriteMatrix (Operator)

Name

write_matrixT_write_matrixWriteMatrixWriteMatrix — Schreiben einer Matrix auf eine Datei.

Signatur

write_matrix( : : MatrixID, FileFormat, FileName : )

Herror T_write_matrix(const Htuple MatrixID, const Htuple FileFormat, const Htuple FileName)

void WriteMatrix(const HTuple& MatrixID, const HTuple& FileFormat, const HTuple& FileName)

void HMatrix::WriteMatrix(const HString& FileFormat, const HString& FileName) const

void HMatrix::WriteMatrix(const char* FileFormat, const char* FileName) const

void HMatrix::WriteMatrix(const wchar_t* FileFormat, const wchar_t* FileName) const   (Nur Windows)

static void HOperatorSet.WriteMatrix(HTuple matrixID, HTuple fileFormat, HTuple fileName)

void HMatrix.WriteMatrix(string fileFormat, string fileName)

Beschreibung

write_matrixwrite_matrixWriteMatrixWriteMatrixWriteMatrix schreibt eine Matrix in die Datei FileNameFileNameFileNameFileNamefileName. Die Matrix kann mit read_matrixread_matrixReadMatrixReadMatrixReadMatrix wieder eingelesen werden. Die Dateiendung für die Matrix ist in HALCON 'mtx'. Der Dateityp kann über den Parameter FileFormatFileFormatFileFormatFileFormatfileFormat gewählt werden. Die folgenden Werte stehen zur Verfügung: 'binary'"binary""binary""binary""binary" für ein binäres Dateiformat und 'ascii'"ascii""ascii""ascii""ascii" für ein Textformat. Im Textformat enthält jede Zeile der Datei eine Zeile der Matrix. Die Spalten sind durch Leerzeichen getrennt. Der Vorteil bei der Nutzung des binären Dateiformats gegenüber dem Textformat liegt am geringeren Speicherbedarf der Ausgabedatei.

Ausführungsinformationen

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control)  matrix → HMatrix, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix Handle der Eingabematrix.

FileFormatFileFormatFileFormatFileFormatfileFormat (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Dateiformat.

Defaultwert: 'binary' "binary" "binary" "binary" "binary"

Werteliste: 'ascii'"ascii""ascii""ascii""ascii", 'binary'"binary""binary""binary""binary"

FileNameFileNameFileNameFileNamefileName (input_control)  filename.write → HTupleHTupleHtuple (string) (string) (HString) (char*)

Name der Datei.

Dateiendung: .mtx

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrix

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH