ShaderConductor/README.md

75 строки
3.5 KiB
Markdown
Исходник Постоянная ссылка Обычный вид История

2018-11-08 10:24:30 +03:00
# ShaderConductor
2018-11-02 04:19:29 +03:00
[![Build Status](https://dev.azure.com/msft-ShaderConductor/public/_apis/build/status/ShaderConductor-CI)](https://dev.azure.com/msft-ShaderConductor/public/_build/latest?definitionId=1)
[![License](https://img.shields.io/github/license/mashape/apistatus.svg)](LICENSE)
2018-11-08 10:24:30 +03:00
ShaderConductor is a tool designed for cross-compiling HLSL to other shading languages.
2018-11-02 04:19:29 +03:00
2018-11-08 10:24:30 +03:00
## Features
2018-11-02 04:19:29 +03:00
2018-11-08 10:24:30 +03:00
* Converts HLSL to readable, usable and efficient GLSL
* Converts HLSL to readable, usable and efficient ESSL
* Converts HLSL to readable, usable and efficient Metal Shading Language (MSL)
* Converts HLSL to readable, usable and efficient old shader model HLSL
* Supports all stages of shaders, vertex, pixel, hull, domain, geometry, and compute.
Note that this project is still in an early stage, and it is under active development.
## Architecture
ShaderConductor is not a real compiler. Instead, it glues existing open source components to do the cross-compiling.
1. [DirectX Shader Compiler](https://github.com/Microsoft/DirectXShaderCompiler) to compile HLSL to [DXIL](https://github.com/Microsoft/DirectXShaderCompiler/blob/master/docs/DXIL.rst) or [SPIR-V](https://www.khronos.org/registry/spir-v/),
1. [SPIRV-Cross](https://github.com/KhronosGroup/SPIRV-Cross) to convert SPIR-V to target shading languages.
![Architecture](Doc/Arch.svg)
## Prerequisites
* [Git](http://git-scm.com/downloads). Put git into the PATH is recommended.
2018-11-08 10:24:30 +03:00
* [Visual Studio 2017](https://www.visualstudio.com/downloads). Select the following workloads: Universal Windows Platform Development and Desktop Development with C++.
* [CMake](https://www.cmake.org/download/). Version 3.9 or up. It's highly recommended to choose "Add CMake to the system PATH for all users" during installation.
* [Python](https://www.python.org/downloads/). Version 2.7 or up. You need not change your PATH variable during installation.
## Building
ShaderConductor has been tested on Windows, Linux, and macOS.
2018-11-08 10:24:30 +03:00
### The script way:
```
BuildAll.py <BuildSystem> <Compiler> <Architecture> <Configuration>
```
where,
* \<BuildSystem\> can be ninja or vs2017. Default is vs2017.
* \<Compiler\> can be vc141 on Windows, gcc or clang on Linux, clang on macOS.
* \<Architecture\> must be x64 (for now).
* \<Configuration\> can be Debug, Release, RelWithDebInfo, or MinSizeRel. Default is Release.
This script automatically grabs external dependencies to External folder, generates project file in Build/\<BuildSystem\>-\<Compiler\>-\<Platform\>-\<Architecture\>[-\<Configuration\>], and builds it.
2018-11-08 10:24:30 +03:00
### The manual way:
```
mkdir Build
cd Build
cmake -G "Visual Studio 15" -T host=x64 -A x64 ../
2018-11-08 10:24:30 +03:00
cmake --build .
```
After building, the output file ShaderConductor.dll can be located in \<YourCMakeTargetFolder\>/Bin/\<Configuration\>/. It depends on dxcompiler.dll in the same folder.
### Artifacts
You can download [the prebuilt binaries generated by CI system](https://dev.azure.com/msft-ShaderConductor/public/_build/latest?definitionId=1&view=results). Currently, artifacts for Windows, Linux, macOS are published every commit.
2018-11-08 10:24:30 +03:00
## License
ShaderConductor is distributed under the terms of MIT License. See [LICENSE](LICENSE) for details.
## Code of Conduct
2018-11-02 04:19:29 +03:00
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.