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                             unsigned unbind_trailing_count,
94                             bool take_ownership,
95                             const struct pipe_vertex_buffer *buffers);
96 
97 void cso_set_stream_outputs(struct cso_context *ctx,
98                             unsigned num_targets,
99                             struct pipe_stream_output_target **targets,
100                             const unsigned *offsets);
101 
102 
103 enum cso_unbind_flags {
104    CSO_UNBIND_FS_SAMPLERVIEWS = (1 << 0),
105    CSO_UNBIND_FS_SAMPLERVIEW0 = (1 << 1),
106    CSO_UNBIND_FS_IMAGE0 = (1 << 2),
107    CSO_UNBIND_VS_CONSTANTS = (1 << 3),
108    CSO_UNBIND_FS_CONSTANTS = (1 << 4),
109    CSO_UNBIND_VERTEX_BUFFER0 = (1 << 5),
110 };
111 
112 /*
113  * We don't provide shader caching in CSO.  Most of the time the api provides
114  * object semantics for shaders anyway, and the cases where it doesn't
115  * (eg mesa's internally-generated texenv programs), it will be up to
116  * gallium frontends to implement their own specialized caching.
117  */
118 
119 void cso_set_fragment_shader_handle(struct cso_context *ctx, void *handle);
120 void cso_set_vertex_shader_handle(struct cso_context *ctx, void *handle);
121 void cso_set_geometry_shader_handle(struct cso_context *ctx, void *handle);
122 void cso_set_tessctrl_shader_handle(struct cso_context *ctx, void *handle);
123 void cso_set_tesseval_shader_handle(struct cso_context *ctx, void *handle);
124 void cso_set_compute_shader_handle(struct cso_context *ctx, void *handle);
125 
126 
127 void cso_set_framebuffer(struct cso_context *cso,
128                          const struct pipe_framebuffer_state *fb);
129 
130 
131 void cso_set_viewport(struct cso_context *cso,
132                       const struct pipe_viewport_state *vp);
133 void cso_set_viewport_dims(struct cso_context *ctx,
134                            float width, float height, boolean invert);
135 
136 void cso_set_sample_mask(struct cso_context *cso, unsigned stencil_mask);
137 
138 void cso_set_min_samples(struct cso_context *cso, unsigned min_samples);
139 
140 void cso_set_stencil_ref(struct cso_context *cso,
141                          const struct pipe_stencil_ref sr);
142 
143 void cso_set_render_condition(struct cso_context *cso,
144                               struct pipe_query *query,
145                               boolean condition,
146                               enum pipe_render_cond_flag mode);
147 
148 /* gap */
149 #define CSO_BIT_BLEND                     0x2
150 #define CSO_BIT_DEPTH_STENCIL_ALPHA       0x4
151 #define CSO_BIT_FRAGMENT_SAMPLERS         0x8
152 /* gap */
153 #define CSO_BIT_FRAGMENT_SHADER          0x20
154 #define CSO_BIT_FRAMEBUFFER              0x40
155 #define CSO_BIT_GEOMETRY_SHADER          0x80
156 #define CSO_BIT_MIN_SAMPLES             0x100
157 #define CSO_BIT_RASTERIZER              0x200
158 #define CSO_BIT_RENDER_CONDITION        0x400
159 #define CSO_BIT_SAMPLE_MASK             0x800
160 #define CSO_BIT_STENCIL_REF            0x1000
161 #define CSO_BIT_STREAM_OUTPUTS         0x2000
162 #define CSO_BIT_TESSCTRL_SHADER        0x4000
163 #define CSO_BIT_TESSEVAL_SHADER        0x8000
164 #define CSO_BIT_VERTEX_ELEMENTS       0x10000
165 #define CSO_BIT_VERTEX_SHADER         0x20000
166 #define CSO_BIT_VIEWPORT              0x40000
167 #define CSO_BIT_PAUSE_QUERIES         0x80000
168 
169 #define CSO_BITS_ALL_SHADERS (CSO_BIT_VERTEX_SHADER | \
170                               CSO_BIT_FRAGMENT_SHADER | \
171                               CSO_BIT_GEOMETRY_SHADER | \
172                               CSO_BIT_TESSCTRL_SHADER | \
173                               CSO_BIT_TESSEVAL_SHADER)
174 
175 #define CSO_BIT_COMPUTE_SHADER   (1<<0)
176 #define CSO_BIT_COMPUTE_SAMPLERS (1<<1)
177 
178 void cso_save_state(struct cso_context *cso, unsigned state_mask);
179 void cso_restore_state(struct cso_context *cso, unsigned unbind);
180 
181 void cso_save_compute_state(struct cso_context *cso, unsigned state_mask);
182 void cso_restore_compute_state(struct cso_context *cso);
183 
184 /* Optimized version. */
185 void
186 cso_set_vertex_buffers_and_elements(struct cso_context *ctx,
187                                     const struct cso_velems_state *velems,
188                                     unsigned vb_count,
189                                     unsigned unbind_trailing_vb_count,
190                                     bool take_ownership,
191                                     bool uses_user_vertex_buffers,
192                                     const struct pipe_vertex_buffer *vbuffers);
193 
194 /* drawing */
195 
196 void
197 cso_draw_vbo(struct cso_context *cso,
198              const struct pipe_draw_info *info,
199              unsigned drawid_offset,
200              const struct pipe_draw_indirect_info *indirect,
201              const struct pipe_draw_start_count_bias draw);
202 
203 /* info->draw_id can be changed by the callee if increment_draw_id is true. */
204 void
205 cso_multi_draw(struct cso_context *cso,
206                struct pipe_draw_info *info,
207                unsigned drawid_offset,
208                const struct pipe_draw_start_count_bias *draws,
209                unsigned num_draws);
210 
211 void
212 cso_draw_arrays_instanced(struct cso_context *cso, uint mode,
213                           uint start, uint count,
214                           uint start_instance, uint instance_count);
215 
216 void
217 cso_draw_arrays(struct cso_context *cso, uint mode, uint start, uint count);
218 
219 #ifdef	__cplusplus
220 }
221 #endif
222 
223 #endif
224