Video for Linux Two API Specification Revision 2.6.32【转】

文章出处：http://blog.csdn.net/jack0106

V4L2 较 V4L 有较大的改动，并已成为 2.6 的标准接口，函盖 video/ dvb /FM… ，多数驱动都在向 V4l2 迁移 。 V4L2 采用流水线的方式，操作更简单直观。 一般来说，需要用到的函数就是 open() ， close() 和 ioctl () 。

推荐的参考资源：

(1) Video for Linux Two API Specification---Revision 2.6.32

http://linuxtv.org/downloads/video4linux/API/V4L2_API/spec-single/v4l2.html

(2) capture.c 官方示例程序

说明：强烈建议阅读这两个参考资源！！！如果是初次接触，建议可以先浏览一下第一个参考文档，但是capture.c程序一定要仔细的看一下，至少得先让它能够跑起来(正常运行情况下，在终端下会不断的输出一个 ".")。

下面的讲解，都将是基于capture.c程序。但是，capture.c程序有一点点小的不足，后面的内容中会介绍到，在末尾，会附上我稍微修改过的一个版本。

对照capture.c程序，值得我们注意的主要是以下几点：

(1)3 种 I/O 方式

(1.1)read/write，直接使用 read 和 write 函数进行读写。这种方式最简单，但是这种方式会在 用户空间和内核空间不断拷贝数据 ，同时在用户空间和内核空间占用 了 大量内存， 效率不高。

(1.2)mmap ，把硬件设备 里的内存映射 到位于用户空间的应用程序中的内存地址上， 直接处理设备内存，这是一种有效的 方式。

(1.3) userptr ，内存由用户空间的应用程序分配，并把地址传递到内核中的驱动程序， 然后由 v4l2 驱动程序直接将数据填充到用户空间的内存中。

第一种方式效率是最低的，后面两种方法都能提高执行的效率，但是对于mmap 方式，文档中有这样一句描述 --Remember the buffers are allocated in physical memory, as opposed to virtual memory which can be swapped out to disk. Applications should free the buffers as soon as possible with the munmap () function .(使用mmap方法的时候，buffers相当于是在内核空间中分 配的，这种情况下，这些buffer是不能被交换到虚拟内存中，虽然这种方法不怎么影响读写效率，但是它一直占用着内核空间中的内存，当系统的内存有限的 时候，如果同时运行有大量的进程，则对系统的整体性能会有一定的影响。如果对于这里描述的这些概念还不是很清楚的话，没事，先记住下面给出的结论就行了， 以后再详细的去了解)。

所以，对于 I/O 方法的选择，推荐的顺序是 userptr 、 mmap 、 read-write 。

(2) 当使用 mmap 或 userptr 方式的时候，有一个环形缓冲队列的概念，这个队列中，有 n 个 buffer ，驱动程序采集到的视频帧数据，就是存储在每个 buffer 中。

在每次用 VIDIOC_DQBUF 取出一个 buffer ，并且处理完数据后，一定要用 VIDIOC_QBUF 将这个 buffer 再次放回到环形缓冲队列中。

环形缓冲队列，也使得这两种 I/O 方式的效率高于直接 read/write 。

( 3 ) 采集视频的分辨率

(3.1) Cropping ，裁剪 ( 并非所有的摄像头都支持裁剪功能 )

(3.2) Scaling ，缩放

下面有个参考图片，注意图片中的 4 个矩形：

红色 —bounds ，是 最大的能捕捉到的图像 范围。这个是摄像头本身的硬件属性，比如摄像头CCD的分辨率。

蓝色 — defrect ，是 我们的设备能够得到的最大的 范围。要区别于红色的部分，这是在CCD分辨率的基础上，我们的系统通过驱动软件能够获得的最大的分辨率。defrect和bounds可能会有小的差别，也可能是重合的。

绿色 —crop ，是我们希望裁剪的部分 ( 区别裁剪和缩放 ) 。也就是我我们希望获取CCD中的某个矩形部分。

紫色 — fmt ，伸缩，这一部分是我们最终获得的图像的大小。在使用 VIDIOC_S_FMT 时，驱动程序会计算出图像帧数据的大小，并且返回给我们。 ( 后面还会提到这个 )

如果硬件设备不支持 crop ，则相当于就是直接在 defrect 矩形上面设置大小。可以简单的理解为直接设置期望的视频分辨率。普通的摄像头，通常都不支持crop，在capture.c程序中也能看到对crop的处理方式--如果有crop功能，则crop，否则就跳过，直接使用VIDIOC_S_FMT。

(4) capture.c 程序中的 process_image 函数。

capture.c 程序主要是用来演示怎样使用 v4l2 接口，并没有对采集到的视频帧数据做任何实际的处理，仅仅用 process_image 函数表示了处理图像的代码位置。

process_image 函数只有一个参数，就是存储视频帧的内存的地址指针，但是在真正的应用中，通常还需要知道该指针指向的数据的大小。

因此可以修改函数，改成 void process_image ( const void * p, int len ) ，但是每次调用 process_image 的时候，第 2 个参数该传递什么值？

考虑到程序中对 buffer 的定义

struct buffer {

void * start;

size_t length};

如果将 buffer.length 作为第 2 个参数传递到修改后的 process_image 函数中，这样做是不正确的。 process_image 需要的第二个参数应该是每帧图像的大小，仔细阅读代码后会发现， buffer.length 并不一定就等于图像帧的大小。 (buffer 的大小，还需要考虑其他的一些因素，比如内存对齐等 )。

(5) 图像帧的大小和图像的格式

首先要明确一点， RGB 和 YUV 只是两种很笼统的划分方法，还需要知道具体的封装方式，才有办法计算出视频帧数据的实际大小。

对于YUV而言， YUV 格式通常有两大类：打包（ packed ）格式和平面（ planar ）格式。前者将 YUV 分量存放在同一个数组中，通常是几个相邻的像素组成一个宏像素（ macro-pixel ）；而后者使用三个数组分开存放 YUV 三个分量，就像是一个三维平面一样。

以h.263为例， H.263 编码算法要求图象被编码为一个亮度信号和两个色差成分（ Y ， Cb 和 Cr ），可以记为 YCbCr ， 亮度的取样结构都是 dx 个 象素每行， dy 行每幅图象。 两个色差成分的取样都是 dx/2 个象素每行， dy /2 行每幅 图象。如下图。

H.263编码算法 要求的这种图象格式对应到 v4l2 里面，就是 V4L2_PIX_FMT_YUV420 ， (YUV 是 YCbCr ， YVU 是 YCrCb ) 。

V4L2_PIX_FMT_YUV420是一种平坦存储格式，也就是说，在内存中，先存储所有的 Y 值，然后是所有的 Cb 值，最后才是 Cr 值。

假设有一个 V 4L2_PIX_FMT_ Y UV 420 格式的图像，分辨率是 4 × 4 像素，那么该图像帧在内存中存储形式就是

根据前面的描述，可以看出一个公式，当使用 V4L2_PIX_FMT_YUV420 格式采集图像的时候，如果图像的宽度为 width ，高度为 height ，那么图像占用的内存的大小就是 imagesize = width * height * 3 / 2。

前面提到过， 使用 VIDIOC_S_FMT 时，驱动程序会计算出图像帧数据的大小，并且返回给 我们。当 width = 640 ， height = 480 的时候，根据公式， imagesize = 640 * 480 * 3 / 2 = 460800 。

同样设置的时候，返回的 fmt.fmt.pix.sizeimage 也是 460800 。

如果是使用其他的格式，都可以根据各种格式的定义来计算它们实际占用的内存的大小以及他们在内 存中的存储方式。

建议将 Video for Linux Two API Specification 作为手册，里面对视频格式的介绍比较全面。

(6)下面给出修改过的capture.c代码，只改动了一点点

view plaincopy to clipboardprint?

1. #include <stdio.h>
2. #include <stdlib.h>
3. #include <string.h>
4. #include <assert.h>
5. #include <getopt.h> /* getopt_long() */
6. #include <fcntl.h> /* low-level i/o */
7. #include <unistd.h>
8. #include <errno.h>
9. #include <malloc.h>
10. #include <sys/stat.h>
11. #include <sys/types.h>
12. #include <sys/time.h>
13. #include <sys/mman.h>
14. #include <sys/ioctl.h>
15. #include <asm/types.h> /* for videodev2.h */
16. #include <linux/videodev2.h>
17. #define CLEAR(x) memset (&(x), 0, sizeof (x))
18. typedef enum {
19. IO_METHOD_READ, IO_METHOD_MMAP, IO_METHOD_USERPTR,
20. } io_method;
21. struct buffer {
22. void * start;
23. size_t length; //buffer's length is different from cap_image_size
24. };
25. static char * dev_name = NULL;
26. static io_method io = IO_METHOD_MMAP; //IO_METHOD_READ;//IO_METHOD_MMAP;
27. static int fd = -1;
28. struct buffer * buffers = NULL;
29. static unsigned int n_buffers = 0;
30. static FILE * outf = 0;
31. static unsigned int cap_image_size = 0; //to keep the real image size!!
32. static void errno_exit( const char * s) {
33. fprintf(stderr, "%s error %d, %s/n" , s, errno, strerror(errno));
34. exit(EXIT_FAILURE);
35. }
36. static int xioctl( int fd, int request, void * arg) {
37. int r;
38. do
39. r = ioctl(fd, request, arg);
40. while (-1 == r && EINTR == errno);
41. return r;
42. }
43. static void process_image( const void * p, int len) {
44. // static char[115200] Outbuff ;
45. fputc('.' , stdout);
46. if (len > 0) {
47. fputc('.' , stdout);
48. fwrite(p, 1, len, outf);
49. }
50. fflush(stdout);
51. }
52. static int read_frame( void ) {
53. struct v4l2_buffer buf;
54. unsigned int i;
55. switch (io) {
56. case IO_METHOD_READ:
57. if (-1 == read(fd, buffers[0].start, buffers[0].length)) {
58. switch (errno) {
59. case EAGAIN:
60. return 0;
61. case EIO:
62. /* Could ignore EIO, see spec. */
63. /* fall through */
64. default :
65. errno_exit("read" );
66. }
67. }
68. // printf("length = %d/r", buffers[0].length);
69. // process_image(buffers[0].start, buffers[0].length);
70. printf("image_size = %d,/t IO_METHOD_READ buffer.length=%d/r" ,
71. cap_image_size, buffers[0].length);
72. process_image(buffers[0].start, cap_image_size);
73. break ;
74. case IO_METHOD_MMAP:
75. CLEAR (buf);
76. buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
77. buf.memory = V4L2_MEMORY_MMAP;
78. if (-1 == xioctl(fd, VIDIOC_DQBUF, &buf)) {
79. switch (errno) {
80. case EAGAIN:
81. return 0;
82. case EIO:
83. /* Could ignore EIO, see spec. */
84. /* fall through */
85. default :
86. errno_exit("VIDIOC_DQBUF" );
87. }
88. }
89. assert(buf.index < n_buffers);
90. // printf("length = %d/r", buffers[buf.index].length);
91. // process_image(buffers[buf.index].start, buffers[buf.index].length);
92. printf("image_size = %d,/t IO_METHOD_MMAP buffer.length=%d/r" ,
93. cap_image_size, buffers[0].length);
94. process_image(buffers[0].start, cap_image_size);
95. if (-1 == xioctl(fd, VIDIOC_QBUF, &buf))
96. errno_exit("VIDIOC_QBUF" );
97. break ;
98. case IO_METHOD_USERPTR:
99. CLEAR (buf);
100. buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
101. buf.memory = V4L2_MEMORY_USERPTR;
102. if (-1 == xioctl(fd, VIDIOC_DQBUF, &buf)) {
103. switch (errno) {
104. case EAGAIN:
105. return 0;
106. case EIO:
107. /* Could ignore EIO, see spec. */
108. /* fall through */
109. default :
110. errno_exit("VIDIOC_DQBUF" );
111. }
112. }
113. for (i = 0; i < n_buffers; ++i)
114. if (buf.m.userptr == (unsigned long ) buffers[i].start && buf.length
115. == buffers[i].length)
116. break ;
117. assert(i < n_buffers);
118. // printf("length = %d/r", buffers[i].length);
119. // process_image((void *) buf.m.userptr, buffers[i].length);
120. printf("image_size = %d,/t IO_METHOD_USERPTR buffer.length=%d/r" ,
121. cap_image_size, buffers[0].length);
122. process_image(buffers[0].start, cap_image_size);
123. if (-1 == xioctl(fd, VIDIOC_QBUF, &buf))
124. errno_exit("VIDIOC_QBUF" );
125. break ;
126. }
127. return 1;
128. }
129. static void mainloop( void ) {
130. unsigned int count;
131. count = 100;
132. while (count-- > 0) {
133. for (;;) {
134. fd_set fds;
135. struct timeval tv;
136. int r;
137. FD_ZERO(&fds);
138. FD_SET(fd, &fds);
139. /* Timeout. */
140. tv.tv_sec = 2;
141. tv.tv_usec = 0;
142. r = select(fd + 1, &fds, NULL, NULL, &tv);
143. if (-1 == r) {
144. if (EINTR == errno)
145. continue ;
146. errno_exit("select" );
147. }
148. if (0 == r) {
149. fprintf(stderr, "select timeout/n" );
150. exit(EXIT_FAILURE);
151. }
152. if (read_frame())
153. break ;
154. /* EAGAIN - continue select loop. */
155. }
156. }
157. }
158. static void stop_capturing( void ) {
159. enum v4l2_buf_type type;
160. switch (io) {
161. case IO_METHOD_READ:
162. /* Nothing to do. */
163. break ;
164. case IO_METHOD_MMAP:
165. case IO_METHOD_USERPTR:
166. type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
167. if (-1 == xioctl(fd, VIDIOC_STREAMOFF, &type))
168. errno_exit("VIDIOC_STREAMOFF" );
169. break ;
170. }
171. }
172. static void start_capturing( void ) {
173. unsigned int i;
174. enum v4l2_buf_type type;
175. switch (io) {
176. case IO_METHOD_READ:
177. /* Nothing to do. */
178. break ;
179. case IO_METHOD_MMAP:
180. for (i = 0; i < n_buffers; ++i) {
181. struct v4l2_buffer buf;
182. CLEAR (buf);
183. buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
184. buf.memory = V4L2_MEMORY_MMAP;
185. buf.index = i;
186. if (-1 == xioctl(fd, VIDIOC_QBUF, &buf))
187. errno_exit("VIDIOC_QBUF" );
188. }
189. type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
190. if (-1 == xioctl(fd, VIDIOC_STREAMON, &type))
191. errno_exit("VIDIOC_STREAMON" );
192. break ;
193. case IO_METHOD_USERPTR:
194. for (i = 0; i < n_buffers; ++i) {
195. struct v4l2_buffer buf;
196. CLEAR (buf);
197. buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
198. buf.memory = V4L2_MEMORY_USERPTR;
199. buf.index = i;
200. buf.m.userptr = (unsigned long ) buffers[i].start;
201. buf.length = buffers[i].length;
202. if (-1 == xioctl(fd, VIDIOC_QBUF, &buf))
203. errno_exit("VIDIOC_QBUF" );
204. }
205. type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
206. if (-1 == xioctl(fd, VIDIOC_STREAMON, &type))
207. errno_exit("VIDIOC_STREAMON" );
208. break ;
209. }
210. }
211. static void uninit_device( void ) {
212. unsigned int i;
213. switch (io) {
214. case IO_METHOD_READ:
215. free(buffers[0].start);
216. break ;
217. case IO_METHOD_MMAP:
218. for (i = 0; i < n_buffers; ++i)
219. if (-1 == munmap(buffers[i].start, buffers[i].length))
220. errno_exit("munmap" );
221. break ;
222. case IO_METHOD_USERPTR:
223. for (i = 0; i < n_buffers; ++i)
224. free(buffers[i].start);
225. break ;
226. }
227. free(buffers);
228. }
229. static void init_read(unsigned int buffer_size) {
230. buffers = calloc(1, sizeof (*buffers));
231. if (!buffers) {
232. fprintf(stderr, "Out of memory/n" );
233. exit(EXIT_FAILURE);
234. }
235. buffers[0].length = buffer_size;
236. buffers[0].start = malloc(buffer_size);
237. if (!buffers[0].start) {
238. fprintf(stderr, "Out of memory/n" );
239. exit(EXIT_FAILURE);
240. }
241. }
242. static void init_mmap( void ) {
243. struct v4l2_requestbuffers req;
244. CLEAR (req);
245. req.count = 4;
246. req.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
247. req.memory = V4L2_MEMORY_MMAP;
248. if (-1 == xioctl(fd, VIDIOC_REQBUFS, &req)) {
249. if (EINVAL == errno) {
250. fprintf(stderr, "%s does not support "
251. "memory mapping/n" , dev_name);
252. exit(EXIT_FAILURE);
253. } else {
254. errno_exit("VIDIOC_REQBUFS" );
255. }
256. }
257. if (req.count < 2) {
258. fprintf(stderr, "Insufficient buffer memory on %s/n" , dev_name);
259. exit(EXIT_FAILURE);
260. }
261. buffers = calloc(req.count, sizeof (*buffers));
262. if (!buffers) {
263. fprintf(stderr, "Out of memory/n" );
264. exit(EXIT_FAILURE);
265. }
266. for (n_buffers = 0; n_buffers < req.count; ++n_buffers) {
267. struct v4l2_buffer buf;
268. CLEAR (buf);
269. buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
270. buf.memory = V4L2_MEMORY_MMAP;
271. buf.index = n_buffers;
272. if (-1 == xioctl(fd, VIDIOC_QUERYBUF, &buf))
273. errno_exit("VIDIOC_QUERYBUF" );
274. buffers[n_buffers].length = buf.length;
275. buffers[n_buffers].start = mmap(NULL /* start anywhere */ , buf.length,
276. PROT_READ | PROT_WRITE /* required */ ,
277. MAP_SHARED /* recommended */ , fd, buf.m.offset);
278. if (MAP_FAILED == buffers[n_buffers].start)
279. errno_exit("mmap" );
280. }
281. }
282. static void init_userp(unsigned int buffer_size) {
283. struct v4l2_requestbuffers req;
284. unsigned int page_size;
285. page_size = getpagesize();
286. buffer_size = (buffer_size + page_size - 1) & ~(page_size - 1);
287. CLEAR (req);
288. req.count = 4;
289. req.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
290. req.memory = V4L2_MEMORY_USERPTR;
291. if (-1 == xioctl(fd, VIDIOC_REQBUFS, &req)) {
292. if (EINVAL == errno) {
293. fprintf(stderr, "%s does not support "
294. "user pointer i/o/n" , dev_name);
295. exit(EXIT_FAILURE);
296. } else {
297. errno_exit("VIDIOC_REQBUFS" );
298. }
299. }
300. buffers = calloc(4, sizeof (*buffers));
301. if (!buffers) {
302. fprintf(stderr, "Out of memory/n" );
303. exit(EXIT_FAILURE);
304. }
305. for (n_buffers = 0; n_buffers < 4; ++n_buffers) {
306. buffers[n_buffers].length = buffer_size;
307. buffers[n_buffers].start = memalign(/* boundary */ page_size,
308. buffer_size);
309. if (!buffers[n_buffers].start) {
310. fprintf(stderr, "Out of memory/n" );
311. exit(EXIT_FAILURE);
312. }
313. }
314. }
315. static void init_device( void ) {
316. struct v4l2_capability cap;
317. struct v4l2_cropcap cropcap;
318. struct v4l2_crop crop;
319. struct v4l2_format fmt;
320. unsigned int min;
321. if (-1 == xioctl(fd, VIDIOC_QUERYCAP, &cap)) {
322. if (EINVAL == errno) {
323. fprintf(stderr, "%s is no V4L2 device/n" , dev_name);
324. exit(EXIT_FAILURE);
325. } else {
326. errno_exit("VIDIOC_QUERYCAP" );
327. }
328. }
329. if (!(cap.capabilities & V4L2_CAP_VIDEO_CAPTURE)) {
330. fprintf(stderr, "%s is no video capture device/n" , dev_name);
331. exit(EXIT_FAILURE);
332. }
333. switch (io) {
334. case IO_METHOD_READ:
335. if (!(cap.capabilities & V4L2_CAP_READWRITE)) {
336. fprintf(stderr, "%s does not support read i/o/n" , dev_name);
337. exit(EXIT_FAILURE);
338. }
339. break ;
340. case IO_METHOD_MMAP:
341. case IO_METHOD_USERPTR:
342. if (!(cap.capabilities & V4L2_CAP_STREAMING)) {
343. fprintf(stderr, "%s does not support streaming i/o/n" , dev_name);
344. exit(EXIT_FAILURE);
345. }
346. break ;
347. }
348. //not all capture support crop!!!!!!!
349. /* Select video input, video standard and tune here. */
350. printf("-#-#-#-#-#-#-#-#-#-#-#-#-#-/n" );
351. CLEAR (cropcap);
352. cropcap.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
353. if (0 == xioctl(fd, VIDIOC_CROPCAP, &cropcap)) {
354. crop.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
355. #ifndef CROP_BY_JACK
356. crop.c = cropcap.defrect; /* reset to default */
357. #else
358. crop.c.left = cropcap.defrect.left;
359. crop.c.top = cropcap.defrect.top;
360. crop.c.width = 352;
361. crop.c.height = 288;
362. #endif
363. printf("----->has ability to crop!!/n" );
364. printf("cropcap.defrect = (%d, %d, %d, %d)/n" , cropcap.defrect.left,
365. cropcap.defrect.top, cropcap.defrect.width,
366. cropcap.defrect.height);
367. if (-1 == xioctl(fd, VIDIOC_S_CROP, &crop)) {
368. switch (errno) {
369. case EINVAL:
370. /* Cropping not supported. */
371. break ;
372. default :
373. /* Errors ignored. */
374. break ;
375. }
376. printf("-----!!but crop to (%d, %d, %d, %d) Failed!!/n" ,
377. crop.c.left, crop.c.top, crop.c.width, crop.c.height);
378. } else {
379. printf("----->sussess crop to (%d, %d, %d, %d)/n" , crop.c.left,
380. crop.c.top, crop.c.width, crop.c.height);
381. }
382. } else {
383. /* Errors ignored. */
384. printf("!! has no ability to crop!!/n" );
385. }
386. printf("-#-#-#-#-#-#-#-#-#-#-#-#-#-/n" );
387. printf("/n" );
388. crop finished!
389. //set the format
390. CLEAR (fmt);
391. fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
392. fmt.fmt.pix.width = 640;
393. fmt.fmt.pix.height = 480;
394. //V4L2_PIX_FMT_YVU420, V4L2_PIX_FMT_YUV420 — Planar formats with 1/2 horizontal and vertical chroma resolution, also known as YUV 4:2:0
395. //V4L2_PIX_FMT_YUYV — Packed format with 1/2 horizontal chroma resolution, also known as YUV 4:2:2
396. fmt.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;//V4L2_PIX_FMT_YUV420;//V4L2_PIX_FMT_YUYV;
397. fmt.fmt.pix.field = V4L2_FIELD_INTERLACED;
398. {
399. printf("-#-#-#-#-#-#-#-#-#-#-#-#-#-/n" );
400. printf("=====will set fmt to (%d, %d)--" , fmt.fmt.pix.width,
401. fmt.fmt.pix.height);
402. if (fmt.fmt.pix.pixelformat == V4L2_PIX_FMT_YUYV) {
403. printf("V4L2_PIX_FMT_YUYV/n" );
404. } else if (fmt.fmt.pix.pixelformat == V4L2_PIX_FMT_YUV420) {
405. printf("V4L2_PIX_FMT_YUV420/n" );
406. } else if (fmt.fmt.pix.pixelformat == V4L2_PIX_FMT_NV12) {
407. printf("V4L2_PIX_FMT_NV12/n" );
408. }
409. }
410. if (-1 == xioctl(fd, VIDIOC_S_FMT, &fmt))
411. errno_exit("VIDIOC_S_FMT" );
412. {
413. printf("=====after set fmt/n" );
414. printf(" fmt.fmt.pix.width = %d/n" , fmt.fmt.pix.width);
415. printf(" fmt.fmt.pix.height = %d/n" , fmt.fmt.pix.height);
416. printf(" fmt.fmt.pix.sizeimage = %d/n" , fmt.fmt.pix.sizeimage);
417. cap_image_size = fmt.fmt.pix.sizeimage;
418. printf(" fmt.fmt.pix.bytesperline = %d/n" , fmt.fmt.pix.bytesperline);
419. printf("-#-#-#-#-#-#-#-#-#-#-#-#-#-/n" );
420. printf("/n" );
421. }
422. cap_image_size = fmt.fmt.pix.sizeimage;
423. /* Note VIDIOC_S_FMT may change width and height. */
424. printf("-#-#-#-#-#-#-#-#-#-#-#-#-#-/n" );
425. /* Buggy driver paranoia. */
426. min = fmt.fmt.pix.width * 2;
427. if (fmt.fmt.pix.bytesperline < min)
428. fmt.fmt.pix.bytesperline = min;
429. min = fmt.fmt.pix.bytesperline * fmt.fmt.pix.height;
430. if (fmt.fmt.pix.sizeimage < min)
431. fmt.fmt.pix.sizeimage = min;
432. printf("After Buggy driver paranoia/n" );
433. printf(" >>fmt.fmt.pix.sizeimage = %d/n" , fmt.fmt.pix.sizeimage);
434. printf(" >>fmt.fmt.pix.bytesperline = %d/n" , fmt.fmt.pix.bytesperline);
435. printf("-#-#-#-#-#-#-#-#-#-#-#-#-#-/n" );
436. printf("/n" );
437. switch (io) {
438. case IO_METHOD_READ:
439. init_read(fmt.fmt.pix.sizeimage);
440. break ;
441. case IO_METHOD_MMAP:
442. init_mmap();
443. break ;
444. case IO_METHOD_USERPTR:
445. init_userp(fmt.fmt.pix.sizeimage);
446. break ;
447. }
448. }
449. static void close_device( void ) {
450. if (-1 == close(fd))
451. errno_exit("close" );
452. fd = -1;
453. }
454. static void open_device( void ) {
455. struct stat st;
456. if (-1 == stat(dev_name, &st)) {
457. fprintf(stderr, "Cannot identify '%s': %d, %s/n" , dev_name, errno,
458. strerror(errno));
459. exit(EXIT_FAILURE);
460. }
461. if (!S_ISCHR(st.st_mode)) {
462. fprintf(stderr, "%s is no device/n" , dev_name);
463. exit(EXIT_FAILURE);
464. }
465. fd = open(dev_name, O_RDWR /* required */ | O_NONBLOCK, 0);
466. if (-1 == fd) {
467. fprintf(stderr, "Cannot open '%s': %d, %s/n" , dev_name, errno,
468. strerror(errno));
469. exit(EXIT_FAILURE);
470. }
471. }
472. static void usage( FILE * fp, int argc, char ** argv) {
473. fprintf(fp, "Usage: %s [options]/n/n"
474. "Options:/n"
475. "-d | --device name Video device name [/dev/video0]/n"
476. "-h | --help Print this message/n"
477. "-m | --mmap Use memory mapped buffers/n"
478. "-r | --read Use read() calls/n"
479. "-u | --userp Use application allocated buffers/n"
480. "" , argv[0]);
481. }
482. static const char short_options[] = "d:hmru" ;
483. static const struct option long_options[] = { { "device" , required_argument,
484. NULL, 'd' }, { "help" , no_argument, NULL, 'h' }, { "mmap" , no_argument,
485. NULL, 'm' }, { "read" , no_argument, NULL, 'r' }, { "userp" ,
486. no_argument, NULL, 'u' }, { 0, 0, 0, 0 } };
487. int main( int argc, char ** argv) {
488. dev_name = "/dev/video0" ;
489. outf = fopen("out.yuv" , "wb" );
490. for (;;) {
491. int index;
492. int c;
493. c = getopt_long(argc, argv, short_options, long_options, &index);
494. if (-1 == c)
495. break ;
496. switch (c) {
497. case 0: /* getopt_long() flag */
498. break ;
499. case 'd' :
500. dev_name = optarg;
501. break ;
502. case 'h' :
503. usage(stdout, argc, argv);
504. exit(EXIT_SUCCESS);
505. case 'm' :
506. io = IO_METHOD_MMAP;
507. break ;
508. case 'r' :
509. io = IO_METHOD_READ;
510. break ;
511. case 'u' :
512. io = IO_METHOD_USERPTR;
513. break ;
514. default :
515. usage(stderr, argc, argv);
516. exit(EXIT_FAILURE);
517. }
518. }
519. open_device();
520. init_device();
521. start_capturing();
522. mainloop();
523. printf("/n" );
524. stop_capturing();
525. fclose(outf);
526. uninit_device();
527. close_device();
528. exit(EXIT_SUCCESS);
529. return 0;
530. }

(7) 最后还想多说两句，capture.c只是一个示例程序，仅仅是演示怎样使用v4l2中最基本的接口。尤其是在main函数中的那几个函数调用，表明了在 使用v4l2时的最基本的一个流程，包括 open_device，init_device，start_capturing，mainloop，stop_capturing，uninit_device，close_device。 在写程序的时候，可以充分的利用这几个基本模块，把他们分散在不同的代码位置上，灵活的调用，有兴趣的可以看一下gstreamer中v4l2src的源 代码或者其他的大型程序的相关部分。

总之一句话，capture.c仅仅是一个演示程序，不要局限于它的代码结构，要灵活的使用。