// version: 2014-08-16 /** * o--------------------------------------------------------------------------------o * | This file is part of the RGraph package - you can learn more at: | * | | * | http://www.rgraph.net | * | | * | This package is licensed under the Creative Commons BY-NC license. That means | * | that for non-commercial purposes it's free to use and for business use there's | * | a 99 GBP per-company fee to pay. You can read the full license here: | * | | * | http://www.rgraph.net/license | * 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}; RGraph.Drawing = RGraph.Drawing || {}; /** * The constructor. This function sets up the object. It takes the ID (the HTML attribute) of the canvas as the * first argument and the Y coordinate of the axes as the second * * @param string id The canvas tag ID * @param number y The Y coordinate */ RGraph.Drawing.XAxis = function (conf) { /** * Allow for object config style */ if ( typeof conf === 'object' && typeof conf.y === 'number' && typeof conf.id === 'string') { var id = conf.id var y = conf.y; var parseConfObjectForOptions = true; // Set this so the config is parsed (at the end of the constructor) } else { var id = conf; var y = arguments[1]; } this.id = id; this.canvas = document.getElementById(this.id); this.context = this.canvas.getContext('2d'); this.canvas.__object__ = this; this.y = y; this.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.xaxis'; /** * This facilitates easy object identification, and should always be true */ this.isRGraph = 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 = { 'chart.gutter.left': 25, 'chart.gutter.right': 25, 'chart.labels': null, 'chart.labels.position': 'section', 'chart.colors': ['black'], 'chart.title.color': null, // Defaults to same as chart.colors 'chart.text.color': null, // Defaults to same as chart.colors 'chart.text.font': 'Arial', 'chart.text.size': 10, 'chart.align': 'bottom', 'chart.numlabels': 5, 'chart.scale.visible': true, 'chart.scale.formatter': null, 'chart.scale.decimals': 0, 'chart.scale.invert': false, 'chart.scale.zerostart': true, 'chart.units.pre': '', 'chart.units.post': '', 'chart.title': '', 'chart.numticks': null, 'chart.hmargin': 0, 'chart.linewidth': 1, 'chart.noendtick.left': false, 'chart.noendtick.right': false, 'chart.noxaxis': false, 'chart.max': null, 'chart.min': 0, 'chart.tooltips': null, 'chart.tooltips.effect': 'fade', 'chart.tooltips.css.class':'RGraph_tooltip', 'chart.tooltips.event': 'onclick', 'chart.events.click': null, 'chart.events.mousemove': null, 'chart.xaxispos': 'bottom', 'chart.yaxispos': 'left' } /** * A simple check that the browser has canvas support */ if (!this.canvas) { alert('[DRAWING.XAXIS] No canvas support'); return; } /** * Create the dollar object so that functions can be added to them */ this.$0 = {}; /** * Translate half a pixel for antialiasing purposes - but only if it hasn't beeen * done already */ if (!this.canvas.__rgraph_aa_translated__) { this.context.translate(0.5,0.5); this.canvas.__rgraph_aa_translated__ = true; } var RG = RGraph; var ca = this.canvas; var co = ca.getContext('2d'); var prop = this.properties; var jq = jQuery; var pa = RG.Path; var win = window; var doc = document; var ma = Math; /** * "Decorate" the object with the generic effects if the effects library has been included */ if (RG.Effects && typeof RG.Effects.decorate === 'function') { RG.Effects.decorate(this); } /** * A setter method for setting graph properties. It can be used like this: obj.Set('chart.strokestyle', '#666'); * * @param name string The name of the property to set * @param value mixed The value of the property */ this.set = 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 name === 'object') { RG.parseObjectStyleConfig(this, name); return this; } name = name.toLowerCase(); /** * This should be done first - prepend the property name with "chart." if necessary */ if (name.substr(0,6) != 'chart.') { name = 'chart.' + name; } /** * Make the tickmarks align if labels are specified */ if (name == 'chart.labels' && !prop['chart.numxticks']) { prop['chart.numxticks'] = value.length; } prop[name] = value; return this; }; /** * A getter method for retrieving graph properties. It can be used like this: obj.Get('chart.strokestyle'); * * @param name string The name of the property to get */ this.get = this.Get = function (name) { /** * This should be done first - prepend the property name with "chart." if necessary */ if (name.substr(0,6) != 'chart.') { name = 'chart.' + name; } return prop[name.toLowerCase()]; }; /** * Draws the rectangle */ this.draw = this.Draw = function () { /** * Fire the onbeforedraw event */ RG.FireCustomEvent(this, 'onbeforedraw'); /** * Stop this growing uncntrollably */ this.coordsText = []; /** * Some defaults */ this.gutterLeft = prop['chart.gutter.left']; this.gutterRight = prop['chart.gutter.right']; if (!prop['chart.text.color']) prop['chart.text.color'] = prop['chart.colors'][0]; if (!prop['chart.title.color']) prop['chart.title.color'] = prop['chart.colors'][0]; /** * Parse the colors. This allows for simple gradient syntax */ if (!this.colorsParsed) { this.parseColors(); // Don't want to do this again this.colorsParsed = true; } // DRAW X AXIS HERE this.DrawXAxis(); /** * This installs the event listeners */ RG.InstallEventListeners(this); /** * Fire the onfirstdraw event */ if (this.firstDraw) { RG.fireCustomEvent(this, 'onfirstdraw'); this.firstDraw = false; this.firstDrawFunc(); } /** * Fire the ondraw event */ RG.FireCustomEvent(this, 'ondraw'); return this; }; /** * The getObjectByXY() worker method */ this.getObjectByXY = function (e) { if (this.getShape(e)) { return this; } }; /** * Not used by the class during creating the graph, but is used by event handlers * to get the coordinates (if any) of the selected shape * * @param object e The event object */ this.getShape = function (e) { var mouseXY = RG.getMouseXY(e); var mouseX = mouseXY[0]; var mouseY = mouseXY[1]; if ( mouseX >= this.gutterLeft && mouseX <= (ca.width - this.gutterRight) && mouseY >= this.y - (prop['chart.align'] == 'top' ? (prop['chart.text.size'] * 1.5) + 5 : 0) && mouseY <= (this.y + (prop['chart.align'] == 'top' ? 0 : (prop['chart.text.size'] * 1.5) + 5)) ) { var x = this.gutterLeft; var y = this.y; var w = ca.width - this.gutterLeft - this.gutterRight; var h = 15; return { 0: this, 1: x, 2: y, 3: w, 4: h, 5: 0, 'object': this, 'x': x, 'y': y, 'width': w, 'height': h, 'index': 0, 'tooltip': prop['chart.tooltips'] ? prop['chart.tooltips'][0] : null }; } return null; }; /** * This function positions a tooltip when it is displayed * * @param obj object The chart object * @param int x The X coordinate specified for the tooltip * @param int y The Y coordinate specified for the tooltip * @param objec tooltip The tooltips DIV element */ this.positionTooltip = function (obj, x, y, tooltip, idx) { var coordX = obj.gutterLeft; var coordY = obj.y; var coordW = ca.width - obj.gutterLeft - obj.gutterRight; var coordH = prop['chart.text.size'] * 1.5; var canvasXY = RG.getCanvasXY(ca); var width = tooltip.offsetWidth; var height = tooltip.offsetHeight; // Set the top position tooltip.style.left = 0; tooltip.style.top = canvasXY[1] + this.y - height - 5 + (prop['chart.align'] == 'top' ? ((prop['chart.text.size'] * 1.5) / 2) * -1 : ((prop['chart.text.size'] * 1.5) / 2)) + 'px'; // By default any overflow is hidden tooltip.style.overflow = ''; // The arrow var img = new Image(); img.src = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABEAAAAFCAYAAACjKgd3AAAARUlEQVQYV2NkQAN79+797+RkhC4M5+/bd47B2dmZEVkBCgcmgcsgbAaA9GA1BCSBbhAuA/AagmwQPgMIGgIzCD0M0AMMAEFVIAa6UQgcAAAAAElFTkSuQmCC'; img.style.position = 'absolute'; img.id = '__rgraph_tooltip_pointer__'; img.style.top = (tooltip.offsetHeight - 2) + 'px'; tooltip.appendChild(img); // Reposition the tooltip if at the edges: // LEFT edge if ((canvasXY[0] + coordX + (coordW / 2) - (width / 2)) < 10) { tooltip.style.left = (canvasXY[0] + coordX - (width * 0.1)) + (coordW / 2) + 'px'; img.style.left = ((width * 0.1) - 8.5) + 'px'; // RIGHT edge } else if ((canvasXY[0] + coordX + (coordW / 2) + (width / 2)) > (doc.body.offsetWidth - 10) ) { tooltip.style.left = canvasXY[0] + coordX - (width * 0.9) + (coordW / 2) + 'px'; img.style.left = ((width * 0.9) - 8.5) + 'px'; // Default positioning - CENTERED } else { tooltip.style.left = (canvasXY[0] + coordX + (coordW / 2) - (width * 0.5)) + 'px'; img.style.left = ((width * 0.5) - 8.5) + 'px'; } }; /** * Each object type has its own Highlight() function which highlights the appropriate shape * * @param object shape The shape to highlight */ this.highlight = this.Highlight = function (shape) { // When showing tooltips, this method can be used to highlight the X axis }; /** * 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['chart.colors'] = RG.array_clone(prop['chart.colors']); } /** * Parse various properties for colors */ //this.properties['chart.title.color'] = this.parseSingleColorForGradient(this.properties['chart.title.color']); //this.properties['chart.text.color'] = this.parseSingleColorForGradient(this.properties['chart.text.color']); prop['chart.colors'][0] = this.parseSingleColorForGradient(prop['chart.colors'][0]); }; /** * 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)) { var parts = RegExp.$1.split(':'); // Create the gradient var grad = co.createLinearGradient(prop['chart.gutter.left'],0,ca.width - prop['chart.gutter.right'],0); var diff = 1 / (parts.length - 1); grad.addColorStop(0, RG.trim(parts[0])); for (var j=1,len=parts.length; j