1 //
2 // Copyright 2017 The ANGLE Project Authors. All rights reserved.
3 // Use of this source code is governed by a BSD-style license that can be
4 // found in the LICENSE file.
5 //
6 // ExtensionBehavior.cpp: Extension name enumeration and data structures for storing extension
7 // behavior.
8
9 #include "compiler/translator/ExtensionBehavior.h"
10
11 #include "common/debug.h"
12
13 #include <string.h>
14
15 // clang-format off
16 // Extension Name, Min ESSL Version, Max ESSL Version
17 //
18 // Note that OES_EGL_image_external and OES_texture_3D are ESSL 100 only extensions, but one app has
19 // been found that uses them on GLSL 310. http://issuetracker.google.com/285871779
20 //
21 // Note that OES_texture_storage_multisample_2d_array officially requires ESSL 310
22 // but ANGLE is able to support it with ESSL 300 in most cases.
23 #define LIST_EXTENSIONS(OP) \
24 OP(ANDROID_extension_pack_es31a, 310, 320) \
25 OP(ANGLE_base_vertex_base_instance_shader_builtin, 300, 320) \
26 OP(ANGLE_clip_cull_distance, 300, 320) \
27 OP(ANGLE_multi_draw, 100, 320) \
28 OP(ANGLE_shader_pixel_local_storage, 300, 320) \
29 OP(ANGLE_texture_multisample, 300, 320) \
30 OP(APPLE_clip_distance, 100, 320) \
31 OP(ARB_texture_rectangle, 100, 320) \
32 OP(ARM_shader_framebuffer_fetch, 100, 320) \
33 OP(ARM_shader_framebuffer_fetch_depth_stencil, 100, 320) \
34 OP(EXT_blend_func_extended, 100, 320) \
35 OP(EXT_clip_cull_distance, 300, 320) \
36 OP(EXT_conservative_depth, 300, 320) \
37 OP(EXT_draw_buffers, 100, 100) \
38 OP(EXT_frag_depth, 100, 100) \
39 OP(EXT_geometry_shader, 310, 320) \
40 OP(OES_geometry_shader, 310, 320) \
41 OP(OES_shader_io_blocks, 310, 320) \
42 OP(EXT_shader_io_blocks, 310, 320) \
43 OP(EXT_gpu_shader5, 310, 320) \
44 OP(OES_gpu_shader5, 310, 320) \
45 OP(EXT_primitive_bounding_box, 310, 320) \
46 OP(OES_primitive_bounding_box, 310, 320) \
47 OP(EXT_separate_shader_objects, 100, 320) \
48 OP(EXT_shader_framebuffer_fetch, 100, 320) \
49 OP(EXT_shader_framebuffer_fetch_non_coherent, 100, 320) \
50 OP(EXT_shader_non_constant_global_initializers, 100, 320) \
51 OP(EXT_shader_texture_lod, 100, 100) \
52 OP(EXT_shadow_samplers, 100, 100) \
53 OP(EXT_tessellation_shader, 310, 320) \
54 OP(OES_tessellation_shader, 310, 320) \
55 OP(EXT_texture_buffer, 310, 320) \
56 OP(EXT_texture_cube_map_array, 310, 320) \
57 OP(EXT_texture_query_lod, 300, 320) \
58 OP(EXT_texture_shadow_lod, 300, 320) \
59 OP(EXT_YUV_target, 300, 320) \
60 OP(KHR_blend_equation_advanced, 100, 320) \
61 OP(NV_EGL_stream_consumer_external, 100, 320) \
62 OP(NV_shader_framebuffer_fetch, 100, 100) \
63 OP(NV_shader_noperspective_interpolation, 300, 320) \
64 OP(OES_EGL_image_external, 100, 310) \
65 OP(OES_EGL_image_external_essl3, 300, 320) \
66 OP(OES_sample_variables, 300, 320) \
67 OP(OES_shader_multisample_interpolation, 300, 320) \
68 OP(OES_shader_image_atomic, 310, 320) \
69 OP(OES_standard_derivatives, 100, 100) \
70 OP(OES_texture_3D, 100, 310) \
71 OP(OES_texture_buffer, 310, 320) \
72 OP(OES_texture_cube_map_array, 310, 320) \
73 OP(OES_texture_storage_multisample_2d_array, 300, 320) \
74 OP(OVR_multiview, 300, 320) \
75 OP(OVR_multiview2, 300, 320) \
76 OP(WEBGL_video_texture, 100, 320)
77 // clang-format on
78
79 namespace sh
80 {
81
82 #define RETURN_EXTENSION_NAME_CASE(ext, min_version, max_version) \
83 case TExtension::ext: \
84 return "GL_" #ext;
85
GetExtensionNameString(TExtension extension)86 const char *GetExtensionNameString(TExtension extension)
87 {
88 switch (extension)
89 {
90 LIST_EXTENSIONS(RETURN_EXTENSION_NAME_CASE)
91 default:
92 UNREACHABLE();
93 return "";
94 }
95 }
96
97 #define RETURN_EXTENSION_IF_NAME_MATCHES(ext, min_version, max_version) \
98 if (strcmp(extWithoutGLPrefix, #ext) == 0) \
99 { \
100 return TExtension::ext; \
101 }
102
GetExtensionByName(const char * extension)103 TExtension GetExtensionByName(const char *extension)
104 {
105 // If first characters of the extension don't equal "GL_", early out.
106 if (strncmp(extension, "GL_", 3) != 0)
107 {
108 return TExtension::UNDEFINED;
109 }
110 const char *extWithoutGLPrefix = extension + 3;
111
112 LIST_EXTENSIONS(RETURN_EXTENSION_IF_NAME_MATCHES)
113
114 return TExtension::UNDEFINED;
115 }
116
117 #define RETURN_VERSION_CHECK(ext, min_version, max_version) \
118 case TExtension::ext: \
119 return (version >= min_version) && (version <= max_version);
120
CheckExtensionVersion(TExtension extension,int version)121 bool CheckExtensionVersion(TExtension extension, int version)
122 {
123 switch (extension)
124 {
125 LIST_EXTENSIONS(RETURN_VERSION_CHECK)
126 default:
127 UNREACHABLE();
128 return false;
129 }
130 }
131
GetBehaviorString(TBehavior b)132 const char *GetBehaviorString(TBehavior b)
133 {
134 switch (b)
135 {
136 case EBhRequire:
137 return "require";
138 case EBhEnable:
139 return "enable";
140 case EBhWarn:
141 return "warn";
142 case EBhDisable:
143 return "disable";
144 default:
145 return nullptr;
146 }
147 }
148
IsExtensionEnabled(const TExtensionBehavior & extBehavior,TExtension extension)149 bool IsExtensionEnabled(const TExtensionBehavior &extBehavior, TExtension extension)
150 {
151 ASSERT(extension != TExtension::UNDEFINED);
152 auto iter = extBehavior.find(extension);
153 return iter != extBehavior.end() &&
154 (iter->second == EBhEnable || iter->second == EBhRequire || iter->second == EBhWarn);
155 }
156
157 } // namespace sh
158