#include </home/runner/work/OrcaSlicer/OrcaSlicer/src/libslic3r/TextureDisplacement.hpp>

Collaboration diagram for Slic3r::DecodedHeightTexture:

Classes
struct	TexelTap

Public Member Functions
bool	empty () const
bool	has_color () const
float	sample (const Vec2f &uv, bool tile_enabled=true, TextureTileMethod tile_method=TextureTileMethod::Repeat) const
Vec3f	sample_color (const Vec2f &uv, bool tile_enabled=true, TextureTileMethod tile_method=TextureTileMethod::Repeat) const
bool	texel_tap (const Vec2f &uv, bool tile_enabled, TextureTileMethod tile_method, TexelTap &out) const

Public Attributes
std::vector< uint8_t >	pixels
std::vector< uint8_t >	rgb
int	width = 0
int	height = 0

Detailed Description

Class Documentation

◆ Slic3r::DecodedHeightTexture::TexelTap

struct Slic3r::DecodedHeightTexture::TexelTap

Class Members
float	tx = 0.f
float	ty = 0.f
int	x0 = 0
int	x1 = 0
int	y0 = 0
int	y1 = 0

Member Function Documentation

◆ empty()

bool Slic3r::DecodedHeightTexture::empty ( ) const

inline

541{ return width <= 0 || height <= 0 || pixels.empty(); }

Slic3r::DecodedHeightTexture::pixels

std::vector< uint8_t > pixels

Definition TextureDisplacement.hpp:532

Slic3r::DecodedHeightTexture::width

int width

Definition TextureDisplacement.hpp:538

Slic3r::DecodedHeightTexture::height

int height

Definition TextureDisplacement.hpp:539

References height, pixels, and width.

Referenced by Slic3r::apply_texture_adjustments(), Slic3r::downscale_height_texture(), has_color(), Slic3r::GUI::anonymous_namespace{TextureLibrary.cpp}::image_from_decoded(), Slic3r::GUI::GLGizmoTextureDisplacement::load_image_adjust_source(), Slic3r::anonymous_namespace{TextureDisplacement.cpp}::prepare_sampleable_layers(), Slic3r::GUI::GLGizmoTextureDisplacement::push_uv_pane_state(), Slic3r::sample_layer_height(), texel_tap(), and Slic3r::GUI::anonymous_namespace{GLGizmoTextureDisplacement.cpp}::upload_height_thumbnail().

Here is the caller graph for this function:

◆ has_color()

bool Slic3r::DecodedHeightTexture::has_color ( ) const

inline

542{ return !empty() && rgb.size() == size_t(width) * size_t(height) * 3; }

Slic3r::DecodedHeightTexture::rgb

std::vector< uint8_t > rgb

Definition TextureDisplacement.hpp:537

Slic3r::DecodedHeightTexture::empty

bool empty() const

Definition TextureDisplacement.hpp:541

References empty(), height, rgb, and width.

Referenced by Slic3r::analyze_texture_detail(), Slic3r::apply_texture_adjustments(), Slic3r::build_texture_displacement_in_place(), Slic3r::decode_height_texture(), Slic3r::downscale_height_texture(), Slic3r::height_texture_has_color(), Slic3r::GUI::anonymous_namespace{TextureLibrary.cpp}::image_from_decoded(), Slic3r::GUI::GLGizmoTextureDisplacement::mix_targets(), Slic3r::anonymous_namespace{TextureDisplacement.cpp}::prepare_sampleable_layers(), Slic3r::GUI::GLGizmoTextureDisplacement::push_uv_pane_state(), sample_color(), Slic3r::sample_layer_color(), Slic3r::GUI::anonymous_namespace{GLGizmoTextureDisplacement.cpp}::upload_color_texture(), and Slic3r::GUI::anonymous_namespace{GLGizmoTextureDisplacement.cpp}::upload_height_thumbnail().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sample()

float Slic3r::DecodedHeightTexture::sample	(	const Vec2f &	uv,
		bool	tile_enabled = true,
		TextureTileMethod	tile_method = TextureTileMethod::Repeat ) const

{
    TexelTap tap;
    if (!texel_tap(uv, tile_enabled, tile_method, tap))
        return 0.f;
    const int   x0 = tap.x0, y0 = tap.y0, x1 = tap.x1, y1 = tap.y1;
    const float tx = tap.tx, ty = tap.ty;
 
    auto at = [this](int x, int y) { return float(pixels[size_t(y) * size_t(width) + size_t(x)]) / 255.f; };
    const float top    = at(x0, y0) * (1.f - tx) + at(x1, y0) * tx;
    const float bottom = at(x0, y1) * (1.f - tx) + at(x1, y1) * tx;
    return top * (1.f - ty) + bottom * ty;
}

References pixels, texel_tap(), Slic3r::DecodedHeightTexture::TexelTap::tx, Slic3r::DecodedHeightTexture::TexelTap::ty, width, Slic3r::DecodedHeightTexture::TexelTap::x0, Slic3r::DecodedHeightTexture::TexelTap::x1, Slic3r::DecodedHeightTexture::TexelTap::y0, and Slic3r::DecodedHeightTexture::TexelTap::y1.

Referenced by Slic3r::sample_layer_height().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sample_color()

Vec3f Slic3r::DecodedHeightTexture::sample_color	(	const Vec2f &	uv,
		bool	tile_enabled = true,
		TextureTileMethod	tile_method = TextureTileMethod::Repeat ) const

{
    TexelTap tap;
    if (!has_color() || !texel_tap(uv, tile_enabled, tile_method, tap))
        return Vec3f::Zero();
 
    auto at = [this](int x, int y) {
        const size_t i = (size_t(y) * size_t(width) + size_t(x)) * 3;
        return Vec3f(float(rgb[i]) / 255.f, float(rgb[i + 1]) / 255.f, float(rgb[i + 2]) / 255.f);
    };
    const Vec3f top    = at(tap.x0, tap.y0) * (1.f - tap.tx) + at(tap.x1, tap.y0) * tap.tx;
    const Vec3f bottom = at(tap.x0, tap.y1) * (1.f - tap.tx) + at(tap.x1, tap.y1) * tap.tx;
    return top * (1.f - tap.ty) + bottom * tap.ty;
}

References has_color(), rgb, texel_tap(), Slic3r::DecodedHeightTexture::TexelTap::tx, Slic3r::DecodedHeightTexture::TexelTap::ty, width, Slic3r::DecodedHeightTexture::TexelTap::x0, Slic3r::DecodedHeightTexture::TexelTap::x1, Slic3r::DecodedHeightTexture::TexelTap::y0, and Slic3r::DecodedHeightTexture::TexelTap::y1.

Referenced by Slic3r::sample_layer_color().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ texel_tap()

bool Slic3r::DecodedHeightTexture::texel_tap	(	const Vec2f &	uv,
		bool	tile_enabled,
		TextureTileMethod	tile_method,
		TexelTap &	out ) const

{
    if (empty())
        return false;
 
    auto repeat01 = [](float x) {
        x = std::fmod(x, 1.f);
        return x < 0.f ? x + 1.f : x;
    };
    // Standard mirrored-repeat: reflect back and forth every other unit, so tile edges always
    // line up with themselves instead of jumping from one edge of the image to the other.
    auto mirrored_repeat01 = [](float x) {
        x = std::fmod(std::abs(x), 2.f);
        return x > 1.f ? 2.f - x : x;
    };
 
    if (!tile_enabled && (uv.x() < 0.f || uv.x() >= 1.f || uv.y() < 0.f || uv.y() >= 1.f))
        // Outside the single, non-repeating placement entirely: no texture there, not "smeared
        // edge pixel" - clamping the *coordinate* to [0, 1] would otherwise keep returning the
        // border row/column's height forever in every direction, stretching it out to infinity.
        return false;
 
    float u, v;
    if (!tile_enabled) {
        u = uv.x();
        v = uv.y();
    } else if (tile_method == TextureTileMethod::MirroredRepeat) {
        u = mirrored_repeat01(uv.x());
        v = mirrored_repeat01(uv.y());
    } else {
        u = repeat01(uv.x());
        v = repeat01(uv.y());
    }
 
    const float fx = u * float(width);
    const float fy = v * float(height);
    const int   x0 = std::clamp(int(std::floor(fx)), 0, width - 1);
    const int   y0 = std::clamp(int(std::floor(fy)), 0, height - 1);
    // Neighbour for bilinear filtering: wrap for tiling methods, clamp at the edge otherwise (a
    // repeating neighbour would incorrectly blend against the opposite edge of the image).
    tap.x0 = x0;
    tap.y0 = y0;
    tap.x1 = tile_enabled ? (x0 + 1) % width  : std::min(x0 + 1, width - 1);
    tap.y1 = tile_enabled ? (y0 + 1) % height : std::min(y0 + 1, height - 1);
    tap.tx = fx - std::floor(fx);
    tap.ty = fy - std::floor(fy);
    return true;
}