home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / PIECES1.ZIP / PIECES.DOC < prev    next >
Encoding:
Text File  |  1993-08-30  |  9.3 KB  |  187 lines
  1.                                     PIECES
  2.  
  3.                                  Version 1.00
  4.  
  5.                   Shareware, Copyright 1993, Another Company
  6.  
  7.          A suite of inter-related small programs with  which  you  can
  8.          build   just  about  anything  for  the  IBM-compatible.   No
  9.          programming  experience  is  required.   However, programmers
  10.          too, can use PIECES to avoid reinventing  wheels  by  calling
  11.          these programs from within their own software.
  12.  
  13.                           What You Can Do With Pieces
  14.  
  15.          If you've ever wanted to build your own programs,  tutorials,
  16.          graphical user  interfaces,  menus,  catalogs,  slide  shows,
  17.          technical  presentations, shareware, school materials, if you
  18.          have anything to say in words, pictures  or  sounds,  if  you
  19.          want  your  finished  products  to  be  of truly professional
  20.          quality, if you have just one little thing  you'd  like  your
  21.          computer  to  do,  or  if you like to piece together your own
  22.          grand unified software, whether  you  are  a  beginner  or  a
  23.          programmer, PIECES is for you!
  24.  
  25.          You can use one of the PIECES (small programs) or all of  the
  26.          PIECES  in  this  kit  to:  Show  a .PCX or .GIF file, make a
  27.          hyperlinked show, run your text files, make a menu, hook your
  28.          own programs into a presentation, make a  self-running  kiosk
  29.          demonstration,  compose  a  song,  talk  to  you,  make  your
  30.          programming tasks simpler, make your finished  products  look
  31.          like finished products, sell your products, and anything else
  32.          you need.
  33.  
  34.                                  Specifically:
  35.  
  36.          All  of  the  programs on this disk can  be  inter-related to
  37.          themselves or to outside software.
  38.              For  instance,  you might project a .GIF graphics file on
  39.          the screen, then write a title on it, then  run  a  digitized
  40.          speech  file,  then  show  a menu, which presents an arrow so
  41.          that the user can hyperlink to another .GIF image, which  you
  42.          then  present,  etc. All this can be done with PIECES.
  43.              Not  only  will you be able to use the software presented
  44.          in this PIECES package, but  you  can  run  the  PIECES  from
  45.          within  other  programs,  and you can run other programs from
  46.          within  PIECES.   This  is  perhaps  the very best feature of
  47.          PIECES, you can run  almost  anything  which  has  ever  been
  48.          written for IBM-compatibles from within PIECES.
  49.  
  50.                                How to Use PIECES
  51.  
  52.          The foundations  of  PIECES  presentations  or  programs  are
  53.          called  script files.  These are simply text files containing
  54.          one or more lines of instructions.  These  instructions  tell
  55.          one  or  more  PIECES  to  start  up and do their thing.  The
  56.          script files look a  bit  like  batch  files,  but  they  are
  57.          simpler. To write script files, simply use your favorite word
  58.          processing program or text editor in standard ASCII mode.  If
  59.          you  have  Microsoft  Windows,  you might like to use NOTEPAD
  60.          which is a standard and easy-to-use text editor.
  61.  
  62.          Pieces  script  files  are  most  often  run by PIECES called
  63.          RUN.EXE,  SEQUENCE.EXE,  HLINK.EXE   and   LOOP.EXE.    These
  64.          interpret  and  dispatch  the  commands  you have put in your
  65.          script files.
  66.  
  67.          To understand more about what each PIECE does, and how to use
  68.          it, read all the chapters which follow.
  69.  
  70.          Then, experiment.  The powers of this package are  fantastic,
  71.          but  you  may  have  to try things several different ways and
  72.          read the documentation files several times before you get the
  73.          results you want.
  74.  
  75.          To  find  out  how to purchase PIECES, and about other PIECES
  76.          which are available only from ANOTHER COMPANY, see the  OTHER
  77.          THINGS   chapter  (THINGS.DOC  file)  at  the  end  of  these
  78.          chapters.
  79.  
  80.          PIECES  is shareware.  You may copy and distribute this whole
  81.          set as long as you keep all files intact and  unchanged.   If
  82.          you  are  a  shareware distributor you may add your own batch
  83.          and text files.
  84.              If you use any of the PIECES you must register it  within
  85.          30  days.   You  may  register individual PIECES for very low
  86.          cost each, or the whole package for even lower cost.
  87.              Most  of  the  programs  in this shareware version have a
  88.          little "unregistered" pop-up notice  which  occurs  randomly,
  89.          every  200th  time.  The registered versions do not have this
  90.          nocice, and some are as much as 3000 bytes smaller  with  the
  91.          notice function removed.
  92.  
  93.                                   An Example
  94.  
  95.          For  a  complex  example of PIECES in operation examine these
  96.          sample files in the  PIECES  package  BEGIN.BAT,  PIECES.CFG,
  97.          NOEGA,  and  HASEGA,  using  your  favorite text file viewing
  98.          program or DREAM.EXE (Type: DREAM filename, where filename is
  99.          the file you want to view.
  100.  
  101.                                      Oops!
  102.  
  103.          It  is  possible  to  accidentally  stack up too many pieces.
  104.          Each  one  takes  up  a valuable bit of the base 640k of RAM,
  105.          and with enough layers, all the RAM will  disappear.   You'll
  106.          want  to be careful to engineer complex presentations so that
  107.          you never get more than several layers deep.
  108.  
  109.                                     Windows
  110.  
  111.          All of the PIECES run fine under Windows or DOS.  However, as
  112.          with any multimedia, sounds and  motion  effects  may  appear
  113.          choppy if multitasking  under  Windows  unless  you  dedicate
  114.          100%  of  foreground  and  background  processor time to your
  115.          PIECES application.
  116.  
  117.                                     History
  118.  
  119.          This  is  version  1.00  of  what promises to have a long and
  120.          interesting   history.    I  intend  to  continue  making new
  121.          PIECES  everytime  an interesting need comes up.  What I need
  122.          now, are your suggestions for what  new  PIECES  need  to  be
  123.          invented.   Because  it  is  new,  I'd really appreciate your
  124.          comments: What needs to be improved, what  works  well,  what
  125.          features  I could add, ways to improve the documentation, bug
  126.          reports, and especially ideas for new PIECES.  Also  keep  in
  127.          touch  if  you  would like to know about what new PIECES have
  128.          been created since this shareware was released.
  129.  
  130.                                 Gary Smith
  131.                                 c/o OEC Systems
  132.                                 4646 North Shallowford Road
  133.                                 Atlanta, GA  30338-6304
  134.  
  135.                                 phone: 404-394-1000
  136.                                 orders only: 800-444-2424
  137.                                 fax: 404-394-1006
  138.                                 BBS: 404-804-7889
  139.                                 
  140.                              A Note To Programmers
  141.  
  142.          If   you  would  like  to  make  programs  with  hyperlinked,
  143.          mouse-supported menus, or display .GIF or  .PCX  images  from
  144.          within  your  software,  or many other such things, but don't
  145.          even know where to start, you'll  find  that  PIECES  can  do
  146.          these  things for you, saving your valuable time.  Instead of
  147.          spending months  trying  to  figure  out  how  to  bend  your
  148.          programming  language to the job, simply shell, exec or spawn
  149.          some of the PIECES from within programs.
  150.              Most  of  the pieces have very small memory requirements,
  151.          but you must usually explicitly leave  some  stack  and  heap
  152.          space  for  them.   See your programming language manuals for
  153.          more details.
  154.  
  155.          Quick Basic example:
  156.             SHELL("FADE.EXE 10");
  157.  
  158.          C/C++ example:
  159.             result = spawnp(P_WAIT,"PGIF.EXE","LOGO.GIF");
  160.  
  161.          Turbo Pascal example:
  162.             exec('HLINK.EXE','HLINK.CFG');
  163.  
  164.              This software is  copyrighted  by  Jeff Napier of Another
  165.          Company, and distributed by Gary Smith of OEC Systems.
  166.              
  167.              The  shareware  or  registered  versions of PIECES may be
  168.          purchased from Gary Smith at OEC Systems:
  169.  
  170.                                 Gary Smith
  171.                                 c/o OEC Systems
  172.                                 4646 North Shallowford Road
  173.                                 Atlanta, GA  30338-6304
  174.  
  175.                                 phone: 404-394-1000
  176.                                 orders only: 800-444-2424
  177.                                 fax: 404-394-1006
  178.                                 BBS: 404-804-7889
  179.                                 
  180.                                 MasterCard and VISA accepted
  181.  
  182.              Neither Another Company nor Gary Smith/OEC Systems assume 
  183.          any  responsibility  for  your  use  of  this  product or any 
  184.          Another Company product.
  185.          _____________________________________________________________
  186.                                                        end of chapter.
  187.