Poiyomi Shaders

https://www.poiyomi.com/
Admin
Poiyomi Shaders is a comprehensive shader system for Unity that provides toon, realistic, and...
Tokens:92,657
Snippets:1,345
Trust Score:8.4
Update:7 months ago
Show doc for...
Tokens:
Raw
### String Builders for Duplicate Modules (ShaderLab)

Source: https://www.poiyomi.com/modular-shader-system

This example demonstrates using Poiyomi's string builder syntax (`<ms_stringbuilder>`) to accumulate values across multiple instances of the same module. This is useful for managing shared keywords or conditions, ensuring that code is only compiled once or based on a combined state.

```ShaderLab
// Define a string builder (first instance creates, others append)  
<ms_stringbuilder::MY_ACCUMULATED_VALUE>initial_value  
  
// In subsequent instances, append to the builder  
<ms_stringbuilder::MY_ACCUMULATED_VALUE>|| additional_value  
  
// Use the accumulated value  
#if <ms_stringwriter::MY_ACCUMULATED_VALUE>  
    // Code using the combined condition  
#endif  
```

```ShaderLab
<ms_include_in_first>  
{  
    <ms_stringbuilder::_ANY_EMISSION_KEYWORD>defined(_EMISSION)  
}  
<ms_include_in_not_first>  
{  
    <ms_stringbuilder::_ANY_EMISSION_KEYWORD>|| defined(POI_EMISSION___mID__)  
}  
```

--------------------------------

### Integrate AudioLink Data

Source: https://www.poiyomi.com/modular-shader-system

Example of accessing AudioLink data from the PoiMods structure within a shader.

```HLSL
#ifdef POI_AUDIOLINK  
    if (poiMods.audioLinkAvailable)  
    {  
        float bassValue = poiMods.audioLink[0];     // Bass  
        float lowMidValue = poiMods.audioLink[1];   // Low Mid  
        float highMidValue = poiMods.audioLink[2];  // High Mid  
        float trebleValue = poiMods.audioLink[3];   // Treble  
        float volumeValue = poiMods.audioLink[4];   // Volume  
    }  
#endif
```

--------------------------------

### Poiyomi Shader Template Collection Structure

Source: https://www.poiyomi.com/modular-shader-system

Demonstrates the structure of a .poiTemplateCollection file, showing how shader code is organized into named sections using '#T#SectionName'. It includes examples of conditional compilation and property declarations.

```csharp
#T#YourModuleProperties  
//ifex _EnableYourModule==0  
[HideInInspector] m_start_yourModule (" Your Module--{reference_property:_EnableYourModule}", Float) = 0  
[HideInInspector][ThryToggle(POI_YOUR_MODULE)]_EnableYourModule ("Enable", Float) = 0  
_YourProperty ("Property Name", Range(0, 1)) = 0.5  
[HideInInspector] m_end_yourModule ("", Float) = 0  
//endex  
  
#T#YourModuleKeywords  
//ifex _EnableYourModule==0  
#pragma shader_feature_local POI_YOUR_MODULE  
//endex  
  
#T#YourModuleVariables  
//ifex _EnableYourModule==0  
#ifdef POI_YOUR_MODULE  
    float _YourProperty;  
#endif  
//endex  
  
#T#YourModuleFunction  
//ifex _EnableYourModule==0  
#ifdef POI_YOUR_MODULE  
    void ApplyYourModule(inout PoiFragData poiFragData, in PoiMesh poiMesh)  
    {  
        // Your shader logic here  
    }  
#endif  
//endex  
  
#T#YourModuleFunctionCall  
//ifex _EnableYourModule==0  
#ifdef POI_YOUR_MODULE  
    ApplyYourModule(poiFragData, poiMesh);  
#endif  
//endex  
```

--------------------------------

### Simple Color Tint Module Example (ShaderLab)

Source: https://www.poiyomi.com/modular-shader-system

This snippet demonstrates how to implement a simple color tint module in Poiyomi shader. It uses feature guards (`//ifex`, `#ifdef`) to conditionally compile code, ensuring that the color tint functionality is only included when enabled. It defines properties for tint color and strength, and a function to apply the tint to the fragment data.

```ShaderLab
#T#ColorTintProperties  
//ifex _EnableColorTint==0  
[HideInInspector] m_start_colorTint (" Color Tint--{reference_property:_EnableColorTint}", Float) = 0  
[HideInInspector][ThryToggle(POI_COLOR_TINT)]_EnableColorTint ("Enable", Float) = 0  
_TintColor ("Tint Color--{reference_property:_TintColorThemeIndex}", Color) = (1, 1, 1, 1)  
[HideInInspector][ThryWideEnum(Off, 0, Theme Color 0, 1, Theme Color 1, 2, Theme Color 2, 3, Theme Color 3, 4)] _TintColorThemeIndex ("", Int) = 0  
_TintStrength ("Strength", Range(0, 1)) = 1  
[HideInInspector] m_end_colorTint ("", Float) = 0  
//endex  
  
#T#ColorTintKeywords  
//ifex _EnableColorTint==0  
#pragma shader_feature_local POI_COLOR_TINT  
//endex  
  
#T#ColorTintVariables  
//ifex _EnableColorTint==0  
#ifdef POI_COLOR_TINT  
    float4 _TintColor;  
    float _TintColorThemeIndex;  
    float _TintStrength;  
#endif  
//endex  
  
#T#ColorTintFunction  
//ifex _EnableColorTint==0  
#ifdef POI_COLOR_TINT  
    void ApplyColorTint(inout PoiFragData poiFragData, in PoiMods poiMods)  
    {  
        float3 tint = poiThemeColor(poiMods, _TintColor.rgb, _TintColorThemeIndex);  
        poiFragData.baseColor.rgb = lerp(poiFragData.baseColor.rgb, poiFragData.baseColor.rgb * tint, _TintStrength);  
    }  
#endif  
//endex  
  
#T#ColorTintFunctionCall  
//ifex _EnableColorTint==0  
#ifdef POI_COLOR_TINT  
    ApplyColorTint(poiFragData, poiMods);  
#endif  
//endex  
```
Tokens:
Raw