CxImage使用指南

帮助地址：http://www.xdp.it/cximage/

----------------------------------------------------

1、Load：reads from disk the image in a specific format；

2、Save：saves to disk the image in a specific format；

3、Filter：2D linear filter(图像锐化，可提高图像清晰度)；

4、Copy：copies the image from an exsisting source；

5、Resample：resizes the image ；

6、Saturate：changes the saturation of the image(调整图像饱和度)；

7、GrayScale：图像灰度化；

8、Flip：图像上下翻动；

9、Mirror：图像左右翻动；

10、Negative：颜色取反(255-原值)；

11、Dither：converts the image to B&W using the desired method ；

12、Threshold：converts the image to B&W(二值化)；

13、AdaptiveThreshold：converts the image to B&W, using an optimal threshold mask(自适应阈值法)；

14、Colorize：replaces the original hue and saturation values；

15、Solarize：convert all colors above a given lightness level into their negative ；

16、Light：changes the brightness and the contrast of the image(图像亮度和对比度调整)；

17、Threshold2：filters only the pixels with a lightness less (or more) than the threshold level, and preserves the   colors for the unfiltered pixels；
18、Dilate：enhance the light areas of the image；
19、Erode：enhance the dark areas of the image；
20、Contour：enhance the variations between adjacent pixels；similar results can be achieved using Filter(), but the algorithms are different both in Edge() and in Contour()；
21、Edge：enhance the variations between adjacent pixels(注意线性和非线性的区别)；similar results can be achieved using Filter(), but the algorithms are different both in Edge() and in Contour()；
22、Trace：finds the contour of an object with a given color；
23、Noise：adds an uniform noise to the image；
24、Jitter：adds a random offset to each pixel in the image；

25、Draw：draws the image in the specified device context, with support for alpha channel, alpha palette, transparency, opacity；
26、GetWidth：获得图像的宽带；
27、GetHeight：获得图像的高度；
28、GetXDPI：获得图像x轴分辨率(支持TIFF、JPEG、PNG、BMP格式)；
29、GetYDPI：获得图像y轴分辨率(支持TIFF、JPEG、PNG、BMP格式)；
30、IsValid：checks if the image is correctly initializated；
31、SetJpegQuality：set quality level for JPEG and JPEG2000；
32、GetJpegQuality：get quality level for JPEG and JPEG2000；
33、GetNumColors：returns 2, 16, 256; 0 for RGB images；
34、GetLastError：returns the last reported error；
35、SetPixelColor：设置像素颜色值；

---------------------------------------------------------------

1、打开一张图

bool CxImage::Load(const TCHAR * filename, uint32_t imagetype)

2、保存一张图
bool CxImage::Save(LPCWSTR filename, DWORD imagetype=0)
参数和上面是一样的。
3、得到图形数据，以便在OpenGL中使用材质
 BYTE* CxImage::GetBits(DWORD row = 0);
4、得到图形大小
long GetSize();
5、得到图形高度和宽度
 DWORD CxImage::GetHeight();
 DWORD CxImage::GetWidth();
6、得到文件类型
 DWORD CxImage::GetType()  const;
7、得到最后一个错误
 char* CxImage::GetLastError();
8、在界面中绘制出来
long CxImage::Draw(HDC hdc, const RECT& rect, RECT* pClipRect=NULL)
HDC 绘图设备，rect 绘图的区域，确定绘图的左上角和右下角坐标。pClipRect，裁剪区域，一般可以和绘图区域一样大小，除非特殊需要。

-------------------------------------------------------

class CxImage
{
...
protected:
void* pDib;            //包含文件头，调色板等等
BITMAPINFOHEADER head; //标准的文件头（位图）
CXIMAGEINFO info;      //扩展了的信息
BYTE* pSelection;      //用户选中的区域
BYTE* pAlpha;          //alpha通道
CxImage** pLayers;     //通用层
}
typedef struct tagCxImageInfo {
DWORD   dwEffWidth;       //DWORD 扫描线宽
BYTE*   pImage;           //图像位数
void*   pGhost;           //if this is a ghost, pGhost point to the body
DWORD   dwType;           //原图像的格式
char    szLastError[256]; //出错信息
long    nProgress;        //监视循环的次数
long    nEscape;          //跳出标志
long    nBkgndIndex;      //GIF, PNG, MNG格式使用
RGBQUAD nBkgndColor;      //RGB三原色透明度
BYTE    nQuality;         //JPEG格式使用
long    nFrame;           //TIF, GIF, MNG使用 :实际的帧数
long    nNumFrames;       //TIF, GIF, MNG使用 :帧总数
DWORD   dwFrameDelay;     //GIF, MNG使用
long    xDPI;             //水平分辨率
long    yDPI;             //垂直分辨率
RECT    rSelectionBox;    //选中的矩形区
BYTE    nAlphaMax;        //阴影的最大不透明度
bool    bAlphaPaletteEnabled;  //如果调色板中有Alpha通道则为真
bool    bEnabled;         //打开绘图函数
long    xOffset;
long    yOffset;
DWORD   dwEncodeOption;   //一些编码选项
RGBQUAD last_c;           //一些优化选项
BYTE    last_c_index;
bool    last_c_isvalid;
long    nNumLayers;
DWORD   dwFlags;
} CXIMAGEINFO;