Repository navigation
freemapper-print v0.5.0
Added
- Masks for window and corridor orienteering in the project file (ADR 0045). A
[[masks]]table has an id and
polygons made of an outline and holes, the windows. The points are map mm with the y axis up, as OOM shows them
and ascentre_map_mmtakes them.mask = "…"in[[assignments]]gives a course its mask, and several courses
may share one. On loading, the program checks every mask and reports an error with file, line and field, such
as a hole outside its outline or a ring that crosses itself. - Masks print. On the sheet of a course with a mask the map is missing in the masked area; outside the outline and
in the windows it shows, and overlapping windows make one window. The course overprint, the description box, the
sheet elements and the footer stay visible, the legs between the windows included. Without a mask of its own, a
course gets Purple Pen's white-out areas, each on its own, also where they overlap. A sheet applies at most 1000
masks; when a course has more, the rest are left out andcheckwarns. Sheets without a mask stay the same byte
for byte. masks windowwrites a mask with round windows around the controls of a course (ADR 0047). The radius counts
in millimetres on paper, 15 mm by default;--radius-forgives single controls a radius of their own,
--controlspicks controls by code or number, and--assignprints the course with it. The start and the finish
get a window too, unless--no-startor--no-finishleaves it out. The output and the comment in the project
file name the start and the finish as such, not by the codesSTA1andFIN1. The mask keeps the windows in map
mm; after a change of print scale, run the command again.masks corridorturns a line you give with--pointsinto a corridor as wide as--width(10 mm on paper by
default). There is no automatic corridor. The command refuses a bend too sharp for the width, or a line that
crosses itself, and names the place; for a crossing, the point where the edges meet.- Both commands append the table to the project file as text, with a comment on how it was made; everything
before it stays unchanged. They never change a mask that exists. If the file writes its assignments as
assignments = [...],--assignstops with exit code 2 and leaves the file as it was. checklooks at course sheets with a mask (ADR 0046). It warns when a control, the start or the finish lies
where the mask hides the map, and counts by kind what of the course overprint lies there: marked routes,
crossing points, forbidden routes, out-of-bounds boundaries, out-of-bounds and dangerous areas, texts. The
overprint prints all the same. It also warns when a mask hides the whole map frame, and says for information
when a mask hides nothing in the frame or no course uses it; white-out areas from Purple Pen that hide nothing
share one line per course. It warns when a sheet element or the footer covers part of a window. When the project
file names a white-out area by its number (whiteout-<n>),checksays where that area lies, because the number
follows the order in the course file and can mean another area after a change in Purple Pen. When the check
reaches its limit,checksays that it checked only part of the sheet.- Two examples:
luebeck-training-window(window orienteering with eight controls) and
luebeck-training-corridor(corridor orienteering along three streets of Lübeck's old town). The manual has a
chapter 11 on masks.
Changed
- The note on white-out areas in the course file now starts with "Info:" and no longer counts toward the exit
code ofcheck, because white-outs print. - The program reads a project file of at most 16 MB and refuses a larger one before reading it. A file within the
limits for masks needs about 4 MB at most. - The last line of
checkcounts in the right number: "With notes: 1 of 1 course, 0 of 1 layout sheet."
Download the archive for your system, unpack it and start freemapper-print
(Windows: freemapper-print.exe) from a terminal or register it with your AI assistant.
Installation and first steps: see README.md (Deutsch) / README.en.md (English) in the
archive or https://github.com/HenryJobst/freemapper-print#readme
- Windows: freemapper-print-v0.5.0-windows-x86_64.zip
- macOS Apple Silicon (M1 and newer): freemapper-print-v0.5.0-macos-arm64.tar.gz
- macOS Intel: freemapper-print-v0.5.0-macos-x86_64.tar.gz
- Linux: freemapper-print-v0.5.0-linux-x86_64.tar.gz (ARM: linux-arm64)
Full Changelog: v0.4.0...v0.5.0