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

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 __COLORCVT_H__
  36. #define __COLORCVT_H__  1
  37. #ifdef __cplusplus
  38. extern "C" {
  39. #endif
  40. /*
  41.  * Returns current state of "from/to I420" converters.
  42.  * Use:
  43.  *  void GetSrcI420Colors (float *brightness, float *contrast, float *saturation, float *hue);
  44.  * Output:
  45.  *  brightness - brightness adjustment [-1,1], 0 - default;
  46.  *  contrast   - contrast adjustment   [-1,1], 0 - default;
  47.  *  saturation - saturation adjustment [-1,1], 0 - default;
  48.  *  hue        - hue adjustment        [-1,1], 0 - default;
  49.  * Returns:
  50.  *  none.
  51.  */
  52. void GetSrcI420Colors (float *brightness, float *contrast, float *saturation, float *hue);
  53. /*
  54.  * Initializes "from/to I420" converters.
  55.  * Use:
  56.  *  void SetSrcI420Colors (float Brightness, float Contrast, float Saturation, float Hue);
  57.  *  void SetDestI420Colors (float Brightness, float Contrast, float Saturation, float Hue);
  58.  * Input:
  59.  *  Brightness - brightness adjustment [-1,1], 0 - default;
  60.  *  Contrast   - contrast adjustment   [-1,1], 0 - default;
  61.  *  Saturation - saturation adjustment [-1,1], 0 - default;
  62.  *  Hue        - hue adjustment        [-1,1], 0 - default;
  63.  * Returns:
  64.  *  none.
  65.  */
  66. void SetSrcI420Colors (float Brightness, float Contrast, float Saturation, float Hue);
  67. void SetDestI420Colors (float Brightness, float Contrast, float Saturation, float Hue);
  68. /*
  69.  * Suggest palettes to use for 8-bit RGB formats.
  70.  * Use:
  71.  *  int SuggestSrcRGB8Palette (int nColors, unsigned long *lpRGBVals);
  72.  *  int SuggestDestRGB8Palette (int nColors, unsigned long *lpRGBVals);
  73.  * Input:
  74.  *  nColors - the number of existing colors in palette
  75.  *  lpRGBVals - RGB values for each palette entry
  76.  *  lpIndices - pixel values (palette indices)
  77.  * Returns:
  78.  *  >0, the total number of colors to be used, if success
  79.  *  -1, if error
  80.  */
  81. int SuggestSrcRGB8Palette (int nColors, unsigned int *lpRGBVals);
  82. int SuggestDestRGB8Palette (int nColors, unsigned int *lpRGBVals);
  83. /*
  84.  * Set palettes to use for 8-bit RGB formats.
  85.  * Use:
  86.  *  int SetSrcRGB8Palette (int nColors, unsigned int *lpRGBVals, int *lpIndices);
  87.  *  int SetDestRGB8Palette (int nColors, unsigned int *lpRGBVals, int *lpIndices);
  88.  * Input:
  89.  *  nColors - the number of colors in palette
  90.  *  lpRGBVals - RGB values for each palette entry
  91.  *  lpIndices - pixel values (palette indices)
  92.  * Returns:
  93.  *  >0, the total number of colors set, if success
  94.  *  -1, if error
  95.  */
  96. int SetSrcRGB8Palette (int nColors, unsigned int *lpRGBVals, int *lpIndices);
  97. int SetDestRGB8Palette (int nColors, unsigned int *lpRGBVals, int *lpIndices);
  98. /*
  99.  * Format-conversion routines.
  100.  * Use:
  101.  *  int XXXXtoYYYY (unsigned char *dest_ptr, int dest_width, int dest_height,
  102.  *      int dest_pitch, int dest_x, int dest_y, int dest_dx, int dest_dy,
  103.  *      unsigned char *src_ptr, int src_width, int src_height, int src_pitch,
  104.  *      int src_x, int src_y, int src_dx, int src_dy);
  105.  * Input:
  106.  *  dest_ptr - pointer to a destination buffer
  107.  *  dest_width, dest_height - width/height of the destination image (pixels)
  108.  *  dest_pitch - pitch of the dest. buffer (in bytes; <0 - if bottom up image)
  109.  *  dest_x, dest_y, dest_dx, dest_dy - destination rectangle (pixels)
  110.  *  src_ptr - pointer to an input image
  111.  *  src_width, src_height - width/height of the input image (pixels)
  112.  *  src_pitch - pitch of the source buffer (in bytes; <0 - if bottom up image)
  113.  *  src_x, src_y, src_dx, src_dy - source rectangle (pixels)
  114.  * Returns:
  115.  *  0 - if success; -1 if failure.
  116.  * Notes:
  117.  *  a) In all cases, pointers to the source and destination buffers must be
  118.  *     DWORD aligned, and both pitch parameters must be multiple of 4!!!
  119.  *  b) Converters that deal with YUV 4:2:2, or 4:2:0 formats may also require
  120.  *     rectangle parameters (x,y,dx,dy) to be multiple of 2. Failure to provide
  121.  *     aligned rectangles will result in partially converted image.
  122.  *  c) Currently only scale factors of 1:1 and 2:1 are supported; if the rates
  123.  *     dest_dx/src_dx & dest_dy/src_dy are neither 1, or 2, the converters
  124.  *     will fail.
  125.  */
  126. /* "from I420" converters: */
  127. int I420toI420     (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  128. int I420toYV12     (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  129. int I420toYUY2     (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  130. int I420toUYVY     (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  131. int I420toRGB32    (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  132. int I420toRGB24    (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  133. int I420toRGB565   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  134. int I420toRGB555   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  135. int I420toRGB8     (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  136. /* "to I420" converters: */
  137. int   YV12toI420   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  138. int   YVU9toI420   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  139. int   YUY2toI420   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  140. int   UYVYtoI420   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  141. int  RGB32toI420   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  142. int  RGB24toI420   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  143. int RGB565toI420   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  144. int RGB555toI420   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  145. int   RGB8toI420   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  146. /* to BGR32 converters: */
  147. int   I420toBGR32  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  148. int  RGB32toBGR32  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  149. int  RGB24toBGR32  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  150. int RGB565toBGR32  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  151. int RGB555toBGR32  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  152. int   RGB8toBGR32  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  153. /* all possible "RGBx to RGBy" converters: */
  154. int RGB32toRGB32   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  155. int RGB32toRGB24   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  156. int RGB32toRGB565  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  157. int RGB32toRGB555  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  158. int RGB32toRGB8    (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  159. int RGB24toRGB32   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  160. int RGB24toRGB24   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  161. int RGB24toRGB565  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  162. int RGB24toRGB555  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  163. int RGB24toRGB8    (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  164. int RGB565toRGB32  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  165. int RGB565toRGB24  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  166. int RGB565toRGB565 (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  167. int RGB565toRGB555 (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  168. int RGB565toRGB8   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  169. int RGB555toRGB32  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  170. int RGB555toRGB24  (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  171. int RGB555toRGB565 (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  172. int RGB555toRGB555 (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  173. int RGB555toRGB8   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  174. int RGB8toRGB32    (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  175. int RGB8toRGB24    (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  176. int RGB8toRGB565   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  177. int RGB8toRGB555   (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  178. int RGB8toRGB8     (unsigned char *, int, int, int, int, int, int, int, unsigned char *, int, int, int, int, int, int, int);
  179. /*
  180.  * Alternative I420->RGB converters:
  181.  * Use:
  182.  *  void oldI420toRGBXXX (unsigned char *ysrc, unsigned char *usrc,
  183.  *          unsigned char *vsrc, int pitchSrc, unsigned char *dst,
  184.  *          int width, int height, int pitchDst);
  185.  * Input:
  186.  *  ysrc, usrc, vsrc - pointers to Y, Cr, and Cb components of the frame
  187.  *  pitchSrc - pitch of the input frame (luminance)
  188.  *  dst - pointer to an output buffer
  189.  *  width, height - the size of frame to convert
  190.  *  pitchDst - pitch of the output buffer (in RGB pixels!!!)
  191.  * Returns:
  192.  *  none.
  193.  */
  194. void oldI420toRGB32  (unsigned char *, unsigned char *, unsigned char *, int, unsigned char *, int, int, int);
  195. void oldI420toRGB24  (unsigned char *, unsigned char *, unsigned char *, int, unsigned char *, int, int, int);
  196. void oldI420toRGB565 (unsigned char *, unsigned char *, unsigned char *, int, unsigned char *, int, int, int);
  197. void oldI420toRGB555 (unsigned char *, unsigned char *, unsigned char *, int, unsigned char *, int, int, int);
  198. void oldI420toRGB32x2  (unsigned char *, unsigned char *, unsigned char *, int, unsigned char *, int, int, int);
  199. void oldI420toRGB24x2  (unsigned char *, unsigned char *, unsigned char *, int, unsigned char *, int, int, int);
  200. void oldI420toRGB565x2 (unsigned char *, unsigned char *, unsigned char *, int, unsigned char *, int, int, int);
  201. void oldI420toRGB555x2 (unsigned char *, unsigned char *, unsigned char *, int, unsigned char *, int, int, int);
  202. #ifdef __cplusplus
  203. }
  204. #endif
  205. #endif /* __COLORCVT_H__ */