spacemap 0.1.14 → 0.1.16

package/README.md

@@ -47,7 +47,7 @@ your page:
 ```html
 <div id="map" style="height: 500px"></div>
 <script type="module">
-	import { createMap } from 'https://cdn.jsdelivr.net/npm/spacemap@0.1.14/dist/spacemap.js';
+	import { createMap } from 'https://cdn.jsdelivr.net/npm/spacemap@0.1.16/dist/spacemap.js';
 	const map = await createMap({ container: '#map' });
 </script>
 ```
@@ -451,6 +451,22 @@ it straight back.
 The flat map needs nothing of its own for this: its pictures are layers already,
 and `addRasterLayer` puts one of yours over or in place of them.
 
+### Surface tiles
+
+Close up, a body's surface sharpens with tiles fetched around the camera. Some
+maps draw none — on a device short of memory, for one — and every body then
+shows its whole-globe maps alone, which go soft close up:
+
+```js
+map.tilesEnabled(); // false where the map draws no tiles at all
+await map.hasTiles('naif-499'); // whether tiles sharpen Mars up close
+```
+
+`hasTiles` is also false for a body without tiles, one drawn as a shape model
+up close, and one whose tiles could not be fetched. It reads the body's own
+data, so it answers before the camera gets there. A page can use the two to
+limit how far the reader zooms in, or to say that close-up detail is off.
+
 ### Layers
 
 What the map draws is a set of layers, each switched by id — the kinds of
@@ -646,6 +662,22 @@ A `system` is named by its primary and measured in the primary's radii. A body
 with no moons has no system map, and asking for one rejects, leaving the map as
 it was.
 
+A ringed primary's rings are a band across every ring there is, out to the
+faintest dust: Saturn's runs past Mimas, Enceladus, Tethys and Dione to the
+E ring. `rings: 'visible'` spans only the rings `createMap` shows, at the cost
+of the primary's bundle and its ring profiles:
+
+```js
+createSystemMap({
+	container: '#picker',
+	view: { kind: 'system', id: 'naif-699' },
+	rings: 'visible'
+});
+```
+
+Jupiter's and Neptune's rings are too faint to see, so their systems then have
+no band.
+
 **A click reports what was picked and goes nowhere.** Walking down into a
 system and back up is the page's own doing, which is what lets it keep a back
 button, a breadcrumb or a URL of its own: