The New Ribbons Interface.

	Ribbons versions 2.5 and higher employ an X/Motif interface
	with an OpenGL graphics window.
	If you have never used ribbons 2.4 or below, ignore below
	and look at the Graphics section of the manual.
	Previous versions used IRIS GL calls for all graphics,
	including interaction with pop-up menus and control panels.
	Now the standard X/Motif calls handle all user interaction.

	Just try it out --- ribbons 2.5 is basically the same program.
	Hopefully the X/Motif style is already familiar to you.
	Its workings are briefly described by example below.
	Then new features, missing features, and bugs are enumerated.

	There is no longer a MainMenu popped up via the RightMouse button.
	A MenuBar across the top of the window handles most of these functions.
	Selection of an item on the MenuBar by pressing the LeftMouse button
	opens a pulldown menu of choices.
	Slide the cursor to highlight choices, and release button to select.

	For example, File is first item on the MenuBar.
	Selection presents a list whose first choice is "Save Image  Alt+i".
	Selecting saves the image on the screen to the disk.
	"Alt+i", meaning depress the 'Alt' and 'i' keys simultaneously,
	is a keyboard shortcut to invoke the action.
	!***! then hit the PrintScreen key to actually save. !***!

	All I/O operations and quiting the program are invoked through File.
	All I/O selections open the Motif file selection dialog box.
	Double click a filename or type it in and return to select.

	The MenuBar Edit choices all open Control Panels.
	This is similar to the old version, but there are more, smaller panels.
	Atoms, Bonds, Ndots, and Polys panels replace the old Geometry panel.
	Colors has been separated into Colors and Lights.
	Ribbons are adjusted by three panels:  
	Style (coloring and selection), Dimensions (thickness and width), 
	and Nprimitives (complexity and textures). 

	The MenuBar Models replaces the 'models' submenu from MainMenu.
	The MenuBar View calls Reset View and assorted viewing options.
	The MenuBar Help calls up the on-line HTML manual, this also
	available from stand-alone program:	'ribbons-help'.
	For sample images with data:  'ribbons-image'.
	Another stand-alone  'ribbons-gallery'  shows more images.


	Almost all old features still exist and several new features added.
	There are some minor bugs, due to my knowledge of X/motif.

	** New Features **

	Mouse Translation - has changed.
	Use only the RightMouse depressed (instead of all 3 buttons at once)
	and cursor movement to translate left/right and up/down.
	LeftMouse+MiddleMouse still controls in/out translation.
	Now all translations change the center of rotation.

	Fast drawing mode to speed interactive transformations.
	Select Menubar View FastDrawing (Alt+f).
	Toggles between a minimal line drawing representation and the
	current raster settings.
		-or-
	Simplify Image - for faster interaction.
	MenuBar View has Show/Hide Object selections to replace the
	old shortcuts from the MainMenu.

	Full-Screen Antialiasing - no more annoying jaggies.
	Select Menubar Edit AntiAlias Image.
	Slide on submenu to pick N, the # of passes of redrawing the
	randomly jittered image.  Filename set with Menubar Save Image (Alt+i),
	!***! then hit the PrintScreen key to actually save. !***!
	You may hit the Pause button to cancel the save.
	Beautiful, at the expense of increased rendering times.

	3D-text -  now have a *.texts file, analogous to the *.atoms file.
	Each line in the *.texts file is a *.str filename, each of which
	has the same format as the *.sph file:  x y z r k string
	The string is displayed in color k at xyz position ( r is ignored).
	Use the Text Panel to adjust properties of groups of strings.

	Picking - since version 2.4.
	All three buttons pressed while over a ribbon residue will
	display information about it to the screen

	Re-Read Data - instead of starting over.
	Say you look at the image and decide residue #25 is in a helix,
	rather than the coil assigned by the automated procedure.
	Edit the *.ss file, changing the 'ss' key of #25 from 'H' to 'c'.
	Select File Re-Read-Data *.ribbons to affect the change.
	(Before you had to quit the program, then start it back up.
	This will be interactive in version 3.0)

	Save Defaults - for initialization of future runs.
	MenuBar File choice to write out a file in the ribbons '.defaults'
	format.

	More Output Options - for raytracers & Inventor.
	MenuBar File PrintSpecialFiles choices now print files for
	popular public domain raytracers Rayshade (by Craig Kolb)
	and Radiance (by Greg Ward).
	Also prints out current state of primitives in *.iv VRML format.

	Atom/Bond/Poly etc colors - may be set to any value interactively
	now (or restored to original) via new coice in control panel.

	Fat Line Bonds - for improved interaction.
	Open Edit Bonds Panel,  select 'lines' from DrawStyle then
	scale the width in pixels with LineWidth.
	Dashed bonds if 'lines' and 'complexity != 0.

	Bigger Dots - for improved surface representation.
	Open Edit Ndots Panel,  scale the width in pixels with LineWidth,
	select 'AntiAlias' for round instead of square dots.

	Chicken Wire Surfaces - for improved representation.
	Open Edit Polys Panel,  select 'lines' from DrawStyle.
	New utility program 'iso-surf' makes contours from DSN6 map.
	New utility program 'access' makes a DSN6 map of the surface.

	Ribbons Thru C-alphas - not flowing gracefully by.
	Open Edit Ribbon Style Panel,  toggle Ribbons Thru CA
	and/or Including Sheets to force the ribbon to pass thru the CA,
	the latter forcing pleats in the sheets.
	This is not as pretty, but good when hanging side chains off coils.

	Depth Cueing - via the fog effect.
	Open Edit Light Panel, set Fog On and Fog Density to
	adjust the fade into the background.
	
	Light Intensities - now variable.
	Open Edit Light Panel to control two independent directional
	white light sources.

	Background Color - and ambiance.
	Open Edit Light Panel for separate widgets to edit the
	ambient light and background RGB (still can be set throught
	editing color #0 in the Color Panel).

	View Down Axes - and Orthogonal rotations.
	MenuBar View has Rotate +/- 90 selects.

	No Stretched Spheres - bug fixed for stereo.
	MenuBar View Stereo SidebySide no longer distorts spheres.

	New utility program 'pdb-sele-pdb' selects subset of atoms using
	XPLOR's sele=(selection-statement) syntax.


	** Missing Features **

	MainMenu	- now use MenuBar.

	MainMenu Ribbons - shortcut to coloring choices.
	Open Edit Ribbon Style Panel to pick choice.

	Centering - old geometry panel.
	Now translations move the center of rotation.

	Animation Panel - except peptide plane.
	MenuBar View to fly the USS Peptide Plane.
	Rudimentary animation panel is no longer supported
	(If anyone misses this feature badly, please tell me).

	Motion Panel - is gone.
	Scripting of rotations/scaling & saving frame is gone.
	(If anyone misses this feature badly, please tell me).


	** Current Bugs **

	These are mostly problems with X/Motif - any help would
	be appreciated.

	Colors/Fonts - X, why?
	These MAY be screwed up on your machine, due to my lack of
	understanding of X-resources.

	Hardware Stereo - X, why?
	X extensions in the manual were followed, but we have no machine.
	Well, we got a machine - doesn't work - trying the SGI helpline.

	Control Panels Plop - X, why?
	User has no control over the initial placement of the panels,
	you may move them after they are plopped down in the middle.