MIME-Version: 1.0
References: <CAMZUoKmiwXW50F2onqNUZO8HXQa4+Z=z3s3WyN7-rAMV=KiSgw@mail.gmail.com>
 <CAF90AvmaRYO6HKn9npyfzO6M6FZnN6DRhqopLpeSnHJNK=5i9g@mail.gmail.com>
 <Y+40gVnMpj0prfQk@camus> <f19acdabd3fbc0ff389669131acbb79e@dtrt.org>
 <Y/Ke4yV7eV/87Kat@camus>
In-Reply-To: <Y/Ke4yV7eV/87Kat@camus>
From: Christopher Allen <ChristopherA@lifewithalacrity.com>
Date: Sun, 19 Feb 2023 15:05:12 -0800
Message-ID: <CACrqygByMiEJNmn33DjOet8m3kjz116y-8y8v7EYrLq1-NG95w@mail.gmail.com>
To: Andrew Poelstra <apoelstra@wpsoftware.net>, 
 Bitcoin Protocol Discussion <bitcoin-dev@lists.linuxfoundation.org>
Content-Type: multipart/alternative; boundary="000000000000dae1c405f5159414"
Subject: Re: [bitcoin-dev] Codex32
Precedence: list

--000000000000dae1c405f5159414
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

An easy but possibly very important tip:

If you use only UPPER CASE alpha and numbers in codex32, and avoid most
punctuation, it makes QR rendering of it significantly smaller. This is
because the QR code to the ISO SPEC, when seeing lowercase, assumes the
value is binary, then converts it to a two byte value. If instead, the
codex32 is all upper, and it uses only the 45 allowed characters (see
https://www.thonky.com/qr-code-tutorial/alphanumeric-table) , it will leave
it single byte and try to compress it. Of course it doesn=E2=80=99t compres=
s well,
but that is OK because it at least didn=E2=80=99t double the size first.

See our research on this topic at
https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2020-0=
03-uri-binary-compatibility.md

A superior QR codec can do better (see our
https://github.com/BlockchainCommons/QRCodeGenerator or
https://www.nayuki.io/page/qr-code-generator-library) but many platforms
and more basic QR codecs will double the size of the QR if you have any
lower case.

=E2=80=94 Christopher Allen

--000000000000dae1c405f5159414
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

An easy but possibly very important tip:=C2=A0<div dir=3D"auto"><br></div><=
div dir=3D"auto">If you use only UPPER CASE alpha and numbers in codex32, a=
nd avoid most punctuation, it makes QR rendering of it significantly smalle=
r. This is because the QR code to the ISO SPEC, when seeing lowercase, assu=
mes the value is binary, then converts it to a two byte value. If instead, =
the codex32 is all upper, and it uses only the 45 allowed characters (see <=
div dir=3D"auto"><a href=3D"https://www.thonky.com/qr-code-tutorial/alphanu=
meric-table">https://www.thonky.com/qr-code-tutorial/alphanumeric-table</a>=
) , it will leave it single byte and try to compress it. Of course it doesn=
=E2=80=99t compress well, but that is OK because it at least didn=E2=80=99t=
 double the size first.=C2=A0</div></div><div dir=3D"auto"><br></div><div d=
ir=3D"auto">See our research on this topic at=C2=A0<div><a href=3D"https://=
github.com/BlockchainCommons/Research/blob/master/papers/bcr-2020-003-uri-b=
inary-compatibility.md">https://github.com/BlockchainCommons/Research/blob/=
master/papers/bcr-2020-003-uri-binary-compatibility.md</a></div><div dir=3D=
"auto"><br></div><div dir=3D"auto">A superior QR codec can do better (see o=
ur=C2=A0<div dir=3D"auto"><a href=3D"https://github.com/BlockchainCommons/Q=
RCodeGenerator">https://github.com/BlockchainCommons/QRCodeGenerator</a> or=
=C2=A0<div dir=3D"auto"><a href=3D"https://www.nayuki.io/page/qr-code-gener=
ator-library">https://www.nayuki.io/page/qr-code-generator-library</a>) but=
 many platforms and more basic QR codecs will double the size of the QR if =
you have any lower case.</div></div></div><div dir=3D"auto"><br></div><div =
dir=3D"auto">=E2=80=94 Christopher Allen</div></div><div dir=3D"auto"><br><=
/div>

--000000000000dae1c405f5159414--