core/vil/vil_exception.h

Go to the documentation of this file.

#ifndef vil_exception_h_
#define vil_exception_h_
//:
// \file
// \brief Exceptions thrown by vil, and a mechanism for turning them off.
// \author Ian Scott.

#include <vcl_string.h>
#include <vcl_cstdlib.h>
#include <vcl_iostream.h>
#if VCL_HAS_EXCEPTIONS
# include <vcl_stdexcept.h>
#endif
#include <vil/vil_pixel_format.h>


//: Throw an exception indicating a definite problem.
// If exceptions have been disabled, this function
// will abort.
template <class T>
void vil_exception_error(T exception)
{
#if !defined VXL_LEGACY_ERROR_REPORTING && VCL_HAS_EXCEPTIONS
  throw exception;
#else
  vcl_cerr << "\nERROR: " << exception.what() << vcl_endl;
  vcl_abort();
#endif
}

//: Throw an exception indicating a potential problem.
// If exceptions have been disabled, this function
// will return.
template <class T>
void vil_exception_warning(T exception)
{
#if !defined VXL_LEGACY_ERROR_REPORTING && VCL_HAS_EXCEPTIONS
  throw exception;
#else
  vcl_cerr << "\nWARNING: " << exception.what() << vcl_endl;
#endif
}

  //: Indicates that a function call failed because the pixel types were incompatible.
  class vil_exception_pixel_formats_incompatible
#if VCL_HAS_EXCEPTIONS
  : public vcl_logic_error
#endif
  {
   public:
    enum vil_pixel_format src_type, dest_type;
    vcl_string operation_name;
    vil_exception_pixel_formats_incompatible(
      enum vil_pixel_format src, enum vil_pixel_format dest, const vcl_string& operation) :
#if VCL_HAS_EXCEPTIONS
    vcl_logic_error(operation + ": Pixel formats incompatible."),
#endif
      src_type(src), dest_type(dest), operation_name(operation) {}
#if VCL_HAS_EXCEPTIONS
    virtual ~vil_exception_pixel_formats_incompatible() throw() {}
#else
    const char * what() const {return "Pixel formats incompatible.";}
#endif
  };


  //: Indicates that a function call failed because a pixel format could not be handled.
  class vil_exception_unsupported_pixel_format
#if VCL_HAS_EXCEPTIONS
  : public vcl_logic_error
#endif
  {
   public:
    enum vil_pixel_format src_type;
    vcl_string operation_name;
    vil_exception_unsupported_pixel_format(
      enum vil_pixel_format src, const vcl_string& operation) :
#if VCL_HAS_EXCEPTIONS
    vcl_logic_error(operation + ": Unsupported pixel format."),
#endif
      src_type(src), operation_name(operation) {}
#if VCL_HAS_EXCEPTIONS
    virtual ~vil_exception_unsupported_pixel_format() throw() {}
#else
    const char * what() const {return "Unsupported Pixel formats.";}
#endif
  };


  //: Indicates that some reference was made to pixels beyond the bounds of an image.
  // In most cases of out-of-bounds access, you will not get this exception. For efficiency
  // reasons, vil may not test for this problem, or may if you are lucky trip an assert.
  // This function is only used in cases where easy of use, and risk of mistakes are high,
  // and inefficiency is very low.
  class vil_exception_out_of_bounds
#if VCL_HAS_EXCEPTIONS
  : public vcl_logic_error
#endif
  {
   public:
    vcl_string operation_name;
    vil_exception_out_of_bounds(
      const vcl_string& operation) :
#if VCL_HAS_EXCEPTIONS
    vcl_logic_error(operation + ": Pixel access out-of-bounds."),
#endif
      operation_name(operation) {}
#if VCL_HAS_EXCEPTIONS
    virtual ~vil_exception_out_of_bounds() throw() {}
#else
    const char * what() const {return "Pixel access out-of-bounds.";}
#endif
  };



  //: Indicates that some operation is not supported.
  // In most cases you will not get this exception. For efficiency
  // reasons, vil may not test for this problem, or may if you are lucky trip an assert.
  // This function is only used in cases where easy of use, and risk of mistakes are high,
  // and inefficiency is very low.
  class vil_exception_unsupported_operation
#if VCL_HAS_EXCEPTIONS
  : public vcl_logic_error
#endif
  {
   public:
    vcl_string operation_name;
    vil_exception_unsupported_operation(
      const vcl_string& operation) :
#if VCL_HAS_EXCEPTIONS
    vcl_logic_error(operation + ": Unsupported operation."),
#endif
      operation_name(operation) {}
#if VCL_HAS_EXCEPTIONS
    virtual ~vil_exception_unsupported_operation() throw() {}
#else
    const char * what() const {return "Unsupported operation.";}
#endif
  };


  //: Indicates that an image load or save operation failed.
  // Generally this should be thrown, only after checks on the image type
  // have been passed by the file format object, and while an
  // unrecoverable error is detected inside the image_resource constructor,
  // or similar.
  class vil_exception_image_io
#if VCL_HAS_EXCEPTIONS
  : public vcl_runtime_error
#endif
  {
   public:
#if !VCL_HAS_EXCEPTIONS
    vcl_string full_what;
#endif
    vcl_string function_name, file_type, filename;
    vil_exception_image_io(const vcl_string& function,
                           const vcl_string& type,
                           const vcl_string& name) :
#if VCL_HAS_EXCEPTIONS
      vcl_runtime_error
#else
      full_what
#endif
      ("Unrecoverable failure in " + function + " while loading "
       + name + " using " + type + " loader."),
      function_name(function), file_type(type), filename(name) {}
#if VCL_HAS_EXCEPTIONS
    virtual ~vil_exception_image_io() throw() {}
#else
    const char * what() const { return full_what.c_str(); }
#endif
  };





#endif // vil_exception_h_

---