fabric-rails 1.0.12.1 → 1.2.1

data/vendor/assets/javascripts/fabric/util/dom_request.js

@@ -26,7 +26,6 @@
 
   /**
    * Cross-browser abstraction for sending XMLHttpRequest
-   * @method request
    * @memberOf fabric.util
    * @param {String} url URL to send XMLHttpRequest to
    * @param {Object} [options] Options object
@@ -69,4 +68,4 @@
   }
 
   fabric.util.request = request;
-})();
+})();

data/vendor/assets/javascripts/fabric/util/dom_style.js

@@ -2,7 +2,6 @@
 
   /**
    * Cross-browser wrapper for setting element's style
-   * @method setStyle
    * @memberOf fabric.util
    * @param {HTMLElement} element
    * @param {Object} styles
@@ -68,4 +67,4 @@
 
   fabric.util.setStyle = setStyle;
 
-})();
+})();

data/vendor/assets/javascripts/fabric/util/lang_array.js

@@ -2,12 +2,14 @@
 
   var slice = Array.prototype.slice;
 
+  /* _ES5_COMPAT_START_ */
+
   if (!Array.prototype.indexOf) {
     /**
      * Finds index of an element in an array
-     * @method indexOf
      * @param {Any} searchElement
      * @param {Number} [fromIndex]
+     * @return {Number}
      */
     Array.prototype.indexOf = function (searchElement /*, fromIndex */ ) {
       if (this === void 0 || this === null) {
@@ -23,7 +25,7 @@
         if (n !== n) { // shortcut for verifying if it's NaN
           n = 0;
         }
-        else if (n !== 0 && n !== (1 / 0) && n !== -(1 / 0)) {
+        else if (n !== 0 && n !== Number.POSITIVE_INFINITY && n !== Number.NEGATIVE_INFINITY) {
           n = (n > 0 || -1) * Math.floor(Math.abs(n));
         }
       }
@@ -43,9 +45,9 @@
   if (!Array.prototype.forEach) {
     /**
      * Iterates an array, invoking callback for each element
-     * @method forEach
      * @param {Function} fn Callback to invoke for each element
      * @param {Object} [context] Context to invoke callback in
+     * @return {Array}
      */
     Array.prototype.forEach = function(fn, context) {
       for (var i = 0, len = this.length >>> 0; i < len; i++) {
@@ -59,9 +61,9 @@
   if (!Array.prototype.map) {
     /**
      * Returns a result of iterating over an array, invoking callback for each element
-     * @method map
      * @param {Function} fn Callback to invoke for each element
      * @param {Object} [context] Context to invoke callback in
+     * @return {Array}
      */
     Array.prototype.map = function(fn, context) {
       var result = [ ];
@@ -77,9 +79,9 @@
   if (!Array.prototype.every) {
     /**
      * Returns true if a callback returns truthy value for all elements in an array
-     * @method every
      * @param {Function} fn Callback to invoke for each element
      * @param {Object} [context] Context to invoke callback in
+     * @return {Boolean}
      */
     Array.prototype.every = function(fn, context) {
       for (var i = 0, len = this.length >>> 0; i < len; i++) {
@@ -94,9 +96,9 @@
   if (!Array.prototype.some) {
     /**
      * Returns true if a callback returns truthy value for at least one element in an array
-     * @method every
      * @param {Function} fn Callback to invoke for each element
      * @param {Object} [context] Context to invoke callback in
+     * @return {Boolean}
      */
     Array.prototype.some = function(fn, context) {
       for (var i = 0, len = this.length >>> 0; i < len; i++) {
@@ -111,9 +113,9 @@
   if (!Array.prototype.filter) {
     /**
      * Returns the result of iterating over elements in an array
-     * @method filter
      * @param {Function} fn Callback to invoke for each element
      * @param {Object} [context] Context to invoke callback in
+     * @return {Array}
      */
     Array.prototype.filter = function(fn, context) {
       var result = [ ], val;
@@ -132,9 +134,9 @@
   if (!Array.prototype.reduce) {
     /**
      * Returns "folded" (reduced) result of iterating over elements in an array
-     * @method filter
      * @param {Function} fn Callback to invoke for each element
      * @param {Object} [context] Context to invoke callback in
+     * @return {Any}
      */
     Array.prototype.reduce = function(fn /*, initial*/) {
       var len = this.length >>> 0,
@@ -166,12 +168,14 @@
     };
   }
 
+  /* _ES5_COMPAT_END_ */
+
   /**
    * Invokes method on all items in a given array
-   * @method invoke
    * @memberOf fabric.util.array
    * @param {Array} array Array to iterate over
    * @param {String} method Name of a method to invoke
+   * @return {Array}
    */
   function invoke(array, method) {
     var args = slice.call(arguments, 2), result = [ ];
@@ -183,10 +187,10 @@
 
   /**
    * Finds maximum value in array (not necessarily "first" one)
-   * @method max
    * @memberOf fabric.util.array
    * @param {Array} array Array to iterate over
    * @param {String} byProperty
+   * @return {Any}
    */
   function max(array, byProperty) {
     if (!array || array.length === 0) return undefined;
@@ -212,10 +216,10 @@
 
   /**
    * Finds minimum value in array (not necessarily "first" one)
-   * @method min
    * @memberOf fabric.util.array
    * @param {Array} array Array to iterate over
    * @param {String} byProperty
+   * @return {Any}
    */
   function min(array, byProperty) {
     if (!array || array.length === 0) return undefined;
@@ -240,11 +244,13 @@
     return result;
   }
 
-  /** @namespace */
+  /**
+   * @namespace fabric.util.array
+   */
   fabric.util.array = {
     invoke: invoke,
     min: min,
     max: max
   };
 
-})();
+})();

data/vendor/assets/javascripts/fabric/util/lang_class.js

@@ -57,7 +57,6 @@
 
   /**
    * Helper for creation of "classes". Note that pr
-   * @method createClass
    * @param parent optional "Class" to inherit from
    * @param properties Properties shared by all instances of this class
    *                  (be careful modifying objects defined here as this would affect all instances)
@@ -94,4 +93,4 @@
   }
 
   fabric.util.createClass = createClass;
-})();
+})();

data/vendor/assets/javascripts/fabric/util/lang_function.js

@@ -1,3 +1,4 @@
+/* _ES5_COMPAT_START_ */
 (function() {
 
   var slice = Array.prototype.slice,
@@ -32,4 +33,5 @@
     };
   }
 
-})();
+})();
+/* _ES5_COMPAT_END_ */

data/vendor/assets/javascripts/fabric/util/lang_object.js

@@ -1,11 +1,11 @@
 (function(){
-  
+
   /**
    * Copies all enumerable properties of one object to another
    * @memberOf fabric.util.object
-   * @method extend
    * @param {Object} destination Where to copy to
    * @param {Object} source Where to copy from
+   * @return {Object}
    */
   function extend(destination, source) {
     // JScript DontEnum bug is not taken care of
@@ -17,9 +17,9 @@
 
   /**
    * Creates an empty object and copies all enumerable properties of another object to it
-   * @method clone
    * @memberOf fabric.util.object
    * @param {Object} object Object to clone
+   * @return {Object}
    */
   function clone(object) {
     return extend({ }, object);
@@ -30,5 +30,5 @@
     extend: extend,
     clone: clone
   };
-  
-})();
+
+})();

data/vendor/assets/javascripts/fabric/util/lang_string.js

@@ -1,9 +1,10 @@
 (function() {
 
+/* _ES5_COMPAT_START_ */
 if (!String.prototype.trim) {
   /**
    * Trims a string (removing whitespace from the beginning and the end)
-   * @method trim
+   * @function external:String#trim
    * @see <a href="https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/String/Trim">String#trim on MDN</a>
    */
   String.prototype.trim = function () {
@@ -11,11 +12,11 @@ if (!String.prototype.trim) {
     return this.replace(/^[\s\xA0]+/, '').replace(/[\s\xA0]+$/, '');
   };
 }
+/* _ES5_COMPAT_END_ */
 
 /**
  * Camelizes a string
  * @memberOf fabric.util.string
- * @method camelize
  * @param {String} string String to camelize
  * @return {String} Camelized version of a string
  */
@@ -28,7 +29,6 @@ function camelize(string) {
 /**
  * Capitalizes a string
  * @memberOf fabric.util.string
- * @method capitalize
  * @param {String} string String to capitalize
  * @return {String} Capitalized version of a string
  */
@@ -39,7 +39,6 @@ function capitalize(string) {
 /**
  * Escapes XML in a string
  * @memberOf fabric.util.string
- * @method escapeXml
  * @param {String} string String to escape
  * @return {String} Escaped version of a string
  */
@@ -51,7 +50,10 @@ function escapeXml(string) {
      .replace(/>/g, '&gt;');
 }
 
-/** @namespace */
+/**
+ * String utilities
+ * @namespace fabric.util.string
+ */
 fabric.util.string = {
   camelize: camelize,
   capitalize: capitalize,

data/vendor/assets/javascripts/fabric/util/misc.js

@@ -4,7 +4,7 @@
       atan2 = Math.atan2;
 
   /**
-   * @namespace
+   * @namespace fabric.util
    */
   fabric.util = { };
 
@@ -13,7 +13,6 @@
    * Presence of value (and its position in an array) is determined via `Array.prototype.indexOf`
    * @static
    * @memberOf fabric.util
-   * @method removeFromArray
    * @param {Array} array
    * @param {Any} value
    * @return {Array} original array
@@ -29,7 +28,6 @@
   /**
    * Returns random number between 2 specified ones.
    * @static
-   * @method getRandomInt
    * @memberOf fabric.util
    * @param {Number} min lower limit
    * @param {Number} max upper limit
@@ -44,7 +42,6 @@
   /**
    * Transforms degrees to radians.
    * @static
-   * @method degreesToRadians
    * @memberOf fabric.util
    * @param {Number} degrees value in degrees
    * @return {Number} value in radians
@@ -56,7 +53,6 @@
   /**
    * Transforms radians to degrees.
    * @static
-   * @method radiansToDegrees
    * @memberOf fabric.util
    * @param {Number} radians value in radians
    * @return {Number} value in degrees
@@ -68,7 +64,6 @@
   /**
    * Rotates `point` around `origin` with `radians`
    * @static
-   * @method rotatePoint
    * @memberOf fabric.util
    * @param {fabric.Point} The point to rotate
    * @param {fabric.Point} The origin of the rotation
@@ -90,7 +85,6 @@
   /**
    * A wrapper around Number#toFixed, which contrary to native method returns number, not string.
    * @static
-   * @method toFixed
    * @memberOf fabric.util
    * @param {Number | String} number number to operate on
    * @param {Number} fractionDigits number of fraction digits to "leave"
@@ -103,7 +97,6 @@
    /**
     * Function which always returns `false`.
     * @static
-    * @method falseFunction
     * @memberOf fabric.util
     * @return {Boolean}
     */
@@ -113,7 +106,6 @@
 
    /**
     * Changes value from one to another within certain period of time, invoking callbacks as value is being changed.
-    * @method animate
     * @memberOf fabric.util
     * @param {Object} [options] Animation options
     * @param {Function} [options.onChange] Callback; invoked on every value change
@@ -162,7 +154,6 @@
                           };
   /**
     * requestAnimationFrame polyfill based on http://paulirish.com/2011/requestanimationframe-for-smart-animating/
-    * @method requestAnimFrame
     * @memberOf fabric.util
     * @param {Function} callback Callback to invoke
     * @param {DOMElement} element optional Element to associate with animation
@@ -171,9 +162,18 @@
     return _requestAnimFrame.apply(fabric.window, arguments);
   };
 
+  /**
+    * Returns klass "Class" object of given fabric.Object type
+    * @memberOf fabric.util
+    * @param {String} type Type of object (eg. 'circle')
+    * @return {Object} klass "Class"
+    */
+  function getKlass(type) {
+    return fabric[fabric.util.string.camelize(fabric.util.string.capitalize(type))];
+  }
+
   /**
     * Loads image element from given url and passes it to a callback
-    * @method loadImage
     * @memberOf fabric.util
     * @param {String} url URL representing an image
     * @param {Function} callback Callback; invoked with loaded image
@@ -181,7 +181,7 @@
     */
   function loadImage(url, callback, context) {
     if (url) {
-      var img = new Image();
+      var img = fabric.util.createImage();
       /** @ignore */
       img.onload = function () {
         callback && callback.call(context, img);
@@ -198,16 +198,11 @@
    * Creates corresponding fabric instances from their object representations
    * @static
    * @memberOf fabric.util
-   * @method enlivenObjects
    * @param {Array} objects Objects to enliven
    * @param {Function} callback Callback to invoke when all objects are created
    */
   function enlivenObjects(objects, callback) {
 
-    function getKlass(type) {
-      return fabric[fabric.util.string.camelize(fabric.util.string.capitalize(type))];
-    }
-
     function onLoaded() {
       if (++numLoadedObjects === numTotalObjects) {
         if (callback) {
@@ -224,7 +219,7 @@
       if (!o.type) {
         return;
       }
-      var klass = getKlass(o.type);
+      var klass = fabric.util.getKlass(o.type);
       if (klass.async) {
         klass.fromObject(o, function (o, error) {
           if (!error) {
@@ -244,7 +239,6 @@
    * Groups SVG elements (usually those retrieved from SVG document)
    * @static
    * @memberOf fabric.util
-   * @method groupSVGElements
    * @param {Array} elements SVG elements to group
    * @param {Object} [options] Options object
    * @return {fabric.Object|fabric.PathGroup}
@@ -253,23 +247,7 @@
     var object;
 
     if (elements.length > 1) {
-      var hasText = elements.some(function(el) { return el.type === 'text'; });
-
-      if (hasText) {
-        object = new fabric.Group([ ], options);
-        elements.reverse().forEach(function(obj) {
-          if (obj.cx) {
-            obj.left = obj.cx;
-          }
-          if (obj.cy) {
-            obj.top = obj.cy;
-          }
-          object.addWithUpdate(obj);
-        });
-      }
-      else {
-        object = new fabric.PathGroup(elements, options);
-      }
+      object = new fabric.PathGroup(elements, options);
     }
     else {
       object = elements[0];
@@ -285,7 +263,6 @@
    * Populates an object with properties of another object
    * @static
    * @memberOf fabric.util
-   * @method populateWithProperties
    * @param {Object} source Source object
    * @param {Object} destination Destination object
    * @return {Array} properties Propertie names to include
@@ -293,7 +270,9 @@
   function populateWithProperties(source, destination, properties) {
     if (properties && Object.prototype.toString.call(properties) === '[object Array]') {
       for (var i = 0, len = properties.length; i < len; i++) {
-        destination[properties[i]] = source[properties[i]];
+        if (properties[i] in source) {
+          destination[properties[i]] = source[properties[i]];
+        }
       }
     }
   }
@@ -304,7 +283,6 @@
    * This method is used to draw dashed line around selection area.
    * See <a href="http://stackoverflow.com/questions/4576724/dotted-stroke-in-canvas">dotted stroke in canvas</a>
    *
-   * @method drawDashedLine
    * @param ctx {Canvas} context
    * @param x {Number} start x coordinate
    * @param y {Number} start y coordinate
@@ -343,7 +321,6 @@
    * Creates canvas element and initializes it via excanvas if necessary
    * @static
    * @memberOf fabric.util
-   * @method createCanvasElement
    * @param {CanvasElement} [canvasEl] optional canvas element to initialize; when not given, element is created implicitly
    * @return {CanvasElement} initialized canvas element
    */
@@ -355,11 +332,22 @@
     return canvasEl;
   }
 
+  /**
+   * Creates image element (works on client and node)
+   * @static
+   * @memberOf fabric.util
+   * @return {Image} image element
+   */
+  function createImage() {
+    return fabric.isLikelyNode
+      ? new (require('canvas').Image)()
+      : fabric.document.createElement('img');
+  }
+
   /**
    * Creates accessors (getXXX, setXXX) for a "class", based on "stateProperties" array
    * @static
    * @memberOf fabric.util
-   * @method createAccessors
    * @param {Object} klass "Class" to create accessors for
    */
   function createAccessors(klass) {
@@ -386,6 +374,177 @@
     }
   }
 
+  /**
+   * @static
+   * @memberOf fabric.util
+   * @param {fabric.Object} receiver Object implementing `clipTo` method
+   * @param {CanvasRenderingContext2D} ctx Context to clip
+   */
+  function clipContext(receiver, ctx) {
+    ctx.save();
+    ctx.beginPath();
+    receiver.clipTo(ctx);
+    ctx.clip();
+  }
+
+  /**
+   * Multiply matrix A by matrix B to nest transformations
+   * @static
+   * @memberOf fabric.util
+   * @param  {Array} matrixA First transformMatrix
+   * @param  {Array} matrixB Second transformMatrix
+   * @return {Array} The product of the two transform matrices
+   */
+  function multiplyTransformMatrices(matrixA, matrixB) {
+    // Matrix multiply matrixA * matrixB
+    var a = [
+      [matrixA[0], matrixA[2], matrixA[4]],
+      [matrixA[1], matrixA[3], matrixA[5]],
+      [0         , 0         , 1         ]
+    ];
+
+    var b = [
+      [matrixB[0], matrixB[2], matrixB[4]],
+      [matrixB[1], matrixB[3], matrixB[5]],
+      [0         , 0         , 1         ]
+    ];
+
+    var result = [];
+    for (var r=0; r<3; r++) {
+      result[r] = [];
+      for (var c=0; c<3; c++) {
+        var sum = 0;
+        for (var k=0; k<3; k++) {
+          sum += a[r][k]*b[k][c];
+        }
+
+        result[r][c] = sum;
+      }
+    }
+
+    return [
+      result[0][0],
+      result[1][0],
+      result[0][1],
+      result[1][1],
+      result[0][2],
+      result[1][2]
+    ];
+  }
+
+  function getFunctionBody(fn) {
+    return (String(fn).match(/function[^{]*\{([\s\S]*)\}/) || {})[1];
+  }
+
+  function drawArc(ctx, x, y, coords) {
+    var rx = coords[0];
+    var ry = coords[1];
+    var rot = coords[2];
+    var large = coords[3];
+    var sweep = coords[4];
+    var ex = coords[5];
+    var ey = coords[6];
+    var segs = arcToSegments(ex, ey, rx, ry, large, sweep, rot, x, y);
+    for (var i=0; i<segs.length; i++) {
+     var bez = segmentToBezier.apply(this, segs[i]);
+     ctx.bezierCurveTo.apply(ctx, bez);
+    }
+  }
+
+  var arcToSegmentsCache = { },
+      segmentToBezierCache = { },
+      _join = Array.prototype.join,
+      argsString;
+
+  // Generous contribution by Raph Levien, from libsvg-0.1.0.tar.gz
+  function arcToSegments(x, y, rx, ry, large, sweep, rotateX, ox, oy) {
+    argsString = _join.call(arguments);
+    if (arcToSegmentsCache[argsString]) {
+      return arcToSegmentsCache[argsString];
+    }
+
+    var th = rotateX * (Math.PI/180);
+    var sin_th = Math.sin(th);
+    var cos_th = Math.cos(th);
+    rx = Math.abs(rx);
+    ry = Math.abs(ry);
+    var px = cos_th * (ox - x) * 0.5 + sin_th * (oy - y) * 0.5;
+    var py = cos_th * (oy - y) * 0.5 - sin_th * (ox - x) * 0.5;
+    var pl = (px*px) / (rx*rx) + (py*py) / (ry*ry);
+    if (pl > 1) {
+      pl = Math.sqrt(pl);
+      rx *= pl;
+      ry *= pl;
+    }
+
+    var a00 = cos_th / rx;
+    var a01 = sin_th / rx;
+    var a10 = (-sin_th) / ry;
+    var a11 = (cos_th) / ry;
+    var x0 = a00 * ox + a01 * oy;
+    var y0 = a10 * ox + a11 * oy;
+    var x1 = a00 * x + a01 * y;
+    var y1 = a10 * x + a11 * y;
+
+    var d = (x1-x0) * (x1-x0) + (y1-y0) * (y1-y0);
+    var sfactor_sq = 1 / d - 0.25;
+    if (sfactor_sq < 0) sfactor_sq = 0;
+    var sfactor = Math.sqrt(sfactor_sq);
+    if (sweep === large) sfactor = -sfactor;
+    var xc = 0.5 * (x0 + x1) - sfactor * (y1-y0);
+    var yc = 0.5 * (y0 + y1) + sfactor * (x1-x0);
+
+    var th0 = Math.atan2(y0-yc, x0-xc);
+    var th1 = Math.atan2(y1-yc, x1-xc);
+
+    var th_arc = th1-th0;
+    if (th_arc < 0 && sweep === 1){
+      th_arc += 2*Math.PI;
+    } else if (th_arc > 0 && sweep === 0) {
+      th_arc -= 2 * Math.PI;
+    }
+
+    var segments = Math.ceil(Math.abs(th_arc / (Math.PI * 0.5 + 0.001)));
+    var result = [];
+    for (var i=0; i<segments; i++) {
+      var th2 = th0 + i * th_arc / segments;
+      var th3 = th0 + (i+1) * th_arc / segments;
+      result[i] = [xc, yc, th2, th3, rx, ry, sin_th, cos_th];
+    }
+
+    arcToSegmentsCache[argsString] = result;
+    return result;
+  }
+
+  function segmentToBezier(cx, cy, th0, th1, rx, ry, sin_th, cos_th) {
+    argsString = _join.call(arguments);
+    if (segmentToBezierCache[argsString]) {
+      return segmentToBezierCache[argsString];
+    }
+
+    var a00 = cos_th * rx;
+    var a01 = -sin_th * ry;
+    var a10 = sin_th * rx;
+    var a11 = cos_th * ry;
+
+    var th_half = 0.5 * (th1 - th0);
+    var t = (8/3) * Math.sin(th_half * 0.5) * Math.sin(th_half * 0.5) / Math.sin(th_half);
+    var x1 = cx + Math.cos(th0) - t * Math.sin(th0);
+    var y1 = cy + Math.sin(th0) + t * Math.cos(th0);
+    var x3 = cx + Math.cos(th1);
+    var y3 = cy + Math.sin(th1);
+    var x2 = x3 + t * Math.sin(th1);
+    var y2 = y3 - t * Math.cos(th1);
+
+    segmentToBezierCache[argsString] = [
+      a00 * x1 + a01 * y1,      a10 * x1 + a11 * y1,
+      a00 * x2 + a01 * y2,      a10 * x2 + a11 * y2,
+      a00 * x3 + a01 * y3,      a10 * x3 + a11 * y3
+    ];
+
+    return segmentToBezierCache[argsString];
+  }
+
   fabric.util.removeFromArray = removeFromArray;
   fabric.util.degreesToRadians = degreesToRadians;
   fabric.util.radiansToDegrees = radiansToDegrees;
@@ -395,12 +554,18 @@
   fabric.util.falseFunction = falseFunction;
   fabric.util.animate = animate;
   fabric.util.requestAnimFrame = requestAnimFrame;
+  fabric.util.getKlass = getKlass;
   fabric.util.loadImage = loadImage;
   fabric.util.enlivenObjects = enlivenObjects;
   fabric.util.groupSVGElements = groupSVGElements;
   fabric.util.populateWithProperties = populateWithProperties;
   fabric.util.drawDashedLine = drawDashedLine;
   fabric.util.createCanvasElement = createCanvasElement;
+  fabric.util.createImage = createImage;
   fabric.util.createAccessors = createAccessors;
+  fabric.util.clipContext = clipContext;
+  fabric.util.multiplyTransformMatrices = multiplyTransformMatrices;
+  fabric.util.getFunctionBody = getFunctionBody;
+  fabric.util.drawArc = drawArc;
 
-})();
+})();