Points Import: Difference between revisions

From FreeCAD Documentation
(Removed 'in progress'.)
No edit summary
 
(7 intermediate revisions by 3 users not shown)
Line 4: Line 4:
<!--T:10-->
<!--T:10-->
{{Docnav
{{Docnav
|
|[[Points_Structure|Points Structure]]
|[[Points_Export|Points Export]]
|[[Points_Export|Export]]
|[[Points_Module|Points]]
|[[Points_Workbench|Points]]
|IconL=
|IconL=
|IconR=Points_Export.svg
|IconR=Points_Export.svg
Line 16: Line 16:
|Name=Points Import
|Name=Points Import
|MenuLocation=Points → Import points...
|MenuLocation=Points → Import points...
|Workbenches=[[Points_Module|Points]]
|Workbenches=[[Points_Workbench|Points]]
|SeeAlso=[[Import_Export|Import Export]]
|SeeAlso=[[Import_Export|Import Export]]
}}
}}
Line 22: Line 22:
==Description== <!--T:2-->
==Description== <!--T:2-->


<!--T:14-->
The '''Points Import''' command imports a point cloud from a file.
The '''Points Import''' command imports a point cloud from a file.


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


<!--T:15-->
# There are several ways to invoke the command:
# There are several ways to invoke the command:
#* Press the {{Button|[[Image:Points_Import.svg|16px]] [[Points_Import|Points Import]]}} button.
#* Press the {{Button|[[Image:Points_Import.svg|16px]] [[Points_Import|Import Points...]]}} button.
#* Select the {{MenuCommand|Points → [[Image:Points_Import.svg|16px]] Import Points...}} option from the menu.
#* Select the {{MenuCommand|Points → [[Image:Points_Import.svg|16px]] Import Points...}} option from the menu.
# Select a point cloud file.
# Select a point cloud file.
# Press the {{Button|Open}} button.
# Press the {{Button|Open}} button.


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


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

See [[Points_Convert|Points Convert]].
See [[Points_Convert|Points Convert]].


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


<!--T:19-->
* A point cloud file must have the {{FileName|.asc}}, {{FileName|.pcd}} or {{FileName|.ply}} extension.
* 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.
* Each line in the file must list the X, Y and Z coordinates of a point.
Line 53: Line 56:


<!--T:7-->
<!--T:7-->
For testing you can use [https://github.com/FREECAD/Examples/blob/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].
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-->
<!--T:8-->
{{Docnav
{{Docnav
|
|[[Points_Structure|Points Structure]]
|[[Points_Export|Points Export]]
|[[Points_Export|Export]]
|[[Points_Module|Points]]
|[[Points_Workbench|Points]]
|IconL=
|IconL=
|IconR=Points_Export.svg
|IconR=Points_Export.svg
Line 69: Line 72:
{{Points Tools navi{{#translation:}}}}
{{Points Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

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.