API reference - Ricoh Theta

Option _autoBracket

	Definitions
Type	`object`

Description: Multi bracket shooting setting.

Example:

{
    "_bracketNumber": 2,
    "_bracketParameters": [
        {
            "exposureProgram": 1,
            "iso": 100,
            "shutterSpeed": 0.01,
            "whiteBalance": "auto"
        },
        {
            "_colorTemperature": 5000,
            "exposureProgram": 1,
            "iso": 400,
            "shutterSpeed": 0.0025,
            "whiteBalance": "_colorTemperature"
        }
    ]
}

Property	Type	Required	Description
_bracketNumber	integer	yes	Number of shots in multi bracket shooting.
_bracketParameters	array	yes	List of parameters specified for multi bracket shooting.

_bracketNumber

	Definitions
Type	`integer`

Description: Number of shots in multi bracket shooting.

	Restrictions
Minimum	≥ 2
Maximum	≤ 13

_bracketParameters

	Definitions
Type	`array`

Description: List of parameters specified for multi bracket shooting.

	Array restrictions
Min items	N/A
Max items	N/A

Each item of this array must be	Description
bracketParameter	Parameter for a shot. Theta X supports only 1 (manual program) for exposureProgram. Others than Theta Z1 do not support aperture.

bracketParameter

	Definitions
Type	`object`

Description: Parameter for a shot. Theta X supports only 1 (manual program) for exposureProgram. Others than Theta Z1 do not support aperture.

Property	Type	Required	Description
iso	enum (of integer)	no	ISO sensitivity. 0 means auto. Only Theta X supports 50 and 64. Only Theta Z1 supports 4000, 5000 and 6400. This option value is retained separately for each of still image shooting mode and video shooting mode.
shutterSpeed	enum (of integer or number)	no	Shutter speed (seconds). See detail descriptions.
_colorTemperature	integer	no	Color temperature setting of Theta (Kelvin). To enable this option, set the value `”_colorTemperature”` to whiteBalance option. This option value is retained separately for each of still image shooting mode and video shooting mode.
exposureProgram	enum (of integer)	yes	Current exposure program. This option value is retained separately for each of still image shooting mode and video shooting mode. 1 Manual program 2 Normal program. Exposure settings are all set automatically. 3 Aperture priority program. Theta Z1 only 4 Shutter priority program 9 ISO priority program
aperture	enum (of integer or number)	no	Aperture value. Others than Theta Z1, aperture value is fixed so that you need not to care of this option. Value 0 means auto aperture. Possible values for Theta Z1 is 0, 2.1, 3.5 and 5.6. Possible values for Theta X is 0 and 2.4.
exposureCompensation	enum (of number)	no	Exposure compensation (EV). This option value is retained separately for each of still image shooting mode and video shooting mode. If the exposure program is set to manual program, the value of this option is 0.
whiteBalance	enum (of string)	yes	White balance. See detail descritions.

iso

	Definitions
Type	`enum (of integer)`

Description: ISO sensitivity. 0 means auto. Only Theta X supports 50 and 64. Only Theta Z1 supports 4000, 5000 and 6400.
This option value is retained separately for each of still image shooting mode and video shooting mode.

Must be one of:

0
50
64
80
100
125
160
200
250
320
400
500
640
800
1000
1250
1600
2000
2500
3200
4000
5000
6400

shutterSpeed

	Definitions
Type	`enum (of integer or number)`

Description: Shutter speed (seconds). See detail descriptions.

Must be one of:

0
0.00004
0.00005
0.0000625
0.00007812
0.00008
0.0001
0.000125
0.00015625
0.0002
0.00025
0.0003125
0.0004
0.0005
0.000625
0.0008
0.001
0.00125
0.0015625
0.002
0.0025
0.003125
0.004
0.005
0.00625
0.008
0.01
0.0125
0.01666666
0.02
0.025
0.03333333
0.04
0.05
0.06666666
0.07692307
0.1
0.125
0.16666666
0.2
0.25
0.33333333
0.4
0.5
0.625
0.76923076
1
1.3
1.6
2
2.5
3.2
4
5
6
8
10
13
15
20
25
30
40
50
60

_colorTemperature

	Definitions
Type	`integer`

Description: Color temperature setting of Theta (Kelvin).
To enable this option, set the value "_colorTemperature" to whiteBalance option.
This option value is retained separately for each of still image shooting mode and video shooting mode.

Restrictions
Multiple of	100
Minimum	≥ 2500
Maximum	≤ 10000

exposureProgram

	Definitions
Type	`enum (of integer)`

Description: Current exposure program.
This option value is retained separately for each of still image shooting mode and video shooting mode.

1: Manual program
2: Normal program. Exposure settings are all set automatically.
3: Aperture priority program. Theta Z1 only
4: Shutter priority program
9: ISO priority program

Must be one of:

aperture

	Definitions
Type	`enum (of integer or number)`

Description: Aperture value.
Others than Theta Z1, aperture value is fixed so that you need not to care of this option.
Value 0 means auto aperture. Possible values for Theta Z1 is 0, 2.1, 3.5 and 5.6. Possible values for Theta X is 0 and 2.4.

Must be one of:

exposureCompensation

	Definitions
Type	`enum (of number)`

Description: Exposure compensation (EV).
This option value is retained separately for each of still image shooting mode and video shooting mode.
If the exposure program is set to manual program, the value of this option is 0.

Must be one of:

-2.0
-1.7
-1.3
-0.7
-0.3
0.0
0.3
0.7
1.0
1.3
1.7
2.0

whiteBalance

	Definitions
Type	`enum (of string)`

Description: White balance. See detail descritions.

Must be one of:

“auto”
“daylight”
“shade”
“cloudy-daylight”
“incandescent”
“_warmWhiteFluorescent”
“_dayLightFluorescent”
“_dayWhiteFluorescent”
“fluorescent”
“_bulbFluorescent”
“_colorTemperature”
“_underwater”