Prosta biblioteka graficzna (primlib)

Biblioteka zawiera funkcje obudowujące podstawowe operacje z biblioteki SDL_gfx. Jej celem jest dostarczenie prostego sposobu na wykonywanie operacji graficznych osobom uczącym się języka C. Zakłada się, że po nabyciu biegłości w programowaniu w języku C programista będzie używał biblioteki SDL bezpośrednio. Biblioteka jest zawarta w pliku primlib.c. Każdy moduł programu używający biblioteki powinien dołączyć plik nagłówkowy primlib.h. Bibliotekę można pobrać tutaj. Jej użycie wymaga zainstalowania w systemie bibliotek SDL 1.2 i SDL_gfx

Układ współrzędnych

Początek układu współrzędnych znajduje się w lewym górnym rogu okna graficznego. Szerokość i wysokość okna graficznego można uzyskać za pomocą funkcji screenWidth() i screenHeight().

Rysowanie

Kompilacja

W celu skompilowania programu używającego biblioteki primlib należy użyć następującego polecenia:

gcc -D_REENTRANT progname.c primlib.c -o progname -lm -lSDL -lpthread -lSDL_gfx

gdzie progname.c jest nazwą głównego modułu programu.

Opis funkcji zawartych w bibliotece primlib

int initGraph();

Musi być wywołana przed jakąkolwiek operacją graficzną. Zwraca 0 w przypadku sukcesu, wartość niezerową w przypadku błędu.

enum color {BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, WHITE, COLOR_MAX};

Typ wyliczeniowy, reprezentujący dostępne kolory.

void pixel(int x, int y, enum color c);

Umieszcza piksel o kolorze c w punkcie o współrzędnych (x,y).

void line(int x1, int y1, int x2, int y2, enum color c);

Rysuje linię z punktu (x1,y1) do (x2,y2), używając koloru c.

void rect(int x1, int y1, int x2, int y2, enum color c);

Rysuje prostokąt o lewym górnym rogu w punkcie (x1,y1) i prawym dolnym rogu w punkcie (x2,y2), używając koloru c.

void filledRect(int x1, int y1, int x2, int y2, enum color c);

Rysuje wypełniony prostokąt o lewym górnym rogu w punkcie (x1,y1) i prawym dolnym rogu w punkcie (x2,y2), używając koloru c.

void circle(int x, int y, int r, enum color c);

Rysuje okrąg o środku w punkcie (x,y) i promieniu r, używając koloru c.

void filledCircle(int x, int y, int r, enum color c);

Rysuje wypełniony okrąg (koło) o środku w punkcie (x,y) i promieniu r, używając koloru c.

void textout(int x, int y, char *s, enum color c);

Wypisuje tekst s od punktu o współrzędnych (x,y), używając koloru c.

int screenWidth();

Podaje szerokość ekranu.

int screenHeight();

Podaje wysokość ekranu.

void updateScreen();

Uwidacznia wyniki wywołania funkcji graficznych od ostatniego uaktualnienia ekranu.

int pollkey();

Zwraca kod wciśniętego w danej chwili klawisza. Zwraca -1 jeżeli żaden klawisz nie jest wciśnięty.

int getkey();

Czeka na naciśnięcie klawisza i zwraca jego kod.

int isKeyDown(int key);

Zwraca 1 jeżeli klawisz key jest wciśnięty, 0 w pozostałym przypadku.

Lista kodów klawiszy wykorzystywanych przez funkcje związane z klawiaturą: