ChimeraX docs icon

Command: zoom

zoomfactor ] [ frames  N ] [ pixelSize  size ]

The zoom command adjusts the apparent size of viewed items by factor relative to the current display. If near and/or far clipping planes are active, their positions are adjusted to compensate. See also: view, camera, mousemode , scalebar, Side View, making movies

The factor must be positive:

The change is spread out over a specified number of image update frames N (default 1). The apparent size is multiplied by an equal value at each frame as needed to achieve the final result.

Alternatively or in addition to factor, the pixelSize option can be used to specify the absolute scale in length per pixel at the current center of rotation (in data coordinate units, typically Å). The depth of this point matters when perspective is used, because nearby objects appear larger than faraway objects. A constant pixel size is useful for making multiple images at the same scale. If factor is also given, it is applied after the pixel size to calculate the overall (final) amount of zoom.

Given without argments, zoom reports the absolute scale at the current center of rotation.

The zoom command moves the camera toward or away from the scene. It does not change model coordinates.

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