This example code contains a function called wrap_nicely that can be used to reformat string text and add line brakes to wrap text at a given text count.<\/p>\n\n\n\n\n\n\n\n
# return a reformatted string with wordwrapping\n#@staticmethod\ndef wrap_nicely(string, max_chars):\n \"\"\"A helper that will return the string with word-break wrapping.\n :param str string: The text to be wrapped.\n :param int max_chars: The maximum number of characters on a line before wrapping.\n \"\"\"\n string = string.replace('\\n', '').replace('\\r', '') # strip confusing newlines\n words = string.split(' ')\n the_lines = []\n the_line = \"\"\n for w in words:\n if len(the_line+' '+w) <= max_chars:\n the_line += ' '+w\n else:\n the_lines.append(the_line)\n the_line = w\n if the_line:\n the_lines.append(the_line)\n the_lines[0] = the_lines[0][1:]\n the_newline = \"\"\n for w in the_lines:\n the_newline += '\\n'+w\n return the_newline<\/code><\/pre>\n\n\n\nThere is a glitch with text rendering when the Label.text is updated with this reformatted text. To fix this I recommend updating Label.text with “” to clear out whatever is glitching.<\/p>\n\n\n\n
Here is the full example code where I have added recalculation of the Label.y position to account for the position change due to the number of text lines.<\/p>\n\n\n\n
import time\nimport board\nimport displayio\nfrom adafruit_bitmap_font import bitmap_font\nfrom adafruit_display_text import label\n\ndisplay = board.DISPLAY\n \n# ---------- Set the font and preload letters ---------- \n# Be sure to put your font into a folder named \"fonts\".\nfont = bitmap_font.load_font(\"\/fonts\/Helvetica-Bold-16.bdf\")\n# This will preload the text images.\nfont.load_glyphs(b'abcdefghjiklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ- ()')\n\nglyph_box = font.get_bounding_box()\nglyph_h = glyph_box[1] + abs(glyph_box[3])\n \n# ---------- Create the text label object ---------- \n# font: the font used\n# text: some words that you want to display\n# color: set the font color\n# max_glyphs: the number of letters that can appear in this label\ntext_area = label.Label(font, text=\"HELLO WORLD\", color=0xFF00FF, max_glyphs=200)\n\n# Set the location\ntext_area.x = 20\ntext_area.y = 100\n\n# Set the size of the text in whole numbers. 1 = full size and 2 = twice the size.\ntext_area.scale = 1\n\n# return a reformatted string with wordwrapping\n#@staticmethod\ndef wrap_nicely(string, max_chars):\n \"\"\"A helper that will return the string with word-break wrapping.\n :param str string: The text to be wrapped.\n :param int max_chars: The maximum number of characters on a line before wrapping.\n \"\"\"\n string = string.replace('\\n', '').replace('\\r', '') # strip confusing newlines\n words = string.split(' ')\n the_lines = []\n the_line = \"\"\n for w in words:\n if len(the_line+' '+w) <= max_chars:\n the_line += ' '+w\n else:\n the_lines.append(the_line)\n the_line = w\n if the_line:\n the_lines.append(the_line)\n the_lines[0] = the_lines[0][1:]\n the_newline = \"\"\n for w in the_lines:\n the_newline += '\\n'+w\n return the_newline\n\n# Show it\ndisplay.show(text_area)\n\nwhile True:\n # this is used to clear the text buffer\n text_area.text = \"\" # Odd things happen without this\n # Create the Wrapped text string and set it to new_text\n new_text = wrap_nicely(\"The first command is 0xe1 with 15 (0xf) parameters following. The second and third are 0x11 and 0x29 respectively with delays (0x80) of 120ms (0x78) and no parameters.\", 33)\n # Calculate the new text_area.y based on the number of text lines.\n text_area.y = round(new_text.count(\"\\n\")*glyph_h\/2)\n # Send the new wrapped string to text_area.text\n text_area.text = new_text\n\n time.sleep(3)\n text_area.text = \"\" # Odd things happen without this\n new_text = wrap_nicely(\"Now this is a fine mess that we are in.\", 13)\n text_area.y = round(new_text.count(\"\\n\")*glyph_h\/2)\n text_area.text = new_text\n time.sleep(3)<\/code><\/pre>\n\n\n\nThe wrap_nicely() function is based on a similar function used in the adafruit_pyportal.py<\/strong> library for CircuitPython.<\/p>\n\n\n\n