Files
breeze/docs/sun-salutation-flat.md
waozi 6b90f3670c Build practice packs from the practices repository
The practices' pictures, course data and recordings, 184 MB, move out of
Breeze into their own public repository, waozixyz/practices, pinned in
ziran.toml and ziran.lock like the other packages and linked at
build/packages/practices. The build stages them under assets/practices/ as
before, so every pack it makes is byte for byte the same. The narration,
Sun Salutation character and Tai Chi generators write into a practices
checkout mapped in ziran.local.toml. Breeze's history keeps the files.
2026-10-24 23:17:45 -03:00

89 lines
4.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Flat Sun Salutation characters
The app now solves Sun Salutation on the articulated body shared with Tai Chi
and the 7-Minute Workout. `sun_salutation_pose.zi` keeps the twelve yoga poses
and alternates the leading leg each round; `sun_salutation_draw.zi` draws the
same Jade woman and Indigo man from a fixed side view. The session, small
window, previews and guide all use that renderer. The timing and breathing
cues stay with `sun_salutation_rules.zi`.
The scripts below retain the earlier frame artwork for reference and exports.
`scripts/render-sun-salutation-flat.py` draws the Sun Salutation in a clean,
flat vector style: flat colours, no textures or gradients, one darker tone
for the far limbs and shades. It reuses the pose timeline, inverse
kinematics and hair simulation of `scripts/render-sun-salutation-girl.py`
and `docs/sun-salutation-girl.json`, so the yoga form is the same as the
painted animation; only the drawing differs.
```sh
python3 scripts/render-sun-salutation-flat.py # first character's video
python3 scripts/render-sun-salutation-flat.py --character indigo-crop # one character
python3 scripts/render-sun-salutation-flat.py --all # every character
python3 scripts/render-sun-salutation-flat.py --grid # all side by side, numbered
python3 scripts/render-sun-salutation-flat.py --character indigo-crop --still 25.5
```
Videos go straight into `build/sun-salutation-flat/` as `<id>.mp4` and
`choose-characters.mp4` (1536 × 1024, or 768 × 512 cells in the grid, 30 fps,
69 s, one chapter per step). Stills go to `build/sun-salutation-flat/stills/`;
delete them after review. It needs Python 3 with pycairo, FFmpeg with
libx264, and the girl renderer's NumPy and Pillow for its import.
## Characters
`docs/sun-salutation-flat.json` lists the characters: Jade bun for women
and Indigo crop for men (owner's choice, 2026-10-15). Each picks a torso,
legs, sleeves, face and hair by name and gives its colours: skin, hair, top,
pants, the sleeve cuff and the small light orange accent (hair ties). Far
limbs, shades and hair highlights are derived from those colours.
The shapes behind those names are tables in the script:
- `TORSOS`: the top's outline along the spine, its hem band, the seat, the
base of the head, where the neck enters the top, and how far the back of
the hem settles against the hips when lying back up (`tunic`, `male`).
- `LEGS` and `SLEEVES`: limb radii, where trousers and sleeves end and their
bands (`loose`, `trousers`; `bell`, `fitted`).
- `FACES`: the profile, scale, where the neck meets the head, blush, brow
and mouth (`female`, `male`). The neck bends between the top and the
head, so a lifted head never swings it out of the collar, and a shade
under the jaw (`JAW_SHADE`) sets the head on it.
- `HAIRS`: the cap, an optional bun and an optional hanging strand that
swings with the hair simulation (`bunLong`, `crop`). Men have short hair
that never swings: no ponytails or buns.
Limbs are hulls of circles along their bones, and parts of one colour fill as
one shape, so joints never show seams. Feet solve their own floor contact:
flat when standing, on tucked toes behind her in plank and the lunges, on the
instep in cobra. With her chest on the floor, an elbow that would bend down
through it turns up toward her back instead. `--other-side` draws the next
round, in which the other leg steps back first.
## App frames
The app plays the same characters from transparent PNG frames:
```sh
python3 scripts/render-sun-salutation-characters.py
```
It draws every listed character on a clear stage at the rig's sprite scale,
the woman first and then the man, for the first round and again for the next
one (the other leg first), with the app's three-second moves: one
held frame for the first pose, then for each of the other eleven 90 frames
of the move and 30 more while the hanging hair settles
(`SETTLE_SECONDS`). The app plays those during the hold and keeps the last
one; the rest of the hold is left out, so the hair carries on from there
into the next move. Frames are cropped to each move, quantized to 256
colours and saved to `sunsalutation/characters/NN-<id>/` in the
practices checkout (packaged as `assets/practices/sunsalutation/characters/`),
numbered by frame set: `01` and `02` for the first round, `03-<id>-other-side`
and `04-<id>-other-side` for the next.
It then writes `src/practices/sun_salutation/sun_salutation_frames.zi` and
`docs/sun-salutation-characters.json`, recompresses the PNGs
(`scripts/optimize-animation-pngs.py`, needs zopfli) and stores identical
frames once (`scripts/animation_inventory.py`). A character no longer listed
loses its frame folder. The app shows the first character as "Woman with
bun" and the second as "Man with short hair", who speaks with the male voice.