add video buffer support
[glsdk/omapdrmtest.git] / util / util.h
1 /*
2  * Copyright (C) 2011 Texas Instruments
3  * Author: Rob Clark <rob.clark@linaro.org>
4  *
5  * This program is free software; you can redistribute it and/or modify it
6  * under the terms of the GNU General Public License version 2 as published by
7  * the Free Software Foundation.
8  *
9  * This program is distributed in the hope that it will be useful, but WITHOUT
10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
12  * more details.
13  *
14  * You should have received a copy of the GNU General Public License along with
15  * this program.  If not, see <http://www.gnu.org/licenses/>.
16  */
18 #ifndef UTIL_H_
19 #define UTIL_H_
21 #include <stdio.h>
22 #include <stdint.h>
23 #include <stdlib.h>
24 #include <string.h>
25 #include <errno.h>
26 #include <unistd.h>
27 #include <assert.h>
29 #include <omap_drm.h>
30 #include <omap_drmif.h>
33 /* Display Interface:
34  *
35  * Could be either KMS or X11 depending on build and
36  * environment.  Some of details of opening/connecting, allocating buffers,
37  * etc, differ.  The intention is just to provide as simple as possible
38  * abstraction to avoid lots of duplication in each test app to handle
39  * both cases.
40  */
42 struct buffer {
43         uint32_t fourcc, width, height;
44         int nbo;
45         struct omap_bo *bo[4];
46         uint32_t pitches[4];
47 };
49 struct display {
50         int fd;
51         uint32_t width, height;
52         struct omap_device *dev;
54         struct buffer ** (*get_buffers)(struct display *disp, uint32_t n);
55         struct buffer ** (*get_vid_buffers)(struct display *disp,
56                         uint32_t n, uint32_t fourcc, uint32_t w, uint32_t h);
57         int (*post_buffer)(struct display *disp, struct buffer *buf);
58         int (*post_vid_buffer)(struct display *disp, struct buffer *buf,
59                         uint32_t x, uint32_t y, uint32_t w, uint32_t h);
60 };
62 /* Print display related help */
63 void disp_usage(void);
65 /* Open display.. X11 or KMS depending on cmdline args, environment,
66  * and build args
67  */
68 struct display * disp_open(int argc, char **argv);
70 /* Get normal RGB/UI buffers (ie. not scaled, not YUV) */
71 static inline struct buffer **
72 disp_get_buffers(struct display *disp, uint32_t n)
73 {
74         return disp->get_buffers(disp, n);
75 }
77 /* Get video/overlay buffers (ie. can be YUV, scaled, etc) */
78 static inline struct buffer **
79 disp_get_vid_buffers(struct display *disp, uint32_t n,
80                 uint32_t fourcc, uint32_t w, uint32_t h)
81 {
82         return disp->get_vid_buffers(disp, n, fourcc, w, h);
83 }
85 /* flip to / post the specified buffer */
86 static inline int
87 disp_post_buffer(struct display *disp, struct buffer *buf)
88 {
89         return disp->post_buffer(disp, buf);
90 }
92 /* flip to / post the specified video buffer */
93 static inline int
94 disp_post_vid_buffer(struct display *disp, struct buffer *buf,
95                 uint32_t x, uint32_t y, uint32_t w, uint32_t h)
96 {
97         return disp->post_vid_buffer(disp, buf, x, y, w, h);
98 }
100 /* helper to setup the display for apps that just need video with
101  * no flipchain on the GUI layer
102  */
103 struct buffer * disp_get_fb(struct display *disp);
106 /* V4L2 utilities:
107  */
109 struct v4l2;
111 /* Print v4l2 related help */
112 void v4l2_usage(void);
114 /* Open v4l2 (and media0??) XXX */
115 struct v4l2 * v4l2_open(int argc, char **argv, uint32_t *fourcc,
116                 uint32_t *width, uint32_t *height);
118 /* Share the buffers w/ v4l2 via dmabuf */
119 int v4l2_reqbufs(struct v4l2 *v4l2, struct buffer **bufs, uint32_t n);
121 int v4l2_streamon(struct v4l2 *v4l2);
122 int v4l2_streamoff(struct v4l2 *v4l2);
124 /* Queue a buffer to the camera */
125 int v4l2_qbuf(struct v4l2 *v4l2, struct buffer *buf);
127 /* Dequeue buffer from camera */
128 struct buffer * v4l2_dqbuf(struct v4l2 *v4l2);
130 /* Other utilities..
131  */
133 int check_args(int argc, char **argv);
135 void fill(struct buffer *buf, int i);
137 #define FOURCC(a, b, c, d) ((uint32_t)(uint8_t)(a) | ((uint32_t)(uint8_t)(b) << 8) | ((uint32_t)(uint8_t)(c) << 16) | ((uint32_t)(uint8_t)(d) << 24 ))
138 #define FOURCC_STR(str)    FOURCC(str[0], str[1], str[2], str[3])
140 #define MSG(fmt, ...) \
141                 do { fprintf(stderr, fmt "\n", ##__VA_ARGS__); } while (0)
142 #define ERROR(fmt, ...) \
143                 do { fprintf(stderr, "ERROR:%s:%d: " fmt "\n", __func__, __LINE__, ##__VA_ARGS__); } while (0)
145 #ifndef container_of
146 #define container_of(ptr, type, member) \
147     (type *)((char *)(ptr) - (char *) &((type *)0)->member)
148 #endif
150 typedef enum {
151         false = 0,
152         true = 1
153 } bool;
155 #endif /* UTIL_H_ */