image.h

Go to the documentation of this file.

#pragma once
 
#include <liboscar/concepts/named_input_stream.h>
#include <liboscar/formats/image_loading_flags.h>
#include <liboscar/graphics/color_space.h>
#include <liboscar/graphics/texture2d.h>
 
#include <iosfwd>
#include <utility>
 
namespace osc
{
    class Image final {
    public:
        // Read the given (named) image stream into a `Texture2D`.
        //
        // Throws if the image data isn't representable as a GPU texture (e.g. because it has
        // an incorrect number of components).
        static Texture2D read_into_texture(
            std::istream&,
            std::string_view input_name,
            ColorSpace,
            ImageLoadingFlags = {}
        );
 
        template<NamedInputStream Stream>
        static Texture2D read_into_texture(
            Stream&& stream,
            ColorSpace color_space,
            ImageLoadingFlags flags = {})
        {
            return read_into_texture(
                std::forward<Stream>(stream),
                stream.name(),
                color_space,
                flags
            );
        }
    };
 
    class PNG final {
    public:
        static void write(std::ostream&, const Texture2D&);
    };
 
    class JPEG final {
    public:
        static void write(std::ostream&, const Texture2D&, float quality = 0.9f);
    };
}