design: new-project defaults 92x128 @ 8 fps and pre-fitted framing (Tim t1022u)

Authored 2026-11-07 · 6 days ago

Hash: e76a275f8763c85c78b96c84f91e4e70a1c1ff0e
Parent: f46e805b
Pipeline: Obsolete

1 file changed +4 −0

design.md +4 −0

@@ -561,3 +561,7 @@ Findings in Tim's `female.gltf` (the renderer follows the glTF spec, no renderer

561 561

The bundled default female (asset only, models still load as-is) is edited: that stray animation is removed, and the hair mesh (`Object_75`, material `ponytail01`, 3902 vertices, BLEND) with its material, texture, image and buffer data is removed; the `.bin` is compacted. All other bytes' meaning is unchanged; the edit is listed in THIRD_PARTY_NOTICES/README.

562 562

563 563

The removed hair becomes a bundled equipment preset `female-hair` (`.ppe`, female only, its texture embedded). Equipment is rigid: the hair, skinned to several head/neck bones in the source, is baked once at the rest pose and expressed in the rest-pose space of the `head` joint, bound to that joint with zero offset, so at rest it sits exactly where it was and follows the head rigidly (acceptable for hair). Its texture alpha is used with the equipment alpha cutout (0.5), not blended. **Nieuw project** writes it to `presets/female-hair.ppe` and lists it in the project's equipment presets. A generator (`examples/bake_female_hair.rs`) reproduces the edit and the preset from Tim's original files.

564

565 ## Decision 2026-11-07 (Tim t1022u): new-project defaults and pre-fitted framing

566

567

New projects default to target 92 × 128 pixels at 8 fps (depth stays 8-bit `gray`). Existing `.ppd` files keep their stored values (width, height and fps are required fields, so the default never rewrites them). A **Nieuw project** with the bundled default bodies already has **Fit animations** applied for both sexes when it is created: the same one-shot envelope as the button (all clips × frames at the project fps × 60 views, 5% margin, project aspect, pivot unchanged), computed from the copied bodies and stored as each sex's `height_milli`/`center_y_milli`. It is computed at creation (not shipped as constants) so it always matches the bundled assets and defaults; afterwards the frame is fixed as before.

@@ -561,3 +561,7 @@ Findings in Tim's `female.gltf` (the renderer follows the glTF spec, no renderer

561

The bundled default female (asset only, models still load as-is) is edited: that stray animation is removed, and the hair mesh (`Object_75`, material `ponytail01`, 3902 vertices, BLEND) with its material, texture, image and buffer data is removed; the `.bin` is compacted. All other bytes' meaning is unchanged; the edit is listed in THIRD_PARTY_NOTICES/README.

561

The bundled default female (asset only, models still load as-is) is edited: that stray animation is removed, and the hair mesh (`Object_75`, material `ponytail01`, 3902 vertices, BLEND) with its material, texture, image and buffer data is removed; the `.bin` is compacted. All other bytes' meaning is unchanged; the edit is listed in THIRD_PARTY_NOTICES/README.

562

563

The removed hair becomes a bundled equipment preset `female-hair` (`.ppe`, female only, its texture embedded). Equipment is rigid: the hair, skinned to several head/neck bones in the source, is baked once at the rest pose and expressed in the rest-pose space of the `head` joint, bound to that joint with zero offset, so at rest it sits exactly where it was and follows the head rigidly (acceptable for hair). Its texture alpha is used with the equipment alpha cutout (0.5), not blended. **Nieuw project** writes it to `presets/female-hair.ppe` and lists it in the project's equipment presets. A generator (`examples/bake_female_hair.rs`) reproduces the edit and the preset from Tim's original files.

563

The removed hair becomes a bundled equipment preset `female-hair` (`.ppe`, female only, its texture embedded). Equipment is rigid: the hair, skinned to several head/neck bones in the source, is baked once at the rest pose and expressed in the rest-pose space of the `head` joint, bound to that joint with zero offset, so at rest it sits exactly where it was and follows the head rigidly (acceptable for hair). Its texture alpha is used with the equipment alpha cutout (0.5), not blended. **Nieuw project** writes it to `presets/female-hair.ppe` and lists it in the project's equipment presets. A generator (`examples/bake_female_hair.rs`) reproduces the edit and the preset from Tim's original files.

564

565## Decision 2026-11-07 (Tim t1022u): new-project defaults and pre-fitted framing

566

567

New projects default to target 92 × 128 pixels at 8 fps (depth stays 8-bit `gray`). Existing `.ppd` files keep their stored values (width, height and fps are required fields, so the default never rewrites them). A **Nieuw project** with the bundled default bodies already has **Fit animations** applied for both sexes when it is created: the same one-shot envelope as the button (all clips × frames at the project fps × 60 views, 5% margin, project aspect, pivot unchanged), computed from the copied bodies and stored as each sex's `height_milli`/`center_y_milli`. It is computed at creation (not shipped as constants) so it always matches the bundled assets and defaults; afterwards the frame is fixed as before.