| 1 | /* |
| 2 | * This file is part of MPlayer. |
| 3 | * |
| 4 | * MPlayer is free software; you can redistribute it and/or modify |
| 5 | * it under the terms of the GNU General Public License as published by |
| 6 | * the Free Software Foundation; either version 2 of the License, or |
| 7 | * (at your option) any later version. |
| 8 | * |
| 9 | * MPlayer is distributed in the hope that it will be useful, |
| 10 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 11 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 12 | * GNU General Public License for more details. |
| 13 | * |
| 14 | * You should have received a copy of the GNU General Public License along |
| 15 | * with MPlayer; if not, write to the Free Software Foundation, Inc., |
| 16 | * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
| 17 | */ |
| 18 | |
| 19 | #ifndef MPLAYER_MP_IMAGE_H |
| 20 | #define MPLAYER_MP_IMAGE_H |
| 21 | |
| 22 | #include <stdio.h> |
| 23 | #include <stdlib.h> |
| 24 | #include <string.h> |
| 25 | #undef printf //FIXME |
| 26 | #undef fprintf //FIXME |
| 27 | #include "mp_msg.h" |
| 28 | #include "libavutil/avutil.h" |
| 29 | #include "libavutil/avassert.h" |
| 30 | #undef realloc |
| 31 | #undef malloc |
| 32 | #undef free |
| 33 | #undef rand |
| 34 | #undef srand |
| 35 | #undef printf |
| 36 | #undef strncpy |
| 37 | #define ASMALIGN(ZEROBITS) ".p2align " #ZEROBITS "\n\t" |
| 38 | #define CODEC_FLAG2_MEMC_ONLY 0x00001000 ///< Only do ME/MC (I frames -> ref, P frame -> ME+MC). |
| 39 | |
| 40 | enum AVPixelFormat ff_mp2ff_pix_fmt(int mp); |
| 41 | |
| 42 | //--------- codec's requirements (filled by the codec/vf) --------- |
| 43 | |
| 44 | //--- buffer content restrictions: |
| 45 | // set if buffer content shouldn't be modified: |
| 46 | #define MP_IMGFLAG_PRESERVE 0x01 |
| 47 | // set if buffer content will be READ. |
| 48 | // This can be e.g. for next frame's MC: (I/P mpeg frames) - |
| 49 | // then in combination with MP_IMGFLAG_PRESERVE - or it |
| 50 | // can be because a video filter or codec will read a significant |
| 51 | // amount of data while processing that frame (e.g. blending something |
| 52 | // onto the frame, MV based intra prediction). |
| 53 | // A frame marked like this should not be placed in to uncachable |
| 54 | // video RAM for example. |
| 55 | #define MP_IMGFLAG_READABLE 0x02 |
| 56 | |
| 57 | //--- buffer width/stride/plane restrictions: (used for direct rendering) |
| 58 | // stride _have_to_ be aligned to MB boundary: [for DR restrictions] |
| 59 | #define MP_IMGFLAG_ACCEPT_ALIGNED_STRIDE 0x4 |
| 60 | // stride should be aligned to MB boundary: [for buffer allocation] |
| 61 | #define MP_IMGFLAG_PREFER_ALIGNED_STRIDE 0x8 |
| 62 | // codec accept any stride (>=width): |
| 63 | #define MP_IMGFLAG_ACCEPT_STRIDE 0x10 |
| 64 | // codec accept any width (width*bpp=stride -> stride%bpp==0) (>=width): |
| 65 | #define MP_IMGFLAG_ACCEPT_WIDTH 0x20 |
| 66 | //--- for planar formats only: |
| 67 | // uses only stride[0], and stride[1]=stride[2]=stride[0]>>mpi->chroma_x_shift |
| 68 | #define MP_IMGFLAG_COMMON_STRIDE 0x40 |
| 69 | // uses only planes[0], and calculates planes[1,2] from width,height,imgfmt |
| 70 | #define MP_IMGFLAG_COMMON_PLANE 0x80 |
| 71 | |
| 72 | #define MP_IMGFLAGMASK_RESTRICTIONS 0xFF |
| 73 | |
| 74 | //--------- color info (filled by ff_mp_image_setfmt() ) ----------- |
| 75 | // set if number of planes > 1 |
| 76 | #define MP_IMGFLAG_PLANAR 0x100 |
| 77 | // set if it's YUV colorspace |
| 78 | #define MP_IMGFLAG_YUV 0x200 |
| 79 | // set if it's swapped (BGR or YVU) plane/byteorder |
| 80 | #define MP_IMGFLAG_SWAPPED 0x400 |
| 81 | // set if you want memory for palette allocated and managed by ff_vf_get_image etc. |
| 82 | #define MP_IMGFLAG_RGB_PALETTE 0x800 |
| 83 | |
| 84 | #define MP_IMGFLAGMASK_COLORS 0xF00 |
| 85 | |
| 86 | // codec uses drawing/rendering callbacks (draw_slice()-like thing, DR method 2) |
| 87 | // [the codec will set this flag if it supports callbacks, and the vo _may_ |
| 88 | // clear it in get_image() if draw_slice() not implemented] |
| 89 | #define MP_IMGFLAG_DRAW_CALLBACK 0x1000 |
| 90 | // set if it's in video buffer/memory: [set by vo/vf's get_image() !!!] |
| 91 | #define MP_IMGFLAG_DIRECT 0x2000 |
| 92 | // set if buffer is allocated (used in destination images): |
| 93 | #define MP_IMGFLAG_ALLOCATED 0x4000 |
| 94 | |
| 95 | // buffer type was printed (do NOT set this flag - it's for INTERNAL USE!!!) |
| 96 | #define MP_IMGFLAG_TYPE_DISPLAYED 0x8000 |
| 97 | |
| 98 | // codec doesn't support any form of direct rendering - it has own buffer |
| 99 | // allocation. so we just export its buffer pointers: |
| 100 | #define MP_IMGTYPE_EXPORT 0 |
| 101 | // codec requires a static WO buffer, but it does only partial updates later: |
| 102 | #define MP_IMGTYPE_STATIC 1 |
| 103 | // codec just needs some WO memory, where it writes/copies the whole frame to: |
| 104 | #define MP_IMGTYPE_TEMP 2 |
| 105 | // I+P type, requires 2+ independent static R/W buffers |
| 106 | #define MP_IMGTYPE_IP 3 |
| 107 | // I+P+B type, requires 2+ independent static R/W and 1+ temp WO buffers |
| 108 | #define MP_IMGTYPE_IPB 4 |
| 109 | // Upper 16 bits give desired buffer number, -1 means get next available |
| 110 | #define MP_IMGTYPE_NUMBERED 5 |
| 111 | // Doesn't need any buffer, incomplete image (probably a first field only) |
| 112 | // we need this type to be able to differentiate between half frames and |
| 113 | // all other cases |
| 114 | #define MP_IMGTYPE_INCOMPLETE 6 |
| 115 | |
| 116 | #define MP_MAX_PLANES 4 |
| 117 | |
| 118 | #define MP_IMGFIELD_ORDERED 0x01 |
| 119 | #define MP_IMGFIELD_TOP_FIRST 0x02 |
| 120 | #define MP_IMGFIELD_REPEAT_FIRST 0x04 |
| 121 | #define MP_IMGFIELD_TOP 0x08 |
| 122 | #define MP_IMGFIELD_BOTTOM 0x10 |
| 123 | #define MP_IMGFIELD_INTERLACED 0x20 |
| 124 | |
| 125 | typedef struct mp_image { |
| 126 | unsigned int flags; |
| 127 | unsigned char type; |
| 128 | int number; |
| 129 | unsigned char bpp; // bits/pixel. NOT depth! for RGB it will be n*8 |
| 130 | unsigned int imgfmt; |
| 131 | int width,height; // stored dimensions |
| 132 | int x,y,w,h; // visible dimensions |
| 133 | unsigned char* planes[MP_MAX_PLANES]; |
| 134 | int stride[MP_MAX_PLANES]; |
| 135 | char * qscale; |
| 136 | int qstride; |
| 137 | int pict_type; // 0->unknown, 1->I, 2->P, 3->B |
| 138 | int fields; |
| 139 | int qscale_type; // 0->mpeg1/4/h263, 1->mpeg2 |
| 140 | int num_planes; |
| 141 | /* these are only used by planar formats Y,U(Cb),V(Cr) */ |
| 142 | int chroma_width; |
| 143 | int chroma_height; |
| 144 | int chroma_x_shift; // horizontal |
| 145 | int chroma_y_shift; // vertical |
| 146 | int usage_count; |
| 147 | /* for private use by filter or vo driver (to store buffer id or dmpi) */ |
| 148 | void* priv; |
| 149 | } mp_image_t; |
| 150 | |
| 151 | void ff_mp_image_setfmt(mp_image_t* mpi,unsigned int out_fmt); |
| 152 | mp_image_t* ff_new_mp_image(int w,int h); |
| 153 | void ff_free_mp_image(mp_image_t* mpi); |
| 154 | |
| 155 | mp_image_t* ff_alloc_mpi(int w, int h, unsigned long int fmt); |
| 156 | void ff_mp_image_alloc_planes(mp_image_t *mpi); |
| 157 | void ff_copy_mpi(mp_image_t *dmpi, mp_image_t *mpi); |
| 158 | |
| 159 | #endif /* MPLAYER_MP_IMAGE_H */ |