3.8　滑动条事件

在OpenCV中，滑动条设计的主要目的是在视频播放帧中选择特定帧。在和父窗口使用时，需要给滑动条赋予一个特别的名字（通常是一个字符串），接下来直接通过那个名字进行引用。

创建滑动条的函数是createTrackbar，函数声明如下：

     CreateTrackbar(trackbarName, windowName, value, count, onChange) → None

其中，参数trackbarName是滑动条的名称；windowName是滑动条将要添加到父窗口的名称，一旦滑动条创建好，它就将被添加到窗口的顶部或底部，滑动条不会挡住任何已经在窗口中的图像，只会让窗口变大，窗口的名称将作为一个窗口的标记，至于滑动条上滑动钮的确切位置则由操作系统决定，一般都是最左边；参数value是一个指向整数的指针，这个整数值会随着滑动钮的移动自动变化；参数count是滑动条可以滑动的最大值；参数onChange是一个指向回调函数的指针，当滑动钮移动时回调函数就会自动调用。

回调函数类型TrackbarCallback的定义如下：

     def TrackbarCallback(pos,userdata)

其中，参数pos表示滚动块的当前位置；userdata是传给回调函数的可选参数。这个回调函数不是必需的，如果不需要直接赋值为NULL就没有回调函数，移动滑动钮的唯一响应就是createTrackbar的参数value指向的变量值的变化。

除了创建滑动条的函数外，OpenCV还提供了函数getTrackbarPos（用于获取滑动块的位置）和函数setTrackbarPos（用于设置滑动条的位置）。

getTrackbarPos的函数声明如下：

     GetTrackbarPos(trackbarName, windowName) → retval

其中，参数trackbarName是滑动条的名称；windowName是滑动条将要添加到父窗口的名称。函数返回滑动块的当前位置。

setTrackbarPos的函数声明如下：

     SetTrackbarPos(trackbarName, windowName, pos) → None

其中，参数trackName表示滚动条的名称；windowName是滑动条将要添加到父窗口的名称；pos表示要设置的滑动块位置。下面我们看一个专业的例子，利用滑动块调节设置参数。

【例3.12】 利用滑动块控制图片的亮度

在上述代码中，首先读取test.jpg，然后定义滑动块的两个回调函数updateAlpha和updateBeta，接着利用函数namedWindow创建1个窗口，并利用函数createTrackbar创建2个滑动条，这样窗口上就有了2个滑动条。updateAlpha和updateBeta都是滑动条的回调函数，用于响应用户滑动钮这个事件。最后一个while循环，等待用户按键q退出。在回调函数中，np.uint8是专门用于存储各种图像的（包括RGB、灰度图像等），范围是0～255。该函数接收的参数是一个数组，需要注意的是，clip函数的返回值是uint8的参数，但是这个函数仅仅是对原数据和0xff相与（和最低2字节数据相与），这就容易导致如果原数据是大于255的，那么在直接使用np.uint8()后，比第八位更大的数据都被截断了。clip这个函数将数组中的元素限制在a_min、a_max之间，大于a_max的就使得它等于a_max，小于a_min的就使得它等于a_min，它的原型是numpy.clip(a, a_min, a_max,out=None)。其中，a是一个数组，后面两个参数分别表示最小值和最大值。uint8和clip我们在后面章节还会详细讲到。

运行工程，结果如图3-12所示。