git.sesse.net Git - ffmpeg/blob - libavformat/asf.h

   1 /*
   2  * Copyright (c) 2000, 2001 Fabrice Bellard
   3  *
   4  * This file is part of FFmpeg.
   5  *
   6  * FFmpeg is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * FFmpeg 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 GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with FFmpeg; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  19  */
  20
  21 #ifndef AVFORMAT_ASF_H
  22 #define AVFORMAT_ASF_H
  23
  24 #include <stdint.h>
  25 #include "avformat.h"
  26 #include "metadata.h"
  27 #include "riff.h"
  28
  29 typedef enum ASFDataType {
  30     ASF_UNICODE    = 0,
  31     ASF_BYTE_ARRAY = 1,
  32     ASF_BOOL       = 2,
  33     ASF_DWORD      = 3,
  34     ASF_QWORD      = 4,
  35     ASF_WORD       = 5,
  36     ASF_GUID       = 6,
  37 }ASFDataType;
  38
  39 typedef struct ASFMainHeader {
  40     ff_asf_guid guid;                  ///< generated by client computer
  41     uint64_t file_size;         /**< in bytes
  42                                  *   invalid if broadcasting */
  43     uint64_t create_time;       /**< time of creation, in 100-nanosecond units since 1.1.1601
  44                                  *   invalid if broadcasting */
  45     uint64_t play_time;         /**< play time, in 100-nanosecond units
  46                                  * invalid if broadcasting */
  47     uint64_t send_time;         /**< time to send file, in 100-nanosecond units
  48                                  *   invalid if broadcasting (could be ignored) */
  49     uint32_t preroll;           /**< timestamp of the first packet, in milliseconds
  50                                  *   if nonzero - subtract from time */
  51     uint32_t ignore;            ///< preroll is 64 bits - but let's just ignore it
  52     uint32_t flags;             /**< 0x01 - broadcast
  53                                  *   0x02 - seekable
  54                                  *   rest is reserved should be 0 */
  55     uint32_t min_pktsize;       /**< size of a data packet
  56                                  *   invalid if broadcasting */
  57     uint32_t max_pktsize;       /**< shall be the same as for min_pktsize
  58                                  *   invalid if broadcasting */
  59     uint32_t max_bitrate;       /**< bandwidth of stream in bps
  60                                  *   should be the sum of bitrates of the
  61                                  *   individual media streams */
  62 } ASFMainHeader;
  63
  64
  65 typedef struct ASFIndex {
  66     uint32_t packet_number;
  67     uint16_t packet_count;
  68     uint64_t send_time;
  69     uint64_t offset;
  70 } ASFIndex;
  71
  72 extern const ff_asf_guid ff_asf_header;
  73 extern const ff_asf_guid ff_asf_file_header;
  74 extern const ff_asf_guid ff_asf_stream_header;
  75 extern const ff_asf_guid ff_asf_ext_stream_header;
  76 extern const ff_asf_guid ff_asf_audio_stream;
  77 extern const ff_asf_guid ff_asf_audio_conceal_spread;
  78 extern const ff_asf_guid ff_asf_video_stream;
  79 extern const ff_asf_guid ff_asf_jfif_media;
  80 extern const ff_asf_guid ff_asf_video_conceal_none;
  81 extern const ff_asf_guid ff_asf_command_stream;
  82 extern const ff_asf_guid ff_asf_comment_header;
  83 extern const ff_asf_guid ff_asf_codec_comment_header;
  84 extern const ff_asf_guid ff_asf_codec_comment1_header;
  85 extern const ff_asf_guid ff_asf_data_header;
  86 extern const ff_asf_guid ff_asf_head1_guid;
  87 extern const ff_asf_guid ff_asf_head2_guid;
  88 extern const ff_asf_guid ff_asf_extended_content_header;
  89 extern const ff_asf_guid ff_asf_simple_index_header;
  90 extern const ff_asf_guid ff_asf_ext_stream_embed_stream_header;
  91 extern const ff_asf_guid ff_asf_ext_stream_audio_stream;
  92 extern const ff_asf_guid ff_asf_metadata_header;
  93 extern const ff_asf_guid ff_asf_metadata_library_header;
  94 extern const ff_asf_guid ff_asf_marker_header;
  95 extern const ff_asf_guid ff_asf_reserved_4;
  96 extern const ff_asf_guid ff_asf_my_guid;
  97 extern const ff_asf_guid ff_asf_language_guid;
  98 extern const ff_asf_guid ff_asf_content_encryption;
  99 extern const ff_asf_guid ff_asf_ext_content_encryption;
 100 extern const ff_asf_guid ff_asf_digital_signature;
 101 extern const ff_asf_guid ff_asf_extended_stream_properties_object;
 102 extern const ff_asf_guid ff_asf_group_mutual_exclusion_object;
 103 extern const ff_asf_guid ff_asf_mutex_language;
 104
 105 extern const AVMetadataConv ff_asf_metadata_conv[];
 106
 107 /**
 108  * Handles both attached pictures as well as id3 tags.
 109  *
 110  * @return Returns < 0 on error, 1 if the type of the byte array
 111  *         is unsupported by this function and 0 otherwise.
 112  */
 113 int ff_asf_handle_byte_array(AVFormatContext *s, const char *name,
 114                              int val_len);
 115
 116
 117 #define ASF_PACKET_FLAG_ERROR_CORRECTION_PRESENT 0x80 //1000 0000
 118
 119
 120 //   ASF data packet structure
 121 //   =========================
 122 //
 123 //
 124 //  -----------------------------------
 125 // | Error Correction Data             |  Optional
 126 //  -----------------------------------
 127 // | Payload Parsing Information (PPI) |
 128 //  -----------------------------------
 129 // | Payload Data                      |
 130 //  -----------------------------------
 131 // | Padding Data                      |
 132 //  -----------------------------------
 133
 134
 135 // PPI_FLAG - Payload parsing information flags
 136 #define ASF_PPI_FLAG_MULTIPLE_PAYLOADS_PRESENT 1
 137
 138 #define ASF_PPI_FLAG_SEQUENCE_FIELD_IS_BYTE  0x02 //0000 0010
 139 #define ASF_PPI_FLAG_SEQUENCE_FIELD_IS_WORD  0x04 //0000 0100
 140 #define ASF_PPI_FLAG_SEQUENCE_FIELD_IS_DWORD 0x06 //0000 0110
 141 #define ASF_PPI_MASK_SEQUENCE_FIELD_SIZE     0x06 //0000 0110
 142
 143 #define ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_BYTE  0x08 //0000 1000
 144 #define ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_WORD  0x10 //0001 0000
 145 #define ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_DWORD 0x18 //0001 1000
 146 #define ASF_PPI_MASK_PADDING_LENGTH_FIELD_SIZE     0x18 //0001 1000
 147
 148 #define ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_BYTE  0x20 //0010 0000
 149 #define ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_WORD  0x40 //0100 0000
 150 #define ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_DWORD 0x60 //0110 0000
 151 #define ASF_PPI_MASK_PACKET_LENGTH_FIELD_SIZE     0x60 //0110 0000
 152
 153 // PL_FLAG - Payload flags
 154 #define ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_BYTE   0x01 //0000 0001
 155 #define ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_WORD   0x02 //0000 0010
 156 #define ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_DWORD  0x03 //0000 0011
 157 #define ASF_PL_MASK_REPLICATED_DATA_LENGTH_FIELD_SIZE      0x03 //0000 0011
 158
 159 #define ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_BYTE  0x04 //0000 0100
 160 #define ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_WORD  0x08 //0000 1000
 161 #define ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_DWORD 0x0c //0000 1100
 162 #define ASF_PL_MASK_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_SIZE     0x0c //0000 1100
 163
 164 #define ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_BYTE  0x10 //0001 0000
 165 #define ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_WORD  0x20 //0010 0000
 166 #define ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_DWORD 0x30 //0011 0000
 167 #define ASF_PL_MASK_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_SIZE     0x30 //0011 0000
 168
 169 #define ASF_PL_FLAG_STREAM_NUMBER_LENGTH_FIELD_IS_BYTE  0x40 //0100 0000
 170 #define ASF_PL_MASK_STREAM_NUMBER_LENGTH_FIELD_SIZE     0xc0 //1100 0000
 171
 172 #define ASF_PL_FLAG_PAYLOAD_LENGTH_FIELD_IS_BYTE  0x40 //0100 0000
 173 #define ASF_PL_FLAG_PAYLOAD_LENGTH_FIELD_IS_WORD  0x80 //1000 0000
 174 #define ASF_PL_MASK_PAYLOAD_LENGTH_FIELD_SIZE     0xc0 //1100 0000
 175
 176 #define ASF_PL_FLAG_KEY_FRAME 0x80 //1000 0000
 177
 178 #endif /* AVFORMAT_ASF_H */