Points Import: Difference between revisions

From FreeCAD Documentation
(Grammar.)
(Revised. Added 'in progress' for now.)
Line 1: Line 1:
<languages/>
<languages/>

{{Page in progress}}

<translate>
<translate>

<!--T:10-->
<!--T:10-->
{{Docnav
{{Docnav
|[[Points_Structure|Points Structure]]
|
|[[Points_Export|Export]]
|[[Points_Export|Points Export]]
|[[Points_Module|Points]]
|[[Points_Module|Points]]
|IconL=|IconC=Workbench_Points.svg
|IconL=
|IconR=Points_Export_Point_cloud.svg
|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_Module|Points]]
|SeeAlso=[[Points Export]]
}}
}}


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


The '''Points Import''' command imports a point cloud from a file.
== Usage == <!--T:3-->
# Invoke the Import Points command several ways:
#* Press on the [[Image:Points_Import.svg|24px]] [[Points Import]] button in the Points toolbar
#* Use the {{MenuCommand|Points → [[Image:Points_Import.svg|16px]] Import points}} from the Points menu.
# Select the point cloud file
# Press {{Button|Open}}.


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


# There are several ways to invoke the command:
<!--T:5-->
#* Press the {{Button|[[Image:Points_Import.svg|16px]] [[Points_Import|Points Import]]}} button.
* The point cloud file should have one of the following extensions {{incode|.asc}}, {{incode|.pcd}} or {{incode|.ply}}.
#* Select the {{MenuCommand|Points → [[Image:Points_Import.svg|16px]] Import Points...}} option from the menu.
* 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 a point cloud file.
* After importing, your points will be selectable in the [[3D view]], and they can be snapped to using the [[Image:Snap_Endpoint.svg|24px]] [[Draft Endpoint|Snap Endpoint]] method from the [[Image:Workbench_Draft.svg|24px]] [[Draft Workbench]].
# Press the {{Button|Open}} button.
* The cloud point will be imported as a single cloud object. This is unlike the [[Image:Draft_Point.svg|24px]] [[Draft Point|Draft Point]] tool which creates individual points.


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

* 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://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].



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


<!--T:11-->
{{Points Tools navi}}

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

Revision as of 17:07, 21 August 2020

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.


Points Import

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

Description

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

Usage

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

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.