|COGENT Version 2.2 Help|
COGENT provides facilities for printing complete research programme, complete models, or any of a model's component boxes. The facility can be used to generate plain ASCII text files, nicely formatted PostScript files, or moderately well formatted HTML files.
To print a complete research programme select the research programme from the Research Programme Manager window and and on the Print... button on the window's File menu.
To print a complete model open the model (e.g., by double-clicking on its icon on the Diagrammatic History panel of the Research Programme Manager window) and select Print... from the File menu on the model's top-level window (i.e., its principal box/arrow editor window).
To print details of a specific box open the box and select Print... from the File menu on the main window associated with the box.
The details of individual boxes can also be printed by selecting Print... from the menu that appears when you right click over the desired box on a box/arrow editor. A variety of other parts of a model may also be printed (e.g., the output trace and the current contents of boxes). Print... buttons occur in a variety of contexts within COGENT, and all function through a couple of basic dialogue boxes as described below.
Selecting Print... opens a new dialogue box which presents a number of options that control the format, layout and precise content of the printout, as shown in Figure 1:
The print dialogue consists of two regions. In the top are buttons and other widgets for selecting the print options. These are initialised with values taken from the user's printing preferences. At the bottom are two buttons which allow the user to either cancel the operation or go ahead with the printing.
Note: Where appropriate, the Print Dialogue window will be truncated. For example, when printing just the contents of a box, the options for Print new box on new page etc. will not be displayed.
The items in the print dialogue, their values, and the resulting behaviour, are as follows:
Print to file is a Boolean option that, when checked, directs output to a file (rather than a printer). Click on the box following this option to switch its value between checked (indicated by a tick in the box) and unchecked. Make sure the box is not ticked if you want your output to go straight to your system's printer.
Print directory and Print file are only relevant when output is being saved in a file. The print file is the name of the file in which the output will be saved. The file will be stored in the print directory (whose value is inherited from the File Locations preferences panel). Note that you must be able to write files in the print directory for printing to work. Even if you are not printing to a file, this directory will be used for temporary working space and so must be writable. (To set or check this option, switch the category of the preferences window to File Locations.)
Printer command is only relevant when output is not being printed to a file. It is then used to control how the printer output is handled. Its value should be the name of the UNIX command to be used for printing. Typically this is lpr (on older BSD systems) or lp -c (on System V UNIX).
Printouts are actually written to a temporary file in the print directory. If Print to file is set, this file is then renamed to the value of Print file. Otherwise a system command is constructed by prefixing the temporary file name with the value of Printer command. Thus if Printer command is set to lp -c, the system command lp -c tmp.ps will be executed, causing the file to be printed via the lp command. If, on the other hand, Printer command is set to ggv, the system command ggv tmp.ps will be executed. If the output is in PostScript format this will cause the file to be previewed. The temporary file is deleted once the print operation is complete.
Output format controls whether HTML, PostScript or plain text output is generated. Some users may find PostScript files difficult to handle on their systems; in such cases it is possible to get a plain text printout. Other users may prefer HTML output, which can be viewed (and printed) by a Web Browser. Plain text may be useful for including in other documents. HTML may be useful for including in Web pages. In such the option is probably best used in conjunction with the Print to file? option checked.
Printer font size controls the point size of the font used in the PostScript printout. The default value (10) is relatively small, but helps conserve paper.
Print new box on new page controls page breaks (in PostScript output) between box details. When checked, COGENT starts a new output page for each box. By default this is unchecked (again to conserve paper).
Output page style controls whether the printout is generated in Portrait, Landscape or Two-up styles. When Two-up is selected, COGENT produces landscape style output (rather than portrait style output), with two pages printed side by side on each sheet of paper. This mode is again provided for those worried about unnecessary paper use.
Show initial contents governs inclusion of initial contents in the printout. If checked, the initial contents windows of all boxes are included in the printout.
Show current contents governs inclusion of current contents in the printout. If checked, the current contents windows of all boxes are included in the printout.
Show conditions governs how much detail is shown in the output of processes. If checked, all conditions are given in detail. If FALSE, just the rules are included.
Show messages governs inclusion of message logs in the printout. If checked, the message logs windows of all boxes are included in the printout.
Recurse through sub-objects governs recursion through sub-boxes. When checked, and a compound box is being printed, all sub-boxes of the compound will be included in the printout. In the case of printing an entire research programme, if this option is checked all models in the research programme will be included in the printout. If it is not set, the printout will include only the contents of the Diagrammatic History and Programme Description panels.
The default options in the printing dialogue can be set using the print preferences panel, which has a similar layout to the main print dialogue shown above.
|COGENT Version 2.2 Help|