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

get_value_matrixget_value_matrixget_value_matrixGetValueMatrixGetValueMatrix (Operator)

Name

get_value_matrixget_value_matrixget_value_matrixGetValueMatrixGetValueMatrix — Return one ore more elements of a matrix.

Signature

get_value_matrix( : : MatrixID, Row, Column : Value)

Herror get_value_matrix(const Hlong MatrixID, const Hlong Row, const Hlong Column, double* Value)

Herror T_get_value_matrix(const Htuple MatrixID, const Htuple Row, const Htuple Column, Htuple* Value)

Herror get_value_matrix(const HTuple& MatrixID, const HTuple& Row, const HTuple& Column, double* Value)

Herror get_value_matrix(const HTuple& MatrixID, const HTuple& Row, const HTuple& Column, HTuple* Value)

HTuple HMatrix::GetValueMatrix(const HTuple& Row, const HTuple& Column) const

void HOperatorSetX.GetValueMatrix(
[in] VARIANT MatrixID, [in] VARIANT Row, [in] VARIANT Column, [out] VARIANT* Value)

VARIANT HMatrixX.GetValueMatrix(
[in] VARIANT Row, [in] VARIANT Column)

static void HOperatorSet.GetValueMatrix(HTuple matrixID, HTuple row, HTuple column, out HTuple value)

HTuple HMatrix.GetValueMatrix(HTuple row, HTuple column)

double HMatrix.GetValueMatrix(int row, int column)

Description

The operator get_value_matrixget_value_matrixget_value_matrixGetValueMatrixGetValueMatrix returns the values of one ore more elements of the MatrixMatrixMatrixMatrixmatrix as a tuple of floating point numbers. The MatrixMatrixMatrixMatrixmatrix is given by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID. The row coordinates of the elements of the MatrixMatrixMatrixMatrixmatrix are determined by the tuple RowRowRowRowrow, the column coordinates by the tuple ColumnColumnColumnColumncolumn.

Example: 


           /  3.0   1.0  -2.0   1.0  \
  Matrix = | -5.0   7.0   2.0   6.0  |     Row = [0,2,1]   Column = [1,0,3]
           \ -9.0  -4.0   1.0  -1.0  /

  ->   Value = [1.0,-9.0,6.0]

Parallelization

Parameters

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

Matrix handle of the input matrix.

RowRowRowRowrow (input_control)  integer(-array) → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Row numbers of matrix elements to be returned.

Default value: 0

Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100

Restriction: Row >= 0

ColumnColumnColumnColumncolumn (input_control)  integer(-array) → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column numbers of matrix elements to be returned.

Default value: 0

Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100

Restriction: Column >= 0

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

Values of indicated matrix elements.

Result

If the parameters are valid, the operator get_value_matrixget_value_matrixget_value_matrixGetValueMatrixGetValueMatrix 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_value_matrixset_value_matrixset_value_matrixSetValueMatrixSetValueMatrix

Module

Foundation

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