GNU General Public License v3.0

项目介绍

EmGi96/TrailPrint3D 是一个托管在 GitHub 上的开源项目,主要使用 Python 编写,采用 GNU General Public License v3.0 许可证,目前获得 259 个 Star、24 次 Fork。

仓库全名
EmGi96/TrailPrint3D
开源许可证
GNU General Public License v3.0
Star 数
259
Fork 数
24
未关闭 Issue
5

README 摘要

TrailPrint3D A Blender addon that turns GPS trails and geographic data into 3D-printable miniature maps. TrailPrint3D.com Video Tutorial Slightly outdated Features Map Generation Import a GPX file and generate a 3D map around your trail Three generation modes: Single Trail, Multi-Trail chain Premium , Terrain Premium Terrain generation from custom map bounds (center + radius, two corner points, or a blank tile)…

完整内容见 GitHub 原始 README 或本页 。

常见问题

TrailPrint3D 用什么语言开发?

主要使用 Python 编写,采用 GNU General Public License v3.0 许可证,目前有 259 个 Star。

TrailPrint3D 可以免费商用吗?

仓库标注的许可证为 GNU General Public License v3.0,商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 TrailPrint3D 的源码?

可以直接克隆仓库:git clone https://github.com/EmGi96/TrailPrint3D.git,默认分支为 main;安装与运行步骤见仓库 README。

TrailPrint3D 最近还在维护吗?

仓库最近一次更新为 1 天前,当前有 5 个未关闭 Issue;Star 数为 259,可作为社区活跃度的参考。

关于

Blender Addon to turn your GPX files into 3D Printable Full-color Maps

描述取自 GitHub 官方 API,中文内容由 GitRead 中文社区 编辑团队整理。

简要分析

热度分
315
价值分
163
活跃状态
活跃

语言占比

C#
CSS
HTML
JavaScript
PowerShell
Python

Release

README

TrailPrint3D

A Blender addon that turns GPS trails and geographic data into 3D-printable miniature maps.

TrailPrint3D.com

Video Tutorial Slightly outdated

Features

Map Generation

  • Import a GPX file and generate a 3D map around your trail
  • Three generation modes: Single Trail, Multi-Trail chain Premium, Terrain Premium
  • Terrain generation from custom map bounds (center + radius, two corner points, or a blank tile)
  • Multi Tile Generator — visually arrange multiple map tiles before generating
  • Configurable shape: circle, square (with independent width/height), ellipse (with aspect ratio), hexagon, octagon, heart
  • Shape extras: inner/outer/front text overlays, a medal handle, and a protective shell around the map
  • Elevation scaling, path thickness, and single-color-mode for clean single-material prints

Map Elements

Automatically fetches and renders geographic data from OpenStreetMap:

  • Water (ponds, small rivers, big rivers)
  • Ocean Experimental
  • Forests, Scree, Glaciers
  • Farmland, Greenspaces
  • City boundaries
  • Buildings (3D) Experimental
  • Roads (major, primary, and small streets)

Post-Processing

  • Color by Height — stacks multiple elevation colors in material and texture modes; on a single-colored map or previously created height piece, Single Extruder Mode turns the next region into a recessed, one-millimeter-deep element that can be selected and split again
  • Contour Lines — adds printable contour line geometry
  • Magnet Holes — drills holes for magnets (configurable diameter/depth)
  • Dovetail Cutouts — adds dovetail joints for tiling maps
  • Bottom Mark — engraves a mark on the bottom face
  • SVG / Text Import — imports SVG outlines or custom text as 3D objects
  • Pin Placement — places a pin at GPS coordinates; pin on city name Premium
  • Heightmap Import Premium — imports a 2D image as a heightmap
  • Map Holder & Connectors — appends a decorative stand or connector piece to your map
  • Jigsaw Puzzle Generator — draw an area and choose rows/columns to turn a map into an interlocking jigsaw puzzle

Export

  • Export to STL, OBJ, and 3MF (3mf is using the 3MF Addon by Clonephaze)
  • Configurable default export folder in addon preferences
  • Optional auto-export after generation

Requirements

  • Blender 5.1 or newer (required for the bundled Python 3.13 geometry wheels)
  • Internet connection for elevation and map data APIs
  • (Optional) OpenTopography API key — free at portal.opentopography.org
  • (Optional) 3MF Addon by Clonephaze for 3MF export

Installation

  1. Download the latest release zip (or from TrailPrint3D.com ).
  2. In Blender, go to Edit → Preferences → Add-ons → Install.
  3. Select the downloaded zip and enable TrailPrint3D.
  4. If not visible, Press “N” on your Keyboard to open the Sidebar.
    Navigate to the TrailPrint3D Tab in the Sidebar.

Video Tutorial for the Installation

Data Sources

Data Provider Used for
Elevation (SRTM & others) OpenTopoData Terrain height
Elevation tiles Terrain Tiles / Mapzen Terrain height
Elevation (high-res datasets) OpenTopography Terrain height (API key required)
Geographic data OpenStreetMap contributors
using Overpass API
Map Elements
Land-cover classification ESA WorldCover, via Microsoft Planetary Computer (CC BY 4.0) WorldCover terrain colors

WorldCover uses Planetary Computer’s public /item/crop/{width}x{height}.png endpoint with a GeoJSON bounding polygon. The /item/feature/ and /item/bbox/ routes can appear in the API schema but return HTTP 501 on the public service. Fetch errors are reported separately from missing coverage; failed downloads are not cached or filled as water.

License

Copyright © 2026 EmGi.
Released under the GNU General Public License.
Models generated by this addon may be used commercially.

multitile_generator.html (the Multi Tile Generator’s frontend, a Premium-only feature) is excluded from this license — all rights reserved, no license is granted to copy, modify, or redistribute it.

评论

暂无评论