get_ncc_model_regionT_get_ncc_model_regionGetNccModelRegionGetNccModelRegionget_ncc_model_region (Operator)
Name
get_ncc_model_regionT_get_ncc_model_regionGetNccModelRegionGetNccModelRegionget_ncc_model_region
— Return the region used to create an NCC model.
Signature
def get_ncc_model_region(model_id: HHandle) -> HObject
Description
The operator get_ncc_model_regionget_ncc_model_regionGetNccModelRegionGetNccModelRegionGetNccModelRegionget_ncc_model_region
returns the
region used to create the NCC model ModelIDModelIDModelIDModelIDmodelIDmodel_id
in
ModelRegionModelRegionModelRegionModelRegionmodelRegionmodel_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 ModelRegionModelRegionModelRegionModelRegionmodelRegionmodel_region
is normalized
such that the reference point of the model (see set_ncc_model_originset_ncc_model_originSetNccModelOriginSetNccModelOriginSetNccModelOriginset_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_regionGetNccModelRegionGetNccModelRegionGetNccModelRegionget_ncc_model_region
ignores the value of the system
parameter 'clip_region'"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
ModelRegionModelRegionModelRegionModelRegionmodelRegionmodel_region
(output_object) region →
objectHRegionHObjectHRegionHobject *
Model region of the NCC model.
ModelIDModelIDModelIDModelIDmodelIDmodel_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_regionGetNccModelRegionGetNccModelRegionGetNccModelRegionget_ncc_model_region
returns the value 2 (
H_MSG_TRUE)
. If
necessary an exception is raised.
Possible Predecessors
create_ncc_modelcreate_ncc_modelCreateNccModelCreateNccModelCreateNccModelcreate_ncc_model
Module
Matching