Version 3.18.1
Show:

File: graphics/js/VMLDrawing.js

            var IMPLEMENTATION = "vml",
                SHAPE = "shape",
            	SPLITPATHPATTERN = /[a-z][^a-z]*/ig,
                SPLITARGSPATTERN = /[\-]?[0-9]*[0-9|\.][0-9]*/g,
                Y_LANG = Y.Lang,
                IS_NUM = Y_LANG.isNumber,
                IS_ARRAY = Y_LANG.isArray,
                Y_DOM = Y.DOM,
                Y_SELECTOR = Y.Selector,
                DOCUMENT = Y.config.doc,
                AttributeLite = Y.AttributeLite,
            	VMLShape,
            	VMLCircle,
            	VMLPath,
            	VMLRect,
            	VMLEllipse,
            	VMLGraphic,
                VMLPieSlice,
                _getClassName = Y.ClassNameManager.getClassName;
            
            function VMLDrawing() {}
            
            /**
             * <a href="http://www.w3.org/TR/NOTE-VML">VML</a> implementation of the <a href="Drawing.html">`Drawing`</a> class.
             * `VMLDrawing` is not intended to be used directly. Instead, use the <a href="Drawing.html">`Drawing`</a> class.
             * If the browser lacks <a href="http://www.w3.org/TR/SVG/">SVG</a> and <a href="http://www.w3.org/TR/html5/the-canvas-element.html">Canvas</a>
             * capabilities, the <a href="Drawing.html">`Drawing`</a> class will point to the `VMLDrawing` class.
             *
             * @module graphics
             * @class VMLDrawing
             * @constructor
             */
            VMLDrawing.prototype = {
                /**
                 * Maps path to methods
                 *
                 * @property _pathSymbolToMethod
                 * @type Object
                 * @private
                 */
                _pathSymbolToMethod: {
                    M: "moveTo",
                    m: "relativeMoveTo",
                    L: "lineTo",
                    l: "relativeLineTo",
                    C: "curveTo",
                    c: "relativeCurveTo",
                    Q: "quadraticCurveTo",
                    q: "relativeQuadraticCurveTo",
                    z: "closePath",
                    Z: "closePath"
                },
            
                /**
                 * Value for rounding up to coordsize
                 *
                 * @property _coordSpaceMultiplier
                 * @type Number
                 * @private
                 */
                _coordSpaceMultiplier: 100,
            
                /**
                 * Rounds dimensions and position values based on the coordinate space.
                 *
                 * @method _round
                 * @param {Number} The value for rounding
                 * @return Number
                 * @private
                 */
                _round:function(val)
                {
                    return Math.round(val * this._coordSpaceMultiplier);
                },
            
                /**
                 * Concatanates the path.
                 *
                 * @method _addToPath
                 * @param {String} val The value to add to the path string.
                 * @private
                 */
                _addToPath: function(val)
                {
                    this._path = this._path || "";
                    if(this._movePath)
                    {
                        this._path += this._movePath;
                        this._movePath = null;
                    }
                    this._path += val;
                },
            
                /**
                 * Current x position of the drawing.
                 *
                 * @property _currentX
                 * @type Number
                 * @private
                 */
                _currentX: 0,
            
                /**
                 * Current y position of the drqwing.
                 *
                 * @property _currentY
                 * @type Number
                 * @private
                 */
                _currentY: 0,
            
                /**
                 * Draws a bezier curve.
                 *
                 * @method curveTo
                 * @param {Number} cp1x x-coordinate for the first control point.
                 * @param {Number} cp1y y-coordinate for the first control point.
                 * @param {Number} cp2x x-coordinate for the second control point.
                 * @param {Number} cp2y y-coordinate for the second control point.
                 * @param {Number} x x-coordinate for the end point.
                 * @param {Number} y y-coordinate for the end point.
                 * @chainable
                 */
                curveTo: function() {
                    this._curveTo.apply(this, [Y.Array(arguments), false]);
                    return this;
                },
            
                /**
                 * Draws a bezier curve.
                 *
                 * @method relativeCurveTo
                 * @param {Number} cp1x x-coordinate for the first control point.
                 * @param {Number} cp1y y-coordinate for the first control point.
                 * @param {Number} cp2x x-coordinate for the second control point.
                 * @param {Number} cp2y y-coordinate for the second control point.
                 * @param {Number} x x-coordinate for the end point.
                 * @param {Number} y y-coordinate for the end point.
                 * @chainable
                 */
                relativeCurveTo: function() {
                    this._curveTo.apply(this, [Y.Array(arguments), true]);
                    return this;
                },
            
                /**
                 * Implements curveTo methods.
                 *
                 * @method _curveTo
                 * @param {Array} args The arguments to be used.
                 * @param {Boolean} relative Indicates whether or not to use relative coordinates.
                 * @private
                 */
                _curveTo: function(args, relative) {
                    var w,
                        h,
                        x,
                        y,
                        cp1x,
                        cp1y,
                        cp2x,
                        cp2y,
                        pts,
                        right,
                        left,
                        bottom,
                        top,
                        i,
                        len,
                        path,
                        command = relative ? " v " : " c ",
                        relativeX = relative ? parseFloat(this._currentX) : 0,
                        relativeY = relative ? parseFloat(this._currentY) : 0;
                    len = args.length - 5;
                    path = command;
                    for(i = 0; i < len; i = i + 6)
                    {
                        cp1x = parseFloat(args[i]);
                        cp1y = parseFloat(args[i + 1]);
                        cp2x = parseFloat(args[i + 2]);
                        cp2y = parseFloat(args[i + 3]);
                        x = parseFloat(args[i + 4]);
                        y = parseFloat(args[i + 5]);
                        if(i > 0)
                        {
                            path = path + ", ";
                        }
                        path = path +
                                this._round(cp1x) +
                                ", " +
                                this._round(cp1y) +
                                ", " +
                                this._round(cp2x) +
                                ", " +
                                this._round(cp2y) +
                                ", " +
                                this._round(x) +
                                ", " +
                                this._round(y);
                        cp1x = cp1x + relativeX;
                        cp1y = cp1y + relativeY;
                        cp2x = cp2x + relativeX;
                        cp2y = cp2y + relativeY;
                        x = x + relativeX;
                        y = y + relativeY;
                        right = Math.max(x, Math.max(cp1x, cp2x));
                        bottom = Math.max(y, Math.max(cp1y, cp2y));
                        left = Math.min(x, Math.min(cp1x, cp2x));
                        top = Math.min(y, Math.min(cp1y, cp2y));
                        w = Math.abs(right - left);
                        h = Math.abs(bottom - top);
                        pts = [[this._currentX, this._currentY] , [cp1x, cp1y], [cp2x, cp2y], [x, y]];
                        this._setCurveBoundingBox(pts, w, h);
                        this._currentX = x;
                        this._currentY = y;
                    }
                    this._addToPath(path);
                },
            
                /**
                 * Draws a quadratic bezier curve.
                 *
                 * @method quadraticCurveTo
                 * @param {Number} cpx x-coordinate for the control point.
                 * @param {Number} cpy y-coordinate for the control point.
                 * @param {Number} x x-coordinate for the end point.
                 * @param {Number} y y-coordinate for the end point.
                 * @chainable
                 */
                quadraticCurveTo: function() {
                    this._quadraticCurveTo.apply(this, [Y.Array(arguments), false]);
                    return this;
                },
            
                /**
                 * Draws a quadratic bezier curve relative to the current position.
                 *
                 * @method relativeQuadraticCurveTo
                 * @param {Number} cpx x-coordinate for the control point.
                 * @param {Number} cpy y-coordinate for the control point.
                 * @param {Number} x x-coordinate for the end point.
                 * @param {Number} y y-coordinate for the end point.
                 * @chainable
                 */
                relativeQuadraticCurveTo: function() {
                    this._quadraticCurveTo.apply(this, [Y.Array(arguments), true]);
                    return this;
                },
            
                /**
                 * Implements quadraticCurveTo methods.
                 *
                 * @method _quadraticCurveTo
                 * @param {Array} args The arguments to be used.
                 * @param {Boolean} relative Indicates whether or not to use relative coordinates.
                 * @private
                 */
                _quadraticCurveTo: function(args, relative) {
                    var cpx,
                        cpy,
                        cp1x,
                        cp1y,
                        cp2x,
                        cp2y,
                        x,
                        y,
                        currentX = this._currentX,
                        currentY = this._currentY,
                        i,
                        len = args.length - 3,
                        bezierArgs = [],
                        relativeX = relative ? parseFloat(this._currentX) : 0,
                        relativeY = relative ? parseFloat(this._currentY) : 0;
                    for(i = 0; i < len; i = i + 4)
                    {
                        cpx = parseFloat(args[i]) + relativeX;
                        cpy = parseFloat(args[i + 1]) + relativeY;
                        x = parseFloat(args[i + 2]) + relativeX;
                        y = parseFloat(args[i + 3]) + relativeY;
                        cp1x = currentX + 0.67*(cpx - currentX);
                        cp1y = currentY + 0.67*(cpy - currentY);
                        cp2x = cp1x + (x - currentX) * 0.34;
                        cp2y = cp1y + (y - currentY) * 0.34;
                        bezierArgs.push(cp1x);
                        bezierArgs.push(cp1y);
                        bezierArgs.push(cp2x);
                        bezierArgs.push(cp2y);
                        bezierArgs.push(x);
                        bezierArgs.push(y);
                    }
                    this._curveTo.apply(this, [bezierArgs, false]);
                },
            
                /**
                 * Draws a rectangle.
                 *
                 * @method drawRect
                 * @param {Number} x x-coordinate
                 * @param {Number} y y-coordinate
                 * @param {Number} w width
                 * @param {Number} h height
                 * @chainable
                 */
                drawRect: function(x, y, w, h) {
                    this.moveTo(x, y);
                    this.lineTo(x + w, y);
                    this.lineTo(x + w, y + h);
                    this.lineTo(x, y + h);
                    this.lineTo(x, y);
                    this._currentX = x;
                    this._currentY = y;
                    return this;
                },
            
                /**
                 * Draws a rectangle with rounded corners.
                 *
                 * @method drawRect
                 * @param {Number} x x-coordinate
                 * @param {Number} y y-coordinate
                 * @param {Number} w width
                 * @param {Number} h height
                 * @param {Number} ew width of the ellipse used to draw the rounded corners
                 * @param {Number} eh height of the ellipse used to draw the rounded corners
                 * @chainable
                 */
                drawRoundRect: function(x, y, w, h, ew, eh) {
                    this.moveTo(x, y + eh);
                    this.lineTo(x, y + h - eh);
                    this.quadraticCurveTo(x, y + h, x + ew, y + h);
                    this.lineTo(x + w - ew, y + h);
                    this.quadraticCurveTo(x + w, y + h, x + w, y + h - eh);
                    this.lineTo(x + w, y + eh);
                    this.quadraticCurveTo(x + w, y, x + w - ew, y);
                    this.lineTo(x + ew, y);
                    this.quadraticCurveTo(x, y, x, y + eh);
                    return this;
                },
            
                /**
                 * Draws a circle. Used internally by `CanvasCircle` class.
                 *
                 * @method drawCircle
                 * @param {Number} x y-coordinate
                 * @param {Number} y x-coordinate
                 * @param {Number} r radius
                 * @chainable
                 * @protected
                 */
            	drawCircle: function(x, y, radius) {
                    var startAngle = 0,
                        endAngle = 360,
                        circum = radius * 2;
            
                    endAngle *= 65535;
                    this._drawingComplete = false;
                    this._trackSize(x + circum, y + circum);
                    this.moveTo((x + circum), (y + radius));
                    this._addToPath(
                        " ae " +
                        this._round(x + radius) +
                        ", " +
                        this._round(y + radius) +
                        ", " +
                        this._round(radius) +
                        ", " +
                        this._round(radius) +
                        ", " +
                        startAngle +
                        ", " +
                        endAngle
                    );
                    return this;
                },
            
                /**
                 * Draws an ellipse.
                 *
                 * @method drawEllipse
                 * @param {Number} x x-coordinate
                 * @param {Number} y y-coordinate
                 * @param {Number} w width
                 * @param {Number} h height
                 * @chainable
                 * @protected
                 */
            	drawEllipse: function(x, y, w, h) {
                    var startAngle = 0,
                        endAngle = 360,
                        radius = w * 0.5,
                        yRadius = h * 0.5;
                    endAngle *= 65535;
                    this._drawingComplete = false;
                    this._trackSize(x + w, y + h);
                    this.moveTo((x + w), (y + yRadius));
                    this._addToPath(
                        " ae " +
                        this._round(x + radius) +
                        ", " +
                        this._round(x + radius) +
                        ", " +
                        this._round(y + yRadius) +
                        ", " +
                        this._round(radius) +
                        ", " +
                        this._round(yRadius) +
                        ", " +
                        startAngle +
                        ", " +
                        endAngle
                    );
                    return this;
                },
            
                /**
                 * Draws a diamond.
                 *
                 * @method drawDiamond
                 * @param {Number} x y-coordinate
                 * @param {Number} y x-coordinate
                 * @param {Number} width width
                 * @param {Number} height height
                 * @chainable
                 * @protected
                 */
                drawDiamond: function(x, y, width, height)
                {
                    var midWidth = width * 0.5,
                        midHeight = height * 0.5;
                    this.moveTo(x + midWidth, y);
                    this.lineTo(x + width, y + midHeight);
                    this.lineTo(x + midWidth, y + height);
                    this.lineTo(x, y + midHeight);
                    this.lineTo(x + midWidth, y);
                    return this;
                },
            
                /**
                 * Draws a wedge.
                 *
                 * @method drawWedge
                 * @param {Number} x x-coordinate of the wedge's center point
                 * @param {Number} y y-coordinate of the wedge's center point
                 * @param {Number} startAngle starting angle in degrees
                 * @param {Number} arc sweep of the wedge. Negative values draw clockwise.
                 * @param {Number} radius radius of wedge. If [optional] yRadius is defined, then radius is the x radius.
                 * @param {Number} yRadius [optional] y radius for wedge.
                 * @chainable
                 * @private
                 */
                drawWedge: function(x, y, startAngle, arc, radius)
                {
                    var diameter = radius * 2;
                    if(Math.abs(arc) > 360)
                    {
                        arc = 360;
                    }
                    this._currentX = x;
                    this._currentY = y;
                    startAngle *= -65535;
                    arc *= 65536;
                    startAngle = Math.round(startAngle);
                    arc = Math.round(arc);
                    this.moveTo(x, y);
                    this._addToPath(
                        " ae " +
                        this._round(x) +
                        ", " +
                        this._round(y) +
                        ", " +
                        this._round(radius) +
                        " " +
                        this._round(radius) +
                        ", " +
                        startAngle +
                        ", " +
                        arc
                    );
                    this._trackSize(diameter, diameter);
                    return this;
                },
            
                /**
                 * Draws a line segment from the current drawing position to the specified x and y coordinates.
                 *
                 * @method lineTo
                 * @param {Number} point1 x-coordinate for the end point.
                 * @param {Number} point2 y-coordinate for the end point.
                 * @chainable
                 */
                lineTo: function()
                {
                    this._lineTo.apply(this, [Y.Array(arguments), false]);
                    return this;
                },
            
                /**
                 * Draws a line segment using the current line style from the current drawing position to the relative x and y coordinates.
                 *
                 * @method relativeLineTo
                 * @param {Number} point1 x-coordinate for the end point.
                 * @param {Number} point2 y-coordinate for the end point.
                 * @chainable
                 */
                relativeLineTo: function()
                {
                    this._lineTo.apply(this, [Y.Array(arguments), true]);
                    return this;
                },
            
                /**
                 * Implements lineTo methods.
                 *
                 * @method _lineTo
                 * @param {Array} args The arguments to be used.
                 * @param {Boolean} relative Indicates whether or not to use relative coordinates.
                 * @private
                 */
                _lineTo: function(args, relative) {
                    var point1 = args[0],
                        i,
                        len,
                        x,
                        y,
                        path = relative ? " r " : " l ",
                        relativeX = relative ? parseFloat(this._currentX) : 0,
                        relativeY = relative ? parseFloat(this._currentY) : 0;
                    if (typeof point1 === "string" || typeof point1 === "number") {
                        len = args.length - 1;
                        for (i = 0; i < len; i = i + 2) {
                            x = parseFloat(args[i]);
                            y = parseFloat(args[i + 1]);
                            path += ' ' + this._round(x) + ', ' + this._round(y);
                            x = x + relativeX;
                            y = y + relativeY;
                            this._currentX = x;
                            this._currentY = y;
                            this._trackSize.apply(this, [x, y]);
                        }
                    }
                    else
                    {
                        len = args.length;
                        for (i = 0; i < len; i = i + 1) {
                            x = parseFloat(args[i][0]);
                            y = parseFloat(args[i][1]);
                            path += ' ' + this._round(x) + ', ' + this._round(y);
                            x = x + relativeX;
                            y = y + relativeY;
                            this._currentX = x;
                            this._currentY = y;
                            this._trackSize.apply(this, [x, y]);
                        }
                    }
                    this._addToPath(path);
                    return this;
                },
            
                /**
                 * Moves the current drawing position to specified x and y coordinates.
                 *
                 * @method moveTo
                 * @param {Number} x x-coordinate for the end point.
                 * @param {Number} y y-coordinate for the end point.
                 * @chainable
                 */
                moveTo: function()
                {
                    this._moveTo.apply(this, [Y.Array(arguments), false]);
                    return this;
                },
            
                /**
                 * Moves the current drawing position relative to specified x and y coordinates.
                 *
                 * @method relativeMoveTo
                 * @param {Number} x x-coordinate for the end point.
                 * @param {Number} y y-coordinate for the end point.
                 * @chainable
                 */
                relativeMoveTo: function()
                {
                    this._moveTo.apply(this, [Y.Array(arguments), true]);
                    return this;
                },
            
                /**
                 * Implements moveTo methods.
                 *
                 * @method _moveTo
                 * @param {Array} args The arguments to be used.
                 * @param {Boolean} relative Indicates whether or not to use relative coordinates.
                 * @private
                 */
                _moveTo: function(args, relative) {
                    var x = parseFloat(args[0]),
                        y = parseFloat(args[1]),
                        command = relative ? " t " : " m ",
                        relativeX = relative ? parseFloat(this._currentX) : 0,
                        relativeY = relative ? parseFloat(this._currentY) : 0;
                    this._movePath = command + this._round(x) + ", " + this._round(y);
                    x = x + relativeX;
                    y = y + relativeY;
                    this._trackSize(x, y);
                    this._currentX = x;
                    this._currentY = y;
                },
            
                /**
                 * Draws the graphic.
                 *
                 * @method _draw
                 * @private
                 */
                _closePath: function()
                {
                    var fill = this.get("fill"),
                        stroke = this.get("stroke"),
                        node = this.node,
                        w = this.get("width"),
                        h = this.get("height"),
                        path = this._path,
                        pathEnd = "",
                        multiplier = this._coordSpaceMultiplier;
                    this._fillChangeHandler();
                    this._strokeChangeHandler();
                    if(path)
                    {
                        if(fill && fill.color)
                        {
                            pathEnd += ' x';
                        }
                        if(stroke)
                        {
                            pathEnd += ' e';
                        }
                    }
                    if(path)
                    {
                        node.path = path + pathEnd;
                    }
                    if(!isNaN(w) && !isNaN(h))
                    {
                        node.coordOrigin = this._left + ", " + this._top;
                        node.coordSize = (w * multiplier) + ", " + (h * multiplier);
                        node.style.position = "absolute";
                        node.style.width =  w + "px";
                        node.style.height =  h + "px";
                    }
                    this._path = path;
                    this._movePath = null;
                    this._updateTransform();
                },
            
                /**
                 * Completes a drawing operation.
                 *
                 * @method end
                 * @chainable
                 */
                end: function()
                {
                    this._closePath();
                    return this;
                },
            
                /**
                 * Ends a fill and stroke
                 *
                 * @method closePath
                 * @chainable
                 */
                closePath: function()
                {
                    this._addToPath(" x e");
                    return this;
                },
            
                /**
                 * Clears the path.
                 *
                 * @method clear
                 * @chainable
                 */
                clear: function()
                {
            		this._right = 0;
                    this._bottom = 0;
                    this._width = 0;
                    this._height = 0;
                    this._left = 0;
                    this._top = 0;
                    this._path = "";
                    this._movePath = null;
                    return this;
                },
            
                /**
                 * Returns the points on a curve
                 *
                 * @method getBezierData
                 * @param Array points Array containing the begin, end and control points of a curve.
                 * @param Number t The value for incrementing the next set of points.
                 * @return Array
                 * @private
                 */
                getBezierData: function(points, t) {
                    var n = points.length,
                        tmp = [],
                        i,
                        j;
            
                    for (i = 0; i < n; ++i){
                        tmp[i] = [points[i][0], points[i][1]]; // save input
                    }
            
                    for (j = 1; j < n; ++j) {
                        for (i = 0; i < n - j; ++i) {
                            tmp[i][0] = (1 - t) * tmp[i][0] + t * tmp[parseInt(i + 1, 10)][0];
                            tmp[i][1] = (1 - t) * tmp[i][1] + t * tmp[parseInt(i + 1, 10)][1];
                        }
                    }
                    return [ tmp[0][0], tmp[0][1] ];
                },
            
                /**
                 * Calculates the bounding box for a curve
                 *
                 * @method _setCurveBoundingBox
                 * @param Array pts Array containing points for start, end and control points of a curve.
                 * @param Number w Width used to calculate the number of points to describe the curve.
                 * @param Number h Height used to calculate the number of points to describe the curve.
                 * @private
                 */
                _setCurveBoundingBox: function(pts, w, h)
                {
                    var i,
                        left = this._currentX,
                        right = left,
                        top = this._currentY,
                        bottom = top,
                        len = Math.round(Math.sqrt((w * w) + (h * h))),
                        t = 1/len,
                        xy;
                    for(i = 0; i < len; ++i)
                    {
                        xy = this.getBezierData(pts, t * i);
                        left = isNaN(left) ? xy[0] : Math.min(xy[0], left);
                        right = isNaN(right) ? xy[0] : Math.max(xy[0], right);
                        top = isNaN(top) ? xy[1] : Math.min(xy[1], top);
                        bottom = isNaN(bottom) ? xy[1] : Math.max(xy[1], bottom);
                    }
                    left = Math.round(left * 10)/10;
                    right = Math.round(right * 10)/10;
                    top = Math.round(top * 10)/10;
                    bottom = Math.round(bottom * 10)/10;
                    this._trackSize(right, bottom);
                    this._trackSize(left, top);
                },
            
                /**
                 * Updates the size of the graphics object
                 *
                 * @method _trackSize
                 * @param {Number} w width
                 * @param {Number} h height
                 * @private
                 */
                _trackSize: function(w, h) {
                    if (w > this._right) {
                        this._right = w;
                    }
                    if(w < this._left)
                    {
                        this._left = w;
                    }
                    if (h < this._top)
                    {
                        this._top = h;
                    }
                    if (h > this._bottom)
                    {
                        this._bottom = h;
                    }
                    this._width = this._right - this._left;
                    this._height = this._bottom - this._top;
                },
            
                _left: 0,
            
                _right: 0,
            
                _top: 0,
            
                _bottom: 0,
            
                _width: 0,
            
                _height: 0
            };
            Y.VMLDrawing = VMLDrawing;