Camera API

RICOH THETA models V and Z1 support android.hardware.Camera. They do not support android.hardware.camera2. When using the Camera API, notify the camera device control.

Besides Android standard API, RICOH THETA V and Z1 shoot using their original parameters listed below. The original parameters are set using Camera.Parameters set (String key, String value) or set (String key, int value).

Shooting Mode

To set shooting mode, set value (String type) for “RIC_SHOOTING_MODE”. Before shooting, set RIC_SHOOTING_MODE as RicMonitoring. Then, as shooting request arrives, set one of the below listed complying with shooting application. When shooting is over, reset to RicMonitoring.

Value Description
“RicMonitoring” Monitoring
“RicMoviePreview640” Live View (640x320)
“RicMoviePreview1024” Live View (1024x512)
“RicMoviePreview1920” Live View (1920x960)
“RicMoviePreview3840” Live View (3840x1920)
“RicStillCaptureStd” Still Image Shooting
“RicStillCaptureWDR” DR Correction
“RicStillCaptureMultiRawNR” Noise Reduction
“RicStillCaptureMultiYuvHdr” HDR Composite
“RicMovieRecording4kEqui” Equirectangular Formatted Movie (3840x1920)
“RicMovieRecording4kDual” Dual-Fisheye Formatted Movie (3840x1920)
“RicMovieRecording2kEqui” Equirectangular Formatted Movie (1920x960)
“RicMovieRecording2kDual” Dual-Fisheye Formatted Movie (1920x960)

Stitching

To set stitching, set the value (String type) for “RIC_PROC_STITCHING”.

Value Description
“RicNonStitching” For Dual Fish Eye Image
“RicStaticStitching” For Static Stitching
“RicDynamicStitchingAuto” For Dynamic Stitching
“RicDynamicStitchingSave” For the first shot of continuous capture
“RicDynamicStitchingLoad” For the second shot or later shots of continuous capture

Zenith Correction

Set the zenith correction method using “RIC_PROC_ZENITH_CORRECTION”.

Value Description
“RicZenithCorrectionOff” Off
“RicZenithCorrectionOnAuto” Auto Zenith Correction
“RicZenithCorrectionOnSave” With Zenith Correction, save correction parameters
“RicZenithCorrectionOnLoad” Zenith Correction using saved correction parameters

Exposure Program

To set the exposure program, set the value (String type) for “RIC_EXPOSURE_MODE”.

Value Description
“RicManualExposure” Manual Exposure Mode for normal
“RicAutoExposureP” Program Auto Exposure Mode
“RicAutoExposureA” Av priority Auto Exposure mode. Iris setting (RICOH THETA Z1 only)
“RicAutoExposureT” Tv Priority Auto Exposure Mode. Exposure time
“RicAutoExposureS” Sv Priority Auto Exposure Mode, Exposure gain
“RicAutoExposureWDR” For Dynamic Range Compensation (WDR) Mode

Automatic Exposure Lock

Set “RIC_EXPOSURE_LOCK” to enable or disable the auto exposure compensation function.

Value Description
0 unlocked
1 locked

Shutter Speed

To set shutter speed, set the values (int type) for “RIC_MANUAL_EXPOSURE_TIME_FRONT” and “RIC_MANUAL_EXPOSURE_TIME_REAR”. When “RIC_EXPOSURE_MODE” is “RicManualExposure”, longer than 1/8 sec can be set. When “RIC_EXPOSURE_MODE” is “RicAutoExposureT”, from 1/25000 to 1/8 can be set. When “RIC_EXPOSURE_MODE” is “RicAutoExposureP”, “RicAutoExposureA”, “RicAutoExposureS”, or “RicAutoExposureWDR”, only AUTO can be set. It is recommended that the same value be set for “RIC_MANUAL_EXPOSURE_TIME_FRONT” and “RIC_MANUAL_EXPOSURE_TIME_REAR”. There is no guarantee of the action if different values are set.

Value Description
-1 Auto
0 1/25000
1 1/20000
2 1/16000
3 1/12500
4 1/10000
5 1/8000
6 1/6400
7 1/5000
8 1/4000
9 1/3200
10 1/2500
11 1/2000
12 1/1600
13 1/1250
14 1/1000
15 1/800
16 1/640
17 1/500
18 1/400
19 1/320
20 1/250
21 1/200
22 1/160
23 1/125
24 1/100
25 1/80
26 1/60
27 1/50
28 1/40
29 1/30
30 1/25
31 1/20
32 1/15
33 1/13
34 1/10
35 1/8
36 1/6
37 1/5
38 1/4
39 1/3
40 1/2.5
41 1/2
42 1/1.6
43 1/1.3
44 1
45 1.3
46 1.6
47 2
48 2.5
49 3.2
50 4
51 5
52 6
53 8
54 10
55 13
56 15
57 20
58 25
59 30
62 60

ISO Sensitivity

To set ISO sensitivity, set the value (int type) for “RIC_MANUAL_EXPOSURE_ISO_FRONT” and “RIC_MANUAL_EXPOSURE_ISO_REAR”. When “RIC_EXPOSURE_MODE” is “RicAutoExposureP”, “RicAutoExposureA”, “RicAutoExposureT”, or “RicAutoExposureWDR”, only AUTO can be set. It is recommended that the same value be set for “RIC_MANUAL_EXPOSURE_ISO_FRONT” and “RIC_MANUAL_EXPOSURE_ISO_REAR”. There is no guarantee of the action if different values are set.

When the model of the camera is RICOH THETA V, in image shooting mode, a value of 64 to 3200 can be set. When the model of the camera is RICOH THETA V, in video recording mode, a value of 64 to 6400 can be set. When the model of the camera is RICOH THETA Z1, in image shooting mode or video recording mode, a value of 80 to 6400 can be set.

Value Description
-1 Auto
1 64
2 80
3 100
4 125
5 160
6 200
7 250
8 320
9 400
10 500
11 640
12 800
13 1000
14 1250
15 1600
16 2000
17 2500
18 3200
19 4000
20 5000
21 6400

ISO Sensitivity Upper Limit

Set the ISO sensitivity upper limit with “RIC_AEC_MAXISO_STILL” for images and “RIC_AEC_MAXISO_VIDEO” for videos.

When the model of the camera is RICOH THETA V, in image shooting mode, a value of 200 to 3200 can be set. When the camera model is RICOH THETA V, and it is in movie shooting mode, a value of 200 to 6400 can be set. When the model of the camera is RICOH THETA Z1, in image shooting mode or video recording mode, a value of 200 to 6400 can be set.

Value Description
6 200
7 250
8 320
9 400
10 500
11 640
12 800
13 1000
14 1250
15 1600
16 2000
17 2500
18 3200
19 4000
20 5000
21 6400

Aperture

To set aperture, set the value (int type) for “RIC_MANUAL_EXPOSURE_AV_FRONT” and “RIC_MANUAL_EXPOSURE_AV_REAR”. When “RIC_EXPOSURE_MODE” is “RicAutoExposureP”, “RicAutoExposureT”, “RicAutoExposureS”, or “RicAutoExposureWDR”, only AUTO can be set. It is recommended that the same value be set for “RIC_MANUAL_EXPOSURE_AV_FRONT” and “RIC_MANUAL_EXPOSURE_AV_REAR”. There is no guarantee of the action if different values are set.

Value Description
0 Auto
1 F2.1
2 F3.5
3 F5.6

White Balance

To set white balance, set the value (String type) for “RIC_WB_MODE”.

Value Description
“RicWbAuto” Same as WHITE_BALANCE_AUTO
“RicWbPreviousGain” Use same gain as previous WB (not update WB)
“RicWbPrefixTemperature” Use color temperature
“RicWbPrefixDaylight” Same as WHITE_BALANCE_DAYLIGHT
“RicWbPrefixShade” Same as WHITE_BALANCE_SHADE
“RicWbPrefixCloudyDaylight” Same as WHITE_BALANCE_CLOUDY_DAYLIGHT
“RicWbPrefixIncandescent” Same as WHITE_BALANCE_INCANDESCENT
“RicWbPrefixFluorescentWW” Same as WHITE_BALANCE_WARM_FLUORESCENT
“RicWbPrefixFluorescentD” Daylight Fluorescent
“RicWbPrefixFluorescentN” Daywhite Fluorescent
“RicWbPrefixFluorescentW” Same as WHITE_BALANCE_FLUORESCENT
“RicWbPrefixFluorescentL” Bulb Fluorescent
“RicWbPrefixTwilight” Same as WHITE_BALANCE_TWILIGHT

Color Temperature

When “RicWbManualGain” is set in white balance, then set the value (int type) for “RIC_WB_TEMPERATURE” in the Color Temperature setting.

Value Description
2500 - 10000 Range: Between 2500-10000K

Exposure Compensation

To set exposure compensation, set the value (int type) for “exposure-compensation-step”. When “RIC_EXPOSURE_MODE” is “RicManualExposure”, it can only be set to 0.0. When “RIC_EXPOSURE_MODE” is “RicAutoExposureP”, “RicAutoExposureA”, “RicAutoExposureT”, “RicAutoExposureS”, or “RicAutoExposureWDR”, from -2.0 to 2.0 can be set.

Value Description
-6 -2.0
-5 -1.7
-4 -1.3
-3 -1.0
-2 -0.7
-1 -0.3
0 0.0
1 0.3
2 0.7
3 1.0
4 1.3
5 1.7
6 2.0

Canceling Long Exposure

When photographing with the shutter speed set to longer than 1/8 sec, it is called Long Exposure Photography. Long Exposure can be cancelled during photographing. To cancel Long Exposure, set the value (String type) for “RIC_CAPTURE_BREAK”.

Value Description
“RicStillCaptureBreak” Set by setParameters (). When executed, the SlowShutterBreak sequence is executed.
“RicStillCaptureNonBreak” Set by setParameters (). Execute onPictureTaken () before stopPreview ().

Activate Image File Size Specification

Set “RIC_JPEG_COMP_FILESIZE_ENABLED” to enable or disable the image file size specified by “RIC_JPEG_COMP_FILESIZE”.

Value Description
0 disable
1 enable

Image File Size

Set the image file size with “RIC_JPEG_COMP_FILESIZE”.

From 1048576 (1MByte) to 12582912 (12MByte)

Switching DNG Output

Set activation / deactivation of DNG file output with “RIC_DNG_OUTPUT_ENABLED”.

Value Description
0 disable
1 enable