BLOWUP w rozdziale 14...

Nie b�d� omawia� tej funkcji, ale nieco informacji na jej
temat mo�na znale�� w Knowledge Base article Q80080.
Sekcja DIB
Mam nadziej�, �e teraz dobrze czujesz r�nic� mi�dzy bitmapami zale�nymi od
urz�dze� a bitmapami od nich niezale�nymi. DIB mo�e mie� jedn� z kilku orga-
ruzacji kolor�w; DDB musi by� albo monochromatyczna, albo mie� taki sam for-
mat jak rzeczywiste urz�dzenie wyj�ciowe. DIB jest plikiem lub blokiem pami�-
ci; DDB jest bitmapowym obiektem GDI i jest reprezentowana przez uchwyt bit-
mapy. DIB mo�e by� wy�wietlons lub konwertowana na DDB i z powrotem, lecz
to wi��e si� z procesem konwersji mi�dzy bitmapami niezale�nymi od urz�dze�
a bitmapami charakterystycznymi dla urz�dzenia.
Teraz zbli�amy si� do poznania funkcji, kt�ra zdaje si� �ama� te zasady. Zosta�a
wprowadzona w 32-bitowych wersjach Windows i nazywa si� CreateDIBSection.
Oto jej sk�adnia:
hBitmap = CreateDIBSection (
hdc, // uchwyt kontekstu urzddzenia
pInfo, // wska�nik do informacji o DIB
fColorUse, // okre�lenie rodzaju danych koloru
ppBits, // wska�nik do zmiennej wska�nikowej
hSection, // uchwyt obiektu odwzorowania pliku
dwOffset) ; // offset do bit�w w obiekcie odwzorowania pliku
CreateDIBSection to jedna z najwa�niejszych funkcji w Windows API (a przynaj-
mniej, je�eli du�o pracujesz z bitmapami), lecz jest tak niesamowita, �e mo�e zosta�
uznana za nader ezoteryczn� i trudn� do zrozumienia.
Rozpoczrujmy od samej nazwy funkcji. Wiemy, co to jest DIB, lecz czym do dia-
b�a jest "sekcja DIB"? Kiedy po raz pierwszy spojrza�e� na funkcj� CreateDIBSec-
tion, mo�e zacz��e� si� zastanawia�, czy nie pracuje ona jedynie na jakiej� cz�ci
728 Cz�� II: Grafika
DIB. Jest to bliskie prawdy. To, co robi CreateDIBSection, to istotnie utworzenie
cz�ci (sekcji) DIB - bloku pami�ci na bity pikseli bitmapy.
Sp�jrzmy teraz na warto�� zwracan�. Jest to uchwyt do obiektu bitmapowego
GDI. Ta warto�� zwracana jest przypuszczalnie najbardziej zwodniczym aspek-
tem wywo�ania CreateDIBSection zdaje si� sugerowa�, �e ta funkcja dzia�a podobnie
do CreateDIBitmap. Tak, s� podobne, ale zarazem ca�kowicie odmienne. W rze-
czywisto�ci uchwyt bitmapy zwracany z CreateDIBSection znacznie r�ni si� od
uchwytu bitmapy zwracanego ze wszystkich funkcji tworz�cych bitmapy, jakie
napotkali�my rozdziale w tym i poprzednim.
Gdy ju� zrozumiesz charakter funkcji CreateDIBSection, mo�esz zastanowi� si�,
dlaczego warto�� zwracana nie zosta�a zdefiniowana jako� inaczej. Mo�e nawet
dojdziesz do wniosku, �e CreateDIBSection powinna by�a by� nazwana CreateDl-
Bitmap, a ta z kolei powinna by�a zosta� nazwana, jak wcze�niej wspomnia�em,
CreateDDBitmap.
W pierwszym podej�ciu do funkcji CreateDIBSection zastan�wmy si�, jak mo�emy
j� upro�ci� i natychmiast jej u�y�. Po pierwsze, ostatnim dw�m argumentom, hSec-
tion i dwOffset, mo�esz nada� warto�ci, odpowiednio, NULL i 0. Wykorzystanie tych
argument�w om�wi� pod koniec rozdzia�u. Po drugie, parametr hdc u�ywany jest
jedynie w�wczas, gdy parametr fColorUse ma warto�� DIB- PAL COLORS. Je�li
fColorUse wynosi DIB RGB COLORS (lub 0), hdc jest ignorowane. (Nie jest tak
w przypadku CreateDIBitmap, gdzie parametr hdc jest u�ywany do uzyskania for-
matu koloru urz�dzenia, z kt�rym ma by� kompatybilna DDB).
Zatem w swojej najprostszej postaci CreateDIBSection wymaga jedynie drugiego
i czwartego argumentu. Drugi argument to wska�nik do struktury BITMAPIN-
FO. Z takim wska�nikiem mieli�my ju� poprzednio do czynienia. Mam nadziej�,
�e zdefiniowanie wska�nika do wska�nika w czwartym argumencie nie odebra-
�o ci zapahx. W rzeczywisto�ci jest to do�� proste, gdy si� u�ywa funkcji.
Za��my, �e chcesz utworzy� DIB 384X256 bit�w, 0 24 bitach na piksel. Format
24-bitowy jest najprostszy, poniewa� nie wymaga tablicy kolor�w, zatem dla pa-
rametru BITMAPINFO mo�emy zastosowa� struktur� BITMAPINFOHEADER.
Definiujesz trzy zmienne: struktur� BITMAPINFOHEADER, wska�nik do BYTE
i uchwyt bitmapy:
BITMAPINFOHEADER bmih ;
BYTE * pBits ;
HBITMAP hBitmap ;
Teraz zainicjuj pola struktury BITMAPINFOHEADER:
bmih->biSize = sizeof (BITMAPINFOHEADER) ;
bmih->biWidth = 384 ;
bmih->biHeight = 256 ;
bmih->biPlanes = 1 ;
bmih->biBitCount = 24 ;
bmih->biCompression = BI�RGB ;
bmih->biSizeImage = 0 ;
bmih->biXPelsPerMeter = 0 ;
bmih->biYPelsPerMeter = 0 ;
bmih->biClrUsed = 0 ;
bmih->biClrImportant = 0 ;
Rozdzia� 15: Bitmapa niezale�na od urz�dze� 72g
Po tych ograniczonych do minimum przygotowaniach gotowi jeste�my do wy-
wo�ania funkcji:
hBitmap = CreateDIBSection (NULL, (BITMAPINFO *) &bmih, 0, &pBits, NULL, 0) ;
Zauwa�, �e jako drugi argument bierzemy jak zwykle adres struktury BITMA-
PINFOHEADER, lecz tak�e, co jest niezwyk�e, adres pBits - wska�nika do BYTE.
Tak wi�c czwarty argument jest wska�nikiem do wska�nika, jak tego wymaga
funkcja.
Oto co robi funkcja CreateDIBSection: bada struktur� BITMAPINFOHEADER i alo-
kuje blok pami�ci, kt�ry mo�e pomie�ci� bity pikseli DIB. (W tym szczeg�lnym
przypadku blok ma rozmiar 384x256x3 bajt�w). W parametrze pBits, kt�ry do-
starczy�e�, zapisuje wska�nik do tego bloku pami�ci. Funkcja zwraca tak�e
uchwyt do bitmapy, kt�ry jak powiedzia�em, nie jest dok�adnie taki sam, jak
uchwyt zwracany przez funkcj� CreateDIBitmap i inne funkcje tworz�ce bitmapy.
Jednak jeszcze nie sko�czyli�my. Piksele bitmapy s� niezainicjowane. Czytaj�c j
plik DIB, mo�esz po prostu przekaza� parametr pBits do funkcji ReadFile i wczy-
ta� je. Mo�esz je te� ustawi� "r�cznie" w kodzie programu.
Program DIBSECT przedstawiony na rysunku 15-11 jest podobny do programu
DIBCONV, z t� r�nic�, �e wywo�uje funkcj� CreateDIBSection zamiast CreateDl-
Bitmap.
DIBSECT.C
/*
DIBSECT.C - Wy�wietla sekcj� DIB w obszarze roboczym okna


	BLOWUP w rozdziale 14...	Pomodliłem się do każdego boga jaki istniał bym był w wstanie wkurzyć tę kobietę do granic możliwości.