# cutan

> Cut-out animation for an: rigged characters, faces, lip-sync and styles, as a genre package on the an core.


## Pages in this subsection

- [cutan](cutan.html.md): cutan: cut-out animation, as a genre package on the `an` core.
- [cutan.audio](cutan.audio.html.md): The cut-out genre’s lip-sync providers: letters, Rhubarb and word timings to mouth shapes.
- [cutan.audio.injectable_lipsync](cutan.audio.injectable_lipsync.html.md): Lip-sync provider that consumes pre-computed word timings.
- [cutan.audio.offline_lipsync](cutan.audio.offline_lipsync.html.md): OfflineLipSync — deterministic transcript → viseme track. No network, no binary.
- [cutan.audio.rhubarb_lipsync](cutan.audio.rhubarb_lipsync.html.md): RhubarbLipSync — calls the rhubarb-lip-sync binary for phoneme-aligned visemes.
- [cutan.audio.whisper_lipsync](cutan.audio.whisper_lipsync.html.md): WhisperLipSync — faster-whisper word timestamps → viseme keyframes.
- [cutan.bench](cutan.bench.html.md): The cut-out genre’s bench corpus: eight scenes that use characters, and their goldens.
- [cutan.carve](cutan.carve.html.md): Carve: a photo or a video frame in, a matted, normalised, provenance-carrying cut-out part out (cuta...
- [cutan.carve.core](cutan.carve.core.html.md): The carve pipeline: an image (or a video frame) in, a matted, cleaned, provenance-carrying part out.
- [cutan.carve.head](cutan.carve.head.html.md): Head mode: a face located, the neck cut under the jaw, the head normalised on a fixed canvas.
- [cutan.carve.mattes](cutan.carve.mattes.html.md): Matte strategies: which pixels of an image are the subject.
- [cutan.carve.parts](cutan.carve.parts.html.md): Split a carved prop into moving parts, each with a declared pivot.
- [cutan.carve.prop](cutan.carve.prop.html.md): Write a carving (or a carving split into parts) as a library-ready prop folder.
- [cutan.carve.provenance](cutan.carve.provenance.html.md): Where carved pixels came from: an `AssetSource` for a frame of a video or an image.
- [cutan.carve.refine](cutan.carve.refine.html.md): Clean a raw matte into a cut-out’s alpha: keep the subject, close it, edge it, de-spill it.
- [cutan.characters](cutan.characters.html.md): Character art system: Spine-shaped descriptor + SVG sidecars.
- [cutan.characters.brows](cutan.characters.brows.html.md): Brow acting: where the brows can go, what may not draw there, and the `face.brows` capability.
- [cutan.characters.checks](cutan.characters.checks.html.md): The cut-out genre’s semantic checks: `play`, `expression`, turns, views and character refs.
- [cutan.characters.cli](cutan.characters.cli.html.md): User-facing character CLI subcommands.
- [cutan.characters.colour_roles](cutan.characters.colour_roles.html.md): Colour roles: which colour literal in which part is skin, clothing, hair…
- [cutan.characters.dicebear](cutan.characters.dicebear.html.md): DiceBear HTTP API client + best-effort post-processing.
- [cutan.characters.drawn](cutan.characters.drawn.html.md): What the character factory wrote, as it wrote it: the in-memory log behind its record of drawn bytes...
- [cutan.characters.factory](cutan.characters.factory.html.md): High-level entry points: build and inspect a character.
- [cutan.characters.idle](cutan.characters.idle.html.md): Idle animation factories: breath, blink, weight-shift.
- [cutan.characters.licenses](cutan.characters.licenses.html.md): DiceBear per-style licences, as data.
- [cutan.characters.lids](cutan.characters.lids.html.md): A HALF eyelid drawing, made from a character’s own OPEN and CLOSED lid art (cutan#65).
- [cutan.characters.methods](cutan.characters.methods.html.md): The cut-out genre’s methods and aspects, and their compile-time resolution (ADR 0002).
- [cutan.characters.mouth_set](cutan.characters.mouth_set.html.md): Generate the 9-shape default mouth set as parametric SVGs.
- [cutan.characters.play](cutan.characters.play.html.md): Resolve a `play` against a character descriptor — the renderer-free half (an#7).
- [cutan.characters.record](cutan.characters.record.html.md): Record a character’s preview HTML to an mp4.
- [cutan.characters.registration](cutan.characters.registration.html.md): The character side of the cut-out genre, as declarations: `play` and `character`.
- [cutan.characters.schema](cutan.characters.schema.html.md): Character descriptor schema (Spine-shaped, Pydantic v2).
- [cutan.characters.silhouette](cutan.characters.silhouette.html.md): Silhouette rendering and comparison for the silhouette test.
- [cutan.characters.svg_utils](cutan.characters.svg_utils.html.md): SVG manipulation: namespace-aware DOM helpers using stdlib `xml.etree`.
- [cutan.characters.validate](cutan.characters.validate.html.md): Whether an art package is one the compiler can actually render.
- [cutan.characters.vocabulary](cutan.characters.vocabulary.html.md): The cut-out genre’s vocabulary entries: motion presets, expression presets, IR-field notes.
- [cutan.compile](cutan.compile.html.md): The cut-out genre’s compile passes, their lowering hooks and the visuals of its runtime.
- [cutan.compile.coarticulate](cutan.compile.coarticulate.html.md): Co-articulation for a swap mouth: the passes between a provider’s raw viseme
- [cutan.compile.gaze](cutan.compile.gaze.html.md): Ambient saccades for a cutout rig’s pupils: a seeded generator (an#99, epic #9 Wave 6).
- [cutan.compile.lowering](cutan.compile.lowering.html.md): How the stage compiler lowers the cut-out genre’s actions, and reads a character’s swap sets.
- [cutan.compile.passes](cutan.compile.passes.html.md): The cut-out passes over the stage compiler, and the helpers only they use.
- [cutan.conftest](cutan.conftest.html.md): Doctest collection for `cutan`: `nw` is an optional dependency of `cutan.nw` only.
- [cutan.expression](cutan.expression.html.md): Facial expression for the cutout face (an#98, epic #9 Wave 6).
- [cutan.expression.axes](cutan.expression.axes.html.md): The facial expression axes: what a cutout face can be asked to do (an#98).
- [cutan.expression.binding](cutan.expression.binding.html.md): How the axes reach a character: the binding and the mouth-set resolver (an#98).
- [cutan.expression.blendshapes](cutan.expression.blendshapes.html.md): The 52-coefficient blendshape vocabulary, as an import/export mapping (an#98).
- [cutan.expression.presets](cutan.expression.presets.html.md): Expression presets: our art direction on the axes (an#98).
- [cutan.expression.provider](cutan.expression.provider.html.md): The expression provider: authored leaves + dialogue sugar → per-axis curves (an#98).
- [cutan.expression.registration](cutan.expression.registration.html.md): The face side of the cut-out genre, as declarations: `expression` and `[emotion]`.
- [cutan.genre](cutan.genre.html.md): The cut-out animation genre, declared as one object.
- [cutan.impacts](cutan.impacts.html.md): Synthetic impact clips with exact ground truth, for scoring sub-frame timing.
- [cutan.impacts.cli](cutan.impacts.cli.html.md): `an impacts ...` — the impact harness from the shell.
- [cutan.impacts.clip](cutan.impacts.clip.html.md): One impact clip, end to end: spec -> scene -> ground truth -> (video) -> files.
- [cutan.impacts.objects](cutan.impacts.objects.html.md): The things that strike: a stick and a ball, as ordinary `an` props.
- [cutan.impacts.performance](cutan.impacts.performance.html.md): The performance: a tempo grid, and when each impact was intended and executed.
- [cutan.impacts.stroke](cutan.impacts.stroke.html.md): The stroke: impact events -> one continuous height curve `h(t)`.
- [cutan.impacts.truth](cutan.impacts.truth.html.md): Ground truth: what was intended, what was executed, and what each frame shows.
- [cutan.library](cutan.library.html.md): The character analyser: legs, arms, views and mouth chart, derived from the rig.
- [cutan.motion](cutan.motion.html.md): The cut-out genre’s motion presets: moves that name a rig’s parts or swap its views.
- [cutan.projects_store](cutan.projects_store.html.md): Where a cutan project’s files are read from: a disk folder or S3, by configuration.
- [cutan.runtime](cutan.runtime.html.md): JavaScript the cut-out genre adds to the stage runtime (`visuals.js`: the mouth and eye).
- [cutan.styles](cutan.styles.html.md): The named cut-out style specs, shipped as package data (cutan#4).
- [cutan.styles.copies](cutan.styles.copies.html.md): Copies of a style spec, and whether they are stale (cutan#19).
- [cutan.styles.policy](cutan.styles.policy.html.md): A style’s policy: per-aspect method orders the compiler applies (ADR 0002 decision 4, cutan#9).
- [cutan.verify](cutan.verify.html.md): The cut-out style lint: measures a render against a named style spec.
- [cutan.verify.style](cutan.verify.style.html.md): Style lint: measure a render’s cadence, cut rate and palette, and compare them to a style’s targets.

## Optional

- [Top-level llms.txt](../llms.txt): Complete documentation index.