al_create_bitmap

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

Składnia

#include <allegro/allegro5.h>

ALLEGRO_BITMAP * al_create_bitmap( int w, int h )

Argumenty

Argument	Opis
int w	Szerokość nowej bitmapy wyrażona w pikselach.
int h	Wysokość 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

ALLEGRO_BITMAP * img = al_create_bitmap( 500, 500 );

Linki zewnętrzne

http://www.allegro.cc/manual/5/al_create_bitmap

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.