TINF_Test_230418

Dependencies:   mbed

Committer:
Wizo
Date:
Thu Nov 15 18:10:38 2018 +0000
Revision:
0:fbb75c0396c7
TINF_Test_230418

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Wizo 0:fbb75c0396c7 1 /* mbed TextDisplay Library Base Class
Wizo 0:fbb75c0396c7 2 * Copyright (c) 2007-2009 sford
Wizo 0:fbb75c0396c7 3 * Released under the MIT License: http://mbed.org/license/mit
Wizo 0:fbb75c0396c7 4 *
Wizo 0:fbb75c0396c7 5 * A common base class for Text displays
Wizo 0:fbb75c0396c7 6 * To port a new display, derive from this class and implement
Wizo 0:fbb75c0396c7 7 * the constructor (setup the display), character (put a character
Wizo 0:fbb75c0396c7 8 * at a location), rows and columns (number of rows/cols) functions.
Wizo 0:fbb75c0396c7 9 * Everything else (locate, printf, putc, cls) will come for free
Wizo 0:fbb75c0396c7 10 *
Wizo 0:fbb75c0396c7 11 * The model is the display will wrap at the right and bottom, so you can
Wizo 0:fbb75c0396c7 12 * keep writing and will always get valid characters. The location is
Wizo 0:fbb75c0396c7 13 * maintained internally to the class to make this easy
Wizo 0:fbb75c0396c7 14 */
Wizo 0:fbb75c0396c7 15
Wizo 0:fbb75c0396c7 16 #ifndef MBED_TEXTDISPLAY_H
Wizo 0:fbb75c0396c7 17 #define MBED_TEXTDISPLAY_H
Wizo 0:fbb75c0396c7 18
Wizo 0:fbb75c0396c7 19 #include "mbed.h"
Wizo 0:fbb75c0396c7 20
Wizo 0:fbb75c0396c7 21 class TextDisplay : public Stream {
Wizo 0:fbb75c0396c7 22 public:
Wizo 0:fbb75c0396c7 23
Wizo 0:fbb75c0396c7 24 // functions needing implementation in derived implementation class
Wizo 0:fbb75c0396c7 25 /** Create a TextDisplay interface
Wizo 0:fbb75c0396c7 26 *
Wizo 0:fbb75c0396c7 27 * @param name The name used in the path to access the strean through the filesystem
Wizo 0:fbb75c0396c7 28 */
Wizo 0:fbb75c0396c7 29 TextDisplay(const char *name = NULL);
Wizo 0:fbb75c0396c7 30
Wizo 0:fbb75c0396c7 31 /** output a character at the given position
Wizo 0:fbb75c0396c7 32 *
Wizo 0:fbb75c0396c7 33 * @param column column where charater must be written
Wizo 0:fbb75c0396c7 34 * @param row where character must be written
Wizo 0:fbb75c0396c7 35 * @param c the character to be written to the TextDisplay
Wizo 0:fbb75c0396c7 36 */
Wizo 0:fbb75c0396c7 37 virtual void character(int column, int row, int c) = 0;
Wizo 0:fbb75c0396c7 38
Wizo 0:fbb75c0396c7 39 /** return number if rows on TextDisplay
Wizo 0:fbb75c0396c7 40 * @result number of rows
Wizo 0:fbb75c0396c7 41 */
Wizo 0:fbb75c0396c7 42 virtual int rows() = 0;
Wizo 0:fbb75c0396c7 43
Wizo 0:fbb75c0396c7 44 /** return number if columns on TextDisplay
Wizo 0:fbb75c0396c7 45 * @result number of rows
Wizo 0:fbb75c0396c7 46 */
Wizo 0:fbb75c0396c7 47 virtual int columns() = 0;
Wizo 0:fbb75c0396c7 48
Wizo 0:fbb75c0396c7 49 // functions that come for free, but can be overwritten
Wizo 0:fbb75c0396c7 50
Wizo 0:fbb75c0396c7 51 /** redirect output from a stream (stoud, sterr) to display
Wizo 0:fbb75c0396c7 52 * @param stream stream that shall be redirected to the TextDisplay
Wizo 0:fbb75c0396c7 53 */
Wizo 0:fbb75c0396c7 54 virtual bool claim (FILE *stream);
Wizo 0:fbb75c0396c7 55
Wizo 0:fbb75c0396c7 56 /** clear screen
Wizo 0:fbb75c0396c7 57 */
Wizo 0:fbb75c0396c7 58 virtual void cls();
Wizo 0:fbb75c0396c7 59 virtual void locate(int column, int row);
Wizo 0:fbb75c0396c7 60 virtual void foreground(uint16_t colour);
Wizo 0:fbb75c0396c7 61 virtual void background(uint16_t colour);
Wizo 0:fbb75c0396c7 62 // putc (from Stream)
Wizo 0:fbb75c0396c7 63 // printf (from Stream)
Wizo 0:fbb75c0396c7 64
Wizo 0:fbb75c0396c7 65 protected:
Wizo 0:fbb75c0396c7 66
Wizo 0:fbb75c0396c7 67 virtual int _putc(int value);
Wizo 0:fbb75c0396c7 68 virtual int _getc();
Wizo 0:fbb75c0396c7 69
Wizo 0:fbb75c0396c7 70 // character location
Wizo 0:fbb75c0396c7 71 uint16_t _column;
Wizo 0:fbb75c0396c7 72 uint16_t _row;
Wizo 0:fbb75c0396c7 73
Wizo 0:fbb75c0396c7 74 // colours
Wizo 0:fbb75c0396c7 75 uint16_t _foreground;
Wizo 0:fbb75c0396c7 76 uint16_t _background;
Wizo 0:fbb75c0396c7 77 char *_path;
Wizo 0:fbb75c0396c7 78 };
Wizo 0:fbb75c0396c7 79
Wizo 0:fbb75c0396c7 80 #endif