Skip to main content

THETA EXIF Library

Project description

https://badge.fury.io/py/thetaexif.svg https://travis-ci.org/regen100/thetaexif.svg?branch=master

thetaexif is a Python library for RICOH THETA image. It provides a EXIF reader class and a rectification tool.

Requirements

  • Python 3.6 or later

  • Pillow

  • Scipy

Setup

$ pip install thetaexif

Usage

In Python

>>> from thetaexif import ExifReader, tag
>>> reader = ExifReader('image.jpg')
>>> reader.makernote[tag.FIRMWARE_VERSION]
b'Rev0102'
>>> reader.theta[tag.ZENITH_ES]
(Fraction(20, 1), Fraction(-24, 1))

Show Theta EXIF

$ theta-tool info image.jpg
RICOH Marker Note
0x0001 [MakerNoteType]: Rdc
0x0002 [FirmwareVersion]: Rev0102
0x0005 [SerialNumber]: 0000000000102690
0x1000 [RecordingFormat]: 2

THETA Subdir
0x0001 [RicohCameraType]: 1
0x0002 [HDRType]: 0
0x0003 [ZenithEs]: (20, -24)
0x0004 [CompassEs]: 45/2
0x0005 [AbnormalAcceleration]: 0
0x0101 [FilmISO]: (100, 0, 100, 0)
0x0102 [Aperture]: (21/10, 21/10)
0x0103 [ExposureTime]: (1/4000, 1/4000)
0x0104 [SensorSerial1]: A0015348
0x0105 [SensorSerial2]: A0015357

Rectification

rectify command reads gyroscope and compass data and rotate images to rectify camera pose.

Rectify image.jpg and save to image_rectified.jpg:

$ theta-tool rectify image.jpg

Rectify image.jpg using compass data (rotate image to face the north):

$ theta-tool rectify -c image.jpg

Keep EXIF and rectify:

$ theta-tool rectify -e image.jpg

Changelog

0.2 (2019-05-02)

  • Support Python 3.x

  • Remove the dependency on Cython

0.1 (2014-06-22)

  • Initial release

Project details


Download files

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

Source Distribution

thetaexif-0.2.tar.gz (7.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page