libavformat/rm.h

   1 /*
   2  * "Real" compatible muxer and demuxer.
   3  * Copyright (c) 2000, 2001 Fabrice Bellard.
   4  *
   5  * This file is part of FFmpeg.
   6  *
   7  * FFmpeg is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2.1 of the License, or (at your option) any later version.
  11  *
  12  * FFmpeg is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with FFmpeg; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  20  */
  21
  22 #ifndef AVFORMAT_RM_H
  23 #define AVFORMAT_RM_H
  24
  25 #include "avformat.h"
  26
  27
  28 typedef struct {
  29     int nb_packets;
  30     int packet_total_size;
  31     int packet_max_size;
  32     /* codec related output */
  33     int bit_rate;
  34     float frame_rate;
  35     int nb_frames;    /* current frame number */
  36     int total_frames; /* total number of frames */
  37     int num;
  38     AVCodecContext *enc;
  39 } StreamInfo;
  40
  41 typedef struct {
  42     StreamInfo streams[2];
  43     StreamInfo *audio_stream, *video_stream;
  44     int data_pos; /* position of the data after the header */
  45     int nb_packets;
  46     int old_format;
  47     int current_stream;
  48     int remaining_len;
  49     uint8_t *videobuf; ///< place to store merged video frame
  50     int videobufsize;  ///< current assembled frame size
  51     int videobufpos;   ///< position for the next slice in the video buffer
  52     int curpic_num;    ///< picture number of current frame
  53     int cur_slice, slices;
  54     int64_t pktpos;    ///< first slice position in file
  55     /// Audio descrambling matrix parameters
  56     uint8_t *audiobuf; ///< place to store reordered audio data
  57     int64_t audiotimestamp; ///< Audio packet timestamp
  58     int sub_packet_cnt; // Subpacket counter, used while reading
  59     int sub_packet_size, sub_packet_h, coded_framesize; ///< Descrambling parameters from container
  60     int audio_stream_num; ///< Stream number for audio packets
  61     int audio_pkt_cnt; ///< Output packet counter
  62     int audio_framesize; /// Audio frame size from container
  63     int sub_packet_lengths[16]; /// Length of each aac subpacket
  64 } RMContext;
  65
  66 /*< input format for Realmedia-style RTSP streams */
  67 extern AVInputFormat rdt_demuxer;
  68
  69 /**
  70  * Read the MDPR chunk, which contains stream-specific codec initialization
  71  * parameters.
  72  *
  73  * @param s context containing RMContext and ByteIOContext for stream reading
  74  * @param st the stream that the MDPR chunk belongs to and where to store the
  75  *           parameters read from the chunk into
  76  * @param codec_data_size size of the MDPR chunk
  77  * @return 0 on success, errno codes on error
  78  */
  79 int ff_rm_read_mdpr_codecdata (AVFormatContext *s, AVStream *st, int codec_data_size);
  80
  81 /**
  82  * Parse one rm-stream packet from the input bytestream.
  83  *
  84  * @param s context containing RMContext and ByteIOContext for stream reading
  85  * @param st stream to which the packet to be read belongs
  86  * @param len packet length to read from the input
  87  * @param pkt packet location to store the parsed packet data
  88  * @param seq pointer to an integer containing the sequence number, may be
  89  *            updated
  90  * @param flags pointer to an integer containing the packet flags, may be
  91                 updated
  92  * @param ts pointer to timestamp, may be updated
  93  * @return 0 on success, errno codes on error
  94  */
  95 int ff_rm_parse_packet (AVFormatContext *s, AVStream *st, int len,
  96                         AVPacket *pkt, int *seq, int *flags, int64_t *ts);
  97
  98 /**
  99  * Retrieve one cached packet from the rm-context. The real container can
 100  * store several packets (as interpreted by the codec) in a single container
 101  * packet, which means the demuxer holds some back when the first container
 102  * packet is parsed and returned. The result is that rm->audio_pkt_cnt is
 103  * a positive number, the amount of cached packets. Using this function, each
 104  * of those packets can be retrieved sequentially.
 105  *
 106  * @param s context containing RMContext and ByteIOContext for stream reading
 107  * @param st stream that this packet belongs to
 108  * @param pkt location to store the packet data
 109  */
 110 void ff_rm_retrieve_cache (AVFormatContext *s, AVStream *st, AVPacket *pkt);
 111
 112 #endif /* AVFORMAT_RM_H */