9.X API, anchor positioning, bigger scale, set paddings in example. allow smaller screens.

Author: FoamyGuy

adafruit_display_text/outlined_label.py

@@ -100,6 +100,11 @@ def __init__(
         )
 
     def _add_outline(self):
+        """
+        Blit the outline into the labels Bitmap. We will stamp self._stamp_source for each
+        pixel of the foreground color but skip the foreground color when we blit.
+        :return: None
+        """
         if hasattr(self, "_stamp_source"):
             for y in range(self.bitmap.height):
                 for x in range(self.bitmap.width):
@@ -119,12 +124,6 @@ def _add_outline(self):
                                 "Try using either larger padding sizes, or smaller outline_size."
                             ) from value_error
 
-                        # bitmaptools.blit(bitmap, stamp_source, x - size, y - size)
-                        # for y_loc in range(-size, size+1):
-                        #     for x_loc in range(-size, size+1):
-                        #         if bitmap[x+x_loc, y+y_loc] != target_color_index:
-                        #             bitmap[x + x_loc, y + y_loc] = outline_color_index
-
     def _place_text(
         self,
         bitmap: Bitmap,
@@ -136,6 +135,16 @@ def _place_text(
         # when copying glyph bitmaps (this is important for slanted text
         # where rectangular glyph boxes overlap)
     ) -> Tuple[int, int, int, int]:
+        """
+        Copy the glpyphs that represent the value of the string into the labels Bitmap.
+        :param bitmap: The bitmap to place text into
+        :param text: The text to render
+        :param font: The font to render the text in
+        :param xposition: x location of the starting point within the bitmap
+        :param yposition: y location of the starting point within the bitmap
+        :param skip_index: Color index to skip during rendering instead of covering up
+        :return Tuple bounding_box: tuple with x, y, width, height values of the bitmap
+        """
         parent_result = super()._place_text(
             bitmap, text, font, xposition, yposition, skip_index=skip_index
         )

examples/display_text_outlined_label_simpletest.py

@@ -5,17 +5,25 @@
 import terminalio
 from adafruit_display_text import outlined_label
 
-text = "Hello world"
+if board.DISPLAY.width <= 150:
+    text = "Hello\nworld"
+else:
+    text = "Hello world"
+
 text_area = outlined_label.OutlinedLabel(
     terminalio.FONT,
     text=text,
     color=0xFF00FF,
     outline_color=0x00FF00,
     outline_size=1,
-    scale=2,
+    padding_left=2,
+    padding_right=2,
+    padding_top=2,
+    padding_bottom=2,
+    scale=3,
 )
-text_area.x = 10
-text_area.y = 14
-board.DISPLAY.show(text_area)
+text_area.anchor_point = (0,0)
+text_area.anchored_position = (10, 10)
+board.DISPLAY.root_group = text_area
 while True:
     pass