Home /Modules/utf-4088/ENCODER-DECODER.md

ENCODER-DECODER.md

utf-4088/ENCODER-DECODER.md · 42 line(s) · markdown

UTF-4088 encoder and decoder

Status: experimental V1 implementation contract.

Identifier namespaces

The 16,606 front-end records retain identifiers 0x110000..0x1140DD. V1 packed input-state identifiers use the separate interval beginning at 0x200000. This prevents collisions between the front-end registry and encoded input states.

Input packing

A 21-bit packed input contains x (3 bits), y (4 bits), pressure-minus-one (6 bits), and normalized voltage (8 bits):

BitsFieldValid values
0–2x0–7
3–6y0–11
7–12pressure minus one0–49
13–20normalized voltage0–255

Bits 21–31 are reserved and must be zero. Values are logical normalized application inputs, not raw electrical readings or physical pressure.

The identifier is 0x200000 + packed_input. Decode subtracts the base and validates every field. Invalid coordinates, pressure values, reserved bits, front-end IDs, and out-of-range identifiers are rejected.

API

Include encoder_decoder.hpp and use pack_input, unpack_input, encode_input, and decode_input. symbol_from_input accepts a packed V1 input word and returns the disjoint experimental identifier.

Limits

This is an identifier mapping, not a Unicode encoding and not a 4,088-bit integer. It does not encode semantic meaning. Semantic annotations remain separate registry data with provenance and review status.