src/gallium/auxiliary/draw/draw_context.c

   1 /**************************************************************************
   2  *
   3  * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
   4  * 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
   8  * "Software"), to deal in the Software without restriction, including
   9  * without limitation the rights to use, copy, modify, merge, publish,
  10  * distribute, sub license, and/or sell copies of the Software, and to
  11  * permit persons to whom the Software is furnished to do so, subject to
  12  * the following conditions:
  13  *
  14  * The above copyright notice and this permission notice (including the
  15  * next paragraph) shall be included in all copies or substantial portions
  16  * of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  20  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
  21  * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
  22  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  23  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  24  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  25  *
  26  **************************************************************************/
  27
  28  /*
  29   * Authors:
  30   *   Keith Whitwell <keith@tungstengraphics.com>
  31   */
  32
  33
  34 #include "util/u_memory.h"
  35 #include "util/u_math.h"
  36 #include "draw_context.h"
  37 #include "draw_vbuf.h"
  38 #include "draw_vs.h"
  39 #include "draw_pt.h"
  40 #include "draw_pipe.h"
  41
  42
  43 struct draw_context *draw_create( void )
  44 {
  45    struct draw_context *draw = CALLOC_STRUCT( draw_context );
  46    if (draw == NULL)
  47       goto fail;
  48
  49    ASSIGN_4V( draw->plane[0], -1,  0,  0, 1 );
  50    ASSIGN_4V( draw->plane[1],  1,  0,  0, 1 );
  51    ASSIGN_4V( draw->plane[2],  0, -1,  0, 1 );
  52    ASSIGN_4V( draw->plane[3],  0,  1,  0, 1 );
  53    ASSIGN_4V( draw->plane[4],  0,  0,  1, 1 ); /* yes these are correct */
  54    ASSIGN_4V( draw->plane[5],  0,  0, -1, 1 ); /* mesa's a bit wonky */
  55    draw->nr_planes = 6;
  56
  57
  58    draw->reduced_prim = ~0; /* != any of PIPE_PRIM_x */
  59
  60
  61    if (!draw_pipeline_init( draw ))
  62       goto fail;
  63
  64    if (!draw_pt_init( draw ))
  65       goto fail;
  66
  67    if (!draw_vs_init( draw ))
  68       goto fail;
  69
  70    return draw;
  71
  72 fail:
  73    draw_destroy( draw );
  74    return NULL;
  75 }
  76
  77
  78 void draw_destroy( struct draw_context *draw )
  79 {
  80    if (!draw)
  81       return;
  82
  83
  84
  85    /* Not so fast -- we're just borrowing this at the moment.
  86     *
  87    if (draw->render)
  88       draw->render->destroy( draw->render );
  89    */
  90
  91    draw_pipeline_destroy( draw );
  92    draw_pt_destroy( draw );
  93    draw_vs_destroy( draw );
  94
  95    FREE( draw );
  96 }
  97
  98
  99
 100 void draw_flush( struct draw_context *draw )
 101 {
 102    draw_do_flush( draw, DRAW_FLUSH_BACKEND );
 103 }
 104
 105
 106 /**
 107  * Specify the Minimum Resolvable Depth factor for polygon offset.
 108  * This factor potentially depends on the number of Z buffer bits,
 109  * the rasterization algorithm and the arithmetic performed on Z
 110  * values between vertex shading and rasterization.  It will vary
 111  * from one driver to another.
 112  */
 113 void draw_set_mrd(struct draw_context *draw, double mrd)
 114 {
 115    draw->mrd = mrd;
 116 }
 117
 118
 119 /**
 120  * Register new primitive rasterization/rendering state.
 121  * This causes the drawing pipeline to be rebuilt.
 122  */
 123 void draw_set_rasterizer_state( struct draw_context *draw,
 124                                 const struct pipe_rasterizer_state *raster )
 125 {
 126    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 127
 128    draw->rasterizer = raster;
 129    draw->bypass_clipping =
 130       ((draw->rasterizer && draw->rasterizer->bypass_clipping) ||
 131        draw->driver.bypass_clipping);
 132 }
 133
 134
 135 void draw_set_driver_clipping( struct draw_context *draw,
 136                                boolean bypass_clipping )
 137 {
 138    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 139
 140    draw->driver.bypass_clipping = bypass_clipping;
 141    draw->bypass_clipping = (draw->rasterizer->bypass_clipping ||
 142                             draw->driver.bypass_clipping);
 143 }
 144
 145
 146 /**
 147  * Plug in the primitive rendering/rasterization stage (which is the last
 148  * stage in the drawing pipeline).
 149  * This is provided by the device driver.
 150  */
 151 void draw_set_rasterize_stage( struct draw_context *draw,
 152                                struct draw_stage *stage )
 153 {
 154    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 155
 156    draw->pipeline.rasterize = stage;
 157 }
 158
 159
 160 /**
 161  * Set the draw module's clipping state.
 162  */
 163 void draw_set_clip_state( struct draw_context *draw,
 164                           const struct pipe_clip_state *clip )
 165 {
 166    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 167
 168    assert(clip->nr <= PIPE_MAX_CLIP_PLANES);
 169    memcpy(&draw->plane[6], clip->ucp, clip->nr * sizeof(clip->ucp[0]));
 170    draw->nr_planes = 6 + clip->nr;
 171 }
 172
 173
 174 /**
 175  * Set the draw module's viewport state.
 176  */
 177 void draw_set_viewport_state( struct draw_context *draw,
 178                               const struct pipe_viewport_state *viewport )
 179 {
 180    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 181    draw->viewport = *viewport; /* struct copy */
 182    draw->identity_viewport = (viewport->scale[0] == 1.0f &&
 183                               viewport->scale[1] == 1.0f &&
 184                               viewport->scale[2] == 1.0f &&
 185                               viewport->scale[3] == 1.0f &&
 186                               viewport->translate[0] == 0.0f &&
 187                               viewport->translate[1] == 0.0f &&
 188                               viewport->translate[2] == 0.0f &&
 189                               viewport->translate[3] == 0.0f);
 190
 191    draw_vs_set_viewport( draw, viewport );
 192 }
 193
 194
 195
 196 void
 197 draw_set_vertex_buffers(struct draw_context *draw,
 198                         unsigned count,
 199                         const struct pipe_vertex_buffer *buffers)
 200 {
 201    assert(count <= PIPE_MAX_ATTRIBS);
 202
 203    memcpy(draw->pt.vertex_buffer, buffers, count * sizeof(buffers[0]));
 204    draw->pt.nr_vertex_buffers = count;
 205 }
 206
 207
 208 void
 209 draw_set_vertex_elements(struct draw_context *draw,
 210                          unsigned count,
 211                          const struct pipe_vertex_element *elements)
 212 {
 213    assert(count <= PIPE_MAX_ATTRIBS);
 214
 215    memcpy(draw->pt.vertex_element, elements, count * sizeof(elements[0]));
 216    draw->pt.nr_vertex_elements = count;
 217 }
 218
 219
 220 /**
 221  * Tell drawing context where to find mapped vertex buffers.
 222  */
 223 void
 224 draw_set_mapped_vertex_buffer(struct draw_context *draw,
 225                               unsigned attr, const void *buffer)
 226 {
 227    draw->pt.user.vbuffer[attr] = buffer;
 228 }
 229
 230
 231 void
 232 draw_set_mapped_constant_buffer(struct draw_context *draw,
 233                                 const void *buffer,
 234                                 unsigned size )
 235 {
 236    draw->pt.user.constants = buffer;
 237    draw_vs_set_constants( draw, (const float (*)[4])buffer, size );
 238 }
 239
 240
 241 /**
 242  * Tells the draw module to draw points with triangles if their size
 243  * is greater than this threshold.
 244  */
 245 void
 246 draw_wide_point_threshold(struct draw_context *draw, float threshold)
 247 {
 248    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 249    draw->pipeline.wide_point_threshold = threshold;
 250 }
 251
 252
 253 /**
 254  * Tells the draw module to draw lines with triangles if their width
 255  * is greater than this threshold.
 256  */
 257 void
 258 draw_wide_line_threshold(struct draw_context *draw, float threshold)
 259 {
 260    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 261    draw->pipeline.wide_line_threshold = threshold;
 262 }
 263
 264
 265 /**
 266  * Tells the draw module whether or not to implement line stipple.
 267  */
 268 void
 269 draw_enable_line_stipple(struct draw_context *draw, boolean enable)
 270 {
 271    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 272    draw->pipeline.line_stipple = enable;
 273 }
 274
 275
 276 /**
 277  * Tells draw module whether to convert points to quads for sprite mode.
 278  */
 279 void
 280 draw_enable_point_sprites(struct draw_context *draw, boolean enable)
 281 {
 282    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 283    draw->pipeline.point_sprite = enable;
 284 }
 285
 286
 287 void
 288 draw_set_force_passthrough( struct draw_context *draw, boolean enable )
 289 {
 290    draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
 291    draw->force_passthrough = enable;
 292 }
 293
 294
 295 /**
 296  * Ask the draw module for the location/slot of the given vertex attribute in
 297  * a post-transformed vertex.
 298  *
 299  * With this function, drivers that use the draw module should have no reason
 300  * to track the current vertex shader.
 301  *
 302  * Note that the draw module may sometimes generate vertices with extra
 303  * attributes (such as texcoords for AA lines).  The driver can call this
 304  * function to find those attributes.
 305  *
 306  * Zero is returned if the attribute is not found since this is
 307  * a don't care / undefined situtation.  Returning -1 would be a bit more
 308  * work for the drivers.
 309  */
 310 int
 311 draw_find_vs_output(const struct draw_context *draw,
 312                     uint semantic_name, uint semantic_index)
 313 {
 314    const struct draw_vertex_shader *vs = draw->vs.vertex_shader;
 315    uint i;
 316    for (i = 0; i < vs->info.num_outputs; i++) {
 317       if (vs->info.output_semantic_name[i] == semantic_name &&
 318           vs->info.output_semantic_index[i] == semantic_index)
 319          return i;
 320    }
 321
 322    /* XXX there may be more than one extra vertex attrib.
 323     * For example, simulated gl_FragCoord and gl_PointCoord.
 324     */
 325    if (draw->extra_vp_outputs.semantic_name == semantic_name &&
 326        draw->extra_vp_outputs.semantic_index == semantic_index) {
 327       return draw->extra_vp_outputs.slot;
 328    }
 329    return 0;
 330 }
 331
 332
 333 /**
 334  * Return number of vertex shader outputs.
 335  */
 336 uint
 337 draw_num_vs_outputs(const struct draw_context *draw)
 338 {
 339    uint count = draw->vs.vertex_shader->info.num_outputs;
 340    if (draw->extra_vp_outputs.slot > 0)
 341       count++;
 342    return count;
 343 }
 344
 345
 346 /**
 347  * Provide TGSI sampler objects for vertex shaders that use texture fetches.
 348  * This might only be used by software drivers for the time being.
 349  */
 350 void
 351 draw_texture_samplers(struct draw_context *draw,
 352                       uint num_samplers,
 353                       struct tgsi_sampler **samplers)
 354 {
 355    draw->vs.num_samplers = num_samplers;
 356    draw->vs.samplers = samplers;
 357 }
 358
 359
 360
 361
 362 void draw_set_render( struct draw_context *draw,
 363                       struct vbuf_render *render )
 364 {
 365    draw->render = render;
 366 }
 367
 368 void draw_set_edgeflags( struct draw_context *draw,
 369                          const unsigned *edgeflag )
 370 {
 371    draw->pt.user.edgeflag = edgeflag;
 372 }
 373
 374
 375
 376
 377 /**
 378  * Tell the drawing context about the index/element buffer to use
 379  * (ala glDrawElements)
 380  * If no element buffer is to be used (i.e. glDrawArrays) then this
 381  * should be called with eltSize=0 and elements=NULL.
 382  *
 383  * \param draw  the drawing context
 384  * \param eltSize  size of each element (1, 2 or 4 bytes)
 385  * \param elements  the element buffer ptr
 386  */
 387 void
 388 draw_set_mapped_element_buffer_range( struct draw_context *draw,
 389                                       unsigned eltSize,
 390                                       unsigned min_index,
 391                                       unsigned max_index,
 392                                       const void *elements )
 393 {
 394    draw->pt.user.elts = elements;
 395    draw->pt.user.eltSize = eltSize;
 396    draw->pt.user.min_index = min_index;
 397    draw->pt.user.max_index = max_index;
 398 }
 399
 400
 401 void
 402 draw_set_mapped_element_buffer( struct draw_context *draw,
 403                                 unsigned eltSize,
 404                                 const void *elements )
 405 {
 406    draw->pt.user.elts = elements;
 407    draw->pt.user.eltSize = eltSize;
 408    draw->pt.user.min_index = 0;
 409    draw->pt.user.max_index = 0xffffffff;
 410 }
 411
 412
 413 /* Revamp me please:
 414  */
 415 void draw_do_flush( struct draw_context *draw, unsigned flags )
 416 {
 417    if (!draw->suspend_flushing)
 418    {
 419       assert(!draw->flushing); /* catch inadvertant recursion */
 420
 421       draw->flushing = TRUE;
 422
 423       draw_pipeline_flush( draw, flags );
 424
 425       draw->reduced_prim = ~0; /* is reduced_prim needed any more? */
 426
 427       draw->flushing = FALSE;
 428    }
 429 }