Joan: /* example-clients dels repositoris */

2014-01-09T15:52:29Z

example-clients dels repositoris

Pàgina nova

__TOC__
http://dis-dot-dat.net/index.cgi?item=/jacktuts/starting/

Els fitxers amb què treballo estan a 50.../way6/jack. (aquesta podria ser una de les maneres de tocar a baix nivell, programant l'API de JACK).
Segueixo
*http://dis-dot-dat.net/index.cgi?item=jacktuts/starting/playing_a_note

per fer el primer codi, que consisteix en tocar una nota.

<pre>
$gcc -std=c99 -o playc `pkg-config --cflags --libs jack` playc.c
$ ./playc hola
the sample rate is now 44100/sec
engine sample rate: 44100
</pre>
Efectivament, veig que apareix hola en la pestanya Audio de les connexions JACK, i que està connectat al system, i escolto el Do central en la targeta de so.

Per enviar missatges MIDI (apareix el client en la pestanya MIDI del JACK) ho tinc documentat a:
*[[Sax_Trainer#Programaci.C3.B3_de_l.27API_de_JACK_per_enviar_missatges_MIDI]]
També es podria fer un seqüenciador amb l'API d'ALSA, i en aquest cas el client apareixeria en la pestanya ALSA del JACK.

He estat fent bastantes proves i documentant-me, que bàsicament estan a sax_trainer/programacio_jack. '''midisine.c''' (i midisine_comentat.c), midiseq.c, simple_client. Concretament estic fent proves amb jack_bridge.c, que ha d'assentar les bases per tal que el sax_trainer el pugui connectar a un foot controller.

*http://trac.jackaudio.org/browser/trunk/jack/example-clients
*http://trac.jackaudio.org/browser/trunk/jack/example-clients/midisine.c
També seria interessant mirar:
*http://nedko.arnaudov.name/soft/fluidjack.c

El secret per entendre l'API de Jack és pensar una mica a baix nivell, en els buffers i la informació de buffers de memòria que s'intercanvies les aplicacions clients.
==example-clients dels repositoris==
''jackmp'' significa JACK multi-processador, que és el mateix que dir JACK2, i aquesta és la diferència gran entre JACK2 i JACK1: està optimitzat per ordinadors amb multi-processador.

$ svn co http://subversion.jackaudio.org/jack/jack2/trunk/jackmp
dins d'example-clients, compilo els exemples:
<pre>
gcc -D jack -o showtime `pkg-config --cflags --libs jack` showtime.c
./showtime

gcc -D jack -o samplerate `pkg-config --cflags --libs jack` samplerate.c
./samplerate

gcc -D jack -o cpu_load `pkg-config --cflags --libs jack` cpu_load.c
./cpu_load
jack DSP load 0.997674
jack DSP load 0.843427
jack DSP load 0.843836

gcc -D jack -o alias `pkg-config --cflags --libs jack` alias.c
./alias

gcc -D jack -o alsa_in `pkg-config --cflags --libs jack` alsa_in.c
./alsa_inno compila llegir:
*http://permalink.gmane.org/gmane.comp.audio.jackit/18384

gcc -D jack -o alsa_out `pkg-config --cflags --libs jack` alsa_out.c

gcc -D jack -o bufsize `pkg-config --cflags --libs jack` bufsize.c
./bufsize
buffer size = 256 sample rate = 44100

gcc -D jack -o capture_client `pkg-config --cflags --libs jack` capture_client.c
no em compila

gcc -D jack -o metro `pkg-config --cflags --libs jack` metro.c
./metro
(és un client de JACK que és un metrònom).

per a l'exemple transport.c és necessari incloure la llibreria -lreadline
$ gcc -D jack -o transport -lreadline `pkg-config --cflags --libs jack` transport.c
o també:
$ gcc -Wall transport.c -o transport -ljack -lreadline

$ ./transport
transport> help
activate Call jack_activate().
exit Exit transport program.
deactivate Call jack_deactivate().
help Display help text [<command>].
locate Locate to frame <position>.
master Become timebase master [<conditionally>].
play Start transport rolling.
quit Synonym for `exit'.
release Release timebase.
stop Stop transport.
tempo Set beat tempo <beats_per_min>.
timeout Set sync timeout in <seconds>.
? Synonym for `help'.

transport> play
transport> stop
transport> tempo 100
transport> play
transport> master
transport> tempo 80
transport> tempo 120
transport> stop
</pre>

==Què és una funció callback?==
Del Synthesis ToolKit in C++ trobo una bona definició de callback:
*https://ccrma.stanford.edu/software/stk/crealtime.html
<pre>
An alternative scheme for audio input/output is to define a specific function in which audio computations are performed and to let the audio system call this function when more input/output data can be accepted by the hardware (referred to as a callback scheme). In this section, we show how the previous rtsine.cpp program can be modified to work in a callback scenario. There is no "single-sample" interface for this functionality. The callback function will be invoked automatically by the audio system controller (RtAudio) when new data is needed and it is necessary to compute a full audio buffer of samples at that time (see Blocking vs. Callbacks for further information).
</pre>
La idea és que tenim un servidor d'àudio, i aquest servidor és el que s'encarrega de fer crides als clients quan detecta que el buffer de la interface està buida.
==Exemples didàctics==
He fet algunes aplicacions petites amb la idea d'ilustrar com es programa la API de JACK i com es poden fer coses bàsiques a nivell Audio i MIDI.
*[[Projectes_d'Informàtica_Musical#Exemples_did.C3.A0ctics_de_la_API_de_JACK]]
==Exemples importants: realtime, ringbuffer,...(per imprimir i provar)==
S'han recopilat els articles en un sol document i s'ha penjat al servidor:
*[[Fitxer:Articles codi audio programming.odt.zip]]

*Article ''Time waits for nothing'': http://www.rossbencina.com/code/real-time-audio-programming-101-time-waits-for-nothing
*sndfile-jackplay.c (/home/joan/projectes/jplay-sndfile). thread. Fem playback mentre llegim el fitxer. Comentaris sobre l'ús de threads a [[Fils/threads_amb_C%2B%2B]]
*JACK_i_Ringbuffer: http://harryhaaren.blogspot.com/2011/11/tutorial-jack-ringbuffers.html, [[Circular_buffer_/_Ringbuffer]]
*Gravar del micro: jcapture
*Gravar del micro: '''capture_client.c''' (https://github.com/jackaudio/example-clients/blob/master/capture_client.c). Comentaris sobre l'ús de threads a [[Fils/threads_amb_C%2B%2B]]
*http://harryhaaren.blogspot.com/2011/12/tutorial-load-loop-samples.html (Harry Haaren). This tutorial will show you how to load a sample into memory, and then play it back trough a JACK port, continually looping. There's not really that much to it, just a bit of thinking of the order things happen, and arrays.
**codi font: https://github.com/harryhaaren/Linux-Audio-Programming-Documentation/blob/master/loopedSample/loopedSample.cpp
*http://harryhaaren.blogspot.com/2010/06/tutorials.html
**JACK MIDI Examples
*http://harryhaaren.blogspot.com/2009/12/tut-5-callbacks-with-gtkmm.html. Callbacks with GTKmm (senyals)
*Writing Audio To File: http://harryhaaren.blogspot.com/2009/12/tut-4-writing-audio-to-file.html
*JACK tuner. http://freecode.com/projects/jack-tuner. '''compte!!''' aquest programa produciex tons, no és un afinador, i per tant no té res a veure amb la FFT. De totes maneres, pot ser interessant estudiar i compilar el codi.
=capture_client.c=
*https://github.com/jackaudio/example-clients/blob/master/capture_client.c
És un exemple important doncs mostra com s'utilitza la comunicació entre els fils de JACK i del fitxer. A la callback no hi ha cap operació que no sigui ''realtime safe'', però és possible que l'operació d'escriure a disc ralentitzi el procés i apareguin XRuns, que podem calcular (això només hauria de passar si tenim algun problema d'un disc que va lent, o estem utilitzant una latència molt baixa i no hi ha temps a escriure. Recordem que per a captura convé augmentar la latència).
<pre>
$ gcc -Wall -o jackrec -ljack -lsndfile capture_client.c
$ ./jackrec
usage: jackrec -f filename [ -d second ] [ -b bitdepth ] [ -B bufsize ] port1 [ port2 ... ]

$ ./jackrec -f foo.wav system:capture_1
</pre>
Però fixem-nos bé que amb aquesta tècnica de programació controlada per fils no hi ha un bucle principal del programa. Ara bé, com es pot veure estudiant el codi, la única manera de sortir del codi pel final del main() i poder tancar de manera polida el JACK i alliberar recursos és utilitzar l'opció -d, que limita el funcionament a un número de segons determinat. Si no utilitzo -d aleshores es tanca fent Ctrl-C, però el codi original no gestiona l'ús de Ctrl-C.
<pre>
$ gcc -Wall -o jackrec -ljack -lsndfile capture_client.c
$ ./jackrec -f aaa.wav -d 1 system:capture_1
disk thread finished
</pre>

{{Autor}}, setembre 2010

Programant amb l'API de JACK - Historial de revisió

Joan: /* example-clients dels repositoris */