1f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/************************************************************************** 2f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 3f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas. 4f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * All Rights Reserved. 5f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 6f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Permission is hereby granted, free of charge, to any person obtaining a 7f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * copy of this software and associated documentation files (the 8f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * "Software"), to deal in the Software without restriction, including 9f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * without limitation the rights to use, copy, modify, merge, publish, 10f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * distribute, sub license, and/or sell copies of the Software, and to 11f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * permit persons to whom the Software is furnished to do so, subject to 12f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * the following conditions: 13f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 14f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * The above copyright notice and this permission notice (including the 15f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * next paragraph) shall be included in all copies or substantial portions 16f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * of the Software. 17f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 18f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 19f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 20f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 21f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR 22f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 23f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 24f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 25f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 26f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org **************************************************************************/ 27f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 28f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/** 29f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * \file 30f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Vertex buffer drawing stage. 31f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 32f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * \author Keith Whitwell <keith@tungstengraphics.com> 33f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * \author Jose Fonseca <jrfonsec@tungstengraphics.com> 34f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 35f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 36f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifndef DRAW_VBUF_H_ 37f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define DRAW_VBUF_H_ 38f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 39f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 40f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#include "pipe/p_compiler.h" 41f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 42f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 43f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgstruct pipe_rasterizer_state; 44f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgstruct draw_context; 45f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgstruct vertex_info; 46f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 47f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 48f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/** 49f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Interface for hardware vertex buffer rendering. 50f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 51f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgstruct vbuf_render { 52f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 53f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org /** 54f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Driver limits. May be tuned lower to improve cache hits on 55f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * index list. 56f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 57f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org unsigned max_indices; 58f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org unsigned max_vertex_buffer_bytes; 59f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 60f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org /** 61f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Query if the hardware driver needs assistance for a particular 62f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * combination of rasterizer state and primitive. 63f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 64f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Currently optional. 65f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 66f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org boolean (*need_pipeline)(const struct vbuf_render *render, 67f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org const struct pipe_rasterizer_state *rasterizer, 68f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org unsigned int prim ); 69f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 70f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 71f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org /** 72f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Get the hardware vertex format. 73f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 74f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * XXX: have this in draw_context instead? 75f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 76f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org const struct vertex_info *(*get_vertex_info)( struct vbuf_render * ); 77f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 78f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org /** 79f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Request a destination for vertices. 80f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Hardware renderers will use ttm memory, others will just malloc 81f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * something. 82f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 83f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org boolean (*allocate_vertices)( struct vbuf_render *, 84f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org ushort vertex_size, 85f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org ushort nr_vertices ); 86f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 87f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org void *(*map_vertices)( struct vbuf_render * ); 88f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org void (*unmap_vertices)( struct vbuf_render *, 89f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org ushort min_index, 90f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org ushort max_index ); 91f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 92f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org /** 93f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Notify the renderer of the current primitive when it changes. 94f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Must succeed for TRIANGLES, LINES and POINTS. Other prims at 95f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * the discretion of the driver, for the benefit of the passthrough 96f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * path. 97f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 98f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org void (*set_primitive)( struct vbuf_render *, unsigned prim ); 99f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 100f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org /** 101f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Draw indexed primitives. Note that indices are ushort. The driver 102f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * must complete this call, if necessary splitting the index list itself. 103f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 104f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org void (*draw_elements)( struct vbuf_render *, 105f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org const ushort *indices, 106f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org uint nr_indices ); 107f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 108f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org /* Draw non-indexed primitives. 109f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 110f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org void (*draw_arrays)( struct vbuf_render *, 111f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org unsigned start, 112f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org uint nr ); 113f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 114f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org /** 115f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Called when vbuf is done with this set of vertices: 116f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 117f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org void (*release_vertices)( struct vbuf_render * ); 118f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 119f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org void (*destroy)( struct vbuf_render * ); 120f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 121f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 122f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org /** 123f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Called after writing data to the stream out buffers 124f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 125f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org void (*set_stream_output_info)( struct vbuf_render *vbufr, 126f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org unsigned primitive_count, 127f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org unsigned vertices_count, 128f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org unsigned primitive_generated ); 129f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org}; 130f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 131f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 132f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 133f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgstruct draw_stage * 134f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgdraw_vbuf_stage( struct draw_context *draw, 135f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org struct vbuf_render *render ); 136f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 137f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 138f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif /*DRAW_VBUF_H_*/ 139