RICOH THETA Disable Auto-Level topBottomCorrection for Interval Shooting

People often want to disable auto-level for interval shooting. There is no way to do this through the official mobile app or the LCD screen.

The API provides several options.

RICOH THETA API: https://github.com/ricohapi/theta-api-specs/blob/main/theta-web-api-v2.1/options/_top_bottom_correction.md

_topBottomCorrection

Overview

Sets the top/bottom correction.
For RICOH THETA V and RICOH THETA Z1, the top/bottom correction can be set only for still images.
For RICOH THETA X, the top/bottom correction can be set for both still images and videos.

Can be acquired by camera.getOptions and set by camera.setOptions.

Support model

X Z1 V SC S
All All v3.00.1 or later

Support value

Key Description
Apply Top/bottom correction is performed.
ApplyAuto Refer to top/bottom correction when shooting with “ApplyAuto”
ApplySemiAuto Top/bottom correction is performed. The parameters used for top/bottom correction for the first image are saved and used for the 2nd and subsequent images.(RICOH THETA X or later)
ApplySave Performs top/bottom correction and then saves the parameters.
ApplyLoad Performs top/bottom correction using the saved parameters.
Disapply Does not perform top/bottom correction.
Manual*1 Performs the top/bottom correction with the specified front position. The front position can be specified with _topBottomCorrectionRotation.

*1 RICOH THETA X firmware v1.20.0 or later

Restrictions based on the shooting method

Model Shooting method Description
V, Z1 Move interval shooting
Interval composite shooting
Time shift shooting
Shoots with "Apply" regardless of the specified Key
Fixed interval shooting
Multi-bracketing shooting
Shoots with "ApplyAuto" regardless of the specified Key

Top/bottom correction when shooting with “ApplyAuto”

Model Shooting method Description
V, Z1 Interval shooting
Fixed interval shooting
Multi-bracketing shooting
The parameters used for top/bottom correction for the first image are saved and used for the 2nd and subsequent images.
Normal shooting Top/bottom correction is performed.
X Multi-bracketing shooting The parameters used for top/bottom correction for the first image are saved and used for the 2nd and subsequent images.
Except for Multi-bracketing shooting Top/bottom correction is performed.

Insomnia API Tester

Insomnia provides a desktop GUI to configure and save different API commands.

This is the header for the same request.

image

Android API Tester

There are many free Android apps that you can use to save and run API commands on your mobile phone. This is a good option if you’re in the field and want to disapply and apply the auto-level.

image

endpoint and header

post data

image

curl command

You can also use curl from the command line.

curl --request POST \
  --url http://192.168.1.1/osc/commands/execute \
  --header 'Content-Type: application/json;charset=utf-8' \
  --data '{
        "name": "camera.setOptions",
        "parameters": {
                "options": {
                        "_topBottomCorrection": "Disapply"
                }
        }
}'