// Copyright (C) 2011  Davis E. King (davis@dlib.net), Nils Labugt
// License: Boost Software License   See LICENSE.txt for the full license.
#undef DLIB_LOAd_IMAGE_ABSTRACT_
#ifdef DLIB_LOAd_IMAGE_ABSTRACT_

#include "../image_processing/generic_image.h"

namespace dlib
{
    template <typename image_type>
    void load_image (
        image_type& image,
        const std::string& file_name
    );
    /*!
        requires
            - image_type == an image object that implements the interface defined in
              dlib/image_processing/generic_image.h 
        ensures
            - This function loads an image from disk, in the indicated file file_name, and
              writes it to the indicated image object.
            - It is capable of reading the PNG, JPEG, BMP, GIF, and DNG image formats.  It
              is always capable of reading BMP and DNG images.  However, for PNG, JPEG, and
              GIF you must #define DLIB_PNG_SUPPORT, DLIB_JPEG_SUPPORT, and
              DLIB_GIF_SUPPORT respectively and link your program to libpng, libjpeg, and
              libgif respectively.
        throws
            - image_load_error
                This exception is thrown if there is some error that prevents
                us from loading the given image file.
    !*/

}

#endif // DLIB_LOAd_IMAGE_ABSTRACT_