home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Datafile PD-CD 3
/
PDCD_3.iso
/
utilities
/
utilsd
/
examine
/
!Examine
/
!Help
next >
Wrap
Text File
|
1993-04-22
|
12KB
|
308 lines
Help and information on !Examine (Copyright © Erik de Kort)
=============================================================
!Examine is a multitasking magnifier to be used on the desktop.
It consists of one main window (the display), plus a toolwindow
at the bottom of the display. The display shows the area around
your mousepointer (or around the caret) magnified.
The display
-----------
The main part of this application is ofcourse the display, that will show
the magnified screenarea. To keep the display is as small as possible, it
has no titlebar or scrollbars.
You can, however, move and resize it as shown below:
+---+--------+---+
| R/ \R |
| / \ |
|/ \|
| MOVE |
|\ /|
| \ / |
| R\ /R |
+---+--------+---+
In any of the corners, indicated with an 'R', the pointer will change
into an arrow with four directions. You can now resize the display by
depressing the select or the adjust button on your mouse.
Over the middle area the pointer will have the shape of a hand, meaning
that you can pickup the display (again by depressing the select or
the adjust button on your mouse) and move it around the screen.
You stop resizing or moving when you release the mousebutton.
Remember that pressing select will also bring the display window to
the front (adjust will not do that).
In the display area you may press menu, which will popup a .... menu!
This menu has the following layout:
+--------------+
| Info ⇨| -> Show application info
| Options ⇨| -> Show the options box
| Save Options | -> Save all options set in the Options box
+--------------+
| Back | -> Display to the bottom of the window stack.
| Front | -> Display to the top of the window stack.
| Close | -> Close displaywindow
+--------------+
| Quit | -> Quit application
+--------------+
Entries "Info" and "Quit" speak for themselves, but the "Options"
need a little explanation.
I will refer to the display window as "display".
The Options Box
---------------
This box contains some buttons, plus a zoom section.
Buttons:
"Show Pane" -- Enable/disable the toolwindow below the bottom left
corner of the display.
"Show Pointer" -- Enable/disable a pointer indication in the display.
"Cross" -- Select crosshair, or normal pointer indication.
This is only visible with "Show Pointer" enabled.
"Follow Caret" -- Enable/disable the follow-caret mode. (See below)
"Always" -- Stick with caret, regardless. (See below)
"Blank Display" -- If enabled, display window will show up as a
white/gray checkered pattern.
The zoom section provides a (sort of) standard zoom panel.
In the follow-caret mode, the area around the caret is displayed.
However, when you move the mousepointer outside the window that contains
the caret, the display will switch to the mousepointer. You can make
the display stay with the caret, if you select the "Always" option.
Also, the follow-caret mode is disabled while you hold down a mousebutton.
Remember that popping up a menu will also move the mousepointer outside
the window that contains the caret (but inside the menu!).
If you happen to lose track of the caret, you can get it back by using
the Shift-TAB hotkey (as in MENON, which is © Joris RÖling).
If you select the options box by clicking on the menu entry,
rather than moving right, the options box will not disappear
until you specifically close it.
The Toolwindow
--------------
... has the following layout:
+---+---+---+---+---+
|UDL| m | | d |UDR|
+---+---+---+---+---+
The locations 'm' and 'd' display the multiplication and division factors,
that means that the area around the mousepointer is enlarged or reduced
by the factor m/d. For instance m=2 and d=1 will enlarge by 2.
On the left and the right we have two locations 'UDL' and 'UDR'.
These locations contain sprites with arrows up and down, and
correspond to 'm' and 'r' respectively.
Clicking on one with select will add 1 to the corresponding factor,
adjust will subtract 1.
You can disable the display of this toolwindow in the options box.
Command line options:
---------------------
You may use the following options for controlling the defaults of !Examine:
Controlling the Options box: (replace '+' with '-' for the opposite effect)
"+pane" set the "Show Pane" button (default on)
"+pointer" set the "Show Pointer" button (default on)
"+cross" set the "Cross" button (default on)
"+caret" set the "Follow Caret" button (default off)
"+always" set the "Always" button (default off)
"+blank" set the "Blank Display" button (default on)
"-width n" will set the display width to n (default 300 OSunits)
"-height n" will set the display height to n (default 300 OSunits)
"-mul n" will set the multiplication factor to n (default 3)
"-div n" will set the division factor to n (default 1)
Ecample:
/<Examine$Dir>.!RunImage +pane +caret -pointer -blank -mul 5 -div 1
Command line options will take precedence over the saved options.
Desktop boot:
-------------
From version 0.25 on !Examine will include itself in a desktop boot file.
Interactive help:
-----------------
Again from version 0.25 on there is full support for interactive help.
The iconbar:
------------
Click on the iconbar icon to reopen the display if it was closed,
and put it on top of the window stack.
Templates:
----------
!Examine automaticly selects which set of templates should be used.
On RiscOS 2 the 'TemplRO2' set will be used, and on RiscOS 3
the 'TemplRO3' set will be used.
I have not seen my templates on RiscOS 3.00, possibly the fancy
borders need different validation strings.
Should the templates give you problems, then copy the 'TemplRO2'
file over the 'TemplRO3' one (but don't distribute it like that!).
Please inform me if any template troubles occur.
And that's it!
REMEMBER:
This is only a Beta test version, it was written in 8 days
and has therefore not undergone lengthy tests.
I cannot guarantee this program to be bugfree, and despite the
fact that I haven't encountered anything serious, you are well
advised to save important data regularly when working with
this application (you are well advised to do this *ALLWAYS* :-).
It is up to you to determine how 'safe' this program is,
afterall, that is what a Beta test is all about!
I am also interested in what you think of the sprites (particularly
the hand and the resizearrow), and how do you like the up/down
sprite as compared to 2 sprites for up and down (in the pane) ?
Have you noticed that the pointers "know" about letterbox/square pixel
modes ?
Please tell me if anything strange occurs, or if you have comments
on the above. The address is shown at the end of this document.
Your magnificent programmer,
Erik 'Hein' de Kort.
---------------------------------------------------------------------------
How to construct a crunched !RunImage:
______________________________________
I used Ragnar Hafstaðs BASIC cruncher (v1.02, frontend by Dick Alstein) with
the following options enabled (others disabled):
- Discard REM linesD
- Discard empty lines
- Crunch variable names
- Crunch FN/PROC names
- Convert SWI names to numbers
- Build multiple-statement lines
Exceptions to the above are listed in the textfile "DontCrunch".
---------------------------------------------------------------------------
Copyright conditions and disclaimer:
____________________________________
!Examine is FreeWare, which means the following:
- You should have obtained it free of charge.
- Copyright on all sources (including sprites and templates)
remains with me (Erik de Kort).
- You may use (parts of) the sources of !Examine for your own
applications if you meet the following conditions:
- Your application is FreeWare, and has the same copyright
conditions you are reading now. Ofcourse any sources you
create in addition to my sources are copyright you.
- All sources are provided in full.
This means that sources are available as re