opencv2.4.8参考手册（一） 简介

输出数据的自动内存分配

opencv自动释放内存，同样大部分时候也为输出函数的参数自动分配内存，所以如果一个函数有一个或多个输入数组(cv::Mat 实例)和一些输出数组，输出数组会被自动分配或重分配内存。输出数组的大小和类型由输入数组决定。如果需要，函数还会接受额外参数来表明输出数组的属性
例子：

#include "cv.h"
#include "highgui.h"
using namespace cv;
int main(int, char**)
{
VideoCapture cap(0);
if(!cap.isOpened()) return -1;
Mat frame, edges;
namedWindow("edges",1);
for(;;)
{
cap >> frame;
cvtColor(frame, edges, CV_BGR2GRAY);
GaussianBlur(edges, edges, Size(7,7), 1.5, 1.5);
Canny(edges, edges, 0, 30, 3);
imshow("edges", edges);
if(waitKey(30) >= 0) break;
}
return 0;
}

这个技术的关键组件就是Mat::create方法，它接受期望的大小和类型，如果数组已经有特定的大小和类型，那么该方法什么也不做，否则它就会释放先前的分配的数据(递减引用计数器并与0比较)，然后申请分配一块新的指定大小的事缓冲区。大部分函数都会为每一个输出数组调用Mat::create方法，这也是解释了输出数组的自动内存分配机制。

一些需要注意的特例就是cv::mixChannels, cv::RNG::fill和其他一些函数和方法，它们并不会为输出数组分配内存，所以你需要事先分配。

饱和算术

作为一个计算机视觉库，opencv经常要处理的图像像素点往往是紧凑的，8位或才16位每通道形式的数据，这样就要求限制数据的取值范围，进一步说，图像的特定操作（如颜色空间转换，亮度/对比度调整，锐化，复杂的内插（bi-cubic, Lanczos））会产生超出可接受的数据范围，如果你只能够存储结果的低8位抑或是16位，这会导致视觉缺陷或者更进一步影响到后续的分析处理，为了解决这个问题，所谓的饱和算术派上用场了，如，为了存储r(8位的图像数据),以下操作会让你在0~255内找到最接近真实值的值。

I(x; y) = min(max(round(r); 0); 255)

同样的规则也被用来处理有符号8位，有符号16位和无符号类型，这样的语义在库中随处可见，在C++语言中，用的是类标准C++中类型转换操作的saturate_cast，看下面对于 上面方程的实现：

I.at(y, x) = saturate_cast(r);

cv::uchar是opencv中8位无符号类型，

固定的像素类型，限制使用模板

模板是c++中用来实现强大，高效并且安全数据结构和算法的伟大特征，但是过度的模板使用又会导致编译时间变长和代码量变大，此外，it is difficult to separate an interface and implementation when templates are used exclusively（？？），当然这对基本的算法没什么问题，但是对于一个算法就拥有几千行代码的计算机视觉库来说，是不适用的，正因为如此，也因为简化与其他语言的绑定开发（像python,jave,matlab这些压根就没有模板的语言），当前的opencv是基于多态性的运行时动态绑定的实现，在这些动态绑定过慢(like pixel access operators),、不可能(generic Ptr implementation)或者压根就不方便(saturate_cast())的地方，opencv实现就介绍小的模板类、方法和函数，而opencv 的其他地方则限制了模板的使用。

因此，计算机视觉库可以操作的数据类型是一组有限的、固定的基本数据类型。那就是数组元素需要是以下类型：

? 8-bit unsigned integer (uchar)
? 8-bit signed integer (schar)
? 16-bit unsigned integer (ushort)
? 16-bit signed integer (short)
? 32-bit signed integer (int)
? 32-bit floating-point number (float)
? 64-bit floating-point number (double)

? 元组数据类型，元组里的元素的类型（以上一种）是一致的，图像数组就是元组的一种，被叫作多通道数组，以区分单通道数组。最大的可能通道数是用宏CV_CN_MAX定义的，当前版本设置为512

对于这此基本的类型，下面的枚举可以使用：

enum { CV_8U=0, CV_8S=1, CV_16U=2, CV_16S=3, CV_32S=4, CV_32F=5, CV_64F=6 };

多通道类型可以用下面选项来指定：

? CV_8UC1 ... CV_64FC4 常数(通道数据1-4)
? CV_8UC(n) ... CV_64FC(n) or CV_MAKETYPE(CV_8U, n) ... CV_MAKETYPE(CV_64F, n) 当通道数大于4或者编译时不可知即变量可用这些宏

注意：CV_32FC1 == CV_32F, CV_32FC2 == CV_32FC(2) == CV_MAKETYPE(CV_32F, 2), and

CV_MAKETYPE(depth, n) == ((x&7)

Mat mtx(3, 3, CV_32F); // make a 3x3 floating-point matrix
Mat cmtx(10, 1, CV_64FC2); // make a 10x1 2-channel floating-point
// matrix (10-element complex vector)
Mat img(Size(1920, 1080), CV_8UC3); // make a 3-channel (color) image
// of 1920 columns and 1080 rows.
Mat grayscale(image.size(), CV_MAKETYPE(image.depth(), 1)); // make a 1-channel image of
// the same size and same

人脸检测算法只能处理8位的灰度图像或者彩色图像

线性代数函数和大部分机器学习算法只能处理浮点型数据

基本函数，如cv::add,支持所有类型

彩色空间转换函数支持8位无符号，16位无符号，和32位浮点类型。

各个函数的支持类型的子集根据实际应用而设定并且可以根据用户需求在以后来扩展

输入数组和输出数组

很多opencv函数能够处理2维或多维数值数组，通常，这些函数以cpp:class:Mat作为参数，但是在一些场合，用std::vector（如点集）或Matx（如3X3单应矩阵？）要更为方便一些，为了避免API的重复，特殊的“代理”类被引入，由InputArray派生的OutputArray是用来为函数指定一个输出数组。通常，你需要关心这些中间类型（但你不需要明确申明这些类型的变量）：这些都是会自动完成任务的。你可以假设除了InputArray/OutputArray，你总可以用Mat, std::vector, Matx, Vec or Scalar。当一个函数有一个可选择的输入或者输出数组时，而你又不必或者不想定义该数组，你可以传入cv::noArray()。

错误处理

opencv利用异常来触发关键错误，当输入数据是正确的类型并且数据在指定范围内，但是算法由于某些原因没有成功，函数会返回特定的错误代码（通常，是一个布尔变量）

异常可以通过cv::Exception类来实例化，cv::Exception是由std::exception派生的，所以它很容易被标准C++库组件处理。

try
{
... // call OpenCV
}
catch( cv::Exception& e )
{
const char* err_msg = e.what();
std::cout 

多线程和重入

当前版本的OPENCV是完全支持重入的，也就是说，同样的函数，同样的类实例的常数方法，或者同样的不同类实例的非常数方法可以被不同的线程调用，当然，同样的cv::Mat也可以在不同的线程中调用，因为引用计数器的操作是基于架构的原子指令