yuv.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:8k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. #ifndef __YUV_H__
  36. #define __YUV_H__   1
  37. #ifdef __cplusplus
  38. extern "C" {
  39. #endif
  40. /*
  41.  * This header contains a number of data declarations that supposed
  42.  * to be shared between several modules. There should be only one module
  43.  * that would own these data (i.e. declare them locally as public data),
  44.  * while the others just should be able to access them (i.e. they would
  45.  * need to see them declared as "extern"). The following macros would
  46.  * allow us to combine both types of data declarations in a single place.
  47.  */
  48. #ifndef YUV_MAIN
  49. #define YUV_EXTERN  extern
  50. #else
  51. #define YUV_EXTERN  /**/
  52. #endif
  53. /*
  54.  * CCIR Rec. 601-2 definition of YCrCb color space.
  55.  *
  56.  * Given a primary analogue RGB signal (R,G,and B components are in the
  57.  * range of 0..1 volt), the luminance signal is defined as:
  58.  *      Y = 0.299 R + 0.587 G + 0.114 B.
  59.  * Signals of color-defferences, are therefore:
  60.  *      (R-Y) = 0.701 R - 0.587 G - 0.114 B, and
  61.  *      (B-Y) = -0.299 R - 0.587 G + 0.886 B.
  62.  * Using normalization (we want (R-Y) and (B-Y) to be in the range of
  63.  * -0.5..0.5 volt), we will obtain:
  64.  *      Cr = 0.5/0.701 (R-Y), and
  65.  *      Cb = 0.5/0.886 (B-Y).
  66.  * Finally, the quantized versions of Y,Cr,and Cb are defined as:
  67.  *      Y'  = 219 Y + 16,
  68.  *      Cr' = 224 Cr + 128, and
  69.  *      Cb' = 224 Cb + 128.
  70.  * For convenience, we will use the following names for these constants
  71.  * (here and below: V = Cr, and U = Cb):
  72.  */
  73. #define CCIR601_YRCOEF  0.299
  74. #define CCIR601_YGCOEF  0.587
  75. #define CCIR601_YBCOEF  0.114
  76. #define CCIR601_YMAX    219
  77. #define CCIR601_YMED    ((double)CCIR601_YMAX/2.)
  78. #define CCIR601_YOFFSET 16
  79. #define CCIR601_VMAX    224
  80. #define CCIR601_VOFFSET 128
  81. #define CCIR601_UMAX    224
  82. #define CCIR601_UOFFSET 128
  83. /*
  84.  * Also, we typically will deal with quantized R'G'B' signal, represented
  85.  * by 8-bit quantities for R', G' and B' components:
  86.  */
  87. #define RGB_MAX ((1U << 8) - 1)
  88. /*
  89.  * Forward R'G'B'->Y'Cr'Cb' conversion:
  90.  *  a) calculate Y":
  91.  *      Y" = 0.299 R' + 0.587 G' + 0.114 B'; => 3 muls/lookups
  92.  *  b) calculate Y',Cr',Cb' values:
  93.  *      Y'  = 219/255 Y" + 16;     => 1 mul/lookup
  94.  *      Cr' = 224/255 * 0.5/0.701 (R'-Y") + 128; => 1 mul/lookup
  95.  *      Cb' = 224/255 * 0.5/0.886 (B'-Y") + 128; => 1 mul/lookup
  96.  */
  97. #define YSCALE  ((double)CCIR601_YMAX/RGB_MAX)
  98. #define VSCALE  ((double)CCIR601_VMAX/RGB_MAX * 0.5/(1.-CCIR601_YRCOEF))
  99. #define USCALE  ((double)CCIR601_UMAX/RGB_MAX * 0.5/(1.-CCIR601_YBCOEF))
  100. #define YMAX    (RGB_MAX + 3)       /* include max. rounding error */
  101. #define VMAX    (int)((double)(1.-CCIR601_YRCOEF) * RGB_MAX + 1)
  102. #define VMIN    VMAX
  103. #define UMAX    (int)((double)(1.-CCIR601_YBCOEF) * RGB_MAX + 1)
  104. #define UMIN    UMAX
  105. /* R'G'B' -> Y'Cr'Cb' conversion tables: */
  106. YUV_EXTERN int yrtab [RGB_MAX+1], ygtab [RGB_MAX+1], ybtab [RGB_MAX+1];
  107. YUV_EXTERN int yytab [YMAX+1], vrytab [VMIN+VMAX+1], ubytab [UMIN+UMAX+1];
  108. /*
  109.  * Backward Y'Cr'Cb'->R'G'B' conversion:
  110.  *  a) calculate Y":
  111.  *      Y"  = 1/(219/255) (Y'-16);     => 1 mul/lookup
  112.  *  b) calculate R'B':
  113.  *      R'  = Y" + 1/(224/255 * 0.5/0.701) (Cr'-128); => 1 mul/lookup
  114.  *      B'  = Y" + 1/(224/255 * 0.5/0.886) (Cb'-128);  => 1 mul/lookup
  115.  *  c) calculate G':
  116.  *      G'  = 1/0.587 (Y" - 0.299 R' - 0.114 B') =
  117.  *          = Y" - 0.299/0.587/(224/255 * 0.5/0.701) (Cr'-128)
  118.  *               - 0.114/0.587/(224/255 * 0.5/0.886) (Cb'-128); => 2 muls/luts
  119.  */
  120. #define YCOEF   (1/YSCALE)
  121. #define RVCOEF  (1/VSCALE)
  122. #define GVCOEF  (-CCIR601_YRCOEF/CCIR601_YGCOEF/VSCALE)
  123. #define GUCOEF  (-CCIR601_YBCOEF/CCIR601_YGCOEF/USCALE)
  124. #define BUCOEF  (1/USCALE)
  125. /* Y'Cr'Cb'->R'G'B' conversion tables: */
  126. YUV_EXTERN int ytab  [RGB_MAX+1], rvtab [RGB_MAX+1], gvtab [RGB_MAX+1];
  127. YUV_EXTERN int gutab [RGB_MAX+1], butab [RGB_MAX+1];
  128. YUV_EXTERN int rutab [RGB_MAX+1], bvtab [RGB_MAX+1]; /* alpha != 0 */
  129. /*
  130.  * Color adjustments.
  131.  *  a) hue: in NTSC YUV color space, the hue adjustment is equivalent
  132.  *    to the UV axes rotation:
  133.  *      V' = V cos(alpha) - U sin(alpha);
  134.  *      U' = V sin(alpha) + U cos(alpha);
  135.  *    where:
  136.  *      V = (R-Y)/1.14;
  137.  *      U = (B-Y)/2.03;
  138.  *    In YCrCb color space, this will be equivalent to:
  139.  *      Cr' - 128 = (Cr - 128) cos(alpha) - zeta (Cb - 128) sin(alpha));.
  140.  *      Cb' - 128 = xi (Cr - 128) sin(alpha) + (Cb - 128) cos(alpha);
  141.  *    where:
  142.  *      xi   = (1./(0.5/0.701)/1.14)/(1./(0.5/0.886)/2.03);
  143.  *      zeta = 1/xi;
  144.  *  b) saturation:
  145.  *      Cr' - 128 = beta (Cr - 128);
  146.  *      Cb' - 128 = beta (Cb - 128);
  147.  *  c) brightness:
  148.  *      Y' - 16 = gamma (Y - 16);
  149.  *      Cr' - 128 = gamma (Cr - 128);
  150.  *      Cb' - 128 = gamma (Cb - 128);
  151.  *  d) contrast:
  152.  *      Y' - 16 = lambda + kappa (Y - 16);
  153.  *  e) all together:
  154.  *      Y' - 16   = gamma (lambda + kappa (Y - 16));
  155.  *      Cr' - 128 = gamma beta ((Cr - 128) cos(alpha) - zeta (Cb - 128) sin(alpha));
  156.  *      Cb' - 128 = gamma beta (xi (Cr - 128) sin(alpha) + (Cb - 128) cos(alpha));
  157.  */
  158. #define XI      (((1.-CCIR601_YRCOEF)/0.5/1.14)/((1.-CCIR601_YBCOEF)/0.5/2.03))
  159. #define ZETA    (1./XI)
  160. /* empirically choosen limits for color adjustments: */
  161. #define ALPHA_MAX   (M_PI*3/4)
  162. #define ALPHA_MED   0.              /* hue */
  163. #define ALPHA_MIN   (-M_PI*3/4)
  164. #define BETA_MAX    M_SQRT2
  165. #define BETA_MED    1.              /* saturation */
  166. #define BETA_MIN    (M_SQRT2/4)
  167. #define GAMMA_MAX   M_SQRT2
  168. #define GAMMA_MED   1.              /* brightness */
  169. #define GAMMA_MIN   0.5
  170. #define KAPPA_MIN   0.5
  171. #define KAPPA_MED   1.              /* contrast */
  172. #define KAPPA_MAX   2.
  173. #define LAMBDA(kappa)   (CCIR601_YMED * (1. - kappa))
  174. /* indicators of current color adjustment coefficients: */
  175. YUV_EXTERN int is_alpha, is_beta, is_gamma, is_kappa;
  176. /* Y'Cr'Cb'->Y'Cr'Cb' conversion tables: */
  177. YUV_EXTERN int _yytab [RGB_MAX+1], _uutab [RGB_MAX+1], _vvtab [RGB_MAX+1];
  178. YUV_EXTERN int _uvtab [RGB_MAX+1], _vutab [RGB_MAX+1]; /* alpha != 0: */
  179. /* chroma resampling mode: */
  180. YUV_EXTERN int chroma_resampling_mode;
  181. #ifdef __cplusplus
  182. }
  183. #endif
  184. #endif /* __YUV_H__ */