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	Option iso
shutterSpeed	enum (of integer or number)	no	Option shutterSpeed
_colorTemperature	integer	no	Option _colorTemperature
exposureProgram	enum (of integer)	yes	Option exposureProgram
aperture	enum (of integer or number)	no	Option aperture
exposureCompensation	enum (of number)	no	Option exposureCompensation
whiteBalance	enum (of string)	yes	Option whiteBalance

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:

• 1
• 2
• 3
• 4
• 9

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:

• 0
• 2.1
• 2.4
• 3.5
• 5.6

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”

---