home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / utilities / diskutils / dimpwin / dimpwin.doc < prev    next >
Encoding:
Text File  |  1992-02-12  |  7.1 KB  |  169 lines
  1.      Disk Imploder Intuition Interface  V1.0  by Colin Bell.
  2.      -------------------------------------------------------------------
  3.  
  4. DESCRIPTION
  5.         
  6.     DImp-Win allows you to archive disk cylinders from a window
  7.     using Disk-Imploder V2.27 by A.J.Brouwer.
  8.     
  9.     When run, DImp-Win will present you with a window displaying
  10.     all the options available for each mode. Click on the Mode cycle
  11.     gadget to change between Read, Write & Info modes. As you do this 
  12.     the non-applicable gadgets for each mode will be ghosted. After you
  13.     have made your choices, click on start. DImp-Win will invoke DImp
  14.     and tell it what to do.
  15.  
  16.     DImp-Win requires: AmigaOS version 2.04 + 
  17.                        reqtools.library V37 + (in your libs directory)
  18.                            DImp V2.27 + (somewhere in your path)
  19.  
  20. DIMP
  21.         DImp is one of the most efficient disk archivers available
  22.     for the Amiga. It offers 7 different levels of compression,
  23.     the ability to create self-extracting archives, MULTIPLE CYLINDER
  24.     RANGES, ability to work with any floppy compatible device (such as
  25.     RAD: & FMS disks) and it can also add a textfile to the archive that
  26.     will be displayed during extraction.
  27.     Apart from that, it has the FASTEST decompression speed of any disk
  28.     archiver available! To demonstrate this I did this test. I DMS'd &
  29.     DIMP'd a NonDos Game disk in maximum mode of both archivers.
  30.         
  31.         Compression was done on a 68030 and floppy disk
  32.          DMS took 2mins 50secs to create a file of 597510 bytes         
  33.          Dimp took 2mins 25secs to create a file of 629925 bytes
  34.         Decompression was done on a 68000 and an FMS disk
  35.          DMS took 5mins 28secs to unpack the disk
  36.          DIMP took 0mins 30secs to unpack the disk
  37.         That is a Humungous saving when you add all the figures up. The 29k
  38.         filesize difference is only 20secs or so at 9600bps. So get out
  39.         your calculator & work out which archiver you should be using.
  40.  
  41.  
  42.  DImp-Win carries absolutely no warranties, either expressed or implied.
  43.  DImp-Win may not be included with any commercial product nor may it be
  44.  sold for profit either seperately or as part of a compilation without
  45.  my permission. 
  46.  
  47.  
  48. CONTACT   Fidonet:      Colin Bell  3:712/512
  49.             Snail:      PO BOX 1058
  50.                         Bondi Junction
  51.                         NSW  2022  Australia
  52.  
  53.     DImp is Freeware by Albert-Jan Brouwer
  54.     DImp-Win is Freely Distributable but © Copyright 1992 by Colin Bell
  55.     ReqTools & reqtools.library are © Copyright 1991/92 Nico Francois
  56.        
  57. =======ORIGINAL DIMP DOCUMENTATION====================================
  58.  
  59.     Disk Imploder V2.27 by A.J.Brouwer.  FreeWare
  60.     ---------------------------------------------
  61.  
  62.  
  63. NAME
  64.     DImp - Archives cylinders.
  65.  
  66.  
  67. SYNOPSIS
  68.     DImp READ <SourceDrive> Ca[-Cb,Cc,..] <TargetFile> [-M?|-NB|-NC|-X] [+Readme]
  69.       The collection of cylinders to be read must be specified by ranges, Ca-Cb,
  70.       and/or single cylinders, separated by commas.
  71.       -M? or MODE?    = Compression mode, ? = 0-7, default = 5
  72.       -NB or NOBITMAP = Ignore bitmap (normally unused blocks are cleared)
  73.       -NC or NOCOMP   = Do not compress cylinders
  74.       -X  or EXE      = Create self-extracting overlayed executable
  75.       +"Name of Readme file to be displayed during WRITE"
  76.     DImp WRITE <DImpFile> <TargetDrive>
  77.     DImp INFO <DImpFile>
  78.     DImp ABOUT
  79.     DImp will use ".dmp" or ".dex" filename extensions when trying to
  80.     create or recognize DImp data files.
  81.  
  82.  
  83. DESCRIPTION
  84.       DImp allows you to compress a subselection of cylinders from
  85.     any floppy compatible device into a file.  DImp is fast and
  86.     sports a good compression ratio.  Notably, DImp allows you to
  87.     create a self extracting file with an appended readme text,
  88.     thus providing you with a completely self-contained method of
  89.     distributing a disk's contents in a file.
  90.  
  91.        There are four operation mode keywords; "READ" specifies
  92.     that cylinders must be read, "WRITE" indicates that you wish to
  93.     write cylinders encoded in a dimped file, "INFO" displays
  94.     information about the contents of a file containing dimped
  95.     cylinders, and "ABOUT" should be obvious.
  96.  
  97.       The cylinders are individually compressed, checksummed and
  98.     stored, thus, in case of a transmission error, valid cylinders
  99.     can be undimped, and the originator can then select, dimp and
  100.     retransmit the faulty cylinders.
  101.  
  102.       The cylinders to be READ can be selected by entering cylinder
  103.     numbers separated by commas, or a dash if you wish to specify
  104.     a range of cylinders.
  105.  
  106.       When reading or writing, DImp can handle any device that
  107.     supports the normal floppy 2 heads 11 sectors etc. layout,
  108.     thus it is usable with f.e a RAD: or an FMS disk.  You can omit
  109.     the colon normally following these device names.
  110.  
  111.       Additional options include compression mode selection override.
  112.     Given the fact that the tracks are compressed individually, the
  113.     default mode 5 has a pretty optimal compression ratio, though
  114.     the ratio isn't as good as it might have been if cylinder data
  115.     had been treated as a continuous stream.  This is a design choice
  116.     intended to allow the aforementioned flexible handling of
  117.     individual cylinders.
  118.  
  119.       If there's sufficient free memory, DImp will allocate buffers
  120.     for a turbo compression algorithm.  Also, reducing the crunch
  121.     mode will speed things up, dramatically so if you don't have
  122.     sufficient free memory for DImp to run in turbo mode.  Lowering
  123.     the crunch modes results in less efficient compression though.
  124.  
  125.       Next, there are a couple of option switches.  NOBITMAP
  126.     prevents DImp from discarding data that, according to the disk's
  127.     bitmap, isn't used by the filing system.  This option is rarely
  128.     needed.  If you suspect a disk to contain a program that uses a
  129.     low level routine to read its information from that disk, this
  130.     option might be required to prevent loss of relevant data.
  131.     NOCOMP disables compression.  EXE causes DImp to generate self
  132.     extracting dimp files.  These can be executed, and will write
  133.     their contents to a disk selected by the user.  Executable DImp
  134.     files (.dex filename extension) can be treated as normal DImp
  135.     files (.dmp filename extension) in that you can use DImp to
  136.     WRITE these, or get INFO on them.
  137.  
  138.       Lastly, you may specify a filename containing text to be
  139.     displayed during the writing or self-extraction of the dimp file
  140.     you're creating.  This allows you to include a fairly extensive
  141.     comment on the contents of the disk.  This readme filename must
  142.     follow a "+" commandline indicator.
  143.  
  144.  
  145. EXAMPLES
  146.     DImp READ rad 0-79 Work:Cylinders EXE +ram:blahblah
  147.  
  148.  
  149. TECHNOCRAP
  150.       The self-extracting executable files generated by DImp are
  151.     overlayed.  This allows for the cylinder data to be spooled
  152.     during the self-extraction process, resulting in much more
  153.     modest memory requirements than the size of the executable
  154.     would lead one to suspect.
  155.  
  156.       Thanks to resource tracking, transparent error management,
  157.     modular algorithm linking, and sitting on the program for
  158.     several years before releasing it, DImp should be very robust
  159.     and return sensible error messages.
  160.  
  161.     DImp is pure and can be made resident.
  162.  
  163.  
  164. AUTHOR
  165.     Albert-Jan Brouwer 
  166.     UUCP hp4nl.nluug.nl!cbmnlux!ecl001!ajbrouw
  167.     UUCP cbmvax.commodore.com!cbmehq!cbmnlux!ecl001!ajbrouw
  168.     FIDO: 2:281/614 (up for freq sometime fall '91)
  169.