Correct image and activeImage documentation.

Also explain what is a RegionOfInterest. While
at that, solve a couple of javadoc warnings.

Change-Id: Ia07c04af5735b4e7adf778d0f32a844fb7a0336d