Logo2
Logo
bigstockphoto_Businesswoman_Sit_With_Noteboo_227734
 

Commands and Custom Buttons

With Directory Opus 5, you can create your own custom buttons
which execute your desired commands at the click of the mouse.
Buttons are grouped together in a window called a Button Bank.
Any given bank of buttons may show either graphical images or
text, but you may not mix graphics and text in the one bank. You
may have as many banks open at any one time as you desire.
The modular design of Opus 5 means that Button Banks are fully
independent tasks and the buttons themselves are interchangeable
between different banks. Even editing of button banks via the
Button Editor is independent of other program operations, so you
do not need to stop other activities to create, load, edit or save
banks.

Each button can execute an unlimited set of instructions, which
may be triggered by the action of a left, middle or right mouse
click on the custom button, or by selecting an item from the
button's optional pop-up menu. Instructions may include any mix
of AmigaDOS, Workbench, ARexx, Script or Opus 5 commands.
Right mouse button commands and pop-up menu commands are
indicated by a 'dog-ear' in the upper right of the button. For
middle mouse button commands, the 'dog-ear' appears on the
bottom left. This also applies to graphical Button Banks.
With Opus 5.5, you can now define an infinite set of pop-up menus
for each button. This allows you to group a larger number of
related functions in one place and select the specific one when
required. Holding down the LMB on a button displays the full list
of commands attached to that button. Releasing the LMB over a
command brings this command to the top and makes it the default
LMB command.

Scope and Focus of Buttons

Many button commands act on the selected files in the current
source (SRCE) directory, or between the source and destination
(DEST) directories. When creating and using buttons, it is very
important that you understand both what the command does, and
what files and directories it will affect. This is known as the scope
and focus of a button.
Novice Opus 5 users can be confused when they have clicked on a
custom button and nothing happens. Often they have no SRCE
window selected!
+Before clicking on a custom button, verify that the intended
SRCE and DEST directory windows are set correctly.

Special Buttons Menu

As well as from the global Buttons menu,
Opus 5 also provides a special menu directly
attached to each button window. This gives
quick access to popular functions.
To access this menu, move the mouse to the
button window title bar and press the right
mouse button to display the menu. If you
have 'Mouse buttons over inactive banks' in
Options / Miscellaneous disabled, you will need
to activate the Button Bank window first.
The menu options are identical to those provided in the global
Buttons menu, except that this special menu allows you to iconify
the button bank to save space on your Opus backdrop window.
When iconified, the button bank will have a pop-up menu which
will allow you to open the button bank again, or close it for good.
You can also re-open it by double-clicking on the icon.

Internal Opus 5 Commands

As already explained, each button can execute a set of instructions
including AmigaDOS, Workbench, ARexx, Script or internal Opus
commands. The list of internal commands which Directory Opus 5
offers for each custom button or menu is shown below. Each
command is discussed in detail in the following section.

Commands
AddIcon
Alarm
All
AnsiRead
Assign
Beep
CacheList
CheckFit
CleanUp
CloseButtons
CLI
Comment
Confirm
Configure
Copy
CopyAs
CreateFiletype
DateStamp
Delete
DeviceList
DiskCopy
DiskInfo
DoubleClick
DragNDrop
Duplicate
Encrypt
FindFile
FindFiletype
FinishSection
Flash
Format
FreeCaches
FTPAddressbook
FTPCD
FTPCommand
FTPConnect
FTPCopy
FTPDelete
FTPQuit
FTPRename
FTPSetVar
GetSizes
HexRead
Hide
IconInfo
Join
LeaveOut
LoadButtons
LoadEnvironment
LoadOptions
MakeDir
MakeLink
MakeLinkAs
Move
MoveAs
None
Parent
Play
Print
PrintDir
Protect
Quit
Read
Rename
ReSelect
Reveal
Root
Run
ScanDir
Search
Select
Set
Show
SmartRead
Split
Toggle
User1
User2
User3
User4

AddIcon NAME, BORDER/S, NOBORDER/S,LABEL/S,
NOLABEL/S, CHANGE/S
Adds icons to all selected entries in the active Lister. Directory
Opus 5 will automatically sense the type of file and the
appropriate icon for a drawer, tool or project. The icons used
are the current system default icons as defined in ENV:Sys
directory. (See your AmigaDOS manual for more details.)
The BORDER and NOBORDER switches turn the icon border
on or off. The LABEL and NOLABEL switches turn the (text)
label on or off. If CHANGE is specified, the state of the
borders or labels of existing icons will be changed without
creating new icons.
AddIcon operates on all files selected in all current SRCE Listers.
+ Since this command uses the Amiga’s default icons, it may
fail if the correct default icons of the required type are not
available in your ENV:SYS directory. If this happens, run the
Amiga IconEdit program to create and save a set of default icons
for the various file types. For more information on the creation
and editing of default icons, please consult your AmigaDOS user
manual.

Alarm
This command compliments the Beep command and produces
a short siren sound effect rather than a simple beep. Use this to
provide a more noticeable or urgent warning sound than
would be indicated by a simple beep.
See Also: Beep, Flash

All
Selects all entries in any and all of the SRCE or selected Listers
See Also: None,Toggle, Reselect, Select

AnsiRead NAME/F
Invokes the Opus viewer in ANSI mode which interprets and
displays any special ANSI control sequences.
See Also: HexRead, Read, SmartRead

Assign
Allows you to create AmigaDOS assignments for the path as
shown in the Directory Path gadget at the bottom of the active
SRCE Lister. A requester is opened with a set of buttons for :-
Assign: Create an assign for this directory with the
specified name. (Default)
Add: Add this directory to the existing assign with the
specified name.
Path: Add the path of this directory to the existing assign
with the specified name.
Defer: Create a deferred assign for this directory which
will become active only when first accessed.
Abort: Abort the assign operation.
For a more details discussion, refer to your AmigaDOS manual

Beep
This command will sound a beep on either or both of the
sound channels. You could use this command to signify that a
command has finished.
For instance, you could create aDiskcopy button to read:-
Command DiskCopy
Command Beep
See Also: Alarm, Flash, FinishSection

CacheList NEW/F
Displays a list of all the currently buffered directories. Click on
one of the displayed buffers to jump to that buffer
immediately, rather than having to locate it manually.
If there is no current SRCE Lister, a new Lister will be opened.
If the NEW switch is used, a new Lister will always be opened.
See Also: DeviceList

CheckFit
Tests whether the selected files will fit on the destination drive.
A requester displays the number of bytes needed, the available
space, and the percentage of the file which will fit on the
destination drive.
CheckFit works between ALL SRCE directories to the first DEST
directory ONLY.

CleanUp
An Opus housekeeping command. It examines the internal
‘position-info’ file and remove references to any directories or
left-out icons which no longer exist on your system.
References will only be removed if the parent volume is
mounted and available on your system so entries from
removable media will be preserved.

CLI
This is a new debugging command added for Opus 5.5 for the
more advanced users. It opens up a Command Line Interface
or Shell type window where you may enter internal Opus
commands and ARexx functions directly. Such commands
operate on highlighted files and between SRC and DEST
Listers just as if you had them attached to a button or menu.
The CLI is useful to test Opus commands or for quickly
entering Opus commands which you have not set up in a
button or menu. Type ‘Help’ in the window for more
information.

CloseButtons NAME, ALL/S
This command closes the current button bank, a named button
bank, or all button banks. CloseButtons closes the bank from
which the function was launched. CloseButtons <NAME>
closes a named bank and CloseButtons ALL closes all button
banks
See Also: LoadButtons

Comment NAME, COMMENT/F, RECURSE/S
Adds or edits the comment field of all selected entries in the
Lister. The maximum length of a comment is 79 characters.
The RECURSE switch enables recursive access to any files in
selected subdirectories, subject to the global Recursive Filter.

Configure
Displays the Lister Format Editor for the current SRCE Lister.

Confirm TEXT/A
Displays a simple requester showing your chosen TEXT and
presenting the user with the choice of ‘Ok’ and‘Cancel’ buttons.
If the user selects the ‘Cancel’ button the Command script will
be terminated at this point.

Copy NAME, TO, QUIET/S, UPDATE/S
Copies the selected file(s) from the SRCE directory to the DEST
directory.
If any directories are selected to be copied, the global setting of
the Recursive Filter will determine which files are copied. See
global menus Settings/Recursive Filter for more details.
If the UPDATE switch is specified, only files which do not
already exist will be copied.
If multiple SRCE or multiple DEST directories are selected, the copy
command will copy all selected items from the SRCE directories to
all the DEST directories in turn.

CopyAs NAME, NEWNAME, TO, QUIET/S
Copies the selected file(s) from the SRCE directory to the DEST
directory using the new name that you specify. Wildcards can
be used here; see the Rename command for more details. If any
directories are selected to copy, the Recursive Filter determines
which files will be copied.
Copies multiple SRCE to multiple DEST directories if more than one
is selected.

CreateFiletype
Invokes the Filetype Creator which can be very useful for
automatically making Opus Filetypes for unknown files,
especially if you do not know much about file formats. For
detailed information on the Filetype Creator, see page 152.
See Also: FindFiletype

DatestampNAME, RECURSE/S, DATE/F
Allows you to change the datestamp of the selected files and
directories in the active Lister. If directories are selected, you
will be given to option to modify the datestamps of the files
within them.
The RECURSE switch enables recursive access to any selected
files in subdirectories, subject to the global Recursive Filter.
For each entry, you will be presented with a requester. To set
the datestamp of the file to the current date and time, simply
press return. Otherwise, enter the date and time you want.
Choose the ‘OK’ button, or press RETURN, to set the
datestamp one file at a time. To set the datestamp of all
selected entries at once, select the ‘All’ button from the
requester.

Delete NAME, QUIET/S
Deletes all the selected entries in ALL current SRCE Listers.
Be careful with this! It is easy to wipe out valuable data if you
are careless. For safety, Directory Opus 5's default
configuration displays a requester before deleting files.
Nevertheless, you should always double check the selected
files before clicking any button which uses this command.
The Delete command works on ALL SRCE Listers in turn.

DeviceList NEW/S, FULL/S, BRIEF/S
Displays the list of all devices, volumes and assigned
directories in the current SRCE Lister. If the FULL switch is
added, the list of Assigns is expanded to show the full path of
the assigned volumes plus any multi-directory assigns.
Alternatively, if the BRIEF switch is added, only the devices
will be shown.
If there is no current SRCE Lister, a new Lister will be opened.
A new Lister will always be opened if the NEW switch is
specified.
When the device list is in Icon or Icon Action mode, you can
delete and rename assigns using the icon menu.
See Also: CacheList

DiskCopy
Invokes the Opus 5 Diskcopy Requester allowing you to select
the source and destination drives and parameters for copying
disks. (See page 185.)

DiskInfo
Displays information on the parent disk of the current SRCE
Lister. This command works only in a Lister, it does not work
on a selected disk icon. For icons use the global menu item
Icons/Disk Information.
This command works on the active SRCE Lister ONLY.

DoubleClick NAME/F
DragNDrop NAME/F
Execute the defined action for either DoubleClick or
DragNDrop as defined in the Opus filetype for files of the
selected type. ( See Filetypes on page 139 for details.)
Commands work on all files selected in all current SRCE Listers.

Duplicate NAME, NEWNAME, QUIET/S
Makes 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. Wildcards can be used here; see the Rename command
for more details.
The Duplicate command works on ALL SRCE Listers.

Encrypt NAME, TO, PASSWORD, QUIET/S
Have you ever had files that you wanted to encrypt so that
only people who knew the password could understand them?
This command 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 and click on the Decrypt files checkbox, or
precede the password with a minus sign. For example, to
decrypt files encrypted with the password ‘SMEG’, select the
files, choose the encrypt command and enter ‘-SMEG’ as the
password.
Encrypt operates on all files selected in all current SRCE Listers.

FindFile
Searches all selected subdirectories in all SRCE Listers for a
specified file or files. A requester will appear asking for the
pattern to search for. You can use full AmigaDOS pattern
matching for searches.
If a file matching the pattern is found, you may enter the
directory containing it, or to continue the search. If you enter
the directory, all matching entries will be highlighted.

FindFiletype
This command invokes the Filetype Finder which can be used in
finding, installing, and creating Filetypes for the selected files.
For details, see the FileType Creator on page 152.

FinishSection

Forces any preceding programs (AmigaDOS, Workbench,
Batch or ARexx) to finish executing before carrying on to the
next command. Note that the next command need not be an
Opus command; it is just more likely that it will be one.
For instance, to add a beep to the end of the LHArc list Filetype
command, you would change the command list to read:-

AmigaDOS LHARc v {f}
Command FinishSection
Command Beep

Flash
This command has the same uses as the Beep command. It is
different in that it calls the system DisplayBeep function so that
it will flash the display and/or produce a beep or sampled
sound as defined by the Sound preferences program.
See Also: Alarm, Beep

Format DRIVE/F
Allows you to format a new disk. All new disks need to be
formatted before the computer can write to them.
Without arguments, the command will display the Opus 5
Format Requester allowing you to choose the disk to format and
other parameters. (See page 187.)

FreeCaches
Clears all the internally cached directory buffers which are not
currently displayed and frees all unused memory. If you are
running a bit low on memory, this is a good way to free
memory quickly.
If your system uses WB 3.0 or higher, Opus 5 will install its
own internal low memory handler which will flush all unseen
buffers automatically if required under low memory
conditions.

GetSizes FORCE/S
Causes any selected subdirectories in ALL SRCE Listers to be
scanned to calculate the total size, in bytes, of all files contained
in the subdirectory. Once scanned, the sizes of the subdirectory
will be displayed in the Lister. It 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 a subdirectory has been previously scanned, it will not be
rescanned when you use the GetSizes command unless you use
the FORCE switch.
GetSizes only checks the SRC Lister. If you wish to check if the
selected files would fit on the DEST, use the CheckFit command.
If you select an operation which causes a subdirectory to be
scanned (e.g., Copy, Protect, FindFile, etc.), the size will be
displayed as though you had performed a GetSizes.
GetSizes works on ALL SRCE Listers in turn.
See Also: ClearSizes, CheckFit

HexRead NAME/F
Reads and displays 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.
Shown above is an example of the Hex Viewer’s output. The
first value is the offset, displayed in hex. This is the offset
position, in bytes, from the start of the file. The next four
values are each a four-byte long-word, with the actual ASCII
representation at the end. Any non-text characters are shown
with a period (‘.’) character.
See Also: Read, AnsiRead, SmartRead.

Hide
The hide command iconifies Opus 5. It has the same effect as
selecting Opus / Hide from the global menus.

IconInfo NAME/F
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 of Workbench. With this
command, you may select either the ‘.info’ files themselves or
the actual parent files or directories to which the icons refer.
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. If you click on the icon imagery
with the left mouse button, any alternative imagery will be
displayed if it exists. The information displayed for each icon
type is listed below.
Once you have made the desired changes to the icon, the Save
button will save the changes to disk. TheCancel button will exit
without modifying the icon on disk.
Drawer icon: For a drawer icon, you may edit the drawer’s
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 project’s
stack size, default tool and tool types. Also displayed are
the size of the project in bytes and blocks, and the last
modification date.
Tool icon: For a tool icon, you may edit the tool’s
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 a disk icon, you may edit the disk’s Default
Tool. Displayed are the total number of blocks, and the
number of blocks used and free. The block size, creation
date, filesystem type, and read/write status are also
displayed.
Trashcan icon: For a trashcan icon, you may edit the
trashcan’s protection bits, comment and tool types. The
date of the last modification of the trashcan is also
displayed.
Group icon: For a group icon, you may edit the group’s
comment and Tool Types. Also displayed 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 accessible.
Tool types: (where appropriate) 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.
The IconInfo requester allows you to drop other icons on it to
replace the imagery of the icon being edited. Clicking on any
of the Tool Types toggles its state.
Icon Borders and Icon Name
New for Opus 5.5 is a special custom pop-up menu for the
IconInfo requester, just press the RMB when over the IconInfo
requester. The two options allow you to turn off the icon border
and turn off the display of the name shown underneath the icon.
If you are running Workbench version OS3.0 or later and wish
to use a third party replacement for the Workbench
Information function, you can set the ‘DOpus/UseWBInfo’
environment variable, and Opus 5 will call the OS WBInfo()
routine for icon information (this may only work if you have
Workbench running). Use this with patches like SwazInfo.

Join
This command opens the Join Requester showing a list of the
files that were selected in the SRCE directory. From the
buttons, you may add and remove files to or from this list,
clear the list, or rearrange the order of the files to be joined by
moving individual files up and down in the list. Choose the
destination directory, which defaults to the current DEST
directory if one is present, and press the Join button. You will
then be prompted for a filename for the new file.

LeaveOut NAME/F
Places the currently selected files on the Opus 5 Main Window
and permanently leaves them out for easy access.
The command works on all selected entries (files or directories) in all
current SRCE Listers.

LoadButtons NAME/F
LoadEnvironment NAME/F
LoadOptions NAME/F
These three commands take a filename as an argument and
load the Opus 5 component files as described.
LoadEnvironment and LoadOptions will then reset the program
operation to the newly loaded parameters. If only a simple
filename is given, each command searches in the appropriate
Opus 5 path of either DOpus5:Buttons/ or DOpus5:Environment/
or DOpus5:Settings/ for the specified file. If a full pathname is
given, the command will use that pathname instead.

Makedir NAME, NOICON/S, SELECT/S, NEW/S, READ/S
Allows you to create a new subdirectory in the SRCE directory
window; its name is limited to 30 characters.
From the requester, you can choose whether to create an icon
along with the new directory or not. Entering a name and just
pressing RETURN, will either create an icon, or not, according
to the status of the global Settings/Create Icons? menu. The
name of the directory is limited to 25 characters if Create Icons
is enabled. The newly created directory will always be scrolled
into view for further use when in Name mode.
If the optional NAME is used, the command will not ask for
the directory name, but will make it immediately in the current
SRCE directory.
If the optional NOICON switch is used, the directory will be
made without an associated ‘.info’ file.
The SELECT switch will cause the newly created directory to
be selected immediately, and the READ switch will cause it to
be read into a new Lister.
MakeDir works on the first SRCE or current Lister ONLY.

MakeLink NAME, TO, QUIET/S
This command creates a HARD link to files and directories
from SRC to DEST. In essence, it is similar to the Copy
command but creates an Amiga link file in the DEST instead of
copying the file itself. (See the AmigaDos manual for more
information on links.)
By a limitation of the Amiga filesystem, hard links are only
supported to files and directories on the same volume. Soft
links are not supported by Opus 5 and cannot be created with
this command.
To distinguish them from plain files and directories, links are
displayed in bold in Listers in name mode. In icon mode, they
have a little ‘arrow’ image superimposed on them to indicate
that they are links. The same image is shown on any icons
which have been left-out.
Makelinks works from multiple SRCE to multiple DEST directories if
more than one is selected.

MakeLinkAs NAME, NEWNAME, TO, QUIET/S
Performs the same command as MakeLink but allows you to
give each entry a new name in the destination directory.
Wildcards can be used here; see the Rename command for more
details.
MakelinkAs works from multiple SRCE to multiple DEST directories
if more than one is selected.

Move NAME, TO, QUIET/S
Moves all selected entries from the SRCE directory to the DEST
directory. The entry will no longer exist in its original place. If
any directories are selected to move, the Recursive Filter will
be used to determine which files will be copied.
If the Move operation is on the same device, Opus 5 actually
uses the Rename command. On different devices, Copy and
Delete commands are used.
Move acts to move files to a single destination ONLY.
See Also: MoveAs, Copy, CopyAs
+ Be careful with this command! Opus 5 will delete the file if
you are moving it to a different device.

MoveAs NAME, NEWNAME, TO, QUIET/S
Performs the same command as Move, but allows you to give
each entry a new name before it is moved. Wildcards can be
used here; see the Rename command for more details.
MoveAs acts to move files to single destination ONLY.
See Also: Move, Copy, CopyAs

None
Deselects all entries in all the SRCE directory windows.
See Also: All, Toggle, Select, Reselect

Parent
Reads and displays the parent directory of the current
directory open in the SRCE Lister. If the parent directory is
contained in Opus 5's cached buffer list, it will be displayed
without re-reading it. The command is assigned to ‘/’ and ‘?’
keys in Listers. The shifted ‘?’ key opens a new Lister for the
parent.
When the current directory is an assignment, for example, C:,
the assignment will be expanded to the full path
(Workbench:C), whereby the parent command will move to the
parent directory (Workbench:) of the assigned directory.
This command acts on the first SRCE directory only.

Play NAME, QUIET/S
Allows you to listen to sound files. This command plays IFF
8SVX format sound files, raw data files, and a limited set of
SoundTracker type MOD files. It will also play other sound
formats via the datatypes system of OS3.0 and higher. Unless
you have specified the QUIET option, A small requester will
appear while the sound is playing, showing the name, type of
sound file, and playing time. To abort a sound before it has
finished playing, click the ‘Abort’ button in this requester, or
click the ‘Next’ button to skip to the next sound.
Because of some deficiencies in the OS datatypes system, Opus
sometimes cannot tell when a sound being played through
datatypes finishes playing. If this is the case, you will have to
click the ‘Next’ or ‘Abort’ button manually.
+ Due to the explosion in the variety of sound module
formats, e.g. Star/Sound/Noise/ProTracker, Med, OctaMed,
Octalizer, and Med with MIDI modules, Opus 5 cannot play all
such sound formats. To play these formats, we recommended that
you set up a button to call one of the many excellent sound players
currently available. (DeliTracker is an excellent example and can
be readily obtained from AmiNet.)

Protect NAME, RECURSE/S, SET=+/K, CLEAR=-/K
Modify the protection bits of the selected files and directories
in the active directory window. When you select directories,
you will be 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 later.
The RECURSE switch enables recursive access to any selected
files in subdirectories, subject to the global Recursive Filter .
Protect applies to all selected files in all the current SRCE Listers.
The Protection Requester allows you to change the protection
bits of a file or subdirectory. The protection bits are a group of
flags stored with the file, that determine the characteristics of
the file. These flags are given single 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
still be 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 (“made resident”), even when not in
use. This can save a great deal of time, especially if the
program is used often, since 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
cleared. This flag is often used by hard disk backup
programs to record which files have not been changed and
do not need to 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 (ie,
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.
The Protection Requester shows the current file to be modified
and the protection bits currently set. Underneath are two rows
of buttons corresponding to the protection bits which you may
wish to set or clear. When a button is highlighted, it means that
the bit will be cleared or set as shown when you click the ‘OK’
button.
The bottom of the requester gives you buttons to chose the
action required for this specific file.
OK: Causes the current file’s protection bits to be set as
indicated in the display.
All: Causes all selected files to be set, without additional
prompting, as indicated in the display.
Skip: Skips over the current file and moves on to the next
selected file in sequence.
Abort: Aborts the Protect command.

Print NAME/F
Prints the selected files from all the current SRCE directories. It
first displays the Opus 5 Print Requester which allows full
control over print formatting.
New for Opus 5.5, the Print routine automatically prints a form
feed after every file. See page XXX for more details of the Print
Requester.

PrintDir
Print the current directory list shown in the SRCE Lister. The
directory will be printed as currently displayed. To change the
format of the print-out you must edit the Lister format first.
PrintDir works via the Print Requester, giving control over print
formatting.
PrintDir operates on the current SRCE Lister ONLY.

Quit FORCE/S
The Quit command will quit Opus 5, first asking for
confirmation unless you have set Quick Quit in the Options /
Miscellaneous settings. With the FORCE switch, Opus will
always quit without asking for confirmation.

Read NAME/F
Displays the Opus 5 text reader so you may read selected files.
The name of the file is displayed in the viewer window’s title
bar. Since the viewer is an independent program with its own
window, you may open as many viewers to show as many
different files as you wish at any one time.
The Opus 5 viewer provides a number of options from its
menu selections. These include search and print capabilities
and are discussed in detail on page XXX.
Read operates on the current SRCE directory ONLY.
See Also: AnsiRead, HexRead, SmartRead

Rename
Allows you to give new names to all selected entries in the
currently selected SRCE directory windows. 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 an ‘*’
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 an ‘*’.
If you enter an ‘*’ 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 of any entries with the ‘.iff’ suffix. If an entry does not
have a ‘.pic’ suffix, it will be left untouched. The ‘*’ may also be
embedded.
For instance, renaming ‘FOO*BAZ’ as ‘GEE*WIZ’ would
rename ‘FOOBARBAZ’ to ‘GEEBARWIZ’. Again, only one ‘*’
may be used in each of the string Fields.
The Rename command works on ALL SRCE Listers in turn.

Reselect
The Reselect command causes all entries in all SRCE directories
which were deselected by the operation of the previous
command to be reselected.
The Reselect command is assigned to the ‘\’ key in Listers.
See Also: Select, All, None, Toggle

Reveal
This command causes Opus 5 to deiconify if it has been
iconified. It will also bring the Opus 5 screen to the front or
send it to the back if it is already the frontmost screen. It is
equivalent to pressing the hot key combination (by default,
Ctrl + left Shift + left Alt).

Root
Reads and displays the root directory of the SRCE Lister. As
with the Parent command, the buffer list will be searched
before the parent directory is re-read.
When the current directory is an assigned directory, the Root
command will display the root drive of the assigned directory.
When the current directory is a subdirectory to an assigned
directory, the Root command will display the assigned
directory. It is assigned to the ‘:‘ and ‘;’ keys in Listers.
This command acts on the first SRCE directory only.
See Also: Parent

Run NAME/F
Runs each selected file in turn, providing that the file is an
executable program. The action is similar to double-clicking on
the file’s icon, or running it from the CLI. A requester will
appear, asking for any arguments (should you require any).
+ Directory Opus 5 does not provide an ‘Execute’ command. 
This function is handled by the Run command which functions in
the same manner as the AmigaDOS ‘run’ command. If a file has
the ‘s’ (script) bit set, the run command will execute it as a script.

ScanDir PATH,NEW/S, MODE/K, SHOWALL/S
With no arguments, re-reads the current directory in the first
SRCE Lister. If you specify a path, that path will be read into
the current SRCE Lister. If there is no current SRCE, it will
open a new Lister. If the NEW switch is used, it will always
open a new Lister. You may specify the display mode with
MODE=ICON, ACTION or NAME, otherwise the new Lister
will open using the system default as defined by the settings of
the global Lister/ViewAs menu, unless overridden by a stored
snapshot of this path. The SHOWALL switch will cause files
without icons to be visible when in an icon mode.

Search
Searches the contents of all selected files in all SRCE Listers,
and the files within selected directories, for a specified string.
A requester will appear, asking for the search string. There are
also several options available within the requester.
Case insensitive: When checked, any upper and lower case
letters are treated as the same.
Wildcard search: When checked, you can use a question
mark (?) character as a limited wildcard, to mean “match
any character”.
Match whole words: When checked, the string you enter
must be matched in a whole word (if the string is
embedded within a longer string it will not be matched).
You can also specify how the results of the search are
presented to you.
Ask: If a match is found, Opus 5 will ask whether you wish to
read the file. If selected to do so, the text viewer will be opened
and the file will be read automatically.
Leave selected: If enabled, any files that contain the matching
string will be left highlighted. All files that did not match will
be deselected, enabling you to see quickly the files that
contained a match.
Output results: If enabled, the names of files that contained
the matching string will be written to a temporary file. Once
the search has finished, this temporary file will be displayed in
the text viewer.

Select NAME/K, FROM/K, TO/K, BITSON/K,
BITSOFF/K, COMPARE/K,
MATCHNAME/S, NOMATCHNAME/S,
IGNORENAME/S, MATCHDATE/S,
NOMATCHDATE/S, IGNOREDATE/S,
MATCHBITS/S, NOMATCHBITS/S,
IGNOREBITS/S,MATCHCOMPARE/S,
NOMATCHCOMPARE/S,
IGNORECOMPARE/S, BOTH/S,
FILESONLY/S, DIRSONLY/S,
EXCLUDE/S, INCLUDE/S
When called with no arguments, Select displays a requester
allowing you to specify a pattern to match files in the current
SRCE Listers. Files matching the selection criteria will be
selected or deselected depending on the state of the Include or
Exclude switch.
The optional arguments take their names from the fields
displayed in the complex selection requester. If called with
arguments which satisfy a selection criteria, the requester will
not be displayed.
The selection requester may be used in simple or complex
mode as shown above.
See Also: All, None, Toggle, Reselect

Set
The Set command allows you to set certain things regarding
the current Lister or the operation of the current function.
Set Output <handle> - allows you to define the output
handle for the lifetime of this function where <handle> is
CON: or a filename etc.
Set Sort <method> - changes the sort method for the
current source Lister where <method> is either NAME,
SIZE, DATE, PROTECTION, COMMENT, FILETYPE,
VERSION, OWNER, GROUP, or NETPROT (for access).
Set Display <items> - changes the display items (same
options as Set Sort above).
Set Separate <method> - changes the file/directory
separation where <method> is either MIX, DIRSFIRST or
FILESFIRST.
Set Hide <pattern> - changes the hide pattern.
Set Show <pattern> - changes the show pattern.
Set Flags <flags> - sets various flags of REVERSE,
NOICONS, or HIDDEN.
The ‘Set Flags’ command allows you to add and subtract
flags. For example, “Set Flags +hidden -noicons” sets the
hidden flag, clears the noicons flag, and leaves all other
flags untouched. The state of a given flag can be toggled by
using the ‘/flag’ command, e.g. Set Flags /hidden
Set ToolBar <name> - allows you to change a Lister’s
toolbar.
Set Mode <mode> - sets mode to NAME, ICON, or
ACTION, with or without SHOWALL switch.
Set Source - sets Lister into source mode.
Set Dest - sets Lister into destination mode.
Set lock [on | off] - locks or unlocks Lister as
SRCE/DEST.
Set off - turns Lister off.
As with other Opus commands, the Set command and options
are not case sensitive.

Show NAME/F
Displays IFF ILBM pictures, brushes and animations. It will
also display other picture formats via the datatypes system of
OS3.0 and higher.
Opus 5 will show most pictures and brushes, including
overscan, extra halfbrite (EHB), HAM (4096 colour) pictures,
and AGA 8 bit pictures.
Under OS3.0 and higher, if a file is not in IFF format, but in a
format for which a datatype has been installed, the picture will
be displayed by that datatype.
You may scroll around the image by moving the mouse pointer
and the following actions or keys can be used when viewing a
picture or animation:-
Space, Help or P for Help and Print Requester,
Esc or RMB to abort,
LMB to deselect this picture and view the next,
Q to view the next image without deselecting this one,
Del to view the next image and mark this one for deletion.
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)
If any pictures are marked for deletion when the last picture
has been shown, the Delete function will be automatically
launched on them (you are given the usual warning first).
The Show command will use its own IFF code in preference to
datatypes IFF, since datatypes can be slower and have more
problems. If you wish to force Opus to use datatypes first, set
the Opus environment variable with:-
setenv dopus/ShowUseDatatypesFirst

SmartRead NAME/F
Invokes the Opus 5 reader program in either text, ANSI or
HEX mode according to the type of file selected. As with the
read command, if multiple files are selected, they will be
displayed in sequence. Pressing ESC will terminate the
reading of the sequence. See page XXX for more information
regarding the reader.
See Also: AnsiRead, Read, HexRead

Split
Splits files into smaller chunks. It opens a requester for you to
pick the file to split and the destination directory in which to
put the parts. You may choose the size of the chunks into
which to split the file from preset values optimised for Double
Density floppy disk size, High Density disk size, Double
Density MS-DOS disk size, High Density MS-DOS disk size, or
a custom size of your choice. Size is measured in kilobytes.
You must also provide a stem name for the output files to
which .000, .0001, etc will be added.
If the destination directory is a floppy disk (either a
trackdisk.device or a mfm.device disk), you will be prompted
automatically for a new disk to be inserted as necessary.
Split works on ALL SRCE Listers in turn.

Toggle
Causes selected entries in all SRCE directories to be deselected
and deselected entries to be selected. This command is often
used as a complementary right mouse button action for a
button using the All command. The right mouse button would
then toggle or reverse the state of all entries.
See Also: All, None, Select, Reselect.

User1, User2, User 3, User 4 NAME/F
These commands invoke the four user definable commands
associated with your user defined Opus Filetypes.
For example, with the LHA Filetype supplied with Opus 5, the
User1 command is defined to extract files from the archive. So,
selecting an LHA file and pressing a button with the command,
User1, would reference the Filetype, obtain the command and
extract the archive.

New in 5.8

Button banks have been improved with a number of new features and additions. These include:-

Background Pictures including Random Images

Button banks can now have background pictures (only under OS39+.) From the Picture gadget, select the required image from any format supported by the datatypes you have installed. For random pictures, enter either the directory name only or use a wildcard pattern ('*' or '#?' patterns) for specific pictures. Some examples might be:-

     Work:Picture
     or Work:Pictures/Shrubbery#?
     or Work:Pictures/#?.gif

See also Environment, Start Menus

New Settings Options

Auto Close and Auto Iconify
Buttons now have options for Auto Close and Auto Iconify options. When selected, these cause the button bank to be automatically closed or iconified whenever a button in the bank is chosen. This provides a mechanism which saves you having to add a CloseButtons commands to every button in the bank.

Drag

New options have been added to the dragbar orientation settings (now just called 'Drag'). You can choose to let Opus pick the most appropriate orientation by setting Automatic or you may choose to set the drag bar to be horizontal on the top or bottom, vertical on the left or right, or to turn the drag bar off completely.

Active popups
If this is enabled, buttons with multiple functions behave more like start menus when you hold the mouse button down. Instead of allowing you to select the "default" function for the button, it activates the function you have selected immediately.

Button bank Drag Bar

Many users like to have button banks with a hidden drag bar. Even when hidden you can still access the drag bar quickly. Control-left click on a button bank toggles the drag bar on or off. Control-right click on a button bank brings up the bank popup menu (previously you could only access this by right-click on the drag bar).

Commands and Functions

A number of new internal commands have been added to Opus and a number of commands have additional features.

--> Remember a summary of the command details is provided for quick access in the updated context sensitive DOpus Help guide. Press Help from within Opus itself or editor.



Asynchronous Commands

By default, many Opus commands will detach and operate asynchronously. The main commands that do this are AnsiRead, HexRead, Play, Print, Read, Show and SmartRead.

This could be a problem in cases where you wished to define a function that called one of these commands for a file, and then deleted the file. For example,

     Command Play RAM:playfile
     Command Delete RAM:playfile

In this example, a 'race condition' would be generated between the Play command, which operates asynchronously, and the Delete command. Either the Play command would get to the file first, in which case the Delete command would not be able to delete it, or the Delete command would win, in which case the file would not be there for the Play command to open.

To solve this, we have added a WAIT parameter to the above commands. If you specify this argument, the command will operate synchronously and will wait until it has finished before returning.

Taking the above example,

   Command Play RAM:playfile WAIT
   Command Delete RAM:playfile

With the WAIT parameter specified, the Play command will not return until it has finished playing the sound so the Delete command will function as expected.

Commands now operate on Icon Mode Listers

Many people requested the ability to use their buttons and menus on Listers in standard Icon mode. We have enhanced the command sub-system to make this possible, and Icon mode Listers can now be normal 'source' Listers like those in Name or Icon Action mode. However, because Icon mode Listers do not have a 'source/destination' display like the other style of Listers, the Lister window has to be active when the function is executed for an Icon mode Lister to be recognised as a source.

New or Changed Opus Commands

Buildtheme    AS=TO
See Themes.

Closebuttons  NAME,ALL/S,ICONIFY/S,START/S

The CloseButtons command now looks for the name of the button file as well as the name of the button bank. This means that CloseButtons can now take exactly the same name as LoadButtons.

The CloseButtons command can now close Start Menus with the use of the START/S switch. The name you provide is the name of the 'menu' as set in the first column in the menu editor. You can also use the ALL/S switch to close all Start Menus.

Converttheme  FILE=FROM, AS=TO (See Themes).

Copy  NAME, TO, QUIET/S,UPDATE/S,
   MOVEWHENSAME/S, NEWER/S

Copyas  NAME, NEWNAME, QUIET/S,
   MOVEWHENSAME/S

Remember, if the UPDATE switch is set, only files which do not exist will be copied. The NEWER switch is similar to the UPDATE except will only copy files that either do not exist or which have a later datestamp than the existing file. This is very useful for recursive copying of directories for backup purposes. You can also use this with OpusFTP for web maintenance.

--> OpusFTP also provides a direct mechanism for you to override the normal copy command operation to force newer or update. See FTPOptions

When specified, MOVEWHENSAME changes the Copy function into the Move function when the source and destination paths are both on the same disk. This emulates the behaviour when dragging and dropping icons; within the same disk, the files are moved, when dropped on a different disk the files are copied.