Points Import: Difference between revisions

Latest revision as of 15:58, 25 November 2023

Other languages:

Menu location
Points Import
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

There are several ways to invoke the command:
- Press the Import Points... button.
- Select the Points → Import Points... option from the menu.
Select a point cloud file.
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.

Export

Points

Tools: Convert to points, Structured point cloud, Import points, Export points, Cut point cloud, Merge point clouds

User documentation

Getting started
Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

Help: Tutorials, Video tutorials
Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web

Addons: Addon Manager, External workbenches, Scripting and macros

Hubs: User hub, Power users hub, Developer hub

@@ Line 1: / Line 1: @@
 <languages/>
 <translate>
 <!--T:10-->
 {{Docnav
 |
 |[[Points_Export|Export]]
-|[[Points_Module|Points]]
+|[[Points_Workbench|Points]]
-|IconL=|IconC=Workbench_Points.svg
+|IconL=
-|IconR=Points_Export_Point_cloud.svg
+|IconR=Points_Export.svg
+|IconC=Workbench_Points.svg
 }}
 <!--T:1-->
 {{GuiCommand
-|Icon=Points_Import.svg
 |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.
-== Usage == <!--T:3-->
+<!--T:14-->
-# Invoke the Import Points command several ways:
+The '''Points Import''' command imports a point cloud from a file.
-#* 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-->
-<!--T:5-->
+<!--T:15-->
+# There are several ways to invoke the command:
-* The point cloud file should one of the following extensions {{incode|.asc}}, {{incode|.pcd}} or {{incode|.ply}}.
+#* 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 [[Image:Snap_Endpoint.svg|24px]] [[Draft Endpoint|Snap Endpoint]] method from the [[Image:Workbench_Draft.svg|24px]] [[Draft Workbench]].
+# Select a point cloud file.
-* 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.
+# 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>
+0 0
-{{Code|code=
+.4562 -7.2354 12.2367
-0 0
-.4562 -7.2354 12.2367
+.9423 3.1728 -17.6439
-.9423 3.1728 -17.6439
-}}
 <translate>
 <!--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-->
@@ Line 54: / Line 63: @@
 |
 |[[Points_Export|Export]]
-|[[Points_Module|Points]]
+|[[Points_Workbench|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>
+{{Points Tools navi{{#translation:}}}}
+{{Userdocnavi{{#translation:}}}}