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/RToon/Details/03_Outline.md

View on GitHub
# Outline (描边)

RToon 使用经典的 **Inverted Hull (背面膨胀)** 技术来实现描边,并增加了一些独特的动态和噪点功能来模拟手绘感。

## 1. Properties (参数)

*   `_OutlineWidth` ("Width"): 全局描边宽度。
*   `_OutlineWidthControl` ("Width Control", 2D): 使用贴图控制局部描边宽度(如发梢变细)。
*   `_OutlineExtrudeMethod` ("Extrude Method"):
    *   **Normal**: 沿法线膨胀(标准做法,适合圆滑物体)。
    *   **Origin**: 沿物体中心膨胀(适合硬表面或分离的机械结构)。
*   `_OutlineOffset`: 整体偏移描边位置。
*   `_OutlineZPostionInCamera`: **[重要]** 调整描边在相机空间的 Z 值。用于解决描边遮挡物体本身的问题(Z-Fighting 或看起来像浮在表面)。
*   `_DoubleSidedOutline`: 是否双面渲染描边。
*   `_OutlineColor` ("Color"): 描边颜色。
*   `_MixMainTexToOutline`: 将主贴图颜色混合到描边中(让描边不那么生硬)。
*   `_LightAffectOutlineColor`: 描边颜色是否受光照影响(变暗)。

### 动态效果
*   `_NoisyOutlineIntensity`: 静态噪点强度,使线条看起来不直。
*   `_DynamicNoisyOutline`: **[特色]** 动态噪点,使线条像逐帧动画一样抖动。
*   `_OutlineWidthAffectedByViewDistance`: 随距离调整宽度(防止远处于变成一团黑,或近处太粗)。

## 2. Vertex Color Control (顶点色控制)

RToon 强依赖顶点色来微调描边:
*   **Blue Channel (蓝色通道)**: 控制描边宽度。
    *   值 `1.0` (白/蓝): 原始宽度。
    *   值 `0.0` (黑): 宽度为 0(隐藏描边)。
    *   *公式*: `FinalWidth = _OutlineWidth * (1.0 - vertexColor.b)` (注意:这里逻辑似乎是反的,或者是 `1.0` 代表受控程度?需看代码确认)。

## 3. Implementation (实现原理)

位于 `D_Default_URP.shader` 的 `Pass "Outline"`。

### Vertex Shader Logic

```glsl
Varyings LitPassVertex(Attributes input)
{
    // ... (DOTS / Instancing Setup) ...

    // 1. 距离缩放计算
    half RTD_OB_VP_CAL = distance(objPos.rgb, _WorldSpaceCameraPos);
    
    // 2. 顶点色宽度控制
    // 注意逻辑: 如果 vertexColor.b 越大,宽度越小 (1.0 - b)
    // 所以如果不涂色(0.0),则是满宽度。涂了蓝色(1.0),描边消失。
    half RTD_OL_VCRAOW_OO;
    if (!_VertexColorBlueAffectOutlineWitdh) {
        RTD_OL_VCRAOW_OO = _OutlineWidth;
    } else {
        RTD_OL_VCRAOW_OO = _OutlineWidth * (1.0 - output.vertexColor.b);
    }

    // 3. 视距修正
    half RTD_OL_OLWABVD_OO;
    if (!_OutlineWidthAffectedByViewDistance) {
        RTD_OL_OLWABVD_OO = RTD_OL_VCRAOW_OO;
    } else {
        // 随距离限制最大宽度
        RTD_OL_OLWABVD_OO = clamp(RTD_OL_VCRAOW_OO * RTD_OB_VP_CAL, RTD_OL_VCRAOW_OO, _FarDistanceMaxWidth);
    }

    // 4. 动态噪点 (Dynamic Noisy Outline)
    // 生成随机 UV 偏移
    #if N_F_DNO_ON
        // ... 计算 sin/cos 旋转 UV ...
        half2 RTD_OL_DNOL_OO = _8530; // 旋转后的 UV
    #else
        half2 RTD_OL_DNOL_OO = output.uv;
    #endif
    
    // 生成随机数 _1283
    // ...
    
    // 5. 最终挤出
    // 膨胀方向选择
    float3 _OEM = (!_OutlineExtrudeMethod) ? _LBS_CD_Normal : normalize(_LBS_CD_Position.xyz);
    
    // 计算最终宽度 (结合贴图控制 和 噪点)
    half RTD_OL = (RTD_OL_OLWABVD_OO * 0.01) * _OutlineWidthControl_var.r * lerp(1.0, _1283, _NoisyOutlineIntensity);
    
    // 应用挤出
    output.positionCS = mul(GetWorldToHClipMatrix(), mul(GetObjectToWorldMatrix(), float4((_LBS_CD_Position.xyz + _OutlineOffset.xyz * 0.01) + _OEM * RTD_OL, 1.0)));

    // 6. Z-Bias (防止穿模)
    output.positionCS.z -= _OutlineZPostionInCamera * 0.0005;

    return output;
}
```

### Fragment Shader Logic

*   **混色**:
    ```glsl
    // 混合主贴图
    half3 RTD_MMTTO_OO = _MixMainTexToOutline ? (_OutlineColor.rgb * _MainTex_var.rgb) : _OutlineColor.rgb;
    
    // 混合光照
    half3 RTD_OL_LAOC_OO = _LightAffectOutlineColor ? lerp(0, RTD_MMTTO_OO, lightColor.rgb) : RTD_MMTTO_OO;
    ```
*   **Fog**: 描边也会正确应用雾效。

## 4. Analysis (分析)

*   **反向控制**: 顶点色蓝色通道控制逻辑是 `1.0 - b`,这意味着**涂蓝色是消除描边**,默认黑色是保留描边。这符合直觉(默认不需要处理,特殊部位涂色消除)。
*   **动态噪点**: 通过在 Vertex Shader 中扰动挤出距离,实现了类似《Ed, Edd n Eddy》那种线条抖动的效果,非常适合手绘风格游戏。
*   **性能**: 单独 Pass 绘制,会增加 DrawCall 和顶点处理开销。
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