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#define TF_UAV              (1 << 13) /* supports uav */
64#define TF_SM5              (1 << 14) /* supported in SM5 */
65
66void
67svga_translate_vertex_format_vgpu10(enum pipe_format format,
68                                    SVGA3dSurfaceFormat *svga_format,
69                                    unsigned *vf_flags);
70
71void
72svga_translate_texture_buffer_view_format(enum pipe_format format,
73                                          SVGA3dSurfaceFormat *svga_format,
74                                          unsigned *tf_flags);
75
76enum SVGA3dSurfaceFormat
77svga_translate_format(const struct svga_screen *ss,
78                      enum pipe_format format,
79                      unsigned bind);
80
81void
82svga_get_format_cap(struct svga_screen *ss,
83                    SVGA3dSurfaceFormat format,
84                    SVGA3dSurfaceFormatCaps *caps);
85
86void
87svga_format_size(SVGA3dSurfaceFormat format,
88                 unsigned *block_width,
89                 unsigned *block_height,
90                 unsigned *bytes_per_block);
91
92const char *
93svga_format_name(SVGA3dSurfaceFormat format);
94
95boolean
96svga_format_is_integer(SVGA3dSurfaceFormat format);
97
98boolean
99svga_format_support_gen_mips(enum pipe_format format);
100
101enum tgsi_return_type
102svga_get_texture_datatype(enum pipe_format format);
103
104
105// XXX: Move this to svga_context?
106boolean
107svga_has_any_integer_cbufs(const struct svga_context *svga);
108
109
110SVGA3dSurfaceFormat
111svga_typeless_format(SVGA3dSurfaceFormat format);
112
113
114SVGA3dSurfaceFormat
115svga_sampler_format(SVGA3dSurfaceFormat format);
116
117
118bool
119svga_format_is_uncompressed_snorm(SVGA3dSurfaceFormat format);
120
121
122bool
123svga_format_is_typeless(SVGA3dSurfaceFormat format);
124
125bool
126svga_format_is_shareable(const struct svga_screen *ss,
127                         enum pipe_format pformat,
128                         SVGA3dSurfaceFormat sformat,
129                         unsigned bind,
130                         bool verbose);
131
132SVGA3dSurfaceFormat
133svga_linear_to_srgb(SVGA3dSurfaceFormat format);
134
135
136bool
137svga_is_format_supported(struct pipe_screen *screen,
138                         enum pipe_format format,
139                         enum pipe_texture_target target,
140                         unsigned sample_count,
141                         unsigned storage_sample_count,
142                         unsigned bindings);
143
144
145bool
146svga_is_dx_format_supported(struct pipe_screen *screen,
147                            enum pipe_format format,
148                            enum pipe_texture_target target,
149                            unsigned sample_count,
150                            unsigned storage_sample_count,
151                            unsigned bindings);
152
153#endif /* SVGA_FORMAT_H_ */
154