The drawing API Poly object API reference

• Usage example
• Properties
• Methods

The Poly object (which is short for polygon) is a drawing api object which you can use to add regular or irregular shapes to your charts.

Usage example

<script>
    line = new RGraph.Line({
        id: 'cvs',
        data: [4,9,1,3,2,6,5],
        options: {
            spline: true,
            backgroundGridVlines:false,
            backgroundGridBorder:false,
            xaxis: false,
            yaxis: false,
            xaxisLabels: ['Monday','Tuesday','Wednesday','Thursday','Friday','Saturday','Sunday'],
            marginInner: 5,
            tickmarksStyle: 'endcircle',
            tickmarksSize: 10,
            colors: ['black'],
            textSize: 16
        }
    }).draw();

    new RGraph.Drawing.Poly({
        id: 'cvs',
        coords: [[50,150],[75,25],[100,150]],
        options: {
            colorsFill: 'rgba(255,0,0,0.5)',
            colorsStroke: 'rgba(0,0,0,0)',
            shadow: true,
            shadowColor: '#000',
            shadowBlur: 2,
            shadowOffsetx: 3,
            shadowOffsety: 3,
            tooltips: ['<b>The Drawing API Poly object</b>'],
            tooltipsCss: {
                fontWeight: 'bold',
                fontSize: '16pt',
                textAlign: 'left'
            }
        }
    }).draw();
</script>

Properties

• Color properties
• Interactive features properties
• Shadow properties
• Other text properties
• Miscellaneous properties

tooltipsFormattedListItems: [
    ['Bill','Jerry','Berty'], // First tooltip
    ['Gill','Carrie','Lucy'], // Second tooltip
    ['Pob','Nobby','Hilda']   // Third tooltip
]

.RGraph_tooltip ul#rgraph_formatted_tooltips_list li {
    text-align: left;
    color: yellow;
}

tooltips: {
    borderLeft: 'gray 2px solid',
    borderBottom: 'gray 2px solid'
}

tooltipsCss: {
    fontFamily: 'Verdana',
    fontSize: '20pt'
}

<div style="margin-left: 50px; display: inline-block">
    <canvas id="cvs" width="650" height="250"></canvas>
</div>

Methods

<script>
    poly.canvas.onclick = function (e)
    {
        RGraph.redraw();
    
        var canvas = e.target,
            obj    = canvas.__object__,
            shape  = obj.getShape(e);

        if (shape) {
            // Highlight the Poly object.
            obj.path('lw 10 b m % %', shape.coords[0][0], shape.coords[0][1]);

            // Loop through the coordinates of the Poly object
            for (var i=1; i<shape.coords.length; ++i) {
                obj.context.lineTo(shape.coords[i][0]. shape.coords[i][1]);
            }

            // Close and stroke/fill the poly
            obj.path('c s black f red');
        }
    }
</script>

This method can be used to set an event listener on an object. It operates similarly to the jquery on function. The first argument is the event that you wish to attach to and the second is the handler function. For example:

obj.on('draw', function (obj)
{
    // Put your event code here
});

The function is useful if you use method chaining when creating your charts:

obj = new RGraph.Drawing.Poly({
    id: 'cvs',
    coords: [[50,150],[75,25],[100,150]],
}).on('draw', function (obj)
{
    // Put your draw event code here

}).on('click', function (e, shape)
{
    // Handle the click event

}).draw();

The exec function is documented here.