Spi Display String 6X8 Xy - Elatec TWN4 MultiTech Nano Technical Handbook

3. Using Peripherals

3.5.3. SPI Display String 6x8 XY

This method prints a string of ASCII characters. Display of ASCII characters is made possible through a
symbol look-up table. Every character is represented by a 6x8 matrix of pixel data; the matrix incorporates
1-pixel separation between characters. Given that resolution of the Display is 102x64 pixels, a 17x8 char-
acter array is supported.
bool SPIDisplayString6x8XY
(
byte x,
byte y,
char text[ ],
byte len,
bool bg_color
);
Parameters:
byte x
byte y
char text[ ]
byte len
bool bg_color
Return:
Important: This method does not support newline characters nor row overflows. Care should be
taken to ensure the text printed does not go over screen boundaries. The maximum width
of Display is 17 characters. The User needs to verify the start position (X) and length of
text printed (len).
Column Position (X) of character, not pixel. (0 <= x <= 17-len)
Row Position (Y) of character, not pixel. (0 <= y <= 7)
Text string to print in ASCII format.
Number of characters from "text" to print, counting from index 0. This is
intentionally provided in case the User does not wish to print the entire "text"
string. (1 <= len <= 17)
Background Color chosen for Display (0:clear, 1:black). Usually matches
the argument given to "SPI Display Clear" command.
If the operation was successful, the return value is true , otherwise it is
false .
Page 9 of 13