boost/gil/io/read_image.hpp
// // Copyright 2007-2012 Christian Henning, Andreas Pokorny, Lubomir Bourdev // // Distributed under the Boost Software License, Version 1.0 // See accompanying file LICENSE_1_0.txt or copy at // http://www.boost.org/LICENSE_1_0.txt // #ifndef BOOST_GIL_IO_READ_IMAGE_HPP #define BOOST_GIL_IO_READ_IMAGE_HPP #include <boost/gil/extension/toolbox/dynamic_images.hpp> #include <boost/gil/io/base.hpp> #include <boost/gil/io/conversion_policies.hpp> #include <boost/gil/io/device.hpp> #include <boost/gil/io/get_reader.hpp> #include <boost/gil/io/path_spec.hpp> #include <boost/mpl/and.hpp> #include <boost/type_traits/is_base_and_derived.hpp> #include <boost/utility/enable_if.hpp> namespace boost{ namespace gil { /// \ingroup IO /// \brief Reads an image without conversion. Image memory is allocated. /// \param reader An image reader. /// \param img The image in which the data is read into. Must satisfy is_read_supported metafunction. /// \throw std::ios_base::failure template < typename Reader , typename Image > inline void read_image( Reader reader , Image& img , typename enable_if< mpl::and_< detail::is_reader< Reader > , is_format_tag< typename Reader::format_tag_t > , is_read_supported< typename get_pixel_type< typename Image::view_t >::type , typename Reader::format_tag_t > > >::type* /* ptr */ = 0 ) { reader.init_image( img , reader._settings ); reader.apply( view( img )); } /// \brief Reads an image without conversion. Image memory is allocated. /// \param file It's a device. Must satisfy is_input_device metafunction. /// \param img The image in which the data is read into. Must satisfy is_read_supported metafunction. /// \param settings Specifies read settings depending on the image format. /// \throw std::ios_base::failure template < typename Device , typename Image , typename FormatTag > inline void read_image( Device& file , Image& img , const image_read_settings< FormatTag >& settings , typename enable_if< mpl::and_< detail::is_read_device< FormatTag , Device > , is_format_tag< FormatTag > , is_read_supported< typename get_pixel_type< typename Image::view_t >::type , FormatTag > > >::type* /* ptr */ = 0 ) { typedef typename get_reader< Device , FormatTag , detail::read_and_no_convert >::type reader_t; reader_t reader = make_reader( file , settings , detail::read_and_no_convert() ); read_image( reader , img ); } /// \brief Reads an image without conversion. Image memory is allocated. /// \param file It's a device. Must satisfy is_input_device metafunction. /// \param img The image in which the data is read into. Must satisfy is_read_supported metafunction. /// \param tag Defines the image format. Must satisfy is_format_tag metafunction. /// \throw std::ios_base::failure template < typename Device , typename Image , typename FormatTag > inline void read_image( Device& file , Image& img , const FormatTag& tag , typename enable_if< mpl::and_< detail::is_read_device< FormatTag , Device > , is_format_tag< FormatTag > , is_read_supported< typename get_pixel_type< typename Image::view_t >::type , FormatTag > > >::type* /* ptr */ = 0 ) { typedef typename get_reader< Device , FormatTag , detail::read_and_no_convert >::type reader_t; reader_t reader = make_reader( file , tag , detail::read_and_no_convert() ); read_image( reader , img ); } /// \brief Reads an image without conversion. Image memory is allocated. /// \param file_name File name. Must satisfy is_supported_path_spec metafunction. /// \param img The image in which the data is read into. Must satisfy is_read_supported metafunction. /// \param settings Specifies read settings depending on the image format. /// \throw std::ios_base::failure template < typename String , typename Image , typename FormatTag > inline void read_image( const String& file_name , Image& img , const image_read_settings< FormatTag >& settings , typename enable_if< mpl::and_< detail::is_supported_path_spec< String > , is_format_tag< FormatTag > , is_read_supported< typename get_pixel_type< typename Image::view_t >::type , FormatTag > > >::type* /* ptr */ = 0 ) { typedef typename get_reader< String , FormatTag , detail::read_and_no_convert >::type reader_t; reader_t reader = make_reader( file_name , settings , detail::read_and_no_convert() ); read_image( reader , img ); } /// \brief Reads an image without conversion. Image memory is allocated. /// \param file_name File name. Must satisfy is_supported_path_spec metafunction. /// \param img The image in which the data is read into. Must satisfy is_read_supported metafunction. /// \param tag Defines the image format. Must satisfy is_format_tag metafunction. /// \throw std::ios_base::failure template < typename String , typename Image , typename FormatTag > inline void read_image( const String& file_name , Image& img , const FormatTag& tag , typename enable_if< mpl::and_< detail::is_supported_path_spec< String > , is_format_tag< FormatTag > , is_read_supported< typename get_pixel_type< typename Image::view_t >::type , FormatTag > > >::type* /* ptr */ = 0 ) { typedef typename get_reader< String , FormatTag , detail::read_and_no_convert >::type reader_t; reader_t reader = make_reader( file_name , tag , detail::read_and_no_convert() ); read_image( reader , img ); } /// template < typename Reader , typename Images > inline void read_image( Reader& reader , any_image< Images >& images , typename enable_if< mpl::and_< detail::is_dynamic_image_reader< Reader > , is_format_tag< typename Reader::format_tag_t > > >::type* /* ptr */ = 0 ) { reader.apply( images ); } /// \brief Reads an image without conversion. Image memory is allocated. /// \param file It's a device. Must satisfy is_adaptable_input_device metafunction. /// \param images Dynamic image ( mpl::vector ). See boost::gil::dynamic_image extension. /// \param settings Specifies read settings depending on the image format. /// \throw std::ios_base::failure template < typename Device , typename Images , typename FormatTag > inline void read_image( Device& file , any_image< Images >& images , const image_read_settings< FormatTag >& settings , typename enable_if< mpl::and_< detail::is_read_device< FormatTag , Device > , is_format_tag< FormatTag > > >::type* /* ptr */ = 0 ) { typedef typename get_dynamic_image_reader< Device , FormatTag >::type reader_t; reader_t reader = make_dynamic_image_reader( file , settings ); read_image( reader , images ); } /// \brief Reads an image without conversion. Image memory is allocated. /// \param file It's a device. Must satisfy is_adaptable_input_device metafunction. /// \param images Dynamic image ( mpl::vector ). See boost::gil::dynamic_image extension. /// \param tag Defines the image format. Must satisfy is_format_tag metafunction. /// \throw std::ios_base::failure template < typename Device , typename Images , typename FormatTag > inline void read_image( Device& file , any_image< Images >& images , const FormatTag& tag , typename enable_if< mpl::and_< detail::is_read_device< FormatTag , Device > , is_format_tag< FormatTag > > >::type* /* ptr */ = 0 ) { typedef typename get_dynamic_image_reader< Device , FormatTag >::type reader_t; reader_t reader = make_dynamic_image_reader( file , tag ); read_image( reader , images ); } /// \brief Reads an image without conversion. Image memory is allocated. /// \param file_name File name. Must satisfy is_supported_path_spec metafunction. /// \param images Dynamic image ( mpl::vector ). See boost::gil::dynamic_image extension. /// \param settings Specifies read settings depending on the image format. /// \throw std::ios_base::failure template < typename String , typename Images , typename FormatTag > inline void read_image( const String& file_name , any_image< Images >& images , const image_read_settings< FormatTag >& settings , typename enable_if< mpl::and_< detail::is_supported_path_spec< String > , is_format_tag< FormatTag > > >::type* /* ptr */ = 0 ) { typedef typename get_dynamic_image_reader< String , FormatTag >::type reader_t; reader_t reader = make_dynamic_image_reader( file_name , settings ); read_image( reader , images ); } /// \brief Reads an image without conversion. Image memory is allocated. /// \param file_name File name. Must satisfy is_supported_path_spec metafunction. /// \param images Dynamic image ( mpl::vector ). See boost::gil::dynamic_image extension. /// \param tag Defines the image format. Must satisfy is_format_tag metafunction. /// \throw std::ios_base::failure template < typename String , typename Images , typename FormatTag > inline void read_image( const String& file_name , any_image< Images >& images , const FormatTag& tag , typename enable_if< mpl::and_< detail::is_supported_path_spec< String > , is_format_tag< FormatTag > > >::type* /* ptr */ = 0 ) { typedef typename get_dynamic_image_reader< String , FormatTag >::type reader_t; reader_t reader = make_dynamic_image_reader( file_name, tag ); read_image( reader , images ); } } // namespace gil } // namespace boost #endif