Merge pull request #470 from processing/sound-updates

Update sound library reference categories/subcategories

Author: SableRaf

content/references/examples/sound/Amplitude_stop_/Amplitude_stop_0.pde

@@ -16,7 +16,6 @@ void mousePressed() {
   float rate = 3;
   float pos = 0.5;
   float amp = 0.5;
-  float add = 0;
-  file.set(rate, pos, amp, add);
+  file.set(rate, pos, amp);
 }
 

content/references/examples/sound/FFT_stop_/FFT_stop_0.pde

@@ -17,17 +17,21 @@
   "classFields": [],
   "description": "This is a volume analyzer. It calculates the root mean square of the\n amplitude of each audio block and returns that value.",
   "type": "class",
-  "constructors": ["Amplitude(parent)"],
+  "constructors": [
+    "Amplitude(parent)"
+  ],
   "related": [],
   "name": "Amplitude",
   "classanchor": "sound/Amplitude",
-  "category": "analysis",
-  "subcategory": "",
+  "category": "Analysis",
+  "subcategory": "Amplitude",
   "parameters": [
     {
       "name": "parent",
       "description": "typically use \"this\"",
-      "type": ["PApplet"]
+      "type": [
+        "PApplet"
+      ]
     }
   ]
 }

content/references/examples/sound/SoundFile_set_/SoundFile_set_0.pde

@@ -6,8 +6,8 @@
   "syntax": [".analyze()"],
   "returns": "float",
   "type": "method",
-  "category": "amplitude",
-  "subcategory": "",
+  "category": "Analysis",
+  "subcategory": "Amplitude",
   "classanchor": "Amplitude",
   "parameters": []
 }

content/references/translations/en/sound/Amplitude.json

@@ -6,8 +6,8 @@
   "syntax": [".input(input)"],
   "returns": "void",
   "type": "method",
-  "category": "amplitude",
-  "subcategory": "",
+  "category": "Analysis",
+  "subcategory": "Amplitude",
   "classanchor": "Amplitude",
   "parameters": [
     {

content/references/translations/en/sound/Amplitude_analyze_.json

@@ -1,43 +1,65 @@
 {
   "brief": "AudioIn lets you grab the audio input from your sound card.",
   "methods": [
+    {
+      "anchor": "AudioIn_amp_",
+      "name": "amp()",
+      "desc": "Change the amplitude/volume of this sound."
+    },
+    {
+      "anchor": "AudioIn_pan_",
+      "name": "pan()",
+      "desc": "Move the sound in a stereo panorama."
+    },
     {
       "anchor": "AudioIn_play_",
       "name": "play()",
       "desc": "Start capturing the input stream and route it to the audio output"
     },
+    {
+      "anchor": "AudioIn_set_",
+      "name": "set()",
+      "desc": "Set amplitude and pan position with one method."
+    },
     {
       "anchor": "AudioIn_start_",
       "name": "start()",
       "desc": "Start the input stream without routing it to the audio output."
     },
     {
-      "anchor": "AudioIn_set_",
-      "name": "set()",
-      "desc": "Sets amplitude, add and pan position with one method."
+      "anchor": "AudioIn_stop_",
+      "name": "stop()",
+      "desc": "Stop capturing sound from this audio input."
     }
   ],
   "csspath": "../../",
   "isLibrary": "true",
   "classFields": [],
   "description": "AudioIn lets you grab the audio input from your sound card.",
   "type": "class",
-  "constructors": ["AudioIn(parent)", "AudioIn(parent, in)"],
+  "constructors": [
+    "AudioIn(parent)",
+    "AudioIn(parent, in)"
+  ],
   "related": [],
   "name": "AudioIn",
   "classanchor": "sound/AudioIn",
   "category": "I/O",
-  "subcategory": "",
+  "subcategory": "AudioIn",
   "parameters": [
     {
       "name": "parent",
       "description": "typically use \"this\"",
-      "type": ["PApplet"]
+      "type": [
+        "PApplet"
+      ]
     },
     {
       "name": "in",
       "description": "input channel number (optional, default 0)",
-      "type": ["int"]
+      "type": [
+        "int"
+      ]
     }
   ]
 }

content/references/translations/en/sound/Amplitude_input_.json

@@ -1,8 +1,8 @@
 {
-  "brief": "Changes the amplitude/volume of the input stream.",
+  "brief": "Change the amplitude/volume of this sound.",
   "related": [],
   "name": "amp()",
-  "description": "Changes the amplitude/volume of the input stream. Allowed values are between 0.0 and 1.0.",
+  "description": "Change the amplitude/volume of this sound.",
   "syntax": [".amp(amp)"],
   "returns": "void",
   "type": "method",
@@ -12,7 +12,7 @@
   "parameters": [
     {
       "name": "amp",
-      "description": "the amplitude of the input stream as a value from 0.0 (complete silence) to 1.0 (full volume)",
+      "description": "A float value between 0.0 (complete silence) and 1.0 (full volume)\n            controlling the amplitude/volume of this sound.",
       "type": ["float"]
     }
   ]