jsxgraph 1.4.0 → 1.4.3

package/src/math/numerics.js

@@ -1,5 +1,5 @@
 /*
-    Copyright 2008-2021
+    Copyright 2008-2022
         Matthias Ehmann,
         Michael Gerhaeuser,
         Carsten Miller,
@@ -31,6 +31,7 @@
 
 /*global JXG: true, define: true*/
 /*jslint nomen: true, plusplus: true*/
+/*eslint no-loss-of-precision: off */
 
 /* depends:
  utils/type

package/src/math/plot.js

@@ -1,5 +1,5 @@
 /*
-    Copyright 2008-2021
+    Copyright 2008-2022
         Matthias Ehmann,
         Michael Gerhaeuser,
         Carsten Miller,
@@ -457,7 +457,7 @@ define(['jxg', 'base/constants', 'base/coords', 'math/math', 'math/extrapolate',
                 vy = curve.Y(t_real, true) ;
                 vy2 = curve.Y(t_real2, true) ;
                 dy = (vy - vy2) / (t_real - t_real2);
-               
+
                 if (p_good !== null) {
                     this._insertPoint_v2(curve, new Coords(Const.COORDS_BY_USER, p_good, curve.board, false));
                     return true;
@@ -1016,7 +1016,7 @@ define(['jxg', 'base/constants', 'base/coords', 'math/math', 'math/extrapolate',
         },
 
         /**
-         * 
+         *
          * @param {JXG.Curve} curve JSXGraph curve element
          * @param {Number} ta
          * @param {Number} tb
@@ -1959,7 +1959,7 @@ console.log("Polynomial of degree", level);
                 dx, dy;
 
             //console.log("Level", level)
-            if (level == 0) {
+            if (level === 0) {
                 this._insertPoint_v4(curve, [1, NaN, NaN], t);
                 return;
             }

package/src/math/poly.js

@@ -1,5 +1,5 @@
 /*
-    Copyright 2008-2021
+    Copyright 2008-2022
         Matthias Ehmann,
         Michael Gerhaeuser,
         Carsten Miller,

package/src/math/probfuncs.js

@@ -1,5 +1,5 @@
 /*
-    Copyright 2008-2021
+    Copyright 2008-2022
         Matthias Ehmann,
         Carsten Miller,
         Andreas Walter,
@@ -30,6 +30,7 @@
 
 /*global JXG: true, define: true*/
 /*jslint nomen: true, plusplus: true*/
+/*eslint no-loss-of-precision: off */
 
 /* depends:
  jxg

package/src/math/qdt.js

@@ -1,5 +1,5 @@
 /*
-    Copyright 2008-2021
+    Copyright 2008-2022
         Matthias Ehmann,
         Michael Gerhaeuser,
         Carsten Miller,
@@ -10,20 +10,20 @@
     This file is part of JSXGraph.
 
     JSXGraph is free software dual licensed under the GNU LGPL or MIT License.
-    
+
     You can redistribute it and/or modify it under the terms of the
-    
+
       * GNU Lesser General Public License as published by
         the Free Software Foundation, either version 3 of the License, or
         (at your option) any later version
       OR
       * MIT License: https://github.com/jsxgraph/jsxgraph/blob/master/LICENSE.MIT
-    
+
     JSXGraph is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU Lesser General Public License for more details.
-    
+
     You should have received a copy of the GNU Lesser General Public License and
     the MIT License along with JSXGraph. If not, see <http://www.gnu.org/licenses/>
     and <http://opensource.org/licenses/MIT/>.
@@ -44,7 +44,7 @@ define(['math/math', 'utils/type'], function (Mat, Type) {
 
     /**
      * Instantiate a new quad tree.
-     * 
+     *
      * @name JXG.Math.Quadtree
      * @exports Mat.Quadtree as JXG.Math.Quadtree
      * @param {Array} bbox Bounding box of the new quad (sub)tree.
@@ -90,7 +90,7 @@ define(['math/math', 'utils/type'], function (Mat, Type) {
          * @type JXG.Math.Quadtree
          */
         this.southEast = null;
-        
+
         /**
          * In a subdivided quad tree this represents the bottom left subtree.
          * @name JXG.Math.Quadtree#southWest
@@ -155,10 +155,10 @@ define(['math/math', 'utils/type'], function (Mat, Type) {
                 mx = this.xlb + (this.xub - this.xlb) / 2,
                 my = this.ylb + (this.yub - this.ylb) / 2;
 
-            this.northWest = new Quadtree([this.xlb, this.yub, mx, my]);
-            this.northEast = new Quadtree([mx, this.yub, this.xub, my]);
-            this.southEast = new Quadtree([this.xlb, my, mx, this.ylb]);
-            this.southWest = new Quadtree([mx, my, this.xub, this.ylb]);
+            this.northWest = new Mat.Quadtree([this.xlb, this.yub, mx, my]);
+            this.northEast = new Mat.Quadtree([mx, this.yub, this.xub, my]);
+            this.southEast = new Mat.Quadtree([this.xlb, my, mx, this.ylb]);
+            this.southWest = new Mat.Quadtree([mx, my, this.xub, this.ylb]);
 
             for (i = 0; i < l; i += 1) {
                 this.northWest.insert(this.points[i]);

package/src/math/statistics.js

@@ -1,5 +1,5 @@
 /*
-    Copyright 2008-2021
+    Copyright 2008-2022
         Matthias Ehmann,
         Michael Gerhaeuser,
         Carsten Miller,
@@ -131,10 +131,10 @@ define(['jxg', 'math/math', 'utils/type'], function (JXG, Mat, Type) {
         },
 
         /**
-         * The P-th percentile ( 0 < P ≤ 100 ) of a list of N ordered values (sorted from least to greatest) 
-         * is the smallest value in the list such that no more than P percent of the data is strictly less 
+         * The P-th percentile ( 0 < P ≤ 100 ) of a list of N ordered values (sorted from least to greatest)
+         * is the smallest value in the list such that no more than P percent of the data is strictly less
          * than the value and at least P percent of the data is less than or equal to that value. See {@link https://en.wikipedia.org/wiki/Percentile}.
-         * 
+         *
          * Here, the <i>linear interpolation between closest ranks</i> method is used.
          * @param {Array} arr The set of values, need not be ordered.
          * @param {Number|Array} percentile One or several percentiles
@@ -285,7 +285,7 @@ define(['jxg', 'math/math', 'utils/type'], function (JXG, Mat, Type) {
                 } else {
                     len = arr.length;
                     res = [];
-    
+
                     for (i = 0; i < len; i++) {
                         res[i] = Math.abs(arr[i]);
                     }
@@ -540,7 +540,7 @@ define(['jxg', 'math/math', 'utils/type'], function (JXG, Mat, Type) {
          *     () => JXG.Math.Statistics.TheilSenRegression(a.map(el => el.coords))
          *   ],
          *   {strokeWidth:1, strokeColor:'black'});
-         * 
+         *
          * </pre><div id="JXG0a28be85-91c5-44d3-aae6-114e81217cf0" class="jxgbox" style="width: 300px; height: 300px;"></div>
          * <script type="text/javascript">
          *     (function() {
@@ -551,16 +551,16 @@ define(['jxg', 'math/math', 'utils/type'], function (JXG, Mat, Type) {
          *     a[0]=board.create('point', [0,0]);
          *     a[1]=board.create('point', [3,0]);
          *     a[2]=board.create('point', [0,3]);
-         *     
+         *
          *     board.create('line', [
          *         () => JXG.Math.Statistics.TheilSenRegression(a.map(el => el.coords))
          *       ],
          *       {strokeWidth:1, strokeColor:'black'});
-         * 
+         *
          *     })();
-         * 
+         *
          * </script><pre>
-         * 
+         *
          */
         TheilSenRegression: function (coords) {
             var i, j,

package/src/math/symbolic.js

@@ -1,5 +1,5 @@
 /*
-    Copyright 2008-2021
+    Copyright 2008-2022
         Matthias Ehmann,
         Michael Gerhaeuser,
         Carsten Miller,

package/src/options.js

@@ -1,5 +1,5 @@
 /*
-    Copyright 2008-2021
+    Copyright 2008-2022
         Matthias Ehmann,
         Michael Gerhaeuser,
         Carsten Miller,
@@ -360,7 +360,7 @@ define([
              * @type Object
              */
             fullscreen: {
-                symbol: '\u26f6', // '\u25a1'
+                symbol: '\u25a1', // '\u26f6' (not supported by MacOS), // '\u25a1'
                 id: null
             },
 
@@ -546,13 +546,13 @@ define([
              *   factorY: 1.25,  // vertical zoom factor (multiplied to {@link JXG.Board#zoomY})
              *   wheel: true,     // allow zooming by mouse wheel or
              *   				   // by pinch-to-toom gesture on touch devices
-             *   needShift: true, // mouse wheel zooming needs pressing of the shift key
-             *   min: 0.001        // minimal values of {@link JXG.Board#zoomX} and {@link JXG.Board#zoomY}, limits zoomOut
-             *   max: 1000.0       // maximal values of {@link JXG.Board#zoomX} and {@link JXG.Board#zoomY}, limits zoomIn
+             *   needShift: true,   // mouse wheel zooming needs pressing of the shift key
+             *   min: 0.001,        // minimal values of {@link JXG.Board#zoomX} and {@link JXG.Board#zoomY}, limits zoomOut
+             *   max: 1000.0,       // maximal values of {@link JXG.Board#zoomX} and {@link JXG.Board#zoomY}, limits zoomIn
              *
-             *   pinchHorizontal: true // Allow pinch-to-zoom to zoom only horizontal axis
-             *   pinchVertical: true   // Allow pinch-to-zoom to zoom only vertical axis
-             *   pinchSensitivity: 7   // Sensitivity (in degrees) for recognizing horizontal or vertical pinch-to-zoom gestures.
+             *   pinchHorizontal: true, // Allow pinch-to-zoom to zoom only horizontal axis
+             *   pinchVertical: true,   // Allow pinch-to-zoom to zoom only vertical axis
+             *   pinchSensitivity: 7    // Sensitivity (in degrees) for recognizing horizontal or vertical pinch-to-zoom gestures.
              * }
              * </pre>
              *
@@ -652,11 +652,11 @@ define([
              *             panCtrl: false
              *         }
              *     });
-             * 
+             *
              *     })();
-             * 
+             *
              * </script><pre>
-             * 
+             *
              *
              * @see JXG.Board#keyDownListener
              * @see JXG.Board#keyFocusInListener
@@ -704,11 +704,11 @@ define([
              *             axis: true,
              *             resize: {enabled: true, throttle: 200}
              *         });
-             * 
+             *
              *     })();
-             * 
+             *
              * </script><pre>
-             * 
+             *
              *
              */
             resize: {
@@ -753,11 +753,11 @@ define([
              *             axis: true,
              *             moveTarget: document
              *         });
-             * 
+             *
              *     })();
-             * 
+             *
              * </script><pre>
-             * 
+             *
              *
              */
             moveTarget: null,
@@ -783,6 +783,10 @@ define([
              *   visible: false      // Initial visibility. Should be set to false always
              * }
              * </pre>
+             * <p>
+             * Board events triggered by selection manipulation:
+             * 'startselecting', 'stopselecting', 'mousestartselecting', 'mousestopselecting',
+             * 'pointerstartselecting', 'pointerstopselecting', 'touchstartselecting', 'touchstopselecting'.
              *
              * @example
              * board.on('stopselecting', function(){
@@ -796,14 +800,10 @@ define([
              * });
              *
              * @name JXG.Board#selection
-             * @see JXG.Board#startselecting
-             * @see JXG.Board#stopselecting
-             * @see JXG.Board#mousestartselecting
-             * @see JXG.Board#pointerstartselecting
-             * @see JXG.Board#touchstartselecting
-             * @see JXG.Board#mousestopselecting
-             * @see JXG.Board#pointerstopselecting
-             * @see JXG.Board#touchstopselecting
+             *
+             * @see JXG.Board#startSelectionMode
+             * @see JXG.Board#stopSelectionMode
+             *
              * @type Object
              * @default
              */
@@ -1488,7 +1488,20 @@ define([
              */
             isLabel: false,
 
-
+            /**
+             * Controls if an element can get the focus with the tab key.
+             * See <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex">descriptiona at MDN</a>.
+             * The additional value null completely disables focus of an element.
+             * The value will be ignored if keyboard control of the board is not enabled or
+             * the element is fixed or not visible.
+             *
+             * @name JXG.GeometryElement#tabindex
+             * @type Number
+             * @default 0
+             * @see JXG.Board#keyboard
+             * @see JXG.GeometryElement#fixed
+             * @see JXG.GeometryElement#visible
+             */
             tabindex: 0
 
             // close the meta tag
@@ -1588,9 +1601,9 @@ define([
             *             }
             *         },
             *     });
-            * 
+            *
             *     })();
-            * 
+            *
             * </script><pre>
             *
             * @name Ticks#beautifulScientificTickLabels
@@ -1757,14 +1770,28 @@ define([
 
             /**
              * If a label exceeds {@link Ticks#maxLabelLength} this determines the precision used to shorten the tick label.
+             * Replaced by the digits attribute.
              *
              * @type Number
              * @name Ticks#precision
              * @see Ticks#maxLabelLength
+             * @see Ticks#digits
+             * @deprecated
              * @default 3
              */
             precision: 3,
 
+            /**
+             * If a label exceeds {@link Ticks#maxLabelLength} this determines the number of digits used to shorten the tick label.
+             *
+             * @type Number
+             * @name Ticks#digits
+             * @see Ticks#maxLabelLength
+             * @deprecated
+             * @default 3
+             */
+            digits: 3,
+
             /**
              * The default distance between two ticks. Please be aware that this value does not have
              * to be used if {@link Ticks#insertTicks} is set to true.
@@ -2509,7 +2536,7 @@ define([
                 strokeColor: Color.palette.red,
                 highlightFillColor: '#c3d9ff',
                 highlightStrokeColor: '#c3d9ff',
-    
+
                 name: ''
             },
 
@@ -4054,7 +4081,7 @@ define([
             snatchDistance: 0.0,
 
             /**
-             * If set to true, the point will snap to a grid of integer multiples of 
+             * If set to true, the point will snap to a grid of integer multiples of
              * {@link Point#snapSizeX} and {@link Point#snapSizeY} (in user coordinates).
              * <p>
              * The coordinates of the grid points are either integer multiples of snapSizeX and snapSizeY
@@ -4536,13 +4563,27 @@ define([
 
             /**
              * The precision of the slider value displayed in the optional text.
+             * Replaced by the attribute "digits".
+             *
              * @memberOf Slider.prototype
              * @name precision
              * @type Number
+             * @deprecated
+             * @see Slider#digits
              * @default 2
              */
             precision: 2,
 
+            /**
+             * The number of digits of the slider value displayed in the optional text.
+             *
+             * @memberOf Slider.prototype
+             * @name digits
+             * @type Number
+             * @default 2
+             */
+            digits: 2,
+
             firstArrow: false,
             lastArrow: false,
 
@@ -4660,6 +4701,7 @@ define([
                 visible: 'inherit',
                 fixed: true,
                 scalable: false,
+                tabindex: null,
                 name: '',
                 strokeWidth: 1,
                 strokeColor: '#000000',
@@ -4678,7 +4720,7 @@ define([
 
                 // Label drawing
                 drawLabels: false,
-                precision: 2,
+                digits: 2,
                 includeBoundaries: 1,
                 drawZero: true,
                 label: {
@@ -4709,6 +4751,7 @@ define([
                 strokeWidth: 3,
                 visible: 'inherit',
                 fixed: true,
+                tabindex: null,
                 name: '',
                 strokeColor: '#000000',
                 highlightStrokeColor: '#888888'
@@ -4949,13 +4992,26 @@ define([
 
             /**
              * The precision of the tape measure value displayed in the optional text.
+             * Replaced by the attribute digits
+             *
              * @memberOf Tapemeasure.prototype
              * @name precision
              * @type Number
+             * @deprecated
+             * @see Tapemeasure#digits
              * @default 2
              */
             precision: 2,
 
+            /**
+             * The precision of the tape measure value displayed in the optional text.
+             * @memberOf Tapemeasure.prototype
+             * @name precision
+             * @type Number
+             * @default 2
+             */
+            digits: 2,
+
             /**
              * Attributes for first helper point defining the tape measure position.
              *
@@ -5067,11 +5123,11 @@ define([
              *         var board = JXG.JSXGraph.initBoard('JXG2da7e972-ac62-416b-a94b-32559c9ec9f9',
              *             {boundingbox: [-8, 8, 8,-8], axis: true, showcopyright: false, shownavigation: false});
              *     var txt = board.create('text', [2, 2, "hello"], {fontSize: 8, fontUnit: 'vmin'});
-             * 
+             *
              *     })();
-             * 
+             *
              * </script><pre>
-             * 
+             *
              */
             fontUnit: 'px',
 
@@ -5473,7 +5529,7 @@ define([
              * text1 = board.create('text', [5, 1, function(){
              *             return '\\(a(t)= { 1 \\over ' + a.Value().toFixed(3) + '}\\)';
              *         }], {fontSize: 15, fixed:true, strokeColor:'red', anchorY: 'top', parse: false});
-             * 
+             *
              * </pre><div id="JXGf8bd01db-fb6a-4a5c-9e7f-8823f7aa5ac6" class="jxgbox" style="width: 300px; height: 300px;"></div>
              * <script type="text/javascript">
              *     (function() {
@@ -5485,12 +5541,12 @@ define([
              *         suffixlabel:'\\(t_1=\\)',
              *         unitLabel: ' \\(\\text{ ms}\\)',
              *         snapWidth:0.01}),
-             *     
+             *
              *     func = board.create('functiongraph',[function(x){return (a.Value()*x*x)}], {strokeColor: "red"});
              *     text1 = board.create('text', [5, 1, function(){
              *                 return '\\(a(t)= { 1 \\over ' + a.Value().toFixed(3) + '}\\)';
              *             }], {fontSize: 15, fixed:true, strokeColor:'red', anchorY: 'top', parse: false});
-             * 
+             *
              *     })();
              *
              * </script><pre>
@@ -5529,7 +5585,7 @@ define([
              * text1 = board.create('text', [5, 1, function(){
              *             return 'a(t)= { 1 \\over ' + a.Value().toFixed(3) + '}';
              *         }], {fontSize: 15, fixed:true, strokeColor:'red', anchorY: 'top'});
-             * 
+             *
              * </pre>
              * <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.13.10/dist/katex.min.css" integrity="sha384-0cCFrwW/0bAk1Z/6IMgIyNU3kfTcNirlObr4WjrUU7+hZeD6ravdYJ3kPWSeC31M" crossorigin="anonymous">
              * <script src="https://cdn.jsdelivr.net/npm/katex@0.13.10/dist/katex.min.js" integrity="sha384-dtFDxK2tSkECx/6302Z4VN2ZRqt6Gis+b1IwCjJPrn0kMYFQT9rbtyQWg5NFWAF7" crossorigin="anonymous"></script>
@@ -5543,12 +5599,12 @@ define([
              *         suffixlabel:'t_1=',
              *         unitLabel: ' \\text{ ms}',
              *         snapWidth:0.01});
-             *     
+             *
              *     func = board.create('functiongraph',[function(x){return (a.Value()*x*x)}], {strokeColor: "red"});
              *     text1 = board.create('text', [5, 1, function(){
              *                 return 'a(t)= { 1 \\over ' + a.Value().toFixed(3) + '}';
              *             }], {fontSize: 15, fixed:true, strokeColor:'red', anchorY: 'top'});
-             * 
+             *
              *     })();
              *
              * </script><pre>

package/src/options3d.js

@@ -0,0 +1,123 @@
+/*global JXG:true, define: true*/
+
+define([
+    'jxg', 'options'
+], function (JXG, Options) {
+
+    "use strict";
+
+    JXG.extend(Options, {
+
+        infobox: {
+            strokeColor: 'black'
+        },
+
+        axes3d: {
+            axesPosition: 'center',  // Possible values: 'center', otherwise: border
+
+            // Main axes
+            xAxis: { visible: true, point2: {name: 'x'}},
+            yAxis: { visible: true, point2: {name: 'y'}},
+            zAxis: { visible: true, point2: {name: 'z'}},
+
+            // Planes
+            xPlaneRear: { visible: true, layer: 0, mesh3d: { layer: 1 } },
+            yPlaneRear: { visible: true, layer: 0, mesh3d: { layer: 1 } },
+            zPlaneRear: { visible: true, layer: 0, mesh3d: { layer: 1 } },
+
+            xPlaneFront: { visible: false, layer: 0, mesh3d: { layer: 1 } },
+            yPlaneFront: { visible: false, layer: 0, mesh3d: { layer: 1 } },
+            zPlaneFront: { visible: false, layer: 0, mesh3d: { layer: 1 } },
+
+            // Axes on the planes
+            xPlaneRearYAxis: {visible: true, strokeColor: '#888888'},
+            xPlaneRearZAxis: {visible: true, strokeColor: '#888888'},
+            xPlaneFrontYAxis: {visible: false, strokeColor: '#888888'},
+            xPlaneFrontZAxis: {visible: false, strokeColor: '#888888'},
+
+            yPlaneRearXAxis: {visible: true, strokeColor: '#888888'},
+            yPlaneRearZAxis: {visible: true, strokeColor: '#888888'},
+            yPlaneFrontXAxis: {visible: false, strokeColor: '#888888'},
+            yPlaneFrontZAxis: {visible: false, strokeColor: '#888888'},
+
+            zPlaneRearXAxis: {visible: true, strokeColor: '#888888'},
+            zPlaneRearYAxis: {visible: true, strokeColor: '#888888'},
+            zPlaneFrontXAxis: {visible: false, strokeColor: '#888888'},
+            zPlaneFrontYAxis: {visible: false, strokeColor: '#888888'}
+
+        },
+
+        axis3d: {
+            highlight: false,
+            strokecolor: 'black',
+            strokeWidth: 1,
+            tabindex: null,
+
+            point1: { visible: false, name: '' },
+            point2: { visible: false, name: '', label: { visible: true } }
+        },
+
+        mesh3d: {
+            strokeWidth: 1,
+            strokeColor: '#9a9a9a',
+            strokeOpacity: 0.6,
+            highlight: false,
+            fillColor: '#9a9a9a',
+            fillOpacity: 0.1,
+            tabindex: null,
+
+            visible: 'inherit'
+        },
+
+        line3d: {
+            strokeWidth: 1,
+            strokeColor: 'black',
+            fixed: true,
+            tabindex: null,
+
+            gradient: 'linear',
+            gradientSecondColor: '#ffffff',
+
+            point1: {visible: false, name: ''},
+            point2: {visible: false, name: ''}
+        },
+
+        plane3d: {
+            strokeWidth: 0,
+            strokeColor: 'black',
+            strokeOpacity: 1,
+            highlight: false,
+            tabindex: null,
+
+            gradient: 'linear',
+            gradientSecondColor: '#ffffff',
+            gradientAngle: Math.PI,
+            fillColor: '#a7a7a7',
+            fillOpacity: 0.6
+        },
+
+        point3d: {
+            strokeWidth: 0,
+            gradient: 'radial',
+            gradientSecondColor: '#555555',
+            fillColor: 'yellow',
+            highlightStrokeColor: '#555555'
+        },
+
+        surface3d: {
+            highlight: false,
+            tabindex: -1,
+            strokeWidth: 1,
+            stepsU: 30,
+            stepsV: 30
+        },
+
+        view3d: {
+            needsRegularUpdate: true
+        }
+
+    });
+
+    return JXG.Options;
+});
+