zxing_cpp_no_cmake 0.1.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (377) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +13 -0
  3. data/.gitmodules +0 -0
  4. data/CHANGELOG.rdoc +6 -0
  5. data/Gemfile +3 -0
  6. data/Manifest.txt +375 -0
  7. data/README.rdoc +141 -0
  8. data/Rakefile +28 -0
  9. data/bin/zxd +87 -0
  10. data/bin/zxe +53 -0
  11. data/ext/zxing/extconf.rb +20 -0
  12. data/ext/zxing/zxing-cpp/.gitignore +2 -0
  13. data/ext/zxing/zxing-cpp/AUTHORS +115 -0
  14. data/ext/zxing/zxing-cpp/CMakeLists.txt +89 -0
  15. data/ext/zxing/zxing-cpp/COPYING +201 -0
  16. data/ext/zxing/zxing-cpp/NOTICE +65 -0
  17. data/ext/zxing/zxing-cpp/README.md +45 -0
  18. data/ext/zxing/zxing-cpp/build/CMakeCache.txt +382 -0
  19. data/ext/zxing/zxing-cpp/build/CMakeFiles/3.15.4/CMakeCCompiler.cmake +76 -0
  20. data/ext/zxing/zxing-cpp/build/CMakeFiles/3.15.4/CMakeCXXCompiler.cmake +79 -0
  21. data/ext/zxing/zxing-cpp/build/CMakeFiles/3.15.4/CMakeDetermineCompilerABI_C.bin +0 -0
  22. data/ext/zxing/zxing-cpp/build/CMakeFiles/3.15.4/CMakeDetermineCompilerABI_CXX.bin +0 -0
  23. data/ext/zxing/zxing-cpp/build/CMakeFiles/3.15.4/CMakeSystem.cmake +15 -0
  24. data/ext/zxing/zxing-cpp/build/CMakeFiles/3.15.4/CompilerIdC/CMakeCCompilerId.c +665 -0
  25. data/ext/zxing/zxing-cpp/build/CMakeFiles/3.15.4/CompilerIdC/a.out +0 -0
  26. data/ext/zxing/zxing-cpp/build/CMakeFiles/3.15.4/CompilerIdCXX/CMakeCXXCompilerId.cpp +644 -0
  27. data/ext/zxing/zxing-cpp/build/CMakeFiles/3.15.4/CompilerIdCXX/a.out +0 -0
  28. data/ext/zxing/zxing-cpp/build/CMakeFiles/CMakeDirectoryInformation.cmake +16 -0
  29. data/ext/zxing/zxing-cpp/build/CMakeFiles/CMakeOutput.log +447 -0
  30. data/ext/zxing/zxing-cpp/build/CMakeFiles/Makefile.cmake +125 -0
  31. data/ext/zxing/zxing-cpp/build/CMakeFiles/Makefile2 +177 -0
  32. data/ext/zxing/zxing-cpp/build/CMakeFiles/TargetDirectories.txt +9 -0
  33. data/ext/zxing/zxing-cpp/build/CMakeFiles/cmake.check_cache +1 -0
  34. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/CXX.includecache +1892 -0
  35. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/DependInfo.cmake +120 -0
  36. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/build.make +1584 -0
  37. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/cmake_clean.cmake +109 -0
  38. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/cmake_clean_target.cmake +3 -0
  39. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/depend.internal +1465 -0
  40. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/depend.make +1465 -0
  41. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/flags.make +10 -0
  42. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/link.txt +2 -0
  43. data/ext/zxing/zxing-cpp/build/CMakeFiles/libzxing.dir/progress.make +102 -0
  44. data/ext/zxing/zxing-cpp/build/CMakeFiles/progress.marks +1 -0
  45. data/ext/zxing/zxing-cpp/build/CMakeFiles/testrunner.dir/CXX.includecache +344 -0
  46. data/ext/zxing/zxing-cpp/build/CMakeFiles/testrunner.dir/DependInfo.cmake +33 -0
  47. data/ext/zxing/zxing-cpp/build/CMakeFiles/testrunner.dir/build.make +266 -0
  48. data/ext/zxing/zxing-cpp/build/CMakeFiles/testrunner.dir/cmake_clean.cmake +21 -0
  49. data/ext/zxing/zxing-cpp/build/CMakeFiles/testrunner.dir/depend.internal +103 -0
  50. data/ext/zxing/zxing-cpp/build/CMakeFiles/testrunner.dir/depend.make +103 -0
  51. data/ext/zxing/zxing-cpp/build/CMakeFiles/testrunner.dir/flags.make +10 -0
  52. data/ext/zxing/zxing-cpp/build/CMakeFiles/testrunner.dir/link.txt +1 -0
  53. data/ext/zxing/zxing-cpp/build/CMakeFiles/testrunner.dir/progress.make +14 -0
  54. data/ext/zxing/zxing-cpp/build/CMakeFiles/zxing.dir/CXX.includecache +378 -0
  55. data/ext/zxing/zxing-cpp/build/CMakeFiles/zxing.dir/DependInfo.cmake +25 -0
  56. data/ext/zxing/zxing-cpp/build/CMakeFiles/zxing.dir/build.make +145 -0
  57. data/ext/zxing/zxing-cpp/build/CMakeFiles/zxing.dir/cmake_clean.cmake +13 -0
  58. data/ext/zxing/zxing-cpp/build/CMakeFiles/zxing.dir/depend.internal +53 -0
  59. data/ext/zxing/zxing-cpp/build/CMakeFiles/zxing.dir/depend.make +53 -0
  60. data/ext/zxing/zxing-cpp/build/CMakeFiles/zxing.dir/flags.make +10 -0
  61. data/ext/zxing/zxing-cpp/build/CMakeFiles/zxing.dir/link.txt +1 -0
  62. data/ext/zxing/zxing-cpp/build/CMakeFiles/zxing.dir/progress.make +6 -0
  63. data/ext/zxing/zxing-cpp/build/Makefile +3706 -0
  64. data/ext/zxing/zxing-cpp/build/cmake_install.cmake +73 -0
  65. data/ext/zxing/zxing-cpp/build/libzxing.a +0 -0
  66. data/ext/zxing/zxing-cpp/build/testrunner +0 -0
  67. data/ext/zxing/zxing-cpp/build/zxing +0 -0
  68. data/ext/zxing/zxing-cpp/cli/src/ImageReaderSource.cpp +113 -0
  69. data/ext/zxing/zxing-cpp/cli/src/ImageReaderSource.h +40 -0
  70. data/ext/zxing/zxing-cpp/cli/src/jpgd.cpp +3174 -0
  71. data/ext/zxing/zxing-cpp/cli/src/jpgd.h +319 -0
  72. data/ext/zxing/zxing-cpp/cli/src/lodepng.cpp +6261 -0
  73. data/ext/zxing/zxing-cpp/cli/src/lodepng.h +1695 -0
  74. data/ext/zxing/zxing-cpp/cli/src/main.cpp +297 -0
  75. data/ext/zxing/zxing-cpp/cmake/FindCPPUNIT.cmake +54 -0
  76. data/ext/zxing/zxing-cpp/cmake/FindIconv.cmake +57 -0
  77. data/ext/zxing/zxing-cpp/core/src/bigint/.gitignore +6 -0
  78. data/ext/zxing/zxing-cpp/core/src/bigint/BigInteger.cc +405 -0
  79. data/ext/zxing/zxing-cpp/core/src/bigint/BigInteger.hh +215 -0
  80. data/ext/zxing/zxing-cpp/core/src/bigint/BigIntegerAlgorithms.cc +70 -0
  81. data/ext/zxing/zxing-cpp/core/src/bigint/BigIntegerAlgorithms.hh +25 -0
  82. data/ext/zxing/zxing-cpp/core/src/bigint/BigIntegerLibrary.hh +8 -0
  83. data/ext/zxing/zxing-cpp/core/src/bigint/BigIntegerUtils.cc +50 -0
  84. data/ext/zxing/zxing-cpp/core/src/bigint/BigIntegerUtils.hh +72 -0
  85. data/ext/zxing/zxing-cpp/core/src/bigint/BigUnsigned.cc +697 -0
  86. data/ext/zxing/zxing-cpp/core/src/bigint/BigUnsigned.hh +418 -0
  87. data/ext/zxing/zxing-cpp/core/src/bigint/BigUnsignedInABase.cc +125 -0
  88. data/ext/zxing/zxing-cpp/core/src/bigint/BigUnsignedInABase.hh +122 -0
  89. data/ext/zxing/zxing-cpp/core/src/bigint/ChangeLog +146 -0
  90. data/ext/zxing/zxing-cpp/core/src/bigint/Makefile +73 -0
  91. data/ext/zxing/zxing-cpp/core/src/bigint/NumberlikeArray.hh +177 -0
  92. data/ext/zxing/zxing-cpp/core/src/bigint/README +71 -0
  93. data/ext/zxing/zxing-cpp/core/src/win32/zxing/iconv.h +14 -0
  94. data/ext/zxing/zxing-cpp/core/src/win32/zxing/stdint.h +247 -0
  95. data/ext/zxing/zxing-cpp/core/src/win32/zxing/win_iconv.c +2035 -0
  96. data/ext/zxing/zxing-cpp/core/src/zxing/BarcodeFormat.cpp +40 -0
  97. data/ext/zxing/zxing-cpp/core/src/zxing/BarcodeFormat.h +60 -0
  98. data/ext/zxing/zxing-cpp/core/src/zxing/Binarizer.cpp +45 -0
  99. data/ext/zxing/zxing-cpp/core/src/zxing/Binarizer.h +50 -0
  100. data/ext/zxing/zxing-cpp/core/src/zxing/BinaryBitmap.cpp +70 -0
  101. data/ext/zxing/zxing-cpp/core/src/zxing/BinaryBitmap.h +56 -0
  102. data/ext/zxing/zxing-cpp/core/src/zxing/ChecksumException.cpp +28 -0
  103. data/ext/zxing/zxing-cpp/core/src/zxing/ChecksumException.h +34 -0
  104. data/ext/zxing/zxing-cpp/core/src/zxing/DecodeHints.cpp +142 -0
  105. data/ext/zxing/zxing-cpp/core/src/zxing/DecodeHints.h +85 -0
  106. data/ext/zxing/zxing-cpp/core/src/zxing/Exception.cpp +43 -0
  107. data/ext/zxing/zxing-cpp/core/src/zxing/Exception.h +51 -0
  108. data/ext/zxing/zxing-cpp/core/src/zxing/FormatException.cpp +41 -0
  109. data/ext/zxing/zxing-cpp/core/src/zxing/FormatException.h +37 -0
  110. data/ext/zxing/zxing-cpp/core/src/zxing/IllegalStateException.h +35 -0
  111. data/ext/zxing/zxing-cpp/core/src/zxing/InvertedLuminanceSource.cpp +68 -0
  112. data/ext/zxing/zxing-cpp/core/src/zxing/InvertedLuminanceSource.h +48 -0
  113. data/ext/zxing/zxing-cpp/core/src/zxing/LuminanceSource.cpp +86 -0
  114. data/ext/zxing/zxing-cpp/core/src/zxing/LuminanceSource.h +59 -0
  115. data/ext/zxing/zxing-cpp/core/src/zxing/MultiFormatReader.cpp +124 -0
  116. data/ext/zxing/zxing-cpp/core/src/zxing/MultiFormatReader.h +48 -0
  117. data/ext/zxing/zxing-cpp/core/src/zxing/NotFoundException.h +35 -0
  118. data/ext/zxing/zxing-cpp/core/src/zxing/Reader.cpp +31 -0
  119. data/ext/zxing/zxing-cpp/core/src/zxing/Reader.h +40 -0
  120. data/ext/zxing/zxing-cpp/core/src/zxing/ReaderException.h +37 -0
  121. data/ext/zxing/zxing-cpp/core/src/zxing/Result.cpp +61 -0
  122. data/ext/zxing/zxing-cpp/core/src/zxing/Result.h +55 -0
  123. data/ext/zxing/zxing-cpp/core/src/zxing/ResultIO.cpp +34 -0
  124. data/ext/zxing/zxing-cpp/core/src/zxing/ResultPoint.cpp +108 -0
  125. data/ext/zxing/zxing-cpp/core/src/zxing/ResultPoint.h +55 -0
  126. data/ext/zxing/zxing-cpp/core/src/zxing/ResultPointCallback.cpp +26 -0
  127. data/ext/zxing/zxing-cpp/core/src/zxing/ResultPointCallback.h +39 -0
  128. data/ext/zxing/zxing-cpp/core/src/zxing/ZXing.h +133 -0
  129. data/ext/zxing/zxing-cpp/core/src/zxing/aztec/AztecDetectorResult.cpp +54 -0
  130. data/ext/zxing/zxing-cpp/core/src/zxing/aztec/AztecDetectorResult.h +48 -0
  131. data/ext/zxing/zxing-cpp/core/src/zxing/aztec/AztecReader.cpp +68 -0
  132. data/ext/zxing/zxing-cpp/core/src/zxing/aztec/AztecReader.h +49 -0
  133. data/ext/zxing/zxing-cpp/core/src/zxing/aztec/decoder/Decoder.cpp +489 -0
  134. data/ext/zxing/zxing-cpp/core/src/zxing/aztec/decoder/Decoder.h +69 -0
  135. data/ext/zxing/zxing-cpp/core/src/zxing/aztec/detector/Detector.cpp +548 -0
  136. data/ext/zxing/zxing-cpp/core/src/zxing/aztec/detector/Detector.h +92 -0
  137. data/ext/zxing/zxing-cpp/core/src/zxing/common/Array.h +170 -0
  138. data/ext/zxing/zxing-cpp/core/src/zxing/common/BitArray.cpp +155 -0
  139. data/ext/zxing/zxing-cpp/core/src/zxing/common/BitArray.h +81 -0
  140. data/ext/zxing/zxing-cpp/core/src/zxing/common/BitArrayIO.cpp +31 -0
  141. data/ext/zxing/zxing-cpp/core/src/zxing/common/BitMatrix.cpp +143 -0
  142. data/ext/zxing/zxing-cpp/core/src/zxing/common/BitMatrix.h +91 -0
  143. data/ext/zxing/zxing-cpp/core/src/zxing/common/BitSource.cpp +76 -0
  144. data/ext/zxing/zxing-cpp/core/src/zxing/common/BitSource.h +74 -0
  145. data/ext/zxing/zxing-cpp/core/src/zxing/common/CharacterSetECI.cpp +105 -0
  146. data/ext/zxing/zxing-cpp/core/src/zxing/common/CharacterSetECI.h +53 -0
  147. data/ext/zxing/zxing-cpp/core/src/zxing/common/Counted.h +140 -0
  148. data/ext/zxing/zxing-cpp/core/src/zxing/common/DecoderResult.cpp +46 -0
  149. data/ext/zxing/zxing-cpp/core/src/zxing/common/DecoderResult.h +51 -0
  150. data/ext/zxing/zxing-cpp/core/src/zxing/common/DetectorResult.cpp +39 -0
  151. data/ext/zxing/zxing-cpp/core/src/zxing/common/DetectorResult.h +43 -0
  152. data/ext/zxing/zxing-cpp/core/src/zxing/common/GlobalHistogramBinarizer.cpp +212 -0
  153. data/ext/zxing/zxing-cpp/core/src/zxing/common/GlobalHistogramBinarizer.h +48 -0
  154. data/ext/zxing/zxing-cpp/core/src/zxing/common/GreyscaleLuminanceSource.cpp +80 -0
  155. data/ext/zxing/zxing-cpp/core/src/zxing/common/GreyscaleLuminanceSource.h +53 -0
  156. data/ext/zxing/zxing-cpp/core/src/zxing/common/GreyscaleRotatedLuminanceSource.cpp +81 -0
  157. data/ext/zxing/zxing-cpp/core/src/zxing/common/GreyscaleRotatedLuminanceSource.h +46 -0
  158. data/ext/zxing/zxing-cpp/core/src/zxing/common/GridSampler.cpp +122 -0
  159. data/ext/zxing/zxing-cpp/core/src/zxing/common/GridSampler.h +45 -0
  160. data/ext/zxing/zxing-cpp/core/src/zxing/common/HybridBinarizer.cpp +226 -0
  161. data/ext/zxing/zxing-cpp/core/src/zxing/common/HybridBinarizer.h +67 -0
  162. data/ext/zxing/zxing-cpp/core/src/zxing/common/IllegalArgumentException.cpp +27 -0
  163. data/ext/zxing/zxing-cpp/core/src/zxing/common/IllegalArgumentException.h +36 -0
  164. data/ext/zxing/zxing-cpp/core/src/zxing/common/PerspectiveTransform.cpp +107 -0
  165. data/ext/zxing/zxing-cpp/core/src/zxing/common/PerspectiveTransform.h +49 -0
  166. data/ext/zxing/zxing-cpp/core/src/zxing/common/Point.h +47 -0
  167. data/ext/zxing/zxing-cpp/core/src/zxing/common/Str.cpp +61 -0
  168. data/ext/zxing/zxing-cpp/core/src/zxing/common/Str.h +51 -0
  169. data/ext/zxing/zxing-cpp/core/src/zxing/common/StringUtils.cpp +198 -0
  170. data/ext/zxing/zxing-cpp/core/src/zxing/common/StringUtils.h +52 -0
  171. data/ext/zxing/zxing-cpp/core/src/zxing/common/detector/JavaMath.h +43 -0
  172. data/ext/zxing/zxing-cpp/core/src/zxing/common/detector/MathUtils.h +57 -0
  173. data/ext/zxing/zxing-cpp/core/src/zxing/common/detector/MonochromeRectangleDetector.cpp +175 -0
  174. data/ext/zxing/zxing-cpp/core/src/zxing/common/detector/MonochromeRectangleDetector.h +62 -0
  175. data/ext/zxing/zxing-cpp/core/src/zxing/common/detector/WhiteRectangleDetector.cpp +330 -0
  176. data/ext/zxing/zxing-cpp/core/src/zxing/common/detector/WhiteRectangleDetector.h +59 -0
  177. data/ext/zxing/zxing-cpp/core/src/zxing/common/reedsolomon/GenericGF.cpp +150 -0
  178. data/ext/zxing/zxing-cpp/core/src/zxing/common/reedsolomon/GenericGF.h +73 -0
  179. data/ext/zxing/zxing-cpp/core/src/zxing/common/reedsolomon/GenericGFPoly.cpp +218 -0
  180. data/ext/zxing/zxing-cpp/core/src/zxing/common/reedsolomon/GenericGFPoly.h +56 -0
  181. data/ext/zxing/zxing-cpp/core/src/zxing/common/reedsolomon/ReedSolomonDecoder.cpp +174 -0
  182. data/ext/zxing/zxing-cpp/core/src/zxing/common/reedsolomon/ReedSolomonDecoder.h +49 -0
  183. data/ext/zxing/zxing-cpp/core/src/zxing/common/reedsolomon/ReedSolomonException.cpp +30 -0
  184. data/ext/zxing/zxing-cpp/core/src/zxing/common/reedsolomon/ReedSolomonException.h +33 -0
  185. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/DataMatrixReader.cpp +54 -0
  186. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/DataMatrixReader.h +45 -0
  187. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/Version.cpp +199 -0
  188. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/Version.h +87 -0
  189. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/decoder/BitMatrixParser.cpp +361 -0
  190. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/decoder/BitMatrixParser.h +59 -0
  191. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/decoder/DataBlock.cpp +113 -0
  192. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/decoder/DataBlock.h +49 -0
  193. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/decoder/DecodedBitStreamParser.cpp +415 -0
  194. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/decoder/DecodedBitStreamParser.h +104 -0
  195. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/decoder/Decoder.cpp +93 -0
  196. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/decoder/Decoder.h +49 -0
  197. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/detector/CornerPoint.cpp +46 -0
  198. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/detector/CornerPoint.h +43 -0
  199. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/detector/Detector.cpp +447 -0
  200. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/detector/Detector.h +94 -0
  201. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/detector/DetectorException.cpp +23 -0
  202. data/ext/zxing/zxing-cpp/core/src/zxing/datamatrix/detector/DetectorException.h +23 -0
  203. data/ext/zxing/zxing-cpp/core/src/zxing/multi/ByQuadrantReader.cpp +75 -0
  204. data/ext/zxing/zxing-cpp/core/src/zxing/multi/ByQuadrantReader.h +42 -0
  205. data/ext/zxing/zxing-cpp/core/src/zxing/multi/GenericMultipleBarcodeReader.cpp +137 -0
  206. data/ext/zxing/zxing-cpp/core/src/zxing/multi/GenericMultipleBarcodeReader.h +51 -0
  207. data/ext/zxing/zxing-cpp/core/src/zxing/multi/MultipleBarcodeReader.cpp +29 -0
  208. data/ext/zxing/zxing-cpp/core/src/zxing/multi/MultipleBarcodeReader.h +41 -0
  209. data/ext/zxing/zxing-cpp/core/src/zxing/multi/qrcode/QRCodeMultiReader.cpp +58 -0
  210. data/ext/zxing/zxing-cpp/core/src/zxing/multi/qrcode/QRCodeMultiReader.h +36 -0
  211. data/ext/zxing/zxing-cpp/core/src/zxing/multi/qrcode/detector/MultiDetector.cpp +47 -0
  212. data/ext/zxing/zxing-cpp/core/src/zxing/multi/qrcode/detector/MultiDetector.h +37 -0
  213. data/ext/zxing/zxing-cpp/core/src/zxing/multi/qrcode/detector/MultiFinderPatternFinder.cpp +236 -0
  214. data/ext/zxing/zxing-cpp/core/src/zxing/multi/qrcode/detector/MultiFinderPatternFinder.h +47 -0
  215. data/ext/zxing/zxing-cpp/core/src/zxing/oned/CodaBarReader.cpp +340 -0
  216. data/ext/zxing/zxing-cpp/core/src/zxing/oned/CodaBarReader.h +57 -0
  217. data/ext/zxing/zxing-cpp/core/src/zxing/oned/Code128Reader.cpp +497 -0
  218. data/ext/zxing/zxing-cpp/core/src/zxing/oned/Code128Reader.h +48 -0
  219. data/ext/zxing/zxing-cpp/core/src/zxing/oned/Code39Reader.cpp +329 -0
  220. data/ext/zxing/zxing-cpp/core/src/zxing/oned/Code39Reader.h +63 -0
  221. data/ext/zxing/zxing-cpp/core/src/zxing/oned/Code93Reader.cpp +303 -0
  222. data/ext/zxing/zxing-cpp/core/src/zxing/oned/Code93Reader.h +58 -0
  223. data/ext/zxing/zxing-cpp/core/src/zxing/oned/EAN13Reader.cpp +85 -0
  224. data/ext/zxing/zxing-cpp/core/src/zxing/oned/EAN13Reader.h +49 -0
  225. data/ext/zxing/zxing-cpp/core/src/zxing/oned/EAN8Reader.cpp +65 -0
  226. data/ext/zxing/zxing-cpp/core/src/zxing/oned/EAN8Reader.h +47 -0
  227. data/ext/zxing/zxing-cpp/core/src/zxing/oned/ITFReader.cpp +337 -0
  228. data/ext/zxing/zxing-cpp/core/src/zxing/oned/ITFReader.h +54 -0
  229. data/ext/zxing/zxing-cpp/core/src/zxing/oned/MultiFormatOneDReader.cpp +96 -0
  230. data/ext/zxing/zxing-cpp/core/src/zxing/oned/MultiFormatOneDReader.h +38 -0
  231. data/ext/zxing/zxing-cpp/core/src/zxing/oned/MultiFormatUPCEANReader.cpp +110 -0
  232. data/ext/zxing/zxing-cpp/core/src/zxing/oned/MultiFormatUPCEANReader.h +41 -0
  233. data/ext/zxing/zxing-cpp/core/src/zxing/oned/OneDReader.cpp +228 -0
  234. data/ext/zxing/zxing-cpp/core/src/zxing/oned/OneDReader.h +81 -0
  235. data/ext/zxing/zxing-cpp/core/src/zxing/oned/OneDResultPoint.cpp +28 -0
  236. data/ext/zxing/zxing-cpp/core/src/zxing/oned/OneDResultPoint.h +35 -0
  237. data/ext/zxing/zxing-cpp/core/src/zxing/oned/UPCAReader.cpp +70 -0
  238. data/ext/zxing/zxing-cpp/core/src/zxing/oned/UPCAReader.h +50 -0
  239. data/ext/zxing/zxing-cpp/core/src/zxing/oned/UPCEANReader.cpp +309 -0
  240. data/ext/zxing/zxing-cpp/core/src/zxing/oned/UPCEANReader.h +88 -0
  241. data/ext/zxing/zxing-cpp/core/src/zxing/oned/UPCEReader.cpp +146 -0
  242. data/ext/zxing/zxing-cpp/core/src/zxing/oned/UPCEReader.h +47 -0
  243. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/PDF417Reader.cpp +170 -0
  244. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/PDF417Reader.h +49 -0
  245. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/BitMatrixParser.cpp +997 -0
  246. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/BitMatrixParser.h +84 -0
  247. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/DecodedBitStreamParser.cpp +563 -0
  248. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/DecodedBitStreamParser.h +84 -0
  249. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/Decoder.cpp +118 -0
  250. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/Decoder.h +62 -0
  251. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/ec/ErrorCorrection.cpp +214 -0
  252. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/ec/ErrorCorrection.h +71 -0
  253. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/ec/ModulusGF.cpp +120 -0
  254. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/ec/ModulusGF.h +72 -0
  255. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/ec/ModulusPoly.cpp +284 -0
  256. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/decoder/ec/ModulusPoly.h +68 -0
  257. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/detector/Detector.cpp +665 -0
  258. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/detector/Detector.h +106 -0
  259. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/detector/LinesSampler.cpp +715 -0
  260. data/ext/zxing/zxing-cpp/core/src/zxing/pdf417/detector/LinesSampler.h +122 -0
  261. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/ErrorCorrectionLevel.cpp +65 -0
  262. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/ErrorCorrectionLevel.h +52 -0
  263. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/FormatInformation.cpp +117 -0
  264. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/FormatInformation.h +54 -0
  265. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/QRCodeReader.cpp +52 -0
  266. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/QRCodeReader.h +48 -0
  267. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/Version.cpp +560 -0
  268. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/Version.h +85 -0
  269. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/BitMatrixParser.cpp +183 -0
  270. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/BitMatrixParser.h +56 -0
  271. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/DataBlock.cpp +118 -0
  272. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/DataBlock.h +50 -0
  273. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/DataMask.cpp +159 -0
  274. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/DataMask.h +50 -0
  275. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/DecodedBitStreamParser.cpp +428 -0
  276. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/DecodedBitStreamParser.h +72 -0
  277. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/Decoder.cpp +107 -0
  278. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/Decoder.h +46 -0
  279. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/Mode.cpp +90 -0
  280. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/decoder/Mode.h +57 -0
  281. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/AlignmentPattern.cpp +47 -0
  282. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/AlignmentPattern.h +45 -0
  283. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/AlignmentPatternFinder.cpp +208 -0
  284. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/AlignmentPatternFinder.h +68 -0
  285. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/Detector.cpp +315 -0
  286. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/Detector.h +69 -0
  287. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/FinderPattern.cpp +69 -0
  288. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/FinderPattern.h +48 -0
  289. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/FinderPatternFinder.cpp +559 -0
  290. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/FinderPatternFinder.h +76 -0
  291. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/FinderPatternInfo.cpp +41 -0
  292. data/ext/zxing/zxing-cpp/core/src/zxing/qrcode/detector/FinderPatternInfo.h +47 -0
  293. data/ext/zxing/zxing-cpp/core/tests/src/TestRunner.cpp +30 -0
  294. data/ext/zxing/zxing-cpp/core/tests/src/common/BitArrayTest.cpp +216 -0
  295. data/ext/zxing/zxing-cpp/core/tests/src/common/BitArrayTest.h +61 -0
  296. data/ext/zxing/zxing-cpp/core/tests/src/common/BitMatrixTest.cpp +106 -0
  297. data/ext/zxing/zxing-cpp/core/tests/src/common/BitMatrixTest.h +55 -0
  298. data/ext/zxing/zxing-cpp/core/tests/src/common/BitSourceTest.cpp +49 -0
  299. data/ext/zxing/zxing-cpp/core/tests/src/common/BitSourceTest.h +42 -0
  300. data/ext/zxing/zxing-cpp/core/tests/src/common/CountedTest.cpp +58 -0
  301. data/ext/zxing/zxing-cpp/core/tests/src/common/CountedTest.h +46 -0
  302. data/ext/zxing/zxing-cpp/core/tests/src/common/PerspectiveTransformTest.cpp +69 -0
  303. data/ext/zxing/zxing-cpp/core/tests/src/common/PerspectiveTransformTest.h +47 -0
  304. data/ext/zxing/zxing-cpp/core/tests/src/common/reedsolomon/ReedSolomonTest.cpp +129 -0
  305. data/ext/zxing/zxing-cpp/core/tests/src/common/reedsolomon/ReedSolomonTest.h +62 -0
  306. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/ErrorCorrectionLevelTest.cpp +47 -0
  307. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/ErrorCorrectionLevelTest.h +45 -0
  308. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/FormatInformationTest.cpp +88 -0
  309. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/FormatInformationTest.h +47 -0
  310. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/VersionTest.cpp +88 -0
  311. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/VersionTest.h +49 -0
  312. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/decoder/DataMaskTest.cpp +132 -0
  313. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/decoder/DataMaskTest.h +91 -0
  314. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/decoder/ModeTest.cpp +52 -0
  315. data/ext/zxing/zxing-cpp/core/tests/src/qrcode/decoder/ModeTest.h +47 -0
  316. data/ext/zxing/zxing.cc +224 -0
  317. data/lib/zxing.rb +50 -0
  318. data/lib/zxing/.gitignore +2 -0
  319. data/lib/zxing/aztec.rb +5 -0
  320. data/lib/zxing/aztec/aztec_reader.rb +14 -0
  321. data/lib/zxing/bad_image_exception.rb +4 -0
  322. data/lib/zxing/binarizer.rb +8 -0
  323. data/lib/zxing/binary_bitmap.rb +15 -0
  324. data/lib/zxing/checksum_exception.rb +4 -0
  325. data/lib/zxing/common.rb +7 -0
  326. data/lib/zxing/common/bit_matrix.rb +9 -0
  327. data/lib/zxing/common/hybrid_binarizer.rb +17 -0
  328. data/lib/zxing/common/illegal_argument_exception.rb +4 -0
  329. data/lib/zxing/datamatrix.rb +5 -0
  330. data/lib/zxing/datamatrix/data_matrix_reader.rb +14 -0
  331. data/lib/zxing/decodable.rb +11 -0
  332. data/lib/zxing/exception.rb +4 -0
  333. data/lib/zxing/ffi.rb +20 -0
  334. data/lib/zxing/ffi/aztec.rb +6 -0
  335. data/lib/zxing/ffi/aztec/aztec_reader.rb +9 -0
  336. data/lib/zxing/ffi/binarizer.rb +25 -0
  337. data/lib/zxing/ffi/binary_bitmap.rb +15 -0
  338. data/lib/zxing/ffi/common.rb +8 -0
  339. data/lib/zxing/ffi/common/bit_matrix.rb +12 -0
  340. data/lib/zxing/ffi/common/greyscale_luminance_source.rb +30 -0
  341. data/lib/zxing/ffi/common/hybrid_binarizer.rb +10 -0
  342. data/lib/zxing/ffi/datamatrix.rb +6 -0
  343. data/lib/zxing/ffi/datamatrix/data_matrix_reader.rb +9 -0
  344. data/lib/zxing/ffi/library.rb +102 -0
  345. data/lib/zxing/ffi/luminance_source.rb +18 -0
  346. data/lib/zxing/ffi/multi_format_reader.rb +9 -0
  347. data/lib/zxing/ffi/oned.rb +6 -0
  348. data/lib/zxing/ffi/oned/code_39_reader.rb +10 -0
  349. data/lib/zxing/ffi/qrcode.rb +8 -0
  350. data/lib/zxing/ffi/qrcode/decoder.rb +10 -0
  351. data/lib/zxing/ffi/qrcode/detector.rb +10 -0
  352. data/lib/zxing/ffi/reader.rb +58 -0
  353. data/lib/zxing/ffi/result.rb +23 -0
  354. data/lib/zxing/format_exception.rb +4 -0
  355. data/lib/zxing/illegal_argument_exception.rb +4 -0
  356. data/lib/zxing/image.rb +15 -0
  357. data/lib/zxing/luminance_source.rb +18 -0
  358. data/lib/zxing/multi_format_reader.rb +11 -0
  359. data/lib/zxing/not_found_exception.rb +4 -0
  360. data/lib/zxing/oned.rb +5 -0
  361. data/lib/zxing/oned/code_39_reader.rb +15 -0
  362. data/lib/zxing/qrcode.rb +8 -0
  363. data/lib/zxing/qrcode/decoder.rb +14 -0
  364. data/lib/zxing/qrcode/detector.rb +14 -0
  365. data/lib/zxing/qrcode/encoder.rb +8 -0
  366. data/lib/zxing/qrcode/encoder/byte_matrix.rb +18 -0
  367. data/lib/zxing/qrcode/encoder/encoder.rb +9 -0
  368. data/lib/zxing/qrcode/encoder/qrcode.rb +18 -0
  369. data/lib/zxing/reader.rb +8 -0
  370. data/lib/zxing/reader_exception.rb +4 -0
  371. data/lib/zxing/reed_solomon_exception.rb +2 -0
  372. data/lib/zxing/result.rb +18 -0
  373. data/lib/zxing/rmagick.rb +5 -0
  374. data/lib/zxing/rmagick/image.rb +109 -0
  375. data/lib/zxing/version.rb +33 -0
  376. data/zxing_cpp.gemspec +36 -0
  377. metadata +515 -0
@@ -0,0 +1,1695 @@
1
+ /*
2
+ LodePNG version 20130325
3
+
4
+ Copyright (c) 2005-2013 Lode Vandevenne
5
+
6
+ This software is provided 'as-is', without any express or implied
7
+ warranty. In no event will the authors be held liable for any damages
8
+ arising from the use of this software.
9
+
10
+ Permission is granted to anyone to use this software for any purpose,
11
+ including commercial applications, and to alter it and redistribute it
12
+ freely, subject to the following restrictions:
13
+
14
+ 1. The origin of this software must not be misrepresented; you must not
15
+ claim that you wrote the original software. If you use this software
16
+ in a product, an acknowledgment in the product documentation would be
17
+ appreciated but is not required.
18
+
19
+ 2. Altered source versions must be plainly marked as such, and must not be
20
+ misrepresented as being the original software.
21
+
22
+ 3. This notice may not be removed or altered from any source
23
+ distribution.
24
+ */
25
+
26
+ #ifndef LODEPNG_H
27
+ #define LODEPNG_H
28
+
29
+ #include <string.h> /*for size_t*/
30
+
31
+ #ifdef __cplusplus
32
+ #include <vector>
33
+ #include <string>
34
+ #endif /*__cplusplus*/
35
+
36
+ /*
37
+ The following #defines are used to create code sections. They can be disabled
38
+ to disable code sections, which can give faster compile time and smaller binary.
39
+ The "NO_COMPILE" defines are designed to be used to pass as defines to the
40
+ compiler command to disable them without modifying this header, e.g.
41
+ -DLODEPNG_NO_COMPILE_ZLIB for gcc.
42
+ */
43
+ /*deflate & zlib. If disabled, you must specify alternative zlib functions in
44
+ the custom_zlib field of the compress and decompress settings*/
45
+ #ifndef LODEPNG_NO_COMPILE_ZLIB
46
+ #define LODEPNG_COMPILE_ZLIB
47
+ #endif
48
+ /*png encoder and png decoder*/
49
+ #ifndef LODEPNG_NO_COMPILE_PNG
50
+ #define LODEPNG_COMPILE_PNG
51
+ #endif
52
+ /*deflate&zlib decoder and png decoder*/
53
+ #ifndef LODEPNG_NO_COMPILE_DECODER
54
+ #define LODEPNG_COMPILE_DECODER
55
+ #endif
56
+ /*deflate&zlib encoder and png encoder*/
57
+ #ifndef LODEPNG_NO_COMPILE_ENCODER
58
+ #define LODEPNG_COMPILE_ENCODER
59
+ #endif
60
+ /*the optional built in harddisk file loading and saving functions*/
61
+ #ifndef LODEPNG_NO_COMPILE_DISK
62
+ #define LODEPNG_COMPILE_DISK
63
+ #endif
64
+ /*support for chunks other than IHDR, IDAT, PLTE, tRNS, IEND: ancillary and unknown chunks*/
65
+ #ifndef LODEPNG_NO_COMPILE_ANCILLARY_CHUNKS
66
+ #define LODEPNG_COMPILE_ANCILLARY_CHUNKS
67
+ #endif
68
+ /*ability to convert error numerical codes to English text string*/
69
+ #ifndef LODEPNG_NO_COMPILE_ERROR_TEXT
70
+ #define LODEPNG_COMPILE_ERROR_TEXT
71
+ #endif
72
+ /*Compile the default allocators (C's free, malloc and realloc). If you disable this,
73
+ you can define the functions lodepng_free, lodepng_malloc and lodepng_realloc in your
74
+ source files with custom allocators.*/
75
+ #ifndef LODEPNG_NO_COMPILE_ALLOCATORS
76
+ #define LODEPNG_COMPILE_ALLOCATORS
77
+ #endif
78
+ /*compile the C++ version (you can disable the C++ wrapper here even when compiling for C++)*/
79
+ #ifdef __cplusplus
80
+ #ifndef LODEPNG_NO_COMPILE_CPP
81
+ #define LODEPNG_COMPILE_CPP
82
+ #endif
83
+ #endif
84
+
85
+ #ifdef LODEPNG_COMPILE_PNG
86
+ /*The PNG color types (also used for raw).*/
87
+ typedef enum LodePNGColorType
88
+ {
89
+ LCT_GREY = 0, /*greyscale: 1,2,4,8,16 bit*/
90
+ LCT_RGB = 2, /*RGB: 8,16 bit*/
91
+ LCT_PALETTE = 3, /*palette: 1,2,4,8 bit*/
92
+ LCT_GREY_ALPHA = 4, /*greyscale with alpha: 8,16 bit*/
93
+ LCT_RGBA = 6 /*RGB with alpha: 8,16 bit*/
94
+ } LodePNGColorType;
95
+
96
+ #ifdef LODEPNG_COMPILE_DECODER
97
+ /*
98
+ Converts PNG data in memory to raw pixel data.
99
+ out: Output parameter. Pointer to buffer that will contain the raw pixel data.
100
+ After decoding, its size is w * h * (bytes per pixel) bytes larger than
101
+ initially. Bytes per pixel depends on colortype and bitdepth.
102
+ Must be freed after usage with free(*out).
103
+ Note: for 16-bit per channel colors, uses big endian format like PNG does.
104
+ w: Output parameter. Pointer to width of pixel data.
105
+ h: Output parameter. Pointer to height of pixel data.
106
+ in: Memory buffer with the PNG file.
107
+ insize: size of the in buffer.
108
+ colortype: the desired color type for the raw output image. See explanation on PNG color types.
109
+ bitdepth: the desired bit depth for the raw output image. See explanation on PNG color types.
110
+ Return value: LodePNG error code (0 means no error).
111
+ */
112
+ unsigned lodepng_decode_memory(unsigned char** out, unsigned* w, unsigned* h,
113
+ const unsigned char* in, size_t insize,
114
+ LodePNGColorType colortype, unsigned bitdepth);
115
+
116
+ /*Same as lodepng_decode_memory, but always decodes to 32-bit RGBA raw image*/
117
+ unsigned lodepng_decode32(unsigned char** out, unsigned* w, unsigned* h,
118
+ const unsigned char* in, size_t insize);
119
+
120
+ /*Same as lodepng_decode_memory, but always decodes to 24-bit RGB raw image*/
121
+ unsigned lodepng_decode24(unsigned char** out, unsigned* w, unsigned* h,
122
+ const unsigned char* in, size_t insize);
123
+
124
+ #ifdef LODEPNG_COMPILE_DISK
125
+ /*
126
+ Load PNG from disk, from file with given name.
127
+ Same as the other decode functions, but instead takes a filename as input.
128
+ */
129
+ unsigned lodepng_decode_file(unsigned char** out, unsigned* w, unsigned* h,
130
+ const char* filename,
131
+ LodePNGColorType colortype, unsigned bitdepth);
132
+
133
+ /*Same as lodepng_decode_file, but always decodes to 32-bit RGBA raw image.*/
134
+ unsigned lodepng_decode32_file(unsigned char** out, unsigned* w, unsigned* h,
135
+ const char* filename);
136
+
137
+ /*Same as lodepng_decode_file, but always decodes to 24-bit RGB raw image.*/
138
+ unsigned lodepng_decode24_file(unsigned char** out, unsigned* w, unsigned* h,
139
+ const char* filename);
140
+ #endif /*LODEPNG_COMPILE_DISK*/
141
+ #endif /*LODEPNG_COMPILE_DECODER*/
142
+
143
+
144
+ #ifdef LODEPNG_COMPILE_ENCODER
145
+ /*
146
+ Converts raw pixel data into a PNG image in memory. The colortype and bitdepth
147
+ of the output PNG image cannot be chosen, they are automatically determined
148
+ by the colortype, bitdepth and content of the input pixel data.
149
+ Note: for 16-bit per channel colors, needs big endian format like PNG does.
150
+ out: Output parameter. Pointer to buffer that will contain the PNG image data.
151
+ Must be freed after usage with free(*out).
152
+ outsize: Output parameter. Pointer to the size in bytes of the out buffer.
153
+ image: The raw pixel data to encode. The size of this buffer should be
154
+ w * h * (bytes per pixel), bytes per pixel depends on colortype and bitdepth.
155
+ w: width of the raw pixel data in pixels.
156
+ h: height of the raw pixel data in pixels.
157
+ colortype: the color type of the raw input image. See explanation on PNG color types.
158
+ bitdepth: the bit depth of the raw input image. See explanation on PNG color types.
159
+ Return value: LodePNG error code (0 means no error).
160
+ */
161
+ unsigned lodepng_encode_memory(unsigned char** out, size_t* outsize,
162
+ const unsigned char* image, unsigned w, unsigned h,
163
+ LodePNGColorType colortype, unsigned bitdepth);
164
+
165
+ /*Same as lodepng_encode_memory, but always encodes from 32-bit RGBA raw image.*/
166
+ unsigned lodepng_encode32(unsigned char** out, size_t* outsize,
167
+ const unsigned char* image, unsigned w, unsigned h);
168
+
169
+ /*Same as lodepng_encode_memory, but always encodes from 24-bit RGB raw image.*/
170
+ unsigned lodepng_encode24(unsigned char** out, size_t* outsize,
171
+ const unsigned char* image, unsigned w, unsigned h);
172
+
173
+ #ifdef LODEPNG_COMPILE_DISK
174
+ /*
175
+ Converts raw pixel data into a PNG file on disk.
176
+ Same as the other encode functions, but instead takes a filename as output.
177
+ NOTE: This overwrites existing files without warning!
178
+ */
179
+ unsigned lodepng_encode_file(const char* filename,
180
+ const unsigned char* image, unsigned w, unsigned h,
181
+ LodePNGColorType colortype, unsigned bitdepth);
182
+
183
+ /*Same as lodepng_encode_file, but always encodes from 32-bit RGBA raw image.*/
184
+ unsigned lodepng_encode32_file(const char* filename,
185
+ const unsigned char* image, unsigned w, unsigned h);
186
+
187
+ /*Same as lodepng_encode_file, but always encodes from 24-bit RGB raw image.*/
188
+ unsigned lodepng_encode24_file(const char* filename,
189
+ const unsigned char* image, unsigned w, unsigned h);
190
+ #endif /*LODEPNG_COMPILE_DISK*/
191
+ #endif /*LODEPNG_COMPILE_ENCODER*/
192
+
193
+
194
+ #ifdef LODEPNG_COMPILE_CPP
195
+ namespace lodepng
196
+ {
197
+ #ifdef LODEPNG_COMPILE_DECODER
198
+ /*Same as lodepng_decode_memory, but decodes to an std::vector.*/
199
+ unsigned decode(std::vector<unsigned char>& out, unsigned& w, unsigned& h,
200
+ const unsigned char* in, size_t insize,
201
+ LodePNGColorType colortype = LCT_RGBA, unsigned bitdepth = 8);
202
+ unsigned decode(std::vector<unsigned char>& out, unsigned& w, unsigned& h,
203
+ const std::vector<unsigned char>& in,
204
+ LodePNGColorType colortype = LCT_RGBA, unsigned bitdepth = 8);
205
+ #ifdef LODEPNG_COMPILE_DISK
206
+ /*
207
+ Converts PNG file from disk to raw pixel data in memory.
208
+ Same as the other decode functions, but instead takes a filename as input.
209
+ */
210
+ unsigned decode(std::vector<unsigned char>& out, unsigned& w, unsigned& h,
211
+ const std::string& filename,
212
+ LodePNGColorType colortype = LCT_RGBA, unsigned bitdepth = 8);
213
+ #endif //LODEPNG_COMPILE_DISK
214
+ #endif //LODEPNG_COMPILE_DECODER
215
+
216
+ #ifdef LODEPNG_COMPILE_ENCODER
217
+ /*Same as lodepng_encode_memory, but encodes to an std::vector.*/
218
+ unsigned encode(std::vector<unsigned char>& out,
219
+ const unsigned char* in, unsigned w, unsigned h,
220
+ LodePNGColorType colortype = LCT_RGBA, unsigned bitdepth = 8);
221
+ unsigned encode(std::vector<unsigned char>& out,
222
+ const std::vector<unsigned char>& in, unsigned w, unsigned h,
223
+ LodePNGColorType colortype = LCT_RGBA, unsigned bitdepth = 8);
224
+ #ifdef LODEPNG_COMPILE_DISK
225
+ /*
226
+ Converts 32-bit RGBA raw pixel data into a PNG file on disk.
227
+ Same as the other encode functions, but instead takes a filename as output.
228
+ NOTE: This overwrites existing files without warning!
229
+ */
230
+ unsigned encode(const std::string& filename,
231
+ const unsigned char* in, unsigned w, unsigned h,
232
+ LodePNGColorType colortype = LCT_RGBA, unsigned bitdepth = 8);
233
+ unsigned encode(const std::string& filename,
234
+ const std::vector<unsigned char>& in, unsigned w, unsigned h,
235
+ LodePNGColorType colortype = LCT_RGBA, unsigned bitdepth = 8);
236
+ #endif //LODEPNG_COMPILE_DISK
237
+ #endif //LODEPNG_COMPILE_ENCODER
238
+ } //namespace lodepng
239
+ #endif /*LODEPNG_COMPILE_CPP*/
240
+ #endif /*LODEPNG_COMPILE_PNG*/
241
+
242
+ #ifdef LODEPNG_COMPILE_ERROR_TEXT
243
+ /*Returns an English description of the numerical error code.*/
244
+ const char* lodepng_error_text(unsigned code);
245
+ #endif /*LODEPNG_COMPILE_ERROR_TEXT*/
246
+
247
+ #ifdef LODEPNG_COMPILE_DECODER
248
+ /*Settings for zlib decompression*/
249
+ typedef struct LodePNGDecompressSettings LodePNGDecompressSettings;
250
+ struct LodePNGDecompressSettings
251
+ {
252
+ unsigned ignore_adler32; /*if 1, continue and don't give an error message if the Adler32 checksum is corrupted*/
253
+
254
+ /*use custom zlib decoder instead of built in one (default: null)*/
255
+ unsigned (*custom_zlib)(unsigned char**, size_t*,
256
+ const unsigned char*, size_t,
257
+ const LodePNGDecompressSettings*);
258
+ /*use custom deflate decoder instead of built in one (default: null)
259
+ if custom_zlib is used, custom_deflate is ignored since only the built in
260
+ zlib function will call custom_deflate*/
261
+ unsigned (*custom_inflate)(unsigned char**, size_t*,
262
+ const unsigned char*, size_t,
263
+ const LodePNGDecompressSettings*);
264
+
265
+ void* custom_context; /*optional custom settings for custom functions*/
266
+ };
267
+
268
+ extern const LodePNGDecompressSettings lodepng_default_decompress_settings;
269
+ void lodepng_decompress_settings_init(LodePNGDecompressSettings* settings);
270
+ #endif /*LODEPNG_COMPILE_DECODER*/
271
+
272
+ #ifdef LODEPNG_COMPILE_ENCODER
273
+ /*
274
+ Settings for zlib compression. Tweaking these settings tweaks the balance
275
+ between speed and compression ratio.
276
+ */
277
+ typedef struct LodePNGCompressSettings LodePNGCompressSettings;
278
+ struct LodePNGCompressSettings /*deflate = compress*/
279
+ {
280
+ /*LZ77 related settings*/
281
+ unsigned btype; /*the block type for LZ (0, 1, 2 or 3, see zlib standard). Should be 2 for proper compression.*/
282
+ unsigned use_lz77; /*whether or not to use LZ77. Should be 1 for proper compression.*/
283
+ unsigned windowsize; /*the maximum is 32768, higher gives more compression but is slower. Typical value: 2048.*/
284
+ unsigned minmatch; /*mininum lz77 length. 3 is normally best, 6 can be better for some PNGs. Default: 0*/
285
+ unsigned nicematch; /*stop searching if >= this length found. Set to 258 for best compression. Default: 128*/
286
+ unsigned lazymatching; /*use lazy matching: better compression but a bit slower. Default: true*/
287
+
288
+ /*use custom zlib encoder instead of built in one (default: null)*/
289
+ unsigned (*custom_zlib)(unsigned char**, size_t*,
290
+ const unsigned char*, size_t,
291
+ const LodePNGCompressSettings*);
292
+ /*use custom deflate encoder instead of built in one (default: null)
293
+ if custom_zlib is used, custom_deflate is ignored since only the built in
294
+ zlib function will call custom_deflate*/
295
+ unsigned (*custom_deflate)(unsigned char**, size_t*,
296
+ const unsigned char*, size_t,
297
+ const LodePNGCompressSettings*);
298
+
299
+ void* custom_context; /*optional custom settings for custom functions*/
300
+ };
301
+
302
+ extern const LodePNGCompressSettings lodepng_default_compress_settings;
303
+ void lodepng_compress_settings_init(LodePNGCompressSettings* settings);
304
+ #endif /*LODEPNG_COMPILE_ENCODER*/
305
+
306
+ #ifdef LODEPNG_COMPILE_PNG
307
+ /*
308
+ Color mode of an image. Contains all information required to decode the pixel
309
+ bits to RGBA colors. This information is the same as used in the PNG file
310
+ format, and is used both for PNG and raw image data in LodePNG.
311
+ */
312
+ typedef struct LodePNGColorMode
313
+ {
314
+ /*header (IHDR)*/
315
+ LodePNGColorType colortype; /*color type, see PNG standard or documentation further in this header file*/
316
+ unsigned bitdepth; /*bits per sample, see PNG standard or documentation further in this header file*/
317
+
318
+ /*
319
+ palette (PLTE and tRNS)
320
+
321
+ Dynamically allocated with the colors of the palette, including alpha.
322
+ When encoding a PNG, to store your colors in the palette of the LodePNGColorMode, first use
323
+ lodepng_palette_clear, then for each color use lodepng_palette_add.
324
+ If you encode an image without alpha with palette, don't forget to put value 255 in each A byte of the palette.
325
+
326
+ When decoding, by default you can ignore this palette, since LodePNG already
327
+ fills the palette colors in the pixels of the raw RGBA output.
328
+
329
+ The palette is only supported for color type 3.
330
+ */
331
+ unsigned char* palette; /*palette in RGBARGBA... order*/
332
+ size_t palettesize; /*palette size in number of colors (amount of bytes is 4 * palettesize)*/
333
+
334
+ /*
335
+ transparent color key (tRNS)
336
+
337
+ This color uses the same bit depth as the bitdepth value in this struct, which can be 1-bit to 16-bit.
338
+ For greyscale PNGs, r, g and b will all 3 be set to the same.
339
+
340
+ When decoding, by default you can ignore this information, since LodePNG sets
341
+ pixels with this key to transparent already in the raw RGBA output.
342
+
343
+ The color key is only supported for color types 0 and 2.
344
+ */
345
+ unsigned key_defined; /*is a transparent color key given? 0 = false, 1 = true*/
346
+ unsigned key_r; /*red/greyscale component of color key*/
347
+ unsigned key_g; /*green component of color key*/
348
+ unsigned key_b; /*blue component of color key*/
349
+ } LodePNGColorMode;
350
+
351
+ /*init, cleanup and copy functions to use with this struct*/
352
+ void lodepng_color_mode_init(LodePNGColorMode* info);
353
+ void lodepng_color_mode_cleanup(LodePNGColorMode* info);
354
+ /*return value is error code (0 means no error)*/
355
+ unsigned lodepng_color_mode_copy(LodePNGColorMode* dest, const LodePNGColorMode* source);
356
+
357
+ void lodepng_palette_clear(LodePNGColorMode* info);
358
+ /*add 1 color to the palette*/
359
+ unsigned lodepng_palette_add(LodePNGColorMode* info,
360
+ unsigned char r, unsigned char g, unsigned char b, unsigned char a);
361
+
362
+ /*get the total amount of bits per pixel, based on colortype and bitdepth in the struct*/
363
+ unsigned lodepng_get_bpp(const LodePNGColorMode* info);
364
+ /*get the amount of color channels used, based on colortype in the struct.
365
+ If a palette is used, it counts as 1 channel.*/
366
+ unsigned lodepng_get_channels(const LodePNGColorMode* info);
367
+ /*is it a greyscale type? (only colortype 0 or 4)*/
368
+ unsigned lodepng_is_greyscale_type(const LodePNGColorMode* info);
369
+ /*has it got an alpha channel? (only colortype 2 or 6)*/
370
+ unsigned lodepng_is_alpha_type(const LodePNGColorMode* info);
371
+ /*has it got a palette? (only colortype 3)*/
372
+ unsigned lodepng_is_palette_type(const LodePNGColorMode* info);
373
+ /*only returns true if there is a palette and there is a value in the palette with alpha < 255.
374
+ Loops through the palette to check this.*/
375
+ unsigned lodepng_has_palette_alpha(const LodePNGColorMode* info);
376
+ /*
377
+ Check if the given color info indicates the possibility of having non-opaque pixels in the PNG image.
378
+ Returns true if the image can have translucent or invisible pixels (it still be opaque if it doesn't use such pixels).
379
+ Returns false if the image can only have opaque pixels.
380
+ In detail, it returns true only if it's a color type with alpha, or has a palette with non-opaque values,
381
+ or if "key_defined" is true.
382
+ */
383
+ unsigned lodepng_can_have_alpha(const LodePNGColorMode* info);
384
+ /*Returns the byte size of a raw image buffer with given width, height and color mode*/
385
+ size_t lodepng_get_raw_size(unsigned w, unsigned h, const LodePNGColorMode* color);
386
+
387
+ #ifdef LODEPNG_COMPILE_ANCILLARY_CHUNKS
388
+ /*The information of a Time chunk in PNG.*/
389
+ typedef struct LodePNGTime
390
+ {
391
+ unsigned year; /*2 bytes used (0-65535)*/
392
+ unsigned month; /*1-12*/
393
+ unsigned day; /*1-31*/
394
+ unsigned hour; /*0-23*/
395
+ unsigned minute; /*0-59*/
396
+ unsigned second; /*0-60 (to allow for leap seconds)*/
397
+ } LodePNGTime;
398
+ #endif /*LODEPNG_COMPILE_ANCILLARY_CHUNKS*/
399
+
400
+ /*Information about the PNG image, except pixels, width and height.*/
401
+ typedef struct LodePNGInfo
402
+ {
403
+ /*header (IHDR), palette (PLTE) and transparency (tRNS) chunks*/
404
+ unsigned compression_method;/*compression method of the original file. Always 0.*/
405
+ unsigned filter_method; /*filter method of the original file*/
406
+ unsigned interlace_method; /*interlace method of the original file*/
407
+ LodePNGColorMode color; /*color type and bits, palette and transparency of the PNG file*/
408
+
409
+ #ifdef LODEPNG_COMPILE_ANCILLARY_CHUNKS
410
+ /*
411
+ suggested background color chunk (bKGD)
412
+ This color uses the same color mode as the PNG (except alpha channel), which can be 1-bit to 16-bit.
413
+
414
+ For greyscale PNGs, r, g and b will all 3 be set to the same. When encoding
415
+ the encoder writes the red one. For palette PNGs: When decoding, the RGB value
416
+ will be stored, not a palette index. But when encoding, specify the index of
417
+ the palette in background_r, the other two are then ignored.
418
+
419
+ The decoder does not use this background color to edit the color of pixels.
420
+ */
421
+ unsigned background_defined; /*is a suggested background color given?*/
422
+ unsigned background_r; /*red component of suggested background color*/
423
+ unsigned background_g; /*green component of suggested background color*/
424
+ unsigned background_b; /*blue component of suggested background color*/
425
+
426
+ /*
427
+ non-international text chunks (tEXt and zTXt)
428
+
429
+ The char** arrays each contain num strings. The actual messages are in
430
+ text_strings, while text_keys are keywords that give a short description what
431
+ the actual text represents, e.g. Title, Author, Description, or anything else.
432
+
433
+ A keyword is minimum 1 character and maximum 79 characters long. It's
434
+ discouraged to use a single line length longer than 79 characters for texts.
435
+
436
+ Don't allocate these text buffers yourself. Use the init/cleanup functions
437
+ correctly and use lodepng_add_text and lodepng_clear_text.
438
+ */
439
+ size_t text_num; /*the amount of texts in these char** buffers (there may be more texts in itext)*/
440
+ char** text_keys; /*the keyword of a text chunk (e.g. "Comment")*/
441
+ char** text_strings; /*the actual text*/
442
+
443
+ /*
444
+ international text chunks (iTXt)
445
+ Similar to the non-international text chunks, but with additional strings
446
+ "langtags" and "transkeys".
447
+ */
448
+ size_t itext_num; /*the amount of international texts in this PNG*/
449
+ char** itext_keys; /*the English keyword of the text chunk (e.g. "Comment")*/
450
+ char** itext_langtags; /*language tag for this text's language, ISO/IEC 646 string, e.g. ISO 639 language tag*/
451
+ char** itext_transkeys; /*keyword translated to the international language - UTF-8 string*/
452
+ char** itext_strings; /*the actual international text - UTF-8 string*/
453
+
454
+ /*time chunk (tIME)*/
455
+ unsigned time_defined; /*set to 1 to make the encoder generate a tIME chunk*/
456
+ LodePNGTime time;
457
+
458
+ /*phys chunk (pHYs)*/
459
+ unsigned phys_defined; /*if 0, there is no pHYs chunk and the values below are undefined, if 1 else there is one*/
460
+ unsigned phys_x; /*pixels per unit in x direction*/
461
+ unsigned phys_y; /*pixels per unit in y direction*/
462
+ unsigned phys_unit; /*may be 0 (unknown unit) or 1 (metre)*/
463
+
464
+ /*
465
+ unknown chunks
466
+ There are 3 buffers, one for each position in the PNG where unknown chunks can appear
467
+ each buffer contains all unknown chunks for that position consecutively
468
+ The 3 buffers are the unknown chunks between certain critical chunks:
469
+ 0: IHDR-PLTE, 1: PLTE-IDAT, 2: IDAT-IEND
470
+ Do not allocate or traverse this data yourself. Use the chunk traversing functions declared
471
+ later, such as lodepng_chunk_next and lodepng_chunk_append, to read/write this struct.
472
+ */
473
+ unsigned char* unknown_chunks_data[3];
474
+ size_t unknown_chunks_size[3]; /*size in bytes of the unknown chunks, given for protection*/
475
+ #endif /*LODEPNG_COMPILE_ANCILLARY_CHUNKS*/
476
+ } LodePNGInfo;
477
+
478
+ /*init, cleanup and copy functions to use with this struct*/
479
+ void lodepng_info_init(LodePNGInfo* info);
480
+ void lodepng_info_cleanup(LodePNGInfo* info);
481
+ /*return value is error code (0 means no error)*/
482
+ unsigned lodepng_info_copy(LodePNGInfo* dest, const LodePNGInfo* source);
483
+
484
+ #ifdef LODEPNG_COMPILE_ANCILLARY_CHUNKS
485
+ void lodepng_clear_text(LodePNGInfo* info); /*use this to clear the texts again after you filled them in*/
486
+ unsigned lodepng_add_text(LodePNGInfo* info, const char* key, const char* str); /*push back both texts at once*/
487
+
488
+ void lodepng_clear_itext(LodePNGInfo* info); /*use this to clear the itexts again after you filled them in*/
489
+ unsigned lodepng_add_itext(LodePNGInfo* info, const char* key, const char* langtag,
490
+ const char* transkey, const char* str); /*push back the 4 texts of 1 chunk at once*/
491
+ #endif /*LODEPNG_COMPILE_ANCILLARY_CHUNKS*/
492
+
493
+ /*
494
+ Converts raw buffer from one color type to another color type, based on
495
+ LodePNGColorMode structs to describe the input and output color type.
496
+ See the reference manual at the end of this header file to see which color conversions are supported.
497
+ return value = LodePNG error code (0 if all went ok, an error if the conversion isn't supported)
498
+ The out buffer must have size (w * h * bpp + 7) / 8, where bpp is the bits per pixel
499
+ of the output color type (lodepng_get_bpp)
500
+ The fix_png value makes it ignore out of bound palette indices.
501
+ Note: for 16-bit per channel colors, uses big endian format like PNG does.
502
+ */
503
+ unsigned lodepng_convert(unsigned char* out, const unsigned char* in,
504
+ LodePNGColorMode* mode_out, LodePNGColorMode* mode_in,
505
+ unsigned w, unsigned h, unsigned fix_png);
506
+
507
+
508
+ #ifdef LODEPNG_COMPILE_DECODER
509
+ /*
510
+ Settings for the decoder. This contains settings for the PNG and the Zlib
511
+ decoder, but not the Info settings from the Info structs.
512
+ */
513
+ typedef struct LodePNGDecoderSettings
514
+ {
515
+ LodePNGDecompressSettings zlibsettings; /*in here is the setting to ignore Adler32 checksums*/
516
+
517
+ unsigned ignore_crc; /*ignore CRC checksums*/
518
+ unsigned fix_png; /*if 1, try to parse some broken PNG images, e.g. with out of bound palette.*/
519
+ unsigned color_convert; /*whether to convert the PNG to the color type you want. Default: yes*/
520
+
521
+ #ifdef LODEPNG_COMPILE_ANCILLARY_CHUNKS
522
+ unsigned read_text_chunks; /*if false but remember_unknown_chunks is true, they're stored in the unknown chunks*/
523
+ /*store all bytes from unknown chunks in the LodePNGInfo (off by default, useful for a png editor)*/
524
+ unsigned remember_unknown_chunks;
525
+ #endif /*LODEPNG_COMPILE_ANCILLARY_CHUNKS*/
526
+ } LodePNGDecoderSettings;
527
+
528
+ void lodepng_decoder_settings_init(LodePNGDecoderSettings* settings);
529
+ #endif /*LODEPNG_COMPILE_DECODER*/
530
+
531
+ #ifdef LODEPNG_COMPILE_ENCODER
532
+ /*automatically use color type with less bits per pixel if losslessly possible. Default: AUTO*/
533
+ typedef enum LodePNGFilterStrategy
534
+ {
535
+ /*every filter at zero*/
536
+ LFS_ZERO,
537
+ /*Use filter that gives minumum sum, as described in the official PNG filter heuristic.*/
538
+ LFS_MINSUM,
539
+ /*Use the filter type that gives smallest Shannon entropy for this scanline. Depending
540
+ on the image, this is better or worse than minsum.*/
541
+ LFS_ENTROPY,
542
+ /*
543
+ Brute-force-search PNG filters by compressing each filter for each scanline.
544
+ Experimental, very slow, and only rarely gives better compression than MINSUM.
545
+ */
546
+ LFS_BRUTE_FORCE,
547
+ /*use predefined_filters buffer: you specify the filter type for each scanline*/
548
+ LFS_PREDEFINED
549
+ } LodePNGFilterStrategy;
550
+
551
+ /*automatically use color type with less bits per pixel if losslessly possible. Default: LAC_AUTO*/
552
+ typedef enum LodePNGAutoConvert
553
+ {
554
+ LAC_NO, /*use color type user requested*/
555
+ LAC_ALPHA, /*use color type user requested, but if only opaque pixels and RGBA or grey+alpha, use RGB or grey*/
556
+ LAC_AUTO, /*use PNG color type that can losslessly represent the uncompressed image the smallest possible*/
557
+ /*
558
+ like AUTO, but do not choose 1, 2 or 4 bit per pixel types.
559
+ sometimes a PNG image compresses worse if less than 8 bits per pixels.
560
+ */
561
+ LAC_AUTO_NO_NIBBLES,
562
+ /*
563
+ like AUTO, but never choose palette color type. For small images, encoding
564
+ the palette may take more bytes than what is gained. Note that AUTO also
565
+ already prevents encoding the palette for extremely small images, but that may
566
+ not be sufficient because due to the compression it cannot predict when to
567
+ switch.
568
+ */
569
+ LAC_AUTO_NO_PALETTE,
570
+ LAC_AUTO_NO_NIBBLES_NO_PALETTE
571
+ } LodePNGAutoConvert;
572
+
573
+
574
+ /*Settings for the encoder.*/
575
+ typedef struct LodePNGEncoderSettings
576
+ {
577
+ LodePNGCompressSettings zlibsettings; /*settings for the zlib encoder, such as window size, ...*/
578
+
579
+ LodePNGAutoConvert auto_convert; /*how to automatically choose output PNG color type, if at all*/
580
+
581
+ /*If true, follows the official PNG heuristic: if the PNG uses a palette or lower than
582
+ 8 bit depth, set all filters to zero. Otherwise use the filter_strategy. Note that to
583
+ completely follow the official PNG heuristic, filter_palette_zero must be true and
584
+ filter_strategy must be LFS_MINSUM*/
585
+ unsigned filter_palette_zero;
586
+ /*Which filter strategy to use when not using zeroes due to filter_palette_zero.
587
+ Set filter_palette_zero to 0 to ensure always using your chosen strategy. Default: LFS_MINSUM*/
588
+ LodePNGFilterStrategy filter_strategy;
589
+ /*used if filter_strategy is LFS_PREDEFINED. In that case, this must point to a buffer with
590
+ the same length as the amount of scanlines in the image, and each value must <= 5. You
591
+ have to cleanup this buffer, LodePNG will never free it. Don't forget that filter_palette_zero
592
+ must be set to 0 to ensure this is also used on palette or low bitdepth images.*/
593
+ unsigned char* predefined_filters;
594
+
595
+ /*force creating a PLTE chunk if colortype is 2 or 6 (= a suggested palette).
596
+ If colortype is 3, PLTE is _always_ created.*/
597
+ unsigned force_palette;
598
+ #ifdef LODEPNG_COMPILE_ANCILLARY_CHUNKS
599
+ /*add LodePNG identifier and version as a text chunk, for debugging*/
600
+ unsigned add_id;
601
+ /*encode text chunks as zTXt chunks instead of tEXt chunks, and use compression in iTXt chunks*/
602
+ unsigned text_compression;
603
+ #endif /*LODEPNG_COMPILE_ANCILLARY_CHUNKS*/
604
+ } LodePNGEncoderSettings;
605
+
606
+ void lodepng_encoder_settings_init(LodePNGEncoderSettings* settings);
607
+ #endif /*LODEPNG_COMPILE_ENCODER*/
608
+
609
+
610
+ #if defined(LODEPNG_COMPILE_DECODER) || defined(LODEPNG_COMPILE_ENCODER)
611
+ /*The settings, state and information for extended encoding and decoding.*/
612
+ typedef struct LodePNGState
613
+ {
614
+ #ifdef LODEPNG_COMPILE_DECODER
615
+ LodePNGDecoderSettings decoder; /*the decoding settings*/
616
+ #endif /*LODEPNG_COMPILE_DECODER*/
617
+ #ifdef LODEPNG_COMPILE_ENCODER
618
+ LodePNGEncoderSettings encoder; /*the encoding settings*/
619
+ #endif /*LODEPNG_COMPILE_ENCODER*/
620
+ LodePNGColorMode info_raw; /*specifies the format in which you would like to get the raw pixel buffer*/
621
+ LodePNGInfo info_png; /*info of the PNG image obtained after decoding*/
622
+ unsigned error;
623
+ #ifdef LODEPNG_COMPILE_CPP
624
+ //For the lodepng::State subclass.
625
+ virtual ~LodePNGState(){}
626
+ #endif
627
+ } LodePNGState;
628
+
629
+ /*init, cleanup and copy functions to use with this struct*/
630
+ void lodepng_state_init(LodePNGState* state);
631
+ void lodepng_state_cleanup(LodePNGState* state);
632
+ void lodepng_state_copy(LodePNGState* dest, const LodePNGState* source);
633
+ #endif /* defined(LODEPNG_COMPILE_DECODER) || defined(LODEPNG_COMPILE_ENCODER) */
634
+
635
+ #ifdef LODEPNG_COMPILE_DECODER
636
+ /*
637
+ Same as lodepng_decode_memory, but uses a LodePNGState to allow custom settings and
638
+ getting much more information about the PNG image and color mode.
639
+ */
640
+ unsigned lodepng_decode(unsigned char** out, unsigned* w, unsigned* h,
641
+ LodePNGState* state,
642
+ const unsigned char* in, size_t insize);
643
+
644
+ /*
645
+ Read the PNG header, but not the actual data. This returns only the information
646
+ that is in the header chunk of the PNG, such as width, height and color type. The
647
+ information is placed in the info_png field of the LodePNGState.
648
+ */
649
+ unsigned lodepng_inspect(unsigned* w, unsigned* h,
650
+ LodePNGState* state,
651
+ const unsigned char* in, size_t insize);
652
+ #endif /*LODEPNG_COMPILE_DECODER*/
653
+
654
+
655
+ #ifdef LODEPNG_COMPILE_ENCODER
656
+ /*This function allocates the out buffer with standard malloc and stores the size in *outsize.*/
657
+ unsigned lodepng_encode(unsigned char** out, size_t* outsize,
658
+ const unsigned char* image, unsigned w, unsigned h,
659
+ LodePNGState* state);
660
+ #endif /*LODEPNG_COMPILE_ENCODER*/
661
+
662
+ /*
663
+ The lodepng_chunk functions are normally not needed, except to traverse the
664
+ unknown chunks stored in the LodePNGInfo struct, or add new ones to it.
665
+ It also allows traversing the chunks of an encoded PNG file yourself.
666
+
667
+ PNG standard chunk naming conventions:
668
+ First byte: uppercase = critical, lowercase = ancillary
669
+ Second byte: uppercase = public, lowercase = private
670
+ Third byte: must be uppercase
671
+ Fourth byte: uppercase = unsafe to copy, lowercase = safe to copy
672
+ */
673
+
674
+ /*get the length of the data of the chunk. Total chunk length has 12 bytes more.*/
675
+ unsigned lodepng_chunk_length(const unsigned char* chunk);
676
+
677
+ /*puts the 4-byte type in null terminated string*/
678
+ void lodepng_chunk_type(char type[5], const unsigned char* chunk);
679
+
680
+ /*check if the type is the given type*/
681
+ unsigned char lodepng_chunk_type_equals(const unsigned char* chunk, const char* type);
682
+
683
+ /*0: it's one of the critical chunk types, 1: it's an ancillary chunk (see PNG standard)*/
684
+ unsigned char lodepng_chunk_ancillary(const unsigned char* chunk);
685
+
686
+ /*0: public, 1: private (see PNG standard)*/
687
+ unsigned char lodepng_chunk_private(const unsigned char* chunk);
688
+
689
+ /*0: the chunk is unsafe to copy, 1: the chunk is safe to copy (see PNG standard)*/
690
+ unsigned char lodepng_chunk_safetocopy(const unsigned char* chunk);
691
+
692
+ /*get pointer to the data of the chunk, where the input points to the header of the chunk*/
693
+ unsigned char* lodepng_chunk_data(unsigned char* chunk);
694
+ const unsigned char* lodepng_chunk_data_const(const unsigned char* chunk);
695
+
696
+ /*returns 0 if the crc is correct, 1 if it's incorrect (0 for OK as usual!)*/
697
+ unsigned lodepng_chunk_check_crc(const unsigned char* chunk);
698
+
699
+ /*generates the correct CRC from the data and puts it in the last 4 bytes of the chunk*/
700
+ void lodepng_chunk_generate_crc(unsigned char* chunk);
701
+
702
+ /*iterate to next chunks. don't use on IEND chunk, as there is no next chunk then*/
703
+ unsigned char* lodepng_chunk_next(unsigned char* chunk);
704
+ const unsigned char* lodepng_chunk_next_const(const unsigned char* chunk);
705
+
706
+ /*
707
+ Appends chunk to the data in out. The given chunk should already have its chunk header.
708
+ The out variable and outlength are updated to reflect the new reallocated buffer.
709
+ Returns error code (0 if it went ok)
710
+ */
711
+ unsigned lodepng_chunk_append(unsigned char** out, size_t* outlength, const unsigned char* chunk);
712
+
713
+ /*
714
+ Appends new chunk to out. The chunk to append is given by giving its length, type
715
+ and data separately. The type is a 4-letter string.
716
+ The out variable and outlength are updated to reflect the new reallocated buffer.
717
+ Returne error code (0 if it went ok)
718
+ */
719
+ unsigned lodepng_chunk_create(unsigned char** out, size_t* outlength, unsigned length,
720
+ const char* type, const unsigned char* data);
721
+
722
+
723
+ /*Calculate CRC32 of buffer*/
724
+ unsigned lodepng_crc32(const unsigned char* buf, size_t len);
725
+ #endif /*LODEPNG_COMPILE_PNG*/
726
+
727
+
728
+ #ifdef LODEPNG_COMPILE_ZLIB
729
+ /*
730
+ This zlib part can be used independently to zlib compress and decompress a
731
+ buffer. It cannot be used to create gzip files however, and it only supports the
732
+ part of zlib that is required for PNG, it does not support dictionaries.
733
+ */
734
+
735
+ #ifdef LODEPNG_COMPILE_DECODER
736
+ /*Inflate a buffer. Inflate is the decompression step of deflate. Out buffer must be freed after use.*/
737
+ unsigned lodepng_inflate(unsigned char** out, size_t* outsize,
738
+ const unsigned char* in, size_t insize,
739
+ const LodePNGDecompressSettings* settings);
740
+
741
+ /*
742
+ Decompresses Zlib data. Reallocates the out buffer and appends the data. The
743
+ data must be according to the zlib specification.
744
+ Either, *out must be NULL and *outsize must be 0, or, *out must be a valid
745
+ buffer and *outsize its size in bytes. out must be freed by user after usage.
746
+ */
747
+ unsigned lodepng_zlib_decompress(unsigned char** out, size_t* outsize,
748
+ const unsigned char* in, size_t insize,
749
+ const LodePNGDecompressSettings* settings);
750
+ #endif /*LODEPNG_COMPILE_DECODER*/
751
+
752
+ #ifdef LODEPNG_COMPILE_ENCODER
753
+ /*
754
+ Compresses data with Zlib. Reallocates the out buffer and appends the data.
755
+ Zlib adds a small header and trailer around the deflate data.
756
+ The data is output in the format of the zlib specification.
757
+ Either, *out must be NULL and *outsize must be 0, or, *out must be a valid
758
+ buffer and *outsize its size in bytes. out must be freed by user after usage.
759
+ */
760
+ unsigned lodepng_zlib_compress(unsigned char** out, size_t* outsize,
761
+ const unsigned char* in, size_t insize,
762
+ const LodePNGCompressSettings* settings);
763
+
764
+ /*
765
+ Find length-limited Huffman code for given frequencies. This function is in the
766
+ public interface only for tests, it's used internally by lodepng_deflate.
767
+ */
768
+ unsigned lodepng_huffman_code_lengths(unsigned* lengths, const unsigned* frequencies,
769
+ size_t numcodes, unsigned maxbitlen);
770
+
771
+ /*Compress a buffer with deflate. See RFC 1951. Out buffer must be freed after use.*/
772
+ unsigned lodepng_deflate(unsigned char** out, size_t* outsize,
773
+ const unsigned char* in, size_t insize,
774
+ const LodePNGCompressSettings* settings);
775
+
776
+ #endif /*LODEPNG_COMPILE_ENCODER*/
777
+ #endif /*LODEPNG_COMPILE_ZLIB*/
778
+
779
+ #ifdef LODEPNG_COMPILE_DISK
780
+ /*
781
+ Load a file from disk into buffer. The function allocates the out buffer, and
782
+ after usage you should free it.
783
+ out: output parameter, contains pointer to loaded buffer.
784
+ outsize: output parameter, size of the allocated out buffer
785
+ filename: the path to the file to load
786
+ return value: error code (0 means ok)
787
+ */
788
+ unsigned lodepng_load_file(unsigned char** out, size_t* outsize, const char* filename);
789
+
790
+ /*
791
+ Save a file from buffer to disk. Warning, if it exists, this function overwrites
792
+ the file without warning!
793
+ buffer: the buffer to write
794
+ buffersize: size of the buffer to write
795
+ filename: the path to the file to save to
796
+ return value: error code (0 means ok)
797
+ */
798
+ unsigned lodepng_save_file(const unsigned char* buffer, size_t buffersize, const char* filename);
799
+ #endif /*LODEPNG_COMPILE_DISK*/
800
+
801
+ #ifdef LODEPNG_COMPILE_CPP
802
+ //The LodePNG C++ wrapper uses std::vectors instead of manually allocated memory buffers.
803
+ namespace lodepng
804
+ {
805
+ #ifdef LODEPNG_COMPILE_PNG
806
+ class State : public LodePNGState
807
+ {
808
+ public:
809
+ State();
810
+ State(const State& other);
811
+ virtual ~State();
812
+ State& operator=(const State& other);
813
+ };
814
+
815
+ #ifdef LODEPNG_COMPILE_DECODER
816
+ //Same as other lodepng::decode, but using a State for more settings and information.
817
+ unsigned decode(std::vector<unsigned char>& out, unsigned& w, unsigned& h,
818
+ State& state,
819
+ const unsigned char* in, size_t insize);
820
+ unsigned decode(std::vector<unsigned char>& out, unsigned& w, unsigned& h,
821
+ State& state,
822
+ const std::vector<unsigned char>& in);
823
+ #endif /*LODEPNG_COMPILE_DECODER*/
824
+
825
+ #ifdef LODEPNG_COMPILE_ENCODER
826
+ //Same as other lodepng::encode, but using a State for more settings and information.
827
+ unsigned encode(std::vector<unsigned char>& out,
828
+ const unsigned char* in, unsigned w, unsigned h,
829
+ State& state);
830
+ unsigned encode(std::vector<unsigned char>& out,
831
+ const std::vector<unsigned char>& in, unsigned w, unsigned h,
832
+ State& state);
833
+ #endif /*LODEPNG_COMPILE_ENCODER*/
834
+
835
+ #ifdef LODEPNG_COMPILE_DISK
836
+ /*
837
+ Load a file from disk into an std::vector. If the vector is empty, then either
838
+ the file doesn't exist or is an empty file.
839
+ */
840
+ void load_file(std::vector<unsigned char>& buffer, const std::string& filename);
841
+
842
+ /*
843
+ Save the binary data in an std::vector to a file on disk. The file is overwritten
844
+ without warning.
845
+ */
846
+ void save_file(const std::vector<unsigned char>& buffer, const std::string& filename);
847
+ #endif //LODEPNG_COMPILE_DISK
848
+ #endif //LODEPNG_COMPILE_PNG
849
+
850
+ #ifdef LODEPNG_COMPILE_ZLIB
851
+ #ifdef LODEPNG_COMPILE_DECODER
852
+ //Zlib-decompress an unsigned char buffer
853
+ unsigned decompress(std::vector<unsigned char>& out, const unsigned char* in, size_t insize,
854
+ const LodePNGDecompressSettings& settings = lodepng_default_decompress_settings);
855
+
856
+ //Zlib-decompress an std::vector
857
+ unsigned decompress(std::vector<unsigned char>& out, const std::vector<unsigned char>& in,
858
+ const LodePNGDecompressSettings& settings = lodepng_default_decompress_settings);
859
+ #endif //LODEPNG_COMPILE_DECODER
860
+
861
+ #ifdef LODEPNG_COMPILE_ENCODER
862
+ //Zlib-compress an unsigned char buffer
863
+ unsigned compress(std::vector<unsigned char>& out, const unsigned char* in, size_t insize,
864
+ const LodePNGCompressSettings& settings = lodepng_default_compress_settings);
865
+
866
+ //Zlib-compress an std::vector
867
+ unsigned compress(std::vector<unsigned char>& out, const std::vector<unsigned char>& in,
868
+ const LodePNGCompressSettings& settings = lodepng_default_compress_settings);
869
+ #endif //LODEPNG_COMPILE_ENCODER
870
+ #endif //LODEPNG_COMPILE_ZLIB
871
+ } //namespace lodepng
872
+ #endif /*LODEPNG_COMPILE_CPP*/
873
+
874
+ /*
875
+ TODO:
876
+ [.] test if there are no memory leaks or security exploits - done a lot but needs to be checked often
877
+ [.] check compatibility with vareous compilers - done but needs to be redone for every newer version
878
+ [X] converting color to 16-bit per channel types
879
+ [ ] read all public PNG chunk types (but never let the color profile and gamma ones touch RGB values)
880
+ [ ] make sure encoder generates no chunks with size > (2^31)-1
881
+ [ ] partial decoding (stream processing)
882
+ [X] let the "isFullyOpaque" function check color keys and transparent palettes too
883
+ [X] better name for the variables "codes", "codesD", "codelengthcodes", "clcl" and "lldl"
884
+ [ ] don't stop decoding on errors like 69, 57, 58 (make warnings)
885
+ [ ] make option to choose if the raw image with non multiple of 8 bits per scanline should have padding bits or not
886
+ [ ] let the C++ wrapper catch exceptions coming from the standard library and return LodePNG error codes
887
+ */
888
+
889
+ #endif /*LODEPNG_H inclusion guard*/
890
+
891
+ /*
892
+ LodePNG Documentation
893
+ ---------------------
894
+
895
+ 0. table of contents
896
+ --------------------
897
+
898
+ 1. about
899
+ 1.1. supported features
900
+ 1.2. features not supported
901
+ 2. C and C++ version
902
+ 3. security
903
+ 4. decoding
904
+ 5. encoding
905
+ 6. color conversions
906
+ 6.1. PNG color types
907
+ 6.2. color conversions
908
+ 6.3. padding bits
909
+ 6.4. A note about 16-bits per channel and endianness
910
+ 7. error values
911
+ 8. chunks and PNG editing
912
+ 9. compiler support
913
+ 10. examples
914
+ 10.1. decoder C++ example
915
+ 10.2. decoder C example
916
+ 11. changes
917
+ 12. contact information
918
+
919
+
920
+ 1. about
921
+ --------
922
+
923
+ PNG is a file format to store raster images losslessly with good compression,
924
+ supporting different color types and alpha channel.
925
+
926
+ LodePNG is a PNG codec according to the Portable Network Graphics (PNG)
927
+ Specification (Second Edition) - W3C Recommendation 10 November 2003.
928
+
929
+ The specifications used are:
930
+
931
+ *) Portable Network Graphics (PNG) Specification (Second Edition):
932
+ http://www.w3.org/TR/2003/REC-PNG-20031110
933
+ *) RFC 1950 ZLIB Compressed Data Format version 3.3:
934
+ http://www.gzip.org/zlib/rfc-zlib.html
935
+ *) RFC 1951 DEFLATE Compressed Data Format Specification ver 1.3:
936
+ http://www.gzip.org/zlib/rfc-deflate.html
937
+
938
+ The most recent version of LodePNG can currently be found at
939
+ http://lodev.org/lodepng/
940
+
941
+ LodePNG works both in C (ISO C90) and C++, with a C++ wrapper that adds
942
+ extra functionality.
943
+
944
+ LodePNG exists out of two files:
945
+ -lodepng.h: the header file for both C and C++
946
+ -lodepng.c(pp): give it the name lodepng.c or lodepng.cpp (or .cc) depending on your usage
947
+
948
+ If you want to start using LodePNG right away without reading this doc, get the
949
+ examples from the LodePNG website to see how to use it in code, or check the
950
+ smaller examples in chapter 13 here.
951
+
952
+ LodePNG is simple but only supports the basic requirements. To achieve
953
+ simplicity, the following design choices were made: There are no dependencies
954
+ on any external library. There are functions to decode and encode a PNG with
955
+ a single function call, and extended versions of these functions taking a
956
+ LodePNGState struct allowing to specify or get more information. By default
957
+ the colors of the raw image are always RGB or RGBA, no matter what color type
958
+ the PNG file uses. To read and write files, there are simple functions to
959
+ convert the files to/from buffers in memory.
960
+
961
+ This all makes LodePNG suitable for loading textures in games, demos and small
962
+ programs, ... It's less suitable for full fledged image editors, loading PNGs
963
+ over network (it requires all the image data to be available before decoding can
964
+ begin), life-critical systems, ...
965
+
966
+ 1.1. supported features
967
+ -----------------------
968
+
969
+ The following features are supported by the decoder:
970
+
971
+ *) decoding of PNGs with any color type, bit depth and interlace mode, to a 24- or 32-bit color raw image,
972
+ or the same color type as the PNG
973
+ *) encoding of PNGs, from any raw image to 24- or 32-bit color, or the same color type as the raw image
974
+ *) Adam7 interlace and deinterlace for any color type
975
+ *) loading the image from harddisk or decoding it from a buffer from other sources than harddisk
976
+ *) support for alpha channels, including RGBA color model, translucent palettes and color keying
977
+ *) zlib decompression (inflate)
978
+ *) zlib compression (deflate)
979
+ *) CRC32 and ADLER32 checksums
980
+ *) handling of unknown chunks, allowing making a PNG editor that stores custom and unknown chunks.
981
+ *) the following chunks are supported (generated/interpreted) by both encoder and decoder:
982
+ IHDR: header information
983
+ PLTE: color palette
984
+ IDAT: pixel data
985
+ IEND: the final chunk
986
+ tRNS: transparency for palettized images
987
+ tEXt: textual information
988
+ zTXt: compressed textual information
989
+ iTXt: international textual information
990
+ bKGD: suggested background color
991
+ pHYs: physical dimensions
992
+ tIME: modification time
993
+
994
+ 1.2. features not supported
995
+ ---------------------------
996
+
997
+ The following features are _not_ supported:
998
+
999
+ *) some features needed to make a conformant PNG-Editor might be still missing.
1000
+ *) partial loading/stream processing. All data must be available and is processed in one call.
1001
+ *) The following public chunks are not supported but treated as unknown chunks by LodePNG
1002
+ cHRM, gAMA, iCCP, sRGB, sBIT, hIST, sPLT
1003
+ Some of these are not supported on purpose: LodePNG wants to provide the RGB values
1004
+ stored in the pixels, not values modified by system dependent gamma or color models.
1005
+
1006
+
1007
+ 2. C and C++ version
1008
+ --------------------
1009
+
1010
+ The C version uses buffers allocated with alloc that you need to free()
1011
+ yourself. You need to use init and cleanup functions for each struct whenever
1012
+ using a struct from the C version to avoid exploits and memory leaks.
1013
+
1014
+ The C++ version has extra functions with std::vectors in the interface and the
1015
+ lodepng::State class which is a LodePNGState with constructor and destructor.
1016
+
1017
+ These files work without modification for both C and C++ compilers because all
1018
+ the additional C++ code is in "#ifdef __cplusplus" blocks that make C-compilers
1019
+ ignore it, and the C code is made to compile both with strict ISO C90 and C++.
1020
+
1021
+ To use the C++ version, you need to rename the source file to lodepng.cpp
1022
+ (instead of lodepng.c), and compile it with a C++ compiler.
1023
+
1024
+ To use the C version, you need to rename the source file to lodepng.c (instead
1025
+ of lodepng.cpp), and compile it with a C compiler.
1026
+
1027
+
1028
+ 3. Security
1029
+ -----------
1030
+
1031
+ Even if carefully designed, it's always possible that LodePNG contains possible
1032
+ exploits. If you discover one, please let me know, and it will be fixed.
1033
+
1034
+ When using LodePNG, care has to be taken with the C version of LodePNG, as well
1035
+ as the C-style structs when working with C++. The following conventions are used
1036
+ for all C-style structs:
1037
+
1038
+ -if a struct has a corresponding init function, always call the init function when making a new one
1039
+ -if a struct has a corresponding cleanup function, call it before the struct disappears to avoid memory leaks
1040
+ -if a struct has a corresponding copy function, use the copy function instead of "=".
1041
+ The destination must also be inited already.
1042
+
1043
+
1044
+ 4. Decoding
1045
+ -----------
1046
+
1047
+ Decoding converts a PNG compressed image to a raw pixel buffer.
1048
+
1049
+ Most documentation on using the decoder is at its declarations in the header
1050
+ above. For C, simple decoding can be done with functions such as
1051
+ lodepng_decode32, and more advanced decoding can be done with the struct
1052
+ LodePNGState and lodepng_decode. For C++, all decoding can be done with the
1053
+ various lodepng::decode functions, and lodepng::State can be used for advanced
1054
+ features.
1055
+
1056
+ When using the LodePNGState, it uses the following fields for decoding:
1057
+ *) LodePNGInfo info_png: it stores extra information about the PNG (the input) in here
1058
+ *) LodePNGColorMode info_raw: here you can say what color mode of the raw image (the output) you want to get
1059
+ *) LodePNGDecoderSettings decoder: you can specify a few extra settings for the decoder to use
1060
+
1061
+ LodePNGInfo info_png
1062
+ --------------------
1063
+
1064
+ After decoding, this contains extra information of the PNG image, except the actual
1065
+ pixels, width and height because these are already gotten directly from the decoder
1066
+ functions.
1067
+
1068
+ It contains for example the original color type of the PNG image, text comments,
1069
+ suggested background color, etc... More details about the LodePNGInfo struct are
1070
+ at its declaration documentation.
1071
+
1072
+ LodePNGColorMode info_raw
1073
+ -------------------------
1074
+
1075
+ When decoding, here you can specify which color type you want
1076
+ the resulting raw image to be. If this is different from the colortype of the
1077
+ PNG, then the decoder will automatically convert the result. This conversion
1078
+ always works, except if you want it to convert a color PNG to greyscale or to
1079
+ a palette with missing colors.
1080
+
1081
+ By default, 32-bit color is used for the result.
1082
+
1083
+ LodePNGDecoderSettings decoder
1084
+ ------------------------------
1085
+
1086
+ The settings can be used to ignore the errors created by invalid CRC and Adler32
1087
+ chunks, and to disable the decoding of tEXt chunks.
1088
+
1089
+ There's also a setting color_convert, true by default. If false, no conversion
1090
+ is done, the resulting data will be as it was in the PNG (after decompression)
1091
+ and you'll have to puzzle the colors of the pixels together yourself using the
1092
+ color type information in the LodePNGInfo.
1093
+
1094
+
1095
+ 5. Encoding
1096
+ -----------
1097
+
1098
+ Encoding converts a raw pixel buffer to a PNG compressed image.
1099
+
1100
+ Most documentation on using the encoder is at its declarations in the header
1101
+ above. For C, simple encoding can be done with functions such as
1102
+ lodepng_encode32, and more advanced decoding can be done with the struct
1103
+ LodePNGState and lodepng_encode. For C++, all encoding can be done with the
1104
+ various lodepng::encode functions, and lodepng::State can be used for advanced
1105
+ features.
1106
+
1107
+ Like the decoder, the encoder can also give errors. However it gives less errors
1108
+ since the encoder input is trusted, the decoder input (a PNG image that could
1109
+ be forged by anyone) is not trusted.
1110
+
1111
+ When using the LodePNGState, it uses the following fields for encoding:
1112
+ *) LodePNGInfo info_png: here you specify how you want the PNG (the output) to be.
1113
+ *) LodePNGColorMode info_raw: here you say what color type of the raw image (the input) has
1114
+ *) LodePNGEncoderSettings encoder: you can specify a few settings for the encoder to use
1115
+
1116
+ LodePNGInfo info_png
1117
+ --------------------
1118
+
1119
+ When encoding, you use this the opposite way as when decoding: for encoding,
1120
+ you fill in the values you want the PNG to have before encoding. By default it's
1121
+ not needed to specify a color type for the PNG since it's automatically chosen,
1122
+ but it's possible to choose it yourself given the right settings.
1123
+
1124
+ The encoder will not always exactly match the LodePNGInfo struct you give,
1125
+ it tries as close as possible. Some things are ignored by the encoder. The
1126
+ encoder uses, for example, the following settings from it when applicable:
1127
+ colortype and bitdepth, text chunks, time chunk, the color key, the palette, the
1128
+ background color, the interlace method, unknown chunks, ...
1129
+
1130
+ When encoding to a PNG with colortype 3, the encoder will generate a PLTE chunk.
1131
+ If the palette contains any colors for which the alpha channel is not 255 (so
1132
+ there are translucent colors in the palette), it'll add a tRNS chunk.
1133
+
1134
+ LodePNGColorMode info_raw
1135
+ -------------------------
1136
+
1137
+ You specify the color type of the raw image that you give to the input here,
1138
+ including a possible transparent color key and palette you happen to be using in
1139
+ your raw image data.
1140
+
1141
+ By default, 32-bit color is assumed, meaning your input has to be in RGBA
1142
+ format with 4 bytes (unsigned chars) per pixel.
1143
+
1144
+ LodePNGEncoderSettings encoder
1145
+ ------------------------------
1146
+
1147
+ The following settings are supported (some are in sub-structs):
1148
+ *) auto_convert: when this option is enabled, the encoder will
1149
+ automatically choose the smallest possible color mode (including color key) that
1150
+ can encode the colors of all pixels without information loss.
1151
+ *) btype: the block type for LZ77. 0 = uncompressed, 1 = fixed huffman tree,
1152
+ 2 = dynamic huffman tree (best compression). Should be 2 for proper
1153
+ compression.
1154
+ *) use_lz77: whether or not to use LZ77 for compressed block types. Should be
1155
+ true for proper compression.
1156
+ *) windowsize: the window size used by the LZ77 encoder (1 - 32768). Has value
1157
+ 2048 by default, but can be set to 32768 for better, but slow, compression.
1158
+ *) force_palette: if colortype is 2 or 6, you can make the encoder write a PLTE
1159
+ chunk if force_palette is true. This can used as suggested palette to convert
1160
+ to by viewers that don't support more than 256 colors (if those still exist)
1161
+ *) add_id: add text chunk "Encoder: LodePNG <version>" to the image.
1162
+ *) text_compression: default 1. If 1, it'll store texts as zTXt instead of tEXt chunks.
1163
+ zTXt chunks use zlib compression on the text. This gives a smaller result on
1164
+ large texts but a larger result on small texts (such as a single program name).
1165
+ It's all tEXt or all zTXt though, there's no separate setting per text yet.
1166
+
1167
+
1168
+ 6. color conversions
1169
+ --------------------
1170
+
1171
+ An important thing to note about LodePNG, is that the color type of the PNG, and
1172
+ the color type of the raw image, are completely independent. By default, when
1173
+ you decode a PNG, you get the result as a raw image in the color type you want,
1174
+ no matter whether the PNG was encoded with a palette, greyscale or RGBA color.
1175
+ And if you encode an image, by default LodePNG will automatically choose the PNG
1176
+ color type that gives good compression based on the values of colors and amount
1177
+ of colors in the image. It can be configured to let you control it instead as
1178
+ well, though.
1179
+
1180
+ To be able to do this, LodePNG does conversions from one color mode to another.
1181
+ It can convert from almost any color type to any other color type, except the
1182
+ following conversions: RGB to greyscale is not supported, and converting to a
1183
+ palette when the palette doesn't have a required color is not supported. This is
1184
+ not supported on purpose: this is information loss which requires a color
1185
+ reduction algorithm that is beyong the scope of a PNG encoder (yes, RGB to grey
1186
+ is easy, but there are multiple ways if you want to give some channels more
1187
+ weight).
1188
+
1189
+ By default, when decoding, you get the raw image in 32-bit RGBA or 24-bit RGB
1190
+ color, no matter what color type the PNG has. And by default when encoding,
1191
+ LodePNG automatically picks the best color model for the output PNG, and expects
1192
+ the input image to be 32-bit RGBA or 24-bit RGB. So, unless you want to control
1193
+ the color format of the images yourself, you can skip this chapter.
1194
+
1195
+ 6.1. PNG color types
1196
+ --------------------
1197
+
1198
+ A PNG image can have many color types, ranging from 1-bit color to 64-bit color,
1199
+ as well as palettized color modes. After the zlib decompression and unfiltering
1200
+ in the PNG image is done, the raw pixel data will have that color type and thus
1201
+ a certain amount of bits per pixel. If you want the output raw image after
1202
+ decoding to have another color type, a conversion is done by LodePNG.
1203
+
1204
+ The PNG specification gives the following color types:
1205
+
1206
+ 0: greyscale, bit depths 1, 2, 4, 8, 16
1207
+ 2: RGB, bit depths 8 and 16
1208
+ 3: palette, bit depths 1, 2, 4 and 8
1209
+ 4: greyscale with alpha, bit depths 8 and 16
1210
+ 6: RGBA, bit depths 8 and 16
1211
+
1212
+ Bit depth is the amount of bits per pixel per color channel. So the total amount
1213
+ of bits per pixel is: amount of channels * bitdepth.
1214
+
1215
+ 6.2. color conversions
1216
+ ----------------------
1217
+
1218
+ As explained in the sections about the encoder and decoder, you can specify
1219
+ color types and bit depths in info_png and info_raw to change the default
1220
+ behaviour.
1221
+
1222
+ If, when decoding, you want the raw image to be something else than the default,
1223
+ you need to set the color type and bit depth you want in the LodePNGColorMode,
1224
+ or the parameters of the simple function of LodePNG you're using.
1225
+
1226
+ If, when encoding, you use another color type than the default in the input
1227
+ image, you need to specify its color type and bit depth in the LodePNGColorMode
1228
+ of the raw image, or use the parameters of the simplefunction of LodePNG you're
1229
+ using.
1230
+
1231
+ If, when encoding, you don't want LodePNG to choose the output PNG color type
1232
+ but control it yourself, you need to set auto_convert in the encoder settings
1233
+ to LAC_NONE, and specify the color type you want in the LodePNGInfo of the
1234
+ encoder.
1235
+
1236
+ If you do any of the above, LodePNG may need to do a color conversion, which
1237
+ follows the rules below, and may sometimes not be allowed.
1238
+
1239
+ To avoid some confusion:
1240
+ -the decoder converts from PNG to raw image
1241
+ -the encoder converts from raw image to PNG
1242
+ -the colortype and bitdepth in LodePNGColorMode info_raw, are those of the raw image
1243
+ -the colortype and bitdepth in the color field of LodePNGInfo info_png, are those of the PNG
1244
+ -when encoding, the color type in LodePNGInfo is ignored if auto_convert
1245
+ is enabled, it is automatically generated instead
1246
+ -when decoding, the color type in LodePNGInfo is set by the decoder to that of the original
1247
+ PNG image, but it can be ignored since the raw image has the color type you requested instead
1248
+ -if the color type of the LodePNGColorMode and PNG image aren't the same, a conversion
1249
+ between the color types is done if the color types are supported. If it is not
1250
+ supported, an error is returned. If the types are the same, no conversion is done.
1251
+ -even though some conversions aren't supported, LodePNG supports loading PNGs from any
1252
+ colortype and saving PNGs to any colortype, sometimes it just requires preparing
1253
+ the raw image correctly before encoding.
1254
+ -both encoder and decoder use the same color converter.
1255
+
1256
+ Non supported color conversions:
1257
+ -color to greyscale: no error is thrown, but the result will look ugly because
1258
+ only the red channel is taken
1259
+ -anything, to palette when that palette does not have that color in it: in this
1260
+ case an error is thrown
1261
+
1262
+ Supported color conversions:
1263
+ -anything to 8-bit RGB, 8-bit RGBA, 16-bit RGB, 16-bit RGBA
1264
+ -any grey or grey+alpha, to grey or grey+alpha
1265
+ -anything to a palette, as long as the palette has the requested colors in it
1266
+ -removing alpha channel
1267
+ -higher to smaller bitdepth, and vice versa
1268
+
1269
+ If you want no color conversion to be done:
1270
+ -In the encoder, you can make it save a PNG with any color type by giving the
1271
+ raw color mode and LodePNGInfo the same color mode, and setting auto_convert to
1272
+ LAC_NO.
1273
+ -In the decoder, you can make it store the pixel data in the same color type
1274
+ as the PNG has, by setting the color_convert setting to false. Settings in
1275
+ info_raw are then ignored.
1276
+
1277
+ The function lodepng_convert does the color conversion. It is available in the
1278
+ interface but normally isn't needed since the encoder and decoder already call
1279
+ it.
1280
+
1281
+ 6.3. padding bits
1282
+ -----------------
1283
+
1284
+ In the PNG file format, if a less than 8-bit per pixel color type is used and the scanlines
1285
+ have a bit amount that isn't a multiple of 8, then padding bits are used so that each
1286
+ scanline starts at a fresh byte. But that is NOT true for the LodePNG raw input and output.
1287
+ The raw input image you give to the encoder, and the raw output image you get from the decoder
1288
+ will NOT have these padding bits, e.g. in the case of a 1-bit image with a width
1289
+ of 7 pixels, the first pixel of the second scanline will the the 8th bit of the first byte,
1290
+ not the first bit of a new byte.
1291
+
1292
+ 6.4. A note about 16-bits per channel and endianness
1293
+ ----------------------------------------------------
1294
+
1295
+ LodePNG uses unsigned char arrays for 16-bit per channel colors too, just like
1296
+ for any other color format. The 16-bit values are stored in big endian (most
1297
+ significant byte first) in these arrays. This is the opposite order of the
1298
+ little endian used by x86 CPU's.
1299
+
1300
+ LodePNG always uses big endian because the PNG file format does so internally.
1301
+ Conversions to other formats than PNG uses internally are not supported by
1302
+ LodePNG on purpose, there are myriads of formats, including endianness of 16-bit
1303
+ colors, the order in which you store R, G, B and A, and so on. Supporting and
1304
+ converting to/from all that is outside the scope of LodePNG.
1305
+
1306
+ This may mean that, depending on your use case, you may want to convert the big
1307
+ endian output of LodePNG to little endian with a for loop. This is certainly not
1308
+ always needed, many applications and libraries support big endian 16-bit colors
1309
+ anyway, but it means you cannot simply cast the unsigned char* buffer to an
1310
+ unsigned short* buffer on x86 CPUs.
1311
+
1312
+
1313
+ 7. error values
1314
+ ---------------
1315
+
1316
+ All functions in LodePNG that return an error code, return 0 if everything went
1317
+ OK, or a non-zero code if there was an error.
1318
+
1319
+ The meaning of the LodePNG error values can be retrieved with the function
1320
+ lodepng_error_text: given the numerical error code, it returns a description
1321
+ of the error in English as a string.
1322
+
1323
+ Check the implementation of lodepng_error_text to see the meaning of each code.
1324
+
1325
+
1326
+ 8. chunks and PNG editing
1327
+ -------------------------
1328
+
1329
+ If you want to add extra chunks to a PNG you encode, or use LodePNG for a PNG
1330
+ editor that should follow the rules about handling of unknown chunks, or if your
1331
+ program is able to read other types of chunks than the ones handled by LodePNG,
1332
+ then that's possible with the chunk functions of LodePNG.
1333
+
1334
+ A PNG chunk has the following layout:
1335
+
1336
+ 4 bytes length
1337
+ 4 bytes type name
1338
+ length bytes data
1339
+ 4 bytes CRC
1340
+
1341
+ 8.1. iterating through chunks
1342
+ -----------------------------
1343
+
1344
+ If you have a buffer containing the PNG image data, then the first chunk (the
1345
+ IHDR chunk) starts at byte number 8 of that buffer. The first 8 bytes are the
1346
+ signature of the PNG and are not part of a chunk. But if you start at byte 8
1347
+ then you have a chunk, and can check the following things of it.
1348
+
1349
+ NOTE: none of these functions check for memory buffer boundaries. To avoid
1350
+ exploits, always make sure the buffer contains all the data of the chunks.
1351
+ When using lodepng_chunk_next, make sure the returned value is within the
1352
+ allocated memory.
1353
+
1354
+ unsigned lodepng_chunk_length(const unsigned char* chunk):
1355
+
1356
+ Get the length of the chunk's data. The total chunk length is this length + 12.
1357
+
1358
+ void lodepng_chunk_type(char type[5], const unsigned char* chunk):
1359
+ unsigned char lodepng_chunk_type_equals(const unsigned char* chunk, const char* type):
1360
+
1361
+ Get the type of the chunk or compare if it's a certain type
1362
+
1363
+ unsigned char lodepng_chunk_critical(const unsigned char* chunk):
1364
+ unsigned char lodepng_chunk_private(const unsigned char* chunk):
1365
+ unsigned char lodepng_chunk_safetocopy(const unsigned char* chunk):
1366
+
1367
+ Check if the chunk is critical in the PNG standard (only IHDR, PLTE, IDAT and IEND are).
1368
+ Check if the chunk is private (public chunks are part of the standard, private ones not).
1369
+ Check if the chunk is safe to copy. If it's not, then, when modifying data in a critical
1370
+ chunk, unsafe to copy chunks of the old image may NOT be saved in the new one if your
1371
+ program doesn't handle that type of unknown chunk.
1372
+
1373
+ unsigned char* lodepng_chunk_data(unsigned char* chunk):
1374
+ const unsigned char* lodepng_chunk_data_const(const unsigned char* chunk):
1375
+
1376
+ Get a pointer to the start of the data of the chunk.
1377
+
1378
+ unsigned lodepng_chunk_check_crc(const unsigned char* chunk):
1379
+ void lodepng_chunk_generate_crc(unsigned char* chunk):
1380
+
1381
+ Check if the crc is correct or generate a correct one.
1382
+
1383
+ unsigned char* lodepng_chunk_next(unsigned char* chunk):
1384
+ const unsigned char* lodepng_chunk_next_const(const unsigned char* chunk):
1385
+
1386
+ Iterate to the next chunk. This works if you have a buffer with consecutive chunks. Note that these
1387
+ functions do no boundary checking of the allocated data whatsoever, so make sure there is enough
1388
+ data available in the buffer to be able to go to the next chunk.
1389
+
1390
+ unsigned lodepng_chunk_append(unsigned char** out, size_t* outlength, const unsigned char* chunk):
1391
+ unsigned lodepng_chunk_create(unsigned char** out, size_t* outlength, unsigned length,
1392
+ const char* type, const unsigned char* data):
1393
+
1394
+ These functions are used to create new chunks that are appended to the data in *out that has
1395
+ length *outlength. The append function appends an existing chunk to the new data. The create
1396
+ function creates a new chunk with the given parameters and appends it. Type is the 4-letter
1397
+ name of the chunk.
1398
+
1399
+ 8.2. chunks in info_png
1400
+ -----------------------
1401
+
1402
+ The LodePNGInfo struct contains fields with the unknown chunk in it. It has 3
1403
+ buffers (each with size) to contain 3 types of unknown chunks:
1404
+ the ones that come before the PLTE chunk, the ones that come between the PLTE
1405
+ and the IDAT chunks, and the ones that come after the IDAT chunks.
1406
+ It's necessary to make the distionction between these 3 cases because the PNG
1407
+ standard forces to keep the ordering of unknown chunks compared to the critical
1408
+ chunks, but does not force any other ordering rules.
1409
+
1410
+ info_png.unknown_chunks_data[0] is the chunks before PLTE
1411
+ info_png.unknown_chunks_data[1] is the chunks after PLTE, before IDAT
1412
+ info_png.unknown_chunks_data[2] is the chunks after IDAT
1413
+
1414
+ The chunks in these 3 buffers can be iterated through and read by using the same
1415
+ way described in the previous subchapter.
1416
+
1417
+ When using the decoder to decode a PNG, you can make it store all unknown chunks
1418
+ if you set the option settings.remember_unknown_chunks to 1. By default, this
1419
+ option is off (0).
1420
+
1421
+ The encoder will always encode unknown chunks that are stored in the info_png.
1422
+ If you need it to add a particular chunk that isn't known by LodePNG, you can
1423
+ use lodepng_chunk_append or lodepng_chunk_create to the chunk data in
1424
+ info_png.unknown_chunks_data[x].
1425
+
1426
+ Chunks that are known by LodePNG should not be added in that way. E.g. to make
1427
+ LodePNG add a bKGD chunk, set background_defined to true and add the correct
1428
+ parameters there instead.
1429
+
1430
+
1431
+ 9. compiler support
1432
+ -------------------
1433
+
1434
+ No libraries other than the current standard C library are needed to compile
1435
+ LodePNG. For the C++ version, only the standard C++ library is needed on top.
1436
+ Add the files lodepng.c(pp) and lodepng.h to your project, include
1437
+ lodepng.h where needed, and your program can read/write PNG files.
1438
+
1439
+ If performance is important, use optimization when compiling! For both the
1440
+ encoder and decoder, this makes a large difference.
1441
+
1442
+ Make sure that LodePNG is compiled with the same compiler of the same version
1443
+ and with the same settings as the rest of the program, or the interfaces with
1444
+ std::vectors and std::strings in C++ can be incompatible.
1445
+
1446
+ CHAR_BITS must be 8 or higher, because LodePNG uses unsigned chars for octets.
1447
+
1448
+ *) gcc and g++
1449
+
1450
+ LodePNG is developed in gcc so this compiler is natively supported. It gives no
1451
+ warnings with compiler options "-Wall -Wextra -pedantic -ansi", with gcc and g++
1452
+ version 4.7.1 on Linux, 32-bit and 64-bit.
1453
+
1454
+ *) Mingw
1455
+
1456
+ The Mingw compiler (a port of gcc) for Windows is fully supported by LodePNG.
1457
+
1458
+ *) Visual Studio 2005 and up, Visual C++ Express Edition 2005 and up
1459
+
1460
+ Visual Studio may give warnings about 'fopen' being deprecated. A multiplatform library
1461
+ can't support the proposed Visual Studio alternative however, so LodePNG keeps using
1462
+ fopen. If you don't want to see the deprecated warnings, put this on top of lodepng.h
1463
+ before the inclusions:
1464
+ #define _CRT_SECURE_NO_DEPRECATE
1465
+
1466
+ Other than the above warnings, LodePNG should be warning-free with warning
1467
+ level 3 (W3). Warning level 4 (W4) will give warnings about integer conversions.
1468
+ I'm not planning to resolve these warnings. To get rid of them, let Visual
1469
+ Studio use warning level W3 for lodepng.cpp only: right click lodepng.cpp,
1470
+ Properties, C/C++, General, Warning Level: Level 3 (/W3).
1471
+
1472
+ Visual Studio may want "stdafx.h" files to be included in each source file and
1473
+ give an error "unexpected end of file while looking for precompiled header".
1474
+ That is not standard C++ and will not be added to the stock LodePNG. You can
1475
+ disable it for lodepng.cpp only by right clicking it, Properties, C/C++,
1476
+ Precompiled Headers, and set it to Not Using Precompiled Headers there.
1477
+
1478
+ *) Visual Studio 6.0
1479
+
1480
+ LodePNG support for Visual Studio 6.0 is not guaranteed because VS6 doesn't
1481
+ follow the C++ standard correctly.
1482
+
1483
+ *) Comeau C/C++
1484
+
1485
+ Vesion 20070107 compiles without problems on the Comeau C/C++ Online Test Drive
1486
+ at http://www.comeaucomputing.com/tryitout in both C90 and C++ mode.
1487
+
1488
+ *) Compilers on Macintosh
1489
+
1490
+ LodePNG has been reported to work both with the gcc and LLVM for Macintosh, both
1491
+ for C and C++.
1492
+
1493
+ *) Other Compilers
1494
+
1495
+ If you encounter problems on other compilers, feel free to let me know and I may
1496
+ try to fix it if the compiler is modern standards complient.
1497
+
1498
+
1499
+ 10. examples
1500
+ ------------
1501
+
1502
+ This decoder example shows the most basic usage of LodePNG. More complex
1503
+ examples can be found on the LodePNG website.
1504
+
1505
+ 10.1. decoder C++ example
1506
+ -------------------------
1507
+
1508
+ #include "lodepng.h"
1509
+ #include <iostream>
1510
+
1511
+ int main(int argc, char *argv[])
1512
+ {
1513
+ const char* filename = argc > 1 ? argv[1] : "test.png";
1514
+
1515
+ //load and decode
1516
+ std::vector<unsigned char> image;
1517
+ unsigned width, height;
1518
+ unsigned error = lodepng::decode(image, width, height, filename);
1519
+
1520
+ //if there's an error, display it
1521
+ if(error) std::cout << "decoder error " << error << ": " << lodepng_error_text(error) << std::endl;
1522
+
1523
+ //the pixels are now in the vector "image", 4 bytes per pixel, ordered RGBARGBA..., use it as texture, draw it, ...
1524
+ }
1525
+
1526
+ 10.2. decoder C example
1527
+ -----------------------
1528
+
1529
+ #include "lodepng.h"
1530
+
1531
+ int main(int argc, char *argv[])
1532
+ {
1533
+ unsigned error;
1534
+ unsigned char* image;
1535
+ size_t width, height;
1536
+ const char* filename = argc > 1 ? argv[1] : "test.png";
1537
+
1538
+ error = lodepng_decode32_file(&image, &width, &height, filename);
1539
+
1540
+ if(error) printf("decoder error %u: %s\n", error, lodepng_error_text(error));
1541
+
1542
+ / * use image here * /
1543
+
1544
+ free(image);
1545
+ return 0;
1546
+ }
1547
+
1548
+
1549
+ 11. changes
1550
+ -----------
1551
+
1552
+ The version number of LodePNG is the date of the change given in the format
1553
+ yyyymmdd.
1554
+
1555
+ Some changes aren't backwards compatible. Those are indicated with a (!)
1556
+ symbol.
1557
+
1558
+ *) 25 mar 2013: Added an optional feature to ignore some PNG errors (fix_png).
1559
+ *) 11 mar 2013 (!): Bugfix with custom free. Changed from "my" to "lodepng_"
1560
+ prefix for the custom allocators and made it possible with a new #define to
1561
+ use custom ones in your project without needing to change lodepng's code.
1562
+ *) 28 jan 2013: Bugfix with color key.
1563
+ *) 27 okt 2012: Tweaks in text chunk keyword length error handling.
1564
+ *) 8 okt 2012 (!): Added new filter strategy (entropy) and new auto color mode.
1565
+ (no palette). Better deflate tree encoding. New compression tweak settings.
1566
+ Faster color conversions while decoding. Some internal cleanups.
1567
+ *) 23 sep 2012: Reduced warnings in Visual Studio a little bit.
1568
+ *) 1 sep 2012 (!): Removed #define's for giving custom (de)compression functions
1569
+ and made it work with function pointers instead.
1570
+ *) 23 jun 2012: Added more filter strategies. Made it easier to use custom alloc
1571
+ and free functions and toggle #defines from compiler flags. Small fixes.
1572
+ *) 6 may 2012 (!): Made plugging in custom zlib/deflate functions more flexible.
1573
+ *) 22 apr 2012 (!): Made interface more consistent, renaming a lot. Removed
1574
+ redundant C++ codec classes. Reduced amount of structs. Everything changed,
1575
+ but it is cleaner now imho and functionality remains the same. Also fixed
1576
+ several bugs and shrinked the implementation code. Made new samples.
1577
+ *) 6 nov 2011 (!): By default, the encoder now automatically chooses the best
1578
+ PNG color model and bit depth, based on the amount and type of colors of the
1579
+ raw image. For this, autoLeaveOutAlphaChannel replaced by auto_choose_color.
1580
+ *) 9 okt 2011: simpler hash chain implementation for the encoder.
1581
+ *) 8 sep 2011: lz77 encoder lazy matching instead of greedy matching.
1582
+ *) 23 aug 2011: tweaked the zlib compression parameters after benchmarking.
1583
+ A bug with the PNG filtertype heuristic was fixed, so that it chooses much
1584
+ better ones (it's quite significant). A setting to do an experimental, slow,
1585
+ brute force search for PNG filter types is added.
1586
+ *) 17 aug 2011 (!): changed some C zlib related function names.
1587
+ *) 16 aug 2011: made the code less wide (max 120 characters per line).
1588
+ *) 17 apr 2011: code cleanup. Bugfixes. Convert low to 16-bit per sample colors.
1589
+ *) 21 feb 2011: fixed compiling for C90. Fixed compiling with sections disabled.
1590
+ *) 11 dec 2010: encoding is made faster, based on suggestion by Peter Eastman
1591
+ to optimize long sequences of zeros.
1592
+ *) 13 nov 2010: added LodePNG_InfoColor_hasPaletteAlpha and
1593
+ LodePNG_InfoColor_canHaveAlpha functions for convenience.
1594
+ *) 7 nov 2010: added LodePNG_error_text function to get error code description.
1595
+ *) 30 okt 2010: made decoding slightly faster
1596
+ *) 26 okt 2010: (!) changed some C function and struct names (more consistent).
1597
+ Reorganized the documentation and the declaration order in the header.
1598
+ *) 08 aug 2010: only changed some comments and external samples.
1599
+ *) 05 jul 2010: fixed bug thanks to warnings in the new gcc version.
1600
+ *) 14 mar 2010: fixed bug where too much memory was allocated for char buffers.
1601
+ *) 02 sep 2008: fixed bug where it could create empty tree that linux apps could
1602
+ read by ignoring the problem but windows apps couldn't.
1603
+ *) 06 jun 2008: added more error checks for out of memory cases.
1604
+ *) 26 apr 2008: added a few more checks here and there to ensure more safety.
1605
+ *) 06 mar 2008: crash with encoding of strings fixed
1606
+ *) 02 feb 2008: support for international text chunks added (iTXt)
1607
+ *) 23 jan 2008: small cleanups, and #defines to divide code in sections
1608
+ *) 20 jan 2008: support for unknown chunks allowing using LodePNG for an editor.
1609
+ *) 18 jan 2008: support for tIME and pHYs chunks added to encoder and decoder.
1610
+ *) 17 jan 2008: ability to encode and decode compressed zTXt chunks added
1611
+ Also vareous fixes, such as in the deflate and the padding bits code.
1612
+ *) 13 jan 2008: Added ability to encode Adam7-interlaced images. Improved
1613
+ filtering code of encoder.
1614
+ *) 07 jan 2008: (!) changed LodePNG to use ISO C90 instead of C++. A
1615
+ C++ wrapper around this provides an interface almost identical to before.
1616
+ Having LodePNG be pure ISO C90 makes it more portable. The C and C++ code
1617
+ are together in these files but it works both for C and C++ compilers.
1618
+ *) 29 dec 2007: (!) changed most integer types to unsigned int + other tweaks
1619
+ *) 30 aug 2007: bug fixed which makes this Borland C++ compatible
1620
+ *) 09 aug 2007: some VS2005 warnings removed again
1621
+ *) 21 jul 2007: deflate code placed in new namespace separate from zlib code
1622
+ *) 08 jun 2007: fixed bug with 2- and 4-bit color, and small interlaced images
1623
+ *) 04 jun 2007: improved support for Visual Studio 2005: crash with accessing
1624
+ invalid std::vector element [0] fixed, and level 3 and 4 warnings removed
1625
+ *) 02 jun 2007: made the encoder add a tag with version by default
1626
+ *) 27 may 2007: zlib and png code separated (but still in the same file),
1627
+ simple encoder/decoder functions added for more simple usage cases
1628
+ *) 19 may 2007: minor fixes, some code cleaning, new error added (error 69),
1629
+ moved some examples from here to lodepng_examples.cpp
1630
+ *) 12 may 2007: palette decoding bug fixed
1631
+ *) 24 apr 2007: changed the license from BSD to the zlib license
1632
+ *) 11 mar 2007: very simple addition: ability to encode bKGD chunks.
1633
+ *) 04 mar 2007: (!) tEXt chunk related fixes, and support for encoding
1634
+ palettized PNG images. Plus little interface change with palette and texts.
1635
+ *) 03 mar 2007: Made it encode dynamic Huffman shorter with repeat codes.
1636
+ Fixed a bug where the end code of a block had length 0 in the Huffman tree.
1637
+ *) 26 feb 2007: Huffman compression with dynamic trees (BTYPE 2) now implemented
1638
+ and supported by the encoder, resulting in smaller PNGs at the output.
1639
+ *) 27 jan 2007: Made the Adler-32 test faster so that a timewaste is gone.
1640
+ *) 24 jan 2007: gave encoder an error interface. Added color conversion from any
1641
+ greyscale type to 8-bit greyscale with or without alpha.
1642
+ *) 21 jan 2007: (!) Totally changed the interface. It allows more color types
1643
+ to convert to and is more uniform. See the manual for how it works now.
1644
+ *) 07 jan 2007: Some cleanup & fixes, and a few changes over the last days:
1645
+ encode/decode custom tEXt chunks, separate classes for zlib & deflate, and
1646
+ at last made the decoder give errors for incorrect Adler32 or Crc.
1647
+ *) 01 jan 2007: Fixed bug with encoding PNGs with less than 8 bits per channel.
1648
+ *) 29 dec 2006: Added support for encoding images without alpha channel, and
1649
+ cleaned out code as well as making certain parts faster.
1650
+ *) 28 dec 2006: Added "Settings" to the encoder.
1651
+ *) 26 dec 2006: The encoder now does LZ77 encoding and produces much smaller files now.
1652
+ Removed some code duplication in the decoder. Fixed little bug in an example.
1653
+ *) 09 dec 2006: (!) Placed output parameters of public functions as first parameter.
1654
+ Fixed a bug of the decoder with 16-bit per color.
1655
+ *) 15 okt 2006: Changed documentation structure
1656
+ *) 09 okt 2006: Encoder class added. It encodes a valid PNG image from the
1657
+ given image buffer, however for now it's not compressed.
1658
+ *) 08 sep 2006: (!) Changed to interface with a Decoder class
1659
+ *) 30 jul 2006: (!) LodePNG_InfoPng , width and height are now retrieved in different
1660
+ way. Renamed decodePNG to decodePNGGeneric.
1661
+ *) 29 jul 2006: (!) Changed the interface: image info is now returned as a
1662
+ struct of type LodePNG::LodePNG_Info, instead of a vector, which was a bit clumsy.
1663
+ *) 28 jul 2006: Cleaned the code and added new error checks.
1664
+ Corrected terminology "deflate" into "inflate".
1665
+ *) 23 jun 2006: Added SDL example in the documentation in the header, this
1666
+ example allows easy debugging by displaying the PNG and its transparency.
1667
+ *) 22 jun 2006: (!) Changed way to obtain error value. Added
1668
+ loadFile function for convenience. Made decodePNG32 faster.
1669
+ *) 21 jun 2006: (!) Changed type of info vector to unsigned.
1670
+ Changed position of palette in info vector. Fixed an important bug that
1671
+ happened on PNGs with an uncompressed block.
1672
+ *) 16 jun 2006: Internally changed unsigned into unsigned where
1673
+ needed, and performed some optimizations.
1674
+ *) 07 jun 2006: (!) Renamed functions to decodePNG and placed them
1675
+ in LodePNG namespace. Changed the order of the parameters. Rewrote the
1676
+ documentation in the header. Renamed files to lodepng.cpp and lodepng.h
1677
+ *) 22 apr 2006: Optimized and improved some code
1678
+ *) 07 sep 2005: (!) Changed to std::vector interface
1679
+ *) 12 aug 2005: Initial release (C++, decoder only)
1680
+
1681
+
1682
+ 12. contact information
1683
+ -----------------------
1684
+
1685
+ Feel free to contact me with suggestions, problems, comments, ... concerning
1686
+ LodePNG. If you encounter a PNG image that doesn't work properly with this
1687
+ decoder, feel free to send it and I'll use it to find and fix the problem.
1688
+
1689
+ My email address is (puzzle the account and domain together with an @ symbol):
1690
+ Domain: gmail dot com.
1691
+ Account: lode dot vandevenne.
1692
+
1693
+
1694
+ Copyright (c) 2005-2012 Lode Vandevenne
1695
+ */