add_deformable_surface_model_reference_pointT_add_deformable_surface_model_reference_pointAddDeformableSurfaceModelReferencePointAddDeformableSurfaceModelReferencePointadd_deformable_surface_model_reference_point (Operator)
Name
add_deformable_surface_model_reference_pointT_add_deformable_surface_model_reference_pointAddDeformableSurfaceModelReferencePointAddDeformableSurfaceModelReferencePointadd_deformable_surface_model_reference_point — Add a reference point to a deformable surface model.
Signature
def add_deformable_surface_model_reference_point(deformable_surface_model: HHandle, reference_point_x: MaybeSequence[Union[float, int]], reference_point_y: MaybeSequence[Union[float, int]], reference_point_z: MaybeSequence[Union[float, int]]) -> Sequence[int]
def add_deformable_surface_model_reference_point_s(deformable_surface_model: HHandle, reference_point_x: MaybeSequence[Union[float, int]], reference_point_y: MaybeSequence[Union[float, int]], reference_point_z: MaybeSequence[Union[float, int]]) -> int
Description
The operator add_deformable_surface_model_reference_pointadd_deformable_surface_model_reference_pointAddDeformableSurfaceModelReferencePointAddDeformableSurfaceModelReferencePointAddDeformableSurfaceModelReferencePointadd_deformable_surface_model_reference_point adds
one or more reference points to the deformable surface model passed in
DeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModeldeformableSurfaceModeldeformable_surface_model.
The 3D coordinates of the reference points is passed in the parameters
ReferencePointXReferencePointXReferencePointXReferencePointXreferencePointXreference_point_x, ReferencePointYReferencePointYReferencePointYReferencePointYreferencePointYreference_point_y and
ReferencePointZReferencePointZReferencePointZReferencePointZreferencePointZreference_point_z.
The index of the new reference points is returned in
ReferencePointIndexReferencePointIndexReferencePointIndexReferencePointIndexreferencePointIndexreference_point_index.
Reference points are defined in model coordinates, i.e., in the coordinate
frame of the model parameter of create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModelCreateDeformableSurfaceModelcreate_deformable_surface_model.
The operators
find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModelFindDeformableSurfaceModelfind_deformable_surface_model and
refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModelRefineDeformableSurfaceModelrefine_deformable_surface_model return the position of all
added reference points as found in the scene.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on internal data level.
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
DeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModeldeformableSurfaceModeldeformable_surface_model (input_control, state is modified) deformable_surface_model → HDeformableSurfaceModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the deformable surface model.
ReferencePointXReferencePointXReferencePointXReferencePointXreferencePointXreference_point_x (input_control) real(-array) → HTupleMaybeSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
x-coordinates of a reference point.
ReferencePointYReferencePointYReferencePointYReferencePointYreferencePointYreference_point_y (input_control) real(-array) → HTupleMaybeSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
x-coordinates of a reference point.
ReferencePointZReferencePointZReferencePointZReferencePointZreferencePointZreference_point_z (input_control) real(-array) → HTupleMaybeSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
x-coordinates of a reference point.
ReferencePointIndexReferencePointIndexReferencePointIndexReferencePointIndexreferencePointIndexreference_point_index (output_control) integer(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the new reference point.
Result
add_deformable_surface_model_reference_pointadd_deformable_surface_model_reference_pointAddDeformableSurfaceModelReferencePointAddDeformableSurfaceModelReferencePointAddDeformableSurfaceModelReferencePointadd_deformable_surface_model_reference_point returns 2 (
H_MSG_TRUE)
if all
parameters are correct. If necessary, an exception is raised.
Possible Predecessors
create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModelCreateDeformableSurfaceModelcreate_deformable_surface_model,
read_deformable_surface_modelread_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModelReadDeformableSurfaceModelread_deformable_surface_model
Possible Successors
find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModelFindDeformableSurfaceModelfind_deformable_surface_model,
refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModelRefineDeformableSurfaceModelrefine_deformable_surface_model,
write_deformable_surface_modelwrite_deformable_surface_modelWriteDeformableSurfaceModelWriteDeformableSurfaceModelWriteDeformableSurfaceModelwrite_deformable_surface_model
See also
create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModelCreateDeformableSurfaceModelcreate_deformable_surface_model,
find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModelFindDeformableSurfaceModelfind_deformable_surface_model,
refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModelRefineDeformableSurfaceModelrefine_deformable_surface_model
Module
3D Metrology