Reference

You generally won't need to call this 'manually;' the initialization is automatically done when the GAMBY object is created.

• gamby.init();

When printing numbers, GAMBY's print() and println() use the same arguments as the Arduino's standard Serial.print().

When used in GambyBlockMode or GambyGraphicsMode, the various print() and println() functions have some limitations:

• Text is drawn directly to the LCD, bypassing the offscreen buffer. This means that any update() of the screen where text is drawn will erase the text.
• Text printed to the display will overwrite anything underneath it.
• You should typically call setPos() before printing text. If you don't, the text may appear someplace unexpected.
• Vertical placement of text is limited to the same 8 lines as GambyTextMode. 

• gamby.print(s);
• gamby.print(n);
• gamby.print(n, base);
• gamby.print(f);
• gamby.print(f, digits);

• s: the string to draw. (char *)
• n: a non-decimal number to draw (int, long, unsigned int, unsigned long, or byte)
• base: the number system to use when printing (constants BIN, OCT, DEC, or HEX). The default is DEC.
  
• f: a decimal number to draw (float or double)
• digits: the number of decimal digits to print (byte). The default is 2.
  

See print() for more information.

• gamby.print_P(s);

• s: the PROGMEM address (e.g. the name of the variable) of the string to draw. (const char *)

When printing numbers, GAMBY's print() and println() uses the same arguments as the Arduino's standard Serial.print().

To save a little memory, instead of using both println() and print(), consider using only print() and 'manually' end your strings with a 'newline' character ('\n').

See print() for more information.

• gamby.println(s);
• gamby.println(n);
• gamby.println(n, base);
• gamby.println(f);
• gamby.println(f, digits);

• s: the string to draw. (char *)
• n: a non-decimal number to draw (int, long, unsigned int, unsigned long, or unsigned char)
• base: the number system to use when printing (constants BIN, OCT, DEC, or HEX). The default is DEC.
  
• f: a decimal number to draw (float or double)
• digits: the number of decimal digits to print (byte). The default is 2.

To save a little memory, instead of using both println_P() and print_P(), consider using only print_P() and 'manually' end your strings with a 'newline' character ('\n').

See print() for more information.

• gamby.println_P(s);

• s: the PROGMEM address of the string to draw. (const char *)

• gamby.readInputs();

This has no real effect when using drawing methods specific to GambyBlockMode or GambyGraphicsMode  (setBlock(), box(), line(), etc.), and calling any of those after setPos() will change the position from the one you specified. In these modes, use setPos() immediately before GambyTextMode methods like drawIcon().

• gamby.setPos(col, line);

• col: The column (0 to 95) (byte)
• line: The vertical 8 pixel 'page' (0 to 7) (byte)

textDraw is a byte that controls the 'styling' of the text. It is typically used with the following predefined constants:

• TEXT_NORMAL: Regular text, dark on light.
  
• TEXT_INVERSE: Light text on a dark background.
  
• TEXT_UNDERLINE: Dark on light with an underline. Pixels in the letters will invert where they touch the line.
  
• TEXT_STRIKETHRU: Dark on light with a line through the center. Pixels in the letters will invert where they touch the line.
  

// GambyTextMode example. It's assumed that 'font' is defined in another tab
// (as in the Gamby/examples/_Templates/TextModeTemplate sketch).
#include <Gamby.h>

GambyTextMode gamby;
extern const long font[];

void setup() {
  gamby.font = font;
  gamby.println("This is normal.");
  gamby.textDraw = TEXT_INVERSE;
  gamby.println("This is inverse.");
  gamby.textDraw = TEXT_UNDERLINE;
  gamby.println("This is underlined.");

  // The textDraw is actually bits XORed over the text, so you could even 
  // do something like this:
  gamby.textDraw = B01010101;
  gamby.println("This has lines through it and is probably unreadable.");
}

void loop() {
}