import { isNumber, assign, forEach, every, debounce, bind, reduce, find, isDefined } from 'min-dash'; import { assignStyle } from 'min-dom'; import { add as collectionAdd, remove as collectionRemove } from '../util/Collections'; import { getType, getBBox as getBoundingBox } from '../util/Elements'; import { asTRBL } from '../layout/LayoutUtil'; import { append as svgAppend, attr as svgAttr, classes as svgClasses, create as svgCreate, transform as svgTransform, remove as svgRemove } from 'tiny-svg'; import { createMatrix as createMatrix } from 'tiny-svg'; function round(number, resolution) { return Math.round(number * resolution) / resolution; } function ensurePx(number) { return isNumber(number) ? number + 'px' : number; } function findRoot(element) { while (element.parent) { element = element.parent; } return element; } /** * Creates a HTML container element for a SVG element with * the given configuration * * @param {Object} options * @return {HTMLElement} the container element */ function createContainer(options) { options = assign({}, { width: '100%', height: '100%' }, options); const container = options.container || document.body; // create a
around the svg element with the respective size // this way we can always get the correct container size // (this is impossible for elements at the moment) const parent = document.createElement('div'); parent.setAttribute('class', 'djs-container djs-parent'); assignStyle(parent, { position: 'relative', overflow: 'hidden', width: ensurePx(options.width), height: ensurePx(options.height) }); container.appendChild(parent); return parent; } function createGroup(parent, cls, childIndex) { const group = svgCreate('g'); svgClasses(group).add(cls); const index = childIndex !== undefined ? childIndex : parent.childNodes.length - 1; // must ensure second argument is node or _null_ // cf. https://developer.mozilla.org/en-US/docs/Web/API/Node/insertBefore parent.insertBefore(group, parent.childNodes[index] || null); return group; } const BASE_LAYER = 'base'; // render plane contents behind utility layers const PLANE_LAYER_INDEX = 0; const UTILITY_LAYER_INDEX = 1; const REQUIRED_MODEL_ATTRS = { shape: [ 'x', 'y', 'width', 'height' ], connection: [ 'waypoints' ] }; /** * The main drawing canvas. * * @class * @constructor * * @emits Canvas#canvas.init * * @param {Object} config * @param {EventBus} eventBus * @param {GraphicsFactory} graphicsFactory * @param {ElementRegistry} elementRegistry */ export default function Canvas(config, eventBus, graphicsFactory, elementRegistry) { this._eventBus = eventBus; this._elementRegistry = elementRegistry; this._graphicsFactory = graphicsFactory; this._rootsIdx = 0; this._layers = {}; this._planes = []; this._rootElement = null; this._init(config || {}); } Canvas.$inject = [ 'config.canvas', 'eventBus', 'graphicsFactory', 'elementRegistry' ]; /** * Creates a element that is wrapped into a
. * This way we are always able to correctly figure out the size of the svg element * by querying the parent node. * (It is not possible to get the size of a svg element cross browser @ 2014-04-01) *
* * ... * *
*/ Canvas.prototype._init = function(config) { const eventBus = this._eventBus; // html container const container = this._container = createContainer(config); const svg = this._svg = svgCreate('svg'); svgAttr(svg, { width: '100%', height: '100%' }); svgAppend(container, svg); const viewport = this._viewport = createGroup(svg, 'viewport'); // debounce canvas.viewbox.changed events // for smoother diagram interaction if (config.deferUpdate !== false) { this._viewboxChanged = debounce(bind(this._viewboxChanged, this), 300); } eventBus.on('diagram.init', function() { /** * An event indicating that the canvas is ready to be drawn on. * * @memberOf Canvas * * @event canvas.init * * @type {Object} * @property {SVGElement} svg the created svg element * @property {SVGElement} viewport the direct parent of diagram elements and shapes */ eventBus.fire('canvas.init', { svg: svg, viewport: viewport }); }, this); // reset viewbox on shape changes to // recompute the viewbox eventBus.on([ 'shape.added', 'connection.added', 'shape.removed', 'connection.removed', 'elements.changed', 'root.set' ], function() { delete this._cachedViewbox; }, this); eventBus.on('diagram.destroy', 500, this._destroy, this); eventBus.on('diagram.clear', 500, this._clear, this); }; Canvas.prototype._destroy = function(emit) { this._eventBus.fire('canvas.destroy', { svg: this._svg, viewport: this._viewport }); const parent = this._container.parentNode; if (parent) { parent.removeChild(this._container); } delete this._svg; delete this._container; delete this._layers; delete this._planes; delete this._rootElement; delete this._viewport; }; Canvas.prototype._clear = function() { const allElements = this._elementRegistry.getAll(); // remove all elements allElements.forEach(element => { const type = getType(element); if (type === 'root') { this.removeRootElement(element); } else { this._removeElement(element, type); } }); // remove all planes this._planes = []; this._rootElement = null; // force recomputation of view box delete this._cachedViewbox; }; /** * Returns the default layer on which * all elements are drawn. * * @returns {SVGElement} */ Canvas.prototype.getDefaultLayer = function() { return this.getLayer(BASE_LAYER, PLANE_LAYER_INDEX); }; /** * Returns a layer that is used to draw elements * or annotations on it. * * Non-existing layers retrieved through this method * will be created. During creation, the optional index * may be used to create layers below or above existing layers. * A layer with a certain index is always created above all * existing layers with the same index. * * @param {string} name * @param {number} index * * @returns {SVGElement} */ Canvas.prototype.getLayer = function(name, index) { if (!name) { throw new Error('must specify a name'); } let layer = this._layers[name]; if (!layer) { layer = this._layers[name] = this._createLayer(name, index); } // throw an error if layer creation / retrival is // requested on different index if (typeof index !== 'undefined' && layer.index !== index) { throw new Error('layer <' + name + '> already created at index <' + index + '>'); } return layer.group; }; /** * For a given index, return the number of layers that have a higher index and * are visible. * * This is used to determine the node a layer should be inserted at. * * @param {Number} index * @returns {Number} */ Canvas.prototype._getChildIndex = function(index) { return reduce(this._layers, function(childIndex, layer) { if (layer.visible && index >= layer.index) { childIndex++; } return childIndex; }, 0); }; /** * Creates a given layer and returns it. * * @param {string} name * @param {number} [index=0] * * @return {Object} layer descriptor with { index, group: SVGGroup } */ Canvas.prototype._createLayer = function(name, index) { if (typeof index === 'undefined') { index = UTILITY_LAYER_INDEX; } const childIndex = this._getChildIndex(index); return { group: createGroup(this._viewport, 'layer-' + name, childIndex), index: index, visible: true }; }; /** * Shows a given layer. * * @param {String} layer * @returns {SVGElement} */ Canvas.prototype.showLayer = function(name) { if (!name) { throw new Error('must specify a name'); } const layer = this._layers[name]; if (!layer) { throw new Error('layer <' + name + '> does not exist'); } const viewport = this._viewport; const group = layer.group; const index = layer.index; if (layer.visible) { return group; } const childIndex = this._getChildIndex(index); viewport.insertBefore(group, viewport.childNodes[childIndex] || null); layer.visible = true; return group; }; /** * Hides a given layer. * * @param {String} layer * @returns {SVGElement} */ Canvas.prototype.hideLayer = function(name) { if (!name) { throw new Error('must specify a name'); } const layer = this._layers[name]; if (!layer) { throw new Error('layer <' + name + '> does not exist'); } const group = layer.group; if (!layer.visible) { return group; } svgRemove(group); layer.visible = false; return group; }; Canvas.prototype._removeLayer = function(name) { const layer = this._layers[name]; if (layer) { delete this._layers[name]; svgRemove(layer.group); } }; /** * Returns the currently active layer. Can be null. * * @returns {SVGElement|null} */ Canvas.prototype.getActiveLayer = function() { const plane = this._findPlaneForRoot(this.getRootElement()); if (!plane) { return null; } return plane.layer; }; /** * Returns the plane which contains the given element. * * @param {string|djs.model.Base} element * * @return {djs.model.Base} root for element */ Canvas.prototype.findRoot = function(element) { if (typeof element === 'string') { element = this._elementRegistry.get(element); } if (!element) { return; } const plane = this._findPlaneForRoot( findRoot(element) ) || {}; return plane.rootElement; }; /** * Return a list of all root elements on the diagram. * * @return {djs.model.Root[]} */ Canvas.prototype.getRootElements = function() { return this._planes.map(function(plane) { return plane.rootElement; }); }; Canvas.prototype._findPlaneForRoot = function(rootElement) { return find(this._planes, function(plane) { return plane.rootElement === rootElement; }); }; /** * Returns the html element that encloses the * drawing canvas. * * @return {DOMNode} */ Canvas.prototype.getContainer = function() { return this._container; }; // markers ////////////////////// Canvas.prototype._updateMarker = function(element, marker, add) { let container; if (!element.id) { element = this._elementRegistry.get(element); } // we need to access all container = this._elementRegistry._elements[element.id]; if (!container) { return; } forEach([ container.gfx, container.secondaryGfx ], function(gfx) { if (gfx) { // invoke either addClass or removeClass based on mode if (add) { svgClasses(gfx).add(marker); } else { svgClasses(gfx).remove(marker); } } }); /** * An event indicating that a marker has been updated for an element * * @event element.marker.update * @type {Object} * @property {djs.model.Element} element the shape * @property {Object} gfx the graphical representation of the shape * @property {string} marker * @property {boolean} add true if the marker was added, false if it got removed */ this._eventBus.fire('element.marker.update', { element: element, gfx: container.gfx, marker: marker, add: !!add }); }; /** * Adds a marker to an element (basically a css class). * * Fires the element.marker.update event, making it possible to * integrate extension into the marker life-cycle, too. * * @example * canvas.addMarker('foo', 'some-marker'); * * const fooGfx = canvas.getGraphics('foo'); * * fooGfx; // ... * * @param {string|djs.model.Base} element * @param {string} marker */ Canvas.prototype.addMarker = function(element, marker) { this._updateMarker(element, marker, true); }; /** * Remove a marker from an element. * * Fires the element.marker.update event, making it possible to * integrate extension into the marker life-cycle, too. * * @param {string|djs.model.Base} element * @param {string} marker */ Canvas.prototype.removeMarker = function(element, marker) { this._updateMarker(element, marker, false); }; /** * Check the existence of a marker on element. * * @param {string|djs.model.Base} element * @param {string} marker */ Canvas.prototype.hasMarker = function(element, marker) { if (!element.id) { element = this._elementRegistry.get(element); } const gfx = this.getGraphics(element); return svgClasses(gfx).has(marker); }; /** * Toggles a marker on an element. * * Fires the element.marker.update event, making it possible to * integrate extension into the marker life-cycle, too. * * @param {string|djs.model.Base} element * @param {string} marker */ Canvas.prototype.toggleMarker = function(element, marker) { if (this.hasMarker(element, marker)) { this.removeMarker(element, marker); } else { this.addMarker(element, marker); } }; /** * Returns the current root element. * * Supports two different modes for handling root elements: * * 1. if no root element has been added before, an implicit root will be added * and returned. This is used in applications that don't require explicit * root elements. * * 2. when root elements have been added before calling `getRootElement`, * root elements can be null. This is used for applications that want to manage * root elements themselves. * * @returns {Object|djs.model.Root|null} rootElement. */ Canvas.prototype.getRootElement = function() { const rootElement = this._rootElement; // can return null if root elements are present but none was set yet if (rootElement || this._planes.length) { return rootElement; } return this.setRootElement(this.addRootElement(null)); }; /** * Adds a given root element and returns it. * * @param {Object|djs.model.Root} rootElement * * @return {Object|djs.model.Root} rootElement */ Canvas.prototype.addRootElement = function(rootElement) { const idx = this._rootsIdx++; if (!rootElement) { rootElement = { id: '__implicitroot_' + idx, children: [], isImplicit: true }; } const layerName = rootElement.layer = 'root-' + idx; this._ensureValid('root', rootElement); const layer = this.getLayer(layerName, PLANE_LAYER_INDEX); this.hideLayer(layerName); this._addRoot(rootElement, layer); this._planes.push({ rootElement: rootElement, layer: layer }); return rootElement; }; /** * Removes a given rootElement and returns it. * * @param {djs.model.Root|String} rootElement * * @return {Object|djs.model.Root} rootElement */ Canvas.prototype.removeRootElement = function(rootElement) { if (typeof rootElement === 'string') { rootElement = this._elementRegistry.get(rootElement); } const plane = this._findPlaneForRoot(rootElement); if (!plane) { return; } // hook up life-cycle events this._removeRoot(rootElement); // clean up layer this._removeLayer(rootElement.layer); // clean up plane this._planes = this._planes.filter(function(plane) { return plane.rootElement !== rootElement; }); // clean up active root if (this._rootElement === rootElement) { this._rootElement = null; } return rootElement; }; // root element handling ////////////////////// /** * Sets a given element as the new root element for the canvas * and returns the new root element. * * @param {Object|djs.model.Root} rootElement * * @return {Object|djs.model.Root} new root element */ Canvas.prototype.setRootElement = function(rootElement, override) { if (isDefined(override)) { throw new Error('override not supported'); } if (rootElement === this._rootElement) { return; } let plane; if (!rootElement) { throw new Error('rootElement required'); } plane = this._findPlaneForRoot(rootElement); // give set add semantics for backwards compatibility if (!plane) { rootElement = this.addRootElement(rootElement); } this._setRoot(rootElement); return rootElement; }; Canvas.prototype._removeRoot = function(element) { const elementRegistry = this._elementRegistry, eventBus = this._eventBus; // simulate element remove event sequence eventBus.fire('root.remove', { element: element }); eventBus.fire('root.removed', { element: element }); elementRegistry.remove(element); }; Canvas.prototype._addRoot = function(element, gfx) { const elementRegistry = this._elementRegistry, eventBus = this._eventBus; // resemble element add event sequence eventBus.fire('root.add', { element: element }); elementRegistry.add(element, gfx); eventBus.fire('root.added', { element: element, gfx: gfx }); }; Canvas.prototype._setRoot = function(rootElement, layer) { const currentRoot = this._rootElement; if (currentRoot) { // un-associate previous root element this._elementRegistry.updateGraphics(currentRoot, null, true); // hide previous layer this.hideLayer(currentRoot.layer); } if (rootElement) { if (!layer) { layer = this._findPlaneForRoot(rootElement).layer; } // associate element with this._elementRegistry.updateGraphics(rootElement, this._svg, true); // show root layer this.showLayer(rootElement.layer); } this._rootElement = rootElement; this._eventBus.fire('root.set', { element: rootElement }); }; // add functionality ////////////////////// Canvas.prototype._ensureValid = function(type, element) { if (!element.id) { throw new Error('element must have an id'); } if (this._elementRegistry.get(element.id)) { throw new Error('element <' + element.id + '> already exists'); } const requiredAttrs = REQUIRED_MODEL_ATTRS[type]; const valid = every(requiredAttrs, function(attr) { return typeof element[attr] !== 'undefined'; }); if (!valid) { throw new Error( 'must supply { ' + requiredAttrs.join(', ') + ' } with ' + type); } }; Canvas.prototype._setParent = function(element, parent, parentIndex) { collectionAdd(parent.children, element, parentIndex); element.parent = parent; }; /** * Adds an element to the canvas. * * This wires the parent <-> child relationship between the element and * a explicitly specified parent or an implicit root element. * * During add it emits the events * * * <{type}.add> (element, parent) * * <{type}.added> (element, gfx) * * Extensions may hook into these events to perform their magic. * * @param {string} type * @param {Object|djs.model.Base} element * @param {Object|djs.model.Base} [parent] * @param {number} [parentIndex] * * @return {Object|djs.model.Base} the added element */ Canvas.prototype._addElement = function(type, element, parent, parentIndex) { parent = parent || this.getRootElement(); const eventBus = this._eventBus, graphicsFactory = this._graphicsFactory; this._ensureValid(type, element); eventBus.fire(type + '.add', { element: element, parent: parent }); this._setParent(element, parent, parentIndex); // create graphics const gfx = graphicsFactory.create(type, element, parentIndex); this._elementRegistry.add(element, gfx); // update its visual graphicsFactory.update(type, element, gfx); eventBus.fire(type + '.added', { element: element, gfx: gfx }); return element; }; /** * Adds a shape to the canvas * * @param {Object|djs.model.Shape} shape to add to the diagram * @param {djs.model.Base} [parent] * @param {number} [parentIndex] * * @return {djs.model.Shape} the added shape */ Canvas.prototype.addShape = function(shape, parent, parentIndex) { return this._addElement('shape', shape, parent, parentIndex); }; /** * Adds a connection to the canvas * * @param {Object|djs.model.Connection} connection to add to the diagram * @param {djs.model.Base} [parent] * @param {number} [parentIndex] * * @return {djs.model.Connection} the added connection */ Canvas.prototype.addConnection = function(connection, parent, parentIndex) { return this._addElement('connection', connection, parent, parentIndex); }; /** * Internal remove element */ Canvas.prototype._removeElement = function(element, type) { const elementRegistry = this._elementRegistry, graphicsFactory = this._graphicsFactory, eventBus = this._eventBus; element = elementRegistry.get(element.id || element); if (!element) { // element was removed already return; } eventBus.fire(type + '.remove', { element: element }); graphicsFactory.remove(element); // unset parent <-> child relationship collectionRemove(element.parent && element.parent.children, element); element.parent = null; eventBus.fire(type + '.removed', { element: element }); elementRegistry.remove(element); return element; }; /** * Removes a shape from the canvas * * @param {string|djs.model.Shape} shape or shape id to be removed * * @return {djs.model.Shape} the removed shape */ Canvas.prototype.removeShape = function(shape) { /** * An event indicating that a shape is about to be removed from the canvas. * * @memberOf Canvas * * @event shape.remove * @type {Object} * @property {djs.model.Shape} element the shape descriptor * @property {Object} gfx the graphical representation of the shape */ /** * An event indicating that a shape has been removed from the canvas. * * @memberOf Canvas * * @event shape.removed * @type {Object} * @property {djs.model.Shape} element the shape descriptor * @property {Object} gfx the graphical representation of the shape */ return this._removeElement(shape, 'shape'); }; /** * Removes a connection from the canvas * * @param {string|djs.model.Connection} connection or connection id to be removed * * @return {djs.model.Connection} the removed connection */ Canvas.prototype.removeConnection = function(connection) { /** * An event indicating that a connection is about to be removed from the canvas. * * @memberOf Canvas * * @event connection.remove * @type {Object} * @property {djs.model.Connection} element the connection descriptor * @property {Object} gfx the graphical representation of the connection */ /** * An event indicating that a connection has been removed from the canvas. * * @memberOf Canvas * * @event connection.removed * @type {Object} * @property {djs.model.Connection} element the connection descriptor * @property {Object} gfx the graphical representation of the connection */ return this._removeElement(connection, 'connection'); }; /** * Return the graphical object underlaying a certain diagram element * * @param {string|djs.model.Base} element descriptor of the element * @param {boolean} [secondary=false] whether to return the secondary connected element * * @return {SVGElement} */ Canvas.prototype.getGraphics = function(element, secondary) { return this._elementRegistry.getGraphics(element, secondary); }; /** * Perform a viewbox update via a given change function. * * @param {Function} changeFn */ Canvas.prototype._changeViewbox = function(changeFn) { // notify others of the upcoming viewbox change this._eventBus.fire('canvas.viewbox.changing'); // perform actual change changeFn.apply(this); // reset the cached viewbox so that // a new get operation on viewbox or zoom // triggers a viewbox re-computation this._cachedViewbox = null; // notify others of the change; this step // may or may not be debounced this._viewboxChanged(); }; Canvas.prototype._viewboxChanged = function() { this._eventBus.fire('canvas.viewbox.changed', { viewbox: this.viewbox() }); }; /** * Gets or sets the view box of the canvas, i.e. the * area that is currently displayed. * * The getter may return a cached viewbox (if it is currently * changing). To force a recomputation, pass `false` as the first argument. * * @example * * canvas.viewbox({ x: 100, y: 100, width: 500, height: 500 }) * * // sets the visible area of the diagram to (100|100) -> (600|100) * // and and scales it according to the diagram width * * const viewbox = canvas.viewbox(); // pass `false` to force recomputing the box. * * console.log(viewbox); * // { * // inner: Dimensions, * // outer: Dimensions, * // scale, * // x, y, * // width, height * // } * * // if the current diagram is zoomed and scrolled, you may reset it to the * // default zoom via this method, too: * * const zoomedAndScrolledViewbox = canvas.viewbox(); * * canvas.viewbox({ * x: 0, * y: 0, * width: zoomedAndScrolledViewbox.outer.width, * height: zoomedAndScrolledViewbox.outer.height * }); * * @param {Object} [box] the new view box to set * @param {number} box.x the top left X coordinate of the canvas visible in view box * @param {number} box.y the top left Y coordinate of the canvas visible in view box * @param {number} box.width the visible width * @param {number} box.height * * @return {Object} the current view box */ Canvas.prototype.viewbox = function(box) { if (box === undefined && this._cachedViewbox) { return this._cachedViewbox; } const viewport = this._viewport, outerBox = this.getSize(); let innerBox, matrix, activeLayer, transform, scale, x, y; if (!box) { // compute the inner box based on the // diagrams active layer. This allows us to exclude // external components, such as overlays activeLayer = this._rootElement ? this.getActiveLayer() : null; innerBox = activeLayer && activeLayer.getBBox() || {}; transform = svgTransform(viewport); matrix = transform ? transform.matrix : createMatrix(); scale = round(matrix.a, 1000); x = round(-matrix.e || 0, 1000); y = round(-matrix.f || 0, 1000); box = this._cachedViewbox = { x: x ? x / scale : 0, y: y ? y / scale : 0, width: outerBox.width / scale, height: outerBox.height / scale, scale: scale, inner: { width: innerBox.width || 0, height: innerBox.height || 0, x: innerBox.x || 0, y: innerBox.y || 0 }, outer: outerBox }; return box; } else { this._changeViewbox(function() { scale = Math.min(outerBox.width / box.width, outerBox.height / box.height); const matrix = this._svg.createSVGMatrix() .scale(scale) .translate(-box.x, -box.y); svgTransform(viewport, matrix); }); } return box; }; /** * Gets or sets the scroll of the canvas. * * @param {Object} [delta] the new scroll to apply. * * @param {number} [delta.dx] * @param {number} [delta.dy] */ Canvas.prototype.scroll = function(delta) { const node = this._viewport; let matrix = node.getCTM(); if (delta) { this._changeViewbox(function() { delta = assign({ dx: 0, dy: 0 }, delta || {}); matrix = this._svg.createSVGMatrix().translate(delta.dx, delta.dy).multiply(matrix); setCTM(node, matrix); }); } return { x: matrix.e, y: matrix.f }; }; /** * Scrolls the viewbox to contain the given element. * Optionally specify a padding to be applied to the edges. * * @param {Object|String} [element] the element to scroll to. * @param {Object|Number} [padding=100] the padding to be applied. Can also specify top, bottom, left and right. * */ Canvas.prototype.scrollToElement = function(element, padding) { let defaultPadding = 100; if (typeof element === 'string') { element = this._elementRegistry.get(element); } // set to correct rootElement const rootElement = this.findRoot(element); if (rootElement !== this.getRootElement()) { this.setRootElement(rootElement); } if (!padding) { padding = {}; } if (typeof padding === 'number') { defaultPadding = padding; } padding = { top: padding.top || defaultPadding, right: padding.right || defaultPadding, bottom: padding.bottom || defaultPadding, left: padding.left || defaultPadding }; const elementBounds = getBoundingBox(element), elementTrbl = asTRBL(elementBounds), viewboxBounds = this.viewbox(), zoom = this.zoom(); let dx, dy; // shrink viewboxBounds with padding viewboxBounds.y += padding.top / zoom; viewboxBounds.x += padding.left / zoom; viewboxBounds.width -= (padding.right + padding.left) / zoom; viewboxBounds.height -= (padding.bottom + padding.top) / zoom; const viewboxTrbl = asTRBL(viewboxBounds); const canFit = elementBounds.width < viewboxBounds.width && elementBounds.height < viewboxBounds.height; if (!canFit) { // top-left when element can't fit dx = elementBounds.x - viewboxBounds.x; dy = elementBounds.y - viewboxBounds.y; } else { const dRight = Math.max(0, elementTrbl.right - viewboxTrbl.right), dLeft = Math.min(0, elementTrbl.left - viewboxTrbl.left), dBottom = Math.max(0, elementTrbl.bottom - viewboxTrbl.bottom), dTop = Math.min(0, elementTrbl.top - viewboxTrbl.top); dx = dRight || dLeft; dy = dBottom || dTop; } this.scroll({ dx: -dx * zoom, dy: -dy * zoom }); }; /** * Gets or sets the current zoom of the canvas, optionally zooming * to the specified position. * * The getter may return a cached zoom level. Call it with `false` as * the first argument to force recomputation of the current level. * * @param {string|number} [newScale] the new zoom level, either a number, i.e. 0.9, * or `fit-viewport` to adjust the size to fit the current viewport * @param {string|Point} [center] the reference point { x: .., y: ..} to zoom to, 'auto' to zoom into mid or null * * @return {number} the current scale */ Canvas.prototype.zoom = function(newScale, center) { if (!newScale) { return this.viewbox(newScale).scale; } if (newScale === 'fit-viewport') { return this._fitViewport(center); } let outer, matrix; this._changeViewbox(function() { if (typeof center !== 'object') { outer = this.viewbox().outer; center = { x: outer.width / 2, y: outer.height / 2 }; } matrix = this._setZoom(newScale, center); }); return round(matrix.a, 1000); }; function setCTM(node, m) { const mstr = 'matrix(' + m.a + ',' + m.b + ',' + m.c + ',' + m.d + ',' + m.e + ',' + m.f + ')'; node.setAttribute('transform', mstr); } Canvas.prototype._fitViewport = function(center) { const vbox = this.viewbox(), outer = vbox.outer, inner = vbox.inner; let newScale, newViewbox; // display the complete diagram without zooming in. // instead of relying on internal zoom, we perform a // hard reset on the canvas viewbox to realize this // // if diagram does not need to be zoomed in, we focus it around // the diagram origin instead if (inner.x >= 0 && inner.y >= 0 && inner.x + inner.width <= outer.width && inner.y + inner.height <= outer.height && !center) { newViewbox = { x: 0, y: 0, width: Math.max(inner.width + inner.x, outer.width), height: Math.max(inner.height + inner.y, outer.height) }; } else { newScale = Math.min(1, outer.width / inner.width, outer.height / inner.height); newViewbox = { x: inner.x + (center ? inner.width / 2 - outer.width / newScale / 2 : 0), y: inner.y + (center ? inner.height / 2 - outer.height / newScale / 2 : 0), width: outer.width / newScale, height: outer.height / newScale }; } this.viewbox(newViewbox); return this.viewbox(false).scale; }; Canvas.prototype._setZoom = function(scale, center) { const svg = this._svg, viewport = this._viewport; const matrix = svg.createSVGMatrix(); const point = svg.createSVGPoint(); let centerPoint, originalPoint, currentMatrix, scaleMatrix, newMatrix; currentMatrix = viewport.getCTM(); const currentScale = currentMatrix.a; if (center) { centerPoint = assign(point, center); // revert applied viewport transformations originalPoint = centerPoint.matrixTransform(currentMatrix.inverse()); // create scale matrix scaleMatrix = matrix .translate(originalPoint.x, originalPoint.y) .scale(1 / currentScale * scale) .translate(-originalPoint.x, -originalPoint.y); newMatrix = currentMatrix.multiply(scaleMatrix); } else { newMatrix = matrix.scale(scale); } setCTM(this._viewport, newMatrix); return newMatrix; }; /** * Returns the size of the canvas * * @return {Dimensions} */ Canvas.prototype.getSize = function() { return { width: this._container.clientWidth, height: this._container.clientHeight }; }; /** * Return the absolute bounding box for the given element * * The absolute bounding box may be used to display overlays in the * callers (browser) coordinate system rather than the zoomed in/out * canvas coordinates. * * @param {ElementDescriptor} element * @return {Bounds} the absolute bounding box */ Canvas.prototype.getAbsoluteBBox = function(element) { const vbox = this.viewbox(); let bbox; // connection // use svg bbox if (element.waypoints) { const gfx = this.getGraphics(element); bbox = gfx.getBBox(); } // shapes // use data else { bbox = element; } const x = bbox.x * vbox.scale - vbox.x * vbox.scale; const y = bbox.y * vbox.scale - vbox.y * vbox.scale; const width = bbox.width * vbox.scale; const height = bbox.height * vbox.scale; return { x: x, y: y, width: width, height: height }; }; /** * Fires an event in order other modules can react to the * canvas resizing */ Canvas.prototype.resized = function() { // force recomputation of view box delete this._cachedViewbox; this._eventBus.fire('canvas.resized'); };