FFmpeg  4.3
gif.c
Go to the documentation of this file.
1 /*
2  * Animated GIF muxer
3  * Copyright (c) 2000 Fabrice Bellard
4  *
5  * first version by Francois Revol <revol@free.fr>
6  *
7  * This file is part of FFmpeg.
8  *
9  * FFmpeg is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License as published by the Free Software Foundation; either
12  * version 2.1 of the License, or (at your option) any later version.
13  *
14  * FFmpeg is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17  * Lesser General Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser General Public
20  * License along with FFmpeg; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22  */
23 
24 #include "avformat.h"
25 #include "internal.h"
26 #include "libavutil/avassert.h"
27 #include "libavutil/imgutils.h"
28 #include "libavutil/log.h"
29 #include "libavutil/opt.h"
30 #include "libavcodec/bytestream.h"
31 #include "libavcodec/gif.h"
32 
33 typedef struct GIFContext {
34  AVClass *class;
35  int loop;
37  int duration;
38  int64_t last_pos;
39  int have_end;
41 } GIFContext;
42 
44 {
45  if (s->nb_streams != 1 ||
46  s->streams[0]->codecpar->codec_type != AVMEDIA_TYPE_VIDEO ||
47  s->streams[0]->codecpar->codec_id != AV_CODEC_ID_GIF) {
49  "GIF muxer supports only a single video GIF stream.\n");
50  return AVERROR(EINVAL);
51  }
52 
53  avpriv_set_pts_info(s->streams[0], 64, 1, 100);
54 
55  return 0;
56 }
57 
59 {
60  GetByteContext gb;
61  int x;
62 
63  bytestream2_init(&gb, data, size);
64 
65  while (bytestream2_get_bytes_left(&gb) > 0) {
66  x = bytestream2_get_byte(&gb);
68  return 0;
69 
70  x = bytestream2_get_byte(&gb);
71  while (x != GIF_GCE_EXT_LABEL && bytestream2_get_bytes_left(&gb) > 0) {
72  int block_size = bytestream2_get_byte(&gb);
73  if (!block_size)
74  break;
75  bytestream2_skip(&gb, block_size);
76  }
77 
78  if (x == GIF_GCE_EXT_LABEL)
79  return bytestream2_tell(&gb) + 2;
80  }
81 
82  return 0;
83 }
84 
85 static int gif_get_delay(GIFContext *gif, AVPacket *prev, AVPacket *new)
86 {
87  if (new && new->pts != AV_NOPTS_VALUE)
88  gif->duration = av_clip_uint16(new->pts - prev->pts);
89  else if (!new && gif->last_delay >= 0)
90  gif->duration = gif->last_delay;
91 
92  return gif->duration;
93 }
94 
96 {
97  GIFContext *gif = s->priv_data;
98  AVIOContext *pb = s->pb;
99  AVPacket *pkt = gif->prev_pkt;
100 
101  if (!gif->prev_pkt) {
102  gif->prev_pkt = av_packet_alloc();
103  if (!gif->prev_pkt)
104  return AVERROR(ENOMEM);
105  return av_packet_ref(gif->prev_pkt, new_pkt);
106  }
107 
108  gif->last_pos = avio_tell(pb);
109  if (pkt->size > 0)
110  gif->have_end = pkt->data[pkt->size - 1] == GIF_TRAILER;
111 
112  if (!gif->last_pos) {
113  int delay_pos;
114  int off = 13;
115 
116  if (pkt->size < 13)
117  return AVERROR(EINVAL);
118 
119  if (pkt->data[10] & 0x80)
120  off += 3 * (1 << ((pkt->data[10] & 0x07) + 1));
121 
122  if (pkt->size < off + 2)
123  return AVERROR(EINVAL);
124 
125  avio_write(pb, pkt->data, off);
126 
127  if (pkt->data[off] == GIF_EXTENSION_INTRODUCER && pkt->data[off + 1] == 0xff)
128  off += 19;
129 
130  if (pkt->size <= off)
131  return AVERROR(EINVAL);
132 
133  /* "NETSCAPE EXTENSION" for looped animation GIF */
134  if (gif->loop >= 0) {
135  avio_w8(pb, GIF_EXTENSION_INTRODUCER); /* GIF Extension code */
136  avio_w8(pb, GIF_APP_EXT_LABEL); /* Application Extension Label */
137  avio_w8(pb, 0x0b); /* Length of Application Block */
138  avio_write(pb, "NETSCAPE2.0", sizeof("NETSCAPE2.0") - 1);
139  avio_w8(pb, 0x03); /* Length of Data Sub-Block */
140  avio_w8(pb, 0x01);
141  avio_wl16(pb, (uint16_t)gif->loop);
142  avio_w8(pb, 0x00); /* Data Sub-block Terminator */
143  }
144 
145  delay_pos = gif_parse_packet(s, pkt->data + off, pkt->size - off);
146  if (delay_pos > 0 && delay_pos < pkt->size - off - 2) {
147  avio_write(pb, pkt->data + off, delay_pos);
148  avio_wl16(pb, gif_get_delay(gif, pkt, new_pkt));
149  avio_write(pb, pkt->data + off + delay_pos + 2, pkt->size - off - delay_pos - 2);
150  } else {
151  avio_write(pb, pkt->data + off, pkt->size - off);
152  }
153  } else {
154  int delay_pos = gif_parse_packet(s, pkt->data, pkt->size);
155 
156  if (delay_pos > 0 && delay_pos < pkt->size - 2) {
157  avio_write(pb, pkt->data, delay_pos);
158  avio_wl16(pb, gif_get_delay(gif, pkt, new_pkt));
159  avio_write(pb, pkt->data + delay_pos + 2, pkt->size - delay_pos - 2);
160  } else {
161  avio_write(pb, pkt->data, pkt->size);
162  }
163  }
164 
166  if (new_pkt)
167  return av_packet_ref(gif->prev_pkt, new_pkt);
168 
169  return 0;
170 }
171 
173 {
174  GIFContext *gif = s->priv_data;
175  AVIOContext *pb = s->pb;
176 
177  if (!gif->prev_pkt)
178  return AVERROR(EINVAL);
179 
181 
182  if (!gif->have_end)
183  avio_w8(pb, GIF_TRAILER);
184  av_packet_free(&gif->prev_pkt);
185 
186  return 0;
187 }
188 
189 #define OFFSET(x) offsetof(GIFContext, x)
190 #define ENC AV_OPT_FLAG_ENCODING_PARAM
191 static const AVOption options[] = {
192  { "loop", "Number of times to loop the output: -1 - no loop, 0 - infinite loop", OFFSET(loop),
193  AV_OPT_TYPE_INT, { .i64 = 0 }, -1, 65535, ENC },
194  { "final_delay", "Force delay (in centiseconds) after the last frame", OFFSET(last_delay),
195  AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 65535, ENC },
196  { NULL },
197 };
198 
199 static const AVClass gif_muxer_class = {
200  .class_name = "GIF muxer",
201  .item_name = av_default_item_name,
202  .version = LIBAVUTIL_VERSION_INT,
203  .option = options,
204 };
205 
207  .name = "gif",
208  .long_name = NULL_IF_CONFIG_SMALL("CompuServe Graphics Interchange Format (GIF)"),
209  .mime_type = "image/gif",
210  .extensions = "gif",
211  .priv_data_size = sizeof(GIFContext),
212  .audio_codec = AV_CODEC_ID_NONE,
213  .video_codec = AV_CODEC_ID_GIF,
217  .priv_class = &gif_muxer_class,
219 };
av_packet_unref
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
Definition: avpacket.c:605
GIFContext::last_pos
int64_t last_pos
Definition: gif.c:38
AVOutputFormat::name
const char * name
Definition: avformat.h:491
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
gif_write_header
static int gif_write_header(AVFormatContext *s)
Definition: gif.c:43
opt.h
GetByteContext
Definition: bytestream.h:33
AVFMT_VARIABLE_FPS
#define AVFMT_VARIABLE_FPS
Format allows variable fps.
Definition: avformat.h:465
GIF_TRAILER
#define GIF_TRAILER
Definition: gif.h:42
gif_get_delay
static int gif_get_delay(GIFContext *gif, AVPacket *prev, AVPacket *new)
Definition: gif.c:85
AVPacket::data
uint8_t * data
Definition: packet.h:355
AVOption
AVOption.
Definition: opt.h:246
data
const char data[16]
Definition: mxf.c:91
ff_gif_muxer
AVOutputFormat ff_gif_muxer
Definition: gif.c:206
GIF_GCE_EXT_LABEL
#define GIF_GCE_EXT_LABEL
Definition: gif.h:45
ENC
#define ENC
Definition: gif.c:190
av_packet_free
void av_packet_free(AVPacket **pkt)
Free the packet, if the packet is reference counted, it will be unreferenced first.
Definition: avpacket.c:64
GIFContext::loop
int loop
Definition: gif.c:35
avio_wl16
void avio_wl16(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:447
bytestream2_skip
static av_always_inline void bytestream2_skip(GetByteContext *g, unsigned int size)
Definition: bytestream.h:164
x
FFmpeg Automated Testing Environment ************************************Introduction Using FATE from your FFmpeg source directory Submitting the results to the FFmpeg result aggregation server Uploading new samples to the fate suite FATE makefile targets and variables Makefile targets Makefile variables Examples Introduction **************FATE is an extended regression suite on the client side and a means for results aggregation and presentation on the server side The first part of this document explains how you can use FATE from your FFmpeg source directory to test your ffmpeg binary The second part describes how you can run FATE to submit the results to FFmpeg’s FATE server In any way you can have a look at the publicly viewable FATE results by visiting this as it can be seen if some test on some platform broke with their recent contribution This usually happens on the platforms the developers could not test on The second part of this document describes how you can run FATE to submit your results to FFmpeg’s FATE server If you want to submit your results be sure to check that your combination of OS and compiler is not already listed on the above mentioned website In the third part you can find a comprehensive listing of FATE makefile targets and variables Using FATE from your FFmpeg source directory **********************************************If you want to run FATE on your machine you need to have the samples in place You can get the samples via the build target fate rsync Use this command from the top level source this will cause FATE to fail NOTE To use a custom wrapper to run the pass ‘ target exec’ to ‘configure’ or set the TARGET_EXEC Make variable Submitting the results to the FFmpeg result aggregation server ****************************************************************To submit your results to the server you should run fate through the shell script ‘tests fate sh’ from the FFmpeg sources This script needs to be invoked with a configuration file as its first argument tests fate sh path to fate_config A configuration file template with comments describing the individual configuration variables can be found at ‘doc fate_config sh template’ Create a configuration that suits your based on the configuration template The ‘slot’ configuration variable can be any string that is not yet but it is suggested that you name it adhering to the following pattern ‘ARCH OS COMPILER COMPILER VERSION’ The configuration file itself will be sourced in a shell therefore all shell features may be used This enables you to setup the environment as you need it for your build For your first test runs the ‘fate_recv’ variable should be empty or commented out This will run everything as normal except that it will omit the submission of the results to the server The following files should be present in $workdir as specified in the configuration it may help to try out the ‘ssh’ command with one or more ‘ v’ options You should get detailed output concerning your SSH configuration and the authentication process The only thing left is to automate the execution of the fate sh script and the synchronisation of the samples directory Uploading new samples to the fate suite *****************************************If you need a sample uploaded send a mail to samples request This is for developers who have an account on the fate suite server If you upload new please make sure they are as small as space on each network bandwidth and so on benefit from smaller test cases Also keep in mind older checkouts use existing sample that means in practice generally do not remove or overwrite files as it likely would break older checkouts or releases Also all needed samples for a commit should be ideally before the push If you need an account for frequently uploading samples or you wish to help others by doing that send a mail to ffmpeg devel rsync vauL Duo x
Definition: fate.txt:150
avio_tell
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:557
loop
static int loop
Definition: ffplay.c:341
GIFContext::prev_pkt
AVPacket * prev_pkt
Definition: gif.c:40
GIFContext::have_end
int have_end
Definition: gif.c:39
avassert.h
GIFContext::last_delay
int last_delay
Definition: gif.c:36
gif_muxer_class
static const AVClass gif_muxer_class
Definition: gif.c:199
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
GIFContext::duration
int duration
Definition: gif.c:37
s
#define s(width, name)
Definition: cbs_vp9.c:257
AVFormatContext
Format I/O context.
Definition: avformat.h:1335
internal.h
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
NULL
#define NULL
Definition: coverity.c:32
write_trailer
static int write_trailer(AVFormatContext *s1)
Definition: v4l2enc.c:98
av_default_item_name
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:235
avio_w8
void avio_w8(AVIOContext *s, int b)
Definition: aviobuf.c:191
av_packet_ref
int av_packet_ref(AVPacket *dst, const AVPacket *src)
Setup a new reference to the data described by a given packet.
Definition: avpacket.c:614
bytestream2_get_bytes_left
static av_always_inline int bytestream2_get_bytes_left(GetByteContext *g)
Definition: bytestream.h:154
bytestream2_tell
static av_always_inline int bytestream2_tell(GetByteContext *g)
Definition: bytestream.h:188
AVIOContext
Bytestream IO Context.
Definition: avio.h:161
AVPacket::size
int size
Definition: packet.h:356
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:186
avpriv_set_pts_info
void avpriv_set_pts_info(AVStream *s, int pts_wrap_bits, unsigned int pts_num, unsigned int pts_den)
Set the time base and wrapping info for a given stream.
Definition: utils.c:4938
gif.h
size
int size
Definition: twinvq_data.h:11134
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
GIFContext
Definition: gif.c:46
gif_write_trailer
static int gif_write_trailer(AVFormatContext *s)
Definition: gif.c:172
avio_write
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:213
av_packet_alloc
AVPacket * av_packet_alloc(void)
Allocate an AVPacket and set its fields to default values.
Definition: avpacket.c:53
write_packet
static void write_packet(OutputFile *of, AVPacket *pkt, OutputStream *ost, int unqueue)
Definition: ffmpeg.c:701
AV_CODEC_ID_GIF
@ AV_CODEC_ID_GIF
Definition: codec_id.h:146
log.h
AV_CODEC_ID_NONE
@ AV_CODEC_ID_NONE
Definition: codec_id.h:47
AVOutputFormat
Definition: avformat.h:490
AVPacket::pts
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: packet.h:348
GIF_EXTENSION_INTRODUCER
#define GIF_EXTENSION_INTRODUCER
Definition: gif.h:43
uint8_t
uint8_t
Definition: audio_convert.c:194
options
static const AVOption options[]
Definition: gif.c:191
AVClass::class_name
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:72
avformat.h
pkt
static AVPacket pkt
Definition: demuxing_decoding.c:54
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:223
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
GIF_APP_EXT_LABEL
#define GIF_APP_EXT_LABEL
Definition: gif.h:47
gif_write_packet
static int gif_write_packet(AVFormatContext *s, AVPacket *new_pkt)
Definition: gif.c:95
AVPacket
This structure stores compressed data.
Definition: packet.h:332
gif_parse_packet
static int gif_parse_packet(AVFormatContext *s, uint8_t *data, int size)
Definition: gif.c:58
bytestream.h
imgutils.h
bytestream2_init
static av_always_inline void bytestream2_init(GetByteContext *g, const uint8_t *buf, int buf_size)
Definition: bytestream.h:133
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:564
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
OFFSET
#define OFFSET(x)
Definition: gif.c:189
write_header
static void write_header(FFV1Context *f)
Definition: ffv1enc.c:346