Yara

Yara's legend has had a lasting impact on Brazilian culture, influencing literature, music, art, and even modern media. She represents the mystique of the Amazon, the power and mystery of indigenous cultures, and the enduring appeal of the natural world. In literature, she has been a subject of fascination for poets and writers who see in her a symbol of freedom, beauty, and the untamed spirit of the Amazon.

In the rich tapestry of Brazilian folklore, there exists a figure so intriguing, so shrouded in mystery, that she has captivated the imagination of people for centuries. Her name is Yara, a mermaid-like creature from the depths of the Amazon River, and her story is a compelling blend of myth, cultural heritage, and the timeless allure of the unknown. Yara's legend has had a lasting impact on

One of the most popular tales about Yara tells the story of a beautiful indigenous girl who lived on the banks of the Amazon River. According to legend, she was so beautiful that she attracted the attention of many suitors, but she remained elusive and independent. One day, while bathing in the river, she was seen by a handsome young man who fell deeply in love with her. However, their love was forbidden by her family or, in some versions, by her own choice to remain free and unbound. In the rich tapestry of Brazilian folklore, there

The legend of Yara originates from the indigenous mythology of Brazil, specifically among the Tupi and Guarani peoples. According to ancient lore, Yara was not merely a creature of the river but a symbol of beauty, seduction, and the untamed power of nature. Her name, which translates to "small girl" or "young woman" in the Tupi language, belies the complexity and depth of her character. According to legend, she was so beautiful that

Options

Customise the signature functionality through additional settings.

Different colours:

$('#coloursSignature').signature({background: 'blue', color: '#ffffff'});

Line thickness:

$('#thicknessSignature').signature({thickness: 4});

Add a guideline:

$('#guidelineSignature').signature({guideline: true});

Customise guideline:

$('#guideline2Signature').signature({guideline: true,
	guidelineOffset: 25, guidelineIndent: 20, guidelineColor: '#ff0000'});

Via metadata:

<div id="metadataSignature" class="{signature: {guideline: true, guidelineColor: '#008000'}}"></div>
$('#metadataSignature').signature();

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.

When changed:

 

$('#whenChangedSignature').signature({
	change: function(event, ui) {
		alert('Signature changed');
	}});

$('#clearButton').click(function() {
	$('#whenChangedSignature').signature('clear');
});

$('#isEmptyButton').click(function() {
	alert('Is empty? ' + $('#whenChangedSignature').signature('isEmpty'));
});

Save/Restore

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.

Capture signature:

  As ( )

$('#captureSignature').signature({syncField: '#signatureJSON'});

$('#clear2Button').click(function() {
	$('#captureSignature').signature('clear');
});

$('input[name="syncFormat"]').change(function() {
var saved = $('#signatureJSON').val()
    var syncFormat = $('input[name="syncFormat"]:checked').val();
	$('#captureSignature').signature('option', 'syncFormat', syncFormat);
	$('#captureSignature').signature('draw', saved)
});

$('#svgStyles').change(function() {
	$('#captureSignature').signature('option', 'svgStyles', $(this).is(':checked'));
});

Signature Output:

 

Re-draw signature:

$('#redrawButton').click(function() {
	$('#redrawSignature').signature('enable').
		signature('draw', $('#signatureJSON').val()).
		signature('disable');
});

$('#redrawSignature').signature({disabled: true});

Yara's legend has had a lasting impact on Brazilian culture, influencing literature, music, art, and even modern media. She represents the mystique of the Amazon, the power and mystery of indigenous cultures, and the enduring appeal of the natural world. In literature, she has been a subject of fascination for poets and writers who see in her a symbol of freedom, beauty, and the untamed spirit of the Amazon.

In the rich tapestry of Brazilian folklore, there exists a figure so intriguing, so shrouded in mystery, that she has captivated the imagination of people for centuries. Her name is Yara, a mermaid-like creature from the depths of the Amazon River, and her story is a compelling blend of myth, cultural heritage, and the timeless allure of the unknown.

One of the most popular tales about Yara tells the story of a beautiful indigenous girl who lived on the banks of the Amazon River. According to legend, she was so beautiful that she attracted the attention of many suitors, but she remained elusive and independent. One day, while bathing in the river, she was seen by a handsome young man who fell deeply in love with her. However, their love was forbidden by her family or, in some versions, by her own choice to remain free and unbound.

The legend of Yara originates from the indigenous mythology of Brazil, specifically among the Tupi and Guarani peoples. According to ancient lore, Yara was not merely a creature of the river but a symbol of beauty, seduction, and the untamed power of nature. Her name, which translates to "small girl" or "young woman" in the Tupi language, belies the complexity and depth of her character.

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".

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