fabric 5.3.0 → 6.0.0-beta3

package/src/shapes/active_selection.class.js

@@ -1,155 +0,0 @@
-(function(global) {
-
-  'use strict';
-
-  var fabric = global.fabric || (global.fabric = { });
-
-  if (fabric.ActiveSelection) {
-    return;
-  }
-
-  /**
-   * Group class
-   * @class fabric.ActiveSelection
-   * @extends fabric.Group
-   * @tutorial {@link http://fabricjs.com/fabric-intro-part-3#groups}
-   * @see {@link fabric.ActiveSelection#initialize} for constructor definition
-   */
-  fabric.ActiveSelection = fabric.util.createClass(fabric.Group, /** @lends fabric.ActiveSelection.prototype */ {
-
-    /**
-     * Type of an object
-     * @type String
-     * @default
-     */
-    type: 'activeSelection',
-
-    /**
-     * Constructor
-     * @param {Object} objects ActiveSelection objects
-     * @param {Object} [options] Options object
-     * @return {Object} thisArg
-     */
-    initialize: function(objects, options) {
-      options = options || {};
-      this._objects = objects || [];
-      for (var i = this._objects.length; i--; ) {
-        this._objects[i].group = this;
-      }
-
-      if (options.originX) {
-        this.originX = options.originX;
-      }
-      if (options.originY) {
-        this.originY = options.originY;
-      }
-      this._calcBounds();
-      this._updateObjectsCoords();
-      fabric.Object.prototype.initialize.call(this, options);
-      this.setCoords();
-    },
-
-    /**
-     * Change te activeSelection to a normal group,
-     * High level function that automatically adds it to canvas as
-     * active object. no events fired.
-     * @since 2.0.0
-     * @return {fabric.Group}
-     */
-    toGroup: function() {
-      var objects = this._objects.concat();
-      this._objects = [];
-      var options = fabric.Object.prototype.toObject.call(this);
-      var newGroup = new fabric.Group([]);
-      delete options.type;
-      newGroup.set(options);
-      objects.forEach(function(object) {
-        object.canvas.remove(object);
-        object.group = newGroup;
-      });
-      newGroup._objects = objects;
-      if (!this.canvas) {
-        return newGroup;
-      }
-      var canvas = this.canvas;
-      canvas.add(newGroup);
-      canvas._activeObject = newGroup;
-      newGroup.setCoords();
-      return newGroup;
-    },
-
-    /**
-     * If returns true, deselection is cancelled.
-     * @since 2.0.0
-     * @return {Boolean} [cancel]
-     */
-    onDeselect: function() {
-      this.destroy();
-      return false;
-    },
-
-    /**
-     * Returns string representation of a group
-     * @return {String}
-     */
-    toString: function() {
-      return '#<fabric.ActiveSelection: (' + this.complexity() + ')>';
-    },
-
-    /**
-     * Decide if the object should cache or not. Create its own cache level
-     * objectCaching is a global flag, wins over everything
-     * needsItsOwnCache should be used when the object drawing method requires
-     * a cache step. None of the fabric classes requires it.
-     * Generally you do not cache objects in groups because the group outside is cached.
-     * @return {Boolean}
-     */
-    shouldCache: function() {
-      return false;
-    },
-
-    /**
-     * Check if this group or its parent group are caching, recursively up
-     * @return {Boolean}
-     */
-    isOnACache: function() {
-      return false;
-    },
-
-    /**
-     * Renders controls and borders for the object
-     * @param {CanvasRenderingContext2D} ctx Context to render on
-     * @param {Object} [styleOverride] properties to override the object style
-     * @param {Object} [childrenOverride] properties to override the children overrides
-     */
-    _renderControls: function(ctx, styleOverride, childrenOverride) {
-      ctx.save();
-      ctx.globalAlpha = this.isMoving ? this.borderOpacityWhenMoving : 1;
-      this.callSuper('_renderControls', ctx, styleOverride);
-      childrenOverride = childrenOverride || { };
-      if (typeof childrenOverride.hasControls === 'undefined') {
-        childrenOverride.hasControls = false;
-      }
-      childrenOverride.forActiveSelection = true;
-      for (var i = 0, len = this._objects.length; i < len; i++) {
-        this._objects[i]._renderControls(ctx, childrenOverride);
-      }
-      ctx.restore();
-    },
-  });
-
-  /**
-   * Returns {@link fabric.ActiveSelection} instance from an object representation
-   * @static
-   * @memberOf fabric.ActiveSelection
-   * @param {Object} object Object to create a group from
-   * @param {Function} [callback] Callback to invoke when an ActiveSelection instance is created
-   */
-  fabric.ActiveSelection.fromObject = function(object, callback) {
-    fabric.util.enlivenObjects(object.objects, function(enlivenedObjects) {
-      delete object.objects;
-      callback && callback(new fabric.ActiveSelection(enlivenedObjects, object, true));
-    });
-  };
-
-})(typeof exports !== 'undefined' ? exports : this);

package/src/shapes/circle.class.js

@@ -1,210 +0,0 @@
-(function(global) {
-
-  'use strict';
-
-  var fabric = global.fabric || (global.fabric = { }),
-      degreesToRadians = fabric.util.degreesToRadians;
-
-  if (fabric.Circle) {
-    fabric.warn('fabric.Circle is already defined.');
-    return;
-  }
-
-  /**
-   * Circle class
-   * @class fabric.Circle
-   * @extends fabric.Object
-   * @see {@link fabric.Circle#initialize} for constructor definition
-   */
-  fabric.Circle = fabric.util.createClass(fabric.Object, /** @lends fabric.Circle.prototype */ {
-
-    /**
-     * Type of an object
-     * @type String
-     * @default
-     */
-    type: 'circle',
-
-    /**
-     * Radius of this circle
-     * @type Number
-     * @default
-     */
-    radius: 0,
-
-    /**
-     * degrees of start of the circle.
-     * probably will change to degrees in next major version
-     * @type Number 0 - 359
-     * @default 0
-     */
-    startAngle: 0,
-
-    /**
-     * End angle of the circle
-     * probably will change to degrees in next major version
-     * @type Number 1 - 360
-     * @default 360
-     */
-    endAngle: 360,
-
-    cacheProperties: fabric.Object.prototype.cacheProperties.concat('radius', 'startAngle', 'endAngle'),
-
-    /**
-     * @private
-     * @param {String} key
-     * @param {*} value
-     * @return {fabric.Circle} thisArg
-     */
-    _set: function(key, value) {
-      this.callSuper('_set', key, value);
-
-      if (key === 'radius') {
-        this.setRadius(value);
-      }
-
-      return this;
-    },
-
-    /**
-     * Returns object representation of an instance
-     * @param {Array} [propertiesToInclude] Any properties that you might want to additionally include in the output
-     * @return {Object} object representation of an instance
-     */
-    toObject: function(propertiesToInclude) {
-      return this.callSuper('toObject', ['radius', 'startAngle', 'endAngle'].concat(propertiesToInclude));
-    },
-
-    /* _TO_SVG_START_ */
-
-    /**
-     * Returns svg representation of an instance
-     * @return {Array} an array of strings with the specific svg representation
-     * of the instance
-     */
-    _toSVG: function() {
-      var svgString, x = 0, y = 0,
-          angle = (this.endAngle - this.startAngle) % 360;
-
-      if (angle === 0) {
-        svgString = [
-          '<circle ', 'COMMON_PARTS',
-          'cx="' + x + '" cy="' + y + '" ',
-          'r="', this.radius,
-          '" />\n'
-        ];
-      }
-      else {
-        var start = degreesToRadians(this.startAngle),
-            end = degreesToRadians(this.endAngle),
-            radius = this.radius,
-            startX = fabric.util.cos(start) * radius,
-            startY = fabric.util.sin(start) * radius,
-            endX = fabric.util.cos(end) * radius,
-            endY = fabric.util.sin(end) * radius,
-            largeFlag = angle > 180 ? '1' : '0';
-        svgString = [
-          '<path d="M ' + startX + ' ' + startY,
-          ' A ' + radius + ' ' + radius,
-          ' 0 ', +largeFlag + ' 1', ' ' + endX + ' ' + endY,
-          '" ', 'COMMON_PARTS', ' />\n'
-        ];
-      }
-      return svgString;
-    },
-    /* _TO_SVG_END_ */
-
-    /**
-     * @private
-     * @param {CanvasRenderingContext2D} ctx context to render on
-     */
-    _render: function(ctx) {
-      ctx.beginPath();
-      ctx.arc(
-        0,
-        0,
-        this.radius,
-        degreesToRadians(this.startAngle),
-        degreesToRadians(this.endAngle),
-        false
-      );
-      this._renderPaintInOrder(ctx);
-    },
-
-    /**
-     * Returns horizontal radius of an object (according to how an object is scaled)
-     * @return {Number}
-     */
-    getRadiusX: function() {
-      return this.get('radius') * this.get('scaleX');
-    },
-
-    /**
-     * Returns vertical radius of an object (according to how an object is scaled)
-     * @return {Number}
-     */
-    getRadiusY: function() {
-      return this.get('radius') * this.get('scaleY');
-    },
-
-    /**
-     * Sets radius of an object (and updates width accordingly)
-     * @return {fabric.Circle} thisArg
-     */
-    setRadius: function(value) {
-      this.radius = value;
-      return this.set('width', value * 2).set('height', value * 2);
-    },
-  });
-
-  /* _FROM_SVG_START_ */
-  /**
-   * List of attribute names to account for when parsing SVG element (used by {@link fabric.Circle.fromElement})
-   * @static
-   * @memberOf fabric.Circle
-   * @see: http://www.w3.org/TR/SVG/shapes.html#CircleElement
-   */
-  fabric.Circle.ATTRIBUTE_NAMES = fabric.SHARED_ATTRIBUTES.concat('cx cy r'.split(' '));
-
-  /**
-   * Returns {@link fabric.Circle} instance from an SVG element
-   * @static
-   * @memberOf fabric.Circle
-   * @param {SVGElement} element Element to parse
-   * @param {Function} [callback] Options callback invoked after parsing is finished
-   * @param {Object} [options] Options object
-   * @throws {Error} If value of `r` attribute is missing or invalid
-   */
-  fabric.Circle.fromElement = function(element, callback) {
-    var parsedAttributes = fabric.parseAttributes(element, fabric.Circle.ATTRIBUTE_NAMES);
-
-    if (!isValidRadius(parsedAttributes)) {
-      throw new Error('value of `r` attribute is required and can not be negative');
-    }
-
-    parsedAttributes.left = (parsedAttributes.left || 0) - parsedAttributes.radius;
-    parsedAttributes.top = (parsedAttributes.top || 0) - parsedAttributes.radius;
-    callback(new fabric.Circle(parsedAttributes));
-  };
-
-  /**
-   * @private
-   */
-  function isValidRadius(attributes) {
-    return (('radius' in attributes) && (attributes.radius >= 0));
-  }
-  /* _FROM_SVG_END_ */
-
-  /**
-   * Returns {@link fabric.Circle} instance from an object representation
-   * @static
-   * @memberOf fabric.Circle
-   * @param {Object} object Object to create an instance from
-   * @param {function} [callback] invoked with new instance as first argument
-   * @return {void}
-   */
-  fabric.Circle.fromObject = function(object, callback) {
-    fabric.Object._fromObject('Circle', object, callback);
-  };
-
-})(typeof exports !== 'undefined' ? exports : this);

package/src/shapes/ellipse.class.js

@@ -1,181 +0,0 @@
-(function(global) {
-
-  'use strict';
-
-  var fabric = global.fabric || (global.fabric = { }),
-      piBy2   = Math.PI * 2;
-
-  if (fabric.Ellipse) {
-    fabric.warn('fabric.Ellipse is already defined.');
-    return;
-  }
-
-  /**
-   * Ellipse class
-   * @class fabric.Ellipse
-   * @extends fabric.Object
-   * @return {fabric.Ellipse} thisArg
-   * @see {@link fabric.Ellipse#initialize} for constructor definition
-   */
-  fabric.Ellipse = fabric.util.createClass(fabric.Object, /** @lends fabric.Ellipse.prototype */ {
-
-    /**
-     * Type of an object
-     * @type String
-     * @default
-     */
-    type: 'ellipse',
-
-    /**
-     * Horizontal radius
-     * @type Number
-     * @default
-     */
-    rx:   0,
-
-    /**
-     * Vertical radius
-     * @type Number
-     * @default
-     */
-    ry:   0,
-
-    cacheProperties: fabric.Object.prototype.cacheProperties.concat('rx', 'ry'),
-
-    /**
-     * Constructor
-     * @param {Object} [options] Options object
-     * @return {fabric.Ellipse} thisArg
-     */
-    initialize: function(options) {
-      this.callSuper('initialize', options);
-      this.set('rx', options && options.rx || 0);
-      this.set('ry', options && options.ry || 0);
-    },
-
-    /**
-     * @private
-     * @param {String} key
-     * @param {*} value
-     * @return {fabric.Ellipse} thisArg
-     */
-    _set: function(key, value) {
-      this.callSuper('_set', key, value);
-      switch (key) {
-
-        case 'rx':
-          this.rx = value;
-          this.set('width', value * 2);
-          break;
-
-        case 'ry':
-          this.ry = value;
-          this.set('height', value * 2);
-          break;
-
-      }
-      return this;
-    },
-
-    /**
-     * Returns horizontal radius of an object (according to how an object is scaled)
-     * @return {Number}
-     */
-    getRx: function() {
-      return this.get('rx') * this.get('scaleX');
-    },
-
-    /**
-     * Returns Vertical radius of an object (according to how an object is scaled)
-     * @return {Number}
-     */
-    getRy: function() {
-      return this.get('ry') * this.get('scaleY');
-    },
-
-    /**
-     * Returns object representation of an instance
-     * @param {Array} [propertiesToInclude] Any properties that you might want to additionally include in the output
-     * @return {Object} object representation of an instance
-     */
-    toObject: function(propertiesToInclude) {
-      return this.callSuper('toObject', ['rx', 'ry'].concat(propertiesToInclude));
-    },
-
-    /* _TO_SVG_START_ */
-    /**
-     * Returns svg representation of an instance
-     * @return {Array} an array of strings with the specific svg representation
-     * of the instance
-     */
-    _toSVG: function() {
-      return [
-        '<ellipse ', 'COMMON_PARTS',
-        'cx="0" cy="0" ',
-        'rx="', this.rx,
-        '" ry="', this.ry,
-        '" />\n'
-      ];
-    },
-    /* _TO_SVG_END_ */
-
-    /**
-     * @private
-     * @param {CanvasRenderingContext2D} ctx context to render on
-     */
-    _render: function(ctx) {
-      ctx.beginPath();
-      ctx.save();
-      ctx.transform(1, 0, 0, this.ry / this.rx, 0, 0);
-      ctx.arc(
-        0,
-        0,
-        this.rx,
-        0,
-        piBy2,
-        false);
-      ctx.restore();
-      this._renderPaintInOrder(ctx);
-    },
-  });
-
-  /* _FROM_SVG_START_ */
-  /**
-   * List of attribute names to account for when parsing SVG element (used by {@link fabric.Ellipse.fromElement})
-   * @static
-   * @memberOf fabric.Ellipse
-   * @see http://www.w3.org/TR/SVG/shapes.html#EllipseElement
-   */
-  fabric.Ellipse.ATTRIBUTE_NAMES = fabric.SHARED_ATTRIBUTES.concat('cx cy rx ry'.split(' '));
-
-  /**
-   * Returns {@link fabric.Ellipse} instance from an SVG element
-   * @static
-   * @memberOf fabric.Ellipse
-   * @param {SVGElement} element Element to parse
-   * @param {Function} [callback] Options callback invoked after parsing is finished
-   * @return {fabric.Ellipse}
-   */
-  fabric.Ellipse.fromElement = function(element, callback) {
-
-    var parsedAttributes = fabric.parseAttributes(element, fabric.Ellipse.ATTRIBUTE_NAMES);
-
-    parsedAttributes.left = (parsedAttributes.left || 0) - parsedAttributes.rx;
-    parsedAttributes.top = (parsedAttributes.top || 0) - parsedAttributes.ry;
-    callback(new fabric.Ellipse(parsedAttributes));
-  };
-  /* _FROM_SVG_END_ */
-
-  /**
-   * Returns {@link fabric.Ellipse} instance from an object representation
-   * @static
-   * @memberOf fabric.Ellipse
-   * @param {Object} object Object to create an instance from
-   * @param {function} [callback] invoked with new instance as first argument
-   * @return {void}
-   */
-  fabric.Ellipse.fromObject = function(object, callback) {
-    fabric.Object._fromObject('Ellipse', object, callback);
-  };
-
-})(typeof exports !== 'undefined' ? exports : this);