JOML Versions Save

A Java math library for OpenGL rendering calculations

1.10.5

1 year ago

Breaking Changes

Rename Matrix4.projViewFromRectangle() to perspectiveOffCenterViewFromRectangle() - (https://github.com/JOML-CI/JOML/commit/8cc09c2b41ccc19c1fd799211038cd8f5cd9fe1a)

Additions

Quaternion.mul(scalar) - (https://github.com/JOML-CI/JOML/issues/316) (https://github.com/JOML-CI/JOML/commit/313e8390f59017831052aadd71f27d2d23e7e6b4)
Matrix2d.getTransposed([int, ]FloatBuffer)/getTransposedFloats() - (https://github.com/JOML-CI/JOML/commit/d99f4f08ee19980151d21a3710f17c8281e8223c)
Matrix3d.getTransposed()/getTransposedFloats() - (https://github.com/JOML-CI/JOML/commit/d99f4f08ee19980151d21a3710f17c8281e8223c)
Matrix3x2d.getTransposed()/getTransposedFloats() - (https://github.com/JOML-CI/JOML/commit/d99f4f08ee19980151d21a3710f17c8281e8223c)
Matrix4d.getTransposed([int, ]FloatBuffer)/getTransposedFloats() - (https://github.com/JOML-CI/JOML/commit/d99f4f08ee19980151d21a3710f17c8281e8223c)

Fixes

Matrix2.mulComponentWise() - Thanks to @TheIceCreamBear (https://github.com/JOML-CI/JOML/issues/310) (https://github.com/JOML-CI/JOML/commit/44177d8329ab824a9a88e118ab17a31c0fe9a692)
Vector2f.round() - Thanks to @xupwup (https://github.com/JOML-CI/JOML/issues/314) (https://github.com/JOML-CI/JOML/commit/be615b3b805a25bc94e6b129f36df60210ff69b5)
Matrix2d.getTransposed(Buffer) - (https://github.com/JOML-CI/JOML/commit/d99f4f08ee19980151d21a3710f17c8281e8223c)
Matrix4x3d.getTransposedFloats(ByteBuffer) - Thanks to @theagentd (https://github.com/JOML-CI/JOML/issues/317) (https://github.com/JOML-CI/JOML/commit/d99f4f08ee19980151d21a3710f17c8281e8223c)

1.10.4

2 years ago

Breaking Changes

Remove non-const methods from Matrix4f/dc interfaces - those were in there by mistake (https://github.com/JOML-CI/JOML/commit/4d3a4f3b3d1914903106b32663e6f7fe6beeb6a6)

Additions

Quaternion.getEulerAnglesZXY() - (https://github.com/JOML-CI/JOML/commit/1c1922fb103f29911cbcbdd2f832966b18d763c7)
Quaternion.getEulerAnglesYXZ() - (https://github.com/JOML-CI/JOML/commit/f5ede558e10972029658e10164118460eeb0bf58)
Matrix4.[set]perspectiveOffCenterFov() - (https://github.com/JOML-CI/JOML/commit/21db7f06b271020611f44d66cbc49bd12eed2f9d, https://github.com/JOML-CI/JOML/commit/82539aec5aff5b05746f3a49c3ae9bd56edd52b5)
Matrix4/4x3.translationRotateInvert() - (https://github.com/JOML-CI/JOML/commit/aad9dfcac29c79240c91602d95bf396966b2819e)
Matrix4.[set]perspectiveOffCenterFovLH() - (https://github.com/JOML-CI/JOML/commit/c88d4da00f3a509af346bd44faa1944f7dc56f99)

Fixes

Intersection.intersect/testSphereSphere() - (https://github.com/JOML-CI/JOML/issues/304) (https://github.com/JOML-CI/JOML/commit/1ba8c57cba70f67ef1315d6abd7e9bd41c2e063f)
Setting matrix properties in Matrix4.negateX/Y/Z() - (https://github.com/JOML-CI/JOML/commit/280d561d900c72c57e7cb5e079a9f06018e5b4ee)
Matrix4x3f.invert(Matrix4f) - m33 element was set to 0.0 instead of 1.0 (https://github.com/JOML-CI/JOML/commit/01ae4f0fef9c2687de24c70f2d20605998b0cf9c)

Miscellaneous

Remove unnecessary local variables and set all matrix fields in Matrix4/4x3.rotateTranslationInternal() - (https://github.com/JOML-CI/JOML/issues/305) (https://github.com/JOML-CI/JOML/commit/489f4392a79109205fe7f6c0ec9636f1a70eecf3)
Enable FAST_MATH path for sin(float) - (https://github.com/JOML-CI/JOML/issues/307) (https://github.com/JOML-CI/JOML/commit/984fae3623ba6c2d5e9e7c4e198cd60858bf0081)
Refactor Matrix4f element accesses to always use getter/accessor method - (https://github.com/JOML-CI/JOML/commit/2ef7a7059f8f39a84cb5bf9a0d14f66209918d63)

1.10.3

2 years ago

Additions

Matrix4.tile(x, y, w, h) - to map a sub-cuboid of a ortho or perspective view (https://github.com/JOML-CI/JOML/commit/676c54385d0896691f3feb21b7dde60203c6c619)
Matrix4x3.mul3x3(elements...) - multiply by specifying individual matrix elements (https://github.com/JOML-CI/JOML/commit/21c14aef85638bd24aa38321e49496da5e6bbf9f)
Matrix3/4x3/4.mapXYZ/...() - doing 90°/180°/270° rotations (and -1 scaling) without using sin/cos (https://github.com/JOML-CI/JOML/commit/c2beed442d0440fe27aa6805616fcbd4fddafc6d, https://github.com/JOML-CI/JOML/commit/f37e8d562eedd2bce5a69bd3ad7ae73bfb088265, https://github.com/JOML-CI/JOML/commit/3ced0b4cc3f1959988a4e5b66d546c1c71037e13, https://github.com/JOML-CI/JOML/commit/1948aa9891b57ed93373213ecf252d47c0ade4fe, https://github.com/JOML-CI/JOML/commit/15b6c1713f8ec25e3fa82b6c9b629f723305d4e6, https://github.com/JOML-CI/JOML/commit/dea2ddbfd943a23c36c3bc6a19bd19a5ce836a9f)
Matrix3/4x3/4.negateX/Y/Z() - (https://github.com/JOML-CI/JOML/commit/b6edd37fae9006edb3e7347bfd277ed79c48d9b3, https://github.com/JOML-CI/JOML/commit/3ced0b4cc3f1959988a4e5b66d546c1c71037e13, https://github.com/JOML-CI/JOML/commit/dea2ddbfd943a23c36c3bc6a19bd19a5ce836a9f)
Matrix3/4x3/4.getEulerAnglesXYZ() - (https://github.com/JOML-CI/JOML/commit/1587fbc03813d3005edf58eb0faea7877920a54e)
Quaternion.getEulerAnglesZYX() - (https://github.com/JOML-CI/JOML/commit/6fe925bdd972d70db997013d935662b8aa526516)

Fixes

Typo in Matrix*Stack.popMatrix() exception message - Thanks to @squid233 (https://github.com/JOML-CI/JOML/pull/303) (https://github.com/JOML-CI/JOML/commit/8d10d9cd4144ce683852702f264e3786e9a9a003)

1.10.2

2 years ago

Breaking Changes

Matrix3dc.getRowColumn() parameter order - (https://github.com/JOML-CI/JOML/pull/285) (https://github.com/JOML-CI/JOML/commit/71addb8a8b98a2679c0e759ed9a10bf79338ec0b)

Additions

FrustumIntersection.testLineSegment() - (https://github.com/JOML-CI/JOML/issues/292) (https://github.com/JOML-CI/JOML/commit/3ca7519c070209867216ce6bf141dc24974ade6c)

Fixes

Matrix.toString() not respecting joml.format.decimals option - (https://github.com/JOML-CI/JOML/commit/b559f052e91beccda9d8b799a3876b450200eaf6)
Matrix3dc.getRowColumn() parameter order - Thanks to @leacoleaco (https://github.com/JOML-CI/JOML/pull/285) (https://github.com/JOML-CI/JOML/commit/71addb8a8b98a2679c0e759ed9a10bf79338ec0b)
Matrix4x3d.setFloats(index, ByteBuffer) not respecting provided index - Thanks to @leacoleaco (https://github.com/JOML-CI/JOML/pull/286) (https://github.com/JOML-CI/JOML/commit/5f59006db34a4ba4898b5d4576a7f4b2acf059d9)

Miscellaneous

Fixes to JavaDocs - (https://github.com/JOML-CI/JOML/commit/32aedaac46b5b4536a02f37951a721e1c156ed6a, https://github.com/JOML-CI/JOML/commit/b8f531c2f318629dbbd744148aa5e8aa749661a7, https://github.com/JOML-CI/JOML/commit/56ebda46ba1871e6d842b0a71b382d7f67c466ac, https://github.com/JOML-CI/JOML/commit/83ff59b479921896b989bb4d018bfbbd86d29bd1)

1.10.1

3 years ago

Additions

Reintroduce Intersectionf/d classes - temporarily moved to joml-primitives in the 1.10.0 release (https://github.com/JOML-CI/JOML/commit/51fd2fe432d3d2b09a11db2ac6a79441be1d1c60)
Matrix4x3.scaleAround() - (https://github.com/JOML-CI/JOML/commit/0b464dcddb8c2fffb7ff68ba7ad0138d957ad055)
Matrix.set(int, Buffer) - (https://github.com/JOML-CI/JOML/issues/281) (https://github.com/JOML-CI/JOML/commit/7fd5da7d2c36c6a9d2383ab52815de020532b94e)

Fixes

Vector4.set(array) - Thanks to @brunesto (https://github.com/JOML-CI/JOML/issues/278) (https://github.com/JOML-CI/JOML/commit/4b002f1ea3b7403fb7fca35b073378622083e714)
Aliasing bug in Matrix4.scaleAround() - (https://github.com/JOML-CI/JOML/commit/130ecb31ff8bd8e20ea3af8c26af99496cb4191c)
Aliasing bug in Matrix4.frustum()/frustumLH() - (https://github.com/JOML-CI/JOML/commit/dceb7e863cee3d91e053b76a17ff4083a24c21cd)
Matrix3x2f.get3x3(buffer) when using sun.misc.Unsafe - Thanks to @nickthecoder (https://github.com/JOML-CI/JOML/issues/280) (https://github.com/JOML-CI/JOML/commit/57bbb1828ad1d04363d0757dec91a0f88b2f82d9)

Miscellaneous

Implement java.lang.Cloneable for all classes - (https://github.com/JOML-CI/JOML/issues/279) (https://github.com/JOML-CI/JOML/commit/223693611854b5c6001533a36a92bf39cef320bf)
Use Math.fma() in Matrix4.project() - (https://github.com/JOML-CI/JOML/commit/23fd272ac941cd133d5fe70bb186df04c4d01598)
Fix JavaDocs of Matrix4(x3).arcball(..., dest) - (https://github.com/JOML-CI/JOML/commit/ffc5962031a37347f5c2bcd4720e87ec5a1ec41c)
Use Math.fma() in more Matrix4f.rotate*() methods - (https://github.com/JOML-CI/JOML/commit/b6f3bf9402614a258997c1f95b58ef70a1f49cbc)

1.10.0

3 years ago

Breaking Changes

Geometry primitives classes and the Intersectionf/d classes have been moved to org.joml:joml-primitives under package org.joml.primitives. The change of package org.joml to org.joml.primitives for these classes was necessary because multiple modules in the Java 9+ module system (Jigsaw) cannot export the same package when one module also depends on the other for that same package. - (https://github.com/JOML-CI/JOML/issues/274) (https://github.com/JOML-CI/JOML/commit/8211a8a80a3b5e3d79ac983d93970e8d2a1dba5e)

Development (including release notes for the changes between 1.9.25 and 1.10.0) of those primitives are continued in the JOML-CI/joml-primitives repository. For this 1.10.0 release, see: https://github.com/JOML-CI/joml-primitives/releases/tag/1.10.0

Additions

Vector2i.div() - Thanks to @EXTER7 (https://github.com/JOML-CI/JOML/pull/253) (https://github.com/JOML-CI/JOML/commit/dc961709010592f1b6c95258be68d707bc45feb3)
Quaternion.equals(delta) - Thanks to @pollend (https://github.com/JOML-CI/JOML/pull/263) (https://github.com/JOML-CI/JOML/commit/9867ebffefbc4cd31b3bbbc62c7b9dabbc4de112)
Math.lerp/biLerp/triLerp() - Thanks to @pollend (https://github.com/JOML-CI/JOML/pull/275) (https://github.com/JOML-CI/JOML/commit/631362a660073e38e21b113aeb3c53cb36575329)
Math.signum() - (https://github.com/JOML-CI/JOML/issues/267) (https://github.com/JOML-CI/JOML/commit/15bb744f75361d63671351402de2735dc3b748cd)
Vector2i(float/double,float/double,RoundingMode) constructor - Thanks to @pollend (https://github.com/JOML-CI/JOML/pull/276) (https://github.com/JOML-CI/JOML/commit/a26ae0347a4b303cb38d47c8b0e6093ff80c7a10)
Matrix3.quadraticFormProduct() - (https://github.com/JOML-CI/JOML/issues/251) (https://github.com/JOML-CI/JOML/commit/5a73b16e6e3c938af256489994721f79b1ff5473)

Fixes

GeometryUtils.bitangent() - Thanks to @Kerai (https://github.com/JOML-CI/JOML/pull/243) (https://github.com/JOML-CI/JOML/commit/3a4dd2d421719ba1e0216fbfa49796b0d212e601)
Creating AxisAngle from identity quaternion - Thanks to @lukehutch (https://github.com/JOML-CI/JOML/issues/255) (https://github.com/JOML-CI/JOML/commit/1627a3241bb079098c8395bb1634661b339cfb21, https://github.com/JOML-CI/JOML/commit/57fb50c82d23e0b9c2a1235baea37d66a1ef28c3)
Parameter aliasing in Matrix4.mulPerspectiveAffine() - Thanks to @Exolothon (https://github.com/JOML-CI/JOML/issues/266) (https://github.com/JOML-CI/JOML/commit/3275f4f2d15979bdfc1bb7ee17fce304356281ff)
Sign in GeometryUtils.perpendicular() - Thanks to @tpietzsch (https://github.com/JOML-CI/JOML/pull/272) (https://github.com/JOML-CI/JOML/commit/1f5082440bf3805ab25ce24720fb54bc7d18c644)
Use sync instead of CAS-seeding with sun.misc.Unsafe in Random - Thanks to @Danjb1 (https://github.com/JOML-CI/JOML/issues/273) (https://github.com/JOML-CI/JOML/commit/407eabd0836cc1e5332d994be10042f052570c9e)
Parameter aliasing in Matrix3x2.scaleAround() - (https://github.com/JOML-CI/JOML/commit/424d180686cbca8253546099c4a788fec4c5afc8)

Miscellaneous

Fix FrustumIntersection JavaDocs - (https://github.com/JOML-CI/JOML/commit/d1361d1aa159273547de89ee0e67e72b8ee95ae4)
Fix documentation of Vector[34][fd].mulAdd() - Thanks to @Runemoro (https://github.com/JOML-CI/JOML/issues/254) (https://github.com/JOML-CI/JOML/commit/d7c73af201ab4f5c3789c7f52d25f6b6988223b5)
Add missing JavaDocs - (https://github.com/JOML-CI/JOML/commit/772b770e7b6f0b26e30ad76bd5d41e241fb9f3b8)

1.9.25

3 years ago

Breaking Changes

Unify AABB/Rectangle intersection test method names - Thanks to @pollend (https://github.com/JOML-CI/JOML/issues/239) (https://github.com/JOML-CI/JOML/pull/240) (https://github.com/JOML-CI/JOML/commit/582daa199f8c1230168ddedd82f392d921ae3b5d)
- rename AABB.test*() to intersects*()
- rename Rectangle.intersects() to intersectsRectangle()
- rename Rectangle.contains() to containsPoint()

Additions

Matrix4.transformTranspose(), Vector4.mulTranspose() - (https://github.com/JOML-CI/JOML/commit/094f9fd49afec20eb3d46b03e16a411c9be2fe4e, https://github.com/JOML-CI/JOML/commit/8e8a5d36009da422119de849cd9d4264f19ea95c)
Matrix4f.setTransposed(array|buffer) - (https://github.com/JOML-CI/JOML/commit/ff6deb5644ec49781264948b879f3f497dc6776e)
Matrix4f.setTransposedFromAddress() - (https://github.com/JOML-CI/JOML/commit/2a523b675885f76f012d561e64a5ba114e606699)
Math.clamp(float|double|int) - Thanks to @pollend (https://github.com/JOML-CI/JOML/pull/233) (https://github.com/JOML-CI/JOML/commit/14033e6c388489b045053099a9fd9231a2bb9200)
AABBi - Thanks to @pollend (https://github.com/JOML-CI/JOML/pull/235) (https://github.com/JOML-CI/JOML/commit/4e35f9b79ab77a4d868b5bdb07fd7bf46b744854)
AABB.set(AABBi/d/f source) - Thanks to @pollend (https://github.com/JOML-CI/JOML/issues/234) (https://github.com/JOML-CI/JOML/pull/238) (https://github.com/JOML-CI/JOML/commit/579f1dea2a5aa943f82eb0d8f109d1ea63ef3dbf)
AABB.isValid(), .validate(), .intersection() - Thanks to @pollend (https://github.com/JOML-CI/JOML/issues/239) (https://github.com/JOML-CI/JOML/pull/240) (https://github.com/JOML-CI/JOML/commit/582daa199f8c1230168ddedd82f392d921ae3b5d)
Expose generic Matrix4.mul() as mul0() - (https://github.com/JOML-CI/JOML/commit/279d1532e5ae95406fce22542b2fdd52f729b862)

Fixes

AxisAngle4.set(Matrix) when identity matrix - (https://github.com/JOML-CI/JOML/commit/9fba2f49a04647f20c9c05cbfff9083bc719076c)
Rectangle.contains(point) - Thanks to @BenjaminAmos (https://github.com/JOML-CI/JOML/issues/227) (https://github.com/JOML-CI/JOML/commit/1cdb432cfa04a21093f59d717f9f0bc25b79074a)
Vector2f/d.perpendicular() - Thanks to @ieperen3039 (https://github.com/JOML-CI/JOML/pull/230) (https://github.com/JOML-CI/JOML/commit/2c119bd6b32a9f4269e9d3ba3c874a59b59a0290)
Rectanglei.writeExternal() writing float instead of int - Thanks to @pollend (https://github.com/JOML-CI/JOML/pull/236) (https://github.com/JOML-CI/JOML/commit/e18d378189710286b808781a6e5b127ac4a0de9c)
Parameter ordering in Quaternion.rotateYXZ() - Thanks to @kBlaszczyk (https://github.com/JOML-CI/JOML/pull/237) (https://github.com/JOML-CI/JOML/commit/6cf938b3635179c377639ddadc54943b0cfce42a)
Intersection.findClosestPointOnRectangle() - Thanks to @defance (https://github.com/JOML-CI/JOML/pull/242) (https://github.com/JOML-CI/JOML/commit/fae6cfa1b9c9b1172600cfdb1214f4e6807bbe1b)

Miscellaneous

Make Matrix4f.rotateXYZ() take a Vector3fc - Thanks to @cry0genic (https://github.com/JOML-CI/JOML/pull/226) (https://github.com/JOML-CI/JOML/commit/b2d980c3859610947f69ef1cac700afbff838304)
Improve performance of Matrix4.set/get(column, row) using Unsafe - (https://github.com/JOML-CI/JOML/commit/3e016d30d6421051623ce3998e1e3e966dedcf0d)
Add -Djoml.forceUnsafe option to force the use of Unsafe in MemUtil - (https://github.com/JOML-CI/JOML/commit/53c02459515ffe6aa17c984388cc39c6484e9d3c)
Improve performance of Matrix3.set/get(column, row) using Unsafe - (https://github.com/JOML-CI/JOML/commit/d024b83d168137f40f119dd4a0d17ae7ae496807)
Do not include sources and gwt xml in Graal build - (https://github.com/JOML-CI/JOML/commit/7fdd55a40ff7c03d8335ad4a97ce233f7d9c2818)
Fix JavaDocs of methods returning this - (https://github.com/JOML-CI/JOML/commit/be76b05929caf39d05be6b500decb018100d7f7c)

1.9.24

4 years ago

Additions

Rectangle methods - Thanks to @pollend (#221, #222) (https://github.com/JOML-CI/JOML/commit/93ecf59d65bb5d1af44d4b60cf4ca67dac3ae658, https://github.com/JOML-CI/JOML/commit/2b3534a3da5110bbdf157b4110e4d789d520b516, https://github.com/JOML-CI/JOML/commit/c710e0c5a10da014f003aee80d17aac1abda3d90, https://github.com/JOML-CI/JOML/commit/86ddf08f4036da3d1aefc93b42b9a8f227fac2fa)
no-args Random constructor - Thanks to @XenoAmess (#224) (https://github.com/JOML-CI/JOML/commit/b79a6cc17287138e36d527fbe58535daed06be23, https://github.com/JOML-CI/JOML/commit/1c1a276489625a1ea0ee06833e4c147500e19e59)
Vector2f/d.div() - (https://github.com/JOML-CI/JOML/commit/fc9a8a1f75546c8c9740c4072275060f90d69b19)

Fixes

switch from microbenchmark-based detection of FMA to toggle - Thanks to @theagentd (#225) (https://github.com/JOML-CI/JOML/commit/0257c39fa0d62ab0e6b0608d31851ef6f19d0ba8)
Intersection.POINT_ON_TRIANGLE_FACE value - Thanks to @Xayton (#223) (https://github.com/JOML-CI/JOML/commit/c8c4ce7bc5e1dc74fe3cf8eb33a8017db1e5d6c6)

1.9.23

4 years ago

Additions

Quaternion/Matrix.isFinite() - (#211) (https://github.com/JOML-CI/JOML/commit/537c93d847e45e16dcc1be5468e600b7e03b42fd)
Math.safeAsin() to handle floating-point inaccuracies - (#217) (https://github.com/JOML-CI/JOML/commit/9aecd42ab0b7d9c0983c90e14cf4e9c440f6d1c8)
Rectangle.scale() - Thanks to @MKMax (#216) (https://github.com/JOML-CI/JOML/commit/761588408ad2c87e7dff03bef99578e63a8f5e8d)

Fixes

Quaternion.rotationTo/rotateTo to handle non-unit vectors - Thanks to @ieperen3039 (#212) (https://github.com/JOML-CI/JOML/commit/27d49aab126042da6ee800bf8e3782b0a910ae1c)
NaN with Quaternion.getEulerAnglesXYZ() - Thanks to @haubna (#217) (https://github.com/JOML-CI/JOML/commit/9aecd42ab0b7d9c0983c90e14cf4e9c440f6d1c8)
Matrix4.transpose() - (since 1.9.21) Thanks to @PS-Soundwave and @pollend - (#218) (#219, #220) (https://github.com/JOML-CI/JOML/commit/93946dcae6308fdc2eefbd315cb275e6461ef97f, https://github.com/JOML-CI/JOML/commit/3a4a59d2de0c58f0dd571e36adf1a7c809d3ac80)
AxisAngle4.toString() - Thanks to @lukehutch (#214) (https://github.com/JOML-CI/JOML/commit/e7edc6207a47d3cdc153a9b9e266e444f57fc7f0)

Miscellaneous

Format NaN/Inf without Unicode characters - (#215) (https://github.com/JOML-CI/JOML/commit/8037c4db231a8c8f239822acc5545e2068984f00)
Improve Matrix4.positive[XYZ]() when orthonormal - (https://github.com/JOML-CI/JOML/commit/95aa6eaeaaa0644f3e64ae372a5519d7e1da8630)

1.9.22

4 years ago

Additions

Quaternion.transformInverse()/transformInverseUnit() - (#209) (https://github.com/JOML-CI/JOML/commit/f7e57f3f8351d03618ce06dd6ad78802761ed057, https://github.com/JOML-CI/JOML/commit/ad7602b0e92c5a06bc53ffe68b27ff842bf99ca3, https://github.com/JOML-CI/JOML/commit/cb8f6c116f8398f594bf1f5da00c4054fe308879)

Fixes

Regression in Vector3f/4f.rotateX/rotateY/rotateZ() and Vector3f.cross() - (since 1.9.21) Thanks to @ieperen3039 for reporting (#210) (https://github.com/JOML-CI/JOML/commit/9edcb4c82997fd050da732f1ac272e96fb6f296b)