Skip to content

LeoYeAI/agent-master-skills / skills/animation-shader

animation-shader

Verified

READ this skill when implementing or configuring animation-style shaders (Toon/Cel Shaders) — including outlines, rim lighting, toon shading, MatCap, emission, dissolve, hatching, or any stylized rendering effect. Contains preset styles and feature-to-reference mappings for lilToon, Poiyomi, UTS2, RToon, SToon, and ToonShadingCollection. Works as a domain knowledge plugin alongside workflow skills (OpenSpec, SpecKit) or plan mode of an agent.

FileKindSize
SKILL.mdskill md17.0 KB
_meta.jsonconfig285 B
references/PoiyomiShaders/Details/01_Base_Main.mdmarkdown4.8 KB
references/PoiyomiShaders/Details/02_Lighting_Shadows.mdmarkdown4.9 KB
references/PoiyomiShaders/Details/03_Surface_Reflections.mdmarkdown3.9 KB
references/PoiyomiShaders/Details/04_Special_Effects.mdmarkdown3.4 KB
references/PoiyomiShaders/Details/05_Outline.mdmarkdown2.6 KB
references/PoiyomiShaders/Features.mdmarkdown2.1 KB
references/RToon/Details/01_Core_Shading.mdmarkdown5.3 KB
references/RToon/Details/02_ShadowT.mdmarkdown3.1 KB
references/RToon/Details/03_Outline.mdmarkdown4.6 KB
references/RToon/Details/04_MatCap_Reflection.mdmarkdown3.6 KB
references/RToon/Details/05_Gloss_Rim.mdmarkdown3.2 KB
references/RToon/Details/06_Advanced_Features.mdmarkdown3.3 KB
references/RToon/Features.mdmarkdown4.2 KB
references/SToon/Details/01_Core_Shading.mdmarkdown3.4 KB
references/SToon/Details/02_Outline.mdmarkdown2.9 KB
references/SToon/Details/03_Overlays.mdmarkdown3.1 KB
references/SToon/Details/04_Specular_Rim.mdmarkdown2.7 KB
references/SToon/Details/05_Artistic_Controls.mdmarkdown3.2 KB
references/SToon/Features.mdmarkdown2.6 KB
references/ToonShadingCollection/Details/01_ArtStyles.mdmarkdown2.5 KB
references/ToonShadingCollection/Details/02_Outline.mdmarkdown4.4 KB
references/ToonShadingCollection/Details/03_Diffuse.mdmarkdown4.5 KB
references/ToonShadingCollection/Details/04_Specular.mdmarkdown3.2 KB
references/ToonShadingCollection/Details/05_Environment.mdmarkdown3.1 KB
references/ToonShadingCollection/Details/06_PBR_Stylization.mdmarkdown4.6 KB
references/ToonShadingCollection/Details/07_Stylized_Features.mdmarkdown4.0 KB
references/ToonShadingCollection/Details/08_PostProcessing.mdmarkdown3.5 KB
references/ToonShadingCollection/Details/09_Lighting_Shadows.mdmarkdown3.1 KB
references/ToonShadingCollection/Details/10_Animation_VFX.mdmarkdown3.7 KB
references/ToonShadingCollection/Details/11_Modeling_Pipeline.mdmarkdown2.9 KB
references/ToonShadingCollection/Features.mdmarkdown2.1 KB
references/UnityChanToonShaderVer2/Details/01_DoubleShade.mdmarkdown3.6 KB
references/UnityChanToonShaderVer2/Details/02_ShadingGradeMap.mdmarkdown3.1 KB
references/UnityChanToonShaderVer2/Details/03_Outline.mdmarkdown2.7 KB
references/UnityChanToonShaderVer2/Details/04_SpecialFeatures.mdmarkdown3.6 KB
references/UnityChanToonShaderVer2/Features.mdmarkdown5.6 KB
references/lilToon/Details/01_Base_Main.mdmarkdown4.8 KB
references/lilToon/Details/02_Lighting_Shadows.mdmarkdown3.9 KB
references/lilToon/Details/03_Surface_Reflections.mdmarkdown4.2 KB
references/lilToon/Details/04_Special_Effects.mdmarkdown4.7 KB
references/lilToon/Details/05_Advanced.mdmarkdown3.9 KB
references/lilToon/Details/06_Variants.mdmarkdown3.4 KB
references/lilToon/Details/07_Variant_Features.mdmarkdown4.8 KB
references/lilToon/Details/08_Outline.mdmarkdown3.3 KB
references/lilToon/Features.mdmarkdown3.3 KB
workflow-standalone.mdmarkdown6.4 KB

references/lilToon/Details/02_Lighting_Shadows.md

View on GitHub
# Lighting & Shadows

## 1. Shadows & Toon Shading
lilToon employs a sophisticated 3-layer shadow system blended with a "Toon Stepping" function to create stylized shading.

### Properties
*   **_UseShadow**: Enable shadows.
*   **_ShadowStrength**: Overall shadow strength.
*   **_ShadowColor**, **_Shadow2ndColor**, **_Shadow3rdColor**: Colors for the shadow layers.
*   **_ShadowBorder**, **_ShadowBlur**: Control the edge sharpness and position of the shadow.
*   **_ShadowReceive**: Influence of received shadows (cast by other objects).
*   Masks: `_ShadowBorderMask`, `_ShadowBlurMask`, `_ShadowStrengthMask`.

### Implementation Call
The shadow logic is in `lilGetShading` (lil_common_frag.hlsl), called via `OVERRIDE_SHADOW`.

```hlsl
#define OVERRIDE_SHADOW \
    lilGetShading(fd LIL_SAMP_IN(sampler_MainTex));
```

### Principles & Math

**Toon Stepping Function (`lilTooningScale`)**
Maps the input value (NdotL) through a step function controlled by a `Border` and `Blur` parameter.
$Value' = \frac{Value - (Border - Blur/2)}{Blur}$

```hlsl
float lilTooningScale(float aascale, float value, float border, float blur) {
    float borderMin = saturate(border - blur * 0.5);
    float borderMax = saturate(border + blur * 0.5);
    return saturate((value - borderMin) / (borderMax - borderMin));
}
```

**Shadow Logic (`lilGetShading` Pseudo-Code)**
1.  **Calculate NdotL**:
    ```hlsl
    // Can blend normal map with geometric normal per layer
    float3 N1 = lerp(fd.origN, fd.N, _ShadowNormalStrength);
    float NdotL = dot(LightDir, N1) * 0.5 + 0.5;
    ```
2.  **Apply Received Shadows**:
    ```hlsl
    float shadowAtten = saturate(LightAttenuation + distance(LightDir, OriginalLightDir));
    NdotL *= lerp(1.0, shadowAtten, _ShadowReceive);
    ```
3.  **Apply AO/Border Mask**:
    ```hlsl
    float mask = Sample(ShadowBorderMask);
    mask = mask * Shift + Offset;
    NdotL *= mask; 
    ```
4.  **Apply Toon Step**:
    ```hlsl
    float shadowMix = lilTooningScale(1.0, NdotL, _ShadowBorder, _ShadowBlur);
    ```
5.  **Final Color Blend**:
    ```hlsl
    FinalColor = lerp(ShadowColor, BaseColor, shadowMix);
    ```

## 2. Backlight
Simulates light coming from behind the object, creating a rim-like effect or subsurface scattering approximation.

### Properties
*   **_BacklightColor**: Color of the backlight.
*   **_BacklightMainStrength**: How much it blends with the main color.
*   **_BacklightDirectivity**: Focus of the light.
*   **_BacklightViewStrength**: Influence of view direction.
*   **_BacklightBorder**, **_BacklightBlur**: Toon stepping parameters.

### Implementation Call
Implemented in `lilBacklight` (lil_common_frag.hlsl), called via `OVERRIDE_BACKLIGHT`.

```hlsl
#define OVERRIDE_BACKLIGHT lilBacklight(fd LIL_SAMP_IN(sampler_MainTex));
```

### Principles & Math
It combines the "Half Vector" (or view alignment) with the light alignment.

**Formula:**
1.  **Directivity Factor**: $Factor = saturate(-HalfVector \cdot Normal)^{Directivity}$
2.  **View & Light Alignment**: $LightNormal = dot(normalize(-ViewDir \cdot ViewStrength + LightDir), Normal)$

**Function (`lilBacklight` Pseudo-Code):**
```hlsl
void lilBacklight(...) {
    // 1. Calculate Backlight Intensity
    // fd.hl is the Half Vector (bisector of View and Light)
    float backlightFactor = pow(saturate(-dot(HalfVector, Normal) * 0.5 + 0.5), _BacklightDirectivity);
    
    // 2. Adjust based on View Strength
    float3 virtualLightDir = normalize(-ViewDir * _BacklightViewStrength + LightDir);
    float backlightLN = dot(virtualLightDir, Normal) * 0.5 + 0.5;
    
    // 3. Toon Step (Sharpen the effect)
    backlightLN = lilTooningScale(1.0, backlightLN, _BacklightBorder, _BacklightBlur);
    
    float finalBacklight = saturate(backlightFactor * backlightLN);

    // 4. Add to Color
    float3 resultColor = lerp(_BacklightColor, _BacklightColor * Albedo, _BacklightMainStrength);
    FinalColor += finalBacklight * resultColor * LightColor;
}
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall