Home » Archimedes archive » Archimedes World » archimedes_world_volume_14_issue_12_scp.adf » !NUp_NUp » !NUp/!Help

!NUp/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Archimedes World » archimedes_world_volume_14_issue_12_scp.adf » !NUp_NUp
Filename: !NUp/!Help
Read OK:
File size: 2C8B bytes
Load address: 0000
Exec address: 0000
File contents
!Help file for !NUp


License
=======

The copyright to this application, NUp, is retained by the author, Simon
Melhuish. NUp may be copied freely for non-commercial use. Copies may be
passed to a third party, for non-commercial use, so long as no charge is
made, all files, including this one, are included, and the software and
documentation are not altered in any way. You may not upload NUp to any kind
of bulletin board system, or similar, without the express permission of the
author, although you are free to distribute copies on a one-to-one basis by
electronic mail systems. �Public domain� libraries are not permitted to
distribute NUp without the express permission of the author. Anyone wishing
to include NUp in a CD compilation, or similar, is required to contact me for
permission. Newer versions of the software and/or the documentation may be
made available at a future date.

I reserve the right to change the above conditions, or to withdraw or revoke
this licence in relation to any or all users at any time and for any reason.

NUp comes with absolutely no warranty. I accept no responsibilty for any
problems you might think are related to the use of this software. You use it
entirely at your own risk.


Description
===========

NUp stands for N-Up printing. It is a utility application that allows several
drawfiles to be printed on a single page. Other file types may be loaded
using a system of helper applications.


Minimum requirements
======= ============

NUp should run on a 1 MB machine, with RISC OS 3.1 or later. NUp itself takes
only 48 kB of memory. The toolbox modules are quite big though. You will need
enough free memory in addition to allow for the size of your drawfiles, plus
some for helper applications for other file types.


Running NUp
======= ===

Run NUp by double clicking its icon in a filer window. The NUp icon should
now appear on the iconbar. If it doesn't you'll probably see an error box
telling you to run the !Printers application first. NUp needs to ask Printers
about page sizes, etc, so you must have it running.

NUp will refuse to run if another copy is already running.

The text under the iconbar icon shows two numbers. The first is the number of
panels on the page currently filled by drawfiles. At the start this will of
course read '0'. The second number is the number of panels per page. The
value depends upon how you have NUp set up.


Interactive help
=========== ====

NUp fully supports interactive help. Run a help application (e.g the RISC OS
3 !Help application). You will now be provided with help on the NUp iconbar
icon, all the NUp windows and the NUp menu.


Loading drawfiles
======= =========

To load a drawfile into NUp drag its icon onto the NUp icon on the iconbar.
The NUp main window will now open, with your drawfile loaded into one of the
panels on the page. Should you close the main window you can re-open it at
any time by select-clicking the NUp iconbar icon. You may drag more than one
file to NUp (the iconbar icon or the main window if it is open). For each
drawfile loaded the loaded panel count will increment by one. Note that you
can have more panels loaded than fit one one page. For files not currently
displayed only the filename is kept by NUp, to reduce memory requirements. Be
sure not to delete files dragged onto NUp but not yet displayed.


Loading other file types
======= ===== ==== =====

NUp loads drawfiles only. However, it can automatically convert certain
file types to draw format (the converted files will be held in the !Scrap
application - the original files are preserved). This works by using "helper"
applications. Currently these can handle text, sprites and most of the
formats acceptable to ChangeFSI. For the latter, you must ensure that
ChangeFSI has been booted (or "seen" by the filer). Some of these conversions
require several steps, and so are not especially fast.


Loading directories
======= ===========

When a directory is dropped onto NUp it will iterate through its contents.
Subdirectories will be scanned recursively. If there are files not handled by
NUp or its helpers they will be ignored without any error message. Image
filing systems (e.g SparkFS archives, x-files, etc) are treated as if they
were normal directories.


The NUp menu
=== === ====

Clicking the menu button over the NUp iconbar icon or the main window pops up
the NUp menu. This has entries for program info, options, scaling, flushing,
printing and quiting NUp.


Changing the setup
======== === =====

To change NUp's setup select the "Options..." entry on the NUp menu. The
"Layout Options" dialogue box thus revealed allows you to set the page
orientation (landscape or portrait), the page size, the number of panels
across and down, and automatic page printing and flushing.

Normally you would leave the page size set to "Printer size". However, if you
have special requirements, e.g to fit the NUp panels to a sheet of sticky
labels, you might want to define a "Custom size". Click the radio button, and
the custom dimension entries will become writeable. The values are all in mm.
The width and height are the page size _including_ margins. The margins are
all _inwards_ from the edge of the page. However, negative margin values are
allowed.

When you are happy with the setup click "Set". If you want to revert to the
old setup click "Cancel". If you want to preserve the setup for the next time
NUp is run click "Save".


Printing
========

When you want to print the page displayed in the main window, even if it is
not full, select "Print..." from the NUp menu. This will pop up a dialogue
box showing the currently selected printer and the number of copies the
print. You may change the latter by entering a number or clicking the up or
down bump icons.

When you are satisfied click "Print". Click "Cancel" to cancel the print
operation.

You you want to set the number of copies only, for a future (automatic) print
operation, set the number and click "Print" with _no_ files loaded.


Flushing Panels
======== ======

There are two menu entries for flushing (clearing) panels. "Flush all" clears
all currently loaded drawfiles from NUp. "Flush page" clears only the panels
displayed in the main window. If there were more than a pageful of drawfiles
loaded the next pageful will now be displayed in the main window.


"Auto print" and "Auto flush"
============ === ============

These two options in the setup dialogue govern the automatic printing and
flushing of the main window. With "Auto print" selected the page will be
printed automatically as soon as it is filled. With "Auto flush" selected the
page will be flushed automatically after it is printed. If you have a large
number of files to print you can select both these options, so that when you
drag them to NUp pages will be filled and printed automatically. There might
be an unfilled page left at the end, in which case you will have to select
"Print..." manually.


Scaling
=======

The "Scale" menu entry leads to a "Scale view" dialogue box. This has buttons
to set the scaling to any of various preset values, or you can enter your
desired value directly. There is a "Scale to fit" button, which will select
the best scaling to fit the window to the current screen mode. Click on
"Scale" when you are happy with the setting, or "Cancel" to use the old
value.

Note that the size of the printed version is not affected by this scale
factor.


Advanced setup
======== =====

If you are familiar with the operation of system aliases you might like to
use your boot sequence, etc, to redefine the way that NUp calls its helper
applications. If you look at !NUp.!Run you will see lines defining aliases of
the form Alias$NUpHelper_xxx, where xxx is the filetype. Redefining any of
these after NUp has loaded will affect the conversion of any files of that
type subsequently loaded.

For instance, you might enter the line:
  Set Alias$NUpHelper_fff <NUp$Dir>.helpers.Txt2NUp %%0 Trinity.Medium 20
This would change the font used for text files.

If you like, you can change the aliases completely, to point to your own
helper applications.


Helper applications
====== ============

The supplied helper applications can be found in !NUp.helpers
These support the conversion of text to draw, sprite to draw, and other
bitmap types to draw, via sprites.

The operation is fairly simple. When a non-draw file is dragged onto NUp, it
checks to see if an alias is defined. If it is, it executes the alias. It is
then the responsibility of the helper application, run by the alias, to load
the file, convert it to draw format and save it to the NUp application. NUp
sees this just as another draw file and loads it through the normal
mechanism. However, NUp has to keep track of which file has a helper running.
It will queue demands for helpers until the previous one has completed. This
is because some filetypes (i.e sprite and text) can result in more than one
output file (one per sprite image or one per page). To tell NUp when it has
finished with a file the helper application must send a NUpHelperDyingMessage
(0x4f441 - registered) message to NUp. The data part of this message is the
name of the input file. In fact this is optional, but if not present the
first byte of the data part must be 0. A trivial application in the helpers
directory (!NUp.helpers.nupobit) performs this task.


Controlling NUp remotely
=========== === ========

The task for which I originally wrote NUp was to handle draw files produced
automatically by another application. To fully automate everything it became
apparent that I should add a facility for this application (or any other) to
take control of NUp's setup, etc. This is done using the wimp message
NUpControlMessage (0x4f440 - registered). The format of the data block is
non-trivial, and possibly subject to change; so I won't describe it here.
However, I have provided an application in the helpers directory called
"nupcont". Running this will send control messages to NUp (make sure NUp is
running first).

The switches to nupcont to set the type of control message are:

  f    flush page

  F    flush all

  p    print
           c N  after 'p' sets number of copies to N
         e.g nupcont -pc 4
           prints 4 copies

  o    set options
         parameters (compulsary) are:
           x y landscape auto_print auto_flush
         e.g nupcont -o 2 2 1 0 1
           2 by 2, landscape, auto print off, auto flush on

  c    custom page size
         parameters (compulsary) are (unit is 0.1 mm):
           lmarg bmarg rmrg tmarg width height

  d    use default page size


Problems
========

At present I am not aware of any bugs. Please see below for contact details
if you find any.

Be sure to have !Printers running before trying to run NUp.

If any of Acorn's toolbox modules (toolbox, window, drwafile, etc) were not
supplied with this distribution you will find them on Acorn's FTP site.


Contacting the author
========== === ======

I am currently contactable for suggestions, bug reports, flattery, etc, at:

sjm@jb.man.ac.uk

or

sjm@melhuish.demon.co.uk

Or by post as:

Dr. Simon J. Melhuish,
N.R.A.L.,
Jodrell Bank,
Macclesfield,
Cheshire.
SK11 9DL


You might like to visit my home page:
http://www.jb.man.ac.uk/~sjm/
where you will find information about me, and Jodrell Bank's work on the
Cosmic Microwave Background.
00000000  21 48 65 6c 70 20 66 69  6c 65 20 66 6f 72 20 21  |!Help file for !|
00000010  4e 55 70 0a 0a 0a 4c 69  63 65 6e 73 65 0a 3d 3d  |NUp...License.==|
00000020  3d 3d 3d 3d 3d 0a 0a 54  68 65 20 63 6f 70 79 72  |=====..The copyr|
00000030  69 67 68 74 20 74 6f 20  74 68 69 73 20 61 70 70  |ight to this app|
00000040  6c 69 63 61 74 69 6f 6e  2c 20 4e 55 70 2c 20 69  |lication, NUp, i|
00000050  73 20 72 65 74 61 69 6e  65 64 20 62 79 20 74 68  |s retained by th|
00000060  65 20 61 75 74 68 6f 72  2c 20 53 69 6d 6f 6e 0a  |e author, Simon.|
00000070  4d 65 6c 68 75 69 73 68  2e 20 4e 55 70 20 6d 61  |Melhuish. NUp ma|
00000080  79 20 62 65 20 63 6f 70  69 65 64 20 66 72 65 65  |y be copied free|
00000090  6c 79 20 66 6f 72 20 6e  6f 6e 2d 63 6f 6d 6d 65  |ly for non-comme|
000000a0  72 63 69 61 6c 20 75 73  65 2e 20 43 6f 70 69 65  |rcial use. Copie|
000000b0  73 20 6d 61 79 20 62 65  0a 70 61 73 73 65 64 20  |s may be.passed |
000000c0  74 6f 20 61 20 74 68 69  72 64 20 70 61 72 74 79  |to a third party|
000000d0  2c 20 66 6f 72 20 6e 6f  6e 2d 63 6f 6d 6d 65 72  |, for non-commer|
000000e0  63 69 61 6c 20 75 73 65  2c 20 73 6f 20 6c 6f 6e  |cial use, so lon|
000000f0  67 20 61 73 20 6e 6f 20  63 68 61 72 67 65 20 69  |g as no charge i|
00000100  73 0a 6d 61 64 65 2c 20  61 6c 6c 20 66 69 6c 65  |s.made, all file|
00000110  73 2c 20 69 6e 63 6c 75  64 69 6e 67 20 74 68 69  |s, including thi|
00000120  73 20 6f 6e 65 2c 20 61  72 65 20 69 6e 63 6c 75  |s one, are inclu|
00000130  64 65 64 2c 20 61 6e 64  20 74 68 65 20 73 6f 66  |ded, and the sof|
00000140  74 77 61 72 65 20 61 6e  64 0a 64 6f 63 75 6d 65  |tware and.docume|
00000150  6e 74 61 74 69 6f 6e 20  61 72 65 20 6e 6f 74 20  |ntation are not |
00000160  61 6c 74 65 72 65 64 20  69 6e 20 61 6e 79 20 77  |altered in any w|
00000170  61 79 2e 20 59 6f 75 20  6d 61 79 20 6e 6f 74 20  |ay. You may not |
00000180  75 70 6c 6f 61 64 20 4e  55 70 20 74 6f 20 61 6e  |upload NUp to an|
00000190  79 20 6b 69 6e 64 0a 6f  66 20 62 75 6c 6c 65 74  |y kind.of bullet|
000001a0  69 6e 20 62 6f 61 72 64  20 73 79 73 74 65 6d 2c  |in board system,|
000001b0  20 6f 72 20 73 69 6d 69  6c 61 72 2c 20 77 69 74  | or similar, wit|
000001c0  68 6f 75 74 20 74 68 65  20 65 78 70 72 65 73 73  |hout the express|
000001d0  20 70 65 72 6d 69 73 73  69 6f 6e 20 6f 66 20 74  | permission of t|
000001e0  68 65 0a 61 75 74 68 6f  72 2c 20 61 6c 74 68 6f  |he.author, altho|
000001f0  75 67 68 20 79 6f 75 20  61 72 65 20 66 72 65 65  |ugh you are free|
00000200  20 74 6f 20 64 69 73 74  72 69 62 75 74 65 20 63  | to distribute c|
00000210  6f 70 69 65 73 20 6f 6e  20 61 20 6f 6e 65 2d 74  |opies on a one-t|
00000220  6f 2d 6f 6e 65 20 62 61  73 69 73 20 62 79 0a 65  |o-one basis by.e|
00000230  6c 65 63 74 72 6f 6e 69  63 20 6d 61 69 6c 20 73  |lectronic mail s|
00000240  79 73 74 65 6d 73 2e 20  94 50 75 62 6c 69 63 20  |ystems. .Public |
00000250  64 6f 6d 61 69 6e 95 20  6c 69 62 72 61 72 69 65  |domain. librarie|
00000260  73 20 61 72 65 20 6e 6f  74 20 70 65 72 6d 69 74  |s are not permit|
00000270  74 65 64 20 74 6f 0a 64  69 73 74 72 69 62 75 74  |ted to.distribut|
00000280  65 20 4e 55 70 20 77 69  74 68 6f 75 74 20 74 68  |e NUp without th|
00000290  65 20 65 78 70 72 65 73  73 20 70 65 72 6d 69 73  |e express permis|
000002a0  73 69 6f 6e 20 6f 66 20  74 68 65 20 61 75 74 68  |sion of the auth|
000002b0  6f 72 2e 20 41 6e 79 6f  6e 65 20 77 69 73 68 69  |or. Anyone wishi|
000002c0  6e 67 0a 74 6f 20 69 6e  63 6c 75 64 65 20 4e 55  |ng.to include NU|
000002d0  70 20 69 6e 20 61 20 43  44 20 63 6f 6d 70 69 6c  |p in a CD compil|
000002e0  61 74 69 6f 6e 2c 20 6f  72 20 73 69 6d 69 6c 61  |ation, or simila|
000002f0  72 2c 20 69 73 20 72 65  71 75 69 72 65 64 20 74  |r, is required t|
00000300  6f 20 63 6f 6e 74 61 63  74 20 6d 65 20 66 6f 72  |o contact me for|
00000310  0a 70 65 72 6d 69 73 73  69 6f 6e 2e 20 4e 65 77  |.permission. New|
00000320  65 72 20 76 65 72 73 69  6f 6e 73 20 6f 66 20 74  |er versions of t|
00000330  68 65 20 73 6f 66 74 77  61 72 65 20 61 6e 64 2f  |he software and/|
00000340  6f 72 20 74 68 65 20 64  6f 63 75 6d 65 6e 74 61  |or the documenta|
00000350  74 69 6f 6e 20 6d 61 79  20 62 65 0a 6d 61 64 65  |tion may be.made|
00000360  20 61 76 61 69 6c 61 62  6c 65 20 61 74 20 61 20  | available at a |
00000370  66 75 74 75 72 65 20 64  61 74 65 2e 0a 0a 49 20  |future date...I |
00000380  72 65 73 65 72 76 65 20  74 68 65 20 72 69 67 68  |reserve the righ|
00000390  74 20 74 6f 20 63 68 61  6e 67 65 20 74 68 65 20  |t to change the |
000003a0  61 62 6f 76 65 20 63 6f  6e 64 69 74 69 6f 6e 73  |above conditions|
000003b0  2c 20 6f 72 20 74 6f 20  77 69 74 68 64 72 61 77  |, or to withdraw|
000003c0  20 6f 72 20 72 65 76 6f  6b 65 0a 74 68 69 73 20  | or revoke.this |
000003d0  6c 69 63 65 6e 63 65 20  69 6e 20 72 65 6c 61 74  |licence in relat|
000003e0  69 6f 6e 20 74 6f 20 61  6e 79 20 6f 72 20 61 6c  |ion to any or al|
000003f0  6c 20 75 73 65 72 73 20  61 74 20 61 6e 79 20 74  |l users at any t|
00000400  69 6d 65 20 61 6e 64 20  66 6f 72 20 61 6e 79 20  |ime and for any |
00000410  72 65 61 73 6f 6e 2e 0a  0a 4e 55 70 20 63 6f 6d  |reason...NUp com|
00000420  65 73 20 77 69 74 68 20  61 62 73 6f 6c 75 74 65  |es with absolute|
00000430  6c 79 20 6e 6f 20 77 61  72 72 61 6e 74 79 2e 20  |ly no warranty. |
00000440  49 20 61 63 63 65 70 74  20 6e 6f 20 72 65 73 70  |I accept no resp|
00000450  6f 6e 73 69 62 69 6c 74  79 20 66 6f 72 20 61 6e  |onsibilty for an|
00000460  79 0a 70 72 6f 62 6c 65  6d 73 20 79 6f 75 20 6d  |y.problems you m|
00000470  69 67 68 74 20 74 68 69  6e 6b 20 61 72 65 20 72  |ight think are r|
00000480  65 6c 61 74 65 64 20 74  6f 20 74 68 65 20 75 73  |elated to the us|
00000490  65 20 6f 66 20 74 68 69  73 20 73 6f 66 74 77 61  |e of this softwa|
000004a0  72 65 2e 20 59 6f 75 20  75 73 65 20 69 74 0a 65  |re. You use it.e|
000004b0  6e 74 69 72 65 6c 79 20  61 74 20 79 6f 75 72 20  |ntirely at your |
000004c0  6f 77 6e 20 72 69 73 6b  2e 0a 0a 0a 44 65 73 63  |own risk....Desc|
000004d0  72 69 70 74 69 6f 6e 0a  3d 3d 3d 3d 3d 3d 3d 3d  |ription.========|
000004e0  3d 3d 3d 0a 0a 4e 55 70  20 73 74 61 6e 64 73 20  |===..NUp stands |
000004f0  66 6f 72 20 4e 2d 55 70  20 70 72 69 6e 74 69 6e  |for N-Up printin|
00000500  67 2e 20 49 74 20 69 73  20 61 20 75 74 69 6c 69  |g. It is a utili|
00000510  74 79 20 61 70 70 6c 69  63 61 74 69 6f 6e 20 74  |ty application t|
00000520  68 61 74 20 61 6c 6c 6f  77 73 20 73 65 76 65 72  |hat allows sever|
00000530  61 6c 0a 64 72 61 77 66  69 6c 65 73 20 74 6f 20  |al.drawfiles to |
00000540  62 65 20 70 72 69 6e 74  65 64 20 6f 6e 20 61 20  |be printed on a |
00000550  73 69 6e 67 6c 65 20 70  61 67 65 2e 20 4f 74 68  |single page. Oth|
00000560  65 72 20 66 69 6c 65 20  74 79 70 65 73 20 6d 61  |er file types ma|
00000570  79 20 62 65 20 6c 6f 61  64 65 64 0a 75 73 69 6e  |y be loaded.usin|
00000580  67 20 61 20 73 79 73 74  65 6d 20 6f 66 20 68 65  |g a system of he|
00000590  6c 70 65 72 20 61 70 70  6c 69 63 61 74 69 6f 6e  |lper application|
000005a0  73 2e 0a 0a 0a 4d 69 6e  69 6d 75 6d 20 72 65 71  |s....Minimum req|
000005b0  75 69 72 65 6d 65 6e 74  73 0a 3d 3d 3d 3d 3d 3d  |uirements.======|
000005c0  3d 20 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 0a  |= ============..|
000005d0  4e 55 70 20 73 68 6f 75  6c 64 20 72 75 6e 20 6f  |NUp should run o|
000005e0  6e 20 61 20 31 20 4d 42  20 6d 61 63 68 69 6e 65  |n a 1 MB machine|
000005f0  2c 20 77 69 74 68 20 52  49 53 43 20 4f 53 20 33  |, with RISC OS 3|
00000600  2e 31 20 6f 72 20 6c 61  74 65 72 2e 20 4e 55 70  |.1 or later. NUp|
00000610  20 69 74 73 65 6c 66 20  74 61 6b 65 73 0a 6f 6e  | itself takes.on|
00000620  6c 79 20 34 38 20 6b 42  20 6f 66 20 6d 65 6d 6f  |ly 48 kB of memo|
00000630  72 79 2e 20 54 68 65 20  74 6f 6f 6c 62 6f 78 20  |ry. The toolbox |
00000640  6d 6f 64 75 6c 65 73 20  61 72 65 20 71 75 69 74  |modules are quit|
00000650  65 20 62 69 67 20 74 68  6f 75 67 68 2e 20 59 6f  |e big though. Yo|
00000660  75 20 77 69 6c 6c 20 6e  65 65 64 0a 65 6e 6f 75  |u will need.enou|
00000670  67 68 20 66 72 65 65 20  6d 65 6d 6f 72 79 20 69  |gh free memory i|
00000680  6e 20 61 64 64 69 74 69  6f 6e 20 74 6f 20 61 6c  |n addition to al|
00000690  6c 6f 77 20 66 6f 72 20  74 68 65 20 73 69 7a 65  |low for the size|
000006a0  20 6f 66 20 79 6f 75 72  20 64 72 61 77 66 69 6c  | of your drawfil|
000006b0  65 73 2c 20 70 6c 75 73  0a 73 6f 6d 65 20 66 6f  |es, plus.some fo|
000006c0  72 20 68 65 6c 70 65 72  20 61 70 70 6c 69 63 61  |r helper applica|
000006d0  74 69 6f 6e 73 20 66 6f  72 20 6f 74 68 65 72 20  |tions for other |
000006e0  66 69 6c 65 20 74 79 70  65 73 2e 0a 0a 0a 52 75  |file types....Ru|
000006f0  6e 6e 69 6e 67 20 4e 55  70 0a 3d 3d 3d 3d 3d 3d  |nning NUp.======|
00000700  3d 20 3d 3d 3d 0a 0a 52  75 6e 20 4e 55 70 20 62  |= ===..Run NUp b|
00000710  79 20 64 6f 75 62 6c 65  20 63 6c 69 63 6b 69 6e  |y double clickin|
00000720  67 20 69 74 73 20 69 63  6f 6e 20 69 6e 20 61 20  |g its icon in a |
00000730  66 69 6c 65 72 20 77 69  6e 64 6f 77 2e 20 54 68  |filer window. Th|
00000740  65 20 4e 55 70 20 69 63  6f 6e 20 73 68 6f 75 6c  |e NUp icon shoul|
00000750  64 0a 6e 6f 77 20 61 70  70 65 61 72 20 6f 6e 20  |d.now appear on |
00000760  74 68 65 20 69 63 6f 6e  62 61 72 2e 20 49 66 20  |the iconbar. If |
00000770  69 74 20 64 6f 65 73 6e  27 74 20 79 6f 75 27 6c  |it doesn't you'l|
00000780  6c 20 70 72 6f 62 61 62  6c 79 20 73 65 65 20 61  |l probably see a|
00000790  6e 20 65 72 72 6f 72 20  62 6f 78 0a 74 65 6c 6c  |n error box.tell|
000007a0  69 6e 67 20 79 6f 75 20  74 6f 20 72 75 6e 20 74  |ing you to run t|
000007b0  68 65 20 21 50 72 69 6e  74 65 72 73 20 61 70 70  |he !Printers app|
000007c0  6c 69 63 61 74 69 6f 6e  20 66 69 72 73 74 2e 20  |lication first. |
000007d0  4e 55 70 20 6e 65 65 64  73 20 74 6f 20 61 73 6b  |NUp needs to ask|
000007e0  20 50 72 69 6e 74 65 72  73 0a 61 62 6f 75 74 20  | Printers.about |
000007f0  70 61 67 65 20 73 69 7a  65 73 2c 20 65 74 63 2c  |page sizes, etc,|
00000800  20 73 6f 20 79 6f 75 20  6d 75 73 74 20 68 61 76  | so you must hav|
00000810  65 20 69 74 20 72 75 6e  6e 69 6e 67 2e 0a 0a 4e  |e it running...N|
00000820  55 70 20 77 69 6c 6c 20  72 65 66 75 73 65 20 74  |Up will refuse t|
00000830  6f 20 72 75 6e 20 69 66  20 61 6e 6f 74 68 65 72  |o run if another|
00000840  20 63 6f 70 79 20 69 73  20 61 6c 72 65 61 64 79  | copy is already|
00000850  20 72 75 6e 6e 69 6e 67  2e 0a 0a 54 68 65 20 74  | running...The t|
00000860  65 78 74 20 75 6e 64 65  72 20 74 68 65 20 69 63  |ext under the ic|
00000870  6f 6e 62 61 72 20 69 63  6f 6e 20 73 68 6f 77 73  |onbar icon shows|
00000880  20 74 77 6f 20 6e 75 6d  62 65 72 73 2e 20 54 68  | two numbers. Th|
00000890  65 20 66 69 72 73 74 20  69 73 20 74 68 65 20 6e  |e first is the n|
000008a0  75 6d 62 65 72 20 6f 66  0a 70 61 6e 65 6c 73 20  |umber of.panels |
000008b0  6f 6e 20 74 68 65 20 70  61 67 65 20 63 75 72 72  |on the page curr|
000008c0  65 6e 74 6c 79 20 66 69  6c 6c 65 64 20 62 79 20  |ently filled by |
000008d0  64 72 61 77 66 69 6c 65  73 2e 20 41 74 20 74 68  |drawfiles. At th|
000008e0  65 20 73 74 61 72 74 20  74 68 69 73 20 77 69 6c  |e start this wil|
000008f0  6c 20 6f 66 0a 63 6f 75  72 73 65 20 72 65 61 64  |l of.course read|
00000900  20 27 30 27 2e 20 54 68  65 20 73 65 63 6f 6e 64  | '0'. The second|
00000910  20 6e 75 6d 62 65 72 20  69 73 20 74 68 65 20 6e  | number is the n|
00000920  75 6d 62 65 72 20 6f 66  20 70 61 6e 65 6c 73 20  |umber of panels |
00000930  70 65 72 20 70 61 67 65  2e 20 54 68 65 0a 76 61  |per page. The.va|
00000940  6c 75 65 20 64 65 70 65  6e 64 73 20 75 70 6f 6e  |lue depends upon|
00000950  20 68 6f 77 20 79 6f 75  20 68 61 76 65 20 4e 55  | how you have NU|
00000960  70 20 73 65 74 20 75 70  2e 0a 0a 0a 49 6e 74 65  |p set up....Inte|
00000970  72 61 63 74 69 76 65 20  68 65 6c 70 0a 3d 3d 3d  |ractive help.===|
00000980  3d 3d 3d 3d 3d 3d 3d 3d  20 3d 3d 3d 3d 0a 0a 4e  |======== ====..N|
00000990  55 70 20 66 75 6c 6c 79  20 73 75 70 70 6f 72 74  |Up fully support|
000009a0  73 20 69 6e 74 65 72 61  63 74 69 76 65 20 68 65  |s interactive he|
000009b0  6c 70 2e 20 52 75 6e 20  61 20 68 65 6c 70 20 61  |lp. Run a help a|
000009c0  70 70 6c 69 63 61 74 69  6f 6e 20 28 65 2e 67 20  |pplication (e.g |
000009d0  74 68 65 20 52 49 53 43  20 4f 53 0a 33 20 21 48  |the RISC OS.3 !H|
000009e0  65 6c 70 20 61 70 70 6c  69 63 61 74 69 6f 6e 29  |elp application)|
000009f0  2e 20 59 6f 75 20 77 69  6c 6c 20 6e 6f 77 20 62  |. You will now b|
00000a00  65 20 70 72 6f 76 69 64  65 64 20 77 69 74 68 20  |e provided with |
00000a10  68 65 6c 70 20 6f 6e 20  74 68 65 20 4e 55 70 20  |help on the NUp |
00000a20  69 63 6f 6e 62 61 72 0a  69 63 6f 6e 2c 20 61 6c  |iconbar.icon, al|
00000a30  6c 20 74 68 65 20 4e 55  70 20 77 69 6e 64 6f 77  |l the NUp window|
00000a40  73 20 61 6e 64 20 74 68  65 20 4e 55 70 20 6d 65  |s and the NUp me|
00000a50  6e 75 2e 0a 0a 0a 4c 6f  61 64 69 6e 67 20 64 72  |nu....Loading dr|
00000a60  61 77 66 69 6c 65 73 0a  3d 3d 3d 3d 3d 3d 3d 20  |awfiles.======= |
00000a70  3d 3d 3d 3d 3d 3d 3d 3d  3d 0a 0a 54 6f 20 6c 6f  |=========..To lo|
00000a80  61 64 20 61 20 64 72 61  77 66 69 6c 65 20 69 6e  |ad a drawfile in|
00000a90  74 6f 20 4e 55 70 20 64  72 61 67 20 69 74 73 20  |to NUp drag its |
00000aa0  69 63 6f 6e 20 6f 6e 74  6f 20 74 68 65 20 4e 55  |icon onto the NU|
00000ab0  70 20 69 63 6f 6e 20 6f  6e 20 74 68 65 20 69 63  |p icon on the ic|
00000ac0  6f 6e 62 61 72 2e 0a 54  68 65 20 4e 55 70 20 6d  |onbar..The NUp m|
00000ad0  61 69 6e 20 77 69 6e 64  6f 77 20 77 69 6c 6c 20  |ain window will |
00000ae0  6e 6f 77 20 6f 70 65 6e  2c 20 77 69 74 68 20 79  |now open, with y|
00000af0  6f 75 72 20 64 72 61 77  66 69 6c 65 20 6c 6f 61  |our drawfile loa|
00000b00  64 65 64 20 69 6e 74 6f  20 6f 6e 65 20 6f 66 20  |ded into one of |
00000b10  74 68 65 0a 70 61 6e 65  6c 73 20 6f 6e 20 74 68  |the.panels on th|
00000b20  65 20 70 61 67 65 2e 20  53 68 6f 75 6c 64 20 79  |e page. Should y|
00000b30  6f 75 20 63 6c 6f 73 65  20 74 68 65 20 6d 61 69  |ou close the mai|
00000b40  6e 20 77 69 6e 64 6f 77  20 79 6f 75 20 63 61 6e  |n window you can|
00000b50  20 72 65 2d 6f 70 65 6e  20 69 74 20 61 74 0a 61  | re-open it at.a|
00000b60  6e 79 20 74 69 6d 65 20  62 79 20 73 65 6c 65 63  |ny time by selec|
00000b70  74 2d 63 6c 69 63 6b 69  6e 67 20 74 68 65 20 4e  |t-clicking the N|
00000b80  55 70 20 69 63 6f 6e 62  61 72 20 69 63 6f 6e 2e  |Up iconbar icon.|
00000b90  20 59 6f 75 20 6d 61 79  20 64 72 61 67 20 6d 6f  | You may drag mo|
00000ba0  72 65 20 74 68 61 6e 20  6f 6e 65 0a 66 69 6c 65  |re than one.file|
00000bb0  20 74 6f 20 4e 55 70 20  28 74 68 65 20 69 63 6f  | to NUp (the ico|
00000bc0  6e 62 61 72 20 69 63 6f  6e 20 6f 72 20 74 68 65  |nbar icon or the|
00000bd0  20 6d 61 69 6e 20 77 69  6e 64 6f 77 20 69 66 20  | main window if |
00000be0  69 74 20 69 73 20 6f 70  65 6e 29 2e 20 46 6f 72  |it is open). For|
00000bf0  20 65 61 63 68 0a 64 72  61 77 66 69 6c 65 20 6c  | each.drawfile l|
00000c00  6f 61 64 65 64 20 74 68  65 20 6c 6f 61 64 65 64  |oaded the loaded|
00000c10  20 70 61 6e 65 6c 20 63  6f 75 6e 74 20 77 69 6c  | panel count wil|
00000c20  6c 20 69 6e 63 72 65 6d  65 6e 74 20 62 79 20 6f  |l increment by o|
00000c30  6e 65 2e 20 4e 6f 74 65  20 74 68 61 74 20 79 6f  |ne. Note that yo|
00000c40  75 0a 63 61 6e 20 68 61  76 65 20 6d 6f 72 65 20  |u.can have more |
00000c50  70 61 6e 65 6c 73 20 6c  6f 61 64 65 64 20 74 68  |panels loaded th|
00000c60  61 6e 20 66 69 74 20 6f  6e 65 20 6f 6e 65 20 70  |an fit one one p|
00000c70  61 67 65 2e 20 46 6f 72  20 66 69 6c 65 73 20 6e  |age. For files n|
00000c80  6f 74 20 63 75 72 72 65  6e 74 6c 79 0a 64 69 73  |ot currently.dis|
00000c90  70 6c 61 79 65 64 20 6f  6e 6c 79 20 74 68 65 20  |played only the |
00000ca0  66 69 6c 65 6e 61 6d 65  20 69 73 20 6b 65 70 74  |filename is kept|
00000cb0  20 62 79 20 4e 55 70 2c  20 74 6f 20 72 65 64 75  | by NUp, to redu|
00000cc0  63 65 20 6d 65 6d 6f 72  79 20 72 65 71 75 69 72  |ce memory requir|
00000cd0  65 6d 65 6e 74 73 2e 20  42 65 0a 73 75 72 65 20  |ements. Be.sure |
00000ce0  6e 6f 74 20 74 6f 20 64  65 6c 65 74 65 20 66 69  |not to delete fi|
00000cf0  6c 65 73 20 64 72 61 67  67 65 64 20 6f 6e 74 6f  |les dragged onto|
00000d00  20 4e 55 70 20 62 75 74  20 6e 6f 74 20 79 65 74  | NUp but not yet|
00000d10  20 64 69 73 70 6c 61 79  65 64 2e 0a 0a 0a 4c 6f  | displayed....Lo|
00000d20  61 64 69 6e 67 20 6f 74  68 65 72 20 66 69 6c 65  |ading other file|
00000d30  20 74 79 70 65 73 0a 3d  3d 3d 3d 3d 3d 3d 20 3d  | types.======= =|
00000d40  3d 3d 3d 3d 20 3d 3d 3d  3d 20 3d 3d 3d 3d 3d 0a  |==== ==== =====.|
00000d50  0a 4e 55 70 20 6c 6f 61  64 73 20 64 72 61 77 66  |.NUp loads drawf|
00000d60  69 6c 65 73 20 6f 6e 6c  79 2e 20 48 6f 77 65 76  |iles only. Howev|
00000d70  65 72 2c 20 69 74 20 63  61 6e 20 61 75 74 6f 6d  |er, it can autom|
00000d80  61 74 69 63 61 6c 6c 79  20 63 6f 6e 76 65 72 74  |atically convert|
00000d90  20 63 65 72 74 61 69 6e  0a 66 69 6c 65 20 74 79  | certain.file ty|
00000da0  70 65 73 20 74 6f 20 64  72 61 77 20 66 6f 72 6d  |pes to draw form|
00000db0  61 74 20 28 74 68 65 20  63 6f 6e 76 65 72 74 65  |at (the converte|
00000dc0  64 20 66 69 6c 65 73 20  77 69 6c 6c 20 62 65 20  |d files will be |
00000dd0  68 65 6c 64 20 69 6e 20  74 68 65 20 21 53 63 72  |held in the !Scr|
00000de0  61 70 0a 61 70 70 6c 69  63 61 74 69 6f 6e 20 2d  |ap.application -|
00000df0  20 74 68 65 20 6f 72 69  67 69 6e 61 6c 20 66 69  | the original fi|
00000e00  6c 65 73 20 61 72 65 20  70 72 65 73 65 72 76 65  |les are preserve|
00000e10  64 29 2e 20 54 68 69 73  20 77 6f 72 6b 73 20 62  |d). This works b|
00000e20  79 20 75 73 69 6e 67 20  22 68 65 6c 70 65 72 22  |y using "helper"|
00000e30  0a 61 70 70 6c 69 63 61  74 69 6f 6e 73 2e 20 43  |.applications. C|
00000e40  75 72 72 65 6e 74 6c 79  20 74 68 65 73 65 20 63  |urrently these c|
00000e50  61 6e 20 68 61 6e 64 6c  65 20 74 65 78 74 2c 20  |an handle text, |
00000e60  73 70 72 69 74 65 73 20  61 6e 64 20 6d 6f 73 74  |sprites and most|
00000e70  20 6f 66 20 74 68 65 0a  66 6f 72 6d 61 74 73 20  | of the.formats |
00000e80  61 63 63 65 70 74 61 62  6c 65 20 74 6f 20 43 68  |acceptable to Ch|
00000e90  61 6e 67 65 46 53 49 2e  20 46 6f 72 20 74 68 65  |angeFSI. For the|
00000ea0  20 6c 61 74 74 65 72 2c  20 79 6f 75 20 6d 75 73  | latter, you mus|
00000eb0  74 20 65 6e 73 75 72 65  20 74 68 61 74 0a 43 68  |t ensure that.Ch|
00000ec0  61 6e 67 65 46 53 49 20  68 61 73 20 62 65 65 6e  |angeFSI has been|
00000ed0  20 62 6f 6f 74 65 64 20  28 6f 72 20 22 73 65 65  | booted (or "see|
00000ee0  6e 22 20 62 79 20 74 68  65 20 66 69 6c 65 72 29  |n" by the filer)|
00000ef0  2e 20 53 6f 6d 65 20 6f  66 20 74 68 65 73 65 20  |. Some of these |
00000f00  63 6f 6e 76 65 72 73 69  6f 6e 73 0a 72 65 71 75  |conversions.requ|
00000f10  69 72 65 20 73 65 76 65  72 61 6c 20 73 74 65 70  |ire several step|
00000f20  73 2c 20 61 6e 64 20 73  6f 20 61 72 65 20 6e 6f  |s, and so are no|
00000f30  74 20 65 73 70 65 63 69  61 6c 6c 79 20 66 61 73  |t especially fas|
00000f40  74 2e 0a 0a 0a 4c 6f 61  64 69 6e 67 20 64 69 72  |t....Loading dir|
00000f50  65 63 74 6f 72 69 65 73  0a 3d 3d 3d 3d 3d 3d 3d  |ectories.=======|
00000f60  20 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 0a 0a 57 68  | ===========..Wh|
00000f70  65 6e 20 61 20 64 69 72  65 63 74 6f 72 79 20 69  |en a directory i|
00000f80  73 20 64 72 6f 70 70 65  64 20 6f 6e 74 6f 20 4e  |s dropped onto N|
00000f90  55 70 20 69 74 20 77 69  6c 6c 20 69 74 65 72 61  |Up it will itera|
00000fa0  74 65 20 74 68 72 6f 75  67 68 20 69 74 73 20 63  |te through its c|
00000fb0  6f 6e 74 65 6e 74 73 2e  0a 53 75 62 64 69 72 65  |ontents..Subdire|
00000fc0  63 74 6f 72 69 65 73 20  77 69 6c 6c 20 62 65 20  |ctories will be |
00000fd0  73 63 61 6e 6e 65 64 20  72 65 63 75 72 73 69 76  |scanned recursiv|
00000fe0  65 6c 79 2e 20 49 66 20  74 68 65 72 65 20 61 72  |ely. If there ar|
00000ff0  65 20 66 69 6c 65 73 20  6e 6f 74 20 68 61 6e 64  |e files not hand|
00001000  6c 65 64 20 62 79 0a 4e  55 70 20 6f 72 20 69 74  |led by.NUp or it|
00001010  73 20 68 65 6c 70 65 72  73 20 74 68 65 79 20 77  |s helpers they w|
00001020  69 6c 6c 20 62 65 20 69  67 6e 6f 72 65 64 20 77  |ill be ignored w|
00001030  69 74 68 6f 75 74 20 61  6e 79 20 65 72 72 6f 72  |ithout any error|
00001040  20 6d 65 73 73 61 67 65  2e 20 49 6d 61 67 65 0a  | message. Image.|
00001050  66 69 6c 69 6e 67 20 73  79 73 74 65 6d 73 20 28  |filing systems (|
00001060  65 2e 67 20 53 70 61 72  6b 46 53 20 61 72 63 68  |e.g SparkFS arch|
00001070  69 76 65 73 2c 20 78 2d  66 69 6c 65 73 2c 20 65  |ives, x-files, e|
00001080  74 63 29 20 61 72 65 20  74 72 65 61 74 65 64 20  |tc) are treated |
00001090  61 73 20 69 66 20 74 68  65 79 0a 77 65 72 65 20  |as if they.were |
000010a0  6e 6f 72 6d 61 6c 20 64  69 72 65 63 74 6f 72 69  |normal directori|
000010b0  65 73 2e 0a 0a 0a 54 68  65 20 4e 55 70 20 6d 65  |es....The NUp me|
000010c0  6e 75 0a 3d 3d 3d 20 3d  3d 3d 20 3d 3d 3d 3d 0a  |nu.=== === ====.|
000010d0  0a 43 6c 69 63 6b 69 6e  67 20 74 68 65 20 6d 65  |.Clicking the me|
000010e0  6e 75 20 62 75 74 74 6f  6e 20 6f 76 65 72 20 74  |nu button over t|
000010f0  68 65 20 4e 55 70 20 69  63 6f 6e 62 61 72 20 69  |he NUp iconbar i|
00001100  63 6f 6e 20 6f 72 20 74  68 65 20 6d 61 69 6e 20  |con or the main |
00001110  77 69 6e 64 6f 77 20 70  6f 70 73 20 75 70 0a 74  |window pops up.t|
00001120  68 65 20 4e 55 70 20 6d  65 6e 75 2e 20 54 68 69  |he NUp menu. Thi|
00001130  73 20 68 61 73 20 65 6e  74 72 69 65 73 20 66 6f  |s has entries fo|
00001140  72 20 70 72 6f 67 72 61  6d 20 69 6e 66 6f 2c 20  |r program info, |
00001150  6f 70 74 69 6f 6e 73 2c  20 73 63 61 6c 69 6e 67  |options, scaling|
00001160  2c 20 66 6c 75 73 68 69  6e 67 2c 0a 70 72 69 6e  |, flushing,.prin|
00001170  74 69 6e 67 20 61 6e 64  20 71 75 69 74 69 6e 67  |ting and quiting|
00001180  20 4e 55 70 2e 0a 0a 0a  43 68 61 6e 67 69 6e 67  | NUp....Changing|
00001190  20 74 68 65 20 73 65 74  75 70 0a 3d 3d 3d 3d 3d  | the setup.=====|
000011a0  3d 3d 3d 20 3d 3d 3d 20  3d 3d 3d 3d 3d 0a 0a 54  |=== === =====..T|
000011b0  6f 20 63 68 61 6e 67 65  20 4e 55 70 27 73 20 73  |o change NUp's s|
000011c0  65 74 75 70 20 73 65 6c  65 63 74 20 74 68 65 20  |etup select the |
000011d0  22 4f 70 74 69 6f 6e 73  2e 2e 2e 22 20 65 6e 74  |"Options..." ent|
000011e0  72 79 20 6f 6e 20 74 68  65 20 4e 55 70 20 6d 65  |ry on the NUp me|
000011f0  6e 75 2e 20 54 68 65 0a  22 4c 61 79 6f 75 74 20  |nu. The."Layout |
00001200  4f 70 74 69 6f 6e 73 22  20 64 69 61 6c 6f 67 75  |Options" dialogu|
00001210  65 20 62 6f 78 20 74 68  75 73 20 72 65 76 65 61  |e box thus revea|
00001220  6c 65 64 20 61 6c 6c 6f  77 73 20 79 6f 75 20 74  |led allows you t|
00001230  6f 20 73 65 74 20 74 68  65 20 70 61 67 65 0a 6f  |o set the page.o|
00001240  72 69 65 6e 74 61 74 69  6f 6e 20 28 6c 61 6e 64  |rientation (land|
00001250  73 63 61 70 65 20 6f 72  20 70 6f 72 74 72 61 69  |scape or portrai|
00001260  74 29 2c 20 74 68 65 20  70 61 67 65 20 73 69 7a  |t), the page siz|
00001270  65 2c 20 74 68 65 20 6e  75 6d 62 65 72 20 6f 66  |e, the number of|
00001280  20 70 61 6e 65 6c 73 0a  61 63 72 6f 73 73 20 61  | panels.across a|
00001290  6e 64 20 64 6f 77 6e 2c  20 61 6e 64 20 61 75 74  |nd down, and aut|
000012a0  6f 6d 61 74 69 63 20 70  61 67 65 20 70 72 69 6e  |omatic page prin|
000012b0  74 69 6e 67 20 61 6e 64  20 66 6c 75 73 68 69 6e  |ting and flushin|
000012c0  67 2e 0a 0a 4e 6f 72 6d  61 6c 6c 79 20 79 6f 75  |g...Normally you|
000012d0  20 77 6f 75 6c 64 20 6c  65 61 76 65 20 74 68 65  | would leave the|
000012e0  20 70 61 67 65 20 73 69  7a 65 20 73 65 74 20 74  | page size set t|
000012f0  6f 20 22 50 72 69 6e 74  65 72 20 73 69 7a 65 22  |o "Printer size"|
00001300  2e 20 48 6f 77 65 76 65  72 2c 20 69 66 20 79 6f  |. However, if yo|
00001310  75 0a 68 61 76 65 20 73  70 65 63 69 61 6c 20 72  |u.have special r|
00001320  65 71 75 69 72 65 6d 65  6e 74 73 2c 20 65 2e 67  |equirements, e.g|
00001330  20 74 6f 20 66 69 74 20  74 68 65 20 4e 55 70 20  | to fit the NUp |
00001340  70 61 6e 65 6c 73 20 74  6f 20 61 20 73 68 65 65  |panels to a shee|
00001350  74 20 6f 66 20 73 74 69  63 6b 79 0a 6c 61 62 65  |t of sticky.labe|
00001360  6c 73 2c 20 79 6f 75 20  6d 69 67 68 74 20 77 61  |ls, you might wa|
00001370  6e 74 20 74 6f 20 64 65  66 69 6e 65 20 61 20 22  |nt to define a "|
00001380  43 75 73 74 6f 6d 20 73  69 7a 65 22 2e 20 43 6c  |Custom size". Cl|
00001390  69 63 6b 20 74 68 65 20  72 61 64 69 6f 20 62 75  |ick the radio bu|
000013a0  74 74 6f 6e 2c 20 61 6e  64 0a 74 68 65 20 63 75  |tton, and.the cu|
000013b0  73 74 6f 6d 20 64 69 6d  65 6e 73 69 6f 6e 20 65  |stom dimension e|
000013c0  6e 74 72 69 65 73 20 77  69 6c 6c 20 62 65 63 6f  |ntries will beco|
000013d0  6d 65 20 77 72 69 74 65  61 62 6c 65 2e 20 54 68  |me writeable. Th|
000013e0  65 20 76 61 6c 75 65 73  20 61 72 65 20 61 6c 6c  |e values are all|
000013f0  20 69 6e 20 6d 6d 2e 0a  54 68 65 20 77 69 64 74  | in mm..The widt|
00001400  68 20 61 6e 64 20 68 65  69 67 68 74 20 61 72 65  |h and height are|
00001410  20 74 68 65 20 70 61 67  65 20 73 69 7a 65 20 5f  | the page size _|
00001420  69 6e 63 6c 75 64 69 6e  67 5f 20 6d 61 72 67 69  |including_ margi|
00001430  6e 73 2e 20 54 68 65 20  6d 61 72 67 69 6e 73 20  |ns. The margins |
00001440  61 72 65 0a 61 6c 6c 20  5f 69 6e 77 61 72 64 73  |are.all _inwards|
00001450  5f 20 66 72 6f 6d 20 74  68 65 20 65 64 67 65 20  |_ from the edge |
00001460  6f 66 20 74 68 65 20 70  61 67 65 2e 20 48 6f 77  |of the page. How|
00001470  65 76 65 72 2c 20 6e 65  67 61 74 69 76 65 20 6d  |ever, negative m|
00001480  61 72 67 69 6e 20 76 61  6c 75 65 73 20 61 72 65  |argin values are|
00001490  0a 61 6c 6c 6f 77 65 64  2e 0a 0a 57 68 65 6e 20  |.allowed...When |
000014a0  79 6f 75 20 61 72 65 20  68 61 70 70 79 20 77 69  |you are happy wi|
000014b0  74 68 20 74 68 65 20 73  65 74 75 70 20 63 6c 69  |th the setup cli|
000014c0  63 6b 20 22 53 65 74 22  2e 20 49 66 20 79 6f 75  |ck "Set". If you|
000014d0  20 77 61 6e 74 20 74 6f  20 72 65 76 65 72 74 20  | want to revert |
000014e0  74 6f 20 74 68 65 0a 6f  6c 64 20 73 65 74 75 70  |to the.old setup|
000014f0  20 63 6c 69 63 6b 20 22  43 61 6e 63 65 6c 22 2e  | click "Cancel".|
00001500  20 49 66 20 79 6f 75 20  77 61 6e 74 20 74 6f 20  | If you want to |
00001510  70 72 65 73 65 72 76 65  20 74 68 65 20 73 65 74  |preserve the set|
00001520  75 70 20 66 6f 72 20 74  68 65 20 6e 65 78 74 20  |up for the next |
00001530  74 69 6d 65 0a 4e 55 70  20 69 73 20 72 75 6e 20  |time.NUp is run |
00001540  63 6c 69 63 6b 20 22 53  61 76 65 22 2e 0a 0a 0a  |click "Save"....|
00001550  50 72 69 6e 74 69 6e 67  0a 3d 3d 3d 3d 3d 3d 3d  |Printing.=======|
00001560  3d 0a 0a 57 68 65 6e 20  79 6f 75 20 77 61 6e 74  |=..When you want|
00001570  20 74 6f 20 70 72 69 6e  74 20 74 68 65 20 70 61  | to print the pa|
00001580  67 65 20 64 69 73 70 6c  61 79 65 64 20 69 6e 20  |ge displayed in |
00001590  74 68 65 20 6d 61 69 6e  20 77 69 6e 64 6f 77 2c  |the main window,|
000015a0  20 65 76 65 6e 20 69 66  20 69 74 20 69 73 0a 6e  | even if it is.n|
000015b0  6f 74 20 66 75 6c 6c 2c  20 73 65 6c 65 63 74 20  |ot full, select |
000015c0  22 50 72 69 6e 74 2e 2e  2e 22 20 66 72 6f 6d 20  |"Print..." from |
000015d0  74 68 65 20 4e 55 70 20  6d 65 6e 75 2e 20 54 68  |the NUp menu. Th|
000015e0  69 73 20 77 69 6c 6c 20  70 6f 70 20 75 70 20 61  |is will pop up a|
000015f0  20 64 69 61 6c 6f 67 75  65 0a 62 6f 78 20 73 68  | dialogue.box sh|
00001600  6f 77 69 6e 67 20 74 68  65 20 63 75 72 72 65 6e  |owing the curren|
00001610  74 6c 79 20 73 65 6c 65  63 74 65 64 20 70 72 69  |tly selected pri|
00001620  6e 74 65 72 20 61 6e 64  20 74 68 65 20 6e 75 6d  |nter and the num|
00001630  62 65 72 20 6f 66 20 63  6f 70 69 65 73 20 74 68  |ber of copies th|
00001640  65 0a 70 72 69 6e 74 2e  20 59 6f 75 20 6d 61 79  |e.print. You may|
00001650  20 63 68 61 6e 67 65 20  74 68 65 20 6c 61 74 74  | change the latt|
00001660  65 72 20 62 79 20 65 6e  74 65 72 69 6e 67 20 61  |er by entering a|
00001670  20 6e 75 6d 62 65 72 20  6f 72 20 63 6c 69 63 6b  | number or click|
00001680  69 6e 67 20 74 68 65 20  75 70 20 6f 72 0a 64 6f  |ing the up or.do|
00001690  77 6e 20 62 75 6d 70 20  69 63 6f 6e 73 2e 0a 0a  |wn bump icons...|
000016a0  57 68 65 6e 20 79 6f 75  20 61 72 65 20 73 61 74  |When you are sat|
000016b0  69 73 66 69 65 64 20 63  6c 69 63 6b 20 22 50 72  |isfied click "Pr|
000016c0  69 6e 74 22 2e 20 43 6c  69 63 6b 20 22 43 61 6e  |int". Click "Can|
000016d0  63 65 6c 22 20 74 6f 20  63 61 6e 63 65 6c 20 74  |cel" to cancel t|
000016e0  68 65 20 70 72 69 6e 74  0a 6f 70 65 72 61 74 69  |he print.operati|
000016f0  6f 6e 2e 0a 0a 59 6f 75  20 79 6f 75 20 77 61 6e  |on...You you wan|
00001700  74 20 74 6f 20 73 65 74  20 74 68 65 20 6e 75 6d  |t to set the num|
00001710  62 65 72 20 6f 66 20 63  6f 70 69 65 73 20 6f 6e  |ber of copies on|
00001720  6c 79 2c 20 66 6f 72 20  61 20 66 75 74 75 72 65  |ly, for a future|
00001730  20 28 61 75 74 6f 6d 61  74 69 63 29 20 70 72 69  | (automatic) pri|
00001740  6e 74 0a 6f 70 65 72 61  74 69 6f 6e 2c 20 73 65  |nt.operation, se|
00001750  74 20 74 68 65 20 6e 75  6d 62 65 72 20 61 6e 64  |t the number and|
00001760  20 63 6c 69 63 6b 20 22  50 72 69 6e 74 22 20 77  | click "Print" w|
00001770  69 74 68 20 5f 6e 6f 5f  20 66 69 6c 65 73 20 6c  |ith _no_ files l|
00001780  6f 61 64 65 64 2e 0a 0a  0a 46 6c 75 73 68 69 6e  |oaded....Flushin|
00001790  67 20 50 61 6e 65 6c 73  0a 3d 3d 3d 3d 3d 3d 3d  |g Panels.=======|
000017a0  3d 20 3d 3d 3d 3d 3d 3d  0a 0a 54 68 65 72 65 20  |= ======..There |
000017b0  61 72 65 20 74 77 6f 20  6d 65 6e 75 20 65 6e 74  |are two menu ent|
000017c0  72 69 65 73 20 66 6f 72  20 66 6c 75 73 68 69 6e  |ries for flushin|
000017d0  67 20 28 63 6c 65 61 72  69 6e 67 29 20 70 61 6e  |g (clearing) pan|
000017e0  65 6c 73 2e 20 22 46 6c  75 73 68 20 61 6c 6c 22  |els. "Flush all"|
000017f0  20 63 6c 65 61 72 73 0a  61 6c 6c 20 63 75 72 72  | clears.all curr|
00001800  65 6e 74 6c 79 20 6c 6f  61 64 65 64 20 64 72 61  |ently loaded dra|
00001810  77 66 69 6c 65 73 20 66  72 6f 6d 20 4e 55 70 2e  |wfiles from NUp.|
00001820  20 22 46 6c 75 73 68 20  70 61 67 65 22 20 63 6c  | "Flush page" cl|
00001830  65 61 72 73 20 6f 6e 6c  79 20 74 68 65 20 70 61  |ears only the pa|
00001840  6e 65 6c 73 0a 64 69 73  70 6c 61 79 65 64 20 69  |nels.displayed i|
00001850  6e 20 74 68 65 20 6d 61  69 6e 20 77 69 6e 64 6f  |n the main windo|
00001860  77 2e 20 49 66 20 74 68  65 72 65 20 77 65 72 65  |w. If there were|
00001870  20 6d 6f 72 65 20 74 68  61 6e 20 61 20 70 61 67  | more than a pag|
00001880  65 66 75 6c 20 6f 66 20  64 72 61 77 66 69 6c 65  |eful of drawfile|
00001890  73 0a 6c 6f 61 64 65 64  20 74 68 65 20 6e 65 78  |s.loaded the nex|
000018a0  74 20 70 61 67 65 66 75  6c 20 77 69 6c 6c 20 6e  |t pageful will n|
000018b0  6f 77 20 62 65 20 64 69  73 70 6c 61 79 65 64 20  |ow be displayed |
000018c0  69 6e 20 74 68 65 20 6d  61 69 6e 20 77 69 6e 64  |in the main wind|
000018d0  6f 77 2e 0a 0a 0a 22 41  75 74 6f 20 70 72 69 6e  |ow...."Auto prin|
000018e0  74 22 20 61 6e 64 20 22  41 75 74 6f 20 66 6c 75  |t" and "Auto flu|
000018f0  73 68 22 0a 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |sh".============|
00001900  20 3d 3d 3d 20 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  | === ===========|
00001910  3d 0a 0a 54 68 65 73 65  20 74 77 6f 20 6f 70 74  |=..These two opt|
00001920  69 6f 6e 73 20 69 6e 20  74 68 65 20 73 65 74 75  |ions in the setu|
00001930  70 20 64 69 61 6c 6f 67  75 65 20 67 6f 76 65 72  |p dialogue gover|
00001940  6e 20 74 68 65 20 61 75  74 6f 6d 61 74 69 63 20  |n the automatic |
00001950  70 72 69 6e 74 69 6e 67  20 61 6e 64 0a 66 6c 75  |printing and.flu|
00001960  73 68 69 6e 67 20 6f 66  20 74 68 65 20 6d 61 69  |shing of the mai|
00001970  6e 20 77 69 6e 64 6f 77  2e 20 57 69 74 68 20 22  |n window. With "|
00001980  41 75 74 6f 20 70 72 69  6e 74 22 20 73 65 6c 65  |Auto print" sele|
00001990  63 74 65 64 20 74 68 65  20 70 61 67 65 20 77 69  |cted the page wi|
000019a0  6c 6c 20 62 65 0a 70 72  69 6e 74 65 64 20 61 75  |ll be.printed au|
000019b0  74 6f 6d 61 74 69 63 61  6c 6c 79 20 61 73 20 73  |tomatically as s|
000019c0  6f 6f 6e 20 61 73 20 69  74 20 69 73 20 66 69 6c  |oon as it is fil|
000019d0  6c 65 64 2e 20 57 69 74  68 20 22 41 75 74 6f 20  |led. With "Auto |
000019e0  66 6c 75 73 68 22 20 73  65 6c 65 63 74 65 64 20  |flush" selected |
000019f0  74 68 65 0a 70 61 67 65  20 77 69 6c 6c 20 62 65  |the.page will be|
00001a00  20 66 6c 75 73 68 65 64  20 61 75 74 6f 6d 61 74  | flushed automat|
00001a10  69 63 61 6c 6c 79 20 61  66 74 65 72 20 69 74 20  |ically after it |
00001a20  69 73 20 70 72 69 6e 74  65 64 2e 20 49 66 20 79  |is printed. If y|
00001a30  6f 75 20 68 61 76 65 20  61 20 6c 61 72 67 65 0a  |ou have a large.|
00001a40  6e 75 6d 62 65 72 20 6f  66 20 66 69 6c 65 73 20  |number of files |
00001a50  74 6f 20 70 72 69 6e 74  20 79 6f 75 20 63 61 6e  |to print you can|
00001a60  20 73 65 6c 65 63 74 20  62 6f 74 68 20 74 68 65  | select both the|
00001a70  73 65 20 6f 70 74 69 6f  6e 73 2c 20 73 6f 20 74  |se options, so t|
00001a80  68 61 74 20 77 68 65 6e  20 79 6f 75 0a 64 72 61  |hat when you.dra|
00001a90  67 20 74 68 65 6d 20 74  6f 20 4e 55 70 20 70 61  |g them to NUp pa|
00001aa0  67 65 73 20 77 69 6c 6c  20 62 65 20 66 69 6c 6c  |ges will be fill|
00001ab0  65 64 20 61 6e 64 20 70  72 69 6e 74 65 64 20 61  |ed and printed a|
00001ac0  75 74 6f 6d 61 74 69 63  61 6c 6c 79 2e 20 54 68  |utomatically. Th|
00001ad0  65 72 65 20 6d 69 67 68  74 0a 62 65 20 61 6e 20  |ere might.be an |
00001ae0  75 6e 66 69 6c 6c 65 64  20 70 61 67 65 20 6c 65  |unfilled page le|
00001af0  66 74 20 61 74 20 74 68  65 20 65 6e 64 2c 20 69  |ft at the end, i|
00001b00  6e 20 77 68 69 63 68 20  63 61 73 65 20 79 6f 75  |n which case you|
00001b10  20 77 69 6c 6c 20 68 61  76 65 20 74 6f 20 73 65  | will have to se|
00001b20  6c 65 63 74 0a 22 50 72  69 6e 74 2e 2e 2e 22 20  |lect."Print..." |
00001b30  6d 61 6e 75 61 6c 6c 79  2e 0a 0a 0a 53 63 61 6c  |manually....Scal|
00001b40  69 6e 67 0a 3d 3d 3d 3d  3d 3d 3d 0a 0a 54 68 65  |ing.=======..The|
00001b50  20 22 53 63 61 6c 65 22  20 6d 65 6e 75 20 65 6e  | "Scale" menu en|
00001b60  74 72 79 20 6c 65 61 64  73 20 74 6f 20 61 20 22  |try leads to a "|
00001b70  53 63 61 6c 65 20 76 69  65 77 22 20 64 69 61 6c  |Scale view" dial|
00001b80  6f 67 75 65 20 62 6f 78  2e 20 54 68 69 73 20 68  |ogue box. This h|
00001b90  61 73 20 62 75 74 74 6f  6e 73 0a 74 6f 20 73 65  |as buttons.to se|
00001ba0  74 20 74 68 65 20 73 63  61 6c 69 6e 67 20 74 6f  |t the scaling to|
00001bb0  20 61 6e 79 20 6f 66 20  76 61 72 69 6f 75 73 20  | any of various |
00001bc0  70 72 65 73 65 74 20 76  61 6c 75 65 73 2c 20 6f  |preset values, o|
00001bd0  72 20 79 6f 75 20 63 61  6e 20 65 6e 74 65 72 20  |r you can enter |
00001be0  79 6f 75 72 0a 64 65 73  69 72 65 64 20 76 61 6c  |your.desired val|
00001bf0  75 65 20 64 69 72 65 63  74 6c 79 2e 20 54 68 65  |ue directly. The|
00001c00  72 65 20 69 73 20 61 20  22 53 63 61 6c 65 20 74  |re is a "Scale t|
00001c10  6f 20 66 69 74 22 20 62  75 74 74 6f 6e 2c 20 77  |o fit" button, w|
00001c20  68 69 63 68 20 77 69 6c  6c 20 73 65 6c 65 63 74  |hich will select|
00001c30  0a 74 68 65 20 62 65 73  74 20 73 63 61 6c 69 6e  |.the best scalin|
00001c40  67 20 74 6f 20 66 69 74  20 74 68 65 20 77 69 6e  |g to fit the win|
00001c50  64 6f 77 20 74 6f 20 74  68 65 20 63 75 72 72 65  |dow to the curre|
00001c60  6e 74 20 73 63 72 65 65  6e 20 6d 6f 64 65 2e 20  |nt screen mode. |
00001c70  43 6c 69 63 6b 20 6f 6e  0a 22 53 63 61 6c 65 22  |Click on."Scale"|
00001c80  20 77 68 65 6e 20 79 6f  75 20 61 72 65 20 68 61  | when you are ha|
00001c90  70 70 79 20 77 69 74 68  20 74 68 65 20 73 65 74  |ppy with the set|
00001ca0  74 69 6e 67 2c 20 6f 72  20 22 43 61 6e 63 65 6c  |ting, or "Cancel|
00001cb0  22 20 74 6f 20 75 73 65  20 74 68 65 20 6f 6c 64  |" to use the old|
00001cc0  0a 76 61 6c 75 65 2e 0a  0a 4e 6f 74 65 20 74 68  |.value...Note th|
00001cd0  61 74 20 74 68 65 20 73  69 7a 65 20 6f 66 20 74  |at the size of t|
00001ce0  68 65 20 70 72 69 6e 74  65 64 20 76 65 72 73 69  |he printed versi|
00001cf0  6f 6e 20 69 73 20 6e 6f  74 20 61 66 66 65 63 74  |on is not affect|
00001d00  65 64 20 62 79 20 74 68  69 73 20 73 63 61 6c 65  |ed by this scale|
00001d10  0a 66 61 63 74 6f 72 2e  0a 0a 0a 41 64 76 61 6e  |.factor....Advan|
00001d20  63 65 64 20 73 65 74 75  70 0a 3d 3d 3d 3d 3d 3d  |ced setup.======|
00001d30  3d 3d 20 3d 3d 3d 3d 3d  0a 0a 49 66 20 79 6f 75  |== =====..If you|
00001d40  20 61 72 65 20 66 61 6d  69 6c 69 61 72 20 77 69  | are familiar wi|
00001d50  74 68 20 74 68 65 20 6f  70 65 72 61 74 69 6f 6e  |th the operation|
00001d60  20 6f 66 20 73 79 73 74  65 6d 20 61 6c 69 61 73  | of system alias|
00001d70  65 73 20 79 6f 75 20 6d  69 67 68 74 20 6c 69 6b  |es you might lik|
00001d80  65 20 74 6f 0a 75 73 65  20 79 6f 75 72 20 62 6f  |e to.use your bo|
00001d90  6f 74 20 73 65 71 75 65  6e 63 65 2c 20 65 74 63  |ot sequence, etc|
00001da0  2c 20 74 6f 20 72 65 64  65 66 69 6e 65 20 74 68  |, to redefine th|
00001db0  65 20 77 61 79 20 74 68  61 74 20 4e 55 70 20 63  |e way that NUp c|
00001dc0  61 6c 6c 73 20 69 74 73  20 68 65 6c 70 65 72 0a  |alls its helper.|
00001dd0  61 70 70 6c 69 63 61 74  69 6f 6e 73 2e 20 49 66  |applications. If|
00001de0  20 79 6f 75 20 6c 6f 6f  6b 20 61 74 20 21 4e 55  | you look at !NU|
00001df0  70 2e 21 52 75 6e 20 79  6f 75 20 77 69 6c 6c 20  |p.!Run you will |
00001e00  73 65 65 20 6c 69 6e 65  73 20 64 65 66 69 6e 69  |see lines defini|
00001e10  6e 67 20 61 6c 69 61 73  65 73 20 6f 66 0a 74 68  |ng aliases of.th|
00001e20  65 20 66 6f 72 6d 20 41  6c 69 61 73 24 4e 55 70  |e form Alias$NUp|
00001e30  48 65 6c 70 65 72 5f 78  78 78 2c 20 77 68 65 72  |Helper_xxx, wher|
00001e40  65 20 78 78 78 20 69 73  20 74 68 65 20 66 69 6c  |e xxx is the fil|
00001e50  65 74 79 70 65 2e 20 52  65 64 65 66 69 6e 69 6e  |etype. Redefinin|
00001e60  67 20 61 6e 79 20 6f 66  0a 74 68 65 73 65 20 61  |g any of.these a|
00001e70  66 74 65 72 20 4e 55 70  20 68 61 73 20 6c 6f 61  |fter NUp has loa|
00001e80  64 65 64 20 77 69 6c 6c  20 61 66 66 65 63 74 20  |ded will affect |
00001e90  74 68 65 20 63 6f 6e 76  65 72 73 69 6f 6e 20 6f  |the conversion o|
00001ea0  66 20 61 6e 79 20 66 69  6c 65 73 20 6f 66 20 74  |f any files of t|
00001eb0  68 61 74 0a 74 79 70 65  20 73 75 62 73 65 71 75  |hat.type subsequ|
00001ec0  65 6e 74 6c 79 20 6c 6f  61 64 65 64 2e 0a 0a 46  |ently loaded...F|
00001ed0  6f 72 20 69 6e 73 74 61  6e 63 65 2c 20 79 6f 75  |or instance, you|
00001ee0  20 6d 69 67 68 74 20 65  6e 74 65 72 20 74 68 65  | might enter the|
00001ef0  20 6c 69 6e 65 3a 0a 20  20 53 65 74 20 41 6c 69  | line:.  Set Ali|
00001f00  61 73 24 4e 55 70 48 65  6c 70 65 72 5f 66 66 66  |as$NUpHelper_fff|
00001f10  20 3c 4e 55 70 24 44 69  72 3e 2e 68 65 6c 70 65  | <NUp$Dir>.helpe|
00001f20  72 73 2e 54 78 74 32 4e  55 70 20 25 25 30 20 54  |rs.Txt2NUp %%0 T|
00001f30  72 69 6e 69 74 79 2e 4d  65 64 69 75 6d 20 32 30  |rinity.Medium 20|
00001f40  0a 54 68 69 73 20 77 6f  75 6c 64 20 63 68 61 6e  |.This would chan|
00001f50  67 65 20 74 68 65 20 66  6f 6e 74 20 75 73 65 64  |ge the font used|
00001f60  20 66 6f 72 20 74 65 78  74 20 66 69 6c 65 73 2e  | for text files.|
00001f70  0a 0a 49 66 20 79 6f 75  20 6c 69 6b 65 2c 20 79  |..If you like, y|
00001f80  6f 75 20 63 61 6e 20 63  68 61 6e 67 65 20 74 68  |ou can change th|
00001f90  65 20 61 6c 69 61 73 65  73 20 63 6f 6d 70 6c 65  |e aliases comple|
00001fa0  74 65 6c 79 2c 20 74 6f  20 70 6f 69 6e 74 20 74  |tely, to point t|
00001fb0  6f 20 79 6f 75 72 20 6f  77 6e 0a 68 65 6c 70 65  |o your own.helpe|
00001fc0  72 20 61 70 70 6c 69 63  61 74 69 6f 6e 73 2e 0a  |r applications..|
00001fd0  0a 0a 48 65 6c 70 65 72  20 61 70 70 6c 69 63 61  |..Helper applica|
00001fe0  74 69 6f 6e 73 0a 3d 3d  3d 3d 3d 3d 20 3d 3d 3d  |tions.====== ===|
00001ff0  3d 3d 3d 3d 3d 3d 3d 3d  3d 0a 0a 54 68 65 20 73  |=========..The s|
00002000  75 70 70 6c 69 65 64 20  68 65 6c 70 65 72 20 61  |upplied helper a|
00002010  70 70 6c 69 63 61 74 69  6f 6e 73 20 63 61 6e 20  |pplications can |
00002020  62 65 20 66 6f 75 6e 64  20 69 6e 20 21 4e 55 70  |be found in !NUp|
00002030  2e 68 65 6c 70 65 72 73  0a 54 68 65 73 65 20 73  |.helpers.These s|
00002040  75 70 70 6f 72 74 20 74  68 65 20 63 6f 6e 76 65  |upport the conve|
00002050  72 73 69 6f 6e 20 6f 66  20 74 65 78 74 20 74 6f  |rsion of text to|
00002060  20 64 72 61 77 2c 20 73  70 72 69 74 65 20 74 6f  | draw, sprite to|
00002070  20 64 72 61 77 2c 20 61  6e 64 20 6f 74 68 65 72  | draw, and other|
00002080  0a 62 69 74 6d 61 70 20  74 79 70 65 73 20 74 6f  |.bitmap types to|
00002090  20 64 72 61 77 2c 20 76  69 61 20 73 70 72 69 74  | draw, via sprit|
000020a0  65 73 2e 0a 0a 54 68 65  20 6f 70 65 72 61 74 69  |es...The operati|
000020b0  6f 6e 20 69 73 20 66 61  69 72 6c 79 20 73 69 6d  |on is fairly sim|
000020c0  70 6c 65 2e 20 57 68 65  6e 20 61 20 6e 6f 6e 2d  |ple. When a non-|
000020d0  64 72 61 77 20 66 69 6c  65 20 69 73 20 64 72 61  |draw file is dra|
000020e0  67 67 65 64 20 6f 6e 74  6f 20 4e 55 70 2c 20 69  |gged onto NUp, i|
000020f0  74 0a 63 68 65 63 6b 73  20 74 6f 20 73 65 65 20  |t.checks to see |
00002100  69 66 20 61 6e 20 61 6c  69 61 73 20 69 73 20 64  |if an alias is d|
00002110  65 66 69 6e 65 64 2e 20  49 66 20 69 74 20 69 73  |efined. If it is|
00002120  2c 20 69 74 20 65 78 65  63 75 74 65 73 20 74 68  |, it executes th|
00002130  65 20 61 6c 69 61 73 2e  20 49 74 20 69 73 0a 74  |e alias. It is.t|
00002140  68 65 6e 20 74 68 65 20  72 65 73 70 6f 6e 73 69  |hen the responsi|
00002150  62 69 6c 69 74 79 20 6f  66 20 74 68 65 20 68 65  |bility of the he|
00002160  6c 70 65 72 20 61 70 70  6c 69 63 61 74 69 6f 6e  |lper application|
00002170  2c 20 72 75 6e 20 62 79  20 74 68 65 20 61 6c 69  |, run by the ali|
00002180  61 73 2c 20 74 6f 20 6c  6f 61 64 0a 74 68 65 20  |as, to load.the |
00002190  66 69 6c 65 2c 20 63 6f  6e 76 65 72 74 20 69 74  |file, convert it|
000021a0  20 74 6f 20 64 72 61 77  20 66 6f 72 6d 61 74 20  | to draw format |
000021b0  61 6e 64 20 73 61 76 65  20 69 74 20 74 6f 20 74  |and save it to t|
000021c0  68 65 20 4e 55 70 20 61  70 70 6c 69 63 61 74 69  |he NUp applicati|
000021d0  6f 6e 2e 20 4e 55 70 0a  73 65 65 73 20 74 68 69  |on. NUp.sees thi|
000021e0  73 20 6a 75 73 74 20 61  73 20 61 6e 6f 74 68 65  |s just as anothe|
000021f0  72 20 64 72 61 77 20 66  69 6c 65 20 61 6e 64 20  |r draw file and |
00002200  6c 6f 61 64 73 20 69 74  20 74 68 72 6f 75 67 68  |loads it through|
00002210  20 74 68 65 20 6e 6f 72  6d 61 6c 0a 6d 65 63 68  | the normal.mech|
00002220  61 6e 69 73 6d 2e 20 48  6f 77 65 76 65 72 2c 20  |anism. However, |
00002230  4e 55 70 20 68 61 73 20  74 6f 20 6b 65 65 70 20  |NUp has to keep |
00002240  74 72 61 63 6b 20 6f 66  20 77 68 69 63 68 20 66  |track of which f|
00002250  69 6c 65 20 68 61 73 20  61 20 68 65 6c 70 65 72  |ile has a helper|
00002260  20 72 75 6e 6e 69 6e 67  2e 0a 49 74 20 77 69 6c  | running..It wil|
00002270  6c 20 71 75 65 75 65 20  64 65 6d 61 6e 64 73 20  |l queue demands |
00002280  66 6f 72 20 68 65 6c 70  65 72 73 20 75 6e 74 69  |for helpers unti|
00002290  6c 20 74 68 65 20 70 72  65 76 69 6f 75 73 20 6f  |l the previous o|
000022a0  6e 65 20 68 61 73 20 63  6f 6d 70 6c 65 74 65 64  |ne has completed|
000022b0  2e 20 54 68 69 73 0a 69  73 20 62 65 63 61 75 73  |. This.is becaus|
000022c0  65 20 73 6f 6d 65 20 66  69 6c 65 74 79 70 65 73  |e some filetypes|
000022d0  20 28 69 2e 65 20 73 70  72 69 74 65 20 61 6e 64  | (i.e sprite and|
000022e0  20 74 65 78 74 29 20 63  61 6e 20 72 65 73 75 6c  | text) can resul|
000022f0  74 20 69 6e 20 6d 6f 72  65 20 74 68 61 6e 20 6f  |t in more than o|
00002300  6e 65 0a 6f 75 74 70 75  74 20 66 69 6c 65 20 28  |ne.output file (|
00002310  6f 6e 65 20 70 65 72 20  73 70 72 69 74 65 20 69  |one per sprite i|
00002320  6d 61 67 65 20 6f 72 20  6f 6e 65 20 70 65 72 20  |mage or one per |
00002330  70 61 67 65 29 2e 20 54  6f 20 74 65 6c 6c 20 4e  |page). To tell N|
00002340  55 70 20 77 68 65 6e 20  69 74 20 68 61 73 0a 66  |Up when it has.f|
00002350  69 6e 69 73 68 65 64 20  77 69 74 68 20 61 20 66  |inished with a f|
00002360  69 6c 65 20 74 68 65 20  68 65 6c 70 65 72 20 61  |ile the helper a|
00002370  70 70 6c 69 63 61 74 69  6f 6e 20 6d 75 73 74 20  |pplication must |
00002380  73 65 6e 64 20 61 20 4e  55 70 48 65 6c 70 65 72  |send a NUpHelper|
00002390  44 79 69 6e 67 4d 65 73  73 61 67 65 0a 28 30 78  |DyingMessage.(0x|
000023a0  34 66 34 34 31 20 2d 20  72 65 67 69 73 74 65 72  |4f441 - register|
000023b0  65 64 29 20 6d 65 73 73  61 67 65 20 74 6f 20 4e  |ed) message to N|
000023c0  55 70 2e 20 54 68 65 20  64 61 74 61 20 70 61 72  |Up. The data par|
000023d0  74 20 6f 66 20 74 68 69  73 20 6d 65 73 73 61 67  |t of this messag|
000023e0  65 20 69 73 20 74 68 65  0a 6e 61 6d 65 20 6f 66  |e is the.name of|
000023f0  20 74 68 65 20 69 6e 70  75 74 20 66 69 6c 65 2e  | the input file.|
00002400  20 49 6e 20 66 61 63 74  20 74 68 69 73 20 69 73  | In fact this is|
00002410  20 6f 70 74 69 6f 6e 61  6c 2c 20 62 75 74 20 69  | optional, but i|
00002420  66 20 6e 6f 74 20 70 72  65 73 65 6e 74 20 74 68  |f not present th|
00002430  65 0a 66 69 72 73 74 20  62 79 74 65 20 6f 66 20  |e.first byte of |
00002440  74 68 65 20 64 61 74 61  20 70 61 72 74 20 6d 75  |the data part mu|
00002450  73 74 20 62 65 20 30 2e  20 41 20 74 72 69 76 69  |st be 0. A trivi|
00002460  61 6c 20 61 70 70 6c 69  63 61 74 69 6f 6e 20 69  |al application i|
00002470  6e 20 74 68 65 20 68 65  6c 70 65 72 73 0a 64 69  |n the helpers.di|
00002480  72 65 63 74 6f 72 79 20  28 21 4e 55 70 2e 68 65  |rectory (!NUp.he|
00002490  6c 70 65 72 73 2e 6e 75  70 6f 62 69 74 29 20 70  |lpers.nupobit) p|
000024a0  65 72 66 6f 72 6d 73 20  74 68 69 73 20 74 61 73  |erforms this tas|
000024b0  6b 2e 0a 0a 0a 43 6f 6e  74 72 6f 6c 6c 69 6e 67  |k....Controlling|
000024c0  20 4e 55 70 20 72 65 6d  6f 74 65 6c 79 0a 3d 3d  | NUp remotely.==|
000024d0  3d 3d 3d 3d 3d 3d 3d 3d  3d 20 3d 3d 3d 20 3d 3d  |========= === ==|
000024e0  3d 3d 3d 3d 3d 3d 0a 0a  54 68 65 20 74 61 73 6b  |======..The task|
000024f0  20 66 6f 72 20 77 68 69  63 68 20 49 20 6f 72 69  | for which I ori|
00002500  67 69 6e 61 6c 6c 79 20  77 72 6f 74 65 20 4e 55  |ginally wrote NU|
00002510  70 20 77 61 73 20 74 6f  20 68 61 6e 64 6c 65 20  |p was to handle |
00002520  64 72 61 77 20 66 69 6c  65 73 20 70 72 6f 64 75  |draw files produ|
00002530  63 65 64 0a 61 75 74 6f  6d 61 74 69 63 61 6c 6c  |ced.automaticall|
00002540  79 20 62 79 20 61 6e 6f  74 68 65 72 20 61 70 70  |y by another app|
00002550  6c 69 63 61 74 69 6f 6e  2e 20 54 6f 20 66 75 6c  |lication. To ful|
00002560  6c 79 20 61 75 74 6f 6d  61 74 65 20 65 76 65 72  |ly automate ever|
00002570  79 74 68 69 6e 67 20 69  74 20 62 65 63 61 6d 65  |ything it became|
00002580  0a 61 70 70 61 72 65 6e  74 20 74 68 61 74 20 49  |.apparent that I|
00002590  20 73 68 6f 75 6c 64 20  61 64 64 20 61 20 66 61  | should add a fa|
000025a0  63 69 6c 69 74 79 20 66  6f 72 20 74 68 69 73 20  |cility for this |
000025b0  61 70 70 6c 69 63 61 74  69 6f 6e 20 28 6f 72 20  |application (or |
000025c0  61 6e 79 20 6f 74 68 65  72 29 20 74 6f 0a 74 61  |any other) to.ta|
000025d0  6b 65 20 63 6f 6e 74 72  6f 6c 20 6f 66 20 4e 55  |ke control of NU|
000025e0  70 27 73 20 73 65 74 75  70 2c 20 65 74 63 2e 20  |p's setup, etc. |
000025f0  54 68 69 73 20 69 73 20  64 6f 6e 65 20 75 73 69  |This is done usi|
00002600  6e 67 20 74 68 65 20 77  69 6d 70 20 6d 65 73 73  |ng the wimp mess|
00002610  61 67 65 0a 4e 55 70 43  6f 6e 74 72 6f 6c 4d 65  |age.NUpControlMe|
00002620  73 73 61 67 65 20 28 30  78 34 66 34 34 30 20 2d  |ssage (0x4f440 -|
00002630  20 72 65 67 69 73 74 65  72 65 64 29 2e 20 54 68  | registered). Th|
00002640  65 20 66 6f 72 6d 61 74  20 6f 66 20 74 68 65 20  |e format of the |
00002650  64 61 74 61 20 62 6c 6f  63 6b 20 69 73 0a 6e 6f  |data block is.no|
00002660  6e 2d 74 72 69 76 69 61  6c 2c 20 61 6e 64 20 70  |n-trivial, and p|
00002670  6f 73 73 69 62 6c 79 20  73 75 62 6a 65 63 74 20  |ossibly subject |
00002680  74 6f 20 63 68 61 6e 67  65 3b 20 73 6f 20 49 20  |to change; so I |
00002690  77 6f 6e 27 74 20 64 65  73 63 72 69 62 65 20 69  |won't describe i|
000026a0  74 20 68 65 72 65 2e 0a  48 6f 77 65 76 65 72 2c  |t here..However,|
000026b0  20 49 20 68 61 76 65 20  70 72 6f 76 69 64 65 64  | I have provided|
000026c0  20 61 6e 20 61 70 70 6c  69 63 61 74 69 6f 6e 20  | an application |
000026d0  69 6e 20 74 68 65 20 68  65 6c 70 65 72 73 20 64  |in the helpers d|
000026e0  69 72 65 63 74 6f 72 79  20 63 61 6c 6c 65 64 0a  |irectory called.|
000026f0  22 6e 75 70 63 6f 6e 74  22 2e 20 52 75 6e 6e 69  |"nupcont". Runni|
00002700  6e 67 20 74 68 69 73 20  77 69 6c 6c 20 73 65 6e  |ng this will sen|
00002710  64 20 63 6f 6e 74 72 6f  6c 20 6d 65 73 73 61 67  |d control messag|
00002720  65 73 20 74 6f 20 4e 55  70 20 28 6d 61 6b 65 20  |es to NUp (make |
00002730  73 75 72 65 20 4e 55 70  20 69 73 0a 72 75 6e 6e  |sure NUp is.runn|
00002740  69 6e 67 20 66 69 72 73  74 29 2e 0a 0a 54 68 65  |ing first)...The|
00002750  20 73 77 69 74 63 68 65  73 20 74 6f 20 6e 75 70  | switches to nup|
00002760  63 6f 6e 74 20 74 6f 20  73 65 74 20 74 68 65 20  |cont to set the |
00002770  74 79 70 65 20 6f 66 20  63 6f 6e 74 72 6f 6c 20  |type of control |
00002780  6d 65 73 73 61 67 65 20  61 72 65 3a 0a 0a 20 20  |message are:..  |
00002790  66 20 20 20 20 66 6c 75  73 68 20 70 61 67 65 0a  |f    flush page.|
000027a0  0a 20 20 46 20 20 20 20  66 6c 75 73 68 20 61 6c  |.  F    flush al|
000027b0  6c 0a 0a 20 20 70 20 20  20 20 70 72 69 6e 74 0a  |l..  p    print.|
000027c0  20 20 20 20 20 20 20 20  20 20 20 63 20 4e 20 20  |           c N  |
000027d0  61 66 74 65 72 20 27 70  27 20 73 65 74 73 20 6e  |after 'p' sets n|
000027e0  75 6d 62 65 72 20 6f 66  20 63 6f 70 69 65 73 20  |umber of copies |
000027f0  74 6f 20 4e 0a 20 20 20  20 20 20 20 20 20 65 2e  |to N.         e.|
00002800  67 20 6e 75 70 63 6f 6e  74 20 2d 70 63 20 34 0a  |g nupcont -pc 4.|
00002810  20 20 20 20 20 20 20 20  20 20 20 70 72 69 6e 74  |           print|
00002820  73 20 34 20 63 6f 70 69  65 73 0a 0a 20 20 6f 20  |s 4 copies..  o |
00002830  20 20 20 73 65 74 20 6f  70 74 69 6f 6e 73 0a 20  |   set options. |
00002840  20 20 20 20 20 20 20 20  70 61 72 61 6d 65 74 65  |        paramete|
00002850  72 73 20 28 63 6f 6d 70  75 6c 73 61 72 79 29 20  |rs (compulsary) |
00002860  61 72 65 3a 0a 20 20 20  20 20 20 20 20 20 20 20  |are:.           |
00002870  78 20 79 20 6c 61 6e 64  73 63 61 70 65 20 61 75  |x y landscape au|
00002880  74 6f 5f 70 72 69 6e 74  20 61 75 74 6f 5f 66 6c  |to_print auto_fl|
00002890  75 73 68 0a 20 20 20 20  20 20 20 20 20 65 2e 67  |ush.         e.g|
000028a0  20 6e 75 70 63 6f 6e 74  20 2d 6f 20 32 20 32 20  | nupcont -o 2 2 |
000028b0  31 20 30 20 31 0a 20 20  20 20 20 20 20 20 20 20  |1 0 1.          |
000028c0  20 32 20 62 79 20 32 2c  20 6c 61 6e 64 73 63 61  | 2 by 2, landsca|
000028d0  70 65 2c 20 61 75 74 6f  20 70 72 69 6e 74 20 6f  |pe, auto print o|
000028e0  66 66 2c 20 61 75 74 6f  20 66 6c 75 73 68 20 6f  |ff, auto flush o|
000028f0  6e 0a 0a 20 20 63 20 20  20 20 63 75 73 74 6f 6d  |n..  c    custom|
00002900  20 70 61 67 65 20 73 69  7a 65 0a 20 20 20 20 20  | page size.     |
00002910  20 20 20 20 70 61 72 61  6d 65 74 65 72 73 20 28  |    parameters (|
00002920  63 6f 6d 70 75 6c 73 61  72 79 29 20 61 72 65 20  |compulsary) are |
00002930  28 75 6e 69 74 20 69 73  20 30 2e 31 20 6d 6d 29  |(unit is 0.1 mm)|
00002940  3a 0a 20 20 20 20 20 20  20 20 20 20 20 6c 6d 61  |:.           lma|
00002950  72 67 20 62 6d 61 72 67  20 72 6d 72 67 20 74 6d  |rg bmarg rmrg tm|
00002960  61 72 67 20 77 69 64 74  68 20 68 65 69 67 68 74  |arg width height|
00002970  0a 0a 20 20 64 20 20 20  20 75 73 65 20 64 65 66  |..  d    use def|
00002980  61 75 6c 74 20 70 61 67  65 20 73 69 7a 65 0a 0a  |ault page size..|
00002990  0a 50 72 6f 62 6c 65 6d  73 0a 3d 3d 3d 3d 3d 3d  |.Problems.======|
000029a0  3d 3d 0a 0a 41 74 20 70  72 65 73 65 6e 74 20 49  |==..At present I|
000029b0  20 61 6d 20 6e 6f 74 20  61 77 61 72 65 20 6f 66  | am not aware of|
000029c0  20 61 6e 79 20 62 75 67  73 2e 20 50 6c 65 61 73  | any bugs. Pleas|
000029d0  65 20 73 65 65 20 62 65  6c 6f 77 20 66 6f 72 20  |e see below for |
000029e0  63 6f 6e 74 61 63 74 20  64 65 74 61 69 6c 73 0a  |contact details.|
000029f0  69 66 20 79 6f 75 20 66  69 6e 64 20 61 6e 79 2e  |if you find any.|
00002a00  0a 0a 42 65 20 73 75 72  65 20 74 6f 20 68 61 76  |..Be sure to hav|
00002a10  65 20 21 50 72 69 6e 74  65 72 73 20 72 75 6e 6e  |e !Printers runn|
00002a20  69 6e 67 20 62 65 66 6f  72 65 20 74 72 79 69 6e  |ing before tryin|
00002a30  67 20 74 6f 20 72 75 6e  20 4e 55 70 2e 0a 0a 49  |g to run NUp...I|
00002a40  66 20 61 6e 79 20 6f 66  20 41 63 6f 72 6e 27 73  |f any of Acorn's|
00002a50  20 74 6f 6f 6c 62 6f 78  20 6d 6f 64 75 6c 65 73  | toolbox modules|
00002a60  20 28 74 6f 6f 6c 62 6f  78 2c 20 77 69 6e 64 6f  | (toolbox, windo|
00002a70  77 2c 20 64 72 77 61 66  69 6c 65 2c 20 65 74 63  |w, drwafile, etc|
00002a80  29 20 77 65 72 65 20 6e  6f 74 0a 73 75 70 70 6c  |) were not.suppl|
00002a90  69 65 64 20 77 69 74 68  20 74 68 69 73 20 64 69  |ied with this di|
00002aa0  73 74 72 69 62 75 74 69  6f 6e 20 79 6f 75 20 77  |stribution you w|
00002ab0  69 6c 6c 20 66 69 6e 64  20 74 68 65 6d 20 6f 6e  |ill find them on|
00002ac0  20 41 63 6f 72 6e 27 73  20 46 54 50 20 73 69 74  | Acorn's FTP sit|
00002ad0  65 2e 0a 0a 0a 43 6f 6e  74 61 63 74 69 6e 67 20  |e....Contacting |
00002ae0  74 68 65 20 61 75 74 68  6f 72 0a 3d 3d 3d 3d 3d  |the author.=====|
00002af0  3d 3d 3d 3d 3d 20 3d 3d  3d 20 3d 3d 3d 3d 3d 3d  |===== === ======|
00002b00  0a 0a 49 20 61 6d 20 63  75 72 72 65 6e 74 6c 79  |..I am currently|
00002b10  20 63 6f 6e 74 61 63 74  61 62 6c 65 20 66 6f 72  | contactable for|
00002b20  20 73 75 67 67 65 73 74  69 6f 6e 73 2c 20 62 75  | suggestions, bu|
00002b30  67 20 72 65 70 6f 72 74  73 2c 20 66 6c 61 74 74  |g reports, flatt|
00002b40  65 72 79 2c 20 65 74 63  2c 20 61 74 3a 0a 0a 73  |ery, etc, at:..s|
00002b50  6a 6d 40 6a 62 2e 6d 61  6e 2e 61 63 2e 75 6b 0a  |jm@jb.man.ac.uk.|
00002b60  0a 6f 72 0a 0a 73 6a 6d  40 6d 65 6c 68 75 69 73  |.or..sjm@melhuis|
00002b70  68 2e 64 65 6d 6f 6e 2e  63 6f 2e 75 6b 0a 0a 4f  |h.demon.co.uk..O|
00002b80  72 20 62 79 20 70 6f 73  74 20 61 73 3a 0a 0a 44  |r by post as:..D|
00002b90  72 2e 20 53 69 6d 6f 6e  20 4a 2e 20 4d 65 6c 68  |r. Simon J. Melh|
00002ba0  75 69 73 68 2c 0a 4e 2e  52 2e 41 2e 4c 2e 2c 0a  |uish,.N.R.A.L.,.|
00002bb0  4a 6f 64 72 65 6c 6c 20  42 61 6e 6b 2c 0a 4d 61  |Jodrell Bank,.Ma|
00002bc0  63 63 6c 65 73 66 69 65  6c 64 2c 0a 43 68 65 73  |cclesfield,.Ches|
00002bd0  68 69 72 65 2e 0a 53 4b  31 31 20 39 44 4c 0a 0a  |hire..SK11 9DL..|
00002be0  0a 59 6f 75 20 6d 69 67  68 74 20 6c 69 6b 65 20  |.You might like |
00002bf0  74 6f 20 76 69 73 69 74  20 6d 79 20 68 6f 6d 65  |to visit my home|
00002c00  20 70 61 67 65 3a 0a 68  74 74 70 3a 2f 2f 77 77  | page:.http://ww|
00002c10  77 2e 6a 62 2e 6d 61 6e  2e 61 63 2e 75 6b 2f 7e  |w.jb.man.ac.uk/~|
00002c20  73 6a 6d 2f 0a 77 68 65  72 65 20 79 6f 75 20 77  |sjm/.where you w|
00002c30  69 6c 6c 20 66 69 6e 64  20 69 6e 66 6f 72 6d 61  |ill find informa|
00002c40  74 69 6f 6e 20 61 62 6f  75 74 20 6d 65 2c 20 61  |tion about me, a|
00002c50  6e 64 20 4a 6f 64 72 65  6c 6c 20 42 61 6e 6b 27  |nd Jodrell Bank'|
00002c60  73 20 77 6f 72 6b 20 6f  6e 20 74 68 65 0a 43 6f  |s work on the.Co|
00002c70  73 6d 69 63 20 4d 69 63  72 6f 77 61 76 65 20 42  |smic Microwave B|
00002c80  61 63 6b 67 72 6f 75 6e  64 2e 0a                 |ackground..|
00002c8b