PTRVIEW

The Launchpad Text File Viewer

by Dilwyn Jones


This is a rudimentary text file viewer, based on the code
used in the View command in Q-Trans.

It's purpose is simple: load a single text file and scroll
through it. If the lines of text are wider than can be
displayed in the visible screen area, you can pan across to
the full width of the text (as long as the text lines are not
wider than about 32,700 characters).

If a command line filename is given, that text file is loaded
and displayed. The Help command in Launchpad uses this
facility to display the text files.

CONFIGURATION

Configure the program settings using the usual Config or
MenuConfig to alter the level 1 config block settings.

1. Sound off or on - the beeps accompanying error messages
2. Default drive/directory for loading text files
3. Default startup display size - choose from any of 6 sizes:
   1 - QL 512x256 screen
   2 - EGA (640x350)
   3 - VGA (640x480)
   4 - SVGA (800x600)
   5 - 1024x512 (Aurora or Q40/Q60)
   6 - 1024x768 (XGA)


STARTING THE PROGRAM

Simple execute PTRVIEW_OBJ :

EXEC FLP1_PTRVIEW_OBJ

If you want a file to be loaded automatically at startup:

EX FLP1_PTRVIEW_OBJ;'devX_filename'


USING THE PROGRAM

+---------------------------------------------------------+
| [move][resize][Zzz][Top][Up][PageUp][Load] [Filename]   |
|       [PageDown][Down][Bottom][Refresh][Copyright][ESC] |
|                                                         |

The program is mainly controlled by a single row of icons
along the top of the display:

MOVE - the usual icon for moving the program around the
screen.

RESIZE - Hit (left click) on this to cycle through the six
available display sizes, or Do (right click) on this to
select a size from a menu.

Zzz - put the program to sleep in the QPAC2 button frame

Top - jump to the top of the text

Up - Scroll up one line of text

PageUp - Up by one screenful of text

Load - bring up the file selection menu to choose a new file
to load.

Filename - shows the filename of the currently displayed
file. If you Hit on this item, it brings up the file
selection menu, if you Do on this item it lets you type in a
filename into the box - this might be useful if a filename
has been transferred via the stuffer buffer, for example.

Page Down - Down by one screenful of text

Down - down one line of text

Bottom - jump to the bottom of the text

Refresh - redraw the display

Copyright - brings up a short copyright menu about the
program

ESC - quit from the program.

Additionally, the following controls are available to
navigate through the text:

Hit (left click) on the upper half of the text window to
scroll up through the text

Do (right click) on the upper half of the text window to
scroll up a screenful.

Hit or Do on the bottom half of the window to scroll down.

Click on the pan bar at the bottom to pan sideways through
text to view wide lines of text.

Click on the scroll bar at the right to scroll up or down to
given poitns in the text.

THE FILE SELECTION MENU

This works just like the ones in Launchpad. A set of buttons
at the top let you navigate through directories on a disk,
while the larger box at the bottom displays the filenames.

A row of drive name icons lets you click on a 3 letter
directory device name to switch drives. Click on numbers 1 to
8 to select drive number. Click on DATAD$ or PROGD$ to select
the current DATA DEFAULT or PROGRAM DEFAULT drive names.
Click on the <- icon to go back down a directory.

Hit or Do on the F2 window to manually type in a new
drive/directory name.

In the main window, Hit or Do on a filename to select that
filename. Directories are shown with the '>' symbol before
their names; click on one of these directory names to enter
that directory if selecting files from a hard disk for
example.

Hit or Do on the little lightning symbol (Refresh) in the top
right to redraw the list of files on a given drive if
required.

ERRORS

If an error menu appears, follow the prompt to click on OK to
remove it.

RELEASE HISTORY

17.10.03  v1.00 First release.

21.10.03  v1.01 Scroll and pan bar now shown after loading a
                file specified via command line.

5.11.03   v1.02 No longer fails to display the last character
                of lines in files where maximum line width is
                an odd number.

12.11.03  v1.03 Uses revised display_cde file to prevent
                FLIM_W extension problems on older QDOS ROMs.

