simon/walkmap
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Geometry isn't working at all, but my head is spinning!

Browse source
This commit is contained in:
Simon Brooke 2020-05-24 16:05:04 +01:00
parent 8a2cb942e6
commit 223bf1ce77
No known key found for this signature in database
GPG key ID: A7A4F18D1D4DF987
21 changed files with 212 additions and 75 deletions
Download patch file Download diff file Expand all files Collapse all files

29
docs/codox/intro.html
View file

@ -1,8 +1,7 @@
<!DOCTYPE html PUBLIC ""
"">
<html><head><meta charset="UTF-8" /><title>Introduction to walkmap</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name">Walkmap</span> <span class="project-version">0.1.0-SNAPSHOT</span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 current"><a href="intro.html"><div class="inner"><span>Introduction to walkmap</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="walkmap.core.html"><div class="inner"><span>walkmap.core</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#introduction-to-walkmap" name="introduction-to-walkmap"></a>Introduction to walkmap</h1>
<h2><a href="#introduction" name="introduction"></a>Introduction</h2>
<p>This library is written in support of work on <a href="https://simon-brooke.github.io/the-great-game/codox/">The Great Game</a>, but is separate because it may be of some use in other settings.</p>
<html><head><meta charset="UTF-8" /><title>Introduction to walkmap</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name">Walkmap</span> <span class="project-version">0.1.0-SNAPSHOT</span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 current"><a href="intro.html"><div class="inner"><span>Introduction to walkmap</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>walkmap</span></div></div></li><li class="depth-2 branch"><a href="walkmap.core.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></a></li><li class="depth-2 branch"><a href="walkmap.edge.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>edge</span></div></a></li><li class="depth-2 branch"><a href="walkmap.geometry.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>geometry</span></div></a></li><li class="depth-2 branch"><a href="walkmap.path.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>path</span></div></a></li><li class="depth-2 branch"><a href="walkmap.polygon.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>polygon</span></div></a></li><li class="depth-2 branch"><a href="walkmap.stl.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>stl</span></div></a></li><li class="depth-2 branch"><a href="walkmap.svg.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>svg</span></div></a></li><li class="depth-2"><a href="walkmap.vertex.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>vertex</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#introduction-to-walkmap" name="introduction-to-walkmap"></a>Introduction to walkmap</h1>
<p>This library is written in support of work on <a href="https://simon-brooke.github.io/the-great-game/codox/Pathmaking.html">The Great Game</a>, but is separate because it may be of some use in other settings.</p>
<h2><a href="#usage" name="usage"></a>Usage</h2>
<p>What works:</p>
<p>No clojars repo yet, build the jar yourself with</p>
@ -11,31 +10,31 @@
<p>Lein dependency:</p>
<pre><code>[walkmap "0.1.0-SNAPSHOT"]
</code></pre>
<p>Using:</p>
<pre><code>(require '[walkmap.core :refer :all])
</code></pre>
<h3><a href="#converting-heightmaps-to-stl" name="converting-heightmaps-to-stl"></a>Converting heightmaps to STL</h3>
<p>Doesn’t work yet, and is not a priority. Use <a href="https://github.com/fogleman/hmm">hmm</a> instead.</p>
<h3><a href="#reading-binary-stl-files" name="reading-binary-stl-files"></a>Reading binary STL files</h3>
<pre><code>(decode-binary-stl "path/to/input-file.stl")
<pre><code>(require '[walkmap.stl :refer [decode-binary-stl]])
(decode-binary-stl "path/to/input-file.stl")
</code></pre>
<p>Works, seems good.</p>
<h3><a href="#writing-ascii-stl-files" name="writing-ascii-stl-files"></a>Writing ASCII STL files</h3>
<pre><code>(write-ascii-stl "path/to/output-file.ascii.stl" stl-structure)
<pre><code>(require '[walkmap.stl :refer [write-ascii-stl]])
(write-ascii-stl "path/to/output-file.ascii.stl" stl-structure)
</code></pre>
<p>Works, seems good, agrees with Python implementation except for different number of places of decimals printed.</p>
<h3><a href="#converting-stl-to-svg" name="converting-stl-to-svg"></a>Converting STL to SVG</h3>
<pre><code>(stl-to-svg stl-structure)
</code></pre>
<p>Works for smaller test files. I’m not yet confident it works for arbitrary sized STL structures. Returns a <a href="https://github.com/stathissideris/dali">Dali</a> structure representing an SVG drawing, which can be printed with</p>
<pre><code>(dali.io/render-svg structure)
<pre><code>(require '[walkmap.svg :refer [stl-&gt;svg]])
(stl-&gt;svg stl-structure)
</code></pre>
<p>Works, seems good. Returns a <a href="https://github.com/weavejester/hiccup">hiccup</a> representation of the SVG.</p>
<p><strong>NOTE THAT</strong> the SVG data does not contain height information, which the STL data does contain. Thus gradient information can only be obtained from the STL.</p>
<h3><a href="#converting-stl-file-to-svg-or-svg-file" name="converting-stl-file-to-svg-or-svg-file"></a>Converting STL file to SVG or SVG file</h3>
<pre><code>(binary-stl-file-to-svg "path/to/input-file.stl")
<pre><code>(require '[walkmap.core :refer [binary-stl-file-&gt;svg]])
(binary-stl-file-&gt;svg "path/to/input-file.stl")
</code></pre>
<p>Works for smaller test files. I’m not yet confident it works for arbitrary sized STL structures. Returns a <a href="https://github.com/stathissideris/dali">Dali</a> structure representing an SVG drawing, as above.</p>
<pre><code>(binary-stl-file-to-svg "path/to/input-file.stl" "path-to-output-file.svg")
<p>Works, seems good. Returns a <a href="https://github.com/weavejester/hiccup">hiccup</a> representation of the SVG.</p>
<pre><code>(require '[walkmap.core :refer [binary-stl-file-&gt;svg]])
(binary-stl-file-&gt;svg "path/to/input-file.stl" "path-to-output-file.svg")
</code></pre>
<p>As above, but, as a side effect, writes the SVG to the specified output file. Works for smaller test files, as above.</p>
<h3><a href="#merging-exclusion-maps-and-reserved-area-maps" name="merging-exclusion-maps-and-reserved-area-maps"></a>Merging exclusion maps and reserved area maps</h3>