yuv.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:12k
源码类别:

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: yuv.h,v 1.3.8.1 2004/07/09 01:59:56 hubbe Exp $
  3.  * 
  4.  * Portions Copyright (c) 1995-2004 RealNetworks, Inc. All Rights Reserved.
  5.  * 
  6.  * The contents of this file, and the files included with this file,
  7.  * are subject to the current version of the RealNetworks Public
  8.  * Source License (the "RPSL") available at
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed
  10.  * the file under the current version of the RealNetworks Community
  11.  * Source License (the "RCSL") available at
  12.  * http://www.helixcommunity.org/content/rcsl, in which case the RCSL
  13.  * will apply. You may also obtain the license terms directly from
  14.  * RealNetworks.  You may not use this file except in compliance with
  15.  * the RPSL or, if you have a valid RCSL with RealNetworks applicable
  16.  * to this file, the RCSL.  Please see the applicable RPSL or RCSL for
  17.  * the rights, obligations and limitations governing use of the
  18.  * contents of the file.
  19.  * 
  20.  * Alternatively, the contents of this file may be used under the
  21.  * terms of the GNU General Public License Version 2 or later (the
  22.  * "GPL") in which case the provisions of the GPL are applicable
  23.  * instead of those above. If you wish to allow use of your version of
  24.  * this file only under the terms of the GPL, and not to allow others
  25.  * to use your version of this file under the terms of either the RPSL
  26.  * or RCSL, indicate your decision by deleting the provisions above
  27.  * and replace them with the notice and other provisions required by
  28.  * the GPL. If you do not delete the provisions above, a recipient may
  29.  * use your version of this file under the terms of any one of the
  30.  * RPSL, the RCSL or the GPL.
  31.  * 
  32.  * This file is part of the Helix DNA Technology. RealNetworks is the
  33.  * developer of the Original Code and owns the copyrights in the
  34.  * portions it created.
  35.  * 
  36.  * This file, and the files included with this file, is distributed
  37.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
  38.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
  39.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
  40.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
  41.  * ENJOYMENT OR NON-INFRINGEMENT.
  42.  * 
  43.  * Technology Compatibility Kit Test Suite(s) Location:
  44.  *    http://www.helixcommunity.org/content/tck
  45.  * 
  46.  * Contributor(s):
  47.  * 
  48.  * ***** END LICENSE BLOCK ***** */
  49. /*
  50.  * yuv.h: constants, prototypes, and macros used by the color
  51.  * conversion routines.  This header should not be included in any
  52.  * files that are not part of the color conversion library.
  53.  */
  54. #ifndef YUV_H_
  55. #define YUV_H_
  56. /* 
  57.  * This constant defines the maximum width of a video frame that will
  58.  * be supported by the color convert routines.  Setting this value to
  59.  * 640 will allow all RealVideo encodes to work..  If you explicitly
  60.  * disallow (and test for) frame widths larger than this value
  61.  * elsewhere in the player, then this value can be set to a smaller
  62.  * value.  The allocated memory is 12 * MAXWIDTH bytes.
  63.  */
  64. /* This was increased to 720 to handle half D1 video. */
  65. #define MAXWIDTH 720
  66. /*******************************************************************
  67.  * Don't change values below this line.
  68.  *******************************************************************/
  69. /* some math. constants: */
  70. #ifndef M_PI
  71. #define M_PI      3.14159265358979323846
  72. #endif
  73. #ifndef M_SQRT2
  74. #define M_SQRT2   1.41421356237309504880
  75. #endif
  76. /* fast rounding to a nearest integer: */
  77. #if _M_IX86
  78. #define INT(a) DoubleToInt(a)
  79. static __inline int DoubleToInt(double a)
  80. {
  81.     int ia;
  82.     __asm   fld     a
  83.     __asm   fistp   ia
  84.     return ia;
  85. }
  86. #else
  87. #define INT(a) ((int) (((a)<0)? ((a)-0.5): ((a)+0.5)))
  88. #endif
  89. extern   int ytab  [], rvtab [], gvtab [];
  90. extern   int gutab [], butab [];
  91. extern   int rutab [], bvtab []; /* alpha != 0 */
  92. /*
  93.  * Bytes-per-pixel, for readability:
  94.  */
  95. #define BPP1    1
  96. #define BPP2    2
  97. #define BPP3    3
  98. #define BPP4    4
  99. /*
  100.  * Clipping & dithering:
  101.  *
  102.  * Note: the CLIPNEG/CLIPPOS numbers are somewhat rounded values
  103.  *  that correspond to current GAMMA_MAX,KAPPA_MAX, and BETA_MAX
  104.  *  parameters. If you are planning to modify any of these, the
  105.  *  ranges of the clip tables shall be adjusted as well.
  106.  */
  107. #define CLIPRNG 256                 /* unclipped range */
  108. #define CLIPNEG (288 * 4)           /* rounded max neg. value */
  109. #define CLIPPOS (288 * 4)           /* rounded max shot over 256 */
  110. #if defined(HELIX_FEATURE_CC_RGB444out)
  111. //These 2 handle all the RGB444 conversions
  112. #define CLIP4 (pcd->clip4+CLIPNEG)       /* offset into clip4 */
  113. #define CLIP8 (pcd->clip8+CLIPNEG)       /* offset into clip8 */
  114. #endif
  115. #if defined(HELIX_FEATURE_CC_RGB565out)            
  116. //These 2 handle all the RGB565 conversions
  117. #define CLIP5 (pcd->clip5+CLIPNEG)       /* offset into clip5 */
  118. #define CLIP6 (pcd->clip6+CLIPNEG)       /* offset into clip6 */
  119. #endif
  120.             
  121. /* 2-level, 2x2 dither noise, added before rounding to 333/555/565.
  122.  * Define NO_DITHER to disable. */
  123. #ifndef NO_DITHER
  124. #define DITH3L  8   /* 16 - 8 */
  125. #define DITH3H  24  /* 16 + 8 */
  126. #define DITH4L  4   /* 8 - 4 */
  127. #define DITH4H  12  /* 8 + 4 */
  128. #define DITH5L  2   /* 4 - 2 */
  129. #define DITH5H  6   /* 4 + 2 */
  130. #define DITH6L  1   /* 2 - 1 */
  131. #define DITH6H  3   /* 2 + 1 */
  132. #else /* disabled */
  133. #define DITH3L  16  /* does (i+16)>>5 for proper rounding */
  134. #define DITH3H  16
  135. #define DITH4L  8   /* does (i+8)>>4 for proper rounding */
  136. #define DITH4H  8
  137. #define DITH5L  4   /* does (i+4)>>3 for proper rounding */
  138. #define DITH5H  4
  139. #define DITH6L  2   /* does (i+2)>>2 for proper rounding */
  140. #define DITH6H  2
  141. #endif
  142. extern int chk_args (unsigned char *, int, int,
  143.      int, int, int, int, int,
  144.      unsigned char *, int, int,
  145.      int, int, int, int, int,
  146.      int *, int *);
  147. /*
  148.  * CCIR Rec. 601-2 definition of YCrCb color space.
  149.  *
  150.  * Given a primary analogue RGB signal (R,G,and B components are in the
  151.  * range of 0..1 volt), the luminance signal is defined as:
  152.  *      Y = 0.299 R + 0.587 G + 0.114 B.
  153.  * Signals of color-defferences, are therefore:
  154.  *      (R-Y) = 0.701 R - 0.587 G - 0.114 B, and
  155.  *      (B-Y) = -0.299 R - 0.587 G + 0.886 B.
  156.  * Using normalization (we want (R-Y) and (B-Y) to be in the range of
  157.  * -0.5..0.5 volt), we will obtain:
  158.  *      Cr = 0.5/0.701 (R-Y), and
  159.  *      Cb = 0.5/0.886 (B-Y).
  160.  * Finally, the quantized versions of Y,Cr,and Cb are defined as:
  161.  *      Y'  = 219 Y + 16,
  162.  *      Cr' = 224 Cr + 128, and
  163.  *      Cb' = 224 Cb + 128.
  164.  *
  165.  * For convenience, we will use the following names for these constants
  166.  * (here and below: V = Cr, and U = Cb):
  167.  */
  168. #define CCIR601_YRCOEF  0.299
  169. #define CCIR601_YGCOEF  0.587
  170. #define CCIR601_YBCOEF  0.114
  171. #define CCIR601_YMAX    219
  172. #define CCIR601_YMED    ((double)CCIR601_YMAX/2.)
  173. #define CCIR601_YOFFSET 16
  174. #define CCIR601_VMAX    224
  175. #define CCIR601_VOFFSET 128
  176. #define CCIR601_UMAX    224
  177. #define CCIR601_UOFFSET 128
  178. /*
  179.  * Also, we typically will deal with quantized R'G'B' signal, represented
  180.  * by 8-bit quantities for R', G' and B' components:
  181.  */
  182. #define RGB_MAX 255
  183. /*
  184.  * Forward R'G'B'->Y'Cr'Cb' conversion:
  185.  *  a) calculate Y":
  186.  *      Y" = 0.299 R' + 0.587 G' + 0.114 B';            => 3 muls/lookups
  187.  *  b) calculate Y',Cr',Cb' values:
  188.  *      Y'  = 219/255 Y" + 16;                          => 1 mul/lookup
  189.  *      Cr' = 224/255 * 0.5/0.701 (R'-Y") + 128;        => 1 mul/lookup
  190.  *      Cb' = 224/255 * 0.5/0.886 (B'-Y") + 128;        => 1 mul/lookup
  191.  */
  192. #define YSCALE  ((double)CCIR601_YMAX/RGB_MAX)
  193. #define VSCALE  ((double)CCIR601_VMAX/RGB_MAX * 0.5/(1.-CCIR601_YRCOEF))
  194. #define USCALE  ((double)CCIR601_UMAX/RGB_MAX * 0.5/(1.-CCIR601_YBCOEF))
  195. #define YMAX    (RGB_MAX + 3)       /* include max. rounding error */
  196. #define VMAX    (int)((double)(1.-CCIR601_YRCOEF) * RGB_MAX + 1)
  197. #define VMIN    VMAX
  198. #define UMAX    (int)((double)(1.-CCIR601_YBCOEF) * RGB_MAX + 1)
  199. #define UMIN    UMAX
  200. /*
  201.  * Backward Y'Cr'Cb'->R'G'B' conversion:
  202.  *  a) calculate Y":
  203.  *      Y"  = 1/(219/255) (Y'-16);                                              => 1 mul/lookup
  204.  *  b) calculate R'B':
  205.  *      R'  = Y" + 1/(224/255 * 0.5/0.701) (Cr'-128);   => 1 mul/lookup
  206.  *      B'  = Y" + 1/(224/255 * 0.5/0.886) (Cb'-128);   => 1 mul/lookup
  207.  *  c) calculate G':
  208.  *      G'  = 1/0.587 (Y" - 0.299 R' - 0.114 B') =
  209.  *          = Y" - 0.299/0.587/(224/255 * 0.5/0.701) (Cr'-128)
  210.  *               - 0.114/0.587/(224/255 * 0.5/0.886) (Cb'-128); => 2 muls/luts
  211.  */
  212. #define YCOEF   (1/YSCALE)
  213. #define RVCOEF  (1/VSCALE)
  214. #define GVCOEF  (-CCIR601_YRCOEF/CCIR601_YGCOEF/VSCALE)
  215. #define GUCOEF  (-CCIR601_YBCOEF/CCIR601_YGCOEF/USCALE)
  216. #define BUCOEF  (1/USCALE)
  217. /*
  218.  * Color adjustments.
  219.  *  a) hue: in NTSC YUV color space, the hue adjustment is equivalent
  220.  *    to the UV axes rotation:
  221.  *      V' = V cos(alpha) - U sin(alpha);
  222.  *      U' = V sin(alpha) + U cos(alpha);
  223.  *    where:
  224.  *      V = (R-Y)/1.14;
  225.  *      U = (B-Y)/2.03;
  226.  *    In YCrCb color space, this will be equivalent to:
  227.  *      Cr' - 128 = (Cr - 128) cos(alpha) - zeta (Cb - 128) sin(alpha));.
  228.  *      Cb' - 128 = xi (Cr - 128) sin(alpha) + (Cb - 128) cos(alpha);
  229.  *    where:
  230.  *      xi   = (1./(0.5/0.701)/1.14)/(1./(0.5/0.886)/2.03);
  231.  *      zeta = 1/xi;
  232.  *  b) saturation:
  233.  *      Cr' - 128 = beta (Cr - 128);
  234.  *      Cb' - 128 = beta (Cb - 128);
  235.  *  c) brightness:
  236.  *      Y' - 16 = gamma (Y - 16);
  237.  *      Cr' - 128 = gamma (Cr - 128);
  238.  *      Cb' - 128 = gamma (Cb - 128);
  239.  *  d) contrast:
  240.  *      Y' - 16 = lambda + kappa (Y - 16);
  241.  *  e) all together:
  242.  *      Y' - 16   = gamma (lambda + kappa (Y - 16));
  243.  *      Cr' - 128 = gamma beta ((Cr - 128) cos(alpha) - zeta (Cb - 128) sin(alpha));
  244.  *      Cb' - 128 = gamma beta (xi (Cr - 128) sin(alpha) + (Cb - 128) cos(alpha));
  245.  */
  246. #define XI      (((1.-CCIR601_YRCOEF)/0.5/1.14)/((1.-CCIR601_YBCOEF)/0.5/2.03))
  247. #define ZETA    (1./XI)
  248. /* empirically choosen limits for color adjustments: */
  249. #define ALPHA_MAX   (M_PI*3/4)
  250. #define ALPHA_MED   0.              /* hue */
  251. #define ALPHA_MIN   (-M_PI*3/4)
  252. #define BETA_MAX    M_SQRT2
  253. #define BETA_MED    1.              /* saturation */
  254. #define BETA_MIN    (M_SQRT2/4)
  255. #define GAMMA_MAX   M_SQRT2
  256. #define GAMMA_MED   1.              /* brightness */
  257. #define GAMMA_MIN   0.5
  258. #define KAPPA_MIN   0.5
  259. #define KAPPA_MED   1.              /* contrast */
  260. #define KAPPA_MAX   2.
  261. #define LAMBDA(kappa)   (CCIR601_YMED * (1. - kappa))
  262. /*
  263.  * color_data_t: This struct contains all variables that need to be
  264.  * persistant across calls the the color conversion routines. These
  265.  * were formerly stored in global values. These needed to be removed
  266.  * due to Symbian dll restrictions.
  267.  */
  268. typedef struct color_data_t_ {
  269.     int color_conversion_tables_inited;
  270.   
  271.     int is_alpha;
  272.     int is_beta;
  273.     int is_gamma;
  274.     int is_kappa;
  275.     float cur_brightness;
  276.     float cur_contrast;
  277.     float cur_saturation;
  278.     float cur_hue; 
  279.     unsigned char linebuf[3 * MAXWIDTH * BPP4];
  280.     /* Y'Cr'Cb'->R'G'B' conversion tables: */
  281.     int ytab  [RGB_MAX+1];
  282.     int rvtab [RGB_MAX+1];
  283.     int gvtab [RGB_MAX+1];
  284.     int gutab [RGB_MAX+1];
  285.     int butab [RGB_MAX+1];
  286.     int rutab [RGB_MAX+1];
  287.     int bvtab [RGB_MAX+1]; /* alpha != 0 */
  288.     /* actual clip tables */
  289. #if defined(HELIX_FEATURE_CC_RGB444out)
  290.     unsigned char clip4 [CLIPNEG+CLIPRNG+CLIPPOS]; /* clip/round to 4 bits */
  291.     unsigned char clip8 [CLIPNEG+CLIPRNG+CLIPPOS]; /* clip to 8 bits */
  292. #endif    
  293. #if defined(HELIX_FEATURE_CC_RGB565out)
  294.     unsigned char clip5 [CLIPNEG+CLIPRNG+CLIPPOS]; /* clip/round to 5 bits */
  295.     unsigned char clip6 [CLIPNEG+CLIPRNG+CLIPPOS]; /* clip/round to 6 bits */
  296. #endif
  297.     
  298. } color_data_t;
  299. void InitColorData(color_data_t* pcd);
  300. #endif /* YUV_H_ */