home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d968 / justlook.lha / JustLook / JustLook.ReadMe < prev    next >
Text File  |  1993-12-04  |  5KB  |  129 lines
  1.  
  2. Program name:  JustLook
  3.  
  4. What it does:  Generates input events to control mouse and keyboard
  5.  
  6. Author:        Kamran Karimi
  7.  
  8. Written with:  SAS/C 6.00
  9.  
  10. Source:        Included
  11.  
  12. Machine:       Amiga 1200
  13.  
  14. Program status:Read 'Is JustLook shareware?' below.
  15. -----------------------------------------------------------------------------
  16.  
  17. Directory contents:
  18.  
  19.  JustLook.o <-- the main file containing the routines
  20.  
  21.  Handlers.o <-- parts implemented in Assembly
  22.  
  23.  JustLook.doc <-- the file describing JustLook routines
  24.  
  25.  JustLook.ReadMe <-- the file you are reading now
  26.  
  27.  Source/JustLook.c <-- source of JustLook.o
  28.  
  29.  Source/JustLook.h <-- header used by JustLook.c and example programs
  30.  
  31.  Source/Handlers.asm <-- source of Handlers.o
  32.  
  33.  Examples <-- directory containing example programs and their sources
  34. -----------------------------------------------------------------------------
  35.  
  36.  JustLook, Questions and Answers
  37.  
  38.  
  39. Q. What is JustLook?
  40.  
  41. A. JustLook is for programmers who write Intuition compatible applications.
  42.  
  43.  Not all programs can be accompanied with video tapes to explain them.
  44. Here is where JustLook comes in!. Using JustLook, you can write programs
  45. to show the user how to use your applications. JustLook routines provide 
  46. control over mouse and keyboard and generate input events which are external
  47. to all programs in the system. So you can move the mouse, click it, and
  48. type letters, and the programs won't see any difference between these 
  49. events and the user actually generating them with the mouse and keyboard.
  50. This results in the fact that your program needs very little (if any) 
  51. modifications to work with JustLook. programs written with JustLook routines
  52. have a '.jl' extension.
  53. -----------------------------------------------------------------------------
  54.  
  55. Q. Is JustLook shareware?
  56.  
  57. A. Sort of, if used for PD programs, it is free. If accompanied by commercial
  58. or shareware applications, a donnation is appreciated.
  59. ----------------------------------------------------------------------------- 
  60.  
  61. Q. Are JustLook's files and their documents consistent?
  62.  
  63. A. Unfortunately no. I usually don't read a text twice and have the nasty 
  64. habit of writing the documentation long after the code is written and update
  65. it at long intervals. Also, you'll find lots of misspelled words. In this
  66. case, think of the word having the nearest pronunciation. I am sorry for
  67. this.
  68. ----------------------------------------------------------------------------- 
  69.  
  70. Q. How is JustLook implemented?
  71.  
  72. A. The code is not reentrant, with the main cause of the problem being IEWait().
  73. This should not be a serious problem, as keboard and mouse are hardly 
  74. sharable!. Anyway, in its current situation, JustLook can not be implemented
  75. as Amiga shared libraries.
  76.  The main routines are MoveMouse(), Click() and RawType(). Other routines
  77. use MoveMouse() and Click() extensively. You could do anything you want,
  78. using only these three routines.
  79. ----------------------------------------------------------------------------- 
  80.  
  81. Q. What conditions should the application have to use JustLook?
  82.  
  83. A. The first thing is that it should have a window with a name. This is the
  84. most important thing. Also, gadgets used in the program should have either
  85. unique names or UserID values. Menus don't have any particular problem.
  86. -----------------------------------------------------------------------------
  87.  
  88. Q. What you should note in programs you write with JustLook? 
  89.  
  90. A. You should have opened intuition.library before calling any of the JustLook
  91. routines. To call GoOverIcon(), you should have opened icon.library.
  92.  
  93.  As your program is linked with JustLook, you should take care not to use
  94. the following variable names in your programs:
  95.  
  96.     DisableIE
  97.     WaitIE
  98.     Global_HandlerName
  99.     Global_WaitName
  100.     NoMouse_Port
  101.     NoKey_Port
  102.     Global_IEPort
  103.     Global_IEHandler
  104.     Global_IEReq
  105.     Global_Me
  106.     Global_LeftMask
  107.     Global_MidMask
  108.     Global_RightMask
  109. -----------------------------------------------------------------------------
  110.  
  111. Q. How you can compile programs with JustLook?
  112.  
  113. A. assuming your program source is X.jl.c, use the following commands:
  114. 1> sc X.jl.c
  115. 1> slink lib:c.o X.jl.o JustLook.o Handlers.o lib lib:sc.lib lib:amiga.lib
  116. -----------------------------------------------------------------------------
  117.  
  118. Q. Where can you reach the author?
  119.  
  120. A. You can write to me at the following address:
  121.  
  122.     Kamran Karimi
  123.     2,HassanAbad
  124.     haghShenas str.
  125.     Navab str.
  126.     13599 - Tehran
  127.     Iran
  128. -----------------------------------------------------------------------------
  129.