Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Docs.

  • Loading branch information...
commit 07e4e2dd81dcab2a90e810cdabbc137f70440fe2 1 parent 2ad5c5c
@cassiel authored
Showing with 28 additions and 9 deletions.
  1. +27 −1 README.md
  2. +0 −2  project.clj
  3. +1 −6 scratch.clj
View
28 README.md
@@ -1,8 +1,34 @@
# Sifaka: a Clojure-based template builder for Lemur
-## Notes
+Sifaka is a package for constructing [Liine Lemur][liine] templates,
+and uploading them
+to iOS devices, purely in Clojure, avoiding the rather quirky WYSIWYG
+template editor.
+
+The code is at an early stage; we're just testing with `Container`
+objects at the moment, as we shake out some details of the XML
+generation. This is likely to be a slow process, as the object
+parameters are numerous and subtle.
+
+Thanks to Matthew Stanton, whose Python code [here][stanton] pointed the
+way to uploading templates via TCP/IP. (We figured out the rest, and
+corrected some errors, by sniffing network packets from the editor.) No
+thanks to JazzMutant whose "OSC-style" example code is confusing,
+misdocumented and just plain wrong.
+
+## Usage
+
+Sifaka is a [Leiningen 2][lein] project, so build in the usual
+manner. There are one or two upload examples at the bottom of
+`scratch.clj`.
+
+## Technical Notes
- The Lemur editor doesn't allow containers with a dimension less than 25.
- Containers appear to have internal padding: an internal offset of
`[0 0]` results in some space around the contained object.
+
+[liine]: http://liine.net
+[stanton]: http://music.trontronic.com/lemur/lemur_loader.py
+[lein]: https://github.com/technomancy/leiningen/
View
2  project.clj
@@ -1,7 +1,5 @@
(defproject eu.cassiel/sifaka "1.0.0-SNAPSHOT"
:description "FIXME: write description"
:dependencies [[org.clojure/clojure "1.4.0"]
- [overtone/osc-clj "0.7.1"]
- [net.loadbang/net.loadbang.osc "1.2.0"]
[weissjeffm/clojure.prxml "1.3.0-SNAPSHOT"]
[expectations "1.3.6"]])
View
7 scratch.clj
@@ -5,14 +5,9 @@
[xml-fu :as x])
(sifaka.examples [sierpinski :as sp])
(clojure [prxml :as p]))
- (:use overtone.osc)
- (:use overtone.osc.encode)
- (:use overtone.osc.peer)
(:import [java.nio.channels DatagramChannel]
[java.nio ByteBuffer]
- [java.net InetAddress InetSocketAddress DatagramSocket DatagramPacket]
- [net.loadbang.osc.comms UDPTransmitter]
- [net.loadbang.osc.data Message]))
+ [java.net InetAddress InetSocketAddress DatagramSocket DatagramPacket]))
;; --- Basic XML generation.
Please sign in to comment.
Something went wrong with that request. Please try again.