git.sesse.net Git - ffmpeg/blob - libavformat/asfenc.c

   1 /*
   2  * ASF muxer
   3  * Copyright (c) 2000, 2001 Fabrice Bellard
   4  *
   5  * This file is part of Libav.
   6  *
   7  * Libav 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  * Libav 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 Libav; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  20  */
  21
  22 #include "libavutil/dict.h"
  23 #include "libavutil/mathematics.h"
  24 #include "avformat.h"
  25 #include "avio_internal.h"
  26 #include "internal.h"
  27 #include "riff.h"
  28 #include "asf.h"
  29
  30 #undef NDEBUG
  31 #include <assert.h>
  32
  33
  34 #define ASF_INDEXED_INTERVAL    10000000
  35 #define ASF_INDEX_BLOCK         600
  36
  37 #define ASF_PACKET_ERROR_CORRECTION_DATA_SIZE 0x2
  38 #define ASF_PACKET_ERROR_CORRECTION_FLAGS          \
  39     (ASF_PACKET_FLAG_ERROR_CORRECTION_PRESENT |    \
  40      ASF_PACKET_ERROR_CORRECTION_DATA_SIZE)
  41
  42 #if (ASF_PACKET_ERROR_CORRECTION_FLAGS != 0)
  43 #   define ASF_PACKET_ERROR_CORRECTION_FLAGS_FIELD_SIZE 1
  44 #else
  45 #   define ASF_PACKET_ERROR_CORRECTION_FLAGS_FIELD_SIZE 0
  46 #endif
  47
  48 #define ASF_PPI_PROPERTY_FLAGS                                       \
  49     (ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_BYTE           |    \
  50      ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_DWORD |    \
  51      ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_BYTE       |    \
  52      ASF_PL_FLAG_STREAM_NUMBER_LENGTH_FIELD_IS_BYTE)
  53
  54 #define ASF_PPI_LENGTH_TYPE_FLAGS 0
  55
  56 #define ASF_PAYLOAD_FLAGS ASF_PL_FLAG_PAYLOAD_LENGTH_FIELD_IS_WORD
  57
  58 #if (ASF_PPI_FLAG_SEQUENCE_FIELD_IS_BYTE == (ASF_PPI_LENGTH_TYPE_FLAGS & ASF_PPI_MASK_SEQUENCE_FIELD_SIZE))
  59 #   define ASF_PPI_SEQUENCE_FIELD_SIZE 1
  60 #endif
  61 #if (ASF_PPI_FLAG_SEQUENCE_FIELD_IS_WORD == (ASF_PPI_LENGTH_TYPE_FLAGS & ASF_PPI_MASK_SEQUENCE_FIELD_SIZE))
  62 #   define ASF_PPI_SEQUENCE_FIELD_SIZE 2
  63 #endif
  64 #if (ASF_PPI_FLAG_SEQUENCE_FIELD_IS_DWORD == (ASF_PPI_LENGTH_TYPE_FLAGS & ASF_PPI_MASK_SEQUENCE_FIELD_SIZE))
  65 #   define ASF_PPI_SEQUENCE_FIELD_SIZE 4
  66 #endif
  67 #ifndef ASF_PPI_SEQUENCE_FIELD_SIZE
  68 #   define ASF_PPI_SEQUENCE_FIELD_SIZE 0
  69 #endif
  70
  71 #if (ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_BYTE == (ASF_PPI_LENGTH_TYPE_FLAGS & ASF_PPI_MASK_PACKET_LENGTH_FIELD_SIZE))
  72 #   define ASF_PPI_PACKET_LENGTH_FIELD_SIZE 1
  73 #endif
  74 #if (ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_WORD == (ASF_PPI_LENGTH_TYPE_FLAGS & ASF_PPI_MASK_PACKET_LENGTH_FIELD_SIZE))
  75 #   define ASF_PPI_PACKET_LENGTH_FIELD_SIZE 2
  76 #endif
  77 #if (ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_DWORD == (ASF_PPI_LENGTH_TYPE_FLAGS & ASF_PPI_MASK_PACKET_LENGTH_FIELD_SIZE))
  78 #   define ASF_PPI_PACKET_LENGTH_FIELD_SIZE 4
  79 #endif
  80 #ifndef ASF_PPI_PACKET_LENGTH_FIELD_SIZE
  81 #   define ASF_PPI_PACKET_LENGTH_FIELD_SIZE 0
  82 #endif
  83
  84 #if (ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_BYTE == (ASF_PPI_LENGTH_TYPE_FLAGS & ASF_PPI_MASK_PADDING_LENGTH_FIELD_SIZE))
  85 #   define ASF_PPI_PADDING_LENGTH_FIELD_SIZE 1
  86 #endif
  87 #if (ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_WORD == (ASF_PPI_LENGTH_TYPE_FLAGS & ASF_PPI_MASK_PADDING_LENGTH_FIELD_SIZE))
  88 #   define ASF_PPI_PADDING_LENGTH_FIELD_SIZE 2
  89 #endif
  90 #if (ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_DWORD == (ASF_PPI_LENGTH_TYPE_FLAGS & ASF_PPI_MASK_PADDING_LENGTH_FIELD_SIZE))
  91 #   define ASF_PPI_PADDING_LENGTH_FIELD_SIZE 4
  92 #endif
  93 #ifndef ASF_PPI_PADDING_LENGTH_FIELD_SIZE
  94 #   define ASF_PPI_PADDING_LENGTH_FIELD_SIZE 0
  95 #endif
  96
  97 #if (ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_BYTE == (ASF_PPI_PROPERTY_FLAGS & ASF_PL_MASK_REPLICATED_DATA_LENGTH_FIELD_SIZE))
  98 #   define ASF_PAYLOAD_REPLICATED_DATA_LENGTH_FIELD_SIZE 1
  99 #endif
 100 #if (ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_WORD == (ASF_PPI_PROPERTY_FLAGS & ASF_PL_MASK_REPLICATED_DATA_LENGTH_FIELD_SIZE))
 101 #   define ASF_PAYLOAD_REPLICATED_DATA_LENGTH_FIELD_SIZE 2
 102 #endif
 103 #if (ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_DWORD == (ASF_PPI_PROPERTY_FLAGS & ASF_PL_MASK_REPLICATED_DATA_LENGTH_FIELD_SIZE))
 104 #   define ASF_PAYLOAD_REPLICATED_DATA_LENGTH_FIELD_SIZE 4
 105 #endif
 106 #ifndef ASF_PAYLOAD_REPLICATED_DATA_LENGTH_FIELD_SIZE
 107 #   define ASF_PAYLOAD_REPLICATED_DATA_LENGTH_FIELD_SIZE 0
 108 #endif
 109
 110 #if (ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_BYTE == (ASF_PPI_PROPERTY_FLAGS & ASF_PL_MASK_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_SIZE))
 111 #   define ASF_PAYLOAD_OFFSET_INTO_MEDIA_OBJECT_FIELD_SIZE 1
 112 #endif
 113 #if (ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_WORD == (ASF_PPI_PROPERTY_FLAGS & ASF_PL_MASK_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_SIZE))
 114 #   define ASF_PAYLOAD_OFFSET_INTO_MEDIA_OBJECT_FIELD_SIZE 2
 115 #endif
 116 #if (ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_DWORD == (ASF_PPI_PROPERTY_FLAGS & ASF_PL_MASK_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_SIZE))
 117 #   define ASF_PAYLOAD_OFFSET_INTO_MEDIA_OBJECT_FIELD_SIZE 4
 118 #endif
 119 #ifndef ASF_PAYLOAD_OFFSET_INTO_MEDIA_OBJECT_FIELD_SIZE
 120 #   define ASF_PAYLOAD_OFFSET_INTO_MEDIA_OBJECT_FIELD_SIZE 0
 121 #endif
 122
 123 #if (ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_BYTE == (ASF_PPI_PROPERTY_FLAGS & ASF_PL_MASK_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_SIZE))
 124 #   define ASF_PAYLOAD_MEDIA_OBJECT_NUMBER_FIELD_SIZE 1
 125 #endif
 126 #if (ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_WORD == (ASF_PPI_PROPERTY_FLAGS & ASF_PL_MASK_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_SIZE))
 127 #   define ASF_PAYLOAD_MEDIA_OBJECT_NUMBER_FIELD_SIZE 2
 128 #endif
 129 #if (ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_DWORD == (ASF_PPI_PROPERTY_FLAGS & ASF_PL_MASK_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_SIZE))
 130 #   define ASF_PAYLOAD_MEDIA_OBJECT_NUMBER_FIELD_SIZE 4
 131 #endif
 132 #ifndef ASF_PAYLOAD_MEDIA_OBJECT_NUMBER_FIELD_SIZE
 133 #   define ASF_PAYLOAD_MEDIA_OBJECT_NUMBER_FIELD_SIZE 0
 134 #endif
 135
 136 #if (ASF_PL_FLAG_PAYLOAD_LENGTH_FIELD_IS_BYTE == (ASF_PAYLOAD_FLAGS & ASF_PL_MASK_PAYLOAD_LENGTH_FIELD_SIZE))
 137 #   define ASF_PAYLOAD_LENGTH_FIELD_SIZE 1
 138 #endif
 139 #if (ASF_PL_FLAG_PAYLOAD_LENGTH_FIELD_IS_WORD == (ASF_PAYLOAD_FLAGS & ASF_PL_MASK_PAYLOAD_LENGTH_FIELD_SIZE))
 140 #   define ASF_PAYLOAD_LENGTH_FIELD_SIZE 2
 141 #endif
 142 #ifndef ASF_PAYLOAD_LENGTH_FIELD_SIZE
 143 #   define ASF_PAYLOAD_LENGTH_FIELD_SIZE 0
 144 #endif
 145
 146 #define PACKET_HEADER_MIN_SIZE \
 147     (ASF_PACKET_ERROR_CORRECTION_FLAGS_FIELD_SIZE +       \
 148      ASF_PACKET_ERROR_CORRECTION_DATA_SIZE +              \
 149      1 +        /* Length Type Flags */                   \
 150      1 +        /* Property Flags */                      \
 151      ASF_PPI_PACKET_LENGTH_FIELD_SIZE +                   \
 152      ASF_PPI_SEQUENCE_FIELD_SIZE +                        \
 153      ASF_PPI_PADDING_LENGTH_FIELD_SIZE +                  \
 154      4 +        /* Send Time Field */                     \
 155      2)         /* Duration Field */
 156
 157 // Replicated Data shall be at least 8 bytes long.
 158 #define ASF_PAYLOAD_REPLICATED_DATA_LENGTH 0x08
 159
 160 #define PAYLOAD_HEADER_SIZE_SINGLE_PAYLOAD                \
 161     (1 +     /* Stream Number */                          \
 162      ASF_PAYLOAD_MEDIA_OBJECT_NUMBER_FIELD_SIZE +         \
 163      ASF_PAYLOAD_OFFSET_INTO_MEDIA_OBJECT_FIELD_SIZE +    \
 164      ASF_PAYLOAD_REPLICATED_DATA_LENGTH_FIELD_SIZE +      \
 165      ASF_PAYLOAD_REPLICATED_DATA_LENGTH)
 166
 167 #define PAYLOAD_HEADER_SIZE_MULTIPLE_PAYLOADS             \
 168     (1 +        /* Stream Number */                       \
 169      ASF_PAYLOAD_MEDIA_OBJECT_NUMBER_FIELD_SIZE +         \
 170      ASF_PAYLOAD_OFFSET_INTO_MEDIA_OBJECT_FIELD_SIZE +    \
 171      ASF_PAYLOAD_REPLICATED_DATA_LENGTH_FIELD_SIZE +      \
 172      ASF_PAYLOAD_REPLICATED_DATA_LENGTH +                 \
 173      ASF_PAYLOAD_LENGTH_FIELD_SIZE)
 174
 175 #define SINGLE_PAYLOAD_DATA_LENGTH                        \
 176     (PACKET_SIZE -                                        \
 177      PACKET_HEADER_MIN_SIZE -                             \
 178      PAYLOAD_HEADER_SIZE_SINGLE_PAYLOAD)
 179
 180 #define MULTI_PAYLOAD_CONSTANT                            \
 181     (PACKET_SIZE -                                        \
 182      PACKET_HEADER_MIN_SIZE -                             \
 183      1 -         /* Payload Flags */                      \
 184      2 * PAYLOAD_HEADER_SIZE_MULTIPLE_PAYLOADS)
 185
 186 #define DATA_HEADER_SIZE 50
 187
 188 typedef struct ASFStream {
 189     int num;
 190     unsigned char seq;
 191     /* use for reading */
 192     AVPacket pkt;
 193     int frag_offset;
 194     int timestamp;
 195     int64_t duration;
 196
 197     int ds_span;                /* descrambling  */
 198     int ds_packet_size;
 199     int ds_chunk_size;
 200
 201     int64_t packet_pos;
 202
 203     uint16_t stream_language_index;
 204
 205     int      palette_changed;
 206     uint32_t palette[256];
 207 } ASFStream;
 208
 209 typedef struct ASFContext {
 210     uint32_t seqno;
 211     int is_streamed;
 212     ASFStream streams[128];              ///< it's max number and it's not that big
 213     /* non streamed additonnal info */
 214     uint64_t nb_packets;                 ///< how many packets are there in the file, invalid if broadcasting
 215     int64_t duration;                    ///< in 100ns units
 216     /* packet filling */
 217     unsigned char multi_payloads_present;
 218     int packet_size_left;
 219     int packet_timestamp_start;
 220     int packet_timestamp_end;
 221     unsigned int packet_nb_payloads;
 222     uint8_t packet_buf[PACKET_SIZE];
 223     AVIOContext pb;
 224     /* only for reading */
 225     uint64_t data_offset;                ///< beginning of the first data packet
 226
 227     int64_t last_indexed_pts;
 228     ASFIndex *index_ptr;
 229     uint32_t nb_index_count;
 230     uint32_t nb_index_memory_alloc;
 231     uint16_t maximum_packet;
 232 } ASFContext;
 233
 234 static const AVCodecTag codec_asf_bmp_tags[] = {
 235     { AV_CODEC_ID_MPEG4,     MKTAG('M', 'P', '4', 'S') },
 236     { AV_CODEC_ID_MPEG4,     MKTAG('M', '4', 'S', '2') },
 237     { AV_CODEC_ID_MSMPEG4V3, MKTAG('M', 'P', '4', '3') },
 238     { AV_CODEC_ID_NONE,      0 },
 239 };
 240
 241 #define PREROLL_TIME 3100
 242
 243 static void put_guid(AVIOContext *s, const ff_asf_guid *g)
 244 {
 245     assert(sizeof(*g) == 16);
 246     avio_write(s, *g, sizeof(*g));
 247 }
 248
 249 static void put_str16(AVIOContext *s, const char *tag)
 250 {
 251     int len;
 252     uint8_t *pb;
 253     AVIOContext *dyn_buf;
 254     if (avio_open_dyn_buf(&dyn_buf) < 0)
 255         return;
 256
 257     avio_put_str16le(dyn_buf, tag);
 258     len = avio_close_dyn_buf(dyn_buf, &pb);
 259     avio_wl16(s, len);
 260     avio_write(s, pb, len);
 261     av_freep(&pb);
 262 }
 263
 264 static int64_t put_header(AVIOContext *pb, const ff_asf_guid *g)
 265 {
 266     int64_t pos;
 267
 268     pos = avio_tell(pb);
 269     put_guid(pb, g);
 270     avio_wl64(pb, 24);
 271     return pos;
 272 }
 273
 274 /* update header size */
 275 static void end_header(AVIOContext *pb, int64_t pos)
 276 {
 277     int64_t pos1;
 278
 279     pos1 = avio_tell(pb);
 280     avio_seek(pb, pos + 16, SEEK_SET);
 281     avio_wl64(pb, pos1 - pos);
 282     avio_seek(pb, pos1, SEEK_SET);
 283 }
 284
 285 /* write an asf chunk (only used in streaming case) */
 286 static void put_chunk(AVFormatContext *s, int type,
 287                       int payload_length, int flags)
 288 {
 289     ASFContext *asf = s->priv_data;
 290     AVIOContext *pb = s->pb;
 291     int length;
 292
 293     length = payload_length + 8;
 294     avio_wl16(pb, type);
 295     avio_wl16(pb, length);      // size
 296     avio_wl32(pb, asf->seqno);  // sequence number
 297     avio_wl16(pb, flags);       // unknown bytes
 298     avio_wl16(pb, length);      // size_confirm
 299     asf->seqno++;
 300 }
 301
 302 /* convert from unix to windows time */
 303 static int64_t unix_to_file_time(int ti)
 304 {
 305     int64_t t;
 306
 307     t  = ti * INT64_C(10000000);
 308     t += INT64_C(116444736000000000);
 309     return t;
 310 }
 311
 312 static int32_t get_send_time(ASFContext *asf, int64_t pres_time, uint64_t *offset)
 313 {
 314     int i;
 315     int32_t send_time = 0;
 316     *offset = asf->data_offset + DATA_HEADER_SIZE;
 317     for (i = 0; i < asf->nb_index_count; i++) {
 318         if (pres_time <= asf->index_ptr[i].send_time)
 319             break;
 320         send_time = asf->index_ptr[i].send_time;
 321         *offset   = asf->index_ptr[i].offset;
 322     }
 323
 324     return send_time / 10000;
 325 }
 326
 327 static int asf_write_markers(AVFormatContext *s)
 328 {
 329     ASFContext *asf = s->priv_data;
 330     AVIOContext *pb = s->pb;
 331     int i;
 332     AVRational scale = {1, 10000000};
 333     int64_t hpos = put_header(pb, &ff_asf_marker_header);
 334
 335     put_guid(pb, &ff_asf_reserved_4);  // ASF spec mandates this reserved value
 336     avio_wl32(pb, s->nb_chapters);     // markers count
 337     avio_wl16(pb, 0);                  // ASF spec mandates 0 for this
 338     avio_wl16(pb, 0);                  // name length 0, no name given
 339
 340     for (i = 0; i < s->nb_chapters; i++) {
 341         AVChapter *c = s->chapters[i];
 342         AVDictionaryEntry *t = av_dict_get(c->metadata, "title", NULL, 0);
 343         int64_t pres_time = av_rescale_q(c->start, c->time_base, scale);
 344         uint64_t offset;
 345         int32_t send_time = get_send_time(asf, pres_time, &offset);
 346         int len = 0;
 347         uint8_t *buf;
 348         AVIOContext *dyn_buf;
 349         if (t) {
 350             if (avio_open_dyn_buf(&dyn_buf) < 0)
 351                 return AVERROR(ENOMEM);
 352             avio_put_str16le(dyn_buf, t->value);
 353             len = avio_close_dyn_buf(dyn_buf, &buf);
 354         }
 355         avio_wl64(pb, offset);            // offset of the packet with send_time
 356         avio_wl64(pb, pres_time + PREROLL_TIME * 10000); // presentation time
 357         avio_wl16(pb, 12 + len);          // entry length
 358         avio_wl32(pb, send_time);         // send time
 359         avio_wl32(pb, 0);                 // flags, should be 0
 360         avio_wl32(pb, len / 2);           // marker desc length in WCHARS!
 361         if (t) {
 362             avio_write(pb, buf, len);     // marker desc
 363             av_freep(&buf);
 364         }
 365     }
 366     end_header(pb, hpos);
 367     return 0;
 368 }
 369
 370 /* write the header (used two times if non streamed) */
 371 static int asf_write_header1(AVFormatContext *s, int64_t file_size,
 372                              int64_t data_chunk_size)
 373 {
 374     ASFContext *asf = s->priv_data;
 375     AVIOContext *pb = s->pb;
 376     AVDictionaryEntry *tags[5];
 377     int header_size, n, extra_size, extra_size2, wav_extra_size, file_time;
 378     int has_title;
 379     int metadata_count;
 380     AVCodecContext *enc;
 381     int64_t header_offset, cur_pos, hpos;
 382     int bit_rate;
 383     int64_t duration;
 384
 385     ff_metadata_conv(&s->metadata, ff_asf_metadata_conv, NULL);
 386
 387     tags[0] = av_dict_get(s->metadata, "title", NULL, 0);
 388     tags[1] = av_dict_get(s->metadata, "author", NULL, 0);
 389     tags[2] = av_dict_get(s->metadata, "copyright", NULL, 0);
 390     tags[3] = av_dict_get(s->metadata, "comment", NULL, 0);
 391     tags[4] = av_dict_get(s->metadata, "rating", NULL, 0);
 392
 393     duration       = asf->duration + PREROLL_TIME * 10000;
 394     has_title      = tags[0] || tags[1] || tags[2] || tags[3] || tags[4];
 395     metadata_count = av_dict_count(s->metadata);
 396
 397     bit_rate = 0;
 398     for (n = 0; n < s->nb_streams; n++) {
 399         enc = s->streams[n]->codec;
 400
 401         avpriv_set_pts_info(s->streams[n], 32, 1, 1000); /* 32 bit pts in ms */
 402
 403         bit_rate += enc->bit_rate;
 404     }
 405
 406     if (asf->is_streamed) {
 407         put_chunk(s, 0x4824, 0, 0xc00); /* start of stream (length will be patched later) */
 408     }
 409
 410     put_guid(pb, &ff_asf_header);
 411     avio_wl64(pb, -1); /* header length, will be patched after */
 412     avio_wl32(pb, 3 + has_title + !!metadata_count + s->nb_streams); /* number of chunks in header */
 413     avio_w8(pb, 1); /* ??? */
 414     avio_w8(pb, 2); /* ??? */
 415
 416     /* file header */
 417     header_offset = avio_tell(pb);
 418     hpos          = put_header(pb, &ff_asf_file_header);
 419     put_guid(pb, &ff_asf_my_guid);
 420     avio_wl64(pb, file_size);
 421     file_time = 0;
 422     avio_wl64(pb, unix_to_file_time(file_time));
 423     avio_wl64(pb, asf->nb_packets); /* number of packets */
 424     avio_wl64(pb, duration); /* end time stamp (in 100ns units) */
 425     avio_wl64(pb, asf->duration); /* duration (in 100ns units) */
 426     avio_wl64(pb, PREROLL_TIME); /* start time stamp */
 427     avio_wl32(pb, (asf->is_streamed || !pb->seekable) ? 3 : 2);  /* ??? */
 428     avio_wl32(pb, s->packet_size); /* packet size */
 429     avio_wl32(pb, s->packet_size); /* packet size */
 430     avio_wl32(pb, bit_rate); /* Nominal data rate in bps */
 431     end_header(pb, hpos);
 432
 433     /* unknown headers */
 434     hpos = put_header(pb, &ff_asf_head1_guid);
 435     put_guid(pb, &ff_asf_head2_guid);
 436     avio_wl32(pb, 6);
 437     avio_wl16(pb, 0);
 438     end_header(pb, hpos);
 439
 440     /* title and other infos */
 441     if (has_title) {
 442         int len;
 443         uint8_t *buf;
 444         AVIOContext *dyn_buf;
 445
 446         if (avio_open_dyn_buf(&dyn_buf) < 0)
 447             return AVERROR(ENOMEM);
 448
 449         hpos = put_header(pb, &ff_asf_comment_header);
 450
 451         for (n = 0; n < FF_ARRAY_ELEMS(tags); n++) {
 452             len = tags[n] ? avio_put_str16le(dyn_buf, tags[n]->value) : 0;
 453             avio_wl16(pb, len);
 454         }
 455         len = avio_close_dyn_buf(dyn_buf, &buf);
 456         avio_write(pb, buf, len);
 457         av_freep(&buf);
 458         end_header(pb, hpos);
 459     }
 460     if (metadata_count) {
 461         AVDictionaryEntry *tag = NULL;
 462         hpos = put_header(pb, &ff_asf_extended_content_header);
 463         avio_wl16(pb, metadata_count);
 464         while ((tag = av_dict_get(s->metadata, "", tag, AV_DICT_IGNORE_SUFFIX))) {
 465             put_str16(pb, tag->key);
 466             avio_wl16(pb, 0);
 467             put_str16(pb, tag->value);
 468         }
 469         end_header(pb, hpos);
 470     }
 471     /* chapters using ASF markers */
 472     if (!asf->is_streamed && s->nb_chapters) {
 473         int ret;
 474         if (ret = asf_write_markers(s))
 475             return ret;
 476     }
 477     /* stream headers */
 478     for (n = 0; n < s->nb_streams; n++) {
 479         int64_t es_pos;
 480         //        ASFStream *stream = &asf->streams[n];
 481
 482         enc                 = s->streams[n]->codec;
 483         asf->streams[n].num = n + 1;
 484         asf->streams[n].seq = 0;
 485
 486         switch (enc->codec_type) {
 487         case AVMEDIA_TYPE_AUDIO:
 488             wav_extra_size = 0;
 489             extra_size     = 18 + wav_extra_size;
 490             extra_size2    = 8;
 491             break;
 492         default:
 493         case AVMEDIA_TYPE_VIDEO:
 494             wav_extra_size = enc->extradata_size;
 495             extra_size     = 0x33 + wav_extra_size;
 496             extra_size2    = 0;
 497             break;
 498         }
 499
 500         hpos = put_header(pb, &ff_asf_stream_header);
 501         if (enc->codec_type == AVMEDIA_TYPE_AUDIO) {
 502             put_guid(pb, &ff_asf_audio_stream);
 503             put_guid(pb, &ff_asf_audio_conceal_spread);
 504         } else {
 505             put_guid(pb, &ff_asf_video_stream);
 506             put_guid(pb, &ff_asf_video_conceal_none);
 507         }
 508         avio_wl64(pb, 0); /* ??? */
 509         es_pos = avio_tell(pb);
 510         avio_wl32(pb, extra_size); /* wav header len */
 511         avio_wl32(pb, extra_size2); /* additional data len */
 512         avio_wl16(pb, n + 1); /* stream number */
 513         avio_wl32(pb, 0); /* ??? */
 514
 515         if (enc->codec_type == AVMEDIA_TYPE_AUDIO) {
 516             /* WAVEFORMATEX header */
 517             int wavsize = ff_put_wav_header(pb, enc);
 518
 519             if (wavsize < 0)
 520                 return -1;
 521             if (wavsize != extra_size) {
 522                 cur_pos = avio_tell(pb);
 523                 avio_seek(pb, es_pos, SEEK_SET);
 524                 avio_wl32(pb, wavsize); /* wav header len */
 525                 avio_seek(pb, cur_pos, SEEK_SET);
 526             }
 527             /* ERROR Correction */
 528             avio_w8(pb, 0x01);
 529             if (enc->codec_id == AV_CODEC_ID_ADPCM_G726 || !enc->block_align) {
 530                 avio_wl16(pb, 0x0190);
 531                 avio_wl16(pb, 0x0190);
 532             } else {
 533                 avio_wl16(pb, enc->block_align);
 534                 avio_wl16(pb, enc->block_align);
 535             }
 536             avio_wl16(pb, 0x01);
 537             avio_w8(pb, 0x00);
 538         } else {
 539             avio_wl32(pb, enc->width);
 540             avio_wl32(pb, enc->height);
 541             avio_w8(pb, 2); /* ??? */
 542             avio_wl16(pb, 40 + enc->extradata_size); /* size */
 543
 544             /* BITMAPINFOHEADER header */
 545             ff_put_bmp_header(pb, enc, ff_codec_bmp_tags, 1);
 546         }
 547         end_header(pb, hpos);
 548     }
 549
 550     /* media comments */
 551
 552     hpos = put_header(pb, &ff_asf_codec_comment_header);
 553     put_guid(pb, &ff_asf_codec_comment1_header);
 554     avio_wl32(pb, s->nb_streams);
 555     for (n = 0; n < s->nb_streams; n++) {
 556         const AVCodecDescriptor *codec_desc;
 557         const char *desc;
 558
 559         enc  = s->streams[n]->codec;
 560         codec_desc = avcodec_descriptor_get(enc->codec_id);
 561
 562         if (enc->codec_type == AVMEDIA_TYPE_AUDIO)
 563             avio_wl16(pb, 2);
 564         else if (enc->codec_type == AVMEDIA_TYPE_VIDEO)
 565             avio_wl16(pb, 1);
 566         else
 567             avio_wl16(pb, -1);
 568
 569         if (enc->codec_id == AV_CODEC_ID_WMAV2)
 570             desc = "Windows Media Audio V8";
 571         else
 572             desc = codec_desc ? codec_desc->name : NULL;
 573
 574         if (desc) {
 575             AVIOContext *dyn_buf;
 576             uint8_t *buf;
 577             int len;
 578
 579             if (avio_open_dyn_buf(&dyn_buf) < 0)
 580                 return AVERROR(ENOMEM);
 581
 582             avio_put_str16le(dyn_buf, desc);
 583             len = avio_close_dyn_buf(dyn_buf, &buf);
 584             avio_wl16(pb, len / 2); // "number of characters" = length in bytes / 2
 585
 586             avio_write(pb, buf, len);
 587             av_freep(&buf);
 588         } else
 589             avio_wl16(pb, 0);
 590
 591         avio_wl16(pb, 0); /* no parameters */
 592
 593         /* id */
 594         if (enc->codec_type == AVMEDIA_TYPE_AUDIO) {
 595             avio_wl16(pb, 2);
 596             avio_wl16(pb, enc->codec_tag);
 597         } else {
 598             avio_wl16(pb, 4);
 599             avio_wl32(pb, enc->codec_tag);
 600         }
 601         if (!enc->codec_tag)
 602             return -1;
 603     }
 604     end_header(pb, hpos);
 605
 606     /* patch the header size fields */
 607
 608     cur_pos     = avio_tell(pb);
 609     header_size = cur_pos - header_offset;
 610     if (asf->is_streamed) {
 611         header_size += 8 + 30 + DATA_HEADER_SIZE;
 612
 613         avio_seek(pb, header_offset - 10 - 30, SEEK_SET);
 614         avio_wl16(pb, header_size);
 615         avio_seek(pb, header_offset - 2 - 30, SEEK_SET);
 616         avio_wl16(pb, header_size);
 617
 618         header_size -= 8 + 30 + DATA_HEADER_SIZE;
 619     }
 620     header_size += 24 + 6;
 621     avio_seek(pb, header_offset - 14, SEEK_SET);
 622     avio_wl64(pb, header_size);
 623     avio_seek(pb, cur_pos, SEEK_SET);
 624
 625     /* movie chunk, followed by packets of packet_size */
 626     asf->data_offset = cur_pos;
 627     put_guid(pb, &ff_asf_data_header);
 628     avio_wl64(pb, data_chunk_size);
 629     put_guid(pb, &ff_asf_my_guid);
 630     avio_wl64(pb, asf->nb_packets); /* nb packets */
 631     avio_w8(pb, 1); /* ??? */
 632     avio_w8(pb, 1); /* ??? */
 633     return 0;
 634 }
 635
 636 static int asf_write_header(AVFormatContext *s)
 637 {
 638     ASFContext *asf = s->priv_data;
 639
 640     s->packet_size  = PACKET_SIZE;
 641     asf->nb_packets = 0;
 642
 643     asf->last_indexed_pts      = 0;
 644     asf->index_ptr             = av_malloc(sizeof(ASFIndex) * ASF_INDEX_BLOCK);
 645     asf->nb_index_memory_alloc = ASF_INDEX_BLOCK;
 646     asf->nb_index_count        = 0;
 647     asf->maximum_packet        = 0;
 648
 649     /* the data-chunk-size has to be 50 (DATA_HEADER_SIZE), which is
 650      * data_size - asf->data_offset at the moment this function is done.
 651      * It is needed to use asf as a streamable format. */
 652     if (asf_write_header1(s, 0, DATA_HEADER_SIZE) < 0) {
 653         //av_free(asf);
 654         av_freep(&asf->index_ptr);
 655         return -1;
 656     }
 657
 658     avio_flush(s->pb);
 659
 660     asf->packet_nb_payloads     = 0;
 661     asf->packet_timestamp_start = -1;
 662     asf->packet_timestamp_end   = -1;
 663     ffio_init_context(&asf->pb, asf->packet_buf, s->packet_size, 1,
 664                       NULL, NULL, NULL, NULL);
 665
 666     return 0;
 667 }
 668
 669 static int asf_write_stream_header(AVFormatContext *s)
 670 {
 671     ASFContext *asf = s->priv_data;
 672
 673     asf->is_streamed = 1;
 674
 675     return asf_write_header(s);
 676 }
 677
 678 static int put_payload_parsing_info(AVFormatContext *s,
 679                                     unsigned sendtime, unsigned duration,
 680                                     int nb_payloads, int padsize)
 681 {
 682     ASFContext *asf = s->priv_data;
 683     AVIOContext *pb = s->pb;
 684     int ppi_size, i;
 685     int64_t start = avio_tell(pb);
 686
 687     int iLengthTypeFlags = ASF_PPI_LENGTH_TYPE_FLAGS;
 688
 689     padsize -= PACKET_HEADER_MIN_SIZE;
 690     if (asf->multi_payloads_present)
 691         padsize--;
 692     assert(padsize >= 0);
 693
 694     avio_w8(pb, ASF_PACKET_ERROR_CORRECTION_FLAGS);
 695     for (i = 0; i < ASF_PACKET_ERROR_CORRECTION_DATA_SIZE; i++)
 696         avio_w8(pb, 0x0);
 697
 698     if (asf->multi_payloads_present)
 699         iLengthTypeFlags |= ASF_PPI_FLAG_MULTIPLE_PAYLOADS_PRESENT;
 700
 701     if (padsize > 0) {
 702         if (padsize < 256)
 703             iLengthTypeFlags |= ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_BYTE;
 704         else
 705             iLengthTypeFlags |= ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_WORD;
 706     }
 707     avio_w8(pb, iLengthTypeFlags);
 708
 709     avio_w8(pb, ASF_PPI_PROPERTY_FLAGS);
 710
 711     if (iLengthTypeFlags & ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_WORD)
 712         avio_wl16(pb, padsize - 2);
 713     if (iLengthTypeFlags & ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_BYTE)
 714         avio_w8(pb, padsize - 1);
 715
 716     avio_wl32(pb, sendtime);
 717     avio_wl16(pb, duration);
 718     if (asf->multi_payloads_present)
 719         avio_w8(pb, nb_payloads | ASF_PAYLOAD_FLAGS);
 720
 721     ppi_size = avio_tell(pb) - start;
 722
 723     return ppi_size;
 724 }
 725
 726 static void flush_packet(AVFormatContext *s)
 727 {
 728     ASFContext *asf = s->priv_data;
 729     int packet_hdr_size, packet_filled_size;
 730
 731     assert(asf->packet_timestamp_end >= asf->packet_timestamp_start);
 732
 733     if (asf->is_streamed)
 734         put_chunk(s, 0x4424, s->packet_size, 0);
 735
 736     packet_hdr_size = put_payload_parsing_info(s,
 737                                                asf->packet_timestamp_start,
 738                                                asf->packet_timestamp_end -
 739                                                asf->packet_timestamp_start,
 740                                                asf->packet_nb_payloads,
 741                                                asf->packet_size_left);
 742
 743     packet_filled_size = PACKET_SIZE - asf->packet_size_left;
 744     assert(packet_hdr_size <= asf->packet_size_left);
 745     memset(asf->packet_buf + packet_filled_size, 0, asf->packet_size_left);
 746
 747     avio_write(s->pb, asf->packet_buf, s->packet_size - packet_hdr_size);
 748
 749     avio_flush(s->pb);
 750     asf->nb_packets++;
 751     asf->packet_nb_payloads     = 0;
 752     asf->packet_timestamp_start = -1;
 753     asf->packet_timestamp_end   = -1;
 754     ffio_init_context(&asf->pb, asf->packet_buf, s->packet_size, 1,
 755                       NULL, NULL, NULL, NULL);
 756 }
 757
 758 static void put_payload_header(AVFormatContext *s, ASFStream *stream,
 759                                int presentation_time, int m_obj_size,
 760                                int m_obj_offset, int payload_len, int flags)
 761 {
 762     ASFContext *asf = s->priv_data;
 763     AVIOContext *pb = &asf->pb;
 764     int val;
 765
 766     val = stream->num;
 767     if (flags & AV_PKT_FLAG_KEY)
 768         val |= ASF_PL_FLAG_KEY_FRAME;
 769     avio_w8(pb, val);
 770
 771     avio_w8(pb, stream->seq);     // Media object number
 772     avio_wl32(pb, m_obj_offset);  // Offset Into Media Object
 773
 774     // Replicated Data shall be at least 8 bytes long.
 775     // The first 4 bytes of data shall contain the
 776     // Size of the Media Object that the payload belongs to.
 777     // The next 4 bytes of data shall contain the
 778     // Presentation Time for the media object that the payload belongs to.
 779     avio_w8(pb, ASF_PAYLOAD_REPLICATED_DATA_LENGTH);
 780
 781     avio_wl32(pb, m_obj_size);        // Replicated Data - Media Object Size
 782     avio_wl32(pb, presentation_time); // Replicated Data - Presentation Time
 783
 784     if (asf->multi_payloads_present) {
 785         avio_wl16(pb, payload_len);   // payload length
 786     }
 787 }
 788
 789 static void put_frame(AVFormatContext *s, ASFStream *stream, AVStream *avst,
 790                       int timestamp, const uint8_t *buf,
 791                       int m_obj_size, int flags)
 792 {
 793     ASFContext *asf = s->priv_data;
 794     int m_obj_offset, payload_len, frag_len1;
 795
 796     m_obj_offset = 0;
 797     while (m_obj_offset < m_obj_size) {
 798         payload_len = m_obj_size - m_obj_offset;
 799         if (asf->packet_timestamp_start == -1) {
 800             asf->multi_payloads_present = (payload_len < MULTI_PAYLOAD_CONSTANT);
 801
 802             asf->packet_size_left = PACKET_SIZE;
 803             if (asf->multi_payloads_present) {
 804                 frag_len1 = MULTI_PAYLOAD_CONSTANT - 1;
 805             } else {
 806                 frag_len1 = SINGLE_PAYLOAD_DATA_LENGTH;
 807             }
 808             asf->packet_timestamp_start = timestamp;
 809         } else {
 810             // multi payloads
 811             frag_len1 = asf->packet_size_left -
 812                         PAYLOAD_HEADER_SIZE_MULTIPLE_PAYLOADS -
 813                         PACKET_HEADER_MIN_SIZE - 1;
 814
 815             if (frag_len1 < payload_len &&
 816                 avst->codec->codec_type == AVMEDIA_TYPE_AUDIO) {
 817                 flush_packet(s);
 818                 continue;
 819             }
 820         }
 821         if (frag_len1 > 0) {
 822             if (payload_len > frag_len1)
 823                 payload_len = frag_len1;
 824             else if (payload_len == (frag_len1 - 1))
 825                 payload_len = frag_len1 - 2;  // additional byte need to put padding length
 826
 827             put_payload_header(s, stream, timestamp + PREROLL_TIME,
 828                                m_obj_size, m_obj_offset, payload_len, flags);
 829             avio_write(&asf->pb, buf, payload_len);
 830
 831             if (asf->multi_payloads_present)
 832                 asf->packet_size_left -= (payload_len + PAYLOAD_HEADER_SIZE_MULTIPLE_PAYLOADS);
 833             else
 834                 asf->packet_size_left -= (payload_len + PAYLOAD_HEADER_SIZE_SINGLE_PAYLOAD);
 835             asf->packet_timestamp_end = timestamp;
 836
 837             asf->packet_nb_payloads++;
 838         } else {
 839             payload_len = 0;
 840         }
 841         m_obj_offset += payload_len;
 842         buf          += payload_len;
 843
 844         if (!asf->multi_payloads_present)
 845             flush_packet(s);
 846         else if (asf->packet_size_left <= (PAYLOAD_HEADER_SIZE_MULTIPLE_PAYLOADS + PACKET_HEADER_MIN_SIZE + 1))
 847             flush_packet(s);
 848     }
 849     stream->seq++;
 850 }
 851
 852 static int asf_write_packet(AVFormatContext *s, AVPacket *pkt)
 853 {
 854     ASFContext *asf = s->priv_data;
 855     AVIOContext *pb = s->pb;
 856     ASFStream *stream;
 857     int64_t duration;
 858     AVCodecContext *codec;
 859     int64_t packet_st, pts;
 860     int start_sec, i;
 861     int flags = pkt->flags;
 862     uint64_t offset = avio_tell(pb);
 863
 864     codec  = s->streams[pkt->stream_index]->codec;
 865     stream = &asf->streams[pkt->stream_index];
 866
 867     if (codec->codec_type == AVMEDIA_TYPE_AUDIO)
 868         flags &= ~AV_PKT_FLAG_KEY;
 869
 870     pts = (pkt->pts != AV_NOPTS_VALUE) ? pkt->pts : pkt->dts;
 871     assert(pts != AV_NOPTS_VALUE);
 872     duration      = pts * 10000;
 873     asf->duration = FFMAX(asf->duration, duration + pkt->duration * 10000);
 874
 875     packet_st = asf->nb_packets;
 876     put_frame(s, stream, s->streams[pkt->stream_index],
 877               pkt->dts, pkt->data, pkt->size, flags);
 878
 879     /* check index */
 880     if ((!asf->is_streamed) && (flags & AV_PKT_FLAG_KEY)) {
 881         start_sec = (int)(duration / INT64_C(10000000));
 882         if (start_sec != (int)(asf->last_indexed_pts / INT64_C(10000000))) {
 883             for (i = asf->nb_index_count; i < start_sec; i++) {
 884                 if (i >= asf->nb_index_memory_alloc) {
 885                     int err;
 886                     asf->nb_index_memory_alloc += ASF_INDEX_BLOCK;
 887                     if ((err = av_reallocp_array(&asf->index_ptr,
 888                                                 asf->nb_index_memory_alloc,
 889                                                 sizeof(*asf->index_ptr))) < 0) {
 890                        asf->nb_index_memory_alloc = 0;
 891                        return err;
 892                    }
 893                 }
 894                 // store
 895                 asf->index_ptr[i].packet_number = (uint32_t)packet_st;
 896                 asf->index_ptr[i].packet_count  = (uint16_t)(asf->nb_packets - packet_st);
 897                 asf->index_ptr[i].send_time     = start_sec * INT64_C(10000000);
 898                 asf->index_ptr[i].offset        = offset;
 899                 asf->maximum_packet             = FFMAX(asf->maximum_packet,
 900                                                         (uint16_t)(asf->nb_packets - packet_st));
 901             }
 902             asf->nb_index_count   = start_sec;
 903             asf->last_indexed_pts = duration;
 904         }
 905     }
 906     return 0;
 907 }
 908
 909 static int asf_write_index(AVFormatContext *s, ASFIndex *index,
 910                            uint16_t max, uint32_t count)
 911 {
 912     AVIOContext *pb = s->pb;
 913     int i;
 914
 915     put_guid(pb, &ff_asf_simple_index_header);
 916     avio_wl64(pb, 24 + 16 + 8 + 4 + 4 + (4 + 2) * count);
 917     put_guid(pb, &ff_asf_my_guid);
 918     avio_wl64(pb, ASF_INDEXED_INTERVAL);
 919     avio_wl32(pb, max);
 920     avio_wl32(pb, count);
 921     for (i = 0; i < count; i++) {
 922         avio_wl32(pb, index[i].packet_number);
 923         avio_wl16(pb, index[i].packet_count);
 924     }
 925
 926     return 0;
 927 }
 928
 929 static int asf_write_trailer(AVFormatContext *s)
 930 {
 931     ASFContext *asf = s->priv_data;
 932     int64_t file_size, data_size;
 933
 934     /* flush the current packet */
 935     if (asf->pb.buf_ptr > asf->pb.buffer)
 936         flush_packet(s);
 937
 938     /* write index */
 939     data_size = avio_tell(s->pb);
 940     if ((!asf->is_streamed) && (asf->nb_index_count != 0))
 941         asf_write_index(s, asf->index_ptr, asf->maximum_packet, asf->nb_index_count);
 942     avio_flush(s->pb);
 943
 944     if (asf->is_streamed || !s->pb->seekable) {
 945         put_chunk(s, 0x4524, 0, 0); /* end of stream */
 946     } else {
 947         /* rewrite an updated header */
 948         file_size = avio_tell(s->pb);
 949         avio_seek(s->pb, 0, SEEK_SET);
 950         asf_write_header1(s, file_size, data_size - asf->data_offset);
 951     }
 952
 953     av_free(asf->index_ptr);
 954     return 0;
 955 }
 956
 957 #if CONFIG_ASF_MUXER
 958 AVOutputFormat ff_asf_muxer = {
 959     .name           = "asf",
 960     .long_name      = NULL_IF_CONFIG_SMALL("ASF (Advanced / Active Streaming Format)"),
 961     .mime_type      = "video/x-ms-asf",
 962     .extensions     = "asf,wmv,wma",
 963     .priv_data_size = sizeof(ASFContext),
 964     .audio_codec    = CONFIG_LIBMP3LAME ? AV_CODEC_ID_MP3 : AV_CODEC_ID_MP2,
 965     .video_codec    = AV_CODEC_ID_MSMPEG4V3,
 966     .write_header   = asf_write_header,
 967     .write_packet   = asf_write_packet,
 968     .write_trailer  = asf_write_trailer,
 969     .flags          = AVFMT_GLOBALHEADER,
 970     .codec_tag      = (const AVCodecTag * const []) {
 971         codec_asf_bmp_tags, ff_codec_bmp_tags, ff_codec_wav_tags, 0
 972     },
 973 };
 974 #endif /* CONFIG_ASF_MUXER */
 975
 976 #if CONFIG_ASF_STREAM_MUXER
 977 AVOutputFormat ff_asf_stream_muxer = {
 978     .name           = "asf_stream",
 979     .long_name      = NULL_IF_CONFIG_SMALL("ASF (Advanced / Active Streaming Format)"),
 980     .mime_type      = "video/x-ms-asf",
 981     .extensions     = "asf,wmv,wma",
 982     .priv_data_size = sizeof(ASFContext),
 983     .audio_codec    = CONFIG_LIBMP3LAME ? AV_CODEC_ID_MP3 : AV_CODEC_ID_MP2,
 984     .video_codec    = AV_CODEC_ID_MSMPEG4V3,
 985     .write_header   = asf_write_stream_header,
 986     .write_packet   = asf_write_packet,
 987     .write_trailer  = asf_write_trailer,
 988     .flags          = AVFMT_GLOBALHEADER,
 989     .codec_tag      = (const AVCodecTag * const []) {
 990         codec_asf_bmp_tags, ff_codec_bmp_tags, ff_codec_wav_tags, 0
 991     },
 992 };
 993 #endif /* CONFIG_ASF_STREAM_MUXER */