/elec/propeller-clock

To get this branch, use:
bzr branch http://bzr.ed.am/elec/propeller-clock

« back to all changes in this revision

Viewing changes to src/text_renderer.h

  • Committer: Tim Marston
  • Date: 2012-05-18 18:29:50 UTC
  • Revision ID: tim@ed.am-20120518182950-t85bn9a21n72uzm8
text messages are now individually enabled and draw()n automatically

Show diffs side-by-side

added added

removed removed

Lines of Context:
27
27
#include <PString.h>
28
28
 
29
29
 
30
 
#define MAX_MESSAGE_LENGTH 64
31
 
 
32
 
 
33
 
class TextRenderer
 
30
#define MESSAGE_BUFFER_LEN 32
 
31
 
 
32
 
 
33
namespace TextRenderer
34
34
{
35
 
public:
36
 
 
37
 
        /**
38
 
         * Get singleton instance of text renderer.
 
35
 
 
36
        /**
 
37
         * Initialise.
 
38
         */
 
39
        void init();
 
40
 
 
41
        /**
 
42
         * Get the width, in pexels, of a message.
39
43
         *
40
 
         * @return singleton instance
 
44
         * @param message_len the length of the message
 
45
         * @param scale taxt scaling factor
41
46
         */
42
 
        static TextRenderer &get_instance();
 
47
        int get_width( int message_len, int scale );
43
48
 
44
49
        /**
45
 
         * Retrieve the PString that is used to render text with the intention of
46
 
         * changing it. This resets the text services.
 
50
         * Draw a column of pixels at pixel-offset x in the message.
47
51
         *
48
52
         * @param message the message
49
 
         */
50
 
        PString &get_pstring();
51
 
 
52
 
        /**
53
 
         * Call at the start of each frame.
54
 
         */
55
 
        void draw_reset();
56
 
 
57
 
        /**
58
 
         * Draw segment using automatic scrolling.
59
 
         */
60
 
        void draw_scroll( int segment );
61
 
 
62
 
protected:
63
 
 
64
 
        TextRenderer();
65
 
 
66
 
        /**
67
 
         * Transform segment in to display-space.
68
 
         *
69
 
         * @param segment
70
 
         * @return display-space segment
71
 
         */
72
 
        int xform_segment( int segment );
73
 
 
74
 
        /**
75
 
         * Draw the specified column of pixels from the message
76
 
         *
77
 
         * @param x pixel column to draw
78
 
         */
79
 
        void render( int x );
80
 
 
81
 
        /**
82
 
         * Get a pointer to the character data in the font for a given
83
 
         * character.
84
 
         *
85
 
         * @param character to look-up
86
 
         * @param glyph where to store the glyph data
87
 
         */
88
 
        void get_glyph( char c, char *glyph );
89
 
 
90
 
        /** the buffer for the message */
91
 
        char _message_buffer[ MAX_MESSAGE_LENGTH ];
92
 
 
93
 
        /** the current message */
94
 
        PString _message;
95
 
 
96
 
        /** glyph */
97
 
        char _glyph_cache[ 8 ];
98
 
 
99
 
        /** the character the current glyph is for */
100
 
        char _glyph_cache_char;
101
 
 
102
 
        /** selected font */
103
 
        int _font;
104
 
 
105
 
        /** time last frame */
106
 
        unsigned long _last_millis;
107
 
 
108
 
        /** duration last frame (in case we can't calculate it this
109
 
         * frame!) */
110
 
        unsigned long _duration;
111
 
 
112
 
        /** scroll position (in segments ) */
113
 
        signed long _scroll;
 
53
         * @param message_len the length of the message (to save it being
 
54
         *              calculated)
 
55
         * @param x the pixel column of the message to draw
 
56
         * @param y_flip true to draw up-side down
 
57
         * @param y_shift shift the drawing up/down
 
58
         * @param scale taxt scaling factor
 
59
         */
 
60
        void render( const char *message, int message_len, int x,
 
61
                                 bool y_flip, int y_shift, int scale );
 
62
 
 
63
        /**
 
64
         * Reset the output buffer.
 
65
         */
 
66
        void reset_buffer();
 
67
 
 
68
 
 
69
        /**
 
70
         * Notify renderer that the output buffer will require rendering.
 
71
         */
 
72
        void buffer_in_use();
 
73
 
 
74
 
 
75
        /**
 
76
         * Output the output buffer (and reset the output buffer).
 
77
         */
 
78
        void output_buffer();
 
79
 
 
80
        /**
 
81
         * Get the font number in use.
 
82
         *
 
83
         * @return font number
 
84
         */
 
85
        int get_font();
 
86
 
 
87
        /**
 
88
         * Switch to the next font.
 
89
         */
 
90
        void inc_font();
114
91
 
115
92
};
116
93