Rename objects and fix comments and javadoc

Prepare object names for later addition of similar
split per channel calculations to Manders' split coeff.s

Fix up javadoc for @param tags etc.

Fix up comments describing objects so its more
easier to understand for a new pair of eyes.

Signed-off-by: daniel j. white <dan@chalkie.org.uk>