/libgphoto2-theta

The libgphoto2 camera access and control library.

Primary LanguageCGNU Lesser General Public License v2.1LGPL-2.1

libgphoto2 for RICOH THETA USB API

modifications for RICOH THETA

  • shutterspeed works thanks to patch from hugues, creator of the FOX SEWER ROVER
  • white balance settings made human readable by dhp, Dalho Park of TeeLabs (indoor 3D mapping company)

more information on libgphoto2

Refer to the original libgphoto2 README for more information

install

autoreconf --install --symlink
./configure --prefix=/usr/local
make
make install

modifications overview

shutterspeed by Hugues

config.c (libgphoto2-2.5.30\camlibs\ptp2)

	{ N_("Shutter Speed"), 					"shutterspeed", 			PTP_DPC_RICOH_ShutterSpeed, 			PTP_VENDOR_MICROSOFT, 		PTP_DTC_UINT64, _get_Ricoh_ShutterSpeed, _put_Ricoh_ShutterSpeed },	

Line was added after this line:

{ N_("Shutter Speed"), "shutterspeed", PTP_DPC_RICOH_ShutterSpeed, PTP_VENDOR_PENTAX, PTP_DTC_UINT64, _get_Ricoh_ShutterSpeed, _put_Ricoh_ShutterSpeed },

human readable white balance values by Dahlo Park

this is git diff in libgphoto2 root dir.

diff --git a/camlibs/ptp2/config.c b/camlibs/ptp2/config.c
index 5b5e057a7..ed55ad508 100644
--- a/camlibs/ptp2/config.c
+++ b/camlibs/ptp2/config.c
@@ -1496,6 +1496,17 @@ static struct deviceproptableu16 whitebalance[] = {
        { N_("Fluorescent: Day White"), 0x8004, PTP_VENDOR_PENTAX },
        { N_("Fluorescent: White"),     0x8005, PTP_VENDOR_PENTAX },
        { N_("Fluorescent: Tungsten"),  0x8006, PTP_VENDOR_PENTAX },
+
+       { N_("Shade"),                  0x8001, PTP_VENDOR_MICROSOFT },
+       { N_("Cloudy"),                 0x8002, PTP_VENDOR_MICROSOFT },
+       { N_("Tungsten 2"),             0x8020, PTP_VENDOR_MICROSOFT },
+       { N_("Fluorescent: Daylight"),  0x8003, PTP_VENDOR_MICROSOFT },
+       { N_("Fluorescent: Day White"), 0x8004, PTP_VENDOR_MICROSOFT },
+       { N_("Fluorescent: White"),     0x8005, PTP_VENDOR_MICROSOFT },
+       { N_("Fluorescent: Tungsten"),  0x8006, PTP_VENDOR_MICROSOFT },
+       { N_("CT settings"),            0x8007, PTP_VENDOR_MICROSOFT },
+       { N_("Underwater"),             0x8008, PTP_VENDOR_MICROSOFT },
+
 };
 GENERIC16TABLE(WhiteBalance,whitebalance)

gphoto2 examples

camera summary info

gphoto2 --summary
Camera summary:                                                                
Manufacturer: Ricoh Company, Ltd.
Model: RICOH THETA X
  Version: 1.30.0
  Serial Number: 14010001
Vendor Extension ID: 0x6 (1.10)
Vendor Extension Description: 

set to video mode

gphoto2 --set-config=5013=32770

start video

gphoto2 --set-config movie=1

stop video

gphoto2 --set-config=/main/actions/opcode=0x1018,0xFFFFFFFF

start video and stop after specified time

gphoto2 --set-config movie=1 --wait-event=10s --set-config movie=0 

get current shutter speed

gphoto2 --get-config shutterspeed
Label: Shutter Speed                                                           
Readonly: 0
Type: RADIO
Current: Auto
Choice: 0 Auto
END

set exposure program to shutter priority

gphoto2 --set-config=/main/other/500e=4

get shutterspeed when camera set to shutter priority

 gphoto2 --get-config shutterspeed
Label: Shutter Speed                                                           
Readonly: 0
Type: RADIO
Current: 1/250
Choice: 0 1/16000
Choice: 1 1/12800
Choice: 2 1/10000
Choice: 3 1/8000
Choice: 4 1/6400
Choice: 5 1/5000
Choice: 6 1/4000
Choice: 7 1/3200
Choice: 8 1/2500
Choice: 9 1/2000
Choice: 10 1/1600
Choice: 11 1/1250
Choice: 12 1/1000
Choice: 13 1/800
Choice: 14 1/640
Choice: 15 1/500
Choice: 16 1/400
Choice: 17 1/320
Choice: 18 1/250
Choice: 19 1/200
Choice: 20 1/160
Choice: 21 1/125
Choice: 22 1/100
Choice: 23 1/80
Choice: 24 1/60
Choice: 25 1/50
Choice: 26 1/40
Choice: 27 1/30
Choice: 28 1/25
Choice: 29 1/20
Choice: 30 1/15
Choice: 31 1/13
Choice: 32 1/10
Choice: 33 1/8
Choice: 34 1/6
Choice: 35 1/5
Choice: 36 1/4
Choice: 37 1/3
Choice: 38 10/25
Choice: 39 1/2
Choice: 40 10/16
Choice: 41 10/13
Choice: 42 1/1
Choice: 43 13/10
Choice: 44 16/10
Choice: 45 2/1
Choice: 46 25/10
Choice: 47 32/10
Choice: 48 4/1
Choice: 49 5/1
Choice: 50 6/1
Choice: 51 8/1
Choice: 52 10/1
Choice: 53 13/1
Choice: 54 15/1
END

set shutterspeed to 1/1600

gphoto2 --set-config-index shutterspeed=10

get shutterspeed to verify setting

Current is 1/1600, which is choice 10.

gphoto2 --get-config shutterspeed
Label: Shutter Speed                                                           
Readonly: 0
Type: RADIO
Current: 1/1600

Set Back to Mode 2, Auto

gphoto2 --set-config=/main/other/500e=2

Reconfirm Auto

gphoto2 --get-config shutterspeed
Label: Shutter Speed                                                           
Readonly: 0
Type: RADIO
Current: Auto
Choice: 0 Auto

get white balance

gphoto2 --get-config /main/imgsettings/whitebalance
Label: WhiteBalance                                                            
Readonly: 0
Type: RADIO
Current: Fluorescent: White
Choice: 0 Automatic
Choice: 1 Daylight
Choice: 2 Shade
Choice: 3 Cloudy
Choice: 4 Tungsten
Choice: 5 Tungsten 2
Choice: 6 Fluorescent: Daylight
Choice: 7 Fluorescent: Day White
Choice: 8 Fluorescent: White
Choice: 9 Fluorescent: Tungsten
Choice: 10 CT settings
Choice: 11 Underwater
END

take picture

gphoto2 --trigger-capture

disable image stitching

gphoto2 --set-config /main/other/d834=2

enable image stitching

gphoto2 --set-config /main/other/d834=1

put camera to sleep

gphoto2 --set-config=/main/other/d80e=1

wake camera up from sleep

gphoto2 --set-config=/main/other/d80e=0