
 -------------------------------------------------------------------------

                                 LogoutGUI

                             A Login requester
                          for MultiUserFileSystem

                       Release date 25th January 1998

                               PUBLIC DOMAIN

 -------------------------------------------------------------------------



Introduction
============

  The standard MultiUserFileSystem (muFS) login prompt is boring.  If
you follow the standard installation instructions, it opens on a plain
grey screen.  Well, actually, it opens on the Workbench screen, before
workbench is loaded, which amounts to the same thing.

  It would be cool if it could have a nice backdrop, and make some
kind of startup sound when it was ready.

  LogoutGUI does just that.  It loads a picture as a backdrop, and
plays a sound when its screen appears.

  But if its used to LogIN, why is it called LogOUTgui?  Because the
muFS installation instructions instruct you to use the Logout command
rather than the Login command, because it logs out the current user
before asking for a new one.


Requirements
============

  You need an amiga with :-

    - a hard drive with at least one muFS partition
    - Kickstart 3, for datatypes loading
    - at least one cool picture


Installation
============

  - Copy LogoutGUI to your C: directory.  Put this document somewhere
  safe for reference.

  - Edit your s:user-startup.  Find the line which displays the old
  login request, and modify it to read :-

    C:LogoutGUI <PICTUREFILE> SOUND=<SOUNDFILE>

    where <PICTUREFILE> is the name and path to your chosen login
  backdrop picture, and <SOUNDFILE> is the name and path to your chosen
  login sound.


Usage
=====

  LogoutGUI can only be used from the shell, or command line.

  LogoutGUI PICTURE/A SOUND/K BLANK=BORDERBLANK/S ALL/S

  PICTURE names a file which is used as the backdrop.  It also supplies
    the screen size, depth and mode id (eg PAL, NTSC, VGA etc...).
      You should modify the picture in a paint program so that the first
    four colours are grey, black, white and blue, so that the login window
    appears in normal colours.
      If the mouse pointer appears in the wrong colours, you should
    modify colours 17, 18 and 19 to be the same as your pointer's.
      If there is a problem loading the picture, then it will default
    back to a plain grey PAL screen.  If you need it to default to NTSC
    or VGA, you will have to modify the source code and recompile it.

  SOUND is any sound file you want played.  LogoutGUI uses datatypes to
    load and play the sound, so if you have ProtrackerDT, you could
    have a really long and funky tune.
      The sound is stopped when the user has logged in.

  BLANK causes the border of AGA machines to be black.  It just looks
    more professional.

  ALL causes all the previous logged in users to be logged out.  You
    should not need to use this.  See the muFS documentation for Logout
    for more details.


Bugs
====

  Icky nasty things.

  If muFS is not running on any partition, it might crash.  Actually, all
  the muFS programs seem to do that, so I might take a look at the sources
  some time.

  If you run it from the shell, it sometimes ignores the GUI flag and
  outputs a textual request.  Actually, the Logout command that comes
  with muFS does this too.  It seems to work fine from the user-startup
  though.


Future
======

  If I am feeling productive, I might add some of the following :-

    - Have an animation playing
    - Add a screen saver
    - Random picture/sound selection?
    - Option to tile the picture
    - Auto detection of PAL/NTSC


Disclaimer
==========

  NO!  ITS NOT MY FAULT!  GO AWAY!


Credits
=======

  This program was hacked together quickly from Logout.c, which is part
  of the muFS distribution; and from ViewDT.c which is a public domain
  picture datatypes example written by the kind folks at Cloante.

  muFS is © Copyright 1993-1994 Geert Uytterhoeven, and is available from
    Aminet:util/misc/MultiUser18bin.lha 128K

  ViewDT.c is Public Domain.  I've included it for reference.


Author
======

  Hi!  My name's Tak Tang.  I dont have E-mail currently, but if you're
  REALLY desperate to contact me, you can mail me at

    Tak Tang
    240 Broadlands Road
    Swaythling
    SOUTHAMPTON
    Hants
    SO17 3AS



