libavformat/gif.c
6cea494e
 /*
7fbde343
  * Animated GIF muxer
406792e7
  * Copyright (c) 2000 Fabrice Bellard
6cea494e
  *
ac9362c5
  * first version by Francois Revol <revol@free.fr>
  *
b78e7197
  * This file is part of FFmpeg.
  *
  * FFmpeg is free software; you can redistribute it and/or
19720f15
  * 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.
6cea494e
  *
b78e7197
  * FFmpeg is distributed in the hope that it will be useful,
6cea494e
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
19720f15
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Lesser General Public License for more details.
6cea494e
  *
19720f15
  * 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
6cea494e
  */
 
 #include "avformat.h"
7e57adb4
 #include "internal.h"
635389cc
 #include "libavutil/avassert.h"
 #include "libavutil/imgutils.h"
d31e3f7c
 #include "libavutil/log.h"
 #include "libavutil/opt.h"
6d32ec6c
 
5f9986f5
 /* XXX: random value that shouldn't be taken into effect if there is no
  * transparent color in the palette (the transparency bit will be set to 0) */
 #define DEFAULT_TRANSPARENCY_INDEX 0x1f
 
 static int get_palette_transparency_index(const uint32_t *palette)
 {
     int transparent_color_index = -1;
     unsigned i, smallest_alpha = 0xff;
 
     if (!palette)
         return -1;
 
     for (i = 0; i < AVPALETTE_COUNT; i++) {
         const uint32_t v = palette[i];
         if (v >> 24 < smallest_alpha) {
             smallest_alpha = v >> 24;
             transparent_color_index = i;
         }
     }
     return smallest_alpha < 128 ? transparent_color_index : -1;
 }
 
adb9b235
 static int gif_image_write_header(AVIOContext *pb, const AVCodecContext *avctx,
33510e86
                                   int loop_count, uint32_t *palette)
6cea494e
 {
87f29996
     int i;
     int64_t aspect = 0;
adb9b235
     const AVRational sar = avctx->sample_aspect_ratio;
45782a98
 
     if (sar.num > 0 && sar.den > 0) {
87f29996
         aspect = sar.num * 64LL / sar.den - 15;
45782a98
         if (aspect < 0 || aspect > 255)
             aspect = 0;
     }
6cea494e
 
bbc413f9
     avio_write(pb, "GIF", 3);
     avio_write(pb, "89a", 3);
adb9b235
     avio_wl16(pb, avctx->width);
     avio_wl16(pb, avctx->height);
6cea494e
 
635389cc
     if (palette) {
5f9986f5
         const int bcid = get_palette_transparency_index(palette);
 
7b972d82
         avio_w8(pb, 0xf7); /* flags: global clut, 256 entries */
5f9986f5
         avio_w8(pb, bcid < 0 ? DEFAULT_TRANSPARENCY_INDEX : bcid); /* background color index */
45782a98
         avio_w8(pb, aspect);
33510e86
         for (i = 0; i < 256; i++) {
b6408ffc
             const uint32_t v = palette[i] & 0xffffff;
dfb32310
             avio_wb24(pb, v);
84ab361f
         }
635389cc
     } else {
         avio_w8(pb, 0); /* flags */
         avio_w8(pb, 0); /* background color index */
45782a98
         avio_w8(pb, aspect);
84ab361f
     }
6cea494e
 
09f59d6a
 
     if (loop_count >= 0 ) {
         /* "NETSCAPE EXTENSION" for looped animation GIF */
         avio_w8(pb, 0x21); /* GIF Extension code */
         avio_w8(pb, 0xff); /* Application Extension Label */
         avio_w8(pb, 0x0b); /* Length of Application Block */
         avio_write(pb, "NETSCAPE2.0", sizeof("NETSCAPE2.0") - 1);
         avio_w8(pb, 0x03); /* Length of Data Sub-Block */
         avio_w8(pb, 0x01);
         avio_wl16(pb, (uint16_t)loop_count);
         avio_w8(pb, 0x00); /* Data Sub-block Terminator */
     }
8108551a
 
5f9986f5
     avio_flush(pb);
6cea494e
     return 0;
 }
 
daf8cf35
 typedef struct GIFContext {
8870cf7c
     AVClass *class;
d31e3f7c
     int loop;
67cc31d6
     int last_delay;
a7c5b7a6
     AVPacket *prev_pkt;
     int duration;
ba19f848
 } GIFContext;
 
 static int gif_write_header(AVFormatContext *s)
 {
     GIFContext *gif = s->priv_data;
28f9858c
     AVCodecContext *video_enc;
635389cc
     uint32_t palette[AVPALETTE_COUNT];
ba19f848
 
9db1c645
     if (s->nb_streams != 1 ||
         s->streams[0]->codec->codec_type != AVMEDIA_TYPE_VIDEO ||
         s->streams[0]->codec->codec_id   != AV_CODEC_ID_GIF) {
28f9858c
         av_log(s, AV_LOG_ERROR,
9db1c645
                "GIF muxer supports only a single video GIF stream.\n");
28f9858c
         return AVERROR(EINVAL);
     }
 
     video_enc = s->streams[0]->codec;
ba19f848
 
7e57adb4
     avpriv_set_pts_info(s->streams[0], 64, 1, 100);
635389cc
     if (avpriv_set_systematic_pal2(palette, video_enc->pix_fmt) < 0) {
         av_assert0(video_enc->pix_fmt == AV_PIX_FMT_PAL8);
5f9986f5
         /* delay header writing: we wait for the first palette to put it
          * globally */
635389cc
     } else {
adb9b235
         gif_image_write_header(s->pb, video_enc, gif->loop, palette);
20dd25ad
     }
ba19f848
 
     return 0;
 }
 
a7c5b7a6
 static int flush_packet(AVFormatContext *s, AVPacket *new)
 {
     GIFContext *gif = s->priv_data;
5f9986f5
     int size, bcid;
ae628ec1
     AVIOContext *pb = s->pb;
13478b27
     const uint32_t *palette;
a7c5b7a6
     AVPacket *pkt = gif->prev_pkt;
 
     if (!pkt)
         return 0;
13478b27
 
     /* Mark one colour as transparent if the input palette contains at least
      * one colour that is more than 50% transparent. */
     palette = (uint32_t*)av_packet_get_side_data(pkt, AV_PKT_DATA_PALETTE, &size);
     if (palette && size != AVPALETTE_SIZE) {
         av_log(s, AV_LOG_ERROR, "Invalid palette extradata\n");
         return AVERROR_INVALIDDATA;
     }
5f9986f5
     bcid = get_palette_transparency_index(palette);
ba19f848
 
a7c5b7a6
     if (new && new->pts != AV_NOPTS_VALUE)
         gif->duration = av_clip_uint16(new->pts - gif->prev_pkt->pts);
67cc31d6
     else if (!new && gif->last_delay >= 0)
         gif->duration = gif->last_delay;
7e57adb4
 
ba19f848
     /* graphic control extension block */
77eb5504
     avio_w8(pb, 0x21);
     avio_w8(pb, 0xf9);
     avio_w8(pb, 0x04); /* block size */
5f9986f5
     avio_w8(pb, 1<<2 | (bcid >= 0));
a7c5b7a6
     avio_wl16(pb, gif->duration);
5f9986f5
     avio_w8(pb, bcid < 0 ? DEFAULT_TRANSPARENCY_INDEX : bcid);
77eb5504
     avio_w8(pb, 0x00);
ba19f848
 
01367b0f
     avio_write(pb, pkt->data, pkt->size);
6cea494e
 
a7c5b7a6
     av_free_packet(gif->prev_pkt);
     if (new)
         av_copy_packet(gif->prev_pkt, new);
 
6cea494e
     return 0;
 }
 
6189ff36
 static int gif_write_packet(AVFormatContext *s, AVPacket *pkt)
 {
     GIFContext *gif = s->priv_data;
5f9986f5
     const AVCodecContext *video_enc = s->streams[0]->codec;
6189ff36
 
     if (!gif->prev_pkt) {
         gif->prev_pkt = av_malloc(sizeof(*gif->prev_pkt));
         if (!gif->prev_pkt)
             return AVERROR(ENOMEM);
5f9986f5
 
         /* Write the first palette as global palette */
         if (video_enc->pix_fmt == AV_PIX_FMT_PAL8) {
             int size;
             void *palette = av_packet_get_side_data(pkt, AV_PKT_DATA_PALETTE, &size);
 
             if (!palette) {
                 av_log(s, AV_LOG_ERROR, "PAL8 packet is missing palette in extradata\n");
                 return AVERROR_INVALIDDATA;
             }
             if (size != AVPALETTE_SIZE) {
                 av_log(s, AV_LOG_ERROR, "Invalid palette extradata\n");
                 return AVERROR_INVALIDDATA;
             }
             gif_image_write_header(s->pb, video_enc, gif->loop, palette);
         }
 
6189ff36
         return av_copy_packet(gif->prev_pkt, pkt);
     }
     return flush_packet(s, pkt);
 }
 
6cea494e
 static int gif_write_trailer(AVFormatContext *s)
 {
a7c5b7a6
     GIFContext *gif = s->priv_data;
ae628ec1
     AVIOContext *pb = s->pb;
6cea494e
 
a7c5b7a6
     flush_packet(s, NULL);
     av_freep(&gif->prev_pkt);
77eb5504
     avio_w8(pb, 0x3b);
3b4bb19e
 
6cea494e
     return 0;
 }
 
d31e3f7c
 #define OFFSET(x) offsetof(GIFContext, x)
 #define ENC AV_OPT_FLAG_ENCODING_PARAM
 static const AVOption options[] = {
09f59d6a
     { "loop", "Number of times to loop the output: -1 - no loop, 0 - infinite loop", OFFSET(loop),
       AV_OPT_TYPE_INT, { .i64 = 0 }, -1, 65535, ENC },
c37b0daf
     { "final_delay", "Force delay (in centiseconds) after the last frame", OFFSET(last_delay),
67cc31d6
       AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 65535, ENC },
d31e3f7c
     { NULL },
 };
 
 static const AVClass gif_muxer_class = {
     .class_name = "GIF muxer",
     .item_name  = av_default_item_name,
     .version    = LIBAVUTIL_VERSION_INT,
     .option     = options,
 };
 
c6610a21
 AVOutputFormat ff_gif_muxer = {
33510e86
     .name           = "gif",
     .long_name      = NULL_IF_CONFIG_SMALL("GIF Animation"),
     .mime_type      = "image/gif",
     .extensions     = "gif",
     .priv_data_size = sizeof(GIFContext),
36ef5369
     .audio_codec    = AV_CODEC_ID_NONE,
635389cc
     .video_codec    = AV_CODEC_ID_GIF,
33510e86
     .write_header   = gif_write_header,
     .write_packet   = gif_write_packet,
     .write_trailer  = gif_write_trailer,
     .priv_class     = &gif_muxer_class,
7e57adb4
     .flags          = AVFMT_VARIABLE_FPS,
6cea494e
 };