yum-mirror/glslang
git clone https://git.yummers.dev/yum-mirror/glslang
6a0d48e4
main
1// 2// Copyright (C) 2014-2016 LunarG, Inc. 3// Copyright (C) 2018 Google, Inc. 4// 5// All rights reserved. 6// 7// Redistribution and use in source and binary forms, with or without 8// modification, are permitted provided that the following conditions 9// are met: 10// 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// 23// 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. 35 36// 37// Call into SPIRV-Tools to disassemble, validate, and optimize. 38// 39 40#pragma once 41#ifndef GLSLANG_SPV_TOOLS_H 42#define GLSLANG_SPV_TOOLS_H 43 44#if ENABLE_OPT 45#include <vector> 46#include <ostream> 47#include <unordered_set> 48#include "spirv-tools/libspirv.h" 49#endif 50 51#include "glslang/MachineIndependent/Versions.h" 52#include "glslang/Include/visibility.h" 53#include "GlslangToSpv.h" 54#include "Logger.h" 55 56namespace glslang { 57 58#if ENABLE_OPT 59 60class TIntermediate ; 61 62// Translate glslang's view of target versioning to what SPIRV-Tools uses. 63GLSLANG_EXPORT spv_target_env MapToSpirvToolsEnv (const SpvVersion & spvVersion ,spv ::SpvBuildLogger * logger ); 64GLSLANG_EXPORT spv_target_env MapToSpirvToolsEnv (const glslang ::TIntermediate & intermediate ,spv ::SpvBuildLogger * logger ); 65 66// Use the SPIRV-Tools disassembler to print SPIR-V using a SPV_ENV_UNIVERSAL_1_3 environment. 67GLSLANG_EXPORT void SpirvToolsDisassemble (std ::ostream & out ,const std ::vector < unsignedint >& spirv ); 68 69// Use the SPIRV-Tools disassembler to print SPIR-V with a provided SPIR-V environment. 70GLSLANG_EXPORT void SpirvToolsDisassemble (std ::ostream & out ,const std ::vector < unsignedint >& spirv , 71spv_target_env requested_context ); 72 73// Apply the SPIRV-Tools validator to generated SPIR-V. 74GLSLANG_EXPORT void SpirvToolsValidate (const glslang ::TIntermediate & intermediate ,std ::vector < unsignedint >& spirv , 75spv ::SpvBuildLogger * ,bool prelegalization ); 76 77// Apply the SPIRV-Tools optimizer to generated SPIR-V. HLSL SPIR-V is legalized in the process. 78GLSLANG_EXPORT void SpirvToolsTransform (const glslang ::TIntermediate & intermediate ,std ::vector < unsignedint >& spirv , 79spv ::SpvBuildLogger * ,const SpvOptions * ,bool prelegalization ); 80 81// Apply the SPIRV-Tools EliminateDeadInputComponents pass to generated SPIR-V. Put result in |spirv|. 82GLSLANG_EXPORT void SpirvToolsEliminateDeadInputComponents (spv_target_env target_env ,std ::vector < unsignedint >& spirv , 83spv ::SpvBuildLogger * ); 84 85// Apply the SPIRV-Tools AnalyzeDeadOutputStores pass to generated SPIR-V. Put result in |live_locs|. 86// Return true if the result is valid. 87GLSLANG_EXPORT bool SpirvToolsAnalyzeDeadOutputStores (spv_target_env target_env ,std ::vector < unsignedint >& spirv , 88std ::unordered_set < uint32_t >* live_locs , 89std ::unordered_set < uint32_t >* live_builtins , 90spv ::SpvBuildLogger * ); 91 92// Apply the SPIRV-Tools EliminateDeadOutputStores and AggressiveDeadCodeElimination passes to generated SPIR-V using 93// |live_locs|. Put result in |spirv|. 94GLSLANG_EXPORT void SpirvToolsEliminateDeadOutputStores (spv_target_env target_env ,std ::vector < unsignedint >& spirv , 95std ::unordered_set < uint32_t >* live_locs , 96std ::unordered_set < uint32_t >* live_builtins , 97spv ::SpvBuildLogger * ); 98 99// Apply the SPIRV-Tools optimizer to strip debug info from SPIR-V. This is implicitly done by 100// SpirvToolsTransform if spvOptions->stripDebugInfo is set, but can be called separately if 101// optimization is disabled. 102GLSLANG_EXPORT void SpirvToolsStripDebugInfo (const glslang ::TIntermediate & intermediate , 103std ::vector < unsignedint >& spirv ,spv ::SpvBuildLogger * ); 104 105#endif 106 107}// end namespace glslang 108 109#endif // GLSLANG_SPV_TOOLS_H