view bwsplash/README @ 299:91e61d00a6b5

add AT@BUZ and AT@BZSTOP commands for testing BUZM SWE
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 29 Mar 2022 04:41:25 +0000
parents a963d8cd8682
children
line wrap: on
line source

When TI's original version of small B&W UI firmware boots or shuts down, the
splash screen it displays consists of a 56x38 pixel B&W TI logo centered in the
middle of the LCD.  (Back when this code was owned by Condat rather than TI,
this splash screen was an animated Condat logo of approximately the same size -
it is still present in the code, conditioned out.)  Because we are FreeCalypso
and not TI or Condat, we need our own logo or at least our own splash screen to
replace those other company logos.

A bona fide FreeCalypso logo does not exist yet as of this writing (2021-03),
and while we (Falconia family that owns FC) do have some logo ideas in the
works, the 96x64 pixel B&W (1bpp) framebuffer in the FreeCalypso Lite config is
far too limited compared to other media - hence we are currently going for a
simple splash screen that merely consists of the words "FreeCalypso Lite".

The current version of our minimal-effort splash screen is 80x30 pixels, to be
centered in the middle of the 96x64 pixel LCD.  The bitmap drawing is given in
bwsplash.pbm, which is a Plain PBM file, making the pixel image directly
viewable and editable in vi.  The tools in this directory compile it into hex
bytes for inclusion in C source, and the finished artifact goes into
src/ui/bmi/mmiIcons.c, fc_splash_screen_smallbw[] char array.  The coordinates
for positioning this bitmap within the full 96x64 pixel framebuffer are given
in src/ui/bmi/mmiResources.h - look for WELCOME_ANI_POS_X and WELCOME_ANI_POS_Y
definitions.

The present splash screen is strictly a minimal-effort job with absolutely no
quality claims of any kind.  If someone is more graphically talented than I am,
or has more time to invest into drawing a prettier splash screen, suggestions
for improvement are always welcome.