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

write_matrixwrite_matrixWriteMatrixwrite_matrixWriteMatrixWriteMatrix (Operator)

Name

write_matrixwrite_matrixWriteMatrixwrite_matrixWriteMatrixWriteMatrix — Schreiben einer Matrix auf eine Datei.

Signatur

write_matrix( : : MatrixID, FileFormat, FileName : )

Herror write_matrix(const Hlong MatrixID, const char* FileFormat, const char* FileName)

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

Herror write_matrix(const HTuple& MatrixID, const HTuple& FileFormat, const HTuple& FileName)

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

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 HOperatorSetX.WriteMatrix(
[in] VARIANT MatrixID, [in] VARIANT FileFormat, [in] VARIANT FileName)

void HMatrixX.WriteMatrix(
[in] BSTR FileFormat, [in] BSTR FileName)

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

void HMatrix.WriteMatrix(string fileFormat, string fileName)

Beschreibung

write_matrixwrite_matrixWriteMatrixwrite_matrixWriteMatrixWriteMatrix schreibt eine Matrix in die Datei FileNameFileNameFileNameFileNameFileNamefileName. Die Matrix kann mit read_matrixread_matrixReadMatrixread_matrixReadMatrixReadMatrix wieder eingelesen werden. Die Dateiendung für die Matrix ist in HALCON 'mtx'. Der Dateityp kann über den Parameter FileFormatFileFormatFileFormatFileFormatFileFormatfileFormat gewählt werden. Die folgenden Werte stehen zur Verfügung: 'binary'"binary""binary""binary""binary""binary" für ein binäres Dateiformat und 'ascii'"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.

Parallelisierung

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control)  matrix → HMatrix, HTupleHTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Matrix Handle der Eingabematrix.

FileFormatFileFormatFileFormatFileFormatFileFormatfileFormat (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Dateiformat.

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

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

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.write → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name der Datei.

Dateiendung: .mtx

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixcreate_matrixCreateMatrixCreateMatrix

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH