Laboratorium nr 6

1/4

1)

Bitmapy

Biblioteka Allegro podczas wywołania funkcji set_gfx_mode() standardowo alokuje w

pamięci karty graficznej specjalny obszar będący bitmapą. Obszar ten opisany jest za

pomocą struktury BITMAP i dostęp do niego odbywa się poprzez zmienną wskaźnikową

screen. Dodatkowo biblioteka Allegro oferuje programiście możliwość tworzenia własnych

bitmap w pamięci RAM komputera. Rozróżniamy 4 podstawowe typy bitmap:

1.

Memory Bitmap (standardowa bitmapa w pamięci RAM)

2.

Sub Bitmap (bitmapa potomna, będąca częścią bitmapy rodzica)

3.

Video Memory Bitmap (specjalny rodzaj bitmap, wykorzystywany w grach)

4.

System Bitmap (specjalny rodzaj bitmap systemowych)

W celu alokacji pamięci dla własnej bitmapy, wywołujemy funkcję:

BITMAP *create_bitmap(int width, int height)

Funkcja ta zwraca wskaźnik do bitmapy, w przypadku błędu alokacji zwracana jest

wartość NULL. Na końcu działania programu należy zwolnić obszar pamięci zajęty przez

daną bitmapę za pomocą wywołania funkcji:

void destroy_bitmap(BITMAP *bitmap)

Nazwa funkcji

Parametry

Opis

create_bitmap_ex

BITMAP *create_bitmap_ex(int

color_depth, int width, int height)

Funkcja alokuje obszar w pamięci

komputera dla bitmapy o głębi

koloru i rozmiarach podanych jako

parametry funkcji

create_sub_bitmap

BITMAP *create_sub_bitmap(BITMAP

*parent, int x, y, width, height)

Funkcja alokuje obszar w pamięci

komputera dla sub-bitmapy. Jako

parametry podajemy rozmiar oraz

wskaźnik na bitmapę (rodzica)

create_video_bitmap

BITMAP *create_video_bitmap(int width,

int height)

Funkcja alokuje obszar w pamięci

komputera dla video-bitmapy. Jako

parametry podajemy rozmiar

bitmapy

create_system_bitmap

BITMAP *create_system_bitmap(int

width, int height)

Funkcja alokuje obszar w pamięci

komputera dla system-bitmapy.

Jako parametry podajemy rozmiar

bitmapy

set_clip_rect

void set_clip_rect(BITMAP *bitmap, int x1,

int y1, int x2, int y2)

Funkcja ustawia nowy prostokąt

obcinania dla podanej bitmapy.

Grafika Komputerowa 2D

Temat: Bitmapy, wczytywanie plików, double-buffer w bibliotece Allegro

Instrukcja

laboratoryjna

6

Przygotował: dr inż. Grzegorz Łukawski, mgr inż. Maciej Lasota

Laboratorium nr 6

2/4

2)

Wczytywanie plików

Biblioteka Allegro umożliwia wczytywania różnego rodzaju bitmap z plików. Obsługuje

ona następujące formaty plików graficznych: BMP, PCX, TGA, LBM. W celu wczytania

bitmapy z dowolnie obsługiwanego pliku wywołujemy funkcję:

BITMAP *load_bitmap(const char *filename, RGB *pal)

Funkcja ta przyjmuje dwa parametry. Pierwszy parametr jest stałą znakową, będącą

nazwą pliku. Drugim parametrem jest zmienna typu PALETTE, zadaniem tej zmiennej jest

przechowywanie wczytanej z pliku palety kolorów.

Każdą wczytaną bitmapę musimy na końcu zwolnić za pomocą funkcji

destroy_bitmap().

Nazwa funkcji

Parametry

Opis

load_bmp

BITMAP *load_bmp(const char *filename, RGB *pal)

Funkcja wczytuje bitmapę oraz

paletę kolorów z pliku BMP

load_lbm

BITMAP *load_lbm(const char *filename, RGB *pal)

Funkcja wczytuje bitmapę oraz

paletę kolorów z pliku LBM

load_pcx

BITMAP *load_pcx(const char *filename, RGB *pal)

Funkcja wczytuje bitmapę oraz

paletę kolorów z pliku PCX

load_tga

BITMAP *load_tga(const char *filename, RGB *pal)

Funkcja wczytuje bitmapę oraz

paletę kolorów z pliku TGA

save_bitmap

int save_bitmap(const char *filename, BITMAP *bmp,

const RGB *pal)

Funkcja zapisuje bitmapę do

dowolnie obsługiwanego

formatu pliku.

3)

Kopiowanie bitmap w pamięci

W celu skopiowania prostokątnego obszaru jednej bitmapy do drugiej bitmapy,

wywołujemy funkcje:

void blit(BITMAP *source, BITMAP *dest, int source_x, int source_y, int dest_x,

int dest_y, int width, int height);

Jako parametry podajemy bitmapę źródłową, bitmapę docelową, współrzędne lewego

górnego rogu obszaru oraz wysokość i szerokość obszaru do skopiowania. Funkcja blite()

wykorzystywana jest w technice Double Buffernig (podwójnego bufora), czyli technice

zapewniającej płynne wyświetlanie obrazów. Każdy kolejny obraz jest wcześniej rysowany w

pamięci RAM komputera, po czym zostaje bezpośrednio wyświetlony przez kartę graficzną

na ekranie monitora.

Laboratorium nr 6

3/4

UWAGA! SPRITE (w Allegro) są to specjalne rodzaje bitmap, służące do

przechowywania obrazów np. w grach komputerowych. Możemy na nich

operować identycznie jak na zwykłych bitmapach.

Nazwa funkcji

Parametry

Opis

draw_sprite

void draw_sprite(BITMAP *bmp, BITMAP *sprite,

int x, int y)

Funkcja kopiuje obszar

bitmapy sprite do drugiej

bitmapy. Jako parametr

podajemy pozycje

początkową rysowania

stretch_sprite

void stretch_sprite(BITMAP *bmp, BITMAP *sprite,

int x, int y, int w, int h)

Funkcja kopiuje obszar

bitmapy sprite do drugiej

bitmapy, dokonując zmiany

rozmiaru. Jako parametry

podajemy pozycję

początkową rysowania oraz
nową wysokość i szerokość

rotate_sprite

void rotate_sprite(BITMAP *bmp, BITMAP *sprite,

int x, int y, fixed angle)

Funkcja kopiuje obszar

bitmapy sprite do drugiej

bitmapy, dokonując obrotu o

podany kąt

pivot_sprite

void pivot_sprite(BITMAP *bmp, BITMAP *sprite,

int x, int y, int cx, int cy, fixed angle)

Funkcja kopiuje obszar

bitmapy sprite do drugiej

bitmapy, dokonując obrotu o

podany kąt względem punktu

(cx,cy)

draw_sprite_v_flip

void draw_sprite_v_flip(BITMAP *bmp, BITMAP

*sprite, int x, int y)

Funkcja kopiuje obszar

bitmapy sprite do drugiej

bitmapy, dokonując

odwrócenia pionowego

draw_sprite_h_flip

void draw_sprite_h_flip(BITMAP *bmp, BITMAP

*sprite, int x, int y);

Funkcja kopiuje obszar

bitmapy sprite do drugiej

bitmapy, dokonując

odwrócenia poziomego

draw_sprite_vh_flip

void draw_sprite_vh_flip(BITMAP *bmp, BITMAP

*sprite, int x, int y)

Funkcja kopiuje obszar

bitmapy sprite do drugiej

bitmapy, dokonując

odwrócenia pionowego i

poziomego

rotate_scaled_sprite

void rotate_scaled_sprite(BITMAP *bmp, BITMAP

*sprite, int x, int y, fixed angle, fixed scale)

Funkcja kopiuje obszar

bitmapy sprite do drugiej

bitmapy, dokonując obrotu o

podany kąt i skalowania

pivot_scaled_sprite

void pivot_scaled_sprite(BITMAP *bmp, BITMAP

*sprite, int x, int y, int cx, int cy, fixed angle, fixed

scale)

Funkcja kopiuje obszar

bitmapy sprite do drugiej

bitmapy, dokonując obrotu o

podany kąt względem punktu

(cx,cy) i skalowania

stretch_blit

void stretch_blit(BITMAP *source, BITMAP *dest,

int source_x, source_y, source_width,

source_height, int dest_x, dest_y, dest_width,

dest_height)

Funkcja kopiuje obszar

jednej bitmapy do drugiej

bitmapy, dokonując

dodatkowo zmiany rozmiaru

Laboratorium nr 6

4/4

UWAGA! Poniżej zostały przedstawione niektóre funkcje służące do uzyskania

efektu przezroczystości, więcej informacji w dokumentacji biblioteki

Nazwa funkcji

Parametry

set_trans_blender

void set_trans_blender(int r, int g, int b, int a);

set_alpha_blender

void set_alpha_blender();

set_write_alpha_blender

void set_write_alpha_blender();