Stb image loader (jMonkeyEngine#2718)

Author: riccardobl

gradle/libs.versions.toml

@@ -48,6 +48,8 @@ nifty-style-black      = { module = "com.github.nifty-gui:nifty-style-black",
 spotbugs-gradle-plugin = "com.github.spotbugs.snom:spotbugs-gradle-plugin:6.4.8"
 vecmath = "javax.vecmath:vecmath:1.5.2"
 
+stb-image = "org.ngengine:stb-image:2.30.4"
+
 [bundles]
 
 [plugins]

jme3-android/src/main/resources/com/jme3/asset/Android.cfg

@@ -3,6 +3,4 @@ INCLUDE com/jme3/asset/General.cfg
 # Android specific locators
 LOCATOR / com.jme3.asset.plugins.AndroidLocator
 
-# Android specific loaders
-LOADER com.jme3.texture.plugins.AndroidNativeImageLoader : jpg, bmp, gif, png, jpeg
 LOADER com.jme3.texture.plugins.AndroidBufferImageLoader : webp, heic, heif

jme3-core/src/main/java/com/jme3/texture/image/ImageCodec.java

@@ -103,13 +103,21 @@ public ImageCodec(int bpp, int flags, int maxAlpha, int maxRed, int maxGreen, in
 
         params.put(Format.RGB8,     new ByteOffsetImageCodec(3, 0, -1, 0, 1, 2));
 
-        params.put(Format.RGB32F,        new ByteAlignedImageCodec(12, FLAG_F32,
-                                                                   0,  4, 4, 4,
-                                                                   0,  0, 4, 8));
-        
-        ByteAlignedImageCodec rgb16f = new ByteAlignedImageCodec(6, FLAG_F16,
-                                                            0, 2, 2, 2,
-                                                            0, 0, 2, 4); 
+        params.put(Format.RGB32F,        new ByteAlignedImageCodec(12, FLAG_F32,
+                                                                   0,  4, 4, 4,
+                                                                   0,  0, 4, 8));
+
+        params.put(Format.R16F,          new ByteAlignedImageCodec(2, FLAG_F16,
+                                                                   0,  2, 0, 0,
+                                                                   0,  0, 0, 0));
+
+        params.put(Format.RG16F,         new ByteAlignedImageCodec(4, FLAG_F16,
+                                                                   0,  2, 2, 0,
+                                                                   0,  0, 2, 0));
+
+        ByteAlignedImageCodec rgb16f = new ByteAlignedImageCodec(6, FLAG_F16,
+                                                            0, 2, 2, 2,
+                                                            0, 0, 2, 4);
         params.put(Format.RGB16F, rgb16f);
         params.put(Format.RGB16F_to_RGB111110F, rgb16f);
         params.put(Format.RGB16F_to_RGB9E5, rgb16f);

jme3-core/src/main/resources/com/jme3/asset/Desktop.cfg

@@ -1,5 +1,4 @@
 INCLUDE com/jme3/asset/General.cfg
 
 # Desktop-specific loaders
-LOADER com.jme3.texture.plugins.AWTLoader : jpg, bmp, gif, png, jpeg
 LOADER com.jme3.cursors.plugins.CursorLoader : ani, cur, ico

jme3-core/src/main/resources/com/jme3/asset/General.cfg

@@ -9,8 +9,6 @@ LOADER com.jme3.material.plugins.ShaderNodeDefinitionLoader : j3sn
 LOADER com.jme3.font.plugins.BitmapFontLoader : fnt
 LOADER com.jme3.texture.plugins.DDSLoader : dds
 LOADER com.jme3.texture.plugins.PFMLoader : pfm
-LOADER com.jme3.texture.plugins.HDRLoader : hdr
-LOADER com.jme3.texture.plugins.TGALoader : tga
 LOADER com.jme3.export.binary.BinaryLoader : j3o
 LOADER com.jme3.export.binary.BinaryLoader : j3f
 LOADER com.jme3.scene.plugins.OBJLoader : obj
@@ -23,4 +21,5 @@ LOADER com.jme3.shader.plugins.GLSLLoader : vert, frag, geom, tsctrl, tseval, gl
 LOADER com.jme3.scene.plugins.gltf.GltfLoader : gltf
 LOADER com.jme3.scene.plugins.gltf.BinLoader : bin
 LOADER com.jme3.scene.plugins.gltf.GlbLoader : glb
+LOADER com.jme3.texture.plugins.StbImageLoader : jpg, bmp, gif, png, jpeg, tga, psd, hdr 
 LOADER com.jme3.audio.plugins.OGGLoader : ogg

jme3-core/src/plugins/java/com/jme3/texture/plugins/HDRLoader.java

@@ -46,6 +46,11 @@
 import java.util.logging.Level;
 import java.util.logging.Logger;
 
+/**
+ * @deprecated use {@link StbImageLoader} instead, which supports HDR images and more formats. This loader is
+ *             kept for backward compatibility but may be removed in future versions.
+ */
+@Deprecated
 public class HDRLoader implements AssetLoader {
 
     private static final Logger logger = Logger.getLogger(HDRLoader.class.getName());

jme3-core/src/plugins/java/com/jme3/texture/plugins/TGALoader.java

@@ -46,15 +46,16 @@
 import java.nio.ByteBuffer;
 
 /**
- * <code>TextureManager</code> provides static methods for building a
- * <code>Texture</code> object. Typically, the information supplied is the
- * filename and the texture properties.
+ * <code>TextureManager</code> provides static methods for building a <code>Texture</code> object. Typically,
+ * the information supplied is the filename and the texture properties.
  * 
  * @author Mark Powell
  * @author Joshua Slack - cleaned, commented, added ability to read 16bit true color and color-mapped TGAs.
  * @author Kirill Vainer - ported to jME3
  * @version $Id: TGALoader.java 4131 2009-03-19 20:15:28Z blaine.dev $
+ * @deprecated use {@link StbImageLoader} instead
  */
+@Deprecated
 public final class TGALoader implements AssetLoader {
 
     // 0 - no image data in file

jme3-desktop/build.gradle

@@ -1,3 +1,4 @@
 dependencies {
     api project(':jme3-core')
+    api project(':jme3-plugins')
 }

jme3-desktop/src/main/java/com/jme3/texture/plugins/AWTLoader.java

@@ -47,6 +47,12 @@
 import java.nio.ByteBuffer;
 import javax.imageio.ImageIO;
 
+/**
+ * @deprecated use {@link StbImageLoader} instead, which supports more formats and is more efficient and
+ *             platform agnostic. This loader is kept for backward compatibility but may be removed in future
+ *             versions.
+ */
+@Deprecated
 public class AWTLoader implements AssetLoader {
 
     public static final ColorModel AWT_RGBA4444 = new DirectColorModel(16,

jme3-plugins/build.gradle

@@ -14,5 +14,7 @@ dependencies {
     implementation "org.jmonkeyengine:drako:1.4.5-jme"
     implementation project(':jme3-plugins-json')
     implementation project(':jme3-plugins-json-gson')
+    implementation libs.stb.image
+
     testRuntimeOnly project(':jme3-desktop')
 }