jMonkeyEngine Changelog

What's new in jMonkeyEngine 3.7.0 Beta 1

May 10, 2024

What's Changed Since 3.7.0-alpha3.1:
Gradle build (zip) by @JNightRide in #2235
Logic code error (LwjglCanvas - LWJGL3) by @JNightRide in #2238
Fix SkeletonDebugger deserializing by @tonihele in #2228
#2224 Fix bug where the clipRect would be left in the openGL state by @richardTingle in #2225
Logs exception as severe on asset locator instantiation failure by @codex128 in #2232
stop building with JDK 8 at GitHub Actions by @stephengold in #2254
Remove material cache, some materials seem not work when cloned by @tonihele in #2255
solution for issue #2250 (exceptions from Image.setMultiSamples(1)) by @stephengold in #2251
main.yml: upgrade the wrapper validation action to v3 by @stephengold in #2257

New in jMonkeyEngine 3.7.0 Alpha 3 (Mar 11, 2024)

New in jMonkeyEngine 3.7.0 Alpha 2 (Mar 4, 2024)

New in jMonkeyEngine 3.7.0 Alpha 1 (Feb 27, 2024)

New in jMonkeyEngine 3.6.0 (Mar 20, 2023)

New features:
Jme3-lwjgl3: add a WindowSizeListener
Actions based vr input
Separate concept of window size from default framebuffer size
Add FOR macro to GLSL preprocessor and J3MD
Android: Implemented AndroidNativeBufferAllocator - Deprecated AndroidBufferAllocator
Add GL debug capabilities
Add java types to VarType and type checks to MatParam
Some enhancement to new animation system
Added a Loop tween to Tweens factory class. Supports looping by count…
Added Tweens.cycle() and Tweens.invert() methods
Add instance culling function in InstancedGeometry
Implementation of a glTF extension loader for KHR_texture_transform
Add the Spatial.addControlAt() method
JmeContext: add a getSystemListener() method
Add 4 getters to JmeContext for screen position and frame-buffer size
Bugs and defects addressed:
RenderState: fixed 'backStencilStencilFailOperation' field serializat…
LwjglWindow:assign new thread to mainThread field.
Chase cam can rotate fix on re-enable
Fix and test for issue 1723 (more serialization bugs in RenderState)
Fix NullPointerException in AnimLayer.update()
AlAudioRenderer: update OpenAL state when dry filter is re-applied
Cross-platform fix for issue 1745 (mouse input scaling)
Fix error 1280 in MacOS when querying GL_FRAMEBUFFER_SRGB_CAPABLE_EXT
Fix issue 1705 (serialize 6 mesh subclasses)
Solve issue #1761 (AssertionError in ALAudioRenderer)
Solve issue #1780 (built-in matdefs/shaders lack core-profile support)
Fix draw/read buffer selection for framebuffers (FrameBuffer.setTargetIndex(int))
Add toggleable framebuffer mipmaps generation. Fix #1788
work around missing reshape() callbacks from LWJGL v3 (issue #1793)
JmeSurfaceView: Fixed duplicate app destruction.
Solve issue #1798 (filtered scenes are squeezed)
Solve issue #1813 (glTF loader loses keyframes)
Refactor to avoid invoking AppSettings.getBoolean() directly
JmeSurfaceView: Removed explicit nullifying GlSurfaceView onDestroy
Solve issue #1809 (GltfLoader is not thread-safe)
Fix issue #1839
SettingsDialog: LAF fix
Fix #1843 (java.util.zip.ZipException in HttpZipLocator)
Fix #1850 (JmeSystem.writeImageFile() throw java.nio.BufferUnderflowE…
Fix: make the stencil test functions usable.
Fix #1871 (vertex colors not loaded in gltf models)
Fix #1867 (LightFilter gets applied even if not needed)
Fix #1412 (GltfLoader does not support AO packed in MetallicRoughnessMap)
Fix #1882 (J3MLoader always generates mips ignoring MinFilter)
Made Gltf extension loaders non-static to avoid concurrency issues
Fix #1883 (Image class wrongly setting GL mips flags inside the constructor)
Fix #1892 (TestChooser does not show classes list when run with java 8)
main.yml: use "temurin" openjdk.
Fix #1773 (Wrong particle position when worldSpace flag equals to true)
Jme3-niftygui: solve issue #1891 (incorrect fullscreen layout)
Jme3-lwjgl:updated to lwjgl v2.9.4 hosted by org.jmonkeyengine.
Fix #1890 (crashes attempting to run example apps in fullscreen with LWJGL v2)
When in VR attach the debug scene to the two eye's scenes
Refactored PBR Terrain to use new for-loops.
Refactored Advanced PBR Terrain to use new for-loops
Update AfflictionLib.glsllib
Common.gradle: set class files compatible with Java 8 using "release" option.
Test and fix for #1909 (NPE while generating tangents)
Jme3-lwjgl: bump to lwjgl 2.9.5.
Fix #1917 (RendererException in ScreenshotAppState: Attempting to upload empty buffer)
PBRLighting: fix comment describing packed MetallicRoughnessMap
solve issue #1919 (underflow while generating tangents)
Main.yml: deploy with jdk17
Fix #1923 (OSSRH artifacts are build with different java version)
Resolve issue #1926 (unnecessary dependencies)
Solve issue #1928 (OutOfMemoryError in FBX importer)
Solve issue #1930 (NPE in FbxLayerElement)
Solve issue #1932 (class cast exceptions in FBX importer)

New in jMonkeyEngine 3.6.0 Beta 2 (Feb 13, 2023)

New in jMonkeyEngine 3.6.0 Beta 1 (Jan 24, 2023)

New in jMonkeyEngine 3.6.0 Alpha 3 (Jan 15, 2023)

New in jMonkeyEngine 3.6.0 Alpha 2 (Jan 12, 2023)

New in jMonkeyEngine 3.6.0 Alpha 1 (Jan 2, 2023)

Potential breaking changes:
Use OpenGL 3.2 as default by @riccardobl in #1752
BlendAction: resolve slow-motion side effect caused by stretching actions by @Ali-RS in #1848
move SettingsDialog and ErrorDialog to new jme3-awt-dialogs module by @riccardobl in #1876
JmeSurfaceView: Package migration by @Scrappers-glitch in #1819
New features:
jme3-lwjgl3: add a WindowSizeListener by @Ali-RS in #1711
#1734 actions based vr input by @richardTingle in #1735
Separate concept of window size from default framebuffer size by @riccardobl in #1750
Add FOR macro to GLSL preprocessor and J3MD by @riccardobl in #1758
Android: Implemented AndroidNativeBufferAllocator - Deprecated AndroidBufferAllocator by @Scrappers-glitch in #1821
Add GL debug capabilities by @riccardobl in #1790
Add java types to VarType and type checks to MatParam by @riccardobl in #1797
Some enhancement to new animation system by @Ali-RS in #1845
Added a Loop tween to Tweens factory class. Supports looping by count… by @Ali-RS in #1846
Added Tweens.cycle() and Tweens.invert() methods by @Ali-RS in #1849
Add instance culling function in InstancedGeometry by @Ali-RS in #1865
Implementation of a glTF extension loader for KHR_texture_transform by @manuelrmo in #1869
Bugs and defects addressed:
RenderState: fixed 'backStencilStencilFailOperation' field serializat… by @Ali-RS in #1719
LwjglWindow:assign new thread to mainThread field. by @Ali-RS in #1722
Chase cam can rotate fix on re-enable by @tlf30 in #1692
fix and test for issue 1723 (more serialization bugs in RenderState) by @stephengold in #1726
Fix NullPointerException in AnimLayer.update() by @capdevon in #1730
AlAudioRenderer: update OpenAL state when dry filter is re-applied by @stephengold in #1728
Cross-platform fix for issue 1745 (mouse input scaling) by @riccardobl in #1753
Fix error 1280 in MacOS when querying GL_FRAMEBUFFER_SRGB_CAPABLE_EXT by @riccardobl in #1749
Fix issue 1705 (serialize 6 mesh subclasses) by @stephengold in #1754
solve issue #1761 (AssertionError in ALAudioRenderer) by @stephengold in #1762
solve issue #1780 (built-in matdefs/shaders lack core-profile support) by @stephengold in #1781
Fix draw/read buffer selection for framebuffers (FrameBuffer.setTargetIndex(int)) by @riccardobl in #1786
Add toggleable framebuffer mipmaps generation. Fix #1788 by @riccardobl in #1791
work around missing reshape() callbacks from LWJGL v3 (issue #1793) by @stephengold in #1794
JmeSurfaceView: Fixed duplicate app destruction. by @Scrappers-glitch in #1801
solve issue #1798 (filtered scenes are squeezed) by @stephengold in #1812
solve issue #1813 (glTF loader loses keyframes) by @stephengold in #1815
refactor to avoid invoking AppSettings.getBoolean() directly by @stephengold in #1796
JmeSurfaceView: Removed explicit nullifying GlSurfaceView onDestroy by @Scrappers-glitch in #1802
solve issue #1809 (GltfLoader is not thread-safe) by @stephengold in #1810
Fix issue #1839 by @Lukas-Habring in #1840
SettingsDialog: LAF fix by @Scrappers-glitch in #1827
Fix #1843 (java.util.zip.ZipException in HttpZipLocator) by @Ali-RS in #1842
Fix #1850 (JmeSystem.writeImageFile() throw java.nio.BufferUnderflowE… by @Ali-RS in #1851
Fix: make the stencil test functions usable. by @zzuegg in #1866
Fix #1871 (vertex colors not loaded in gltf models) by @tonihele in #1873
Fix #1867 (LightFilter gets applied even if not needed) by @zzuegg in #1872
Fix #1412 (GltfLoader does not support AO packed in MetallicRoughnessMap) by @manuelrmo in #1880
Fix #1882 (J3MLoader always generates mips ignoring MinFilter) by @Ali-RS in #1884
Made Gltf extension loaders non-static to avoid concurrency issues by @Ali-RS in #1886
Fix #1883 (Image class wrongly setting GL mips flags inside the constructor) by @Ali-RS in #1885
General improvements:
avoid invoking the newly-deprecated BitmapText 2-arg constructor by @stephengold in #1709
rename local variables for clarity by @stephengold in #1715
clarify some non-javadoc comments by @stephengold in #1712
rename method arguments for clarity by @stephengold in #1716
downgrade or delete unnecessary library dependencies by @stephengold in #1714
Test post water 1699 by @bob0bob in #1707
LwjglCanvas: initialize OpenCL for LWJGL2 by @AmiroooTheWalnut in #1720
account for world transform in TerrainQuad.setNormalRecalcNeeded() by @yaRnMcDonuts in #1741
Vector2f: save 2 trig calculations in rotateAroundOrigin() by @stephengold in #1731
Configure circular deps as warning on eclipse by @riccardobl in #1747
GlfwMouseInput: scale mouse coords only if Retina AppSetting is true by @stephengold in #1746
Add simple math methods to Vector3f by @yaRnMcDonuts in #1744
TerrainQuad: publicize fixNormals() by @stephengold in #1738
Add simple math methods to Vector4f by @yaRnMcDonuts in #1755
Add simple math methods to Vector2f by @yaRnMcDonuts in #1756
rename private variables by @stephengold in #1736
rename more method arguments for clarity by @stephengold in #1742
Add set methods and constructors to ColorRGBA that take in a Vector param by @yaRnMcDonuts in #1757
JoyButtonTrigger: clarify that the constructor arg is not an axis ID by @stephengold in #1765
jme3-nifty should account for gamma correction by @stephengold in #1764
TestPostWater: avoid using the deprecated BitmapText constructor by @stephengold in #1766
RenderDeviceJme: CachedTextKey.equals() lacks a type check by @stephengold in #1768
Refactoring of the initialization code of the 'particleMesh' variable. by @capdevon in #1769
InstancedGeometry: added a field to keep track of all instance data b… by @Ali-RS in #1772
avoid use of deprecated methods (mostly Class.newInsta...

New in jMonkeyEngine 3.5.2 (Apr 21, 2022)

New in jMonkeyEngine 3.5.1 (Mar 21, 2022)

New in jMonkeyEngine 3.5.0 (Jan 23, 2022)

New in jMonkeyEngine 3.5.0 Beta 9 (Jan 17, 2022)

New in jMonkeyEngine 3.5.0 Beta 6 (Jan 11, 2022)

New in jMonkeyEngine 3.5.0 Beta 5 (Dec 30, 2021)

New in jMonkeyEngine 3.5.0 Beta 4 (Dec 18, 2021)

Upgrade considerations (potential breaking changes):
explicitly requires Java 8 or higher (issue #1661)
more precise return types for 13 clone() methods (issue #1676, PR #1683)
changed the semantics of FastMath.sphericalToCartesianZ() (issue #1349, PR #1573)
deleted the Weights class, which was deprecated in v3.4 (issue #1620, PR #1632)
protected the no-arg constructor of TransformTrack (PR #1531)
New features:
enhancements to SurfaceView for Android (PR #1650), including:
optional binding to activity lifecycle
added listeners for "layout drawn" and "renderer started"
new DestructionPolicy applied when exiting an activity
add full stack trace and a "copy log" button to the error dialog
added settings for "show error dialog", "exit on Esc pressed", and "show Esc exit prompt"
added the getGlEsVersion() method
determine the maximum supported width for lines (issue #1555, PR #1643)
support for additional compressed texture formats (issue #1619, PR #1621)
texture flipping for certain RGTC formats (PR #1629)
app settings to position the initial window in LWJGL v3 (issue #1668, PR #1670)
a color-adjustment filter (issue #781, PR #1665)
RectangleMesh class for custom quads (PR #1701)
calculateD() and calculateNormal() methods in Rectangle class (PR #1701)
CenterQuad mesh in jme3-core (PR #1704)
added getNbMorphTargets(), setKeyframesWeight(), and setNbMorphTargets() to the MorphTrack class (PR #1608)
made getOffsetTransform() and getAttachmentsNode() accessible to subclasses of Joint (PR #1536)
distinguish ARM macOS/Windows from other platforms (issue #1528, PR #1530)
convert inner class Layer to a top-level class (issue #1566, PR #1656)
Bugs and defects addressed:
LWJGL v3 hangs while creating a window (issues #1193, #1514, and #1558, PR #1690)
Right-to-Left and cursive fonts displayed incorrectly (issue #1158, PR #1685)
incorrect cursor position on macOS with Retina (issue #893, PR #1607)
incorrect VirtualIndexBuffer for a LineLoop mesh (issue #1603, PR #1605)
sphericalToCartesianZ() doesn't reverse cartesianZToSpherical() (issue #1349, PR #1573)
null-pointer exceptions while loading erroneous glTF models:
in GltfLoader.findChildren() (PR #1471)
in SkinningControl.getAttachmentsNode() (issue #1612, PR #1639)
cryptic crash when more than 16 textures are used (issue #37, PR #1574)
fromJmeKeyCode() returns garbage for unknown keys (issue #1596, PR #1638)
serialization bugs:
CartoonEdgeFilter class (issue #1640, PR #1647)
ShaderNodeVariable class (PR #1585)
Torus class (PR #1586)
typos in logger/exception messages (PR #1584, 3beca2b)
General improvements:
upgraded LWJGL to v3.3.0 (PR #1659)
faster asset loading on Android devices (issue #1622, PR #1627)
faster writing of MJPEG files (PR #1592)
more efficient logging (issues #1672 and #1680, PRs #1673 and #1682)
un-deprecate AndroidBufferImageLoader (PR #1660)
javadoc (issues #1648 and #1597; PRs #1581, #1599, #1620, #1642, #1646, #1651, #1653, #1650, #1663, #1666, #1684, #1689, #1698, and #1706; 4db02fa, 8075eeb, ac8696e, e79340a, and f40f21a)
examples and tests (issues #1290, #1630, and #1687; PRs #1570, #1594, #1610, #1625, #1631, #1635, and #1697; 7c5fe46 and 9d8bd88)
New deprecations:
Quaternion.negate() (PR #1702)
BitmapText(BitmapFont font, boolean rightToLeft) (PR #1685)
CenterQuad mesh in jme3-vr (3097f05)

New in jMonkeyEngine 3.4.1 (Dec 6, 2021)

New in jMonkeyEngine 3.4.0 (Nov 15, 2021)

A production-quality release of JMonkeyEngine with the following changes relative to v3.3.2-stable:
Upgrade considerations (a.k.a. potential breaking changes):
Gamma correction is enabled by default. In apps that default the setting (don't explicitly enable/disable it), scenes may appear brighter or darker than expected. (discussion, 6ade1a0)
Vsync is enabled by default. In apps that default the setting (don't explicitly enable/disable it), the frame rate and CPU/GPU usage may be lower than expected. (discussion, f34e660)
Maven artifacts aren't available from JCenter. Obtain them from the Maven Central Repository instead. (issue #1468, discussion)
The "jme3-bullet", "jme3-bullet-native", and "jme-bullet-native-android" libraries (physics using native Bullet) were removed from the Engine. For 3-D physics, use "jme3-jbullet" or Minie. (PR #1474)
The "jme3-blender" library (Blender importer) was removed from the Engine. To import 3-D models from Blender, use glTF as an intermediate format. (discussion, 221acaa)
Setters that had previously been deprecated to no-ops were removed. (PR #1510)
Utility classes that previously could be instantiated were made non-instantiable. (420b959, 1031e03, 145cc1b)
Protected the no-arg constructors for Camera (issue #1461, PR #1464) and InstancedNode (6402aad).
Added range checks to IndexBuffer.put() methods. (issue #1427)
The "jme3-jogl" library (JOGL backend) was removed from the Engine. If you must use JOGL instead of LWJGL, contact JogAmp. (discussion, PRs #1339 and #1368)
The "jme3tools.navigation" package was removed from the "jme3-desktop" library. If you need this package, it's available from the "jMonkeyEngine-Contributions" project. (issue #1430, PR #1450)
New features:
material definitions for physically-based rendering (PBR) of terrain (PR #1478)
map keys for non-US keyboard layouts when using LWJGL v3 (issue #942)
de-saturation for materials based on "Unshaded.j3md" (PR #1449)
embed a JME application in a custom UI design on Android devices (PR #1494)
extensions to JoystickCompatibilityMappings (PR #1483)
flesh out the new animation system:
more getters/setters for Action (PR #1489) and AnimComposer (PR #1376)
a factory class to generate animations programmatically (issue #1453, PR #1507)
incorporate animations into cinematic cutscenes (PR #1508)
more methods to create and manipulate armature masks (issue #1499, PR #1504)
capability to remove morph targets from a Mesh (PR #1378)
enhance the glTF importer:
handle "unlit" materials (PR #1463)
handle URIs (PR #1396)
handle lights defined using the "KHR_lights_punctual" extension (PR #1443)
LWJGL v3 support for Linux-on-ARM and 32-bit Windows (discussion, 6711986)
more ways to look up appstates by ID (a79be13)
LightControl support for spotlights (PR #1466)
combine GlowColor and GlowMap in a single Material (PR #1444)
add fromRGBA255() and chainable setters to the ColorRGBA class (a057a6d, 37f1e7f)
serialize final fields across a network (PR #1505)
more getters/setters for Camera (PR #1492), EnvironmentCamera (issue #1447, PR #1481), and Renderer (PR #1482)
pack ambient-occlusion (AO) data into the metallic roughness map of a PBR material (PR #1403)
handle named groups when importing 3-D models in OBJ format (PR #1369)
a unified mechanism to manage the render targets of a FrameBuffer (PR #1401)
depth-only copy of a FrameBuffer (PR #1400)
performance profiling of render() and postRender() methods (PR #1485)
Bugs addressed:
no sound on Android devices (issue #1239, PR #1475)
inaccurate frame rate when using LWJGL v3 (issue #1455)
LWJGL context restart issues (PR #1526, issues #844 and #1445)
OGRE importer doesn't set the initial pose (issue #1395)
jme3-jbullet depends on unavailable Maven artifacts (PR #1541)
cloning a Joint (issue #1469, PR #1470)
logic error in Transform.interpolateTransforms() (issue #1394)
crashes in TransformTrack.getTranslations() and getRotations() (PR #1532)
crashes while compiling shaders (PRs #1456 and #1458)
crash while importing from glTF (PR #1442)
crash with NegativeArraySizeException (PR #1377)
assertion failure in TouchTrigger.touchHash() (PR #1448)
wrong center location for a spherical LightProbe (PR #1440)
animation uses wrong easing function (PR #1397)
material parameter of type IntArray not set (issue #1564, PR #1565)
incorrect import of UTF-8 data (issue #1436, PR #1437)
unable to locate OpenAL library (issue #1383, PR #1432)
multiple issues involving iOS devices (PR #1473)
multiple issues involving instanced geometries (PRs #1457 and #1467)
gamepad split into 2 input devices (PR #1454)
SSAO interferes with transparent unshaded materials (discussion, PR #1512)
FXAA filter disables transparency (discussion, PR #1517)
can't generate mipmaps for cubemap faces (issue #1222, PR #1409)
bounding-sphere merge yields NaN (issue #1459, PR #1465)
LOD causes terrain patches to disappear (issue #1382, PR #1418)
crash while de-serializing a WireFrustum (issue #1462)
crash in LogicalOggStreamImpl (issue #1244, PR #1480)
crash while cloning a TerrainPatch (issue #1391)
MorphControl doesn't override JmeCloneable/Savable methods (issue #1548, PRs #1549 and #1553)
incomplete serialization of TerrainQuad (PR #1476)
inaccurate de-serialization of DistanceLodCalculator (issue #1381, PR #1385)
checkSetParam() warning while creating sky (issue #1414, PR #1438)
General improvements:
javadoc (issues #1275, #1366, #1370, #1388, #1428; PRs #1373, #1374, #1386, #1429, #1451, #1493, #1511, #1519, #1521, #1522, and #1550)
ported "jme3-examples" apps to the new animation system (issue #1452; PRs #1333, #1487, #1500, #1503, and #1515)
New deprecations:
LightNode class (issue #1033, PR #1042)
com.jme3.anim.Weights class (PR #1523)
15 methods in the FrameBuffer class (PR #1401)

New in jMonkeyEngine 3.5.0 Alpha 1 (Nov 15, 2021)

New in jMonkeyEngine 3.3.2 (Dec 10, 2020)

New in jMonkeyEngine 3.3.2 SDK Preview 1 (Oct 8, 2020)

New in jMonkeyEngine 3.3.0 Beta 1 (Apr 7, 2020)

New in jMonkeyEngine 3.2.1 Build 06.03.2018 (Mar 7, 2018)

New in jMonkeyEngine 3.2.1 (Jan 30, 2018)

New in jMonkeyEngine 3.2.0 Preview (Nov 10, 2017)