Native FBInk: Another small tool to print crap on your screen!

[NiLuJe]

So, err, I may have reimplemented eips from scratch. Oops?!

Long story short, not having eips on Kobo had been bugging me for a while, so I finally caved and did it myself.

And then I kind of went a wee bit overboard with it... .

So, yeaaaah, here it is, tailored for Kindles...

NOTE: It's also bundled with USBNet, provided you use a current snapshot, which you should .

NOTE: It's actually also usable as a C library (in which case, you can also strip down extra fonts, image & OpenType support to to shave it down to ~55KB). The binaries attached here are basically a commandline utility statically linked to said library. Some flags & options may look familiar .

NOTE: Bindings available in Go, LuaJIT & Python (with the Python bindings being shipped as part of my Python package).

[NiLuJe]

Released v0.9.10 .

This one *may* actually properly handle the KOA2. Or not. .

[PoP]

From the usbnet bundle:

Spoiler:

[root@kindle us]# fbink -c -p -m -y 10 -S 6 "Thanks for fbink NiLuJe" 
[FBInk] Variable fb info: 1448x1072, 8bpp @ rotation: 2
[FBInk] Fontsize set to 48x48.
[FBInk] Line length: 30 cols, Page size: 22 rows.
[FBInk] Fixed fb info: smem_len 6782976, line_length 1472
[FBInk] Kernel's HZ value appears to be 100
Printing string 'Thanks for fbink NiLuJe' @ column 0, row 10 (inverted: false, flashing: false, centered: true, left padded: true, clear screen: true, font scaling: x6)
[root@kindle us]# fbink -m -y 18 "$(cat PoP.txt)"
[FBInk] Variable fb info: 1448x1072, 8bpp @ rotation: 2
[FBInk] Fontsize set to 32x32.
[FBInk] Line length: 45 cols, Page size: 33 rows.
[FBInk] Fixed fb info: smem_len 6782976, line_length 1472
[FBInk] Kernel's HZ value appears to be 100            
Printing string ' ____          ____    
/\  _`\       /\  _`\  
\ \ \L\ \ ___ \ \ \L\ \
 \ \ ,__// __`\\ \ ,__/
  \ \ \//\ \L\ \\ \ \/ 
   \ \_\\ \____/ \ \_\ 
    \/_/ \/___/   \/_/ 
      ' @ column 0, row 18 (inverted: false, flashing: false, centered: true, left padded: false, clear screen: false, font scaling: x0)
[root@kindle us]# screenshot

[NiLuJe]

@PoP: \o/

And just to assuage my inner OCD: that was a BOM at the beginning of PoP.txt, right?

[PoP]

Exactly. And I shamelessly stripped the fbink warning that said it would ignore it!

[NiLuJe]

Released v0.9.12 .

This one mainly has new centering code, so that stuff is even more in the middle than before! Yay.

(Also, stuff may be even more broken than before, because basic geometry & arithmetics and me don't mix).

This should also feature a slightly more correct KOA2 handling .

[PoP]

Still working

Spoiler:

[root@kindle us]# ./fbink -c -p -m -y 9 -S 6 -F fantasy "BOM"
[FBInk] Variable fb info: 1448x1072, 8bpp @ rotation: 2
[FBInk] Fontsize set to 48x48.
[FBInk] Line length: 30 cols, Page size: 22 rows.
[FBInk] Fixed fb info: smem_len 6782976, line_length 1472
[FBInk] Kernel's HZ value appears to be 100
Printing string 'BOM' @ column 0, row 9 (inverted: false, flashing: false, centered: true, left padded: true, clear screen: true, font scaling: x6)
[root@kindle us]# ./fbink -p -m -y 10 -S 6 "Now handled?"
[FBInk] Variable fb info: 1448x1072, 8bpp @ rotation: 2
[FBInk] Fontsize set to 48x48.
[FBInk] Line length: 30 cols, Page size: 22 rows.
[FBInk] Fixed fb info: smem_len 6782976, line_length 1472
[FBInk] Kernel's HZ value appears to be 100
Printing string 'Now handled?' @ column 0, row 10 (inverted: false, flashing: false, centered: true, left padded: true, clear screen: false, font scaling: x6)
[root@kindle us]# ./fbink -p -m -y 18 "$(cat PoP.txt)"
[FBInk] Variable fb info: 1448x1072, 8bpp @ rotation: 2
[FBInk] Fontsize set to 32x32.
[FBInk] Line length: 45 cols, Page size: 33 rows.
[FBInk] Fixed fb info: smem_len 6782976, line_length 1472
[FBInk] Kernel's HZ value appears to be 100
Printing string '____          ____
/\  _`\       /\  _`\
\ \ \L\ \ ___ \ \ \L\ \
 \ \ ,__// __`\\ \ ,__/
  \ \ \//\ \L\ \\ \ \/
   \ \_\\ \____/ \ \_\
    \/_/ \/___/   \/_/
      ' @ column 0, row 18 (inverted: false, flashing: false, centered: true, left padded: true, clear screen: false, font scaling: x0)
[FBInk] Codepoint U+FEFF is not covered by this font!
[root@kindle us]# screenshot
[root@kindle us]#

[NiLuJe]

Released v0.9.14 (after a 0.9.13) .

It's mostly Kobo fixes, but hopefully, I didn't break anything else on the way .

[NiLuJe]

And v1.0.0 is finally out the door .

Again, mainly Kobo & API tweaks. And the KV should now default to a slightly smaller font size.

[NiLuJe]

Released v1.2.0 .

With one major feature, bringing us to (useful) feature parity with eips: image support! Yay!
Most common image formats are supported, although you really should be using properly dithered PNGs .

JPEG (at least for my test images) appears to be slightly broken on really legacy devices (i.e., armv6), but the rest looks okay there .

[PoP]

Now with graphics support...

Spoiler:

[root@kindle us]# fbink -c -p -m -y 9 -S 6 -F fantasy "T H A N K S !"
[FBInk] Variable fb info: 1448x1072, 8bpp @ rotation: 2 (Upside Down, 180°)
[FBInk] Fontsize set to 48x48.
[FBInk] Line length: 30 cols, Page size: 22 rows.
[FBInk] Fixed fb info: ID is "mxc_epdc_fb", length of fb mem: 6782976 bytes & line length: 1472 bytes
[FBInk] Kernel's HZ value appears to be 100
Printing string 'T H A N K S !' @ column 0, row 9 (inverted: false, flashing: false, centered: true, left padded: true, clear screen: true, font scaling: x6)
[root@kindle us]# fbink -g file=NiLuJe.png -x 26   -y 10
[FBInk] Variable fb info: 1448x1072, 8bpp @ rotation: 2 (Upside Down, 180°)
[FBInk] Fontsize set to 24x24.
[FBInk] Line length: 60 cols, Page size: 44 rows.
[FBInk] Fixed fb info: ID is "mxc_epdc_fb", length of fb mem: 6782976 bytes & line length: 1472 bytes
[FBInk] Kernel's HZ value appears to be 100
Displaying image 'NiLuJe.png' @ (0, 0)
[root@kindle us]# fbink -p -m -y 22 "$(cat PoP.txt)"
[FBInk] Variable fb info: 1448x1072, 8bpp @ rotation: 2 (Upside Down, 180°)
[FBInk] Fontsize set to 24x24.
[FBInk] Line length: 60 cols, Page size: 44 rows.
[FBInk] Fixed fb info: ID is "mxc_epdc_fb", length of fb mem: 6782976 bytes & line length: 1472 bytes
[FBInk] Kernel's HZ value appears to be 100
Printing string ' ____          ____
/\  _`\       /\  _`\
\ \ \L\ \ ___ \ \ \L\ \
 \ \ ,__// __`\\ \ ,__/
  \ \ \//\ \L\ \\ \ \/
   \ \_\\ \____/ \ \_\
    \/_/ \/___/   \/_/
      ' @ column 0, row 22 (inverted: false, flashing: false, centered: true, left padded: true, clear screen: false, font scaling: x0)
[root@kindle us]# screenshot

[PoP]

After the book, the native version!

Spoiler:

#!/bin/sh
#
#moving worms
#end with CTRL-C
cd /mnt/us
fbink -c -x 15 -y 18 "Moving Worms"
while :;do fbink -g file=0.png -x 12  -y 20;usleep 200000;fbink -g file=1.png -x 12  -y 20;usleep 200000;fbink -g file=2.png -x 12  -y 20;usleep 200000;fbink -g file=3.png -x 12  -y 20;usleep 200000;fbink -g file=4.png -x 12  -y 20;usleep 200000;fbink -g file=5.png -x 12  -y 20;usleep 200000;fbink -g file=6.png -x 12  -y 20;usleep 200000;fbink -g file=7.png -x 12  -y 20;usleep 200000;fbink -g file=8.png -x 12  -y 20;usleep 200000;fbink -g file=9.png -x 12  -y 20;usleep 200000;fbink -g file=10.png -x 12  -y 20;usleep 200000;fbink -g file=11.png -x 12  -y 20;usleep 200000;fbink -g file=12.png -x 12  -y 20;usleep 200000;fbink -g file=13.png -x 12  -y 20;usleep 200000;fbink -g file=14.png -x 12  -y 20;usleep 200000;fbink -g file=15.png -x 12  -y 20;usleep 200000;fbink -g file=16.png -x 12  -y 20;usleep 200000;fbink -g file=17.png -x 12  -y 20;usleep 200000;fbink -g file=18.png -x 12  -y 20;usleep 200000;fbink -g file=19.png -x 12  -y 20;usleep 200000;fbink -g file=20.png -x 12  -y 20;usleep 200000;fbink -g file=21.png -x 12  -y 20;usleep 200000;fbink -g file=22.png -x 12  -y 20;usleep 200000;fbink -g file=23.png -x 12  -y 20;usleep 200000;fbink -g file=24.png -x 12  -y 20;usleep 200000;fbink -g file=25.png -x 12  -y 20;usleep 200000;fbink -g file=26.png -x 12  -y 20;usleep 200000;fbink -g file=27.png -x 12  -y 20;usleep 200000;fbink -g file=28.png -x 12  -y 20;usleep 200000;fbink -g file=29.png -x 12  -y 20;usleep 200000;done

SCNR

[NiLuJe]

Released v1.2.5 .

Expands on the image display feature of v1.2.0 by adding proper transparency support (i.e., if you feed it an image with an alpha channel, it'll do the right thing with it) .

You can opt to disable this via a flag, because it comes with a bit of a performance penalty .

It also properly handles 4bpp framebuffers, for real this time. Turns out the JPEG issue in 1.2.0 was actually much more generalized, I just hadn't really noticed it, because, err, coding at night, no frontlight... . Oops?.
(Text was mostly unaffected by the issue, because the fact that it's either black or white was hiding the underlying issue ).

[PoP]

Spoiler:

/mnt/us/SW.sh StarWar.txt

#!/bin/sh
#
#Star War-Display-esque of a file
L1=" "
L2=" "
L3=" "
L4=" "
L6=" "
file="/mnt/us/$1"
fbink -cmp -y 10 -S 6 "THE PHANTOM MENACE"
while IFS= read -r line
do
  L6=$line
  fbink -mp -y 103 -S 1 "$L1"
  fbink -mp -y 53 -S 2 "$L2"
  fbink -mp -y 37 -S 3 "$L3"
  fbink -mp -y 29 -S 4 "$L4"
  fbink -mp -y 24 -S 5 "$L5"
  fbink -mp -y 21 -S 6 "$L6"
  usleep 1000000
  L1=$L2
  L2=$L3
  L3=$L4
  L4=$L5
  L5=$L6
done <"$file"

Try it on any file :

[PoP]

I was trying to zoom a single "X" character on a K3:

#!/bin/sh
#
#Zoom
i=1
while [ "$i" -le "45" ]; do
  fbink -cmp -S $i "X"
  /mnt/us/screenshot.sh
  usleep 1000000
  i=$(($i + 1))
done

It started all right from S 1 to S 36:
S 1 S 2 S 3 ... to S 36

But from S 37 to S 45 doubled "X" appeared:
S 37 ... to S 45

Any idea what's wrong?