패키지, 저장소 및 앱 카테고리 검색

hand_signature 표지
패키지 상세v3.1.0+2

hand_signature

부드러운 서명을 그릴 수 있는 서명 패드 위젯입니다. 다양한 그리기 및 내보내기 설정을 제공하며 SVG도 지원합니다.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
1.2만
좋아요
306
Pub 점수
150

패키지 설치

flutter pub add hand_signature

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

사용자 정의 가능한 그림 및 내보내기 옵션을 갖춘 부드럽고 상호작용 가능한 서명 패드를 만들 수 있는 플러터 위젯입니다. 모바일, 웹, 데스크톱 등 다양한 플랫폼을 지원합니다. 다양한 앱 요구사항에 맞는 SVG 내보내기 및 유연한 스타일링 기능을 제공합니다. 양식, 인증 및 디지털 문서화에서 사용자 서명이 필요한 경우에 이상적입니다.

사용 사례

  • 디지털 양식 제출
  • 서명을 통한 사용자 인증
  • 전자 서명 수집
  • 문서 승인 워크플로우
  • 온라인 계약 서명
  • 모바일 앱 등록

주요 기능

  • 부드러운 서명 그리기
  • SVG 내보내기 지원
  • 사용자 지정 가능한 테두리 두께 및 색상
  • 크로스 플랫폼 호환성
  • 실시간 렌더링
  • 사용자 정의 가능한 내보내기 설정

적합한 대상

  • 전자 서명이 필요한 앱
  • 폼 중심 애플리케이션
  • 사용자 입력이 있는 모바일 및 웹 앱
  • 디지털 문서 워크플로우
  • 교육용 또는 기업용 소프트웨어

고려 사항

  • 사용자 터치 입력이 필요합니다
  • 저사양 기기에서는 성능이 다를 수 있습니다
  • SVG 내보내기는 추가 처리가 필요할 수 있습니다
  • 2차원 그림 그리기만 가능
  • 내장된 저장소 또는 검증 없음
  • 고주기 사용 사례에 최적화되지 않음

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

Hand Signature

pub.dev

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.

Signature

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.

import 'package:hand_signature/signature.dart';

final control = HandSignatureControl(
  initialSetup: SignaturePathSetup(
    threshold: 5.0,
    smoothRatio: 0.65,
    velocityRange: 2.0,
    pressureRatio: 0.0,
  ),
);

final widget = HandSignature(
  control: control,
  drawer: ShapeSignatureDrawer(
    color: Colors.blueGrey,
    width: 2.0,
    maxWidth: 10.0,
  ),
);

HandSignatureControl

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.

class MyCustomDrawer extends HandSignatureDrawer {
  @override
  void paint(Canvas canvas, Size size, List<CubicPath> paths) {
    // Custom painting logic here
  }
}

Check custom_sample.dart for dynamic setup and drawing. Custom Drawer


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 SVG
final svg = control.toSvg();

// Export to PNG
final png = await control.toImage(
  width: 512,
  height: 512,
  drawer: ShapeSignatureDrawer(
    color: Colors.black,
  ),
);

// Export to raw data
final 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.

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트