2 * Misc image conversion routines
3 * Copyright (c) 2001, 2002, 2003 Fabrice Bellard
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 * misc image conversion routines
28 * - write 'ffimg' program to test all the image related stuff
29 * - move all api to slice based system
30 * - integrate deinterlacing, postprocessing and scaling in the conversion process
34 #include "imgconvert.h"
37 #include "libavutil/avassert.h"
38 #include "libavutil/colorspace.h"
39 #include "libavutil/common.h"
40 #include "libavutil/pixdesc.h"
41 #include "libavutil/imgutils.h"
43 void avcodec_get_chroma_sub_sample(enum AVPixelFormat pix_fmt, int *h_shift, int *v_shift)
45 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
47 *h_shift = desc->log2_chroma_w;
48 *v_shift = desc->log2_chroma_h;
51 int avcodec_get_pix_fmt_loss(enum AVPixelFormat dst_pix_fmt,
52 enum AVPixelFormat src_pix_fmt,
55 return av_get_pix_fmt_loss(dst_pix_fmt, src_pix_fmt, has_alpha);
58 enum AVPixelFormat avcodec_find_best_pix_fmt_of_2(enum AVPixelFormat dst_pix_fmt1, enum AVPixelFormat dst_pix_fmt2,
59 enum AVPixelFormat src_pix_fmt, int has_alpha, int *loss_ptr)
61 return av_find_best_pix_fmt_of_2(dst_pix_fmt1, dst_pix_fmt2, src_pix_fmt, has_alpha, loss_ptr);
64 #if AV_HAVE_INCOMPATIBLE_LIBAV_ABI
65 enum AVPixelFormat avcodec_find_best_pix_fmt2(const enum AVPixelFormat *pix_fmt_list,
66 enum AVPixelFormat src_pix_fmt,
67 int has_alpha, int *loss_ptr){
68 return avcodec_find_best_pix_fmt_of_list(pix_fmt_list, src_pix_fmt, has_alpha, loss_ptr);
71 enum AVPixelFormat avcodec_find_best_pix_fmt2(enum AVPixelFormat dst_pix_fmt1, enum AVPixelFormat dst_pix_fmt2,
72 enum AVPixelFormat src_pix_fmt, int has_alpha, int *loss_ptr)
74 return avcodec_find_best_pix_fmt_of_2(dst_pix_fmt1, dst_pix_fmt2, src_pix_fmt, has_alpha, loss_ptr);
78 enum AVPixelFormat avcodec_find_best_pix_fmt_of_list(const enum AVPixelFormat *pix_fmt_list,
79 enum AVPixelFormat src_pix_fmt,
80 int has_alpha, int *loss_ptr){
83 enum AVPixelFormat best = AV_PIX_FMT_NONE;
85 for(i=0; pix_fmt_list[i] != AV_PIX_FMT_NONE; i++)
86 best = avcodec_find_best_pix_fmt_of_2(best, pix_fmt_list[i], src_pix_fmt, has_alpha, loss_ptr);
92 void ff_shrink22(uint8_t *dst, int dst_wrap,
93 const uint8_t *src, int src_wrap,
94 int width, int height)
97 const uint8_t *s1, *s2;
100 for(;height > 0; height--) {
104 for(w = width;w >= 4; w-=4) {
105 d[0] = (s1[0] + s1[1] + s2[0] + s2[1] + 2) >> 2;
106 d[1] = (s1[2] + s1[3] + s2[2] + s2[3] + 2) >> 2;
107 d[2] = (s1[4] + s1[5] + s2[4] + s2[5] + 2) >> 2;
108 d[3] = (s1[6] + s1[7] + s2[6] + s2[7] + 2) >> 2;
114 d[0] = (s1[0] + s1[1] + s2[0] + s2[1] + 2) >> 2;
125 void ff_shrink44(uint8_t *dst, int dst_wrap,
126 const uint8_t *src, int src_wrap,
127 int width, int height)
130 const uint8_t *s1, *s2, *s3, *s4;
133 for(;height > 0; height--) {
139 for(w = width;w > 0; w--) {
140 d[0] = (s1[0] + s1[1] + s1[2] + s1[3] +
141 s2[0] + s2[1] + s2[2] + s2[3] +
142 s3[0] + s3[1] + s3[2] + s3[3] +
143 s4[0] + s4[1] + s4[2] + s4[3] + 8) >> 4;
156 void ff_shrink88(uint8_t *dst, int dst_wrap,
157 const uint8_t *src, int src_wrap,
158 int width, int height)
162 for(;height > 0; height--) {
163 for(w = width;w > 0; w--) {
166 tmp += src[0] + src[1] + src[2] + src[3] + src[4] + src[5] + src[6] + src[7];
169 *(dst++) = (tmp + 32)>>6;
170 src += 8 - 8*src_wrap;
172 src += 8*src_wrap - 8*width;
173 dst += dst_wrap - width;
177 /* return true if yuv planar */
178 static inline int is_yuv_planar(const AVPixFmtDescriptor *desc)
181 int planes[4] = { 0 };
183 if ( desc->flags & AV_PIX_FMT_FLAG_RGB
184 || !(desc->flags & AV_PIX_FMT_FLAG_PLANAR))
187 /* set the used planes */
188 for (i = 0; i < desc->nb_components; i++)
189 planes[desc->comp[i].plane] = 1;
191 /* if there is an unused plane, the format is not planar */
192 for (i = 0; i < desc->nb_components; i++)
199 int av_picture_crop(AVPicture *dst, const AVPicture *src,
200 enum AVPixelFormat pix_fmt, int top_band, int left_band)
202 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
207 if (pix_fmt < 0 || pix_fmt >= AV_PIX_FMT_NB)
210 y_shift = desc->log2_chroma_h;
211 x_shift = desc->log2_chroma_w;
212 av_image_fill_max_pixsteps(max_step, NULL, desc);
214 if (is_yuv_planar(desc)) {
215 dst->data[0] = src->data[0] + (top_band * src->linesize[0]) + left_band;
216 dst->data[1] = src->data[1] + ((top_band >> y_shift) * src->linesize[1]) + (left_band >> x_shift);
217 dst->data[2] = src->data[2] + ((top_band >> y_shift) * src->linesize[2]) + (left_band >> x_shift);
219 if(top_band % (1<<y_shift) || left_band % (1<<x_shift))
221 dst->data[0] = src->data[0] + (top_band * src->linesize[0]) + (left_band * max_step[0]);
224 dst->linesize[0] = src->linesize[0];
225 dst->linesize[1] = src->linesize[1];
226 dst->linesize[2] = src->linesize[2];
230 int av_picture_pad(AVPicture *dst, const AVPicture *src, int height, int width,
231 enum AVPixelFormat pix_fmt, int padtop, int padbottom, int padleft, int padright,
234 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
242 if (pix_fmt < 0 || pix_fmt >= AV_PIX_FMT_NB)
245 if (!is_yuv_planar(desc)) {
247 return -1; //TODO: Not yet implemented
249 av_image_fill_max_pixsteps(max_step, NULL, desc);
251 if (padtop || padleft) {
252 memset(dst->data[0], color[0],
253 dst->linesize[0] * padtop + (padleft * max_step[0]));
256 if (padleft || padright) {
257 optr = dst->data[0] + dst->linesize[0] * padtop +
258 (dst->linesize[0] - (padright * max_step[0]));
259 yheight = height - 1 - (padtop + padbottom);
260 for (y = 0; y < yheight; y++) {
261 memset(optr, color[0], (padleft + padright) * max_step[0]);
262 optr += dst->linesize[0];
266 if (padbottom || padright) {
267 optr = dst->data[0] + dst->linesize[0] * (height - padbottom) -
268 (padright * max_step[0]);
269 memset(optr, color[0], dst->linesize[0] * padbottom +
270 (padright * max_step[0]));
276 for (i = 0; i < 3; i++) {
277 x_shift = i ? desc->log2_chroma_w : 0;
278 y_shift = i ? desc->log2_chroma_h : 0;
280 if (padtop || padleft) {
281 memset(dst->data[i], color[i],
282 dst->linesize[i] * (padtop >> y_shift) + (padleft >> x_shift));
285 if (padleft || padright) {
286 optr = dst->data[i] + dst->linesize[i] * (padtop >> y_shift) +
287 (dst->linesize[i] - (padright >> x_shift));
288 yheight = (height - 1 - (padtop + padbottom)) >> y_shift;
289 for (y = 0; y < yheight; y++) {
290 memset(optr, color[i], (padleft + padright) >> x_shift);
291 optr += dst->linesize[i];
295 if (src) { /* first line */
296 uint8_t *iptr = src->data[i];
297 optr = dst->data[i] + dst->linesize[i] * (padtop >> y_shift) +
298 (padleft >> x_shift);
299 memcpy(optr, iptr, (width - padleft - padright) >> x_shift);
300 iptr += src->linesize[i];
301 optr = dst->data[i] + dst->linesize[i] * (padtop >> y_shift) +
302 (dst->linesize[i] - (padright >> x_shift));
303 yheight = (height - 1 - (padtop + padbottom)) >> y_shift;
304 for (y = 0; y < yheight; y++) {
305 memset(optr, color[i], (padleft + padright) >> x_shift);
306 memcpy(optr + ((padleft + padright) >> x_shift), iptr,
307 (width - padleft - padright) >> x_shift);
308 iptr += src->linesize[i];
309 optr += dst->linesize[i];
313 if (padbottom || padright) {
314 optr = dst->data[i] + dst->linesize[i] *
315 ((height - padbottom) >> y_shift) - (padright >> x_shift);
316 memset(optr, color[i],dst->linesize[i] *
317 (padbottom >> y_shift) + (padright >> x_shift));
331 for (i=0; i<AV_PIX_FMT_NB*2; i++) {
332 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(i);
333 if(!desc || !desc->name) {
338 av_log(NULL, AV_LOG_INFO, "%3d unused pixel format values\n", skip);
341 av_log(NULL, AV_LOG_INFO, "pix fmt %s yuv_plan:%d avg_bpp:%d\n", desc->name, is_yuv_planar(desc), av_get_padded_bits_per_pixel(desc));
342 if ((!(desc->flags & AV_PIX_FMT_FLAG_ALPHA)) != (desc->nb_components != 2 && desc->nb_components != 4)) {
343 av_log(NULL, AV_LOG_ERROR, "Alpha flag mismatch\n");
351 #endif /* FF_API_AVPICTURE */