git.sesse.net Git - ffmpeg/blob - libavcodec/imgconvert.c

   1 /*
   2  * Misc image conversion routines
   3  * Copyright (c) 2001, 2002, 2003 Fabrice Bellard
   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 /**
  23  * @file
  24  * misc image conversion routines
  25  */
  26
  27 /* TODO:
  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
  31  */
  32
  33 #include "avcodec.h"
  34 #include "dsputil.h"
  35 #include "internal.h"
  36 #include "imgconvert.h"
  37 #include "libavutil/colorspace.h"
  38 #include "libavutil/pixdesc.h"
  39 #include "libavcore/imgutils.h"
  40
  41 #if HAVE_MMX && HAVE_YASM
  42 #include "x86/dsputil_mmx.h"
  43 #endif
  44
  45 #define xglue(x, y) x ## y
  46 #define glue(x, y) xglue(x, y)
  47
  48 #define FF_COLOR_RGB      0 /**< RGB color space */
  49 #define FF_COLOR_GRAY     1 /**< gray color space */
  50 #define FF_COLOR_YUV      2 /**< YUV color space. 16 <= Y <= 235, 16 <= U, V <= 240 */
  51 #define FF_COLOR_YUV_JPEG 3 /**< YUV color space. 0 <= Y <= 255, 0 <= U, V <= 255 */
  52
  53 #define FF_PIXEL_PLANAR   0 /**< each channel has one component in AVPicture */
  54 #define FF_PIXEL_PACKED   1 /**< only one components containing all the channels */
  55 #define FF_PIXEL_PALETTE  2  /**< one components containing indexes for a palette */
  56
  57 #if HAVE_MMX && HAVE_YASM
  58 #define deinterlace_line_inplace ff_deinterlace_line_inplace_mmx
  59 #define deinterlace_line         ff_deinterlace_line_mmx
  60 #else
  61 #define deinterlace_line_inplace deinterlace_line_inplace_c
  62 #define deinterlace_line         deinterlace_line_c
  63 #endif
  64
  65 typedef struct PixFmtInfo {
  66     uint8_t nb_channels;     /**< number of channels (including alpha) */
  67     uint8_t color_type;      /**< color type (see FF_COLOR_xxx constants) */
  68     uint8_t pixel_type;      /**< pixel storage type (see FF_PIXEL_xxx constants) */
  69     uint8_t is_alpha : 1;    /**< true if alpha can be specified */
  70     uint8_t depth;           /**< bit depth of the color components */
  71 } PixFmtInfo;
  72
  73 /* this table gives more information about formats */
  74 static const PixFmtInfo pix_fmt_info[PIX_FMT_NB] = {
  75     /* YUV formats */
  76     [PIX_FMT_YUV420P] = {
  77         .nb_channels = 3,
  78         .color_type = FF_COLOR_YUV,
  79         .pixel_type = FF_PIXEL_PLANAR,
  80         .depth = 8,
  81     },
  82     [PIX_FMT_YUV422P] = {
  83         .nb_channels = 3,
  84         .color_type = FF_COLOR_YUV,
  85         .pixel_type = FF_PIXEL_PLANAR,
  86         .depth = 8,
  87     },
  88     [PIX_FMT_YUV444P] = {
  89         .nb_channels = 3,
  90         .color_type = FF_COLOR_YUV,
  91         .pixel_type = FF_PIXEL_PLANAR,
  92         .depth = 8,
  93     },
  94     [PIX_FMT_YUYV422] = {
  95         .nb_channels = 1,
  96         .color_type = FF_COLOR_YUV,
  97         .pixel_type = FF_PIXEL_PACKED,
  98         .depth = 8,
  99     },
 100     [PIX_FMT_UYVY422] = {
 101         .nb_channels = 1,
 102         .color_type = FF_COLOR_YUV,
 103         .pixel_type = FF_PIXEL_PACKED,
 104         .depth = 8,
 105     },
 106     [PIX_FMT_YUV410P] = {
 107         .nb_channels = 3,
 108         .color_type = FF_COLOR_YUV,
 109         .pixel_type = FF_PIXEL_PLANAR,
 110         .depth = 8,
 111     },
 112     [PIX_FMT_YUV411P] = {
 113         .nb_channels = 3,
 114         .color_type = FF_COLOR_YUV,
 115         .pixel_type = FF_PIXEL_PLANAR,
 116         .depth = 8,
 117     },
 118     [PIX_FMT_YUV440P] = {
 119         .nb_channels = 3,
 120         .color_type = FF_COLOR_YUV,
 121         .pixel_type = FF_PIXEL_PLANAR,
 122         .depth = 8,
 123     },
 124     [PIX_FMT_YUV420P16LE] = {
 125         .nb_channels = 3,
 126         .color_type = FF_COLOR_YUV,
 127         .pixel_type = FF_PIXEL_PLANAR,
 128         .depth = 16,
 129     },
 130     [PIX_FMT_YUV422P16LE] = {
 131         .nb_channels = 3,
 132         .color_type = FF_COLOR_YUV,
 133         .pixel_type = FF_PIXEL_PLANAR,
 134         .depth = 16,
 135     },
 136     [PIX_FMT_YUV444P16LE] = {
 137         .nb_channels = 3,
 138         .color_type = FF_COLOR_YUV,
 139         .pixel_type = FF_PIXEL_PLANAR,
 140         .depth = 16,
 141     },
 142     [PIX_FMT_YUV420P16BE] = {
 143         .nb_channels = 3,
 144         .color_type = FF_COLOR_YUV,
 145         .pixel_type = FF_PIXEL_PLANAR,
 146         .depth = 16,
 147     },
 148     [PIX_FMT_YUV422P16BE] = {
 149         .nb_channels = 3,
 150         .color_type = FF_COLOR_YUV,
 151         .pixel_type = FF_PIXEL_PLANAR,
 152         .depth = 16,
 153     },
 154     [PIX_FMT_YUV444P16BE] = {
 155         .nb_channels = 3,
 156         .color_type = FF_COLOR_YUV,
 157         .pixel_type = FF_PIXEL_PLANAR,
 158         .depth = 16,
 159     },
 160
 161
 162     /* YUV formats with alpha plane */
 163     [PIX_FMT_YUVA420P] = {
 164         .nb_channels = 4,
 165         .color_type = FF_COLOR_YUV,
 166         .pixel_type = FF_PIXEL_PLANAR,
 167         .depth = 8,
 168     },
 169
 170     /* JPEG YUV */
 171     [PIX_FMT_YUVJ420P] = {
 172         .nb_channels = 3,
 173         .color_type = FF_COLOR_YUV_JPEG,
 174         .pixel_type = FF_PIXEL_PLANAR,
 175         .depth = 8,
 176     },
 177     [PIX_FMT_YUVJ422P] = {
 178         .nb_channels = 3,
 179         .color_type = FF_COLOR_YUV_JPEG,
 180         .pixel_type = FF_PIXEL_PLANAR,
 181         .depth = 8,
 182     },
 183     [PIX_FMT_YUVJ444P] = {
 184         .nb_channels = 3,
 185         .color_type = FF_COLOR_YUV_JPEG,
 186         .pixel_type = FF_PIXEL_PLANAR,
 187         .depth = 8,
 188     },
 189     [PIX_FMT_YUVJ440P] = {
 190         .nb_channels = 3,
 191         .color_type = FF_COLOR_YUV_JPEG,
 192         .pixel_type = FF_PIXEL_PLANAR,
 193         .depth = 8,
 194     },
 195
 196     /* RGB formats */
 197     [PIX_FMT_RGB24] = {
 198         .nb_channels = 3,
 199         .color_type = FF_COLOR_RGB,
 200         .pixel_type = FF_PIXEL_PACKED,
 201         .depth = 8,
 202     },
 203     [PIX_FMT_BGR24] = {
 204         .nb_channels = 3,
 205         .color_type = FF_COLOR_RGB,
 206         .pixel_type = FF_PIXEL_PACKED,
 207         .depth = 8,
 208     },
 209     [PIX_FMT_ARGB] = {
 210         .nb_channels = 4, .is_alpha = 1,
 211         .color_type = FF_COLOR_RGB,
 212         .pixel_type = FF_PIXEL_PACKED,
 213         .depth = 8,
 214     },
 215     [PIX_FMT_RGB48BE] = {
 216         .nb_channels = 3,
 217         .color_type = FF_COLOR_RGB,
 218         .pixel_type = FF_PIXEL_PACKED,
 219         .depth = 16,
 220     },
 221     [PIX_FMT_RGB48LE] = {
 222         .nb_channels = 3,
 223         .color_type = FF_COLOR_RGB,
 224         .pixel_type = FF_PIXEL_PACKED,
 225         .depth = 16,
 226     },
 227     [PIX_FMT_RGB565BE] = {
 228         .nb_channels = 3,
 229         .color_type = FF_COLOR_RGB,
 230         .pixel_type = FF_PIXEL_PACKED,
 231         .depth = 5,
 232     },
 233     [PIX_FMT_RGB565LE] = {
 234         .nb_channels = 3,
 235         .color_type = FF_COLOR_RGB,
 236         .pixel_type = FF_PIXEL_PACKED,
 237         .depth = 5,
 238     },
 239     [PIX_FMT_RGB555BE] = {
 240         .nb_channels = 3,
 241         .color_type = FF_COLOR_RGB,
 242         .pixel_type = FF_PIXEL_PACKED,
 243         .depth = 5,
 244     },
 245     [PIX_FMT_RGB555LE] = {
 246         .nb_channels = 3,
 247         .color_type = FF_COLOR_RGB,
 248         .pixel_type = FF_PIXEL_PACKED,
 249         .depth = 5,
 250     },
 251     [PIX_FMT_RGB444BE] = {
 252         .nb_channels = 3,
 253         .color_type = FF_COLOR_RGB,
 254         .pixel_type = FF_PIXEL_PACKED,
 255         .depth = 4,
 256     },
 257     [PIX_FMT_RGB444LE] = {
 258         .nb_channels = 3,
 259         .color_type = FF_COLOR_RGB,
 260         .pixel_type = FF_PIXEL_PACKED,
 261         .depth = 4,
 262     },
 263
 264     /* gray / mono formats */
 265     [PIX_FMT_GRAY16BE] = {
 266         .nb_channels = 1,
 267         .color_type = FF_COLOR_GRAY,
 268         .pixel_type = FF_PIXEL_PLANAR,
 269         .depth = 16,
 270     },
 271     [PIX_FMT_GRAY16LE] = {
 272         .nb_channels = 1,
 273         .color_type = FF_COLOR_GRAY,
 274         .pixel_type = FF_PIXEL_PLANAR,
 275         .depth = 16,
 276     },
 277     [PIX_FMT_GRAY8] = {
 278         .nb_channels = 1,
 279         .color_type = FF_COLOR_GRAY,
 280         .pixel_type = FF_PIXEL_PLANAR,
 281         .depth = 8,
 282     },
 283     [PIX_FMT_MONOWHITE] = {
 284         .nb_channels = 1,
 285         .color_type = FF_COLOR_GRAY,
 286         .pixel_type = FF_PIXEL_PLANAR,
 287         .depth = 1,
 288     },
 289     [PIX_FMT_MONOBLACK] = {
 290         .nb_channels = 1,
 291         .color_type = FF_COLOR_GRAY,
 292         .pixel_type = FF_PIXEL_PLANAR,
 293         .depth = 1,
 294     },
 295
 296     /* paletted formats */
 297     [PIX_FMT_PAL8] = {
 298         .nb_channels = 4, .is_alpha = 1,
 299         .color_type = FF_COLOR_RGB,
 300         .pixel_type = FF_PIXEL_PALETTE,
 301         .depth = 8,
 302     },
 303     [PIX_FMT_UYYVYY411] = {
 304         .nb_channels = 1,
 305         .color_type = FF_COLOR_YUV,
 306         .pixel_type = FF_PIXEL_PACKED,
 307         .depth = 8,
 308     },
 309     [PIX_FMT_ABGR] = {
 310         .nb_channels = 4, .is_alpha = 1,
 311         .color_type = FF_COLOR_RGB,
 312         .pixel_type = FF_PIXEL_PACKED,
 313         .depth = 8,
 314     },
 315     [PIX_FMT_BGR565BE] = {
 316         .nb_channels = 3,
 317         .color_type = FF_COLOR_RGB,
 318         .pixel_type = FF_PIXEL_PACKED,
 319         .depth = 5,
 320     },
 321     [PIX_FMT_BGR565LE] = {
 322         .nb_channels = 3,
 323         .color_type = FF_COLOR_RGB,
 324         .pixel_type = FF_PIXEL_PACKED,
 325         .depth = 5,
 326     },
 327     [PIX_FMT_BGR555BE] = {
 328         .nb_channels = 3,
 329         .color_type = FF_COLOR_RGB,
 330         .pixel_type = FF_PIXEL_PACKED,
 331         .depth = 5,
 332     },
 333     [PIX_FMT_BGR555LE] = {
 334         .nb_channels = 3,
 335         .color_type = FF_COLOR_RGB,
 336         .pixel_type = FF_PIXEL_PACKED,
 337         .depth = 5,
 338     },
 339     [PIX_FMT_BGR444BE] = {
 340         .nb_channels = 3,
 341         .color_type = FF_COLOR_RGB,
 342         .pixel_type = FF_PIXEL_PACKED,
 343         .depth = 4,
 344     },
 345     [PIX_FMT_BGR444LE] = {
 346         .nb_channels = 3,
 347         .color_type = FF_COLOR_RGB,
 348         .pixel_type = FF_PIXEL_PACKED,
 349         .depth = 4,
 350     },
 351     [PIX_FMT_RGB8] = {
 352         .nb_channels = 1,
 353         .color_type = FF_COLOR_RGB,
 354         .pixel_type = FF_PIXEL_PACKED,
 355         .depth = 8,
 356     },
 357     [PIX_FMT_RGB4] = {
 358         .nb_channels = 1,
 359         .color_type = FF_COLOR_RGB,
 360         .pixel_type = FF_PIXEL_PACKED,
 361         .depth = 4,
 362     },
 363     [PIX_FMT_RGB4_BYTE] = {
 364         .nb_channels = 1,
 365         .color_type = FF_COLOR_RGB,
 366         .pixel_type = FF_PIXEL_PACKED,
 367         .depth = 8,
 368     },
 369     [PIX_FMT_BGR8] = {
 370         .nb_channels = 1,
 371         .color_type = FF_COLOR_RGB,
 372         .pixel_type = FF_PIXEL_PACKED,
 373         .depth = 8,
 374     },
 375     [PIX_FMT_BGR4] = {
 376         .nb_channels = 1,
 377         .color_type = FF_COLOR_RGB,
 378         .pixel_type = FF_PIXEL_PACKED,
 379         .depth = 4,
 380     },
 381     [PIX_FMT_BGR4_BYTE] = {
 382         .nb_channels = 1,
 383         .color_type = FF_COLOR_RGB,
 384         .pixel_type = FF_PIXEL_PACKED,
 385         .depth = 8,
 386     },
 387     [PIX_FMT_NV12] = {
 388         .nb_channels = 2,
 389         .color_type = FF_COLOR_YUV,
 390         .pixel_type = FF_PIXEL_PLANAR,
 391         .depth = 8,
 392     },
 393     [PIX_FMT_NV21] = {
 394         .nb_channels = 2,
 395         .color_type = FF_COLOR_YUV,
 396         .pixel_type = FF_PIXEL_PLANAR,
 397         .depth = 8,
 398     },
 399
 400     [PIX_FMT_BGRA] = {
 401         .nb_channels = 4, .is_alpha = 1,
 402         .color_type = FF_COLOR_RGB,
 403         .pixel_type = FF_PIXEL_PACKED,
 404         .depth = 8,
 405     },
 406     [PIX_FMT_RGBA] = {
 407         .nb_channels = 4, .is_alpha = 1,
 408         .color_type = FF_COLOR_RGB,
 409         .pixel_type = FF_PIXEL_PACKED,
 410         .depth = 8,
 411     },
 412 };
 413
 414 void avcodec_get_chroma_sub_sample(enum PixelFormat pix_fmt, int *h_shift, int *v_shift)
 415 {
 416     *h_shift = av_pix_fmt_descriptors[pix_fmt].log2_chroma_w;
 417     *v_shift = av_pix_fmt_descriptors[pix_fmt].log2_chroma_h;
 418 }
 419
 420 const char *avcodec_get_pix_fmt_name(enum PixelFormat pix_fmt)
 421 {
 422     if (pix_fmt < 0 || pix_fmt >= PIX_FMT_NB)
 423         return NULL;
 424     else
 425         return av_pix_fmt_descriptors[pix_fmt].name;
 426 }
 427
 428 #if LIBAVCODEC_VERSION_MAJOR < 53
 429 enum PixelFormat avcodec_get_pix_fmt(const char *name)
 430 {
 431     return av_get_pix_fmt(name);
 432 }
 433 #endif
 434
 435 void avcodec_pix_fmt_string (char *buf, int buf_size, enum PixelFormat pix_fmt)
 436 {
 437     /* print header */
 438     if (pix_fmt < 0)
 439         snprintf (buf, buf_size,
 440                   "name      " " nb_channels" " depth"
 441             );
 442     else{
 443         PixFmtInfo info= pix_fmt_info[pix_fmt];
 444
 445         snprintf (buf, buf_size,
 446                   "%-11s %5d %9d",
 447                   av_pix_fmt_descriptors[pix_fmt].name,
 448                   info.nb_channels,
 449                   info.depth
 450             );
 451     }
 452 }
 453
 454 int ff_is_hwaccel_pix_fmt(enum PixelFormat pix_fmt)
 455 {
 456     return av_pix_fmt_descriptors[pix_fmt].flags & PIX_FMT_HWACCEL;
 457 }
 458
 459 int ff_set_systematic_pal(uint32_t pal[256], enum PixelFormat pix_fmt){
 460     int i;
 461
 462     for(i=0; i<256; i++){
 463         int r,g,b;
 464
 465         switch(pix_fmt) {
 466         case PIX_FMT_RGB8:
 467             r= (i>>5    )*36;
 468             g= ((i>>2)&7)*36;
 469             b= (i&3     )*85;
 470             break;
 471         case PIX_FMT_BGR8:
 472             b= (i>>6    )*85;
 473             g= ((i>>3)&7)*36;
 474             r= (i&7     )*36;
 475             break;
 476         case PIX_FMT_RGB4_BYTE:
 477             r= (i>>3    )*255;
 478             g= ((i>>1)&3)*85;
 479             b= (i&1     )*255;
 480             break;
 481         case PIX_FMT_BGR4_BYTE:
 482             b= (i>>3    )*255;
 483             g= ((i>>1)&3)*85;
 484             r= (i&1     )*255;
 485             break;
 486         case PIX_FMT_GRAY8:
 487             r=b=g= i;
 488             break;
 489         default:
 490             return -1;
 491         }
 492         pal[i] =  b + (g<<8) + (r<<16);
 493     }
 494
 495     return 0;
 496 }
 497
 498 #if LIBAVCODEC_VERSION_MAJOR < 53
 499 int ff_fill_linesize(AVPicture *picture, enum PixelFormat pix_fmt, int width)
 500 {
 501     return av_image_fill_linesizes(picture->linesize, pix_fmt, width);
 502 }
 503
 504 int ff_fill_pointer(AVPicture *picture, uint8_t *ptr, enum PixelFormat pix_fmt,
 505                     int height)
 506 {
 507     return av_image_fill_pointers(picture->data, pix_fmt, height, ptr, picture->linesize);
 508 }
 509 #endif
 510
 511 int avpicture_fill(AVPicture *picture, uint8_t *ptr,
 512                    enum PixelFormat pix_fmt, int width, int height)
 513 {
 514     int ret;
 515
 516     if ((ret = av_image_check_size(width, height, 0, NULL)) < 0)
 517         return ret;
 518
 519     if ((ret = av_image_fill_linesizes(picture->linesize, pix_fmt, width)) < 0)
 520         return ret;
 521
 522     return av_image_fill_pointers(picture->data, pix_fmt, height, ptr, picture->linesize);
 523 }
 524
 525 int avpicture_layout(const AVPicture* src, enum PixelFormat pix_fmt, int width, int height,
 526                      unsigned char *dest, int dest_size)
 527 {
 528     const PixFmtInfo* pf = &pix_fmt_info[pix_fmt];
 529     const AVPixFmtDescriptor *desc = &av_pix_fmt_descriptors[pix_fmt];
 530     int i, j, w, ow, h, oh, data_planes;
 531     const unsigned char* s;
 532     int size = avpicture_get_size(pix_fmt, width, height);
 533
 534     if (size > dest_size || size < 0)
 535         return -1;
 536
 537     if (pf->pixel_type == FF_PIXEL_PACKED || pf->pixel_type == FF_PIXEL_PALETTE) {
 538         if (pix_fmt == PIX_FMT_YUYV422 ||
 539             pix_fmt == PIX_FMT_UYVY422 ||
 540             pix_fmt == PIX_FMT_BGR565BE ||
 541             pix_fmt == PIX_FMT_BGR565LE ||
 542             pix_fmt == PIX_FMT_BGR555BE ||
 543             pix_fmt == PIX_FMT_BGR555LE ||
 544             pix_fmt == PIX_FMT_BGR444BE ||
 545             pix_fmt == PIX_FMT_BGR444LE ||
 546             pix_fmt == PIX_FMT_RGB565BE ||
 547             pix_fmt == PIX_FMT_RGB565LE ||
 548             pix_fmt == PIX_FMT_RGB555BE ||
 549             pix_fmt == PIX_FMT_RGB555LE ||
 550             pix_fmt == PIX_FMT_RGB444BE ||
 551             pix_fmt == PIX_FMT_RGB444LE)
 552             w = width * 2;
 553         else if (pix_fmt == PIX_FMT_UYYVYY411)
 554             w = width + width/2;
 555         else if (pix_fmt == PIX_FMT_PAL8)
 556             w = width;
 557         else
 558             w = width * (pf->depth * pf->nb_channels / 8);
 559
 560         data_planes = 1;
 561         h = height;
 562     } else {
 563         data_planes = pf->nb_channels;
 564         w = (width*pf->depth + 7)/8;
 565         h = height;
 566     }
 567
 568     ow = w;
 569     oh = h;
 570
 571     for (i=0; i<data_planes; i++) {
 572         if (i == 1) {
 573             w = (- ((-width) >> desc->log2_chroma_w) * pf->depth + 7) / 8;
 574             h = -((-height) >> desc->log2_chroma_h);
 575             if (pix_fmt == PIX_FMT_NV12 || pix_fmt == PIX_FMT_NV21)
 576                 w <<= 1;
 577         } else if (i == 3) {
 578             w = ow;
 579             h = oh;
 580         }
 581         s = src->data[i];
 582         for(j=0; j<h; j++) {
 583             memcpy(dest, s, w);
 584             dest += w;
 585             s += src->linesize[i];
 586         }
 587     }
 588
 589     if (pf->pixel_type == FF_PIXEL_PALETTE)
 590         memcpy((unsigned char *)(((size_t)dest + 3) & ~3), src->data[1], 256 * 4);
 591
 592     return size;
 593 }
 594
 595 int avpicture_get_size(enum PixelFormat pix_fmt, int width, int height)
 596 {
 597     AVPicture dummy_pict;
 598     if(av_image_check_size(width, height, 0, NULL))
 599         return -1;
 600     switch (pix_fmt) {
 601     case PIX_FMT_RGB8:
 602     case PIX_FMT_BGR8:
 603     case PIX_FMT_RGB4_BYTE:
 604     case PIX_FMT_BGR4_BYTE:
 605     case PIX_FMT_GRAY8:
 606         // do not include palette for these pseudo-paletted formats
 607         return width * height;
 608     }
 609     return avpicture_fill(&dummy_pict, NULL, pix_fmt, width, height);
 610 }
 611
 612 int avcodec_get_pix_fmt_loss(enum PixelFormat dst_pix_fmt, enum PixelFormat src_pix_fmt,
 613                              int has_alpha)
 614 {
 615     const PixFmtInfo *pf, *ps;
 616     const AVPixFmtDescriptor *src_desc = &av_pix_fmt_descriptors[src_pix_fmt];
 617     const AVPixFmtDescriptor *dst_desc = &av_pix_fmt_descriptors[dst_pix_fmt];
 618     int loss;
 619
 620     ps = &pix_fmt_info[src_pix_fmt];
 621
 622     /* compute loss */
 623     loss = 0;
 624     pf = &pix_fmt_info[dst_pix_fmt];
 625     if (pf->depth < ps->depth ||
 626         ((dst_pix_fmt == PIX_FMT_RGB555BE || dst_pix_fmt == PIX_FMT_RGB555LE ||
 627           dst_pix_fmt == PIX_FMT_BGR555BE || dst_pix_fmt == PIX_FMT_BGR555LE) &&
 628          (src_pix_fmt == PIX_FMT_RGB565BE || src_pix_fmt == PIX_FMT_RGB565LE ||
 629           src_pix_fmt == PIX_FMT_BGR565BE || src_pix_fmt == PIX_FMT_BGR565LE)))
 630         loss |= FF_LOSS_DEPTH;
 631     if (dst_desc->log2_chroma_w > src_desc->log2_chroma_w ||
 632         dst_desc->log2_chroma_h > src_desc->log2_chroma_h)
 633         loss |= FF_LOSS_RESOLUTION;
 634     switch(pf->color_type) {
 635     case FF_COLOR_RGB:
 636         if (ps->color_type != FF_COLOR_RGB &&
 637             ps->color_type != FF_COLOR_GRAY)
 638             loss |= FF_LOSS_COLORSPACE;
 639         break;
 640     case FF_COLOR_GRAY:
 641         if (ps->color_type != FF_COLOR_GRAY)
 642             loss |= FF_LOSS_COLORSPACE;
 643         break;
 644     case FF_COLOR_YUV:
 645         if (ps->color_type != FF_COLOR_YUV)
 646             loss |= FF_LOSS_COLORSPACE;
 647         break;
 648     case FF_COLOR_YUV_JPEG:
 649         if (ps->color_type != FF_COLOR_YUV_JPEG &&
 650             ps->color_type != FF_COLOR_YUV &&
 651             ps->color_type != FF_COLOR_GRAY)
 652             loss |= FF_LOSS_COLORSPACE;
 653         break;
 654     default:
 655         /* fail safe test */
 656         if (ps->color_type != pf->color_type)
 657             loss |= FF_LOSS_COLORSPACE;
 658         break;
 659     }
 660     if (pf->color_type == FF_COLOR_GRAY &&
 661         ps->color_type != FF_COLOR_GRAY)
 662         loss |= FF_LOSS_CHROMA;
 663     if (!pf->is_alpha && (ps->is_alpha && has_alpha))
 664         loss |= FF_LOSS_ALPHA;
 665     if (pf->pixel_type == FF_PIXEL_PALETTE &&
 666         (ps->pixel_type != FF_PIXEL_PALETTE && ps->color_type != FF_COLOR_GRAY))
 667         loss |= FF_LOSS_COLORQUANT;
 668     return loss;
 669 }
 670
 671 static int avg_bits_per_pixel(enum PixelFormat pix_fmt)
 672 {
 673     int bits;
 674     const PixFmtInfo *pf;
 675     const AVPixFmtDescriptor *desc = &av_pix_fmt_descriptors[pix_fmt];
 676
 677     pf = &pix_fmt_info[pix_fmt];
 678     switch(pf->pixel_type) {
 679     case FF_PIXEL_PACKED:
 680         switch(pix_fmt) {
 681         case PIX_FMT_YUYV422:
 682         case PIX_FMT_UYVY422:
 683         case PIX_FMT_RGB565BE:
 684         case PIX_FMT_RGB565LE:
 685         case PIX_FMT_RGB555BE:
 686         case PIX_FMT_RGB555LE:
 687         case PIX_FMT_RGB444BE:
 688         case PIX_FMT_RGB444LE:
 689         case PIX_FMT_BGR565BE:
 690         case PIX_FMT_BGR565LE:
 691         case PIX_FMT_BGR555BE:
 692         case PIX_FMT_BGR555LE:
 693         case PIX_FMT_BGR444BE:
 694         case PIX_FMT_BGR444LE:
 695             bits = 16;
 696             break;
 697         case PIX_FMT_UYYVYY411:
 698             bits = 12;
 699             break;
 700         default:
 701             bits = pf->depth * pf->nb_channels;
 702             break;
 703         }
 704         break;
 705     case FF_PIXEL_PLANAR:
 706         if (desc->log2_chroma_w == 0 && desc->log2_chroma_h == 0) {
 707             bits = pf->depth * pf->nb_channels;
 708         } else {
 709             bits = pf->depth + ((2 * pf->depth) >>
 710                                 (desc->log2_chroma_w + desc->log2_chroma_h));
 711         }
 712         break;
 713     case FF_PIXEL_PALETTE:
 714         bits = 8;
 715         break;
 716     default:
 717         bits = -1;
 718         break;
 719     }
 720     return bits;
 721 }
 722
 723 static enum PixelFormat avcodec_find_best_pix_fmt1(int64_t pix_fmt_mask,
 724                                       enum PixelFormat src_pix_fmt,
 725                                       int has_alpha,
 726                                       int loss_mask)
 727 {
 728     int dist, i, loss, min_dist;
 729     enum PixelFormat dst_pix_fmt;
 730
 731     /* find exact color match with smallest size */
 732     dst_pix_fmt = PIX_FMT_NONE;
 733     min_dist = 0x7fffffff;
 734     for(i = 0;i < PIX_FMT_NB; i++) {
 735         if (pix_fmt_mask & (1ULL << i)) {
 736             loss = avcodec_get_pix_fmt_loss(i, src_pix_fmt, has_alpha) & loss_mask;
 737             if (loss == 0) {
 738                 dist = avg_bits_per_pixel(i);
 739                 if (dist < min_dist) {
 740                     min_dist = dist;
 741                     dst_pix_fmt = i;
 742                 }
 743             }
 744         }
 745     }
 746     return dst_pix_fmt;
 747 }
 748
 749 enum PixelFormat avcodec_find_best_pix_fmt(int64_t pix_fmt_mask, enum PixelFormat src_pix_fmt,
 750                               int has_alpha, int *loss_ptr)
 751 {
 752     enum PixelFormat dst_pix_fmt;
 753     int loss_mask, i;
 754     static const int loss_mask_order[] = {
 755         ~0, /* no loss first */
 756         ~FF_LOSS_ALPHA,
 757         ~FF_LOSS_RESOLUTION,
 758         ~(FF_LOSS_COLORSPACE | FF_LOSS_RESOLUTION),
 759         ~FF_LOSS_COLORQUANT,
 760         ~FF_LOSS_DEPTH,
 761         0,
 762     };
 763
 764     /* try with successive loss */
 765     i = 0;
 766     for(;;) {
 767         loss_mask = loss_mask_order[i++];
 768         dst_pix_fmt = avcodec_find_best_pix_fmt1(pix_fmt_mask, src_pix_fmt,
 769                                                  has_alpha, loss_mask);
 770         if (dst_pix_fmt >= 0)
 771             goto found;
 772         if (loss_mask == 0)
 773             break;
 774     }
 775     return PIX_FMT_NONE;
 776  found:
 777     if (loss_ptr)
 778         *loss_ptr = avcodec_get_pix_fmt_loss(dst_pix_fmt, src_pix_fmt, has_alpha);
 779     return dst_pix_fmt;
 780 }
 781
 782 #if LIBAVCODEC_VERSION_MAJOR < 53
 783 void ff_img_copy_plane(uint8_t *dst, int dst_wrap,
 784                            const uint8_t *src, int src_wrap,
 785                            int width, int height)
 786 {
 787     av_image_copy_plane(dst, dst_wrap, src, src_wrap, width, height);
 788 }
 789
 790 int ff_get_plane_bytewidth(enum PixelFormat pix_fmt, int width, int plane)
 791 {
 792     return av_image_get_linesize(pix_fmt, width, plane);
 793 }
 794
 795 void av_picture_data_copy(uint8_t *dst_data[4], int dst_linesize[4],
 796                           uint8_t *src_data[4], int src_linesize[4],
 797                           enum PixelFormat pix_fmt, int width, int height)
 798 {
 799     av_image_copy(dst_data, dst_linesize, src_data, src_linesize,
 800                   pix_fmt, width, height);
 801 }
 802 #endif
 803
 804 void av_picture_copy(AVPicture *dst, const AVPicture *src,
 805                      enum PixelFormat pix_fmt, int width, int height)
 806 {
 807     av_image_copy(dst->data, dst->linesize, src->data,
 808                   src->linesize, pix_fmt, width, height);
 809 }
 810
 811 /* 2x2 -> 1x1 */
 812 void ff_shrink22(uint8_t *dst, int dst_wrap,
 813                      const uint8_t *src, int src_wrap,
 814                      int width, int height)
 815 {
 816     int w;
 817     const uint8_t *s1, *s2;
 818     uint8_t *d;
 819
 820     for(;height > 0; height--) {
 821         s1 = src;
 822         s2 = s1 + src_wrap;
 823         d = dst;
 824         for(w = width;w >= 4; w-=4) {
 825             d[0] = (s1[0] + s1[1] + s2[0] + s2[1] + 2) >> 2;
 826             d[1] = (s1[2] + s1[3] + s2[2] + s2[3] + 2) >> 2;
 827             d[2] = (s1[4] + s1[5] + s2[4] + s2[5] + 2) >> 2;
 828             d[3] = (s1[6] + s1[7] + s2[6] + s2[7] + 2) >> 2;
 829             s1 += 8;
 830             s2 += 8;
 831             d += 4;
 832         }
 833         for(;w > 0; w--) {
 834             d[0] = (s1[0] + s1[1] + s2[0] + s2[1] + 2) >> 2;
 835             s1 += 2;
 836             s2 += 2;
 837             d++;
 838         }
 839         src += 2 * src_wrap;
 840         dst += dst_wrap;
 841     }
 842 }
 843
 844 /* 4x4 -> 1x1 */
 845 void ff_shrink44(uint8_t *dst, int dst_wrap,
 846                      const uint8_t *src, int src_wrap,
 847                      int width, int height)
 848 {
 849     int w;
 850     const uint8_t *s1, *s2, *s3, *s4;
 851     uint8_t *d;
 852
 853     for(;height > 0; height--) {
 854         s1 = src;
 855         s2 = s1 + src_wrap;
 856         s3 = s2 + src_wrap;
 857         s4 = s3 + src_wrap;
 858         d = dst;
 859         for(w = width;w > 0; w--) {
 860             d[0] = (s1[0] + s1[1] + s1[2] + s1[3] +
 861                     s2[0] + s2[1] + s2[2] + s2[3] +
 862                     s3[0] + s3[1] + s3[2] + s3[3] +
 863                     s4[0] + s4[1] + s4[2] + s4[3] + 8) >> 4;
 864             s1 += 4;
 865             s2 += 4;
 866             s3 += 4;
 867             s4 += 4;
 868             d++;
 869         }
 870         src += 4 * src_wrap;
 871         dst += dst_wrap;
 872     }
 873 }
 874
 875 /* 8x8 -> 1x1 */
 876 void ff_shrink88(uint8_t *dst, int dst_wrap,
 877                      const uint8_t *src, int src_wrap,
 878                      int width, int height)
 879 {
 880     int w, i;
 881
 882     for(;height > 0; height--) {
 883         for(w = width;w > 0; w--) {
 884             int tmp=0;
 885             for(i=0; i<8; i++){
 886                 tmp += src[0] + src[1] + src[2] + src[3] + src[4] + src[5] + src[6] + src[7];
 887                 src += src_wrap;
 888             }
 889             *(dst++) = (tmp + 32)>>6;
 890             src += 8 - 8*src_wrap;
 891         }
 892         src += 8*src_wrap - 8*width;
 893         dst += dst_wrap - width;
 894     }
 895 }
 896
 897
 898 int avpicture_alloc(AVPicture *picture,
 899                     enum PixelFormat pix_fmt, int width, int height)
 900 {
 901     int size;
 902     void *ptr;
 903
 904     size = avpicture_fill(picture, NULL, pix_fmt, width, height);
 905     if(size<0)
 906         goto fail;
 907     ptr = av_malloc(size);
 908     if (!ptr)
 909         goto fail;
 910     avpicture_fill(picture, ptr, pix_fmt, width, height);
 911     if(picture->data[1] && !picture->data[2])
 912         ff_set_systematic_pal((uint32_t*)picture->data[1], pix_fmt);
 913
 914     return 0;
 915  fail:
 916     memset(picture, 0, sizeof(AVPicture));
 917     return -1;
 918 }
 919
 920 void avpicture_free(AVPicture *picture)
 921 {
 922     av_free(picture->data[0]);
 923 }
 924
 925 /* return true if yuv planar */
 926 static inline int is_yuv_planar(const PixFmtInfo *ps)
 927 {
 928     return (ps->color_type == FF_COLOR_YUV ||
 929             ps->color_type == FF_COLOR_YUV_JPEG) &&
 930         ps->pixel_type == FF_PIXEL_PLANAR;
 931 }
 932
 933 int av_picture_crop(AVPicture *dst, const AVPicture *src,
 934                     enum PixelFormat pix_fmt, int top_band, int left_band)
 935 {
 936     int y_shift;
 937     int x_shift;
 938
 939     if (pix_fmt < 0 || pix_fmt >= PIX_FMT_NB || !is_yuv_planar(&pix_fmt_info[pix_fmt]))
 940         return -1;
 941
 942     y_shift = av_pix_fmt_descriptors[pix_fmt].log2_chroma_h;
 943     x_shift = av_pix_fmt_descriptors[pix_fmt].log2_chroma_w;
 944
 945     dst->data[0] = src->data[0] + (top_band * src->linesize[0]) + left_band;
 946     dst->data[1] = src->data[1] + ((top_band >> y_shift) * src->linesize[1]) + (left_band >> x_shift);
 947     dst->data[2] = src->data[2] + ((top_band >> y_shift) * src->linesize[2]) + (left_band >> x_shift);
 948
 949     dst->linesize[0] = src->linesize[0];
 950     dst->linesize[1] = src->linesize[1];
 951     dst->linesize[2] = src->linesize[2];
 952     return 0;
 953 }
 954
 955 int av_picture_pad(AVPicture *dst, const AVPicture *src, int height, int width,
 956                    enum PixelFormat pix_fmt, int padtop, int padbottom, int padleft, int padright,
 957             int *color)
 958 {
 959     uint8_t *optr;
 960     int y_shift;
 961     int x_shift;
 962     int yheight;
 963     int i, y;
 964
 965     if (pix_fmt < 0 || pix_fmt >= PIX_FMT_NB ||
 966         !is_yuv_planar(&pix_fmt_info[pix_fmt])) return -1;
 967
 968     for (i = 0; i < 3; i++) {
 969         x_shift = i ? av_pix_fmt_descriptors[pix_fmt].log2_chroma_w : 0;
 970         y_shift = i ? av_pix_fmt_descriptors[pix_fmt].log2_chroma_h : 0;
 971
 972         if (padtop || padleft) {
 973             memset(dst->data[i], color[i],
 974                 dst->linesize[i] * (padtop >> y_shift) + (padleft >> x_shift));
 975         }
 976
 977         if (padleft || padright) {
 978             optr = dst->data[i] + dst->linesize[i] * (padtop >> y_shift) +
 979                 (dst->linesize[i] - (padright >> x_shift));
 980             yheight = (height - 1 - (padtop + padbottom)) >> y_shift;
 981             for (y = 0; y < yheight; y++) {
 982                 memset(optr, color[i], (padleft + padright) >> x_shift);
 983                 optr += dst->linesize[i];
 984             }
 985         }
 986
 987         if (src) { /* first line */
 988             uint8_t *iptr = src->data[i];
 989             optr = dst->data[i] + dst->linesize[i] * (padtop >> y_shift) +
 990                     (padleft >> x_shift);
 991             memcpy(optr, iptr, (width - padleft - padright) >> x_shift);
 992             iptr += src->linesize[i];
 993             optr = dst->data[i] + dst->linesize[i] * (padtop >> y_shift) +
 994                 (dst->linesize[i] - (padright >> x_shift));
 995             yheight = (height - 1 - (padtop + padbottom)) >> y_shift;
 996             for (y = 0; y < yheight; y++) {
 997                 memset(optr, color[i], (padleft + padright) >> x_shift);
 998                 memcpy(optr + ((padleft + padright) >> x_shift), iptr,
 999                        (width - padleft - padright) >> x_shift);
1000                 iptr += src->linesize[i];
1001                 optr += dst->linesize[i];
1002             }
1003         }
1004
1005         if (padbottom || padright) {
1006             optr = dst->data[i] + dst->linesize[i] *
1007                 ((height - padbottom) >> y_shift) - (padright >> x_shift);
1008             memset(optr, color[i],dst->linesize[i] *
1009                 (padbottom >> y_shift) + (padright >> x_shift));
1010         }
1011     }
1012     return 0;
1013 }
1014
1015 /* NOTE: we scan all the pixels to have an exact information */
1016 static int get_alpha_info_pal8(const AVPicture *src, int width, int height)
1017 {
1018     const unsigned char *p;
1019     int src_wrap, ret, x, y;
1020     unsigned int a;
1021     uint32_t *palette = (uint32_t *)src->data[1];
1022
1023     p = src->data[0];
1024     src_wrap = src->linesize[0] - width;
1025     ret = 0;
1026     for(y=0;y<height;y++) {
1027         for(x=0;x<width;x++) {
1028             a = palette[p[0]] >> 24;
1029             if (a == 0x00) {
1030                 ret |= FF_ALPHA_TRANSP;
1031             } else if (a != 0xff) {
1032                 ret |= FF_ALPHA_SEMI_TRANSP;
1033             }
1034             p++;
1035         }
1036         p += src_wrap;
1037     }
1038     return ret;
1039 }
1040
1041 int img_get_alpha_info(const AVPicture *src,
1042                        enum PixelFormat pix_fmt, int width, int height)
1043 {
1044     const PixFmtInfo *pf = &pix_fmt_info[pix_fmt];
1045     int ret;
1046
1047     /* no alpha can be represented in format */
1048     if (!pf->is_alpha)
1049         return 0;
1050     switch(pix_fmt) {
1051     case PIX_FMT_PAL8:
1052         ret = get_alpha_info_pal8(src, width, height);
1053         break;
1054     default:
1055         /* we do not know, so everything is indicated */
1056         ret = FF_ALPHA_TRANSP | FF_ALPHA_SEMI_TRANSP;
1057         break;
1058     }
1059     return ret;
1060 }
1061
1062 #if !(HAVE_MMX && HAVE_YASM)
1063 /* filter parameters: [-1 4 2 4 -1] // 8 */
1064 static void deinterlace_line_c(uint8_t *dst,
1065                              const uint8_t *lum_m4, const uint8_t *lum_m3,
1066                              const uint8_t *lum_m2, const uint8_t *lum_m1,
1067                              const uint8_t *lum,
1068                              int size)
1069 {
1070     uint8_t *cm = ff_cropTbl + MAX_NEG_CROP;
1071     int sum;
1072
1073     for(;size > 0;size--) {
1074         sum = -lum_m4[0];
1075         sum += lum_m3[0] << 2;
1076         sum += lum_m2[0] << 1;
1077         sum += lum_m1[0] << 2;
1078         sum += -lum[0];
1079         dst[0] = cm[(sum + 4) >> 3];
1080         lum_m4++;
1081         lum_m3++;
1082         lum_m2++;
1083         lum_m1++;
1084         lum++;
1085         dst++;
1086     }
1087 }
1088
1089 static void deinterlace_line_inplace_c(uint8_t *lum_m4, uint8_t *lum_m3,
1090                                        uint8_t *lum_m2, uint8_t *lum_m1,
1091                                        uint8_t *lum, int size)
1092 {
1093     uint8_t *cm = ff_cropTbl + MAX_NEG_CROP;
1094     int sum;
1095
1096     for(;size > 0;size--) {
1097         sum = -lum_m4[0];
1098         sum += lum_m3[0] << 2;
1099         sum += lum_m2[0] << 1;
1100         lum_m4[0]=lum_m2[0];
1101         sum += lum_m1[0] << 2;
1102         sum += -lum[0];
1103         lum_m2[0] = cm[(sum + 4) >> 3];
1104         lum_m4++;
1105         lum_m3++;
1106         lum_m2++;
1107         lum_m1++;
1108         lum++;
1109     }
1110 }
1111 #endif
1112
1113 /* deinterlacing : 2 temporal taps, 3 spatial taps linear filter. The
1114    top field is copied as is, but the bottom field is deinterlaced
1115    against the top field. */
1116 static void deinterlace_bottom_field(uint8_t *dst, int dst_wrap,
1117                                     const uint8_t *src1, int src_wrap,
1118                                     int width, int height)
1119 {
1120     const uint8_t *src_m2, *src_m1, *src_0, *src_p1, *src_p2;
1121     int y;
1122
1123     src_m2 = src1;
1124     src_m1 = src1;
1125     src_0=&src_m1[src_wrap];
1126     src_p1=&src_0[src_wrap];
1127     src_p2=&src_p1[src_wrap];
1128     for(y=0;y<(height-2);y+=2) {
1129         memcpy(dst,src_m1,width);
1130         dst += dst_wrap;
1131         deinterlace_line(dst,src_m2,src_m1,src_0,src_p1,src_p2,width);
1132         src_m2 = src_0;
1133         src_m1 = src_p1;
1134         src_0 = src_p2;
1135         src_p1 += 2*src_wrap;
1136         src_p2 += 2*src_wrap;
1137         dst += dst_wrap;
1138     }
1139     memcpy(dst,src_m1,width);
1140     dst += dst_wrap;
1141     /* do last line */
1142     deinterlace_line(dst,src_m2,src_m1,src_0,src_0,src_0,width);
1143 }
1144
1145 static void deinterlace_bottom_field_inplace(uint8_t *src1, int src_wrap,
1146                                              int width, int height)
1147 {
1148     uint8_t *src_m1, *src_0, *src_p1, *src_p2;
1149     int y;
1150     uint8_t *buf;
1151     buf = (uint8_t*)av_malloc(width);
1152
1153     src_m1 = src1;
1154     memcpy(buf,src_m1,width);
1155     src_0=&src_m1[src_wrap];
1156     src_p1=&src_0[src_wrap];
1157     src_p2=&src_p1[src_wrap];
1158     for(y=0;y<(height-2);y+=2) {
1159         deinterlace_line_inplace(buf,src_m1,src_0,src_p1,src_p2,width);
1160         src_m1 = src_p1;
1161         src_0 = src_p2;
1162         src_p1 += 2*src_wrap;
1163         src_p2 += 2*src_wrap;
1164     }
1165     /* do last line */
1166     deinterlace_line_inplace(buf,src_m1,src_0,src_0,src_0,width);
1167     av_free(buf);
1168 }
1169
1170 int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
1171                           enum PixelFormat pix_fmt, int width, int height)
1172 {
1173     int i;
1174
1175     if (pix_fmt != PIX_FMT_YUV420P &&
1176         pix_fmt != PIX_FMT_YUVJ420P &&
1177         pix_fmt != PIX_FMT_YUV422P &&
1178         pix_fmt != PIX_FMT_YUVJ422P &&
1179         pix_fmt != PIX_FMT_YUV444P &&
1180         pix_fmt != PIX_FMT_YUV411P &&
1181         pix_fmt != PIX_FMT_GRAY8)
1182         return -1;
1183     if ((width & 3) != 0 || (height & 3) != 0)
1184         return -1;
1185
1186     for(i=0;i<3;i++) {
1187         if (i == 1) {
1188             switch(pix_fmt) {
1189             case PIX_FMT_YUVJ420P:
1190             case PIX_FMT_YUV420P:
1191                 width >>= 1;
1192                 height >>= 1;
1193                 break;
1194             case PIX_FMT_YUV422P:
1195             case PIX_FMT_YUVJ422P:
1196                 width >>= 1;
1197                 break;
1198             case PIX_FMT_YUV411P:
1199                 width >>= 2;
1200                 break;
1201             default:
1202                 break;
1203             }
1204             if (pix_fmt == PIX_FMT_GRAY8) {
1205                 break;
1206             }
1207         }
1208         if (src == dst) {
1209             deinterlace_bottom_field_inplace(dst->data[i], dst->linesize[i],
1210                                  width, height);
1211         } else {
1212             deinterlace_bottom_field(dst->data[i],dst->linesize[i],
1213                                         src->data[i], src->linesize[i],
1214                                         width, height);
1215         }
1216     }
1217     emms_c();
1218     return 0;
1219 }
1220