Q: What does onHandle
do?
A: It tells you if the mouse pointer is on a particular handle.
I've updated the documentation as follows:
// Inputs:
// x,y - mouse coordinates (they are passed in to handleMouseAction
// or handleMouseMotion
// hx,hy - coordinates of the CENTRE of the handle.
//
// Returns:
// true - the mouse x,y lies within the square centred on
// the handle's hx,hy (ie, if the mouse is on the handle).
//
// NOTE:
// You will have to call this function nine (9) times, to
// identify which handle the user clicked on.