//
|
// 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_AND_CONVERT_IMAGE_HPP
|
#define BOOST_GIL_IO_READ_AND_CONVERT_IMAGE_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/gil/detail/mp11.hpp>
|
|
#include <type_traits>
|
|
namespace boost{ namespace gil {
|
|
/// \ingroup IO
|
|
/// \brief Reads and color-converts an image. Image memory is allocated.
|
/// \param reader An image reader.
|
/// \param img The image in which the data is read into.
|
/// \param settings Specifies read settings depending on the image format.
|
/// \param cc Color converter function object.
|
/// \throw std::ios_base::failure
|
template <typename Reader, typename Image>
|
inline
|
void read_and_convert_image(Reader& reader, Image& img,
|
typename std::enable_if
|
<
|
mp11::mp_and
|
<
|
detail::is_reader<Reader>,
|
is_format_tag<typename Reader::format_tag_t>
|
>::value
|
>::type* /*dummy*/ = nullptr)
|
{
|
reader.init_image(img, reader._settings);
|
reader.apply(view(img));
|
}
|
|
/// \brief Reads and color-converts an image. Image memory is allocated.
|
/// \param device Must satisfy is_input_device metafunction.
|
/// \param img The image in which the data is read into.
|
/// \param settings Specifies read settings depending on the image format.
|
/// \param cc Color converter function object.
|
/// \throw std::ios_base::failure
|
template <typename Device, typename Image, typename ColorConverter, typename FormatTag>
|
inline
|
void read_and_convert_image(
|
Device& device,
|
Image& img,
|
image_read_settings<FormatTag> const& settings,
|
ColorConverter const& cc,
|
typename std::enable_if
|
<
|
mp11::mp_and
|
<
|
detail::is_read_device<FormatTag, Device>,
|
is_format_tag<FormatTag>
|
>::value
|
>::type* /*dummy*/ = nullptr)
|
{
|
using read_and_convert_t = detail::read_and_convert<ColorConverter>;
|
using reader_t = typename get_reader<Device, FormatTag, read_and_convert_t>::type;
|
|
reader_t reader = make_reader(device, settings, read_and_convert_t{cc});
|
read_and_convert_image(reader, img);
|
}
|
|
/// \brief Reads and color-converts an image. 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.
|
/// \param settings Specifies read settings depending on the image format.
|
/// \param cc Color converter function object.
|
/// \throw std::ios_base::failure
|
template <typename String, typename Image, typename ColorConverter, typename FormatTag>
|
inline
|
void read_and_convert_image(
|
String const& file_name,
|
Image& img,
|
image_read_settings<FormatTag> const& settings,
|
ColorConverter const& cc,
|
typename std::enable_if
|
<
|
mp11::mp_and
|
<
|
is_format_tag<FormatTag>,
|
detail::is_supported_path_spec<String>
|
>::value
|
>::type* /*dummy*/ = nullptr)
|
{
|
using read_and_convert_t = detail::read_and_convert<ColorConverter>;
|
using reader_t = typename get_reader<String, FormatTag, read_and_convert_t>::type;
|
|
reader_t reader = make_reader(file_name, settings, read_and_convert_t{cc});
|
read_and_convert_image(reader, img);
|
}
|
|
/// \brief Reads and color-converts an image. 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.
|
/// \param cc Color converter function object.
|
/// \param tag Defines the image format. Must satisfy is_format_tag metafunction.
|
/// \throw std::ios_base::failure
|
template <typename String, typename Image, typename ColorConverter, typename FormatTag>
|
inline
|
void read_and_convert_image(
|
String const& file_name,
|
Image& img,
|
ColorConverter const& cc,
|
FormatTag const& tag,
|
typename std::enable_if
|
<
|
mp11::mp_and
|
<
|
is_format_tag<FormatTag>,
|
detail::is_supported_path_spec<String>
|
>::value
|
>::type* /*dummy*/ = nullptr)
|
{
|
using read_and_convert_t = detail::read_and_convert<ColorConverter>;
|
using reader_t = typename get_reader<String, FormatTag, read_and_convert_t>::type;
|
|
reader_t reader = make_reader(file_name, tag, read_and_convert_t{cc});
|
read_and_convert_image(reader, img);
|
}
|
|
/// \brief Reads and color-converts an image. Image memory is allocated.
|
/// \param device Must satisfy is_input_device metafunction or is_adaptable_input_device.
|
/// \param img The image in which the data is read into.
|
/// \param cc Color converter function object.
|
/// \param tag Defines the image format. Must satisfy is_format_tag metafunction.
|
/// \throw std::ios_base::failure
|
template <typename Device, typename Image, typename ColorConverter, typename FormatTag>
|
inline
|
void read_and_convert_image(
|
Device& device,
|
Image& img,
|
ColorConverter const& cc,
|
FormatTag const& tag,
|
typename std::enable_if
|
<
|
mp11::mp_and
|
<
|
detail::is_read_device<FormatTag, Device>,
|
is_format_tag<FormatTag>
|
>::value
|
>::type* /*dummy*/ = nullptr)
|
{
|
using read_and_convert_t = detail::read_and_convert<ColorConverter>;
|
using reader_t = typename get_reader<Device, FormatTag, read_and_convert_t>::type;
|
|
reader_t reader = make_reader(device, tag, read_and_convert_t{cc});
|
read_and_convert_image(reader, img);
|
}
|
|
/// \brief Reads and color-converts an image. Image memory is allocated. Default color converter is used.
|
/// \param file_name File name. Must satisfy is_supported_path_spec metafunction.
|
/// \param img The image in which the data is read into.
|
/// \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_and_convert_image(
|
String const& file_name,
|
Image& img,
|
image_read_settings<FormatTag> const& settings,
|
typename std::enable_if
|
<
|
mp11::mp_and
|
<
|
is_format_tag<FormatTag>,
|
detail::is_supported_path_spec<String>
|
>::value
|
>::type* /*dummy*/ = nullptr)
|
{
|
using read_and_convert_t = detail::read_and_convert<default_color_converter>;
|
using reader_t = typename get_reader<String, FormatTag, read_and_convert_t>::type;
|
|
reader_t reader = make_reader(file_name, settings, read_and_convert_t{});
|
read_and_convert_image(reader, img);
|
}
|
|
/// \brief Reads and color-converts an image. Image memory is allocated. Default color converter is used.
|
/// \param device It's a device. Must satisfy is_input_device metafunction or is_adaptable_input_device.
|
/// \param img The image in which the data is read into.
|
/// \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_and_convert_image(
|
Device& device,
|
Image& img,
|
image_read_settings<FormatTag> const& settings,
|
typename std::enable_if
|
<
|
mp11::mp_and
|
<
|
detail::is_read_device<FormatTag, Device>,
|
is_format_tag<FormatTag>
|
>::value
|
>::type* /*dummy*/ = nullptr)
|
{
|
using read_and_convert_t = detail::read_and_convert<default_color_converter>;
|
using reader_t = typename get_reader<Device, FormatTag, read_and_convert_t>::type;
|
|
reader_t reader = make_reader(device, settings, read_and_convert_t{});
|
read_and_convert_image(reader, img);
|
}
|
|
/// \brief Reads and color-converts an image. Image memory is allocated. Default color converter is used.
|
/// \param file_name File name. Must satisfy is_supported_path_spec metafunction.
|
/// \param img The image in which the data is read into.
|
/// \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_and_convert_image(
|
String const& file_name,
|
Image& img,
|
FormatTag const& tag,
|
typename std::enable_if
|
<
|
mp11::mp_and
|
<
|
is_format_tag<FormatTag>,
|
detail::is_supported_path_spec<String>
|
>::value
|
>::type* /*dummy*/ = nullptr)
|
{
|
using read_and_convert_t = detail::read_and_convert<default_color_converter>;
|
using reader_t = typename get_reader<String, FormatTag, read_and_convert_t>::type;
|
|
reader_t reader = make_reader(file_name, tag, read_and_convert_t{});
|
read_and_convert_image(reader, img);
|
}
|
|
/// \brief Reads and color-converts an image. Image memory is allocated. Default color converter is used.
|
/// \param file_name File name. Must satisfy is_supported_path_spec metafunction.
|
/// \param img The image in which the data is read into.
|
/// \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_and_convert_image(
|
Device& device,
|
Image& img,
|
FormatTag const& tag,
|
typename std::enable_if
|
<
|
mp11::mp_and
|
<
|
detail::is_read_device<FormatTag, Device>,
|
is_format_tag<FormatTag>
|
>::value
|
>::type* /*dummy*/ = nullptr)
|
{
|
using read_and_convert_t = detail::read_and_convert<default_color_converter>;
|
using reader_t = typename get_reader<Device, FormatTag, read_and_convert_t>::type;
|
|
reader_t reader = make_reader(device, tag, read_and_convert_t{});
|
read_and_convert_image(reader, img);
|
}
|
|
}} // namespace boost::gil
|
|
#endif
|
