Back to files

ABClock version 1.0

How to use the library abclib

Include the abclib header:

#include "abclib.h"

To create the clock, call this function:

void ABC_Make (int hour, int min, int sec, int width, int height, int border)

ABC_Make will clear the area before making the clock

        If (border < 0) then a default border margin will be used
            appropriate for the size of the clock, otherwise, a fixed
            border margin will be used
    
        If (border < 0) then width and height should not be smaller
            than ABC_MINSIZE
    
        If (border >= 0) then width and height should not be smaller
            than ABC_MINSIZE + 2 * border

Your code should define the following two functions:

void ABC_SetColor (int color)

        ABC_SetColor should set the colour to be used in subsequent
            calls to ABC_Rect
        The color argument is one of:
            0 - background colour
            1 - inside colour of square
            2 - square border colour
            3 - hour colour
            4 - minute colour
        As defaults, you should use standard background colour for
            (color < 2), and standard foreground colour otherwise

void ABC_Rect (int x1, int y1, int x2, int y2)

        ABC_Rect should fill the rectangle from lower left (x1, y1) to
            upper right (x2, y2) inclusive, in the colour set by
            ABC_SetColor.
        If (x1 > x2 || y1 > y2) the function should do nothing.

---

Peter Kleiweg
http://www.let.rug.nl/~kleiweg/