zeba_academy_gesture_engine 0.0.1

Advanced custom gesture recognition engine for Flutter.

zeba_academy_gesture_engine

🚀 Advanced custom gesture recognition engine for Flutter.

A powerful, lightweight, and extensible gesture engine that allows developers to create and recognize custom gestures like lines, circles, Z-shapes, and combinations — all without heavy dependencies.

---

✨ Features

• 🎯 Custom gesture recognition (Line, Circle, Z-shape)
• 🔄 Gesture combinations support
• ⚡ Velocity tracking
• 🧭 Direction analysis
• 🧼 Gesture smoothing (noise reduction)
• 🧩 Easy-to-use widget API
• 🚀 Lightweight & no external dependencies

---

📦 Installation

Add this to your pubspec.yaml:

dependencies:
  zeba_academy_gesture_engine: ^0.1.0

Then run:

flutter pub get

---

🚀 Usage

Basic Example

import 'package:zeba_academy_gesture_engine/zeba_academy_gesture_engine.dart';

GestureWidget(
  onGesture: (type, velocity) {
    print("Gesture: $type | Velocity: $velocity");

    if (type == GestureType.circle) {
      print("Circle detected");
    }
  },
  child: Container(
    color: Colors.white,
    child: const Center(
      child: Text("Draw a gesture"),
    ),
  ),
)

---

🎮 Gesture Types

• GestureType.line
• GestureType.circle
• GestureType.zShape
• GestureType.unknown

---

🔥 Advanced Usage

Gesture Combination Detection

// Example: Z → Circle combo

Navigation Example

if (type == GestureType.circle) {
  Navigator.pushNamed(context, '/home');
}

---

🧠 How It Works

The engine processes touch input into gesture points and performs:

• Distance calculations
• Direction tracking using atan2
• Velocity computation
• Shape matching using geometric heuristics

---

📁 Project Structure

lib/
 ├── gesture_engine.dart
 └── src/
     ├── gesture_point.dart
     ├── gesture_analyzer.dart
     ├── gesture_matcher.dart
     ├── gesture_controller.dart
     ├── gesture_widget.dart
     └── gesture_types.dart

---

🧪 Testing

Run tests using:

flutter test

---

📌 Roadmap

• ✨ $1 Gesture Recognizer implementation
• ✨ Multi-touch gesture support
• ✨ Gesture templates system
• ✨ Visual gesture debugger
• ✨ Bezier curve smoothing

---

📜 License

This project is licensed under the GNU General Public License (GPL).

---

👨‍💻 About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects. You can learn more about me and my work at sufyanism.com or connect with me on Linkedin

---

🌐 Your all-in-one no-bloat hub!

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy. Empower yourself with practical skills through curated directives, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development. ➡ Visit our main site: zeba.academy ➡ Explore hands-on courses and resources at: code.zeba.academy ➡ Check out our YouTube for more tutorials: zeba.academy ➡ Follow us on Instagram: zeba.academy

---

🙌 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

---

⭐ Support

If you like this package, give it a ⭐ on GitHub and share it with the community!

---

Thank you for visiting! 🚀