FFmpeg
targa.c
Go to the documentation of this file.
1 /*
2  * Targa (.tga) image decoder
3  * Copyright (c) 2006 Konstantin Shishkov
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg 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  * FFmpeg 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 FFmpeg; 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/intreadwrite.h"
23 #include "libavutil/imgutils.h"
24 #include "avcodec.h"
25 #include "bytestream.h"
26 #include "internal.h"
27 #include "targa.h"
28 
29 typedef struct TargaContext {
31 } TargaContext;
32 
33 static uint8_t *advance_line(uint8_t *start, uint8_t *line,
34  int stride, int *y, int h, int interleave)
35 {
36  *y += interleave;
37 
38  if (*y < h) {
39  return line + interleave * stride;
40  } else {
41  *y = (*y + 1) & (interleave - 1);
42  if (*y && *y < h) {
43  return start + *y * stride;
44  } else {
45  return NULL;
46  }
47  }
48 }
49 
51  uint8_t *start, int w, int h, int stride,
52  int bpp, int interleave)
53 {
54  int x, y;
55  int depth = (bpp + 1) >> 3;
56  int type, count;
57  uint8_t *line = start;
58  uint8_t *dst = line;
59 
60  x = y = count = 0;
61  while (dst) {
62  if (bytestream2_get_bytes_left(&s->gb) <= 0) {
63  av_log(avctx, AV_LOG_ERROR,
64  "Ran ouf of data before end-of-image\n");
65  return AVERROR_INVALIDDATA;
66  }
67  type = bytestream2_get_byteu(&s->gb);
68  count = (type & 0x7F) + 1;
69  type &= 0x80;
70  if (!type) {
71  do {
72  int n = FFMIN(count, w - x);
73  bytestream2_get_buffer(&s->gb, dst, n * depth);
74  count -= n;
75  dst += n * depth;
76  x += n;
77  if (x == w) {
78  x = 0;
79  dst = line = advance_line(start, line, stride, &y, h, interleave);
80  }
81  } while (dst && count > 0);
82  } else {
83  uint8_t tmp[4];
84  bytestream2_get_buffer(&s->gb, tmp, depth);
85  do {
86  int n = FFMIN(count, w - x);
87  count -= n;
88  x += n;
89  do {
90  memcpy(dst, tmp, depth);
91  dst += depth;
92  } while (--n);
93  if (x == w) {
94  x = 0;
95  dst = line = advance_line(start, line, stride, &y, h, interleave);
96  }
97  } while (dst && count > 0);
98  }
99  }
100 
101  if (count) {
102  av_log(avctx, AV_LOG_ERROR, "Packet went out of bounds\n");
103  return AVERROR_INVALIDDATA;
104  }
105 
106  return 0;
107 }
108 
109 static int decode_frame(AVCodecContext *avctx,
110  void *data, int *got_frame,
111  AVPacket *avpkt)
112 {
113  TargaContext * const s = avctx->priv_data;
114  AVFrame * const p = data;
115  uint8_t *dst;
116  int stride;
117  int idlen, pal, compr, y, w, h, bpp, flags, ret;
118  int first_clr, colors, csize;
119  int interleave;
120  size_t img_size;
121 
122  bytestream2_init(&s->gb, avpkt->data, avpkt->size);
123 
124  /* parse image header */
125  idlen = bytestream2_get_byte(&s->gb);
126  pal = bytestream2_get_byte(&s->gb);
127  compr = bytestream2_get_byte(&s->gb);
128  first_clr = bytestream2_get_le16(&s->gb);
129  colors = bytestream2_get_le16(&s->gb);
130  csize = bytestream2_get_byte(&s->gb);
131  bytestream2_skip(&s->gb, 4); /* 2: x, 2: y */
132  w = bytestream2_get_le16(&s->gb);
133  h = bytestream2_get_le16(&s->gb);
134  bpp = bytestream2_get_byte(&s->gb);
135 
136  flags = bytestream2_get_byte(&s->gb);
137 
138  if (!pal && (first_clr || colors || csize)) {
139  av_log(avctx, AV_LOG_WARNING, "File without colormap has colormap information set.\n");
140  // specification says we should ignore those value in this case
141  first_clr = colors = csize = 0;
142  }
143 
144  if (bytestream2_get_bytes_left(&s->gb) < idlen + 2*colors) {
145  av_log(avctx, AV_LOG_ERROR,
146  "Not enough data to read header\n");
147  return AVERROR_INVALIDDATA;
148  }
149 
150  // skip identifier if any
151  bytestream2_skip(&s->gb, idlen);
152 
153  switch (bpp) {
154  case 8:
155  avctx->pix_fmt = ((compr & (~TGA_RLE)) == TGA_BW) ? AV_PIX_FMT_GRAY8 : AV_PIX_FMT_PAL8;
156  break;
157  case 15:
158  case 16:
159  avctx->pix_fmt = AV_PIX_FMT_RGB555LE;
160  break;
161  case 24:
162  avctx->pix_fmt = AV_PIX_FMT_BGR24;
163  break;
164  case 32:
165  avctx->pix_fmt = AV_PIX_FMT_BGRA;
166  break;
167  default:
168  av_log(avctx, AV_LOG_ERROR, "Bit depth %i is not supported\n", bpp);
169  return AVERROR_INVALIDDATA;
170  }
171 
172  if (colors && (colors + first_clr) > 256) {
173  av_log(avctx, AV_LOG_ERROR, "Incorrect palette: %i colors with offset %i\n", colors, first_clr);
174  return AVERROR_INVALIDDATA;
175  }
176 
177  if ((ret = ff_set_dimensions(avctx, w, h)) < 0)
178  return ret;
179 
180  if ((compr & (~TGA_RLE)) == TGA_NODATA) {
181  return avpkt->size;
182  }
183 
184  if (!(compr & TGA_RLE)) {
185  img_size = w * ((bpp + 1) >> 3);
186  if (bytestream2_get_bytes_left(&s->gb) < img_size * h) {
187  av_log(avctx, AV_LOG_ERROR,
188  "Not enough data available for image\n");
189  return AVERROR_INVALIDDATA;
190  }
191  }
192 
193  if ((ret = ff_get_buffer(avctx, p, 0)) < 0)
194  return ret;
196 
197  if (flags & TGA_TOPTOBOTTOM) {
198  dst = p->data[0];
199  stride = p->linesize[0];
200  } else { //image is upside-down
201  dst = p->data[0] + p->linesize[0] * (h - 1);
202  stride = -p->linesize[0];
203  }
204 
206  flags & TGA_INTERLEAVE4 ? 4 : 1;
207 
208  if (colors) {
209  int pal_size, pal_sample_size;
210 
211  switch (csize) {
212  case 32: pal_sample_size = 4; break;
213  case 24: pal_sample_size = 3; break;
214  case 16:
215  case 15: pal_sample_size = 2; break;
216  default:
217  av_log(avctx, AV_LOG_ERROR, "Palette entry size %i bits is not supported\n", csize);
218  return AVERROR_INVALIDDATA;
219  }
220  pal_size = colors * pal_sample_size;
221  if (avctx->pix_fmt != AV_PIX_FMT_PAL8) //should not occur but skip palette anyway
222  bytestream2_skip(&s->gb, pal_size);
223  else {
224  int t;
225  uint32_t *pal = ((uint32_t *)p->data[1]) + first_clr;
226 
227  if (bytestream2_get_bytes_left(&s->gb) < pal_size) {
228  av_log(avctx, AV_LOG_ERROR,
229  "Not enough data to read palette\n");
230  return AVERROR_INVALIDDATA;
231  }
232  switch (pal_sample_size) {
233  case 4:
234  for (t = 0; t < colors; t++)
235  *pal++ = bytestream2_get_le32u(&s->gb);
236  break;
237  case 3:
238  /* RGB24 */
239  for (t = 0; t < colors; t++)
240  *pal++ = (0xffU<<24) | bytestream2_get_le24u(&s->gb);
241  break;
242  case 2:
243  /* RGB555 */
244  for (t = 0; t < colors; t++) {
245  uint32_t v = bytestream2_get_le16u(&s->gb);
246  v = ((v & 0x7C00) << 9) |
247  ((v & 0x03E0) << 6) |
248  ((v & 0x001F) << 3);
249  /* left bit replication */
250  v |= (v & 0xE0E0E0U) >> 5;
251  *pal++ = (0xffU<<24) | v;
252  }
253  break;
254  }
255  p->palette_has_changed = 1;
256  }
257  }
258 
259  if (compr & TGA_RLE) {
260  int res = targa_decode_rle(avctx, s, dst, w, h, stride, bpp, interleave);
261  if (res < 0)
262  return res;
263  } else {
264  uint8_t *line;
265  if (bytestream2_get_bytes_left(&s->gb) < img_size * h) {
266  av_log(avctx, AV_LOG_ERROR,
267  "Not enough data available for image\n");
268  return AVERROR_INVALIDDATA;
269  }
270 
271  line = dst;
272  y = 0;
273  do {
274  bytestream2_get_buffer(&s->gb, line, img_size);
275  line = advance_line(dst, line, stride, &y, h, interleave);
276  } while (line);
277  }
278 
279  if (flags & TGA_RIGHTTOLEFT) { // right-to-left, needs horizontal flip
280  int x;
281  for (y = 0; y < h; y++) {
282  void *line = &p->data[0][y * p->linesize[0]];
283  for (x = 0; x < w >> 1; x++) {
284  switch (bpp) {
285  case 32:
286  FFSWAP(uint32_t, ((uint32_t *)line)[x], ((uint32_t *)line)[w - x - 1]);
287  break;
288  case 24:
289  FFSWAP(uint8_t, ((uint8_t *)line)[3 * x ], ((uint8_t *)line)[3 * w - 3 * x - 3]);
290  FFSWAP(uint8_t, ((uint8_t *)line)[3 * x + 1], ((uint8_t *)line)[3 * w - 3 * x - 2]);
291  FFSWAP(uint8_t, ((uint8_t *)line)[3 * x + 2], ((uint8_t *)line)[3 * w - 3 * x - 1]);
292  break;
293  case 16:
294  FFSWAP(uint16_t, ((uint16_t *)line)[x], ((uint16_t *)line)[w - x - 1]);
295  break;
296  case 8:
297  FFSWAP(uint8_t, ((uint8_t *)line)[x], ((uint8_t *)line)[w - x - 1]);
298  }
299  }
300  }
301  }
302 
303 
304  *got_frame = 1;
305 
306  return avpkt->size;
307 }
308 
310  .name = "targa",
311  .long_name = NULL_IF_CONFIG_SMALL("Truevision Targa image"),
312  .type = AVMEDIA_TYPE_VIDEO,
313  .id = AV_CODEC_ID_TARGA,
314  .priv_data_size = sizeof(TargaContext),
315  .decode = decode_frame,
316  .capabilities = AV_CODEC_CAP_DR1,
317 };
AVCodec
AVCodec.
Definition: codec.h:202
stride
int stride
Definition: mace.c:144
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:186
TGA_INTERLEAVE2
@ TGA_INTERLEAVE2
Definition: targa.h:44
GetByteContext
Definition: bytestream.h:33
TGA_RIGHTTOLEFT
@ TGA_RIGHTTOLEFT
Definition: targa.h:42
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:317
tmp
static uint8_t tmp[11]
Definition: aes_ctr.c:26
w
uint8_t w
Definition: llviddspenc.c:38
internal.h
AVPacket::data
uint8_t * data
Definition: packet.h:373
decode_frame
static int decode_frame(AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
Definition: targa.c:109
data
const char data[16]
Definition: mxf.c:143
AV_PIX_FMT_BGR24
@ AV_PIX_FMT_BGR24
packed RGB 8:8:8, 24bpp, BGRBGR...
Definition: pixfmt.h:69
AV_PIX_FMT_BGRA
@ AV_PIX_FMT_BGRA
packed BGRA 8:8:8:8, 32bpp, BGRABGRA...
Definition: pixfmt.h:95
targa.h
AVFrame::data
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:338
bytestream2_skip
static av_always_inline void bytestream2_skip(GetByteContext *g, unsigned int size)
Definition: bytestream.h:168
U
#define U(x)
Definition: vp56_arith.h:37
ff_targa_decoder
const AVCodec ff_targa_decoder
Definition: targa.c:309
type
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf type
Definition: writing_filters.txt:86
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
decode
static void decode(AVCodecContext *dec_ctx, AVPacket *pkt, AVFrame *frame, FILE *outfile)
Definition: decode_audio.c:71
TGA_RLE
@ TGA_RLE
Definition: targa.h:38
intreadwrite.h
s
#define s(width, name)
Definition: cbs_vp9.c:257
TGA_BW
@ TGA_BW
Definition: targa.h:37
TargaContext::gb
GetByteContext gb
Definition: targa.c:30
NULL
#define NULL
Definition: coverity.c:32
TargaContext
Definition: targa.c:29
AV_PICTURE_TYPE_I
@ AV_PICTURE_TYPE_I
Intra.
Definition: avutil.h:274
bytestream2_get_buffer
static av_always_inline unsigned int bytestream2_get_buffer(GetByteContext *g, uint8_t *dst, unsigned int size)
Definition: bytestream.h:267
AV_PIX_FMT_GRAY8
@ AV_PIX_FMT_GRAY8
Y , 8bpp.
Definition: pixfmt.h:74
bytestream2_get_bytes_left
static av_always_inline int bytestream2_get_bytes_left(GetByteContext *g)
Definition: bytestream.h:158
interleave
static void interleave(uint8_t *dst, uint8_t *src, int w, int h, int dst_linesize, int src_linesize, enum FilterMode mode, int swap)
Definition: vf_il.c:108
AVFrame::pict_type
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:414
ff_get_buffer
int ff_get_buffer(AVCodecContext *avctx, AVFrame *frame, int flags)
Get a buffer for a frame.
Definition: decode.c:1652
AV_CODEC_CAP_DR1
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() or get_encode_buffer() for allocating buffers and supports custom allocators.
Definition: codec.h:52
AVPacket::size
int size
Definition: packet.h:374
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:117
line
Definition: graph2dot.c:48
AV_PIX_FMT_RGB555LE
@ AV_PIX_FMT_RGB555LE
packed RGB 5:5:5, 16bpp, (msb)1X 5R 5G 5B(lsb), little-endian, X=unused/undefined
Definition: pixfmt.h:108
TGA_INTERLEAVE4
@ TGA_INTERLEAVE4
Definition: targa.h:45
FFMIN
#define FFMIN(a, b)
Definition: macros.h:49
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:209
AVCodecContext::pix_fmt
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:593
avcodec.h
AV_PIX_FMT_PAL8
@ AV_PIX_FMT_PAL8
8 bits with AV_PIX_FMT_RGB32 palette
Definition: pixfmt.h:77
ret
ret
Definition: filter_design.txt:187
FFSWAP
#define FFSWAP(type, a, b)
Definition: macros.h:52
AVCodecContext
main external API structure.
Definition: avcodec.h:383
AVFrame::palette_has_changed
int palette_has_changed
Tell user application that palette has changed from previous frame.
Definition: frame.h:479
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
ff_set_dimensions
int ff_set_dimensions(AVCodecContext *s, int width, int height)
Check that the provided frame dimensions are valid and set them on the codec context.
Definition: utils.c:86
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:410
AVPacket
This structure stores compressed data.
Definition: packet.h:350
targa_decode_rle
static int targa_decode_rle(AVCodecContext *avctx, TargaContext *s, uint8_t *start, int w, int h, int stride, int bpp, int interleave)
Definition: targa.c:50
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:137
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
AVFrame::linesize
int linesize[AV_NUM_DATA_POINTERS]
For video, a positive or negative value, which is typically indicating the size in bytes of each pict...
Definition: frame.h:362
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
TGA_TOPTOBOTTOM
@ TGA_TOPTOBOTTOM
Definition: targa.h:43
h
h
Definition: vp9dsp_template.c:2038
AV_CODEC_ID_TARGA
@ AV_CODEC_ID_TARGA
Definition: codec_id.h:143
advance_line
static uint8_t * advance_line(uint8_t *start, uint8_t *line, int stride, int *y, int h, int interleave)
Definition: targa.c:33
TGA_NODATA
@ TGA_NODATA
Definition: targa.h:34
line
The official guide to swscale for confused that consecutive non overlapping rectangles of slice_bottom special converter These generally are unscaled converters of common like for each output line the vertical scaler pulls lines from a ring buffer When the ring buffer does not contain the wanted line
Definition: swscale.txt:40