Subversion Repositories Kolibri OS

Rev

Rev 2975 | Rev 3105 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

  1. <html>
  2. <head>
  3. <title>áèáëèîòåêà äëÿ ðàáîòû ñ 2d áóôåðàìè</title>
  4. <meta http-equiv="content-type" content="text/html; charset=WINDOWS-1251">
  5. <style>
  6. body
  7. {
  8.   font-size: 15px;
  9.   font-family: "Bookman Old Style";
  10.   color: black;
  11.   text-align: justify;
  12. }
  13. h1 { color: green; font-size: 23px; }
  14. h2 { color: green; font-size: 21px; }
  15. h3 { color: green; font-size: 19px; }
  16. h4 { color: #803f00; font-size: 17px; }
  17. i { color: #0099cc; }
  18. b { color: #0099cc; }
  19. p {
  20.   text-indent: 1em;
  21.   margin-top: 3px;
  22.   margin-bottom: 2px;
  23.   margin-left: 0px;
  24.   margin-right: 0px;
  25. }
  26. ol, ul, dl{
  27.   margin-top: 3px;
  28.   margin-bottom: 2px;
  29. }
  30. pre
  31. {
  32.   padding: 2px;
  33.   padding-left: 20px;
  34.   margin-top: 5px;
  35.   margin-bottom: 5px;
  36.   margin-left: 0px;
  37.   margin-right: 0px;
  38.   font-family: "Courier New";
  39.   font-size: 15px;
  40.   color: #004000;
  41.   background-color: #ffd0ff;
  42. }
  43. table { font-size: 15px; }
  44. </style>
  45. </head>
  46.  
  47. <body>
  48.  
  49. <h1>Îãëàâëåíèå</h1>
  50. <ul>
  51. <li>Âñòóïëåíèå</li>
  52. <li><a href="#format_buf">Ôîðìàòû áóôåðîâ</a></li>
  53. <li><a href="#fun">Ôóíêöèè</a><br>
  54. <ul>
  55. <li><a href="#f_init">lib_init</a></li>
  56. <li><a href="#f_b_create">buf2d_create</a></li>
  57. <li><a href="#f_b_create_f">buf2d_create_f_img</a></li>
  58. <li><a href="#f_b_clear">buf2d_clear</a></li>
  59. <li><a href="#f_b_draw">buf2d_draw</a></li>
  60. <li><a href="#f_b_delete">buf2d_delete</a></li>
  61. <li><a href="#f_b_rotate">buf2d_rotate</a></li>
  62. <li><a href="#f_b_hdiv2">buf2d_img_hdiv2</a></li>
  63. <li><a href="#f_b_wdiv2">buf2d_img_wdiv2</a></li>
  64. <li><a href="#f_c_color">buf2d_crop_color</a></li>
  65. <li><a href="#f_flip_v">buf2d_flip_v</a></li>
  66.  
  67. <li><a href="#f_v_brush_c">buf2d_vox_brush_create</a></li>
  68. </ul>
  69. </li>
  70. <li><a href="#const">Êîíñòàíòû</a></li>
  71. <li><a href="#tabl_e">Òàáëèöà ýêñïîðòà</a></li>
  72. <li><a href="#hist">Èñòîðèÿ</a></li>
  73. </ul>
  74.  
  75. <h1>Âñòóïëåíèå</h1>
  76. <p>Äîêóìåíòàöèÿ ê ñâîáîäíîé áèáëèîòåêå <b>buf2d.asm</b>, äëÿ <b>ÎÑ Êîëèáðè</b>.
  77.  Ýòà áèáëèîòåêà ñîçäàíà äëÿ ðàáîòû ñ 2d èçîáðàæåíèÿìè.
  78.  Ñ åå ïîìîùüþ ìîæíî ñîçäàâàòü áóôåðà ñ èçîáðàæåíèÿìè â ïàìÿòè, è ïðè íåîáõîäèìîñòè âûâîäèòü èõ íà ýêðàí.
  79.  Èçîáðàæåíèÿ ìîæíî íàêëàäûâàòü îäíî íà äðóãîå, ïîääåðæèâàåòñÿ ðàáîòà ñ ïðîçðà÷íûìè èçîáðàæåíèÿìè.
  80.  Åñòü ôóíêöèè ðèñîâàíèÿ ëèíèé, êðèâûõ Áåçüå, ïðÿìîóãîëüíèêîâ, îêðóæíîñòåé.
  81.  Òàêæå åñòü ôóíêöèè äëÿ ðèñîâàíèé âîêñåëüíîé ãðàôèêè.</p>
  82.  
  83. <p>Ïîñëåäíåå îáíîâëåíèå áèáëèîòåêè 15.11.12.</p>
  84.  
  85. <h1><a name="format_buf">Ôîðìàòû áóôåðîâ</a></h1>
  86. <p>Ïîääåðæèâàåòñÿ 3 ôîðìàòà áóôåðîâ.
  87.  Êàæäàÿ ôóíêöèÿ ïðè ðàáîòå ñ áóôåðàìè ìîæåò áûòü ðàñ÷èòàíà íà ðàáîòó ñ îïðåäåëåííûìè ôîðìàòàìè èçîáðàæåíèé.</p>
  88.  
  89. <h4>8 áèò</h4>
  90. <p>Ñîæåðæèò àëüôà êàíàë <b>a</b> (ïðîçðà÷íîñòü) èçîáðàæåíèÿ. Íà ýêðàí íå âûâîäèòñÿ. Èñïîëüçóåòñÿ äëÿ ñîçäàíÿ 32-áèòíûõ áóôåðîâ.</p>
  91. <h4>24 áèò</h4>
  92. <p>Äàííûé áóôåð ñîäåðæèò èçîáðàæåíèå â ôîðìàòå <b>rgb</b>. Ìîæåò âûâîäèòñÿ íà ýêðàí.</p>
  93. <h4>32 áèò</h4>
  94. <p>Ñîäåðæèò ïðîçðà÷íîå èçîáðàæåíèå â ôîðìàòå <b>rgba</b>. Íà ýêðàí íå âûâîäèòñÿ. Èñïîëüçóåòñÿ äëÿ íàëîæåíèÿ èçîáðàæåíèé. Åñëè <b>a=255</b> òî ïèêñåëü ïðîçðà÷íûé, åñëè <b>0</b> íå ïðîçðà÷íûé.</p>
  95.  
  96. <h1><a name="fun">Ôóíêöèè</a></h1>
  97.  
  98. <p>Ïî÷òè âñå ôóíêöèè 1-ì ïàðàìåòðîì ïðèíèìàþò óêàçàòåëü íà ñòðóêòóðó áóôåðà,
  99.  èç êîòîðîé ìîãóò èñïîëüçîâàòüñÿ ïàðàìåòðû, íóæíûå äëÿ ðàáîòû êîíêðåòíîé ôóíêöèè.
  100.  Ïðèìåð ñòðóêòóðû áóôåðà èçîáðàæåíèÿ:</p>
  101. <pre>align 4
  102. buf_0:
  103.         dd    0 ;+ 0 óêàçàòåëü íà áóôåð èçîáðàæåíèÿ
  104.         dw  100 ;+ 4 îòñòóï ñëåâà
  105.         dw   10 ;+ 6 îòñòóï ñïðàâà
  106.         dd  150 ;+ 8 øèðèíà
  107.         dd  100 ;+12 âûñîòà
  108.         dd 0x80 ;+16 ôîíîâûé öâåò
  109.         db   24 ;+20 áèò íà ïèêñåëü</pre>
  110.  
  111. <h4><a name="f_init">lib_init</a></h4>
  112. <p>Ýòà ôóíêöèÿ ïîëó÷àåò óêàçàòåëè íà ôóíêöèè ðàáîòû ñ ïàìÿòüþ, âûçûâàòñÿ äîëæíà ïðè çàãðóçêå áèáëèîòåêè. Ìîæåòå èñïîëüçîâàòü ìàêðîñ <b>@use_library_mem</b>, äëÿ åå àâòîìàòè÷åñêîé íàñòðîéêè.</p>
  113.  
  114. <h4><a name="f_b_create">buf2d_create</a></h4>
  115. <p>Ñîçäàåò áóôåð è ÷èñòèò åãî ôîíîâûì öâåòîì. Ïðèìåð:</p>
  116. <pre>stdcall [buf2d_create], buf_0</pre>
  117. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà.</p>
  118. <p>Ïàðàìåòðû äëÿ ñîçäàíèÿ áóôåðà áåðóòñÿ èç ñòðóêòóðû.</p>
  119.  
  120. <h4><a name="f_b_create_f">buf2d_create_f_img</a></h4>
  121. <p>Ñîçäàåò áóôåð íà îñíîâå èçîáðàæåíèÿ â ôîðìàòå <b>rgb</b>.</p>
  122.  
  123. <h4><a name="f_b_clear">buf2d_clear</a></h4>
  124. <p>×èñòèò áóôåð óêàçàíûì öâåòîì. Ïðèìåð:</p>
  125. <pre>buf2d_color equ dword[edi+16] ;öâåò ôîíà áóôåðà
  126. mov edi,buf_0
  127. stdcall [buf2d_clear], edi, buf2d_color ;î÷èùàåì ýêðàí ôîíîâûì öâåòîì</pre>
  128. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà.</p>
  129.  
  130. <h4><a name="f_b_draw">buf2d_draw</a></h4>
  131. <p>Ðèñóåò áóôåð íà ýêðàíå (ðàáîòàåò ÷åðåç ñèñòåìíóþ ô. 7). Ðèñóþòñÿ òîëüêî áóôåðà ñ ãëóáèíîé öâåòà 24 áèòà.</p>
  132.  
  133. <h4><a name="f_b_delete">buf2d_delete</a></h4>
  134. <p>Îñâîáîæäàåò ïàìÿòü çàíÿòóþ èçîáðàæåíèåì áóôåðà.</p>
  135.  
  136. <h4><a name="f_b_rotate">buf2d_rotate</a></h4>
  137. <p>Ïîâîðà÷èâàåò áóôåð íà 90 èëè 180 ãðàäóñîâ. Ïðèìåð:</p>
  138. <pre>stdcall [buf2d_rotate], buf_0, 90</pre>
  139. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà (ìîæåò áûòü 8, 24 èëè 32 áèòíûì); 90 - óãîë ïîâîðîòà.</p>
  140.  
  141. <h4>buf2d_resize</h4>
  142. <p>Èçìåíÿåò ðàçìåðû áóôåðà. Ïîêà ïîääåðæèâàþòñÿ áóôåðà ñ ãëóáèíîé öâåòà 24 áèòà. Ïðèìåð:</p>
  143. <pre>stdcall [buf2d_resize], buf_0, 0,300 ;èçìåíÿåì âûñîòó áóôåðà</pre>
  144. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ ëèíèÿ; 0 - íîâàÿ øèðèíà áóôåðà (0 îçíà÷àåò íå èçìåíÿòü ðàçìåð); 300 - íîâàÿ âûñîòà áóôåðà.</p>
  145.  
  146. <h4>buf2d_line</h4>
  147. <p>Ðèñóåò â áóôåðå ëèíèþ ñ çàäàííûì öâåòîì è êîîðäèíàòàìè. Ïðèìåð:</p>
  148. <pre>stdcall [buf2d_line], buf_0, 30,10, 110,70, 0xffff00 ;ðèñóåì ëèíèþ</pre>
  149. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ ëèíèÿ; 30, 10, 110, 70 - êîîðäèíàòû ëèíèè; 0xffff00 - öâåò ëèíèè.</p>
  150. <p>Äëÿ ðèñîâàíèÿ ñãëàæåííîé ëèíèè èñïîëüçóéòå <b>buf2d_line_sm</b>.</p>
  151.  
  152. <h4>buf2d_line_sm</h4>
  153. <p>Ðèñóåò â áóôåðå ëèíèþ ïðèíèìàåò òàêèæå ïàðàìåòðû êàê è ôóíêöèÿ <b>buf2d_line</b>. Äàííàÿ ôóíêöèÿ ðèñóåò ñãëàæåííóþ ëèíèþ áîëåå êðàñèâóþ ÷åì <b>buf2d_line</b>, íî ðàáîòàåò ìåäëåííåå íå¸ çà ñ÷åò âû÷èñëåíèÿ ñìåøàííûõ öâåòîâ ôîíà è ñàìîé ëèíèè.</p>
  154.  
  155. <h4>buf2d_rect_by_size</h4>
  156. <p>Ðèñóåò ïðÿìîóãîëüíóþ ðàìêó, ïî äâóì êîîðäèíàòàì, 2-ÿ êîîðäèíàòà çàäàíà ïî ðàçìåðó. Åñëè ðàçìåðû îòðèöàòåëüíûå ðàìêà ðèñóåòñÿ â îáðàòíîì íàïðàâëåíèè.</p>
  157. <pre>stdcall [buf2d_rect_by_size], buf_0, 10,10,150,100, 0x8080</pre>
  158. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ ïðÿìîóãîëüíèê; 10, 10 - êîîðäèíàòû ëåâîãî âåðõíåãî óãëà (ïðè îòðèöàòåëüíûõ ðàçìåðàõ êîîðäèíàòà ïðàâîãî íèæíåãî); 150, 100 - ðàçìåð ïðÿìîóãîëüíèêà; 0x8080 - öâåò ëèíèè.</p>
  159.  
  160. <h4>buf2d_filled_rect_by_size</h4>
  161. <p>Ðèñóåò çàêðàøåííûé ïðÿìîóãîëüíèê, ïî äâóì êîîðäèíàòàì, 2-ÿ êîîðäèíàòà çàäàíà ïî ðàçìåðó. Åñëè ðàçìåð çàäàòü 1*1, òî áóäåò íàðèñîâàíà òî÷êà ðàçìåðîì â 1 ïèêñåëü, ò.å. ðàçìåð ïðÿìîóãîëüíèêà â ïèêñåëÿõ áóäåò ðàâåí óêàçàííîìó. Åñëè ðàçìåðû îòðèöàòåëüíûå ïðÿìîóãîëüíèê ðèñóåòñÿ â îáðàòíîì íàïðàâëåíèè.</p>
  162. <pre>stdcall [buf2d_rect_by_size], buf_0, 10,10,150,100, 0x8080</pre>
  163. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ ïðÿìîóãîëüíèê; 10, 10 - êîîðäèíàòû ëåâîãî âåðõíåãî óãëà (ïðè îòðèöàòåëüíûõ ðàçìåðàõ êîîðäèíàòà ïðàâîãî íèæíåãî); 150, 100 - ðàçìåð ïðÿìîóãîëüíèêà; 0x8080 - öâåò ïðÿìîóãîëèêà.</p>
  164.  
  165. <h4>buf2d_circle</h4>
  166. <p>Ðèñóåò â áóôåðå îêðóæíîñòü ñ çàäàííûì öâåòîì è ðàäèóñîì. Ïðèìåð:</p>
  167. <pre>stdcall [buf2d_circle], buf_0, 25, 70, 15, 0xff0000</pre>
  168. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ îêðóæíîñòü; 25, 70 - êîîðäèíàòû öåíòðà; 15 - ðàäèóñ; 0xff0000 - öâåò.</p>
  169.  
  170. <h4><a name="f_b_hdiv2">buf2d_img_hdiv2</a></h4>
  171. <p>Ñæèìàåò èçîáðàæåíèå â áóôåðå ïî âûñîòå â 2 ðàçà, ïðè ýòîì ðàçìåð ñàìîãî áóôåðà íå óìåíüøàåòñÿ.</p>
  172.  
  173. <h4><a name="f_b_wdiv2">buf2d_img_wdiv2</a></h4>
  174. <p>Ñæèìàåò èçîáðàæåíèå â áóôåðå ïî øèðèíå â 2 ðàçà, ïðè ýòîì ðàçìåð ñàìîãî áóôåðà íå óìåíüøàåòñÿ.</p>
  175.  
  176. <h4>buf2d_conv_24_to_8</h4>
  177. <p>Ïðåîáðàçîâàíèå áóôåðà èç 24-áèòíîãî â 8-áèòíûé.
  178.  Ïðè ïðåîáðàçîâàíèè óêàçûâàåòñÿ êàêîé öâåò áåðàòü: 0-ñèíèé, 1-çåëåíûé, 2-êðàñíûé.
  179.  Îñòàëüíûå öâåòà ïðè ïðåîáðàçîâàíèè òåðÿþòñÿ.</p>
  180.  
  181. <h4>buf2d_conv_24_to_32</h4>
  182. <p>Ïðåîáðàçîâàíèå áóôåðà èç 24-áèòíîãî â 32-áèòíûé.
  183.  Ïðè ïðåîáðàçîâàíèè óêàçûâàåòñÿ òàêæå 8-áèòíûé áóôåð, êîòîðûé áóäåò èñïîëüçîâàí äëÿ ñîçäàíèÿ àëüôà êàíàëà. Ïðèìåð:</p>
  184. <pre>stdcall [buf2d_conv_24_to_32],buf_a,buf_b ;äåëàåì áóôåð rgba 32áèò</pre>
  185. <p>Äî âûïîëíåíèÿ ôóíêöèè áóôåð buf_a äîëæåí áûòü 24 áèòíûì, à áóôåð buf_b - 8 áèòíûì.
  186.  Ïîñëå âûïîëíåíèÿ ôóíêöèè áóôåð buf_a ñòàíåò 32 áèòíûì, áóôåð buf_b íå èçìåíèòñÿ.</p>
  187.  
  188. <h4>buf2d_bit_blt</h4>
  189. <p>Ðèñóåò â áóôåðå èçîáðàæåíèå èç äðóãîãî áóôåðà â óêàçàííûõ êîîðäèíàòàõ. Áóôåð â êîòîðîì ðèñóò (ïðèåìíèê) äîëæåí áûòü 24 áèòíûì, à òîò êîòîðûé ðèñóåòñÿ (èñòî÷íèê) 24 èëè 32 áèòíûì. Åñëè áóôåð èñòî÷íèê 32 áèòíûé, òî åãî ïðîçðà÷íîñòü ïðè ðèñîâàíèè íå ó÷èòûâàåòñÿ, äëÿ ó÷åòà ïðîçðà÷íîñòè èñïîëüçóåòñÿ ôóíêöèÿ <i>buf2d_bit_blt_transp</i>. Ïðèìåð:</p>
  190. <pre>stdcall [buf2d_bit_blt], buf_0, 50,30, buf_1 ;ïðîðèñîâêà ñðåäíåãî ñêèíà</pre>
  191. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ èçîáðàæåíèå (ïðèåìíèê);
  192.   buf_1 - ñòðóêòóðà áóôåðà ñ ðèñóåìûì èçîáðàæåíèåì (èñòî÷íèê);
  193.   50,30 - êîîðäèíàòû äëÿ âûâîäà èçîáðàæåíèÿ, îïðåäåëÿþò ïîëîæåíèå ðèñóåìîé êàðòèíêè â buf_0.</p>
  194.  
  195. <h4>buf2d_bit_blt_transp</h4>
  196. <p>Ðèñóåò â áóôåðå èçîáðàæåíèå èç äðóãîãî áóôåðà â óêàçàííûõ êîîðäèíàòàõ, ïðè ýòîì ó÷èòûâàåòñÿ ïðîçðà÷íîñòü.
  197.  Áóôåð êîòîðûé áóäåò íàðèñîâàí äîëæåí áûòü 32 áèòíûì, à òîò â êîòîðîì ðèñóþò 24 áèòíûì.</p>
  198.  
  199. <h4>buf2d_bit_blt_alpha</h4>
  200. <p>Ðèñóåò â áóôåðå èçîáðàæåíèå èç äðóãîãî áóôåðà â óêàçàííûõ êîîðäèíàòàõ, ïðè ýòîì ó÷èòûâàåòñÿ ïðîçðà÷íîñòü.
  201.  Áóôåð êîòîðûé áóäåò íàðèñîâàí äîëæåí áûòü 8 áèòíûì, à òîò â êîòîðîì ðèñóþò 24 áèòíûì.</p>
  202.  
  203. <h4>buf2d_curve_bezier</h4>
  204. <p>Ðèñóåò ïî òðåì òî÷êàì îòðåçîê êðèâîé áåçüå.</p>
  205. <pre>stdcall [buf2d_curve_bezier], buf_0, (10 shl 16)+20,(110 shl 16)+10,(50 shl 16)+90, dword 0xff</pre>
  206. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ êðèâàÿ;
  207.   (10 shl 16)+20,(110 shl 16)+10,(50 shl 16)+90 - êîîðäèíàòû òî÷åê (10,20), (110,10), (50,90);
  208.   0xff - öâåò ïðÿìîé.</p>
  209.  
  210. <h4>buf2d_convert_text_matrix</h4>
  211. <p>Ïðåîáðàçóåò ìàòðèöó ñ òåêñòîì ðàçìåðîì 16*16 â ðàçìåð 1*256. Íåîáõîäèìî äëÿ ñîçäàíèÿ ìàòðèöû äëÿ ðèñîâàíèÿ òåêñòà. Ïåðåä èñïîëüçîâàíèåì äàííîé ôóíêöèè ïðåäïîëàãàåòñÿ ÷òî åñòü èçîáðàæåíèå ñ ïîëíûì íàáîðîì ñèìâîëîâ ðàçìåðîì 16 ñòîëáöîâ íà 16 ñòðîê, èç êîòîðîãî ïðåäâàðèòåëüíî áûë ñîçäàí 8 áèòíûé áóôåð.</p>
  212. <pre>stdcall [buf2d_create_f_img], buf_1,[image_data] ;ñîçäàåì áóôåð 24 áèò íà îñíîâå äàííûõ èçîáðàæåíèÿ
  213. stdcall [buf2d_conv_24_to_8], buf_1,1 ;äåëàåì áóôåð ïðîçðà÷íîñòè 8 áèò
  214. stdcall [buf2d_convert_text_matrix], buf_1</pre>
  215. <p>ãäå buf_1 - ñòðóêòóðà áóôåðà äëÿ ôîðìèðîâàíèÿ òåêñòîâîé ìàòðèöû;
  216.   image_data - äàííûå èçîáðàæåíèÿ òåêñòîâîé ìàòðèöû â ôîðìàòå rgb, ðàçìåðîì 16*16 ñèìâîëîâ.</p>
  217.  
  218. <h4>buf2d_draw_text</h4>
  219. <p>Ðèñóåò òåêñò â áóôåðå, èñïîëüçóÿ ìàòðèöó ñ òåêñòîì ðàçìåðîì 1*256 ñèìâîëîâ. Ïðèìåð:</p>
  220. <pre>stdcall [buf2d_draw_text], buf_0, buf_1,some_text,20,10,0x4040ff ;ðèñóåì ñòðîêó ñ òåêñòîì</pre>
  221. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà â êîòîðîì áóäåò ðèñîâàòüñÿ òåêñò;</p>
  222. <p>buf_1 - ñòðóêòóðà áóôåðà ñ òåêñòîâîé ìàòðèöåé â ôîðìàòå 8 áèò, ðàçìåðîì 1*256 ñèìâîëîâ;</p>
  223. <p>some_text - òåêñò, êîòîðûé áóäåò âûâåäåí â áóôåð buf_0.</p>
  224.  
  225. <h4><a name="f_c_color">buf2d_crop_color</a></h4>
  226. <p>Îáðåçàíèå áóôåðà, ïî óêàçàííîìó öâåòó. Ôóíêöèÿ èñïîëüçóåòñÿ äëÿ óìåíüøåíèÿ ïàìÿòè, çàíèìàåìîé áóôåðîì. Îòðåçàþòñÿ êðàéíèå ÷àñòè áóôåðà èìåþùèå îäèíàêîâûé öâåò. Ïðèìåð:</p>
  227. <pre>stdcall [buf2d_crop_color], buf_0,0xffffff,BUF2D_OPT_CROP_TOP+BUF2D_OPT_CROP_BOTTOM</pre>
  228. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà êîòîðûé áóäåò îáðåçàí;</p>
  229. <p>0xffffff - öâåò ïî êîòîðîìó áóäåò îáðåçàòüñÿ áóôåð;</p>
  230. <p>BUF2D_OPT_CROP_TOP è BUF2D_OPT_CROP_BOTTOM - êîíñòàíòû, óêàçûâàþùèå ñ êàêèõ ñòîðîí îáðåçàòü áóôåð.</p>
  231.  
  232. <h4>buf2d_offset_h</h4>
  233. <p>Ñäâèã èçîáðàæåíèÿ â áóôåðå ïî âûñîòå ââåðõ èëè âíèç.</p>
  234.  
  235. <h4>buf2d_flood_fill</h4>
  236. <p>Ôóíêöèÿ äëÿ ðåêóðñèâíîé çàëèâêè âûáðàííûì öâåòîì. Èìååòñÿ äâà âàðèàíòà çàëèâêè. Ïðèìåð:</p>
  237. <pre>stdcall [buf2d_flood_fill], buf_0, 100,200, 0, 0xff,0xff0000</pre>
  238. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà;</p>
  239. <p>100,200 - êîîðäèíàòû òî÷êè, ñ êîòîðîé íà÷íåòñÿ çàëèâêà;</p>
  240. <p>0 - ïàðàìåòð, îïðåäåëÿåò àëãîðèòì çàëèâêè (ìîæåò áûòü 0 èëè 1);</p>
  241. <p>0xff - öâåò çàëèâêè;</p>
  242. <p>0xff0000 - çàâèñèò îò çíà÷åíèÿ 4-ãî ïàðàìåòðà, 1) åñëè 0 - öâåò äî êîòîðîãî áóäåò çàëèâàòüñÿ îáëàñòü; 2) åñëè 1 - öâåò îáëàñòè êîòîðàÿ áóäåò çàëèâàòñÿ;</p>
  243.  
  244. <h4>buf2d_set_pixel</h4>
  245. <p>Ôóíêöèÿ ñòàâèò òî÷êó, ïðèíèìàåò êîîðäèíàòû è öâåò. Ïðèìåð:</p>
  246. <pre>stdcall [buf2d_set_pixel], buf_0, 100,150, 0xff0000</pre>
  247. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà;</p>
  248. <p>100,150 - êîîðäèíàòû òî÷êè;</p>
  249. <p>0xff0000 - öâåò òî÷êè.</p>
  250.  
  251. <h4>buf2d_get_pixel</h4>
  252. <p>Ôóíêöèÿ çàïèñûâàåò öâåò òî÷êè â ðåãèñòð eax, ïðèíèìàåò êîîðäèíàòû. Ïðèìåð:</p>
  253. <pre>stdcall [buf2d_get_pixel], buf_0, 100,150</pre>
  254. <p>ãäå buf_0 - ñòðóêòóðà áóôåðà;</p>
  255. <p>100,150 - êîîðäèíàòû òî÷êè;</p>
  256. <p>eax - öâåò òî÷êè (äëÿ 8 è 24 áèòíûõ áóôåðîâ íå èñïîëüçóåìûå ñòàðøèå áèòû â eax ðàâíû 0) èëè çíà÷åíèå -1 â ñëó÷àå îøèáêè.</p>
  257.  
  258. <h4><a name="f_flip_v">buf2d_flip_v</a></h4>
  259. <p>Îòðàæàåò èçîáðàæåíèå â áóôåðå ïî âåðòèêàëè (âåðõ è íèç ìåíÿþòñÿ ìåñòàìè). Ïðèìåð:</p>
  260. <pre>stdcall buf2d_flip_v, buf_0</pre>
  261. <p>ãäå buf_0 - ñòðóêòóðà 24-õ áèòíîãî áóôåðà.</p>
  262.  
  263. <h4><a name="f_v_brush_c">buf2d_vox_brush_create</a></h4>
  264. <p>Ñîçäàíèå âîêñåëüíîé êèñòè. Ïðèìåð:</p>
  265. <pre>stdcall [buf2d_vox_brush_create], buf_vox, vox_6_7_z
  266.  
  267. .........
  268.  
  269. align 4
  270. vox_6_7_z: ;äàííûå äëÿ ñîçäàíèÿ ìèíèìàëüíîãî åäèíè÷íîãî âîêñåëÿ
  271. dd 0,0,1,1,0,0,\
  272.    0,2,2,2,2,0,\
  273.    2,2,2,2,2,2,\
  274.    2,3,2,2,3,2,\
  275.    2,3,3,3,3,2,\
  276.    0,3,3,3,3,0,\
  277.    0,0,3,3,0,0
  278.  
  279. align 4
  280. buf_vox: ;äàííûå äëÿ ñîçäàíèÿ íàáîðà âîêñåëüíûõ êèñòåé
  281.         db 6,7,4,3 ;w,h,h_osn,n
  282.         rb BUF_STRUCT_SIZE*(3+1)</pre>
  283. <p>ãäå vox_6_7_z - äàííûå äëÿ ñîçäàíèÿ ìèíèìàëüíîãî åäèíè÷íîãî âîêñåëÿ (0 - îçíà÷àåò ïðîçðà÷íûé ïèêñåëü, äðóãèå öèôðû îïðåäåëÿþò ãëóáèíó äëÿ çàïîëíåíèÿ áóôåðà ãëóáèíû);</p>
  284. <p>buf_vox - äàííûå äëÿ ñîçäàíèÿ íàáîðà âîêñåëüíûõ êèñòåé (6 è 7 - ðàçìåð ìèíèìàëüíîãî åäèíè÷íîãî âîêñåëÿ, 4 - âûñîòà âåðõíåãî îñíîâàíèÿ ìèíèìàëüíîãî åäèíè÷íîãî âîêñåëÿ, 3 - ÷èñëî ñîçäàâàåìûõ âîêñåëüíûõ êèñòåé äëÿ ðèñîâàíèÿ âîêñåëåé âåðõíèõ óðîâíåé);</p>
  285.  
  286. <h4>buf2d_vox_brush_delete</h4>
  287. <p>Óäàëåíèå âîêñåëüíîé êèñòè.</p>
  288.  
  289. <h4>buf2d_vox_obj_draw_1g</h4>
  290. <p>Ðèñîâàíèå âîêñåëüíîãî îáúåêòà ñ 1-é ãðàíüþ.</p>
  291.  
  292. <h4>buf2d_vox_obj_get_img_w_3g</h4>
  293. <p>Âîçâðàøàåò øèðèíó âîêñåëüíîãî èçîáðàæåíèÿ ñ 3-ìÿ ãðàíÿìè (êîòîðîå ðèñóåòñÿ ôóíêöèåé <b>buf2d_vox_obj_draw_3g</b>), ïðèíèìàåò óêàçàòåëü íà êèñòü è ìàñøòàá.</p>
  294.  
  295. <h4>buf2d_vox_obj_get_img_h_3g</h4>
  296. <p>Âîçâðàøàåò âûñîòó âîêñåëüíîãî èçîáðàæåíèÿ ñ 3-ìÿ ãðàíÿìè (êîòîðîå ðèñóåòñÿ ôóíêöèåé <b>buf2d_vox_obj_draw_3g</b>), ïðèíèìàåò óêàçàòåëü íà êèñòü è ìàñøòàá.</p>
  297.  
  298. <h4>buf2d_vox_obj_draw_3g</h4>
  299. <p>Ðèñîâàíèå âîêñåëüíîãî îáúåêòà ñ 3-ìÿ ãðàíÿìè.</p>
  300.  
  301. <h4>buf2d_vox_obj_draw_3g_scaled</h4>
  302. <p>Ðèñîâàíèå ÷àñòè âîêñåëüíîãî îáúåêòà.</p>
  303.  
  304. <h4>buf2d_vox_obj_draw_3g_shadows</h4>
  305. <p>Ôóíêöèÿ ðèñóþùàÿ òåíè äëÿ èçîáðàæåíèé íàðèñîâàííûõ ñ ïîìîùüþ ôóíêöèè <b>buf2d_vox_obj_draw_3g</b> èëè <b>buf2d_vox_obj_draw_3g_scaled</b>.</p>
  306.  
  307. <h4>buf2d_vox_obj_draw_pl</h4>
  308. <p>Ôóíêöèÿ ðèñóþùàÿ ñðåç âîêñåëüíîãî îáüåêòà.</p>
  309.  
  310. <h4>buf2d_vox_obj_draw_pl_scaled</h4>
  311. <p>Ôóíêöèÿ ðèñóþùàÿ ñðåç ÷àñòè âîêñåëüíîãî îáüåêòà.</p>
  312.  
  313. <h1><a name="const">Êîíñòàíòû</a></h1>
  314. <h4>BUF2D_OPT_CROP_TOP equ 1</h4>
  315. <p>Êîíñòàíòà äëÿ ôóíêöèè <a href="#f_c_color">buf2d_crop_color</a>, îáîçíà÷àåò îáðåçêó áóôåðà ñâåðõó</p>
  316. <h4>BUF2D_OPT_CROP_LEFT equ 2</h4>
  317. <p>Êîíñòàíòà äëÿ ôóíêöèè <a href="#f_c_color">buf2d_crop_color</a>, îáîçíà÷àåò îáðåçêó áóôåðà ñëåâà</p>
  318. <h4>BUF2D_OPT_CROP_BOTTOM equ 4</h4>
  319. <p>Êîíñòàíòà äëÿ ôóíêöèè <a href="#f_c_color">buf2d_crop_color</a>, îáîçíà÷àåò îáðåçêó áóôåðà ñíèçó</p>
  320. <h4>BUF2D_OPT_CROP_RIGHT equ 8</h4>
  321. <p>Êîíñòàíòà äëÿ ôóíêöèè <a href="#f_c_color">buf2d_crop_color</a>, îáîçíà÷àåò îáðåçêó áóôåðà ñïðàâà</p>
  322.  
  323. <h1><a name="tabl_e">Òàáëèöà ýêñïîðòà</a></h1>
  324. <p>Ïðèìåð òàáëèöû ýêñïîðòà, ðàñ÷èòàííîé íà èñïîëüçîâàíèå ìàêðîñà <b>@use_library_mem</b>:</p>
  325. <pre>align 4
  326. import_buf2d_lib:
  327.         dd sz_lib_init
  328.         buf2d_create dd sz_buf2d_create
  329.         buf2d_create_f_img dd sz_buf2d_create_f_img
  330.         buf2d_clear dd sz_buf2d_clear
  331.         buf2d_draw dd sz_buf2d_draw
  332.         buf2d_delete dd sz_buf2d_delete
  333.         buf2d_rotate dd sz_buf2d_rotate
  334.         buf2d_resize dd sz_buf2d_resize
  335.         buf2d_line dd sz_buf2d_line
  336.         buf2d_line_sm dd sz_buf2d_line_sm
  337.         buf2d_rect_by_size dd sz_buf2d_rect_by_size
  338.         buf2d_filled_rect_by_size dd sz_buf2d_filled_rect_by_size
  339.         buf2d_circle dd sz_buf2d_circle
  340.         buf2d_img_hdiv2 dd sz_buf2d_img_hdiv2
  341.         buf2d_img_wdiv2 dd sz_buf2d_img_wdiv2
  342.         buf2d_conv_24_to_8 dd sz_buf2d_conv_24_to_8
  343.         buf2d_conv_24_to_32 dd sz_buf2d_conv_24_to_32
  344.         buf2d_bit_blt dd sz_buf2d_bit_blt
  345.         buf2d_bit_blt_transp dd sz_buf2d_bit_blt_transp
  346.         buf2d_bit_blt_alpha dd sz_buf2d_bit_blt_alpha
  347.         buf2d_curve_bezier dd sz_buf2d_curve_bezier
  348.         buf2d_convert_text_matrix dd sz_buf2d_convert_text_matrix
  349.         buf2d_draw_text dd sz_buf2d_draw_text
  350.         buf2d_crop_color dd sz_buf2d_crop_color
  351.         buf2d_offset_h dd sz_buf2d_offset_h
  352.         buf2d_flood_fill dd sz_buf2d_flood_fill
  353.         buf2d_set_pixel dd sz_buf2d_set_pixel
  354.         buf2d_get_pixel dd sz_buf2d_get_pixel
  355.         buf2d_flip_v dd sz_buf2d_flip_v
  356.  
  357.         ;âîêñåëüíûå ôóíêöèè:
  358.         buf2d_vox_brush_create dd sz_buf2d_vox_brush_create
  359.         buf2d_vox_brush_delete dd sz_buf2d_vox_brush_delete
  360.         buf2d_vox_obj_draw_1g dd sz_buf2d_vox_obj_draw_1g
  361.         buf2d_vox_obj_get_img_w_3g dd sz_buf2d_vox_obj_get_img_w_3g
  362.         buf2d_vox_obj_get_img_h_3g dd sz_buf2d_vox_obj_get_img_h_3g
  363.         buf2d_vox_obj_draw_3g dd sz_buf2d_vox_obj_draw_3g
  364.         buf2d_vox_obj_draw_3g_scaled dd sz_buf2d_vox_obj_draw_3g_scaled
  365.         buf2d_vox_obj_draw_3g_shadows dd sz_buf2d_vox_obj_draw_3g_shadows
  366.         buf2d_vox_obj_draw_pl dd sz_buf2d_vox_obj_draw_pl
  367.         buf2d_vox_obj_draw_pl_scaled dd sz_buf2d_vox_obj_draw_pl_scaled
  368.  
  369.         dd 0,0
  370.         sz_lib_init db 'lib_init',0
  371.         sz_buf2d_create db 'buf2d_create',0
  372.         sz_buf2d_create_f_img db 'buf2d_create_f_img',0
  373.         sz_buf2d_clear db 'buf2d_clear',0
  374.         sz_buf2d_draw db 'buf2d_draw',0
  375.         sz_buf2d_delete db 'buf2d_delete',0
  376.         sz_buf2d_rotate db 'buf2d_rotate',0
  377.         sz_buf2d_resize db 'buf2d_resize',0
  378.         sz_buf2d_line db 'buf2d_line',0
  379.         sz_buf2d_line_sm db 'buf2d_line_sm',0
  380.         sz_buf2d_rect_by_size db 'buf2d_rect_by_size',0
  381.         sz_buf2d_filled_rect_by_size db 'buf2d_filled_rect_by_size',0
  382.         sz_buf2d_circle db 'buf2d_circle',0
  383.         sz_buf2d_img_hdiv2 db 'buf2d_img_hdiv2',0
  384.         sz_buf2d_img_wdiv2 db 'buf2d_img_wdiv2',0
  385.         sz_buf2d_conv_24_to_8 db 'buf2d_conv_24_to_8',0
  386.         sz_buf2d_conv_24_to_32 db 'buf2d_conv_24_to_32',0
  387.         sz_buf2d_bit_blt db 'buf2d_bit_blt',0
  388.         sz_buf2d_bit_blt_transp db 'buf2d_bit_blt_transp',0
  389.         sz_buf2d_bit_blt_alpha db 'buf2d_bit_blt_alpha',0
  390.         sz_buf2d_curve_bezier db 'buf2d_curve_bezier',0
  391.         sz_buf2d_convert_text_matrix db 'buf2d_convert_text_matrix',0
  392.         sz_buf2d_draw_text db 'buf2d_draw_text',0
  393.         sz_buf2d_crop_color db 'buf2d_crop_color',0
  394.         sz_buf2d_offset_h db 'buf2d_offset_h',0
  395.         sz_buf2d_flood_fill db 'buf2d_flood_fill',0
  396.         sz_buf2d_set_pixel db 'buf2d_set_pixel',0
  397.         sz_buf2d_get_pixel db 'buf2d_get_pixel',0
  398.         sz_buf2d_flip_v db 'buf2d_flip_v',0
  399.  
  400.         ;âîêñåëüíûå ôóíêöèè:
  401.         sz_buf2d_vox_brush_create db 'buf2d_vox_brush_create',0
  402.         sz_buf2d_vox_brush_delete db 'buf2d_vox_brush_delete',0
  403.         sz_buf2d_vox_obj_draw_1g db 'buf2d_vox_obj_draw_1g',0
  404.         sz_buf2d_vox_obj_get_img_w_3g db 'buf2d_vox_obj_get_img_w_3g',0
  405.         sz_buf2d_vox_obj_get_img_h_3g db 'buf2d_vox_obj_get_img_h_3g',0
  406.         sz_buf2d_vox_obj_draw_3g db 'buf2d_vox_obj_draw_3g',0
  407.         sz_buf2d_vox_obj_draw_3g_scaled db 'buf2d_vox_obj_draw_3g_scaled',0
  408.         sz_buf2d_vox_obj_draw_3g_shadows db 'buf2d_vox_obj_draw_3g_shadows',0
  409.         sz_buf2d_vox_obj_draw_pl db 'buf2d_vox_obj_draw_pl',0
  410.         sz_buf2d_vox_obj_draw_pl_scaled db 'buf2d_vox_obj_draw_pl_scaled',0</pre>
  411.  
  412. <h1><a name="hist">Èñòîðèÿ</a></h1>
  413. <p>02.07.10 - ñàìàÿ ïåðâàÿ âåðñèÿ áèáëèîòåêè, 2 ïðèìåðà èñïîëüçîâàíèÿ.</p>
  414. <p>06.07.10 - ðàñøèðåíû âîçìîæíîñòè ôóíêöèè buf2d_bit_blt, òåïåðü îíà ìîæåò ðèñîâàòü 32 áèòíûå áóôåðû. Äîáàâëåíû 2 íîâûå ôóíêöèè: buf2d_bit_blt_alpha è buf2d_cruve_bezier. Íåáîëüøèå èçìåíåíèÿ â ôóíêöèè buf2d_line.</p>
  415. <p>16.07.10 - èñïðàâëåíî ïî 2 îøèáêè â ôóíêöèÿõ buf2d_img_hdiv2 è buf2d_img_wdiv2, êîòîðûå ìîãëè ïðîÿâëÿòüñÿ ïðè îïðåäåëåííûõ óñëîâèÿõ (åñëè ðàçìåð èçîáðàæåíèÿ áûë êðàòåí 4Êá è äð.). Äîáàâëåíû 2 ôóíêöèè äëÿ âûâîäà òåêñòà â áóôåð buf2d_convert_text_matrix è buf2d_draw_text.</p>
  416. <p>19.07.10 - äîáàâëåíà ôóíêöèÿ ðèñîâàíèÿ îêðóæíîñòè buf2d_circle;
  417.  èçìåíåí ôîðìàò áóôåðà - äëÿ øèðèíû è âûñîòû èñïîëüçóþòñÿ 4-õ áàéòíûå ÷èñëà âìåñòî 2-õ áàéòíûõ.</p>
  418. <p>29.07.10 - äîáàâëåíû ôóíêöèè buf2d_crop_color è buf2d_offset_h;
  419.  èñïðàâëåíèÿ â ôóíêöèè buf2d_delete.</p>
  420. <p>30.09.10 - äîáàâëåíà ôóíêöèÿ buf2d_rect_by_size.</p>
  421. <p>04.10.10 - äîáàâëåíà ôóíêöèÿ buf2d_filled_rect_by_size, äîðàáîòàíà ôóíêöèÿ buf_bit_blt_alpha.</p>
  422. <p>07.10.10 - äîðàáîòàíà ôóíêöèÿ buf_bit_blt (ïðè ïîïûòêå íàðèñîâàòü èçîáðàæåíèå çà ïðåäåëàìè ïðàâîãî êðàÿ áóôåðà ïðèëîæåíèå âûçâàâøåå ôóíêöèþ ïàäàëî).</p>
  423. <p>11.10.10 - èñïðàâëåíî çàäàíèå öâåòîâ â íåêîòîðûõ ôóíêöèÿõ, êðàñíûé è ñèíèé öâåòà ïîìåíÿë ìåñòàìè. Òåïåðü öâåòà ñîâïàäàþò ñ ñèñåìíûìè ôóíêöèÿìè.</p>
  424. <p>02.11.10 - äîáàâëåíà ôóíêöèÿ buf2d_flood_fill.</p>
  425. <p>22.12.10 - èçìåíåíî èìÿ ôóíêöèè buf2d_cruve_bezier íà buf2d_curve_bezier.</p>
  426. <p>25.03.11 - äîáàâëåíà ôóíêöèÿ äëÿ ðèñîâàíèÿ òî÷êè buf2d_set_pixel.</p>
  427. <p>30.08.11 - äîáàâëåíà ôóíêöèÿ èçìåíåíèÿ ðàçìåðîâ áóôåðà buf2d_resize.</p>
  428. <p>13.09.11 - îïòèìèçèðîâàíà ðàáîòà ôóíêöèé buf2d_filled_rect_by_size buf2d_rect_by_size, äîáàâëåíû ïðèìåðû èñïîëüçîâàíèÿ áèáëèîòåêè.</p>
  429. <p>22.09.11 - äîáàâëåíà ôóíêöèÿ buf2d_line_sm äëÿ ðèñîâàíèÿ ñãëàæåííîé ëèíèè.</p>
  430. <p>20.02.12 - ôóíêöèè buf2d_filled_rect_by_size è buf2d_rect_by_size ìîãóò ïðèíèìàòü îòðèöàòåëüíûå ðàçìåðû äëÿ ïðÿìîóãîëüíèêîâ, â ôóíêöèè buf2d_line ãîðèçîíòàëüíàÿ ëèíèÿ ðèñóåòñÿ íà 1 ïèêñåëü äëèíåå (ðàíüøå íå äîðèñîâûâàëî), íåêîòîðûå ôóíêöèè ìîãóò ðèñîâàòü â 8 áèòíûõ áóôåðàõ.</p>
  431. <p>23.02.12 - ôóíêöèÿ buf2d_bit_blt_alpha ìîæåò ïðèíèìàòü îòðèöàòåëüíûå êîîðäèíàòû â ïîçèöèè êîïèðóåìîãî áóôåðà, íåáîëüøèå äîðàáîòêè â buf2d_bit_blt_transp</p>
  432. <p>11.05.12 - äîáàâëåíà ôóíêöèÿ äëÿ âçÿòèÿ öâåòà òî÷êè buf2d_get_pixel, äîðàáîòêè â buf2d_set_pixel.</p>
  433. <p>12.06.12 - äîáàâëåíû ôóíêöèè äëÿ ðèñîâàíèÿ âîêñåëüíîé ãðàôèêè.</p>
  434. <p>11.08.12 - ôóíêöèè äëÿ ñæàòèÿ èçîáðàæåíèé buf2d_img_hdiv2 è buf2d_img_wdiv2 ðàáîòàþò ñ 32 áèòíûìè áóôåðàìè.</p>
  435. <p>01.10.12 - äîáàâëåíà ôóíêöèÿ ïîâîðîòà èçîáðàæåíèé íà 90 è 180 ãðàäóñîâ buf2d_rotate.</p>
  436. <p>15.11.12 - äîáàâëåíà ôóíêöèÿ îòðàæåíèÿ 24 áèòíûõ èçîáðàæåíèé ïî âåðòèêàëè buf_flip_v, èñïðàâëåíèÿ â ôóíêöèè buf2d_img_hdiv2.</p>
  437. </body>
  438. </html>