ChimeraX docs icon

Command: graphics

graphicsatomTriangles  Na ] [ bondTriangles  Nb ] [ totalAtomTriangles  maxa ] [ totalBondTriangles  maxb ] [ ribbonDivisions  divisions ] [ ribbonSides  sides ] [ maxFrameRate  N ] [ frameRate  true | false ] [ waitForVsync  true | false ] [ colorDepth  8 | 16 ]

graphics  driver

graphics  restart

graphics  triangles  model-spec

The graphics command sets graphical rendering parameters and allows detailed control over object triangulation. Normally, the fineness of atom and bond triangulation is adjusted automatically depending on the display contents (e.g., the number of atoms displayed), within the ranges of 10-2000 triangles per atom and 24-160 per bond, up to maximum totals for atoms and bonds set with totalAtomTriangles and totalBondTriangles, respectively (initial default five million each, 5000000). Automatic adjustment can be tuned in either direction with set subdivision, and by default, vr temporarily lowers the limits on total triangles for faster rendering. See also: cartoon style

As an alternative to automatic adjustment, the graphics command allows using fixed numbers of triangles per atom and bond:

The maxFrameRate option sets the target frame rate in ChimeraX to Nf  frames per second (initial default 60). The actual redraw rate may be lower than the target, depending on the rendering speed of the computer and the complexity of the scene.

The frameRate option indicates whether to report the average frame rate each second in the status line (initial default false).

The waitForVsync option indicates whether to synchronize drawing to the display vertical refresh rate, typically 60 Hz (initial default usually true, but depends on the graphics driver settings). Without synchronization, the frame rate can exceed the vertical refresh rate and the display can exhibit image tearing.

The colorDepth option sets the number of bits used per color component (red, green, blue, and alpha) in offscreen framebuffers, with initial default 8. Switching to 16 bits causes all rendering to occur in an offscreen framebuffer and then get copied to the display, and may slow the frame rate by a factor of two or more. The 16-bit setting may improve the appearance of volume solid rendering if the color mode is also set to 16 bits, e.g., volume colorMode auto16.

Given without options, graphics reports the current triangles per atom and bond, ribbon divisions per residue, and maximum frame rate in the Log. The number of ribbon sides and divisions can be reported (or changed) with cartoon style, and the maximum frame rate can also be reported/changed with set.

Graphics subcommands:

UCSF Resource for Biocomputing, Visualization, and Informatics / March 2019