@thi.ng/matrices 2.1.77 → 2.2.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-09-25T07:43:28Z
+- **Last updated**: 2023-10-23T07:37:37Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [2.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/matrices@2.2.0) (2023-10-23)
+
+#### 🚀 Features
+
+- add fit23 & fit44() matrix ops ([e2040e1](https://github.com/thi-ng/umbrella/commit/e2040e1))
+
 ### [2.1.22](https://github.com/thi-ng/umbrella/tree/@thi.ng/matrices@2.1.22) (2022-08-16)
 
 #### 🩹 Bug fixes

package/README.md

@@ -82,7 +82,7 @@ For Node.js REPL:
 const matrices = await import("@thi.ng/matrices");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 5.02 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 5.08 KB
 
 ## Dependencies
 
@@ -107,6 +107,7 @@ A selection:
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/scenegraph.png" width="240"/>                    | 2D scenegraph & shape picking                                                                | [Demo](https://demo.thi.ng/umbrella/scenegraph/)         | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/scenegraph)         |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/scenegraph-image.png" width="240"/>              | 2D scenegraph & image map based geometry manipulation                                        | [Demo](https://demo.thi.ng/umbrella/scenegraph-image/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/scenegraph-image)   |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-graph.jpg" width="240"/>                  | Minimal shader graph developed during livestream #2                                          | [Demo](https://demo.thi.ng/umbrella/shader-graph/)       | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-graph)       |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/simd-plot.png" width="240"/>                     | Fitting, transforming & plotting 10k data points per frame using SIMD                        | [Demo](https://demo.thi.ng/umbrella/simd-plot/)          | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/simd-plot)          |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/soa-ecs-100k.png" width="240"/>                  | Entity Component System w/ 100k 3D particles                                                 | [Demo](https://demo.thi.ng/umbrella/soa-ecs/)            | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/soa-ecs)            |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/text-canvas.png" width="240"/>                   | 3D wireframe textmode demo                                                                   | [Demo](https://demo.thi.ng/umbrella/text-canvas/)        | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/text-canvas)        |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/unbiased-normals.png" width="240"/>              | Visual comparison of biased vs. unbiased normal vectors projected on the surface of a sphere | [Demo](https://demo.thi.ng/umbrella/unbiased-normals/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/unbiased-normals)   |
@@ -125,6 +126,7 @@ A selection:
 
 ### Matrix creation
 
+- `fit23` / `fit44`
 - `rotation22` / `rotation23`
 - `rotationAroundAxis33` / `rotationAroundAxis44`
 - `rotationX33` / `rotationX44`

package/fit.d.ts

@@ -0,0 +1,27 @@
+import type { ReadonlyVec } from "@thi.ng/vectors";
+import type { Mat } from "./api.js";
+/**
+ * Creates a 2x3 matrix which maps coordinates from a 2D source rect (defined by
+ * `srcPos` and `srcSize`) to a destination rect (`destPos` & `destSize`).
+ * Writes result matrix to `out` or creates new matrix if `out` is null.
+ *
+ * @param out
+ * @param srcPos
+ * @param srcSize
+ * @param destPos
+ * @param destSize
+ */
+export declare const fit23: (out: Mat | null, srcPos: ReadonlyVec, srcSize: ReadonlyVec, destPos: ReadonlyVec, destSize: ReadonlyVec) => import("@thi.ng/vectors").Vec;
+/**
+ * Creates a 4x4 matrix which maps coordinates from a 3D source AABB (defined by
+ * `srcPos` and `srcSize`) to a destination AABB (`destPos` & `destSize`).
+ * Writes result matrix to `out` or creates new matrix if `out` is null.
+ *
+ * @param out
+ * @param srcPos
+ * @param srcSize
+ * @param destPos
+ * @param destSize
+ */
+export declare const fit44: (out: Mat | null, srcPos: ReadonlyVec, srcSize: ReadonlyVec, destPos: ReadonlyVec, destSize: ReadonlyVec) => import("@thi.ng/vectors").Vec;
+//# sourceMappingURL=fit.d.ts.map

package/fit.js

@@ -0,0 +1,30 @@
+import { maddN2, maddN3 } from "@thi.ng/vectors/maddn";
+import { mulN2 } from "@thi.ng/vectors/muln";
+import { safeDiv2, safeDiv3 } from "@thi.ng/vectors/safe-div";
+import { concat } from "./concat.js";
+import { scale23, scale44 } from "./scale.js";
+import { translation23, translation44 } from "./translation.js";
+/**
+ * Creates a 2x3 matrix which maps coordinates from a 2D source rect (defined by
+ * `srcPos` and `srcSize`) to a destination rect (`destPos` & `destSize`).
+ * Writes result matrix to `out` or creates new matrix if `out` is null.
+ *
+ * @param out
+ * @param srcPos
+ * @param srcSize
+ * @param destPos
+ * @param destSize
+ */
+export const fit23 = (out, srcPos, srcSize, destPos, destSize) => concat(out, translation23(null, maddN2([], destSize, 0.5, destPos)), scale23(null, safeDiv2([], destSize, srcSize)), translation23(null, mulN2(null, maddN2([], srcSize, 0.5, srcPos), -1)));
+/**
+ * Creates a 4x4 matrix which maps coordinates from a 3D source AABB (defined by
+ * `srcPos` and `srcSize`) to a destination AABB (`destPos` & `destSize`).
+ * Writes result matrix to `out` or creates new matrix if `out` is null.
+ *
+ * @param out
+ * @param srcPos
+ * @param srcSize
+ * @param destPos
+ * @param destSize
+ */
+export const fit44 = (out, srcPos, srcSize, destPos, destSize) => concat(out, translation44(null, maddN3([], destSize, 0.5, destPos)), scale44(null, safeDiv3([], destSize, srcSize)), translation44(null, mulN2(null, maddN3([], srcSize, 0.5, srcPos), -1)));

package/index.d.ts

@@ -11,6 +11,7 @@ export * from "./determinant.js";
 export * from "./diag.js";
 export * from "./div.js";
 export * from "./divn.js";
+export * from "./fit.js";
 export * from "./frustum.js";
 export * from "./identity.js";
 export * from "./invert.js";

package/index.js

@@ -11,6 +11,7 @@ export * from "./determinant.js";
 export * from "./diag.js";
 export * from "./div.js";
 export * from "./divn.js";
+export * from "./fit.js";
 export * from "./frustum.js";
 export * from "./identity.js";
 export * from "./invert.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/matrices",
-  "version": "2.1.77",
+  "version": "2.2.0",
   "description": "Matrix & quaternion operations for 2D/3D geometry processing",
   "type": "module",
   "module": "./index.js",
@@ -34,17 +34,17 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.5",
-    "@thi.ng/checks": "^3.4.5",
-    "@thi.ng/math": "^5.6.2",
-    "@thi.ng/vectors": "^7.7.19"
+    "@thi.ng/api": "^8.9.6",
+    "@thi.ng/checks": "^3.4.6",
+    "@thi.ng/math": "^5.6.3",
+    "@thi.ng/vectors": "^7.7.20"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.36.4",
-    "@thi.ng/testament": "^0.3.23",
-    "rimraf": "^5.0.1",
+    "@microsoft/api-extractor": "^7.38.0",
+    "@thi.ng/testament": "^0.3.24",
+    "rimraf": "^5.0.5",
     "tools": "^0.0.1",
-    "typedoc": "^0.25.0",
+    "typedoc": "^0.25.2",
     "typescript": "^5.2.2"
   },
   "keywords": [
@@ -130,6 +130,9 @@
     "./divn": {
       "default": "./divn.js"
     },
+    "./fit": {
+      "default": "./fit.js"
+    },
     "./frustum": {
       "default": "./frustum.js"
     },
@@ -269,5 +272,5 @@
     ],
     "year": 2018
   },
-  "gitHead": "46e445c09f2909d1aeaa9fdc8d8b3aa61c114db2\n"
+  "gitHead": "8d46d9326a9f9b81d65e7e274446f5964f9942ac\n"
 }