Points Import: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
No edit summary
 
(23 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:10-->
<!--T:10-->
{{Docnav
{{Docnav||[[Points_Export|Export]]|[[Points_Module|Points]]|IconL=|IconC=PointsWorkbench.svg|IconR=Points_Export_Point_cloud.svg}}
|
|[[Points_Export|Export]]
|[[Points_Workbench|Points]]
|IconL=
|IconR=Points_Export.svg
|IconC=Workbench_Points.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Icon=Points_Import.svg
|Name=Points Import
|Name=Points Import
|MenuLocation=Points → Import points
|MenuLocation=Points → Import points...
|Workbenches=[[Points Module|Points]]
|Workbenches=[[Points_Workbench|Points]]
|SeeAlso=[[Points Export]]
|SeeAlso=[[Import_Export|Import Export]]
}}
}}


== Description== <!--T:2-->
==Description== <!--T:2-->
This tool imports 3D points from a point cloud file.


== How to use == <!--T:3-->
<!--T:14-->
The '''Points Import''' command imports a point cloud from a file.
# Click on {{Button|[[Image:Points_Import.svg|16px]] [[Points Import]]}} or use the menu {{MenuCommand|Points → [[Image:Points_Import.svg|16px]] Import points}}.
# Select the file with point cloud and click {{Button|Open}}.


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


<!--T:5-->
<!--T:15-->
# There are several ways to invoke the command:
* The coordinates of the points should be read from a text file with the extension {{incode|.asc}}.
#* Press the {{Button|[[Image:Points_Import.svg|16px]] [[Points_Import|Import Points...]]}} button.
* Each line should have a collection of X, Y, Z coordinates separated by a space. The coordinates must use a decimal point, not a decimal comma.
#* Select the {{MenuCommand|Points → [[Image:Points_Import.svg|16px]] Import Points...}} option from the menu.
* After importing, your points will be selectable in the 3D view, and they can be snapped to using the [[Draft Endpoint|Snap Endpoint]] method from the [[Draft Workbench]].
# Select a point cloud file.
* The cloud point will be imported as a single cloud object. This is unlike the [[Draft Point|Draft Point]] tool which creates individual points.
# Press the {{Button|Open}} button.


== Sample point cloud file == <!--T:6-->
==Properties== <!--T:16-->

<!--T:17-->
See [[Points_Convert|Points Convert]].

==Point cloud file format== <!--T:18-->

<!--T:19-->
* A point cloud file must have the {{FileName|.asc}}, {{FileName|.pcd}} or {{FileName|.ply}} extension.
* Each line in the file must list the X, Y and Z coordinates of a point.
* The coordinates must be separated by spaces.
* The coordinates must use a decimal point, not a decimal comma.

==Sample point cloud file== <!--T:6-->


</translate>
</translate>
0 0 0
{{Code|code=
1.4562 -7.2354 12.2367
0 0 0
1.4562 -7.2354 12.2367
5.9423 3.1728 -17.6439
5.9423 3.1728 -17.6439
}}
<translate>
<translate>


<!--T:7-->
<!--T:7-->
For testing you can use this [https://github.com/FREECAD/Examples/blob/master/Point_cloud_ExampleFiles/PointCloud-Data_Stanford-Bunny.asc ASC] file, which is a low polygon version of the [http://graphics.stanford.edu/data/3Dscanrep/ Stanford Bunny].
For testing you can use [https://raw.githubusercontent.com/FreeCAD/Examples/master/Point_cloud_ExampleFiles/PointCloud-Data_Stanford-Bunny.asc this file], which is a low polygon version of the [http://graphics.stanford.edu/data/3Dscanrep/ Stanford Bunny].


<!--T:8-->
{{Docnav||[[Points_Export|Export]]|[[Points_Module|Points]]|IconL=|IconC=PointsWorkbench.svg|IconR=Points_Export_Point_cloud.svg}}


<!--T:11-->
<!--T:8-->
{{Docnav
{{Points Tools navi}}
|
|[[Points_Export|Export]]
|[[Points_Workbench|Points]]
|IconL=
|IconR=Points_Export.svg
|IconC=Workbench_Points.svg
}}


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

Latest revision as of 15:58, 25 November 2023

Points Import

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

Description

The Points Import command imports a point cloud from a file.

Usage

  1. There are several ways to invoke the command:
    • Press the Import Points... button.
    • Select the Points → Import Points... option from the menu.
  2. Select a point cloud file.
  3. Press the Open button.

Properties

See Points Convert.

Point cloud file format

  • A point cloud file must have the .asc, .pcd or .ply extension.
  • Each line in the file must list the X, Y and Z coordinates of a point.
  • The coordinates must be separated by spaces.
  • The coordinates must use a decimal point, not a decimal comma.

Sample point cloud file

0 0 0
1.4562 -7.2354 12.2367
5.9423 3.1728 -17.6439

For testing you can use this file, which is a low polygon version of the Stanford Bunny.