Viewing is open to everyone. Downloading and starring need a GitHub sign-in.
Sign in with GitHub
CKey-Format-v0.14.0.md
v0.1.0-build.85
Latest
Commit ede38f5
Sign in with GitHub to download. Each download is recorded with your GitHub username.
| 1 | # CKey locator format v0.14.0 (draft) |
| 2 | |
| 3 | Status: experimental reference profile. Encoder output uses `format=14` (`0E`) |
| 4 | and `profile=1`. Historic locator formats 8 and 11--13 remain decoder-readable. |
| 5 | |
| 6 | ## Corner finders |
| 7 | |
| 8 | The field is 29 by 29 units with a continuous 0.65-unit rounded-square border |
| 9 | from `(0.5,0.5)` to `(28.5,28.5)`, radius 3.5. Each finder is **one** broad, |
| 10 | round-capped arc inside that border. Its local top-left centre is `(4.0,4.0)`, |
| 11 | radius `2.30`, width `0.80`; its reflected instances occupy the other corners. |
| 12 | The arc follows the upper-left exterior quadrant from `(1.70,4.0)` to |
| 13 | `(4.0,1.70)`, so its open/concave mouth faces down-right toward the polar ring |
| 14 | matrix. The other three corner arcs are continuous. The top-left arc is split |
| 15 | at 225 degrees with a cap-compensated `0.95`-unit visible gap, which is the |
| 16 | orientation signature. All 6 by 6 corner envelopes are reserved. |
| 17 | |
| 18 | Profile 2 and Profile 3 use this same normalized construction: one inboard |
| 19 | arc per rounded corner, a continuous outer border, and the top-left split. |
| 20 | Their geometric scale changes with their physical field; it does not change |
| 21 | the one-arc semantic or its orientation. |
| 22 | |
| 23 | ## Remaining rules |
| 24 | |
| 25 | Grid, Ray, and Ring Keys; 72-slot polar rings and ray band; payload placement; |
| 26 | and the 16-byte locator capacity are unchanged. The frame is |
| 27 | `C7 4B 0E 01 00 10`, payload, then CRC-32C; it is systematic shortened |
| 28 | RS(77,26) over GF(256), polynomial `0x11D`, with 51 parity bytes and a |
| 29 | 25-unknown-byte-error bound. An image reader uses structural key/finder |
| 30 | evidence to fit geometry but accepts a payload only after RS and CRC checks. |
| 31 | |
| 32 | The normative vector is [`locator-v14.json`](../tests/vectors/locator-v14.json). |