1 /**************************************************************************
3 * Copyright 2008 Tungsten Graphics, Inc., Cedar Park, Texas.
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:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
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 TUNGSTEN GRAPHICS 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.
26 **************************************************************************/
30 * SWIG interface definion for Gallium types.
32 * @author Jose Fonseca <jrfonseca@tungstengraphics.com>
35 %nodefaultctor st_context;
36 %nodefaultdtor st_context;
44 st_context_destroy($self);
48 * State functions (create/bind/destroy state objects)
51 void set_blend( const struct pipe_blend_state *state ) {
52 cso_set_blend($self->cso, state);
55 void set_fragment_sampler( unsigned index, const struct pipe_sampler_state *state ) {
56 cso_single_sampler($self->cso, index, state);
57 cso_single_sampler_done($self->cso);
60 void set_vertex_sampler( unsigned index, const struct pipe_sampler_state *state ) {
61 cso_single_vertex_sampler($self->cso, index, state);
62 cso_single_vertex_sampler_done($self->cso);
65 void set_rasterizer( const struct pipe_rasterizer_state *state ) {
66 cso_set_rasterizer($self->cso, state);
69 void set_depth_stencil_alpha(const struct pipe_depth_stencil_alpha_state *state) {
70 cso_set_depth_stencil_alpha($self->cso, state);
73 void set_fragment_shader( const struct pipe_shader_state *state ) {
77 cso_set_fragment_shader_handle($self->cso, NULL);
81 fs = $self->pipe->create_fs_state($self->pipe, state);
85 if(cso_set_fragment_shader_handle($self->cso, fs) != PIPE_OK)
88 cso_delete_fragment_shader($self->cso, $self->fs);
92 void set_vertex_shader( const struct pipe_shader_state *state ) {
96 cso_set_vertex_shader_handle($self->cso, NULL);
100 vs = $self->pipe->create_vs_state($self->pipe, state);
104 if(cso_set_vertex_shader_handle($self->cso, vs) != PIPE_OK)
107 cso_delete_vertex_shader($self->cso, $self->vs);
111 void set_geometry_shader( const struct pipe_shader_state *state ) {
115 cso_set_geometry_shader_handle($self->cso, NULL);
119 gs = $self->pipe->create_gs_state($self->pipe, state);
123 if(cso_set_geometry_shader_handle($self->cso, gs) != PIPE_OK)
126 cso_delete_geometry_shader($self->cso, $self->gs);
130 struct pipe_sampler_view *
131 create_sampler_view(struct pipe_resource *texture,
132 enum pipe_format format = PIPE_FORMAT_NONE,
133 unsigned first_level = 0,
134 unsigned last_level = ~0,
135 unsigned swizzle_r = 0,
136 unsigned swizzle_g = 1,
137 unsigned swizzle_b = 2,
138 unsigned swizzle_a = 3)
140 struct pipe_context *pipe = $self->pipe;
141 struct pipe_sampler_view templat;
143 memset(&templat, 0, sizeof templat);
144 if (format == PIPE_FORMAT_NONE) {
145 templat.format = texture->format;
147 templat.format = format;
149 templat.last_level = MIN2(last_level, texture->last_level);
150 templat.first_level = first_level;
151 templat.last_level = last_level;
152 templat.swizzle_r = swizzle_r;
153 templat.swizzle_g = swizzle_g;
154 templat.swizzle_b = swizzle_b;
155 templat.swizzle_a = swizzle_a;
157 return pipe->create_sampler_view(pipe, texture, &templat);
161 sampler_view_destroy(struct pipe_context *ctx,
162 struct pipe_sampler_view *view)
164 struct pipe_context *pipe = $self->pipe;
166 pipe->sampler_view_destroy(pipe, view);
170 * Parameter-like state (or properties)
173 void set_blend_color(const struct pipe_blend_color *state ) {
174 cso_set_blend_color($self->cso, state);
177 void set_stencil_ref(const struct pipe_stencil_ref *state ) {
178 cso_set_stencil_ref($self->cso, state);
181 void set_clip(const struct pipe_clip_state *state ) {
182 $self->pipe->set_clip_state($self->pipe, state);
185 void set_constant_buffer(unsigned shader, unsigned index,
186 struct pipe_resource *buffer )
188 $self->pipe->set_constant_buffer($self->pipe, shader, index, buffer);
191 void set_framebuffer(const struct pipe_framebuffer_state *state )
193 memcpy(&$self->framebuffer, state, sizeof *state);
194 cso_set_framebuffer($self->cso, state);
197 void set_polygon_stipple(const struct pipe_poly_stipple *state ) {
198 $self->pipe->set_polygon_stipple($self->pipe, state);
201 void set_scissor(const struct pipe_scissor_state *state ) {
202 $self->pipe->set_scissor_state($self->pipe, state);
205 void set_viewport(const struct pipe_viewport_state *state) {
206 cso_set_viewport($self->cso, state);
209 void set_fragment_sampler_view(unsigned index,
210 struct pipe_sampler_view *view)
212 pipe_sampler_view_reference(&$self->fragment_sampler_views[index], view);
214 $self->pipe->set_fragment_sampler_views($self->pipe,
216 $self->fragment_sampler_views);
219 void set_vertex_sampler_view(unsigned index,
220 struct pipe_sampler_view *view)
222 pipe_sampler_view_reference(&$self->vertex_sampler_views[index], view);
224 $self->pipe->set_vertex_sampler_views($self->pipe,
225 PIPE_MAX_VERTEX_SAMPLERS,
226 $self->vertex_sampler_views);
229 void set_fragment_sampler_texture(unsigned index,
230 struct pipe_resource *texture) {
231 struct pipe_sampler_view templ;
234 texture = $self->default_texture;
235 pipe_sampler_view_reference(&$self->fragment_sampler_views[index], NULL);
236 u_sampler_view_default_template(&templ,
239 $self->fragment_sampler_views[index] = $self->pipe->create_sampler_view($self->pipe,
242 $self->pipe->set_fragment_sampler_views($self->pipe,
244 $self->fragment_sampler_views);
247 void set_vertex_sampler_texture(unsigned index,
248 struct pipe_resource *texture) {
249 struct pipe_sampler_view templ;
252 texture = $self->default_texture;
253 pipe_sampler_view_reference(&$self->vertex_sampler_views[index], NULL);
254 u_sampler_view_default_template(&templ,
257 $self->vertex_sampler_views[index] = $self->pipe->create_sampler_view($self->pipe,
261 $self->pipe->set_vertex_sampler_views($self->pipe,
262 PIPE_MAX_VERTEX_SAMPLERS,
263 $self->vertex_sampler_views);
266 void set_vertex_buffer(unsigned index,
269 unsigned buffer_offset,
270 struct pipe_resource *buffer)
273 struct pipe_vertex_buffer state;
275 memset(&state, 0, sizeof(state));
276 state.stride = stride;
277 state.max_index = max_index;
278 state.buffer_offset = buffer_offset;
279 state.buffer = buffer;
281 memcpy(&$self->vertex_buffers[index], &state, sizeof(state));
283 for(i = 0; i < PIPE_MAX_ATTRIBS; ++i)
284 if(self->vertex_buffers[i].buffer)
285 $self->num_vertex_buffers = i + 1;
287 $self->pipe->set_vertex_buffers($self->pipe,
288 $self->num_vertex_buffers,
289 $self->vertex_buffers);
292 void set_vertex_element(unsigned index,
293 const struct pipe_vertex_element *element)
295 memcpy(&$self->vertex_elements[index], element, sizeof(*element));
298 void set_vertex_elements(unsigned num)
300 $self->num_vertex_elements = num;
301 cso_set_vertex_elements($self->cso,
302 $self->num_vertex_elements,
303 $self->vertex_elements);
310 void draw_arrays(unsigned mode, unsigned start, unsigned count) {
311 $self->pipe->draw_arrays($self->pipe, mode, start, count);
314 void draw_elements( struct pipe_resource *indexBuffer,
315 unsigned indexSize, int indexBias,
316 unsigned mode, unsigned start, unsigned count)
318 $self->pipe->draw_elements($self->pipe,
325 void draw_range_elements( struct pipe_resource *indexBuffer,
326 unsigned indexSize, int indexBias,
327 unsigned minIndex, unsigned maxIndex,
328 unsigned mode, unsigned start, unsigned count)
330 $self->pipe->draw_range_elements($self->pipe,
331 indexBuffer, indexSize, indexBias,
336 void draw_vertices(unsigned prim,
338 unsigned num_attribs,
339 const float *vertices)
341 struct pipe_context *pipe = $self->pipe;
342 struct pipe_screen *screen = pipe->screen;
343 struct pipe_resource *vbuf;
344 struct pipe_transfer *transfer;
345 struct pipe_vertex_element velements[PIPE_MAX_ATTRIBS];
346 struct pipe_vertex_buffer vbuffer;
351 size = num_verts * num_attribs * 4 * sizeof(float);
353 vbuf = pipe_buffer_create(screen,
354 PIPE_BIND_VERTEX_BUFFER,
359 map = pipe_buffer_map(pipe, vbuf, PIPE_TRANSFER_WRITE, &transfer);
362 memcpy(map, vertices, size);
363 pipe_buffer_unmap(pipe, vbuf, transfer);
365 cso_save_vertex_elements($self->cso);
367 /* tell pipe about the vertex attributes */
368 for (i = 0; i < num_attribs; i++) {
369 velements[i].src_offset = i * 4 * sizeof(float);
370 velements[i].instance_divisor = 0;
371 velements[i].vertex_buffer_index = 0;
372 velements[i].src_format = PIPE_FORMAT_R32G32B32A32_FLOAT;
374 cso_set_vertex_elements($self->cso, num_attribs, velements);
376 /* tell pipe about the vertex buffer */
377 memset(&vbuffer, 0, sizeof(vbuffer));
378 vbuffer.buffer = vbuf;
379 vbuffer.stride = num_attribs * 4 * sizeof(float); /* vertex size */
380 vbuffer.buffer_offset = 0;
381 vbuffer.max_index = num_verts - 1;
382 pipe->set_vertex_buffers(pipe, 1, &vbuffer);
385 pipe->draw_arrays(pipe, prim, 0, num_verts);
387 cso_restore_vertex_elements($self->cso);
390 pipe_resource_reference(&vbuf, NULL);
396 clear(unsigned buffers, const float *rgba, double depth = 0.0f,
397 unsigned stencil = 0)
399 $self->pipe->clear($self->pipe, buffers, rgba, depth, stencil);
403 flush(unsigned flags = 0) {
404 struct pipe_fence_handle *fence = NULL;
405 $self->pipe->flush($self->pipe, flags | PIPE_FLUSH_RENDER_CACHE, &fence);
407 /* TODO: allow asynchronous operation */
408 $self->pipe->screen->fence_finish( $self->pipe->screen, fence, 0 );
409 $self->pipe->screen->fence_reference( $self->pipe->screen, &fence, NULL );
417 void surface_copy(struct st_surface *dst,
418 unsigned destx, unsigned desty,
419 struct st_surface *src,
420 unsigned srcx, unsigned srcy,
421 unsigned width, unsigned height)
424 struct pipe_surface *_dst = NULL;
425 struct pipe_surface *_src = NULL;
427 _dst = st_pipe_surface(dst, PIPE_BIND_BLIT_DESTINATION);
429 SWIG_exception(SWIG_ValueError, "couldn't acquire destination surface for writing");
431 _src = st_pipe_surface(src, PIPE_BIND_BLIT_SOURCE);
433 SWIG_exception(SWIG_ValueError, "couldn't acquire source surface for reading");
435 $self->pipe->surface_copy($self->pipe, _dst, destx, desty, _src, srcx, srcy, width, height);
438 pipe_surface_reference(&_src, NULL);
439 pipe_surface_reference(&_dst, NULL);
441 struct pipe_subresource subdst, subsrc;
442 subsrc.face = src->face;
443 subsrc.level = src->level;
444 subdst.face = dst->face;
445 subdst.level = dst->level;
446 $self->pipe->resource_copy_region($self->pipe, dst->texture, subdst, destx, desty, dst->zslice,
447 src->texture, subsrc, srcx, srcy, src->zslice, width, height);
450 void surface_fill(struct st_surface *dst,
451 unsigned x, unsigned y,
452 unsigned width, unsigned height,
456 struct pipe_surface *_dst = NULL;
458 _dst = st_pipe_surface(dst, PIPE_BIND_BLIT_DESTINATION);
460 SWIG_exception(SWIG_ValueError, "couldn't acquire destination surface for writing");
462 $self->pipe->surface_fill($self->pipe, _dst, x, y, width, height, value);
465 pipe_surface_reference(&_dst, NULL);
467 struct pipe_subresource subdst;
468 subdst.face = dst->face;
469 subdst.level = dst->level;
470 $self->pipe->resource_fill_region($self->pipe, dst->texture, subdst, x, y, dst->zslice,
471 width, height, value);
474 %cstring_output_allocate_size(char **STRING, int *LENGTH, free(*$1));
476 surface_read_raw(struct st_surface *surface,
477 unsigned x, unsigned y, unsigned w, unsigned h,
478 char **STRING, int *LENGTH)
480 struct pipe_resource *texture = surface->texture;
481 struct pipe_context *pipe = $self->pipe;
482 struct pipe_transfer *transfer;
485 stride = util_format_get_stride(texture->format, w);
486 *LENGTH = util_format_get_nblocksy(texture->format, h) * stride;
487 *STRING = (char *) malloc(*LENGTH);
491 transfer = pipe_get_transfer(pipe,
499 pipe_get_tile_raw(pipe, transfer, 0, 0, w, h, *STRING, stride);
500 pipe->transfer_destroy(pipe, transfer);
504 %cstring_input_binary(const char *STRING, unsigned LENGTH);
506 surface_write_raw(struct st_surface *surface,
507 unsigned x, unsigned y, unsigned w, unsigned h,
508 const char *STRING, unsigned LENGTH, unsigned stride = 0)
510 struct pipe_resource *texture = surface->texture;
511 struct pipe_context *pipe = $self->pipe;
512 struct pipe_transfer *transfer;
515 stride = util_format_get_stride(texture->format, w);
517 if(LENGTH < util_format_get_nblocksy(texture->format, h) * stride)
518 SWIG_exception(SWIG_ValueError, "offset must be smaller than buffer size");
520 transfer = pipe_get_transfer(pipe,
528 SWIG_exception(SWIG_MemoryError, "couldn't initiate transfer");
530 pipe_put_tile_raw(pipe, transfer, 0, 0, w, h, STRING, stride);
531 pipe->transfer_destroy(pipe, transfer);
538 surface_read_rgba(struct st_surface *surface,
539 unsigned x, unsigned y, unsigned w, unsigned h,
542 struct pipe_context *pipe = $self->pipe;
543 struct pipe_transfer *transfer;
544 transfer = pipe_get_transfer(pipe,
552 pipe_get_tile_rgba(pipe, transfer, 0, 0, w, h, rgba);
553 pipe->transfer_destroy(pipe, transfer);
558 surface_write_rgba(struct st_surface *surface,
559 unsigned x, unsigned y, unsigned w, unsigned h,
562 struct pipe_context *pipe = $self->pipe;
563 struct pipe_transfer *transfer;
564 transfer = pipe_get_transfer(pipe,
572 pipe_put_tile_rgba(pipe, transfer, 0, 0, w, h, rgba);
573 pipe->transfer_destroy(pipe, transfer);
577 %cstring_output_allocate_size(char **STRING, int *LENGTH, free(*$1));
579 surface_read_rgba8(struct st_surface *surface,
580 unsigned x, unsigned y, unsigned w, unsigned h,
581 char **STRING, int *LENGTH)
583 struct pipe_context *pipe = $self->pipe;
584 struct pipe_transfer *transfer;
586 unsigned char *rgba8;
596 *STRING = (char *) malloc(*LENGTH);
600 rgba = malloc(h*w*4*sizeof(float));
604 rgba8 = (unsigned char *) *STRING;
606 transfer = pipe_get_transfer(pipe,
614 pipe_get_tile_rgba(pipe, transfer, 0, 0, w, h, rgba);
615 for(j = 0; j < h; ++j) {
616 for(i = 0; i < w; ++i)
617 for(k = 0; k <4; ++k)
618 rgba8[j*w*4 + i*4 + k] = float_to_ubyte(rgba[j*w*4 + i*4 + k]);
620 pipe->transfer_destroy(pipe, transfer);
627 surface_read_z(struct st_surface *surface,
628 unsigned x, unsigned y, unsigned w, unsigned h,
631 struct pipe_context *pipe = $self->pipe;
632 struct pipe_transfer *transfer;
633 transfer = pipe_get_transfer(pipe,
641 pipe_get_tile_z(pipe, transfer, 0, 0, w, h, z);
642 pipe->transfer_destroy(pipe, transfer);
647 surface_write_z(struct st_surface *surface,
648 unsigned x, unsigned y, unsigned w, unsigned h,
651 struct pipe_context *pipe = $self->pipe;
652 struct pipe_transfer *transfer;
653 transfer = pipe_get_transfer(pipe,
661 pipe_put_tile_z(pipe, transfer, 0, 0, w, h, z);
662 pipe->transfer_destroy(pipe, transfer);
667 surface_sample_rgba(struct st_surface *surface,
671 st_sample_surface($self->pipe, surface, rgba, norm != 0);
675 surface_compare_rgba(struct st_surface *surface,
676 unsigned x, unsigned y, unsigned w, unsigned h,
677 const float *rgba, float tol = 0.0)
679 struct pipe_context *pipe = $self->pipe;
680 struct pipe_transfer *transfer;
686 rgba2 = MALLOC(h*w*4*sizeof(float));
690 transfer = pipe_get_transfer(pipe,
702 pipe_get_tile_rgba(pipe, transfer, 0, 0, w, h, rgba2);
703 pipe->transfer_destroy(pipe, transfer);
708 for(i = h*w; i; --i) {
709 unsigned differs = 0;
711 float delta = *p2++ - *p1++;
712 if (delta < -tol || delta > tol)
723 %cstring_input_binary(const char *STRING, unsigned LENGTH);
725 transfer_inline_write(struct pipe_resource *resource,
726 struct pipe_subresource *sr,
728 const struct pipe_box *box,
729 const char *STRING, unsigned LENGTH,
731 unsigned slice_stride)
733 struct pipe_context *pipe = $self->pipe;
735 pipe->transfer_inline_write(pipe, resource, *sr, usage, box, STRING, stride, slice_stride);
738 %cstring_output_allocate_size(char **STRING, int *LENGTH, free(*$1));
739 void buffer_read(struct pipe_resource *buffer,
740 char **STRING, int *LENGTH)
742 struct pipe_context *pipe = $self->pipe;
744 assert(buffer->target == PIPE_BUFFER);
746 *LENGTH = buffer->width0;
747 *STRING = (char *) malloc(buffer->width0);
751 pipe_buffer_read(pipe, buffer, 0, buffer->width0, *STRING);
754 void buffer_write(struct pipe_resource *buffer,
755 const char *STRING, unsigned LENGTH, unsigned offset = 0)
757 struct pipe_context *pipe = $self->pipe;
759 assert(buffer->target == PIPE_BUFFER);
761 if(offset > buffer->width0)
762 SWIG_exception(SWIG_ValueError, "offset must be smaller than buffer size");
764 if(offset + LENGTH > buffer->width0)
765 SWIG_exception(SWIG_ValueError, "data length must fit inside the buffer");
767 pipe_buffer_write(pipe, buffer, offset, LENGTH, STRING);