|
1 /* |
|
2 Public ivtv API header |
|
3 Copyright (C) 2003-2004 Kevin Thayer <nufan_wfk at yahoo.com> |
|
4 Copyright (C) 2004-2007 Hans Verkuil <hverkuil@xs4all.nl> |
|
5 |
|
6 This program is free software; you can redistribute it and/or modify |
|
7 it under the terms of the GNU General Public License as published by |
|
8 the Free Software Foundation; either version 2 of the License, or |
|
9 (at your option) any later version. |
|
10 |
|
11 This program is distributed in the hope that it will be useful, |
|
12 but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|
14 GNU General Public License for more details. |
|
15 |
|
16 You should have received a copy of the GNU General Public License |
|
17 along with this program; if not, write to the Free Software |
|
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
|
19 */ |
|
20 |
|
21 #ifndef __LINUX_IVTV_H__ |
|
22 #define __LINUX_IVTV_H__ |
|
23 |
|
24 #include <linux/compiler.h> |
|
25 #include <linux/types.h> |
|
26 #include <linux/videodev2.h> |
|
27 |
|
28 /* ivtv knows several distinct output modes: MPEG streaming, |
|
29 YUV streaming, YUV updates through user DMA and the passthrough |
|
30 mode. |
|
31 |
|
32 In order to clearly tell the driver that we are in user DMA |
|
33 YUV mode you need to call IVTV_IOC_DMA_FRAME with y_source == NULL |
|
34 first (althrough if you don't then the first time |
|
35 DMA_FRAME is called the mode switch is done automatically). |
|
36 |
|
37 When you close the file handle the user DMA mode is exited again. |
|
38 |
|
39 While in one mode, you cannot use another mode (EBUSY is returned). |
|
40 |
|
41 All this means that if you want to change the YUV interlacing |
|
42 for the user DMA YUV mode you first need to do call IVTV_IOC_DMA_FRAME |
|
43 with y_source == NULL before you can set the correct format using |
|
44 VIDIOC_S_FMT. |
|
45 |
|
46 Eventually all this should be replaced with a proper V4L2 API, |
|
47 but for now we have to do it this way. */ |
|
48 |
|
49 struct ivtv_dma_frame { |
|
50 enum v4l2_buf_type type; /* V4L2_BUF_TYPE_VIDEO_OUTPUT */ |
|
51 __u32 pixelformat; /* 0 == same as destination */ |
|
52 void __user *y_source; /* if NULL and type == V4L2_BUF_TYPE_VIDEO_OUTPUT, |
|
53 then just switch to user DMA YUV output mode */ |
|
54 void __user *uv_source; /* Unused for RGB pixelformats */ |
|
55 struct v4l2_rect src; |
|
56 struct v4l2_rect dst; |
|
57 __u32 src_width; |
|
58 __u32 src_height; |
|
59 }; |
|
60 |
|
61 #define IVTV_IOC_DMA_FRAME _IOW ('V', BASE_VIDIOC_PRIVATE+0, struct ivtv_dma_frame) |
|
62 |
|
63 /* These are the VBI types as they appear in the embedded VBI private packets. */ |
|
64 #define IVTV_SLICED_TYPE_TELETEXT_B (1) |
|
65 #define IVTV_SLICED_TYPE_CAPTION_525 (4) |
|
66 #define IVTV_SLICED_TYPE_WSS_625 (5) |
|
67 #define IVTV_SLICED_TYPE_VPS (7) |
|
68 |
|
69 #endif /* _LINUX_IVTV_H */ |