home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga GigaPD 3
/
Amiga_GigaPD_v3_3of3.iso
/
fred_fish
/
fish_951-1000_unpacked
/
983
/
yass
/
yass.doc
< prev
next >
Wrap
Text File
|
1993-06-25
|
12KB
|
324 lines
Yass V2.0 - Manual
~~~~~~~~~~~~~~~~~~
NAME
Yass - Yet Another Screen Selector
DESCRIPTION
Yass is a (new) Screen & Window-Selector Commodity for Amigas with
OS2.0 or higher. Here's a rundown of Yass' features:
o Completely controllable via keyboard.
(of course you can use your mouse, if you really want to).
o Shows Screens and Windows (option).
o Shows PublicScreenname or ScreenTitle (option).
o Ability to change the default PublicScreen.
o Opens window even on non-public screens (option).
o Font-sensitive.
o Resizeable window.
o Saves settings (position, size, ...) in ToolTypes
o Nice GUI with some OS3.x features
o Locale-support (OS2.1 + OS3.x)
COPYRIGHT
Yass is freely distributable.
Yass is free to be spread on public-domain and shareware disks
especially on Fred Fish's AmigaLibDisks, as long as they are sold
for a reasonable charge that is less than US $6 or DM 8.- .
For use in commercial products the permission of the authors is required.
Yass may be copied and distributed via electronic networks such
as the Internet, also it may be held available on anonymous ftp-servers,
mail-boxes or BBS's.
The Copyright is still by the Author.
AUTHOR
Albert Schweizer
Kelterstr. 9
71032 B÷blingen
Germany
Internet: schweizr@rz.fht-esslingen.de
PS. IF YOU LIKE THIS PROGRAM A LOT, SEND ME A POSTCARD !!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
REQUIREMENTS
o Any Amiga with Kickstart 2.04 (V37) or higher
STARTING
Yass is a COMMODITY, therefore it _only_ runs under WB Release
2.0 (V37.175) and newer. A Commodity is normally started in the
"SYS:WBStartup" drawer. So it will be automatically started on the
workbench startup (LoadWB, usually in "S:Startup-Sequence").
So, just copy "Yass" and "Yass.info" to "SYS:WBStartup", or
click and move the icon to the drawer.
To get Yass started without rebooting now, double-click the icon.
If the Tool Types weren't changed yet, a window shows up. Double-click
once more, if the window doesn't show up.
You can start Yass from the CLI or another Shell.
(If started from CLI/shell, the 'Save Settings' feature is not available)
For example you can start Yass in the S:User-Startup:
Run >NIL: <NIL: Yass CX_POPUP=NO
OPTIONS - TOOL TYPES
Yass knows some ToolTypes which can either be located within the
.info file or may be issued on the command line. The syntax should
be of the form ToolType=Value.
Here are the ToolTypes the program recognizes.
DONOTWAIT
When started from WBStartup, let
WB know that it doesn't have to wait
for Yass.
CX_PRIORITY=<-128 - 129>
Priority in "commodities.library"'s queue
Default: 0
CX_POPUP=<YES | NO>
When Yass is started, the Screenlist-Window may show
up when set to 'YES' or any (!) other String than 'N*'.
Default: YES
CX_POPKEY=<HotKey>
The hotkey which opens Yass' Window.
You will get a DisplayBeep if the hotkey is not valid.
Default: Shift Escape
EXTPOPUP=<YES | NO>
Yass' Screenlist-Window will popup on every screen
(even on non-public screens !) when set to 'YES' or any
other string than 'N*'. See WARNINGS for more information.
Will be changed by 'Save Settings'
Default: YES
SHOWWINDOWS=<YES | NO>
The Screenlist will also contain windows when set
to 'YES' or any other string than 'N*'.
Will be changed by 'Save Settings'
Default: NO
SCREENNAME=<Title | PubName>
Show Screen-Title or PublicScreen-name (if available)
Will be changed by 'Save Settings'
Default: PubName
LEFT=<startup X-position>
Yass' Screenlist-Window x-position at startup.
Will be changed by 'Save Settings'
Default: 100
TOP=<starup Y-position>
Yass' Screenlist-Window y-position at startup.
Will be changed by 'Save Settings'
Default: 100
WIDTH=<starup width>
Yass' Screenlist-Window width at startup.
Will be changed by 'Save Settings'
Default: 260
HEIGHT=<starup height>
Yass' Screenlist-Window height at startup.
Will be changed by 'Save Settings'
Default: 243
PREFEREDWINDOW=<Pattern>
<Pattern> is a case-sensitive AmigaDOS-Pattern.
If you select a screen with a window on it, which
title matches <Pattern>, it will be activated.
Default: #?Shell#?
BACKPATTERN=<YES | NO>
Yass' window will contain a background-pattern when
set to 'YES' or any other string than 'N*'.
The active-window-titlebar-color will be used to
draw the background-pattern (use OS3.x-palette-prefs
to change).
Default: YES
RENDERTYPE=<+|- [ NONE | RIDGE | BUTTON | ICONDROPBOX ]>
Use '-' to draw BevelBoxes in recessed-mode.
RIDGE | BUTTON | ICONDROPBOX selects rendertype for
BevelBoxes ( OS3.x Only ).
Use +NONE or -NONE to turn BevelBox-drawing off.
OS2.x - BevelBoxes will always be drawn in BUTTON-look.
(I prefer RIDGE or BUTTON, ICONDROPBOX looks ugly ;-)
Default: +RIDGE
USAGE
When the CX_POPUP Tooltype is set to 'YES' and Yass is being started
or when the hot key was pressed, the Screenlist-Window shows up.
SCREENLIST WINDOW (V39 style):
Keys after _ are short-cuts. With them you can access the gadgets
with the keyboard w/o moving the mouse.
+-+---------------------------+-+-+
|o| Yass <Shift Esc> |Q|H|
+-+---------------------------+-+-+
| |
| +-----------------------------+ |
| | Screen / Window List | |
| +---------------------------+-+ |
| |Workbench | | | Use mouse or [SHIFT]+
| | -Work 77 % voll, 43 M fre| | | CURSOR-UP/DOWN/LEFT/RIGHT
| | -AmigaShell | | | to select window/screen.
| |CygnusEdScreen1 | | |
| | +-+ |
| | |A| |
| | |V| |
| +---------------------------+-+ |
| |
| +-----------------------------+ |
| | Default _PublicScreen | | CycleGadget:
| +---+-------------------------+ | The value inside the
| | G | Workbench | | Cycle-Gadget is set to
| +---+-------------------------+ | the current default
| | Public screen.
| +-------+ +-------+ +-------+ |
| |_Select| |_Window+ |_Cancel| |
| +-------+ +-------+ +-------+ |
| |
+-------------------------------+-+
| |/|
+-------------------------------+-+
GADGET-KEYBOARD-CONTROL
o To select next/previous Screen/Window-List-Item use CURSOR-UP/DOWN.
o If ShowWindows-Option is enabled use CURSOR-LEFT/RIGHT to
select next/previous Screen.
o Press 'p' to change the default Public screen.
Use SHIFT to alter the entry in the other direction.
o Press 's' or <return> to activate selected screen/window.
o Press 'c' or <esc> to close the window w/o action.
o Press 'w' or <SPACE> to show up windows of selected screen.
MENU ITEMS:
Menu items can also be used via the keyboard, use the shown
Command Keys.
+---------+
| Project |
+-+-------+---------+
|Screenname ╗|
| +------------+
| | Title T| Show Screentitle
| |/ Public P| Show Public screen name
| +------------+
|/ Ext. Popup E| Enables extended popup-mode.
| Show Windows W| Include windows in Screenlist.
|Save Settings S| Save Settings in Icon-ToolTypes.
|-----------------|
|About ?| Shows up the version and Copyright.
|-----------------|
|Quit Q| Exit Yass.
+-----------------+
WARNINGS
If you use the EXTENDED POPUP-MODE, Yass will try to open its window
on every Screen (even on non-public screens). This could cause problems
if a program trys to close the screen while Yass' window is open.
It might be possible that situations emerge which confuze the OS and
lead to a software failure.
In other words don't experiment with it when you haven't saved that
file you are editing yet. Remember you use this at your own risk!
TESTING
This program was developed on an A4000/040 and was tested on the
following configurations:
o A1000, 120 MB IDE HD, Multivision FF, 512 KB Chip-RAM and
2 MB Fast-RAM. (OS2.1 + OS3.0+)
o A2000, '030 25MHz, 200 MB SCSI HD, oMniBus-Gfx-System, 1 MB Chip-RAM
and some MB 32Bit-Fast-RAM. (OS3.0+)
o A3000 25MHz, 1 GB SCSI HD, oMniBus-Gfx-System, 2 MB Chip-RAM and
some MB Fast-RAM. (OS3.0+)
o A4000/040, 2 x 170MB IDE HDs, oMniBus-Gfx-System, 2 MB Chip-RAM
and 12 MB Fast-RAM. (OS3.0+)
On all these configuration the program seems to work fine, so I guess
you can run it on almost any machine (with a bit of spare memory).
TODO
o Hotkeys for screens
o MUI-Version ?!
o Smartpointer-Option for window-selection
If you have any suggestions, let me know!
BUGS
Tell me about any you find!
RELEASE NOTES
V0.x▀ - Internal releases, for betatesters only. DON'T USE.
V1.0 - First Public release
V1.1 - Fixed nasty resize-Bug
- Some internal changes
V1.2 - PREFEREDWINDOW-Option/ToolType added
V1.3 - New GUI
- Many internal changes
- Fixed Enforcer-hit in PREFEREDWINDOW-Option
V1.4 - Background-pattern added (was) *** OS3.x only ***
V1.5 - Improved backbround-pattern colorscheme (was) *** OS3.x only ***
- Added Save-Config feature.
V1.6 - BACKPATTERN-Option/ToolType added (was) *** OS3.x only ***
- RENDERTYPE-Option/ToolType added *** OS3.x only ***
V1.7 - Fixed Listview-Render-Bug when backpattern was active.
- Backgroundpattern / BACKPATTERN-Option now available for OS2.x
V2.0 - Fixed problems with public-screen-locking
- Fixed bug in POPKEY-ToolType-parsing (was introduced in V1.5)
- GUI completely rewritten
- Many internal changes
- New Feature: showing up windowlist for one screen
(use window-gadget or <SPACE>)
- Added +/- and NONE switch to RENDERTYPE-option
- Width and Height no longer font-sensitive
- Locale-support (english + german) *** OS2.1 + OS3.x only ***
- Inproved 'Save Settings' (now appends ToolTypes)