set_ncc_model_origin🔗
Short description🔗
set_ncc_model_origin — Set the origin (reference point) of an NCC model.
Signature🔗
set_ncc_model_origin( ncc_model ModelID, point.y Row, point.x Column )
Description🔗
The operator set_ncc_model_origin sets the origin (reference
point) of the NCC model ModelID 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_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🔗
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🔗
ModelID (input_control, state is modified) ncc_model → (handle)
Handle of the model.
Row (input_control) point.y → (real)
Row coordinate of the origin of the NCC model.
Column (input_control) point.x → (real)
Column coordinate of the origin of the NCC model.
Result🔗
If the handle of the model is valid, the operator
set_ncc_model_origin returns the value 2 (H_MSG_TRUE). If necessary
an exception is raised.
Combinations with other operators🔗
Combinations
Possible predecessors
create_ncc_model, read_ncc_model
Possible successors
find_ncc_model, get_ncc_model_origin, find_ncc_models
See also
Module🔗
Matching