home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Fresh Fish 5
/
FreshFish_July-August1994.bin
/
bbs
/
os20
/
iconmonger-2.0.lha
/
IconMonger
/
IconMonger.doc
< prev
next >
Wrap
Text File
|
1994-01-11
|
5KB
|
121 lines
PROGRAM: IconMonger 2.0
AUTHOR: Todd M. Lewis E-MAIL: Todd_Lewis@unc.edu
2601 Piedmont Drive
Sanford, NC 27330-9437 USA
IconMonger is a CLI-only utility which manipulates various
attributes of selected icons. AmigaOS 2.04 or above is required.
IconMonger can work on single icons or selected icons within a
single directory or on an entire directory tree or disk. Icons
can be selected by name, image, icon type, stack size and/or
default tool. Possible changes include image, colors, stack
size, default tool and/or position.
DISTRIBUTION
Sure, go ahead. I didn't write these docs for myself, ya know.
RUNNING THE PROGRAM
IconMonger can take a whole bunch of parameters. The template is:
FROM/K,FILE,A=ALL/S,DISKS/S,DRAWERS/S,TOOLS/S,PROJECTS/S,TRASH=GARBAGE/S,
U=UNSNAPSHOT/S,R=RECOLOR/S,OI=OLDIMAGE/K,NI=NEWIMAGE/K,OT=OLDTOOL/K,
NT=NEWTOOL/K,OS=OLDSTACK/K,NS=NEWSTACK/N/K,NEWICON/K,
Q=QUIET/S,V=VERBOSE/S,T=TEST/S
The parameters fit into three groups: Selectors, Actions, and Modes.
Selectors allow user to specify what icons to operate on. They are:
FROM Selects what directory to work in if not the
current directory.
FILE A file name or pattern to match. Do not include
the ".info" part of icon file names.
ALL Extends file selection to subdirectories of the
FROM or current directory.
DISKS Limits selection to these types of icons. If none
DRAWERS of these are specified, all icon types are
TOOLS eligible.
PROJECTS
GARBAGE
OLDIMAGE Limits selection to icons with normal images which
are identical to the specified icon's image.
OLDTOOL Limits selection to PROJECT icons with default tools
which match this DOS pattern. Example:
"OLDTOOL=#?more" selects any icon with a default
tool which ends with the letters "more".
OLDSTACK Limits selection to icons with a stack size parameter
which matches the criteria specified. OLDSTACK implies
both TOOLS and PROJECTS. OLDSTACK specifications
consist of a relational prefix and some number.
Valid relational prefixes are LT, LE, EQ, GE and GT.
Example: "OLDSTACK LT2000" selects icons with a
specified stack less than 2000 bytes.
LT means Less Than, LE means Less Than or Equal To,
EQ means Equal To, GE means Greater Than or Equal To,
and GT means Greater Than. Upper and lower case
are both acceptable.
Action parameters tell the program what action to take with selected icons.
UNSNAPSHOT Same as the UnSnapshot menu item on Workbench.
RECOLOR Exchanges pens 1 and 2 (black and white). This
would be handy if you had a disk of icons from
pre-2.04 days and you wanted to update their
colors to match current conventions.
NEWIMAGE Changes the image of the selected icons to that
of the icon specified with this parameter.
Example: "IconMonger OLDIMAGE=Ugly NEWIMAGE=Pretty"
would change all icons in the current directory
that looked like "Ugly" to look like "Pretty".
Both Ugly and Pretty would have to be icons in
the current directory.
NEWSTACK Set the stack size of selected icons to this
value.
NEWICON Simply replace the selected icons with this
icon.
Modes determine how the program operates.
QUIET Produces few if any messages.
VERBOSE Explains what a command will do, and explains
which criteria are not met by icons which are
not selected.
TEST Goes through the whole process but doesn't
actually write out any changes. This lets you
try out a command with relative safety until you
are sure you are specifying the options you want.
EXAMPLES
IconMonger FROM DF0: ALL UNSNAPSHOT RECOLOR
Unsnapshots and recolors all the icons on the disk in drive DF0:.
IconMonger OLDTOOL=#?More NEWTOOL Less
Changes the default tool of all the PROJECT icons in the current
directory with a default tool that ends with "More" to "Less".
IconMonger FROM DF0:Docs OLDTOOL #?(More|Less) NEWIMAGE Text
Changes the image of any PROJECT icon in the DF0:Docs
directory with a default tool that ends with either "more"
or "less" to the image of the icon "Text" which is in the
current directory.