Donate

Export

Points

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

For point cloud files with the .asc, .pcd or .ply extension the following rules apply:

• 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.

Scripting

The code below can be used to scale an imported point cloud. Select the point cloud and run the code, either by pasting it in the Python console, or by saving it as a macro and executing that macro.

from PySide import QtWidgets
import FreeCAD as App
import FreeCADGui as Gui

def scale_points(obj, scale_x, scale_y, scale_z):
    mtx = App.Matrix()
    mtx.scale(scale_x, scale_y, scale_z)
    pts = obj.Points.copy()
    pts.transformGeometry(mtx)
    obj.Points = pts
    App.ActiveDocument.recompute()

if Gui.Selection.getSelection():
    obj = Gui.Selection.getSelection()[0]
    if obj.isDerivedFrom("Points::Feature"):
        scale, ok = QtWidgets.QInputDialog.getDouble(
            None,
            "Scale point cloud",
            "Scale:",
            value=1.0,
            decimals=6
        )
        if ok:
            scale_points(obj, scale, scale, scale)

Export

Points