From 6772831200d14c2436aea2d0c837f40dbf12156f Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sun, 26 Sep 2021 13:11:47 +0200 Subject: Prepare Web API section for Markdown conversion (#2464) * Remove summary classes and ids * Remove unecessary hidden * Remove useless span filled with useless attributes / ids * Remove useless font * Remove notranslate * Remove id in other elements than headings * Remove name attributes * Remove 
 for JS w/ language-js class

* Remove 
 for HTML w/ language-html class

* Remove 
 for other lang w/ language-* class

* Rm highlighted line in code samples

* fix links, internal, external, absolute URLs

* missing file from last commit

* Fix styles errors apart from table + some classes

* Fix notes and warnings (+ some other :x)

* fix typo during merge which broke a doc

* aand forgot a conflict

* fix remaining classes of errors except dls and images

* Fix dls

* Fix images (deki/mozillademos) and remaining style issues

* Remove script tag from svg file

* Remove script tag from svg fileS

* Compress SVG files for CI
---
 .../api/audiobuffersourcenode/buffer/index.html    |  6 +-
 .../api/audiobuffersourcenode/detune/index.html    |  4 +-
 files/fr/web/api/audiobuffersourcenode/index.html  | 96 +++++++++++-----------
 .../web/api/audiobuffersourcenode/loop/index.html  |  6 +-
 .../api/audiobuffersourcenode/loopend/index.html   |  4 +-
 .../api/audiobuffersourcenode/loopstart/index.html |  4 +-
 .../audiobuffersourcenode/playbackrate/index.html  | 10 +--
 .../web/api/audiobuffersourcenode/start/index.html |  2 +-
 8 files changed, 63 insertions(+), 69 deletions(-)

(limited to 'files/fr/web/api/audiobuffersourcenode')

diff --git a/files/fr/web/api/audiobuffersourcenode/buffer/index.html b/files/fr/web/api/audiobuffersourcenode/buffer/index.html
index 08181c687c..377e917158 100644
--- a/files/fr/web/api/audiobuffersourcenode/buffer/index.html
+++ b/files/fr/web/api/audiobuffersourcenode/buffer/index.html
@@ -5,9 +5,7 @@ translation_of: Web/API/AudioBufferSourceNode/buffer
 ---
 
{{ APIRef("Web Audio API") }}

 
-

 
La propriété buffer de l'interface {{ domxref("AudioBufferSourceNode") }} donne la possibilité de lire un son en utilisant un {{domxref("AudioBuffer")}} comme ressource audio.

-

 
 
Si la propriété buffer a la valeur NULL, elle définit un canal unique silencieux (chaque échantillon vaut 0).

 
@@ -23,10 +21,10 @@ translation_of: Web/API/AudioBufferSourceNode/buffer
 
Exemple

 
 

-
Note: pour un exemple complet, voir le code interprété, ou le code source.

+
Note : Pour un exemple complet, voir le code interprété, ou le code source.

 

 
-
var myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
+
var myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
 
 button.onclick = function() {
   // Remplit le buffer avec du bruit blanc;
diff --git a/files/fr/web/api/audiobuffersourcenode/detune/index.html b/files/fr/web/api/audiobuffersourcenode/detune/index.html
index 60fc6f0121..bb352ab774 100644
--- a/files/fr/web/api/audiobuffersourcenode/detune/index.html
+++ b/files/fr/web/api/audiobuffersourcenode/detune/index.html
@@ -16,7 +16,7 @@ translation_of: Web/API/AudioBufferSourceNode/detune
 
 
Syntaxe

 
-
var source = contexteAudio.createBufferSource();
+
var source = contexteAudio.createBufferSource();
 source.detune.value = 100; // valeur en cents

 
 

@@ -29,7 +29,7 @@ source.detune.value = 100; // valeur en cents

 
 
Exemple

 
-
var audioCtx = new AudioContext();
+
var audioCtx = new AudioContext();
 
 var nbChan = 2;
 var nbFrames = audioCtx.sampleRate * 2.0;
diff --git a/files/fr/web/api/audiobuffersourcenode/index.html b/files/fr/web/api/audiobuffersourcenode/index.html
index b689f99b77..ce90a90902 100644
--- a/files/fr/web/api/audiobuffersourcenode/index.html
+++ b/files/fr/web/api/audiobuffersourcenode/index.html
@@ -11,20 +11,18 @@ translation_of: Web/API/AudioBufferSourceNode
 ---
 
{{APIRef("Web Audio API")}}

 
-
L'interface AudioBufferSourceNode est un {{domxref("AudioScheduledSourceNode")}} qui représente une source audio constituée de données audio en mémoire, stockées dans un {{domxref ("AudioBuffer")}}. Elle est particulièrement utile pour lire des sons qui requierrent des conditions de lecture particulières, comme la synchronisation sur un certain rythme, et peuvent être stockés en mémoire. Si ce type de son doit être lu depuis le disque ou le réseau, il conviendra d'utiliser un {{domxref("AudioWorkletNode")}}. 

+
L'interface AudioBufferSourceNode est un {{domxref("AudioScheduledSourceNode")}} qui représente une source audio constituée de données audio en mémoire, stockées dans un {{domxref ("AudioBuffer")}}. Elle est particulièrement utile pour lire des sons qui requierrent des conditions de lecture particulières, comme la synchronisation sur un certain rythme, et peuvent être stockés en mémoire. Si ce type de son doit être lu depuis le disque ou le réseau, il conviendra d'utiliser un {{domxref("AudioWorkletNode")}}.

 
 
{{InheritanceDiagram}}

 
-
Un AudioBufferSourceNode n'a pas d'entrée et il comporte une unique sortie, dont le nombre de canaux est spécifié par la propriété {{domxref("AudioBufferSourceNode.buffer", "buffer")}}. Si aucun buffer n'est paramétré, c'est-à-dire si la valeur de l'attribut est NULL, la sortie contient un seul canal silencieux (chaque échantillon vaut 0).

+
Un AudioBufferSourceNode n'a pas d'entrée et il comporte une unique sortie, dont le nombre de canaux est spécifié par la propriété {{domxref("AudioBufferSourceNode.buffer", "buffer")}}. Si aucun buffer n'est paramétré, c'est-à-dire si la valeur de l'attribut est NULL, la sortie contient un seul canal silencieux (chaque échantillon vaut 0).

 
 


- Un {{domxref("AudioBufferSourceNode")}} ne peut être joué qu'une seule fois; autrement dit un seul appel à la fonction AudioBufferSourceNode.start() est autorisé. Pour rejouer le son, il faut créer un nouvel AudioBufferSourceNode. Heureusement ces noeuds ne demandent pas beaucoup de ressource, et les véritables AudioBuffers peuvent être réutilisés. On dit que les AudioBufferSourceNodes doivent être utilisés en mode "one shot": une fois que la lecture est lancée, toutes les références peuvent être supprimées, et elles seront collectées par le ramasse-miette automatiquement quand la lecture des sons sera terminée.

+ Un {{domxref("AudioBufferSourceNode")}} ne peut être joué qu'une seule fois; autrement dit un seul appel à la fonction AudioBufferSourceNode.start() est autorisé. Pour rejouer le son, il faut créer un nouvel AudioBufferSourceNode. Heureusement ces noeuds ne demandent pas beaucoup de ressource, et les véritables AudioBuffers peuvent être réutilisés. On dit que les AudioBufferSourceNodes doivent être utilisés en mode "one shot": une fois que la lecture est lancée, toutes les références peuvent être supprimées, et elles seront collectées par le ramasse-miette automatiquement quand la lecture des sons sera terminée.

 
 
Plusieurs appels à la fonction AudioBufferSourceNode.stop() sont autorisés. Le dernier appel remplace le précédent, à condition que le AudioBufferSourceNode n'ait pas déjà atteint la fin du buffer.

 
-
The AudioBufferSourceNode takes the content of an AudioBuffer and m

-
-
+
L'objet AudioBufferSourceNode prend le contenu d'un AudioBuffer et le convertit en audio

 
 
@@ -69,7 +67,7 @@ translation_of: Web/API/AudioBufferSourceNode
  
{{domxref ("AudioParam")}} de type a-rate qui définit le facteur de vitesse à laquelle la ressource audio sera jouée. Comme aucune correction de pitch n'est appliquée sur la sortie, il peut être utilisé pour modifier le pitch de l'échantillon.

 
-
Gestionnaires d'évènement

+
Gestionnaires d'évènement
Hérite des gestionnaires d'évènement de son parent, {{domxref("AudioScheduledSourceNode")}}.

 
@@ -82,52 +80,52 @@ translation_of: Web/API/AudioBufferSourceNode
 
Cet exemple crée un tampon de deux secondes, le remplit avec du bruit blanc et le joue par l'intermédiaire d'un AudioBufferSourceNode.

-
Note: Vous pouvez aussi exécuter the code, ou regarder le code source.

+
Note : Vous pouvez aussi exécuter the code, ou regarder le code source.

 

 
-
var contexteAudio = new (window.AudioContext || window.webkitAudioContext)();
-var bouton = document.querySelector('button');
-var pre = document.querySelector('pre');
-var monScript = document.querySelector('script');
-
-pre.innerHTML = monScript.innerHTML;
-
-// Stéréo
-var canaux = 2;
-
-// Crée un tampon vide de deux secondes
-// au taux d'échantillonnage du AudioContext
-var compteurTrames = contexteAudio.sampleRate * 2.0;
-
-var myArrayBuffer = contexteAudio.createBuffer(2, compteurTrames, contexteAudio.sampleRate);
-
-bouton.onclick = function() {
-  // remplit le tampon avec du bruit blanc;
-  // valeurs aléatoires entre -1.0 et 1.0
-  for (var canal = 0; canal < canaux; canal++) {
-   // crée le ArrayBuffer qui contient les données
-   var nowBuffering = myArrayBuffer.getChannelData(canal);
-   for (var i = 0; i < compteurTrames; i++) {
-     // Math.random() est compris entre [0; 1.0]
-     // audio doit être compris entre [-1.0; 1.0]
-     nowBuffering[i] = Math.random() * 2 - 1;
-   }
-  }
-
-  // crée AudioBufferSourceNode.
-  // c'est AudioNode utilisé pour lire un AudioBuffer
-  var source = contexteAudio.createBufferSource();
-  // initialise le tampon du AudioBufferSourceNode
-  source.buffer = myArrayBuffer;
-  // connecte l'AudioBufferSourceNode avec la destination
-  // de façon à ce qu'on puisse entendre le son
-  source.connect(contexteAudio.destination);
-  // lance la lecture de la source
-  source.start();
-}

+
var contexteAudio = new (window.AudioContext || window.webkitAudioContext)();
+var bouton = document.querySelector('button');
+var pre = document.querySelector('pre');
+var monScript = document.querySelector('script');
+
+pre.innerHTML = monScript.innerHTML;
+
+// Stéréo
+var canaux = 2;
+
+// Crée un tampon vide de deux secondes
+// au taux d'échantillonnage du AudioContext
+var compteurTrames = contexteAudio.sampleRate * 2.0;
+
+var myArrayBuffer = contexteAudio.createBuffer(2, compteurTrames, contexteAudio.sampleRate);
+
+bouton.onclick = function() {
+  // remplit le tampon avec du bruit blanc;
+  // valeurs aléatoires entre -1.0 et 1.0
+  for (var canal = 0; canal < canaux; canal++) {
+   // crée le ArrayBuffer qui contient les données
+   var nowBuffering = myArrayBuffer.getChannelData(canal);
+   for (var i = 0; i < compteurTrames; i++) {
+     // Math.random() est compris entre [0; 1.0]
+     // audio doit être compris entre [-1.0; 1.0]
+     nowBuffering[i] = Math.random() * 2 - 1;
+   }
+  }
+
+  // crée AudioBufferSourceNode.
+  // c'est AudioNode utilisé pour lire un AudioBuffer
+  var source = contexteAudio.createBufferSource();
+  // initialise le tampon du AudioBufferSourceNode
+  source.buffer = myArrayBuffer;
+  // connecte l'AudioBufferSourceNode avec la destination
+  // de façon à ce qu'on puisse entendre le son
+  source.connect(contexteAudio.destination);
+  // lance la lecture de la source
+  source.start();
+}

-
Note: Pour un exemple de decodeAudioData(), voir la page {{domxref("AudioContext.decodeAudioData")}}.

+
Note : Pour un exemple de decodeAudioData(), voir la page {{domxref("AudioContext.decodeAudioData")}}.

 
Spécifications

diff --git a/files/fr/web/api/audiobuffersourcenode/loop/index.html b/files/fr/web/api/audiobuffersourcenode/loop/index.html
index feac85d179..739e46de9c 100644
--- a/files/fr/web/api/audiobuffersourcenode/loop/index.html
+++ b/files/fr/web/api/audiobuffersourcenode/loop/index.html
@@ -19,7 +19,7 @@ translation_of: Web/API/AudioBufferSourceNode/loop
 
 
Syntaxe

 
-
var source = audioCtx.createBufferSource();
+
var source = audioCtx.createBufferSource();
 source.loop = true;
 

 
@@ -34,10 +34,10 @@ source.loop = true;
 
Dans cet exemple, la fonction {{domxref("AudioContext.decodeAudioData")}} est utilisée pour décoder une piste audio et la placer dans un {{domxref("AudioBufferSourceNode")}}. Les boutons mis à disposition permettent de lire et d'arrêter la lecture audio, et un slider est utilisé pour changer la valeur de playbackRate en temps réel. Quand la lecture est terminée, elle boucle.

 
 

-
Note: Vous pouvez essayer un exemple live (or voir la source.)

+
Note : Vous pouvez essayer un exemple live (or voir la source.)

 

 
-
function getData() {
+
function getData() {
   source = audioCtx.createBufferSource();
   request = new XMLHttpRequest();
 
diff --git a/files/fr/web/api/audiobuffersourcenode/loopend/index.html b/files/fr/web/api/audiobuffersourcenode/loopend/index.html
index fa1bde9140..c580e48ecb 100644
--- a/files/fr/web/api/audiobuffersourcenode/loopend/index.html
+++ b/files/fr/web/api/audiobuffersourcenode/loopend/index.html
@@ -16,7 +16,7 @@ translation_of: Web/API/AudioBufferSourceNode/loopEnd
 
 
Syntaxe

 
-
var source = contexteAudio.createBufferSource();
+
var source = contexteAudio.createBufferSource();
 source.loopEnd = 3;
 

 
@@ -31,7 +31,7 @@ source.loopEnd = 3;
 
Lorsque la lecture de la source audio est terminée, elle boucle. Il est possible de contrôler la durée de la boucle en modifiant loopStart et loopEnd. Par exemple, si leurs valeurs sont fixées à 20 et 25, respectivement, le son bouclera entre la 20ème et la 25ème secondes du morceau.

 
 

-
Note : Voir  l'exemple complet et son code source.

+
Note : Voir  l'exemple complet et son code source.

 

 
 
function getData() {
diff --git a/files/fr/web/api/audiobuffersourcenode/loopstart/index.html b/files/fr/web/api/audiobuffersourcenode/loopstart/index.html
index b155c78b81..11a5b2165e 100644
--- a/files/fr/web/api/audiobuffersourcenode/loopstart/index.html
+++ b/files/fr/web/api/audiobuffersourcenode/loopstart/index.html
@@ -8,7 +8,7 @@ translation_of: Web/API/AudioBufferSourceNode/loopStart
 
 
Syntaxe

 
-
var source = contexteAudio.createBufferSource();
+
var source = contexteAudio.createBufferSource();
 source.loopStart = 3;
 

 
@@ -23,7 +23,7 @@ source.loopStart = 3;
 
Lorsque la lecture de la source audio est terminée, elle boucle. Il est possible de contrôler la durée de la boucle en modifiant loopStart et loopEnd. Par exemple, si leurs valeurs sont fixées à 20 et 25, respectivement, le son bouclera entre la 20ème et la 25ème secondes du morceau.

 
 

-
Note: Voir  l'exemple complet et son code source.

+
Note : Voir  l'exemple complet et son code source.

 

 
 
function getData() {
diff --git a/files/fr/web/api/audiobuffersourcenode/playbackrate/index.html b/files/fr/web/api/audiobuffersourcenode/playbackrate/index.html
index e9c4047369..5f13016165 100644
--- a/files/fr/web/api/audiobuffersourcenode/playbackrate/index.html
+++ b/files/fr/web/api/audiobuffersourcenode/playbackrate/index.html
@@ -6,7 +6,7 @@ translation_of: Web/API/AudioBufferSourceNode/playbackRate
 
{{ APIRef("Web Audio API") }}

 
 

-
La propriété playbackRate de l'interface {{ domxref("AudioBufferSourceNode") }} est un {{domxref("AudioParam")}} de type k-rate qui définit la vitesse à laquelle le contenu audio sera lu.

+
La propriété playbackRate de l'interface {{ domxref("AudioBufferSourceNode") }} est un {{domxref("AudioParam")}} de type k-rate qui définit la vitesse à laquelle le contenu audio sera lu.

 

 
 
Une valeur de 1.0 (c'est ) indique que le son doit être lu à la vitesse de son taux d'échantillonnage, une valeur inférieure qu'il doit être lu plus lentement, et une valeur supérieure plus rapidement. la valeur par défaut est 1.0. Pour toute autre valeur l'AudioBufferSourceNode rééchantillone le son avant de l'envoyer vers la sortie.

@@ -17,10 +17,8 @@ translation_of: Web/API/AudioBufferSourceNode/playbackRate
 source.playbackRate.value = 1.25; // proportion : 25% plus rapide que la vitesse normale
 

 
-

 

-
Note: Bien que le AudioParam renvoyé soit en lecture seule, la valeur qu'il représente ne l'est pas.

-

+
Note : Bien que le AudioParam renvoyé soit en lecture seule, la valeur qu'il représente ne l'est pas.

 

 
 
Valeur

@@ -40,14 +38,14 @@ source.playbackRate.value = 1.25; // proportion : 25% plus rapide que la vitesse
 
Dans cet exemple, la fonction {{domxref("AudioContext.decodeAudioData")}} est utilisée pour décoder une piste audio et la mettre dans un {{domxref("AudioBufferSourceNode")}}. L'interface fournit deux boutons pour démarrer et arrêter la lecture, et des sliders pour modifier les propriétés playbackRate, loopStart et loopEnd à la volée.

 
 

-
Note: Voir  l'exemple complet et son code source.

+
Note : Voir  l'exemple complet et son code source.

 

 
 
<input class="playback-rate-control" type="range" min="0.25" max="3" step="0.05" value="1">
 <span class="playback-rate-value">1.0</span>
 

 
-
function getData() {
+
function getData() {
   source = contexteAudio.createBufferSource();
   requete = new XMLHttpRequest();
 
diff --git a/files/fr/web/api/audiobuffersourcenode/start/index.html b/files/fr/web/api/audiobuffersourcenode/start/index.html
index 99f3314c3c..b07993659d 100644
--- a/files/fr/web/api/audiobuffersourcenode/start/index.html
+++ b/files/fr/web/api/audiobuffersourcenode/start/index.html
@@ -51,7 +51,7 @@ translation_of: Web/API/AudioBufferSourceNode/start
 
source.start(contexteAudio.currentTime + 1,3,10);

 
 

-
Note: Pour un exemple plus complexe montrant la méthode start() en action, consulter l'exemple {{domxref("AudioContext.decodeAudioData")}}. Voir aussi  l'exemple complet et son code source.

+
Note : Pour un exemple plus complexe montrant la méthode start() en action, consulter l'exemple {{domxref("AudioContext.decodeAudioData")}}. Voir aussi  l'exemple complet et son code source.

 

 
 

-- 
cgit v1.2.3-54-g00ecf