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
30 #include "libavutil/avassert.h"
31 #include "libavutil/colorspace.h"
32 #include "libavutil/common.h"
33 #include "libavutil/pixdesc.h"
34 #include "libavutil/internal.h"
35 #include "libavutil/imgutils.h"
38 void avcodec_get_chroma_sub_sample(enum AVPixelFormat pix_fmt, int *h_shift, int *v_shift)
40 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
42 *h_shift = desc->log2_chroma_w;
43 *v_shift = desc->log2_chroma_h;
47 int avcodec_get_pix_fmt_loss(enum AVPixelFormat dst_pix_fmt,
48 enum AVPixelFormat src_pix_fmt,
51 return av_get_pix_fmt_loss(dst_pix_fmt, src_pix_fmt, has_alpha);
54 enum AVPixelFormat avcodec_find_best_pix_fmt_of_2(enum AVPixelFormat dst_pix_fmt1, enum AVPixelFormat dst_pix_fmt2,
55 enum AVPixelFormat src_pix_fmt, int has_alpha, int *loss_ptr)
57 return av_find_best_pix_fmt_of_2(dst_pix_fmt1, dst_pix_fmt2, src_pix_fmt, has_alpha, loss_ptr);
60 #if AV_HAVE_INCOMPATIBLE_LIBAV_ABI
61 enum AVPixelFormat avcodec_find_best_pix_fmt2(const enum AVPixelFormat *pix_fmt_list,
62 enum AVPixelFormat src_pix_fmt,
63 int has_alpha, int *loss_ptr){
64 return avcodec_find_best_pix_fmt_of_list(pix_fmt_list, src_pix_fmt, has_alpha, loss_ptr);
67 enum AVPixelFormat avcodec_find_best_pix_fmt2(enum AVPixelFormat dst_pix_fmt1, enum AVPixelFormat dst_pix_fmt2,
68 enum AVPixelFormat src_pix_fmt, int has_alpha, int *loss_ptr)
70 return avcodec_find_best_pix_fmt_of_2(dst_pix_fmt1, dst_pix_fmt2, src_pix_fmt, has_alpha, loss_ptr);
74 enum AVPixelFormat avcodec_find_best_pix_fmt_of_list(const enum AVPixelFormat *pix_fmt_list,
75 enum AVPixelFormat src_pix_fmt,
76 int has_alpha, int *loss_ptr){
79 enum AVPixelFormat best = AV_PIX_FMT_NONE;
81 for(i=0; pix_fmt_list[i] != AV_PIX_FMT_NONE; i++)
82 best = avcodec_find_best_pix_fmt_of_2(best, pix_fmt_list[i], src_pix_fmt, has_alpha, loss_ptr);
88 FF_DISABLE_DEPRECATION_WARNINGS
89 /* return true if yuv planar */
90 static inline int is_yuv_planar(const AVPixFmtDescriptor *desc)
93 int planes[4] = { 0 };
95 if ( desc->flags & AV_PIX_FMT_FLAG_RGB
96 || !(desc->flags & AV_PIX_FMT_FLAG_PLANAR))
99 /* set the used planes */
100 for (i = 0; i < desc->nb_components; i++)
101 planes[desc->comp[i].plane] = 1;
103 /* if there is an unused plane, the format is not planar */
104 for (i = 0; i < desc->nb_components; i++)
110 int av_picture_crop(AVPicture *dst, const AVPicture *src,
111 enum AVPixelFormat pix_fmt, int top_band, int left_band)
113 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
118 if (pix_fmt < 0 || pix_fmt >= AV_PIX_FMT_NB)
121 y_shift = desc->log2_chroma_h;
122 x_shift = desc->log2_chroma_w;
123 av_image_fill_max_pixsteps(max_step, NULL, desc);
125 if (is_yuv_planar(desc)) {
126 dst->data[0] = src->data[0] + (top_band * src->linesize[0]) + left_band;
127 dst->data[1] = src->data[1] + ((top_band >> y_shift) * src->linesize[1]) + (left_band >> x_shift);
128 dst->data[2] = src->data[2] + ((top_band >> y_shift) * src->linesize[2]) + (left_band >> x_shift);
130 if(top_band % (1<<y_shift) || left_band % (1<<x_shift))
132 dst->data[0] = src->data[0] + (top_band * src->linesize[0]) + (left_band * max_step[0]);
135 dst->linesize[0] = src->linesize[0];
136 dst->linesize[1] = src->linesize[1];
137 dst->linesize[2] = src->linesize[2];
141 int av_picture_pad(AVPicture *dst, const AVPicture *src, int height, int width,
142 enum AVPixelFormat pix_fmt, int padtop, int padbottom, int padleft, int padright,
145 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(pix_fmt);
153 if (pix_fmt < 0 || pix_fmt >= AV_PIX_FMT_NB)
156 if (!is_yuv_planar(desc)) {
158 return -1; //TODO: Not yet implemented
160 av_image_fill_max_pixsteps(max_step, NULL, desc);
162 if (padtop || padleft) {
163 memset(dst->data[0], color[0],
164 dst->linesize[0] * padtop + (padleft * max_step[0]));
167 if (padleft || padright) {
168 optr = dst->data[0] + dst->linesize[0] * padtop +
169 (dst->linesize[0] - (padright * max_step[0]));
170 yheight = height - 1 - (padtop + padbottom);
171 for (y = 0; y < yheight; y++) {
172 memset(optr, color[0], (padleft + padright) * max_step[0]);
173 optr += dst->linesize[0];
177 if (padbottom || padright) {
178 optr = dst->data[0] + dst->linesize[0] * (height - padbottom) -
179 (padright * max_step[0]);
180 memset(optr, color[0], dst->linesize[0] * padbottom +
181 (padright * max_step[0]));
187 for (i = 0; i < 3; i++) {
188 x_shift = i ? desc->log2_chroma_w : 0;
189 y_shift = i ? desc->log2_chroma_h : 0;
191 if (padtop || padleft) {
192 memset(dst->data[i], color[i],
193 dst->linesize[i] * (padtop >> y_shift) + (padleft >> x_shift));
196 if (padleft || padright) {
197 optr = dst->data[i] + dst->linesize[i] * (padtop >> y_shift) +
198 (dst->linesize[i] - (padright >> x_shift));
199 yheight = (height - 1 - (padtop + padbottom)) >> y_shift;
200 for (y = 0; y < yheight; y++) {
201 memset(optr, color[i], (padleft + padright) >> x_shift);
202 optr += dst->linesize[i];
206 if (src) { /* first line */
207 uint8_t *iptr = src->data[i];
208 optr = dst->data[i] + dst->linesize[i] * (padtop >> y_shift) +
209 (padleft >> x_shift);
210 memcpy(optr, iptr, (width - padleft - padright) >> x_shift);
211 iptr += src->linesize[i];
212 optr = dst->data[i] + dst->linesize[i] * (padtop >> y_shift) +
213 (dst->linesize[i] - (padright >> x_shift));
214 yheight = (height - 1 - (padtop + padbottom)) >> y_shift;
215 for (y = 0; y < yheight; y++) {
216 memset(optr, color[i], (padleft + padright) >> x_shift);
217 memcpy(optr + ((padleft + padright) >> x_shift), iptr,
218 (width - padleft - padright) >> x_shift);
219 iptr += src->linesize[i];
220 optr += dst->linesize[i];
224 if (padbottom || padright) {
225 optr = dst->data[i] + dst->linesize[i] *
226 ((height - padbottom) >> y_shift) - (padright >> x_shift);
227 memset(optr, color[i],dst->linesize[i] *
228 (padbottom >> y_shift) + (padright >> x_shift));
242 for (i=0; i<AV_PIX_FMT_NB*2; i++) {
243 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(i);
244 if(!desc || !desc->name) {
249 av_log(NULL, AV_LOG_INFO, "%3d unused pixel format values\n", skip);
252 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));
253 if ((!(desc->flags & AV_PIX_FMT_FLAG_ALPHA)) != (desc->nb_components != 2 && desc->nb_components != 4)) {
254 av_log(NULL, AV_LOG_ERROR, "Alpha flag mismatch\n");
262 FF_ENABLE_DEPRECATION_WARNINGS
263 #endif /* FF_API_AVPICTURE */