Opencv——CvvImage类参考手册

CvvImage使用说明和注意事项

由于CvvImage是在 highgui.h 头文件中声明的，因此如果您的程序中需要使用，则必须在开头包含此头文件

#include <highgui.h>

CvvImage对应CImage宏:

#define CImage CvvImage

注意事项：

由于CImage太常见，很容易造成冲突，因此建议不要使用该宏(可以直接删去此宏定义)。

警告：参数中含有HDC（注：一种windows系统下定义的变量类型，用来描述设备描述表的句柄类型）类型的并不能保证移植到其他平台，例如Show/DrawToHDC等。

后文中的DC，即device context（设备环境），一般可以理解为windows操作系统为方便绘图而抽象的”绘图表面“，“往窗口上绘图”，有时也被说成是“往窗口DC上绘图”。

[编辑]

CvvImage::Create

bool CvvImage::Create(int w, int h, int bpp, int origin);

创建一个图像。成功返回true，失败返回false。

w: 图像宽
h: 图像高
bpp: 每个像素的bit数，值等于像素深度乘以通道数
origin: 0 - 顶—左结构， 1 - 底—左结构 (Windows bitmaps 风格)

例:

// 创建一个400行600列的， IPL_DEPTH_8U类型的3通道图像， 顶—左结构
 
CvvImage img;
bool flag = img.Create(600, 400, IPL_DEPTH_8U*3, 0);
if(!flag) 
    printf("创建图像失败!");

[编辑]

CvvImage::CopyOf

void  CvvImage::CopyOf(CvvImage& img, int desired_color);
void  CvvImage::CopyOf(IplImage* img, int desired_color);

从img复制图像到当前的对象中。

img: 要复制的图像。
desired_color: 为复制后图像的通道数，复制后图像的像素深度为8bit。

例:

// 读一个图像， 然后复制为1个3通道的彩色图像
 
CvvImage img1, img2;
 
img1.Load("example.tiff");
img2.CopyOf(img1, 3);

[编辑]

CvvImage::Load

bool CvvImage::Load(const char* filename, int desired_color);

装载一个图像。

filename: 图像文件名称。
desired_color: 图像波段数，和cvLoadImage类似。

[编辑]

CvvImage::LoadRect

bool CvvImage::LoadRect(const char* filename, int desired_color, CvRect rect);

从图像读出一个区域。

filename: 图像名称。
desired_color: 图像波段数，和cvLoadImage类似。
rect: 要读取的图像范围。

注: LoadRect是先用Load装载一个图像，然后再将rect设置为图像的ROI区域，然后复制图像得到，因此，如果一个图像很大(例如几百MB)，即使想从中只读几个像素也是会失败的。

[编辑]

CvvImage::Save

bool  CvvImage::Save(const char* filename);

保存图像。和cvSaveImage相似。

[编辑]

CvvImage::Show

void  CvvImage::Show(const char* window);

显示一个图像。和cvShowImage相似。

[编辑]

CvvImage::Show

void  CvvImage::Show(HDC dc, int x, int y, int w, int h, int from_x, int from_y);

绘制图像的部分到DC。图像没有缩放。此函数仅在Windows下有效。

dc: 设备描述符。
x: 局部图像显示在DC上,从DC上的第x列开始。
y: 局部图像显示在DC上,从DC上的第y列开始。
(x,y)为局部图像显示在DC上的起始位置。
w: 局部图像宽度。
h: 局部图像高度。
from_x: 从图像的第from_x列开始显示。
from_y: 从图像的第from_y行开始显示。

例:

// 从图像10行20列开始， 显示400行600列图像到设备描述符的100行200列开始的位置
 
CvvImage img;
img.Load("example.tiff");
 
img.Show(hDC, 200, 100, 600, 400, 20, 10);

[编辑]

CvvImage::DrawToHDC

void  CImage::DrawToHDC(HDC hDCDst, RECT* pDstRect);

绘制图像的ROI区域到DC的pDstRect，如果图像大小和pDstRect不一致，图像会拉伸/压缩。此函数仅在Windows下有效。

hDCDst: 设备描述符。
pDstRect: 对应的设备描述符区域。

例:

CvvImage img;
img.Load("example.tiff");
 
CRect rect;
rect.left = 100;
rect.top = 200;
rect.right = rect.left + 600;
rect.bottom = rect.top + 400;
 
img.DrawToHDC(hDC, &rect);

[编辑]

CvvImage::Fill

void CvvImage::Fill(int color);

以color颜色填充图像。

[编辑]

CvvImage类定义

/* CvvImage class definition */
class CV_EXPORTS CvvImage
{
public:
    CvvImage();
    virtual ~CvvImage();
 
    /* Create image (BGR or grayscale) */
    virtual bool  Create( int width, int height, int bits_per_pixel, int image_origin = 0 );
 
    /* Load image from specified file */
    virtual bool  Load( const char* filename, int desired_color = 1 );
 
    /* Load rectangle from the file */
    virtual bool  LoadRect( const char* filename,
                            int desired_color, CvRect r );
 
#ifdef WIN32
    virtual bool  LoadRect( const char* filename,
                            int desired_color, RECT r )
    {
        return LoadRect( filename, desired_color,
                         cvRect( r.left, r.top, r.right - r.left, r.bottom - r.top ));
    }
#endif
 
    /* Save entire image to specified file. */
    virtual bool  Save( const char* filename );
 
    /* Get copy of input image ROI */
    virtual void  CopyOf( CvvImage& image, int desired_color = -1 );
    virtual void  CopyOf( IplImage* img, int desired_color = -1 );
 
    IplImage* GetImage() { return m_img; };
    virtual void  Destroy(void);
 
    /* width and height of ROI */
    int Width() { return !m_img ? 0 : !m_img->roi ? m_img->width : m_img->roi->width; };
    int Height() { return !m_img ? 0 : !m_img->roi ? m_img->height : m_img->roi->height;};
    int Bpp() { return m_img ? (m_img->depth & 255)*m_img->nChannels : 0; };
 
    virtual void  Fill( int color );
 
    /* draw to highgui window */
    virtual void  Show( const char* window );
 
#ifdef WIN32
    /* draw part of image to the specified DC */
    virtual void  Show( HDC dc, int x, int y, int width, int height,
                        int from_x = 0, int from_y = 0 );
    /* draw the current image ROI to the specified rectangle of the destination DC */
    virtual void  DrawToHDC( HDC hDCDst, RECT* pDstRect );
#endif
 
protected:
 
    IplImage*  m_img;
};