ClassesClassesClassesClasses | | | | Operators

select_points_object_model_3dselect_points_object_model_3dSelectPointsObjectModel3dselect_points_object_model_3dSelectPointsObjectModel3dSelectPointsObjectModel3d (Operator)

Name

select_points_object_model_3dselect_points_object_model_3dSelectPointsObjectModel3dselect_points_object_model_3dSelectPointsObjectModel3dSelectPointsObjectModel3d — Apply a threshold to an attribute of 3D object models.

Signature

select_points_object_model_3d( : : ObjectModel3D, Attrib, MinValue, MaxValue : ObjectModel3DThresholded)

Herror select_points_object_model_3d(const Hlong ObjectModel3D, const char* Attrib, double MinValue, double MaxValue, Hlong* ObjectModel3DThresholded)

Herror T_select_points_object_model_3d(const Htuple ObjectModel3D, const Htuple Attrib, const Htuple MinValue, const Htuple MaxValue, Htuple* ObjectModel3DThresholded)

Herror select_points_object_model_3d(const HTuple& ObjectModel3D, const HTuple& Attrib, const HTuple& MinValue, const HTuple& MaxValue, Hlong* ObjectModel3DThresholded)

Herror select_points_object_model_3d(const HTuple& ObjectModel3D, const HTuple& Attrib, const HTuple& MinValue, const HTuple& MaxValue, HTuple* ObjectModel3DThresholded)

HTuple HObjectModel3D::SelectPointsObjectModel3d(const HTuple& Attrib, const HTuple& MinValue, const HTuple& MaxValue) const

void SelectPointsObjectModel3d(const HTuple& ObjectModel3D, const HTuple& Attrib, const HTuple& MinValue, const HTuple& MaxValue, HTuple* ObjectModel3DThresholded)

static HObjectModel3DArray HObjectModel3D::SelectPointsObjectModel3d(const HObjectModel3DArray& ObjectModel3D, const HTuple& Attrib, const HTuple& MinValue, const HTuple& MaxValue)

HObjectModel3D HObjectModel3D::SelectPointsObjectModel3d(const HString& Attrib, double MinValue, double MaxValue) const

HObjectModel3D HObjectModel3D::SelectPointsObjectModel3d(const char* Attrib, double MinValue, double MaxValue) const

void HOperatorSetX.SelectPointsObjectModel3d(
[in] VARIANT ObjectModel3D, [in] VARIANT Attrib, [in] VARIANT MinValue, [in] VARIANT MaxValue, [out] VARIANT* ObjectModel3DThresholded)

IHObjectModel3DX* HObjectModel3DX.SelectPointsObjectModel3d(
[in] VARIANT Attrib, [in] VARIANT MinValue, [in] VARIANT MaxValue)

static void HOperatorSet.SelectPointsObjectModel3d(HTuple objectModel3D, HTuple attrib, HTuple minValue, HTuple maxValue, out HTuple objectModel3DThresholded)

static HObjectModel3D[] HObjectModel3D.SelectPointsObjectModel3d(HObjectModel3D[] objectModel3D, HTuple attrib, HTuple minValue, HTuple maxValue)

HObjectModel3D HObjectModel3D.SelectPointsObjectModel3d(string attrib, double minValue, double maxValue)

Description

select_points_object_model_3dselect_points_object_model_3dSelectPointsObjectModel3dselect_points_object_model_3dSelectPointsObjectModel3dSelectPointsObjectModel3d selects points of 3D object models based on the specified attributes. One or more attributes can be specified by their names in AttribAttribAttribAttribAttribattrib. The minimum and maximum values are set in MinValueMinValueMinValueMinValueMinValueminValue and MaxValueMaxValueMaxValueMaxValueMaxValuemaxValue.

The following attributes are available:

'point_coord_x'"point_coord_x""point_coord_x""point_coord_x""point_coord_x""point_coord_x":

The x-coordinates of the set of 3D points.

'point_coord_y'"point_coord_y""point_coord_y""point_coord_y""point_coord_y""point_coord_y":

The y-coordinates of the set of 3D points.

'point_coord_z'"point_coord_z""point_coord_z""point_coord_z""point_coord_z""point_coord_z":

The z-coordinates of the set of 3D points.

'point_normal_x'"point_normal_x""point_normal_x""point_normal_x""point_normal_x""point_normal_x":

The x-components of the 3D point normals of the set of 3D points.

'point_normal_y'"point_normal_y""point_normal_y""point_normal_y""point_normal_y""point_normal_y":

The y-components of the 3D point normals of the set of 3D points.

'point_normal_z'"point_normal_z""point_normal_z""point_normal_z""point_normal_z""point_normal_z":

The z-components of the 3D point normals of the set of 3D points.

'mapping_row'"mapping_row""mapping_row""mapping_row""mapping_row""mapping_row":

The row-components of the 2D mapping of the set of 3D points.

'mapping_col'"mapping_col""mapping_col""mapping_col""mapping_col""mapping_col":

The column-components of the 2D mapping of the set of 3D points.

Extended attribute:

Enter the name of an extended attribute of the type 'vertices'"vertices""vertices""vertices""vertices""vertices" and the selection will be applied based on the values of the extended attribute.

The selection is applied based on the listed attributes. The resulting 3D object model will contain all points that are inside the interval specified by MinValueMinValueMinValueMinValueMinValueminValue and MaxValueMaxValueMaxValueMaxValueMaxValuemaxValue. If AttribAttribAttribAttribAttribattrib contains more than one entry, the second threshold operation is applied to the result of the previous operation, etc. The number of minimum and maximum values must be equal to the number of attributes given in AttribAttribAttribAttribAttribattrib. All attributes that are connected with the points (e.g., polygons or triangles) are adapted in such a way that there is no reference to the removed points left.

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.

Parallelization

Parameters

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

Handle of the 3D object models.

AttribAttribAttribAttribAttribattrib (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Attributes the threshold is applied to.

Default value: 'point_coord_z' "point_coord_z" "point_coord_z" "point_coord_z" "point_coord_z" "point_coord_z"

List of values: 'mapping_col'"mapping_col""mapping_col""mapping_col""mapping_col""mapping_col", 'mapping_row'"mapping_row""mapping_row""mapping_row""mapping_row""mapping_row", 'point_coord_x'"point_coord_x""point_coord_x""point_coord_x""point_coord_x""point_coord_x", 'point_coord_y'"point_coord_y""point_coord_y""point_coord_y""point_coord_y""point_coord_y", 'point_coord_z'"point_coord_z""point_coord_z""point_coord_z""point_coord_z""point_coord_z", 'point_normal_x'"point_normal_x""point_normal_x""point_normal_x""point_normal_x""point_normal_x", 'point_normal_y'"point_normal_y""point_normal_y""point_normal_y""point_normal_y""point_normal_y", 'point_normal_z'"point_normal_z""point_normal_z""point_normal_z""point_normal_z""point_normal_z"

MinValueMinValueMinValueMinValueMinValueminValue (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Minimum value for the attributes specified by AttribAttribAttribAttribAttribattrib.

Default value: 0.5

MaxValueMaxValueMaxValueMaxValueMaxValuemaxValue (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Maximum value for the attributes specified by AttribAttribAttribAttribAttribattrib.

Default value: 1.0

ObjectModel3DThresholdedObjectModel3DThresholdedObjectModel3DThresholdedObjectModel3DThresholdedObjectModel3DThresholdedobjectModel3DThresholded (output_control)  object_model_3d(-array) HObjectModel3D, HTupleHTupleHObjectModel3D, HTupleHObjectModel3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the reduced 3D object models.

Example (HDevelop)

gen_object_model_3d_from_points (rand(100), rand(100),\
                                    rand(100), ObjectModel3D)
select_points_object_model_3d (ObjectModel3D, 'point_coord_z',\
                               0.5, 1, ObjectModel3DThresholded)
get_object_model_3d_params (ObjectModel3DThresholded, 'num_points',\
                            NumPoints)

Result

select_points_object_model_3dselect_points_object_model_3dSelectPointsObjectModel3dselect_points_object_model_3dSelectPointsObjectModel3dSelectPointsObjectModel3d returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Possible Predecessors

read_object_model_3dread_object_model_3dReadObjectModel3dread_object_model_3dReadObjectModel3dReadObjectModel3d, xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d

Possible Successors

connection_object_model_3dconnection_object_model_3dConnectionObjectModel3dconnection_object_model_3dConnectionObjectModel3dConnectionObjectModel3d, project_object_model_3dproject_object_model_3dProjectObjectModel3dproject_object_model_3dProjectObjectModel3dProjectObjectModel3d, object_model_3d_to_xyzobject_model_3d_to_xyzObjectModel3dToXyzobject_model_3d_to_xyzObjectModel3dToXyzObjectModel3dToXyz, clear_object_model_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d

See also

connection_object_model_3dconnection_object_model_3dConnectionObjectModel3dconnection_object_model_3dConnectionObjectModel3dConnectionObjectModel3d

Module

3D Metrology


ClassesClassesClassesClasses | | | | Operators