1 // ┌─────────────────────────────────────────────────────────────────────┐ \\
2 // │ "Raphaël 2.0.1" - JavaScript Vector Library │ \\
3 // ├─────────────────────────────────────────────────────────────────────┤ \\
4 // │ Copyright (c) 2008-2011 Dmitry Baranovskiy (http://raphaeljs.com) │ \\
5 // │ Copyright (c) 2008-2011 Sencha Labs (http://sencha.com) │ \\
6 // │ Licensed under the MIT (http://raphaeljs.com/license.html) license. │ \\
7 // └─────────────────────────────────────────────────────────────────────┘ \\
13 * Creates a canvas object on which to draw.
14 * You must do this first, as all future calls to drawing methods
15 * from this instance will be bound to this canvas.
18 - container (HTMLElement|string) DOM element or its ID which is going to be a parent for drawing surface
21 - callback (function) #optional callback function which is going to be executed in the context of newly created paper
27 - callback (function) #optional callback function which is going to be executed in the context of newly created paper
29 - all (array) (first 3 or 4 elements in the array are equal to [containerID, width, height] or [x, y, width, height]. The rest are element descriptions in format {type: type, <attributes>}). See @Paper.add.
30 - callback (function) #optional callback function which is going to be executed in the context of newly created paper
32 - onReadyCallback (function) function that is going to be called on DOM ready event. You can also subscribe to this event via Eve’s “DOMLoad” event. In this case method returns `undefined`.
35 | // Each of the following examples create a canvas
36 | // that is 320px wide by 200px high.
37 | // Canvas is created at the viewport’s 10,50 coordinate.
38 | var paper = Raphael(10, 50, 320, 200);
39 | // Canvas is created at the top left corner of the #notepad element
40 | // (or its top right corner in dir="rtl" elements)
41 | var paper = Raphael(document.getElementById("notepad"), 320, 200);
43 | var paper = Raphael("notepad", 320, 200);
45 | var set = Raphael(["notepad", 320, 200, {
60 if (R.is(first, "function")) {
61 return loaded ? first() : eve.on("DOMload", first);
62 } else if (R.is(first, array)) {
63 return R._engine.create[apply](R, first.splice(0, 3 + R.is(first[0], nu))).add(first);
65 var args = Array.prototype.slice.call(arguments, 0);
66 if (R.is(args[args.length - 1], "function")) {
68 return loaded ? f.call(R._engine.create[apply](R, args)) : eve.on("DOMload", function () {
69 f.call(R._engine.create[apply](R, args));
72 return R._engine.create[apply](R, arguments);
80 elements = {circle: 1, rect: 1, path: 1, ellipse: 1, text: 1, image: 1},
81 formatrg = /\{(\d+)\}/g,
83 has = "hasOwnProperty",
89 was: Object.prototype[has].call(g.win, "Raphael"),
97 * Shortcut for @Paper.customAttributes
100 * Paper.customAttributes
101 [ property (object) ]
103 * If you have a set of attributes that you would like to represent
104 * as a function of some number you can do it easily with custom attributes:
106 | paper.customAttributes.hue = function (num) {
108 | return {fill: "hsb(" + num + ", 0.75, 1)"};
110 | // Custom attribute “hue” will change fill
111 | // to be given hue with fixed saturation and brightness.
112 | // Now you can use it like this:
113 | var c = paper.circle(10, 10, 10).attr({hue: .45});
114 | // or even like this:
115 | c.animate({hue: 1}, 1e3);
117 | // You could also create custom attribute
118 | // with multiple parameters:
119 | paper.customAttributes.hsb = function (h, s, b) {
120 | return {fill: "hsb(" + [h, s, b].join(",") + ")"};
122 | c.attr({hsb: "0.5 .8 1"});
123 | c.animate({hsb: [1, 0, 0.5]}, 1e3);
125 this.ca = this.customAttributes = {};
128 appendChild = "appendChild",
131 supportsTouch = "createTouch" in g.doc,
136 events = "click dblclick mousedown mousemove mouseout mouseover mouseup touchstart touchmove touchend touchcancel"[split](S),
138 mousedown: "touchstart",
139 mousemove: "touchmove",
142 lowerCase = Str.prototype.toLowerCase,
152 toString = "toString",
154 objectToString = Object.prototype.toString,
157 ISURL = R._ISURL = /^url\(['"]?([^\)]+?)['"]?\)$/i,
158 colourRegExp = /^\s*((#[a-f\d]{6})|(#[a-f\d]{3})|rgba?\(\s*([\d\.]+%?\s*,\s*[\d\.]+%?\s*,\s*[\d\.]+%?(?:\s*,\s*[\d\.]+%?)?)\s*\)|hsba?\(\s*([\d\.]+(?:deg|\xb0|%)?\s*,\s*[\d\.]+%?\s*,\s*[\d\.]+(?:%?\s*,\s*[\d\.]+)?)%?\s*\)|hsla?\(\s*([\d\.]+(?:deg|\xb0|%)?\s*,\s*[\d\.]+%?\s*,\s*[\d\.]+(?:%?\s*,\s*[\d\.]+)?)%?\s*\))\s*$/i,
159 isnan = {"NaN": 1, "Infinity": 1, "-Infinity": 1},
160 bezierrg = /^(?:cubic-)?bezier\(([^,]+),([^,]+),([^,]+),([^\)]+)\)/,
162 setAttribute = "setAttribute",
163 toFloat = parseFloat,
165 upperCase = Str.prototype.toUpperCase,
166 availableAttrs = R._availableAttrs = {
168 "arrow-start": "none",
170 "clip-rect": "0 0 1e9 1e9",
176 font: '10px "Arial"',
177 "font-family": '"Arial"',
179 "font-style": "normal",
183 href: "http://raphaeljs.com/",
192 "stroke-dasharray": "",
193 "stroke-linecap": "butt",
194 "stroke-linejoin": "butt",
195 "stroke-miterlimit": 0,
199 "text-anchor": "middle",
206 availableAnimAttrs = R._availableAnimAttrs = {
221 "stroke-opacity": nu,
223 transform: "transform",
228 commaSpaces = /\s*,\s*/,
229 hsrg = {hs: 1, rg: 1},
230 p2s = /,?([achlmqrstvxz]),?/gi,
231 pathCommand = /([achlmrqstvz])[\s,]*((-?\d*\.?\d*(?:e[\-+]?\d+)?\s*,?\s*)+)/ig,
232 tCommand = /([rstm])[\s,]*((-?\d*\.?\d*(?:e[\-+]?\d+)?\s*,?\s*)+)/ig,
233 pathValues = /(-?\d*\.?\d*(?:e[\-+]?\d+)?)\s*,?\s*/ig,
234 radial_gradient = R._radial_gradient = /^r(?:\(([^,]+?)\s*,\s*([^\)]+?)\))?/,
236 sortByKey = function (a, b) {
237 return a.key - b.key;
239 sortByNumber = function (a, b) {
240 return toFloat(a) - toFloat(b);
242 fun = function () {},
243 pipe = function (x) {
246 rectPath = R._rectPath = function (x, y, w, h, r) {
248 return [["M", x + r, y], ["l", w - r * 2, 0], ["a", r, r, 0, 0, 1, r, r], ["l", 0, h - r * 2], ["a", r, r, 0, 0, 1, -r, r], ["l", r * 2 - w, 0], ["a", r, r, 0, 0, 1, -r, -r], ["l", 0, r * 2 - h], ["a", r, r, 0, 0, 1, r, -r], ["z"]];
250 return [["M", x, y], ["l", w, 0], ["l", 0, h], ["l", -w, 0], ["z"]];
252 ellipsePath = function (x, y, rx, ry) {
256 return [["M", x, y], ["m", 0, -ry], ["a", rx, ry, 0, 1, 1, 0, 2 * ry], ["a", rx, ry, 0, 1, 1, 0, -2 * ry], ["z"]];
258 getPath = R._getPath = {
259 path: function (el) {
260 return el.attr("path");
262 circle: function (el) {
264 return ellipsePath(a.cx, a.cy, a.r);
266 ellipse: function (el) {
268 return ellipsePath(a.cx, a.cy, a.rx, a.ry);
270 rect: function (el) {
272 return rectPath(a.x, a.y, a.width, a.height, a.r);
274 image: function (el) {
276 return rectPath(a.x, a.y, a.width, a.height);
278 text: function (el) {
279 var bbox = el._getBBox();
280 return rectPath(bbox.x, bbox.y, bbox.width, bbox.height);
283 mapPath = R.mapPath = function (path, matrix) {
287 var x, y, i, j, ii, jj, pathi;
288 path = path2curve(path);
289 for (i = 0, ii = path.length; i < ii; i++) {
291 for (j = 1, jj = pathi.length; j < jj; j += 2) {
292 x = matrix.x(pathi[j], pathi[j + 1]);
293 y = matrix.y(pathi[j], pathi[j + 1]);
304 [ property (string) ]
306 * Can be “SVG”, “VML” or empty, depending on browser support.
308 R.type = (g.win.SVGAngle || g.doc.implementation.hasFeature("http://www.w3.org/TR/SVG11/feature#BasicStructure", "1.1") ? "SVG" : "VML");
309 if (R.type == "VML") {
310 var d = g.doc.createElement("div"),
312 d.innerHTML = '<v:shape adj="1"/>';
314 b.style.behavior = "url(#default#VML)";
315 if (!(b && typeof b.adj == "object")) {
322 [ property (boolean) ]
324 * `true` if browser supports SVG.
328 [ property (boolean) ]
330 * `true` if browser supports VML.
332 R.svg = !(R.vml = R.type == "VML");
336 [ property (object) ]
338 * You can add your own method to the canvas. For example if you want to draw a pie chart,
339 * you can create your own pie chart function and ship it as a Raphaël plugin. To do this
340 * you need to extend the `Raphael.fn` object. You should modify the `fn` object before a
341 * Raphaël instance is created, otherwise it will take no effect. Please note that the
342 * ability for namespaced plugins was removed in Raphael 2.0. It is up to the plugin to
343 * ensure any namespacing ensures proper context.
345 | Raphael.fn.arrow = function (x1, y1, x2, y2, size) {
346 | return this.path( ... );
348 | // or create namespace
349 | Raphael.fn.mystuff = {
350 | arrow: function () {…},
351 | star: function () {…},
354 | var paper = Raphael(10, 10, 630, 480);
356 | paper.arrow(10, 10, 30, 30, 5).attr({fill: "#f00"});
357 | paper.mystuff.arrow();
358 | paper.mystuff.star();
360 R.fn = paperproto = Paper.prototype = R.prototype;
367 * Handfull replacement for `typeof` operator.
369 - o (…) any object or primitive
370 - type (string) name of the type, i.e. “string”, “function”, “number”, etc.
371 = (boolean) is given value is of given type
373 R.is = function (o, type) {
374 type = lowerCase.call(type);
375 if (type == "finite") {
376 return !isnan[has](+o);
378 if (type == "array") {
379 return o instanceof Array;
381 return (type == "null" && o === null) ||
382 (type == typeof o && o !== null) ||
383 (type == "object" && o === Object(o)) ||
384 (type == "array" && Array.isArray && Array.isArray(o)) ||
385 objectToString.call(o).slice(8, -1).toLowerCase() == type;
391 * Returns angle between two or three points
393 - x1 (number) x coord of first point
394 - y1 (number) y coord of first point
395 - x2 (number) x coord of second point
396 - y2 (number) y coord of second point
397 - x3 (number) #optional x coord of third point
398 - y3 (number) #optional y coord of third point
399 = (number) angle in degrees.
401 R.angle = function (x1, y1, x2, y2, x3, y3) {
408 return (180 + math.atan2(-y, -x) * 180 / PI + 360) % 360;
410 return R.angle(x1, y1, x3, y3) - R.angle(x2, y2, x3, y3);
417 * Transform angle to radians
419 - deg (number) angle in degrees
420 = (number) angle in radians.
422 R.rad = function (deg) {
423 return deg % 360 * PI / 180;
429 * Transform angle to degrees
431 - deg (number) angle in radians
432 = (number) angle in degrees.
434 R.deg = function (rad) {
435 return rad * 180 / PI % 360;
441 * Snaps given value to given grid.
443 - values (array|number) given array of values or step of the grid
444 - value (number) value to adjust
445 - tolerance (number) #optional tolerance for snapping. Default is `10`.
446 = (number) adjusted value.
448 R.snapTo = function (values, value, tolerance) {
449 tolerance = R.is(tolerance, "finite") ? tolerance : 10;
450 if (R.is(values, array)) {
451 var i = values.length;
452 while (i--) if (abs(values[i] - value) <= tolerance) {
457 var rem = value % values;
458 if (rem < tolerance) {
461 if (rem > values - tolerance) {
462 return value - rem + values;
472 * Returns RFC4122, version 4 ID
474 var createUUID = R.createUUID = (function (uuidRegEx, uuidReplacer) {
476 return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(uuidRegEx, uuidReplacer).toUpperCase();
478 })(/[xy]/g, function (c) {
479 var r = math.random() * 16 | 0,
480 v = c == "x" ? r : (r & 3 | 8);
481 return v.toString(16);
488 * Used when you need to draw in `<iframe>`. Switched window to the iframe one.
490 - newwin (window) new window object
492 R.setWindow = function (newwin) {
493 eve("setWindow", R, g.win, newwin);
495 g.doc = g.win.document;
496 if (R._engine.initWin) {
497 R._engine.initWin(g.win);
500 var toHex = function (color) {
502 // http://dean.edwards.name/weblog/2009/10/convert-any-colour-value-to-hex-in-msie/
503 var trim = /^\s+|\s+$/g;
506 var docum = new ActiveXObject("htmlfile");
507 docum.write("<body>");
511 bod = createPopup().document.body;
513 var range = bod.createTextRange();
514 toHex = cacher(function (color) {
516 bod.style.color = Str(color).replace(trim, E);
517 var value = range.queryCommandValue("ForeColor");
518 value = ((value & 255) << 16) | (value & 65280) | ((value & 16711680) >>> 16);
519 return "#" + ("000000" + value.toString(16)).slice(-6);
525 var i = g.doc.createElement("i");
526 i.title = "Rapha\xebl Colour Picker";
527 i.style.display = "none";
528 g.doc.body.appendChild(i);
529 toHex = cacher(function (color) {
530 i.style.color = color;
531 return g.doc.defaultView.getComputedStyle(i, E).getPropertyValue("color");
536 hsbtoString = function () {
537 return "hsb(" + [this.h, this.s, this.b] + ")";
539 hsltoString = function () {
540 return "hsl(" + [this.h, this.s, this.l] + ")";
542 rgbtoString = function () {
545 prepareRGB = function (r, g, b) {
546 if (g == null && R.is(r, "object") && "r" in r && "g" in r && "b" in r) {
551 if (g == null && R.is(r, string)) {
552 var clr = R.getRGB(r);
557 if (r > 1 || g > 1 || b > 1) {
565 packageRGB = function (r, g, b, o) {
574 toString: rgbtoString
576 R.is(o, "finite") && (rgb.opacity = o);
584 * Parses the color string and returns object with all values for the given color.
586 - clr (string) color string in one of the supported formats (see @Raphael.getRGB)
587 = (object) Combined RGB & HSB object in format:
592 o hex (string) color in HTML/CSS format: #••••••,
593 o error (boolean) `true` if string can’t be parsed,
595 o s (number) saturation,
596 o v (number) value (brightness),
597 o l (number) lightness
600 R.color = function (clr) {
602 if (R.is(clr, "object") && "h" in clr && "s" in clr && "b" in clr) {
603 rgb = R.hsb2rgb(clr);
608 } else if (R.is(clr, "object") && "h" in clr && "s" in clr && "l" in clr) {
609 rgb = R.hsl2rgb(clr);
615 if (R.is(clr, "string")) {
618 if (R.is(clr, "object") && "r" in clr && "g" in clr && "b" in clr) {
619 rgb = R.rgb2hsl(clr);
623 rgb = R.rgb2hsb(clr);
627 clr.r = clr.g = clr.b = clr.h = clr.s = clr.v = clr.l = -1;
630 clr.toString = rgbtoString;
637 * Converts HSB values to RGB object.
640 - s (number) saturation
641 - v (number) value or brightness
642 = (object) RGB object in format:
647 o hex (string) color in HTML/CSS format: #••••••
650 R.hsb2rgb = function (h, s, v, o) {
651 if (this.is(h, "object") && "h" in h && "s" in h && "b" in h) {
661 X = C * (1 - abs(h % 2 - 1));
665 R += [C, X, 0, 0, X, C][h];
666 G += [X, C, C, X, 0, 0][h];
667 B += [0, 0, X, C, C, X][h];
668 return packageRGB(R, G, B, o);
674 * Converts HSL values to RGB object.
677 - s (number) saturation
678 - l (number) luminosity
679 = (object) RGB object in format:
684 o hex (string) color in HTML/CSS format: #••••••
687 R.hsl2rgb = function (h, s, l, o) {
688 if (this.is(h, "object") && "h" in h && "s" in h && "l" in h) {
693 if (h > 1 || s > 1 || l > 1) {
701 C = 2 * s * (l < .5 ? l : 1 - l);
702 X = C * (1 - abs(h % 2 - 1));
703 R = G = B = l - C / 2;
706 R += [C, X, 0, 0, X, C][h];
707 G += [X, C, C, X, 0, 0][h];
708 B += [0, 0, X, C, C, X][h];
709 return packageRGB(R, G, B, o);
715 * Converts RGB values to HSB object.
720 = (object) HSB object in format:
723 o s (number) saturation
724 o b (number) brightness
727 R.rgb2hsb = function (r, g, b) {
728 b = prepareRGB(r, g, b);
735 C = V - mmin(r, g, b);
737 V == r ? (g - b) / C :
738 V == g ? (b - r) / C + 2 :
741 H = ((H + 360) % 6) * 60 / 360;
742 S = C == 0 ? 0 : C / V;
743 return {h: H, s: S, b: V, toString: hsbtoString};
749 * Converts RGB values to HSL object.
754 = (object) HSL object in format:
757 o s (number) saturation
758 o l (number) luminosity
761 R.rgb2hsl = function (r, g, b) {
762 b = prepareRGB(r, g, b);
767 var H, S, L, M, m, C;
772 M == r ? (g - b) / C :
773 M == g ? (b - r) / C + 2 :
775 H = ((H + 360) % 6) * 60 / 360;
778 L < .5 ? C / (2 * L) :
780 return {h: H, s: S, l: L, toString: hsltoString};
782 R._path2string = function () {
783 return this.join(",").replace(p2s, "$1");
785 function repush(array, item) {
786 for (var i = 0, ii = array.length; i < ii; i++) if (array[i] === item) {
787 return array.push(array.splice(i, 1)[0]);
790 function cacher(f, scope, postprocessor) {
792 var arg = Array.prototype.slice.call(arguments, 0),
793 args = arg.join("\u2400"),
794 cache = newf.cache = newf.cache || {},
795 count = newf.count = newf.count || [];
796 if (cache[has](args)) {
798 return postprocessor ? postprocessor(cache[args]) : cache[args];
800 count.length >= 1e3 && delete cache[count.shift()];
802 cache[args] = f[apply](scope, arg);
803 return postprocessor ? postprocessor(cache[args]) : cache[args];
808 var preload = R._preload = function (src, f) {
809 var img = g.doc.createElement("img");
810 img.style.cssText = "position:absolute;left:-9999em;top:-9999em";
811 img.onload = function () {
814 g.doc.body.removeChild(this);
816 img.onerror = function () {
817 g.doc.body.removeChild(this);
819 g.doc.body.appendChild(img);
823 function clrToString() {
831 * Parses colour string as RGB object
833 - colour (string) colour string in one of formats:
835 # <li>Colour name (“<code>red</code>”, “<code>green</code>”, “<code>cornflowerblue</code>”, etc)</li>
836 # <li>#••• — shortened HTML colour: (“<code>#000</code>”, “<code>#fc0</code>”, etc)</li>
837 # <li>#•••••• — full length HTML colour: (“<code>#000000</code>”, “<code>#bd2300</code>”)</li>
838 # <li>rgb(•••, •••, •••) — red, green and blue channels’ values: (“<code>rgb(200, 100, 0)</code>”)</li>
839 # <li>rgb(•••%, •••%, •••%) — same as above, but in %: (“<code>rgb(100%, 175%, 0%)</code>”)</li>
840 # <li>hsb(•••, •••, •••) — hue, saturation and brightness values: (“<code>hsb(0.5, 0.25, 1)</code>”)</li>
841 # <li>hsb(•••%, •••%, •••%) — same as above, but in %</li>
842 # <li>hsl(•••, •••, •••) — same as hsb</li>
843 # <li>hsl(•••%, •••%, •••%) — same as hsb</li>
845 = (object) RGB object in format:
850 o hex (string) color in HTML/CSS format: #••••••,
851 o error (boolean) true if string can’t be parsed
854 R.getRGB = cacher(function (colour) {
855 if (!colour || !!((colour = Str(colour)).indexOf("-") + 1)) {
856 return {r: -1, g: -1, b: -1, hex: "none", error: 1, toString: clrToString};
858 if (colour == "none") {
859 return {r: -1, g: -1, b: -1, hex: "none", toString: clrToString};
861 !(hsrg[has](colour.toLowerCase().substring(0, 2)) || colour.charAt() == "#") && (colour = toHex(colour));
869 rgb = colour.match(colourRegExp);
872 blue = toInt(rgb[2].substring(5), 16);
873 green = toInt(rgb[2].substring(3, 5), 16);
874 red = toInt(rgb[2].substring(1, 3), 16);
877 blue = toInt((t = rgb[3].charAt(3)) + t, 16);
878 green = toInt((t = rgb[3].charAt(2)) + t, 16);
879 red = toInt((t = rgb[3].charAt(1)) + t, 16);
882 values = rgb[4][split](commaSpaces);
883 red = toFloat(values[0]);
884 values[0].slice(-1) == "%" && (red *= 2.55);
885 green = toFloat(values[1]);
886 values[1].slice(-1) == "%" && (green *= 2.55);
887 blue = toFloat(values[2]);
888 values[2].slice(-1) == "%" && (blue *= 2.55);
889 rgb[1].toLowerCase().slice(0, 4) == "rgba" && (opacity = toFloat(values[3]));
890 values[3] && values[3].slice(-1) == "%" && (opacity /= 100);
893 values = rgb[5][split](commaSpaces);
894 red = toFloat(values[0]);
895 values[0].slice(-1) == "%" && (red *= 2.55);
896 green = toFloat(values[1]);
897 values[1].slice(-1) == "%" && (green *= 2.55);
898 blue = toFloat(values[2]);
899 values[2].slice(-1) == "%" && (blue *= 2.55);
900 (values[0].slice(-3) == "deg" || values[0].slice(-1) == "\xb0") && (red /= 360);
901 rgb[1].toLowerCase().slice(0, 4) == "hsba" && (opacity = toFloat(values[3]));
902 values[3] && values[3].slice(-1) == "%" && (opacity /= 100);
903 return R.hsb2rgb(red, green, blue, opacity);
906 values = rgb[6][split](commaSpaces);
907 red = toFloat(values[0]);
908 values[0].slice(-1) == "%" && (red *= 2.55);
909 green = toFloat(values[1]);
910 values[1].slice(-1) == "%" && (green *= 2.55);
911 blue = toFloat(values[2]);
912 values[2].slice(-1) == "%" && (blue *= 2.55);
913 (values[0].slice(-3) == "deg" || values[0].slice(-1) == "\xb0") && (red /= 360);
914 rgb[1].toLowerCase().slice(0, 4) == "hsla" && (opacity = toFloat(values[3]));
915 values[3] && values[3].slice(-1) == "%" && (opacity /= 100);
916 return R.hsl2rgb(red, green, blue, opacity);
918 rgb = {r: red, g: green, b: blue, toString: clrToString};
919 rgb.hex = "#" + (16777216 | blue | (green << 8) | (red << 16)).toString(16).slice(1);
920 R.is(opacity, "finite") && (rgb.opacity = opacity);
923 return {r: -1, g: -1, b: -1, hex: "none", error: 1, toString: clrToString};
929 * Converts HSB values to hex representation of the colour.
932 - s (number) saturation
933 - b (number) value or brightness
934 = (string) hex representation of the colour.
936 R.hsb = cacher(function (h, s, b) {
937 return R.hsb2rgb(h, s, b).hex;
943 * Converts HSL values to hex representation of the colour.
946 - s (number) saturation
947 - l (number) luminosity
948 = (string) hex representation of the colour.
950 R.hsl = cacher(function (h, s, l) {
951 return R.hsl2rgb(h, s, l).hex;
957 * Converts RGB values to hex representation of the colour.
962 = (string) hex representation of the colour.
964 R.rgb = cacher(function (r, g, b) {
965 return "#" + (16777216 | b | (g << 8) | (r << 16)).toString(16).slice(1);
971 * On each call returns next colour in the spectrum. To reset it back to red call @Raphael.getColor.reset
973 - value (number) #optional brightness, default is `0.75`
974 = (string) hex representation of the colour.
976 R.getColor = function (value) {
977 var start = this.getColor.start = this.getColor.start || {h: 0, s: 1, b: value || .75},
978 rgb = this.hsb2rgb(start.h, start.s, start.b);
983 start.s <= 0 && (this.getColor.start = {h: 0, s: 1, b: start.b});
988 * Raphael.getColor.reset
991 * Resets spectrum position for @Raphael.getColor back to red.
993 R.getColor.reset = function () {
997 // http://schepers.cc/getting-to-the-point
998 function catmullRom2bezier(crp) {
1000 for (var i = 0, iLen = crp.length; iLen - 2 > i; i += 2) {
1001 var p = [{x: +crp[i], y: +crp[i + 1]},
1002 {x: +crp[i], y: +crp[i + 1]},
1003 {x: +crp[i + 2], y: +crp[i + 3]},
1004 {x: +crp[i + 4], y: +crp[i + 5]}];
1005 if (iLen - 4 == i) {
1006 p[0] = {x: +crp[i - 2], y: +crp[i - 1]};
1009 p[0] = {x: +crp[i - 2], y: +crp[i - 1]};
1012 (-p[0].x + 6 * p[1].x + p[2].x) / 6,
1013 (-p[0].y + 6 * p[1].y + p[2].y) / 6,
1014 (p[1].x + 6 * p[2].x - p[3].x) / 6,
1015 (p[1].y + 6*p[2].y - p[3].y) / 6,
1024 * Raphael.parsePathString
1029 * Parses given path string into an array of arrays of path segments.
1031 - pathString (string|array) path string or array of segments (in the last case it will be returned straight away)
1032 = (array) array of segments.
1034 R.parsePathString = cacher(function (pathString) {
1038 var paramCounts = {a: 7, c: 6, h: 1, l: 2, m: 2, r: 4, q: 4, s: 4, t: 2, v: 1, z: 0},
1040 if (R.is(pathString, array) && R.is(pathString[0], array)) { // rough assumption
1041 data = pathClone(pathString);
1044 Str(pathString).replace(pathCommand, function (a, b, c) {
1046 name = b.toLowerCase();
1047 c.replace(pathValues, function (a, b) {
1048 b && params.push(+b);
1050 if (name == "m" && params.length > 2) {
1051 data.push([b][concat](params.splice(0, 2)));
1053 b = b == "m" ? "l" : "L";
1056 data.push([b][concat](params));
1057 } else while (params.length >= paramCounts[name]) {
1058 data.push([b][concat](params.splice(0, paramCounts[name])));
1059 if (!paramCounts[name]) {
1065 data.toString = R._path2string;
1069 * Raphael.parseTransformString
1074 * Parses given path string into an array of transformations.
1076 - TString (string|array) transform string or array of transformations (in the last case it will be returned straight away)
1077 = (array) array of transformations.
1079 R.parseTransformString = cacher(function (TString) {
1083 var paramCounts = {r: 3, s: 4, t: 2, m: 6},
1085 if (R.is(TString, array) && R.is(TString[0], array)) { // rough assumption
1086 data = pathClone(TString);
1089 Str(TString).replace(tCommand, function (a, b, c) {
1091 name = lowerCase.call(b);
1092 c.replace(pathValues, function (a, b) {
1093 b && params.push(+b);
1095 data.push([b][concat](params));
1098 data.toString = R._path2string;
1102 * Raphael.findDotsAtSegment
1107 * Find dot coordinates on the given cubic bezier curve at the given t.
1109 - p1x (number) x of the first point of the curve
1110 - p1y (number) y of the first point of the curve
1111 - c1x (number) x of the first anchor of the curve
1112 - c1y (number) y of the first anchor of the curve
1113 - c2x (number) x of the second anchor of the curve
1114 - c2y (number) y of the second anchor of the curve
1115 - p2x (number) x of the second point of the curve
1116 - p2y (number) y of the second point of the curve
1117 - t (number) position on the curve (0..1)
1118 = (object) point information in format:
1120 o x: (number) x coordinate of the point
1121 o y: (number) y coordinate of the point
1123 o x: (number) x coordinate of the left anchor
1124 o y: (number) y coordinate of the left anchor
1127 o x: (number) x coordinate of the right anchor
1128 o y: (number) y coordinate of the right anchor
1131 o x: (number) x coordinate of the start of the curve
1132 o y: (number) y coordinate of the start of the curve
1135 o x: (number) x coordinate of the end of the curve
1136 o y: (number) y coordinate of the end of the curve
1138 o alpha: (number) angle of the curve derivative at the point
1141 R.findDotsAtSegment = function (p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t) {
1147 x = t13 * p1x + t12 * 3 * t * c1x + t1 * 3 * t * t * c2x + t3 * p2x,
1148 y = t13 * p1y + t12 * 3 * t * c1y + t1 * 3 * t * t * c2y + t3 * p2y,
1149 mx = p1x + 2 * t * (c1x - p1x) + t2 * (c2x - 2 * c1x + p1x),
1150 my = p1y + 2 * t * (c1y - p1y) + t2 * (c2y - 2 * c1y + p1y),
1151 nx = c1x + 2 * t * (c2x - c1x) + t2 * (p2x - 2 * c2x + c1x),
1152 ny = c1y + 2 * t * (c2y - c1y) + t2 * (p2y - 2 * c2y + c1y),
1153 ax = t1 * p1x + t * c1x,
1154 ay = t1 * p1y + t * c1y,
1155 cx = t1 * c2x + t * p2x,
1156 cy = t1 * c2y + t * p2y,
1157 alpha = (90 - math.atan2(mx - nx, my - ny) * 180 / PI);
1158 (mx > nx || my < ny) && (alpha += 180);
1164 start: {x: ax, y: ay},
1165 end: {x: cx, y: cy},
1169 R._removedFactory = function (methodname) {
1170 return function () {
1171 throw new Error("Rapha\xebl: you are calling to method \u201c" + methodname + "\u201d of removed object");
1174 var pathDimensions = cacher(function (path) {
1176 return {x: 0, y: 0, width: 0, height: 0};
1178 path = path2curve(path);
1184 for (var i = 0, ii = path.length; i < ii; i++) {
1192 var dim = curveDim(x, y, p[1], p[2], p[3], p[4], p[5], p[6]);
1193 X = X[concat](dim.min.x, dim.max.x);
1194 Y = Y[concat](dim.min.y, dim.max.y);
1199 var xmin = mmin[apply](0, X),
1200 ymin = mmin[apply](0, Y);
1204 width: mmax[apply](0, X) - xmin,
1205 height: mmax[apply](0, Y) - ymin
1207 }, null, function (o) {
1215 pathClone = function (pathArray) {
1217 if (!R.is(pathArray, array) || !R.is(pathArray && pathArray[0], array)) { // rough assumption
1218 pathArray = R.parsePathString(pathArray);
1220 for (var i = 0, ii = pathArray.length; i < ii; i++) {
1222 for (var j = 0, jj = pathArray[i].length; j < jj; j++) {
1223 res[i][j] = pathArray[i][j];
1226 res.toString = R._path2string;
1229 pathToRelative = R._pathToRelative = cacher(function (pathArray) {
1230 if (!R.is(pathArray, array) || !R.is(pathArray && pathArray[0], array)) { // rough assumption
1231 pathArray = R.parsePathString(pathArray);
1239 if (pathArray[0][0] == "M") {
1240 x = pathArray[0][1];
1241 y = pathArray[0][2];
1245 res.push(["M", x, y]);
1247 for (var i = start, ii = pathArray.length; i < ii; i++) {
1248 var r = res[i] = [],
1250 if (pa[0] != lowerCase.call(pa[0])) {
1251 r[0] = lowerCase.call(pa[0]);
1259 r[6] = +(pa[6] - x).toFixed(3);
1260 r[7] = +(pa[7] - y).toFixed(3);
1263 r[1] = +(pa[1] - y).toFixed(3);
1269 for (var j = 1, jj = pa.length; j < jj; j++) {
1270 r[j] = +(pa[j] - ((j % 2) ? x : y)).toFixed(3);
1279 for (var k = 0, kk = pa.length; k < kk; k++) {
1283 var len = res[i].length;
1284 switch (res[i][0]) {
1290 x += +res[i][len - 1];
1293 y += +res[i][len - 1];
1296 x += +res[i][len - 2];
1297 y += +res[i][len - 1];
1300 res.toString = R._path2string;
1303 pathToAbsolute = R._pathToAbsolute = cacher(function (pathArray) {
1304 if (!R.is(pathArray, array) || !R.is(pathArray && pathArray[0], array)) { // rough assumption
1305 pathArray = R.parsePathString(pathArray);
1307 if (!pathArray || !pathArray.length) {
1308 return [["M", 0, 0]];
1316 if (pathArray[0][0] == "M") {
1317 x = +pathArray[0][1];
1318 y = +pathArray[0][2];
1322 res[0] = ["M", x, y];
1324 for (var r, pa, i = start, ii = pathArray.length; i < ii; i++) {
1327 if (pa[0] != upperCase.call(pa[0])) {
1328 r[0] = upperCase.call(pa[0]);
1336 r[6] = +(pa[6] + x);
1337 r[7] = +(pa[7] + y);
1346 var dots = [x, y][concat](pa.slice(1));
1347 for (var j = 2, jj = dots.length; j < jj; j++) {
1348 dots[j] = +dots[j] + x;
1349 dots[++j] = +dots[j] + y;
1352 res = res[concat](catmullRom2bezier(dots));
1358 for (j = 1, jj = pa.length; j < jj; j++) {
1359 r[j] = +pa[j] + ((j % 2) ? x : y);
1362 } else if (pa[0] == "R") {
1363 dots = [x, y][concat](pa.slice(1));
1365 res = res[concat](catmullRom2bezier(dots));
1366 r = ["R"][concat](pa.slice(-2));
1368 for (var k = 0, kk = pa.length; k < kk; k++) {
1384 mx = r[r.length - 2];
1385 my = r[r.length - 1];
1387 x = r[r.length - 2];
1388 y = r[r.length - 1];
1391 res.toString = R._path2string;
1393 }, null, pathClone),
1394 l2c = function (x1, y1, x2, y2) {
1395 return [x1, y1, x2, y2, x2, y2];
1397 q2c = function (x1, y1, ax, ay, x2, y2) {
1401 _13 * x1 + _23 * ax,
1402 _13 * y1 + _23 * ay,
1403 _13 * x2 + _23 * ax,
1404 _13 * y2 + _23 * ay,
1409 a2c = function (x1, y1, rx, ry, angle, large_arc_flag, sweep_flag, x2, y2, recursive) {
1410 // for more information of where this math came from visit:
1411 // http://www.w3.org/TR/SVG11/implnote.html#ArcImplementationNotes
1412 var _120 = PI * 120 / 180,
1413 rad = PI / 180 * (+angle || 0),
1416 rotate = cacher(function (x, y, rad) {
1417 var X = x * math.cos(rad) - y * math.sin(rad),
1418 Y = x * math.sin(rad) + y * math.cos(rad);
1419 return {x: X, y: Y};
1422 xy = rotate(x1, y1, -rad);
1425 xy = rotate(x2, y2, -rad);
1428 var cos = math.cos(PI / 180 * angle),
1429 sin = math.sin(PI / 180 * angle),
1432 var h = (x * x) / (rx * rx) + (y * y) / (ry * ry);
1440 k = (large_arc_flag == sweep_flag ? -1 : 1) *
1441 math.sqrt(abs((rx2 * ry2 - rx2 * y * y - ry2 * x * x) / (rx2 * y * y + ry2 * x * x))),
1442 cx = k * rx * y / ry + (x1 + x2) / 2,
1443 cy = k * -ry * x / rx + (y1 + y2) / 2,
1444 f1 = math.asin(((y1 - cy) / ry).toFixed(9)),
1445 f2 = math.asin(((y2 - cy) / ry).toFixed(9));
1447 f1 = x1 < cx ? PI - f1 : f1;
1448 f2 = x2 < cx ? PI - f2 : f2;
1449 f1 < 0 && (f1 = PI * 2 + f1);
1450 f2 < 0 && (f2 = PI * 2 + f2);
1451 if (sweep_flag && f1 > f2) {
1454 if (!sweep_flag && f2 > f1) {
1464 if (abs(df) > _120) {
1468 f2 = f1 + _120 * (sweep_flag && f2 > f1 ? 1 : -1);
1469 x2 = cx + rx * math.cos(f2);
1470 y2 = cy + ry * math.sin(f2);
1471 res = a2c(x2, y2, rx, ry, angle, 0, sweep_flag, x2old, y2old, [f2, f2old, cx, cy]);
1474 var c1 = math.cos(f1),
1478 t = math.tan(df / 4),
1479 hx = 4 / 3 * rx * t,
1480 hy = 4 / 3 * ry * t,
1482 m2 = [x1 + hx * s1, y1 - hy * c1],
1483 m3 = [x2 + hx * s2, y2 - hy * c2],
1485 m2[0] = 2 * m1[0] - m2[0];
1486 m2[1] = 2 * m1[1] - m2[1];
1488 return [m2, m3, m4][concat](res);
1490 res = [m2, m3, m4][concat](res).join()[split](",");
1492 for (var i = 0, ii = res.length; i < ii; i++) {
1493 newres[i] = i % 2 ? rotate(res[i - 1], res[i], rad).y : rotate(res[i], res[i + 1], rad).x;
1498 findDotAtSegment = function (p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t) {
1501 x: pow(t1, 3) * p1x + pow(t1, 2) * 3 * t * c1x + t1 * 3 * t * t * c2x + pow(t, 3) * p2x,
1502 y: pow(t1, 3) * p1y + pow(t1, 2) * 3 * t * c1y + t1 * 3 * t * t * c2y + pow(t, 3) * p2y
1505 curveDim = cacher(function (p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y) {
1506 var a = (c2x - 2 * c1x + p1x) - (p2x - 2 * c2x + c1x),
1507 b = 2 * (c1x - p1x) - 2 * (c2x - c1x),
1509 t1 = (-b + math.sqrt(b * b - 4 * a * c)) / 2 / a,
1510 t2 = (-b - math.sqrt(b * b - 4 * a * c)) / 2 / a,
1514 abs(t1) > "1e12" && (t1 = .5);
1515 abs(t2) > "1e12" && (t2 = .5);
1516 if (t1 > 0 && t1 < 1) {
1517 dot = findDotAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t1);
1521 if (t2 > 0 && t2 < 1) {
1522 dot = findDotAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t2);
1526 a = (c2y - 2 * c1y + p1y) - (p2y - 2 * c2y + c1y);
1527 b = 2 * (c1y - p1y) - 2 * (c2y - c1y);
1529 t1 = (-b + math.sqrt(b * b - 4 * a * c)) / 2 / a;
1530 t2 = (-b - math.sqrt(b * b - 4 * a * c)) / 2 / a;
1531 abs(t1) > "1e12" && (t1 = .5);
1532 abs(t2) > "1e12" && (t2 = .5);
1533 if (t1 > 0 && t1 < 1) {
1534 dot = findDotAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t1);
1538 if (t2 > 0 && t2 < 1) {
1539 dot = findDotAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t2);
1544 min: {x: mmin[apply](0, x), y: mmin[apply](0, y)},
1545 max: {x: mmax[apply](0, x), y: mmax[apply](0, y)}
1548 path2curve = R._path2curve = cacher(function (path, path2) {
1549 var p = pathToAbsolute(path),
1550 p2 = path2 && pathToAbsolute(path2),
1551 attrs = {x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null},
1552 attrs2 = {x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null},
1553 processPath = function (path, d) {
1556 return ["C", d.x, d.y, d.x, d.y, d.x, d.y];
1558 !(path[0] in {T:1, Q:1}) && (d.qx = d.qy = null);
1565 path = ["C"][concat](a2c[apply](0, [d.x, d.y][concat](path.slice(1))));
1568 nx = d.x + (d.x - (d.bx || d.x));
1569 ny = d.y + (d.y - (d.by || d.y));
1570 path = ["C", nx, ny][concat](path.slice(1));
1573 d.qx = d.x + (d.x - (d.qx || d.x));
1574 d.qy = d.y + (d.y - (d.qy || d.y));
1575 path = ["C"][concat](q2c(d.x, d.y, d.qx, d.qy, path[1], path[2]));
1580 path = ["C"][concat](q2c(d.x, d.y, path[1], path[2], path[3], path[4]));
1583 path = ["C"][concat](l2c(d.x, d.y, path[1], path[2]));
1586 path = ["C"][concat](l2c(d.x, d.y, path[1], d.y));
1589 path = ["C"][concat](l2c(d.x, d.y, d.x, path[1]));
1592 path = ["C"][concat](l2c(d.x, d.y, d.X, d.Y));
1597 fixArc = function (pp, i) {
1598 if (pp[i].length > 7) {
1602 pp.splice(i++, 0, ["C"][concat](pi.splice(0, 6)));
1605 ii = mmax(p.length, p2 && p2.length || 0);
1608 fixM = function (path1, path2, a1, a2, i) {
1609 if (path1 && path2 && path1[i][0] == "M" && path2[i][0] != "M") {
1610 path2.splice(i, 0, ["M", a2.x, a2.y]);
1615 ii = mmax(p.length, p2 && p2.length || 0);
1618 for (var i = 0, ii = mmax(p.length, p2 && p2.length || 0); i < ii; i++) {
1619 p[i] = processPath(p[i], attrs);
1621 p2 && (p2[i] = processPath(p2[i], attrs2));
1622 p2 && fixArc(p2, i);
1623 fixM(p, p2, attrs, attrs2, i);
1624 fixM(p2, p, attrs2, attrs, i);
1627 seglen = seg.length,
1628 seg2len = p2 && seg2.length;
1629 attrs.x = seg[seglen - 2];
1630 attrs.y = seg[seglen - 1];
1631 attrs.bx = toFloat(seg[seglen - 4]) || attrs.x;
1632 attrs.by = toFloat(seg[seglen - 3]) || attrs.y;
1633 attrs2.bx = p2 && (toFloat(seg2[seg2len - 4]) || attrs2.x);
1634 attrs2.by = p2 && (toFloat(seg2[seg2len - 3]) || attrs2.y);
1635 attrs2.x = p2 && seg2[seg2len - 2];
1636 attrs2.y = p2 && seg2[seg2len - 1];
1638 return p2 ? [p, p2] : p;
1639 }, null, pathClone),
1640 parseDots = R._parseDots = cacher(function (gradient) {
1642 for (var i = 0, ii = gradient.length; i < ii; i++) {
1644 par = gradient[i].match(/^([^:]*):?([\d\.]*)/);
1645 dot.color = R.getRGB(par[1]);
1646 if (dot.color.error) {
1649 dot.color = dot.color.hex;
1650 par[2] && (dot.offset = par[2] + "%");
1653 for (i = 1, ii = dots.length - 1; i < ii; i++) {
1654 if (!dots[i].offset) {
1655 var start = toFloat(dots[i - 1].offset || 0),
1657 for (var j = i + 1; j < ii; j++) {
1658 if (dots[j].offset) {
1659 end = dots[j].offset;
1668 var d = (end - start) / (j - i + 1);
1669 for (; i < j; i++) {
1671 dots[i].offset = start + "%";
1677 tear = R._tear = function (el, paper) {
1678 el == paper.top && (paper.top = el.prev);
1679 el == paper.bottom && (paper.bottom = el.next);
1680 el.next && (el.next.prev = el.prev);
1681 el.prev && (el.prev.next = el.next);
1683 tofront = R._tofront = function (el, paper) {
1684 if (paper.top === el) {
1689 el.prev = paper.top;
1690 paper.top.next = el;
1693 toback = R._toback = function (el, paper) {
1694 if (paper.bottom === el) {
1698 el.next = paper.bottom;
1700 paper.bottom.prev = el;
1703 insertafter = R._insertafter = function (el, el2, paper) {
1705 el2 == paper.top && (paper.top = el);
1706 el2.next && (el2.next.prev = el);
1711 insertbefore = R._insertbefore = function (el, el2, paper) {
1713 el2 == paper.bottom && (paper.bottom = el);
1714 el2.prev && (el2.prev.next = el);
1719 extractTransform = R._extractTransform = function (el, tstr) {
1721 return el._.transform;
1723 tstr = Str(tstr).replace(/\.{3}|\u2026/g, el._.transform || E);
1724 var tdata = R.parseTransformString(tstr),
1732 _.transform = tdata || [];
1734 for (var i = 0, ii = tdata.length; i < ii; i++) {
1737 command = Str(t[0]).toLowerCase(),
1738 absolute = t[0] != command,
1739 inver = absolute ? m.invert() : 0,
1745 if (command == "t" && tlen == 3) {
1749 x2 = inver.x(t[1], t[2]);
1750 y2 = inver.y(t[1], t[2]);
1751 m.translate(x2 - x1, y2 - y1);
1753 m.translate(t[1], t[2]);
1755 } else if (command == "r") {
1757 bb = bb || el.getBBox(1);
1758 m.rotate(t[1], bb.x + bb.width / 2, bb.y + bb.height / 2);
1760 } else if (tlen == 4) {
1762 x2 = inver.x(t[2], t[3]);
1763 y2 = inver.y(t[2], t[3]);
1764 m.rotate(t[1], x2, y2);
1766 m.rotate(t[1], t[2], t[3]);
1770 } else if (command == "s") {
1771 if (tlen == 2 || tlen == 3) {
1772 bb = bb || el.getBBox(1);
1773 m.scale(t[1], t[tlen - 1], bb.x + bb.width / 2, bb.y + bb.height / 2);
1776 } else if (tlen == 5) {
1778 x2 = inver.x(t[3], t[4]);
1779 y2 = inver.y(t[3], t[4]);
1780 m.scale(t[1], t[2], x2, y2);
1782 m.scale(t[1], t[2], t[3], t[4]);
1787 } else if (command == "m" && tlen == 7) {
1788 m.add(t[1], t[2], t[3], t[4], t[5], t[6]);
1803 if (sx == 1 && sy == 1 && !deg && _.bbox) {
1810 getEmpty = function (item) {
1812 switch (l.toLowerCase()) {
1813 case "t": return [l, 0, 0];
1814 case "m": return [l, 1, 0, 0, 1, 0, 0];
1815 case "r": if (item.length == 4) {
1816 return [l, 0, item[2], item[3]];
1820 case "s": if (item.length == 5) {
1821 return [l, 1, 1, item[3], item[4]];
1822 } else if (item.length == 3) {
1829 equaliseTransform = R._equaliseTransform = function (t1, t2) {
1830 t2 = Str(t2).replace(/\.{3}|\u2026/g, t1);
1831 t1 = R.parseTransformString(t1) || [];
1832 t2 = R.parseTransformString(t2) || [];
1833 var maxlength = mmax(t1.length, t2.length),
1838 for (; i < maxlength; i++) {
1839 tt1 = t1[i] || getEmpty(t2[i]);
1840 tt2 = t2[i] || getEmpty(tt1);
1841 if ((tt1[0] != tt2[0]) ||
1842 (tt1[0].toLowerCase() == "r" && (tt1[2] != tt2[2] || tt1[3] != tt2[3])) ||
1843 (tt1[0].toLowerCase() == "s" && (tt1[3] != tt2[3] || tt1[4] != tt2[4]))
1849 for (j = 0, jj = mmax(tt1.length, tt2.length); j < jj; j++) {
1850 j in tt1 && (from[i][j] = tt1[j]);
1851 j in tt2 && (to[i][j] = tt2[j]);
1859 R._getContainer = function (x, y, w, h) {
1861 container = h == null && !R.is(x, "object") ? g.doc.getElementById(x) : x;
1862 if (container == null) {
1865 if (container.tagName) {
1868 container: container,
1869 width: container.style.pixelWidth || container.offsetWidth,
1870 height: container.style.pixelHeight || container.offsetHeight
1874 container: container,
1889 * Raphael.pathToRelative
1894 * Converts path to relative form
1896 - pathString (string|array) path string or array of segments
1897 = (array) array of segments.
1899 R.pathToRelative = pathToRelative;
1902 * Raphael.path2curve
1907 * Converts path to a new path where all segments are cubic bezier curves.
1909 - pathString (string|array) path string or array of segments
1910 = (array) array of segments.
1912 R.path2curve = path2curve;
1919 * Returns matrix based on given parameters.
1929 R.matrix = function (a, b, c, d, e, f) {
1930 return new Matrix(a, b, c, d, e, f);
1932 function Matrix(a, b, c, d, e, f) {
1949 (function (matrixproto) {
1954 * Adds given matrix to existing one.
1963 - matrix (object) @Matrix
1965 matrixproto.add = function (a, b, c, d, e, f) {
1966 var out = [[], [], []],
1967 m = [[this.a, this.c, this.e], [this.b, this.d, this.f], [0, 0, 1]],
1968 matrix = [[a, c, e], [b, d, f], [0, 0, 1]],
1971 if (a && a instanceof Matrix) {
1972 matrix = [[a.a, a.c, a.e], [a.b, a.d, a.f], [0, 0, 1]];
1975 for (x = 0; x < 3; x++) {
1976 for (y = 0; y < 3; y++) {
1978 for (z = 0; z < 3; z++) {
1979 res += m[x][z] * matrix[z][y];
1995 * Returns inverted version of the matrix
1998 matrixproto.invert = function () {
2000 x = me.a * me.d - me.b * me.c;
2001 return new Matrix(me.d / x, -me.b / x, -me.c / x, me.a / x, (me.c * me.f - me.d * me.e) / x, (me.b * me.e - me.a * me.f) / x);
2007 * Returns copy of the matrix
2010 matrixproto.clone = function () {
2011 return new Matrix(this.a, this.b, this.c, this.d, this.e, this.f);
2017 * Translate the matrix
2022 matrixproto.translate = function (x, y) {
2023 this.add(1, 0, 0, 1, x, y);
2032 - y (number) #optional
2033 - cx (number) #optional
2034 - cy (number) #optional
2036 matrixproto.scale = function (x, y, cx, cy) {
2037 y == null && (y = x);
2038 (cx || cy) && this.add(1, 0, 0, 1, cx, cy);
2039 this.add(x, 0, 0, y, 0, 0);
2040 (cx || cy) && this.add(1, 0, 0, 1, -cx, -cy);
2046 * Rotates the matrix
2052 matrixproto.rotate = function (a, x, y) {
2056 var cos = +math.cos(a).toFixed(9),
2057 sin = +math.sin(a).toFixed(9);
2058 this.add(cos, sin, -sin, cos, x, y);
2059 this.add(1, 0, 0, 1, -x, -y);
2065 * Return x coordinate for given point after transformation described by the matrix. See also @Matrix.y
2071 matrixproto.x = function (x, y) {
2072 return x * this.a + y * this.c + this.e;
2078 * Return y coordinate for given point after transformation described by the matrix. See also @Matrix.x
2084 matrixproto.y = function (x, y) {
2085 return x * this.b + y * this.d + this.f;
2087 matrixproto.get = function (i) {
2088 return +this[Str.fromCharCode(97 + i)].toFixed(4);
2090 matrixproto.toString = function () {
2092 "matrix(" + [this.get(0), this.get(1), this.get(2), this.get(3), this.get(4), this.get(5)].join() + ")" :
2093 [this.get(0), this.get(2), this.get(1), this.get(3), 0, 0].join();
2095 matrixproto.toFilter = function () {
2096 return "progid:DXImageTransform.Microsoft.Matrix(M11=" + this.get(0) +
2097 ", M12=" + this.get(2) + ", M21=" + this.get(1) + ", M22=" + this.get(3) +
2098 ", Dx=" + this.get(4) + ", Dy=" + this.get(5) + ", sizingmethod='auto expand')";
2100 matrixproto.offset = function () {
2101 return [this.e.toFixed(4), this.f.toFixed(4)];
2104 return a[0] * a[0] + a[1] * a[1];
2106 function normalize(a) {
2107 var mag = math.sqrt(norm(a));
2108 a[0] && (a[0] /= mag);
2109 a[1] && (a[1] /= mag);
2115 * Splits matrix into primitive transformations
2116 = (object) in format:
2117 o dx (number) translation by x
2118 o dy (number) translation by y
2119 o scalex (number) scale by x
2120 o scaley (number) scale by y
2121 o shear (number) shear
2122 o rotate (number) rotation in deg
2123 o isSimple (boolean) could it be represented via simple transformations
2125 matrixproto.split = function () {
2132 var row = [[this.a, this.c], [this.b, this.d]];
2133 out.scalex = math.sqrt(norm(row[0]));
2136 out.shear = row[0][0] * row[1][0] + row[0][1] * row[1][1];
2137 row[1] = [row[1][0] - row[0][0] * out.shear, row[1][1] - row[0][1] * out.shear];
2139 out.scaley = math.sqrt(norm(row[1]));
2141 out.shear /= out.scaley;
2144 var sin = -row[0][1],
2147 out.rotate = R.deg(math.acos(cos));
2149 out.rotate = 360 - out.rotate;
2152 out.rotate = R.deg(math.asin(sin));
2155 out.isSimple = !+out.shear.toFixed(9) && (out.scalex.toFixed(9) == out.scaley.toFixed(9) || !out.rotate);
2156 out.isSuperSimple = !+out.shear.toFixed(9) && out.scalex.toFixed(9) == out.scaley.toFixed(9) && !out.rotate;
2157 out.noRotation = !+out.shear.toFixed(9) && !out.rotate;
2161 * Matrix.toTransformString
2164 * Return transform string that represents given matrix
2165 = (string) transform string
2167 matrixproto.toTransformString = function (shorter) {
2168 var s = shorter || this[split]();
2170 s.scalex = +s.scalex.toFixed(4);
2171 s.scaley = +s.scaley.toFixed(4);
2172 s.rotate = +s.rotate.toFixed(4);
2173 return (s.dx && s.dy ? "t" + [s.dx, s.dy] : E) +
2174 (s.scalex != 1 || s.scaley != 1 ? "s" + [s.scalex, s.scaley, 0, 0] : E) +
2175 (s.rotate ? "r" + [s.rotate, 0, 0] : E);
2177 return "m" + [this.get(0), this.get(1), this.get(2), this.get(3), this.get(4), this.get(5)];
2180 })(Matrix.prototype);
2182 // WebKit rendering bug workaround method
2183 var version = navigator.userAgent.match(/Version\/(.*?)\s/) || navigator.userAgent.match(/Chrome\/(\d+)/);
2184 if ((navigator.vendor == "Apple Computer, Inc.") && (version && version[1] < 4 || navigator.platform.slice(0, 2) == "iP") ||
2185 (navigator.vendor == "Google Inc." && version && version[1] < 8)) {
2190 * There is an inconvenient rendering bug in Safari (WebKit):
2191 * sometimes the rendering should be forced.
2192 * This method should help with dealing with this bug.
2194 paperproto.safari = function () {
2195 var rect = this.rect(-99, -99, this.width + 99, this.height + 99).attr({stroke: "none"});
2196 setTimeout(function () {rect.remove();});
2199 paperproto.safari = fun;
2202 var preventDefault = function () {
2203 this.returnValue = false;
2205 preventTouch = function () {
2206 return this.originalEvent.preventDefault();
2208 stopPropagation = function () {
2209 this.cancelBubble = true;
2211 stopTouch = function () {
2212 return this.originalEvent.stopPropagation();
2214 addEvent = (function () {
2215 if (g.doc.addEventListener) {
2216 return function (obj, type, fn, element) {
2217 var realName = supportsTouch && touchMap[type] ? touchMap[type] : type,
2219 var scrollY = g.doc.documentElement.scrollTop || g.doc.body.scrollTop,
2220 scrollX = g.doc.documentElement.scrollLeft || g.doc.body.scrollLeft,
2221 x = e.clientX + scrollX,
2222 y = e.clientY + scrollY;
2223 if (supportsTouch && touchMap[has](type)) {
2224 for (var i = 0, ii = e.targetTouches && e.targetTouches.length; i < ii; i++) {
2225 if (e.targetTouches[i].target == obj) {
2227 e = e.targetTouches[i];
2228 e.originalEvent = olde;
2229 e.preventDefault = preventTouch;
2230 e.stopPropagation = stopTouch;
2235 return fn.call(element, e, x, y);
2237 obj.addEventListener(realName, f, false);
2238 return function () {
2239 obj.removeEventListener(realName, f, false);
2243 } else if (g.doc.attachEvent) {
2244 return function (obj, type, fn, element) {
2245 var f = function (e) {
2246 e = e || g.win.event;
2247 var scrollY = g.doc.documentElement.scrollTop || g.doc.body.scrollTop,
2248 scrollX = g.doc.documentElement.scrollLeft || g.doc.body.scrollLeft,
2249 x = e.clientX + scrollX,
2250 y = e.clientY + scrollY;
2251 e.preventDefault = e.preventDefault || preventDefault;
2252 e.stopPropagation = e.stopPropagation || stopPropagation;
2253 return fn.call(element, e, x, y);
2255 obj.attachEvent("on" + type, f);
2256 var detacher = function () {
2257 obj.detachEvent("on" + type, f);
2265 dragMove = function (e) {
2268 scrollY = g.doc.documentElement.scrollTop || g.doc.body.scrollTop,
2269 scrollX = g.doc.documentElement.scrollLeft || g.doc.body.scrollLeft,
2274 if (supportsTouch) {
2275 var i = e.touches.length,
2278 touch = e.touches[i];
2279 if (touch.identifier == dragi.el._drag.id) {
2282 (e.originalEvent ? e.originalEvent : e).preventDefault();
2289 var node = dragi.el.node,
2291 next = node.nextSibling,
2292 parent = node.parentNode,
2293 display = node.style.display;
2294 g.win.opera && parent.removeChild(node);
2295 node.style.display = "none";
2296 o = dragi.el.paper.getElementByPoint(x, y);
2297 node.style.display = display;
2298 g.win.opera && (next ? parent.insertBefore(node, next) : parent.appendChild(node));
2299 o && eve("drag.over." + dragi.el.id, dragi.el, o);
2302 eve("drag.move." + dragi.el.id, dragi.move_scope || dragi.el, x - dragi.el._drag.x, y - dragi.el._drag.y, x, y, e);
2305 dragUp = function (e) {
2306 R.unmousemove(dragMove).unmouseup(dragUp);
2307 var i = drag.length,
2311 dragi.el._drag = {};
2312 eve("drag.end." + dragi.el.id, dragi.end_scope || dragi.start_scope || dragi.move_scope || dragi.el, e);
2318 [ property (object) ]
2320 * You can add your own method to elements. This is usefull when you want to hack default functionality or
2321 * want to wrap some common transformation or attributes in one method. In difference to canvas methods,
2322 * you can redefine element method at any time. Expending element methods wouldn’t affect set.
2324 | Raphael.el.red = function () {
2325 | this.attr({fill: "#f00"});
2328 | paper.circle(100, 100, 20).red();
2330 elproto = R.el = {};
2335 * Adds event handler for click for the element.
2337 - handler (function) handler for the event
2344 * Removes event handler for click for the element.
2346 - handler (function) handler for the event
2354 * Adds event handler for double click for the element.
2356 - handler (function) handler for the event
2360 * Element.undblclick
2363 * Removes event handler for double click for the element.
2365 - handler (function) handler for the event
2373 * Adds event handler for mousedown for the element.
2375 - handler (function) handler for the event
2379 * Element.unmousedown
2382 * Removes event handler for mousedown for the element.
2384 - handler (function) handler for the event
2392 * Adds event handler for mousemove for the element.
2394 - handler (function) handler for the event
2398 * Element.unmousemove
2401 * Removes event handler for mousemove for the element.
2403 - handler (function) handler for the event
2411 * Adds event handler for mouseout for the element.
2413 - handler (function) handler for the event
2417 * Element.unmouseout
2420 * Removes event handler for mouseout for the element.
2422 - handler (function) handler for the event
2430 * Adds event handler for mouseover for the element.
2432 - handler (function) handler for the event
2436 * Element.unmouseover
2439 * Removes event handler for mouseover for the element.
2441 - handler (function) handler for the event
2449 * Adds event handler for mouseup for the element.
2451 - handler (function) handler for the event
2458 * Removes event handler for mouseup for the element.
2460 - handler (function) handler for the event
2465 * Element.touchstart
2468 * Adds event handler for touchstart for the element.
2470 - handler (function) handler for the event
2474 * Element.untouchstart
2477 * Removes event handler for touchstart for the element.
2479 - handler (function) handler for the event
2487 * Adds event handler for touchmove for the element.
2489 - handler (function) handler for the event
2493 * Element.untouchmove
2496 * Removes event handler for touchmove for the element.
2498 - handler (function) handler for the event
2506 * Adds event handler for touchend for the element.
2508 - handler (function) handler for the event
2512 * Element.untouchend
2515 * Removes event handler for touchend for the element.
2517 - handler (function) handler for the event
2522 * Element.touchcancel
2525 * Adds event handler for touchcancel for the element.
2527 - handler (function) handler for the event
2531 * Element.untouchcancel
2534 * Removes event handler for touchcancel for the element.
2536 - handler (function) handler for the event
2539 for (var i = events.length; i--;) {
2540 (function (eventName) {
2541 R[eventName] = elproto[eventName] = function (fn, scope) {
2542 if (R.is(fn, "function")) {
2543 this.events = this.events || [];
2544 this.events.push({name: eventName, f: fn, unbind: addEvent(this.shape || this.node || g.doc, eventName, fn, scope || this)});
2548 R["un" + eventName] = elproto["un" + eventName] = function (fn) {
2549 var events = this.events,
2551 while (l--) if (events[l].name == eventName && events[l].f == fn) {
2553 events.splice(l, 1);
2554 !events.length && delete this.events;
2566 * Adds or retrieves given value asociated with given key.
2568 * See also @Element.removeData
2570 - key (string) key to store data
2571 - value (any) #optional value to store
2573 * or, if value is not specified:
2576 | for (var i = 0, i < 5, i++) {
2577 | paper.circle(10 + 15 * i, 10, 10)
2578 | .attr({fill: "#000"})
2580 | .click(function () {
2581 | alert(this.data("i"));
2585 elproto.data = function (key, value) {
2586 var data = eldata[this.id] = eldata[this.id] || {};
2587 if (arguments.length == 1) {
2588 if (R.is(key, "object")) {
2589 for (var i in key) if (key[has](i)) {
2590 this.data(i, key[i]);
2594 eve("data.get." + this.id, this, data[key], key);
2598 eve("data.set." + this.id, this, value, key);
2602 * Element.removeData
2605 * Removes value associated with an element by given key.
2606 * If key is not provided, removes all the data of the element.
2608 - key (string) #optional key
2611 elproto.removeData = function (key) {
2613 eldata[this.id] = {};
2615 eldata[this.id] && delete eldata[this.id][key];
2623 * Adds event handlers for hover for the element.
2625 - f_in (function) handler for hover in
2626 - f_out (function) handler for hover out
2627 - icontext (object) #optional context for hover in handler
2628 - ocontext (object) #optional context for hover out handler
2631 elproto.hover = function (f_in, f_out, scope_in, scope_out) {
2632 return this.mouseover(f_in, scope_in).mouseout(f_out, scope_out || scope_in);
2638 * Removes event handlers for hover for the element.
2640 - f_in (function) handler for hover in
2641 - f_out (function) handler for hover out
2644 elproto.unhover = function (f_in, f_out) {
2645 return this.unmouseover(f_in).unmouseout(f_out);
2652 * Adds event handlers for drag of the element.
2654 - onmove (function) handler for moving
2655 - onstart (function) handler for drag start
2656 - onend (function) handler for drag end
2657 - mcontext (object) #optional context for moving handler
2658 - scontext (object) #optional context for drag start handler
2659 - econtext (object) #optional context for drag end handler
2660 * Additionaly following `drag` events will be triggered: `drag.start.<id>` on start,
2661 * `drag.end.<id>` on end and `drag.move.<id>` on every move. When element will be dragged over another element
2662 * `drag.over.<id>` will be fired as well.
2664 * Start event and start handler will be called in specified context or in context of the element with following parameters:
2665 o x (number) x position of the mouse
2666 o y (number) y position of the mouse
2667 o event (object) DOM event object
2668 * Move event and move handler will be called in specified context or in context of the element with following parameters:
2669 o dx (number) shift by x from the start point
2670 o dy (number) shift by y from the start point
2671 o x (number) x position of the mouse
2672 o y (number) y position of the mouse
2673 o event (object) DOM event object
2674 * End event and end handler will be called in specified context or in context of the element with following parameters:
2675 o event (object) DOM event object
2678 elproto.drag = function (onmove, onstart, onend, move_scope, start_scope, end_scope) {
2680 (e.originalEvent || e).preventDefault();
2681 var scrollY = g.doc.documentElement.scrollTop || g.doc.body.scrollTop,
2682 scrollX = g.doc.documentElement.scrollLeft || g.doc.body.scrollLeft;
2683 this._drag.x = e.clientX + scrollX;
2684 this._drag.y = e.clientY + scrollY;
2685 this._drag.id = e.identifier;
2686 !drag.length && R.mousemove(dragMove).mouseup(dragUp);
2687 drag.push({el: this, move_scope: move_scope, start_scope: start_scope, end_scope: end_scope});
2688 onstart && eve.on("drag.start." + this.id, onstart);
2689 onmove && eve.on("drag.move." + this.id, onmove);
2690 onend && eve.on("drag.end." + this.id, onend);
2691 eve("drag.start." + this.id, start_scope || move_scope || this, e.clientX + scrollX, e.clientY + scrollY, e);
2694 draggable.push({el: this, start: start});
2695 this.mousedown(start);
2699 * Element.onDragOver
2702 * Shortcut for assigning event handler for `drag.over.<id>` event, where id is id of the element (see @Element.id).
2704 - f (function) handler for event, first argument would be the element you are dragging over
2706 elproto.onDragOver = function (f) {
2707 f ? eve.on("drag.over." + this.id, f) : eve.unbind("drag.over." + this.id);
2713 * Removes all drag event handlers from given element.
2715 elproto.undrag = function () {
2716 var i = draggable.length;
2717 while (i--) if (draggable[i].el == this) {
2718 this.unmousedown(draggable[i].start);
2719 draggable.splice(i, 1);
2720 eve.unbind("drag.*." + this.id);
2722 !draggable.length && R.unmousemove(dragMove).unmouseup(dragUp);
2732 - x (number) x coordinate of the centre
2733 - y (number) y coordinate of the centre
2735 = (object) Raphaël element object with type “circle”
2738 | var c = paper.circle(50, 50, 40);
2740 paperproto.circle = function (x, y, r) {
2741 var out = R._engine.circle(this, x || 0, y || 0, r || 0);
2742 this.__set__ && this.__set__.push(out);
2749 * Draws a rectangle.
2753 - x (number) x coordinate of the top left corner
2754 - y (number) y coordinate of the top left corner
2755 - width (number) width
2756 - height (number) height
2757 - r (number) #optional radius for rounded corners, default is 0
2758 = (object) Raphaël element object with type “rect”
2761 | // regular rectangle
2762 | var c = paper.rect(10, 10, 50, 50);
2763 | // rectangle with rounded corners
2764 | var c = paper.rect(40, 40, 50, 50, 10);
2766 paperproto.rect = function (x, y, w, h, r) {
2767 var out = R._engine.rect(this, x || 0, y || 0, w || 0, h || 0, r || 0);
2768 this.__set__ && this.__set__.push(out);
2779 - x (number) x coordinate of the centre
2780 - y (number) y coordinate of the centre
2781 - rx (number) horizontal radius
2782 - ry (number) vertical radius
2783 = (object) Raphaël element object with type “ellipse”
2786 | var c = paper.ellipse(50, 50, 40, 20);
2788 paperproto.ellipse = function (x, y, rx, ry) {
2789 var out = R._engine.ellipse(this, x || 0, y || 0, rx || 0, ry || 0);
2790 this.__set__ && this.__set__.push(out);
2797 * Creates a path element by given path data string.
2799 - pathString (string) #optional path string in SVG format.
2800 * Path string consists of one-letter commands, followed by comma seprarated arguments in numercal form. Example:
2802 * Here we can see two commands: “M”, with arguments `(10, 20)` and “L” with arguments `(30, 40)`. Upper case letter mean command is absolute, lower case—relative.
2804 # <p>Here is short list of commands available, for more details see <a href="http://www.w3.org/TR/SVG/paths.html#PathData" title="Details of a path's data attribute's format are described in the SVG specification.">SVG path string format</a>.</p>
2805 # <table><thead><tr><th>Command</th><th>Name</th><th>Parameters</th></tr></thead><tbody>
2806 # <tr><td>M</td><td>moveto</td><td>(x y)+</td></tr>
2807 # <tr><td>Z</td><td>closepath</td><td>(none)</td></tr>
2808 # <tr><td>L</td><td>lineto</td><td>(x y)+</td></tr>
2809 # <tr><td>H</td><td>horizontal lineto</td><td>x+</td></tr>
2810 # <tr><td>V</td><td>vertical lineto</td><td>y+</td></tr>
2811 # <tr><td>C</td><td>curveto</td><td>(x1 y1 x2 y2 x y)+</td></tr>
2812 # <tr><td>S</td><td>smooth curveto</td><td>(x2 y2 x y)+</td></tr>
2813 # <tr><td>Q</td><td>quadratic Bézier curveto</td><td>(x1 y1 x y)+</td></tr>
2814 # <tr><td>T</td><td>smooth quadratic Bézier curveto</td><td>(x y)+</td></tr>
2815 # <tr><td>A</td><td>elliptical arc</td><td>(rx ry x-axis-rotation large-arc-flag sweep-flag x y)+</td></tr>
2816 # <tr><td>R</td><td><a href="http://en.wikipedia.org/wiki/Catmull–Rom_spline#Catmull.E2.80.93Rom_spline">Catmull-Rom curveto</a>*</td><td>x1 y1 (x y)+</td></tr></tbody></table>
2817 * * “Catmull-Rom curveto” is a not standard SVG command and added in 2.0 to make life easier.
2819 | var c = paper.path("M10 10L90 90");
2820 | // draw a diagonal line:
2821 | // move to 10,10, line to 90,90
2823 paperproto.path = function (pathString) {
2824 pathString && !R.is(pathString, string) && !R.is(pathString[0], array) && (pathString += E);
2825 var out = R._engine.path(R.format[apply](R, arguments), this);
2826 this.__set__ && this.__set__.push(out);
2833 * Embeds an image into the surface.
2837 - src (string) URI of the source image
2838 - x (number) x coordinate position
2839 - y (number) y coordinate position
2840 - width (number) width of the image
2841 - height (number) height of the image
2842 = (object) Raphaël element object with type “image”
2845 | var c = paper.image("apple.png", 10, 10, 80, 80);
2847 paperproto.image = function (src, x, y, w, h) {
2848 var out = R._engine.image(this, src || "about:blank", x || 0, y || 0, w || 0, h || 0);
2849 this.__set__ && this.__set__.push(out);
2856 * Draws a text string. If you need line breaks, put “\n” in the string.
2860 - x (number) x coordinate position
2861 - y (number) y coordinate position
2862 - text (string) The text string to draw
2863 = (object) Raphaël element object with type “text”
2866 | var t = paper.text(50, 50, "Raphaël\nkicks\nbutt!");
2868 paperproto.text = function (x, y, text) {
2869 var out = R._engine.text(this, x || 0, y || 0, Str(text));
2870 this.__set__ && this.__set__.push(out);
2877 * Creates array-like object to keep and operate several elements at once.
2878 * Warning: it doesn’t create any elements for itself in the page, it just groups existing elements.
2879 * Sets act as pseudo elements — all methods available to an element can be used on a set.
2880 = (object) array-like object that represents set of elements
2883 | var st = paper.set();
2885 | paper.circle(10, 10, 5),
2886 | paper.circle(30, 10, 5)
2888 | st.attr({fill: "red"}); // changes the fill of both circles
2890 paperproto.set = function (itemsArray) {
2891 !R.is(itemsArray, "array") && (itemsArray = Array.prototype.splice.call(arguments, 0, arguments.length));
2892 var out = new Set(itemsArray);
2893 this.__set__ && this.__set__.push(out);
2900 * Creates @Paper.set. All elements that will be created after calling this method and before calling
2901 * @Paper.setFinish will be added to the set.
2905 | paper.circle(10, 10, 5),
2906 | paper.circle(30, 10, 5)
2907 | var st = paper.setFinish();
2908 | st.attr({fill: "red"}); // changes the fill of both circles
2910 paperproto.setStart = function (set) {
2911 this.__set__ = set || this.set();
2917 * See @Paper.setStart. This method finishes catching and returns resulting set.
2921 paperproto.setFinish = function (set) {
2922 var out = this.__set__;
2923 delete this.__set__;
2930 * If you need to change dimensions of the canvas call this method
2934 - width (number) new width of the canvas
2935 - height (number) new height of the canvas
2937 | var st = paper.set();
2939 | paper.circle(10, 10, 5),
2940 | paper.circle(30, 10, 5)
2942 | st.attr({fill: "red"});
2944 paperproto.setSize = function (width, height) {
2945 return R._engine.setSize.call(this, width, height);
2951 * Sets the view box of the paper. Practically it gives you ability to zoom and pan whole paper surface by
2952 * specifying new boundaries.
2956 - x (number) new x position, default is `0`
2957 - y (number) new y position, default is `0`
2958 - w (number) new width of the canvas
2959 - h (number) new height of the canvas
2960 - fit (boolean) `true` if you want graphics to fit into new boundary box
2962 paperproto.setViewBox = function (x, y, w, h, fit) {
2963 return R._engine.setViewBox.call(this, x, y, w, h, fit);
2969 * Points to the topmost element on the paper
2975 * Points to the bottom element on the paper
2977 paperproto.top = paperproto.bottom = null;
2982 * Points to the @Raphael object/function
2984 paperproto.raphael = R;
2985 var getOffset = function (elem) {
2986 var box = elem.getBoundingClientRect(),
2987 doc = elem.ownerDocument,
2989 docElem = doc.documentElement,
2990 clientTop = docElem.clientTop || body.clientTop || 0, clientLeft = docElem.clientLeft || body.clientLeft || 0,
2991 top = box.top + (g.win.pageYOffset || docElem.scrollTop || body.scrollTop ) - clientTop,
2992 left = box.left + (g.win.pageXOffset || docElem.scrollLeft || body.scrollLeft) - clientLeft;
2999 * Paper.getElementByPoint
3002 * Returns you topmost element under given point.
3004 = (object) Raphaël element object
3007 - x (number) x coordinate from the top left corner of the window
3008 - y (number) y coordinate from the top left corner of the window
3010 | paper.getElementByPoint(mouseX, mouseY).attr({stroke: "#f00"});
3012 paperproto.getElementByPoint = function (x, y) {
3015 target = g.doc.elementFromPoint(x, y);
3016 if (g.win.opera && target.tagName == "svg") {
3017 var so = getOffset(svg),
3018 sr = svg.createSVGRect();
3021 sr.width = sr.height = 1;
3022 var hits = svg.getIntersectionList(sr, null);
3024 target = hits[hits.length - 1];
3030 while (target.parentNode && target != svg.parentNode && !target.raphael) {
3031 target = target.parentNode;
3033 target == paper.canvas.parentNode && (target = svg);
3034 target = target && target.raphael ? paper.getById(target.raphaelid) : null;
3041 * Returns you element by its internal ID.
3046 = (object) Raphaël element object
3048 paperproto.getById = function (id) {
3049 var bot = this.bottom;
3062 * Executes given function for each element on the paper
3064 * If callback function returns `false` it will stop loop running.
3068 - callback (function) function to run
3069 - thisArg (object) context object for the callback
3070 = (object) Paper object
3072 paperproto.forEach = function (callback, thisArg) {
3073 var bot = this.bottom;
3075 if (callback.call(thisArg, bot) === false) {
3083 return this.x + S + this.y;
3085 function x_y_w_h() {
3086 return this.x + S + this.y + S + this.width + " \xd7 " + this.height;
3092 * Return bounding box for a given element
3096 - isWithoutTransform (boolean) flag, `true` if you want to have bounding box before transformations. Default is `false`.
3097 = (object) Bounding box object:
3099 o x: (number) top left corner x
3100 o y: (number) top left corner y
3101 o width: (number) width
3102 o height: (number) height
3105 elproto.getBBox = function (isWithoutTransform) {
3110 if (isWithoutTransform) {
3111 if (_.dirty || !_.bboxwt) {
3112 this.realPath = getPath[this.type](this);
3113 _.bboxwt = pathDimensions(this.realPath);
3114 _.bboxwt.toString = x_y_w_h;
3119 if (_.dirty || _.dirtyT || !_.bbox) {
3120 if (_.dirty || !this.realPath) {
3122 this.realPath = getPath[this.type](this);
3124 _.bbox = pathDimensions(mapPath(this.realPath, this.matrix));
3125 _.bbox.toString = x_y_w_h;
3126 _.dirty = _.dirtyT = 0;
3134 = (object) clone of a given element
3137 elproto.clone = function () {
3141 var out = this.paper[this.type]().attr(this.attr());
3142 this.__set__ && this.__set__.push(out);
3149 * Return set of elements that create glow-like effect around given element. See @Paper.set.
3151 * Note: Glow is not connected to the element. If you change element attributes it won’t adjust itself.
3155 - glow (object) #optional parameters object with all properties optional:
3157 o width (number) size of the glow, default is `10`
3158 o fill (boolean) will it be filled, default is `false`
3159 o opacity (number) opacity, default is `0.5`
3160 o offsetx (number) horizontal offset, default is `0`
3161 o offsety (number) vertical offset, default is `0`
3162 o color (string) glow colour, default is `black`
3164 = (object) @Paper.set of elements that represents glow
3166 elproto.glow = function (glow) {
3167 if (this.type == "text") {
3172 width: (glow.width || 10) + (+this.attr("stroke-width") || 1),
3173 fill: glow.fill || false,
3174 opacity: glow.opacity || .5,
3175 offsetx: glow.offsetx || 0,
3176 offsety: glow.offsety || 0,
3177 color: glow.color || "#000"
3182 path = this.realPath || getPath[this.type](this);
3183 path = this.matrix ? mapPath(path, this.matrix) : path;
3184 for (var i = 1; i < c + 1; i++) {
3185 out.push(r.path(path).attr({
3187 fill: s.fill ? s.color : "none",
3188 "stroke-linejoin": "round",
3189 "stroke-linecap": "round",
3190 "stroke-width": +(s.width / c * i).toFixed(3),
3191 opacity: +(s.opacity / c).toFixed(3)
3194 return out.insertBefore(this).translate(s.offsetx, s.offsety);
3196 var curveslengths = {},
3197 getPointAtSegmentLength = function (p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, length) {
3200 name = [p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y].join(),
3201 cache = curveslengths[name],
3203 !cache && (curveslengths[name] = cache = {data: []});
3204 cache.timer && clearTimeout(cache.timer);
3205 cache.timer = setTimeout(function () {delete curveslengths[name];}, 2e3);
3206 if (length != null && !cache.precision) {
3207 var total = getPointAtSegmentLength(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y);
3208 cache.precision = ~~total * 10;
3211 precision = cache.precision || precision;
3212 for (var i = 0; i < precision + 1; i++) {
3213 if (cache.data[i * precision]) {
3214 dot = cache.data[i * precision];
3216 dot = R.findDotsAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, i / precision);
3217 cache.data[i * precision] = dot;
3219 i && (len += pow(pow(old.x - dot.x, 2) + pow(old.y - dot.y, 2), .5));
3220 if (length != null && len >= length) {
3225 if (length == null) {
3229 getLengthFactory = function (istotal, subpath) {
3230 return function (path, length, onlystart) {
3231 path = path2curve(path);
3232 var x, y, p, l, sp = "", subpaths = {}, point,
3234 for (var i = 0, ii = path.length; i < ii; i++) {
3240 l = getPointAtSegmentLength(x, y, p[1], p[2], p[3], p[4], p[5], p[6]);
3241 if (len + l > length) {
3242 if (subpath && !subpaths.start) {
3243 point = getPointAtSegmentLength(x, y, p[1], p[2], p[3], p[4], p[5], p[6], length - len);
3244 sp += ["C" + point.start.x, point.start.y, point.m.x, point.m.y, point.x, point.y];
3245 if (onlystart) {return sp;}
3246 subpaths.start = sp;
3247 sp = ["M" + point.x, point.y + "C" + point.n.x, point.n.y, point.end.x, point.end.y, p[5], p[6]].join();
3253 if (!istotal && !subpath) {
3254 point = getPointAtSegmentLength(x, y, p[1], p[2], p[3], p[4], p[5], p[6], length - len);
3255 return {x: point.x, y: point.y, alpha: point.alpha};
3262 sp += p.shift() + p;
3265 point = istotal ? len : subpath ? subpaths : R.findDotsAtSegment(x, y, p[0], p[1], p[2], p[3], p[4], p[5], 1);
3266 point.alpha && (point = {x: point.x, y: point.y, alpha: point.alpha});
3270 var getTotalLength = getLengthFactory(1),
3271 getPointAtLength = getLengthFactory(),
3272 getSubpathsAtLength = getLengthFactory(0, 1);
3274 * Raphael.getTotalLength
3277 * Returns length of the given path in pixels.
3281 - path (string) SVG path string.
3285 R.getTotalLength = getTotalLength;
3287 * Raphael.getPointAtLength
3290 * Return coordinates of the point located at the given length on the given path.
3294 - path (string) SVG path string
3297 = (object) representation of the point:
3299 o x: (number) x coordinate
3300 o y: (number) y coordinate
3301 o alpha: (number) angle of derivative
3304 R.getPointAtLength = getPointAtLength;
3306 * Raphael.getSubpath
3309 * Return subpath of a given path from given length to given length.
3313 - path (string) SVG path string
3314 - from (number) position of the start of the segment
3315 - to (number) position of the end of the segment
3317 = (string) pathstring for the segment
3319 R.getSubpath = function (path, from, to) {
3320 if (this.getTotalLength(path) - to < 1e-6) {
3321 return getSubpathsAtLength(path, from).end;
3323 var a = getSubpathsAtLength(path, to, 1);
3324 return from ? getSubpathsAtLength(a, from).end : a;
3327 * Element.getTotalLength
3330 * Returns length of the path in pixels. Only works for element of “path” type.
3333 elproto.getTotalLength = function () {
3334 if (this.type != "path") {return;}
3335 if (this.node.getTotalLength) {
3336 return this.node.getTotalLength();
3338 return getTotalLength(this.attrs.path);
3341 * Element.getPointAtLength
3344 * Return coordinates of the point located at the given length on the given path. Only works for element of “path” type.
3350 = (object) representation of the point:
3352 o x: (number) x coordinate
3353 o y: (number) y coordinate
3354 o alpha: (number) angle of derivative
3357 elproto.getPointAtLength = function (length) {
3358 if (this.type != "path") {return;}
3359 return getPointAtLength(this.attrs.path, length);
3362 * Element.getSubpath
3365 * Return subpath of a given element from given length to given length. Only works for element of “path” type.
3369 - from (number) position of the start of the segment
3370 - to (number) position of the end of the segment
3372 = (string) pathstring for the segment
3374 elproto.getSubpath = function (from, to) {
3375 if (this.type != "path") {return;}
3376 return R.getSubpath(this.attrs.path, from, to);
3379 * Raphael.easing_formulas
3382 * Object that contains easing formulas for animation. You could extend it with your own. By default it has following list of easing:
3385 # <li>“<” or “easeIn” or “ease-in”</li>
3386 # <li>“>” or “easeOut” or “ease-out”</li>
3387 # <li>“<>” or “easeInOut” or “ease-in-out”</li>
3388 # <li>“backIn” or “back-in”</li>
3389 # <li>“backOut” or “back-out”</li>
3390 # <li>“elastic”</li>
3393 # <p>See also <a href="http://raphaeljs.com/easing.html">Easing demo</a>.</p>
3395 var ef = R.easing_formulas = {
3396 linear: function (n) {
3405 "<>": function (n) {
3406 var q = .48 - n / 1.04,
3407 Q = math.sqrt(.1734 + q * q),
3409 X = pow(abs(x), 1 / 3) * (x < 0 ? -1 : 1),
3411 Y = pow(abs(y), 1 / 3) * (y < 0 ? -1 : 1),
3413 return (1 - t) * 3 * t * t + t * t * t;
3415 backIn: function (n) {
3417 return n * n * ((s + 1) * n - s);
3419 backOut: function (n) {
3422 return n * n * ((s + 1) * n + s) + 1;
3424 elastic: function (n) {
3428 return pow(2, -10 * n) * math.sin((n - .075) * (2 * PI) / .3) + 1;
3430 bounce: function (n) {
3439 l = s * n * n + .75;
3441 if (n < (2.5 / p)) {
3443 l = s * n * n + .9375;
3446 l = s * n * n + .984375;
3453 ef.easeIn = ef["ease-in"] = ef["<"];
3454 ef.easeOut = ef["ease-out"] = ef[">"];
3455 ef.easeInOut = ef["ease-in-out"] = ef["<>"];
3456 ef["back-in"] = ef.backIn;
3457 ef["back-out"] = ef.backOut;
3459 var animationElements = [],
3460 requestAnimFrame = window.requestAnimationFrame ||
3461 window.webkitRequestAnimationFrame ||
3462 window.mozRequestAnimationFrame ||
3463 window.oRequestAnimationFrame ||
3464 window.msRequestAnimationFrame ||
3465 function (callback) {
3466 setTimeout(callback, 16);
3468 animation = function () {
3469 var Now = +new Date,
3471 for (; l < animationElements.length; l++) {
3472 var e = animationElements[l];
3473 if (e.el.removed || e.paused) {
3476 var time = Now - e.start,
3489 time = (e.initstatus * e.anim.top - e.prev) / (e.percent - e.prev) * ms;
3490 e.status = e.initstatus;
3491 delete e.initstatus;
3492 e.stop && animationElements.splice(l--, 1);
3494 e.status = (e.prev + (e.percent - e.prev) * (time / ms)) / e.anim.top;
3500 var pos = easing(time / ms);
3501 for (var attr in from) if (from[has](attr)) {
3502 switch (availableAnimAttrs[attr]) {
3504 now = +from[attr] + pos * ms * diff[attr];
3508 upto255(round(from[attr].r + pos * ms * diff[attr].r)),
3509 upto255(round(from[attr].g + pos * ms * diff[attr].g)),
3510 upto255(round(from[attr].b + pos * ms * diff[attr].b))
3515 for (var i = 0, ii = from[attr].length; i < ii; i++) {
3516 now[i] = [from[attr][i][0]];
3517 for (var j = 1, jj = from[attr][i].length; j < jj; j++) {
3518 now[i][j] = +from[attr][i][j] + pos * ms * diff[attr][i][j];
3520 now[i] = now[i].join(S);
3525 if (diff[attr].real) {
3527 for (i = 0, ii = from[attr].length; i < ii; i++) {
3528 now[i] = [from[attr][i][0]];
3529 for (j = 1, jj = from[attr][i].length; j < jj; j++) {
3530 now[i][j] = from[attr][i][j] + pos * ms * diff[attr][i][j];
3534 var get = function (i) {
3535 return +from[attr][i] + pos * ms * diff[attr][i];
3537 // now = [["r", get(2), 0, 0], ["t", get(3), get(4)], ["s", get(0), get(1), 0, 0]];
3538 now = [["m", get(0), get(1), get(2), get(3), get(4), get(5)]];
3542 if (attr == "clip-rect") {
3546 now[i] = +from[attr][i] + pos * ms * diff[attr][i];
3551 var from2 = [][concat](from[attr]);
3553 i = that.paper.customAttributes[attr].length;
3555 now[i] = +from2[i] + pos * ms * diff[attr][i];
3562 (function (id, that, anim) {
3563 setTimeout(function () {
3564 eve("anim.frame." + id, that, anim);
3566 })(that.id, that, e.anim);
3568 (function(f, el, a) {
3569 setTimeout(function() {
3570 eve("anim.frame." + el.id, el, a);
3571 eve("anim.finish." + el.id, el, a);
3572 R.is(f, "function") && f.call(el);
3574 })(e.callback, that, e.anim);
3576 animationElements.splice(l--, 1);
3577 if (e.repeat > 1 && !e.next) {
3578 for (key in to) if (to[has](key)) {
3579 init[key] = e.totalOrigin[key];
3582 runAnimation(e.anim, e.el, e.anim.percents[0], null, e.totalOrigin, e.repeat - 1);
3584 if (e.next && !e.stop) {
3585 runAnimation(e.anim, e.el, e.next, null, e.totalOrigin, e.repeat);
3589 R.svg && that && that.paper && that.paper.safari();
3590 animationElements.length && requestAnimFrame(animation);
3592 upto255 = function (color) {
3593 return color > 255 ? 255 : color < 0 ? 0 : color;
3596 * Element.animateWith
3599 * Acts similar to @Element.animate, but ensure that given animation runs in sync with another given element.
3603 - element (object) element to sync with
3604 - anim (object) animation to sync with
3605 - params (object) #optional final attributes for the element, see also @Element.attr
3606 - ms (number) #optional number of milliseconds for animation to run
3607 - easing (string) #optional easing type. Accept on of @Raphael.easing_formulas or CSS format: `cubic‐bezier(XX, XX, XX, XX)`
3608 - callback (function) #optional callback function. Will be called at the end of animation.
3610 - element (object) element to sync with
3611 - anim (object) animation to sync with
3612 - animation (object) #optional animation object, see @Raphael.animation
3614 = (object) original element
3616 elproto.animateWith = function (element, anim, params, ms, easing, callback) {
3617 var a = params ? R.animation(params, ms, easing, callback) : anim,
3618 status = element.status(anim);
3619 return this.animate(a).status(a, status * anim.ms / a.ms);
3621 function CubicBezierAtTime(t, p1x, p1y, p2x, p2y, duration) {
3623 bx = 3 * (p2x - p1x) - cx,
3626 by = 3 * (p2y - p1y) - cy,
3628 function sampleCurveX(t) {
3629 return ((ax * t + bx) * t + cx) * t;
3631 function solve(x, epsilon) {
3632 var t = solveCurveX(x, epsilon);
3633 return ((ay * t + by) * t + cy) * t;
3635 function solveCurveX(x, epsilon) {
3636 var t0, t1, t2, x2, d2, i;
3637 for(t2 = x, i = 0; i < 8; i++) {
3638 x2 = sampleCurveX(t2) - x;
3639 if (abs(x2) < epsilon) {
3642 d2 = (3 * ax * t2 + 2 * bx) * t2 + cx;
3643 if (abs(d2) < 1e-6) {
3658 x2 = sampleCurveX(t2);
3659 if (abs(x2 - x) < epsilon) {
3667 t2 = (t1 - t0) / 2 + t0;
3671 return solve(t, 1 / (200 * duration));
3673 elproto.onAnimation = function (f) {
3674 f ? eve.on("anim.frame." + this.id, f) : eve.unbind("anim.frame." + this.id);
3677 function Animation(anim, ms) {
3683 for (var attr in anim) if (anim[has](attr)) {
3684 newAnim[toFloat(attr)] = anim[attr];
3685 percents.push(toFloat(attr));
3687 percents.sort(sortByNumber);
3689 this.anim = newAnim;
3690 this.top = percents[percents.length - 1];
3691 this.percents = percents;
3697 * Creates a copy of existing animation object with given delay.
3701 - delay (number) number of ms to pass between animation start and actual animation
3703 = (object) new altered Animation object
3704 | var anim = Raphael.animation({cx: 10, cy: 20}, 2e3);
3705 | circle1.animate(anim); // run the given animation immediately
3706 | circle2.animate(anim.delay(500)); // run the given animation after 500 ms
3708 Animation.prototype.delay = function (delay) {
3709 var a = new Animation(this.anim, this.ms);
3710 a.times = this.times;
3711 a.del = +delay || 0;
3718 * Creates a copy of existing animation object with given repetition.
3722 - repeat (number) number iterations of animation. For infinite animation pass `Infinity`
3724 = (object) new altered Animation object
3726 Animation.prototype.repeat = function (times) {
3727 var a = new Animation(this.anim, this.ms);
3729 a.times = math.floor(mmax(times, 0)) || 1;
3732 function runAnimation(anim, element, percent, status, totalOrigin, times) {
3733 percent = toFloat(percent);
3746 for (i = 0, ii = animationElements.length; i < ii; i++) {
3747 var e = animationElements[i];
3748 if (e.el.id == element.id && e.anim == anim) {
3749 if (e.percent != percent) {
3750 animationElements.splice(i, 1);
3755 element.attr(e.totalOrigin);
3760 status = +to; // NaN
3762 for (var i = 0, ii = anim.percents.length; i < ii; i++) {
3763 if (anim.percents[i] == percent || anim.percents[i] > status * anim.top) {
3764 percent = anim.percents[i];
3765 prev = anim.percents[i - 1] || 0;
3766 ms = ms / anim.top * (percent - prev);
3767 next = anim.percents[i + 1];
3768 params = anim.anim[percent];
3770 } else if (status) {
3771 element.attr(anim.anim[anim.percents[i]]);
3778 for (var attr in params) if (params[has](attr)) {
3779 if (availableAnimAttrs[has](attr) || element.paper.customAttributes[has](attr)) {
3780 from[attr] = element.attr(attr);
3781 (from[attr] == null) && (from[attr] = availableAttrs[attr]);
3782 to[attr] = params[attr];
3783 switch (availableAnimAttrs[attr]) {
3785 diff[attr] = (to[attr] - from[attr]) / ms;
3788 from[attr] = R.getRGB(from[attr]);
3789 var toColour = R.getRGB(to[attr]);
3791 r: (toColour.r - from[attr].r) / ms,
3792 g: (toColour.g - from[attr].g) / ms,
3793 b: (toColour.b - from[attr].b) / ms
3797 var pathes = path2curve(from[attr], to[attr]),
3799 from[attr] = pathes[0];
3801 for (i = 0, ii = from[attr].length; i < ii; i++) {
3802 diff[attr][i] = [0];
3803 for (var j = 1, jj = from[attr][i].length; j < jj; j++) {
3804 diff[attr][i][j] = (toPath[i][j] - from[attr][i][j]) / ms;
3810 eq = equaliseTransform(_[attr], to[attr]);
3812 from[attr] = eq.from;
3815 diff[attr].real = true;
3816 for (i = 0, ii = from[attr].length; i < ii; i++) {
3817 diff[attr][i] = [from[attr][i][0]];
3818 for (j = 1, jj = from[attr][i].length; j < jj; j++) {
3819 diff[attr][i][j] = (to[attr][i][j] - from[attr][i][j]) / ms;
3823 var m = (element.matrix || new Matrix),
3825 _: {transform: _.transform},
3826 getBBox: function () {
3827 return element.getBBox(1);
3838 extractTransform(to2, to[attr]);
3839 to[attr] = to2._.transform;
3841 (to2.matrix.a - m.a) / ms,
3842 (to2.matrix.b - m.b) / ms,
3843 (to2.matrix.c - m.c) / ms,
3844 (to2.matrix.d - m.d) / ms,
3845 (to2.matrix.e - m.e) / ms,
3846 (to2.matrix.e - m.f) / ms
3848 // from[attr] = [_.sx, _.sy, _.deg, _.dx, _.dy];
3849 // var to2 = {_:{}, getBBox: function () { return element.getBBox(); }};
3850 // extractTransform(to2, to[attr]);
3852 // (to2._.sx - _.sx) / ms,
3853 // (to2._.sy - _.sy) / ms,
3854 // (to2._.deg - _.deg) / ms,
3855 // (to2._.dx - _.dx) / ms,
3856 // (to2._.dy - _.dy) / ms
3861 var values = Str(params[attr])[split](separator),
3862 from2 = Str(from[attr])[split](separator);
3863 if (attr == "clip-rect") {
3868 diff[attr][i] = (values[i] - from[attr][i]) / ms;
3874 values = [][concat](params[attr]);
3875 from2 = [][concat](from[attr]);
3877 i = element.paper.customAttributes[attr].length;
3879 diff[attr][i] = ((values[i] || 0) - (from2[i] || 0)) / ms;
3885 var easing = params.easing,
3886 easyeasy = R.easing_formulas[easing];
3888 easyeasy = Str(easing).match(bezierrg);
3889 if (easyeasy && easyeasy.length == 5) {
3890 var curve = easyeasy;
3891 easyeasy = function (t) {
3892 return CubicBezierAtTime(t, +curve[1], +curve[2], +curve[3], +curve[4], ms);
3898 timestamp = params.start || anim.start || +new Date;
3902 timestamp: timestamp,
3903 start: timestamp + (anim.del || 0),
3905 initstatus: status || 0,
3913 callback: params.callback,
3916 repeat: times || anim.times,
3917 origin: element.attr(),
3918 totalOrigin: totalOrigin
3920 animationElements.push(e);
3921 if (status && !isInAnim && !isInAnimSet) {
3923 e.start = new Date - ms * status;
3924 if (animationElements.length == 1) {
3929 e.start = new Date - e.ms * status;
3931 animationElements.length == 1 && requestAnimFrame(animation);
3933 isInAnim.initstatus = status;
3934 isInAnim.start = new Date - isInAnim.ms * status;
3936 eve("anim.start." + element.id, element, anim);
3942 * Creates an animation object that can be passed to the @Element.animate or @Element.animateWith methods.
3943 * See also @Animation.delay and @Animation.repeat methods.
3947 - params (object) final attributes for the element, see also @Element.attr
3948 - ms (number) number of milliseconds for animation to run
3949 - easing (string) #optional easing type. Accept one of @Raphael.easing_formulas or CSS format: `cubic‐bezier(XX, XX, XX, XX)`
3950 - callback (function) #optional callback function. Will be called at the end of animation.
3952 = (object) @Animation
3954 R.animation = function (params, ms, easing, callback) {
3955 if (params instanceof Animation) {
3958 if (R.is(easing, "function") || !easing) {
3959 callback = callback || easing || null;
3962 params = Object(params);
3967 for (attr in params) if (params[has](attr) && toFloat(attr) != attr && toFloat(attr) + "%" != attr) {
3969 p[attr] = params[attr];
3972 return new Animation(params, ms);
3974 easing && (p.easing = easing);
3975 callback && (p.callback = callback);
3976 return new Animation({100: p}, ms);
3983 * Creates and starts animation for given element.
3987 - params (object) final attributes for the element, see also @Element.attr
3988 - ms (number) number of milliseconds for animation to run
3989 - easing (string) #optional easing type. Accept one of @Raphael.easing_formulas or CSS format: `cubic‐bezier(XX, XX, XX, XX)`
3990 - callback (function) #optional callback function. Will be called at the end of animation.
3992 - animation (object) animation object, see @Raphael.animation
3994 = (object) original element
3996 elproto.animate = function (params, ms, easing, callback) {
3998 if (element.removed) {
3999 callback && callback.call(element);
4002 var anim = params instanceof Animation ? params : R.animation(params, ms, easing, callback);
4003 runAnimation(anim, element, anim.percents[0], null, element.attr());
4010 * Sets the status of animation of the element in milliseconds. Similar to @Element.status method.
4014 - anim (object) animation object
4015 - value (number) number of milliseconds from the beginning of the animation
4017 = (object) original element if `value` is specified
4018 * Note, that during animation following events are triggered:
4020 * On each animation frame event `anim.frame.<id>`, on start `anim.start.<id>` and on end `anim.finish.<id>`.
4022 elproto.setTime = function (anim, value) {
4023 if (anim && value != null) {
4024 this.status(anim, mmin(value, anim.ms) / anim.ms);
4032 * Gets or sets the status of animation of the element.
4036 - anim (object) #optional animation object
4037 - value (number) #optional 0 – 1. If specified, method works like a setter and sets the status of a given animation to the value. This will cause animation to jump to the given position.
4041 = (array) status if `anim` is not specified. Array of objects in format:
4043 o anim: (object) animation object
4044 o status: (number) status
4047 = (object) original element if `value` is specified
4049 elproto.status = function (anim, value) {
4054 if (value != null) {
4055 runAnimation(anim, this, -1, mmin(value, 1));
4058 len = animationElements.length;
4059 for (; i < len; i++) {
4060 e = animationElements[i];
4061 if (e.el.id == this.id && (!anim || e.anim == anim)) {
4081 * Stops animation of the element with ability to resume it later on.
4085 - anim (object) #optional animation object
4087 = (object) original element
4089 elproto.pause = function (anim) {
4090 for (var i = 0; i < animationElements.length; i++) if (animationElements[i].el.id == this.id && (!anim || animationElements[i].anim == anim)) {
4091 if (eve("anim.pause." + this.id, this, animationElements[i].anim) !== false) {
4092 animationElements[i].paused = true;
4101 * Resumes animation if it was paused with @Element.pause method.
4105 - anim (object) #optional animation object
4107 = (object) original element
4109 elproto.resume = function (anim) {
4110 for (var i = 0; i < animationElements.length; i++) if (animationElements[i].el.id == this.id && (!anim || animationElements[i].anim == anim)) {
4111 var e = animationElements[i];
4112 if (eve("anim.resume." + this.id, this, e.anim) !== false) {
4114 this.status(e.anim, e.status);
4123 * Stops animation of the element.
4127 - anim (object) #optional animation object
4129 = (object) original element
4131 elproto.stop = function (anim) {
4132 for (var i = 0; i < animationElements.length; i++) if (animationElements[i].el.id == this.id && (!anim || animationElements[i].anim == anim)) {
4133 if (eve("anim.stop." + this.id, this, animationElements[i].anim) !== false) {
4134 animationElements.splice(i--, 1);
4139 elproto.toString = function () {
4140 return "Rapha\xebl\u2019s object";
4144 var Set = function (items) {
4149 for (var i = 0, ii = items.length; i < ii; i++) {
4150 if (items[i] && (items[i].constructor == elproto.constructor || items[i].constructor == Set)) {
4151 this[this.items.length] = this.items[this.items.length] = items[i];
4157 setproto = Set.prototype;
4162 * Adds each argument to the current set.
4163 = (object) original element
4165 setproto.push = function () {
4168 for (var i = 0, ii = arguments.length; i < ii; i++) {
4169 item = arguments[i];
4170 if (item && (item.constructor == elproto.constructor || item.constructor == Set)) {
4171 len = this.items.length;
4172 this[len] = this.items[len] = item;
4182 * Removes last element and returns it.
4185 setproto.pop = function () {
4186 this.length && delete this[this.length--];
4187 return this.items.pop();
4193 * Executes given function for each element in the set.
4195 * If function returns `false` it will stop loop running.
4199 - callback (function) function to run
4200 - thisArg (object) context object for the callback
4201 = (object) Set object
4203 setproto.forEach = function (callback, thisArg) {
4204 for (var i = 0, ii = this.items.length; i < ii; i++) {
4205 if (callback.call(thisArg, this.items[i], i) === false) {
4211 for (var method in elproto) if (elproto[has](method)) {
4212 setproto[method] = (function (methodname) {
4213 return function () {
4214 var arg = arguments;
4215 return this.forEach(function (el) {
4216 el[methodname][apply](el, arg);
4221 setproto.attr = function (name, value) {
4222 if (name && R.is(name, array) && R.is(name[0], "object")) {
4223 for (var j = 0, jj = name.length; j < jj; j++) {
4224 this.items[j].attr(name[j]);
4227 for (var i = 0, ii = this.items.length; i < ii; i++) {
4228 this.items[i].attr(name, value);
4237 * Removeds all elements from the set
4239 setproto.clear = function () {
4240 while (this.length) {
4248 * Removes given element from the set
4252 - index (number) position of the deletion
4253 - count (number) number of element to remove
4254 - insertion… (object) #optional elements to insert
4255 = (object) set elements that were deleted
4257 setproto.splice = function (index, count, insertion) {
4258 index = index < 0 ? mmax(this.length + index, 0) : index;
4259 count = mmax(0, mmin(this.length - index, count));
4264 for (i = 2; i < arguments.length; i++) {
4265 args.push(arguments[i]);
4267 for (i = 0; i < count; i++) {
4268 todel.push(this[index + i]);
4270 for (; i < this.length - index; i++) {
4271 tail.push(this[index + i]);
4273 var arglen = args.length;
4274 for (i = 0; i < arglen + tail.length; i++) {
4275 this.items[index + i] = this[index + i] = i < arglen ? args[i] : tail[i - arglen];
4277 i = this.items.length = this.length -= count - arglen;
4281 return new Set(todel);
4287 * Removes given element from the set
4291 - element (object) element to remove
4292 = (boolean) `true` if object was found & removed from the set
4294 setproto.exclude = function (el) {
4295 for (var i = 0, ii = this.length; i < ii; i++) if (this[i] == el) {
4300 setproto.animate = function (params, ms, easing, callback) {
4301 (R.is(easing, "function") || !easing) && (callback = easing || null);
4302 var len = this.items.length,
4310 callback && (collector = function () {
4311 !--len && callback.call(set);
4313 easing = R.is(easing, string) ? easing : collector;
4314 var anim = R.animation(params, ms, easing, collector);
4315 item = this.items[--i].animate(anim);
4317 this.items[i] && !this.items[i].removed && this.items[i].animateWith(item, anim);
4321 setproto.insertAfter = function (el) {
4322 var i = this.items.length;
4324 this.items[i].insertAfter(el);
4328 setproto.getBBox = function () {
4333 for (var i = this.items.length; i--;) if (!this.items[i].removed) {
4334 var box = this.items[i].getBBox();
4337 w.push(box.x + box.width);
4338 h.push(box.y + box.height);
4340 x = mmin[apply](0, x);
4341 y = mmin[apply](0, y);
4345 width: mmax[apply](0, w) - x,
4346 height: mmax[apply](0, h) - y
4349 setproto.clone = function (s) {
4351 for (var i = 0, ii = this.items.length; i < ii; i++) {
4352 s.push(this.items[i].clone());
4356 setproto.toString = function () {
4357 return "Rapha\xebl\u2018s set";
4361 * Raphael.registerFont
4364 * Adds given font to the registered set of fonts for Raphaël. Should be used as an internal call from within Cufón’s font file.
4365 * Returns original parameter, so it could be used with chaining.
4366 # <a href="http://wiki.github.com/sorccu/cufon/about">More about Cufón and how to convert your font form TTF, OTF, etc to JavaScript file.</a>
4370 - font (object) the font to register
4371 = (object) the font you passed in
4373 | Cufon.registerFont(Raphael.registerFont({…}));
4375 R.registerFont = function (font) {
4379 this.fonts = this.fonts || {};
4385 family = font.face["font-family"];
4386 for (var prop in font.face) if (font.face[has](prop)) {
4387 fontcopy.face[prop] = font.face[prop];
4389 if (this.fonts[family]) {
4390 this.fonts[family].push(fontcopy);
4392 this.fonts[family] = [fontcopy];
4395 fontcopy.face["units-per-em"] = toInt(font.face["units-per-em"], 10);
4396 for (var glyph in font.glyphs) if (font.glyphs[has](glyph)) {
4397 var path = font.glyphs[glyph];
4398 fontcopy.glyphs[glyph] = {
4401 d: path.d && "M" + path.d.replace(/[mlcxtrv]/g, function (command) {
4402 return {l: "L", c: "C", x: "z", t: "m", r: "l", v: "c"}[command] || "M";
4406 for (var k in path.k) if (path[has](k)) {
4407 fontcopy.glyphs[glyph].k[k] = path.k[k];
4418 * Finds font object in the registered fonts by given parameters. You could specify only one word from the font name, like “Myriad” for “Myriad Pro”.
4422 - family (string) font family name or any word from it
4423 - weight (string) #optional font weight
4424 - style (string) #optional font style
4425 - stretch (string) #optional font stretch
4426 = (object) the font object
4428 | paper.print(100, 100, "Test string", paper.getFont("Times", 800), 30);
4430 paperproto.getFont = function (family, weight, style, stretch) {
4431 stretch = stretch || "normal";
4432 style = style || "normal";
4433 weight = +weight || {normal: 400, bold: 700, lighter: 300, bolder: 800}[weight] || 400;
4437 var font = R.fonts[family];
4439 var name = new RegExp("(^|\\s)" + family.replace(/[^\w\d\s+!~.:_-]/g, E) + "(\\s|$)", "i");
4440 for (var fontName in R.fonts) if (R.fonts[has](fontName)) {
4441 if (name.test(fontName)) {
4442 font = R.fonts[fontName];
4449 for (var i = 0, ii = font.length; i < ii; i++) {
4451 if (thefont.face["font-weight"] == weight && (thefont.face["font-style"] == style || !thefont.face["font-style"]) && thefont.face["font-stretch"] == stretch) {
4462 * Creates set of shapes to represent given font at given position with given size.
4463 * Result of the method is set object (see @Paper.set) which contains each letter as separate path object.
4467 - x (number) x position of the text
4468 - y (number) y position of the text
4469 - text (string) text to print
4470 - font (object) font object, see @Paper.getFont
4471 - size (number) #optional size of the font, default is `16`
4472 - origin (string) #optional could be `"baseline"` or `"middle"`, default is `"middle"`
4473 - letter_spacing (number) #optional number in range `-1..1`, default is `0`
4474 = (object) resulting set of letters
4476 | var txt = r.print(10, 50, "print", r.getFont("Museo"), 30).attr({fill: "#fff"});
4477 | // following line will paint first letter in red
4478 | txt[0].attr({fill: "#f00"});
4480 paperproto.print = function (x, y, string, font, size, origin, letter_spacing) {
4481 origin = origin || "middle"; // baseline|middle
4482 letter_spacing = mmax(mmin(letter_spacing || 0, 1), -1);
4483 var out = this.set(),
4484 letters = Str(string)[split](E),
4488 R.is(font, string) && (font = this.getFont(font));
4490 scale = (size || 16) / font.face["units-per-em"];
4491 var bb = font.face.bbox[split](separator),
4493 height = +bb[1] + (origin == "baseline" ? bb[3] - bb[1] + (+font.face.descent) : (bb[3] - bb[1]) / 2);
4494 for (var i = 0, ii = letters.length; i < ii; i++) {
4495 var prev = i && font.glyphs[letters[i - 1]] || {},
4496 curr = font.glyphs[letters[i]];
4497 shift += i ? (prev.w || font.w) + (prev.k && prev.k[letters[i]] || 0) + (font.w * letter_spacing) : 0;
4498 curr && curr.d && out.push(this.path(curr.d).attr({
4501 transform: [["t", shift * scale, 0]]
4504 out.transform(["...s", scale, scale, top, height, "t", (x - top) / scale, (y - height) / scale]);
4513 * Imports elements in JSON array in format `{type: type, <attributes>}`
4518 = (object) resulting set of imported elements
4537 paperproto.add = function (json) {
4538 if (R.is(json, "array")) {
4539 var res = this.set(),
4543 for (; i < ii; i++) {
4545 elements[has](j.type) && res.push(this[j.type]().attr(j));
4555 * Simple format function. Replaces construction of type “`{<number>}`” to the corresponding argument.
4559 - token (string) string to format
4560 - … (string) rest of arguments will be treated as parameters for replacement
4561 = (string) formated string
4567 | // this will draw a rectangular shape equivalent to "M10,20h40v50h-40z"
4568 | paper.path(Raphael.format("M{0},{1}h{2}v{3}h{4}z", x, y, width, height, -width));
4570 R.format = function (token, params) {
4571 var args = R.is(params, array) ? [0][concat](params) : arguments;
4572 token && R.is(token, string) && args.length - 1 && (token = token.replace(formatrg, function (str, i) {
4573 return args[++i] == null ? E : args[i];
4581 * A little bit more advanced format function than @Raphael.format. Replaces construction of type “`{<name>}`” to the corresponding argument.
4585 - token (string) string to format
4586 - json (object) object which properties will be used as a replacement
4587 = (string) formated string
4589 | // this will draw a rectangular shape equivalent to "M10,20h40v50h-40z"
4590 | paper.path(Raphael.format("M{x},{y}h{dim.width}v{dim.height}h{dim['negative width']}z", {
4596 | "negative width": -40
4600 R.fullfill = (function () {
4601 var tokenRegex = /\{([^\}]+)\}/g,
4602 objNotationRegex = /(?:(?:^|\.)(.+?)(?=\[|\.|$|\()|\[('|")(.+?)\2\])(\(\))?/g, // matches .xxxxx or ["xxxxx"] to run over object properties
4603 replacer = function (all, key, obj) {
4605 key.replace(objNotationRegex, function (all, name, quote, quotedName, isFunc) {
4606 name = name || quotedName;
4611 typeof res == "function" && isFunc && (res = res());
4614 res = (res == null || res == obj ? all : res) + "";
4617 return function (str, obj) {
4618 return String(str).replace(tokenRegex, function (all, key) {
4619 return replacer(all, key, obj);
4627 * If you want to leave no trace of Raphaël (Well, Raphaël creates only one global variable `Raphael`, but anyway.) You can use `ninja` method.
4628 * Beware, that in this case plugins could stop working, because they are depending on global variable existance.
4630 = (object) Raphael object
4632 | (function (local_raphael) {
4633 | var paper = local_raphael(10, 10, 320, 200);
4635 | })(Raphael.ninja());
4637 R.ninja = function () {
4638 oldRaphael.was ? (g.win.Raphael = oldRaphael.is) : delete Raphael;
4643 [ property (object) ]
4645 * You can add your own method to elements and sets. It is wise to add a set method for each element method
4646 * you added, so you will be able to call the same method on sets too.
4648 * See also @Raphael.el.
4650 | Raphael.el.red = function () {
4651 | this.attr({fill: "#f00"});
4653 | Raphael.st.red = function () {
4654 | this.forEach(function () {
4659 | paper.set(paper.circle(100, 100, 20), paper.circle(110, 100, 20)).red();
4662 // Firefox <3.6 fix: http://webreflection.blogspot.com/2009/11/195-chars-to-help-lazy-loading.html
4663 (function (doc, loaded, f) {
4664 if (doc.readyState == null && doc.addEventListener){
4665 doc.addEventListener(loaded, f = function () {
4666 doc.removeEventListener(loaded, f, false);
4667 doc.readyState = "complete";
4669 doc.readyState = "loading";
4671 function isLoaded() {
4672 (/in/).test(doc.readyState) ? setTimeout(isLoaded, 9) : R.eve("DOMload");
4675 })(document, "DOMContentLoaded");
4677 oldRaphael.was ? (g.win.Raphael = R) : (Raphael = R);
4679 eve.on("DOMload", function () {