1 /*
  2     Copyright 2008-2022
  3         Matthias Ehmann,
  4         Michael Gerhaeuser,
  5         Carsten Miller,
  6         Bianca Valentin,
  7         Alfred Wassermann,
  8         Peter Wilfahrt
  9 
 10     This file is part of JSXGraph.
 11 
 12     JSXGraph is free software dual licensed under the GNU LGPL or MIT License.
 13 
 14     You can redistribute it and/or modify it under the terms of the
 15 
 16       * GNU Lesser General Public License as published by
 17         the Free Software Foundation, either version 3 of the License, or
 18         (at your option) any later version
 19       OR
 20       * MIT License: https://github.com/jsxgraph/jsxgraph/blob/master/LICENSE.MIT
 21 
 22     JSXGraph is distributed in the hope that it will be useful,
 23     but WITHOUT ANY WARRANTY; without even the implied warranty of
 24     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 25     GNU Lesser General Public License for more details.
 26 
 27     You should have received a copy of the GNU Lesser General Public License and
 28     the MIT License along with JSXGraph. If not, see <http://www.gnu.org/licenses/>
 29     and <http://opensource.org/licenses/MIT/>.
 30  */
 31 
 32 

 34 
 35 /*jslint nomen: true, plusplus: true*/
 36 
 37 /* depends:
 38  jxg
 39  base/constants
 40  base/coords
 41  options
 42  math/numerics
 43  math/math
 44  math/geometry
 45  math/complex
 46  parser/jessiecode
 47  parser/geonext
 48  utils/color
 49  utils/type
 50  utils/event
 51  utils/env
 52   elements:
 53    transform
 54    point
 55    line
 56    text
 57    grid
 58  */
 59 
 60 /**
 61  * @fileoverview The JXG.Board class is defined in this file. JXG.Board controls all properties and methods
 62  * used to manage a geonext board like managing geometric elements, managing mouse and touch events, etc.
 63  */
 64 
 65 define([
 66     'jxg', 'base/constants', 'base/coords', 'options', 'math/numerics', 'math/math', 'math/geometry', 'math/complex',
 67     'math/statistics',
 68     'parser/jessiecode', 'utils/color', 'utils/type', 'utils/event', 'utils/env',
 69     'base/composition'
 70 ], function (JXG, Const, Coords, Options, Numerics, Mat, Geometry, Complex, Statistics, JessieCode, Color, Type,
 71                 EventEmitter, Env, Composition) {
 72 
 73     'use strict';
 74 
 75     /**
 76      * Constructs a new Board object.
 77      * @class JXG.Board controls all properties and methods used to manage a geonext board like managing geometric
 78      * elements, managing mouse and touch events, etc. You probably don't want to use this constructor directly.
 79      * Please use {@link JXG.JSXGraph.initBoard} to initialize a board.
 80      * @constructor
 81      * @param {String} container The id or reference of the HTML DOM element the board is drawn in. This is usually a HTML div.
 82      * @param {JXG.AbstractRenderer} renderer The reference of a renderer.
 83      * @param {String} id Unique identifier for the board, may be an empty string or null or even undefined.
 84      * @param {JXG.Coords} origin The coordinates where the origin is placed, in user coordinates.
 85      * @param {Number} zoomX Zoom factor in x-axis direction
 86      * @param {Number} zoomY Zoom factor in y-axis direction
 87      * @param {Number} unitX Units in x-axis direction
 88      * @param {Number} unitY Units in y-axis direction
 89      * @param {Number} canvasWidth  The width of canvas
 90      * @param {Number} canvasHeight The height of canvas
 91      * @param {Object} attributes The attributes object given to {@link JXG.JSXGraph.initBoard}
 92      * @borrows JXG.EventEmitter#on as this.on
 93      * @borrows JXG.EventEmitter#off as this.off
 94      * @borrows JXG.EventEmitter#triggerEventHandlers as this.triggerEventHandlers
 95      * @borrows JXG.EventEmitter#eventHandlers as this.eventHandlers
 96      */
 97     JXG.Board = function (container, renderer, id, origin, zoomX, zoomY, unitX, unitY, canvasWidth, canvasHeight, attributes) {
 98         /**
 99          * Board is in no special mode, objects are highlighted on mouse over and objects may be
100          * clicked to start drag&drop.
101          * @type Number
102          * @constant
103          */
104         this.BOARD_MODE_NONE = 0x0000;
105 
106         /**
107          * Board is in drag mode, objects aren't highlighted on mouse over and the object referenced in
108          * {@link JXG.Board#mouse} is updated on mouse movement.
109          * @type Number
110          * @constant
111          * @see JXG.Board#drag_obj
112          */
113         this.BOARD_MODE_DRAG = 0x0001;
114 
115         /**
116          * In this mode a mouse move changes the origin's screen coordinates.
117          * @type Number
118          * @constant
119          */
120         this.BOARD_MODE_MOVE_ORIGIN = 0x0002;
121 
122         /**
123          * Update is made with high quality, e.g. graphs are evaluated at much more points.
124          * @type Number
125          * @constant
126          * @see JXG.Board#updateQuality
127          */
128         this.BOARD_MODE_ZOOM = 0x0011;
129 
130         /**
131          * Update is made with low quality, e.g. graphs are evaluated at a lesser amount of points.
132          * @type Number
133          * @constant
134          * @see JXG.Board#updateQuality
135          */
136         this.BOARD_QUALITY_LOW = 0x1;
137 
138         /**
139          * Update is made with high quality, e.g. graphs are evaluated at much more points.
140          * @type Number
141          * @constant
142          * @see JXG.Board#updateQuality
143          */
144         this.BOARD_QUALITY_HIGH = 0x2;
145 
146         /**
147          * Pointer to the document element containing the board.
148          * @type Object
149          */
150         // Former version:
151         // this.document = attributes.document || document;
152         if (Type.exists(attributes.document) && attributes.document !== false) {
153             this.document = attributes.document;
154         } else if (document !== undefined && Type.isObject(document)) {
155             this.document = document;
156         }
157 
158         /**
159          * The html-id of the html element containing the board.
160          * @type String
161          */
162         this.container = container;
163 
164         /**
165          * Pointer to the html element containing the board.
166          * @type Object
167          */
168         this.containerObj = (Env.isBrowser ? this.document.getElementById(this.container) : null);
169 
170         if (Env.isBrowser && renderer.type !== 'no' && this.containerObj === null) {
171             throw new Error("\nJSXGraph: HTML container element '" + container + "' not found.");
172         }
173 
174         /**
175          * A reference to this boards renderer.
176          * @type JXG.AbstractRenderer
177          * @name JXG.Board#renderer
178          * @private
179          * @ignore
180          */
181         this.renderer = renderer;
182 
183         /**
184          * Grids keeps track of all grids attached to this board.
185          * @type Array
186          * @private
187          */
188         this.grids = [];
189 
190         /**
191          * Some standard options
192          * @type JXG.Options
193          */
194         this.options = Type.deepCopy(Options);
195         this.attr = attributes;
196 
197         /**
198          * Dimension of the board.
199          * @default 2
200          * @type Number
201          */
202         this.dimension = 2;
203 
204         this.jc = new JessieCode();
205         this.jc.use(this);
206 
207         /**
208          * Coordinates of the boards origin. This a object with the two properties
209          * usrCoords and scrCoords. usrCoords always equals [1, 0, 0] and scrCoords
210          * stores the boards origin in homogeneous screen coordinates.
211          * @type Object
212          * @private
213          */
214         this.origin = {};
215         this.origin.usrCoords = [1, 0, 0];
216         this.origin.scrCoords = [1, origin[0], origin[1]];
217 
218         /**
219          * Zoom factor in X direction. It only stores the zoom factor to be able
220          * to get back to 100% in zoom100().
221          * @name JXG.Board.zoomX
222          * @type Number
223          * @private
224          * @ignore
225          */
226         this.zoomX = zoomX;
227 
228         /**
229          * Zoom factor in Y direction. It only stores the zoom factor to be able
230          * to get back to 100% in zoom100().
231          * @name JXG.Board.zoomY
232          * @type Number
233          * @private
234          * @ignore
235          */
236         this.zoomY = zoomY;
237 
238         /**
239          * The number of pixels which represent one unit in user-coordinates in x direction.
240          * @type Number
241          * @private
242          */
243         this.unitX = unitX * this.zoomX;
244 
245         /**
246          * The number of pixels which represent one unit in user-coordinates in y direction.
247          * @type Number
248          * @private
249          */
250         this.unitY = unitY * this.zoomY;
251 
252         /**
253          * Keep aspect ratio if bounding box is set and the width/height ratio differs from the
254          * width/height ratio of the canvas.
255          * @type Boolean
256          * @private
257          */
258         this.keepaspectratio = false;
259 
260         /**
261          * Canvas width.
262          * @type Number
263          * @private
264          */
265         this.canvasWidth = canvasWidth;
266 
267         /**
268          * Canvas Height
269          * @type Number
270          * @private
271          */
272         this.canvasHeight = canvasHeight;
273 
274         // If the given id is not valid, generate an unique id
275         if (Type.exists(id) && id !== '' && Env.isBrowser && !Type.exists(this.document.getElementById(id))) {
276             this.id = id;
277         } else {
278             this.id = this.generateId();
279         }
280 
281         EventEmitter.eventify(this);
282 
283         this.hooks = [];
284 
285         /**
286          * An array containing all other boards that are updated after this board has been updated.
287          * @type Array
288          * @see JXG.Board#addChild
289          * @see JXG.Board#removeChild
290          */
291         this.dependentBoards = [];
292 
293         /**
294          * During the update process this is set to false to prevent an endless loop.
295          * @default false
296          * @type Boolean
297          */
298         this.inUpdate = false;
299 
300         /**
301          * An associative array containing all geometric objects belonging to the board. Key is the id of the object and value is a reference to the object.
302          * @type Object
303          */
304         this.objects = {};
305 
306         /**
307          * An array containing all geometric objects on the board in the order of construction.
308          * @type Array
309          */
310         this.objectsList = [];
311 
312         /**
313          * An associative array containing all groups belonging to the board. Key is the id of the group and value is a reference to the object.
314          * @type Object
315          */
316         this.groups = {};
317 
318         /**
319          * Stores all the objects that are currently running an animation.
320          * @type Object
321          */
322         this.animationObjects = {};
323 
324         /**
325          * An associative array containing all highlighted elements belonging to the board.
326          * @type Object
327          */
328         this.highlightedObjects = {};
329 
330         /**
331          * Number of objects ever created on this board. This includes every object, even invisible and deleted ones.
332          * @type Number
333          */
334         this.numObjects = 0;
335 
336         /**
337          * An associative array to store the objects of the board by name. the name of the object is the key and value is a reference to the object.
338          * @type Object
339          */
340         this.elementsByName = {};
341 
342         /**
343          * The board mode the board is currently in. Possible values are
344          * <ul>
345          * <li>JXG.Board.BOARD_MODE_NONE</li>
346          * <li>JXG.Board.BOARD_MODE_DRAG</li>
347          * <li>JXG.Board.BOARD_MODE_MOVE_ORIGIN</li>
348          * </ul>
349          * @type Number
350          */
351         this.mode = this.BOARD_MODE_NONE;
352 
353         /**
354          * The update quality of the board. In most cases this is set to {@link JXG.Board#BOARD_QUALITY_HIGH}.
355          * If {@link JXG.Board#mode} equals {@link JXG.Board#BOARD_MODE_DRAG} this is set to
356          * {@link JXG.Board#BOARD_QUALITY_LOW} to speed up the update process by e.g. reducing the number of
357          * evaluation points when plotting functions. Possible values are
358          * <ul>
359          * <li>BOARD_QUALITY_LOW</li>
360          * <li>BOARD_QUALITY_HIGH</li>
361          * </ul>
362          * @type Number
363          * @see JXG.Board#mode
364          */
365         this.updateQuality = this.BOARD_QUALITY_HIGH;
366 
367         /**
368          * If true updates are skipped.
369          * @type Boolean
370          */
371         this.isSuspendedRedraw = false;
372 
373         this.calculateSnapSizes();
374 
375         /**
376          * The distance from the mouse to the dragged object in x direction when the user clicked the mouse button.
377          * @type Number
378          * @see JXG.Board#drag_dy
379          * @see JXG.Board#drag_obj
380          */
381         this.drag_dx = 0;
382 
383         /**
384          * The distance from the mouse to the dragged object in y direction when the user clicked the mouse button.
385          * @type Number
386          * @see JXG.Board#drag_dx
387          * @see JXG.Board#drag_obj
388          */
389         this.drag_dy = 0;
390 
391         /**
392          * The last position where a drag event has been fired.
393          * @type Array
394          * @see JXG.Board#moveObject
395          */
396         this.drag_position = [0, 0];
397 
398         /**
399          * References to the object that is dragged with the mouse on the board.
400          * @type JXG.GeometryElement
401          * @see JXG.Board#touches
402          */
403         this.mouse = {};
404 
405         /**
406          * Keeps track on touched elements, like {@link JXG.Board#mouse} does for mouse events.
407          * @type Array
408          * @see JXG.Board#mouse
409          */
410         this.touches = [];
411 
412         /**
413          * A string containing the XML text of the construction.
414          * This is set in {@link JXG.FileReader.parseString}.
415          * Only useful if a construction is read from a GEONExT-, Intergeo-, Geogebra-, or Cinderella-File.
416          * @type String
417          */
418         this.xmlString = '';
419 
420         /**
421          * Cached result of getCoordsTopLeftCorner for touch/mouseMove-Events to save some DOM operations.
422          * @type Array
423          */
424         this.cPos = [];
425 
426         /**
427          * Contains the last time (epoch, msec) since the last touchMove event which was not thrown away or since
428          * touchStart because Android's Webkit browser fires too much of them.
429          * @type Number
430          */
431         this.touchMoveLast = 0;
432 
433         /**
434          * Contains the pointerId of the last touchMove event which was not thrown away or since
435          * touchStart because Android's Webkit browser fires too much of them.
436          * @type Number
437          */
438          this.touchMoveLastId = Infinity;
439 
440         /**
441          * Contains the last time (epoch, msec) since the last getCoordsTopLeftCorner call which was not thrown away.
442          * @type Number
443          */
444         this.positionAccessLast = 0;
445 
446         /**
447          * Collects all elements that triggered a mouse down event.
448          * @type Array
449          */
450         this.downObjects = [];
451 
452         if (this.attr.showcopyright) {
453             this.renderer.displayCopyright(Const.licenseText, parseInt(this.options.text.fontSize, 10));
454         }
455 
456         /**
457          * Full updates are needed after zoom and axis translates. This saves some time during an update.
458          * @default false
459          * @type Boolean
460          */
461         this.needsFullUpdate = false;
462 
463         /**
464          * If reducedUpdate is set to true then only the dragged element and few (e.g. 2) following
465          * elements are updated during mouse move. On mouse up the whole construction is
466          * updated. This enables us to be fast even on very slow devices.
467          * @type Boolean
468          * @default false
469          */
470         this.reducedUpdate = false;
471 
472         /**
473          * The current color blindness deficiency is stored in this property. If color blindness is not emulated
474          * at the moment, it's value is 'none'.
475          */
476         this.currentCBDef = 'none';
477 
478         /**
479          * If GEONExT constructions are displayed, then this property should be set to true.
480          * At the moment there should be no difference. But this may change.
481          * This is set in {@link JXG.GeonextReader.readGeonext}.
482          * @type Boolean
483          * @default false
484          * @see JXG.GeonextReader.readGeonext
485          */
486         this.geonextCompatibilityMode = false;
487 
488         if (this.options.text.useASCIIMathML && translateASCIIMath) {
489             init();
490         } else {
491             this.options.text.useASCIIMathML = false;
492         }
493 
494         /**
495          * A flag which tells if the board registers mouse events.
496          * @type Boolean
497          * @default false
498          */
499         this.hasMouseHandlers = false;
500 
501         /**
502          * A flag which tells if the board registers touch events.
503          * @type Boolean
504          * @default false
505          */
506         this.hasTouchHandlers = false;
507 
508         /**
509          * A flag which stores if the board registered pointer events.
510          * @type Boolean
511          * @default false
512          */
513         this.hasPointerHandlers = false;
514 
515         /**
516          * A flag which tells if the board the JXG.Board#mouseUpListener is currently registered.
517          * @type Boolean
518          * @default false
519          */
520         this.hasMouseUp = false;
521 
522         /**
523          * A flag which tells if the board the JXG.Board#touchEndListener is currently registered.
524          * @type Boolean
525          * @default false
526          */
527         this.hasTouchEnd = false;
528 
529         /**
530          * A flag which tells us if the board has a pointerUp event registered at the moment.
531          * @type Boolean
532          * @default false
533          */
534         this.hasPointerUp = false;
535 
536         /**
537          * Offset for large coords elements like images
538          * @type Array
539          * @private
540          * @default [0, 0]
541          */
542         this._drag_offset = [0, 0];
543 
544         /**
545          * Stores the input device used in the last down or move event.
546          * @type String
547          * @private
548          * @default 'mouse'
549          */
550         this._inputDevice = 'mouse';
551 
552         /**
553          * Keeps a list of pointer devices which are currently touching the screen.
554          * @type Array
555          * @private
556          */
557         this._board_touches = [];
558 
559         /**
560          * A flag which tells us if the board is in the selecting mode
561          * @type Boolean
562          * @default false
563          */
564         this.selectingMode = false;
565 
566         /**
567          * A flag which tells us if the user is selecting
568          * @type Boolean
569          * @default false
570          */
571         this.isSelecting = false;
572 
573         /**
574          * A flag which tells us if the user is scrolling the viewport
575          * @type Boolean
576          * @private
577          * @default false
578          * @see JXG.Board#scrollListener
579          */
580         this._isScrolling = false;
581 
582         /**
583          * A flag which tells us if a resize is in process
584          * @type Boolean
585          * @private
586          * @default false
587          * @see JXG.Board#resizeListener
588          */
589         this._isResizing = false;
590 
591         /**
592          * A bounding box for the selection
593          * @type Array
594          * @default [ [0,0], [0,0] ]
595          */
596         this.selectingBox = [[0, 0], [0, 0]];
597 
598         this.mathLib = Math;        // Math or JXG.Math.IntervalArithmetic
599         this.mathLibJXG = JXG.Math; // JXG.Math or JXG.Math.IntervalArithmetic
600 
601         if (this.attr.registerevents) {
602             this.addEventHandlers();
603         }
604 
605         this.methodMap = {
606             update: 'update',
607             fullUpdate: 'fullUpdate',
608             on: 'on',
609             off: 'off',
610             trigger: 'trigger',
611             setView: 'setBoundingBox',
612             setBoundingBox: 'setBoundingBox',
613             migratePoint: 'migratePoint',
614             colorblind: 'emulateColorblindness',
615             suspendUpdate: 'suspendUpdate',
616             unsuspendUpdate: 'unsuspendUpdate',
617             clearTraces: 'clearTraces',
618             left: 'clickLeftArrow',
619             right: 'clickRightArrow',
620             up: 'clickUpArrow',
621             down: 'clickDownArrow',
622             zoomIn: 'zoomIn',
623             zoomOut: 'zoomOut',
624             zoom100: 'zoom100',
625             zoomElements: 'zoomElements',
626             remove: 'removeObject',
627             removeObject: 'removeObject'
628         };
629     };
630 
631     JXG.extend(JXG.Board.prototype, /** @lends JXG.Board.prototype */ {
632 
633         /**
634          * Generates an unique name for the given object. The result depends on the objects type, if the
635          * object is a {@link JXG.Point}, capital characters are used, if it is of type {@link JXG.Line}
636          * only lower case characters are used. If object is of type {@link JXG.Polygon}, a bunch of lower
637          * case characters prefixed with P_ are used. If object is of type {@link JXG.Circle} the name is
638          * generated using lower case characters. prefixed with k_ is used. In any other case, lower case
639          * chars prefixed with s_ is used.
640          * @param {Object} object Reference of an JXG.GeometryElement that is to be named.
641          * @returns {String} Unique name for the object.
642          */
643         generateName: function (object) {
644             var possibleNames, i,
645                 maxNameLength = this.attr.maxnamelength,
646                 pre = '',
647                 post = '',
648                 indices = [],
649                 name = '';
650 
651             if (object.type === Const.OBJECT_TYPE_TICKS) {
652                 return '';
653             }
654 
655             if (Type.isPoint(object)) {
656                 // points have capital letters
657                 possibleNames = ['', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O',
658                     'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'];
659             } else if (object.type === Const.OBJECT_TYPE_ANGLE) {
660                 possibleNames = ['', 'α', 'β', 'γ', 'δ', 'ε', 'ζ', 'η', 'θ',
661                     'ι', 'κ', 'λ', 'μ', 'ν', 'ξ', 'ο', 'π', 'ρ',
662                     'σ', 'τ', 'υ', 'φ', 'χ', 'ψ', 'ω'];
663             } else {
664                 // all other elements get lowercase labels
665                 possibleNames = ['', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o',
666                     'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z'];
667             }
668 
669             if (!Type.isPoint(object) &&
670                     object.elementClass !== Const.OBJECT_CLASS_LINE &&
671                     object.type !== Const.OBJECT_TYPE_ANGLE) {
672                 if (object.type === Const.OBJECT_TYPE_POLYGON) {
673                     pre = 'P_{';
674                 } else if (object.elementClass === Const.OBJECT_CLASS_CIRCLE) {
675                     pre = 'k_{';
676                 } else if (object.elementClass === Const.OBJECT_CLASS_TEXT) {
677                     pre = 't_{';
678                 } else {
679                     pre = 's_{';
680                 }
681                 post = '}';
682             }
683 
684             for (i = 0; i < maxNameLength; i++) {
685                 indices[i] = 0;
686             }
687 
688             while (indices[maxNameLength - 1] < possibleNames.length) {
689                 for (indices[0] = 1; indices[0] < possibleNames.length; indices[0]++) {
690                     name = pre;
691 
692                     for (i = maxNameLength; i > 0; i--) {
693                         name += possibleNames[indices[i - 1]];
694                     }
695 
696                     if (!Type.exists(this.elementsByName[name + post])) {
697                         return name + post;
698                     }
699 
700                 }
701                 indices[0] = possibleNames.length;
702 
703                 for (i = 1; i < maxNameLength; i++) {
704                     if (indices[i - 1] === possibleNames.length) {
705                         indices[i - 1] = 1;
706                         indices[i] += 1;
707                     }
708                 }
709             }
710 
711             return '';
712         },
713 
714         /**
715          * Generates unique id for a board. The result is randomly generated and prefixed with 'jxgBoard'.
716          * @returns {String} Unique id for a board.
717          */
718         generateId: function () {
719             var r = 1;
720 
721             // as long as we don't have a unique id generate a new one
722             while (Type.exists(JXG.boards['jxgBoard' + r])) {
723                 r = Math.round(Math.random() * 65535);
724             }
725 
726             return ('jxgBoard' + r);
727         },
728 
729         /**
730          * Composes an id for an element. If the ID is empty ('' or null) a new ID is generated, depending on the
731          * object type. As a side effect {@link JXG.Board#numObjects}
732          * is updated.
733          * @param {Object} obj Reference of an geometry object that needs an id.
734          * @param {Number} type Type of the object.
735          * @returns {String} Unique id for an element.
736          */
737         setId: function (obj, type) {
738             var randomNumber,
739                 num = this.numObjects,
740                 elId = obj.id;
741 
742             this.numObjects += 1;
743 
744             // If no id is provided or id is empty string, a new one is chosen
745             if (elId === '' || !Type.exists(elId)) {
746                 elId = this.id + type + num;
747                 while (Type.exists(this.objects[elId])) {
748                     randomNumber = Math.round(Math.random() * 65535);
749                     elId = this.id + type + num + '-' + randomNumber;
750                 }
751             }
752 
753             obj.id = elId;
754             this.objects[elId] = obj;
755             obj._pos = this.objectsList.length;
756             this.objectsList[this.objectsList.length] = obj;
757 
758             return elId;
759         },
760 
761         /**
762          * After construction of the object the visibility is set
763          * and the label is constructed if necessary.
764          * @param {Object} obj The object to add.
765          */
766         finalizeAdding: function (obj) {
767             if (Type.evaluate(obj.visProp.visible) === false) {
768                 this.renderer.display(obj, false);
769             }
770         },
771 
772         finalizeLabel: function (obj) {
773             if (obj.hasLabel &&
774                 !Type.evaluate(obj.label.visProp.islabel) &&
775                 Type.evaluate(obj.label.visProp.visible) === false) {
776                 this.renderer.display(obj.label, false);
777             }
778         },
779 
780         /**********************************************************
781          *
782          * Event Handler helpers
783          *
784          **********************************************************/
785 
786         /**
787          * Returns false if the event has been triggered faster than the maximum frame rate.
788          *
789          * @param {Event} evt Event object given by the browser (unused)
790          * @returns {Boolean} If the event has been triggered faster than the maximum frame rate, false is returned.
791          * @private
792          * @see JXG.Board#pointerMoveListener
793          * @see JXG.Board#touchMoveListener
794          * @see JXG.Board#mouseMoveListener
795          */
796         checkFrameRate: function(evt) {
797             var handleEvt = false,
798                 time = new Date().getTime();
799 
800             if (Type.exists(evt.pointerId) && this.touchMoveLastId !== evt.pointerId) {
801                 handleEvt = true;
802                 this.touchMoveLastId = evt.pointerId;
803             }
804             if (!handleEvt && (time - this.touchMoveLast) * this.attr.maxframerate >= 1000) {
805                 handleEvt = true;
806             }
807             if (handleEvt) {
808                 this.touchMoveLast = time;
809             }
810             return handleEvt;
811         },
812 
813         /**
814          * Calculates mouse coordinates relative to the boards container.
815          * @returns {Array} Array of coordinates relative the boards container top left corner.
816          */
817         getCoordsTopLeftCorner: function () {
818             var cPos, doc, crect,
819                 docElement = this.document.documentElement || this.document.body.parentNode,
820                 docBody = this.document.body,
821                 container = this.containerObj,
822                 // viewport, content,
823                 zoom, o;
824 
825             /**
826              * During drags and origin moves the container element is usually not changed.
827              * Check the position of the upper left corner at most every 1000 msecs
828              */
829             if (this.cPos.length > 0 &&
830                     (this.mode === this.BOARD_MODE_DRAG || this.mode === this.BOARD_MODE_MOVE_ORIGIN ||
831                     (new Date()).getTime() - this.positionAccessLast < 1000)) {
832                 return this.cPos;
833             }
834             this.positionAccessLast = (new Date()).getTime();
835 
836             // Check if getBoundingClientRect exists. If so, use this as this covers *everything*
837             // even CSS3D transformations etc.
838             // Supported by all browsers but IE 6, 7.
839 
840             if (container.getBoundingClientRect) {
841                 crect = container.getBoundingClientRect();
842 
843 
844                 zoom = 1.0;
845                 // Recursively search for zoom style entries.
846                 // This is necessary for reveal.js on webkit.
847                 // It fails if the user does zooming
848                 o = container;
849                 while (o && Type.exists(o.parentNode)) {
850                     if (Type.exists(o.style) && Type.exists(o.style.zoom) && o.style.zoom !== '') {
851                         zoom *= parseFloat(o.style.zoom);
852                     }
853                     o = o.parentNode;
854                 }
855                 cPos = [crect.left * zoom, crect.top * zoom];
856 
857                 // add border width
858                 cPos[0] += Env.getProp(container, 'border-left-width');
859                 cPos[1] += Env.getProp(container, 'border-top-width');
860 
861                 // vml seems to ignore paddings
862                 if (this.renderer.type !== 'vml') {
863                     // add padding
864                     cPos[0] += Env.getProp(container, 'padding-left');
865                     cPos[1] += Env.getProp(container, 'padding-top');
866                 }
867 
868                 this.cPos = cPos.slice();
869                 return this.cPos;
870             }
871 
872             //
873             //  OLD CODE
874             //  IE 6-7 only:
875             //
876             cPos = Env.getOffset(container);
877             doc = this.document.documentElement.ownerDocument;
878 
879             if (!this.containerObj.currentStyle && doc.defaultView) {     // Non IE
880                 // this is for hacks like this one used in wordpress for the admin bar:
881                 // html { margin-top: 28px }
882                 // seems like it doesn't work in IE
883 
884                 cPos[0] += Env.getProp(docElement, 'margin-left');
885                 cPos[1] += Env.getProp(docElement, 'margin-top');
886 
887                 cPos[0] += Env.getProp(docElement, 'border-left-width');
888                 cPos[1] += Env.getProp(docElement, 'border-top-width');
889 
890                 cPos[0] += Env.getProp(docElement, 'padding-left');
891                 cPos[1] += Env.getProp(docElement, 'padding-top');
892             }
893 
894             if (docBody) {
895                 cPos[0] += Env.getProp(docBody, 'left');
896                 cPos[1] += Env.getProp(docBody, 'top');
897             }
898 
899             // Google Translate offers widgets for web authors. These widgets apparently tamper with the clientX
900             // and clientY coordinates of the mouse events. The minified sources seem to be the only publicly
901             // available version so we're doing it the hacky way: Add a fixed offset.


904                 cPos[0] += 10;
905                 cPos[1] += 25;
906             }
907 
908             // add border width
909             cPos[0] += Env.getProp(container, 'border-left-width');
910             cPos[1] += Env.getProp(container, 'border-top-width');
911 
912             // vml seems to ignore paddings
913             if (this.renderer.type !== 'vml') {
914                 // add padding
915                 cPos[0] += Env.getProp(container, 'padding-left');
916                 cPos[1] += Env.getProp(container, 'padding-top');
917             }
918 
919             cPos[0] += this.attr.offsetx;
920             cPos[1] += this.attr.offsety;
921 
922             this.cPos = cPos.slice();
923             return this.cPos;
924         },
925 
926         /**
927          * Get the position of the mouse in screen coordinates, relative to the upper left corner
928          * of the host tag.
929          * @param {Event} e Event object given by the browser.
930          * @param {Number} [i] Only use in case of touch events. This determines which finger to use and should not be set
931          * for mouseevents.
932          * @returns {Array} Contains the mouse coordinates in screen coordinates, ready for {@link JXG.Coords}
933          */
934         getMousePosition: function (e, i) {
935             var cPos = this.getCoordsTopLeftCorner(),
936                 absPos,
937                 v;
938 
939             // Position of cursor using clientX/Y
940             absPos = Env.getPosition(e, i, this.document);
941 
942             /**
943              * In case there has been no down event before.
944              */
945             if (!Type.exists(this.cssTransMat)) {
946                 this.updateCSSTransforms();
947             }
948             // Position relative to the top left corner
949             v = [1, absPos[0] - cPos[0], absPos[1] - cPos[1]];
950             v = Mat.matVecMult(this.cssTransMat, v);
951             v[1] /= v[0];
952             v[2] /= v[0];
953             return [v[1], v[2]];
954 
955             // Method without CSS transformation
956             /*
957              return [absPos[0] - cPos[0], absPos[1] - cPos[1]];
958              */
959         },
960 
961         /**
962          * Initiate moving the origin. This is used in mouseDown and touchStart listeners.
963          * @param {Number} x Current mouse/touch coordinates
964          * @param {Number} y Current mouse/touch coordinates
965          */
966         initMoveOrigin: function (x, y) {
967             this.drag_dx = x - this.origin.scrCoords[1];
968             this.drag_dy = y - this.origin.scrCoords[2];
969 
970             this.mode = this.BOARD_MODE_MOVE_ORIGIN;
971             this.updateQuality = this.BOARD_QUALITY_LOW;
972         },
973 
974         /**
975          * Collects all elements below the current mouse pointer and fulfilling the following constraints:
976          * <ul><li>isDraggable</li><li>visible</li><li>not fixed</li><li>not frozen</li></ul>
977          * @param {Number} x Current mouse/touch coordinates
978          * @param {Number} y current mouse/touch coordinates
979          * @param {Object} evt An event object
980          * @param {String} type What type of event? 'touch', 'mouse' or 'pen'.
981          * @returns {Array} A list of geometric elements.
982          */
983         initMoveObject: function (x, y, evt, type) {
984             var pEl,
985                 el,
986                 collect = [],
987                 offset = [],
988                 haspoint,
989                 len = this.objectsList.length,
990                 dragEl = {visProp: {layer: -10000}};
991 
992             //for (el in this.objects) {
993             for (el = 0; el < len; el++) {
994                 pEl = this.objectsList[el];
995                 haspoint = pEl.hasPoint && pEl.hasPoint(x, y);
996 
997                 if (pEl.visPropCalc.visible && haspoint) {
998                     pEl.triggerEventHandlers([type + 'down', 'down'], [evt]);
999                     this.downObjects.push(pEl);
1000                 }
1001 
1002                 if (haspoint &&
1003                     pEl.isDraggable &&
1004                     pEl.visPropCalc.visible &&
1005                     ((this.geonextCompatibilityMode &&
1006                         (Type.isPoint(pEl) ||
1007                          pEl.elementClass === Const.OBJECT_CLASS_TEXT)
1008                      ) ||
1009                      !this.geonextCompatibilityMode
1010                     ) &&
1011                     !Type.evaluate(pEl.visProp.fixed)
1012                     /*(!pEl.visProp.frozen) &&*/
1013                     ) {
1014 
1015                     // Elements in the highest layer get priority.
1016                     if (pEl.visProp.layer > dragEl.visProp.layer ||
1017                             (pEl.visProp.layer === dragEl.visProp.layer &&
1018                              pEl.lastDragTime.getTime() >= dragEl.lastDragTime.getTime()
1019                             )) {
1020                         // If an element and its label have the focus
1021                         // simultaneously, the element is taken.
1022                         // This only works if we assume that every browser runs
1023                         // through this.objects in the right order, i.e. an element A
1024                         // added before element B turns up here before B does.
1025                         if (!this.attr.ignorelabels ||
1026                             (!Type.exists(dragEl.label) || pEl !== dragEl.label)) {
1027                             dragEl = pEl;
1028                             collect.push(dragEl);
1029 
1030                             // Save offset for large coords elements.
1031                             if (Type.exists(dragEl.coords)) {
1032                                 offset.push(Statistics.subtract(dragEl.coords.scrCoords.slice(1), [x, y]));
1033                             } else {
1034                                 offset.push([0, 0]);
1035                             }
1036 
1037                             // we can't drop out of this loop because of the event handling system
1038                             //if (this.attr.takefirst) {
1039                             //    return collect;
1040                             //}
1041                         }
1042                     }
1043                 }
1044             }
1045 
1046             if (this.attr.drag.enabled && collect.length > 0) {
1047                 this.mode = this.BOARD_MODE_DRAG;
1048             }
1049 
1050             // A one-element array is returned.
1051             if (this.attr.takefirst) {
1052                 collect.length = 1;
1053                 this._drag_offset = offset[0];
1054             } else {
1055                 collect = collect.slice(-1);
1056                 this._drag_offset = offset[offset.length - 1];
1057             }
1058 
1059             if (!this._drag_offset) {
1060                 this._drag_offset = [0, 0];
1061             }
1062 
1063             // Move drag element to the top of the layer
1064             if (this.renderer.type === 'svg' &&
1065                 Type.exists(collect[0]) &&
1066                 Type.evaluate(collect[0].visProp.dragtotopoflayer) &&
1067                 collect.length === 1 &&
1068                 Type.exists(collect[0].rendNode)) {
1069 
1070                 collect[0].rendNode.parentNode.appendChild(collect[0].rendNode);
1071             }
1072 
1073             // Init rotation angle and scale factor for two finger movements
1074             this.previousRotation = 0.0;
1075             this.previousScale = 1.0;
1076 
1077             if (collect.length >= 1) {
1078                 collect[0].highlight(true);
1079                 this.triggerEventHandlers(['mousehit', 'hit'], [evt, collect[0]]);
1080             }
1081 
1082             return collect;
1083         },
1084 
1085         /**
1086          * Moves an object.
1087          * @param {Number} x Coordinate
1088          * @param {Number} y Coordinate
1089          * @param {Object} o The touch object that is dragged: {JXG.Board#mouse} or {JXG.Board#touches}.
1090          * @param {Object} evt The event object.
1091          * @param {String} type Mouse or touch event?
1092          */
1093         moveObject: function (x, y, o, evt, type) {
1094             var newPos = new Coords(Const.COORDS_BY_SCREEN, this.getScrCoordsOfMouse(x, y), this),
1095                 drag,
1096                 dragScrCoords, newDragScrCoords;
1097 
1098             if (!(o && o.obj)) {
1099                 return;
1100             }
1101             drag = o.obj;
1102 
1103             // Save updates for very small movements of coordsElements, see below
1104             if (drag.coords) {
1105                 dragScrCoords = drag.coords.scrCoords.slice();
1106             }
1107 
1108             /*
1109              * Save the position.
1110              */
1111             this.drag_position = [newPos.scrCoords[1], newPos.scrCoords[2]];
1112             this.drag_position = Statistics.add(this.drag_position, this._drag_offset);
1113             //
1114             // We have to distinguish between CoordsElements and other elements like lines.
1115             // The latter need the difference between two move events.
1116             if (Type.exists(drag.coords)) {
1117                 drag.setPositionDirectly(Const.COORDS_BY_SCREEN, this.drag_position);
1118             } else {
1119                 this.displayInfobox(false);
1120                                     // Hide infobox in case the user has touched an intersection point
1121                                     // and drags the underlying line now.
1122 
1123                 if (!isNaN(o.targets[0].Xprev + o.targets[0].Yprev)) {
1124                     drag.setPositionDirectly(Const.COORDS_BY_SCREEN,
1125                         [newPos.scrCoords[1], newPos.scrCoords[2]],
1126                         [o.targets[0].Xprev, o.targets[0].Yprev]
1127                         );
1128                 }
1129                 // Remember the actual position for the next move event. Then we are able to
1130                 // compute the difference vector.
1131                 o.targets[0].Xprev = newPos.scrCoords[1];
1132                 o.targets[0].Yprev = newPos.scrCoords[2];
1133             }
1134             // This may be necessary for some gliders and labels
1135             if (Type.exists(drag.coords)) {
1136                 drag.prepareUpdate().update(false).updateRenderer();
1137                 this.updateInfobox(drag);
1138                 drag.prepareUpdate().update(true).updateRenderer();
1139             }
1140 
1141             if (drag.coords) {
1142                 newDragScrCoords = drag.coords.scrCoords;
1143             }
1144             // No updates for very small movements of coordsElements
1145             if (!drag.coords ||
1146                 dragScrCoords[1] !== newDragScrCoords[1] ||
1147                 dragScrCoords[2] !== newDragScrCoords[2]) {
1148 
1149                 drag.triggerEventHandlers([type + 'drag', 'drag'], [evt]);
1150 
1151                 this.update();
1152             }
1153             drag.highlight(true);
1154             this.triggerEventHandlers(['mousehit', 'hit'], [evt, drag]);
1155 
1156             drag.lastDragTime = new Date();
1157         },
1158 
1159         /**
1160          * Moves elements in multitouch mode.
1161          * @param {Array} p1 x,y coordinates of first touch
1162          * @param {Array} p2 x,y coordinates of second touch
1163          * @param {Object} o The touch object that is dragged: {JXG.Board#touches}.
1164          * @param {Object} evt The event object that lead to this movement.
1165          */
1166         twoFingerMove: function (o, id, evt) {
1167             var drag;
1168 
1169             if (Type.exists(o) && Type.exists(o.obj)) {
1170                 drag = o.obj;
1171             } else {
1172                 return;
1173             }
1174 
1175             if (drag.elementClass === Const.OBJECT_CLASS_LINE ||
1176                 drag.type === Const.OBJECT_TYPE_POLYGON) {
1177                 this.twoFingerTouchObject(o.targets, drag, id);
1178             } else if (drag.elementClass === Const.OBJECT_CLASS_CIRCLE) {
1179                 this.twoFingerTouchCircle(o.targets, drag, id);
1180             }
1181 
1182             if (evt) {
1183                 drag.triggerEventHandlers(['touchdrag', 'drag'], [evt]);
1184             }
1185         },
1186 
1187         /**
1188          * Moves, rotates and scales a line or polygon with two fingers.
1189          * @param {Array} tar Array conatining touch event objects: {JXG.Board#touches.targets}.
1190          * @param {object} drag The object that is dragged:
1191          * @param {Number} id pointerId of the event. In case of old touch event this is emulated.
1192          */
1193         twoFingerTouchObject: function (tar, drag, id) {
1194             var np, op, nd, od,
1195                 d, alpha,
1196                 S, t1, t3, t4, t5,
1197                 ar, i, len,
1198                 fixEl, moveEl, fix;
1199 
1200             if (Type.exists(tar[0]) && Type.exists(tar[1]) &&
1201                 !isNaN(tar[0].Xprev + tar[0].Yprev + tar[1].Xprev + tar[1].Yprev)) {
1202 
1203                 if (id === tar[0].num) {
1204                     fixEl  = tar[1];
1205                     moveEl = tar[0];
1206                 } else {
1207                     fixEl  = tar[0];
1208                     moveEl = tar[1];
1209                 }
1210 
1211                 fix = (new Coords(Const.COORDS_BY_SCREEN, [fixEl.Xprev, fixEl.Yprev], this)).usrCoords;
1212                 // Previous finger position
1213                 op = (new Coords(Const.COORDS_BY_SCREEN, [moveEl.Xprev, moveEl.Yprev], this)).usrCoords;
1214                 // New finger position
1215                 np = (new Coords(Const.COORDS_BY_SCREEN, [moveEl.X, moveEl.Y], this)).usrCoords;
1216 
1217                 // Old and new directions
1218                 od = Mat.crossProduct(fix, op);
1219                 nd = Mat.crossProduct(fix, np);
1220 
1221                 // Intersection between the two directions
1222                 S = Mat.crossProduct(od, nd);
1223 
1224                 // If parallel translate, otherwise rotate
1225                 if (Math.abs(S[0]) < Mat.eps) {
1226                     return;
1227                 }
1228 
1229                 alpha = Geometry.rad(op.slice(1), fix.slice(1), np.slice(1));
1230 
1231                 t1 = this.create('transform', [alpha, [fix[1], fix[2]]], {type: 'rotate'});
1232                 t1.update();
1233 
1234                 if (Type.evaluate(drag.visProp.scalable)) {
1235                     // Scale
1236                     d = Geometry.distance(np, fix) / Geometry.distance(op, fix);
1237 
1238                     t3 = this.create('transform', [-fix[1], -fix[2]], {type: 'translate'});
1239                     t4 = this.create('transform', [d, d], {type: 'scale'});
1240                     t5 = this.create('transform', [fix[1], fix[2]], {type: 'translate'});
1241                     t1.melt(t3).melt(t4).melt(t5);
1242                 }
1243 
1244                 if (drag.elementClass === Const.OBJECT_CLASS_LINE) {
1245                     ar = [];
1246                     if (drag.point1.draggable()) {
1247                         ar.push(drag.point1);
1248                     }
1249                     if (drag.point2.draggable()) {
1250                         ar.push(drag.point2);
1251                     }
1252                     t1.applyOnce(ar);
1253                 } else if (drag.type === Const.OBJECT_TYPE_POLYGON) {
1254                     ar = [];
1255                     len = drag.vertices.length - 1;
1256                     for (i = 0; i < len; ++i) {
1257                         if (drag.vertices[i].draggable()) {
1258                             ar.push(drag.vertices[i]);
1259                         }
1260                     }
1261                     t1.applyOnce(ar);
1262                 }
1263 
1264                 this.update();
1265                 drag.highlight(true);
1266             }
1267         },
1268 
1269         /*
1270          * Moves, rotates and scales a circle with two fingers.
1271          * @param {Array} tar Array conatining touch event objects: {JXG.Board#touches.targets}.
1272          * @param {object} drag The object that is dragged:
1273          * @param {Number} id pointerId of the event. In case of old touch event this is emulated.
1274          */
1275         twoFingerTouchCircle: function (tar, drag, id) {
1276             var fixEl, moveEl, np, op, fix,
1277                 d, alpha, t1, t2, t3, t4;
1278 
1279             if (drag.method === 'pointCircle' || drag.method === 'pointLine') {
1280                 return;
1281             }
1282 
1283             if (Type.exists(tar[0]) && Type.exists(tar[1]) &&
1284                 !isNaN(tar[0].Xprev + tar[0].Yprev + tar[1].Xprev + tar[1].Yprev)) {
1285 
1286                 if (id === tar[0].num) {
1287                     fixEl  = tar[1];
1288                     moveEl = tar[0];
1289                 } else {
1290                     fixEl  = tar[0];
1291                     moveEl = tar[1];
1292                 }
1293 
1294                 fix = (new Coords(Const.COORDS_BY_SCREEN, [fixEl.Xprev, fixEl.Yprev], this)).usrCoords;
1295                 // Previous finger position
1296                 op = (new Coords(Const.COORDS_BY_SCREEN, [moveEl.Xprev, moveEl.Yprev], this)).usrCoords;
1297                 // New finger position
1298                 np = (new Coords(Const.COORDS_BY_SCREEN, [moveEl.X, moveEl.Y], this)).usrCoords;
1299 
1300                 alpha = Geometry.rad(op.slice(1), fix.slice(1), np.slice(1));
1301 
1302                 // Rotate and scale by the movement of the second finger
1303                 t1 = this.create('transform', [-fix[1], -fix[2]], {type: 'translate'});
1304                 t2 = this.create('transform', [alpha], {type: 'rotate'});
1305                 t1.melt(t2);
1306                 if (Type.evaluate(drag.visProp.scalable)) {
1307                     d = Geometry.distance(fix, np) / Geometry.distance(fix, op);
1308                     t3 = this.create('transform', [d, d], {type: 'scale'});
1309                     t1.melt(t3);
1310                 }
1311                 t4 = this.create('transform', [fix[1], fix[2]], {type: 'translate'});
1312                 t1.melt(t4);
1313 
1314                 if (drag.center.draggable()) {
1315                     t1.applyOnce([drag.center]);
1316                 }
1317 
1318                 if (drag.method === 'twoPoints') {
1319                     if (drag.point2.draggable()) {
1320                         t1.applyOnce([drag.point2]);
1321                     }
1322                 } else if (drag.method === 'pointRadius') {
1323                     if (Type.isNumber(drag.updateRadius.origin)) {
1324                         drag.setRadius(drag.radius * d);
1325                     }
1326                 }
1327 
1328                 this.update(drag.center);
1329                 drag.highlight(true);
1330             }
1331         },
1332 
1333         highlightElements: function (x, y, evt, target) {
1334             var el, pEl, pId,
1335                 overObjects = {},
1336                 len = this.objectsList.length;
1337 
1338             // Elements  below the mouse pointer which are not highlighted yet will be highlighted.
1339             for (el = 0; el < len; el++) {
1340                 pEl = this.objectsList[el];
1341                 pId = pEl.id;
1342                 if (Type.exists(pEl.hasPoint) && pEl.visPropCalc.visible && pEl.hasPoint(x, y)) {
1343                     // this is required in any case because otherwise the box won't be shown until the point is dragged
1344                     this.updateInfobox(pEl);
1345 
1346                     if (!Type.exists(this.highlightedObjects[pId])) { // highlight only if not highlighted
1347                         overObjects[pId] = pEl;
1348                         pEl.highlight();
1349                         // triggers board event.
1350                         this.triggerEventHandlers(['mousehit', 'hit'], [evt, pEl, target]);
1351                     }
1352 
1353                     if (pEl.mouseover) {
1354                         pEl.triggerEventHandlers(['mousemove', 'move'], [evt]);
1355                     } else {
1356                         pEl.triggerEventHandlers(['mouseover', 'over'], [evt]);
1357                         pEl.mouseover = true;
1358                     }
1359                 }
1360             }
1361 
1362             for (el = 0; el < len; el++) {
1363                 pEl = this.objectsList[el];
1364                 pId = pEl.id;
1365                 if (pEl.mouseover) {
1366                     if (!overObjects[pId]) {
1367                         pEl.triggerEventHandlers(['mouseout', 'out'], [evt]);
1368                         pEl.mouseover = false;
1369                     }
1370                 }
1371             }
1372         },
1373 
1374         /**
1375          * Helper function which returns a reasonable starting point for the object being dragged.
1376          * Formerly known as initXYstart().
1377          * @private
1378          * @param {JXG.GeometryElement} obj The object to be dragged
1379          * @param {Array} targets Array of targets. It is changed by this function.
1380          */
1381         saveStartPos: function (obj, targets) {
1382             var xy = [], i, len;
1383 
1384             if (obj.type === Const.OBJECT_TYPE_TICKS) {
1385                 xy.push([1, NaN, NaN]);
1386             } else if (obj.elementClass === Const.OBJECT_CLASS_LINE) {
1387                 xy.push(obj.point1.coords.usrCoords);
1388                 xy.push(obj.point2.coords.usrCoords);
1389             } else if (obj.elementClass === Const.OBJECT_CLASS_CIRCLE) {
1390                 xy.push(obj.center.coords.usrCoords);
1391                 if (obj.method === 'twoPoints') {
1392                     xy.push(obj.point2.coords.usrCoords);
1393                 }
1394             } else if (obj.type === Const.OBJECT_TYPE_POLYGON) {
1395                 len = obj.vertices.length - 1;
1396                 for (i = 0; i < len; i++) {
1397                     xy.push(obj.vertices[i].coords.usrCoords);
1398                 }
1399             } else if (obj.type === Const.OBJECT_TYPE_SECTOR) {
1400                 xy.push(obj.point1.coords.usrCoords);
1401                 xy.push(obj.point2.coords.usrCoords);
1402                 xy.push(obj.point3.coords.usrCoords);
1403             } else if (Type.isPoint(obj) || obj.type === Const.OBJECT_TYPE_GLIDER) {
1404                 xy.push(obj.coords.usrCoords);
1405             } else if (obj.elementClass === Const.OBJECT_CLASS_CURVE) {
1406                 // if (Type.exists(obj.parents)) {
1407                 //     len = obj.parents.length;
1408                 //     if (len > 0) {
1409                 //         for (i = 0; i < len; i++) {
1410                 //             xy.push(this.select(obj.parents[i]).coords.usrCoords);
1411                 //         }
1412                 //     } else
1413                 // }
1414                 if (obj.points.length > 0) {
1415                     xy.push(obj.points[0].usrCoords);
1416                 }
1417             } else {
1418                 try {
1419                     xy.push(obj.coords.usrCoords);
1420                 } catch (e) {
1421                     JXG.debug('JSXGraph+ saveStartPos: obj.coords.usrCoords not available: ' + e);
1422                 }
1423             }
1424 
1425             len = xy.length;
1426             for (i = 0; i < len; i++) {
1427                 targets.Zstart.push(xy[i][0]);
1428                 targets.Xstart.push(xy[i][1]);
1429                 targets.Ystart.push(xy[i][2]);
1430             }
1431         },
1432 
1433         mouseOriginMoveStart: function (evt) {
1434             var r, pos;
1435 
1436             r = this._isRequiredKeyPressed(evt, 'pan');
1437             if (r) {
1438                 pos = this.getMousePosition(evt);
1439                 this.initMoveOrigin(pos[0], pos[1]);
1440             }
1441 
1442             return r;
1443         },
1444 
1445         mouseOriginMove: function (evt) {
1446             var r = (this.mode === this.BOARD_MODE_MOVE_ORIGIN),
1447                 pos;
1448 
1449             if (r) {
1450                 pos = this.getMousePosition(evt);
1451                 this.moveOrigin(pos[0], pos[1], true);
1452             }
1453 
1454             return r;
1455         },
1456 
1457         /**
1458          * Start moving the origin with one finger.
1459          * @private
1460          * @param  {Object} evt Event from touchStartListener
1461          * @return {Boolean}   returns if the origin is moved.
1462          */
1463         touchStartMoveOriginOneFinger: function (evt) {
1464             var touches = evt[JXG.touchProperty],
1465                 conditions, pos;
1466 
1467             conditions = this.attr.pan.enabled &&
1468                 !this.attr.pan.needtwofingers &&
1469                 touches.length === 1;
1470 
1471             if (conditions) {
1472                 pos = this.getMousePosition(evt, 0);
1473                 this.initMoveOrigin(pos[0], pos[1]);
1474             }
1475 
1476             return conditions;
1477         },
1478 
1479         /**
1480          * Move the origin with one finger
1481          * @private
1482          * @param  {Object} evt Event from touchMoveListener
1483          * @return {Boolean}     returns if the origin is moved.
1484          */
1485         touchOriginMove: function (evt) {
1486             var r = (this.mode === this.BOARD_MODE_MOVE_ORIGIN),
1487                 pos;
1488 
1489             if (r) {
1490                 pos = this.getMousePosition(evt, 0);
1491                 this.moveOrigin(pos[0], pos[1], true);
1492             }
1493 
1494             return r;
1495         },
1496 
1497         /**
1498          * Stop moving the origin with one finger
1499          * @return {null} null
1500          * @private
1501          */
1502         originMoveEnd: function () {
1503             this.updateQuality = this.BOARD_QUALITY_HIGH;
1504             this.mode = this.BOARD_MODE_NONE;
1505         },
1506 
1507         /**********************************************************
1508          *
1509          * Event Handler
1510          *
1511          **********************************************************/
1512 
1513         /**
1514          *  Add all possible event handlers to the board object
1515          */
1516         addEventHandlers: function () {
1517             if (Env.supportsPointerEvents()) {
1518                 this.addPointerEventHandlers();
1519             } else {
1520                 this.addMouseEventHandlers();
1521                 this.addTouchEventHandlers();
1522             }
1523 
1524             // This one produces errors on IE
1525             //Env.addEvent(this.containerObj, 'contextmenu', function (e) { e.preventDefault(); return false;}, this);
1526             // This one works on IE, Firefox and Chromium with default configurations. On some Safari
1527             // or Opera versions the user must explicitly allow the deactivation of the context menu.
1528             if (this.containerObj !== null) {
1529                 this.containerObj.oncontextmenu = function (e) {
1530                     if (Type.exists(e)) {
1531                         e.preventDefault();
1532                     }
1533                     return false;
1534                 };
1535             }
1536 
1537             this.addFullscreenEventHandlers();
1538             this.addKeyboardEventHandlers();
1539 
1540             if (Env.isBrowser) {
1541                 try {
1542                     // resizeObserver: triggered if size of the JSXGraph div changes.
1543                     this.startResizeObserver();
1544                 } catch (err) {
1545                     // resize event: triggered if size of window changes
1546                     Env.addEvent(window, 'resize', this.resizeListener, this);
1547                     // intersectionObserver: triggered if JSXGraph becomes visible.
1548                     this.startIntersectionObserver();
1549                 }
1550                 // Scroll event: needs to be captured since on mobile devices
1551                 // sometimes a header bar is displayed / hidden, which triggers a
1552                 // resize event.
1553                 Env.addEvent(window, 'scroll', this.scrollListener, this);
1554             }
1555         },
1556 
1557         /**
1558          * Remove all event handlers from the board object
1559          */
1560         removeEventHandlers: function () {
1561             this.removeMouseEventHandlers();
1562             this.removeTouchEventHandlers();
1563             this.removePointerEventHandlers();
1564 
1565             this.removeFullscreenEventHandlers();
1566             this.removeKeyboardEventHandlers();
1567             if (Env.isBrowser) {
1568                 if (Type.exists(this.resizeObserver)) {
1569                     this.stopResizeObserver();
1570                 } else {
1571                     Env.removeEvent(window, 'resize', this.resizeListener, this);
1572                     this.stopIntersectionObserver();
1573                 }
1574                 Env.removeEvent(window, 'scroll', this.scrollListener, this);
1575             }
1576         },
1577 
1578         /**
1579          * Registers the MSPointer* event handlers.
1580          */
1581         addPointerEventHandlers: function () {
1582             if (!this.hasPointerHandlers && Env.isBrowser) {
1583                 var moveTarget = this.attr.movetarget || this.containerObj;
1584 
1585                 if (window.navigator.msPointerEnabled) {  // IE10-
1586                     Env.addEvent(this.containerObj, 'MSPointerDown', this.pointerDownListener, this);
1587                     Env.addEvent(moveTarget, 'MSPointerMove', this.pointerMoveListener, this);
1588                 } else {
1589                     Env.addEvent(this.containerObj, 'pointerdown', this.pointerDownListener, this);
1590                     Env.addEvent(moveTarget, 'pointermove', this.pointerMoveListener, this);
1591                 }
1592                 Env.addEvent(this.containerObj, 'mousewheel', this.mouseWheelListener, this);
1593                 Env.addEvent(this.containerObj, 'DOMMouseScroll', this.mouseWheelListener, this);
1594 
1595                 if (this.containerObj !== null) {
1596                     // This is needed for capturing touch events.
1597                     // It is also in jsxgraph.css, but one never knows...
1598                     this.containerObj.style.touchAction = 'none';
1599                 }
1600 
1601                 this.hasPointerHandlers = true;
1602             }
1603         },
1604 
1605         /**
1606          * Registers mouse move, down and wheel event handlers.
1607          */
1608         addMouseEventHandlers: function () {
1609             if (!this.hasMouseHandlers && Env.isBrowser) {
1610                 var moveTarget = this.attr.movetarget || this.containerObj;
1611 
1612                 Env.addEvent(this.containerObj, 'mousedown', this.mouseDownListener, this);
1613                 Env.addEvent(moveTarget, 'mousemove', this.mouseMoveListener, this);
1614 
1615                 Env.addEvent(this.containerObj, 'mousewheel', this.mouseWheelListener, this);
1616                 Env.addEvent(this.containerObj, 'DOMMouseScroll', this.mouseWheelListener, this);
1617 
1618                 this.hasMouseHandlers = true;
1619             }
1620         },
1621 
1622         /**
1623          * Register touch start and move and gesture start and change event handlers.
1624          * @param {Boolean} appleGestures If set to false the gesturestart and gesturechange event handlers
1625          * will not be registered.
1626          *
1627          * Since iOS 13, touch events were abandoned in favour of pointer events
1628          */
1629         addTouchEventHandlers: function (appleGestures) {
1630             if (!this.hasTouchHandlers && Env.isBrowser) {
1631                 var moveTarget = this.attr.movetarget || this.containerObj;
1632 
1633                 Env.addEvent(this.containerObj, 'touchstart', this.touchStartListener, this);
1634                 Env.addEvent(moveTarget, 'touchmove', this.touchMoveListener, this);
1635 
1636                 /*
1637                 if (!Type.exists(appleGestures) || appleGestures) {
1638                     // Gesture listener are called in touchStart and touchMove.
1639                     //Env.addEvent(this.containerObj, 'gesturestart', this.gestureStartListener, this);
1640                     //Env.addEvent(this.containerObj, 'gesturechange', this.gestureChangeListener, this);
1641                 }
1642                 */
1643 
1644                 this.hasTouchHandlers = true;
1645             }
1646         },
1647 
1648         /**
1649          * Add fullscreen events which update the CSS transformation matrix to correct
1650          * the mouse/touch/pointer positions in case of CSS transformations.
1651          */
1652         addFullscreenEventHandlers: function() {
1653             var i,
1654                 // standard/Edge, firefox, chrome/safari, IE11
1655                 events = ['fullscreenchange', 'mozfullscreenchange', 'webkitfullscreenchange', 'msfullscreenchange'],
1656                 le = events.length;
1657 
1658             if (!this.hasFullsceenEventHandlers && Env.isBrowser) {
1659                 for (i = 0; i < le; i++) {
1660                     Env.addEvent(this.document, events[i], this.fullscreenListener, this);
1661                 }
1662                 this.hasFullsceenEventHandlers = true;
1663             }
1664         },
1665 
1666         addKeyboardEventHandlers: function() {
1667             if (!this.hasKeyboardHandlers && Env.isBrowser) {
1668                 Env.addEvent(this.containerObj, 'keydown', this.keyDownListener, this);
1669                 Env.addEvent(this.containerObj, 'focusin', this.keyFocusInListener, this);
1670                 Env.addEvent(this.containerObj, 'focusout', this.keyFocusOutListener, this);
1671                 this.hasKeyboardHandlers = true;
1672             }
1673         },
1674 
1675         /**
1676          * Remove all registered touch event handlers.
1677          */
1678         removeKeyboardEventHandlers: function () {
1679             if (this.hasKeyboardHandlers && Env.isBrowser) {
1680                 Env.removeEvent(this.containerObj, 'keydown', this.keyDownListener, this);
1681                 Env.removeEvent(this.containerObj, 'focusin', this.keyFocusInListener, this);
1682                 Env.removeEvent(this.containerObj, 'focusout', this.keyFocusOutListener, this);
1683                 this.hasKeyboardHandlers = false;
1684             }
1685         },
1686 
1687         /**
1688          * Remove all registered event handlers regarding fullscreen mode.
1689          */
1690         removeFullscreenEventHandlers: function() {
1691             var i,
1692                 // standard/Edge, firefox, chrome/safari, IE11
1693                 events = ['fullscreenchange', 'mozfullscreenchange', 'webkitfullscreenchange', 'msfullscreenchange'],
1694                 le = events.length;
1695 
1696             if (this.hasFullsceenEventHandlers && Env.isBrowser) {
1697                 for (i = 0; i < le; i++) {
1698                     Env.removeEvent(this.document, events[i], this.fullscreenListener, this);
1699                 }
1700                 this.hasFullsceenEventHandlers = false;
1701             }
1702         },
1703 
1704         /**
1705          * Remove MSPointer* Event handlers.
1706          */
1707         removePointerEventHandlers: function () {
1708             if (this.hasPointerHandlers && Env.isBrowser) {
1709                 var moveTarget = this.attr.movetarget || this.containerObj;
1710 
1711                 if (window.navigator.msPointerEnabled) {  // IE10-
1712                     Env.removeEvent(this.containerObj, 'MSPointerDown', this.pointerDownListener, this);
1713                     Env.removeEvent(moveTarget, 'MSPointerMove', this.pointerMoveListener, this);
1714                 } else {
1715                     Env.removeEvent(this.containerObj, 'pointerdown', this.pointerDownListener, this);
1716                     Env.removeEvent(moveTarget, 'pointermove', this.pointerMoveListener, this);
1717                 }
1718 
1719                 Env.removeEvent(this.containerObj, 'mousewheel', this.mouseWheelListener, this);
1720                 Env.removeEvent(this.containerObj, 'DOMMouseScroll', this.mouseWheelListener, this);
1721 
1722                 if (this.hasPointerUp) {
1723                     if (window.navigator.msPointerEnabled) {  // IE10-
1724                         Env.removeEvent(this.document, 'MSPointerUp',   this.pointerUpListener, this);
1725                     } else {
1726                         Env.removeEvent(this.document, 'pointerup',     this.pointerUpListener, this);
1727                         Env.removeEvent(this.document, 'pointercancel', this.pointerUpListener, this);
1728                     }
1729                     this.hasPointerUp = false;
1730                 }
1731 
1732                 this.hasPointerHandlers = false;
1733             }
1734         },
1735 
1736         /**
1737          * De-register mouse event handlers.
1738          */
1739         removeMouseEventHandlers: function () {
1740             if (this.hasMouseHandlers && Env.isBrowser) {
1741                 var moveTarget = this.attr.movetarget || this.containerObj;
1742 
1743                 Env.removeEvent(this.containerObj, 'mousedown', this.mouseDownListener, this);
1744                 Env.removeEvent(moveTarget, 'mousemove', this.mouseMoveListener, this);
1745 
1746                 if (this.hasMouseUp) {
1747                     Env.removeEvent(this.document, 'mouseup', this.mouseUpListener, this);
1748                     this.hasMouseUp = false;
1749                 }
1750 
1751                 Env.removeEvent(this.containerObj, 'mousewheel', this.mouseWheelListener, this);
1752                 Env.removeEvent(this.containerObj, 'DOMMouseScroll', this.mouseWheelListener, this);
1753 
1754                 this.hasMouseHandlers = false;
1755             }
1756         },
1757 
1758         /**
1759          * Remove all registered touch event handlers.
1760          */
1761         removeTouchEventHandlers: function () {
1762             if (this.hasTouchHandlers && Env.isBrowser) {
1763                 var moveTarget = this.attr.movetarget || this.containerObj;
1764 
1765                 Env.removeEvent(this.containerObj, 'touchstart', this.touchStartListener, this);
1766                 Env.removeEvent(moveTarget, 'touchmove', this.touchMoveListener, this);
1767 
1768                 if (this.hasTouchEnd) {
1769                     Env.removeEvent(this.document, 'touchend', this.touchEndListener, this);
1770                     this.hasTouchEnd = false;
1771                 }
1772 
1773                 this.hasTouchHandlers = false;
1774             }
1775         },
1776 
1777         /**
1778          * Handler for click on left arrow in the navigation bar
1779          * @returns {JXG.Board} Reference to the board
1780          */
1781         clickLeftArrow: function () {
1782             this.moveOrigin(this.origin.scrCoords[1] + this.canvasWidth * 0.1, this.origin.scrCoords[2]);
1783             return this;
1784         },
1785 
1786         /**
1787          * Handler for click on right arrow in the navigation bar
1788          * @returns {JXG.Board} Reference to the board
1789          */
1790         clickRightArrow: function () {
1791             this.moveOrigin(this.origin.scrCoords[1] - this.canvasWidth * 0.1, this.origin.scrCoords[2]);
1792             return this;
1793         },
1794 
1795         /**
1796          * Handler for click on up arrow in the navigation bar
1797          * @returns {JXG.Board} Reference to the board
1798          */
1799         clickUpArrow: function () {
1800             this.moveOrigin(this.origin.scrCoords[1], this.origin.scrCoords[2] - this.canvasHeight * 0.1);
1801             return this;
1802         },
1803 
1804         /**
1805          * Handler for click on down arrow in the navigation bar
1806          * @returns {JXG.Board} Reference to the board
1807          */
1808         clickDownArrow: function () {
1809             this.moveOrigin(this.origin.scrCoords[1], this.origin.scrCoords[2] + this.canvasHeight * 0.1);
1810             return this;
1811         },
1812 
1813         /**
1814          * Triggered on iOS/Safari while the user inputs a gesture (e.g. pinch) and is used to zoom into the board.
1815          * Works on iOS/Safari and Android.
1816          * @param {Event} evt Browser event object
1817          * @returns {Boolean}
1818          */
1819         gestureChangeListener: function (evt) {
1820             var c,
1821                 dir1 = [],
1822                 dir2 = [],
1823                 angle,
1824                 mi = 10,
1825                 isPinch = false,
1826                 // Save zoomFactors
1827                 zx = this.attr.zoom.factorx,
1828                 zy = this.attr.zoom.factory,
1829                 factor,
1830                 dist,
1831                 dx, dy, theta, cx, cy, bound;
1832 
1833             if (this.mode !== this.BOARD_MODE_ZOOM) {
1834                 return true;
1835             }
1836             evt.preventDefault();
1837 
1838             dist = Geometry.distance([evt.touches[0].clientX, evt.touches[0].clientY],
1839                 [evt.touches[1].clientX, evt.touches[1].clientY], 2);
1840 
1841             // Android pinch to zoom
1842             // evt.scale was available in iOS touch events (pre iOS 13)
1843             // evt.scale is undefined in Android
1844             if (evt.scale === undefined) {
1845                 evt.scale = dist / this.prevDist;
1846             }
1847 
1848             if (!Type.exists(this.prevCoords)) {
1849                 return false;
1850             }
1851             // Compute the angle of the two finger directions
1852             dir1 = [evt.touches[0].clientX - this.prevCoords[0][0],
1853                     evt.touches[0].clientY - this.prevCoords[0][1]];
1854             dir2 = [evt.touches[1].clientX - this.prevCoords[1][0],
1855                     evt.touches[1].clientY - this.prevCoords[1][1]];
1856 
1857             if ((dir1[0] * dir1[0] + dir1[1] * dir1[1] < mi * mi) &&
1858                 (dir2[0] * dir2[0] + dir2[1] * dir2[1] < mi * mi)) {
1859                     return false;
1860             }
1861 
1862             angle = Geometry.rad(dir1, [0,0], dir2);
1863             if (this.isPreviousGesture !== 'pan' &&
1864                 Math.abs(angle) > Math.PI * 0.2 &&
1865                 Math.abs(angle) < Math.PI * 1.8) {
1866                 isPinch = true;
1867             }
1868 
1869             if (this.isPreviousGesture !== 'pan' && !isPinch) {
1870                 if (Math.abs(evt.scale) < 0.77 || Math.abs(evt.scale) > 1.3) {
1871                     isPinch = true;
1872                 }
1873             }
1874 
1875             factor = evt.scale / this.prevScale;
1876             this.prevScale = evt.scale;
1877             this.prevCoords = [[evt.touches[0].clientX, evt.touches[0].clientY],
1878                                [evt.touches[1].clientX, evt.touches[1].clientY]];
1879 
1880             c = new Coords(Const.COORDS_BY_SCREEN, this.getMousePosition(evt, 0), this);
1881 
1882             if (this.attr.pan.enabled &&
1883                 this.attr.pan.needtwofingers &&
1884                 !isPinch) {
1885                 // Pan detected
1886 
1887                 this.isPreviousGesture = 'pan';
1888 
1889                 this.moveOrigin(c.scrCoords[1], c.scrCoords[2], true);
1890             } else if (this.attr.zoom.enabled &&
1891                         Math.abs(factor - 1.0) < 0.5) {
1892                 // Pinch detected
1893 
1894                 if (this.attr.zoom.pinchhorizontal || this.attr.zoom.pinchvertical) {
1895                     dx = Math.abs(evt.touches[0].clientX - evt.touches[1].clientX);
1896                     dy = Math.abs(evt.touches[0].clientY - evt.touches[1].clientY);
1897                     theta = Math.abs(Math.atan2(dy, dx));
1898                     bound = Math.PI * this.attr.zoom.pinchsensitivity / 90.0;
1899                 }
1900 
1901                 if (this.attr.zoom.pinchhorizontal && theta < bound) {
1902                     this.attr.zoom.factorx = factor;
1903                     this.attr.zoom.factory = 1.0;
1904                     cx = 0;
1905                     cy = 0;
1906                 } else if (this.attr.zoom.pinchvertical && Math.abs(theta - Math.PI * 0.5) < bound) {
1907                     this.attr.zoom.factorx = 1.0;
1908                     this.attr.zoom.factory = factor;
1909                     cx = 0;
1910                     cy = 0;
1911                 } else {
1912                     this.attr.zoom.factorx = factor;
1913                     this.attr.zoom.factory = factor;
1914                     cx = c.usrCoords[1];
1915                     cy = c.usrCoords[2];
1916                 }
1917 
1918                 this.zoomIn(cx, cy);
1919 
1920                 // Restore zoomFactors
1921                 this.attr.zoom.factorx = zx;
1922                 this.attr.zoom.factory = zy;
1923             }
1924 
1925             return false;
1926         },
1927 
1928         /**
1929          * Called by iOS/Safari as soon as the user starts a gesture. Works natively on iOS/Safari,
1930          * on Android we emulate it.
1931          * @param {Event} evt
1932          * @returns {Boolean}
1933          */
1934         gestureStartListener: function (evt) {
1935             var pos;
1936 
1937             evt.preventDefault();
1938             this.prevScale = 1.0;
1939             // Android pinch to zoom
1940             this.prevDist = Geometry.distance([evt.touches[0].clientX, evt.touches[0].clientY],
1941                             [evt.touches[1].clientX, evt.touches[1].clientY], 2);
1942             this.prevCoords = [[evt.touches[0].clientX, evt.touches[0].clientY],
1943                                [evt.touches[1].clientX, evt.touches[1].clientY]];
1944             this.isPreviousGesture = 'none';
1945 
1946             // If pinch-to-zoom is interpreted as panning
1947             // we have to prepare move origin
1948             pos = this.getMousePosition(evt, 0);
1949             this.initMoveOrigin(pos[0], pos[1]);
1950 
1951             this.mode = this.BOARD_MODE_ZOOM;
1952             return false;
1953         },
1954 
1955         /**
1956          * Test if the required key combination is pressed for wheel zoom, move origin and
1957          * selection
1958          * @private
1959          * @param  {Object}  evt    Mouse or pen event
1960          * @param  {String}  action String containing the action: 'zoom', 'pan', 'selection'.
1961          * Corresponds to the attribute subobject.
1962          * @return {Boolean}        true or false.
1963          */
1964         _isRequiredKeyPressed: function (evt, action) {
1965             var obj = this.attr[action];
1966             if (!obj.enabled) {
1967                 return false;
1968             }
1969 
1970             if (((obj.needshift && evt.shiftKey) || (!obj.needshift && !evt.shiftKey)) &&
1971                 ((obj.needctrl && evt.ctrlKey) || (!obj.needctrl && !evt.ctrlKey))
1972             )  {
1973                 return true;
1974             }
1975 
1976             return false;
1977         },
1978 
1979         /*
1980          * Pointer events
1981          */
1982 
1983         /**
1984          *
1985          * Check if pointer event is already registered in {@link JXG.Board#_board_touches}.
1986          *
1987          * @param  {Object} evt Event object
1988          * @return {Boolean} true if down event has already been sent.
1989          * @private
1990          */
1991          _isPointerRegistered: function(evt) {
1992             var i, len = this._board_touches.length;
1993 
1994             for (i = 0; i < len; i++) {
1995                 if (this._board_touches[i].pointerId === evt.pointerId) {
1996                     return true;
1997                 }
1998             }
1999             return false;
2000         },
2001 
2002         /**
2003          *
2004          * Store the position of a pointer event.
2005          * If not yet done, registers a pointer event in {@link JXG.Board#_board_touches}.
2006          * Allows to follow the path of that finger on the screen.
2007          * Only two simultaneous touches are supported.
2008          *
2009          * @param {Object} evt Event object
2010          * @returns {JXG.Board} Reference to the board
2011          * @private
2012          */
2013          _pointerStorePosition: function (evt) {
2014             var i, found;
2015 
2016             for (i = 0, found = false; i < this._board_touches.length; i++) {
2017                 if (this._board_touches[i].pointerId === evt.pointerId) {
2018                     this._board_touches[i].clientX = evt.clientX;
2019                     this._board_touches[i].clientY = evt.clientY;
2020                     found = true;
2021                     break;
2022                 }
2023             }
2024 
2025             // Restrict the number of simultaneous touches to 2
2026             if (!found && this._board_touches.length < 2) {
2027                 this._board_touches.push({
2028                     pointerId: evt.pointerId,
2029                     clientX: evt.clientX,
2030                     clientY: evt.clientY
2031                 });
2032             }
2033 
2034             return this;
2035         },
2036 
2037         /**
2038          * Deregisters a pointer event in {@link JXG.Board#_board_touches}.
2039          * It happens if a finger has been lifted from the screen.
2040          *
2041          * @param {Object} evt Event object
2042          * @returns {JXG.Board} Reference to the board
2043          * @private
2044          */
2045         _pointerRemoveTouches: function (evt) {
2046             var i;
2047             for (i = 0; i < this._board_touches.length; i++) {
2048                 if (this._board_touches[i].pointerId === evt.pointerId) {
2049                     this._board_touches.splice(i, 1);
2050                     break;
2051                 }
2052             }
2053 
2054             return this;
2055         },
2056 
2057         /**
2058          * Remove all registered fingers from {@link JXG.Board#_board_touches}.
2059          * This might be necessary if too many fingers have been registered.
2060          * @returns {JXG.Board} Reference to the board
2061          * @private
2062          */
2063         _pointerClearTouches: function() {
2064             if (this._board_touches.length > 0) {
2065                 this.dehighlightAll();
2066             }
2067             this.updateQuality = this.BOARD_QUALITY_HIGH;
2068             this.mode = this.BOARD_MODE_NONE;
2069             this._board_touches = [];
2070             this.touches = [];
2071         },
2072 
2073         /**
2074          * Determine which input device is used for this action.
2075          * Possible devices are 'touch', 'pen' and 'mouse'.
2076          * This affects the precision and certain events.
2077          * In case of no browser, 'mouse' is used.
2078          *
2079          * @see JXG.Board#pointerDownListener
2080          * @see JXG.Board#pointerMoveListener
2081          * @see JXG.Board#initMoveObject
2082          * @see JXG.Board#moveObject
2083          *
2084          * @param {Event} evt The browsers event object.
2085          * @returns {String} 'mouse', 'pen', or 'touch'
2086          * @private
2087          */
2088         _getPointerInputDevice: function(evt) {
2089             if (Env.isBrowser) {
2090                 if (evt.pointerType === 'touch' ||        // New
2091                     (window.navigator.msMaxTouchPoints && // Old
2092                         window.navigator.msMaxTouchPoints > 1)) {
2093                     return 'touch';
2094                 }
2095                 if (evt.pointerType === 'mouse') {
2096                     return 'mouse';
2097                 }
2098                 if (evt.pointerType === 'pen') {
2099                     return 'pen';
2100                 }
2101             }
2102             return 'mouse';
2103         },
2104 
2105         /**
2106          * This method is called by the browser when a pointing device is pressed on the screen.
2107          * @param {Event} evt The browsers event object.
2108          * @param {Object} object If the object to be dragged is already known, it can be submitted via this parameter
2109          * @returns {Boolean} ...
2110          */
2111         pointerDownListener: function (evt, object) {
2112             var i, j, k, pos, elements, sel,
2113                 target_obj,
2114                 type = 'mouse', // Used in case of no browser
2115                 found, target;
2116 
2117             // Fix for Firefox browser: When using a second finger, the
2118             // touch event for the first finger is sent again.
2119             if (!object && this._isPointerRegistered(evt)) {
2120                 return false;
2121             }
2122 
2123             if (!object && evt.isPrimary) {
2124                 // First finger down. To be on the safe side this._board_touches is cleared.
2125                 this._pointerClearTouches();
2126             }
2127 
2128             if (!this.hasPointerUp) {
2129                 if (window.navigator.msPointerEnabled) {  // IE10-
2130                     Env.addEvent(this.document, 'MSPointerUp',   this.pointerUpListener, this);
2131                 } else {
2132                     // 'pointercancel' is fired e.g. if the finger leaves the browser and drags down the system menu on Android
2133                     Env.addEvent(this.document, 'pointerup',     this.pointerUpListener, this);
2134                     Env.addEvent(this.document, 'pointercancel', this.pointerUpListener, this);
2135                 }
2136                 this.hasPointerUp = true;
2137             }
2138 
2139             if (this.hasMouseHandlers) {
2140                 this.removeMouseEventHandlers();
2141             }
2142 
2143             if (this.hasTouchHandlers) {
2144                 this.removeTouchEventHandlers();
2145             }
2146 
2147             // Prevent accidental selection of text
2148             if (this.document.selection && Type.isFunction(this.document.selection.empty)) {
2149                 this.document.selection.empty();
2150             } else if (window.getSelection) {
2151                 sel = window.getSelection();
2152                 if (sel.removeAllRanges) {
2153                     try {
2154                         sel.removeAllRanges();
2155                     } catch (e) {}
2156                 }
2157             }
2158 
2159             // Mouse, touch or pen device
2160             this._inputDevice = this._getPointerInputDevice(evt);
2161             type = this._inputDevice;
2162             this.options.precision.hasPoint = this.options.precision[type];
2163 
2164             // Handling of multi touch with pointer events should be easier than the touch events.
2165             // Every pointer device has its own pointerId, e.g. the mouse
2166             // always has id 1 or 0, fingers and pens get unique ids every time a pointerDown event is fired and they will
2167             // keep this id until a pointerUp event is fired. What we have to do here is:
2168             //  1. collect all elements under the current pointer
2169             //  2. run through the touches control structure
2170             //    a. look for the object collected in step 1.
2171             //    b. if an object is found, check the number of pointers. If appropriate, add the pointer.
2172             pos = this.getMousePosition(evt);
2173 
2174             // selection
2175             this._testForSelection(evt);
2176             if (this.selectingMode) {
2177                 this._startSelecting(pos);
2178                 this.triggerEventHandlers(['touchstartselecting', 'pointerstartselecting', 'startselecting'], [evt]);
2179                 return;     // don't continue as a normal click
2180             }
2181 
2182             if (this.attr.drag.enabled && object) {
2183                 elements = [ object ];
2184                 this.mode = this.BOARD_MODE_DRAG;
2185             } else {
2186                 elements = this.initMoveObject(pos[0], pos[1], evt, type);
2187             }
2188 
2189             target_obj = {
2190                 num: evt.pointerId,
2191                 X: pos[0],
2192                 Y: pos[1],
2193                 Xprev: NaN,
2194                 Yprev: NaN,
2195                 Xstart: [],
2196                 Ystart: [],
2197                 Zstart: []
2198             };
2199 
2200             // If no draggable object can be found, get out here immediately
2201             if (elements.length > 0) {
2202                 // check touches structure
2203                 target = elements[elements.length - 1];
2204                 found = false;
2205 
2206                 // Reminder: this.touches is the list of elements which
2207                 // currently "possess" a pointer (mouse, pen, finger)
2208                 for (i = 0; i < this.touches.length; i++) {
2209                     // An element receives a further touch, i.e.
2210                     // the target is already in our touches array, add the pointer to the existing touch
2211                     if (this.touches[i].obj === target) {
2212                         j = i;
2213                         k = this.touches[i].targets.push(target_obj) - 1;
2214                         found = true;
2215                         break;
2216                     }
2217                 }
2218                 if (!found) {
2219                     // An new element hae been touched.
2220                     k = 0;
2221                     j = this.touches.push({
2222                         obj: target,
2223                         targets: [target_obj]
2224                     }) - 1;
2225                 }
2226 
2227                 this.dehighlightAll();
2228                 target.highlight(true);
2229 
2230                 this.saveStartPos(target, this.touches[j].targets[k]);
2231 
2232                 // Prevent accidental text selection
2233                 // this could get us new trouble: input fields, links and drop down boxes placed as text
2234                 // on the board don't work anymore.
2235                 if (evt && evt.preventDefault) {
2236                     evt.preventDefault();
2237                 } else if (window.event) {
2238                     window.event.returnValue = false;
2239                 }
2240             }
2241 
2242             if (this.touches.length > 0) {
2243                 evt.preventDefault();
2244                 evt.stopPropagation();
2245             }
2246 
2247             if (!Env.isBrowser) {
2248                 return false;
2249             }
2250             if (this._getPointerInputDevice(evt) !== 'touch') {
2251                 if (this.mode === this.BOARD_MODE_NONE) {
2252                     this.mouseOriginMoveStart(evt);
2253                 }
2254             } else {
2255                 this._pointerStorePosition(evt);
2256                 evt.touches = this._board_touches;
2257 
2258                 // Touch events on empty areas of the board are handled here, see also touchStartListener
2259                 // 1. case: one finger. If allowed, this triggers pan with one finger
2260                 if (evt.touches.length === 1 &&
2261                     this.mode === this.BOARD_MODE_NONE &&
2262                     this.touchStartMoveOriginOneFinger(evt)) {
2263                         // Empty by purpose
2264                 } else if (evt.touches.length === 2 &&
2265                             (this.mode === this.BOARD_MODE_NONE || this.mode === this.BOARD_MODE_MOVE_ORIGIN)
2266                         ) {
2267                     // 2. case: two fingers: pinch to zoom or pan with two fingers needed.
2268                     // This happens when the second finger hits the device. First, the
2269                     // "one finger pan mode" has to be cancelled.
2270                     if (this.mode === this.BOARD_MODE_MOVE_ORIGIN) {
2271                         this.originMoveEnd();
2272                     }
2273 
2274                     this.gestureStartListener(evt);
2275                 }
2276             }
2277 
2278             this.triggerEventHandlers(['touchstart', 'down', 'pointerdown', 'MSPointerDown'], [evt]);
2279             return false;
2280         },
2281 
2282         // /**
2283         //  * Called if pointer leaves an HTML tag. It is called by the inner-most tag.
2284         //  * That means, if a JSXGraph text, i.e. an HTML div, is placed close
2285         //  * to the border of the board, this pointerout event will be ignored.
2286         //  * @param  {Event} evt
2287         //  * @return {Boolean}
2288         //  */
2289         // pointerOutListener: function (evt) {
2290         //     if (evt.target === this.containerObj ||
2291         //         (this.renderer.type === 'svg' && evt.target === this.renderer.foreignObjLayer)) {
2292         //         this.pointerUpListener(evt);
2293         //     }
2294         //     return this.mode === this.BOARD_MODE_NONE;
2295         // },
2296 
2297         /**
2298          * Called periodically by the browser while the user moves a pointing device across the screen.
2299          * @param {Event} evt
2300          * @returns {Boolean}
2301          */
2302         pointerMoveListener: function (evt) {
2303             var i, j, pos, touchTargets,
2304                 type = 'mouse'; // in case of no browser
2305 
2306             if (this._getPointerInputDevice(evt) === 'touch' && !this._isPointerRegistered(evt)) {
2307                 // Test, if there was a previous down event of this _getPointerId
2308                 // (in case it is a touch event).
2309                 // Otherwise this move event is ignored. This is necessary e.g. for sketchometry.
2310                 return this.BOARD_MODE_NONE;
2311             }
2312 
2313             if (!this.checkFrameRate(evt)) {
2314                 return false;
2315             }
2316 
2317             if (this.mode !== this.BOARD_MODE_DRAG) {
2318                 this.dehighlightAll();
2319                 this.displayInfobox(false);
2320             }
2321 
2322             if (this.mode !== this.BOARD_MODE_NONE) {
2323                 evt.preventDefault();
2324                 evt.stopPropagation();
2325             }
2326 
2327             this.updateQuality = this.BOARD_QUALITY_LOW;
2328             // Mouse, touch or pen device
2329             this._inputDevice = this._getPointerInputDevice(evt);
2330             type = this._inputDevice;
2331             this.options.precision.hasPoint = this.options.precision[type];
2332 
2333             // selection
2334             if (this.selectingMode) {
2335                 pos = this.getMousePosition(evt);
2336                 this._moveSelecting(pos);
2337                 this.triggerEventHandlers(['touchmoveselecting', 'moveselecting', 'pointermoveselecting'], [evt, this.mode]);
2338             } else if (!this.mouseOriginMove(evt)) {
2339                 if (this.mode === this.BOARD_MODE_DRAG) {
2340                     // Run through all jsxgraph elements which are touched by at least one finger.
2341                     for (i = 0; i < this.touches.length; i++) {
2342                         touchTargets = this.touches[i].targets;
2343                         // Run through all touch events which have been started on this jsxgraph element.
2344                         for (j = 0; j < touchTargets.length; j++) {
2345                             if (touchTargets[j].num === evt.pointerId) {
2346 
2347                                 pos = this.getMousePosition(evt);
2348                                 touchTargets[j].X = pos[0];
2349                                 touchTargets[j].Y = pos[1];
2350 
2351                                 if (touchTargets.length === 1) {
2352                                     // Touch by one finger: this is possible for all elements that can be dragged
2353                                     this.moveObject(pos[0], pos[1], this.touches[i], evt, type);
2354                                 } else if (touchTargets.length === 2) {
2355                                     // Touch by two fingers: e.g. moving lines
2356                                     this.twoFingerMove(this.touches[i], evt.pointerId, evt);
2357 
2358                                     touchTargets[j].Xprev = pos[0];
2359                                     touchTargets[j].Yprev = pos[1];
2360                                 }
2361 
2362                                 // There is only one pointer in the evt object, so there's no point in looking further
2363                                 break;
2364                             }
2365                         }
2366                     }
2367                 } else {
2368                     if (this._getPointerInputDevice(evt) === 'touch') {
2369                         this._pointerStorePosition(evt);
2370 
2371                         if (this._board_touches.length === 2) {
2372                             evt.touches = this._board_touches;
2373                             this.gestureChangeListener(evt);
2374                         }
2375                     }
2376 
2377                     // Move event without dragging an element
2378                     pos = this.getMousePosition(evt);
2379                     this.highlightElements(pos[0], pos[1], evt, -1);
2380                 }
2381             }
2382 
2383             // Hiding the infobox is commented out, since it prevents showing the infobox
2384             // on IE 11+ on 'over'
2385             //if (this.mode !== this.BOARD_MODE_DRAG) {
2386                 //this.displayInfobox(false);
2387             //}
2388             this.triggerEventHandlers(['touchmove', 'move', 'pointermove', 'MSPointerMove'], [evt, this.mode]);
2389             this.updateQuality = this.BOARD_QUALITY_HIGH;
2390 
2391             return this.mode === this.BOARD_MODE_NONE;
2392         },
2393 
2394         /**
2395          * Triggered as soon as the user stops touching the device with at least one finger.
2396          * @param {Event} evt
2397          * @returns {Boolean}
2398          */
2399         pointerUpListener: function (evt) {
2400             var i, j, found, touchTargets;
2401 
2402             this.triggerEventHandlers(['touchend', 'up', 'pointerup', 'MSPointerUp'], [evt]);
2403             this.displayInfobox(false);
2404 
2405             if (evt) {
2406                 for (i = 0; i < this.touches.length; i++) {
2407                     touchTargets = this.touches[i].targets;
2408                     for (j = 0; j < touchTargets.length; j++) {
2409                         if (touchTargets[j].num === evt.pointerId) {
2410                             touchTargets.splice(j, 1);
2411                             if (touchTargets.length === 0) {
2412                                 this.touches.splice(i, 1);
2413                             }
2414                             break;
2415                         }
2416                     }
2417                 }
2418             }
2419 
2420             // selection
2421             if (this.selectingMode) {
2422                 this._stopSelecting(evt);
2423                 this.triggerEventHandlers(['touchstopselecting', 'pointerstopselecting', 'stopselecting'], [evt]);
2424             } else {
2425                 for (i = this.downObjects.length - 1; i > -1; i--) {
2426                     found = false;
2427                     for (j = 0; j < this.touches.length; j++) {
2428                         if (this.touches[j].obj.id === this.downObjects[i].id) {
2429                             found = true;
2430                         }
2431                     }
2432                     if (!found) {
2433                         this.downObjects[i].triggerEventHandlers(['touchend', 'up', 'pointerup', 'MSPointerUp'], [evt]);
2434                         this.downObjects[i].snapToGrid();
2435                         this.downObjects[i].snapToPoints();
2436                         this.downObjects.splice(i, 1);
2437                     }
2438                 }
2439             }
2440 
2441             // this._pointerRemoveTouches(evt);
2442             // if (this._board_touches.length === 0) {
2443                 if (this.hasPointerUp) {
2444                     if (window.navigator.msPointerEnabled) {  // IE10-
2445                         Env.removeEvent(this.document, 'MSPointerUp',   this.pointerUpListener, this);
2446                     } else {
2447                         Env.removeEvent(this.document, 'pointerup',     this.pointerUpListener, this);
2448                         Env.removeEvent(this.document, 'pointercancel', this.pointerUpListener, this);
2449                     }
2450                     this.hasPointerUp = false;
2451                 }
2452 
2453                 // this.dehighlightAll();
2454                 // this.updateQuality = this.BOARD_QUALITY_HIGH;
2455                 // this.mode = this.BOARD_MODE_NONE;
2456 
2457                 this.originMoveEnd();
2458                 this.update();
2459             // }
2460             // After one finger leaves the screen the gesture is stopped.
2461             this._pointerClearTouches();
2462             return true;
2463         },
2464 
2465         /**
2466          * Touch-Events
2467          */
2468 
2469         /**
2470          * This method is called by the browser when a finger touches the surface of the touch-device.
2471          * @param {Event} evt The browsers event object.
2472          * @returns {Boolean} ...
2473          */
2474         touchStartListener: function (evt) {
2475             var i, pos, elements, j, k,
2476                 eps = this.options.precision.touch,
2477                 obj, found, targets,
2478                 evtTouches = evt[JXG.touchProperty],
2479                 target, touchTargets;
2480 
2481             if (!this.hasTouchEnd) {
2482                 Env.addEvent(this.document, 'touchend', this.touchEndListener, this);
2483                 this.hasTouchEnd = true;
2484             }
2485 
2486             // Do not remove mouseHandlers, since Chrome on win tablets sends mouseevents if used with pen.
2487             //if (this.hasMouseHandlers) { this.removeMouseEventHandlers(); }
2488 
2489             // prevent accidental selection of text
2490             if (this.document.selection && Type.isFunction(this.document.selection.empty)) {
2491                 this.document.selection.empty();
2492             } else if (window.getSelection) {
2493                 window.getSelection().removeAllRanges();
2494             }
2495 
2496             // multitouch
2497             this._inputDevice = 'touch';
2498             this.options.precision.hasPoint = this.options.precision.touch;
2499 
2500             // This is the most critical part. first we should run through the existing touches and collect all targettouches that don't belong to our
2501             // previous touches. once this is done we run through the existing touches again and watch out for free touches that can be attached to our existing
2502             // touches, e.g. we translate (parallel translation) a line with one finger, now a second finger is over this line. this should change the operation to
2503             // a rotational translation. or one finger moves a circle, a second finger can be attached to the circle: this now changes the operation from translation to
2504             // stretching. as a last step we're going through the rest of the targettouches and initiate new move operations:
2505             //  * points have higher priority over other elements.
2506             //  * if we find a targettouch over an element that could be transformed with more than one finger, we search the rest of the targettouches, if they are over
2507             //    this element and add them.
2508             // ADDENDUM 11/10/11:
2509             //  (1) run through the touches control object,
2510             //  (2) try to find the targetTouches for every touch. on touchstart only new touches are added, hence we can find a targettouch
2511             //      for every target in our touches objects
2512             //  (3) if one of the targettouches was bound to a touches targets array, mark it
2513             //  (4) run through the targettouches. if the targettouch is marked, continue. otherwise check for elements below the targettouch:
2514             //      (a) if no element could be found: mark the target touches and continue
2515             //      --- in the following cases, "init" means:
2516             //           (i) check if the element is already used in another touches element, if so, mark the targettouch and continue
2517             //          (ii) if not, init a new touches element, add the targettouch to the touches property and mark it
2518             //      (b) if the element is a point, init
2519             //      (c) if the element is a line, init and try to find a second targettouch on that line. if a second one is found, add and mark it
2520             //      (d) if the element is a circle, init and try to find TWO other targettouches on that circle. if only one is found, mark it and continue. otherwise
2521             //          add both to the touches array and mark them.
2522             for (i = 0; i < evtTouches.length; i++) {
2523                 evtTouches[i].jxg_isused = false;
2524             }
2525 
2526             for (i = 0; i < this.touches.length; i++) {
2527                 touchTargets = this.touches[i].targets;
2528                 for (j = 0; j < touchTargets.length; j++) {
2529                     touchTargets[j].num = -1;
2530                     eps = this.options.precision.touch;
2531 
2532                     do {
2533                         for (k = 0; k < evtTouches.length; k++) {
2534                             // find the new targettouches
2535                             if (Math.abs(Math.pow(evtTouches[k].screenX - touchTargets[j].X, 2) +
2536                                     Math.pow(evtTouches[k].screenY - touchTargets[j].Y, 2)) < eps * eps) {
2537                                 touchTargets[j].num = k;
2538                                 touchTargets[j].X = evtTouches[k].screenX;
2539                                 touchTargets[j].Y = evtTouches[k].screenY;
2540                                 evtTouches[k].jxg_isused = true;
2541                                 break;
2542                             }
2543                         }
2544 
2545                         eps *= 2;
2546 
2547                     } while (touchTargets[j].num === -1 &&
2548                              eps < this.options.precision.touchMax);
2549 
2550                     if (touchTargets[j].num === -1) {
2551                         JXG.debug('i couldn\'t find a targettouches for target no ' + j + ' on ' + this.touches[i].obj.name + ' (' + this.touches[i].obj.id + '). Removed the target.');
2552                         JXG.debug('eps = ' + eps + ', touchMax = ' + Options.precision.touchMax);
2553                         touchTargets.splice(i, 1);
2554                     }
2555 
2556                 }
2557             }
2558 
2559             // we just re-mapped the targettouches to our existing touches list.
2560             // now we have to initialize some touches from additional targettouches
2561             for (i = 0; i < evtTouches.length; i++) {
2562                 if (!evtTouches[i].jxg_isused) {
2563 
2564                     pos = this.getMousePosition(evt, i);
2565                     // selection
2566                     // this._testForSelection(evt); // we do not have shift or ctrl keys yet.
2567                     if (this.selectingMode) {
2568                         this._startSelecting(pos);
2569                         this.triggerEventHandlers(['touchstartselecting', 'startselecting'], [evt]);
2570                         evt.preventDefault();
2571                         evt.stopPropagation();
2572                         this.options.precision.hasPoint = this.options.precision.mouse;
2573                         return this.touches.length > 0; // don't continue as a normal click
2574                     }
2575 
2576                     elements = this.initMoveObject(pos[0], pos[1], evt, 'touch');
2577                     if (elements.length !== 0) {
2578                         obj = elements[elements.length - 1];
2579                         target = {num: i,
2580                             X: evtTouches[i].screenX,
2581                             Y: evtTouches[i].screenY,
2582                             Xprev: NaN,
2583                             Yprev: NaN,
2584                             Xstart: [],
2585                             Ystart: [],
2586                             Zstart: []
2587                         };
2588 
2589                         if (Type.isPoint(obj) ||
2590                                 obj.elementClass === Const.OBJECT_CLASS_TEXT ||
2591                                 obj.type === Const.OBJECT_TYPE_TICKS ||
2592                                 obj.type === Const.OBJECT_TYPE_IMAGE) {
2593                             // It's a point, so it's single touch, so we just push it to our touches
2594                             targets = [obj];
2595 
2596                             // For the UNDO/REDO of object moves
2597                             this.saveStartPos(obj, targets[0]);
2598 
2599                             this.touches.push({ obj: obj, targets: targets });
2600                             obj.highlight(true);
2601 
2602                         } else if (obj.elementClass === Const.OBJECT_CLASS_LINE ||
2603                                 obj.elementClass === Const.OBJECT_CLASS_CIRCLE ||
2604                                 obj.elementClass === Const.OBJECT_CLASS_CURVE ||
2605                                 obj.type === Const.OBJECT_TYPE_POLYGON) {
2606                             found = false;
2607 
2608                             // first check if this geometric object is already captured in this.touches
2609                             for (j = 0; j < this.touches.length; j++) {
2610                                 if (obj.id === this.touches[j].obj.id) {
2611                                     found = true;
2612                                     // only add it, if we don't have two targets in there already
2613                                     if (this.touches[j].targets.length === 1) {
2614                                         // For the UNDO/REDO of object moves
2615                                         this.saveStartPos(obj, target);
2616                                         this.touches[j].targets.push(target);
2617                                     }
2618 
2619                                     evtTouches[i].jxg_isused = true;
2620                                 }
2621                             }
2622 
2623                             // we couldn't find it in touches, so we just init a new touches
2624                             // IF there is a second touch targetting this line, we will find it later on, and then add it to
2625                             // the touches control object.
2626                             if (!found) {
2627                                 targets = [target];
2628 
2629                                 // For the UNDO/REDO of object moves
2630                                 this.saveStartPos(obj, targets[0]);
2631                                 this.touches.push({ obj: obj, targets: targets });
2632                                 obj.highlight(true);
2633                             }
2634                         }
2635                     }
2636 
2637                     evtTouches[i].jxg_isused = true;
2638                 }
2639             }
2640 
2641             if (this.touches.length > 0) {
2642                 evt.preventDefault();
2643                 evt.stopPropagation();
2644             }
2645 
2646             // Touch events on empty areas of the board are handled here:
2647             // 1. case: one finger. If allowed, this triggers pan with one finger
2648             if (evtTouches.length === 1 && this.mode === this.BOARD_MODE_NONE && this.touchStartMoveOriginOneFinger(evt)) {
2649             } else if (evtTouches.length === 2 &&
2650                         (this.mode === this.BOARD_MODE_NONE || this.mode === this.BOARD_MODE_MOVE_ORIGIN)
2651                     ) {
2652                 // 2. case: two fingers: pinch to zoom or pan with two fingers needed.
2653                 // This happens when the second finger hits the device. First, the
2654                 // "one finger pan mode" has to be cancelled.
2655                 if (this.mode === this.BOARD_MODE_MOVE_ORIGIN) {
2656                     this.originMoveEnd();
2657                 }
2658                 this.gestureStartListener(evt);
2659             }
2660 
2661             this.options.precision.hasPoint = this.options.precision.mouse;
2662             this.triggerEventHandlers(['touchstart', 'down'], [evt]);
2663 
2664             return false;
2665             //return this.touches.length > 0;
2666         },
2667 
2668         /**
2669          * Called periodically by the browser while the user moves his fingers across the device.
2670          * @param {Event} evt
2671          * @returns {Boolean}
2672          */
2673         touchMoveListener: function (evt) {
2674             var i, pos1, pos2,
2675                 touchTargets,
2676                 evtTouches = evt[JXG.touchProperty];
2677 
2678             if (!this.checkFrameRate(evt)) {
2679                 return false;
2680             }
2681 
2682             if (this.mode !== this.BOARD_MODE_NONE) {
2683                 evt.preventDefault();
2684                 evt.stopPropagation();
2685             }
2686 
2687             if (this.mode !== this.BOARD_MODE_DRAG) {
2688                 this.dehighlightAll();
2689                 this.displayInfobox(false);
2690             }
2691 
2692             this._inputDevice = 'touch';
2693             this.options.precision.hasPoint = this.options.precision.touch;
2694             this.updateQuality = this.BOARD_QUALITY_LOW;
2695 
2696             // selection
2697             if (this.selectingMode) {
2698                 for (i = 0; i < evtTouches.length; i++) {
2699                     if (!evtTouches[i].jxg_isused) {
2700                         pos1 = this.getMousePosition(evt, i);
2701                         this._moveSelecting(pos1);
2702                         this.triggerEventHandlers(['touchmoves', 'moveselecting'], [evt, this.mode]);
2703                         break;
2704                     }
2705                 }
2706             } else {
2707                 if (!this.touchOriginMove(evt)) {
2708                     if (this.mode === this.BOARD_MODE_DRAG) {
2709                         // Runs over through all elements which are touched
2710                         // by at least one finger.
2711                         for (i = 0; i < this.touches.length; i++) {
2712                             touchTargets = this.touches[i].targets;
2713                             if (touchTargets.length === 1) {
2714 
2715 
2716                                 // Touch by one finger:  this is possible for all elements that can be dragged
2717                                 if (evtTouches[touchTargets[0].num]) {
2718                                     pos1 = this.getMousePosition(evt, touchTargets[0].num);
2719                                     if (pos1[0] < 0 || pos1[0] > this.canvasWidth ||
2720                                         pos1[1] < 0 || pos1[1] > this.canvasHeight) {
2721                                         return;
2722                                     }
2723                                     touchTargets[0].X = pos1[0];
2724                                     touchTargets[0].Y = pos1[1];
2725                                     this.moveObject(pos1[0], pos1[1], this.touches[i], evt, 'touch');
2726                                 }
2727 
2728                             } else if (touchTargets.length === 2 &&
2729                                 touchTargets[0].num > -1 &&
2730                                 touchTargets[1].num > -1) {
2731 
2732                                 // Touch by two fingers: moving lines, ...
2733                                 if (evtTouches[touchTargets[0].num] &&
2734                                     evtTouches[touchTargets[1].num]) {
2735 
2736                                     // Get coordinates of the two touches
2737                                     pos1 = this.getMousePosition(evt, touchTargets[0].num);
2738                                     pos2 = this.getMousePosition(evt, touchTargets[1].num);
2739                                     if (pos1[0] < 0 || pos1[0] > this.canvasWidth ||
2740                                         pos1[1] < 0 || pos1[1] > this.canvasHeight ||
2741                                         pos2[0] < 0 || pos2[0] > this.canvasWidth ||
2742                                         pos2[1] < 0 || pos2[1] > this.canvasHeight) {
2743                                         return;
2744                                     }
2745 
2746                                     touchTargets[0].X = pos1[0];
2747                                     touchTargets[0].Y = pos1[1];
2748                                     touchTargets[1].X = pos2[0];
2749                                     touchTargets[1].Y = pos2[1];
2750 
2751                                     this.twoFingerMove(this.touches[i], touchTargets[0].num, evt);
2752                                     this.twoFingerMove(this.touches[i], touchTargets[1].num);
2753 
2754                                     touchTargets[0].Xprev = pos1[0];
2755                                     touchTargets[0].Yprev = pos1[1];
2756                                     touchTargets[1].Xprev = pos2[0];
2757                                     touchTargets[1].Yprev = pos2[1];
2758                                 }
2759                             }
2760                         }
2761                     } else {
2762                         if (evtTouches.length === 2) {
2763                             this.gestureChangeListener(evt);
2764                         }
2765                         // Move event without dragging an element
2766                         pos1 = this.getMousePosition(evt, 0);
2767                         this.highlightElements(pos1[0], pos1[1], evt, -1);
2768                     }
2769                 }
2770             }
2771 
2772             if (this.mode !== this.BOARD_MODE_DRAG) {
2773                 this.displayInfobox(false);
2774             }
2775 
2776             this.triggerEventHandlers(['touchmove', 'move'], [evt, this.mode]);
2777             this.options.precision.hasPoint = this.options.precision.mouse;
2778             this.updateQuality = this.BOARD_QUALITY_HIGH;
2779 
2780             return this.mode === this.BOARD_MODE_NONE;
2781         },
2782 
2783         /**
2784          * Triggered as soon as the user stops touching the device with at least one finger.
2785          * @param {Event} evt
2786          * @returns {Boolean}
2787          */
2788         touchEndListener: function (evt) {
2789             var i, j, k,
2790                 eps = this.options.precision.touch,
2791                 tmpTouches = [], found, foundNumber,
2792                 evtTouches = evt && evt[JXG.touchProperty],
2793                 touchTargets;
2794 
2795             this.triggerEventHandlers(['touchend', 'up'], [evt]);
2796             this.displayInfobox(false);
2797 
2798             // selection
2799             if (this.selectingMode) {
2800                 this._stopSelecting(evt);
2801                 this.triggerEventHandlers(['touchstopselecting', 'stopselecting'], [evt]);
2802             } else if (evtTouches && evtTouches.length > 0) {
2803                 for (i = 0; i < this.touches.length; i++) {
2804                     tmpTouches[i] = this.touches[i];
2805                 }
2806                 this.touches.length = 0;
2807 
2808                 // try to convert the operation, e.g. if a lines is rotated and translated with two fingers and one finger is lifted,
2809                 // convert the operation to a simple one-finger-translation.
2810                 // ADDENDUM 11/10/11:
2811                 // see addendum to touchStartListener from 11/10/11
2812                 // (1) run through the tmptouches
2813                 // (2) check the touches.obj, if it is a
2814                 //     (a) point, try to find the targettouch, if found keep it and mark the targettouch, else drop the touch.
2815                 //     (b) line with
2816                 //          (i) one target: try to find it, if found keep it mark the targettouch, else drop the touch.
2817                 //         (ii) two targets: if none can be found, drop the touch. if one can be found, remove the other target. mark all found targettouches
2818                 //     (c) circle with [proceed like in line]
2819 
2820                 // init the targettouches marker
2821                 for (i = 0; i < evtTouches.length; i++) {
2822                     evtTouches[i].jxg_isused = false;
2823                 }
2824 
2825                 for (i = 0; i < tmpTouches.length; i++) {
2826                     // could all targets of the current this.touches.obj be assigned to targettouches?
2827                     found = false;
2828                     foundNumber = 0;
2829                     touchTargets = tmpTouches[i].targets;
2830 
2831                     for (j = 0; j < touchTargets.length; j++) {
2832                         touchTargets[j].found = false;
2833                         for (k = 0; k < evtTouches.length; k++) {
2834                             if (Math.abs(Math.pow(evtTouches[k].screenX - touchTargets[j].X, 2) + Math.pow(evtTouches[k].screenY - touchTargets[j].Y, 2)) < eps * eps) {
2835                                 touchTargets[j].found = true;
2836                                 touchTargets[j].num = k;
2837                                 touchTargets[j].X = evtTouches[k].screenX;
2838                                 touchTargets[j].Y = evtTouches[k].screenY;
2839                                 foundNumber += 1;
2840                                 break;
2841                             }
2842                         }
2843                     }
2844 
2845                     if (Type.isPoint(tmpTouches[i].obj)) {
2846                         found = (touchTargets[0] && touchTargets[0].found);
2847                     } else if (tmpTouches[i].obj.elementClass === Const.OBJECT_CLASS_LINE) {
2848                         found = (touchTargets[0] && touchTargets[0].found) || (touchTargets[1] && touchTargets[1].found);
2849                     } else if (tmpTouches[i].obj.elementClass === Const.OBJECT_CLASS_CIRCLE) {
2850                         found = foundNumber === 1 || foundNumber === 3;
2851                     }
2852 
2853                     // if we found this object to be still dragged by the user, add it back to this.touches
2854                     if (found) {
2855                         this.touches.push({
2856                             obj: tmpTouches[i].obj,
2857                             targets: []
2858                         });
2859 
2860                         for (j = 0; j < touchTargets.length; j++) {
2861                             if (touchTargets[j].found) {
2862                                 this.touches[this.touches.length - 1].targets.push({
2863                                     num: touchTargets[j].num,
2864                                     X: touchTargets[j].screenX,
2865                                     Y: touchTargets[j].screenY,
2866                                     Xprev: NaN,
2867                                     Yprev: NaN,
2868                                     Xstart: touchTargets[j].Xstart,
2869                                     Ystart: touchTargets[j].Ystart,
2870                                     Zstart: touchTargets[j].Zstart
2871                                 });
2872                             }
2873                         }
2874 
2875                     } else {
2876                         tmpTouches[i].obj.noHighlight();
2877                     }
2878                 }
2879 
2880             } else {
2881                 this.touches.length = 0;
2882             }
2883 
2884             for (i = this.downObjects.length - 1; i > -1; i--) {
2885                 found = false;
2886                 for (j = 0; j < this.touches.length; j++) {
2887                     if (this.touches[j].obj.id === this.downObjects[i].id) {
2888                         found = true;
2889                     }
2890                 }
2891                 if (!found) {
2892                     this.downObjects[i].triggerEventHandlers(['touchup', 'up'], [evt]);
2893                     this.downObjects[i].snapToGrid();
2894                     this.downObjects[i].snapToPoints();
2895                     this.downObjects.splice(i, 1);
2896                 }
2897             }
2898 
2899             if (!evtTouches || evtTouches.length === 0) {
2900 
2901                 if (this.hasTouchEnd) {
2902                     Env.removeEvent(this.document, 'touchend', this.touchEndListener, this);
2903                     this.hasTouchEnd = false;
2904                 }
2905 
2906                 this.dehighlightAll();
2907                 this.updateQuality = this.BOARD_QUALITY_HIGH;
2908 
2909                 this.originMoveEnd();
2910                 this.update();
2911             }
2912 
2913             return true;
2914         },
2915 
2916         /**
2917          * This method is called by the browser when the mouse button is clicked.
2918          * @param {Event} evt The browsers event object.
2919          * @returns {Boolean} True if no element is found under the current mouse pointer, false otherwise.
2920          */
2921         mouseDownListener: function (evt) {
2922             var pos, elements, result;
2923 
2924             // prevent accidental selection of text
2925             if (this.document.selection && Type.isFunction(this.document.selection.empty)) {
2926                 this.document.selection.empty();
2927             } else if (window.getSelection) {
2928                 window.getSelection().removeAllRanges();
2929             }
2930 
2931             if (!this.hasMouseUp) {
2932                 Env.addEvent(this.document, 'mouseup', this.mouseUpListener, this);
2933                 this.hasMouseUp = true;
2934             } else {
2935                 // In case this.hasMouseUp==true, it may be that there was a
2936                 // mousedown event before which was not followed by an mouseup event.
2937                 // This seems to happen with interactive whiteboard pens sometimes.
2938                 return;
2939             }
2940 
2941             this._inputDevice = 'mouse';
2942             this.options.precision.hasPoint = this.options.precision.mouse;
2943             pos = this.getMousePosition(evt);
2944 
2945             // selection
2946             this._testForSelection(evt);
2947             if (this.selectingMode) {
2948                 this._startSelecting(pos);
2949                 this.triggerEventHandlers(['mousestartselecting', 'startselecting'], [evt]);
2950                 return;     // don't continue as a normal click
2951             }
2952 
2953             elements = this.initMoveObject(pos[0], pos[1], evt, 'mouse');
2954 
2955             // if no draggable object can be found, get out here immediately
2956             if (elements.length === 0) {
2957                 this.mode = this.BOARD_MODE_NONE;
2958                 result = true;
2959             } else {
2960                 /** @ignore */
2961                 this.mouse = {
2962                     obj: null,
2963                     targets: [{
2964                         X: pos[0],
2965                         Y: pos[1],
2966                         Xprev: NaN,
2967                         Yprev: NaN
2968                     }]
2969                 };
2970                 this.mouse.obj = elements[elements.length - 1];
2971 
2972                 this.dehighlightAll();
2973                 this.mouse.obj.highlight(true);
2974 
2975                 this.mouse.targets[0].Xstart = [];
2976                 this.mouse.targets[0].Ystart = [];
2977                 this.mouse.targets[0].Zstart = [];
2978 
2979                 this.saveStartPos(this.mouse.obj, this.mouse.targets[0]);
2980 
2981                 // prevent accidental text selection
2982                 // this could get us new trouble: input fields, links and drop down boxes placed as text
2983                 // on the board don't work anymore.
2984                 if (evt && evt.preventDefault) {
2985                     evt.preventDefault();
2986                 } else if (window.event) {
2987                     window.event.returnValue = false;
2988                 }
2989             }
2990 
2991             if (this.mode === this.BOARD_MODE_NONE) {
2992                 result = this.mouseOriginMoveStart(evt);
2993             }
2994 
2995             this.triggerEventHandlers(['mousedown', 'down'], [evt]);
2996 
2997             return result;
2998         },
2999 
3000         /**
3001          * This method is called by the browser when the mouse is moved.
3002          * @param {Event} evt The browsers event object.
3003          */
3004         mouseMoveListener: function (evt) {
3005             var pos;
3006 
3007             if (!this.checkFrameRate(evt)) {
3008                 return false;
3009             }
3010 
3011             pos = this.getMousePosition(evt);
3012 
3013             this.updateQuality = this.BOARD_QUALITY_LOW;
3014 
3015             if (this.mode !== this.BOARD_MODE_DRAG) {
3016                 this.dehighlightAll();
3017                 this.displayInfobox(false);
3018             }
3019 
3020             // we have to check for four cases:
3021             //   * user moves origin
3022             //   * user drags an object
3023             //   * user just moves the mouse, here highlight all elements at
3024             //     the current mouse position
3025             //   * the user is selecting
3026 
3027             // selection
3028             if (this.selectingMode) {
3029                 this._moveSelecting(pos);
3030                 this.triggerEventHandlers(['mousemoveselecting', 'moveselecting'], [evt, this.mode]);
3031             } else if (!this.mouseOriginMove(evt)) {
3032                 if (this.mode === this.BOARD_MODE_DRAG) {
3033                     this.moveObject(pos[0], pos[1], this.mouse, evt, 'mouse');
3034                 } else { // BOARD_MODE_NONE
3035                     // Move event without dragging an element
3036                     this.highlightElements(pos[0], pos[1], evt, -1);
3037                 }
3038                 this.triggerEventHandlers(['mousemove', 'move'], [evt, this.mode]);
3039             }
3040             this.updateQuality = this.BOARD_QUALITY_HIGH;
3041         },
3042 
3043         /**
3044          * This method is called by the browser when the mouse button is released.
3045          * @param {Event} evt
3046          */
3047         mouseUpListener: function (evt) {
3048             var i;
3049 
3050             if (this.selectingMode === false) {
3051                 this.triggerEventHandlers(['mouseup', 'up'], [evt]);
3052             }
3053 
3054             // redraw with high precision
3055             this.updateQuality = this.BOARD_QUALITY_HIGH;
3056 
3057             if (this.mouse && this.mouse.obj) {
3058                 // The parameter is needed for lines with snapToGrid enabled
3059                 this.mouse.obj.snapToGrid(this.mouse.targets[0]);
3060                 this.mouse.obj.snapToPoints();
3061             }
3062 
3063             this.originMoveEnd();
3064             this.dehighlightAll();
3065             this.update();
3066 
3067             // selection
3068             if (this.selectingMode) {
3069                 this._stopSelecting(evt);
3070                 this.triggerEventHandlers(['mousestopselecting', 'stopselecting'], [evt]);
3071             } else {
3072                 for (i = 0; i < this.downObjects.length; i++) {
3073                     this.downObjects[i].triggerEventHandlers(['mouseup', 'up'], [evt]);
3074                 }
3075             }
3076 
3077             this.downObjects.length = 0;
3078 
3079             if (this.hasMouseUp) {
3080                 Env.removeEvent(this.document, 'mouseup', this.mouseUpListener, this);
3081                 this.hasMouseUp = false;
3082             }
3083 
3084             // release dragged mouse object
3085             /** @ignore */
3086             this.mouse = null;
3087         },
3088 
3089         /**
3090          * Handler for mouse wheel events. Used to zoom in and out of the board.
3091          * @param {Event} evt
3092          * @returns {Boolean}
3093          */
3094         mouseWheelListener: function (evt) {
3095             if (!this.attr.zoom.wheel || !this._isRequiredKeyPressed(evt, 'zoom')) {
3096                 return true;
3097             }
3098 
3099             evt = evt || window.event;
3100             var wd = evt.detail ? -evt.detail : evt.wheelDelta / 40,
3101                 pos = new Coords(Const.COORDS_BY_SCREEN, this.getMousePosition(evt), this);
3102 
3103             if (wd > 0) {
3104                 this.zoomIn(pos.usrCoords[1], pos.usrCoords[2]);
3105             } else {
3106                 this.zoomOut(pos.usrCoords[1], pos.usrCoords[2]);
3107             }
3108 
3109             this.triggerEventHandlers(['mousewheel'], [evt]);
3110 
3111             evt.preventDefault();
3112             return false;
3113         },
3114 
3115         /**
3116          * Allow moving of JSXGraph elements with arrow keys
3117          * and zooming of the construction with + / -.
3118          * Panning of the construction is done with arrow keys
3119          * if the pan key (shift or ctrl) is pressed.
3120          * The selection of the element is done with the tab key.
3121          *
3122          * @param  {Event} evt The browser's event object
3123          *
3124          * @see JXG.Board#keyboard
3125          * @see JXG.Board#keyFocusInListener
3126          * @see JXG.Board#keyFocusOutListener
3127          *
3128          */
3129         keyDownListener: function (evt) {
3130             var id_node = evt.target.id,
3131                 id, el, res,
3132                 sX = 0,
3133                 sY = 0,
3134                 // dx, dy are provided in screen units and
3135                 // are converted to user coordinates
3136                 dx = Type.evaluate(this.attr.keyboard.dx) / this.unitX,
3137                 dy = Type.evaluate(this.attr.keyboard.dy) / this.unitY,
3138                 doZoom = false,
3139                 dir, actPos;
3140 
3141             if (!this.attr.keyboard.enabled || id_node === '') {
3142                 return false;
3143             }
3144 
3145             // Get the JSXGraph id from the id of the SVG node.
3146             id = id_node.replace(this.containerObj.id + '_', '');
3147             el = this.select(id);
3148 
3149             if (Type.exists(el.coords)) {
3150                 actPos = el.coords.usrCoords.slice(1);
3151             }
3152 
3153             if (Type.evaluate(this.attr.keyboard.panshift) || Type.evaluate(this.attr.keyboard.panctrl)) {
3154                 doZoom = true;
3155             }
3156 
3157             if ((Type.evaluate(this.attr.keyboard.panshift) && evt.shiftKey) ||
3158                 (Type.evaluate(this.attr.keyboard.panctrl) && evt.ctrlKey)) {
3159                 if (evt.keyCode === 38) {           // up
3160                     this.clickUpArrow();
3161                 } else if (evt.keyCode === 40) {    // down
3162                     this.clickDownArrow();
3163                 } else if (evt.keyCode === 37) {    // left
3164                     this.clickLeftArrow();
3165                 } else if (evt.keyCode === 39) {    // right
3166                     this.clickRightArrow();
3167                 }
3168             } else {
3169                 // Adapt dx, dy to snapToGrid and attractToGrid
3170                 // snapToGrid has priority.
3171                 if (Type.exists(el.visProp)) {
3172                     if (Type.exists(el.visProp.snaptogrid) &&
3173                         el.visProp.snaptogrid &&
3174                         Type.evaluate(el.visProp.snapsizex) &&
3175                         Type.evaluate(el.visProp.snapsizey)) {
3176 
3177                         // Adapt dx, dy such that snapToGrid is possible
3178                         res = el.getSnapSizes();
3179                         sX = res[0];
3180                         sY = res[1];
3181                         dx = Math.max(sX, dx);
3182                         dy = Math.max(sY, dy);
3183 
3184                     } else if (Type.exists(el.visProp.attracttogrid) &&
3185                         el.visProp.attracttogrid &&
3186                         Type.evaluate(el.visProp.attractordistance) &&
3187                         Type.evaluate(el.visProp.attractorunit)) {
3188 
3189                         // Adapt dx, dy such that attractToGrid is possible
3190                         sX = 1.1 * Type.evaluate(el.visProp.attractordistance);
3191                         sY = sX;
3192 
3193                         if (Type.evaluate(el.visProp.attractorunit) === 'screen') {
3194                             sX /= this.unitX;
3195                             sY /= this.unitX;
3196                         }
3197                         dx = Math.max(sX, dx);
3198                         dy = Math.max(sY, dy);
3199                     }
3200 
3201                 }
3202 
3203                 if (evt.keyCode === 38) {           // up
3204                     dir = [0, dy];
3205                 } else if (evt.keyCode === 40) {    // down
3206                     dir = [0, -dy];
3207                 } else if (evt.keyCode === 37) {    // left
3208                     dir = [-dx, 0];
3209                 } else if (evt.keyCode === 39) {    // right
3210                     dir = [dx, 0];
3211                 // } else if (evt.keyCode === 9) {  // tab
3212 
3213                 } else if (doZoom && evt.key === '+') {   // +
3214                     this.zoomIn();
3215                 } else if (doZoom && evt.key === '-') {   // -
3216                     this.zoomOut();
3217                 } else if (doZoom && evt.key === 'o') {   // o
3218                     this.zoom100();
3219                 }
3220                 if (dir && el.isDraggable &&
3221                         el.visPropCalc.visible &&
3222                         ((this.geonextCompatibilityMode &&
3223                             (Type.isPoint(el) ||
3224                             el.elementClass === Const.OBJECT_CLASS_TEXT)
3225                         ) || !this.geonextCompatibilityMode) &&
3226                         !Type.evaluate(el.visProp.fixed)
3227                     ) {
3228 
3229                     if (Type.exists(el.coords)) {
3230                         dir[0] += actPos[0];
3231                         dir[1] += actPos[1];
3232                     }
3233                     // For coordsElement setPosition has to call setPositionDirectly.
3234                     // Otherwise the position is set by a translation.
3235                     el.setPosition(JXG.COORDS_BY_USER, dir);
3236                     if (Type.exists(el.coords)) {
3237                         this.updateInfobox(el);
3238                     }
3239                     this.triggerEventHandlers(['hit'], [evt, el]);
3240                 }
3241             }
3242 
3243             this.update();
3244 
3245             return true;
3246         },
3247 
3248         /**
3249          * Event listener for SVG elements getting focus.
3250          * This is needed for highlighting when using keyboard control.
3251          *
3252          * @see JXG.Board#keyFocusOutListener
3253          * @see JXG.Board#keyDownListener
3254          * @see JXG.Board#keyboard
3255          *
3256          * @param  {Event} evt The browser's event object
3257          */
3258         keyFocusInListener: function (evt) {
3259             var id_node = evt.target.id,
3260                 id, el;
3261 
3262             if (!this.attr.keyboard.enabled || id_node === '') {
3263                 return false;
3264             }
3265 
3266             id = id_node.replace(this.containerObj.id + '_', '');
3267             el = this.select(id);
3268             if (Type.exists(el.highlight)) {
3269                 el.highlight(true);
3270             }
3271             if (Type.exists(el.coords)) {
3272                 this.updateInfobox(el);
3273             }
3274             this.triggerEventHandlers(['hit'], [evt, el]);
3275         },
3276 
3277         /**
3278          * Event listener for SVG elements losing focus.
3279          * This is needed for dehighlighting when using keyboard control.
3280          *
3281          * @see JXG.Board#keyFocusInListener
3282          * @see JXG.Board#keyDownListener
3283          * @see JXG.Board#keyboard
3284          *
3285          * @param  {Event} evt The browser's event object
3286          */
3287         keyFocusOutListener: function (evt) {
3288             if (!this.attr.keyboard.enabled) {
3289                 return false;
3290             }
3291             // var id_node = evt.target.id,
3292             //     id, el;
3293 
3294             // id = id_node.replace(this.containerObj.id + '_', '');
3295             // el = this.select(id);
3296             this.dehighlightAll();
3297             this.displayInfobox(false);
3298         },
3299 
3300         /**
3301          * Update the width and height of the JSXGraph container div element.
3302          * Read actual values with getBoundingClientRect(),
3303          * and call board.resizeContainer() with this values.
3304          * <p>
3305          * If necessary, also call setBoundingBox().
3306          *
3307          * @see JXG.Board#startResizeObserver
3308          * @see JXG.Board#resizeListener
3309          * @see JXG.Board#resizeContainer
3310          * @see JXG.Board#setBoundingBox
3311          *
3312          */
3313         updateContainerDims: function() {
3314             var w, h,
3315                 bb, css;
3316 
3317             // Get size of the board's container div
3318             bb = this.containerObj.getBoundingClientRect();
3319             w = bb.width;
3320             h = bb.height;
3321 
3322             // Subtract the border size
3323             if (window && window.getComputedStyle) {
3324                 css = window.getComputedStyle(this.containerObj, null);
3325                 w -= parseFloat(css.getPropertyValue('border-left-width')) + parseFloat(css.getPropertyValue('border-right-width'));
3326                 h -= parseFloat(css.getPropertyValue('border-top-width'))  + parseFloat(css.getPropertyValue('border-bottom-width'));
3327             }
3328 
3329             // If div is invisible - do nothing
3330             if (w <= 0 || h <= 0) {
3331                 return;
3332             }
3333 
3334             // If bounding box is not yet initialized, do it now.
3335             if (isNaN(this.getBoundingBox()[0])) {
3336                 this.setBoundingBox(this.attr.boundingbox, this.keepaspectratio, 'keep');
3337             }
3338 
3339             // Do nothing if the dimension did not change since being visible
3340             // the last time. Note that if the div had display:none in the mean time,
3341             // we did not store this._prevDim.
3342             if (Type.exists(this._prevDim) &&
3343                 this._prevDim.w === w && this._prevDim.h === h) {
3344                     return;
3345             }
3346 
3347             // Set the size of the SVG or canvas element
3348             this.resizeContainer(w, h, true);
3349             this._prevDim = {
3350                 w: w,
3351                 h: h
3352             };
3353         },
3354 
3355         /**
3356          * Start observer which reacts to size changes of the JSXGraph
3357          * container div element. Calls updateContainerDims().
3358          * If not available, an event listener for the window-resize event is started.
3359          * On mobile devices also scrolling might trigger resizes.
3360          * However, resize events triggered by scrolling events should be ignored.
3361          * Therefore, also a scrollListener is started.
3362          * Resize can be controlled with the board attribute resize.
3363          *
3364          * @see JXG.Board#updateContainerDims
3365          * @see JXG.Board#resizeListener
3366          * @see JXG.Board#scrollListener
3367          * @see JXG.Board#resize
3368          *
3369          */
3370         startResizeObserver: function() {
3371             var that = this;
3372 
3373             if (!Env.isBrowser || !this.attr.resize || !this.attr.resize.enabled) {
3374                 return;
3375             }
3376 
3377             this.resizeObserver = new ResizeObserver(function(entries) {
3378                 if (!that._isResizing) {
3379                     that._isResizing = true;
3380                     window.setTimeout(function() {
3381                         try {
3382                             that.updateContainerDims();
3383                         } catch (err) {
3384                             that.stopResizeObserver();
3385                         } finally {
3386                             that._isResizing = false;
3387                         }
3388                     }, that.attr.resize.throttle);
3389                 }
3390             });
3391             this.resizeObserver.observe(this.containerObj);
3392         },
3393 
3394         /**
3395          * Stops the resize observer.
3396          * @see JXG.Board#startResizeObserver
3397          *
3398          */
3399         stopResizeObserver: function() {
3400             if (!Env.isBrowser || !this.attr.resize || !this.attr.resize.enabled) {
3401                 return;
3402             }
3403 
3404             if (Type.exists(this.resizeObserver)) {
3405                 this.resizeObserver.unobserve(this.containerObj);
3406             }
3407         },
3408 
3409         /**
3410          * Fallback solutions if there is no resizeObserver available in the browser.
3411          * Reacts to resize events of the window (only). Otherwise similar to
3412          * startResizeObserver(). To handle changes of the visibility
3413          * of the JSXGraph container element, additionally an intersection observer is used.
3414          * which watches changes in the visibility of the JSXGraph container element.
3415          * This is necessary e.g. for register tabs or dia shows.
3416          *
3417          * @see JXG.Board#startResizeObserver
3418          * @see JXG.Board#startIntersectionObserver
3419          */
3420         resizeListener: function() {
3421             var that = this;
3422 
3423             if (!Env.isBrowser || !this.attr.resize || !this.attr.resize.enabled) {
3424                 return;
3425             }
3426             if (!this._isScrolling && !this._isResizing) {
3427                 this._isResizing = true;
3428                 window.setTimeout(function() {
3429                     that.updateContainerDims();
3430                     that._isResizing = false;
3431                 }, this.attr.resize.throttle);
3432             }
3433         },
3434 
3435         /**
3436          * Listener to watch for scroll events. Sets board._isScrolling = true
3437          * @param  {Event} evt The browser's event object
3438          *
3439          * @see JXG.Board#startResizeObserver
3440          * @see JXG.Board#resizeListener
3441          *
3442          */
3443         scrollListener: function(evt) {
3444             var that = this;
3445 
3446             if (!Env.isBrowser) {
3447                 return;
3448             }
3449             if (!this._isScrolling) {
3450                 this._isScrolling = true;
3451                 window.setTimeout(function() {
3452                     that._isScrolling = false;
3453                 }, 66);
3454             }
3455         },
3456 
3457         /**
3458          * Watch for changes of the visibility of the JSXGraph container element.
3459          *
3460          * @see JXG.Board#startResizeObserver
3461          * @see JXG.Board#resizeListener
3462          *
3463          */
3464         startIntersectionObserver: function() {
3465             var that = this,
3466                 options = {
3467                     root: null,
3468                     rootMargin: '0px',
3469                     threshold: 0.8
3470                 };
3471 
3472             try {
3473                 this.intersectionObserver = new IntersectionObserver(function(entries) {
3474                     // If bounding box is not yet initialized, do it now.
3475                     if (isNaN(that.getBoundingBox()[0])) {
3476                         that.updateContainerDims();
3477                     }
3478                 }, options);
3479                 this.intersectionObserver.observe(that.containerObj);
3480             } catch (err) {
3481                 console.log('JSXGraph: IntersectionObserver not available in this browser.');
3482             }
3483         },
3484 
3485         /**
3486          * Stop the intersection observer
3487          *
3488          * @see JXG.Board#startIntersectionObserver
3489          *
3490          */
3491         stopIntersectionObserver: function() {
3492             if (Type.exists(this.intersectionObserver)) {
3493                 this.intersectionObserver.unobserve(this.containerObj);
3494             }
3495         },
3496 
3497         /**********************************************************
3498          *
3499          * End of Event Handlers
3500          *
3501          **********************************************************/
3502 
3503         /**
3504          * Initialize the info box object which is used to display
3505          * the coordinates of points near the mouse pointer,
3506          * @returns {JXG.Board} Reference to the board
3507         */
3508         initInfobox: function () {
3509             var  attr = Type.copyAttributes({}, this.options, 'infobox');
3510 
3511             attr.id = this.id + '_infobox';
3512             /**
3513              * Infobox close to points in which the points' coordinates are displayed.
3514              * This is simply a JXG.Text element. Access through board.infobox.
3515              * Uses CSS class .JXGinfobox.
3516              * @type JXG.Text
3517              *
3518              */
3519             this.infobox = this.create('text', [0, 0, '0,0'], attr);
3520 
3521             this.infobox.distanceX = -20;
3522             this.infobox.distanceY = 25;
3523             // this.infobox.needsUpdateSize = false;  // That is not true, but it speeds drawing up.
3524 
3525             this.infobox.dump = false;
3526 
3527             this.displayInfobox(false);
3528             return this;
3529         },
3530 
3531         /**
3532          * Updates and displays a little info box to show coordinates of current selected points.
3533          * @param {JXG.GeometryElement} el A GeometryElement
3534          * @returns {JXG.Board} Reference to the board
3535          * @see JXG.Board#displayInfobox
3536          * @see JXG.Board#showInfobox
3537          * @see Point#showInfobox
3538          *
3539          */
3540         updateInfobox: function (el) {
3541             var x, y, xc, yc,
3542             vpinfoboxdigits,
3543             vpsi = Type.evaluate(el.visProp.showinfobox);
3544 
3545             if ((!Type.evaluate(this.attr.showinfobox) &&  vpsi === 'inherit') ||
3546                 !vpsi) {
3547                 return this;
3548             }
3549 
3550             if (Type.isPoint(el)) {
3551                 xc = el.coords.usrCoords[1];
3552                 yc = el.coords.usrCoords[2];
3553 
3554                 vpinfoboxdigits = Type.evaluate(el.visProp.infoboxdigits);
3555                 this.infobox.setCoords(xc + this.infobox.distanceX / this.unitX,
3556                                        yc + this.infobox.distanceY / this.unitY);
3557 
3558                 if (typeof el.infoboxText !== 'string') {
3559                     if (vpinfoboxdigits === 'auto') {
3560                         x = Type.autoDigits(xc);
3561                         y = Type.autoDigits(yc);
3562                     } else if (Type.isNumber(vpinfoboxdigits)) {
3563                         x = Type.toFixed(xc, vpinfoboxdigits);
3564                         y = Type.toFixed(yc, vpinfoboxdigits);
3565                     } else {
3566                         x = xc;
3567                         y = yc;
3568                     }
3569 
3570                     this.highlightInfobox(x, y, el);
3571                 } else {
3572                     this.highlightCustomInfobox(el.infoboxText, el);
3573                 }
3574 
3575                 this.displayInfobox(true);
3576             }
3577             return this;
3578         },
3579 
3580         /**
3581          * Set infobox visible / invisible.
3582          *
3583          * It uses its property hiddenByParent to memorize its status.
3584          * In this way, many DOM access can be avoided.
3585          *
3586          * @param  {Boolean} val true for visible, false for invisible
3587          * @returns {JXG.Board} Reference to the board.
3588          * @see JXG.Board#updateInfobox
3589          *
3590          */
3591         displayInfobox: function(val) {
3592             if (this.infobox.hiddenByParent === val) {
3593                 this.infobox.hiddenByParent = !val;
3594                 this.infobox.prepareUpdate().updateVisibility(val).updateRenderer();
3595             }
3596             return this;
3597         },
3598 
3599         // Alias for displayInfobox to be backwards compatible.
3600         // The method showInfobox clashes with the board attribute showInfobox
3601         showInfobox: function(val) {
3602             return this.displayInfobox(val);
3603         },
3604 
3605         /**
3606          * Changes the text of the info box to show the given coordinates.
3607          * @param {Number} x
3608          * @param {Number} y
3609          * @param {JXG.GeometryElement} [el] The element the mouse is pointing at
3610          * @returns {JXG.Board} Reference to the board.
3611          */
3612         highlightInfobox: function (x, y, el) {
3613             this.highlightCustomInfobox('(' + x + ', ' + y + ')', el);
3614             return this;
3615         },
3616 
3617         /**
3618          * Changes the text of the info box to what is provided via text.
3619          * @param {String} text
3620          * @param {JXG.GeometryElement} [el]
3621          * @returns {JXG.Board} Reference to the board.
3622          */
3623         highlightCustomInfobox: function (text, el) {
3624             this.infobox.setText(text);
3625             return this;
3626         },
3627 
3628         /**
3629          * Remove highlighting of all elements.
3630          * @returns {JXG.Board} Reference to the board.
3631          */
3632         dehighlightAll: function () {
3633             var el, pEl, needsDehighlight = false;
3634 
3635             for (el in this.highlightedObjects) {
3636                 if (this.highlightedObjects.hasOwnProperty(el)) {
3637                     pEl = this.highlightedObjects[el];
3638 
3639                     if (this.hasMouseHandlers || this.hasPointerHandlers) {
3640                         pEl.noHighlight();
3641                     }
3642 
3643                     needsDehighlight = true;
3644 
3645                     // In highlightedObjects should only be objects which fulfill all these conditions
3646                     // And in case of complex elements, like a turtle based fractal, it should be faster to
3647                     // just de-highlight the element instead of checking hasPoint...
3648                     // if ((!Type.exists(pEl.hasPoint)) || !pEl.hasPoint(x, y) || !pEl.visPropCalc.visible)
3649                 }
3650             }
3651 
3652             this.highlightedObjects = {};
3653 
3654             // We do not need to redraw during dehighlighting in CanvasRenderer
3655             // because we are redrawing anyhow
3656             //  -- We do need to redraw during dehighlighting. Otherwise objects won't be dehighlighted until
3657             // another object is highlighted.
3658             if (this.renderer.type === 'canvas' && needsDehighlight) {
3659                 this.prepareUpdate();
3660                 this.renderer.suspendRedraw(this);
3661                 this.updateRenderer();
3662                 this.renderer.unsuspendRedraw();
3663             }
3664 
3665             return this;
3666         },
3667 
3668         /**
3669          * Returns the input parameters in an array. This method looks pointless and it really is, but it had a purpose
3670          * once.
3671          * @private
3672          * @param {Number} x X coordinate in screen coordinates
3673          * @param {Number} y Y coordinate in screen coordinates
3674          * @returns {Array} Coordinates [x, y] of the mouse in screen coordinates.
3675          * @see JXG.Board#getUsrCoordsOfMouse
3676          */
3677         getScrCoordsOfMouse: function (x, y) {
3678             return [x, y];
3679         },
3680 
3681         /**
3682          * This method calculates the user coords of the current mouse coordinates.
3683          * @param {Event} evt Event object containing the mouse coordinates.
3684          * @returns {Array} Coordinates [x, y] of the mouse in user coordinates.
3685          * @example
3686          * board.on('up', function (evt) {
3687          *         var a = board.getUsrCoordsOfMouse(evt),
3688          *             x = a[0],
3689          *             y = a[1],
3690          *             somePoint = board.create('point', [x,y], {name:'SomePoint',size:4});
3691          *             // Shorter version:
3692          *             //somePoint = board.create('point', a, {name:'SomePoint',size:4});
3693          *         });
3694          *
3695          * </pre><div id="JXG48d5066b-16ba-4920-b8ea-a4f8eff6b746" class="jxgbox" style="width: 300px; height: 300px;"></div>
3696          * <script type="text/javascript">
3697          *     (function() {
3698          *         var board = JXG.JSXGraph.initBoard('JXG48d5066b-16ba-4920-b8ea-a4f8eff6b746',
3699          *             {boundingbox: [-8, 8, 8,-8], axis: true, showcopyright: false, shownavigation: false});
3700          *     board.on('up', function (evt) {
3701          *             var a = board.getUsrCoordsOfMouse(evt),
3702          *                 x = a[0],
3703          *                 y = a[1],
3704          *                 somePoint = board.create('point', [x,y], {name:'SomePoint',size:4});
3705          *                 // Shorter version:
3706          *                 //somePoint = board.create('point', a, {name:'SomePoint',size:4});
3707          *             });
3708          *
3709          *     })();
3710          *
3711          * </script><pre>
3712          *
3713          * @see JXG.Board#getScrCoordsOfMouse
3714          * @see JXG.Board#getAllUnderMouse
3715          */
3716         getUsrCoordsOfMouse: function (evt) {
3717             var cPos = this.getCoordsTopLeftCorner(),
3718                 absPos = Env.getPosition(evt, null, this.document),
3719                 x = absPos[0] - cPos[0],
3720                 y = absPos[1] - cPos[1],
3721                 newCoords = new Coords(Const.COORDS_BY_SCREEN, [x, y], this);
3722 
3723             return newCoords.usrCoords.slice(1);
3724         },
3725 
3726         /**
3727          * Collects all elements under current mouse position plus current user coordinates of mouse cursor.
3728          * @param {Event} evt Event object containing the mouse coordinates.
3729          * @returns {Array} Array of elements at the current mouse position plus current user coordinates of mouse.
3730          * @see JXG.Board#getUsrCoordsOfMouse
3731          * @see JXG.Board#getAllObjectsUnderMouse
3732          */
3733         getAllUnderMouse: function (evt) {
3734             var elList = this.getAllObjectsUnderMouse(evt);
3735             elList.push(this.getUsrCoordsOfMouse(evt));
3736 
3737             return elList;
3738         },
3739 
3740         /**
3741          * Collects all elements under current mouse position.
3742          * @param {Event} evt Event object containing the mouse coordinates.
3743          * @returns {Array} Array of elements at the current mouse position.
3744          * @see JXG.Board#getAllUnderMouse
3745          */
3746         getAllObjectsUnderMouse: function (evt) {
3747             var cPos = this.getCoordsTopLeftCorner(),
3748                 absPos = Env.getPosition(evt, null, this.document),
3749                 dx = absPos[0] - cPos[0],
3750                 dy = absPos[1] - cPos[1],
3751                 elList = [],
3752                 el,
3753                 pEl,
3754                 len = this.objectsList.length;
3755 
3756             for (el = 0; el < len; el++) {
3757                 pEl = this.objectsList[el];
3758                 if (pEl.visPropCalc.visible && pEl.hasPoint && pEl.hasPoint(dx, dy)) {
3759                     elList[elList.length] = pEl;
3760                 }
3761             }
3762 
3763             return elList;
3764         },
3765 
3766         /**
3767          * Update the coords object of all elements which possess this
3768          * property. This is necessary after changing the viewport.
3769          * @returns {JXG.Board} Reference to this board.
3770          **/
3771         updateCoords: function () {
3772             var el, ob, len = this.objectsList.length;
3773 
3774             for (ob = 0; ob < len; ob++) {
3775                 el = this.objectsList[ob];
3776 
3777                 if (Type.exists(el.coords)) {
3778                     if (Type.evaluate(el.visProp.frozen)) {
3779                         el.coords.screen2usr();
3780                     } else {
3781                         el.coords.usr2screen();
3782                     }
3783                 }
3784             }
3785             return this;
3786         },
3787 
3788         /**
3789          * Moves the origin and initializes an update of all elements.
3790          * @param {Number} x
3791          * @param {Number} y
3792          * @param {Boolean} [diff=false]
3793          * @returns {JXG.Board} Reference to this board.
3794          */
3795         moveOrigin: function (x, y, diff) {
3796             var ox, oy, ul, lr;
3797             if (Type.exists(x) && Type.exists(y)) {
3798                 ox = this.origin.scrCoords[1];
3799                 oy = this.origin.scrCoords[2];
3800 
3801                 this.origin.scrCoords[1] = x;
3802                 this.origin.scrCoords[2] = y;
3803 
3804                 if (diff) {
3805                     this.origin.scrCoords[1] -= this.drag_dx;
3806                     this.origin.scrCoords[2] -= this.drag_dy;
3807                 }
3808 
3809                 ul = (new Coords(Const.COORDS_BY_SCREEN, [0, 0], this)).usrCoords;
3810                 lr = (new Coords(Const.COORDS_BY_SCREEN, [this.canvasWidth, this.canvasHeight], this)).usrCoords;
3811                 if (ul[1] < this.maxboundingbox[0] ||
3812                     ul[2] > this.maxboundingbox[1] ||
3813                     lr[1] > this.maxboundingbox[2] ||
3814                     lr[2] < this.maxboundingbox[3]) {
3815 
3816                     this.origin.scrCoords[1] = ox;
3817                     this.origin.scrCoords[2] = oy;
3818                 }
3819             }
3820 
3821             this.updateCoords().clearTraces().fullUpdate();
3822             this.triggerEventHandlers(['boundingbox']);
3823 
3824             return this;
3825         },
3826 
3827         /**
3828          * Add conditional updates to the elements.
3829          * @param {String} str String containing coniditional update in geonext syntax
3830          */
3831         addConditions: function (str) {
3832             var term, m, left, right, name, el, property,
3833                 functions = [],
3834                 // plaintext = 'var el, x, y, c, rgbo;\n',
3835                 i = str.indexOf('<data>'),
3836                 j = str.indexOf('<' + '/data>'),
3837 
3838                 xyFun = function (board, el, f, what) {
3839                     return function () {
3840                         var e, t;
3841 
3842                         e = board.select(el.id);
3843                         t = e.coords.usrCoords[what];
3844 
3845                         if (what === 2) {
3846                             e.setPositionDirectly(Const.COORDS_BY_USER, [f(), t]);
3847                         } else {
3848                             e.setPositionDirectly(Const.COORDS_BY_USER, [t, f()]);
3849                         }
3850                         e.prepareUpdate().update();
3851                     };
3852                 },
3853 
3854                 visFun = function (board, el, f) {
3855                     return function () {
3856                         var e, v;
3857 
3858                         e = board.select(el.id);
3859                         v = f();
3860 
3861                         e.setAttribute({visible: v});
3862                     };
3863                 },
3864 
3865                 colFun = function (board, el, f, what) {
3866                     return function () {
3867                         var e, v;
3868 
3869                         e = board.select(el.id);
3870                         v = f();
3871 
3872                         if (what === 'strokewidth') {
3873                             e.visProp.strokewidth = v;
3874                         } else {
3875                             v = Color.rgba2rgbo(v);
3876                             e.visProp[what + 'color'] = v[0];
3877                             e.visProp[what + 'opacity'] = v[1];
3878                         }
3879                     };
3880                 },
3881 
3882                 posFun = function (board, el, f) {
3883                     return function () {
3884                         var e = board.select(el.id);
3885 
3886                         e.position = f();
3887                     };
3888                 },
3889 
3890                 styleFun = function (board, el, f) {
3891                     return function () {
3892                         var e = board.select(el.id);
3893 
3894                         e.setStyle(f());
3895                     };
3896                 };
3897 
3898             if (i < 0) {
3899                 return;
3900             }
3901 
3902             while (i >= 0) {
3903                 term = str.slice(i + 6, j);   // throw away <data>
3904                 m = term.indexOf('=');
3905                 left = term.slice(0, m);
3906                 right = term.slice(m + 1);
3907                 m = left.indexOf('.');     // Dies erzeugt Probleme bei Variablennamen der Form " Steuern akt."
3908                 name = left.slice(0, m);    //.replace(/\s+$/,''); // do NOT cut out name (with whitespace)
3909                 el = this.elementsByName[Type.unescapeHTML(name)];
3910 
3911                 property = left.slice(m + 1).replace(/\s+/g, '').toLowerCase(); // remove whitespace in property
3912                 right = Type.createFunction (right, this, '', true);
3913 
3914                 // Debug
3915                 if (!Type.exists(this.elementsByName[name])) {
3916                     JXG.debug("debug conditions: |" + name + "| undefined");
3917                 } else {
3918                     // plaintext += "el = this.objects[\"" + el.id + "\"];\n";
3919 
3920                     switch (property) {
3921                     case 'x':
3922                         functions.push(xyFun(this, el, right, 2));
3923                         break;
3924                     case 'y':
3925                         functions.push(xyFun(this, el, right, 1));
3926                         break;
3927                     case 'visible':
3928                         functions.push(visFun(this, el, right));
3929                         break;
3930                     case 'position':
3931                         functions.push(posFun(this, el, right));
3932                         break;
3933                     case 'stroke':
3934                         functions.push(colFun(this, el, right, 'stroke'));
3935                         break;
3936                     case 'style':
3937                         functions.push(styleFun(this, el, right));
3938                         break;
3939                     case 'strokewidth':
3940                         functions.push(colFun(this, el, right, 'strokewidth'));
3941                         break;
3942                     case 'fill':
3943                         functions.push(colFun(this, el, right, 'fill'));
3944                         break;
3945                     case 'label':
3946                         break;
3947                     default:
3948                         JXG.debug("property '" + property + "' in conditions not yet implemented:" + right);
3949                         break;
3950                     }
3951                 }
3952                 str = str.slice(j + 7); // cut off "</data>"
3953                 i = str.indexOf('<data>');
3954                 j = str.indexOf('<' + '/data>');
3955             }
3956 
3957             this.updateConditions = function () {
3958                 var i;
3959 
3960                 for (i = 0; i < functions.length; i++) {
3961                     functions[i]();
3962                 }
3963 
3964                 this.prepareUpdate().updateElements();
3965                 return true;
3966             };
3967             this.updateConditions();
3968         },
3969 
3970         /**
3971          * Computes the commands in the conditions-section of the gxt file.
3972          * It is evaluated after an update, before the unsuspendRedraw.
3973          * The function is generated in
3974          * @see JXG.Board#addConditions
3975          * @private
3976          */
3977         updateConditions: function () {
3978             return false;
3979         },
3980 
3981         /**
3982          * Calculates adequate snap sizes.
3983          * @returns {JXG.Board} Reference to the board.
3984          */
3985         calculateSnapSizes: function () {
3986             var p1 = new Coords(Const.COORDS_BY_USER, [0, 0], this),
3987                 p2 = new Coords(Const.COORDS_BY_USER, [this.options.grid.gridX, this.options.grid.gridY], this),
3988                 x = p1.scrCoords[1] - p2.scrCoords[1],
3989                 y = p1.scrCoords[2] - p2.scrCoords[2];
3990 
3991             this.options.grid.snapSizeX = this.options.grid.gridX;
3992             while (Math.abs(x) > 25) {
3993                 this.options.grid.snapSizeX *= 2;
3994                 x /= 2;
3995             }
3996 
3997             this.options.grid.snapSizeY = this.options.grid.gridY;
3998             while (Math.abs(y) > 25) {
3999                 this.options.grid.snapSizeY *= 2;
4000                 y /= 2;
4001             }
4002 
4003             return this;
4004         },
4005 
4006         /**
4007          * Apply update on all objects with the new zoom-factors. Clears all traces.
4008          * @returns {JXG.Board} Reference to the board.
4009          */
4010         applyZoom: function () {
4011             this.updateCoords().calculateSnapSizes().clearTraces().fullUpdate();
4012 
4013             return this;
4014         },
4015 
4016         /**
4017          * Zooms into the board by the factors board.attr.zoom.factorX and board.attr.zoom.factorY and applies the zoom.
4018          * The zoom operation is centered at x, y.
4019          * @param {Number} [x]
4020          * @param {Number} [y]
4021          * @returns {JXG.Board} Reference to the board
4022          */
4023         zoomIn: function (x, y) {
4024             var bb = this.getBoundingBox(),
4025                 zX = this.attr.zoom.factorx,
4026                 zY = this.attr.zoom.factory,
4027                 dX = (bb[2] - bb[0]) * (1.0 - 1.0 / zX),
4028                 dY = (bb[1] - bb[3]) * (1.0 - 1.0 / zY),
4029                 lr = 0.5,
4030                 tr = 0.5,
4031                 mi = this.attr.zoom.eps || this.attr.zoom.min || 0.001;  // this.attr.zoom.eps is deprecated
4032 
4033             if ((this.zoomX > this.attr.zoom.max && zX > 1.0) ||
4034                 (this.zoomY > this.attr.zoom.max && zY > 1.0) ||
4035                 (this.zoomX < mi && zX < 1.0) ||  // zoomIn is used for all zooms on touch devices
4036                 (this.zoomY < mi && zY < 1.0)) {
4037                 return this;
4038             }
4039 
4040             if (Type.isNumber(x) && Type.isNumber(y)) {
4041                 lr = (x - bb[0]) / (bb[2] - bb[0]);
4042                 tr = (bb[1] - y) / (bb[1] - bb[3]);
4043             }
4044 
4045             this.setBoundingBox([bb[0] + dX * lr, bb[1] - dY * tr, bb[2] - dX * (1 - lr), bb[3] + dY * (1 - tr)], this.keepaspectratio, 'update');
4046             return this.applyZoom();
4047         },
4048 
4049         /**
4050          * Zooms out of the board by the factors board.attr.zoom.factorX and board.attr.zoom.factorY and applies the zoom.
4051          * The zoom operation is centered at x, y.
4052          *
4053          * @param {Number} [x]
4054          * @param {Number} [y]
4055          * @returns {JXG.Board} Reference to the board
4056          */
4057         zoomOut: function (x, y) {
4058             var bb = this.getBoundingBox(),
4059                 zX = this.attr.zoom.factorx,
4060                 zY = this.attr.zoom.factory,
4061                 dX = (bb[2] - bb[0]) * (1.0 - zX),
4062                 dY = (bb[1] - bb[3]) * (1.0 - zY),
4063                 lr = 0.5,
4064                 tr = 0.5,
4065                 mi = this.attr.zoom.eps || this.attr.zoom.min || 0.001;  // this.attr.zoom.eps is deprecated
4066 
4067             if (this.zoomX < mi || this.zoomY < mi) {
4068                 return this;
4069             }
4070 
4071             if (Type.isNumber(x) && Type.isNumber(y)) {
4072                 lr = (x - bb[0]) / (bb[2] - bb[0]);
4073                 tr = (bb[1] - y) / (bb[1] - bb[3]);
4074             }
4075 
4076             this.setBoundingBox([bb[0] + dX * lr, bb[1] - dY * tr, bb[2] - dX * (1 - lr), bb[3] + dY * (1 - tr)], this.keepaspectratio, 'update');
4077 
4078             return this.applyZoom();
4079         },
4080 
4081         /**
4082          * Reset the zoom level to the original zoom level from initBoard();
4083          * Additionally, if the board as been initialized with a boundingBox (which is the default),
4084          * restore the viewport to the original viewport during initialization. Otherwise,
4085          * (i.e. if the board as been initialized with unitX/Y and originX/Y),
4086          * just set the zoom level to 100%.
4087          *
4088          * @returns {JXG.Board} Reference to the board
4089          */
4090         zoom100: function () {
4091             var bb, dX, dY;
4092 
4093             if (Type.exists(this.attr.boundingbox)) {
4094                 this.setBoundingBox(this.attr.boundingbox, this.keepaspectratio, 'reset');
4095             } else {
4096                 // Board has been set up with unitX/Y and originX/Y
4097                 bb = this.getBoundingBox();
4098                 dX = (bb[2] - bb[0]) * (1.0 - this.zoomX) * 0.5;
4099                 dY = (bb[1] - bb[3]) * (1.0 - this.zoomY) * 0.5;
4100                 this.setBoundingBox([bb[0] + dX, bb[1] - dY, bb[2] - dX, bb[3] + dY], this.keepaspectratio, 'reset');
4101             }
4102             return this.applyZoom();
4103         },
4104 
4105         /**
4106          * Zooms the board so every visible point is shown. Keeps aspect ratio.
4107          * @returns {JXG.Board} Reference to the board
4108          */
4109         zoomAllPoints: function () {
4110             var el, border, borderX, borderY, pEl,
4111                 minX = 0,
4112                 maxX = 0,
4113                 minY = 0,
4114                 maxY = 0,
4115                 len = this.objectsList.length;
4116 
4117             for (el = 0; el < len; el++) {
4118                 pEl = this.objectsList[el];
4119 
4120                 if (Type.isPoint(pEl) && pEl.visPropCalc.visible) {
4121                     if (pEl.coords.usrCoords[1] < minX) {
4122                         minX = pEl.coords.usrCoords[1];
4123                     } else if (pEl.coords.usrCoords[1] > maxX) {
4124                         maxX = pEl.coords.usrCoords[1];
4125                     }
4126                     if (pEl.coords.usrCoords[2] > maxY) {
4127                         maxY = pEl.coords.usrCoords[2];
4128                     } else if (pEl.coords.usrCoords[2] < minY) {
4129                         minY = pEl.coords.usrCoords[2];
4130                     }
4131                 }
4132             }
4133 
4134             border = 50;
4135             borderX = border / this.unitX;
4136             borderY = border / this.unitY;
4137 
4138             this.setBoundingBox([minX - borderX, maxY + borderY, maxX + borderX, minY - borderY], this.keepaspectratio, 'update');
4139 
4140             return this.applyZoom();
4141         },
4142 
4143         /**
4144          * Reset the bounding box and the zoom level to 100% such that a given set of elements is
4145          * within the board's viewport.
4146          * @param {Array} elements A set of elements given by id, reference, or name.
4147          * @returns {JXG.Board} Reference to the board.
4148          */
4149         zoomElements: function (elements) {
4150             var i, e, box,
4151                 newBBox = [Infinity, -Infinity, -Infinity, Infinity],
4152                 cx, cy, dx, dy, d;
4153 
4154             if (!Type.isArray(elements) || elements.length === 0) {
4155                 return this;
4156             }
4157 
4158             for (i = 0; i < elements.length; i++) {
4159                 e = this.select(elements[i]);
4160 
4161                 box = e.bounds();
4162                 if (Type.isArray(box)) {
4163                     if (box[0] < newBBox[0]) { newBBox[0] = box[0]; }
4164                     if (box[1] > newBBox[1]) { newBBox[1] = box[1]; }
4165                     if (box[2] > newBBox[2]) { newBBox[2] = box[2]; }
4166                     if (box[3] < newBBox[3]) { newBBox[3] = box[3]; }
4167                 }
4168             }
4169 
4170             if (Type.isArray(newBBox)) {
4171                 cx = 0.5 * (newBBox[0] + newBBox[2]);
4172                 cy = 0.5 * (newBBox[1] + newBBox[3]);
4173                 dx = 1.5 * (newBBox[2] - newBBox[0]) * 0.5;
4174                 dy = 1.5 * (newBBox[1] - newBBox[3]) * 0.5;
4175                 d = Math.max(dx, dy);
4176                 this.setBoundingBox([cx - d, cy + d, cx + d, cy - d], this.keepaspectratio, 'update');
4177             }
4178 
4179             return this;
4180         },
4181 
4182         /**
4183          * Sets the zoom level to <tt>fX</tt> resp <tt>fY</tt>.
4184          * @param {Number} fX
4185          * @param {Number} fY
4186          * @returns {JXG.Board} Reference to the board.
4187          */
4188         setZoom: function (fX, fY) {
4189             var oX = this.attr.zoom.factorx,
4190                 oY = this.attr.zoom.factory;
4191 
4192             this.attr.zoom.factorx = fX / this.zoomX;
4193             this.attr.zoom.factory = fY / this.zoomY;
4194 
4195             this.zoomIn();
4196 
4197             this.attr.zoom.factorx = oX;
4198             this.attr.zoom.factory = oY;
4199 
4200             return this;
4201         },
4202 
4203         /**
4204          * Removes object from board and renderer.
4205          * <p>
4206          * <b>Performance hints:</b> It is recommended to use the object's id.
4207          * If many elements are removed, it is best to call <tt>board.suspendUpdate()</tt>
4208          * before looping through the elements to be removed and call
4209          * <tt>board.unsuspendUpdate()</tt> after the loop. Further, it is advisable to loop
4210          * in reverse order, i.e. remove the object in reverse order of their creation time.
4211          *
4212          * @param {JXG.GeometryElement|Array} object The object to remove or array of objects to be removed.
4213          * The element(s) is/are given by name, id or a reference.
4214          * @param {Boolean} saveMethod If true, the algorithm runs through all elements
4215          * and tests if the element to be deleted is a child element. If yes, it will be
4216          * removed from the list of child elements. If false (default), the element
4217          * is removed from the lists of child elements of all its ancestors.
4218          * This should be much faster.
4219          * @returns {JXG.Board} Reference to the board
4220          */
4221         removeObject: function (object, saveMethod) {
4222             var el, i;
4223 
4224             if (Type.isArray(object)) {
4225                 for (i = 0; i < object.length; i++) {
4226                     this.removeObject(object[i]);
4227                 }
4228 
4229                 return this;
4230             }
4231 
4232             object = this.select(object);
4233 
4234             // If the object which is about to be removed unknown or a string, do nothing.
4235             // it is a string if a string was given and could not be resolved to an element.
4236             if (!Type.exists(object) || Type.isString(object)) {
4237                 return this;
4238             }
4239 
4240             try {
4241                 // remove all children.
4242                 for (el in object.childElements) {
4243                     if (object.childElements.hasOwnProperty(el)) {
4244                         object.childElements[el].board.removeObject(object.childElements[el]);
4245                     }
4246                 }
4247 
4248                 // Remove all children in elements like turtle
4249                 for (el in object.objects) {
4250                     if (object.objects.hasOwnProperty(el)) {
4251                         object.objects[el].board.removeObject(object.objects[el]);
4252                     }
4253                 }
4254 
4255                 // Remove the element from the childElement list and the descendant list of all elements.
4256                 if (saveMethod) {
4257                     // Running through all objects has quadratic complexity if many objects are deleted.
4258                     for (el in this.objects) {
4259                         if (this.objects.hasOwnProperty(el)) {
4260                             if (Type.exists(this.objects[el].childElements) &&
4261                                 Type.exists(this.objects[el].childElements.hasOwnProperty(object.id))
4262                             ) {
4263                                 delete this.objects[el].childElements[object.id];
4264                                 delete this.objects[el].descendants[object.id];
4265                             }
4266                         }
4267                     }
4268                 } else if (Type.exists(object.ancestors)) {
4269                     // Running through the ancestors should be much more efficient.
4270                     for (el in object.ancestors) {
4271                         if (object.ancestors.hasOwnProperty(el)) {
4272                             if (Type.exists(object.ancestors[el].childElements) &&
4273                                 Type.exists(object.ancestors[el].childElements.hasOwnProperty(object.id))
4274                             ) {
4275                                 delete object.ancestors[el].childElements[object.id];
4276                                 delete object.ancestors[el].descendants[object.id];
4277                             }
4278                         }
4279                     }
4280                 }
4281 
4282                 // remove the object itself from our control structures
4283                 if (object._pos > -1) {
4284                     this.objectsList.splice(object._pos, 1);
4285                     for (el = object._pos; el < this.objectsList.length; el++) {
4286                         this.objectsList[el]._pos--;
4287                     }
4288                 } else if (object.type !== Const.OBJECT_TYPE_TURTLE) {
4289                     JXG.debug('Board.removeObject: object ' + object.id + ' not found in list.');
4290                 }
4291 
4292                 delete this.objects[object.id];
4293                 delete this.elementsByName[object.name];
4294 
4295                 if (object.visProp && Type.evaluate(object.visProp.trace)) {
4296                     object.clearTrace();
4297                 }
4298 
4299                 // the object deletion itself is handled by the object.
4300                 if (Type.exists(object.remove)) {
4301                     object.remove();
4302                 }
4303             } catch (e) {
4304                 JXG.debug(object.id + ': Could not be removed: ' + e);
4305             }
4306 
4307             this.update();
4308 
4309             return this;
4310         },
4311 
4312         /**
4313          * Removes the ancestors of an object an the object itself from board and renderer.
4314          * @param {JXG.GeometryElement} object The object to remove.
4315          * @returns {JXG.Board} Reference to the board
4316          */
4317         removeAncestors: function (object) {
4318             var anc;
4319 
4320             for (anc in object.ancestors) {
4321                 if (object.ancestors.hasOwnProperty(anc)) {
4322                     this.removeAncestors(object.ancestors[anc]);
4323                 }
4324             }
4325 
4326             this.removeObject(object);
4327 
4328             return this;
4329         },
4330 
4331         /**
4332          * Initialize some objects which are contained in every GEONExT construction by default,
4333          * but are not contained in the gxt files.
4334          * @returns {JXG.Board} Reference to the board
4335          */
4336         initGeonextBoard: function () {
4337             var p1, p2, p3;
4338 
4339             p1 = this.create('point', [0, 0], {
4340                 id: this.id + 'g00e0',
4341                 name: 'Ursprung',
4342                 withLabel: false,
4343                 visible: false,
4344                 fixed: true
4345             });
4346 
4347             p2 = this.create('point', [1, 0], {
4348                 id: this.id + 'gX0e0',
4349                 name: 'Punkt_1_0',
4350                 withLabel: false,
4351                 visible: false,
4352                 fixed: true
4353             });
4354 
4355             p3 = this.create('point', [0, 1], {
4356                 id: this.id + 'gY0e0',
4357                 name: 'Punkt_0_1',
4358                 withLabel: false,
4359                 visible: false,
4360                 fixed: true
4361             });
4362 
4363             this.create('line', [p1, p2], {
4364                 id: this.id + 'gXLe0',
4365                 name: 'X-Achse',
4366                 withLabel: false,
4367                 visible: false
4368             });
4369 
4370             this.create('line', [p1, p3], {
4371                 id: this.id + 'gYLe0',
4372                 name: 'Y-Achse',
4373                 withLabel: false,
4374                 visible: false
4375             });
4376 
4377             return this;
4378         },
4379 
4380         /**
4381          * Change the height and width of the board's container.
4382          * After doing so, {@link JXG.JSXGraph.setBoundingBox} is called using
4383          * the actual size of the bounding box and the actual value of keepaspectratio.
4384          * If setBoundingbox() should not be called automatically,
4385          * call resizeContainer with dontSetBoundingBox == true.
4386          * @param {Number} canvasWidth New width of the container.
4387          * @param {Number} canvasHeight New height of the container.
4388          * @param {Boolean} [dontset=false] If true do not set the CSS width and height of the DOM element.
4389          * @param {Boolean} [dontSetBoundingBox=false] If true do not call setBoundingBox().
4390          * @returns {JXG.Board} Reference to the board
4391          */
4392         resizeContainer: function (canvasWidth, canvasHeight, dontset, dontSetBoundingBox) {
4393             var box;
4394                 // w, h, cx, cy;
4395                 // box_act,
4396                 // shift_x = 0,
4397                 // shift_y = 0;
4398 
4399             if (!dontSetBoundingBox) {
4400                 // box_act = this.getBoundingBox();    // This is the actual bounding box.
4401                 box = this.getBoundingBox();    // This is the actual bounding box.
4402             }
4403 
4404             this.canvasWidth = parseFloat(canvasWidth);
4405             this.canvasHeight = parseFloat(canvasHeight);
4406 
4407             // if (!dontSetBoundingBox) {
4408             //     box     = this.attr.boundingbox;    // This is the intended bounding box.
4409 
4410             //     // The shift values compensate the follow-up correction
4411             //     // in setBoundingBox in case of "this.keepaspectratio==true"
4412             //     // Otherwise, shift_x and shift_y will be zero.
4413             //     // Obsolet since setBoundingBox centers in case of "this.keepaspectratio==true".
4414             //     // shift_x = box_act[0] - box[0] / this.zoomX;
4415             //     // shift_y = box_act[1] - box[1] / this.zoomY;
4416 
4417             //     cx = (box[2] + box[0]) * 0.5; // + shift_x;
4418             //     cy = (box[3] + box[1]) * 0.5; // + shift_y;
4419 
4420             //     w = (box[2] - box[0]) * 0.5 / this.zoomX;
4421             //     h = (box[1] - box[3]) * 0.5 / this.zoomY;
4422 
4423             //     box = [cx - w, cy + h, cx + w, cy - h];
4424             // }
4425 
4426             if (!dontset) {
4427                 this.containerObj.style.width = (this.canvasWidth) + 'px';
4428                 this.containerObj.style.height = (this.canvasHeight) + 'px';
4429             }
4430             this.renderer.resize(this.canvasWidth, this.canvasHeight);
4431 
4432             if (!dontSetBoundingBox) {
4433                 this.setBoundingBox(box, this.keepaspectratio, 'keep');
4434             }
4435 
4436             return this;
4437         },
4438 
4439         /**
4440          * Lists the dependencies graph in a new HTML-window.
4441          * @returns {JXG.Board} Reference to the board
4442          */
4443         showDependencies: function () {
4444             var el, t, c, f, i;
4445 
4446             t = '<p>\n';
4447             for (el in this.objects) {
4448                 if (this.objects.hasOwnProperty(el)) {
4449                     i = 0;
4450                     for (c in this.objects[el].childElements) {
4451                         if (this.objects[el].childElements.hasOwnProperty(c)) {
4452                             i += 1;
4453                         }
4454                     }
4455                     if (i >= 0) {
4456                         t += '<strong>' + this.objects[el].id + ':<' + '/strong> ';
4457                     }
4458 
4459                     for (c in this.objects[el].childElements) {
4460                         if (this.objects[el].childElements.hasOwnProperty(c)) {
4461                             t += this.objects[el].childElements[c].id + '(' + this.objects[el].childElements[c].name + ')' + ', ';
4462                         }
4463                     }
4464                     t += '<p>\n';
4465                 }
4466             }
4467             t += '<' + '/p>\n';
4468             f = window.open();
4469             f.document.open();
4470             f.document.write(t);
4471             f.document.close();
4472             return this;
4473         },
4474 
4475         /**
4476          * Lists the XML code of the construction in a new HTML-window.
4477          * @returns {JXG.Board} Reference to the board
4478          */
4479         showXML: function () {
4480             var f = window.open('');
4481             f.document.open();
4482             f.document.write('<pre>' + Type.escapeHTML(this.xmlString) + '<' + '/pre>');
4483             f.document.close();
4484             return this;
4485         },
4486 
4487         /**
4488          * Sets for all objects the needsUpdate flag to "true".
4489          * @returns {JXG.Board} Reference to the board
4490          */
4491         prepareUpdate: function () {
4492             var el, pEl, len = this.objectsList.length;
4493 
4494             /*
4495             if (this.attr.updatetype === 'hierarchical') {
4496                 return this;
4497             }
4498             */
4499 
4500             for (el = 0; el < len; el++) {
4501                 pEl = this.objectsList[el];
4502                 pEl.needsUpdate = pEl.needsRegularUpdate || this.needsFullUpdate;
4503             }
4504 
4505             for (el in this.groups) {
4506                 if (this.groups.hasOwnProperty(el)) {
4507                     pEl = this.groups[el];
4508                     pEl.needsUpdate = pEl.needsRegularUpdate || this.needsFullUpdate;
4509                 }
4510             }
4511 
4512             return this;
4513         },
4514 
4515         /**
4516          * Runs through all elements and calls their update() method.
4517          * @param {JXG.GeometryElement} drag Element that caused the update.
4518          * @returns {JXG.Board} Reference to the board
4519          */
4520         updateElements: function (drag) {
4521             var el, pEl;
4522             //var childId, i = 0;
4523 
4524             drag = this.select(drag);
4525 
4526             /*
4527             if (Type.exists(drag)) {
4528                 for (el = 0; el < this.objectsList.length; el++) {
4529                     pEl = this.objectsList[el];
4530                     if (pEl.id === drag.id) {
4531                         i = el;
4532                         break;
4533                     }
4534                 }
4535             }
4536             */
4537 
4538             for (el = 0; el < this.objectsList.length; el++) {
4539                 pEl = this.objectsList[el];
4540                 if (this.needsFullUpdate && pEl.elementClass === Const.OBJECT_CLASS_TEXT) {
4541                     pEl.updateSize();
4542                 }
4543 
4544                 // For updates of an element we distinguish if the dragged element is updated or
4545                 // other elements are updated.
4546                 // The difference lies in the treatment of gliders and points based on transformations.
4547                 pEl.update(!Type.exists(drag) || pEl.id !== drag.id)
4548                    .updateVisibility();
4549             }
4550 
4551             // update groups last
4552             for (el in this.groups) {
4553                 if (this.groups.hasOwnProperty(el)) {
4554                     this.groups[el].update(drag);
4555                 }
4556             }
4557 
4558             return this;
4559         },
4560 
4561         /**
4562          * Runs through all elements and calls their update() method.
4563          * @returns {JXG.Board} Reference to the board
4564          */
4565         updateRenderer: function () {
4566             var el,
4567                 len = this.objectsList.length;
4568 
4569             /*
4570             objs = this.objectsList.slice(0);
4571             objs.sort(function (a, b) {
4572                 if (a.visProp.layer < b.visProp.layer) {
4573                     return -1;
4574                 } else if (a.visProp.layer === b.visProp.layer) {
4575                     return b.lastDragTime.getTime() - a.lastDragTime.getTime();
4576                 } else {
4577                     return 1;
4578                 }
4579             });
4580             */
4581 
4582             if (this.renderer.type === 'canvas') {
4583                 this.updateRendererCanvas();
4584             } else {
4585                 for (el = 0; el < len; el++) {
4586                     this.objectsList[el].updateRenderer();
4587                 }
4588             }
4589             return this;
4590         },
4591 
4592         /**
4593          * Runs through all elements and calls their update() method.
4594          * This is a special version for the CanvasRenderer.
4595          * Here, we have to do our own layer handling.
4596          * @returns {JXG.Board} Reference to the board
4597          */
4598         updateRendererCanvas: function () {
4599             var el, pEl, i, mini, la,
4600                 olen = this.objectsList.length,
4601                 layers = this.options.layer,
4602                 len = this.options.layer.numlayers,
4603                 last = Number.NEGATIVE_INFINITY;
4604 
4605             for (i = 0; i < len; i++) {
4606                 mini = Number.POSITIVE_INFINITY;
4607 
4608                 for (la in layers) {
4609                     if (layers.hasOwnProperty(la)) {
4610                         if (layers[la] > last && layers[la] < mini) {
4611                             mini = layers[la];
4612                         }
4613                     }
4614                 }
4615 
4616                 last = mini;
4617 
4618                 for (el = 0; el < olen; el++) {
4619                     pEl = this.objectsList[el];
4620 
4621                     if (pEl.visProp.layer === mini) {
4622                         pEl.prepareUpdate().updateRenderer();
4623                     }
4624                 }
4625             }
4626             return this;
4627         },
4628 
4629         /**
4630          * Please use {@link JXG.Board.on} instead.
4631          * @param {Function} hook A function to be called by the board after an update occurred.
4632          * @param {String} [m='update'] When the hook is to be called. Possible values are <i>mouseup</i>, <i>mousedown</i> and <i>update</i>.
4633          * @param {Object} [context=board] Determines the execution context the hook is called. This parameter is optional, default is the
4634          * board object the hook is attached to.
4635          * @returns {Number} Id of the hook, required to remove the hook from the board.
4636          * @deprecated
4637          */
4638         addHook: function (hook, m, context) {
4639             JXG.deprecated('Board.addHook()', 'Board.on()');
4640             m = Type.def(m, 'update');
4641 
4642             context = Type.def(context, this);
4643 
4644             this.hooks.push([m, hook]);
4645             this.on(m, hook, context);
4646 
4647             return this.hooks.length - 1;
4648         },
4649 
4650         /**
4651          * Alias of {@link JXG.Board.on}.
4652          */
4653         addEvent: JXG.shortcut(JXG.Board.prototype, 'on'),
4654 
4655         /**
4656          * Please use {@link JXG.Board.off} instead.
4657          * @param {Number|function} id The number you got when you added the hook or a reference to the event handler.
4658          * @returns {JXG.Board} Reference to the board
4659          * @deprecated
4660          */
4661         removeHook: function (id) {
4662             JXG.deprecated('Board.removeHook()', 'Board.off()');
4663             if (this.hooks[id]) {
4664                 this.off(this.hooks[id][0], this.hooks[id][1]);
4665                 this.hooks[id] = null;
4666             }
4667 
4668             return this;
4669         },
4670 
4671         /**
4672          * Alias of {@link JXG.Board.off}.
4673          */
4674         removeEvent: JXG.shortcut(JXG.Board.prototype, 'off'),
4675 
4676         /**
4677          * Runs through all hooked functions and calls them.
4678          * @returns {JXG.Board} Reference to the board
4679          * @deprecated
4680          */
4681         updateHooks: function (m) {
4682             var arg = Array.prototype.slice.call(arguments, 0);
4683 
4684             JXG.deprecated('Board.updateHooks()', 'Board.triggerEventHandlers()');
4685 
4686             arg[0] = Type.def(arg[0], 'update');
4687             this.triggerEventHandlers([arg[0]], arguments);
4688 
4689             return this;
4690         },
4691 
4692         /**
4693          * Adds a dependent board to this board.
4694          * @param {JXG.Board} board A reference to board which will be updated after an update of this board occurred.
4695          * @returns {JXG.Board} Reference to the board
4696          */
4697         addChild: function (board) {
4698             if (Type.exists(board) && Type.exists(board.containerObj)) {
4699                 this.dependentBoards.push(board);
4700                 this.update();
4701             }
4702             return this;
4703         },
4704 
4705         /**
4706          * Deletes a board from the list of dependent boards.
4707          * @param {JXG.Board} board Reference to the board which will be removed.
4708          * @returns {JXG.Board} Reference to the board
4709          */
4710         removeChild: function (board) {
4711             var i;
4712 
4713             for (i = this.dependentBoards.length - 1; i >= 0; i--) {
4714                 if (this.dependentBoards[i] === board) {
4715                     this.dependentBoards.splice(i, 1);
4716                 }
4717             }
4718             return this;
4719         },
4720 
4721         /**
4722          * Runs through most elements and calls their update() method and update the conditions.
4723          * @param {JXG.GeometryElement} [drag] Element that caused the update.
4724          * @returns {JXG.Board} Reference to the board
4725          */
4726         update: function (drag) {
4727             var i, len, b, insert,
4728                 storeActiveEl;
4729 
4730             if (this.inUpdate || this.isSuspendedUpdate) {
4731                 return this;
4732             }
4733             this.inUpdate = true;
4734 
4735             if (this.attr.minimizereflow === 'all' && this.containerObj && this.renderer.type !== 'vml') {
4736                 storeActiveEl = document.activeElement; // Store focus element
4737                 insert = this.renderer.removeToInsertLater(this.containerObj);
4738             }
4739 
4740             if (this.attr.minimizereflow === 'svg' && this.renderer.type === 'svg') {
4741                 storeActiveEl = document.activeElement;
4742                 insert = this.renderer.removeToInsertLater(this.renderer.svgRoot);
4743             }
4744 
4745             this.prepareUpdate().updateElements(drag).updateConditions();
4746             this.renderer.suspendRedraw(this);
4747             this.updateRenderer();
4748             this.renderer.unsuspendRedraw();
4749             this.triggerEventHandlers(['update'], []);
4750 
4751             if (insert) {
4752                 insert();
4753                 storeActiveEl.focus();     // Restore focus element
4754             }
4755 
4756             // To resolve dependencies between boards
4757             // for (var board in JXG.boards) {
4758             len = this.dependentBoards.length;
4759             for (i = 0; i < len; i++) {
4760                 b = this.dependentBoards[i];
4761                 if (Type.exists(b) && b !== this) {
4762                     b.updateQuality = this.updateQuality;
4763                     b.prepareUpdate().updateElements().updateConditions();
4764                     b.renderer.suspendRedraw();
4765                     b.updateRenderer();
4766                     b.renderer.unsuspendRedraw();
4767                     b.triggerEventHandlers(['update'], []);
4768                 }
4769 
4770             }
4771 
4772             this.inUpdate = false;
4773             return this;
4774         },
4775 
4776         /**
4777          * Runs through all elements and calls their update() method and update the conditions.
4778          * This is necessary after zooming and changing the bounding box.
4779          * @returns {JXG.Board} Reference to the board
4780          */
4781         fullUpdate: function () {
4782             this.needsFullUpdate = true;
4783             this.update();
4784             this.needsFullUpdate = false;
4785             return this;
4786         },
4787 
4788         /**
4789          * Adds a grid to the board according to the settings given in board.options.
4790          * @returns {JXG.Board} Reference to the board.
4791          */
4792         addGrid: function () {
4793             this.create('grid', []);
4794 
4795             return this;
4796         },
4797 
4798         /**
4799          * Removes all grids assigned to this board. Warning: This method also removes all objects depending on one or
4800          * more of the grids.
4801          * @returns {JXG.Board} Reference to the board object.
4802          */
4803         removeGrids: function () {
4804             var i;
4805 
4806             for (i = 0; i < this.grids.length; i++) {
4807                 this.removeObject(this.grids[i]);
4808             }
4809 
4810             this.grids.length = 0;
4811             this.update(); // required for canvas renderer
4812 
4813             return this;
4814         },
4815 
4816         /**
4817          * Creates a new geometric element of type elementType.
4818          * @param {String} elementType Type of the element to be constructed given as a string e.g. 'point' or 'circle'.
4819          * @param {Array} parents Array of parent elements needed to construct the element e.g. coordinates for a point or two
4820          * points to construct a line. This highly depends on the elementType that is constructed. See the corresponding JXG.create*
4821          * methods for a list of possible parameters.
4822          * @param {Object} [attributes] An object containing the attributes to be set. This also depends on the elementType.
4823          * Common attributes are name, visible, strokeColor.
4824          * @returns {Object} Reference to the created element. This is usually a GeometryElement, but can be an array containing
4825          * two or more elements.
4826          */
4827         create: function (elementType, parents, attributes) {
4828             var el, i;
4829 
4830             elementType = elementType.toLowerCase();
4831 
4832             if (!Type.exists(parents)) {
4833                 parents = [];
4834             }
4835 
4836             if (!Type.exists(attributes)) {
4837                 attributes = {};
4838             }
4839 
4840             for (i = 0; i < parents.length; i++) {
4841                 if (Type.isString(parents[i]) &&
4842                     !(elementType === 'text' && i === 2) &&
4843                     !((elementType === 'input' || elementType === 'checkbox' || elementType === 'button') &&
4844                       (i === 2 || i === 3)) &&
4845                     !(elementType === 'curve' && i > 0) // Allow curve plots with jessiecode
4846                 ) {
4847                     parents[i] = this.select(parents[i]);
4848                 }
4849             }
4850 
4851             if (Type.isFunction(JXG.elements[elementType])) {
4852                 el = JXG.elements[elementType](this, parents, attributes);
4853             } else {
4854                 throw new Error("JSXGraph: create: Unknown element type given: " + elementType);
4855             }
4856 
4857             if (!Type.exists(el)) {
4858                 JXG.debug("JSXGraph: create: failure creating " + elementType);
4859                 return el;
4860             }
4861 
4862             if (el.prepareUpdate && el.update && el.updateRenderer) {
4863                 el.fullUpdate();
4864             }
4865             return el;
4866         },
4867 
4868         /**
4869          * Deprecated name for {@link JXG.Board.create}.
4870          * @deprecated
4871          */
4872         createElement: function () {
4873             JXG.deprecated('Board.createElement()', 'Board.create()');
4874             return this.create.apply(this, arguments);
4875         },
4876 
4877         /**
4878          * Delete the elements drawn as part of a trace of an element.
4879          * @returns {JXG.Board} Reference to the board
4880          */
4881         clearTraces: function () {
4882             var el;
4883 
4884             for (el = 0; el < this.objectsList.length; el++) {
4885                 this.objectsList[el].clearTrace();
4886             }
4887 
4888             this.numTraces = 0;
4889             return this;
4890         },
4891 
4892         /**
4893          * Stop updates of the board.
4894          * @returns {JXG.Board} Reference to the board
4895          */
4896         suspendUpdate: function () {
4897             if (!this.inUpdate) {
4898                 this.isSuspendedUpdate = true;
4899             }
4900             return this;
4901         },
4902 
4903         /**
4904          * Enable updates of the board.
4905          * @returns {JXG.Board} Reference to the board
4906          */
4907         unsuspendUpdate: function () {
4908             if (this.isSuspendedUpdate) {
4909                 this.isSuspendedUpdate = false;
4910                 this.fullUpdate();
4911             }
4912             return this;
4913         },
4914 
4915         /**
4916          * Set the bounding box of the board.
4917          * @param {Array} bbox New bounding box [x1,y1,x2,y2]
4918          * @param {Boolean} [keepaspectratio=false] If set to true, the aspect ratio will be 1:1, but
4919          * the resulting viewport may be larger.
4920          * @param {String} [setZoom='reset'] Reset, keep or update the zoom level of the board. 'reset'
4921          * sets {@link JXG.Board#zoomX} and {@link JXG.Board#zoomY} to the start values (or 1.0).
4922          * 'update' adapts these values accoring to the new bounding box and 'keep' does nothing.
4923          * @returns {JXG.Board} Reference to the board
4924          */
4925         setBoundingBox: function (bbox, keepaspectratio, setZoom) {
4926             var h, w, ux, uy,
4927                 offX = 0,
4928                 offY = 0,
4929                 dim = Env.getDimensions(this.container, this.document);
4930 
4931             if (!Type.isArray(bbox)) {
4932                 return this;
4933             }
4934 
4935             if (bbox[0] < this.maxboundingbox[0] ||
4936                 bbox[1] > this.maxboundingbox[1] ||
4937                 bbox[2] > this.maxboundingbox[2] ||
4938                 bbox[3] < this.maxboundingbox[3]) {
4939                 return this;
4940             }
4941 
4942             if (!Type.exists(setZoom)) {
4943                 setZoom = 'reset';
4944             }
4945 
4946             ux = this.unitX;
4947             uy = this.unitY;
4948 
4949             this.canvasWidth = parseInt(dim.width, 10);
4950             this.canvasHeight = parseInt(dim.height, 10);
4951             w = this.canvasWidth;
4952             h = this.canvasHeight;
4953             if (keepaspectratio) {
4954                 this.unitX = w / (bbox[2] - bbox[0]);
4955                 this.unitY = h / (bbox[1] - bbox[3]);
4956                 if (Math.abs(this.unitX) < Math.abs(this.unitY)) {
4957                     this.unitY = Math.abs(this.unitX) * this.unitY / Math.abs(this.unitY);
4958                     // Add the additional units in equal portions above and below
4959                     offY = (h / this.unitY - (bbox[1] - bbox[3])) * 0.5;
4960                 } else {
4961                     this.unitX = Math.abs(this.unitY) * this.unitX / Math.abs(this.unitX);
4962                     // Add the additional units in equal portions left and right
4963                     offX = (w / this.unitX - (bbox[2] - bbox[0])) * 0.5;
4964                 }
4965                 this.keepaspectratio = true;
4966             } else {
4967                 this.unitX = w / (bbox[2] - bbox[0]);
4968                 this.unitY = h / (bbox[1] - bbox[3]);
4969                 this.keepaspectratio = false;
4970             }
4971 
4972             this.moveOrigin(-this.unitX * (bbox[0] - offX), this.unitY * (bbox[1] + offY));
4973 
4974             if (setZoom === 'update') {
4975                 this.zoomX *= this.unitX / ux;
4976                 this.zoomY *= this.unitY / uy;
4977             } else if (setZoom === 'reset') {
4978                 this.zoomX = Type.exists(this.attr.zoomx) ? this.attr.zoomx : 1.0;
4979                 this.zoomY = Type.exists(this.attr.zoomy) ? this.attr.zoomy : 1.0;
4980             }
4981 
4982             return this;
4983         },
4984 
4985         /**
4986          * Get the bounding box of the board.
4987          * @returns {Array} bounding box [x1,y1,x2,y2] upper left corner, lower right corner
4988          */
4989         getBoundingBox: function () {
4990             var ul = (new Coords(Const.COORDS_BY_SCREEN, [0, 0], this)).usrCoords,
4991                 lr = (new Coords(Const.COORDS_BY_SCREEN, [this.canvasWidth, this.canvasHeight], this)).usrCoords;
4992 
4993             return [ul[1], ul[2], lr[1], lr[2]];
4994         },
4995 
4996         /**
4997          * Adds an animation. Animations are controlled by the boards, so the boards need to be aware of the
4998          * animated elements. This function tells the board about new elements to animate.
4999          * @param {JXG.GeometryElement} element The element which is to be animated.
5000          * @returns {JXG.Board} Reference to the board
5001          */
5002         addAnimation: function (element) {
5003             var that = this;
5004 
5005             this.animationObjects[element.id] = element;
5006 
5007             if (!this.animationIntervalCode) {
5008                 this.animationIntervalCode = window.setInterval(function () {
5009                     that.animate();
5010                 }, element.board.attr.animationdelay);
5011             }
5012 
5013             return this;
5014         },
5015 
5016         /**
5017          * Cancels all running animations.
5018          * @returns {JXG.Board} Reference to the board
5019          */
5020         stopAllAnimation: function () {
5021             var el;
5022 
5023             for (el in this.animationObjects) {
5024                 if (this.animationObjects.hasOwnProperty(el) && Type.exists(this.animationObjects[el])) {
5025                     this.animationObjects[el] = null;
5026                     delete this.animationObjects[el];
5027                 }
5028             }
5029 
5030             window.clearInterval(this.animationIntervalCode);
5031             delete this.animationIntervalCode;
5032 
5033             return this;
5034         },
5035 
5036         /**
5037          * General purpose animation function. This currently only supports moving points from one place to another. This
5038          * is faster than managing the animation per point, especially if there is more than one animated point at the same time.
5039          * @returns {JXG.Board} Reference to the board
5040          */
5041         animate: function () {
5042             var props, el, o, newCoords, r, p, c, cbtmp,
5043                 count = 0,
5044                 obj = null;
5045 
5046             for (el in this.animationObjects) {
5047                 if (this.animationObjects.hasOwnProperty(el) && Type.exists(this.animationObjects[el])) {
5048                     count += 1;
5049                     o = this.animationObjects[el];
5050 
5051                     if (o.animationPath) {
5052                         if (Type.isFunction(o.animationPath)) {
5053                             newCoords = o.animationPath(new Date().getTime() - o.animationStart);
5054                         } else {
5055                             newCoords = o.animationPath.pop();
5056                         }
5057 
5058                         if ((!Type.exists(newCoords)) || (!Type.isArray(newCoords) && isNaN(newCoords))) {
5059                             delete o.animationPath;
5060                         } else {
5061                             o.setPositionDirectly(Const.COORDS_BY_USER, newCoords);
5062                             o.fullUpdate();
5063                             obj = o;
5064                         }
5065                     }
5066                     if (o.animationData) {
5067                         c = 0;
5068 
5069                         for (r in o.animationData) {
5070                             if (o.animationData.hasOwnProperty(r)) {
5071                                 p = o.animationData[r].pop();
5072 
5073                                 if (!Type.exists(p)) {
5074                                     delete o.animationData[p];
5075                                 } else {
5076                                     c += 1;
5077                                     props = {};
5078                                     props[r] = p;
5079                                     o.setAttribute(props);
5080                                 }
5081                             }
5082                         }
5083 
5084                         if (c === 0) {
5085                             delete o.animationData;
5086                         }
5087                     }
5088 
5089                     if (!Type.exists(o.animationData) && !Type.exists(o.animationPath)) {
5090                         this.animationObjects[el] = null;
5091                         delete this.animationObjects[el];
5092 
5093                         if (Type.exists(o.animationCallback)) {
5094                             cbtmp = o.animationCallback;
5095                             o.animationCallback = null;
5096                             cbtmp();
5097                         }
5098                     }
5099                 }
5100             }
5101 
5102             if (count === 0) {
5103                 window.clearInterval(this.animationIntervalCode);
5104                 delete this.animationIntervalCode;
5105             } else {
5106                 this.update(obj);
5107             }
5108 
5109             return this;
5110         },
5111 
5112         /**
5113          * Migrate the dependency properties of the point src
5114          * to the point dest and  delete the point src.
5115          * For example, a circle around the point src
5116          * receives the new center dest. The old center src
5117          * will be deleted.
5118          * @param {JXG.Point} src Original point which will be deleted
5119          * @param {JXG.Point} dest New point with the dependencies of src.
5120          * @param {Boolean} copyName Flag which decides if the name of the src element is copied to the
5121          *  dest element.
5122          * @returns {JXG.Board} Reference to the board
5123          */
5124         migratePoint: function (src, dest, copyName) {
5125             var child, childId, prop, found, i, srcLabelId, srcHasLabel = false;
5126 
5127             src = this.select(src);
5128             dest = this.select(dest);
5129 
5130             if (Type.exists(src.label)) {
5131                 srcLabelId = src.label.id;
5132                 srcHasLabel = true;
5133                 this.removeObject(src.label);
5134             }
5135 
5136             for (childId in src.childElements) {
5137                 if (src.childElements.hasOwnProperty(childId)) {
5138                     child = src.childElements[childId];
5139                     found = false;
5140 
5141                     for (prop in child) {
5142                         if (child.hasOwnProperty(prop)) {
5143                             if (child[prop] ===  src) {
5144                                 child[prop] = dest;
5145                                 found = true;
5146                             }
5147                         }
5148                     }
5149 
5150                     if (found) {
5151                         delete src.childElements[childId];
5152                     }
5153 
5154                     for (i = 0; i < child.parents.length; i++) {
5155                         if (child.parents[i] === src.id) {
5156                             child.parents[i] = dest.id;
5157                         }
5158                     }
5159 
5160                     dest.addChild(child);
5161                 }
5162             }
5163 
5164             // The destination object should receive the name
5165             // and the label of the originating (src) object
5166             if (copyName) {
5167                 if (srcHasLabel) {
5168                     delete dest.childElements[srcLabelId];
5169                     delete dest.descendants[srcLabelId];
5170                 }
5171 
5172                 if (dest.label) {
5173                     this.removeObject(dest.label);
5174                 }
5175 
5176                 delete this.elementsByName[dest.name];
5177                 dest.name = src.name;
5178                 if (srcHasLabel) {
5179                     dest.createLabel();
5180                 }
5181             }
5182 
5183             this.removeObject(src);
5184 
5185             if (Type.exists(dest.name) && dest.name !== '') {
5186                 this.elementsByName[dest.name] = dest;
5187             }
5188 
5189             this.fullUpdate();
5190 
5191             return this;
5192         },
5193 
5194         /**
5195          * Initializes color blindness simulation.
5196          * @param {String} deficiency Describes the color blindness deficiency which is simulated. Accepted values are 'protanopia', 'deuteranopia', and 'tritanopia'.
5197          * @returns {JXG.Board} Reference to the board
5198          */
5199         emulateColorblindness: function (deficiency) {
5200             var e, o;
5201 
5202             if (!Type.exists(deficiency)) {
5203                 deficiency = 'none';
5204             }
5205 
5206             if (this.currentCBDef === deficiency) {
5207                 return this;
5208             }
5209 
5210             for (e in this.objects) {
5211                 if (this.objects.hasOwnProperty(e)) {
5212                     o = this.objects[e];
5213 
5214                     if (deficiency !== 'none') {
5215                         if (this.currentCBDef === 'none') {
5216                             // this could be accomplished by JXG.extend, too. But do not use
5217                             // JXG.deepCopy as this could result in an infinite loop because in
5218                             // visProp there could be geometry elements which contain the board which
5219                             // contains all objects which contain board etc.
5220                             o.visPropOriginal = {
5221                                 strokecolor: o.visProp.strokecolor,
5222                                 fillcolor: o.visProp.fillcolor,
5223                                 highlightstrokecolor: o.visProp.highlightstrokecolor,
5224                                 highlightfillcolor: o.visProp.highlightfillcolor
5225                             };
5226                         }
5227                         o.setAttribute({
5228                             strokecolor: Color.rgb2cb(Type.evaluate(o.visPropOriginal.strokecolor), deficiency),
5229                             fillcolor: Color.rgb2cb(Type.evaluate(o.visPropOriginal.fillcolor), deficiency),
5230                             highlightstrokecolor: Color.rgb2cb(Type.evaluate(o.visPropOriginal.highlightstrokecolor), deficiency),
5231                             highlightfillcolor: Color.rgb2cb(Type.evaluate(o.visPropOriginal.highlightfillcolor), deficiency)
5232                         });
5233                     } else if (Type.exists(o.visPropOriginal)) {
5234                         JXG.extend(o.visProp, o.visPropOriginal);
5235                     }
5236                 }
5237             }
5238             this.currentCBDef = deficiency;
5239             this.update();
5240 
5241             return this;
5242         },
5243 
5244         /**
5245          * Select a single or multiple elements at once.
5246          * @param {String|Object|function} str The name, id or a reference to a JSXGraph element on this board. An object will
5247          * be used as a filter to return multiple elements at once filtered by the properties of the object.
5248          * @param {Boolean} onlyByIdOrName If true (default:false) elements are only filtered by their id, name or groupId.
5249          * The advanced filters consisting of objects or functions are ignored.
5250          * @returns {JXG.GeometryElement|JXG.Composition}
5251          * @example
5252          * // select the element with name A
5253          * board.select('A');
5254          *
5255          * // select all elements with strokecolor set to 'red' (but not '#ff0000')
5256          * board.select({
5257          *   strokeColor: 'red'
5258          * });
5259          *
5260          * // select all points on or below the x axis and make them black.
5261          * board.select({
5262          *   elementClass: JXG.OBJECT_CLASS_POINT,
5263          *   Y: function (v) {
5264          *     return v <= 0;
5265          *   }
5266          * }).setAttribute({color: 'black'});
5267          *
5268          * // select all elements
5269          * board.select(function (el) {
5270          *   return true;
5271          * });
5272          */
5273         select: function (str, onlyByIdOrName) {
5274             var flist, olist, i, l,
5275                 s = str;
5276 
5277             if (s === null) {
5278                 return s;
5279             }
5280 
5281             // it's a string, most likely an id or a name.
5282             if (Type.isString(s) && s !== '') {
5283                 // Search by ID
5284                 if (Type.exists(this.objects[s])) {
5285                     s = this.objects[s];
5286                 // Search by name
5287                 } else if (Type.exists(this.elementsByName[s])) {
5288                     s = this.elementsByName[s];
5289                 // Search by group ID
5290                 } else if (Type.exists(this.groups[s])) {
5291                     s = this.groups[s];
5292                 }
5293             // it's a function or an object, but not an element
5294             } else if (!onlyByIdOrName &&
5295                 (Type.isFunction(s) ||
5296                  (Type.isObject(s) && !Type.isFunction(s.setAttribute))
5297                 )) {
5298                 flist = Type.filterElements(this.objectsList, s);
5299 
5300                 olist = {};
5301                 l = flist.length;
5302                 for (i = 0; i < l; i++) {
5303                     olist[flist[i].id] = flist[i];
5304                 }
5305                 s = new Composition(olist);
5306             // it's an element which has been deleted (and still hangs around, e.g. in an attractor list
5307             } else if (Type.isObject(s) && Type.exists(s.id) && !Type.exists(this.objects[s.id])) {
5308                 s = null;
5309             }
5310 
5311             return s;
5312         },
5313 
5314         /**
5315          * Checks if the given point is inside the boundingbox.
5316          * @param {Number|JXG.Coords} x User coordinate or {@link JXG.Coords} object.
5317          * @param {Number} [y] User coordinate. May be omitted in case <tt>x</tt> is a {@link JXG.Coords} object.
5318          * @returns {Boolean}
5319          */
5320         hasPoint: function (x, y) {
5321             var px = x,
5322                 py = y,
5323                 bbox = this.getBoundingBox();
5324 
5325             if (Type.exists(x) && Type.isArray(x.usrCoords)) {
5326                 px = x.usrCoords[1];
5327                 py = x.usrCoords[2];
5328             }
5329 
5330             return !!(Type.isNumber(px) && Type.isNumber(py) &&
5331                 bbox[0] < px && px < bbox[2] && bbox[1] > py && py > bbox[3]);
5332         },
5333 
5334         /**
5335          * Update CSS transformations of type scaling. It is used to correct the mouse position
5336          * in {@link JXG.Board.getMousePosition}.
5337          * The inverse transformation matrix is updated on each mouseDown and touchStart event.
5338          *
5339          * It is up to the user to call this method after an update of the CSS transformation
5340          * in the DOM.
5341          */
5342         updateCSSTransforms: function () {
5343             var obj = this.containerObj,
5344                 o = obj,
5345                 o2 = obj;
5346 
5347             this.cssTransMat = Env.getCSSTransformMatrix(o);
5348 
5349             /*
5350              * In Mozilla and Webkit: offsetParent seems to jump at least to the next iframe,
5351              * if not to the body. In IE and if we are in an position:absolute environment
5352              * offsetParent walks up the DOM hierarchy.
5353              * In order to walk up the DOM hierarchy also in Mozilla and Webkit
5354              * we need the parentNode steps.
5355              */
5356             o = o.offsetParent;
5357             while (o) {
5358                 this.cssTransMat = Mat.matMatMult(Env.getCSSTransformMatrix(o), this.cssTransMat);
5359 
5360                 o2 = o2.parentNode;
5361                 while (o2 !== o) {
5362                     this.cssTransMat = Mat.matMatMult(Env.getCSSTransformMatrix(o), this.cssTransMat);
5363                     o2 = o2.parentNode;
5364                 }
5365 
5366                 o = o.offsetParent;
5367             }
5368             this.cssTransMat = Mat.inverse(this.cssTransMat);
5369 
5370             return this;
5371         },
5372 
5373         /**
5374          * Start selection mode. This function can either be triggered from outside or by
5375          * a down event together with correct key pressing. The default keys are
5376          * shift+ctrl. But this can be changed in the options.
5377          *
5378          * Starting from out side can be realized for example with a button like this:
5379          * <pre>
5380          * 	<button onclick="board.startSelectionMode()">Start</button>
5381          * </pre>
5382          * @example
5383          * //
5384          * // Set a new bounding box from the selection rectangle
5385          * //
5386          * var board = JXG.JSXGraph.initBoard('jxgbox', {
5387          *         boundingBox:[-3,2,3,-2],
5388          *         keepAspectRatio: false,
5389          *         axis:true,
5390          *         selection: {
5391          *             enabled: true,
5392          *             needShift: false,
5393          *             needCtrl: true,
5394          *             withLines: false,
5395          *             vertices: {
5396          *                 visible: false
5397          *             },
5398          *             fillColor: '#ffff00',
5399          *         }
5400          *      });
5401          *
5402          * var f = function f(x) { return Math.cos(x); },
5403          *     curve = board.create('functiongraph', [f]);
5404          *
5405          * board.on('stopselecting', function(){
5406          *     var box = board.stopSelectionMode(),
5407          *
5408          *         // bbox has the coordinates of the selection rectangle.
5409          *         // Attention: box[i].usrCoords have the form [1, x, y], i.e.
5410          *         // are homogeneous coordinates.
5411          *         bbox = box[0].usrCoords.slice(1).concat(box[1].usrCoords.slice(1));
5412          *
5413          *         // Set a new bounding box
5414          *         board.setBoundingBox(bbox, false);
5415          *  });
5416          *
5417          *
5418          * </pre><div class="jxgbox" id="JXG11eff3a6-8c50-11e5-b01d-901b0e1b8723" style="width: 300px; height: 300px;"></div>
5419          * <script type="text/javascript">
5420          *     (function() {
5421          *     //
5422          *     // Set a new bounding box from the selection rectangle
5423          *     //
5424          *     var board = JXG.JSXGraph.initBoard('JXG11eff3a6-8c50-11e5-b01d-901b0e1b8723', {
5425          *             boundingBox:[-3,2,3,-2],
5426          *             keepAspectRatio: false,
5427          *             axis:true,
5428          *             selection: {
5429          *                 enabled: true,
5430          *                 needShift: false,
5431          *                 needCtrl: true,
5432          *                 withLines: false,
5433          *                 vertices: {
5434          *                     visible: false
5435          *                 },
5436          *                 fillColor: '#ffff00',
5437          *             }
5438          *        });
5439          *
5440          *     var f = function f(x) { return Math.cos(x); },
5441          *         curve = board.create('functiongraph', [f]);
5442          *
5443          *     board.on('stopselecting', function(){
5444          *         var box = board.stopSelectionMode(),
5445          *
5446          *             // bbox has the coordinates of the selection rectangle.
5447          *             // Attention: box[i].usrCoords have the form [1, x, y], i.e.
5448          *             // are homogeneous coordinates.
5449          *             bbox = box[0].usrCoords.slice(1).concat(box[1].usrCoords.slice(1));
5450          *
5451          *             // Set a new bounding box
5452          *             board.setBoundingBox(bbox, false);
5453          *      });
5454          *     })();
5455          *
5456          * </script><pre>
5457          *
5458          */
5459         startSelectionMode: function () {
5460             this.selectingMode = true;
5461             this.selectionPolygon.setAttribute({visible: true});
5462             this.selectingBox = [[0, 0], [0, 0]];
5463             this._setSelectionPolygonFromBox();
5464             this.selectionPolygon.fullUpdate();
5465         },
5466 
5467         /**
5468          * Finalize the selection: disable selection mode and return the coordinates
5469          * of the selection rectangle.
5470          * @returns {Array} Coordinates of the selection rectangle. The array
5471          * contains two {@link JXG.Coords} objects. One the upper left corner and
5472          * the second for the lower right corner.
5473          */
5474         stopSelectionMode: function () {
5475             this.selectingMode = false;
5476             this.selectionPolygon.setAttribute({visible: false});
5477             return [this.selectionPolygon.vertices[0].coords, this.selectionPolygon.vertices[2].coords];
5478         },
5479 
5480         /**
5481          * Start the selection of a region.
5482          * @private
5483          * @param  {Array} pos Screen coordiates of the upper left corner of the
5484          * selection rectangle.
5485          */
5486         _startSelecting: function (pos) {
5487             this.isSelecting = true;
5488             this.selectingBox = [ [pos[0], pos[1]], [pos[0], pos[1]] ];
5489             this._setSelectionPolygonFromBox();
5490         },
5491 
5492         /**
5493          * Update the selection rectangle during a move event.
5494          * @private
5495          * @param  {Array} pos Screen coordiates of the move event
5496          */
5497         _moveSelecting: function (pos) {
5498             if (this.isSelecting) {
5499                 this.selectingBox[1] = [pos[0], pos[1]];
5500                 this._setSelectionPolygonFromBox();
5501                 this.selectionPolygon.fullUpdate();
5502             }
5503         },
5504 
5505         /**
5506          * Update the selection rectangle during an up event. Stop selection.
5507          * @private
5508          * @param  {Object} evt Event object
5509          */
5510         _stopSelecting:  function (evt) {
5511             var pos = this.getMousePosition(evt);
5512 
5513             this.isSelecting = false;
5514             this.selectingBox[1] = [pos[0], pos[1]];
5515             this._setSelectionPolygonFromBox();
5516         },
5517 
5518         /**
5519          * Update the Selection rectangle.
5520          * @private
5521          */
5522         _setSelectionPolygonFromBox: function () {
5523                var A = this.selectingBox[0],
5524                 B = this.selectingBox[1];
5525 
5526                this.selectionPolygon.vertices[0].setPositionDirectly(JXG.COORDS_BY_SCREEN, [A[0], A[1]]);
5527                this.selectionPolygon.vertices[1].setPositionDirectly(JXG.COORDS_BY_SCREEN, [A[0], B[1]]);
5528                this.selectionPolygon.vertices[2].setPositionDirectly(JXG.COORDS_BY_SCREEN, [B[0], B[1]]);
5529                this.selectionPolygon.vertices[3].setPositionDirectly(JXG.COORDS_BY_SCREEN, [B[0], A[1]]);
5530         },
5531 
5532         /**
5533          * Test if a down event should start a selection. Test if the
5534          * required keys are pressed. If yes, {@link JXG.Board.startSelectionMode} is called.
5535          * @param  {Object} evt Event object
5536          */
5537         _testForSelection: function (evt) {
5538             if (this._isRequiredKeyPressed(evt, 'selection')) {
5539                 if (!Type.exists(this.selectionPolygon)) {
5540                     this._createSelectionPolygon(this.attr);
5541                 }
5542                 this.startSelectionMode();
5543             }
5544         },
5545 
5546         /**
5547          * Create the internal selection polygon, which will be available as board.selectionPolygon.
5548          * @private
5549          * @param  {Object} attr board attributes, e.g. the subobject board.attr.
5550          * @returns {Object} pointer to the board to enable chaining.
5551          */
5552         _createSelectionPolygon: function(attr) {
5553             var selectionattr;
5554 
5555             if (!Type.exists(this.selectionPolygon)) {
5556                 selectionattr = Type.copyAttributes(attr, Options, 'board', 'selection');
5557                 if (selectionattr.enabled === true) {
5558                     this.selectionPolygon = this.create('polygon', [[0, 0], [0, 0], [0, 0], [0, 0]], selectionattr);
5559                 }
5560             }
5561 
5562             return this;
5563         },
5564 
5565         /* **************************
5566          *     EVENT DEFINITION
5567          * for documentation purposes
5568          * ************************** */
5569 
5570         //region Event handler documentation
5571 
5572         /**
5573          * @event
5574          * @description Whenever the user starts to touch or click the board.
5575          * @name JXG.Board#down
5576          * @param {Event} e The browser's event object.
5577          */
5578         __evt__down: function (e) { },
5579 
5580         /**
5581          * @event
5582          * @description Whenever the user starts to click on the board.
5583          * @name JXG.Board#mousedown
5584          * @param {Event} e The browser's event object.
5585          */
5586         __evt__mousedown: function (e) { },
5587 
5588         /**
5589          * @event
5590          * @description Whenever the user taps the pen on the board.
5591          * @name JXG.Board#pendown
5592          * @param {Event} e The browser's event object.
5593          */
5594         __evt__pendown: function (e) { },
5595 
5596         /**
5597          * @event
5598          * @description Whenever the user starts to click on the board with a
5599          * device sending pointer events.
5600          * @name JXG.Board#pointerdown
5601          * @param {Event} e The browser's event object.
5602          */
5603         __evt__pointerdown: function (e) { },
5604 
5605         /**
5606          * @event
5607          * @description Whenever the user starts to touch the board.
5608          * @name JXG.Board#touchstart
5609          * @param {Event} e The browser's event object.
5610          */
5611         __evt__touchstart: function (e) { },
5612 
5613         /**
5614          * @event
5615          * @description Whenever the user stops to touch or click the board.
5616          * @name JXG.Board#up
5617          * @param {Event} e The browser's event object.
5618          */
5619         __evt__up: function (e) { },
5620 
5621         /**
5622          * @event
5623          * @description Whenever the user releases the mousebutton over the board.
5624          * @name JXG.Board#mouseup
5625          * @param {Event} e The browser's event object.
5626          */
5627         __evt__mouseup: function (e) { },
5628 
5629         /**
5630          * @event
5631          * @description Whenever the user releases the mousebutton over the board with a
5632          * device sending pointer events.
5633          * @name JXG.Board#pointerup
5634          * @param {Event} e The browser's event object.
5635          */
5636         __evt__pointerup: function (e) { },
5637 
5638         /**
5639          * @event
5640          * @description Whenever the user stops touching the board.
5641          * @name JXG.Board#touchend
5642          * @param {Event} e The browser's event object.
5643          */
5644         __evt__touchend: function (e) { },
5645 
5646         /**
5647          * @event
5648          * @description This event is fired whenever the user is moving the finger or mouse pointer over the board.
5649          * @name JXG.Board#move
5650          * @param {Event} e The browser's event object.
5651          * @param {Number} mode The mode the board currently is in
5652          * @see JXG.Board#mode
5653          */
5654         __evt__move: function (e, mode) { },
5655 
5656         /**
5657          * @event
5658          * @description This event is fired whenever the user is moving the mouse over the board.
5659          * @name JXG.Board#mousemove
5660          * @param {Event} e The browser's event object.
5661          * @param {Number} mode The mode the board currently is in
5662          * @see JXG.Board#mode
5663          */
5664         __evt__mousemove: function (e, mode) { },
5665 
5666         /**
5667          * @event
5668          * @description This event is fired whenever the user is moving the pen over the board.
5669          * @name JXG.Board#penmove
5670          * @param {Event} e The browser's event object.
5671          * @param {Number} mode The mode the board currently is in
5672          * @see JXG.Board#mode
5673          */
5674         __evt__penmove: function (e, mode) { },
5675 
5676         /**
5677          * @event
5678          * @description This event is fired whenever the user is moving the mouse over the board  with a
5679          * device sending pointer events.
5680          * @name JXG.Board#pointermove
5681          * @param {Event} e The browser's event object.
5682          * @param {Number} mode The mode the board currently is in
5683          * @see JXG.Board#mode
5684          */
5685         __evt__pointermove: function (e, mode) { },
5686 
5687         /**
5688          * @event
5689          * @description This event is fired whenever the user is moving the finger over the board.
5690          * @name JXG.Board#touchmove
5691          * @param {Event} e The browser's event object.
5692          * @param {Number} mode The mode the board currently is in
5693          * @see JXG.Board#mode
5694          */
5695         __evt__touchmove: function (e, mode) { },
5696 
5697         /**
5698          * @event
5699          * @description Whenever an element is highlighted this event is fired.
5700          * @name JXG.Board#hit
5701          * @param {Event} e The browser's event object.
5702          * @param {JXG.GeometryElement} el The hit element.
5703          * @param target
5704          *
5705          * @example
5706          * var c = board.create('circle', [[1, 1], 2]);
5707          * board.on('hit', function(evt, el) {
5708          *     console.log("Hit element", el);
5709          * });
5710          *
5711          * </pre><div id="JXG19eb31ac-88e6-11e8-bcb5-901b0e1b8723" class="jxgbox" style="width: 300px; height: 300px;"></div>
5712          * <script type="text/javascript">
5713          *     (function() {
5714          *         var board = JXG.JSXGraph.initBoard('JXG19eb31ac-88e6-11e8-bcb5-901b0e1b8723',
5715          *             {boundingbox: [-8, 8, 8,-8], axis: true, showcopyright: false, shownavigation: false});
5716          *     var c = board.create('circle', [[1, 1], 2]);
5717          *     board.on('hit', function(evt, el) {
5718          *         console.log("Hit element", el);
5719          *     });
5720          *
5721          *     })();
5722          *
5723          * </script><pre>
5724          */
5725         __evt__hit: function (e, el, target) { },
5726 
5727         /**
5728          * @event
5729          * @description Whenever an element is highlighted this event is fired.
5730          * @name JXG.Board#mousehit
5731          * @see JXG.Board#hit
5732          * @param {Event} e The browser's event object.
5733          * @param {JXG.GeometryElement} el The hit element.
5734          * @param target
5735          */
5736         __evt__mousehit: function (e, el, target) { },
5737 
5738         /**
5739          * @event
5740          * @description This board is updated.
5741          * @name JXG.Board#update
5742          */
5743         __evt__update: function () { },
5744 
5745         /**
5746          * @event
5747          * @description The bounding box of the board has changed.
5748          * @name JXG.Board#boundingbox
5749          */
5750         __evt__boundingbox: function () { },
5751 
5752         /**
5753          * @event
5754          * @description Select a region is started during a down event or by calling
5755          * {@link JXG.Board.startSelectionMode}
5756          * @name JXG.Board#startselecting
5757          */
5758          __evt__startselecting: function () { },
5759 
5760          /**
5761          * @event
5762          * @description Select a region is started during a down event
5763          * from a device sending mouse events or by calling
5764          * {@link JXG.Board.startSelectionMode}.
5765          * @name JXG.Board#mousestartselecting
5766          */
5767          __evt__mousestartselecting: function () { },
5768 
5769          /**
5770          * @event
5771          * @description Select a region is started during a down event
5772          * from a device sending pointer events or by calling
5773          * {@link JXG.Board.startSelectionMode}.
5774          * @name JXG.Board#pointerstartselecting
5775          */
5776          __evt__pointerstartselecting: function () { },
5777 
5778          /**
5779          * @event
5780          * @description Select a region is started during a down event
5781          * from a device sending touch events or by calling
5782          * {@link JXG.Board.startSelectionMode}.
5783          * @name JXG.Board#touchstartselecting
5784          */
5785          __evt__touchstartselecting: function () { },
5786 
5787          /**
5788           * @event
5789           * @description Selection of a region is stopped during an up event.
5790           * @name JXG.Board#stopselecting
5791           */
5792          __evt__stopselecting: function () { },
5793 
5794          /**
5795          * @event
5796          * @description Selection of a region is stopped during an up event
5797          * from a device sending mouse events.
5798          * @name JXG.Board#mousestopselecting
5799          */
5800          __evt__mousestopselecting: function () { },
5801 
5802          /**
5803          * @event
5804          * @description Selection of a region is stopped during an up event
5805          * from a device sending pointer events.
5806          * @name JXG.Board#pointerstopselecting
5807          */
5808          __evt__pointerstopselecting: function () { },
5809 
5810          /**
5811          * @event
5812          * @description Selection of a region is stopped during an up event
5813          * from a device sending touch events.
5814          * @name JXG.Board#touchstopselecting
5815          */
5816          __evt__touchstopselecting: function () { },
5817 
5818          /**
5819          * @event
5820          * @description A move event while selecting of a region is active.
5821          * @name JXG.Board#moveselecting
5822          */
5823          __evt__moveselecting: function () { },
5824 
5825          /**
5826          * @event
5827          * @description A move event while selecting of a region is active
5828          * from a device sending mouse events.
5829          * @name JXG.Board#mousemoveselecting
5830          */
5831          __evt__mousemoveselecting: function () { },
5832 
5833          /**
5834          * @event
5835          * @description Select a region is started during a down event
5836          * from a device sending mouse events.
5837          * @name JXG.Board#pointermoveselecting
5838          */
5839          __evt__pointermoveselecting: function () { },
5840 
5841          /**
5842          * @event
5843          * @description Select a region is started during a down event
5844          * from a device sending touch events.
5845          * @name JXG.Board#touchmoveselecting
5846          */
5847          __evt__touchmoveselecting: function () { },
5848 
5849         /**
5850          * @ignore
5851          */
5852         __evt: function () {},
5853 
5854         //endregion
5855 
5856         /**
5857          * Expand the JSXGraph construction to fullscreen.
5858          * In order to preserve the proportions of the JSXGraph element,
5859          * a wrapper div is created which is set to fullscreen.
5860          * <p>
5861          * The wrapping div has the CSS class 'jxgbox_wrap_private' which is
5862          * defined in the file 'jsxgraph.css'
5863          * <p>
5864          * This feature is not available on iPhones (as of December 2021).
5865          *
5866          * @param {String} id (Optional) id of the div element which is brought to fullscreen.
5867          * If not provided, this defaults to the JSXGraph div. However, it may be necessary for the aspect ratio trick
5868          * which using padding-bottom/top and an out div element. Then, the id of the outer div has to be supplied.
5869          *
5870          * @return {JXG.Board} Reference to the board
5871          *
5872          * @example
5873          * <div id='jxgbox' class='jxgbox' style='width:500px; height:200px;'></div>
5874          * <button onClick="board.toFullscreen()">Fullscreen</button>
5875          *
5876          * <script language="Javascript" type='text/javascript'>
5877          * var board = JXG.JSXGraph.initBoard('jxgbox', {axis:true, boundingbox:[-5,5,5,-5]});
5878          * var p = board.create('point', [0, 1]);
5879          * </script>
5880          *
5881          * </pre><div id="JXGd5bab8b6-fd40-11e8-ab14-901b0e1b8723" class="jxgbox" style="width: 300px; height: 300px;"></div>
5882          * <script type="text/javascript">
5883          *      var board_d5bab8b6;
5884          *     (function() {
5885          *         var board = JXG.JSXGraph.initBoard('JXGd5bab8b6-fd40-11e8-ab14-901b0e1b8723',
5886          *             {boundingbox:[-5,5,5,-5], axis: true, showcopyright: false, shownavigation: false});
5887          *         var p = board.create('point', [0, 1]);
5888          *         board_d5bab8b6 = board;
5889          *     })();
5890          * </script>
5891          * <button onClick="board_d5bab8b6.toFullscreen()">Fullscreen</button>
5892          * <pre>
5893          *
5894          * @example
5895          * <div id='outer' style='max-width: 500px; margin: 0 auto;'>
5896          * <div id='jxgbox' class='jxgbox' style='height: 0; padding-bottom: 100%'></div>
5897          * </div>
5898          * <button onClick="board.toFullscreen('outer')">Fullscreen</button>
5899          *
5900          * <script language="Javascript" type='text/javascript'>
5901          * var board = JXG.JSXGraph.initBoard('jxgbox', {
5902          *     axis:true,
5903          *     boundingbox:[-5,5,5,-5],
5904          *     fullscreen: { id: 'outer' },
5905          *     showFullscreen: true
5906          * });
5907          * var p = board.create('point', [-2, 3], {});
5908          * </script>
5909          *
5910          * </pre><div id="JXG7103f6b_outer" style='max-width: 500px; margin: 0 auto;'>
5911          * <div id="JXG7103f6be-6993-4ff8-8133-c78e50a8afac" class="jxgbox" style="height: 0; padding-bottom: 100%;"></div>
5912          * </div>
5913          * <button onClick="board_JXG7103f6be.toFullscreen('JXG7103f6b_outer')">Fullscreen</button>
5914          * <script type="text/javascript">
5915          *     var board_JXG7103f6be;
5916          *     (function() {
5917          *         var board = JXG.JSXGraph.initBoard('JXG7103f6be-6993-4ff8-8133-c78e50a8afac',
5918          *             {boundingbox: [-8, 8, 8,-8], axis: true, fullscreen: { id: 'JXG7103f6b_outer' }, showFullscreen: true,
5919          *              showcopyright: false, shownavigation: false});
5920          *     var p = board.create('point', [-2, 3], {});
5921          *     board_JXG7103f6be = board;
5922          *     })();
5923          *
5924          * </script><pre>
5925          *
5926          *
5927          */
5928         toFullscreen: function (id) {
5929             var wrap_id, wrap_node, inner_node;
5930 
5931             id = id || this.container;
5932             this._fullscreen_inner_id = id;
5933             inner_node = document.getElementById(id);
5934             wrap_id = 'fullscreenwrap_' + id;
5935 
5936             // Wrap a div around the JSXGraph div.
5937             if (this.document.getElementById(wrap_id)) {
5938                 wrap_node = this.document.getElementById(wrap_id);
5939             } else {
5940                 wrap_node = document.createElement('div');
5941                 wrap_node.classList.add('JXG_wrap_private');
5942                 wrap_node.setAttribute('id', wrap_id);
5943                 inner_node.parentNode.insertBefore(wrap_node, inner_node);
5944                 wrap_node.appendChild(inner_node);
5945             }
5946 
5947             // Get the real width and height of the JSXGraph div
5948             // and determine the scaling and vertical shift amount
5949             this._fullscreen_res = Env._getScaleFactors(inner_node);
5950 
5951             // Trigger fullscreen mode
5952             wrap_node.requestFullscreen = wrap_node.requestFullscreen ||
5953                 wrap_node.webkitRequestFullscreen ||
5954                 wrap_node.mozRequestFullScreen ||
5955                 wrap_node.msRequestFullscreen;
5956 
5957             if (wrap_node.requestFullscreen) {
5958                 wrap_node.requestFullscreen();
5959             }
5960 
5961             return this;
5962         },
5963 
5964         /**
5965          * If fullscreen mode is toggled, the possible CSS transformations
5966          * which are applied to the JSXGraph canvas have to be reread.
5967          * Otherwise the position of upper left corner is wrongly interpreted.
5968          *
5969          * @param  {Object} evt fullscreen event object (unused)
5970          */
5971         fullscreenListener: function (evt) {
5972             var res, inner_id, inner_node;
5973 
5974             inner_id = this._fullscreen_inner_id;
5975             if (!Type.exists(inner_id)) {
5976                 return;
5977             }
5978 
5979             document.fullscreenElement = document.fullscreenElement ||
5980                     document.webkitFullscreenElement ||
5981                     document.mozFullscreenElement ||
5982                     document.msFullscreenElement;
5983 
5984             inner_node = document.getElementById(inner_id);
5985             // If full screen mode is started we have to remove CSS margin around the JSXGraph div.
5986             // Otherwise, the positioning of the fullscreen div will be false.
5987             // When leaving the fullscreen mode, the margin is put back in.
5988             if (document.fullscreenElement) {
5989                 // Just entered fullscreen mode
5990 
5991                 // Get the data computed in board.toFullscreen()
5992                 res = this._fullscreen_res;
5993 
5994                 // Store the scaling data.
5995                 // It is used in AbstractRenderer.updateText to restore the scaling matrix
5996                 // which is removed by MathJax.
5997                 // Further, the CSS margin has to be removed when in fullscreen mode,
5998                 // and must be restored later.
5999                 inner_node._cssFullscreenStore = {
6000                     id: document.fullscreenElement.id,
6001                     isFullscreen: true,
6002                     margin: inner_node.style.margin,
6003                     width: inner_node.style.width,
6004                     scale: res.scale,
6005                     vshift: res.vshift
6006                 };
6007 
6008                 inner_node.style.margin = '';
6009                 inner_node.style.width = res.width + 'px';
6010 
6011                 // Do the shifting and scaling via CSS pseudo rules
6012                 // We do this after fullscreen mode has been established to get the correct size
6013                 // of the JSXGraph div.
6014                 Env.scaleJSXGraphDiv(document.fullscreenElement.id, inner_id, res.scale, res.vshift);
6015 
6016                 // Clear document.fullscreenElement, because Safari doesn't to it and
6017                 // when leaving full screen mode it is still set.
6018                 document.fullscreenElement = null;
6019 
6020             } else if (Type.exists(inner_node._cssFullscreenStore)) {
6021                 // Just left the fullscreen mode
6022 
6023                 // Remove the CSS rules added in Env.scaleJSXGraphDiv
6024                 try {
6025                     document.styleSheets[document.styleSheets.length - 1].deleteRule(0);
6026                 } catch (err) {
6027                     console.log('JSXGraph: Could not remove CSS rules for full screen mode');
6028                 }
6029 
6030                 inner_node._cssFullscreenStore.isFullscreen = false;
6031                 inner_node.style.margin = inner_node._cssFullscreenStore.margin;
6032                 inner_node.style.width = inner_node._cssFullscreenStore.width;
6033 
6034             }
6035 
6036             this.updateCSSTransforms();
6037         },
6038 
6039         /**
6040          * Function to animate a curve rolling on another curve.
6041          * @param {Curve} c1 JSXGraph curve building the floor where c2 rolls
6042          * @param {Curve} c2 JSXGraph curve which rolls on c1.
6043          * @param {number} start_c1 The parameter t such that c1(t) touches c2. This is the start position of the
6044          *                          rolling process
6045          * @param {Number} stepsize Increase in t in each step for the curve c1
6046          * @param {Number} direction
6047          * @param {Number} time Delay time for setInterval()
6048          * @param {Array} pointlist Array of points which are rolled in each step. This list should contain
6049          *      all points which define c2 and gliders on c2.
6050          *
6051          * @example
6052          *
6053          * // Line which will be the floor to roll upon.
6054          * var line = brd.create('curve', [function (t) { return t;}, function (t){ return 1;}], {strokeWidth:6});
6055          * // Center of the rolling circle
6056          * var C = brd.create('point',[0,2],{name:'C'});
6057          * // Starting point of the rolling circle
6058          * var P = brd.create('point',[0,1],{name:'P', trace:true});
6059          * // Circle defined as a curve. The circle "starts" at P, i.e. circle(0) = P
6060          * var circle = brd.create('curve',[
6061          *           function (t){var d = P.Dist(C),
6062          *                           beta = JXG.Math.Geometry.rad([C.X()+1,C.Y()],C,P);
6063          *                       t += beta;
6064          *                       return C.X()+d*Math.cos(t);
6065          *           },
6066          *           function (t){var d = P.Dist(C),
6067          *                           beta = JXG.Math.Geometry.rad([C.X()+1,C.Y()],C,P);
6068          *                       t += beta;
6069          *                       return C.Y()+d*Math.sin(t);
6070          *           },
6071          *           0,2*Math.PI],
6072          *           {strokeWidth:6, strokeColor:'green'});
6073          *
6074          * // Point on circle
6075          * var B = brd.create('glider',[0,2,circle],{name:'B', color:'blue',trace:false});
6076          * var roll = brd.createRoulette(line, circle, 0, Math.PI/20, 1, 100, [C,P,B]);
6077          * roll.start() // Start the rolling, to be stopped by roll.stop()
6078          *
6079          * </pre><div class="jxgbox" id="JXGe5e1b53c-a036-4a46-9e35-190d196beca5" style="width: 300px; height: 300px;"></div>
6080          * <script type="text/javascript">
6081          * var brd = JXG.JSXGraph.initBoard('JXGe5e1b53c-a036-4a46-9e35-190d196beca5', {boundingbox: [-5, 5, 5, -5], axis: true, showcopyright:false, shownavigation: false});
6082          * // Line which will be the floor to roll upon.
6083          * var line = brd.create('curve', [function (t) { return t;}, function (t){ return 1;}], {strokeWidth:6});
6084          * // Center of the rolling circle
6085          * var C = brd.create('point',[0,2],{name:'C'});
6086          * // Starting point of the rolling circle
6087          * var P = brd.create('point',[0,1],{name:'P', trace:true});
6088          * // Circle defined as a curve. The circle "starts" at P, i.e. circle(0) = P
6089          * var circle = brd.create('curve',[
6090          *           function (t){var d = P.Dist(C),
6091          *                           beta = JXG.Math.Geometry.rad([C.X()+1,C.Y()],C,P);
6092          *                       t += beta;
6093          *                       return C.X()+d*Math.cos(t);
6094          *           },
6095          *           function (t){var d = P.Dist(C),
6096          *                           beta = JXG.Math.Geometry.rad([C.X()+1,C.Y()],C,P);
6097          *                       t += beta;
6098          *                       return C.Y()+d*Math.sin(t);
6099          *           },
6100          *           0,2*Math.PI],
6101          *           {strokeWidth:6, strokeColor:'green'});
6102          *
6103          * // Point on circle
6104          * var B = brd.create('glider',[0,2,circle],{name:'B', color:'blue',trace:false});
6105          * var roll = brd.createRoulette(line, circle, 0, Math.PI/20, 1, 100, [C,P,B]);
6106          * roll.start() // Start the rolling, to be stopped by roll.stop()
6107          * </script><pre>
6108          */
6109         createRoulette: function (c1, c2, start_c1, stepsize, direction, time, pointlist) {
6110             var brd = this,
6111                 Roulette = function () {
6112                     var alpha = 0, Tx = 0, Ty = 0,
6113                         t1 = start_c1,
6114                         t2 = Numerics.root(
6115                             function (t) {
6116                                 var c1x = c1.X(t1),
6117                                     c1y = c1.Y(t1),
6118                                     c2x = c2.X(t),
6119                                     c2y = c2.Y(t);
6120 
6121                                 return (c1x - c2x) * (c1x - c2x) + (c1y - c2y) * (c1y - c2y);
6122                             },
6123                             [0, Math.PI * 2]
6124                         ),
6125                         t1_new = 0.0, t2_new = 0.0,
6126                         c1dist,
6127 
6128                         rotation = brd.create('transform', [
6129                             function () {
6130                                 return alpha;
6131                             }
6132                         ], {type: 'rotate'}),
6133 
6134                         rotationLocal = brd.create('transform', [
6135                             function () {
6136                                 return alpha;
6137                             },
6138                             function () {
6139                                 return c1.X(t1);
6140                             },
6141                             function () {
6142                                 return c1.Y(t1);
6143                             }
6144                         ], {type: 'rotate'}),
6145 
6146                         translate = brd.create('transform', [
6147                             function () {
6148                                 return Tx;
6149                             },
6150                             function () {
6151                                 return Ty;
6152                             }
6153                         ], {type: 'translate'}),
6154 
6155                         // arc length via Simpson's rule.
6156                         arclen = function (c, a, b) {
6157                             var cpxa = Numerics.D(c.X)(a),
6158                                 cpya = Numerics.D(c.Y)(a),
6159                                 cpxb = Numerics.D(c.X)(b),
6160                                 cpyb = Numerics.D(c.Y)(b),
6161                                 cpxab = Numerics.D(c.X)((a + b) * 0.5),
6162                                 cpyab = Numerics.D(c.Y)((a + b) * 0.5),
6163 
6164                                 fa = Math.sqrt(cpxa * cpxa + cpya * cpya),
6165                                 fb = Math.sqrt(cpxb * cpxb + cpyb * cpyb),
6166                                 fab = Math.sqrt(cpxab * cpxab + cpyab * cpyab);
6167 
6168                             return (fa + 4 * fab + fb) * (b - a) / 6;
6169                         },
6170 
6171                         exactDist = function (t) {
6172                             return c1dist - arclen(c2, t2, t);
6173                         },
6174 
6175                         beta = Math.PI / 18,
6176                         beta9 = beta * 9,
6177                         interval = null;
6178 
6179                     this.rolling = function () {
6180                         var h, g, hp, gp, z;
6181 
6182                         t1_new = t1 + direction * stepsize;
6183 
6184                         // arc length between c1(t1) and c1(t1_new)
6185                         c1dist = arclen(c1, t1, t1_new);
6186 
6187                         // find t2_new such that arc length between c2(t2) and c1(t2_new) equals c1dist.
6188                         t2_new = Numerics.root(exactDist, t2);
6189 
6190                         // c1(t) as complex number
6191                         h = new Complex(c1.X(t1_new), c1.Y(t1_new));
6192 
6193                         // c2(t) as complex number
6194                         g = new Complex(c2.X(t2_new), c2.Y(t2_new));
6195 
6196                         hp = new Complex(Numerics.D(c1.X)(t1_new), Numerics.D(c1.Y)(t1_new));
6197                         gp = new Complex(Numerics.D(c2.X)(t2_new), Numerics.D(c2.Y)(t2_new));
6198 
6199                         // z is angle between the tangents of c1 at t1_new, and c2 at t2_new
6200                         z = Complex.C.div(hp, gp);
6201 
6202                         alpha = Math.atan2(z.imaginary, z.real);
6203                         // Normalizing the quotient
6204                         z.div(Complex.C.abs(z));
6205                         z.mult(g);
6206                         Tx = h.real - z.real;
6207 
6208                         // T = h(t1_new)-g(t2_new)*h'(t1_new)/g'(t2_new);
6209                         Ty = h.imaginary - z.imaginary;
6210 
6211                         // -(10-90) degrees: make corners roll smoothly
6212                         if (alpha < -beta && alpha > -beta9) {
6213                             alpha = -beta;
6214                             rotationLocal.applyOnce(pointlist);
6215                         } else if (alpha > beta && alpha < beta9) {
6216                             alpha = beta;
6217                             rotationLocal.applyOnce(pointlist);
6218                         } else {
6219                             rotation.applyOnce(pointlist);
6220                             translate.applyOnce(pointlist);
6221                             t1 = t1_new;
6222                             t2 = t2_new;
6223                         }
6224                         brd.update();
6225                     };
6226 
6227                     this.start = function () {
6228                         if (time > 0) {
6229                             interval = window.setInterval(this.rolling, time);
6230                         }
6231                         return this;
6232                     };
6233 
6234                     this.stop = function () {
6235                         window.clearInterval(interval);
6236                         return this;
6237                     };
6238                     return this;
6239                 };
6240             return new Roulette();
6241         }
6242     });
6243 
6244     return JXG.Board;
6245 });
6246