O widget de Padrão de Assinatura que permite desenhar assinaturas suaves. Com uma variedade de configurações de desenho e exportação. E também suporta SVG.
Orientação gerada a partir de informações públicas. Apenas para referência.
Um widget Flutter para criar quadros de assinatura suaves e interativos com opções personalizáveis de desenho e exportação. Suporta múltiplas plataformas, incluindo mobile, web e desktop. Oferece exportação em SVG e estilos flexíveis para atender às diversas necessidades de aplicativos. Ideal para formulários, autenticação e documentação digital onde assinaturas de usuários são necessárias.
Casos de uso
Submissões de formulários digitais
Autenticação de usuário por assinatura
Coleta de assinatura eletrônica
Fluxos de aprovação de documentos
Assinatura de contrato online
Registro de aplicativo móvel
Principais recursos
Desenho suave de assinatura
Suporte à exportação SVG
Largura e cor de traço personalizáveis
Compatibilidade multiplataforma
Renderização em tempo real
Configurações de exportação configuráveis
Indicado para
Aplicativos que exigem assinaturas eletrônicas
Aplicações com muitos formulários
Aplicativos móveis e web com entrada de usuário
fluxos de trabalho de documentos digitais
software educacional ou corporativo
Considerações
Requer entrada de toque do usuário
O desempenho pode variar em dispositivos de baixa gama
A exportação SVG pode precisar de processamento adicional
Limitado a desenho 2D
Nenhuma armazenamento ou validação embutidos
Não otimizado para casos de uso de alta frequência
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
Hand Signature
A Flutter plugin providing a Signature Pad for drawing smooth signatures. This library is written in a pure Dart/Flutter environment to provide support for all platforms. It's easy to use, with a variety of drawing and export settings, and also supports SVG files.
The signature pad drawing is based on Cubic Bézier curves and offers a choice between performance and 'beauty' modes.
Features
Cross-Platform: Works on any platform supported by Flutter.
Customizable: Adjust stroke width, color, and smoothing.
Multiple Drawing Types: Choose between line, shape, and arc presets for different visual styles. It's also possible to implement a custom drawing experience.
Velocity and Pressure Based Stroke: The thickness of the line can vary based on the drawing speed and pressure.
Export Options: Export signatures as PNG, SVG, or raw data (JSON/Map).
Import/Export: Save and load signature data state.
Usage
Here is a simple example of how to use the signature pad.
This class handles the logic behind the signature, controlling input touches and managing the control points of the signature curve.
SignaturePathSetup defines how input data will be handled.
threshold: Controls the minimal distance between two points. A higher distance creates a smoother, but less precise, curve.
smoothRatio: (0 - 1) Controls how smooth the curve will be. A higher ratio creates a smoother, but less precise, curve. The best results are typically between 0.5 and 0.75.
velocityRange: Controls the curve size based on the drawing speed. A thin line corresponds to a fast movement, while a thick line corresponds to a slow movement.
presureRatio: (0 - 1) Ratio between pressure sensitivity and velocity. 0.0 = only velocity, 1.0 = only pressure. Some platforms/devices (like mouse pointer) doesn't support sensitivity'
args: Custom variables - mostly used for custom HandSignatureDrawer.
HandSignature
This widget handles touch gestures and draws the curve on the canvas.
control: The HandSignatureControl that processes input and stores the raw data.
drawer: The HandSignatureDrawer that handles the painting of the signature.
backgroundColor: The background color of the signature canvas.
placeholder: A widget to display when the signature is empty.
Drawers
Drawers are responsible for rendering the signature on the canvas. You can use one of the pre-built drawers or create your own.
Pre-built Drawers
LineSignatureDrawer: Basic line with a single line width.
ShapeSignatureDrawer: Default drawer, mimics an ink pen. It varies line width based on velocity and/or pressure. This is a good option for exporting to SVG.
ArcSignatureDrawer: Also mimics an ink pen, but is less performant than ShapeSignatureDrawer. This is the default drawer when exporting to an image.
DynamicSignatureDrawer: Dynamically selects the drawing type based on provided arguments.
MultiSignatureDrawer: Combines multiple drawers, allowing for complex effects and layering.
Custom Drawer
You can create a custom drawer by extending HandSignatureDrawer and implementing the paint method. This allows full control over how the signature is rendered.
Check custom_sample.dart for dynamic setup and drawing.
Exporting
You can modify properties like canvas size, stroke width, and color during export. You can also provide a custom drawer when exporting to an image. The most common export formats are SVG and PNG. During export, data are re-rendered with the preferred setup and output dimensions.
State can be saved with toMap() and restored with the import() method.
final control = HandSignatureControl();
// Export to SVGfinal svg = control.toSvg();
// Export to PNGfinal png = await control.toImage(
width: 512,
height: 512,
drawer: ShapeSignatureDrawer(
color: Colors.black,
),
);
// Export to raw datafinal data = control.toMap();
// Import from raw data
control.import(data);
SVG:
shape: Generates a reasonably small file that is well-supported by most programs.
arc: Generates a larger SVG file, which some programs may struggle to handle.
line: A simple Bezier curve.
Image: Export to an Image or Picture object, which can then be converted to PNG bytes.
arc: Default drawer when exporting image data.
drawer: Specifies HandSignatureDrawer to use during canvas export.
JSON/Map: Export the current state as raw data, which can be used later to restore the signature.
Data is exported with timestamp and pressure information for each point.
Displaying an exported SVG file
You can display an exported SVG file using a library like flutter_svg.