texture-state-animation git:20260921.d4bf893A

Immutable. This exact content is served forever at /api/v1/blob/236400d3e0f6efea.

---
name: texture-state-animation
description: Design and validate texture-state transitions for Blender animations without ugly whole-image crossfades, texture popping, misregistered morphs, or target-engine-incompatible Python-only swaps. Use when animating between multiple source textures, mascot/logo states, style states, lightmaps, decals, or UI skins.
when_to_use: Texture state animation, texture morphs, material state transitions, image sequence planning, masked wipes, glow reveals, texture registration, avoiding bad crossfades, GLB-compatible texture animation planning.
allowed-tools: Read Bash Glob Grep mcp__blender__execute_blender_code mcp__blender__get_scene_info mcp__blender__get_object_info
---

# Texture State Animation

This skill exists because “crossfade several full images” usually looks bad. Texture animation must be designed like motion graphics: registered states, constrained transition channels, and preview gates.

## Failure modes to avoid

- Whole-frame crossfades between unrelated crops/compositions.
- Python frame handlers as the only playback mechanism when export/runtime support is needed.
- Texture swaps that change silhouette, camera crop, or scale at the same time as decorative motion.
- Mixing aura/background/HUD pixels into the avatar surface texture unless that is the intent.
- Morph pulses that break accepted geometry constraints such as constant depth.

## Workflow

1. **Register states first**: crop, scale, align, and color-normalize all source states into one canvas and one semantic mask.
2. **Classify pixels/layers**:
   - avatar surface/base;
   - facial decal/features;
   - glow/emission accents;
   - background/aura/context;
   - HUD/circle elements.
3. **Choose transition type per layer**, not one global blend:
   - avatar surface: hold, shimmer, subtle value/roughness pulse, or masked dissolve;
   - face features: hold or short opacity fade;
   - glow accents: emission pulse / traveling highlight;
   - aura/HUD: independent orbit/dash/dot animation;
   - background: separate plane/compositor, never baked into avatar unless requested.
4. **Use export-compatible channels when needed**:
   - keyframed material values, opacity, UV transform, shape keys, object transforms;
   - image sequence only if target supports it;
   - avoid Blender Python handlers for final GLB unless the target runtime will recreate them.
5. Render a contact sheet and flicker report before calling the animation acceptable.

## Acceptance gates

- Each texture state is registered to the same bbox/landmarks.
- No full-canvas crossfade is used unless state registration and semantics match.
- Avatar silhouette remains stable unless the story explicitly calls for a morph.
- Context/aura elements are separate from the avatar material.
- The exported format can reproduce the animation, or limitations are documented.

## Scripts

- `scripts/texture_transition_plan.py` creates a transition plan from source states and flags risky whole-frame crossfades.