Skip to content

Turn one illustration into an animated 2D mesh avatar with a coding agent and a local editor

29.0 KB
Raw Blame

Rig fields

See the avatar file and folder format for the manifest, built images and metadata that accompany rig.json.

Version 1 uses the original source.png coordinate system: origin at the top left, x right, y down. Coordinates, radii, lengths, grid spacing and bands are source pixels; angles are radians, not the degrees used by the pose sliders. All numbers must be finite. Ellipse radii and mesh cell sizes must be positive. Mesh cell sizes and fine-mesh rectangle coordinates must be integers. Accessory boxes must be integer rectangles inside the image. A band is [start, end] with start < end. Ellipses are smooth influence regions, not hard cut-out boundaries.

Only buns, strands, accessories, hand, view.gazeCenter and view.irisTravel are optional. Omit absent optional groups. Required regions must still be placed even if their animation will be small. The initial draft has empty eye polygons and is intentionally invalid until they are traced. See agent-guide.md for the process and rig-mapping.md for the engine mapping. Do not copy the example illustration's coordinates into a new image.

Field Meaning, unit and placement
version Schema version; set to 1.
image.width Original PNG width, px; exact image dimensions.
image.height Original PNG height, px; exact image dimensions.
head.cx Head influence centre x, px; near the horizontal face centre.
head.cy Head influence centre y, px; slightly above the eyes.
head.rx Horizontal head radius, px; include hair and head accessories.
head.ry Vertical head radius, px; include crown and hair, avoid shoulders where possible.
head.shiftX Maximum horizontal face-turn displacement, px; start around 3–4% of image width.
head.shiftY Maximum vertical face-turn displacement, px; start around 2–3% of image height.
head.pivotX Head roll pivot x, px; centre of the neck.
head.pivotY Head roll pivot y, px; at the neck above the collarbone.
head.maxRoll Roll magnitude at a ±30° head pose, radians; start near 0.15.
head.weightBand Y range, px, where head influence fades from full to zero; below chin to collarbone.
head.turnBand Y range, px, where face-turn displacement fades; below chin into upper chest.
body.pivotX Body roll pivot x, px; middle of the lower torso.
body.pivotY Body roll pivot y, px; near the bottom of the image.
body.maxRoll Body rotation at a ±10° body pose, radians; start near 0.035.
body.breathBand Y range, px, where breathing fades to zero; upper chest to bottom.
body.rollBand Y range, px, where body roll fades to zero; upper body to anchored lower torso.
body.chest.cx Chest centre x, px; centre of visible upper torso.
body.chest.cy Chest centre y, px; below neck and above lower torso.
body.chest.rx Chest horizontal radius, px; cover torso inside the arms.
body.chest.ry Chest vertical radius, px; cover breathing region.
body.shoulders[*].cx Shoulder centre x, px; one ellipse per visible shoulder.
body.shoulders[*].cy Shoulder centre y, px; on the visible shoulder.
body.shoulders[*].rx Shoulder horizontal radius, px; cover shoulder width.
body.shoulders[*].ry Shoulder vertical radius, px; cover shoulder height.
face.nose.cx Horizontal centre, px; Nose influence ellipse, px; centre on nose tip, radii around bridge/tip region.
face.nose.cy Vertical centre, px; Nose influence ellipse, px; centre on nose tip, radii around bridge/tip region.
face.nose.rx Horizontal influence radius, px; Nose influence ellipse, px; centre on nose tip, radii around bridge/tip region.
face.nose.ry Vertical influence radius, px; Nose influence ellipse, px; centre on nose tip, radii around bridge/tip region.
face.mouth.cx Horizontal centre, px; Mouth movement influence ellipse, px; centre on lips, extend slightly into surrounding skin.
face.mouth.cy Vertical centre, px; Mouth movement influence ellipse, px; centre on lips, extend slightly into surrounding skin.
face.mouth.rx Horizontal influence radius, px; Mouth movement influence ellipse, px; centre on lips, extend slightly into surrounding skin.
face.mouth.ry Vertical influence radius, px; Mouth movement influence ellipse, px; centre on lips, extend slightly into surrounding skin.
face.eyeA.cx Horizontal centre, px; Image-left eye influence ellipse, px; cover eye and immediate surrounding skin.
face.eyeA.cy Vertical centre, px; Image-left eye influence ellipse, px; cover eye and immediate surrounding skin.
face.eyeA.rx Horizontal influence radius, px; Image-left eye influence ellipse, px; cover eye and immediate surrounding skin.
face.eyeA.ry Vertical influence radius, px; Image-left eye influence ellipse, px; cover eye and immediate surrounding skin.
face.eyeB.cx Horizontal centre, px; Image-right eye influence ellipse, px; cover eye and immediate surrounding skin.
face.eyeB.cy Vertical centre, px; Image-right eye influence ellipse, px; cover eye and immediate surrounding skin.
face.eyeB.rx Horizontal influence radius, px; Image-right eye influence ellipse, px; cover eye and immediate surrounding skin.
face.eyeB.ry Vertical influence radius, px; Image-right eye influence ellipse, px; cover eye and immediate surrounding skin.
face.earL.cx Horizontal centre, px; Image-left ear influence ellipse, px; centre on the ear location, even when hidden.
face.earL.cy Vertical centre, px; Image-left ear influence ellipse, px; centre on the ear location, even when hidden.
face.earL.rx Horizontal influence radius, px; Image-left ear influence ellipse, px; centre on the ear location, even when hidden.
face.earL.ry Vertical influence radius, px; Image-left ear influence ellipse, px; centre on the ear location, even when hidden.
face.earR.cx Horizontal centre, px; Image-right ear influence ellipse, px; centre on the ear location, even when hidden.
face.earR.cy Vertical centre, px; Image-right ear influence ellipse, px; centre on the ear location, even when hidden.
face.earR.rx Horizontal influence radius, px; Image-right ear influence ellipse, px; centre on the ear location, even when hidden.
face.earR.ry Vertical influence radius, px; Image-right ear influence ellipse, px; centre on the ear location, even when hidden.
face.brow.cx Horizontal centre, px; Brow influence ellipse, px; cover the visible eyebrow region, avoiding hair.
face.brow.cy Vertical centre, px; Brow influence ellipse, px; cover the visible eyebrow region, avoiding hair.
face.brow.rx Horizontal influence radius, px; Brow influence ellipse, px; cover the visible eyebrow region, avoiding hair.
face.brow.ry Vertical influence radius, px; Brow influence ellipse, px; cover the visible eyebrow region, avoiding hair.
face.brow.band Y range, px, fading brow movement from full to zero below brow.
face.jaw.cx Horizontal centre, px; Jaw influence ellipse, px; centre just above chin, cover lower jaw.
face.jaw.cy Vertical centre, px; Jaw influence ellipse, px; centre just above chin, cover lower jaw.
face.jaw.rx Horizontal influence radius, px; Jaw influence ellipse, px; centre just above chin, cover lower jaw.
face.jaw.ry Vertical influence radius, px; Jaw influence ellipse, px; centre just above chin, cover lower jaw.
face.jaw.band Y range, px, fading jaw influence from zero to full toward chin.
buns.bunL.cx Horizontal centre, px; Optional image-left bun ellipse, px; include whole bun, exclude ribbons.
buns.bunL.cy Vertical centre, px; Optional image-left bun ellipse, px; include whole bun, exclude ribbons.
buns.bunL.rx Horizontal influence radius, px; Optional image-left bun ellipse, px; include whole bun, exclude ribbons.
buns.bunL.ry Vertical influence radius, px; Optional image-left bun ellipse, px; include whole bun, exclude ribbons.
buns.bunR.cx Horizontal centre, px; Optional image-right bun ellipse, px; include whole bun, exclude ribbons.
buns.bunR.cy Vertical centre, px; Optional image-right bun ellipse, px; include whole bun, exclude ribbons.
buns.bunR.rx Horizontal influence radius, px; Optional image-right bun ellipse, px; include whole bun, exclude ribbons.
buns.bunR.ry Vertical influence radius, px; Optional image-right bun ellipse, px; include whole bun, exclude ribbons.
eyes Exactly two entries: index 0 is image-left, index 1 image-right (not anatomical left/right).
eyes[*].opening Polygon [x,y] points, px; trace eye white + iris inside lashes, 14–20 points from outer corner.
eyes[*].roi Polygon [x,y] points, px; surround full lashes and lower lid by about 10–20 px, avoid hair.
eyes[*].x0 Generated leftmost opening x, px; omit in draft, builder computes it.
eyes[*].x1 Generated rightmost opening x, px; omit in draft, builder computes it.
eyes[*].top Generated 24 upper-edge y samples, px, evenly spaced x0→x1; omit in draft.
eyes[*].bot Generated 24 lower-edge y samples, px, evenly spaced x0→x1; omit in draft.
mouth.cx Closed mouth line centre x, px; between lip corners.
mouth.cy Centre y of the straight line through lip corners, px; bow adds curvature.
mouth.angle Angle of lip-corner line, radians; positive slopes down to image-right.
mouth.halfLen Half length of lip-corner line, px; centre to either corner.
mouth.bow Downward curvature at the middle of mouth line, px; zero for a straight line.
mouth.area.cx Mouth sprite influence centre x, px; centre on lips.
mouth.area.cy Mouth sprite influence centre y, px; centre on lips.
mouth.area.rx Mouth edit region horizontal radius, px; slightly beyond corners.
mouth.area.ry Mouth edit region vertical radius, px; allow drawn open mouths without reaching chin.
mouth.area.angle Mouth edit ellipse rotation, radians; follow mouth line.
cheeks Exactly two [x,y] blush centres, px; image-left then image-right cheek.
strands[*].name Nonempty label for the hair lock; use distinct readable names.
strands[*].nodes Root-to-tip polyline of [x,y] points, px; start with four nodes entirely on hair.
strands[*].sigma Width of strand influence, px; around half the visible lock width.
strands[*].k Positive spring response multiplier, unitless; start near 1.
strands[*].max Maximum hair displacement, px; start around 7–12.
accessories[*].name Unique safe layer filename stem (letters/digits/underscore/hyphen), not a reserved layer name.
accessories[*].pivot Hanging accessory root [x,y], px; fixed attachment point.
accessories[*].tip Hanging accessory endpoint [x,y], px; bottom of pendant/tassel.
accessories[*].split Split position along two-bone accessory, fraction strictly between 0 and 1; start near 0.4.
accessories[*].box Integer [x0,y0,x1,y1] search rectangle, px; tightly bound accessory, x1/y1 exclusive.
accessories[*].color.redness Minimum (R-max(G,B))/max(R,1) ratio, 0–1; builder currently isolates red accessories only.
accessories[*].color.minRed Minimum red channel, 0–255; suppress dark background inside box.
hand.outline Polygon [x,y] points, px; trace the entire visible hand/forearm to cut out.
hand.jaw Visible jaw polyline [x,y], px; sample both sides of the hand occlusion for interpolation.
hand.jawRange Increasing x range, px; jaw segment to reconstruct behind hand.
hand.background Polygon [x,y] points, px; background-side region behind hand, below jaw.
hand.elbow Elbow pivot [x,y], px; may be outside the visible image.
hand.wrist Wrist pivot [x,y], px; at wrist joint.
hand.knuckle Finger rotation pivot [x,y], px; at knuckle near the face.
hand.contact Fingertip contact [x,y], px; point pinned near chin as head moves.
hand.forearmShare Fraction 0–1 of arm rotation applied to forearm; start near 0.3.
hand.armBand Y range, px, fading arm rotation to zero toward bottom of arm.
hand.wristBand Y range, px, fading wrist rotation to zero below wrist.
hand.handBand Y range, px, fading head/contact following below hand.
hand.fingerXBand X range, px, increasing finger influence toward image-right.
hand.fingerYBand Y range, px, fading finger influence toward bottom.
hand.pinBand Y range, px, increasing lower arm anchoring toward image bottom.
mesh.baseCell Coarse base-layer cell spacing, px; example 14.
mesh.fine.x0 Face/hair refinement rectangle left x, px; enclose moving features.
mesh.fine.x1 Refinement rectangle right x, px; greater than x0.
mesh.fine.y0 Refinement rectangle top y, px; above crown/hair.
mesh.fine.y1 Refinement rectangle bottom y, px; below chin/hair tips.
mesh.fine.cell Fine base-layer cell spacing, px; example 7, reduce only when detail needs it.
mesh.handCell Hand-layer cell spacing, px; example 9.
mesh.tasselCell Hanging-accessory cell spacing, px; example 6.
mesh.eyeBallCell Eye white/iris layer cell spacing, px; example 4.
mesh.eyeCell Lash/lid layer cell spacing, px; example 3.
mesh.spriteCell Drawn eye/mouth sprite cell spacing, px; example 4.
view.padTop Top viewport margin as fraction of source height; negative crops crown, must be between -1 and 1.
view.padSide Each side viewport margin as fraction of source width; start at 0, must exceed -0.5.
view.gazeCenter Optional pointer-follow origin [x,y], px; between eyes; defaults to head centre.
view.irisTravel Optional iris travel at full gaze, px; defaults to 7. Raise it for large eyes, around 15% of the eye opening width.

Draft validation accepts omitted x0/x1/top/bot only as a complete group; supplying some of the four fields is an error. Complete rigs always require all four. Changing eye geometry requires rebuilding; old sampled curves cannot reconstruct new image pixels.

Optional garments

Experimental full-body feature; its fields and behaviour may change.

cloth is an optional array. Omit it or use [] to retain the existing rendering. Coordinates are source-image pixels, with x increasing right and y increasing down.

Field Meaning / default
cloth[*].name Unique letters/digits/underscore/hyphen name; generates cloth_<name>.png.
cloth[*].outline Cutout polygon, at least three points, enclosing all ruffles and tails belonging to this garment. Changing it requires rebuilding layers.
cloth[*].waist Upper attachment polyline, at least two points, from image-left to right. Follows the body or parent garment.
cloth[*].hem Lower polyline, at least two points, from image-left to right. Cover the full width of the cloth, including projecting ruffles.
cloth[*].seams Optional waist-to-hem column polylines, ordered image-left to right; empty uses the waist/hem grid. Supply 2–64 lines with at least two points each and strictly increasing y. Nonempty seams override columns; lengths follow the source polylines.
cloth[*].tiers Optional array of 0–8 cross-column joint polylines, ordered waist to hem. Each line has at least two points and crosses every column exactly once. With N tiers there are N+1 coupled links; empty uses two links split at half the source length.
cloth[*].scale Optional positive image scale, millimetres per source pixel. If omitted, infer 0.8m from mean hip-to-ankle length when legs exists; otherwise assume image height represents 1.6m. Supply this for cropped or unusually proportioned art.
cloth[*].columns, rows Integer grid node counts, both at least 2; defaults 8, 5. With seams/tiers, rows is a minimum: the grid includes every tier joint and at least two subdivisions per link.
cloth[*].responseGain Positive rendered-response exaggeration; default 1 (physical). 1.6 amplifies cloth angles only. Child solvers use the unexaggerated parent grid, while visible attachments follow the exaggerated grid.
cloth[*].tierGain Positive render-only multiplier on each link's angle relative to the uppermost link; default 1. Applies only when seams or tiers are nonempty. Changes visible bending without changing physical states, frequencies or child solver input.
cloth[*].highModeDamping Positive damping-ratio multiplier for modes above the lowest-frequency mode; default 1. Applies only when seams or tiers are nonempty. Below 1 lets higher modes oscillate longer; the lowest mode keeps 0.25 × damping.
cloth[*].swing Positive multiplier on the physical pendulum frequency; default 1. A value of 1 uses the source scale, column length and gravity.
cloth[*].stiffness Positive restoring-force multiplier; default 1. Modal frequencies scale by swing × √stiffness, using effective link lengths of 0.8 times their source lengths.
cloth[*].damping Positive damping multiplier; default 1. Base small-angle damping ratio is 0.25 × damping; larger values suppress oscillations. highModeDamping can further scale higher modes in the seams/tiers solver.
cloth[*].follow Column rigidity, 0..1; default 0.85. At 1 each link is rigid; lower values add up to 10% within-link quadratic bend, without a delayed row chain.
cloth[*].cohesion Integer smoothing passes over column angles and angular velocities, 0..8; default 3.
cloth[*].wind Nonnegative coherent breeze strength as a fraction of max; default 0.05, 0 disables wind. All columns receive the same phase.
cloth[*].max Positive soft limit on grid displacement from the body-carried shape, px; default 20. Limits rotation at the hem and reserves up to 10% for weak vertical bounce. Extrapolated mesh points outside the grid can move farther.
cloth[*].behind Optional boolean, default false; draw before the bare base when true. Changing depth requires rebuilding overlapping cutouts.
cloth[*].parent Optional name of an earlier cloth entry. Its displaced grid drives this garment's waist, useful for rear tails attached to a skirt.
body.hip.shift Optional full-body sideways travel at bodyAngleX=10, px. Supply with band to fade sideways motion toward planted feet.
body.hip.band Increasing source-y range over which sideways body travel fades to zero. Existing rigs without hip keep their original deformation.
mesh.clothCell Positive integer garment render-mesh spacing, px; default 8. Independent of cloth grid node counts.

Without seams or tiers, each column retains its existing two equal-length pendulum links. Nonempty seams or tiers use an N-link serial pendulum, with link lengths measured along each source column between tier intersections. Without explicit seams, columns interpolate the waist and hem. Validation rejects crossed or inverted grid cells, columns shorter than 1 source pixel, missing or repeated tier crossings, and tier intersections that are not ordered waist to hem. Adjacent intersections, including the endpoints, must be separated by at least 0.001 of the column length.

Columns are driven by the attachment's horizontal acceleration, including motion from pelvis yaw. Gravity is 9.80665m/s², converted to source pixels. Each link uses an effective length of 0.8 times its source length, between a uniform rigid strip (2L/3) and a tip-heavy point mass (L), approximating a ruffled hem. Upward attachment acceleration increases apparent gravity; source y points down, so the implementation uses g - accelerationY. The angle is relative to the world rest shape, so the cloth retains its hanging orientation as the pelvis tilts. Absolute link angles are solved together using the pendulum mass matrix, gravity and Coriolis forces, with endpoint masses proportional to link lengths. The legacy equal-length two-link solver uses Rayleigh damping for both small-angle modes. The seams/tiers solver uses modal damping to set every small-angle mode to 0.25 × damping, with highModeDamping applied above the lowest mode. Frequencies follow link lengths rather than hand-tuned rows. Each rendered link retains its length, with a small within-link bend controlled by follow. Each link endpoint retains its distance from that link's pivot; a separate weak, critically damped vertical response can change it slightly during vertical acceleration. Parent accelerations are evaluated on the parent's unexaggerated physical grid; visible attachments follow its rendered grid. No additional random samples are used.

setClothTuning(name, tuning) accepts a Partial<ClothTuning> containing the tuning fields above. A null name applies to all garments; a string applies only to that name. Updates take effect on the next simulation step without resetting velocity, changing the rig or rebuilding layers. Invalid values or an unknown name throw a RangeError. Studio edits update the rig and are included when saving it. In Studio's Cloth inspector, add or delete seam and tier lines, drag their vertices, double-click edges to add vertices, or Alt-click vertices to remove them. These motion-grid edits do not require rebuilding image layers; outline edits do. The element exposes this method through element.avatar / await element.ready; React exposes the same element through its ref and the runtime through onLoad.

Optional planted legs

Experimental full-body feature; its fields and behaviour may change.

Omit legs to retain the existing deformation exactly. weightShift is an optional parameter in -1..1, default 0: negative supports the image-left leg, positive supports the image-right leg. For rigs with legs, idle weight transfer uses a five-second cycle: a 0.9-second quintic S transition and 1.6-second hold in each half-cycle, targeting ±0.7. The existing body spring smooths it. Rigs without legs retain the previous deterministic sine and deformation.

Field Meaning
legs.spine Optional stabilization fraction 0..1, default 0.7; the upper torso retains a small opposite pelvic inclination of 1 - spine, blended through the spine. Chest and head follow serial springs rather than a rigid translating trunk.
legs.bob Optional nonnegative extra pelvis dip in source px, default 2; driven by transfer speed and returning to zero during a hold. Included in the planted-foot IK.
legs.twist Optional pelvis yaw limit in degrees, 0..15; absent or 0 preserves the existing output. Weight transfer drives yaw, with a small residual during holds. Shoulders partly counterturn according to spine, the head stays frontal, and feet stay fixed.
legs.pelvis Bone rotation centre [x,y] in source pixels.
legs.shift Nonnegative sideways travel in px at full weight transfer.
legs.tilt Nonnegative pelvic tilt in radians at full transfer; the free side lowers.
legs.bend Nonnegative inward-flexion scale in px. The free knee gets an extra inward offset of bend * weightShift²; the remaining flexion goes towards the camera. Also sets the small soft-IK settling scale.
legs.band Increasing source-y interval for counter-rotation; the spine blends towards the chest; shoulder inclination is partly countered rather than fully cancelled.
legs.left, legs.right Image-side joints, each with hip, knee, ankle source points. Require band start < hip y < knee y < ankle y. The rest knee determines which way the leg bends.
legs.split Polyline dividing the legs, with strictly increasing y. Put its start inside the crotch gap: the split is hard below this point and blends over eight pixels above it.

The IK is solved in 3D, with a forward pole, then projected onto the drawing. Bone lengths are preserved in 3D; the projected bones may shorten. The source knee's inward offset relative to the hip–ankle axis travels with that axis, retaining the drawn rest shape. Rest forward depth is 5% of the shorter projected bone. A smooth pelvis drop keeps both legs within reach without sudden knee extension; calibrate modest shift/tilt values for each illustration. At neutral, the added deformation is zero. With legs, bodyAngleX enters the same pelvis/IK transform, using body.hip.shift when supplied, and does not also apply the legacy hip shear. Breath and body roll remain in their existing order, fading to zero over the last 55 px before the ankles. Vertices at and below the higher ankle stay exactly fixed. Cloth attachments follow the pelvis through the usual base deformer, with their existing lag.

Studio exposes the pelvis and joint handles, an editable split polyline, and the shift, tilt, bend, band and optional twist fields under Legs. These edits recalculate weights without marking image layers stale. Pause idle motion to test the Weight shift slider, then save the rig to persist the geometry and tuning.

render-poses adds weight-left, weight-right at ±0.6, plus weight-shift-0..9 over one five-second cycle when legs is present.

For planted rigs, the chest drive lags the pelvis by approximately 0.1–0.2s; head stabilization follows one spring later and preserves intentional head gestures. Independent idle body noise is reduced to 35% without changing random-number consumption.

Optional hanging arms

Experimental full-body feature; its fields and behaviour may change.

Use arms for front-facing, hanging arms separated from the body by a transparent gap. Omit it for arms touching or in front of the torso, hands on hips, crossed arms, and bust-up illustrations. This is a small deformation of the original drawing; it does not reconstruct hidden skin or clothing, raise the arms, or resolve cloth collisions. Without arms, the avatar keeps its existing deformation. The native runtime currently ignores arms and its parameters; use the WebGL runtime for this feature.

Field Meaning
arms.left, arms.right Image-left and image-right arms. Each has the source-pixel points shoulder, elbow, wrist and its own split polyline. All points must be inside the image, with shoulder y < elbow y < wrist y.
arms.left.shoulder, arms.right.shoulder Upper-arm pivot [x,y], inside the sleeve near the armpit. Motion fades to zero at the shoulder to keep the sleeve attached.
arms.left.elbow, arms.right.elbow Elbow pivot [x,y]. Upper arm and forearm motion blend around this joint.
arms.left.wrist, arms.right.wrist Wrist [x,y]; the hand follows the forearm.
arms.left.split, arms.right.split At least two source points with strictly increasing y, tracing the transparent gap from just below the armpit to below the fingertips. The left split must be to the right of its elbow and wrist; the right split must be to their left. With cloth cutouts, check the actual base_cloth.png gap too. Keep the line clear of visible arm pixels and allow room for mesh cells around narrow gaps.
arms.swing Optional upper-arm rotation limit in degrees, 0..10, default 4.
arms.bend Optional additional elbow flexion limit in degrees, 0..12, default 6. Negative flexion is not allowed.
arms.inward Optional 0..1 fraction of the swing limit allowed towards the body, default 0.4.

New parameters, all defaulting to 0, are armSwingL / armSwingR (-1..1, positive outwards) and elbowBendL / elbowBendR (0..1). L/R refer to the image sides. The existing armAngle / handAngle parameters still control the separate chin-hand rig. Zero arm parameters add exactly zero deformation. During idle, arms partly counter the torso inclination with a damped delay and a small breathing motion.

In Studio, Body → Arms exposes both joint chains, editable split lines and tuning. Joint, split and tuning edits recalculate weights without rebuilding image layers. The four arm pose sliders appear only when arms is set. Full-body support lists Legs / Arms / Cloth as set or not set; parts not set keep the standard motion.

Live shows which body parts the loaded avatar supports. Track body movement follows visible elbows and wrists relative to the calibrated posture. Mirror swaps their image sides. Each hidden elbow releases that side, while a hidden wrist releases only elbow bend: hold the last pose for 500 ms, then fade to idle with a 200 ms time constant. A 90-degree extra elbow bend maps to about 0.6 at normal sensitivity, with a camera tracking cap of 0.75. Tracking uses image-plane angles, so depth-only movement may not produce the same response. Calibrate with relaxed, visible arms.

render-poses adds arms-out, arms-in, elbows-bent, arm-left, arm-right, arms-body-left, arms-body-right, arm-cycle-0..9 and arm-idle-0..10 when arms is present. Inspect sleeves, elbows, wrists and skirt edges in every frame. Reduce swing, bend or inward if the hand enters clothing; segmentation remnants in cut-out cloth must be corrected in the artwork rather than by increasing motion.