#############################################################

                                 GetScreenID 1.1

                         Written by GONCALVES A. Georges

               Copyright © 1994 by GONCALVES A. Georges ( Melkor )
                               All rights reserved

          #############################################################



                                   User manual

                                       of

                                   GetScreenID
                                   version 1.1


                                   * Sommary *


                        1 - Disclaimer
                        2 - Distribution
                        3 - Introduction
                        4 - Requirements
                        5 - Usage
                        6 - Hints and Tips
                        7 - Acknowledgements
                        8 - Contacting author


  1 - Disclaimer :
  ----------------

  The author is not responsible for any damage caused directly  or  indirectly
  by  the  use  of this program. If your monitor explode, your hardisk crashed
  and no more formatable or your 680x0 changed in an Intel type processor  its
  not my fault. Use it at your own risk.


  2 - Distribution :
  ------------------

  You can distribute it as long as you don't make money with it :(  It's NOT
  public domain but freely distribuable. Really, it's a CardWare program. That
  means if you enjoy and use it, you have the moral obligation to send me a
  postal card of your city or country, not so expensive I think ;-)
 
 
  3 - Introduction :
  ------------------

  Have you never been annoyed when you want to display a  picture,  with  your
  favourite  viewer,  in  a different screenmode than the one specified in the
  picture file and your viewer asks for a display ID or the string name of the
  screenmode instead of opening a ScreenModeRequester like the Asl or Reqtools
  ones ? Sure yes ! Don't you think that is very boring to type something like
  "PAL:High  Res  no  flicker"  every  time  you  want  it.  This  string only
  represents the DisplayID  of  a  ScreenMode  and  its  better  to  choose  a
  ScreenMode in a requester, isn't it ? That's the job of GetScreenID. It
  works similary to those GetPubName programs.


  4 - Requirements :
  ------------------

  You must have some little things in order to get GSI to work :

    - Reqtools.library V38 or better
    
    - a little Shell knowledge ( very little )
    
    - an Amiga ( GSI is useless on PCs as Screens don't exists ;-> )

    - You must hate MicroSoft Windows ;-)


  5 - Usage :
  -----------

  Here is the HARDER part ( joke ! )

  From Workbench : Doubleclick it and you'll have a ScreenModeRequester.
                   Choose the Mode and a Requester will show you the
                   appropriate DisplayID. Workbench use is most for info
                   purpose.

  From Shell     : Type GSI and you'll get the ScreenModeRequester. When
                   selected the DisplayID is inserted in the command line
                   so you can use it as follows :

                   PicViewer Pics:BeautyfullGirl SCREENMODE=`GSI`

                   and your PicViewer will receive as argument :

                   PicViewer Pics:BeautyfullGirl SCREENMODE=A9004

                   for "PAL:High Res No Flicker".


  Can it be easier ?


  6 - Hints ans tips :
  --------------------

  GSI has some features that can be transparent for a normal user and usefull
  for experienced ones.

  o The requesters appear on the frontmost public screen.

  o if the program that requires the DisplayID wants a 'C' formated hex number
    just add the 'C' prefix for a hex number : 0x or 0X

    ex:  PicViewer Pics:BeautyfullGirl SCREENMODE=0x`GSI` or ...MODE=0X`GSI`

    to   PicViewer Pics:BeautifullGirl SCREENMODE=0xA9004 or ...MODE=0XA9004


  7 - Acknowledgements :
  ----------------------

  GSI has been created using SAS/C 6.51 ( Poor guys on PCs with Borland  C  :-)
  It  was linked with the TinyStartup lib © Stéphane BUNEL ( TinyStartup is the
  MUI of startups, it controls all for you and so simple to use ( even  a  BABY
  can  program  with  it  ! ). Edition by GoldED ( Only Dietmar Eilert makes it
  possible ) on OS 3.x Kickstart 40.68, Workbench 40.42 ( What a wonderfull  OS
  ! ). Documentation was a piece of cake with the ( buggy but cool ) AGWritter.
  Of course, only an Amiga can run this thingies ( Thanks to the engineers  for
  making a so wonderfull computer ).

  and now the friends...


  Stéphane Bunel : Katov
                   TinyStartup is now really good and reliable. no more 'c.o'.
                   'Amiga for ever and PC for Lamer...'

  Christophe Paoutoff : Showgger
                        Hello 'Chojé', GSC is the best CPU board ever made.
                        4 CPUs, 3 CoPros and NO hardware needed :-)
                        That's the Exec's fault !!!!

  Olivier Laudren : Cople
                    RayTracing master !!! How are you my friend ?

  Nicolas Frank : Gryzor
                  ProWizard et DeliWizard are the ProTracker rulers !!!

  Kersten Emmrich : Emmy
                    33MHz ist nein genug, 40MHz ist gut !!!
  
  Magnus Holmgren :
                    Hello to my friend, the swedish knight :)

  Federico Giannici :
                      impossible to live without CycleToMenu !!!

  and many others I forgot, sorry :(


  8 - Contacting the author :
  ---------------------------

  I can be reached at :

    Goncalves A. Georges
    27, rue Morand
    75011 Paris
    FRANCE

  Sorry, no E-Mail address ( not yet :) .