Skip to content
Java Port of the stb_image.h
Branch: master
Clone or download


Download Chat

StbImageJava is Java port of stb_image.h 2.22. Or - in other words - it's a Java library that can load images in JPG, PNG, BMP, TGA, PSD and GIF formats.

Adding Reference

StbImageJava is available at bintray/jcenter:


Following code loads image from byte array and converts it to 32-bit RGBA:

  byte[] bytes = Files.readAllBytes(new File("image.jpg").toPath());
  ImageResult image = ImageResult.FromData(bytes, ColorComponents.RedGreenBlueAlpha);

Building from Source

  1. Clone this repo.
  2. gradlew idea
  3. Open generated project in the Intellij IDEA.

Reliability & Performance

There is special app to measure reliability & performance of StbImageSharp in comparison to the original stb_image.h:

It could be built through command gradlew jar(jar will appear in the folder testing/build/libs) and ran through: java -jar testing-1.0.jar <path_to_folder_with_images>(i.e. java -jar testing-1.0.jar D:/Projects/TestImages).

It goes through every image file in the specified folder and tries to load it 10 times with StbImageJava, then 10 times with ljwgl-stb(which is JNI wrapper over original stb_image.h). Then it compares whether the results are byte-wise similar and also calculates loading times. Also it sums up and reports loading times for each method.

Moreover ImageIO is included in the testing too.

I've used it over following set of images:

The byte-wise comprarison results are similar for StbImageSharp and Stb.Native(except a few 16-bit PNGs and PSDs that arent supported yet by StbImageJava).

And performance comparison results are(times are total loading times):

13 -- StbImageJava - jpg: 2890, psd: 9, bmp: 101, png: 12785, tga: 830, Total: 16615 ms
13 -- Stb.Native - jpg: 846, psd: 0, bmp: 35, png: 9350, tga: 587, Total: 10818 ms
13 -- ImageIO - jpg: 2161, bmp: 17, png: 14760, Total: 16938 ms
13 -- Total files processed - jpg: 170, psd: 1, bmp: 7, png: 564, tga: 41, Total: 783


Public Domain


You can’t perform that action at this time.