home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / magazine / drdobbs / ddjcompr / hstest / read.me
Text File  |  1991-04-29  |  5KB  |  176 lines
  1.  
  2.                                                     SIG m.b.H
  3.                                                     tom ehlert
  4.                                                     bachstrasse 22
  5.                                                     D-5100 aachen
  6.                                                     germany
  7.  
  8.  
  9.  
  10.     This is my entry to the DDJ Compression Contest
  11.  
  12.  
  13.     Right now I have a problem: I just reread the conditions
  14.     under which I may participate at the contest and (re)learned that
  15.     I MUST fill an ENTRY FORM which I don't have. Scince I have
  16.     no access to Compuserve I FAXed to DDJ for the request for
  17.     this entry form, but it's not yet here (5 hours later). So I
  18.     try to imagine what might be asked on this entry form and
  19.     hope for the best.
  20.  
  21.  
  22.     program name        :   HSTEST
  23.     program author      :   tom ehlert
  24.     post address        :   SIG m.b.H
  25.                             tom ehlert
  26.                             bachstrasse 22
  27.                             D-5100 aachen       / germany
  28.  
  29.     phone number        :   0241-502066
  30.     FAX   number        :   0241-502068
  31.  
  32.  
  33.     operating system    :   MS/PCDOS > 2.00
  34.     memory requirements :   >= 370 KByte
  35.  
  36.     compiler            :   MSC    6.00A
  37.     assembler           :   MASM   5.1
  38.     linker              :   MSLINK 3.65
  39.  
  40.  
  41.  
  42.  
  43.  
  44.     usage               :
  45.             HSTEST file compressed_file
  46.         for fast compression/decompression
  47.  
  48.             HSTEST file compressed_file -F
  49.  
  50.         for better,slower compression/decompression
  51.  
  52.             HSTEST compressed_file file
  53.  
  54.         to decompress the compressed file
  55.  
  56.  
  57.     sourcecode is on SRC\; regenerate with
  58.         cd SRC
  59.         tm ar
  60.  
  61.  
  62.     right to the sourcecode by anybody else :
  63.         none except the file PQ.C which is directly derived from
  64.         a DDJ artikel in 6'87 (Priority Queues).
  65.  
  66.  
  67.  
  68. 
  69.  
  70.  
  71.     Here a longer, more verbose description:
  72.  
  73.  
  74.     programmname : HSTEST.EXE
  75.  
  76.     usage :
  77.         HSTEST infile outfile [-options]
  78.                      options are
  79.             -Uncompress infile to outfile,
  80.                      default is compress infile to outfile
  81.             -Full (and slow) compression, default is fast mode
  82.             -S print statistics
  83.             -Quiet mode
  84.  
  85.  
  86.     allthought the differenz in speed for fast or full compression
  87.     is not very big, the speed during decompression is enormous.
  88.  
  89.     so if you want maximum compression use parameter -F, if you
  90.     want fast decompression don't use it.
  91.  
  92.  
  93.     What HSTEST is good for:
  94.         HSTEST is an extremely basic File compression/decompression
  95.         programm and not an archiving utility (like PKZIP etc.).
  96.         I produced it just to demonstrate the combination of
  97.         the combined pack() and hs_pack() routines and to keep
  98.         the sourcecode as small (and understandable) as possible.
  99.  
  100.         A general archiving utility is also available, based on
  101.         the above routines.
  102.  
  103.  
  104.     REGENERATION of HSTEST:
  105.  
  106.         sourcecode is in SRC. regenerate with
  107.  
  108.             cd SRC
  109.             tm ar
  110.  
  111.         AR.MAK is the makefile, it should document the process.
  112.         HSTEST has been compiled with MSC600A and MASM5.1,
  113.         but it should compile with any other C-Compiler as well
  114.         provided that _fastcall,far,... keywords are supported
  115.         or ignored.
  116.  
  117.         some (trivial) supportcode has been included to STOMLIB.LIB
  118.         to make the differenz between packing and systeminterface
  119.         more clear. its source is in LIB. STOMLIB.LIB can be
  120.         regenerated using
  121.  
  122.             cd LIB
  123.             tm tomlib
  124.  
  125.  
  126. 
  127.  
  128.     Some comments about the proposed benchmarks:
  129.         You want to measure the performance for compression ratio
  130.         of files in the order of 2 MByte. Allthought this is certainly
  131.         important, it is virtually useless for some cases which are
  132.         often needed:
  133.  
  134.             sourcefiles  (1..20 Kbytes usually)
  135.             OBJfiles     (1..20 Kbytes usually)
  136.             Help-screens (1..5  Kbytes usually)
  137.             compressed pictures :
  138.             GEM .IMG     (15..30 KBytes)
  139.  
  140.         these files are necessarily small. pack()/hs_pack() are
  141.         inherently usable for small files, they compress even
  142.         files of 1 Kbyte significantly. This is important for
  143.         any archiving utility, because it's rather impractical
  144.         to decompress 1 MByte of compressed file just to retrieve
  145.         the last file of 100+ sourcefiles.
  146.  
  147.         So I would suggest you measure the performance for
  148.         "normal" Files as well.
  149.         I usually do this (to verify and measure HSTEST) by
  150.         compressing/decompressing each File on my harddisk C:Drive
  151.         (2500 Files, 32 MByte) or my server Harddisk
  152.         (15000 Files,256 MByte).
  153.  
  154.         Beside this: I wish you some fun during the evaluation of
  155.         probably several Gigabytes of compression / decompression
  156.         Software.
  157.  
  158.         Last note:
  159.             DDJ is one of the journals which I read since 6 years
  160.             and will be reading 6 years to come.
  161.  
  162.                 have fun
  163.                             tom ehlert.
  164.  
  165.  
  166.  
  167.  
  168.             SIG m.b.H.
  169.             tom ehlert      phone 241-502066
  170.                             FAX   241-502068
  171.  
  172.             bachstr. 22
  173.             D-5100 aachen
  174.             germany
  175.  
  176.