AdaFruit Wave Shield Librairie AFwave - Historique des versions

Admin le 30 août 2013 à 20:23

2013-08-30T20:23:25Z

Admin : /* Avoir plus de RAM et de Flash! */

2012-03-14T20:01:29Z

Avoir plus de RAM et de Flash!

Admin : /* Volume adjust */

2012-03-14T20:00:34Z

Volume adjust

Admin : /* Saving & restoring the play position */

2012-03-14T19:51:11Z

Saving & restoring the play position

Admin : /* Changing sample rate */

2012-03-14T18:14:26Z

Changing sample rate

Admin : /* Closing the file */

2012-03-14T18:08:16Z

Closing the file

Admin : /* Playing the file */

2012-03-14T18:06:40Z

Playing the file

Admin : /* Opening a file for playing */

2012-03-14T12:20:16Z

Opening a file for playing

Admin : /* Looking for files */

2012-03-14T12:13:05Z

Looking for files

Admin : /* Initialize the card */

2012-03-14T12:06:03Z

Initialize the card

← Version précédente		Version du 30 août 2013 à 20:23
Ligne 165 :		Ligne 165 :
	[http://www.ladyada.net/make/waveshield/examples.html See here for more information].		[http://www.ladyada.net/make/waveshield/examples.html See here for more information].

−	{{~~ADF~~-~~Accord}}~~	+	{{WaveShield-TRAILER}}
−
−	~~{{MCH-Accord~~}}

@@ Ligne 3 : / Ligne 3 : @@
 == Avoir plus de RAM et de Flash! ==
 Note MCHobby:
-Les plateforme Arduino sont maintenant distribuée avec un ATmega328.
+Les plateformes Arduino sont maintenant distribuée avec un ATmega328.
 Cette section n'est vraiment pertinente que si vous ne possédez pas d'ATmega328.

@@ Ligne 149 : / Ligne 149 : @@
 == Volume adjust ==
-You can change the volume of the audio 'digitally' on the fly. Note that this doesn't change the volume control potentiometer, it actually just reduces the digital values going to the DAC. Thus the quality of the audio will be degraded. However, it may come in handy so it has been included. Since it slows down playback a bit, it is not enabled by default. To enable digital volume control, open up '''wave.cpp''' in the library folder and look for the line '''#define DVOLUME 0''' and change the 0 to a 1. Then delete all the files in the library folder that end with .o, this will force the software to recompile the library when the sketch is compiled.
+Vous pouvez ajuster le volume audio "digital" à la volée. Bien entendu, cela ne modifie pas la position du potentiomètre mais réduit les valeurs digitales envoyées au convertisseur DAC. Ainsi, la qualité audio sera dégradée. Cependant, cela pourrait paraître utile (raison pour laquelle il a été inclus).
-The volume is controlled by a variable in the Wavefile object. For example, if you have '''Wavefile wave''' at the top of your sketch, then you can set the volume by calling wave.volume = 4. The volume can be set from 0 to 12. A volume value of 0 is maximum, and 12 is silence. Anything higher than 12 will be the same as 12.
+Puisque cette fonctionnalité ralenti un peu la vitesse de lecture, celle option n'est pas disponible par défaut.
 [http://www.ladyada.net/make/waveshield/examples.html See here for more information].

@@ Ligne 139 : / Ligne 139 : @@
 [[AdaFruit Wave Shield Exemples|Voyez ici pour plus d'information.]]
-== Saving & restoring the play position ==
+== Sauver et restaurer une position ==
-If, say, you want to know where along in the wave file you are, that information is also available in '''wave.getSize()''' (the number of bytes in the entire wave) and wave.remainingBytesInChunk (how many bytes are left to play)
+Disons que si vous voulez savoir à quelle position vous vous trouvez dans le fichier musical, cette information est disponible par l'intermédiaire des fonctions  '''wave.getSize()''' (le nombre d'octets du fichier wave en entier) et '''wave.remainingBytesInChunk''' (le nombre d'octet qu'il reste à jouer)
-You can set the current place to play from using '''wave.seek()''', the Arduino will immediately start to fastforward to that location. For example, '''wave.seek(0)''' will take you to the beginning, '''wave.seek(wave.getSize()/2)''' will take you to the middle of the file.
+Vous pouvez vous déplacer dans le fichier joué en utilisant '''wave.seek()''', Arduino démarrera immédiatement une opération d'avance rapide (un saut) jusqu'à cette position.
 == Volume adjust ==

@@ Ligne 131 : / Ligne 131 : @@
 Vous pouvez fermer le fichier en appelant '''card.close_file(f)''' où f est le fichier créé à l'aide de l'instruction '''card.open_file(name)'''
-== Changing sample rate ==
+== Modifier le taux d'échantillonnage ==
-This is sort of strange, but may be useful if, say, you have a sine wave or sample that youd like to change the pitch of or if youd like to 'fast forward' through some music
+Cela peut paraître étrange, mais vraiment très utile si vous voulez, par exemple, modifier le timbre de la voix, faire une avance rapide durant le morceau, contrôler un signal sinusoïdal.
-The sample rate (i.g. 22kHz) is stored in '''wave.dwSamplesPerSec'''. It will be initially set to whatever the wave file is supposed to be. Simply assign a new sample rate to the variable to change it on the fly.
+Le taux d'échantillonnage (ex: 22kHz) est stocké dans la variable '''wave.dwSamplesPerSec'''. Cette valeur est initialisée avec la valeur d'échantillonnage du fichier wave (lorsqu'il est ouvert). Il suffit d'assigner une nouvelle valeur d'échantillonnage et le programme en tiendra compte immédiatement.
-[http://www.ladyada.net/make/waveshield/examples.html See here for more information.]
+[[AdaFruit Wave Shield Exemples|Voyez ici pour plus d'information.]]
 == Saving & restoring the play position ==

@@ Ligne 125 : / Ligne 125 : @@
 Vous pouvez interrompre le fichier audio en appelant '''wave.stop()'''
-== Closing the file ==
+== Fermer le fichier ==
-When you're done playing audio from a file, '''you must close it'''! You can close the file by calling '''card.close_file(f)''' where f is the file you created using '''card.open_file(name)'''
+Quand vous avez terminé de jouer le ficiher audio, '''vous devez le fermer'''!
 == Changing sample rate ==

@@ Ligne 117 : / Ligne 117 : @@
 </nowiki>
-== Playing the file ==
+== Jouer un fichier ==
-Finally we can play the file! Its quite easy, once the wavefile has been opened as above, simply call '''wave.play()''' to being playback. The Arduino plays audio in an interrupt, which means that '''wave.play()''' returns immediately. You can then mess with sensors, print feedback or buttons or whatever.
+Finalement, nous pouvons jouer le fichier! C'est vraiment simple une fois que le fichier wave a été ouvert comme ci-dessus. Il suffit d'appeler '''wave.play()''' pour commencer à jouer le morceau. Arduino jour le morceau en utilisant une interruption, ce qui signifie que '''wave.play()''' s'exécute immédiatement (et ne reste pas bloquée jusqu'à la fin du morceau). Vous pouvez donc utiliser des senseurs ou des boutons ou afficher un retour d'information ou détecter ou tout ce que vous voulez.
-While the wavefile is playing, you can check its status with the variable '''wave.isplaying''' . If the variable is 1 then the audio is playing. If its 0 that means it has finished playing
+Pendant que le fichier wave est joué, vous pouvez vérifier l'état de la variable '''wave.isplaying''' . La variable contient 1 pendant que le fichier Audio est joué, sinon elle contient 0 lorsque le fichier audio est terminé.
-You can stop playback by calling '''wave.stop()'''
+Vous pouvez interrompre le fichier audio en appelant '''wave.stop()'''
 == Closing the file ==

@@ Ligne 86 : / Ligne 86 : @@
 </nowiki>
-== Opening a file for playing ==
+== Ouverture d'un fichier pour reproduction Audio ==
-There are two steps to opening a file for playing. The first is to just open the file itself, then the file must be converted to a wavefile. That means the file is read and checked for a wavetable header. To open a file, you just need the name, you can pass in a string such as "MYSOUND.WAV" or read through the directory and use the name returned from '''get_next_name_in_dir()'''. Since long names arent supported (to keep the library smaller) you may want to use ls() function above to see what the 8.3 format name of the file is.
+Il y a deux étapes à faire pour ouvrir un fichier en vue d'une reproduction audio (pour le jouer).
   <nowiki>AF_Wave card;
@@ Ligne 99 : / Ligne 106 : @@
     f = card.open_file(name);
     if (!f) {
-       putstring_nl(" Couldn't open file"); return;
+       putstring_nl(" Echec ouverture fichier!"); return;
+    }
     if (!wave.create(f)) {
-      putstring_nl(" Not a valid WAV"); return;
+      putstring_nl(" WAV invalide!"); return;
+    }

@@ Ligne 60 : / Ligne 60 : @@
 Ce code va essayer d'initialiser la carte, ouvrir la table des partitions (partition table), ouvrir le système de fichier FAT16 (FAT16 filesystem) et finalement ouvrir le répertoire racine. S'il échoue, il imprime un message d'erreur.
-== Looking for files ==
+== Recherche des fichiers ==
-There isn't a lot of interface code for going through the root directory. Basically you can reset the directory (start over from beginning) and get the name of the next file. The files are not organized alphabetically but rather in the order that they were created on the card.
+Naviguer dans le répertoire principal à la recherche des fichiers ne réclame que peu de code.
-You'll need to make a character array 13 characters long to store the 8.3 + terminating 0 of the file. Here is an example of displaying the name of each file available. When done, it resets the directory.
+Vous avez besoin d'un tableau de caratère (character array) de 13 caractères pour stocker le nom du fichier (8 caract. + "." + 3 caract. + caractère Null 0).
   <nowiki>void ls() {
@@ Ligne 71 : / Ligne 74 : @@
    card.reset_dir();
-   putstring_nl("Files found:");
+   putstring_nl("Fichier trouvé:");
    while (1) {
      ret = card.get_next_name_in_dir(name);

@@ Ligne 29 : / Ligne 29 : @@
 [[AdaFruit Wave Shield WaveHC_dap|Nous avons également un article qui passe la librairie WaveHC en revue]]
-== Initialize the card ==
+== Initialiser la carte ==
-The first thing that must be done is initializing the SD card for reading. You should copy & paste this code from the examples since there's really only one way to do it.
+La première chose à faire est d'initialiser la carte SD en vue d'effectuer des lectures. Vous devriez copier et coller le code de l'exemple ci-dessous puisqu'il n'y a vraiment qu'une seule façon de le faire.
-Note that this here is a snippet, use the examples in the library for the 'full listing'
+Notez que ce code ne contient de qu'un fragment, utilisez les exemples dans le librairie pour une 'listing complet'
   <nowiki>AF_Wave card;
@@ Ligne 42 : / Ligne 42 : @@
    if (!card.init_card()) {
-     putstring_nl("Card init. failed!"); return;
+     putstring_nl("Init. Carte échec!"); return;
+   }
    if (!card.open_partition()) {
-     putstring_nl("No partition!"); return;
+     putstring_nl("Pas de partition!"); return;
+   }
    if (!card.open_filesys()) {
-     putstring_nl("Couldn't open filesys"); return;
+     putstring_nl("Echec Ouverture systeme fichier (filesys)"); return;
+   }
   if (!card.open_rootdir()) {
-     putstring_nl("Couldn't open dir"); return;
+     putstring_nl("Echec ouverture repertoir (open dir)"); return;
+   }
+}
@@ Ligne 58 : / Ligne 58 : @@
 </nowiki>
-This code will try to initialize the card, open the partition table, open the FAT16 filesystem and finally open the root directory. If it fails it will print out an error message.
+Ce code va essayer d'initialiser la carte, ouvrir la table des partitions (partition table), ouvrir le système de fichier FAT16 (FAT16 filesystem) et finalement ouvrir le répertoire racine. S'il échoue, il imprime un message d'erreur.
 == Looking for files ==