We are currently experiencing downtime impacting viewing & cloning the Mesa repo, and some GitLab pages returning 503. Please see #freedesktop on IRC for more updates.

glamor.h 9.41 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
/*
 * Copyright © 2008 Intel Corporation
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
 * IN THE SOFTWARE.
 *
 * Authors:
 *    Eric Anholt <eric@anholt.net>
 *
 */
Eric Anholt's avatar
Eric Anholt committed
27 28 29 30 31

#ifndef GLAMOR_H
#define GLAMOR_H

#include "scrnintstr.h"
32
#ifdef GLAMOR_FOR_XORG
33
#include "xf86str.h"
34
#endif
Eric Anholt's avatar
Eric Anholt committed
35 36 37 38 39
#include "pixmapstr.h"
#include "windowstr.h"
#include "gcstruct.h"
#include "picturestr.h"
#include "fb.h"
40
#include "fbpict.h"
Eric Anholt's avatar
Eric Anholt committed
41

Zhigang Gong's avatar
Zhigang Gong committed
42
#endif				/* GLAMOR_H */
Eric Anholt's avatar
Eric Anholt committed
43

44 45 46 47 48
/* @GLAMOR_INVERTED_Y_AXIS:
 * set 1 means the GL env's origin (0,0) is at top-left. 
 * EGL/DRM platform is an example need to set this bit.
 * glx platform's origin is at bottom-left thus need to
 * clear this bit.*/
49

Zhigang Gong's avatar
Zhigang Gong committed
50
#define GLAMOR_INVERTED_Y_AXIS  	1
51 52 53 54 55 56 57 58 59

/* @GLAMOR_USE_SCREEN:
 * If want to let glamor to do everything including the
 * create/destroy pixmap and handle the gc ops. need to
 * set this bit. Standalone glamor DDX driver need to set
 * this bit.
 * Otherwise, need to clear this bit, as the intel video 
 * driver with glamor enabled.
 * */
Zhigang Gong's avatar
Zhigang Gong committed
60
#define GLAMOR_USE_SCREEN		2
61 62 63 64 65 66 67
/* @GLAMOR_USE_PICTURE_SCREEN:
 * If want to let glamor to do all the composition related
 * things, need to set this bit. Just as standalone glamor
 * DDX driver.
 * Otherwise, need to clear this bit, as the intel video
 * driver with glamor enabled.
 */
Zhigang Gong's avatar
Zhigang Gong committed
68 69 70 71 72
#define GLAMOR_USE_PICTURE_SCREEN 	4

#define GLAMOR_VALID_FLAGS      (GLAMOR_INVERTED_Y_AXIS  		\
				 | GLAMOR_USE_SCREEN 			\
                                 | GLAMOR_USE_PICTURE_SCREEN)
73

74 75 76 77
/*
 * glamor_pixmap_type : glamor pixmap's type.
 * @MEMORY: pixmap is in memory.
 * @TEXTURE_DRM: pixmap is in a texture created from a DRM buffer.
78 79 80
 * @SEPARATE_TEXTURE: The texture is created from a DRM buffer, but
 * 		      the format is incompatible, so this type of pixmap
 * 		      will never fallback to DDX layer.
81 82 83 84 85 86
 * @DRM_ONLY: pixmap is in a external DRM buffer.
 * @TEXTURE_ONLY: pixmap is in an internal texture.
 */
typedef enum  glamor_pixmap_type {
	GLAMOR_MEMORY,
	GLAMOR_TEXTURE_DRM,
87
	GLAMOR_SEPARATE_TEXTURE,
88 89 90 91
	GLAMOR_DRM_ONLY,
	GLAMOR_TEXTURE_ONLY
} glamor_pixmap_type_t;

92
#define GLAMOR_EGL_EXTERNAL_BUFFER 3
93 94 95 96 97 98 99 100 101 102
/* @glamor_init: Initialize glamor internal data structure.
 *
 * @screen: Current screen pointer.
 * @flags:  Please refer the flags description above.
 *
 * This function initializes necessary internal data structure
 * for glamor. And before calling into this function, the OpenGL
 * environment should be ready. Should be called before any real 
 * glamor rendering or texture allocation functions. 
 */
103 104
extern _X_EXPORT Bool glamor_init(ScreenPtr screen, unsigned int flags);
extern _X_EXPORT void glamor_fini(ScreenPtr screen);
Zhigang Gong's avatar
Zhigang Gong committed
105 106 107
extern _X_EXPORT void glamor_set_screen_pixmap_texture(ScreenPtr screen,
						       int w, int h,
						       unsigned int tex);
108 109 110 111 112 113 114 115
/* @glamor_glyphs_init: Initialize glyphs internal data structures.
 *
 * @pScreen: Current screen pointer.
 *
 * This function must be called after the glamor_init and the texture
 * can be allocated. An example is to call it when create the screen
 * resources at DDX layer.
 */
Zhigang Gong's avatar
Zhigang Gong committed
116 117
extern _X_EXPORT Bool glamor_glyphs_init(ScreenPtr pScreen);

118 119 120 121
extern _X_EXPORT void glamor_set_pixmap_texture(PixmapPtr pixmap, int w, int h,
						unsigned int tex);

extern _X_EXPORT void glamor_set_pixmap_type(PixmapPtr pixmap, glamor_pixmap_type_t type);
Zhigang Gong's avatar
Zhigang Gong committed
122 123
extern _X_EXPORT void glamor_destroy_textured_pixmap(PixmapPtr pixmap);
extern _X_EXPORT void glamor_block_handler(ScreenPtr screen);
124 125
extern _X_EXPORT PixmapPtr glamor_create_pixmap(ScreenPtr screen, int w, int h, int depth,
						unsigned int usage);
126

127
#ifdef GLAMOR_FOR_XORG
128 129 130 131 132 133 134 135 136
/* @glamor_egl_init: Initialize EGL environment.
 *
 * @scrn: Current screen info pointer.
 * @fd:   Current drm fd.
 *
 * This function creates and intialize EGL contexts. 
 * Should be called from DDX's preInit function.
 * Return TRUE if success, otherwise return FALSE.
 * */
137
extern _X_EXPORT Bool glamor_egl_init(ScrnInfoPtr scrn, int fd);
138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157

/* @glamor_egl_init_textured_pixmap: Initialization for textured pixmap allocation.
 *
 * @screen: Current screen pointer.
 *
 * This function must be called before any textured pixmap's creation including
 * the screen pixmap. Could be called from DDX's screenInit function after the calling
 * to glamor_init..
 */
extern _X_EXPORT Bool glamor_egl_init_textured_pixmap(ScreenPtr screen);

/* @glamor_egl_create_textured_screen: Create textured screen pixmap.
 *
 * @screen: screen pointer to be processed.
 * @handle: screen pixmap's BO handle.
 * @stride: screen pixmap's stride in bytes.
 *
 * This function is similar with the create_textured_pixmap. As the
 * screen pixmap is a special, we handle it separately in this function.
 */
Zhigang Gong's avatar
Zhigang Gong committed
158 159 160
extern _X_EXPORT Bool glamor_egl_create_textured_screen(ScreenPtr screen,
							int handle,
							int stride);
161 162 163 164 165 166 167 168 169 170 171 172 173

/*
 * @glamor_egl_create_textured_pixmap: Try to create a textured pixmap from
 * 				       a BO handle.
 * 
 * @pixmap: The pixmap need to be processed.
 * @handle: The BO's handle attached to this pixmap at DDX layer.
 * @stride: Stride in bytes for this pixmap.
 *
 * This function try to create a texture from the handle and attach
 * the texture to the pixmap , thus glamor can render to this pixmap
 * as well. Return true if successful, otherwise return FALSE.
 */
Zhigang Gong's avatar
Zhigang Gong committed
174 175 176 177
extern _X_EXPORT Bool glamor_egl_create_textured_pixmap(PixmapPtr pixmap,
							int handle,
							int stride);

178 179
extern _X_EXPORT void glamor_egl_destroy_textured_pixmap(PixmapPtr pixmap);

Zhigang Gong's avatar
Zhigang Gong committed
180 181 182
extern _X_EXPORT Bool glamor_egl_close_screen(ScreenPtr screen);
extern _X_EXPORT void glamor_egl_free_screen(int scrnIndex, int flags);

183
#endif
184

Zhigang Gong's avatar
Zhigang Gong committed
185
extern _X_EXPORT int glamor_create_gc(GCPtr gc);
186 187

extern _X_EXPORT void glamor_validate_gc(GCPtr gc, unsigned long changes, DrawablePtr drawable);
188 189 190 191 192
/* Glamor rendering/drawing functions with XXX_nf. 
 * nf means no fallback within glamor internal if possible. If glamor
 * fail to accelerate the operation, glamor will return a false, and the
 * caller need to implement fallback method. Return a true means the
 * rendering request get done successfully. */
193 194 195 196 197
extern _X_EXPORT Bool glamor_fill_spans_nf(DrawablePtr drawable,
					   GCPtr gc,
					   int n, DDXPointPtr points, 
					   int *widths, int sorted);

198 199 200 201
extern _X_EXPORT Bool glamor_poly_fill_rect_nf(DrawablePtr drawable,
					       GCPtr gc, 
					       int nrect, 
					       xRectangle * prect);
202

203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253
extern _X_EXPORT Bool glamor_put_image_nf(DrawablePtr drawable, 
					  GCPtr gc, int depth, int x, int y,
		 	 		  int w, int h, int left_pad, 
					  int image_format, char *bits);

extern _X_EXPORT Bool glamor_copy_n_to_n_nf(DrawablePtr src,
					    DrawablePtr dst,
					    GCPtr gc,
					    BoxPtr box,
					    int nbox,
					    int dx,
					    int dy,
					    Bool reverse,
					    Bool upsidedown, Pixel bitplane, 
					    void *closure);

extern _X_EXPORT Bool glamor_composite_nf(CARD8 op,
					  PicturePtr source,
					  PicturePtr mask,
					  PicturePtr dest,
					  INT16 x_source,
					  INT16 y_source,
					  INT16 x_mask,
					  INT16 y_mask,
					  INT16 x_dest, INT16 y_dest, 
					  CARD16 width, CARD16 height);

extern _X_EXPORT Bool glamor_trapezoids_nf(CARD8 op,
					   PicturePtr src, PicturePtr dst,
					   PictFormatPtr mask_format, 
					   INT16 x_src, INT16 y_src,
					   int ntrap, xTrapezoid * traps);

extern _X_EXPORT Bool glamor_glyphs_nf(CARD8 op,
				       PicturePtr src,
				       PicturePtr dst,
				       PictFormatPtr mask_format,
				       INT16 x_src,
				       INT16 y_src, int nlist, 
				       GlyphListPtr list, GlyphPtr * glyphs);

extern _X_EXPORT Bool glamor_triangles_nf(CARD8 op,
					  PicturePtr pSrc,
					  PicturePtr pDst,
					  PictFormatPtr maskFormat,
					  INT16 xSrc, INT16 ySrc, 
					  int ntris, xTriangle * tris);


extern _X_EXPORT void glamor_glyph_unrealize(ScreenPtr screen, GlyphPtr glyph);

254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271
extern _X_EXPORT Bool glamor_set_spans_nf(DrawablePtr drawable, GCPtr gc, char *src,
					  DDXPointPtr points, int *widths, int n, int sorted);

extern _X_EXPORT Bool glamor_get_spans_nf(DrawablePtr drawable, int wmax,
					  DDXPointPtr points, int *widths, int count, char *dst);

extern _X_EXPORT Bool glamor_composite_rects_nf (CARD8         op,
						 PicturePtr    pDst,
						 xRenderColor  *color,
						 int           nRect,
						 xRectangle    *rects);

extern _X_EXPORT Bool glamor_get_image_nf(DrawablePtr pDrawable, int x, int y, int w, int h,
					  unsigned int format, unsigned long planeMask, char *d);

extern _X_EXPORT Bool glamor_add_traps_nf(PicturePtr pPicture,
					  INT16 x_off, 
					  INT16 y_off, int ntrap, xTrap * traps);
272