more javadoc and added getPointMatrix