pencil_kit 1.0.0

A Flutter plugin that provides a iOS PencilKit widget on iOS.

Flutter iOS Pencil Kit

Flutter plugin for using iOS Pencil Kit.

Note 📒

• This package only provides iOS implementation. If you try use widget of this package other than iOS, you see a Red warning box.
• iOS Pencil Kit is available from iOS 13.0

Supported Platforms 📱

• iOS

Features & Todo 🌟

• ✅ Drawing
• ✅ Show/Hide palette
• ✅ Undo/Redo
• ✅ Clear
• ✅ UI properties(background color, scrollability, isOpaque, etc...)
• ❌ Manage drawing tools programmatically
• ❌ Import/Export drawing data

Requirements ✅

• iOS: Deployment target >= 9.0

Setup & Usage 🎉

flutter pub add pencil_kit

Available Methods

Methods available for PencilKitController.

Method	Description
clear()	Clear canvas
show()	Show Palette
hide()	Hide Palette
redo()	Redo last drawing action
undo()	Undo last drawing action

PencilKit Widget Parameters

All the available parameters.

Parameter	Description
onPencilKitViewCreated	A callback for platform view created. You can store PencilKitController from argument of this callback.
hitTestBehavior	iOS UIKitView hitTestBehavior
unAvailableFallback	A widget for render UnAvailable state. The default is A red box
alwaysBounceVertical	A Boolean value that determines whether bouncing always occurs when vertical scrolling reaches the end of the content.
alwaysBounceHorizontal	A Boolean value that determines whether bouncing always occurs when horizontal scrolling reaches the end of the content view.
isRulerActive	A Boolean value that indicates whether a ruler view is visible on the canvas.
drawingPolicy	The policy that controls the types of touches allowed when drawing on the canvas. This properties can be applied from iOS 14.0
onRulerActiveChanged	A callback for ruler activate state changed
onToolPickerVisibilityChanged	A callback for tool picker visibility state changed

Example

import 'package:pencil_kit/pencil_kit.dart';

class MyWidgetState extends State<MyWidget> {
  late final PencilKitController controller;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('PencilKit Example'),
          actions: [
            IconButton(
              icon: const Icon(Icons.palette),
              onPressed: () => controller.show(),
            ),
            IconButton(
              icon: const Icon(Icons.close),
              onPressed: () => controller.hide(),
            ),
            IconButton(
              icon: const Icon(Icons.undo),
              onPressed: () => controller.undo(),
            ),
            IconButton(
              icon: const Icon(Icons.redo),
              onPressed: () => controller.redo(),
            ),
            IconButton(
              icon: const Icon(Icons.refresh),
              onPressed: () => controller.clear(),
            ),
          ],
        ),
        body: PencilKit(
          onPencilKitViewCreated: (controller) => this.controller = controller,
          alwaysBounceVertical: false,
          alwaysBounceHorizontal: true,
          isRulerActive: false,
          drawingPolicy: PencilKitIos14DrawingPolicy.anyInput,
          onRulerActiveChanged: (isRulerActive) {
            if (kDebugMode) {
              print('isRulerActive $isRulerActive');
            }
          },
          onToolPickerVisibilityChanged: (isVisible) {
            if (kDebugMode) {
              print('isVisible $isVisible');
            }
          },
          backgroundColor: Colors.blue.withOpacity(0.1),
          isOpaque: false,
        ),
      ),
    );
  }
}

Contributors ✨

Thanks goes to these wonderful people (emoji key):

MJ Studio 🤔

This project follows the all-contributors specification. Contributions of any kind welcome!