mp_image.h 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  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. #ifndef MPLAYER_MP_IMAGE_H
  19. #define MPLAYER_MP_IMAGE_H
  20. #include <stdio.h>
  21. #include <stdlib.h>
  22. #include <string.h>
  23. #include "mp_msg.h"
  24. //--------- codec's requirements (filled by the codec/vf) ---------
  25. //--- buffer content restrictions:
  26. // set if buffer content shouldn't be modified:
  27. #define MP_IMGFLAG_PRESERVE 0x01
  28. // set if buffer content will be READ for next frame's MC: (I/P mpeg frames)
  29. #define MP_IMGFLAG_READABLE 0x02
  30. //--- buffer width/stride/plane restrictions: (used for direct rendering)
  31. // stride _have_to_ be aligned to MB boundary: [for DR restrictions]
  32. #define MP_IMGFLAG_ACCEPT_ALIGNED_STRIDE 0x4
  33. // stride should be aligned to MB boundary: [for buffer allocation]
  34. #define MP_IMGFLAG_PREFER_ALIGNED_STRIDE 0x8
  35. // codec accept any stride (>=width):
  36. #define MP_IMGFLAG_ACCEPT_STRIDE 0x10
  37. // codec accept any width (width*bpp=stride -> stride%bpp==0) (>=width):
  38. #define MP_IMGFLAG_ACCEPT_WIDTH 0x20
  39. //--- for planar formats only:
  40. // uses only stride[0], and stride[1]=stride[2]=stride[0]>>mpi->chroma_x_shift
  41. #define MP_IMGFLAG_COMMON_STRIDE 0x40
  42. // uses only planes[0], and calculates planes[1,2] from width,height,imgfmt
  43. #define MP_IMGFLAG_COMMON_PLANE 0x80
  44. #define MP_IMGFLAGMASK_RESTRICTIONS 0xFF
  45. //--------- color info (filled by mp_image_setfmt() ) -----------
  46. // set if number of planes > 1
  47. #define MP_IMGFLAG_PLANAR 0x100
  48. // set if it's YUV colorspace
  49. #define MP_IMGFLAG_YUV 0x200
  50. // set if it's swapped (BGR or YVU) plane/byteorder
  51. #define MP_IMGFLAG_SWAPPED 0x400
  52. // set if you want memory for palette allocated and managed by vf_get_image etc.
  53. #define MP_IMGFLAG_RGB_PALETTE 0x800
  54. #define MP_IMGFLAGMASK_COLORS 0xF00
  55. // codec uses drawing/rendering callbacks (draw_slice()-like thing, DR method 2)
  56. // [the codec will set this flag if it supports callbacks, and the vo _may_
  57. // clear it in get_image() if draw_slice() not implemented]
  58. #define MP_IMGFLAG_DRAW_CALLBACK 0x1000
  59. // set if it's in video buffer/memory: [set by vo/vf's get_image() !!!]
  60. #define MP_IMGFLAG_DIRECT 0x2000
  61. // set if buffer is allocated (used in destination images):
  62. #define MP_IMGFLAG_ALLOCATED 0x4000
  63. // buffer type was printed (do NOT set this flag - it's for INTERNAL USE!!!)
  64. #define MP_IMGFLAG_TYPE_DISPLAYED 0x8000
  65. // codec doesn't support any form of direct rendering - it has own buffer
  66. // allocation. so we just export its buffer pointers:
  67. #define MP_IMGTYPE_EXPORT 0
  68. // codec requires a static WO buffer, but it does only partial updates later:
  69. #define MP_IMGTYPE_STATIC 1
  70. // codec just needs some WO memory, where it writes/copies the whole frame to:
  71. #define MP_IMGTYPE_TEMP 2
  72. // I+P type, requires 2+ independent static R/W buffers
  73. #define MP_IMGTYPE_IP 3
  74. // I+P+B type, requires 2+ independent static R/W and 1+ temp WO buffers
  75. #define MP_IMGTYPE_IPB 4
  76. // Upper 16 bits give desired buffer number, -1 means get next available
  77. #define MP_IMGTYPE_NUMBERED 5
  78. // Doesn't need any buffer, incomplete image (probably a first field only)
  79. // we need this type to be able to differentiate between half frames and
  80. // all other cases
  81. #define MP_IMGTYPE_INCOMPLETE 6
  82. #define MP_MAX_PLANES 4
  83. #define MP_IMGFIELD_ORDERED 0x01
  84. #define MP_IMGFIELD_TOP_FIRST 0x02
  85. #define MP_IMGFIELD_REPEAT_FIRST 0x04
  86. #define MP_IMGFIELD_TOP 0x08
  87. #define MP_IMGFIELD_BOTTOM 0x10
  88. #define MP_IMGFIELD_INTERLACED 0x20
  89. typedef struct mp_image {
  90. unsigned int flags;
  91. unsigned char type;
  92. int number;
  93. unsigned char bpp; // bits/pixel. NOT depth! for RGB it will be n*8
  94. unsigned int imgfmt;
  95. int width,height; // stored dimensions
  96. int x,y,w,h; // visible dimensions
  97. unsigned char* planes[MP_MAX_PLANES];
  98. int stride[MP_MAX_PLANES];
  99. char * qscale;
  100. int qstride;
  101. int pict_type; // 0->unknown, 1->I, 2->P, 3->B
  102. int fields;
  103. int qscale_type; // 0->mpeg1/4/h263, 1->mpeg2
  104. int num_planes;
  105. /* these are only used by planar formats Y,U(Cb),V(Cr) */
  106. int chroma_width;
  107. int chroma_height;
  108. int chroma_x_shift; // horizontal
  109. int chroma_y_shift; // vertical
  110. int usage_count;
  111. /* for private use by filter or vo driver (to store buffer id or dmpi) */
  112. void* priv;
  113. } mp_image_t;
  114. void mp_image_setfmt(mp_image_t* mpi,unsigned int out_fmt);
  115. mp_image_t* new_mp_image(int w,int h);
  116. void free_mp_image(mp_image_t* mpi);
  117. mp_image_t* alloc_mpi(int w, int h, unsigned long int fmt);
  118. void mp_image_alloc_planes(mp_image_t *mpi);
  119. void copy_mpi(mp_image_t *dmpi, mp_image_t *mpi);
  120. #endif /* MPLAYER_MP_IMAGE_H */