ChimeraX docs icon

Command: camera

Usage:
cameramode ] [ eyeSeparation  distance ] [ fieldOfView  field-angle ] [ convergence  angle ] [ pixelEyeSeparation  pixels ] [ cubePixels  cpixels ]

The camera command sets mono or stereo viewing and related parameters. If given without arguments, it reports the current settings in the Log, including position and view direction. See also: view, zoom, scalebar, getcrd, vr roomCamera, Side View, virtual reality, making images

The camera mode can be:

The eyeSeparation option specifies the distance between left- and right-eye viewpoints in scene distance units, usually Å, for all stereo modes (default 0.2 for 360° modes, otherwise 5.0).

The fieldOfView option specifies the horizontal angular field of view (default 30°) for all modes except 360° and orthographic.

The convergence option sets the angle of convergence between the eyes and applies only to the crosseye (default 10°) and walleye (default –5°) modes.

The pixelEyeSeparation option specifies the distance between left- and right-eye viewpoints in screen pixels (default 200) for sequential stereo only. This is usually determined adequately by the display, but adjustments may be needed for comfortable viewing when sequential stereo is projected.

The cubePixels option sets cube map size for the 360, 360sbs, 360tb, and dome modes (default 1024, meaning 1024 x 1024 pixels per cube face). Powers of 2 are recommended.

Restoring a mode will set parameters to the default values for that mode, except as specified in the command; previous settings are not retained.

Zooming in Stereo

In stereo modes (those with separate views for left and right eyes), the zoom mousemode adjusts the eye separation proportionally to moving the camera closer or farther away so that the apparent distance to a model stays the same while its apparent size changes. Holding the alt key (option key on Mac) in addition to the zoom-assigned button, however, moves the camera without changing the eye separation, allowing the apparent distance to be adjusted. See also: zooming in VR


UCSF Resource for Biocomputing, Visualization, and Informatics / June 2022