Permalink
Browse files

MIDI documentation (still WIP, on-going)

  • Loading branch information...
1 parent 3b739f3 commit d64b32746f7aae43fad9d74bd2af1e18370f026e @wpwrak wpwrak committed Feb 13, 2012
Showing with 265 additions and 96 deletions.
  1. +14 −2 src/compiler/doc/Makefile
  2. +27 −27 src/compiler/doc/arch.fig
  3. +2 −2 src/compiler/doc/bind.fig
  4. +38 −0 src/compiler/doc/floats.inc
  5. +184 −65 src/compiler/doc/midi.tex
@@ -10,15 +10,15 @@ PICS = arch msg bind stim \
pot-0 pot-90 pot-180 pot-270 \
enc-0 enc-90 enc-270 enc-450 enc-405 \
dial-0 dial-90 dial-180 dial-360 \
- dial-405 dial-315
+ dial-405 dial-405-idle dial-315 dial-45 dial-135 dial-315f
GEN = nocvars.inc
.PHONY: all xpdf clean
all: midi.pdf
-midi.pdf: midi.tex $(PICS:%=%.$(PICEXT)) $(GEN)
+midi.pdf: midi.tex floats.inc $(PICS:%=%.$(PICEXT)) $(GEN)
pdflatex midi
xpdf: midi.pdf
@@ -102,9 +102,21 @@ dial-360.$(PICEXT): dial.fig
dial-405.$(PICEXT): dial.fig
$(call fig2pdf, 45deg cw-slow)
+dial-405-idle.$(PICEXT): dial.fig
+ $(call fig2pdf, 45deg)
+
dial-315.$(PICEXT): dial.fig
$(call fig2pdf, 315deg ccw)
+dial-45.$(PICEXT): dial.fig
+ $(call fig2pdf, 45deg ccw-slow)
+
+dial-135.$(PICEXT): dial.fig
+ $(call fig2pdf, 135deg ccw-fast)
+
+dial-315f.$(PICEXT): dial.fig
+ $(call fig2pdf, 315deg ccw-fast)
+
nocvars.inc: ../fnp.ids
./mknocvars <$< >$@ || { rm -f $@; exit 1; }
@@ -22,32 +22,32 @@ Single
1 1 0 3 0 7 50 -1 -1 0.000 1 0.0000 4050 3825 675 450 4050 3825 4725 4275
4 1 0 45 -1 18 12 0.0000 4 150 1050 4050 3915 Translation\001
-6
-6 6480 2205 8370 4995
+6 6480 2655 8370 5445
2 2 0 2 0 7 55 -1 -1 0.000 0 0 -1 0 0 5
- 6525 2250 8325 2250 8325 4950 6525 4950 6525 2250
-4 0 0 45 -1 18 12 0.0000 4 195 1560 6750 2925 var = range(aux);\001
-4 0 32 55 -1 18 12 0.0000 4 195 990 6750 3240 per_frame:\001
-4 0 32 55 -1 18 12 0.0000 4 180 960 6975 3555 rot = time;\001
-4 0 32 55 -1 18 12 0.0000 4 135 1110 6975 3870 zoom = var;\001
-4 0 32 55 -1 18 12 0.0000 4 105 840 6750 2610 ...more...\001
-4 0 32 55 -1 18 12 0.0000 4 105 840 6975 4185 ...more...\001
+ 6525 2700 8325 2700 8325 5400 6525 5400 6525 2700
+4 0 0 45 -1 18 12 0.0000 4 195 1560 6750 3375 var = range(aux);\001
+4 0 32 55 -1 18 12 0.0000 4 195 990 6750 3690 per_frame:\001
+4 0 32 55 -1 18 12 0.0000 4 180 960 6975 4005 rot = time;\001
+4 0 32 55 -1 18 12 0.0000 4 135 1110 6975 4320 zoom = var;\001
+4 0 32 55 -1 18 12 0.0000 4 105 840 6750 3060 ...more...\001
+4 0 32 55 -1 18 12 0.0000 4 105 840 6975 4635 ...more...\001
-6
-6 1305 3825 1665 4185
-1 3 0 2 0 7 50 -1 -1 0.000 1 0.0000 1485 4005 127 127 1485 4005 1395 3915
+6 1305 3915 1665 4275
+1 3 0 2 0 7 50 -1 -1 0.000 1 0.0000 1485 4095 127 127 1485 4095 1395 4005
2 1 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
- 1485 4005 1395 3915
+ 1485 4095 1395 4005
-6
-6 1485 3285 1665 3600
-5 1 0 2 0 7 50 -1 -1 0.000 0 0 0 0 1575.000 3375.000 1530 3375 1575 3330 1620 3375
-5 1 0 2 0 7 50 -1 -1 0.000 0 1 0 0 1575.000 3510.000 1530 3510 1575 3555 1620 3510
-1 3 0 2 0 7 47 -1 15 0.000 1 0.0000 1575 3375 45 45 1575 3375 1620 3375
+6 945 3330 1260 3510
+5 1 0 2 0 7 50 -1 -1 0.000 0 0 0 0 1035.000 3420.000 1035 3465 990 3420 1035 3375
+5 1 0 2 0 7 50 -1 -1 0.000 0 1 0 0 1170.000 3420.000 1170 3465 1215 3420 1170 3375
+1 3 0 2 0 7 47 -1 15 0.000 1 1.5708 1035 3420 45 45 1035 3420 1035 3375
2 1 0 2 0 7 49 -1 -1 0.000 0 0 -1 0 0 2
- 1530 3375 1530 3510
+ 1035 3465 1170 3465
2 1 0 2 0 7 49 -1 -1 0.000 0 0 -1 0 0 2
- 1620 3375 1620 3510
+ 1035 3375 1170 3375
-6
-1 3 0 2 0 7 50 -1 -1 0.000 1 0.0000 1080 3420 90 90 1080 3420 1170 3420
-1 3 0 2 0 7 50 -1 -1 0.000 1 0.0000 1350 3420 90 90 1350 3420 1440 3420
+1 3 0 2 0 7 50 -1 -1 0.000 1 0.0000 1530 3420 90 90 1530 3420 1620 3420
+1 3 0 2 0 7 50 -1 -1 0.000 1 0.0000 1530 3690 90 90 1530 3690 1620 3690
2 1 0 2 0 7 53 -1 -1 0.000 0 0 -1 0 0 2
3600 5355 4725 5355
2 1 0 2 0 7 53 -1 -1 0.000 0 0 -1 0 0 2
@@ -71,19 +71,19 @@ Single
1890 3825 3330 3825
2 1 0 2 0 7 50 -1 -1 0.000 0 0 7 1 0 3
1 1 2.00 60.00 60.00
- 4770 3825 6885 3825 6885 2970
-2 1 0 2 0 7 50 -1 -1 0.000 0 0 -1 1 0 3
- 1 1 2.00 60.00 60.00
- 6705 2880 4050 2880 4050 3330
-2 1 0 2 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+ 4770 3825 6885 3825 6885 3420
+2 1 0 2 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
1080 4320 1080 3645
-2 1 0 4 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+2 1 0 4 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
990 4095 1170 4095
2 2 0 3 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
810 3150 1800 3150 1800 4500 810 4500 810 3150
+2 1 0 2 0 7 50 -1 -1 0.000 0 0 -1 1 0 4
+ 1 1 2.00 60.00 60.00
+ 7470 3195 7470 2880 4050 2880 4050 3330
4 1 0 45 -1 18 12 0.0000 4 150 525 12330 6570 Patch\001
-4 1 0 45 -1 18 12 0.0000 4 150 435 3285 5355 dev1\001
-4 1 0 45 -1 18 12 0.0000 4 150 435 3285 6480 dev2\001
+4 1 0 45 -1 18 12 0.0000 4 150 615 3285 5355 Gizmo\001
+4 1 32 45 -1 18 12 0.0000 4 150 435 3285 6480 Frob\001
4 0 0 45 -1 18 12 0.0000 4 150 1380 4185 4725 Characteristics\001
4 1 0 45 -1 18 12 0.0000 4 150 630 2610 3735 Events\001
4 1 0 45 -1 18 12 0.0000 4 150 1500 3960 7470 Device database\001
@@ -136,15 +136,15 @@ Single
4 1 0 50 -1 18 12 0.0000 4 150 690 5400 6255 MIDICC\001
4 1 0 50 -1 18 12 0.0000 4 135 315 6300 6255 103\001
4 1 0 50 -1 18 12 0.0000 4 195 300 6750 6255 pot\001
-4 1 0 45 -1 18 12 0.0000 4 150 435 4185 6030 dev1\001
+4 1 0 45 -1 18 12 0.0000 4 150 615 4185 6030 Gizmo\001
4 1 0 50 -1 18 12 0.0000 4 150 1050 10350 3555 Translators\001
4 1 0 30 -1 14 20 0.0000 4 270 3315 5625 4050 var = range(aux);\001
4 1 0 50 -1 18 12 0.0000 4 150 525 4815 6030 Name\001
4 1 0 50 -1 18 12 0.0000 4 195 450 5355 6030 Type\001
4 1 0 50 -1 18 12 0.0000 4 150 345 6750 6030 Dev\001
4 1 0 50 -1 18 12 0.0000 4 150 330 6345 6030 Ctrl\001
4 1 0 50 -1 18 12 0.0000 4 150 480 5895 6030 Chan\001
-4 1 0 45 -1 18 12 0.0000 4 150 435 4185 7380 dev2\001
+4 1 32 45 -1 18 12 0.0000 4 150 435 4185 7380 Frob\001
4 1 0 50 -1 18 12 0.0000 4 150 1500 5490 8820 Device database\001
4 1 0 50 -1 18 12 0.0000 4 150 330 8955 8370 Ctrl\001
4 1 0 50 -1 18 12 0.0000 4 150 435 9450 8370 Proc\001
@@ -0,0 +1,38 @@
+\newcommand{\figarch}{
+\begin{figure}[!tb]
+\begin{center}
+\includegraphics{arch.pdf}
+\end{center}
+\caption{Input event processing in Flickernoise.}
+\label{arch}
+\end{figure}}
+
+\newcommand{\figmsg}{
+\begin{figure}[!tb]
+\begin{center}
+\includegraphics{msg.pdf}
+\end{center}
+\caption{Anatomy of a MIDI Control Change message.}
+\label{msg}
+\end{figure}}
+
+\newcommand{\figbind}{
+\begin{figure}[!tb]
+\begin{center}
+\includegraphics{bind.pdf}
+\end{center}
+\caption{When binding a control variable, information from the device
+ database, a translation map, and the table of patch variables is
+ combined into a stimulus entry.}
+\label{bind}
+\end{figure}}
+
+\newcommand{\figstim}{
+\begin{figure}[!tb]
+\begin{center}
+\includegraphics{stim.pdf}
+\end{center}
+\caption{When a MIDI control message is received, Flickernoise looks
+ for a matching stimulus and processes the value accordingly.}
+\label{stim}
+\end{figure}}
Oops, something went wrong.

0 comments on commit d64b327

Please sign in to comment.