1/**********************************************************
2 * Copyright 2009-2011 VMware, Inc. All rights reserved.
3 *
4 * Permission is hereby granted, free of charge, to any person
5 * obtaining a copy of this software and associated documentation
6 * files (the "Software"), to deal in the Software without
7 * restriction, including without limitation the rights to use, copy,
8 * modify, merge, publish, distribute, sublicense, and/or sell copies
9 * of the Software, and to permit persons to whom the Software is
10 * furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice shall be
13 * included in all copies or substantial portions of the Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
19 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
20 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
21 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 * SOFTWARE.
23 *
24 * The format encoding idea is partially borrowed from libpixman, but it is not
25 * considered a "substantial part of the software", so the pixman copyright
26 * is left out for simplicity, and acknowledgment is instead given in this way.
27 *
28 *********************************************************
29 * Authors:
30 * Zack Rusin <zackr-at-vmware-dot-com>
31 * Thomas Hellstrom <thellstrom-at-vmware-dot-com>
32 */
33
34#ifndef _XA_TRACKER_H_
35#define _XA_TRACKER_H_
36
37#include <stdint.h>
38
39#define XA_TRACKER_VERSION_MAJOR @XA_MAJOR@
40#define XA_TRACKER_VERSION_MINOR @XA_MINOR@
41#define XA_TRACKER_VERSION_PATCH @XA_PATCH@
42
43#define XA_FLAG_SHARED         (1 << 0)
44#define XA_FLAG_RENDER_TARGET  (1 << 1)
45#define XA_FLAG_SCANOUT        (1 << 2)
46
47#define XA_MAP_READ                     (1 << 0)
48#define XA_MAP_WRITE                    (1 << 1)
49#define XA_MAP_MAP_DIRECTLY             (1 << 2)
50#define XA_MAP_UNSYNCHRONIZED           (1 << 3)
51#define XA_MAP_DONTBLOCK                (1 << 4)
52#define XA_MAP_DISCARD_WHOLE_RESOURCE   (1 << 5)
53
54#define XA_ERR_NONE            0
55#define XA_ERR_NORES           1
56#define XA_ERR_INVAL           2
57#define XA_ERR_BUSY            3
58
59enum xa_surface_type {
60    xa_type_other,
61    xa_type_a,
62    xa_type_argb,
63    xa_type_abgr,
64    xa_type_bgra,
65    xa_type_z,
66    xa_type_zs,
67    xa_type_sz,
68    xa_type_yuv_component
69};
70
71/*
72 * Note that these formats should not be assumed to be binary compatible with
73 * pixman formats, but with the below macros and a format type map,
74 * conversion should be simple. Macros for now. We might replace with
75 * inline functions.
76 */
77
78#define xa_format(bpp,type,a,r,g,b)	(((bpp) << 24) |  \
79					 ((type) << 16) | \
80					 ((a) << 12) |	  \
81					 ((r) << 8) |	  \
82					 ((g) << 4) |	  \
83					 ((b)))
84/*
85 *  Non-RGBA one- and two component formats.
86 */
87
88#define xa_format_c(bpp,type,c1,c2) (((bpp) << 24) |	  \
89				     ((type) << 16) |	  \
90				     ((c1) << 8) |	  \
91				     ((c2)))
92#define xa_format_bpp(f)	(((f) >> 24)       )
93#define xa_format_type(f)	(((f) >> 16) & 0xff)
94#define xa_format_a(f)	(((f) >> 12) & 0x0f)
95#define xa_format_r(f)	(((f) >>  8) & 0x0f)
96#define xa_format_g(f)	(((f) >>  4) & 0x0f)
97#define xa_format_b(f)	(((f)      ) & 0x0f)
98#define xa_format_rgb(f)	(((f)      ) & 0xfff)
99#define xa_format_c1(f)          (((f) >> 8 ) & 0xff)
100#define xa_format_c2(f)          (((f)      ) & 0xff)
101#define xa_format_argb_depth(f)	(xa_format_a(f) +	\
102				 xa_format_r(f) +	\
103				 xa_format_g(f) +	\
104				 xa_format_b(f))
105#define xa_format_c_depth(f)    (xa_format_c1(f) + \
106				 xa_format_c2(f))
107
108static inline int
109xa_format_type_is_color(uint32_t xa_format)
110{
111    return (xa_format_type(xa_format) < xa_type_z);
112}
113
114static inline unsigned int
115xa_format_depth(uint32_t xa_format)
116{
117    return ((xa_format_type_is_color(xa_format)) ?
118	    xa_format_argb_depth(xa_format) : xa_format_c_depth(xa_format));
119}
120
121enum xa_formats {
122    xa_format_unknown = 0,
123    xa_format_a8 = xa_format(8, xa_type_a, 8, 0, 0, 0),
124
125    xa_format_a8r8g8b8 = xa_format(32, xa_type_argb, 8, 8, 8, 8),
126    xa_format_x8r8g8b8 = xa_format(32, xa_type_argb, 0, 8, 8, 8),
127    xa_format_r5g6b5 = xa_format(16, xa_type_argb, 0, 5, 6, 5),
128    xa_format_x1r5g5b5 = xa_format(16, xa_type_argb, 0, 5, 5, 5),
129    xa_format_a4r4g4b4 = xa_format(16, xa_type_argb, 4, 4, 4, 4),
130    xa_format_a2b10g10r10 = xa_format(32, xa_type_abgr, 2, 10, 10, 10),
131    xa_format_x2b10g10r10 = xa_format(32, xa_type_abgr, 0, 10, 10, 10),
132    xa_format_b8g8r8a8 = xa_format(32, xa_type_bgra, 8, 8, 8, 8),
133    xa_format_b8g8r8x8 = xa_format(32, xa_type_bgra, 0, 8, 8, 8),
134
135    xa_format_z16 = xa_format_c(16, xa_type_z, 16, 0),
136    xa_format_z32 = xa_format_c(32, xa_type_z, 32, 0),
137    xa_format_z24 = xa_format_c(32, xa_type_z, 24, 0),
138
139    xa_format_x8z24 = xa_format_c(32, xa_type_sz, 24, 0),
140    xa_format_s8z24 = xa_format_c(32, xa_type_sz, 24, 8),
141    xa_format_z24x8 = xa_format_c(32, xa_type_zs, 24, 0),
142    xa_format_z24s8 = xa_format_c(32, xa_type_zs, 24, 8),
143
144    xa_format_yuv8 = xa_format_c(8, xa_type_yuv_component, 8, 0)
145};
146
147struct xa_tracker;
148struct xa_surface;
149
150struct xa_box {
151    uint16_t x1, y1, x2, y2;
152};
153
154enum xa_handle_type {
155    xa_handle_type_shared,
156    xa_handle_type_kms,
157    xa_handle_type_fd,
158};
159
160extern void xa_tracker_version(int *major, int *minor, int *patch);
161
162extern struct xa_tracker *xa_tracker_create(int drm_fd);
163
164extern void xa_tracker_destroy(struct xa_tracker *xa);
165
166extern int xa_format_check_supported(struct xa_tracker *xa,
167				     enum xa_formats xa_format,
168				     unsigned int flags);
169
170extern struct xa_surface *xa_surface_create(struct xa_tracker *xa,
171					    int width,
172					    int height,
173					    int depth,
174					    enum xa_surface_type stype,
175					    enum xa_formats pform,
176					    unsigned int flags);
177
178extern struct xa_surface * xa_surface_from_handle(struct xa_tracker *xa,
179					    int width,
180					    int height,
181					    int depth,
182					    enum xa_surface_type stype,
183					    enum xa_formats pform,
184					    unsigned int flags,
185					    uint32_t handle, uint32_t stride);
186extern struct xa_surface *
187xa_surface_from_handle2(struct xa_tracker *xa,
188                        int width,
189                        int height,
190                        int depth,
191                        enum xa_surface_type stype,
192                        enum xa_formats xa_format,
193                        unsigned int flags,
194                        enum xa_handle_type type,
195                        uint32_t handle,
196                        uint32_t stride);
197
198enum xa_formats xa_surface_format(const struct xa_surface *srf);
199
200extern struct xa_surface *xa_surface_ref(struct xa_surface *srf);
201extern void xa_surface_unref(struct xa_surface *srf);
202
203extern int xa_surface_redefine(struct xa_surface *srf,
204			       int width,
205			       int height,
206			       int depth,
207			       enum xa_surface_type stype,
208			       enum xa_formats rgb_format,
209			       unsigned int new_flags,
210			       int copy_contents);
211
212extern int xa_surface_handle(struct xa_surface *srf,
213			     enum xa_handle_type type,
214			     uint32_t * handle,
215			     unsigned int *byte_stride);
216
217#endif
218