added new methods for multiple images; added doxygen comments