Operator Reference

HALCON Operator Reference / Matching / Correlation-Based
ClassesClasses | | Operators

get_ncc_model_regionT_get_ncc_model_regionGetNccModelRegionGetNccModelRegionget_ncc_model_region (Operator)

get_ncc_model_regionT_get_ncc_model_regionGetNccModelRegionGetNccModelRegionget_ncc_model_region — Return the region used to create an NCC model.

Signature

get_ncc_model_region( : ModelRegion : ModelID : )

Herror T_get_ncc_model_region(Hobject* ModelRegion, const Htuple ModelID)

void GetNccModelRegion(HObject* ModelRegion, const HTuple& ModelID)

HRegion HNCCModel::GetNccModelRegion() const

static void HOperatorSet.GetNccModelRegion(out HObject modelRegion, HTuple modelID)

HRegion HNCCModel.GetNccModelRegion()

def get_ncc_model_region(model_id: HHandle) -> HObject

Description

The operator get_ncc_model_regionget_ncc_model_regionGetNccModelRegionGetNccModelRegionget_ncc_model_region returns the region used to create the NCC model ModelIDModelIDModelIDmodelIDmodel_id in ModelRegionModelRegionModelRegionmodelRegionmodel_region. This region can be used, for example, to visualize the found instances of the model in an image. It should be noted that the position of ModelRegionModelRegionModelRegionmodelRegionmodel_region is normalized such that the reference point of the model (see set_ncc_model_originset_ncc_model_originSetNccModelOriginSetNccModelOriginset_ncc_model_origin) lies at the pixel position (0,0). Hence, the region simply needs to be translated to the found position in the image (and possibly rotated around this point). get_ncc_model_regionget_ncc_model_regionGetNccModelRegionGetNccModelRegionget_ncc_model_region ignores the value of the system parameter 'clip_region'"clip_region""clip_region""clip_region""clip_region".

Execution Information

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

Parameters

ModelRegionModelRegionModelRegionmodelRegionmodel_region (output_object)  region → objectHRegionHObjectHObjectHobject *

Model region of the NCC model.

ModelIDModelIDModelIDmodelIDmodel_id (input_control)  ncc_model → HNCCModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the model.

Result

If the handle of the NCC model is valid, the operator get_ncc_model_regionget_ncc_model_regionGetNccModelRegionGetNccModelRegionget_ncc_model_region returns the value 2 ( H_MSG_TRUE) . If necessary an exception is raised.

Possible Predecessors

create_ncc_modelcreate_ncc_modelCreateNccModelCreateNccModelcreate_ncc_model

Module

Matching

ClassesClasses | | Operators