Skip to content

Commit

Permalink
Initial commit
Browse files Browse the repository at this point in the history
  • Loading branch information
@jamiebicknell
jamiebicknell committed Jun 20, 2014
0 parents commit aefff4d
Show file tree
Hide file tree
Showing 4 changed files with 258 additions and 0 deletions.
21 changes: 21 additions & 0 deletions LICENSE.md
@@ -0,0 +1,21 @@
The MIT License (MIT)

Copyright (c) 2014 Jamie Bicknell - @jamiebicknell

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
115 changes: 115 additions & 0 deletions README.md
@@ -0,0 +1,115 @@
# Sparkline

PHP script to generate sparklines, with browser cachine with ETag.

## Example Usage

```html
<img src='sparkline.php?size=80x20&data=2,4,5,6,10,7,8,5,7,7,11,8,6,9,11,9,13,14,12,16&back=fff&line=5bb763&fill=d5f7d8' />
```

<table>
<tr>
<th>URL</th>
<th>Output</th>
</tr>
<tr>
<td>`html sparkline.php`</td>
<td><img src='http://jamiebicknell.github.io/Sparkline/sparkline_1403094493691.png' alt='EG1' /></td>
</tr>
<tr>
<td>`sparkline.php?data=5`</td>
<td><img src='http://jamiebicknell.github.io/Sparkline/sparkline_1403094493692.png' alt='EG2' /></td>
</tr>
<tr>
<td>`sparkline.php?data=2,4,5,6,10,7,8,5,7,7,11,8,6,9,11,9,13,14,12,16`</td>
<td><img src='http://jamiebicknell.github.io/Sparkline/sparkline_1403094493693.png' alt='EG3' /></td>
</tr>
<tr>
<td>`sparkline.php?data=2,4,5,6,10,7,8,5,7,7,11,8,6,9,11,9,13,14,12,16&line=5bb763&fill=d5f7d8`</td>
<td><img src='http://jamiebicknell.github.io/Sparkline/sparkline_1403094493694.png' alt='EG4' /></td>
</tr>
<tr>
<td>`sparkline.php?data=2,4,5,6,10,7,8,5,7,7,11,8,6,9,11,9,13,14,12,16&line=fd8626&fill=ffedde`</td>
<td><img src='http://jamiebicknell.github.io/Sparkline/sparkline_1403094493695.png' alt='EG5' /></td>
</tr>
<tr>
<td>`sparkline.php?data=2,4,5,6,10,7,8,5,7,7,11,8,6,9,11,9,13,14,12,16&line=ed5565&fill=ffe2e2`</td>
<td><img src='http://jamiebicknell.github.io/Sparkline/sparkline_1403094493696.png' alt='EG6' /></td>
</tr>
<tr>
<td>`sparkline.php?data=2,4,5,6,10,7,8,5,7,7,11,8,6,9,11,9,13,14,12,16&line=444&fill=eee`</td>
<td><img src='http://jamiebicknell.github.io/Sparkline/sparkline_1403094493697.png' alt='EG7' /></td>
</tr>
<tr>
<td>`sparkline.php?data=2,4,5,6,10,7,8,5,7,7,11,8,6,9,11,9,13,14,12,16&line=31475c&fill=fff`</td>
<td><img src='http://jamiebicknell.github.io/Sparkline/sparkline_1403094493698.png' alt='EG8' /></td>
</tr>
<tr>
<td>`sparkline.php?size=185x40&data=2,4,5,6,10,7,8,5,7,7,11,8,6,9,11,9,13,14,12,16`</td>
<td><img src='http://jamiebicknell.github.io/Sparkline/sparkline_1403094493699.png' alt='EG9' /></td>
</tr>
</table>


## Query Parameters

<table>
<tr>
<th>Key</th>
<th>Example Value</th>
<th>Default</th>
<th>Description</th>
</tr>
<tr>
<td>size</td>
<td>100x25, 100</td>
<td>80x20</td>
<td>Width must be between 50 and 80<br />Height must be between 20 and 800</td>
</tr>
<tr>
<td>data</td>
<td>10,20,50,20,30,40,50,120,90</td>
<td></td>
<td>Comma separated list of values to plot</td>
</tr>
<tr>
<td>back</td>
<td>eeeeee, ddd</td>
<td>ffffff</td>
<td>Hexadecimal code for background colour</td>
</tr>
<tr>
<td>line</td>
<td>555555, 222</td>
<td>1388db</td>
<td>Hexadecimal code for line colour</td>
</tr>
<tr>
<td>fill</td>
<td>cccccc, bbb</td>
<td>e6f2fa</td>
<td>Hexadecimal code for fill colour</td>
</tr>
</table>

## Size Parameter

<table>
<tr>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>100</td>
<td>Creates a square image 100px in width and 100px in height</td>
</tr>
<tr>
<td>80x20</td>
<td>Creates an image 80px in width and 20px in height</td>
</tr>
</table>

##License

Sparkline is licensed under the [MIT license](http://opensource.org/licenses/MIT), see [LICENSE.md](https://github.com/jamiebicknell/Sparkline/blob/master/LICENSE.md) for details.
21 changes: 21 additions & 0 deletions composer.json
@@ -0,0 +1,21 @@
{
"name": "jamiebicknell/Sparkline",
"description": "PHP script to generate sparklines",
"keywords": [
"sparkline",
"sparklines",
"php",
"gd"
],
"homepage": "http://github.com/jamiebicknell/Sparkline",
"license": "MIT",
"authors": [
{
"name": "Jamie Bicknell",
"homepage": "http://www.jamiebicknell.com"
}
],
"require": {
"php": ">=5.2.0"
}
}
101 changes: 101 additions & 0 deletions sparkline.php
@@ -0,0 +1,101 @@
<?php

/*
Title: Sparkline
URL: http://github.com/jamiebicknell/Sparkline
Author: Jamie Bicknell
Twitter: @jamiebicknell
*/

$size = isset($_GET['size']) ? str_replace('x', '', $_GET['size']) != '' ? $_GET['size'] : '80x20' : '80x20';
$back = isset($_GET['back']) ? $_GET['back'] : 'ffffff';
$line = isset($_GET['line']) ? $_GET['line'] : '1388db';
$fill = isset($_GET['fill']) ? $_GET['fill'] : 'e6f2fa';
$data = isset($_GET['data']) ? explode(',', $_GET['data']) : array();

list($w, $h) = explode('x', $size);
$w = floor(max(50, min(800, $w)));
$h = !strstr($size, 'x') ? $w : floor(max(20, min(800, $h)));
$t = 1.75;
$s = 4;

$w *= $s;
$h *= $s;
$t *= $s;

$salt = 'v1.0.0';
$hash = md5($salt . $_SERVER['QUERY_STRING']);

$data = (count($data) < 2) ? array_fill(0, 2, $data[0]) : $data;
$count = count($data);
$step = $w / ($count - 1);
$max = max($data);

if (!extension_loaded('gd')) {
die('GD extension is not installed');
}

if (isset($_SERVER['HTTP_IF_NONE_MATCH'])) {
if ($_SERVER['HTTP_IF_NONE_MATCH'] == $hash) {
header($_SERVER['SERVER_PROTOCOL'] . ' 304 Not Modified');
die();
}
}

$im = imagecreatetruecolor($w, $h);
list($r, $g, $b) = hexToRgb($back);
$bg = imagecolorallocate($im, $r, $g, $b);
list($r, $g, $b) = hexToRgb($line);
$fg = imagecolorallocate($im, $r, $g, $b);
list($r, $g, $b) = hexToRgb($fill);
$lg = imagecolorallocate($im, $r, $g, $b);
imagefill($im, 0, 0, $bg);

imagesetthickness($im, $t);

foreach ($data as $k => $v) {
$v = $v > 0 ? round($v / $max * $h) : 0;
$data[$k] = max($s, min($v, $h - $s));
}

$x1 = 0;
$y1 = $h - $data[0];
$line = array();
$poly = array(0, $h + 50, $x1, $y1);
for ($i = 1; $i < $count; $i++) {
$x2 = $x1 + $step;
$y2 = $h - $data[$i];
array_push($line, array($x1, $y1, $x2, $y2));
array_push($poly, $x2, $y2);
$x1 = $x2;
$y1 = $y2;
}
array_push($poly, $x2, $h + 50);

imagefilledpolygon($im, $poly, $count + 2, $lg);

foreach ($line as $k => $v) {
list($x1, $y1, $x2, $y2) = $v;
imageline($im, $x1, $y1, $x2, $y2, $fg);
}

$om = imagecreatetruecolor($w / $s, $h / $s);
imagecopyresampled($om, $im, 0, 0, 0, 0, $w / $s, $h / $s, $w, $h);
imagedestroy($im);

header('Content-Type: image/png');
header('Content-Disposition: inline; filename="sparkline_' . time() . substr(microtime(), 2, 3) . '.png"');
header('ETag: ' . $hash);
header('Accept-Ranges: none');
header('Cache-Control: max-age=604800, must-revalidate');
header('Expires: ' . gmdate('D, d M Y H:i:s T', strtotime('+7 days')));
imagepng($om);
imagedestroy($om);

function hexToRgb($hex)
{
$hex = ltrim(strtolower($hex), '#');
$hex = isset($hex[3]) ? $hex : $hex[0] . $hex[0] . $hex[1] . $hex[1] . $hex[2] . $hex[2];
$dec = hexdec($hex);
return array(0xFF & ($dec >> 0x10), 0xFF & ($dec >> 0x8), 0xFF & $dec);
}

0 comments on commit aefff4d

Please sign in to comment.