gallium: change comments to remove 'state tracker'
[mesa.git] / src / gallium / auxiliary / cso_cache / cso_context.h
1 /**************************************************************************
2 *
3 * Copyright 2007-2008 VMware, Inc.
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 VMWARE 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 #ifndef CSO_CONTEXT_H
30 #define CSO_CONTEXT_H
31
32 #include "pipe/p_context.h"
33 #include "pipe/p_state.h"
34 #include "pipe/p_defines.h"
35 #include "cso_cache.h"
36
37
38 #ifdef __cplusplus
39 extern "C" {
40 #endif
41
42 struct cso_context;
43 struct u_vbuf;
44
45 #define CSO_NO_USER_VERTEX_BUFFERS (1 << 0)
46 #define CSO_NO_64B_VERTEX_BUFFERS (1 << 1)
47
48 struct cso_context *cso_create_context(struct pipe_context *pipe,
49 unsigned flags);
50 void cso_destroy_context( struct cso_context *cso );
51 struct pipe_context *cso_get_pipe_context(struct cso_context *cso);
52
53
54 enum pipe_error cso_set_blend( struct cso_context *cso,
55 const struct pipe_blend_state *blend );
56
57
58 enum pipe_error cso_set_depth_stencil_alpha( struct cso_context *cso,
59 const struct pipe_depth_stencil_alpha_state *dsa );
60
61
62
63 enum pipe_error cso_set_rasterizer( struct cso_context *cso,
64 const struct pipe_rasterizer_state *rasterizer );
65
66
67 void
68 cso_set_samplers(struct cso_context *cso,
69 enum pipe_shader_type shader_stage,
70 unsigned count,
71 const struct pipe_sampler_state **states);
72
73
74 /* Alternate interface to support gallium frontends that like to modify
75 * samplers one at a time:
76 */
77 void
78 cso_single_sampler(struct cso_context *cso, enum pipe_shader_type shader_stage,
79 unsigned idx, const struct pipe_sampler_state *states);
80
81 void
82 cso_single_sampler_done(struct cso_context *cso,
83 enum pipe_shader_type shader_stage);
84
85
86 enum pipe_error cso_set_vertex_elements(struct cso_context *ctx,
87 const struct cso_velems_state *velems);
88
89 void cso_set_vertex_buffers(struct cso_context *ctx,
90 unsigned start_slot, unsigned count,
91 const struct pipe_vertex_buffer *buffers);
92
93 void cso_set_stream_outputs(struct cso_context *ctx,
94 unsigned num_targets,
95 struct pipe_stream_output_target **targets,
96 const unsigned *offsets);
97
98
99 /*
100 * We don't provide shader caching in CSO. Most of the time the api provides
101 * object semantics for shaders anyway, and the cases where it doesn't
102 * (eg mesa's internally-generated texenv programs), it will be up to
103 * gallium frontends to implement their own specialized caching.
104 */
105
106 void cso_set_fragment_shader_handle(struct cso_context *ctx, void *handle);
107 void cso_set_vertex_shader_handle(struct cso_context *ctx, void *handle);
108 void cso_set_geometry_shader_handle(struct cso_context *ctx, void *handle);
109 void cso_set_tessctrl_shader_handle(struct cso_context *ctx, void *handle);
110 void cso_set_tesseval_shader_handle(struct cso_context *ctx, void *handle);
111 void cso_set_compute_shader_handle(struct cso_context *ctx, void *handle);
112
113
114 void cso_set_framebuffer(struct cso_context *cso,
115 const struct pipe_framebuffer_state *fb);
116
117
118 void cso_set_viewport(struct cso_context *cso,
119 const struct pipe_viewport_state *vp);
120 void cso_set_viewport_dims(struct cso_context *ctx,
121 float width, float height, boolean invert);
122
123
124 void cso_set_blend_color(struct cso_context *cso,
125 const struct pipe_blend_color *bc);
126
127 void cso_set_sample_mask(struct cso_context *cso, unsigned stencil_mask);
128
129 void cso_set_min_samples(struct cso_context *cso, unsigned min_samples);
130
131 void cso_set_stencil_ref(struct cso_context *cso,
132 const struct pipe_stencil_ref *sr);
133
134 void cso_set_render_condition(struct cso_context *cso,
135 struct pipe_query *query,
136 boolean condition,
137 enum pipe_render_cond_flag mode);
138
139
140 #define CSO_BIT_AUX_VERTEX_BUFFER_SLOT 0x1
141 #define CSO_BIT_BLEND 0x2
142 #define CSO_BIT_DEPTH_STENCIL_ALPHA 0x4
143 #define CSO_BIT_FRAGMENT_SAMPLERS 0x8
144 #define CSO_BIT_FRAGMENT_SAMPLER_VIEWS 0x10
145 #define CSO_BIT_FRAGMENT_SHADER 0x20
146 #define CSO_BIT_FRAMEBUFFER 0x40
147 #define CSO_BIT_GEOMETRY_SHADER 0x80
148 #define CSO_BIT_MIN_SAMPLES 0x100
149 #define CSO_BIT_RASTERIZER 0x200
150 #define CSO_BIT_RENDER_CONDITION 0x400
151 #define CSO_BIT_SAMPLE_MASK 0x800
152 #define CSO_BIT_STENCIL_REF 0x1000
153 #define CSO_BIT_STREAM_OUTPUTS 0x2000
154 #define CSO_BIT_TESSCTRL_SHADER 0x4000
155 #define CSO_BIT_TESSEVAL_SHADER 0x8000
156 #define CSO_BIT_VERTEX_ELEMENTS 0x10000
157 #define CSO_BIT_VERTEX_SHADER 0x20000
158 #define CSO_BIT_VIEWPORT 0x40000
159 #define CSO_BIT_PAUSE_QUERIES 0x80000
160 #define CSO_BIT_FRAGMENT_IMAGE0 0x100000
161
162 #define CSO_BITS_ALL_SHADERS (CSO_BIT_VERTEX_SHADER | \
163 CSO_BIT_FRAGMENT_SHADER | \
164 CSO_BIT_GEOMETRY_SHADER | \
165 CSO_BIT_TESSCTRL_SHADER | \
166 CSO_BIT_TESSEVAL_SHADER)
167
168 void cso_save_state(struct cso_context *cso, unsigned state_mask);
169 void cso_restore_state(struct cso_context *cso);
170
171
172 /* sampler view state */
173
174 void
175 cso_set_sampler_views(struct cso_context *cso,
176 enum pipe_shader_type shader_stage,
177 unsigned count,
178 struct pipe_sampler_view **views);
179
180
181 /* shader images */
182
183 void
184 cso_set_shader_images(struct cso_context *cso,
185 enum pipe_shader_type shader_stage,
186 unsigned start, unsigned count,
187 struct pipe_image_view *views);
188
189
190 /* constant buffers */
191
192 void cso_set_constant_buffer(struct cso_context *cso,
193 enum pipe_shader_type shader_stage,
194 unsigned index, struct pipe_constant_buffer *cb);
195 void cso_set_constant_buffer_resource(struct cso_context *cso,
196 enum pipe_shader_type shader_stage,
197 unsigned index,
198 struct pipe_resource *buffer);
199 void cso_set_constant_user_buffer(struct cso_context *cso,
200 enum pipe_shader_type shader_stage,
201 unsigned index, void *ptr, unsigned size);
202 void cso_save_constant_buffer_slot0(struct cso_context *cso,
203 enum pipe_shader_type shader_stage);
204 void cso_restore_constant_buffer_slot0(struct cso_context *cso,
205 enum pipe_shader_type shader_stage);
206
207 /* Optimized version. */
208 void
209 cso_set_vertex_buffers_and_elements(struct cso_context *ctx,
210 const struct cso_velems_state *velems,
211 unsigned vb_count,
212 unsigned unbind_trailing_vb_count,
213 const struct pipe_vertex_buffer *vbuffers,
214 bool uses_user_vertex_buffers);
215
216 /* drawing */
217
218 void
219 cso_draw_vbo(struct cso_context *cso,
220 const struct pipe_draw_info *info);
221
222 void
223 cso_draw_arrays_instanced(struct cso_context *cso, uint mode,
224 uint start, uint count,
225 uint start_instance, uint instance_count);
226
227 void
228 cso_draw_arrays(struct cso_context *cso, uint mode, uint start, uint count);
229
230 #ifdef __cplusplus
231 }
232 #endif
233
234 #endif