Add option to disable auto rescale

Update CHANGES.md.
Update the documentation.

Author: TiagoCavalcante

CHANGES.md

@@ -7,6 +7,7 @@ dev
 Improvements:
 - Update three.js to r138 (#96)
 - Add support to smartphones (#97)
+- Add option to disable `autoRescale` (#100)
 
 Internals:
 - Rename branch master to main

docs/documentation.md

@@ -30,6 +30,7 @@ You can use mathics-threejs-backend in 2 ways:
 The main function of mathics-threejs-backend is `drawGraphics3d`, takes the following arguments:
 - `container` (type: HTMLElement)
 - `data` (type: object) — object with the following properties:
+  - `autoRescale` (type: bool) — whether the plot should be rescaled after spin. Default: `true`
   - `axes` (type: object) — default: `{}`, object with the following properties:
     - `hasaxes` (type: bool\|bool[3]) — default: `false`
     - `ticks` (type: [number[], number[], string[]][3]) — array containing the ticks' information for, respectively, x, y and z axes. The ticks' information is an array of three elements: big ticks' 0-1 coordinates, small ticks' 0-1 coordinates, big ticks' labels. Default: `[]`
@@ -47,6 +48,8 @@ The main function of mathics-threejs-backend is `drawGraphics3d`, takes the foll
   - `protocol` (type: string) — protocol version (current is `1.2`), if it isn't compatible a warning is shown instead of the graphics. Only availiable in production version
 - `maxSize` (type: number) — default: `400`
 - `innerWidthMultiplier` (type: number) — the multiplier of the window inner width, the effective width is `min(maxSize, innerWidthMultiplier * window.innerWidth)`, default: `0.65`
+- `config` (type: object) — object with the following properties:
+  - `autoRescale` (type: bool) — default: `true`
 
 ## Examples
 - ```js

src/graphics3d.js

@@ -25,7 +25,8 @@ export default function (
 		viewpoint = [1.3, -2.4, 2]
 	},
 	maxSize = 400,
-	innerWidthMultiplier = 0.65
+	innerWidthMultiplier = 0.65,
+	{ autoRescale = true } = { autoRescale: true }
 ) {
 	axes.hasaxes ??= false;
 	extent ??= calculateExtent(elements);
@@ -41,8 +42,7 @@ export default function (
 		phi,
 		onMouseDownPhi,
 		onTouchStartFingersDistance,
-		canvasSize = Math.min(maxSize, window.innerWidth * innerWidthMultiplier),
-		autoRescale = true;
+		canvasSize = Math.min(maxSize, window.innerWidth * innerWidthMultiplier);
 
 	const onMouseDownPosition = new Int16Array(2);
 

src/index.js

@@ -1,6 +1,6 @@
 import drawGraphics3d from './graphics3d.js';
 
-function translationLayer(container, object, maxSize, innerWidthMultiplier) {
+function translationLayer(container, object, maxSize, innerWidthMultiplier, config) {
 	if (object.protocol) {
 		// protocol version is X.Y, so it is an array of two elements: major version and minor version
 		const versionArray = object.protocol.match(/\d/g);
@@ -38,7 +38,7 @@ function translationLayer(container, object, maxSize, innerWidthMultiplier) {
 		light.type = light.type.toLowerCase();
 	});
 
-	return drawGraphics3d(container, object, maxSize, innerWidthMultiplier);
+	return drawGraphics3d(container, object, maxSize, innerWidthMultiplier, config);
 }
 
 window.drawGraphics3d = translationLayer;