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/08_Outline.md

View on GitHub
# Outline

The Outline feature is a core component of the "toon" look, typically implemented using the **Inverted Hull** method (rendering the mesh inside-out and slightly larger).

## 1. Principles
The outline is rendered as a separate pass (or a specialized variant).

### Vertex Displacement
Vertices are pushed outward along their **Normals** in object space. To make the outline look consistent, lilToon also supports using a **Vector Map** (to smooth sharp edges) or **Vertex Colors** to control width.

### Inverted Hull (Pass Settings)
*   **Culling**: Set to `Front` (only backfaces are rendered).
*   **Offset**: Often adjusted to prevent Z-fighting with the main surface.

## 2. Properties
*   **_OutlineColor**: Color and transparency of the outline.
*   **_OutlineWidth**: Base width.
*   **_OutlineWidthMask**: Texture to scale the width (R channel).
*   **_OutlineFixWidth**: Controls how width changes with distance from camera (0 = 3D size, 1 = Screen size).
*   **_OutlineZBias**: Offsets the outline towards/away from the camera to fix depth issues.
*   **_OutlineVectorTex**: A normal map-like texture to define custom "push" directions.
*   **_OutlineLitColor**: Allows the outline to be affected by scene lights.

## 3. Implementation (Vertex Shader)
The vertex displacement logic is found in `lil_vert_outline.hlsl` and `lil_common_functions.hlsl`.

### Math Formula
1.  **Base Width**: $W_{base} = \text{Width} \times 0.01$
2.  **Masking**: $W_{mask} = W_{base} \times \text{Sample}(\text{WidthMask})$
3.  **Distance Scaling**:
    *   Makes the outline constant size on screen.
    *   $W_{final} = W_{mask} \times \text{lerp}(1.0, \text{DistanceToCamera}, \text{FixWidth})$
4.  **Displacement**: $Pos_{new} = Pos_{old} + Normal_{OS} \times W_{final}$

### Pseudo-Code (`lilCalcOutlinePosition`)
```hlsl
void lilCalcOutlinePosition(inout float3 positionOS, float3 normalOS, ...)
{
    // 1. Calculate the distance-fixed width
    float3 positionWS = TransformObjectToWorld(positionOS);
    float dist = length(CameraPosition - positionWS);
    
    float width = _OutlineWidth * 0.01;
    width *= Sample(WidthMask).r;
    
    // Scale width based on distance to keep it constant in screen-space
    width *= lerp(1.0, dist, _OutlineFixWidth);

    // 2. Select the extrusion vector
    float3 outlineN = normalOS;
    #if USE_VECTOR_TEX
        outlineN = UnpackNormal(Sample(OutlineVectorTex));
    #endif

    // 3. Extrude
    positionOS += outlineN * width;

    // 4. Apply Z-Bias (push away from camera to avoid clipping)
    float3 viewDirOS = normalize(CameraPosOS - positionOS);
    positionOS -= viewDirOS * _OutlineZBias;
}
```

## 4. Implementation (Fragment Shader)
The fragment shader handles the coloring and optional lighting of the outline.

```hlsl
#define OVERRIDE_OUTLINE_COLOR \
    // 1. Sample texture
    fd.col = Sample(_OutlineTex, uv);
    
    // 2. Adjust HSVG
    fd.col.rgb = lilToneCorrection(fd.col.rgb, _OutlineTexHSVG);
    
    // 3. Apply Lighting
    // Check dot product of Light and Normal
    float factor = saturate(NdotL * _LitScale + _LitOffset);
    fd.col.rgb = lerp(fd.col.rgb * _OutlineColor, _OutlineLitColor, factor);
```

## 5. Variants
*   **`lts_o.shader`**: Standard shader including an Outline pass.
*   **`lts_oo.shader`**: **Outline Only**. Contains ONLY the outline rendering pass.

```
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: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated 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: 323kUpdated Claude CodeCodexVerifiedInstall