/[svn]/jlscp/trunk/src/org/linuxsampler/lscp/Client.java

Diff of /jlscp/trunk/src/org/linuxsampler/lscp/Client.java

Parent Directory | Revision Log | View Patch Patch

-revision 1421 by iliev,
Sun Oct 14 18:08:45 2007 UTC
+revision 2242 by iliev,
Wed Aug 17 09:06:46 2011 UTC
 Line 1
  /*
   *   jlscp - a java LinuxSampler control protocol API
   *
-  *   Copyright (C) 2005-2007 Grigor Iliev <grigor@grigoriliev.com>
+  *   Copyright (C) 2005-2011 Grigor Iliev <grigor@grigoriliev.com>
   *
   *   This file is part of jlscp.
   *
 Line 28 
 import java.io.OutputStream;
  import java.net.InetSocketAddress;
  import java.net.Socket;
  import java.net.SocketTimeoutException;
- import java.net.UnknownHostException;
+ import java.util.ArrayList;
+ import java.util.TreeMap;
  import java.util.Vector;
  import java.util.logging.Level;
  import java.util.logging.Logger;
-Line 41 
 import static org.linuxsampler.lscp.Pars
+Line 42 
 import static org.linuxsampler.lscp.Pars
  /**
   * This class is the abstraction representing a client endpoint for communication with LinuxSampler
-  * instance. Since it implements all commands specified in the LSCP protocol v1.1, for more
+  * instance. Since it implements all commands specified in the LSCP protocol v1.5, for more
   * information look at the
-  * <a href=http://www.linuxsampler.org/api/lscp-1.1.html>LSCP</a> specification.
+  * <a href=http://www.linuxsampler.org/api/lscp-1.5.html>LSCP</a> specification.
   *
   * <p> The following code establishes connection to LinuxSampler instance and gets the
   * LinuxSampler version:
-Line 78 
 public class Client {
+Line 79 
 public class Client {
          private EventThread eventThread;
          private boolean printOnlyMode = false;
+         public enum ResultSetType {
+                 EMPTY, SINGLE_LINE, MULTI_LINE
+         }
+         private static class ResultSetEntry {
+                 public ResultSetType type;
+                 public
+                 ResultSetEntry(ResultSetType type) {
+                         this.type = type;
+                 }
+         }
+         private Vector<ResultSetEntry> resultSetQueue = new Vector<ResultSetEntry>();
+         /* Used for caching the engines' info */
+         private final TreeMap<String, SamplerEngine> engineMap = new TreeMap<String, SamplerEngine>();
          class EventThread extends Thread {
                  private Vector<String> queue = new Vector<String>();
-Line 85 
 public class Client {
+Line 104 
 public class Client {
                  EventThread() { super("LSCP-Event-Thread"); }
+                 @Override
                  public void
                  run() {
                          while(!mustTerminate()) {
-Line 164 
 public class Client {
+Line 184 
 public class Client {
                  if(printOnlyMode) setPrintOnlyMode(true);
          }
+         private boolean extendedCharacterEscaping = true;
+         /**
+          * Sets whether strings sent to LinuxSampler should be more aggressively escaped.
+          */
+         public synchronized void
+         setExtendedCharacterEscaping(boolean b) { extendedCharacterEscaping = b; }
+         /**
+          * Determines whether strings sent to LinuxSampler should be more aggressively escaped.
+          */
+         public synchronized boolean
+         getExtendedCharacterEscaping() { return extendedCharacterEscaping; }
+         /**
+          * @see java.net.Socket#setSoTimeout
+          */
+         public synchronized void
+         setSoTimeout(int timeout) {
+                 soTimeout = timeout;
+                 try { if(sock != null) sock.setSoTimeout(timeout); }
+                 catch(Exception x) { getLogger().log(Level.INFO, "Unable to set timeout", x); }
+         }
+         private String
+         toEscapedText(String s) {
+                 s = toEscapedString(s);
+                 return conv(s);
+         }
+         private String
+         toEscapedFsEntry(String s) {
+                 s = toEscapedFileName(s);
+                 return conv(s);
+         }
+         /**
+          * Applies an extended character escaping to the specified string if needed.
+          */
+         private String
+         conv(String s) {
+                 return getExtendedCharacterEscaping() ? toExtendedEscapeSequence(s) : s;
+         }
          /**
           * Determines whether the client is in print-only mode.
           * Print-only mode means that the client will just print all
-Line 262 
 public class Client {
+Line 327 
 public class Client {
                  if(sock != null) disconnect();
                  if(getPrintOnlyMode()) return;
+                 engineMap.clear();
                  // Initializing LSCP event thread
                  if(eventThread.isAlive()) {
                          getLogger().warning("LSCP event thread already running!");
-Line 344 
 public class Client {
+Line 411 
 public class Client {
                  if(!llFSI.isEmpty()) subscribe("FX_SEND_INFO");
                  if(!llSC.isEmpty()) subscribe("STREAM_COUNT");
                  if(!llVC.isEmpty()) subscribe("VOICE_COUNT");
+                 if(!llTSC.isEmpty()) subscribe("TOTAL_STREAM_COUNT");
                  if(!llTVC.isEmpty()) subscribe("TOTAL_VOICE_COUNT");
                  if(!llMIMC.isEmpty()) subscribe("MIDI_INSTRUMENT_MAP_COUNT");
                  if(!llMIMI.isEmpty()) subscribe("MIDI_INSTRUMENT_MAP_INFO");
                  if(!llMIC.isEmpty()) subscribe("MIDI_INSTRUMENT_COUNT");
                  if(!llMII.isEmpty()) subscribe("MIDI_INSTRUMENT_INFO");
+                 if(!llDMD.isEmpty()) subscribe("DEVICE_MIDI");
+                 if(!llCMD.isEmpty()) subscribe("CHANNEL_MIDI");
                  if(!llID.isEmpty()) {
                          subscribe("DB_INSTRUMENT_DIRECTORY_COUNT");
                          subscribe("DB_INSTRUMENT_DIRECTORY_INFO");
                          subscribe("DB_INSTRUMENT_COUNT");
                          subscribe("DB_INSTRUMENT_INFO");
+                         subscribe("DB_INSTRUMENTS_JOB_INFO");
                  }
                  if(!llGI.isEmpty()) subscribe("GLOBAL_INFO");
+                 if(!llEIC.isEmpty()) subscribe("EFFECT_INSTANCE_COUNT");
+                 if(!llEII.isEmpty()) subscribe("EFFECT_INSTANCE_INFO");
+                 if(!llSECC.isEmpty()) subscribe("SEND_EFFECT_CHAIN_COUNT");
+                 if(!llSECI.isEmpty()) subscribe("SEND_EFFECT_CHAIN_INFO");
          }
          /**
-Line 372 
 public class Client {
+Line 447 
 public class Client {
                          eventThread.terminate();
                          eventThread = new EventThread();
                  }
+                 engineMap.clear();
          }
          /**
-Line 419 
 public class Client {
+Line 496 
 public class Client {
                          else getLogger().severe("Unknown notification format: " + s);
                  }
          }
+         private synchronized void
+         processResultSetQueue() {
+                 for(int i = 0; i < resultSetQueue.size(); i++) {
+                         try {
+                                 switch(resultSetQueue.get(i).type) {
+                                         case EMPTY:
+                                                 getEmptyResultSet();
+                                                 break;
+                                         case SINGLE_LINE:
+                                                 getSingleLineResultSet();
+                                                 break;
+                                         case MULTI_LINE:
+                                                 getMultiLineResultSet();
+                                                 break;
+                                         default:
+                                                 getLogger().severe("Unknown result set type");
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.FINE, "Error while processing result set queue", x);
+                         }
+                 }
+                 resultSetQueue.removeAllElements();
+         }
          /**
           * Gets empty result set.
           * @return <code>ResultSet</code> instance.
           */
          private ResultSet
          getEmptyResultSet() throws IOException, LscpException, LSException {
+                 processResultSetQueue();
                  return parseEmptyResultSet(getLine());
          }
          private ResultSet
          getSingleLineResultSet() throws IOException, LscpException, LSException {
+                 processResultSetQueue();
                  ResultSet rs = new ResultSet();
                  String ln = getLine();
-Line 449 
 public class Client {
+Line 553 
 public class Client {
          private ResultSet
          getMultiLineResultSet() throws IOException, LscpException, LSException {
+                 processResultSetQueue();
                  ResultSet rs = new ResultSet();
                  String ln = getLine();
-Line 485 
 public class Client {
+Line 590 
 public class Client {
          private final Vector<ItemInfoListener> llMIDI = new Vector<ItemInfoListener>();
          private final Vector<StreamCountListener> llSC = new Vector<StreamCountListener>();
          private final Vector<VoiceCountListener> llVC = new Vector<VoiceCountListener>();
+         private final Vector<TotalStreamCountListener> llTSC = new Vector<TotalStreamCountListener>();
          private final Vector<TotalVoiceCountListener> llTVC = new Vector<TotalVoiceCountListener>();
          /** MIDI instrument map count listeners */
-Line 497 
 public class Client {
+Line 603 
 public class Client {
          /** MIDI instrument info listeners */
          private final Vector<MidiInstrumentInfoListener> llMII =
                  new Vector<MidiInstrumentInfoListener>();
+         private final Vector<DeviceMidiDataListener> llDMD = new Vector<DeviceMidiDataListener>();
+         private final Vector<ChannelMidiDataListener> llCMD = new Vector<ChannelMidiDataListener>();
          private final Vector<InstrumentsDbListener> llID = new Vector<InstrumentsDbListener>();
          private final Vector<GlobalInfoListener> llGI = new Vector<GlobalInfoListener>();
+         private final ArrayList<EffectInstanceCountListener> llEIC = new ArrayList<EffectInstanceCountListener>();
+         private final Vector<EffectInstanceInfoListener> llEII = new Vector<EffectInstanceInfoListener>();
+         private final Vector<SendEffectChainCountListener> llSECC = new Vector<SendEffectChainCountListener>();
+         private final Vector<SendEffectChainInfoListener> llSECI = new Vector<SendEffectChainInfoListener>();
          /**
-Line 522 
 public class Client {
+Line 634 
 public class Client {
                          !llMIDI.isEmpty() ||
                          !llSC.isEmpty()   ||
                          !llVC.isEmpty()   ||
+                         !llTSC.isEmpty()  ||
                          !llTVC.isEmpty()  ||
                          !llMIMC.isEmpty() ||
                          !llMIMI.isEmpty() ||
                          !llMIC.isEmpty()  ||
                          !llMII.isEmpty()  ||
+                         !llDMD.isEmpty()  ||
+                         !llCMD.isEmpty()  ||
                          !llID.isEmpty()   ||
-                         !llGI.isEmpty();
+                         !llGI.isEmpty()   ||
+                         !llEIC.isEmpty()  ||
+                         !llEII.isEmpty()  ||
+                         !llSECC.isEmpty() ||
+                         !llSECI.isEmpty();
+         }
+         private synchronized void
+         fireDeviceMidiDataEvent(String s) {
+                 try {
+                         String[] list = parseList(s, ' ');
+                         if(list.length != 5) {
+                                 getLogger().warning("Unknown DEVICE_MIDI format");
+                                 return;
+                         }
+                         int dev = parseInt(list[0]);
+                         int port = parseInt(list[1]);
+                         MidiDataEvent.Type type = parseMidiDataType(list[2]);
+                         if(type == null) return;
+                         int note = parseInt(list[3]);
+                         int velocity = parseInt(list[4]);
+                         DeviceMidiDataEvent e = new DeviceMidiDataEvent(this, type, note, velocity);
+                         e.setDeviceId(dev);
+                         e.setPortId(port);
+                         for(DeviceMidiDataListener l : llDMD) l.midiDataArrived(e);
+                 } catch(LscpException x) {
+                         getLogger().log (
+                                 Level.WARNING, LscpI18n.getLogMsg("CommandFailed!"), x
+                         );
+                 }
+         }
+         private synchronized void
+         fireChannelMidiDataEvent(String s) {
+                 try {
+                         String[] list = parseList(s, ' ');
+                         if(list.length != 4) {
+                                 getLogger().warning("Unknown CHANNEL_MIDI format");
+                                 return;
+                         }
+                         int channel = parseInt(list[0]);
+                         MidiDataEvent.Type type = parseMidiDataType(list[1]);
+                         if(type == null) return;
+                         int note = parseInt(list[2]);
+                         int velocity = parseInt(list[3]);
+                         ChannelMidiDataEvent e = new ChannelMidiDataEvent(this, type, note, velocity);
+                         e.setChannelId(channel);
+                         for(ChannelMidiDataListener l : llCMD) l.midiDataArrived(e);
+                 } catch(LscpException x) {
+                         getLogger().log (
+                                 Level.WARNING, LscpI18n.getLogMsg("CommandFailed!"), x
+                         );
+                 }
+         }
+         private MidiDataEvent.Type
+         parseMidiDataType(String s) {
+                 if("NOTE_ON".equals(s)) return MidiDataEvent.Type.NOTE_ON;
+                 if("NOTE_OFF".equals(s)) return MidiDataEvent.Type.NOTE_OFF;
+                 if("CC".equals(s)) return MidiDataEvent.Type.CC;
+                 getLogger().warning("Unknown MIDI data type: " + s);
+                 return null;
          }
          private synchronized void
          fireEvent(String s) {
-                  if(s.startsWith("DB_INSTRUMENT_DIRECTORY_COUNT:")) {
+                 // Sort by priority
+                  if(s.startsWith("CHANNEL_MIDI:")) {
+                         s = s.substring("CHANNEL_MIDI:".length());
+                         fireChannelMidiDataEvent(s);
+                 } else if(s.startsWith("DEVICE_MIDI:")) {
+                         s = s.substring("DEVICE_MIDI:".length());
+                         fireDeviceMidiDataEvent(s);
+                 } else if(s.startsWith("DB_INSTRUMENT_DIRECTORY_COUNT:")) {
                          s = s.substring("DB_INSTRUMENT_DIRECTORY_COUNT:".length());
                          InstrumentsDbEvent e = new InstrumentsDbEvent(this, s);
                          for(InstrumentsDbListener l : llID) l.directoryCountChanged(e);
-Line 662 
 public class Client {
+Line 855 
 public class Client {
                          } catch(NumberFormatException x) {
                                  getLogger().log(Level.WARNING, "Unknown CHANNEL_INFO format", x);
                          }
+                 } else if(s.startsWith("TOTAL_STREAM_COUNT:")) {
+                         try {
+                                 s = s.substring("TOTAL_STREAM_COUNT:".length());
+                                 int i = Integer.parseInt(s);
+                                 TotalStreamCountEvent e = new TotalStreamCountEvent(this, i);
+                                 for(TotalStreamCountListener l : llTSC) l.totalStreamCountChanged(e);
+                         } catch(NumberFormatException x) {
+                                 getLogger().log (
+                                         Level.WARNING, "Unknown TOTAL_STREAM_COUNT format", x
+                                 );
+                         }
                  } else if(s.startsWith("TOTAL_VOICE_COUNT:")) {
                          try {
                                  s = s.substring("TOTAL_VOICE_COUNT:".length());
-Line 809 
 public class Client {
+Line 1013 
 public class Client {
                          } catch(Exception x) {
                                  getLogger().log(Level.WARNING, "Unknown FX_SEND_INFO format", x);
                          }
+                 } else if(s.startsWith("EFFECT_INSTANCE_COUNT:")) {
+                         try {
+                                 s = s.substring("EFFECT_INSTANCE_COUNT:".length());
+                                 int i = Integer.parseInt(s);
+                                 EffectInstanceCountEvent e = new EffectInstanceCountEvent(this, i);
+                                 for(EffectInstanceCountListener l : llEIC) {
+                                         l.effectInstanceCountChanged(e);
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.WARNING, "Unknown EFFECT_INSTANCE_COUNT format", x);
+                         }
+                 } else if(s.startsWith("EFFECT_INSTANCE_INFO:")) {
+                         try {
+                                 s = s.substring("EFFECT_INSTANCE_INFO:".length());
+                                 int i = Integer.parseInt(s);
+                                 EffectInstanceInfoEvent e = new EffectInstanceInfoEvent(this, i);
+                                 for(EffectInstanceInfoListener l : llEII) {
+                                         l.effectInstanceInfoChanged(e);
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.WARNING, "Unknown EFFECT_INSTANCE_INFO format", x);
+                         }
+                 } else if(s.startsWith("SEND_EFFECT_CHAIN_COUNT:")) {
+                         try {
+                                 s = s.substring("SEND_EFFECT_CHAIN_COUNT:".length());
+                                 Integer[] i = parseIntList(s, ' ');
+                                 if(i.length != 2) {
+                                         getLogger().warning("Unknown SEND_EFFECT_CHAIN_COUNT format");
+                                         return;
+                                 }
+                                 SendEffectChainCountEvent e =
+                                         new SendEffectChainCountEvent(this, i[0], i[1]);
+                                 for(SendEffectChainCountListener l : llSECC) {
+                                         l.sendEffectChainCountChanged(e);
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.WARNING, "Unknown SEND_EFFECT_CHAIN_COUNT format", x);
+                         }
+                 } else if(s.startsWith("SEND_EFFECT_CHAIN_INFO:")) {
+                         try {
+                                 s = s.substring("SEND_EFFECT_CHAIN_INFO:".length());
+                                 Integer[] i = parseIntList(s, ' ');
+                                 if(i.length != 3) {
+                                         getLogger().warning("Unknown SEND_EFFECT_CHAIN_INFO format");
+                                         return;
+                                 }
+                                 SendEffectChainInfoEvent e =
+                                         new SendEffectChainInfoEvent(this, i[0], i[1], i[2]);
+                                 for(SendEffectChainInfoListener l : llSECI) {
+                                         l.sendEffectChainInfoChanged(e);
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.WARNING, "Unknown SEND_EFFECT_CHAIN_INFO format", x);
+                         }
                  } else if(s.startsWith("GLOBAL_INFO:")) {
                          handleGlobalInfoEvent(s.substring("GLOBAL_INFO:".length()));
                  } else if(s.startsWith("MISCELLANEOUS:")) {
-Line 825 
 public class Client {
+Line 1089 
 public class Client {
                                  float f = Float.parseFloat(s.substring("VOLUME ".length()));
                                  GlobalInfoEvent e = new GlobalInfoEvent(this, f);
                                  for(GlobalInfoListener l : llGI) l.volumeChanged(e);
+                         } else if(s.startsWith("VOICES ")) {
+                                 int i = Integer.parseInt(s.substring("VOICES ".length()));
+                                 GlobalInfoEvent e = new GlobalInfoEvent(this, i, -1);
+                                 for(GlobalInfoListener l : llGI) l.voiceLimitChanged(e);
+                         } else if(s.startsWith("STREAMS ")) {
+                                 int i = Integer.parseInt(s.substring("STREAMS ".length()));
+                                 GlobalInfoEvent e = new GlobalInfoEvent(this, -1, i);
+                                 for(GlobalInfoListener l : llGI) l.streamLimitChanged(e);
+                         } else {
+                                 getLogger().info("Unknown GLOBAL_INFO format: " + s);
                          }
                  } catch(NumberFormatException x) {
                          getLogger().log(Level.WARNING, "Unknown GLOBAL_INFO format", x);
-Line 1134 
 public class Client {
+Line 1408 
 public class Client {
          /**
           * Registers the specified listener for receiving event messages.
           * Listeners can be registered regardless of the connection state.
+          * @param l The <code>TotalStreamCountListener</code> to register.
+          */
+         public synchronized void
+         addTotalStreamCountListener(TotalStreamCountListener l) {
+                 if(llTSC.isEmpty()) subscribe("TOTAL_STREAM_COUNT");
+                 llTSC.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>TotalStreamCountListener</code> to remove.
+          */
+         public synchronized void
+         removeTotalStreamCountListener(TotalStreamCountListener l) {
+                 boolean b = llTSC.remove(l);
+                 if(b && llTSC.isEmpty()) unsubscribe("TOTAL_STREAM_COUNT");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
           * @param l The <code>TotalVoiceCountListener</code> to register.
           */
          public synchronized void
-Line 1244 
 public class Client {
+Line 1540 
 public class Client {
          /**
           * Registers the specified listener for receiving event messages.
           * Listeners can be registered regardless of the connection state.
+          * @param l The <code>DeviceMidiDataListener</code> to register.
+          */
+         public synchronized void
+         addDeviceMidiDataListener(DeviceMidiDataListener l) {
+                 if(llDMD.isEmpty()) subscribe("DEVICE_MIDI");
+                 llDMD.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>DeviceMidiDataListener</code> to remove.
+          */
+         public synchronized void
+         removeDeviceMidiDataListener(DeviceMidiDataListener l) {
+                 boolean b = llDMD.remove(l);
+                 if(b && llDMD.isEmpty()) unsubscribe("DEVICE_MIDI");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>ChannelMidiDataListener</code> to register.
+          */
+         public synchronized void
+         addChannelMidiDataListener(ChannelMidiDataListener l) {
+                 if(llCMD.isEmpty()) subscribe("CHANNEL_MIDI");
+                 llCMD.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>ChannelMidiDataListener</code> to remove.
+          */
+         public synchronized void
+         removeChannelMidiDataListener(ChannelMidiDataListener l) {
+                 boolean b = llCMD.remove(l);
+                 if(b && llCMD.isEmpty()) unsubscribe("CHANNEL_MIDI");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
           * @param l The <code>InstrumentsDbListener</code> to register.
           */
          public synchronized void
-Line 1298 
 public class Client {
+Line 1638 
 public class Client {
          }
          /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>EffectInstanceCountListener</code> to register.
+          */
+         public synchronized void
+         addEffectInstanceCountListener(EffectInstanceCountListener l) {
+                 if(llEIC.isEmpty()) subscribe("EFFECT_INSTANCE_COUNT");
+                 llEIC.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>EffectInstanceCountListener</code> to remove.
+          */
+         public synchronized void
+         removeEffectInstanceCountListener(EffectInstanceCountListener l) {
+                 boolean b = llEIC.remove(l);
+                 if(b && llEIC.isEmpty()) unsubscribe("EFFECT_INSTANCE_COUNT");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>EffectInstanceInfoListener</code> to register.
+          */
+         public synchronized void
+         addEffectInstanceInfoListener(EffectInstanceInfoListener l) {
+                 if(llEII.isEmpty()) subscribe("EFFECT_INSTANCE_INFO");
+                 llEII.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>EffectInstanceInfoListener</code> to remove.
+          */
+         public synchronized void
+         removeEffectInstanceInfoListener(EffectInstanceInfoListener l) {
+                 boolean b = llEII.remove(l);
+                 if(b && llEII.isEmpty()) unsubscribe("EFFECT_INSTANCE_INFO");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>SendEffectChainCountListener</code> to register.
+          */
+         public synchronized void
+         addSendEffectChainCountListener(SendEffectChainCountListener l) {
+                 if(llSECC.isEmpty()) subscribe("SEND_EFFECT_CHAIN_COUNT");
+                 llSECC.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>SendEffectChainCountListener</code> to remove.
+          */
+         public synchronized void
+         removeSendEffectChainCountListener(SendEffectChainCountListener l) {
+                 boolean b = llSECC.remove(l);
+                 if(b && llSECC.isEmpty()) unsubscribe("SEND_EFFECT_CHAIN_COUNT");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>SendEffectChainInfoListener</code> to register.
+          */
+         public synchronized void
+         addSendEffectChainInfoListener(SendEffectChainInfoListener l) {
+                 if(llSECI.isEmpty()) subscribe("SEND_EFFECT_CHAIN_INFO");
+                 llSECI.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>SendEffectChainInfoListener</code> to remove.
+          */
+         public synchronized void
+         removeSendEffectChainInfoListener(SendEffectChainInfoListener l) {
+                 boolean b = llSECI.remove(l);
+                 if(b && llSECI.isEmpty()) unsubscribe("SEND_EFFECT_CHAIN_INFO");
+         }
+         /**
           * Gets the number of all audio output drivers currently
           * available for the LinuxSampler instance.
           * @return The number of all audio output drivers currently
-          * available for the LinuxSampler instance.
+          * available for the LinuxSampler instance or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getAudioOutputDriverCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET AVAILABLE_AUDIO_OUTPUT_DRIVERS");
-                 out.writeLine("GET AVAILABLE_AUDIO_OUTPUT_DRIVERS");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 1373 
 public class Client {
+Line 1795 
 public class Client {
          public synchronized AudioOutputDriver
          getAudioOutputDriverInfo(String driverName, Parameter... depList)
                                          throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 AudioOutputDriver aod = new AudioOutputDriver();
-                 out.writeLine("GET AUDIO_OUTPUT_DRIVER INFO " + driverName);
+                 if(!retrieveInfo("GET AUDIO_OUTPUT_DRIVER INFO " + driverName, aod)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 AudioOutputDriver aod = new AudioOutputDriver(rs.getMultiLineResult());
                  aod.setName(driverName);
                  for(String s : aod.getParameterNames())
-Line 1418 
 public class Client {
+Line 1836 
 public class Client {
                  args.append(' ').append(param);
                  for(Parameter p : deplist) {
-                         if(p.getValue() == null) continue;
+                         if(p == null || p.getName() == null || p.getValue() == null) continue;
                          args.append(' ').append(p.getName()).append('=').append(p.getStringValue());
                  }
-Line 1478 
 public class Client {
+Line 1896 
 public class Client {
          createAudioOutputDevice(String aoDriver, Parameter... paramList)
                                          throws IOException, LSException, LscpException {
-                 verifyConnection();
                  StringBuffer args = new StringBuffer(aoDriver);
                  for(Parameter p : paramList) {
-                         if(p.getValue() == null) continue;
+                         if(p == null || p.getName() == null || p.getValue() == null) continue;
                          args.append(' ').append(p.getName()).append('=').append(p.getStringValue());
                  }
-                 out.writeLine("CREATE AUDIO_OUTPUT_DEVICE " + args.toString());
+                 return retrieveIndex("CREATE AUDIO_OUTPUT_DEVICE " + args.toString());
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 1504 
 public class Client {
+Line 1916 
 public class Client {
           */
          public synchronized void
          destroyAudioOutputDevice(int deviceId) throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 retrieveIndex("DESTROY AUDIO_OUTPUT_DEVICE " + deviceId);
-                 out.writeLine("DESTROY AUDIO_OUTPUT_DEVICE " + deviceId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 1530 
 public class Client {
+Line 1938 
 public class Client {
          /**
           * Gets the current number of all created audio output devices.
-          * @return The current number of all created audio output devices.
+          * @return The current number of all created audio output devices
+          *  or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getAudioOutputDeviceCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET AUDIO_OUTPUT_DEVICES");
-                 out.writeLine("GET AUDIO_OUTPUT_DEVICES");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 1576 
 public class Client {
+Line 1980 
 public class Client {
           */
          public synchronized Integer[]
          getAudioOutputDeviceIDs() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST AUDIO_OUTPUT_DEVICES");
-                 out.writeLine("LIST AUDIO_OUTPUT_DEVICES");
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 1683 
 public class Client {
+Line 2083 
 public class Client {
           */
          public synchronized void
          setAudioOutputDeviceParameter(int deviceId, Parameter prm)
-                                                 throws IOException, LscpException, LSException {
+                                         throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String kv = prm.getName() + '=' + prm.getStringValue();
-                 out.writeLine("SET AUDIO_OUTPUT_DEVICE_PARAMETER " + deviceId + ' ' + kv);
+                 retrieveIndex("SET AUDIO_OUTPUT_DEVICE_PARAMETER " + deviceId + ' ' + kv);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 1874 
 public class Client {
+Line 2270 
 public class Client {
           */
          public synchronized void
          setAudioOutputChannelParameter(int devId, int chn,  Parameter prm)
-                                                 throws IOException, LscpException, LSException {
+                                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = devId + " " + chn + " " + prm.getName() + '=' + prm.getStringValue();
-                 out.writeLine("SET AUDIO_OUTPUT_CHANNEL_PARAMETER " + args);
+                 retrieveIndex("SET AUDIO_OUTPUT_CHANNEL_PARAMETER " + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
           * Gets the current number of all MIDI input drivers.
-          * @return The current number of all MIDI input drivers.
+          * @return The current number of all MIDI input drivers or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInputDriverCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET AVAILABLE_MIDI_INPUT_DRIVERS");
-                 out.writeLine("GET AVAILABLE_MIDI_INPUT_DRIVERS");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 1958 
 public class Client {
+Line 2345 
 public class Client {
          public synchronized MidiInputDriver
          getMidiInputDriverInfo(String driverName, Parameter... depList)
                                          throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 MidiInputDriver mid = new MidiInputDriver();
-                 out.writeLine("GET MIDI_INPUT_DRIVER INFO " + driverName);
+                 if(!retrieveInfo("GET MIDI_INPUT_DRIVER INFO " + driverName, mid)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 MidiInputDriver mid = new MidiInputDriver(rs.getMultiLineResult());
                  mid.setName(driverName);
                  for(String s : mid.getParameterNames())
-Line 2004 
 public class Client {
+Line 2386 
 public class Client {
                  args.append(' ').append(param);
                  for(Parameter p : deplist) {
-                         if(p.getValue() == null) continue;
+                         if(p == null || p.getName() == null || p.getValue() == null) continue;
                          args.append(' ').append(p.getName()).append('=').append(p.getStringValue());
                  }
-Line 2063 
 public class Client {
+Line 2445 
 public class Client {
           */
          public synchronized int
          createMidiInputDevice(String miDriver, Parameter... paramList)
-                                         throws IOException, LSException, LscpException {
+                                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  StringBuffer args = new StringBuffer(miDriver);
                  for(Parameter p : paramList) {
-                         if(p.getValue() == null) continue;
+                         if(p == null || p.getName() == null || p.getValue() == null) continue;
                          args.append(' ').append(p.getName()).append('=').append(p.getStringValue());
                  }
-                 out.writeLine("CREATE MIDI_INPUT_DEVICE " + args.toString());
+                 return retrieveIndex("CREATE MIDI_INPUT_DEVICE " + args.toString());
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 2092 
 public class Client {
+Line 2468 
 public class Client {
           */
          public synchronized void
          destroyMidiInputDevice(int deviceId) throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 retrieveIndex("DESTROY MIDI_INPUT_DEVICE " + deviceId);
-                 out.writeLine("DESTROY MIDI_INPUT_DEVICE " + deviceId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 2118 
 public class Client {
+Line 2490 
 public class Client {
          /**
           * Gets the current number of all created MIDI input devices.
-          * @return The current number of all created MIDI input devices.
+          * @return The current number of all created MIDI input
+          * devices or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInputDeviceCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET MIDI_INPUT_DEVICES");
-                 out.writeLine("GET MIDI_INPUT_DEVICES");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 2170 
 public class Client {
+Line 2538 
 public class Client {
           */
          public synchronized Integer[]
          getMidiInputDeviceIDs() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST MIDI_INPUT_DEVICES");
-                 out.writeLine("LIST MIDI_INPUT_DEVICES");
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 2216 
 public class Client {
+Line 2580 
 public class Client {
                                  mid.setActive(Boolean.parseBoolean(s));
                          } else if(s.startsWith("PORTS: ")) {
                                  s = s.substring("PORTS: ".length());
-                                 int ports = Parser.parseInt(s);
-                                 MidiPort[] midiPorts = new MidiPort[ports > 0 ? ports : 0];
+                                 Parameter<Integer> ports = (Parameter<Integer>)
+                                         getMidiInputDriverParameterInfo(drv, "PORTS");
+                                 ports.parseValue(s);
+                                 mid.setPortsParameter(ports);
+                                 int j = ports.getValue();
+                                 MidiPort[] midiPorts = new MidiPort[j > 0 ? j : 0];
                                  for(int i = 0; i < midiPorts.length; i++)
                                          midiPorts[i] = getMidiInputPortInfo(deviceId, i);
-Line 2264 
 public class Client {
+Line 2635 
 public class Client {
           */
          public synchronized void
          setMidiInputDeviceParameter(int deviceId, Parameter prm)
-                                                 throws IOException, LscpException, LSException {
+                                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String kv = prm.getName() + '=' + prm.getStringValue();
-                 out.writeLine("SET MIDI_INPUT_DEVICE_PARAMETER " + deviceId + ' ' + kv);
+                 retrieveIndex("SET MIDI_INPUT_DEVICE_PARAMETER " + deviceId + ' ' + kv);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-          * Changes the port number of the speicified MIDI input device.
+          * Changes the port number of the specified MIDI input device.
           * @param deviceId The numerical ID of the MIDI input device.
           * @param ports The new number of MIDI input ports.
           *
-Line 2437 
 public class Client {
+Line 2804 
 public class Client {
           */
          public synchronized void
          setMidiInputPortParameter(int deviceId, int port,  Parameter prm)
-                                                 throws IOException, LscpException, LSException {
+                                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = deviceId + " " + port + " " +
                          prm.getName() + '=' + prm.getStringValue();
-                 out.writeLine("SET MIDI_INPUT_PORT_PARAMETER " + args);
+                 retrieveIndex("SET MIDI_INPUT_PORT_PARAMETER " + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 2459 
 public class Client {
+Line 2822 
 public class Client {
           */
          public synchronized int
          addMidiInstrumentMap(String name) throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 return retrieveIndex("ADD MIDI_INSTRUMENT_MAP '" + toEscapedText(name) + "'");
-                 out.writeLine("ADD MIDI_INSTRUMENT_MAP '" + toEscapedString(name) + "'");
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 2479 
 public class Client {
+Line 2836 
 public class Client {
           */
          public synchronized void
          removeMidiInstrumentMap(int mapId) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 retrieveIndex("REMOVE MIDI_INSTRUMENT_MAP " + mapId);
-                 out.writeLine("REMOVE MIDI_INSTRUMENT_MAP " + mapId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 2494 
 public class Client {
+Line 2847 
 public class Client {
           */
          public synchronized void
          removeAllMidiInstrumentMaps() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 retrieveIndex("REMOVE MIDI_INSTRUMENT_MAP ALL");
-                 out.writeLine("REMOVE MIDI_INSTRUMENT_MAP ALL");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
           * Gets the current number of all MIDI instrument maps.
-          * @return The current number of all MIDI instrument maps.
+          * @return The current number of all MIDI instrument maps
+          *  or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInstrumentMapCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET MIDI_INSTRUMENT_MAPS");
-                 out.writeLine("GET MIDI_INSTRUMENT_MAPS");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 2530 
 public class Client {
+Line 2875 
 public class Client {
           */
          public synchronized Integer[]
          getMidiInstrumentMapIDs() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST MIDI_INSTRUMENT_MAPS");
-                 out.writeLine("LIST MIDI_INSTRUMENT_MAPS");
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 2608 
 public class Client {
+Line 2949 
 public class Client {
           */
          public synchronized void
          setMidiInstrumentMapName(int mapId, String name)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
+                 name = toEscapedText(name);
-                 name = toEscapedString(name);
+                 retrieveIndex("SET MIDI_INSTRUMENT_MAP NAME " +  + mapId + " '" + name + "'");
-                 out.writeLine("SET MIDI_INSTRUMENT_MAP NAME " +  + mapId + " '" + name + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
-Line 2661 
 public class Client {
+Line 2998 
 public class Client {
                  cmd.append(entry.getMidiBank()).append(' ');
                  cmd.append(entry.getMidiProgram()).append(' ');
                  cmd.append(info.getEngine()).append(" '");
-                 cmd.append(info.getFilePath()).append("' ");
+                 cmd.append(conv(info.getFilePath())).append("' ");
                  cmd.append(info.getInstrumentIndex()).append(' ');
                  cmd.append(info.getVolume());
                  if(!info.getLoadMode().name().equals("DEFAULT")) {
-Line 2669 
 public class Client {
+Line 3006 
 public class Client {
                  }
                  if(info.getName() != null) {
-                         String s = toEscapedString(info.getName());
+                         String s = toEscapedText(info.getName());
                          cmd.append(" '").append(s).append("'");
                  }
-Line 2691 
 public class Client {
+Line 3028 
 public class Client {
           */
          public synchronized void
          unmapMidiInstrument(int mapId, MidiInstrumentEntry entry)
-                                         throws IOException, LSException, LscpException {
+                                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  StringBuffer cmd = new StringBuffer("UNMAP MIDI_INSTRUMENT ");
                  cmd.append(mapId).append(' ');
                  cmd.append(entry.getMidiBank()).append(' ');
                  cmd.append(entry.getMidiProgram());
-                 out.writeLine(cmd.toString());
+                 retrieveIndex(cmd.toString());
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
           * Gets the current number of all MIDI instrument in all maps.
-          * @return The current number of all MIDI instrument in all maps.
+          * @return The current number of all MIDI instrument in all maps
+          * or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInstrumentCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET MIDI_INSTRUMENTS ALL");
-                 out.writeLine("GET MIDI_INSTRUMENTS ALL");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
           * Gets the current number of MIDI instrument in the specified map.
           * @param mapId The ID of the map.
-          * @return The current number of MIDI instrument in the specified map.
+          * @return The current number of MIDI instrument in the
+          * specified map or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInstrumentCount(int mapId) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET MIDI_INSTRUMENTS " + String.valueOf(mapId));
-                 out.writeLine("GET MIDI_INSTRUMENTS " + String.valueOf(mapId));
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 2760 
 public class Client {
+Line 3085 
 public class Client {
          }
          /**
-          * Gets all MIDI instrument contained int the specified MIDI instrument map.
+          * Gets all MIDI instrument entries contained int the specified MIDI instrument map.
+          * @param mapId The ID of the map, which instruments should be obtained.
+          * @return An int array providing all MIDI instrument entries
+          * in the specified MIDI instrument map.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int[][]
+         getMidiInstrumentEntries(int mapId) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine("LIST MIDI_INSTRUMENTS " + String.valueOf(mapId));
+                 if(getPrintOnlyMode()) return null;
+                 String[] entries = parseArray(getSingleLineResultSet().getResult());
+                 int[][] e = new int[entries.length][3];
+                 for(int i = 0; i < entries.length; i++) {
+                         Integer[] vals = parseIntList(entries[i]);
+                         if(vals.length != 3) {
+                                 throw new LscpException(LscpI18n.getLogMsg("CommandFailed!"));
+                         }
+                         e[i][0] = vals[0];
+                         e[i][1] = vals[1];
+                         e[i][2] = vals[2];
+                 }
+                 return e;
+         }
+         /**
+          * Gets all MIDI instruments contained int the specified MIDI instrument map.
           * @param mapId The ID of the map, which instruments should be obtained.
           * @return A <code>MidiInstrumentInfo</code> array providing
-          * all MIDI instruments from all MIDI instrument maps.
+          * all MIDI instruments in the specified MIDI instrument map.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
-Line 2811 
 public class Client {
+Line 3168 
 public class Client {
                                          throws IOException, LscpException, LSException {
                  verifyConnection();
+                 requestMidiInstrumentInfo(mapId, bank, program);
+                 return getMidiInstrumentInfoResponse(mapId, bank, program);
+         }
+         private void
+         requestMidiInstrumentInfo(int mapId, int bank, int program) throws IOException {
                  StringBuffer cmd = new StringBuffer("GET MIDI_INSTRUMENT INFO ");
                  cmd.append(mapId).append(' ');
                  cmd.append(bank).append(' ');
                  cmd.append(program);
                  out.writeLine(cmd.toString());
-                 if(getPrintOnlyMode()) return null;
+         }
+         private MidiInstrumentInfo
+         getMidiInstrumentInfoResponse(int mapId, int bank, int program)
+                                         throws IOException, LscpException, LSException {
+                 if(getPrintOnlyMode()) return null;
                  ResultSet rs = getMultiLineResultSet();
                  MidiInstrumentEntry entry = new MidiInstrumentEntry(bank, program);
                  return new MidiInstrumentInfo(mapId, entry, rs.getMultiLineResult());
-Line 2865 
 public class Client {
+Line 3233 
 public class Client {
           */
          public synchronized void
          loadInstrument(String filename, int instrIdx, int samplerChn, boolean nonModal)
-                                                 throws IOException, LscpException, LSException {
+                                                 throws IOException, LscpException, LSException
+         {
                  String cmd = nonModal ? "LOAD INSTRUMENT NON_MODAL " : "LOAD INSTRUMENT ";
-                 String args = '\'' + filename + "' " + instrIdx + ' ' + samplerChn;
+                 String args = '\'' + conv(filename) + "' " + instrIdx + ' ' + samplerChn;
-                 out.writeLine(cmd + args);
+                 retrieveIndex(cmd + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 2890 
 public class Client {
+Line 3255 
 public class Client {
           */
          public synchronized void
          loadSamplerEngine(String engineName, int samplerChn)
-                                         throws IOException, LscpException, LSException {
+                                         throws IOException, LscpException, LSException
+         { retrieveIndex("LOAD ENGINE " + engineName + ' ' + samplerChn); }
-                 verifyConnection();
-                 out.writeLine("LOAD ENGINE " + engineName + ' ' + samplerChn);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Gets the current number of all created sampler channels.
-          * @return The current number of all created sampler channels.
+          * @return The current number of all created sampler
+          * channels or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getSamplerChannelCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET CHANNELS");
-                 out.writeLine("GET CHANNELS");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 2937 
 public class Client {
+Line 3292 
 public class Client {
                  return channels;
          }
+         /**
+          * Gets a list of the specified sampler channels.
+          * @return A <code>SamplerChannel</code> array providing all created sampler channels.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #addSamplerChannel
+          * @see #removeSamplerChannel
+          */
+         public synchronized SamplerChannel[]
+         getSamplerChannels(final Integer[] ids) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 int count = 0;
+                 for(int i = 0; i < ids.length; i++) {
+                         if(ids[i] >= 0) {
+                                 int tmp = ids[i]; // to avoid overlapping
+                                 ids[i] = -1;
+                                 ids[count++] = tmp;
+                         }
+                 }
+                 if(getPrintOnlyMode()) return null;
+                 final SamplerChannel[] channels = new SamplerChannel[count];
+                 new CmdListIterator(count) {
+                         @Override
+                         protected void
+                         writeOutput(int index) throws IOException {
+                                 channels[index] = new SamplerChannel();
+                                 out.writeLine("GET CHANNEL INFO " + ids[index]);
+                                 channels[index].setChannelId(ids[index]);
+                         }
+                         @Override
+                         protected void
+                         readInput(int index) throws IOException, LscpException, LSException {
+                                 if(getPrintOnlyMode()) return;
+                                 ResultSet rs = getMultiLineResultSet();
+                                 for(String s : rs.getMultiLineResult()) {
+                                         if(!channels[index].parse(s)) {
+                                                 String msg = LscpI18n.getLogMsg("unknownLine", s);
+                                                 Client.getLogger().info(msg);
+                                         }
+                                 }
+                         }
+                 }.run();
+                 for(SamplerChannel sc : channels) {
+                         if(sc.getEngine() != null) {
+                                 sc.setEngine(getEngineInfo(sc.getEngine().getName()));
+                         }
+                 }
+                 return channels;
+         }
+         private static abstract class CmdListIterator {
+                 private final int cmdCount;
+                 private final int cmdsPerStep;
+                 CmdListIterator(int cmdCount) {
+                         this(cmdCount, 100);
+                 }
+                 CmdListIterator(int cmdCount, int cmdsPerStep) {
+                         this.cmdCount = cmdCount;
+                         this.cmdsPerStep = cmdsPerStep;
+                 }
+                 public void
+                 run() throws IOException, LscpException, LSException {
+                         int currentStep = 0;
+                         int stepCount = cmdCount / cmdsPerStep;
+                         for(currentStep = 0; currentStep < stepCount; currentStep++) {
+                                 for(int j = 0; j < cmdsPerStep; j++) {
+                                         int idx = (currentStep * cmdsPerStep) + j;
+                                         writeOutput(idx);
+                                 }
+                                 for(int j = 0; j < cmdsPerStep; j++) {
+                                         int idx = (currentStep * cmdsPerStep) + j;
+                                         readInput(idx);
+                                 }
+                         }
+                         int cmdsLeft = cmdCount % cmdsPerStep;
+                         if(cmdsLeft > 0) {
+                                 for(int j = 0; j < cmdsLeft; j++) {
+                                         int idx = stepCount * cmdsPerStep + j;
+                                         writeOutput(idx);
+                                 }
+                                 for(int j = 0; j < cmdsLeft; j++) {
+                                         int idx = stepCount * cmdsPerStep + j;
+                                         readInput(idx);
+                                 }
+                         }
+                 }
+                 protected abstract void writeOutput(int index) throws IOException;
+                 protected abstract void readInput(int index) throws IOException, LscpException, LSException;
+         }
          /**
           * Gets a list with numerical IDs of all created sampler channels.
-Line 2950 
 public class Client {
+Line 3414 
 public class Client {
           */
          public synchronized Integer[]
          getSamplerChannelIDs() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST CHANNELS");
-                 out.writeLine("LIST CHANNELS");
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 2969 
 public class Client {
+Line 3429 
 public class Client {
           */
          public synchronized int
          addSamplerChannel() throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 return retrieveIndex("ADD CHANNEL");
-                 out.writeLine("ADD CHANNEL");
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 2991 
 public class Client {
+Line 3445 
 public class Client {
           */
          public synchronized void
          removeSamplerChannel(int samplerChn) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 retrieveIndex("REMOVE CHANNEL " + samplerChn);
-                 out.writeLine("REMOVE CHANNEL " + samplerChn);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
           * Gets the number of all available engines.
-          * @return The number of all available engines.
+          * @return The number of all available engines or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getEngineCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET AVAILABLE_ENGINES");
-                 out.writeLine("GET AVAILABLE_ENGINES");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 3066 
 public class Client {
+Line 3511 
 public class Client {
           */
          private synchronized SamplerEngine
          getEngineInfo(String engineName) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 SamplerEngine se = engineMap.get(engineName);
-                 out.writeLine("GET ENGINE INFO " + engineName);
+                 if(se != null) return se;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
+                 se = new SamplerEngine();
-                 SamplerEngine se = new SamplerEngine(rs.getMultiLineResult());
+                 if(!retrieveInfo("GET ENGINE INFO " + engineName, se)) return null;
                  se.setName(engineName);
+                 engineMap.put(engineName, se);
                  return se;
          }
-Line 3090 
 public class Client {
+Line 3536 
 public class Client {
           */
          public synchronized SamplerChannel
          getSamplerChannelInfo(int samplerChn) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 SamplerChannel sc = new SamplerChannel();
-                 out.writeLine("GET CHANNEL INFO " + samplerChn);
+                 if(!retrieveInfo("GET CHANNEL INFO " + samplerChn, sc)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 SamplerChannel sc = new SamplerChannel(rs.getMultiLineResult());
                  sc.setChannelId(samplerChn);
                  if(sc.getEngine() != null) sc.setEngine(getEngineInfo(sc.getEngine().getName()));
-Line 3106 
 public class Client {
+Line 3548 
 public class Client {
           * Gets the current number of active voices on the specified sampler channel.
           *
           * @param samplerChn The sampler channel number.
-          * @return The current number of active voices on the specified sampler channel.
+          * @return The current number of active voices on the
+          * specified sampler channel or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If there is no sampler channel with number <code>samplerChn</code>.
-Line 3114 
 public class Client {
+Line 3557 
 public class Client {
           */
          public synchronized int
          getChannelVoiceCount(int samplerChn) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET CHANNEL VOICE_COUNT " + samplerChn);
-                 out.writeLine("GET CHANNEL VOICE_COUNT " + samplerChn);
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getSingleLineResultSet();
-                 return parseInt(rs.getResult());
          }
          /**
-Line 3260 
 public class Client {
+Line 3697 
 public class Client {
           */
          public synchronized void
          setChannelAudioOutputDevice(int samplerChn, int devId)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL AUDIO_OUTPUT_DEVICE " + samplerChn + ' ' + devId); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL AUDIO_OUTPUT_DEVICE " + samplerChn + ' ' + devId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Sets the audio output channel on the specified sampler channel.
-Line 3290 
 public class Client {
+Line 3721 
 public class Client {
           */
          public synchronized void
          setChannelAudioOutputChannel(int samplerChn, int audioOut, int audioIn)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = " " + samplerChn + ' ' + audioOut + ' ' + audioIn;
-                 out.writeLine("SET CHANNEL AUDIO_OUTPUT_CHANNEL" + args);
+                 retrieveIndex("SET CHANNEL AUDIO_OUTPUT_CHANNEL" + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3319 
 public class Client {
+Line 3746 
 public class Client {
           */
          public synchronized void
          setChannelMidiInputDevice(int samplerChn, int devId)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL MIDI_INPUT_DEVICE " + samplerChn + ' ' + devId); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL MIDI_INPUT_DEVICE " + samplerChn + ' ' + devId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Sets the MIDI input port on the specified sampler channel.
-Line 3342 
 public class Client {
+Line 3763 
 public class Client {
           */
          public synchronized void
          setChannelMidiInputPort(int samplerChn, int port)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL MIDI_INPUT_PORT " + samplerChn + ' ' + port); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL MIDI_INPUT_PORT " + samplerChn + ' ' + port);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Sets the MIDI input channel the specified sampler channel should listen to.
-Line 3365 
 public class Client {
+Line 3780 
 public class Client {
           */
          public synchronized void
          setChannelMidiInputChannel(int samplerChn, int midiChn)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = String.valueOf(samplerChn) + ' ';
                  args += (midiChn == -1 ? "ALL" : String.valueOf(midiChn));
-                 out.writeLine("SET CHANNEL MIDI_INPUT_CHANNEL " + args);
+                 retrieveIndex("SET CHANNEL MIDI_INPUT_CHANNEL " + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3397 
 public class Client {
+Line 3808 
 public class Client {
           */
          public synchronized void
          setChannelMidiInstrumentMap(int samplerChn, int mapId)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String s;
                  if(mapId == -1) {
                          s = " NONE";
-Line 3408 
 public class Client {
+Line 3818 
 public class Client {
                  } else {
                          s = " " + String.valueOf(mapId);
                  }
-                 out.writeLine("SET CHANNEL MIDI_INSTRUMENT_MAP " + samplerChn + s);
-                 if(getPrintOnlyMode()) return;
+                 retrieveIndex("SET CHANNEL MIDI_INSTRUMENT_MAP " + samplerChn + s);
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3428 
 public class Client {
+Line 3836 
 public class Client {
           */
          public synchronized void
          setChannelVolume(int samplerChn, float volume)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL VOLUME " + samplerChn + ' ' + volume); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL VOLUME " + samplerChn + ' ' + volume);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Mute/unmute the specified sampler channel.
-Line 3452 
 public class Client {
+Line 3854 
 public class Client {
           */
          public synchronized void
          setChannelMute(int samplerChn, boolean mute)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL MUTE " + samplerChn + ' ' + (mute ? 1 : 0)); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL MUTE " + samplerChn + ' ' + (mute ? 1 : 0));
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Solo/unsolo the specified sampler channel.
-Line 3476 
 public class Client {
+Line 3872 
 public class Client {
           */
          public synchronized void
          setChannelSolo(int samplerChn, boolean solo)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL SOLO " + samplerChn + ' ' + (solo ? 1 : 0)); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL SOLO " + samplerChn + ' ' + (solo ? 1 : 0));
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Creates an additional effect send on the specified sampler channel.
-Line 3516 
 public class Client {
+Line 3906 
 public class Client {
           */
          public synchronized int
          createFxSend(int channel, int midiCtrl, String name)
-                         throws IOException, LSException, LscpException {
+                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  String s = String.valueOf(channel) + " " + String.valueOf(midiCtrl);
-                 if(name != null) s += " '" + toEscapedString(name) + "'";
+                 if(name != null) s += " '" + toEscapedText(name) + "'";
-                 out.writeLine("CREATE FX_SEND " + s);
-                 if(getPrintOnlyMode()) return -1;
+                 return retrieveIndex("CREATE FX_SEND " + s);
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 3540 
 public class Client {
+Line 3925 
 public class Client {
           */
          public synchronized void
          destroyFxSend(int channel, int fxSend)
-                         throws IOException, LSException, LscpException {
+                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  String s = String.valueOf(channel) + " " + String.valueOf(fxSend);
-                 out.writeLine("DESTROY FX_SEND " + s);
+                 retrieveIndex("DESTROY FX_SEND " + s);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3559 
 public class Client {
+Line 3940 
 public class Client {
           * @throws LSException If some other error occurs.
           */
          public synchronized int
-         getFxSoundCount(int channel) throws IOException, LscpException, LSException {
+         getFxSendCount(int channel) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET FX_SENDS " + String.valueOf(channel));
-                 out.writeLine("GET FX_SENDS " + String.valueOf(channel));
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 3605 
 public class Client {
+Line 3981 
 public class Client {
           */
          public synchronized Integer[]
          getFxSendIDs(int channel) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST FX_SENDS " + channel);
-                 out.writeLine("LIST FX_SENDS " + channel);
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 3624 
 public class Client {
+Line 3996 
 public class Client {
           */
          public synchronized FxSend
          getFxSendInfo(int channel, int fxSend) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 FxSend fxs = new FxSend();
                  String s = String.valueOf(channel) + " " + String.valueOf(fxSend);
-                 out.writeLine("GET FX_SEND INFO " + s);
+                 if(!retrieveInfo("GET FX_SEND INFO " + s, fxs)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 FxSend fxs = new FxSend(rs.getMultiLineResult());
                  fxs.setFxSendId(fxSend);
                  return fxs;
-Line 3648 
 public class Client {
+Line 4016 
 public class Client {
           */
          public synchronized void
          setFxSendName(int channel, int fxSend, String name)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
+                 String args = " " + channel + " " + fxSend + " '" + toEscapedText(name) + "'";
-                 String args = " " + channel + " " + fxSend + " '" + toEscapedString(name) + "'";
+                 retrieveIndex("SET FX_SEND NAME" + args);
-                 out.writeLine("SET FX_SEND NAME" + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3678 
 public class Client {
+Line 4042 
 public class Client {
           */
          public synchronized void
          setFxSendAudioOutputChannel(int channel, int fxSend, int audioSrc, int audioDst)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = " " + channel + " " + fxSend + " " + audioSrc + " " + audioDst;
-                 out.writeLine("SET FX_SEND AUDIO_OUTPUT_CHANNEL" + args);
+                 retrieveIndex("SET FX_SEND AUDIO_OUTPUT_CHANNEL" + args);
-                 if(getPrintOnlyMode()) return;
+         }
-                 ResultSet rs = getEmptyResultSet();
+         /**
+          * Assign a destination effect to an effect send.
+          * @param channel The sampler channel number.
+          * @param fxSend The numerical ID of the effect send entity.
+          * @param fxChainId The numerical ID of the destination effect chain.
+          * @param chainPos The exact effect chain position in the effect
+          * chain which hosts the actual destination effect.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If
+          * <ul>
+          * <li><code>channel</code> is not a valid channel number;
+          * <li><code>fxSend</code> is not a valid effect send ID;
+          * <li><code>fxChainId</code> is not a valid effect chain ID;
+          * <li><code>chainPos</code> is out of bounds;
+          * <li>There is no engine assigned yet to the specified sampler channel;
+          * <li>There is no audio output device connected to the specified sampler channel.
+          * </ul>
+          */
+         public synchronized void
+         setFxSendEffect(int channel, int fxSend, int fxChainId, int chainPos)
+                                 throws IOException, LscpException, LSException
+         {
+                 String args = " " + channel + " " + fxSend + " " + fxChainId + " " + chainPos;
+                 retrieveIndex("SET FX_SEND EFFECT" + args);
+         }
+         /**
+          * Removes destination effect from an effect send.
+          * @param channel The sampler channel number.
+          * @param fxSend The numerical ID of the effect send entity.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If other error occurs.
+          */
+         public synchronized void
+         removeFxSendEffect(int channel, int fxSend) throws IOException, LscpException, LSException {
+                 String args = " " + channel + " " + fxSend;
+                 retrieveIndex("REMOVE FX_SEND EFFECT" + args);
          }
          /**
-Line 3706 
 public class Client {
+Line 4107 
 public class Client {
           */
          public synchronized void
          setFxSendMidiController(int channel, int fxSend, int midiCtrl)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = " " + channel + " " + fxSend + " " + midiCtrl;
-                 out.writeLine("SET FX_SEND MIDI_CONTROLLER" + args);
+                 retrieveIndex("SET FX_SEND MIDI_CONTROLLER" + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3729 
 public class Client {
+Line 4126 
 public class Client {
           */
          public synchronized void
          setFxSendLevel(int channel, int fxSend, float volume)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = " " + channel + " " + fxSend + " " + String.valueOf(volume);
-                 out.writeLine("SET FX_SEND LEVEL" + args);
+                 retrieveIndex("SET FX_SEND LEVEL" + args);
-                 if(getPrintOnlyMode()) return;
+         }
-                 ResultSet rs = getEmptyResultSet();
+         /**
+          * Gets the current amount of internal effects available to the sampler.
+          * @return The current amount of internal effects available to the sampler.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getEffectCount() throws IOException, LscpException, LSException
+         { return retrieveInt("GET AVAILABLE_EFFECTS"); }
+         /**
+          * Gets the list of internal effects available to the sampler.
+          * Note that the set of available internal effects can change at runtime.
+          * @return An <code>Effect</code> array providing the current list of internal effects.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized Effect[]
+         getEffects() throws IOException, LscpException, LSException {
+                 Integer[] idS = getEffectIDs();
+                 if(getPrintOnlyMode()) return null;
+                 Effect[] effects = new Effect[idS.length];
+                 for(int i = 0; i < effects.length; i++)
+                         effects[i] = getEffectInfo(idS[i]);
+                 return effects;
+         }
+         /**
+          * Retrieves the list of available internal effects.
+          * Note that the set of available internal effects can change at runtime.
+          * @return An <code>Integer</code> array providing
+          * the numerical IDs of all available internal effects.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized Integer[]
+         getEffectIDs() throws IOException, LscpException, LSException
+         { return getIntegerList("LIST AVAILABLE_EFFECTS"); }
+         /**
+          * Gets general informations about the specified effect.
+          * @param effect The numerical ID of the effect entity.
+          * @return <code>Effect</code> instance containing
+          * general informations about the specified effect.
+          * @throws IOException If an I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the effect ID is invalid.
+          */
+         public synchronized Effect
+         getEffectInfo(int effect) throws IOException, LscpException, LSException {
+                 Effect e = new Effect();
+                 if(!retrieveInfo("GET EFFECT INFO " + effect, e)) return null;
+                 e.setEffectId(effect);
+                 return e;
+         }
+         /**
+          * Creates an instance of the desired effect.
+          * @param id The unique ID of the effect.
+          * @return The unique ID of the newly created effect instance.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the creation of the effect instance failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #getEffectIDs
+          * @see #getEffectInfo
+          * @see #destroyEffectInstance
+          */
+         public synchronized int
+         createEffectInstanceById(int id) throws IOException, LSException, LscpException
+         { return retrieveIndex("CREATE EFFECT_INSTANCE " + String.valueOf(id)); }
+         /**
+          * Creates an instance of the desired effect.
+          * @return The unique ID of the newly created effect instance.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the creation of the effect instance failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #getEffectInfo
+          * @see #destroyEffectInstance
+          */
+         public synchronized int
+         createEffectInstance(Effect effect) throws IOException, LSException, LscpException
+         { return createEffectInstanceById(effect.getEffectId()); }
+         /**
+          * Creates an instance of the desired effect.
+          * @return The unique ID of the newly created effect instance.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the creation of the effect instance failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #getEffectInfo
+          * @see #destroyEffectInstance
+          */
+         public synchronized int
+         createEffectInstance(String system, String module, String name)
+                         throws IOException, LSException, LscpException
+         {
+                 String s = system + " '" + toEscapedText(module) + "' '" + toEscapedText(name) + "'";
+                 return retrieveIndex("CREATE EFFECT_INSTANCE " + s);
+         }
+         /**
+          * Destroys the specified unused effect instance.
+          * @param instanceId The numerical ID of the effect instance.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #createEffectInstance
+          */
+         public synchronized void
+         destroyEffectInstance(int instanceId) throws IOException, LSException, LscpException
+         { retrieveIndex("DESTROY EFFECT_INSTANCE " + String.valueOf(instanceId)); }
+         /**
+          * Gets the current amount of effect instances available to the sampler.
+          * @return The current amount of effect instances available to the sampler.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getEffectInstanceCount() throws IOException, LscpException, LSException
+         { return retrieveInt("GET EFFECT_INSTANCES"); }
+         /**
+          * Gets the current list of effect instances.
+          * @return An <code>EffectInstanceInfo</code> array
+          * providing the current list of effect instances.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized EffectInstanceInfo[]
+         getEffectInstances() throws IOException, LscpException, LSException {
+                 Integer[] idS = getEffectInscanceIDs();
+                 if(getPrintOnlyMode()) return null;
+                 EffectInstanceInfo[] eis = new EffectInstanceInfo[idS.length];
+                 for(int i = 0; i < eis.length; i++)
+                         eis[i] = getEffectInstanceInfo(idS[i]);
+                 return eis;
+         }
+         /**
+          * Retrieves the current list of effect instances.
+          * @return An <code>Integer</code> array providing
+          * the numerical IDs of all available effect instances.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized Integer[]
+         getEffectInscanceIDs() throws IOException, LscpException, LSException
+         { return getIntegerList("LIST EFFECT_INSTANCES"); }
+         /**
+          * Gets the current informations about the specified effect instance.
+          * @param id The numerical ID of the effect instance.
+          * @return <code>EffectInstanceInfo</code> object containing
+          * the current informations about the specified effect instance.
+          * @throws IOException If an I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the effect instance ID is invalid.
+          */
+         public synchronized EffectInstanceInfo
+         getEffectInstanceInfo(int id) throws IOException, LscpException, LSException {
+                 EffectInstanceInfo ei = new EffectInstanceInfo();
+                 if(!retrieveInfo("GET EFFECT_INSTANCE INFO " + id, ei)) return null;
+                 ei.setInstanceId(id);
+                 for(int i = 0; i < ei.getParameterCount(); i++) {
+                         ei.addParameter(getEffectInstanceParameterInfo(id, i));
+                 }
+                 return ei;
+         }
+         /**
+          * Gets information about the specified effect parameter.
+          * @param id The numerical ID of the effect instance.
+          * @param parameter The parameter index.
+          * @return <code>EffectParameter</code> object containing
+          * information about the specified effect parameter.
+          * Note that only the following fields are used - description,
+          * value, rangeMin, rangeMax, possibilities and default.
+          * @throws IOException If an I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the effect instance ID or the parameter index is invalid.
+          */
+         public synchronized EffectParameter
+         getEffectInstanceParameterInfo(int instanceId, int parameter)
+                                 throws IOException, LscpException, LSException
+         {
+                 EffectParameter prm = new EffectParameter(instanceId, parameter);
+                 String s = String.valueOf(instanceId) + " " + String.valueOf(parameter);
+                 if(!retrieveInfo("GET EFFECT_INSTANCE_INPUT_CONTROL INFO " + s, prm)) return null;
+                 return prm;
+         }
+         /**
+          * Alters the current value of an effect parameter.
+          * @param instanceId The numerical ID of the effect instance.
+          * @param prmIndex The index of the parameter to alter.
+          * @param value The new value for this parameter.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If
+          * <ul>
+          * <li>There is no effect instance with numerical ID <code>instanceId</code>;
+          * <li>There parameter index is invalid;
+          * <li>The new value is out of range;
+          * </ul>
+          *
+          * @see #getEffectInstanceInfo
+          * @see #getEffectInstanceParameterInfo
+          */
+         public synchronized void
+         setEffectInstanceParameter(int instanceId, int prmIndex, float value)
+                                         throws IOException, LscpException, LSException
+         {
+                 String s = " " + instanceId + " " + prmIndex + " " + value;
+                 retrieveIndex("SET EFFECT_INSTANCE_INPUT_CONTROL VALUE" + s);
+         }
+         /**
+          * Gets the current amount of send effect chains on the specified audio output device.
+          * @param audioDeviceId numerical ID of the audio output device.
+          * @return The current amount of send effect chains or -1 if in "print only" mode.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getSendEffectChainCount(int audioDeviceId) throws IOException, LscpException, LSException
+         { return retrieveInt("GET SEND_EFFECT_CHAINS " + audioDeviceId); }
+         /**
+          * Gets the current list of send effect chains on the specified audio output device.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @return An <code>EffectInstanceInfo</code> array
+          * providing the current list of effect instances.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized EffectChainInfo[]
+         getSendEffectChains(int audioDeviceId) throws IOException, LscpException, LSException {
+                 Integer[] idS = getSendEffectChainIDs(audioDeviceId);
+                 if(getPrintOnlyMode()) return null;
+                 EffectChainInfo[] ecs = new EffectChainInfo[idS.length];
+                 for(int i = 0; i < ecs.length; i++) {
+                         ecs[i] = getSendEffectChainInfo(audioDeviceId, idS[i]);
+                         ecs[i].setChainId(idS[i]);
+                 }
+                 return ecs;
+         }
+         /**
+          * Retrieves the current list of send effect
+          * chains on the specified audio output device.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @return An <code>Integer</code> array providing the numerical
+          * IDs of all send effect chains on the specified audio output device.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized Integer[]
+         getSendEffectChainIDs(int audioDeviceId) throws IOException, LscpException, LSException
+         { return getIntegerList("LIST SEND_EFFECT_CHAINS " + audioDeviceId); }
+         /**
+          * Adds a send effect chain to the specified audio output device.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @return The numerical ID of the new send effect chain.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the creation of the effect chain failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #removeSendEffectChain
+          * @see #getSendEffectChainInfo
+          */
+         public synchronized int
+         addSendEffectChain(int audioDeviceId) throws IOException, LSException, LscpException
+         { return retrieveIndex("ADD SEND_EFFECT_CHAIN " + audioDeviceId); }
+         /**
+          * Removes a send effect chain from an audio output device.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain to remove.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #addSendEffectChain
+          */
+         public synchronized void
+         removeSendEffectChain(int audioDeviceId, int chainId) throws IOException, LSException, LscpException
+         { retrieveIndex("REMOVE SEND_EFFECT_CHAIN " + audioDeviceId + " " + chainId); }
+         /**
+          * Gets the current information of a send effect chain.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain.
+          * @return <code>EffectChainInfo</code> object containing
+          * the current informations about the specified effect chain.
+          * @throws IOException If an I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the audio device ID or the effect chain ID is invalid.
+          */
+         public synchronized EffectChainInfo
+         getSendEffectChainInfo(int audioDeviceId, int chainId)
+                                 throws IOException, LscpException, LSException
+         {
+                 verifyConnection();
+                 String str = " " + audioDeviceId + " " + chainId;
+                 out.writeLine("GET SEND_EFFECT_CHAIN INFO" + str);
+                 if(getPrintOnlyMode()) return null;
+                 ResultSet rs = getMultiLineResultSet();
+                 EffectChainInfo chain = null;
+                 for(String s : rs.getMultiLineResult()) {
+                         if(s.startsWith("EFFECT_SEQUENCE: ")) {
+                                 s = s.substring("EFFECT_SEQUENCE: ".length());
+                                 Integer[] eis = parseIntList(s);
+                                 EffectInstanceInfo[] instances = new EffectInstanceInfo[eis.length];
+                                 for(int i = 0; i < eis.length; i++) {
+                                         instances[i] = getEffectInstanceInfo(eis[i]);
+                                 }
+                                 chain = new EffectChainInfo(instances);
+                                 chain.setChainId(chainId);
+                         }
+                 }
+                 return chain;
+         }
+         /**
+          * Adds an unused effect instance to the end of a send effect chain.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain.
+          * @param fxInstanceId The numerical ID of the effect instance to add.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If invalid index is specified.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #addSendEffectChain
+          * @see #createEffectInstance
+          */
+         public synchronized void
+         appendEffectInstance(int audioDeviceId, int chainId, int fxInstanceId)
+                         throws IOException, LSException, LscpException
+         {
+                 String s = " " + audioDeviceId + " " + chainId + " " + fxInstanceId;
+                 retrieveIndex("APPEND SEND_EFFECT_CHAIN EFFECT" + s);
+         }
+         /**
+          * Adds an unused effect instance at a certain position of a send effect chain.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain.
+          * @param pos The exact position in the effect chain where
+          * the supplied effect shall be inserted to.
+          * @param fxInstanceId The numerical ID of the effect instance to insert.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If invalid index is specified.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #addSendEffectChain
+          * @see #createEffectInstance
+          */
+         public synchronized void
+         insertEffectInstance(int audioDeviceId, int chainId, int pos, int fxInstanceId)
+                         throws IOException, LSException, LscpException
+         {
+                 String s = " " + audioDeviceId + " " + chainId + " " + pos + " " + fxInstanceId;
+                 retrieveIndex("INSERT SEND_EFFECT_CHAIN EFFECT" + s);
+         }
+         /**
+          * Removes an effect instance from a certain position of a send effect chain.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain.
+          * @param pos The exact position of the effect
+          * instance to be removed from the effect chain.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If invalid index is specified.
+          * @see #appendEffectInstance
+          * @see #insertEffectInstance
+          */
+         public synchronized void
+         removeEffectInstanceFromChain(int audioDeviceId, int chainId, int pos)
+                         throws IOException, LSException, LscpException
+         {
+                 String s = " " + audioDeviceId + " " + chainId + " " + pos;
+                 retrieveIndex("REMOVE SEND_EFFECT_CHAIN EFFECT" + s);
          }
          /**
-Line 3750 
 public class Client {
+Line 4543 
 public class Client {
           * @see #getSamplerChannels
           */
          public synchronized void
-         editChannelInstrument(int samplerChn) throws IOException, LscpException, LSException {
+         editChannelInstrument(int samplerChn) throws IOException, LscpException, LSException
-                 verifyConnection();
+         { retrieveIndex("EDIT CHANNEL INSTRUMENT " + samplerChn); }
-                 out.writeLine("EDIT CHANNEL INSTRUMENT " + samplerChn);
-                 if(getPrintOnlyMode()) return;
+         /**
+          * Sends a MIDI event to this sampler channel.
-                 ResultSet rs = getEmptyResultSet();
+          * @param samplerChn The sampler channel number.
+          * @param type The type of MIDI message to send.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If <code>samplerChn</code> is not a valid channel number or if
+          * there is no instrument loaded on the specified sampler channel.
+          * @see #getSamplerChannels
+          */
+         public synchronized void
+         sendChannelMidiData(int samplerChn, MidiDataEvent.Type type, int arg1, int arg2)
+                                                 throws IOException, LscpException, LSException
+         {
+                 StringBuffer sb = new StringBuffer();
+                 sb.append("SEND CHANNEL MIDI_DATA ");
+                 sb.append(type).append(" ").append(samplerChn).append(" ");
+                 sb.append(arg1).append(" ").append(arg2);
+                 retrieveIndex(sb.toString());
          }
+         /**
+          * Resets the specified sampler channel.
+          *
+          * @param samplerChn The sampler channel number.
+          *
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If <code>samplerChn</code> is not a valid channel number or if
+          * there is no engine assigned yet to the specified sampler channel.
+          * @see #getSamplerChannels
+          */
+         public synchronized void
+         resetChannel(int samplerChn) throws IOException, LscpException, LSException
+         { retrieveIndex("RESET CHANNEL " + samplerChn); }
          /**
-Line 3768 
 public class Client {
+Line 4593 
 public class Client {
           * @throws LscpException If LSCP protocol corruption occurs.
           */
          public synchronized void
-         addDbDirectory(String dir) throws IOException, LSException, LscpException {
+         addDbDirectory(String dir) throws IOException, LSException, LscpException
-                 verifyConnection();
+         { retrieveIndex("ADD DB_INSTRUMENT_DIRECTORY '" + conv(dir) + "'"); }
-                 out.writeLine("ADD DB_INSTRUMENT_DIRECTORY '" + dir + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Removes the specified directory from the instruments database.
-Line 3785 
 public class Client {
+Line 4605 
 public class Client {
           * empty or if the removal of the directory failed.
           */
          public synchronized void
-         removeDbDirectory(String dir) throws IOException, LscpException, LSException {
+         removeDbDirectory(String dir) throws IOException, LscpException, LSException
-                 removeDbDirectory(dir, false);
+         { removeDbDirectory(dir, false); }
-         }
          /**
           * Removes the specified directory from the instruments database.
-Line 3800 
 public class Client {
+Line 4619 
 public class Client {
           */
          public synchronized void
          removeDbDirectory(String dir, boolean force)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String s = "REMOVE DB_INSTRUMENT_DIRECTORY ";
                  if(force) s += "FORCE ";
-                 out.writeLine(s + "'" + dir + "'");
+                 retrieveIndex(s + "'" + conv(dir) + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3828 
 public class Client {
+Line 4643 
 public class Client {
                  String cmd = "REMOVE DB_INSTRUMENT_DIRECTORY ";
                  if(force) cmd += "FORCE ";
-                 for(String s : dirs) out.writeLine(cmd + "'" + s + "'");
+                 for(String s : dirs) out.writeLine(cmd + "'" + conv(s) + "'");
                  if(getPrintOnlyMode()) return;
-Line 3866 
 public class Client {
+Line 4681 
 public class Client {
                  String s;
                  if(recursive) s = "GET DB_INSTRUMENT_DIRECTORIES RECURSIVE '";
                  else s = "GET DB_INSTRUMENT_DIRECTORIES '";
-                 out.writeLine(s + dir + "'");
+                 out.writeLine(s + conv(dir) + "'");
                  if(getPrintOnlyMode()) return -1;
                  s = getSingleLineResultSet().getResult();
-Line 3885 
 public class Client {
+Line 4700 
 public class Client {
          public synchronized String[]
          getDbDirectoryNames(String dir) throws IOException, LscpException, LSException {
                  verifyConnection();
-                 out.writeLine("LIST DB_INSTRUMENT_DIRECTORIES '" + dir + "'");
+                 out.writeLine("LIST DB_INSTRUMENT_DIRECTORIES '" + conv(dir) + "'");
                  if(getPrintOnlyMode()) return null;
                  String[] names = parseEscapedStringList(getSingleLineResultSet().getResult());
-Line 3906 
 public class Client {
+Line 4721 
 public class Client {
           */
          public synchronized DbDirectoryInfo
          getDbDirectoryInfo(String dir) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 DbDirectoryInfo info = new DbDirectoryInfo();
-                 out.writeLine("GET DB_INSTRUMENT_DIRECTORY INFO '" + dir + "'");
+                 if(!retrieveInfo("GET DB_INSTRUMENT_DIRECTORY INFO '" + conv(dir) + "'", info)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 DbDirectoryInfo info = new DbDirectoryInfo(rs.getMultiLineResult());
                  if(dir.equals("/")) {
                          info.setName("/");
                  } else {
-Line 3940 
 public class Client {
+Line 4752 
 public class Client {
                  if(!hasEndingFileSeparator(dir)) dir += "/";
                  DbDirectoryInfo[] infoS = new DbDirectoryInfo[dirS.length];
                  for(int i = 0; i < dirS.length; i++) {
-                         infoS[i] = getDbDirectoryInfo(dir + toEscapedFileName(dirS[i]));
+                         infoS[i] = getDbDirectoryInfo(conv(dir) + toEscapedFsEntry(dirS[i]));
                  }
                  return infoS;
          }
-Line 3956 
 public class Client {
+Line 4768 
 public class Client {
           *
          public synchronized DbDirectoryInfo[]
          getDbDirectories(String dir) throws IOException, LscpException, LSException {
-                 String[] dirS = getDbDirectoryNames(dir);
+                 String[] dirS = getDbDirectoryNames(conv(dir));
                  if(dirS.length == 0) return new DbDirectoryInfo[0];
-                 if(dir.charAt(dir.length() - 1) != '/') dir += "/";
+                 if(dir.charAt(dir.length() - 1) != '/') dir += "/"; // FIXME:
                  for(int i = 0; i < dirS.length; i++) {
-                         out.writeLine("GET DB_INSTRUMENT_DIRECTORY INFO '" + dir + dirS[i] + "'");
+                         out.writeLine("GET DB_INSTRUMENT_DIRECTORY INFO '" + conv(dir + dirS[i]) + "'");
                  }
                  if(getPrintOnlyMode()) return null;
-Line 4005 
 public class Client {
+Line 4817 
 public class Client {
           */
          public synchronized void
          renameDbDirectory(String dir, String name) throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 name = toEscapedText(name);
-                 name = toEscapedString(name);
+                 retrieveIndex("SET DB_INSTRUMENT_DIRECTORY NAME '" + conv(dir) + "' '" + conv(name) + "'");
-                 out.writeLine("SET DB_INSTRUMENT_DIRECTORY NAME '" + dir + "' '" + name + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 4022 
 public class Client {
+Line 4830 
 public class Client {
           * @throws LscpException If LSCP protocol corruption occurs.
           */
          public synchronized void
-         moveDbDirectory(String dir, String dst) throws IOException, LSException, LscpException {
+         moveDbDirectory(String dir, String dst) throws IOException, LSException, LscpException
-                 verifyConnection();
+         { retrieveIndex("MOVE DB_INSTRUMENT_DIRECTORY '" + conv(dir) + "' '" + conv(dst) + "'"); }
-                 out.writeLine("MOVE DB_INSTRUMENT_DIRECTORY '" + dir + "' '" + dst + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Moves the specified directories into the specified location.
-Line 4042 
 public class Client {
+Line 4845 
 public class Client {
          moveDbDirectories(String dirs[], String dst) throws IOException, LSException, LscpException {
                  verifyConnection();
                  for(String s : dirs) {
-                         out.writeLine("MOVE DB_INSTRUMENT_DIRECTORY '" + s + "' '" + dst + "'");
+                         out.writeLine("MOVE DB_INSTRUMENT_DIRECTORY '" + conv(s) + "' '" + conv(dst) + "'");
                  }
                  if(getPrintOnlyMode()) return;
-Line 4058 
 public class Client {
+Line 4861 
 public class Client {
           * @throws LscpException If LSCP protocol corruption occurs.
           */
          public synchronized void
-         copyDbDirectory(String dir, String dst) throws IOException, LSException, LscpException {
+         copyDbDirectory(String dir, String dst) throws IOException, LSException, LscpException
-                 verifyConnection();
+         { retrieveIndex("COPY DB_INSTRUMENT_DIRECTORY '" + conv(dir) + "' '" + conv(dst) + "'"); }
-                 out.writeLine("COPY DB_INSTRUMENT_DIRECTORY '" + dir + "' '" + dst + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Copies the specified directories into the specified location.
-Line 4078 
 public class Client {
+Line 4876 
 public class Client {
          copyDbDirectories(String[] dirs, String dst) throws IOException, LSException, LscpException {
                  verifyConnection();
                  for(String s : dirs) {
-                         out.writeLine("COPY DB_INSTRUMENT_DIRECTORY '" + s + "' '" + dst + "'");
+                         out.writeLine("COPY DB_INSTRUMENT_DIRECTORY '" + conv(s) + "' '" + conv(dst) + "'");
                  }
                  if(getPrintOnlyMode()) return;
-Line 4095 
 public class Client {
+Line 4893 
 public class Client {
           */
          public synchronized void
          setDbDirectoryDescription(String dir, String desc)
-                                 throws IOException, LSException, LscpException {
+                                 throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  String s = "SET DB_INSTRUMENT_DIRECTORY DESCRIPTION '";
-                 out.writeLine(s + dir + "' '" + toEscapedString(desc) + "'");
+                 retrieveIndex(s + conv(dir) + "' '" + toEscapedText(desc) + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          public static enum ScanMode {
-Line 4143 
 public class Client {
+Line 4937 
 public class Client {
           */
          public synchronized int
          addDbInstrument(String dbDir, String filePath, int instrIndex, boolean background)
-                                         throws IOException, LSException, LscpException {
+                                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  String s = "ADD DB_INSTRUMENTS";
                  if(background) s += " NON_MODAL";
-                 s += " '" + dbDir + "' '" + filePath + "' ";
+                 s += " '" + conv(dbDir) + "' '" + conv(filePath) + "' ";
-                 out.writeLine(s + String.valueOf(instrIndex));
+                 return retrieveIndex(s + String.valueOf(instrIndex));
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 4190 
 public class Client {
+Line 4979 
 public class Client {
           */
          public synchronized int
          addDbInstruments(String dbDir, String filePath, boolean background)
-                                         throws IOException, LSException, LscpException {
+                                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  String s = "ADD DB_INSTRUMENTS";
                  if(background) s += " NON_MODAL";
-                 out.writeLine(s + " '" + dbDir + "' '" + filePath + "'");
+                 return retrieveIndex(s + " '" + conv(dbDir) + "' '" + conv(filePath) + "'");
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 4262 
 public class Client {
+Line 5046 
 public class Client {
          addDbInstruments(ScanMode mode, String dbDir, String fsDir, boolean background)
                                          throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 return addDbInstruments(mode, dbDir, fsDir, background, false);
+         }
+         /**
+          * Adds the instruments in the specified file system directory
+          * to the specified instruments database directory.
+          * @param mode Determines the scanning mode. If RECURSIVE is
+          * specified, all supported instruments in the specified file system
+          * direcotry will be added to the specified instruments database
+          * directory, including the instruments in subdirectories
+          * of the supplied directory. If NON_RECURSIVE is specified,
+          * the instruments in the subdirectories will not be processed.
+          * If FLAT is specified, all supported instruments in the specified
+          * file system direcotry will be added, including the instruments in
+          * subdirectories of the supplied directory, but the respective
+          * subdirectory structure will not be recreated in the instruments
+          * database and all instruments will be added directly in the
+          * specified database directory.
+          * @param dbDir The absolute path name of the database directory
+          * in which the supported instruments will be added.
+          * @param fsDir The absolute path name of the file system directory.
+          * @param background If <code>true</code>, the scan will be done
+          * in background and this method may return before the job is finished.
+          * @param insDir If <code>true</code> a drieectory is created for each
+          * instrument file.
+          * @return If <code>background</code> is <code>true</code>, the ID
+          * of the scan job.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #addInstrumentsDbListener
+          */
+         public synchronized int
+         addDbInstruments(ScanMode mode, String dbDir, String fsDir, boolean background, boolean insDir)
+                                         throws IOException, LSException, LscpException
+         {
                  StringBuffer sb = new StringBuffer("ADD DB_INSTRUMENTS");
                  if(background) sb.append(" NON_MODAL");
-Line 4277 
 public class Client {
+Line 5096 
 public class Client {
                                  sb.append(" FLAT");
                                  break;
                  }
+                 if(insDir)
+                         sb.append(" FILE_AS_DIR");
-                 sb.append(" '").append(dbDir).append("' '");
+                 sb.append(" '").append(conv(dbDir)).append("' '");
-                 sb.append(fsDir).append("'");
+                 sb.append(conv(fsDir)).append("'");
-                 out.writeLine(sb.toString());
+                 return retrieveIndex(sb.toString());
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
           * Removes the specified instrument from the instruments database.
           * @param instr The absolute path name of the instrument to remove.
-Line 4295 
 public class Client {
+Line 5112 
 public class Client {
           * @throws LSException If the removing of the instrument failed.
           */
          public synchronized void
-         removeDbInstrument(String instr) throws IOException, LscpException, LSException {
+         removeDbInstrument(String instr) throws IOException, LscpException, LSException
+         { retrieveIndex("REMOVE DB_INSTRUMENT '" + conv(instr) + "'"); }
-                 verifyConnection();
-                 out.writeLine("REMOVE DB_INSTRUMENT '" + instr + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Removes the specified instruments from the instruments database.
-Line 4315 
 public class Client {
+Line 5126 
 public class Client {
          removeDbInstruments(String[] instrs) throws IOException, LscpException, LSException {
                  verifyConnection();
                  for(String s : instrs) {
-                         out.writeLine("REMOVE DB_INSTRUMENT '" + s + "'");
+                         out.writeLine("REMOVE DB_INSTRUMENT '" + conv(s) + "'");
                  }
                  if(getPrintOnlyMode()) return;
-Line 4353 
 public class Client {
+Line 5164 
 public class Client {
                  String s;
                  if(recursive) s = "GET DB_INSTRUMENTS RECURSIVE '";
                  else s = "GET DB_INSTRUMENTS '";
-                 out.writeLine(s + dir + "'");
+                 out.writeLine(s + conv(dir) + "'");
                  if(getPrintOnlyMode()) return -1;
                  s = getSingleLineResultSet().getResult();
-Line 4372 
 public class Client {
+Line 5183 
 public class Client {
          public synchronized String[]
          getDbInstrumentNames(String dir) throws IOException, LscpException, LSException {
                  verifyConnection();
-                 out.writeLine("LIST DB_INSTRUMENTS '" + dir + "'");
+                 out.writeLine("LIST DB_INSTRUMENTS '" + conv(dir) + "'");
                  if(getPrintOnlyMode()) return null;
                  String[] names = parseEscapedStringList(getSingleLineResultSet().getResult());
-Line 4393 
 public class Client {
+Line 5204 
 public class Client {
           */
          public synchronized DbInstrumentInfo
          getDbInstrumentInfo(String instr) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 DbInstrumentInfo info = new DbInstrumentInfo();
-                 out.writeLine("GET DB_INSTRUMENT INFO '" + instr + "'");
+                 if(!retrieveInfo("GET DB_INSTRUMENT INFO '" + conv(instr) + "'", info)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 DbInstrumentInfo info = new DbInstrumentInfo(rs.getMultiLineResult());
                  String s = getParentDirectory(instr);
                  if(s != null) info.setDirectoryPath(s);
                  s = getFileName(instr);
-Line 4423 
 public class Client {
+Line 5231 
 public class Client {
                  DbInstrumentInfo[] infoS = new DbInstrumentInfo[instrS.length];
                  for(int i = 0; i < instrS.length; i++) {
-                         infoS[i] = getDbInstrumentInfo(dir + toEscapedFileName(instrS[i]));
+                         infoS[i] = getDbInstrumentInfo(conv(dir) + toEscapedFsEntry(instrS[i]));
                  }
                  return infoS;
          }
-Line 4442 
 public class Client {
+Line 5250 
 public class Client {
                  String[] instrS = getDbInstrumentNames(dir);
                  if(instrS.length == 0) return new DbInstrumentInfo[0];
-                 if(dir.charAt(dir.length() - 1) != '/') dir += "/";
+                 if(dir.charAt(dir.length() - 1) != '/') dir += "/"; FIXME:
                  for(int i = 0; i < instrS.length; i++) {
-                         out.writeLine("GET DB_INSTRUMENT INFO '" + dir + instrS[i] + "'");
+                         out.writeLine("GET DB_INSTRUMENT INFO '" + conv(dir) + instrS[i] + "'");
                  }
                  if(getPrintOnlyMode()) return null;
-Line 4488 
 public class Client {
+Line 5296 
 public class Client {
           */
          public synchronized void
          renameDbInstrument(String instr, String name)
-                                 throws IOException, LSException, LscpException {
+                                 throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
+                 name = toEscapedText(name);
-                 name = toEscapedString(name);
+                 retrieveIndex("SET DB_INSTRUMENT NAME '" + conv(instr) + "' '" + conv(name) + "'");
-                 out.writeLine("SET DB_INSTRUMENT NAME '" + instr + "' '" + name + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 4507 
 public class Client {
+Line 5311 
 public class Client {
           * @throws LscpException If LSCP protocol corruption occurs.
           */
          public synchronized void
-         moveDbInstrument(String instr, String dst) throws IOException, LSException, LscpException {
+         moveDbInstrument(String instr, String dst) throws IOException, LSException, LscpException
-                 verifyConnection();
+         { retrieveIndex("MOVE DB_INSTRUMENT '" + conv(instr) + "' '" + conv(dst) + "'"); }
-                 out.writeLine("MOVE DB_INSTRUMENT '" + instr + "' '" + dst + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Moves the specified instruments into the specified location.
-Line 4527 
 public class Client {
+Line 5326 
 public class Client {
          moveDbInstruments(String[] instrs, String dst) throws IOException, LSException, LscpException {
                  verifyConnection();
                  for(String s : instrs) {
-                         out.writeLine("MOVE DB_INSTRUMENT '" + s + "' '" + dst + "'");
+                         out.writeLine("MOVE DB_INSTRUMENT '" + conv(s) + "' '" + conv(dst) + "'");
                  }
                  if(getPrintOnlyMode()) return;
-Line 4543 
 public class Client {
+Line 5342 
 public class Client {
           * @throws LscpException If LSCP protocol corruption occurs.
           */
          public synchronized void
-         copyDbInstrument(String instr, String dst) throws IOException, LSException, LscpException {
+         copyDbInstrument(String instr, String dst) throws IOException, LSException, LscpException
-                 verifyConnection();
+         { retrieveIndex("COPY DB_INSTRUMENT '" + conv(instr) + "' '" + conv(dst) + "'"); }
-                 out.writeLine("COPY DB_INSTRUMENT '" + instr + "' '" + dst + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Copies the specified instruments into the specified location.
-Line 4563 
 public class Client {
+Line 5357 
 public class Client {
          copyDbInstruments(String[] instrs, String dst) throws IOException, LSException, LscpException {
                  verifyConnection();
                  for(String s : instrs) {
-                         out.writeLine("COPY DB_INSTRUMENT '" + s + "' '" + dst + "'");
+                         out.writeLine("COPY DB_INSTRUMENT '" + conv(s) + "' '" + conv(dst) + "'");
                  }
                  if(getPrintOnlyMode()) return;
-Line 4580 
 public class Client {
+Line 5374 
 public class Client {
           */
          public synchronized void
          setDbInstrumentDescription(String instr, String desc)
-                                 throws IOException, LSException, LscpException {
+                                 throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
+                 desc = toEscapedText(desc);
-                 desc = toEscapedString(desc);
+                 retrieveIndex("SET DB_INSTRUMENT DESCRIPTION '" + conv(instr) + "' '" + desc + "'");
-                 out.writeLine("SET DB_INSTRUMENT DESCRIPTION '" + instr + "' '" + desc + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
+          * Substitutes all occurrences of the instrument file
+          * <code>oldPath</code> in the database, with <code>newPath</code>.
+          * @param oldPath The absolute path name of the instrument file to substitute.
+          * @param newPath The new absolute path name.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         setDbInstrumentFilePath(String oldPath, String newPath)
+                                 throws IOException, LSException, LscpException
+         { retrieveIndex("SET DB_INSTRUMENT FILE_PATH '" + conv(oldPath) + "' '" + conv(newPath) + "'"); }
+         /**
           * Finds all directories in the specified directory
           * that corresponds to the specified search criterias.
           * @param dir The absolute path name of the directory to search.
-Line 4628 
 public class Client {
+Line 5432 
 public class Client {
                  StringBuffer sb = new StringBuffer();
                  sb.append("FIND DB_INSTRUMENT_DIRECTORIES");
                  if(nonRecursive) sb.append(" NON_RECURSIVE");
-                 sb.append(" '").append(dir).append("'");
+                 sb.append(" '").append(conv(dir)).append("'");
                  if(query.name != null && query.name.length() > 0) {
-                         sb.append(" NAME='").append(toEscapedString(query.name)).append("'");
+                         sb.append(" NAME='").append(toEscapedText(query.name)).append("'");
                  }
                  String s = query.getCreatedAfter();
-Line 4656 
 public class Client {
+Line 5460 
 public class Client {
                  if(query.description != null && query.description.length() > 0) {
                          sb.append(" DESCRIPTION='");
-                         sb.append(toEscapedString(query.description)).append("'");
+                         sb.append(toEscapedText(query.description)).append("'");
                  }
                  out.writeLine(sb.toString());
-Line 4709 
 public class Client {
+Line 5513 
 public class Client {
                  StringBuffer sb = new StringBuffer();
                  sb.append("FIND DB_INSTRUMENTS");
                  if(nonRecursive) sb.append(" NON_RECURSIVE");
-                 sb.append(" '").append(dir).append("'");
+                 sb.append(" '").append(conv(dir)).append("'");
                  if(query.name != null && query.name.length() > 0) {
-                         sb.append(" NAME='").append(toEscapedString(query.name)).append("'");
+                         sb.append(" NAME='").append(toEscapedText(query.name)).append("'");
                  }
                  if(query.formatFamilies.size() > 0) {
-Line 4753 
 public class Client {
+Line 5557 
 public class Client {
                  if(query.description != null && query.description.length() > 0) {
                          sb.append(" DESCRIPTION='");
-                         sb.append(toEscapedString(query.description)).append("'");
+                         sb.append(toEscapedText(query.description)).append("'");
                  }
                  if(query.instrumentType != DbSearchQuery.InstrumentType.BOTH) {
-Line 4766 
 public class Client {
+Line 5570 
 public class Client {
                  }
                  if(query.product != null && query.product.length() > 0) {
-                         sb.append(" PRODUCT='").append(toEscapedString(query.product)).append("'");
+                         sb.append(" PRODUCT='").append(toEscapedText(query.product)).append("'");
                  }
                  if(query.artists != null && query.artists.length() > 0) {
-                         sb.append(" ARTISTS='").append(toEscapedString(query.artists)).append("'");
+                         sb.append(" ARTISTS='").append(toEscapedText(query.artists)).append("'");
                  }
                  if(query.keywords != null && query.keywords.length() > 0) {
                          sb.append(" KEYWORDS='");
-                         sb.append(toEscapedString(query.keywords)).append("'");
+                         sb.append(toEscapedText(query.keywords)).append("'");
                  }
                  out.writeLine(sb.toString());
-Line 4791 
 public class Client {
+Line 5595 
 public class Client {
          }
          /**
+          * Returns a list of all instrument files in the database
+          * that that don't exist in the filesystem.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If other error occurs.
+          */
+         public synchronized String[]
+         findLostDbInstrumentFiles() throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine("FIND LOST DB_INSTRUMENT_FILES");
+                 if(getPrintOnlyMode()) return null;
+                 return parseEscapedStringList(getSingleLineResultSet().getResult());
+         }
+         /**
           * Gets status information about the specified job.
           * @param jobId The ID of the job.
           * @return A <code>ScanJobInfo</code> instance providing information
-Line 4801 
 public class Client {
+Line 5622 
 public class Client {
           */
          public synchronized ScanJobInfo
          getDbInstrumentsJobInfo(int jobId) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 ScanJobInfo info = new ScanJobInfo();
-                 out.writeLine("GET DB_INSTRUMENTS_JOB INFO " + String.valueOf(jobId));
+                 if(!retrieveInfo("GET DB_INSTRUMENTS_JOB INFO " + String.valueOf(jobId), info)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 ScanJobInfo info = new ScanJobInfo(rs.getMultiLineResult());
                  return info;
          }
-Line 4819 
 public class Client {
+Line 5636 
 public class Client {
           * @throws LSException If the formatting of the instruments database failed.
           */
          public synchronized void
-         formatInstrumentsDb() throws IOException, LscpException, LSException {
+         formatInstrumentsDb() throws IOException, LscpException, LSException
-                 verifyConnection();
+         { retrieveIndex("FORMAT INSTRUMENTS_DB"); }
-                 out.writeLine("FORMAT INSTRUMENTS_DB");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
-          * Resets the specified sampler channel.
+          * Resets the whole sampler.
           *
-          * @param samplerChn The sampler channel number.
-          *
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
-          * @throws LSException If <code>samplerChn</code> is not a valid channel number or if
-          * there is no engine assigned yet to the specified sampler channel.
-          * @see #getSamplerChannels
           */
          public synchronized void
-         resetChannel(int samplerChn) throws IOException, LscpException, LSException {
+         resetSampler() throws IOException, LscpException {
                  verifyConnection();
-                 out.writeLine("RESET CHANNEL " + samplerChn);
+                 out.writeLine("RESET");
                  if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
+                 try { ResultSet rs = getEmptyResultSet(); }
+                 catch(LSException x) { getLogger().warning(x.getMessage()); }
          }
          /**
-          * Resets the whole sampler.
+          * Gets the current number of all active streams.
-          *
+          * @return The current number of all active streams or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
           */
-         public synchronized void
+         public synchronized int
-         resetSampler() throws IOException, LscpException {
+         getTotalStreamCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET TOTAL_STREAM_COUNT");
-                 out.writeLine("RESET");
-                 if(getPrintOnlyMode()) return;
-                 try { ResultSet rs = getEmptyResultSet(); }
-                 catch(LSException x) { getLogger().warning(x.getMessage()); }
          }
          /**
           * Gets the current number of all active voices.
-          * @return The current number of all active voices.
+          * @return The current number of all active voices or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getTotalVoiceCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET TOTAL_VOICE_COUNT");
-                 out.writeLine("GET TOTAL_VOICE_COUNT");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
           * Gets the maximum number of active voices.
-          * @return The maximum number of active voices.
+          * @return The maximum number of active voices or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getTotalVoiceCountMax() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET TOTAL_VOICE_COUNT_MAX");
-                 out.writeLine("GET TOTAL_VOICE_COUNT_MAX");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 4909 
 public class Client {
+Line 5703 
 public class Client {
           */
          public synchronized ServerInfo
          getServerInfo() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 ServerInfo info = new ServerInfo();
-                 out.writeLine("GET SERVER INFO");
+                 if(!retrieveInfo("GET SERVER INFO", info)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
+                 return info;
-                 return new ServerInfo(rs.getMultiLineResult());
          }
          /**
-          * Gets the golobal volume of the sampler.
+          * Gets the global volume of the sampler.
-          * @return The golobal volume of the sampler.
+          * @return The global volume of the sampler.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
-Line 4943 
 public class Client {
+Line 5735 
 public class Client {
           * @see #getVolume
           */
          public synchronized void
-         setVolume(float volume) throws IOException, LscpException, LSException {
+         setVolume(float volume) throws IOException, LscpException, LSException
+         { retrieveIndex("SET VOLUME " + volume); }
-                 verifyConnection();
+         /**
-                 out.writeLine("SET VOLUME " + volume);
+          * Gets the global sampler-wide limit of maximum voices.
-                 if(getPrintOnlyMode()) return;
+          * @return The global sampler-wide limit of maximum voices or -1 if in "print only" mode.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getGlobalVoiceLimit() throws IOException, LscpException, LSException {
+                 return retrieveInt("GET VOICES");
+         }
+         /**
+          * Sets the global sampler-wide limit of maximum voices.
+          * @param maxVoices The new global limit of maximum voices.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #getVolume
+          */
+         public synchronized void
+         setGlobalVoiceLimit(int maxVoices) throws IOException, LscpException, LSException
+         { retrieveIndex("SET VOICES " + maxVoices); }
+         /**
+          * Gets the global sampler-wide limit of maximum disk streams.
+          * @return The global sampler-wide limit of maximum disk streams
+          *  or -1 if in "print only" mode.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getGlobalStreamLimit() throws IOException, LscpException, LSException {
+                 return retrieveInt("GET STREAMS");
+         }
+         /**
+          * Sets the global sampler-wide limit for maximum disk streams.
+          * @param maxVoices The new global limit of maximum disk streams.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #getVolume
+          */
+         public synchronized void
+         setGlobalStreamLimit(int maxStreams) throws IOException, LscpException, LSException
+         { retrieveIndex("SET STREAMS " + maxStreams); }
+         /**
+          * Gets the number of instruments in the specified instrument file.
+          * @param filename The absolute path name of the instrument file.
+          * @return The number of instruments in the specified instrument file
+          *  or -1 if in "print only" mode.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the file is not found, or other error occur.
+          */
+         public synchronized int
+         getFileInstrumentCount(String filename) throws IOException, LscpException, LSException {
+                 return retrieveInt("GET FILE INSTRUMENTS '" + conv(filename) +"'");
+         }
+         /**
+          * Gets information about the instrument with index
+          * <code>instrIdx</code> in the specified instrument file.
+          * @param filename The absolute path name of the instrument file.
+          * @param instrIdx The index of the instrument in the specified instrument file.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If failed to retrieve information.
+          */
+         public synchronized Instrument
+         getFileInstrumentInfo(String filename, int instrIdx)
+                                 throws IOException, LscpException, LSException {
+                 FileInstrument instr = new FileInstrument();
+                 String cmd = "GET FILE INSTRUMENT INFO '" + conv(filename) + "' " + String.valueOf(instrIdx);
+                 if(!retrieveInfo(cmd, instr)) return null;
-                 ResultSet rs = getEmptyResultSet();
+                 return instr;
+         }
+         /**
+          * Gets the list of instruments in the specified instrument file.
+          * @param filename The absolute path name of the instrument file.
+          * @return An <code>Instrument</code> array providing
+          * information about all instruments in the specified instrument file.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified file name is invalid.
+          */
+         public synchronized Instrument[]
+         getFileInstruments(String filename) throws IOException, LscpException, LSException {
+                 int l = getFileInstrumentCount(filename);
+                 if(l < 0) return null;
+                 Instrument[] instrS = new FileInstrument[l];
+                 for(int i = 0; i < instrS.length; i++) {
+                         instrS[i] = getFileInstrumentInfo(filename, i);
+                 }
+                 return instrS;
+         }
+         private static class FileInstrument extends AbstractInstrument {
+                 FileInstrument() { }
+                 public String
+                 getEngine() {
+                         // TODO: engine lookup?
+                         return getFormatFamily();
+                 }
+                 @Override
+                 public boolean
+                 parse(String s) throws LscpException {
+                         if(s.startsWith("PRODUCT: ") || s.startsWith("ARTISTS: ")) return true;
+                         return super.parse(s);
+                 }
          }
          private void
-Line 4973 
 public class Client {
+Line 5880 
 public class Client {
                          throw new LSException(0, s, details);
                  }
          }
+         /**
+          * Retrieves a list of integers.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         private Integer[]
+         getIntegerList(String lscpCmd) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine(lscpCmd);
+                 if(getPrintOnlyMode()) return null;
+                 return parseIntList(getSingleLineResultSet().getResult());
+         }
+         private boolean
+         retrieveInfo(String lscpCmd, Parseable p) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine(lscpCmd);
+                 if(getPrintOnlyMode()) return false;
+                 ResultSet rs = getMultiLineResultSet();
+                 for(String s : rs.getMultiLineResult()) {
+                         if(!p.parse(s)) Client.getLogger().info(LscpI18n.getLogMsg("unknownLine", s));
+                 }
+                 return true;
+         }
+         private int
+         retrieveInt(String lscpCmd) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine(lscpCmd);
+                 if(getPrintOnlyMode()) return -1;
+                 String s = getSingleLineResultSet().getResult();
+                 return parseInt(s);
+         }
+         private int
+         retrieveIndex(String lscpCmd) throws IOException, LSException, LscpException {
+                 verifyConnection();
+                 out.writeLine(lscpCmd);
+                 if(getPrintOnlyMode()) return -1;
+                 return getEmptyResultSet().getIndex();
+         }
          /**
           * Returns the logger for this library.

 Legend:



Removed from v.1421
 


changed lines


 
Added in v.2242
 Legend:



Removed from v.1421
 


changed lines


 
Added in v.2242
-Removed from v.1421
+Added in v.2242

	ViewVC Help
Powered by ViewVC