source: trunk/HELP_SOURCE/source/tree2prt.hlp

Last change on this file was 18769, checked in by westram, 3 years ago
  • move all helpfiles to new source location
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 6.5 KB
Line 
1#Please insert up references in the next lines (line starts with keyword UP)
2UP      arb.hlp
3UP      glossary.hlp
4
5#Please insert subtopic references  (line starts with keyword SUB)
6
7# Hypertext links in helptext can be added like this: LINK{ref.hlp|http://add|bla@domain}
8
9#************* Title of helpfile !! and start of real helpfile strunk********
10TITLE           Print a Graphic to a Printer
11
12OCCURRENCE      ARB_NT/Tree/Print Tree
13                ARB_SECEDIT/File/Print structure
14
15DESCRIPTION     Multi Page Printer
16
17SECTION Select what to print
18
19                Clip at Screen: Show only those graphics that are
20                                drawn at the ARB_NT main window
21
22                Show Handles:   Show/Hide root and mark symbols
23
24                Export colors:  Whether to export colors or not.
25
26SECTION Page Layout
27
28                The upper part of this section shows the current graphic size,
29                the magnification in effect, the resulting outputsize (after
30                resize) and the used papersize.
31
32                graphic size:   size of graphic in inches. When you change the display
33                                while this window stays open (e.g. zoom in/out ...)
34                                press <Get Graphic Size> to update the graphic size.
35
36                Magnify%: magnification of graphic. This can either be set manually or
37                          will be set automatically by changing the number of pages used.
38
39                Papersize: useable paper size in inches (i.e. size of area printer can fill)
40
41                           Normally you will select one of the predefined paper formats.
42                           Doing this will pass it to fig2dev (which is used to preprocess
43                           printing).
44
45                           It is also possible to use non-standard-formats by setting the paper
46                           size directly, but since they aren't known by fig2dev figuring out
47                           magnification, overlap etc. might be tricky or impossible.
48
49                Orientation: Landscape or Portrait mode
50
51                Bordersize: Keep an empty border around the graphic (specified as percentage of
52                            graphic size)
53
54                Useable size: How much of a page your printer can fill. This is used when
55                              calculating the 'Papersize' from paper format.
56
57                              This value cannot be influenced by ARB, it's only here to
58                              allow you to inform ARB about the capabilities/restrictions
59                              of your printer setup.
60
61SECTION Multiple pages
62
63                Left side shows the fractional number of pages needed to print with
64                current magnification and orientation.
65
66                Fit on XXX pages:
67
68                    - shows the number of pages which will be printed
69                    - change it and click on 'Fit on' to zoom the graphic such that
70                      it will fit on the specified number of pages (that will
71                      modify 'Orientation' and 'Magnify%')
72                    - mark lock to fix the number of pages used. You will not be
73                      able to change magnification when locked.
74                    - the small buttons below allow to quickly fit onto the
75                      displayed number of pages.
76
77                Overlap: If checked, the printed pages will "slightly" overlap.
78                         Does not apply when printing to a single page - obviously.
79
80                         Note: ARB cannot influence the size of the overlap-region,
81                               but it needs to know it in order to be able to properly
82                               calculate the needed magnification.
83
84                               If the default of 10% does not match your system, you'll
85                               have to test it (use preview for that). Once you got a
86                               working value, save properties to store it for future
87                               sessions.
88
89
90SECTION Destination
91
92                - Printer: Use print command to print
93                - File: Use File Name as destination file name
94                - Preview: Print to file and show using gv (ghostview)
95
96SECTION HOWTO configure correct overlap
97
98        The following actions need to be performed in order!
99
100                First you need to determine the 'Useable size':
101
102                      - set bordersize to 0%
103                      - select a graphic which is very tall (i.e. does not fill the complete
104                        width of a page when magnified to fit on one page)
105                      - Fit on 1 page
106                      - select Destination 'Preview'
107                      - now change 'Useable size' until height fits best
108                      - control whether this value is also correct for width and/or landscape. It
109                        is important, that you do NOT use multiple pages when checking this.
110
111                Determine whether your fig2dev has the overlap bug:
112
113                      - disable overlap bug
114                      - print on 2 vertically arranged pages in portrait mode with ~1.99 rows
115                        of pages
116                      - if there is empty space at top of printout and some info is clipped
117                        at bottom, your fig2dev has the bug
118
119                Determine the overlap value used by fig2dev:
120
121                      - switch to landscape mode
122                      - print ~1.99 rows of pages
123                      - adjust overlap percentage until it fits best on two pages
124                      - check value with ~2.99 rows and ~3.99 rows
125                      - check value with portrait mode
126
127NOTES           The default printer used by ARB can be defined by setting the
128                environment variable PRINTER to your printer name.
129
130                To change the proportion between font- and graphic-size you have to change the
131                physical zoom factor (of the radial tree/secondary structure). For dendrogram
132                and IRS tree the physical zoom will also affect the relation between
133                horizontal branch length and vertical branch distance.
134
135EXAMPLES        Print a long list tree:
136
137                        1. Select tree style in ARB_NT main window
138                        2. Select File/Print tree
139                        3. Select Destination 'Printer'
140                        4. Press PRINT button
141
142WARNINGS        Printing cannot be stopped
143
144BUGS            None
Note: See TracBrowser for help on using the repository browser.