사용자 정의 가능한 그림 및 내보내기 옵션을 갖춘 부드럽고 상호작용 가능한 서명 패드를 만들 수 있는 플러터 위젯입니다. 모바일, 웹, 데스크톱 등 다양한 플랫폼을 지원합니다. 다양한 앱 요구사항에 맞는 SVG 내보내기 및 유연한 스타일링 기능을 제공합니다. 양식, 인증 및 디지털 문서화에서 사용자 서명이 필요한 경우에 이상적입니다.
사용 사례
디지털 양식 제출
서명을 통한 사용자 인증
전자 서명 수집
문서 승인 워크플로우
온라인 계약 서명
모바일 앱 등록
주요 기능
부드러운 서명 그리기
SVG 내보내기 지원
사용자 지정 가능한 테두리 두께 및 색상
크로스 플랫폼 호환성
실시간 렌더링
사용자 정의 가능한 내보내기 설정
적합한 대상
전자 서명이 필요한 앱
폼 중심 애플리케이션
사용자 입력이 있는 모바일 및 웹 앱
디지털 문서 워크플로우
교육용 또는 기업용 소프트웨어
고려 사항
사용자 터치 입력이 필요합니다
저사양 기기에서는 성능이 다를 수 있습니다
SVG 내보내기는 추가 처리가 필요할 수 있습니다
2차원 그림 그리기만 가능
내장된 저장소 또는 검증 없음
고주기 사용 사례에 최적화되지 않음
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
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.