ChimeraX docs icon

Command: clip

clipnear  offsetnear | off ] [ far  offsetfar | off ] [ front  offsetfront | off ] [ back  offsetback | off ] [ position  refpoint ] [ axis  normal ] [ coordinateSystem  model-spec ]

clip  off

clip  list

The clip command controls clipping planes. Up to four planes can be active:

If given without arguments, clip acts like clip front 0. The command clip off turns off all clipping planes, whereas clip list reports the locations of any active clipping planes.

Capping of clipped surfaces can be controlled with a preference setting and/or the surface cap command. See also: view, mousemode

Each plane can be activated or turned off individually; specifying an offset activates a plane if it was not already active. Offsets are in physical distance units (generally Å), with positive values increasing away from the viewer for the near/far planes. The offsets are relative to the position reference point, if given. Otherwise, offsets are relative to the current positions of the planes, or (if a plane is newly activated) the center of the bounding box of displayed models. The position of a plane is forgotten when it is turned off.

The position refpoint can be given as:

The axis option sets front/back plane orientation, where the normal (the axis perpendicular to the plane) can be given as:

The coordinateSystem for interpreting position and axis coordinates can be specified by reference model number. Otherwise, the screen coordinate system (X horizontal, Y vertical, Z in/out of screen) will be used. The default initial orientation of front/back planes is normal to the screen Z-axis or line of sight.

UCSF Resource for Biocomputing, Visualization, and Informatics / January 2018