virtual-landmark 0.1.0

A Python package for defining custom landmarks in Mediapipe making easy to calculate some new virtual points with a single extention class

Virtual Landmark

virtual-landmark is a modular and extensible system for working with custom landmarks on top of MediaPipe Pose. It enables developers to define additional pose points through geometric relationships, access them like native MediaPipe landmarks, and extend pose rendering and analysis.

The complete documentation can be found on the documentation page

---

Features

• 🧩 Create virtual landmarks with @landmark decorator
• 📐 Measure 2D and 3D joint angles
• 🎨 Extend pose drawings with new connections and styles
• 📚 Seamlessly integrate with MediaPipe’s landmark list
• 🧠 Named access to all landmarks via enum-like interface

---

How It Works

The system works in three stages:

1. Definition

Virtual landmarks are declared using @landmark("NAME", connection=[...]) decorators on methods that return a 3D point.

2. Discovery

Upon instantiating VirtualLandmark, all decorated methods are scanned, executed, and their results added to the landmark list.

3. Access

Virtual landmarks behave like native landmarks:

• Access index via .NAME.value
• Retrieve coordinates via landmark list
• Draw using standard MediaPipe rendering tools

---

Getting Started

Install MediaPipe:

pip install mediapipe opencv-python virtual-landmark

Clone or copy this repo, then run the examples:

python examples/get_started.py
python examples/hello_world.py
python examples/video.py
python examples/web_cam.py

There are also a Jupyter notebook that you can run through the follow command:

pip install jupyterlab matplotlib
jupyter lab examples

---