Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Branch: master
Fetching contributors…

Cannot retrieve contributors at this time

executable file 673 lines (587 sloc) 19.336 kB
/*
glcd.cpp - Arduino library support for graphic LCDs
Copyright (c) 2008,2009,2010 Michael Margolis and Bill Perry
vi:ts=4
This file is part of the Arduino GLCD library.
GLCD 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 2.1 of the License, or
(at your option) any later version.
GLCD 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 GLCD. If not, see <http://www.gnu.org/licenses/>.
This file contains high level functions based on the previous ks0108 library.
The functions were inspired from code written and copyright by Fabian Maximilian Thiele.
you can obtain a copy of his original work here:
http://www.scienceprog.com/wp-content/uploads/2007/07/glcd_ks0108.zip
The glcd class impliments high level graphics routines.
It is derived from the glcd_Device class that impliments the protocol for sending and
receiving data and commands to a GLCD device
*/
#include <avr/pgmspace.h>
#include "glcd.h"
#include "glcd_Config.h"
#define BITMAP_FIX // enables a bitmap rendering fix/patch
glcd::glcd(){
glcd_Device::Inverted = NON_INVERTED;
}
/**
* Initilize the GLCD library and hardware
*
* @param invert specifices whether display is in normal mode or inverted mode.
*
* This should be called prior to any other graphic library function.
* It does all the needed initializations including taking care of the
* low level hardware initalization of the display device.
*
* The optional @em invert parameter specifies if the display should be run in a normal
* mode, dark pixels on light background or inverted, light pixels on a dark background.
*
* To specify dark pixels use the define @b NON-INVERTED and to use light pixels use
* the define @b INVERTED
*
* Upon completion of the initialization, then entire display will be cleared.
* @note
* This function can also be called to re-initliaze the display hardware.
*/
void glcd::Init(uint8_t invert){
glcd_Device::Init(invert);
}
/**
* Clear the lcd display
*
* @param color BLACK or WHITE
*
* Sets all the pixels on the display from 0,0 to GLCD.Width-1,GLCD.Height-1
* to the specified color.
*
* Color is optional and defaults to WHITE.
*
* @note
* If the display is in INVERTED mode, then the color WHITE will paint the screen
* BLACK and the color BLACK will paint the screen WHITE.
*
*
*/
void glcd::ClearScreen(uint8_t color){
this->SetPixels(0,0,GLCD.Width-1,GLCD.Height-1, color);
}
/*
* Drawline code is based on Bresenham's line algorithm
* http://en.wikipedia.org/wiki/Bresenham%27s_line_algorithm
*
* This routine replaces the Teiele's DrawLine() routine which was
* much larger and much slower.
* -- bperrybap
*/
/*
* First, define a few macros to make the DrawLine code below read more like
* the wikipedia example code.
*/
#define _GLCD_absDiff(x,y) ((x>y) ? (x-y) : (y-x))
#define _GLCD_swap(a,b) \
do\
{\
uint8_t t;\
t=a;\
a=b;\
b=t;\
} while(0)
/**
* Draw a line
*
* @param x1 a value from 0 to GLCD.Width-1 indicating start x coordinate
* @param y1 a value fron 0 to GLCD.Height-1 indicating start y coordinate
* @param x2 a value from 0 to GLCD.Width-1 indicating end x coordinate
* @param y2 a value fron 0 to GLCD.Height-1 indicating end y coordinate
* @param color BLACK or WHITE
*
* Draws a line starting at x1,y2 and ending at x2,y2.
*
* Color is optional and defaults to BLACK.
*
* @see DrawHLine()
* @see DrawVLine()
*
*/
void glcd::DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, uint8_t color)
{
uint8_t deltax, deltay, x,y, steep;
int8_t error, ystep;
#ifdef XXX
/*
* Rather than fudge up coordinates that are outside of range,
* It is better to allow the algorithm to run with them "as is"
* so that any pixels on the line that land inside the valid display
* coordinates will be drawn properly.
*
* If the coordinates are patched, then the line drawn will not
* be anything close to the original slope as the endpoint coordinates
* will have been altered.
*/
if(x1>=DISPLAY_WIDTH) x1=0;
if(x2>=DISPLAY_WIDTH) x2=0;
if(y1>=DISPLAY_HEIGHT) y1=0;
if(y2>=DISPLAY_HEIGHT) y2=0;
#endif
steep = _GLCD_absDiff(y1,y2) > _GLCD_absDiff(x1,x2);
if ( steep )
{
_GLCD_swap(x1, y1);
_GLCD_swap(x2, y2);
}
if (x1 > x2)
{
_GLCD_swap(x1, x2);
_GLCD_swap(y1, y2);
}
deltax = x2 - x1;
deltay =_GLCD_absDiff(y2,y1);
error = deltax / 2;
y = y1;
if(y1 < y2) ystep = 1; else ystep = -1;
for(x = x1; x <= x2; x++)
{
if (steep) this->SetDot(y,x, color); else this->SetDot(x,y, color);
error = error - deltay;
if (error < 0)
{
y = y + ystep;
error = error + deltax;
}
}
}
/**
* Draw a rectangle of given width and height
*
* @param x the x coordinate of the upper left corner of the rectangle
* @param y the y coordinate of the upper left corner of the rectangle
* @param width width of the rectangle
* @param height height of the rectangle
* @param color BLACK or WHITE
*
* Draws a rectangle with the specified width and height.
* The upper left corner at x,y and the lower right
* corner at x+width,y+width.
*
* The length of the horizontal sides will be width+1 pixels
* The length of the vertical sides will be height+1 pixels
*
* Color is optional and defaults to BLACK.
*
* @note The width and height parameters work differently than FillRect()
*
* @see FillRect()
* @see InvertRect()
* @see DrawRoundRect()
*/
void glcd::DrawRect(uint8_t x, uint8_t y, uint8_t width, uint8_t height, uint8_t color) {
DrawHLine(x, y, width, color); // top
DrawHLine(x, y+height, width, color); // bottom
DrawVLine(x, y, height, color); // left
DrawVLine(x+width, y, height, color); // right
}
/**
* Draw a rectangle with rounder corners
*
* @param x the x coordinate of the upper left corner of the rectangle
* @param y the y coordinate of the upper left corner of the rectangle
* @param width width of the rectangle
* @param height height of the rectangle
* @param radius ????
* @param color BLACK or WHITE
*
* Draws a rectangle the same as DrawRect() but with rounded corners.
* Radius is a value from 1 to half the height or width of the rectangle.
* (what does that really mean?????)
* Which is it, or is it a the smaller of the two?
* FIXME FIXME need more description here.
*
* @see DrawRect()
*/
void glcd::DrawRoundRect(uint8_t x, uint8_t y, uint8_t width, uint8_t height, uint8_t radius, uint8_t color) {
int16_t tSwitch;
uint8_t x1 = 0, y1 = radius;
tSwitch = 3 - 2 * radius;
while (x1 <= y1) {
this->SetDot(x+radius - x1, y+radius - y1, color);
this->SetDot(x+radius - y1, y+radius - x1, color);
this->SetDot(x+width-radius + x1, y+radius - y1, color);
this->SetDot(x+width-radius + y1, y+radius - x1, color);
this->SetDot(x+width-radius + x1, y+height-radius + y1, color);
this->SetDot(x+width-radius + y1, y+height-radius + x1, color);
this->SetDot(x+radius - x1, y+height-radius + y1, color);
this->SetDot(x+radius - y1, y+height-radius + x1, color);
if (tSwitch < 0) {
tSwitch += (4 * x1 + 6);
} else {
tSwitch += (4 * (x1 - y1) + 10);
y1--;
}
x1++;
}
this->DrawHLine(x+radius, y, width-(2*radius), color); // top
this->DrawHLine(x+radius, y+height, width-(2*radius), color); // bottom
this->DrawVLine(x, y+radius, height-(2*radius), color); // left
this->DrawVLine(x+width, y+radius, height-(2*radius), color); // right
}
/**
* Fill a Rectangle
*
* @param x the x coordinate of the upper left corner of the rectangle
* @param y the y coordinate of the upper left corner of the rectangle
* @param width width of the rectangle
* @param height height of the rectangle
* @param color BLACK or WHITE
*
* Fills a rectanglular area of the specified width and height.
*
* The resulting rectangle covers an area @em width pixels wide by @em height pixels
* tall starting from the pixel at x,y.
*
* The upper left corner at x,y and the lower right corner at x+width-1,y+width-1.
*
*
* The length of the horizontal sides will be width pixels
* The length of the vertical sides will be height pixels
*
* Color is optional and defaults to BLACK.
*
* @note The width and height parameters work differently than DrawRect()
*
*
* @warning FillRect() behavior has changed from the previous versions of the ks0108 library.
* The filled rectangle will be one pixel smaller in width and height than the old version.
* This change was to make the functionality consistent with the way
* Java and C# create filled rectangles
*
* @see DrawRect()
* @see InvertRect()
*/
void glcd::FillRect(uint8_t x, uint8_t y, uint8_t width, uint8_t height, uint8_t color) {
this->SetPixels(x,y,x+width,y+height,color);
}
/**
* Invert a Rectangular area
*
* @param x the x coordinate of the upper left corner of the rectangle
* @param y the y coordinate of the upper left corner of the rectangle
* @param width width of the rectangle
* @param height height of the rectangle
*
* Inverts the pixels in the rectanglular area of the specified width and height.
* BLACK pixels becom WHITE and WHITE pixels become BLACK.
*
* See FillRect() for full the full details of the rectangular area.
*
* @note The width and height parameters work differently than DrawRect()
*
* @warning InvertRect() behavior has changed from the previous versions of the ks0108 library.
* The inverted rectangle will be one pixel smaller in width and height than the old version.
*
* @see DrawRect()
* @see FillRect()
*/
void glcd::InvertRect(uint8_t x, uint8_t y, uint8_t width, uint8_t height) {
uint8_t mask, pageOffset, h, i, data, tmpData;
height++;
pageOffset = y%8;
y -= pageOffset;
mask = 0xFF;
if(height < 8-pageOffset) {
mask >>= (8-height);
h = height;
} else {
h = 8-pageOffset;
}
mask <<= pageOffset;
/*
* First do the fractional pages at the top of the region
*/
glcd_Device::GotoXY(x, y);
for(i=0; i<=width; i++) {
data = this->ReadData();
tmpData = ~data;
data = (tmpData & mask) | (data & ~mask);
this->WriteData(data);
}
/*
* Now do the full pages
*/
while(h+8 <= height) {
h += 8;
y += 8;
glcd_Device::GotoXY(x, y);
for(i=0; i<=width; i++) {
data = this->ReadData();
this->WriteData(~data);
}
}
/*
* Now do the fractional pages aat the bottom of the region
*/
if(h < height) {
mask = ~(0xFF << (height-h));
glcd_Device::GotoXY(x, y+8);
for(i=0; i<=width; i++) {
data = this->ReadData();
tmpData = ~data;
data = (tmpData & mask) | (data & ~mask);
this->WriteData(data);
}
}
}
/**
* Set LCD Display mode
*
* @param invert Inverted mode
*
* Sets the graphical state mode for the entire LCD display
* to @b NON_INVERTED (BLACK colorerd pixeld are dark)
* or @b INVERTED (WHITE colored pixels are dark)
*
*/
void glcd::SetDisplayMode(uint8_t invert) { // was named SetInverted
if(this->Inverted != invert) {
this->InvertRect(0,0,DISPLAY_WIDTH-1,DISPLAY_HEIGHT-1);
this->Inverted = invert;
}
}
/**
* Set contrast of display
*
* @param contrast
*
*/
void glcd::SetContrast(uint8_t value){
glcd_Device::SetContrast(value);
}
/**
* Draw a bitmap image
*
* @param bitmap a ponter to the bitmap data
* @param x the x coordinate of the upper left corner of the bitmap
* @param y the y coordinate of the upper left corner of the bitmap
* @param color BLACK or WHITE
*
* Draws a bitmap image with the upper left corner at location x,y
* The bitmap data is assumed to be in program memory.
*
* Color is optional and defaults to BLACK.
*
*/
void glcd::DrawBitmap(Image_t bitmap, uint8_t x, uint8_t y, uint8_t color){
uint8_t width, height;
uint8_t i, j;
width = ReadPgmData(bitmap++);
height = ReadPgmData(bitmap++);
#ifdef BITMAP_FIX // temporary ifdef just to show what changes if a new
// bit rendering routine is written.
/*
* In the absence of a new/better/proper bitmap rendering routine,
* this routine will provide a temporary fix for drawing bitmaps that are
* are non multiples of 8 pixels in height and start on non LCD page Y addresses.
*
* Note: nomally a routine like this should not have knowledge of how
* how the lower level write routine works. But in this case it does.
*
* Currently, the low level WriteData() routine ORs in the pixels when data spans
* a LCD memory page. So.....
*
* In order to ensure that the bitmap data is written to the pixels *exactly* as it
* it defined in the bitmap data, i.e every black pixels is black and every white
* pixel is white,...
*
* If height or y coordinate is not on a page boundary, clear the background first
* Techincally, this could be done all the time and it wouldn't hurt, it
* would just suck up a few more cycles.
*/
if( (y & 7) || (height & 7))
{
this->FillRect(x, y, width, height, WHITE);
}
#endif
for(j = 0; j < height / 8; j++) {
glcd_Device::GotoXY(x, y + (j*8) );
for(i = 0; i < width; i++) {
uint8_t displayData = ReadPgmData(bitmap++);
if(color == BLACK)
this->WriteData(displayData);
else
this->WriteData(~displayData);
}
}
}
// the following inline functions were added 2 Dec 2009 to replace macros
/**
* Draw a Vertical Line
*
* @param x a value from 0 to GLCD.Width-1
* @param y a value from 0 to GLCD.Height-1
* @param height a value from 1 to GLCD.Height-y-1
* @param color color of line
*
* color of BLACK or WHITE is an optional parameter indicating pixel color, default is BLACK
*
* The line drawn will be height+1 pixels.
*
* @note This function was previously named DrawVertLine() in the ks0108 library
*
* @see DrawLine()
* @see DrawHLine()
*/
void glcd::DrawVLine(uint8_t x, uint8_t y, uint8_t height, uint8_t color){
// this->FillRect(x, y, 0, length, color);
this->SetPixels(x,y,x,y+height,color);
}
/**
* Draw a Horizontal Line
*
* @param x a value from 0 to GLCD.Width-1
* @param y a value from 0 to GLCD.Height-1
* @param width a value from 1 to GLCD.Width-x-1
* @param color BLACK or WHITE
*
* The line drawn will be width+1 pixels.
*
* color is an optional parameter indicating pixel color and defaults to BLACK
*
* @note This function was previously named DrawHoriLine() in the ks0108 library
*
* @see DrawLine()
* @see DrawVLine()
*/
void glcd::DrawHLine(uint8_t x, uint8_t y, uint8_t width, uint8_t color){
// this->FillRect(x, y, length, 0, color);
this->SetPixels(x,y, x+width, y, color);
}
/**
* Draw a Circle
*
* @param xCenter X coordinate of the center of the circle
* @param yCenter Y coordinate of the center of the circle
* @param radius radius of circle
* @param color BLACK or WHITE
*
* Draws a circle of the given radius extending out from
* the center pixel.
* The circle will fit inside a rectanglular area bounded by
* x-radius,y-radius and x+radius,y+radius
*
* Because the circle is drawn from the center pixel out,
* the diameter will be 2 * radius +1 pixels.
*
* Color is optional and defaults to BLACK.
*
* @see FillCircle()
*/
void glcd::DrawCircle(uint8_t xCenter, uint8_t yCenter, uint8_t radius, uint8_t color){
this->DrawRoundRect(xCenter-radius, yCenter-radius, 2*radius, 2*radius, radius, color);
}
/**
* Draw a Filled in a Circle
*
* @param xCenter X coordinate of the center of the circle
* @param yCenter Y coordinate of the center of the circle
* @param radius radius of circle
* @param color WHITE or BLACK
*
* Draws a filled in circle of the given radius extending out from
* the center pixel.
*
* See DrawCircle() for the full details on sizing.
*
* Color is optional and defaults to BLACK.
*
* @see DrawCircle()
*
*/
void glcd::FillCircle(uint8_t x0, uint8_t y0, uint8_t radius, uint8_t color)
{
/*
* Circle fill Code is merely a modification of the midpoint
* circle algorithem which is an adaption of Bresenham's line algorithm
* http://en.wikipedia.org/wiki/Midpoint_circle_algorithm
* http://en.wikipedia.org/wiki/Bresenham%27s_line_algorithm
*
* While it looks different it is the same calculation that is in
* DrawRoundRect()
*
* Note: FillCircle()
* could be modified to work like DrawCircle() by using
* a DrawRoundRect() function.
* DrawRoundRect() first plots the cicrular quadrants and then draws
* the horizontal and verticl lines between them to create
* a rounded rectangle.
*
* For fills of rounded rectangles, this type of circle fill algorithm
* would fill the upper and lower quadrants on each side of the rounded
* rectangle by connecting them vertically.
* When that was done, a filled rectangle would be neded need to fill the
* space between them.
* There really isn't an easy way to fill a rounded rectangle.
*
* For now, it is limited to circles.
*
* --- bperrybap
*/
int f = 1 - radius;
int ddF_x = 1;
int ddF_y = -2 * radius;
uint8_t x = 0;
uint8_t y = radius;
/*
* Fill in the center between the two halves
*/
DrawLine(x0, y0-radius, x0, y0+radius, color);
while(x < y)
{
// ddF_x == 2 * x + 1;
// ddF_y == -2 * y;
// f == x*x + y*y - radius*radius + 2*x - y + 1;
if(f >= 0)
{
y--;
ddF_y += 2;
f += ddF_y;
}
x++;
ddF_x += 2;
f += ddF_x;
/*
* Now draw vertical lines between the points on the circle rather than
* draw the points of the circle. This draws lines between the
* perimeter points on the upper and lower quadrants of the 2 halves of the circle.
*/
DrawLine(x0+x, y0+y, x0+x, y0-y, color);
DrawLine(x0-x, y0+y, x0-x, y0-y, color);
DrawLine(x0+y, y0+x, y+x0, y0-x, color);
DrawLine(x0-y, y0+x, x0-y, y0-x, color);
}
}
//
// Font Functions
//
uint8_t ReadPgmData(const uint8_t* ptr) { // note this is a static function
return pgm_read_byte(ptr);
}
/*
* Below here are text wrapper functions
*/
/// @cond hide_from_doxygen
size_t glcd::write(uint8_t c) // method needed for Print base class
{
gText::PutChar(c);
}
/// @endcond
// override GotoXY to call CursorToxy
void glcd::GotoXY(uint8_t x, uint8_t y)
{
glcd_Device::GotoXY(x, y);
CursorToXY(x,y);
}
// Make one instance for the user
glcd GLCD = glcd();
Jump to Line
Something went wrong with that request. Please try again.