update javadoc, harmonize API, and remove toImage and toPicture methods
that do not take an input.