From a32556275fa5d98ab56e88cfef58b7e51ff7f792 Mon Sep 17 00:00:00 2001
From: Bob <rsheldiii@gmail.com>
Date: Fri, 1 May 2020 16:35:25 -0400
Subject: [PATCH] add legends example

---
 examples/legends.scad | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 examples/legends.scad

diff --git a/examples/legends.scad b/examples/legends.scad
new file mode 100644
index 0000000..2ac4ca3
--- /dev/null
+++ b/examples/legends.scad
@@ -0,0 +1,32 @@
+include <../includes.scad>
+
+/* here's how to use the legends() command.
+   The first argument is the legend itself, which can also be a whole string.
+   The second argument is the "position" of the legend relative to center.
+   Legends currently have to all be inset or outset at the same time, but you
+   can have as many of them as you want.
+   The numbers used are some magic constant, so just fudge them until it looks good.
+*/
+
+/* $outset_legends = true; */
+legends = [
+  ["a", "b", "c", "d"],
+  ["e", "f", "g", "h"],
+  ["i", "j", "k", "l"],
+];
+
+$font_size = 4;
+
+for (x=[0:len(legends)-1]) {
+  translate_u(x,0) {
+    legend(legends[x][0], [-1,-1]) {
+      legend(legends[x][1], [-1,1]) {
+        legend(legends[x][2], [1,-1]) {
+          front_legend(legends[x][3]) {
+            key();
+          }
+        }
+      }
+    }
+  }
+}