home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 631b.lha / IFFCHR_v1.1 / IFFCHR.doc < prev    next >
Text File  |  1992-04-15  |  9KB  |  208 lines
  1.       ***********************    IFFCHR 1.1    ***********************
  2.  
  3.          Copyright (c) 1992 by David Hopwood.  All Rights Reserved.
  4.       
  5.       ****************************************************************
  6.       
  7.       Files included in this archive are:
  8.  
  9.  
  10.       IFFCHR-u          -unregistered version of IFFCHR v1.1
  11.       IFFCHR-u.info     -icon
  12.  
  13.       IFFCHR.doc        -documentation for IFFCHR (this file)
  14.       IFFCHR.doc.info   -icon (default tool = C:more)
  15.  
  16.       Update.notes      -what's new in this version
  17.       Update.notes.info -icon (default tool = C:more)
  18.  
  19.       ReadCHR           -limited ANSI viewer for examples (CLI only)
  20.  
  21.       BWorb.ilbm        -IFF screen from which ASCIIorb.asc and
  22.                          ANSIorb.ans were made.
  23.  
  24.       ASCIIorb.asc      -example of plain ASCII output
  25.       ASCIIorb          -IconX script for viewing example
  26.       ASCIIorb.info     -icon
  27.  
  28.       ANSIorb.ans       -example of black and white ANSI output
  29.       ANSIorb           -IconX script for viewing example
  30.       ANSIorb.info      -icon
  31.  
  32.       COLORorb.ilbm     -IFF screen from which COLORorb.ans was made.
  33.  
  34.       COLORorb.ans      -example of color ANSI output
  35.       COLORorb          -IconX script for viewing example
  36.       COLORorb.info     -icon
  37.  
  38.       .info             -placement data for icons
  39.  
  40.  
  41.       ****************************************************************
  42.  
  43.          This program is dedicated to the memory of Jamie Main, my
  44.       best friend, co-worker, and fellow Amigoid who left this life 
  45.       behind quite abruptly on August 15th, 1990.
  46.  
  47.       ****************************************************************
  48.  
  49.          IFFCHR is an Amiga graphics utility that will translate 
  50.       non-HAM IFF screens into character graphics text files that 
  51.       approximate the same shapes and colors as in the original 
  52.       screen.
  53.  
  54.          IFFCHR is primarily targeted for BBS users who want to
  55.       participate in "ANSI artwork" message bases.  These sections
  56.       of the BBS will allow color changes and other text screen
  57.       functions through the use of ANSI control characters.
  58.  
  59.          Although nothing is implied in the ANSI standard, the use
  60.       and proper viewing of BBS-style ANSI usually requires both a
  61.       standard 8-color palette and the IBM extended ASCII
  62.       character set to be present.  This can be achieved through
  63.       use of "colorbench" and Preferences to achieve the proper
  64.       colors, while the IBM extended ASCII can be found in the
  65.       Amiga font "ibm5.font".  Use FED to change this font to
  66.       non-proportional, if necessary, and then use FF to install
  67.       the font globally.
  68.  
  69.          As an alternative, a limited ANSI viewer is included for
  70.       viewing IFFCHR examples.  The viewer is called "ReadCHR" 
  71.       and is restricted to color changes only.  No cursor
  72.       movements, bold colors, etc, are supported by ReadCHR at 
  73.       this time.
  74.  
  75.          Many of you may be familiar with various "ANSI paint"
  76.       programs used to create ANSI artwork.  While IFFCHR will
  77.       produce ANSI text, it does so in a very different way. 
  78.       Rather than trying to create a graphic in low resolution
  79.       ANSI character graphics, IFFCHR allows you to use the IFF
  80.       format to create your art first in high resolution.  It then 
  81.       translates that directly into ANSI text.
  82.  
  83.           IFFCHR also produces black and white ANSI, and "plain
  84.       vanilla" ASCII graphics.  The ASCII can be loaded into a
  85.       word processor for editing.
  86.  
  87.       ****************************************************************
  88.  
  89.          Here is a brief rundown of the options you'll be
  90.       presented with...
  91.  
  92.  
  93.          Read from...   Enter the file name of the non-HAM IFF
  94.                         screen you wish to convert here.
  95.  
  96.          Save as...     File name to save by.
  97.  
  98.          Color          When set to "Color", ANSI color control
  99.          (toggle)       characters will be used.  The IFF screen
  100.                         will be re-mapped to the target palette.
  101.  
  102.                         When set to "No Color", only black and
  103.                         white colors are used for ANSI.  The IFF
  104.                         screen will be re-mapped using dot-densities
  105.                         to a 2-color palette.  If "ASCII only" is 
  106.                         selected (see next menu), no color control 
  107.                         characters will be output.
  108.  
  109.          Graphic Font   When set to "Graphic Font", the IBM
  110.          (toggle)       extended ASCII character set will be used
  111.                         in the output.  This allows several extra
  112.                         characters to be used in the translation,
  113.                         providing greater detail.  An IBM 8 type of
  114.                         font is required for viewing the results.
  115.  
  116.                         When set to "ASCII only", plain vanilla
  117.                         ASCII text is used in the output.  Also,
  118.                         various characters such as "." and "\"
  119.                         will be excluded to avoid popular control
  120.                         characters used on several ASCII-only BBS
  121.                         programs.   The resulting file can also be
  122.                         edited in a word processor.
  123.  
  124.          Line Feeds     This toggle selects between two
  125.            only         end-of-line combinations.  Either
  126.          (toggle)       line feeds only can be selected, or
  127.                         carriage returns in combination with
  128.                         line feeds. 
  129.  
  130.          About          Credits and information.
  131.  
  132.          Line Length    Length of lines in final text output. 
  133.                         Although most BBS programs are 80 column,
  134.                         there is often a prompt of one of more
  135.                         characters at the beginning of each line. 
  136.                         Line lengths of 77 will usually get around
  137.                         this problem.
  138.  
  139.          Gray Level     IFFCHR uses this value to determine cutoff
  140.                         levels in palette conversion.  This value
  141.                         is used in both Color and No Color modes.
  142.                         A higher setting here will increase
  143.                         contrast, but will also limit the number
  144.                         of colors used.
  145.  
  146.          Start          Activates conversion routine.  During
  147.                         conversion, work can be viewed and aborted
  148.                         early with a left-mouse-button click. 
  149.                         The abort option is active when the mouse
  150.                         pointer changes to an EXIT sign.
  151.  
  152.          Window Close   This standard window gadget in the upper
  153.                         left corner of the options screen will
  154.                         terminate the session.
  155.  
  156.       ****************************************************************
  157.  
  158.          IFFCHR performs approximately 12,160 comparison tests per
  159.       character output.  This amounts to over 24 million
  160.       comparisons on a 80x25 character screen in which there are
  161.       no solid areas of color.  In solid patches, IFFCHR
  162.       immediately outputs a blank space to save time.
  163.  
  164.          The results you get from IFFCHR correspond directly to
  165.       the quality of the IFF screen that is input.  This is
  166.       especially true when it comes to palette decisions and the
  167.       level of detail contained in the graphic.  These factors are
  168.       altered to a degree by the "gray level" setting in IFFCHR
  169.       options gadget window, but are better off determined while
  170.       in the process of creating the IFF itself.
  171.  
  172.          Using a paint program or other graphic utility will
  173.       allow you to condition the screen for optimum conversion
  174.       characteristics.
  175.  
  176.          Included with IFFCHR are some examples of its output.
  177.       Icons are provided for Workbench use with IconX in the C:
  178.       directory, or "ReadCHR" can be used from CLI to view the 
  179.       examples in the following  format:
  180.  
  181.          ReadCHR filename
  182.  
  183.          The examples provided here with extensions of ".ans" or 
  184.       ".asc" can be viewed with this utility.  
  185.  
  186.       ****************************************************************
  187.  
  188.          Unregistered versions of IFFCHR will insert a small ad
  189.       in the output of the program.  Registered versions will
  190.       have this hindrance removed.  The unregistered version is
  191.       freely redistributable.  The registered version is NOT.  To 
  192.       register, send your name, address, and a check or money 
  193.       order for $12 (US) to:
  194.  
  195.                               David Hopwood
  196.                               P.O. Box 4485
  197.                               Dearborn, MI
  198.                                  48126-0485
  199.  
  200.       ****************************************************************
  201.  
  202.          No warranties are implied or expressed with regard to the 
  203.       fitness or merchantability of this material for any particular 
  204.       purpose.  All risks and damages, incidental or otherwise, 
  205.       arising through the use or misuse of this material are entirely 
  206.       at the responsibility of the user.
  207.  
  208.