libmpcodecs/mp_image.h

   1 #ifndef MPLAYER_MP_IMAGE_H
   2 #define MPLAYER_MP_IMAGE_H
   3
   4 #include <stdio.h>
   5 #include <stdlib.h>
   6 #include <string.h>
   7 #include "mp_msg.h"
   8
   9 //--------- codec's requirements (filled by the codec/vf) ---------
  10
  11 //--- buffer content restrictions:
  12 // set if buffer content shouldn't be modified:
  13 #define MP_IMGFLAG_PRESERVE 0x01
  14 // set if buffer content will be READ for next frame's MC: (I/P mpeg frames)
  15 #define MP_IMGFLAG_READABLE 0x02
  16
  17 //--- buffer width/stride/plane restrictions: (used for direct rendering)
  18 // stride _have_to_ be aligned to MB boundary:  [for DR restrictions]
  19 #define MP_IMGFLAG_ACCEPT_ALIGNED_STRIDE 0x4
  20 // stride should be aligned to MB boundary:     [for buffer allocation]
  21 #define MP_IMGFLAG_PREFER_ALIGNED_STRIDE 0x8
  22 // codec accept any stride (>=width):
  23 #define MP_IMGFLAG_ACCEPT_STRIDE 0x10
  24 // codec accept any width (width*bpp=stride -> stride%bpp==0) (>=width):
  25 #define MP_IMGFLAG_ACCEPT_WIDTH 0x20
  26 //--- for planar formats only:
  27 // uses only stride[0], and stride[1]=stride[2]=stride[0]>>mpi->chroma_x_shift
  28 #define MP_IMGFLAG_COMMON_STRIDE 0x40
  29 // uses only planes[0], and calculates planes[1,2] from width,height,imgfmt
  30 #define MP_IMGFLAG_COMMON_PLANE 0x80
  31
  32 #define MP_IMGFLAGMASK_RESTRICTIONS 0xFF
  33
  34 //--------- color info (filled by mp_image_setfmt() ) -----------
  35 // set if number of planes > 1
  36 #define MP_IMGFLAG_PLANAR 0x100
  37 // set if it's YUV colorspace
  38 #define MP_IMGFLAG_YUV 0x200
  39 // set if it's swapped (BGR or YVU) plane/byteorder
  40 #define MP_IMGFLAG_SWAPPED 0x400
  41 // using palette for RGB data
  42 #define MP_IMGFLAG_RGB_PALETTE 0x800
  43
  44 #define MP_IMGFLAGMASK_COLORS 0xF00
  45
  46 // codec uses drawing/rendering callbacks (draw_slice()-like thing, DR method 2)
  47 // [the codec will set this flag if it supports callbacks, and the vo _may_
  48 //  clear it in get_image() if draw_slice() not implemented]
  49 #define MP_IMGFLAG_DRAW_CALLBACK 0x1000
  50 // set if it's in video buffer/memory: [set by vo/vf's get_image() !!!]
  51 #define MP_IMGFLAG_DIRECT 0x2000
  52 // set if buffer is allocated (used in destination images):
  53 #define MP_IMGFLAG_ALLOCATED 0x4000
  54
  55 // buffer type was printed (do NOT set this flag - it's for INTERNAL USE!!!)
  56 #define MP_IMGFLAG_TYPE_DISPLAYED 0x8000
  57 // set if it can not be reused yet (for MP_IMGTYPE_NUMBERED)
  58 #define MP_IMGFLAG_IN_USE 0x10000
  59
  60 // codec doesn't support any form of direct rendering - it has own buffer
  61 // allocation. so we just export its buffer pointers:
  62 #define MP_IMGTYPE_EXPORT 0
  63 // codec requires a static WO buffer, but it does only partial updates later:
  64 #define MP_IMGTYPE_STATIC 1
  65 // codec just needs some WO memory, where it writes/copies the whole frame to:
  66 #define MP_IMGTYPE_TEMP 2
  67 // I+P type, requires 2+ independent static R/W buffers
  68 #define MP_IMGTYPE_IP 3
  69 // I+P+B type, requires 2+ independent static R/W and 1+ temp WO buffers
  70 #define MP_IMGTYPE_IPB 4
  71 // Upper 16 bits give desired buffer number, -1 means get next available
  72 #define MP_IMGTYPE_NUMBERED 5
  73
  74 #define MP_MAX_PLANES   4
  75
  76 #define MP_IMGFIELD_ORDERED 0x01
  77 #define MP_IMGFIELD_TOP_FIRST 0x02
  78 #define MP_IMGFIELD_REPEAT_FIRST 0x04
  79 #define MP_IMGFIELD_TOP 0x08
  80 #define MP_IMGFIELD_BOTTOM 0x10
  81 #define MP_IMGFIELD_INTERLACED 0x20
  82
  83 typedef struct mp_image_s {
  84     unsigned int flags;
  85     unsigned char type;
  86     int number;
  87     unsigned char bpp;  // bits/pixel. NOT depth! for RGB it will be n*8
  88     unsigned int imgfmt;
  89     int width,height;  // stored dimensions
  90     int x,y,w,h;  // visible dimensions
  91     unsigned char* planes[MP_MAX_PLANES];
  92     int stride[MP_MAX_PLANES];
  93     char * qscale;
  94     int qstride;
  95     int pict_type; // 0->unknown, 1->I, 2->P, 3->B
  96     int fields;
  97     int qscale_type; // 0->mpeg1/4/h263, 1->mpeg2
  98     int num_planes;
  99     /* these are only used by planar formats Y,U(Cb),V(Cr) */
 100     int chroma_width;
 101     int chroma_height;
 102     int chroma_x_shift; // horizontal
 103     int chroma_y_shift; // vertical
 104     /* for private use by filter or vo driver (to store buffer id or dmpi) */
 105     void* priv;
 106 } mp_image_t;
 107
 108 #ifdef IMGFMT_YUY2
 109 static inline void mp_image_setfmt(mp_image_t* mpi,unsigned int out_fmt){
 110     mpi->flags&=~(MP_IMGFLAG_PLANAR|MP_IMGFLAG_YUV|MP_IMGFLAG_SWAPPED);
 111     mpi->imgfmt=out_fmt;
 112     // compressed formats
 113     if(out_fmt == IMGFMT_MPEGPES ||
 114        out_fmt == IMGFMT_ZRMJPEGNI || out_fmt == IMGFMT_ZRMJPEGIT || out_fmt == IMGFMT_ZRMJPEGIB ||
 115        IMGFMT_IS_VDPAU(out_fmt) || IMGFMT_IS_XVMC(out_fmt)){
 116         mpi->bpp=0;
 117         return;
 118     }
 119     mpi->num_planes=1;
 120     if (IMGFMT_IS_RGB(out_fmt)) {
 121         if (IMGFMT_RGB_DEPTH(out_fmt) < 8 && !(out_fmt&128))
 122             mpi->bpp = IMGFMT_RGB_DEPTH(out_fmt);
 123         else
 124             mpi->bpp=(IMGFMT_RGB_DEPTH(out_fmt)+7)&(~7);
 125         return;
 126     }
 127     if (IMGFMT_IS_BGR(out_fmt)) {
 128         if (IMGFMT_BGR_DEPTH(out_fmt) < 8 && !(out_fmt&128))
 129             mpi->bpp = IMGFMT_BGR_DEPTH(out_fmt);
 130         else
 131             mpi->bpp=(IMGFMT_BGR_DEPTH(out_fmt)+7)&(~7);
 132         mpi->flags|=MP_IMGFLAG_SWAPPED;
 133         return;
 134     }
 135     mpi->flags|=MP_IMGFLAG_YUV;
 136     mpi->num_planes=3;
 137     switch(out_fmt){
 138     case IMGFMT_I420:
 139     case IMGFMT_IYUV:
 140         mpi->flags|=MP_IMGFLAG_SWAPPED;
 141     case IMGFMT_YV12:
 142         mpi->flags|=MP_IMGFLAG_PLANAR;
 143         mpi->bpp=12;
 144         mpi->chroma_width=(mpi->width>>1);
 145         mpi->chroma_height=(mpi->height>>1);
 146         mpi->chroma_x_shift=1;
 147         mpi->chroma_y_shift=1;
 148         return;
 149     case IMGFMT_IF09:
 150         mpi->num_planes=4;
 151     case IMGFMT_YVU9:
 152         mpi->flags|=MP_IMGFLAG_PLANAR;
 153         mpi->bpp=9;
 154         mpi->chroma_width=(mpi->width>>2);
 155         mpi->chroma_height=(mpi->height>>2);
 156         mpi->chroma_x_shift=2;
 157         mpi->chroma_y_shift=2;
 158         return;
 159     case IMGFMT_444P:
 160         mpi->flags|=MP_IMGFLAG_PLANAR;
 161         mpi->bpp=24;
 162         mpi->chroma_width=(mpi->width);
 163         mpi->chroma_height=(mpi->height);
 164         mpi->chroma_x_shift=0;
 165         mpi->chroma_y_shift=0;
 166         return;
 167     case IMGFMT_422P:
 168         mpi->flags|=MP_IMGFLAG_PLANAR;
 169         mpi->bpp=16;
 170         mpi->chroma_width=(mpi->width>>1);
 171         mpi->chroma_height=(mpi->height);
 172         mpi->chroma_x_shift=1;
 173         mpi->chroma_y_shift=0;
 174         return;
 175     case IMGFMT_411P:
 176         mpi->flags|=MP_IMGFLAG_PLANAR;
 177         mpi->bpp=12;
 178         mpi->chroma_width=(mpi->width>>2);
 179         mpi->chroma_height=(mpi->height);
 180         mpi->chroma_x_shift=2;
 181         mpi->chroma_y_shift=0;
 182         return;
 183     case IMGFMT_Y800:
 184     case IMGFMT_Y8:
 185         /* they're planar ones, but for easier handling use them as packed */
 186 //      mpi->flags|=MP_IMGFLAG_PLANAR;
 187         mpi->bpp=8;
 188         mpi->num_planes=1;
 189         return;
 190     case IMGFMT_UYVY:
 191         mpi->flags|=MP_IMGFLAG_SWAPPED;
 192     case IMGFMT_YUY2:
 193         mpi->bpp=16;
 194         mpi->num_planes=1;
 195         return;
 196     case IMGFMT_NV12:
 197         mpi->flags|=MP_IMGFLAG_SWAPPED;
 198     case IMGFMT_NV21:
 199         mpi->flags|=MP_IMGFLAG_PLANAR;
 200         mpi->bpp=12;
 201         mpi->num_planes=2;
 202         mpi->chroma_width=(mpi->width>>0);
 203         mpi->chroma_height=(mpi->height>>1);
 204         mpi->chroma_x_shift=0;
 205         mpi->chroma_y_shift=1;
 206         return;
 207     }
 208     mp_msg(MSGT_DECVIDEO,MSGL_WARN,"mp_image: unknown out_fmt: 0x%X\n",out_fmt);
 209     mpi->bpp=0;
 210 }
 211 #endif
 212
 213 static inline mp_image_t* new_mp_image(int w,int h){
 214     mp_image_t* mpi=(mp_image_t*)malloc(sizeof(mp_image_t));
 215     if(!mpi) return NULL; // error!
 216     memset(mpi,0,sizeof(mp_image_t));
 217     mpi->width=mpi->w=w;
 218     mpi->height=mpi->h=h;
 219     return mpi;
 220 }
 221
 222 static inline void free_mp_image(mp_image_t* mpi){
 223     if(!mpi) return;
 224     if(mpi->flags&MP_IMGFLAG_ALLOCATED){
 225         /* becouse we allocate the whole image in once */
 226         if(mpi->planes[0]) free(mpi->planes[0]);
 227     }
 228     free(mpi);
 229 }
 230
 231 mp_image_t* alloc_mpi(int w, int h, unsigned long int fmt);
 232 void copy_mpi(mp_image_t *dmpi, mp_image_t *mpi);
 233
 234 #endif /* MPLAYER_MP_IMAGE_H */