Inkplate 6COLOR – Printing Text

Printing text on Inkplate is simple and requires only a few functions. The library also supports custom fonts.

ℹ️

For complete examples of text printing, most Arduino projects in the library include some form of text output.

---

Simple Text Printing

To print text, use setCursor followed by print. If you're using the default font, you may want to use setTextSize to increase the font size:

// Declare Inkplate object
Inkplate inkplate;

void setup()
{
    inkplate.begin();
    inkplate.clearDisplay();
    inkplate.setCursor(0,100);
    inkplate.setTextSize(4);
    inkplate.setTextColor(INKPLATE_RED);
    inkplate.print("Hi inkplate (in size 4)!");
    inkplate.setCursor(0,150);
    inkplate.setTextSize(3);
    inkplate.setTextColor(INKPLATE_YELLOW);
    inkplate.print("Hi inkplate (in size 3)!");
    inkplate.setCursor(0,200);
    inkplate.setTextSize(2);
    inkplate.setTextColor(INKPLATE_ORANGE);
    inkplate.print("Hi inkplate (in size 2)!");
    inkplate.setCursor(0,250);
    inkplate.setTextSize(1);
    inkplate.setTextColor(INKPLATE_BLACK);
    inkplate.print("Hi inkplate (in size 1)!");
    inkplate.display();
}

void loop()
{}

Expected output on Inkplate display.

inkplate.setTextSize()

Increases the text size by a given factor.

Returns value: None

Function parameters:

Type	Name	Description
uint8_t	s	Size factor. 1 is default size, 2 is twice as large, 3 is three times larger, etc.

inkplate.print()

Prints text at the previously set cursor position. This is the standard Arduino print function used in many native Arduino objects and libraries.

Returns value: size_t, number of bytes printed.

Function parameters:

Type	Name	Description
const char *	_c	The C-style string to print on the display.

inkplate.setTextColor()

Sets the color of the text. Must be called before printing.

Returns value: None

Function parameters:

Type	Name	Description
uint16_t	c	Text color.
uint16_t	bg	Optional background color. Default is transparent.

---

Custom Fonts

The default font appears blocky as it is optimized for minimal memory usage. You can use custom fonts by downloading them from the Adafruit GFX official repository. Adafruit provides well-documented examples on using custom fonts here.

After downloading a font, place it in your sketch folder, include it, and use setFont:

#include "Inkplate.h"
#include "FreeMono9pt7b.h"

Inkplate inkplate;

void setup() {
  inkplate.begin();
  inkplate.clearDisplay();
  inkplate.display();
  inkplate.setFont(&FreeMono9pt7b);
  inkplate.setCursor(100,100);
  inkplate.setTextColor(BLACK);
  inkplate.setTextSize(3);
  inkplate.print("Hello World!");
  inkplate.display();
}

void loop() {
}

Expected output on Inkplate display.

inkplate.setFont()

Sets a custom font for text printing. Must be called before printing.

Returns type: None

Function parameters:

Type	Name	Description
const GFXfont *	f	Pointer to the GFXfont structure of the font to be set.

---

TextBox

You can manually define the area in which text will appear by using the drawTextBox() function.

#include "Inkplate.h"            // Include the Inkplate library in the sketch
#include "FreeMono24pt7b.h"

// Create an Inkplate object and set the library to 1 Bit mode (BW)
Inkplate inkplate;

const char* text = "This is an example of a text written in a textbox. When a word doesn't fit into the current row, it goes to the next one." \
" If the text reaches the lower bound, it ends with three dots (...) to mark that the text isn't displayed fully";

void setup()
{
    inkplate.begin();        // Initialize Inkplate library (you should call this function ONLY ONCE)
    inkplate.clearDisplay(); // Clear the display's frame buffer
    inkplate.display();      // Put a clear image on the display
    inkplate.setTextColor(INKPLATE_BLACK);

    // Create a text box without any optional parameters
    // x0 - x coordinate of the upper left corner
    // y0 - y coordinate of the upper left corner
    // x1 - x coordinate of the bottom right corner
    // y1 - y coordinate of the bottom right corner
    // text - text we want to display
    inkplate.drawTextBox(50,100,250,300,text);

    // Create a text box with all parameters
    // x0 - x coordinate of the upper left corner
    // y0 - y coordinate of the upper left corner
    // x1 - x coordinate of the bottom right corner
    // y1 - y coordinate of the bottom right corner
    // text - text we want to display
    // textSizeMultiplier - factor by which we want to enlarge the font size
    // font - address of the selected custom font
    // verticalSpacing - number of pixels between each row of text
    // showBorder - create a visible rectangle around the box
    // fontSize - size of the used font in pt
    int offset = 32; // Note: some custom fonts are drawn from bottom-to-top, which requires an offset. Use an offset that best suits the font you use.
    inkplate.drawTextBox(300,100 + offset,488,300,text,1,&FreeMono24pt7b,27,false,24);

    // Display both text boxes
    inkplate.display();
}

void loop()
{
    // Nothing...
}

Expected output on Inkplate display.

inkplate.drawTextBox()

This function creates a TextBox.

Returns type: void

Function parameters:

Type	Name	Description
uint16_t	x0	X coordinate of the upper left corner.
uint16_t	y0	Y coordinate of the upper left corner.
uint16_t	x1	X coordinate of the bottom right corner.
uint16_t	y1	Y coordinate of the bottom right corner.
const char*	text	Text we want to display.
uint16_t	textSize	Factor by which we want to enlarge the font size.
const GFXfont*	font	Address of the selected custom font.
uint16_t	verticalSpacing	Number of pixels between each row of text.
bool	showBorder	Create a visible rectangle around the box.
uint16_t	fontSize	Size of the used font in pt.