Points Convert: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
(Properties)
 
(29 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{UnfinishedDocu}}
<translate>
<translate>

<!--T:6-->
<!--T:6-->
{{Docnav
{{Docnav|[[Points_Transform|Transform]]|[[Points PolyCut|Polygon cut]]|[[Points_Module|Points]]|IconL=Points_Transform.png|IconC=PointsWorkbench.svg|IconR=PolygonPick.svg}}
|[[Points_Export|Export]]
|[[Points_Structure|Structure]]
|[[Points_Workbench|Points]]
|IconL=Points_Export.svg
|IconR=Points_Structure.svg
|IconC=Workbench_Points.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Points Convert
|Name=Points Convert
|MenuLocation=
|MenuLocation=Points → Convert to points...
|Workbenches=[[Points Module|Points]]
|Workbenches=[[Points_Workbench|Points]]
|SeeAlso=
}}
}}


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


== How to use == <!--T:3-->
<!--T:8-->
The '''Points Convert''' command creates point clouds from shape objects or mesh objects.


<!--T:4-->
<!--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.
{{Docnav|[[Points_Transform|Transform]]|[[Points PolyCut|Polygon cut]]|[[Points_Module|Points]]|IconL=Points_Transform.png|IconC=PointsWorkbench.svg|IconR=PolygonPick.svg}}


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

⚫
{{Points Tools navi}}
⚫
<!--T:10-->
# Select one or more objects.
# There are several ways to invoke the command:
#* 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.
# 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.

==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.

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

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

<!--T:18-->
* {{PropertyData|Points|PointsKernel|Hidden}}: a Points Kernel associated with this 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=== <!--T:19-->

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

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


<!--T:4-->
{{Docnav
|[[Points_Export|Export]]
|[[Points_Structure|Structure]]
|[[Points_Workbench|Points]]
|IconL=Points_Export.svg
|IconR=Points_Structure.svg
|IconC=Workbench_Points.svg
}}


⚫
<!--T:5-->
⚫
{{Userdocnavi}}
</translate>
</translate>
⚫
{{Points Tools navi{{#translation:}}}}
⚫
{{Userdocnavi{{#translation:}}}}

Latest revision as of 16:15, 25 November 2023

Other languages:

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.


Points
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=Points_Convert&oldid=1332332"