Appendix B. Utilities


This section describes the utility programs that come with
Launch. For any updates on the information here, please read
the file

     UTILS.TXT

installed in your Launch directory.


CDir


This program gives you a directory that combines both the
directory tree and the files in each directory in the one
display. Files of different types (extensions) are shown in
different colours. CDir automatically detects redirection,
so output can be redirected to a disk file or printer (see
your DOS manual for further details on redirection). CDir
also adjusts its display to cope with varying screen widths
and heights.

Usage: cdir [initial path]

     initial path   This parameter tells CDir which
               directory should be at the top of the tree it
               produces.
     
Eg. For a listing starting at directory C:\UTILITY, you
would type

     cdir c:\utility

Eg. For a listing of an entire disk to be placed in the new
file LIST.TXT you would type

     cdir d:\ > list.txt

CDir shows files with different extensions in different
colours, for example .EXE  .COM and .BAT all have their own
distinctive colour, whereas .DOC and .TXT files have the
same colour etc.

CDir's output is paused (and restarted) by pressing [Space],
and is stopped by pressing [Esc].

 Patching CDIR
CDir has an easily located patch point for those who wish to
customise its colours and extensions. Using a hex or sector
editor, search for the string Patch> in CDIR.EXE. The very
first byte following this string represents the colour used
for displaying the directory tree. This is followed by a
series of colour and filespec pairs. Each pair consists of a
byte representing the colour, and another three bytes giving
the letters which are matched to determine a file's display
colour. These letters may include normal DOS wildcards if
desired. If a file matches more than one extension, the
first match is always used. The last extension before the
closing <Patch string must be ??? (a catch-all).


DirSize


This program advises you of the amount of space each
directory on your disk takes up, and of the space remaining
on the disk. When a directory has descendants, the program
shows the collective total of each directory and its
descendants in square brackets.

Usage: dirsize [initial path]

Eg.

         3,174,400   C:\PROWIN\   [4,585,472]
           485,376   ASPECT   [1,409,024]
           923,648     DEMO
             2,048   CAPTURE
                 0   DNLOAD
                 0   UPLOAD
     
     4,820,992 bytes free

DirSize's output can be redirected to any device. See your
DOS manual for more details on redirection.

DirSize can be used to easily work out the size of various
combinations of directories and sub directories. This is
useful when you have to delete directories to make way for a
new application- simply find a directory whose collective
total is the most suitable. Alternatively, DirSize can be
used to find the total size of an application before a
backup or copy is made.


Chart


This program prints an ASCII chart on your screen, giving
Decimal, Hex and ASCII values for each character. If a key
is pressed while Chart is running, it will terminate.

Usage: chart


Colours


This program prints a chart of colours to your screen,
showing all the colour combinations that are currently
available.

Usage: colours


KbdPut


This program allows you to place sequences of keypresses in
the keyboard buffer as though they had been typed.

Usage:  kbdput string

     string    is a literal enclosed in quotes  eg. "EXIT"
               is the ASCII code for the desired key  eg. 13
               for [Enter]
               is the ASCII code for the desired extended
               key, preceded by a ^  eg. ^59 for [F1]
     
               or any combination of the above


This command can be used in two ways:

     (1)  to pass information back to an application which
          you have shelled out of, thus using Launch as an
          external method of selecting the next action in
          the application eg.
     
               kbdput ^33 "X"
     
     (2)  to pass information to an application about to be
          invoked, thus performing a common initial task
          such as changing the current directory, or
          entering your name eg.

               kbdput "SIMON" 13

                              
The number of characters stored in the keyboard buffer must
not exceed fifteen (a limit imposed by DOS) unless you are
using a DOS keyboard buffer extender.



 Keyboard Codes
This chart is for use with the KbdPut program. It tells you
which directive to use to emulate a particular keystroke.


    Key     Unshifte   Shifted   Control     Alt
                d
    F1         ^59       ^84       ^94      ^104
    F2         ^60       ^85       ^95      ^105
    F3         ^61       ^86       ^96      ^106
    F4         ^62       ^87       ^97      ^107
    F5         ^63       ^88       ^98      ^108
    F6         ^64       ^89       ^99      ^109
    F7         ^65       ^90      ^100      ^110
    F8         ^66       ^91      ^101      ^111
    F9         ^67       ^92      ^102      ^112
    F10        ^68       ^93      ^103      ^113
    F11       ^133      ^135      ^137      ^139
    F12       ^134      ^136      ^138      ^140
                                              
   Left        ^75       52       ^115        
   Right       ^77       54       ^116        
    Up         ^72       56                   
   Down        ^80       50                   
                                              
   Home        ^71       55       ^119        
    End        ^79       49       ^117        
  Page Up      ^73       57       ^132        
 Page Down     ^81       51       ^118        
  Insert       ^82       ^5        ^3         
  Delete       ^83       ^7        ^6       ^186
  Escape       27        27        27         
Back Space      8         8        127        
    Tab         9        ^15                  
   Enter       13        13        10         
                                              
     '         39        34                   
     *         42        42                   
     +         43        43                   
     ,         44        60                   
     -         45        95        31       ^130
     .         46        62                   
     /         47        63                   
     ;         59        58                   
     =         61        43                 ^131
     [         91        123       27         
     \         92        124       28         
     ]         93        125       29         
     `         96        126                  
     A         97        65         1        ^30
     B         98        66         2        ^48
     C         99        67         3        ^46
     D         100       68         4        ^32
     E         101       69         5        ^18
     F         102       70         6        ^33
     G         103       71         7        ^34
     H         104       72         8        ^35
     I         105       73         9        ^23
     J         106       74        10        ^36
     K         107       75        11        ^37
     L         108       76        12        ^38
     M         109       77        13        ^50
     N         110       78        14        ^49
     O         111       79        15        ^24
     P         112       80        16        ^25
     Q         113       81        17        ^16
     R         114       82        18        ^19
     S         115       83        19        ^31
     T         116       84        20        ^20
     U         117       85        21        ^22
     V         118       86        22        ^47
     W         119       87        23        ^17
     X         120       88        24        ^45
     Y         121       89        25        ^21
     Z         122       90        26        ^44
                                              
     0         48        41                 ^129
     1         49        33                 ^120
     2         50        64        ^3       ^121
     3         51        35                 ^122
     4         52        36                 ^123
     5         53        37                 ^124
     6         54        94        30       ^125
     7         55        38                 ^126
     8         56        42                 ^127
     9         57        40                 ^128


