rgraph-rails 5.00 → 6.14

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

@@ -1,37 +1,668 @@
+'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
 
-RGraph=window.RGraph||{isRGraph:true};RGraph.Drawing=RGraph.Drawing||{};RGraph.Drawing.Poly=function(conf)
-{if(typeof conf==='object'&&typeof conf.coords==='object'&&typeof conf.id==='string'){var id=conf.id,coords=conf.coords,parseConfObjectForOptions=true;}else{var id=conf,coords=arguments[1];}
-this.id=id;this.canvas=document.getElementById(this.id);this.context=this.canvas.getContext('2d');this.colorsParsed=false;this.canvas.__object__=this;this.coords=coords;this.coordsText=[];this.original_colors=[];this.firstDraw=true;this.propertyNameAliases={};this.type='drawing.poly';this.isRGraph=true;this.uid=RGraph.createUID();this.canvas.uid=this.canvas.uid?this.canvas.uid:RGraph.createUID();this.properties={'chart.linewidth':1,'chart.colors.stroke':'black','chart.colors.fill':'red','chart.events.click':null,'chart.events.mousemove':null,'chart.tooltips':null,'chart.tooltips.override':null,'chart.tooltips.effect':'fade','chart.tooltips.css.class':'RGraph_tooltip','chart.tooltips.event':'onclick','chart.tooltips.highlight':true,'chart.highlight.stroke':'rgba(0,0,0,0)','chart.highlight.fill':'rgba(255,255,255,0.7)','chart.shadow':false,'chart.shadow.color':'rgba(0,0,0,0.2)','chart.shadow.offsetx':3,'chart.shadow.offsety':3,'chart.shadow.blur':5,'chart.clearto':'rgba(0,0,0,0)'}
-if(!this.canvas){alert('[DRAWING.POLY] No canvas support');return;}
-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');if(!this.colorsParsed){this.parseColors();this.colorsParsed=true;}
-this.coordsText=[];if(prop['chart.shadow']){co.shadowColor=prop['chart.shadow.color'];co.shadowOffsetX=prop['chart.shadow.offsetx'];co.shadowOffsetY=prop['chart.shadow.offsety'];co.shadowBlur=prop['chart.shadow.blur'];}
-co.strokeStyle=prop['chart.colors.stroke'];co.fillStyle=prop['chart.colors.fill'];this.drawPoly();co.lineWidth=prop['chart.linewidth'];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)
-{if(this.getShape(e)){return this;}};this.drawPoly=this.DrawPoly=function()
-{var coords=this.coords;pa2(co,['b','m',coords[0][0],coords[0][1]]);for(var i=1,len=coords.length;i<len;++i){co.lineTo(coords[i][0],coords[i][1]);}
-pa2(co,['lw',prop['chart.linewidth'],'c','f',co.fillStyle,'s',co.strokeStyle]);};this.getShape=function(e)
-{var coords=this.coords,mouseXY=RG.getMouseXY(e),mouseX=mouseXY[0],mouseY=mouseXY[1];var old_strokestyle=co.strokeStyle,old_fillstyle=co.fillStyle;co.beginPath();co.strokeStyle='rgba(0,0,0,0)';co.fillStyle='rgba(0,0,0,0)';this.drawPoly();co.strokeStyle=old_strokestyle;co.fillStyle=old_fillstyle;if(co.isPointInPath(mouseX,mouseY)){return{0:this,1:this.coords,2:0,'object':this,'coords':this.coords,'index':0,'tooltip':prop['chart.tooltips']?prop['chart.tooltips'][0]:null};}
-return null;};this.highlight=this.Highlight=function(shape)
-{co.fillStyle=prop['chart.fillstyle'];if(prop['chart.tooltips.highlight']){if(typeof prop['chart.highlight.style']==='function'){(prop['chart.highlight.style'])(shape);}else{pa2(co,['b','fu',function(obj){obj.drawPoly();},'f',prop['chart.highlight.fill'],'s',prop['chart.highlight.stroke']]);}}};this.parseColors=function()
-{if(this.original_colors.length===0){this.original_colors['chart.colors.fill']=RG.array_clone(prop['chart.colors.fill']);this.original_colors['chart.colors.stroke']=RG.array_clone(prop['chart.colors.stroke']);this.original_colors['chart.highlight.stroke']=RG.array_clone(prop['chart.highlight.stroke']);this.original_colors['chart.highlight.fill']=RG.array_clone(prop['chart.highlight.fill']);}
-var func=this.parseSingleColorForGradient;prop['chart.colors.fill']=func(prop['chart.colors.fill']);prop['chart.colors.stroke']=func(prop['chart.colors.stroke']);prop['chart.highlight.stroke']=func(prop['chart.highlight.stroke']);prop['chart.highlight.fill']=func(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(0,0,ca.width,0),diff=1/(parts.length-1);grad.addColorStop(0,RG.trim(parts[0]));for(var j=1,len=parts.length;j<len;++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()
-{};RG.register(this);if(parseConfObjectForOptions){RG.parseObjectStyleConfig(this,conf.options);}};
+    
+    //
+    // 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.
+    //
+
+    // 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.Poly = function (conf)
+    {
+        var id                        = conf.id,
+            coords                    = conf.coords;
+
+        this.id                = id;
+        this.canvas            = document.getElementById(this.id);
+        this.context           = this.canvas.getContext('2d');
+        this.colorsParsed      = false;
+        this.canvas.__object__ = this;
+        this.coords            = coords;
+        this.coordsText        = [];
+        this.original_colors   = [];
+        this.firstDraw         = true; // After the first draw this will be false
+
+        //
+        // This defines the type of this shape
+        //
+        this.type = 'drawing.poly';
+
+
+        //
+        // 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 =
+        {
+            linewidth:               1,
+
+            colorsStroke:            'black',
+            colorsFill:              'red',
+
+            tooltips:                   null,
+            tooltipsOverride:           null,
+            tooltipsEffect:             'slide',
+            tooltipsCssClass:           'RGraph_tooltip',
+            tooltipsCss:                null,
+            tooltipsEvent:              'onclick',
+            tooltipsHighlight:          true,
+            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)',
+
+            shadow:                  false,
+            shadowColor:             'rgba(0,0,0,0.2)',
+            shadowOffsetx:           3,
+            shadowOffsety:           3,
+            shadowBlur:              5,
+
+
+            text:                    null,
+
+            clearto:                 'rgba(0,0,0,0)'
+        }
+
+        //
+        // A simple check that the browser has canvas support
+        //
+        if (!this.canvas) {
+            alert('[DRAWING.POLY] No canvas support');
+            return;
+        }
+        
+        //
+        // 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 properties.
+        // 
+        // @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 shape
+        //
+        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
+            //
+            if (!this.colorsParsed) {
+    
+                this.parseColors();
+    
+                // Don't want to do this again
+                this.colorsParsed = true;
+            }
+    
+    
+
+
+
+            //
+            // Stop this growing uncontrollably
+            //
+            this.coordsText = [];
+
+
+
+
+    
+            //
+            // DRAW THE SHAPE HERE
+            //
+
+            if (properties.shadow) {
+                this.context.shadowColor   = properties.shadowColor;
+                this.context.shadowOffsetX = properties.shadowOffsetx;
+                this.context.shadowOffsetY = properties.shadowOffsety;
+                this.context.shadowBlur    = properties.shadowBlur;
+            }
+
+            this.context.strokeStyle = properties.colorsStroke;
+            this.context.fillStyle   = properties.colorsFill;
+
+            this.drawPoly();
+            
+            this.context.lineWidth = properties.linewidth;
+            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)
+        {
+            if (this.getShape(e)) {
+                return this;
+            }
+        };
+
+
+
+
+
+
+
+
+        //
+        // Draw the Poly but doesn't stroke or fill - that's left to other functions
+        //
+        this.drawPoly = function ()
+        {
+            var coords = this.coords;
+            
+            this.path('b m % %', coords[0][0], coords[0][1]);
+
+            // Draw lines to subsequent coords
+            for (var i=1,len=coords.length; i<len; ++i) {
+                this.context.lineTo(coords[i][0],coords[i][1]);
+            }
+
+            // Close the path and stroke/fill it with whatever the current fill/stroke styles are
+            this.path(
+                'lw % c f % s %',
+                properties.linewidth,
+                this.context.fillStyle,
+                this.context.strokeStyle
+            );
+        };
+
+
+
+
+        //
+        // Not used by the class during creating the graph, but is used by event handlers
+        // to get the coordinates (if any) of the selected bar
+        // 
+        // @param object e The event object
+        //
+        this.getShape = function (e)
+        {
+            var coords  = this.coords,
+                mouseXY = RGraph.getMouseXY(e),
+                mouseX  = mouseXY[0],
+                mouseY  = mouseXY[1];
+    
+            // Should redraw the poly but not stroke or fill it and then use isPointInPath() to test it
+            // DON'T USE PATH OBJECT HERE
+            
+            // Need to save these so that they can be reset
+            var old_strokestyle = this.context.strokeStyle,
+                old_fillstyle   = this.context.fillStyle;
+            
+            this.context.beginPath();
+                this.context.strokeStyle = 'rgba(0,0,0,0)';
+                this.context.fillStyle = 'rgba(0,0,0,0)';
+            this.drawPoly();
+            
+            // Reset the colors
+            this.context.strokeStyle = old_strokestyle;
+            this.context.fillStyle   = old_fillstyle;
+
+    
+            if (this.context.isPointInPath(mouseX, mouseY)) {
+
+                if (RGraph.parseTooltipText && properties.tooltips) {
+                    var tooltip = RGraph.parseTooltipText(properties.tooltips, 0);
+                }
+
+                return {
+                    object: this,
+                    coords: this.coords,
+                   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)
+        {
+            // Evidentally this is necessary
+            this.context.fillStyle = properties.colorsFill;
+
+            // Close a path thats been left open.
+            //
+            // Taken out 17/11/19
+            //
+            // this.path(
+            //     'c f % s %',
+            //     properties.highlightFill,
+            //     properties.highlightStroke
+            // );
+
+            // Add the new highlight
+            if (properties.tooltipsHighlight) {
+                if (typeof properties.highlightStyle === 'function') {
+                    (properties.highlightStyle)(shape);
+                } else {
+                    this.path('b');
+                    this.drawPoly();
+                    this.path('f % s %', 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.colorsFill      = RGraph.arrayClone(properties.colorsFill);
+                this.original_colors.colorsStroke    = RGraph.arrayClone(properties.colorsStroke);
+                this.original_colors.highlightStroke = RGraph.arrayClone(properties.highlightStroke);
+                this.original_colors.highlightFill   = RGraph.arrayClone(properties.highlightFill);
+            }
+
+            var func = this.parseSingleColorForGradient;
+    
+            //
+            // Parse various properties for colors
+            //
+            properties.colorsFill      = func(properties.colorsFill);
+            properties.colorsStroke    = func(properties.colorsStroke);
+            properties.highlightStroke = func(properties.highlightStroke);
+            properties.highlightFill   = func(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});
+                }
+
+                // Create the gradient
+                var parts = RegExp.$1.split(':'),
+                    grad  = this.context.createLinearGradient(0,0,this.canvas.width,0),
+                    diff  = 1 / (parts.length - 1);
+    
+                grad.addColorStop(0, RGraph.trim(parts[0]));
+    
+                for (var j=1,len=parts.length; j<len; ++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 ()
+        {
+        };
+
+
+
+
+
+
+
+
+        //
+        // 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);
+
+            // Calculate the minimum X coordinate
+            for (var i=0,minx=this.coords[0][0],maxx=0,miny=this.coords[0][1],maxy=0; i<this.coords.length; ++i) {
+                // Find the minimum and maximum X coordinate
+                minx = Math.min(minx, this.coords[i][0]);
+                maxx = Math.max(maxx, this.coords[i][0]);
+                
+                // Find the minimum and maximum Y coordinate
+                miny = Math.min(miny, this.coords[i][1]);
+                maxy = Math.max(maxy, this.coords[i][1]);
+            }
+
+            var x = ((maxx - minx) / 2) + minx,
+                y = ((maxy - miny) / 2) + miny;
+
+            // Position the tooltip in the X direction
+            args.tooltip.style.left = (
+                canvasXY[0]                            // The X coordinate of the canvas
+                - (tooltip.offsetWidth / 2)            // Subtract half of the tooltip width
+                + obj.properties.tooltipsOffsetx       // Add any user defined offset
+                + x
+            ) + '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
+                + y
+                 - 10
+            ) + '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);
+    };