Biblioteka procedur graficznych dla SDL
        Wersja końcowa

W tym artykule znajdziesz wersję plików bibliotecznych do kolejnych zajęć z nauki programowania grafiki komputerowej.

Opis instalacji środowiska znajdziesz w artykułach OL031, OL032 i OL034.

Parametry dla konsolidatora Dev-C++:

-lmingw32
-mwindows
-lSDLmain
-lSDL

Pliki biblioteczne

SDL_gfx.h

SDL_gfx.cpp

Opis funkcji i struktur danych

Funkcja oblicza macierz powinowactwa prostokątnego A względem prostej ax + by + c = 0 i o współczynniku powinowactwa k. Zwraca wskaźnik do obliczonej macierzy. Po wykorzystaniu macierz powinna zostać usunięta z pamięci.

gfx2DCopyPoly(p)

Funkcja tworzy kopię listy łamanych i zwraca jej adres - po wykorzystaniu kopię usuwamy. Z funkcji korzystamy przy tworzeniu transformacji geometrycznych, gdy chcemy uzyskać nowy obraz figury bez utraty jej oryginału. Zasada postępowania jest następująca:

1. W tablicy F mamy figurę, czyli listę łamanych. Konstrukcję tej listy opisuje artykuł OL051.
2. Tworzymy kopię F w nowej tablicy:
       Sint32 * NF = gfx2DCopyPoly(F);
3. Tworzymy macierz przekształcenia G.
4. Wykonujemy przekształcenie geometryczne na kopii figury:
       gfx2DTransform(NF,G);
5. Rysujemy wynikową figurę:
       gfxDrawPoly(screen,NF,kolor);
6. Usuwamy niepotrzebne już macierze:
       delete [] NF;
       delete [] G;

gfx2DDrawPoly(s,p,color)

Funkcja rysuje obiekt wektorowy zbudowany z listy łamanych. Konstrukcję tej listy opisuje artykuł OL051. Reaguje na prostokąt obcinania.

gfx2DHomoth(xh,yh,k)

Funkcja oblicza macierz jednokładności H względem punktu (xh,yh) i o współczynniku k. Zwraca wskaźnik do obliczonej macierzy przekształcenia.  Po wykorzystaniu macierz powinna zostać usunięta z pamięci.

Funkcja oblicza macierz rotacji R - obrotu na płaszczyźnie i zwraca wskazanie do niej.  Po wykorzystaniu macierz powinna zostać usunięta z pamięci.

gfx2DScale(Sx,Sy)

Funkcja oblicza macierz skalowania S wzdłuż osi OX i OY i zwraca wskazanie do niej. Po wykorzystaniu macierz powinna zostać usunięta z pamięci.

gfx2DShear(Sx,Sy)

Funkcja oblicza macierz ścinania S wzdłuż osi OX i OY i zwraca wskazanie do niej. Po wykorzystaniu macierz powinna zostać usunięta z pamięci.

Funkcja oblicza macierz translacji T - przesunięcia na płaszczyźnie i zwraca wskazanie do niej. Po wykorzystaniu macierz powinna zostać usunięta z pamięci.

gfx2DTransform(p,tmx)

Funkcja przekształca współrzędne wierzchołków poszczególnych list łamanych zgodnie z macierzą transformacji. Operację tę wykonujemy zwykle na kopi obiektu tuż przed rysowaniem. Ponieważ współrzędne są zaokrąglane do liczb całkowitych, funkcja nie nadaje się do sekwencyjnej animacji z uwagi na kumulację błędów zaokrągleń.

gfxBoundaryFill(screen,x,y,fcolor,bcolor)

Funkcja wypełnia kolorem fcolor obszar wskazany ziarnem x,y. Obszar jest ograniczony konturem (linią) w kolorze bcolor oraz prostokątem obcinającym. Wszystkie piksele o kolorze różnym od bcolor zostaną pomalowane w obszarze na fcolor.

gfxCircle(screen,x_s,y_s,r,color)

Funkcja rysuje okrąg o środku w punkcie (x_s,y_s), promieniu r i kolorze konturu color. Okrąg w całości musi się mieścić na powierzchni graficznej.

gfxClipCircle(screen,x_s,y_s,r,color)

Funkcja rysuje okrąg o środku w punkcie (x_s,y_s), promieniu r i kolorze konturu color. Okrąg jest obcinany do prostokąta screen->clip_rect.

gfxClipEllipse(screen,x_s,y_s,r_x,r_y,color)

Funkcja rysuje elipsę o środku w punkcie (x_s,y_s), promieniach r_x, r_y i kolorze konturu color. Elipsa jest obcinana do prostokąta screen->clip_rect.

gfxClipHLine(screen,x,y,color,len)

Funkcja rysuje odcinek poziomy na obszarze graficznym. Odcinek jest obcinany do prostokąta obcinającego zdefiniowanego w strukturze screen.

gfxClipLine(screen,x₁,y₁,x₂,y₂,color)

Funkcja rysuje odcinek od punktu początkowego (x₁,y₁) do punktu końcowego (x₂,y₂) wykorzystując algorytm Bresenhama. Odcinek jest obcinany do prostokąta obcinającego zdefiniowanego w strukturze screen.

gfxClipLineTo(screen,x,y,color)

Funkcja rysuje odcinek od punktu początkowego ustawionego przez funkcję gfxMoveTo() lub punktu końcowego ostatniego wywołania funkcji gfxLineTo() do punktu (x,y). Punkt końcowy (x,y) staje się punktem początkowym dla kolejnego wywołania tej funkcji. Umożliwia to rysowanie łamanych, zbudowanych z odcinków połączonych końcami. Odcinek jest obcinany do prostokąta obcinającego zdefiniowanego w strukturze screen.

gfxClipPlot(screen,x,y,color)

Funkcja rysuje jeden punkt na powierzchni graficznej. Jeśli punkt (x,y) znajduje się poza prostokątem obcinającym w strukturze screen, nie będzie rysowany.

gfxClipRectangle(screen,r,color)

Funkcja rysuje prostokątną ramkę zdefiniowaną strukturą SDL_Rect. Ramka jest obcinana do prostokąta obcinającego w strukturze screen.

gfxClipVLine(screen,x,y,color,len)

Funkcja rysuje odcinek pionowy na obszarze graficznym.  Odcinek jest obcinany do prostokąta obcinającego zdefiniowanego w strukturze screen.

gfxCloseFont(f)

Funkcja zamyka czcionkę bitmapową i zwalnia zajmowaną przez nią pamięć.

gfxDrawChar(screen,f,c,x,y,fcolor,bcolor)

Rysuje znak c w kolorze fcolor na tle bcolor na współrzędnych x,y powierzchni graficznej. Jeśli kolory fcolor (tylko dla czcionki bitmapowej) lub bcolor (dla obu typów czcionek - bitmapowej i wektorowej) przyjmą wartość -1, to będą traktowane jako przeźroczyste. Pozwala to rysowanie tekstu bez kasowania tła lub na inne ciekawe efekty graficzne. Rysowana literka powinna w całości mieścić się na powierzchni graficznej. Funkcja zwraca szerokość w pikselach narysowanej literki.

gfxDrawText(screen,f,t,x,y,fcolor,bcolor)

Rysuje tekst t w kolorze fcolor na tle bcolor na współrzędnych x,y powierzchni graficznej. Jeśli kolory fcolor (tylko dla czcionki bitmapowej) lub bcolor (dla obu typów czcionek - bitmapowej i wektorowej) przyjmą wartość -1, to będą traktowane jako przeźroczyste. Pozwala to rysowanie tekstu bez kasowania tła lub na inne ciekawe efekty graficzne. Rysowany tekst powinien w całości mieścić się na powierzchni graficznej. Jako wynik funkcja zwraca pozycję x leżącą za wypisanym tekstem. Pozycja ta może zostać wykorzystana do kontynuacji rysowania tekstu w następnym wywołaniu tej funkcji.

gfxEllipse(screen,x_s,y_s,r_x,r_y,color)

Funkcja rysuje elipsę o środku w punkcie (x_s,y_s), promieniach r_x, r_y i kolorze konturu color. Elipsa w całości musi się mieścić na powierzchni graficznej.

gfxFillCircle(screen,x_s,y_s,r,color)

Funkcja rysuje wypełnione kolorem color koło = o środku w punkcie (x_s,y_s) i promieniu r. Koło jest obcinane do prostokąta screen->clip_rect.

gfxFillEllipse(screen,x_s,y_s,r_x,r_y,color)

Funkcja rysuje owal o środku w punkcie (x_s,y_s), promieniach r_x, r_y i kolorze konturu color. Owal jest obcinany do prostokąta screen->clip_rect.

gfxFillPoly(s,f,color)

Funkcja wypełnia kolorem color obiekt wektorowy zbudowany z listy łamanych. Konstrukcję tej listy opisuje artykuł OL051. Reaguje na prostokąt obcinania.

gfxFont

Struktura gfxFont przechowuje matryce bitmapowe literek czcionki bitmapowej lub definicje łamanych dla czcionki wektorowej. Dostęp do matryc lub łamanych jest poprzez tablicę wskaźników cp[ ]. Indeks wskaźnika jest kodem ASCII znaku.

gfxFloodFill(screen,x,y,fcolor)

Funkcja wypełnia kolorem fcolor obszar wskazany ziarnem x,y. Obszar posiada jednolity kolor oraz jest ograniczony obszarami w innych kolorach i prostokątem obcinającym.

gfxGetPixel(screen,x,y)

Funkcja zwraca 32 bitowy kod koloru piksela umieszczonego na pozycji x,y powierzchni graficznej. Współrzędne x i y muszą zawierać się w obszarze graficznym.

gfxHLine(screen,x,y,color,len)

Funkcja rysuje odcinek poziomy na obszarze graficznym. Odcinek w całości powinien się zawierać w tym obszarze.

gfxLibVersion()

Funkcja zwraca tekst z numerem wersji biblioteki graficznej SDL_gfx. Istnieje tylko dla celów testowych w trakcie instalacji oprogramowania.

gfxLine(screen,x₁,y₁,x₂,y₂,color)

Funkcja rysuje odcinek od punktu początkowego (x₁,y₁) do punktu końcowego (x₂,y₂) wykorzystując algorytm Bresenhama. Punkt początkowy i końcowy musi zawierać się w powierzchni graficznej.

gfxLineTo(screen,x,y,color)

Funkcja rysuje odcinek od punktu początkowego ustawionego przez funkcję gfxMoveTo() lub punktu końcowego ostatniego wywołania funkcji gfxLineTo() do punktu (x,y). Punkt końcowy (x,y) staje się punktem początkowym dla kolejnego wywołania tej funkcji. Umożliwia to rysowanie łamanych, zbudowanych z odcinków połączonych końcami. Punkt początkowy i końcowy rysowanego odcinka muszą zawierać się w powierzchni graficznej screen.

gfxMAdd(n,m,A,B)

Funkcja dodaje macierz A do macierzy B i zwraca wskazanie do macierzy wynikowe C. Macierze A ,B zawierają elementy typu double.
C_{n x m} = A_{n x m} + B_{n x m}

gfxMMul(n,r,A,B)

Funkcja mnoży macierz A przez macierz B i zwraca wskazanie do macierzy wynikowej C.  Macierze A ,B zawierają elementy typu double.
C_{n x r} = A_{n x m} x B_{m x r}

gfxMoveTo(x,y)

Funkcja współpracuje z gfxLineTo() oraz gfxClipLine(). Ustawia punkt początkowy odcinka.

gfxOpenFont(filename)

Funkcja odczytuje z pliku tekstowe definicje matryc czcionki bitmapowej lub definicje łamanych dla czcionki wektorowej i umieszcza je w strukturze gfxFont. Zwraca adres tej struktury lub NULL w przypadku błędów - najczęściej zła nazwa pliku. Struktura pliku jest dokładnie opisana w rozdziałach OL041 i OL042. Przykładowe czcionki:

bmpbold8x8.fnt
bmpnorm8x8.fnt
bmpprop8x8.fnt
bmppropbold8x8.fnt
vecprop9x12.fnt

Wykorzystywane pliki czcionek najlepiej umieścić w tym samym katalogu co program. W przeciwnym razie należy przekazać funkcji gfxOpenFont() pełną ścieżkę dostępu wraz z nazwą pliku wg konwencji stosowanej w danym systemie operacyjnym. Polskie znaki należy zdefiniować zgodnie z kodowaniem systemowym.

gfxPlot(screen,x,y,color)

Funkcja rysuje jeden punkt na powierzchni graficznej. Punkt musi się zawierać w tej powierzchni, tzn jego współrzędne nie mogą wykraczać poza marginesy, w przeciwnym wypadku może dojść do zamknięcia aplikacji z powodu naruszenia praw dostępu do chronionych obszarów pamięci.

gfxRectangle(screen,r,color)

Funkcja rysuje prostokątną ramkę zdefiniowaną strukturą SDL_Rect. Ramka w całości musi się zawierać w obszarze graficznym.

gfxTextLength(f,t)

Funkcja oblicza szerokość w pikselach podanego jako parametr t tekstu.

gfxVLine(screen,x,y,color,len)

Funkcja rysuje odcinek pionowy na obszarze graficznym. Odcinek w całości powinien się zawierać w tym obszarze.

I Liceum Ogólnokształcące    im. Kazimierza Brodzińskiego w Tarnowie ©2024 mgr Jerzy Wałaszek

Pytania proszę przesyłać na adres email: i-lo@eduinf.waw.pl

W artykułach serwisu są używane cookies. Jeśli nie chcesz ich otrzymywać,
zablokuj je w swojej przeglądarce.
Informacje dodatkowe