1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
|
/*
* h323plugins.h
*
* H.323 codec plugins handler
*
* Open H323 Library
*
* Copyright (C) 2004 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 H323 Library.
*
* The Initial Developer of the Original Code is Post Increment
*
* Contributor(s): ______________________________________.
*
* $Log: opalplugin.h,v $
* Revision 1.3.4.1 2005/02/07 00:41:31 csoutheren
* Backported patches from Atlas-devel
*
* Revision 1.5 2004/12/20 23:30:20 csoutheren
* Added plugin support for packet loss concealment frames
*
* Revision 1.4 2004/11/29 06:30:53 csoutheren
* Added support for wideband codecs
*
* Revision 1.3 2004/05/18 22:26:28 csoutheren
* Initial support for embedded codecs
* Fixed problems with streamed codec support
* Updates for abstract factory loading methods
*
* Revision 1.2 2004/05/09 14:44:36 csoutheren
* Added support for streamed plugin audio codecs
*
* Revision 1.1 2004/04/09 12:25:25 csoutheren
* Renamed from h323plugin.h
*
* Revision 1.2 2004/04/03 10:38:24 csoutheren
* Added in initial cut at codec plugin code. Branches are for wimps :)
*
* Revision 1.1.2.1 2004/03/31 11:03:16 csoutheren
* Initial public version
*
* Revision 1.8 2004/02/23 13:17:32 craigs
* Fixed problems with codec interface functions
*
* Revision 1.7 2004/02/23 13:04:09 craigs
* Removed warnings when compliing plugins
*
* Revision 1.6 2004/01/27 14:55:46 craigs
* Implemented static linking of new codecs
*
* Revision 1.5 2004/01/23 05:21:15 craigs
* Updated for changes to the codec plugin interface
*
* Revision 1.4 2004/01/09 11:27:46 craigs
* Plugin codec audio now works :)
*
* Revision 1.3 2004/01/09 07:32:22 craigs
* More fixes for capability problems
*
* Revision 1.2 2004/01/06 07:05:03 craigs
* Changed to support plugin codecs
*
* Revision 1.1 2004/01/04 13:37:51 craigs
* Implementation of codec plugins
*
*
*/
#ifndef __OPAL_H323PLUGIN_H
#define __OPAL_H323PLUGIN_H
#ifdef __cplusplus
extern "C" {
#endif
#include <time.h>
#ifdef _WIN32
# ifdef PLUGIN_CODEC_DLL_EXPORTS
# define PLUGIN_CODEC_DLL_API __declspec(dllexport)
# else
# define PLUGIN_CODEC_DLL_API __declspec(dllimport)
# endif
#else
#define PLUGIN_CODEC_DLL_API
#endif
#define PWLIB_PLUGIN_API_VERSION 0
#define PLUGIN_CODEC_VERSION 1 // initial version
#define PLUGIN_CODEC_VERSION_WIDEBAND 2 // added wideband
#define PLUGIN_CODEC_API_VER_FN PWLibPlugin_GetAPIVersion
#define PLUGIN_CODEC_API_VER_FN_STR "PWLibPlugin_GetAPIVersion"
#define PLUGIN_CODEC_GET_CODEC_FN OpalCodecPlugin_GetCodecs
#define PLUGIN_CODEC_GET_CODEC_FN_STR "OpalCodecPlugin_GetCodecs"
#define PLUGIN_CODEC_API_VER_FN_DECLARE \
PLUGIN_CODEC_DLL_API unsigned int PLUGIN_CODEC_API_VER_FN() \
{ return PWLIB_PLUGIN_API_VERSION; }
enum {
PluginCodec_Licence_None = 0,
PluginCodec_License_GPL = 1,
PluginCodec_License_MPL = 2,
PluginCodec_License_Freeware = 3,
PluginCodec_License_ResearchAndDevelopmentUseOnly = 4,
PluginCodec_License_BSD = 5,
PluginCodec_License_NoRoyalties = 0x7f,
// any license codes above here require royalty payments
PluginCodec_License_RoyaltiesRequired = 0x80
};
struct PluginCodec_information {
// start of version 1 fields
time_t timestamp; // codec creation time and date - obtain with command: date -u "+%c = %s"
const char * sourceAuthor; // source code author
const char * sourceVersion; // source code version
const char * sourceEmail; // source code email contact information
const char * sourceURL; // source code web site
const char * sourceCopyright; // source code copyright
const char * sourceLicense; // source code license
unsigned char sourceLicenseCode; // source code license
const char * codecDescription; // codec description
const char * codecAuthor; // codec author
const char * codecVersion; // codec version
const char * codecEmail; // codec email contact information
const char * codecURL; // codec web site
const char * codecCopyright; // codec copyright information
const char * codecLicense; // codec license
unsigned short codecLicenseCode; // codec license code
// end of version 1 fields
};
enum PluginCodec_Flags {
PluginCodec_MediaTypeMask = 0x000f,
PluginCodec_MediaTypeAudio = 0x0000,
PluginCodec_MediaTypeVideo = 0x0001,
PluginCodec_MediaTypeAudioStreamed = 0x0002,
PluginCodec_InputTypeMask = 0x0010,
PluginCodec_InputTypeRaw = 0x0000,
PluginCodec_InputTypeRTP = 0x0010,
PluginCodec_OutputTypeMask = 0x0020,
PluginCodec_OutputTypeRaw = 0x0000,
PluginCodec_OutputTypeRTP = 0x0020,
PluginCodec_RTPTypeMask = 0x0040,
PluginCodec_RTPTypeDynamic = 0x0000,
PluginCodec_RTPTypeExplicit = 0x0040,
PluginCodec_RTPSharedMask = 0x0080,
PluginCodec_RTPTypeNotShared = 0x0000,
PluginCodec_RTPTypeShared = 0x0080,
PluginCodec_DecodeSilenceMask = 0x0100,
PluginCodec_NoDecodeSilence = 0x0000,
PluginCodec_DecodeSilence = 0x0100,
PluginCodec_BitsPerSamplePos = 12,
PluginCodec_BitsPerSampleMask = 0xf000,
};
enum PluginCodec_CoderFlags {
PluginCodec_CoderSilenceFrame = 1
};
struct PluginCodec_Definition;
struct PluginCodec_ControlDefn {
const char * name;
int (*control)(const struct PluginCodec_Definition * codec, void * context,
const char * name, void * parm, unsigned * parmLen);
};
struct PluginCodec_Definition {
unsigned int version; // codec structure version
// start of version 1 fields
struct PluginCodec_information * info; // license information
unsigned int flags; // b0-3: 0 = audio, 1 = video
// b4: 0 = raw input, 1 = RTP input
// b5: 0 = raw output, 1 = RTP output
// b6: 0 = dynamic RTP, 1 = explicit RTP
// b7: 0 = no share RTP, 1 = share RTP
const char * descr; // text decription
const char * sourceFormat; // source format
const char * destFormat; // destination format
const void * userData; // user data value
unsigned int sampleRate; // samples per second
unsigned int bitsPerSec; // raw bits per second
unsigned int nsPerFrame; // nanoseconds per frame
unsigned int samplesPerFrame; // samples per frame
unsigned int bytesPerFrame; // max bytes per frame
unsigned int recommendedFramesPerPacket; // recommended number of frames per packet
unsigned int maxFramesPerPacket; // maximum number of frames per packet
unsigned char rtpPayload; // IANA RTP payload code (if defined)
const char * sdpFormat; // SDP format string (or NULL, if no SDP format)
void * (*createCodec)(const struct PluginCodec_Definition * codec); // create codec
void (*destroyCodec) (const struct PluginCodec_Definition * codec, void * context); // destroy codec
int (*codecFunction) (const struct PluginCodec_Definition * codec, void * context, // do codec function
const void * from, unsigned * fromLen,
void * to, unsigned * toLen,
unsigned int * flag);
struct PluginCodec_ControlDefn * codecControls;
// H323 specific fields
unsigned char h323CapabilityType;
void * h323CapabilityData;
// end of version 1 fields
};
typedef struct PluginCodec_Definition * (* PluginCodec_GetCodecFunction)(unsigned int *, unsigned int);
typedef unsigned (* PluginCodec_GetAPIVersionFunction)();
///////////////////////////////////////////////////////////////////
//
// H.323 specific values
//
struct PluginCodec_H323CapabilityExtension {
unsigned int index;
void * data;
unsigned dataLength;
};
struct PluginCodec_H323NonStandardCodecData {
const char * objectId;
unsigned char t35CountryCode;
unsigned char t35Extension;
unsigned short manufacturerCode;
const unsigned char * data;
unsigned int dataLength;
int (*capabilityMatchFunction)(struct PluginCodec_H323NonStandardCodecData *);
};
struct PluginCodec_H323AudioGSMData {
int comfortNoise:1;
int scrambled:1;
};
struct PluginCodec_H323AudioG7231AnnexC {
unsigned char maxAl_sduAudioFrames;
int silenceSuppression:1;
int highRateMode0:6; // INTEGER (27..78), -- units octets
int highRateMode1:6; // INTEGER (27..78), -- units octets
int lowRateMode0:6; // INTEGER (23..66), -- units octets
int lowRateMode1:6; // INTEGER (23..66), -- units octets
int sidMode0:4; // INTEGER (6..17), -- units octets
int sidMode1:4; // INTEGER (6..17), -- units octets
};
struct PluginCodec_H323VideoH261
{
int qcifMPI:2; // INTEGER (1..4) OPTIONAL, -- units 1/29.97 Hz
int cifMPI:2; // INTEGER (1..4) OPTIONAL, -- units 1/29.97 Hz
int temporalSpatialTradeOffCapability; // BOOLEAN,
int maxBitRate; // INTEGER (1..19200), -- units of 100 bit/s
int stillImageTransmission:1; // BOOLEAN, -- Annex D of H.261
int videoBadMBsCap:1; // BOOLEAN
const struct PluginCodec_H323CapabilityExtension * extensions;
};
enum {
PluginCodec_H323Codec_undefined, // must be zero, so empty struct is undefined
PluginCodec_H323Codec_programmed, // H323ProgrammedCapability
PluginCodec_H323Codec_nonStandard, // H323NonStandardData
PluginCodec_H323Codec_generic, // not yet implemented
// audio codecs
PluginCodec_H323AudioCodec_g711Alaw_64k, // int
PluginCodec_H323AudioCodec_g711Alaw_56k, // int
PluginCodec_H323AudioCodec_g711Ulaw_64k, // int
PluginCodec_H323AudioCodec_g711Ulaw_56k, // int
PluginCodec_H323AudioCodec_g722_64k, // int
PluginCodec_H323AudioCodec_g722_56k, // int
PluginCodec_H323AudioCodec_g722_48k, // int
PluginCodec_H323AudioCodec_g7231, // H323AudioG7231Data
PluginCodec_H323AudioCodec_g728, // int
PluginCodec_H323AudioCodec_g729, // int
PluginCodec_H323AudioCodec_g729AnnexA, // int
PluginCodec_H323AudioCodec_is11172, // not yet implemented
PluginCodec_H323AudioCodec_is13818Audio, // not yet implemented
PluginCodec_H323AudioCodec_g729wAnnexB, // int
PluginCodec_H323AudioCodec_g729AnnexAwAnnexB, // int
PluginCodec_H323AudioCodec_g7231AnnexC, // H323AudioG7231AnnexC
PluginCodec_H323AudioCodec_gsmFullRate, // H323AudioGSMData
PluginCodec_H323AudioCodec_gsmHalfRate, // H323AudioGSMData
PluginCodec_H323AudioCodec_gsmEnhancedFullRate, // H323AudioGSMData
PluginCodec_H323AudioCodec_g729Extensions, // not yet implemented
// video codecs
PluginCodec_H323VideoCodec_h261, // not yet implemented
PluginCodec_H323VideoCodec_h262, // not yet implemented
PluginCodec_H323VideoCodec_h263, // not yet implemented
PluginCodec_H323VideoCodec_is11172, // not yet implemented
};
#ifdef OPAL_STATIC_CODEC
# undef PLUGIN_CODEC_DLL_API
# define PLUGIN_CODEC_DLL_API static
# define PLUGIN_CODEC_IMPLEMENT(name) \
unsigned int Opal_StaticCodec_##name##_GetAPIVersion() \
{ return PWLIB_PLUGIN_API_VERSION; } \
static struct PluginCodec_Definition * PLUGIN_CODEC_GET_CODEC_FN(unsigned * count, unsigned /*version*/); \
struct PluginCodec_Definition * Opal_StaticCodec_##name##_GetCodecs(unsigned * p1, unsigned p2) \
{ return PLUGIN_CODEC_GET_CODEC_FN(p1,p2); } \
#else
# define PLUGIN_CODEC_IMPLEMENT(name) \
PLUGIN_CODEC_DLL_API unsigned int PLUGIN_CODEC_API_VER_FN() \
{ return PWLIB_PLUGIN_API_VERSION; } \
#endif
#ifdef __cplusplus
};
#endif
#endif
|
