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).

Contents

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
“RicStillCaptureStdBurst” Still Image Shooting (Burst Capture Mode)
(RICOH THETA Z1 firmware v2.00.1 or later)
“RicStillCaptureWDR” DR Correction
“RicStillCaptureMultiRawNR” Noise Reduction
“RicStillCaptureMultiYuvHdr” HDR Composite
“RicStillCaptureMultiYuvHhHdr” Handheld HDR Composite
(RICOH THETA Z1 firmware v1.20.1 or later and RICOH THETA V firmware v3.10.1 or later)
“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 sec
1 1/20000 sec
2 1/16000 sec
3 1/12500 sec
4 1/10000 sec
5 1/8000 sec
6 1/6400 sec
7 1/5000 sec
8 1/4000 sec
9 1/3200 sec
10 1/2500 sec
11 1/2000 sec
12 1/1600 sec
13 1/1250 sec
14 1/1000 sec
15 1/800 sec
16 1/640 sec
17 1/500 sec
18 1/400 sec
19 1/320 sec
20 1/250 sec
21 1/200 sec
22 1/160 sec
23 1/125 sec
24 1/100 sec
25 1/80 sec
26 1/60 sec
27 1/50 sec
28 1/40 sec
29 1/30 sec
30 1/25 sec
31 1/20 sec
32 1/15 sec
33 1/13 sec
34 1/10 sec
35 1/8 sec
36 1/6 sec
37 1/5 sec
38 1/4 sec
39 1/3 sec
40 1/2.5 sec
41 1/2 sec
42 1/1.6 sec
43 1/1.3 sec
44 1 sec
45 1.3 sec
46 1.6 sec
47 2 sec
48 2.5 sec
49 3.2 sec
50 4 sec
51 5 sec
52 6 sec
53 8 sec
54 10 sec
55 13 sec
56 15 sec
57 20 sec
58 25 sec
59 30 sec
62 60 sec

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

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 Ev
-5 -1.7 Ev
-4 -1.3 Ev
-3 -1.0 Ev
-2 -0.7 Ev
-1 -0.3 Ev
0 0.0 Ev
1 0.3 Ev
2 0.7 Ev
3 1.0 Ev
4 1.3 Ev
5 1.7 Ev
6 2.0 Ev

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

Burst Capture Mode

Burst Capture Mode is to shoot JPEG or DNG images as the highest FPS capturing, upto 9 frames as maximum. Remark

  • Set RIC_SHOOTING_MODE to “RicStillCaptureStdBurst” before “startPreview”.
  • “PictureCallBack” will be sent to application layer same times as the number of captured frames.
  • When using RIC_DNG_OUTPUT_ENABLED=1, this mode will output DNG images only. JPEG images cannot be output.
  • DNG images will be stored in DCIM/0/temp[0-8].dng.
  • This feature can be used with RICOH THETA Z1 firmware v2.00 or later

To set the number of burst capture frames, set value (int type) for “RIC_AEC_BURST_CAPTURE_NUM”. Default value is 1.

Value Description
1 1 frame
3 3 frames
5 5 frames
7 7 frames
9 9 frames

To set the bracket step of burst capture mode, set value (int type) for “RIC_AEC_BURST_BRACKET_STEP”. Default value is 0.

Value Description
0 0.0 Ev, this means to capture all frames with same exposure setting.
1 0.3 Ev
2 0.7 Ev
3 1.0 Ev
4 1.3 Ev
5 1.7 Ev
6 2.0 Ev
7 2.3 Ev
8 2.7 Ev
9 3.0 Ev

To set the exposure compensation of burst capture mode, set value (int type) for “RIC_AEC_BURST_COMPENSATION”. Default value is 0.

Value Description
-15 -5.0 Ev
-14 -4.7 Ev
-13 -4.3 Ev
-12 -4.0 Ev
-11 -3.7 Ev
-10 -3.3 Ev
-9 -3.0 Ev
-8 -2.7 Ev
-7 -2.3 Ev
-6 -2.0 Ev
-5 -1.7 Ev
-4 -1.3 Ev
-3 -1.0 Ev
-2 -0.7 Ev
-1 -0.3 Ev
0 0.0 Ev
1 +0.3 Ev
2 +0.7 Ev
3 +1.0 Ev
4 +1.3 Ev
5 +1.7 Ev
6 +2.0 Ev
7 +2.3 Ev
8 +2.7 Ev
9 +3.0 Ev
10 +3.3 Ev
11 +3.7 Ev
12 +4.0 Ev
13 +4.3 Ev
14 +4.7 Ev
15 +5.0 Ev

To set the upper limit of exposure time of burst capture mode, set value (int type) for “RIC_AEC_BURST_MAX_EXPOSURE_TIME”. Default value is 56.

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

To set “RIC_AEC_BURST_ENABLE_ISO_CONTROL” to 1, ISO sensitivity will be set higher value when exposure time reach to RIC_AEC_BURST_MAX_EXPOSURE_TIME. Default value is 0.

Value Description
0 Disable to auto ISO control. This means to set always ISO80 when auto exposure mode.
1 Enable to auto ISO control. This means to allow higher ISO sensitivity.