← Cycles
qmap · c11archivedstarted Feb 5Auto draft — not yet reviewed

Grid Layout Engine

Why we did this

Layout code from five cycles had grown tangled: positions, 3D coordinates, collisions and label sizes all mixed together, so it was hard to reason about.

What happened

A clean layout engine works on a simple grid, packs groups inside groups from the inside out, then hands positions to the 3D scene. Test scenes from three things to hundreds check it.

Early → finalThe same packing works for three things or hundreds, with boxes inside boxes.
At a glance
3
changes
0
conversations
4
decisions
0
outside helpers

What changed

The two changes that matter most, in plain words. Open any one to see it.

  1. 1

    The same packing works for three things or hundreds, with boxes inside boxes.

    One engine, any size · came from Mark Parson

  2. 2

    Working out positions and drawing the 3D scene are now two separate jobs.

    Layout separate from drawing · came from Mark Parson

Also in this cycle
  • Each nesting level gets its own color, and inner tiles sit just above outer ones. New in this cycle

How we got here

Each change, traced back to the conversation it came from. A solid mark means the record names the source; a dashed one was matched by the draft and waits for review.

Someone said

From the record: no recorded conversation behind this one.

We decided

qmap-c11-D1 Every actor takes one grid square, which keeps packing simple. — Mark Parson

qmap-c11-D2 Groups can hold groups, to any depth. — Mark Parson

qmap-c11-D3 Children are packed in shelves: rows, tallest first. — Mark Parson

So now

The same packing works for three things or hundreds, with boxes inside boxes.

Someone said

From the record: no recorded conversation behind this one.

We decided

qmap-c11-D4 The engine works in grid squares; one square is 1.5 scene units, and that is adjustable. — Mark Parson

So now

Working out positions and drawing the 3D scene are now two separate jobs.

Thanks to

People outside Qpoint first. Every thank-you points at something they said or made.

MP
Mark Parson
Qpoint team

Rebuilt layout as a clean grid engine

The record names no one. The experiment code and this record reached the qmap repo in commits authored by Mark Parson.

All images

Every picture from this cycle. Click any one to step through them all.

The pairs

One engine, any sizeEarly → final
→
Nested tiles that read clearlyNew in this cycle

Everything captured · 11

The full record 4 decisions · 4 key-change entries · 692 words · 11 captures

The record stays as written, for agents and for audit: Key Changes, every decision, the artifacts and the visual record.

Open the record for c11 →

Qpoint Brand Style Guide