Index: third_party/shaderc/shaderc.h |
diff --git a/third_party/shaderc/shaderc.h b/third_party/shaderc/shaderc.h |
deleted file mode 100644 |
index 2d2af14b6be24bc21677689c8798c24f7d648fd8..0000000000000000000000000000000000000000 |
--- a/third_party/shaderc/shaderc.h |
+++ /dev/null |
@@ -1,327 +0,0 @@ |
-// Copyright 2015 The Shaderc Authors. All rights reserved. |
-// |
-// Licensed under the Apache License, Version 2.0 (the "License"); |
-// you may not use this file except in compliance with the License. |
-// You may obtain a copy of the License at |
-// |
-// http://www.apache.org/licenses/LICENSE-2.0 |
-// |
-// Unless required by applicable law or agreed to in writing, software |
-// distributed under the License is distributed on an "AS IS" BASIS, |
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
-// See the License for the specific language governing permissions and |
-// limitations under the License. |
- |
-#ifndef SHADERC_H_ |
-#define SHADERC_H_ |
- |
-#ifdef __cplusplus |
-extern "C" { |
-#endif |
- |
-#include <stdbool.h> |
-#include <stddef.h> |
-#include <stdint.h> |
- |
-typedef enum { |
- // Forced shader kinds. These shader kinds force the compiler to compile the |
- // source code as the specified kind of shader. |
- shaderc_glsl_vertex_shader, |
- shaderc_glsl_fragment_shader, |
- shaderc_glsl_compute_shader, |
- shaderc_glsl_geometry_shader, |
- shaderc_glsl_tess_control_shader, |
- shaderc_glsl_tess_evaluation_shader, |
- // Deduce the shader kind from #pragma annotation in the source code. Compiler |
- // will emit error if #pragma annotation is not found. |
- shaderc_glsl_infer_from_source, |
- // Default shader kinds. Compiler will fall back to compile the source code as |
- // the specified kind of shader when #pragma annotation is not found in the |
- // source code. |
- shaderc_glsl_default_vertex_shader, |
- shaderc_glsl_default_fragment_shader, |
- shaderc_glsl_default_compute_shader, |
- shaderc_glsl_default_geometry_shader, |
- shaderc_glsl_default_tess_control_shader, |
- shaderc_glsl_default_tess_evaluation_shader, |
-} shaderc_shader_kind; |
- |
-typedef enum { |
- shaderc_target_env_vulkan, // create SPIR-V under Vulkan semantics |
- shaderc_target_env_opengl, // create SPIR-V under OpenGL semantics |
- shaderc_target_env_opengl_compat, // create SPIR-V under OpenGL semantics, |
- // including compatibility profile |
- // functions |
- shaderc_target_env_default = shaderc_target_env_vulkan |
-} shaderc_target_env; |
- |
-typedef enum { |
- shaderc_profile_none, // Used if and only if GLSL version did not specify |
- // profiles. |
- shaderc_profile_core, |
- shaderc_profile_compatibility, |
- shaderc_profile_es, |
-} shaderc_profile; |
- |
-// Used in the result module (shaderc_spv_module) to indicate the status of an |
-// compilation. |
-typedef enum { |
- shaderc_compilation_status_success = 0, |
- shaderc_compilation_status_invalid_stage, // error stage deduction |
- shaderc_compilation_status_compilation_error, |
- shaderc_compilation_status_internal_error, // unexpected failure |
- shaderc_compilation_status_null_result_module, |
-} shaderc_compilation_status; |
- |
-// Usage examples: |
-// |
-// Aggressively release compiler resources, but spend time in initialization |
-// for each new use. |
-// shaderc_compiler_t compiler = shaderc_compiler_initialize(); |
-// shader_spv_module_t module = shaderc_compile_into_spv(compiler, |
-// "int main() {}", 13, shaderc_glsl_vertex_shader, "main"); |
-// // Do stuff with module compilation results. |
-// shaderc_module_release(module); |
-// shaderc_compiler_release(compiler); |
-// |
-// Keep the compiler object around for a long time, but pay for extra space |
-// occupied. |
-// shaderc_compiler_t compiler = shaderc_compiler_initialize(); |
-// // On the same, other or multiple simultaneous threads. |
-// shader_spv_module_t module = shaderc_compile_into_spv(compiler, |
-// "int main() {}", 13, shaderc_glsl_vertex_shader, "main"); |
-// // Do stuff with module compilation results. |
-// shaderc_module_release(module); |
-// // Once no more compilations are to happen. |
-// shaderc_compiler_release(compiler); |
- |
-// An opaque handle to an object that manages all compiler state. |
-typedef struct shaderc_compiler* shaderc_compiler_t; |
- |
-// Returns a shaderc_compiler_t that can be used to compile modules. |
-// A return of NULL indicates that there was an error initializing the compiler. |
-// Any function operating on shaderc_compiler_t must offer the basic |
-// thread-safety guarantee. |
-// [http://herbsutter.com/2014/01/13/gotw-95-solution-thread-safety-and-synchronization/] |
-// That is: concurrent invocation of these functions on DIFFERENT objects needs |
-// no synchronization; concurrent invocation of these functions on the SAME |
-// object requires synchronization IF AND ONLY IF some of them take a non-const |
-// argument. |
-shaderc_compiler_t shaderc_compiler_initialize(void); |
- |
-// Releases the resources held by the shaderc_compiler_t. |
-// After this call it is invalid to make any future calls to functions |
-// involving this shaderc_compiler_t. |
-void shaderc_compiler_release(shaderc_compiler_t); |
- |
-// An opaque handle to an object that manages options to a single compilation |
-// result. |
-typedef struct shaderc_compile_options* shaderc_compile_options_t; |
- |
-// Returns a default-initialized shaderc_compile_options_t that can be used |
-// to modify the functionality of a compiled module. |
-// A return of NULL indicates that there was an error initializing the options. |
-// Any function operating on shaderc_compile_options_t must offer the |
-// basic thread-safety guarantee. |
-shaderc_compile_options_t shaderc_compile_options_initialize(void); |
- |
-// Returns a copy of the given shaderc_compile_options_t. |
-// If NULL is passed as the parameter the call is the same as |
-// shaderc_compile_options_init. |
-shaderc_compile_options_t shaderc_compile_options_clone( |
- const shaderc_compile_options_t options); |
- |
-// Releases the compilation options. It is invalid to use the given |
-// shaderc_compile_options_t object in any future calls. It is safe to pass |
-// NULL to this function, and doing such will have no effect. |
-void shaderc_compile_options_release(shaderc_compile_options_t options); |
- |
-// Adds a predefined macro to the compilation options. This has the |
-// same effect as passing -Dname=value to the command-line compiler. |
-// If value is NULL, it has the effect same as passing -Dname to the |
-// command-line compiler. If a macro definition with the same name has |
-// previously been added, the value is replaced with the new value. |
-// The null-terminated strings that the name and value parameters point to |
-// must remain valid for the duration of the call, but can be modified or |
-// deleted after this function has returned. |
-void shaderc_compile_options_add_macro_definition( |
- shaderc_compile_options_t options, const char* name, const char* value); |
- |
-// Sets the compiler mode to generate debug information in the output. |
-void shaderc_compile_options_set_generate_debug_info( |
- shaderc_compile_options_t options); |
- |
-// Sets the compiler mode to emit a disassembly text instead of a binary. In |
-// this mode, the byte array result in the shaderc_spv_module returned |
-// from shaderc_compile_into_spv() will consist of SPIR-V assembly text. |
-// Note the preprocessing only mode overrides this option, and this option |
-// overrides the default mode generating a SPIR-V binary. |
-void shaderc_compile_options_set_disassembly_mode( |
- shaderc_compile_options_t options); |
- |
-// Forces the GLSL language version and profile to a given pair. The version |
-// number is the same as would appear in the #version annotation in the source. |
-// Version and profile specified here overrides the #version annotation in the |
-// source. Use profile: 'shaderc_profile_none' for GLSL versions that do not |
-// define profiles, e.g. versions below 150. |
-void shaderc_compile_options_set_forced_version_profile( |
- shaderc_compile_options_t options, int version, shaderc_profile profile); |
- |
-// To support file inclusion, libshaderc invokes a callback into its client to |
-// resolve the full path and content of the included file. |
-// The client callback should follow the specified function signature below, and |
-// it should be passed to libshaderc through the corresponding setter function. |
-// When the including of a file is done, libshaderc will call another client |
-// callback to clean up the resources used for the including process. The client |
-// should implement the clean up method and pass it to libshaderc together with |
-// the response method. |
- |
-// The struct that contains the information to be returned to the libshaderc. |
-// The client-side implemented response method should return a pointer of this |
-// struct. The underlying data is owned by client code. |
-struct shaderc_includer_response { |
- const char* path; |
- size_t path_length; |
- const char* content; |
- size_t content_length; |
-}; |
- |
-// The function signature of the client-side implemented response method. It |
-// returns a pointer to shaderc_includer_response struct. |
-typedef shaderc_includer_response* (*shaderc_includer_response_get_fn)( |
- void* user_data, const char* filename); |
- |
-// The function signature of the client-side implemented clean-up method. |
-// Includer will call this callback function when the including process is done |
-// with the fullpath and content data. |
-typedef void (*shaderc_includer_response_release_fn)( |
- void* user_data, shaderc_includer_response* data); |
- |
-// Sets the callback functions for the includer. When the includer queries for |
-// the full path and content of a file, client's method will be called to |
-// response. And when the query is done, client will be notified to clean up. |
-// TODO: File inclusion needs to be context-aware. |
-// e.g. |
-// In file: /path/to/main_shader.vert: |
-// #include "include/a" |
-// In file: /path/to/include/a": |
-// #include "b" |
-// When compiling /path/to/main_shader.vert, the compiler should be able to |
-// go to /path/to/include/b to find the file b. |
-// This needs context info from compiler to client includer, and may needs |
-// interface changes. |
-void shaderc_compile_options_set_includer_callbacks( |
- shaderc_compile_options_t options, shaderc_includer_response_get_fn getter, |
- shaderc_includer_response_release_fn releasor, void* user_data); |
- |
-// Sets the compiler mode to do only preprocessing. The byte array result in the |
-// module returned by the compilation is the text of the preprocessed shader. |
-// This option overrides all other compilation modes, such as disassembly mode |
-// and the default mode of compilation to SPIR-V binary. |
-void shaderc_compile_options_set_preprocessing_only_mode( |
- shaderc_compile_options_t options); |
- |
-// Sets the compiler mode to suppress warnings, overriding warnings-as-errors |
-// mode. When both suppress-warnings and warnings-as-errors modes are |
-// turned on, warning messages will be inhibited, and will not be emitted |
-// as error messages. |
-void shaderc_compile_options_set_suppress_warnings( |
- shaderc_compile_options_t options); |
- |
-// Sets the target shader environment, affecting which warnings or errors will |
-// be issued. The version will be for distinguishing between different versions |
-// of the target environment. "0" is the only supported version at this point |
-void shaderc_compile_options_set_target_env(shaderc_compile_options_t options, |
- shaderc_target_env target, |
- uint32_t version); |
- |
-// Sets the compiler mode to treat all warnings as errors. Note the |
-// suppress-warnings mode overrides this option, i.e. if both |
-// warning-as-errors and suppress-warnings modes are set, warnings will not |
-// be emitted as error messages. |
-void shaderc_compile_options_set_warnings_as_errors( |
- shaderc_compile_options_t options); |
- |
-// An opaque handle to the results of a call to shaderc_compile_into_spv(). |
-typedef struct shaderc_spv_module* shaderc_spv_module_t; |
- |
-// Takes a GLSL source string and the associated shader kind, input file |
-// name, compiles it according to the given additional_options. If the shader |
-// kind is not set to a specified kind, but shaderc_glslc_infer_from_source, |
-// the compiler will try to deduce the shader kind from the source |
-// string and a failure in deducing will generate an error. Currently only |
-// #pragma annotation is supported. If the shader kind is set to one of the |
-// default shader kinds, the compiler will fall back to the default shader |
-// kind in case it failed to deduce the shader kind from source string. |
-// The input_file_name is a null-termintated string. It is used as a tag to |
-// identify the source string in cases like emitting error messages. It |
-// doesn't have to be a 'file name'. |
-// By default the source string will be compiled into SPIR-V binary |
-// and a shaderc_spv_module will be returned to hold the results of the |
-// compilation. When disassembly mode or preprocessing only mode is enabled |
-// in the additional_options, the source string will be compiled into char |
-// strings and held by the returned shaderc_spv_module. The entry_point_name |
-// null-terminated string defines the name of the entry point to associate |
-// with this GLSL source. If the additional_options parameter is not NULL, |
-// then the compilation is modified by any options present. May be safely |
-// called from multiple threads without explicit synchronization. If there |
-// was failure in allocating the compiler object NULL will be returned. |
-shaderc_spv_module_t shaderc_compile_into_spv( |
- const shaderc_compiler_t compiler, const char* source_text, |
- size_t source_text_size, shaderc_shader_kind shader_kind, |
- const char* input_file_name, const char* entry_point_name, |
- const shaderc_compile_options_t additional_options); |
- |
-// The following functions, operating on shaderc_spv_module_t objects, offer |
-// only the basic thread-safety guarantee. |
- |
-// Releases the resources held by module. It is invalid to use module for any |
-// further operations. |
-void shaderc_module_release(shaderc_spv_module_t module); |
- |
-// Returns true if the result in module was a successful compilation. |
-bool shaderc_module_get_success(const shaderc_spv_module_t module); |
- |
-// Returns the number of bytes in a SPIR-V module result string. When the module |
-// is compiled with disassembly mode or preprocessing only mode, the result |
-// string is a char string. Otherwise, the result string is binary string. |
-size_t shaderc_module_get_length(const shaderc_spv_module_t module); |
- |
-// Returns the number of warnings generated during the compilation. |
-size_t shaderc_module_get_num_warnings(const shaderc_spv_module_t module); |
- |
-// Returns the number of errors generated during the compilation. |
-size_t shaderc_module_get_num_errors(const shaderc_spv_module_t module); |
- |
-// Returns the compilation status, indicating whether the compilation succeeded, |
-// or failed due to some reasons, like invalid shader stage or compilation |
-// errors. |
-shaderc_compilation_status shaderc_module_get_compilation_status( |
- const shaderc_spv_module_t); |
- |
-// Returns a pointer to the start of the SPIR-V bytes, either SPIR-V binary or |
-// char string. When the source string is compiled into SPIR-V binary, this is |
-// guaranteed to be castable to a uint32_t*. If the source string is compiled in |
-// disassembly mode or preprocessing only mode, the pointer will point to the |
-// result char string. |
-const char* shaderc_module_get_bytes(const shaderc_spv_module_t module); |
- |
-// Returns a null-terminated string that contains any error messages generated |
-// during the compilation. |
-const char* shaderc_module_get_error_message(const shaderc_spv_module_t module); |
- |
-// Provides the version & revision of the SPIR-V which will be produced |
-void shaderc_get_spv_version(unsigned int* version, unsigned int* revision); |
- |
-// Parses the version and profile from a given null-terminated string |
-// containing both version and profile, like: '450core'. Returns false if |
-// the string can not be parsed. Returns true when the parsing succeeds. The |
-// parsed version and profile are returned through arguments. |
-bool shaderc_parse_version_profile(const char* str, int* version, |
- shaderc_profile* profile); |
- |
-#ifdef __cplusplus |
-} |
-#endif // __cplusplus |
- |
-#endif // SHADERC_H_ |