• Open Source Computer Vision Library

CvvImage类参考手册

Wikipedia,自由的百科全书

(修订版本间差异)
20:21 2009年1月5日的修订版本
Chai2010 (Talk | 贡献)

← Previous diff
22:13 2009年1月6日的修订版本
Ollydbg23 (Talk | 贡献)
添加第一节的介绍,DC的见解,修改代码标签
Next diff →
第 1行: 第 1行:
-CvvImage使用 前需要包含 highgui.h 头文件+==CvvImage使用 说明和注意事项==
 +由于CvvImage是在 highgui.h 头文件 中声明的,因此如果您的程序中需要使用,则必须在开头包含此头文件
 +<source lang="c">
 +#include <highgui.h>
 +</source>
 +CvvImage对应CImage宏:
 +<source lang="c">
 +#define CImage CvvImage
 +</source>
- #include <highgui.h>+ 注意事项:
- +
-CvvImage对应CImage宏:+
- #define CImage CvvImage+*由于CImage太常见, 很容易造成冲突, 因此建议不要使用该宏(可以直接删去此宏定义)。
-'''但是 由于CImage太常见 很容易造成冲突, 因此建议不要使用该宏(可以直接删去) '''+*警告:参数中含有HDC(注:一种windows系统下定义的变量类型 用来描述设备描述表的句柄类型)类型的并不能保证移植到其他平台 例如Show/DrawToHDC等
-[[警告:参数 含有HDC类型 并不能保证移植到其他平台 例如Show/DrawToHDC等 ]]+*后文 中的'''DC''' 即device context(设备环境),一般可以理解为windows操作系统为方便绘图而抽象的”绘图表面“,“往窗口上绘图”,有时也被说成是“往窗口DC上绘图”
==CvvImage::Create== ==CvvImage::Create==
第 22行: 第 28行:
例: 例:
-<pre>// 创建一个400行600列的, IPL_DEPTH_8U类型的3通道图像, 顶—左结构+<source lang="c">// 创建一个400行600列的, IPL_DEPTH_8U类型的3通道图像, 顶—左结构
CvvImage img; CvvImage img;
bool flag = img.Create(600, 400, IPL_DEPTH_8U*3, 0); bool flag = img.Create(600, 400, IPL_DEPTH_8U*3, 0);
if(!flag) if(!flag)
- printf("创建图像失败!");</pre>+ printf("创建图像失败!");</source>
==CvvImage::CopyOf== ==CvvImage::CopyOf==
第 39行: 第 45行:
例: 例:
-<pre>// 读一个图像, 然后复制为1个3通道的彩色图像+<source lang="c">// 读一个图像, 然后复制为1个3通道的彩色图像
CvvImage img1, img2; CvvImage img1, img2;
img1.Load("example.tiff"); img1.Load("example.tiff");
-img2.CopyOf(img1, 3);</pre>+img2.CopyOf(img1, 3);</source>
==CvvImage::Load== ==CvvImage::Load==
第 91行: 第 97行:
例: 例:
-<pre>// 从图像10行20列开始, 显示400行600列图像到设备描述符的100行200列开始的位置+<source lang="c">// 从图像10行20列开始, 显示400行600列图像到设备描述符的100行200列开始的位置
CvvImage img; CvvImage img;
img.Load("example.tiff"); img.Load("example.tiff");
-img.Show(hDC, 200, 100, 600, 400, 20, 10);</pre>+img.Show(hDC, 200, 100, 600, 400, 20, 10);</source>
==CvvImage::DrawToHDC== ==CvvImage::DrawToHDC==
第 108行: 第 114行:
例: 例:
-<pre>CvvImage img;+<source lang="c">CvvImage img;
img.Load("example.tiff"); img.Load("example.tiff");
第 117行: 第 123行:
rect.bottom = rect.top + 400; rect.bottom = rect.top + 400;
-img.DrawToHDC(hDC, &rect);</pre>+img.DrawToHDC(hDC, &rect);</source>
==CvvImage::Fill== ==CvvImage::Fill==
第 125行: 第 131行:
==CvvImage类定义== ==CvvImage类定义==
-<pre>/* CvvImage class definition */+<source lang="c">/* CvvImage class definition */
class CV_EXPORTS CvvImage class CV_EXPORTS CvvImage
{ {
第 183行: 第 189行:
IplImage* m_img; IplImage* m_img;
}; };
-</pre>+</source>
==编写者== ==编写者==
*[http://sites.google.com/site/chaishushan/ chai2010] *[http://sites.google.com/site/chaishushan/ chai2010]
*[[User:Shiqi_Yu|于仕琪]] *[[User:Shiqi_Yu|于仕琪]]

22:13 2009年1月6日的修订版本

目录

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