![]() |
![]() |
![]() |
![]() |
![]() |
The Print Dialogs in the SDL Suite and in the Organizer
To print, you select any of the submenus in the Print menu from the File menu. This will open a Print dialog. Since the print functions in the tools are not identical, the print dialogs look somewhat different depending on where they are invoked from. As you can see in Figure 77 and Figure 78, the differences are that the Organizer print dialog includes the Contents area, whereas the SDL Suite tool print dialogs include a Setup button.
The main differences between printing from the Organizer and an SDL Suite tool are:
- In an SDL Suite tool, it is only possible to print the information or document that is opened in the tool. In the Organizer, you can select to print all or any of the documents that are managed by the Organizer.
- It is possible to print only selected symbols (when applicable) from an SDL Suite Editor, which is not possible from the Organizer.
- When you print from a viewer, the printout will be the contents of the active window. If you print from the Organizer, it is possible to include or exclude a window from the printout, independently of which window is currently active.
- In the Organizer it is also possible to print a table of contents and the contents of the Organizer window.
Endpoints are not displayed in printed documents/diagrams, regardless of the value of the Show Link Endpoints option.
Both dialogs contain the following areas and buttons:
- Document Area
- Destination Area
- Print button
- Default button
- Cancel button
The Organizer print dialog also contains the Contents area with setup buttons, and a Save button. A Setup button is also included in each the SDL Suite tool print dialog. The setup buttons in the Contents area of the Organizer print dialog are equivalent to the Setup button in an SDL Suite tool print dialog. The Save button is used to save print dialog settings in print selection files, for later use in the print dialog.
All dialog areas and buttons will be described in this chapter.
Contents Area in the Organizer Dialog
The Contents area is only available in the Organizer Print dialog. In the area, it is possible to control what information to print, through a number of toggle buttons and Setup buttons. Each of the toggles identify a group of documents that may be printed:
- Table of contents
- Organizer view
- Link Manager view
- OM diagram
- HMSC diagram
- SC diagram
- SDL interaction
- SDL flowchart
- SDL overview
- MSC diagram
- Text document
- Coverage diagram
- Cross reference diagram
- Type diagram
It is not possible to include TTCN documents in a global printout from the Organizer. See The Print TTCN Dialog in the Organizer for information on how to print TTCN documents from the Organizer.
Some toggle buttons may be turned on by default. This is determined by which document types that are present in the default scope of print.
Table of Contents
This option determines whether a table of contents should be generated or not. The table of contents consists of a textual list with information about what source diagrams and generated diagrams that are included in the printout, with references to physical page numbers. There is also a possibility to only include Organizer chapters in the table of contents, i.e. all other printed entities are suppressed in the table of contents.
The table of contents is either printed on the first pages that constitute the resulting printout, or after an initial text document acting as a title page.
Organizer View
This option determines whether a printout of the Organizer main window should be included or not in the generated output. Only the visible parts (i.e. expanded nodes) are included.
The resulting printout will match the Organizer's View Options, i.e. file names, directories, etc. will be shown if they are in the Organizer Main window.
Link Manager View
This option determines whether a printout of the Link Manager Window should be included or not in the generated output. Only the visible parts (i.e. expanded nodes) are included.
OM/HMSC/SC/MSC/Text Diagram,
SDL Interaction,
SDL Flowchart,
SDL OverviewThese options determines whether the documents and diagrams that are visible in the Organizer should be included or not in the printout. The SDL Interaction diagrams are: system, system type, block, block type, substructure, package diagrams. The SDL Flow diagrams are: process, process type, service, service type, procedure, operator, macro diagrams.
Coverage Diagram
This option determines whether Transition Coverage and Symbol Coverage trees should be included or not in the generated output.
Cross Ref Diagram
This option determines whether Definitions and Uses should be included or not in the generated output.
The resulting output will show the graphical appearance as when displayed in the Index Viewer, with the exception that only SDL entities defined or used in SDL diagrams printed together with the index will be visible in the index.
Type Diagram
This option determines whether an SDL-92 Type list and SDL Type Inheritance and Redefinition list should be included in the generated output or not.
The resulting output will show the SDL-92 type lists for the SDL system currently in view in the Organizer. The lists will be produced by using the options defined in the List Options, Tree Options and Symbol Options of the Type Viewer.
Setup Buttons in the Contents Area
Furthermore, each group of documents that may be printed is supplied with setup buttons. When you click a setup button, a Print Setup dialog will be issued, see Print Setup Dialogs. In the dialog, it is possible to set additional options that affect the printout of the current group of documents.
Document Area
The Document area contains a number of settings that make it possible to specify the size of the paper to use, the print range and additional information to be printed on each individual page.
- Paper format
- Image format (Windows Only)
- Margins
- Header file
- Footer file
- Page markers
- First page no
- Print from/to
- Black & white
- Print collapsed texts
- Print chapter pages
- Forward references
- Backward references
When using a printing format other than One Postscript File or MSWPrint the only enabled options in the Document area are Black & white (not for Frame or Interleaf printing) and Print collapsed texts. For these formats the paper layout is determined by the special Print preferences starting with Frame*PaperFormat. However when using Word format the margins and layout are determined by the defaults given by the created Word document.
Paper format
The Paper format option menu specifies what paper format the print function will use. The paper formats are:
- A4, the European standard size (210 * 297 mm)
- A3, the European standard double size (297 * 420 mm)
- US Letter, the American standard (8.5" * 11")
- US Legal (8.5" * 14")
- User Defined, which makes it possible to customize a size with the Margins button. The size may also have been set in the Preferences Manager.
Margins
The Margins button provides access to the Paper Format Setup dialog where the print margins may be specified.
The print margins govern how much space is reserved around the area used when printing. Values are expressed in millimeters.
- There are four slide bars for the adjustment of the margins:
- The dialog also contains two slide bars used for controlling what paper format to use when the Paper format option User Defined is set:
- The OK button applies the values as currently defined and closes the dialog.
- The Cancel button closes the dialog without changing any values.
Image format (Windows Only)
For Word printing the Image format option menu specifies what image format the print function will use. The image formats are:
Header file
Footer file
This feature controls whether or not a header/footer should be printed on each page. The page header/footer is defined in a text file of its own, which you need to supply. For information about the contents and syntax of this file, see Footer and Header Files.
- The header/footer file options are turned on/off with toggle buttons.
- When you click the folder button, a Select File dialog will be issued. In this dialog you may select the header/footer file.
- It is also possible to type the name and directory of the file directly into the text field.
Header or footer files are only supported in PostScript Output (not EPS) or MSWPrint Output (Windows only).
Page markers
An SDL/OM page or an MSC diagram may require multiple physical pages when printed. If you want to print an SDL/MSC/OM document and the document is physically spread over more than one physical page, the Page markers toggle button facilitates the reassembling of the paper sheets into the original page.
- If the toggle button is on, adjacent page markers will be inserted on the edge of each physical page. An adjacent page marker looks like a small arrowhead which refers to the adjacent page. If there are lines crossing a physical page border, line identifiers (like X1, X2... or Y1, Y2...) will be attached to the line, making it easy to find the continuation of the line on the other page.
Physical page numbering follows a "first right, then down" fashion.
The physical page breaks are indicated with dashed lines in the diagram editors. A page number is inserted at the lower right corner of each page in the editor.
Page markers and all other options where page numbers are used are only supported in PostScript Output (not EPS) or MSWPrint Output (Windows only).
It is possible to print an individual page number on each printed page. This is done by using a header file. Read more about header files in Footer and Header Files.
First page no
When you order multiple print jobs, you may want to restart the page numbering on each printout with a number different from 1, which is the default value.
If you want to change the number of the first page, you should type the number in the First page no: field.
Print from/to
It is possible to exclude a number of pages form a printout. To specify the print range, you type the page numbers in the Print from and Print to fields. Make sure that the toggle button is on, your settings will have no effect otherwise.
When the toggle button is off, all physical pages that constitute the printout will be generated.
Black & white
If this option is selected, all symbols and lines will be printed with a black border on a white background. If this option is not selected, symbols and lines will be printed with the color they have on screen. As default, this option is off.
For FrameMaker or Interleaf printing this option is always on and disabled as the printing will always be in black and white.
Print collapsed texts
Text symbols, comment symbols and text extension symbols can be collapsed. When they are collapsed, it is not possible to see the complete text these symbols contain in the diagram. Instead, it is possible to print the complete text as a separate text page after the diagram. This option decides if such a text page should be printed or not. As default, this option is on.
Print chapter pages
(Organizer only.) Decides if text connected to chapter symbols in the Organizer should be printed or not. As default, this option is on.
Forward references
(Organizer only.) Decides if forward paper page references should be printed or not. Paper page references makes the printout easier to read. You can get paper page references for the following relations:
- SDL reference symbol -> SDL diagram
- (H)MSC reference symbol -> (H)MSC diagram
- SDL join/out-connector -> SDL label/in-connector
- SDL procedure call -> SDL procedure diagram
- SDL nextstate symbol -> SDL state symbol
As default, forward paper page references are printed.
There is a preference, Print*MaxPageReferences, that decides the maximum number of page references in one place. The default value is 20. A value of 0 is the same as "no limit".
Backward references
Similar to forward references, but produces paper page references that allows the reader of the printout to follow the flow backwards instead.
Destination Area
The Destination area contains print options that affect the output format and the destination of the resulting output. It is for example possible to send a printout to a printer or to look at the results in a pre-viewer.
Format
This feature controls what output format will be generated when printing. You select the output format in an option menu. The output formats supported are:
- One PostScript File
- One EPS File1
- If only one page is to be printed, this option is valid and will result in an EPS File containing one physical page. If the Print setup caused more than one physical page to be printed, only the first page will be printed. The layout of the page for EPS printing is determined by the preferences in Frame*PaperFormat.
- One EPS File Per Page
- This format implies that the output will be in the form of multiple EPS files, placed in a specified directory. Along with the EPS files, a map file containing the translation scheme is produced. See To file / Map file.
- One FrameMaker MIF File2
- This format signifies the generation of one FrameMaker MIF file. The file will contain a number of contiguous, cropped anchored frames. The layout of the page for MIF printing is determined by the preferences in Frame*PaperFormat.
- One FrameMaker MIF File Per Page
- This option produces one FrameMaker MIF file per page. A map file is also produced, showing the translation table. See To file / Map file, below.
- Import into FrameMaker (UNIX only)
- If an instance of FrameMaker is found up and running, this option generates a FrameMaker MIF temporary file that will be imported into an anchored frame, placed below the current insertion point in the active FrameMaker document. If no instance of FrameMaker is found, then an attempt is made to start one with the command maker and create a new FrameMaker document, showing the contents of the file.
- See also Importing into FrameMaker (UNIX only) for how this option functions when multiple instances of FrameMaker are running on your computer.
- One Interleaf IAF File3
- This format produces one Interleaf ASCII Format file. The layout of the page for IAF printing is determined by the preferences in Frame*PaperFormat.
- One Interleaf IAF File Per Page
- This option produces one Interleaf ASCII Format file per page. A map file is also produced, showing the translation table. See To file / Map file.
- MSW Print
- One Word DOC File
- (Windows only)
- This option produces one Word Document format file for use with Microsoft Word 2003 or Word 2000. The generated image sizes can be set by the Image format option. When choosing Normal.dot the layout of the page for Word printing is determined by the margins and paper format as defined when a new document in Word is created. When choosing User Defined the sizes can be set to any desired size, however when they are inserted into the Word document if necessary they are scaled to fit inside the margins of the document.
- Word Files (DOC + EMF)
- (Windows only)
- This option produces one Word Document format file that is a hub for a set of Enhanced Metafiles. When you select this option you also have to specify the main Word Document file in the To file text field. The produced Enhanced Metafiles are auto-named and placed in the same directory as the main Word Document file. The generated image sizes can be set as for One Word DOC File.
- Web Files (HTML+PNG)
- This option produces HTML (text) and PNG (picture) files that can be viewed in a web browser. The PNG file format is similar to the GIF file format and is supported by Netscape Navigator 4.0 and Microsoft Internet Explorer 4.0 or later. When you select this option, you also have to specify the main HTML file in the To file text field. All other produced files are auto-named and placed in the same directory as the main HTML file.
To file / Map file
If this radio button is turned on, the output will be a file. The name of this radio button depends on the format specified in the Format option menu. If the format selected will generate one output file - i.e. the format name ends with Per Page - the name will be Map file. Otherwise it will be To file.
A map file contains a translation scheme of all files generated (containing information about SDL diagram / page and the corresponding printout file). The naming algorithm of the generated files will ensure a fixed mapping between a diagram and the generated files between two subsequent Print jobs. However, if the input to the Print function is changed (its size!), this is not necessarily true.
See Map File if you want detailed information on the syntax of a map file.
- When you click the folder button, a Select File dialog will be issued. In this dialog you may select the name of the file and where it is to be saved.
- It is also possible to type the name of the file directly into the text field. The directory where the file will be saved is the most currently selected.
Execute
If this radio button is on, the output file will be used as input to an OS command. An example of this is to load a printer with a PostScript file. It may also be used to send the resulting PostScript code to a PostScript previewer. For instance, if type a previewer command in the field - ghostview for example - you may preview the PostScript file.
The command lpr (or any other related) will send the printout to a printer.
The default command is specified in the Preference Manager. In the Windows version, the command lpr is available, which functions much like the corresponding UNIX print spool command.
Setup
When you click the Setup button (only available in an SDL Suite tool Print dialog), a Print Setup dialog will be issued. In the dialog, it is possible to set additional options. The additional options differ between the the SDL Suite tools. See Print Setup Dialogs for more information.
1EPS stands for Encapsulated PostScript
2 3
http://www.ibm.com/rational |
![]() |
![]() |
![]() |
![]() |