/elec/propeller-clock : contents of src/text

: (revision 59)

To get this branch, use:

bzr branch
http://bzr.ed.am/elec/propeller-clock

/*
 * text_renderer.h
 *
 * Copyright (C) 2011 Tim Marston <tim@ed.am> and Dan Marston.
 *
 * This file is part of propeller-clock (hereafter referred to as "this
 * program"). See http://ed.am/dev/software/arduino/propeller-clock for more
 * information.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published
 * by the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
#ifndef _TEXT_RENDERER_H_
#define _TEXT_RENDERER_H_


#include <PString.h>


#define MAX_MESSAGE_LENGTH 64


class TextRenderer
{
public:

	/**
	 * Get singleton instance of text renderer.
	 *
	 * @return singleton instance
	 */
	static TextRenderer &get_instance();

	/**
	 * Retrieve the PString that is used to render text with the intention of
	 * changing it. This resets the text services.
	 *
	 * @param message the message
	 */
	PString &get_pstring();

	/**
	 * Call at the start of each frame.
	 */
	void draw_reset();

	/**
	 * Draw segment using automatic scrolling.
	 */
	void draw_scroll( int segment );

protected:

	TextRenderer();

	/**
	 * Transform segment in to display-space.
	 *
	 * @param segment
	 * @return display-space segment
	 */
	int xform_segment( int segment );

	/**
	 * Draw the specified column of pixels from the message
	 *
	 * @param x pixel column to draw
	 */
	void render( int x );

	/**
	 * Get a pointer to the character data in the font for a given
	 * character.
	 *
	 * @param character to look-up
	 * @param glyph where to store the glyph data
	 */
	void get_glyph( char c, char *glyph );

	/** the buffer for the message */
	char _message_buffer[ MAX_MESSAGE_LENGTH ];

	/** the current message */
	PString _message;

	/** glyph */
	char _glyph_cache[ 8 ];

	/** the character the current glyph is for */
	char _glyph_cache_char;

	/** selected font */
	int _font;

	/** time last frame */
	unsigned long _last_millis;

	/** duration last frame (in case we can't calculate it this
	 * frame!) */
	unsigned long _duration;

	/** scroll position (in segments ) */
	signed long _scroll;

};


#endif //_TEXT_RENDERER_H_

59 by edam removed ulibc, fixed button, added text rendering	1	/*
	2	* text_renderer.h
	3	*
	4	* Copyright (C) 2011 Tim Marston <tim@ed.am> and Dan Marston.
	5	*
	6	* This file is part of propeller-clock (hereafter referred to as "this
	7	* program"). See http://ed.am/dev/software/arduino/propeller-clock for more
	8	* information.
	9	*
	10	* This program is free software: you can redistribute it and/or modify
	11	* it under the terms of the GNU Lesser General Public License as published
	12	* by the Free Software Foundation, either version 3 of the License, or
	13	* (at your option) any later version.
	14	*
	15	* This program is distributed in the hope that it will be useful,
	16	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	17	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	18	* GNU Lesser General Public License for more details.
	19	*
	20	* You should have received a copy of the GNU Lesser General Public License
	21	* along with this program. If not, see <http://www.gnu.org/licenses/>.
	22	*/
	23	#ifndef _TEXT_RENDERER_H_
	24	#define _TEXT_RENDERER_H_
	25
	26
	27	#include <PString.h>
	28
	29
	30	#define MAX_MESSAGE_LENGTH 64
	31
	32
	33	class TextRenderer
	34	{
	35	public:
	36
	37	/**
	38	* Get singleton instance of text renderer.
	39	*
	40	* @return singleton instance
	41	*/
	42	static TextRenderer &get_instance();
	43
	44	/**
	45	* Retrieve the PString that is used to render text with the intention of
	46	* changing it. This resets the text services.
	47	*
	48	* @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;
114
115	};
116
117
118	#endif //_TEXT_RENDERER_H_