* uhr * 16.3.96 * .hpr * may be used freely at no cost * .hpr'96 *


"uhr" displays a small old-fashioned clock to the top left of the
screen, 20 by 15 pixels wide, appearing as a black sqare with a
white scale. The display will be updated every minute, and within
one second after changing the i/o-channel, i.e. when changing to
another job by CTR/C or picking that job.

The Pointer-I.F. (PIF) is not necessary, though, it helps to re-
drawing the scale by just fetching the stored backgound picture,
which otherwise would be drawn from new every minute. If found the
clock will automatically be placed into the "button frame".

The clock remains always visible, regardless of the PIF locking
(other) windows. If invoked in another MODE than the current state
the display will be suppressed. One more clock may be installed at
the same screen position in the different MODE to always have a
clock displayed.

Optional parameters are:

flag:           "Q"
one number:     Format
two numbers:    Format, left
three numbers:  Format, left, top

"flag" was introduced to suppress a special error correction due to
some mistakes when reading the system clock occuring in conjunction
with the QXL-card. The parameter string usually should begin with
the flag set to "Q", by its own or, immediately followed by one of
the other parameters.

'Format' is a number determining the (approximately) square size
of the clocks background window, the sizes of which will become
four times the number of width and three time the number of height
measured in pixels.

'Left' and 'top' are the pixel co-ordiantes of the clocks windows
origin (as used in the WINDOW command).

The parameters should be delimeted by any character which is not a
decimal figure, with the exception of the "Q" which must immediately
preceed one of the number-parameters, if not passed just by ist own.

If a window channel number was passed as the first parameter (before
the sizes and flag containing string), the clock will appear in that
window, its height determining the clocks size.


Some examples:

        EX uhr;"Q4 450 2"
or
        EX uhr;"Q4,"&(SCR_XLIM-4*4)&",18"
in SMSQ executes a very small clock to the right of the screen.

        EX uhr;"Q8 "&(512-2-4*8)&" 14"
invokes the clock-window equivalent to a WINDOW definition of
        SCR_32x24a14x0

Or
        EX uhr,scr_80x60a4x4
quite a big one, with green display on black background. And

        nn = FOPEN("scr_80a400x2")
        PAPER#nn,4 : INK#nn,0 : BORDER#nn,1,7
        EX uhr,#nn;"Q20"
equally sized, to the right of the screen, white on black, and
adjusting(!) the windows sizes to the appropriate values


"Bugs":
Some screen savers might activate the screen display every minute
because of the QDOS-graphic routines used seem to re-position the
cursor or mouse pointers.


If any questions arise, please, refer to
    h.-peter recktenwald, 12159 bln, albestr. 21, t: 030 8520413

 eof 
