rgraph-rails 5.00 → 6.14

data/vendor/assets/javascripts/RGraph.drawing.image.js

@@ -1,53 +1,858 @@
+'version:2023-09-16 (6.14)';
+//
+    // o--------------------------------------------------------------------------------o
+    // | This file is part of the RGraph package - you can learn more at:               |
+    // |                                                                                |
+    // |                         https://www.rgraph.net                                 |
+    // |                                                                                |
+    // | RGraph is licensed under the Open Source MIT license. That means that it's     |
+    // | totally free to use and there are no restrictions on what you can do with it!  |
+    // o--------------------------------------------------------------------------------o
+    
+    //
+    // Having this here means that the RGraph libraries can be included in any order, instead of you having
+    // to include the common core library first.
+    //
 
-RGraph=window.RGraph||{isRGraph:true};RGraph.Drawing=RGraph.Drawing||{};RGraph.Drawing.Image=function(conf)
-{if(typeof conf==='object'&&typeof conf.x==='number'&&typeof conf.y==='number'&&typeof conf.src==='string'&&typeof conf.id==='string'){var id=conf.id,canvas=document.getElementById(id),x=conf.x,y=conf.y,src=conf.src,parseConfObjectForOptions=true;}else{var id=conf,canvas=document.getElementById(id),x=arguments[1],y=arguments[2],src=arguments[3];}
-this.id=id;this.canvas=document.getElementById(this.id);this.context=this.canvas.getContext('2d');this.colorsParsed=false;this.canvas.__object__=this;this.alignmentProcessed=false;this.original_colors=[];this.firstDraw=true;this.propertyNameAliases={};this.x=x;this.y=y;this.src=src;this.img=new Image();this.img.src=this.src;this.type='drawing.image';this.isRGraph=true;this.uid=RGraph.createUID();this.canvas.uid=this.canvas.uid?this.canvas.uid:RGraph.CreateUID();this.properties={'chart.src':null,'chart.width':null,'chart.height':null,'chart.halign':'left','chart.valign':'top','chart.events.mousemove':null,'chart.events.click':null,'chart.shadow':false,'chart.shadow.color':'gray','chart.shadow.offsetx':3,'chart.shadow.offsety':3,'chart.shadow.blur':5,'chart.tooltips':null,'chart.tooltips.highlight':true,'chart.tooltips.css.class':'RGraph_tooltip','chart.tooltips.event':'onclick','chart.highlight.stroke':'rgba(0,0,0,0)','chart.highlight.fill':'rgba(255,255,255,0.7)','chart.colors.alpha':1,'chart.border':false,'chart.border.color':'black','chart.border.linewidth':1,'chart.border.radius':0,'chart.background.color':'rgba(0,0,0,0)','chart.clearto':'rgba(0,0,0,0)'}
-if(!this.canvas){alert('[DRAWING.IMAGE] No canvas support');return;}
-this.coords=[];this.$0={};if(!this.canvas.__rgraph_aa_translated__){this.context.translate(0.5,0.5);this.canvas.__rgraph_aa_translated__=true;}
-var RG=RGraph,ca=this.canvas,co=ca.getContext('2d'),prop=this.properties,pa2=RG.path2,win=window,doc=document,ma=Math
-if(RG.Effects&&typeof RG.Effects.decorate==='function'){RG.Effects.decorate(this);}
-this.set=this.Set=function(name)
-{var value=typeof arguments[1]==='undefined'?null:arguments[1];if(arguments.length===1&&typeof name==='object'){RG.parseObjectStyleConfig(this,name);return this;}
-if(name.substr(0,6)!='chart.'){name='chart.'+name;}
-while(name.match(/([A-Z])/)){name=name.replace(/([A-Z])/,'.'+RegExp.$1.toLowerCase());}
-prop[name]=value;return this;};this.get=this.Get=function(name)
-{if(name.substr(0,6)!='chart.'){name='chart.'+name;}
-while(name.match(/([A-Z])/)){name=name.replace(/([A-Z])/,'.'+RegExp.$1.toLowerCase());}
-return prop[name.toLowerCase()];};this.draw=this.Draw=function()
-{RG.fireCustomEvent(this,'onbeforedraw');var obj=this;this.img.onload=function()
-{if(!obj.colorsParsed){obj.parseColors();obj.colorsParsed=true;}
-obj.width=this.width;obj.height=this.height;if(!this.alignmentProcessed){var customWidthHeight=(typeof obj.properties['chart.width']=='number'&&typeof obj.properties['chart.width']=='number');if(obj.properties['chart.halign']==='center'){obj.x-=customWidthHeight?(obj.properties['chart.width']/2):(this.width/2);}else if(obj.properties['chart.halign']=='right'){obj.x-=customWidthHeight?obj.properties['chart.width']:this.width;}
-if(obj.properties['chart.valign']==='center'){obj.y-=customWidthHeight?(obj.properties['chart.height']/2):(this.height/2);}else if(obj.properties['chart.valign']=='bottom'){obj.y-=customWidthHeight?obj.properties['chart.height']:this.height;}
-this.alignmentProcessed=true;}}
-if(this.img.complete||this.img.readyState===4){this.img.onload();}
-if(prop['chart.shadow']){RG.setShadow(this,prop['chart.shadow.color'],prop['chart.shadow.offsetx'],prop['chart.shadow.offsety'],prop['chart.shadow.blur']);}
-var oldAlpha=co.globalAlpha;co.globalAlpha=prop['chart.colors.alpha'];if(prop['chart.border']){co.strokeStyle=prop['chart.border.color'];co.lineWidth=prop['chart.border.linewidth'];var borderRadius=0;if(this.width||this.height){borderRadius=ma.min(this.width/2,this.height/2)}
-if((prop['chart.width']/2)>borderRadius&&(prop['chart.height']/2)>borderRadius){borderRadius=ma.min((prop['chart.width']/2),(prop['chart.height']/2))}
-if(prop['chart.border.radius']<borderRadius){borderRadius=prop['chart.border.radius'];}
-co.beginPath();this.roundedRect(ma.round(this.x)-ma.round(co.lineWidth/2),ma.round(this.y)-ma.round(co.lineWidth/2),(prop['chart.width']||this.img.width)+co.lineWidth,(prop['chart.height']||this.img.height)+co.lineWidth,borderRadius);}
-if(borderRadius){co.save();this.drawBackgroundColor(borderRadius);co.beginPath();this.roundedRect(ma.round(this.x)-ma.round(co.lineWidth/2),ma.round(this.y)-ma.round(co.lineWidth/2),(prop['chart.width']||this.img.width)+co.lineWidth,(prop['chart.height']||this.img.height)+co.lineWidth,borderRadius);co.clip();}else{this.drawBackgroundColor(0);}
-if(typeof prop['chart.height']==='number'||typeof prop['chart.width']==='number'){co.drawImage(this.img,ma.round(this.x),ma.round(this.y),prop['chart.width']||this.width,prop['chart.height']||this.height);}else{co.drawImage(this.img,ma.round(this.x),ma.round(this.y));}
-if(borderRadius){co.restore();}
-RG.noShadow(this);if(prop['chart.border']){co.stroke();}
-co.globalAlpha=oldAlpha;this.img.onload=function()
-{RG.redrawCanvas(ca);obj.coords[0]=[ma.round(obj.x),ma.round(obj.y),typeof prop['chart.width']==='number'?prop['chart.width']:this.width,typeof prop['chart.height']=='number'?prop['chart.height']:this.height];}
-RG.noShadow(this);RG.installEventListeners(this);if(this.firstDraw){this.firstDraw=false;RG.fireCustomEvent(this,'onfirstdraw');this.firstDrawFunc();}
-RG.fireCustomEvent(this,'ondraw');return this;};this.exec=function(func)
-{func(this);return this;};this.getObjectByXY=function(e)
-{var mouseXY=RG.getMouseXY(e);if(this.getShape(e)){return this;}};this.getShape=function(e)
-{var mouseXY=RG.getMouseXY(e),mouseX=mouseXY[0],mouseY=mouseXY[1];if(this.coords&&this.coords[0]&&mouseXY[0]>=this.coords[0][0]&&mouseXY[0]<=(this.coords[0][0]+this.coords[0][2])&&mouseXY[1]>=this.coords[0][1]&&mouseXY[1]<=(this.coords[0][1]+this.coords[0][3])){return{0:this,1:this.coords[0][0],2:this.coords[0][1],3:this.coords[0][2],4:this.coords[0][3],5:0,'object':this,'x':this.coords[0][0],'y':this.coords[0][1],'width':this.coords[0][2],'height':this.coords[0][3],'index':0,'tooltip':prop['chart.tooltips']?prop['chart.tooltips'][0]:null};}
-return null;};this.highlight=this.Highlight=function(shape)
-{if(prop['chart.tooltips.highlight']){if(typeof prop['chart.highlight.style']==='function'){(prop['chart.highlight.style'])(shape);}else{pa2(co,['b','r',this.coords[0][0],this.coords[0][1],this.coords[0][2],this.coords[0][3],'f',prop['chart.highlight.fill'],'s',prop['chart.highlight.stroke']]);}}};this.parseColors=function()
-{if(this.original_colors.length===0){this.original_colors['chart.colors.background']=RG.arrayClone(prop['chart.colors.background']);this.original_colors['chart.highlight.stroke']=RG.arrayClone(prop['chart.highlight.stroke']);this.original_colors['chart.highlight.fill']=RG.arrayClone(prop['chart.highlight.fill']);}
-prop['chart.colors.background']=this.parseSingleColorForGradient(prop['chart.colors.background']);prop['chart.highlight.stroke']=this.parseSingleColorForGradient(prop['chart.highlight.stroke']);prop['chart.highlight.fill']=this.parseSingleColorForGradient(prop['chart.highlight.fill']);};this.reset=function()
-{};this.parseSingleColorForGradient=function(color)
-{if(!color){return color;}
-if(typeof color==='string'&&color.match(/^gradient\((.*)\)$/i)){if(color.match(/^gradient\(({.*})\)$/i)){return RGraph.parseJSONGradient({object:this,def:RegExp.$1});}
-var parts=RegExp.$1.split(':'),grad=co.createLinearGradient(this.x,this.y,this.x+this.img.width,this.y),diff=1/(parts.length-1);grad.addColorStop(0,RG.trim(parts[0]));for(var j=1;j<parts.length;++j){grad.addColorStop(j*diff,RG.trim(parts[j]));}}
-return grad?grad:color;};this.on=function(type,func)
-{if(type.substr(0,2)!=='on'){type='on'+type;}
-if(typeof this[type]!=='function'){this[type]=func;}else{RG.addCustomEventListener(this,type,func);}
-return this;};this.firstDrawFunc=function()
-{};this.roundedRect=function(x,y,width,height,radius)
-{co.save();co.translate(x,y);co.moveTo(width/2,0);co.arcTo(width,0,width,height,ma.min(height/2,radius));co.arcTo(width,height,0,height,ma.min(width/2,radius));co.arcTo(0,height,0,0,ma.min(height/2,radius));co.arcTo(0,0,radius,0,ma.min(width/2,radius));co.lineTo(width/2,0);co.restore();};this.drawBackgroundColor=function(borderRadius)
-{co.beginPath();co.fillStyle=prop['chart.background.color'];this.roundedRect(ma.round(this.x)-ma.round(co.lineWidth/2),ma.round(this.y)-ma.round(co.lineWidth/2),(prop['chart.width']||this.img.width)+co.lineWidth,(prop['chart.height']||this.img.height)+co.lineWidth,borderRadius);co.fill();};RG.register(this);if(parseConfObjectForOptions){RG.parseObjectStyleConfig(this,conf.options);}};
+    // Define the RGraph global variable
+    RGraph = window.RGraph || {isrgraph:true,isRGraph: true,rgraph:true};
+    RGraph.Drawing = RGraph.Drawing || {};
+
+    //
+    // The constructor. This function sets up the object.
+    //
+    RGraph.Drawing.Image = function (conf)
+    {
+        var id     = conf.id,
+            canvas = document.getElementById(id),
+            x      = conf.x,
+            y      = conf.y,
+            src    = conf.src;
+
+        // id, x, y
+        this.id                 = id;
+        this.canvas             = document.getElementById(this.id);
+        this.context            = this.canvas.getContext('2d');
+        this.colorsParsed       = false;
+        this.canvas.__object__  = this;
+        this.alignmentProcessed = false;
+        this.original_colors    = [];
+        this.firstDraw         = true; // After the first draw this will be false
+
+        //
+        // Store the properties
+        //
+        this.x   = x;
+        this.y   = y;
+        this.src = src;
+        this.img = new Image();
+        this.img.src = this.src;
+
+
+        //
+        // This defines the type of this shape
+        //
+        this.type = 'drawing.image';
+
+
+        //
+        // This facilitates easy object identification, and should always be true
+        //
+        this.isRGraph = true;
+        this.isrgraph = true;
+        this.rgraph   = true;
+
+
+        //
+        // This adds a uid to the object that you can use for identification purposes
+        //
+        this.uid = RGraph.createUID();
+
+
+        //
+        // This adds a UID to the canvas for identification purposes
+        //
+        this.canvas.uid = this.canvas.uid ? this.canvas.uid : RGraph.createUID();
+
+
+
+
+        //
+        // Some example background properties
+        //
+        this.properties =
+        {
+            src:              null,
+
+            width:            null,
+            height:           null,
+
+            halign:           'left',
+            valign:           'top',
+
+            shadow:           false,
+            shadowColor:     'gray',
+            shadowOffsetx:   3,
+            shadowOffsety:   3,
+            shadowBlur:      5,
+
+            tooltips:                   null,
+            tooltipsHighlight:          true,
+            tooltipsCssClass:           'RGraph_tooltip',
+            tooltipsCss:                null,
+            tooltipsEffect:             'slide',
+            tooltipsEvent:              'onclick',
+            tooltipsFormattedPoint:     '.',
+            tooltipsFormattedThousand:  ',',
+            tooltipsFormattedDecimals:  0,
+            tooltipsFormattedUnitsPre:  '',
+            tooltipsFormattedUnitsPost: '',
+            tooltipsFormattedListType:  'ul',
+            tooltipsFormattedListItems: null,
+            tooltipsPointer:            true,
+            tooltipsPointerOffsetx:     0,
+            tooltipsPointerOffsety:     0,
+            tooltipsPositionStatic:     true,
+
+            highlightStroke:     'rgba(0,0,0,0)',
+            highlightFill:       'rgba(255,255,255,0.7)',
+
+            colorsAlpha:         1,
+
+            border:               false,
+            borderColor:         'black',
+            borderLinewidth:     1,
+            borderRadius:        0,
+
+            backgroundColor:     'rgba(0,0,0,0)',
+
+            text:                null,
+
+            clearto:   'rgba(0,0,0,0)'
+        }
+
+        //
+        // A simple check that the browser has canvas support
+        //
+        if (!this.canvas) {
+            alert('[DRAWING.IMAGE] No canvas support');
+            return;
+        }
+        
+        //
+        // This can be used to store the coordinates of shapes on the graph
+        //
+        this.coords = [];
+
+
+        //
+        // Create the dollar object so that functions can be added to them
+        //
+        this.$0 = {};
+
+
+
+
+        // Easy access to  properties and the path function
+        var properties = this.properties;
+        this.path      = RGraph.pathObjectFunction;
+
+        //
+        // "Decorate" the object with the generic effects if the effects library has been included
+        //
+        if (RGraph.Effects && typeof RGraph.Effects.decorate === 'function') {
+            RGraph.Effects.decorate(this);
+        }
+
+
+
+        //
+        // A setter method for setting graph properties. It can be used like this: obj.set('colorsStroke', '#666');
+        // 
+        // @param name  string The name of the property to set OR it can be a map
+        //                     of name/value settings like what you set in the constructor
+        //
+        this.set = function (name)
+        {
+            var value = typeof arguments[1] === 'undefined' ? null : arguments[1];
+
+            // the number of arguments is only one and it's an
+            // object - parse it for configuration data and return.
+            if (arguments.length === 1 && typeof arguments[0] === 'object') {
+                for (i in arguments[0]) {
+                    if (typeof i === 'string') {
+                        this.set(i, arguments[0][i]);
+                    }
+                }
+
+                return this;
+            }
+
+            properties[name] = value;
+
+            return this;
+        };
+
+
+
+
+
+
+
+
+        //
+        // A getter method for retrieving graph properties. It can be used like this: obj.get('colorsStroke');
+        // 
+        // @param name  string The name of the property to get
+        //
+        this.get = function (name)
+        {
+            return properties[name];
+        };
+
+
+
+
+
+
+
+
+        //
+        // Draws the circle
+        //
+        this.draw = function ()
+        {
+            //
+            // Fire the onbeforedraw event
+            //
+            RGraph.fireCustomEvent(this, 'onbeforedraw');
+
+            // Translate half a pixel for antialiasing purposes - but only if it hasn't been
+            // done already
+            //
+            // MUST be the first thing done!
+            //
+            if (!this.canvas.__rgraph_aa_translated__) {
+                this.context.translate(0.5,0.5);
+            
+                this.canvas.__rgraph_aa_translated__ = true;
+            }
+    
+
+            //
+            // Parse the colors. This allows for simple gradient syntax
+            //
+            var obj = this;
+            this.img.onload = function ()
+            {
+                if (!obj.colorsParsed) {
+    
+                    obj.parseColors();
+        
+                    // Don't want to do this again
+                    obj.colorsParsed = true;
+                }
+                
+                obj.width  = this.width;
+                obj.height = this.height;
+
+    
+    
+    
+    
+    
+    
+                if (!obj.alignmentProcessed) {
+                
+                    var customWidthHeight = (typeof obj.properties.width == 'number' && typeof obj.properties.width == 'number');
+
+                    // Horizontal alignment
+                    if (obj.properties.halign === 'center') {
+                        obj.x -= customWidthHeight ? (obj.properties.width / 2) : (this.width / 2);
+                    } else if (obj.properties.halign == 'right') {
+                        obj.x -= customWidthHeight ? obj.properties.width : this.width;
+                    }
+                    
+                    // Vertical alignment
+                    if (obj.properties.valign === 'center') {
+                        obj.y -= customWidthHeight ? (obj.properties.height / 2) : (this.height / 2);
+                    } else if (obj.properties.valign == 'bottom') {
+                        obj.y -= customWidthHeight ? obj.properties.height : this.height;
+                    }
+                    
+                    // Don't do this again
+                    obj.alignmentProcessed = true;
+                }
+            }
+    
+    
+    
+    
+    
+    
+    
+            
+            // The onload event doesn't always fire - so call it manually as well
+            if (this.img.complete || this.img.readyState === 4) {
+                this.img.onload();
+            }
+    
+    
+            //
+            // Draw the image here
+            //
+            
+            if (properties.shadow) {
+                RGraph.setShadow(
+                    this,
+                    properties.shadowColor,
+                    properties.shadowOffsetx,
+                    properties.shadowOffsety,
+                    properties.shadowBlur
+                );
+            }
+
+            var oldAlpha = this.context.globalAlpha;
+            this.context.globalAlpha = properties.colorsAlpha;
+
+
+
+
+
+                //
+                // Draw a border around the image
+                //
+                if (properties.border) {
+                    
+                    this.context.strokeStyle = properties.borderColor;
+                    this.context.lineWidth   = properties.borderLinewidth;
+                    
+                    var borderRadius = 0;
+                    
+                    // Work out the borderRadius only if the image has been loaded
+                    if (this.width || this.height) {
+                        borderRadius = Math.min(this.width / 2, this.height / 2)
+                    }
+                    
+                    if ((properties.width / 2) > borderRadius && (properties.height / 2) > borderRadius) {
+                        borderRadius = Math.min((properties.width / 2), (properties.height / 2))
+                    }
+                    
+                    if (properties.borderRadius < borderRadius) {
+                        borderRadius = properties.borderRadius;
+                    }
+                
+                
+                
+                
+                    this.context.beginPath();
+                    this.roundedRect(
+                        Math.round(this.x) - Math.round(this.context.lineWidth / 2),
+                        Math.round(this.y) - Math.round(this.context.lineWidth / 2),
+                        (properties.width || this.img.width) + this.context.lineWidth,
+                        (properties.height || this.img.height) + this.context.lineWidth,
+                        borderRadius
+                    );
+                }
+                
+                
+                
+                if (borderRadius) {
+                    this.context.save();
+
+                    // Draw the rect that casts the shadow
+
+                    // Draw the background color
+                    this.drawBackgroundColor(borderRadius);
+
+
+
+                    // Clip the canvas
+                    this.context.beginPath();
+                    this.roundedRect(
+                        Math.round(this.x) - Math.round(this.context.lineWidth / 2),
+                        Math.round(this.y) - Math.round(this.context.lineWidth / 2),
+                        (properties.width || this.img.width) + this.context.lineWidth,
+                        (properties.height || this.img.height) + this.context.lineWidth,
+                        borderRadius
+                    );
+                    this.context.clip();
+                
+                } else {
+                
+                    // Draw the background color
+                    this.drawBackgroundColor(0);
+                }
+
+
+                if (typeof properties.height === 'number' || typeof properties.width === 'number') {
+                    this.context.drawImage(
+                        this.img,
+                        Math.round(this.x),
+                        Math.round(this.y),
+                        properties.width || this.width,
+                        properties.height || this.height
+                    );
+                } else {
+                    this.context.drawImage(
+                        this.img,
+                        Math.round(this.x),
+                        Math.round(this.y)
+                    );
+                }
+
+
+
+
+                // If borderRadius is enabled restore the canvas to it's pre-clipped state
+                if (borderRadius) {
+                    this.context.restore();
+                }
+                
+                RGraph.noShadow(this);
+                
+                
+        
+                // If the border is enabled need a stroke so that the border is drawn
+                if (properties.border) {
+                    this.context.stroke();
+                }
+
+
+
+
+
+            this.context.globalAlpha = oldAlpha;
+    
+            var obj    = this;    
+            this.img.onload = function ()
+            {
+                RGraph.redrawCanvas(obj.canvas);
+                
+                obj.coords[0] = [
+                    Math.round(obj.x),
+                    Math.round(obj.y),
+                    typeof properties.width === 'number' ? properties.width : this.width, typeof properties.height == 'number' ? properties.height : this.height
+                ];
+            }
+            
+            RGraph.noShadow(this);
+
+
+
+
+            //
+            // Add custom text thats specified
+            //
+            RGraph.addCustomText(this);
+
+
+
+
+    
+    
+            //
+            // This installs the event listeners
+            //
+            RGraph.installEventListeners(this);
+    
+
+            //
+            // Fire the onfirstdraw event
+            //
+            if (this.firstDraw) {
+                this.firstDraw = false;
+                RGraph.fireCustomEvent(this, 'onfirstdraw');
+                this.firstDrawFunc();
+            }
+
+
+
+
+            //
+            // Fire the draw event
+            //
+            RGraph.fireCustomEvent(this, 'ondraw');
+
+            return this;
+        };
+
+
+
+
+
+
+
+
+        //
+        // Used in chaining. Runs a function there and then - not waiting for
+        // the events to fire (eg the onbeforedraw event)
+        // 
+        // @param function func The function to execute
+        //
+        this.exec = function (func)
+        {
+            func(this);
+            
+            return this;
+        };
+
+
+
+
+
+
+
+
+        //
+        // The getObjectByXY() worker method
+        //
+        this.getObjectByXY = function (e)
+        {
+            var mouseXY = RGraph.getMouseXY(e);
+    
+            if (this.getShape(e)) {
+                return this;
+            }
+        };
+
+
+
+
+
+
+
+
+        //
+        // Not used by the class during creating the shape, but is used by event handlers
+        // to get the coordinates (if any) of the selected bar
+        // 
+        // @param object e The event object
+        // @param object   OPTIONAL You can pass in the bar object instead of the
+        //                          function using "this"
+        //
+        this.getShape = function (e)
+        {
+            var mouseXY = RGraph.getMouseXY(e),
+                mouseX  = mouseXY[0],
+                mouseY  = mouseXY[1];
+    
+            if (   this.coords
+                && this.coords[0]
+                && mouseXY[0] >= this.coords[0][0]
+                && mouseXY[0] <= (this.coords[0][0] + this.coords[0][2])
+                && mouseXY[1] >= this.coords[0][1]
+                && mouseXY[1] <= (this.coords[0][1] + this.coords[0][3])) {
+                
+                if (RGraph.parseTooltipText && properties.tooltips) {
+                    var tooltip = RGraph.parseTooltipText(properties.tooltips, 0);
+                }
+                
+                return {
+                    object: this,
+                         x: this.coords[0][0],
+                         y: this.coords[0][1],
+                     width: this.coords[0][2],
+                    height: this.coords[0][3],
+                   dataset: 0,
+                     index: 0,
+           sequentialIndex: 0,
+                   tooltip: typeof tooltip === 'string' ? tooltip : null
+                };
+            }
+            
+            return null;
+        };
+
+
+
+
+
+
+
+
+        //
+        // Each object type has its own Highlight() function which highlights the appropriate shape
+        // 
+        // @param object shape The shape to highlight
+        //
+        this.highlight = function (shape)
+        {
+            if (properties.tooltipsHighlight) {
+                if (typeof properties.highlightStyle === 'function') {
+                    (properties.highlightStyle)(shape);
+                } else {
+                    this.path(
+                        'b r % % % % f % s %',
+                        this.coords[0][0],this.coords[0][1],this.coords[0][2],this.coords[0][3],
+                        properties.highlightFill, properties.highlightStroke
+                    );
+                }
+            }
+        };
+
+
+
+
+
+
+
+
+        //
+        // This allows for easy specification of gradients
+        //
+        this.parseColors = function ()
+        {
+            // Save the original colors so that they can be restored when the canvas is reset
+            if (this.original_colors.length === 0) {
+                this.original_colors.colorsBackground = RGraph.arrayClone(properties.colorsBackground);
+                this.original_colors.highlightStroke  = RGraph.arrayClone(properties.highlightStroke);
+                this.original_colors.highlightFill    = RGraph.arrayClone(properties.highlightFill);
+            }
+
+
+
+
+            //
+            // Parse various properties for colors
+            //
+            properties.colorsBackground = this.parseSingleColorForGradient(properties.colorsBackground);
+            properties.highlightStroke  = this.parseSingleColorForGradient(properties.highlightStroke);
+            properties.highlightFill    = this.parseSingleColorForGradient(properties.highlightFill);
+        };
+
+
+
+
+
+
+
+
+        //
+        // Use this function to reset the object to the post-constructor state. Eg reset colors if
+        // need be etc
+        //
+        this.reset = function ()
+        {
+        };
+
+
+
+
+
+
+
+
+        //
+        // This parses a single color value
+        //
+        this.parseSingleColorForGradient = function (color)
+        {
+            if (!color) {
+                return color;
+            }
+    
+
+            if (typeof color === 'string' && color.match(/^gradient\((.*)\)$/i)) {
+
+                // Allow for JSON gradients
+                if (color.match(/^gradient\(({.*})\)$/i)) {
+                    return RGraph.parseJSONGradient({object: this, def: RegExp.$1});
+                }
+
+                var parts = RegExp.$1.split(':'),
+                    grad  = this.context.createLinearGradient(this.x, this.y, this.x + this.img.width, this.y),
+                    diff  = 1 / (parts.length - 1);
+
+                grad.addColorStop(0, RGraph.trim(parts[0]));
+    
+                for (var j=1; j<parts.length; ++j) {
+                    grad.addColorStop(j * diff, RGraph.trim(parts[j]));
+                }
+            }
+    
+            return grad ? grad : color;
+        };
+
+
+
+
+
+
+
+
+        //
+        // Using a function to add events makes it easier to facilitate method chaining
+        // 
+        // @param string   type The type of even to add
+        // @param function func 
+        //
+        this.on = function (type, func)
+        {
+            if (type.substr(0,2) !== 'on') {
+                type = 'on' + type;
+            }
+            
+            if (typeof this[type] !== 'function') {
+                this[type] = func;
+            } else {
+                RGraph.addCustomEventListener(this, type, func);
+            }
+    
+            return this;
+        };
+
+
+
+
+
+
+
+
+        //
+        // This function runs once only
+        // (put at the end of the file (before any effects))
+        //
+        this.firstDrawFunc = function ()
+        {
+        };
+
+
+
+
+
+
+
+
+        //
+        // This draws a rectangle for the border of the image with optional rounded corners
+        //
+        this.roundedRect = function (x, y, width, height, radius)
+        {
+            // Save the existing state of the canvas so that it can be restored later
+            this.context.save();
+            
+                // Translate to the given X/Y coordinates
+                this.context.translate(x, y);
+    
+                // Move to the center of the top horizontal line
+                this.context.moveTo(width / 2,0);
+                
+                // Draw the rounded corners. The connecting lines in between them are drawn automatically
+                this.context.arcTo(width,0,width,height, Math.min(height / 2, radius));
+                this.context.arcTo(width, height, 0, height, Math.min(width / 2, radius));
+                this.context.arcTo(0, height, 0, 0, Math.min(height / 2, radius));
+                this.context.arcTo(0, 0, radius, 0, Math.min(width / 2, radius));
+    
+                // Draw a line back to the start coordinates
+                this.context.lineTo(width / 2,0);
+    
+            // Restore the state of the canvas to as it was before the save()
+            this.context.restore();
+        };
+
+
+
+
+
+
+
+
+        //
+        // 
+        //
+        this.drawBackgroundColor = function (borderRadius)
+        {
+            this.context.beginPath();
+            this.context.fillStyle = properties.backgroundColor;
+            this.roundedRect(
+                Math.round(this.x) - Math.round(this.context.lineWidth / 2),
+                Math.round(this.y) - Math.round(this.context.lineWidth / 2),
+                (properties.width || this.img.width) + this.context.lineWidth,
+                (properties.height || this.img.height) + this.context.lineWidth,
+                borderRadius
+            );
+            this.context.fill();
+        };
+
+
+
+
+
+
+
+
+        //
+        // A worker function that handles Bar chart specific tooltip substitutions
+        //
+        this.tooltipSubstitutions = function (opt)
+        {
+            return {
+                  index: 0,
+                dataset: 0,
+        sequentialIndex: 0,
+                  value: null
+            };
+        };
+
+
+
+
+
+
+
+
+        //
+        // This allows for static tooltip positioning
+        //
+        this.positionTooltipStatic = function (args)
+        {
+            var obj        = args.object,
+                e          = args.event,
+                tooltip    = args.tooltip,
+                index      = args.index,
+                canvasXY   = RGraph.getCanvasXY(obj.canvas);
+
+            // Position the tooltip in the X direction
+            args.tooltip.style.left = (
+                canvasXY[0]                            // The X coordinate of the canvas
+                + this.x                               // The X coordinate of the image
+                + ((properties.width || this.img.width) / 2) // Add half of the image width
+                - (tooltip.offsetWidth / 2)            // Subtract half of the tooltip width
+                + obj.properties.tooltipsOffsetx       // Add any user defined offset
+            ) + 'px';
+
+            args.tooltip.style.top  = (
+                  canvasXY[1]                            // The Y coordinate of the canvas
+                - tooltip.offsetHeight                   // The height of the tooltip
+                + obj.properties.tooltipsOffsety         // Add any user defined offset
+                + this.y                                 // Add the Y coordinate
+                - 10                                     // An arbitrary amount
+            ) + 'px';
+        };
+
+
+
+
+
+
+
+
+        //
+        // Objects are now always registered so that the chart is redrawn if need be.
+        //
+        RGraph.register(this);
+
+
+
+
+
+
+
+
+        //
+        // This is the 'end' of the constructor so if the first argument
+        // contains configuration data - handle that.
+        //
+        RGraph.parseObjectStyleConfig(this, conf.options);
+    };