/* * This file is part of MPlayer. * * MPlayer is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * MPlayer is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License along * with MPlayer; if not, write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ #ifndef MPLAYER_MP_IMAGE_H #define MPLAYER_MP_IMAGE_H #include #include #include #include #include "mp_msg.h" #include "libvo/csputils.h" //--------- codec's requirements (filled by the codec/vf) --------- //--- buffer content restrictions: // set if buffer content shouldn't be modified: #define MP_IMGFLAG_PRESERVE 0x01 // set if buffer content will be READ. // This can be e.g. for next frame's MC: (I/P mpeg frames) - // then in combination with MP_IMGFLAG_PRESERVE - or it // can be because a video filter or codec will read a significant // amount of data while processing that frame (e.g. blending something // onto the frame, MV based intra prediction). // A frame marked like this should not be placed in to uncachable // video RAM for example. #define MP_IMGFLAG_READABLE 0x02 //--- buffer width/stride/plane restrictions: (used for direct rendering) // stride _have_to_ be aligned to MB boundary: [for DR restrictions] #define MP_IMGFLAG_ACCEPT_ALIGNED_STRIDE 0x4 // stride should be aligned to MB boundary: [for buffer allocation] #define MP_IMGFLAG_PREFER_ALIGNED_STRIDE 0x8 // codec accept any stride (>=width): #define MP_IMGFLAG_ACCEPT_STRIDE 0x10 // codec accept any width (width*bpp=stride -> stride%bpp==0) (>=width): #define MP_IMGFLAG_ACCEPT_WIDTH 0x20 //--- for planar formats only: // uses only stride[0], and stride[1]=stride[2]=stride[0]>>mpi->chroma_x_shift #define MP_IMGFLAG_COMMON_STRIDE 0x40 // uses only planes[0], and calculates planes[1,2] from width,height,imgfmt #define MP_IMGFLAG_COMMON_PLANE 0x80 #define MP_IMGFLAGMASK_RESTRICTIONS 0xFF //--------- color info (filled by mp_image_setfmt() ) ----------- // set if number of planes > 1 #define MP_IMGFLAG_PLANAR 0x100 // set if it's YUV colorspace #define MP_IMGFLAG_YUV 0x200 // set if it's swapped (BGR or YVU) plane/byteorder #define MP_IMGFLAG_SWAPPED 0x400 // set if you want memory for palette allocated and managed by vf_get_image etc. #define MP_IMGFLAG_RGB_PALETTE 0x800 #define MP_IMGFLAGMASK_COLORS 0xF00 // codec uses drawing/rendering callbacks (draw_slice()-like thing, DR method 2) // [the codec will set this flag if it supports callbacks, and the vo _may_ // clear it in get_image() if draw_slice() not implemented] #define MP_IMGFLAG_DRAW_CALLBACK 0x1000 // set if it's in video buffer/memory: [set by vo/vf's get_image() !!!] #define MP_IMGFLAG_DIRECT 0x2000 // set if buffer is allocated (used in destination images): #define MP_IMGFLAG_ALLOCATED 0x4000 // buffer type was printed (do NOT set this flag - it's for INTERNAL USE!!!) #define MP_IMGFLAG_TYPE_DISPLAYED 0x8000 // codec doesn't support any form of direct rendering - it has own buffer // allocation. so we just export its buffer pointers: #define MP_IMGTYPE_EXPORT 0 // codec requires a static WO buffer, but it does only partial updates later: #define MP_IMGTYPE_STATIC 1 // codec just needs some WO memory, where it writes/copies the whole frame to: #define MP_IMGTYPE_TEMP 2 // I+P type, requires 2+ independent static R/W buffers #define MP_IMGTYPE_IP 3 // I+P+B type, requires 2+ independent static R/W and 1+ temp WO buffers #define MP_IMGTYPE_IPB 4 // Upper 16 bits give desired buffer number, -1 means get next available #define MP_IMGTYPE_NUMBERED 5 #define MP_MAX_PLANES 4 #define MP_IMGFIELD_ORDERED 0x01 #define MP_IMGFIELD_TOP_FIRST 0x02 #define MP_IMGFIELD_REPEAT_FIRST 0x04 #define MP_IMGFIELD_TOP 0x08 #define MP_IMGFIELD_BOTTOM 0x10 #define MP_IMGFIELD_INTERLACED 0x20 typedef struct mp_image { unsigned int flags; unsigned char type; int number; unsigned char bpp; // bits/pixel. NOT depth! for RGB it will be n*8 unsigned int imgfmt; int width,height; // internal to vf.c, do not use (stored dimensions) int w,h; // visible dimensions int display_w,display_h; // if set (!= 0), anamorphic size uint8_t *planes[MP_MAX_PLANES]; int stride[MP_MAX_PLANES]; char * qscale; int qstride; int pict_type; // 0->unknown, 1->I, 2->P, 3->B int fields; int qscale_type; // 0->mpeg1/4/h263, 1->mpeg2 int num_planes; /* these are only used by planar formats Y,U(Cb),V(Cr) */ int chroma_width; int chroma_height; int chroma_x_shift; // horizontal int chroma_y_shift; // vertical enum mp_csp colorspace; enum mp_csp_levels levels; int usage_count; /* for private use by filter or vo driver (to store buffer id or dmpi) */ void* priv; } mp_image_t; void mp_image_setfmt(mp_image_t* mpi,unsigned int out_fmt); mp_image_t* new_mp_image(int w,int h); void free_mp_image(mp_image_t* mpi); mp_image_t* alloc_mpi(int w, int h, unsigned long int fmt); void mp_image_alloc_planes(mp_image_t *mpi); void copy_mpi(mp_image_t *dmpi, mp_image_t *mpi); enum mp_csp mp_image_csp(struct mp_image *img); enum mp_csp_levels mp_image_levels(struct mp_image *img); struct mp_csp_details; void mp_image_set_colorspace_details(struct mp_image *image, struct mp_csp_details *csp); // this macro requires img_format.h to be included too: #define MP_IMAGE_PLANAR_BITS_PER_PIXEL_ON_PLANE(mpi, p) \ (IMGFMT_IS_YUVP16((mpi)->imgfmt) ? 16 : 8) #define MP_IMAGE_BITS_PER_PIXEL_ON_PLANE(mpi, p) \ (((mpi)->flags & MP_IMGFLAG_PLANAR) \ ? MP_IMAGE_PLANAR_BITS_PER_PIXEL_ON_PLANE(mpi, p) \ : (mpi)->bpp) #define MP_IMAGE_BYTES_PER_ROW_ON_PLANE(mpi, p) \ ((MP_IMAGE_BITS_PER_PIXEL_ON_PLANE(mpi, p) * ((mpi)->w >> (p ? mpi->chroma_x_shift : 0)) + 7) / 8) #endif /* MPLAYER_MP_IMAGE_H */