Îãëàâëåíèå

Âñòóïëåíèå

Ôîðìàòû áóôåðîâ

Ôóíêöèè

lib_init

buf2d_create

buf2d_create_f_img

buf2d_clear

buf2d_draw

buf2d_delete

buf2d_rotate

buf2d_resize

buf2d_line

buf2d_line_sm

buf2d_rect_by_size

buf2d_filled_rect_by_size

buf2d_circle

buf2d_img_hdiv2

buf2d_img_wdiv2

buf2d_conv_24_to_8

buf2d_conv_24_to_32

buf2d_bit_blt

buf2d_bit_blt_transp

buf2d_bit_blt_alpha

buf2d_curve_bezier

buf2d_convert_text_matrix

buf2d_draw_text

buf2d_crop_color

buf2d_offset_h

buf2d_flood_fill

buf2d_set_pixel

buf2d_get_pixel

buf2d_flip_h

buf2d_flip_v

buf2d_filter_dither

buf2d_vox_brush_create

buf2d_vox_brush_delete

buf2d_vox_obj_draw_1g

buf2d_vox_obj_get_img_w_3g

buf2d_vox_obj_get_img_h_3g

buf2d_vox_obj_draw_3g

buf2d_vox_obj_draw_3g_scaled

buf2d_vox_obj_draw_3g_shadows

buf2d_vox_obj_draw_pl

buf2d_vox_obj_draw_pl_scaled

Êîíñòàíòû

Òàáëèöà ýêñïîðòà

Èñòîðèÿ

Âñòóïëåíèå

Äîêóìåíòàöèÿ ê ñâîáîäíîé áèáëèîòåêå buf2d.asm, äëÿ ÎÑ Êîëèáðè.

 Ýòà áèáëèîòåêà ñîçäàíà äëÿ ðàáîòû ñ 2d èçîáðàæåíèÿìè.

 Ñ åå ïîìîùüþ ìîæíî ñîçäàâàòü áóôåðà ñ èçîáðàæåíèÿìè â ïàìÿòè, è ïðè íåîáõîäèìîñòè âûâîäèòü èõ íà ýêðàí.

 Èçîáðàæåíèÿ ìîæíî íàêëàäûâàòü îäíî íà äðóãîå, ïîääåðæèâàåòñÿ ðàáîòà ñ ïðîçðà÷íûìè èçîáðàæåíèÿìè.

 Åñòü ôóíêöèè ðèñîâàíèÿ ëèíèé, êðèâûõ Áåçüå, ïðÿìîóãîëüíèêîâ, îêðóæíîñòåé.

 Òàêæå åñòü ôóíêöèè äëÿ ðèñîâàíèé âîêñåëüíîé ãðàôèêè.

Ïîñëåäíåå îáíîâëåíèå áèáëèîòåêè 09.02.16.

Ôîðìàòû áóôåðîâ

Ïîääåðæèâàåòñÿ 3 ôîðìàòà áóôåðîâ.

 Êàæäàÿ ôóíêöèÿ ïðè ðàáîòå ñ áóôåðàìè ìîæåò áûòü ðàñ÷èòàíà íà ðàáîòó ñ îïðåäåëåííûìè ôîðìàòàìè èçîáðàæåíèé.

8 áèò

Ñîæåðæèò àëüôà êàíàë a (ïðîçðà÷íîñòü) èçîáðàæåíèÿ. Íà ýêðàí íå âûâîäèòñÿ. Èñïîëüçóåòñÿ äëÿ ñîçäàíÿ 32-áèòíûõ áóôåðîâ.

24 áèò

Äàííûé áóôåð ñîäåðæèò èçîáðàæåíèå â ôîðìàòå rgb. Ìîæåò âûâîäèòñÿ íà ýêðàí.

32 áèò

Ñîäåðæèò ïðîçðà÷íîå èçîáðàæåíèå â ôîðìàòå rgba. Íà ýêðàí íå âûâîäèòñÿ. Èñïîëüçóåòñÿ äëÿ íàëîæåíèÿ èçîáðàæåíèé. Åñëè a=255 òî ïèêñåëü ïðîçðà÷íûé, åñëè 0 íå ïðîçðà÷íûé.

Ôóíêöèè

Ïî÷òè âñå ôóíêöèè 1-ì ïàðàìåòðîì ïðèíèìàþò óêàçàòåëü íà ñòðóêòóðó áóôåðà,

 èç êîòîðîé ìîãóò èñïîëüçîâàòüñÿ ïàðàìåòðû, íóæíûå äëÿ ðàáîòû êîíêðåòíîé ôóíêöèè.

 Ïðèìåð ñòðóêòóðû áóôåðà èçîáðàæåíèÿ:

align 4

buf_0:

	dd    0 ;+ 0 óêàçàòåëü íà áóôåð èçîáðàæåíèÿ

	dw  100 ;+ 4 îòñòóï ñëåâà

	dw   10 ;+ 6 îòñòóï ñïðàâà

	dd  150 ;+ 8 øèðèíà

	dd  100 ;+12 âûñîòà

	dd 0x80 ;+16 ôîíîâûé öâåò

	db   24 ;+20 áèò íà ïèêñåëü

lib_init

Ýòà ôóíêöèÿ ïîëó÷àåò óêàçàòåëè íà ôóíêöèè ðàáîòû ñ ïàìÿòüþ, âûçûâàòñÿ äîëæíà ïðè çàãðóçêå áèáëèîòåêè. Ìîæåòå èñïîëüçîâàòü ìàêðîñ @use_library_mem, äëÿ åå àâòîìàòè÷åñêîé íàñòðîéêè.

buf2d_create

Ñîçäàåò áóôåð è ÷èñòèò åãî ôîíîâûì öâåòîì. Ïðèìåð:

stdcall [buf2d_create], buf_0

ãäå buf_0 - ñòðóêòóðà áóôåðà.

Ïàðàìåòðû äëÿ ñîçäàíèÿ áóôåðà áåðóòñÿ èç ñòðóêòóðû.

buf2d_create_f_img

Ñîçäàåò áóôåð íà îñíîâå èçîáðàæåíèÿ â ôîðìàòå rgb.

buf2d_w equ dword[edi+8] ;øèðèíà áóôåðà

buf2d_h equ dword[edi+12] ;âûñîòà áóôåðà

mov edi,buf_i0

mov buf2d_w,320

mov buf2d_h,240

stdcall [buf2d_create_f_img], edi,[open_file_img]

ãäå buf_0 - ñòðóêòóðà áóôåðà, open_file_img - óêàçàòåëü íà äàííûå èçîáðàæåíèÿ â ôîðìàòå rgb, 320 - øèðèíà èçîáðàæåíèÿ â ïèêñåëÿõ, 240 - âûñîòà èçîáðàæåíèÿ â ïèêñåëÿõ.

buf2d_clear

×èñòèò áóôåð óêàçàíûì öâåòîì. Ïðèìåð:

buf2d_color equ dword[edi+16] ;öâåò ôîíà áóôåðà

mov edi,buf_0

stdcall [buf2d_clear], edi, buf2d_color ;î÷èùàåì ýêðàí ôîíîâûì öâåòîì

ãäå buf_0 - ñòðóêòóðà áóôåðà.

buf2d_draw

Ðèñóåò áóôåð íà ýêðàíå (ðàáîòàåò ÷åðåç ñèñòåìíóþ ô. 7). Ðèñóþòñÿ òîëüêî áóôåðà ñ ãëóáèíîé öâåòà 24 áèòà.

buf2d_delete

Îñâîáîæäàåò ïàìÿòü çàíÿòóþ èçîáðàæåíèåì áóôåðà.

buf2d_rotate

Ïîâîðà÷èâàåò áóôåð íà 90 èëè 180 ãðàäóñîâ. Ïðèìåð:

stdcall [buf2d_rotate], buf_0, 90

ãäå buf_0 - ñòðóêòóðà áóôåðà (ìîæåò áûòü 8, 24 èëè 32 áèòíûì); 90 - óãîë ïîâîðîòà.

buf2d_resize

Èçìåíÿåò ðàçìåðû áóôåðà èëè èçîáðàæåíèÿ â áóôåðå. Ïîêà ïîääåðæèâàþòñÿ áóôåðà ñ ãëóáèíîé öâåòà 24 áèòà.

Ïðèìåð 1:

stdcall [buf2d_resize], buf_0, 0,300, 1 ;èçìåíÿåì âûñîòó áóôåðà

ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ ëèíèÿ; 0 - íîâàÿ øèðèíà áóôåðà (0 îçíà÷àåò íå èçìåíÿòü ðàçìåð); 300 - íîâàÿ âûñîòà áóôåðà; 1 - ïàðàìåòð óêàçûâàþùèé ÷òî èçìåíÿþòñÿ ðàçìåðû áóôåðà.

Ïðèìåð 2:

stdcall [buf2d_resize], buf_0, 250,0, 2 ;èçìåíÿåì èçîáðàæåíèå â áóôåðå

ãäå 250 - íîâàÿ øèðèíà áóôåðà; 0 - íîâàÿ âûñîòà áóôåðà (0 îçíà÷àåò íå èçìåíÿòü ðàçìåð); 2 - ïàðàìåòð óêàçûâàþùèé ÷òî èçìåíÿåì èçîáðàæåíèå â áóôåðå.

Åñëè ïîñëåäíèé ïàðàìåòð ðàâåí 2 òî ðàçìåð áóôåðà îñòàåòñÿ íåèçìåííûì è ôóíêöèÿ ðàáîòàåò àíàëîãè÷íî òàê êàê è ôóíêöèè buf2d_img_hdiv2, buf2d_img_wdiv2. Ðàçíèöà â òîì, ÷òî buf2d_resize ìîæåò ñæèìàòü èçîáðàæåíèÿ äî çàäàííîãî ðàçìåðà, à íå ðîâíî â 2 ðàçà.

buf2d_line

Ðèñóåò â áóôåðå ëèíèþ ñ çàäàííûì öâåòîì è êîîðäèíàòàìè. Ïðèìåð:

stdcall [buf2d_line], buf_0, 30,10, 110,70, 0xffff00 ;ðèñóåì ëèíèþ

ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ ëèíèÿ; 30, 10, 110, 70 - êîîðäèíàòû ëèíèè; 0xffff00 - öâåò ëèíèè.

Äëÿ ðèñîâàíèÿ ñãëàæåííîé ëèíèè èñïîëüçóéòå buf2d_line_sm.

buf2d_line_sm

Ðèñóåò â áóôåðå ëèíèþ ïðèíèìàåò òàêèæå ïàðàìåòðû êàê è ôóíêöèÿ buf2d_line. Äàííàÿ ôóíêöèÿ ðèñóåò ñãëàæåííóþ ëèíèþ áîëåå êðàñèâóþ ÷åì buf2d_line, íî ðàáîòàåò ìåäëåííåå íå¸ çà ñ÷åò âû÷èñëåíèÿ ñìåøàííûõ öâåòîâ ôîíà è ñàìîé ëèíèè.

buf2d_rect_by_size

Ðèñóåò ïðÿìîóãîëüíóþ ðàìêó, ïî äâóì êîîðäèíàòàì, 2-ÿ êîîðäèíàòà çàäàíà ïî ðàçìåðó. Åñëè ðàçìåðû îòðèöàòåëüíûå ðàìêà ðèñóåòñÿ â îáðàòíîì íàïðàâëåíèè.

stdcall [buf2d_rect_by_size], buf_0, 10,10,150,100, 0x8080

ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ ïðÿìîóãîëüíèê; 10, 10 - êîîðäèíàòû ëåâîãî âåðõíåãî óãëà (ïðè îòðèöàòåëüíûõ ðàçìåðàõ êîîðäèíàòà ïðàâîãî íèæíåãî); 150, 100 - ðàçìåð ïðÿìîóãîëüíèêà; 0x8080 - öâåò ëèíèè.

buf2d_filled_rect_by_size

Ðèñóåò çàêðàøåííûé ïðÿìîóãîëüíèê, ïî äâóì êîîðäèíàòàì, 2-ÿ êîîðäèíàòà çàäàíà ïî ðàçìåðó. Åñëè ðàçìåð çàäàòü 1*1, òî áóäåò íàðèñîâàíà òî÷êà ðàçìåðîì â 1 ïèêñåëü, ò.å. ðàçìåð ïðÿìîóãîëüíèêà â ïèêñåëÿõ áóäåò ðàâåí óêàçàííîìó. Åñëè ðàçìåðû îòðèöàòåëüíûå ïðÿìîóãîëüíèê ðèñóåòñÿ â îáðàòíîì íàïðàâëåíèè.

stdcall [buf2d_rect_by_size], buf_0, 10,10,150,100, 0x8080

ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ ïðÿìîóãîëüíèê; 10, 10 - êîîðäèíàòû ëåâîãî âåðõíåãî óãëà (ïðè îòðèöàòåëüíûõ ðàçìåðàõ êîîðäèíàòà ïðàâîãî íèæíåãî); 150, 100 - ðàçìåð ïðÿìîóãîëüíèêà; 0x8080 - öâåò ïðÿìîóãîëèêà.

buf2d_circle

Ðèñóåò â áóôåðå îêðóæíîñòü ñ çàäàííûì öâåòîì è ðàäèóñîì. Ïðèìåð:

stdcall [buf2d_circle], buf_0, 25, 70, 15, 0xff0000

ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ îêðóæíîñòü; 25, 70 - êîîðäèíàòû öåíòðà; 15 - ðàäèóñ; 0xff0000 - öâåò.

buf2d_img_hdiv2

Ñæèìàåò èçîáðàæåíèå â áóôåðå ïî âûñîòå â 2 ðàçà, ïðè ýòîì ðàçìåð ñàìîãî áóôåðà íå óìåíüøàåòñÿ.

buf2d_img_wdiv2

Ñæèìàåò èçîáðàæåíèå â áóôåðå ïî øèðèíå â 2 ðàçà, ïðè ýòîì ðàçìåð ñàìîãî áóôåðà íå óìåíüøàåòñÿ.

buf2d_conv_24_to_8

Ïðåîáðàçîâàíèå áóôåðà èç 24-áèòíîãî â 8-áèòíûé.

 Ïðè ïðåîáðàçîâàíèè óêàçûâàåòñÿ êàêîé öâåò áåðàòü: 0-ñèíèé, 1-çåëåíûé, 2-êðàñíûé.

 Îñòàëüíûå öâåòà ïðè ïðåîáðàçîâàíèè òåðÿþòñÿ.

buf2d_conv_24_to_32

Ïðåîáðàçîâàíèå áóôåðà èç 24-áèòíîãî â 32-áèòíûé.

 Ïðè ïðåîáðàçîâàíèè óêàçûâàåòñÿ òàêæå 8-áèòíûé áóôåð, êîòîðûé áóäåò èñïîëüçîâàí äëÿ ñîçäàíèÿ àëüôà êàíàëà. Ïðèìåð:

stdcall [buf2d_conv_24_to_32],buf_a,buf_b ;äåëàåì áóôåð rgba 32áèò

Äî âûïîëíåíèÿ ôóíêöèè áóôåð buf_a äîëæåí áûòü 24 áèòíûì, à áóôåð buf_b - 8 áèòíûì.

 Ïîñëå âûïîëíåíèÿ ôóíêöèè áóôåð buf_a ñòàíåò 32 áèòíûì, áóôåð buf_b íå èçìåíèòñÿ.

buf2d_bit_blt

Ðèñóåò â áóôåðå èçîáðàæåíèå èç äðóãîãî áóôåðà â óêàçàííûõ êîîðäèíàòàõ. Áóôåð â êîòîðîì ðèñóò (ïðèåìíèê) äîëæåí áûòü 24 áèòíûì, à òîò êîòîðûé ðèñóåòñÿ (èñòî÷íèê) 24 èëè 32 áèòíûì. Åñëè áóôåð èñòî÷íèê 32 áèòíûé, òî åãî ïðîçðà÷íîñòü ïðè ðèñîâàíèè íå ó÷èòûâàåòñÿ, äëÿ ó÷åòà ïðîçðà÷íîñòè èñïîëüçóåòñÿ ôóíêöèÿ buf2d_bit_blt_transp. Ïðèìåð:

stdcall [buf2d_bit_blt], buf_0, 50,30, buf_1 ;ïðîðèñîâêà ñðåäíåãî ñêèíà

ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ èçîáðàæåíèå (ïðèåìíèê);

  buf_1 - ñòðóêòóðà áóôåðà ñ ðèñóåìûì èçîáðàæåíèåì (èñòî÷íèê);

  50,30 - êîîðäèíàòû äëÿ âûâîäà èçîáðàæåíèÿ, îïðåäåëÿþò ïîëîæåíèå ðèñóåìîé êàðòèíêè â buf_0.

buf2d_bit_blt_transp

Ðèñóåò â áóôåðå èçîáðàæåíèå èç äðóãîãî áóôåðà â óêàçàííûõ êîîðäèíàòàõ, ïðè ýòîì ó÷èòûâàåòñÿ ïðîçðà÷íîñòü.

 Áóôåð êîòîðûé áóäåò íàðèñîâàí äîëæåí áûòü 32 áèòíûì, à òîò â êîòîðîì ðèñóþò 24 áèòíûì.

buf2d_bit_blt_alpha

Ðèñóåò â áóôåðå èçîáðàæåíèå èç äðóãîãî áóôåðà â óêàçàííûõ êîîðäèíàòàõ, ïðè ýòîì ó÷èòûâàåòñÿ ïðîçðà÷íîñòü.

 Áóôåð êîòîðûé áóäåò íàðèñîâàí äîëæåí áûòü 8 áèòíûì, à òîò â êîòîðîì ðèñóþò 24 áèòíûì.

buf2d_curve_bezier

Ðèñóåò ïî òðåì òî÷êàì îòðåçîê êðèâîé áåçüå.

stdcall [buf2d_curve_bezier], buf_0, (10 shl 16)+20,(110 shl 16)+10,(50 shl 16)+90, dword 0xff

ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ êðèâàÿ;

  (10 shl 16)+20,(110 shl 16)+10,(50 shl 16)+90 - êîîðäèíàòû òî÷åê (10,20), (110,10), (50,90);

  0xff - öâåò ïðÿìîé.

buf2d_convert_text_matrix

Ïðåîáðàçóåò ìàòðèöó ñ òåêñòîì ðàçìåðîì 16*16 â ðàçìåð 1*256. Íåîáõîäèìî äëÿ ñîçäàíèÿ ìàòðèöû äëÿ ðèñîâàíèÿ òåêñòà. Ïåðåä èñïîëüçîâàíèåì äàííîé ôóíêöèè ïðåäïîëàãàåòñÿ ÷òî åñòü èçîáðàæåíèå ñ ïîëíûì íàáîðîì ñèìâîëîâ ðàçìåðîì 16 ñòîëáöîâ íà 16 ñòðîê, èç êîòîðîãî ïðåäâàðèòåëüíî áûë ñîçäàí 8 áèòíûé áóôåð.

stdcall [buf2d_create_f_img], buf_1,[image_data] ;ñîçäàåì áóôåð 24 áèò íà îñíîâå äàííûõ èçîáðàæåíèÿ

stdcall [buf2d_conv_24_to_8], buf_1,1 ;äåëàåì áóôåð ïðîçðà÷íîñòè 8 áèò

stdcall [buf2d_convert_text_matrix], buf_1

ãäå buf_1 - ñòðóêòóðà áóôåðà äëÿ ôîðìèðîâàíèÿ òåêñòîâîé ìàòðèöû;

  image_data - äàííûå èçîáðàæåíèÿ òåêñòîâîé ìàòðèöû â ôîðìàòå rgb, ðàçìåðîì 16*16 ñèìâîëîâ.

buf2d_draw_text

Ðèñóåò òåêñò â áóôåðå, èñïîëüçóÿ ìàòðèöó ñ òåêñòîì ðàçìåðîì 1*256 ñèìâîëîâ. Ïðèìåð:

stdcall [buf2d_draw_text], buf_0, buf_1,some_text,20,10,0x4040ff ;ðèñóåì ñòðîêó ñ òåêñòîì

ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ òåêñò;

buf_1 - ñòðóêòóðà áóôåðà ñ òåêñòîâîé ìàòðèöåé â ôîðìàòå 8 áèò, ðàçìåðîì 1*256 ñèìâîëîâ;

some_text - òåêñò, êîòîðûé áóäåò âûâåäåí â áóôåð buf_0.

buf2d_crop_color

Îáðåçàíèå áóôåðà, ïî óêàçàííîìó öâåòó. Ôóíêöèÿ èñïîëüçóåòñÿ äëÿ óìåíüøåíèÿ ïàìÿòè, çàíèìàåìîé áóôåðîì. Îòðåçàþòñÿ êðàéíèå ÷àñòè áóôåðà èìåþùèå îäèíàêîâûé öâåò. Ïðèìåð:

stdcall [buf2d_crop_color], buf_0,0xffffff,BUF2D_OPT_CROP_TOP+BUF2D_OPT_CROP_BOTTOM

ãäå buf_0 - ñòðóêòóðà áóôåðà êîòîðûé áóäåò îáðåçàí;

0xffffff - öâåò ïî êîòîðîìó áóäåò îáðåçàòüñÿ áóôåð;

BUF2D_OPT_CROP_TOP è BUF2D_OPT_CROP_BOTTOM - êîíñòàíòû, óêàçûâàþùèå ñ êàêèõ ñòîðîí îáðåçàòü áóôåð.

buf2d_offset_h

Ñäâèã èçîáðàæåíèÿ â áóôåðå ïî âûñîòå ââåðõ èëè âíèç.

buf2d_flood_fill

Ôóíêöèÿ äëÿ ðåêóðñèâíîé çàëèâêè âûáðàííûì öâåòîì. Èìååòñÿ äâà âàðèàíòà çàëèâêè. Ïðèìåð:

stdcall [buf2d_flood_fill], buf_0, 100,200, 0, 0xff,0xff0000

ãäå buf_0 - ñòðóêòóðà áóôåðà;

100,200 - êîîðäèíàòû òî÷êè, ñ êîòîðîé íà÷íåòñÿ çàëèâêà;

0 - ïàðàìåòð, îïðåäåëÿåò àëãîðèòì çàëèâêè (ìîæåò áûòü 0 èëè 1);

0xff - öâåò çàëèâêè;

0xff0000 - çàâèñèò îò çíà÷åíèÿ 4-ãî ïàðàìåòðà, 1) åñëè 0 - öâåò äî êîòîðîãî áóäåò çàëèâàòüñÿ îáëàñòü; 2) åñëè 1 - öâåò îáëàñòè êîòîðàÿ áóäåò çàëèâàòñÿ;

buf2d_set_pixel

Ôóíêöèÿ ñòàâèò òî÷êó, ïðèíèìàåò êîîðäèíàòû è öâåò. Ïðèìåð:

stdcall [buf2d_set_pixel], buf_0, 100,150, 0xff0000

ãäå buf_0 - ñòðóêòóðà áóôåðà;

100,150 - êîîðäèíàòû òî÷êè;

0xff0000 - öâåò òî÷êè.

buf2d_get_pixel

Ôóíêöèÿ çàïèñûâàåò öâåò òî÷êè â ðåãèñòð eax, ïðèíèìàåò êîîðäèíàòû. Ïðèìåð:

stdcall [buf2d_get_pixel], buf_0, 100,150

ãäå buf_0 - ñòðóêòóðà áóôåðà;

100,150 - êîîðäèíàòû òî÷êè;

eax - öâåò òî÷êè (äëÿ 8 è 24 áèòíûõ áóôåðîâ íå èñïîëüçóåìûå ñòàðøèå áèòû â eax ðàâíû 0) èëè çíà÷åíèå -1 â ñëó÷àå îøèáêè.

buf2d_flip_h

Îòðàæàåò èçîáðàæåíèå â áóôåðå ïî ãîðèçîíòàëè (ëåâî è ïðàâî ìåíÿþòñÿ ìåñòàìè). Ïðèìåð:

stdcall buf2d_flip_h, buf_0

ãäå buf_0 - ñòðóêòóðà 24-õ èëè 32-õ áèòíîãî áóôåðà.

buf2d_flip_v

Îòðàæàåò èçîáðàæåíèå â áóôåðå ïî âåðòèêàëè (âåðõ è íèç ìåíÿþòñÿ ìåñòàìè). Ïðèìåð:

stdcall buf2d_flip_v, buf_0

ãäå buf_0 - ñòðóêòóðà 24-õ èëè 32-õ áèòíîãî áóôåðà.

buf2d_filter_dither

Ôèëüòð, êîòîðûé ïðåîáðàçóåò èçîáðàæåíèå èç 24 áèòíîãî áóôåðà â 8-ìè öâåòíîå. Ðàçðÿäíîñòü áóôåðà íå ìåíÿåòñÿ. Ïðèìåð:

stdcall [buf2d_filter_dither], buf_0, 0

ãäå buf_0 - ñòðóêòóðà 24-õ áèòíîãî áóôåðà;

0 - àëãîðèòì (âîçìîæíûå çíà÷åíèÿ: 0 - Sierra Lite, 1 - Floyd-Steinberg, 2 - Burkers, 3 - Heavyiron_mod, 4 - Atkinson).

buf2d_vox_brush_create

Ñîçäàíèå âîêñåëüíîé êèñòè. Ïðèìåð:

stdcall [buf2d_vox_brush_create], buf_vox, vox_6_7_z

.........

align 4

vox_6_7_z: ;äàííûå äëÿ ñîçäàíèÿ ìèíèìàëüíîãî åäèíè÷íîãî âîêñåëÿ

dd 0,0,1,1,0,0,\

   0,2,2,2,2,0,\

   2,2,2,2,2,2,\

   2,3,2,2,3,2,\

   2,3,3,3,3,2,\

   0,3,3,3,3,0,\

   0,0,3,3,0,0

align 4

buf_vox: ;äàííûå äëÿ ñîçäàíèÿ íàáîðà âîêñåëüíûõ êèñòåé

	db 6,7,4,3 ;w,h,h_osn,n

	rb BUF_STRUCT_SIZE*(3+1)

ãäå vox_6_7_z - äàííûå äëÿ ñîçäàíèÿ ìèíèìàëüíîãî åäèíè÷íîãî âîêñåëÿ (0 - îçíà÷àåò ïðîçðà÷íûé ïèêñåëü, äðóãèå öèôðû îïðåäåëÿþò ãëóáèíó äëÿ çàïîëíåíèÿ áóôåðà ãëóáèíû);

buf_vox - äàííûå äëÿ ñîçäàíèÿ íàáîðà âîêñåëüíûõ êèñòåé (6 è 7 - ðàçìåð ìèíèìàëüíîãî åäèíè÷íîãî âîêñåëÿ, 4 - âûñîòà âåðõíåãî îñíîâàíèÿ ìèíèìàëüíîãî åäèíè÷íîãî âîêñåëÿ, 3 - ÷èñëî ñîçäàâàåìûõ âîêñåëüíûõ êèñòåé äëÿ ðèñîâàíèÿ âîêñåëåé âåðõíèõ óðîâíåé);

buf2d_vox_brush_delete

Óäàëåíèå âîêñåëüíîé êèñòè.

buf2d_vox_obj_draw_1g

Ðèñîâàíèå âîêñåëüíîãî îáúåêòà ñ 1-é ãðàíüþ.

buf2d_vox_obj_get_img_w_3g

Âîçâðàøàåò øèðèíó âîêñåëüíîãî èçîáðàæåíèÿ ñ 3-ìÿ ãðàíÿìè (êîòîðîå ðèñóåòñÿ ôóíêöèåé buf2d_vox_obj_draw_3g), ïðèíèìàåò óêàçàòåëü íà êèñòü è ìàñøòàá.

buf2d_vox_obj_get_img_h_3g

Âîçâðàøàåò âûñîòó âîêñåëüíîãî èçîáðàæåíèÿ ñ 3-ìÿ ãðàíÿìè (êîòîðîå ðèñóåòñÿ ôóíêöèåé buf2d_vox_obj_draw_3g), ïðèíèìàåò óêàçàòåëü íà êèñòü è ìàñøòàá.

buf2d_vox_obj_draw_3g

Ðèñîâàíèå âîêñåëüíîãî îáúåêòà ñ 3-ìÿ ãðàíÿìè.

buf2d_vox_obj_draw_3g_scaled

Ðèñîâàíèå ÷àñòè âîêñåëüíîãî îáúåêòà.

buf2d_vox_obj_draw_3g_shadows

Ôóíêöèÿ ðèñóþùàÿ òåíè äëÿ èçîáðàæåíèé íàðèñîâàííûõ ñ ïîìîùüþ ôóíêöèè buf2d_vox_obj_draw_3g èëè buf2d_vox_obj_draw_3g_scaled.

buf2d_vox_obj_draw_pl

Ôóíêöèÿ ðèñóþùàÿ ñðåç âîêñåëüíîãî îáüåêòà.

buf2d_vox_obj_draw_pl_scaled

Ôóíêöèÿ ðèñóþùàÿ ñðåç ÷àñòè âîêñåëüíîãî îáüåêòà.

Êîíñòàíòû

BUF2D_OPT_CROP_TOP equ 1

Êîíñòàíòà äëÿ ôóíêöèè buf2d_crop_color, îáîçíà÷àåò îáðåçêó áóôåðà ñâåðõó

BUF2D_OPT_CROP_LEFT equ 2

Êîíñòàíòà äëÿ ôóíêöèè buf2d_crop_color, îáîçíà÷àåò îáðåçêó áóôåðà ñëåâà

BUF2D_OPT_CROP_BOTTOM equ 4

Êîíñòàíòà äëÿ ôóíêöèè buf2d_crop_color, îáîçíà÷àåò îáðåçêó áóôåðà ñíèçó

BUF2D_OPT_CROP_RIGHT equ 8

Êîíñòàíòà äëÿ ôóíêöèè buf2d_crop_color, îáîçíà÷àåò îáðåçêó áóôåðà ñïðàâà

Òàáëèöà ýêñïîðòà

Ïðèìåð òàáëèöû ýêñïîðòà, ðàñ÷èòàííîé íà èñïîëüçîâàíèå ìàêðîñà @use_library_mem:

align 4

import_buf2d_lib:

	dd sz_lib_init

	buf2d_create dd sz_buf2d_create

	buf2d_create_f_img dd sz_buf2d_create_f_img

	buf2d_clear dd sz_buf2d_clear

	buf2d_draw dd sz_buf2d_draw

	buf2d_delete dd sz_buf2d_delete

	buf2d_rotate dd sz_buf2d_rotate

	buf2d_resize dd sz_buf2d_resize

	buf2d_line dd sz_buf2d_line

	buf2d_line_sm dd sz_buf2d_line_sm

	buf2d_rect_by_size dd sz_buf2d_rect_by_size

	buf2d_filled_rect_by_size dd sz_buf2d_filled_rect_by_size

	buf2d_circle dd sz_buf2d_circle

	buf2d_img_hdiv2 dd sz_buf2d_img_hdiv2

	buf2d_img_wdiv2 dd sz_buf2d_img_wdiv2

	buf2d_conv_24_to_8 dd sz_buf2d_conv_24_to_8

	buf2d_conv_24_to_32 dd sz_buf2d_conv_24_to_32

	buf2d_bit_blt dd sz_buf2d_bit_blt

	buf2d_bit_blt_transp dd sz_buf2d_bit_blt_transp

	buf2d_bit_blt_alpha dd sz_buf2d_bit_blt_alpha

	buf2d_curve_bezier dd sz_buf2d_curve_bezier

	buf2d_convert_text_matrix dd sz_buf2d_convert_text_matrix

	buf2d_draw_text dd sz_buf2d_draw_text

	buf2d_crop_color dd sz_buf2d_crop_color

	buf2d_offset_h dd sz_buf2d_offset_h

	buf2d_flood_fill dd sz_buf2d_flood_fill

	buf2d_set_pixel dd sz_buf2d_set_pixel

	buf2d_get_pixel dd sz_buf2d_get_pixel

	buf2d_flip_h dd sz_buf2d_flip_h

	buf2d_flip_v dd sz_buf2d_flip_v

	buf2d_filter_dither dd sz_buf2d_filter_dither

	;âîêñåëüíûå ôóíêöèè:

	buf2d_vox_brush_create dd sz_buf2d_vox_brush_create

	buf2d_vox_brush_delete dd sz_buf2d_vox_brush_delete

	buf2d_vox_obj_draw_1g dd sz_buf2d_vox_obj_draw_1g

	buf2d_vox_obj_get_img_w_3g dd sz_buf2d_vox_obj_get_img_w_3g

	buf2d_vox_obj_get_img_h_3g dd sz_buf2d_vox_obj_get_img_h_3g

	buf2d_vox_obj_draw_3g dd sz_buf2d_vox_obj_draw_3g

	buf2d_vox_obj_draw_3g_scaled dd sz_buf2d_vox_obj_draw_3g_scaled

	buf2d_vox_obj_draw_3g_shadows dd sz_buf2d_vox_obj_draw_3g_shadows

	buf2d_vox_obj_draw_pl dd sz_buf2d_vox_obj_draw_pl

	buf2d_vox_obj_draw_pl_scaled dd sz_buf2d_vox_obj_draw_pl_scaled

	dd 0,0

	sz_lib_init db 'lib_init',0

	sz_buf2d_create db 'buf2d_create',0

	sz_buf2d_create_f_img db 'buf2d_create_f_img',0

	sz_buf2d_clear db 'buf2d_clear',0

	sz_buf2d_draw db 'buf2d_draw',0

	sz_buf2d_delete db 'buf2d_delete',0

	sz_buf2d_rotate db 'buf2d_rotate',0

	sz_buf2d_resize db 'buf2d_resize',0

	sz_buf2d_line db 'buf2d_line',0

	sz_buf2d_line_sm db 'buf2d_line_sm',0

	sz_buf2d_rect_by_size db 'buf2d_rect_by_size',0

	sz_buf2d_filled_rect_by_size db 'buf2d_filled_rect_by_size',0

	sz_buf2d_circle db 'buf2d_circle',0

	sz_buf2d_img_hdiv2 db 'buf2d_img_hdiv2',0

	sz_buf2d_img_wdiv2 db 'buf2d_img_wdiv2',0

	sz_buf2d_conv_24_to_8 db 'buf2d_conv_24_to_8',0

	sz_buf2d_conv_24_to_32 db 'buf2d_conv_24_to_32',0

	sz_buf2d_bit_blt db 'buf2d_bit_blt',0

	sz_buf2d_bit_blt_transp db 'buf2d_bit_blt_transp',0

	sz_buf2d_bit_blt_alpha db 'buf2d_bit_blt_alpha',0

	sz_buf2d_curve_bezier db 'buf2d_curve_bezier',0

	sz_buf2d_convert_text_matrix db 'buf2d_convert_text_matrix',0

	sz_buf2d_draw_text db 'buf2d_draw_text',0

	sz_buf2d_crop_color db 'buf2d_crop_color',0

	sz_buf2d_offset_h db 'buf2d_offset_h',0

	sz_buf2d_flood_fill db 'buf2d_flood_fill',0

	sz_buf2d_set_pixel db 'buf2d_set_pixel',0

	sz_buf2d_get_pixel db 'buf2d_get_pixel',0

	sz_buf2d_flip_h db 'buf2d_flip_h',0

	sz_buf2d_flip_v db 'buf2d_flip_v',0

	sz_buf2d_filter_dither db 'buf2d_filter_dither',0

	;âîêñåëüíûå ôóíêöèè:

	sz_buf2d_vox_brush_create db 'buf2d_vox_brush_create',0

	sz_buf2d_vox_brush_delete db 'buf2d_vox_brush_delete',0

	sz_buf2d_vox_obj_draw_1g db 'buf2d_vox_obj_draw_1g',0

	sz_buf2d_vox_obj_get_img_w_3g db 'buf2d_vox_obj_get_img_w_3g',0

	sz_buf2d_vox_obj_get_img_h_3g db 'buf2d_vox_obj_get_img_h_3g',0

	sz_buf2d_vox_obj_draw_3g db 'buf2d_vox_obj_draw_3g',0

	sz_buf2d_vox_obj_draw_3g_scaled db 'buf2d_vox_obj_draw_3g_scaled',0

	sz_buf2d_vox_obj_draw_3g_shadows db 'buf2d_vox_obj_draw_3g_shadows',0

	sz_buf2d_vox_obj_draw_pl db 'buf2d_vox_obj_draw_pl',0

	sz_buf2d_vox_obj_draw_pl_scaled db 'buf2d_vox_obj_draw_pl_scaled',0

Èñòîðèÿ

02.07.10 - ñàìàÿ ïåðâàÿ âåðñèÿ áèáëèîòåêè, 2 ïðèìåðà èñïîëüçîâàíèÿ.

06.07.10 - ðàñøèðåíû âîçìîæíîñòè ôóíêöèè buf2d_bit_blt, òåïåðü îíà ìîæåò ðèñîâàòü 32 áèòíûå áóôåðû. Äîáàâëåíû 2 íîâûå ôóíêöèè: buf2d_bit_blt_alpha è buf2d_cruve_bezier. Íåáîëüøèå èçìåíåíèÿ â ôóíêöèè buf2d_line.

16.07.10 - èñïðàâëåíî ïî 2 îøèáêè â ôóíêöèÿõ buf2d_img_hdiv2 è buf2d_img_wdiv2, êîòîðûå ìîãëè ïðîÿâëÿòüñÿ ïðè îïðåäåëåííûõ óñëîâèÿõ (åñëè ðàçìåð èçîáðàæåíèÿ áûë êðàòåí 4Êá è äð.). Äîáàâëåíû 2 ôóíêöèè äëÿ âûâîäà òåêñòà â áóôåð buf2d_convert_text_matrix è buf2d_draw_text.

19.07.10 - äîáàâëåíà ôóíêöèÿ ðèñîâàíèÿ îêðóæíîñòè buf2d_circle;

 èçìåíåí ôîðìàò áóôåðà - äëÿ øèðèíû è âûñîòû èñïîëüçóþòñÿ 4-õ áàéòíûå ÷èñëà âìåñòî 2-õ áàéòíûõ.

29.07.10 - äîáàâëåíû ôóíêöèè buf2d_crop_color è buf2d_offset_h;

 èñïðàâëåíèÿ â ôóíêöèè buf2d_delete.

30.09.10 - äîáàâëåíà ôóíêöèÿ buf2d_rect_by_size.

04.10.10 - äîáàâëåíà ôóíêöèÿ buf2d_filled_rect_by_size, äîðàáîòàíà ôóíêöèÿ buf2d_bit_blt_alpha.

07.10.10 - äîðàáîòàíà ôóíêöèÿ buf2d_bit_blt (ïðè ïîïûòêå íàðèñîâàòü èçîáðàæåíèå çà ïðåäåëàìè ïðàâîãî êðàÿ áóôåðà ïðèëîæåíèå âûçâàâøåå ôóíêöèþ ïàäàëî).

11.10.10 - èñïðàâëåíî çàäàíèå öâåòîâ â íåêîòîðûõ ôóíêöèÿõ, êðàñíûé è ñèíèé öâåòà ïîìåíÿë ìåñòàìè. Òåïåðü öâåòà ñîâïàäàþò ñ ñèñåìíûìè ôóíêöèÿìè.

02.11.10 - äîáàâëåíà ôóíêöèÿ buf2d_flood_fill.

22.12.10 - èçìåíåíî èìÿ ôóíêöèè buf2d_cruve_bezier íà buf2d_curve_bezier.

25.03.11 - äîáàâëåíà ôóíêöèÿ äëÿ ðèñîâàíèÿ òî÷êè buf2d_set_pixel.

30.08.11 - äîáàâëåíà ôóíêöèÿ èçìåíåíèÿ ðàçìåðîâ áóôåðà buf2d_resize.

13.09.11 - îïòèìèçèðîâàíà ðàáîòà ôóíêöèé buf2d_filled_rect_by_size buf2d_rect_by_size, äîáàâëåíû ïðèìåðû èñïîëüçîâàíèÿ áèáëèîòåêè.

22.09.11 - äîáàâëåíà ôóíêöèÿ buf2d_line_sm äëÿ ðèñîâàíèÿ ñãëàæåííîé ëèíèè.

20.02.12 - ôóíêöèè buf2d_filled_rect_by_size è buf2d_rect_by_size ìîãóò ïðèíèìàòü îòðèöàòåëüíûå ðàçìåðû äëÿ ïðÿìîóãîëüíèêîâ, â ôóíêöèè buf2d_line ãîðèçîíòàëüíàÿ ëèíèÿ ðèñóåòñÿ íà 1 ïèêñåëü äëèíåå (ðàíüøå íå äîðèñîâûâàëî), íåêîòîðûå ôóíêöèè ìîãóò ðèñîâàòü â 8 áèòíûõ áóôåðàõ.

23.02.12 - ôóíêöèÿ buf2d_bit_blt_alpha ìîæåò ïðèíèìàòü îòðèöàòåëüíûå êîîðäèíàòû â ïîçèöèè êîïèðóåìîãî áóôåðà, íåáîëüøèå äîðàáîòêè â buf2d_bit_blt_transp

11.05.12 - äîáàâëåíà ôóíêöèÿ äëÿ âçÿòèÿ öâåòà òî÷êè buf2d_get_pixel, äîðàáîòêè â buf2d_set_pixel.

12.06.12 - äîáàâëåíû ôóíêöèè äëÿ ðèñîâàíèÿ âîêñåëüíîé ãðàôèêè.

11.08.12 - ôóíêöèè äëÿ ñæàòèÿ èçîáðàæåíèé buf2d_img_hdiv2 è buf2d_img_wdiv2 ðàáîòàþò ñ 32 áèòíûìè áóôåðàìè.

01.10.12 - äîáàâëåíà ôóíêöèÿ ïîâîðîòà èçîáðàæåíèé íà 90 è 180 ãðàäóñîâ buf2d_rotate.

15.11.12 - äîáàâëåíà ôóíêöèÿ îòðàæåíèÿ 24 áèòíûõ èçîáðàæåíèé ïî âåðòèêàëè buf2d_flip_v, èñïðàâëåíèÿ â ôóíêöèè buf2d_img_hdiv2.

14.12.12 - äîáàâëåíà ôóíêöèÿ íàëîæåíèÿ ôèëüòðà buf2d_filter_dither.

24.12.12 - äîáàâëåíû 2 íîâûõ àëãîðèòìà â ôóíêöèþ íàëîæåíèÿ ôèëüòðà buf2d_filter_dither.

30.01.15 - äîáàâëåíà ïîääåðæêà 32 áèòíûõ áóôåðîâ â ôóíêöèþ buf2d_flip_v, äîáàâëåíà ôóíêöèÿ îòðàæåíèÿ ïî ãîðèçîíòàëè buf2d_flip_h.

09.02.16 - èçìåíåíà ôóíêöèÿ buf2d_resize äîáàâëåí äîïîëíèòåëüíûé ïàðàìåòð, êîòîðûé óêàçûâàåò ìåíÿòü ëè èçîáðàæåíèå èëè ðàçìåðû áóôåðà.

04.05.20 - ôóíêöèÿ buf2d_bit_blt ìîæåò ïðèíèìàòü îòðèöàòåëüíûå êîîðäèíàòû â ïîçèöèè êîïèðóåìîãî áóôåðà.