Skip to content

v4.2.0

Choose a tag to compare

@github-actions github-actions released this 08 Nov 17:50
· 24 commits to main since this release
76c20bc

Release v4.2.0

Build Details:


Changelog

Changes since v4.1.0

Version 4.2.0 adds a compass rose and a cartouche drawn by the module, names the map's natural features from its terrain, gives every name a random name button, places names round the decorations, and saves images as WebP as well as PNG.

Note: existing maps are unchanged. A map made before version 4.2.0 keeps its Water label style until Name natural features first runs on it, which replaces Water with the six geographic styles; labels that used Water keep its look, as Custom.

FEATURES

  • Compass rose: Add decoration in Cartography is now a menu of Image, Compass rose and Cartouche. A compass rose is drawn by the module in three designs (Classic, Mariner's and North arrow), with 4 to 32 points, rings, a degree ring, a letter or a fleur-de-lis for north and a backing disc, in one of five colour schemes (Parchment, Sea chart, Ink, Slate and Crimson) or colours of your own, and with its letters in any of the label fonts, turned with the rose or kept upright.
  • Cartouche: a panel holding the map's title, in three designs (Plaque, Ribbon and Frame). It shows the map's name, and follows it when the map is renamed, saved as a copy or cut into a regional map, or a title of its own, with a subtitle if you want one, the same colour schemes and lettering of its own. A long title is made smaller, then put on two lines.
  • Natural features named: Name natural features, in the Labels tool, finds the map's oceans, seas, gulfs, bays and lakes, its mountain ranges, hills and highlands, its great forests, jungles, deserts, steppes, tundra and plains, and its largest rivers from the terrain, and names each in the language of the people living there ("Grey Sea", "Gulf of Ashby", "River Tass") in six new geographic label styles. Running it again after a terrain change places its names again and keeps any you have moved, renamed or restyled.
  • Random names: a Random name button beside the name of every pin, route and region gives it a name in the language of the people living there. About one name in three adds a word that fits, such as Hills, Port or Road. Each press gives another.
  • Name all: a new Names section in Generate names the map's regions, pins and routes in one go, with a choice of which kinds of item to name and which of their names to replace. Names you typed are never replaced.
  • WebP images: Export image and Export to scene can save as PNG, WebP, lossless (the same pixels in about 60% of the size) or WebP, 90% quality (about a fifth of a PNG's size, with the line work intact), each shown with its estimated size at the chosen scale. The format you chose last is chosen at first next time.

IMPROVEMENTS

  • Names keep clear of decorations: names now go round the scale bar, compass roses, cartouches and image decorations, and find their places again when you let go of a decoration you have moved, turned or resized.
  • Natural features among the other names: the names Name natural features gives are placed with the rest by importance (oceans and seas with the realms, bays last), keeping inside their feature, and a river's name follows a stretch of its river wherever there is room. A name you move stays where you put it.
  • Route names: a route's name can now sit anywhere along its line, half way first, rather than only at its middle, and a route you have named is placed before the places' names, so they go round it.
  • Geographic label styles: new maps start with Ocean and sea, Gulf, bay and lake, River, Mountains, Hills and highlands and Forest, desert and plains in place of Water. The land's features are named in two greens, which join the colour picker's presets.
  • Export to PNG is now Export image, in Export, History and Travel.
  • Labels list: a new Of natural features filter. Natural features' names count as Generated, so Hand-made lists only the labels you placed yourself.
  • Decorations: each row in the Map decorations list shows its kind's icon, and a chosen decoration's handle shows only in Move, so in Select nothing covers it. On a regional map, a compass rose or a cartouche keeps its place and size relative to the map.
  • Generate again: a random name (from Random name or Name all) does not count as an edit, so Generate again still replaces a generated item that has one.

UNDER THE HOOD

  • Map decorations gain a kind (compass or cartouche; none is an image, so older maps need no migration) and the fields of each kind. New CompassGeometry, CartoucheGeometry and DrawnDecoration build them; their letters are text in the label fonts, raised to the export's scale like any name. New DecorationSvg draws the inspector's thumbnails from numbers and checked colours only. MapPackage passes drawn decorations through import and backup untouched.
  • New ImageFormat: WebP is offered only where the browser returns WebP when asked, and sizes are estimated from four sample tiles at the chosen scale.
  • New PlaceNames makes a name from the map's seed, the item's id and how often it has been rerolled, so the same name can be made again. New RandomNames and FeatureNames. New saved fields nameSource and nameRoll on pins, routes and regions, and feature on standalone labels (what the action found and gave the label, to tell an edited label and to find its feature again).
  • New FeatureDetection finds natural features from the terrain: seas by a watershed of the distance to land, inlets, lakes, relief, land areas from the biomes, and rivers by flow, each with a footprint to match it across runs.
  • LabelLayout takes obstacles, ranks natural features by kind and places route names along their lines and river names on stretches of their course; LabelPlacement candidates may carry their own box and turn.