Survey Points Exporter is a professional Blender addon for exporting survey points — mesh vertices and Empty object locations — into real-world coordinates.

It allows you to work with a custom axis orientation (East / West / North / South), reference point offsets, and optional Z-axis rotation, instead of relying on Blender’s default origin.

The addon supports exporting points from the active mesh or entire collections, with control over coordinate order, decimal formatting, and output format (TXT or CSV).

Additional tools include calculating a reference point from a known surveyed point, retrieving real-world coordinates of an active vertex or Empty, moving points to entered coordinates, and a viewport compass overlay for orientation.

Designed for surveying, construction, civil engineering, and CAD/GIS workflows.

For roundtrip workflows, this add-on integrates seamlessly with Survey Points Importer – Geodetic & Construction Workflow, allowing consistent coordinate system settings between import and export.

📘 Documentation

Survey Points Exporter – Blender Add-on

1. Introduction

Points Export is a professional Blender add-on for exporting point coordinates from 3D scenes into survey-friendly formats.

It supports:

• vertices and empty objects
• user-defined coordinate systems
• configurable axis orientation and rotation
• TXT and CSV export formats

The add-on is designed for surveying, civil engineering, road design, and GIS workflows.

2. Installation

1. Download the add-on ZIP file
2. Open Blender
3. Go to Edit → Preferences → Get Extensions → arrow in the upper right corner → Install from Disk
4. Select the ZIP file and Click Install from Disk
5. Open the N-panel in the 3D Viewport (N)
6. Find the Survey tab

3. Export Types

3.1 Mesh Object

Exports vertices from the active mesh object.

Options:

• Export only selected vertices
• Ignore hidden vertices

3.2 Collection (mesh objects and empties)

Exports:

• vertices from all mesh objects
• locations from empty objects

within the selected collection.

3.3 Collection (empties only)

Exports only empty object locations from a collection.

4. Coordinate System Configuration

4.1 Axis Orientation

• X and Y axes can be set to North, South, East, or West
• X and Y must be perpendicular
• Z-axis rotation can be applied if required

This allows alignment with real-world survey coordinate systems.

4.2 Reference Point

Reference points are used to align Blender coordinates with real-world coordinates.

Calculate Reference from Known Point

1. Select a vertex or empty with known real coordinates
2. Enter known X, Y, Z values
3. Click Calculate Reference
4. Click Apply Calculated Reference

4.3 Verification

Use Get Active Vert / Empty Coords to:

• display transformed coordinates
• verify correctness against known values

5. Export Settings

5.1 Point Naming

• Custom prefix
• Optional object name inclusion

Example:

P_001 BOD_PointA

5.2 Precision

• Decimal places: 0–10

5.3 File Formats

TXT

• Configurable delimiter
• Configurable decimal separator

CSV

• Configurable delimiter
• Configurable decimal separator

Supported delimiters:

• comma
• semicolon
• tab

6. Coordinate Editing (Inverse Transformation)

The add-on allows setting empty/vert positions using real-world coordinates.

Set Active Vert / Empty to Coordinates

1. Enable the tool
2. Enter target X, Y, Z
3. Select a vertex or empty
4. Click Set to Coordinates

The inverse transformation is applied automatically.

7. Visual Tools

7.1 Compass Overlay

A compass is displayed in the 3D viewport showing:

• current X and Y axis orientation
• coordinate system alignment

8. Settings Management

8.1 Save Settings

Opens a file dialog and saves the current add-on configuration to an external
.txt file.

The saved settings include:

• export options
• axis orientation
• reference point
• formatting settings

The settings file can be reused across different Blender projects
and shared between computers or users.

8.2 Load Settings

Opens a file dialog and loads add-on settings from a previously saved
settings .txt file.

All stored parameters are applied immediately after loading.

8.3 Import from Survey Points Importer

If the compatible add-on is installed (currently in development), the following can be imported:

• axis orientation
• reference point coordinates

9. Supported Coordinate System Examples

S-JTSK

• X Axis: South
• Y Axis: West
• Z Rotation: 0°

10. Requirements

• Blender: 5.0.0 or later

11. License

GNU General Public License v3.0 or later
(GPL-3.0-or-later)

❓ FAQ

What is the reference point used for?

The reference point is used only during coordinate calculations within the add-on.

It does not modify Blender objects or scene coordinates.

During export and coordinate queries, point positions are transformed

using the configured reference point so that the output matches

the defined real-world survey coordinate system.

Why must X and Y axes be perpendicular?

Non-perpendicular axes would result in invalid coordinate transformations. The add-on enforces correct orientation.

Why do my exported coordinates not match expected values?

Check:

• axis orientation
• reference point calculation
• Z-axis rotation
• decimal separator and delimiter settings

Can I move objects using real-world coordinates?

Yes. Use Set active vert/empty to manual coordinates to position verts/empties via inverse transformation.

Where are settings stored?

Settings are saved as a Blender text block:

.SurveyPointsExporterSettings

Is the add-on compatible with other survey tools?

Yes. TXT and CSV outputs are compatible with most:

• CAD software
• GIS tools
• survey and machine control workflows