tplace
v1.2.0
Published
Interactively place raster images into a very* zoomable canvas with translation, rotation, and scale, and render an XYZ tile set composed of the placed images.
Downloads
10
Readme
tplace
Interactively place raster images into a very* zoomable canvas with translation, rotation, and scale, and render an XYZ tile set composed of the placed images.
* How zoomable? A typical tile-based slippy map supports zoom level 0 to roughly 30. The maximum safely representable number in JavaScript is roughly 253. So it's safe to assume a typical tile-based slippy map supports at most 253 tile rows or columns at maximum zoom, making the maximum zoom 53. tplace
uses shardedmapview in order to splice together a huge number of standard slippy maps into one global slippy map, thereby supporting 2253 tile rows or columns at maximum zoom, making the maximum zoom 253.
You can use shardedmapview to render your very zoomy tile set. Example: Powers of Ten, an interactive remake of the famous film. Powers of Ten zooms from the known universe (14 light years) to the interior of a proton (10-15 meters), or 150 zoom levels.
1. Install
Install globally with yarn
or npm
and you'll get the tplace
binary in your command line.
sudo yarn global add tplace
or
npm install -g tplace
2. Place raster images into a slippy canvas
tplace edit
TODO: screencast gif of basic placement interaction
Placed images and their positions, rotations, and scales are stored in the current working directory.
3. Render an XYZ tile set
tplace render png8
or
tplace render jpeg
with custom zoom range
tplace render jpeg --min-zoom -70 --max-zoom 50
These render an XYZ tile set into tiles/
in the current working directory, variably using 8-bit PNG or JPEG compression. 8-bit PNG is good for web delivery of low color graphic art. Sorry, you can't set the JPEG quality or use PNG24 right now :/
The zoom range defaults to something, but you can control the min and/or max.
Super alpha incomplete but capable software available to you with no warranty!