recording.h

Go to the documentation of this file.

/*
 * audiorecord.h
 *
 * OPAL audio record manager
 *
 * Open Phone Abstraction Library (OPAL)
 * Formally known as the Open H323 project.
 *
 * Copyright (C) 2007 Post Increment
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Open Phone Abstraction Library.
 *
 * The Initial Developer of the Original Code is Post Increment
 *
 * Contributor(s): ______________________________________.
 *
 * $Revision: 32351 $
 * $Author: rjongbloed $
 * $Date: 2014-07-14 14:36:59 +1000 (Mon, 14 Jul 2014) $
 */


#ifndef OPAL_OPAL_AUDIORECORD_H
#define OPAL_OPAL_AUDIORECORD_H


#include <opal_config.h>

#if OPAL_HAS_MIXER

class OpalMediaFormat;
class RTP_DataFrame;


class OpalRecordManager
{
  public:
    typedef PFactory<OpalRecordManager, PCaselessString> Factory;

#if OPAL_VIDEO
    enum VideoMode {
      eSideBySideLetterbox, 
      eSideBySideScaled,    
      eStackedPillarbox,    
      eStackedScaled,       
      eSeparateStreams,     
      NumVideoMixingModes
    };
#endif

    // Options for recording calls.
    struct Options {
      bool      m_stereo;       
      PString   m_audioFormat;  
#if OPAL_VIDEO
      VideoMode m_videoMixing;  
      PString   m_videoFormat;  
      unsigned  m_videoWidth;   
      unsigned  m_videoHeight;  
      unsigned  m_videoRate;    
#endif

      Options(
        bool         stereo = true,
#if OPAL_VIDEO
        VideoMode    videoMixing = eSideBySideLetterbox,
#endif
        const char * audioFormat = NULL
#if OPAL_VIDEO
        ,
        const char * videoFormat = NULL,
        unsigned width = PVideoFrameInfo::CIFWidth,
        unsigned height = PVideoFrameInfo::CIFHeight,
        unsigned rate = 15
#endif
      ) : m_stereo(stereo)
        , m_audioFormat(audioFormat)
#if OPAL_VIDEO
        , m_videoMixing(videoMixing)
        , m_videoFormat(videoFormat)
        , m_videoWidth(width)
        , m_videoHeight(height)
        , m_videoRate(rate)
#endif
      {
      }
    };

    virtual ~OpalRecordManager() { }

    bool Open(const PFilePath & fn)
    {
      return OpenFile(fn);
    }

    bool Open(const PFilePath & fn, bool mono) // For backward compatibility
    {
      m_options.m_stereo = !mono;
      return OpenFile(fn);
    }

    bool Open(const PFilePath & fn, const Options & options)
    {
      m_options = options;
      return Open(fn);
    }

    virtual bool IsOpen() const = 0;

    virtual bool Close() = 0;

    virtual bool OpenStream(
      const PString & strmId,         
      const OpalMediaFormat & format  
    ) = 0;

    virtual bool CloseStream(
      const PString & strmId  
    ) = 0;

    virtual bool WriteAudio(
      const PString & strmId,     
      const RTP_DataFrame & rtp   
    ) = 0;

#if OPAL_VIDEO

    virtual bool WriteVideo(
      const PString & strmId,     
      const RTP_DataFrame & rtp   
    ) = 0;
#endif

    const Options & GetOptions() const { return m_options; }

    void SetOptions(const Options & options)
    {
      m_options = options;
    }

  protected:
    virtual bool OpenFile(const PFilePath & fn) = 0;

    Options m_options;
};

// Force linking of modules

#ifdef P_WAVFILE
PFACTORY_LOAD(OpalWAVRecordManager);
#endif

#if OPAL_VIDEO && P_VFW_CAPTURE
PFACTORY_LOAD(OpalAVIRecordManager);
#endif

#endif // OPAL_HAS_MIXER


#endif // OPAL_OPAL_AUDIORECORD_H