remove_object_model_3d_attrib_modRemoveObjectModel3dAttribModRemoveObjectModel3dAttribModremove_object_model_3d_attrib_modT_remove_object_model_3d_attrib_mod🔗

Short description🔗

remove_object_model_3d_attrib_modRemoveObjectModel3dAttribModRemoveObjectModel3dAttribModremove_object_model_3d_attrib_modT_remove_object_model_3d_attrib_mod — Remove attributes of a 3D object model.

Signature🔗

remove_object_model_3d_attrib_mod( object_model_3d ObjectModel3D, string Attributes )

Description🔗

remove_object_model_3d_attrib_modRemoveObjectModel3dAttribMod removes the standard and/or extended attributes given in Attributesattributesattributes of a 3D object model ObjectModel3DobjectModel3Dobject_model_3d. Doing so changes the 3D object model. This is in contrast to the operator remove_object_model_3d_attribRemoveObjectModel3dAttrib, which creates a new model but functions identically otherwise.

If the Attributesattributesattributes do not exist in ObjectModel3DobjectModel3Dobject_model_3d, no exception is raised.

For a detailed description of Attributesattributesattributes see operator remove_object_model_3d_attribRemoveObjectModel3dAttrib.

Attention🔗

remove_object_model_3d_attrib_modRemoveObjectModel3dAttribMod removes Attributesattributesattributes 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🔗

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🔗

ObjectModel3DobjectModel3Dobject_model_3d (input_control) object_model_3d → (handle)HTuple (HHandle)HObjectModel3D, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the input 3D object model.

Attributesattributesattributes (input_control) string(-array) → (string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Name of the attributes to be removed.

Default: 'extended_attribute'"extended_attribute"
List of values: 'all', 'blue', 'distance_computation_data', 'extended_attribute', 'green', 'lines', 'original_point_indices', 'point_normal', 'polygons', 'primitive_box', 'primitive_cylinder', 'primitive_plane', 'primitive_sphere', 'primitives_all', 'red', 'score', 'shape_based_matching_3d_data', 'triangles', 'xyz_mapping'

Result🔗

If the parameters are valid, the operator remove_object_model_3d_attrib_modRemoveObjectModel3dAttribMod returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

set_object_model_3d_attrib_modSetObjectModel3dAttribMod

Possible successors

get_object_model_3d_paramsGetObjectModel3dParams

Alternatives

remove_object_model_3d_attribRemoveObjectModel3dAttrib

Module🔗

3D Metrology