Add drawTextBox function

Author: JosipKuci

src/include/Graphics.cpp

@@ -271,4 +271,105 @@ int16_t Graphics::width()
 int16_t Graphics::height()
 {
     return _height;
-};
+};
+
+
+/**
+ * @brief       Draws a text box with optional border and word-wrapped content
+ *
+ * @param       int16_t x0  
+ *              Top-left x-coordinate of the text box
+ * @param       int16_t y0  
+ *              Top-left y-coordinate of the text box
+ * @param       int16_t x1  
+ *              Bottom-right x-coordinate of the text box
+ * @param       int16_t y1  
+ *              Bottom-right y-coordinate of the text box
+ * @param       const char* text  
+ *              The null-terminated string to be rendered inside the box
+ * @param       uint16_t textSizeMultiplier  
+ *              Size multiplier for the text
+ * @param       const GFXfont* font  
+ *              Pointer to the font to use for rendering the text
+ * @param       uint16_t verticalSpacing  
+ *              Vertical spacing (in pixels) between lines of text; if 0 or NULL, defaults to text height + padding
+ * @param       bool showBorder  
+ *              Whether to draw a border around the text box
+ * @param       uint16_t fontSize  
+ *              Font size in points (pt)
+ *
+ * @details     This function renders a block of text inside the defined rectangular area.
+ *              It automatically wraps words to the next line if they exceed the available width.
+ *              If the text does not fit entirely, an ellipsis ("...") is added to the final visible line.
+ *              Text is padded with spaces to keep a consistent line length.
+ */
+void Graphics::drawTextBox(int16_t x0,int16_t y0,int16_t x1,int16_t y1, const char* text,uint16_t textSizeMultiplier, const GFXfont *font, uint16_t verticalSpacing, bool showBorder, uint16_t fontSize )
+{
+    int16_t currentX = x0;
+    int16_t currentY = y0;
+
+    int16_t textLenght=strlen(text);
+    int offset=0;
+    fontSize=(fontSize*3)/4; //1pt = 4/3 px
+    int numOfCharactersPerLine=(x1-x0)/(textSizeMultiplier*fontSize);
+    int16_t currentLineLenght=numOfCharactersPerLine;
+    this->setTextSize(textSizeMultiplier);
+    this->setFont(font);
+    if(showBorder)
+    {
+        this->drawRect(x0,y0,(x1-x0),(y1-y0),1);
+    }
+    if(verticalSpacing==NULL)
+    {
+        verticalSpacing=textSizeMultiplier*fontSize+6;
+    }
+    for (int i = y0; i < (y1 - verticalSpacing); i += verticalSpacing)
+    {
+        currentY = i;
+        this->setCursor(currentX, currentY);
+    
+        int remainingLength = textLenght - offset;
+        int lineLength = (remainingLength < currentLineLenght) ? remainingLength : currentLineLenght;
+    
+        // Temporary buffer to hold potential line
+        char* buffer = (char*)malloc((lineLength + 1) * sizeof(char));
+        memcpy(buffer, text + offset, lineLength);
+        buffer[lineLength] = '\0';
+    
+        // Find the last space in buffer to wrap at word boundary
+        int lastSpaceIndex = -1;
+        for (int j = 0; j < lineLength; ++j) {
+            if (buffer[j] == ' ') lastSpaceIndex = j;
+        }
+    
+        // If a word gets cut, wrap to the next line
+        if ((offset + lineLength < textLenght) && (text[offset + lineLength] != ' ') && (lastSpaceIndex != -1) && ((i + verticalSpacing) < (y1 - verticalSpacing))) {
+            lineLength = lastSpaceIndex + 1; // Include the space
+        }
+    
+        // Allocate space for actual line with null-terminator
+        char* textPart = (char*)malloc((currentLineLenght + 1) * sizeof(char));
+        memset(textPart, ' ', currentLineLenght); // Fill with spaces
+        memcpy(textPart, text + offset, lineLength); // Copy valid part
+        textPart[currentLineLenght] = '\0';
+    
+        // Ellipsis on final visible line
+        if ((i + verticalSpacing) >= (y1 - verticalSpacing) && (offset + lineLength < textLenght)) {
+
+
+            textPart[currentLineLenght - 1] = '.';
+            textPart[currentLineLenght - 2] = '.';
+            textPart[currentLineLenght - 3] = '.';
+        }
+    
+        this->print(textPart);
+    
+        offset += lineLength;
+        free(buffer);
+        free(textPart);
+    
+        if (offset >= textLenght) return;
+    }
+    
+
+}

src/include/Graphics.h

@@ -55,6 +55,7 @@ class Graphics : public Shapes, public Image
     uint8_t getRotation();
 
     void drawPixel(int16_t x, int16_t y, uint16_t color) override;
+    void drawTextBox(int16_t x0,int16_t y0,int16_t x1,int16_t x2, const char* text,uint16_t textSize=1, const GFXfont *font=NULL, uint16_t vericalSpacing=NULL,  bool showBorder=false, uint16_t fontSize=8 );
 
 #if !defined(ARDUINO_INKPLATECOLOR) && !defined(ARDUINO_INKPLATE2) && !defined(ARDUINO_INKPLATE4) &&                   \
     !defined(ARDUINO_INKPLATE7)
@@ -99,6 +100,7 @@ class Graphics : public Shapes, public Image
     void writeLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint16_t color) override;
     void endWrite(void) override;
 
+
     uint8_t _displayMode = 0;
 
   protected: