cairo 1.14.0-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of cairo might be problematic. Click here for more details.

Files changed (636) hide show
  1. checksums.yaml +7 -0
  2. data/AUTHORS +7 -0
  3. data/COPYING +59 -0
  4. data/GPL +340 -0
  5. data/Gemfile +5 -0
  6. data/NEWS +429 -0
  7. data/README.rdoc +120 -0
  8. data/Rakefile +620 -0
  9. data/ext/cairo/cairo.def +140 -0
  10. data/ext/cairo/depend +3 -0
  11. data/ext/cairo/extconf.rb +202 -0
  12. data/ext/cairo/rb_cairo.c +111 -0
  13. data/ext/cairo/rb_cairo.h +348 -0
  14. data/ext/cairo/rb_cairo_constants.c +673 -0
  15. data/ext/cairo/rb_cairo_context.c +1741 -0
  16. data/ext/cairo/rb_cairo_device.c +475 -0
  17. data/ext/cairo/rb_cairo_exception.c +446 -0
  18. data/ext/cairo/rb_cairo_font_extents.c +200 -0
  19. data/ext/cairo/rb_cairo_font_face.c +726 -0
  20. data/ext/cairo/rb_cairo_font_options.c +197 -0
  21. data/ext/cairo/rb_cairo_glyph.c +161 -0
  22. data/ext/cairo/rb_cairo_io.c +166 -0
  23. data/ext/cairo/rb_cairo_io.h +44 -0
  24. data/ext/cairo/rb_cairo_matrix.c +366 -0
  25. data/ext/cairo/rb_cairo_path.c +459 -0
  26. data/ext/cairo/rb_cairo_pattern.c +1192 -0
  27. data/ext/cairo/rb_cairo_private.c +255 -0
  28. data/ext/cairo/rb_cairo_private.h +129 -0
  29. data/ext/cairo/rb_cairo_rectangle.c +83 -0
  30. data/ext/cairo/rb_cairo_region.c +385 -0
  31. data/ext/cairo/rb_cairo_scaled_font.c +235 -0
  32. data/ext/cairo/rb_cairo_surface.c +2284 -0
  33. data/ext/cairo/rb_cairo_text_cluster.c +151 -0
  34. data/ext/cairo/rb_cairo_text_extents.c +221 -0
  35. data/lib/2.0/cairo.so +0 -0
  36. data/lib/2.1/cairo.so +0 -0
  37. data/lib/2.2/cairo.so +0 -0
  38. data/lib/cairo.rb +154 -0
  39. data/lib/cairo/color.rb +267 -0
  40. data/lib/cairo/colors.rb +656 -0
  41. data/lib/cairo/constants.rb +24 -0
  42. data/lib/cairo/context.rb +29 -0
  43. data/lib/cairo/context/blur.rb +45 -0
  44. data/lib/cairo/context/circle.rb +9 -0
  45. data/lib/cairo/context/color.rb +11 -0
  46. data/lib/cairo/context/path.rb +117 -0
  47. data/lib/cairo/context/rectangle.rb +33 -0
  48. data/lib/cairo/context/triangle.rb +12 -0
  49. data/lib/cairo/device.rb +13 -0
  50. data/lib/cairo/paper.rb +183 -0
  51. data/lib/cairo/papers.rb +65 -0
  52. data/lib/cairo/path.rb +15 -0
  53. data/lib/cairo/pattern.rb +12 -0
  54. data/lib/cairo/point.rb +7 -0
  55. data/lib/cairo/surface.rb +13 -0
  56. data/samples/agg/aa_test.rb +304 -0
  57. data/samples/blur.rb +46 -0
  58. data/samples/pac-nomralize.rb +170 -0
  59. data/samples/pac-tee.rb +170 -0
  60. data/samples/pac.rb +98 -0
  61. data/samples/png.rb +44 -0
  62. data/samples/scalable.rb +55 -0
  63. data/samples/text-on-path.rb +59 -0
  64. data/samples/text2.rb +130 -0
  65. data/test/cairo-test-utils.rb +44 -0
  66. data/test/run-test.rb +29 -0
  67. data/test/test_color.rb +17 -0
  68. data/test/test_constants.rb +27 -0
  69. data/test/test_context.rb +105 -0
  70. data/test/test_exception.rb +36 -0
  71. data/test/test_font_extents.rb +36 -0
  72. data/test/test_font_face.rb +257 -0
  73. data/test/test_font_options.rb +13 -0
  74. data/test/test_image_surface.rb +28 -0
  75. data/test/test_paper.rb +81 -0
  76. data/test/test_quartz_image_surface.rb +13 -0
  77. data/test/test_raster_source_pattern.rb +162 -0
  78. data/test/test_recording_surface.rb +19 -0
  79. data/test/test_region.rb +102 -0
  80. data/test/test_scaled_font.rb +34 -0
  81. data/test/test_script_device.rb +46 -0
  82. data/test/test_script_surface.rb +13 -0
  83. data/test/test_surface.rb +61 -0
  84. data/test/test_tee_surface.rb +32 -0
  85. data/test/test_text_cluster.rb +32 -0
  86. data/test/test_text_extents.rb +40 -0
  87. data/test/test_text_to_glyphs_data.rb +51 -0
  88. data/test/test_xml_device.rb +22 -0
  89. data/test/test_xml_surface.rb +34 -0
  90. data/vendor/local/bin/fc-cache.exe +0 -0
  91. data/vendor/local/bin/fc-cat.exe +0 -0
  92. data/vendor/local/bin/fc-list.exe +0 -0
  93. data/vendor/local/bin/fc-match.exe +0 -0
  94. data/vendor/local/bin/fc-pattern.exe +0 -0
  95. data/vendor/local/bin/fc-query.exe +0 -0
  96. data/vendor/local/bin/fc-scan.exe +0 -0
  97. data/vendor/local/bin/fc-validate.exe +0 -0
  98. data/vendor/local/bin/freetype-config +163 -0
  99. data/vendor/local/bin/libcairo-2.dll +0 -0
  100. data/vendor/local/bin/libcairo-gobject-2.dll +0 -0
  101. data/vendor/local/bin/libcairo-script-interpreter-2.dll +0 -0
  102. data/vendor/local/bin/libfontconfig-1.dll +0 -0
  103. data/vendor/local/bin/libfreetype-6.dll +0 -0
  104. data/vendor/local/bin/libgcc_s_seh-1.dll +0 -0
  105. data/vendor/local/bin/libpixman-1-0.dll +0 -0
  106. data/vendor/local/bin/libpng-config +127 -0
  107. data/vendor/local/bin/libpng16-16.dll +0 -0
  108. data/vendor/local/bin/libpng16-config +127 -0
  109. data/vendor/local/bin/libstdc++-6.dll +0 -0
  110. data/vendor/local/bin/libwinpthread-1.dll +0 -0
  111. data/vendor/local/bin/libxml2-2.dll +0 -0
  112. data/vendor/local/bin/png-fix-itxt.exe +0 -0
  113. data/vendor/local/bin/pngfix.exe +0 -0
  114. data/vendor/local/bin/xml2-config +106 -0
  115. data/vendor/local/bin/xmlcatalog.exe +0 -0
  116. data/vendor/local/bin/xmllint.exe +0 -0
  117. data/vendor/local/bin/zlib1.dll +0 -0
  118. data/vendor/local/etc/fonts/conf.d/10-scale-bitmap-fonts.conf +81 -0
  119. data/vendor/local/etc/fonts/conf.d/20-unhint-small-vera.conf +48 -0
  120. data/vendor/local/etc/fonts/conf.d/30-metric-aliases.conf +546 -0
  121. data/vendor/local/etc/fonts/conf.d/30-urw-aliases.conf +24 -0
  122. data/vendor/local/etc/fonts/conf.d/40-nonlatin.conf +231 -0
  123. data/vendor/local/etc/fonts/conf.d/45-latin.conf +189 -0
  124. data/vendor/local/etc/fonts/conf.d/49-sansserif.conf +21 -0
  125. data/vendor/local/etc/fonts/conf.d/50-user.conf +15 -0
  126. data/vendor/local/etc/fonts/conf.d/51-local.conf +6 -0
  127. data/vendor/local/etc/fonts/conf.d/60-latin.conf +70 -0
  128. data/vendor/local/etc/fonts/conf.d/65-fonts-persian.conf +419 -0
  129. data/vendor/local/etc/fonts/conf.d/65-nonlatin.conf +196 -0
  130. data/vendor/local/etc/fonts/conf.d/69-unifont.conf +28 -0
  131. data/vendor/local/etc/fonts/conf.d/80-delicious.conf +19 -0
  132. data/vendor/local/etc/fonts/conf.d/90-synthetic.conf +64 -0
  133. data/vendor/local/etc/fonts/conf.d/README +23 -0
  134. data/vendor/local/etc/fonts/fonts.conf +155 -0
  135. data/vendor/local/include/cairo/cairo-deprecated.h +123 -0
  136. data/vendor/local/include/cairo/cairo-features.h +31 -0
  137. data/vendor/local/include/cairo/cairo-ft.h +118 -0
  138. data/vendor/local/include/cairo/cairo-gobject.h +192 -0
  139. data/vendor/local/include/cairo/cairo-pdf.h +94 -0
  140. data/vendor/local/include/cairo/cairo-ps.h +116 -0
  141. data/vendor/local/include/cairo/cairo-script-interpreter.h +124 -0
  142. data/vendor/local/include/cairo/cairo-script.h +98 -0
  143. data/vendor/local/include/cairo/cairo-svg.h +84 -0
  144. data/vendor/local/include/cairo/cairo-version.h +8 -0
  145. data/vendor/local/include/cairo/cairo-win32.h +112 -0
  146. data/vendor/local/include/cairo/cairo.h +3153 -0
  147. data/vendor/local/include/fontconfig/fcfreetype.h +59 -0
  148. data/vendor/local/include/fontconfig/fcprivate.h +124 -0
  149. data/vendor/local/include/fontconfig/fontconfig.h +1010 -0
  150. data/vendor/local/include/freetype2/config/ftconfig.h +706 -0
  151. data/vendor/local/include/freetype2/config/ftheader.h +832 -0
  152. data/vendor/local/include/freetype2/config/ftmodule.h +20 -0
  153. data/vendor/local/include/freetype2/config/ftoption.h +846 -0
  154. data/vendor/local/include/freetype2/config/ftstdlib.h +174 -0
  155. data/vendor/local/include/freetype2/freetype.h +4076 -0
  156. data/vendor/local/include/freetype2/ft2build.h +42 -0
  157. data/vendor/local/include/freetype2/ftadvanc.h +182 -0
  158. data/vendor/local/include/freetype2/ftautoh.h +402 -0
  159. data/vendor/local/include/freetype2/ftbbox.h +102 -0
  160. data/vendor/local/include/freetype2/ftbdf.h +210 -0
  161. data/vendor/local/include/freetype2/ftbitmap.h +227 -0
  162. data/vendor/local/include/freetype2/ftbzip2.h +102 -0
  163. data/vendor/local/include/freetype2/ftcache.h +1057 -0
  164. data/vendor/local/include/freetype2/ftcffdrv.h +254 -0
  165. data/vendor/local/include/freetype2/ftchapters.h +121 -0
  166. data/vendor/local/include/freetype2/ftcid.h +166 -0
  167. data/vendor/local/include/freetype2/fterrdef.h +249 -0
  168. data/vendor/local/include/freetype2/fterrors.h +198 -0
  169. data/vendor/local/include/freetype2/ftgasp.h +128 -0
  170. data/vendor/local/include/freetype2/ftglyph.h +620 -0
  171. data/vendor/local/include/freetype2/ftgxval.h +358 -0
  172. data/vendor/local/include/freetype2/ftgzip.h +149 -0
  173. data/vendor/local/include/freetype2/ftimage.h +1322 -0
  174. data/vendor/local/include/freetype2/ftincrem.h +353 -0
  175. data/vendor/local/include/freetype2/ftlcdfil.h +251 -0
  176. data/vendor/local/include/freetype2/ftlist.h +277 -0
  177. data/vendor/local/include/freetype2/ftlzw.h +99 -0
  178. data/vendor/local/include/freetype2/ftmac.h +274 -0
  179. data/vendor/local/include/freetype2/ftmm.h +377 -0
  180. data/vendor/local/include/freetype2/ftmodapi.h +641 -0
  181. data/vendor/local/include/freetype2/ftmoderr.h +194 -0
  182. data/vendor/local/include/freetype2/ftotval.h +203 -0
  183. data/vendor/local/include/freetype2/ftoutln.h +572 -0
  184. data/vendor/local/include/freetype2/ftpfr.h +172 -0
  185. data/vendor/local/include/freetype2/ftrender.h +238 -0
  186. data/vendor/local/include/freetype2/ftsizes.h +159 -0
  187. data/vendor/local/include/freetype2/ftsnames.h +200 -0
  188. data/vendor/local/include/freetype2/ftstroke.h +751 -0
  189. data/vendor/local/include/freetype2/ftsynth.h +81 -0
  190. data/vendor/local/include/freetype2/ftsystem.h +347 -0
  191. data/vendor/local/include/freetype2/fttrigon.h +350 -0
  192. data/vendor/local/include/freetype2/ftttdrv.h +170 -0
  193. data/vendor/local/include/freetype2/fttypes.h +598 -0
  194. data/vendor/local/include/freetype2/ftwinfnt.h +275 -0
  195. data/vendor/local/include/freetype2/ftxf86.h +83 -0
  196. data/vendor/local/include/freetype2/t1tables.h +662 -0
  197. data/vendor/local/include/freetype2/ttnameid.h +1237 -0
  198. data/vendor/local/include/freetype2/tttables.h +787 -0
  199. data/vendor/local/include/freetype2/tttags.h +111 -0
  200. data/vendor/local/include/freetype2/ttunpat.h +59 -0
  201. data/vendor/local/include/libpng16/png.h +3276 -0
  202. data/vendor/local/include/libpng16/pngconf.h +644 -0
  203. data/vendor/local/include/libpng16/pnglibconf.h +208 -0
  204. data/vendor/local/include/libxml2/libxml/DOCBparser.h +96 -0
  205. data/vendor/local/include/libxml2/libxml/HTMLparser.h +306 -0
  206. data/vendor/local/include/libxml2/libxml/HTMLtree.h +147 -0
  207. data/vendor/local/include/libxml2/libxml/SAX.h +173 -0
  208. data/vendor/local/include/libxml2/libxml/SAX2.h +178 -0
  209. data/vendor/local/include/libxml2/libxml/c14n.h +126 -0
  210. data/vendor/local/include/libxml2/libxml/catalog.h +182 -0
  211. data/vendor/local/include/libxml2/libxml/chvalid.h +230 -0
  212. data/vendor/local/include/libxml2/libxml/debugXML.h +217 -0
  213. data/vendor/local/include/libxml2/libxml/dict.h +80 -0
  214. data/vendor/local/include/libxml2/libxml/encoding.h +240 -0
  215. data/vendor/local/include/libxml2/libxml/entities.h +151 -0
  216. data/vendor/local/include/libxml2/libxml/globals.h +509 -0
  217. data/vendor/local/include/libxml2/libxml/hash.h +233 -0
  218. data/vendor/local/include/libxml2/libxml/list.h +137 -0
  219. data/vendor/local/include/libxml2/libxml/nanoftp.h +163 -0
  220. data/vendor/local/include/libxml2/libxml/nanohttp.h +81 -0
  221. data/vendor/local/include/libxml2/libxml/parser.h +1241 -0
  222. data/vendor/local/include/libxml2/libxml/parserInternals.h +644 -0
  223. data/vendor/local/include/libxml2/libxml/pattern.h +100 -0
  224. data/vendor/local/include/libxml2/libxml/relaxng.h +217 -0
  225. data/vendor/local/include/libxml2/libxml/schemasInternals.h +958 -0
  226. data/vendor/local/include/libxml2/libxml/schematron.h +142 -0
  227. data/vendor/local/include/libxml2/libxml/threads.h +84 -0
  228. data/vendor/local/include/libxml2/libxml/tree.h +1310 -0
  229. data/vendor/local/include/libxml2/libxml/uri.h +94 -0
  230. data/vendor/local/include/libxml2/libxml/valid.h +458 -0
  231. data/vendor/local/include/libxml2/libxml/xinclude.h +129 -0
  232. data/vendor/local/include/libxml2/libxml/xlink.h +189 -0
  233. data/vendor/local/include/libxml2/libxml/xmlIO.h +366 -0
  234. data/vendor/local/include/libxml2/libxml/xmlautomata.h +146 -0
  235. data/vendor/local/include/libxml2/libxml/xmlerror.h +945 -0
  236. data/vendor/local/include/libxml2/libxml/xmlexports.h +162 -0
  237. data/vendor/local/include/libxml2/libxml/xmlmemory.h +224 -0
  238. data/vendor/local/include/libxml2/libxml/xmlmodule.h +57 -0
  239. data/vendor/local/include/libxml2/libxml/xmlreader.h +428 -0
  240. data/vendor/local/include/libxml2/libxml/xmlregexp.h +222 -0
  241. data/vendor/local/include/libxml2/libxml/xmlsave.h +88 -0
  242. data/vendor/local/include/libxml2/libxml/xmlschemas.h +246 -0
  243. data/vendor/local/include/libxml2/libxml/xmlschemastypes.h +151 -0
  244. data/vendor/local/include/libxml2/libxml/xmlstring.h +140 -0
  245. data/vendor/local/include/libxml2/libxml/xmlunicode.h +202 -0
  246. data/vendor/local/include/libxml2/libxml/xmlversion.h +489 -0
  247. data/vendor/local/include/libxml2/libxml/xmlwriter.h +488 -0
  248. data/vendor/local/include/libxml2/libxml/xpath.h +557 -0
  249. data/vendor/local/include/libxml2/libxml/xpathInternals.h +632 -0
  250. data/vendor/local/include/libxml2/libxml/xpointer.h +114 -0
  251. data/vendor/local/include/pixman-1/pixman-version.h +50 -0
  252. data/vendor/local/include/pixman-1/pixman.h +1111 -0
  253. data/vendor/local/include/png.h +3276 -0
  254. data/vendor/local/include/pngconf.h +644 -0
  255. data/vendor/local/include/pnglibconf.h +208 -0
  256. data/vendor/local/include/zconf.h +511 -0
  257. data/vendor/local/include/zlib.h +1768 -0
  258. data/vendor/local/lib/cmake/libxml2/libxml2-config.cmake +50 -0
  259. data/vendor/local/lib/fontconfig.def +207 -0
  260. data/vendor/local/lib/libcairo-gobject.a +0 -0
  261. data/vendor/local/lib/libcairo-gobject.dll.a +0 -0
  262. data/vendor/local/lib/libcairo-gobject.la +41 -0
  263. data/vendor/local/lib/libcairo-script-interpreter.a +0 -0
  264. data/vendor/local/lib/libcairo-script-interpreter.dll.a +0 -0
  265. data/vendor/local/lib/libcairo-script-interpreter.la +41 -0
  266. data/vendor/local/lib/libcairo.a +0 -0
  267. data/vendor/local/lib/libcairo.dll.a +0 -0
  268. data/vendor/local/lib/libcairo.la +41 -0
  269. data/vendor/local/lib/libfontconfig.dll.a +0 -0
  270. data/vendor/local/lib/libfontconfig.la +41 -0
  271. data/vendor/local/lib/libfreetype.a +0 -0
  272. data/vendor/local/lib/libfreetype.dll.a +0 -0
  273. data/vendor/local/lib/libfreetype.la +41 -0
  274. data/vendor/local/lib/libpixman-1.a +0 -0
  275. data/vendor/local/lib/libpixman-1.dll.a +0 -0
  276. data/vendor/local/lib/libpixman-1.la +41 -0
  277. data/vendor/local/lib/libpng.a +0 -0
  278. data/vendor/local/lib/libpng.dll.a +0 -0
  279. data/vendor/local/lib/libpng.la +41 -0
  280. data/vendor/local/lib/libpng16.a +0 -0
  281. data/vendor/local/lib/libpng16.dll.a +0 -0
  282. data/vendor/local/lib/libpng16.la +41 -0
  283. data/vendor/local/lib/libxml2.a +0 -0
  284. data/vendor/local/lib/libxml2.dll.a +0 -0
  285. data/vendor/local/lib/libxml2.la +41 -0
  286. data/vendor/local/lib/libz.a +0 -0
  287. data/vendor/local/lib/libz.dll.a +0 -0
  288. data/vendor/local/lib/pkgconfig/cairo-fc.pc +12 -0
  289. data/vendor/local/lib/pkgconfig/cairo-ft.pc +12 -0
  290. data/vendor/local/lib/pkgconfig/cairo-gobject.pc +12 -0
  291. data/vendor/local/lib/pkgconfig/cairo-pdf.pc +12 -0
  292. data/vendor/local/lib/pkgconfig/cairo-png.pc +12 -0
  293. data/vendor/local/lib/pkgconfig/cairo-ps.pc +12 -0
  294. data/vendor/local/lib/pkgconfig/cairo-script.pc +12 -0
  295. data/vendor/local/lib/pkgconfig/cairo-svg.pc +12 -0
  296. data/vendor/local/lib/pkgconfig/cairo-win32-font.pc +12 -0
  297. data/vendor/local/lib/pkgconfig/cairo-win32.pc +12 -0
  298. data/vendor/local/lib/pkgconfig/cairo.pc +13 -0
  299. data/vendor/local/lib/pkgconfig/fontconfig.pc +18 -0
  300. data/vendor/local/lib/pkgconfig/freetype2.pc +14 -0
  301. data/vendor/local/lib/pkgconfig/libpng.pc +11 -0
  302. data/vendor/local/lib/pkgconfig/libpng16.pc +11 -0
  303. data/vendor/local/lib/pkgconfig/libxml-2.0.pc +13 -0
  304. data/vendor/local/lib/pkgconfig/pixman-1.pc +11 -0
  305. data/vendor/local/lib/pkgconfig/zlib.pc +13 -0
  306. data/vendor/local/lib/xml2Conf.sh +8 -0
  307. data/vendor/local/share/aclocal/freetype2.m4 +194 -0
  308. data/vendor/local/share/aclocal/libxml.m4 +188 -0
  309. data/vendor/local/share/doc/libxml2-2.9.2/Copyright +23 -0
  310. data/vendor/local/share/doc/libxml2-2.9.2/examples/testHTML.c +880 -0
  311. data/vendor/local/share/doc/libxml2-2.9.2/examples/testSAX.c +1198 -0
  312. data/vendor/local/share/doc/libxml2-2.9.2/examples/testXPath.c +229 -0
  313. data/vendor/local/share/doc/libxml2-2.9.2/examples/xmllint.c +3801 -0
  314. data/vendor/local/share/doc/libxml2-2.9.2/html/DOM.gif +0 -0
  315. data/vendor/local/share/doc/libxml2-2.9.2/html/FAQ.html +299 -0
  316. data/vendor/local/share/doc/libxml2-2.9.2/html/Libxml2-Logo-180x168.gif +0 -0
  317. data/vendor/local/share/doc/libxml2-2.9.2/html/Libxml2-Logo-90x34.gif +0 -0
  318. data/vendor/local/share/doc/libxml2-2.9.2/html/encoding.html +217 -0
  319. data/vendor/local/share/doc/libxml2-2.9.2/html/examples.xml +751 -0
  320. data/vendor/local/share/doc/libxml2-2.9.2/html/examples.xsl +174 -0
  321. data/vendor/local/share/doc/libxml2-2.9.2/html/html/book1.html +13 -0
  322. data/vendor/local/share/doc/libxml2-2.9.2/html/html/home.png +0 -0
  323. data/vendor/local/share/doc/libxml2-2.9.2/html/html/index.html +13 -0
  324. data/vendor/local/share/doc/libxml2-2.9.2/html/html/left.png +0 -0
  325. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-DOCBparser.html +51 -0
  326. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-HTMLparser.html +184 -0
  327. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-HTMLtree.html +73 -0
  328. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-SAX.html +125 -0
  329. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-SAX2.html +128 -0
  330. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-c14n.html +38 -0
  331. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-catalog.html +142 -0
  332. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-chvalid.html +72 -0
  333. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-debugXML.html +120 -0
  334. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-dict.html +58 -0
  335. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-encoding.html +124 -0
  336. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-entities.html +79 -0
  337. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-globals.html +152 -0
  338. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-hash.html +116 -0
  339. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-lib.html +13 -0
  340. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-list.html +120 -0
  341. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-nanoftp.html +94 -0
  342. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-nanohttp.html +65 -0
  343. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-parser.html +559 -0
  344. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-parserInternals.html +322 -0
  345. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-pattern.html +76 -0
  346. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-relaxng.html +162 -0
  347. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-schemasInternals.html +373 -0
  348. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-schematron.html +81 -0
  349. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-threads.html +72 -0
  350. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-tree.html +990 -0
  351. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-uri.html +73 -0
  352. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-valid.html +289 -0
  353. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xinclude.html +59 -0
  354. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xlink.html +82 -0
  355. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlIO.html +212 -0
  356. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlautomata.html +85 -0
  357. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlerror.html +865 -0
  358. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlexports.html +20 -0
  359. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlmemory.html +107 -0
  360. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlmodule.html +38 -0
  361. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlreader.html +330 -0
  362. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlregexp.html +143 -0
  363. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlsave.html +60 -0
  364. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlschemas.html +185 -0
  365. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlschemastypes.html +123 -0
  366. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlstring.html +108 -0
  367. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlunicode.html +512 -0
  368. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlversion.html +63 -0
  369. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xmlwriter.html +261 -0
  370. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xpath.html +316 -0
  371. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xpathInternals.html +394 -0
  372. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xpointer.html +83 -0
  373. data/vendor/local/share/doc/libxml2-2.9.2/html/html/libxml-xzlib.html +16 -0
  374. data/vendor/local/share/doc/libxml2-2.9.2/html/html/right.png +0 -0
  375. data/vendor/local/share/doc/libxml2-2.9.2/html/html/up.png +0 -0
  376. data/vendor/local/share/doc/libxml2-2.9.2/html/index.html +14 -0
  377. data/vendor/local/share/doc/libxml2-2.9.2/html/io1.c +166 -0
  378. data/vendor/local/share/doc/libxml2-2.9.2/html/io1.res +5 -0
  379. data/vendor/local/share/doc/libxml2-2.9.2/html/io2.c +58 -0
  380. data/vendor/local/share/doc/libxml2-2.9.2/html/io2.res +2 -0
  381. data/vendor/local/share/doc/libxml2-2.9.2/html/libxml.gif +0 -0
  382. data/vendor/local/share/doc/libxml2-2.9.2/html/parse1.c +56 -0
  383. data/vendor/local/share/doc/libxml2-2.9.2/html/parse2.c +72 -0
  384. data/vendor/local/share/doc/libxml2-2.9.2/html/parse3.c +60 -0
  385. data/vendor/local/share/doc/libxml2-2.9.2/html/parse4.c +143 -0
  386. data/vendor/local/share/doc/libxml2-2.9.2/html/reader1.c +107 -0
  387. data/vendor/local/share/doc/libxml2-2.9.2/html/reader1.res +14 -0
  388. data/vendor/local/share/doc/libxml2-2.9.2/html/reader2.c +122 -0
  389. data/vendor/local/share/doc/libxml2-2.9.2/html/reader3.c +120 -0
  390. data/vendor/local/share/doc/libxml2-2.9.2/html/reader3.res +13 -0
  391. data/vendor/local/share/doc/libxml2-2.9.2/html/reader4.c +122 -0
  392. data/vendor/local/share/doc/libxml2-2.9.2/html/reader4.res +3 -0
  393. data/vendor/local/share/doc/libxml2-2.9.2/html/redhat.gif +0 -0
  394. data/vendor/local/share/doc/libxml2-2.9.2/html/smallfootonly.gif +0 -0
  395. data/vendor/local/share/doc/libxml2-2.9.2/html/structure.gif +0 -0
  396. data/vendor/local/share/doc/libxml2-2.9.2/html/test1.xml +1 -0
  397. data/vendor/local/share/doc/libxml2-2.9.2/html/test2.xml +13 -0
  398. data/vendor/local/share/doc/libxml2-2.9.2/html/test3.xml +39 -0
  399. data/vendor/local/share/doc/libxml2-2.9.2/html/testWriter.c +1198 -0
  400. data/vendor/local/share/doc/libxml2-2.9.2/html/tree1.c +94 -0
  401. data/vendor/local/share/doc/libxml2-2.9.2/html/tree1.res +4 -0
  402. data/vendor/local/share/doc/libxml2-2.9.2/html/tree2.c +118 -0
  403. data/vendor/local/share/doc/libxml2-2.9.2/html/tree2.res +18 -0
  404. data/vendor/local/share/doc/libxml2-2.9.2/html/tst.xml +7 -0
  405. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/apa.html +8 -0
  406. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/apb.html +14 -0
  407. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/apc.html +82 -0
  408. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/apd.html +76 -0
  409. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ape.html +78 -0
  410. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/apf.html +67 -0
  411. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/apg.html +75 -0
  412. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/aph.html +76 -0
  413. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/api.html +4 -0
  414. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ar01s02.html +14 -0
  415. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ar01s03.html +47 -0
  416. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ar01s04.html +54 -0
  417. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ar01s05.html +55 -0
  418. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ar01s06.html +35 -0
  419. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ar01s07.html +30 -0
  420. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ar01s08.html +38 -0
  421. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ar01s09.html +63 -0
  422. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/blank.png +0 -0
  423. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/1.png +0 -0
  424. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/10.png +0 -0
  425. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/2.png +0 -0
  426. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/3.png +0 -0
  427. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/4.png +0 -0
  428. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/5.png +0 -0
  429. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/6.png +0 -0
  430. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/7.png +0 -0
  431. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/8.png +0 -0
  432. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/callouts/9.png +0 -0
  433. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/caution.png +0 -0
  434. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/draft.png +0 -0
  435. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/home.png +0 -0
  436. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/important.png +0 -0
  437. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/next.png +0 -0
  438. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/note.png +0 -0
  439. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/prev.png +0 -0
  440. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/tip.png +0 -0
  441. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/toc-blank.png +0 -0
  442. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/toc-minus.png +0 -0
  443. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/toc-plus.png +0 -0
  444. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/up.png +0 -0
  445. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/images/warning.png +0 -0
  446. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/includeaddattribute.c +64 -0
  447. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/includeaddkeyword.c +75 -0
  448. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/includeconvert.c +73 -0
  449. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/includegetattribute.c +72 -0
  450. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/includekeyword.c +79 -0
  451. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/includexpath.c +74 -0
  452. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/index.html +14 -0
  453. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/ix01.html +1 -0
  454. data/vendor/local/share/doc/libxml2-2.9.2/html/tutorial/xmltutorial.pdf +1336 -0
  455. data/vendor/local/share/doc/libxml2-2.9.2/html/w3c.png +0 -0
  456. data/vendor/local/share/doc/libxml2-2.9.2/html/writer.xml +2 -0
  457. data/vendor/local/share/doc/libxml2-2.9.2/html/xml.html +5995 -0
  458. data/vendor/local/share/doc/libxml2-2.9.2/html/xpath1.c +250 -0
  459. data/vendor/local/share/doc/libxml2-2.9.2/html/xpath1.res +5 -0
  460. data/vendor/local/share/doc/libxml2-2.9.2/html/xpath2.c +190 -0
  461. data/vendor/local/share/doc/libxml2-2.9.2/html/xpath2.res +30 -0
  462. data/vendor/local/share/fontconfig/conf.avail/10-autohint.conf +14 -0
  463. data/vendor/local/share/fontconfig/conf.avail/10-no-sub-pixel.conf +14 -0
  464. data/vendor/local/share/fontconfig/conf.avail/10-scale-bitmap-fonts.conf +81 -0
  465. data/vendor/local/share/fontconfig/conf.avail/10-sub-pixel-bgr.conf +14 -0
  466. data/vendor/local/share/fontconfig/conf.avail/10-sub-pixel-rgb.conf +14 -0
  467. data/vendor/local/share/fontconfig/conf.avail/10-sub-pixel-vbgr.conf +14 -0
  468. data/vendor/local/share/fontconfig/conf.avail/10-sub-pixel-vrgb.conf +14 -0
  469. data/vendor/local/share/fontconfig/conf.avail/10-unhinted.conf +14 -0
  470. data/vendor/local/share/fontconfig/conf.avail/11-lcdfilter-default.conf +16 -0
  471. data/vendor/local/share/fontconfig/conf.avail/11-lcdfilter-legacy.conf +16 -0
  472. data/vendor/local/share/fontconfig/conf.avail/11-lcdfilter-light.conf +16 -0
  473. data/vendor/local/share/fontconfig/conf.avail/20-unhint-small-vera.conf +48 -0
  474. data/vendor/local/share/fontconfig/conf.avail/25-unhint-nonlatin.conf +128 -0
  475. data/vendor/local/share/fontconfig/conf.avail/30-metric-aliases.conf +546 -0
  476. data/vendor/local/share/fontconfig/conf.avail/30-urw-aliases.conf +24 -0
  477. data/vendor/local/share/fontconfig/conf.avail/40-nonlatin.conf +231 -0
  478. data/vendor/local/share/fontconfig/conf.avail/45-latin.conf +189 -0
  479. data/vendor/local/share/fontconfig/conf.avail/49-sansserif.conf +21 -0
  480. data/vendor/local/share/fontconfig/conf.avail/50-user.conf +15 -0
  481. data/vendor/local/share/fontconfig/conf.avail/51-local.conf +6 -0
  482. data/vendor/local/share/fontconfig/conf.avail/60-latin.conf +70 -0
  483. data/vendor/local/share/fontconfig/conf.avail/65-fonts-persian.conf +419 -0
  484. data/vendor/local/share/fontconfig/conf.avail/65-khmer.conf +16 -0
  485. data/vendor/local/share/fontconfig/conf.avail/65-nonlatin.conf +196 -0
  486. data/vendor/local/share/fontconfig/conf.avail/69-unifont.conf +28 -0
  487. data/vendor/local/share/fontconfig/conf.avail/70-no-bitmaps.conf +12 -0
  488. data/vendor/local/share/fontconfig/conf.avail/70-yes-bitmaps.conf +12 -0
  489. data/vendor/local/share/fontconfig/conf.avail/80-delicious.conf +19 -0
  490. data/vendor/local/share/fontconfig/conf.avail/90-synthetic.conf +64 -0
  491. data/vendor/local/share/gtk-doc/html/cairo/bindings-errors.html +122 -0
  492. data/vendor/local/share/gtk-doc/html/cairo/bindings-fonts.html +53 -0
  493. data/vendor/local/share/gtk-doc/html/cairo/bindings-memory.html +123 -0
  494. data/vendor/local/share/gtk-doc/html/cairo/bindings-overloading.html +121 -0
  495. data/vendor/local/share/gtk-doc/html/cairo/bindings-path.html +117 -0
  496. data/vendor/local/share/gtk-doc/html/cairo/bindings-patterns.html +75 -0
  497. data/vendor/local/share/gtk-doc/html/cairo/bindings-return-values.html +120 -0
  498. data/vendor/local/share/gtk-doc/html/cairo/bindings-streams.html +92 -0
  499. data/vendor/local/share/gtk-doc/html/cairo/bindings-surfaces.html +93 -0
  500. data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html +397 -0
  501. data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +428 -0
  502. data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +452 -0
  503. data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +342 -0
  504. data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html +315 -0
  505. data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html +1194 -0
  506. data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +577 -0
  507. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-(CGFont)-Fonts.html +129 -0
  508. data/vendor/local/share/gtk-doc/html/cairo/cairo-Quartz-Surfaces.html +197 -0
  509. data/vendor/local/share/gtk-doc/html/cairo/cairo-Raster-Sources.html +600 -0
  510. data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html +226 -0
  511. data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html +810 -0
  512. data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +302 -0
  513. data/vendor/local/share/gtk-doc/html/cairo/cairo-Script-Surfaces.html +360 -0
  514. data/vendor/local/share/gtk-doc/html/cairo/cairo-Transformations.html +394 -0
  515. data/vendor/local/share/gtk-doc/html/cairo/cairo-Types.html +156 -0
  516. data/vendor/local/share/gtk-doc/html/cairo/cairo-User-Fonts.html +677 -0
  517. data/vendor/local/share/gtk-doc/html/cairo/cairo-Version-Information.html +342 -0
  518. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +326 -0
  519. data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +280 -0
  520. data/vendor/local/share/gtk-doc/html/cairo/cairo-XCB-Surfaces.html +527 -0
  521. data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +535 -0
  522. data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html +170 -0
  523. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html +636 -0
  524. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +380 -0
  525. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html +653 -0
  526. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-matrix-t.html +559 -0
  527. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html +2231 -0
  528. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html +956 -0
  529. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +1637 -0
  530. data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-t.html +2695 -0
  531. data/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +53 -0
  532. data/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +53 -0
  533. data/vendor/local/share/gtk-doc/html/cairo/cairo-support.html +44 -0
  534. data/vendor/local/share/gtk-doc/html/cairo/cairo-surfaces.html +74 -0
  535. data/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +1138 -0
  536. data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +747 -0
  537. data/vendor/local/share/gtk-doc/html/cairo/home.png +0 -0
  538. data/vendor/local/share/gtk-doc/html/cairo/index-1.10.html +177 -0
  539. data/vendor/local/share/gtk-doc/html/cairo/index-1.12.html +193 -0
  540. data/vendor/local/share/gtk-doc/html/cairo/index-1.2.html +179 -0
  541. data/vendor/local/share/gtk-doc/html/cairo/index-1.4.html +123 -0
  542. data/vendor/local/share/gtk-doc/html/cairo/index-1.6.html +107 -0
  543. data/vendor/local/share/gtk-doc/html/cairo/index-1.8.html +128 -0
  544. data/vendor/local/share/gtk-doc/html/cairo/index-all.html +1122 -0
  545. data/vendor/local/share/gtk-doc/html/cairo/index.html +157 -0
  546. data/vendor/local/share/gtk-doc/html/cairo/index.sgml +833 -0
  547. data/vendor/local/share/gtk-doc/html/cairo/language-bindings.html +73 -0
  548. data/vendor/local/share/gtk-doc/html/cairo/left.png +0 -0
  549. data/vendor/local/share/gtk-doc/html/cairo/right.png +0 -0
  550. data/vendor/local/share/gtk-doc/html/cairo/style.css +266 -0
  551. data/vendor/local/share/gtk-doc/html/cairo/up.png +0 -0
  552. data/vendor/local/share/gtk-doc/html/libxml2/general.html +38 -0
  553. data/vendor/local/share/gtk-doc/html/libxml2/home.png +0 -0
  554. data/vendor/local/share/gtk-doc/html/libxml2/index.html +67 -0
  555. data/vendor/local/share/gtk-doc/html/libxml2/left.png +0 -0
  556. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-DOCBparser.html +138 -0
  557. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-HTMLparser.html +373 -0
  558. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-HTMLtree.html +172 -0
  559. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-SAX.html +243 -0
  560. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-SAX2.html +247 -0
  561. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-c14n.html +91 -0
  562. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-catalog.html +278 -0
  563. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-chvalid.html +241 -0
  564. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-debugXML.html +225 -0
  565. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-dict.html +134 -0
  566. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-encoding.html +218 -0
  567. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-entities.html +166 -0
  568. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-globals.html +383 -0
  569. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-hash.html +214 -0
  570. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-list.html +226 -0
  571. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-nanoftp.html +187 -0
  572. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-nanohttp.html +142 -0
  573. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-parser.html +766 -0
  574. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-parserInternals.html +688 -0
  575. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-pattern.html +166 -0
  576. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-relaxng.html +278 -0
  577. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-schemasInternals.html +860 -0
  578. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-schematron.html +166 -0
  579. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-threads.html +161 -0
  580. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-tree.html +1597 -0
  581. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-uri.html +154 -0
  582. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-valid.html +528 -0
  583. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xinclude.html +169 -0
  584. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xlink.html +160 -0
  585. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlIO.html +347 -0
  586. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlautomata.html +176 -0
  587. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlerror.html +953 -0
  588. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlexports.html +87 -0
  589. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlmemory.html +186 -0
  590. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlmodule.html +97 -0
  591. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlreader.html +565 -0
  592. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlregexp.html +280 -0
  593. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlsave.html +133 -0
  594. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlschemas.html +314 -0
  595. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlschemastypes.html +237 -0
  596. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlstring.html +217 -0
  597. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlunicode.html +887 -0
  598. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlversion.html +292 -0
  599. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xmlwriter.html +479 -0
  600. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xpath.html +542 -0
  601. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xpathInternals.html +787 -0
  602. data/vendor/local/share/gtk-doc/html/libxml2/libxml2-xpointer.html +171 -0
  603. data/vendor/local/share/gtk-doc/html/libxml2/libxml2.devhelp +3573 -0
  604. data/vendor/local/share/gtk-doc/html/libxml2/right.png +0 -0
  605. data/vendor/local/share/gtk-doc/html/libxml2/style.css +66 -0
  606. data/vendor/local/share/gtk-doc/html/libxml2/up.png +0 -0
  607. data/vendor/local/share/license/cairo/AUTHORS +115 -0
  608. data/vendor/local/share/license/cairo/COPYING +33 -0
  609. data/vendor/local/share/license/cairo/COPYING-LGPL-2.1 +510 -0
  610. data/vendor/local/share/license/cairo/COPYING-MPL-1.1 +470 -0
  611. data/vendor/local/share/license/cairo/README +204 -0
  612. data/vendor/local/share/license/cairo/README.win32 +66 -0
  613. data/vendor/local/share/license/fontconfig/AUTHORS +3 -0
  614. data/vendor/local/share/license/fontconfig/COPYING +28 -0
  615. data/vendor/local/share/license/fontconfig/README +1484 -0
  616. data/vendor/local/share/license/freetype/README +83 -0
  617. data/vendor/local/share/license/freetype/README.git +50 -0
  618. data/vendor/local/share/license/libpng/README +215 -0
  619. data/vendor/local/share/license/libxml2/AUTHORS +5 -0
  620. data/vendor/local/share/license/libxml2/COPYING +23 -0
  621. data/vendor/local/share/license/libxml2/README +39 -0
  622. data/vendor/local/share/license/libxml2/README.tests +39 -0
  623. data/vendor/local/share/license/pixman/AUTHORS +0 -0
  624. data/vendor/local/share/license/pixman/COPYING +42 -0
  625. data/vendor/local/share/license/pixman/README +116 -0
  626. data/vendor/local/share/license/zlib/README +115 -0
  627. data/vendor/local/share/man/man1/freetype-config.1 +108 -0
  628. data/vendor/local/share/man/man1/xml2-config.1 +30 -0
  629. data/vendor/local/share/man/man1/xmlcatalog.1 +340 -0
  630. data/vendor/local/share/man/man1/xmllint.1 +647 -0
  631. data/vendor/local/share/man/man3/libpng.3 +6217 -0
  632. data/vendor/local/share/man/man3/libpngpf.3 +18 -0
  633. data/vendor/local/share/man/man3/libxml.3 +71 -0
  634. data/vendor/local/share/man/man5/png.5 +74 -0
  635. data/vendor/local/share/xml/fontconfig/fonts.dtd +233 -0
  636. metadata +774 -0
@@ -0,0 +1,111 @@
1
+ /***************************************************************************/
2
+ /* */
3
+ /* tttags.h */
4
+ /* */
5
+ /* Tags for TrueType and OpenType tables (specification only). */
6
+ /* */
7
+ /* Copyright 1996-2001, 2004, 2005, 2007, 2008, 2013 by */
8
+ /* David Turner, Robert Wilhelm, and Werner Lemberg. */
9
+ /* */
10
+ /* This file is part of the FreeType project, and may only be used, */
11
+ /* modified, and distributed under the terms of the FreeType project */
12
+ /* license, LICENSE.TXT. By continuing to use, modify, or distribute */
13
+ /* this file you indicate that you have read the license and */
14
+ /* understand and accept it fully. */
15
+ /* */
16
+ /***************************************************************************/
17
+
18
+
19
+ #ifndef __TTAGS_H__
20
+ #define __TTAGS_H__
21
+
22
+
23
+ #include <ft2build.h>
24
+ #include FT_FREETYPE_H
25
+
26
+ #ifdef FREETYPE_H
27
+ #error "freetype.h of FreeType 1 has been loaded!"
28
+ #error "Please fix the directory search order for header files"
29
+ #error "so that freetype.h of FreeType 2 is found first."
30
+ #endif
31
+
32
+
33
+ FT_BEGIN_HEADER
34
+
35
+
36
+ #define TTAG_avar FT_MAKE_TAG( 'a', 'v', 'a', 'r' )
37
+ #define TTAG_BASE FT_MAKE_TAG( 'B', 'A', 'S', 'E' )
38
+ #define TTAG_bdat FT_MAKE_TAG( 'b', 'd', 'a', 't' )
39
+ #define TTAG_BDF FT_MAKE_TAG( 'B', 'D', 'F', ' ' )
40
+ #define TTAG_bhed FT_MAKE_TAG( 'b', 'h', 'e', 'd' )
41
+ #define TTAG_bloc FT_MAKE_TAG( 'b', 'l', 'o', 'c' )
42
+ #define TTAG_bsln FT_MAKE_TAG( 'b', 's', 'l', 'n' )
43
+ #define TTAG_CBDT FT_MAKE_TAG( 'C', 'B', 'D', 'T' )
44
+ #define TTAG_CBLC FT_MAKE_TAG( 'C', 'B', 'L', 'C' )
45
+ #define TTAG_CFF FT_MAKE_TAG( 'C', 'F', 'F', ' ' )
46
+ #define TTAG_CID FT_MAKE_TAG( 'C', 'I', 'D', ' ' )
47
+ #define TTAG_cmap FT_MAKE_TAG( 'c', 'm', 'a', 'p' )
48
+ #define TTAG_cvar FT_MAKE_TAG( 'c', 'v', 'a', 'r' )
49
+ #define TTAG_cvt FT_MAKE_TAG( 'c', 'v', 't', ' ' )
50
+ #define TTAG_DSIG FT_MAKE_TAG( 'D', 'S', 'I', 'G' )
51
+ #define TTAG_EBDT FT_MAKE_TAG( 'E', 'B', 'D', 'T' )
52
+ #define TTAG_EBLC FT_MAKE_TAG( 'E', 'B', 'L', 'C' )
53
+ #define TTAG_EBSC FT_MAKE_TAG( 'E', 'B', 'S', 'C' )
54
+ #define TTAG_feat FT_MAKE_TAG( 'f', 'e', 'a', 't' )
55
+ #define TTAG_FOND FT_MAKE_TAG( 'F', 'O', 'N', 'D' )
56
+ #define TTAG_fpgm FT_MAKE_TAG( 'f', 'p', 'g', 'm' )
57
+ #define TTAG_fvar FT_MAKE_TAG( 'f', 'v', 'a', 'r' )
58
+ #define TTAG_gasp FT_MAKE_TAG( 'g', 'a', 's', 'p' )
59
+ #define TTAG_GDEF FT_MAKE_TAG( 'G', 'D', 'E', 'F' )
60
+ #define TTAG_glyf FT_MAKE_TAG( 'g', 'l', 'y', 'f' )
61
+ #define TTAG_GPOS FT_MAKE_TAG( 'G', 'P', 'O', 'S' )
62
+ #define TTAG_GSUB FT_MAKE_TAG( 'G', 'S', 'U', 'B' )
63
+ #define TTAG_gvar FT_MAKE_TAG( 'g', 'v', 'a', 'r' )
64
+ #define TTAG_hdmx FT_MAKE_TAG( 'h', 'd', 'm', 'x' )
65
+ #define TTAG_head FT_MAKE_TAG( 'h', 'e', 'a', 'd' )
66
+ #define TTAG_hhea FT_MAKE_TAG( 'h', 'h', 'e', 'a' )
67
+ #define TTAG_hmtx FT_MAKE_TAG( 'h', 'm', 't', 'x' )
68
+ #define TTAG_JSTF FT_MAKE_TAG( 'J', 'S', 'T', 'F' )
69
+ #define TTAG_just FT_MAKE_TAG( 'j', 'u', 's', 't' )
70
+ #define TTAG_kern FT_MAKE_TAG( 'k', 'e', 'r', 'n' )
71
+ #define TTAG_lcar FT_MAKE_TAG( 'l', 'c', 'a', 'r' )
72
+ #define TTAG_loca FT_MAKE_TAG( 'l', 'o', 'c', 'a' )
73
+ #define TTAG_LTSH FT_MAKE_TAG( 'L', 'T', 'S', 'H' )
74
+ #define TTAG_LWFN FT_MAKE_TAG( 'L', 'W', 'F', 'N' )
75
+ #define TTAG_MATH FT_MAKE_TAG( 'M', 'A', 'T', 'H' )
76
+ #define TTAG_maxp FT_MAKE_TAG( 'm', 'a', 'x', 'p' )
77
+ #define TTAG_META FT_MAKE_TAG( 'M', 'E', 'T', 'A' )
78
+ #define TTAG_MMFX FT_MAKE_TAG( 'M', 'M', 'F', 'X' )
79
+ #define TTAG_MMSD FT_MAKE_TAG( 'M', 'M', 'S', 'D' )
80
+ #define TTAG_mort FT_MAKE_TAG( 'm', 'o', 'r', 't' )
81
+ #define TTAG_morx FT_MAKE_TAG( 'm', 'o', 'r', 'x' )
82
+ #define TTAG_name FT_MAKE_TAG( 'n', 'a', 'm', 'e' )
83
+ #define TTAG_opbd FT_MAKE_TAG( 'o', 'p', 'b', 'd' )
84
+ #define TTAG_OS2 FT_MAKE_TAG( 'O', 'S', '/', '2' )
85
+ #define TTAG_OTTO FT_MAKE_TAG( 'O', 'T', 'T', 'O' )
86
+ #define TTAG_PCLT FT_MAKE_TAG( 'P', 'C', 'L', 'T' )
87
+ #define TTAG_POST FT_MAKE_TAG( 'P', 'O', 'S', 'T' )
88
+ #define TTAG_post FT_MAKE_TAG( 'p', 'o', 's', 't' )
89
+ #define TTAG_prep FT_MAKE_TAG( 'p', 'r', 'e', 'p' )
90
+ #define TTAG_prop FT_MAKE_TAG( 'p', 'r', 'o', 'p' )
91
+ #define TTAG_sbix FT_MAKE_TAG( 's', 'b', 'i', 'x' )
92
+ #define TTAG_sfnt FT_MAKE_TAG( 's', 'f', 'n', 't' )
93
+ #define TTAG_SING FT_MAKE_TAG( 'S', 'I', 'N', 'G' )
94
+ #define TTAG_trak FT_MAKE_TAG( 't', 'r', 'a', 'k' )
95
+ #define TTAG_true FT_MAKE_TAG( 't', 'r', 'u', 'e' )
96
+ #define TTAG_ttc FT_MAKE_TAG( 't', 't', 'c', ' ' )
97
+ #define TTAG_ttcf FT_MAKE_TAG( 't', 't', 'c', 'f' )
98
+ #define TTAG_TYP1 FT_MAKE_TAG( 'T', 'Y', 'P', '1' )
99
+ #define TTAG_typ1 FT_MAKE_TAG( 't', 'y', 'p', '1' )
100
+ #define TTAG_VDMX FT_MAKE_TAG( 'V', 'D', 'M', 'X' )
101
+ #define TTAG_vhea FT_MAKE_TAG( 'v', 'h', 'e', 'a' )
102
+ #define TTAG_vmtx FT_MAKE_TAG( 'v', 'm', 't', 'x' )
103
+ #define TTAG_wOFF FT_MAKE_TAG( 'w', 'O', 'F', 'F' )
104
+
105
+
106
+ FT_END_HEADER
107
+
108
+ #endif /* __TTAGS_H__ */
109
+
110
+
111
+ /* END */
@@ -0,0 +1,59 @@
1
+ /***************************************************************************/
2
+ /* */
3
+ /* ttunpat.h */
4
+ /* */
5
+ /* Definitions for the unpatented TrueType hinting system */
6
+ /* */
7
+ /* Copyright 2003, 2006 by */
8
+ /* David Turner, Robert Wilhelm, and Werner Lemberg. */
9
+ /* */
10
+ /* Written by Graham Asher <graham.asher@btinternet.com> */
11
+ /* */
12
+ /* This file is part of the FreeType project, and may only be used, */
13
+ /* modified, and distributed under the terms of the FreeType project */
14
+ /* license, LICENSE.TXT. By continuing to use, modify, or distribute */
15
+ /* this file you indicate that you have read the license and */
16
+ /* understand and accept it fully. */
17
+ /* */
18
+ /***************************************************************************/
19
+
20
+
21
+ #ifndef __TTUNPAT_H__
22
+ #define __TTUNPAT_H__
23
+
24
+
25
+ #include <ft2build.h>
26
+ #include FT_FREETYPE_H
27
+
28
+ #ifdef FREETYPE_H
29
+ #error "freetype.h of FreeType 1 has been loaded!"
30
+ #error "Please fix the directory search order for header files"
31
+ #error "so that freetype.h of FreeType 2 is found first."
32
+ #endif
33
+
34
+
35
+ FT_BEGIN_HEADER
36
+
37
+
38
+ /***************************************************************************
39
+ *
40
+ * @constant:
41
+ * FT_PARAM_TAG_UNPATENTED_HINTING
42
+ *
43
+ * @description:
44
+ * A constant used as the tag of an @FT_Parameter structure to indicate
45
+ * that unpatented methods only should be used by the TrueType bytecode
46
+ * interpreter for a typeface opened by @FT_Open_Face.
47
+ *
48
+ */
49
+ #define FT_PARAM_TAG_UNPATENTED_HINTING FT_MAKE_TAG( 'u', 'n', 'p', 'a' )
50
+
51
+ /* */
52
+
53
+ FT_END_HEADER
54
+
55
+
56
+ #endif /* __TTUNPAT_H__ */
57
+
58
+
59
+ /* END */
@@ -0,0 +1,3276 @@
1
+
2
+ /* png.h - header file for PNG reference library
3
+ *
4
+ * libpng version 1.6.14 - October 23, 2014
5
+ * Copyright (c) 1998-2014 Glenn Randers-Pehrson
6
+ * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
7
+ * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
8
+ *
9
+ * This code is released under the libpng license (See LICENSE, below)
10
+ *
11
+ * Authors and maintainers:
12
+ * libpng versions 0.71, May 1995, through 0.88, January 1996: Guy Schalnat
13
+ * libpng versions 0.89c, June 1996, through 0.96, May 1997: Andreas Dilger
14
+ * libpng versions 0.97, January 1998, through 1.6.14 - October 23, 2014: Glenn
15
+ * See also "Contributing Authors", below.
16
+ *
17
+ * Note about libpng version numbers:
18
+ *
19
+ * Due to various miscommunications, unforeseen code incompatibilities
20
+ * and occasional factors outside the authors' control, version numbering
21
+ * on the library has not always been consistent and straightforward.
22
+ * The following table summarizes matters since version 0.89c, which was
23
+ * the first widely used release:
24
+ *
25
+ * source png.h png.h shared-lib
26
+ * version string int version
27
+ * ------- ------ ----- ----------
28
+ * 0.89c "1.0 beta 3" 0.89 89 1.0.89
29
+ * 0.90 "1.0 beta 4" 0.90 90 0.90 [should have been 2.0.90]
30
+ * 0.95 "1.0 beta 5" 0.95 95 0.95 [should have been 2.0.95]
31
+ * 0.96 "1.0 beta 6" 0.96 96 0.96 [should have been 2.0.96]
32
+ * 0.97b "1.00.97 beta 7" 1.00.97 97 1.0.1 [should have been 2.0.97]
33
+ * 0.97c 0.97 97 2.0.97
34
+ * 0.98 0.98 98 2.0.98
35
+ * 0.99 0.99 98 2.0.99
36
+ * 0.99a-m 0.99 99 2.0.99
37
+ * 1.00 1.00 100 2.1.0 [100 should be 10000]
38
+ * 1.0.0 (from here on, the 100 2.1.0 [100 should be 10000]
39
+ * 1.0.1 png.h string is 10001 2.1.0
40
+ * 1.0.1a-e identical to the 10002 from here on, the shared library
41
+ * 1.0.2 source version) 10002 is 2.V where V is the source code
42
+ * 1.0.2a-b 10003 version, except as noted.
43
+ * 1.0.3 10003
44
+ * 1.0.3a-d 10004
45
+ * 1.0.4 10004
46
+ * 1.0.4a-f 10005
47
+ * 1.0.5 (+ 2 patches) 10005
48
+ * 1.0.5a-d 10006
49
+ * 1.0.5e-r 10100 (not source compatible)
50
+ * 1.0.5s-v 10006 (not binary compatible)
51
+ * 1.0.6 (+ 3 patches) 10006 (still binary incompatible)
52
+ * 1.0.6d-f 10007 (still binary incompatible)
53
+ * 1.0.6g 10007
54
+ * 1.0.6h 10007 10.6h (testing xy.z so-numbering)
55
+ * 1.0.6i 10007 10.6i
56
+ * 1.0.6j 10007 2.1.0.6j (incompatible with 1.0.0)
57
+ * 1.0.7beta11-14 DLLNUM 10007 2.1.0.7beta11-14 (binary compatible)
58
+ * 1.0.7beta15-18 1 10007 2.1.0.7beta15-18 (binary compatible)
59
+ * 1.0.7rc1-2 1 10007 2.1.0.7rc1-2 (binary compatible)
60
+ * 1.0.7 1 10007 (still compatible)
61
+ * 1.0.8beta1-4 1 10008 2.1.0.8beta1-4
62
+ * 1.0.8rc1 1 10008 2.1.0.8rc1
63
+ * 1.0.8 1 10008 2.1.0.8
64
+ * 1.0.9beta1-6 1 10009 2.1.0.9beta1-6
65
+ * 1.0.9rc1 1 10009 2.1.0.9rc1
66
+ * 1.0.9beta7-10 1 10009 2.1.0.9beta7-10
67
+ * 1.0.9rc2 1 10009 2.1.0.9rc2
68
+ * 1.0.9 1 10009 2.1.0.9
69
+ * 1.0.10beta1 1 10010 2.1.0.10beta1
70
+ * 1.0.10rc1 1 10010 2.1.0.10rc1
71
+ * 1.0.10 1 10010 2.1.0.10
72
+ * 1.0.11beta1-3 1 10011 2.1.0.11beta1-3
73
+ * 1.0.11rc1 1 10011 2.1.0.11rc1
74
+ * 1.0.11 1 10011 2.1.0.11
75
+ * 1.0.12beta1-2 2 10012 2.1.0.12beta1-2
76
+ * 1.0.12rc1 2 10012 2.1.0.12rc1
77
+ * 1.0.12 2 10012 2.1.0.12
78
+ * 1.1.0a-f - 10100 2.1.1.0a-f (branch abandoned)
79
+ * 1.2.0beta1-2 2 10200 2.1.2.0beta1-2
80
+ * 1.2.0beta3-5 3 10200 3.1.2.0beta3-5
81
+ * 1.2.0rc1 3 10200 3.1.2.0rc1
82
+ * 1.2.0 3 10200 3.1.2.0
83
+ * 1.2.1beta1-4 3 10201 3.1.2.1beta1-4
84
+ * 1.2.1rc1-2 3 10201 3.1.2.1rc1-2
85
+ * 1.2.1 3 10201 3.1.2.1
86
+ * 1.2.2beta1-6 12 10202 12.so.0.1.2.2beta1-6
87
+ * 1.0.13beta1 10 10013 10.so.0.1.0.13beta1
88
+ * 1.0.13rc1 10 10013 10.so.0.1.0.13rc1
89
+ * 1.2.2rc1 12 10202 12.so.0.1.2.2rc1
90
+ * 1.0.13 10 10013 10.so.0.1.0.13
91
+ * 1.2.2 12 10202 12.so.0.1.2.2
92
+ * 1.2.3rc1-6 12 10203 12.so.0.1.2.3rc1-6
93
+ * 1.2.3 12 10203 12.so.0.1.2.3
94
+ * 1.2.4beta1-3 13 10204 12.so.0.1.2.4beta1-3
95
+ * 1.0.14rc1 13 10014 10.so.0.1.0.14rc1
96
+ * 1.2.4rc1 13 10204 12.so.0.1.2.4rc1
97
+ * 1.0.14 10 10014 10.so.0.1.0.14
98
+ * 1.2.4 13 10204 12.so.0.1.2.4
99
+ * 1.2.5beta1-2 13 10205 12.so.0.1.2.5beta1-2
100
+ * 1.0.15rc1-3 10 10015 10.so.0.1.0.15rc1-3
101
+ * 1.2.5rc1-3 13 10205 12.so.0.1.2.5rc1-3
102
+ * 1.0.15 10 10015 10.so.0.1.0.15
103
+ * 1.2.5 13 10205 12.so.0.1.2.5
104
+ * 1.2.6beta1-4 13 10206 12.so.0.1.2.6beta1-4
105
+ * 1.0.16 10 10016 10.so.0.1.0.16
106
+ * 1.2.6 13 10206 12.so.0.1.2.6
107
+ * 1.2.7beta1-2 13 10207 12.so.0.1.2.7beta1-2
108
+ * 1.0.17rc1 10 10017 12.so.0.1.0.17rc1
109
+ * 1.2.7rc1 13 10207 12.so.0.1.2.7rc1
110
+ * 1.0.17 10 10017 12.so.0.1.0.17
111
+ * 1.2.7 13 10207 12.so.0.1.2.7
112
+ * 1.2.8beta1-5 13 10208 12.so.0.1.2.8beta1-5
113
+ * 1.0.18rc1-5 10 10018 12.so.0.1.0.18rc1-5
114
+ * 1.2.8rc1-5 13 10208 12.so.0.1.2.8rc1-5
115
+ * 1.0.18 10 10018 12.so.0.1.0.18
116
+ * 1.2.8 13 10208 12.so.0.1.2.8
117
+ * 1.2.9beta1-3 13 10209 12.so.0.1.2.9beta1-3
118
+ * 1.2.9beta4-11 13 10209 12.so.0.9[.0]
119
+ * 1.2.9rc1 13 10209 12.so.0.9[.0]
120
+ * 1.2.9 13 10209 12.so.0.9[.0]
121
+ * 1.2.10beta1-7 13 10210 12.so.0.10[.0]
122
+ * 1.2.10rc1-2 13 10210 12.so.0.10[.0]
123
+ * 1.2.10 13 10210 12.so.0.10[.0]
124
+ * 1.4.0beta1-5 14 10400 14.so.0.0[.0]
125
+ * 1.2.11beta1-4 13 10211 12.so.0.11[.0]
126
+ * 1.4.0beta7-8 14 10400 14.so.0.0[.0]
127
+ * 1.2.11 13 10211 12.so.0.11[.0]
128
+ * 1.2.12 13 10212 12.so.0.12[.0]
129
+ * 1.4.0beta9-14 14 10400 14.so.0.0[.0]
130
+ * 1.2.13 13 10213 12.so.0.13[.0]
131
+ * 1.4.0beta15-36 14 10400 14.so.0.0[.0]
132
+ * 1.4.0beta37-87 14 10400 14.so.14.0[.0]
133
+ * 1.4.0rc01 14 10400 14.so.14.0[.0]
134
+ * 1.4.0beta88-109 14 10400 14.so.14.0[.0]
135
+ * 1.4.0rc02-08 14 10400 14.so.14.0[.0]
136
+ * 1.4.0 14 10400 14.so.14.0[.0]
137
+ * 1.4.1beta01-03 14 10401 14.so.14.1[.0]
138
+ * 1.4.1rc01 14 10401 14.so.14.1[.0]
139
+ * 1.4.1beta04-12 14 10401 14.so.14.1[.0]
140
+ * 1.4.1 14 10401 14.so.14.1[.0]
141
+ * 1.4.2 14 10402 14.so.14.2[.0]
142
+ * 1.4.3 14 10403 14.so.14.3[.0]
143
+ * 1.4.4 14 10404 14.so.14.4[.0]
144
+ * 1.5.0beta01-58 15 10500 15.so.15.0[.0]
145
+ * 1.5.0rc01-07 15 10500 15.so.15.0[.0]
146
+ * 1.5.0 15 10500 15.so.15.0[.0]
147
+ * 1.5.1beta01-11 15 10501 15.so.15.1[.0]
148
+ * 1.5.1rc01-02 15 10501 15.so.15.1[.0]
149
+ * 1.5.1 15 10501 15.so.15.1[.0]
150
+ * 1.5.2beta01-03 15 10502 15.so.15.2[.0]
151
+ * 1.5.2rc01-03 15 10502 15.so.15.2[.0]
152
+ * 1.5.2 15 10502 15.so.15.2[.0]
153
+ * 1.5.3beta01-10 15 10503 15.so.15.3[.0]
154
+ * 1.5.3rc01-02 15 10503 15.so.15.3[.0]
155
+ * 1.5.3beta11 15 10503 15.so.15.3[.0]
156
+ * 1.5.3 [omitted]
157
+ * 1.5.4beta01-08 15 10504 15.so.15.4[.0]
158
+ * 1.5.4rc01 15 10504 15.so.15.4[.0]
159
+ * 1.5.4 15 10504 15.so.15.4[.0]
160
+ * 1.5.5beta01-08 15 10505 15.so.15.5[.0]
161
+ * 1.5.5rc01 15 10505 15.so.15.5[.0]
162
+ * 1.5.5 15 10505 15.so.15.5[.0]
163
+ * 1.5.6beta01-07 15 10506 15.so.15.6[.0]
164
+ * 1.5.6rc01-03 15 10506 15.so.15.6[.0]
165
+ * 1.5.6 15 10506 15.so.15.6[.0]
166
+ * 1.5.7beta01-05 15 10507 15.so.15.7[.0]
167
+ * 1.5.7rc01-03 15 10507 15.so.15.7[.0]
168
+ * 1.5.7 15 10507 15.so.15.7[.0]
169
+ * 1.6.0beta01-40 16 10600 16.so.16.0[.0]
170
+ * 1.6.0rc01-08 16 10600 16.so.16.0[.0]
171
+ * 1.6.0 16 10600 16.so.16.0[.0]
172
+ * 1.6.1beta01-09 16 10601 16.so.16.1[.0]
173
+ * 1.6.1rc01 16 10601 16.so.16.1[.0]
174
+ * 1.6.1 16 10601 16.so.16.1[.0]
175
+ * 1.6.2beta01 16 10602 16.so.16.2[.0]
176
+ * 1.6.2rc01-06 16 10602 16.so.16.2[.0]
177
+ * 1.6.2 16 10602 16.so.16.2[.0]
178
+ * 1.6.3beta01-11 16 10603 16.so.16.3[.0]
179
+ * 1.6.3rc01 16 10603 16.so.16.3[.0]
180
+ * 1.6.3 16 10603 16.so.16.3[.0]
181
+ * 1.6.4beta01-02 16 10604 16.so.16.4[.0]
182
+ * 1.6.4rc01 16 10604 16.so.16.4[.0]
183
+ * 1.6.4 16 10604 16.so.16.4[.0]
184
+ * 1.6.5 16 10605 16.so.16.5[.0]
185
+ * 1.6.6 16 10606 16.so.16.6[.0]
186
+ * 1.6.7beta01-04 16 10607 16.so.16.7[.0]
187
+ * 1.6.7rc01-03 16 10607 16.so.16.7[.0]
188
+ * 1.6.7 16 10607 16.so.16.7[.0]
189
+ * 1.6.8beta01-02 16 10608 16.so.16.8[.0]
190
+ * 1.6.8rc01-02 16 10608 16.so.16.8[.0]
191
+ * 1.6.8 16 10608 16.so.16.8[.0]
192
+ * 1.6.9beta01-04 16 10609 16.so.16.9[.0]
193
+ * 1.6.9rc01-02 16 10609 16.so.16.9[.0]
194
+ * 1.6.9 16 10609 16.so.16.9[.0]
195
+ * 1.6.10beta01-03 16 10610 16.so.16.10[.0]
196
+ * 1.6.10rc01-03 16 10610 16.so.16.10[.0]
197
+ * 1.6.10 16 10610 16.so.16.10[.0]
198
+ * 1.6.11beta01-06 16 10611 16.so.16.11[.0]
199
+ * 1.6.11rc01-02 16 10611 16.so.16.11[.0]
200
+ * 1.6.11 16 10611 16.so.16.11[.0]
201
+ * 1.6.12rc01-03 16 10612 16.so.16.12[.0]
202
+ * 1.6.12 16 10612 16.so.16.12[.0]
203
+ * 1.6.13beta01-04 16 10613 16.so.16.13[.0]
204
+ * 1.6.13rc01-02 16 10613 16.so.16.13[.0]
205
+ * 1.6.13 16 10613 16.so.16.13[.0]
206
+ * 1.6.14beta01-07 16 10614 16.so.16.14[.0]
207
+ * 1.6.14rc01-02 16 10614 16.so.16.14[.0]
208
+ * 1.6.14 16 10614 16.so.16.14[.0]
209
+ *
210
+ * Henceforth the source version will match the shared-library major
211
+ * and minor numbers; the shared-library major version number will be
212
+ * used for changes in backward compatibility, as it is intended. The
213
+ * PNG_LIBPNG_VER macro, which is not used within libpng but is available
214
+ * for applications, is an unsigned integer of the form xyyzz corresponding
215
+ * to the source version x.y.z (leading zeros in y and z). Beta versions
216
+ * were given the previous public release number plus a letter, until
217
+ * version 1.0.6j; from then on they were given the upcoming public
218
+ * release number plus "betaNN" or "rcNN".
219
+ *
220
+ * Binary incompatibility exists only when applications make direct access
221
+ * to the info_ptr or png_ptr members through png.h, and the compiled
222
+ * application is loaded with a different version of the library.
223
+ *
224
+ * DLLNUM will change each time there are forward or backward changes
225
+ * in binary compatibility (e.g., when a new feature is added).
226
+ *
227
+ * See libpng-manual.txt or libpng.3 for more information. The PNG
228
+ * specification is available as a W3C Recommendation and as an ISO
229
+ * Specification, <http://www.w3.org/TR/2003/REC-PNG-20031110/
230
+ */
231
+
232
+ /*
233
+ * COPYRIGHT NOTICE, DISCLAIMER, and LICENSE:
234
+ *
235
+ * If you modify libpng you may insert additional notices immediately following
236
+ * this sentence.
237
+ *
238
+ * This code is released under the libpng license.
239
+ *
240
+ * libpng versions 1.2.6, August 15, 2004, through 1.6.14, October 23, 2014, are
241
+ * Copyright (c) 2004, 2006-2014 Glenn Randers-Pehrson, and are
242
+ * distributed according to the same disclaimer and license as libpng-1.2.5
243
+ * with the following individual added to the list of Contributing Authors:
244
+ *
245
+ * Cosmin Truta
246
+ *
247
+ * libpng versions 1.0.7, July 1, 2000, through 1.2.5, October 3, 2002, are
248
+ * Copyright (c) 2000-2002 Glenn Randers-Pehrson, and are
249
+ * distributed according to the same disclaimer and license as libpng-1.0.6
250
+ * with the following individuals added to the list of Contributing Authors:
251
+ *
252
+ * Simon-Pierre Cadieux
253
+ * Eric S. Raymond
254
+ * Gilles Vollant
255
+ *
256
+ * and with the following additions to the disclaimer:
257
+ *
258
+ * There is no warranty against interference with your enjoyment of the
259
+ * library or against infringement. There is no warranty that our
260
+ * efforts or the library will fulfill any of your particular purposes
261
+ * or needs. This library is provided with all faults, and the entire
262
+ * risk of satisfactory quality, performance, accuracy, and effort is with
263
+ * the user.
264
+ *
265
+ * libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
266
+ * Copyright (c) 1998, 1999, 2000 Glenn Randers-Pehrson, and are
267
+ * distributed according to the same disclaimer and license as libpng-0.96,
268
+ * with the following individuals added to the list of Contributing Authors:
269
+ *
270
+ * Tom Lane
271
+ * Glenn Randers-Pehrson
272
+ * Willem van Schaik
273
+ *
274
+ * libpng versions 0.89, June 1996, through 0.96, May 1997, are
275
+ * Copyright (c) 1996, 1997 Andreas Dilger
276
+ * Distributed according to the same disclaimer and license as libpng-0.88,
277
+ * with the following individuals added to the list of Contributing Authors:
278
+ *
279
+ * John Bowler
280
+ * Kevin Bracey
281
+ * Sam Bushell
282
+ * Magnus Holmgren
283
+ * Greg Roelofs
284
+ * Tom Tanner
285
+ *
286
+ * libpng versions 0.5, May 1995, through 0.88, January 1996, are
287
+ * Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.
288
+ *
289
+ * For the purposes of this copyright and license, "Contributing Authors"
290
+ * is defined as the following set of individuals:
291
+ *
292
+ * Andreas Dilger
293
+ * Dave Martindale
294
+ * Guy Eric Schalnat
295
+ * Paul Schmidt
296
+ * Tim Wegner
297
+ *
298
+ * The PNG Reference Library is supplied "AS IS". The Contributing Authors
299
+ * and Group 42, Inc. disclaim all warranties, expressed or implied,
300
+ * including, without limitation, the warranties of merchantability and of
301
+ * fitness for any purpose. The Contributing Authors and Group 42, Inc.
302
+ * assume no liability for direct, indirect, incidental, special, exemplary,
303
+ * or consequential damages, which may result from the use of the PNG
304
+ * Reference Library, even if advised of the possibility of such damage.
305
+ *
306
+ * Permission is hereby granted to use, copy, modify, and distribute this
307
+ * source code, or portions hereof, for any purpose, without fee, subject
308
+ * to the following restrictions:
309
+ *
310
+ * 1. The origin of this source code must not be misrepresented.
311
+ *
312
+ * 2. Altered versions must be plainly marked as such and must not
313
+ * be misrepresented as being the original source.
314
+ *
315
+ * 3. This Copyright notice may not be removed or altered from
316
+ * any source or altered source distribution.
317
+ *
318
+ * The Contributing Authors and Group 42, Inc. specifically permit, without
319
+ * fee, and encourage the use of this source code as a component to
320
+ * supporting the PNG file format in commercial products. If you use this
321
+ * source code in a product, acknowledgment is not required but would be
322
+ * appreciated.
323
+ */
324
+
325
+ /*
326
+ * A "png_get_copyright" function is available, for convenient use in "about"
327
+ * boxes and the like:
328
+ *
329
+ * printf("%s", png_get_copyright(NULL));
330
+ *
331
+ * Also, the PNG logo (in PNG format, of course) is supplied in the
332
+ * files "pngbar.png" and "pngbar.jpg (88x31) and "pngnow.png" (98x31).
333
+ */
334
+
335
+ /*
336
+ * Libpng is OSI Certified Open Source Software. OSI Certified is a
337
+ * certification mark of the Open Source Initiative.
338
+ */
339
+
340
+ /*
341
+ * The contributing authors would like to thank all those who helped
342
+ * with testing, bug fixes, and patience. This wouldn't have been
343
+ * possible without all of you.
344
+ *
345
+ * Thanks to Frank J. T. Wojcik for helping with the documentation.
346
+ */
347
+
348
+ /*
349
+ * Y2K compliance in libpng:
350
+ * =========================
351
+ *
352
+ * October 23, 2014
353
+ *
354
+ * Since the PNG Development group is an ad-hoc body, we can't make
355
+ * an official declaration.
356
+ *
357
+ * This is your unofficial assurance that libpng from version 0.71 and
358
+ * upward through 1.6.14 are Y2K compliant. It is my belief that
359
+ * earlier versions were also Y2K compliant.
360
+ *
361
+ * Libpng only has two year fields. One is a 2-byte unsigned integer
362
+ * that will hold years up to 65535. The other, which is deprecated,
363
+ * holds the date in text format, and will hold years up to 9999.
364
+ *
365
+ * The integer is
366
+ * "png_uint_16 year" in png_time_struct.
367
+ *
368
+ * The string is
369
+ * "char time_buffer[29]" in png_struct. This is no longer used
370
+ * in libpng-1.6.x and will be removed from libpng-1.7.0.
371
+ *
372
+ * There are seven time-related functions:
373
+ * png.c: png_convert_to_rfc_1123_buffer() in png.c
374
+ * (formerly png_convert_to_rfc_1123() prior to libpng-1.5.x and
375
+ * png_convert_to_rfc_1152() in error prior to libpng-0.98)
376
+ * png_convert_from_struct_tm() in pngwrite.c, called in pngwrite.c
377
+ * png_convert_from_time_t() in pngwrite.c
378
+ * png_get_tIME() in pngget.c
379
+ * png_handle_tIME() in pngrutil.c, called in pngread.c
380
+ * png_set_tIME() in pngset.c
381
+ * png_write_tIME() in pngwutil.c, called in pngwrite.c
382
+ *
383
+ * All handle dates properly in a Y2K environment. The
384
+ * png_convert_from_time_t() function calls gmtime() to convert from system
385
+ * clock time, which returns (year - 1900), which we properly convert to
386
+ * the full 4-digit year. There is a possibility that libpng applications
387
+ * are not passing 4-digit years into the png_convert_to_rfc_1123_buffer()
388
+ * function, or that they are incorrectly passing only a 2-digit year
389
+ * instead of "year - 1900" into the png_convert_from_struct_tm() function,
390
+ * but this is not under our control. The libpng documentation has always
391
+ * stated that it works with 4-digit years, and the APIs have been
392
+ * documented as such.
393
+ *
394
+ * The tIME chunk itself is also Y2K compliant. It uses a 2-byte unsigned
395
+ * integer to hold the year, and can hold years as large as 65535.
396
+ *
397
+ * zlib, upon which libpng depends, is also Y2K compliant. It contains
398
+ * no date-related code.
399
+ *
400
+ * Glenn Randers-Pehrson
401
+ * libpng maintainer
402
+ * PNG Development Group
403
+ */
404
+
405
+ #ifndef PNG_H
406
+ #define PNG_H
407
+
408
+ /* This is not the place to learn how to use libpng. The file libpng-manual.txt
409
+ * describes how to use libpng, and the file example.c summarizes it
410
+ * with some code on which to build. This file is useful for looking
411
+ * at the actual function definitions and structure components. If that
412
+ * file has been stripped from your copy of libpng, you can find it at
413
+ * <http://www.libpng.org/pub/png/libpng-manual.txt>
414
+ *
415
+ * If you just need to read a PNG file and don't want to read the documentation
416
+ * skip to the end of this file and read the section entitled 'simplified API'.
417
+ */
418
+
419
+ /* Version information for png.h - this should match the version in png.c */
420
+ #define PNG_LIBPNG_VER_STRING "1.6.14"
421
+ #define PNG_HEADER_VERSION_STRING \
422
+ " libpng version 1.6.14 - October 23, 2014\n"
423
+
424
+ #define PNG_LIBPNG_VER_SONUM 16
425
+ #define PNG_LIBPNG_VER_DLLNUM 16
426
+
427
+ /* These should match the first 3 components of PNG_LIBPNG_VER_STRING: */
428
+ #define PNG_LIBPNG_VER_MAJOR 1
429
+ #define PNG_LIBPNG_VER_MINOR 6
430
+ #define PNG_LIBPNG_VER_RELEASE 14
431
+
432
+ /* This should match the numeric part of the final component of
433
+ * PNG_LIBPNG_VER_STRING, omitting any leading zero:
434
+ */
435
+
436
+ #define PNG_LIBPNG_VER_BUILD 0
437
+
438
+ /* Release Status */
439
+ #define PNG_LIBPNG_BUILD_ALPHA 1
440
+ #define PNG_LIBPNG_BUILD_BETA 2
441
+ #define PNG_LIBPNG_BUILD_RC 3
442
+ #define PNG_LIBPNG_BUILD_STABLE 4
443
+ #define PNG_LIBPNG_BUILD_RELEASE_STATUS_MASK 7
444
+
445
+ /* Release-Specific Flags */
446
+ #define PNG_LIBPNG_BUILD_PATCH 8 /* Can be OR'ed with
447
+ PNG_LIBPNG_BUILD_STABLE only */
448
+ #define PNG_LIBPNG_BUILD_PRIVATE 16 /* Cannot be OR'ed with
449
+ PNG_LIBPNG_BUILD_SPECIAL */
450
+ #define PNG_LIBPNG_BUILD_SPECIAL 32 /* Cannot be OR'ed with
451
+ PNG_LIBPNG_BUILD_PRIVATE */
452
+
453
+ #define PNG_LIBPNG_BUILD_BASE_TYPE PNG_LIBPNG_BUILD_STABLE
454
+
455
+ /* Careful here. At one time, Guy wanted to use 082, but that would be octal.
456
+ * We must not include leading zeros.
457
+ * Versions 0.7 through 1.0.0 were in the range 0 to 100 here (only
458
+ * version 1.0.0 was mis-numbered 100 instead of 10000). From
459
+ * version 1.0.1 it's xxyyzz, where x=major, y=minor, z=release
460
+ */
461
+ #define PNG_LIBPNG_VER 10614 /* 1.6.14 */
462
+
463
+ /* Library configuration: these options cannot be changed after
464
+ * the library has been built.
465
+ */
466
+ #ifndef PNGLCONF_H
467
+ /* If pnglibconf.h is missing, you can
468
+ * copy scripts/pnglibconf.h.prebuilt to pnglibconf.h
469
+ */
470
+ # include "pnglibconf.h"
471
+ #endif
472
+
473
+ #ifndef PNG_VERSION_INFO_ONLY
474
+ /* Machine specific configuration. */
475
+ # include "pngconf.h"
476
+ #endif
477
+
478
+ /*
479
+ * Added at libpng-1.2.8
480
+ *
481
+ * Ref MSDN: Private as priority over Special
482
+ * VS_FF_PRIVATEBUILD File *was not* built using standard release
483
+ * procedures. If this value is given, the StringFileInfo block must
484
+ * contain a PrivateBuild string.
485
+ *
486
+ * VS_FF_SPECIALBUILD File *was* built by the original company using
487
+ * standard release procedures but is a variation of the standard
488
+ * file of the same version number. If this value is given, the
489
+ * StringFileInfo block must contain a SpecialBuild string.
490
+ */
491
+
492
+ #ifdef PNG_USER_PRIVATEBUILD /* From pnglibconf.h */
493
+ # define PNG_LIBPNG_BUILD_TYPE \
494
+ (PNG_LIBPNG_BUILD_BASE_TYPE | PNG_LIBPNG_BUILD_PRIVATE)
495
+ #else
496
+ # ifdef PNG_LIBPNG_SPECIALBUILD
497
+ # define PNG_LIBPNG_BUILD_TYPE \
498
+ (PNG_LIBPNG_BUILD_BASE_TYPE | PNG_LIBPNG_BUILD_SPECIAL)
499
+ # else
500
+ # define PNG_LIBPNG_BUILD_TYPE (PNG_LIBPNG_BUILD_BASE_TYPE)
501
+ # endif
502
+ #endif
503
+
504
+ #ifndef PNG_VERSION_INFO_ONLY
505
+
506
+ /* Inhibit C++ name-mangling for libpng functions but not for system calls. */
507
+ #ifdef __cplusplus
508
+ extern "C" {
509
+ #endif /* __cplusplus */
510
+
511
+ /* Version information for C files, stored in png.c. This had better match
512
+ * the version above.
513
+ */
514
+ #define png_libpng_ver png_get_header_ver(NULL)
515
+
516
+ /* This file is arranged in several sections:
517
+ *
518
+ * 1. Any configuration options that can be specified by for the application
519
+ * code when it is built. (Build time configuration is in pnglibconf.h)
520
+ * 2. Type definitions (base types are defined in pngconf.h), structure
521
+ * definitions.
522
+ * 3. Exported library functions.
523
+ * 4. Simplified API.
524
+ *
525
+ * The library source code has additional files (principally pngpriv.h) that
526
+ * allow configuration of the library.
527
+ */
528
+ /* Section 1: run time configuration
529
+ * See pnglibconf.h for build time configuration
530
+ *
531
+ * Run time configuration allows the application to choose between
532
+ * implementations of certain arithmetic APIs. The default is set
533
+ * at build time and recorded in pnglibconf.h, but it is safe to
534
+ * override these (and only these) settings. Note that this won't
535
+ * change what the library does, only application code, and the
536
+ * settings can (and probably should) be made on a per-file basis
537
+ * by setting the #defines before including png.h
538
+ *
539
+ * Use macros to read integers from PNG data or use the exported
540
+ * functions?
541
+ * PNG_USE_READ_MACROS: use the macros (see below) Note that
542
+ * the macros evaluate their argument multiple times.
543
+ * PNG_NO_USE_READ_MACROS: call the relevant library function.
544
+ *
545
+ * Use the alternative algorithm for compositing alpha samples that
546
+ * does not use division?
547
+ * PNG_READ_COMPOSITE_NODIV_SUPPORTED: use the 'no division'
548
+ * algorithm.
549
+ * PNG_NO_READ_COMPOSITE_NODIV: use the 'division' algorithm.
550
+ *
551
+ * How to handle benign errors if PNG_ALLOW_BENIGN_ERRORS is
552
+ * false?
553
+ * PNG_ALLOW_BENIGN_ERRORS: map calls to the benign error
554
+ * APIs to png_warning.
555
+ * Otherwise the calls are mapped to png_error.
556
+ */
557
+
558
+ /* Section 2: type definitions, including structures and compile time
559
+ * constants.
560
+ * See pngconf.h for base types that vary by machine/system
561
+ */
562
+
563
+ /* This triggers a compiler error in png.c, if png.c and png.h
564
+ * do not agree upon the version number.
565
+ */
566
+ typedef char* png_libpng_version_1_6_14;
567
+
568
+ /* Basic control structions. Read libpng-manual.txt or libpng.3 for more info.
569
+ *
570
+ * png_struct is the cache of information used while reading or writing a single
571
+ * PNG file. One of these is always required, although the simplified API
572
+ * (below) hides the creation and destruction of it.
573
+ */
574
+ typedef struct png_struct_def png_struct;
575
+ typedef const png_struct * png_const_structp;
576
+ typedef png_struct * png_structp;
577
+ typedef png_struct * * png_structpp;
578
+
579
+ /* png_info contains information read from or to be written to a PNG file. One
580
+ * or more of these must exist while reading or creating a PNG file. The
581
+ * information is not used by libpng during read but is used to control what
582
+ * gets written when a PNG file is created. "png_get_" function calls read
583
+ * information during read and "png_set_" functions calls write information
584
+ * when creating a PNG.
585
+ * been moved into a separate header file that is not accessible to
586
+ * applications. Read libpng-manual.txt or libpng.3 for more info.
587
+ */
588
+ typedef struct png_info_def png_info;
589
+ typedef png_info * png_infop;
590
+ typedef const png_info * png_const_infop;
591
+ typedef png_info * * png_infopp;
592
+
593
+ /* Types with names ending 'p' are pointer types. The corresponding types with
594
+ * names ending 'rp' are identical pointer types except that the pointer is
595
+ * marked 'restrict', which means that it is the only pointer to the object
596
+ * passed to the function. Applications should not use the 'restrict' types;
597
+ * it is always valid to pass 'p' to a pointer with a function argument of the
598
+ * corresponding 'rp' type. Different compilers have different rules with
599
+ * regard to type matching in the presence of 'restrict'. For backward
600
+ * compatibility libpng callbacks never have 'restrict' in their parameters and,
601
+ * consequentially, writing portable application code is extremely difficult if
602
+ * an attempt is made to use 'restrict'.
603
+ */
604
+ typedef png_struct * PNG_RESTRICT png_structrp;
605
+ typedef const png_struct * PNG_RESTRICT png_const_structrp;
606
+ typedef png_info * PNG_RESTRICT png_inforp;
607
+ typedef const png_info * PNG_RESTRICT png_const_inforp;
608
+
609
+ /* Three color definitions. The order of the red, green, and blue, (and the
610
+ * exact size) is not important, although the size of the fields need to
611
+ * be png_byte or png_uint_16 (as defined below).
612
+ */
613
+ typedef struct png_color_struct
614
+ {
615
+ png_byte red;
616
+ png_byte green;
617
+ png_byte blue;
618
+ } png_color;
619
+ typedef png_color * png_colorp;
620
+ typedef const png_color * png_const_colorp;
621
+ typedef png_color * * png_colorpp;
622
+
623
+ typedef struct png_color_16_struct
624
+ {
625
+ png_byte index; /* used for palette files */
626
+ png_uint_16 red; /* for use in red green blue files */
627
+ png_uint_16 green;
628
+ png_uint_16 blue;
629
+ png_uint_16 gray; /* for use in grayscale files */
630
+ } png_color_16;
631
+ typedef png_color_16 * png_color_16p;
632
+ typedef const png_color_16 * png_const_color_16p;
633
+ typedef png_color_16 * * png_color_16pp;
634
+
635
+ typedef struct png_color_8_struct
636
+ {
637
+ png_byte red; /* for use in red green blue files */
638
+ png_byte green;
639
+ png_byte blue;
640
+ png_byte gray; /* for use in grayscale files */
641
+ png_byte alpha; /* for alpha channel files */
642
+ } png_color_8;
643
+ typedef png_color_8 * png_color_8p;
644
+ typedef const png_color_8 * png_const_color_8p;
645
+ typedef png_color_8 * * png_color_8pp;
646
+
647
+ /*
648
+ * The following two structures are used for the in-core representation
649
+ * of sPLT chunks.
650
+ */
651
+ typedef struct png_sPLT_entry_struct
652
+ {
653
+ png_uint_16 red;
654
+ png_uint_16 green;
655
+ png_uint_16 blue;
656
+ png_uint_16 alpha;
657
+ png_uint_16 frequency;
658
+ } png_sPLT_entry;
659
+ typedef png_sPLT_entry * png_sPLT_entryp;
660
+ typedef const png_sPLT_entry * png_const_sPLT_entryp;
661
+ typedef png_sPLT_entry * * png_sPLT_entrypp;
662
+
663
+ /* When the depth of the sPLT palette is 8 bits, the color and alpha samples
664
+ * occupy the LSB of their respective members, and the MSB of each member
665
+ * is zero-filled. The frequency member always occupies the full 16 bits.
666
+ */
667
+
668
+ typedef struct png_sPLT_struct
669
+ {
670
+ png_charp name; /* palette name */
671
+ png_byte depth; /* depth of palette samples */
672
+ png_sPLT_entryp entries; /* palette entries */
673
+ png_int_32 nentries; /* number of palette entries */
674
+ } png_sPLT_t;
675
+ typedef png_sPLT_t * png_sPLT_tp;
676
+ typedef const png_sPLT_t * png_const_sPLT_tp;
677
+ typedef png_sPLT_t * * png_sPLT_tpp;
678
+
679
+ #ifdef PNG_TEXT_SUPPORTED
680
+ /* png_text holds the contents of a text/ztxt/itxt chunk in a PNG file,
681
+ * and whether that contents is compressed or not. The "key" field
682
+ * points to a regular zero-terminated C string. The "text" fields can be a
683
+ * regular C string, an empty string, or a NULL pointer.
684
+ * However, the structure returned by png_get_text() will always contain
685
+ * the "text" field as a regular zero-terminated C string (possibly
686
+ * empty), never a NULL pointer, so it can be safely used in printf() and
687
+ * other string-handling functions. Note that the "itxt_length", "lang", and
688
+ * "lang_key" members of the structure only exist when the library is built
689
+ * with iTXt chunk support. Prior to libpng-1.4.0 the library was built by
690
+ * default without iTXt support. Also note that when iTXt *is* supported,
691
+ * the "lang" and "lang_key" fields contain NULL pointers when the
692
+ * "compression" field contains * PNG_TEXT_COMPRESSION_NONE or
693
+ * PNG_TEXT_COMPRESSION_zTXt. Note that the "compression value" is not the
694
+ * same as what appears in the PNG tEXt/zTXt/iTXt chunk's "compression flag"
695
+ * which is always 0 or 1, or its "compression method" which is always 0.
696
+ */
697
+ typedef struct png_text_struct
698
+ {
699
+ int compression; /* compression value:
700
+ -1: tEXt, none
701
+ 0: zTXt, deflate
702
+ 1: iTXt, none
703
+ 2: iTXt, deflate */
704
+ png_charp key; /* keyword, 1-79 character description of "text" */
705
+ png_charp text; /* comment, may be an empty string (ie "")
706
+ or a NULL pointer */
707
+ png_size_t text_length; /* length of the text string */
708
+ png_size_t itxt_length; /* length of the itxt string */
709
+ png_charp lang; /* language code, 0-79 characters
710
+ or a NULL pointer */
711
+ png_charp lang_key; /* keyword translated UTF-8 string, 0 or more
712
+ chars or a NULL pointer */
713
+ } png_text;
714
+ typedef png_text * png_textp;
715
+ typedef const png_text * png_const_textp;
716
+ typedef png_text * * png_textpp;
717
+ #endif
718
+
719
+ /* Supported compression types for text in PNG files (tEXt, and zTXt).
720
+ * The values of the PNG_TEXT_COMPRESSION_ defines should NOT be changed. */
721
+ #define PNG_TEXT_COMPRESSION_NONE_WR -3
722
+ #define PNG_TEXT_COMPRESSION_zTXt_WR -2
723
+ #define PNG_TEXT_COMPRESSION_NONE -1
724
+ #define PNG_TEXT_COMPRESSION_zTXt 0
725
+ #define PNG_ITXT_COMPRESSION_NONE 1
726
+ #define PNG_ITXT_COMPRESSION_zTXt 2
727
+ #define PNG_TEXT_COMPRESSION_LAST 3 /* Not a valid value */
728
+
729
+ /* png_time is a way to hold the time in an machine independent way.
730
+ * Two conversions are provided, both from time_t and struct tm. There
731
+ * is no portable way to convert to either of these structures, as far
732
+ * as I know. If you know of a portable way, send it to me. As a side
733
+ * note - PNG has always been Year 2000 compliant!
734
+ */
735
+ typedef struct png_time_struct
736
+ {
737
+ png_uint_16 year; /* full year, as in, 1995 */
738
+ png_byte month; /* month of year, 1 - 12 */
739
+ png_byte day; /* day of month, 1 - 31 */
740
+ png_byte hour; /* hour of day, 0 - 23 */
741
+ png_byte minute; /* minute of hour, 0 - 59 */
742
+ png_byte second; /* second of minute, 0 - 60 (for leap seconds) */
743
+ } png_time;
744
+ typedef png_time * png_timep;
745
+ typedef const png_time * png_const_timep;
746
+ typedef png_time * * png_timepp;
747
+
748
+ #if defined(PNG_STORE_UNKNOWN_CHUNKS_SUPPORTED) ||\
749
+ defined(PNG_USER_CHUNKS_SUPPORTED)
750
+ /* png_unknown_chunk is a structure to hold queued chunks for which there is
751
+ * no specific support. The idea is that we can use this to queue
752
+ * up private chunks for output even though the library doesn't actually
753
+ * know about their semantics.
754
+ *
755
+ * The data in the structure is set by libpng on read and used on write.
756
+ */
757
+ typedef struct png_unknown_chunk_t
758
+ {
759
+ png_byte name[5]; /* Textual chunk name with '\0' terminator */
760
+ png_byte *data; /* Data, should not be modified on read! */
761
+ png_size_t size;
762
+
763
+ /* On write 'location' must be set using the flag values listed below.
764
+ * Notice that on read it is set by libpng however the values stored have
765
+ * more bits set than are listed below. Always treat the value as a
766
+ * bitmask. On write set only one bit - setting multiple bits may cause the
767
+ * chunk to be written in multiple places.
768
+ */
769
+ png_byte location; /* mode of operation at read time */
770
+ }
771
+ png_unknown_chunk;
772
+
773
+ typedef png_unknown_chunk * png_unknown_chunkp;
774
+ typedef const png_unknown_chunk * png_const_unknown_chunkp;
775
+ typedef png_unknown_chunk * * png_unknown_chunkpp;
776
+ #endif
777
+
778
+ /* Flag values for the unknown chunk location byte. */
779
+ #define PNG_HAVE_IHDR 0x01
780
+ #define PNG_HAVE_PLTE 0x02
781
+ #define PNG_AFTER_IDAT 0x08
782
+
783
+ /* Maximum positive integer used in PNG is (2^31)-1 */
784
+ #define PNG_UINT_31_MAX ((png_uint_32)0x7fffffffL)
785
+ #define PNG_UINT_32_MAX ((png_uint_32)(-1))
786
+ #define PNG_SIZE_MAX ((png_size_t)(-1))
787
+
788
+ /* These are constants for fixed point values encoded in the
789
+ * PNG specification manner (x100000)
790
+ */
791
+ #define PNG_FP_1 100000
792
+ #define PNG_FP_HALF 50000
793
+ #define PNG_FP_MAX ((png_fixed_point)0x7fffffffL)
794
+ #define PNG_FP_MIN (-PNG_FP_MAX)
795
+
796
+ /* These describe the color_type field in png_info. */
797
+ /* color type masks */
798
+ #define PNG_COLOR_MASK_PALETTE 1
799
+ #define PNG_COLOR_MASK_COLOR 2
800
+ #define PNG_COLOR_MASK_ALPHA 4
801
+
802
+ /* color types. Note that not all combinations are legal */
803
+ #define PNG_COLOR_TYPE_GRAY 0
804
+ #define PNG_COLOR_TYPE_PALETTE (PNG_COLOR_MASK_COLOR | PNG_COLOR_MASK_PALETTE)
805
+ #define PNG_COLOR_TYPE_RGB (PNG_COLOR_MASK_COLOR)
806
+ #define PNG_COLOR_TYPE_RGB_ALPHA (PNG_COLOR_MASK_COLOR | PNG_COLOR_MASK_ALPHA)
807
+ #define PNG_COLOR_TYPE_GRAY_ALPHA (PNG_COLOR_MASK_ALPHA)
808
+ /* aliases */
809
+ #define PNG_COLOR_TYPE_RGBA PNG_COLOR_TYPE_RGB_ALPHA
810
+ #define PNG_COLOR_TYPE_GA PNG_COLOR_TYPE_GRAY_ALPHA
811
+
812
+ /* This is for compression type. PNG 1.0-1.2 only define the single type. */
813
+ #define PNG_COMPRESSION_TYPE_BASE 0 /* Deflate method 8, 32K window */
814
+ #define PNG_COMPRESSION_TYPE_DEFAULT PNG_COMPRESSION_TYPE_BASE
815
+
816
+ /* This is for filter type. PNG 1.0-1.2 only define the single type. */
817
+ #define PNG_FILTER_TYPE_BASE 0 /* Single row per-byte filtering */
818
+ #define PNG_INTRAPIXEL_DIFFERENCING 64 /* Used only in MNG datastreams */
819
+ #define PNG_FILTER_TYPE_DEFAULT PNG_FILTER_TYPE_BASE
820
+
821
+ /* These are for the interlacing type. These values should NOT be changed. */
822
+ #define PNG_INTERLACE_NONE 0 /* Non-interlaced image */
823
+ #define PNG_INTERLACE_ADAM7 1 /* Adam7 interlacing */
824
+ #define PNG_INTERLACE_LAST 2 /* Not a valid value */
825
+
826
+ /* These are for the oFFs chunk. These values should NOT be changed. */
827
+ #define PNG_OFFSET_PIXEL 0 /* Offset in pixels */
828
+ #define PNG_OFFSET_MICROMETER 1 /* Offset in micrometers (1/10^6 meter) */
829
+ #define PNG_OFFSET_LAST 2 /* Not a valid value */
830
+
831
+ /* These are for the pCAL chunk. These values should NOT be changed. */
832
+ #define PNG_EQUATION_LINEAR 0 /* Linear transformation */
833
+ #define PNG_EQUATION_BASE_E 1 /* Exponential base e transform */
834
+ #define PNG_EQUATION_ARBITRARY 2 /* Arbitrary base exponential transform */
835
+ #define PNG_EQUATION_HYPERBOLIC 3 /* Hyperbolic sine transformation */
836
+ #define PNG_EQUATION_LAST 4 /* Not a valid value */
837
+
838
+ /* These are for the sCAL chunk. These values should NOT be changed. */
839
+ #define PNG_SCALE_UNKNOWN 0 /* unknown unit (image scale) */
840
+ #define PNG_SCALE_METER 1 /* meters per pixel */
841
+ #define PNG_SCALE_RADIAN 2 /* radians per pixel */
842
+ #define PNG_SCALE_LAST 3 /* Not a valid value */
843
+
844
+ /* These are for the pHYs chunk. These values should NOT be changed. */
845
+ #define PNG_RESOLUTION_UNKNOWN 0 /* pixels/unknown unit (aspect ratio) */
846
+ #define PNG_RESOLUTION_METER 1 /* pixels/meter */
847
+ #define PNG_RESOLUTION_LAST 2 /* Not a valid value */
848
+
849
+ /* These are for the sRGB chunk. These values should NOT be changed. */
850
+ #define PNG_sRGB_INTENT_PERCEPTUAL 0
851
+ #define PNG_sRGB_INTENT_RELATIVE 1
852
+ #define PNG_sRGB_INTENT_SATURATION 2
853
+ #define PNG_sRGB_INTENT_ABSOLUTE 3
854
+ #define PNG_sRGB_INTENT_LAST 4 /* Not a valid value */
855
+
856
+ /* This is for text chunks */
857
+ #define PNG_KEYWORD_MAX_LENGTH 79
858
+
859
+ /* Maximum number of entries in PLTE/sPLT/tRNS arrays */
860
+ #define PNG_MAX_PALETTE_LENGTH 256
861
+
862
+ /* These determine if an ancillary chunk's data has been successfully read
863
+ * from the PNG header, or if the application has filled in the corresponding
864
+ * data in the info_struct to be written into the output file. The values
865
+ * of the PNG_INFO_<chunk> defines should NOT be changed.
866
+ */
867
+ #define PNG_INFO_gAMA 0x0001
868
+ #define PNG_INFO_sBIT 0x0002
869
+ #define PNG_INFO_cHRM 0x0004
870
+ #define PNG_INFO_PLTE 0x0008
871
+ #define PNG_INFO_tRNS 0x0010
872
+ #define PNG_INFO_bKGD 0x0020
873
+ #define PNG_INFO_hIST 0x0040
874
+ #define PNG_INFO_pHYs 0x0080
875
+ #define PNG_INFO_oFFs 0x0100
876
+ #define PNG_INFO_tIME 0x0200
877
+ #define PNG_INFO_pCAL 0x0400
878
+ #define PNG_INFO_sRGB 0x0800 /* GR-P, 0.96a */
879
+ #define PNG_INFO_iCCP 0x1000 /* ESR, 1.0.6 */
880
+ #define PNG_INFO_sPLT 0x2000 /* ESR, 1.0.6 */
881
+ #define PNG_INFO_sCAL 0x4000 /* ESR, 1.0.6 */
882
+ #define PNG_INFO_IDAT 0x8000 /* ESR, 1.0.6 */
883
+
884
+ /* This is used for the transformation routines, as some of them
885
+ * change these values for the row. It also should enable using
886
+ * the routines for other purposes.
887
+ */
888
+ typedef struct png_row_info_struct
889
+ {
890
+ png_uint_32 width; /* width of row */
891
+ png_size_t rowbytes; /* number of bytes in row */
892
+ png_byte color_type; /* color type of row */
893
+ png_byte bit_depth; /* bit depth of row */
894
+ png_byte channels; /* number of channels (1, 2, 3, or 4) */
895
+ png_byte pixel_depth; /* bits per pixel (depth * channels) */
896
+ } png_row_info;
897
+
898
+ typedef png_row_info * png_row_infop;
899
+ typedef png_row_info * * png_row_infopp;
900
+
901
+ /* These are the function types for the I/O functions and for the functions
902
+ * that allow the user to override the default I/O functions with his or her
903
+ * own. The png_error_ptr type should match that of user-supplied warning
904
+ * and error functions, while the png_rw_ptr type should match that of the
905
+ * user read/write data functions. Note that the 'write' function must not
906
+ * modify the buffer it is passed. The 'read' function, on the other hand, is
907
+ * expected to return the read data in the buffer.
908
+ */
909
+ typedef PNG_CALLBACK(void, *png_error_ptr, (png_structp, png_const_charp));
910
+ typedef PNG_CALLBACK(void, *png_rw_ptr, (png_structp, png_bytep, png_size_t));
911
+ typedef PNG_CALLBACK(void, *png_flush_ptr, (png_structp));
912
+ typedef PNG_CALLBACK(void, *png_read_status_ptr, (png_structp, png_uint_32,
913
+ int));
914
+ typedef PNG_CALLBACK(void, *png_write_status_ptr, (png_structp, png_uint_32,
915
+ int));
916
+
917
+ #ifdef PNG_PROGRESSIVE_READ_SUPPORTED
918
+ typedef PNG_CALLBACK(void, *png_progressive_info_ptr, (png_structp, png_infop));
919
+ typedef PNG_CALLBACK(void, *png_progressive_end_ptr, (png_structp, png_infop));
920
+
921
+ /* The following callback receives png_uint_32 row_number, int pass for the
922
+ * png_bytep data of the row. When transforming an interlaced image the
923
+ * row number is the row number within the sub-image of the interlace pass, so
924
+ * the value will increase to the height of the sub-image (not the full image)
925
+ * then reset to 0 for the next pass.
926
+ *
927
+ * Use PNG_ROW_FROM_PASS_ROW(row, pass) and PNG_COL_FROM_PASS_COL(col, pass) to
928
+ * find the output pixel (x,y) given an interlaced sub-image pixel
929
+ * (row,col,pass). (See below for these macros.)
930
+ */
931
+ typedef PNG_CALLBACK(void, *png_progressive_row_ptr, (png_structp, png_bytep,
932
+ png_uint_32, int));
933
+ #endif
934
+
935
+ #if defined(PNG_READ_USER_TRANSFORM_SUPPORTED) || \
936
+ defined(PNG_WRITE_USER_TRANSFORM_SUPPORTED)
937
+ typedef PNG_CALLBACK(void, *png_user_transform_ptr, (png_structp, png_row_infop,
938
+ png_bytep));
939
+ #endif
940
+
941
+ #ifdef PNG_USER_CHUNKS_SUPPORTED
942
+ typedef PNG_CALLBACK(int, *png_user_chunk_ptr, (png_structp,
943
+ png_unknown_chunkp));
944
+ #endif
945
+ #ifdef PNG_UNKNOWN_CHUNKS_SUPPORTED
946
+ /* not used anywhere */
947
+ /* typedef PNG_CALLBACK(void, *png_unknown_chunk_ptr, (png_structp)); */
948
+ #endif
949
+
950
+ #ifdef PNG_SETJMP_SUPPORTED
951
+ /* This must match the function definition in <setjmp.h>, and the application
952
+ * must include this before png.h to obtain the definition of jmp_buf. The
953
+ * function is required to be PNG_NORETURN, but this is not checked. If the
954
+ * function does return the application will crash via an abort() or similar
955
+ * system level call.
956
+ *
957
+ * If you get a warning here while building the library you may need to make
958
+ * changes to ensure that pnglibconf.h records the calling convention used by
959
+ * your compiler. This may be very difficult - try using a different compiler
960
+ * to build the library!
961
+ */
962
+ PNG_FUNCTION(void, (PNGCAPI *png_longjmp_ptr), PNGARG((jmp_buf, int)), typedef);
963
+ #endif
964
+
965
+ /* Transform masks for the high-level interface */
966
+ #define PNG_TRANSFORM_IDENTITY 0x0000 /* read and write */
967
+ #define PNG_TRANSFORM_STRIP_16 0x0001 /* read only */
968
+ #define PNG_TRANSFORM_STRIP_ALPHA 0x0002 /* read only */
969
+ #define PNG_TRANSFORM_PACKING 0x0004 /* read and write */
970
+ #define PNG_TRANSFORM_PACKSWAP 0x0008 /* read and write */
971
+ #define PNG_TRANSFORM_EXPAND 0x0010 /* read only */
972
+ #define PNG_TRANSFORM_INVERT_MONO 0x0020 /* read and write */
973
+ #define PNG_TRANSFORM_SHIFT 0x0040 /* read and write */
974
+ #define PNG_TRANSFORM_BGR 0x0080 /* read and write */
975
+ #define PNG_TRANSFORM_SWAP_ALPHA 0x0100 /* read and write */
976
+ #define PNG_TRANSFORM_SWAP_ENDIAN 0x0200 /* read and write */
977
+ #define PNG_TRANSFORM_INVERT_ALPHA 0x0400 /* read and write */
978
+ #define PNG_TRANSFORM_STRIP_FILLER 0x0800 /* write only */
979
+ /* Added to libpng-1.2.34 */
980
+ #define PNG_TRANSFORM_STRIP_FILLER_BEFORE PNG_TRANSFORM_STRIP_FILLER
981
+ #define PNG_TRANSFORM_STRIP_FILLER_AFTER 0x1000 /* write only */
982
+ /* Added to libpng-1.4.0 */
983
+ #define PNG_TRANSFORM_GRAY_TO_RGB 0x2000 /* read only */
984
+ /* Added to libpng-1.5.4 */
985
+ #define PNG_TRANSFORM_EXPAND_16 0x4000 /* read only */
986
+ #define PNG_TRANSFORM_SCALE_16 0x8000 /* read only */
987
+
988
+ /* Flags for MNG supported features */
989
+ #define PNG_FLAG_MNG_EMPTY_PLTE 0x01
990
+ #define PNG_FLAG_MNG_FILTER_64 0x04
991
+ #define PNG_ALL_MNG_FEATURES 0x05
992
+
993
+ /* NOTE: prior to 1.5 these functions had no 'API' style declaration,
994
+ * this allowed the zlib default functions to be used on Windows
995
+ * platforms. In 1.5 the zlib default malloc (which just calls malloc and
996
+ * ignores the first argument) should be completely compatible with the
997
+ * following.
998
+ */
999
+ typedef PNG_CALLBACK(png_voidp, *png_malloc_ptr, (png_structp,
1000
+ png_alloc_size_t));
1001
+ typedef PNG_CALLBACK(void, *png_free_ptr, (png_structp, png_voidp));
1002
+
1003
+ /* Section 3: exported functions
1004
+ * Here are the function definitions most commonly used. This is not
1005
+ * the place to find out how to use libpng. See libpng-manual.txt for the
1006
+ * full explanation, see example.c for the summary. This just provides
1007
+ * a simple one line description of the use of each function.
1008
+ *
1009
+ * The PNG_EXPORT() and PNG_EXPORTA() macros used below are defined in
1010
+ * pngconf.h and in the *.dfn files in the scripts directory.
1011
+ *
1012
+ * PNG_EXPORT(ordinal, type, name, (args));
1013
+ *
1014
+ * ordinal: ordinal that is used while building
1015
+ * *.def files. The ordinal value is only
1016
+ * relevant when preprocessing png.h with
1017
+ * the *.dfn files for building symbol table
1018
+ * entries, and are removed by pngconf.h.
1019
+ * type: return type of the function
1020
+ * name: function name
1021
+ * args: function arguments, with types
1022
+ *
1023
+ * When we wish to append attributes to a function prototype we use
1024
+ * the PNG_EXPORTA() macro instead.
1025
+ *
1026
+ * PNG_EXPORTA(ordinal, type, name, (args), attributes);
1027
+ *
1028
+ * ordinal, type, name, and args: same as in PNG_EXPORT().
1029
+ * attributes: function attributes
1030
+ */
1031
+
1032
+ /* Returns the version number of the library */
1033
+ PNG_EXPORT(1, png_uint_32, png_access_version_number, (void));
1034
+
1035
+ /* Tell lib we have already handled the first <num_bytes> magic bytes.
1036
+ * Handling more than 8 bytes from the beginning of the file is an error.
1037
+ */
1038
+ PNG_EXPORT(2, void, png_set_sig_bytes, (png_structrp png_ptr, int num_bytes));
1039
+
1040
+ /* Check sig[start] through sig[start + num_to_check - 1] to see if it's a
1041
+ * PNG file. Returns zero if the supplied bytes match the 8-byte PNG
1042
+ * signature, and non-zero otherwise. Having num_to_check == 0 or
1043
+ * start > 7 will always fail (ie return non-zero).
1044
+ */
1045
+ PNG_EXPORT(3, int, png_sig_cmp, (png_const_bytep sig, png_size_t start,
1046
+ png_size_t num_to_check));
1047
+
1048
+ /* Simple signature checking function. This is the same as calling
1049
+ * png_check_sig(sig, n) := !png_sig_cmp(sig, 0, n).
1050
+ */
1051
+ #define png_check_sig(sig, n) !png_sig_cmp((sig), 0, (n))
1052
+
1053
+ /* Allocate and initialize png_ptr struct for reading, and any other memory. */
1054
+ PNG_EXPORTA(4, png_structp, png_create_read_struct,
1055
+ (png_const_charp user_png_ver, png_voidp error_ptr,
1056
+ png_error_ptr error_fn, png_error_ptr warn_fn),
1057
+ PNG_ALLOCATED);
1058
+
1059
+ /* Allocate and initialize png_ptr struct for writing, and any other memory */
1060
+ PNG_EXPORTA(5, png_structp, png_create_write_struct,
1061
+ (png_const_charp user_png_ver, png_voidp error_ptr, png_error_ptr error_fn,
1062
+ png_error_ptr warn_fn),
1063
+ PNG_ALLOCATED);
1064
+
1065
+ PNG_EXPORT(6, png_size_t, png_get_compression_buffer_size,
1066
+ (png_const_structrp png_ptr));
1067
+
1068
+ PNG_EXPORT(7, void, png_set_compression_buffer_size, (png_structrp png_ptr,
1069
+ png_size_t size));
1070
+
1071
+ /* Moved from pngconf.h in 1.4.0 and modified to ensure setjmp/longjmp
1072
+ * match up.
1073
+ */
1074
+ #ifdef PNG_SETJMP_SUPPORTED
1075
+ /* This function returns the jmp_buf built in to *png_ptr. It must be
1076
+ * supplied with an appropriate 'longjmp' function to use on that jmp_buf
1077
+ * unless the default error function is overridden in which case NULL is
1078
+ * acceptable. The size of the jmp_buf is checked against the actual size
1079
+ * allocated by the library - the call will return NULL on a mismatch
1080
+ * indicating an ABI mismatch.
1081
+ */
1082
+ PNG_EXPORT(8, jmp_buf*, png_set_longjmp_fn, (png_structrp png_ptr,
1083
+ png_longjmp_ptr longjmp_fn, size_t jmp_buf_size));
1084
+ # define png_jmpbuf(png_ptr) \
1085
+ (*png_set_longjmp_fn((png_ptr), longjmp, (sizeof (jmp_buf))))
1086
+ #else
1087
+ # define png_jmpbuf(png_ptr) \
1088
+ (LIBPNG_WAS_COMPILED_WITH__PNG_NO_SETJMP)
1089
+ #endif
1090
+ /* This function should be used by libpng applications in place of
1091
+ * longjmp(png_ptr->jmpbuf, val). If longjmp_fn() has been set, it
1092
+ * will use it; otherwise it will call PNG_ABORT(). This function was
1093
+ * added in libpng-1.5.0.
1094
+ */
1095
+ PNG_EXPORTA(9, void, png_longjmp, (png_const_structrp png_ptr, int val),
1096
+ PNG_NORETURN);
1097
+
1098
+ #ifdef PNG_READ_SUPPORTED
1099
+ /* Reset the compression stream */
1100
+ PNG_EXPORTA(10, int, png_reset_zstream, (png_structrp png_ptr), PNG_DEPRECATED);
1101
+ #endif
1102
+
1103
+ /* New functions added in libpng-1.0.2 (not enabled by default until 1.2.0) */
1104
+ #ifdef PNG_USER_MEM_SUPPORTED
1105
+ PNG_EXPORTA(11, png_structp, png_create_read_struct_2,
1106
+ (png_const_charp user_png_ver, png_voidp error_ptr, png_error_ptr error_fn,
1107
+ png_error_ptr warn_fn,
1108
+ png_voidp mem_ptr, png_malloc_ptr malloc_fn, png_free_ptr free_fn),
1109
+ PNG_ALLOCATED);
1110
+ PNG_EXPORTA(12, png_structp, png_create_write_struct_2,
1111
+ (png_const_charp user_png_ver, png_voidp error_ptr, png_error_ptr error_fn,
1112
+ png_error_ptr warn_fn,
1113
+ png_voidp mem_ptr, png_malloc_ptr malloc_fn, png_free_ptr free_fn),
1114
+ PNG_ALLOCATED);
1115
+ #endif
1116
+
1117
+ /* Write the PNG file signature. */
1118
+ PNG_EXPORT(13, void, png_write_sig, (png_structrp png_ptr));
1119
+
1120
+ /* Write a PNG chunk - size, type, (optional) data, CRC. */
1121
+ PNG_EXPORT(14, void, png_write_chunk, (png_structrp png_ptr, png_const_bytep
1122
+ chunk_name, png_const_bytep data, png_size_t length));
1123
+
1124
+ /* Write the start of a PNG chunk - length and chunk name. */
1125
+ PNG_EXPORT(15, void, png_write_chunk_start, (png_structrp png_ptr,
1126
+ png_const_bytep chunk_name, png_uint_32 length));
1127
+
1128
+ /* Write the data of a PNG chunk started with png_write_chunk_start(). */
1129
+ PNG_EXPORT(16, void, png_write_chunk_data, (png_structrp png_ptr,
1130
+ png_const_bytep data, png_size_t length));
1131
+
1132
+ /* Finish a chunk started with png_write_chunk_start() (includes CRC). */
1133
+ PNG_EXPORT(17, void, png_write_chunk_end, (png_structrp png_ptr));
1134
+
1135
+ /* Allocate and initialize the info structure */
1136
+ PNG_EXPORTA(18, png_infop, png_create_info_struct, (png_const_structrp png_ptr),
1137
+ PNG_ALLOCATED);
1138
+
1139
+ /* DEPRECATED: this function allowed init structures to be created using the
1140
+ * default allocation method (typically malloc). Use is deprecated in 1.6.0 and
1141
+ * the API will be removed in the future.
1142
+ */
1143
+ PNG_EXPORTA(19, void, png_info_init_3, (png_infopp info_ptr,
1144
+ png_size_t png_info_struct_size), PNG_DEPRECATED);
1145
+
1146
+ /* Writes all the PNG information before the image. */
1147
+ PNG_EXPORT(20, void, png_write_info_before_PLTE,
1148
+ (png_structrp png_ptr, png_const_inforp info_ptr));
1149
+ PNG_EXPORT(21, void, png_write_info,
1150
+ (png_structrp png_ptr, png_const_inforp info_ptr));
1151
+
1152
+ #ifdef PNG_SEQUENTIAL_READ_SUPPORTED
1153
+ /* Read the information before the actual image data. */
1154
+ PNG_EXPORT(22, void, png_read_info,
1155
+ (png_structrp png_ptr, png_inforp info_ptr));
1156
+ #endif
1157
+
1158
+ #ifdef PNG_TIME_RFC1123_SUPPORTED
1159
+ /* Convert to a US string format: there is no localization support in this
1160
+ * routine. The original implementation used a 29 character buffer in
1161
+ * png_struct, this will be removed in future versions.
1162
+ */
1163
+ #if PNG_LIBPNG_VER < 10700
1164
+ /* To do: remove this from libpng17 (and from libpng17/png.c and pngstruct.h) */
1165
+ PNG_EXPORTA(23, png_const_charp, png_convert_to_rfc1123, (png_structrp png_ptr,
1166
+ png_const_timep ptime),PNG_DEPRECATED);
1167
+ #endif
1168
+ PNG_EXPORT(241, int, png_convert_to_rfc1123_buffer, (char out[29],
1169
+ png_const_timep ptime));
1170
+ #endif
1171
+
1172
+ #ifdef PNG_CONVERT_tIME_SUPPORTED
1173
+ /* Convert from a struct tm to png_time */
1174
+ PNG_EXPORT(24, void, png_convert_from_struct_tm, (png_timep ptime,
1175
+ const struct tm * ttime));
1176
+
1177
+ /* Convert from time_t to png_time. Uses gmtime() */
1178
+ PNG_EXPORT(25, void, png_convert_from_time_t, (png_timep ptime, time_t ttime));
1179
+ #endif /* PNG_CONVERT_tIME_SUPPORTED */
1180
+
1181
+ #ifdef PNG_READ_EXPAND_SUPPORTED
1182
+ /* Expand data to 24-bit RGB, or 8-bit grayscale, with alpha if available. */
1183
+ PNG_EXPORT(26, void, png_set_expand, (png_structrp png_ptr));
1184
+ PNG_EXPORT(27, void, png_set_expand_gray_1_2_4_to_8, (png_structrp png_ptr));
1185
+ PNG_EXPORT(28, void, png_set_palette_to_rgb, (png_structrp png_ptr));
1186
+ PNG_EXPORT(29, void, png_set_tRNS_to_alpha, (png_structrp png_ptr));
1187
+ #endif
1188
+
1189
+ #ifdef PNG_READ_EXPAND_16_SUPPORTED
1190
+ /* Expand to 16-bit channels, forces conversion of palette to RGB and expansion
1191
+ * of a tRNS chunk if present.
1192
+ */
1193
+ PNG_EXPORT(221, void, png_set_expand_16, (png_structrp png_ptr));
1194
+ #endif
1195
+
1196
+ #if defined(PNG_READ_BGR_SUPPORTED) || defined(PNG_WRITE_BGR_SUPPORTED)
1197
+ /* Use blue, green, red order for pixels. */
1198
+ PNG_EXPORT(30, void, png_set_bgr, (png_structrp png_ptr));
1199
+ #endif
1200
+
1201
+ #ifdef PNG_READ_GRAY_TO_RGB_SUPPORTED
1202
+ /* Expand the grayscale to 24-bit RGB if necessary. */
1203
+ PNG_EXPORT(31, void, png_set_gray_to_rgb, (png_structrp png_ptr));
1204
+ #endif
1205
+
1206
+ #ifdef PNG_READ_RGB_TO_GRAY_SUPPORTED
1207
+ /* Reduce RGB to grayscale. */
1208
+ #define PNG_ERROR_ACTION_NONE 1
1209
+ #define PNG_ERROR_ACTION_WARN 2
1210
+ #define PNG_ERROR_ACTION_ERROR 3
1211
+ #define PNG_RGB_TO_GRAY_DEFAULT (-1)/*for red/green coefficients*/
1212
+
1213
+ PNG_FP_EXPORT(32, void, png_set_rgb_to_gray, (png_structrp png_ptr,
1214
+ int error_action, double red, double green))
1215
+ PNG_FIXED_EXPORT(33, void, png_set_rgb_to_gray_fixed, (png_structrp png_ptr,
1216
+ int error_action, png_fixed_point red, png_fixed_point green))
1217
+
1218
+ PNG_EXPORT(34, png_byte, png_get_rgb_to_gray_status, (png_const_structrp
1219
+ png_ptr));
1220
+ #endif
1221
+
1222
+ #ifdef PNG_BUILD_GRAYSCALE_PALETTE_SUPPORTED
1223
+ PNG_EXPORT(35, void, png_build_grayscale_palette, (int bit_depth,
1224
+ png_colorp palette));
1225
+ #endif
1226
+
1227
+ #ifdef PNG_READ_ALPHA_MODE_SUPPORTED
1228
+ /* How the alpha channel is interpreted - this affects how the color channels
1229
+ * of a PNG file are returned to the calling application when an alpha channel,
1230
+ * or a tRNS chunk in a palette file, is present.
1231
+ *
1232
+ * This has no effect on the way pixels are written into a PNG output
1233
+ * datastream. The color samples in a PNG datastream are never premultiplied
1234
+ * with the alpha samples.
1235
+ *
1236
+ * The default is to return data according to the PNG specification: the alpha
1237
+ * channel is a linear measure of the contribution of the pixel to the
1238
+ * corresponding composited pixel, and the color channels are unassociated
1239
+ * (not premultiplied). The gamma encoded color channels must be scaled
1240
+ * according to the contribution and to do this it is necessary to undo
1241
+ * the encoding, scale the color values, perform the composition and reencode
1242
+ * the values. This is the 'PNG' mode.
1243
+ *
1244
+ * The alternative is to 'associate' the alpha with the color information by
1245
+ * storing color channel values that have been scaled by the alpha.
1246
+ * image. These are the 'STANDARD', 'ASSOCIATED' or 'PREMULTIPLIED' modes
1247
+ * (the latter being the two common names for associated alpha color channels).
1248
+ *
1249
+ * For the 'OPTIMIZED' mode, a pixel is treated as opaque only if the alpha
1250
+ * value is equal to the maximum value.
1251
+ *
1252
+ * The final choice is to gamma encode the alpha channel as well. This is
1253
+ * broken because, in practice, no implementation that uses this choice
1254
+ * correctly undoes the encoding before handling alpha composition. Use this
1255
+ * choice only if other serious errors in the software or hardware you use
1256
+ * mandate it; the typical serious error is for dark halos to appear around
1257
+ * opaque areas of the composited PNG image because of arithmetic overflow.
1258
+ *
1259
+ * The API function png_set_alpha_mode specifies which of these choices to use
1260
+ * with an enumerated 'mode' value and the gamma of the required output:
1261
+ */
1262
+ #define PNG_ALPHA_PNG 0 /* according to the PNG standard */
1263
+ #define PNG_ALPHA_STANDARD 1 /* according to Porter/Duff */
1264
+ #define PNG_ALPHA_ASSOCIATED 1 /* as above; this is the normal practice */
1265
+ #define PNG_ALPHA_PREMULTIPLIED 1 /* as above */
1266
+ #define PNG_ALPHA_OPTIMIZED 2 /* 'PNG' for opaque pixels, else 'STANDARD' */
1267
+ #define PNG_ALPHA_BROKEN 3 /* the alpha channel is gamma encoded */
1268
+
1269
+ PNG_FP_EXPORT(227, void, png_set_alpha_mode, (png_structrp png_ptr, int mode,
1270
+ double output_gamma))
1271
+ PNG_FIXED_EXPORT(228, void, png_set_alpha_mode_fixed, (png_structrp png_ptr,
1272
+ int mode, png_fixed_point output_gamma))
1273
+ #endif
1274
+
1275
+ #if defined(PNG_GAMMA_SUPPORTED) || defined(PNG_READ_ALPHA_MODE_SUPPORTED)
1276
+ /* The output_gamma value is a screen gamma in libpng terminology: it expresses
1277
+ * how to decode the output values, not how they are encoded.
1278
+ */
1279
+ #define PNG_DEFAULT_sRGB -1 /* sRGB gamma and color space */
1280
+ #define PNG_GAMMA_MAC_18 -2 /* Old Mac '1.8' gamma and color space */
1281
+ #define PNG_GAMMA_sRGB 220000 /* Television standards--matches sRGB gamma */
1282
+ #define PNG_GAMMA_LINEAR PNG_FP_1 /* Linear */
1283
+ #endif
1284
+
1285
+ /* The following are examples of calls to png_set_alpha_mode to achieve the
1286
+ * required overall gamma correction and, where necessary, alpha
1287
+ * premultiplication.
1288
+ *
1289
+ * png_set_alpha_mode(pp, PNG_ALPHA_PNG, PNG_DEFAULT_sRGB);
1290
+ * This is the default libpng handling of the alpha channel - it is not
1291
+ * pre-multiplied into the color components. In addition the call states
1292
+ * that the output is for a sRGB system and causes all PNG files without gAMA
1293
+ * chunks to be assumed to be encoded using sRGB.
1294
+ *
1295
+ * png_set_alpha_mode(pp, PNG_ALPHA_PNG, PNG_GAMMA_MAC);
1296
+ * In this case the output is assumed to be something like an sRGB conformant
1297
+ * display preceeded by a power-law lookup table of power 1.45. This is how
1298
+ * early Mac systems behaved.
1299
+ *
1300
+ * png_set_alpha_mode(pp, PNG_ALPHA_STANDARD, PNG_GAMMA_LINEAR);
1301
+ * This is the classic Jim Blinn approach and will work in academic
1302
+ * environments where everything is done by the book. It has the shortcoming
1303
+ * of assuming that input PNG data with no gamma information is linear - this
1304
+ * is unlikely to be correct unless the PNG files where generated locally.
1305
+ * Most of the time the output precision will be so low as to show
1306
+ * significant banding in dark areas of the image.
1307
+ *
1308
+ * png_set_expand_16(pp);
1309
+ * png_set_alpha_mode(pp, PNG_ALPHA_STANDARD, PNG_DEFAULT_sRGB);
1310
+ * This is a somewhat more realistic Jim Blinn inspired approach. PNG files
1311
+ * are assumed to have the sRGB encoding if not marked with a gamma value and
1312
+ * the output is always 16 bits per component. This permits accurate scaling
1313
+ * and processing of the data. If you know that your input PNG files were
1314
+ * generated locally you might need to replace PNG_DEFAULT_sRGB with the
1315
+ * correct value for your system.
1316
+ *
1317
+ * png_set_alpha_mode(pp, PNG_ALPHA_OPTIMIZED, PNG_DEFAULT_sRGB);
1318
+ * If you just need to composite the PNG image onto an existing background
1319
+ * and if you control the code that does this you can use the optimization
1320
+ * setting. In this case you just copy completely opaque pixels to the
1321
+ * output. For pixels that are not completely transparent (you just skip
1322
+ * those) you do the composition math using png_composite or png_composite_16
1323
+ * below then encode the resultant 8-bit or 16-bit values to match the output
1324
+ * encoding.
1325
+ *
1326
+ * Other cases
1327
+ * If neither the PNG nor the standard linear encoding work for you because
1328
+ * of the software or hardware you use then you have a big problem. The PNG
1329
+ * case will probably result in halos around the image. The linear encoding
1330
+ * will probably result in a washed out, too bright, image (it's actually too
1331
+ * contrasty.) Try the ALPHA_OPTIMIZED mode above - this will probably
1332
+ * substantially reduce the halos. Alternatively try:
1333
+ *
1334
+ * png_set_alpha_mode(pp, PNG_ALPHA_BROKEN, PNG_DEFAULT_sRGB);
1335
+ * This option will also reduce the halos, but there will be slight dark
1336
+ * halos round the opaque parts of the image where the background is light.
1337
+ * In the OPTIMIZED mode the halos will be light halos where the background
1338
+ * is dark. Take your pick - the halos are unavoidable unless you can get
1339
+ * your hardware/software fixed! (The OPTIMIZED approach is slightly
1340
+ * faster.)
1341
+ *
1342
+ * When the default gamma of PNG files doesn't match the output gamma.
1343
+ * If you have PNG files with no gamma information png_set_alpha_mode allows
1344
+ * you to provide a default gamma, but it also sets the ouput gamma to the
1345
+ * matching value. If you know your PNG files have a gamma that doesn't
1346
+ * match the output you can take advantage of the fact that
1347
+ * png_set_alpha_mode always sets the output gamma but only sets the PNG
1348
+ * default if it is not already set:
1349
+ *
1350
+ * png_set_alpha_mode(pp, PNG_ALPHA_PNG, PNG_DEFAULT_sRGB);
1351
+ * png_set_alpha_mode(pp, PNG_ALPHA_PNG, PNG_GAMMA_MAC);
1352
+ * The first call sets both the default and the output gamma values, the
1353
+ * second call overrides the output gamma without changing the default. This
1354
+ * is easier than achieving the same effect with png_set_gamma. You must use
1355
+ * PNG_ALPHA_PNG for the first call - internal checking in png_set_alpha will
1356
+ * fire if more than one call to png_set_alpha_mode and png_set_background is
1357
+ * made in the same read operation, however multiple calls with PNG_ALPHA_PNG
1358
+ * are ignored.
1359
+ */
1360
+
1361
+ #ifdef PNG_READ_STRIP_ALPHA_SUPPORTED
1362
+ PNG_EXPORT(36, void, png_set_strip_alpha, (png_structrp png_ptr));
1363
+ #endif
1364
+
1365
+ #if defined(PNG_READ_SWAP_ALPHA_SUPPORTED) || \
1366
+ defined(PNG_WRITE_SWAP_ALPHA_SUPPORTED)
1367
+ PNG_EXPORT(37, void, png_set_swap_alpha, (png_structrp png_ptr));
1368
+ #endif
1369
+
1370
+ #if defined(PNG_READ_INVERT_ALPHA_SUPPORTED) || \
1371
+ defined(PNG_WRITE_INVERT_ALPHA_SUPPORTED)
1372
+ PNG_EXPORT(38, void, png_set_invert_alpha, (png_structrp png_ptr));
1373
+ #endif
1374
+
1375
+ #if defined(PNG_READ_FILLER_SUPPORTED) || defined(PNG_WRITE_FILLER_SUPPORTED)
1376
+ /* Add a filler byte to 8-bit Gray or 24-bit RGB images. */
1377
+ PNG_EXPORT(39, void, png_set_filler, (png_structrp png_ptr, png_uint_32 filler,
1378
+ int flags));
1379
+ /* The values of the PNG_FILLER_ defines should NOT be changed */
1380
+ # define PNG_FILLER_BEFORE 0
1381
+ # define PNG_FILLER_AFTER 1
1382
+ /* Add an alpha byte to 8-bit Gray or 24-bit RGB images. */
1383
+ PNG_EXPORT(40, void, png_set_add_alpha, (png_structrp png_ptr,
1384
+ png_uint_32 filler, int flags));
1385
+ #endif /* PNG_READ_FILLER_SUPPORTED || PNG_WRITE_FILLER_SUPPORTED */
1386
+
1387
+ #if defined(PNG_READ_SWAP_SUPPORTED) || defined(PNG_WRITE_SWAP_SUPPORTED)
1388
+ /* Swap bytes in 16-bit depth files. */
1389
+ PNG_EXPORT(41, void, png_set_swap, (png_structrp png_ptr));
1390
+ #endif
1391
+
1392
+ #if defined(PNG_READ_PACK_SUPPORTED) || defined(PNG_WRITE_PACK_SUPPORTED)
1393
+ /* Use 1 byte per pixel in 1, 2, or 4-bit depth files. */
1394
+ PNG_EXPORT(42, void, png_set_packing, (png_structrp png_ptr));
1395
+ #endif
1396
+
1397
+ #if defined(PNG_READ_PACKSWAP_SUPPORTED) || \
1398
+ defined(PNG_WRITE_PACKSWAP_SUPPORTED)
1399
+ /* Swap packing order of pixels in bytes. */
1400
+ PNG_EXPORT(43, void, png_set_packswap, (png_structrp png_ptr));
1401
+ #endif
1402
+
1403
+ #if defined(PNG_READ_SHIFT_SUPPORTED) || defined(PNG_WRITE_SHIFT_SUPPORTED)
1404
+ /* Converts files to legal bit depths. */
1405
+ PNG_EXPORT(44, void, png_set_shift, (png_structrp png_ptr, png_const_color_8p
1406
+ true_bits));
1407
+ #endif
1408
+
1409
+ #if defined(PNG_READ_INTERLACING_SUPPORTED) || \
1410
+ defined(PNG_WRITE_INTERLACING_SUPPORTED)
1411
+ /* Have the code handle the interlacing. Returns the number of passes.
1412
+ * MUST be called before png_read_update_info or png_start_read_image,
1413
+ * otherwise it will not have the desired effect. Note that it is still
1414
+ * necessary to call png_read_row or png_read_rows png_get_image_height
1415
+ * times for each pass.
1416
+ */
1417
+ PNG_EXPORT(45, int, png_set_interlace_handling, (png_structrp png_ptr));
1418
+ #endif
1419
+
1420
+ #if defined(PNG_READ_INVERT_SUPPORTED) || defined(PNG_WRITE_INVERT_SUPPORTED)
1421
+ /* Invert monochrome files */
1422
+ PNG_EXPORT(46, void, png_set_invert_mono, (png_structrp png_ptr));
1423
+ #endif
1424
+
1425
+ #ifdef PNG_READ_BACKGROUND_SUPPORTED
1426
+ /* Handle alpha and tRNS by replacing with a background color. Prior to
1427
+ * libpng-1.5.4 this API must not be called before the PNG file header has been
1428
+ * read. Doing so will result in unexpected behavior and possible warnings or
1429
+ * errors if the PNG file contains a bKGD chunk.
1430
+ */
1431
+ PNG_FP_EXPORT(47, void, png_set_background, (png_structrp png_ptr,
1432
+ png_const_color_16p background_color, int background_gamma_code,
1433
+ int need_expand, double background_gamma))
1434
+ PNG_FIXED_EXPORT(215, void, png_set_background_fixed, (png_structrp png_ptr,
1435
+ png_const_color_16p background_color, int background_gamma_code,
1436
+ int need_expand, png_fixed_point background_gamma))
1437
+ #endif
1438
+ #ifdef PNG_READ_BACKGROUND_SUPPORTED
1439
+ # define PNG_BACKGROUND_GAMMA_UNKNOWN 0
1440
+ # define PNG_BACKGROUND_GAMMA_SCREEN 1
1441
+ # define PNG_BACKGROUND_GAMMA_FILE 2
1442
+ # define PNG_BACKGROUND_GAMMA_UNIQUE 3
1443
+ #endif
1444
+
1445
+ #ifdef PNG_READ_SCALE_16_TO_8_SUPPORTED
1446
+ /* Scale a 16-bit depth file down to 8-bit, accurately. */
1447
+ PNG_EXPORT(229, void, png_set_scale_16, (png_structrp png_ptr));
1448
+ #endif
1449
+
1450
+ #ifdef PNG_READ_STRIP_16_TO_8_SUPPORTED
1451
+ #define PNG_READ_16_TO_8 SUPPORTED /* Name prior to 1.5.4 */
1452
+ /* Strip the second byte of information from a 16-bit depth file. */
1453
+ PNG_EXPORT(48, void, png_set_strip_16, (png_structrp png_ptr));
1454
+ #endif
1455
+
1456
+ #ifdef PNG_READ_QUANTIZE_SUPPORTED
1457
+ /* Turn on quantizing, and reduce the palette to the number of colors
1458
+ * available.
1459
+ */
1460
+ PNG_EXPORT(49, void, png_set_quantize, (png_structrp png_ptr,
1461
+ png_colorp palette, int num_palette, int maximum_colors,
1462
+ png_const_uint_16p histogram, int full_quantize));
1463
+ #endif
1464
+
1465
+ #ifdef PNG_READ_GAMMA_SUPPORTED
1466
+ /* The threshold on gamma processing is configurable but hard-wired into the
1467
+ * library. The following is the floating point variant.
1468
+ */
1469
+ #define PNG_GAMMA_THRESHOLD (PNG_GAMMA_THRESHOLD_FIXED*.00001)
1470
+
1471
+ /* Handle gamma correction. Screen_gamma=(display_exponent).
1472
+ * NOTE: this API simply sets the screen and file gamma values. It will
1473
+ * therefore override the value for gamma in a PNG file if it is called after
1474
+ * the file header has been read - use with care - call before reading the PNG
1475
+ * file for best results!
1476
+ *
1477
+ * These routines accept the same gamma values as png_set_alpha_mode (described
1478
+ * above). The PNG_GAMMA_ defines and PNG_DEFAULT_sRGB can be passed to either
1479
+ * API (floating point or fixed.) Notice, however, that the 'file_gamma' value
1480
+ * is the inverse of a 'screen gamma' value.
1481
+ */
1482
+ PNG_FP_EXPORT(50, void, png_set_gamma, (png_structrp png_ptr,
1483
+ double screen_gamma, double override_file_gamma))
1484
+ PNG_FIXED_EXPORT(208, void, png_set_gamma_fixed, (png_structrp png_ptr,
1485
+ png_fixed_point screen_gamma, png_fixed_point override_file_gamma))
1486
+ #endif
1487
+
1488
+ #ifdef PNG_WRITE_FLUSH_SUPPORTED
1489
+ /* Set how many lines between output flushes - 0 for no flushing */
1490
+ PNG_EXPORT(51, void, png_set_flush, (png_structrp png_ptr, int nrows));
1491
+ /* Flush the current PNG output buffer */
1492
+ PNG_EXPORT(52, void, png_write_flush, (png_structrp png_ptr));
1493
+ #endif
1494
+
1495
+ /* Optional update palette with requested transformations */
1496
+ PNG_EXPORT(53, void, png_start_read_image, (png_structrp png_ptr));
1497
+
1498
+ /* Optional call to update the users info structure */
1499
+ PNG_EXPORT(54, void, png_read_update_info, (png_structrp png_ptr,
1500
+ png_inforp info_ptr));
1501
+
1502
+ #ifdef PNG_SEQUENTIAL_READ_SUPPORTED
1503
+ /* Read one or more rows of image data. */
1504
+ PNG_EXPORT(55, void, png_read_rows, (png_structrp png_ptr, png_bytepp row,
1505
+ png_bytepp display_row, png_uint_32 num_rows));
1506
+ #endif
1507
+
1508
+ #ifdef PNG_SEQUENTIAL_READ_SUPPORTED
1509
+ /* Read a row of data. */
1510
+ PNG_EXPORT(56, void, png_read_row, (png_structrp png_ptr, png_bytep row,
1511
+ png_bytep display_row));
1512
+ #endif
1513
+
1514
+ #ifdef PNG_SEQUENTIAL_READ_SUPPORTED
1515
+ /* Read the whole image into memory at once. */
1516
+ PNG_EXPORT(57, void, png_read_image, (png_structrp png_ptr, png_bytepp image));
1517
+ #endif
1518
+
1519
+ /* Write a row of image data */
1520
+ PNG_EXPORT(58, void, png_write_row, (png_structrp png_ptr,
1521
+ png_const_bytep row));
1522
+
1523
+ /* Write a few rows of image data: (*row) is not written; however, the type
1524
+ * is declared as writeable to maintain compatibility with previous versions
1525
+ * of libpng and to allow the 'display_row' array from read_rows to be passed
1526
+ * unchanged to write_rows.
1527
+ */
1528
+ PNG_EXPORT(59, void, png_write_rows, (png_structrp png_ptr, png_bytepp row,
1529
+ png_uint_32 num_rows));
1530
+
1531
+ /* Write the image data */
1532
+ PNG_EXPORT(60, void, png_write_image, (png_structrp png_ptr, png_bytepp image));
1533
+
1534
+ /* Write the end of the PNG file. */
1535
+ PNG_EXPORT(61, void, png_write_end, (png_structrp png_ptr,
1536
+ png_inforp info_ptr));
1537
+
1538
+ #ifdef PNG_SEQUENTIAL_READ_SUPPORTED
1539
+ /* Read the end of the PNG file. */
1540
+ PNG_EXPORT(62, void, png_read_end, (png_structrp png_ptr, png_inforp info_ptr));
1541
+ #endif
1542
+
1543
+ /* Free any memory associated with the png_info_struct */
1544
+ PNG_EXPORT(63, void, png_destroy_info_struct, (png_const_structrp png_ptr,
1545
+ png_infopp info_ptr_ptr));
1546
+
1547
+ /* Free any memory associated with the png_struct and the png_info_structs */
1548
+ PNG_EXPORT(64, void, png_destroy_read_struct, (png_structpp png_ptr_ptr,
1549
+ png_infopp info_ptr_ptr, png_infopp end_info_ptr_ptr));
1550
+
1551
+ /* Free any memory associated with the png_struct and the png_info_structs */
1552
+ PNG_EXPORT(65, void, png_destroy_write_struct, (png_structpp png_ptr_ptr,
1553
+ png_infopp info_ptr_ptr));
1554
+
1555
+ /* Set the libpng method of handling chunk CRC errors */
1556
+ PNG_EXPORT(66, void, png_set_crc_action, (png_structrp png_ptr, int crit_action,
1557
+ int ancil_action));
1558
+
1559
+ /* Values for png_set_crc_action() say how to handle CRC errors in
1560
+ * ancillary and critical chunks, and whether to use the data contained
1561
+ * therein. Note that it is impossible to "discard" data in a critical
1562
+ * chunk. For versions prior to 0.90, the action was always error/quit,
1563
+ * whereas in version 0.90 and later, the action for CRC errors in ancillary
1564
+ * chunks is warn/discard. These values should NOT be changed.
1565
+ *
1566
+ * value action:critical action:ancillary
1567
+ */
1568
+ #define PNG_CRC_DEFAULT 0 /* error/quit warn/discard data */
1569
+ #define PNG_CRC_ERROR_QUIT 1 /* error/quit error/quit */
1570
+ #define PNG_CRC_WARN_DISCARD 2 /* (INVALID) warn/discard data */
1571
+ #define PNG_CRC_WARN_USE 3 /* warn/use data warn/use data */
1572
+ #define PNG_CRC_QUIET_USE 4 /* quiet/use data quiet/use data */
1573
+ #define PNG_CRC_NO_CHANGE 5 /* use current value use current value */
1574
+
1575
+ /* These functions give the user control over the scan-line filtering in
1576
+ * libpng and the compression methods used by zlib. These functions are
1577
+ * mainly useful for testing, as the defaults should work with most users.
1578
+ * Those users who are tight on memory or want faster performance at the
1579
+ * expense of compression can modify them. See the compression library
1580
+ * header file (zlib.h) for an explination of the compression functions.
1581
+ */
1582
+
1583
+ /* Set the filtering method(s) used by libpng. Currently, the only valid
1584
+ * value for "method" is 0.
1585
+ */
1586
+ PNG_EXPORT(67, void, png_set_filter, (png_structrp png_ptr, int method,
1587
+ int filters));
1588
+
1589
+ /* Flags for png_set_filter() to say which filters to use. The flags
1590
+ * are chosen so that they don't conflict with real filter types
1591
+ * below, in case they are supplied instead of the #defined constants.
1592
+ * These values should NOT be changed.
1593
+ */
1594
+ #define PNG_NO_FILTERS 0x00
1595
+ #define PNG_FILTER_NONE 0x08
1596
+ #define PNG_FILTER_SUB 0x10
1597
+ #define PNG_FILTER_UP 0x20
1598
+ #define PNG_FILTER_AVG 0x40
1599
+ #define PNG_FILTER_PAETH 0x80
1600
+ #define PNG_ALL_FILTERS (PNG_FILTER_NONE | PNG_FILTER_SUB | PNG_FILTER_UP | \
1601
+ PNG_FILTER_AVG | PNG_FILTER_PAETH)
1602
+
1603
+ /* Filter values (not flags) - used in pngwrite.c, pngwutil.c for now.
1604
+ * These defines should NOT be changed.
1605
+ */
1606
+ #define PNG_FILTER_VALUE_NONE 0
1607
+ #define PNG_FILTER_VALUE_SUB 1
1608
+ #define PNG_FILTER_VALUE_UP 2
1609
+ #define PNG_FILTER_VALUE_AVG 3
1610
+ #define PNG_FILTER_VALUE_PAETH 4
1611
+ #define PNG_FILTER_VALUE_LAST 5
1612
+
1613
+ #ifdef PNG_WRITE_WEIGHTED_FILTER_SUPPORTED /* EXPERIMENTAL */
1614
+ /* The "heuristic_method" is given by one of the PNG_FILTER_HEURISTIC_
1615
+ * defines, either the default (minimum-sum-of-absolute-differences), or
1616
+ * the experimental method (weighted-minimum-sum-of-absolute-differences).
1617
+ *
1618
+ * Weights are factors >= 1.0, indicating how important it is to keep the
1619
+ * filter type consistent between rows. Larger numbers mean the current
1620
+ * filter is that many times as likely to be the same as the "num_weights"
1621
+ * previous filters. This is cumulative for each previous row with a weight.
1622
+ * There needs to be "num_weights" values in "filter_weights", or it can be
1623
+ * NULL if the weights aren't being specified. Weights have no influence on
1624
+ * the selection of the first row filter. Well chosen weights can (in theory)
1625
+ * improve the compression for a given image.
1626
+ *
1627
+ * Costs are factors >= 1.0 indicating the relative decoding costs of a
1628
+ * filter type. Higher costs indicate more decoding expense, and are
1629
+ * therefore less likely to be selected over a filter with lower computational
1630
+ * costs. There needs to be a value in "filter_costs" for each valid filter
1631
+ * type (given by PNG_FILTER_VALUE_LAST), or it can be NULL if you aren't
1632
+ * setting the costs. Costs try to improve the speed of decompression without
1633
+ * unduly increasing the compressed image size.
1634
+ *
1635
+ * A negative weight or cost indicates the default value is to be used, and
1636
+ * values in the range [0.0, 1.0) indicate the value is to remain unchanged.
1637
+ * The default values for both weights and costs are currently 1.0, but may
1638
+ * change if good general weighting/cost heuristics can be found. If both
1639
+ * the weights and costs are set to 1.0, this degenerates the WEIGHTED method
1640
+ * to the UNWEIGHTED method, but with added encoding time/computation.
1641
+ */
1642
+ PNG_FP_EXPORT(68, void, png_set_filter_heuristics, (png_structrp png_ptr,
1643
+ int heuristic_method, int num_weights, png_const_doublep filter_weights,
1644
+ png_const_doublep filter_costs))
1645
+ PNG_FIXED_EXPORT(209, void, png_set_filter_heuristics_fixed,
1646
+ (png_structrp png_ptr, int heuristic_method, int num_weights,
1647
+ png_const_fixed_point_p filter_weights,
1648
+ png_const_fixed_point_p filter_costs))
1649
+ #endif /* PNG_WRITE_WEIGHTED_FILTER_SUPPORTED */
1650
+
1651
+ /* Heuristic used for row filter selection. These defines should NOT be
1652
+ * changed.
1653
+ */
1654
+ #define PNG_FILTER_HEURISTIC_DEFAULT 0 /* Currently "UNWEIGHTED" */
1655
+ #define PNG_FILTER_HEURISTIC_UNWEIGHTED 1 /* Used by libpng < 0.95 */
1656
+ #define PNG_FILTER_HEURISTIC_WEIGHTED 2 /* Experimental feature */
1657
+ #define PNG_FILTER_HEURISTIC_LAST 3 /* Not a valid value */
1658
+
1659
+ #ifdef PNG_WRITE_SUPPORTED
1660
+ /* Set the library compression level. Currently, valid values range from
1661
+ * 0 - 9, corresponding directly to the zlib compression levels 0 - 9
1662
+ * (0 - no compression, 9 - "maximal" compression). Note that tests have
1663
+ * shown that zlib compression levels 3-6 usually perform as well as level 9
1664
+ * for PNG images, and do considerably fewer caclulations. In the future,
1665
+ * these values may not correspond directly to the zlib compression levels.
1666
+ */
1667
+ PNG_EXPORT(69, void, png_set_compression_level, (png_structrp png_ptr,
1668
+ int level));
1669
+
1670
+ PNG_EXPORT(70, void, png_set_compression_mem_level, (png_structrp png_ptr,
1671
+ int mem_level));
1672
+
1673
+ PNG_EXPORT(71, void, png_set_compression_strategy, (png_structrp png_ptr,
1674
+ int strategy));
1675
+
1676
+ /* If PNG_WRITE_OPTIMIZE_CMF_SUPPORTED is defined, libpng will use a
1677
+ * smaller value of window_bits if it can do so safely.
1678
+ */
1679
+ PNG_EXPORT(72, void, png_set_compression_window_bits, (png_structrp png_ptr,
1680
+ int window_bits));
1681
+
1682
+ PNG_EXPORT(73, void, png_set_compression_method, (png_structrp png_ptr,
1683
+ int method));
1684
+ #endif
1685
+
1686
+ #ifdef PNG_WRITE_CUSTOMIZE_ZTXT_COMPRESSION_SUPPORTED
1687
+ /* Also set zlib parameters for compressing non-IDAT chunks */
1688
+ PNG_EXPORT(222, void, png_set_text_compression_level, (png_structrp png_ptr,
1689
+ int level));
1690
+
1691
+ PNG_EXPORT(223, void, png_set_text_compression_mem_level, (png_structrp png_ptr,
1692
+ int mem_level));
1693
+
1694
+ PNG_EXPORT(224, void, png_set_text_compression_strategy, (png_structrp png_ptr,
1695
+ int strategy));
1696
+
1697
+ /* If PNG_WRITE_OPTIMIZE_CMF_SUPPORTED is defined, libpng will use a
1698
+ * smaller value of window_bits if it can do so safely.
1699
+ */
1700
+ PNG_EXPORT(225, void, png_set_text_compression_window_bits,
1701
+ (png_structrp png_ptr, int window_bits));
1702
+
1703
+ PNG_EXPORT(226, void, png_set_text_compression_method, (png_structrp png_ptr,
1704
+ int method));
1705
+ #endif /* PNG_WRITE_CUSTOMIZE_ZTXT_COMPRESSION_SUPPORTED */
1706
+
1707
+ /* These next functions are called for input/output, memory, and error
1708
+ * handling. They are in the file pngrio.c, pngwio.c, and pngerror.c,
1709
+ * and call standard C I/O routines such as fread(), fwrite(), and
1710
+ * fprintf(). These functions can be made to use other I/O routines
1711
+ * at run time for those applications that need to handle I/O in a
1712
+ * different manner by calling png_set_???_fn(). See libpng-manual.txt for
1713
+ * more information.
1714
+ */
1715
+
1716
+ #ifdef PNG_STDIO_SUPPORTED
1717
+ /* Initialize the input/output for the PNG file to the default functions. */
1718
+ PNG_EXPORT(74, void, png_init_io, (png_structrp png_ptr, png_FILE_p fp));
1719
+ #endif
1720
+
1721
+ /* Replace the (error and abort), and warning functions with user
1722
+ * supplied functions. If no messages are to be printed you must still
1723
+ * write and use replacement functions. The replacement error_fn should
1724
+ * still do a longjmp to the last setjmp location if you are using this
1725
+ * method of error handling. If error_fn or warning_fn is NULL, the
1726
+ * default function will be used.
1727
+ */
1728
+
1729
+ PNG_EXPORT(75, void, png_set_error_fn, (png_structrp png_ptr,
1730
+ png_voidp error_ptr, png_error_ptr error_fn, png_error_ptr warning_fn));
1731
+
1732
+ /* Return the user pointer associated with the error functions */
1733
+ PNG_EXPORT(76, png_voidp, png_get_error_ptr, (png_const_structrp png_ptr));
1734
+
1735
+ /* Replace the default data output functions with a user supplied one(s).
1736
+ * If buffered output is not used, then output_flush_fn can be set to NULL.
1737
+ * If PNG_WRITE_FLUSH_SUPPORTED is not defined at libpng compile time
1738
+ * output_flush_fn will be ignored (and thus can be NULL).
1739
+ * It is probably a mistake to use NULL for output_flush_fn if
1740
+ * write_data_fn is not also NULL unless you have built libpng with
1741
+ * PNG_WRITE_FLUSH_SUPPORTED undefined, because in this case libpng's
1742
+ * default flush function, which uses the standard *FILE structure, will
1743
+ * be used.
1744
+ */
1745
+ PNG_EXPORT(77, void, png_set_write_fn, (png_structrp png_ptr, png_voidp io_ptr,
1746
+ png_rw_ptr write_data_fn, png_flush_ptr output_flush_fn));
1747
+
1748
+ /* Replace the default data input function with a user supplied one. */
1749
+ PNG_EXPORT(78, void, png_set_read_fn, (png_structrp png_ptr, png_voidp io_ptr,
1750
+ png_rw_ptr read_data_fn));
1751
+
1752
+ /* Return the user pointer associated with the I/O functions */
1753
+ PNG_EXPORT(79, png_voidp, png_get_io_ptr, (png_const_structrp png_ptr));
1754
+
1755
+ PNG_EXPORT(80, void, png_set_read_status_fn, (png_structrp png_ptr,
1756
+ png_read_status_ptr read_row_fn));
1757
+
1758
+ PNG_EXPORT(81, void, png_set_write_status_fn, (png_structrp png_ptr,
1759
+ png_write_status_ptr write_row_fn));
1760
+
1761
+ #ifdef PNG_USER_MEM_SUPPORTED
1762
+ /* Replace the default memory allocation functions with user supplied one(s). */
1763
+ PNG_EXPORT(82, void, png_set_mem_fn, (png_structrp png_ptr, png_voidp mem_ptr,
1764
+ png_malloc_ptr malloc_fn, png_free_ptr free_fn));
1765
+ /* Return the user pointer associated with the memory functions */
1766
+ PNG_EXPORT(83, png_voidp, png_get_mem_ptr, (png_const_structrp png_ptr));
1767
+ #endif
1768
+
1769
+ #ifdef PNG_READ_USER_TRANSFORM_SUPPORTED
1770
+ PNG_EXPORT(84, void, png_set_read_user_transform_fn, (png_structrp png_ptr,
1771
+ png_user_transform_ptr read_user_transform_fn));
1772
+ #endif
1773
+
1774
+ #ifdef PNG_WRITE_USER_TRANSFORM_SUPPORTED
1775
+ PNG_EXPORT(85, void, png_set_write_user_transform_fn, (png_structrp png_ptr,
1776
+ png_user_transform_ptr write_user_transform_fn));
1777
+ #endif
1778
+
1779
+ #ifdef PNG_USER_TRANSFORM_PTR_SUPPORTED
1780
+ PNG_EXPORT(86, void, png_set_user_transform_info, (png_structrp png_ptr,
1781
+ png_voidp user_transform_ptr, int user_transform_depth,
1782
+ int user_transform_channels));
1783
+ /* Return the user pointer associated with the user transform functions */
1784
+ PNG_EXPORT(87, png_voidp, png_get_user_transform_ptr,
1785
+ (png_const_structrp png_ptr));
1786
+ #endif
1787
+
1788
+ #ifdef PNG_USER_TRANSFORM_INFO_SUPPORTED
1789
+ /* Return information about the row currently being processed. Note that these
1790
+ * APIs do not fail but will return unexpected results if called outside a user
1791
+ * transform callback. Also note that when transforming an interlaced image the
1792
+ * row number is the row number within the sub-image of the interlace pass, so
1793
+ * the value will increase to the height of the sub-image (not the full image)
1794
+ * then reset to 0 for the next pass.
1795
+ *
1796
+ * Use PNG_ROW_FROM_PASS_ROW(row, pass) and PNG_COL_FROM_PASS_COL(col, pass) to
1797
+ * find the output pixel (x,y) given an interlaced sub-image pixel
1798
+ * (row,col,pass). (See below for these macros.)
1799
+ */
1800
+ PNG_EXPORT(217, png_uint_32, png_get_current_row_number, (png_const_structrp));
1801
+ PNG_EXPORT(218, png_byte, png_get_current_pass_number, (png_const_structrp));
1802
+ #endif
1803
+
1804
+ #ifdef PNG_READ_USER_CHUNKS_SUPPORTED
1805
+ /* This callback is called only for *unknown* chunks. If
1806
+ * PNG_HANDLE_AS_UNKNOWN_SUPPORTED is set then it is possible to set known
1807
+ * chunks to be treated as unknown, however in this case the callback must do
1808
+ * any processing required by the chunk (e.g. by calling the appropriate
1809
+ * png_set_ APIs.)
1810
+ *
1811
+ * There is no write support - on write, by default, all the chunks in the
1812
+ * 'unknown' list are written in the specified position.
1813
+ *
1814
+ * The integer return from the callback function is interpreted thus:
1815
+ *
1816
+ * negative: An error occured, png_chunk_error will be called.
1817
+ * zero: The chunk was not handled, the chunk will be saved. A critical
1818
+ * chunk will cause an error at this point unless it is to be saved.
1819
+ * positive: The chunk was handled, libpng will ignore/discard it.
1820
+ *
1821
+ * See "INTERACTION WTIH USER CHUNK CALLBACKS" below for important notes about
1822
+ * how this behavior will change in libpng 1.7
1823
+ */
1824
+ PNG_EXPORT(88, void, png_set_read_user_chunk_fn, (png_structrp png_ptr,
1825
+ png_voidp user_chunk_ptr, png_user_chunk_ptr read_user_chunk_fn));
1826
+ #endif
1827
+
1828
+ #ifdef PNG_USER_CHUNKS_SUPPORTED
1829
+ PNG_EXPORT(89, png_voidp, png_get_user_chunk_ptr, (png_const_structrp png_ptr));
1830
+ #endif
1831
+
1832
+ #ifdef PNG_PROGRESSIVE_READ_SUPPORTED
1833
+ /* Sets the function callbacks for the push reader, and a pointer to a
1834
+ * user-defined structure available to the callback functions.
1835
+ */
1836
+ PNG_EXPORT(90, void, png_set_progressive_read_fn, (png_structrp png_ptr,
1837
+ png_voidp progressive_ptr, png_progressive_info_ptr info_fn,
1838
+ png_progressive_row_ptr row_fn, png_progressive_end_ptr end_fn));
1839
+
1840
+ /* Returns the user pointer associated with the push read functions */
1841
+ PNG_EXPORT(91, png_voidp, png_get_progressive_ptr,
1842
+ (png_const_structrp png_ptr));
1843
+
1844
+ /* Function to be called when data becomes available */
1845
+ PNG_EXPORT(92, void, png_process_data, (png_structrp png_ptr,
1846
+ png_inforp info_ptr, png_bytep buffer, png_size_t buffer_size));
1847
+
1848
+ /* A function which may be called *only* within png_process_data to stop the
1849
+ * processing of any more data. The function returns the number of bytes
1850
+ * remaining, excluding any that libpng has cached internally. A subsequent
1851
+ * call to png_process_data must supply these bytes again. If the argument
1852
+ * 'save' is set to true the routine will first save all the pending data and
1853
+ * will always return 0.
1854
+ */
1855
+ PNG_EXPORT(219, png_size_t, png_process_data_pause, (png_structrp, int save));
1856
+
1857
+ /* A function which may be called *only* outside (after) a call to
1858
+ * png_process_data. It returns the number of bytes of data to skip in the
1859
+ * input. Normally it will return 0, but if it returns a non-zero value the
1860
+ * application must skip than number of bytes of input data and pass the
1861
+ * following data to the next call to png_process_data.
1862
+ */
1863
+ PNG_EXPORT(220, png_uint_32, png_process_data_skip, (png_structrp));
1864
+
1865
+ /* Function that combines rows. 'new_row' is a flag that should come from
1866
+ * the callback and be non-NULL if anything needs to be done; the library
1867
+ * stores its own version of the new data internally and ignores the passed
1868
+ * in value.
1869
+ */
1870
+ PNG_EXPORT(93, void, png_progressive_combine_row, (png_const_structrp png_ptr,
1871
+ png_bytep old_row, png_const_bytep new_row));
1872
+ #endif /* PNG_PROGRESSIVE_READ_SUPPORTED */
1873
+
1874
+ PNG_EXPORTA(94, png_voidp, png_malloc, (png_const_structrp png_ptr,
1875
+ png_alloc_size_t size), PNG_ALLOCATED);
1876
+ /* Added at libpng version 1.4.0 */
1877
+ PNG_EXPORTA(95, png_voidp, png_calloc, (png_const_structrp png_ptr,
1878
+ png_alloc_size_t size), PNG_ALLOCATED);
1879
+
1880
+ /* Added at libpng version 1.2.4 */
1881
+ PNG_EXPORTA(96, png_voidp, png_malloc_warn, (png_const_structrp png_ptr,
1882
+ png_alloc_size_t size), PNG_ALLOCATED);
1883
+
1884
+ /* Frees a pointer allocated by png_malloc() */
1885
+ PNG_EXPORT(97, void, png_free, (png_const_structrp png_ptr, png_voidp ptr));
1886
+
1887
+ /* Free data that was allocated internally */
1888
+ PNG_EXPORT(98, void, png_free_data, (png_const_structrp png_ptr,
1889
+ png_inforp info_ptr, png_uint_32 free_me, int num));
1890
+
1891
+ /* Reassign responsibility for freeing existing data, whether allocated
1892
+ * by libpng or by the application; this works on the png_info structure passed
1893
+ * in, it does not change the state for other png_info structures.
1894
+ *
1895
+ * It is unlikely that this function works correctly as of 1.6.0 and using it
1896
+ * may result either in memory leaks or double free of allocated data.
1897
+ */
1898
+ PNG_EXPORT(99, void, png_data_freer, (png_const_structrp png_ptr,
1899
+ png_inforp info_ptr, int freer, png_uint_32 mask));
1900
+
1901
+ /* Assignments for png_data_freer */
1902
+ #define PNG_DESTROY_WILL_FREE_DATA 1
1903
+ #define PNG_SET_WILL_FREE_DATA 1
1904
+ #define PNG_USER_WILL_FREE_DATA 2
1905
+ /* Flags for png_ptr->free_me and info_ptr->free_me */
1906
+ #define PNG_FREE_HIST 0x0008
1907
+ #define PNG_FREE_ICCP 0x0010
1908
+ #define PNG_FREE_SPLT 0x0020
1909
+ #define PNG_FREE_ROWS 0x0040
1910
+ #define PNG_FREE_PCAL 0x0080
1911
+ #define PNG_FREE_SCAL 0x0100
1912
+ #ifdef PNG_STORE_UNKNOWN_CHUNKS_SUPPORTED
1913
+ # define PNG_FREE_UNKN 0x0200
1914
+ #endif
1915
+ /* PNG_FREE_LIST 0x0400 removed in 1.6.0 because it is ignored */
1916
+ #define PNG_FREE_PLTE 0x1000
1917
+ #define PNG_FREE_TRNS 0x2000
1918
+ #define PNG_FREE_TEXT 0x4000
1919
+ #define PNG_FREE_ALL 0x7fff
1920
+ #define PNG_FREE_MUL 0x4220 /* PNG_FREE_SPLT|PNG_FREE_TEXT|PNG_FREE_UNKN */
1921
+
1922
+ #ifdef PNG_USER_MEM_SUPPORTED
1923
+ PNG_EXPORTA(100, png_voidp, png_malloc_default, (png_const_structrp png_ptr,
1924
+ png_alloc_size_t size), PNG_ALLOCATED PNG_DEPRECATED);
1925
+ PNG_EXPORTA(101, void, png_free_default, (png_const_structrp png_ptr,
1926
+ png_voidp ptr), PNG_DEPRECATED);
1927
+ #endif
1928
+
1929
+ #ifdef PNG_ERROR_TEXT_SUPPORTED
1930
+ /* Fatal error in PNG image of libpng - can't continue */
1931
+ PNG_EXPORTA(102, void, png_error, (png_const_structrp png_ptr,
1932
+ png_const_charp error_message), PNG_NORETURN);
1933
+
1934
+ /* The same, but the chunk name is prepended to the error string. */
1935
+ PNG_EXPORTA(103, void, png_chunk_error, (png_const_structrp png_ptr,
1936
+ png_const_charp error_message), PNG_NORETURN);
1937
+
1938
+ #else
1939
+ /* Fatal error in PNG image of libpng - can't continue */
1940
+ PNG_EXPORTA(104, void, png_err, (png_const_structrp png_ptr), PNG_NORETURN);
1941
+ # define png_error(s1,s2) png_err(s1)
1942
+ # define png_chunk_error(s1,s2) png_err(s1)
1943
+ #endif
1944
+
1945
+ #ifdef PNG_WARNINGS_SUPPORTED
1946
+ /* Non-fatal error in libpng. Can continue, but may have a problem. */
1947
+ PNG_EXPORT(105, void, png_warning, (png_const_structrp png_ptr,
1948
+ png_const_charp warning_message));
1949
+
1950
+ /* Non-fatal error in libpng, chunk name is prepended to message. */
1951
+ PNG_EXPORT(106, void, png_chunk_warning, (png_const_structrp png_ptr,
1952
+ png_const_charp warning_message));
1953
+ #else
1954
+ # define png_warning(s1,s2) ((void)(s1))
1955
+ # define png_chunk_warning(s1,s2) ((void)(s1))
1956
+ #endif
1957
+
1958
+ #ifdef PNG_BENIGN_ERRORS_SUPPORTED
1959
+ /* Benign error in libpng. Can continue, but may have a problem.
1960
+ * User can choose whether to handle as a fatal error or as a warning. */
1961
+ PNG_EXPORT(107, void, png_benign_error, (png_const_structrp png_ptr,
1962
+ png_const_charp warning_message));
1963
+
1964
+ #ifdef PNG_READ_SUPPORTED
1965
+ /* Same, chunk name is prepended to message (only during read) */
1966
+ PNG_EXPORT(108, void, png_chunk_benign_error, (png_const_structrp png_ptr,
1967
+ png_const_charp warning_message));
1968
+ #endif
1969
+
1970
+ PNG_EXPORT(109, void, png_set_benign_errors,
1971
+ (png_structrp png_ptr, int allowed));
1972
+ #else
1973
+ # ifdef PNG_ALLOW_BENIGN_ERRORS
1974
+ # define png_benign_error png_warning
1975
+ # define png_chunk_benign_error png_chunk_warning
1976
+ # else
1977
+ # define png_benign_error png_error
1978
+ # define png_chunk_benign_error png_chunk_error
1979
+ # endif
1980
+ #endif
1981
+
1982
+ /* The png_set_<chunk> functions are for storing values in the png_info_struct.
1983
+ * Similarly, the png_get_<chunk> calls are used to read values from the
1984
+ * png_info_struct, either storing the parameters in the passed variables, or
1985
+ * setting pointers into the png_info_struct where the data is stored. The
1986
+ * png_get_<chunk> functions return a non-zero value if the data was available
1987
+ * in info_ptr, or return zero and do not change any of the parameters if the
1988
+ * data was not available.
1989
+ *
1990
+ * These functions should be used instead of directly accessing png_info
1991
+ * to avoid problems with future changes in the size and internal layout of
1992
+ * png_info_struct.
1993
+ */
1994
+ /* Returns "flag" if chunk data is valid in info_ptr. */
1995
+ PNG_EXPORT(110, png_uint_32, png_get_valid, (png_const_structrp png_ptr,
1996
+ png_const_inforp info_ptr, png_uint_32 flag));
1997
+
1998
+ /* Returns number of bytes needed to hold a transformed row. */
1999
+ PNG_EXPORT(111, png_size_t, png_get_rowbytes, (png_const_structrp png_ptr,
2000
+ png_const_inforp info_ptr));
2001
+
2002
+ #ifdef PNG_INFO_IMAGE_SUPPORTED
2003
+ /* Returns row_pointers, which is an array of pointers to scanlines that was
2004
+ * returned from png_read_png().
2005
+ */
2006
+ PNG_EXPORT(112, png_bytepp, png_get_rows, (png_const_structrp png_ptr,
2007
+ png_const_inforp info_ptr));
2008
+
2009
+ /* Set row_pointers, which is an array of pointers to scanlines for use
2010
+ * by png_write_png().
2011
+ */
2012
+ PNG_EXPORT(113, void, png_set_rows, (png_const_structrp png_ptr,
2013
+ png_inforp info_ptr, png_bytepp row_pointers));
2014
+ #endif
2015
+
2016
+ /* Returns number of color channels in image. */
2017
+ PNG_EXPORT(114, png_byte, png_get_channels, (png_const_structrp png_ptr,
2018
+ png_const_inforp info_ptr));
2019
+
2020
+ #ifdef PNG_EASY_ACCESS_SUPPORTED
2021
+ /* Returns image width in pixels. */
2022
+ PNG_EXPORT(115, png_uint_32, png_get_image_width, (png_const_structrp png_ptr,
2023
+ png_const_inforp info_ptr));
2024
+
2025
+ /* Returns image height in pixels. */
2026
+ PNG_EXPORT(116, png_uint_32, png_get_image_height, (png_const_structrp png_ptr,
2027
+ png_const_inforp info_ptr));
2028
+
2029
+ /* Returns image bit_depth. */
2030
+ PNG_EXPORT(117, png_byte, png_get_bit_depth, (png_const_structrp png_ptr,
2031
+ png_const_inforp info_ptr));
2032
+
2033
+ /* Returns image color_type. */
2034
+ PNG_EXPORT(118, png_byte, png_get_color_type, (png_const_structrp png_ptr,
2035
+ png_const_inforp info_ptr));
2036
+
2037
+ /* Returns image filter_type. */
2038
+ PNG_EXPORT(119, png_byte, png_get_filter_type, (png_const_structrp png_ptr,
2039
+ png_const_inforp info_ptr));
2040
+
2041
+ /* Returns image interlace_type. */
2042
+ PNG_EXPORT(120, png_byte, png_get_interlace_type, (png_const_structrp png_ptr,
2043
+ png_const_inforp info_ptr));
2044
+
2045
+ /* Returns image compression_type. */
2046
+ PNG_EXPORT(121, png_byte, png_get_compression_type, (png_const_structrp png_ptr,
2047
+ png_const_inforp info_ptr));
2048
+
2049
+ /* Returns image resolution in pixels per meter, from pHYs chunk data. */
2050
+ PNG_EXPORT(122, png_uint_32, png_get_pixels_per_meter,
2051
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2052
+ PNG_EXPORT(123, png_uint_32, png_get_x_pixels_per_meter,
2053
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2054
+ PNG_EXPORT(124, png_uint_32, png_get_y_pixels_per_meter,
2055
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2056
+
2057
+ /* Returns pixel aspect ratio, computed from pHYs chunk data. */
2058
+ PNG_FP_EXPORT(125, float, png_get_pixel_aspect_ratio,
2059
+ (png_const_structrp png_ptr, png_const_inforp info_ptr))
2060
+ PNG_FIXED_EXPORT(210, png_fixed_point, png_get_pixel_aspect_ratio_fixed,
2061
+ (png_const_structrp png_ptr, png_const_inforp info_ptr))
2062
+
2063
+ /* Returns image x, y offset in pixels or microns, from oFFs chunk data. */
2064
+ PNG_EXPORT(126, png_int_32, png_get_x_offset_pixels,
2065
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2066
+ PNG_EXPORT(127, png_int_32, png_get_y_offset_pixels,
2067
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2068
+ PNG_EXPORT(128, png_int_32, png_get_x_offset_microns,
2069
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2070
+ PNG_EXPORT(129, png_int_32, png_get_y_offset_microns,
2071
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2072
+
2073
+ #endif /* PNG_EASY_ACCESS_SUPPORTED */
2074
+
2075
+ #ifdef PNG_READ_SUPPORTED
2076
+ /* Returns pointer to signature string read from PNG header */
2077
+ PNG_EXPORT(130, png_const_bytep, png_get_signature, (png_const_structrp png_ptr,
2078
+ png_const_inforp info_ptr));
2079
+ #endif
2080
+
2081
+ #ifdef PNG_bKGD_SUPPORTED
2082
+ PNG_EXPORT(131, png_uint_32, png_get_bKGD, (png_const_structrp png_ptr,
2083
+ png_inforp info_ptr, png_color_16p *background));
2084
+ #endif
2085
+
2086
+ #ifdef PNG_bKGD_SUPPORTED
2087
+ PNG_EXPORT(132, void, png_set_bKGD, (png_const_structrp png_ptr,
2088
+ png_inforp info_ptr, png_const_color_16p background));
2089
+ #endif
2090
+
2091
+ #ifdef PNG_cHRM_SUPPORTED
2092
+ PNG_FP_EXPORT(133, png_uint_32, png_get_cHRM, (png_const_structrp png_ptr,
2093
+ png_const_inforp info_ptr, double *white_x, double *white_y, double *red_x,
2094
+ double *red_y, double *green_x, double *green_y, double *blue_x,
2095
+ double *blue_y))
2096
+ PNG_FP_EXPORT(230, png_uint_32, png_get_cHRM_XYZ, (png_const_structrp png_ptr,
2097
+ png_const_inforp info_ptr, double *red_X, double *red_Y, double *red_Z,
2098
+ double *green_X, double *green_Y, double *green_Z, double *blue_X,
2099
+ double *blue_Y, double *blue_Z))
2100
+ PNG_FIXED_EXPORT(134, png_uint_32, png_get_cHRM_fixed,
2101
+ (png_const_structrp png_ptr, png_const_inforp info_ptr,
2102
+ png_fixed_point *int_white_x, png_fixed_point *int_white_y,
2103
+ png_fixed_point *int_red_x, png_fixed_point *int_red_y,
2104
+ png_fixed_point *int_green_x, png_fixed_point *int_green_y,
2105
+ png_fixed_point *int_blue_x, png_fixed_point *int_blue_y))
2106
+ PNG_FIXED_EXPORT(231, png_uint_32, png_get_cHRM_XYZ_fixed,
2107
+ (png_const_structrp png_ptr, png_const_inforp info_ptr,
2108
+ png_fixed_point *int_red_X, png_fixed_point *int_red_Y,
2109
+ png_fixed_point *int_red_Z, png_fixed_point *int_green_X,
2110
+ png_fixed_point *int_green_Y, png_fixed_point *int_green_Z,
2111
+ png_fixed_point *int_blue_X, png_fixed_point *int_blue_Y,
2112
+ png_fixed_point *int_blue_Z))
2113
+ #endif
2114
+
2115
+ #ifdef PNG_cHRM_SUPPORTED
2116
+ PNG_FP_EXPORT(135, void, png_set_cHRM, (png_const_structrp png_ptr,
2117
+ png_inforp info_ptr,
2118
+ double white_x, double white_y, double red_x, double red_y, double green_x,
2119
+ double green_y, double blue_x, double blue_y))
2120
+ PNG_FP_EXPORT(232, void, png_set_cHRM_XYZ, (png_const_structrp png_ptr,
2121
+ png_inforp info_ptr, double red_X, double red_Y, double red_Z,
2122
+ double green_X, double green_Y, double green_Z, double blue_X,
2123
+ double blue_Y, double blue_Z))
2124
+ PNG_FIXED_EXPORT(136, void, png_set_cHRM_fixed, (png_const_structrp png_ptr,
2125
+ png_inforp info_ptr, png_fixed_point int_white_x,
2126
+ png_fixed_point int_white_y, png_fixed_point int_red_x,
2127
+ png_fixed_point int_red_y, png_fixed_point int_green_x,
2128
+ png_fixed_point int_green_y, png_fixed_point int_blue_x,
2129
+ png_fixed_point int_blue_y))
2130
+ PNG_FIXED_EXPORT(233, void, png_set_cHRM_XYZ_fixed, (png_const_structrp png_ptr,
2131
+ png_inforp info_ptr, png_fixed_point int_red_X, png_fixed_point int_red_Y,
2132
+ png_fixed_point int_red_Z, png_fixed_point int_green_X,
2133
+ png_fixed_point int_green_Y, png_fixed_point int_green_Z,
2134
+ png_fixed_point int_blue_X, png_fixed_point int_blue_Y,
2135
+ png_fixed_point int_blue_Z))
2136
+ #endif
2137
+
2138
+ #ifdef PNG_gAMA_SUPPORTED
2139
+ PNG_FP_EXPORT(137, png_uint_32, png_get_gAMA, (png_const_structrp png_ptr,
2140
+ png_const_inforp info_ptr, double *file_gamma))
2141
+ PNG_FIXED_EXPORT(138, png_uint_32, png_get_gAMA_fixed,
2142
+ (png_const_structrp png_ptr, png_const_inforp info_ptr,
2143
+ png_fixed_point *int_file_gamma))
2144
+ #endif
2145
+
2146
+ #ifdef PNG_gAMA_SUPPORTED
2147
+ PNG_FP_EXPORT(139, void, png_set_gAMA, (png_const_structrp png_ptr,
2148
+ png_inforp info_ptr, double file_gamma))
2149
+ PNG_FIXED_EXPORT(140, void, png_set_gAMA_fixed, (png_const_structrp png_ptr,
2150
+ png_inforp info_ptr, png_fixed_point int_file_gamma))
2151
+ #endif
2152
+
2153
+ #ifdef PNG_hIST_SUPPORTED
2154
+ PNG_EXPORT(141, png_uint_32, png_get_hIST, (png_const_structrp png_ptr,
2155
+ png_inforp info_ptr, png_uint_16p *hist));
2156
+ #endif
2157
+
2158
+ #ifdef PNG_hIST_SUPPORTED
2159
+ PNG_EXPORT(142, void, png_set_hIST, (png_const_structrp png_ptr,
2160
+ png_inforp info_ptr, png_const_uint_16p hist));
2161
+ #endif
2162
+
2163
+ PNG_EXPORT(143, png_uint_32, png_get_IHDR, (png_const_structrp png_ptr,
2164
+ png_const_inforp info_ptr, png_uint_32 *width, png_uint_32 *height,
2165
+ int *bit_depth, int *color_type, int *interlace_method,
2166
+ int *compression_method, int *filter_method));
2167
+
2168
+ PNG_EXPORT(144, void, png_set_IHDR, (png_const_structrp png_ptr,
2169
+ png_inforp info_ptr, png_uint_32 width, png_uint_32 height, int bit_depth,
2170
+ int color_type, int interlace_method, int compression_method,
2171
+ int filter_method));
2172
+
2173
+ #ifdef PNG_oFFs_SUPPORTED
2174
+ PNG_EXPORT(145, png_uint_32, png_get_oFFs, (png_const_structrp png_ptr,
2175
+ png_const_inforp info_ptr, png_int_32 *offset_x, png_int_32 *offset_y,
2176
+ int *unit_type));
2177
+ #endif
2178
+
2179
+ #ifdef PNG_oFFs_SUPPORTED
2180
+ PNG_EXPORT(146, void, png_set_oFFs, (png_const_structrp png_ptr,
2181
+ png_inforp info_ptr, png_int_32 offset_x, png_int_32 offset_y,
2182
+ int unit_type));
2183
+ #endif
2184
+
2185
+ #ifdef PNG_pCAL_SUPPORTED
2186
+ PNG_EXPORT(147, png_uint_32, png_get_pCAL, (png_const_structrp png_ptr,
2187
+ png_inforp info_ptr, png_charp *purpose, png_int_32 *X0,
2188
+ png_int_32 *X1, int *type, int *nparams, png_charp *units,
2189
+ png_charpp *params));
2190
+ #endif
2191
+
2192
+ #ifdef PNG_pCAL_SUPPORTED
2193
+ PNG_EXPORT(148, void, png_set_pCAL, (png_const_structrp png_ptr,
2194
+ png_inforp info_ptr, png_const_charp purpose, png_int_32 X0, png_int_32 X1,
2195
+ int type, int nparams, png_const_charp units, png_charpp params));
2196
+ #endif
2197
+
2198
+ #ifdef PNG_pHYs_SUPPORTED
2199
+ PNG_EXPORT(149, png_uint_32, png_get_pHYs, (png_const_structrp png_ptr,
2200
+ png_const_inforp info_ptr, png_uint_32 *res_x, png_uint_32 *res_y,
2201
+ int *unit_type));
2202
+ #endif
2203
+
2204
+ #ifdef PNG_pHYs_SUPPORTED
2205
+ PNG_EXPORT(150, void, png_set_pHYs, (png_const_structrp png_ptr,
2206
+ png_inforp info_ptr, png_uint_32 res_x, png_uint_32 res_y, int unit_type));
2207
+ #endif
2208
+
2209
+ PNG_EXPORT(151, png_uint_32, png_get_PLTE, (png_const_structrp png_ptr,
2210
+ png_inforp info_ptr, png_colorp *palette, int *num_palette));
2211
+
2212
+ PNG_EXPORT(152, void, png_set_PLTE, (png_structrp png_ptr,
2213
+ png_inforp info_ptr, png_const_colorp palette, int num_palette));
2214
+
2215
+ #ifdef PNG_sBIT_SUPPORTED
2216
+ PNG_EXPORT(153, png_uint_32, png_get_sBIT, (png_const_structrp png_ptr,
2217
+ png_inforp info_ptr, png_color_8p *sig_bit));
2218
+ #endif
2219
+
2220
+ #ifdef PNG_sBIT_SUPPORTED
2221
+ PNG_EXPORT(154, void, png_set_sBIT, (png_const_structrp png_ptr,
2222
+ png_inforp info_ptr, png_const_color_8p sig_bit));
2223
+ #endif
2224
+
2225
+ #ifdef PNG_sRGB_SUPPORTED
2226
+ PNG_EXPORT(155, png_uint_32, png_get_sRGB, (png_const_structrp png_ptr,
2227
+ png_const_inforp info_ptr, int *file_srgb_intent));
2228
+ #endif
2229
+
2230
+ #ifdef PNG_sRGB_SUPPORTED
2231
+ PNG_EXPORT(156, void, png_set_sRGB, (png_const_structrp png_ptr,
2232
+ png_inforp info_ptr, int srgb_intent));
2233
+ PNG_EXPORT(157, void, png_set_sRGB_gAMA_and_cHRM, (png_const_structrp png_ptr,
2234
+ png_inforp info_ptr, int srgb_intent));
2235
+ #endif
2236
+
2237
+ #ifdef PNG_iCCP_SUPPORTED
2238
+ PNG_EXPORT(158, png_uint_32, png_get_iCCP, (png_const_structrp png_ptr,
2239
+ png_inforp info_ptr, png_charpp name, int *compression_type,
2240
+ png_bytepp profile, png_uint_32 *proflen));
2241
+ #endif
2242
+
2243
+ #ifdef PNG_iCCP_SUPPORTED
2244
+ PNG_EXPORT(159, void, png_set_iCCP, (png_const_structrp png_ptr,
2245
+ png_inforp info_ptr, png_const_charp name, int compression_type,
2246
+ png_const_bytep profile, png_uint_32 proflen));
2247
+ #endif
2248
+
2249
+ #ifdef PNG_sPLT_SUPPORTED
2250
+ PNG_EXPORT(160, int, png_get_sPLT, (png_const_structrp png_ptr,
2251
+ png_inforp info_ptr, png_sPLT_tpp entries));
2252
+ #endif
2253
+
2254
+ #ifdef PNG_sPLT_SUPPORTED
2255
+ PNG_EXPORT(161, void, png_set_sPLT, (png_const_structrp png_ptr,
2256
+ png_inforp info_ptr, png_const_sPLT_tp entries, int nentries));
2257
+ #endif
2258
+
2259
+ #ifdef PNG_TEXT_SUPPORTED
2260
+ /* png_get_text also returns the number of text chunks in *num_text */
2261
+ PNG_EXPORT(162, int, png_get_text, (png_const_structrp png_ptr,
2262
+ png_inforp info_ptr, png_textp *text_ptr, int *num_text));
2263
+ #endif
2264
+
2265
+ /* Note while png_set_text() will accept a structure whose text,
2266
+ * language, and translated keywords are NULL pointers, the structure
2267
+ * returned by png_get_text will always contain regular
2268
+ * zero-terminated C strings. They might be empty strings but
2269
+ * they will never be NULL pointers.
2270
+ */
2271
+
2272
+ #ifdef PNG_TEXT_SUPPORTED
2273
+ PNG_EXPORT(163, void, png_set_text, (png_const_structrp png_ptr,
2274
+ png_inforp info_ptr, png_const_textp text_ptr, int num_text));
2275
+ #endif
2276
+
2277
+ #ifdef PNG_tIME_SUPPORTED
2278
+ PNG_EXPORT(164, png_uint_32, png_get_tIME, (png_const_structrp png_ptr,
2279
+ png_inforp info_ptr, png_timep *mod_time));
2280
+ #endif
2281
+
2282
+ #ifdef PNG_tIME_SUPPORTED
2283
+ PNG_EXPORT(165, void, png_set_tIME, (png_const_structrp png_ptr,
2284
+ png_inforp info_ptr, png_const_timep mod_time));
2285
+ #endif
2286
+
2287
+ #ifdef PNG_tRNS_SUPPORTED
2288
+ PNG_EXPORT(166, png_uint_32, png_get_tRNS, (png_const_structrp png_ptr,
2289
+ png_inforp info_ptr, png_bytep *trans_alpha, int *num_trans,
2290
+ png_color_16p *trans_color));
2291
+ #endif
2292
+
2293
+ #ifdef PNG_tRNS_SUPPORTED
2294
+ PNG_EXPORT(167, void, png_set_tRNS, (png_structrp png_ptr,
2295
+ png_inforp info_ptr, png_const_bytep trans_alpha, int num_trans,
2296
+ png_const_color_16p trans_color));
2297
+ #endif
2298
+
2299
+ #ifdef PNG_sCAL_SUPPORTED
2300
+ PNG_FP_EXPORT(168, png_uint_32, png_get_sCAL, (png_const_structrp png_ptr,
2301
+ png_const_inforp info_ptr, int *unit, double *width, double *height))
2302
+ #if defined(PNG_FLOATING_ARITHMETIC_SUPPORTED) || \
2303
+ defined(PNG_FLOATING_POINT_SUPPORTED)
2304
+ /* NOTE: this API is currently implemented using floating point arithmetic,
2305
+ * consequently it can only be used on systems with floating point support.
2306
+ * In any case the range of values supported by png_fixed_point is small and it
2307
+ * is highly recommended that png_get_sCAL_s be used instead.
2308
+ */
2309
+ PNG_FIXED_EXPORT(214, png_uint_32, png_get_sCAL_fixed,
2310
+ (png_const_structrp png_ptr, png_const_inforp info_ptr, int *unit,
2311
+ png_fixed_point *width, png_fixed_point *height))
2312
+ #endif
2313
+ PNG_EXPORT(169, png_uint_32, png_get_sCAL_s,
2314
+ (png_const_structrp png_ptr, png_const_inforp info_ptr, int *unit,
2315
+ png_charpp swidth, png_charpp sheight));
2316
+
2317
+ PNG_FP_EXPORT(170, void, png_set_sCAL, (png_const_structrp png_ptr,
2318
+ png_inforp info_ptr, int unit, double width, double height))
2319
+ PNG_FIXED_EXPORT(213, void, png_set_sCAL_fixed, (png_const_structrp png_ptr,
2320
+ png_inforp info_ptr, int unit, png_fixed_point width,
2321
+ png_fixed_point height))
2322
+ PNG_EXPORT(171, void, png_set_sCAL_s, (png_const_structrp png_ptr,
2323
+ png_inforp info_ptr, int unit,
2324
+ png_const_charp swidth, png_const_charp sheight));
2325
+ #endif /* PNG_sCAL_SUPPORTED */
2326
+
2327
+ #ifdef PNG_SET_UNKNOWN_CHUNKS_SUPPORTED
2328
+ /* Provide the default handling for all unknown chunks or, optionally, for
2329
+ * specific unknown chunks.
2330
+ *
2331
+ * NOTE: prior to 1.6.0 the handling specified for particular chunks on read was
2332
+ * ignored and the default was used, the per-chunk setting only had an effect on
2333
+ * write. If you wish to have chunk-specific handling on read in code that must
2334
+ * work on earlier versions you must use a user chunk callback to specify the
2335
+ * desired handling (keep or discard.)
2336
+ *
2337
+ * The 'keep' parameter is a PNG_HANDLE_CHUNK_ value as listed below. The
2338
+ * parameter is interpreted as follows:
2339
+ *
2340
+ * READ:
2341
+ * PNG_HANDLE_CHUNK_AS_DEFAULT:
2342
+ * Known chunks: do normal libpng processing, do not keep the chunk (but
2343
+ * see the comments below about PNG_HANDLE_AS_UNKNOWN_SUPPORTED)
2344
+ * Unknown chunks: for a specific chunk use the global default, when used
2345
+ * as the default discard the chunk data.
2346
+ * PNG_HANDLE_CHUNK_NEVER:
2347
+ * Discard the chunk data.
2348
+ * PNG_HANDLE_CHUNK_IF_SAFE:
2349
+ * Keep the chunk data if the chunk is not critical else raise a chunk
2350
+ * error.
2351
+ * PNG_HANDLE_CHUNK_ALWAYS:
2352
+ * Keep the chunk data.
2353
+ *
2354
+ * If the chunk data is saved it can be retrieved using png_get_unknown_chunks,
2355
+ * below. Notice that specifying "AS_DEFAULT" as a global default is equivalent
2356
+ * to specifying "NEVER", however when "AS_DEFAULT" is used for specific chunks
2357
+ * it simply resets the behavior to the libpng default.
2358
+ *
2359
+ * INTERACTION WTIH USER CHUNK CALLBACKS:
2360
+ * The per-chunk handling is always used when there is a png_user_chunk_ptr
2361
+ * callback and the callback returns 0; the chunk is then always stored *unless*
2362
+ * it is critical and the per-chunk setting is other than ALWAYS. Notice that
2363
+ * the global default is *not* used in this case. (In effect the per-chunk
2364
+ * value is incremented to at least IF_SAFE.)
2365
+ *
2366
+ * IMPORTANT NOTE: this behavior will change in libpng 1.7 - the global and
2367
+ * per-chunk defaults will be honored. If you want to preserve the current
2368
+ * behavior when your callback returns 0 you must set PNG_HANDLE_CHUNK_IF_SAFE
2369
+ * as the default - if you don't do this libpng 1.6 will issue a warning.
2370
+ *
2371
+ * If you want unhandled unknown chunks to be discarded in libpng 1.6 and
2372
+ * earlier simply return '1' (handled).
2373
+ *
2374
+ * PNG_HANDLE_AS_UNKNOWN_SUPPORTED:
2375
+ * If this is *not* set known chunks will always be handled by libpng and
2376
+ * will never be stored in the unknown chunk list. Known chunks listed to
2377
+ * png_set_keep_unknown_chunks will have no effect. If it is set then known
2378
+ * chunks listed with a keep other than AS_DEFAULT will *never* be processed
2379
+ * by libpng, in addition critical chunks must either be processed by the
2380
+ * callback or saved.
2381
+ *
2382
+ * The IHDR and IEND chunks must not be listed. Because this turns off the
2383
+ * default handling for chunks that would otherwise be recognized the
2384
+ * behavior of libpng transformations may well become incorrect!
2385
+ *
2386
+ * WRITE:
2387
+ * When writing chunks the options only apply to the chunks specified by
2388
+ * png_set_unknown_chunks (below), libpng will *always* write known chunks
2389
+ * required by png_set_ calls and will always write the core critical chunks
2390
+ * (as required for PLTE).
2391
+ *
2392
+ * Each chunk in the png_set_unknown_chunks list is looked up in the
2393
+ * png_set_keep_unknown_chunks list to find the keep setting, this is then
2394
+ * interpreted as follows:
2395
+ *
2396
+ * PNG_HANDLE_CHUNK_AS_DEFAULT:
2397
+ * Write safe-to-copy chunks and write other chunks if the global
2398
+ * default is set to _ALWAYS, otherwise don't write this chunk.
2399
+ * PNG_HANDLE_CHUNK_NEVER:
2400
+ * Do not write the chunk.
2401
+ * PNG_HANDLE_CHUNK_IF_SAFE:
2402
+ * Write the chunk if it is safe-to-copy, otherwise do not write it.
2403
+ * PNG_HANDLE_CHUNK_ALWAYS:
2404
+ * Write the chunk.
2405
+ *
2406
+ * Note that the default behavior is effectively the opposite of the read case -
2407
+ * in read unknown chunks are not stored by default, in write they are written
2408
+ * by default. Also the behavior of PNG_HANDLE_CHUNK_IF_SAFE is very different
2409
+ * - on write the safe-to-copy bit is checked, on read the critical bit is
2410
+ * checked and on read if the chunk is critical an error will be raised.
2411
+ *
2412
+ * num_chunks:
2413
+ * ===========
2414
+ * If num_chunks is positive, then the "keep" parameter specifies the manner
2415
+ * for handling only those chunks appearing in the chunk_list array,
2416
+ * otherwise the chunk list array is ignored.
2417
+ *
2418
+ * If num_chunks is 0 the "keep" parameter specifies the default behavior for
2419
+ * unknown chunks, as described above.
2420
+ *
2421
+ * If num_chunks is negative, then the "keep" parameter specifies the manner
2422
+ * for handling all unknown chunks plus all chunks recognized by libpng
2423
+ * except for the IHDR, PLTE, tRNS, IDAT, and IEND chunks (which continue to
2424
+ * be processed by libpng.
2425
+ */
2426
+ PNG_EXPORT(172, void, png_set_keep_unknown_chunks, (png_structrp png_ptr,
2427
+ int keep, png_const_bytep chunk_list, int num_chunks));
2428
+
2429
+ /* The "keep" PNG_HANDLE_CHUNK_ parameter for the specified chunk is returned;
2430
+ * the result is therefore true (non-zero) if special handling is required,
2431
+ * false for the default handling.
2432
+ */
2433
+ PNG_EXPORT(173, int, png_handle_as_unknown, (png_const_structrp png_ptr,
2434
+ png_const_bytep chunk_name));
2435
+ #endif
2436
+
2437
+ #ifdef PNG_STORE_UNKNOWN_CHUNKS_SUPPORTED
2438
+ PNG_EXPORT(174, void, png_set_unknown_chunks, (png_const_structrp png_ptr,
2439
+ png_inforp info_ptr, png_const_unknown_chunkp unknowns,
2440
+ int num_unknowns));
2441
+ /* NOTE: prior to 1.6.0 this routine set the 'location' field of the added
2442
+ * unknowns to the location currently stored in the png_struct. This is
2443
+ * invariably the wrong value on write. To fix this call the following API
2444
+ * for each chunk in the list with the correct location. If you know your
2445
+ * code won't be compiled on earlier versions you can rely on
2446
+ * png_set_unknown_chunks(write-ptr, png_get_unknown_chunks(read-ptr)) doing
2447
+ * the correct thing.
2448
+ */
2449
+
2450
+ PNG_EXPORT(175, void, png_set_unknown_chunk_location,
2451
+ (png_const_structrp png_ptr, png_inforp info_ptr, int chunk, int location));
2452
+
2453
+ PNG_EXPORT(176, int, png_get_unknown_chunks, (png_const_structrp png_ptr,
2454
+ png_inforp info_ptr, png_unknown_chunkpp entries));
2455
+ #endif
2456
+
2457
+ /* Png_free_data() will turn off the "valid" flag for anything it frees.
2458
+ * If you need to turn it off for a chunk that your application has freed,
2459
+ * you can use png_set_invalid(png_ptr, info_ptr, PNG_INFO_CHNK);
2460
+ */
2461
+ PNG_EXPORT(177, void, png_set_invalid, (png_const_structrp png_ptr,
2462
+ png_inforp info_ptr, int mask));
2463
+
2464
+ #ifdef PNG_INFO_IMAGE_SUPPORTED
2465
+ /* The "params" pointer is currently not used and is for future expansion. */
2466
+ #ifdef PNG_SEQUENTIAL_READ_SUPPORTED
2467
+ PNG_EXPORT(178, void, png_read_png, (png_structrp png_ptr, png_inforp info_ptr,
2468
+ int transforms, png_voidp params));
2469
+ #endif
2470
+ #ifdef PNG_WRITE_SUPPORTED
2471
+ PNG_EXPORT(179, void, png_write_png, (png_structrp png_ptr, png_inforp info_ptr,
2472
+ int transforms, png_voidp params));
2473
+ #endif
2474
+ #endif
2475
+
2476
+ PNG_EXPORT(180, png_const_charp, png_get_copyright,
2477
+ (png_const_structrp png_ptr));
2478
+ PNG_EXPORT(181, png_const_charp, png_get_header_ver,
2479
+ (png_const_structrp png_ptr));
2480
+ PNG_EXPORT(182, png_const_charp, png_get_header_version,
2481
+ (png_const_structrp png_ptr));
2482
+ PNG_EXPORT(183, png_const_charp, png_get_libpng_ver,
2483
+ (png_const_structrp png_ptr));
2484
+
2485
+ #ifdef PNG_MNG_FEATURES_SUPPORTED
2486
+ PNG_EXPORT(184, png_uint_32, png_permit_mng_features, (png_structrp png_ptr,
2487
+ png_uint_32 mng_features_permitted));
2488
+ #endif
2489
+
2490
+ /* For use in png_set_keep_unknown, added to version 1.2.6 */
2491
+ #define PNG_HANDLE_CHUNK_AS_DEFAULT 0
2492
+ #define PNG_HANDLE_CHUNK_NEVER 1
2493
+ #define PNG_HANDLE_CHUNK_IF_SAFE 2
2494
+ #define PNG_HANDLE_CHUNK_ALWAYS 3
2495
+ #define PNG_HANDLE_CHUNK_LAST 4
2496
+
2497
+ /* Strip the prepended error numbers ("#nnn ") from error and warning
2498
+ * messages before passing them to the error or warning handler.
2499
+ */
2500
+ #ifdef PNG_ERROR_NUMBERS_SUPPORTED
2501
+ PNG_EXPORT(185, void, png_set_strip_error_numbers, (png_structrp png_ptr,
2502
+ png_uint_32 strip_mode));
2503
+ #endif
2504
+
2505
+ /* Added in libpng-1.2.6 */
2506
+ #ifdef PNG_SET_USER_LIMITS_SUPPORTED
2507
+ PNG_EXPORT(186, void, png_set_user_limits, (png_structrp png_ptr,
2508
+ png_uint_32 user_width_max, png_uint_32 user_height_max));
2509
+ PNG_EXPORT(187, png_uint_32, png_get_user_width_max,
2510
+ (png_const_structrp png_ptr));
2511
+ PNG_EXPORT(188, png_uint_32, png_get_user_height_max,
2512
+ (png_const_structrp png_ptr));
2513
+ /* Added in libpng-1.4.0 */
2514
+ PNG_EXPORT(189, void, png_set_chunk_cache_max, (png_structrp png_ptr,
2515
+ png_uint_32 user_chunk_cache_max));
2516
+ PNG_EXPORT(190, png_uint_32, png_get_chunk_cache_max,
2517
+ (png_const_structrp png_ptr));
2518
+ /* Added in libpng-1.4.1 */
2519
+ PNG_EXPORT(191, void, png_set_chunk_malloc_max, (png_structrp png_ptr,
2520
+ png_alloc_size_t user_chunk_cache_max));
2521
+ PNG_EXPORT(192, png_alloc_size_t, png_get_chunk_malloc_max,
2522
+ (png_const_structrp png_ptr));
2523
+ #endif
2524
+
2525
+ #if defined(PNG_INCH_CONVERSIONS_SUPPORTED)
2526
+ PNG_EXPORT(193, png_uint_32, png_get_pixels_per_inch,
2527
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2528
+
2529
+ PNG_EXPORT(194, png_uint_32, png_get_x_pixels_per_inch,
2530
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2531
+
2532
+ PNG_EXPORT(195, png_uint_32, png_get_y_pixels_per_inch,
2533
+ (png_const_structrp png_ptr, png_const_inforp info_ptr));
2534
+
2535
+ PNG_FP_EXPORT(196, float, png_get_x_offset_inches,
2536
+ (png_const_structrp png_ptr, png_const_inforp info_ptr))
2537
+ #ifdef PNG_FIXED_POINT_SUPPORTED /* otherwise not implemented. */
2538
+ PNG_FIXED_EXPORT(211, png_fixed_point, png_get_x_offset_inches_fixed,
2539
+ (png_const_structrp png_ptr, png_const_inforp info_ptr))
2540
+ #endif
2541
+
2542
+ PNG_FP_EXPORT(197, float, png_get_y_offset_inches, (png_const_structrp png_ptr,
2543
+ png_const_inforp info_ptr))
2544
+ #ifdef PNG_FIXED_POINT_SUPPORTED /* otherwise not implemented. */
2545
+ PNG_FIXED_EXPORT(212, png_fixed_point, png_get_y_offset_inches_fixed,
2546
+ (png_const_structrp png_ptr, png_const_inforp info_ptr))
2547
+ #endif
2548
+
2549
+ # ifdef PNG_pHYs_SUPPORTED
2550
+ PNG_EXPORT(198, png_uint_32, png_get_pHYs_dpi, (png_const_structrp png_ptr,
2551
+ png_const_inforp info_ptr, png_uint_32 *res_x, png_uint_32 *res_y,
2552
+ int *unit_type));
2553
+ # endif /* PNG_pHYs_SUPPORTED */
2554
+ #endif /* PNG_INCH_CONVERSIONS_SUPPORTED */
2555
+
2556
+ /* Added in libpng-1.4.0 */
2557
+ #ifdef PNG_IO_STATE_SUPPORTED
2558
+ PNG_EXPORT(199, png_uint_32, png_get_io_state, (png_const_structrp png_ptr));
2559
+
2560
+ /* Removed from libpng 1.6; use png_get_io_chunk_type. */
2561
+ PNG_REMOVED(200, png_const_bytep, png_get_io_chunk_name, (png_structrp png_ptr),
2562
+ PNG_DEPRECATED)
2563
+
2564
+ PNG_EXPORT(216, png_uint_32, png_get_io_chunk_type,
2565
+ (png_const_structrp png_ptr));
2566
+
2567
+ /* The flags returned by png_get_io_state() are the following: */
2568
+ # define PNG_IO_NONE 0x0000 /* no I/O at this moment */
2569
+ # define PNG_IO_READING 0x0001 /* currently reading */
2570
+ # define PNG_IO_WRITING 0x0002 /* currently writing */
2571
+ # define PNG_IO_SIGNATURE 0x0010 /* currently at the file signature */
2572
+ # define PNG_IO_CHUNK_HDR 0x0020 /* currently at the chunk header */
2573
+ # define PNG_IO_CHUNK_DATA 0x0040 /* currently at the chunk data */
2574
+ # define PNG_IO_CHUNK_CRC 0x0080 /* currently at the chunk crc */
2575
+ # define PNG_IO_MASK_OP 0x000f /* current operation: reading/writing */
2576
+ # define PNG_IO_MASK_LOC 0x00f0 /* current location: sig/hdr/data/crc */
2577
+ #endif /* ?PNG_IO_STATE_SUPPORTED */
2578
+
2579
+ /* Interlace support. The following macros are always defined so that if
2580
+ * libpng interlace handling is turned off the macros may be used to handle
2581
+ * interlaced images within the application.
2582
+ */
2583
+ #define PNG_INTERLACE_ADAM7_PASSES 7
2584
+
2585
+ /* Two macros to return the first row and first column of the original,
2586
+ * full, image which appears in a given pass. 'pass' is in the range 0
2587
+ * to 6 and the result is in the range 0 to 7.
2588
+ */
2589
+ #define PNG_PASS_START_ROW(pass) (((1&~(pass))<<(3-((pass)>>1)))&7)
2590
+ #define PNG_PASS_START_COL(pass) (((1& (pass))<<(3-(((pass)+1)>>1)))&7)
2591
+
2592
+ /* A macro to return the offset between pixels in the output row for a pair of
2593
+ * pixels in the input - effectively the inverse of the 'COL_SHIFT' macro that
2594
+ * follows. Note that ROW_OFFSET is the offset from one row to the next whereas
2595
+ * COL_OFFSET is from one column to the next, within a row.
2596
+ */
2597
+ #define PNG_PASS_ROW_OFFSET(pass) ((pass)>2?(8>>(((pass)-1)>>1)):8)
2598
+ #define PNG_PASS_COL_OFFSET(pass) (1<<((7-(pass))>>1))
2599
+
2600
+ /* Two macros to help evaluate the number of rows or columns in each
2601
+ * pass. This is expressed as a shift - effectively log2 of the number or
2602
+ * rows or columns in each 8x8 tile of the original image.
2603
+ */
2604
+ #define PNG_PASS_ROW_SHIFT(pass) ((pass)>2?(8-(pass))>>1:3)
2605
+ #define PNG_PASS_COL_SHIFT(pass) ((pass)>1?(7-(pass))>>1:3)
2606
+
2607
+ /* Hence two macros to determine the number of rows or columns in a given
2608
+ * pass of an image given its height or width. In fact these macros may
2609
+ * return non-zero even though the sub-image is empty, because the other
2610
+ * dimension may be empty for a small image.
2611
+ */
2612
+ #define PNG_PASS_ROWS(height, pass) (((height)+(((1<<PNG_PASS_ROW_SHIFT(pass))\
2613
+ -1)-PNG_PASS_START_ROW(pass)))>>PNG_PASS_ROW_SHIFT(pass))
2614
+ #define PNG_PASS_COLS(width, pass) (((width)+(((1<<PNG_PASS_COL_SHIFT(pass))\
2615
+ -1)-PNG_PASS_START_COL(pass)))>>PNG_PASS_COL_SHIFT(pass))
2616
+
2617
+ /* For the reader row callbacks (both progressive and sequential) it is
2618
+ * necessary to find the row in the output image given a row in an interlaced
2619
+ * image, so two more macros:
2620
+ */
2621
+ #define PNG_ROW_FROM_PASS_ROW(y_in, pass) \
2622
+ (((y_in)<<PNG_PASS_ROW_SHIFT(pass))+PNG_PASS_START_ROW(pass))
2623
+ #define PNG_COL_FROM_PASS_COL(x_in, pass) \
2624
+ (((x_in)<<PNG_PASS_COL_SHIFT(pass))+PNG_PASS_START_COL(pass))
2625
+
2626
+ /* Two macros which return a boolean (0 or 1) saying whether the given row
2627
+ * or column is in a particular pass. These use a common utility macro that
2628
+ * returns a mask for a given pass - the offset 'off' selects the row or
2629
+ * column version. The mask has the appropriate bit set for each column in
2630
+ * the tile.
2631
+ */
2632
+ #define PNG_PASS_MASK(pass,off) ( \
2633
+ ((0x110145AF>>(((7-(off))-(pass))<<2)) & 0xF) | \
2634
+ ((0x01145AF0>>(((7-(off))-(pass))<<2)) & 0xF0))
2635
+
2636
+ #define PNG_ROW_IN_INTERLACE_PASS(y, pass) \
2637
+ ((PNG_PASS_MASK(pass,0) >> ((y)&7)) & 1)
2638
+ #define PNG_COL_IN_INTERLACE_PASS(x, pass) \
2639
+ ((PNG_PASS_MASK(pass,1) >> ((x)&7)) & 1)
2640
+
2641
+ #ifdef PNG_READ_COMPOSITE_NODIV_SUPPORTED
2642
+ /* With these routines we avoid an integer divide, which will be slower on
2643
+ * most machines. However, it does take more operations than the corresponding
2644
+ * divide method, so it may be slower on a few RISC systems. There are two
2645
+ * shifts (by 8 or 16 bits) and an addition, versus a single integer divide.
2646
+ *
2647
+ * Note that the rounding factors are NOT supposed to be the same! 128 and
2648
+ * 32768 are correct for the NODIV code; 127 and 32767 are correct for the
2649
+ * standard method.
2650
+ *
2651
+ * [Optimized code by Greg Roelofs and Mark Adler...blame us for bugs. :-) ]
2652
+ */
2653
+
2654
+ /* fg and bg should be in `gamma 1.0' space; alpha is the opacity */
2655
+
2656
+ # define png_composite(composite, fg, alpha, bg) \
2657
+ { png_uint_16 temp = (png_uint_16)((png_uint_16)(fg) \
2658
+ * (png_uint_16)(alpha) \
2659
+ + (png_uint_16)(bg)*(png_uint_16)(255 \
2660
+ - (png_uint_16)(alpha)) + 128); \
2661
+ (composite) = (png_byte)((temp + (temp >> 8)) >> 8); }
2662
+
2663
+ # define png_composite_16(composite, fg, alpha, bg) \
2664
+ { png_uint_32 temp = (png_uint_32)((png_uint_32)(fg) \
2665
+ * (png_uint_32)(alpha) \
2666
+ + (png_uint_32)(bg)*(65535 \
2667
+ - (png_uint_32)(alpha)) + 32768); \
2668
+ (composite) = (png_uint_16)((temp + (temp >> 16)) >> 16); }
2669
+
2670
+ #else /* Standard method using integer division */
2671
+
2672
+ # define png_composite(composite, fg, alpha, bg) \
2673
+ (composite) = (png_byte)(((png_uint_16)(fg) * (png_uint_16)(alpha) + \
2674
+ (png_uint_16)(bg) * (png_uint_16)(255 - (png_uint_16)(alpha)) + \
2675
+ 127) / 255)
2676
+
2677
+ # define png_composite_16(composite, fg, alpha, bg) \
2678
+ (composite) = (png_uint_16)(((png_uint_32)(fg) * (png_uint_32)(alpha) + \
2679
+ (png_uint_32)(bg)*(png_uint_32)(65535 - (png_uint_32)(alpha)) + \
2680
+ 32767) / 65535)
2681
+ #endif /* PNG_READ_COMPOSITE_NODIV_SUPPORTED */
2682
+
2683
+ #ifdef PNG_READ_INT_FUNCTIONS_SUPPORTED
2684
+ PNG_EXPORT(201, png_uint_32, png_get_uint_32, (png_const_bytep buf));
2685
+ PNG_EXPORT(202, png_uint_16, png_get_uint_16, (png_const_bytep buf));
2686
+ PNG_EXPORT(203, png_int_32, png_get_int_32, (png_const_bytep buf));
2687
+ #endif
2688
+
2689
+ PNG_EXPORT(204, png_uint_32, png_get_uint_31, (png_const_structrp png_ptr,
2690
+ png_const_bytep buf));
2691
+ /* No png_get_int_16 -- may be added if there's a real need for it. */
2692
+
2693
+ /* Place a 32-bit number into a buffer in PNG byte order (big-endian). */
2694
+ #ifdef PNG_WRITE_INT_FUNCTIONS_SUPPORTED
2695
+ PNG_EXPORT(205, void, png_save_uint_32, (png_bytep buf, png_uint_32 i));
2696
+ #endif
2697
+ #ifdef PNG_SAVE_INT_32_SUPPORTED
2698
+ PNG_EXPORT(206, void, png_save_int_32, (png_bytep buf, png_int_32 i));
2699
+ #endif
2700
+
2701
+ /* Place a 16-bit number into a buffer in PNG byte order.
2702
+ * The parameter is declared unsigned int, not png_uint_16,
2703
+ * just to avoid potential problems on pre-ANSI C compilers.
2704
+ */
2705
+ #ifdef PNG_WRITE_INT_FUNCTIONS_SUPPORTED
2706
+ PNG_EXPORT(207, void, png_save_uint_16, (png_bytep buf, unsigned int i));
2707
+ /* No png_save_int_16 -- may be added if there's a real need for it. */
2708
+ #endif
2709
+
2710
+ #ifdef PNG_USE_READ_MACROS
2711
+ /* Inline macros to do direct reads of bytes from the input buffer.
2712
+ * The png_get_int_32() routine assumes we are using two's complement
2713
+ * format for negative values, which is almost certainly true.
2714
+ */
2715
+ # define PNG_get_uint_32(buf) \
2716
+ (((png_uint_32)(*(buf)) << 24) + \
2717
+ ((png_uint_32)(*((buf) + 1)) << 16) + \
2718
+ ((png_uint_32)(*((buf) + 2)) << 8) + \
2719
+ ((png_uint_32)(*((buf) + 3))))
2720
+
2721
+ /* From libpng-1.4.0 until 1.4.4, the png_get_uint_16 macro (but not the
2722
+ * function) incorrectly returned a value of type png_uint_32.
2723
+ */
2724
+ # define PNG_get_uint_16(buf) \
2725
+ ((png_uint_16) \
2726
+ (((unsigned int)(*(buf)) << 8) + \
2727
+ ((unsigned int)(*((buf) + 1)))))
2728
+
2729
+ # define PNG_get_int_32(buf) \
2730
+ ((png_int_32)((*(buf) & 0x80) \
2731
+ ? -((png_int_32)((png_get_uint_32(buf) ^ 0xffffffffL) + 1)) \
2732
+ : (png_int_32)png_get_uint_32(buf)))
2733
+
2734
+ /* If PNG_PREFIX is defined the same thing as below happens in pnglibconf.h,
2735
+ * but defining a macro name prefixed with PNG_PREFIX.
2736
+ */
2737
+ # ifndef PNG_PREFIX
2738
+ # define png_get_uint_32(buf) PNG_get_uint_32(buf)
2739
+ # define png_get_uint_16(buf) PNG_get_uint_16(buf)
2740
+ # define png_get_int_32(buf) PNG_get_int_32(buf)
2741
+ # endif
2742
+ #else
2743
+ # ifdef PNG_PREFIX
2744
+ /* No macros; revert to the (redefined) function */
2745
+ # define PNG_get_uint_32 (png_get_uint_32)
2746
+ # define PNG_get_uint_16 (png_get_uint_16)
2747
+ # define PNG_get_int_32 (png_get_int_32)
2748
+ # endif
2749
+ #endif
2750
+
2751
+ #if defined(PNG_SIMPLIFIED_READ_SUPPORTED) || \
2752
+ defined(PNG_SIMPLIFIED_WRITE_SUPPORTED)
2753
+ /*******************************************************************************
2754
+ * SIMPLIFIED API
2755
+ *******************************************************************************
2756
+ *
2757
+ * Please read the documentation in libpng-manual.txt (TODO: write said
2758
+ * documentation) if you don't understand what follows.
2759
+ *
2760
+ * The simplified API hides the details of both libpng and the PNG file format
2761
+ * itself. It allows PNG files to be read into a very limited number of
2762
+ * in-memory bitmap formats or to be written from the same formats. If these
2763
+ * formats do not accomodate your needs then you can, and should, use the more
2764
+ * sophisticated APIs above - these support a wide variety of in-memory formats
2765
+ * and a wide variety of sophisticated transformations to those formats as well
2766
+ * as a wide variety of APIs to manipulate ancillary information.
2767
+ *
2768
+ * To read a PNG file using the simplified API:
2769
+ *
2770
+ * 1) Declare a 'png_image' structure (see below) on the stack and set the
2771
+ * version field to PNG_IMAGE_VERSION.
2772
+ * 2) Call the appropriate png_image_begin_read... function.
2773
+ * 3) Set the png_image 'format' member to the required sample format.
2774
+ * 4) Allocate a buffer for the image and, if required, the color-map.
2775
+ * 5) Call png_image_finish_read to read the image and, if required, the
2776
+ * color-map into your buffers.
2777
+ *
2778
+ * There are no restrictions on the format of the PNG input itself; all valid
2779
+ * color types, bit depths, and interlace methods are acceptable, and the
2780
+ * input image is transformed as necessary to the requested in-memory format
2781
+ * during the png_image_finish_read() step. The only caveat is that if you
2782
+ * request a color-mapped image from a PNG that is full-color or makes
2783
+ * complex use of an alpha channel the transformation is extremely lossy and the
2784
+ * result may look terrible.
2785
+ *
2786
+ * To write a PNG file using the simplified API:
2787
+ *
2788
+ * 1) Declare a 'png_image' structure on the stack and memset() it to all zero.
2789
+ * 2) Initialize the members of the structure that describe the image, setting
2790
+ * the 'format' member to the format of the image samples.
2791
+ * 3) Call the appropriate png_image_write... function with a pointer to the
2792
+ * image and, if necessary, the color-map to write the PNG data.
2793
+ *
2794
+ * png_image is a structure that describes the in-memory format of an image
2795
+ * when it is being read or defines the in-memory format of an image that you
2796
+ * need to write:
2797
+ */
2798
+ #define PNG_IMAGE_VERSION 1
2799
+
2800
+ typedef struct png_control *png_controlp;
2801
+ typedef struct
2802
+ {
2803
+ png_controlp opaque; /* Initialize to NULL, free with png_image_free */
2804
+ png_uint_32 version; /* Set to PNG_IMAGE_VERSION */
2805
+ png_uint_32 width; /* Image width in pixels (columns) */
2806
+ png_uint_32 height; /* Image height in pixels (rows) */
2807
+ png_uint_32 format; /* Image format as defined below */
2808
+ png_uint_32 flags; /* A bit mask containing informational flags */
2809
+ png_uint_32 colormap_entries;
2810
+ /* Number of entries in the color-map */
2811
+
2812
+ /* In the event of an error or warning the following field will be set to a
2813
+ * non-zero value and the 'message' field will contain a '\0' terminated
2814
+ * string with the libpng error or warning message. If both warnings and
2815
+ * an error were encountered, only the error is recorded. If there
2816
+ * are multiple warnings, only the first one is recorded.
2817
+ *
2818
+ * The upper 30 bits of this value are reserved, the low two bits contain
2819
+ * a value as follows:
2820
+ */
2821
+ # define PNG_IMAGE_WARNING 1
2822
+ # define PNG_IMAGE_ERROR 2
2823
+ /*
2824
+ * The result is a two-bit code such that a value more than 1 indicates
2825
+ * a failure in the API just called:
2826
+ *
2827
+ * 0 - no warning or error
2828
+ * 1 - warning
2829
+ * 2 - error
2830
+ * 3 - error preceded by warning
2831
+ */
2832
+ # define PNG_IMAGE_FAILED(png_cntrl) ((((png_cntrl).warning_or_error)&0x03)>1)
2833
+
2834
+ png_uint_32 warning_or_error;
2835
+
2836
+ char message[64];
2837
+ } png_image, *png_imagep;
2838
+
2839
+ /* The samples of the image have one to four channels whose components have
2840
+ * original values in the range 0 to 1.0:
2841
+ *
2842
+ * 1: A single gray or luminance channel (G).
2843
+ * 2: A gray/luminance channel and an alpha channel (GA).
2844
+ * 3: Three red, green, blue color channels (RGB).
2845
+ * 4: Three color channels and an alpha channel (RGBA).
2846
+ *
2847
+ * The components are encoded in one of two ways:
2848
+ *
2849
+ * a) As a small integer, value 0..255, contained in a single byte. For the
2850
+ * alpha channel the original value is simply value/255. For the color or
2851
+ * luminance channels the value is encoded according to the sRGB specification
2852
+ * and matches the 8-bit format expected by typical display devices.
2853
+ *
2854
+ * The color/gray channels are not scaled (pre-multiplied) by the alpha
2855
+ * channel and are suitable for passing to color management software.
2856
+ *
2857
+ * b) As a value in the range 0..65535, contained in a 2-byte integer. All
2858
+ * channels can be converted to the original value by dividing by 65535; all
2859
+ * channels are linear. Color channels use the RGB encoding (RGB end-points) of
2860
+ * the sRGB specification. This encoding is identified by the
2861
+ * PNG_FORMAT_FLAG_LINEAR flag below.
2862
+ *
2863
+ * When the simplified API needs to convert between sRGB and linear colorspaces,
2864
+ * the actual sRGB transfer curve defined in the sRGB specification (see the
2865
+ * article at http://en.wikipedia.org/wiki/SRGB) is used, not the gamma=1/2.2
2866
+ * approximation used elsewhere in libpng.
2867
+ *
2868
+ * When an alpha channel is present it is expected to denote pixel coverage
2869
+ * of the color or luminance channels and is returned as an associated alpha
2870
+ * channel: the color/gray channels are scaled (pre-multiplied) by the alpha
2871
+ * value.
2872
+ *
2873
+ * The samples are either contained directly in the image data, between 1 and 8
2874
+ * bytes per pixel according to the encoding, or are held in a color-map indexed
2875
+ * by bytes in the image data. In the case of a color-map the color-map entries
2876
+ * are individual samples, encoded as above, and the image data has one byte per
2877
+ * pixel to select the relevant sample from the color-map.
2878
+ */
2879
+
2880
+ /* PNG_FORMAT_*
2881
+ *
2882
+ * #defines to be used in png_image::format. Each #define identifies a
2883
+ * particular layout of sample data and, if present, alpha values. There are
2884
+ * separate defines for each of the two component encodings.
2885
+ *
2886
+ * A format is built up using single bit flag values. All combinations are
2887
+ * valid. Formats can be built up from the flag values or you can use one of
2888
+ * the predefined values below. When testing formats always use the FORMAT_FLAG
2889
+ * macros to test for individual features - future versions of the library may
2890
+ * add new flags.
2891
+ *
2892
+ * When reading or writing color-mapped images the format should be set to the
2893
+ * format of the entries in the color-map then png_image_{read,write}_colormap
2894
+ * called to read or write the color-map and set the format correctly for the
2895
+ * image data. Do not set the PNG_FORMAT_FLAG_COLORMAP bit directly!
2896
+ *
2897
+ * NOTE: libpng can be built with particular features disabled, if you see
2898
+ * compiler errors because the definition of one of the following flags has been
2899
+ * compiled out it is because libpng does not have the required support. It is
2900
+ * possible, however, for the libpng configuration to enable the format on just
2901
+ * read or just write; in that case you may see an error at run time. You can
2902
+ * guard against this by checking for the definition of the appropriate
2903
+ * "_SUPPORTED" macro, one of:
2904
+ *
2905
+ * PNG_SIMPLIFIED_{READ,WRITE}_{BGR,AFIRST}_SUPPORTED
2906
+ */
2907
+ #define PNG_FORMAT_FLAG_ALPHA 0x01U /* format with an alpha channel */
2908
+ #define PNG_FORMAT_FLAG_COLOR 0x02U /* color format: otherwise grayscale */
2909
+ #define PNG_FORMAT_FLAG_LINEAR 0x04U /* 2 byte channels else 1 byte */
2910
+ #define PNG_FORMAT_FLAG_COLORMAP 0x08U /* image data is color-mapped */
2911
+
2912
+ #ifdef PNG_FORMAT_BGR_SUPPORTED
2913
+ # define PNG_FORMAT_FLAG_BGR 0x10U /* BGR colors, else order is RGB */
2914
+ #endif
2915
+
2916
+ #ifdef PNG_FORMAT_AFIRST_SUPPORTED
2917
+ # define PNG_FORMAT_FLAG_AFIRST 0x20U /* alpha channel comes first */
2918
+ #endif
2919
+
2920
+ /* Commonly used formats have predefined macros.
2921
+ *
2922
+ * First the single byte (sRGB) formats:
2923
+ */
2924
+ #define PNG_FORMAT_GRAY 0
2925
+ #define PNG_FORMAT_GA PNG_FORMAT_FLAG_ALPHA
2926
+ #define PNG_FORMAT_AG (PNG_FORMAT_GA|PNG_FORMAT_FLAG_AFIRST)
2927
+ #define PNG_FORMAT_RGB PNG_FORMAT_FLAG_COLOR
2928
+ #define PNG_FORMAT_BGR (PNG_FORMAT_FLAG_COLOR|PNG_FORMAT_FLAG_BGR)
2929
+ #define PNG_FORMAT_RGBA (PNG_FORMAT_RGB|PNG_FORMAT_FLAG_ALPHA)
2930
+ #define PNG_FORMAT_ARGB (PNG_FORMAT_RGBA|PNG_FORMAT_FLAG_AFIRST)
2931
+ #define PNG_FORMAT_BGRA (PNG_FORMAT_BGR|PNG_FORMAT_FLAG_ALPHA)
2932
+ #define PNG_FORMAT_ABGR (PNG_FORMAT_BGRA|PNG_FORMAT_FLAG_AFIRST)
2933
+
2934
+ /* Then the linear 2-byte formats. When naming these "Y" is used to
2935
+ * indicate a luminance (gray) channel.
2936
+ */
2937
+ #define PNG_FORMAT_LINEAR_Y PNG_FORMAT_FLAG_LINEAR
2938
+ #define PNG_FORMAT_LINEAR_Y_ALPHA (PNG_FORMAT_FLAG_LINEAR|PNG_FORMAT_FLAG_ALPHA)
2939
+ #define PNG_FORMAT_LINEAR_RGB (PNG_FORMAT_FLAG_LINEAR|PNG_FORMAT_FLAG_COLOR)
2940
+ #define PNG_FORMAT_LINEAR_RGB_ALPHA \
2941
+ (PNG_FORMAT_FLAG_LINEAR|PNG_FORMAT_FLAG_COLOR|PNG_FORMAT_FLAG_ALPHA)
2942
+
2943
+ /* With color-mapped formats the image data is one byte for each pixel, the byte
2944
+ * is an index into the color-map which is formatted as above. To obtain a
2945
+ * color-mapped format it is sufficient just to add the PNG_FOMAT_FLAG_COLORMAP
2946
+ * to one of the above definitions, or you can use one of the definitions below.
2947
+ */
2948
+ #define PNG_FORMAT_RGB_COLORMAP (PNG_FORMAT_RGB|PNG_FORMAT_FLAG_COLORMAP)
2949
+ #define PNG_FORMAT_BGR_COLORMAP (PNG_FORMAT_BGR|PNG_FORMAT_FLAG_COLORMAP)
2950
+ #define PNG_FORMAT_RGBA_COLORMAP (PNG_FORMAT_RGBA|PNG_FORMAT_FLAG_COLORMAP)
2951
+ #define PNG_FORMAT_ARGB_COLORMAP (PNG_FORMAT_ARGB|PNG_FORMAT_FLAG_COLORMAP)
2952
+ #define PNG_FORMAT_BGRA_COLORMAP (PNG_FORMAT_BGRA|PNG_FORMAT_FLAG_COLORMAP)
2953
+ #define PNG_FORMAT_ABGR_COLORMAP (PNG_FORMAT_ABGR|PNG_FORMAT_FLAG_COLORMAP)
2954
+
2955
+ /* PNG_IMAGE macros
2956
+ *
2957
+ * These are convenience macros to derive information from a png_image
2958
+ * structure. The PNG_IMAGE_SAMPLE_ macros return values appropriate to the
2959
+ * actual image sample values - either the entries in the color-map or the
2960
+ * pixels in the image. The PNG_IMAGE_PIXEL_ macros return corresponding values
2961
+ * for the pixels and will always return 1 for color-mapped formats. The
2962
+ * remaining macros return information about the rows in the image and the
2963
+ * complete image.
2964
+ *
2965
+ * NOTE: All the macros that take a png_image::format parameter are compile time
2966
+ * constants if the format parameter is, itself, a constant. Therefore these
2967
+ * macros can be used in array declarations and case labels where required.
2968
+ * Similarly the macros are also pre-processor constants (sizeof is not used) so
2969
+ * they can be used in #if tests.
2970
+ *
2971
+ * First the information about the samples.
2972
+ */
2973
+ #define PNG_IMAGE_SAMPLE_CHANNELS(fmt)\
2974
+ (((fmt)&(PNG_FORMAT_FLAG_COLOR|PNG_FORMAT_FLAG_ALPHA))+1)
2975
+ /* Return the total number of channels in a given format: 1..4 */
2976
+
2977
+ #define PNG_IMAGE_SAMPLE_COMPONENT_SIZE(fmt)\
2978
+ ((((fmt) & PNG_FORMAT_FLAG_LINEAR) >> 2)+1)
2979
+ /* Return the size in bytes of a single component of a pixel or color-map
2980
+ * entry (as appropriate) in the image: 1 or 2.
2981
+ */
2982
+
2983
+ #define PNG_IMAGE_SAMPLE_SIZE(fmt)\
2984
+ (PNG_IMAGE_SAMPLE_CHANNELS(fmt) * PNG_IMAGE_SAMPLE_COMPONENT_SIZE(fmt))
2985
+ /* This is the size of the sample data for one sample. If the image is
2986
+ * color-mapped it is the size of one color-map entry (and image pixels are
2987
+ * one byte in size), otherwise it is the size of one image pixel.
2988
+ */
2989
+
2990
+ #define PNG_IMAGE_MAXIMUM_COLORMAP_COMPONENTS(fmt)\
2991
+ (PNG_IMAGE_SAMPLE_CHANNELS(fmt) * 256)
2992
+ /* The maximum size of the color-map required by the format expressed in a
2993
+ * count of components. This can be used to compile-time allocate a
2994
+ * color-map:
2995
+ *
2996
+ * png_uint_16 colormap[PNG_IMAGE_MAXIMUM_COLORMAP_COMPONENTS(linear_fmt)];
2997
+ *
2998
+ * png_byte colormap[PNG_IMAGE_MAXIMUM_COLORMAP_COMPONENTS(sRGB_fmt)];
2999
+ *
3000
+ * Alternatively use the PNG_IMAGE_COLORMAP_SIZE macro below to use the
3001
+ * information from one of the png_image_begin_read_ APIs and dynamically
3002
+ * allocate the required memory.
3003
+ */
3004
+
3005
+ /* Corresponding information about the pixels */
3006
+ #define PNG_IMAGE_PIXEL_(test,fmt)\
3007
+ (((fmt)&PNG_FORMAT_FLAG_COLORMAP)?1:test(fmt))
3008
+
3009
+ #define PNG_IMAGE_PIXEL_CHANNELS(fmt)\
3010
+ PNG_IMAGE_PIXEL_(PNG_IMAGE_SAMPLE_CHANNELS,fmt)
3011
+ /* The number of separate channels (components) in a pixel; 1 for a
3012
+ * color-mapped image.
3013
+ */
3014
+
3015
+ #define PNG_IMAGE_PIXEL_COMPONENT_SIZE(fmt)\
3016
+ PNG_IMAGE_PIXEL_(PNG_IMAGE_SAMPLE_COMPONENT_SIZE,fmt)
3017
+ /* The size, in bytes, of each component in a pixel; 1 for a color-mapped
3018
+ * image.
3019
+ */
3020
+
3021
+ #define PNG_IMAGE_PIXEL_SIZE(fmt) PNG_IMAGE_PIXEL_(PNG_IMAGE_SAMPLE_SIZE,fmt)
3022
+ /* The size, in bytes, of a complete pixel; 1 for a color-mapped image. */
3023
+
3024
+ /* Information about the whole row, or whole image */
3025
+ #define PNG_IMAGE_ROW_STRIDE(image)\
3026
+ (PNG_IMAGE_PIXEL_CHANNELS((image).format) * (image).width)
3027
+ /* Return the total number of components in a single row of the image; this
3028
+ * is the minimum 'row stride', the minimum count of components between each
3029
+ * row. For a color-mapped image this is the minimum number of bytes in a
3030
+ * row.
3031
+ */
3032
+
3033
+ #define PNG_IMAGE_BUFFER_SIZE(image, row_stride)\
3034
+ (PNG_IMAGE_PIXEL_COMPONENT_SIZE((image).format)*(image).height*(row_stride))
3035
+ /* Return the size, in bytes, of an image buffer given a png_image and a row
3036
+ * stride - the number of components to leave space for in each row.
3037
+ */
3038
+
3039
+ #define PNG_IMAGE_SIZE(image)\
3040
+ PNG_IMAGE_BUFFER_SIZE(image, PNG_IMAGE_ROW_STRIDE(image))
3041
+ /* Return the size, in bytes, of the image in memory given just a png_image;
3042
+ * the row stride is the minimum stride required for the image.
3043
+ */
3044
+
3045
+ #define PNG_IMAGE_COLORMAP_SIZE(image)\
3046
+ (PNG_IMAGE_SAMPLE_SIZE((image).format) * (image).colormap_entries)
3047
+ /* Return the size, in bytes, of the color-map of this image. If the image
3048
+ * format is not a color-map format this will return a size sufficient for
3049
+ * 256 entries in the given format; check PNG_FORMAT_FLAG_COLORMAP if
3050
+ * you don't want to allocate a color-map in this case.
3051
+ */
3052
+
3053
+ /* PNG_IMAGE_FLAG_*
3054
+ *
3055
+ * Flags containing additional information about the image are held in the
3056
+ * 'flags' field of png_image.
3057
+ */
3058
+ #define PNG_IMAGE_FLAG_COLORSPACE_NOT_sRGB 0x01
3059
+ /* This indicates the the RGB values of the in-memory bitmap do not
3060
+ * correspond to the red, green and blue end-points defined by sRGB.
3061
+ */
3062
+
3063
+ #define PNG_IMAGE_FLAG_FAST 0x02
3064
+ /* On write emphasise speed over compression; the resultant PNG file will be
3065
+ * larger but will be produced significantly faster, particular for large
3066
+ * images. Do not use this option for images which will be distributed, only
3067
+ * used it when producing intermediate files that will be read back in
3068
+ * repeatedly. For a typical 24-bit image the option will double the read
3069
+ * speed at the cost of increasing the image size by 25%, however for many
3070
+ * more compressible images the PNG file can be 10 times larger with only a
3071
+ * slight speed gain.
3072
+ */
3073
+
3074
+ #define PNG_IMAGE_FLAG_16BIT_sRGB 0x04
3075
+ /* On read if the image is a 16-bit per component image and there is no gAMA
3076
+ * or sRGB chunk assume that the components are sRGB encoded. Notice that
3077
+ * images output by the simplified API always have gamma information; setting
3078
+ * this flag only affects the interpretation of 16-bit images from an
3079
+ * external source. It is recommended that the application expose this flag
3080
+ * to the user; the user can normally easily recognize the difference between
3081
+ * linear and sRGB encoding. This flag has no effect on write - the data
3082
+ * passed to the write APIs must have the correct encoding (as defined
3083
+ * above.)
3084
+ *
3085
+ * If the flag is not set (the default) input 16-bit per component data is
3086
+ * assumed to be linear.
3087
+ *
3088
+ * NOTE: the flag can only be set after the png_image_begin_read_ call,
3089
+ * because that call initializes the 'flags' field.
3090
+ */
3091
+
3092
+ #ifdef PNG_SIMPLIFIED_READ_SUPPORTED
3093
+ /* READ APIs
3094
+ * ---------
3095
+ *
3096
+ * The png_image passed to the read APIs must have been initialized by setting
3097
+ * the png_controlp field 'opaque' to NULL (or, safer, memset the whole thing.)
3098
+ */
3099
+ #ifdef PNG_STDIO_SUPPORTED
3100
+ PNG_EXPORT(234, int, png_image_begin_read_from_file, (png_imagep image,
3101
+ const char *file_name));
3102
+ /* The named file is opened for read and the image header is filled in
3103
+ * from the PNG header in the file.
3104
+ */
3105
+
3106
+ PNG_EXPORT(235, int, png_image_begin_read_from_stdio, (png_imagep image,
3107
+ FILE* file));
3108
+ /* The PNG header is read from the stdio FILE object. */
3109
+ #endif /* PNG_STDIO_SUPPORTED */
3110
+
3111
+ PNG_EXPORT(236, int, png_image_begin_read_from_memory, (png_imagep image,
3112
+ png_const_voidp memory, png_size_t size));
3113
+ /* The PNG header is read from the given memory buffer. */
3114
+
3115
+ PNG_EXPORT(237, int, png_image_finish_read, (png_imagep image,
3116
+ png_const_colorp background, void *buffer, png_int_32 row_stride,
3117
+ void *colormap));
3118
+ /* Finish reading the image into the supplied buffer and clean up the
3119
+ * png_image structure.
3120
+ *
3121
+ * row_stride is the step, in byte or 2-byte units as appropriate,
3122
+ * between adjacent rows. A positive stride indicates that the top-most row
3123
+ * is first in the buffer - the normal top-down arrangement. A negative
3124
+ * stride indicates that the bottom-most row is first in the buffer.
3125
+ *
3126
+ * background need only be supplied if an alpha channel must be removed from
3127
+ * a png_byte format and the removal is to be done by compositing on a solid
3128
+ * color; otherwise it may be NULL and any composition will be done directly
3129
+ * onto the buffer. The value is an sRGB color to use for the background,
3130
+ * for grayscale output the green channel is used.
3131
+ *
3132
+ * background must be supplied when an alpha channel must be removed from a
3133
+ * single byte color-mapped output format, in other words if:
3134
+ *
3135
+ * 1) The original format from png_image_begin_read_from_* had
3136
+ * PNG_FORMAT_FLAG_ALPHA set.
3137
+ * 2) The format set by the application does not.
3138
+ * 3) The format set by the application has PNG_FORMAT_FLAG_COLORMAP set and
3139
+ * PNG_FORMAT_FLAG_LINEAR *not* set.
3140
+ *
3141
+ * For linear output removing the alpha channel is always done by compositing
3142
+ * on black and background is ignored.
3143
+ *
3144
+ * colormap must be supplied when PNG_FORMAT_FLAG_COLORMAP is set. It must
3145
+ * be at least the size (in bytes) returned by PNG_IMAGE_COLORMAP_SIZE.
3146
+ * image->colormap_entries will be updated to the actual number of entries
3147
+ * written to the colormap; this may be less than the original value.
3148
+ */
3149
+
3150
+ PNG_EXPORT(238, void, png_image_free, (png_imagep image));
3151
+ /* Free any data allocated by libpng in image->opaque, setting the pointer to
3152
+ * NULL. May be called at any time after the structure is initialized.
3153
+ */
3154
+ #endif /* PNG_SIMPLIFIED_READ_SUPPORTED */
3155
+
3156
+ #ifdef PNG_SIMPLIFIED_WRITE_SUPPORTED
3157
+ #ifdef PNG_STDIO_SUPPORTED
3158
+ /* WRITE APIS
3159
+ * ----------
3160
+ * For write you must initialize a png_image structure to describe the image to
3161
+ * be written. To do this use memset to set the whole structure to 0 then
3162
+ * initialize fields describing your image.
3163
+ *
3164
+ * version: must be set to PNG_IMAGE_VERSION
3165
+ * opaque: must be initialized to NULL
3166
+ * width: image width in pixels
3167
+ * height: image height in rows
3168
+ * format: the format of the data (image and color-map) you wish to write
3169
+ * flags: set to 0 unless one of the defined flags applies; set
3170
+ * PNG_IMAGE_FLAG_COLORSPACE_NOT_sRGB for color format images where the RGB
3171
+ * values do not correspond to the colors in sRGB.
3172
+ * colormap_entries: set to the number of entries in the color-map (0 to 256)
3173
+ */
3174
+ PNG_EXPORT(239, int, png_image_write_to_file, (png_imagep image,
3175
+ const char *file, int convert_to_8bit, const void *buffer,
3176
+ png_int_32 row_stride, const void *colormap));
3177
+ /* Write the image to the named file. */
3178
+
3179
+ PNG_EXPORT(240, int, png_image_write_to_stdio, (png_imagep image, FILE *file,
3180
+ int convert_to_8_bit, const void *buffer, png_int_32 row_stride,
3181
+ const void *colormap));
3182
+ /* Write the image to the given (FILE*). */
3183
+
3184
+ /* With both write APIs if image is in one of the linear formats with 16-bit
3185
+ * data then setting convert_to_8_bit will cause the output to be an 8-bit PNG
3186
+ * gamma encoded according to the sRGB specification, otherwise a 16-bit linear
3187
+ * encoded PNG file is written.
3188
+ *
3189
+ * With color-mapped data formats the colormap parameter point to a color-map
3190
+ * with at least image->colormap_entries encoded in the specified format. If
3191
+ * the format is linear the written PNG color-map will be converted to sRGB
3192
+ * regardless of the convert_to_8_bit flag.
3193
+ *
3194
+ * With all APIs row_stride is handled as in the read APIs - it is the spacing
3195
+ * from one row to the next in component sized units (1 or 2 bytes) and if
3196
+ * negative indicates a bottom-up row layout in the buffer.
3197
+ *
3198
+ * Note that the write API does not support interlacing or sub-8-bit pixels.
3199
+ */
3200
+ #endif /* PNG_STDIO_SUPPORTED */
3201
+ #endif /* PNG_SIMPLIFIED_WRITE_SUPPORTED */
3202
+ /*******************************************************************************
3203
+ * END OF SIMPLIFIED API
3204
+ ******************************************************************************/
3205
+ #endif /* PNG_SIMPLIFIED_{READ|WRITE}_SUPPORTED */
3206
+
3207
+ #ifdef PNG_CHECK_FOR_INVALID_INDEX_SUPPORTED
3208
+ PNG_EXPORT(242, void, png_set_check_for_invalid_index,
3209
+ (png_structrp png_ptr, int allowed));
3210
+ # ifdef PNG_GET_PALETTE_MAX_SUPPORTED
3211
+ PNG_EXPORT(243, int, png_get_palette_max, (png_const_structp png_ptr,
3212
+ png_const_infop info_ptr));
3213
+ # endif
3214
+ #endif /* CHECK_FOR_INVALID_INDEX */
3215
+
3216
+ /*******************************************************************************
3217
+ * IMPLEMENTATION OPTIONS
3218
+ *******************************************************************************
3219
+ *
3220
+ * Support for arbitrary implementation-specific optimizations. The API allows
3221
+ * particular options to be turned on or off. 'Option' is the number of the
3222
+ * option and 'onoff' is 0 (off) or non-0 (on). The value returned is given
3223
+ * by the PNG_OPTION_ defines below.
3224
+ *
3225
+ * HARDWARE: normally hardware capabilites, such as the Intel SSE instructions,
3226
+ * are detected at run time, however sometimes it may be impossible
3227
+ * to do this in user mode, in which case it is necessary to discover
3228
+ * the capabilities in an OS specific way. Such capabilities are
3229
+ * listed here when libpng has support for them and must be turned
3230
+ * ON by the application if present.
3231
+ *
3232
+ * SOFTWARE: sometimes software optimizations actually result in performance
3233
+ * decrease on some architectures or systems, or with some sets of
3234
+ * PNG images. 'Software' options allow such optimizations to be
3235
+ * selected at run time.
3236
+ */
3237
+ #ifdef PNG_SET_OPTION_SUPPORTED
3238
+ #ifdef PNG_ARM_NEON_API_SUPPORTED
3239
+ # define PNG_ARM_NEON 0 /* HARDWARE: ARM Neon SIMD instructions supported */
3240
+ #endif
3241
+ #define PNG_MAXIMUM_INFLATE_WINDOW 2 /* SOFTWARE: force maximum window */
3242
+ #define PNG_SKIP_sRGB_CHECK_PROFILE 4 /* SOFTWARE: Check ICC profile for sRGB */
3243
+ #define PNG_OPTION_NEXT 6 /* Next option - numbers must be even */
3244
+
3245
+ /* Return values: NOTE: there are four values and 'off' is *not* zero */
3246
+ #define PNG_OPTION_UNSET 0 /* Unset - defaults to off */
3247
+ #define PNG_OPTION_INVALID 1 /* Option number out of range */
3248
+ #define PNG_OPTION_OFF 2
3249
+ #define PNG_OPTION_ON 3
3250
+
3251
+ PNG_EXPORT(244, int, png_set_option, (png_structrp png_ptr, int option,
3252
+ int onoff));
3253
+ #endif /* PNG_SET_OPTION_SUPPORTED */
3254
+
3255
+ /*******************************************************************************
3256
+ * END OF HARDWARE AND SOFTWARE OPTIONS
3257
+ ******************************************************************************/
3258
+
3259
+ /* Maintainer: Put new public prototypes here ^, in libpng.3, in project
3260
+ * defs, and in scripts/symbols.def.
3261
+ */
3262
+
3263
+ /* The last ordinal number (this is the *last* one already used; the next
3264
+ * one to use is one more than this.)
3265
+ */
3266
+ #ifdef PNG_EXPORT_LAST_ORDINAL
3267
+ PNG_EXPORT_LAST_ORDINAL(244);
3268
+ #endif
3269
+
3270
+ #ifdef __cplusplus
3271
+ }
3272
+ #endif
3273
+
3274
+ #endif /* PNG_VERSION_INFO_ONLY */
3275
+ /* Do not put anything past this line */
3276
+ #endif /* PNG_H */