HALCON Reference Manual 10.0.2
Table of Contents / Matrix / Access ClassesClassesClasses | | | Operators

get_full_matrixget_full_matrixget_full_matrixGetFullMatrixGetFullMatrix (Operator)

Name

get_full_matrixget_full_matrixget_full_matrixGetFullMatrixGetFullMatrix — Return all values of a matrix.

Signature

get_full_matrix( : : MatrixID : Values)

Herror get_full_matrix(const Hlong MatrixID, double* Values)

Herror T_get_full_matrix(const Htuple MatrixID, Htuple* Values)

Herror get_full_matrix(const HTuple& MatrixID, double* Values)

Herror get_full_matrix(const HTuple& MatrixID, HTuple* Values)

HTuple HMatrix::GetFullMatrix() const

void HOperatorSetX.GetFullMatrix(
[in] VARIANT MatrixID, [out] VARIANT* Values)

VARIANT HMatrixX.GetFullMatrix()

static void HOperatorSet.GetFullMatrix(HTuple matrixID, out HTuple values)

HTuple HMatrix.GetFullMatrix()

Description

The operator get_full_matrixget_full_matrixget_full_matrixGetFullMatrixGetFullMatrix returns the values of all elements of the MatrixMatrixMatrixMatrixmatrix given by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID. The output parameter ValuesValuesValuesValuesvalues is a tuple of floating point numbers and contains all values in a row-major order, i.e., line by line.

Example: 


           /   3.0   1.0  -2.0  \
  Matrix = |  -5.0   7.0   2.0  |
           \  -9.0  -4.0   1.0  /

  ->   Values = [3.0,1.0,-2.0,-5.0,7.0,2.0,-9.0,-4.0,1.0]

Parallelization

Parameters

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control)  matrix → HMatrix, HTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Matrix handle of the input matrix.

ValuesValuesValuesValuesvalues (output_control)  real(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Values of the matrix elements.

Result

If the parameters are valid, the operator get_full_matrixget_full_matrixget_full_matrixGetFullMatrixGetFullMatrix returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

create_matrixcreate_matrixcreate_matrixCreateMatrixCreateMatrix

Possible Successors

clear_matrixclear_matrixclear_matrixClearMatrixClearMatrix, clear_all_matricesclear_all_matricesclear_all_matricesClearAllMatricesClearAllMatrices

See also

set_full_matrixset_full_matrixset_full_matrixSetFullMatrixSetFullMatrix

Module

Foundation

Table of Contents / Matrix / Access ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH