home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Datafile PD-CD 3
/
PDCD_3.iso
/
pocketbk
/
utilsu
/
vr3a100
/
vr3a
/
vr3a.doc
< prev
next >
Wrap
Text File
|
1994-01-09
|
11KB
|
303 lines
Prologue
--------------------------------------------------------------------------
This text is based on Gilles Kohl's HP95XL/HP100XL Vertical Reader v1.05
package. Many thanks to him to allow me to use his text.
Introduction
--------------------------------------------------------------------------
VR stands for 'vertical reader' and will add another use to your
palmtop: reading 'electronic texts'. (In short, etexts - these are
simply ASCII files and can range from short-stories to entire books
and novels.) Read a book or short-story wherever you have your
palmtop with you: on the train, on the plane, in that boring
conference - no need to carry piles of paper along.
VR allows you to hold your palmtop like you would hold a book:
upright, in one hand. Text is much easier to read this way - the
distances the eye has to travel are reduced. VR further increases
readability through the use of proportional fonts and on-the-fly word
wrapping. All navigation and control keys are conveniently located
near your thumb.
A word about word wrap, page positions and rescan
--------------------------------------------------------------------------
Unlike other reader programs, VR doesn't have an 80 column screen at
its disposal and can't output lines from the original text verbatim.
It must break them down into smaller units by using word wrap and
proportional fonts. To save memory, VR doesn't read the whole text
into memory, but works directly on the file level. VR also tries to
gain more space on the screen by reducing horizontal and vertical
whitespace (blanks and empty lines) a bit. While you are reading, VR
remembers the positions (in the file) of the pages you have visited,
so that you can get back to previous pages. Because of this, VR can't
directly jump to the end of your text, for example, if it has not
seen the last page yet. This is also the reason why you can confuse
VR by changing fonts while reading. When you change the text font,
the amount of text that fits on a page is very likely to change. This
in turn invalidates the page positions VR has remembered - they were
valid for the font previously used. The effect is overlap or gaps
(depending on the new font chosen) between pages. (Only when paging
back, though)
The solution is called 're-scan'. VR can be instructed to re-read
your text without actually displaying it, storing updated page
positions as it scans along. This will result in consistent pages,
and will allow you to jump to the last page of the text. Because
scanning may take a long time for larger texts, this operation is
not automatically done but is available from the menu.
VR command overview
--------------------------------------------------------------------------
All VR commands are directly accessibly via the menu and the
keyboard.
NEXT PAGE (<up-arrow>, <Enter>, or Psion-n)
PREVIOUS PAGE (<down-arrow>, <Delete>, or Psion-p)
JUMP TO PAGE (</>, or Psion-j)
These commands allow the reader to move around in the text.
OPEN TEXT FILE (Psion-o)
Will pop up a file query dialog to select a new text. By default, the
directory is "\TXT". Select a text and press <Enter> to
accept your selection, or cancel using <ESC>. If you select a new text,
the page positions, current page, text font and bookmarks (see below)
of the current text are saved first. Then, VR tries to recover the above
information for the newly opened text. (These are stored in *.VPG
files that have the same name as the text file they refer to.)
SELECT FONT (<*>, Psion-f)
This command will pop up a menu of text fonts. Select a font to be
used, and accept it using <Enter> or cancel the menu with <ESC>.
Be sure to read the section entitled 'A word about word wrap, page
positions and rescan' above.
ZOOM IN (<.>(>), Psion-z)
This command simply cycles forward through the text fonts without any
further interaction - it is probably most useful when directly accessed
on the keyboard (by pressing '.').
ZOOM OUT (<,>(<), Psion-Z)
This command simply cycles backwords through the text fonts without
any further interaction.
FIRST PAGE (<->, or Psion-<->)
Jumps to the very first page of the current text, as you would expect.
LAST PAGE (<+>, or Psion-<+>)
This is less obvious, as this command does _not_ necessarily jump to
the last page of your text. Instead, it can only jump to the last
page VR has ever seen of this text. For an explanation of this
behaviour, refer to the section entitled 'A word about word wrap,
page positions and rescan' above. The last page that VR currently
knows is displayed in the status window, see below.
DROP BOOKMARK (Psion-r)
GOTO BOOKMARK (Psion-g)
These two commands are used to drop bookmarks and jump to them. A
bookmark is simply a saved position in the text file that you can
later return to. Ten bookmarks are available - they are all
initialized to the start of the file. When you select 'Drop Bmk',
select the bookmark you want to drop and press <Enter> to drop it,
<ESC> to cancel or <SPACE> to view the current bookmark assignment.
You can later go back to that spot
using 'Goto Bmk'.
Note also that bookmarks really remember file positions, not pages.
Suppose you're reading a text in a rather tiny font, drop bookmark 1
on page 7 and then later decide to switch to a larger font and do a
rescan (see section entitled 'A word about word wrap, page positions
and rescan' above). The page number of bookmark 1 will now be higher
because pages contain less text. Also, bookmark 1 will probably not be
on the top of a page any more. When you jump to bookmark 1, VR will find
the correct location regardless of current page size.
FULL RESCAN (Psion-</>)
SCAN TO END (Psion-k)
These two commands scan your text as if you were reading it very fast
- without displaying the pages (the status window is updated though,
watch it to see the scan progress). A full rescan starts at page 1,
while a rescan to end starts at your current page. You would do a
full rescan to ensure correct page positions after a font change, for
example. A reason for a 'scan to end' might be that you want to go to
the last page of the text.
ABOUT VR (<help>, or Psion-v)
This command will issue some information on your VR version and its
author.
QUIT (<ESC>)
EXIT (Psion-x)
Well, the quit command leaves VR. There are actually two quit
commands: hitting the <ESC> key will ask for confirmation before
quitting. Hitting Psion-x will leave VR no questions asked.
The status window
--------------------------------------------------------------------------
VR uses two lines on the bottom of the screen to display some status
information. The lines looks like this:
Pag: 26/27 Fnt:6
Text: filename.txt
The PAG information gives the current page number, and the number of
the highest page that VR can currently go to. (It will do so when you
hit the <+> key or select the corresponding command from the menu).
The FNT field shows the currently selected text font number. And TEXT
show the filename of the current viewed file.
Font nomenclature
--------------------------------------------------------------------------
VR fonts are named using the following system:
letter 1: identifies the 'family'.
s: sans serif font ('helvetica' style)
f: font with serifs ('times roman' style)
letter 2: monospaced or proportional
m: monospaced
p: proportional
letter 3: character set
a: ascii only (characters from 32 to 126 available)
x: extended set
letter 4: type
n: normal
b: bold
letters 5-6: width in pixel for a monospaced font,
00 for a proportional font.
letters 7-8: depth in pixel for a monospaced font,
approximate point size for a proportional font.
Note: Currently VR3a only provides fixed width fonts (sm*.*)
[The following section is copied verbatim from Gilles Kohl's