draw_context.c File Reference

Include dependency graph for draw_context.c:

Go to the source code of this file.

Functions
struct draw_context *	draw_create (void)
void	draw_destroy (struct draw_context *draw)
void	draw_flush (struct draw_context *draw)
void	draw_set_mrd (struct draw_context *draw, double mrd)
	Specify the Minimum Resolvable Depth factor for polygon offset.
void	draw_set_rasterizer_state (struct draw_context *draw, const struct pipe_rasterizer_state *raster)
	Register new primitive rasterization/rendering state.
void	draw_set_driver_clipping (struct draw_context *draw, boolean bypass_clipping)
void	draw_set_rasterize_stage (struct draw_context *draw, struct draw_stage *stage)
	Plug in the primitive rendering/rasterization stage (which is the last stage in the drawing pipeline).
void	draw_set_clip_state (struct draw_context *draw, const struct pipe_clip_state *clip)
	Set the draw module's clipping state.
void	draw_set_viewport_state (struct draw_context *draw, const struct pipe_viewport_state *viewport)
	Set the draw module's viewport state.
void	draw_set_vertex_buffers (struct draw_context *draw, unsigned count, const struct pipe_vertex_buffer *buffers)
void	draw_set_vertex_elements (struct draw_context *draw, unsigned count, const struct pipe_vertex_element *elements)
void	draw_set_mapped_vertex_buffer (struct draw_context *draw, unsigned attr, const void *buffer)
	Tell drawing context where to find mapped vertex buffers.
void	draw_set_mapped_constant_buffer (struct draw_context *draw, const void *buffer, unsigned size)
void	draw_wide_point_threshold (struct draw_context *draw, float threshold)
	Tells the draw module to draw points with triangles if their size is greater than this threshold.
void	draw_wide_line_threshold (struct draw_context *draw, float threshold)
	Tells the draw module to draw lines with triangles if their width is greater than this threshold.
void	draw_enable_line_stipple (struct draw_context *draw, boolean enable)
	Tells the draw module whether or not to implement line stipple.
void	draw_enable_point_sprites (struct draw_context *draw, boolean enable)
	Tells draw module whether to convert points to quads for sprite mode.
void	draw_set_force_passthrough (struct draw_context *draw, boolean enable)
int	draw_find_vs_output (const struct draw_context *draw, uint semantic_name, uint semantic_index)
	Ask the draw module for the location/slot of the given vertex attribute in a post-transformed vertex.
uint	draw_num_vs_outputs (const struct draw_context *draw)
	Return number of vertex shader outputs.
void	draw_set_render (struct draw_context *draw, struct vbuf_render *render)
void	draw_set_edgeflags (struct draw_context *draw, const unsigned *edgeflag)
void	draw_set_mapped_element_buffer_range (struct draw_context *draw, unsigned eltSize, unsigned min_index, unsigned max_index, const void *elements)
	Tell the drawing context about the index/element buffer to use (ala glDrawElements) If no element buffer is to be used (i.e.
void	draw_set_mapped_element_buffer (struct draw_context *draw, unsigned eltSize, const void *elements)
void	draw_do_flush (struct draw_context *draw, unsigned flags)

---

Function Documentation

struct draw_context* draw_create

(

void

)

[read]

Definition at line 43 of file draw_context.c.

References ASSIGN_4V, CALLOC_STRUCT, draw, draw_destroy(), draw_pipeline_init(), draw_pt_init(), draw_vs_init(), draw_context::nr_planes, draw_context::plane, and draw_context::reduced_prim.

{
   struct draw_context *draw = CALLOC_STRUCT( draw_context );
   if (draw == NULL)
      goto fail;

   ASSIGN_4V( draw->plane[0], -1,  0,  0, 1 );
   ASSIGN_4V( draw->plane[1],  1,  0,  0, 1 );
   ASSIGN_4V( draw->plane[2],  0, -1,  0, 1 );
   ASSIGN_4V( draw->plane[3],  0,  1,  0, 1 );
   ASSIGN_4V( draw->plane[4],  0,  0,  1, 1 ); /* yes these are correct */
   ASSIGN_4V( draw->plane[5],  0,  0, -1, 1 ); /* mesa's a bit wonky */
   draw->nr_planes = 6;


   draw->reduced_prim = ~0; /* != any of PIPE_PRIM_x */


   if (!draw_pipeline_init( draw ))
      goto fail;

   if (!draw_pt_init( draw ))
      goto fail;

   if (!draw_vs_init( draw ))
      goto fail;

   return draw;

fail:
   draw_destroy( draw );   
   return NULL;
}

void draw_destroy

(

struct draw_context *

draw

)

Definition at line 78 of file draw_context.c.

References draw_pipeline_destroy(), draw_pt_destroy(), draw_vs_destroy(), and FREE.

{
   if (!draw)
      return;



   /* Not so fast -- we're just borrowing this at the moment.
    * 
   if (draw->render)
      draw->render->destroy( draw->render );
   */

   draw_pipeline_destroy( draw );
   draw_pt_destroy( draw );
   draw_vs_destroy( draw );

   FREE( draw );
}

void draw_do_flush	(	struct draw_context *	draw,
		unsigned	flags
	)

Definition at line 400 of file draw_context.c.

References assert, draw_pipeline_flush(), FALSE, draw_context::flushing, draw_context::reduced_prim, draw_context::suspend_flushing, and TRUE.

{
   if (!draw->suspend_flushing)
   {
      assert(!draw->flushing); /* catch inadvertant recursion */

      draw->flushing = TRUE;

      draw_pipeline_flush( draw, flags );

      draw->reduced_prim = ~0; /* is reduced_prim needed any more? */
      
      draw->flushing = FALSE;
   }
}

void draw_enable_line_stipple	(	struct draw_context *	draw,
		boolean	enable
	)

Tells the draw module whether or not to implement line stipple.

Definition at line 269 of file draw_context.c.

References draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, draw_context::line_stipple, and draw_context::pipeline.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
   draw->pipeline.line_stipple = enable;
}

void draw_enable_point_sprites	(	struct draw_context *	draw,
		boolean	enable
	)

Tells draw module whether to convert points to quads for sprite mode.

Definition at line 280 of file draw_context.c.

References draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, draw_context::pipeline, and draw_context::point_sprite.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
   draw->pipeline.point_sprite = enable;
}

int draw_find_vs_output	(	const struct draw_context *	draw,
		uint	semantic_name,
		uint	semantic_index
	)

Ask the draw module for the location/slot of the given vertex attribute in a post-transformed vertex.

With this function, drivers that use the draw module should have no reason to track the current vertex shader.

Note that the draw module may sometimes generate vertices with extra attributes (such as texcoords for AA lines). The driver can call this function to find those attributes.

Zero is returned if the attribute is not found since this is a don't care / undefined situtation. Returning -1 would be a bit more work for the drivers.

Definition at line 311 of file draw_context.c.

References draw_context::extra_vp_outputs, draw_vertex_shader::info, tgsi_shader_info::num_outputs, tgsi_shader_info::output_semantic_index, tgsi_shader_info::output_semantic_name, draw_context::semantic_index, draw_context::semantic_name, draw_context::slot, draw_context::vertex_shader, and draw_context::vs.

{
   const struct draw_vertex_shader *vs = draw->vs.vertex_shader;
   uint i;
   for (i = 0; i < vs->info.num_outputs; i++) {
      if (vs->info.output_semantic_name[i] == semantic_name &&
          vs->info.output_semantic_index[i] == semantic_index)
         return i;
   }

   /* XXX there may be more than one extra vertex attrib.
    * For example, simulated gl_FragCoord and gl_PointCoord.
    */
   if (draw->extra_vp_outputs.semantic_name == semantic_name &&
       draw->extra_vp_outputs.semantic_index == semantic_index) {
      return draw->extra_vp_outputs.slot;
   }
   return 0;
}

void draw_flush

(

struct draw_context *

draw

)

Definition at line 100 of file draw_context.c.

References draw_do_flush(), and DRAW_FLUSH_BACKEND.

{
   draw_do_flush( draw, DRAW_FLUSH_BACKEND );
}

uint draw_num_vs_outputs

(

const struct draw_context *

draw

)

Return number of vertex shader outputs.

Definition at line 337 of file draw_context.c.

References draw_context::extra_vp_outputs, draw_vertex_shader::info, tgsi_shader_info::num_outputs, draw_context::slot, draw_context::vertex_shader, and draw_context::vs.

{
   uint count = draw->vs.vertex_shader->info.num_outputs;
   if (draw->extra_vp_outputs.slot > 0)
      count++;
   return count;
}

void draw_set_clip_state	(	struct draw_context *	draw,
		const struct pipe_clip_state *	clip
	)

Set the draw module's clipping state.

Definition at line 163 of file draw_context.c.

References assert, draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, pipe_clip_state::nr, draw_context::nr_planes, PIPE_MAX_CLIP_PLANES, draw_context::plane, and pipe_clip_state::ucp.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );

   assert(clip->nr <= PIPE_MAX_CLIP_PLANES);
   memcpy(&draw->plane[6], clip->ucp, clip->nr * sizeof(clip->ucp[0]));
   draw->nr_planes = 6 + clip->nr;
}

void draw_set_driver_clipping	(	struct draw_context *	draw,
		boolean	bypass_clipping
	)

Definition at line 135 of file draw_context.c.

References pipe_rasterizer_state::bypass_clipping, draw_context::bypass_clipping, draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, draw_context::driver, and draw_context::rasterizer.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );

   draw->driver.bypass_clipping = bypass_clipping;
   draw->bypass_clipping = (draw->rasterizer->bypass_clipping || 
                            draw->driver.bypass_clipping);
}

void draw_set_edgeflags	(	struct draw_context *	draw,
		const unsigned *	edgeflag
	)

Definition at line 353 of file draw_context.c.

References draw_context::pt, and draw_context::user.

{
   draw->pt.user.edgeflag = edgeflag;
}

void draw_set_force_passthrough	(	struct draw_context *	draw,
		boolean	enable
	)

Definition at line 288 of file draw_context.c.

References draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, and draw_context::force_passthrough.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
   draw->force_passthrough = enable;
}

void draw_set_mapped_constant_buffer	(	struct draw_context *	draw,
		const void *	buffer,
		unsigned	size
	)

Definition at line 232 of file draw_context.c.

References draw_vs_set_constants(), draw_context::pt, and draw_context::user.

{
   draw->pt.user.constants = buffer;
   draw_vs_set_constants( draw, (const float (*)[4])buffer, size );
}

void draw_set_mapped_element_buffer	(	struct draw_context *	draw,
		unsigned	eltSize,
		const void *	elements
	)

Definition at line 387 of file draw_context.c.

References draw_context::pt, and draw_context::user.

{
   draw->pt.user.elts = elements;
   draw->pt.user.eltSize = eltSize;
   draw->pt.user.min_index = 0;
   draw->pt.user.max_index = 0xffffffff;
}

void draw_set_mapped_element_buffer_range	(	struct draw_context *	draw,
		unsigned	eltSize,
		unsigned	min_index,
		unsigned	max_index,
		const void *	elements
	)

Tell the drawing context about the index/element buffer to use (ala glDrawElements) If no element buffer is to be used (i.e.

glDrawArrays) then this should be called with eltSize=0 and elements=NULL.

Parameters:

	draw	the drawing context
	eltSize	size of each element (1, 2 or 4 bytes)
	elements	the element buffer ptr

Definition at line 373 of file draw_context.c.

References draw_context::pt, and draw_context::user.

{
   draw->pt.user.elts = elements;
   draw->pt.user.eltSize = eltSize;
   draw->pt.user.min_index = min_index;
   draw->pt.user.max_index = max_index;
}

void draw_set_mapped_vertex_buffer	(	struct draw_context *	draw,
		unsigned	attr,
		const void *	buffer
	)

Tell drawing context where to find mapped vertex buffers.

Definition at line 224 of file draw_context.c.

References draw_context::pt, and draw_context::user.

{
   draw->pt.user.vbuffer[attr] = buffer;
}

void draw_set_mrd	(	struct draw_context *	draw,
		double	mrd
	)

Specify the Minimum Resolvable Depth factor for polygon offset.

This factor potentially depends on the number of Z buffer bits, the rasterization algorithm and the arithmetic performed on Z values between vertex shading and rasterization. It will vary from one driver to another.

Definition at line 113 of file draw_context.c.

References draw_context::mrd.

{
   draw->mrd = mrd;
}

void draw_set_rasterize_stage	(	struct draw_context *	draw,
		struct draw_stage *	stage
	)

Plug in the primitive rendering/rasterization stage (which is the last stage in the drawing pipeline).

This is provided by the device driver.

Definition at line 151 of file draw_context.c.

References draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, draw_context::pipeline, and draw_context::rasterize.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );

   draw->pipeline.rasterize = stage;
}

void draw_set_rasterizer_state	(	struct draw_context *	draw,
		const struct pipe_rasterizer_state *	raster
	)

Register new primitive rasterization/rendering state.

This causes the drawing pipeline to be rebuilt.

Definition at line 123 of file draw_context.c.

References pipe_rasterizer_state::bypass_clipping, draw_context::bypass_clipping, draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, draw_context::driver, and draw_context::rasterizer.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );

   draw->rasterizer = raster;
   draw->bypass_clipping =
      ((draw->rasterizer && draw->rasterizer->bypass_clipping) ||
       draw->driver.bypass_clipping);
}

void draw_set_render	(	struct draw_context *	draw,
		struct vbuf_render *	render
	)

Definition at line 347 of file draw_context.c.

References draw_context::render.

{
   draw->render = render;
}

void draw_set_vertex_buffers	(	struct draw_context *	draw,
		unsigned	count,
		const struct pipe_vertex_buffer *	buffers
	)

Definition at line 197 of file draw_context.c.

References assert, draw_context::nr_vertex_buffers, PIPE_MAX_ATTRIBS, draw_context::pt, and draw_context::vertex_buffer.

{
   assert(count <= PIPE_MAX_ATTRIBS);

   memcpy(draw->pt.vertex_buffer, buffers, count * sizeof(buffers[0]));
   draw->pt.nr_vertex_buffers = count;
}

void draw_set_vertex_elements	(	struct draw_context *	draw,
		unsigned	count,
		const struct pipe_vertex_element *	elements
	)

Definition at line 209 of file draw_context.c.

References assert, draw_context::nr_vertex_elements, PIPE_MAX_ATTRIBS, draw_context::pt, and draw_context::vertex_element.

{
   assert(count <= PIPE_MAX_ATTRIBS);

   memcpy(draw->pt.vertex_element, elements, count * sizeof(elements[0]));
   draw->pt.nr_vertex_elements = count;
}

void draw_set_viewport_state	(	struct draw_context *	draw,
		const struct pipe_viewport_state *	viewport
	)

Set the draw module's viewport state.

Definition at line 177 of file draw_context.c.

References draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, draw_vs_set_viewport(), draw_context::identity_viewport, pipe_viewport_state::scale, pipe_viewport_state::translate, and draw_context::viewport.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
   draw->viewport = *viewport; /* struct copy */
   draw->identity_viewport = (viewport->scale[0] == 1.0f &&
                              viewport->scale[1] == 1.0f &&
                              viewport->scale[2] == 1.0f &&
                              viewport->scale[3] == 1.0f &&
                              viewport->translate[0] == 0.0f &&
                              viewport->translate[1] == 0.0f &&
                              viewport->translate[2] == 0.0f &&
                              viewport->translate[3] == 0.0f);

   draw_vs_set_viewport( draw, viewport );
}

void draw_wide_line_threshold	(	struct draw_context *	draw,
		float	threshold
	)

Tells the draw module to draw lines with triangles if their width is greater than this threshold.

Definition at line 258 of file draw_context.c.

References draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, draw_context::pipeline, and draw_context::wide_line_threshold.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
   draw->pipeline.wide_line_threshold = threshold;
}

void draw_wide_point_threshold	(	struct draw_context *	draw,
		float	threshold
	)

Tells the draw module to draw points with triangles if their size is greater than this threshold.

Definition at line 246 of file draw_context.c.

References draw_do_flush(), DRAW_FLUSH_STATE_CHANGE, draw_context::pipeline, and draw_context::wide_point_threshold.

{
   draw_do_flush( draw, DRAW_FLUSH_STATE_CHANGE );
   draw->pipeline.wide_point_threshold = threshold;
}

---