ClassesClassesClassesClasses | | | | Operators

union_object_model_3dunion_object_model_3dUnionObjectModel3dunion_object_model_3dUnionObjectModel3dUnionObjectModel3d (Operator)

Name

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

Signature

union_object_model_3d( : : ObjectModels3D, Method : UnionObjectModel3D)

Herror union_object_model_3d(const Hlong ObjectModels3D, const char* Method, Hlong* UnionObjectModel3D)

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

Herror union_object_model_3d(const HTuple& ObjectModels3D, const HTuple& Method, Hlong* UnionObjectModel3D)

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

void UnionObjectModel3d(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

void HOperatorSetX.UnionObjectModel3d(
[in] VARIANT ObjectModels3D, [in] VARIANT Method, [out] VARIANT* UnionObjectModel3D)

IHObjectModel3DX* HObjectModel3DX.UnionObjectModel3d([in] BSTR Method)

static void HOperatorSet.UnionObjectModel3d(HTuple objectModels3D, HTuple method, out HTuple unionObjectModel3D)

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

HObjectModel3D HObjectModel3D.UnionObjectModel3d(string method)

Description

union_object_model_3dunion_object_model_3dUnionObjectModel3dunion_object_model_3dUnionObjectModel3dUnionObjectModel3d combines the data of all input models in ObjectModels3DObjectModels3DObjectModels3DObjectModels3DObjectModels3DobjectModels3D to a new 3D object model that is returned in UnionObjectModel3DUnionObjectModel3DUnionObjectModel3DUnionObjectModel3DUnionObjectModel3DunionObjectModel3D. Only attributes that exist in all input objects are combined and returned in UnionObjectModel3DUnionObjectModel3DUnionObjectModel3DUnionObjectModel3DUnionObjectModel3DunionObjectModel3D.

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 MethodMethodMethodMethodMethodmethod is so far 'points_surface'"points_surface""points_surface""points_surface""points_surface""points_surface", which combines all points and surfaces into the output UnionObjectModel3DUnionObjectModel3DUnionObjectModel3DUnionObjectModel3DUnionObjectModel3DunionObjectModel3D.

Note that if a 3D object model is no longer needed or should be overwritten, the memory has to be freed first by calling the operator clear_object_model_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d.

Attention

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

Parallelization

Parameters

ObjectModels3DObjectModels3DObjectModels3DObjectModels3DObjectModels3DobjectModels3D (input_control)  object_model_3d(-array) HObjectModel3D, HTupleHTupleHObjectModel3D, HTupleHObjectModel3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of input 3D object models.

MethodMethodMethodMethodMethodmethod (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Method used for the union.

Default value: 'points_surface' "points_surface" "points_surface" "points_surface" "points_surface" "points_surface"

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

UnionObjectModel3DUnionObjectModel3DUnionObjectModel3DUnionObjectModel3DUnionObjectModel3DunionObjectModel3D (output_control)  object_model_3d HObjectModel3D, HTupleHTupleHObjectModel3D, HTupleHObjectModel3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

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_3dunion_object_model_3dUnionObjectModel3dunion_object_model_3dUnionObjectModel3dUnionObjectModel3d returns 2 (H_MSG_TRUE) if all parameters are correct. If there is no attribute common in all input objects, an exception is raised.

Possible Predecessors

get_object_model_3d_paramsget_object_model_3d_paramsGetObjectModel3dParamsget_object_model_3d_paramsGetObjectModel3dParamsGetObjectModel3dParams

Possible Successors

connection_object_model_3dconnection_object_model_3dConnectionObjectModel3dconnection_object_model_3dConnectionObjectModel3dConnectionObjectModel3d, convex_hull_object_model_3dconvex_hull_object_model_3dConvexHullObjectModel3dconvex_hull_object_model_3dConvexHullObjectModel3dConvexHullObjectModel3d, clear_object_model_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d

See also

gen_box_object_model_3dgen_box_object_model_3dGenBoxObjectModel3dgen_box_object_model_3dGenBoxObjectModel3dGenBoxObjectModel3d, gen_sphere_object_model_3dgen_sphere_object_model_3dGenSphereObjectModel3dgen_sphere_object_model_3dGenSphereObjectModel3dGenSphereObjectModel3d, gen_cylinder_object_model_3dgen_cylinder_object_model_3dGenCylinderObjectModel3dgen_cylinder_object_model_3dGenCylinderObjectModel3dGenCylinderObjectModel3d

Module

3D Metrology


ClassesClassesClassesClasses | | | | Operators