=============================================================================
FindIBar - Bring Icon Bar to fron on demand                      Version 0.03

(C) Stephen Fryatt, 1998-2014                                1 September 2014
=============================================================================


Licence
-------

  FindIBar is licensed under the EUPL, Version 1.1 only (the "Licence"); you
  may not use this work except in compliance with the Licence.

  You may obtain a copy of the Licence at
  http://joinup.ec.europa.eu/software/page/eupl

  Unless required by applicable law or agreed to in writing, software
  distributed under the Licence is distributed on an "AS IS" basis, WITHOUT
  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  See the Licence for the specific language governing permissions and
  limitations under the Licence.

  The source for FindIBar can be found alongside this binary download, at
  http://www.stevefryatt.org.uk/software



Introduction
------------

  FindIBar is an Icon Bar finder as featured in the new Nested WIMP.  If the
  bar is obscured by windows, move the pointer to the bottom of the screen
  and the bar will pop up; move the pointer out of the bar and it will fall
  to the back again.



Installing FindIBar
-------------------

  FindIBar requires RISC OS 3.1 or later.  It can be run off a hard disc or
  floppy disc.  Systems with the Nested Wimp (that is: RISC OS 4.02 or
  better, or where the Nested Wimp is being soft-loaded) should not need it,
  since they already have the same functionality included as standard.

  To install FindIBar on a hard disc, copy the FindIBar module to a suitable
  place on your disc.  If you want it to run on startup, FindIBar should be
  placed in your boot sequence.  On a RiscPC or a machine with the new boot
  structure installed, this can be done by copying it into the
  !Boot.Choices.Boot.Tasks directory (Shift-double-click on !Boot in the root
  directory of your hard drive, double-click on the Choices directory that
  appears, then on the Boot directory, then on the Tasks directory).  On
  older machines you will have to make your own arrangements, although you
  will probably have built your own boot sequence anyway.



Using FindIBar
--------------

  Run the FindIBar module (double-click it from the desktop, or RMRun it).
  Better still, for regular use install it somewhere where it will load every
  time your machine starts (!Boot.Choices.Boot.Tasks on a RiscPC).



*IBarMargin
-----------

  One star command is provided, to set the distance from the bottom of the
  screen that the pointer must be to bring the bar to the front.  With no
  argument, the current setting is printed (2 OS Units, or the bottom row of
  pixels, by default).  Specify a new value to change the distance (eg.
  "*IBarMargin 20" would set 20 OS Units).



How It Works
------------

  FindIBar is a bit kludgy -- sorry.  This is because the "legal" way to do
  what it does -- sending "Message_OpenWindow" events to the WIMP for the
  iconbar -- doesn't appear to work.  Instead, the program fakes Shift-F12
  presses and tries to remember where the bar is.  Occasionally it can get
  this wrong; you may need to move to pointer in and out of the bar to fix
  it.



Source Code
-----------

  The source for the module is available on my website for those who are
  interested in seeing how the whole things works.  You will need AsAsm or
  ObjAsm to get it to assemble.



Updates and Contacting Me
-------------------------

  If you have any comments about FindIBar, or would like to report any bugs
  that you find, you can email me at the address below.

  Updates to FindIBar and more software for RISC OS computers can be found
  on my website at http://www.stevefryatt.org.uk/software/

  Stephen Fryatt
  email: steve@stevefryatt.org.uk
