/FlickerFreePrint

Library to intelligently repaint old text before drawing new--eliminates drawing drafillRect()

Primary LanguageC++

FlickerFreePrint Library

This library will let programmers paint data to TFT LCD's without first having to draw a fillRec to hide old text. This is because a red filled rectangle is first being drawn to erase the previous number. This is a very common approch for clearing old data with fonts that are porportional (character widths are NOT fixed). If using non-proportional fonts this library is not needed as the .setFontColor(ForeColor, BackColor) can be used to automatically clear non drawn areas. This library intelligently paints changed text in background color before painting new text.

WARNING
This library is intended to be used with a wide variety of MCU's. A special library (dtostrf.h) is needed for some MCU's and is delivered with certian MCU's that require it, but not all. If you get a compile error "no such file or directory: dtostrf.h", uncomment this line in FlickerFreePrint.h (around line 50 or so) so the compiler can include it. I have this commented out as few MCU's need it. // #include <avr/dtostrf.h>

General code usage

  1. #include the library
    #include <FlickerFreePrint.h>

  2. create a FlickerFreePaint object for each data to be drawn (put the , pass in your display object and set fore color and back color)
    FlickerFreePrint Data1(&YOUR DISPLAY OBJECT NAME, 0xFFFF, 0X0000);

  3. Print the data similar to the Print object except call print on the data object
    Data1.setTextColor(0xFFFF, 0X0000);
    float j = some data;
    Data1.print(j, 4);

    4. Tips on usage

    1. This library is template based so it should work with most display drivers provided the driver supports getCursorX() methods
    2. this linbrary will not paint correctly if a background gradient is used
    3. this library can work with int, float, char, and other data types
    4. this library has no capability to print DEX, HEX or Println() functions
    5. this libary was not tested with LCD (20x4 type)


    The image below can't show the reuslts in a static image, but in the "Crude Repaint" you will see 25 flicker during each redraw. The yellow text is drawn with FlickerFreePrint and wil not flicker. Same for the blue and green data. Note that the data types for the text is int, float and char. Have a watch

    https://youtu.be/uMqTAoCCCX8

    header image