gallium: add a generic vertex (or other) buffer translation module
[mesa.git] / src / gallium / auxiliary / translate / translate.h
1 /*
2 * Copyright 2008 Tungsten Graphics, inc.
3 * All Rights Reserved.
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * on the rights to use, copy, modify, merge, publish, distribute, sub
9 * license, and/or sell copies of the Software, and to permit persons to whom
10 * the Software is furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice (including the next
13 * paragraph) shall be included in all copies or substantial portions of the
14 * Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
19 * TUNGSTEN GRAPHICS AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
20 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
21 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
22 * USE OR OTHER DEALINGS IN THE SOFTWARE.
23 */
24
25
26 /**
27 * Vertex fetch/store/convert code. This functionality is used in two places:
28 * 1. Vertex fetch/convert - to grab vertex data from incoming vertex
29 * arrays and convert to format needed by vertex shaders.
30 * 2. Vertex store/emit - to convert simple float[][4] vertex attributes
31 * (which is the organization used throughout the draw/prim pipeline) to
32 * hardware-specific formats and emit into hardware vertex buffers.
33 *
34 *
35 * Authors:
36 * Keith Whitwell <keithw@tungstengraphics.com>
37 */
38
39 #ifndef _TRANSLATE_H
40 #define _TRANSLATE_H
41
42
43 #include "pipe/p_compiler.h"
44 #include "pipe/p_format.h"
45
46 struct translate_element
47 {
48 enum pipe_format input_format;
49 unsigned input_buffer;
50 unsigned input_offset;
51
52 enum pipe_format output_format;
53 unsigned output_offset;
54 };
55
56
57 struct translate {
58 void (*destroy)( struct translate * );
59
60 void (*set_buffer)( struct translate *,
61 unsigned i,
62 const void *ptr,
63 unsigned stride );
64
65 void (*run_elts)( struct translate *,
66 const unsigned *elts,
67 unsigned count,
68 void *output_buffer);
69 };
70
71
72
73 struct translate *translate_sse2_create( unsigned output_stride,
74 const struct translate_element *elements,
75 unsigned nr_elements );
76
77 struct translate *translate_generic_create( unsigned output_stride,
78 const struct translate_element *elements,
79 unsigned nr_elements );
80
81
82 #endif