yading@11: /* yading@11: * Realmedia RTSP (RDT) definitions yading@11: * Copyright (c) 2007 Ronald S. Bultje yading@11: * yading@11: * This file is part of FFmpeg. yading@11: * yading@11: * FFmpeg is free software; you can redistribute it and/or yading@11: * modify it under the terms of the GNU Lesser General Public yading@11: * License as published by the Free Software Foundation; either yading@11: * version 2.1 of the License, or (at your option) any later version. yading@11: * yading@11: * FFmpeg is distributed in the hope that it will be useful, yading@11: * but WITHOUT ANY WARRANTY; without even the implied warranty of yading@11: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU yading@11: * Lesser General Public License for more details. yading@11: * yading@11: * You should have received a copy of the GNU Lesser General Public yading@11: * License along with FFmpeg; if not, write to the Free Software yading@11: * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA yading@11: */ yading@11: yading@11: #ifndef AVFORMAT_RDT_H yading@11: #define AVFORMAT_RDT_H yading@11: yading@11: #include yading@11: #include "avformat.h" yading@11: #include "rtpdec.h" yading@11: yading@11: typedef struct RDTDemuxContext RDTDemuxContext; yading@11: yading@11: /** yading@11: * Allocate and init the RDT parsing context. yading@11: * @param ic the containing RTSP demuxer context yading@11: * @param first_stream_of_set_idx index to the first AVStream in the RTSP yading@11: * demuxer context's ic->streams array that is part of this yading@11: * particular stream's set of streams (with identical content) yading@11: * @param priv_data private data of the payload data handler context yading@11: * @param handler pointer to the parse_packet() payload parsing function yading@11: * @return a newly allocated RDTDemuxContext. Free with ff_rdt_parse_close(). yading@11: */ yading@11: RDTDemuxContext *ff_rdt_parse_open(AVFormatContext *ic, yading@11: int first_stream_of_set_idx, yading@11: void *priv_data, yading@11: RTPDynamicProtocolHandler *handler); yading@11: void ff_rdt_parse_close(RDTDemuxContext *s); yading@11: yading@11: /** yading@11: * Calculate the response (RealChallenge2 in the RTSP header) to the yading@11: * challenge (RealChallenge1 in the RTSP header from the Real/Helix yading@11: * server), which is used as some sort of client validation. yading@11: * yading@11: * @param response pointer to response buffer, it should be at least 41 bytes yading@11: * (40 data + 1 zero) bytes long. yading@11: * @param chksum pointer to buffer containing a checksum of the response, yading@11: * it should be at least 9 (8 data + 1 zero) bytes long. yading@11: * @param challenge pointer to the RealChallenge1 value provided by the yading@11: * server. yading@11: */ yading@11: void ff_rdt_calc_response_and_checksum(char response[41], char chksum[9], yading@11: const char *challenge); yading@11: yading@11: /** yading@11: * Register RDT-related dynamic payload handlers with our cache. yading@11: */ yading@11: void av_register_rdt_dynamic_payload_handlers(void); yading@11: yading@11: /** yading@11: * Add subscription information to Subscribe parameter string. yading@11: * yading@11: * @param cmd string to write the subscription information into. yading@11: * @param size size of cmd. yading@11: * @param stream_nr stream number. yading@11: * @param rule_nr rule number to conform to. yading@11: */ yading@11: void ff_rdt_subscribe_rule(char *cmd, int size, yading@11: int stream_nr, int rule_nr); yading@11: yading@11: /** yading@11: * Parse RDT-style packet header. yading@11: * yading@11: * @param buf input buffer yading@11: * @param len length of input buffer yading@11: * @param pset_id will be set to the set ID this packet belongs to yading@11: * @param pseq_no will be set to the sequence number of the packet yading@11: * @param pstream_id will be set to the stream ID this packet belongs to yading@11: * @param pis_keyframe will be whether this packet belongs to a keyframe yading@11: * @param ptimestamp will be set to the timestamp of the packet yading@11: * @return the amount of bytes consumed, or negative on error yading@11: */ yading@11: int ff_rdt_parse_header(const uint8_t *buf, int len, yading@11: int *pset_id, int *pseq_no, int *pstream_id, yading@11: int *pis_keyframe, uint32_t *ptimestamp); yading@11: yading@11: /** yading@11: * Parse RDT-style packet data (header + media data). yading@11: * Usage similar to rtp_parse_packet(). yading@11: */ yading@11: int ff_rdt_parse_packet(RDTDemuxContext *s, AVPacket *pkt, yading@11: uint8_t **buf, int len); yading@11: yading@11: /** yading@11: * Parse a server-related SDP line. yading@11: * yading@11: * @param s the RTSP AVFormatContext yading@11: * @param stream_index the index of the first stream in the set represented yading@11: * by the SDP m= line (in s->streams) yading@11: * @param buf the SDP line yading@11: */ yading@11: void ff_real_parse_sdp_a_line(AVFormatContext *s, int stream_index, yading@11: const char *buf); yading@11: yading@11: #endif /* AVFORMAT_RDT_H */