Points Convert: Difference between revisions

From FreeCAD Documentation
No edit summary
(Properties)
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Page in progress}}

<translate>
<translate>


<!--T:6-->
<!--T:6-->
{{Docnav
{{Docnav
|[[Points_Export|Export]]
|
|[[Points_Structure|Points Structure]]
|[[Points_Structure|Structure]]
|[[Points_Module|Points]]
|[[Points_Workbench|Points]]
|IconL=
|IconL=Points_Export.svg
|IconR=
|IconR=Points_Structure.svg
|IconC=Workbench_Points.svg
|IconC=Workbench_Points.svg
}}
}}
Line 18: Line 15:
{{GuiCommand
{{GuiCommand
|Name=Points Convert
|Name=Points Convert
|Empty=1
|MenuLocation=Points → Convert to points...
|MenuLocation=Points → Convert to points...
|Workbenches=[[Points_Module|Points]]
|Workbenches=[[Points_Workbench|Points]]
}}
}}


==Description== <!--T:2-->
==Description== <!--T:2-->


<!--T:8-->
The '''Points Convert''' command creates point clouds from shape objects, for example created with the [[Draft Module|Draft]], [[Part Module|Part]] or [[PartDesign Workbench|PartDesign]] workbench, or mesh objects.
The '''Points Convert''' command creates point clouds from shape objects or mesh objects.

<!--T:9-->
Here a shape object refers any object with a {{PropertyData|Shape}} property. Objects created with the [[Part_Workbench|Part]] and [[PartDesign_Workbench|PartDesign]] workbench are shape objects. But so are objects created with the [[Sketcher_Workbench|Sketcher]] and [[Draft_Workbench|Draft]] workbench.


==Usage== <!--T:3-->
==Usage== <!--T:3-->


<!--T:10-->
# Select one or more objects.
# Select one or more objects.
# There are several ways to invoke the command:
# Select the {{MenuCommand|Points → Convert to points...}} option from the menu.
#* Press the {{Button|[[Image:Points_Convert.svg|16px]] [[Points_Convert|Convert to points...]]}} button.
#* Select the {{MenuCommand|Points → [[Image:Points_Convert.svg|16px]] Convert to points...}} option from the menu.
# The {{MenuCommand|Distance}} dialog box opens.
# The {{MenuCommand|Distance}} dialog box opens.
# Enter the {{MenuCommand|maximum distance}}. The value must be in the {{Value|0.05}} - {{Value|10.0}} range.
# Enter the {{MenuCommand|maximum distance}}. The value must be in the {{Value|0.01}} - {{Value|10.00}} range.
# Press the {{Button|OK}} button to close the dialog box and finish the command.
# Press the {{Button|OK}} button to close the dialog box and finish the command.


==Properties==
==Properties== <!--T:11-->


<!--T:12-->
Point cloud objects are [[App_GeoFeature|App GeoFeature]] objects with the following additional properties. Select the {{MenuCommand|Show all}} option from the [[Property_editor|Property editor]] context menu to display the hidden properties.
Point cloud objects are [[App_GeoFeature|App GeoFeature]] objects with the following additional properties. Select the {{MenuCommand|Show all}} option from the [[Property_editor|Property editor]] context menu to display the hidden properties.


===Data===
===Data=== <!--T:13-->

====Hidden Data properties====


<!--T:17-->
{{TitleProperty|Base}}
{{TitleProperty|Base}}


<!--T:18-->
* {{PropertyData|Points|PointsKernel}}: a Points PointsKernel associated with this object.
* {{PropertyData|Points|PointsKernel|Hidden}}: a Points Kernel associated with this object.
* {{PropertyData|Normal|NormalList}}: a list of normals. This property is only available if the point cloud object was created by the [[Points_Convert|Points Convert]] command from a shape object with faces or a mesh object.
* {{PropertyData|Normal|NormalList|Hidden}}: a list of normals. This property is only available for point clouds created with the [[Points_Convert|Points Convert]] command from mesh objects or shape objects with faces.

<!--T:14-->
{{TitleProperty|Structured points}}

<!--T:15-->
* {{PropertyData|Height|Integer}}: the number of unique Y coordinates in the point cloud. This property is only available for point clouds created with the [[Points_Structure|Points Structure]] command.
* {{PropertyData|Width|Integer}}: the number of unique X coordinates in the point cloud. This property is only available for point clouds created with the [[Points_Structure|Points Structure]] command.


===View===
===View=== <!--T:19-->


<!--T:20-->
{{TitleProperty|Base}}
{{TitleProperty|Base}}


<!--T:21-->
* {{PropertyView|Point Size|FloatConstraint}}: the size of the points in the [[3D_view|3D view]].
* {{PropertyView|Point Size|FloatConstraint}}: the size in pixels of the points in the [[3D_view|3D view]].




<!--T:4-->
<!--T:4-->
{{Docnav
{{Docnav
|[[Points_Export|Export]]
|
|[[Points_Structure|Points Structure]]
|[[Points_Structure|Structure]]
|[[Points_Module|Points]]
|[[Points_Workbench|Points]]
|IconL=
|IconL=Points_Export.svg
|IconR=
|IconR=Points_Structure.svg
|IconC=Workbench_Points.svg
|IconC=Workbench_Points.svg
}}
}}
Line 68: Line 81:
{{Points Tools navi{{#translation:}}}}
{{Points Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 16:15, 25 November 2023

Points Convert

Menu location
Points → Convert to points...
Workbenches
Points
Default shortcut
None
Introduced in version
-
See also
None

Description

The Points Convert command creates point clouds from shape objects or mesh objects.

Here a shape object refers any object with a DataShape property. Objects created with the Part and PartDesign workbench are shape objects. But so are objects created with the Sketcher and Draft workbench.

Usage

  1. Select one or more objects.
  2. There are several ways to invoke the command:
    • Press the Convert to points... button.
    • Select the Points → Convert to points... option from the menu.
  3. The Distance dialog box opens.
  4. Enter the maximum distance. The value must be in the 0.01 - 10.00 range.
  5. Press the OK button to close the dialog box and finish the command.

Properties

Point cloud objects are App GeoFeature objects with the following additional properties. Select the Show all option from the Property editor context menu to display the hidden properties.

Data

Base

  • Data (Hidden)Points (PointsKernel): a Points Kernel associated with this object.
  • Data (Hidden)Normal (NormalList): a list of normals. This property is only available for point clouds created with the Points Convert command from mesh objects or shape objects with faces.

Structured points

  • DataHeight (Integer): the number of unique Y coordinates in the point cloud. This property is only available for point clouds created with the Points Structure command.
  • DataWidth (Integer): the number of unique X coordinates in the point cloud. This property is only available for point clouds created with the Points Structure command.

View

Base

  • ViewPoint Size (FloatConstraint): the size in pixels of the points in the 3D view.