home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d139 / wheelchairsim.lha / WheelChairSim / MANUAL < prev    next >
Text File  |  1988-05-15  |  31KB  |  1,088 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                   WHEELCHAIR SIMULATOR PACKAGE
  12.                        (Draft 2  4-Feb-88)
  13.  
  14.  
  15.  
  16.                                                    *
  17.              T. Mathews, M. Smith and J. McLaughlin
  18.  
  19.  
  20.               Department of Electrical Engineering,
  21.                      University of Calgary,
  22.                 Calgary, Alberta, Canada T2N 1N4
  23.                                 
  24.                    *                         
  25.                    Technical Resource Centre,
  26.                  Suite 100, 525 11 Avenue, S.W.,
  27.                 Calgary, Alberta, Canada T2R OC9.
  28.  
  29.  
  30.  
  31.                     Contact person: M. Smith.
  32.                     (403) - 220 - 6142 (MDT)
  33.  
  34.  
  35.  
  36. FUNDING:  This  project was initially funded as a special project
  37. by  the   University  of  Calgary and the  Calgary Celebral Palsy
  38. Association. 
  39.  
  40.                    DISTRIBUTION AND COPYRIGHT
  41.  
  42.    This package  remains  the  copyright property of the authors.
  43. However,  you  are  free  to  copy  and  distribute  the  package
  44. provided  this  notice  remains  with  the  package.  You may not
  45. charge  for any package that includes this program other than for
  46. the  cost  of  the  diskette  to  which  it is copied. AMIGA user
  47. groups  and  the  ubiquitous FRED FISK can copy and distribute it
  48. as per normal.  
  49.  
  50.    If you  find  the  package  useful,  then  in  the  spirit  of
  51. SHAREWARE,  you  are  requested to send a tax deductable donation
  52. (suggested  $20)  to  the  Wheelchair  Simulator  Project, c/o J.
  53. McLaughlin  at  the  Technical  Resource  centre address, so that
  54. another student can be hired to do further development work.  
  55.  
  56. WARNING:  Although  much care and attention has been given to the
  57. development   and  testing  of  the  programs  involved  in  this
  58. package,  no  warranty  is  given  that  the programs will behave
  59. exactly as described.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                         PROGRAM HISTORY:
  69.  
  70. The   WHEELCHAIR  SIMULATOR    was  suggested  as a project by J.
  71. McLaughlin  to  T.  Mathews  to  fulfill  the  requirements for a
  72. graphics  course taught by M. Smith. The course, ENEL513, is part
  73. of  the program in  COMPUTER ENGINEERING taught at the University
  74. of  Calgary  Electrical  Engineering  Department  (UCEE). Further
  75. development  work  by  T. Mathews and M. Smith occured across the
  76. summer  of 1987 using funds provided by the University of Calgary
  77. and  the  Calgary  Celebral  Palsy Association.  Credit is due to
  78. the  therapists  and patients of the Alberta Children's Hospital,
  79. Calgary   who   made  many  useful  suggestions  and  tested  the
  80. program.  
  81.  
  82. The   MAKER  program  is  based  on  a  project  developed  by S.
  83. Worthington  again  to fulfill a course requirement for ENEL 513.
  84. It  has  been  extensively modified by M. Smith who also designed
  85. the   LYNNETTE  graphical  interface  which allows the program to
  86. run on the AMIGA.  
  87.  
  88.  
  89.  
  90.                             FEEDBACK
  91.  
  92.  
  93.    Please send your feedback to 
  94.  
  95.      Dr. M. R. Smith,
  96.      Department of Electrical Engineering,
  97.      University of Calgary,
  98.      Calgary, Alberta, Canada T2N 1N4.
  99.  
  100.      (403) 220-6142 (MST)
  101.  
  102. who  is  currently  directing  the  software  development  of the
  103. project  (and  having  a  fun  time  hacking  when  his  new baby
  104. daughter  lets  him onto the terminal. Do you really think that 6
  105. months is TOO early?) 
  106.  
  107.    Please let  him  know  what you think of the program. (I don't
  108. like  the  wall  colours either but something keeps changing them
  109. back  to those colours and I can't find what.) Any suggestions on
  110. different  reinforcers  etc.,  and  information  on bugs would be
  111. useful.  
  112.  
  113.    In reporting  bugs,  please  don't  say  "THIS DOES WORK". Say
  114. instead  if  you do this, and then this, and then that, then this
  115. happens.  That  way,  I  can  trace  what might be happening. For
  116. example,  under  certain conditions (which I can't replicate) all
  117. the  bulletin  boards  and  other  objects move up to the highest
  118. horizontal  wall.  If  this happens, select the DELETE ALL option
  119. and  start  again. If you can make it happen consistently, let me
  120. know how and I'll fix it.  
  121.  
  122.  
  123.                                 M. Smith                      4th
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132. February 1988 
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                         PACKAGE CONTENTS
  197.  
  198.  
  199.    This package  of  programs is designed to enable therapists to
  200. evaluate  the  types  of  control  for  a  wheelchair used by the
  201. handicapped.  It  is  also  useful in providing some training for
  202. persons  who  need  to  become  more  familiar  with the use of a
  203. wheelchair in a non-threatening and safe environment.  
  204.  
  205.    The package  is  designed  to be run on an Amiga computer with
  206. 512K  memory,  a  colour  monitor,  a  joystick, a keyboard and a
  207. mouse.  The  programs  have been written in "C" and can be ported
  208. to  other  computers  that  have  colour graphic capability (e.g.
  209. Apple  G.S.).  Because  of  the size of the program, the need for
  210. graphic  capability  and  other  factors,  it  is  believed  that
  211. porting  to  a  computer  such  as  an  Apple  2E  would  not  be
  212. feasable.  
  213.  
  214.    The package   contains   5   programs,    CONTROLLER,   MAKER,
  215. WHEELCHAIR3D,  WHEELCHAIR2D, ANALYSIS and a series of predesigned
  216. floor plans.  
  217.  
  218. CONTROLLER: 
  219. This  is  a  program  designed  to  allow the easy calling of the
  220. other  programs  in  the package. People who become familiar with
  221. the  AMIGA  will  probably  find  that  the direct calling of the
  222. programs  from  the keyboard is a faster process.  It also allows
  223. changing of the date, patient name and other useful utilities.  
  224.  
  225. MAKER: 
  226. This  program  enables  the  user  to design a floor plan through
  227. which  the wheelchair operator can move. Walls, doorways, tables,
  228. cones  and  other  objects  can be placed as desired on the floor
  229. plan.  Objects  include  arrows  on  the  walls,  happy faces and
  230. bulletin  boards  with  messages.  Other  objects can be added by
  231. getting  the  authors in a good mood via buttering up their egos.
  232. Various  options  such  as wheelchair speed and rotation rate can
  233. be set for use by the wheelchair simulation programs.  
  234.  
  235.  
  236. WHEELCHAIR3D: 
  237. This  displays,  in  animated  3D,  a  view  of  the  floor plan,
  238. bulletin   boards,  etc.,  as  seen  by  a  person  seated  in  a
  239. wheelchair.  The  wheelchair  can  be  moved  through the plan or
  240. rotated by using the joystick.  
  241.  
  242. WHEELCHAIR2D: 
  243. Designed  to  allow  the  user  to become familiar with the floor
  244. plans  generated  by  the  therapist.  It  is more of a game than
  245. anything  else  but does allow some familiarity with the joystick
  246. to  be  obtained.  If  the   game aspect of using the joystick is
  247. important  in  the  therapy,   buy  a  commercial package such as
  248. PACMAN  rather  than  use this program.  There are some very good
  249. (free)  PUBLIC DOMAIN games available on FISH disks. Contact your
  250. local  AMIGA  user's  group  or  computer  shop for details.  The
  251. games  are  free  except  for the cost of the disk onto which you
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260. copy them.  
  261.  
  262. ANALYSIS:  (not yet in existance.) 
  263. This  is designed to allow the therapists to analyse the progress
  264. of  the   patient.  Suggestions as to what useful analysis should
  265. be made are requested.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.                         STARTUP PROCEDURE
  325.  
  326.    Connect your  AMIGA  computer with monitor, joystick and mouse
  327. as  suggested  in your manual. If you are using a custom joystick
  328. be  careful  when  connecting  to  an AMIGA 1000 computer as they
  329. have  a  live  (5  Volt) pin on the joystick connector. Make sure
  330. that  your  joystick  has  this pin disconnected. We have not yet
  331. found  a  joystick that causes a problem, but everybody has heard
  332. of  Murphy.  
  333.  
  334.    For the  AMIGA  1000 computer, insert the  KICKSTART disk into
  335. the  disk  drive and switch on the computer and monitor. With the
  336. AMIGA  500  and  2000 computer you simply switch on the computer:
  337. no KICKSTART disk is necessary.  
  338.  
  339. When  requested  by  a prompt on the screen, remove the KICKSTART
  340. disk  and  insert  the  WHEELCHAIR  SIMULATOR  disk into the disk
  341. drive.  In  a short period of time, the  CONTROLLER  program will
  342. load into memory and run itself.  
  343.  
  344.    Using the  BACKUP  command  of  the  controller  program,  you
  345. should  first  make  copies  of the wheelchair simulator disk and
  346. then  put  away  one  of  the  disks   in a safe location as your
  347. master  disk.   It  is  suggested  that  one  disk  be  used  per
  348. patient.  
  349.  
  350.    Once backup  copies  of  the  disks have been made, choose the
  351. options to run the  MAKER or SIMULATOR programs as required.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.                            CONTROLLER
  389.  
  390.  
  391.    The commands  for  running  this  program  will  appear on the
  392. screen.   Type  the  first  letter  of  the command and press the
  393. RETURN   key.  The  command  will  become  highlighted.  Entering
  394. another  letter  and  pressing  RETURN  will enable you to change
  395. your  choice.  Once  the correct command has been selected, press
  396. return key again and the command will be executed.  
  397.  
  398.  
  399.    The available commands are 
  400.  
  401. A  -  ANALYSIS  provides an analysis and print out of the results
  402. of  the patient sessions using the simulators. (Not available Feb
  403. 1988.) 
  404.  
  405. B  -  BACKUP  which  causes a copy of the master disk to be made.
  406. It  is  suggested  you  make a new disk for each patient and keep
  407. your master disk in a safe location.  
  408.  
  409. C  -  CHANGE which enables you to change the floor plan or change
  410. the  options for the simulation of an existing plan.  You will be
  411. provided  with  a  list of the names of the floor plans.  Type in
  412. the  name  of  the  plan  you wish to change and press the return
  413. key.  
  414.  
  415. D  -  DELETE  which  enables you to delete an unwanted floor plan
  416. from  the disk.  You will be provided with a list of the names of
  417. the  floor  plans.   Type  in  the  name  of the plan you wish to
  418. delete  and press the return key.  To avoid accidental removal of
  419. the  plans  by  the  patient, a password is required to cause the
  420. deletion. The password is Get on with it 
  421.  
  422. L  -  LIST  provides  a  list of the available floor plans on the
  423. current disk.  
  424.  
  425. M  -  MAKE  will allow the making of  a new floor plan.  You will
  426. be  provided  with a list of the names of the floor plans already
  427. existing  so  you  can choose another no conflicting name.  Press
  428. RETURN when you are ready.  
  429.  
  430. P  -  PATIENT  allows  the  changing  of the patients name on the
  431. disk.  The  patient  name  is  used  as a file name into which to
  432. store the analysis results from the simulator.  
  433.  
  434. R  -  REMOVE  removes  the  existing  floor  plans from the disk.
  435. Useful  command  if  you  can't  find  the master disk when a new
  436. patient  comes  in.  Copy  another patient's disk and then remove
  437. the  plans  from  it.  To  avoid  accidental removal, a series of
  438. passwords  are  required to cause the deletion. The passwords are
  439. Get on with it and or else!!!! 
  440.  
  441. T  -  TIME  and  DATE  allows the setting of the current time and
  442. date  of  the  session  for use by the analysis program. Once the
  443. time  and  date  are  set,  they are automatically changed by the
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452. computer until it is powered down.  
  453.  
  454. 2  -  2D  simulation  A  list  of  the  names  of the floor plans
  455. available  is  first  provided.  Type in the name of the plan you
  456. wish to run and press return.  
  457.  
  458. 3  -  3D  simulation  A  list  of  the  names  of the floor plans
  459. available  is  first  provided.  Type in the name of the plan you
  460. wish to run and press return.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.                               MAKER
  517.  
  518.  
  519.  
  520.  
  521.    This program   is   a   graphics   program   to  allow  simple
  522. interactive  entry  of a floor plan.  Rather than entering random
  523. floor  plans,  it  is  suggested that the therapist build a floor
  524. plan  of  a  situation  with  which the patient is familiar (e.g.
  525. hospital ward, home, school).  
  526.  
  527.                            DESCRIPTION
  528.  
  529.  
  530.    If you  are  developing  a  new  floor plan using the M - MAKE
  531. option  of  the  controller  program, you will be provided with a
  532. small  box called a REQUESTER. This is to be used to enter in the
  533. name  of  the plan. There should be a small greyish box (the text
  534. cursor)  inside  the  requester.  If  there is not, then move the
  535. mouse  so that the arrow on the screen points into the black area
  536. of  the  requester  and press the (left) button on the mouse. The
  537. text  cursor   should  appear.  (The  text  cursor will be in the
  538. wrong  place  when  a   requester  appears  on the screen, if the
  539. mouse  buttons get touched shortly before the requester is due to
  540. appear.  This  fact should be remembered as it is a fairly common
  541. thing  to  cause  happen in other parts of the controller program
  542. as  you  become  familiar with the program and become quicker off
  543. the mark.) 
  544.  
  545.  
  546.    Enter in  the  name  of the new plan and press the return key.
  547. If  you  have deliberately chosen the name of an existing plan, a
  548. requester  will  appear  at  the  top  of  the  screen to ask for
  549. confirmation.  Use the mouse to move the arrow to point to either
  550. the  OKAY  TO  DELETE or the CHOOSE NEW NAME option and press the
  551. left mouse button for the program to continue.  
  552.  
  553.  
  554.    If you  used  the  CHANGE  option from the CONTROLLER program,
  555. then  the  old  floor  plan will automatically be read in so that
  556. you can modify it.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.          Using the MAKER program to create floor plans.
  581.  
  582.  
  583.    A grid  of  grey lines will appear on the screen. This will be
  584. the  WORKING AREA where the floor plan is designed.  
  585.  
  586.    At the  right  of  the  screen, is a series of coloured boxes.
  587. These  performed  a  function  in  the original program and since
  588. they  looked  pretty,  I  left  them  in.  In  version  2 of this
  589. program,  these  will be used for selecting objects (happy faces,
  590. etc.) in an easier way than currently done.  
  591.  
  592.    On the  left  of the screen, a series of commands appear ( the
  593. MENU  ).  Move  the red CROSS on the screen to one of the options
  594. by  moving the mouse and press a mouse button. The command chosen
  595. should  become  highlighted  in   WHITE.  If you choose the wrong
  596. menu  item,  move the cross to another option and press the mouse
  597. key  twice:  the  first to unchoose the unwanted item, (highlight
  598. disappears), and the second time to choose the correct item.  
  599.  
  600.    The MENU options are 
  601.  
  602. QUIT  used  for  leaving  the  maker program and returning to the
  603. controller program.  
  604.  
  605. WRITE  PLAN  used  to  save  the  plan you have designed onto the
  606. patient disk.  
  607.  
  608. SHOW  TRUE  To  make  it  easier  to  use  the program, it is not
  609. necessary  to  place  items  such  as  happy  faces  and bulletin
  610. boards   EXACTLY  at  the  right  location  on a wall. You simply
  611. place  it  close  to  a wall. When the plan is saved, the program
  612. works  out  the nearest wall and moves the object to there. Since
  613. the  program  makes some decisions, the objects don't always move
  614. where  you  want  them.  Using the SHOW TRUE option allows you to
  615. find  out  what  the  computer  will  do.  If you don't like what
  616. happens,  use  the  CHANGE  command  to move an item to somewhere
  617. else.  
  618.  
  619. CHANGE  This option allows you to delete incorrect items added to
  620. the  floor  plan,  change  the  messages  printed on the bulletin
  621. board,  change  the operating options of the simulation. For more
  622. details   on   the  CHANGE  command  see  the  section  entitleed
  623. "Building a floor plan".  
  624.  
  625. START   Allows   the  initial  placement  and  direction  of  the
  626. wheelchair to be set in the floor plan.  
  627.  
  628. BULLETIN  Allows  the  placement of bulletin boards and messages.
  629. Details later.  
  630.  
  631. OBJECTS  Allows  the  placement  of  tables, cones, arrows, happy
  632. faces. Details later.  
  633.  
  634. DOORWAYS  Allows  the  placement  of  doorways  in walls. Details
  635. later.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645. WALLS  Allows the placement of walls in the floor plan. The walls
  646. are the fundamental unit of the plan. Details later.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.                       BUILDING A FLOOR PLAN
  709.  
  710.  
  711.    First select  the  WALL  option.  That  option  should  become
  712. HIGHLIGHTED.  Now  move the cross-hair using the mouse. Place the
  713. cross-hair  close  to one of the intersections of the GRID in the
  714. WORKING  SPACE  and  press  the  (LEFT)  mouse  button  ONCE  and
  715. RELEASE.  You  don't  have  to  get  very  fussy of "how close is
  716. close"  as  the  computer  will  choose  the nearest intersection
  717. automatically.  
  718.  
  719.  
  720.    Now move   the  mouse  in  either  a  horizontal  or  vertical
  721. direction.  A thin RED line will appear on the screen and move as
  722. you  move  the  mouse. This is the wall that will later be drawn.
  723. Move  the  mouse  UP,  DOWN,  LEFT and RIGHT until the wall suits
  724. your  fancy.  Then  press  the  mouse  button.  The RED line will
  725. disappear  and a YELLOW line will appear. This line does not move
  726. with the mouse and shows the final placement of the wall.  
  727.  
  728.    DELETING   a  wall  that  is in the wrong place can be done by
  729. the following stages 
  730.    Select the CHANGE option. A new MENU will appear.  
  731.    Select   the  DELETE  LAST  item  option  and  the  wall  will
  732.    disapper.  
  733.    Select the FINISHED option and the main menu will reappear.  
  734.  
  735. Now  add  any  more  walls  that  you  want. You can choose other
  736. options and then come back to add even further walls.  
  737.  
  738.  
  739.  
  740.    Adding  DOORWAYS   to  existing  walls  is  easy.  Choose  the
  741. DOORWAY  option  from the menu.  Choose the middle of an existing
  742. wall  with  the  cross-hair  and press the mouse button.  The red
  743. line  will  again  appear  and move with the mouse movement. This
  744. shows  the  location of the doorway. Make the doorway as large as
  745. you  require  and  press  the  mouse  button. A  PURPLE line will
  746. appear  in  the  wall.  This  represents  the  doorway.  For best
  747. effects  in  the 3D simulation, always place doorways into walls.
  748. You  can  get  some interesting features if the doorway is in the
  749. middle  of  no-where.  Add all the doorways you want. They can be
  750. removed  by using the change command in the same way as described
  751. for the walls.  
  752.  
  753.  
  754.    Adding OBJECTS  to  the  floor  plan  can  be  down  by  first
  755. selecting  the   OBJECT  menu  option. Now move the cross-hair to
  756. the  desired  location  on  the  working area and press the mouse
  757. button.  A  small white dot will appear on the screen marking the
  758. location  chosen.  At  the  bottom of the screen a requester will
  759. appear.  You  can  type  in  the name of object you want and then
  760. press  the  return  key.  The  object  will  then  appear  on the
  761. screen.  The objects available are: 
  762.  
  763.    ^  V  <  > which represent  UP, DOWN, LEFT, RIGHT ARROWS. Note
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.    that  UP  is a term relative to the screen at the moment. When
  773.    the  simulation  works,  an  UP arrow means an arrow that will
  774.    point  north  (towards  the  top  of  the  screen. Interesting
  775.    visual  effects can be acheived by putting an UP arrow near an
  776.    EAST-WEST  wall to provide additional reinforcement. Note that
  777.    these  objects should be placed CLOSE but not ON a wall if you
  778.    want  them  to  remain on the expected side of a wall when the
  779.    floor plan is saved to a disk.  
  780.  
  781.    T  C  represent  TABLES  and  CHAIRS  that  can  be  placed as
  782.    obstacles  or  as  objects  towards  which  the patient can be
  783.    directed.  These  remain where you put them and do not move to
  784.    the nearest when the plan is saved.  
  785.  
  786.    H  represents HAPPY FACES. Happy Faces appear on the wall WHEN
  787.    the  wheelchair  gets  close  to them and is facing them. They
  788.    appear  as  blank black areas on the wall until the wheelchair
  789.    comes  close.   (KNOWN  BUG:   Unpredicatable things happen if
  790.    two  happy faces are on the same wall. Happy Faces only appear
  791.    in  a  very short range of wheelchair positons relative to the
  792.    wall.) 
  793.  
  794. A  useful  reinforcer  is the  BULLETIN board. You are allowed up
  795. to  8  bulletin  boards  per  floor  plan.  This  is an artifical
  796. constraint  and  could  be changed. You enter a bulletin board by
  797. selecting  the  bulletin  menu option. Now move the cross-hair to
  798. the  desired location and press the button. A small dot marks the
  799. location.   A  requester will appear at the bottom of the screen.
  800. Type  in  the  desired message (maximum 25 letters aprroximately)
  801. and  press  the  return  key. The location of the bulletin boards
  802. are  indicated  by  the  symbols B1  through  B8. The messages in
  803. the  bulletin boards can be changed by selecting the CHANGE  menu
  804. option  and  then  the  bulletin  sub-option in the new menu that
  805. appears.  During  the simulation, the message only appears on the
  806. bulletin  boards when the wheelchair is close and in front of the
  807. bulletin board.. At other times, they appear as blank areas.  
  808.  
  809.  
  810.    The starting  location of the wheelchair can be chosen via the
  811. START  menu  option. Select the starting location required in the
  812. floor  plan  and  press the mouse button. A requester will appear
  813. asking  for  the starting direction  to be indicated. The options
  814. are  L  R  U  D which correspond to LEFT, RIGHT, UP and DOWN. The
  815. start  position  can  be changed by deleting the old position via
  816. the  CHANGE  command  and  selecting  a new position. If no start
  817. position  is  chosen,  then the program automatically selects the
  818. centre  of  the  floor plan facing North (up). If this happens to
  819. be a wall then so be it.  
  820.  
  821.  
  822.    The  CHANGE  menu  option  allows  the  deletion  of  unwanted
  823. items,  changing  of simulation options, bulletin board messages.
  824. Selecting  this  item  causes  a  new  menu  to  appear  with the
  825. following choices.  
  826.  
  827.    FINISHED  leaves  the  CHANGE  option  and returns to the main
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.    menu.  
  837.  
  838.    DELETE  LAST  ITEM  will  remove  the  last  item drawn on the
  839.    screen.  
  840.  
  841.    DELETE  ITEM  allows  the deletion of a specific item or group
  842.    of  items.  Once selected, move the cross-hair to a location a
  843.    little  to  the left and below the object to be deleted: press
  844.    the  mouse  button.  Now  move  the cross-hair to a location a
  845.    little  to  the  right and above the object to be deleted.  As
  846.    you  move  the  mouse,  a  small grey rectangle appears on the
  847.    screen.   When  you  press  the  mouse  button, all items that
  848.    start or end in the box will be deleted (never to return).  
  849.    WARNING:    If  you  try  to  delete  a  wall that is touching
  850.    another  wall,  it  is  difficult not to delete both walls. If
  851.    you  do  accidently  delete  an unwanted wall or two, then put
  852.    them back using the WALL command.  
  853.  
  854.    DELETE  ALL allows the deletion of everything in the plan. The
  855.    name  of the plan remains.  If you want to completely delete a
  856.    plan,  then the DELETE option in the CONTROLLER program allows
  857.    you to do this.  
  858.  
  859.    BULLETIN  allows  the changing of the messages in the bulletin
  860.    board.  On  selection  of  this item, a requester will appear.
  861.    Type  in the bulletin board number you want to change. Another
  862.    requester  will  appear showing the old message.  You can edit
  863.    the  message  by  using  the  arrow  keys  to the right of the
  864.    keyboard,  the  backspace  key  and  the normal keyboard keys.
  865.    Press  the return key when you have an acceptable message. The
  866.    arrow  keys  at  the  side of the keyboard allow you to before
  867.    some  editting  on the old message rather than simply deleting
  868.    it using the back space key.  
  869.  
  870.    OPTIONS  allows  the  changing  of  the  options  used  by the
  871.    simulator when it runs.  The options are 
  872.  
  873.       f F S                   (default S)     name FLASH 
  874.       turn  the  FLASH  off/on  or  replace  it  by  a  STOP sign
  875.       respectively.  The  flash  is  used  to  indicate  when the
  876.       wheelchair   runs   into   something.  The  lack  of   some
  877.       indication  that  the  wheelchair has run into something is
  878.       confusing.    However,   the  flash  can  be  an  undesired
  879.       reinforced.  
  880.  
  881.       F0 F1 through F8        (default F0)    name FONTS 
  882.       allowing  the  size  of  the  letters  used on the bulletin
  883.       board  to  be  changed.  (Only  font  0  is present on this
  884.       issue) 
  885.  
  886.       J1 J2 through J5        (default J1)    name JOYSTICK 
  887.       controls  the  momentum  of  the  wheelchair.  Without this
  888.       control,   the  wheelchair  does  not  stop  instantly  you
  889.       release   the  joystick.  Larger  numbers  means  that  the
  890.       joystick  must  be  held for a longer period of time before
  891.       any  action  occurs.  (At  time  of  writing,  this was not
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.       behaving in the manner expected.) 
  901.  
  902.       l L                     (default L)     name LINES 
  903.       places  LINES  off/on the floor of the simulator. This is a
  904.       very useful visual clue in the 3D simulation.  
  905.  
  906.       P1 P2 through P5        (default P1)    name PADS 
  907.       places  a  set  of WHEELCHAIR FOOT PADS on the front of the
  908.       screen  to allow visual positioning of the wheelchair. Only
  909.       P1  means anything as we can't decide on useful shapes (arm
  910.       rests or what have you.) 
  911.  
  912.       R1 R2 through R100      (default R11)   name ROTATION 
  913.       controls  the  rate  of  rotation  of the wheelchair.  This
  914.       should  be  about 7/10 of the value of the SPEED option for
  915.       reasonable looking 3D simulations.  
  916.  
  917.       S1 S2 through S100      (default S16)   name SPEED 
  918.       controls  the  speed  of  forward  motion of the wheelchair
  919.       during each frame of the animation.  
  920.  
  921.       T1 T2 through T100      (default T8)    name TIME 
  922.       controls  the  time  interval  (in  1/10 secs) at which the
  923.       screen  updates.   It  controls  the  animation rate of the
  924.       screen.  Making  the  SPEED  and TIME options both smaller,
  925.       means  that  the  movement  through  the floor plan will be
  926.       smoother.  However,  if  the floor plan is complicated with
  927.       many  walls  and objects, the time for each animation frame
  928.       may change, which is confusing for the patient.  
  929.  
  930.       Z0 Z1 through Z4        (default Z2)    name ZOOM 
  931.       controls  the zoom factor used to display the floor plan in
  932.       the  2D  simulation.  Value Z0 is only useful for providing
  933.       the  patient  with  an  indication  of  what the floor plan
  934.       looks like.  
  935.  
  936. NOTE:  If  this  program  is  run directly from the AMIGA command
  937. line rather than from the CONTROLLER program then the syntax is 
  938.  
  939.         maker  planname 
  940.  
  941. change an old floor plan or 
  942.  
  943.         maker 
  944.  
  945. to make a new floor plan.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.                  3D SIMULATION and 2D SIMULATION
  965.  
  966.  
  967.    These run  automatically  from  the  controller program.  When
  968. the  3D  version  is run, a blue screen will appear. Pressing the
  969. joystick   will   cause   the   simulation   to  start.  Joystick
  970. forward/back  movement  will  cause the scene to move relative to
  971. the  wheelchair.   Left  and  right  joystick movements cause the
  972. chair  to  rotate.  These actions follow what is to expected if a
  973. real  wheelchair  was  moving.  In  the  2D version, the joystick
  974. movement  causes the wheelchair to move on the screen in the same
  975. way that the joystick moves and not a real life movement.  
  976.  
  977.  
  978.    To exit  the  simulators, hold down on the joystick button for
  979. a  count  of  about   5  - 8 seconds and then release the button.
  980. Pull  back  on  the  joystick.  This  removes  the chances of the
  981. patient  accidently  hitting  the  button and causing an unwanted
  982. stop.  
  983.  
  984. KNOWN  BUG:  The  simulators can be stopped by hitting CTRL-C but
  985. this  will  not  allow  the  simulators to be run again until the
  986. computer  has  been powered down.  This might be fixed in a later
  987. release.  
  988.  
  989.  
  990.  
  991. NOTE:  If  this  program  is  run directly from the AMIGA command
  992. line rather than from the CONTROLLER program then the syntax is 
  993.  
  994.    wheelchair2d planname 
  995.  
  996. or 
  997.  
  998.    wheelchair3d planname 
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.                  ANALYSER (Does not yet exist.)
  1029.  
  1030.    This is   a  program  that  analyses  data  collected  by  the
  1031. simulation  programs   during  a  session  with  the  patient.  A
  1032. session  refers  to  the  time  spend  on  one  floor plan at one
  1033. sitting.  The  data  collected  includes floor plan name, session
  1034. date,  session  duration,  whether 2D or 3D simulator used, types
  1035. and  numbers  of obstacles encounterd. Indications of the quality
  1036. of  joystick  use  are  given by the number of times the joystick
  1037. was   released   or  the  patient  bumped  into  walls  or  other
  1038. obstacles.  The settings of the speed, rotation and other options
  1039. are recorder.  
  1040.  
  1041.    The commands  for  tunning  this program appear on the screen.
  1042. Type  the  first  letter of the command and press the return key.
  1043. The  command  will  become  highlighted. Once the correct command
  1044. haaaas  been  chosen, press the  return key again and the command
  1045. will be executed.  
  1046.  
  1047.    the available commands are 
  1048.  
  1049.    A - ANALYSE graphs? information from several sessions.  
  1050.  
  1051.    L - LIST provides a list of sessions according to date.  
  1052.  
  1053.    P  - PRINT provides a hardcopy printout of one of the sessions
  1054.    if a printer is connected to the computer.  
  1055.  
  1056.    S - SCREEN sends the data printout to the screen.  
  1057.  
  1058.  
  1059.    The format of the printout is as follows 
  1060.  
  1061.    1. Name of the patient.  
  1062.    2. Date of the session.  
  1063.    3. Duration of the session.  
  1064.    4. Floor plan name and whether 2D or 3D.  
  1065.    5. List and number of obstacles used.  
  1066.    6. Total number of obstacles.  
  1067.    7. Number of times patient bumped into walls.  
  1068.    8.  Number  of  times  patient  bumped  into  tables  or other
  1069.    obstacles.  
  1070.    9.  Number  of  times joystick was released (i.e. to determine
  1071.    the quality of joystick use.) 
  1072.    10.  Directions  patient  travelled  (i.e. the number of times
  1073.    patient moved forward, reverse, left and right) 
  1074.    11.  Settings  of  the  options  used  in the simulation (i.e.
  1075.    reinforcers, speed, rotation rates etc.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.