* Copyright (C) 2002-2003 Fhg Fokus
 * This file is part of SEMS, a free SIP media server.
 * SEMS is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version. This program is released under
 * the GPL with the additional exemption that compiling, linking,
 * and/or using OpenSSL is allowed.
 * For a license to use the SEMS software under conditions
 * other than those described here, or to purchase support for this
 * software, please contact iptel.org by e-mail at the following addresses:
 *    info@iptel.org
 * SEMS is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License 
 * along with this program; if not, write to the Free Software 
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
/** @file AmMediaProcessor.h */
#ifndef _AmMediaProcessor_h_
#define _AmMediaProcessor_h_

#include "AmEventQueue.h"
#include "amci/amci.h" // AUDIO_BUFFER_SIZE
class AmSession;

#include <set>
using std::set;
#include <map>

struct SchedRequest;

 * \brief Media processing thread
 * This class implements a media processing thread.
 * It processes the media and triggers the sending of RTP
 * of all sessions added to it.
class AmMediaProcessorThread :
  public AmThread,
  public AmEventHandler
  AmEventQueue    events;
  unsigned char   buffer[AUDIO_BUFFER_SIZE];
  set<AmSession*> sessions;
  void processAudio(unsigned int ts);
   * Process pending DTMF events
  void processDtmfEvents();

  // AmThread interface
  void run();
  void on_stop();
  AmSharedVar<bool> stop_requested;
  // AmEventHandler interface
  void process(AmEvent* e);

  inline void postRequest(SchedRequest* sr);
  unsigned int getLoad();

 * \brief Media processing thread manager
 * This class implements the manager that assigns and removes 
 * the Sessions to the various \ref MediaProcessorThreads, 
 * according to their call group. This class contains the API 
 * for the MediaProcessor.
class AmMediaProcessor
  static AmMediaProcessor* _instance;

  unsigned int num_threads; 
  AmMediaProcessorThread**  threads;
  std::map<string, unsigned int> callgroup2thread;
  std::multimap<string, AmSession*> callgroupmembers;
  std::map<AmSession*, string> session2callgroup;
  AmMutex group_mut;

  void removeFromProcessor(AmSession* s, unsigned int r_type);
   * InsertSession     : inserts the session to the processor
   * RemoveSession     : remove the session from the processor
   * SoftRemoveSession : remove the session from the processor but leave it attached
   * ClearSession      : remove the session from processor and clear audio
  enum { InsertSession, RemoveSession, SoftRemoveSession, ClearSession };

  static AmMediaProcessor* instance();

  void init();
  /** Add session s to processor */
  void addSession(AmSession* s, const string& callgroup);
  /** Remove session s from processor */
  void removeSession(AmSession* s);
  /** Remove session s from processor and clear its audio */
  void clearSession(AmSession* s);
  /** Change the callgroup of a session (use with caution) */
  void changeCallgroup(AmSession* s, 
		       const string& new_callgroup);

  void stop();
  static void dispose();