2 * Targa (.tga) image encoder
3 * Copyright (c) 2007 Bobby Bingham
5 * This file is part of FFmpeg.
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.
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.
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
24 #include "libavutil/imgutils.h"
25 #include "libavutil/internal.h"
26 #include "libavutil/intreadwrite.h"
27 #include "libavutil/opt.h"
28 #include "libavutil/pixdesc.h"
34 typedef struct TargaContext {
41 * RLE compress the image, with maximum size of out_size
42 * @param outbuf Output buffer
43 * @param out_size Maximum output size
44 * @param pic Image to compress
45 * @param bpp Bytes per pixel
46 * @param w Image width
47 * @param h Image height
48 * @return Size of output in bytes, or -1 if larger than out_size
50 static int targa_encode_rle(uint8_t *outbuf, int out_size, const AVFrame *pic,
51 int bpp, int w, int h)
58 for(y = 0; y < h; y ++) {
59 ret = ff_rle_encode(out, out_size, pic->data[0] + pic->linesize[0] * y, bpp, w, 0x7f, 0, -1, 0);
70 static int targa_encode_normal(uint8_t *outbuf, const AVFrame *pic, int bpp, int w, int h)
73 uint8_t *out = outbuf;
74 uint8_t *ptr = pic->data[0];
76 for(i=0; i < h; i++) {
79 ptr += pic->linesize[0];
85 static int targa_encode_frame(AVCodecContext *avctx, AVPacket *pkt,
86 const AVFrame *p, int *got_packet)
88 TargaContext *s = avctx->priv_data;
89 int bpp, picsize, datasize = -1, ret, i;
92 picsize = av_image_get_buffer_size(avctx->pix_fmt,
93 avctx->width, avctx->height, 1);
94 if ((ret = ff_alloc_packet2(avctx, pkt, picsize + 45, 0)) < 0)
97 /* zero out the header and only set applicable fields */
98 memset(pkt->data, 0, 12);
99 AV_WL16(pkt->data+12, avctx->width);
100 AV_WL16(pkt->data+14, avctx->height);
101 /* image descriptor byte: origin is always top-left, bits 0-3 specify alpha */
102 pkt->data[17] = 0x20 | (avctx->pix_fmt == AV_PIX_FMT_BGRA ? 8 : 0);
104 out = pkt->data + 18; /* skip past the header we write */
106 avctx->bits_per_coded_sample = av_get_bits_per_pixel(av_pix_fmt_desc_get(avctx->pix_fmt));
107 switch(avctx->pix_fmt) {
108 case AV_PIX_FMT_PAL8: {
109 int pal_bpp = 24; /* Only write 32bit palette if there is transparency information */
110 for (i = 0; i < 256; i++)
111 if (AV_RN32(p->data[1] + 4 * i) >> 24 != 0xFF) {
115 pkt->data[1] = 1; /* palette present */
116 pkt->data[2] = TGA_PAL; /* uncompressed palettised image */
117 pkt->data[6] = 1; /* palette contains 256 entries */
118 pkt->data[7] = pal_bpp; /* palette contains pal_bpp bit entries */
119 pkt->data[16] = 8; /* bpp */
120 for (i = 0; i < 256; i++)
122 AV_WL32(pkt->data + 18 + 4 * i, *(uint32_t *)(p->data[1] + i * 4));
124 AV_WL24(pkt->data + 18 + 3 * i, *(uint32_t *)(p->data[1] + i * 4));
126 out += 32 * pal_bpp; /* skip past the palette we just output */
129 case AV_PIX_FMT_GRAY8:
130 pkt->data[2] = TGA_BW; /* uncompressed grayscale image */
131 avctx->bits_per_coded_sample = 0x28;
132 pkt->data[16] = 8; /* bpp */
134 case AV_PIX_FMT_RGB555LE:
135 pkt->data[2] = TGA_RGB; /* uncompressed true-color image */
136 avctx->bits_per_coded_sample =
137 pkt->data[16] = 16; /* bpp */
139 case AV_PIX_FMT_BGR24:
140 pkt->data[2] = TGA_RGB; /* uncompressed true-color image */
141 pkt->data[16] = 24; /* bpp */
143 case AV_PIX_FMT_BGRA:
144 pkt->data[2] = TGA_RGB; /* uncompressed true-color image */
145 pkt->data[16] = 32; /* bpp */
148 av_log(avctx, AV_LOG_ERROR, "Pixel format '%s' not supported.\n",
149 av_get_pix_fmt_name(avctx->pix_fmt));
150 return AVERROR(EINVAL);
152 bpp = pkt->data[16] >> 3;
155 #if FF_API_CODER_TYPE
156 FF_DISABLE_DEPRECATION_WARNINGS
157 if (avctx->coder_type == FF_CODER_TYPE_RAW)
159 FF_ENABLE_DEPRECATION_WARNINGS
162 /* try RLE compression */
164 datasize = targa_encode_rle(out, picsize, p, bpp, avctx->width, avctx->height);
166 /* if that worked well, mark the picture as RLE compressed */
168 pkt->data[2] |= TGA_RLE;
170 /* if RLE didn't make it smaller, go back to no compression */
171 else datasize = targa_encode_normal(out, p, bpp, avctx->width, avctx->height);
175 /* The standard recommends including this section, even if we don't use
176 * any of the features it affords. TODO: take advantage of the pixel
177 * aspect ratio and encoder ID fields available? */
178 memcpy(out, "\0\0\0\0\0\0\0\0TRUEVISION-XFILE.", 26);
180 pkt->size = out + 26 - pkt->data;
181 pkt->flags |= AV_PKT_FLAG_KEY;
187 static av_cold int targa_encode_init(AVCodecContext *avctx)
189 if (avctx->width > 0xffff || avctx->height > 0xffff) {
190 av_log(avctx, AV_LOG_ERROR, "image dimensions too large\n");
191 return AVERROR(EINVAL);
194 #if FF_API_CODED_FRAME
195 FF_DISABLE_DEPRECATION_WARNINGS
196 avctx->coded_frame->key_frame = 1;
197 avctx->coded_frame->pict_type = AV_PICTURE_TYPE_I;
198 FF_ENABLE_DEPRECATION_WARNINGS
204 #define OFFSET(x) offsetof(TargaContext, x)
205 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
206 static const AVOption options[] = {
207 { "rle", "Use run-length compression", OFFSET(rle), AV_OPT_TYPE_INT, { .i64 = 1 }, 0, 1, VE },
212 static const AVClass targa_class = {
213 .class_name = "targa",
214 .item_name = av_default_item_name,
216 .version = LIBAVUTIL_VERSION_INT,
219 AVCodec ff_targa_encoder = {
221 .long_name = NULL_IF_CONFIG_SMALL("Truevision Targa image"),
222 .type = AVMEDIA_TYPE_VIDEO,
223 .id = AV_CODEC_ID_TARGA,
224 .priv_data_size = sizeof(TargaContext),
225 .priv_class = &targa_class,
226 .init = targa_encode_init,
227 .encode2 = targa_encode_frame,
228 .pix_fmts = (const enum AVPixelFormat[]){
229 AV_PIX_FMT_BGR24, AV_PIX_FMT_BGRA, AV_PIX_FMT_RGB555LE, AV_PIX_FMT_GRAY8, AV_PIX_FMT_PAL8,