Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > b908fbf6412c51882b2aebf8342c549f > files > 83

libecasound-devel-2.5.2-2mdv2009.1.i586.rpm

#ifndef INCLUDED_ECA_CONTROL_DUMP_H
#define INCLUDED_ECA_CONTROL_DUMP_H

#include <iostream>
#include <fstream>

class ECA_CONTROL;

/**
 * Class for dumping status information to a standard output stream.
 * @author Kai Vehmanen
 */
class ECA_CONTROL_DUMP {

 public:

  // --
  // Global info
  // --

  /**
   * Dumps engine status - 'running', 'stopped', 'finished' or 'notready'.
   */
  void dump_status(void);

  /**
   * Dumps the global position. Printed in seconds using a floating-point 
   * representation.
   */
  void dump_position(void);

  /**
   * Dumps the overall processing length. Printed in seconds using a floating-point 
   * representation.
   */
  void dump_length(void);

  // --
  // Chainsetups and chains
  // --

  /**
   * Dumps status std::string for the currently selected chainsetup - 'connected', 
   * 'selected' or an empty std::string.
   */
  void dump_chainsetup_status(void);

  /**
   * Dumps the name of currently selected chain.
   */
  void dump_selected_chain(void);

  // --
  // Audio objects
  // --

  /**
   * Dumps label of currently selected audio input. If no
   * input is selected, dumps an empty std::string.
   */
  void dump_selected_audio_input(void);

  /**
   * Dumps position of currently selected audio input. 
   * Printed in seconds, using a floating-point representation.
   */
  void dump_audio_input_position(void);

  /**
   * Dumps length of currently selected audio input. 
   * Printed in seconds, using a floating-point representation.
   */
  void dump_audio_input_length(void);

  /**
   * Dumps audio input state info. Either 'open' or 'closed'.
   */
  void dump_audio_input_open_state(void);

  /**
   * Dumps label of currently selected audio output. If no
   * output is selected, dumps an empty std::string.
   */
  void dump_selected_audio_output(void);

  /**
   * Dumps position of currently selected audio outputs. 
   * Printed in seconds, using a floating-point representation.
   */
  void dump_audio_output_position(void);

  /**
   * Dumps length of currently selected audio output. 
   * Printed in seconds, using a floating-point representation.
   */
  void dump_audio_output_length(void);

  /**
   * Dumps audio output state info. Either 'open' or 'closed'.
   */
  void dump_audio_output_open_state(void);

  // --
  // Chain operators
  // --

  /**
   * Dumps chain operator parameter value
   *
   * @param chainop operator index 1...n
   * @param param parameter index 1...n
   */
  void dump_chain_operator_value(int chainop, int param);

  /** 
   * Set target stream for dumping.
   */
  void set_dump_target(std::ostream* target) { dostream_repp = target; internal_rep = false; }

  /** 
   * Set target stream for dumping.
   */
  void set_dump_target(const std::string& filename) { dostream_repp = new std::ofstream(filename.c_str()); internal_rep = true; }

  /**
   * Class constructor
   */ 
  ECA_CONTROL_DUMP (ECA_CONTROL* ctrl) : ctrl_repp(ctrl), dostream_repp(&std::cout), internal_rep(false) { }

  /**
   * Virtual destructor
   */
  ~ECA_CONTROL_DUMP (void) { if (internal_rep == true) delete dostream_repp; }

 private:

  ECA_CONTROL* ctrl_repp;
  std::ostream* dostream_repp;
  bool internal_rep;

  void dump(const std::string& key, const std::string& value) { *dostream_repp << key << " " << value << std::endl; }
};

#endif