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 #define CSO_NO_VBUF  (1 << 2)
48 
49 struct cso_context *cso_create_context(struct pipe_context *pipe,
50                                        unsigned flags);
51 void cso_unbind_context(struct cso_context *ctx);
52 void cso_destroy_context( struct cso_context *cso );
53 struct pipe_context *cso_get_pipe_context(struct cso_context *cso);
54 
55 
56 enum pipe_error cso_set_blend( struct cso_context *cso,
57                                const struct pipe_blend_state *blend );
58 
59 
60 enum pipe_error cso_set_depth_stencil_alpha( struct cso_context *cso,
61                                              const struct pipe_depth_stencil_alpha_state *dsa );
62 
63 
64 
65 enum pipe_error cso_set_rasterizer( struct cso_context *cso,
66                                     const struct pipe_rasterizer_state *rasterizer );
67 
68 
69 void
70 cso_set_samplers(struct cso_context *cso,
71                  enum pipe_shader_type shader_stage,
72                  unsigned count,
73                  const struct pipe_sampler_state **states);
74 
75 
76 /* Alternate interface to support gallium frontends that like to modify
77  * samplers one at a time:
78  */
79 void
80 cso_single_sampler(struct cso_context *cso, enum pipe_shader_type shader_stage,
81                    unsigned idx, const struct pipe_sampler_state *states);
82 
83 void
84 cso_single_sampler_done(struct cso_context *cso,
85                         enum pipe_shader_type shader_stage);
86 
87 
88 enum pipe_error cso_set_vertex_elements(struct cso_context *ctx,
89                                         const struct cso_velems_state *velems);
90 
91 void cso_set_vertex_buffers(struct cso_context *ctx,
92                             unsigned start_slot, unsigned count,
93                             const struct pipe_vertex_buffer *buffers);
94 
95 void cso_set_stream_outputs(struct cso_context *ctx,
96                             unsigned num_targets,
97                             struct pipe_stream_output_target **targets,
98                             const unsigned *offsets);
99 
100 
101 enum cso_unbind_flags {
102    CSO_UNBIND_FS_SAMPLERVIEWS = (1 << 0),
103    CSO_UNBIND_FS_SAMPLERVIEW0 = (1 << 1),
104    CSO_UNBIND_FS_IMAGE0 = (1 << 2),
105    CSO_UNBIND_VS_CONSTANTS = (1 << 3),
106    CSO_UNBIND_FS_CONSTANTS = (1 << 4),
107    CSO_UNBIND_VERTEX_BUFFER0 = (1 << 5),
108 };
109 
110 /*
111  * We don't provide shader caching in CSO.  Most of the time the api provides
112  * object semantics for shaders anyway, and the cases where it doesn't
113  * (eg mesa's internally-generated texenv programs), it will be up to
114  * gallium frontends to implement their own specialized caching.
115  */
116 
117 void cso_set_fragment_shader_handle(struct cso_context *ctx, void *handle);
118 void cso_set_vertex_shader_handle(struct cso_context *ctx, void *handle);
119 void cso_set_geometry_shader_handle(struct cso_context *ctx, void *handle);
120 void cso_set_tessctrl_shader_handle(struct cso_context *ctx, void *handle);
121 void cso_set_tesseval_shader_handle(struct cso_context *ctx, void *handle);
122 void cso_set_compute_shader_handle(struct cso_context *ctx, void *handle);
123 
124 
125 void cso_set_framebuffer(struct cso_context *cso,
126                          const struct pipe_framebuffer_state *fb);
127 
128 
129 void cso_set_viewport(struct cso_context *cso,
130                       const struct pipe_viewport_state *vp);
131 void cso_set_viewport_dims(struct cso_context *ctx,
132                            float width, float height, boolean invert);
133 
134 void cso_set_sample_mask(struct cso_context *cso, unsigned stencil_mask);
135 
136 void cso_set_min_samples(struct cso_context *cso, unsigned min_samples);
137 
138 void cso_set_stencil_ref(struct cso_context *cso,
139                          const struct pipe_stencil_ref sr);
140 
141 void cso_set_render_condition(struct cso_context *cso,
142                               struct pipe_query *query,
143                               boolean condition,
144                               enum pipe_render_cond_flag mode);
145 
146 /* gap */
147 #define CSO_BIT_BLEND                     0x2
148 #define CSO_BIT_DEPTH_STENCIL_ALPHA       0x4
149 #define CSO_BIT_FRAGMENT_SAMPLERS         0x8
150 /* gap */
151 #define CSO_BIT_FRAGMENT_SHADER          0x20
152 #define CSO_BIT_FRAMEBUFFER              0x40
153 #define CSO_BIT_GEOMETRY_SHADER          0x80
154 #define CSO_BIT_MIN_SAMPLES             0x100
155 #define CSO_BIT_RASTERIZER              0x200
156 #define CSO_BIT_RENDER_CONDITION        0x400
157 #define CSO_BIT_SAMPLE_MASK             0x800
158 #define CSO_BIT_STENCIL_REF            0x1000
159 #define CSO_BIT_STREAM_OUTPUTS         0x2000
160 #define CSO_BIT_TESSCTRL_SHADER        0x4000
161 #define CSO_BIT_TESSEVAL_SHADER        0x8000
162 #define CSO_BIT_VERTEX_ELEMENTS       0x10000
163 #define CSO_BIT_VERTEX_SHADER         0x20000
164 #define CSO_BIT_VIEWPORT              0x40000
165 #define CSO_BIT_PAUSE_QUERIES         0x80000
166 
167 #define CSO_BITS_ALL_SHADERS (CSO_BIT_VERTEX_SHADER | \
168                               CSO_BIT_FRAGMENT_SHADER | \
169                               CSO_BIT_GEOMETRY_SHADER | \
170                               CSO_BIT_TESSCTRL_SHADER | \
171                               CSO_BIT_TESSEVAL_SHADER)
172 
173 #define CSO_BIT_COMPUTE_SHADER   (1<<0)
174 #define CSO_BIT_COMPUTE_SAMPLERS (1<<1)
175 
176 void cso_save_state(struct cso_context *cso, unsigned state_mask);
177 void cso_restore_state(struct cso_context *cso, unsigned unbind);
178 
179 void cso_save_compute_state(struct cso_context *cso, unsigned state_mask);
180 void cso_restore_compute_state(struct cso_context *cso);
181 
182 /* Optimized version. */
183 void
184 cso_set_vertex_buffers_and_elements(struct cso_context *ctx,
185                                     const struct cso_velems_state *velems,
186                                     unsigned vb_count,
187                                     unsigned unbind_trailing_vb_count,
188                                     bool take_ownership,
189                                     bool uses_user_vertex_buffers,
190                                     const struct pipe_vertex_buffer *vbuffers);
191 
192 /* drawing */
193 
194 void
195 cso_draw_vbo(struct cso_context *cso,
196              const struct pipe_draw_info *info,
197              unsigned drawid_offset,
198              const struct pipe_draw_indirect_info *indirect,
199              const struct pipe_draw_start_count_bias draw);
200 
201 /* info->draw_id can be changed by the callee if increment_draw_id is true. */
202 void
203 cso_multi_draw(struct cso_context *cso,
204                struct pipe_draw_info *info,
205                unsigned drawid_offset,
206                const struct pipe_draw_start_count_bias *draws,
207                unsigned num_draws);
208 
209 void
210 cso_draw_arrays_instanced(struct cso_context *cso, uint mode,
211                           uint start, uint count,
212                           uint start_instance, uint instance_count);
213 
214 void
215 cso_draw_arrays(struct cso_context *cso, uint mode, uint start, uint count);
216 
217 #ifdef	__cplusplus
218 }
219 #endif
220 
221 #endif
222