1
/* $Id: vid_codec_util.h 3715 2011-08-19 09:35:25Z nanang $ */
3
* Copyright (C) 2008-2011 Teluu Inc. (http://www.teluu.com)
4
* Copyright (C) 2003-2008 Benny Prijono <benny@prijono.org>
6
* This program is free software; you can redistribute it and/or modify
7
* it under the terms of the GNU General Public License as published by
8
* the Free Software Foundation; either version 2 of the License, or
9
* (at your option) any later version.
11
* This program is distributed in the hope that it will be useful,
12
* but WITHOUT ANY WARRANTY; without even the implied warranty of
13
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14
* GNU General Public License for more details.
16
* You should have received a copy of the GNU General Public License
17
* along with this program; if not, write to the Free Software
18
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20
#ifndef __PJMEDIA_VID_CODEC_UTIL_H__
21
#define __PJMEDIA_VID_CODEC_UTIL_H__
25
* @file vid_codec_util.h
26
* @brief Video codec utilities.
29
#include <pjmedia/vid_codec.h>
30
#include <pjmedia/sdp_neg.h>
36
* Definition of H.263 parameters.
38
typedef struct pjmedia_vid_codec_h263_fmtp
40
unsigned mpi_cnt; /**< # of parsed MPI param */
42
pjmedia_rect_size size; /**< Picture size/resolution */
43
unsigned val; /**< MPI value */
44
} mpi[32]; /**< Minimum Picture Interval parameter */
46
} pjmedia_vid_codec_h263_fmtp;
50
* Parse SDP fmtp of H.263.
52
* @param fmtp The H.263 SDP fmtp to be parsed.
53
* @param h263_fmtp The parsing result.
55
* @return PJ_SUCCESS on success.
57
PJ_DECL(pj_status_t) pjmedia_vid_codec_h263_parse_fmtp(
58
const pjmedia_codec_fmtp *fmtp,
59
pjmedia_vid_codec_h263_fmtp *h263_fmtp);
63
* Parse, negotiate, and apply the encoding and decoding SDP fmtp of H.263
64
* in the specified codec parameter.
66
* @param param The codec parameter.
68
* @return PJ_SUCCESS on success.
70
PJ_DECL(pj_status_t) pjmedia_vid_codec_h263_apply_fmtp(
71
pjmedia_vid_codec_param *param);
75
* Definition of H.264 parameters.
77
typedef struct pjmedia_vid_codec_h264_fmtp
79
/* profile-level-id */
80
pj_uint8_t profile_idc; /**< Profile ID */
81
pj_uint8_t profile_iop; /**< Profile constraints bits */
82
pj_uint8_t level; /**< Level */
84
/* packetization-mode */
85
pj_uint8_t packetization_mode; /**< Packetization mode */
87
/* max-mbps, max-fs, max-cpb, max-dpb, and max-br */
88
unsigned max_mbps; /**< Max macroblock processing rate */
89
unsigned max_fs; /**< Max frame size (in macroblocks) */
90
unsigned max_cpb; /**< Max coded picture buffer size */
91
unsigned max_dpb; /**< Max decoded picture buffer size */
92
unsigned max_br; /**< Max video bit rate */
94
/* sprop-parameter-sets, in NAL units */
95
pj_size_t sprop_param_sets_len; /**< Parameter set length */
96
pj_uint8_t sprop_param_sets[256]; /**< Parameter set (SPS & PPS),
97
in NAL unit bitstream */
99
} pjmedia_vid_codec_h264_fmtp;
103
* Parse SDP fmtp of H.264.
105
* @param fmtp The H.264 SDP fmtp to be parsed.
106
* @param h264_fmtp The parsing result.
108
* @return PJ_SUCCESS on success.
110
PJ_DECL(pj_status_t) pjmedia_vid_codec_h264_parse_fmtp(
111
const pjmedia_codec_fmtp *fmtp,
112
pjmedia_vid_codec_h264_fmtp *h264_fmtp);
116
* Match H.264 format in the SDP media offer and answer. This will compare
117
* H.264 identifier parameters in SDP fmtp, i.e: "profile-level-id" and
118
* "packetization-mode" fields. For better interoperability, when the option
119
* #PJMEDIA_SDP_NEG_FMT_MATCH_ALLOW_MODIFY_ANSWER is set, this function
120
* may update the answer so the parameters in the answer match to ones
123
* @param pool The memory pool.
124
* @param offer The SDP media offer.
125
* @param o_fmt_idx Index of the H.264 format in the SDP media offer.
126
* @param answer The SDP media answer.
127
* @param a_fmt_idx Index of the H.264 format in the SDP media answer.
128
* @param option The format matching option, see
129
* #pjmedia_sdp_neg_fmt_match_flag.
131
* @return PJ_SUCCESS when the formats in offer and answer match.
133
PJ_DECL(pj_status_t) pjmedia_vid_codec_h264_match_sdp(
135
pjmedia_sdp_media *offer,
137
pjmedia_sdp_media *answer,
143
* Parse and apply the encoding and decoding SDP fmtp of H.264 in the
144
* specified codec parameter. This will validate size and fps to conform
145
* to H.264 level specified in SDP fmtp "profile-level-id".
147
* @param param The codec parameter.
149
* @return PJ_SUCCESS on success.
151
PJ_DECL(pj_status_t) pjmedia_vid_codec_h264_apply_fmtp(
152
pjmedia_vid_codec_param *param);
158
#endif /* __PJMEDIA_VID_CODEC_UTIL_H__ */