Commit graph Ymir/docs/soa-world.md
Author SHA1 Message Date
Meta Vens
be21de1959 SoA impulse tests reach the overflow solver and a swung arm; docs: the lane is a sum of magnitudes
A big sphere with 60 small ones converging has more contacts than graph colours, so Box3D's
scalar overflow path runs: the big lane equals the sum of the small lanes, each its own
momentum change, at restitution 0 and 0.5. A swung arm (ApplyImpulse launches) into a
frictionless slab is exact. The docs say the lane sums magnitudes and is the weight at
rest only on average.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 03:22:09 +01:00
Meta Vens
c5e4e34825 docs: SoA contact impulse, the Box3D fork and how to rebase it
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 02:57:48 +01:00
Meta Vens
6c90bd10f7 docs: SoA world ABI number in the intro
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 02:41:47 +01:00
Meta Vens
e530b9b97d docs: SoA joint handles and generations, ABI 6, anchor creation followed by a validating joint
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 02:41:43 +01:00
Meta Vens
2f78cfa8f5 docs: SoA grab release, anchor hold, tombstoned joint lanes, ray starting inside a shape
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 02:28:48 +01:00
Meta Vens
cec6d0d464 docs: SoA world grab anchors, motor joint, impulses and ray, ABI 5
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 02:02:14 +01:00
Meta Vens
e4cf4cd444 SoA hit impulse estimate: honest limits, two-body and threshold tests, fact element-size guard
ImpulseEstimate is documented as exact for a centre-to-centre hit between
free bodies, over-counting when one collision yields several hit facts and
undercounting for jointed bodies; never a bound. Tests: two free spheres at
mass ratios 1:1, 1:10, 10:1 with restitution 0 and 0.5, and a hit below the
restitution threshold that must not bounce. The ABI handshake now checks the
touch and hit fact element sizes.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 01:52:47 +01:00
Meta Vens
5c35a40ccf SoA: contact force lane renamed LastSubstepForce; hit facts carry an impulse estimate
Box3D exposes no whole-step normal impulse: normalImpulse is the last
sub-step and totalNormalImpulse is a solve plus relax mixture, so no lane
built from them is true on an impact step. The per-body lane is renamed
LastSubstepForce and documented as a resting load only. Impact severity is
the hit fact's ImpulseEstimate, v (1 + e) / (1/mA + 1/mB), checked against
the ball's momentum change at 60 and 240 Hz, 1 and 4 sub-steps, restitution
0 and 0.5. Also pins that dropped counters reset each step.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 01:37:21 +01:00
Meta Vens
a614477d68 docs: SoA world contact facts, contact lanes and ABI 4
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 01:09:55 +01:00
Meta Vens
617beec1dc SoA world publishes each body's shape size as read-only lanes (ABI 3)
Size0/1/2 sit beside Kind, written once in add_body, never touched by step,
so a renderer draws every body from one source.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 00:51:05 +01:00
Meta Vens
0b0321aa00 SoA docs: concurrency line matches the lock; concurrent stepping is not known to race, not promised; 128-world limit
Soul low findings on db09805.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 21:20:07 +01:00
Meta Vens
db09805aba Serialize Box3D world create and destroy behind one process-wide lock
b3CreateWorld/b3DestroyWorld scan and rewrite Box3D's global world pool with
no synchronization; concurrent creation crashed the host (0xC000001D). All
five call sites (SoA world, retained session, pair step, torque lifetime) now
go through one lock owned by ymir_box3d.c (SRWLOCK on Windows, pthread mutex
elsewhere). Adds a multi-thread create/step/dispose test, which aborts the
test host without the lock; drops the serial-test assembly attribute.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-19 21:11:08 +01:00
Meta Vens
fbc1530fa5 Uniform native output path across generators; default view refuses with a clear error; span-lifetime docs
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-19 20:55:25 +01:00
Meta Vens
e6a1e4ad02 Scope PREFIX to MinGW; views refuse lane access after dispose; document lifetime limits
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-19 20:51:04 +01:00
Meta Vens
eb30cac65b Box3D SoA world is public; drop Lodur friend grants; MinGW emits ymir_box3d.dll
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-19 20:43:55 +01:00
Nibu
ea7b3f3d7f soa-world doc: rolling resistance in the descriptor
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-07 04:08:18 +00:00
Nibu
8bb0d0b1de SoA world: joints, force/torque write lanes, capsules and boxes, parent/limb lanes
ABI 2. One body descriptor replaces add_sphere/add_static_box (kinds: sphere, capsule, box, static box).
Revolute, spherical and weld joints created from a world anchor and axis, with joint state lanes (angle,
frame A orientation, relative rotation, relative angular velocity). Per-body force and torque write lanes,
applied before the step then cleared; non-finite values refuse the step. Parent and limb index lanes.
Tests run serially: concurrent b3CreateWorld aborts the host.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-07 03:55:49 +00:00
7d9f1b57a1 Headless 3D SoA world over Box3D, read in place
New native object ymir_box3d_soa (ABI 1): gravity, free rotation, spheres and static boxes,
one worker, state copied once per step into contiguous lanes that a caller reads in place.
Managed Box3DSoaWorld/Box3DSoaView expose the lanes as spans. The planar retained session is
unchanged. Tests: fall and rest, in-place reads, bit-for-bit repeat runs.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-06 18:54:20 +00:00