More documentation

This commit is contained in:
Simon Brooke 2020-05-24 22:22:22 +01:00
parent b6e618695e
commit aafab5faa8
No known key found for this signature in database
GPG key ID: A7A4F18D1D4DF987
2 changed files with 34 additions and 0 deletions

View file

@ -20,6 +20,9 @@ Lein dependency:
[walkmap "0.1.0-SNAPSHOT"]
* [API documentation](https://simon-brooke.github.io/walkmap/codox/index.html)
* [Test coverage](https://simon-brooke.github.io/walkmap/cloverage/index.html)
### Converting heightmaps to STL
Doesn't work yet, and is not a priority. Use
@ -74,6 +77,20 @@ from height maps. These exclusion maps will probably be represented as SVG.
This is not yet implemented.
Culling facets in ocean areas is implemented and works:
(require '[walkmap.core :refer [cull-ocean-facets *sea-level*]])
(cull-ocean-facets stl)
If sea level in your heightmaps is not zero, e.g. is 5, set it thus:
(def ^:dynamic *sea-level* 5.0)
(cull-ocean-facets stl)
It is **strongly recomended** that you set `*sea-level*` to a floating point
number, not an integer, because numbers are specified in the STL file as
floating point, and in Clojure, `(= 5 5.0)` returns `false`.
### Merging road maps and river system maps
It is intended that it should be possible to merge road maps (maps of already

View file

@ -16,6 +16,9 @@ Lein dependency:
[walkmap "0.1.0-SNAPSHOT"]
* [API documentation](https://simon-brooke.github.io/walkmap/codox/index.html)
* [Test coverage](https://simon-brooke.github.io/walkmap/cloverage/index.html)
### Converting heightmaps to STL
Doesn't work yet, and is not a priority. Use
@ -70,6 +73,20 @@ from height maps. These exclusion maps will probably be represented as SVG.
This is not yet implemented.
Culling facets in ocean areas is implemented and works:
(require '[walkmap.core :refer [cull-ocean-facets *sea-level*]])
(cull-ocean-facets stl)
If sea level in your heightmaps is not zero, e.g. is 5, set it thus:
(def ^:dynamic *sea-level* 5.0)
(cull-ocean-facets stl)
It is **strongly recomended** that you set `*sea-level*` to a floating point
number, not an integer, because numbers are specified in the STL file as
floating point, and in Clojure, `(= 5 5.0)` returns `false`.
### Merging road maps and river system maps
It is intended that it should be possible to merge road maps (maps of already