Pupil Labs Camera

This repo contains functionality around the usage of camera intrinsics for undistorting data, projecting and unprojecting points.

It is mostly a wrapper around OpenCV's functionality, providing type hints, input validation, a more intuitive interface, and a few performance optimizations.

Installation

pip install pupil-labs-camera

pip install -e git+https://github.com/pupil-labs/pl-camera.git

Quick Start

The following code demonstrates how to use the library in the context of a Neon recording to undistort an image and 2D gaze points. Additional examples can be found in the example Jupyter Notebook.

import cv2

from pupil_labs import neon_recording as nr
from pupil_labs.camera import Camera

recording = nr.NeonRecording(
    "/path/to/recording"
)
camera = Camera(
    pixel_width=1600,
    pixel_height=1200,
    camera_matrix=recording.calibration.scene_camera_matrix,
    distortion_coefficients=recording.calibration.scene_distortion_coefficients,
)

data = zip(recording.scene, recording.gaze.sample(recording.scene.time))

for scene_frame, gaze_sample in data:
    distorted_image = scene_frame.bgr
    undistorted_image = camera.undistort_image(distorted_image)

    distorted_gaze = gaze_sample.point
    undistorted_gaze = camera.undistort_points(distorted_gaze)

    cv2.circle(
        distorted_image,
        tuple(map(int, distorted_gaze)),
        radius=25,
        color=(0, 0, 255),
        thickness=5,
    )

    cv2.circle(
        undistorted_image,
        tuple(map(int, undistorted_gaze)),
        radius=25,
        color=(0, 255, 0),
        thickness=5,
    )

    cv2.imshow("Distorted Image", distorted_image)
    cv2.imshow("Undistorted Image", undistorted_image)
    cv2.waitKey(30)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pupil_labs_camera-1.2.1.tar.gz (1.7 MB view details)

Uploaded Sep 1, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pupil_labs_camera-1.2.1-py3-none-any.whl (185.6 kB view details)

Uploaded Sep 1, 2026 Python 3

File details

Details for the file pupil_labs_camera-1.2.1.tar.gz.

File metadata

Download URL: pupil_labs_camera-1.2.1.tar.gz
Upload date: Sep 1, 2026
Size: 1.7 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pupil_labs_camera-1.2.1.tar.gz
Algorithm	Hash digest
SHA256	`29cbff5b9c7b31d7e034be8086ceeb5e71d24ed681257625ec97156981781c6f`
MD5	`05237ea6aa326f301081e269754f64ad`
BLAKE2b-256	`4c3c2dd77dc52009886dacd6edcb44da2c7cd941be60685bf55a8165fc867743`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pupil_labs_camera-1.2.1.tar.gz:

Publisher: on-release-main.yml on pupil-labs/pl-camera

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pupil_labs_camera-1.2.1.tar.gz
- Subject digest: 29cbff5b9c7b31d7e034be8086ceeb5e71d24ed681257625ec97156981781c6f
- Sigstore transparency entry: 2674458185
- Sigstore integration time: Sep 1, 2026
Source repository:
- Permalink: pupil-labs/pl-camera@a5dad897286614788191c288ebe5c2e9a28461f2
- Branch / Tag: refs/tags/v1.2.1
- Owner: https://github.com/pupil-labs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: on-release-main.yml@a5dad897286614788191c288ebe5c2e9a28461f2
- Trigger Event: release