get_descriptor_model_pointsT_get_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPoints (Operator)

Name

get_descriptor_model_pointsT_get_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPoints — Query the interest points of the descriptor model or the last processed search image.

Signature

get_descriptor_model_points( : : ModelID, Set, Subset : Row, Column)

Herror T_get_descriptor_model_points(const Htuple ModelID, const Htuple Set, const Htuple Subset, Htuple* Row, Htuple* Column)

void GetDescriptorModelPoints(const HTuple& ModelID, const HTuple& Set, const HTuple& Subset, HTuple* Row, HTuple* Column)

void HDescriptorModel::GetDescriptorModelPoints(const HString& Set, const HTuple& Subset, HTuple* Row, HTuple* Column) const

void HDescriptorModel::GetDescriptorModelPoints(const HString& Set, Hlong Subset, HTuple* Row, HTuple* Column) const

void HDescriptorModel::GetDescriptorModelPoints(const char* Set, Hlong Subset, HTuple* Row, HTuple* Column) const

void HDescriptorModel::GetDescriptorModelPoints(const wchar_t* Set, Hlong Subset, HTuple* Row, HTuple* Column) const   (Windows only)

static void HOperatorSet.GetDescriptorModelPoints(HTuple modelID, HTuple set, HTuple subset, out HTuple row, out HTuple column)

void HDescriptorModel.GetDescriptorModelPoints(string set, HTuple subset, out HTuple row, out HTuple column)

void HDescriptorModel.GetDescriptorModelPoints(string set, int subset, out HTuple row, out HTuple column)

Description

With the operator get_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPointsGetDescriptorModelPoints interest points of the descriptor model or the last processed search image can be queried. It requires a ModelIDModelIDModelIDModelIDmodelID returned by create_uncalib_descriptor_modelcreate_uncalib_descriptor_modelCreateUncalibDescriptorModelCreateUncalibDescriptorModelCreateUncalibDescriptorModel, create_calib_descriptor_modelcreate_calib_descriptor_modelCreateCalibDescriptorModelCreateCalibDescriptorModelCreateCalibDescriptorModel, or read_descriptor_modelread_descriptor_modelReadDescriptorModelReadDescriptorModelReadDescriptorModel.

The interest points stored in the model can always be queried by setting SetSetSetSetset to 'model'"model""model""model""model" and SubsetSubsetSubsetSubsetsubset to 'all'"all""all""all""all". If a find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModel or find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModel precedes, with get_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPointsGetDescriptorModelPoints the interest points of the last search image can be queried as well by setting SetSetSetSetset to 'search'"search""search""search""search" and SubsetSubsetSubsetSubsetsubset to 'all'"all""all""all""all". Additionally, the matched (corresponding) points for each object instance found can be queried by setting SetSetSetSetset to 'model'"model""model""model""model" or 'search'"search""search""search""search" (for the correspondences on the model or search image side, respectively) and SubsetSubsetSubsetSubsetsubset to the result number of the instance. The image coordinates of the queried points are returned in RowRowRowRowrow and ColumnColumnColumnColumncolumn.

Execution Information

Parameters

ModelIDModelIDModelIDModelIDmodelID (input_control)  descriptor_model HDescriptorModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

The handle to the descriptor model.

SetSetSetSetset (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Set of interest points.

Default value: 'model' "model" "model" "model" "model"

List of values: 'model'"model""model""model""model", 'search'"search""search""search""search"

SubsetSubsetSubsetSubsetsubset (input_control)  integer HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Subset of interest points.

Default value: 'all' "all" "all" "all" "all"

Suggested values: 'all'"all""all""all""all", 0, 1, 2

RowRowRowRowrow (output_control)  point.y-array HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Row coordinates of interest points.

ColumnColumnColumnColumncolumn (output_control)  point.x-array HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column coordinates of interest points.

Example (HDevelop)

create_uncalib_descriptor_model (Template,'harris',[],[],[],[],42, \
                                 ModelID)
* Model points can be queried from a model, even if just created
get_descriptor_model_points (ModelID,'model','all',ModelRow,ModelColumn)
find_uncalib_descriptor_model (Image,ModelID,[],[],[],[],0.2,1, \
                               'num_points',HomMat2D,Score)
* Search points can be queried only after a
* find_[un]calib_descriptor_model was executed
get_descriptor_model_points (ModelID,'search','all',SearchRow,SearchColumn)
* Additionally, correspondences for the results can be queried
NumObjects := |HomMat2D|/9
for I := 0 to NumObjects-1 by 1
    * Query corresponding points in the model
    get_descriptor_model_points (ModelID,'model',I, \
                                 CorrModelRow,CorrModelColumn)
    * Query corresponding points in the search image
    get_descriptor_model_points (ModelID,'search',I, \
                                 CorrSearchRow,CorrSearchColumn)
    * Those points are typically for visualizational purposes
    gen_cross_contour_xld (CrossModel,CorrModelRow,CorrModelColumn, \
                           6,0.78)
    gen_cross_contour_xld (CrossSearch,CorrSearchRow,CorrSearchColumn, \
                           6,0.78)

    * ....

endfor

Possible Predecessors

create_uncalib_descriptor_modelcreate_uncalib_descriptor_modelCreateUncalibDescriptorModelCreateUncalibDescriptorModelCreateUncalibDescriptorModel, create_calib_descriptor_modelcreate_calib_descriptor_modelCreateCalibDescriptorModelCreateCalibDescriptorModelCreateCalibDescriptorModel, find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModel, find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModel, read_descriptor_modelread_descriptor_modelReadDescriptorModelReadDescriptorModelReadDescriptorModel

See also

create_uncalib_descriptor_modelcreate_uncalib_descriptor_modelCreateUncalibDescriptorModelCreateUncalibDescriptorModelCreateUncalibDescriptorModel, create_calib_descriptor_modelcreate_calib_descriptor_modelCreateCalibDescriptorModelCreateCalibDescriptorModelCreateCalibDescriptorModel

Module

Matching