home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / PIECES1.ZIP / HLINK.DOC < prev    next >
Encoding:
Text File  |  1993-08-30  |  9.7 KB  |  190 lines
  1.                                 ABOUT HLINK.EXE
  2.  
  3.          HLINK.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.          Hlink   delivers   interactive   user   interface   to   your
  11.          presentations of a type called  "Hyperlinking".  With  Hlink,
  12.          you can display any onscreen image, and the end user is given
  13.          an  arrow  which can be moved with the mouse, arrow or number
  14.          keys. The user can point to something on  your  image,  click
  15.          the  left  mouse  button  or  press  [Enter]  and be taken to
  16.          another part of your presentation. Accompanying HLINK.EXE  in
  17.          the  PIECES  kit  of programs is MAKELINK.EXE, with which you
  18.          create links.
  19.  
  20.                                  How To Use It
  21.  
  22.          First  you  must  create  a  file  of  one or more links with
  23.          MAKELINK.EXE. This is a text file which contains four numbers
  24.          and a filename on each line. The  four  numbers  represent  a
  25.          sensitized  area  on screen.  When HLINK runs, it waits for a
  26.          user to click a  mouse  button  or  press  [Enter].  It  then
  27.          examines  the  file  of  links  and  if  it  finds  one  line
  28.          with an area containing the current position  of  the  arrow,
  29.          then  whatever  is on that line is executed, and HLINK.EXE is
  30.          done.
  31.  
  32.             From the DOS prompt, or within a  batch  or  script  file,
  33.          present  the  image  which  will be used as the HLINK picture
  34.          (often thought  of  as  a  menu  picture).  Then  run  HLINK,
  35.          followed  by  the  name  of  the  file containing your links.
  36.          Here's an example of a RUN script:
  37.  
  38.          PPCX.EXE ANIMALS.PCX
  39.          HLINK.EXE ANIMALS.CFG
  40.          CLEAR.EXE
  41.  
  42.          In the above example, PPCX projects an image you have created
  43.          called ANIMALS.PCX.  We'll assume it is a  menu  image,  with
  44.          pictures  of various  animals,  and  perhaps  containing  the
  45.          names of the animals in text below each animal's picture, and
  46.          also containing a simple line  of  text  to  the  effect  of,
  47.          "Point  to  an animal and click left mouse button."  For this
  48.          example, we must also assume you've already used MAKELINK.EXE
  49.          with ANIMALS.PCX to create ANIMALS.CFG, your chosen  filename
  50.          to contain links to various specific animal pictures.
  51.  
  52.          You  may  be  surprised  to  find out that once HLINK finds a
  53.          link, it is done, and disappears into  DOS-land  forever.  In
  54.          order to proceed with a presentation, you would normally call
  55.          HLINK  again,  when done running the linked file.  One way to
  56.          accomplish this is to link RUN.EXE with a simple script  file
  57.          which RUNs the program you want to link, then calls HLINK.EXE
  58.          with  it's  associated  link  file  again, thereby creating a
  59.          loop.
  60.  
  61.          If a mouse is not available, HLINK  still  works  fine.   The
  62.          arrow can be steered with the arrow keys, or number keys.  If
  63.          the  [Num  Lock]  key is on, pressing any number other than 5
  64.          will move the arrow in large leaps.  The  numbers  [7],  [9],
  65.          [1]  and  [3]  move the arrow diagonally. With the [Num Lock]
  66.          key off, the arrow moves  slowly  -  one  pixel  at  a  time.
  67.          [Home],  [End],  [Page  Up]  and  [Page  Down] move the arrow
  68.          diagonally.  Press [Enter]  to  simulate  clicking  the  left
  69.          mouse  button.   You  might consider putting this information
  70.          about the arrow movement keys in an early instruction picture
  71.          in large presentations.
  72.  
  73.                             Additional Information
  74.  
  75.          NOTE:  Also  see  MAKELINK.DOC  for  more  information  about
  76.          Hyperlinking.
  77.  
  78.              If the user clicks where two  sensitized  areas  overlap,
  79.          then  the first one in the link file is the one which will be
  80.          executed.
  81.  
  82.              HLINK  can  also  run  .COM  files and .BAT files, but it
  83.          cannot display text or graphics files directly.  It must  run
  84.          programs which will display text or display graphics.
  85.  
  86.              Filename extension is not usually required.  You can type
  87.          PGIF  or  PGIF.EXE,  for instance, and the effect will be the
  88.          same.  In the case where there are more than  one  file  with
  89.          the same name, but different extensions, then .BAT files will
  90.          be  run  instead  of  .COM  or  .EXE  files,  and  .COM takes
  91.          precedence over .EXE.
  92.  
  93.              HLINK can handle optional parameters for the programs  it
  94.          runs  of  up  to  about 60 characters in length. Maximum line
  95.          length in the links file is  100  characters,  including  the
  96.          position coordinates.
  97.  
  98.              There is no limit to the number  of  programs  HLINK  can
  99.          handle,  and  no  limit to the size of the file listing these
  100.          programs, but MAKELINK is  limited  to  100  links.   In  the
  101.          extremely  rare  case  where you would want to have more than
  102.          100 links per picture, you can use  MAKELINK  to  create  two
  103.          files  of  links,  then  combine  them  into  one with a text
  104.          editor.   A  more  reasonable  solution  would  be  to   link
  105.          sub-menus, so that each level would contain only a reasonable
  106.          amount of links.
  107.  
  108.          HLINK.EXE can be executed from within other programs, and  of
  109.          course,  you  can  execute programs from within HLINK.  HLINK
  110.          supports all standard text and graphics modes.
  111.  
  112.          You can create or modify link files directly if  you  prefer.
  113.          Use your favorite word processing  or  text  editing  program
  114.          which  works  in  standard ASCII mode.  If you have Microsoft
  115.          Windows, you'll find the included NOTEPAD program  does  this
  116.          well.  Here's what you have to know to edit link files:
  117.  
  118.          *Each  line in a link file contains four numbers, followed by
  119.          a filename and perhaps optional parameters.
  120.  
  121.          *Each line must start at the leftmost position on the screen,
  122.          there  can  be  no spaces.
  123.  
  124.          *Each line is independent of other lines.
  125.  
  126.          *There must be no blank lines.
  127.  
  128.          *Each  line  starts  with  4  numbers  separated  by  spaces.
  129.          They  are  coordinates  marking  a  rectangular region on the
  130.          screen.  The measurements are in pixels, ranging  from  0  at
  131.          the top and left, to full-screen size at the lower right.  In
  132.          the  case  of  16-color  VGA,  for  instance, the lower right
  133.          corner would be 639 and 479.
  134.              If  the  user  clicked  a mouse button or pressed [Enter]
  135.          when the arrow was within the rectangle,  then  this  is  the
  136.          line which will be executed.
  137.              The   first  number  represents  the  left  edge  of  the
  138.          sensitized area. The second number is the top  boundary.  The
  139.          third  is  the right edge boundary and the last number is the
  140.          bottom.
  141.  
  142.                                  About Pieces
  143.  
  144.          PIECES is a shareware disk containing several small  programs
  145.          that  can  be  combined  to  do  a  variety  of  tasks   with
  146.          a super-professional look and feel. No programming experience
  147.          is  needed.   PIECES  can  be  expanded  to  incorporate your
  148.          favorite programs as well, so it's possibilities  for  making
  149.          and enhancing pictures shows, text presentations, multimedia,
  150.          electronic catalogs, teaching materials, executable software,
  151.          games, shareware and more are limitless!
  152.              You  can  register  as many or as few PIECES as you wish.
  153.          Registered users are licensed  to  copy  and  distribute  the
  154.          PIECES  along  with  their  finished  products.  Unregistered
  155.          users may copy and distribute the complete unmodified  PIECES
  156.          package,  but  may not use only portions of it until purchase
  157.          of registration.  Use  of  PIECES  beyond  30  days  requires
  158.          registration.
  159.              Most  unregistered  PIECES programs have a "unregistered"
  160.          notice which pops up randomly, approximately every 200 times.
  161.          This is removed from the registered versions, and also  saves
  162.          as much as 3,000 bytes disk space per program.
  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 file.
  187.  
  188.  
  189.  
  190.