home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / PIECES1.ZIP / LIVETEXT.DOC < prev    next >
Encoding:
Text File  |  1993-08-30  |  10.4 KB  |  231 lines
  1.                                 ABOUT LIVETEXT.EXE
  2.  
  3.          LIVETEXT.EXE  is  a  program from the kit, PIECES, by Another
  4.          Company.  With PIECES, you can create just about anything for
  5.          IBM-compatible computing.  No programming skill is necessary.
  6.          See end of this file for more information about PIECES.
  7.  
  8.                                  What It Does
  9.  
  10.          LIVETEXT.EXE  will display text  within  a  graphics  picture
  11.          from any size standard ASCII file in any selected *.MMF font.
  12.          The text is scrollable with mouse or  arrow  keys.  (assuming
  13.          the  text  file  contains  more  than  will fit on the screen
  14.          simultaneously), and will remain  on-screen  until  the  user
  15.          presses the [Esc] key or right mouse button.
  16.  
  17.                                  How To Use It
  18.  
  19.          Type  LIVETEXT.EXE in a script or batch file while a graphics
  20.          image is being displayed.   Follow  LIVETEXT.EXE  with  these
  21.          parameters,  all  on  the  same line, all separated by spaces
  22.          (see example below):
  23.  
  24.          1) an integer for the left boundary of the  area  to  contain
  25.          the Live Text.
  26.  
  27.          2) an integer for the top boundary of the area to contain the
  28.          Live Text.
  29.  
  30.          3) an integer for the right boundary of the area  to  contain
  31.          the Live Text.
  32.  
  33.          4)  an integer for the bottom boundary of the area to contain
  34.          the Live Text.
  35.  
  36.          5) an integer for the color (see chart below).
  37.  
  38.          6) an integer for startup Autoscroll speed. Autoscroll  is  a
  39.          function of Live Text in which the text scrolls automatically
  40.          at various speeds until the user presses any key. If the user
  41.          presses  a  number  when Live Text is operational, Autoscroll
  42.          begins.  1  begins  slow  Autoscroll  and  9  is  very  fast.
  43.          Autoscroll  turns off automatically if Live Text comes to the
  44.          end of the text file.  If the number entered here is  greater
  45.          than  0,  then Autoscroll begins as soon as Live Text starts.
  46.          This can be useful in Kiosk (unattended, continuous  running)
  47.          presentations,  as  well  as  to show users that this is Live
  48.          Text, not  static  text).  To  avoid  automatically  starting
  49.          Autoscroll, enter 0 here.
  50.  
  51.          7)  The  name  of  the .MMF file to use for the font.  If you
  52.          want to use the built-in DEFAULT font, type DEFAULT here.
  53.  
  54.          8) The name of the standard ASCII file containing the text to
  55.          present.
  56.  
  57.                                   Coordinates
  58.  
  59.          The left edge of the screen is 0 and the right hand  edge  is
  60.          typically  639,  depending  on the current graphics mode. The
  61.          top of the screen is 0, and the bottom is  199,  or  greater,
  62.          depending on the graphics mode.
  63.  
  64.          CGA 2-color : right is 639, bottom is 199
  65.          CGA 4-color : right is 319, bottom is 199
  66.          Hercules : right is 719, bottom is 347
  67.          EGA Low resolution : right is 639, bottom is 199
  68.          EGA High resolution : right is 639, bottom is 349
  69.          VGA 16-color : right is 639, bottom is 479
  70.          VGA 256-color : right is 319, bottom is 199
  71.          Super-VGA : right could be 639, 799 or 1023,
  72.             bottom could be 239,399,479,599,767
  73.  
  74.                                     Colors
  75.  
  76.          After  the location numbers, type an integer representing the
  77.          color  for the text.  The first 16 colors of 16 and 256 color
  78.          modes usually correspond to  the  chart  below,  but  may  be
  79.          changed  by .PCX or .GIF files that take control of the color
  80.          palette:
  81.  
  82.          0 : black
  83.          1 : royal blue
  84.          2 : forest green
  85.          3 : cyan
  86.          4 : red
  87.          5 : purple
  88.          6 : brown
  89.          7 : light gray
  90.          8 : dark gray
  91.          9 : electric blue
  92.          10 : light green
  93.          11 : sky blue
  94.          12 : light red
  95.          13 : magenta
  96.          14 : yellow
  97.          15 : white
  98.  
  99.          The  PIECES  kit comes with several .MMF bitmapped font files
  100.          which are for use with LIVETEXT.EXE.  Several more .MMF files
  101.          are available from Another Company also.
  102.  
  103.          Create  a  text  file  for  LIVETEXT.EXE to use with any word
  104.          processing  program  which  works  in  standard  ASCII  mode.
  105.          Microsoft Windows comes with NOTEPAD, a good program for this
  106.          use. The file can be as long  as you wish.  It  is  advisable
  107.          to  avoid  making lines of characters longer than will fit on
  108.          the screen in the font you have chosen,  because  the  excess
  109.          length will not be displayed.
  110.  
  111.          So,  assuming you have created a file called INTRO.TXT, which
  112.          contains a whole bunch of text, you could type the  following
  113.          in a script or batch file:
  114.  
  115.          PGIF.EXE ARTINTRO.GIF
  116.          LIVETEXT.EXE 20 5 619 474 15 2 PLAZA14.MMF INTRO.TXT
  117.  
  118.          and this is what would happen: First PGIF.EXE  is  called  to
  119.          present   a   .GIF   image   file  you  have  created  called
  120.          ARTINTRO.GIF.  Then LIVETEXT.EXE will present  the  text  you
  121.          have  put  in  the  file,  INTRO.TXT  over  your ARTINTRO.GIF
  122.          picture.  The text will be positioned in a box 20 pixels from
  123.          the left edge of the screen, and 5 pixels from the  top,  619
  124.          pixels to the right and 474 pixels to the bottom.  It will be
  125.          in   color  #15,  which  is  usually  white,  it  will  start
  126.          Autoscroll automatically with the speed of 2, and it will  be
  127.          displayed using PLAZA14 font, which is 14 pixels high.
  128.  
  129.          NOTE: Live Text is very picky about all these parameters, all
  130.          must  be  correct,  within  an  acceptable  range, and in the
  131.          proper order. If you cannot get Live Text to work  the  first
  132.          time   you   try  it,  carefully  reread  this  document  and
  133.          experiment several times until you get it right.
  134.  
  135.          In summary, a line calling Live Text in  a  script  or  batch
  136.          file or from within a program needs:
  137.  
  138.          1-4) four integers representing the left, top, right and bottom
  139.          boundaries in pixels.
  140.  
  141.          5) an integer representing text color
  142.  
  143.          6) an integer representing Autoscroll speed, generally 0.
  144.  
  145.          7) the name of a  .MMF  font  file  or  DEFAULT  to  use  the
  146.          built-in font.
  147.  
  148.          8) The name of the file containing the text.
  149.  
  150.          Each of the above parameters must be separated by a space.
  151.  
  152.                             Additional Information
  153.  
  154.          Live Text examines the pixel located 4 pixels to the right of
  155.          the  left  boundary  and 4 pixels below the top boundary, and
  156.          assumes this color as the background color.
  157.  
  158.          LIVETEXT.EXE requires a graphics mode, meaning a picture must
  159.          be on the screen before LIVETEXT.EXE is called.
  160.  
  161.          Live  Text  requires pressing [Esc] or the right mouse button
  162.          to quit, and will leave the last section of  text  viewed  on
  163.          the screen.  Therefore, you generally want to advise the user
  164.          about  how to work Live Text before it is presented. Also, to
  165.          make  a  seamless  presentation,  you  would  normally  erase
  166.          the Live Text when done, by replaying the .GIF or .PCX image,
  167.          or drawing a rectangle over the area containing the text,  or
  168.          by moving on to another part of your presentation.
  169.  
  170.          Live Text has several built-in functions:
  171.  
  172.          [F1]  :  The  user  can  press  the  [F1]  key  for a list of
  173.          functions.
  174.  
  175.          [P] : To print a Live Text file to the printer.
  176.  
  177.          [S] : To search for any word or phrase within the Live Text.
  178.  
  179.          [1-9]  :  Autoscroll,  the  text will scroll automatically at
  180.          various speeds until the user presses any key  or  until  the
  181.          end of the text file is presented. 1 is slow, and 9 is fast.
  182.  
  183.                                  About Pieces
  184.  
  185.          PIECES is a shareware disk containing several small  programs
  186.          that  can  be  combined  to  do  a  variety  of  tasks   with
  187.          a super-professional look and feel. No programming experience
  188.          is  needed.   PIECES  can  be  expanded  to  incorporate your
  189.          favorite programs as well, so it's possibilities  for  making
  190.          and enhancing pictures shows, text presentations, multimedia,
  191.          electronic catalogs, teaching materials, executable software,
  192.          games, shareware and more are limitless!
  193.              You  can  register  as many or as few PIECES as you wish.
  194.          Registered users are licensed  to  copy  and  distribute  the
  195.          PIECES  along  with  their  finished  products.  Unregistered
  196.          users may copy and distribute the complete unmodified  PIECES
  197.          package,  but  may not use only portions of it until purchase
  198.          of registration.  Use  of  PIECES  beyond  30  days  requires
  199.          registration.
  200.              Most  shareware  PIECES  programs  have  a "unregistered"
  201.          notice which pops up randomly, approximately every 200 times.
  202.          This is removed from the registered versions, and also  saves
  203.          as much as 3,000 bytes disk space per program.
  204.  
  205.              This software is  copyrighted  by  Jeff Napier of Another
  206.          Company, and distributed by Gary Smith of OEC Systems.
  207.              
  208.              The  shareware  or  registered  versions of PIECES may be
  209.          purchased from Gary Smith at OEC Systems:
  210.  
  211.                                 Gary Smith
  212.                                 c/o OEC Systems
  213.                                 4646 North Shallowford Road
  214.                                 Atlanta, GA  30338-6304
  215.  
  216.                                 phone: 404-394-1000
  217.                                 orders only: 800-444-2424
  218.                                 fax: 404-394-1006
  219.                                 BBS: 404-804-7889
  220.                                 
  221.                                 MasterCard and VISA accepted
  222.  
  223.              Neither Another Company nor Gary Smith/OEC Systems assume 
  224.          any  responsibility  for  your  use  of  this  product or any 
  225.          Another Company product.
  226.          _____________________________________________________________
  227.                                                           end of file.
  228.  
  229.  
  230.  
  231.