libavformat/rtp.h
e309128f
 /*
  * RTP definitions
406792e7
  * Copyright (c) 2002 Fabrice Bellard
e309128f
  *
b78e7197
  * This file is part of FFmpeg.
  *
  * FFmpeg is free software; you can redistribute it and/or
e309128f
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
b78e7197
  * version 2.1 of the License, or (at your option) any later version.
e309128f
  *
b78e7197
  * FFmpeg is distributed in the hope that it will be useful,
e309128f
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
b78e7197
  * License along with FFmpeg; if not, write to the Free Software
5509bffa
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
e309128f
  */
98790382
 #ifndef AVFORMAT_RTP_H
 #define AVFORMAT_RTP_H
e309128f
 
9152880e
 #include "libavformat/avformat.h"
245976da
 #include "libavcodec/avcodec.h"
2e814d03
 #include "libavutil/mathematics.h"
99545457
 
b0a880b3
 /**
8034130e
  * Return the payload type for a given stream used in the given format context.
  * Static payload types are derived from the codec.
  * Dynamic payload type are derived from the id field in AVStream.
  * The format context private option payload_type overrides both.
b0a880b3
  *
9152880e
  * @param fmt   The context of the format
b0a880b3
  * @param codec The context of the codec
8034130e
  * @param idx   The stream index
14288774
  * @return The payload type (the 'PT' field in the RTP header).
b0a880b3
  */
8034130e
 int ff_rtp_get_payload_type(AVFormatContext *fmt, AVCodecContext *codec,
                             int idx);
8b1ab7bf
 
d3a57949
 /**
  * Initialize a codec context based on the payload type.
  *
  * Fill the codec_type and codec_id fields of a codec context with
  * information depending on the payload type; for audio codecs, the
  * channels and sample_rate fields are also filled.
  *
  * @param codec The context of the codec
d3da8a45
  * @param payload_type The payload type (the 'PT' field in the RTP header)
d3a57949
  * @return In case of unknown payload type or dynamic payload type, a
  * negative value is returned; otherwise, 0 is returned
  */
bf6d9818
 int ff_rtp_get_codec_info(AVCodecContext *codec, int payload_type);
c3efd98c
 
 /**
  * Return the encoding name (as defined in
  * http://www.iana.org/assignments/rtp-parameters) for a given payload type.
  *
  * @param payload_type The payload type (the 'PT' field in the RTP header)
  * @return In case of unknown payload type or dynamic payload type, a pointer
  * to an empty string is returned; otherwise, a pointer to a string containing
  * the encoding name is returned
  */
e5f483c6
 const char *ff_rtp_enc_name(int payload_type);
3aa7ac6d
 
 /**
  * Return the codec id for the given encoding name and codec type.
  *
  * @param buf A pointer to the string containing the encoding name
  * @param codec_type The codec type
36ef5369
  * @return In case of unknown encoding name, AV_CODEC_ID_NONE is returned;
3aa7ac6d
  * otherwise, the codec id is returned
  */
36ef5369
 enum AVCodecID ff_rtp_codec_id(const char *buf, enum AVMediaType codec_type);
e5f483c6
 
d1ccf0e0
 #define RTP_PT_PRIVATE 96
 #define RTP_VERSION 2
190e507b
 #define RTP_MAX_SDES 256   /**< maximum text length for SDES */
d1ccf0e0
 
da9cea77
 /* RTCP packets use 0.5% of the bandwidth */
d1ccf0e0
 #define RTCP_TX_RATIO_NUM 5
 #define RTCP_TX_RATIO_DEN 1000
 
b5c4bb98
 /* An arbitrary id value for RTP Xiph streams - only relevant to indicate
09f21198
  * that the configuration has changed within a stream (by changing the
b5c4bb98
  * ident value sent).
  */
 #define RTP_XIPH_IDENT 0xfecdba
 
7f3468d3
 /* RTCP packet types */
 enum RTCPType {
0de9380b
     RTCP_FIR    = 192,
     RTCP_NACK, // 193
     RTCP_SMPTETC,// 194
     RTCP_IJ,   // 195
7f3468d3
     RTCP_SR     = 200,
     RTCP_RR,   // 201
     RTCP_SDES, // 202
     RTCP_BYE,  // 203
0de9380b
     RTCP_APP,  // 204
     RTCP_RTPFB,// 205
     RTCP_PSFB, // 206
     RTCP_XR,   // 207
     RTCP_AVB,  // 208
     RTCP_RSI,  // 209
     RTCP_TOKEN,// 210
7f3468d3
 };
 
0de9380b
 #define RTP_PT_IS_RTCP(x) (((x) >= RTCP_FIR && (x) <= RTCP_IJ) || \
                            ((x) >= RTCP_SR  && (x) <= RTCP_TOKEN))
298a587f
 
2e814d03
 #define NTP_TO_RTP_FORMAT(x) av_rescale((x), INT64_C(1) << 32, 1000000)
 
98790382
 #endif /* AVFORMAT_RTP_H */