src/mesa/drivers/common/meta.h

   1 /*
   2  * Mesa 3-D graphics library
   3  *
   4  * Copyright (C) 2009  VMware, Inc.  All Rights Reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a
   7  * copy of this software and associated documentation files (the "Software"),
   8  * to deal in the Software without restriction, including without limitation
   9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  10  * and/or sell copies of the Software, and to permit persons to whom the
  11  * Software is furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included
  14  * in all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  20  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  22  * OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25
  26 #ifndef META_H
  27 #define META_H
  28
  29 #include "main/mtypes.h"
  30
  31 /**
  32  * \name Flags for meta operations
  33  * \{
  34  *
  35  * These flags are passed to _mesa_meta_begin().
  36  */
  37 #define MESA_META_ALL                      ~0x0
  38 #define MESA_META_ALPHA_TEST                0x1
  39 #define MESA_META_BLEND                     0x2  /**< includes logicop */
  40 #define MESA_META_COLOR_MASK                0x4
  41 #define MESA_META_DEPTH_TEST                0x8
  42 #define MESA_META_FOG                      0x10
  43 #define MESA_META_PIXEL_STORE              0x20
  44 #define MESA_META_PIXEL_TRANSFER           0x40
  45 #define MESA_META_RASTERIZATION            0x80
  46 #define MESA_META_SCISSOR                 0x100
  47 #define MESA_META_SHADER                  0x200
  48 #define MESA_META_STENCIL_TEST            0x400
  49 #define MESA_META_TRANSFORM               0x800 /**< modelview/projection matrix state */
  50 #define MESA_META_TEXTURE                0x1000
  51 #define MESA_META_VERTEX                 0x2000
  52 #define MESA_META_VIEWPORT               0x4000
  53 #define MESA_META_CLAMP_FRAGMENT_COLOR   0x8000
  54 #define MESA_META_CLAMP_VERTEX_COLOR    0x10000
  55 #define MESA_META_CONDITIONAL_RENDER    0x20000
  56 #define MESA_META_CLIP                  0x40000
  57 #define MESA_META_SELECT_FEEDBACK       0x80000
  58 #define MESA_META_MULTISAMPLE          0x100000
  59 #define MESA_META_FRAMEBUFFER_SRGB     0x200000
  60 #define MESA_META_OCCLUSION_QUERY      0x400000
  61 /**\}*/
  62
  63 /**
  64  * State which we may save/restore across meta ops.
  65  * XXX this may be incomplete...
  66  */
  67 struct save_state
  68 {
  69    GLbitfield SavedState;  /**< bitmask of MESA_META_* flags */
  70
  71    /* Always saved/restored with meta. */
  72    gl_api API;
  73
  74    /** MESA_META_CLEAR (and others?) */
  75    struct gl_query_object *CurrentOcclusionObject;
  76
  77    /** MESA_META_ALPHA_TEST */
  78    GLboolean AlphaEnabled;
  79    GLenum AlphaFunc;
  80    GLclampf AlphaRef;
  81
  82    /** MESA_META_BLEND */
  83    GLbitfield BlendEnabled;
  84    GLboolean ColorLogicOpEnabled;
  85
  86    /** MESA_META_COLOR_MASK */
  87    GLubyte ColorMask[MAX_DRAW_BUFFERS][4];
  88
  89    /** MESA_META_DEPTH_TEST */
  90    struct gl_depthbuffer_attrib Depth;
  91
  92    /** MESA_META_FOG */
  93    GLboolean Fog;
  94
  95    /** MESA_META_PIXEL_STORE */
  96    struct gl_pixelstore_attrib Pack, Unpack;
  97
  98    /** MESA_META_PIXEL_TRANSFER */
  99    GLfloat RedBias, RedScale;
 100    GLfloat GreenBias, GreenScale;
 101    GLfloat BlueBias, BlueScale;
 102    GLfloat AlphaBias, AlphaScale;
 103    GLfloat DepthBias, DepthScale;
 104    GLboolean MapColorFlag;
 105
 106    /** MESA_META_RASTERIZATION */
 107    GLenum FrontPolygonMode, BackPolygonMode;
 108    GLboolean PolygonOffset;
 109    GLboolean PolygonSmooth;
 110    GLboolean PolygonStipple;
 111    GLboolean PolygonCull;
 112
 113    /** MESA_META_SCISSOR */
 114    struct gl_scissor_attrib Scissor;
 115
 116    /** MESA_META_SHADER */
 117    GLboolean VertexProgramEnabled;
 118    struct gl_vertex_program *VertexProgram;
 119    GLboolean FragmentProgramEnabled;
 120    struct gl_fragment_program *FragmentProgram;
 121    GLboolean ATIFragmentShaderEnabled;
 122    struct gl_shader_program *Shader[MESA_SHADER_STAGES];
 123    struct gl_shader_program *ActiveShader;
 124
 125    /** MESA_META_STENCIL_TEST */
 126    struct gl_stencil_attrib Stencil;
 127
 128    /** MESA_META_TRANSFORM */
 129    GLenum MatrixMode;
 130    GLfloat ModelviewMatrix[16];
 131    GLfloat ProjectionMatrix[16];
 132    GLfloat TextureMatrix[16];
 133
 134    /** MESA_META_CLIP */
 135    GLbitfield ClipPlanesEnabled;
 136
 137    /** MESA_META_TEXTURE */
 138    GLuint ActiveUnit;
 139    GLuint ClientActiveUnit;
 140    /** for unit[0] only */
 141    struct gl_texture_object *CurrentTexture[NUM_TEXTURE_TARGETS];
 142    /** mask of TEXTURE_2D_BIT, etc */
 143    GLbitfield TexEnabled[MAX_TEXTURE_UNITS];
 144    GLbitfield TexGenEnabled[MAX_TEXTURE_UNITS];
 145    GLuint EnvMode;  /* unit[0] only */
 146
 147    /** MESA_META_VERTEX */
 148    struct gl_vertex_array_object *VAO;
 149    struct gl_buffer_object *ArrayBufferObj;
 150
 151    /** MESA_META_VIEWPORT */
 152    GLfloat ViewportX, ViewportY, ViewportW, ViewportH;
 153    GLclampd DepthNear, DepthFar;
 154
 155    /** MESA_META_CLAMP_FRAGMENT_COLOR */
 156    GLenum ClampFragmentColor;
 157
 158    /** MESA_META_CLAMP_VERTEX_COLOR */
 159    GLenum ClampVertexColor;
 160
 161    /** MESA_META_CONDITIONAL_RENDER */
 162    struct gl_query_object *CondRenderQuery;
 163    GLenum CondRenderMode;
 164
 165    /** MESA_META_SELECT_FEEDBACK */
 166    GLenum RenderMode;
 167    struct gl_selection Select;
 168    struct gl_feedback Feedback;
 169
 170    /** MESA_META_MULTISAMPLE */
 171    struct gl_multisample_attrib Multisample;
 172
 173    /** MESA_META_FRAMEBUFFER_SRGB */
 174    GLboolean sRGBEnabled;
 175
 176    /** Miscellaneous (always disabled) */
 177    GLboolean Lighting;
 178    GLboolean RasterDiscard;
 179    GLboolean TransformFeedbackNeedsResume;
 180 };
 181
 182 /**
 183  * Temporary texture used for glBlitFramebuffer, glDrawPixels, etc.
 184  * This is currently shared by all the meta ops.  But we could create a
 185  * separate one for each of glDrawPixel, glBlitFramebuffer, glCopyPixels, etc.
 186  */
 187 struct temp_texture
 188 {
 189    GLuint TexObj;
 190    GLenum Target;         /**< GL_TEXTURE_2D or GL_TEXTURE_RECTANGLE */
 191    GLsizei MinSize;       /**< Min texture size to allocate */
 192    GLsizei MaxSize;       /**< Max possible texture size */
 193    GLboolean NPOT;        /**< Non-power of two size OK? */
 194    GLsizei Width, Height; /**< Current texture size */
 195    GLenum IntFormat;
 196    GLfloat Sright, Ttop;  /**< right, top texcoords */
 197 };
 198
 199 /**
 200  * State for GLSL texture sampler which is used to generate fragment
 201  * shader in _mesa_meta_generate_mipmap().
 202  */
 203 struct blit_shader {
 204    const char *type;
 205    const char *func;
 206    const char *texcoords;
 207    GLuint shader_prog;
 208 };
 209
 210 /**
 211  * Table of all sampler types and shaders for accessing them.
 212  */
 213 struct blit_shader_table {
 214    struct blit_shader sampler_1d;
 215    struct blit_shader sampler_2d;
 216    struct blit_shader sampler_3d;
 217    struct blit_shader sampler_rect;
 218    struct blit_shader sampler_cubemap;
 219    struct blit_shader sampler_1d_array;
 220    struct blit_shader sampler_2d_array;
 221    struct blit_shader sampler_cubemap_array;
 222 };
 223
 224 /**
 225  * Indices in the blit_state->msaa_shaders[] array
 226  *
 227  * Note that setup_glsl_msaa_blit_shader() assumes that the _INT enums are one
 228  * more than the non-_INT version and _UINT is one beyond that.
 229  */
 230 enum blit_msaa_shader {
 231    BLIT_MSAA_SHADER_2D_MULTISAMPLE_RESOLVE,
 232    BLIT_MSAA_SHADER_2D_MULTISAMPLE_RESOLVE_INT,
 233    BLIT_MSAA_SHADER_2D_MULTISAMPLE_RESOLVE_UINT,
 234    BLIT_MSAA_SHADER_2D_MULTISAMPLE_COPY,
 235    BLIT_MSAA_SHADER_2D_MULTISAMPLE_COPY_INT,
 236    BLIT_MSAA_SHADER_2D_MULTISAMPLE_COPY_UINT,
 237    BLIT_MSAA_SHADER_2D_MULTISAMPLE_DEPTH_RESOLVE,
 238    BLIT_MSAA_SHADER_2D_MULTISAMPLE_DEPTH_COPY,
 239    BLIT_MSAA_SHADER_COUNT,
 240 };
 241
 242 /**
 243  * State for glBlitFramebufer()
 244  */
 245 struct blit_state
 246 {
 247    GLuint VAO;
 248    GLuint VBO;
 249    GLuint DepthFP;
 250    struct blit_shader_table shaders;
 251    GLuint msaa_shaders[BLIT_MSAA_SHADER_COUNT];
 252    struct temp_texture depthTex;
 253 };
 254
 255
 256 /**
 257  * State for glClear()
 258  */
 259 struct clear_state
 260 {
 261    GLuint VAO;
 262    GLuint VBO;
 263    GLuint ShaderProg;
 264    GLint ColorLocation;
 265    GLint LayerLocation;
 266
 267    GLuint IntegerShaderProg;
 268    GLint IntegerColorLocation;
 269    GLint IntegerLayerLocation;
 270 };
 271
 272
 273 /**
 274  * State for glCopyPixels()
 275  */
 276 struct copypix_state
 277 {
 278    GLuint VAO;
 279    GLuint VBO;
 280 };
 281
 282
 283 /**
 284  * State for glDrawPixels()
 285  */
 286 struct drawpix_state
 287 {
 288    GLuint VAO;
 289    GLuint VBO;
 290
 291    GLuint StencilFP;  /**< Fragment program for drawing stencil images */
 292    GLuint DepthFP;  /**< Fragment program for drawing depth images */
 293 };
 294
 295
 296 /**
 297  * State for glBitmap()
 298  */
 299 struct bitmap_state
 300 {
 301    GLuint VAO;
 302    GLuint VBO;
 303    struct temp_texture Tex;  /**< separate texture from other meta ops */
 304 };
 305
 306 /**
 307  * State for _mesa_meta_generate_mipmap()
 308  */
 309 struct gen_mipmap_state
 310 {
 311    GLuint VAO;
 312    GLuint VBO;
 313    GLuint FBO;
 314    GLuint Sampler;
 315
 316    struct blit_shader_table shaders;
 317 };
 318
 319 /**
 320  * State for texture decompression
 321  */
 322 struct decompress_state
 323 {
 324    GLuint VAO;
 325    GLuint VBO, FBO, RBO, Sampler;
 326    GLint Width, Height;
 327
 328    struct blit_shader_table shaders;
 329 };
 330
 331 /**
 332  * State for glDrawTex()
 333  */
 334 struct drawtex_state
 335 {
 336    GLuint VAO;
 337    GLuint VBO;
 338 };
 339
 340 #define MAX_META_OPS_DEPTH      8
 341 /**
 342  * All per-context meta state.
 343  */
 344 struct gl_meta_state
 345 {
 346    /** Stack of state saved during meta-ops */
 347    struct save_state Save[MAX_META_OPS_DEPTH];
 348    /** Save stack depth */
 349    GLuint SaveStackDepth;
 350
 351    struct temp_texture TempTex;
 352
 353    struct blit_state Blit;    /**< For _mesa_meta_BlitFramebuffer() */
 354    struct clear_state Clear;  /**< For _mesa_meta_Clear() */
 355    struct copypix_state CopyPix;  /**< For _mesa_meta_CopyPixels() */
 356    struct drawpix_state DrawPix;  /**< For _mesa_meta_DrawPixels() */
 357    struct bitmap_state Bitmap;    /**< For _mesa_meta_Bitmap() */
 358    struct gen_mipmap_state Mipmap;    /**< For _mesa_meta_GenerateMipmap() */
 359    struct decompress_state Decompress;  /**< For texture decompression */
 360    struct drawtex_state DrawTex;  /**< For _mesa_meta_DrawTex() */
 361 };
 362
 363 struct vertex {
 364    GLfloat x, y, z, tex[4];
 365    GLfloat r, g, b, a;
 366 };
 367
 368 extern void
 369 _mesa_meta_init(struct gl_context *ctx);
 370
 371 extern void
 372 _mesa_meta_free(struct gl_context *ctx);
 373
 374 extern void
 375 _mesa_meta_begin(struct gl_context *ctx, GLbitfield state);
 376
 377 extern void
 378 _mesa_meta_end(struct gl_context *ctx);
 379
 380 extern GLboolean
 381 _mesa_meta_in_progress(struct gl_context *ctx);
 382
 383 extern void
 384 _mesa_meta_BlitFramebuffer(struct gl_context *ctx,
 385                            GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1,
 386                            GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1,
 387                            GLbitfield mask, GLenum filter);
 388
 389 extern void
 390 _mesa_meta_Clear(struct gl_context *ctx, GLbitfield buffers);
 391
 392 extern void
 393 _mesa_meta_glsl_Clear(struct gl_context *ctx, GLbitfield buffers);
 394
 395 extern void
 396 _mesa_meta_CopyPixels(struct gl_context *ctx, GLint srcx, GLint srcy,
 397                       GLsizei width, GLsizei height,
 398                       GLint dstx, GLint dsty, GLenum type);
 399
 400 extern void
 401 _mesa_meta_DrawPixels(struct gl_context *ctx,
 402                       GLint x, GLint y, GLsizei width, GLsizei height,
 403                       GLenum format, GLenum type,
 404                       const struct gl_pixelstore_attrib *unpack,
 405                       const GLvoid *pixels);
 406
 407 extern void
 408 _mesa_meta_Bitmap(struct gl_context *ctx,
 409                   GLint x, GLint y, GLsizei width, GLsizei height,
 410                   const struct gl_pixelstore_attrib *unpack,
 411                   const GLubyte *bitmap);
 412
 413 extern GLboolean
 414 _mesa_meta_check_generate_mipmap_fallback(struct gl_context *ctx, GLenum target,
 415                                           struct gl_texture_object *texObj);
 416
 417 extern void
 418 _mesa_meta_GenerateMipmap(struct gl_context *ctx, GLenum target,
 419                           struct gl_texture_object *texObj);
 420
 421 extern void
 422 _mesa_meta_CopyTexSubImage(struct gl_context *ctx, GLuint dims,
 423                            struct gl_texture_image *texImage,
 424                            GLint xoffset, GLint yoffset, GLint slice,
 425                            struct gl_renderbuffer *rb,
 426                            GLint x, GLint y,
 427                            GLsizei width, GLsizei height);
 428
 429 extern void
 430 _mesa_meta_GetTexImage(struct gl_context *ctx,
 431                        GLenum format, GLenum type, GLvoid *pixels,
 432                        struct gl_texture_image *texImage);
 433
 434 extern void
 435 _mesa_meta_DrawTex(struct gl_context *ctx, GLfloat x, GLfloat y, GLfloat z,
 436                    GLfloat width, GLfloat height);
 437
 438 /* meta-internal functions */
 439 GLuint
 440 _mesa_meta_compile_shader_with_debug(struct gl_context *ctx, GLenum target,
 441                                      const GLcharARB *source);
 442
 443
 444 GLuint
 445 _mesa_meta_link_program_with_debug(struct gl_context *ctx, GLuint program);
 446
 447 GLboolean
 448 _mesa_meta_alloc_texture(struct temp_texture *tex,
 449                          GLsizei width, GLsizei height, GLenum intFormat);
 450
 451 void
 452 _mesa_meta_setup_texture_coords(GLenum faceTarget,
 453                                 GLint slice,
 454                                 GLint width,
 455                                 GLint height,
 456                                 GLint depth,
 457                                 GLfloat coords0[4],
 458                                 GLfloat coords1[4],
 459                                 GLfloat coords2[4],
 460                                 GLfloat coords3[4]);
 461
 462 struct temp_texture *
 463 _mesa_meta_get_temp_texture(struct gl_context *ctx);
 464
 465 struct temp_texture *
 466 _mesa_meta_get_temp_depth_texture(struct gl_context *ctx);
 467
 468 void
 469 _mesa_meta_setup_vertex_objects(GLuint *VAO, GLuint *VBO,
 470                                 bool use_generic_attributes,
 471                                 unsigned vertex_size, unsigned texcoord_size,
 472                                 unsigned color_size);
 473
 474 void
 475 _mesa_meta_setup_ff_tnl_for_blit(GLuint *VAO, GLuint *VBO,
 476                                  unsigned texcoord_size);
 477
 478 void
 479 _mesa_meta_setup_drawpix_texture(struct gl_context *ctx,
 480                                  struct temp_texture *tex,
 481                                  GLboolean newTex,
 482                                  GLsizei width, GLsizei height,
 483                                  GLenum format, GLenum type,
 484                                  const GLvoid *pixels);
 485
 486 void
 487 _mesa_meta_setup_copypix_texture(struct gl_context *ctx,
 488                                  struct temp_texture *tex,
 489                                  GLint srcX, GLint srcY,
 490                                  GLsizei width, GLsizei height,
 491                                  GLenum intFormat,
 492                                  GLenum filter);
 493
 494 void
 495 _mesa_meta_setup_blit_shader(struct gl_context *ctx,
 496                              GLenum target,
 497                              struct blit_shader_table *table);
 498
 499 void
 500 _mesa_meta_glsl_blit_cleanup(struct blit_state *blit);
 501
 502 void
 503 _mesa_meta_blit_shader_table_cleanup(struct blit_shader_table *table);
 504
 505 void
 506 _mesa_meta_glsl_generate_mipmap_cleanup(struct gen_mipmap_state *mipmap);
 507
 508 #endif /* META_H */