full implementation of the opacity thing

now fully integrated in the example app. Works quite well. But the
example application, looks kinda messy now.  need to find a fix for that
soon. Added more Javadoc and fixed some warnings.