TEXTUREPROJLODOFFSET(3G)

🎀 NAME 🎀

textureProjLodOffset — bestie, this one does a texture lookup with projection AND explicit level-of-detail AND an offset. Three things at once, she's an overachiever 💅

---

🦋 DECLARATION 🦋

okay so here's the whole roster of overloads, copy-pasted EXACTLY because I do not play with signatures:

gvec4 textureProjLodOffset(gsampler1D sampler, vec2 P, float lod,
                           int offset);

gvec4 textureProjLodOffset(gsampler1D sampler, vec4 P, float lod,
                           int offset);

gvec4 textureProjLodOffset(gsampler2D sampler, vec3 P, float lod,
                           ivec2 offset);

gvec4 textureProjLodOffset(gsampler2D sampler, vec4 P, float lod,
                           ivec2 offset);

gvec4 textureProjLodOffset(gsampler3D sampler, vec4 P, float lod,
                           ivec3 offset);

float textureProjLodOffset(sampler1DShadow sampler, vec4 P, float lod,
                           int offset);

float textureProjLodOffset(sampler2DShadow sampler, vec4 P, float lod,
                           ivec2 offset);

seven of them. seven. she's booked and busy ✨

---

🌸 PARAMETERS 🌸

• sampler — the sampler your texture is bound to. like, the vibe you're pulling texels from 🫶
• P — the texture coordinates where the sampling happens. where you're pointing the little flashlight 🔦
• lod — the explicit level-of-detail to fetch texels from. you're telling it, not asking it, no cap 👑
• offset — the offset, in texels, applied to P before the texels get fetched. tiny nudge, big difference 💫

---

💖 DESCRIPTION 💖

so textureProjLodOffset performs a texture lookup with projection, from an explicitly specified level-of-detail, with an offset applied to the texture coordinates before sampling. it's giving multitasking main character energy fr fr.

here's the tea on how the coordinates work 🍓: the texture coordinates consumed from P — not including the last component of P — get divided by the last component of P. that's the projection part, periodt.

then, for the shadow forms, the resulting 3rd component of P is used as Dref. 💅

once all those values are computed, the texture lookup proceeds exactly as in textureLodOffset() — with lod used to specify the level-of-detail the texture gets sampled from, and offset used to specifiy the offset, in texels, applied to the texture coordinates before sampling. (yes, "specifiy" — I'm keeping it, that's the original's typo and I respect her 🙈)

---

⭐ VERSION SUPPORT ⭐

which GLSL versions said yes to her? vibe check:

┌──────────────────────┬───────────────────────────────────────────────────────────────────────────────────┐
│                      │        OpenGL Shading Language Version                                            │
├──────────────────────┼──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┤
│ Function             │ 1.10 │ 1.20 │ 1.30 │ 1.40 │ 1.50 │ 3.30 │ 4.00 │ 4.10 │ 4.20 │ 4.30 │ 4.40 │ 4.50 │
│ Name                 │      │      │      │      │      │      │      │      │      │      │      │      │
├──────────────────────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
│ textureProjLodOffset │  -   │  -   │  ✔   │  ✔   │  ✔   │  ✔   │  ✔   │  ✔   │  ✔   │  ✔   │  ✔   │  ✔   │
└──────────────────────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┘

tl;dr: she showed up in 1.30 and never left. 1.10 and 1.20 said no. everyone after said slay 🔥

---

🌈 SEE ALSO 🌈

her whole friend group, go say hi:

• texelFetch()
• texelFetchOffset()
• texture()
• textureGather()
• textureGatherOffset()
• textureGatherOffsets()
• textureGrad()
• textureGradOffset()
• textureLod()
• textureLodOffset()
• textureOffset()
• textureProj()
• textureProjGrad()
• textureProjGradOffset()
• textureProjLod()
• textureProjOffset()
• textureQueryLod()
• textureSize()

---

👑 COPYRIGHT 👑

Copyright © 2011-2014 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.

---

💜 COPYRIGHT (yes, again) 💜

Copyright © 2011-2014 Khronos Group

---

okay bestie that's the whole page, mwah 🫶 this came from the [FIXME: source] situation, dated 01/03/2018, and it's filed under TEXTUREPROJLODOFFSET(3G) — go forth and sample responsibly 💖✨🎀