CvvImage类参考手册

Wikipedia，自由的百科全书

（修订版本间差异）

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

编写者

取自"http://wiki.opencv.org.cn/index.php/CvvImage%E7%B1%BB%E5%8F%82%E8%80%83%E6%89%8B%E5%86%8C"

-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==
 例:
-<pre>// 创建一个400行600列的， IPL_DEPTH_8U类型的3通道图像， 顶—左结构
+<source lang="c">// 创建一个400行600列的， IPL_DEPTH_8U类型的3通道图像， 顶—左结构
 CvvImage img;
 bool flag = img.Create(600, 400, IPL_DEPTH_8U*3, 0);
 if(!flag)
-    printf("创建图像失败!");</pre>
+    printf("创建图像失败!");</source>
 ==CvvImage::CopyOf==
 例:
-<pre>// 读一个图像， 然后复制为1个3通道的彩色图像
+<source lang="c">// 读一个图像， 然后复制为1个3通道的彩色图像
 CvvImage img1, img2;
 img1.Load("example.tiff");
-img2.CopyOf(img1, 3);</pre>
+img2.CopyOf(img1, 3);</source>
 ==CvvImage::Load==
 例:
-<pre>// 从图像10行20列开始， 显示400行600列图像到设备描述符的100行200列开始的位置
+<source lang="c">// 从图像10行20列开始， 显示400行600列图像到设备描述符的100行200列开始的位置
 CvvImage img;
 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==
 例:
-<pre>CvvImage img;
+<source lang="c">CvvImage img;
 img.Load("example.tiff");
 rect.bottom = rect.top + 400;
-img.DrawToHDC(hDC, &rect);</pre>
+img.DrawToHDC(hDC, &rect);</source>
 ==CvvImage::Fill==
 ==CvvImage类定义==
-<pre>/* CvvImage class definition */
+<source lang="c">/* CvvImage class definition */
 class CV_EXPORTS CvvImage
 {
     IplImage*  m_img;
 };
-</pre>
+</source>
 ==编写者==
 *[http://sites.google.com/site/chaishushan/ chai2010]
 *[[User:Shiqi_Yu|于仕琪]]

CvvImage类参考手册

Wikipedia，自由的百科全书

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

目录

CvvImage使用说明和注意事项

CvvImage::Create

CvvImage::CopyOf

CvvImage::Load

CvvImage::LoadRect

CvvImage::Save

CvvImage::Show

CvvImage::Show

CvvImage::DrawToHDC

CvvImage::Fill

CvvImage类定义

编写者

Views

导航

Personal tools

工具