remove_object_model_3d_attrib_modT_remove_object_model_3d_attrib_modRemoveObjectModel3dAttribModRemoveObjectModel3dAttribMod (Operator)
Name
remove_object_model_3d_attrib_modT_remove_object_model_3d_attrib_modRemoveObjectModel3dAttribModRemoveObjectModel3dAttribMod
— Remove attributes of a 3D object model.
Signature
Description
remove_object_model_3d_attrib_modremove_object_model_3d_attrib_modRemoveObjectModel3dAttribModRemoveObjectModel3dAttribModRemoveObjectModel3dAttribMod
removes the standard and/or extended
attributes given in AttributesAttributesAttributesAttributesattributes
of a 3D object model
ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D
.
Doing so changes the 3D object model. This is in contrast to the
operator remove_object_model_3d_attribremove_object_model_3d_attribRemoveObjectModel3dAttribRemoveObjectModel3dAttribRemoveObjectModel3dAttrib
, which creates a new model
but functions identically otherwise.
If the AttributesAttributesAttributesAttributesattributes
do not exist in ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D
, no
exception is raised.
For a detailed description of AttributesAttributesAttributesAttributesattributes
see operator
remove_object_model_3d_attribremove_object_model_3d_attribRemoveObjectModel3dAttribRemoveObjectModel3dAttribRemoveObjectModel3dAttrib
.
Attention
remove_object_model_3d_attrib_modremove_object_model_3d_attrib_modRemoveObjectModel3dAttribModRemoveObjectModel3dAttribModRemoveObjectModel3dAttribMod
removes AttributesAttributesAttributesAttributesattributes
unchecked from the 3D object model. Special attention must be paid
to retain a consistent 3D object model, as most of the operators expect
consistent 3D object models. Furthermore, the mapping of the 3D points to
image coordinates should not be removed because it speeds up the
computation of many operators.
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
ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D
(input_control) object_model_3d →
HObjectModel3D, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the input 3D object model.
AttributesAttributesAttributesAttributesattributes
(input_control) string(-array) →
HTupleHTupleHtuple (string) (string) (HString) (char*)
Name of the attributes to be removed.
Default value:
'extended_attribute'
"extended_attribute"
"extended_attribute"
"extended_attribute"
"extended_attribute"
List of values: 'all'"all""all""all""all", 'blue'"blue""blue""blue""blue", 'distance_computation_data'"distance_computation_data""distance_computation_data""distance_computation_data""distance_computation_data", 'extended_attribute'"extended_attribute""extended_attribute""extended_attribute""extended_attribute", 'green'"green""green""green""green", 'lines'"lines""lines""lines""lines", 'original_point_indices'"original_point_indices""original_point_indices""original_point_indices""original_point_indices", 'point_normal'"point_normal""point_normal""point_normal""point_normal", 'polygons'"polygons""polygons""polygons""polygons", 'primitive_box'"primitive_box""primitive_box""primitive_box""primitive_box", 'primitive_cylinder'"primitive_cylinder""primitive_cylinder""primitive_cylinder""primitive_cylinder", 'primitive_plane'"primitive_plane""primitive_plane""primitive_plane""primitive_plane", 'primitive_sphere'"primitive_sphere""primitive_sphere""primitive_sphere""primitive_sphere", 'primitives_all'"primitives_all""primitives_all""primitives_all""primitives_all", 'red'"red""red""red""red", 'score'"score""score""score""score", 'shape_based_matching_3d_data'"shape_based_matching_3d_data""shape_based_matching_3d_data""shape_based_matching_3d_data""shape_based_matching_3d_data", 'triangles'"triangles""triangles""triangles""triangles", 'xyz_mapping'"xyz_mapping""xyz_mapping""xyz_mapping""xyz_mapping"
Result
If the parameters are valid, the operator
remove_object_model_3d_attrib_modremove_object_model_3d_attrib_modRemoveObjectModel3dAttribModRemoveObjectModel3dAttribModRemoveObjectModel3dAttribMod
returns the value 2 (H_MSG_TRUE).
If necessary, an exception is raised.
Possible Predecessors
set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribModSetObjectModel3dAttribMod
Possible Successors
get_object_model_3d_paramsget_object_model_3d_paramsGetObjectModel3dParamsGetObjectModel3dParamsGetObjectModel3dParams
Alternatives
remove_object_model_3d_attribremove_object_model_3d_attribRemoveObjectModel3dAttribRemoveObjectModel3dAttribRemoveObjectModel3dAttrib
See also
copy_object_model_3dcopy_object_model_3dCopyObjectModel3dCopyObjectModel3dCopyObjectModel3d
,
set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribModSetObjectModel3dAttribMod
Module
3D Metrology