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
235