// o---------------------------------------------------------------------------------o // | This file is part of the RGraph package - you can learn more at: | // | | // | https://www.rgraph.net/license.html | // | | // | RGraph is dual-licensed under the Open Source GPL license. That means that it's | // | free to use and there are no restrictions on what you can use RGraph for! | // | If the GPL license does not suit you however, then there's an inexpensive | // | commercial license option available. See the URL above for more details. | // 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. // // 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.Background = function (conf) { var id = conf.id, canvas = document.getElementById(id); this.id = id; this.canvas = document.getElementById(this.id); this.context = this.canvas.getContext('2d'); this.canvas.__object__ = this; this.original_colors = []; this.colorsParsed = false; this.firstDraw = true; // After the first draw this will be false // // This defines the type of this shape // this.type = 'drawing.background'; // // 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 = { backgroundBarsCount: null, backgroundBarsColor1: 'rgba(0,0,0,0)', backgroundBarsColor2: 'rgba(0,0,0,0)', backgroundGrid: true, backgroundGridColor: '#ddd', backgroundGridLinewidth: 1, backgroundGridVlines: true, backgroundGridHlines: true, backgroundGridBorder: true, backgroundGridAutofit: true, backgroundGridHlinesCount: 5, backgroundGridVlinesCount: 20, backgroundGridDashed: false, backgroundGridDotted: false, backgroundGridDashArray: null, backgroundImage : null, backgroundImageStretch: true, backgroundImageX: null, backgroundImageY: null, backgroundImageW: null, backgroundImageH: null, backgroundImageAlign: null, backgroundColor: null, marginLeft: 35, marginRight: 35, marginTop: 35, marginBottom: 35, textColor: 'black', // Gradients aren't supported for this color textSize: 12, textFont: 'Arial, Verdana, sans-serif', textBold: false, textItalic: false, textAccessible: false, textAccessibleOverflow: 'visible', textAccessiblePointerevents: false, text: null, tooltips: null, tooltipsHighlight: true, tooltipsCssClass: 'RGraph_tooltip', tooltipsCss: null, tooltipsEffect: 'slide', tooltipsEvent: 'onclick', tooltipsFormattedThousand: ',', tooltipsFormattedPoint: '.', 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)', linewidth: 1, title: '', titleFont: null, titleSize: null, titleColor: null, titleBold: null, titleItalic: null, titleX: null, titleY: null, titleHalign: null, titleValign: null, titleOffsetx: 0, titleOffsety: 0, titleSubtitle: '', titleSubtitleSize: null, titleSubtitleColor: '#aaa', titleSubtitleFont: null, titleSubtitleBold: null, titleSubtitleItalic: null, titleSubtitleOffsetx: 0, titleSubtitleOffsety: 0, xaxisTitle: '', xaxisTitleBold: null, xaxisTitleItalic: null, xaxisTitleSize: null, xaxisTitleFont: null, xaxisTitleColor: null, xaxisTitleX: null, xaxisTitleY: null, xaxisTitlePos: null, yaxisTitle: '', yaxisTitleBold: null, yaxisTitleSize: null, yaxisTitleFont: null, yaxisTitleColor: null, yaxisTitleItalic: null, yaxisTitleX: null, yaxisTitleY: null, yaxisTitlePos: null, clearto: 'rgba(0,0,0,0)', clip: null } // // Add the reverse look-up table for property names // so that property names can be specified in any case. // this.properties_lowercase_map = []; for (var i in this.properties) { if (typeof i === 'string') { this.properties_lowercase_map[i.toLowerCase()] = i; } } // // A simple check that the browser has canvas support // if (!this.canvas) { alert('[DRAWING.BACKGROUND] 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 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]; // Go through all of the properties and make sure // that they're using the correct capitalisation if (typeof name === 'string') { name = this.properties_lowercase_map[name.toLowerCase()] || name; } // Go through all of the properties and make sure // that they're using the correct capitalisation name = this.properties_lowercase_map[name.toLowerCase()] || name; // Set the colorsParsed flag to false if the colors // property is being set if ( name === 'backgroundColor' || name === 'backgroundGridColor' || name === 'backgroundBarsColor1' || name === 'backgroundBarsColor2' || name === 'highlightStroke' || name === 'highlightFill' ) { this.colorsParsed = false; } // 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) { // Go through all of the properties and make sure // that they're using the correct capitalisation name = this.properties_lowercase_map[name.toLowerCase()] || name; return properties[name]; }; // // Draws the circle // this.draw = function () { // // Fire the onbeforedraw event // RGraph.fireCustomEvent(this, 'onbeforedraw'); // // Install clipping // // MUST be the first thing that's done after the // beforedraw event // if (!RGraph.isNull(this.properties.clip)) { RGraph.clipTo.start(this, this.properties.clip); } // 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; } // // DRAW BACKGROUND HERE * // this.marginLeft = properties.marginLeft; this.marginRight = properties.marginRight; this.marginTop = properties.marginTop; this.marginBottom = properties.marginBottom; // // Parse the colors. This allows for simple gradient syntax // if (!this.colorsParsed) { this.parseColors(); // Don't want to do this again this.colorsParsed = true; } // // Set the shadow // RGraph.drawBackgroundImage(this); RGraph.Background.draw(this); // // Add custom text thats specified // RGraph.addCustomText(this); // // This installs the event listeners // RGraph.installEventListeners(this); // // End clipping // if (!RGraph.isNull(this.properties.clip)) { RGraph.clipTo.end(); } // // 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; } }; // // 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]; // Draw a path to test this.path( 'b r % % % %', this.marginLeft, this.marginTop, this.canvas.width - this.marginRight - this.marginLeft, this.canvas.height - this.marginTop - this.marginBottom ); if ( this.context.isPointInPath(mouseX, mouseY) && (this.properties.clip ? RGraph.clipTo.test(this, mouseX, mouseY) : true) ) { if (RGraph.parseTooltipText && properties.tooltips) { var tooltip = RGraph.parseTooltipText(properties.tooltips, 0); } return { object: this, 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 %', properties.marginLeft,properties.marginTop,this.canvas.width - properties.marginLeft - properties.marginRight,this.canvas.height - properties.marginTop - properties.marginBottom, 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.backgroundColor = RGraph.arrayClone(properties.backgroundColor); this.original_colors.backgroundGridColor = RGraph.arrayClone(properties.backgroundGridColor); this.original_colors.backgroundBarsColor1 = RGraph.arrayClone(properties.backgroundBarsColor1); this.original_colors.backgroundBarsColor2 = RGraph.arrayClone(properties.backgroundBarsColor2); this.original_colors.highlightStroke = RGraph.arrayClone(properties.highlightStroke); this.original_colors.highlightFill = RGraph.arrayClone(properties.highlightFill); } // // Parse various properties for colors // properties.backgroundColor = this.parseSingleColorForGradient(properties.backgroundColor); properties.backgroundBarsColor1 = this.parseSingleColorForGradient(properties.backgroundBarsColor1); properties.backgroundBarsColor2 = this.parseSingleColorForGradient(properties.backgroundBarsColor2); properties.backgroundGridColor = this.parseSingleColorForGradient(properties.backgroundGridColor); 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}); } // Split and create the gradient var parts = RegExp.$1.split(':'), grad = this.context.createLinearGradient( this.marginLeft, this.marginTop, this.canvas.width - this.marginRight, this.canvas.height - this.marginBottom ), diff = 1 / (parts.length - 1); //grad.addColorStop(0, RGraph.trim(parts[0])); for (var j=0; j