Returns the current raster image object. The method fills a passed raster image object and returns it to the calling subroutine.