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

remove_object_model_3d_attrib_mod( : : ObjectModel3D, Attributes : )

Herror T_remove_object_model_3d_attrib_mod(const Htuple ObjectModel3D, const Htuple Attributes)

void RemoveObjectModel3dAttribMod(const HTuple& ObjectModel3D, const HTuple& Attributes)

void HObjectModel3D::RemoveObjectModel3dAttribMod(const HTuple& Attributes) const

void HObjectModel3D::RemoveObjectModel3dAttribMod(const HString& Attributes) const

void HObjectModel3D::RemoveObjectModel3dAttribMod(const char* Attributes) const

void HObjectModel3D::RemoveObjectModel3dAttribMod(const wchar_t* Attributes) const   (Windows only)

static void HOperatorSet.RemoveObjectModel3dAttribMod(HTuple objectModel3D, HTuple attributes)

void HObjectModel3D.RemoveObjectModel3dAttribMod(HTuple attributes)

void HObjectModel3D.RemoveObjectModel3dAttribMod(string attributes)

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

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