@database AGASSM.guide @rem $Date: 15/1/96 15:51:25 $ $Revision: 2.4 $ @wordwrap @node MAIN @title "AGASSM Help" AGASSM v7.22 by Paul Vernon (15/1/96) AmigaGuide Help file. I. @{" About " link HELP_ABOUT} II. @{" Windows " link HELP_WINDOWS} III. @{" Buttons " link HELP_BUTTONS} IV. @{" Menus " link HELP_MENUS} V. @{" SlideShow List " link HELP_LIST} VI. @{" ARexx and Commodity Ports " link HELP_PORTS} VII. @{" System Requirements for operation " link HELP_SYS} VIII. @{" Acknowledgments & Contact Address" link HELP_ACKS} IX. @{" History " link HELP_HISTORY} X. @{" TroubleShooting " link HELP_TROUBLE} XI. @{" Disclaimer " link HELP_DISC} AGASSM v7.2x is Copyright (C) Paul Vernon 1996. *********************************************************************** *** IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT *** *** *** *** AGASSM and associated files are copyrighted by Paul Vernon. *** *** 5D Licenceware and its appointed distributors have exclusive *** *** distribution rights to the registered version. If you receive a *** *** 'registered' version from elsewhere then please contact 5D so *** *** that action can be taken. *** *** *** *********************************************************************** @endnode @node HELP_ABOUT @title "AGASSM Help: About" AGASSM is designed to be an AGA chipset slideshow creator. AGASSM and its player both require OS3.0 or above to operate. AGASSM is designed to be a quick system friendly SlideShow creation utility that takes advantage of OS 3.0 and above. The origins of AGASSM date back to early 1994 when I got my hands on a copy of Blitz Basic II. Thanks ACID for a great language! P.S. (Where's the support gone?) AGASSM has a few tricks up its sleeve, so that you can produce some rather striking slideshows while still having all the advantages of OS 3.0 such as ARexx. AGASSM is able to display IFF-pictures (not 24-bit), play IFF-animations (Anim5), music modules (MED (MMD0 format) and ST), IFF-samples, and execute ARexx commands and Scripts as standard. The useful aspect of AGASSM, is its @{" ARexx port " link HELP_PORTS}, which enables you to do things most Slideshow programs can't. That is utilise other peoples viewers and players to display or play file formats that AGASSM cannot normally cope with. For instance, AGASSM can cope with MED-Modules up to MMD0 but cannot play 8-track MED-Modules as standard. This however is not a problem as Teijo Kinnunens 'OctaMEDPlayer' has an ARexx port so, you can launch the player and load and play an 8 channel module all from AGASSM. AGASSM was written entirely by myself (Paul Vernon) as a personal utility for my own use but I was convinced by my friends at University to publish it as Licenceware as they thought it looked 'dead professional!' well professional it isn't but I hope is goes some way to making the creation of slideshows a little bit easier. I would appreciate it if when you copy the program for your friends, you leave out the registration file so that the save feature is disabled. If you don't, and a copy of your program gets back to me I shall withdraw my support to you by refusing to supply you with future versions! YOU HAVE BEEN WARNED! AGASSP is freely distributable. AGASSM is most definitely @{u}NOT!@{uu} @{" What's new in version 7.22 " link HELP_NEW} @endnode @node HELP_NEW @title "AGASSM Help: What's new?" Here's a quick rundown of the additions and changes to AGASSM since the last version of AGASSM (6.4). · Re-designed interface (altered/added windows) · Filetype recognition system · New fader routines · Better implementation of user defined macros · Now requires ARexx to operate · Ability to alter sample playback rate · Standardised file format for slideshows · Full random access list editing (Add, Up, Down, Remove) (v7.21) · Several Wipes now added. (v7.22) · Transparent support for @{" PowerPacked " link HELP_PACK} files · Several other major/minor bug fixes. For the first time ever AGASSM does not require the AGA chipset any more to operate and if you attempt to display a picture that requires the AGA chipset, you will be informed if your machine is incapable. AGASSP also incorporates this feature, and ignores AGA specific pictures on ECS machines! This also applies to AGA machines that do not have the SetPatch installed in their startup sequence. For these machines, the AGA screen modes are inaccessible until the SetPatch command is run. On first looking at AGASSM 7.2x there is an instant difference with v6.4. The interface has been redesigned. I've been wanting to do it for a while but it seemed like a lot of trouble for a marginally better system. Anyway with the summer holiday upon me (and no job) I had nothing better to do so I redesigned the user interface. Hopefully, you will be able to see the advantages it brings. @{" Windows " link HELP_WINDOWS} are smaller with the gadgets being more compact and following a much more logical layout with gadgets being grouped together according to their functions. Due to the interface changes, I had to change the file-format for the slideshows slightly, so AGASSM 7.2 can't load in AGASSM 6.4 slideshows. Hopefully, this file format will be the standard for a while and I have given it a name! Its called 'SSM0' and its identifier can be found in the first four bytes of the slideshow file. The format is smaller than previous versions of AGASSM and contains more information! The fade routine has been changed too. From 3 procedures and well over 60 lines of code to 2 procedures and about 8 lines of code. The speed increase is extremely noticeable on 256 colour pictures. The fade is also much much smoother. The sample playback routine has also been improved, with the user now able to define the frequency of playback through the Object Information window, although the maximum sample frequency of a sample can only be 32767 Hz. This however should be sufficient for most samples. As an extra, I've now incorporated a filetype recognition system that automatically identifies the type of object that you are attempting to load. Along with the filetypes AGASSM can load, I've also added some filetypes that it can't load so that AGASSM automatically rejects an object that it cannot handle. The file-recognition system also works via the ARexx menu, so you can use the @{" ADDOBJECT " link HELP_COMMANDS} command with a wildcard and the objects will only be loaded if AGASSM can handle them! It also automatically configures the object with its specific object settings! Be warned however, it sometimes gets things wrong! Due to the spurious/random data in a file. With reference to samples, the file-recognition system also looks inside sample files and finds the playback rate at which they were recorded. This is then used as the default, but can be changed by the user to play back at any rate. To cope with all these changes, AGASSP has been updated to version 2.1, with a new look interface, incorporating a message box and an Error message box in its window. AGASSP is also now able to cope with multiple selection in Workbench and will happily play 1 slideshow directly after another and another and another and... Also AGASSP incorporates the new fader routines and also supports the new file-format. (If it is really necessary, then I will code a conversion program to convert old slideshows (Tell me if you want one!)) @endnode @node HELP_WINDOWS @title "AGASSM Help: Windows" AGASSM is a modularised program with 4 separate windows with 4 distinct @{" functions " link HELP_BUTTONS}. The first window is the main slideshow creation window. The other 3 are support systems for this main window. The main two windows are the initial window that is presented on booting AGASSM and the Object Information window. This can be accessed through the menus or by double-clicking on an object in the slideshow list. Through the Object Information window, you are able to define several aspects of the object, telling AGASSM exactly what the object is and how it is to be dealt with. A few options in this window have been incorporated from the 'Extras' @{" menu " link HELP_MENUS} of version 6.4 of AGASSM and the 'Extras' menu has now been removed. The remaining windows are the Defaults window to configure AGASSM for a slideshow and the ARexx Command Window. Information in the Defaults window can be saved to a config file, but it is not necessary as the information is also saved within each slideshow file. The ARexx Execute window enables you to execute an ARexx command line. @endnode @node HELP_BUTTONS @title "AGASSM Help: Buttons" @{b}@{u}The Main Window@{ub}@{uu} The main window is where most of the slideshow creation is done. Objects can be loaded into and removed from the slideshow and general aspects of the slideshow can be edited. @{b}New Slideshow!@{ub} Clears the @{" SlideShow List " link HELP_LIST} ready to create a new slideshow and resets all @{" defaults " link HELP_DEFAULTS} to their last saved settings. @{b}Play SlideShow@{ub} Plays the currently loaded slideshow that is in the list. @{b}Load SlideShow@{ub} Brings up a requester to load a pre-made slideshow for editing. Slideshows are stored in an encrypted format and when viewed with any other system appear garbled. @{b}Save SlideShow@{ub} Brings up a requester to save a slideshow for use with the player utility and for re-editing in the future. @{b}Add@{ub} Enables you to load an @{" Object " link HELP_OBJECTS} into the current slideshow list after the currently selected object. @{b}Up@{ub} Allows you to move an object in the list up. @{b}Down@{ub} Allows you to move an object down the list. @{b}Remove@{ub} Removes the currently selected Object from the SlideShow list. @{b}Time :@{ub} You can use this gadget to determine how long AGASSM waits after displaying a picture before it displays/plays/executes the next Object in the list. @{b}Loop :@{ub} Determines how long the slideshow is repeated. Be careful as if you leave it at its default setting, the slideshow will repeat infinitely. If you play the SlideShow by mistake and it begins to repeat, then hold down both mouse buttons until AGASSM returns you to the WorkBench. @{b}Quit :@{ub} This gadget quits AGASSM. @{b}@{u}The Object Information Window@{ub}@{uu} The Object Information window is where you can edit several different aspects of the currently selected objects settings. @{b}Object Type Cycle Gadget@{ub} This Cycle Gadget defines what the selected @{" Object " link HELP_OBJECTS} actually is. @{b}Viewmode Cycle gadget@{ub} If the Object is a picture then it can be Normal, Extra Half Bright (Brite for all you silly people who spell it like that) or HAM. This cycle gadget selects the viewmode for each picture. @{b}Module Type Cycle Gadget@{ub} If the current Object is a music @{" Module " link HELP_OBJECTS} then it can be either a MED or an SoundTracker module. @{b}Stop Module@{ub} If a music module is playing then this gadget stops it playing. @{b}View/Play Object@{ub} Displays, plays or executes the currently selected Object which can be identified by the text gadget to the left of this gadget. @{b}Frames per (s) : (Frames per second)@{ub} Display the replay rate of the currently selected animation in the list. @{b}Loop :@{ub} This can be set to loop the currently selected animation for up to 100 times. @{b}Frequency@{ub} This displays the playback frequency of an IFF-8SVX sound sample. You are able to set the playback frequency via the slider control beneath the information box. @{b}Effects :@{ub} This gadget cycles through all the different options that can be performed on an object. @{i}BackGnd@{ui} Makes the currently selected picture into a background that is displayed in between the other pictures in a slideshow. @{i}Wait...@{ui} If a slideshow becomes too large to fit on one disk, then you can use this facility to carry on over several disks. For instance, you have an animation saying please insert disk 2. Select this object in the slideshow list, then select this option. After that, begin building the slideshow from your next disk and when you come to play the slideshow, the animation will repeat until the next disk is inserted! If however, you have a multi-drive system and the disk is already in a drive, the 'Please insert...' animation will not be displayed. @{i}Fade@{ui} This facility is only available of pictures of the Amiga's Normal Viewmode. That is pictures of 2 to 256 colours. When this option is selected, the picture fades in from and out to black. @{i}Loop Sample@{ui} This plays a looped IFF sample according to its internal settings. @{i}Slide@{ui} This slides a picture up the screen. @{i}HorizB@{ui} This draws the picture on the screen in a column by column fashion. @{i}VertB@{ui} This draws the picture on the screen in a row by row fashion. @{i}SpiralB@{ui} This draws the picture from the centre, spiralling outwards. @{i}RandomB@{ui} This draws the picture using randomly placed blocks. @{i}Blitter@{ui} This fires blocks onto the screen from the bottom left corner of the screen. @{b}WARNING :- @{ub} The blocks effects require standard sized screens or Video overscan screens. They cannot cope with wierd screen sizes. If you give AGASSM a wierd screen size, it may (or may not) crash! To skip a picture that is being drawn with one of the effects, hold down the right mouse button. @{b}Close@{ub} Closes the Object Information window. @{b}@{u}The ARexx Command Line Window@{ub}@{uu} With this window, you can directly execute or add a set of ARexx commands to a Slideshow. @{b}Execute@{ub} Executes the current @{" ARexx " link HELP_PORTS} string in the String gadget. The string must be enclosed in speech marks i.e. "" with filenames being enclosed in apostrophes i.e. '' @{b}Add to SlideShow@{ub} Rather than executing the Command line, you can add it directly to a Slideshow. @{b}Save as macro@{ub} Enables you to save the current argument in the requester as a macro for use within AGASSM. @{b}Cancel@{ub} Closes the window without any effect. A set of command's in the ARexx Execute Command Window must be surrounded by a pair of speech marks with filenames being surrounded by the apostrophe e.g. "LOADSHOW 'WORK:GFX/MYSHOW.SHOW';EXIT 'Slideshow loaded';" The semi-colon separates separate commands from each other, while the exit command must always be the last command in a command sequence. A message may be given by the EXIT argument but it is not necessary e.g. "LOADSHOW 'WORK:GFX/MYSHOW.SHOW';EXIT;" This does exactly the same as the previous command sequence with the exception that AGASSM does not display a message on completion of the command sequence. @{b}@{u}The Defaults Window@{ub}@{uu} This window enables you to set the default settings for each time you run AGASSM. @{b}Audio Filter@{ub} Changes the status of the Audio Filter @{b}System Requesters@{ub} Toggles the system requesters on and off (Useful for multi-disk slideshows) @{b}Sample Buffer@{ub} Sets the size of the IFF sample diskplay routine. Around 16k (16384 bytes) should be enough for most purposes. @{b}Hotkey@{ub} Allows the user to define AGASSM's commodity @{" HOTKEY " link HELP_PORTS} (default :- ctrl lalt a) @{b}Use@{ub} Implements the default settings. @{b}Save@{ub} Saves and implements the default settings. @{b}Cancel@{ub} Resets the defaults to their previous settings and closes the window with no effect. @endnode @node HELP_MENUS @title "AGASSM Help: Menus" Most of the power of AGASSM is linked to its @{" SlideShow list " link HELP_LIST} and the menu bar this gives a run down of the features of the menu bar. @{b}Project@{ub} @{i}Load SlideShow@{ui} @{b}@{i}A@{ui} L@{ub} Bring up the file requester so that a slideshow can be loaded. @{i}Save Slideshow@{ui} @{b}@{i}A@{ui} S@{ub} Save the current slideshow to a file. @{i}Play Slideshow@{ui} Plays the current slideshow. To end a slideshow prematurely, hold down both mousebuttons until AGASSM or AGASSP returns you to the WorkBench. @{i}New SlideShow@{ui} Clears the @{" SlideShow List " link HELP_LIST} ready to create a new slideshow and resets all @{" defaults " link HELP_DEFAULTS} to their last saved settings. @{i}Defaults...@{ui} @{b}@{i}A@{ui} D@{ub} Enables the setting of various @{" defaults " link HELP_DEFAULTS} for use with AGASSM @{i}About...@{ui} @{b}@{i}A@{ui} ?@{ub} The About requester! @{i}Hide@{ui} @{b}@{i}H@{ui} H@{ub} @{i}Quit@{ui} @{b}@{i}A@{ui} Q@{ub} Quits AGASSM! @{b}Objects@{ub} @{i}Load Object@{ui} @{b}@{i}A@{ui} O@{ub} Loads an Object into the SlideShow list. @{i}Object Type »@{ui} Defines what the @{" Object " link HELP_OBJECTS} actually is. This menu option has several sub-options, these are :- · Picture @{b}@{i}A@{ui} P@{ub} · Animation @{b}@{i}A@{ui} A@{ub} · Module @{b}@{i}A@{ui} M@{ub} · ARexx-Script @{b}@{i}A@{ui} R@{ub} · IFF-Sample @{b}@{i}A@{ui} F@{ub} @{i}View Object@{ui} @{b}@{i}A@{ui} V@{ub} Displays, plays or executes the currently selected object. @{i}Remove@{ui} Removes the last object in the Slideshow list. @{i}Stop Audio@{ui} If a music module is playing this gadget stops it. @{i}Information...@{ui} @{b}@{i}A@{ui} I@{ub} Opens the Object Information Window. @{b}ARexx@{ub} @{i}Execute ARexx Script...@{ui} Brings up a file requester so that you might choose an ARexx script to execute. @{i}Execute ARexx Command...@{ui} @{b}@{i}A@{ui} E@{ub} Brings up a text requester so that you can enter your own ARexx commands in a similar fashion the WorkBench's Execute Command function. Although, you can add the command directly into an AGASSM slideshow rather than execute it using the 'Add to Slideshow' Gadget in the requester. @{i}Re-Read ARexx Macros...@{ui} The @{" ARexx " link HELP_PORTS} menu has a special feature, in that it assumes that any file it finds with the '.agassm' extension on the end in the 'REXX:' directory is an ARexx script and adds it to the menu. This way, AGASSM allows up to 150 self defined @{" macros " link HELP_MACROS} using the ARexx language as its core. The Re-Read ARexx Macros option enables you to add/change/remove macros in the 'REXX:' directory and Re-Read the directory therefore updating the list of macros in the menus without Quiting and re-running AGASSM. The user defined macros can also have their own user defined shortcuts in exactly the same way as normal menu items. You must be careful to give these macros unique shortcuts or clashes will occur. The process of giving the macro a keyboard shortcut is quite simple requiring you to be able to rename a file! For example :- To give the file @{b}REXX:Add-Directory.agassm@{ub} a shortcut letter of 'C' the file must be renamed to @{b}'REXX:Add-Directory,C.agassm'@{ub} where the ',' separates the text appearing in the menu from the keyboard shortcut. @endnode @node HELP_MACROS @title "AGASSM Help: ARexx Macros" Adding macros to the ARexx @{" menu " link HELP_MENUS} could not be easier. All you have to do to add a macro to AGASSM's menu is add the '.agassm' suffix to the filename and copy the macro into the 'REXX:' directory. The 'REXX:' directory is usually assigned to the 'S:' directory. Up to 150 user defined macros can be added to AGASSM to make the creation of slideshows more simple. For instance one of the supplied macros will search through any directory that you specify and add any files that it recognises in that directory. This makes the creation of slideshows easy as once all your pictures/anims/music files are placed in their directories on your slideshow disk all you have to do is 'Add' each directory to the slideshow! Macros can be created using your favourite text editor and once they are in the 'REXX:' directory, they can be recognised by their '.agassm' suffix and loaded into the menu using @{" Re-Read ARexx Macros " link HELP_MENUS}. Simple! @endnode @node HELP_PACK @title "AGASSM Help: Power Packer compatiblity" AGASSM now supports crunched files using the PowerPacker.library. This will allow you to fit more onto one disk. All objects except ARexx scripts can be used in a crunched form. That is to say, you can use crunched IFF Pictures/Anims and Samples. You can also use crunched music modules of both MMD0 and ST format. There is a slight drawback to using Power Packed files however. AGASSM's file recognition system cannot look inside the file to identify what type of object it is, so you have to tell it. Once you have done that, AGASSM behaves as if the file were a normal un-crunched file. AGASSM requires large amounts of memory for the Power Packer feature to work well (4 Mb at least I should say). If you are running a standard A1200 like me, then you will be able to use Power Packer on the small pictures. Forget about using a 640 by 512, 256 colour picture with an effect because power packer uses internal memory buffers as well as the effect, and then there's the screen to open!! @endnode @node HELP_SYS @title "AGASSM Help: System Requirements" Operating System :- 2.1 or above Memory Requirements :- 2Mb (4Mb is better) Disk Drives required :- 1 Floppy Drive (2 drives are better) (Hard Drive is recommended) Software Libraries needed :- PowerPacker.library RexxSysLib.library Mathieeedoubbas.library Commodities.library * * AGASSM only AGASSM and AGASSP have been tested on the following machines :- A600 '000 7Mhz 2Mb (Does not work as yet HMMMM.... :-( ) A1200 '020 14Mhz 2Mb A1200 '020 14Mhz 2Mb + 4Mb A1200 '030 50Mhz 2Mb + 4Mb A1200 '030 50Mhz 2Mb + 4Mb + 12Mb (Virtual Memory using VMM) @endnode @node HELP_KEYSTROKES @title "AGASSM Help: Keystrokes" AGASSM has several keyboard short-cuts that are designed to speed up the use of the program, but as this program is entirely mouse driven, I find that they slow me down. The keyboard short-cuts are available through the @{" menu " link HELP_MENUS} section. Your own keyboard shortcuts can be added to AGASSM's ARexx menu for your user defined macros. The process to do so is located in the @{b}ARexx@{ub} section of the @{" menus " link HELP_MENUS} guide. @endnode @node HELP_LIST @title "AGASSM Help: SlideShow List" The Slideshow list is the heart of AGASSM's ease of use and power. It enables you to add objects of many @{" formats " link HELP_OBJECTS} to a slideshow so that is can be a full Multimedia experience. The List enables you to build the general structure of the slideshow, then using AGASSM's other features, you can develop the general structure and add little details to the slideshow that make it look that little bit better. The current objects name is displayed in the Text requester below the list and can be changed via this Text requester. @endnode @node HELP_DEFAULTS @title "AGASSM Help: Defaults" AGASSM has several default settings that can be changed from within the Defaults window. These default settings are :- The Audio Filter (On or Off) The System Requesters (On or Off) (Useful for multi-disk slideshows) The Sample disk buffer size for samples over 128k in length. The @{" Commodity " link HELP_PORTS} HotKey @endnode @node HELP_OBJECTS @title "AGASSM Help: Object types" AGASSM is not just a picture display utility. It can do other things too such as play music modules, samples and animations. It can even execute ARexx scripts from within a slideshow. For this reason, you need to define what each object is in the slideshow. An object can be of 5 different types. These are :- · IFF Picture · IFF Animation (Anim 5) · Music Module (MED or ST format) · IFF Samples · ARexx Scripts Through the use of ARexx scripts, this range of object types can be extended by the remote use of other programs capabilities. @{b}IFF-Picture@{ub} @{b}@{i}A@{ui} P@{ub} This can be any standard IFF-Picture that can be created from within for instance DeLuxe Paint IV AGA ®. @{b}IFF-Animations@{ub} @{b}@{i}A@{ui} A@{ub} These must be of the Anim 5 format and can be in any viewmode (Normal/Half Bright/HAM) @{b}Music Modules@{ub} @{b}@{i}A@{ui} M@{ub} The MED module must be of the MMD0 format as AGASSM does not directly support MED modules of higher versions. The ST module player plays most any ST-module, but I have experienced trouble with @{u}very@{uu} old ST-modules. @{b}IFF samples@{ub} @{b}@{i}A@{ui} [@{ub} Samples must be mono, but can be of any length. If they are over 128K however, AGASSM plays them directly from disk and looping is quirky with these long samples. @{b}ARexx Scripts@{ub} @{b}@{i}A@{ui} R@{ub} @{" ARexx " link HELP_PORTS} scripts can be included to either trigger outside programs or affect the way in which AGASSM itself is running. @endnode @node HELP_PORTS @title "AGASSM Help: ARexx and Commodity Ports" AGASSM is equipped with both an ARexx and a Commodity port. Indeed AGASSM will refuse to run if ARexx has not been initiated on your system. To initiate ARexx, all you have to do is run the RexxMast® program in the System drawer of your System Disk (WorkBench). @{b}ARexx Port@{ub} The ARexx port has along with it several Built-in @{" commands " link HELP_COMMANDS} that can be used to control AGASSM from remote applications. AGASSM can also control remote applications using their in-built commands. For instance, AGASSM has no in-built support for playing OctaMED® songs or modules, but can still be used to play them via an ARexx script controlling the OctaMED player. As well as ARexx @{" Scripts " link HELP_SCRIPTS}, AGASSM also provides support for the direct executing of ARexx commands via the ARexx menu. @{b}Commodity Port@{ub} The Commodity port is a simple affair, letting you open and close the main AGASSM display while keeping AGASSM running in the background. This really is just an advanced sleep facility. You can also quit AGASSM using the CX utility. @endnode @node HELP_SCRIPTS @title "AGASSM Help: ARexx Scripts" ARexx scripts can be either executed from the @{" menu " link HELP_MACROS} or from within an AGASSM slideshow. They can be used to either control AGASSM or some external program that also supports ARexx. Here are a few example scripts for use within AGASSM. @{b}OctaMED player ® routine@{ub} /* OctaMED Player DEMO */ ADDRESS COMMAND 'C:Run Work:Music/OctaMED/Utilities/OctaMEDPlayer' ADDRESS COMMAND 'Wait 2' ADDRESS 'OCTAMEDPLAYER' LoadMod 'Work:Music/OctaMED/Mods/FairLigt.mod' Play Exit 'OctaMed has started playing' /* This message is displayed in AGASSM */ @{b}clariSSA ® demo script@{ub} /* AGASSM ARexx Script to play a demo anim from clariSSA*/ exists = Show('P','CLARISSA') If exists = 0 then do EXIT 'Unable to find clariSSA' End Options RESULTS Address clariSSA Requeststatus OFF LoadAnim MASTER Name 'ClariSSA:SSA-Anim/SSADemoAnim' PlayAnim 1 Screens CloseAnim MASTER EXIT @endnode @node HELP_COMMANDS @title "AGASSM Help: ARexx Commands" AGASSM contains some internal ARexx commands that are used to control AGASSM from a remote piece of software. This allows information to be exchanged and the creation of a slideshow to occur automatically! As I don't actually own an ARexx manual, Commodore only put it in the A4000 package, I think I've not done too bad with these commands! As with the GUI of AGASSM, certain features of this interface only work with certain object types. It is pretty obvious which commands affect which object types. @{b}ADDOBJECT@{ub} [filename] * Adds an object to the current Slideshow List. Wildcards can be used in the filename. @{b}SETOBJECTTYPE@{ub} * Sets a specified object to a specific format. Wildcards can be used in the filename. = 0 - Picture 1 - Animation 2 - Module 3 - ARexx Script 4 - IFF Sample [viewmode] = 0 - Normal OR 0 - MED module 1 - Extra Half Bright 1 - ST module 2 - HAM6/8 @{b}VIEWOBJECT@{ub} * Displays, plays or executes the selected object. Wildcards can be used. @{b}REMOVE@{ub} * Removes an object from the slideshow list. Wildcards can be used. @{b}STOPAUDIO@{ub} If a music module has been launched from within AGASSM this will stop it. @{b}ADDEFFECT@{ub} [suboption] * Adds an effect or 'extra' to an object. = "WAIT|FADE|LOOP|BACKGND|SLIDE|BLOCKS" where the BLOCKS option has the sub-options. "HORIZ|VERT|SPIRAL|RANDOM|BLITTER|BLINDS|L-R|U-D" @{b}REMEFFECT@{ub} * Removes an effect or 'extra' from an object. @{b}SETANIMSPEED@{ub} * = 1 to 25 @{b}SETANIMLOOP@{ub} * = 1 to 100 @{b}LOADSHOW@{ub} [filename] * If the filename is omitted, a file requester is opened. @{b}SAVESHOW@{ub} [filename] * If the filename is omitted, a file requester is opened. @{b}NEWSHOW@{ub} * Resets AGASSM and clears the slideshow list. @{b}SETDISPTIME@{ub}