Program name:  JustLook

What it does:  Generates input events to control mouse and keyboard

Author:        Kamran Karimi
 
Written with:  SAS/C 6.00

Source:        Included

Machine:       Amiga 1200

Program status:Read 'Is JustLook shareware?' below.
-----------------------------------------------------------------------------
 
Directory contents:

 JustLook.o <-- the main file containing the routines
 
 Handlers.o <-- parts implemented in Assembly

 JustLook.doc <-- the file describing JustLook routines

 JustLook.ReadMe <-- the file you are reading now

 Source/JustLook.c <-- source of JustLook.o
 
 Source/JustLook.h <-- header used by JustLook.c and example programs

 Source/Handlers.asm <-- source of Handlers.o

 Examples <-- directory containing example programs and their sources
-----------------------------------------------------------------------------

 JustLook, Questions and Answers


Q. What is JustLook?

A. JustLook is for programmers who write Intuition compatible applications.

 Not all programs can be accompanied with video tapes to explain them.
Here is where JustLook comes in!. Using JustLook, you can write programs
to show the user how to use your applications. JustLook routines provide 
control over mouse and keyboard and generate input events which are external
to all programs in the system. So you can move the mouse, click it, and
type letters, and the programs won't see any difference between these 
events and the user actually generating them with the mouse and keyboard.
This results in the fact that your program needs very little (if any) 
modifications to work with JustLook. programs written with JustLook routines
have a '.jl' extension.
-----------------------------------------------------------------------------

Q. Is JustLook shareware?

A. Sort of, if used for PD programs, it is free. If accompanied by commercial
or shareware applications, a donnation is appreciated.
----------------------------------------------------------------------------- 

Q. Are JustLook's files and their documents consistent?

A. Unfortunately no. I usually don't read a text twice and have the nasty 
habit of writing the documentation long after the code is written and update
it at long intervals. Also, you'll find lots of misspelled words. In this
case, think of the word having the nearest pronunciation. I am sorry for
this.
----------------------------------------------------------------------------- 

Q. How is JustLook implemented?

A. The code is not reentrant, with the main cause of the problem being IEWait().
This should not be a serious problem, as keboard and mouse are hardly 
sharable!. Anyway, in its current situation, JustLook can not be implemented
as Amiga shared libraries.
 The main routines are MoveMouse(), Click() and RawType(). Other routines
use MoveMouse() and Click() extensively. You could do anything you want,
using only these three routines.
----------------------------------------------------------------------------- 

Q. What conditions should the application have to use JustLook?

A. The first thing is that it should have a window with a name. This is the
most important thing. Also, gadgets used in the program should have either
unique names or UserID values. Menus don't have any particular problem.
-----------------------------------------------------------------------------

Q. What you should note in programs you write with JustLook? 

A. You should have opened intuition.library before calling any of the JustLook
routines. To call GoOverIcon(), you should have opened icon.library.

 As your program is linked with JustLook, you should take care not to use
the following variable names in your programs:

	DisableIE
	WaitIE
	Global_HandlerName
	Global_WaitName
	NoMouse_Port
	NoKey_Port
	Global_IEPort
	Global_IEHandler
	Global_IEReq
	Global_Me
	Global_LeftMask
	Global_MidMask
	Global_RightMask
-----------------------------------------------------------------------------

Q. How you can compile programs with JustLook?

A. assuming your program source is X.jl.c, use the following commands:
1> sc X.jl.c
1> slink lib:c.o X.jl.o JustLook.o Handlers.o lib lib:sc.lib lib:amiga.lib
-----------------------------------------------------------------------------

Q. Where can you reach the author?

A. You can write to me at the following address:
 
	Kamran Karimi
	2,HassanAbad
	haghShenas str.
	Navab str.
	13599 - Tehran
	Iran
-----------------------------------------------------------------------------