get_descriptor_model_pointsT_get_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPoints (Operator)

Name

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

Signature

Description

With the operator get_descriptor_model_pointsget_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPoints 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_modelcreate_uncalib_descriptor_modelCreateUncalibDescriptorModelCreateUncalibDescriptorModel, create_calib_descriptor_modelcreate_calib_descriptor_modelcreate_calib_descriptor_modelCreateCalibDescriptorModelCreateCalibDescriptorModel, or read_descriptor_modelread_descriptor_modelread_descriptor_modelReadDescriptorModelReadDescriptorModel.

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_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModel or find_calib_descriptor_modelfind_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModel preceeds, with get_descriptor_model_pointsget_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPoints 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.

Attention

A descriptor model 'ModelID'"ModelID""ModelID""ModelID""ModelID" cannot be shared between two or more user's threads. Different descriptor models can be used independently and safely in different threads.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

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_modelcreate_uncalib_descriptor_modelCreateUncalibDescriptorModelCreateUncalibDescriptorModel, create_calib_descriptor_modelcreate_calib_descriptor_modelcreate_calib_descriptor_modelCreateCalibDescriptorModelCreateCalibDescriptorModel, find_uncalib_descriptor_modelfind_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModel, find_calib_descriptor_modelfind_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModel, read_descriptor_modelread_descriptor_modelread_descriptor_modelReadDescriptorModelReadDescriptorModel

See also

create_uncalib_descriptor_modelcreate_uncalib_descriptor_modelcreate_uncalib_descriptor_modelCreateUncalibDescriptorModelCreateUncalibDescriptorModel, create_calib_descriptor_modelcreate_calib_descriptor_modelcreate_calib_descriptor_modelCreateCalibDescriptorModelCreateCalibDescriptorModel

Module

Matching