1 /**********************************************************
2 * Copyright 2009-2011 VMware, Inc. All rights reserved.
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:
12 * The above copyright notice and this permission notice shall be
13 * included in all copies or substantial portions of the Software.
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
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.
28 *********************************************************
30 * Zack Rusin <zackr-at-vmware-dot-com>
31 * Thomas Hellstrom <thellstrom-at-vmware-dot-com>
34 #ifndef _XA_TRACKER_H_
35 #define _XA_TRACKER_H_
39 #define XA_TRACKER_VERSION_MAJOR 2
40 #define XA_TRACKER_VERSION_MINOR 2
41 #define XA_TRACKER_VERSION_PATCH 0
43 #define XA_FLAG_SHARED (1 << 0)
44 #define XA_FLAG_RENDER_TARGET (1 << 1)
45 #define XA_FLAG_SCANOUT (1 << 2)
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)
55 #define XA_ERR_NORES 1
56 #define XA_ERR_INVAL 2
59 enum xa_surface_type
{
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
78 #define xa_format(bpp,type,a,r,g,b) (((bpp) << 24) | \
85 * Non-RGBA one- and two component formats.
88 #define xa_format_c(bpp,type,c1,c2) (((bpp) << 24) | \
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) + \
105 #define xa_format_c_depth(f) (xa_format_c1(f) + \
109 xa_format_type_is_color(uint32_t xa_format
)
111 return (xa_format_type(xa_format
) < xa_type_z
);
114 static inline unsigned int
115 xa_format_depth(uint32_t xa_format
)
117 return ((xa_format_type_is_color(xa_format
)) ?
118 xa_format_argb_depth(xa_format
) : xa_format_c_depth(xa_format
));
122 xa_format_unknown
= 0,
123 xa_format_a8
= xa_format(8, xa_type_a
, 8, 0, 0, 0),
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),
130 xa_format_z16
= xa_format_c(16, xa_type_z
, 16, 0),
131 xa_format_z32
= xa_format_c(32, xa_type_z
, 32, 0),
132 xa_format_z24
= xa_format_c(32, xa_type_z
, 24, 0),
134 xa_format_x8z24
= xa_format_c(32, xa_type_sz
, 24, 0),
135 xa_format_s8z24
= xa_format_c(32, xa_type_sz
, 24, 8),
136 xa_format_z24x8
= xa_format_c(32, xa_type_zs
, 24, 0),
137 xa_format_z24s8
= xa_format_c(32, xa_type_zs
, 24, 8),
139 xa_format_yuv8
= xa_format_c(8, xa_type_yuv_component
, 8, 0)
146 uint16_t x1
, y1
, x2
, y2
;
149 enum xa_handle_type
{
150 xa_handle_type_shared
,
154 extern void xa_tracker_version(int *major
, int *minor
, int *patch
);
156 extern struct xa_tracker
*xa_tracker_create(int drm_fd
);
158 extern void xa_tracker_destroy(struct xa_tracker
*xa
);
160 extern int xa_format_check_supported(struct xa_tracker
*xa
,
161 enum xa_formats xa_format
,
164 extern struct xa_surface
*xa_surface_create(struct xa_tracker
*xa
,
168 enum xa_surface_type stype
,
169 enum xa_formats pform
,
172 extern struct xa_surface
* xa_surface_from_handle(struct xa_tracker
*xa
,
176 enum xa_surface_type stype
,
177 enum xa_formats pform
,
179 uint32_t handle
, uint32_t stride
);
181 enum xa_formats
xa_surface_format(const struct xa_surface
*srf
);
183 extern struct xa_surface
*xa_surface_ref(struct xa_surface
*srf
);
184 extern void xa_surface_unref(struct xa_surface
*srf
);
186 extern int xa_surface_redefine(struct xa_surface
*srf
,
190 enum xa_surface_type stype
,
191 enum xa_formats rgb_format
,
192 unsigned int new_flags
,
195 extern int xa_surface_handle(struct xa_surface
*srf
,
196 enum xa_handle_type type
,
198 unsigned int *byte_stride
);