set_ncc_model_originT_set_ncc_model_originSetNccModelOriginSetNccModelOriginset_ncc_model_origin (Operator)
Name
set_ncc_model_originT_set_ncc_model_originSetNccModelOriginSetNccModelOriginset_ncc_model_origin
— Set the origin (reference point) of an NCC model.
Signature
Herror T_set_ncc_model_origin(const Htuple ModelID, const Htuple Row, const Htuple Column)
Description
The operator set_ncc_model_originset_ncc_model_originSetNccModelOriginSetNccModelOriginSetNccModelOriginset_ncc_model_origin
sets the origin (reference
point) of the NCC model ModelIDModelIDModelIDModelIDmodelIDmodel_id
to a new value. The origin
is specified relative to the center of gravity of the domain
(region) of the image that was used to create the NCC model with
create_ncc_modelcreate_ncc_modelCreateNccModelCreateNccModelCreateNccModelcreate_ncc_model
. Hence, an origin of (0,0) means that the
center of gravity of the domain of the model image is used as the
origin. An origin of (-20,-40) means that the origin lies to the
upper left of the center of gravity.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator modifies the state of the following input parameter:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Parameters
ModelIDModelIDModelIDModelIDmodelIDmodel_id
(input_control, state is modified) ncc_model →
HNCCModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the model.
RowRowRowRowrowrow
(input_control) point.y →
HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row coordinate of the origin of the NCC model.
ColumnColumnColumnColumncolumncolumn
(input_control) point.x →
HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column coordinate of the origin of the NCC model.
Result
If the handle of the model is valid, the operator
set_ncc_model_originset_ncc_model_originSetNccModelOriginSetNccModelOriginSetNccModelOriginset_ncc_model_origin
returns the value 2 (
H_MSG_TRUE)
. If necessary
an exception is raised.
Possible Predecessors
create_ncc_modelcreate_ncc_modelCreateNccModelCreateNccModelCreateNccModelcreate_ncc_model
,
read_ncc_modelread_ncc_modelReadNccModelReadNccModelReadNccModelread_ncc_model
Possible Successors
find_ncc_modelfind_ncc_modelFindNccModelFindNccModelFindNccModelfind_ncc_model
,
get_ncc_model_originget_ncc_model_originGetNccModelOriginGetNccModelOriginGetNccModelOriginget_ncc_model_origin
,
find_ncc_modelsfind_ncc_modelsFindNccModelsFindNccModelsFindNccModelsfind_ncc_models
See also
area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center
Module
Matching