Consider offering control over creation of background bitmap to reduce memory usage

[kevinjwalters]

I've not followed the recent changes to this library but somewhere since https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/tag/20200327 an extra bitmap is created for a background feature. This is the likely candidate for the primary cause of a MemoryError exception that now occurs using this library for the application in Adafruit Learn: CLUE Sensor Plotter in CircuitPython. An example of this exception output can be seen in the description of the second issue in Adafruit Forums: Clue_Plotter Problem.

This may affect other existing applications too. I'd guess ones with lots of text on screen, large (possibly scaled) text and/or memory tight ones are more at risk.

I'm not sure what the new bitmap is for but a decision on whether this feature should be off by default would be useful and dictate whether existing applications need testing/reviewing/changing.

[kevinjwalters]

This might also be the cause for my audio becoming a little more choppy. I'm moving around some bitmaps with text underneath them while playing samples in my applicaiton. I'd shrunk them down a bit in size to reduce the pauses in playback to an acceptable amount but it's possible they got worse a week or two ago. I'd assumed this was my imagination but it's possible it coincided with me doing a library refresh and picking up a later adafruit_display_text library with the background bitmap in my Label objects.

[FoamyGuy]

@kevinjwalters if you have a moment try testing out the branch from this PR: kmatch98#2

It should avoid making the bitmap if background color is not used.

[kevinjwalters]

I tried https://github.com/FoamyGuy/Adafruit_CircuitPython_Display_Text/blob/51e13b2e619c9069f74c60eeb4c2f9f64b052247/adafruit_display_text/label.py with the plotter program from my guide, same error

Traceback (most recent call last):
  File "code.py", line 197, in <module>
  File "code.py", line 162, in popup_text
  File "plotter.py", line 786, in info
  File "/lib/adafruit_display_text/label.py", line 130, in __init__
  File "/lib/adafruit_display_text/label.py", line 300, in _update_text
  File "/lib/adafruit_display_text/label.py", line 169, in _create_background_box
MemoryError: memory allocation failed, allocating 1616 bytes

I think that's expected as it sets a blue backround which triggers the creation of the bitmap even when the monospaced terminalio.FONT is in use? Perhaps there's a (reliable) way to detect if a font is proportionally spaced? If so, that would be a useful extra condition around the use of a bg bitmap to reduce memory usage for monospaced use.

[FoamyGuy]

Ahh, yeah I think you are right. It would still be making the bitmap now. I'm going to work on getting it finalized later today. I will look into the possibility of skipping the bitmap for termainli.FONT text.

[kmatch98]

This was resolved in #59

The default for background color is None and now prevents creation of the bitmap. I hope this will resolve your memory usage issue.

[kevinjwalters]

I've tested three different versions of the library from February, June and the most recent one in July and there's both performance differences and rendering differences using terminalio.FONT: https://www.youtube.com/watch?v=FtI1xx6o3c8

That's running on 5.3.0 btw.

[kmatch98]

@kevinjwalters Thank you for the video, this is good insight. Can you clarify how you are generating this demo? Are your recreating the text label from scratch or moving its x,y location? If moving x,y are you doing this in a higher level group or relocating this box?

If possible please post the demo code, I want to be sure to understand the specific issue that is causing the performance change.

[kevinjwalters]

From the video description: https://github.com/kevinjwalters/circuitpython-examples/blob/master/clue/clue-label-test.py

[kmatch98]

Thanks. Sorry I overlooked it in the description. Was too fixated on watching the complex storyline of the video :)

[kmatch98]

@FoamyGuy just adding you to this so you will be aware of the performance change listed above. This probably should be added as a new issue.

So far I haven’t dug into this yet.

[caternuson]

This appears to have been closed, but I just hit the same issue.

code.py is the clue-plotter.py program from this guide:
https://learn.adafruit.com/clue-sensor-plotter-circuitpython/circuitpython-sensor-plotter
along with the other .py files from there.

Using library bundle adafruit-circuitpython-bundle-5.x-mpy-20200728.zip, also printing __version__ below just to verify:

Adafruit CircuitPython 5.3.1 on 2020-07-13; Adafruit CLUE nRF52840 Express with nRF52840
>>> from adafruit_display_text import label
>>> label.__version__
'2.8.0'
>>>
soft reboot

Auto-reload is on. Simply save files over USB to run them or enter REPL to disable.
code.py output:
Traceback (most recent call last):
  File "code.py", line 195, in <module>
  File "code.py", line 162, in popup_text
  File "plotter.py", line 786, in info
  File "adafruit_display_text/label.py", line 128, in __init__
  File "adafruit_display_text/label.py", line 303, in _update_text
  File "adafruit_display_text/label.py", line 212, in _update_background_color
  File "adafruit_display_text/label.py", line 169, in _create_background_box
MemoryError: memory allocation failed, allocating 1616 bytes