Skip to content

union_object_model_3dUnionObjectModel3dUnionObjectModel3dunion_object_model_3dT_union_object_model_3d🔗

Short description🔗

union_object_model_3dUnionObjectModel3dUnionObjectModel3dunion_object_model_3dT_union_object_model_3d — Combine several 3D object models to a new 3D object model.

Signature🔗

union_object_model_3d( object_model_3d ObjectModels3D, string Method, out object_model_3d UnionObjectModel3D )void UnionObjectModel3d( const HTuple& ObjectModels3D, const HTuple& Method, HTuple* UnionObjectModel3D )static void HOperatorSet.UnionObjectModel3d( HTuple objectModels3D, HTuple method, out HTuple unionObjectModel3D )def union_object_model_3d( object_models_3d: MaybeSequence[HHandle], method: str ) -> HHandle

Herror T_union_object_model_3d( const Htuple ObjectModels3D, const Htuple Method, Htuple* UnionObjectModel3D )

static HObjectModel3D HObjectModel3D::UnionObjectModel3d( const HObjectModel3DArray& ObjectModels3D, const HString& Method )

HObjectModel3D HObjectModel3D::UnionObjectModel3d( const HString& Method ) const

HObjectModel3D HObjectModel3D::UnionObjectModel3d( const char* Method ) const

HObjectModel3D HObjectModel3D::UnionObjectModel3d( const wchar_t* Method ) const (Windows only)

static HObjectModel3D HObjectModel3D.UnionObjectModel3d( HObjectModel3D[] objectModels3D, string method )

HObjectModel3D HObjectModel3D.UnionObjectModel3d( string method )

Description🔗

union_object_model_3dUnionObjectModel3d combines the data of all input models in ObjectModels3DobjectModels3Dobject_models_3d to a new 3D object model that is returned in UnionObjectModel3DunionObjectModel3Dunion_object_model_3d.

Overlapping areas in the 3D object models might cause the potential 2D mapping, polygons, or triangles in the output to be less useful, since they might overlap, too.

The only supported Methodmethodmethod is so far 'points_surface'"points_surface", which combines all points, surfaces and lines into the output UnionObjectModel3DunionObjectModel3Dunion_object_model_3d. Extended Attributes are copied if no holes appear, i.e., if they are present in all input object models where the standard attribute they are attached to exists.

Attention🔗

union_object_model_3dUnionObjectModel3d ignores 3D object models of type 3D primitive and 3D shape model.

Execution information🔗

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.

Parameters🔗

ObjectModels3DobjectModels3Dobject_models_3d (input_control) object_model_3d(-array) → (handle)HTuple (HHandle)HObjectModel3D, HTuple (IntPtr)MaybeSequence[HHandle]Htuple (handle)

Handle of input 3D object models.

Methodmethodmethod (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Method used for the union.

Default: 'points_surface'"points_surface"
List of values: 'points_surface'"points_surface"

UnionObjectModel3DunionObjectModel3Dunion_object_model_3d (output_control) object_model_3d → (handle)HTuple (HHandle)HObjectModel3D, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the resulting 3D object model.

Example🔗

(HDevelop)

gen_object_model_3d_from_points ([0,0,0,0],[1,1,0,0], [0,1,1,0],\
                                    ObjectModel3D1)
gen_object_model_3d_from_points ([1,1,1,1],[1,1,0,0], [0,1,1,0],\
                                    ObjectModel3D2)
get_object_model_3d_params (ObjectModel3D1, 'diameter', DiameterOld)
union_object_model_3d ([ObjectModel3D1,ObjectModel3D2], 'points_surface',\
                       UnionObjectModel3D)
get_object_model_3d_params (UnionObjectModel3D, 'diameter', DiameterNew)

Result🔗

union_object_model_3dUnionObjectModel3d returns 2 (H_MSG_TRUE) if all parameters are correct. If there is no attribute common in all input objects, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

get_object_model_3d_paramsGetObjectModel3dParams

Possible successors

connection_object_model_3dConnectionObjectModel3d, convex_hull_object_model_3dConvexHullObjectModel3d

See also

gen_box_object_model_3dGenBoxObjectModel3d, gen_sphere_object_model_3dGenSphereObjectModel3d, gen_cylinder_object_model_3dGenCylinderObjectModel3d

Module🔗

3D Metrology