@DATABASE StormScreenManager.guide
@$VER StormScreenManager 1.1 (14.08.00)
@(C) Copyright 1998-2000 by HAAGE & PARTNER Computer GmbH

@SMARTWRAP
@TAB 3

@MACRO HEADER "@{b}@{FG Shine}"
@MACRO UHEADER "@{FG Text}@{UB}@{PAR}"
@MACRO SUBHDR "@{u}"
@MACRO USUBHDR "@{uu}@{PAR}"

@MACRO MARK "@{u}"
@MACRO UMARK "@{uu}"
@MACRO LETTER "@{b}@{FG Shine}"
@MACRO ULETTER "@{FG Text}@{ub}"

@NODE Main "StormScreenManager"

@{HEADER}StormScreenManager - A Public Screen Manager@{UHEADER}

      © 1998-2000 by HAAGE & PARTNER Computer GmbH@{PAR}

@{" Overview     " LINK "Overview"} What is StormScreenManager?@{PAR}
@{" Installation " LINK "Installation"} How to install?@{PAR}
@{" GUI          " LINK "GUI"} What are that nice gadgets for?@{PAR}
@{" Menu         " LINK "Menu"} Only 4 little menu items@{PAR}
@{" Commodity    " LINK "Commodity"} How to control StormScreenManager?@{PAR}
@{" REXX         " LINK "REXX"} What commands does it understand?@{PAR}

@ENDNODE

@NODE Overview "Overview"

StormScreenManager is a public screen manager. You can open new public
screens and control many screen parameters. It has a graphical user
interface, is a commodity and knows some REXX commands.

StormScreenManager is used by StormC and AmigaWriter to open a screen for their
GUI.

@ENDNODE

@NODE Installation "Installation"

Copy the executable "StormScreenManager" and its icon to SYS:WBStartup.
Please check if the Tooltype "DONOTWAIT" is set.

Copy any catalog files into LOCALE:

You can run StormScreenManager with a double-click on the icon. After the
next reboot StormScreenManager will be started automatically.

@ENDNODE

@NODE GUI "Graphical User Interface"

If you press the hotkey (Ctrl-Alt-P by default) the StormScreenManagers main
window is opened. This contains a list of all screens and some buttons. Most
buttons are disabled if the screen is not defined by StormScreenManager
(like "Workbench")


Select a screen from the list to operate on this screen. If the screen is
currently open most buttons are disabled.


If you double-click a screen in the list this screen becomes the default
public screen. Every application that does not set a public screen for its
windows will open its screen on the default public screen.


Enter a (new) name for your selected screen into the string input field.


Press "@{u}N@{uu}ew" to define a new screen.


Press "@{u}D@{uu}elete" to remove the selected screen from the list.


Press "@{u}M@{uu}ode" to select a display mode for the selected screen. The
ASL screen-mode requester is opened. Select a display mode and press "OK"
to use it.


Press "@{u}F@{uu}ont" to select a font for the selected screen. The ASL
font requester is opened. Select a font and press "OK" to use it.


Press "@{u}O@{uu}pen to open the selected screen. The button is a toggle button
so it stays in its selected mode until you press it again. This will close
your screen.


Select the checkmark "Open @{u}B@{uu}ehind" to make the screen opening behind
all other screens. This is usefull if you open a screen at startup and
Workbench should still be the front screen.


Press @{"Properties..." LINK "Properties"} to open a second window that contains some more
settings for your screen.


Press "Shanghai" to open all new windows that would open their windows on
"Workbench" on the current default public screen.


Press "Auto Popup" to popup a screen if the first window is opened on it.

@ENDNODE

@NODE Properties "Properties Window"

The properties window contains some more information and settings about your
selected screen.


Colors: The number of colors which can be displayed on the screen.


Width/Height: The screen dimensions in pixel.


@{u}F@{uu}ont: Select a font-mode to be used. "Custom" means your selected font (from
the main window) will be used, "System" means your default system font will
be used and "Workbench" means your workbench font will be used.


@{u}T@{uu}itle: Define a title for the screen which will be displayed in the screen
title bar. If no title is entered the name of the screen is displayed.


Select "Like @{u}W@{uu}orkbench" if your screen shall use the same display mode,
dimensions, color depth and font like the screen "Workbench".


Select "@{u}C@{uu}lose Gadget" to give your screen a little close gadget in
the upper left edge. This allows to close the screen if no window is
open on it. But "Auto Popup" and automatically closing the screen after
the last window has been gone (which will be used if the screen is opened
by an AREXX command) will not work longer.


Select "@{u}Q@{uu}uiet" if no title bar shall be displayed.


Select "@{u}D@{uu}raggable" if the screen is dragabble.


Select "@{u}E@{uu}xclusive" if this screen must always be the only visible
screen. If you drag this screen you will not see any other screen behind it.


@ENDNODE

@NODE Menu "Pulldown Menu"

There is only one menu "Project":


Save (Shortcut Amiga-S): Save your screen definitions and many settings to
the WB Icon of StormScreenManager. All window positions will be saved.


Attention: If a screen is currently open (while saving) it will be
automatically opened after the next start of StormScreenManager.


About...: HAAGE&Partner did it, you know?


Hide: Close StormScreenManagers windows. Use the commodities exchange program
or the commodities popup key to open the windows again.


Quit: Quits StormScreenManager if possible. StormScreenManagers has to wait
until all screens it has opened can be closed. If a application has still a
window open on a screen this screen cannot be closed. But StormScreenManager
will quit as soon as all screens are closed.

@ENDNODE

@NODE Commodity "Commodity Interface"

StormScreenManager is a Commodity. It can be controlled by the Commodity
Exchange Program:


"Disable"/"Enable" is not very useful, it only disables the hotkey to popup
the GUI.


"Remove" quits StormScreenManager as soon as possible: every screen that is
opened by StormScreenManager must be closed. This is done automatically. If
a screen cannot be closed StormScreenManager quits as soon as the last
window on the screen is closed.


The default popup key is control-alt-p. You can change the tooltype
"CX_POPKEY" to any valid hotkey expression.


By default StormScreenManager does not open its GUI at startup. Set the
tooltype CX_POPUP to ON if you want StormScreenManager to open its
GUI automatically.

@ENDNODE

@NODE REXX "REXX Interface"

The REXX commands allow limited control of StormScreenManager. You can control
existing screens but not define new ones.


@{b}OPEN@{ub} <screenname> - Open screen <screenname>. It will be closed as soon
as the last window is closed.


@{b}CLOSE@{ub} <screenname> - Close screen <screenname>.


@{b}SCREENTOFRONT@{ub} <screenname> - Bring screen <screenname> to front.


@{b}SCREENTOBACK@{ub} <screenname> - Put screen <screenname> to back.


@{b}SETDEFSCREEN@{ub} <screenname> - Try to make screen <screenname> the default
screen.


@{b}SHANGHAI@{ub} ON/OFF - Set or clear the global shanghai flag.


@{b}AUTOPOPUP@{ub} ON/OFF - Set or clear the global auto popup flag.


@{b}HIDE@{ub} - Hide the GUI.


@{b}SHOW@{ub} - Show the GUI.


@{b}QUIT@{ub} - Quit StormScreenManager.


@{b}GETLIST@{ub} - Get a list of all screens displayed in StormScreenManager
(this list contains also the public screens like Workbench or opend by other
applications/public screen managers). This can be used to be displayed in
an application to allow the user to select a screen by name. Every screenname
in this list is enclosed in quotes (").


@ENDNODE