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

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 __COLORMAP_H__
  36. #define __COLORMAP_H__   1
  37. #ifdef __cplusplus
  38. extern "C" {
  39. #endif
  40.     
  41. #include "ciddefs.h"
  42. // this is needed here primarily for UNIX where mmioFOURCC is not present
  43. // this is also defined in /src/comlib/win/ddraw.h - which is also not
  44. // used with UNIXes
  45. #ifndef MAKEFOURCC
  46. #define MAKEFOURCC(ch0, ch1, ch2, ch3)                              
  47.                 ((ULONG32)(BYTE)(ch0) | ((ULONG32)(BYTE)(ch1) << 8) |   
  48.                 ((ULONG32)(BYTE)(ch2) << 16) | ((ULONG32)(BYTE)(ch3) << 24 ))
  49. #endif //defined(MAKEFOURCC)
  50. /*
  51.  * Some useful format-classification macros:
  52.  */
  53. #define IsGDI(cid)          ((cid) >= CID_RGB32 && (cid) <= CID_RGB8)
  54. #define IsPalettized(cid)   ((cid) == CID_RGB8)
  55. #define IsRGB(cid)          (((cid) >= CID_RGB32 && (cid) <= CID_RGB8) || ((cid) >= CID_BGR32 && (cid) <= CID_RGB444) || ((cid)==CID_ARGB32) )
  56. #define IsYUV(cid)          ((cid)==CID_YUVA || (cid) == CID_XING || (cid) == CID_DVPF || ((cid) >= CID_I420 && (cid) <= CID_UYVY))
  57. #define IsYUVPlanar(cid)    ( (cid)==CID_YUVA || (cid)==CID_XING || ((cid) >= CID_I420 && (cid) <= CID_YVU9))
  58. #define IsYUVPacked(cid)    ((cid) >= CID_YUY2 && (cid) <= CID_UYVY)
  59. #define IsMotionComp(cid)   ((cid) >= CID_MC12 && (cid) <= CID_IGOR)
  60. #define IsHWPostfilter(cid) ((cid) == CID_DVPF)
  61. #define IsStructured(cid)   ((cid) >= CID_MC12 && (cid) <= CID_DVPF)
  62. /*
  63.  * Get color format ID.
  64.  * Use:
  65.  *  int GetBitmapColor (LPBITMAPINFO lpbi);
  66.  *  int GetDirectDrawColor (LPDDPIXELFORMAT lpddpf);
  67.  * Input:
  68.  *  lpbi - pointer to BITMAPINFO structure containing image format
  69.  *  lpddpf - pointer to a DirectDraw DDPIXELFORMAT structure
  70.  * Returns:
  71.  *  ID of the specified format, if found;
  72.  *  CID_UNKNOWN, if not supported.
  73.  */
  74. #ifdef _WIN32
  75.     int GetBitmapColor (LPBITMAPINFO lpbi);
  76. #if !defined(WIN32_PLATFORM_PSPC)
  77.     int GetDirectDrawColor (LPDDPIXELFORMAT lpddpf);
  78. #endif /* !defined(WIN32_PLATFORM_PSPC) */
  79. #else
  80.     int GetBitmapColor (HXBitmapInfo* lpbi);
  81. #endif
  82. /*
  83.  * Set color format.
  84.  * Use:
  85.  *  int SetBitmapColor (LPBITMAPINFO lpbi, int cid);
  86.  *  int SetDirectDrawColor (LPDDPIXELFORMAT lpddpf, int cid);
  87.  * Input:
  88.  *  lpbi - pointer to BITMAPINFO structure containing image format
  89.  *  lpddpf - pointer to a DirectDraw DDPIXELFORMAT structure
  90.  *  cid - color format to set
  91.  * Returns:
  92.  *  0, if success,
  93.  *  !0 if wrong color format ID passed
  94.  */
  95. #ifdef _WIN32
  96. int SetBitmapColor (LPBITMAPINFO lpbi, int cid);
  97. #if !defined(WIN32_PLATFORM_PSPC)
  98. int SetDirectDrawColor (LPDDPIXELFORMAT lpddpf, int cid);
  99. #endif /* !defined(WIN32_PLATFORM_PSPC) */
  100. #else
  101. int SetBitmapColor (HXBitmapInfo* lpbi, int cid);
  102. #endif
  103. /*
  104.  * Get pitch of the bitmap image.
  105.  * Use:
  106.  *  int GetBitmapPitch (LPBITMAPINFO lpbi);
  107.  * Input:
  108.  *  lpbi - pointer to BITMAPINFO structure containing image format
  109.  * Returns:
  110.  *  !0 -- pitch of the bitmap image; <0 if bottom-up bitmap
  111.  *  0 - unrecognized bitmap format
  112.  */
  113. #ifdef _WIN32    
  114. int GetBitmapPitch (LPBITMAPINFO lpbi);
  115. #else    
  116. int GetBitmapPitch (HXBitmapInfo* lpbi);
  117. #endif
  118.     
  119. /*
  120.  * Get size of the bitmap image.
  121.  * Use:
  122.  *  int GetBitmapImageSize (LPBITMAPINFO lpbi);
  123.  * Input:
  124.  *  lpbi - pointer to BITMAPINFO structure containing image format
  125.  * Returns:
  126.  *  !0 -- size of the bitmap image
  127.  *  0 - unrecognized bitmap format
  128.  */
  129. #ifdef _WIN32    
  130. int GetBitmapImageSize (LPBITMAPINFO lpbi);
  131. #else    
  132. int GetBitmapImageSize (HXBitmapInfo* lpbi);
  133. #endif
  134. #ifdef _WIN32   
  135. int MakeBitmap (LPBITMAPINFO lpbi, int nBISize,
  136.     int cid, ULONG32 dwWidth, ULONG32 dwHeight, LPPALETTEENTRY lppe, int nColors);
  137. #else
  138. int MakeBitmap( HXBitmapInfo* lpbi, int nBISize, int cid,
  139.                 ULONG32 dwWidth, ULONG32 dwHeight, void* lppe, int nColors);
  140. #endif   
  141. /*
  142.  * Maps a FourCC to CID don't use this for RGB values.
  143.  * Use:
  144.  *  int MapFourCCtoCID (ULONG32 dwFourCC);
  145.  * Input:
  146.  *  dwFourCC - teh fourCC you want to map to a CID
  147.  * Returns:
  148.  *  teh CID, if found
  149.  */
  150. int MapFourCCtoCID(ULONG32 dwFourCC);
  151. /*
  152.  * Maps a CID to a FourCC
  153.  * Use:
  154.  *  int MapCIDtoFourCC (ULONG32 CID);
  155.  * Returns:
  156.  *  the FourCC, if found
  157.  *  else 0.
  158.  */
  159. int MapCIDtoFourCC(ULONG32 CID);
  160. #ifdef _WIN32
  161. /*
  162.  * Get bitmap palette.
  163.  * Use:
  164.  *  int GetBitmapPalette (LPBITMAPINFO lpbi, LPPALETTEENTRY lppe);
  165.  * Input:
  166.  *  lpbi - pointer to BITMAPINFO structure
  167.  *  lppe - pointer to a buffer to contain palette entries
  168.  * Returns:
  169.  *  the number of colors in palette
  170.  *  0, if bitmap does not use palette.
  171.  */
  172. int GetBitmapPalette (LPBITMAPINFO lpbi, LPPALETTEENTRY lppe);
  173. /*
  174.  * Set bitmap palette.
  175.  * Use:
  176.  *  int SetBitmapPalette (LPBITMAPINFO lpbi, LPPALETTEENTRY lppe, int n);
  177.  * Input:
  178.  *  lpbi - pointer to BITMAPINFO structure
  179.  *  lppe - pointer to a buffer containing palette entries
  180.  *  n    - the total number of colors in palette
  181.  * Returns:
  182.  *  the number of colors set
  183.  *  0, if bitmap does not use palette.
  184.  */
  185. int SetBitmapPalette (LPBITMAPINFO lpbi, LPPALETTEENTRY lppe, int n);
  186. /*
  187.  * Check the validity of a bitmap structure.
  188.  * Use:
  189.  *  int CheckBitmap (LPBITMAPINFO lpbi);
  190.  * Input:
  191.  *  lpbi - pointer to BITMAPINFO structure to check
  192.  * Returns:
  193.  *  !0 - bitmap parameters are correct
  194.  *  0 - otherwise
  195.  */
  196. int CheckBitmap (LPBITMAPINFO lpbi);
  197. #endif // _WIN32
  198. #ifdef __cplusplus
  199. }
  200. #endif
  201. #endif /* __COLORMAP_H__ */