opencv 图像处理和计算机视觉参考手册.htm

Opencv的中文参考指南

             | A<SUB>21</SUB> A<SUB>22</SUB>  b<SUB>2</SUB> |
</PRE>
<P>其中在非整数坐标 A&#8226;(x,y)<SUP>T</SUP>+b 的象素点值通过双线性变换得到。多通道图像的每一个通道都单独计算.</P>
<H4><SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">例子：使用</SPAN> 
cvGetQuadrangleSubPix <SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">进行图像旋转</SPAN></H4><PRE>#include "cv.h"
#include "highgui.h"
#include "math.h"

int main( int argc, char** argv )
{
    IplImage* src;
    /* the first command line parameter must be image file name */
    if( argc==2 &amp;&amp; (src = cvLoadImage(argv[1], -1))!=0)
    {
        IplImage* dst = cvCloneImage( src );
        int delta = 1;
        int angle = 0;

        cvNamedWindow( "src", 1 );
        cvShowImage( "src", src );

        for(;;)
        {
            float m[6];
            double factor = (cos(angle*CV_PI/180.) + 1.1)*3;
            CvMat M = cvMat( 2, 3, CV_32F, m );
            int w = src-&gt;width;
            int h = src-&gt;height;

            m[0] = (float)(factor*cos(-angle*2*CV_PI/180.));
            m[1] = (float)(factor*sin(-angle*2*CV_PI/180.));
            m[2] = w*0.5f;
            m[3] = -m[1];
            m[4] = m[0];
            m[5] = h*0.5f;

            cvGetQuadrangleSubPix( src, dst, &amp;M, 1, cvScalarAll(0));

            cvNamedWindow( "dst", 1 );
            cvShowImage( "dst", dst );

            if( cvWaitKey(5) == 27 )
                break;

            angle = (angle + delta) % 360;
        }
    }
    return 0;
}
</PRE>
<HR>

<H3><A name=decl_cvResize>Resize</A></H3>
<P class=Blurb><SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">图像大小变换</SPAN></P><PRE>void cvResize( const CvArr* src, CvArr* dst, int interpolation=CV_INTER_LINEAR );
</PRE>
<P>
<DL>
  <DT>src
  <DD>输入图像. 
  <DT>dst
  <DD>输出图像. 
  <DT>interpolation
  <DD>差值方法:
  <UL>
    <LI>CV_INTER_NN - 最近邻差值, 
    <LI>CV_INTER_LINEAR - 双线性差值 (缺省使用) 
    <LI>CV_INTER_AREA - 使用象素关系重采样。当图像缩小时候，该方法可以避免波纹出现。当图像放大时，类似于 
    <CODE>CV_INTER_NN</SPAN></CODE> 方法.. 
    <LI>CV_INTER_CUBIC - 立方差值. </LI></UL></DD></DL>
<P>函数 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvResize">cvResize</A> 
将图像 <CODE>src</SPAN></CODE> 改变尺寸得到与 <CODE>dst 同样大小。</SPAN></CODE>若设定 
ROI，函数将按常规支持 ROI.</P>
<HR>

<H3><A name=decl_cvWarpAffine>WarpAffine</A></H3>
<P class=Blurb><SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">对图像做仿射变换</SPAN></P><PRE>void cvWarpAffine( const CvArr* src, CvArr* dst, const CvMat* map_matrix,
                   int flags=CV_INTER_LINEAR+CV_WARP_FILL_OUTLIERS,
                   CvScalar fillval=cvScalarAll(0) );
</PRE>
<P>
<DL>
  <DT>src
  <DD>输入图像. 
  <DT>dst
  <DD>输出图像. 
  <DT>map_matrix
  <DD>2×3 变换矩阵 
  <DT>flags
  <DD>插值方法和以下开关选项的组合：
  <UL>
    <LI>CV_WARP_FILL_OUTLIERS - 填充所有缩小图像的象素。如果部分象素落在输入图像的边界外，那么它们的值设定为 
    <CODE>fillval</CODE>. 
    <LI>CV_WARP_INVERSE_MAP - 指定 <CODE>matrix</SPAN></CODE> 
    是输出图像到输入图像的反变换，因此可以直接用来做象素差值。否则, 函数从 <CODE>map_matrix 得到反变换。</CODE> </LI></UL>
  <DT>fillval
  <DD>用来填充边界外面的值 </DD></DL>
<P>函数 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvWarpAffine">cvWarpAffine</A> 
利用下面指定的矩阵变换输入图像：</P><PRE>dst(x&amp;apos;,y&amp;apos;)&lt;-src(x,y)
如果没有指定 CV_WARP_INVERSE_MAP ， (x&amp;apos;,y&amp;apos;)<SUP>T</SUP>=map_matrix&#8226;(x,y,1)<SUP>T</SUP>+b ,
否则， (x, y)<SUP>T</SUP>=map_matrix&#8226;(x&amp;apos;,y&amp;apos,1)<SUP>T</SUP>+b
</PRE>
<P>函数与 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvGetQuadrangleSubPix">cvGetQuadrangleSubPix</A> 
类似，但是不完全相同。 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvWarpAffine">cvWarpAffine</A> 
要求输入和输出图像具有同样的数据类型，有更大的资源开销（因此对小图像不太合适）而且输出图像的部分可以保留不变。而 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvGetQuadrangleSubPix">cvGetQuadrangleSubPix</A> 
可以精确地从8位图像中提取四边形到浮点数缓存区中，具有比较小的系统开销，而且总是全部改变输出图像的内容。 </P>
<P>要变换稀疏矩阵，使用 cxcore 中的函数 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvTransform">cvTransform</A> 
。</P>
<HR>

<H3><A name=decl_cv2DRotationMatrix>2DRotationMatrix</A></H3>
<P class=Blurb><SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">计算二维旋转的仿射变换矩阵</SPAN></P><PRE>CvMat* cv2DRotationMatrix( CvPoint2D32f center, double angle,
                           double scale, CvMat* map_matrix );
</PRE>
<P>
<DL>
  <DT>center
  <DD>输入图像的旋转中心坐标 
  <DT>angle
  <DD>旋转角度（度）。正值表示逆时针旋转(坐标原点假设在左上角). 
  <DT>scale
  <DD>各项同性的尺度因子 
  <DT>map_matrix
  <DD>输出 2×3 矩阵的指针 </DD></DL>
<P>函数 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cv2DRotationMatrix">cv2DRotationMatrix</A> 
计算矩阵:</P><PRE>[  α  β  |  (1-α)*center.x - β*center.y ]
[ -β  α  |  β*center.x + (1-α)*center.y ]

where α=scale*cos(angle), β=scale*sin(angle)
</PRE>
<P>该变换并不改变原始旋转中心点的坐标，如果这不是操作目的，则可以通过调整平移量改变其坐标(译者注：通过简单的推导可知，放射变换的实现是首先将旋转中心置为坐标原点，再进行旋转和尺度变换，最后重新将坐标原点设定为输入图像的左上角，这里的平移量是center.x, 
center.y).</P>
<HR>

<H3><A name=decl_cvWarpPerspective>WarpPerspective</A></H3>
<P class=Blurb><SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">对图像进行透视变换</SPAN></P><PRE>void cvWarpPerspective( const CvArr* src, CvArr* dst, const CvMat* map_matrix,
                        int flags=CV_INTER_LINEAR+CV_WARP_FILL_OUTLIERS,
                        CvScalar fillval=cvScalarAll(0) );
</PRE>
<P>
<DL>
  <DT>src
  <DD>输入图像. 
  <DT>dst
  <DD>输出图像. 
  <DT>map_matrix
  <DD>3×3 变换矩阵 
  <DT>flags
  <DD>插值方法和以下开关选项的组合:
  <UL>
    <LI>CV_WARP_FILL_OUTLIERS - 填充所有缩小图像的象素。如果部分象素落在输入图像的边界外，那么它们的值设定为 
    <CODE>fillval</CODE>. 
    <LI>CV_WARP_INVERSE_MAP - 指定 <CODE>matrix</SPAN></CODE> 
    是输出图像到输入图像的反变换，因此可以直接用来做象素差值。否则, 函数从 <CODE>map_matrix 得到反变换。</CODE> </LI></UL>
  <DT>fillval
  <DD>用来填充边界外面的值 </DD></DL>
<P>函数 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvWarpPerspective">cvWarpPerspective</A> 
利用下面指定矩阵变换输入图像：</P><PRE>dst(x&amp;apos;,y&amp;apos;)&lt;-src(x,y)
若指定 CV_WARP_INVERSE_MAP， (tx&amp;apos;,ty&amp;apos;,t)<SUP>T</SUP>=map_matrix&#8226;(x,y,1)<SUP>T</SUP>+b
否则， (tx, ty, t)<SUP>T</SUP>=map_matrix&#8226;(x&amp;apos;,y&amp;apos,1)<SUP>T</SUP>+b
</PRE>
<P>要变换稀疏矩阵，使用 cxcore 中的函数 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvTransform">cvTransform</A> 
。</P>
<HR>

<H3><A name=decl_cvWarpPerspectiveQMatrix>WarpPerspectiveQMatrix</A></H3>
<P class=Blurb><SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">用</SPAN>4<SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">个对应点计算透视变换矩阵</SPAN></P><PRE>CvMat* cvWarpPerspectiveQMatrix( const CvPoint2D32f* src,
                                 const CvPoint2D32f* dst,
                                 CvMat* map_matrix );
</PRE>
<P>
<DL>
  <DT>src
  <DD>输入图像的四边形的4个点坐标 
  <DT>dst
  <DD>输出图像的对应四边形的4个点坐标 
  <DT>map_matrix
  <DD>输出的 3×3 矩阵 </DD></DL>
<P>函数 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvWarpPerspectiveQMatrix">cvWarpPerspectiveQMatrix</A> 
计算透视变换矩阵，使得：</P><PRE>(t<SUB>i</SUB>x'<SUB>i</SUB>,t<SUB>i</SUB>y'<SUB>i</SUB>,t<SUB>i</SUB>)<SUP>T</SUP>=matrix&#8226;(x<SUB>i</SUB>,y<SUB>i</SUB>,1)<SUP>T</SUP>
</PRE>
<P>其中 <CODE>dst(i)=(x'<SUB>i</SUB>,y'<SUB>i</SUB>), 
src(i)=(x<SUB>i</SUB>,y<SUB>i</SUB>), i=0..3</CODE>.</P>
<HR>

<H2><A name=cv_imgproc_morphology>形态学操作</A></H2>
<HR>

<H3><A 
name=decl_cvCreateStructuringElementEx>CreateStructuringElementEx</A></H3>
<P class=Blurb><SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">创建结构元素</SPAN></P><PRE>IplConvKernel* cvCreateStructuringElementEx( int cols, int rows, int anchor_x, int anchor_y,
                                             int shape, int* values=NULL );
</PRE>
<P>
<DL>
  <DT>cols
  <DD>结构元素的列数目 
  <DT>rows
  <DD>结构元素的行数目 
  <DT>anchor_x
  <DD>锚点的相对水平偏移量 
  <DT>anchor_y
  <DD>锚点的相对垂直便宜量 
  <DT>shape
  <DD>结构元素的形状，可以是下列值： 
  <UL>
    <LI><CODE>CV_SHAPE_RECT</CODE>, 长方形元素; 
    <LI><CODE>CV_SHAPE_CROSS</CODE>, 交错元素 a cross-shaped element; 
    <LI><CODE>CV_SHAPE_ELLIPSE</CODE>, 椭圆元素; 
    <LI><CODE>CV_SHAPE_CUSTOM</CODE>, 用户自定义元素。这种情况下参数 <CODE>values</SPAN></CODE> 
    定义了 mask,即象素的那个邻域必须考虑。 </LI></UL>
  <DT>values
  <DD>指向结构元素的指针，它是一个平面数组，表示对元素矩阵逐行扫描。(非零点表示该点属于结构元)。如果指针为空，则表示平面数组中的所有元素都是非零的，即结构元是一个长方形(该参数仅仅当shape参数是 
  <CODE>CV_SHAPE_CUSTOM</CODE> 时才予以考虑)。 </DD></DL>
<P>函数 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cv CreateStructuringElementEx">cv 
CreateStructuringElementEx</A> 分配和填充结构 <CODE>IplConvKernel</SPAN></CODE>, 
它可作为形态操作中的结构元素。</P>
<HR>

<H3><A name=decl_cvReleaseStructuringElement>ReleaseStructuringElement</A></H3>
<P class=Blurb><SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">删除结构元素</SPAN></P><PRE>void cvReleaseStructuringElement( IplConvKernel** element );
</PRE>
<P>
<DL>
  <DT>element
  <DD>被删除的结构元素的指针 </DD></DL>
<P>函数 <A 
href="http://fsa.ia.ac.cn/opencv-doc-cn/opencv-doc-cn-0.9.7/ref/opencvref_cv.cn.htm#decl_cvReleaseStructuringElement">cvReleaseStructuringElement</A> 
释放结构 <CODE>IplConvKernel 。</SPAN></CODE>如果 <CODE>*element</SPAN></CODE> 为 
<CODE>NULL</SPAN></CODE>, 则函数不作用。</P>
<HR>

<H3><A name=decl_cvErode>Erode</A></H3>
<P class=Blurb><SPAN 
style="FONT-FAMILY: 宋体; mso-ascii-font-family: Helvetica; mso-hansi-font-family: Helvetica">使用任意结构元素腐蚀图像</SPAN></P><PRE>void cvErode( const CvArr* src, CvArr* dst, IplConvKernel* element=NULL, int iterations=1 );
</PRE>
<P>
<DL>
  <DT>src
  <DD>输入图像.