Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Opracował: SeaMonster131
Biblioteki C/C++

al_create_bitmap

[funkcja] Tworzy nową, pustą bitmapę o podanych wymiarach.

Składnia

C/C++
#include <allegro/allegro5.h>

ALLEGRO_BITMAP * al_create_bitmap( int w, int h )

Argumenty

ArgumentOpis
int wSzerokość nowej bitmapy wyrażona w pikselach.
int hWysokość nowej bitmapy wyrażona w pikselach.

Zwracana wartość

Zwraca adres bitmapy, jeśli utworzenie bitmapy powiodło się.

Zwraca NULL, jeśli utworzenie bitmapy nie powiodło się.

Opis szczegółowy

Funkcja tworzy nową, pustą bitmapę o podanych wymiarach. Wysokość jak i szerokość nie może być liczbą ujemną. Jeżeli nie zostanie ustawiona flaga ALLEGRO_MEMORY_FLAG, to bitmapa jest tworzona dla bieżącego ekranu. Wyświetlanie na innym ekranie może być powolne.

Mogą wystąpić ograniczenia wielkości bitmapy. Np. DirectX lub OpenGL zazwyczaj mają określony maksymalny rozmiar bitmapy. Więc, jeżeli tworzenie bitmapy zakończy się błędem, trzeba będzię ponownie ją stworzyć, ale z mniejszymi rozmiarami.

Dodatkowe informacje

Pamięć zaalokowaną należy zwolnić za pomocą funkcji al_destroy_bitmap, aby uniknąć wycieków pamięci.

Przykład

C/C++
ALLEGRO_BITMAP * img = al_create_bitmap( 500, 500 );

Linki zewnętrzne