Getting Started
PTCloud Digitizer is a desktop application for point cloud visualization, survey digitizing and CAD drafting, with tools for terrain modelling and automatic feature detection.
System Requirements
- Windows 10 or Windows 11, 64-bit (32-bit Windows is not supported)
- Graphics card and driver with OpenGL 4.5 support
- Microsoft Visual C++ 2015–2022 Redistributable (x64) — installed automatically by the installer if missing
- 8 GB RAM minimum, 16 GB or more recommended for large point clouds
- SSD storage recommended
- Internet connection for license activation (the program can then run offline for a limited grace period)
Installation
- Run
PTCloudDigitizer_Setup_2.0.0.exe - Choose the installer language (Hungarian or English) and follow the wizard
- The program is installed for the current user into
%LOCALAPPDATA%\Programs\PTCloudDigitizer; administrator rights are not needed. If the Visual C++ runtime has to be installed, Windows asks for confirmation once - Optionally create a desktop icon. The program is added to the Start menu
Uninstall from Windows Settings > Apps or from the Start menu entry.
First Steps
- Start the program and activate your license (see License Activation)
- Create a project: File > New Project and select a folder
- Import a point cloud: File > Import > Point Cloud (LAS/LAZ)...
- The view zooms to the point cloud automatically. Later you can use the Zoom Extents button to fit everything in view
License Activation
The license is bound to your computer and is checked online at startup.
Activating
- When no valid license is found, the License Activation window appears at startup
- Enter your license key. It is formatted automatically as
XXXX-XXXX-XXXX-XXXX - Click Activate (or press Enter). Exit closes the program
Server messages are shown in the window (errors in red, “Connecting to server...” in yellow).
Offline Use
After activation the program can be used without an internet connection for a grace period set by your license (typically a few days). Connect to the internet regularly to renew it.
License Information & Deactivation
Help > License Info... shows the masked license key, tier, expiry date and online/offline status with the remaining offline days. Deactivate License... releases the license from this computer (for example before moving to a new machine); the program closes afterwards.
Interface Overview
The interface consists of a menu bar, a tabbed ribbon, the viewport and dockable panels.
Menu Bar
| Menu | Contents |
|---|---|
| File | New Project, Open Project..., Save, Save As..., Close Project, Import, Export, Recent Projects, Preferences..., Exit |
| Edit | Undo, Redo, Delete, Select All, Deselect All |
| View | Show/hide panels, 3D Preview Window, Camera Views (Top, Front, Right, Perspective, Zoom Extents) |
| Tools | Snap Settings, Volume Calculation, Copy / Move / Rotate of the selection |
| Help | Help Topics, License Info... |
Ribbon Tabs
| Tab | Buttons |
|---|---|
| Draw | Point, Line, Polyline, Circle, Arc, Rectangle, Polygon, Hatch, Edge Trace, Text, Text Settings, Dimension, Dimension Settings, Altitude, Altitude Settings |
| Building | Roof, Roof Profile, Room, 3DWall, Door, Window, Opening |
| Modify | Trim, Extend, Intersect, Break 1pt, Break 2pt, Cut Between, Parallel, Copy Style |
| Viewport and 3D Views | Horizontal Section, Vertical Section, X-Ray, 3D Preview, Top, Front, Right, 3D Perspective, Zoom Extents |
| Panels | Horizontal Section, Vertical Section, X-Ray Panel, Floors Panel |
| Export | DXF, IFC, Points, Section Image |
| Pointcloud Tools | Ground Classify, Detect Trees, Fit Tree (click), Export Trees, Detect Poles, Fit Pole (click), Export Poles, Trace Wire (auto), Trace Wire (semi), Create Grid Points, Export Grid Points, Create TIN Surface, Enable/Disable Surface Edit, Volume Calculation, Select Points |
A large icon on the right end of the ribbon shows the active command (grey cursor icon when no command is active). Ribbon buttons have tooltips.
Panels
| Panel | Purpose |
|---|---|
| Project Browser | Tree of point clouds, imported DXF files, orthophotos, floors, CAD entities, trees, poles, grids, TIN surfaces and volume calculations. Most objects have a right-click menu |
| Properties | Properties of the selected entity or entities; values can be edited directly. Includes bulk operations for multiple selections |
| Layers | Layer management (see Layers) |
| Active Tool | Settings of the current command: layer, floor, elevation, Q radius, point number/code/description, Continuous editing, Parallel distance, Edge Trace parameters, 3D Wall floor buttons |
| Command Line | Command input, prompts and message history (see Command Line) |
| Section Plane / Vertical Section / X-Ray View | Settings of the section views |
| Floor Manager | Floors and levels (see Floors & Levels) |
| Snap Settings | Snap modes and snap radius |
Panels are shown or hidden from the View menu and can be docked or floated. Panel visibility and the docking layout are saved automatically (in layout.json next to the program) and restored at the next start.
Status Bar
Shows the status message, FPS, the number of loaded points, GPU memory, and indicators for measurement (F2), snap, grid and the quick popups (F4–F7). Clicking the snap indicator opens a snap popup. The cursor coordinates are displayed in the viewport itself.
Project Management
A project stores the point cloud references, CAD entities, layers, floors, sections, grids, TIN surfaces and volume calculations.
Creating and Opening
- File > New Project — select a folder; the project file is created in it and named after the folder
- File > Open Project... — open an existing
.ptprojfile - File > Recent Projects — reopen a recently used project (Clear Recent Projects empties the list)
- File > Close Project
Saving
- File > Save or Ctrl+S
- File > Save As...
- When closing a project or the program with unsaved changes, you are asked to Save, Discard or Cancel
Project Folder
<FolderName>.ptproj— main project file (JSON)<FolderName>.entities.json— CAD entities<FolderName>.codes.json— point code librarysectionparams.json— vertical section definitionspointclouds/— point clouds created by the program (e.g. ground classification results)tiles/,exports/— working folders
Point Clouds
Supported Formats
| Format | Extension | Description |
|---|---|---|
| LAS/LAZ | .las, .laz | ASPRS LiDAR format, uncompressed and compressed |
| E57 | .e57 | ASTM E57 scanner exchange format |
| PLY | .ply | Polygon File Format with RGB colors |
| PTS | .pts | Leica text format |
| XYZ | .xyz | Text format with optional RGB/intensity columns |
Importing
- File > Import > Point Cloud (LAS/LAZ)... (the file dialog accepts all formats above)
- Select the file. Progress is shown in the Command Line
- The view zooms to the new cloud automatically
To load only part of a large cloud, use File > Import > Point Cloud with Decimation...:
| Option | Points loaded | Use case |
|---|---|---|
| 100% (All Points) | All | Full detail |
| 50% (Every 2nd Point) | Every 2nd | Large scans |
| 25% (Every 4th Point) | Every 4th | Very large scans |
| 10% (Every 10th Point) | Every 10th | Quick preview |
| 5% (Every 20th Point) | Every 20th | Overview only |
The maximum number of points loaded is limited by Max Points (millions) in File > Preferences > Software (default 100 million, 0 = no limit).
Point Cloud Menu (Project Browser)
Right-click a point cloud in the Project Browser:
- Hide / Show
- Color Override — display the whole cloud in one color (Red, Blue, Green, Yellow, Cyan, Magenta)
- Display Mode:
- RGB — original colors
- Intensity — with selectable color schemes
- Classification — only if the cloud contains class data; individual classes can be shown or hidden (Show All / Hide All)
- Height (elevation) — color by Z. The Low cut / High cut sliders squeeze the color ramp onto a height band (useful for wires or low vegetation); Reset to full range restores it
- Set Display Shift... / Reset Display Shift (see Real-World Coordinates)
- Save Decimated — for clouds imported with decimation: save the reduced cloud in LAS, PLY, XYZ or PTS format
- Export Grid Points / Delete Grid Points — for clouds that have grid points (see Grid Points)
- Remove from project
Real-World Coordinates
Survey coordinates are large numbers (e.g. 640123.456, 245678.890). To keep rendering precise, the program shifts the data near the origin internally and shows real-world values everywhere.
- The first loaded point cloud sets the world reference offset; later clouds use the same offset, so clouds in the same coordinate system line up automatically
- The offset is shown in the Project Browser under Point Clouds (“World Offset: ...”)
- The viewport cursor shows real-world coordinates in color, with the local coordinates below in grey
- The Properties panel and the Measurement panel show real-world values first, local values in grey
- All exports (DXF, points, trees, poles, grid points, LandXML) write real-world coordinates
Display Shift
To temporarily move a cloud on screen without changing its data: right-click it in the Project Browser > Set Display Shift... and enter X/Y offsets. Shifted clouds are listed in red with a [SHIFTED] tag. Reset Display Shift removes the offset.
Viewports & Navigation
View Types
Switch the viewport content with the buttons on the Viewport and 3D Views ribbon tab:
| View | Description | Drawing |
|---|---|---|
| 3D Point Cloud (Top / Front / Right / 3D Perspective) | 3D view with orthographic presets or perspective orbit camera | In the orthographic views (not in perspective) |
| Horizontal Section | Top-down view of a horizontal slice at a given elevation | Yes |
| Vertical Section | Side view along a section line | Yes |
| X-Ray | Top-down density view (grayscale) | Yes |
The camera presets are also in View > Camera Views and in the F5 quick popup.
Mouse Navigation
| Action | 3D Perspective | Top/Front/Right, sections, X-Ray |
|---|---|---|
| Pan | Middle button + drag | Middle button + drag |
| Orbit | Right button + drag (around the point under the cursor) | — |
| Zoom | Scroll wheel (toward the cursor) | Scroll wheel (at the cursor) |
Zoom Extents
Fits all data in view. Available as the Zoom Extents ribbon button, the button in the top-right corner of the viewport, View > Camera Views > Zoom Extents, and F5 then 5.
Section Views
Horizontal Section
Shows a horizontal slice of the point cloud from above. Set the elevation of the cut and its thickness (total slab thickness, half above and half below the elevation) in the Section Plane panel (Panels > Horizontal Section).
Vertical Sections
Vertical sections are named section lines with a thickness and an offset.
- Open the Vertical Section panel (Panels > Vertical Section) and click New Section
- Click the start and the end point of the section line in the viewport
- Accept or change the suggested name (e.g. “Section A-A”)
- Default thickness is 0.5 m, default step 0.1 m (changeable in the panel)
- In the Vertical Section view, ↑/→ move the section forward and ↓/← backward by one step
- Right-click a section in the panel: Set as Active, Rename, Delete
- Section lines can be edited with grips in the top-down view: blue grips at the ends, green grip in the middle (moves the whole line)
X-Ray View
A top-down density image of the cloud. Its settings are in the X-Ray View panel (Panels > X-Ray Panel).
3D Preview Window
An independent floating 3D window (3D Preview ribbon button, View > 3D Preview Window or F5 then 8):
- Middle button pan, right button orbit, scroll zoom
- Preset views: Top, Front, Right, 3D
- Optional horizontal slice with Bottom Z / Top Z sliders
Orthophoto Import
- File > Import > Orthophoto...
- Select a PNG, JPEG, TIFF or BMP image
- The accompanying world file (
.pgw,.jgw,.tfw,.wld, etc.) is detected automatically. If none is found, you can locate it manually; otherwise the image is placed at the origin at 1 pixel = 1 unit - The image is placed at the minimum Z of the point cloud
In the Project Browser, expand the orthophoto to adjust Opacity, Brightness, Contrast, Saturation and Z. Right-click offers Hide/Show and Remove from project.
Orthophotos are shown in the 3D, horizontal section and X-Ray views, below the point cloud. When an orthophoto is visible, CAD entities are drawn with a dark outline for better readability.
Drawing Tools
Drawing tools are on the Draw ribbon tab, in the F6 quick popup, and can be started by typing their command in the Command Line. Drawing works in the orthographic 3D views, horizontal sections, vertical sections and X-Ray view (not in 3D perspective).
Available Tools
| Tool | Command | Usage |
|---|---|---|
| Point | point | Place survey points with number, code and description (see Survey Points) |
| Line | line | Click points to draw connected line segments; Esc to finish |
| Polyline | polyline, pline | Click vertices; Enter to finish |
| Circle | circle | Center + radius by default; other modes below |
| Arc | arc | Center + start + end by default; other modes below |
| Rectangle | rectangle, rec | Click the first corner, then the opposite corner — or type the size as width,height in the Command Line after the first click |
| Polygon | polygon | Regular polygon with 3–64 sides: type the side count (or d for the default), click the center, click the radius point. The bottom side is always horizontal |
| Hatch | hatch, h | Click inside a closed boundary (see Annotation Tools) |
| Edge Trace | — | Semi-automatic edge tracing in vertical sections (see Edge Trace) |
| Text / Dimension / Altitude | text/t, dimension/dim, altitude/alt | See Annotation Tools |
Building tools (Door, Window, Opening, Room, Roof, Roof Profile, 3D Wall) are described in Building Elements.
Circle Modes
While the Circle tool is active, type a mode in the Command Line and press Enter:
cr/center— center + radius (default)3p/3point— circle through 3 clicked pointsttr— tangent to two entities with a given radiustp— tangent mode
Circles drawn in a vertical section lie on the section plane; they appear in all views and are exported to DXF as real circles.
Arc Modes
cse/center— center, start, end (default). The mouse movement decides the direction (clockwise / counter-clockwise), arcs over 180° are possible3p— arc through 3 pointsttr,tp— tangent modes
Active Tool Panel
While a drawing tool is active, its settings are shown in the Active Tool panel:
- Layer — layer for new entities. Changing the tool does not change the layer
- Floor — floor assignment (Unassigned or a defined floor)
- Elevation — Z of new entities: Floor / Ceiling / Custom when a floor is selected, direct input otherwise. The current Z (or the Q-picked height) is shown
- Q Rad — search radius of the Q height pick
- For the Point tool: point number, code and description
Height Pick with Q
Hold Q while drawing to take the Z value from the point cloud around the cursor:
- Works with Point, Line, Polyline, Circle, Arc, Polygon, Dimension, Altitude and the measurement tools, in all drawing views except the Vertical Section view
- The average height is sampled once when Q is pressed and used for clicks while Q is held. Release and press Q again to sample at a new position
- A red circle shows the search radius and the picked height is displayed next to the cursor
- The radius is set in the Active Tool panel or in Preferences (default 0.5 m)
Orthogonal Drawing
Hold Shift while drawing to lock the next segment horizontally or vertically.
Finishing and Repeating
- Esc or a right-click cancels the current command
- When no command is active and there is nothing under the cursor, a right-click restarts the last used command
Survey Points
Placing Points
- Start the Point tool (Draw tab, F6 then 1, or the
pointcommand) - Set the number, code and description in the Active Tool panel
- Click in the viewport. The point number increases automatically after each point
- If the number already exists, the field turns red; click the ! icon to jump to the next free number
- New codes are added to the project's code library automatically
Importing a Code List
File > Import > Point Codes... reads a CSV or TXT file with one code,description per line (description optional, lines starting with # are comments):
# Comment line
TREE,Tree location
FENCE,Fence point
BLDG,Building corner
POST
Importing Survey Points
File > Import > Survey Points (CSV/TXT)... opens the Import Survey Points dialog:
- Column Format: PNEZC, PENZC, PNEZ, PENZ, NEZ, ENZ or XYZ (P = point number, N = north, E = east, Z = elevation, C = code)
- Separator: Auto-detect, comma, semicolon, tab or space
- Skip Header Lines and Target Layer
- A preview shows the first 10 lines of the file (skipped lines in grey)
Point Display
In File > Preferences > Points: point symbol (cross, X, circle, square, triangle), symbol size, which labels to show (number, height, code, description), text size and label colors. Labels are shown in all view types.
Selecting Points by Attributes
Pointcloud Tools > Select Points opens the Point Selection Filter: filter by Code and Description (case-insensitive partial match), Layer, number range (Number From / To, 0 = no limit) and grid source cloud. The number of matching points is shown; use Select Matching, Deselect Matching or Delete Selected Points.
Entities in Vertical Sections
- Points, circles and polygons drawn in a vertical section store the section position. Points and polygons only appear when the same section position is displayed
- Section polygons are only visible in their section and in the section DXF export
- Circles, lines and polylines drawn in a section are real 3D entities on the section plane and appear in all views
Editing Elevations
Select an entity and open the Elevation part of the Properties panel: enter a Z value or use Set to Floor Elevation... / Set to Ceiling Elevation.... With several entities selected, the bulk operations allow setting the elevation of all of them at once.
Building Elements
The Building ribbon tab contains tools for digitizing buildings from floor plan sections.
Door, Window, Opening
Doors, windows and openings are placed between two parallel wall lines:
- Click the baseline (a line or polyline: one face of the wall)
- Click the frame line (the other face of the wall)
- Click point A on the baseline (for doors: the hinge side)
- Click point B on the baseline — the element is created
The tool stays active for the next element; Esc exits. Commands: door, window, opening; also in the F6 popup (4, 5, 6). Height labels and line overhang are set in Preferences > D/W/O. The right-click menu of a selected door, window or opening offers Set Height from Section and Unlock Height.
Room
Click the boundary points of the room and press Enter. The room number, name, area and perimeter are displayed; the next room number and the label settings are in Preferences > Room. To move a room label, right-click it, then click the new position.
Roof
Click the boundary points of the roof and press Enter. In the Properties panel choose the type (Flat, Gable, Hip, Shed), slope and overhang; the 3D roof surface is generated automatically.
Roof Profile
- In a Vertical Section view, start Roof Profile (command
rporroofprofile) - Click the profile points and press Enter
- Select the profile, right-click and choose Set Extrusion (pick 2 points) or Set Extrusion (enter depth)... to extrude it perpendicular to the section. Clear Extrusion removes it
3D Wall
- Start 3DWall (command
3dwallorwall). At least one floor must exist - Choose the floor with the buttons in the Active Tool panel (the last used floor is preselected)
- Click inside a region enclosed by wall lines. The boundary, including interior holes, is detected and previewed
- Press Enter to accept the preview; click inside the next region to continue; Esc exits
The wall is extruded between the floor and ceiling elevation of the selected floor.
Command Line
The Command Line panel shows prompts and messages, and accepts typed commands. Click into the input field, type the command and press Enter.
Commands
| Category | Commands (aliases) |
|---|---|
| Drawing | point, line, polyline (pline), circle, arc, rectangle (rec), polygon, hatch (h), text (t), dimension (dim), altitude (alt) |
| Building | door, window, opening, roof, roofprofile (rp), room, 3dwall (wall) |
| Modify | intersect, extend, trim, parallel, break1pt, break2pt, cutbetween, copystyle (cs) |
| Selection | copy, move, rotate, delete (erase) — require a selection |
Commands are not case-sensitive. Inside commands the Command Line also takes values: circle/arc modes, the polygon side count, the rotation angle and the rectangle size.
Suggestions
While typing, matching commands are suggested above the input (up to 6). Use ↑/↓ to choose, Tab to complete and Esc to close the list.
Editing Tools
Selecting
- Click an entity to select it; Ctrl+click adds or removes entities
- Edit > Select All / Deselect All; in the Project Browser, entity groups have Select All / Deselect All
- Esc clears the selection when no command is active
Grip Editing
When exactly one point, line or polyline is selected, grips appear: blue grips at end points and vertices, green grips at segment midpoints (move the whole segment). Drag a grip to change the geometry. Grips are not available in the Vertical Section view.
Modify Commands
On the Modify tab, in the F7 quick popup (1–7) and as Command Line commands. They work in plan views and in vertical sections, but not in 3D perspective.
| Command | Description |
|---|---|
| Intersect | Click two lines: both are trimmed or extended to their intersection, keeping the parts you clicked |
| Extend | Select the boundary first, then click the lines to extend to it |
| Trim | Select the cutting line first, then click the parts to trim |
| Parallel | Create a parallel copy of a line, arc or circle. The distance is set in the Active Tool panel, or measured with its Pick button by clicking two points |
| Cut Between | Remove the part of a line between two cutting lines |
| Break 1pt | Split a line into two at one point |
| Break 2pt | Remove the part of a line between two points |
| Copy Style | Click a reference entity, then click target entities to give them its layer and style |
Continuous Editing
With Continuous enabled (checkbox in the Active Tool panel, or Preferences > Software; on by default), Trim, Extend, Parallel, Copy, Copy Style, Break 1pt and Break 2pt stay active after each operation:
- Trim / Extend: the cutting/boundary line stays selected, just keep clicking target lines
- Parallel: the distance is kept, select the next entity
- Copy: click more destination points
- Break: select the next line
End the command with Esc or a right-click.
Copy, Move, Rotate, Align, Delete
Select the entities first. Then use the viewport right-click menu, the Tools menu, the Command Line, or (with the mouse over the viewport) the keys below:
| Operation | Key | Steps |
|---|---|---|
| Copy | C | Click the base point, then the destination(s) |
| Move | M | Click the base point, then the destination |
| Rotate | R | Click the rotation center, then type the angle in the Command Line |
| Align to Entity | right-click menu | Click a reference line; the selection is rotated to its direction |
| Delete | Delete | Deletes the selection |
The right-click menu also has Change Layer and Deselect.
Undo / Redo
- Ctrl+Z or Edit > Undo
- Ctrl+Y / Ctrl+Shift+Z or Edit > Redo
Edge Trace
Semi-automatic tracing of continuous edges (building edges, terrain breaks, structural elements) across vertical section positions.
- Open a Vertical Section view and click Edge Trace on the Draw tab
- Click a start seed point on the edge
- Move the section with the arrow keys and click the next seed further along the edge
- The traced edge is previewed; add more seeds to extend it
- Press Enter to save it as a polyline (layer “Polylines”); Esc cancels
Parameters (Active Tool panel)
| Radius | Search radius around the predicted edge position |
| Max Gap | Number of consecutive section steps without data before tracing stops |
| Auto Continue | Continue tracing automatically beyond the last seed |
Annotation Tools
Annotations are placed on the current layer.
Hatch
- Start Hatch (Draw tab or
hatch) - Click inside a closed region bounded by lines, polylines, arcs or circles. The smallest enclosing region and its holes are found automatically
After creation, select the hatch to change in the Properties panel: pattern (Solid, Lines, Cross, Dots), scale, angle, color and opacity. The area (with holes subtracted) is calculated.
Text
- Start Text (or
text) and click the insertion point - In the Create Text dialog enter the text and set height, rotation, horizontal and vertical alignment, color and style
Text Settings opens the Text Styles editor (font size, width factor, oblique angle, bold).
Dimension
- Start Dimension (or
dim) - Click the first and the second point, then click to set the offset of the dimension line
Dimension Settings opens the Dimension Styles editor: text height, arrow size and type (Arrow, Tick, Dot, Oblique), decimal places, extension line offset/overshoot, units and color. A single dimension can have an override text in the Properties panel.
Altitude
- Start Altitude (or
alt) - Click a point with Point Cloud snap enabled, or hold Q while clicking — a height source is required
Altitude Settings opens the Altitude Styles editor: text height, decimal places, sign prefix, unit display, and a reference elevation for relative heights.
Layers
Each layer has a name, color, visibility and lock state. The active layer is marked “(ACTIVE)”.
Layers Panel
- Toolbar: + new layer, - delete (only empty layers), R rename, move up/down, AZ sort, show/hide all, lock/unlock all
- Per layer: visibility, lock and color; double-click to rename; drag to reorder
- Right-click a layer: Move Up, Move Down, Select All Entities, Rename, Delete
Default Layers
New projects contain: 0, Points, Lines, Polylines, Walls, Doors, Windows, Openings, Roofs, Rooms, Stairs, Furniture. Some tools create their own layers when needed, e.g. Grid Points, Contour_Major, Contour_Minor, Trees, Poles, Wires.
Floors & Levels
Floors organize entities by building level. Open the Floor Manager with Panels > Floors Panel, View > Floor Manager or F8.
- Each floor has a name, floor elevation, ceiling elevation and color. Split levels with several floor/ceiling elevations are supported
- Add Floor, Duplicate, Show All
- Right-click a floor: Set as Active, Show Only This, Edit Properties, Duplicate, Move Up, Move Down, Delete (only floors without entities)
- In the Edit Floor dialog, elevations can be picked from the point cloud
- Ctrl+PgUp / Ctrl+PgDn switch the active floor
- In the Project Browser: Set Active, Hide/Show, Show Only This Floor, Show All Floors, Move Selected Entities Here; single entities can be moved with Move to Floor
New entities get the floor and elevation (Floor / Ceiling / Custom) selected in the Active Tool panel.
Snapping
| Mode | Snaps to | Marker |
|---|---|---|
| Endpoint | End points of lines, polylines and arcs | Square |
| Midpoint | Midpoints of segments and arcs | Triangle |
| Intersection | Intersections of lines | X |
| Perpendicular | Perpendicular foot on a line | Cross (+) |
| Nearest | Nearest point on an entity | X in a circle |
| Center | Centers of circles and arcs (hover the circumference), doors, windows, openings and polylines | Circle with dot |
| Point Cloud | Points of the point cloud | Diamond |
- F3 switches snapping on/off
- F4 opens the snap quick popup: 1–7 toggle the modes, 0 toggles snapping on/off
- Detailed settings incl. Snap Radius: Snap Settings panel, Tools > Snap Settings, or Preferences > Snap
Measurement
Press F2 to open the Measurement panel and choose a mode:
| Mode | Clicks | Result |
|---|---|---|
| Point Data | 1 | X, Y, Z of the point |
| Distance (Orthogonal) | 2 | Distance with X/Y/Z components, plus 2D and 3D distance |
| Distance (Free 3D) | 2 | Direct 3D distance |
| Delta Height (Z) | 2 | Height difference, plus 2D and 3D distance |
Results show real-world coordinates (local values in grey). Q height pick and snapping work while measuring.
Ground Classification
Separates ground points from the point cloud with the Cloth Simulation Filter (CSF).
- Pointcloud Tools > Ground Classify
- Choose the Point Cloud and set the parameters
- Click Run Classification. A progress bar is shown; the run can be cancelled
| Parameter | Default | Meaning |
|---|---|---|
| Cloth Resolution | 1.00 m | Cloth grid size (0.1–5 m). Smaller is more detailed but slower |
| Max Iterations | 500 | Maximum simulation steps (50–2000) |
| Classification Threshold | 0.50 m | Maximum distance from the cloth for a point to count as ground |
| Slope Postprocessing | on | Improves results on hilly terrain |
| Time Step (Advanced) | 0.65 | Simulation time step |
Result: a new point cloud <name>_ground (shown in brown) saved as pointclouds\<name>_ground.las in the project folder. The original cloud is not changed. If no ground points are found, try a larger threshold, a smaller resolution or more iterations.
Grid Points, TIN & Contours
Create Grid Points
Pointcloud Tools > Create Grid Points samples the point cloud on a regular grid (tip: use the ground cloud from Ground Classification):
- Spacing X / Spacing Y (m, default 1.00) and Search Radius (m, default 1.50) — Z is the average height within the radius
- The estimated number of points is shown (warning above 500 000, maximum 5 million)
- Result: points with code “GRID” on the “Grid Points” layer. Grid positions without data are skipped
Grids are listed in the Project Browser under Grids; right-click: Hide/Show, Lock/Unlock, Export Grid Points..., Delete Grid Points. Export Grid Points (ribbon) writes a CSV with Number,East,North,Elevation,Code.
Create TIN Surface
- Pointcloud Tools > Create TIN Surface
- Enter the Surface Name and choose the sources: Grid points, Selected points, Selected lines/polylines as breaklines
- Click Create (at least 3 points are needed). A constrained Delaunay triangulation is built
In the Project Browser under TIN Surfaces each surface shows its triangle count, area and Z range, with a Fill Opacity slider. Right-click: Toggle Wireframe, Toggle Filled, Toggle Color by Elevation, Generate Contours..., Regenerate Contours, Delete Contours, Export as LandXML..., Delete Surface.
Editing a Surface
Pointcloud Tools > Enable Surface Edit (choose the surface if there are several). Click triangles to select them, Ctrl+click to add, or drag a rectangle; Delete removes the selected triangles. Existing contours are then marked as out of date (“contours stale”) and can be regenerated.
Contours
Generate Contours... on a surface: set the Major interval (default 1.00 m) and Minor interval (default 0.20 m). Contours are created as 3D polylines on the “Contour_Major” (red) and “Contour_Minor” layers and replace earlier contours of the surface.
LandXML Export
Export as LandXML... writes the surface as LandXML 1.2 (points and faces) with real-world coordinates.
Volume Calculation
Calculates cut and fill volumes between two TIN surfaces (e.g. original terrain and design or a later survey).
Creating a Calculation
- Open the Volume Calculations panel: Pointcloud Tools > Volume Calculation or Tools > Volume Calculation
- Click + New Calculation (at least two TIN surfaces are needed)
- Set the Name, Base Surface, Comparative Surface and Grid Cell Size (default 0.50 m)
- Click Create & Calculate
Results: Cut, Fill and Net volume (m³), cut, fill and total area (m²). Cut means the base surface is above the comparative surface. Display settings: cut and fill color, opacity, color map, grid.
Boundary
Right-click a calculation > Set Boundary Polyline... and click a closed polyline to limit the calculation to that area. Clear Boundary removes it; Recalculate updates the result.
PDF Report
- Right-click a calculation > Generate PDF Report...
- Choose a template (or “(Default Layout)”) and click Generate PDF.... The PDF opens automatically
Report Templates (Tools > Volume Calculation > Report Templates..., or Edit Templates...): page size (A4, A3, Letter, Legal), orientation, margins, multiple pages, and elements — static text, dynamic text (project, calculation, surfaces, date, volumes, areas, cell size, boundary), result table, top-down view and section view — positioned in millimetres.
Tree Detection
Finds tree trunks in the point cloud and determines their position, trunk diameter and height.
Automatic Detection
- Pointcloud Tools > Detect Trees, choose the point cloud
- Check the parameters and click Detect (runs in the background, can be cancelled)
- Review the candidates in the Detected Trees - Review window
| Parameter | Default | Meaning |
|---|---|---|
| Measure height | 0.40 m | Height above ground where the trunk is measured; must be below the first branches (orchard 0.3–0.5 m, forest DBH 1.3 m) |
| Slice thickness | 0.20 m | Thickness of the measuring slice |
| Min / Max diameter | 0.04 / 0.50 m | Accepted trunk diameter range |
| Cluster gap | 0.10 m | Maximum gap within one trunk cluster |
| Min fit quality | 0.55 | Minimum quality of the circle fit |
| Require vertical trunk column | on, 0.60 m | The trunk must continue vertically for at least this length |
| Require green crown above trunk | on | Requires green points above the trunk (crown start height, crown radius, min crown points, min green fraction, max crown offset). Skipped automatically for clouds without RGB |
| Limit to selected boundary | off | Search only inside one selected closed polyline |
| Estimate tree heights | on | Also determine tree height |
Reset to defaults restores the default values.
Reviewing
Each candidate is listed with diameter, height and quality and has an accept checkbox. Hovering a row highlights the tree in the viewport; clicking it makes it blink. Use Accept All, Reject All, then Add N Accepted Trees; Discard All or closing the window drops the candidates.
Fitting Single Trees
Fit Tree (click) switches on fit mode with its settings window (same main parameters plus Click search radius, 0.40 m). Click near a trunk in a plan, section or 3D view to fit and add that tree. Leave the mode with Exit Fit Mode, Esc or the ribbon button.
Result and Export
Trees are added to the “Trees” layer and listed in the Project Browser. The Properties panel shows base position, trunk diameter, measuring height, tree height, crown radius and fit quality. Export Trees writes a TXT/CSV file with the columns number,eovy,eovx,z,diameter,height (eovy = easting, eovx = northing, diameter in metres).
Pole Detection
Finds utility poles (also tilted poles and A-poles) and determines their axis, length, diameter and base point.
Automatic Detection
Pointcloud Tools > Detect Poles:
| Parameter | Default |
|---|---|
| Min length / Max length | 5.00 / 20.00 m |
| Max diameter | 0.80 m |
| Max tilt | 35° |
| Min linearity | 0.85 |
| Voxel size | 0.30 m |
| Min points | 40 |
| Max height | 20.0 m |
| Detect A-poles (leaning pairs) | on |
The candidates are reviewed in the Detected Poles - Review window the same way as trees. Each row shows type (Wood / Concrete, A for A-poles), length, diameter, tilt and quality.
Fitting Single Poles
Fit Pole (click): click near a pole to fit it (Click search radius 0.80 m). A-pole pairing is not done in this mode. Leave the mode with Exit Fit Mode or the ribbon button.
Result and Export
Poles are added to the “Poles” layer. The type (wood or concrete) is estimated from the taper and can be changed in the Properties panel, which also shows length, base and top diameter, axis, tilt and A-pole partner. Export Poles writes the same column format as the tree export (diameter = base diameter, height = pole length).
Wire Tracing
Traces overhead power lines as 3D polylines by following the wire through the point cloud. The first visible point cloud is used.
Automatic Mode
Pointcloud Tools > Trace Wire (auto), then click on a wire. The whole span is traced in both directions and saved immediately.
Semi-Automatic Mode
- Trace Wire (semi), click the start point on the wire
- Click ahead along the wire to give the direction
- The next point is proposed (green). Confirm it with a click, Enter or Confirm next
- Backspace / Undo removes the last point
- Finish saves the wire
Leave either mode with Exit Wire Mode or the ribbon button.
Parameters
| Parameter | Default | Meaning |
|---|---|---|
| Min height | 3.0 m | Only points at least this high above ground are used |
| Step distance | 1.50 m | Distance between traced points |
| Corridor radius | 0.40 m | Search radius around the predicted position |
| Wire tube radius | 0.15 m | Lower it (e.g. 0.10) if the trace jumps between parallel wires |
| Min corridor points | 3 | Minimum points needed to continue |
| Init radius | 1.20 m | Search radius around the first click |
Result: an open 3D polyline on the “Wires” layer (undoable). Tip: the Height (elevation) display mode with Low/High cut makes wires easy to see.
Export Options
Exports are in File > Export and on the Export ribbon tab. All exports use real-world coordinates.
DXF Export
File > Export > DXF... or the DXF button. The dialog shows the entity and layer counts and the Sill label prefix option. Entities hidden individually are not exported. Colors are converted to the nearest AutoCAD Color Index.
| Entity | DXF representation |
|---|---|
| Point | POINT (with code/description texts) |
| Line / Polyline | LINE / POLYLINE |
| Arc / Circle | ARC / CIRCLE |
| Door | LINEs, swing ARC and size label |
| Window / Opening | LINEs and label |
| Room | Closed POLYLINE and label block (number, name, area, perimeter) |
| Roof | Eave POLYLINE, 3DFACE surfaces and edge LINEs |
| 3D Wall | Top and bottom POLYLINEs, vertical edges and side 3DFACEs |
| Roof Profile | 3DFACE quads (extrusion) and POLYLINE outlines |
| Hatch | Closed POLYLINE boundaries (outer and holes) |
| Text | TEXT with height, rotation and alignment |
| Dimension | LINEs and TEXT |
| Altitude | POINT and TEXT |
Trees and poles are exported with Export Trees / Export Poles (see above), not to DXF.
Section DXF Export
File > Export > Section DXF... (available when a vertical section is active) exports the section as a flat 2D drawing: DXF X = distance along the section, DXF Y = elevation.
Point Export (CSV/TXT)
File > Export > Points (CSV/TXT)... or the Points button exports the digitized survey points (not the point cloud), sorted by number.
- File type: CSV (comma) or TXT (tab); Include header row; Coordinate decimals (0–8)
- Fields: Point Number, Easting (X), Northing (Y), Elevation (Z), Code, Description, Layer
- Columns: add with Add Field, remove with the X button, reorder with the ^/v buttons or by dragging, click a label to rename it, Reset Default restores the standard order
- Merge fields: Add Merge Field combines several fields with a separator (e.g. Code + Description with “-” → “ROOF-Ridge edge”)
- Export schemes: save, load and delete named column setups
IFC Export (BIM)
File > Export > IFC... or the IFC button. Choose IFC 2x3 or IFC 4. Exported: walls and 3D walls (IfcWall), doors (IfcDoor), windows (IfcWindow), openings (IfcOpeningElement), roofs (IfcRoof) and rooms (IfcSpace), organized by building storey (floors).
Section Image Export
File > Export > Section Image... or the Section Image button exports a viewport (3D top view, horizontal section or X-Ray) as an image:
- Source viewport, PNG or JPEG (quality 1–100, default 95)
- Resolution: custom (100–8192 px) or presets HD (1920×1080), 4K (3840×2160), Square (2000×2000)
- Optional world file (
.pgw/.jgw) for GIS and CAD software
Other Exports
- Trees / Poles — TXT/CSV (see Tree Detection, Pole Detection)
- Grid Points — CSV (see Grid Points)
- TIN surface — LandXML 1.2
- Volume report — PDF
- Decimated point cloud — LAS, PLY, XYZ, PTS (Project Browser > Save Decimated)
DXF Import
Imports existing drawings (floor plans, survey data) as reference geometry. A project must be open.
- File > Import > DXF File... and select the file
- A summary of the imported entities and layers is written to the Command Line
- Imported entity types: POINT, LINE, POLYLINE, LWPOLYLINE, ARC, CIRCLE
- Layers are kept with the file name as prefix (e.g. “floorplan_Walls”); ACI colors are converted to RGB
- If a point cloud is loaded, the DXF is aligned to it automatically. If you import the DXF first, right-click it in the Project Browser > Apply Point Cloud Shift afterwards
- Project Browser right-click: Hide All / Show All, Apply Point Cloud Shift, Remove from project
Preferences
File > Preferences...; confirm with Save & Close.
| Tab | Settings |
|---|---|
| Software | Square size, crosshairs, line width, Continuous editing, Max Zoom (2D views), Max Points (millions), Q height pick radius, Q display size |
| Snap | Snap modes and radius |
| Room | Show number / name / area / perimeter, text size, next room number |
| Points | Point style, size, labels, text size, label colors |
| D/W/O | Door/window/opening height labels, text size, line overhang |
Help
- F1 or Help > Help Topics opens the built-in help window with short topics (getting started, navigation, quick popups, drawing, editing, snapping, layers, sections, X-Ray, 3D preview, import, export)
- Ribbon buttons show tooltips
- This manual is the complete reference
Keyboard & Mouse Reference
The keys listed here work in the current version. Drawing tools have no single-key shortcuts; start them from the ribbon, the F6 popup or the Command Line.
General
| Ctrl+S | Save project |
| Ctrl+Z | Undo |
| Ctrl+Y / Ctrl+Shift+Z | Redo |
| Esc | Cancel the current command / clear the selection |
| Delete | Delete the selection (mouse over the viewport, no active command) |
| Ctrl+PgUp / Ctrl+PgDn | Previous / next floor |
Function Keys
| F1 | Help window |
| F2 | Measurement panel |
| F3 | Snapping on/off |
| F4 | Snap popup: 1–7 toggle modes, 0 snapping on/off |
| F5 | View popup: 1 Top, 2 Front, 3 Right, 4 3D, 5 Zoom Extents, 6 Section Plane, 7 X-Ray, 8 3D Preview |
| F6 | Draw popup: 1 Point, 2 Line, 3 Polyline, 4 Door, 5 Window, 6 Opening, 7 Circle, 8 Arc, 9 Polygon |
| F7 | Edit popup: 1 Intersect, 2 Extend, 3 Trim, 4 Parallel, 5 Cut Between, 6 Break 1pt, 7 Break 2pt |
| F8 | Floor Manager |
F2–F8 require an open project.
With a Selection (mouse over the viewport)
| C | Copy |
| M | Move |
| R | Rotate |
While Drawing
| Q (hold) | Pick height from the point cloud (not in the Vertical Section view) |
| Shift (hold) | Horizontal/vertical lock |
| Enter | Finish polyline, room, roof, roof profile; accept 3D wall preview; save edge trace; confirm next wire point |
| Backspace | Remove the last point in semi-automatic wire tracing |
| Arrow keys | Move the vertical section forward/backward (Vertical Section view) |
Mouse
| Left click | Select / place point |
| Ctrl + left click | Add to / remove from selection |
| Right click | Cancel the command; context menu on a selection; otherwise repeat the last command |
| Middle button drag | Pan |
| Right button drag | Orbit (3D perspective) |
| Scroll wheel | Zoom |