• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright © 2015 Intel Corporation
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice (including the next
12  * paragraph) shall be included in all copies or substantial portions of the
13  * Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21  * IN THE SOFTWARE.
22  *
23  * Authors:
24  *    Jason Ekstrand (jason@jlekstrand.net)
25  *
26  */
27 
28 #ifndef _NIR_SPIRV_H_
29 #define _NIR_SPIRV_H_
30 
31 #include "util/disk_cache.h"
32 #include "compiler/nir/nir.h"
33 #include "compiler/shader_info.h"
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38 
39 struct nir_spirv_specialization {
40    uint32_t id;
41    nir_const_value value;
42    bool defined_on_module;
43 };
44 
45 enum nir_spirv_debug_level {
46    NIR_SPIRV_DEBUG_LEVEL_INFO,
47    NIR_SPIRV_DEBUG_LEVEL_WARNING,
48    NIR_SPIRV_DEBUG_LEVEL_ERROR,
49 };
50 
51 enum nir_spirv_execution_environment {
52    NIR_SPIRV_VULKAN = 0,
53    NIR_SPIRV_OPENCL,
54    NIR_SPIRV_OPENGL,
55 };
56 
57 struct spirv_to_nir_options {
58    enum nir_spirv_execution_environment environment;
59 
60    /* Whether to make FragCoord to a system value, the same as
61     * GLSLFragCoordIsSysVal in GLSL.
62     */
63    bool frag_coord_is_sysval;
64 
65    /* Whether to keep ViewIndex as an input instead of rewriting to a sysval.
66     */
67    bool view_index_is_input;
68 
69    /* Create a nir library. */
70    bool create_library;
71 
72    /* Whether to use nir_intrinsic_deref_buffer_array_length intrinsic instead
73     * of nir_intrinsic_get_ssbo_size to lower OpArrayLength.
74     */
75    bool use_deref_buffer_array_length;
76 
77    struct spirv_supported_capabilities caps;
78 
79    /* Address format for various kinds of pointers. */
80    nir_address_format ubo_addr_format;
81    nir_address_format ssbo_addr_format;
82    nir_address_format phys_ssbo_addr_format;
83    nir_address_format push_const_addr_format;
84    nir_address_format shared_addr_format;
85    nir_address_format global_addr_format;
86    nir_address_format temp_addr_format;
87    nir_address_format constant_addr_format;
88 
89    const nir_shader *clc_shader;
90 
91    struct {
92       void (*func)(void *private_data,
93                    enum nir_spirv_debug_level level,
94                    size_t spirv_offset,
95                    const char *message);
96       void *private_data;
97    } debug;
98 };
99 
100 bool gl_spirv_validation(const uint32_t *words, size_t word_count,
101                          struct nir_spirv_specialization *spec, unsigned num_spec,
102                          gl_shader_stage stage, const char *entry_point_name);
103 
104 nir_shader *spirv_to_nir(const uint32_t *words, size_t word_count,
105                          struct nir_spirv_specialization *specializations,
106                          unsigned num_specializations,
107                          gl_shader_stage stage, const char *entry_point_name,
108                          const struct spirv_to_nir_options *options,
109                          const nir_shader_compiler_options *nir_options);
110 
111 bool nir_can_find_libclc(unsigned ptr_bit_size);
112 
113 nir_shader *
114 nir_load_libclc_shader(unsigned ptr_bit_size,
115                        struct disk_cache *disk_cache,
116                        const struct spirv_to_nir_options *spirv_options,
117                        const nir_shader_compiler_options *nir_options);
118 
119 bool nir_lower_libclc(nir_shader *shader, const nir_shader *clc_shader);
120 
121 #ifdef __cplusplus
122 }
123 #endif
124 
125 #endif /* _NIR_SPIRV_H_ */
126