A jQuery UIplugin
that captures or draws a signature.
It requires the jQuery UI widget and mouse modules and needs the
excanvas.js add-in for older IE versions.
The current version is 1.2.1 and is available
under the MIT licence.
For more detail see the documentation reference page.
Or see a minimal page that you could
use as a basis for your own investigations.
The most striking element is the prepended year: . Pokémon Emerald was released by Nintendo and Game Freak exclusively for the Game Boy Advance in 2004 (Japan) and 2005 (worldwide). The Game Boy Advance itself launched in 2001. There is no version of Emerald —not a beta, not a prototype—that could exist in 1986.
The first anomaly that catches the eye is the year "1986" associated with Pokémon Emerald. For context, Pokémon Emerald was officially released in 2005 for the Game Boy Advance, a handheld console that was a successor to the original Game Boy. The Game Boy Advance was launched in 2001, and it was a significant technological leap forward from the 8-bit Game Boy of the late 1980s.
The primary reason this specific file is searched for is because it is the mandatory base file for .
: This is the release number. Pokémon Emerald was the 1,986th unique GBA game dumped and cataloged by early preservation groups. -u- : This signifies the USA (English) version of the game. 1986 - Pokemon Emerald -u--trashman-.gba
The -trashman- tag was his signature—a way to claim credit without joining a major scene group like TrashMan (no relation) or Rising Sun . Several other dumps bear his mark:
To experience customized versions of Hoenn, enthusiasts use dedicated patch tools to merge their legal files:
The importance of this specific file extends far beyond just being a good dump. It is the foundational canvas for one of the most active ROM hacking communities in history. The filename has become a sort of ritual, a specific invocation that creators use to ensure their art is built on solid ground.
: This refers to the "release group" or the individual who successfully dumped the data from the physical cartridge into a digital .gba format. 💎 Why Pokémon Emerald is the "GBA Crown Jewel"
: You need a Game Boy Advance (GBA) emulator to run the file. : Reviewers from Visual Boy Advance (VBA) often recommend it for its stability. is a popular choice for mobile users. Patching ROM Hacks : Many popular hacks, such as Pokemon Blazing Emerald Pokémon Lazarus There is no version of Emerald —not a
Unlike previous games with one antagonist team, Emerald saw players battling both Team Magma and Team Aqua, who aimed to expand land and sea, respectively [2].
The enduring popularity of the "1986" ROM is tied directly to the quality of the game itself. Pokémon Emerald is widely considered by fans to be one of the greatest Pokémon games ever made. It perfected the mechanics introduced in Ruby and Sapphire by adding features that defined the franchise for years to come: The Battle Frontier
Options
Customise the signature functionality through additional settings.
Using metadata for configuration may require adding the jquery.metadata.js plugin to your page.
Events
You can be notified when the signature has changed via the change setting.
And you can erase the signature with the clear command and
test for any content via the isEmpty command.
Extract the signature as a JSON value, and later re-draw it from that value.
Alternately you can generate the signature as SVG, or as a data URL in PNG or JPEG format.
The most striking element is the prepended year: . Pokémon Emerald was released by Nintendo and Game Freak exclusively for the Game Boy Advance in 2004 (Japan) and 2005 (worldwide). The Game Boy Advance itself launched in 2001. There is no version of Emerald —not a beta, not a prototype—that could exist in 1986.
The first anomaly that catches the eye is the year "1986" associated with Pokémon Emerald. For context, Pokémon Emerald was officially released in 2005 for the Game Boy Advance, a handheld console that was a successor to the original Game Boy. The Game Boy Advance was launched in 2001, and it was a significant technological leap forward from the 8-bit Game Boy of the late 1980s.
The primary reason this specific file is searched for is because it is the mandatory base file for .
: This is the release number. Pokémon Emerald was the 1,986th unique GBA game dumped and cataloged by early preservation groups. -u- : This signifies the USA (English) version of the game.
The -trashman- tag was his signature—a way to claim credit without joining a major scene group like TrashMan (no relation) or Rising Sun . Several other dumps bear his mark:
To experience customized versions of Hoenn, enthusiasts use dedicated patch tools to merge their legal files:
[Release Number] - [Game Title] - [Dump Group Name] . [File Extension] 1. "1986" (The No-Intro Release Number)
The importance of this specific file extends far beyond just being a good dump. It is the foundational canvas for one of the most active ROM hacking communities in history. The filename has become a sort of ritual, a specific invocation that creators use to ensure their art is built on solid ground.
: This refers to the "release group" or the individual who successfully dumped the data from the physical cartridge into a digital .gba format. 💎 Why Pokémon Emerald is the "GBA Crown Jewel"
: You need a Game Boy Advance (GBA) emulator to run the file. : Reviewers from Visual Boy Advance (VBA) often recommend it for its stability. is a popular choice for mobile users. Patching ROM Hacks : Many popular hacks, such as Pokemon Blazing Emerald Pokémon Lazarus
Unlike previous games with one antagonist team, Emerald saw players battling both Team Magma and Team Aqua, who aimed to expand land and sea, respectively [2].
The enduring popularity of the "1986" ROM is tied directly to the quality of the game itself. Pokémon Emerald is widely considered by fans to be one of the greatest Pokémon games ever made. It perfected the mechanics introduced in Ruby and Sapphire by adding features that defined the franchise for years to come: The Battle Frontier
C# Rendering
You can render an image from the signature JSON text on the server.
The following shows how to do this in .NET 4.5 C#, thanks to Daniel Knight.
You would call this code as follows
and it returns a base64 encoded byte array as a string:
GetBase64Png(jsonEncoding, width, height);
using System;
using System.Collections.Generic;
using System.Web.Script.Serialization;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;
using System.Web.Http;
public class GraphicsController : ApiController
{
[HttpGet]
[ActionName("GetBase64Png")]
public string GetBase64Png([FromUri] string linesGraphicJSON, [FromUri] int width, [FromUri] int height)
{
return Draw2DLineGraphic(new JavaScriptSerializer().Deserialize<Signature>(linesGraphicJSON), width, height);
}
private string Draw2DLineGraphic(I2DLineGraphic lineGraphic, int width, int height)
{
//The png's bytes
byte[] png = null;
//Create the Bitmap set Width and height
using (Bitmap b = new Bitmap(width, height))
{
using (Graphics g = Graphics.FromImage(b))
{
//Make sure the image is drawn Smoothly (this makes the pen lines look smoother)
g.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.AntiAlias;
//Set the background to white
g.Clear(Color.White);
//Create a pen to draw the signature with
Pen pen = new Pen(Color.Black, 2);
//Smooth out the pen, making it rounded
pen.DashCap = System.Drawing.Drawing2D.DashCap.Round;
//Last point a line finished at
Point LastPoint = new Point();
bool hasLastPoint = false;
//Draw the signature on the bitmap
foreach (List<List<double>> line in lineGraphic.lines)
{
foreach (List<double> point in line)
{
var x = (int)Math.Round(point[0]);
var y = (int)Math.Round(point[1]);
if (hasLastPoint)
{
g.DrawLine(pen, LastPoint, new Point(x, y));
}
LastPoint.X = x;
LastPoint.Y = y;
hasLastPoint = true;
}
hasLastPoint = false;
}
}
//Convert the image to a png in memory
using (MemoryStream stream = new MemoryStream())
{
b.Save(stream, ImageFormat.Png);
png = stream.ToArray();
}
}
return Convert.ToBase64String(png);
}
public class Signature : I2DLineGraphic
{
public List<List<List<double>>> lines { get; set; }
}
interface I2DLineGraphic
{
List<List<List<double>>> lines { get; set; }
}
}
In the Wild
This tab highlights examples of this plugin in use "in the wild".
None as yet.
To add another example, please contact me (kbwood.au{at}gmail.com)
and provide the plugin name, the URL of your site, its title,
and a short description of its purpose and where/how the plugin is used.
Quick Reference
A full list of all possible settings is shown below.
Note that not all would apply in all cases. For more detail see the
documentation reference page.
$(selector).signature({
background: '#ffffff', // Colour of the background
color: '#000000', // Colour of the signature
thickness: 2, // Thickness of the lines
guideline: false, // Add a guide line or not?
guidelineColor: '#a0a0a0', // Guide line colour
guidelineOffset: 25, // Guide line offset from the bottom
guidelineIndent: 10, // Guide line indent from the edges
// Error message when no canvas
notAvailable: 'Your browser doesn\'t support signing',
scale: 1, // A scaling factor for rendering the signature (only applies to redraws).
syncField: null, // Selector for synchronised text field
syncFormat: 'JSON', // The output respresentation: 'JSON' (default), 'SVG', 'PNG', 'JPEG'
svgStyles: false, // True to use style attribute in SVG
change: null // Callback when signature changed
});
$.kbw.signature.options // Access settings for all instances
$(selector).signature('option', settings) // Change the instance settings
$(selector).signature('option', name, value) // Change an instance setting
$(selector).signature('option') // Retrieve the instance settings
$(selector).signature('option', name) // Retrieve an instance setting
$(selector).signature('enable') // Enable the signature functionality
$(selector).signature('disable') // Disable the signature functionality
$(selector).signature('destroy') // Remove the signature functionality
$(selector).signature('clear') // Erase any signature
$(selector).signature('isEmpty') // Determine if there is no signature
$(selector).signature('toDataURL') // Convert the signature to an image in a data: URL
$(selector).signature('toJSON') // Convert the signature to JSON
$(selector).signature('toSVG') // Convert the signature to SVG
$(selector).signature('draw', sig) // Re-draw the signature from JSON, SVG, or a data: URL
Usage
Include the jQuery and jQuery UI libraries and CSS in the head section of your page.