OPAQUE-BYTES is an arbitrary byte sequence whose meaning and format are not set by this format itself. It uses the Value direct codes 0x07EL (even bytes) and 0x07FL (odd bytes), family BINARY. The byte count is set by the least significant bit of the Codec and the number of Payload WORDs. It is 2 × Payload WORD count − least significant bit, and no Byte Count is stored (Value).

ItemValue
NameOPAQUE-BYTES (even/odd pair. Names per code are in the member table below)
TAG ID0x07EL·0x07FL
Section3 0011 (Value), offset within section C = 30~31
KindValue · family: BINARY
Index descriptionByte sequence of unknown meaning and format. Even/odd bytes
Hugo pathvalue/binary/opaque-bytes.md

Members

This page covers the two codes of an even/odd pair together. The even code is for values with an even byte count, the odd code for an odd byte count (Record and TAG WORD). There is one codec document per code. The fields of the two codec documents are the same; only the DECLARE target and the name (BIND) differ.

TAG IDNameByte countCodec IDSpec documentTAG WORD
0x07ELOPAQUE-BYTES-EVENeven0x000007E00x00000000/codecs/0x000007E0/0000 0111 1110 LLLL
0x07FLOPAQUE-BYTES-ODDodd0x000007F00x00000000/codecs/0x000007F0/0000 0111 1111 LLLL

Fields (spec document)

The order of FIELDs in the document is the order of Payload fields (Codec spec document).

OrderField (BIND)FIELDWidthAccepted format (CODEC)ENUM
1bytes#2remaining raw bytes (0xFFFF)

Layout

TAG WORD          0000 0111 111P LLLL      Codec 0x07EL/0x07FL
[Length extension TAG] when the total is 15 WORDs or more
Payload WORD 1st ... Nth   bytes / final zero padding

Interpretation and validity

  • Read as many bytes as the byte count from the Payload in order. Within a WORD, the upper byte comes first.
  • The Payload WORD count is ceil(byte count/2). If the code is odd but the lower byte of the last WORD is not 00, it is rejected.
  • If the even/odd code, the Payload WORD count, and the zero padding do not agree with each other, it is rejected.

Format status

  • The even/odd code pair (0x07EL even, 0x07FL odd), the payload arrangement, and the zero padding of the last WORD do not cite an external industry standard; they are GEUL’s own framing.

Length

  • The total is the WORD count of the TAG 1 WORD, the Length extension TAG (if present), and the Payload added together. 14 WORDs or fewer use a direct length; 15 WORDs or more use the 1110·1111 extended length, and the extension TAG is also included in the total (Record and TAG WORD).
  • 0 bytes is written as a 1 WORD record (TAG WORD only) with the even code (0x07EL) (Value).

Examples

The bytes AB CD EF are 3 bytes (odd), so it is OPAQUE-BYTES-ODD (0x07FL), Payload ABCD EF00. The total is 3 WORDs, so LLLL=0010.

07F2 ABCD EF00

The empty byte sequence is the 1 WORD 07E0 (OPAQUE-BYTES-EVEN, TAG WORD only).

Spec document source

This is the spec document 0x00000000/codecs/0x000007E0/latest.geul as read with geul show (hex in uppercase).

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000007E000000000
BODY
#1 DECLARE 0x07E0
#2 FIELD #1 rest
#3 BIND #1 "OPAQUE-BYTES-EVEN"
#4 BIND #2 "bytes"

The above is the codec document of OPAQUE-BYTES-EVEN (0x07EL). The codec document of the other member (OPAQUE-BYTES-ODD) differs only in the codec ID in the DOC-ID, the DECLARE target, and the name bound to #1 (BIND).