| Flutter Impeller |

compiler.cc
Go to the documentation of this file.
1 // Copyright 2013 The Flutter Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
4
5 #include "impeller/compiler/compiler.h"
6
7 #include <cstdint>
8 #include <filesystem>
9 #include <memory>
10 #include <optional>
11 #include <sstream>
12 #include <string>
13 #include <utility>
14
15 #include "flutter/fml/paths.h"
16 #include "impeller/base/allocation.h"
17 #include "impeller/compiler/compiler_backend.h"
18 #include "impeller/compiler/constants.h"
19 #include "impeller/compiler/includer.h"
20 #include "impeller/compiler/logger.h"
21 #include "impeller/compiler/spirv_compiler.h"
22 #include "impeller/compiler/types.h"
23 #include "impeller/compiler/uniform_sorter.h"
24 #include "impeller/compiler/utilities.h"
25
26 namespace impeller {
27 namespace compiler {
28
29 namespace {
30 constexpr const char* kEGLImageExternalExtension = "GL_OES_EGL_image_external";
31 constexpr const char* kEGLImageExternalExtension300 =
32 "GL_OES_EGL_image_external_essl3";
33 } // namespace
34
35 // This value should be <= 7372. UBOs can be larger on some devices but a
36 // performance cost will be paid.
37 // https://docs.qualcomm.com/bundle/publicresource/topics/80-78185-2/best_practices.html?product=1601111740035277#buffer-best-practices
38 static const uint32_t kMaxUniformBufferSize = 6208;
39
40 static uint32_t ParseMSLVersion(const std::string& msl_version) {
41 std::stringstream sstream(msl_version);
42 std::string version_part;
43 uint32_t major = 1;
44 uint32_t minor = 2;
45 uint32_t patch = 0;
46 if (std::getline(sstream, version_part, '.')) {
47 major = std::stoi(version_part);
48 if (std::getline(sstream, version_part, '.')) {
49 minor = std::stoi(version_part);
50 if (std::getline(sstream, version_part, '.')) {
51 patch = std::stoi(version_part);
52 }
53 }
54 }
55 if (major < 1 || (major == 1 && minor < 2)) {
56 std::cerr << "--metal-version version must be at least 1.2. Have "
57 << msl_version << std::endl;
58 }
59 return spirv_cross::CompilerMSL::Options::make_msl_version(major, minor,
60 patch);
61 }
62
63 static CompilerBackend CreateMSLCompiler(
64 const spirv_cross::ParsedIR& ir,
65 const SourceOptions& source_options,
66 std::optional<uint32_t> msl_version_override = {}) {
67 auto sl_compiler = std::make_shared<spirv_cross::CompilerMSL>(ir);
68 spirv_cross::CompilerMSL::Options sl_options;
69 sl_options.platform =
70 TargetPlatformToMSLPlatform(source_options.target_platform);
71 sl_options.msl_version = msl_version_override.value_or(
72 ParseMSLVersion(source_options.metal_version));
73 sl_options.ios_use_simdgroup_functions =
74 sl_options.is_ios() &&
75 sl_options.msl_version >=
76 spirv_cross::CompilerMSL::Options::make_msl_version(2, 4, 0);
77 sl_options.use_framebuffer_fetch_subpasses = true;
78 sl_compiler->set_msl_options(sl_options);
79
80 // Sort the float and sampler uniforms according to their declared/decorated
81 // order. For user authored fragment shaders, the API for setting uniform
82 // values uses the index of the uniform in the declared order. By default, the
83 // metal backend of spirv-cross will order uniforms according to usage. To fix
84 // this, we use the sorted order and the add_msl_resource_binding API to force
85 // the ordering to match the declared order. Note that while this code runs
86 // for all compiled shaders, it will only affect vertex and fragment shaders
87 // due to the specified stage.
88 auto floats =
89 SortUniforms(&ir, sl_compiler.get(), spirv_cross::SPIRType::Float);
90 auto images =
91 SortUniforms(&ir, sl_compiler.get(), spirv_cross::SPIRType::SampledImage);
92
93 spv::ExecutionModel execution_model =
94 spv::ExecutionModel::ExecutionModelFragment;
95 if (source_options.type == SourceType::kVertexShader) {
96 execution_model = spv::ExecutionModel::ExecutionModelVertex;
97 }
98
99 uint32_t buffer_offset = 0;
100 uint32_t sampler_offset = 0;
101 for (auto& float_id : floats) {
102 sl_compiler->add_msl_resource_binding(
103 {.stage = execution_model,
104 .basetype = spirv_cross::SPIRType::BaseType::Float,
105 .desc_set = sl_compiler->get_decoration(float_id,
106 spv::DecorationDescriptorSet),
107 .binding =
108 sl_compiler->get_decoration(float_id, spv::DecorationBinding),
109 .count = 1u,
110 .msl_buffer = buffer_offset});
111 buffer_offset++;
112 }
113 for (auto& image_id : images) {
114 sl_compiler->add_msl_resource_binding({
115 .stage = execution_model,
116 .basetype = spirv_cross::SPIRType::BaseType::SampledImage,
117 .desc_set =
118 sl_compiler->get_decoration(image_id, spv::DecorationDescriptorSet),
119 .binding =
120 sl_compiler->get_decoration(image_id, spv::DecorationBinding),
121 .count = 1u,
122 // A sampled image is both an image and a sampler, so both
123 // offsets need to be set or depending on the partiular shader
124 // the bindings may be incorrect.
125 .msl_texture = sampler_offset,
126 .msl_sampler = sampler_offset,
127 });
128 sampler_offset++;
129 }
130
131 return CompilerBackend(sl_compiler);
132 }
133
134 static CompilerBackend CreateVulkanCompiler(
135 const spirv_cross::ParsedIR& ir,
136 const SourceOptions& source_options) {
137 auto gl_compiler = std::make_shared<spirv_cross::CompilerGLSL>(ir);
138 spirv_cross::CompilerGLSL::Options sl_options;
139 sl_options.force_zero_initialized_variables = true;
140 sl_options.vertex.fixup_clipspace = true;
141 sl_options.vulkan_semantics = true;
142 gl_compiler->set_common_options(sl_options);
143 return CompilerBackend(gl_compiler);
144 }
145
146 static CompilerBackend CreateGLSLCompiler(const spirv_cross::ParsedIR& ir,
147 const SourceOptions& source_options) {
148 auto gl_compiler = std::make_shared<spirv_cross::CompilerGLSL>(ir);
149
150 // Walk the variables and insert the external image extension if any of them
151 // begins with the external texture prefix. Unfortunately, we can't walk
152 // `gl_compiler->get_shader_resources().separate_samplers` until the compiler
153 // is further along.
154 //
155 // Unfortunately, we can't just let the shader author add this extension and
156 // use `samplerExternalOES` directly because compiling to spirv requires the
157 // source language profile to be at least 310 ES, but this extension is
158 // incompatible with ES 310+.
159 for (auto& id : ir.ids_for_constant_or_variable) {
160 if (StringStartsWith(ir.get_name(id), kExternalTexturePrefix)) {
161 if (source_options.gles_language_version >= 300) {
162 gl_compiler->require_extension(kEGLImageExternalExtension300);
163 } else {
164 gl_compiler->require_extension(kEGLImageExternalExtension);
165 }
166 break;
167 }
168 }
169
170 spirv_cross::CompilerGLSL::Options sl_options;
171 sl_options.force_zero_initialized_variables = true;
172 sl_options.vertex.fixup_clipspace = true;
173 if (source_options.target_platform == TargetPlatform::kOpenGLES ||
174 source_options.target_platform == TargetPlatform::kRuntimeStageGLES ||
175 source_options.target_platform == TargetPlatform::kRuntimeStageGLES3) {
176 sl_options.version = source_options.gles_language_version > 0
177 ? source_options.gles_language_version
178 : 100;
179 sl_options.es = true;
180 if (source_options.target_platform == TargetPlatform::kRuntimeStageGLES3) {
181 sl_options.version = 300;
182 }
183 if (source_options.require_framebuffer_fetch &&
184 source_options.type == SourceType::kFragmentShader) {
185 gl_compiler->remap_ext_framebuffer_fetch(0, 0, true);
186 }
187 gl_compiler->set_variable_type_remap_callback(
188 [&](const spirv_cross::SPIRType& type, const std::string& var_name,
189 std::string& name_of_type) {
190 if (StringStartsWith(var_name, kExternalTexturePrefix)) {
191 name_of_type = "samplerExternalOES";
192 }
193 });
194 } else {
195 sl_options.version = source_options.gles_language_version > 0
196 ? source_options.gles_language_version
197 : 120;
198 sl_options.es = false;
199 }
200 gl_compiler->set_common_options(sl_options);
201 return CompilerBackend(gl_compiler);
202 }
203
204 static CompilerBackend CreateSkSLCompiler(const spirv_cross::ParsedIR& ir,
205 const SourceOptions& source_options) {
206 auto sksl_compiler = std::make_shared<CompilerSkSL>(ir);
207 return CompilerBackend(sksl_compiler);
208 }
209
210 static bool EntryPointMustBeNamedMain(TargetPlatform platform) {
211 switch (platform) {
212 case TargetPlatform::kUnknown:
213 FML_UNREACHABLE();
214 case TargetPlatform::kMetalDesktop:
215 case TargetPlatform::kMetalIOS:
216 case TargetPlatform::kVulkan:
217 case TargetPlatform::kRuntimeStageMetal:
218 case TargetPlatform::kRuntimeStageVulkan:
219 return false;
220 case TargetPlatform::kSkSL:
221 case TargetPlatform::kOpenGLES:
222 case TargetPlatform::kOpenGLDesktop:
223 case TargetPlatform::kRuntimeStageGLES:
224 case TargetPlatform::kRuntimeStageGLES3:
225 return true;
226 }
227 FML_UNREACHABLE();
228 }
229
230 static CompilerBackend CreateCompiler(const spirv_cross::ParsedIR& ir,
231 const SourceOptions& source_options) {
232 CompilerBackend compiler;
233 switch (source_options.target_platform) {
234 case TargetPlatform::kMetalDesktop:
235 case TargetPlatform::kMetalIOS:
236 case TargetPlatform::kRuntimeStageMetal:
237 compiler = CreateMSLCompiler(ir, source_options);
238 break;
239 case TargetPlatform::kVulkan:
240 case TargetPlatform::kRuntimeStageVulkan:
241 compiler = CreateVulkanCompiler(ir, source_options);
242 break;
243 case TargetPlatform::kUnknown:
244 case TargetPlatform::kOpenGLES:
245 case TargetPlatform::kOpenGLDesktop:
246 case TargetPlatform::kRuntimeStageGLES:
247 case TargetPlatform::kRuntimeStageGLES3:
248 compiler = CreateGLSLCompiler(ir, source_options);
249 break;
250 case TargetPlatform::kSkSL:
251 compiler = CreateSkSLCompiler(ir, source_options);
252 }
253 if (!compiler) {
254 return {};
255 }
256 auto* backend = compiler.GetCompiler();
257 if (!EntryPointMustBeNamedMain(source_options.target_platform) &&
258 source_options.source_language == SourceLanguage::kGLSL) {
259 backend->rename_entry_point("main", source_options.entry_point_name,
260 ToExecutionModel(source_options.type));
261 }
262 return compiler;
263 }
264
265 namespace {
266 uint32_t CalculateUBOSize(const spirv_cross::Compiler* compiler) {
267 spirv_cross::ShaderResources resources = compiler->get_shader_resources();
268 uint32_t result = 0;
269 for (const spirv_cross::Resource& ubo : resources.uniform_buffers) {
270 const spirv_cross::SPIRType& ubo_type =
271 compiler->get_type(ubo.base_type_id);
272 uint32_t size = compiler->get_declared_struct_size(ubo_type);
273 result += size;
274 }
275 return result;
276 }
277
278 } // namespace
279
280 Compiler::Compiler(const std::shared_ptr<const fml::Mapping>& source_mapping,
281 const SourceOptions& source_options,
282 Reflector::Options reflector_options)
283 : options_(source_options) {
284 if (!source_mapping || source_mapping->GetMapping() == nullptr) {
285 COMPILER_ERROR(error_stream_)
286 << "Could not read shader source or shader source was empty.";
287 return;
288 }
289
290 if (source_options.target_platform == TargetPlatform::kUnknown) {
291 COMPILER_ERROR(error_stream_) << "Target platform not specified.";
292 return;
293 }
294
295 SPIRVCompilerOptions spirv_options;
296
297 // Make sure reflection is as effective as possible. The generated shaders
298 // will be processed later by backend specific compilers.
299 spirv_options.generate_debug_info = true;
300
301 switch (options_.source_language) {
302 case SourceLanguage::kGLSL:
303 // Expects GLSL 4.60 (Core Profile).
304 // https://www.khronos.org/registry/OpenGL/specs/gl/GLSLangSpec.4.60.pdf
305 spirv_options.source_langauge =
306 shaderc_source_language::shaderc_source_language_glsl;
307 spirv_options.source_profile = SPIRVCompilerSourceProfile{
308 shaderc_profile::shaderc_profile_core, //
309 460, //
310 };
311 break;
312 case SourceLanguage::kHLSL:
313 spirv_options.source_langauge =
314 shaderc_source_language::shaderc_source_language_hlsl;
315 break;
316 case SourceLanguage::kUnknown:
317 COMPILER_ERROR(error_stream_) << "Source language invalid.";
318 return;
319 }
320
321 switch (source_options.target_platform) {
322 case TargetPlatform::kMetalDesktop:
323 case TargetPlatform::kMetalIOS: {
324 SPIRVCompilerTargetEnv target;
325
326 if (source_options.use_half_textures) {
327 target.env = shaderc_target_env::shaderc_target_env_opengl;
328 target.version = shaderc_env_version::shaderc_env_version_opengl_4_5;
329 target.spirv_version = shaderc_spirv_version::shaderc_spirv_version_1_0;
330 } else {
331 target.env = shaderc_target_env::shaderc_target_env_vulkan;
332 target.version = shaderc_env_version::shaderc_env_version_vulkan_1_1;
333 target.spirv_version = shaderc_spirv_version::shaderc_spirv_version_1_3;
334 }
335
336 spirv_options.target = target;
337 } break;
338 case TargetPlatform::kOpenGLES:
339 case TargetPlatform::kOpenGLDesktop:
340 case TargetPlatform::kVulkan:
341 case TargetPlatform::kRuntimeStageVulkan: {
342 SPIRVCompilerTargetEnv target;
343
344 target.env = shaderc_target_env::shaderc_target_env_vulkan;
345 target.version = shaderc_env_version::shaderc_env_version_vulkan_1_1;
346 target.spirv_version = shaderc_spirv_version::shaderc_spirv_version_1_3;
347
348 if (source_options.target_platform ==
349 TargetPlatform::kRuntimeStageVulkan) {
350 spirv_options.macro_definitions.push_back("IMPELLER_GRAPHICS_BACKEND");
351 spirv_options.relaxed_vulkan_rules = true;
352 }
353 spirv_options.target = target;
354 } break;
355 case TargetPlatform::kRuntimeStageMetal:
356 case TargetPlatform::kRuntimeStageGLES:
357 case TargetPlatform::kRuntimeStageGLES3: {
358 SPIRVCompilerTargetEnv target;
359
360 target.env = shaderc_target_env::shaderc_target_env_opengl;
361 target.version = shaderc_env_version::shaderc_env_version_opengl_4_5;
362 target.spirv_version = shaderc_spirv_version::shaderc_spirv_version_1_0;
363
364 spirv_options.target = target;
365 spirv_options.macro_definitions.push_back("IMPELLER_GRAPHICS_BACKEND");
366 } break;
367 case TargetPlatform::kSkSL: {
368 SPIRVCompilerTargetEnv target;
369
370 target.env = shaderc_target_env::shaderc_target_env_opengl;
371 target.version = shaderc_env_version::shaderc_env_version_opengl_4_5;
372 target.spirv_version = shaderc_spirv_version::shaderc_spirv_version_1_0;
373
374 // When any optimization level above 'zero' is enabled, the phi merges at
375 // loop continue blocks are rendered using syntax that is supported in
376 // GLSL, but not in SkSL.
377 // https://bugs.chromium.org/p/skia/issues/detail?id=13518.
378 spirv_options.optimization_level =
379 shaderc_optimization_level::shaderc_optimization_level_zero;
380 spirv_options.target = target;
381 spirv_options.macro_definitions.push_back("SKIA_GRAPHICS_BACKEND");
382 } break;
383 case TargetPlatform::kUnknown:
384 COMPILER_ERROR(error_stream_) << "Target platform invalid.";
385 return;
386 }
387
388 // Implicit definition that indicates that this compilation is for the device
389 // (instead of the host).
390 spirv_options.macro_definitions.push_back("IMPELLER_DEVICE");
391 for (const auto& define : source_options.defines) {
392 spirv_options.macro_definitions.push_back(define);
393 }
394
395 std::vector<std::string> included_file_names;
396 spirv_options.includer = std::make_shared<Includer>(
397 options_.working_directory, options_.include_dirs,
398 [&included_file_names](auto included_name) {
399 included_file_names.emplace_back(std::move(included_name));
400 });
401
402 // SPIRV Generation.
403 SPIRVCompiler spv_compiler(source_options, source_mapping);
404
405 spirv_assembly_ = spv_compiler.CompileToSPV(
406 error_stream_, spirv_options.BuildShadercOptions());
407
408 if (!spirv_assembly_) {
409 return;
410 } else {
411 included_file_names_ = std::move(included_file_names);
412 }
413
414 // SL Generation.
415 spirv_cross::Parser parser(
416 reinterpret_cast<const uint32_t*>(spirv_assembly_->GetMapping()),
417 spirv_assembly_->GetSize() / sizeof(uint32_t));
418 // The parser and compiler must be run separately because the parser contains
419 // meta information (like type member names) that are useful for reflection.
420 parser.parse();
421
422 const auto parsed_ir =
423 std::make_shared<spirv_cross::ParsedIR>(parser.get_parsed_ir());
424
425 auto sl_compiler = CreateCompiler(*parsed_ir, options_);
426
427 if (!sl_compiler) {
428 COMPILER_ERROR(error_stream_)
429 << "Could not create compiler for target platform.";
430 return;
431 }
432
433 uint32_t ubo_size = CalculateUBOSize(sl_compiler.GetCompiler());
434 if (ubo_size > kMaxUniformBufferSize) {
435 COMPILER_ERROR(error_stream_) << "Uniform buffer size exceeds max ("
436 << kMaxUniformBufferSize << "): " << ubo_size;
437 return;
438 }
439
440 // We need to invoke the compiler even if we don't use the SL mapping later
441 // for Vulkan. The reflector needs information that is only valid after a
442 // successful compilation call.
443 auto sl_compilation_result =
444 CreateMappingWithString(sl_compiler.GetCompiler()->compile());
445
446 // If the target is Vulkan, our shading language is SPIRV which we already
447 // have. We just need to strip it of debug information. If it isn't, we need
448 // to invoke the appropriate compiler to compile the SPIRV to the target SL.
449 if (source_options.target_platform == TargetPlatform::kVulkan ||
450 source_options.target_platform == TargetPlatform::kRuntimeStageVulkan) {
451 auto stripped_spirv_options = spirv_options;
452 stripped_spirv_options.generate_debug_info = false;
453 sl_mapping_ = spv_compiler.CompileToSPV(
454 error_stream_, stripped_spirv_options.BuildShadercOptions());
455 } else {
456 sl_mapping_ = sl_compilation_result;
457 }
458
459 if (!sl_mapping_) {
460 COMPILER_ERROR(error_stream_) << "Could not generate SL from SPIRV";
461 return;
462 }
463
464 reflector_ = std::make_unique<Reflector>(std::move(reflector_options), //
465 parsed_ir, //
466 GetSLShaderSource(), //
467 sl_compiler //
468 );
469
470 if (!reflector_->IsValid()) {
471 COMPILER_ERROR(error_stream_)
472 << "Could not complete reflection on generated shader.";
473 return;
474 }
475
476 is_valid_ = true;
477 }
478
479 Compiler::~Compiler() = default;
480
481 std::shared_ptr<fml::Mapping> Compiler::GetSPIRVAssembly() const {
482 return spirv_assembly_;
483 }
484
485 std::shared_ptr<fml::Mapping> Compiler::GetSLShaderSource() const {
486 return sl_mapping_;
487 }
488
489 bool Compiler::IsValid() const {
490 return is_valid_;
491 }
492
493 std::string Compiler::GetSourcePrefix() const {
494 std::stringstream stream;
495 stream << options_.file_name << ": ";
496 return stream.str();
497 }
498
499 std::string Compiler::GetErrorMessages() const {
500 return error_stream_.str();
501 }
502
503 const std::vector<std::string>& Compiler::GetIncludedFileNames() const {
504 return included_file_names_;
505 }
506
507 static std::string JoinStrings(std::vector<std::string> items,
508 const std::string& separator) {
509 std::stringstream stream;
510 for (size_t i = 0, count = items.size(); i < count; i++) {
511 const auto is_last = (i == count - 1);
512
513 stream << items[i];
514 if (!is_last) {
515 stream << separator;
516 }
517 }
518 return stream.str();
519 }
520
521 std::string Compiler::GetDependencyNames(const std::string& separator) const {
522 std::vector<std::string> dependencies = included_file_names_;
523 dependencies.push_back(options_.file_name);
524 return JoinStrings(dependencies, separator);
525 }
526
527 std::unique_ptr<fml::Mapping> Compiler::CreateDepfileContents(
528 std::initializer_list<std::string> targets_names) const {
529 // https://github.com/ninja-build/ninja/blob/master/src/depfile_parser.cc#L28
530 const auto targets = JoinStrings(targets_names, " ");
531 const auto dependencies = GetDependencyNames(" ");
532
533 std::stringstream stream;
534 stream << targets << ": " << dependencies << "\n";
535
536 auto contents = std::make_shared<std::string>(stream.str());
537 return std::make_unique<fml::NonOwnedMapping>(
538 reinterpret_cast<const uint8_t*>(contents->data()), contents->size(),
539 [contents](auto, auto) {});
540 }
541
542 const Reflector* Compiler::GetReflector() const {
543 return reflector_.get();
544 }
545
546 } // namespace compiler
547 } // namespace impeller
allocation.h
type
GLenum type
Definition: blit_command_gles.cc:151
impeller::compiler::Compiler::GetSPIRVAssembly
std::shared_ptr< fml::Mapping > GetSPIRVAssembly() const
Definition: compiler.cc:481
impeller::compiler::Compiler::GetReflector
const Reflector * GetReflector() const
Definition: compiler.cc:542
impeller::compiler::Compiler::Compiler
Compiler(const std::shared_ptr< const fml::Mapping > &source_mapping, const SourceOptions &options, Reflector::Options reflector_options)
Definition: compiler.cc:280
impeller::compiler::Compiler::GetIncludedFileNames
const std::vector< std::string > & GetIncludedFileNames() const
Definition: compiler.cc:503
impeller::compiler::Compiler::CreateDepfileContents
std::unique_ptr< fml::Mapping > CreateDepfileContents(std::initializer_list< std::string > targets) const
Definition: compiler.cc:527
impeller::compiler::Compiler::~Compiler
~Compiler()
impeller::compiler::Compiler::IsValid
bool IsValid() const
Definition: compiler.cc:489
impeller::compiler::Compiler::GetSLShaderSource
std::shared_ptr< fml::Mapping > GetSLShaderSource() const
Definition: compiler.cc:485
impeller::compiler::Compiler::GetErrorMessages
std::string GetErrorMessages() const
Definition: compiler.cc:499
impeller::compiler::Reflector
Definition: reflector.h:144
impeller::compiler::SPIRVCompiler
Definition: spirv_compiler.h:57
impeller::compiler::SPIRVCompiler::CompileToSPV
std::shared_ptr< fml::Mapping > CompileToSPV(std::stringstream &error_stream, const shaderc::CompileOptions &spirv_options) const
Definition: spirv_compiler.cc:21
constants.h
types.h
compiler.h
compiler_backend.h
includer.h
logger.h
COMPILER_ERROR
#define COMPILER_ERROR(stream)
Definition: logger.h:39
impeller::compiler::SourceType::kFragmentShader
@ kFragmentShader
impeller::compiler::SourceType::kVertexShader
@ kVertexShader
impeller::compiler::CreateSkSLCompiler
static CompilerBackend CreateSkSLCompiler(const spirv_cross::ParsedIR &ir, const SourceOptions &source_options)
Definition: compiler.cc:204
impeller::compiler::kMaxUniformBufferSize
static const uint32_t kMaxUniformBufferSize
Definition: compiler.cc:38
impeller::compiler::CreateVulkanCompiler
static CompilerBackend CreateVulkanCompiler(const spirv_cross::ParsedIR &ir, const SourceOptions &source_options)
Definition: compiler.cc:134
impeller::compiler::SourceLanguage::kUnknown
@ kUnknown
impeller::compiler::SourceLanguage::kGLSL
@ kGLSL
impeller::compiler::SourceLanguage::kHLSL
@ kHLSL
impeller::compiler::kExternalTexturePrefix
constexpr char kExternalTexturePrefix[]
Definition: constants.h:11
impeller::compiler::EntryPointMustBeNamedMain
static bool EntryPointMustBeNamedMain(TargetPlatform platform)
Definition: compiler.cc:210
impeller::compiler::CreateMSLCompiler
static CompilerBackend CreateMSLCompiler(const spirv_cross::ParsedIR &ir, const SourceOptions &source_options, std::optional< uint32_t > msl_version_override={})
Definition: compiler.cc:63
impeller::compiler::CreateCompiler
static CompilerBackend CreateCompiler(const spirv_cross::ParsedIR &ir, const SourceOptions &source_options)
Definition: compiler.cc:230
impeller::compiler::JoinStrings
static std::string JoinStrings(std::vector< std::string > items, const std::string &separator)
Definition: compiler.cc:507
impeller::compiler::TargetPlatformToMSLPlatform
spirv_cross::CompilerMSL::Options::Platform TargetPlatformToMSLPlatform(TargetPlatform platform)
Definition: types.cc:215
impeller::compiler::ParseMSLVersion
static uint32_t ParseMSLVersion(const std::string &msl_version)
Definition: compiler.cc:40
impeller::compiler::StringStartsWith
bool StringStartsWith(const std::string &target, const std::string &prefix)
Definition: utilities.cc:87
impeller::compiler::TargetPlatform
TargetPlatform
Definition: types.h:28
impeller::compiler::TargetPlatform::kRuntimeStageMetal
@ kRuntimeStageMetal
impeller::compiler::TargetPlatform::kOpenGLES
@ kOpenGLES
impeller::compiler::TargetPlatform::kUnknown
@ kUnknown
impeller::compiler::TargetPlatform::kRuntimeStageVulkan
@ kRuntimeStageVulkan
impeller::compiler::TargetPlatform::kRuntimeStageGLES3
@ kRuntimeStageGLES3
impeller::compiler::TargetPlatform::kVulkan
@ kVulkan
impeller::compiler::TargetPlatform::kMetalDesktop
@ kMetalDesktop
impeller::compiler::TargetPlatform::kMetalIOS
@ kMetalIOS
impeller::compiler::TargetPlatform::kSkSL
@ kSkSL
impeller::compiler::TargetPlatform::kOpenGLDesktop
@ kOpenGLDesktop
impeller::compiler::TargetPlatform::kRuntimeStageGLES
@ kRuntimeStageGLES
impeller::compiler::CreateGLSLCompiler
static CompilerBackend CreateGLSLCompiler(const spirv_cross::ParsedIR &ir, const SourceOptions &source_options)
Definition: compiler.cc:146
impeller::compiler::ToExecutionModel
spv::ExecutionModel ToExecutionModel(SourceType type)
Definition: types.cc:201
impeller
Definition: allocation.cc:12
impeller::SortUniforms
std::vector< spirv_cross::ID > SortUniforms(const spirv_cross::ParsedIR *ir, const spirv_cross::Compiler *compiler, std::optional< spirv_cross::SPIRType::BaseType > type_filter, bool include)
Sorts uniform declarations in an IR according to decoration order.
Definition: uniform_sorter.cc:11
impeller::CreateMappingWithString
std::shared_ptr< fml::Mapping > CreateMappingWithString(std::string string)
Creates a mapping with string data.
Definition: allocation.cc:111
spirv_compiler.h
impeller::compiler::CompilerBackend
Definition: compiler_backend.h:19
impeller::compiler::CompilerBackend::GetCompiler
spirv_cross::Compiler * GetCompiler()
Definition: compiler_backend.cc:70
impeller::compiler::Reflector::Options
Definition: reflector.h:146
impeller::compiler::SPIRVCompilerOptions
Definition: spirv_compiler.h:32
impeller::compiler::SPIRVCompilerOptions::source_langauge
std::optional< shaderc_source_language > source_langauge
Definition: spirv_compiler.h:37
impeller::compiler::SPIRVCompilerOptions::macro_definitions
std::vector< std::string > macro_definitions
Definition: spirv_compiler.h:48
impeller::compiler::SPIRVCompilerOptions::relaxed_vulkan_rules
bool relaxed_vulkan_rules
Definition: spirv_compiler.h:52
impeller::compiler::SPIRVCompilerOptions::optimization_level
shaderc_optimization_level optimization_level
Definition: spirv_compiler.h:40
impeller::compiler::SPIRVCompilerOptions::source_profile
std::optional< SPIRVCompilerSourceProfile > source_profile
Definition: spirv_compiler.h:38
impeller::compiler::SPIRVCompilerOptions::includer
std::shared_ptr< Includer > includer
Definition: spirv_compiler.h:50
impeller::compiler::SPIRVCompilerOptions::generate_debug_info
bool generate_debug_info
Definition: spirv_compiler.h:33
impeller::compiler::SPIRVCompilerOptions::BuildShadercOptions
shaderc::CompileOptions BuildShadercOptions() const
Definition: spirv_compiler.cc:277
impeller::compiler::SPIRVCompilerOptions::target
std::optional< SPIRVCompilerTargetEnv > target
Definition: spirv_compiler.h:46
impeller::compiler::SPIRVCompilerSourceProfile
Definition: spirv_compiler.h:19
impeller::compiler::SPIRVCompilerTargetEnv
Definition: spirv_compiler.h:24
impeller::compiler::SPIRVCompilerTargetEnv::spirv_version
shaderc_spirv_version spirv_version
Definition: spirv_compiler.h:28
impeller::compiler::SPIRVCompilerTargetEnv::env
shaderc_target_env env
Definition: spirv_compiler.h:25
impeller::compiler::SPIRVCompilerTargetEnv::version
shaderc_env_version version
Definition: spirv_compiler.h:26
impeller::compiler::SourceOptions
Definition: source_options.h:20
impeller::compiler::SourceOptions::gles_language_version
uint32_t gles_language_version
Definition: source_options.h:28
impeller::compiler::SourceOptions::use_half_textures
bool use_half_textures
Whether half-precision textures should be supported, requiring opengl semantics. Only used on metal t...
Definition: source_options.h:35
impeller::compiler::SourceOptions::source_language
SourceLanguage source_language
Definition: source_options.h:23
impeller::compiler::SourceOptions::include_dirs
std::vector< IncludeDir > include_dirs
Definition: source_options.h:25
impeller::compiler::SourceOptions::file_name
std::string file_name
Definition: source_options.h:26
impeller::compiler::SourceOptions::require_framebuffer_fetch
bool require_framebuffer_fetch
Whether the GLSL framebuffer fetch extension will be required.
Definition: source_options.h:40
impeller::compiler::SourceOptions::entry_point_name
std::string entry_point_name
Definition: source_options.h:27
impeller::compiler::SourceOptions::target_platform
TargetPlatform target_platform
Definition: source_options.h:22
impeller::compiler::SourceOptions::type
SourceType type
Definition: source_options.h:21
impeller::compiler::SourceOptions::working_directory
std::shared_ptr< fml::UniqueFD > working_directory
Definition: source_options.h:24
impeller::compiler::SourceOptions::metal_version
std::string metal_version
Definition: source_options.h:31
impeller::compiler::SourceOptions::defines
std::vector< std::string > defines
Definition: source_options.h:29
uniform_sorter.h
utilities.h