• Open Source Computer Vision Library

CvvImage类参考手册

Wikipedia,自由的百科全书

目录

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;
};

编写者

Views
Personal tools