blob: 2c46cc07fa861126784f2d1d8c4e775765425069 [file] [log] [blame]
John Kessenicha0af4732012-12-12 21:15:54 +00001//
John Kessenich927608b2017-01-06 12:34:14 -07002// Copyright (C) 2002-2005 3Dlabs Inc. Ltd.
3// Copyright (C) 2013-2016 LunarG, Inc.
John Kessenichbd0747d2013-02-17 06:01:50 +00004//
John Kessenich927608b2017-01-06 12:34:14 -07005// All rights reserved.
John Kessenicha0af4732012-12-12 21:15:54 +00006//
John Kessenich927608b2017-01-06 12:34:14 -07007// Redistribution and use in source and binary forms, with or without
8// modification, are permitted provided that the following conditions
9// are met:
John Kessenicha0af4732012-12-12 21:15:54 +000010//
11// Redistributions of source code must retain the above copyright
12// notice, this list of conditions and the following disclaimer.
13//
14// Redistributions in binary form must reproduce the above
15// copyright notice, this list of conditions and the following
16// disclaimer in the documentation and/or other materials provided
17// with the distribution.
18//
19// Neither the name of 3Dlabs Inc. Ltd. nor the names of its
20// contributors may be used to endorse or promote products derived
21// from this software without specific prior written permission.
22//
John Kessenich927608b2017-01-06 12:34:14 -070023// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
24// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
25// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
26// FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
27// COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
28// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
29// BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
30// LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
31// CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32// LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
33// ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34// POSSIBILITY OF SUCH DAMAGE.
John Kessenicha0af4732012-12-12 21:15:54 +000035//
John Kessenich05a70632013-09-17 19:26:08 +000036
37// this only applies to the standalone wrapper, not the front end in general
Aras Pranckevicius8e204b22017-05-10 16:52:50 +030038#ifndef _CRT_SECURE_NO_WARNINGS
John Kessenich05a70632013-09-17 19:26:08 +000039#define _CRT_SECURE_NO_WARNINGS
Aras Pranckevicius8e204b22017-05-10 16:52:50 +030040#endif
John Kessenich05a70632013-09-17 19:26:08 +000041
Lei Zhang8a9b1ee2016-05-19 13:31:43 -040042#include "ResourceLimits.h"
John Kessenich2b07c7e2013-07-31 18:44:13 +000043#include "Worklist.h"
John Kessenich3494b4d2017-05-22 15:00:42 -060044#include "DirStackFileIncluder.h"
John Kessenicha0af4732012-12-12 21:15:54 +000045#include "./../glslang/Include/ShHandle.h"
John Kessenich0da9eaa2015-08-01 17:10:02 -060046#include "./../glslang/Include/revision.h"
John Kessenicha0af4732012-12-12 21:15:54 +000047#include "./../glslang/Public/ShaderLang.h"
John Kessenich0df0cde2015-03-03 17:09:43 +000048#include "../SPIRV/GlslangToSpv.h"
John Kessenich5e4b1242015-08-06 22:53:06 -060049#include "../SPIRV/GLSL.std.450.h"
John Kessenichacba7722015-03-04 03:48:38 +000050#include "../SPIRV/doc.h"
51#include "../SPIRV/disassemble.h"
John Kessenich3494b4d2017-05-22 15:00:42 -060052
John Kessenich66ec80e2016-08-05 14:04:23 -060053#include <cstring>
54#include <cstdlib>
steve-lunarg7f7c2ed2016-09-07 15:20:19 -060055#include <cctype>
John Kessenich66ec80e2016-08-05 14:04:23 -060056#include <cmath>
steve-lunarg7f7c2ed2016-09-07 15:20:19 -060057#include <array>
Juan Lopeza558b262017-04-02 23:04:00 +020058#include <memory>
59#include <thread>
John Kessenicha0af4732012-12-12 21:15:54 +000060
baldurk876a0e32015-11-16 18:03:28 +010061#include "../glslang/OSDependent/osinclude.h"
John Kessenicha0af4732012-12-12 21:15:54 +000062
63extern "C" {
64 SH_IMPORT_EXPORT void ShOutputHtml();
65}
66
John Kessenich94a81fb2013-08-31 02:41:30 +000067// Command-line options
68enum TOptions {
John Kessenich906cc212016-12-09 19:22:20 -070069 EOptionNone = 0,
70 EOptionIntermediate = (1 << 0),
71 EOptionSuppressInfolog = (1 << 1),
72 EOptionMemoryLeakMode = (1 << 2),
73 EOptionRelaxedErrors = (1 << 3),
74 EOptionGiveWarnings = (1 << 4),
75 EOptionLinkProgram = (1 << 5),
76 EOptionMultiThreaded = (1 << 6),
77 EOptionDumpConfig = (1 << 7),
78 EOptionDumpReflection = (1 << 8),
79 EOptionSuppressWarnings = (1 << 9),
80 EOptionDumpVersions = (1 << 10),
81 EOptionSpv = (1 << 11),
82 EOptionHumanReadableSpv = (1 << 12),
83 EOptionVulkanRules = (1 << 13),
84 EOptionDefaultDesktop = (1 << 14),
85 EOptionOutputPreprocessed = (1 << 15),
86 EOptionOutputHexadecimal = (1 << 16),
87 EOptionReadHlsl = (1 << 17),
88 EOptionCascadingErrors = (1 << 18),
89 EOptionAutoMapBindings = (1 << 19),
steve-lunarge0b9deb2016-09-16 13:26:37 -060090 EOptionFlattenUniformArrays = (1 << 20),
John Kessenich906cc212016-12-09 19:22:20 -070091 EOptionNoStorageFormat = (1 << 21),
John Kessenich20f01e72016-12-12 11:41:43 -070092 EOptionKeepUncalled = (1 << 22),
John Kessenich4f1403e2017-04-05 17:38:20 -060093 EOptionHlslOffsets = (1 << 23),
steve-lunargbe283552017-04-18 12:18:01 -060094 EOptionHlslIoMapping = (1 << 24),
John Kessenich71facdf2017-05-17 18:28:19 -060095 EOptionAutoMapLocations = (1 << 25),
John Kessenich121853f2017-05-31 17:11:16 -060096 EOptionDebug = (1 << 26),
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +020097 EOptionStdin = (1 << 27),
John Kessenich94a81fb2013-08-31 02:41:30 +000098};
99
John Kessenicha0af4732012-12-12 21:15:54 +0000100//
John Kessenich68d78fd2015-07-12 19:28:10 -0600101// Return codes from main/exit().
John Kessenicha0af4732012-12-12 21:15:54 +0000102//
103enum TFailCode {
104 ESuccess = 0,
105 EFailUsage,
106 EFailCompile,
107 EFailLink,
108 EFailCompilerCreate,
John Kessenich2b07c7e2013-07-31 18:44:13 +0000109 EFailThreadCreate,
John Kessenicha0af4732012-12-12 21:15:54 +0000110 EFailLinkerCreate
111};
112
113//
John Kessenich68d78fd2015-07-12 19:28:10 -0600114// Forward declarations.
John Kessenicha0af4732012-12-12 21:15:54 +0000115//
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600116EShLanguage FindLanguage(const std::string& name, bool parseSuffix=true);
John Kessenich51cdd902014-02-18 23:37:57 +0000117void CompileFile(const char* fileName, ShHandle);
John Kessenicha0af4732012-12-12 21:15:54 +0000118void usage();
John Kessenich04acb1b2017-06-14 17:36:50 -0600119char* ReadFileData(const char* fileName);
120void FreeFileData(char* data);
John Kessenich54d8cda2013-02-11 22:36:01 +0000121void InfoLogMsg(const char* msg, const char* name, const int num);
John Kessenich41cf6b52013-06-25 18:10:05 +0000122
John Kessenichc999ba22013-11-07 23:33:24 +0000123// Globally track if any compile or link failure.
124bool CompileFailed = false;
125bool LinkFailed = false;
126
John Kessenich05a70632013-09-17 19:26:08 +0000127TBuiltInResource Resources;
128std::string ConfigFile;
129
John Kessenicha0af4732012-12-12 21:15:54 +0000130//
John Kessenichf0bcb0a2016-04-02 13:09:14 -0600131// Parse either a .conf file provided by the user or the default from glslang::DefaultTBuiltInResource
John Kessenich05a70632013-09-17 19:26:08 +0000132//
133void ProcessConfigFile()
John Kessenichb51f62c2013-04-11 16:31:09 +0000134{
John Kessenich04acb1b2017-06-14 17:36:50 -0600135 if (ConfigFile.size() == 0)
Lei Zhang414eb602016-03-04 16:22:34 -0500136 Resources = glslang::DefaultTBuiltInResource;
John Kessenich04acb1b2017-06-14 17:36:50 -0600137 else {
138 char* configString = ReadFileData(ConfigFile.c_str());
139 glslang::DecodeResourceLimits(&Resources, configString);
140 FreeFileData(configString);
John Kessenich05a70632013-09-17 19:26:08 +0000141 }
John Kessenicha0af4732012-12-12 21:15:54 +0000142}
143
John Kessenich94a81fb2013-08-31 02:41:30 +0000144int Options = 0;
John Kessenich68d78fd2015-07-12 19:28:10 -0600145const char* ExecutableName = nullptr;
146const char* binaryFileName = nullptr;
John Kessenich4d65ee32016-03-12 18:17:47 -0700147const char* entryPointName = nullptr;
steve-lunargf1e0c872016-10-31 15:13:43 -0600148const char* sourceEntryPointName = nullptr;
Dan Bakerc6ede892016-08-11 14:06:06 -0400149const char* shaderStageName = nullptr;
Flavioaea3c892017-02-06 11:46:35 -0800150const char* variableName = nullptr;
John Kessenich971a0a82017-06-07 15:06:58 -0600151std::vector<std::string> IncludeDirectoryList;
John Kessenich6353d552017-06-23 11:11:09 -0600152int ClientInputSemanticsVersion = 100; // maps to, say, #define VULKAN 100
153int VulkanClientVersion = 100; // would map to, say, Vulkan 1.0
154int OpenGLClientVersion = 450; // doesn't influence anything yet, but maps to OpenGL 4.50
155unsigned int TargetVersion = 0x00001000; // maps to, say, SPIR-V 1.0
John Kessenich2a271162017-07-20 20:00:36 -0600156std::vector<std::string> Processes; // what should be recorded by OpModuleProcessed, or equivalent
John Kessenich68d78fd2015-07-12 19:28:10 -0600157
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600158std::array<unsigned int, EShLangCount> baseSamplerBinding;
159std::array<unsigned int, EShLangCount> baseTextureBinding;
steve-lunarg9088be42016-11-01 10:31:42 -0600160std::array<unsigned int, EShLangCount> baseImageBinding;
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600161std::array<unsigned int, EShLangCount> baseUboBinding;
steve-lunarg932bb5c2017-02-21 17:19:08 -0700162std::array<unsigned int, EShLangCount> baseSsboBinding;
steve-lunargbe283552017-04-18 12:18:01 -0600163std::array<unsigned int, EShLangCount> baseUavBinding;
Hyangran Park36dc8292017-05-02 16:27:29 +0900164std::array<std::vector<std::string>, EShLangCount> baseResourceSetBinding;
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600165
John Kessenicha9313662017-06-15 10:40:49 -0600166// Add things like "#define ..." to a preamble to use in the beginning of the shader.
167class TPreamble {
168public:
169 TPreamble() { }
170
171 bool isSet() const { return text.size() > 0; }
172 const char* get() const { return text.c_str(); }
173
174 // #define...
175 void addDef(std::string def)
176 {
177 text.append("#define ");
178 fixLine(def);
179
John Kessenich2a271162017-07-20 20:00:36 -0600180 Processes.push_back("D");
181 Processes.back().append(def);
182
John Kessenicha9313662017-06-15 10:40:49 -0600183 // The first "=" needs to turn into a space
LoopDawgb97b25e2017-07-12 09:04:39 -0600184 const size_t equal = def.find_first_of("=");
John Kessenicha9313662017-06-15 10:40:49 -0600185 if (equal != def.npos)
186 def[equal] = ' ';
187
188 text.append(def);
189 text.append("\n");
190 }
191
192 // #undef...
193 void addUndef(std::string undef)
194 {
195 text.append("#undef ");
196 fixLine(undef);
John Kessenich2a271162017-07-20 20:00:36 -0600197
198 Processes.push_back("U");
199 Processes.back().append(undef);
200
John Kessenicha9313662017-06-15 10:40:49 -0600201 text.append(undef);
202 text.append("\n");
203 }
204
205protected:
206 void fixLine(std::string& line)
207 {
208 // Can't go past a newline in the line
LoopDawgb97b25e2017-07-12 09:04:39 -0600209 const size_t end = line.find_first_of("\n");
John Kessenicha9313662017-06-15 10:40:49 -0600210 if (end != line.npos)
211 line = line.substr(0, end);
212 }
213
214 std::string text; // contents of preamble
215};
216
217TPreamble UserPreamble;
218
John Kessenich68d78fd2015-07-12 19:28:10 -0600219//
220// Create the default name for saving a binary if -o is not provided.
221//
222const char* GetBinaryName(EShLanguage stage)
223{
224 const char* name;
225 if (binaryFileName == nullptr) {
226 switch (stage) {
227 case EShLangVertex: name = "vert.spv"; break;
228 case EShLangTessControl: name = "tesc.spv"; break;
229 case EShLangTessEvaluation: name = "tese.spv"; break;
230 case EShLangGeometry: name = "geom.spv"; break;
231 case EShLangFragment: name = "frag.spv"; break;
232 case EShLangCompute: name = "comp.spv"; break;
233 default: name = "unknown"; break;
234 }
235 } else
236 name = binaryFileName;
237
238 return name;
239}
John Kessenich2b07c7e2013-07-31 18:44:13 +0000240
John Kessenich05a70632013-09-17 19:26:08 +0000241//
242// *.conf => this is a config file that can set limits/resources
243//
244bool SetConfigFile(const std::string& name)
245{
246 if (name.size() < 5)
247 return false;
248
John Kessenich4c706852013-10-11 16:28:43 +0000249 if (name.compare(name.size() - 5, 5, ".conf") == 0) {
John Kessenich05a70632013-09-17 19:26:08 +0000250 ConfigFile = name;
251 return true;
252 }
253
254 return false;
255}
256
John Kessenich68d78fd2015-07-12 19:28:10 -0600257//
258// Give error and exit with failure code.
259//
260void Error(const char* message)
261{
262 printf("%s: Error %s (use -h for usage)\n", ExecutableName, message);
263 exit(EFailUsage);
264}
265
266//
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600267// Process an optional binding base of the form:
268// --argname [stage] base
269// Where stage is one of the forms accepted by FindLanguage, and base is an integer
270//
271void ProcessBindingBase(int& argc, char**& argv, std::array<unsigned int, EShLangCount>& base)
272{
273 if (argc < 2)
274 usage();
275
276 if (!isdigit(argv[1][0])) {
277 if (argc < 3) // this form needs one more argument
278 usage();
John Kessenichecba76f2017-01-06 00:34:48 -0700279
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600280 // Parse form: --argname stage base
281 const EShLanguage lang = FindLanguage(argv[1], false);
282 base[lang] = atoi(argv[2]);
283 argc-= 2;
284 argv+= 2;
285 } else {
286 // Parse form: --argname base
287 for (int lang=0; lang<EShLangCount; ++lang)
288 base[lang] = atoi(argv[1]);
289
290 argc--;
291 argv++;
292 }
293}
294
Hyangran Park36dc8292017-05-02 16:27:29 +0900295void ProcessResourceSetBindingBase(int& argc, char**& argv, std::array<std::vector<std::string>, EShLangCount>& base)
296{
297 if (argc < 2)
298 usage();
299
300 if (!isdigit(argv[1][0])) {
LoopDawg52017192017-07-14 15:15:47 -0600301 if (argc < 3) // this form needs one more argument
Hyangran Park36dc8292017-05-02 16:27:29 +0900302 usage();
303
LoopDawg52017192017-07-14 15:15:47 -0600304 // Parse form: --argname stage [regname set base...], or:
305 // --argname stage set
Hyangran Park36dc8292017-05-02 16:27:29 +0900306 const EShLanguage lang = FindLanguage(argv[1], false);
307
LoopDawg52017192017-07-14 15:15:47 -0600308 argc--;
309 argv++;
310
311 while (argc > 1 && argv[1] != nullptr && argv[1][0] != '-') {
312 base[lang].push_back(argv[1]);
313
314 argc--;
315 argv++;
Hyangran Park36dc8292017-05-02 16:27:29 +0900316 }
LoopDawg52017192017-07-14 15:15:47 -0600317
318 // Must have one arg, or a multiple of three (for [regname set binding] triples)
319 if (base[lang].size() != 1 && (base[lang].size() % 3) != 0)
320 usage();
321
Hyangran Park36dc8292017-05-02 16:27:29 +0900322 } else {
LoopDawg52017192017-07-14 15:15:47 -0600323 // Parse form: --argname set
Hyangran Park36dc8292017-05-02 16:27:29 +0900324 for (int lang=0; lang<EShLangCount; ++lang)
325 base[lang].push_back(argv[1]);
326
327 argc--;
328 argv++;
329 }
330}
331
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600332//
John Kessenich68d78fd2015-07-12 19:28:10 -0600333// Do all command-line argument parsing. This includes building up the work-items
334// to be processed later, and saving all the command-line options.
335//
336// Does not return (it exits) if command-line is fatally flawed.
337//
Juan Lopeza558b262017-04-02 23:04:00 +0200338void ProcessArguments(std::vector<std::unique_ptr<glslang::TWorkItem>>& workItems, int argc, char* argv[])
John Kessenich2b07c7e2013-07-31 18:44:13 +0000339{
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600340 baseSamplerBinding.fill(0);
341 baseTextureBinding.fill(0);
steve-lunarg9088be42016-11-01 10:31:42 -0600342 baseImageBinding.fill(0);
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600343 baseUboBinding.fill(0);
steve-lunarg932bb5c2017-02-21 17:19:08 -0700344 baseSsboBinding.fill(0);
steve-lunargbe283552017-04-18 12:18:01 -0600345 baseUavBinding.fill(0);
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600346
John Kessenich38f3b892013-09-06 19:52:57 +0000347 ExecutableName = argv[0];
Juan Lopeza558b262017-04-02 23:04:00 +0200348 workItems.reserve(argc);
John Kessenich38f3b892013-09-06 19:52:57 +0000349
John Kessenichc178f0a2017-06-23 10:58:31 -0600350 const auto bumpArg = [&]() {
351 if (argc > 0) {
352 argc--;
353 argv++;
354 }
355 };
356
357 // read a string directly attached to a single-letter option
John Kessenich6263fb12017-06-14 15:52:44 -0600358 const auto getStringOperand = [&](const char* desc) {
359 if (argv[0][2] == 0) {
360 printf("%s must immediately follow option (no spaces)\n", desc);
361 exit(EFailUsage);
362 }
363 return argv[0] + 2;
364 };
365
John Kessenich6353d552017-06-23 11:11:09 -0600366 // read a number attached to a single-letter option
367 const auto getAttachedNumber = [&](const char* desc) {
368 int num = atoi(argv[0] + 2);
369 if (num == 0) {
370 printf("%s: expected attached non-0 number\n", desc);
371 exit(EFailUsage);
372 }
373 return num;
374 };
375
376 // minimum needed (without overriding something else) to target Vulkan SPIR-V
377 const auto setVulkanSpv = []() {
378 Options |= EOptionSpv;
379 Options |= EOptionVulkanRules;
380 Options |= EOptionLinkProgram;
381 };
382
383 // minimum needed (without overriding something else) to target OpenGL SPIR-V
384 const auto setOpenGlSpv = []() {
385 Options |= EOptionSpv;
386 Options |= EOptionLinkProgram;
387 // undo a -H default to Vulkan
388 Options &= ~EOptionVulkanRules;
389 };
390
John Kessenichc178f0a2017-06-23 10:58:31 -0600391 for (bumpArg(); argc >= 1; bumpArg()) {
John Kessenich2b07c7e2013-07-31 18:44:13 +0000392 if (argv[0][0] == '-') {
John Kessenich2aa7f3a2015-05-15 16:02:07 +0000393 switch (argv[0][1]) {
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600394 case '-':
395 {
396 std::string lowerword(argv[0]+2);
397 std::transform(lowerword.begin(), lowerword.end(), lowerword.begin(), ::tolower);
398
399 // handle --word style options
John Kessenich6263fb12017-06-14 15:52:44 -0600400 if (lowerword == "auto-map-bindings" || // synonyms
John Kessenich6353d552017-06-23 11:11:09 -0600401 lowerword == "auto-map-binding" ||
402 lowerword == "amb") {
John Kessenich6263fb12017-06-14 15:52:44 -0600403 Options |= EOptionAutoMapBindings;
404 } else if (lowerword == "auto-map-locations" || // synonyms
405 lowerword == "aml") {
406 Options |= EOptionAutoMapLocations;
John Kessenich6353d552017-06-23 11:11:09 -0600407 } else if (lowerword == "client") {
408 if (argc > 1) {
409 if (strcmp(argv[1], "vulkan100") == 0)
410 setVulkanSpv();
411 else if (strcmp(argv[1], "opengl100") == 0)
412 setOpenGlSpv();
413 else
414 Error("--client expects vulkan100 or opengl100");
415 }
416 bumpArg();
John Kessenich6263fb12017-06-14 15:52:44 -0600417 } else if (lowerword == "flatten-uniform-arrays" || // synonyms
418 lowerword == "flatten-uniform-array" ||
419 lowerword == "fua") {
420 Options |= EOptionFlattenUniformArrays;
421 } else if (lowerword == "hlsl-offsets") {
422 Options |= EOptionHlslOffsets;
423 } else if (lowerword == "hlsl-iomap" ||
424 lowerword == "hlsl-iomapper" ||
425 lowerword == "hlsl-iomapping") {
426 Options |= EOptionHlslIoMapping;
427 } else if (lowerword == "keep-uncalled" || // synonyms
428 lowerword == "ku") {
429 Options |= EOptionKeepUncalled;
430 } else if (lowerword == "no-storage-format" || // synonyms
431 lowerword == "nsf") {
432 Options |= EOptionNoStorageFormat;
John Kessenich2a271162017-07-20 20:00:36 -0600433 } else if (lowerword == "relaxed-errors") {
434 Options |= EOptionRelaxedErrors;
John Kessenich6263fb12017-06-14 15:52:44 -0600435 } else if (lowerword == "resource-set-bindings" || // synonyms
436 lowerword == "resource-set-binding" ||
437 lowerword == "rsb") {
438 ProcessResourceSetBindingBase(argc, argv, baseResourceSetBinding);
steve-lunarg9088be42016-11-01 10:31:42 -0600439 } else if (lowerword == "shift-image-bindings" || // synonyms
440 lowerword == "shift-image-binding" ||
441 lowerword == "sib") {
442 ProcessBindingBase(argc, argv, baseImageBinding);
John Kessenich6263fb12017-06-14 15:52:44 -0600443 } else if (lowerword == "shift-sampler-bindings" || // synonyms
444 lowerword == "shift-sampler-binding" ||
445 lowerword == "ssb") {
446 ProcessBindingBase(argc, argv, baseSamplerBinding);
447 } else if (lowerword == "shift-uav-bindings" || // synonyms
448 lowerword == "shift-uav-binding" ||
449 lowerword == "suavb") {
450 ProcessBindingBase(argc, argv, baseUavBinding);
451 } else if (lowerword == "shift-texture-bindings" || // synonyms
452 lowerword == "shift-texture-binding" ||
453 lowerword == "stb") {
454 ProcessBindingBase(argc, argv, baseTextureBinding);
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600455 } else if (lowerword == "shift-ubo-bindings" || // synonyms
456 lowerword == "shift-ubo-binding" ||
steve-lunargbe283552017-04-18 12:18:01 -0600457 lowerword == "shift-cbuffer-bindings" ||
458 lowerword == "shift-cbuffer-binding" ||
459 lowerword == "sub" ||
460 lowerword == "scb") {
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600461 ProcessBindingBase(argc, argv, baseUboBinding);
steve-lunarg932bb5c2017-02-21 17:19:08 -0700462 } else if (lowerword == "shift-ssbo-bindings" || // synonyms
463 lowerword == "shift-ssbo-binding" ||
464 lowerword == "sbb") {
465 ProcessBindingBase(argc, argv, baseSsboBinding);
John Kessenich6263fb12017-06-14 15:52:44 -0600466 } else if (lowerword == "source-entrypoint" || // synonyms
467 lowerword == "sep") {
John Kessenichc178f0a2017-06-23 10:58:31 -0600468 if (argc <= 1)
John Kessenich6263fb12017-06-14 15:52:44 -0600469 Error("no <entry-point> provided for --source-entrypoint");
John Kessenichc178f0a2017-06-23 10:58:31 -0600470 sourceEntryPointName = argv[1];
471 bumpArg();
John Kessenich6263fb12017-06-14 15:52:44 -0600472 break;
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +0200473 } else if (lowerword == "stdin") {
474 Options |= EOptionStdin;
475 shaderStageName = argv[1];
John Kessenich2a271162017-07-20 20:00:36 -0600476 } else if (lowerword == "suppress-warnings") {
477 Options |= EOptionSuppressWarnings;
John Kessenich6353d552017-06-23 11:11:09 -0600478 } else if (lowerword == "target-env") {
479 if (argc > 1) {
480 if (strcmp(argv[1], "vulkan1.0") == 0) {
481 setVulkanSpv();
482 VulkanClientVersion = 100;
483 } else if (strcmp(argv[1], "opengl") == 0) {
484 setOpenGlSpv();
485 OpenGLClientVersion = 450;
486 } else
487 Error("--target-env expected vulkan1.0 or opengl");
488 }
489 bumpArg();
Flavio15017db2017-02-15 14:29:33 -0800490 } else if (lowerword == "variable-name" || // synonyms
491 lowerword == "vn") {
492 Options |= EOptionOutputHexadecimal;
John Kessenichc178f0a2017-06-23 10:58:31 -0600493 if (argc <= 1)
Flavio15017db2017-02-15 14:29:33 -0800494 Error("no <C-variable-name> provided for --variable-name");
John Kessenichc178f0a2017-06-23 10:58:31 -0600495 variableName = argv[1];
496 bumpArg();
Flavio15017db2017-02-15 14:29:33 -0800497 break;
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600498 } else {
499 usage();
500 }
501 }
502 break;
John Kessenich6263fb12017-06-14 15:52:44 -0600503 case 'C':
504 Options |= EOptionCascadingErrors;
505 break;
506 case 'D':
John Kessenicha9313662017-06-15 10:40:49 -0600507 if (argv[0][2] == 0)
508 Options |= EOptionReadHlsl;
509 else
510 UserPreamble.addDef(getStringOperand("-D<macro> macro name"));
John Kessenich6263fb12017-06-14 15:52:44 -0600511 break;
512 case 'E':
513 Options |= EOptionOutputPreprocessed;
514 break;
515 case 'G':
John Kessenich6353d552017-06-23 11:11:09 -0600516 // OpenGL Client
517 setOpenGlSpv();
518 if (argv[0][2] != 0)
519 ClientInputSemanticsVersion = getAttachedNumber("-G<num> client input semantics");
John Kessenich6263fb12017-06-14 15:52:44 -0600520 break;
John Kessenich2aa7f3a2015-05-15 16:02:07 +0000521 case 'H':
522 Options |= EOptionHumanReadableSpv;
John Kessenich91e4aa52016-07-07 17:46:42 -0600523 if ((Options & EOptionSpv) == 0) {
524 // default to Vulkan
John Kessenich6353d552017-06-23 11:11:09 -0600525 setVulkanSpv();
John Kessenich91e4aa52016-07-07 17:46:42 -0600526 }
527 break;
John Kessenich971a0a82017-06-07 15:06:58 -0600528 case 'I':
John Kessenicha9313662017-06-15 10:40:49 -0600529 IncludeDirectoryList.push_back(getStringOperand("-I<dir> include path"));
John Kessenich68d78fd2015-07-12 19:28:10 -0600530 break;
Dan Baker5afdd782016-08-11 17:53:57 -0400531 case 'S':
John Kessenichc178f0a2017-06-23 10:58:31 -0600532 if (argc <= 1)
Dan Baker5afdd782016-08-11 17:53:57 -0400533 Error("no <stage> specified for -S");
John Kessenichc178f0a2017-06-23 10:58:31 -0600534 shaderStageName = argv[1];
535 bumpArg();
dankbaker45d49bc2016-08-08 21:43:07 -0400536 break;
John Kessenicha9313662017-06-15 10:40:49 -0600537 case 'U':
538 UserPreamble.addUndef(getStringOperand("-U<macro>: macro name"));
539 break;
John Kessenich6263fb12017-06-14 15:52:44 -0600540 case 'V':
John Kessenich6353d552017-06-23 11:11:09 -0600541 setVulkanSpv();
542 if (argv[0][2] != 0)
543 ClientInputSemanticsVersion = getAttachedNumber("-G<num> client input semantics");
John Kessenichc555ddd2015-06-17 02:38:44 +0000544 break;
John Kessenich05a70632013-09-17 19:26:08 +0000545 case 'c':
546 Options |= EOptionDumpConfig;
547 break;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000548 case 'd':
John Kessenich26ad2682014-08-13 20:17:19 +0000549 Options |= EOptionDefaultDesktop;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000550 break;
John Kessenich4d65ee32016-03-12 18:17:47 -0700551 case 'e':
552 // HLSL todo: entry point handle needs much more sophistication.
553 // This is okay for one compilation unit with one entry point.
554 entryPointName = argv[1];
John Kessenichc178f0a2017-06-23 10:58:31 -0600555 if (argc <= 1)
John Kessenicha25530c2017-09-11 20:13:49 -0600556 Error("no <name> provided for -e");
John Kessenichc178f0a2017-06-23 10:58:31 -0600557 bumpArg();
John Kessenich4d65ee32016-03-12 18:17:47 -0700558 break;
John Kessenich121853f2017-05-31 17:11:16 -0600559 case 'g':
560 Options |= EOptionDebug;
561 break;
John Kessenich68d78fd2015-07-12 19:28:10 -0600562 case 'h':
563 usage();
564 break;
John Kessenich05a70632013-09-17 19:26:08 +0000565 case 'i':
John Kessenich94a81fb2013-08-31 02:41:30 +0000566 Options |= EOptionIntermediate;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000567 break;
568 case 'l':
John Kessenichd78e3512014-08-25 20:07:55 +0000569 Options |= EOptionLinkProgram;
John Kessenich94a81fb2013-08-31 02:41:30 +0000570 break;
571 case 'm':
572 Options |= EOptionMemoryLeakMode;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000573 break;
John Kessenich68d78fd2015-07-12 19:28:10 -0600574 case 'o':
John Kessenichc178f0a2017-06-23 10:58:31 -0600575 if (argc <= 1)
John Kessenich68d78fd2015-07-12 19:28:10 -0600576 Error("no <file> provided for -o");
John Kessenichc178f0a2017-06-23 10:58:31 -0600577 binaryFileName = argv[1];
578 bumpArg();
John Kessenich68d78fd2015-07-12 19:28:10 -0600579 break;
John Kessenich11f9fc72013-11-07 01:06:34 +0000580 case 'q':
581 Options |= EOptionDumpReflection;
582 break;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000583 case 'r':
John Kessenich94a81fb2013-08-31 02:41:30 +0000584 Options |= EOptionRelaxedErrors;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000585 break;
586 case 's':
John Kessenich94a81fb2013-08-31 02:41:30 +0000587 Options |= EOptionSuppressInfolog;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000588 break;
John Kessenich38f3b892013-09-06 19:52:57 +0000589 case 't':
Juan Lopeza558b262017-04-02 23:04:00 +0200590 Options |= EOptionMultiThreaded;
John Kessenich38f3b892013-09-06 19:52:57 +0000591 break;
John Kessenich319de232013-12-04 04:43:40 +0000592 case 'v':
593 Options |= EOptionDumpVersions;
594 break;
John Kessenichb0a7eb52013-11-07 17:44:20 +0000595 case 'w':
596 Options |= EOptionSuppressWarnings;
597 break;
Johannes van Waverenecb0f3b2016-05-27 12:55:53 -0500598 case 'x':
599 Options |= EOptionOutputHexadecimal;
Johannes van Waverenecb0f3b2016-05-27 12:55:53 -0500600 break;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000601 default:
John Kessenich68d78fd2015-07-12 19:28:10 -0600602 usage();
603 break;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000604 }
John Kessenich38f3b892013-09-06 19:52:57 +0000605 } else {
John Kessenich05a70632013-09-17 19:26:08 +0000606 std::string name(argv[0]);
607 if (! SetConfigFile(name)) {
Juan Lopeza558b262017-04-02 23:04:00 +0200608 workItems.push_back(std::unique_ptr<glslang::TWorkItem>(new glslang::TWorkItem(name)));
John Kessenich05a70632013-09-17 19:26:08 +0000609 }
John Kessenich38f3b892013-09-06 19:52:57 +0000610 }
John Kessenich2b07c7e2013-07-31 18:44:13 +0000611 }
612
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +0200613 // Make sure that -S is always specified if --stdin is specified
614 if ((Options & EOptionStdin) && shaderStageName == nullptr)
615 Error("must provide -S when --stdin is given");
616
John Kessenich68d78fd2015-07-12 19:28:10 -0600617 // Make sure that -E is not specified alongside linking (which includes SPV generation)
618 if ((Options & EOptionOutputPreprocessed) && (Options & EOptionLinkProgram))
619 Error("can't use -E when linking is selected");
John Kessenichc555ddd2015-06-17 02:38:44 +0000620
Johannes van Waverenecb0f3b2016-05-27 12:55:53 -0500621 // -o or -x makes no sense if there is no target binary
John Kessenich68d78fd2015-07-12 19:28:10 -0600622 if (binaryFileName && (Options & EOptionSpv) == 0)
623 Error("no binary generation requested (e.g., -V)");
steve-lunarge0b9deb2016-09-16 13:26:37 -0600624
625 if ((Options & EOptionFlattenUniformArrays) != 0 &&
626 (Options & EOptionReadHlsl) == 0)
627 Error("uniform array flattening only valid when compiling HLSL source.");
John Kessenich2b07c7e2013-07-31 18:44:13 +0000628}
629
John Kessenich68d78fd2015-07-12 19:28:10 -0600630//
631// Translate the meaningful subset of command-line options to parser-behavior options.
632//
John Kessenichb0a7eb52013-11-07 17:44:20 +0000633void SetMessageOptions(EShMessages& messages)
634{
635 if (Options & EOptionRelaxedErrors)
636 messages = (EShMessages)(messages | EShMsgRelaxedErrors);
637 if (Options & EOptionIntermediate)
638 messages = (EShMessages)(messages | EShMsgAST);
639 if (Options & EOptionSuppressWarnings)
640 messages = (EShMessages)(messages | EShMsgSuppressWarnings);
John Kessenich68d78fd2015-07-12 19:28:10 -0600641 if (Options & EOptionSpv)
642 messages = (EShMessages)(messages | EShMsgSpvRules);
643 if (Options & EOptionVulkanRules)
644 messages = (EShMessages)(messages | EShMsgVulkanRules);
Andrew Woloszynaae1ad82015-06-24 17:00:46 -0400645 if (Options & EOptionOutputPreprocessed)
646 messages = (EShMessages)(messages | EShMsgOnlyPreprocessor);
John Kessenich66e2faf2016-03-12 18:34:36 -0700647 if (Options & EOptionReadHlsl)
648 messages = (EShMessages)(messages | EShMsgReadHlsl);
John Kessenicha86836e2016-07-09 14:50:57 -0600649 if (Options & EOptionCascadingErrors)
650 messages = (EShMessages)(messages | EShMsgCascadingErrors);
John Kessenich906cc212016-12-09 19:22:20 -0700651 if (Options & EOptionKeepUncalled)
652 messages = (EShMessages)(messages | EShMsgKeepUncalled);
John Kessenich4f1403e2017-04-05 17:38:20 -0600653 if (Options & EOptionHlslOffsets)
654 messages = (EShMessages)(messages | EShMsgHlslOffsets);
John Kessenich121853f2017-05-31 17:11:16 -0600655 if (Options & EOptionDebug)
656 messages = (EShMessages)(messages | EShMsgDebugInfo);
John Kessenichb0a7eb52013-11-07 17:44:20 +0000657}
658
John Kessenich68d78fd2015-07-12 19:28:10 -0600659//
John Kessenich69f4b512013-09-04 21:19:27 +0000660// Thread entry point, for non-linking asynchronous mode.
John Kessenichc999ba22013-11-07 23:33:24 +0000661//
Juan Lopeza558b262017-04-02 23:04:00 +0200662void CompileShaders(glslang::TWorklist& worklist)
John Kessenich2b07c7e2013-07-31 18:44:13 +0000663{
John Kessenich38f3b892013-09-06 19:52:57 +0000664 glslang::TWorkItem* workItem;
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +0200665 if (Options & EOptionStdin) {
666 worklist.remove(workItem);
667 ShHandle compiler = ShConstructCompiler(FindLanguage("stdin"), Options);
John Kessenich2b07c7e2013-07-31 18:44:13 +0000668 if (compiler == 0)
Juan Lopeza558b262017-04-02 23:04:00 +0200669 return;
John Kessenich2b07c7e2013-07-31 18:44:13 +0000670
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +0200671 CompileFile("stdin", compiler);
John Kessenich2b07c7e2013-07-31 18:44:13 +0000672
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +0200673 if (! (Options & EOptionSuppressInfolog))
674 workItem->results = ShGetInfoLog(compiler);
John Kessenich2b07c7e2013-07-31 18:44:13 +0000675
676 ShDestruct(compiler);
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +0200677 } else {
678 while (worklist.remove(workItem)) {
679 ShHandle compiler = ShConstructCompiler(FindLanguage(workItem->name), Options);
680 if (compiler == 0)
681 return;
682
683 CompileFile(workItem->name.c_str(), compiler);
684
685 if (! (Options & EOptionSuppressInfolog))
686 workItem->results = ShGetInfoLog(compiler);
687
688 ShDestruct(compiler);
689 }
John Kessenich2b07c7e2013-07-31 18:44:13 +0000690 }
John Kessenich2b07c7e2013-07-31 18:44:13 +0000691}
692
John Kessenich6626cad2015-06-19 05:14:19 +0000693// Outputs the given string, but only if it is non-null and non-empty.
694// This prevents erroneous newlines from appearing.
Andrew Woloszynaae1ad82015-06-24 17:00:46 -0400695void PutsIfNonEmpty(const char* str)
John Kessenich6626cad2015-06-19 05:14:19 +0000696{
697 if (str && str[0]) {
698 puts(str);
699 }
700}
701
Andrew Woloszynaae1ad82015-06-24 17:00:46 -0400702// Outputs the given string to stderr, but only if it is non-null and non-empty.
703// This prevents erroneous newlines from appearing.
704void StderrIfNonEmpty(const char* str)
705{
John Kessenich04acb1b2017-06-14 17:36:50 -0600706 if (str && str[0])
707 fprintf(stderr, "%s\n", str);
Andrew Woloszynaae1ad82015-06-24 17:00:46 -0400708}
709
John Kessenichc57b2a92016-01-16 15:30:03 -0700710// Simple bundling of what makes a compilation unit for ease in passing around,
711// and separation of handling file IO versus API (programmatic) compilation.
712struct ShaderCompUnit {
713 EShLanguage stage;
John Kessenich04acb1b2017-06-14 17:36:50 -0600714 static const int maxCount = 1;
715 int count; // live number of strings/names
John Kessenicha9313662017-06-15 10:40:49 -0600716 const char* text[maxCount]; // memory owned/managed externally
John Kessenich04acb1b2017-06-14 17:36:50 -0600717 std::string fileName[maxCount]; // hold's the memory, but...
718 const char* fileNameList[maxCount]; // downstream interface wants pointers
dankbakerafe6e9c2016-08-21 12:29:08 -0400719
John Kessenich04acb1b2017-06-14 17:36:50 -0600720 ShaderCompUnit(EShLanguage stage) : stage(stage), count(0) { }
dankbakerafe6e9c2016-08-21 12:29:08 -0400721
John Kessenich04acb1b2017-06-14 17:36:50 -0600722 ShaderCompUnit(const ShaderCompUnit& rhs)
dankbakerafe6e9c2016-08-21 12:29:08 -0400723 {
724 stage = rhs.stage;
John Kessenich04acb1b2017-06-14 17:36:50 -0600725 count = rhs.count;
726 for (int i = 0; i < count; ++i) {
727 fileName[i] = rhs.fileName[i];
728 text[i] = rhs.text[i];
729 fileNameList[i] = rhs.fileName[i].c_str();
730 }
dankbakerafe6e9c2016-08-21 12:29:08 -0400731 }
732
John Kessenicha9313662017-06-15 10:40:49 -0600733 void addString(std::string& ifileName, const char* itext)
John Kessenich04acb1b2017-06-14 17:36:50 -0600734 {
735 assert(count < maxCount);
736 fileName[count] = ifileName;
737 text[count] = itext;
738 fileNameList[count] = fileName[count].c_str();
739 ++count;
740 }
John Kessenichc57b2a92016-01-16 15:30:03 -0700741};
742
John Kessenich69f4b512013-09-04 21:19:27 +0000743//
John Kessenichc57b2a92016-01-16 15:30:03 -0700744// For linking mode: Will independently parse each compilation unit, but then put them
745// in the same program and link them together, making at most one linked module per
746// pipeline stage.
John Kessenich69f4b512013-09-04 21:19:27 +0000747//
748// Uses the new C++ interface instead of the old handle-based interface.
749//
John Kessenichc57b2a92016-01-16 15:30:03 -0700750
751void CompileAndLinkShaderUnits(std::vector<ShaderCompUnit> compUnits)
John Kessenich69f4b512013-09-04 21:19:27 +0000752{
753 // keep track of what to free
754 std::list<glslang::TShader*> shaders;
John Kessenichc57b2a92016-01-16 15:30:03 -0700755
John Kessenich69f4b512013-09-04 21:19:27 +0000756 EShMessages messages = EShMsgDefault;
John Kessenichb0a7eb52013-11-07 17:44:20 +0000757 SetMessageOptions(messages);
John Kessenich69f4b512013-09-04 21:19:27 +0000758
John Kessenich69f4b512013-09-04 21:19:27 +0000759 //
760 // Per-shader processing...
761 //
762
John Kessenich5b0f13a2013-11-01 03:08:40 +0000763 glslang::TProgram& program = *new glslang::TProgram;
rdb32084e82016-02-23 22:17:38 +0100764 for (auto it = compUnits.cbegin(); it != compUnits.cend(); ++it) {
765 const auto &compUnit = *it;
John Kessenichc57b2a92016-01-16 15:30:03 -0700766 glslang::TShader* shader = new glslang::TShader(compUnit.stage);
John Kessenich04acb1b2017-06-14 17:36:50 -0600767 shader->setStringsWithLengthsAndNames(compUnit.text, NULL, compUnit.fileNameList, compUnit.count);
John Kessenich4d65ee32016-03-12 18:17:47 -0700768 if (entryPointName) // HLSL todo: this needs to be tracked per compUnits
769 shader->setEntryPoint(entryPointName);
steve-lunargf1e0c872016-10-31 15:13:43 -0600770 if (sourceEntryPointName)
771 shader->setSourceEntryPoint(sourceEntryPointName);
John Kessenicha9313662017-06-15 10:40:49 -0600772 if (UserPreamble.isSet())
773 shader->setPreamble(UserPreamble.get());
John Kessenich2a271162017-07-20 20:00:36 -0600774 shader->addProcesses(Processes);
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600775
776 shader->setShiftSamplerBinding(baseSamplerBinding[compUnit.stage]);
777 shader->setShiftTextureBinding(baseTextureBinding[compUnit.stage]);
steve-lunarg9088be42016-11-01 10:31:42 -0600778 shader->setShiftImageBinding(baseImageBinding[compUnit.stage]);
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600779 shader->setShiftUboBinding(baseUboBinding[compUnit.stage]);
steve-lunarg932bb5c2017-02-21 17:19:08 -0700780 shader->setShiftSsboBinding(baseSsboBinding[compUnit.stage]);
steve-lunargbe283552017-04-18 12:18:01 -0600781 shader->setShiftUavBinding(baseUavBinding[compUnit.stage]);
steve-lunarge0b9deb2016-09-16 13:26:37 -0600782 shader->setFlattenUniformArrays((Options & EOptionFlattenUniformArrays) != 0);
steve-lunargcce8d482016-10-14 18:36:42 -0600783 shader->setNoStorageFormat((Options & EOptionNoStorageFormat) != 0);
Hyangran Park36dc8292017-05-02 16:27:29 +0900784 shader->setResourceSetBinding(baseResourceSetBinding[compUnit.stage]);
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600785
steve-lunargbe283552017-04-18 12:18:01 -0600786 if (Options & EOptionHlslIoMapping)
787 shader->setHlslIoMapping(true);
788
steve-lunarg7f7c2ed2016-09-07 15:20:19 -0600789 if (Options & EOptionAutoMapBindings)
790 shader->setAutoMapBindings(true);
John Kessenichecba76f2017-01-06 00:34:48 -0700791
John Kessenich71facdf2017-05-17 18:28:19 -0600792 if (Options & EOptionAutoMapLocations)
793 shader->setAutoMapLocations(true);
794
John Kessenich4be4aeb2017-06-23 10:50:22 -0600795 // Set up the environment, some subsettings take precedence over earlier
796 // ways of setting things.
797 if (Options & EOptionSpv) {
798 if (Options & EOptionVulkanRules) {
799 shader->setEnvInput((Options & EOptionReadHlsl) ? glslang::EShSourceHlsl
800 : glslang::EShSourceGlsl,
John Kessenich6353d552017-06-23 11:11:09 -0600801 compUnit.stage, glslang::EShClientVulkan, ClientInputSemanticsVersion);
802 shader->setEnvClient(glslang::EShClientVulkan, VulkanClientVersion);
803 shader->setEnvTarget(glslang::EshTargetSpv, TargetVersion);
John Kessenich4be4aeb2017-06-23 10:50:22 -0600804 } else {
805 shader->setEnvInput((Options & EOptionReadHlsl) ? glslang::EShSourceHlsl
806 : glslang::EShSourceGlsl,
John Kessenich6353d552017-06-23 11:11:09 -0600807 compUnit.stage, glslang::EShClientOpenGL, ClientInputSemanticsVersion);
808 shader->setEnvClient(glslang::EShClientOpenGL, OpenGLClientVersion);
809 shader->setEnvTarget(glslang::EshTargetSpv, TargetVersion);
John Kessenich4be4aeb2017-06-23 10:50:22 -0600810 }
811 }
812
John Kessenich69f4b512013-09-04 21:19:27 +0000813 shaders.push_back(shader);
John Kessenichb3297152015-07-11 18:01:03 -0600814
John Kessenich4be4aeb2017-06-23 10:50:22 -0600815 const int defaultVersion = Options & EOptionDefaultDesktop ? 110 : 100;
John Kessenich69f4b512013-09-04 21:19:27 +0000816
John Kessenich3494b4d2017-05-22 15:00:42 -0600817 DirStackFileIncluder includer;
John Kessenich971a0a82017-06-07 15:06:58 -0600818 std::for_each(IncludeDirectoryList.rbegin(), IncludeDirectoryList.rend(), [&includer](const std::string& dir) {
819 includer.pushExternalLocalDirectory(dir); });
John Kessenichc555ddd2015-06-17 02:38:44 +0000820 if (Options & EOptionOutputPreprocessed) {
821 std::string str;
Dejan Mircevski7be4b822015-06-17 11:40:33 -0400822 if (shader->preprocess(&Resources, defaultVersion, ENoProfile, false, false,
Andrew Woloszyna132af52016-03-07 13:23:09 -0500823 messages, &str, includer)) {
Andrew Woloszynaae1ad82015-06-24 17:00:46 -0400824 PutsIfNonEmpty(str.c_str());
825 } else {
826 CompileFailed = true;
827 }
828 StderrIfNonEmpty(shader->getInfoLog());
829 StderrIfNonEmpty(shader->getInfoDebugLog());
John Kessenichc555ddd2015-06-17 02:38:44 +0000830 continue;
831 }
John Kessenich3494b4d2017-05-22 15:00:42 -0600832 if (! shader->parse(&Resources, defaultVersion, false, messages, includer))
John Kessenichc999ba22013-11-07 23:33:24 +0000833 CompileFailed = true;
John Kessenichc555ddd2015-06-17 02:38:44 +0000834
John Kessenich69f4b512013-09-04 21:19:27 +0000835 program.addShader(shader);
836
John Kessenichc57b2a92016-01-16 15:30:03 -0700837 if (! (Options & EOptionSuppressInfolog) &&
838 ! (Options & EOptionMemoryLeakMode)) {
John Kessenich04acb1b2017-06-14 17:36:50 -0600839 PutsIfNonEmpty(compUnit.fileName[0].c_str());
Andrew Woloszynaae1ad82015-06-24 17:00:46 -0400840 PutsIfNonEmpty(shader->getInfoLog());
841 PutsIfNonEmpty(shader->getInfoDebugLog());
John Kessenich69f4b512013-09-04 21:19:27 +0000842 }
John Kessenich69f4b512013-09-04 21:19:27 +0000843 }
844
845 //
846 // Program-level processing...
847 //
848
John Kessenich4d65ee32016-03-12 18:17:47 -0700849 // Link
John Kessenich68d78fd2015-07-12 19:28:10 -0600850 if (! (Options & EOptionOutputPreprocessed) && ! program.link(messages))
John Kessenichc999ba22013-11-07 23:33:24 +0000851 LinkFailed = true;
852
steve-lunarg9ae34742016-10-05 13:40:13 -0600853 // Map IO
854 if (Options & EOptionSpv) {
855 if (!program.mapIO())
856 LinkFailed = true;
857 }
John Kessenichecba76f2017-01-06 00:34:48 -0700858
John Kessenich4d65ee32016-03-12 18:17:47 -0700859 // Report
John Kessenichc57b2a92016-01-16 15:30:03 -0700860 if (! (Options & EOptionSuppressInfolog) &&
861 ! (Options & EOptionMemoryLeakMode)) {
Andrew Woloszynaae1ad82015-06-24 17:00:46 -0400862 PutsIfNonEmpty(program.getInfoLog());
863 PutsIfNonEmpty(program.getInfoDebugLog());
John Kessenich69f4b512013-09-04 21:19:27 +0000864 }
865
John Kessenich4d65ee32016-03-12 18:17:47 -0700866 // Reflect
John Kessenich11f9fc72013-11-07 01:06:34 +0000867 if (Options & EOptionDumpReflection) {
868 program.buildReflection();
869 program.dumpReflection();
870 }
871
John Kessenich4d65ee32016-03-12 18:17:47 -0700872 // Dump SPIR-V
John Kessenich0df0cde2015-03-03 17:09:43 +0000873 if (Options & EOptionSpv) {
John Kessenich92f90382014-07-28 04:21:04 +0000874 if (CompileFailed || LinkFailed)
John Kessenich68d78fd2015-07-12 19:28:10 -0600875 printf("SPIR-V is not generated for failed compile or link\n");
John Kessenich92f90382014-07-28 04:21:04 +0000876 else {
877 for (int stage = 0; stage < EShLangCount; ++stage) {
John Kessenicha7a68a92014-08-24 18:21:00 +0000878 if (program.getIntermediate((EShLanguage)stage)) {
John Kessenich0df0cde2015-03-03 17:09:43 +0000879 std::vector<unsigned int> spirv;
Lei Zhang09caf122016-05-02 18:11:54 -0400880 std::string warningsErrors;
Lei Zhang17535f72016-05-04 15:55:59 -0400881 spv::SpvBuildLogger logger;
John Kessenich121853f2017-05-31 17:11:16 -0600882 glslang::SpvOptions spvOptions;
883 if (Options & EOptionDebug)
884 spvOptions.generateDebugInfo = true;
885 glslang::GlslangToSpv(*program.getIntermediate((EShLanguage)stage), spirv, &logger, &spvOptions);
John Kessenichc57b2a92016-01-16 15:30:03 -0700886
887 // Dump the spv to a file or stdout, etc., but only if not doing
888 // memory/perf testing, as it's not internal to programmatic use.
889 if (! (Options & EOptionMemoryLeakMode)) {
Johannes van Waverenecb0f3b2016-05-27 12:55:53 -0500890 printf("%s", logger.getAllMessages().c_str());
891 if (Options & EOptionOutputHexadecimal) {
John Kessenich8f674e82017-02-18 09:45:40 -0700892 glslang::OutputSpvHex(spirv, GetBinaryName((EShLanguage)stage), variableName);
Johannes van Waverenecb0f3b2016-05-27 12:55:53 -0500893 } else {
894 glslang::OutputSpvBin(spirv, GetBinaryName((EShLanguage)stage));
895 }
John Kessenichc57b2a92016-01-16 15:30:03 -0700896 if (Options & EOptionHumanReadableSpv) {
John Kessenichc57b2a92016-01-16 15:30:03 -0700897 spv::Disassemble(std::cout, spirv);
898 }
John Kessenichacba7722015-03-04 03:48:38 +0000899 }
John Kessenicha7a68a92014-08-24 18:21:00 +0000900 }
John Kessenich92f90382014-07-28 04:21:04 +0000901 }
902 }
903 }
904
John Kessenich5b0f13a2013-11-01 03:08:40 +0000905 // Free everything up, program has to go before the shaders
906 // because it might have merged stuff from the shaders, and
907 // the stuff from the shaders has to have its destructors called
908 // before the pools holding the memory in the shaders is freed.
909 delete &program;
John Kessenich69f4b512013-09-04 21:19:27 +0000910 while (shaders.size() > 0) {
911 delete shaders.back();
912 shaders.pop_back();
913 }
John Kessenich69f4b512013-09-04 21:19:27 +0000914}
915
John Kessenichc57b2a92016-01-16 15:30:03 -0700916//
917// Do file IO part of compile and link, handing off the pure
918// API/programmatic mode to CompileAndLinkShaderUnits(), which can
919// be put in a loop for testing memory footprint and performance.
920//
921// This is just for linking mode: meaning all the shaders will be put into the
922// the same program linked together.
923//
924// This means there are a limited number of work items (not multi-threading mode)
925// and that the point is testing at the linking level. Hence, to enable
926// performance and memory testing, the actual compile/link can be put in
927// a loop, independent of processing the work items and file IO.
928//
Juan Lopeza558b262017-04-02 23:04:00 +0200929void CompileAndLinkShaderFiles(glslang::TWorklist& Worklist)
John Kessenichc57b2a92016-01-16 15:30:03 -0700930{
931 std::vector<ShaderCompUnit> compUnits;
932
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +0200933 // If this is using stdin, we can't really detect multiple different file
934 // units by input type. We need to assume that we're just being given one
935 // file of a certain type.
936 if ((Options & EOptionStdin) != 0) {
937 ShaderCompUnit compUnit(FindLanguage("stdin"));
938 std::istreambuf_iterator<char> begin(std::cin), end;
939 std::string tempString(begin, end);
940 char* fileText = strdup(tempString.c_str());
941 std::string fileName = "stdin";
942 compUnit.addString(fileName, fileText);
John Kessenichc57b2a92016-01-16 15:30:03 -0700943 compUnits.push_back(compUnit);
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +0200944 } else {
945 // Transfer all the work items from to a simple list of
946 // of compilation units. (We don't care about the thread
947 // work-item distribution properties in this path, which
948 // is okay due to the limited number of shaders, know since
949 // they are all getting linked together.)
950 glslang::TWorkItem* workItem;
951 while (Worklist.remove(workItem)) {
952 ShaderCompUnit compUnit(FindLanguage(workItem->name));
953 char* fileText = ReadFileData(workItem->name.c_str());
954 if (fileText == nullptr)
955 usage();
956 compUnit.addString(workItem->name, fileText);
957 compUnits.push_back(compUnit);
958 }
John Kessenichc57b2a92016-01-16 15:30:03 -0700959 }
960
961 // Actual call to programmatic processing of compile and link,
962 // in a loop for testing memory and performance. This part contains
963 // all the perf/memory that a programmatic consumer will care about.
964 for (int i = 0; i < ((Options & EOptionMemoryLeakMode) ? 100 : 1); ++i) {
965 for (int j = 0; j < ((Options & EOptionMemoryLeakMode) ? 100 : 1); ++j)
966 CompileAndLinkShaderUnits(compUnits);
967
968 if (Options & EOptionMemoryLeakMode)
969 glslang::OS_DumpMemoryCounters();
970 }
971
John Kessenicha9313662017-06-15 10:40:49 -0600972 // free memory from ReadFileData, which got stored in a const char*
973 // as the first string above
rdb32084e82016-02-23 22:17:38 +0100974 for (auto it = compUnits.begin(); it != compUnits.end(); ++it)
John Kessenicha9313662017-06-15 10:40:49 -0600975 FreeFileData(const_cast<char*>(it->text[0]));
John Kessenichc57b2a92016-01-16 15:30:03 -0700976}
977
John Kessenicha0af4732012-12-12 21:15:54 +0000978int C_DECL main(int argc, char* argv[])
979{
Juan Lopeza558b262017-04-02 23:04:00 +0200980 // array of unique places to leave the shader names and infologs for the asynchronous compiles
981 std::vector<std::unique_ptr<glslang::TWorkItem>> workItems;
982 ProcessArguments(workItems, argc, argv);
983
984 glslang::TWorklist workList;
985 std::for_each(workItems.begin(), workItems.end(), [&workList](std::unique_ptr<glslang::TWorkItem>& item) {
986 assert(item);
987 workList.add(item.get());
988 });
John Kessenich2b07c7e2013-07-31 18:44:13 +0000989
John Kessenich05a70632013-09-17 19:26:08 +0000990 if (Options & EOptionDumpConfig) {
Lei Zhang414eb602016-03-04 16:22:34 -0500991 printf("%s", glslang::GetDefaultTBuiltInResourceString().c_str());
Juan Lopeza558b262017-04-02 23:04:00 +0200992 if (workList.empty())
John Kessenich05a70632013-09-17 19:26:08 +0000993 return ESuccess;
994 }
995
John Kessenich0da9eaa2015-08-01 17:10:02 -0600996 if (Options & EOptionDumpVersions) {
997 printf("Glslang Version: %s %s\n", GLSLANG_REVISION, GLSLANG_DATE);
John Kessenich319de232013-12-04 04:43:40 +0000998 printf("ESSL Version: %s\n", glslang::GetEsslVersionString());
999 printf("GLSL Version: %s\n", glslang::GetGlslVersionString());
John Kessenich68d78fd2015-07-12 19:28:10 -06001000 std::string spirvVersion;
1001 glslang::GetSpirvVersion(spirvVersion);
John Kessenich0da9eaa2015-08-01 17:10:02 -06001002 printf("SPIR-V Version %s\n", spirvVersion.c_str());
John Kessenich5e4b1242015-08-06 22:53:06 -06001003 printf("GLSL.std.450 Version %d, Revision %d\n", GLSLstd450Version, GLSLstd450Revision);
John Kessenich55e7d112015-11-15 21:33:39 -07001004 printf("Khronos Tool ID %d\n", glslang::GetKhronosToolId());
John Kessenichb84313d2016-07-20 16:03:29 -06001005 printf("GL_KHR_vulkan_glsl version %d\n", 100);
1006 printf("ARB_GL_gl_spirv version %d\n", 100);
Juan Lopeza558b262017-04-02 23:04:00 +02001007 if (workList.empty())
John Kessenich319de232013-12-04 04:43:40 +00001008 return ESuccess;
1009 }
1010
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +02001011 if (workList.empty() && ((Options & EOptionStdin) == 0)) {
John Kessenich05a70632013-09-17 19:26:08 +00001012 usage();
John Kessenich05a70632013-09-17 19:26:08 +00001013 }
1014
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +02001015 if (Options & EOptionStdin) {
1016 workItems.push_back(std::unique_ptr<glslang::TWorkItem>{new glslang::TWorkItem("stdin")});
1017 workList.add(workItems.back().get());
1018 }
1019
John Kessenich05a70632013-09-17 19:26:08 +00001020 ProcessConfigFile();
1021
John Kessenich69f4b512013-09-04 21:19:27 +00001022 //
1023 // Two modes:
John Kessenich38f3b892013-09-06 19:52:57 +00001024 // 1) linking all arguments together, single-threaded, new C++ interface
1025 // 2) independent arguments, can be tackled by multiple asynchronous threads, for testing thread safety, using the old handle interface
John Kessenich69f4b512013-09-04 21:19:27 +00001026 //
John Kessenichc555ddd2015-06-17 02:38:44 +00001027 if (Options & EOptionLinkProgram ||
1028 Options & EOptionOutputPreprocessed) {
John Kessenichc36e1d82013-11-01 17:41:52 +00001029 glslang::InitializeProcess();
Juan Lopeza558b262017-04-02 23:04:00 +02001030 CompileAndLinkShaderFiles(workList);
John Kessenichc36e1d82013-11-01 17:41:52 +00001031 glslang::FinalizeProcess();
1032 } else {
1033 ShInitialize();
1034
Juan Lopeza558b262017-04-02 23:04:00 +02001035 bool printShaderNames = workList.size() > 1;
John Kessenich69f4b512013-09-04 21:19:27 +00001036
Juan Lopeza558b262017-04-02 23:04:00 +02001037 if (Options & EOptionMultiThreaded)
1038 {
1039 std::array<std::thread, 16> threads;
1040 for (unsigned int t = 0; t < threads.size(); ++t)
1041 {
1042 threads[t] = std::thread(CompileShaders, std::ref(workList));
1043 if (threads[t].get_id() == std::thread::id())
1044 {
John Kessenich38f3b892013-09-06 19:52:57 +00001045 printf("Failed to create thread\n");
1046 return EFailThreadCreate;
1047 }
John Kessenicha0af4732012-12-12 21:15:54 +00001048 }
Juan Lopeza558b262017-04-02 23:04:00 +02001049
1050 std::for_each(threads.begin(), threads.end(), [](std::thread& t) { t.join(); });
John Kessenichc999ba22013-11-07 23:33:24 +00001051 } else
Juan Lopeza558b262017-04-02 23:04:00 +02001052 CompileShaders(workList);
John Kessenich38f3b892013-09-06 19:52:57 +00001053
1054 // Print out all the resulting infologs
Juan Lopeza558b262017-04-02 23:04:00 +02001055 for (size_t w = 0; w < workItems.size(); ++w) {
1056 if (workItems[w]) {
1057 if (printShaderNames || workItems[w]->results.size() > 0)
1058 PutsIfNonEmpty(workItems[w]->name.c_str());
1059 PutsIfNonEmpty(workItems[w]->results.c_str());
John Kessenich38f3b892013-09-06 19:52:57 +00001060 }
1061 }
John Kessenichc36e1d82013-11-01 17:41:52 +00001062
1063 ShFinalize();
John Kessenicha0af4732012-12-12 21:15:54 +00001064 }
John Kessenich2b07c7e2013-07-31 18:44:13 +00001065
John Kessenichc999ba22013-11-07 23:33:24 +00001066 if (CompileFailed)
John Kessenicha0af4732012-12-12 21:15:54 +00001067 return EFailCompile;
John Kessenichc999ba22013-11-07 23:33:24 +00001068 if (LinkFailed)
John Kessenicha0af4732012-12-12 21:15:54 +00001069 return EFailLink;
1070
1071 return 0;
1072}
1073
1074//
1075// Deduce the language from the filename. Files must end in one of the
1076// following extensions:
1077//
John Kessenich2b07c7e2013-07-31 18:44:13 +00001078// .vert = vertex
1079// .tesc = tessellation control
1080// .tese = tessellation evaluation
1081// .geom = geometry
1082// .frag = fragment
John Kessenich94a81fb2013-08-31 02:41:30 +00001083// .comp = compute
John Kessenicha0af4732012-12-12 21:15:54 +00001084//
steve-lunarg7f7c2ed2016-09-07 15:20:19 -06001085EShLanguage FindLanguage(const std::string& name, bool parseSuffix)
John Kessenicha0af4732012-12-12 21:15:54 +00001086{
steve-lunarg7f7c2ed2016-09-07 15:20:19 -06001087 size_t ext = 0;
John Kesseniche751bca2017-03-16 11:20:38 -06001088 std::string suffix;
steve-lunarg7f7c2ed2016-09-07 15:20:19 -06001089
Dan Bakerc6ede892016-08-11 14:06:06 -04001090 if (shaderStageName)
1091 suffix = shaderStageName;
John Kesseniche751bca2017-03-16 11:20:38 -06001092 else {
1093 // Search for a suffix on a filename: e.g, "myfile.frag". If given
1094 // the suffix directly, we skip looking for the '.'
1095 if (parseSuffix) {
1096 ext = name.rfind('.');
1097 if (ext == std::string::npos) {
1098 usage();
1099 return EShLangVertex;
1100 }
1101 ++ext;
1102 }
1103 suffix = name.substr(ext, std::string::npos);
1104 }
dankbaker45d49bc2016-08-08 21:43:07 -04001105
John Kessenich2b07c7e2013-07-31 18:44:13 +00001106 if (suffix == "vert")
1107 return EShLangVertex;
1108 else if (suffix == "tesc")
1109 return EShLangTessControl;
1110 else if (suffix == "tese")
1111 return EShLangTessEvaluation;
1112 else if (suffix == "geom")
1113 return EShLangGeometry;
1114 else if (suffix == "frag")
1115 return EShLangFragment;
John Kessenichc0275792013-08-09 17:14:49 +00001116 else if (suffix == "comp")
1117 return EShLangCompute;
John Kessenich2b07c7e2013-07-31 18:44:13 +00001118
1119 usage();
John Kesseniche95ecc52012-12-12 21:34:14 +00001120 return EShLangVertex;
John Kessenicha0af4732012-12-12 21:15:54 +00001121}
1122
John Kessenicha0af4732012-12-12 21:15:54 +00001123//
John Kessenichecba76f2017-01-06 00:34:48 -07001124// Read a file's data into a string, and compile it using the old interface ShCompile,
John Kessenich69f4b512013-09-04 21:19:27 +00001125// for non-linkable results.
John Kessenicha0af4732012-12-12 21:15:54 +00001126//
John Kessenich51cdd902014-02-18 23:37:57 +00001127void CompileFile(const char* fileName, ShHandle compiler)
John Kessenicha0af4732012-12-12 21:15:54 +00001128{
John Kessenichca3457f2015-05-18 01:59:45 +00001129 int ret = 0;
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +02001130 char* shaderString;
1131 if ((Options & EOptionStdin) != 0) {
1132 std::istreambuf_iterator<char> begin(std::cin), end;
1133 std::string tempString(begin, end);
1134 shaderString = strdup(tempString.c_str());
1135 } else {
1136 shaderString = ReadFileData(fileName);
1137 }
John Kessenich41cf6b52013-06-25 18:10:05 +00001138
1139 // move to length-based strings, rather than null-terminated strings
John Kessenich04acb1b2017-06-14 17:36:50 -06001140 int* lengths = new int[1];
1141 lengths[0] = (int)strlen(shaderString);
John Kessenicha0af4732012-12-12 21:15:54 +00001142
John Kessenich52ac67e2013-05-05 23:46:22 +00001143 EShMessages messages = EShMsgDefault;
John Kessenichb0a7eb52013-11-07 17:44:20 +00001144 SetMessageOptions(messages);
John Kessenichecba76f2017-01-06 00:34:48 -07001145
John Kessenicha9313662017-06-15 10:40:49 -06001146 if (UserPreamble.isSet())
1147 Error("-D and -U options require -l (linking)\n");
1148
John Kessenich94a81fb2013-08-31 02:41:30 +00001149 for (int i = 0; i < ((Options & EOptionMemoryLeakMode) ? 100 : 1); ++i) {
1150 for (int j = 0; j < ((Options & EOptionMemoryLeakMode) ? 100 : 1); ++j) {
John Kessenich927608b2017-01-06 12:34:14 -07001151 // ret = ShCompile(compiler, shaderStrings, NumShaderStrings, lengths, EShOptNone, &Resources, Options, (Options & EOptionDefaultDesktop) ? 110 : 100, false, messages);
John Kessenich04acb1b2017-06-14 17:36:50 -06001152 ret = ShCompile(compiler, &shaderString, 1, nullptr, EShOptNone, &Resources, Options, (Options & EOptionDefaultDesktop) ? 110 : 100, false, messages);
John Kessenich927608b2017-01-06 12:34:14 -07001153 // const char* multi[12] = { "# ve", "rsion", " 300 e", "s", "\n#err",
John Kessenichecba76f2017-01-06 00:34:48 -07001154 // "or should be l", "ine 1", "string 5\n", "float glo", "bal",
John Kessenichea869fb2013-10-28 18:12:06 +00001155 // ";\n#error should be line 2\n void main() {", "global = 2.3;}" };
John Kessenich927608b2017-01-06 12:34:14 -07001156 // const char* multi[7] = { "/", "/", "\\", "\n", "\n", "#", "version 300 es" };
1157 // ret = ShCompile(compiler, multi, 7, nullptr, EShOptNone, &Resources, Options, (Options & EOptionDefaultDesktop) ? 110 : 100, false, messages);
John Kessenich41cf6b52013-06-25 18:10:05 +00001158 }
John Kessenicha0af4732012-12-12 21:15:54 +00001159
John Kessenich94a81fb2013-08-31 02:41:30 +00001160 if (Options & EOptionMemoryLeakMode)
John Kessenich2b07c7e2013-07-31 18:44:13 +00001161 glslang::OS_DumpMemoryCounters();
John Kessenicha0af4732012-12-12 21:15:54 +00001162 }
John Kessenicha0af4732012-12-12 21:15:54 +00001163
John Kessenich41cf6b52013-06-25 18:10:05 +00001164 delete [] lengths;
John Kessenich04acb1b2017-06-14 17:36:50 -06001165 FreeFileData(shaderString);
John Kessenicha0af4732012-12-12 21:15:54 +00001166
John Kessenichc999ba22013-11-07 23:33:24 +00001167 if (ret == 0)
1168 CompileFailed = true;
John Kessenicha0af4732012-12-12 21:15:54 +00001169}
1170
John Kessenicha0af4732012-12-12 21:15:54 +00001171//
1172// print usage to stdout
1173//
1174void usage()
1175{
John Kessenich319de232013-12-04 04:43:40 +00001176 printf("Usage: glslangValidator [option]... [file]...\n"
1177 "\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001178 "'file' can end in .<stage> for auto-stage classification, where <stage> is:\n"
1179 " .conf to provide a config file that replaces the default configuration\n"
John Kessenich68d78fd2015-07-12 19:28:10 -06001180 " (see -c option below for generating a template)\n"
1181 " .vert for a vertex shader\n"
1182 " .tesc for a tessellation control shader\n"
1183 " .tese for a tessellation evaluation shader\n"
1184 " .geom for a geometry shader\n"
1185 " .frag for a fragment shader\n"
1186 " .comp for a compute shader\n"
John Kessenich319de232013-12-04 04:43:40 +00001187 "\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001188 "Options:\n"
1189 " -C cascading errors; risk crash from accumulation of error recoveries\n"
1190 " -D input is HLSL\n"
John Kessenicha9313662017-06-15 10:40:49 -06001191 " -D<macro=def>\n"
1192 " -D<macro> define a pre-processor macro\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001193 " -E print pre-processed GLSL; cannot be used with -l;\n"
1194 " errors will appear on stderr.\n"
John Kessenich6353d552017-06-23 11:11:09 -06001195 " -G[ver] create SPIR-V binary, under OpenGL semantics; turns on -l;\n"
John Kessenich68d78fd2015-07-12 19:28:10 -06001196 " default file name is <stage>.spv (-o overrides this)\n"
John Kessenich6353d552017-06-23 11:11:09 -06001197 " 'ver', when present, is the version of the input semantics,\n"
1198 " which will appear in #define GL_SPIRV ver\n"
1199 " '--client opengl100' is the same as -G100\n"
1200 " a '--target-env' for OpenGL will also imply '-G'\n"
John Kessenich68d78fd2015-07-12 19:28:10 -06001201 " -H print human readable form of SPIR-V; turns on -V\n"
John Kessenich971a0a82017-06-07 15:06:58 -06001202 " -I<dir> add dir to the include search path; includer's directory\n"
1203 " is searched first, followed by left-to-right order of -I\n"
John Kesseniche751bca2017-03-16 11:20:38 -06001204 " -S <stage> uses specified stage rather than parsing the file extension\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001205 " choices for <stage> are vert, tesc, tese, geom, frag, or comp\n"
John Kessenich6353d552017-06-23 11:11:09 -06001206 " -U<macro> undefine a pre-processor macro\n"
1207 " -V[ver] create SPIR-V binary, under Vulkan semantics; turns on -l;\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001208 " default file name is <stage>.spv (-o overrides this)\n"
John Kessenich6353d552017-06-23 11:11:09 -06001209 " 'ver', when present, is the version of the input semantics,\n"
1210 " which will appear in #define VULKAN ver\n"
1211 " '--client vulkan100' is the same as -V100\n"
1212 " a '--target-env' for Vulkan will also imply '-V'\n"
John Kessenich68d78fd2015-07-12 19:28:10 -06001213 " -c configuration dump;\n"
1214 " creates the default configuration file (redirect to a .conf file)\n"
1215 " -d default to desktop (#version 110) when there is no shader #version\n"
1216 " (default is ES version 100)\n"
John Kessenicha25530c2017-09-11 20:13:49 -06001217 " -e <name> specify <name> as the entry-point name\n"
John Kessenich121853f2017-05-31 17:11:16 -06001218 " -g generate debug information\n"
John Kessenich68d78fd2015-07-12 19:28:10 -06001219 " -h print this usage message\n"
1220 " -i intermediate tree (glslang AST) is printed out\n"
1221 " -l link all input files together to form a single module\n"
1222 " -m memory leak mode\n"
John Kessenicha25530c2017-09-11 20:13:49 -06001223 " -o <file> save binary to <file>, requires a binary option (e.g., -V)\n"
John Kessenich68d78fd2015-07-12 19:28:10 -06001224 " -q dump reflection query database\n"
John Kessenich2a271162017-07-20 20:00:36 -06001225 " -r synonym for --relaxed-errors\n"
John Kessenich68d78fd2015-07-12 19:28:10 -06001226 " -s silent mode\n"
1227 " -t multi-threaded mode\n"
1228 " -v print version strings\n"
John Kessenich2a271162017-07-20 20:00:36 -06001229 " -w synonym for --suppress-warnings\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001230 " -x save binary output as text-based 32-bit hexadecimal numbers\n"
1231 " --auto-map-bindings automatically bind uniform variables\n"
1232 " without explicit bindings.\n"
1233 " --amb synonym for --auto-map-bindings\n"
1234 " --auto-map-locations automatically locate input/output lacking\n"
John Kessenichc178f0a2017-06-23 10:58:31 -06001235 " 'location' (fragile, not cross stage)\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001236 " --aml synonym for --auto-map-locations\n"
John Kessenich6353d552017-06-23 11:11:09 -06001237 " --client {vulkan<ver>|opengl<ver>} see -V and -G\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001238 " --flatten-uniform-arrays flatten uniform texture/sampler arrays to\n"
1239 " scalars\n"
1240 " --fua synonym for --flatten-uniform-arrays\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001241 " --hlsl-offsets Allow block offsets to follow HLSL rules\n"
1242 " Works independently of source language\n"
1243 " --hlsl-iomap Perform IO mapping in HLSL register space\n"
1244 " --keep-uncalled don't eliminate uncalled functions\n"
1245 " --ku synonym for --keep-uncalled\n"
1246 " --no-storage-format use Unknown image format\n"
1247 " --nsf synonym for --no-storage-format\n"
John Kessenich2a271162017-07-20 20:00:36 -06001248 " --relaxed-errors relaxed GLSL semantic error-checking mode\n"
LoopDawg52017192017-07-14 15:15:47 -06001249 " --resource-set-binding [stage] name set binding\n"
1250 " Set descriptor set and binding for individual resources\n"
1251 " --resource-set-binding [stage] set\n"
1252 " Set descriptor set for all resources\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001253 " --rsb [stage] type set binding synonym for --resource-set-binding\n"
1254 " --shift-image-binding [stage] num base binding number for images (uav)\n"
1255 " --sib [stage] num synonym for --shift-image-binding\n"
1256 " --shift-sampler-binding [stage] num base binding number for samplers\n"
1257 " --ssb [stage] num synonym for --shift-sampler-binding\n"
1258 " --shift-ssbo-binding [stage] num base binding number for SSBOs\n"
1259 " --sbb [stage] num synonym for --shift-ssbo-binding\n"
1260 " --shift-texture-binding [stage] num base binding number for textures\n"
1261 " --stb [stage] num synonym for --shift-texture-binding\n"
1262 " --shift-uav-binding [stage] num base binding number for UAVs\n"
1263 " --suavb [stage] num synonym for --shift-uav-binding\n"
1264 " --shift-UBO-binding [stage] num base binding number for UBOs\n"
1265 " --shift-cbuffer-binding [stage] num synonym for --shift-UBO-binding\n"
1266 " --sub [stage] num synonym for --shift-UBO-binding\n"
John Kessenicha25530c2017-09-11 20:13:49 -06001267 " --source-entrypoint <name> the given shader source function is\n"
1268 " renamed to be the <name> given in -e\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001269 " --sep synonym for --source-entrypoint\n"
Sven-Hendrik Haase0dd12852017-09-02 19:34:54 +02001270 " --stdin Read from stdin instead of from a file.\n"
1271 " You'll have to provide the shader stage\n"
1272 " using -S.\n"
John Kessenich2a271162017-07-20 20:00:36 -06001273 " --suppress-warnings suppress GLSL warnings\n"
1274 " (except as required by #extension : warn)\n"
1275 " --target-env {vulkan1.0|opengl} set the execution environment code will\n"
1276 " execute in (as opposed to language\n"
1277 " semantics selected by --client) defaults:\n"
1278 " 'vulkan1.0' under '--client vulkan<ver>'\n"
1279 " 'opengl' under '--client opengl<ver>'\n"
John Kessenich6263fb12017-06-14 15:52:44 -06001280 " --variable-name <name> Creates a C header file that contains a\n"
1281 " uint32_t array named <name>\n"
1282 " initialized with the shader binary code.\n"
1283 " --vn <name> synonym for --variable-name <name>\n"
John Kessenichb0a7eb52013-11-07 17:44:20 +00001284 );
John Kessenich68d78fd2015-07-12 19:28:10 -06001285
1286 exit(EFailUsage);
John Kessenicha0af4732012-12-12 21:15:54 +00001287}
1288
John Kessenich3ce4e592014-10-06 19:57:34 +00001289#if !defined _MSC_VER && !defined MINGW_HAS_SECURE_API
John Kessenichcfd643e2013-03-08 23:14:42 +00001290
1291#include <errno.h>
1292
1293int fopen_s(
1294 FILE** pFile,
John Kessenich51cdd902014-02-18 23:37:57 +00001295 const char* filename,
1296 const char* mode
John Kessenichcfd643e2013-03-08 23:14:42 +00001297)
1298{
1299 if (!pFile || !filename || !mode) {
1300 return EINVAL;
1301 }
1302
1303 FILE* f = fopen(filename, mode);
1304 if (! f) {
1305 if (errno != 0) {
1306 return errno;
1307 } else {
1308 return ENOENT;
1309 }
1310 }
1311 *pFile = f;
1312
1313 return 0;
1314}
1315
1316#endif
1317
John Kessenicha0af4732012-12-12 21:15:54 +00001318//
1319// Malloc a string of sufficient size and read a string into it.
1320//
John Kessenich04acb1b2017-06-14 17:36:50 -06001321char* ReadFileData(const char* fileName)
John Kessenicha0af4732012-12-12 21:15:54 +00001322{
John Kessenichb3297152015-07-11 18:01:03 -06001323 FILE *in = nullptr;
John Kessenich3ce4e592014-10-06 19:57:34 +00001324 int errorCode = fopen_s(&in, fileName, "r");
John Kessenich68d78fd2015-07-12 19:28:10 -06001325 if (errorCode || in == nullptr)
1326 Error("unable to open input file");
John Kessenichecba76f2017-01-06 00:34:48 -07001327
John Kessenich04acb1b2017-06-14 17:36:50 -06001328 int count = 0;
John Kessenicha0af4732012-12-12 21:15:54 +00001329 while (fgetc(in) != EOF)
1330 count++;
1331
John Kessenichd6c72a42014-08-18 19:42:35 +00001332 fseek(in, 0, SEEK_SET);
John Kessenichca3457f2015-05-18 01:59:45 +00001333
John Kessenich04acb1b2017-06-14 17:36:50 -06001334 char* return_data = (char*)malloc(count + 1); // freed in FreeFileData()
1335 if ((int)fread(return_data, 1, count, in) != count) {
1336 free(return_data);
John Kessenich68d78fd2015-07-12 19:28:10 -06001337 Error("can't read input file");
John Kessenicha0af4732012-12-12 21:15:54 +00001338 }
John Kessenich68d78fd2015-07-12 19:28:10 -06001339
John Kessenich04acb1b2017-06-14 17:36:50 -06001340 return_data[count] = '\0';
John Kessenicha0af4732012-12-12 21:15:54 +00001341 fclose(in);
John Kessenichb3297152015-07-11 18:01:03 -06001342
John Kessenicha0af4732012-12-12 21:15:54 +00001343 return return_data;
1344}
1345
John Kessenich04acb1b2017-06-14 17:36:50 -06001346void FreeFileData(char* data)
John Kessenicha0af4732012-12-12 21:15:54 +00001347{
John Kessenichb3297152015-07-11 18:01:03 -06001348 free(data);
John Kessenicha0af4732012-12-12 21:15:54 +00001349}
1350
John Kessenich54d8cda2013-02-11 22:36:01 +00001351void InfoLogMsg(const char* msg, const char* name, const int num)
John Kessenicha0af4732012-12-12 21:15:54 +00001352{
John Kessenichfae38ee2015-06-10 23:23:12 +00001353 if (num >= 0 )
1354 printf("#### %s %s %d INFO LOG ####\n", msg, name, num);
1355 else
1356 printf("#### %s %s INFO LOG ####\n", msg, name);
John Kessenicha0af4732012-12-12 21:15:54 +00001357}