28 lines
1.8 KiB
Markdown
28 lines
1.8 KiB
Markdown
# Usage in fabulous/canvas/frex shaders
|
|
## Getting started
|
|
All you need to do to access respackotps values is paste the following in a file where you want them according to your renderer:
|
|
|
|
| Renderer | Include snippet |
|
|
|------------------|-------------------------------------------------------------------------------------------------------------------|
|
|
| Canvas | `#include respackopts:config_supplier` |
|
|
| Vanilla/Fabulous | `//include respackopts:config_supplier` (this is done to avoid problems when loading shaders without respackopts) |
|
|
|
|
However, usually you will want to still have a pack that works if respackotps is not present. In that case, canvas will still load the file,
|
|
however, values that respackotps registers will not be available leading to compile errors.
|
|
To avoid this, I recommend creating a source file in your own shader which will load default values if respackotps isn't present. You can do that as follows:
|
|
```glsl
|
|
#include respackopts:config_supplier
|
|
|
|
#ifndef respackopts_loaded
|
|
// define your default values here
|
|
// Example:
|
|
// #define examplePack_someTexture
|
|
#endif
|
|
```
|
|
You will then need to include this file in the places you want to access its values.
|
|
|
|
## Using the values
|
|
All values respackotps exposes follow the form: `<id>_<entry>` or `<id>_<category>_<entry>`
|
|
To view the code respackotps generates for your pack, you can run the `/rpoc dump glsl` command in minecraft (You must enable the `debugCommands` config option for this).
|
|
This will create a frex.frag file in your .minecraft/respackotps directory containing the generated shader code (available since 2.7.0).
|