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