HLSL Parser and GLSL code generator (emscripten version)
C++ HTML Lua
Pull request Compare This branch is 11 commits ahead, 101 commits behind Thekla:master.
Latest commit 1fbe9a2 Feb 19, 2015 @zz85 Update README
Permalink
Failed to load latest commit information.
src
LICENSE
README.md
hlslparser.js
hlslparser.js.mem
index.html
premake4.lua

README.md

Warning

Here lies a emscripten port of HLSLPaser. This port is basically modifications on Ignacio Castaño's (used for The Witness) improvements for Max McGuire's version of HLSLParser (used for Natural Selection).

If you like this, you may also find my port for GLSL Optimizer interesting.

Usage

emcc src/*.cpp -o hlslparser.js -s EXPORTED_FUNCTIONS="['_parseHLSL']" --bind -O3

Demo here.

hlslparser

HLSL Parser and GLSL code generator

This is the code we used in Natural Selection 2 to convert HLSL shader code to GLSL for use with OpenGL. The code is pulled from a larger codebase and has some dependencies which have been replaced with stubs. These dependencies are all very basic (array classes, memory allocators, etc.) so replacing them with our own equivalent should be simple if you want to use this code.

The parser is designed to work with HLSL code written in the legacy Direct3D 9 style (e.g. D3DCOMPILE_ENABLE_BACKWARDS_COMPATIBILITY should be used with D3D11). The parser works with cbuffers for uniforms, so in addition to generating GLSL, there is a class provided for generating D3D9-compatible HLSL which doesn't support cbuffers. The GLSL code requires version 3.1 for support of uniform blocks. The parser is designed to catch all errors and generate "clean" GLSL which can then be compiled without any errors.

The HLSL parsing is done though a basic recursive descent parser coded by hand rather than using a parser generator. We believe makes the code easier to understand and work with.

To get consistent results from Direct3D and OpenGL, our engine renders in OpenGL "upside down". This is automatically added into the generated GLSL vertex shaders.

Although this code was written specifically for our use, we hope that it may be useful as an educational tool or a base for someone who wants to do something similar.