Program: NewPubScreen

Version: 1.4 (17.10.96)

Author:  Simon Clayton
         12 Valley Way
         Exmouth
         Devon
         EX8 4PD
         ENGLAND

         sdc395@ecs.soton.ac.uk

Short:   NewPubScreen is a simple CLI command which opens a public screen
         using the supplied name and screen mode.

Req.:    OS 2.0 or better.

The arguments are as follows:

NAME       - a name for the public screen.  It must be unique among the
             public screens.

WIDTH      - the width of the screen in pixels.  Default as Workbench.

HEIGHT     - the height of the screen in pixels.  Default as Workbench.

DEPTH      - the depth (number of bitplanes) of the screen.  Default as
             Workbench.

MODE       - the mode ID for the screen.  Common mode IDs are:

             NTSC:HalfBrite             $11080
             NTSC:HalfBrite Laced       $11084
             NTSC:HAM                   $11800
             NTSC:HAM Laced             $11804
             NTSC:High Res              $19000
             NTSC:High Res Laced        $19004
             NTSC:Low Res               $11000
             NTSC:Low Res Laced         $11004
             PAL:HalfBrite              $21080
             PAL:HalfBrite Laced        $21084
             PAL:HAM                    $21800
             PAL:HAM Laced              $21804
             PAL:High Res               $29000
             PAL:High Res Laced         $29004
             PAL:Low Res                $21000
             PAL:Low Res Laced          $21004

             These numbers should be entered with the "$" as they are
             hexidecimal.  Default as Workbench.

AUTOSCROLL - allow the mouse to push large screens around the visible
or AS        display area

REQUESTER  - brings up an ASL screen mode requester to specify width,
or REQ       height, depth, mode and autoscroll.  This option requires
             asl.library version 38 or better.

So typing "NewPubScreen MyScreen WIDTH 320 HEIGHT 256 DEPTH 4 MODE $21000"
will result in NewPubScreen opening a standard PAL low res 16 colour screen
with the name "MyScreen".  You could now open a Shell on this screen by
typing "NewShell CON://///SCREENMyScreen".

Please send me any comments or suggestions you have to improve NewPubScreen.

One more thing...

THE SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
YOU ARE ADVISED TO TEST THE SOFTWARE THOROUGHLY BEFORE RELYING ON IT.  YOU
AGREE TO ACCEPT THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
SOFTWARE AND DOCUMENTATION.  IN NO EVENT WILL SIMON CLAYTON BE LIABLE FOR
DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY
DEFECT IN THE PROGRAM.

Hope you like it,

Simon