home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / PIECES1.ZIP / MAKELINK.DOC < prev    next >
Encoding:
Text File  |  1993-08-30  |  8.9 KB  |  180 lines
  1.                               ABOUT MAKELINK.EXE
  2.  
  3.          MAKELINK.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.          MAKELINK  is  for  creating  link  files  to  be  used   with
  11.          HLINK.EXE,  a program which presents an arrow on any graphics
  12.          screen and lets the user select the next action taken by your
  13.          presentation by pointing to various items you have  pictured.
  14.          This   is   how   you   can   design  menus  and  hyperlinked
  15.          presentations.
  16.  
  17.          MAKELINK creates a text file containing one  or  more  lines.
  18.          Each  line contains 4 numbers followed by a filename and then
  19.          possibly  optional  parameters.  The  4  numbers  outline   a
  20.          "sensitized area." If the user clicks within this  sensitized
  21.          area, the filename on the line will be executed.
  22.  
  23.                                  How To Use It
  24.  
  25.          First  you  must create a picture to use as a menu. There are
  26.          two ways to start MAKELINK.EXE.   If  your  menu  picture  is
  27.          fully  contained  in  a  .PCX  or  .GIF  image, you can cause
  28.          MAKELINK to project this image when it starts.  If your  menu
  29.          picture  is  created by a combination of PIECES programs, you
  30.          may make a script to make the picture, then  have  that  same
  31.          script call MAKELINK.
  32.              If you want to use MAKELINK with a .PCX or .GIF image, at
  33.          the  DOS prompt, type MAKELINK, followed by a space, then the
  34.          name of a file which will contain the links,  another  space,
  35.          and  finally,  the  name of the .PCX or .GIF image containing
  36.          your menu picture. For the file to contain the links, you can
  37.          choose  any  DOS-legal  filename,  although  names  ending in
  38.          .EXE, .COM, .GIF, etc would be confusing.
  39.              If you want to use MAKELINK directly, make a script  file
  40.          (typically  called  by  RUN.EXE)  which projects your picture
  41.          then has a line which calls MAKELINK, optionally followed  by
  42.          the name of the file which you want to contain the links.
  43.              If you do not enter a link filename, you will be prompted
  44.          to type a name once MAKELINK starts.
  45.              If  you use a new name for the link file, a new file will
  46.          be created, but if you choose the name of a link  file  which
  47.          already  exists, you'll be able to edit existing links or add
  48.          and delete links to that file.
  49.              When MAKELINK starts, you'll  see  a  menu  with  several
  50.          choices:
  51.  
  52.          HELP - For on-screen information
  53.  
  54.          NEW  - To create a new link.  You start adding links to a new
  55.             file by selecting NEW.
  56.  
  57.          EDIT - To modify  the  position  or  filename  called  by  an
  58.             existing  link.  You can move any link, and change what it
  59.             does at any time.
  60.  
  61.          DELETE - To get rid of a link.
  62.  
  63.          NEXT - To view the next link in the file.  If you are already
  64.             looking  at the last link, or if there are no links in the
  65.             file, nothing will happen when NEXT is selected.
  66.  
  67.          PREVIOUS - To view previous links in the  file.   Every  time
  68.             PREVIOUS is selected, you'll see the link previous to  the
  69.             one  being  viewed.   If  you  are  at the begining of the
  70.             file, or if the file is new, nothing will happen.
  71.  
  72.          MOVE - This will move the menu to the lower left  corner  and
  73.             the top bar to the bottom, so that if an important area of
  74.             your picture is obscurred, you'll be able to see  it.   If
  75.             the menu and bar are already at the bottom,  they'll  jump
  76.             back to the top.
  77.  
  78.          QUIT - To end MAKELINK.EXE.
  79.  
  80.                             Additional Information
  81.  
  82.          When MAKELINK starts, the top bar shows the first link in the
  83.          file.  If you are using a short video mode, one with only 320
  84.          pixels  horizontally,  the top bar shows only the name of the
  85.          file to be executed and optional parameters.   In  any  other
  86.          video  mode,  it also shows the coordinates of the sensitized
  87.          area.
  88.  
  89.          If the link file is empty (new), then you will  see  a  blank
  90.          bar or one containing nothing but 4 zeroes.
  91.  
  92.          Also shown, unless the file is new, will be a rectangle which
  93.          demonstrates the actual sensitized area.  If you wish to move
  94.          this  rectangle  for  any  link,  simply select EDIT from the
  95.          menu.
  96.  
  97.          There is a 100-link limit to MAKELINK.  If  you  really  need
  98.          more  than  100  links per file, you can make two link files,
  99.          then combine them with a word processing program, although  a
  100.          better solution is to create sub-menus.
  101.  
  102.          You can create or modify link files directly if  you  prefer.
  103.          Use your favorite word processing  or  text  editing  program
  104.          which  works  in  standard ASCII mode.  If you have Microsoft
  105.          Windows, you'll find the included NOTEPAD program  does  this
  106.          well.  Here's what you have to know to edit link files:
  107.  
  108.          *Each  line in a link file contains four numbers, followed by
  109.          a filename and perhaps optional parameters.
  110.  
  111.          *Each line must start at the leftmost position on the screen,
  112.          there  can  be  no spaces.
  113.  
  114.          *Each line is independent of other lines.
  115.  
  116.          *There must be no blank lines.
  117.  
  118.          *Each  line  starts  with  4  numbers  separated  by  spaces.
  119.          They  are  coordinates  marking  a  rectangular region on the
  120.          screen.  The measurements are in pixels, ranging  from  0  at
  121.          the top and left, to full-screen size at the lower right.  In
  122.          the  case  of  16-color  VGA,  for  instance, the lower right
  123.          corner would be 639 and 479.
  124.              If  the  user  clicked  a mouse button or pressed [Enter]
  125.          when the arrow was within the rectangle,  then  this  is  the
  126.          line which will be executed.
  127.              The   first  number  represents  the  left  edge  of  the
  128.          sensitized area. The second number is the top  boundary.  The
  129.          third  is  the right edge boundary and the last number is the
  130.          bottom.
  131.  
  132.                                  About Pieces
  133.  
  134.          PIECES is a shareware disk containing several small  programs
  135.          that  can  be  combined  to  do  a  variety  of  tasks   with
  136.          a super-professional look and feel. No programming experience
  137.          is  needed.   PIECES  can  be  expanded  to  incorporate your
  138.          favorite programs as well, so it's possibilities  for  making
  139.          and enhancing pictures shows, text presentations, multimedia,
  140.          electronic catalogs, teaching materials, executable software,
  141.          games, shareware and more are limitless!
  142.              You  can  register  as many or as few PIECES as you wish.
  143.          Registered users are licensed  to  copy  and  distribute  the
  144.          PIECES  along  with  their  finished  products.  Unregistered
  145.          users may copy and distribute the complete unmodified  PIECES
  146.          package,  but  may not use only portions of it until purchase
  147.          of registration.  Use  of  PIECES  beyond  30  days  requires
  148.          registration.
  149.              Most  unregistered PIECES programs have an "unregistered"
  150.          notice which pops up randomly, approximately every 200 times.
  151.          This is removed from the registered versions, and also  saves
  152.          as much as 3,000 bytes disk space per program.
  153.  
  154.              This software is  copyrighted  by  Jeff Napier of Another
  155.          Company, and distributed by Gary Smith of OEC Systems.
  156.              
  157.              The  shareware  or  registered  versions of PIECES may be
  158.          purchased from Gary Smith at OEC Systems:
  159.  
  160.                                 Gary Smith
  161.                                 c/o OEC Systems
  162.                                 4646 North Shallowford Road
  163.                                 Atlanta, GA  30338-6304
  164.  
  165.                                 phone: 404-394-1000
  166.                                 orders only: 800-444-2424
  167.                                 fax: 404-394-1006
  168.                                 BBS: 404-804-7889
  169.                                 
  170.                                 MasterCard and VISA accepted
  171.  
  172.              Neither Another Company nor Gary Smith/OEC Systems assume 
  173.          any  responsibility  for  your  use  of  this  product or any 
  174.          Another Company product.
  175.          _____________________________________________________________
  176.                                                           end of file.
  177.  
  178.  
  179.  
  180.