Yass V1.6 - Manual ~~~~~~~~~~~~~~~~~~ NAME Yass - Yet Another Screen Selector DESCRIPTION Yass is a (new) Screen-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 configuration (position, size, ...) in ToolTypes o Nice GUI with some OS3.x features 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-Config feature is not available) For example you can start Yass in the S:User-Startup: Run >NIL: Priority in "commodities.library"'s queue Default: 0 CX_POPUP= When Yass is started, the Screenlist-Window may show up when set to 'YES' or any (!) other String than 'N*'. Default: YES CX_POPKEY= The hot key opens the Screenlist-Window of Yass. Default: Shift Escape EXTPOPUP= 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-Config... Default: YES SHOWWINDOWS= The Screenlist will also contain windows when set to 'YES' or any other string than 'N*'. Will be changed by Save-Config... Default: NO SCREENNAME= Show Screen-Title or PublicScreen-name (if available) Will be changed by Save-Config... Default: PubName LEFT=<startup X-position> Yass' Screenlist-Window x-position at startup. Will be changed by Save-Config... Default: 100 TOP=<starup Y-position> Yass' Screenlist-Window y-position at startup. Will be changed by Save-Config... Default: 100 WIDTH=<starup width min. 180> Yass' Screenlist-Window width at startup. (width is font-sensitive !! The relation is 1:1 for topaz.8) Will be changed by Save-Config... Default: 270 HEIGHT=<starup height min. 120> Yass' Screenlist-Window height at startup. (height is font-sensitive !! The relation is 1:1 for topaz.8) Will be changed by Save-Config... Default: 133 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> *** OS3.x only *** 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 palette-prefs to change). Background-pattern for OS2.x is not supported. Default: YES RENDERTYPE=<RIDGE | BUTTON | ICONDROPBOX> *** OS3.x only *** Selects rendertype for BevelBoxes. 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 in "[]" 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 fr| | | CURSOR-UP/DOWN/LEFT/RIGHT | | -AmigaShell | | | to select window/screen. | |CygnusEdScreen1 | | | | | +-+ | | | |A| | | | |V| | | +--------------------------+-+ | | | | +----------------------------+ | | | Default [P]ublicScreen | | CycleGadget: | +---+------------------------+ | The value inside the | | G | Workbench | | Cycle-Gadget is set to | +---+------------------------+ | the current default | | Public screen. | +------------+ +------------+ | | | [S]elect | | [C]ancel | | | +------------+ +------------+ | | | +------------------------------+-+ | |/| +------------------------------+-+ 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. MENU ITEMS: Menu items can also be used via the keyboard, use the shown Command Keys. +---------+ | Project | +-+-------+---------+ |Screenname »| | +------------+ | | Title T| Show Screentitle | |/ PubName P| Show Public screen name | +------------+ |/ Ext. Popup E| Enables extended popup-mode. | Show Windows W| Include windows in Screenlist. |Save Config... S| Save Configuration as 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 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 *** OS3.x only *** V1.5 - Improved backbround-pattern colorscheme *** OS3.x only *** - Added Save-Config feature. V1.6 - BACKPATTERN-Option/ToolType added *** OS3.x only *** - RENDERTYPE-Option/ToolType added *** OS3.x only ***