asc-tools information (asciitool.c for dos)

   ASC-TOOLS  Information    for asciitool.c for dos

=======================================================================
i didn't think i'd have to do this.....

...to save me re-posting a tidier package...

...here is an installation procedure and
 a brief explanation on how the tools work...



  -=O[  Instructions to install Ascii-Tools  ]O=-
      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1.  obtain the following zip archives from news:alt.ascii-art.animation

        ASCTOOLS.ZIP  111.824 Kb   9th August 1998
        ASCTOOL2.ZIP   29.754 Kb  11th August 1998

2.  unzip ASCTOOLS.ZIP to a directory (eg.  C:\AT)

3.  rename ASC-TOOL.EXE to ASC-T386.EXE
    rename TR.EXE       to TR-386.EXE
    rename SED.EXE      to SED-386.EXE

4.  unzip ASCTOOL2.ZIP to the same directory as ASCTOOLS.ZIP
    (over-writing the batch files)

5.  check the files against this list :-

      ASC-TOOL.EXE  11.402 Kb  Ascii picture raw rotation tool
                               (no DPMI required)
      ASC-TOOL.TXT   1.125 Kb  brief help page for ASC-TOOL.EXE
      ASC-TOOL.C     6.816 Kb  source-code used for ASC-TOOL.EXE
      ASC-T386.EXE  65.045 Kb  Ascii picture raw rotation tool (i386)
                               (requires 386 or higher and CWSDPMI.EXE)
      TR-386.EXE    86.314 Kb  Unix character translation tool (i386)
                               (requires 386 or higher and CWSDPMI.EXE)
      SED-386.EXE   73.216 Kb  Unix stream editor (i386 version)
                               (requires 386 or higher and CWSDPMI.EXE)
      CWSDPMI.EXE   25.920 Kb  DPMI support for i386 executables
                               (requires 386 or higher)
      CWSDPMI.DOC    7.060 Kb  documentation sheet for CWSDPMI.EXE
      LR.BAT         0.930 Kb  flip ascii picture left-right
      TB.BAT         0.673 Kb  flip ascii picture top-bottom
      CW90.BAT       0.799 Kb  rotate clockwise 90 degrees
      CCW90.BAT      0.811 Kb  rotate counter-clockwise 90 degrees
      asciitool.tgz  3.149 Kb  original unix source-code asciitool.c
                               and unix shell scripts.

6.  add the directory  C:\AT  to your PATH environment variable if you
    wish to run the batch-files from any location.



  -=O[  Brief Description of how these tools work  ]O=-
      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  The batch-files first call  ASC-TOOL.EXE  to perform raw flips and
  rotations of ascii-art pictures,

  like this :-

  type test1.asc

          >>--->

  asc-tool -mh test1.asc

          >--->>

  The output from ASC-TOOL.EXE is then piped to  TR-386.EXE  which
  re-maps (translates) the characters according to two sets of
  characters supplied as parameters.

  The first set are characters to be re-mapped and
  the second set are the characters the first set will be re-mapped to,

  like this :-

  type test2.asc

          >--->>

  tr-386 ">" "<" test2.asc

          <---<<

  tr-386 "->" "=<" test2.asc

          <===<<

  The resulting output from TR-386.EXE may then be piped to SED-386.EXE
  which simply strips any trailing space characters, using the command

  sed-386 "s/ $*//"

  Trailing space characters in a document could be removed using the
  command :-

  sed-386 "s/ $*//" document.txt >doc-stripped.txt


  SUMMARY
  -------
  Thus the process for LH.BAT is :-

  type %1;  asc-tool -mh %1 | tr-386 "->" "=<" | sed-386 "s/ $*//"

  >>--->        >--->>           <===<<


  !..hope all this makes sense..!

[][][ see yuz
[][][ colin
-- 
( () /_ / /\)   _/   /? .\ /\) /) .\ /_ /_
CJRandall http://www.shieldwolf.demon.co.uk

Related ASCII art in the Gallery

Explore these categories from our collection of 11,000+ artworks:

  ___
  \_/
   |
   |jgs
 __|__
|  ^  |
\ \_/ /
 '._.'

Make your own ASCII art

Turn images, text or 3D into ASCII, or draw your own – right in your browser.