1 2/************************************************************************** 3 * 4 * Copyright 2007 VMware, Inc. 5 * All Rights Reserved. 6 * 7 * Permission is hereby granted, free of charge, to any person obtaining a 8 * copy of this software and associated documentation files (the 9 * "Software"), to deal in the Software without restriction, including 10 * without limitation the rights to use, copy, modify, merge, publish, 11 * distribute, sub license, and/or sell copies of the Software, and to 12 * permit persons to whom the Software is furnished to do so, subject to 13 * the following conditions: 14 * 15 * The above copyright notice and this permission notice (including the 16 * next paragraph) shall be included in all copies or substantial portions 17 * of the Software. 18 * 19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 20 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 21 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 22 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR 23 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 24 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 25 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 26 * 27 **************************************************************************/ 28 29/** 30 * \brief Public interface into the drawing module. 31 */ 32 33/* Authors: Keith Whitwell <keithw@vmware.com> 34 */ 35 36 37#ifndef DRAW_CONTEXT_H 38#define DRAW_CONTEXT_H 39 40 41#include "pipe/p_state.h" 42 43struct pipe_context; 44struct draw_context; 45struct draw_stage; 46struct draw_vertex_shader; 47struct draw_geometry_shader; 48struct draw_fragment_shader; 49struct tgsi_sampler; 50struct tgsi_image; 51struct tgsi_buffer; 52 53/* 54 * structure to contain driver internal information 55 * for stream out support. mapping stores the pointer 56 * to the buffer contents, and internal offset stores 57 * an internal counter to how much of the stream 58 * out buffer is used (in bytes). 59 */ 60struct draw_so_target { 61 struct pipe_stream_output_target target; 62 void *mapping; 63 int internal_offset; 64}; 65 66struct draw_context *draw_create( struct pipe_context *pipe ); 67 68#if HAVE_LLVM 69struct draw_context *draw_create_with_llvm_context(struct pipe_context *pipe, 70 void *context); 71#endif 72 73struct draw_context *draw_create_no_llvm(struct pipe_context *pipe); 74 75void draw_destroy( struct draw_context *draw ); 76 77void draw_flush(struct draw_context *draw); 78 79void draw_set_viewport_states( struct draw_context *draw, 80 unsigned start_slot, 81 unsigned num_viewports, 82 const struct pipe_viewport_state *viewports ); 83 84void draw_set_clip_state( struct draw_context *pipe, 85 const struct pipe_clip_state *clip ); 86 87/** 88 * Sets the rasterization state used by the draw module. 89 * The rast_handle is used to pass the driver specific representation 90 * of the rasterization state. It's going to be used when the 91 * draw module sets the state back on the driver itself using the 92 * pipe::bind_rasterizer_state method. 93 * 94 * NOTE: if you're calling this function from within the pipe's 95 * bind_rasterizer_state you should always call it before binding 96 * the actual state - that's because the draw module can try to 97 * bind its own rasterizer state which would reset your newly 98 * set state. i.e. always do 99 * draw_set_rasterizer_state(driver->draw, state->pipe_state, state); 100 * driver->state.raster = state; 101 */ 102void draw_set_rasterizer_state( struct draw_context *draw, 103 const struct pipe_rasterizer_state *raster, 104 void *rast_handle ); 105 106void draw_set_rasterize_stage( struct draw_context *draw, 107 struct draw_stage *stage ); 108 109void draw_wide_point_threshold(struct draw_context *draw, float threshold); 110 111void draw_wide_point_sprites(struct draw_context *draw, boolean draw_sprite); 112 113void draw_wide_line_threshold(struct draw_context *draw, float threshold); 114 115void draw_enable_line_stipple(struct draw_context *draw, boolean enable); 116 117void draw_enable_point_sprites(struct draw_context *draw, boolean enable); 118 119void draw_set_zs_format(struct draw_context *draw, enum pipe_format format); 120 121boolean 122draw_install_aaline_stage(struct draw_context *draw, struct pipe_context *pipe); 123 124boolean 125draw_install_aapoint_stage(struct draw_context *draw, struct pipe_context *pipe); 126 127boolean 128draw_install_pstipple_stage(struct draw_context *draw, struct pipe_context *pipe); 129 130 131struct tgsi_shader_info * 132draw_get_shader_info(const struct draw_context *draw); 133 134void 135draw_prepare_shader_outputs(struct draw_context *draw); 136 137int 138draw_find_shader_output(const struct draw_context *draw, 139 uint semantic_name, uint semantic_index); 140 141boolean 142draw_will_inject_frontface(const struct draw_context *draw); 143 144uint 145draw_num_shader_outputs(const struct draw_context *draw); 146 147uint 148draw_total_vs_outputs(const struct draw_context *draw); 149 150uint 151draw_total_gs_outputs(const struct draw_context *draw); 152 153void 154draw_texture_sampler(struct draw_context *draw, 155 uint shader_type, 156 struct tgsi_sampler *sampler); 157 158void 159draw_image(struct draw_context *draw, 160 uint shader_type, 161 struct tgsi_image *image); 162 163void 164draw_buffer(struct draw_context *draw, 165 uint shader_type, 166 struct tgsi_buffer *buffer); 167 168void 169draw_set_sampler_views(struct draw_context *draw, 170 enum pipe_shader_type shader_stage, 171 struct pipe_sampler_view **views, 172 unsigned num); 173void 174draw_set_samplers(struct draw_context *draw, 175 enum pipe_shader_type shader_stage, 176 struct pipe_sampler_state **samplers, 177 unsigned num); 178 179void 180draw_set_mapped_texture(struct draw_context *draw, 181 unsigned shader_stage, 182 unsigned sview_idx, 183 uint32_t width, uint32_t height, uint32_t depth, 184 uint32_t first_level, uint32_t last_level, 185 const void *base, 186 uint32_t row_stride[PIPE_MAX_TEXTURE_LEVELS], 187 uint32_t img_stride[PIPE_MAX_TEXTURE_LEVELS], 188 uint32_t mip_offsets[PIPE_MAX_TEXTURE_LEVELS]); 189 190 191/* 192 * Vertex shader functions 193 */ 194 195struct draw_vertex_shader * 196draw_create_vertex_shader(struct draw_context *draw, 197 const struct pipe_shader_state *shader); 198void draw_bind_vertex_shader(struct draw_context *draw, 199 struct draw_vertex_shader *dvs); 200void draw_delete_vertex_shader(struct draw_context *draw, 201 struct draw_vertex_shader *dvs); 202void draw_vs_attach_so(struct draw_vertex_shader *dvs, 203 const struct pipe_stream_output_info *info); 204void draw_vs_reset_so(struct draw_vertex_shader *dvs); 205 206 207/* 208 * Fragment shader functions 209 */ 210struct draw_fragment_shader * 211draw_create_fragment_shader(struct draw_context *draw, 212 const struct pipe_shader_state *shader); 213void draw_bind_fragment_shader(struct draw_context *draw, 214 struct draw_fragment_shader *dvs); 215void draw_delete_fragment_shader(struct draw_context *draw, 216 struct draw_fragment_shader *dvs); 217 218/* 219 * Geometry shader functions 220 */ 221struct draw_geometry_shader * 222draw_create_geometry_shader(struct draw_context *draw, 223 const struct pipe_shader_state *shader); 224void draw_bind_geometry_shader(struct draw_context *draw, 225 struct draw_geometry_shader *dvs); 226void draw_delete_geometry_shader(struct draw_context *draw, 227 struct draw_geometry_shader *dvs); 228 229 230/* 231 * Vertex data functions 232 */ 233 234void draw_set_vertex_buffers(struct draw_context *draw, 235 unsigned start_slot, unsigned count, 236 const struct pipe_vertex_buffer *buffers); 237 238void draw_set_vertex_elements(struct draw_context *draw, 239 unsigned count, 240 const struct pipe_vertex_element *elements); 241 242void draw_set_indexes(struct draw_context *draw, 243 const void *elements, unsigned elem_size, 244 unsigned available_space); 245 246void draw_set_mapped_vertex_buffer(struct draw_context *draw, 247 unsigned attr, const void *buffer, 248 size_t size); 249 250void 251draw_set_mapped_constant_buffer(struct draw_context *draw, 252 unsigned shader_type, 253 unsigned slot, 254 const void *buffer, 255 unsigned size); 256 257void 258draw_set_mapped_so_targets(struct draw_context *draw, 259 int num_targets, 260 struct draw_so_target *targets[PIPE_MAX_SO_BUFFERS]); 261 262 263/*********************************************************************** 264 * draw_pt.c 265 */ 266 267void draw_vbo(struct draw_context *draw, 268 const struct pipe_draw_info *info); 269 270 271/******************************************************************************* 272 * Driver backend interface 273 */ 274struct vbuf_render; 275void draw_set_render( struct draw_context *draw, 276 struct vbuf_render *render ); 277 278void draw_set_driver_clipping( struct draw_context *draw, 279 boolean bypass_clip_xy, 280 boolean bypass_clip_z, 281 boolean guard_band_xy, 282 boolean bypass_clip_points); 283 284void draw_set_force_passthrough( struct draw_context *draw, 285 boolean enable ); 286 287 288/******************************************************************************* 289 * Draw statistics 290 */ 291void draw_collect_pipeline_statistics(struct draw_context *draw, 292 boolean enable); 293 294/******************************************************************************* 295 * Draw pipeline 296 */ 297boolean draw_need_pipeline(const struct draw_context *draw, 298 const struct pipe_rasterizer_state *rasterizer, 299 unsigned prim ); 300 301int 302draw_get_shader_param(unsigned shader, enum pipe_shader_cap param); 303 304int 305draw_get_shader_param_no_llvm(unsigned shader, enum pipe_shader_cap param); 306 307boolean 308draw_get_option_use_llvm(void); 309 310#endif /* DRAW_CONTEXT_H */ 311