final version including fix for sphere reflection "warping"
also including documentation