write_matrixT_write_matrixWriteMatrixWriteMatrixwrite_matrix (Operator)

Name

write_matrixT_write_matrixWriteMatrixWriteMatrixwrite_matrix — 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)

def write_matrix(matrix_id: HHandle, file_format: str, file_name: str) -> None

Beschreibung

write_matrixwrite_matrixWriteMatrixWriteMatrixWriteMatrixwrite_matrix schreibt eine Matrix in die Datei FileNameFileNameFileNameFileNamefileNamefile_name. Die Matrix kann mit read_matrixread_matrixReadMatrixReadMatrixReadMatrixread_matrix wieder eingelesen werden. Die Dateiendung für die Matrix ist in HALCON 'mtx'. Der Dateityp kann über den Parameter FileFormatFileFormatFileFormatFileFormatfileFormatfile_format 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.

Ausführungsinformationen

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control)  matrix HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix Handle der Eingabematrix.

FileFormatFileFormatFileFormatFileFormatfileFormatfile_format (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Dateiformat.

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

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

FileNameFileNameFileNameFileNamefileNamefile_name (input_control)  filename.write HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name der Datei.

Dateiendung: .mtx

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrixcreate_matrix

Modul

Foundation