new option to specify how failures to handle images should be handled, completes #6