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