|
3991
|
1 /*
|
|
|
2 * vidix.h
|
|
|
3 * VIDIX - VIDeo Interface for *niX
|
|
|
4 * This interface is introduced as universal one to MPEG decoder,
|
|
|
5 * BES == Back End Scaler and YUV2RGB hw accelerators.
|
|
|
6 * In the future it may be expanded up to capturing and audio things.
|
|
|
7 * Main goal of this this interface imlpementation is providing DGA
|
|
|
8 * everywhere where it's possible (unlike X11 and other).
|
|
|
9 * Copyright 2002 Nick Kurshev
|
|
|
10 * Licence: GPL
|
|
|
11 * This interface is based on v4l2, fbvid.h, mga_vid.h projects
|
|
|
12 * and personally my ideas.
|
|
|
13 * NOTE: This interface is introduces as driver interface.
|
|
|
14 * Don't use it for APP.
|
|
|
15 */
|
|
|
16 #ifndef VIDIX_H
|
|
|
17 #define VIDIX_H
|
|
|
18
|
|
|
19 #ifdef __cplusplus
|
|
|
20 extern "C" {
|
|
|
21 #endif
|
|
|
22
|
|
|
23 #define VIDIX_VERSION 100
|
|
|
24
|
|
|
25 /* returns driver version */
|
|
|
26 extern unsigned vixGetVersion( void );
|
|
|
27
|
|
4191
|
28 #define PROBE_NORMAL 0 /* normal probing */
|
|
|
29 #define PROBE_FORCE 1 /* ignore device_id but recognize device if it's known */
|
|
|
30 /* Probes video hw.
|
|
|
31 verbose - specifies verbose level.
|
|
|
32 force - specifies force mode - driver should ignore
|
|
|
33 device_id (danger but useful for new devices)
|
|
|
34 Returns 0 if ok else errno */
|
|
|
35 extern int vixProbe( int verbose, int force );
|
|
3991
|
36 /* Initializes driver. Returns 0 if ok else errno */
|
|
|
37 extern int vixInit( void );
|
|
|
38 /* Destroys driver */
|
|
|
39 extern void vixDestroy( void );
|
|
|
40
|
|
|
41 typedef struct vidix_capability_s
|
|
|
42 {
|
4323
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
43 char name[64]; /* Driver name */
|
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
44 char author[64]; /* Author name */
|
|
4191
|
45 #define TYPE_OUTPUT 0x00000000 /* Is a video playback device */
|
|
|
46 #define TYPE_CAPTURE 0x00000001 /* Is a capture device */
|
|
|
47 #define TYPE_CODEC 0x00000002 /* Device supports hw (de)coding */
|
|
3991
|
48 #define TYPE_FX 0x00000004 /* Is a video effects device */
|
|
|
49 int type; /* Device type, see below */
|
|
4191
|
50 unsigned reserved0[4];
|
|
3991
|
51 int maxwidth;
|
|
|
52 int maxheight;
|
|
|
53 int minwidth;
|
|
|
54 int minheight;
|
|
|
55 int maxframerate; /* -1 if unlimited */
|
|
|
56 #define FLAG_NONE 0x00000000 /* No flags defined */
|
|
|
57 #define FLAG_DMA 0x00000001 /* Card can use DMA */
|
|
4191
|
58 #define FLAG_EQ_DMA 0x00000002 /* Card can use DMA only if src pitch == dest pitch */
|
|
3991
|
59 #define FLAG_UPSCALER 0x00000010 /* Card supports hw upscaling */
|
|
|
60 #define FLAG_DOWNSCALER 0x00000020 /* Card supports hw downscaling */
|
|
|
61 #define FLAG_SUBPIC 0x00001000 /* Card supports DVD subpictures */
|
|
4263
|
62 #define FLAG_EQUALIZER 0x00002000 /* Card supports equalizer */
|
|
4191
|
63 unsigned flags; /* Feature flags, see above */
|
|
3991
|
64 unsigned short vendor_id;
|
|
|
65 unsigned short device_id;
|
4323
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
66 unsigned reserved1[4];
|
|
3991
|
67 }vidix_capability_t;
|
|
|
68
|
|
|
69 /* Should fill at least type before init.
|
|
|
70 Returns 0 if ok else errno */
|
|
|
71 extern int vixGetCapability(vidix_capability_t *);
|
|
|
72
|
|
|
73 typedef struct vidix_fourcc_s
|
|
|
74 {
|
|
|
75 unsigned fourcc;
|
|
|
76 #define VID_DEPTH_NONE 0x0000
|
|
|
77 #define VID_DEPTH_1BPP 0x0001
|
|
|
78 #define VID_DEPTH_2BPP 0x0002
|
|
|
79 #define VID_DEPTH_4BPP 0x0004
|
|
|
80 #define VID_DEPTH_8BPP 0x0008
|
|
|
81 #define VID_DEPTH_12BPP 0x0010
|
|
|
82 #define VID_DEPTH_15BPP 0x0020
|
|
|
83 #define VID_DEPTH_16BPP 0x0040
|
|
|
84 #define VID_DEPTH_24BPP 0x0080
|
|
|
85 #define VID_DEPTH_32BPP 0x0100
|
|
|
86 unsigned depth;
|
|
|
87 #define VID_CAP_NONE 0x0000
|
|
|
88 #define VID_CAP_EXPAND 0x0001 /* if overlay can be bigger than source */
|
|
|
89 #define VID_CAP_SHRINK 0x0002 /* if overlay can be smaller than source */
|
|
|
90 #define VID_CAP_BLEND 0x0004 /* if overlay can be blended with framebuffer */
|
|
|
91 #define VID_CAP_COLORKEY 0x0008 /* if overlay can be restricted to a colorkey */
|
|
|
92 #define VID_CAP_ALPHAKEY 0x0010 /* if overlay can be restricted to an alpha channel */
|
|
|
93 #define VID_CAP_COLORKEY_ISRANGE 0x0020 /* if the colorkey can be a range */
|
|
|
94 #define VID_CAP_ALPHAKEY_ISRANGE 0x0040 /* if the alphakey can be a range */
|
|
|
95 #define VID_CAP_COLORKEY_ISMAIN 0x0080 /* colorkey is checked against framebuffer */
|
|
|
96 #define VID_CAP_COLORKEY_ISOVERLAY 0x0100 /* colorkey is checked against overlay */
|
|
|
97 #define VID_CAP_ALPHAKEY_ISMAIN 0x0200 /* alphakey is checked against framebuffer */
|
|
|
98 #define VID_CAP_ALPHAKEY_ISOVERLAY 0x0400 /* alphakey is checked against overlay */
|
|
|
99 unsigned flags;
|
|
|
100 }vidix_fourcc_t;
|
|
|
101
|
|
|
102 /* Returns 0 if ok else errno */
|
|
|
103 extern int vixQueryFourcc(vidix_fourcc_t *);
|
|
|
104
|
|
|
105 typedef struct vidix_yuv_s
|
|
|
106 {
|
|
|
107 unsigned y,u,v;
|
|
|
108 }vidix_yuv_t;
|
|
|
109
|
|
|
110 typedef struct vidix_rect_s
|
|
|
111 {
|
|
|
112 unsigned x,y,w,h; /* in pixels */
|
|
4008
|
113 vidix_yuv_t pitch; /* line-align in bytes */
|
|
3991
|
114 }vidix_rect_t;
|
|
|
115
|
|
|
116 typedef struct vidix_color_key_s
|
|
|
117 {
|
|
|
118 #define CKEY_FALSE 0
|
|
|
119 #define CKEY_TRUE 1
|
|
|
120 #define CKEY_EQ 2
|
|
|
121 #define CKEY_NEQ 3
|
|
|
122 unsigned op; /* defines logical operation */
|
|
|
123 unsigned char red;
|
|
|
124 unsigned char green;
|
|
|
125 unsigned char blue;
|
|
|
126 unsigned char reserved;
|
|
|
127 }vidix_ckey_t;
|
|
|
128
|
|
|
129 typedef struct vidix_video_key_s
|
|
|
130 {
|
|
|
131 #define VKEY_FALSE 0
|
|
|
132 #define VKEY_TRUE 1
|
|
|
133 #define VKEY_EQ 2
|
|
|
134 #define VKEY_NEQ 3
|
|
|
135 unsigned op; /* defines logical operation */
|
|
|
136 unsigned char key[8];
|
|
|
137 }vidix_vkey_t;
|
|
|
138
|
|
|
139 typedef struct vidix_playback_s
|
|
|
140 {
|
|
|
141 unsigned fourcc; /* app -> driver: movies's fourcc */
|
|
|
142 unsigned capability; /* app -> driver: what capability to use */
|
4323
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
143 unsigned blend_factor; /* app -> driver: blending factor */
|
|
3991
|
144 vidix_rect_t src; /* app -> driver: original movie size */
|
|
|
145 vidix_rect_t dest; /* app -> driver: destinition movie size. driver->app dest_pitch */
|
4323
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
146 #define VID_PLAY_INTERLEAVED_UV 0x00000001 /* driver -> app: interleaved UV planes */
|
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
147 #define INTERLEAVING_UV 0x00001000 /* UVUVUVUVUV used by Matrox G200 */
|
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
148 #define INTERLEAVING_VU 0x00001001 /* VUVUVUVUVU */
|
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
149 int flags;
|
|
3995
|
150 /* memory model */
|
4323
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
151 unsigned frame_size; /* driver -> app: destinition frame size */
|
|
4191
|
152 unsigned num_frames; /* app -> driver: after call: driver -> app */
|
|
4929
|
153 #define VID_PLAY_MAXFRAMES 64 /* reasonable limitation for decoding ahead */
|
4323
fa8ba116a716
some typos fixed ;), added author to capabilites and extended name to 64 bytes. added interleaved uv planes support
alex
diff
changeset
|
154 unsigned offsets[VID_PLAY_MAXFRAMES]; /* driver -> app */
|
|
3991
|
155 vidix_yuv_t offset; /* driver -> app: relative offsets within frame for yuv planes */
|
|
|
156 void* dga_addr; /* driver -> app: linear address */
|
|
3995
|
157 }vidix_playback_t;
|
|
3991
|
158
|
|
|
159 /* Returns 0 if ok else errno */
|
|
3995
|
160 extern int vixConfigPlayback(vidix_playback_t *);
|
|
3991
|
161
|
|
|
162 /* Returns 0 if ok else errno */
|
|
|
163 extern int vixPlaybackOn( void );
|
|
|
164
|
|
|
165 /* Returns 0 if ok else errno */
|
|
|
166 extern int vixPlaybackOff( void );
|
|
|
167
|
|
|
168 /* Returns 0 if ok else errno */
|
|
|
169 extern int vixPlaybackFrameSelect( unsigned frame_idx );
|
|
|
170
|
|
4070
|
171 typedef struct vidix_grkey_s
|
|
|
172 {
|
|
|
173 vidix_ckey_t ckey; /* app -> driver: color key */
|
|
|
174 vidix_vkey_t vkey; /* app -> driver: video key */
|
|
|
175 #define KEYS_PUT 0
|
|
|
176 #define KEYS_AND 1
|
|
|
177 #define KEYS_OR 2
|
|
|
178 #define KEYS_XOR 3
|
|
|
179 unsigned key_op; /* app -> driver: keys operations */
|
|
|
180 }vidix_grkey_t;
|
|
|
181
|
|
|
182 /* Returns 0 if ok else errno */
|
|
|
183 extern int vixGetGrKeys( vidix_grkey_t * );
|
|
|
184
|
|
|
185 /* Returns 0 if ok else errno */
|
|
|
186 extern int vixSetGrKeys( const vidix_grkey_t * );
|
|
|
187
|
|
|
188
|
|
3991
|
189 typedef struct vidix_video_eq_s
|
|
|
190 {
|
|
4318
|
191 #define VEQ_CAP_NONE 0x00000000UL
|
|
|
192 #define VEQ_CAP_BRIGHTNESS 0x00000001UL
|
|
|
193 #define VEQ_CAP_CONTRAST 0x00000002UL
|
|
|
194 #define VEQ_CAP_SATURATION 0x00000004UL
|
|
|
195 #define VEQ_CAP_HUE 0x00000008UL
|
|
|
196 #define VEQ_CAP_RGB_INTENSITY 0x00000010UL
|
|
|
197 int cap; /* on get_eq should contain capability of equalizer
|
|
|
198 on set_eq should contain using fields */
|
|
3991
|
199 /* end-user app can have presets like: cold-normal-hot picture and so on */
|
|
|
200 int brightness; /* -1000 : +1000 */
|
|
|
201 int contrast; /* -1000 : +1000 */
|
|
|
202 int saturation; /* -1000 : +1000 */
|
|
|
203 int hue; /* -1000 : +1000 */
|
|
4318
|
204 int red_intensity; /* -1000 : +1000 */
|
|
|
205 int green_intensity;/* -1000 : +1000 */
|
|
|
206 int blue_intensity; /* -1000 : +1000 */
|
|
4191
|
207 #define VEQ_FLG_ITU_R_BT_601 0x00000000 /* ITU-R BT.601 colour space (default) */
|
|
|
208 #define VEQ_FLG_ITU_R_BT_709 0x00000001 /* ITU-R BT.709 colour space */
|
|
|
209 #define VEQ_FLG_ITU_MASK 0x0000000f
|
|
|
210 int flags; /* currently specifies ITU YCrCb color space to use */
|
|
3991
|
211 }vidix_video_eq_t;
|
|
|
212
|
|
|
213 /* Returns 0 if ok else errno */
|
|
|
214 extern int vixPlaybackGetEq( vidix_video_eq_t * );
|
|
|
215
|
|
|
216 /* Returns 0 if ok else errno */
|
|
|
217 extern int vixPlaybackSetEq( const vidix_video_eq_t * );
|
|
|
218
|
|
4191
|
219 typedef struct vidix_deinterlace_s
|
|
|
220 {
|
|
|
221 #define CFG_NON_INTERLACED 0x00000000 /* stream is not interlaced */
|
|
|
222 #define CFG_INTERLACED 0x00000001 /* stream is interlaced */
|
|
|
223 #define CFG_EVEN_ODD_INTERLACING 0x00000002 /* first frame contains even fields but second - odd */
|
|
|
224 #define CFG_ODD_EVEN_INTERLACING 0x00000004 /* first frame contains odd fields but second - even */
|
|
|
225 #define CFG_UNIQUE_INTERLACING 0x00000008 /* field deinterlace_pattern is valid */
|
|
|
226 #define CFG_UNKNOWN_INTERLACING 0x0000000f /* unknown deinterlacing - use adaptive if it's possible */
|
|
|
227 unsigned flags;
|
|
|
228 unsigned deinterlace_pattern; /* app -> driver: deinterlace pattern if flag CFG_UNIQUE_INTERLACING is set */
|
|
|
229 }vidix_deinterlace_t;
|
|
|
230
|
|
|
231 /* Returns 0 if ok else errno */
|
|
|
232 extern int vixPlaybackGetDeint( vidix_deinterlace_t * );
|
|
|
233
|
|
|
234 /* Returns 0 if ok else errno */
|
|
|
235 extern int vixPlaybackSetDeint( const vidix_deinterlace_t * );
|
|
|
236
|
|
3991
|
237 typedef struct vidix_slice_s
|
|
|
238 {
|
|
|
239 void* address; /* app -> driver */
|
|
|
240 unsigned size; /* app -> driver */
|
|
|
241 vidix_rect_t slice; /* app -> driver */
|
|
|
242 }vidix_slice_t;
|
|
|
243
|
|
|
244 typedef struct vidix_dma_s
|
|
|
245 {
|
|
|
246 vidix_slice_t src; /* app -> driver */
|
|
|
247 vidix_slice_t dest; /* app -> driver */
|
|
|
248 #define LVO_DMA_NOSYNC 0
|
|
|
249 #define LVO_DMA_SYNC 1 /* means: wait vsync or hsync */
|
|
|
250 unsigned flags; /* app -> driver */
|
|
|
251 }vidix_dma_t;
|
|
|
252
|
|
|
253 /* Returns 0 if ok else errno */
|
|
|
254 extern int vixPlaybackCopyFrame( const vidix_dma_t * );
|
|
|
255
|
|
4191
|
256 /*
|
|
|
257 This structure is introdused to support OEM effects like:
|
|
|
258 - sharpness
|
|
|
259 - exposure
|
|
|
260 - (auto)gain
|
|
|
261 - H(V)flip
|
|
|
262 - black level
|
|
|
263 - white balance
|
|
|
264 and many other
|
|
|
265 */
|
|
|
266 typedef struct vidix_oem_fx_s
|
|
|
267 {
|
|
|
268 #define FX_TYPE_BOOLEAN 0x00000000
|
|
|
269 #define FX_TYPE_INTEGER 0x00000001
|
|
|
270 int type; /* type of effects */
|
|
|
271 int num; /* app -> driver: effect number. From 0 to max number of effects */
|
|
|
272 int minvalue; /* min value of effect. 0 - for boolean */
|
|
|
273 int maxvalue; /* max value of effect. 1 - for boolean */
|
|
|
274 int value; /* current value of effect on 'get'; required on set */
|
|
|
275 char * name[80]; /* effect name to display */
|
|
|
276 }vidix_oem_fx_t;
|
|
|
277
|
|
|
278 /* Returns 0 if ok else errno */
|
|
|
279 extern int vixQueryNumOemEffects( unsigned * number );
|
|
|
280
|
|
|
281 /* Returns 0 if ok else errno */
|
|
|
282 extern int vixGetOemEffect( vidix_oem_fx_t * );
|
|
|
283
|
|
|
284 /* Returns 0 if ok else errno */
|
|
|
285 extern int vixSetOemEffect( const vidix_oem_fx_t * );
|
|
|
286
|
|
3991
|
287 #ifdef __cplusplus
|
|
|
288 }
|
|
|
289 #endif
|
|
|
290
|
|
|
291 #endif
|
