O-----------------------[wHERE tHE wARES cOME fROM]------------------------O :____.__ ____________________ __.______________________________________.___: \_ _ \ |_ _/ _ _/ _ ___ \___Y |____ \__/ _ __ __/_ __/ __ __)_/ __ \| _/ : / / |/\/ / \/ / \| \ \/\| | | \ \/ __// /_| |_\ \| |/ / \ . \ |: : \ \ | \ \ \ \ \ / \ \ : | / \ \ | / | | | \ : \ \ \ |: :____ /_____\___/____/____ /____| |____ /____|____|__:____ /__|____ /_:\__|: : \/ \/ \/ + \/ \/ : : : : Uploaded Time: 17:47:57 [...] Uploaded Date: 93-Jul-24 : : : O-------------(nODE1: 49-o2324-22698 - nODE2: 49-o2324-54552)--------------O ### BLOOD_TXT V2.0 © XRAY/MSQ ### ° _ . _ \\ _ _ __ ___ ____ _____..ooğOğoo.._____ ____ ___ __ _ _ // \\ \\ _ \\\\O//// _ // // \\ \\ \\ _ \_____/ _ // // // \\ \\ \\ \\ _ // // // // _____/ \_____/ \_____/ \_____/ \_____/ \_____/ \_____/ \_____/ \_____/ \_____ - -- --- ---- ----- ---------> F A I T H <--------- ----- ---- --- -- - ___ _______ _______ ________ __ ______ _______ _______ /\_/\ \_ \\\\/\_ \\\\ \_ \\\\/ \ / \\\\ \_ \\\\/\_ \\\\ / /\/ / \__ \ \____/\ / \_____/ \/¯\___ \/ \__ \ \____/\ / / / / // / _ \/ / __/\ / \ \ / \\ \ // / _ \/ / \/¯¯¯\ // /¯¯¯¯¯\\ \ / \/¯¯¯\ /\ / // / // /¯¯¯¯¯\\ \ \________/\_¯ /\_ ¯ /\ \_ / / /\_ / ¯ /\_¯ /\_ ¯ /\ \ \/\¯¯¯¯\/\¯¯¯¯¯¯¯¯\/nox\¯¯¯¯¯¯¯¯¯\/ \¯¯¯¯¯¯¯¯¯\/\¯¯¯¯\/\¯¯¯¯¯¯¯¯\/ ¯¯¯¯¯¯¯¯ ¯¯¯¯¯ ¯¯¯¯¯¯¯¯¯ ¯¯¯¯¯¯¯¯¯¯ ¯¯¯¯¯¯¯¯¯¯ ¯¯¯¯¯ ¯¯¯¯¯¯¯¯¯ <===========Y=0=U=R====R=O=Y=A=L===L=I=N=K===T=O===H=E=A=V=E=N============> __ _______________________________________________________________ __ \ /__/ \__\ / /\ // SysOp: GANDALF/FAITH NODE 1&2: +49 (0) 0NLY ELITE! \\ /\ \//¯_________________________________________________________________¯\\/ ¯\/\_/ \_/\/¯ /¯\\/ CoSysOp:COROPLEX/J-F-K/JONNY WALKER/ROMULUS/MIKE HAMMER \//¯\ _/ /¯\___________STÖRTEBECKER/[-RUNT&SCOTTIE]__________________________/¯\ \_ \/ \ / \/ ¯¯ ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ ¯¯ ------> Configuration: A3000, 4MB, 1,5 GIGS, 48 H0URS-WAREZ, 2 PORTS <------ DIRECTORYOPUS 4.10 COMPLEATE MANUAL RELEASED 23/7/1993 Corrected By Celic/$ceptic THE 4.10 FEATURES YOU MAY FIND AT THE END OF THIS FILE Chapter 1 A DirectoryOpus Walk-through 1. 1 What is DirectoryOpus? The theory behind Dir Opus is quite simple. On the screen there are two windows. These are called directory windows. You can read a directory into each of these from any device accessible by the amiga. You can read a directory into each of these from any device accessible by the amiga. You can select files and/ or directories in either of these widows, then minipulate them almost any way you like. Selected entries can be copied to the opposite window, Deleted or renamed; text files can be read, picture files can be viewed, and sound can be herd. DirectoryOpus ofers much more than these "bare bones" features, and you will learn more later in this manual. 1. 2 Files and Directories The Amigas dos (disk operating system) deals with two kinds of data arrangement files and directories. Each file and directory must be given a unique name; within a directory you cannot have two files, two dirs. or a file and dir of the same name. 1. 2. 1 Files Any data you record on a disk is stored in a file. Files contain information. which may be from a data base, from a word processor, from a painting prog, or the entire contents of a programe. The size of a file is expressed in bytes, each byte being equivalent to one character. Storing the string hello in a file would use five bytes, as the word hello is five characters long. Whether a file can be displayed, executed, deleted, edited, or considered as a script file, depends upon attributes that are explaind later. All files have a date stamp which shows what the system date and time where the last time the file was writtten to. Files may also have a comment of up to 79 characters attached to them. 1. 2. 2 Directories To store information in a logical manner, disks are generaly organized into directories, which are often referd to as drawers. If you picture a disk as a fileing cabinet, with your programs, data base files and pictures as the actual files, then directories are the drawers of the fileing cabinet. some of these drawers have futher drawers inside them, called sub dirs, which themselves can contain drawers, and so on, indefinitely. the dir or sub dir containing any given sub dir is known as its parent dir. The highest level of organizatlan is the root dir. If the dir is a filing cabinet, then the root dir is the room it stands in. The route you take along a dir tree to reach a file is called a path. as you procced along the path, each branch of the tree is seperated from the next branch by a / character. For example, the path of archives is expressed as work: downloads/ archves/ picture. arc. To refer to pcture. arc, you use what is called a path name. This consists of a files path, followed by the name of a file. Picture. arc, s path name would be work ; downloads/ archives/ picture. arc. The number of files and sub dir any given dir can contain is limited only by the ammount of space on the disk. 1. 3 Installing DirOpus If your computer does not have a hard drive, you may want to run directory opus from the distribution disk; otherwise you need to use the installation program, Installopus, which inserts Directory Opus into your hard disks root directory. It will modify your user startup sequence. Installopus allows you to choose the approach best suited to your level of expertise. For the novice, installopus inserts dir opus into your hard disks root directory and does everything for you, offering you few choicews. you may choose to have the directory opus screen displayed when you first boot up your computer, otherwise you may run directory opus from the workbench or from the cli. At a more ambitious level, installopus allows you to select the directories into which directory opus is to be installed. The expert user can take control: installopus allows you to define every singlechoice available, and assumes that you know what you are doing. You are able to modify your startup sequence to your needs. For more information, use installopus built in help system. 1. 4 Running Directory Opus There are three common ways of running directory opus. From Workbench From CLI From your Startup Sequence each are described below. 1. 4. 1 Starting from Workbench The easiest way to run directory opus is from the Workbench. double- click on the directory opus icon on the Workbench screen and, several seconds later, the directory opus screen will appear. 1. 4. 2 Starting from a CLI To run directory opus from the CLI enter: dopus:DirectoryOpus This assumes one of two things. Either you are running directory opus from a floppy drive containing the directory opus diskette, or you have it installed on a hard drive with an assignment of dopus: to its location. ( the install utility can create the assignment in your startup sequence) . 1. 4. 3 Automatic startup in the startup-sequence The startup-sequence is a script file that is automatically executed when you first turn on the computer. It can contain instructions to do many different things, including running directory opus. Either the installopus utility can modify your startup-sequence for you, or you can do it yourself. To modify your startup sequence you need a text editor such as commodores ed or memax. A highly recommended commercial text editor is cygnused professional, by asdg-inc. This is the text editor with which directory opus was written, and is a very powerful tool. Run your text editor, and load your startup-sequence into it. The startup- sequence resides in the s: directory of your boot disk. Pick a convenient place to put the new instruction. A good place would be the line immediately before the endcli instruction ( at the end), but you can realy put it anywhere. Add the line: assign dopus: dh0: tools/ dopus dopus: DirectoryOpus -i This assumes you have installed directory opus in a directory called dh0: tools/ dopus. Of course you need to use the actual directory path. The -i at the end of the instruction tells directory opus to start up iconifed, which means that the program will open only a little window on the workbench screen, instead of its own custom screen, and will sit unobtrusively in the background until needed. From the workbench, you can add a tooltype of iconstart= 1 to the directory opus icon, for the sadme effect. If you do not want directory opus to start up iconified, simply remove the -i. The more technically inclined may notice that there is no run on the instruction line. This is because directory opus detaches itself, freeing up the cli and allowing it to continue with the startup sequence ( and ulitmately closing). Make sure you save the startup-sequence once you have modified it. If your changes make sence, directory opus will be run automatically when you boot up. There is another flag you can use when you run directory opus. The -c flag tells directory opus where to load the configuration file from. For instance, -cdh1: stuff/ DirectoryOpus. cfg would load (and subsequently save) the configuration file from dh1: stuff / DirectoryOpus. cfg. From workbench, a tooltype of configfile= dh1: stuff/ DirectoryOpus. cfg would have the same effect. By default, it will look in dopus: modules. 1. 5 Introduction to using directory opus This section gives you a short tour of directory opus. It describes directory opus in its default configuration. The various configuration options will be described in a later chapter. 1. 5. 1 Aborting Before using the program, it is inportant to know how to abort an action. Most functions can be aborted once they have begun, and this can be usful if you accidentally start deleting the contents of your hard drive. To abort, press the left and right mouse buttons simultaneously. This will only take effect if the directory opus screen is active (i. e, it is at the front of the display). Do not be alarmed if the action does not abort immediately; some functions such as copy, will have to finish the file they are working upon before abotring. 1. 5. 2 Directory opus components Lets start with a brief description of the main components of the directory opus display. Title bar: the title bar is at the very top of the directory opus display. It is used to display various status or error messages. If you are unsure what directory opus is doing, it is a good idea to look in the title bar for a hint. The title bar is also used to reposition the directory opus screen. Clock/Memory bar: the clock/ memory bar is at the bottom of the directory opus display. It displays current memory and time information. Directory window: a directory window allows you to display the files and sub- directories contained in a directory. You can select (and deselect) files and sub-directories. Directory opus has two directory windows. The directory windows are described in greater detail below. Custom buttons: the custom buttons perform actions which usually trigger an operation on the selected files in the active directory window. Drive buttons: the drive buttons read the contents of a specific directory and display them in the currently active directory window. Custom menus: custom menus, like custom buttons, perform actions. Note: many parts of the directory opus interface use the right mouse button for alternative operations. As with DPaint, the mouse pointer must be positioned on the title bar when the right mouse button is clicked for the menu titles to appear. Tiny buttons: four tiny buttons are positioned between the two directory windows, and six tiny buttons are placed on the clock/ memory bar. 1. 5. 3 Directory Windows: There are two directory windows. One window is active at a time. because some actions, such as copy, work with selected files in the active directory window and use the inactive window as the destination, The active window is referred to as the source window and the inactive window is referred to as the destination window. Selecting the active directory window Clicking anywhere in a window with either mouse button will activate that window. Unless you are extremely precice in your placement of the pointer, however, clicking with the left mouse button to activate a window may lead to your selecting an unwanted entry. This is when using the right mouse button can be useful, as selecting entries is a left mouse button function, but clicking with the right mouse button can never have that effect. Pressing the space bar activates the inactive directory window. This allows you to toggle between the active and inactive windows. Directory window components Directory field Disk name Window area Window view sliders Next and previous buffer buttons ------------------------------------------------------------------- Directory field Many directory opus functions require that you read a directory into the active directory window. To read any directory, enter the name into the directory field. When you click in a directory field it will be activated, and a cursor will appear. Pressing the return key will activate the directory field for the active directory window. Once the field is activated, enter the name of the directory you want. There are several editing features you can use: Backspace: deletes the character to the left of the cursor Delete: deletes the character under the cursor Cursor key: moves the cursor one space in the direction of the arrow Cursor key+shift: moves the cursor to the beginning or end of the string. Right Amiga + x key: this is known as amiga-x erases the entire string Right Amiga + q key this is known as amiga-x restores the contents of a field to the previous information. Once you have entered the pathname you wish to read, press return. You will see the directory window activate ( if it is not already active), and the directory will be read. Disk name The disk name area of the directory window shows the disk or volume name for the currently displayed directory. This area also displays the amount of free space on the directorys volume. Window area The window area of the directory window displays the directorys files and sub- directorys. Selecting files To select an entry, file or sub- directory, click on it with the left mouse button. If you hold down the left mouse button and move the mouse up or down, all entries passed over will be highlighted. This is called drag selecting. When you click on an entry which is already selected, it will deselect it. By drag- selecting when you click on a selected entry, already selected entries that are passed over will be deselected. Entering sub-directorys Many directories that you read in will contain sub- directories. Instead of having to type in the name of a sub-directory, you need only to double click on it. Zhis will load the sub-directory into the same directory window. Opening the sub-directory in the other directory window allows you to copy files between the sub directory and its parent. To do this, you perform a click move click (click m click) with the left mouse button. Click m click means to click first on a sub directory entry then to move the mouse pointer to the other (inactive) window and click again. This can be tricky because the two clicks must occur within the amiga configured double click time (see amiga input preferences). An alternative method to click m click (which requires less mouse pointer gymnastics), is to click and hold on an unselected sub directory entry with the left mouse button. Then, without releasing the left mouse button, press and release the right mouse button. Without releasing the left mouse button, move the mouse pointer to the inactive window. As you move the mouse pointer, a copy of the selected sub directory will follow the mouse. When you position the mouse pointer over the inactive window, release the mouse button; the sub directory will now be read into the inactive windoow, which now will become the active directory window. A final alternative is to click and hold on an unselected sub directory entry with the left mouse button. Then, without releasing the left mouse button, move the mouse pointer to the unselected directory window. The trick to this method is to move the mouse pointer horizontally without moving up or down. Should you inadvertently move the mouse pointer over an entry above or below the selected sub directory, it will not follow the mouse pointer to the other window. When you do it correctly, a copy of the selected sub directory will follow the mouse pointer over to the inactive window and will be read when you release the mouse pointer. Moving to a parent directory: If the directory displayed in a directory window is a sub directory, you may wish to return to its parent directory. You could return to the parent directory by editing the directory field text directly, but the procedure is cumbersome and error prone; there are better ways. The default configuration includes a custom button which returns you to the parent directory. Each directory window contains a hidden parent button on the outer edge of the window area which will move you to the parent directory. On the left directory window, it is the white border on the far left. On the right directory window, it is the black border on the far right. When you click the left mouse button on a hidden parent button, directory opus will display the directorys parent, if it has one. When you click the right mouse button on the hidden parent button, directory opus will display the root directory. Window view sliders: Once the directory has been read in, it is displayed in the directory window. There is a limited space on the screen, however, so the whole directory may not be visible at once. A pair of sliders extends your view of the window. In the centre of the two directory windows are two vertical window view sliders. You can slide these up and down, to scroll through the contents of the directory. to slide the vertical window view sliders, press the left mouse button on the black bar and, while holding down the mouse button, move the mouse up and down. Click above or below the solid bar for the slider to move one page in that direction. At the bottonm of the two vertical window view sliders are arrow buttons. These will move the slider one line in either direction when clicked upon. Click and hold the left mouse button on one of the arrow buttons for the directory to scroll through the window. Press either the up or down cursor keys to move one line in that direction. These too will scroll when held down. Press the up or down cursor keys in conjunction with either shift key to move a page in that direction. Press a cursor key in conjunction with the ctrl key to display the top or bottom of the directory. To scroll quickly to the first entry starting with a particular letter, press that letter; the directory will scroll as close as it can get to the first entry whether file or directory starting with that letter. Press a letter in conjunction with either shift key to scroll only to the first file begining with that letter. Whether or not the entire directory fits in vertically, it will definitely not fit in horizontally. There is more information available for entries than just the filename. Also displayed is the size in bytes, the protection bits assigned to that entry, the date that entry was last written to the disk, and any comment that may be assigned to that entry. Horizontal window view sliders can be seen at the bottom of the directory windows, with arrows at the inner ends. These work like the vertical window view sliders, including the keyboard equivalents. you can scroll up and down, and left and right, by holding the right mouse button and moving the mouse. The directory windows are usually the same size. If you want to see more information than is displayed in the windows you can stretch the divider between them left or right to resize them. There is a hidden size bar between the two vertical window view sliders. when you click and hold this button, the size bar will appear. While holding the mouse button, move the mouse left or right. When you have the window as you want it, release the button. There three shortcut keys for resizing the directory windows: - slides the window view sliders to the far left \ slides them to the far right = re-centres the window view sliders Next and previous buffer buttons: Directory opus maintains up to 100 directory buffers for each directory window. To move back and forth through the buffers, click on either the previous buffer button or the next buffer button. The buffer will be displayed without re-reading the drive. The keyboard equivalent alternative is to press the alt key in conjunction with the left or right cursor key. To activate the directory field, press the return key. To re-read the directory, press the return key twice. 1. 5. 4 Custom Buttons: There are default custom buttons, all of which have left mouse button functions. Some of the buttons are also configured to perform right mouse button functions. The custom buttons with right mouse button functions are indicated by a dog-ear in the upper right corner of the button. Important: Many of the custom buttons perform actions on the selected files in the current directory window. before clicking on a custom button, verify that the idtended directory window is active. novice directory opus users can be confused when they have clicked on a custom button in an inactive window, and it does nothing. Of course you should verify that the selected files and directories within the directory window are the ones you wish acted on. All: The all button selects all entries in the currently active directory window Toggle: Selecting all with the right mouse button will toggle or reverse the state of all entries. This causes selected entries to be deselected and deselected entries to be selected. None: The none button deselects all entries in the currently active directory window. Parent: The parent button reads the parent directory of the directory open in the active directory window. If the parent directory is contaoned in the windows buffer list, it will be displayed without re-reading it. When the current directory is an assignment, for example c: , the assignment will be expanded, and then the parent function will move to the parent directory of the assigned directory. Root: The root button reads the root directory of the active directory window. as with the parent function, the buffer list will be searched before the parent directory is re-read. When the current directory is a sub directory to an assigned directory, the root function will display the assigned directory. When the current directory is an assigned directory, the root function will display the root drive of the assigned directory. Copy: The copy button copies the selected file to the destination (inactive) directory. If any directories are selected to copy, the sub directory filter will be used to determine which files will be copied. Copy as: The copy as function is similar to copy except that the entries are copied to the destination directory using new names that you specify. Wildcards can be used here. Move: This function will move all selected entries from the source directory to the destination directory. The entry will no longer exist in its original place. If any directories are selected to move, the sub-directory filter will be used to determine which files will be moved. Be careful with this function. Directory opus will delete the file if you are moving it to a different device. Move as: Move as allows you to give each entry a new name before it is moved. Rename: Rename allows you to give new names to all selected entries in the active directory window. A requester will appear for each entry in turn, asking for the new name. The initial rename requester has two string fields instead of one. You will usually just edit the name in the lower of the two to the new name. A limited type of wildcard rename is possible. entering a * in the bottom field allows you to add prefixes or suffixes. For instance, entering *. pic will add a . pic suffix to all selected entries. entering a* will add an a prefix. Only one * may be used in this process. You cannot give a file a name that contains a *. If you enter a * in the top as well as the bottom field, you can replace sections of the name. for example, entering *. pic in the top field and *. iff in the bottom field will replace the . pic suffix in any entry that has one with a . iff suffix. if an entry does not have a . pic suffix, it will be untouched. The * may also be embedded. For instance, renaming foo*baz as gee*wiz would rename foobarbaz as geebarwiz. Again, only one * may be used in each of the string fields. Clone: Clone allows you to make a copy of selected entries in the same directory, but with different names. A requester will appear for each entry, asking for the new name. Delete: Delete will delete all selected entries in the active directory window be careful with this, as it is easy to wipe out valuable data if you are careless. Directory opus`s default configuration brings up a requester before deleting. Nevertheless, you should always double check the selected files before clicking this button. Makedir: Makedir allows you to create a new sub-directory in the active directory window; its name is limited to 30 characters. A configuration option, create icons with directories, can be used to create an icon at the same time. The name of the directory is limited to 25 characters if create icons with directories is enabled. Assign: Assign allows you to create an amigados assignment to the directory in the active window. The assign command gives more examples. Check Fit: The check fit button tests whetheer the selected file will fit on the destination drive. The screen title bar will display the number of bytes needed, the available space, and the percentage of the file which will fit on the destination drive. Getsizes: The getsizes button causes any selected sub-directories to be scanned. The scanning calculates the total size, in bytes, of all files contained in the sub-directory. Once scanned, the sub-directory will be displayed. If a sub-directory has been previously scanned, it will not be rescanned when you select the getsizes button. See clear sizes below. The getsizes button also displays in the status bar the number of files, directories and bytes that have been selected out of the total number of files, directories and bytes. If there is enough space for the total selected bytes on the disk in the destination directory window, all selected files would fit on the destination disk if they were copied and a y will be displayed after the count. If they won`t fit an n will be displayed. If you select an operation which causes a sub-directory to be scanned (e. g. copy, protect, hunt ect. ), the size will be displayed as though you had performed a getsizes. Clearsizes: The clearsizes button will clear the sizes for selected directories, but not for selected files. If a sub-directory has been scanned already, pressing the get sizes button will not work. It is possible that a previously scanned directorys size is no longer accurate; ant application, including directory opus, might have changed the contents of the sub-directory since it was last scanned. To re-scan a sub-directory, the size must be cleared with the clearsizes button. Hunt: The hunt button allows you to search all selected sub-directories for a specified file or files. A requester appears asking for the pattern to hunt for. You can use full pattern matching for this search. If a file matching the pattern is found, You are asked if you wish to enter the directory containing it, or to continue the search. If elect to enter the directory, the directory will be read and then all matching entries will be highlighted. You can also select entire devices to hunt, using the device list feature that is described later. Search: The search button allows you to search the contents of all selected files, and the files within selected directories, for a specified string. a requester appears asking for the string pattern to hunt for. Again, full pattern matching is supported. If a file containing the string is found, you are asked if you wish to read that file, or continue the search. If you elect to read the file, it will be loaded into the text viewer, and a search will automatically be initiated for the string you want. You can also select entire devices to search, using the device list feature that is described later. If any directories are selected to search, the sub-directory filter will be used to determine which files will be searched. Run: The run button allows you to run each selected file in turn, providing that the file is executable. It is simmilar to double clicking on the files icon, or running it from the cli a requester will appear, asking for any arguments (should you require any). Execute: If you select this button with the right mouse button, the file will be executed as batch files. This has the same effect as running the batch file via iconx ( refer to amigados manual), or executing it from the cli. Comment: The comment button allows you to add comments to all selected entries, or to edit existing comments. The maximum length of a comment is 79 characters. If any directories are selected to comment, the sub-directory filter will be used to determine which files will be commented. You will be prompted for a comment for each selected entry. If you wish to attach the same comment to all entries, you should select the all button. Datestamp: The datestamp button allows you to change the datestamp of the selected files and directories in the the active directory window. When you select directories, You are asked whether you wish the files within them to have their datestamps modified also. If any directories are selected to datestamp, the sub-directory filter will be used to determine which files will be datestamped. For each entry, you are presented with a requester. If you wish the file to have its datestamp set to the current date and time, simply press return. otherwise, enter the date and time you want. To set the datestamp of all selected entries you should select the all button from the datestamp requester. Choose okay or press return to set the datestamps one file at a time. Protect: The protect button allows you to modify the protection bits of the selected files and directories in the active directory window. When you select directories, you are asked whether you also wish the files within them to be protected. for each entry, you are presented with a requester displaying the protection bits currently set for that entry. This is described in greater detail in the next chapter. If any directories are selected to protect, the sub-directory filter will be used to determine which files will be protected. Icon Info: The icon info button brings up the directory opus info requester for each of the selected files. Add Icon: Addicon allows you to add icons to all selected entries in the active directory window. Directory opus will automatically sense what type of file it is and add the appropriate icon (drawer, tool or project). Default icons are used unless you have specified the name of your own icons within the configuration (described later). Arc Ext: This button allows you to extract files from an archive file. Directory opus comes configured for arc, zoo, lharc files. When you click on this button, the files are extracted from the selected files and copied into the destination window. Note: directory opus distribution disks do not include the actual archive programs arc, zoo and lha. because they are shareware, we are not allowed to distribute them. They are available free on most bulletin boards. Encrypt: Have you ever had files that you wanted to encrypt so that only people who knew the password could understand them? This function allows you to do just that. It will encrypt all selected files, using the password that you enter, with a complex algorithm that most people will find impossible to work out. The resulting files are not written over the originals, but are instead written to the destination directory. They will be the same size as the original files, so you can ensure you have enough room in the destination directory. To decrypt a previously encrypted file, you should enter the same password preceded by a minus sign. For example, to decrypt files you encrypted with the password foo, select the files, choose the encrypt function and enter -foo as the password. Read: The read button allows you to read selected files. The name of the file is displayed at the bottom of the screen. You can use the slider and cursor keys to move through the file. Buttons along the bottom move up and down by a page, move to the top and bottom, allow you to search for text, and print the file. Pressing the right mouse button or the q key quits the text viewer. ANSI Read: The ANSI read button brings up the same reader as read except that it handles the special ANSI control sequences. HEX read: The HEX read button will read the selected files in the same way as read, except in hexadecimal format. This allows you to view binary files and other files containing non-text characters. Show: The show button is very versatile indeed. It will display iff ilbm pictures and brushes, animations, workbench icons and fonts. If the file is an iff ilbm, it will be displayed using information from the file. Directory Opus will show most pictures and brushes, including overscan, extra halfbrite (ehb), ham (4096 colour)pictures, dynamic hires pictures created by macropaint, and aga 8 bit pictures. The following keys can be used when viewing a picture or animation. Tab Cycle Colours Cursoor Keys Scroll Mouse Pointer Scroll Shift Cursor Keys Scroll by page CTRL Cursor Keys Scroll to end . Mouse pointer on/off [ Display in 4 bit format ] Display in 8 bit format ESC or Right mouse button Abort Q or Left mouse button Next Space, Help or P Help and print requester These keys can be used when viewing an Animation S Starts and stops N Next frame - Slow down = Speed up \ Original speed f1 - f10 Various speeds (f1 fastest) The show routine will also display Icons. If the file has a . info suffix it is assumed to be an Icon. If the icon has an alternative image, press return to toggle between the two. To display a font, you need to enter the actual font drawer, and select the size file (that is, the file 8, 12, 19, etc), not the . font file. Play: The play button plays the selected files as sound files. If the file is an 8svx format iff sampled sound (of the type generated by audio master, for instance), the speed and other information from within the File will be used. This button will play any file, and if the file is not 8svx, it will assume a speed of 10000 samples/second. Using the inovamusic. library, the play button also plays star/sound/ noise/protracker, med, octamed, octalizer, and med with midi modules. Each file is played once only. to abort a sound while it is playing, press the left and right mouse buttons. Loop Play: If you select this button with the right mouse button, the sounds are played continuously (looped). To advance to the next sound, you must press the left mouse button. Edit: The edit button allows you to edit any selected files, using the text editor (or word processor) specified in the configuration. The custom button configuration is explained later. By default, it is configured to use commodores c:ed program. You will probably want to alter this configuration to use an editor of your own choosing. New File: The new file button prompts you for a file name. If you select this button with the right mouse button, you will be asked for a filename to create a new file. Print: The print button brings up a requester which allows you full control of print formatting. 1. 6 The Tiny Buttons: The Directory Opus screen has several buttons that are not configurable; they activate the most necessary and usful functions, and are included so that these functions are always available, whatever your configurations may be. If you had mistakenly configured directory opus so that no button or menu called the configuration program, you would never be able to run the configuration program to change this! These buttons are called the tiny buttons, as they are much smaller than the configurable buttons on the screen. Four of them are arranged in a square approximately at the centre of the screen. Six others are found in the bottom right-hand corner of the screen. They all have one character titles. B Buffer list: This activates the buffer list function. This function displays a list of all the directories contained in directory opus` internal buffers. You may then double click on one of the displayed buffers so as to jump to that buffer immediatly, rather than clicking the arrows to cycle through the buffers one by one. Pressing the right mouse button over the buffer list button will activate the clear buffers command which clears from memory the contents of all buffers except the two that are currently displayed. R Reselect: This activates the reselect function. This Function will reselect all entries that were selected before the last operation was initiated. The entries are reselected only if they still exist, and regardless of whether the buffer containing them is currently displayed. Pressing the right mouse button over the R Reselect button performs the rescan function on the active directory window. S Select: This button activates the select function. This allows you to select files and directories in the active directory window using wildcards. All standard wildcards are supported ( *~? etc) as well as the amiga dos wildcards hash ? and ?. Pressing the right mouse button over the file select requester button will activate the get devices function (the device list function). This function produces a list of all devices, volumes and logically assigned directories that exist in the system. A Arexx: This activates the arexx function, which allows you to launch an arexx script or execute an arexx command from within directory opus. Pressing the right mouse button over this button will activate the dirtree function (the directory tree function). This function scans all sub-directories in the currently displayed directory, and produces a tree structure. The Tiny Bottom right Buttons: These buttons are optional; if you dont want them you can make them disapear by deselecting the bottom right tiny buttons flag on the config/screen/general configuration screen. ? Help: This button activates the help function. provided a help file has been loaded, selecting any button or menu after enabling the help mode should result in the appearance of some helpful text. Note:- the highlighted question mark indicates the help mode is active. E Error Help: This activates the errorhelp function, which gives you more information about dos error codes than is generally available. F Sub-Directory Filter: This button activates the sub-directory filter. When you click on this button, a requester will ask you to enter a file filter. The filter can contain a file specification containing wildcard characters. When you click the okay or press return, the requester will disappear and the F button will be highlighted. This indicates the filter is activated. When the filter is activated, any command which processes the files in selected sub-directories will only act on files which match the filter. These Commands are:- Copy: Copy as: Move: Move as: Hunt: Search: Protect: Datestamp: Comment: If the F Button is highlighted, you can turn off the filter by clicking on it again. It will become un-highlighted. C Configure: This activates the configure function, and will either load into memory or invoke the configuration program. I Iconify: This Button activates the iconify function. It closes the directory opus screen, de-allocates as much memory as possible, and then opens a small window on the workbench screen. This allows you to have Directory Opus constantly available, while using the minimum amount of memory possible. Q Quit: This activates the quit Function, which allows you to exit Directory Opus (providing there is not a print operation under way). If the Configuration has been modified and not saved, you are asked if you wish to save it first. 1. 8 Default Menus: Directory opus has 100 user-definable Menus. The functions chapter explains more about the menus, and the function editor chapter explains how to configure them. This Chapter simply gives a brief description of the default menus. All the menus can be changed, but they are configured initially for certain functions. 1. 8. 1 Project Menus: Project/Set Date: This Function allows you to set the system time and date, especially if you do not have a battery-backed clock. After you have set the time, the Amiga Clock keeps running to provide an accurate timekeeper. All files or directories created will have a datestamp of the current system time. The datestamp command of Directory Opus uses the system time. Two requesters will appear; the first containing the current date, and the second containing the current time. To change either the date or the time, delete and enter a new one. the date is expected to be entered in the form dd-mmm-yy. for example, 22-sep-89. Time is expected in the form hh:mm:ss, as in 18:30:43. You must include the dashes and colons as demonstrated above. Project/Current Dir: This Function allows you to set the current working directory for Directory Opus. The current directory is the directory loaded when you activate either directory field, delete the existing pathname (if there is one), and press return on a blank string. A requester will appear, containing the pathname of the active directory window. If this is acceptable as the new current directory press return. Otherwise, edit it to read as you wish. Project/Help: Provided a help file has beed loaded in, selecting any button/menu after enabling help mode with this menu should result in the appearance of some helpful text. Help can be read from any file, although the default is s:DirectoryOpus.hlp. the file name can be changed with the helpfile configuration option, described later. The help file chapter describes the help file in detail, and explains how you can edit it to add help for your own buttons and menus. Project/Error Help: Error help gives you information about dos error codes. When you select this option, you are asked for which dos error code number you want help. Examples of dor error codes are 123, 205 and 225. You are then presented with a description of that error, and information pertaining to the possible cause and cure of the error. Error Help is also stored in the help file (see above); if the help file has not been loaded, error help will not be available. See the help file chapter for more information. Project/Configure: Directory Opus uses a separate program to modify the configuration. This saves about 127k of memory, as the configuration program need only be in memory when it is being used. If you have plenty of memory, directory opus can be configured to load the configuration program on startup. In this case, it is run from memory each time the configure function is invoked, rather than loaded from disk. This can be much faster, especially if you have a floppy based system. see the configuration program chapter for more detailed information. Project/About: This Function displays some information about this program. Project/Tech Support: This menu displays information about getting technical support. Please refer to the requester before contacing inovatronics as there are specific times and methods for getting technical support. Project/Version: This menu displays the current version of kickstart, workbench and Directory Opus. This information will be necessary when getting technical support. Project/Iconfy: This Function closes the Directory Opus window and screen, de-allocates as much memory as possible, and then opens a small window on the workbench screen. This is known as iconifying, and allows you to have Directory Opus constantly available, while using the least amount of memory. The iconifed window may contain a clock, or may not be visible at all, depending on how you have set the iconify type configuration option (described later). To determine the initial position of the iconified window (especially if you plan to start up Directory Opus in the iconified state), you should iconify directory opus, and position the window as you would like it to appear. That done, re-enter directory opus, and save the configuration (described later). When iconified, you can drop workbench icons on the directory opus window. This will have the same effect as if you displayed the file in a Directory Opus window and double-click on it. for example, if you drop a picture on the window, it will show it. To re-enter directory opus, click the left mouse button in the iconified window, then press the right mouse button. If you wish to quit Directory Opus without going back into it, click the close button at the far left of the iconified window. Note that if you have the configuration option iconify type set to hidden, the only way to re-enter Directory Opus is with the hotkeys. These default to ctrl-shift-alt (the ctrl key, the left shift key and the left alt key simultaneously), although this may be changed in the configuration (explained later) Project/Burron Iconify: This causes a special variation of directory opus iconification. normally iconification is set up by the configopus/system/clocks screen, but with this commandyou can iconify directory opus into a bank of buttons on worbench. In this Mode Directory Opus allows you to do almost all, if not all it normally does. For instance, if you select the copy button a requester will open asking you to select something to copy followed by another asking where to copy it. You can also use the bank of buttons as an appwindow when running in os2. 0. To show a picture, you would simply drag the icon of the picture onto the show button. The slider to the right of the button bank allows you to choose which button bank is shown. To un iconify back to Directory Opus, press the uniconify button above the slider to the right of the bank. Or select the close button of the window. The close button will you wish to quit Directory Opus or uniconify it. Project/Quit: This function will exit Directory Opus (providing there is not a print operation happening at the time). If the configuration has been modified and not saved, you are asked if you want to save it first. 1. 8. 2 Function Menu: The function menu contains miscellaneous disk operations, and archive adding. Function/Disk Copy: This function brings up a requester which allows you to make an exact copy of one disk on another. For more information, see disk copy requester later. Function/Format: This allows you to format a new disk. All new disks need to be formatted before the computer can write files to them. For more information, see the format requester later. When this is selected, a requester with several buttons appears. Drives df0: to df3: are available. Separate names may be specified for each disk. Verify allows you to turn verify on or off. As with function/disk copy, the process is faster with verify turned off, but you wont be made aware of any errors, so its better to leave verify turned on if you dont completely trust your disks. If quick is selected, the disk will just be initialized (wiped). This provides an extremely fast way to erase an old disk. This will not work on new disks, however; only on disks that have previously been formatted. If no icons are selected, the disk. info, trashcan. Info and trashcan directory will not be created on the disk. Function/Install: This function brings up a requester that allows you to make a disk bootable. To be bootable, disks must have special information written on their first sector. For more information, see the install requester later. Function/Relabel: This function allows you to change the name (label) of the disk that is open in the active directory window. Function/Print Dir: This function allows you to print the directory in the active directory window. You are able to choose the information you want to print (file sizes, protection bits, dates and comments). This function is not started as a separate process, unlike the print command. For more information, see the print dir requester later. Function/Disk Info: This function displays some information about the disk the active directory resides on, including space used, space free, datestamp and number of errors on the disk. Function/lha add, arc add, zoo add: These functions allow you to create and add files to arcives, using the popular archivers arc, zoo and lha or lharc (and up to three others; see the functions section of chapter 7 for more information). To add files to an archive, select the files you wish to add, and select this function. You will be asked for the name of the archive to create or add to. You should have the destinaion directory open in the inactive window. Chapter 2 Requesters and Viewers: This chapter presents the more complicated requesters and viewers. Each of these is associated with Directory Opus commands which are activated by custom buttons and menus. 2. 1 Protection Requester: The protection requester allows you to change a files or a sub-directorys protection bits. The protection bits are a group of flags that are stored with the file, that determine the characteristics of the file. These flags are given one character names. The protection bits currently in use are hsparwed. H: Hidden. If this flag is set, the file is not normally displayed. This allows you to mark certain files as "invisible", to avoid cluttering your directories. The file can stillbe accessed normally, and not all programs implement this flag. S: Script. A script file is a file containing a list of amigados commands to execute; it is like a simple computer program. This flag indicates that the file in question is a script file. A script file is sometimes called a batch file. P: Pure. If a program file is flagged as pure, it can be made to remain in memory, even when not in use. This can save a great deal of time, especially if the program is not used a lot, as it does not have to be loaded from disk each time. A: Archive. This flag indicates that the file has not been changed. If this file is ever written to, the a flag will be turned off. This can be used in a hard disk backup program, to record which files have been backed up, and need not be backed up again. R: Readable. If this flag is set, the file can be accessed. W: Writeable. If this flag is set, the file can be written to (i. e, more information can be stored in it than is already there). E: Executable. If a program file does not have this flag set. It can not be run. D: Deleteable. If this flag is not set, the file can not be deleted. While AmigaDos and other programs do not fully support all of these bits, Directory Opus gives you access to all documented protection bits. As AmigaDos is enhanced, some bits, such as writable, will become more usful. If you have additional questions about the usage of the bits, refer to your Amiga documentation. There is a button for each protection bit along the left edge of the requester. Clicking on each of these will toggle a checkmarrk on and off within the button. When the checkmark is on, it means that the bit will be set when you click on the okay button. In the middle of the requester are four buttons which manipulate multiple protection bits at a time. These buttons do not cause any action to take place within the selected files; they simply change the state of the protection bit buttons. All Bits: Sets all proction bit buttons. None: Causes all protection bit buttons to be cleared. Toggle: Sets all clear protection bit buttons, and clears all set protection bit buttons. Revert: Restores the protection bit buttons to the settings they had when you entered this requester. On the right side of the requester are three groups of protection bits: old, new, and mask. Each group contains a protection bit letter or a "-" (dash) for each bit. The letter indicates that the associated protection bit is set, a dash indicates that it is clear. The old group indicates the original bits when you entered the requester. The new indicates the current status of the protection bit buttons. Whenever you click the protection bit button, it will be reflected in the group. Unlike the previously described old and new groups, the mask group bits can be changed by clicking on the associated letter or dash. The mask group allows you to specify protection bits which should not be modified, regardless of the protection bit buttons. When the letter is shown, the bit will not be modified. The dash means that you need to set the bit according to the setting of the protection bit button. This is most usful when changing files within a sub-directory or using the all button (described below). For example:you want to set the archive bit in all files contained in a sub-directory, but you dont want to affect any of the other protection bits. Set the archive protection button on the left side of the requester and set all the archive bits in the mask group except A. This will preserve all the files bits with the exception of the archive bit, which will be set. Along the bottom of the requester are three buttons: Okay: Causes the current file (shown in the screen title bar) to be set as indicated in the protection bit buttons (and possibly filtered according to the mask group). All: Causes all selected files to be set, without additional prompting, as indicated in the protection bit buttons (and possibly filtered according to the mask group). Cancel: Aborts the protection function. 2. 2 Disk Copy requester: This function allows you to make an exact copy of one disk on another. When this function is invoked, a requester with several buttons appears. From: This list contains the possible disk drives that may be used as the source. When you click on one, it becomes the selected drive. To: This list contains the possible desitnation drives which are compatible with the selected source drive. The source disk drive is always available as a destination to allow you to make single drive copies. This only makes sence with removable media such as floppy drives as it would accomplish nothing yo copy a hard drive to itself. Verify: This button allows you to turn off the integrity verification when writing data to the destination drive. Although it is faster, you probably wont want to do this. Bump Name: This button allows you to chance the volume name using the same naming convention as workbench`s diskcopy. (See AmigaDos documentation for details. ) This function will not copy any procted software, or non-amigados format disks. Selecting the diskcopy button will start the copy. The exit button will abort without attempting a diskcopy. 2. 3 Format Requester: This allows you to format a new disk. All new disks need to be formatted before the computer can write to them. When this is selected a requester with several buttons appears. On the left side is a list containing the devices which can be formatted using this operation. Warning! this option will destroy existing data on a disk. Be sure you want to erase the data before you click format or quick format buttons the list on the left side of the requester conains the devices which you can format. The selected device is highlighted. Be sure the device you intend to format is the one that is highlighted! Name: This field allows you to give the drive to be formatted a volume name. Fast File System: This allows you to format a device using the fast file system option of AmigaDos. You should consult AmigaDos documentation for more detail. this option does not work on floppies prior to os2. 0. Intrenational Mode: This allows file and directory names to include accented characters. OS2. 1 and later. Directory Caching: Directory caching mode will decrece the capacity of your disk but the directory reading speed will be mush greater. Put Trahscan: This button allows you to put a trashcan in the root directory of the newly formatted device. Verify: This button allows you to desable the format verification. as with function/disk copy, the process is faster with verify turned off, but you wont be made aware of any errors, so its better to leave verify turned on unless you completely trust your disks (you really shouldnt). Format: This button begins the formatting process. Be very careful you have selected the correct device. Once a format begins, it can be aborted, but data will be lost. Quick Format: When this button is selected, the disk will just be initialized (wiped). This provides an extremely fast way to erase an old disk. This will not work on ner disks, however; only on disks that have previously been formatted. Exit: This button will abort without attempting a format. 2. 4 Install Requester: This function allows you to make a disk bootable. to be bootable, disks must have special information written on their first sector. the list on the left contains the possible devices on which you can install a boot sector. Select the possible device you want to install on. When you select a device (or insert a new disk in the device), Directory Opus will examine the boot sector and inform you of the disks current status. It does this automatically when you first bring up the install requester. It will tell you one of the following: No Disk Present: This simply means that you havent inserted a disk in the drive yet. when you do so, it will update this status message. Normal 1. 3 OFS Bootblock: This means the disk was installed with the old file system used before 2. 0 of AmigaDos. Normal 2. 0+ FFS bootblock: This means that the disk was installed with the new file system used for 2. 0 and later versions of AmigaDos. Non Standard: This means that the disk is corrupt. It may contain a virus and it would be a good idea to run a virus checker program to make sure. Fast File System: This button allows you to istall a fast file system bootblock. Install: This button installs the boot sector on the disk. No Boot: This button removes the boot sector from the disk. This will keep the disk from being bootable. however, you can always re-install the boot sector by clicking the install button. Exit: This button will abort without attempting an install. 2. 5 Print Dir Requester: This function allows you to print the directory in the active directory window. If no files are selected, all files will be printed. however, if only some files are selected, only those files will be printed. You can select the information you want to print:file sizes, protection bits, dates, comments, and file types. Directory Opus can only print the selected information when it is being displayed in the directory window. Output To: By default, the output will be sent to the printer. however, you can redirect the output to a file of your choosing. Printer: This option directs the output to the printer. File: When this option is enabled, output is directed to the file indicated in the accompanying field, Click on the magnifing glass next to the file field to use a file requester to find the file name; otherwise type the name directly into the file field. Print: When you click on this button, Directory Opus will begin printing the information. it is not started as a separate process, so you might have to wait while Directory Opus completes printing the information. Exit: This button will abort without attempting to print the directory. 2. 6 Print Requester: This requester gives you full print formatting control for text files. Note: All printers are not created equal. Some printers will ignore some of these configuration options. These configuration options work in accordance with the Amiga printer preferences. The Amiga preferences may override these preferences or simply make the output look silly. For example, you cannot use these options to display more lines on a page than is specified in Amiga preferences. There are several configuration items in the print requester: Top Margin: This field contains the line number where text should start. A top margin of 1 starts on the first line and does not have any blank lines. Bottom Margin: This field contains the number of printed lines on each page. The top margin lines are not included in this value. For example, a top margin of 5, and a bottom margin of 60 the last line will be printed on line 65. Left Largin: This field contains the number of characters to skip before printing each line. Right Margin: This field contains the number of printed characters allowed on each line. The left margin characters are not included in this value. For example, a left margin of 5 and a right margin of 70 will result in the last printable character in column 75. Tab Size: This field contains the number of spaces to which a tab character is equivalent. Directory Opus converts tabs to spaces and will insert the appropriate number of spaces to create columns based on tab size. For example, a tab size of 8 specifies tab positions of 8, 16, 24, 32, 40, 56, and 64. Print Pitch: This button cycles between pica, elite, and fine. These values specify the size of letters to print. Your printer will determine the exact dimensions of these values. Quality: This button cycles between letter, and draft. Some printers can be toggled between letter and draft quality printing. Eject Final page: A check in this button enables a final form feed character after printing the last page. Configuration: This button cycles between header and footer. The title, date and page number. Buttons (described below) can be used with creating a header or footer line for each page in the print out. When the configuration button is header, these buttons affect the header line; otherwise, they affect the footer line. By default, Directory Opus will not ceate a header or a footer line. Title: When the checkmark next to title is on, a title will be generated. By default, the filename will be the title. However, you can override this by putting text in the title field. You can have different titles in the header and footer lines. Date: When the checkmark next to date is on, the current date will be printed. Usually this is enabled for either the header line or the footer line, but not for both. Page No: When the checkmark next to page no is on, the page number will be printed. Usually this is enabled for either the header line or the footer line, but not for both. Text Style: This button allows you to modify the appearence of all the printed text except the headers and footers. (Some printers do not support all of these styles). Clicking on the text style cycle button allows you to choose from the following options: normal, bold, italics, unlined (underlined), dblstrik (double strike), and shadow. Output to: By default, the output will be sent to the printer. However, you can dedirect the output to a file of your choosing. Printer: This option directs output to the printer. File: When this option is enabled, output is directed to the file indicated in the accompanying field. Click on the magnifying glass next to the file field to use a file requester to find the file name; otherwise type the name directly into the file field. (If you leave the field empty, the output will go to the printer. ) Print: When you click this button, Directory Opus will begin printing the information. This function will print all selected files, one at a time. If you select only one file to print, the print routine will be started up as a separate process, allowing you to continue working with Directory Opus. To cancel this type of print, simply select the print function again. A requester will appear asking if you want to continue with the print or halt it. This requester will also appear if you attempt to quit directory opus while a print operation is in place, as you cannot quit until the print has finished. Even if you abort a print, the printer may not actually stop for some time. This is because most printers have buffers, some quite large ones, which store data for printing and will need to empty themselves before the printout will stop. Exit: This will abort without attempting to print. 2. 7 Text Viewer: The name of the file is displayed at the bottom of the screen, giving the current position within the file both in lines and as a percentage, and also the total number of lines in the file. Press the left mouse button to scroll through the file. press the left mouse button to scrolling on or off. The direction and speed of the scroll are governed by the position of the mouse pointer in the window. The mouse pointer will become invisible while the text is scrolling. No scrolling occurs if you have the mouse in the centre of the window. To scroll forward, move the mouse down until the text starts to scroll (providing there is actually more than one page of text). The further down you move the mouse, the faster the text will scroll. This procedure is reversed for backwards scrolling. The buttons in the bottom-right of the screen also allow you to move around the file. Most buttons will repeat if held down for any length of time. (Each button uses the corresponding letter as a shortcut key. ) Up/Down Arrows: Move up and down a line at a time. U: Moves up a page at a time. D: Moves down a page at a time. T: Moves to the top of the file. B: Moves to the bottom of the file. Cursor keys: Move up and down. Cursor key+shift: Moves one page at a time. Cursor key+ctrl: Moves to the top or bottom. The current line and percentage values (in the middle of the bottom bar)act as hidden buttons:click on them and a requester will allow you to specify a new value. It will jump to the new location. S: Searches for a string. you can use full pattern matching. P: Prints the current file. C key: Prints only the current page. this has no button equivalent. X or Q or ESC: Leaves the text viewer. You can also use the right mouse button to exit. If you have selected more than one file, the next one will be read when you exit. To exit without reading the next file, press the right mouse button. 2. 8 HEX Viewer: The hex viewer will read files in the same way as read, except in the hexadecimal format. This allows you to view binary files and other files containing non-text characters. The file is displayed in the following manner: The first value is the offset, displayed in hex. This the number of bytes you are into the file. The next four values are each a four byte longword, with the actual ascii representation at the end. Any non-text characters are shown as a . character. Chapter 3 Opus Configuration (Configopus) 3. 1 Introduction: The Opus Configuration utility is a powerful and easy to use instrument for customizing Directory Opus precisely to your tastes. Do you want to use an interlace screen? Eight or sixteen colours? Lots of buttons? fancy buttons? Directories sorted by date, in reverse order? Instant access to various assignments? With Configopus, these are but a few of the myriad choices you can make. Sophisticated though it is, the configopus utility is quick and easy to use. This chapter is intended as a complete set of instructions for users new to directory opus, and as a convenient reference for experienced users. Directory opus uses a separate program to modify the configuration. this saves approximately 130k of memory, as the configuration program need only be in memory when it is being used. Not only that, but the configuration program can be run independently of Directory Opus, if you are realy short of memory. If you do have plenty of memory, however, Directory Opus can be configured to load the configuration program on startup. In this case, it is run from memory each time the configure program isinvoked, rather than loaded from disk. That can be much faster, especially if you have a floppy based system. From within directory opus, you can startup configopus by clicking on the small c button on the lower right or selecting the configure item from the project menu. From outside directory opus, you can start configopus by itself either by double clicking on the configopus icon or starting it from a cli 3. 2 Configopus main screen: On the Configopus screen there are several items of interest. At the top of the screen you will see screen depth and help buttons and the screen title bar. Screen depth button: Allows the user to push the screen behind the other screens opened. Help Button: Brings up help information. when you have questions about something on the screen, try here first. If the help button does not answer your question, then you can drag out the manual. Screen title bar: Describes the current screen. Doubles as the screen drag bar, which allows you to drag the screen down and see the screen(s) behind the Configopus screen. The next set of buttons to look at are the subject buttons along the left side of the screen. when you select one, the screen will change to show that part of the Configopus. Buttons: Configure the custom buttons, allowing you to launch internal commands and external programs. Drives: Configure the custom drive buttons. Filetypes: Configure the file classes and actions necessary for file recognition. Hotkeys: Configure the global hotkeys, allowing you to launch programs from anywhere in the system while Directory Opus is active or iconified. Menus: Configure the custom menus, allowing you to launch internal commands and external programs. Operation: Flags and settings that affect the way Directory Opus behaves. Screen: Modifies the characteristics and appearance of the Directory Opus screen and graphic user interface. System: Additional items that affect the way Directory Opus interacts with the operating system. The last buttons on this screen are the okay and cancel buttons. these allow you to say eitheer ok, lets use this setting and go back to Directory Opus, or oops! Forget all that, and lets get out of here! 3. 3 ConfigOpus configure menus: There are four menu items available on most screens in Configopus that allow the user to control the configuration data. You can revert to the default configuration, Load a configuration file or save the current configuration. On the configopus screen these menus will allow you to affect all the configuration data. When you select the open item, you load all the configuration data from that file, replacing any changes that you have made with this new data. On the other screens in configopus, the open menu will only override the information specific to that screen. For instance, on the custom button screen only the custom button banks will be loaded from a configuration file. This allows you to load banks of buttons that you have defined in advance, so as to control the newtek video toaster, for example, or some other application. Default: Reset to the factory default configuration settings. Open: Load configuration settings from a disk file. These banks will be inserted at the end of the banks that you have already defined. If you are on custom buttons, drives, filetypes, hotkeys or menus this will only load that part of the configuration file. As an example, by using this, you can inport custom button banks from someone elses configuration file. Save: Save the current configuration settings as the default. Save as: Same as save, but this allows you to specify a filename. 3. 4 Buttons/Manager: There are 42 custom buttons, located at the bottom of the Directory Opus screen. Each button can have a left and/or right mouse button event, bringing the total number of custom buttons to 84. The custom buttons are arranged in banks. There is only one bank of these buttons by default, but the configureation program allows you to add or delete as many banks as you want, which means that the number of custom buttons is limited only by the available memory and your imagination. The button configuration screen displays the current button bank, with the left mouse button events at the top and the right mouse button events at the bottom of the screen. There are ten buttons across the bottom of the buttons/manager screen. the copy, swap and delete buttons stay selected if they have been selected with the left mouse button. For instance, copy button will stay selected to remind you that you are in copy button mode. When you want to leave this mode, select copy button again. The below that work in this fashion are: copy, swap and delete. Next bank: With this button you can cycle through the button banks. The current bank number is displayed in the title bar of the screen. Select this button with the left mouse button to move to the next bank. Select this button with the right mouse button to move you back to the previous bank. New bank: This button allows you to ceate a new bank of buttons. If you select this button with the left mouse button, it will create an empty bank at the end of the bank list. This bank will then be shown. if you press this button with the right mouse button, the new bank will be inserted before the current bank, instead of at the end of the bank list. Copy bank: Use this to copy the currently displayed bank. A requester will appear asking you to enter the bank number to copy the current bank onto. If the bank number you enter does not exist then a new bank will be created, at the end of the bank list. The current bank will be copied there. Swap bank: Swap bank allows you to swap the contents of the currently displayed bank with those of another. A requester will appear asking you to enter the bank number to copy to. If the bank number you enter does not exist, the swap operation will be aborted. Delete bank: After asking for conformation, this button will delete the current bank. If the current bank is also the only bank, you will be warned. Copy button: This button allows you to copy one custom button onto another. select the custom button to be copied, then select a custom button to copy it onto. To abort the copy, turn off the copy mode, select copy button again, or select the custom button you are copying again. Swap button: This permits you to swap two custom buttons. It works the same way as the copy custom button execpt that it simply exchanges the two custom buttons. Delete button: After asking for conformation, this will reset all the data associated with the custom button. When in copy or swap button mode, the next bank button is still usable and allows you to copy and swap custom buttons between banks. 3. 4. 1 Button manager menus: The default or open.... menu items in the configure menu allow you to import custom button banks from either the default configuration or a configuration file from disk. These banks will be inserted at the end of banks you have already defined. There is an additional menu strip available on this screen. The button rows menu allows you to configure the actual number of rows of custom buttons that will be displayed at one time on the main Directory Opus screen. You can choose from zero (no buttons displayed), one, two, three or six rows. This will also affect the drive bank height. To edit a custom button, make sure you are not in copy, swap or delete mode. Select the custom button, and you will be shown the custom button editor screen. The last two buttons on this screen (lower right corner) are the okay and cancel buttons. These allow you to say ok, lets use all these custom button changes and go back to configopus main screen, or oops! Forget all this, and lets just leave. 3. 5 Buttons/Editor: At the top of the custom button edit screen you can see what the current custom button looks like. The palettes on either side allow you to select the buttons foreground and background colours. If you click on the example button itself, it will highlight to show you what the real button will look like when selected. Name: The name field allows you to modify the name that appears on the button, and is limited to 63 characters. The shortcut key displays the keyboard equivalent for this custom button Sample: To modify the shortcut key, select the sample button at the right of the shortcut key field, then any keys you press, along with any qualifer keys, will be inserted in the shortcut key field. To turn off sample mode, select the sample button again. To remove the shortcut key, select the sample button with the right mouse button. 3. 6 Command editor: A command tells Directory Opus what to do when somthing happens, and can be attached to custom buttons, filetype actions, hotkeys and menus. Each of these has its own configuration screen with unique aspects (e. g. , the title and colours used on a custom button). The unique aspects of the various editors are described in their own sections, but they all have a common portion, referred to as the command editor, which allows you to edit the command. At the centre of the command editor is the command list which contains the commands associated with this function. To the left of this list are four buttons that allow you to modify the order and effectiveness of these commands. New entry: Adds a new command to the list. Duplicate: To duplicate an existing command, select the command and select the duplicate button. The duplicated command will be added to the end of the command list. Swap: To exchange the position of two commands, select the first, then select the swap button. With the swap button active, select the second command to swap. To cancel the swap operation, select the swap button again. Delete: To delete a command from the list, select the command and select the delete button. To edit a command, simply click on it. The command string will be copied to the fieldbelow the list for you to edit it. 3. 6. 1 Edit Fields: Below the command list is a group of editing tools. These tools allow you to edit active command entries. When you click on an entry in the command list it becomes active, or an empty one is created when you select new entry. Command type: The cycle button on the left below the command list allows you to specify which kind of commond is used. When you click on this button, it will cycle through the following command types: Command: Executable: Workbench: Batch: Arexx: Each of these command types is described below. When you click on the magnifing glass button just to the right of the command type button, a requester appears allowing you to pick an appropriate entry for the selected command type. Each of the following descriptions indicates the kind of requester which will appear. Command: These are internal commands, built into directory opus. many of these commands can take parameters from buttons amd menus, as well as from arexx. Internal commands are documented in the commands chapter. The magnifing glass button brings up a list of internal commands. Executable: Executables are launched as if you were running them manually from the cli. Thus, with an output window enabled, they can receive keyboard input from the user and display output on the screen. The magnifing glass button brings up a file requester. Workbench: Workbench programs are also executable programs. They are launched, however. As if you were double clicking on their icons from Workbench. this can be an advantage, as many programs do not take arguments, or do not work at all if run from CLI. If the workbench program given is a tool (i. e. , an executable program), Directory Opus will look for its icon file to determine the necessary stack size to give to the program. If the icon cannot be located, the stack size defined in the button, menu or filetype will be used. If the Workbench program is given is a project (a non-executable file created by another program), Directory Opus will look for its icon file to find its default tool, the actual program needed to load the file. If the icon cannot be found, or a default tool can not be loaded successfully, Directory Opus will not launch the file. The projects icon is also used to determine stack size. Workbench programs can also take arguments from Directory Opus using the {f} and cimilar sequences. This can be very usful indeed. Deluxe Paint, for instance, does not accept arguments if run from the cli; you would be unable, therefore, to select a picture file for deluxe paint to load from Directory Opus if you were running Dpaint as an executable. if, however, you have the command defined as: Dpaint {f} and have the command type set to Workbench, Deluxepaint will be run as a workbench program. from the Workbench, Deluxepaint will accept arguments, so the first file you selected would be loaded into dpaint automatically The magnifying glass button brings up a file requester. whenever Directory Opus opens a command editor, it creates an appicon on Workbench. The Directory Opus appicon looks like a normal icon, but it does not do anything when you double click on it. However, if you drop an icon on it, Directory Opus will add a Workbench command entry. Batch: Batch files, also called script files, are files that you might run with the execute command, or with the execute command from the cli. Selecting a command type as batch will cause the file to be executed as a script file. The magnifying glass button brings up a file requester. This file requester is initially set to s: because this is where batch files come from by default. Arexx: This type indicates that the command is an arexx script. This script will only be launched if ARexx is active in the system. Note that the address of the ARexx port will be set automatically; you do not need to use the ARexx address command to address the command to Directory Opus. The magnifying glass button brings up a file requester. This file requester is initially set to rex: because this is the place ARexx files come from by default. {}: This button is located next to the command edit field. This button brings up a list of the argument functions. Refer to the functions section of the manual for more information about this powerful feature. Function strings can contain many different command sequences to do different things with files and directories. For documentation on these, and more information on functions in general, consult the functions section of the manual. Flags: Below the command list is the flags list. This is a list of all the flags available for custom commands. These flags apply to all commands in the command list. The flags are:- Auto iconify: Causes Directory Opus to enter iconified mode when the commands are launched. This could be useful in low memory situations. It only works with run asynchronously enabled. Cd source: If this is turned on, the current directory of the custom command will be set to the current source directory (active directory window). Cd destination: This has a similar effect to cd scource, except that the current directory of the custom command will be set to the current destination directory (inactive directory window). Directory Opus to front: Causes the Directory Opus screen to be brought to the front when the commands have terminated. It is used in conjunction with workbench to front. If enabled in conjunction with run asynchronously and output window, this flag will have a slightly different effect. In that case, the output window will be opened on the Workbench screen as normal, but the Workbench screen will not be brought to the front. Do all files: This causes the commands to act on each selected entry in turn, instead of just the first entry. This is used for commands that do not support multiple filenames on the command line, where {f} to send all selected entries, would not work. Include dopus-startup: Has Directory Opus execute a file called s:dopus-startup before any external commands are actually executed. This file is used in the same way as the shell-startup file above, but it is distinct from the shell startup file, and therefore allows you to put into it any Directory Opus-specific commands. Include Shell-startup: If this option is enabled, then Directory Opus will execute the standard s:shell-startup file before any external commands are actually executed. This allows you to have all your path lists, resident commands, etc. available to custom commands. No file quote: This option enables Directory Opus to operate correctly with some older or poorly written software. Normally, whenever Directory Opus sends a filename to a custom command with the {f}, {o}, etc. flags, the filename is enclosed in quotation marks. This allows you to use filenames containing space with external programs. However, some software does not interpret the quotation marks correctly. If you find this is the case with any program, simply select the no filename quote flag. Output window: Opens a window for output from these commands. The window will open on the Directory Opus screen, unless the Workbench to front option or the run asynchronously option is enabled. In this case, it will open on the workbench screen, and the Workbench screen will be brought to the front automatically. The window is opened using the handle specified in the System/Amigados section of the configuration. Output to file: Redirects all output from the commands to a temporary file in the t: directory, which is then read via the text viewer. This allows you to read the output of a program thoroughly, and even to print it. Note that if you are sending output to a file, the command cannot receive input from the keyboard. Recursive directories: Allows the command access to files within sub-directories. Normally, whenever a {f} or {f} orsimilar sequence would result in the name of a directory being included in the programs parameters, Directory Opus would treat the directory in the same way as a file. In other words, the command would not act recursively on all files within the directory. If this option is enabled, the names of all files within that directory, and within sub-directories within the directory, and so on, are included in the programs parameters. This allows the command to act on all files in the directory and not just on the directory itself. Reload each file: Causes Directory Opus to rescan a file after it has been acted upon by a command, and updates the size, datestamp, comment and protection bits of the file. You can therefore reflect changes in size, for instance, made by a text editor to a file. Rescan destination: This flag makes Directory Opus reload the destination directory (inactive directory window) when the command terminates. this, and the above option, allows Directory Opus to display correctly any changes made to either directory window by external programs, such as archivers. Rescan scource: Makes directory opus reload the scource directory (active directory window) when rhw command terminates. Run asynchronously: Indicates that the commands are to be launched as a new process, and Directory Opus is not to wait for it to return. If this is the case, and an output window is specified, the output window opens on the Workbench screen. Workbench to front: Causes the Workbench screen to be brought to the front. Three fields at the lower right allow you to specify stack size, priority and output window close delay. Stack size: The stack size is the size (in bytes) that external programs will use as stack space. The default and minium is 4000 bytes. The documentation of the program you are running should advise you of the best stack size to use. Priority: The priority field allows you to determine the priority at which the programs will run. The default is 0. You should not normally use anything lower than -10 or higher than 10, execpt for certain programs (the documentation of the program may advise you of appropriate priorities. Close delay: This field is the number of seconds after the commands have finished before the output window closes (if one is specified). The default is 2, which means that the output window will close two seconds after the commands have terminated. If you set the close delay to 0, the output window will close immediately. If you set it to -1, it will wait for you to press the left mouse button before closing. 3. 6. 2 Edit menu: If you move the mouse to the top of the screen and press the right mouse button, you will see that the main configure menu has been replaced by the edit menu. The options in this menu operate on the currently displayed command list. This includes the flags and fields. All screens with a command editor contain the edit menu with cut, copy, and paste functions. These allow you to swap function definitions between custom buttons, menus and file types. Cut: Copies the settings of this command list to the clipboard then erases them, resetting all fields to their default settings. Copy: Copies the settings of this command list to the clipboard, but will leave the values untouched. Paste: Displays a list of all command clips in the clipboard (if there are any present). If you select an entry from this list, it will be pasted into the current command replacing any information that was there already. Erase: Resets all fields to default settings, erasing the command list. The command will not be copied to the clipboard. Clear clips: When you use the cut and copy edit menus, the commands are stored in the file t:configopus. clip. Clear clips deletes this file causing all previously clipped commands to be cleared. 3. 7 Drives/manager: The drives button configuration screen allows you to configure the drive buttons. These buttons give you quick and easy access to device or directory. There are 30 drive buttons, arranged in five banks with six buttons in each. The drives configuration screen displays all 30 drive buttons at the top. There are ten buttons across the bottom of the screen. Some of these buttons stay selected when selected with the left mouse button. For instance, copy bank will stay selected, reminding you that you are now in copy bank mode. To leave this mode, select copy bank again. The buttons below that work in this fashion are: copy bank, swap bank, delete bank, sort bank, copy drive and delete drive. Get drives: Causes to be assigned to the names of all the devices and assigned directories (the first 30 present) in your system. You would normally only do this when performing a major reconfiguration. Copy bank: Copies one drive bank onto another. Select any drive button in the drive bank to copy, and then any drive button in the destination bank. Swap bank: Allows you to exchange the contents of two drive banks. This works the same way as the copy bank button. Delete bank: Erases the contents of a drive bank. If a drive bank has no buttons defined in it, it will not be displayed on the main Directory Opus screen (i. e. Directory Opus skips over unused drive banks). In fact, if you delete all the banks, the drive banks will not even be shown on the main Directory Opus screen. This allows the main custom buttons to be wider. Sort bank: Alphabetically sorts the contents of a drive bank. Select any drive button in a bank and that bank will be sorted. Copy drive: Copies one drive button onto another. Select the derive button to be copied, then select a drive button to copy it onto. You can abort the copy by turning off copy mode, selecting copy drive again, or selecting the copied drive button a second time. Swap drive: Swaps two drive buttons. This works the same way as the copy drive button execpt that it exchanges the two drive buttons. Delete drive: After asking for confirmation, resets all the data associated with a drive button. The last two buttons on this screen (lower right corneer) are the okay and cancel buttons. These allow you to say ok, lets use all these drive button changes and go back to configopus main screen, or oops!forget all this, and lets just leave. 3. 8 Drives/editor: When you select a drive button from one of the banks, the drives editor will appear or be updated with that drive buttons information. The drives editor will be displyed directly below the drive banks. Name: This field allows you to modify the name that appears on the drive button. The name field is limited to fifteen characters. Path: This is the actual Amigados path that is read in whenever this drive button is selected. The path field is limited to 256 characters. Shortcut key: Is a display area for the keyboard equivalent for this drive button. Sample: To modify the shortcut key, select the sample button. While the sample button is selected, any keys, along with any qualifiers, you press will be inserted in the shortcut key field. To turn off sample mode simply select the sample button again. To remove the shortcut key simlpy select the sample button with the right mouse button. 3. 9 Filetypes/manager: A file is simply stored data. Files can contain executable programs, iff pictures, icons for Workbench, or a multitude of other kinds of data. Most (but not all) files have an identifiable structure. Directory Opus filetypes system is designed to examine a files structure and identify the kind (or type) of data it contains. You can configure Directory Opus to understand an unlimited number of filetypes. Filetypes are a versatile feature of Directory Opus. Using filetypes, you can configure Directory Opus to play animations when they are double clicked, to load a database program when you attempt to read a database file, or to uncompress an archived file when you click m click on it. This is the essence of the filetypes:when you do something to a file, Directory Opus can figure out what kind of file it is, and take the appropriate action for that type of data. There are two sections to the filetypes configuration: Filetypes: There is a list of filetypes which is searched when an action occurs. If the file being processed matches a filetype, you can configure Directory Opus to perform a specific action. File classes: There is a database of file class definitions: each describes the process of matching a particular kind of file. Directory Opus comes with more file classes than you will probably use. You can select from this list when you are creating a new filetype entry. you dont have to be an expert or know anything about the internal structure of the file to do this. The file class manager, described in the next section, allows you to edit existing file classes, or define new ones. (This can be somewhat more complicated. ) 3. 9. 1 Filetypes: The filetype configuration screen displays the list of filetypes that Directory Opus recognizes. by default, it recognizes lha archive, Arc arcive, Zoo archive, and Workbench icons. There are five buttons across the bottom of the screen. Some of these buttons when selected with the left mouse button stay selected. For instance delete will stay selected indicating that you are now in delete mode. To leave this mode simply select delete again. Both the delete and swap buttons work in this fashion. New: This allows you to create a new filetype entry based on a predefined file class. When you select this button a requester appears containing currently defined classes. To create a new entry for one of these file classes simply select it and you will be brought to the filetype action editor (described below). Swap: This button allows you to exchange the positions of two filetypes in the list. This can be very useful or even neccessary. In the case of having two filetypes defined in which one is a sub-set of the other, e. g. 24 BIT ILBM pictures vs regular IFF ILBM pictures, you would want the 24 bit ILBM pictures to come first because they are a special case of the regular IFF ILBM picture filetype. otherwise, pictures (in this case) will be matched with the regular IFF ILBM picture filetype and will never have a chance to match with the sub-set 24 bit ILBM picture filetype. To actually perform a swap, click on the swap button to enter that mode. Click on the first filetype, then on the second. Those two filetypes will exchange places in the list. To exit swap mode simply press swap a second time. Delete: In this mode you can select filetypes to remove from the list. Click on the delete button, then click on the entries you wish to delete. If you accidentally delete an entry, click on the cancel button. Okay and Cancel: These buttons allow you to say ok, lets use all these filetype changes and go back to configopus main screen, or oops! forget all this and lets just leave. To edit a filetype, make sure you are not in swap or delete mode. Then simply select it. You will then be taken to the filetype editor screen. 3. 9. 2 Menus: There is an additional menu on this screen which controls file classes. Please refer to the section on file class manager for information about this menu. 3. 9. 3 Editing an existing entry: To edit an entry in the list, simple click on it and you will be taken to the filetype editor (described below). 3. 10 Filetypes/editor: This editor allows you to define the actions taken on a matching filetype. In a preceding section, you learned to configure an action when a custom button is selected. Essentially, you say "when this button is clicked do this. ". In the filetypes editor, you say:"when i do this to this particular filetype do that. " The primary difference is that a custom button can only be activated by being clicked on; the functions available for editing filetypes can be activated in several ways. Events: At the top of the filetypes editor is a list of event types, which are instructions you amy choose to directory opus regarding filetypes. Each of these events is associated to either a mouse action or a Directory Opus command, so each entry on the list is tagged either action or command. An asterisk * indicates that entry already has an event command list defined for it. Clicking on an entry in the list highlights it to show that it is the command list currently being edited. The current command list is displayed in the editing list in the middle of the screen. The small field immediately above it describes the event. While each of these event types can be defined to do something, usually only a few are actually defined. It certainly is not neccessary to define all events for a filetype. When one of these is activated, Directory Opus does the following: It first searches the filetype list, starting with the first entry, and checks whether it matches the entrys file class. If it matches, it looks to see if the corresponding event is defined from this editor. If it is defined, it performs the command list. If it does not match the file class, or if it matches and does not have a command list defined, it continues to search the filetypes list. It is possible for it to match a subsequent entry that does have a command list defined. 3. 10. 1 Mouse action events: Mouse events occur when you either double click on a file or perform a click m click. Double click: This occurs when you double clicck on a file. A popular use of this is to examine a file (e. g. , show it if it is a picture or play it if it is a sound). The actual double click speed is defined by the operating systems preference program. Clicl m click: This event occurs when a file is clicked on then the mouse is moved to the other window and clicked. One popular use of this event is for archive extracting. Another way this event can happen is by using click drag release. With this you literally drag a file into the window and drop it there. 3. 10. 2 Command events: Command events are called when a file is acted upon by a Directory Opus command. For example, when a read command is performed on a file. Directory Opus will search for a filetype which matches the file and has a read event defined. You could, however, have read do something special for an archive (i. e. list the contents of the archive). Likewise if you have a music score you could define the play (or loop play) to call up your player for that music score. Each of the following command events is associated with a corresponding Directory Opus command. This allows you to redefine the specific action taken for a particular filetype. By convention you should use a command event for something similar to its normal use, but there is nothing to stop you from giving a command event a label that is totally irrevelent to its use. Its up to you to keep the context of the command (i. e. a read would would be confusing if it did a disk format). The following list describes the normal usages. You can decide what you want it to mean for any given filetype. ANSI read: Fancy text viewer. HEX read: Binary or hexadecimal file viewer. Loop play: Normally associated with playing sounds in loops Play: Playing sounds. Read: Simple text viewer or viewing contents of archives. Show: Picture viewer. User events: The terms user1, user2, user3, and user4 may seem cryptic, but they are here to give you flexibility. Each of the preceding commands has an implied usage, but you may have an application which doesnt realy mean any of these. In that case, you can decide that one of these user events means "perform this special operation". Directory Opus default configuration employs user1 for extracting from archives. Edit class: The button to the far right of the list allows you to modify this filetypes class definition. Ee will talk about editing file classes in the file class section. Below the list of events associated with this filetype is a field describing this particular event. For instance you could have the read event say something like "reading file... ". this message will appear in Directory Opus title bar when the event is being performed. The remaining part of this requester is described in the command editor section. 3. 11 File class/manager: File class management is handled by a menu accessible from the filetype manager screen then offers management tools and storage optoins: New: Selecting this menu option allows you to create a new file class definition. Edit: This will open a requester showing you all the currently defined file classes. To pick one to edit, simply select it; you will then be brought to the file class editor. To abort press cancel. Once you have made a filetype entry based on a file class definition then you must use the edit class button on the filetype editor screen. When you make a filetype, it uses a copy of the file class in the actual filetype entry. This has several important results. once a filetype is made, you can edit its file class definition without changing the original definition. The edit class button on the filetype editor allows you to do this. Selecting edit from the classes menu allows you to edit the original file class definition. This will not automatically update any filetypes which used the original definition. You can even delete the original file class without affecying a filetype which used it. Duplicate: This allows you to create a new file class based on an already defined file class. Delete: This will bring up a requester allowing you to select a file class to clear from memory. Simply select the file class to delete and respond yes to the confirming requester. Press cancel to abort deleting. Open: With this you can inport file class definitions from a file. Save: Save the current file classes to their default place on disk. Save as: Save the current file classes to a specific file on disk. Clear: Clear all file class definitions from memory. 3. 12 File class/editor: Selecting new, edit, or duplicate from the filetype manager screen or clicking edit class button on the filetypes editor brings up the file class editor. This screen is the most complex section of configopus. It even looks scary, but dont worry: it is rather simple once you get to know it. The best way to describe this screen is to start at the top and go down from there. File viewer: The field at the top of the screen is simply a file viewer. To view a file, type its name into the field or click on the magnifing glass to bring up a file requester. The file selected will appear below the field. It will be displayed in hex/ascii format similar to the hex read command in Directory Opus itself. You may wonder why we have a file viewer on this screen. We have found that when creating a new file class definition it is usful to a way to look at files, since you are trying to describe to Directory Opus a way of identifying files. To the right of the file viewer is a button that cycles from decimal to hex. This button tells configopus in what format to display the position and offset information in the two read-only fields below the cycle button. The simplest way to show how this all works is with an example. Select the file c:ed (by either typing into the field or using the magnifying glass file requester). The format of the data in the fileviewer is as follows: the first column is the address into the file we are looking at. The next four columns are 16 bytes of data from the file in hexadecimal format. The last column is simply those 16 bytes in ascii format. Where there is a byte that is 00 or nul we display it in ascii as a period. Position your mouse pointer over the "f3" characters and press the left mouse button. A cursor will appear and the position read only field will be filled with "000000003". This means that the cursor is positioned on the forth byte in the file (remember byte locations are zero relative, that is, first byte is at location zero). If you click the cycle button above the position read only field and change it to hex then the position will be filled in with "$00000003" which is hexadecimal for three. You can move the cursor around in the file with either the mouse pointer (simply select another place in the file) or the cursor keys. Now double click on those "f3"characters. This time the characters change colours. They are now the position from which offsets are computed. Move the cursor by pressing the down key a few times and you will notice the offset read only field contains the offset from the double click position. 3. 12. 1 File class editor Components: Thats about it for the file viewer part of the file class editor screen. Now we go off to the real power house of Directory Opus. File class: The field below the file viewer is for the name of the file class. This is for the name of the file class. Class id: The class id will appear beside the filetype in the filetype manager screen and is a shorthand way for Directory Opus to write the name of the file class. Underneath the fields is the file class identification definition. This is a series of actions that Directory Opus will perform in order to identify a file class. The action may be as simple as matching a filename to a pattern or as complex as scanning an IFF form looking for data in a specific iff chunk. Below the list is a magnifying glass, a read only field and an argument field. These are used for editing the file class identification definition. New entry: Creates a new entry in the file class definition script. Duplicate: Duplicates the current file class definition script line. The copied line is inserted after the current line. Swap: Lets you swap the position of two file class definition script lines. Delete: Will let you delete the current line. 3. 12. 2 Editing: To edit a line simply click on it, and the read only and argument fields will be filled in. To change the command in the read only field, click on the magnifying glass button and a list of other commands will be displayed. Select the one you want or press cancel to abort. The general structure of the file class definition script is that there is a clause or a sequence of clauses that describe what should be considered a matching file for a given filetype. There are only two directives that delimit clauses:and and or. They are used to tell the system what to do if a clause fails or succeeds. When all the clauses are finished and the result is true then the file is of the right type. 3. 12. 3 File class edit commads: And: If the preceding clause succeeds, then also do this clause; otherwise skip to the next clause. If the preceding clause executed did not succeed, then execution stops and the file does not match. Or: If the preceding clause fails then do this clause; otherwise skip to the next clause. 3. 12. 4 Testing directives: This states that a sequence of bytes starting at the current file offset must match the given pattern. To match a single unknown chatacter when text is given, use the ? character. To match a single unknown byte when $HEX is given use two of them (??). You can also use \000 syntax to specify ASCII characters by their decimal number. A \009 would be a tab character, a \114 would be the lowercase r. Example: Match $000003f3 (executables start with these bytes) Match form????ilbm (the way an iff ilbm picture starts) Match hey\0090overthere ("hey"then a tab then "overthere") Matchbits: Match bits hsparwed This tests the files protection bits. To see if a bit is set, put a + before the character. To see if the bit is unset use the - . Example: Matchbits +rw read write must be on, others dont matter. Matchbits -e executable must be off, others dont matter. Matchbits +rw -e read, write must be on and no executable. Matchcomment: Match comment text: Simply compare the text given against the comment of the file. Any valid amigados wildcard pattern is usable here. Example: Matchcomment silly_picture (file with silly_picture as a comment) Matchcomment #?eddie#? (any file with eddie in its comment) Matchdate: Matchdate dates: Test the date of the file against a date. For information about datestrings or ranges see the select command later in the manual. Example: Matchdate 08-sept-92 Matchdate < 10-jan-92 Matchname: Matchname filename: The filename must match the character pattern given. Any valid Amigados wildcard pattern is usable here. Example: Matchname #?. ilbm. Matchname *. lzh Matchsize: Matchsize > or < or = integer: Test the size of a file against a value. Example: Matchsize > 1000 3. 12. 5 Movement directives: Moveto: Moveto byte location: Move to a specific byte offset from the begining of the file. Initially you are always at the begining of the file, but you may have been moved in a previous clause, so you might want to put a moveto at the begining of a clause in order to know exactly where you are. Example: Moveto 0 (back to the begining of the file. Moveto 100 (move to the 101st byte of the file) Move: Move byteoffset: Move to a byte relative to the current file offset. Example: Move 16 (move sixteen bytes forward into the file) Move -4 (move back four bytes from where we are) Searchfor: Searchfor text or $HEX. Search (starting at the current file offset) for a certain byte pattern that matches the given pattern. See the match command for valid options for this directive. If the match occurs, then the current file position will be the first character matched. Example: Searchfor cmap (look for the "cmap", position on the "c") Searchfor m. k. (search for m. k. , position on the "m") A failure of ant movement directives causes the clause to fail. Example: One example of usage is the field class 24bit picture. Example: Match form????ILBM (file must start with these characters) and (if the previous cause is true then do the following) searchfor bmhd (then search for the bmhd chunk id) move 16 (moves sixteen bytes into the file) match $18 (this must be 24 (or $18 in hex) to be a 24bit picture. ) We would suggest looking at the predefined file classes to get an idea of the type of thing you can do with this system. 3. 13 Hotkeys/manager: Directory opus can have an unlimited number of hotkeys defined. hotkeys are systematic global key definitions. These keys are available from every application you run, as long as Directory Opus is running or iconified. If Directory Opus is busy doing somthing else (i. e. , copying files etc. ) then the keys operation will start up as soon as Directory Opus has finished. Under 2. 0, hotkeys are implemented via commodities and are controlable via the commodities exchange program (see amiga 2. 0 manual). There are six buttons across the bottom of the screen. Some of these buttons stay selected when selected with the left mouse button. For instance, delete will stay selected to remind you that you are now in delete mode. To leave this mode, select delete again. The buttons below that work in this fashion are: duplicare, swap and delete. New hotkey: Takes you to the hotkey editor so you can define a new hotkey. Duplicate: Duplicates a hotkey. you can abort the copy by simply turning off duplication mode, selecting duplicate again. Swap: Allows you to swap the order of two hotkeys. Remember that the first hotkey is seen first, so if you have two hotkey entries defined to the same key sequence, only the first one will be seen. Delete: After asking for confirmation, this deletes hotkeys. 3. 13. 1 Menus: The default or open menu items in the configure menu allow you to import hotkeys from either the default configuration or a configuration file from disk. To edit a hotkey, make sure that you are not in duplicate, swap or delete mode, then simply select it. You will then be taken to the hotkey editor screen. The last two buttons on this screen (lower right corner) are the okay and cancel buttons. These allow you to say, ok lets use all these custom button changes and go back to configopus main screen, or oops! forget all this, and lets just leave. 3. 14 Hotkeys/editor: Name: This field is simply a nane for the hotkey and can contain anything. Directory Opus only uses this as a label so that you will know what the hotkey does. Hotkey: Is a display area for the hotkey sequence. It shows the defined hotkey or is empty if one has not been defined. Sample: To modify the hotkey, select this button. While the sample button is selected, any keys, along with any qualifiers you press will be inserted in the hotkey field. To turn off sample mode, select the sample button again. To clear the hotkey sequence simply select the sample button with the right mouse button. The remaining part of this requester is described in the command editor section. 3. 15 Menus/manager: This section allows you to configure the menus. There are 100 custom menu items, arranged as five menus of twenty items each. The menu configuration screen displays the five menus, with the menu titles at the top. All the menu items in each menu strip are not displayed at once; because space is limited on the screen, only a certain number are visable at a time. To move through the menu items, use the slider at the right of the screen. There are ten buttons across the bottom of the screen. Some of these buttons stay selected when selected with the left mouse button. For instance, delete item will stay selected to remind you that you are now in delete item mode. To leave this mode, select delete item again. The buttons below, that work in this fashion are:copy menu, swap menu, delete menu, sort menu, insert item, copy item, swap item and delete item. Copy menu: Copies the contents of one menu to another. When you have selected this option, select a menu item in the actual menu you wish to copy, and then a menu item in the menu you want to copy the first menu to. Swap menu: Swaps the contents of two menus. It works in the same way as the copy menu function, except that the contents of the second menu are exchanged and not replaced. Delete menu: Removes all functions from one of the five menus. Select a menu item in the appropriate menu; a requester will appear to verify the operation. If you select okay, the contents of the menu will be deleted. Sort menu: Sorts the contents of each selected menu alphabetically by name. Insert item: Allows you to insert a new item between two existing items. Select the item in front of which you want the new item to be inserted. Copy item: Allows you to copy one menu item to another. When you have selected this option, select the menu iten to copy, and then the menu item to copy it to. Swap item: Allows you to swap two menu items. It works in the same way as the copy item function, except that the second item is exchanged and not replaced. Delete item: Deletes menu items. Select the menu item you wish to delete. All menu items below it will be moved up to fill the empty space. The default or open menu items in the configure menu allow you to import menus from either the default configuration or a configuration file from disk. To edit a menu item, make sure you are not in copy menu, swap menu, delete menu, sort menu, insert item, copy item, swap item or delete item mode. Then simply select it, and you will be taken to the menu item editor screen. The last two buttons on this screen (lower right corner) are the okay and cancel buttons. These allow you to say ok lets use all these custom button changes and go back to configopus main screen, or oops! forget all this and lets just leave. 3. 16 Menus/editor: At the top of the menu item edit screen is an example of what the current menu item looks like. The palettes on either side of the example allow you to select the foreground and background colours of the menu item. Name: This field alows you to modify the name that appears on the menu item, and is limited to 63 characters. Shortcut key: Is a display area for the shortcut key sequence. The shortcut key gives the keyboard equivalent of this menu item. Sample: To modify the shortcut key, select this button:any keys, along with any qualifiers you press will be inserted in the shortcut key field. To turn off sample mode, select the sample button again. To clear the shortcut key sequence simply select the sample button with the right mouse button. The remaining part of this requester is described in the command editor section. 3. 17 Operations: The operation configuration screen gives you complete control over the way each of the listed operations is performed. You can cover any contingency by specifying precisely how you want each operation to be carried out in any situation that might arise. When you select one of the buttons to the left of the screen, requesters will appear, asking you how to proceed. Copy: This button allows you to check the amount of space available for copying files and directories, and to set the archive bits once the copying is finished. You are able to choose which parts of the file information need to be copied. You are also given options to consider if the file being copied already exists in the destination. Date format: With this button you may choose between the Amiga systems default or three other formats for displaying the date. Delete: Without the reminders that this button summons, you might lose some very valuable information. Error check: You may choose either dos requesters or the more comprehensive Directory Opus error requesters when you select this button. General: This button displays miscellaneous flags that are detailed in the operations/general subsection. Icons: With this button you may decide whether to create a drawer icon, whether each files icon undergoes every change that befalls its file, and whether an icon is selected automatically with its file. List format: The screen summoned by this button gives you control of the format of the lists in both screens. Update: This button ofrfers various features that are detailed in the operations/update subsection. 3. 17. 1 Operations/copy: When copying files and directories: Check destinations free space before starting: This causes Directory Opus to check that the destination directory has enough free space in it before attempting to copy selected files and/or directories. If Directory Opus does think that all selected entries will fit in the destination directory, it will alert you with a requester, and give you the option of abandoning the copy process. If any selected directories do not have sizes displayed for them, Directory Opus will ask you if you wish it to perform a byte count on these directories before seeing whether or not they will fit. Set archive bit of scource after finishing: After Directory Opus copies a file, the original file will get its archive bit set to true. This means that the file has been archived. Also copy scources... : These flags tell directory opus that when it copies a file, it must also copy these parts of the file information aas well. You can have all, none, or any combination of these selected. Datestamp: Protection bits: Comment: What to do when a file already exists: These flags tell directory opus what to do if a file that is being copied already exists in the destination. Only one of these may be selected. You have four options: Always replace files: Replaces the original file regardless. Never replace files: Will never replace the original file. Replace only older files: Replaces the original file only if the file to be copied has a more recent last modification date. Ask before replacing: Asks the user what to do if the file already exists. 3. 17. 2 Operations/date format: Date format: This tells Directory Opus how to format dates. The Amigas operating srstem uses the first (dd-mmm-yy) by default, but you may choose whichever one you prefer. dd-mmm-yy (22-sept-92) yy-mm-dd (92-09-22) mm-dd-yy (09-22-92) dd-mm-yy (22-09-92) Misc flags: Name substitutiuon (today, tomorrow, etc): Causes words like today, tomorrow or tuesday to be substituted for a date, if appropriate. 12 hour clock: This allows you to choose whether the clock format used by Directory Opus be displayed in 12 hour or 24 hour format. 3. 17. 3 Operations/delete: Ask before: Commencing delete: Tells Directory Opus to check with you before actually starting to delete. This is rather a useful everyday option because its always better to be safe than sorry. Deleting files: Tells Directory Opus to ask for confirmation before deleteing every file. Deleting non-empty directories: Tells Directory Opus to ask for confirmation before deleting directories that have items in them. Misc flags: Ignore the delete protection bit: When deleteing, this sets the delete protection bit on all files that do not have it set. This means that the files protected against deletion will be deleted anyway. 3. 17. 4 Operations/error check: Enable: Dos requesters: Disables Amigados requesters that would appear on the Directory Opus screen (disk is write protected etc. ). instead, you will only see an error message appear in the Directory Opus status bar. Opus error requesters: Causes Directory Opus to open its own error requester when an error is encountered. This requester contains more information than the standard Amigados. 3. 17. 5 Operations/general: Misc flags: Click-m-click drag: Drags files or directories. To drag a file you must (holding down the left mouse button) move the mouse to the left or right of the file. Do not move up or down until the selected file has been lifted as this would initiate drag-selecting. You can also press the right mouse button while holding down the left to initiate dragging. If you drop the file in the other directory window it will be the same as click-m-clicking. If you drop the file on a custom button at the bottom of the screen that buttons action will be performed. Display info: Makes Directory Opus behave as it did in version 1, by displaying a files protection bits, datestamp and commet in the status bar. Directory opus now displays these in the directory windows, and keeps a count of selected files, etc. in the status bar instead. If you prefer the old style display, turn display info on. All file information will be displayed in the status bar as you select entries, as well as in the directory windows. With this turned on, you can use the byte command to view the count of selected entries. File double-click: Directory Opus will interrogate a file that is double clicked on with the left mouse button, and will perform the default action for that file type. You may your own filetypes, and specify what action is to be performed on them. However, there are also several hard coded filetypes. These are IFF ILBM pictures and brushes, icons, fonts, IFF 8SVX sounds, and executable programs. If a file does not match any of the user defined filetypes, it is checked to see if it is one of the hard coded types. In that case, the default action for these filetypes is performed. If a file does not match any filetypes user-defined or otherwise, it is treated as a text file, and loaded into the text viewer. If any ansi control sequences are detected, these will be displayed correctly. If the file contains any non-text characters, it will be read in hexadecimal format. Window slider activate: Causes a directory window to become active whenever its sliders or arrow buttons are selected. If this option is not enabled, selecting the sliders or arrow buttons of a directory will not cause it to become active. 3. 17. 6 Operations/icons: Misc flags: Create icons with directories: Creates a drawer icon whenever you create a directory with the makedir command. Perform all actions on icons as well: Whatever happens to a file will happen to that files icon as well. For instance, if you delete the file data, data.info (if it exists) will be deleted too. If you rename the file frog to buffalo, the frog.info (if it exists) will be renamed as buffalo. Info automatically. Select icons automatically: Has similar results to perform all actions on icons as well, except that whenever you select a file, its associated .info file (if it exists) is also selected. 3. 17. 7 Operations/list format: Format of the list in the: Left window: Right window: The cycle button specifies which directory window you are modifying. This allows you to have different list formats in each window, but it does require you to specify the format for each window. If you change the format (using the buttons described below), and you want it to be the same for both windows, dont forget to click on this button and make the corresponding changes to the other window. Available display items: This list allows you to add display items to the selected display items list by clicking on them. An item can only be added once, so if you click on an item that is already in the list, nothing will happen. The available display items are: File name: File size: Protection bits: Creation date: File comment: File type: Displayed lengths: The fields allow you to adjust the width of some these items. The adjustable lengths are: File name: File comment: File type: Selected display items: When you select an item from the list of available display items. It appears here. This allows you to specify exactly what to display. When you select an item in this list, it places a check mark next to it. This indicates which item to sort the window list on. Clicking on the checked item unchecks it. If no items are checked then the directory window will not be sorted. Reset: This button causes the list to reset to the factory default settings. Clear: The left mouse button clears all entries, allowing you to start all over again. The right mouse button clears the last entry in the list, allowing you to correct a mistake. Entry separation: This cycle button allows you to specify how directories and files are sorted. Directories first: Files first: Mix files/directories: Reverse sorting: This specifies that the list should sort in reverse order. For instance instead of a coming before b, b would come before a. 3. 17. 8 Operations/update: When processing files: Makes Directory Opus open a progress indicator window when it is processing files. Left justify filename in status bar: Left justifies filenames in the status bar rather than centering them as usual. Scroll directory window to follow operation: Causes the directory windows to scroll, ensuring the visibility of the current entry being acted upon in an operation. The display is returned to its original position when the operation is complete. Update free disk space: Causes the free space display in the disk name display at the top of the active directory window to be updated whenever a file is copied or deleted from the directory. Otherwise, the display is only updated at the end of a complete operation. Misc flags: Directory refresh using startnotify 2. 0 os only: Sets up automatic notification of the currently visable directories. If the directories are modified outside Directory Opus (i. e. , by another program), Directory Opus will automatically re-read the directory to reflect the changes. Warning while this feature works in many circumstances, the current versions of 2.xx and 3.xx of the operating system have a bug preventing this from being completely useful. Currently the operating system does not notify us to all events, but we have left this option in place so when the bug is fixed Directory Opus will be ready. Redraw more than a quarter of a page: Causes Directory Opus to redraw the window if you move more than a quarter of a page in either direction. This flag can greatly speed up movement through directories. Ordinarily, if you use the sliders to move a directory less than a complete page in either direction, the directory window will scroll one file at a time. It is only if you move a complete page or more at once that the window will actually be redrawnn. Although not as pleasing aesthetically, redrawing is considerably faster, especially in high resolution modes. 3. 18 Screen: The screen configuration screen allows you to modify the appearance of the screen to suit your needs and preferences. Requesters concerning the screens features will appear when you click on one of the buttons at the left side of the screen. Arrows: Allows you to specify where the arrows on the sliders used by Directory Opus will appear. Colours: Allows you modify the pen colours of almost all the components of the Directory Opus screen. Fonts: Allows you to specify the fonts used in different parts of Directory Opus. General: Allows you to specify various options for the screens appearance. Palette: Allows you to set the colours of the Directory Opus screen. Screen mode: Allows you to specify the mode, size and depth of the Directory Opus screen. Okay and cancel: These allow oyu to say either ok, lets use the screen settings and go back to directory opus, or oops! forget all that, and lets get out of here!. 3. 18. 1 Screen/arrows: This screen allows you to specify where the arrows on the sliders used by Directory Opus will appear. There are three choices for each of the three slider types. You can also adjust the size of the arrows. The easiest way to learn how to use this is just to play with it. Select the slider type by clicking on it, or cycle through the types by clicking on the cycle button. The selected slider type will be highlighted. Adjust size: These buttons allow you to adjust the width of the arrows in the selected slider type. You can certainly make these huge if you want. 3. 18. 2 Screen/colours: This requester allows you to modify the pen colours of almost all the components of the Directory Opus screen. The number of colours to choose from are specified in the screen/screen mode: and the colour palette is specified in screen/palette. A mock up of the Directory Opus screen is shown, to allow you to see the results of your colour changes. To select the item you want to modify, either click on it in the example box, or click the cycle button at the top of the screen to advance to the next item. To modify the colours of an item, use the foreground and background palette boxes. Note that OS 1.3, you cannot modify the colour of some items. 3. 18. 3 Screen/fonts: The screen/fonts requester allows you to specify the fonts used in different parts of Directory Opus. when this option is selected for the very first time, there will be a delay while Directory Opus looks to see which fonts exist in the system. Display item: The items for which you may configure a font are displayed in this list. Clicking on an item displays the currently selected font and size in the font and size lists. You can then use these lists to select the desired values for the display item. Font: This list contains the list of available fonts. The selected font for the display item is highlighted. Click on a font name to change the selected font. Size: This list contains the sizes available for the currently selected font. The selected size is highlighted. Click on a font size to change the selected size. An example of the currently selected font and size will be displayed below these lists. Some display items accept non-proportional fonts, and others only accept 8-point fonts. The list of available fonts will change to filter out unaccepttabel fonts. Note that under os 1.3 you cannot use a different font in the pathname field. Setting the pathname to a larger font will make the pathname field larger, but under os 1.3 the string fields will still use the general 8 point font. 3. 18. 4 Screen/general: This requester allows you to specify various options for the screens appearance. Visible screen title buttons: Makes the close and depth buttons of the title bar visible on Directory Opus sceen. Bottom right tiny buttons: Makes the tiny buttons in the lower right of Directory Opus screen visible. Button bank sliders: Makes sliders appear beside the drive and custom button banks. These make it easier to scroll through the banks. Indicate button has rmb function: All buttons with right mouse button function will have a dog-eared upper right corner. New look sliders: The sliders adopt the new style of operating system 2.0. Draggable requesters: All requesters will have a window title bar allowing you to move it. 3. 18. 5 Screen/palette: The screen/palette requester allows you to set the colours of the Directory Opus screen. a palette box is displayed, allowing you to select the colour to modify. You can change the colour by using the sliders to adjust the red, green and blue components. You can also enter colour values directly, using the string fields. Presets: There are also several preset colour palettes available, which you can select just by clicking. The reset entry will return the colours to the values they had when you entered this section (an undo feature basically). The Directory Opus default entry sets the default Directory Opus palette. the Workbench default entry has the default Workbench colours. The Workbench current entry is the colours currently set on the Workbench screen. The other presets are diffeerent settings which you can experiment with at your own leisure. 3. 18. 6 Screen/screen mode: The screen/screen mode requester allows you to specify the mode, size and depth of the Directory Opus screen. Display mode: Contains a list of the available display modes. Under OS 1.3 this will contain high res, high res laced, Workbench:use and Workbench:clone. under os 2.0 the modes available will vary depending upon the monitors currently active in your system. The characteristics of the selected display mode are shown at the bottom of the screen. There are two special items on the list. Workbench use: Causes Directory Opus to open a window on the Workbench screen, and not to open a custom screen. The width and height of this window are editable, but the number of colours is fixed at the current Workbench depth. Workbench clone: Causes Directory Opus to open a screen in the same mode and exactly the same size as the Workbench screen. The size of this screen is not editable, but you may modify the number of colours. Width: This field allows you to specify the screen width. Use default: When this button contains a check, the width field can not be changed. It will not be changed. It will, however, display the default value to be used. When you click on this button, it will allow you to change the value in the width field. (When you are using workbench clone, the use default button cannot be deselected. ) Height: This field allows you to specify the screen height. Use default: When this button contains a check, the height field can not be changed. It will, however, display the default value to be used. When you click on this button, it will allow you to change the value in the height field. (When you are using workbench clone, the use default button cannot be deselected. ) Colours: Depending upon the selected screen mode, the number of colours will vary from four to sixteen. There are screen modes with a maximum of less than sixteen; if this is the case, your selection will be limited. Half-height screen: This causes the directory opus screen to open at half its normal height, and to positioned halfway down the display. With an interlaced screen, this would give you a screen the size of a normal (non-interlaced) screen, with the screen behind it still bartially visible. Turning on the half-height screen option will not modify the systems screen height setting. 3. 19 System: The system configuration screen lets you tell Directory Opus how to run several operations. Amigados: Allows you to specify how directory opus starts up amigados programs. Clocks: Allows you to specify how directory opus displays clock information. Directories: Allows you to set various options for directory operations. Hotkey: Allows you to specify the hotkey to activate Directory Opus. Icons: Allows you to specify the icons which will be created with the iiicaddicon command. Modules: Allows you to specify preloaded external modules. Show pattern: Allows you to specify files to be shown or excluded from the directory lists. Startup: Allows you to specify various startup options. View and play: Allows you to configure options for directory opus viewers. Okay and cancel: These allow you to say either ok, lets use the screen settings and go back to directory opus, or oops! forget all that, and lets get out of here!. 3. 19. 1 System/amigados: This requester allows you to specify how Directory Opus starts up amigados programs. Running Amigados applications: Shell: This field is the amigados command used to launch programs that have output windows. It defaults to newcli. If you wish to use a shell, you could change the default to newshell. If you wish to use a wshell, you could change it to newwsh. The magnifying glass button to the left of this field opens a requester to help you locate the command you wish to use. Console: This is the console under which all output windows are opened. It is also used to open a cli by the newcli command, and by the run command when no files are selected. The console allows you to specify the size, position and title of the output window. It follows the standard Amigados format, namely: Device:leftedge/topedge/width/height/title/options. Device This is the device you are using. It is normally con, but under Amigados 1.3 it may be newcon (which will open a shell instead of a cli). Leftedge: The left edge of the window ( x coordinate, in pixels). Topedge: The top edge of the window ( y coordinate, in pixels). Width: The width of the window in pixels. Height: The height of the window in pixels. Title: The title of the window. Options: Some devices allow you to specify optional parameters (i. e. , /close). The valid parameters vary, so consult the devices documentation for details. An example is: Con:20/10/600/180/directory opus output/close. Start-up script: This is an Amigados batch script that will be performed before Directory Opus launches any programs. Priority: Main priority allows you to specify the priority at which Directory Opus itself runs. the default priority is 0, which means that it peacefully coexists with everything else. Setting the priority higher means that while Directory Opus will not be slowed down much by other tasks, the performance of other tasks will suffer. It is suggested that you set the priority no higher than 10. 3. 19. 2 System/clocks: This requester allows you to specify how Directory Opus displays clock information. Clock/memory bar: These flags tell Directory Opus how to format the clock bar at the bottom of its screen. You can include any combination of these items, but in some fonts you may not be able to see all the items selected because their space may be limited. Memory monitor: Displays the amount of chip memory, fast memory and the total memory in the clock bar. Cpu monitor: Displays the percentage of cpu time that is being used. 100% indicates that there is not any idle time and that at least one process is attempting to run continuously. Date: Displays the current date in the clock bar. Time: Displays the current time in the clock bar. Show free space as: There are two groups of buttons with this title. One applies to the clock/memory bar, and the other applies to the iconified window. They allow you to specify how the memory monitor, when enabled, will display memory. Bytes free: Displays all digits (this can be hard to read with large values). Kilo/megabytes free: Displays value in either kilobytes or megabytes as applicable. Text format: There are two groups of buttons with this title. one applicable to the clock/memory bar, and the other applies to the iconified window. They allow you to specify how the titles for the memory monitor, when enabled, will be displayed. The choices are:- Chip and fast: C and f: When iconified: These buttons allow you to specify how Directory Opus should act when iconified. Window: The following flags allow you to specify what is displayed in the window. Memory monitor: Date: Cpu monitor: Time: Directory Opus will iconify to a small window on Workbench. If this window is enabled, its last position is saved when you save the configuration file. To un-iconify the window, simply activate it by clicking on it with the leftmuse button and then press the right mouse button. No window: Directory Opus will close all windows. An appicon: directory opus will open an icon on workbench. Simply double click on the icon to uniconify it. 3. 19. 3 System/directories: This requester allows you to set various options for directory operations. Directory caches: Buffers per window: Allows you to specify the number of buffers to be allocated to each directory window. You can have any value from one to 255. Always move to empty buffer: Causes Directory Opus to use an empty buffer (if possible) whenever a new directory is read. A new directory is read whenever you enter a path in the directory fields, double click or click m click on a directory name, or select a drive button. Re-read changed or incomplete buffers: When a buffered directory is shown, this will make Directory Opus check the directory on disk to see if it has changed. If it has, this will cause a re-read of the directory. Also, if the original reading of a directory was interrupted it will be re-read in. Search buffers on: Parent/root operation: This option causes the directory buffers to be searched for the parent or root directory of the current directory, whenever the parent or root commands are chosen. If the parent or root directory exists in a buffer (i. e. , it has already been read), the buffered directory is retrieved from memory. This can save a lot of needless disk access. Double click/click-m-click directory read: When a directory is selected via double click or click-m-click this will cause Directory Opus to search the buffered directories first. Misc flags: Auto diskchange: Causes Directory Opus to sence disk changes in any drive. If you have the root directory open in either of the directory windows when you change the disk, then the new disk will be read automatically. This allows you to scan through different disks without having to follow the usual selection procedure. Auto disk load: This option works in a similar fashion to auto diskchange, except that it detects any disk being inserted, not just those disks currently being displayed. If you insert a disk in a floppy drive with this option turned on, you will be asked whether you wish to read the disk into the left or the right window. Expand pathnames: This flag will cause all paths to be expanded to their full pathnames. For example, if this flag was enabled and you entered s: in the directory field, the name might be expanded to workbench1.3:s/. It will also do this when when you select a drive button. for instance if you selected a drive button marked df0:, the actual name of the disk would be inserted in the directory field. You should note that ass the expand pathnames flag causes the actual volume name of disks to be used, the system (and you) may get confused when using two two disks with the same name. As a rule, you should avoid using identically named disks at the same time. Use exall():os2.0 only: If selected, Directory Opus will use the exall function to read directories, rather than the old examine ()/exnext() combination. exall() can be slightly faster than the old method. Warning: Operating systems 2.x nd 3.x currently have a bug that causes them to skip directory entries when using exall() on certain devices. Some devices to watch out for include: cd rom, parnet and networks. If you have problems, simply turn off this option. Show free space as: These allow you to choose how to measure the free space that is displayed alongside the disk name. Bytes free: Display the number of free bytes. Kilo/megabytes free: Displays the amount of free space in either kilobytes or megabytes (depending upon the size. Blocks free: Displays the number of blocks free (as will also be shown by the Amigados info command). Percentage of space free: Displays the free space as a percentage of the total size. 3. 19. 4 System/hotkey: This requester allows you to specify the Directory Opus activate hotkey. Uniconify/activate hotkey: This hotkey is really a combination of keys that you press to do one of four things: If directory opus is iconified, it will be uniconified. If the Directory Opus is open, but at the back of the display, it will be brought to the front. If the system has been pulled down using the screen drag bar, it will be brought to the top. If the screen is already at the front of the display, it will be moved to the back. Sample: To modify the hotkey, select the sample button at the right of the hotkey field. While the sample button is selected, any keys that you press, along with any qualifiers, will be inserted in the hotkey field. To turn off sample mode, select the sample button again. To remove the hotkey simply select the sample button with the right mouse button. The default hotkeys are control+lshift+lalt, meaning that pressing the control key, the left shift key and the left alt keys together will perform the action. Use middle mouse button: With this flag turned on Directory Opus will also use the middle mouse button as well as the hotkey defined above. 3. 19. 5 System/icons: This requester allows you to specify the icons which will be created with the addicon command. Addicons icons: This list includes three built in icon types: drawer, tool and project. in addition, each of the filetypes is included in this list. This system allows you to specify your own icons to use with the addicon command if you do not like the default icons. Simply select the type of iconyou want to change (e. g. , drawer, tool, etc. ), and its current icon will appear in the lower right corner. You may change the icon by modifying the field directly below the list. The magnifying glass button is provided to allow you to find the icon you want easily. Under OS 1.3 we provide some built in icon images but under OS 2.0 we use the system standard images. Projects default tool: Allows you to modify the default tool of project icons added with the addicon command. This only works with the built in project icon or the default workbench project icon; not with user supplied icons. For example, you may set the default tool to c:fullview. then, whenever you double click from Workbench on an icon that you have added to a project, fullview will be invoked. 3. 19. 6 System/modules: An external module is a small program which Directory Opus runs to perform infrequent operations. By making them external, they do not have to be in memory at all times. If you are not concerned with their memory usage and you dont want Directory Opus to load them each time you use them, this requester allows you to specify which modules you want to be preloaded. External support modules: Lists all external modules supported by directory opus. If you want a module to be preloaded, select it and a checkmark will appar. Select it again if you do not want it preloaded. Preloaded modules take less time to start up but use additional ram. Language: Allows you to select a language for Directory Opus. by default, directory opus uses the built in english language, but as other languages become available they will appear here. To select one for use, simply click on it. 3. 19. 7 System/show pattern: This requester allows you to specify files to show or exclude from the directory lists. Directory list pattern: Hide files with hidden bit set: Tells Directory Opus to take notice of the h bit; any files that have this protection bit set will not be displayed. Show: Allows a wildcard pattern against which all files are checked. if the file matches this pattern, it is displayed. Hide: Allows a wildcard pattern against which all files are checked. If the file matches this pattern, it is not displayed. 3. 19. 8 System/startup: This requester allows you to specify various startup options. Directories to be read on startup: These fields allow you to specify the path name of a directory that is loaded automatically into the left or right window whenever directory opus starts. The magnifying glass button to the left of these fields opens a directory requester to help you locate the path you require. Left: This field specifies the startup directory for the left window. Right: This field specifies the startup directory for the right window. Arexx scripts to execute on: These allow you to specify the name of two arexx scripts that are automatically run when directory opus starts (startup), or when it returns from an iconified state (uniconify). Startup: This arexx script is executed when Directory Opus first starts up. Uniconify: The uniconify arexx script is executed when Directory Opus is uniconified. CFG return: This arexx script is executed when directory opus returns from the configopus utility. 3. 19. 9 System/view and play: This requester allows you to configure options for Directory Opus viewers. Picture/animation viewer (IFF ILBM/anim): Balck background between pictures: This flag causes a blank screen to be displayed while each picture is loading. Otherwise, the Directory Opus screen will be displayed in between each picture. Start animation paused: Makes animation come up paused. This is particulary useful when an animation is simply a collection of pictures and not really an animation. 8 bits per gun colour: This tells Directory Opus to treat the colour information in IFF ILBMs as having 8 bits per gun. Pictures that have 4 bits per gun, per aga, are shown a little dimmer than usual. Show delay: Allows you to show pictures as a simple slideshow. If set to 0, pictures will wait for you to press the left mouse button before continuing. On other settings, the pictures will continue to display one after the other for the specified time in seconds. Fade delay: Allows you to configure the speed at which pictures fade in and out. If it is set to 0, there will be no fading at all. The default is 2; the maximum is 10. The value, by the way, indicates in 60ths (50ths on pal) of a second the time between each change in colour. Sound player (IFF 8SVX): Turn audio filter of for play: Causes the high pass audio filter to be turned off while each IFF 8SVX sound file is played. Note that on a1000s the audio filter may not be software selectable. Loop on double click: Tells Directory Opus to behave as it did in version 3. 4. In that version, when you double clicked on sounds, they played in a looped fashion. Under version 4.0 the sound is played only once. Text viewer: Text viewer borders: Tell the text viewer to have a silder and fancier borders. Note that with the fancier borders and sliders you may not be able to read text files that are 80 characters unless you use a smaller font or wider screen. Tab size: Allows you to specify the number of spaces to which a tab character is equivalent in the ansiread command. The default is 8, which is also the ansi standard. Chapter 4 Commands: This chapter lists the Directory Opus commands in alphbetical order. Lets begin with an example of an entrys layout, with its component parts explained as they occur. Command ARexx only: The name of the command comes first. If it is followed by the words arexx only it means that it is a command that can only be called from another program by using the ARexx intercommunication language. Otherwise, a command can be used both in a button (menu, hotkey or filetype) and as an arexx command. Command this is the syntax of the command. Elements in square brackets are optional. Below the syntax, its elements are explained in turn. If necessary, there will follow notes pertaining to the use of the particular command. All Directory Opus commands when called from ARexx respond with two variables: rc (the error status code) and result. RC will always be an integer value indicating the severity of an error, 0 being no error. Result will indicate success or failure of the command, usually expressed as an integer value, or it may be data, such as the name of a file. Abort print: Abort the current print process. ARexx results: RC= 0 Result = nothing was printing. 1 Somthing was printing but is now aborted. About: This command displays copyright information and mailing addresses. ARexx results: RC=0 Result = undefined Add cust entry: ARexx only: Addcustentry text [userdata] [fgpen] [bgpen] [selectable] [show] [before] Text is the text for the entry, and may be up to 256 characters long. The dimensions of the horizontal slider are adjusted automatically to the longest entry. Userdata optional; user data for this entry. This is not displayed but can be retrieved, defaults to nothing. Fgpen: Optional; pen colour to display entry in or -1 for default file colour, defaults to -1. Bgpen: Optional; backgroung colour of entry or -1 for default file background colour, defaults to -1. Selectable: Optional; indicates if entry is selectable (0= not selectable or 1= selectable), defaults to 1. Show: Optional; boolean to update directory display (0=do not update, 1=update), defaults to 0. Before: Optional; ordinal entry number before which to add this entry. a 0 adds the entry to the begining of the list -1 adds at the end of the list, defaults to -1. This is similar to the addfile command, but allows for entries of up to 256 characters. Entries added with this command are completely user defined. This command will fail if there are any normal entries already in the active window, so you should always call clearwin before using it. by default, entries are not sorted in any way; the most recent entry will be shown as the last. ARexx results: RC=0 Result =0 or 1 to indicate failure or success. Addcusthandler; Addcusthandler portname [win] Portname name of handlers message port. Win: Optional; window to add a custom handler to (-1= current window, 0=left or 1=right) defaults to -1. This command will attach an ARexx portname to the current directory buffer. When you manipulate the buffers entries, Directory Opus will pass messages to the special portname. This command is only used with buffers created using addcustentry. Currently the only two actions supported are double click and click-m-click. As an example, this system could be used to create a phonebook system or a network manager with Directory Opus. ARexx results; RC=0 Result= name of old handlers message port (if there was one) Addfile: Addfile name, size, type, seconds, comment, protection, reserved. show. Name: Name of entry. Size: Size in bytes of entry. Type: Type of entry (-1= file or 1= dir). Seconds; Datestamp of file, seconds from jan 1, 1978 (date that AmigaDos considers the begining of time) Comment: File comment. Protection: Protection bits in ascii form rw would mean readable and writable. Reserved: Reserved, must be 0 for now Show: Update directory display boolean This command adds a file or directory entry to the active directory window. ARexx results; RC=0 Result = 0 or 1 to indicate failure or success. Addicon: Addicon [name] Name optional; name of file. This will add icons to all selected files and directories in the active directory window. Directory Opus automatically senses what sort of file it is (drawer, project, tool, etc) and will arr the appropriate icon. Under os 2.0, however, we use the workbench default icons. you may specify your own icons in the configopus if the default icons are not suitable. You may also specify the default tool to be used for project icons. If the name is not given, it will use the first available selected item in the current directory window. ARexx results: RC=0 Result = undefined. Alarm: Alarm, this command will sound an alarm on both or either sound channels. You could use this command to warn people that they have selected a dangerous command. For instance, you could modify the delete button to read: Command alarm Command delete ARexx results: RC=0 Result= undifined. All: This command selects all files and directories in the active directory window. ARexx results: RC=0 Result = undefined. ANSIRead: ANSIRead [name] Name optional; name of file. This command operates in exactly the same way as the read command, except that it displays ansi control sequences (colours and typestyles) properly, and also handles tab characters correctly. If the name is not given it will use the first available selected item in the current directory window. ARexx results: RC=0 Result=undefined. ARexx: Arexx [command] Command optional; command to execute. This allows you to launch an arexx script or execute any Directory Opus ARexx command from within Directory Opus. If the command is not given a requester will open asking the user for one. ARexx results: RC=0 Result = undefined. Assign: Assign [name] Name optional; name to assign. This command allows you to assign a logical device name to the currently active directory. The c: device is an example of a logical device; it is not a physical disk itself, but is a directory that has been assigned the name c:. For example, a simpe name such as text: can be assigned to a long and complicated pathname such as; Dh0:projects/work/1989/april/bits&pieces/text from then on, whenever you enter text: into a directory button, you will go straight to the directory at the end of the assigned path, instead of having to go through all the sub-directories on the way. You can use the assignment in any other program as well. Logical devices always end with a colon. Assign also allows you to cancel a previously assigned device, or reassign a device to another directory. To do this, press the right mouse button over the s (select) button to activate the getdevices command. Select the assigned device(s) you wish to change, and invoke the assign command. A requester will apear, into which you can type the new pathname to be assigned each device name. If you enter a blank string, that logical device will be unassigned. ARexx results: RC=0 Result = undefined. Beep: This command will sounda beep on both or either of the sound channels. You could use this command to signify that a command has finished. For instance, you could modify the directory option to read: Command diskcopy Command beep In versions of the operating system later than 38 (2.1) this command will call the system beep routine. Under earlier versions it will sound its own beep. ARexx results: RC=0 Result=undefined. Buffer list: Buffer list [win] Win optional; window to scan the buffer list into (-1=current window, 0=left or 1=right) defaults to -1. This command displays a list of all the buffered directories. You may then double click on one of the displayed buffers to jump to that buffer immediately, rather than clicking on the arrows to cycle through the buffers one by one. Arexx results: RC=0 Result=undefined Busy: Busy [on/off] On/off optional; adjust the busy pointer, defaults to on. This command turns on or off the busy pointer. ARexx result: RC=0 Result=undefined. Buttoniconify: Buttoniconify [rows] [bank] Rows optional; number of button rows. this can be 1, 2, 3 or 6. defaults to whatever Directory Opus to. Bank optional; bank number to display initially, defaults to 1. This causes Directory Opus to open a window on workbench containing the custom buttons. ARexx results: RC=0 Result=undefined. CD: CD [path] Path optional; new current directory path, if path is not given a requester will open. This command allows you to set the current working directory for Directory Opus. This is the directory that is read if you press return on an empty directory button. ARexx results: RC=0 Result=undefined. Check abort: This command allows you to monitor, from an arexx script, whether the user has pressed the left and right mouse buttons together (to abort). It also resets the abort flag every time it is called. If you plan to use the checkabort command. You should call checkabort at the start of the script (to reset the abort flag), before actually using it to check the abort status. ARexx results: RC=0 Result=0 if abort sequence has not been hit, 1 if it has Checkfit: Checkfit [win] Win optional; window to a checkfit on (-1=current window, 0=left or 1=right) defaults to -1. This works in the same way as getsizes does except that its calculation is based on disk block sizes, and is therefore much more accurate. The disadvantage to checkfit is that it needs to recalculate every time the destinations block size changes. Therefore, even if all scource directories already have their sizes shown, checkfit may need to scan them all again. Operations like copy, etc, that generate directory sizes, are not suitable for checkfit, and so again checkfit will need to scan all selected directories. Checkfit displays the total number of bytes needed and the number of bytes free (i. e. , block numbers multiplied by the block size), and the percentage of files that will actually fit. If they will all fit, it shows 100%, if only half fit, it shows 50%. The getsizes command is retained as it can be used quickly to provide a rough guide. Checkfit can completely replace the getsizes command if you dont mind it having to rescan directories when you might not have expected it. ARexx results: RC=0 Result=undefined Clearbuffers: This command will clear the contents of all the directory buffers other than the two that are currently displayed. All unused memory will be de-allocated. This is a good way to free memory quickly if you have lots of used buffers and are running a bit low on memory. Arexx results: RC=0 Result=undefined Clearsizes: Clearsizes [win] Win optional; window to clear the sizes from (-1=current window, 0 = left or 1 = right) defaults to -1. If a directorys size is already displayed, then the directory will not be re-scanned when selected nor the getsizes command invoked. This could mean that the directory size is inaccurate, especially if any files have been created or deleted in it by another program. selecting one or more directories, and then selecting the clearsizes command, will cause the directory sizes to disappear. You can then reselect the directories, invoke the getsizes command, and the directories will be re-scanned and their updated sizes displayed. ARexx results: RC=0 Result=undefined Clearwin: Clearwin [win] Win optional; window to clear (-1=current window, 0= left or 1 right) defaults to -1. This command will clear the contents of a directory window. ARexx results: RC=0 Result=undefined Clone: Clone [name] [new name] New name optional; new file name This command allows you to make a copy of selected entries in the same directory, and rename them. A requester will appear for each entry, asking for the new name. This can also work with a specified file. If a new name is not given then a requester will appear. ARexx results: RC=0 Result=undefined Comment: Comment [name] [comment] Name optional; file name Comment optional; comment string This command allows you to change the comment, or filenote, of the selected files and directories in the active directory window. When directories are selected, you are asked whether the files within them are to have their comments modified also. For each entry, you are presented with a requester containing its current comment. To change the comment, edit it and press return. To retain the comment just press return. To set the comment of all selected entries you should the all button from the comment requester; choosing okay or pressing return will set the comments one file at a time. ARexx results: RC=0 Result=undefined Configure: Simply starts up the configuration program. ARexx results: RC=0 Result=undefined Contst: If there is a song paused, then it starts it playing again. ARexx results: RC=0 Result=undefined Copy: Copy [name] [destination] Name optional; filename Destination optional; destination directory This command copies all selected files and directories in the active directory window to the inactive directory window, keeping the same names. If a filename is given then only that file will be copied, but you may also specify a destination directory. ARexx results: RC=0 Result=undefined Copyas: Copyas [name] [new name] Name optional; file name New name optional; new file name This command copies all selected files and directories in the active directory window to the inactive directory window, and allows you to specify a new name for each file or directory. If a filename is given, then only that file will be copied. ARexx results: RC=0 Result=undefined Copywindow: Win optional; window to copy from (-1=current window, 0=left or 1=right) defaults to -1 This will copy the contents of a specified window or the current window into the other window. ARexx results: RC=0 Result=undefined Datestamp: Datestamp [name] [date] Name optional; file name Date optional; date to set This command allows you to change the datestamp of selected files and directories in the active directory window. When directories are selected, you are asked whether you also wish the files within them to have their datestamps modified. For each entry, you are presented with a requester. If you wish the file to have its datestamp set to the current date and time, simply press return. Otherwise, enter the desired date and time. To set the datestamp of all selected entries you should select the all button from the datestamp requester; choosing okay will set the datestamps a file at a time. ARexx results: RC=0 Result=undefined Defaults: This causes Directory Opus to reset to the hard-coded, default configuration. if you have modified the configuration yourself, and have not yet saved it, you are asked if you wish to save it first. ARexx results: RC=0 Result=undefined Delete: Delete [name] Name optional; filename This will delete all selected entries or just the specified file in the active directory window. Be careful with this, as it is easy to wipe out valuable data. ARexx results: RC=0 Result=undefined Dirtree: Dirtree [win] Win optional; window to create a directory tree in (-1=current window, 0=left or 1=right) defaults to -1. This command will map out a directory tree in the active directory window, or a specified window. ARexx results: RC=0 Result=undefined Diskcopy: Diskcopy [scource] destination [verify] [bump] Source optional; source disk Destinations destination disk Verify optional; diskcopy with verify on Bump optional; bump the revision of the disk name, as with workbench. This command will diskcopy from scource to destination, with verify turned on if the verify keyword is specified. If no scource or destination are specified, the diskcopy requester is opened. If the bump keyword is given then Directory Opus will bump the revision (copy_of_diskname)of the disk name as workbench does. ARexx results: RC=0 Result=undefined Diskcopybg: Diskcopybg same as diskcopy This command will execute diskcopy in the background mode. This allows you to start up a diskcopy and still use Directory Opus. ARexx results: RC=0 Result=undefined Diskinfo: Diskinfo [path] Path optional; path of a disk to get info about This command displays some information about the disk the active directory resides on, including space used and free, datestamp and number of errors on the disk. ARexx results: RC=0 Result=undefined Displaydir: Displaydir [win] Win optional; window to refresh (-1=current window, 0=left or 1=right) Defaults to -1. This command will update the display for the active directory window or the specified window. ARexx results: RC=0 Result=undefined Dopustoback: Move the directory opus to the back. ARexx results: RC=0 Result=undefined Dopustofront: Move the Directory Opus screen to the front. ARexx results: RC=0 Result=undefined Encrypt: Encrypt [name] [password] Name optional; filename Password optional; password to use Have you ever had files that you wanted to encrypt so that only people who know the password could understand them? This command allows you to do just that. It will encrypt all selected files, using a password that you enter, with a complex algorithm that most people will find impossible to work out. The resulting files are not written over, but are instead written to the destination directory. They will be the same size as the original files, so you can ensure you have enough room in the destination directory. To decrypt a previously encrypted file, you should enter the same password preceded by a minus sign. For example, to decrypt files you encrypted with the password foo, select the files, choose the encrypt command and enter -foo as the password. ARexx results: RC=0 Result=undefined Errorhelp: Errorhelp [code] Code optional; error code This command gives you more information about dos error codes than is generally available. When you select this option, you are asked for the dos error code you want help with. Examples of dos error codes are 123, 205 and 225. You are then presented with a description of that error and information pertaining to the possible cause and cure of the error. ARexx results: RC=0 Result=undefined Execute: Execute [filename] Filename optional; name of a file to execute as a batch file This command will attempt to execute each selected file in turn or to execute a specific file as a batch file. This has the same effect as if you had run the batch file via iconx, or via the execute command from the Cli. ARexx results: RC=0 Result=undefined Fileinfo: ARexx only Fileinfo name [separator] [win] Name; name of file to give info for (must be in the active or specified window) Separator optional; character used to separate info Win optional; window to get file from (-1=current window, 0=left or 1=right) Defaults to -1. This command returns information on the entry called name (which must be in the active directory window). The information returned is separated by a separator(default separator is space), and consists of the filename, the size in bytes, the size in blocks(not used yet), the file type (less than 0 indicates a file, greater than 0 indicates a directory), the selected status (boolean), the date (days), the date (seconds), the comment and the protection bits. The date is returned as a number of days since January 1st 1978, and as the number of seconds since midnight. The protection bits are returned in the format hsparwed (with a - character where the bit is not set). ARexx results: RC=0 Result=information about the file Finishsection: Internal only. The finishsection command forces any preceding programs (AmigaDos, Workbench, batch or ARexx) to executing before carrying on to the next command. The next command need not be a Directory Opus command; it is just more likely that it will be. For instance, to add a beep to the end of the lharc list filetype command, you would change the command list to read: Aamigados lharc v {f} Command finishsection Command beep ARexx results: RC=0 Result=undefined Format: Format [drive] [verify] [quick] [noicons] [ffs] [inter] [cache] Drive optional; drive to format Verify optional; format with verify on Quick optional; quick format Noicons optional; format with no icons FFS optional; format fast file system Inter optional; format in international mode os 2.0 only Cache optional; format in directory caching mode os 3.0 only This allows you to format a new disk. All new disks need to be formatted before the computer can write to them. The verify flag allows you to turn verify on or off. If verify is turned off, ghe format process will be much faster, but you will not be made aware of any errors that qccur. If you dont completely trust your disks, leave verify on. The FFS option in format allows you to format a disk to use the fast filing system of kickstart 2.0. If you are running a kickstart less than 2.0, you will still be able to select this option to format a disk, however, reading FFS-formatted disks is impossible without 2.0 or greater. International mode allows file and directory names to include accented characters. Directory caching mode will decrease the capacity of your disk but the directory reading speed will be much greater. ARexx results: RC=0 Result=undefined Formatbg: Formatbg same as format This command will execute format in background mode. This allows you to start up a format and still use Directory Opus. ARexx results: RC=0 Result=udefined Getall: ARexx only. Getall [separator] [win] Separator optional; character used to separate names Win optional; window to get names from (-1=current window, 0=left or 1=right) defaults to -1. This command returns, in the result variable, the names of all entries in the active directory window. If separator is specified, the names are separated by a separator. The default separator is a space. You should be prepared to handle a long string. ARexx results: RC=0 Result=all the entries Getdevices: Getdevices [win] Win optional; window to put device list into (-1=current window, 0=left or 1=right) Defaults to -1 This command displays a list of all devices, volumes and assigned directories present in the system. You may then read in these devices by double clicking on them. You can also select entire devices for use with the hunt and search commands. ARexx results: RC=0 Result=undefined Getdirs ARexx only Getdirs [separator] [win] Separator optional; character used to separate directory names Win optional; window to get directory names from (-1=current window, 0=left or 1=right) Defaults to -1. This command returns, in the result variable, the names of directories in the active directory window. If separator is specified, the names are separated by the separator. The default separator is a space. you should be prepared to handle a long string. ARexx results: RC=0 Result=all the directory entries Getentry: ARexx only Getentry num Num the entry number whose name is to be returned Returns the file or directory name of entry number @num@. ARexx results; RC=0 Result=name of the specified entry Getfiletype: ARexx only Getfiletype filename [type] Filename file whose filetype is to be returned Type optional; form of filetype id (0=file class description or 1=file class id), defaults to 0 Returns the filetype (if recognized) of the specified file. ARexx results: RC=0 Result=filetype id of the file if filetype is known Getfiles: ARexx only. Getfiles [separator] [win] Separator optional; character used to separate filenames Win optional; window to get filenames from (-1=current window, 0=left or 1=right) defaults to -1. This command returns, in the result variable, the names of all files in the active directory window. If separator is specified, the names are separated by a separator. The default separator is a space. You should be prepared to handle a long string. ARexx results: RC=0 Result=all the file entries Getnextselected: ARexx only Getnextselected [win] Win optional; window to get next selected item from (-1=current window, 0=left or 1=right) defaults to -1 This command returns the name of the first selected entry (in the result variable) in the active directory window. The entry is not deselected afterwards so if you dont deselect it yourself, that is the only name you will ever get returned. ARexx results: RC=0 Result=name of the entry Getselectedall: ARexx only Getselectedall [separator] [win] Separator optional; character used to separate names Win optional; window to get names from (-1=current window, 0=left or 1=right) Defaults to -1. This command returns, in the result variable, the names of all selected entries in the active directory window. If separator is specified, the names are separated by a separator. The default separator is a space. You should be prepared to handle a long string. ARexx results: RC=0 Result=all the selected entries Getselecteddirs: ARexx only Getselecteddirs [separator] [win] Separator optional; character used to separate selected directory names Win optional; window to get directory names from (-1=current window, 0=left or 1=right) defaults to -1. This command returns, in the result variable, the names of all selected directories in the active directory window. If separator is specified, the names are separated by a separator. The default separator is a space. You should be prepared to handle a long string. ARexx results: RC=0 Result=all the selected directory entries Getselectedfiles: ARexx only Getselectedfiles [separator] [win] Separator optional; character used to separate selected filenames Win optional; window to get selected filenames from (-1=current window, 0=left or 1=right) defaults to -1. This command returns, in the result variable, the names of all selected files in the active directory window. If separator is specified, the names are separated by a separator. The default separator is a space. You should be prepared to hanle a long string. ARexx results: RC=0 Result=allthe selected file entries Getsizes: Getsizes [win] Win optional; window to work with. (-1=current window, 0=left or 1=right) defaults to -1. This will display in the status bar the same information that is displayed when entries are selected (namely, the number of selected files, directories and bytes, out of the total number of files, directories and bytes), along with one additional piece of information. If the selected entries occupy fewer bytes than the free space on the disk in the opposite directory window, allowing all selected files to fit on the destination disk were they to be copied, a y will be displayed after the count. Otherwise an n will be displayed. If any directories are selected when getsizes is chosen, the directories that do not already have a size displayed are scanned, and the size of the directories are calculated and displayed. ARexx results: RC=0 Result=undefined Getstring: ARexx only Getstring [message] Message optional; text for requester This command will open a requester for the user to enter text into. If a message is given, that is used as a prompt for the requester. ARexx results: RC=0 success, 1 cancel was pressed Result=string entered by user Help: Provided a help file has been loaded in, selecting any button or menu after enabling help mode with this menu should result in the appearance of some helpful text. To turn help mode off, select this command again. ARexx results: RC=0 Result=undefined Hexread: Hexread [name] Name optional; name of file This command will read the selected files in the same way as read, but in hexadecimal format. This allows you view binary and other files containing non-text characters. ARexx results: RC=0 Result=undefined Hunt: Hunt [name] [pattern] Name optional; name of directory to hunt Pattern optional; file pattern to hunt This command allows you to search all selected directories (and their sub-directories) for a specifies file or files. a requester appears asking for the pattern to hunt for. You can use ful pattern matching for this search. If a file matching the pattern is found, you are asked if you wish to enter the directory containing it, or continue the search. If you elect to enter the directory, the directory will be read and then all matching entries will be highlighted. ARexx results: RC=0 Result=undefined Iconify: This command closes the directory opus window and screen, de-allocates as much memory as possible, and then opens a small window on the Workbench screen. This is known as iconifying, and allows you to have Directory Opus constantly available while using the minimum amount of memory. To determine the initial position of the iconified window, especially if you start up Directory Opus in the iconified state, you should iconify Directory Opus, and position the window as you would like it to appear. Then re-enter Directory Opus, and save the configuration (described later). To re-enter Directory Opus, simpe click the left mouse button in the iconified window, the press the right mouse button. If you wish to quit Directory Opus without going back into it, just click the close button at the far left of the iconified window. If you have the configuration option iconify type (described later) set to hidden, the only way to re-enter Directory Opus is with the hotkeys. These default to ctrl-shift-alt (the ctrl key, the left shift key and the left alt key held down simultaneously), although this may be changed in the configuration (explained later). ARexx results: RC=0 Result=undefined Iconinfo: Iconinfo [name] Name optional; name of icon (or file with icon) This command allows you to modify the characteristics of icons such as stack size, default tool and tool types. It operates in a similar fashion to the information menu item of Workbench. To use this command you may either select the .info files themselves or the actual files or directories the icons belong to. A requester will appear when you run this command on a valid icon. The actual appearance of the requester will vary depending on the type of icon, but in all cases the actual icon imagery will be displayed. You can click on this image with the left mouse button to display the alternative imagery (if it exists). The remap colours button will swap colours 1 and 2 of the icon displayed. This can be useful to remap icons designed under os 1.3 for usage under os 2.0, since os 2.0 swapped the light and dark colours around. The information displayed for each icon is listed below. once you have made the desired changes to the icon, the save button will save the changes to disk. The skip and cancel buttons will exit without modifying the icon on disk. Drawer icon: For a drawer icon you may edit the drawers protection bits, comment, and tool types. The date of the last modification of the drawer is also displayed. Project icon: For a project icon you may edit the projects stack size, default tool and tool types. Also displayed are the size of the project in bytes and the blocks, and the last modification date. Tool icon: For a tool icon you may edit the tools protection bits, stack size, comment and tool types. Also displayed are the size of the tool in bytes and blocks, and the last modification date. Disk icon: For the disk icon you may edit the disks default tool. Displayed are the total number of blocks, and the number of blocks used and free. The block size, creation date and disk status are also displayed. Trashcan icon: For a trashcan icon the only information available is the last modification date. Protection bits (where appropriate) are modified in the same way as with the protect command, except that the hidden and pure bits are not acceessible. Tool types (where approprite) are modified in the same way as from Workbench. To edit an existing tool type, simply select it, and press return when you have modified it. To create a new tool type, select the new button. To delete an existing tool type, select it and then select the delete button. ARexx results: RC=0 Result=undefined Install: Install [drive] [ffs] [noboot] Drive optional; drive to install FFS optional; install a FFS bootblock Noboot optional; make disk non-bootable This command allows you to make a disk bootable. All bootable disks have special information written to the first sector of the disk. Without this, the disk will not boot. ARexx results: RC=0 Result=undefined Installbg: Same as install This command will execute install in background mode. This allows you to start up a diskcopy and still use Directory Opus. ARexx results: RC=0 Result=undefined Lastsaved: This command causes Directory Opus to read the last saved configuration file. If you have modified the configuration, and have not yet saved it, you are asked for conformation before this is done. ARexx results: RC=0 Result=undefined Loadconfig: Loadconfig name Name configuration file to load Loads the specified configuration file. ARexx results: RC=0 Result= 0 means success, 1 means some sort of failure. Loadstrings: Loadstrings name Name string file to load ARexx results: RC=0 Result= 0 means success, 1 means some sort of failure Loopplay: Loopplay [name] Name optional; name of file Unlike the play command, the loopplay command plays a sound file repeatedly, requiring a mouse button click to proceed to the next one. ARexx results: RC=0 Result=undefined Makedir: Makedir [name] Name optional; name of directory This command allows you to create a new sub-directory in the active directory window. ARexx results: RC=0 Result=undefined Modify: Modify name value Name name of item to modify Value new value This command allows you to make quick changes in certain configuration options from buttons or menus, rather than going through the configuration program. The modify command allows changes to at least two characteristics the name of the option to change, and the new value (s) for it. Most values are actually a combination of flag bits; to determine the desired value, you simply add the values of the flag bits together. You can also add and subtract bits. To do this, specify each bit (or combination of bits)that you wish to add or subtract, preceded by the appropriate sign (+ for add and - for subtract). The options you can change are:- Banknumber: Allows you to specify the bank being shown. Banknumber num Buttonrows: Corresponds to buttons/button rows menu. Buttonrows rows Copyflags: Corresponds to operations/copy Copyflags flags Flags: 1= keep original datestamp 2= keep original protection bits 4= keep original comment 8= set archive bit 16= check destination free space. Dateformat: Corresponds to operation/date format Dateformat flags Flags: 1= Amigados format (dd-mmm-yy) 2= International format (yy-mm-dd) 4= Usa format (mm-dd-yy) 8= English/australian format (dd-mm-yy) 16= Name substitution (today, tomorrow, etc) 32= 12 hour clock Defaulttool: The current default tool for project icons created with addicon. Defaulttool toolname Deleteflags: Corresponds to operation/delete Deleteflags flags Flags: 1 = ask before commencing delete 2 = ask before deleting files 4 = ask before deleting non-empty directories 8 = set delete protection bit Dirflags: Corresponds to system/directories. Dirflags flags Flags: 1 = always move to empty buffer 2 = use exall() to read directories 4 = auto diskchange 8 = auto disk load 16 = search buffers on double-click 32 = re-read changed or incomplete buffers 64 = search buffers on parent/root operation 128 = expand pathnames Displaylength: Corresponds to operation/list formats length fields. This sets the lengths of some of the directory list items. displaylength win type length win is the window to act upon (-1=current window, 0=left or 1=right). Types: 0 = name 1 = comment 2 = filetype Errorflags: Corresponds to operation/errorcheck Errorflags flags Flags: 1 = diable dos requesters 2 = display error requester Fadedelay: Corresponds to system/view and plays fade delay. Fadedelay time Filter: Adjust the global filename filter. If filepattern is not given then global filter is turned off. Filter [filepattern] Font: Corresponds to screen/fonts. This takes three values; the id number of the font to change, the name of the new font, and the point size of the font. Font idnumber font size Idnumbers: 0 = general (8 point font) 1 = directory window font 2 = text viewer font 3 = buttons 4 = menus 5 = status bar 6 = disk names 7 = clock bar 8 = requesters 9 = path fields 10 = button iconify Generalflags: Corresponds to operation/general Generalflags flags Flags: 2 = display info 8 = file double click 64 = window slider activate 128 = click-n-click drag Helpfile: Allows you to specify a help file to load Helpfile pathname Hidepattern: Corresponds to system/show patterns hidepattern Hidepattern pattern Iconflags: Corresponds to operation/icons Iconflags flags Flags: 1 = create icons with directories 2 = perform all actions on icons as well 4 = select icons automatically Iconifyflags: Corresponds to system/clocks. Iconifyflags flags Flags: 1 = memory monitor 2 = cpu monitor 4 = date 8 = time 16 = no window 32 = appicon 64 = memory in bytes 128 = c: and f: Note that no window and appicon are mutually exclusive. If the two flags are specified together the results will be unpredictable. Listformat: Corresponds to operation/list format. The value of this is not a combination of flags, but instead a list of numbers representing items. Listformat win items Win is the window to act upon (-1=current window, 0=left or 1=right) items is up to five numbers, which indicate what data is to be displayed and in what order. Items: 0 = none 1 = size 2 = protection 3 = datestamp 4 = comment 5 = filetype Outputcmd: Correspond to system/amigados/output command. Outputcmd shellcommand Outputwindow: Corresponds to system/amigados/output window. Outputwindow consoledefinition Replaceflags: Corresponds to operation/copy Replaceflags flags Flags: 1 = always replace files 2 = never replace files 4 = replace only older files 8 = ask before replacing Screenmode: Corresponds to screen/screenmode Screenmode mode Mode values 1 = open on workbenchs screen 2 = open a clone of workbenches screen Under os2.0/os3.0 other mode ids are supported. some common mode ids are 32768 = high res screen 32772 = high res laced screen 32800 = super high res screen 32804 = super high res laced screen 233508 = productivity screen 233509 = productivity laced screen 266240 = a2024 10 hz screen 299008 = a2024 15 hz screen Scrdepth: Corresponds to screen/screen modes depth. The depth can be 2, 3, or 4 bitplanes. That is the same as four, eight or sixteen colours. Scrdepth depth Screenflags: Corresponds to screen/screen mode. Screenflags flags Flags: 1 = use default screen width 2 = use default screen height 4 = half-height screen Scrclockflags: Corresponds to system/clocks. Scrclockflags flags Flags: 1 = memory monitor 2 = cpu monitor 4 = date 8 = time 64 = memory in bytes 128 = c: and f: Scrh: Corresponds to screen/screen modes height. Scrh height Scrw Corresponds to screen/screen modes width. Scrw width Separatemethod: Corresponds to operation/list formats cycle button. Separatemethod win method Win is the window to act upon (-1=current window, 0=left or 1=right). Methods: 0 = mix files and directories 1 = displays directories first 2 = displays files first Showdelay: Corresponds to system/view and plays show delay. Showdelay delay. Showfreeflags: Corresponds to system/directory flags. Showfreeflags flags Flags: 1 = bytes free 2 = kilo/megabytes free 4 = blocks free 8 = precentage of space free These bits are mutualy exclusive. If more than one is specified at a time the results will be unpredictable. Showpatbits: Corresponds to system/show patterns hidden bit flag. Showpatbits flags Flags: 1 = hide files with hidden bit set. Showpattern: Corresponds to system/show patterns show pattern Showpattern pattern Sortflags: Corresponds to operation/list formats sort flag. Sortflags flag Flags: 1 = reverse sort in the left window 2 = reverse sort in the right window Sortmethod: Corresponds to operation/list formats checked sort item. Sort method win item Win is the window to act upon (-1=current window, 0=left or 1=right). Items: 0 = name 1 = size 2 = protection 3 = datestamp 4 = comment 5 = filetype Updateflags: Corresponds to operation/update. Updateflags flags Flags: 1 = update free disk space 2 = scroll directory window to follow operations 4 = redraw more than a quarter of a page 8 = directory refresh using startnotify () 16 = left-justify filename in status bar 32 = display progress indicator Viewplayflags: Corresponds to system/view and play. Viewplayflags flags Flags: 1 = black background between pictures 2 = turn audio filter off for 8svx play 4 = 8-bits per gun colour 8 = loopplay 8svx sound file on double click 16 = text view borders 32 = start animations paused Windowsize: Adjusts the placement of the centre bar of Directory Opus directory windows. Windowsize offset Any modify command that change display characteristics (screen size, mode and depth, list format, etc) will not take effect until you execute the redraw command. For commands that only change directory display characteristics, you use the displaydir command to update the directory display. Some modifications (like date format, hide and show patterns, etc) will not take effect until the directory is actually re-read ( for instance, when the rescan command is used). For example, you could have two buttons configured to switch between a high res screen with 8 colours, and a high res interlaced screen with 4 colours. The definitions for these buttons might be: Laceon -command modify screenmode 32772 command modify scrdepth 2 command redraw Laceoff-commnad modify screenmode 32768 command modify scrdepth 3 command redraw As another example, you might wish to change the left window to be sorted by date, but to leave the right window alone. For this, you would have the command: Commannd modify sortflags 0 3 Command rescan 0 ARexx results: RC=0 Result=undefined Move: Move [name] [destination] Name optional; name of file Destination optional; destination path This allows you to move all selected files and directories from the active directory window to the inactive window. The file or directory will be copied to the destination, and the original will be deleted. ARexx results: RC=0 Result=undefined Moveas: Moveas [name] [new name] Name optional; name of file New name optional; new file name This command moves all selected files and directories from the active directory window to the inactive window, and allows you to specify a new name for each file or directory. The file or directory will be copied to the destination under the new name, and the original will be deleted. ARexx results: RC=0 Result=undefined Newcli: Newcli [handle] Handle optional; cli console handle to use. This command opens a cli from within Directory Opus, using the output window defined in the configuration. The new cli will be separate from Directory Opus, so to end the cli you must type endcli, as usual. ARexx results: RC=0 Result=undefined Nextdrives: This command simply flips to the next bank of drive buttons. ARexx results: RC=0 Result=undefined None: This command deselects all files and directories in the active directory window. ARexx results: RC=0 Result=undefinined Otherwindow: This is the same as pressing the space bar, and activates the inactive directory window. ARexx results: RC=0 Result= 0 left window is now active, 1 right window is now active. Parent: Parent [win] Win optional; window to do a parent of (-1=current window, 0=left or 1=right) defaults to -1. This will read the parent directory of the directory open in the active or specified directory window. There are also two hidden parent buttons; one for each directory window. They are hidden in the outermost borders (on the left of the screen and the right of the screen)of the directory windows. ARexx results: RC=0 Result=undefined Patternmatch: Patternmatch pattern string Pattern pattern string String string to match to pattern This will returrn a boolean value to indicate whether the supplied string matches the supplied pattern (which may include full wildcards) ARexx results: RC=0 Result=0 if string does not match, 1 if it does. Play: Play [name] Name optional; name of file This will attempt to play each selected file. If the file is an 8SVX format iff sampled sound (of the type generated by audio master, for instance), the speed and other information from within the file will be used. The play routine plays both mono and stereo iff 8svx files. When playing a file that is not iff 8svx, it will assume a speed of 10000 samples/second. This command also plays song modules. See playst for more information. Each file is played once only, unlike the loopplay command, which plays each file continuously. If the system/view/play/turn audio filter off or for play option is selected, the high pass filter will be turned off while a sound is playing. ARexx results: RC=0 Result=undefined Playst: Playst [name] Name optional; name of file Play a song module. Directory Opus supports sound/noise/protracker, oktalizer and med modules. ARexx results: RC=0 Result=undefined Print: Print [name] Name optional; name of file The print routine is a full featured text formatter. You can have a header and/or footer printed at the top and bottom of each page if you wish. Both the header and footer can consist of the title, the current date and the page number. You may select any combination of title, date and page number you wish. If none are selected, the header or footer is not printed. You may also select the typestyle of the header and the footer, by clicking on the buttons that initially say normal. These allow you to cycle through the various typestyles avaiable:normal, bold, italics, underline, doublestrike and shadow. Note that some printers may not have all these typestyles available. You may enter a title (to be used in the header and footer)in the title string field. Leaving this blank will cause the name of the file to be used as a title. The output field allows you to specify where you want the output of the print process to go. This defaults to prt:, but you may choose to have the output sent to a disk file. In this case, simply enter the path and the name of the file you wish to print to. The cycle button labeled quality allows you to specify whether all text is printed in draft mode or nlq mode. The button below that determines whether or not the last page of the file to be printed is followed by a formfeed character, which would cause it to be ejected. To start the print operation, select the print button. This command will print all selected files, one at a time. If you select only one file to print, theprint routine will be started up as a separate process, allowing you to continue working with Directory Opus. To cancel this type of print, select the print command again. A requester will appear aasking if you want to continue with the print or halt it. This requester will also appear if you attempt to quit Directory opus while a print operation is in place, as you cannot quit until the print has finished. To cancel a print job that has not been sent to the printer yet, simply press the left and right mouse buttons in the normal way. Even if you abort a print, the printer may not actually stop for sometime. This is because most printers have print buffers, some quite large ones, which must empty the data they have stored into the printer first. ARexx results: RC=0 Result=undefined Printdir: Printdir [win] Win optional; widow to scan the buffer list into (-1=current window, 0=left or 1=right) defaults to -1. This command allows you to print the directory in the active directory window. You are able to choose the information you want to print (file sizes, protection bits, dates and comments). This command is not started as a separate process, unlike the print command. Printdir also allows you to specify the output file to which the directory is to be printed. This can be prt: (i. e. , your printer, the default)or a disk file. ARexx results: RC=0 Result=undefined Protect: Protect [name] [bits] Name optional; name of file Bits optional; bits to set on given file The protect command now allows you to specify bit-masking. This lets you mask some bits as untouchable. You can selectively add or remove certain bits while leaving other bits in their original state. To select a mask, click on the characters following the mask:string. if a mask bit is turned on, its character equivalent will be displayed; otherwise a hyphen (-) character will be displayed. No mask bits that are tuned on will be modified during the protection operation. ARexx results: RC=0 Result=undefined Query: Query item [win] Item configuration item to query Win optional; window argument that some items need (-1=current window, 0=left or 1=right) defaults to -1. Returns the current value of a specific configuration item. These items are described in the modify command. Any item that can be modified can be queried. Several of the configuration items need an additional window argument. These are listformat, displaylength, sortmethod and separatemethod. ARexx results: RC=0 Result=current value of the specified item Quit: Quit [force] Force optional; do not ask user for confirmation. This command will exit Directory Opus (providing there is not a print operation happening at the time). If the configuration has been modified and not saved, you are asked if you wish to save it first. ARexx results: RC=0 Result=undefined Read: Read [name] Name optional; name of file This command allows you to read selected files. At the bottom of the screen the name of the file is displayed, along with the current position within the file in lines and as a percentage, and also the total number of lines in the file. The mouse is used to move through the file. Press the left mouse button to turn scrolling on or off. The direction of the scroll is governed by the position of the mouse pointer in the window. The mouse pointer will become invisible while the text is scrolling. No scrolling occurs if you have the mouse in the centre of the window. To scroll forward, move the mouse down until the text starts to scroll. The further down you move the mouse, the faster the text will scroll. This procedure is reversed for backwards scrolling. The buttons in the bottom right of the screen also allow you to move around the file. Most buttons will repeat if held down for any length of time. The up and down arrows move up and down a line at a time. The u and d buttons move up and down a page at a time. The t and b buttons move to the top and bottom of the file. You can also use the cursor keys to move up and down. as before, in conjunction with shift these keys will move a page at a time, and in conjunction with ctrl they will move to the top and bottom of the file. To jump to a specified line, click on the number showing the current line position (immediately to the left of the word lines). You can also press the j key. To jump to a specified percentage, click on the number immediately to the left of the % sign. To search for a string, click on the s button or press the s key. You can use full pattern matching in this search. To print the current file, click on the p button (or press the p key). To print only the current page, press the c key (this has no button equivalent). To leave the text viewer, click on the x button, or press either x, q or esc. If more than one file was selected, the next one will be read when you exit. To exit without reading the next file, press the right mouse button. ARexx results: RC=0 Result=undefined Redraw: This command will completely redraw the Directory Opus screen. The screen is closed and then re-opened. ARexx results: RC=0 Result=undefined Relabel: Relabel [device newname] Device optional; device to relabel Newname new name to give selected device This command allows you to change the name (label) of the disk that is open in the active directory window. ARexx results: RC=0 Result=undefined Remember: This command allows you to make temporary changes with the modify command, and then restore all the settings later. ARexx results: RC=0 Result=undefined Removeentry: Removeentry number show Number number of entry to remove Show boolean indicates whether to update display Removes an entry by ordinal number ARexx results: RC=0 Result=0 entry was not found, 1 entry was found and removed Removefile: Removefile name show Name of the file entry to remove Show boolean indicates whether to update display This command removes the specified entry from the active directory window, and returns a boolean indicating whether the entry was found and removed. Show is a boolean value indicating wether you want the display updated or not. ARexx results: RC=0 Result=0 entry was not found, 1 entry was found and removed Rename: Rename [name newname] Name optional; name of file Newname to give to selected file This allows you to rename all selected files and directories. You may use a * to specify a pattern. If no * is used, you are asked for a new name for each individual file. To add a prefix or a suffix (or both) to all selected entries, use * in the second string field. For example, to add hires as a prefix and .pic as a suffix to all selected entries, enter hires*.pic. To change a prefix or suffix (or both) of all selected entries, use a * in the top string field. For example, to change hires to medres as a prefix, and .pic to .iff as a suffix, enter hires*.pic in the top string field, and medres*.iff in the bottom string field. ARexx results: RC=0 Result=undefined Request: Request message Message text to print in the requester Displays requester with given message text ARexx results: RC=0 Result=0 cancel was selected, 1 okay was selected Rescan: Rescan [win] Win optional; window to rescan (-1=current window, 0=left or 1=right) defaults to -1. This causes the directory in the active window to be re-read. this has exactly the same effect aas activating the directory string field and pressing return, without modifing the directory name. ARexx results: RC=0 Result=undefined Reselect: This command will reselect all entries that were selected before the last opeeration was initiated. ARexx results: RC=0 Result=undefined Restore: This command is used to restore the previously remembered settings. ARexx results: RC=0 Result=undefined Root: Root [win] Win optional; window to scan the buffer list into (-1=current window, 0=left or 1=right) defaults to -1. This command reads the root directory of the active or specified directory window. There are two hidden root buttons; one for each directory window. They are hidden in the outermost borders (on the left of the screen and the right of the screen) of the directory windows. With the left mouse button, these buttons perform the parent command; when selected with the right mouse button they will load the root directory. ARexx results: RC=0 Result=undefined Run: Run [name] Name optional; name of file This command allows you to run each selected file in turn, providing that file is executable. This will have much the same effect as if you had double-clicked on the files icon, or run it from the cli. A requester will appear, asking for arguments (should the program require any). ARexx results: RC=0 Result=undefined Saveconfig: Saveconfig [filename] Filename optional; configuration file to save to This command saves the configuration to the file that it was read from initially. Scandir: Scandir path [win] Path path to read Win optional; window to read directory into (-1=current window, 0=left or 1=right) defaults to -1. This command allows you to read a directory in much the same way as the drive buttons. For example: Command scandir dh0:work would read the dh0:work directory into the current window. One usage of this allows you to have an entire bank of buttons devoted to "drive buttons". You could then set up a button on every other bank that would, using the modify command, jump to that bank. ARexx results: RC=0 Result=undefined Scrollh: Scrollh chars [win] Chars characters to scroll Win optional; window to scroll (-1=current window, 0=left or 1=right) defaults to -1. This will scroll the directory window horizontally by the specified number of characters (either positive or negative). ARexx results: RC=0 Result=new horizontal position Scrolltoshow: Scrolltoshow entry [win] Entry entry to make visible. May be either a name or wildcard pattern, or the ordinal number of the desired entry. Win optional; window to scroll (-1=current window, 0=left or 1=right) defaults to-1. This command will try to scroll the specified entry into view. ARexx results: RC=0 Result=0 if entry was not found, 1 if it was found. Scrollv: Scrollv lines [win] Lines lines to scroll Win optional; window to scroll (-1=current window, 0=left or 1=right) defaults to -1. This will scroll the directory window vertically by the specified number of lines (either positive or negative). ARexx results: RC=0 Result=new vertical position Search: Search [name] [pattern] [ucnic] [wild] [byword] Name optional; name of file Pattern optional; text pattern to search for Ucnic optional; uppercase characters does not equal lowercase characters. Wild optional; pattern contains wildcard characters Byword optional; match only whole words This command allows you to search all selected files for a specified string, which may contain wildcards. If a match is found you are told which file conains the string, and you are given the option to enter the text viewer and read the file. If you opt to do this, a search for the string is automatically initiated once the file has been read by the text viewer. If any directories are selected, all the files within those directories are also searched. the flags ucnic, wild and byword are off by default. ARexx results: RC=0 Result=undefined Select: Select [pattern] [onlyfiles] [onlydir] [name] [date] [protection] Pattern optional; pattern to select by Onlyfiles optional; select only files, defaults to both files and directories. Onlydirs optional; select only directories Name optional; match on name, (default) Date optional; match on date Protection optional; match on protection bits When used in name mode (default) this command allows you to select files and directories in the active directory window using wildcards. All standard wildcards are supported #. ?, |, %, (, ), [, ], *, ~ and `. when used in date mode you can select all files and directories created or modified on a certain date only. Simply enter that date (e. g. , 28-mar-90 would select all entries with datestamps set to any time on the 28th of march, 1990). you can also use words like yesterday, today, tuesday, etc. you can also specify a specific time. Simply enter the time (in the format hh:mm:ss). If you enter a time, however, the datestamp must match that time exactly for the entry to be selected. Of you enter a time but not a date it will select files created today that match that time. You can also select a range of dates. for instance, to select all entries created or modified between the 18th of april 1989 and the 22nd of september 1991, you would enter: 18-apr-89 > 22-sep-91 The > character does not in this case signify "greater than"; it simply indicates a range of dates. It must have at least one space on either side of it. To select all files from the beginning of time to, for instance, the 3rd of january 1990, you would enter: > 3-jan-91 to select all files from, for example, the 12th of july, 1983 to the current date (today) you would enter: 12-jul-83 > you may also specify times when entering date ranges. If used in protect bit mode you may specify protection bits that are allowed to be set, and bits that are not. If a bit or group of bits is allowed to be set, precede it with a + character. If a bit or group of bits is not allowed to be set, precede it with a - character. the initial + character is assumed. For instance, to select all readable and writable files, you would simply enter: rw or, you could enter +rw. Both these would have the same effect. To expand upon this, and select all readable and writable files, but not those that have the hidden or archive bits set, you would enter: rw-ha or, toselect files that do not have the bits sped set, you would enter -sped The select command is additive; i. e. , entries not matching the given pattern are not deselected. ARexx results: RC=0 Result=undefined Selectentry: Selectentry number Number ordinal number of entry to select State optional; selection state (-1=toggles, 0=unselect and 1=select) defaults to -1. Show optional; boolean indicating whether to update display Selects an entry in the active window ARexx results: RC=0 Result=previous select status of entry or -1 if it could be found Selectfile: Selectfile name [state] [show] Name name of entry to select State optional; selection state (-1=toggles, 0=unselect and 1=select) defaults to -1. Show optional; boolean indicating whether to update display This command will select the entry specified by filename, as if it had just been clicked on. ARexx results: RC=0 Result=previous select status of file or -1 if it could not be found Setwintitle: Setwintitle title [win] Title title string to use Win optional; window to modify (-1=current window, 0=left or 1=right) defaults to -1. Sets title of active or specified window to given string. ARexx results: RC=0 Result=undefined Show: Show [name] Name optional; name of file This command is very versatile indeed. it will display IFF ILBM pictures and brushes, Workbench icons and fonts. if the file is an IFF ILBM, it will be displayed using information from the file. Directory Opus will correctly show most pictures and brushes, including overscan, extra halfbrite (ehb), ham pictures (4096 colours), and the new aga display modes of the A4000 and A1200, including ham8 with 262144 colours at once. If the picture contains colour cycling information, pressing tab will toggle colour cycling on or off. You can press p to print the picture. Should you wish the mouse pointer to be visible (in order to point at some part of the picture, for instance), press the . (period) key. The show routine will also display icons. If the file has a .info suffix it is assumed to be an icon. If the icon has an alternative image, pressing return will toggle between the two. To display a font, you need to enter the actual font drawer, and show the size file. That is, the file 8, 12, 19, etc, not the .font file. if you press the help key while viewing a picture, font or icon, a screen will appear showing information about what you were looking at. You can also print what you are looking at. ARexx results: RC=0 Result=undefined Smartread: Smartread [name] Name optional; name of file This command invokes the text viewer in the same way as the read command. However, it checks the file for binary characters, and if any are found, the file is hexread instead. ARexx results: RC=0 Result=undefined Status: Status value [set newvalue] Value indicates the type of status you want Set newvalue optional; set the status to the specified value This command returns the value for the specified status command (listed below). If the set keyword is specified, this command will set the status to the specified value (if appropriate for that status command). Most status values can be set. Some status commands require a sub-number. an example of this is status 4, which returns the total number of files in a specified directory window. The directory window may be either 0 (for the left-hand window), 1 (for the right-hand window) or -1 (for the active window). The command would therefore be status 4 0 for the left-hand window, and status 4 1 for the right-hand window. Status values are as follows: 1 Current directory: This returns or sets the pathname of the current directory Status 1 [set path] 2 Version: This returns the current version number (as a string) Status 2 3 Active window: This returns or sets the active directory window (either 0 or 1). Status 3 [set win] 4 Number of files: This returns the total number of files in a directory window. Status 4 win 5 Number of dirs: This returns the total number of directories in the directory window. Status 5 win 6 Number of entries: This returns the total number of entries in the directory window. Status 6 win 7 Number of selected files: This returns the total number of selected files in the directory window. Status 7 win 8 Number of selected dirs: This returns the total number of selected directories in the directory window. Status 8 win 9 Number of selected entries: This returns the total number of selected entries in the directory window. Status 9 win 10 Total bytes: This returns the total number of bytes (sum of the lengths of all files) in the directory window. Status 10 win 11 Total selected bytes: This returns the total number of selected bytes (sum of the lengths of all selected files)in the directory window. Status 11 win 12 Select pattern: This returns or sets the current select pattern (used in the select command). Status 12 [type] [set pattern] Types.... 0=name, default 1=date 2=bits 13 Directory name: This returns the name of the directory that is open in the specified window. Setting this to another pathname will read that directory. Status 13 win [set path] 14 Disk name: This returns the name of the disk that is open in the directory window. this cannot be set (use the relabel command to change the disk name). Status 14 win 15 Disk free bytes: This returns the number of bytes free on the disk open in the directory window. Status 15 win 16 Disk total bytes: This returns the total number of bytes (free+used) on the disk open in the directory window. Status 16 win 17 Buffered directory name: This returns the pathname of the directory that is stored in a specific directory buffer (from 0 to 255). Status 17 win buf 18 Buffered diskname: This returns the diskname of the directory stored in a specific directory buffer (from 0 to 255). Status 18 win buf 19 Buffered disk free bytes: This returns the free space on the disk whose directory is stored in a specific directory buffer (from 0 to 255). This data may no longer reflect the actual free space on that disk. Status 19 win buf 20 Buffered disk total bytes: This returns the space used on the disk whose directory is stored in a specific directory buffer (from 0 to 255). This data may no longer reflect the space used on that disk. Status 20 win buf 21 Buffer displayed: This returns the number of the buffer that is displayed in the directory window, a number from 0 to 255. If this is set to a specific buffer that buffer will be the one shown in the directory window. Status 21 win [set buf] 22 Unused in Directory Opus 4.01 23 Unused in Directory Opus 4.01 24 Entries per page: This returns the number of entries that can be displayed per page. Status 24 25 Configuration changed: This returns a boolean value to indicate whether the configuration has been changed since it was last saved. Status 25 [set state] 26 Okay string: This returns the name of the okay string in requesters. This also allows you to select the text of the positive button for the request and getstring commands. Status 26 [set string] 27 Cancel string: This returns the name of the canecl string in requesters. This also allows you to select the text of the negative button for the request and getstring commands. Status 27 [set string] 28 Currently iconified: This returns a value indicating whether Directory Opus is currently iconified and if so what type of iconification it is. This will return 0 if not iconified, 1 if iconified and 2 if button iconified. Status 28 29 Unused in Directory Opus 4.01 30 Top text justification: This returns a value indicating how the text in the status bar is rendered. Status 30 [set type] Types.... 0=left 1=right 2=centre 31 Unused in Directory Opus 4.01 32 Unused in Directory Opus 4.01 33 Unused in Directory Opus 4.01 34 Unused in Directory Opus 4.01 35 Unused in Directory Opus 4.01 ARexx results: RC=0 Result=depends on which status was requested. Stopst: Stops playing a song module. ARexx results: RC=0 Result=undefined Swapwindow: Swaps the contents of the two directory windows. ARexx results: RC=0 Result=undefined Techsupport: This command displays some information on how to contact technical support. ARexx results: RC=0 Result=undefined Toggle: This command reverses the state of all files and directories in the active directory (i. e. all selected entries are deselected, and vice versa). ARexx results: RC=0 Result=undefined Toptext: Text text string to display Displays given string in the status bar. ARexx results: RC=0 Result=undefined Uniconify: Returns to main program from iconified state. ARexx results: RC=0 Result=undefined User1, user2, user3, user4: These commands will invoke the four user definable commands associated with your filetypes, in the default configuration the command user1 is defined to extract files from archives. ARexx results: RC=0 Result=undefined Verify: Verify [text] Text optional; text to display in requester Displays "are you sure?" requester. if this is included in a multi- command operation, cancel will abort the rest of the commands. ARexx results: RC=0 Result=0 is cancel, 1 is okay Version: This command displays information about Directory Opus, Kickstart, Workbench and your computer. ARexx results: RC=0 Result=undefined 4. 1 Simple argument functions: {d} Destination directory windows path This will insert the path of the destination directory window. {f} First selected entry (with path) Insert the path and filename of the first selected entry. The entry will then be deselected. {f} All selected entries (with paths) Insert the path and filenames of all selected entries. The entries will then be deselected. AmigaDos has limited the length of the command line to 256 characters. Therefore, if the length of acommand line exceeds 256 characters because of a {f} sequence (or for any reason), another command line will be created for the next lot of file entries until there are no more selected file entries. {fu} First entry (with path, do not deselect) The same as {f} except that the entry is not deselected. {fu} All entries (with paths, do not deselect) The same as {f} except that the entries are not deselected. {o} First selected entry (name only) The same as {f} except that only the name of the first selected entry is used, without the pathname. {o} Allselected entries (names only) The same as {f} except that only the names of the selected entries are used, without the pathname. {ou} First entry (name only, do not deselect) The same as {o} except that the entry is not deselected after it is used. {ou} All entries (names only, do not deselect) The same as {o} except that the entries are nor deselected after they are used. {p} ARexx port/public screen name This will insert the name of the rexx port for this invocation of Directory Opus. Every Directory Opus running will have a unique Rexx port name. this is the same name used for the public screen name. {s} Scource directory windows path This will insert the path of the scource directory window. 4.2 Requester functions: {rdtitle:default} Directory requester Default can be any valid pathname. {rftitle:default} File requester Default can be any valid pathname or filename {rftitle:default} Multi-select file requester Default can be any valid pathname or filename {rotitle:default} Font requester Default can be any fontname. a pointsize can be specified with a slash followed by a number (i.e. topaz/8). {rstitle:default} Requester that asks for some text Default can be any text. The title string that will appear on the requester. You can just omit the title string, in which case a default title will be used. The default string (preceded by a colon) is the default string that is to appear in the requester. this too can be omitted. The default string can contain bracketed letters. These tell Directory Opus where to insert additional information into the requester. The supported bracketed letters include... [o] Inserts the last referred filename, only the filename [f] Inserts the last referred filename, both path and filename [s] Inserts the source directory windows path [d] Inserts the destination directory windows path For example, it would be possible to have your own custom rename button with the following call function: c:rename {f} {reenter new filename:foo. [o]} In this case a string requester would open with the title "enter new filename"and the default of the string field would be "foo. " Followed by the selected filename. Chapter 5: Appendices: 5. 1 Glossary: Some terms used in this manual that you may need to know are: Active: (directory window) Denoted by a highlighted disk name. This is the scource directory, the directory that all commands will act upon. Buffers: A directory buffer is an internal storage area for directory information. whenever Directory Opus reads directory information from a disk, it stores the information in a directory buffer. By storing the directory information in a buffer, Directory Opus can avoid unnecessarily re-reading the disk. Click-m-click: This is a Directory Opus term. To click-m-click is to click once with the mouse button, move the mouse to another part of the screen, and press the mouse button again, all within the double-click time set from preferences. Directory window: One of the two windows on the screen in which entries are displayed. Double-click: An Amiga term, this means to click twice with the mouse button (usually the left button, but sometimes the right button) on an object, within a pre-determined time. The time is set from within preferences, and you should consult your Amiga manual for more information on this. Drive gadgets: The 30 gadgets, of which only six are visible at once, that enable you to easily read any directory. Entry: Either a file or a directory. File types: A file type is a set of user-defined tests to see whether a file is of a certain type or not. Actions can then be performed on the file, depending on its type. Highlight: Highlight is the term given to the changing or reversal of colours, usually when an object is selected. Inactive: (directory window) Disk name is not highlighted. This is the destination directory, and files may sometimes be written here from the scource directory. Menu: A pull-down menu is like a list of gadgets. A menu is accessed by moving the mouse to the top of the screen and holding the right mouse button. Open: A directory that is currently displayed is said to be open. Requester: A requester is usually a box that appears on the screen, soliciting a responce. Some requesters require a string input, others simply ask you to choose yes or no. Rmb button: A Directory Opus term. This is a button that is selected with the right mouse button, instead of with the left. Selected: Entries are selected when they are highlighted. This is usually done by clicking on them with the left mouse button. 5. 2 How we start external programs: Directory Opus uses the small (4k) AmigaDos program. Dopusrt, to help it launch Amigados, Workbench, batch and ARexx programs. When you start up an external program a script file is created in the t: directory. This script file contains all the initialization and execution code needed to start up and manage your programs. The Dopusrt program is called at the end of the script file, and communicates with Directory Opus to inform it when the script file has finished running. This is needed for functions that are not run asynchronously. It also doubles as a wait command, which is needed for the adjustable close delay. To take advantage of the current directory changing, adjustable stack, and priority you will need the commands cd, stack and changetaskpri in your computers c: directory. You will also need the commands run, execute, failat, newcli and endcli. These are almost always present in your c: directory anyway, so you should not need to install them. There are a couple of other points to be aware of. Because external programs are run via a script file, they can be aborted like any other script file by pressing ctrl-d. This is only possible if you have an output window selected. If the script file is aborted in this fashion, the output window effectively turns into a cli, so you must type endcli to remove the window. The second point is that if the program was not run asynchronously, Directory Opus will be frozen, waiting for the siganl back from the dopusrt program. If you abort the script file before it reaches dopusrt, Directory Opus will never unfreeze. You can force Directory Opus to unfreeze by activating the Directory Opus window and pressing shift-esc (the shift key in conjuction with the escape key). This allows you to turn any non-asynchronous program into an asynchronous program, while the program is running. Note that when using newcli or newshell as the output command, an error such as unknown command will abort the script file as well. You should therefore make sure that all your buttons, filetypes, hotkeys or menus do not try to run nonexistent programs. 5. 3 Wild card patterns: Directory Opus can use wild cards to make some tasks easier. Wild card characters are expressions that tell Directory Opus to match (or not match, in some cases) more than just one character. You may already have encountered pattern matching in the descussion of the rename command. ? This token will match any single character, but does not include none. For example, fi?e would match file, fine and fire but not fie. # This character tells Directory Opus to match the following expression 0 or more times. For instance, fre#d would match fre, fred, fredd, freddd, etc. "#?" will match anything, just like "*" (see below). () Is in effect an or (p1|p2|p3) will match on any one of the patterns p1, p2 and p3. for instance, (d*g|c*t) would match dog, cat, dig, cot, etc. you may include aas many patterns inside the parentheses as you like, separated by vertical bars (|). | Use this token within parentheses to separate different expressions you wish to match at the same time. for example, "(ab|cd)" will match any one of the items separated by "|" (here, "ab and cd). % Matches 0 characters. This is always (usful in an instance like "(foo|bar|%)"). another example: "ca(m|%)p" will match camp and cap. * Synonym for "#?", an asterisk will match any number of repititions of any characters, including none. For instance, "f*" will match f, fr, fre, fred, fredd, freddy, etc. ~ The tilde can be used to negate an expression. Anything that would normally match, now will not match. for example, "f~(rog)" will match from but not frog. "~j*" will not match anything starting with j. [] Brackets enclose a list of characters ( a "character class") that match of the characters in the class. "[abc]" tells Directory Opus to match either "a", "b", or "c" in this position. ~ A tilde at the begining of a character class matches any characters that are not in the class. For example, [~bc]" says "match any character except "b" or "c". - A hyphen indicates a character range (only within character classes). The expression "[a-z]" represents all the loweRCase letters from "a" to "z". ` (Apostrophe or single quote) Use this character to declare the following character to be a literal character, used as it stands instead of as a wild card. This permits you to use the characters #, ?, |, %, (, ), [, ], *, ~ and even an apostrophe as themselves rather than as pattern-matching control characters. For instance, year*`% will match year1989%, year1990% but not year1989 or year1990 as would normally be the case, with % meaning match on nothing. Note that this means that you must use `` to match an apostrophe. Note "expression" in the above tabe means either a single character (ex:"#?"), or an alternation (ex:"#(ab|cd|ef)"), or a character class (ex:"#[a-za-z]"). 5. 4 Shortcut keys: These are the default shortcut keys. Each of these can be redefined using the configopus utility. Addicon: left shift ctrl i All: ctrl a ARC extract: ctrl e Check fit: ctrl f Clone: ctrl l Comment: left shift ctrl c Configure: right amiga c Copy: ctrl c Date stamp: ctrl d Delete: left shift ctrl d Edit: left shift ctrl e Get sizes: ctrl g HEX read: ctrl h Hunt: left shift ctrl h Iconfy: right amiga i Icon info: ctrl i Make dir: ctrl m Move: left shift ctrl m None: ctrl n Parent: ctrl p Play: ctrl y Print: left shift ctrl p Protect: ctrl t Quit: right amiga q Read: ctrl r Rename: left shift ctrl r Root: ctrl o Run: ctrl u Search: left shift ctrl s Show: ctrl s 5. 5 Simple shortcut keys: Toggle help mode: help Active directory field: return key Max right window: - Max left window: \ Centre windows: = Change active window: spacebar Scroll window up one line: up arrow Scroll window down one line: down arrow Scroll window to top: shift up arrow Scroll window to bottom: shift down arrow Scroll window right one column: right arrow Scroll window left one column: left arrow Scroll window to far right: shift right arrow Scroll window to far left: shift left arrow ============================================================================ Changes made to Directory OPUS version 4.10 that are not reflected in the printed manual. If you are just getting started, you may not be too concerned with this information yet. However, there are a couple of new options in the Configuration Program which do not appear in your printed manual.These comments assume some familiarity with using Directory OPUS and its configuration utility. ============================================================================ Directroy OPUS, Version 4.10 DOpus.Library, Version 22.5 New Shortcut keys ----------------- The following shortcut keys have been added: Shift-Return Displays the Buffer List in the current window. Alt-Return Displays the Device List in the current window. LAmiga-Space Scrolls to first selected file RAmiga-Space Scrolls to first selected directory ] Displays the next gadget bank [ Displays the previous gadget bank Furthermore, when showing a list of pictures, the Return key will proceed to the next picture. =============================================================================== Skip All while Searching ------------------------ When a text string is found while searching multiple files, a requester appears asking you if you want to read the file. A "Skip all" button has been added. Selecting this button continues searching the selected files without bringing up this requester. As a result, the files containing the search text will remain highlighted, files which do not contain the search text will be deselected. At this point you can do some other operation on the selected files (the ones containing the text). For example, this is a great way to copy files which contain some text string. =============================================================================== Choosing the Parent of your Choice ---------------------------------- You can now bring up a requester which shows all the Parent Directories for the current directory. Simply double-click on the current directory's Diskname bar. Selecting an entry and clicking Okay, or double-clicking an entry will read the selected directory. Also, if the current directory, or any of its parent directories have multi-volume assigns (see your AmigaDos documentation), these will be displayed in the list as well. =============================================================================== Double-Click an already selected entry -------------------------------------- You can now double click on a selected file or directory. Previously, you had to un-select the entry before performing the double-click operation. Now it will perform the appropriate double-click operation. =============================================================================== File Name completion -------------------- If you are editing the Directory Field for a Directory Window, and you are going to type the name of a sub-directory - you can save a few keystrokes by starting the name and press the Help key. Directory Opus will fill out the subdirectory name with the first name which starts with the name you filled in. Subsequent presses of the Help key will cycle through all matching directory names. =============================================================================== Using Workbench Iconify Window as a File Viewer ----------------------------------------------- You can drop Workbench Icons on Directory OPUS's Iconified Window bar to view the file. OPUS will view the file in the same manner as a double-click from Directory OPUS's main window. In other words, a Picture is shown, a Text file brings up OPUS's text viewer, etc. =============================================================================== Running Format, Diskcopy, Install, and Info requester from a Shell ------------------------------------------------------------------ You can run OPUS's Format, Disk Copy, and Install requesters directly from an Amiga Dos prompt without going through Directory OPUS. All three are contained in the program DOpus:modules/DOpus_Disk. You select between the three by giving a command argument of F for Format, D for Disk Copy, and I for Install. For example: >DOpus_Disk F ;Brings up Format >DOpus_Disk D ;Disk Copy >DOpus_Disk I ;Install These can also be started from the Workbench; see below for the required Tooltypes. You can also run OPUS's Icon information requester directly by running the program DOpus:modules/DOpus_Icon. It needs a filename as an argument. The ".info" on the end is optional. >DOpus_Icon sys:prefs.info >DOpus_Icon sys:prefs ============================================================================ Tooltypes and Command Arguments ------------------------------- The following Tooltypes and command arguments are supported: Directory Opus Tooltypes Command Argument ------------------------------------------------------------------------ ICONSTART -i Start iconified BUTTONSTART -b Start button-iconified CONFIGFILE -c Specify new configuration filename CHECK -g Check if Opus is already running DOpus_Disk OPERATION=Format f Format OPERATION=Diskcopy d Diskcopy OPERATION=Install i Install ============================================================================ Save Button is back ------------------- The "Save" Button on ConfigOpus's main screen, which was removed in version 4.0, is back. Clicking this button saves the configuration without bringing up the file requester. ============================================================================ Help Button is gone ------------------- The help button, which was represented by a "?", has been removed from the ConfigOpus screens. The Help key still displays the help for the current screen. ============================================================================ Display Copy Progress Indicator ------------------------------- You can now have Directory OPUS display a Copy Progress Indicator, a bar which shows how much of a file has been copied or moved. This option has been added to the "Operation/Update" Editor in Config OPUS. This is especially useful when copying large files. The Progress indicator will appear when using the Copy, CopyTo, Move, MoveTo, Clone, and Encrypt operations. ============================================================================ Drop Icon change ---------------- If you are running AmigaDos 3.0, ConfigOpus will open on the Workbench screen if possible. When it does this, the AppIcon (described on p. 91) will not appear on the Workbench screen. Instead, drop the Icons directly on the editor Window. ============================================================================ Paint Mode ---------- In the Buttons, Menus, and Drives editor screens, there is a new menu called "Tools" with a menu item called "Paint mode". Paint mode allows you to easily set the colors of many items without bringing up the editor for each of them. Selecting the "Paint Mode" menu item brings up a requester which allows you to select the Foreground and Background colors you want to paint with. When you select Okay, the title on the Editor will contain the text "(Paint Mode Active)" and the "Paint Mode" menu will have a checkmark next to it. When you click on a Button in the Button Editor, the button will be painted with the selected colors (the Menu and Drives editors work in similar manner). You can click on as many buttons as you wish to paint. When you are done painting with these colors, select the "Paint Mode" menu item again. This will turn off Paint Mode. If you want to paint with some other colors, simply select the menu item "Paint Mode" again to restart the process. ============================================================================ New options in Screen/General ----------------------------- 'Display status text in title bar' This removed the status bar at the top of Directory OPUS's main window and uses the the title bar for status messages. This gives you a little more room for viewing files. 'New-look menus' (Only for AmigaDos 3.0 and later) Uses the new-look black on white menus. With this flag enabled, any menu items that use the default colors of 0 on 1 will be automatically mapped to 1 on 2. 'Custom screen window borders' Turns on the new Window look described below. ============================================================================ New Window Look --------------- Starting with AmigaDos version 2.0 Commodore established user interface style guide standards. The purpose of these standards is to provide Amiga owners a consistant interface for the various programs they are using. We strongly believe in this philosophy and are continuously evaluating our products in regard to this standard. As a result, some changes have been made to Directory OPUS. Primarily, Directory OPUS, and Config OPUS now have a slightly different look. For those who are interested in such details, OPUS used to open a borderless, backdrop window when open on a custom screen. Now, when the 'Custom screen window borders' flag is selected, or Directory OPUS is open on the Workbench or another public screen, it now opens a window with OS-supplied borders, Close, Zoom (under 2.0) and Depth buttons. As a result, it has real window borders. It also means the Depth button in the upper right corner is a Window Depth Button. Before it was a Screen Depth Button. Window Depth Buttons arrange Windows on a screen, Screen Depth Buttons arrange the screens. If you click on the Window Depth Button and Directory Opus does not push to the back, don't be alarmed. Below, we will tell you how to resize the Directory Opus Window to get access to the Screen Button. We also added an invisible Window Size Button in the lower right corner. When you click on the border in this corner you can resize the OPUS window. To resize the OPUS window to give you access to the Screen Depth button, perform the following steps. - Click on the Window Size Button on the window border in the lower right corner and move the mouse pointer up an inch or so. This will give you room to move the Window down. - Click on the Window Drag bar, at the top of the OPUS window, drag it down. When you release window, the Screen Title Bar and its Depth button will be exposed. - Using the same Window Drag bar, position the window so you can see as much of the Screen Title Bar as you wish. - Finally, using the Window Size Button, in the lower right corner, drag the bottom of the window as far as it will go down and to the right. Remember, to save the Window position and size, go to ConfigOpus and save the configuration. It will save the current window settings. ============================================================================ Open Directory OPUS on a Public Screen -------------------------------------- The Display Mode list in the "Screen/Screen Mode" editor in ConfigOpus will include any Public Screens allowing you to open OPUS on the selected screen. ============================================================================ Screen/Sliders Editor --------------------- There is a new editor in the Screen configuration called Sliders. This editor allows you to select the position of the Window View Sliders. Simply click on the buttons above the simulated window views to toggle them between Right and Left. ============================================================================ The SHAM is back ---------------- The controversial SHAM picture is once again handled by OPUS's picture displayer. This mode, while unsupported by Commodore, has some popularity. We removed it in Version 4.0 because of its unstable nature. We took it out because we could not get it to work with all SHAM pictures and Commodore refuses to give support to this rogue format. As a result, we do not guarantee it will work. With all that said, our SHAM viewer does work with most SHAM and now also PCHG pictures. Invalid SHAM pictures may still cause problems. ============================================================================ New Modify/Query Command options -------------------------------- WindowXY - Change window position (immediately) WindowWH - Change window size (immediately) PubScreen - Open up onto public screen (need to also set ScreenMode to 3 for public screen and do a Redraw) ============================================================================ FileClass Move & MoveTo now accepts $ hex values ------------------------------------------------ The Move and MoveTo operations in FileClass identification now accepts Hex values which are proceeded by a '$' character. For example: MoveTo $100 - Moves to the 256'th byte in the file ============================================================================ New command : SetVar -------------------- SetVar Sets the specified local environment variable to the given value. Return codes : RC=0 Success RC=10 Attempted under 1.3 (only works under 2.0) RC=20 Incorrect arguments given RC=30 Failed (RESULT=DOS error code) New command sequence : {v} -------------------------- {v} Inserts value of named variable in command string. Example : Command SetVar testvar {RsEnter something} AmigaDOS Echo You typed : "{vtestvar}" ============================================================================== Documentation for those who have tried to use AddCustHandler ------------------------------------------------------------ This is the ARexx arguments which get passed to a Custom Handler Arg0 - Operation type (1=Double-click, 2=Click-m-click) Arg1 - Entry number (This is the ordinal number of the selected entry. Note that this number is assigned in the order that the entries are added; if an entry is not added at the end of the list, this number will not correctly reflect its position in the list) Arg2 - Entry text (This returns the text for this entry) Arg3 - Userdata (This is the user-assigned data for this entry. We suggest that you possibly use this value for keeping track of entries rather than the Entry number returned in Arg1). _ . _ \\ _ _ __ ___ ____ _____..ooğOğoo.._____ ____ ___ __ _ _ // \\ \\ _ \\\\O//// _ // // \\ \\ \\ _ \_____/ _ // // // \\ \\ \\ \\ _ // // // // _____/ \_____/ \_____/ \_____/ \_____/ \_____/ \_____/ \_____/ \_____/ \_____ - -- --- ---- ----- ---------> F A I T H <--------- ----- ---- --- -- - ___ _______ _______ ________ __ ______ _______ _______ /\_/\ \_ \\\\/\_ \\\\ \_ \\\\/ \ / \\\\ \_ \\\\/\_ \\\\ / /\/ / \__ \ \____/\ / \_____/ \/¯\___ \/ \__ \ \____/\ / / / / // / _ \/ / __/\ / \ \ / \\ \ // / _ \/ / \/¯¯¯\ // /¯¯¯¯¯\\ \ / \/¯¯¯\ /\ / // / // /¯¯¯¯¯\\ \ \________/\_¯ /\_ ¯ /\ \_ / / /\_ / ¯ /\_¯ /\_ ¯ /\ \ \/\¯¯¯¯\/\¯¯¯¯¯¯¯¯\/nox\¯¯¯¯¯¯¯¯¯\/ \¯¯¯¯¯¯¯¯¯\/\¯¯¯¯\/\¯¯¯¯¯¯¯¯\/ ¯¯¯¯¯¯¯¯ ¯¯¯¯¯ ¯¯¯¯¯¯¯¯¯ ¯¯¯¯¯¯¯¯¯¯ ¯¯¯¯¯¯¯¯¯¯ ¯¯¯¯¯ ¯¯¯¯¯¯¯¯¯ <===========Y=0=U=R====R=O=Y=A=L===L=I=N=K===T=O===H=E=A=V=E=N============> __ _______________________________________________________________ __ \ /__/ \__\ / /\ // SysOp: GANDALF/FAITH NODE 1&2: +49 (0) 0NLY ELITE! \\ /\ \//¯_________________________________________________________________¯\\/ ¯\/\_/ \_/\/¯ /¯\\/ CoSysOp:COROPLEX/J-F-K/JONNY WALKER/ROMULUS/MIKE HAMMER \//¯\ _/ /¯\___________STÖRTEBECKER/[-RUNT&SCOTTIE]__________________________/¯\ \_ \/ \ / \/ ¯¯ ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ ¯¯ ------> Configuration: A3000, 4MB, 1,5 GIGS, 48 H0URS-WAREZ, 2 PORTS <------ O-----------------------[wHERE tHE wARES cOME fROM]------------------------O :____.__ ____________________ __.______________________________________.___: \_ _ \ |_ _/ _ _/ _ ___ \___Y |____ \__/ _ __ __/_ __/ __ __)_/ __ \| _/ : / / |/\/ / \/ / \| \ \/\| | | \ \/ __// /_| |_\ \| |/ / \ . \ |: : \ \ | \ \ \ \ \ / \ \ : | / \ \ | / | | | \ : \ \ \ |: :____ /_____\___/____/____ /____| |____ /____|____|__:____ /__|____ /_:\__|: : \/ \/ \/ + \/ \/ : : : : Uploaded Time: 17:47:57 [...] Uploaded Date: 93-Jul-24 : : : O-------------(nODE1: 49-o2324-22698 - nODE2: 49-o2324-54552)--------------O ### BLOOD_TXT V2.0 © XRAY/MSQ ### °