Points Import: Difference between revisions

From FreeCAD Documentation
No edit summary
m (linted templates + Reformatted 'Usage' section + added templates and links)
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:10-->
{{Docnav
|
|[[Points_Export|Export]]
|[[Points_Module|Points]]
|IconL=|IconC=Workbench_Points.svg
|IconR=Points_Export_Point_cloud.svg
}}


<!--T:1-->
<!--T:1-->
Line 14: Line 22:
This tool imports 3D points from a point cloud file.
This tool imports 3D points from a point cloud file.


== How to use == <!--T:3-->
== Usage == <!--T:3-->
# Invoke the Import Points command several ways:
⚫
# Click on {{Button|[[Image:Points_Import.svg|16px]] [[Points Import]]}} or use the menu {{MenuCommand|Points → [[Image:Points_Import.svg|16px]] Import points}}.
#* Press on the [[Image:Points_Import.svg|24px]] [[Points Import]] button in the Points toolbar
⚫
# Select the file with point cloud and click {{Button|Open}}.
⚫
#* 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-->
=== Notes === <!--T:4-->
Line 23: Line 34:
* The coordinates of the points should be read from a text file with the extension {{incode|.asc}}.
* The coordinates of the points should be read from a text file with the extension {{incode|.asc}}.
* 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.
* 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.
* 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]].
* 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]].
* The cloud point will be imported as a single cloud object. This is unlike the [[Draft Point|Draft Point]] tool which creates individual points.
* 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-->
== Sample point cloud file == <!--T:6-->
Line 40: Line 51:


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

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


Revision as of 00:14, 12 February 2020

Other languages:

Points Import

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

Description

This tool imports 3D points from a point cloud file.

Usage

  1. Invoke the Import Points command several ways:
    • Press on the Points Import button in the Points toolbar
    • Use the Points → Import points from the Points menu.
  2. Select the point cloud file
  3. Press Open.

Notes

  • The coordinates of the points should be read from a text file with the extension .asc.
  • 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.
  • After importing, your points will be selectable in the 3D view, and they can be snapped to using the File:Snap Endpoint.svg Snap Endpoint method from the Draft Workbench.
  • The cloud point will be imported as a single cloud object. This is unlike the Draft Point tool which creates individual points.

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 ASC file, which is a low polygon version of the Stanford Bunny.

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