// o---------------------------------------------------------------------------o
    // | This file is part of the RGraph package - you can learn more at:          |
    // |                                                                           |
    // |                           https://www.rgraph.net                          |
    // |                                                                           |
    // | RGraph is dual-licensed under the Open Source GPL license. This means     |
    // | that it's free to use for any purpose. The GPL license does have          |
    // | consequences on the license of the software that you include it in,       |
    // | however. If this is not desirable, then there's an inexpensive commercial |
    // | license option available. See the RGraph website 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.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 properties
        //
        this.properties =
        {
            marginTop:         35, // Used for clipping
            marginBottom:      35, // Used for clipping
            marginLeft:        35, // Used for clipping
            marginRight:       35, // Used for clipping

            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',
            tooltipsPersistent:         false,
            tooltipsFormattedPoint:     '.',
            tooltipsFormattedThousand:  ',',
            tooltipsFormattedDecimals:  0,
            tooltipsFormattedUnitsPre:  '',
            tooltipsFormattedUnitsPost: '',
            tooltipsFormattedListType:  'ul',
            tooltipsFormattedListItems: null,
            tooltipsPointer:            true,
            tooltipsPointerOffsetx:     0,
            tooltipsPointerOffsety:     0,
            tooltipsPositionStatic:     true,
            tooltipsOffsetx:            0,
            tooltipsOffsety:            0,

            highlightStroke:     'transparent',
            highlightFill:       'rgba(255,255,255,0.7)',
            highlightFade:       true,

            colorsAlpha:         1,

            border:               false,
            borderColor:         'black',
            borderLinewidth:     1,
            borderRadius:        0,

            backgroundColor:     'transparent',

            text:                null,

            clearto:             'transparent',
            
            clip:                null,
            events:              {},
            responsive:          null,
            scale:               true,
            scaleFactor:         2,
            antialiasTranslate:  false,
            
            style:               []
        };




        //
        // These are the properties that get scaled up if the
        // scale option is enabled.
        //
        this.properties_scale = [
        
            'width',
            'height',

            'marginLeft',
            'marginRight',
            'marginBottom',
            'marginTop',
            'marginInner',

            'textSize',

            'shadowOffsetx',
            'shadowOffsety',
            'shadowBlur',
            
            'linewidth',
            
            'borderLinewidth',
            'borderRadius'
        ];








        //
        // 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.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];

            // 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;
            }

            // Set the colorsParsed flag to false if the colors
            // property is being set
            if (
                   name === 'colorsBackground'
                || name === 'highlightFill'
                || name === 'highlightStroke'
               ) {
                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 ()
        {
            // MUST be the first thing that's done - but only
            // once!!
            RGraph.runOnce(`scale-up-the-canvas-once-in-the-draw-function-${this.id}-${this.uid}`,  () =>
            {
                // Note that we're in an arrow function so the
                // 'this' variable is OK to be used and refers
                // to the RGraph Line chart object.
                RGraph.scale(this);
            });




            //
            // Fire the onbeforedraw event
            //
            RGraph.fireCustomEvent(this, 'onbeforedraw');



            //
            // Add any CSS that has been specified to the document.
            // This is general CSS and does not necessarily have to
            // pertain to the canvas tag. It only gets added once
            // to the document no matter how many times this draw
            // function is called.
            //
            // Add the CSS to a <style> block in the <head>.
            RGraph.addConfigurationBasedCSS(this);
            
            var scaleFactor = RGraph.getScaleFactor(this);





            //
            // Install clipping
            //
            // MUST be the first thing that's done after the
            // beforedraw event
            //
            if (!RGraph.isNullish(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
            //
            // The old style antialias fix
            //
            if (   !this.properties.scale
                && this.properties.antialiasTranslate
                && !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 = (RGraph.isNumber(obj.properties.width) && RGraph.isNumber(obj.properties.width));

                    // Horizontal alignment
                    if (obj.properties.halign === 'center') {
                        obj.x = obj.x - (customWidthHeight ? (obj.properties.width / 2) : (this.width / 2));
                    } else if (obj.properties.halign == 'right') {
                        obj.x = obj.x - (customWidthHeight ? obj.properties.width : this.width);
                    }

                    // Vertical alignment
                    if (obj.properties.valign === 'center') {
                        obj.y = obj.y - (customWidthHeight ? (obj.properties.height / 2) : (this.height / 2));
                    } else if (obj.properties.valign === 'bottom') {
                       obj.y = 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;



                // Need this to stop a rectangle being drawn around
                // the llast path that was added to the canvas.
                this.context.beginPath();

                //
                // 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
                    );
                }
                this.context.stroke();


                
                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 {
                
                    // Add the image to the document so that the
                    // width/height can be ascertained
                    document.body.appendChild(this.img);
                    this.img.style.position = 'absolute';
                    this.img.style.top      = '-1000px';
                    this.img.style.left     = '-1000px';

                    this.context.drawImage(
                        this.img,
                        Math.round(this.x),
                        Math.round(this.y),
                        this.img.offsetWidth,
                        this.img.offsetHeight
                    );
                }




                // 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);
    




            //
            // End clipping
            //
            if (!RGraph.isNullish(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)
        {
            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])
                && (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,
                         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 the highlightFade property is not set then call
            // the highlight function multiple times when the
            // globalAlpha is set at varying levels of transparency
            // to fade the highlight in. If the variable is set,
            // however, then this call is probably a part of said
            // highlighting process so don't call ourselves
            // again - just highlight the chart.
            if (this.properties.highlightFade && !this.highlight.highlighting) {
            
                // Add a variable to the highlight function (this
                // function) to indicate that we're currently in
                // the process of highlighting.
                this.highlight.highlighting = true;
                
                var obj = this;
                setTimeout(function() {obj.context.globalAlpha = 0.2; obj.highlight(shape); obj.context.globalAlpha = 1;}, 20);
                setTimeout(function() {obj.context.globalAlpha = 0.2; obj.highlight(shape); obj.context.globalAlpha = 1;}, 40);
                setTimeout(function() {obj.context.globalAlpha = 0.2; obj.highlight(shape); obj.context.globalAlpha = 1;}, 60);
                setTimeout(function() {obj.context.globalAlpha = 0.2; obj.highlight(shape); obj.context.globalAlpha = 1;}, 80);
                setTimeout(function() {obj.context.globalAlpha = 0.2; obj.highlight(shape); obj.context.globalAlpha = 1;}, 100);
                setTimeout(function() {obj.context.globalAlpha = 0.2; obj.highlight(shape); obj.context.globalAlpha = 1;}, 120);
                setTimeout(function() {obj.context.globalAlpha = 0.2; obj.highlight(shape); obj.context.globalAlpha = 1;}, 140);
                setTimeout(function() {obj.highlight.highlighting = false;}, 400);
            
                return;
            }

            RGraph.clipTo.callback(this, function (obj)
            {
                if (typeof obj.properties.highlightStyle === 'function') {
                    (obj.properties.highlightStyle)(shape);
                } else {
                    obj.path('b');

                    obj.roundedRect(
                        obj.coords[0][0],
                        obj.coords[0][1],
                        obj.coords[0][2],
                        obj.coords[0][3],
                        obj.properties.borderRadius
                    );

                    obj.path(
                        'f % s %',
                        obj.properties.highlightFill,
                        obj.properties.highlightStroke
                    );
                }
            });// End of clipping callback.
        };








        //
        // 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)
        {
            var scaleFactor = RGraph.getScaleFactor(this);

            this.context.beginPath();
            this.context.strokeStyle = 'transparent';
            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),
                scaleFactor = RGraph.getScaleFactor(obj);

            // Position the tooltip in the X direction
            if (scaleFactor === 1) {
                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';
            } else {
                args.tooltip.style.left = (
                    canvasXY[0]                            // The X coordinate of the canvas
                    + (this.x / scaleFactor)               // The X coordinate of the image
                    + ((properties.width || this.img.width) / 4) // Add half of the image width
                    - (tooltip.offsetWidth / 2)            // Subtract half of the tooltip width
                    + obj.properties.tooltipsOffsetx       // Add any user defined offset
                ) + 'px';
            }

            // Positon the tooltip in the vertical direction
            if (scaleFactor === 1) {
                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
                    - (12 - properties.borderLinewidth)          // An arbitrary amount
                ) + 'px';
            } else {
                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 / scaleFactor)                                 // Add the Y coordinate
                    - ((7 * scaleFactor) - properties.borderLinewidth)          // 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);
    };