https://github.com/jcfandinocal/progaf

A python framework to develop games with real world object tracking (using cameras) combined with projection mapping
https://github.com/jcfandinocal/progaf

camera detection framework game-engine games mediapipe opencv-python panda3d projection-mapping projector pygame

Last synced: 8 months ago
JSON representation

A python framework to develop games with real world object tracking (using cameras) combined with projection mapping

• Host: GitHub
• URL: https://github.com/jcfandinocal/progaf
• Owner: jcfandinocal
• License: gpl-3.0
• Created: 2021-04-26T19:49:16.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2021-04-28T20:16:47.000Z (almost 5 years ago)
• Last Synced: 2025-06-22T23:03:42.562Z (9 months ago)
• Topics: camera, detection, framework, game-engine, games, mediapipe, opencv-python, panda3d, projection-mapping, projector, pygame
• Language: Python
• Homepage:
• Size: 5.88 MB
• Stars: 12
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: contributing.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# PROGAF

A python framework to develop games with real world object tracking (using cameras) combined with projection mapping

## Installation

To install, just run `pip install progaf`. Please take a look a the provided [examples](https://github.com/jcfandinocal/progaf/tree/main/examples)

## About

The goal of the project is to provide a light, conceptually clean, open source framework to support application development using projection mapping (also known as surface projection, video mapping or spatial augmented reality) and/or real world object tracking using cameras. Expected uses for the framework include the development of games and possibly other applications across several domains including education, training, marketing, exhibition, entertainment and art.

Main features are:

- Object-oriented abstraction layer including: 

  - Hardware Integration (standard camera, depth camera, projector)

  - Object detection, identification and tracking (with specific detectors for faces, eyes, hands, geometric shapes and blobs) using [OpenCV](https://opencv.org) and Google [MediaPipe](https://github.com/google/mediapipe)

  - Gestures and events detection and processing

  - Integration of detected objects into existing game engines: 

    - [PyGame](https://github.com/pygame/pygame)

    - [Panda3D](https://www.panda3d.org)

The framework also supports projection-mapping applications with specific features:

- Easy and intuitive projector-camera alignment and calibration

- Affine and pespective transformations of application objects

- Projection mapping over static surfaces and/or moving objects in real time

- Capabilities to render/project in real time any combination of video streams, images, textures, text or graphics

## Contributing

Contributions are welcome. Please feel free to fork the repo and submit pull requests.