The emacs ringing system can output methods and groups of methods for printing via PostScript, in a variety of styles. Unlike most other ringing software's PostScript output, emacs-ringing outputs a ringing program in PostScript, and a method description, and a collection of drawing routines for the core of the PostScript ringing system to call.
Selecting the style of the output is done by providing different drawing routines.
There are four collections of drawing routines: method plotting style, title style (also affects the placement of the method on the page), grid style, and, for method groups, layout styles.
Layout and sizing is done according to the current drawing region
(actually, the bounding box of the clipping path, for those who know
PostScript) in practice, this will normally start off as the page
boundaries. Because the PostScript is self-sizing, emacs-ringing
doesn't output a
%%BoundingBox comment to say how big the
whole drawing is, and so the output isn't conformant EPSF and can't be
imported into publishing programs. Later versions will let you force a
particular size onto the output.
The printing commands prompt you to choose from the available styles. This document will list the styles available at the time, although there's a risk I'll write a new style and forget to include it here for a while.
The title style file draws the title (and place notation, although it could omit that) and sets up the rest of the page for plotting the method, by setting up the drawing region to the part of the page that doesn't have the title on it.
Some of these have emacs file variables that cause the printing setup routines to prompt for more information.
The plotting style prints numbers and letters, draws lines and crossings, and so on. Plotting styles will typically fit themselves to the drawing region available.
defaultstyle, but puts the bell just before you in solid black, the one after you in mid-gray, and all the others apart from you and the treble in pale gray.
full-grid, but as a stereogram.
a PostScript file which prints a chosen method in all the styles
available. You have to send this file to the printer or previewer
The group layout style draws the group title, and places the methods on the page by setting the drawing region for each one in turn and then using the title style and plotting style for the methods in turn.
An optional underlying grid may be drawn for some method plotting styles.
As well as the printing commands, there are similar previewing commands. Instead of sending the PostScript to a printer, they run a previewer to display it immediately.
If you can't work out why a combination of styles is having a
particular effect, try
before the command that creates the PostScript. This will produce a
graduated border around each layout element, so you can see how the
layout works. This takes a long time to print!