include/dynacodec.h

   1 /*
   2  * dynacodec.h
   3  *
   4  * Dynamic codec loading
   5  *
   6  * Open H323 Library
   7  *
   8  * Copyright (c) 2003 Equivalence Pty. Ltd.
   9  *
  10  * The contents of this file are subject to the Mozilla Public License
  11  * Version 1.0 (the "License"); you may not use this file except in
  12  * compliance with the License. You may obtain a copy of the License at
  13  * http://www.mozilla.org/MPL/
  14  *
  15  * Software distributed under the License is distributed on an "AS IS"
  16  * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
  17  * the License for the specific language governing rights and limitations
  18  * under the License.
  19  *
  20  * The Original Code is Open H323 Library.
  21  *
  22  * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
  23  *
  24  * Contributor(s): ______________________________________.
  25  *
  26  * $Log$
  27  * Revision 1.2  2003/04/30 04:57:13  craigs
  28  * Changed interface to DLL codec to improve Opal compatibility
  29  *
  30  * Revision 1.1  2003/04/27 23:48:24  craigs
  31  * Initial version
  32  *
  33  */
  34
  35 #ifndef _OPALDYNACODEC
  36 #define _OPALDYNACODEC
  37
  38 extern "C" {
  39 #include "dllcodec.h"
  40 };
  41
  42 #include "h323caps.h"
  43
  44 /////////////////////////////////////////////////////////////////////////////
  45
  46 class OpalDLLCodecRec;
  47
  48 class OpalDynaCodecDLL : public PDynaLink
  49 {
  50   public:
  51     PCLASSINFO(OpalDynaCodecDLL, PDynaLink);
  52
  53     OpalDynaCodecDLL(const PFilePath & codec);
  54     BOOL Load();
  55
  56     OpalDLLCodecInfo * EnumerateCodecs(unsigned * count);
  57
  58     static BOOL LoadCodecs();
  59     static BOOL LoadCodecs(const PDirectory & dir);
  60     static BOOL LoadCodec(const PFilePath & file);
  61
  62     static PINDEX AddAudioCapabilities(H323EndPoint & ep,
  63                                        PINDEX descriptorNum,
  64                                        PINDEX simultaneousNum,
  65                                        H323Capabilities & capabilities);
  66
  67     static PINDEX AddVideoCapabilities(H323EndPoint & ep,
  68                                        PINDEX descriptorNum,
  69                                        PINDEX simultaneousNum,
  70                                        H323Capabilities & capabilities);
  71
  72     static PINDEX AddCapabilities(H323EndPoint & ep,
  73                                   PINDEX descriptorNum,
  74                                   PINDEX simultaneousNum,
  75                                   H323Capabilities & capabilities,
  76                                   const PString & type);
  77
  78     static PDirectory defaultCodecDir;
  79
  80   protected:
  81     OpalDLLCodecInfo * (*EnumerateCodecsFn)(unsigned apiVersion, unsigned * count);
  82     static PMutex mutex;
  83     static BOOL inited;
  84     int referenceCount;
  85 };
  86
  87 /////////////////////////////////////////////////////////////////////////////
  88
  89 class OpalDLLCodecRec : public PObject {
  90   PCLASSINFO(OpalDLLCodecRec, PObject);
  91   public:
  92     OpalDLLCodecRec(OpalDynaCodecDLL & _encoder,
  93                const PStringToString & _attributes,
  94               const OpalDLLCodecInfo & _encoderCodeInfo,
  95                      OpalMediaFormat * _mediaFormat);
  96
  97     void * CreateContext() const;
  98     void DestroyContext(void * context) const;
  99
 100     H323Capability * CreateCapability(H323EndPoint & ep) const;
 101
 102     void SetParameter(const PString & attribute, const PString & value) const;
 103     PString GetParameter(const PString & attribute, const char * defValue = NULL) const;
 104
 105     OpalDynaCodecDLL & encoder;
 106     PStringToString    attributes;
 107     OpalDLLCodecInfo   info;
 108
 109     OpalMediaFormat  * mediaFormat;
 110     //H323Capability   * capability;
 111     //PString            h323Name;
 112 };
 113
 114 /////////////////////////////////////////////////////////////////////////////
 115
 116 class OpalDynaAudioCodec : public H323FramedAudioCodec
 117 {
 118   PCLASSINFO(OpalDynaAudioCodec, H323FramedAudioCodec)
 119
 120   public:
 121     OpalDynaAudioCodec(const OpalDLLCodecRec & _info, Direction direction);
 122     ~OpalDynaAudioCodec();
 123     virtual BOOL EncodeFrame(BYTE * buffer, unsigned & length);
 124     virtual BOOL DecodeFrame(const BYTE * buffer, unsigned length, unsigned & written);
 125
 126   protected:
 127     const OpalDLLCodecRec & info;
 128     void * context;
 129     unsigned samplesPerFrame;
 130     unsigned bytesPerFrame;
 131 };
 132
 133 /////////////////////////////////////////////////////////////////////////////
 134
 135 class OpalDynaCodecRegistration : public H323CapabilityRegistration
 136 {
 137   PCLASSINFO(OpalDynaCodecRegistration, H323CapabilityRegistration);
 138   public:
 139     OpalDynaCodecRegistration(const PString & name,
 140                               OpalDLLCodecRec * _encoderInfo,
 141                               OpalDLLCodecRec * _decoderInfo,
 142                               OpalMediaFormat * _mediaFormat);
 143
 144     H323Capability * Create(H323EndPoint & ep) const;
 145
 146     friend class OpalDynaCodecDLL;
 147
 148   protected:
 149     OpalDLLCodecRec * encoderInfo;
 150     OpalDLLCodecRec * decoderInfo;
 151     OpalMediaFormat * mediaFormat;
 152 };
 153
 154 /////////////////////////////////////////////////////////////////////////////
 155
 156 class OpalDynaCodecNonStandardAudioCapability : public H323NonStandardAudioCapability
 157 {
 158   PCLASSINFO(OpalDynaCodecNonStandardAudioCapability, H323NonStandardAudioCapability);
 159
 160   public:
 161     OpalDynaCodecNonStandardAudioCapability(
 162       const OpalDLLCodecRec & _info,
 163       H323EndPoint & _endpoint,
 164       unsigned maxPacketSize,         /// Maximum size of an audio packet in frames
 165       unsigned desiredPacketSize,     /// Desired transmit size of an audio packet in frames
 166       BYTE country,                   /// t35 information
 167       BYTE extension,                 /// t35 information
 168       WORD maufacturer,               /// t35 information
 169       const BYTE * nonstdHeader,      /// nonstandard header
 170       PINDEX nonstdHeaderLen);
 171
 172     virtual PObject * Clone() const;
 173     virtual H323Codec * CreateCodec(H323Codec::Direction direction) const;
 174     virtual PString GetFormatName() const;
 175
 176   protected:
 177     const OpalDLLCodecRec & info;
 178     H323EndPoint & endpoint;
 179 };
 180
 181 /////////////////////////////////////////////////////////////////////////////
 182
 183 class OpalDynaNonStandardAudioCodec : public OpalDynaAudioCodec
 184 {
 185   PCLASSINFO(OpalDynaNonStandardAudioCodec, OpalDynaAudioCodec)
 186
 187   public:
 188     OpalDynaNonStandardAudioCodec(const OpalDLLCodecRec & _info, Direction direction);
 189     ~OpalDynaNonStandardAudioCodec();
 190 };
 191
 192 /////////////////////////////////////////////////////////////////////////////
 193
 194 class OpalDynaCodecStandardAudioCapability : public H323AudioCapability
 195 {
 196   PCLASSINFO(OpalDynaCodecStandardAudioCapability, H323AudioCapability);
 197
 198   public:
 199     OpalDynaCodecStandardAudioCapability(
 200       const OpalDLLCodecRec & _info,
 201       H323EndPoint & _endpoint,
 202       unsigned maxPacketSize,         /// Maximum size of an audio packet in frames
 203       unsigned desiredPacketSize,     /// Desired transmit size of an audio packet in frames
 204       unsigned subType);
 205
 206     BOOL OnSendingPDU(H245_AudioCapability & cap, unsigned packetSize) const;
 207     BOOL OnReceivedPDU(const H245_AudioCapability & cap, unsigned & packetSize);
 208
 209     PObject * Clone() const;
 210     H323Codec * CreateCodec(H323Codec::Direction direction) const;
 211     PString GetFormatName() const;
 212     unsigned GetSubType() const;
 213
 214   protected:
 215     const OpalDLLCodecRec & info;
 216     H323EndPoint & endpoint;
 217     unsigned subType;
 218 };
 219
 220 /////////////////////////////////////////////////////////////////////////////
 221
 222 class OpalDynaCodecStandardVideoCapability : public H323VideoCapability
 223 {
 224   PCLASSINFO(OpalDynaCodecStandardVideoCapability, H323VideoCapability);
 225
 226   public:
 227     OpalDynaCodecStandardVideoCapability(
 228       const OpalDLLCodecRec & _info,
 229       H323EndPoint & _endpoint,
 230       unsigned subType);
 231
 232     BOOL OnSendingPDU(H245_VideoCapability & pdu) const;
 233     BOOL OnSendingPDU(H245_VideoMode & pdu) const;
 234     BOOL OnReceivedPDU(const H245_VideoCapability & pdu);
 235
 236     PObject * Clone() const;
 237     H323Codec * CreateCodec(H323Codec::Direction direction) const;
 238     PString GetFormatName() const;
 239     unsigned GetSubType() const;
 240
 241   protected:
 242     const OpalDLLCodecRec & info;
 243     H323EndPoint & endpoint;
 244     unsigned subType;
 245 };
 246
 247 /////////////////////////////////////////////////////////////////////////////
 248
 249 class OpalDynaVideoCodec : public H323VideoCodec
 250 {
 251   PCLASSINFO(OpalDynaVideoCodec, H323VideoCodec)
 252
 253   public:
 254     OpalDynaVideoCodec(
 255       const OpalDLLCodecRec & _info, Direction direction);
 256
 257     ~OpalDynaVideoCodec();
 258
 259     BOOL Read(BYTE * buffer,unsigned & length,RTP_DataFrame & rtpFrame);
 260     BOOL Write(const BYTE * buffer, unsigned length, const RTP_DataFrame & rtp, unsigned & written);
 261
 262   protected:
 263     const OpalDLLCodecRec & info;
 264     void * context;
 265 };
 266
 267
 268 #endif