/// @brief Include to sample 2d textures. /// @file gli/sampler2d.hpp #pragma once #include "sampler.hpp" #include "texture2d.hpp" #include "mipmaps_compute.hpp" #include "convert_func.hpp" #include "clear.hpp" namespace gli { /// 2d texture sampler /// @tparam T Sampler can fetch, write and interpret any texture format but will expose and process the data through type T conversions. /// @tparam P Precision in term of ULPs template class sampler2d : public sampler { private: typedef typename detail::interpolate::type interpolate_type; public: typedef texture2d texture_type; typedef typename texture_type::size_type size_type; typedef typename texture_type::extent_type extent_type; typedef interpolate_type level_type; typedef vec<2, interpolate_type, P> normalized_type; typedef vec<4, T, P> texel_type; sampler2d(texture_type const& Texture, wrap Wrap, filter Mip = FILTER_NEAREST, filter Min = FILTER_NEAREST, texel_type const& BorderColor = texel_type(0, 0, 0, 1)); ~sampler2d() { } void set_border_color(texel_type BorderColor) { this->BorderColor = BorderColor; } /// Access the sampler texture object texture_type const& operator()() const; /// Fetch a texel from the sampler texture texel_type texel_fetch(extent_type const& TexelCoord, size_type const& Level) const; /// Write a texel in the sampler texture void texel_write(extent_type const& TexelCoord, size_type const& Level, texel_type const& Texel); /// Clear the sampler texture with a uniform texel void clear(texel_type const& Texel); /// Sample a texture at a specific level texel_type texture_lod(normalized_type const& SampleCoord, level_type Level) const; /// Sample a texture using specified gradiants texel_type texture_grad(normalized_type const& SampleCoord, normalized_type const& dPdx, normalized_type const& dPdy) const; /// Generate all the mipmaps of the sampler texture from the texture base level void generate_mipmaps(filter Minification); /// Generate the mipmaps of the sampler texture from the texture base level to the texture max level included void generate_mipmaps(size_type BaseLevel, size_type MaxLevel, filter Minification); private: typedef typename detail::convert::func convert_type; typedef typename detail::convert::fetchFunc fetch_type; typedef typename detail::convert::writeFunc write_type; typedef typename detail::filterBase::filterFunc filter_type; texture_type Texture; convert_type Convert; texel_type BorderColor; filter_type Filter; }; typedef sampler2d fsampler2D; typedef sampler2d dsampler2D; typedef sampler2d usampler2D; typedef sampler2d isampler2D; }//namespace gli extern "C" { namespace bindings { namespace FSampler2D { #ifndef _WIN32 gli::fsampler2D fsampler2d_new(const gli::texture2d & Texture, gli::wrap Wrap, gli::filter Mip, gli::filter Min) { return gli::fsampler2D(Texture, Wrap, Mip, Min); } #endif void fsampler2d_set_border_color(gli::fsampler2D & Sampler, TexelType4F BorderColor) { Sampler.set_border_color(gli::tex4FToVec4(BorderColor)); } void fsampler2d_clear(gli::fsampler2D & Sampler, TexelType4F Texel) { Sampler.clear(gli::tex4FToVec4(Texel)); } TexelType4F fsampler2d_texel_fetch(const gli::fsampler2D & Sampler, const gli::fsampler2D::extent_type & TexelCoord, gli::texture::size_type Level) { gli::vec4 raw = Sampler.texel_fetch(TexelCoord, Level); return vec4ToTex4F(raw); } void fsampler2d_texel_write(gli::fsampler2D & Sampler, const gli::fsampler2D::extent_type & TexelCoord, gli::texture::size_type Level, TexelType4F Texel) { return Sampler.texel_write(TexelCoord, Level, gli::tex4FToVec4(Texel)); } TexelType4F fsampler2d_texel_lod(const gli::fsampler2D & Sampler, const float SampleCoord[2], float Level) { gli::vec4 raw = Sampler.texture_lod(gli::fsampler2D::normalized_type(SampleCoord[0], SampleCoord[1]), Level); return vec4ToTex4F(raw); } const gli::texture2d & fsampler2d_target_texture(const gli::fsampler2D & Sampler) { return Sampler.operator()(); } void fsampler2d_generate_mipmaps1(gli::fsampler2D & Sampler, gli::filter Minification) { Sampler.generate_mipmaps(Minification); } void fsampler2d_generate_mipmaps2(gli::fsampler2D & Sampler, gli::texture::size_type BaseLevel, gli::texture::size_type MaxLevel, gli::filter Minification) { Sampler.generate_mipmaps(BaseLevel, MaxLevel, Minification); } /// Manually Call destructor for image object. Helper function used in FFI. void destroy_sampler2d(gli::fsampler2D & Sampler) { Sampler.~sampler2d(); } } } } #ifdef GLI_IMPLEMENTATION #include "sampler2d.inl" #endif