UPDATE - UPD direction inclusion - Docs Update

Author: jposada202020

adafruit_display_text/__init__.py

@@ -161,36 +161,67 @@ class LabelBase(Group):
     Subclasses should implement ``_set_text``, ``_set_font``, and ``_set_line_spacing`` to
     have the correct behavior for that type of label.
 
+    Anchor points are represented in the corners of the following graph
+
+    (0.0,0.0)┌──────────────────────────────────────────────────────────────┐ (1.0,0.0)
+             │                                          @@      |           │
+             │                                          @@      Ascent      │
+             │                                          @@      |           │
+             │------------------------------------------@@+-----|-----------│
+             │      %@   @%      @@@@@@@@%       %@@@@@@@@      |           │
+             │       %@ @%       @@%    %@       @%    %@@      |           │
+             │        %@%        @@      @%     %@      @@      |           │ Bounding BOX
+             │        %@%        @@      @$     $@      @@      |           │
+             │       %@ @%       @@$     @       @%    $@@      |           │
+             │      %@   @%      @@@@@@@%         %@@@@@@@      |           │
+             │-------------------@@+----------------------------------------│ Baseline
+             │                   @@   |                                     │
+             │                   @@   Descent                               │
+             │                   @@___|                                     │
+    (0.0,1.0)╰──────────────────────────────────────────────────────────────┘(1.0,1.0)
+
+
     :param Font font: A font class that has ``get_bounding_box`` and ``get_glyph``.
       Must include a capital M for measuring character size.
     :param str text: Text to display
     :param int max_glyphs: Unnecessary parameter (provided only for direct compability
      with :py:func:`~adafruit_display_text.label.Label`)
+
     :param int color: Color of all text in RGB hex
     :param int background_color: Color of the background, use `None` for transparent
+
     :param float line_spacing: Line spacing of text to display
+
     :param bool background_tight: Set `True` only if you want background box to tightly
      surround text. When set to 'True' Padding parameters will be ignored.
+
     :param int padding_top: Additional pixels added to background bounding box at top
     :param int padding_bottom: Additional pixels added to background bounding box at bottom
     :param int padding_left: Additional pixels added to background bounding box at left
     :param int padding_right: Additional pixels added to background bounding box at right
+
     :param (float,float) anchor_point: Point that anchored_position moves relative to.
      Tuple with decimal percentage of width and height.
      (E.g. (0,0) is top left, (1.0, 0.5): is middle right.)
     :param (int,int) anchored_position: Position relative to the anchor_point. Tuple
      containing x,y pixel coordinates.
+
     :param int scale: Integer value of the pixel scaling
+
     :param bool save_text: Set True to save the text string as a constant in the
      label structure.  Set False to reduce memory use.
+
     :param bool base_alignment: when True allows to align text label to the baseline.
      This is helpful when two or more labels need to be aligned to the same baseline
+
     :param (int,str) tab_replacement: tuple with tab character replace information. When
      (4, " ") will indicate a tab replacement of 4 spaces, defaults to 4 spaces by
      tab character
+
     :param str label_direction: string defining the label text orientation. There are 5
      configurations possibles ``LTR``-Left-To-Right ``RTL``-Right-To-Left
-     ``TTB``-Top-To-Bottom ``UPR``-Upwards ``DWR``-Downwards. It defaults to ``LTR``"""
+     ``TTB``-Top-To-Bottom ``UPR``-Upwards ``DWR``-Downwards and ``UPD``-Upside-Down
+     (bitmap_label only). It defaults to ``LTR``"""
 
     # pylint: disable=unused-argument,  too-many-instance-attributes, too-many-locals, too-many-arguments
     def __init__(
@@ -235,7 +266,7 @@ def __init__(
 
         self._text = text
 
-        if label_direction not in ["LTR", "RTL", "UPR", "DWR", "TTB"]:
+        if label_direction not in ["LTR", "RTL", "UPR", "DWR", "TTB", "UPD"]:
             raise RuntimeError("Please provide a valid text direction")
         self._label_direction = label_direction
 
@@ -384,6 +415,7 @@ def bounding_box(self) -> Tuple[int, int]:
         first two numbers are offset from the x, y origin of this group"""
         return tuple(self._bounding_box)
 
+    # pylint: disable=no-member
     @property
     def line_spacing(self) -> float:
         """The amount of space between lines of text, in multiples of the font's
@@ -410,6 +442,6 @@ def _set_label_direction(self, new_label_direction: str) -> None:
     @label_direction.setter
     def label_direction(self, new_label_direction: str) -> None:
         """Set the text direction of the label"""
-        if new_label_direction not in ["LTR", "RTL", "UPR", "DWR", "TTB"]:
+        if new_label_direction not in ["LTR", "RTL", "UPR", "DWR", "TTB", "UPD"]:
             raise RuntimeError("Please provide a valid text direction")
         self._set_label_direction(new_label_direction)

adafruit_display_text/bitmap_label.py

@@ -79,7 +79,7 @@ class Label(LabelBase):
      tab character
     :param str label_direction: string defining the label text orientation. There are 5
      configurations possibles ``LTR``-Left-To-Right ``RTL``-Right-To-Left
-     ``UPR``-Upwards ``DWR``-Downwards. It defaults to ``LTR``"""
+     ``UPR``-Upwards ``DWR``-Downwards and ``UPD``-Upside-Down. It defaults to ``LTR``"""
 
     # pylint: disable=unused-argument, too-many-instance-attributes, too-many-locals, too-many-arguments
     # pylint: disable=too-many-branches, no-self-use, too-many-statements
@@ -282,6 +282,9 @@ def _reset_text(
             if self._label_direction == "DWR":
                 self.tilegrid.transpose_xy = True
                 self.tilegrid.flip_y = True
+            if self._label_direction == "UPD":
+                self.tilegrid.flip_x = True
+                self.tilegrid.flip_y = True
 
             # Clear out any items in the local_group Group, in case this is an update to
             # the bitmap_label