--- web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html 2006/12/27 16:23:46 1002 +++ web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html 2006/12/29 20:27:15 1006 @@ -145,7 +145,7 @@
-This Internet-Draft will expire on June 30, 2007.
+This Internet-Draft will expire on July 2, 2007.
@@ -352,6 +352,10 @@
Reset sampler
6.6.4.
General sampler informations
+ 6.6.5.
+Getting global volume attenuation
+ 6.6.6.
+Setting global volume attenuation
6.7.
MIDI Instrument Mapping
6.7.1.
@@ -5822,6 +5826,94 @@
The mentioned fields above don't have to be in particular order. Other fields might be added in future.
+TOC |
The client can ask for the current global sampler-wide volume + attenuation by sending the following command: +
++
++GET VOLUME +
+
+ +
+Possible Answers: +
++
++The sampler will always answer by returning the optional + dotted floating point coefficient, reflecting the current + global volume attenuation. + +
+
+ +
+Note: it is up to the respective sampler engine whether to obey + that global volume parameter or not, but in general all engines SHOULD + use this parameter. +
+TOC |
The client can alter the current global sampler-wide volume + attenuation by sending the following command: +
++
++SET VOLUME <volume> +
+
+ +
+Where <volume> should be replaced by the optional dotted + floating point value, reflecting the new global volume parameter. + This value might usually be in the range between 0.0 and 1.0, that + is for attenuating the overall volume. +
+Possible Answers: +
++
++"OK" - +
+++ + +on success +
+"WRN:<warning-code>:<warning-message>" - +
+++ + +if the global volume was set, but there are noteworthy + issue(s) related, providing an appropriate warning code and + warning message +
+"ERR:<error-code>:<error-message>" - +
+++ + +in case it failed, providing an appropriate error code and error message +
+
+ +
TOC |
/ FX_SEND SP INFO SP sampler_channel SP fx_send_id
+/ VOLUME + +
@@ -7227,6 +7322,9 @@
/ ECHO SP boolean
+/ VOLUME SP volume_value + +