The Viewing Tool has five sections shown as index cards, Camera, Effects, Rotation, Side View, and Lighting. Only one card is shown at a time, and clicking the tab for another brings it to the front.

For just the section being shown: Reset replaces the current settings with the original "factory" defaults, Restore replaces the current settings with those previously saved in the preferences file, and Save saves the current settings to the preferences file. Close dismisses the Viewing Tool, and Help opens this manual page in a browser window.

Camera

The Camera section of the Viewing Tool controls several aspects of the view, including stereo parameters. There are several ways to start Camera, a tool in the Viewing Controls category. Default settings are indicated in bold. See also: stereo, set projection

• camera mode - refers to any of several stereo and mono viewing options (details...):
  • mono (default, not in stereo)
  • stereo left eye
  • stereo right eye
  • cross-eye stereo
  • wall-eye stereo
  • red-cyan stereo - overlapping left-eye and right-eye views in different colors, to be viewed with "glasses" (often inexpensive cardboard/plastic) with colored filters
  • sequential stereo - rapid flickering between left-eye and right-eye views, to be viewed with special synchronised glasses. Sequential stereo is not always available.
  • reverse sequential stereo - as above, but with the opposite convention for the two views
  • row stereo, right eye even - row-interleaved with even rows used for the right-eye view
  • row stereo, right eye odd - row-interleaved with odd rows used for the right-eye view
  • DTI side-by-side stereo
• projection (perspective/orthographic) - perspective makes farther-away objects smaller, and is indicated in the Side View by red lines diverging from the eye position. An orthographic projection has no scaling-with-distance effect, and is indicated in the Side View by horizontal red lines.
• scale factor (1 when a structure is first opened) - a factor reflecting the cumulative effects of scaling with the mouse, the Side View, and/or the command scale
• near plane - Z-coordinate of the front global clipping plane
• far plane - Z-coordinate of the back global clipping plane
• horizontal field of view (allowed range 1.0-179.0°) - how much perspective is used; does not affect the orthographic projection. The vertical field of view will change along with the horizontal field of view, but their exact relationship depends on the aspect ratio of the graphics window.
• Stereo parameters
  • units (millimeters/centimeters/inches) - units for the following stereo parameters
  • eye separation (2.0 inches) - effective distance between the left and right eyes
  • distance to screen - effective distance from the viewer to the screen (or focal plane, even though items out of this plane do not appear "out of focus"). When viewed in stereo, items in front of the focal plane will appear to project from the screen, and items behind the plane will appear to recede behind the screen.
  • screen width - physical width of the entire screen (not just the graphics window). The value is initially what is reported by the windowing system, but it can be edited. Changing the value does not resize the graphics window.

  The eye separation and distance to screen govern the parallax between the left- and right-eye views. The horizontal field of view, distance to screen, and screen width are interdependent. The graphics window width is determined from the screen width and the known pixel dimensions of the screen and graphics window. The horizontal field of view is computed from the graphics window width and the distance to screen. For a given graphics window width, the horizontal field of view and distance to screen are inversely related; changing one changes only the other, in the opposite direction. Changing the screen width or resizing the graphics window changes only the horizontal field of view, in the same direction.

Effects

The Effects section of the Viewing Tool controls visual effects such as depth cueing. There are several ways to start Effects, a tool in the Viewing Controls category. Default settings are indicated in bold. See also: set

• depth cueing (on by default) refers to front-to-back shading with the depth-cueing color. The shading increases linearly from start to end.
  • start (0.5) - where depth-cueing starts, relative to the front (0.0) and back (1.0) global clipping planes; values outside the 0-1 range are allowed
  • end (1.0) - where depth-cueing attains full strength, relative to the front (0.0) and back (1.0) global clipping planes; values outside the 0-1 range are allowed
  • color (a color well, No Color by default) - the color used for front-to-back shading (depth cueing). When set to No Color, the shading color will be the same as the background color.
  
  
• silhouettes (off by default) highlights borders and discontinuities with a thin outline in the silhouette color
  • color (a color well, No Color by default) - when set to No Color, the silhouette color will be gray if the background is black, otherwise black.
  • width (1.0) - silhouette linewidth
  
  
• subdivision quality (1.5, maximum 20.0) - the stick, ball-and-stick, sphere, and ribbon representations consist of curved surfaces approximated by collections of planes; increasing the subdivision quality increases the number of planes and the apparent smoothness. This setting also affects curved geometric objects defined in BILD format, but not molecular surfaces. Display presets adjust the subdivision quality to 1.5 (interactive) or 5.0 (publication).
• local viewer (true/false) - whether for lighting purposes the actual (local) position of the viewer is used. The alternative of treating the viewer as infinitely far away simplifies the lighting calculations and is more computationally expedient. The difference in appearance is generally quite subtle.
• transparent background (true/false) - whether to make the background in saved images transparent (regardless of the background color shown in Chimera). Not all systems have the hardware required to support background transparency. When this setting is true, PNG and TIFF images saved from the session will include opacity information, making them easier to composite with different backgrounds in image-editing applications. (Note: TIFF images with background transparency may not be interpreted correctly by Adobe Photoshop®.) Background transparency can also be enabled with the startup option --bgopacity. For background transparency in raytraced images, see the POV-Ray Options preferences.
• show shadows (true/false) - display interactive shadows to enhance 3D perception during interactive use and/or to preview shadow locations before saving a raytraced image. Not all platforms support this option.
• multisampling (true/false) - whether to use multiple samples per pixel so that edges are antialiased (the default setting depends on the graphics card). Most modern graphics cards support multisampling, although certain graphics driver bugs may necessitate turning it off. Multisampling can also be enabled with the startup option --multisample.

Rotation

The Rotation section of the Viewing Tool controls rotation behavior. There are several ways to start Rotation, a tool in the Movement category. See also: cofr, set independent

• center of rotation method:
  • fixed - at a fixed point relative to the model(s), see rotation center
  • center of models - at the center of the bounding sphere of the displayed parts of active models
  • independent - a separate center for each model rather than a single collective center
  • center of view - continually adjusted to the current center of view (in the middle of the window, halfway between the front and back global clipping planes)
  • front center (default) - when the view is zoomed out, behaves like center of models; when the view is zoomed in on parts of items, behaves like center of view, except the center of rotation depth (Z-coordinate) is set to that of the frontmost displayed unclipped atom whose VDW sphere intercepts a line perpendicular to the screen in the window center. The center is not updated when only rotations are performed.
• rotation center (X, Y, and Z coordinates in the laboratory frame of reference) - editable only when the center of rotation method is fixed, meaningless when models are set to rotate independently

Side View

The Side View section of the Viewing Tool provides a convenient and intuitive way to scale the view and to control clipping. There are several ways to start the Side View, a tool in the Viewing Controls category.

• The yellow square on the left represents the viewer's eye position. Dragging it horizontally with the left mouse button adjusts the scale factor. This does not change the stereo parameter distance to screen. Double-clicking the eye position brings up a menu for changing the camera mode.
  
  
• The vertical yellow lines represent the front and back (hither and yon) global clipping planes. Each can be dragged with the left mouse button. Dragging the hither plane with the middle or right mouse button moves both clipping planes in the same direction, while dragging the yon plane with the middle or right mouse button moves the clipping planes in opposite directions.
  
  
• The red lines emanating from the eye position show the field of vision. The lines diverge when perspective is used, but are parallel in the orthographic projection.

The Clip checkbox indicates global clipping status (on or off). Surface capping... brings up the Surface Capping dialog for controlling the appearance of planar caps where surfaces are sliced away.

Clicking View All turns off global clipping and adjusts the scale to include everything that is displayed. Model rotations and translations are not adjusted.

The default Side is right: it shows the relationship between the viewer and the Chimera scene from the viewer's right side. Setting View to top switches to a top view in which stereo parameters and perspective can be adjusted interactively.

Lighting

The Lighting section of the Viewing Tool allows lighting parameters to be changed and saved. There are several ways to start Lighting, a tool in the Viewing Controls category. See also: lighting, lighting details

Lighting includes two sections:

• Intensity
• Shininess

• Save the current settings to the name shown
• use Save As... to save the current settings with a new name
• Delete the style whose name is shown

The Intensity section includes:

• mode - the number and type of lights:
  • ambient - ambient light only
  • single - ambient light and one directional light (the key light)
  • two-point (default) - ambient light and two directional lights: key and fill
  • three-point - three directional lights: key, fill, and back (details...)
  By default, only the key light gives specular highlights, and the other lights are treated as shadowless during raytracing. The directional lights can be moved interactively by dragging the color-coded solid arrows on the sphere (green:key, purple:fill, red:back). The back light is restricted to the rim of the sphere. Outlines on the sphere in the two- and three-point modes represent commonly used positions for the key and fill lights.
• brightness (default 1.15; slider values range from 0.0 to 5.0) - the total diffuse (nonspecular) illumination of the scene
• contrast (default 0.7; slider values range from 0.0 to 20.0) - the ratio of the key light to other light(s), disregarding any specular contributions; higher contrast gives darker shading
• quality (normal/glossy) - the glossy setting uses an OpenGL shader to provide per-pixel lighting, which gives a glossy appearance, and angle-dependent transparency. This option is grayed out if not supported by the graphics driver or the current lighting mode. With normal lighting, specular highlights are only calculated at triangle vertices and linearly interpolated across triangles, and transparent triangles do not appear more opaque when viewed edge-on as compared to face-on. Separate but related settings can be found in the Shininess section.

Shininess

The Shininess interface controls the specular parameters of the viewed objects (rather than the light sources). Although part of the Lighting tool, Shininess is also handled as a separate tool in the Viewing Controls category. See also: lighting, lighting details

• sharpness (30.0 by default; ranges from 1.0 to 128.0) - refers to the "spread" of highlights; lower values yield larger, more diffuse highlights, while higher values yield more pointlike highlights. Technically, sharpness is the OpenGL specular exponent. The effective highlight intensity varies as the cosine of the angle between the view direction and the direction of the reflected light, raised to the power of this exponent.
• reflectivity (1.0 by default; ranges from 0.1 to 10.0) - scale factor for the components of the specular color (below). The resulting values may exceed 1.
• color (a color well, a light gray by default) - specular color, that used for shiny highlights. It is added to the color that would be shown in the absence of highlights. If the color is already bright white, highlights will not be discernable; if the color is nominally green and the specular color is red, the highlights will appear to be yellow. This explanation assumes that all light sources are white or gray; however, lights have their own diffuse and specular colors, which must be combined with that of the material.

The Shininess interface adjusts the material properties of the Chimera default material. Stick, ball-and-stick, sphere, and ribbon representations and molecular surfaces use the default material. It is not possible to independently control the shininess of different models that use the default material. Except for surfaces generated by Volume Viewer and Multiscale Models (for which special code was written), the properties of models that do not use the default material (VRML models, for example) are not adjusted.