Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
MIDI documentation (still WIP, on-going)
  • Loading branch information
wpwrak committed Feb 14, 2012
1 parent 3b739f3 commit d64b327
Show file tree
Hide file tree
Showing 5 changed files with 265 additions and 96 deletions.
16 changes: 14 additions & 2 deletions src/compiler/doc/Makefile
Expand Up @@ -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
Expand Down Expand Up @@ -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; }

Expand Down
54 changes: 27 additions & 27 deletions src/compiler/doc/arch.fig
Expand Up @@ -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
Expand All @@ -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
Expand Down
4 changes: 2 additions & 2 deletions src/compiler/doc/bind.fig
Expand Up @@ -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
Expand Down
38 changes: 38 additions & 0 deletions src/compiler/doc/floats.inc
@@ -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}}

0 comments on commit d64b327

Please sign in to comment.