PURE DATA

1

Copyright : The Contributors (see back) Published : 2011-02-11 License : None Note : We offer no warranty if you follow this manual and something goes wrong. So becareful!

Introduction1. Prsentation2. Exemples d'utilisation3. Programmation graphique

2

1. PRSENTATIONPure Data (souvent abrg pd) est un logiciel de cration multimdia interactif courammentutilis dans les domaines artistiques, scientifiques et pdagogiques. Sa popularit rsidenotamment dans sa facilit d'utilisation. Plutt qu'un langage de programmation textuel, PureData propose un environnement de programmation graphique dans laquelle l'utilisateur est invit manipuler des icnes reprsentants des fonctionnalits et les brancher ensemble.

UN LOGICIEL DE CRATION MULTIMDIA INTERACTIVEMULTIDISCIPLINAIRE

Pure Data est utilis dans tous les champs de la cration (musique, arts visuels, danse,thtre, robotique, etc.) pour des performances visuelles et sonores ou la cration d'installationsinteractives, participatives et gnratives. Il possde des capacits particulires dans lesdomaines de la musique acoustique et de la musique audio-numrique : il sert modliser desinstruments lectroniques comme les synthtiseurs. Il permet la gestion d'chantillonneurs(samplers) et d'effets, la composition musicale, ou encore, la cration de squenceur MIDI, etc. Ilpeut galement grer des applications vido et 3D.

Avec Pure Data, il est possible galement d'interfacer un programme avec le monde physique enutilisant des capteurs (camras, dtecteurs de prsence, etc.) pour commander des robots,interagir avec des sites internet, ou encore, effectuer une visualisation de donnes. En artappliqu, il est utilis en design d'interaction, en architecture et pour crer des jeux.

Par ailleurs, on trouve des utilisateurs de Pure Data dans d'autres disciplines techniques etscientifiques comme l'lectronique, les sciences physiques et les mathmatiques. Il peuttre un excellent outil de mesures acoustiques par exemple.

Enfin, c'est un outil pdagogique pour les analyses acoustiques et audio-numriques, lasynthse sonore, la 3D, les oprations mathmatiques, et de multiples autres domaines. Grce son systme de programmation intuitif, Pure Data favorise l'apprentissage et l'exprimentation.De nombreux enseignants et formateurs pdagogues l'utilisent pour leurs cours, formations etateliers, voire mme conoivent l'aide de ce logiciel des dispositifs numriques originauxd'enseignement.

L'accs tous ces domaines constitue une formidable richesse. Le croisement des disciplines etdes comptences cre une effervescence crative et stimulante. Cependant, certains domainestechniques, comme la manipulation du son, font appel des connaissances trs spcialises quidpassent la simple utilisation d'un logiciel. Cela peut crer des obstacles et des frustrations qu'ilne faut pas nier. Ces difficults peuvent tre dpasses en utilisant les ressources d'aidedisponibles comme les forums et les listes de diffusion.

UNE EXPRIENCE DE PROGRAMMATION VISUELLE ETINTUITIVE

3

Si Pure Data emprunte la programmation classique certaines notions comme les noms defonctions (objets), son attrait rside dans son environnement graphique. La programmationgraphique permet d'organiser des applications avec des icnes relies entre elles par des fils sansfaire appel des lignes de texte, contrairement aux environnements de programmationtraditionnels que sont par exemple le langage C ou le Pascal.

Programmer avec Pure Data est une exprience qui s'apparente manipuler des chosestangibles et les brancher ensemble. L'unit de base est une bote rectangulaire, et l'criture duprogramme (le patch) consiste relier ces botes avec des fils. Cela forme des graphes, oudiagrammes, qui mettent en abme leur propre fonctionnement.

En tout temps, le programme fonctionne permettant ainsi l'utilisateur de modifier son code etde voir aussitt les changements s'appliquer.

PETIT HISTORIQUE

Pure Data fait partie de la famille des langages de programmation par patchs comme JMax,VVVV, Ingen, etc. Cette famille de langages faite de botes et de fils tire son origine de laconception modulaire exprimente dans les premiers programmes musicaux de Max Mathewsau cours des annes 1950 qui avaient eux-mmes inspir les premiers synthtiseurs analogiques.

Miller Puckette est le crateur de Pure Data. En 1988, il dveloppe l'Ircam l'diteur Patcher(http://crca.ucsd.edu/~msp/Publications/icmc88.pdf). Ce logiciel fut revendu la socit Opcodepour crer bien plus tard Max/MSP. Miller Puckette reprit la conception de Patcher pour en faireun logiciel libre des fins musicales.

Les conditions de la vente du logiciel une entreprise commerciale, alors que la phase derecherche initiale tait intgralement finance par des fonds publics, restent encore aujourd'huiincomprhensibles et font dbat. D'ailleurs, les crateurs du logiciel propritaire Max/MSP ontcopi le code source de Pure Data pour crer la partie qui s'occupe du traitement de signal audiodans Max/MSP. Si Pure Data avait t publi sous une licence copyleft, comme la GPL, celan'aurait pas t lgal, mais hlas ! la BSD permet de privatiser le code source. Heureusement, lalicence BSD nous garantit de toujours pouvoir utiliser, partager et modifier Pure Data dans lefutur.

Pour les plus historiens d'entre vous, voici un diagramme sous la forme amusante d'un patchPure Data retraant cette volution :

Pour revenir Pure Data, la version actuelle de base s'appelle pd-vanilla. La version pd-extented 0.42-5 regroupe pd-vanilla et de nombreuses bibliothques tendant ainsi lesfonctions du logiciel. Les exemples donns dans ce manuel font rfrence ces 2 versions.

UN LOGICIEL LIBRE ET GRATUIT SOUTENU PAR UNECOMMUNAUT ACTIVE

4

http://crca.ucsd.edu/~msp/Publications/icmc88.pdf

La licence qui protge ce logiciel permet un travail collaboratif, l'accessibilit des sources et unedistribution gratuite auprs des utilisateurs. Pure Data est un logiciel libre publi sous la licence Standard Improved BSD . Le noyau de Pure Data (Pd Vanilla) est toujours maintenu par MillerPuckette. Par la suite, de nombreux dveloppeurs se sont joints au projet : ils ont permis ainsid'ajouter des "bibliothques" qui tendent les capacits du logiciel. Ceux-ci sont fournis avec PureData Extended, qui est une version du logiciel offrant plusieurs amliorations par rapport laversion Vanilla. La communaut se compose de dveloppeurs, d'utilisateurs et de personnes ressources .

Les dveloppeurs de bibliothques crent de nouveaux objets en langage C ou C++ oucontribuent amliorer le fonctionnement gnral du programme. Les utilisateurs s'y consacrent des fins artistiques, scientifiques ou pdagogiques. Ils peuvent aussi contribuer lacommunaut en partageant leurs expriences auprs des dveloppeurs ou en ditant desdocuments, des tutoriels, etc. Les personnes ressources organisent des moments detransmission des connaissances (conventions), des rencontres, des festivals artistiques etparticipent ainsi la vitalit des changes dans la communaut.

A PROPOS DE CE MANUEL

Ce manuel est une production originale en franais, plusieurs co-auteurs francophones dediffrents pays ayant particip sa rdaction. A l'occasion, il s'appuie sur le manuel dit surFLOSS Manuals anglophone.

Le manuel en franais de Pure Data est destin des publics professionnels ou amateurs quisouhaitent s'initier l'utilisation de ce logiciel. Il ne demande aucune connaissance pralable part celle de savoir manipuler un ordinateur. L'apprentissage de Pure Data est propos ici pas pas et nous vous invitons suivre l'ordre de succession des chapitres, particulirement lespremiers, qui posent les bases de l'utilisation du logiciel.

Disponible en plusieurs formats numriques (html, pdf, ePub) ainsi qu'en version papier, cemanuel est publi sous licence GPLv2 : vous tes autoriss le lire, le modifier et le copierlibrement.

Cet ouvrage est n d'une collaboration, il est vivant : il volue au fur et mesure descontributions. Pour consulter la dernire version actualise, nous vous invitons visiterrgulirement le volet francophone de Floss Manuals sur le site http://fr.flossmanuals.net.

Le cur et la structure de l'ouvrage d'environ 149 pages ont t raliss en 5 jours dans le cadred'un BookSprint qui s'est tenu Paris du 7 au 11 fvrier 2011 grce au partenariat et au soutientde l'Organisation internationale de la Francophonie (http://www.francophonie.org/), de Mainsd'uvres (http://www.mainsdoeuvres.org/) et d'Okno (http://www.okno.be/).

Vous consultez l'dition date du 11 fvrier 2011.

5

http://www.francophonie.org/http://www.mainsdoeuvres.org/http://www.okno.be/

2. EXEMPLES D'UTILISATIONLogiciel de cration multimdia temps rel, Pure Data est couramment utilis dans lesdomaines artistiques (musique, arts visuels, danse, thtre, arts appliqus, etc.), scientifiques(lectronique, robotique, sciences physiques, mathmatiques) et pdagogiques. L'accs tous cesdomaines constitue une formidable richesse. Le croisement des disciplines et des comptencescre une effervescence crative.

PRODUCTIONS ARTISTIQUES AVEC PURE DATA

Dans les champs des arts et de l'exprimentation, la richesse des fonctionnalits de Pure Datastimule l'imagination des crateurs et favorise la pluridisciplinarit. Utilis notamment dans lamusique, les arts visuels et la danse, il est au cur de performances visuelles et sonoresinteractives. Pure Data voyage travers pays et cultures notamment au Canada, en Belgique,au Sngal, en Tunisie, au Maroc, etc.

Voici quelques exemples de productions artistiques et musicales ralises avec Pure Data.

STUDIO DIOPTRIQUE

Utilis dans le cadre de vido-performances, le dispositif Studio dioptrique dconstruit les imagesqui passent travers lui : morceles, dstructures, elles prennent un nouveau sens. Gres parl'ordinateur, les dformations de l'image rpondent en temps rel aux gestes de la main del'utilisateur sur des objets. Studio dioptrique est dvelopp avec des logiciels libres notammentPure Data.

6

Ralis par Patrick Fontana et Pierre-Yves Fave (France) :http://fofana.free.fr/luca/videoperformancefr.htm

SYMPTMES

Symptmes lors du Plastic Hacker Space Festival, Octobre 2010.

Des fragments de mots, visibles l'cran, deviennent des espaces concrets et temporels.Symptmes explore les espaces de similitude ou de dissension entre texte et image. Utilisant lechamp lectromagntique pour la capture de l'environnement sonore interne l'ordinateur, un ouplusieurs enregistrements mergent de cet environnement frquentiel. l'aide du logiciel PureData, de lgres modulations des frquences rendent le discours compltement inaudible ouchangent la qualit du son.

Ralis en 2010 par Pascale Gustin (France) :http://www.pascsaq.org/weblog/archives/2010/11/11/sympt%C3%B4mes/index.html

GHOST ELECTRIC GEARS

Ghost electric Gears au Festival Garmerz 06

7

http://fofana.free.fr/luca/videoperformancefr.htmhttp://www.pascsaq.org/weblog/archives/2010/11/11/sympt%F4mes/index.html

Le principe de l'installation Ghost electric gears est d'implmenter dans le monde de l'artl'esthtique des vitrines des magasins de vente de matriel informatique, multimdia etd'appareils lectromnagers. L'ide est d'utiliser ces vitrines comme instruments de musiqueassists par ordinateur. Le dispositif est compos d'une carte Arduino et d'un squenceur midicontrls par le logiciel Pure Data : la carte d'interface envoie la lecture d'un fichier audio (midi).Ainsi, l'on peut animer ces objets qui "trainent dans nos placards" et crer une ambiance faite delumires et de sons.

Ralis en 2010 par Fenshu (France) :

Vido de l'installation au Festival Gamerz 06 :http://www.dailymotion.com/video/xfz1fu_festival-gamerz-06-fenshu-version-longue_videogamesPatch Pd.ziphttp://reso-nance.org/?p=272&lang=fr

L.T.D.M.S.

L.T.D.M.S. est une formation belge de post-rock noisy cre dbut 2000 sur les cendres dugroupe punk-rock Les Trucks. Le groupe apprcie de rcrer sur scne un lieu qui lui soit propreen installant des tlviseurs, des projecteurs ou des lumires tamises. Le VJ (Bernard Delcourt)utilise Pure Data avec l'extension vido PDP pour des projections multi-crans et pourtransformer le son de certains instruments en direct.

L.T.D.M.S. (Belgique) : http://www.ltdms.be

LE POULPE

8

http://www.dailymotion.com/video/xfz1fu_festival-gamerz-06-fenshu-version-longue_videogameshttp://reso-nance.org/wp-content/uploads/2010/12/patch-Ghost-electric-gears.ziphttp://reso-nance.org/?p=272&%E2%81%9E%u205Elang=frhttp://www.ltdms.be

Les composants matriels et logiciels du Poulpe : capteurs de son, table de mixage, ordinateur, carteson, patch Pure Data, hauts-parleurs.

Le POULPE sinstalle dans les lieux de vie quotidienne et citadine. Il forme le corps virtuel de laville exprimant par le son ses mouvements invisibles et lensemble des flux qui la traversent etqui la constituent. l'aide de capteurs de sons install dans diffrents lieux, le POULPE dploieses tentacules pour lier des contextes toujours diffrents et qui s'changent leurs flux sonoresvia internet : ces flux continus viennent simmiscer dans lenvironnement sonore dun milieu et lemodifient.

Selon sa propre logique, un automate virtuel utilisant Pure Data filtre en direct les sons capts,les transforme, les mixe et les redistribue.

Ralis en partenariat avec la Cellule dIntervention dAPO33, l'ECM de la Rgion Centre Bandits-mages, Labomedia et l'atelier nUM de l'Ecole suprieure des beaux-arts Tours (France) :http://www.apo33.org/poulpe/doku.php

Patch Pd du Poulpe orlanais : http://yamatierea.org/papatchs/lapoule33/lapoule33.zip

LA CHORALE A ROULETTES

Tlphones cadran bricols, ordinateur, logiciel Pure Data.

La Chorale roulettes est une installation sonore qui met en scne des tlphones cadran,modles de la communication moderne. Chaque appareil a conserv sa sonnerie originale.Additionnes et composes, celles-ci gnrent un rpertoire tendu o des timbres joyeux etentranants peuvent rpondre des sons dune infinie tristesse. La Chorale roulettes proposeune gamme de timbres allant de la sonnerie mlodieuse au clic peine audible dun ronronmtallique assourdi.

Ralis en 2007 par Darsha Hewitt et Alexandre Quessy (Canada-Qubec) :http://alexandre.quessy.net/?q=rotarianchoir

TECHNIQUE MIXTE

9

http://www.apo33.org/poulpe/doku.php http://yamatierea.org/papatchs/lapoule33/lapoule33.ziphttp://alexandre.quessy.net/?q=rotarianchoir

L'oeuvre participative Technique mixte au Festival E-Fest 2010 Tunis : cran de rtro-projection,vidoprojecteur, documents papier format A4, ordinateur, logiciel Pure Data, carte son, capteurspyrolectriques 60 et enceintes.

Technique mixte est un dispositif qui propose dexploiter une base de donnes virtuelle, actualiseet dcline sous diffrents formats (vido, papier et audio). Il introduit le processus dexplorationde donnes (Data Mining) dans le champ de lart. partir dune fouille de donnes, de techniqueset de matriaux utiliss pour dcrire les uvres dart runies sous forme de liste au sein dundocument potique, un programme lit le texte et gnre en temps rel une reprsentationdynamique et diagrammatique.

Un processus de traduction des donnes, entre visible et lisible, gnre des bulles qui grossissent,flottent et sentrechoquent, voluant ainsi dans le temps en fonction de leurs cohabitationsrcurrentes au sein des diffrentes techniques artistiques nonces dans le texte. Par sonintrusion dans ce dispositif interactif, le spectateur dclenche la relecture du texte et renouvelleainsi tout le processus.

Ralis en 2010 par Farah Khelil (Tunisie) : http://farahkhelil.free.fr/index.php?/projets/techniques-mixtes

CHDH

Deux ordinateurs portables, logiciel Pure Data, deux interfaces potentiomtres motoriss MIDI(BCF2000), une carte son (deux voix, sortie cinch), un splitter VGA.

10

http://farahkhelil.free.fr/index.php?/projets/techniques-mixtes

La performance Chdh explore les relations entre limage et le son notamment l'aide du logicielPure Data coupl la librairie GEM. Ce projet voque un monde virtuel, constitu de craturesabstraites plus ou moins autonomes. Le mouvement de ces cratures comme des instrumentsaudiovisuels singuliers est influenc en temps rel par deux instrumentistes qui les font vivre etragir. Ces objets virtuels crent alors des donnes utilises pour la synthse de la vido et duson, gnrant ainsi une forte cohsion entre les mdias utiliss. Le public assiste une projectioncinma gnre en temps rel par les deux instrumentistes placs ct de lcran.

Ralis par Cyrille Henry, Nicolas Montgermont, Damien Henry (France) :http://www.chdh.free.fr/spip.php?article2

RETIME/KRONOSCOP

Camras, un cran en tulle, clairage, ordinateur, logiciel Pure Data.

Grce un dispositif informatique, l'on peut enfin jongler avec le temps : faire ressentirlincroyable dilatation des secondes, suspendre les instants choisis, retrouver le prsent qui fileinexorablement ou, encore, revenir sur lerreur. Ces sensations prennent un sens particulierlorsquelles sont confrontes au jonglage, art de la contrainte. ReTime propose d'explorer ce brefinstant du jonglage o nat l'erreur... quelques secondes o tout s'chappe... ce moment o, horsde contrle, le monde patiemment bti dans la matrise, s'croule.

Entre le dsarroi et le dsaveu, le jongleur, dans son jeu avec la gravit, a encore perdu. Au-delde l'exprience de la chute et sa temporalit phmre, reTime joue avec le temps et l'espacecomme le jongleur avec la gravit. Cette observation est dautant plus perceptible lors dunspectacle puisque le public a une autre vision de ce que vit lacteur, il ne peroit pas latemporalit de celui qui agit. Aussi reTime propose un dispositif qui joue de cette perception dutemps. Faire ressentir lincroyable dilatation des secondes lorsque limprvu survient, suspendreles instants choisis, retrouver ce prsent qui file inexorablement ou revenir sur linfime erreur...sont autant de sensations qui prennent un sens si particulier lorsquelles sont confrontes aujonglage.

Ralis en 2006 par la Compagnie Adrien (France) :http://www.adrienm.net/spectacles/retime/index.html

RYBN

11

http://www.chdh.free.fr/spip.php?article2 http://www.adrienm.net/spectacles/retime/index.html

Depuis mars 2006, le collectif artistique RYBN dveloppe un projet de recherche autour du DataMining, bas sur la rcupration et la visualisation de donnes accessibles sur Internet. Endtournant les objectifs initiaux de Data Mining et de technologies de surveillance numriques, lesdonnes collectes l'aide de flux sont utilises pour crer une srie d'images. Ces visualisationsnumriques sont bases sur des principes cartographiques, et sont mises jour en temps rel.Le projet intitul Antidatamining (ADM) est la fois une enqute artistique, socio-conomique etgopolitique, ainsi qu'un processus archologique en temps rel se concentrant sur les flux dedonnes qui composent une partie de notre socit contemporaine.

Ralis depuis 2006 par RYbN (France / Belgique) : http://www.imal.org/WorkshopADM/index.php?page=rybn_fr

THIN SYNCH'D SPACES

Installation au BRASS, 2010, sur un cran en plastique vgtal. Un ordinateur, trois projecteursvidos, quatre enceintes acoustiques, camra IR, spot, structure aluminium, tendeurs.

12

http://www.imal.org/WorkshopADM/index.php?page=rybn_fr

Un grand cran traverse la salle. L'image y reflte un monde trange fait d'assemblagesd'espaces distincts et dans une temporalit dconcertante. Lorsquun spectateur s'en approche,il pntre dans cet univers et le son comme l'image suivent ses mouvements. Des lieux d'unpaysage urbain ont t films image par image durant plusieurs jours et par une synchronisationtoujours changeante des boucles d'images, le temps peru est alors "drgl".

L'espace visuel de cette installation est compos de surfaces vidos dans un espace 3D virtuel,de prises de vue de plusieurs camras en diffrents lieux relies par un rseau sans fil. Levisiteur parcourt ce lieu trange grce un capteur de mouvement permettant un contrlecorporel du point de vue : il se dplace physiquement et simultanment ses dplacements sontvirtuels dans l'architecture en mouvement avec l'impression d'tre face un miroir ou unefentre sur un autre monde. Les surfaces 3D sont "permables" et la gravit est absente : ceciajoute l'tranget de cet univers tout en trahissant la facture de l'illusion. L'interaction et laspatialisation du son, gnrs d'aprs des prises de son relles retravailles, sont dveloppesdans Pure Data. L'image est calcule en temps rel avec le moteur de jeux de Blender.

Ralis depuis 2008 par Ogeem / Olivier Meunier, Stephanie Laforce (Belgique) : http://ogeem.be

LA FAIM JUSTIFIE LES MOYENS

Sculpture interactive sur la thmatique de la faim.

En s'inspirant des meutes de la faim, les crateurs de cette oeuvre interactive veulent susciterune rflexion autour de la pauvret en Afrique. L'installation en bois est constitue d'uneaccumulation de manches de balais, de cuillres, de fer, etc. En ouvrant une bote de conservedans laquelle est install un capteur de luminosit, le visiteur enclenche un dfilement d'imagesde scnes de famine tout en faisant entendre des sons de cuillres.

Ralis en novembre 2010 - janvier 2011 par Charles Seck, Roland Kossigan Assilevi, SambaTounkara - Kr Thiossane (Sngal): http://sicap1695.phpnet.org/spip.php?article57

VEDERSI #1

13

http://ogeem.behttp://sicap1695.phpnet.org/spip.php?article57

Musique mixte pour une peinture, 2 surfaces vitres, Pure Data & 2 capteurs piezzo.

Aux frontires entre l'installation sonore et visuelle, l'action painting et la musique mixte,Vedersi#1 met en scne la transdisciplinarit en transformant le geste pictural en un flux sonore.L'artiste peint sur des surfaces verticales en verre sur lesquelles sont positionnes des capteursaudio de type piezzo. Les phnomnes sonores ainsi enregistrs sont transmis Pure Data quiles modifient en direct, en leur appliquant toutes les dclinaisons possibles du traitement dusignal audio numrique.

Ralis par Sitan adle K / Tad Bisaha au festival Dix'Art 2011 : http://vedersi.blogspot.com

PROJETS PDAGOGIQUES AVEC PURE DATA

Grce son systme de programmation intuitif, Pure Data favorise l'apprentissage etl'exprimentation. De nombreux artistes et pdagogues l'utilisent pour leurs cours, formations etateliers, voire mme conoivent l'aide de ce logiciel des dispositifs numriques originauxd'enseignement.

VALISE PDAGOGIQUE CRATION INTERACTIVE

14

http://vedersi.blogspot.com/

Prsentation de la valise pdagogique Kr Thiossane, Villa des arts et du multimdia

Ralis dans le cadre d'un projet d'essaimage de pratiques artistiques numriques en Afrique del'Ouest et dans les Carabes, la Valise Pdagogique Cration Interactive est un ensemble matriel,logiciel et documentaire pour l'apprentissage des technologies d'Interaction Temps Rel dans lacration contemporaine, tous champs artistiques confondus (arts plastiques, danse, thtre,musique, architecture, design, etc.).

Conue notamment avec Pure Data, la valise peut servir aussi bien de plate-formed'apprentissage dans le cadre d'un atelier de dcouverte de l'interaction en art que d'outil decration pour artiste en permettant d'inventer, de simuler puis de raliser des milliers dedispositifs interactifs diffrents.

Ralis en 2010-2011 par Jean-Nol Montagn (artiste plasticien), Jrme Abel (artistesdveloppeurs) et les lectroniciens africains de ENDA Ecopole en partenariat avec Kr Thiossane(Sngal) et le CRAS (France) :

CRAS : http://www.craslab.org/persojn/valise/index.php?page=Main+page KR THIOSSANE : http://sicap1695.phpnet.org/spip.php?article30ECOPOLE OUEST-AFRICAINE : http://www.enda.sn/ecopole/

MIAM - MALETTE INTERACTIVE ARTISTIQUE MULTIMEDIA

15

http://www.craslab.org/persojn/valise/index.php?page=Main+pagehttp://sicap1695.phpnet.org/spip.php?article30 http://www.enda.sn/ecopole/

Illustration des priphriques et dispositifs contenus dans la Malette Interactive ArtistiqueMultimedia

Destine tre tant un outil pdagogique quun instrument/systme vocation artistique,la Malette Interactive Artistiques Multimedia (MIAM) est constitue dun ordinateur quipedes priphriques les plus couramment utiliss dans les dispositifs et instruments interactifs(capteurs divers, webcam, joystick, wiimote, carte arduino, etc.). utilisant notamment Pure Data,elle offre aux enseignants et formateurs de nombreuses ressources numriques et multimedia "prt l'emploi" destin un large public pour un dcryptage et une approche de lhistoire de lartnumrique, interactif de faon didactique et illustre.

Le projet de Malette Interactive Artistique Multimedia a reu le soutien financier du Ministrefranais de la Culture et de la Communication.

Ralis en 2010-2011 par les associations Labomedia et Ping (France) en collaboration notammentavec la Fabrique du Libre : http://lamiam.fr/

Les images des ralisations prsentes dans ce chapitre sont la proprit de leurs auteursrespectifs.

16

http://lamiam.fr/

3. PROGRAMMATION GRAPHIQUELa programmation graphique permet d'organiser des applications avec des icnes relies entreelles par des fils sans faire appel des lignes de texte, contrairement aux environnements deprogrammation traditionnels que sont par exemple le C ou le Pascal.

PROGRAMMATION TEXTUELLE

Les programmes informatiques sont le plus souvent crits sous forme de texte. Ils sontenregistrs dans des fichiers que vous devez ensuite compiler pour rendre le programmeexcutable. Il s'agit de "programmation textuelle".

;

csound -W -d -o tone.wav

sr = 44100 ; Sample rate.kr = 4410 ; Control signal rate.ksmps = 10 ; Samples pr. control signal.nchnls = 1 ; Number of output channels.

instr 1a1 oscil p4, p5, 1 ; Simple oscillator. out a1 ; Output. endin

f1 0 8192 10 1 ; Table containing a sine wave. i1 0 1 20000 1000 ; Play one second of one kHz tone. e

Ci-dessus, un exemple de programme texte : http://fr.wikipedia.org/wiki/Csound

Maitriser les concepts et les langages de ces logiciels demande un certain temps d'tude et depratique. Pour ces raisons, aux yeux des non-programmeurs, ces mthodes d'criture et decompilation de programmes paraissent souvent peu intuitives.

PROGRAMMATION GRAPHIQUE

Pure Data propose un environnement de programmation graphique. Au lieu d'crire des lignes detexte, vous ajoutez et liez des lments graphiques : les "botes". Ces botes sont lareprsentation graphique de fonctions qui, quant elles, sont crites sous forme de texte etcompiles. L'action de ces boites est transparente pour l'utilisateur, il n'a pas se soucier descodages induits. Manipuler ces objets la souris et les dplacer dans l'espace de la page demeureplus accessible et ludique que d'crire des pages de code. En outre, l'aisance d'excution de PureData, la souplesse de l'interface, permet chacun d'aborder et de s'initier l'univers de laprogrammation.

17

http://fr.wikipedia.org/wiki/Csound

PATCH

Pure Data n'est pas un logiciel de plomberie (quoique) ni un logiciel de gnalogie. Ni un mtier tisser. Et pourtant... Un programme dans Pure Data s'appelle un "patch" c'est--dire unensemble de botes connectes par des fils. Ce terme vient des synthtiseurs modulaires. Lescbles audio y relient des modules sonores et cela cre un patch. Ce terme fut aussi utilis pourdsigner un programme l'poque des premiers gros ordinateurs comme l'ENIAC. Nous parlonsvolontiers de couture pour tisser nos programmes. En avant tisserand !

18

Installation4. Pd-extended vs pd-vanilla5. Installation sur GNU/Linux6. Installation sur Mac OS X7. Installation sur Windows

19

4. PD-EXTENDED VS PD-VANILLAPure Data se distribue selon deux saveurs, deux versions. Pure Data, vanilla et Pure DataExtended.

Pure Data Extended est souvent reprsent par le logo de Pure Data ajout d'un interrupteur.

La version de base de Pure Data dveloppe par Miller Puckette s'appelle pd-vanilla (Pure Datavanilla). Elle permet de manipuler de l'audio et du MIDI. Vous trouverez sur le site officiel(www.puredata.info, le tlchargement des versions les plus rcentes.

La version pd-extended (Pure Data Extended) regroupe pd-vanilla avec en plus de nombreusesbibliothques cres par une communaut de dveloppeurs. Ces bibliothques tendent lesfonctions de pd-vanilla pour pouvoir, par exemple, traiter de la vido, communiquer avec despriphriques USB et FIREWIRE ou raliser des oprations complexes en une seule fois, etc. Lesversions rcentes de Pure Data Extended se tlcharge galement depuis le site officiel duprojet.

20

http://puredata.info/downloads

Il est recommand aux utilisateurs qui dbutent avec Pure Data d'installer pd-extended.Cette version demeure la plus conviviale pour un dbutant tout en offrant un maximum depossibilits (pour un mme plaisir). Mais de nombreux utilisateurs plus expriments choisissentpd-vanilla pour la simplicit de son noyau requrant un minimum de dpendances. Cette optionimplique cependant d'installer soi-mme les extensions ncessaires ses besoins.

SYSTMES D'EXPLOITATION

Pd-vanilla comme pd-extended existent pour les trois principaux systmes d'exploitation :GNU/Linux, Mac OS X et Microsoft Windows. Ces applications ont rcemment t portesvers les plates-formes iOS, Android, Maemo et se dclinent aussi sur le Web via le projetWebPd.

Les dveloppeurs Pure Data privilgient le systme GNU/Linux, mais exportent souvent leurstravaux aux autres systmes d'exploitation, parfois en y ajoutant des optimisations spcifiques chaque systme. A noter aussi, par exemple, que certains objets n'existent que sur une desplates-formes, tandis que d'autres ne reposent que sur les bibliothques de votre systmed'exploitation. Par exemple, nous pouvons citer des optimisations de la librairie graphique GEMpour Mac OS X, l'objet [pix_video] de GEM dclin en [pix_videoDS] pour Windows, la dfuntebibliothque vido Framestein pour Windows, etc.

Quelque soit votre plateforme, Pure Data prservera sa convivialit et vous constaterez demeilleures performances si votre systme est bien en ordre.

21

http://mccormick.cx/projects/WebPd/

5. INSTALLATION SUR GNU/LINUXVoyons maintenant comment installer Pure Data sur un systme libre.

PD-EXTENDED

Nom du logiciel : Pure Data ExtendedPage de tlchargement : http://puredata.info/downloadsVersion du logiciel utilise ici : Pd-extended 0.42-5Systme d'exploitation utilis ici : Ubuntu 10.04 Lucid (similaire pour les autres versions)Matriel minimum recommand : Processeur 300 Mhz, 128 Mo RAMMatriel pour un usage audio/vido intense : Processeur 2 Ghz, 1 Go RAM, cartegraphique supportant bien l'OpenGL (NVIDIA, ATI, etc.)

Tlcharger et installer un paquet prt l'emploi

Le logiciel Pure Data est disponible sous forme de "paquets" pour les systmes d'exploitationDebian et Ubuntu : ceci veut dire qu'il peut s'installer en quelques clics.

Pour d'autres systmes d'exploitation GNU/Linux ou pour des besoins plus spcifiques, il estpossible de "compiler" Pure Data, c'est--dire de crer l'excutable partir des codes sources dulogiciel : cette opration est plutt rserve aux spcialistes et elle ne sera pas traite dans cechapitre.

Il existe plusieurs versions de pd-extended en fonction du processeur de votre ordinateur (32bits, 64 bits) et une version optimise pour certains netbooks

Rendez-vous la page de tlchargement : http://puredata.info/downloads

22

http://puredata.info/downloadshttp://puredata.info/downloads

1. Quand le paquet adapt votre processeur est tlcharg, faites un clic droit sur celui-ciet choisissez "Ouvrir avec installateur de paquets GDebi".

2. L'installateur de paquet s'ouvre et vous indique s'il est ncessaire de charger des librairiescomplmentaires : si c'est le cas, vous DEVEZ avoir une connexion internet pour terminerl'installation.

3. Cliquez sur "Installer le paquet".4. Tout se passe bien, l'installation se termine, vous avez dsormais une nouvelle icne dans

votre menu : Applications > Programmation > Pure Data

Mthode alternative : ajouter un dpt pour installer pd-extended

Plutt qu'une installation de pd-extended par tlchargement d'un paquet, la mthoded'installation via un dpt permet des mises jours simplifies. L'installation est lgrement pluslongue car elle ncessite de rajouter ce dpt contenant pd-extended son systmed'exploitation. Ceci peut tre fait en ligne de commande ou via le gestionnaire de paquets.

Pour connatre l'adresse du dpt correspondant votre systme, allez voir sur cette page dusite pure-data.info

Synaptic est un gestionnaire de paquets graphiques couramment utilis. Pour y accder, vousdevez identifier votre distribution Linux :

Menu Applications > Systme pour XubuntuMenu Systme > Administration pour Ubuntu

Pour aller plus loin : http://doc.ubuntu-fr.org/synaptic

PD-VANILLA

Pd-vanilla est prsent dans les dpts debian et ubuntu pour une installation plus simple :

soit avec le gestionnaire de paquets, chercher "Puredata" (sans avoir ajout de dptsupplmentaire) et faire un clic droit > "Slectionner pour installation"soit en ligne de commande

sudo apt-get install puredata

Trop facile ! Aprs, si vous avez besoin d'extensions spcifiques, vous pourrez peut-tre lestrouver dans les dpts d'Ubuntu. La plupart de ces paquets ont un nom qui commence par "pd-", sauf le paquet "gem".

DISTRIBUTIONS GNU/LINUX ORIENTES MULTIMDIA

Il vous est possible d'installer une distribution plus oriente pour le multimdia. C'est--dire unedistribution qui comprend les logiciels multimdia pr-installs, un noyau Linux temps rel, etc. Engnral, vous pouvez en choisir une avec la version "live" et la version normale installable. Laversion "live" vous permet de tester la distribution sans l'installer. Vous pouvez ainsi tester lacompatibilit de votre matriel.

Notez que ces distributions sont toujours en cours de dveloppement (comme tout le monde !) etdonc plus ou moins en retard par rapport aux distributions qui servent de base (Ubuntu, Debian,etc.) ;

De plus, pour certaines distributions, vous pouvez garder votre version actuelle et n'installer queles paquets multimdia et le noyau temps rel. Par exemple, pour Ubuntu, vous pouvez gardervotre version et installer les paquets : ubuntustudio-desktop, linux-rt, ubuntustudio-graphics,ubuntustudio-video, ubuntustudio-audio, ubuntustudio-audio-plugins (voir http://doc.ubuntu-fr.org/ubuntu_studio)

23

http://puredata.info/docs/faq/debianhttp://doc.ubuntu-fr.org/synaptichttp://doc.ubuntu-fr.org/ubuntu_studio

Les distributions : Puredyne, Ubuntu Studio, Apodio, Dyne:bolic, Debian Multimedia, TangoStudio,ArtistX.

Voir aussi le site http://www.linuxmao.org

24

http://puredyne.org/http://ubuntustudio.org/http://www.apodio.org/http://dynebolic.org/http://debian-multimedia.org/http://tangostudio.tuxfamily.org/http://www.artistx.org/site3/http://www.linuxmao.org

6. INSTALLATION SUR MAC OS XNous allons voir comment installer Pure Data sur Mac OS. Nous installerons Pd-extended, car ilfonctionne bien sous Max OS X, et comprend de nombreuses extensions.

PD-EXTENDED

Nom du logiciel : Pure Data Extended

Page de tlchargement : http://puredata.info/downloadsVersion du logiciel utilise ici : pd-extended 0.42-5Systme d'exploitation utilis ici : Mac OS 10.4 ou 10.5 Matriel minimum recommand : Processeur 300 Mhz, 128 Mo RAMMatriel pour un usage audio/vido intense : Processeur 2 Ghz, 1 Go RAM, cartegraphique supportant bien OpenGL (NVIDIA, ATI, etc.)

Tlcharger et installer un paquet prt l'emploi

Le logiciel Pure Data est disponible sous forme d'un paquet prt l'emploi.

Il existe plusieurs versions de pd-extended en fonction du processeur de votre ordinateur : Intel(Mac Pro, MacBook, all Intel Macs) ou PowerPC (PowerMac, PowerBook, iMac, with G4 or G5)(32bits, 64 bits).

La page de tlchargement : http://puredata.info/downloads

25

http://puredata.info/downloadshttp://puredata.info/downloads

1. Une fois le paquet adapt votre processeur tlcharg, double-cliquez sur celui-ci, "lireet accepter la Licence d'utilisation" apparat.

2. Cliquez sur "Agree" et l'image du disque se monte et s'ouvre automatiquement. Il suffitalors de dplacer pd-extended.app dans le dossier "Applications" (ou dans tout autredossier de votre choix) pour copier pd-extended sur votre disque dur et l'installer de faonprenne.

3. Une fois pd-extended copi sur votre disque, vous pouvez ventuellement lire le fichier"ReadMe" (en anglais) pour un complment d'information sur l'installation.

4. Vous retrouvez l'icne Pure Data dans vos applications et il vous suffit de double-cliquersur l'icne pour lancer Pure Data.

Pour lancer le logiciel, cliquez dsormais sur l'icne qui est prsente dans votre dossier"Applications" :

Pendant que le logiciel se lance, vrifiez dans la fentre qui s'ouvre que les librairies se chargentcorrectement. Si vous avez un message qui s'affiche comme celui ci-dessous, il vous faudra enplus installer X11 (installation dcrite au chapitre suivant).

26

Installation complmentaire de la librairie X11 pour Mac OS X 10.3 Pantherand 10.4 Tiger

Cette installation n'est plus ncessaire partir de Mac OS 10.5 puisque la librairie X11 y estinstalle par dfaut.

La librairie ddie au traitement vido PDP ncessite l'installation de la librairie X11 contenue dansle DVD d'installation de Mac OS et ce uniquement pour Mac OS 10.3 et 10.4. Si vous n'avez plusce DVD, vous pourrez le trouver en ligne. La Foire aux questions concernant Mac OS est ici :http://puredata.info/docs/faq/macosx

27

http://fr.flossmanuals.net/bin/view/Puredata/PDPhttp://puredata.info/docs/faq/macosx

1. Insrez votre disque OS X Tiger (#1). Descendez dans la fentre pour localiser l'icne"Optional Installs" et double-cliquez sur cette icne.

2. Cliquez sur "Continuer" au premier cran.3. Vous pouvez lire la licence d'utilisation et cliquez sur "Continuer".4. Cliquez sur Accepter5. Choisissez un emplacement et cliquez sur Continuer.

6. Droulez la liste des Applications, cochez la case correspondante X11, puis cliquez surUpgrade.

28

7. Entrez votre mot de passe et cliquez sur OK.8. Attendre jusqu' la fin de l'installation ...9. Quand la librairie X11 est installe correctement, cliquez sur Fermer.

10. Et voil!

29

7. INSTALLATION SUR WINDOWSInstallons maintenant Pure Data sur Windows.

PD EXTENDED

Nom du logiciel : Pure Data ExtendedPage de tlchargement : http://puredata.info/downloadsVersion du logiciel utilise ici : Pd-Extended 0.42.5Systme d'exploitation utilis ici : Windows XPMatriel minimum recommand : Processeur 300 Mhz, 128 Mo RAMMatriel pour un usage audio/vido intense : Processeur 2 Ghz, 1 Go RAM, Cartegraphique supportant bien l'OpenGL (Nvidia, ...)

Tlcharger et installer le logiciel

Le logiciel Pure Data Extended est disponible pour Microsoft Windows2000/XP/2003/Vista/Windows 7 (32-bit)

La page de tlchargement : http://puredata.info/downloads

Lien direct pour le tlchargement : http://downloads.sourceforge.net/pure-data/Pd-0.42.5-extended-windowsxp-i386.exe

1. Une fois le fichierPd-0.42.5-extended-windowsxp-i386.exe tlcharg, double cliquer sur celui-ci

2. Lire et accepter la Licence d'utilisation.

3. Choisir le dossier d'installation.

4. Crer le raccourci dans le menu Dmarrer.

5. Cliquer sur "Create a desktop icon" pour crer un raccourci sur le bureau.

6. Lancer l'installation.

30

http://puredata.info/downloadshttp://puredata.info/downloadshttp://downloads.sourceforge.net/pure-data/Pd-0.42.5-extended-windowsxp-i386.exe

7. Patienter ...

8. C'est fini !

9. Lancer Pure Data Extended en cliquant deux fois sur l'un des raccourcis, une alerte descurit Windows apparait, cliquer sur Dbloquer

Pd tant construit autour d'un client et d'un serveur qui communiquent entre eux au sein del'ordinateur, il faut "dire" au Firewall de Windows de dbloquer cette communication

10. C'est parti !

PD VANILLE

Nom du logiciel : Pure Data Vanilla

Page de tlchargement : http://puredata.info/downloadsVersion du logiciel utilise ici : Pd-Extended 0.42.6Systme d'exploitation utilis ici : Windows XPMatriel minimum recommand : Processeur 300 Mhz, 128 Mo RAMMatriel pour un usage audio/vido intense : Processeur 2 Ghz, 1 Go RAM, Cartegraphique supportant bien l'OpenGL (Nvidia, ...

31

http://puredata.info/downloads

Tlcharger et installer le logiciel

Le logiciel Pure Data Vanilla est disponible pour Microsoft Windows 2000/XP/2003/Vista/Windows7 (32-bit)

La page de tlchargement : http://puredata.info/downloads

http://downloads.sourceforge.net/pure-data/pd-0.42-5.msw.zip

1. Une fois le fichier pd-0.42-5.msw.zip tlcharg, l'extraire par exemple dans c:\Program Filesou tout autre rpertoire de votre choix.

2. Un dossier "Pd" est automatiquement cr, aller dans le rpertoire "bin" et cliquer sur lefichier "pd.exe", faire un clic droit et choisir "Envoyer vers" > "Bureau (Crer un raccourci)"

3. Cela permet de lancer Pd depuis le bureau

4. Double cliquer sur le raccourci pour lancer Pure Data Vanilla

5. Il faut cliquer sur Dbloquer pour laisser le client le serveur de Pd discuter ensemble

6. C'est parti !

Configuration8. Configurations audio et MIDI9. Configuration : chemins et librairies

32

http://puredata.info/downloadshttp://downloads.sourceforge.net/pure-data/pd-0.42-5.msw.zip

8. CONFIGURATIONS AUDIO ET MIDIChaque systme informatique est spcifique tout comme chaque utilisateur est diffrent. Si voussouhaitez utiliser Pure Data pour grer du signal audio, il vous faudra pralablement configurervos appareils audio. Si vous dcidez recevoir ou envoyer des notes et des contrles MIDI, il s'agitgalement de configurer vos appareils MIDI.

TESTEZ SI LE SON FONCTIONNE

Tout d'abord, Pure Data a peut-tre dtect automatiquement votre interface audio ! Pourvrifier si cette interface fonctionne, choisissez l'item "Test Audio and MIDI" dans le menu"Media" de Pure Data et le patch "testtone.pd" apparat.

Reprez les colonnes de carrs gauche du patch sous le titre "TEST TONES". Ces carrs oucases sont des choix multiples dont les options sont : "OFF", "60" ou "80". Pour entendre la jolienote LA 440 Hz, cliquez sur la case correspondant au choix "60" ou "80" et un carr noirapparat dans la case que vous avez slectionne. Si vous entendez un son, cela signifie que PureData a dtect votre interface audio ! Dans le cas contraire, il va vous falloir configurerl'interface utiliser. Nous verrons comment faire par la suite. L'on peut changer le son du testpar un bruit en choisissant l'option "NOISE" plutt que "TONE" en cliquant dans la casecorrespondante.

33

CHOIX DU PILOTE AUDIO

Pour capturer et faire entendre un son, Pure Data supporte une varit de pilotes audio quidpendent de votre systme d'exploitation. Les pilotes servent supporter des appareils audio.Ceux-ci sont lists dans le menu "Media".

Les pilotes supports sont sur GNU/Linux : OSS, ALSA ou JACK ; sur Mac OS X : portaudio ouJACK ; sur Windows : ASIO (via portaudio et qui est le seul support). Pour MS Windows, il estpossible d'installer Asio4all.

Pour changer de pilote, choisissez l'un d'entre eux dans le menu "Media". Sur GNU/Linux, ALSAdevrait fonctionner assez facilement. JACK, quant lui, est essentiel si vous souhaitez utiliser uneinterface audio Firewire ou si vous souhaitez brancher l'audio de Pure Data avec d'autres logiciels.Dans ce cas, vous pourriez tre amens utiliser l'application QJackctl (qjackctl en ligne decommande) pour grer JACK et ses connections.

Une fois le pilote choisi, vous pouvez ajuster avec finesse votre configuration audio.

CONFIGURATION AUDIO

Pure Data fournit une fentre de dialogue qui permet de configurer le nombre d'entres et desorties audio du logiciel ainsi que son taux d'chantillonnage. Vous n'entendrez rien si les optionsde ce dialogue sont mal configures.

Dans Pure Data, l'item "Autio settings..." se trouve dans le menu "Media" sous GNU/Linux etWindows et dans le menu "Preferences" sous Mac OS X.

34

http://www.asio4all.com/

Cliquez sur "Save all settings" avant de fermer cette bote de dialogue si vous souhaitezappliquer les changements effectus.

Le taux d'chantillonnage

Ce chiffre peut prendre l'une des valeurs supportes par votre pilote et votre interface audio.Par dfaut, il est de 44 100 Hz, ce qui correspond au taux d'chantillonnage des disquescompacts. Une autre valeur couramment utilise ici est 48 000 Hz.

Dlai

Pure Data a besoin d'un peu de temps pour temporiser le signal audio qu'il reoit et poureffectuer tous les calculs que vous lui faites faire avant de vous faire entendre des sons. Aintervalle rgulier, Pure Data enregistre le son dans un espace mmoire, puis il applique toutesles oprations sur le son et, enfin, il donne le rsultat de ces calculs l'interface audio afin depouvoir entendre quelque chose. La dure de cet intervalle est spcifie dans cette bote dedialogue (delay). Par dfaut, il est de 50 millisecondes.

Les musiciens prfrent quand ce nombre est petit. Toutefois si vous le rduisez trop, Pure Datan'a pas le temps de tout calculer et vous entendrez des craquements indsirables dans le son detemps en temps. Pour trouver une valeur optimale, vous pouvez tenter de rduire ce dlaiprogressivement jusqu' entendre ces craquements. Vous pourrez ensuite remonter le dlaijusqu' ce que vous n'en entendiez plus.

Si vous utilisez JACK, vous devriez vous assurer d'utiliser des blocs audio de la mme taille queceux de JACK. Pour cela, il vous suffit de crer un objet [block~] avec comme argument unnombre magique. Sous GNU/Linux, l'on obtient ce nombre en consultant notre configuration"QJackctl" (ou l'quivalent). Le nombre que l'on trouve sous "Frames/Period" est alors multiplierpar celui sous "Periods/Buffer".

Activation et nombres d'entres et de sorties

Vous pouvez activer ou non les entres et sorties de votre interface audio. Vous devriez lesactiver si elles ne le sont pas. Dans la plupart des cas, vous pouvez choisir la mme interfaceaudio pour les entres et les sorties, avec du son mono ou stro. Dans le second cas, il vousfaudra choisir deux canaux en entre et galement deux en sortie.

CHOIX DU PILOTE MIDI

Pour recevoir des notes et des contrles MIDI de quelque instrument MIDI que ce soit, vousdevez d'abord choisir un pilote. Les pilotes audio sont lists dans le menu "Media" avec leurappellation. Sur GNU/Linux, vous pouvez choisir "Default" ou "ALSA". Le second devrait bienfonctionner.

CONFIGURATION MIDI

35

Le dialogue de configuration MIDI est accessible par l'item "MIDI settings..." du menu "Media" ou"Preferences" sous Mac OS X. Cette bote de dialogue vous permet de choisir quel appareil MIDIvous souhaitez utiliser ainsi que le nombre d'entres et de sorties MIDI. Par exemple, si voussouhaitez brancher un clavier MIDI dans Pure Data, entrez le chiffre 1 dans le nombre d'entresMIDI.

Remarque : vous pouvez router le Midi entre les applications via Jack sur GNU/Linux.

TESTER LE MIDI

Le patch qui sert tester l'audio sert galement tester le MIDI. Choisir l'item "Test Audio andMIDI" du menu "Media". Si tout est bien configur, les nombres affichs dans ce patch devraientchanger lorsque vous appuyez sur les touches de votre clavier MIDI.

Vous pouvez galement envoyer des notes MIDI un appareil ou un autre logiciel branchs lasortie MIDI de Pure Data en cliquant sur la case de l'interrupteur qui a pour titre "MIDI OUT". Unecroix apparat dans cette case signalant la connexion effective.

36

9. CONFIGURATION : CHEMINS ETLIBRAIRIESPure Data est un programme modulaire qui, au dmarrage, charge les objets de base, puis desextensions. (librairies d'objets externes et librairies d'abstractions) Mais pour pouvoir charger cesmodules, Pure Data a besoin de connaitre les chemins prcis vers ces fichiers.

FICHIERS DE CONFIGURATION

La configuration de Pure Data est modifiable via son interface graphique et est enregistre dansun fichier:

GNU/Linux : ~/.pdrc, ~/.pdsetting, ~/.pdextended.Mac OS X : ~/.pdrc, ~/Library/Preferences/org.puredata.pd.plistMS Windows : Menu Dmarrer > Excuter une commande > Taper "regedit" :HKEY_LOCAL_MACHINE > SOFTWARE > Pd ou Pd-extended

Note : Dans les chemins de fichiers, le signe tilde "~" dsigne votre dossier utilisateur.

OPTIONS AU DMARRAGE

Beaucoup d'options sont modifiables. Par exemple, vous pouvez avoir besoin d'ouvrir un patch audmarrage de Pure Data ou de spcifier votre configuration audio et Midi. Sous GNU/Linux, onpeut dmarrer Pure Data en ligne de commande, et spcifier ces options directement cemoment. En voici un exemple :

pd -jack -r 48000 -inchannels 2 -outchannels 2 monpatch.pd

Vous pouvez aussi spcifier ce genre d'options dans un des fichiers de configuration, nousverrons comment un peu plus loin.

CHARGEMENT DE FICHIERS AU DMARRAGE

La boite de dialogue des chemins de recherche de Pure Data indique au logiciel o chercher lesextensions, les abstractions ou les polices de caractre, par exemple. Vous pouvez y ajouter leschemins des dossiers dans lesquels vous placez vos propres extensions. Pour afficher la boite dedialogue, choisir l'item "Path..." du menu "File". Sous Mac OS X, il se trouve plutt sous "Pd-Extended > Preferences > Path...".

37

CHARGEMENT DES BIBLIOTHQUES AU DMARRAGE

"Charger les bibliothques" signifie charger un ensemble d'objets externes. Il faut spcifier cesbibliothques Pure Data en indiquant leur nom qui se situe dans le rpertoire : "./extra/". Onouvre cette fentre en choisissant l'item "Startup" sous le menu "File" (ou "Pd-Extended >Preferences > Startup" sous Max OS X).

Noter le bloc de texte ditable droite de "startup flags" pour pouvoir entrer vos options dedmarrage. Chaque option est prcde d'un tiret "-".

CHARGER DES BIBLIOTHQUES UN FOIS EN ROUTE

Il est plus lger de ne charger les bibliothques que lorsqu'on en a vraiment besoin plutt que detoutes les charger systmatiquement au dmarrage. L'objet [import] permet de charger unebibliothque depuis un patch une fois que Pure Data est dj en marche.

ARBORESCENCE DES FICHIERS INSTALLS

38

Pour utiliser des extensions, il faut connatre leur nom et savoir o elles se trouvent. Lorsqu'oninstalle l'application, un rpertoire nomm "extra" est cr. Ce rpertoire contient plusieursextensions. Pure Data doit tre configur pour les chercher dans ce dossier lorsque vient letemps de crer un objet. Ce rpertoire est situ dans "/usr/lib/pd/extra" ou "/usr/lib/pd-extended/extra". Sous Mac OS X, rejoindre "/Applications/Pd-extended.app/Contents/Resources"et faire un clic-droit sur l'icne de l'application pour en afficher le contenu. Sous MicrosoftWindows, les fichiers de Pure Data sont situs sous "C:/Program files/pd".

Au mme niveau que ce rpertoire "extra" se trouve galement un rpertoire nomm "doc" quicontient des tonnes de patchs de documentation.

Les extensions pour Pure Data se nomment ".pd_linux" sous GNU/Linux, ".pd_darwin" sous MacOS X et ".dll" sous Microsoft Windows.

NOTES SUR LES CHEMINS ET RELATIFS

Pour indiquer Pure Data un fichier (par exemple sonore ou vido) ouvrir, on peut utiliser unchemin relatif ou un chemin absolu. Un chemin relatif est relatif au rpertoire dans lequel setrouve votre patch. Ainsi, si on souhaites ouvrir l'image "bonjour.jpg" qui se trouve dans le mmerpertoire que notre patch, on doit simplement spcifier "bonjour.jpg". Un chemin absolu, lui, estrelatif la racine du systme de fichiers. Par exemple, voici comment indiquer le chemin absoluvers le fichier "bonjour.jpg" qui se trouve sur votre bureau, si votre nom d'usager est "martin" :

Sous GNU/Linux :

/home/martin/bonjour.jpg

Sous Mac OS X :

/Users/martin/bonjour.jpg

Sous Microsoft Windows :

C:/Documents and Settings/martin/bonjour.jpg

Pour connatre le chemin absolu vers votre patch, voir dans la barre du haut de sa fentre :

Ici, on peut voir que cette patch est dans le rpertoire "/usr/lib/pd-extended/doc/manuals/0.Intro/".

Prise en main rapide10. Introduction par l'exemple11. L'interface utilisateur12. Le patch13. Le flot des donnes14. Objets graphiques15. Quelques objets utiles16. Mon premier patch17. Organisation des objets

39

10. INTRODUCTION PAR L'EXEMPLENous allons maintenant voir un exemple de patch fait avec Pure Data. Il s'agit d'un patch qui ferades notes de musique alatoires sans arrt.

Dans un patch, l'information s'coule du haut vers le bas. La sortie de chaque bote estconnecte l'entre d'une autre afin d'y diriger de l'information. L'information s'coule parimpulsions, comme le sang dans les artres.

Ce patch contient un interrupteur, qui lorsqu'on l'active, allume le mtronome. Ce mtronome semet battre toutes les 250 millisecondes. Il envoie une impulsion via sa sortie. Notez que laglissire horizontale qui se trouve en haut droite de ce patch permet de varier la vitesse dumtronome, car il est connect sa seconde entre, qui sert spcifier cette intervale.

Plus bas, c'est un objet [random] qui reoit les impulsions du mtronome. Il produit un nombre auhasard entre 0 et 999. (car il offre mille choix) On peut changer le nombre de choix parmilesquels il tire au hasard en lui envoyant un nombre dans sa deuxime entre.

Ensuite, on additionne 20 au nombre qui a t choisi au hasard. Pourquoi ? Eh bien ! c'est pourviter de produire des frquences trop graves, ce qui pourrait endommager vos enceintes audio.Mieux vaut tre prudent. Le nombre obtenu est envoy dans l'objet [osc~]. Celui-ci s'attend recevoir un nombre qui lui dira quelle frquence osciller priodiquement. Cela va produire uneonde sonore.

Enfin, le signal sonore qui est produit par l'oscillateur [osc~] est envoy aux deux sorties audio devotre interface audio. C'est l le rle de l'objet [adc~] que d'tre le point de sortie du son traitou produit par Pure Data. Notez que les fils qui transportent un signal audio sont plus gras queceux qui acheminent des impulsions de donnes.

40

CONVENTIONS SYNTAXIQUES PROPRES PURE DATA

[create < Dans Pure Data, cette convention sert dcrire un message.

[gemwin] Dans Pure Data, cette convention sert dcrire un objet.

41

11. L'INTERFACE UTILISATEURpetite phrase introductive svp

POUR DMARRER PURE DATA

sur GNU/Linux, par exemple nous le trouverons dans le menu Applications > Sound &Video > PureData ou dans le menu Applications > Multimdia > Pd-extended

sur Windows, vous le trouverez dans le menu Dmarrer > Programmes > Pd-extendedsur Mac OS X, double-cliquez sur l'icne prsent dans le dossier "Applications".

Sous GNU/Linux, Pure Data (Vanilla) se dmarre galement en entrant la commande "pd" dansun terminal :

pd

ou pour Pure Data Extended, selon votre mthode d'installation (paquets .deb ou gestionnaire depaquets) :

pdextended

FENTRE PRINCIPALE

Quand nous ouvrons Pure Data pour la premire fois, nous nous retrouvons face ce que nousallons appeler la fentre principale. Celle-ci contient diverses informations et surtout la console.

Tout d'abord, nous remarquons une succession de messages (des indications textuelles) qui, nousle comprendrons au cours de notre pratique, peuvent tre des outils essentiels pour l'crituredes programmes. Ils le sont notamment pour la correction des erreurs ventuelles. On vrifieainsi que le programme que nous venons de crer fonctionne tel que nous le souhaitons. Cesmessages textuels sont lisibles dans la fentre principale. Quand on envoie des messages dansl'objet [print], on peut afficher des informations dans la console.

42

Les messages textuels envoys par Pure Data lors de son chargement sont galement desindications importantes propos du chargement des bibliothques externes (externals) etventuellement des erreurs encourues lors de leur chargement.

Quelques uns des messages rencontrs

[import] $Revision: 1.2 $ [import] is still in development, the interface could change! compiled against Pd version 0.42.5

Ces messages informent essentiellement sur la version de Pure Data utilise. Sur le message ci-dessus, la version est la 0.42.

GEM: Graphics Environment for MultimediaGEM: ver: 0.92.3GEM: compiled: Sep 22 2010

Le message ci-dessus nous apprend que la bibliothque (librairie) Gem (voir plus loin dans cemanuel pour de plus amples informations son sujet) est prsente dans sa version 0.92.3compile le 22 septembre 2010. En gnral, s'ensuivent les noms des diffrents dveloppeurs dela bibliothque.

Activer et dsactiver l'audio

Une des options les plus importantes dans la fentre principale repose sur la possibilit decommuter l'audio. Pour ce faire, il suffit de cocher la case nomme "compute audio" en haut droite de la console des messages.

LES MENUS

Au dessus de la console des messages, nous trouvons toute une suite de menus droulants.Voici quelques unes de leurs principales caractristiques.

Dans le menu suivant Pd-extended vous trouverez essentiellement :

43

1. Des informations au sujet de la version de Pure Data installe sur votre systme.2. La possibilit de changer les Preferences par dfaut (voir la partie installation pour plus de

dtail ce sujet).3. La possibilit de quitter Pure Data

Dans le menu File, nous allons pouvoir :

1. Crer un nouveau fichier.2. Ouvrir un fichier existant.3. Fermer le fichier courant.4. Sauvegarder le fichier.5. Sauvegarder le fichier sous.

MODE ACTION ET MODE DITION

Dans le menu Edit se trouve l'tat fondamental dans lequel nous voluons avec Pure Data : soitnous ditons le patch, soit nous l'utilisons. En mode "action", nous agissons sur le programme,nous contrlons les paramtres et nous actionnons des comportements pr-dfinis. En mode"dition", nous pouvons "crire" ces comportements, dfinir les calculs etc. Le mode "action" estutile quand on excute par exemple une performance ou quand on utilise le rsultat de notrepatch.

ctl + e ou pomme + e : edit mode (curseur main) / action mode (curseur flche)

44

Le mode dans lequel nous nous trouvons est indiqu tout en bas du menu face l'item Editmode.

N.B. : Agir lgrement sur le curseur pour visualiser le changement.

Savoir changer du mode "dition" au mode "utilisation" est une habilet des plus importantespour matriser Pure Data. Nous distinguerons facilement ces deux modes : en mode dition lecurseur de la souris se transforme en petite main tandis qu'en mode action, les lments placssont griss continuellement, ne peuvent tre dplacs, ni effacs. Par contre, l'avantage du modeutilisation est que nous pouvons alors cliquer sur les botes messages afin d'en activer la sortie,changer la valeur dans les botes nombre, cliquer sur les bang, et utiliser les autres objetsgraphiques.

45

12. LE PATCHL'ensemble structur et organis des instructions relatives ce que l'on veut programmer se faitdans le patch.

Nous prsentons dans ce chapitre, les composantes de bases ainsi que les menuscomplmentaires de l'espace de travail de Pure Data.

COMPOSANTES DE BASES

C'est partir du menu Put que nous allons pouvoir placer sur notre patch les lments de basedu traitement des donnes. Ce menu offre des choix intressants seulement si le patch estouvert. Afin de rendre ces quelques premires indications plus concrtes, nous allons prsentles mettre en uvre et crer un premier patch.

LE PATCH

Qu'est-ce qu'un patch ?

Ce que nous appelons communment un patch, c'est une feuille de travail ou un espace detravail, au commencement vide ! Sur laquelle nous allons pouvoir "composer", "tisser" ou crirenotre programme.

Faire Menu -> File -> New ou Ctrl+n. Ceci cre un patch :

46

Un nouveau patch, vraiment vide !

LA BOTE MESSAGE

Le message dans son concept abstrait est toute donne qui transite l'intrieur de Pure Data travers les ficelles grises fines, hormis le son. Comprendre le traitement des messages dans PureData est une partie essentielle de sa prise en main complte. Cette partie spcifique sera traiteultrieurement.

La bote message, quant elle prend la forme concrte d'une sorte de drapeau, que nouspourrions comparer galement une "enveloppe". Disons que c'est une sorte de "poche" derception et d'envoi, trs pratique pour traiter pratiquement toutes les formes de donnes denatures diffrentes (nombres, symboles...) rencontres dans Pure Data, sauf le son.

Sur cette feuille vide, dans le Menu -> Put -> Message ou Ctrl+Maj+2, nous crons notrepremire bote de message.

Ci-dessus, une bote de message vide.

LA BOTE OBJET

Nous allons ensuite crer un premier objet. Faire Menu -> Put -> Object ou Ctrl+Maj+1

47

Ce que nous nommons objet est ce genre de bote rectangulaire comme ci-dessous :

A l'intrieur du rectangle en pointill, nous allons crire le nom de l'objet que nous souhaitonsutiliser, ici [print]. "print" sert afficher dans la console les messages qui lui sont envoys, sansles transformer, sans effectuer aucun calcul dessus.

Une fois cre, cette bote se dessine soit sous forme de pointills bleu ou rouge, soit ses traitssont continus et gris fonc. Si les traits sont en pointills, il y a une erreur et nous avons chou crer l'objet (erreur de frappe par exemple). Si les traits sont pleins, tout va bien et notre objetexiste !

En programmation, chaque caractre, espace ou signe de ponctuation son importance !

On pourrait comparer cet objet ce que l'on nomme en informatique une fonction, c'est direquelque chose qui effectue une action prcise quand on le lui demande. Dans le cas prsent, nouslui demandons d'crire un message dans la console. Pour que cet ordre devienne effectif, nousl'avons spcifi explicitement, ici en inscrivant le mot "print" dans la bote. On appelle ce nom laclasse de l'objet, ou plus simplement, le nom de l'objet.

A la suite de certains noms d'objets, on peut y ajouter un ou plusieurs arguments sous la formede mots et/ou de chiffres spars par des espaces. Certains objets acceptent diffrents typesd'arguments. Si nous faisons erreur, dans ce cas galement, l'objet peut refuser de natre !

Dans le cas prsent ici, l'argument accept par la fonction d'impression [print] est un entteajout devant le message envoy. Cet entte sera utile pour distinguer plusieurs messages lesuns des autres dans le cas o plusieurs objets [print] se trouvent dans le patch.

48

Ensuite, en mode dition (Ctrl+e) l'aide du pointeur de la souris, nous allons nous positionnerau-dessus du minuscule rectangle situ en bas gauche de notre bote de message. Le pointeurse transforme en cercle noir gras. En cliquant sur le bouton gauche de la souris, nous allons tirerun cble du bas de la bote message, vers le petit rectangle situ en haut et gauche de la boteobjet [print]. Lorsque notre curseur est au-dessus du petit rectangle en haut gauche de l'objeten question, un cercle noir devrait apparatre nouveau, nous signalant que, si nous lchons lebouton gauche de notre souris, nous allons effectuer une connexion. C'est dire, brancher nosdeux botes ensemble !

Ces rectangles situs en haut et en bas des botes messages, des botes objets, des botesnombres etc. sont les entres et des sorties du flot des donnes. Nous les nommerons entres(inlet) et sorties (outlet).

Quand on clique sur une bote message, le message qu'elle contient est envoy travers les filsconnects sa sortie. Bien faire attention passer en mode action !

LA BOTE NOMBRE

La bote nombre permet de recueillir, de lire ou de contrler un flot de donnes de type float ounombre dcimal. Il est noter que Pure Data ne travaille pas avec des nombres entiers maisseulement avec des nombres virgule. De plus amples dtails ce sujet, seront dvelopps dansla suite de ce manuel.

Pour crer une bote nombre, faire Ctrl+Maj+3.

49

En mode action, nous pouvons soit cliquer et glisser le curseur de la souris de bas en haut ou dehaut en bas pour faire voluer les valeurs l'intrieur de la bote, soit en cliquant directement l'intrieur de la bote nombre, entrer une valeur directement au clavier.

LA BOTE SYMBOL

La bote symbol aura un peu le mme comportement que la bote nombre, sauf qu'elle va nouspermettre de visualiser ou entrer au clavier des chanes de caractres. Notez que cette boteressemble la bote de nombre. Elle est seulement plus allonge. Pour entrer une chane decaractre l'intrieur, il faut cliquer sur la bote en mode action, puis entrer au clavier le motsouhait.

Remarque : Pour faire sortir le mot dans la console de Pure Data, en d'autre terme activer uneaction sur la bote symbol, faire un retour chariot.

Faire Menu -> Put -> Symbol ou Ctrl+Maj+4

Toutes ces botes nombres, botes objets, botes symbols peuvent tre connectes entre elles.

HELP!

Il est a noter une particularit trs intressante de Pd offrant l'accs des rubriques d'aidesinternes, crites directement avec Pure Data. Ceci nous permet, par exemple, de tester lespatches pour les dcouvrir concrtement ou bien effectuer des copier / coller de portions de cesrubriques, d'exprimenter, de jouer avec, etc.

50

Pour accder pendant l'criture du patch ces rubriques et sans sortir de ce dernier, il suffit deplacer le curseur de votre souris sur, par exemple la bote objet avec le nom de sa fonction et defaire un clic droit. Une fentre de dialogue doit apparatre comme ceci :

LES COMMENTAIRES

Un commentaire permet, comme son nom l'indique, de commenter. C'est dire de laisser desinformations lisibles pour soi-mme ou pour d'autres, de nos actions effectues sur le patch, desmodifications apportes ou du comportement de certaines portions du patch. C'est une bonnehabitude prendre lorsque nous commenons programmer. Cela favorise la lisibilit, le travailen quipe et la rutilisation de nos patches.

Faire Menu -> Put -> Comment ou Ctrl+Maj+5

SUPPLMENTS AU SUJET DES MENUS.

Le menu Find permet de localiser les parties problmatiques. Elles seront marques en bleu. Siune erreur est dtecte par Pure Data, elle sera signale dans la console.

Le menu Media permet d'activer ou de dsactiver l'audio, de configurer l'audio et le MIDI, detester si tout a fonctionne, et bien plus encore. Nous verrons tout cela en dtails dans lechapitre sur la configuration audio et MIDI.

Le menu Window permet de vrifier et d'accder aux diffrentes fentres ouvertes durant lasession de travail.

Enfin le menu Help, nous donne accs de prcieuses informations et exemples d'aides :

51

Dans les deux captures ci-dessus, nous avons gauche la plage droule du menu Help.Browser est slectionn. A droite, le sous-menu Help Browser, tel qu'il se prsente dans laversion 0.42.5 de Pd-extended (Mac OS X). Ce navigateur d'aide contient des tonnes d'exempleset de patch d'aide pour des tas d'objets. Essayer de comprendre et d'utiliser un patch d'aide parjour est un excellent moyen de matriser rapidement Pure Data. Patience et courage ! Le jeu envaut la chandelle.

La rubrique Manuals/ va nous permettre d'accder divers manuels en anglais. Pure Data/ nousmnera vers les tutoriaux de base du cur de Pure Data... Viennent ensuite la liste desbibliothques externes avec leurs exemples d'aides et autres informations intgrs par chacunde leurs dveloppeurs.

52

13. LE FLOT DES DONNESLa programmation graphique avec Pure Data est relativement intuitive, mais certaines notionsdans la manire dont les informations s'coulent peuvent parfois drouter, et rendre lacomprhension des patchs difficile pour l'oeil nophyte. Nous allons donc ici introduire plusieursmanires particulires au flot des donnes dans le langage de dataflow qu'offre Pure Data.

L'ORDRE DES OPRATIONS

Pure Data fonctionne suivant la logique de la "chute d'eau", c'est--dire que les donnes partentdu haut pour transiter vers le bas. Les entres (inlets) sont donc sur le haut des botes, lessorties (outlets) sur le bas. Le transit des donnes est instantan : il n'y a pas de dlai entrel'entre d'une donne et sa sortie dans la bote suivante.

L'ordre dans lequel les messages entrent et sortent des botes est important. Quand un objeteffectue une action, et si des messages doivent passer par plusieurs de ses "sorties", ce seratoujours la sortie la plus droite qui produira un message en premier. Ses autres messages envoyer le seront de droite gauche jusqu' la sortie la plus gauche.

L'objet [trigger] permet de contrler l'ordre d'envoi des informations des sorties de droite gauche et permet de convertir le type de donne relaye (voir chapitre : "Quelques objetsutiles").

LES MESSAGES

Les objets dans Pure Data communiquent les uns avec les autres en utilisant des messagesgnralement partir de la sortie ou l'"outlet" d'un objet vers l'entre ou l'"inlet" d'un autreobjet. Ces messages sont transports travers les lignes noires appeles les "ficelles". Cesmessages sont gnralement des "requtes" c'est--dire qu'ils demandent l'objet d'oprer uneaction comme "ouvrir un fichier", de faire un calcul (addition, soustraction etc.) ou de stocker desdonnes. Mis part les signaux audio (objet + ~ avec ficelles paisses) toutes les autres donnesen Pure Data sont des messages.

Les messages sont composs de un ou plusieurs lments de donnes appels atomes.

Il y a plusieurs types d'atomes dans Pure Data, mais les plus importants sont les suivants :

numriques - des nombres comme "3," "4.5," ou "5.55556e+06"symboliques - typiquement un mot qui ne peut tre interprt comme un nombre, et quine contient pas d'espace, par exemple "blablah" "fichier02" ou "reset".

(N.B. : attention utiliser le point la place de la virgule pour les nombres avec des dcimales.)

Les messages dans Pure Data commencent par un atome symbolique appel selecteur, qui peuttre suivi par zro ou plus d'atomes, appels lments du message (tous spars par desespaces). Hormis deux exceptions bien pratiques expliques ci-dessous, les messages Pure Dataadhrent la forme : slecteur lment1 lment2 lment3 (etc.).

Le slecteur du message permet l'objet de savoir ce qu'il doit faire : quand un message arrive l'une de ses entres, l'objet vrifie le slecteur et choisit l'action approprie ou mthode.Chaque objet a sa ou ses mthodes particulires. Un objet peut ainsi accepter un messageconstitu du slecteur "set" suivi d'un atome numrique, ce qui permettra de sauvegarder cettevaleur. Un autre objet peut accepter un message constitu du seul slecteur "clear" (sanslment) comme mthode permettant "d'oublier" les donnes actuellement en mmoire. Poursavoir ce qu'un objet accepte comme messages, il suffit de faire un clic-droit sur l'objet et dechoisir help depuis le menu contextuel.

53

Les objets de pd impriment un message d'erreur dans la console chaque fois qu'ils reoivent unmessage incompris par l'objet. [change] par exemple, n'accepte que les nombres et le symbole"set". Si on lui adresse le message [Nicolas est nerveux

CONNECTIONS SANS FIL

Il est possible de connecter des composants ensemble et d'envoyer des messages sans utiliserde fil : on utilise alors la fonction des objets [send] et [receive] qui vont agir comme metteurs etrcepteurs.

Lors de la cration des objets, on ajoute un mot-cl qui sera le nom du fil virtuel reliantl'metteur et le(s) rcepteur(s). Ceci fonctionne sur toute la session Pure Data en cours commeliant entre tous les patchs, les sous-patchs et les abstractions qui sont ouverts. Il faut donc faireattention au mot-cl employ pour tre certain du chemin pris par les donnes.

Il est galement possible de raliser cette opration en utilisant les proprits des composants(clic droit, Properties) et en ditant les champs "send symbol" ou "receive symbol" avec le tagdsir. Ceci supprime l'entre/sortie concerne, et la remplace par un envoi sans fil. Cettemthode est pratique mais ncessite plus d'attention lors de la relecture du patch, puisque lessources/destinations ne sont ds lors plus visible dans la fentre du patch.

Un message peut galement envoyer ses donnes sans fil, en utilisant une syntaxe spcifique : siun message contient un point-virgule+retour la ligne, la suite du message est interprtecomme un [send] avec le premier argument comme tag et le second comme valeur.

Plusieurs lignes peuvent tres combines pour envoyer des messages plusieurs [receive]diffrents...

LE SIGNE $

Parfois on veut rserver une place dans les arguments d'un objet ou dans un message pour unevaleur qui sera dtermine ultrieurement. Pour ce faire on utilise le signe $ (dollar).

Ce signe a un usage diffrent selon qu'on l'utilise dans un objet ou un message.

Dans un message

Une boite message accepte les variables $n (avec n > 0) et les substitue par la valeurcorrespondante l'index de l'atome dans une liste reue. La substitution est purement locale etcorrespond uniquement la liste reue, contrairement l'utilisation dans un message o les $ncorrespondent des arguments du patch.

Dans un objet

De la mme manire qu'un objet accepte des arguments, une abstraction peut en accepter pourles utiliser l'intrieur. Les arguments sont passs dans l'ordre, et sont accessible par l'usage de$n avec n correspondant la position de l'argument dans la dclaration de l'abstraction.

55

Par exemple, cette abstraction multiplie la valeur entre droite par les 2 arguments lorsqu'onlui envoie un bang gauche :

Le signe dollar $n utilis dans un objet fera donc toujours rfrence aux arguments del'abstraction laquelle il appartient, contrairement l'usage dans les messages.

Alors que $1, $2, etc. reprsentent le premier, second, etc. argument de l'abstraction, il y en aun spcial qui est trs utile dans Pure Data. $0 est une variable qui est remplace de manireinterne par un nombre unique de 4 chiffres propre chaque patch et instance d'abstraction. End'autres mots, pd fait en sorte que chaque instance d'abstraction reoive un nombre uniquemmoris dans la variable $0. L'utilit en est dmontre dans l'abstraction suivante utilisant deslignes de dlais, qui ne peuvent avoir le mme nom dans plusieurs instances de la mmeabstraction, sous peine de conflit.

Les lignes de dlais dans les instances de l'abstraction [localdelay] sont donc nommes ici 1021-dline et 1022-dline.

Bien qu'on appelle souvent une variable construite avec $0-kekchose "variable locale", il est touta fait possible d'y accder depuis l'espace de variable globale simplement en trouvant par quoi at remplac $0, comme ci-dessus. C'est donc uniquement l'assignation qui est locale, pas lavariable construite.

56

14. OBJETS GRAPHIQUESIl existe dans Pure Data des objets qui peuvent nous aider crer des interfaces graphiques enquelques clics. Ils illustrent des mtaphores classiques de contrle comme celles de boutons, decurseurs et d'interrupteurs. Il vous est possible de crer ces objets en choisissant un des itemsde la deuxime section du menu "Put".

N.B. Il faut pralablement avoir crer un premier patch pour pouvoir accder au menu droulant"Put".

Le plus simple de ces gadgets est le "Canvas", qui n'est en fait qu'un rectangle de couleur. Cetobjet peut tre cr en crivant [cnv] dans une bote d'objet ou en choisissant l'item "Canvas" dumenu "Put".

Nous pouvons changer certaines proprits du "Canvas" comme sa couleur et sa taille en faisantun clic-droit l'intrieur du carr aux bordures bleu lectrique qui se trouve en haut et gauchedu canvas.

Un menu spcifique au "Canvas" apparat et vous pouvez choisir l'item "Properties" : ceci faitapparatre une fentre avec diffrentes proprits. La caractristique de pouvoir changer lesproprits d'un objet est valable pour la plupart des objets interactifs que nous trouvons dans laseconde section du menu "Put". La possibilit de modifier les proprits des objets interactifs lesdistinguent des botes objets de bases que nous avons vues prcdemment.

57

L'on peut galement accompagner d'une tiquette de texte un patch ou un secteur du patch.Cela peut rendre les interfaces graphiques cres plus faciles comprendre au premier coupd'il. Le "Canvas" est alors bienvenu pour ce type d'utilisation.

Attention, un objet nouveau (ici le "Canvas") va venir se superposer tout ce qui a tprcdemment cr au mme emplacement dans le patch. Le "Canvas" est souvent utilis poursouligner une section particulire du patch, un objet, un commentaire etc. ou pour mettre enrelief quelque chose. Lorsque ces mises en relief arrivent aprs la cration de la section que nousvoulons pointer, le "Canvas" viendra recouvrir cette section. Dans ce cas, crez le "Canvas" endehors de la zone concerne du patch, puis slectionnez-le, coupez-le et collez la zone. De cettemanire, le "Canvas" viendra se placer en dessous de la section faire ressortir.

BANG! IMPULSIONS

Certaines actions peuvent tre dclenches en cliquant avec notre souris comme quand nouscliquons sur un lien Web ou sur le bouton "confirmer" d'un formulaire. Une action est alorseffectue immdiatement.

L'objet [bng] est un bouton qui met une impulsion quand nous cliquons dessus. Pour crer un[bng], vous pouvez choisir l'item "Bang" du menu "Put". On peut aussi appuyer sur Majuscule-Contrle-b.

Nous pouvons activer cet objet "Bang" en lui envoyant un message "Bang" dans son entre et encliquant sur ce message.

LES INTERRUPTEURS

Parfois, nous voulons activer ou dsactiver certaines fonctionnalits de notre patch et cela peutse faire au moyen d'un interrupteur.

58

L'objet [tgl] est un interrupteur deux positions. Il peut tre soit allum, soit teint. Au momento il change d'tat, il envoie un chiffre sa sortie. Par dfaut, il envoie "un" (1) lorsqu'il est allummais cette valeur peut tre change par l'intermdiaire de "Properties". Il envoie "zro" (0)lorsqu'il est teint. Vous pouvez crer un [tgl] en choisissant l'item "Toggle" du menu "Put". Onpeut aussi appuyer sur Majuscule-Contrle-t.

Nous pouvons allumer ou teindre un interrupteur en lui envoyant la valeur "un" (1) (ou uneautre) ou "zro" (0) par le biais d'un message "nombre".

LES GLISSIRES

Pour contrler le volume d'un son ou l'intensit d'un effet, il est trs facile de placer une glissiredans notre patch. Celle-ci expulse par sa sortie une suite de valeurs situes entre sa valeurminimale et sa valeur maximale. Ceci a lieu lorsqu'on dplace son curseur au moyen de la souris.Pour ce faire, cliquer sur le curseur, maintenir le bouton enfonc et dplacer la souris.

Nous pouvons crer une glissire horizontal [hsl] en choisissant l'item "Hslider" du menu "Put", ouen appuyant sur Majuscule-Contrle-h. Pour crer, une glissire vertical [vsl], vous pouvez choisirl'item "Vslider" du menu "Put" ou en appuyant sur Majuscule-Contrle-v.

Vous pouvez galement dplacer le curseur de la glissire en envoyant un nombre dans sonentre. Pour changer la position du curseur sans pour autant que la glissire n'envoie quoi que cesoit sa sortie, il faut lui envoyer le message [set 54< : ici "54" est la valeur que l'on souhaite luidonner. Choisir dans ses proprits "steady on click" ou "jump on click" lui dicte soit d'atteindrela valeur souhaite en dplaant sur le curseur de la glissire, soit d'atteindre cette valeur par unclic de souris l'endroit souhait du curseur pour le second cas.

Particularit : le message [range 34< va permettre de redfinir " la vole" l'intervalle desvaleurs des glissires. Dans ce cas d'exemple "34" va permettre de donner notre glissire unchamp de valeurs qui ira de 0 89. Si nous avons cre cette glissire sans diter ses valeurs pardfaut (de 0 127) notre glissire ne pourra plus envoyer que des valeurs allant de 0 34 aprsavoir t rinitialis par le message [range + (valeur choisie)

BOUTONS RADIO

Certains appareils radio ont des boutons servant slectionner directement des postes pr-dfinis. Dans Pure Data, ces slecteurs nombre fixe de choix sont constitus d'un groupe decarrs et un seul d'entre eux contient un carr noir plus petit. Nous crons un groupe horizontalde boutons radio [hradio] en choisissant l'item "Hradio" du menu "Put". De mme, le groupevertical se cre via l'item "Vradio". Leur fentre de proprits permet de choisir la couleur dufond et celle de leur premier plan. De mme par l'intermdiaire de la fentre de dialogue"Properties", nous allons pouvoir slectionner le nombre de boutons radio que nous souhaitonscrer pour le [hradio] ou [vradio].

60

LES TABLEAUX

L'on doit souvent grer de grandes listes de nombres, effectuer une seule et mme oprationsur tout un groupe de valeurs ou, encore, contenir les chantillons d'un son. En effet, un sonnumrique n'est qu'une srie de chiffres indiquant la position de la membrane d'un micro oud'une enceinte. Dans ce cas, nous aurons besoin de crer un tableau. Nous verronsultrieurement une manire plus prcise de les utiliser. Pour le moment, il s'agit de prsenterune manire gnrale de les crer et de configurer certaines de leur proprits les pluscourantes. Dans le menu "Put", slectionnez et placez "Array". Un clic droit de souris permetd'accder ses proprits ("Properties")

61

15. QUELQUES OBJETS UTILESPour crer des objets, il vous suffit d'crire du texte dans une boite objet vide. Le texte estorganis en deux parties toujours spares par un espace. Le premier mot dfinit le typed'objets et ceux qui suivent servent d'argument qui initialise l'objet pralablement dfini enfonction de sa ou ses valeurs. Les exemples d'objets qui suivent illustrent ce principe.

[METRO] MTRONOME

L'objet [metro] est un mtronome dont nous pouvons contrler le rythme. Il envoie un "bang"chaque x millime(s) de seconde. Nous spcifions sa longueur d'onde (= 1/frquence) enargument. Par exemple, [metro 50] envoie une impulsion toutes les 50 millisecondes soit 20impulsions par seconde.

Pour lancer le mtronome, nous envoyons un "bang" ou un message [1< dans l'entre de gauchedu mtronome. Pour modifier le rythme, l'argument est envoy dans son entre de droite. Cetteopration arrterait le mtronome s'il fonctionnait. L'envoi du message [0< dans l'entre degauche l'arrte gnralement, ou nous pouvons encore utiliser un [toggle] comme interrupteur.

[LOADBANG] INITIALISATION DE PARAMTRE

L'objet [loadbang] gnre un bang unique chaque dmarrage du patch, vers son unique sortie(outlet). Cela permet d'automatiser une action en envoyant un paramtre un objet lorsqu'il nepermet pas d'inscrire celui-ci en argument par exemple. L'objet [loadbang] ne possde pasd'argument, il se dclenche simplement une fois.

[TRIGGER] DCLENCHEMENT CONTRL

L'objet [trigger] est un objet trs utile pour contrler l'ordre des oprations que l'on doit faire.Celui-ci prend une valeur d'entre, convertit cette valeur en fonction des arguments et sort lesnouvelles valeurs dans les sorties, en commenant par sa sortie la plus droite et en terminantpar celle la plus gauche.

62

[FLOAT] NOMBRES RELS

L'objet [float] enregistre un nombre rel avec une virgule flottante. Il envoie ce nombre via sasortie quand une information lui est envoye par son entre gauche. Si un nombre lui arrive parson entre droite, ce nombre change sa valeur interne mais sans l'vacuer par sa sortie. Ilpermet donc de stocker de manire temporaire une valeur pour envoyer cette valeur parailleurs quand il y en a besoin. L'exemple ci-dessous prsente un compteur. Le rle d'uncompteur est... de compter ! Celui-ci commence zro soit la valeur par dfaut d'un [float] et ilaugmente de 1 chaque fois que nous cliquons sur le bouton "Bang".

[SYMBOL] CHAINES DE CARACTRE

L'objet [symbol] fonctionne de la mme manire que [float] pour des symboles (chanes decaractres).

[SPIGOT] INTERRUPTEUR DE FLUX

L'objet [spigot] permet de crer des interrupteurs qui bloquent ou laissent passer le message.

63

L'entre de droite ouvre le canal lorsqu'il reoit 1 et le ferme avec 0. L'exemple ci-dessus faitpasser alternativement les donnes droite ou gauche lorsqu'on clique sur le "Bang". (= [gate] enMaxMSP).

[LIST] TRAITEMENT DES LISTES

Dans Pure Data, les messages peuvent tre catgoriss en deux groupes :

les messages contenant des donnes directes ("bang", nombres, symboles, listes) qui sontla principale faon de communiquer ;les messages contenant "tout le reste" et qui peuvent, par exemple, servir changer desarguments de configuration des objets, lire et crire des fichier, quitter pure-data, etc.

Ces derniers messages existent de sorte que des objets complexes ne ncessitent pas un grandnombre d'entres et puissent tre configurs simplement.

L'objet [list] permet de travailler des messages comprenant plus d'un lment en les ajoutant, lessupprimant, les divisant dans la liste ou en extrayant le nombre d'lments.

[PRINT] AFFICHER DU TEXTE DANS LA CONSOLE

Cet objet imprime les messages qui lui sont envoys dans la fentre de la console et vouspermet ainsi de voir l'ordre et le contenu des messages qui lui parviennent : ceci est trs utilepour contrler le bon droulement des oprations. L'argument qui vient aprs "print" dans l'objetest une tiquette qui sera ajoute en dbut de ligne lors de l'impression des messages et ilpermet de diffrencier plusieurs messages imprims dans la fentre de la console.

[SELECT] COMPARAISON DE VALEUR

[select] permet de comparer l'entre d'une valeur dans l'objet une valeur ou un nombredonn de valeurs dfinis comme arguments. Si la valeur entre est gale l'une des valeursargumentes dans "Select", un "Bang" est mis dans la sortie correspondante. L'ordre des"Bangs" suit l'ordre des valeurs argumentes dans "Select". Les valeurs qui ne correspondent pas celles testes sortent non transformes dans la sortie de droite.

[select] peut prendre des symboles comme arguments. Le premier argument dtermine le typede donne qu'il attend (float ou symbol). Si [select] (qui peut tre abrvi en [sel]) est cr sansargument ou avec un seul argument, l'entre de droite de [select] sert fixer cet argument avecun "nombre" et ceci permet de modifier l'argument en intervenant par ailleurs dans le patch.

64

[ROUTE] AIGUILLAGE DE DONNES

Cet objet permet de slectionner le chemin emprunt par les messages en fonction du premier"atome" du message (c'est--dire la premire partie des messages qui sont des nombres). Lesarguments de "Route" dterminent le type des messages attendus et permettent de lescomparer aux entres.

Dans l'exemple ci-dessous, s'ils ne correspondent pas, ils sortent par la sortie de droite, sinon leschanes de caractres qui suivent les "atomes" dans les messages sont imprimes dans lafentre de la console grce [print].

[PACK] ET [UNPACK] TRAITEMENT DE LISTES DEMESSAGES

L'objet [pack] permet de rassembler des messages et [unpack] les spare.

65

16. MON PREMIER PATCHCOMMENT CONSTRUIRE UN PREMIER PATCH DE SYNTHSESONORE ALATOIRE ?

Nous allons dcrire ci-dessous pas pas la construction d'un patch qui permet d'mettre un sondont nous pourrons moduler le tempo avec un mtronome et modifier sa frquence de faonalatoire.

1. Lancez Pure Data.

2. Testez si l'audio fonctionne bien : Menu "Media" de l'interface principale puis cliquez sur "Testaudio and Midi".

3. Un patch s'ouvre, cliquez sous "TEST TONES" dans la case la plus haute du rectangle degauche, cot de "80", vous devriez entendre un son continu, le son fonctionne !

Si ce n'est pas le cas, rfrez-vous la partie "Configuration de l'audio et du midi" de ce manuel.

4. Vrifiez que le bouton "Compute Audio" est bien coch sans quoi Pure Data ne produira pas deson.

Attention : Si vous tes passs par l'tape "Test audio and Midi", le bouton "Compute Audio" estnormalement automatiquement coch

66

5. Pour crer un nouvel espace de travail ou patch, allez dans le menu de l'interface dans "File"et cliquez