TEXTUREPROJGRADOFFSE(3G)

💖 textureProjGradOffset — the TEXTUREPROJGRADOFFSE(3G) glow-up 💖

okay bestie, sit down, hydrate, because we're doing a texture lookup with projection, explicit gradients AND an offset all at once. it's giving "overachiever" and honestly? we love that for us. 🦋

---

✨ NAME ✨

textureProjGradOffset — perform a texture lookup with projection, explicit gradients and offset 🎀

---

🌸 DECLARATION 🌸

here's the whole lineup, exactly as it is, no notes, no edits, periodt:

gvec4 textureProjGradOffset(gsampler1D sampler, vec2 P, float dPdx,
                            float dPdy, int offset);

gvec4 textureProjGradOffset(gsampler1D sampler, vec4 P, float dPdx,
                            float dPdy, int offset);

gvec4 textureProjGradOffset(gsampler2D sampler, vec3 P, vec2 dPdx,
                            vec2 dPdy, ivec2 offset);

gvec4 textureProjGradOffset(gsampler2D sampler, vec4 P, vec2 dPdx,
                            vec2 dPdy, ivec2 offset);

gvec4 textureProjGradOffset(gsampler3D sampler, vec4 P, vec3 dPdx,
                            vec3 dPdy, ivec3 offset);

float textureProjGradOffset(sampler1DShadow sampler, vec4 P, float dPdx,
                            float dPdy, int offset);

float textureProjGradOffset(sampler2DShadow sampler, vec4 P, vec2 dPdx,
                            vec2 dPdy, ivec2 offset);

gvec4 textureProjGradOffset(gsampler2DRect sampler, vec3 P, vec2 dPdx,
                            vec2 dPdy, ivec2 offset);

gvec4 textureProjGradOffset(gsampler2DRect sampler, vec4 P, vec2 dPdx,
                            vec2 dPdy, ivec2 offset);

float textureProjGradOffset(gsampler2DRectShadow sampler, vec4 P,
                            vec2 dPdx, vec2 dPdy, ivec2 offset);

look at all those overloads. main character energy, every single one. 👑

---

💅 PARAMETERS 💅

• sampler — the sampler your texture is bound to, aka the one we're pulling texels out of. it's the plug. 🔌
• P — the texture coordinates where the sampling is gonna happen. the "where we at" of it all.
• dPdx — the partial derivative of P with respect to window x. yes, a real math thing, we're doing calculus at the function call, slay. ✨
• dPdy — the partial derivative of P with respect to window y. same vibe, other axis. 🌈
• offset — the offsets, in texels, at which the texture gets sampled relative to the projection of P. so it's P's projection but shifted, lowkey. 🎀

---

🫶 DESCRIPTION 🫶

textureProjGradOffset does a texture lookup with projection and explicit gradients and offsets. all three. at once. iconic.

here's the tea on the projection part: the texture coordinates taken from P — not including the last component of P — get divided by the last component of P. that's the whole projection moment. ✨

then, in the shadow forms, the resulting 3rd component of P gets used as Dref.

and after all those values are computed? the lookup just proceeds like it does in textureGradOffset(), handing over dPdx and dPdy as the gradients, and offset as the offset. so basically: do the projection, then let textureGradOffset() cook. 🔥

---

🌟 VERSION SUPPORT 🌟

here's the vibe check across every GLSL version, bestie. no table, just receipts. 💀

textureProjGradOffset

• GLSL 1.10 — - (not invited 🙈)
• GLSL 1.20 — - (still not invited 😭)
• GLSL 1.30 — ✔
• GLSL 1.40 — ✔
• GLSL 1.50 — ✔
• GLSL 3.30 — ✔
• GLSL 4.00 — ✔
• GLSL 4.10 — ✔
• GLSL 4.20 — ✔
• GLSL 4.30 — ✔
• GLSL 4.40 — ✔
• GLSL 4.50 — ✔

textureProjGradOffset (gsampler2DRect{Shadow})

• GLSL 1.10 — - 🙈
• GLSL 1.20 — - 🙈
• GLSL 1.30 — - 🙈
• GLSL 1.40 — ✔
• GLSL 1.50 — ✔
• GLSL 3.30 — ✔
• GLSL 4.00 — ✔
• GLSL 4.10 — ✔
• GLSL 4.20 — ✔
• GLSL 4.30 — ✔
• GLSL 4.40 — ✔
• GLSL 4.50 — ✔

so the Rect shadow version is a little late to the party (arrives at 1.40, fashionably, as always 💅) while the main one showed up at 1.30 and never left. obsessed.

---

🦋 SEE ALSO 🦋

the whole friend group, go say hi:

• texelFetch()
• texelFetchOffset()
• texture()
• textureGather()
• textureGatherOffset()
• textureGatherOffsets()
• textureGrad()
• textureGradOffset()
• textureLod()
• textureLodOffset()
• textureOffset()
• textureProj()
• textureProjGrad()
• textureProjLod()
• textureProjLodOffset()
• 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 © 2011-2014 Khronos Group

---

okay so full disclosure: the man page header spells it TEXTUREPROJGRADOFFSE and the footer says [FIXME: source] and 01/03/2018, and I'm not gonna pretend that's not a whole mood. the title ate, the typo ate, we move. 💖

and that's the page, bestie. [FIXME: source] → 01/03/2018, straight from the TEXTUREPROJGRADOFFSE(3G) zone. go sample something gorgeous. 🧚✨