home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Frozen Fish 1: Amiga
/
FrozenFish-Apr94.iso
/
bbs
/
alib
/
d5xx
/
d570
/
dirwork.lha
/
DirWork
/
DWEdit.doc
< prev
next >
Wrap
Text File
|
1991-11-21
|
23KB
|
629 lines
DWEdit V1.43a (30276 bytes) The configuration editor for DirWork 1.43
-----------------------------------------------------------------------
This program may be copied as long as it is accompanied by this doc file
both unaltered & no money is charged(except for a reasonable copying fee
such as what Fred Fish charges). All use of this program is at your own
risk & I assume no responsibility or liability for any problems that occur.
Well you can change most options/buttons etc from DirWork but
DWEdit allows you to edit some others as well as making the configuring
process a lot easier. To start DWEdit(assuming DWEdit is in a valid path
eg c:):-
Select the menu item from in DirWork (Best way!).
From a CLI/Shell type "DWEdit DWFileName".
From a CLI/Shell type "DWEdit s:DW.config".
For DirWork 1.31, 1.40 - 1.42 users you can load in the previous
Button/Instant Actions and PopKey/Tool data. Menu type Options aren't
loaded. Things change so some coverting from 1.31 is done but new options
might be better so have a look.
From a CLI/Shell type "DWEdit DWFileName OldDWFileName".
Then if everything is ok you will be presented with a screen with
all the DirWork Buttons as well as buttons for the left/middle/right mouse
button instant actions. You can select one of the main buttons:-
Quit - Quit without keeping any changes made.
Quit & Save - Quit and keep changes.
Options - Takes you to a screen of options
Ed PopTools - Takes you to the PopKey/Tools screen
When the mouse is over a Button/Instant Action the current config
for that button is shown at the bottom of the display. Pressing the button
takes you to a Button/Instant Action editing screen.
There are three toggle buttons on the main screen as well. You can
select SwapButton then press buttons to swap them then select swap button
again to turn it off. Same goes for SwapRow. CopyBut is like swap button
but the button is copied.
----------------------------------------------------------------------------
The Options screen
----------------------------------------------------------------------------
Here you can change many options that you couldn't from DirWork
itself:-
OPTIONS THAT TOGGLE ON/OFF
AutoPoint Automatically select windows the mouse is over.
Often called SunMouse.
XCopyBootBlocks The Boot block checker will treat Xcopy Boot blocks as if
they are standard boot blocks.
(ie won't warn you when you insert a disk with one)
ActivateTextGad After getting a directory DirWork will activate the text
gadget.
NoDWDuplicates When you have one DW running and try to start another it
will just bring the one running to the front.
ExternalConfig Maybe you would like to crunch DirWork and keep changing
your config. This makes DirWork use "S:DW.config" and its
configuration file instead of using the DW executable.
ButtonsBelow If your one of those upsidedown people this will put the
buttons etc below the file list for you.
PositionIndepen This make the button position irrelevent to what file list
it refers to. You have to press the right mouse button
on the button to refer to the right list as the source.
Plenty of people use DW this way as you don't have to
have duplicates of each button.
MouseAccelerat Accelerates your mouse based on values given in Accel and
threshold.
NoWBenchTools Stops DW from adding tools to the workbench screen in
kick2.0+.
NoCloseGadget DW does some trickery to have a window close gadget and
still allow dragging with the screen, this turns off
this and you get a normal sceen title bar all the time
and hence you must create a quit button. Only problem
is the menu titles are overwritten with the title stuff
sometimes when you try to access a menu item.
BusyPointer A little Busy clock comes up when DW is already doing
something. This is the only option on by default.
Interlace Screen is interlaced.
Productivity Screen is non interlaced. Requires ECS chips in your
machine and a VGA or better monitor.
OPTIONS YOU SET THE VALUE OF
TaskPriority The priority relative to other prgrams running of DW.
1 is usually a good value as it give DW more processor
time than most other programs.
Recommended range -5 to 5.
MouseAccel The factor by which mouse movement will be multiplied by.
You must turn the mouse acceleration option on as well.
Recommended range 2 to 10.
MouseThreshhold This is the smallest movement required before the mouse
acceleration factor is used. So when you do small
movements no acceleration occurs and hence you have fine
control. A value of 1 means always multiply be MouseAccel.
You must turn the mouse acceleration option on as well.
Recommended range 1 to 20.
ScreenBlankTim Amount of time the machine must be idle before the screen
blanks. Assuming you have the ScreenBlank option on.
In tenths of a second so 4800=8 minutes.
Recommened range 2400 to 9600.
BufferedNumber Number of directories keep in memory when you have the
buffered directory option turned on.
Recommened range 4 to 20.
VMKTime Amount of time between VMK checks. Assuming you have the
Periodic VMK check option on.
In tenths of a second so 80=8 seconds.
Recommened range 10 to 180.
WindowLeftEdge The x coordinate of the top/left corner of windows DW opens
on the workbench screen.
WindowTopEdge The y coordinate of the top/left corner of windows DW opens
on the workbench screen.
WindowWidth The width of windows DW opens on the workbench screen.
WindowHeight The height of windows DW opens on the workbench screen.
ScreenWidth The width of the screen DW opens.
ScreenHeight The height of the screen DW opens.
Colors13 These are the color numbers DW uses for a window Kick 1.3.
(0=Blue 1=White 2=Black 3=Orange by default colors)
Colors20 These are the color numbers DW uses for a window Kick 2.0.
(0=Grey 1=Black 2=White 3=LiBlue by default colors)
ColorsSc These are the color numbers DW uses for screen.
They have the following sequence:-
First three for File lists (Background/Files/Dirs)
Next two for title bar (Text/Background)
Next three for button text
Next two for button border
For example Colors13 by default is:
2133132100
File list is 213=BlackBack/WhiteFiles/OrangeDirs
Title bar is 31=Orange on White
Buttons text is 321=OrangeText/BlackText/WhiteText
Button Border is 00=No border shown
SLIDE GADGETS AT BOTTOM
The three slide gadgets are Red/Green/Blue modifiers for the screen
palette for DW. Just select a color button under the sliders then use the
slide movement to adjust the colors.
----------------------------------------------------------------------------
The Button/Instant Action editing screen
----------------------------------------------------------------------------
This screen displays all the functions available with the currently
selected function highlighted. The configuration text gadget is activated
and consists of:-
" , , "
||||| |||\__/ |
| ||| | +------------Arguments for operation.
| ||| |
| ||| |
| ||| |
| ||| +------ Keyboard combination (qualifier/keycode)
| |||
| |||
| |||+-------------- Options for certain routines.
| ||
| ||
| |+--------------- What needs to be selected to operate.
| | F=Selected Files. D=Selected Dirs.
| | B=Selected Files &/or Dirs.
| | A=All files/dirs even if not selected.
| | f=special mode that allows some files or no files
| | 0=irrelevent
| |
| +--------------- Internal routine the button uses.
| A capital letter signifies that the operation does
| not require selected files/dirs. A lower case
| hence means the operation should require selected
| files/dirs.
|
|
+---------------------------------------- Button Name of 5 Chars
This is the text that is displayed inside the
button.
The f selection is useful for Edit and similar buttons used with
the u function it allows you to define a button that if pressed without any
files selected it starts the program without a filename. But when file(s)
are selected it acts like F.
SAMPLE CHANGES FOR BUTTONS/INSTANT ACTIONS:-
---------------------------------------------------------------------------
Routine| Example changes and Information
letter | Remember upper case routine letter means selected file(s) related.
---------------------------------------------------------------------------
D A simple change would be changing DH1: to DF2: and make the F1 key
get that directory. Just select the DH1: button, go up to change
last button pressed and change
" DH1:,D00----,DH1:" to " DF2:,D000050,DF2:".
To make a button that gets the directory already in the text gadget
(instead of just pressing the right mouse button over the gadget)
"GetDr,D0c----,"
N Executes commands. If you want to execute a program and don't
want the selected files to be added to the command.
You must add CTRL-J EndCLI to your command if you use a option
that opens a window and you want it to automatically close.
Options(w,W,p,P,f,F,t,T,R):-
Uppercase of any of these letters means a requester first.
w if you want a window to open for the output.
p if you want a window to open for the output and waits for you
to press a key before it closes.
f bring workbench screen to the front.
t bring workbench screen to front for command then DW screen.
R if you want a requester so you can edit the command before
it is executed.
0 means no window or requester or bringing screens to the front.
Examples:-
"Prefs,N00----,Preferences" Bring up 1.2/1.3 preferences.
No output window is opened.
"Avail,N0p----,AvailJEndCLI" Show available memory in a window.
Then automatically close that window
after the user presses a key (or clicks
on the close gadget with Kick2.0+).
Note the J is CTRL-J
"Avail,N0w----,List" List a directory in a output window that stays
open until the user enters EndCLI (or clicks
on the close gadget with Kick2.0+).
"DiskC,N0w----,DiskCopy DF0: TO DF0:JEndCLI" Diskcopy DF0: to DF0:
opening a window for
the output that auto
closes when the Diskcopy
is finished.
Note the J is CTRL-J
M The Makedir function can be given a filename which it will copy
to create a icon for the directory. All you have to do is give
it the filename of the icon you want it to create.
"MakDr,M00----,sys:DefaultDraw.info"
P To create a parent button if you don't like going to the far
left/right of the directory text and pressing the left button.
"Paren,P00----,"
R To create a root button if you don't like going to the far
left/right of the directory text and pressing the right button.
"Root ,R00----,"
t Is the Type/Hextype function. Options are
A=ASCII H=Hex (try to load full file)
a=ASCII h=Hex (Only load first 32K of file)
j To make a all button select dirs as well as files.
Change "All ,jAf----," to "All ,jAb----,"
k The Protect function inverses the protect bit specified in the
Options (d,e,w,r,a,p,s)
So "Prote,kBd----," will change the delete protection of a file.
d To make a delete button that doesn't request you when you delete a
non empty dir.
Options (d,D,b,B)
Change "Delet,dBD----," to "Delet,dB0----,"
To make a delete button that requests you when you delete a file
or a directory:-
Change "Delet,dBD----," to "Delet,dBB----,"
The lower case letter option means that if Delete fails it will
prompt you and if you want will UnProtect each file and try to
delete again.
c To make a copy button clone the file note, protection and date.
BytesFree for the source/destination is updated after a copy.
"CCopy,cBc----,"
m To make a move button clone the file note, protection and date.
"CMove,mBc----,"
u The u internal routine is one of the most usefull it will execute
the text in the argument part of the button config with any any
file/dirnames selected. If you want the button to operate on
selected files and directories use the B middle letter. If you
want it just to operate on selected files use F and if you just
want it to operate only on selected Dirs use D. Note the u
command automatically adds JEndCLI (where J is CTRL-J) to commands
that use an option that opens a window
Options(w,W,p,P,f,F,t,T,R):-
Uppercase of any of these letters means a requester first.
w if you want a window to open for the output.
p if you want a window to open for the output and waits for you
to press a key before it closes.
f bring workbench screen to the front.
t bring workbench screen to front for command then DW screen.
R if you want a requester so you can edit the command before
it is executed.
0 means no window or requester or bringing screens to the front.
An example of using the u routine is the edit button and right mouse
instant operation on text files:- " Edit,uF0----,Run >NIL: E"
To change to path for the editor from E to c:Ed just select the edit
button, go up to change last button pressed and change to
" Edit,uF0----,Run >NIL: c:Ed"
Note an output window is not needed hence the 0 as the option.
To change the double click on a text file to use another text viewer
instead of the default internal type. After you double click a
text file & select change last button pressed change
"Text ,tFA----," to "Text ,uF0,ViewerName".
To make a button that uses DOS's list command on selected files and
dirs, and shows the output in a window than stays open until the
user presses a key (or clicks the close gadget with Kick2.0-).
"List ,uBp----,List"
To make a button that uses DOS's Execute command to execute script
files, with an output window open while the command is executing.
"Execu,uFw----,Execute"
To make a button that uses DOS's FileNote command to change the
FileNote of a file in a requester.
"Execu,uFR----,FileNote"
x Is like the u command except that the other file list
is CD'ed before the command is executed. It is used for the extract
commands for .lzh files and the like so that files produced go to
the destination directory and not the source one.
The destination directory is read in after this button is finished.
b Is the routine which displays the FileNote/protection bits so
"FBits,bB0----," would create a button for it instead of going to the
far right or left of the file/dir.
These are the default Button/Instant Actions configurations:-
"Instn,nF0----,",
"Print,iF0----,",
"Serch,fF0----,",
"NewZP,uff----,Run >NIL: NewZAP",
"LharA,aF0----,Lharc a ",
"NewSh,N0f----,NewShell",
"Info ,I00----,",
" Info,I00----,",
"DskOp,K00----,",
"Commd,N0w----,",
"NewZP,uff----,Run >NIL: NewZAP",
"Serch,fF0----,",
"Print,iF0----,",
"Sleep,S00----,",
"EScpt,uFw----,Execute",
"Prote,kBd----,",
"PlayS,pF0----,",
"MakDi,M00----,",
"HxTyp,tFH----,",
"Delet,dBD----,",
"Move ,mB0----,",
" Move,mB0----,",
"Delet,dBD----,",
"HxTyp,tFH----,",
"MakDi,M00----,",
"PlayS,pF0----,",
"Prote,kBd----,",
" VMK ,V00----,",
"Volms,U00----,",
" Run ,ufR----,Run >NIL:",
"Show ,sF0----,",
"Edit ,uf0----,Run >NIL: E",
"Type ,tFA----,",
"Renam,rB0----,",
"Copy ,cB0----,",
" Copy,cB0----,",
"Renam,rB0----,",
" Type,tFA----,",
" Edit,uf0----,Run >NIL: E",
" Show,sF0----,",
" Run ,ufR----,Run >NIL:",
"Volms,U00----,",
"WORK:,D00----,WORK:",
"SYS: ,D00----,SYS:",
"DH1: ,D00----,DH1:",
"DH0: ,D00----,DH0:",
"DF1: ,D00----,DF1:",
"DF0: ,D00----,DF0:",
"RAM: ,D00----,RAM:",
" RAM:,D00----,RAM:",
" DF0:,D00----,DF0:",
" DF1:,D00----,DF1:",
" DH0:,D00----,DH0:",
" DH1:,D00----,DH1:",
" SYS:,D00----,SYS:",
"WORK:,D00----,WORK:",
"All ,jAf----,",
"None ,lB0----,",
"CD ,C00----,",
"<< ,E00----,",
"<>SWA,W00----,",
">> ,E00----,",
"CD ,C00----,",
"None ,lB0----,",
"All ,jAf----,",
These are the default actions for left mouse double click on a file:-
"MOD. ,uFf----,Intuitracker",
".ARC ,uFp----,Arc v",
".DMS ,uFW----,DMS Write",
".LZH ,uFp----,Lharc l",
".LHW ,uFW----,Lhwarp Write 0",
".PAK ,xFw----,",
".WRP ,uFW----,UnWarp",
".ZIP ,uFp----,UnZIP -v",
".ZOO ,uFp----,Zoo v",
".GIF ,uF0----,VirtGIF",
".INFO,000----,",
"8SVX ,pF0----,",
"ANIM ,uF0----,ShowANIM",
"ILBM ,sF0----,",
"SMUS ,uF0----,PlaySMUS",
"FTXT ,uF0----,",
"Most ,uFt----,Most",
"PowPk,tFA----,",
"Exect,000----,",
"Text ,tFA----,",
"Binry,tFH----,",
These are the default actions for middle mouse click on a file:-
"MOD. ,uFf----,Run >NIL: Intuitracker",
".ARC ,xF0----,Run >NIL: Arc xw",
".DMS ,uF0----,Run >NIL: DMS Write",
".LZH ,xF0----,Run >NIL: Lharc -m -x -r x",
".LHW ,uF0----,Run >NIL: Lhwarp Write 0",
".PAK ,xF0----,Run >NIL:",
".WRP ,uF0----,Run >NIL: UnWarp",
".ZIP ,uF0----,Run >NIL: UnZIP -xdo",
".ZOO ,xF0----,Run >NIL: Zoo xO//",
".GIF ,uF0----,Run >NIL: VirtGIF",
".INFO,000----,",
"8SVX ,uF0----,Run >NIL: PlaySS",
"ANIM ,uF0----,Run >NIL: ShowANIM",
"ILBM ,uF0----,Run >NIL: Dpaint",
"SMUS ,uF0----,Run >NIL: PlaySMUS",
"FTXT ,uF0----,",
"Most ,uFf----,Run >NIL: Most",
"PowPk,uF0----,Run >NIL: PowerPacker",
"Exect,uF0----,Run >NIL: ReSource",
"Text ,uF0----,Run >NIL: E",
"Binry,uFf----,Run >NIL: NewZAP",
These are the default actions for right mouse click on a file:-
"MOD. ,uFf----,Run >NIL: Intuitracker",
".ARC ,xFw----,Arc xw",
".DMS ,uFW----,DMS Write",
".LZH ,xFw----,Lharc -m -x -r x",
".LHW ,uFW----,Lhwarp Write 0",
".PAK ,xFw----,",
".WRP ,uFR----,Run >NIL: UnWarp",
".ZIP ,uF0----,UnZIP -xdo",
".ZOO ,xFw----,Zoo xO//",
".GIF ,uF0----,Run >NIL: VirtGIF",
".INFO,000----,",
"8SVX ,uF0----,PlaySS",
"ANIM ,uF0----,ShowANIM",
"ILBM ,uF0----,Mostra",
"SMUS ,uF0----,PlaySMUS",
"FTXT ,uF0----,",
"Most ,uFf----,Run >NIL: Most",
"PowPk,uF0----,PPShow",
"Exect,uFR----,",
"Text ,uF0----,Run >NIL: E",
"Binry,uFf----,Run >NIL: NewZAP",
----------------------------------------------------------------------------
The PopKey/Tools editing screen
----------------------------------------------------------------------------
There is a slight difference between Button/Instant Actions and the
PopKey/Tool configuration as the PopKey entry has no button name part and
has @ at the start of each entry other wise they are the same.
"@ , "
|||\__/ |
||| | +---------Arguments for operation.
||| | Also what appears as menu text.
||| | Must have something here for PopKey/Tools
||| |
||| +------ Keyboard combination (qualifier/keycode)
|||
|||
|||+-------------- Options for certain routines.
||
||
|+--------------- What needs to be selected to operate.
| F=Selected Files. D=Selected Dirs.
| B=Selected Files &/or Dirs.
| A=All files/dirs even if not selected.
| f=special mode that allows some files or no files
| 0=irrelevent (This is usually the case for PopKey/Tools
|
+--------------- Internal routine the button uses.
A capital letter signifies that the operation does
not require selected files/dirs. A lower case
hence means the operation should require selected
files/dirs.
So say you wanted to change the PopKey to wake up DirWork all you
have to do is edit the Qualifier/KeyCode of the first entry. First click
out of the text gadget the press the key combination you want DirWork to
wake up with. The values for this key combination is shown on the right
hand side of the display. Just substitue those values for the one
currently in the PopKey/Tool text gadget.
By pressing the * on the keypad you would have got Qual=00 & Key=5D :-
So "@A001922,DW in Memory" becomes "@A00005D,DW in Memory"
\_/\/\/
| \ + The D KeyCode
| + The CTRL SHIFT ALT Qualifier
+ Remember this is the function part A just happes to be awake function
The most common thing you will add to you tools/popkey data are
commands to execute external programs so an example is to make it so if we
select "Paint" from the Tools menu or press Amiga-F2
So add to the PopKey/ToolData "@N004051,Run Paint".
The N means execute external program, the first 0 means nothing needs to be
selected in the file lists and the second means no options. Then the next
4 numbers are the Quailfier/Keycode for LeftAmiga-F2 key combinations.
Then After the , is the command to execute and this is the text that will
show in the tools menu.
For more information on the N function (or any other as you can use all
the functions that you can use to define a button, the captial letter
functions are the ones you might use though) see the Button/Instant Action
section
----------------------------------------------------------------------------
General details
----------------------------------------------------------------------------
For each button and PopKeyEntry you can specify a key combination consisting
of special keys (Qualifiers) and the normal key. Here are some values to
help you. But in DWEdit on the Button change screen and the PopKey/Tool
screen you can just click out of any text gadget and the press any key
combination and the values are displayed.
Sample Qualifiers: Sample RawKeys:
LSHIFT=$01 Esc=$45 F1=$50 to F10=$59
RSHIFT=$02 `=$00 1=$01 to \=$0D BS=$41
CTRL =$08 Tab=$42 Q=$10 to P=$19 to ]=$1B
LALT =$10 A=$20 to L=$28 to '=$2A
RALT =$20 Z=$31 to M=$37 to /=$3A
LAMIGA=$40 Del=$46 Help=$5F Return=$44 Space=$40
RAMIGA=$80 Up=$4C Down=$4D Left=$4F Right=$4E
Keypad RawKeys:
(=$5A to *=$5D -=$4A +=$
0=$0F .=$3C Enter=$43
History: V1.41a First release
V1.42a Now loads the PopKey/Tools from 1.40 DW's
And some help/example text improvements.
V1.43a Added CopyBut and more examples.
Bye,
Chris Hames (Available for any Amiga work)