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 if(avctx->width > 0xffff || avctx->height > 0xffff) {
93 av_log(avctx, AV_LOG_ERROR, "image dimensions too large\n");
94 return AVERROR(EINVAL);
96 picsize = av_image_get_buffer_size(avctx->pix_fmt,
97 avctx->width, avctx->height, 1);
98 if ((ret = ff_alloc_packet2(avctx, pkt, picsize + 45, 0)) < 0)
101 /* zero out the header and only set applicable fields */
102 memset(pkt->data, 0, 12);
103 AV_WL16(pkt->data+12, avctx->width);
104 AV_WL16(pkt->data+14, avctx->height);
105 /* image descriptor byte: origin is always top-left, bits 0-3 specify alpha */
106 pkt->data[17] = 0x20 | (avctx->pix_fmt == AV_PIX_FMT_BGRA ? 8 : 0);
108 out = pkt->data + 18; /* skip past the header we write */
110 avctx->bits_per_coded_sample = av_get_bits_per_pixel(av_pix_fmt_desc_get(avctx->pix_fmt));
111 switch(avctx->pix_fmt) {
112 case AV_PIX_FMT_PAL8: {
113 int pal_bpp = 24; /* Only write 32bit palette if there is transparency information */
114 for (i = 0; i < 256; i++)
115 if (AV_RN32(p->data[1] + 4 * i) >> 24 != 0xFF) {
119 pkt->data[1] = 1; /* palette present */
120 pkt->data[2] = TGA_PAL; /* uncompressed palettised image */
121 pkt->data[6] = 1; /* palette contains 256 entries */
122 pkt->data[7] = pal_bpp; /* palette contains pal_bpp bit entries */
123 pkt->data[16] = 8; /* bpp */
124 for (i = 0; i < 256; i++)
126 AV_WL32(pkt->data + 18 + 4 * i, *(uint32_t *)(p->data[1] + i * 4));
128 AV_WL24(pkt->data + 18 + 3 * i, *(uint32_t *)(p->data[1] + i * 4));
130 out += 32 * pal_bpp; /* skip past the palette we just output */
133 case AV_PIX_FMT_GRAY8:
134 pkt->data[2] = TGA_BW; /* uncompressed grayscale image */
135 avctx->bits_per_coded_sample = 0x28;
136 pkt->data[16] = 8; /* bpp */
138 case AV_PIX_FMT_RGB555LE:
139 pkt->data[2] = TGA_RGB; /* uncompressed true-color image */
140 avctx->bits_per_coded_sample =
141 pkt->data[16] = 16; /* bpp */
143 case AV_PIX_FMT_BGR24:
144 pkt->data[2] = TGA_RGB; /* uncompressed true-color image */
145 pkt->data[16] = 24; /* bpp */
147 case AV_PIX_FMT_BGRA:
148 pkt->data[2] = TGA_RGB; /* uncompressed true-color image */
149 pkt->data[16] = 32; /* bpp */
152 av_log(avctx, AV_LOG_ERROR, "Pixel format '%s' not supported.\n",
153 av_get_pix_fmt_name(avctx->pix_fmt));
154 return AVERROR(EINVAL);
156 bpp = pkt->data[16] >> 3;
159 #if FF_API_CODER_TYPE
160 FF_DISABLE_DEPRECATION_WARNINGS
161 if (avctx->coder_type == FF_CODER_TYPE_RAW)
163 FF_ENABLE_DEPRECATION_WARNINGS
166 /* try RLE compression */
168 datasize = targa_encode_rle(out, picsize, p, bpp, avctx->width, avctx->height);
170 /* if that worked well, mark the picture as RLE compressed */
172 pkt->data[2] |= TGA_RLE;
174 /* if RLE didn't make it smaller, go back to no compression */
175 else datasize = targa_encode_normal(out, p, bpp, avctx->width, avctx->height);
179 /* The standard recommends including this section, even if we don't use
180 * any of the features it affords. TODO: take advantage of the pixel
181 * aspect ratio and encoder ID fields available? */
182 memcpy(out, "\0\0\0\0\0\0\0\0TRUEVISION-XFILE.", 26);
184 pkt->size = out + 26 - pkt->data;
185 pkt->flags |= AV_PKT_FLAG_KEY;
191 static av_cold int targa_encode_init(AVCodecContext *avctx)
193 #if FF_API_CODED_FRAME
194 FF_DISABLE_DEPRECATION_WARNINGS
195 avctx->coded_frame->key_frame = 1;
196 avctx->coded_frame->pict_type = AV_PICTURE_TYPE_I;
197 FF_ENABLE_DEPRECATION_WARNINGS
203 #define OFFSET(x) offsetof(TargaContext, x)
204 #define VE AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_ENCODING_PARAM
205 static const AVOption options[] = {
206 { "rle", "Use run-length compression", OFFSET(rle), AV_OPT_TYPE_INT, { .i64 = 1 }, 0, 1, VE },
211 static const AVClass targa_class = {
212 .class_name = "targa",
213 .item_name = av_default_item_name,
215 .version = LIBAVUTIL_VERSION_INT,
218 AVCodec ff_targa_encoder = {
220 .long_name = NULL_IF_CONFIG_SMALL("Truevision Targa image"),
221 .type = AVMEDIA_TYPE_VIDEO,
222 .id = AV_CODEC_ID_TARGA,
223 .priv_data_size = sizeof(TargaContext),
224 .priv_class = &targa_class,
225 .init = targa_encode_init,
226 .encode2 = targa_encode_frame,
227 .pix_fmts = (const enum AVPixelFormat[]){
228 AV_PIX_FMT_BGR24, AV_PIX_FMT_BGRA, AV_PIX_FMT_RGB555LE, AV_PIX_FMT_GRAY8, AV_PIX_FMT_PAL8,