1/**********************************************************
2 * Copyright 2011 VMware, Inc.  All rights reserved.
3 *
4 * Permission is hereby granted, free of charge, to any person
5 * obtaining a copy of this software and associated documentation
6 * files (the "Software"), to deal in the Software without
7 * restriction, including without limitation the rights to use, copy,
8 * modify, merge, publish, distribute, sublicense, and/or sell copies
9 * of the Software, and to permit persons to whom the Software is
10 * furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice shall be
13 * included in all copies or substantial portions of the Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
19 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
20 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
21 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 * SOFTWARE.
23 *
24 **********************************************************/
25
26#ifndef SVGA_FORMAT_H_
27#define SVGA_FORMAT_H_
28
29
30#include "pipe/p_format.h"
31#include "svga_context.h"
32#include "svga_types.h"
33#include "svga_reg.h"
34#include "svga3d_reg.h"
35
36
37struct svga_screen;
38
39
40/**
41 * Vertex format flags.  These are used to specify that some vertex formats
42 * need extra processing/conversion in the vertex shader.  For example,
43 * setting the W component to 1, or swapping R/B, or converting packed uint
44 * types to signed int/snorm.
45 */
46#define VF_ADJUST_RANGE     (1 << 0)
47#define VF_W_TO_1           (1 << 1)
48#define VF_U_TO_F_CAST      (1 << 2)  /* convert uint to float */
49#define VF_I_TO_F_CAST      (1 << 3)  /* convert sint to float */
50#define VF_BGRA             (1 << 4)  /* swap R/B */
51#define VF_PUINT_TO_SNORM   (1 << 5)  /* 10_10_10_2 to snorm */
52#define VF_PUINT_TO_USCALED (1 << 6)  /* 10_10_10_2 to uscaled */
53#define VF_PUINT_TO_SSCALED (1 << 7)  /* 10_10_10_2 to sscaled */
54
55/**
56 * Texture format flags.
57 */
58#define TF_GEN_MIPS         (1 << 8)  /* supports hw generate mipmap */
59#define TF_000X             (1 << 9)  /* swizzle <0, 0, 0, X> */
60#define TF_XXXX             (1 << 10) /* swizzle <X, X, X, X> */
61#define TF_XXX1             (1 << 11) /* swizzle <X, X, X, 1> */
62#define TF_XXXY             (1 << 12) /* swizzle <X, X, X, Y> */
63
64void
65svga_translate_vertex_format_vgpu10(enum pipe_format format,
66                                    SVGA3dSurfaceFormat *svga_format,
67                                    unsigned *vf_flags);
68
69void
70svga_translate_texture_buffer_view_format(enum pipe_format format,
71                                          SVGA3dSurfaceFormat *svga_format,
72                                          unsigned *tf_flags);
73
74enum SVGA3dSurfaceFormat
75svga_translate_format(const struct svga_screen *ss,
76                      enum pipe_format format,
77                      unsigned bind);
78
79void
80svga_get_format_cap(struct svga_screen *ss,
81                    SVGA3dSurfaceFormat format,
82                    SVGA3dSurfaceFormatCaps *caps);
83
84void
85svga_format_size(SVGA3dSurfaceFormat format,
86                 unsigned *block_width,
87                 unsigned *block_height,
88                 unsigned *bytes_per_block);
89
90const char *
91svga_format_name(SVGA3dSurfaceFormat format);
92
93boolean
94svga_format_is_integer(SVGA3dSurfaceFormat format);
95
96boolean
97svga_format_support_gen_mips(enum pipe_format format);
98
99enum tgsi_return_type
100svga_get_texture_datatype(enum pipe_format format);
101
102
103// XXX: Move this to svga_context?
104boolean
105svga_has_any_integer_cbufs(const struct svga_context *svga);
106
107
108SVGA3dSurfaceFormat
109svga_typeless_format(SVGA3dSurfaceFormat format);
110
111
112SVGA3dSurfaceFormat
113svga_sampler_format(SVGA3dSurfaceFormat format);
114
115
116bool
117svga_format_is_uncompressed_snorm(SVGA3dSurfaceFormat format);
118
119
120bool
121svga_format_is_typeless(SVGA3dSurfaceFormat format);
122
123bool
124svga_format_is_shareable(const struct svga_screen *ss,
125                         enum pipe_format pformat,
126                         SVGA3dSurfaceFormat sformat,
127                         unsigned bind,
128                         bool verbose);
129
130SVGA3dSurfaceFormat
131svga_linear_to_srgb(SVGA3dSurfaceFormat format);
132
133
134bool
135svga_is_format_supported(struct pipe_screen *screen,
136                         enum pipe_format format,
137                         enum pipe_texture_target target,
138                         unsigned sample_count,
139                         unsigned storage_sample_count,
140                         unsigned bindings);
141
142
143bool
144svga_is_dx_format_supported(struct pipe_screen *screen,
145                            enum pipe_format format,
146                            enum pipe_texture_target target,
147                            unsigned sample_count,
148                            unsigned storage_sample_count,
149                            unsigned bindings);
150
151#endif /* SVGA_FORMAT_H_ */
152