--- web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html 2006/12/29 20:06:14 1005 +++ web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html 2006/12/29 20:27:15 1006 @@ -145,7 +145,7 @@ LinuxSampler DevelopersC. Schoenebeck Internet-DraftInteressengemeinschaft Software Intended status: Standards TrackEngineering e. V. -Expires: June 30, 2007December 27, 2006 +Expires: July 2, 2007December 29, 2006


LinuxSampler Control Protocol
LSCP 1.2

@@ -173,7 +173,7 @@ The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html.

-This Internet-Draft will expire on June 30, 2007.

+This Internet-Draft will expire on July 2, 2007.

Copyright Notice

@@ -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 
+

6.6.5.  +Getting global volume attenuation

+ +

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 
+

6.6.6.  +Setting global volume attenuation

+ +

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 

6.7.  @@ -7197,6 +7289,9 @@

/ FX_SEND SP INFO SP sampler_channel SP fx_send_id

+

/ VOLUME + +

@@ -7227,6 +7322,9 @@

/ ECHO SP boolean

+

/ VOLUME SP volume_value + +