home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Format 63
/
af063sub.adf
/
WinDaemon
/
WindowDaemon.doc
< prev
next >
Wrap
Text File
|
1994-07-13
|
27KB
|
860 lines
----------------------------------------------------------------------------------
MAIN
----------------------------------------------------------------------------------
WindowDaemon 1.9 Copyright (C)1992,93,94 David Swasbrook.
================
If you are upgrading from version 1.8 or earlier then you may wish to know
that the configuration is now stored in the ENV: and ENVARC: directories
and no longer as tool types.
'Disclaimer ' Legal information
'Shareware ' Shareware information
'Requirements ' Whats needed
'Introduction ' Introduction to WindowDaemon
'How to Install ' How to install WindowDaemon
'Update Information' How to get the latest WindowDaemon version
'Special Thanks ' Thankyou for your ideas/support
'History ' A very brief history of WindowDaemon
'Index ' A brief index
----------------------------------------------------------------------------------
Disclaimer
----------------------------------------------------------------------------------
Disclaimer
**********
I hereby reject any liability or responsibility for these or any
other consequences from the use of WindowDaemon whatsoever. This
includes, but is not limited to, damage to your equipment, to your
data, personal injuries, financial loss or any other kinds of side
effects.
Although WindowDaemon has been tested thoroughly on several different
machines, I cannot rule out the possibility that WindowDaemon
o is somehow incompatible to your equipment
o has bugs that show up on your equipment
o does not do what it is supposed to do on your equipment
It is your responsiblity to take any precautions necessary to
protect yourself from these or any other effects. I explicitly
reject any liability or responsibility from the consequences of you
using WindowDaemon.
Swaz.
----------------------------------------------------------------------------------
Conditions
----------------------------------------------------------------------------------
Shareware
*********
WindowDaemon is shareware. The program may be freely distributed and
copied, as long as the following conditions are fulfilled:
o The sales price must not be higher than the cost of an (empty)
disk plus a nominal copying fee plus costs for shipping. The total
price must not be higher than 5 US$.
o All parts of the program and the documentation must be complete.
The distribution of single parts or incomplete subsets of the
original distribution is NOT ALLOWED.
o WindowDaemon or parts of it may not be sold in combination with or
as part of commercial software.
o Program and documentation may not be changed in any way.
o Permission has been given for distribution through Aminet and
Fred Fish.
WindowDaemon is shareware, this means I request those users, who
use WindowDaemon, to send me the shareware fee of 10 US$ (20 $NZ) (or
any other contributions gratefully accepted) to the following address:
Postal: David Swasbrook,
43 Pickwick Parade,
Howick,
Auckland,
New Zealand.
Internet: swaz@iconz.co.nz (private)
or msd@iconz.co.nz
Please include the following information in your registration:
o your name, address (electronic mail addresses preferred)
o your Amiga model(s)
o Kickstart and Workbench versions
o the WindowDaemon version number
I assure you that the information you send me will be treated
confidentially.
I will try and inform everybody, who has registered with me as
described above, when a new version of WindowDaemon becomes available.
If you have sent a sharware donation, if possible, you will recieve
an update through mail (preferably email).
Thank you very much in advance !
----------------------------------------------------------------------------------
Requirements
----------------------------------------------------------------------------------
Requirements
************
The following are required for WindowDaemon to run:
o Kickstart V37 or higher.
o 'matrix.library' version 23.1916 or higher
o For additional features for WindowDaemon you should be using
kickstart V39 or higher.
----------------------------------------------------------------------------------
MxLib
----------------------------------------------------------------------------------
MatrixLibrary
*************
Copyright © David Swasbrook, All Rights Reserved.
o Yet another library to put in your LIBS: drawer.
o Matrix.library is a development tool which will be used in
fourthcoming releases of programs I have written.
o The name "matrix" came from "The Matrix" - The computer system used
by the TimeLords (Re: Dr Who).
----------------------------------------------------------------------------------
Introduction
----------------------------------------------------------------------------------
Introduction
************
WindowDaemon gives you more control over intuition windows and screens.
'Arexx ' Control via arexx
'Commodities ' Standard commodities interface
'Configuring ' How to configure
'List of Hotkeys ' Assign keys to perform actions
'Locale ' Interface available in different languages
'Screen/Window Requestor' Goto a screen or window easily
'Sounds ' Sound effects
'Workbench Enhancements ' Workbench improvements
----------------------------------------------------------------------------------
ScrWinReq
----------------------------------------------------------------------------------
Screen/Window Requestor
***********************
This provides a way to find a screen or window by simply
pressing the right mouse button in the top right hand corner
of a screen. The requestor will list all named screens and
windows (or just screens only). Double clicking on a screen
or window will bring the screen and window to the front of
the display... saving you the trouble of looking for it.
----------------------------------------------------------------------------------
Comodity
----------------------------------------------------------------------------------
Commodities Support
*******************
WindowDaemon is a commodity and supports standard commodities features.
The following arguments may be specified as either ToolTypes or
entered in on the command line. If possible WindowDaemon will load
the tooltypes from the icon (if available) and any cli arguments
will overide the tooltypes specified.
CX_POPKEY - The hot key to display the WindowDaemon interface.
Default = "CONTROL ALT w" 'See HotKey'
CX_POPUP - Show the WindowDaemon interface. Default = FALSE.
CX_PRIORITY - Set the priority of the WindowDaemon broker.
----------------------------------------------------------------------------------
Installation
----------------------------------------------------------------------------------
Installation
************
Double click on the "install" icon.
----------------------------------------------------------------------------------
WBENCHANCE
----------------------------------------------------------------------------------
Workbench Enhancements
**********************
o Selecting the CLOSEWINDOW gadget and holding down the CONTROL
key will open the drawers parent window.
o Double clicking on a drawer while holding down the CONTROL key
will close the current window (unless it is the main workbench
window).
NOTE: This is only available under V39 or higher kickstarts.
o Selecting the CLOSEWINDOW gadget and holding down the ALT key
will close all workbench drawer windows.
o The HELP key may be used to obtain information on the currently
selected icons.
o The DEL key may be used to delete the currently selected icons.
----------------------------------------------------------------------------------
AboutWindow
----------------------------------------------------------------------------------
The About Window
****************
This window may be displayed by either running WindowDaemon while
it is currently installed, through the POPKEY, or through the
Commodities Exchange.
----------------------------------------------------------------------------------
Settings
----------------------------------------------------------------------------------
WindowDaemon Settings Editor
*****************************
The editor for WindowDaemon settings may be activated through the
WindowDaemon interface by selecting the "Settings" button from the
'about window'.
ALT patch - if checked then patches will be installed for
the ALT-CloseWindow to perform the action of
closing all workbench windows.
WBWindow patch - if checked then a patch is installed such that
when you double click on a drawer on workbench
the currently active window will be closed if
you are holding down the CONTROL key. And also
when closing a drawer the parent drawer can
be opened automatically.
Reverse Close - if set then when a window is closed its parent
window will be opened. Also when a drawer is opend
its parent window will be closed. It is necessary
to set the WBWindow patch for these features.
Screen Select - if set then pressing the right mouse button in the
top right hand corner of the screen will display
a 'requestor to select a screen or window'.
Both Buttons - if checked this will enable the window to front
or back action to be performed when both mouse
buttons are down.
MSDSounds - if checked this will send an Arexx command to the
Arexx Port named "PLAY". See 'Sound Useage'.
Arexx Port - Sets the name of the arexx port.
Listview - This is a 'list of all the hotkeys', double click
on an entry in this list and you get a brief
description on what that hotkey action does and
you are able to define the 'hotkey'.
Help - If checked, then pressing the HELP key will display
the information about the selected icons.
(This is the same as selecting the "Information"
menu item from the icons menu).
Del - If checked, then pressing the DEL key will delete
the selected icons.
(This is the same as selecting the "Delete" menu
item from the icons menu).
Font - Sets the font to be used for the windows.
WBWindow Qual - This is the qualifier for use with the WBWindow Patch.
---------------------------------------------------------------------
Save - Save the current settings to the icon.
Use - Use the current settings
Cancel - Do nothing, thouch nothing, get Kryten!
----------------------------------------------------------------------------------
HotkeyList
----------------------------------------------------------------------------------
List of HotKeys
***************
The following are a list of possible actions that you may assign
a 'hotkey' to:
Action Breif Description
------ -----------------
BACK Push window to the back
CLOSE Ask window to close
CLOSEPARENT Ask parent window to close
CLOSEWBWINDOWS Close all workbench drawer windows that are open.
DECREASEPRI Decrease the priority of current task
FORCECLOSE Close the window. This WILL close the window
no matter what. This is a dangerous action
to perform if the window is still in use.
You should only use this if the task owning
the window has crashed etc.
FRONT Bring window to the front
FRONTBACK Push window to front, or to the back if it
is already at the front
INCREASEPRI Increase the priority of current task
MAKEBIG Size window to maximum size
MAKEPUBSCREEN Make the active screen the default public screen.
It must however be a public screen.
MAKESMALL Size window to minimum size
NEXTSCREEN Bring next screen to front
NEXTWINDOW Activate the next window
PUBSCREEN Bring default public screen to the front.
PREVWINDOW Activate the previous window
REMTASKOWNER Remove the task that owns the window from
the system
SCREENCLOSE Close the screen. This is a very dangerous
action. See FORCECLOSE for more details.
SCREENTOP Move screen to top of display
TOGGLEREVERSECLOSE Toggle reverse close state.
WSCREENFRONT Bring windows screen to front
WBTOFRONT Bring the Workbench screen to the front
ZIP Zip/unzip window
----------------------------------------------------------------------------------
Arexx
----------------------------------------------------------------------------------
Useage of WindowDaemon with Arexx
**********************************
WindowDaemon has an arexx port named "WINDOWDAEMON" and it will
accept the following commands:
General Commands
****************
HIDE - hide the interface window
QUIT - ask the WindowDaemon to quit
SHOW - display the interface window
Window Commands
***************
BACK - push active window to the back
CLOSE - send a close message to the active window
CLOSEPARENT - close the parent window of the active window
CLOSEWBWINDOWS - closes all the drawer windows open on the
workbench screen.
FORCECLOSE - this will force the active window to be closed
without informing any tasks using the window.
This is only of use if an application crashes
and leaves windows open.
(NOTE: If you close windows that are still in
use you may find that you will crash)
FRONT - bring active window to the front
FRONTBACK - push active window to the front or back
INCREASEPRI - increase priority of task owning current window
DECREASEPRI - decrease priority of task owning current window
MAKEBIG - size active window to maximum dimensions
MAKESMALL - size active window to minimum dimensions
NEXTWINDOW - activate the next window
PREVWINDOW - activate the previous window
ZIP - zip/unzip the active window.
Screen Commands
***************
CLOSESCREEN - this will close the active screen without
informing any tasks using the screen. If
necessary any windows on the screen are also
closed without informing the tasks that own
them. This is only of use if an application
crashes and leaves screens open.
(NOTE: If you close screens that are still in
use you may find that you will crash)
MAKEPUBSCREEN - make the active screen the default public screen,
it must however be a public screen.
NEXTSCREEN - pop the next screen to the front of the display
and activate its last window.
PUBSCREENTOFRONT - bring the default public screen to the front
SCREENTOP - pop the active screen to the top of the display
at (0,0)
WINDOWSCREENFRONT - bring the screen with the active window to the
front.
WORKBENCHTOFRONT - bring the Workbench screen to the front.
Miscellaneous Commands
**********************
REMTASKOWNER - this will *REMOVE* the task that owns the active
window.
TOGGLEREVERSECLOSE - this toggles the current state of the reverse
close feature for CONTROL CLOSEWINDOW.
The above commands may be executed from CLI via Arexx by typing
rx ' address <PORTNAME> <COMMAND>
Examples:
*********
1) To quit the WindowDaemon
rx ' address WINDOWDAEMON QUIT
2) To close the active window
rx ' address WINDOWDAEMON CLOSE
3) To zip/unzip the active window
rx ' address WINDOWDAEMON ZIP
----------------------------------------------------------------------------------
MSDSounds
----------------------------------------------------------------------------------
MSD/UPD Sounds
**************
WindowDaemon will play sounds through a Sound Daemon such as MSD or
UPD. These add an Arexx port to the system called "PLAY" and the
following sound id's are sent to the port:
WindowDaemon/CloseScreen - when a screen is closed
WindowDaemon/CloseWindow - when a window is sent a CLOSEWINDOW
WindowDaemon/CloseWindowTrue - when you FORCE a window to be closed
WindowDaemon/DecreaseTaskPriority - task priority decreased
WindowDaemon/DefaultPubScreen - when the default pub screen is brought
WindowDaemon/IncreaseTaskPriority - task priority increased
WindowDaemon/NextWindow - activation of next window
WindowDaemon/NextScreen - activation of next screen and window
WindowDaemon/RemTaskOwner - removal of task owning window
WindowDaemon/ScreenToTop - screen has been moved to (0,0)
WindowDaemon/WindowBig - window is made big
WindowDaemon/WindowScreenToFront - the active windows screen has been
brought to the front
WindowDaemon/WindowSmall - window is made small
WindowDaemon/WindowToBack - window pushed to back of display
WindowDaemon/WindowToFront - window brought to front of display
WindowDaemon/WorkbenchToFront - Workbench brought to the front
WindowDaemon/ZipWindow - zip/unzip of active window
Acknowledgements
****************
UPD is Copyright © 1991 Jonas Petersson & Absolut Software (aka Sirius Soft)
MSD is Copyright © 1992,93 David Swasbrook. (Not released yet)
----------------------------------------------------------------------------------
Updates
----------------------------------------------------------------------------------
Update Information
******************
I will try and further improve WindowDaemon if I have time for it.
Registered users will at least get a notification when new versions of
WindowDaemon get available that contain significant changes or enhancements.
New versions of WindowDaemon will also be available on the Internet per
"anonymous FTP" (look on Aminet).
In order to be able to improve and/or correct WindowDaemon, I would like to
ask every user to do the following:
o send me the registration fee of US$ 10
o send me bug reports, if you find any bugs
o give me hints how to improve WindowDaemon
Thank you very much in advance !
----------------------------------------------------------------------------------
HotKey
----------------------------------------------------------------------------------
What is a HotKey?
*****************
HotKey description strings have the following template:
[CLASS] (([-]QUAL)|SYN)o [[-]UPSTROKE] [HIGHMAP|ANSICODE]
'CLASS ' 'QUAL ' 'SYN '
'UPSTROKE' 'HIGHMAP ' 'ANSICODE'
(o means zero or more occurances of the of the expression in brackets)
Examples:
*********
"CONTROL \\"
This hot key is activated when the "\\" (backslash) key and the control
key are pressed at the same time.
"LALT SHIFT F10"
This hot key is activated when the LEFT ALT key, either SHIFT key
and F10 are pressed at the same time.
"LCOMMAND A"
- This is actually the equivalent of "LCOMMAND SHIFT a"
----------------------------------------------------------------------------------
HotKeyClass
----------------------------------------------------------------------------------
CLASS
*****
Is one of the following strings:
RAWKEY, RAWMOUSE, EVENT, POINTERPOS, TIMER, NEWPREFS,
DISKREMOVED, DISKINSERTED
If not specified, the class is taken to be RAWKEY.
----------------------------------------------------------------------------------
HotKeyQual
----------------------------------------------------------------------------------
QUAL
****
Is one (or more) of the following strings:
LSHIFT, RSHIFT, CAPSLOCK, CONTROL, LALT, RALT, LCOMMAND,
RCOMMAND, NUMERICPAD, REPEAT, MIDBUTTON, RBUTTON, LEFTBUTTON,
RELATIVEMOUSE
A preceding '-' means that the value of the corresponding
qualifier is to be considered irrelevant.
----------------------------------------------------------------------------------
HotKeySyn
----------------------------------------------------------------------------------
SYN
*** Syn (synonym) is one (or more) of the following strings:
SHIFT, CAPS, ALT
SHIFT - left or right shift
CAPS - shift or capslock
ALT - either alt key
----------------------------------------------------------------------------------
HotKeyUpstroke
----------------------------------------------------------------------------------
UPSTROKE
********
If this token is absent, only DOWNSTROKES are considered
for RAWMOUSE (MOUSEBUTTONS) and RAWKEY events. If it is
present alone, only UPSTROKES count. If it preceded by
'-' it means that both up and down strokes are included.
----------------------------------------------------------------------------------
HotKeyHighMap
----------------------------------------------------------------------------------
HIGHMAP
*******
One of the following strings:
COMMA, SPACE, BACKSPACE, TAB, ENTER, RETURN, ESC, DEL, UP,
DOWN, RIGHT, LEFT, HELP, F1, F2, F3, F4, F5, F6, F7, F8, F9,
F10, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
----------------------------------------------------------------------------------
HotKeyAnsiCode
----------------------------------------------------------------------------------
ANSICODE
********
A single character token is interpreted as a character code,
which is looked up in the system default keymap.
----------------------------------------------------------------------------------
Locale
----------------------------------------------------------------------------------
Locale Support
**************
The WindowDaemon interface supports locale, the built in language is
english.
Included in the archive is the 'Catalog Translation file' just in
case you would like to translate it into your locale.
Catalog filename matrix/WindowDaemon.catalog
Submitting a catalog:
If you wish to send me a locale for WindowDaemon please could you send
the actual text translation file rather than the completed catalog
itself?
----------------------------------------------------------------------------------
Thanx
----------------------------------------------------------------------------------
Contributors
************
Thanks also to the following who reported bugs and suggestons:
Jeffrey Peden
Joachim Worringen
Seth Harman
Beta testing performed by:
Barry McConnel
Daryl Jay
o I'm sorry if you have contributed and you name is not in the
above lists. I try to reply to all email so if you have sent
me some mail and not received a reply then it is more than
likely that my mailer sent it to nil: accidentally.
----------------------------------------------------------------------------------
History
----------------------------------------------------------------------------------
History Information
*******************
`V1.9' o The configuration is no longer stored as tool
types. Config file is saved in ENV:
o The Workbench window open/close enchancement
key may be selected from Control, Shift or
MiddleMouseButton.
o Bugfix in DEL/HELP code
o Added screen/window selector
o Aminet/IRC release
`V1.8' o Added DEL and HELP key shortcuts to workbench.
o Removed short versions of hotkey tooltypes.
o Aminet release
`V1.7' o Removed unecessary code
o Fixed small problem with font settings
o ALT-CloseWindow is working again. V1.6 was crashing.
o Control-\ can now be disabled
`V1.6' o Aminet release
`V1.5' o Added task priority control of active window
o Beta release only.
`V1.4' o Fixed data-alignment problem
o Added locale support.
o Control-\ patch added to CONTROLKEYPATCHES to close
the active window. This was added so you can close any
window not just cli's with this key combination.
o Hopefully have fixed the `bug' that would occasionally
lock the system when you double clicked on an icon while
holding down control.
o Added option to reverse the CONTROL-CLOSEWINDOW and
CONTROL-DOUBLECLICK on drawer. To get normal window
actions you need to hold down control if this flag is
set. This is toggleable via a hotkey or arexx command.
New arguments REVERSECLOSE, RC=HOTKEY_TOGGLEREVERSECLOSE.
o Beta release only.
`V1.3' o Internal release only.
`V1.2' o Internal release only.
`V1.1' o Now has a user interface to configure all the hotkeys
o Added new argument/tooltypes: CONTROLKEYPATCHES,
MP=HOTKEY_MAKEPUBSCREEN, CW=HOTKEY_CLOSEWBWINDOWS
o New arexx commands: MAKEPUBSCREEN, CLOSEWBWINDOWS
o Can now open parent when you close a workbench drawer window
when holding down the CONTROL key
`V1.0' o Initial release on Aminet.
----------------------------------------------------------------------------------
Index
----------------------------------------------------------------------------------
'About Window ' Program information
'Arexx ' Send commands via arexx
'Commodities ' Standard commodities interface
'Conditions ' Shareware information
'Configuration ' Configuring WindowDaemon
'Disclaimer ' Legal information
'Introduction ' Introduction to WindowDaemon
'Installation ' How to install WindowDaemon
'History ' A very brief history of WindowDaemon
'HotKeys ' How to define a hotkey
'Locale ' Interface available in different languages
'List of Hotkeys ' Assign keys to perform actions
'Matrix Library ' Yet another library
'Requirements ' Whats needed
'Screen/Window Requestor' Goto a screen or window easily
'Shareware ' Shareware information
'Special Thanks ' Thanks
'Updates ' New versions
'Workbench Enhancements ' Workbench improvements
Other files:
'WindowDaemon Catalog ' Catalog Description file for WindowDaemon