il__manip_8h-source.html 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
  3. <title>DevIL: /home/dwoods/DevIL/src-IL/include/il_manip.h Source File</title>
  4. <link href="doxygen.css" rel="stylesheet" type="text/css">
  5. <link href="tabs.css" rel="stylesheet" type="text/css">
  6. </head><body>
  7. <!-- Generated by Doxygen 1.5.6 -->
  8. <div class="navigation" id="top">
  9. <div class="tabs">
  10. <ul>
  11. <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
  12. <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
  13. <li class="current"><a href="files.html"><span>Files</span></a></li>
  14. </ul>
  15. </div>
  16. <h1>/home/dwoods/DevIL/src-IL/include/il_manip.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">//-----------------------------------------------------------------------------</span>
  17. <a name="l00002"></a>00002 <span class="comment">//</span>
  18. <a name="l00003"></a>00003 <span class="comment">// ImageLib Sources</span>
  19. <a name="l00004"></a>00004 <span class="comment">// Copyright (C) 2001-2002 by Denton Woods</span>
  20. <a name="l00005"></a>00005 <span class="comment">// Last modified: 05/25/2001 &lt;--Y2K Compliant! =]</span>
  21. <a name="l00006"></a>00006 <span class="comment">//</span>
  22. <a name="l00007"></a>00007 <span class="comment">// Filename: src-IL/include/il_manip.h</span>
  23. <a name="l00008"></a>00008 <span class="comment">//</span>
  24. <a name="l00009"></a>00009 <span class="comment">// Description: Image manipulation</span>
  25. <a name="l00010"></a>00010 <span class="comment">//</span>
  26. <a name="l00011"></a>00011 <span class="comment">//-----------------------------------------------------------------------------</span>
  27. <a name="l00012"></a>00012
  28. <a name="l00013"></a>00013 <span class="preprocessor">#ifndef MANIP_H</span>
  29. <a name="l00014"></a>00014 <span class="preprocessor"></span><span class="preprocessor">#define MANIP_H</span>
  30. <a name="l00015"></a>00015 <span class="preprocessor"></span>
  31. <a name="l00016"></a>00016 <span class="preprocessor">#ifdef _cplusplus</span>
  32. <a name="l00017"></a>00017 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
  33. <a name="l00018"></a>00018 <span class="preprocessor">#endif</span>
  34. <a name="l00019"></a>00019 <span class="preprocessor"></span>
  35. <a name="l00020"></a>00020 ILboolean ilFlipImage(<span class="keywordtype">void</span>);
  36. <a name="l00021"></a>00021 ILboolean ilMirrorImage(<span class="keywordtype">void</span>); <span class="comment">//@JASON New routine created 03/28/2001</span>
  37. <a name="l00022"></a>00022
  38. <a name="l00023"></a>00023 <span class="comment">//-----------------------------------------------</span>
  39. <a name="l00024"></a>00024 <span class="comment">// Overflow handler for float-to-half conversion;</span>
  40. <a name="l00025"></a>00025 <span class="comment">// generates a hardware floating-point overflow,</span>
  41. <a name="l00026"></a>00026 <span class="comment">// which may be trapped by the operating system.</span>
  42. <a name="l00027"></a>00027 <span class="comment">//-----------------------------------------------</span>
  43. <a name="l00028"></a>00028 <span class="preprocessor">#ifndef NOINLINE</span>
  44. <a name="l00029"></a>00029 <span class="preprocessor"></span>
  45. <a name="l00030"></a>00030 <span class="preprocessor">#if defined(_MSC_VER)</span>
  46. <a name="l00031"></a>00031 <span class="preprocessor"></span><span class="preprocessor"> #pragma warning(push)</span>
  47. <a name="l00032"></a>00032 <span class="preprocessor"></span><span class="preprocessor"> #pragma warning(disable : 4756) // Disables 'named type definition in parentheses' warning</span>
  48. <a name="l00033"></a>00033 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
  49. <a name="l00034"></a>00034 <span class="preprocessor"></span>INLINE ILfloat <span class="comment">/*ILAPIENTRY*/</span> ilFloatToHalfOverflow() {
  50. <a name="l00035"></a>00035 ILfloat f = 1e10;
  51. <a name="l00036"></a>00036 ILint j;
  52. <a name="l00037"></a>00037 <span class="keywordflow">for</span> (j = 0; j &lt; 10; j++)
  53. <a name="l00038"></a>00038 f *= f; <span class="comment">// this will overflow before</span>
  54. <a name="l00039"></a>00039 <span class="comment">// the for loop terminates</span>
  55. <a name="l00040"></a>00040 <span class="keywordflow">return</span> f;
  56. <a name="l00041"></a>00041 }
  57. <a name="l00042"></a>00042 <span class="preprocessor">#if defined(_MSC_VER)</span>
  58. <a name="l00043"></a>00043 <span class="preprocessor"></span><span class="preprocessor"> #pragma warning(pop)</span>
  59. <a name="l00044"></a>00044 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
  60. <a name="l00045"></a>00045 <span class="preprocessor"></span>
  61. <a name="l00046"></a>00046 <span class="comment">//-----------------------------------------------------</span>
  62. <a name="l00047"></a>00047 <span class="comment">// Float-to-half conversion -- general case, including</span>
  63. <a name="l00048"></a>00048 <span class="comment">// zeroes, denormalized numbers and exponent overflows.</span>
  64. <a name="l00049"></a>00049 <span class="comment">//-----------------------------------------------------</span>
  65. <a name="l00050"></a>00050 INLINE ILushort ILAPIENTRY ilFloatToHalf(ILuint i) {
  66. <a name="l00051"></a>00051 <span class="comment">//</span>
  67. <a name="l00052"></a>00052 <span class="comment">// Our floating point number, f, is represented by the bit</span>
  68. <a name="l00053"></a>00053 <span class="comment">// pattern in integer i. Disassemble that bit pattern into</span>
  69. <a name="l00054"></a>00054 <span class="comment">// the sign, s, the exponent, e, and the significand, m.</span>
  70. <a name="l00055"></a>00055 <span class="comment">// Shift s into the position where it will go in in the</span>
  71. <a name="l00056"></a>00056 <span class="comment">// resulting half number.</span>
  72. <a name="l00057"></a>00057 <span class="comment">// Adjust e, accounting for the different exponent bias</span>
  73. <a name="l00058"></a>00058 <span class="comment">// of float and half (127 versus 15).</span>
  74. <a name="l00059"></a>00059 <span class="comment">//</span>
  75. <a name="l00060"></a>00060
  76. <a name="l00061"></a>00061 <span class="keyword">register</span> <span class="keywordtype">int</span> s = (i &gt;&gt; 16) &amp; 0x00008000;
  77. <a name="l00062"></a>00062 <span class="keyword">register</span> <span class="keywordtype">int</span> e = ((i &gt;&gt; 23) &amp; 0x000000ff) - (127 - 15);
  78. <a name="l00063"></a>00063 <span class="keyword">register</span> <span class="keywordtype">int</span> m = i &amp; 0x007fffff;
  79. <a name="l00064"></a>00064
  80. <a name="l00065"></a>00065 <span class="comment">//</span>
  81. <a name="l00066"></a>00066 <span class="comment">// Now reassemble s, e and m into a half:</span>
  82. <a name="l00067"></a>00067 <span class="comment">//</span>
  83. <a name="l00068"></a>00068
  84. <a name="l00069"></a>00069 <span class="keywordflow">if</span> (e &lt;= 0)
  85. <a name="l00070"></a>00070 {
  86. <a name="l00071"></a>00071 <span class="keywordflow">if</span> (e &lt; -10)
  87. <a name="l00072"></a>00072 {
  88. <a name="l00073"></a>00073 <span class="comment">//</span>
  89. <a name="l00074"></a>00074 <span class="comment">// E is less than -10. The absolute value of f is</span>
  90. <a name="l00075"></a>00075 <span class="comment">// less than HALF_MIN (f may be a small normalized</span>
  91. <a name="l00076"></a>00076 <span class="comment">// float, a denormalized float or a zero).</span>
  92. <a name="l00077"></a>00077 <span class="comment">//</span>
  93. <a name="l00078"></a>00078 <span class="comment">// We convert f to a half zero.</span>
  94. <a name="l00079"></a>00079 <span class="comment">//</span>
  95. <a name="l00080"></a>00080
  96. <a name="l00081"></a>00081 <span class="keywordflow">return</span> 0;
  97. <a name="l00082"></a>00082 }
  98. <a name="l00083"></a>00083
  99. <a name="l00084"></a>00084 <span class="comment">//</span>
  100. <a name="l00085"></a>00085 <span class="comment">// E is between -10 and 0. F is a normalized float,</span>
  101. <a name="l00086"></a>00086 <span class="comment">// whose magnitude is less than HALF_NRM_MIN.</span>
  102. <a name="l00087"></a>00087 <span class="comment">//</span>
  103. <a name="l00088"></a>00088 <span class="comment">// We convert f to a denormalized half.</span>
  104. <a name="l00089"></a>00089 <span class="comment">// </span>
  105. <a name="l00090"></a>00090
  106. <a name="l00091"></a>00091 m = (m | 0x00800000) &gt;&gt; (1 - e);
  107. <a name="l00092"></a>00092
  108. <a name="l00093"></a>00093 <span class="comment">//</span>
  109. <a name="l00094"></a>00094 <span class="comment">// Round to nearest, round "0.5" up.</span>
  110. <a name="l00095"></a>00095 <span class="comment">//</span>
  111. <a name="l00096"></a>00096 <span class="comment">// Rounding may cause the significand to overflow and make</span>
  112. <a name="l00097"></a>00097 <span class="comment">// our number normalized. Because of the way a half's bits</span>
  113. <a name="l00098"></a>00098 <span class="comment">// are laid out, we don't have to treat this case separately;</span>
  114. <a name="l00099"></a>00099 <span class="comment">// the code below will handle it correctly.</span>
  115. <a name="l00100"></a>00100 <span class="comment">// </span>
  116. <a name="l00101"></a>00101
  117. <a name="l00102"></a>00102 <span class="keywordflow">if</span> (m &amp; 0x00001000)
  118. <a name="l00103"></a>00103 m += 0x00002000;
  119. <a name="l00104"></a>00104
  120. <a name="l00105"></a>00105 <span class="comment">//</span>
  121. <a name="l00106"></a>00106 <span class="comment">// Assemble the half from s, e (zero) and m.</span>
  122. <a name="l00107"></a>00107 <span class="comment">//</span>
  123. <a name="l00108"></a>00108
  124. <a name="l00109"></a>00109 <span class="keywordflow">return</span> s | (m &gt;&gt; 13);
  125. <a name="l00110"></a>00110 }
  126. <a name="l00111"></a>00111 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (e == 0xff - (127 - 15))
  127. <a name="l00112"></a>00112 {
  128. <a name="l00113"></a>00113 <span class="keywordflow">if</span> (m == 0)
  129. <a name="l00114"></a>00114 {
  130. <a name="l00115"></a>00115 <span class="comment">//</span>
  131. <a name="l00116"></a>00116 <span class="comment">// F is an infinity; convert f to a half</span>
  132. <a name="l00117"></a>00117 <span class="comment">// infinity with the same sign as f.</span>
  133. <a name="l00118"></a>00118 <span class="comment">//</span>
  134. <a name="l00119"></a>00119
  135. <a name="l00120"></a>00120 <span class="keywordflow">return</span> s | 0x7c00;
  136. <a name="l00121"></a>00121 }
  137. <a name="l00122"></a>00122 <span class="keywordflow">else</span>
  138. <a name="l00123"></a>00123 {
  139. <a name="l00124"></a>00124 <span class="comment">//</span>
  140. <a name="l00125"></a>00125 <span class="comment">// F is a NAN; we produce a half NAN that preserves</span>
  141. <a name="l00126"></a>00126 <span class="comment">// the sign bit and the 10 leftmost bits of the</span>
  142. <a name="l00127"></a>00127 <span class="comment">// significand of f, with one exception: If the 10</span>
  143. <a name="l00128"></a>00128 <span class="comment">// leftmost bits are all zero, the NAN would turn </span>
  144. <a name="l00129"></a>00129 <span class="comment">// into an infinity, so we have to set at least one</span>
  145. <a name="l00130"></a>00130 <span class="comment">// bit in the significand.</span>
  146. <a name="l00131"></a>00131 <span class="comment">//</span>
  147. <a name="l00132"></a>00132
  148. <a name="l00133"></a>00133 m &gt;&gt;= 13;
  149. <a name="l00134"></a>00134 <span class="keywordflow">return</span> s | 0x7c00 | m | (m == 0);
  150. <a name="l00135"></a>00135 }
  151. <a name="l00136"></a>00136 }
  152. <a name="l00137"></a>00137 <span class="keywordflow">else</span>
  153. <a name="l00138"></a>00138 {
  154. <a name="l00139"></a>00139 <span class="comment">//</span>
  155. <a name="l00140"></a>00140 <span class="comment">// E is greater than zero. F is a normalized float.</span>
  156. <a name="l00141"></a>00141 <span class="comment">// We try to convert f to a normalized half.</span>
  157. <a name="l00142"></a>00142 <span class="comment">//</span>
  158. <a name="l00143"></a>00143
  159. <a name="l00144"></a>00144 <span class="comment">//</span>
  160. <a name="l00145"></a>00145 <span class="comment">// Round to nearest, round "0.5" up</span>
  161. <a name="l00146"></a>00146 <span class="comment">//</span>
  162. <a name="l00147"></a>00147
  163. <a name="l00148"></a>00148 <span class="keywordflow">if</span> (m &amp; 0x00001000)
  164. <a name="l00149"></a>00149 {
  165. <a name="l00150"></a>00150 m += 0x00002000;
  166. <a name="l00151"></a>00151
  167. <a name="l00152"></a>00152 <span class="keywordflow">if</span> (m &amp; 0x00800000)
  168. <a name="l00153"></a>00153 {
  169. <a name="l00154"></a>00154 m = 0; <span class="comment">// overflow in significand,</span>
  170. <a name="l00155"></a>00155 e += 1; <span class="comment">// adjust exponent</span>
  171. <a name="l00156"></a>00156 }
  172. <a name="l00157"></a>00157 }
  173. <a name="l00158"></a>00158
  174. <a name="l00159"></a>00159 <span class="comment">//</span>
  175. <a name="l00160"></a>00160 <span class="comment">// Handle exponent overflow</span>
  176. <a name="l00161"></a>00161 <span class="comment">//</span>
  177. <a name="l00162"></a>00162
  178. <a name="l00163"></a>00163 <span class="keywordflow">if</span> (e &gt; 30)
  179. <a name="l00164"></a>00164 {
  180. <a name="l00165"></a>00165 ilFloatToHalfOverflow(); <span class="comment">// Cause a hardware floating point overflow;</span>
  181. <a name="l00166"></a>00166 <span class="keywordflow">return</span> s | 0x7c00; <span class="comment">// if this returns, the half becomes an</span>
  182. <a name="l00167"></a>00167 } <span class="comment">// infinity with the same sign as f.</span>
  183. <a name="l00168"></a>00168
  184. <a name="l00169"></a>00169 <span class="comment">//</span>
  185. <a name="l00170"></a>00170 <span class="comment">// Assemble the half from s, e and m.</span>
  186. <a name="l00171"></a>00171 <span class="comment">//</span>
  187. <a name="l00172"></a>00172
  188. <a name="l00173"></a>00173 <span class="keywordflow">return</span> s | (e &lt;&lt; 10) | (m &gt;&gt; 13);
  189. <a name="l00174"></a>00174 }
  190. <a name="l00175"></a>00175 }
  191. <a name="l00176"></a>00176
  192. <a name="l00177"></a>00177 <span class="comment">// Taken from OpenEXR</span>
  193. <a name="l00178"></a>00178 INLINE ILuint ILAPIENTRY ilHalfToFloat (ILushort y) {
  194. <a name="l00179"></a>00179
  195. <a name="l00180"></a>00180 <span class="keywordtype">int</span> s = (y &gt;&gt; 15) &amp; 0x00000001;
  196. <a name="l00181"></a>00181 <span class="keywordtype">int</span> e = (y &gt;&gt; 10) &amp; 0x0000001f;
  197. <a name="l00182"></a>00182 <span class="keywordtype">int</span> m = y &amp; 0x000003ff;
  198. <a name="l00183"></a>00183
  199. <a name="l00184"></a>00184 <span class="keywordflow">if</span> (e == 0)
  200. <a name="l00185"></a>00185 {
  201. <a name="l00186"></a>00186 <span class="keywordflow">if</span> (m == 0)
  202. <a name="l00187"></a>00187 {
  203. <a name="l00188"></a>00188 <span class="comment">//</span>
  204. <a name="l00189"></a>00189 <span class="comment">// Plus or minus zero</span>
  205. <a name="l00190"></a>00190 <span class="comment">//</span>
  206. <a name="l00191"></a>00191
  207. <a name="l00192"></a>00192 <span class="keywordflow">return</span> s &lt;&lt; 31;
  208. <a name="l00193"></a>00193 }
  209. <a name="l00194"></a>00194 <span class="keywordflow">else</span>
  210. <a name="l00195"></a>00195 {
  211. <a name="l00196"></a>00196 <span class="comment">//</span>
  212. <a name="l00197"></a>00197 <span class="comment">// Denormalized number -- renormalize it</span>
  213. <a name="l00198"></a>00198 <span class="comment">//</span>
  214. <a name="l00199"></a>00199
  215. <a name="l00200"></a>00200 <span class="keywordflow">while</span> (!(m &amp; 0x00000400))
  216. <a name="l00201"></a>00201 {
  217. <a name="l00202"></a>00202 m &lt;&lt;= 1;
  218. <a name="l00203"></a>00203 e -= 1;
  219. <a name="l00204"></a>00204 }
  220. <a name="l00205"></a>00205
  221. <a name="l00206"></a>00206 e += 1;
  222. <a name="l00207"></a>00207 m &amp;= ~0x00000400;
  223. <a name="l00208"></a>00208 }
  224. <a name="l00209"></a>00209 }
  225. <a name="l00210"></a>00210 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (e == 31)
  226. <a name="l00211"></a>00211 {
  227. <a name="l00212"></a>00212 <span class="keywordflow">if</span> (m == 0)
  228. <a name="l00213"></a>00213 {
  229. <a name="l00214"></a>00214 <span class="comment">//</span>
  230. <a name="l00215"></a>00215 <span class="comment">// Positive or negative infinity</span>
  231. <a name="l00216"></a>00216 <span class="comment">//</span>
  232. <a name="l00217"></a>00217
  233. <a name="l00218"></a>00218 <span class="keywordflow">return</span> (s &lt;&lt; 31) | 0x7f800000;
  234. <a name="l00219"></a>00219 }
  235. <a name="l00220"></a>00220 <span class="keywordflow">else</span>
  236. <a name="l00221"></a>00221 {
  237. <a name="l00222"></a>00222 <span class="comment">//</span>
  238. <a name="l00223"></a>00223 <span class="comment">// Nan -- preserve sign and significand bits</span>
  239. <a name="l00224"></a>00224 <span class="comment">//</span>
  240. <a name="l00225"></a>00225
  241. <a name="l00226"></a>00226 <span class="keywordflow">return</span> (s &lt;&lt; 31) | 0x7f800000 | (m &lt;&lt; 13);
  242. <a name="l00227"></a>00227 }
  243. <a name="l00228"></a>00228 }
  244. <a name="l00229"></a>00229
  245. <a name="l00230"></a>00230 <span class="comment">//</span>
  246. <a name="l00231"></a>00231 <span class="comment">// Normalized number</span>
  247. <a name="l00232"></a>00232 <span class="comment">//</span>
  248. <a name="l00233"></a>00233
  249. <a name="l00234"></a>00234 e = e + (127 - 15);
  250. <a name="l00235"></a>00235 m = m &lt;&lt; 13;
  251. <a name="l00236"></a>00236
  252. <a name="l00237"></a>00237 <span class="comment">//</span>
  253. <a name="l00238"></a>00238 <span class="comment">// Assemble s, e and m.</span>
  254. <a name="l00239"></a>00239 <span class="comment">//</span>
  255. <a name="l00240"></a>00240
  256. <a name="l00241"></a>00241 <span class="keywordflow">return</span> (s &lt;&lt; 31) | (e &lt;&lt; 23) | m;
  257. <a name="l00242"></a>00242 }
  258. <a name="l00243"></a>00243 <span class="preprocessor">#endif //NOINLINE</span>
  259. <a name="l00244"></a>00244 <span class="preprocessor"></span>
  260. <a name="l00245"></a>00245 <span class="preprocessor">#ifdef _cplusplus</span>
  261. <a name="l00246"></a>00246 <span class="preprocessor"></span>}
  262. <a name="l00247"></a>00247 <span class="preprocessor">#endif</span>
  263. <a name="l00248"></a>00248 <span class="preprocessor"></span>
  264. <a name="l00249"></a>00249 <span class="preprocessor">#endif//MANIP_H</span>
  265. </pre></div></div>
  266. <hr size="1"><address style="text-align: right;"><small>Generated on Sun Mar 8 20:01:41 2009 for DevIL by&nbsp;
  267. <a href="http://www.doxygen.org/index.html">
  268. <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
  269. </body>
  270. </html>