TEXTUREPROJOFFSET(3G)

✨ TEXTUREPROJOFFSET ✨

okay bestie, pull up a chair, we're doing the 3G manual page for textureProjOffset and honestly? it's giving math but make it cute. it does a texture lookup with projection and an offset. two things. at once. iconic behavior fr fr 💅

---

🌸 NAME 🌸

textureProjOffset — perform a texture lookup with projection and offset 🦋

---

🎀 DECLARATION 🎀

here's the whole cast list, no cap. copy these exactly, bestie, don't get creative:

gvec4 textureProjOffset(gsampler1D sampler, vec2 P, int offset,
                        [float bias]);

gvec4 textureProjOffset(gsampler1D sampler, vec4 P, int offset,
                        [float bias]);

gvec4 textureProjOffset(gsampler2D sampler, vec3 P, ivec2 offset,
                        [float bias]);

gvec4 textureProjOffset(gsampler2D sampler, vec4 P, ivec2 offset,
                        [float bias]);

gvec4 textureProjOffset(gsampler3D sampler, vec4 P, ivec3 offset,
                        [float bias]);

float textureProjOffset(sampler1DShadow sampler, vec4 P, int offset,
                        [float bias]);

float textureProjOffset(sampler2DShadow sampler, vec4 P, ivec2 offset,
                        [float bias]);

gvec4 textureProjOffset(gsampler2DRect sampler, vec3 P, ivec2 offset);

gvec4 textureProjOffset(gsampler2DRect sampler, vec4 P, ivec2 offset);

float textureProjOffset(gsampler2DRectShadow sampler, vec4 P,
                        ivec2 offset);

see how the 2DRect girlies don't get a bias? yeah. noted. 👑

---

💜 PARAMETERS 💜

• sampler — the sampler your texture is bound to. like, the one the texels are gonna be retrieved from. she's the source of truth, periodt.
• P — the texture coordinates where the sampling is gonna happen. the where, basically.
• offset — the offset that gets applied to P before sampling goes down. yes, before. that's the whole point of the function, bestie.
• bias — an optional little bias that gets applied while the level-of-detail computation is happening. optional. she's invited but she doesn't have to come.

---

🌈 DESCRIPTION 🌈

okay so textureProjOffset does a texture lookup with projection. here's the tea:

the texture coordinates consumed from P — and we're not including the last component of P here — get divided by the last component of P. classic projection move, we love a divide 💫

then, in the shadow forms, that resulting 3rd component of P is used as Dref. (yes, Dref. the drama component.)

after all that math is computed, the texture lookup proceeds exactly like it does in textureOffset(), with the offset being used to offset the computed texture coordinates. so it's like textureOffset() but the coordinates did a little glow-up first. slay. 🦋

---

⭐ VERSION SUPPORT ⭐

vibe check on who's allowed to use this, by OpenGL Shading Language Version:

textureProjOffset

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

textureProjOffset (gsampler2DRect{Shadow})

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

so the 2DRect version showed up late to the party in 1.40. fashionably late. we respect it. ✨

---

🫶 SEE ALSO 🫶

the whole friend group, go say hi:

texelFetch(), texelFetchOffset(), texture(), textureGather(), textureGatherOffset(), textureGatherOffsets(), textureGrad(), textureGradOffset(), textureLod(), textureLodOffset(), textureOffset(), textureProj(), textureProjGrad(), textureProjGradOffset(), textureProjLod(), textureProjLodOffset(), 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 that's the whole page, you ate that 🍓

this one's from the [FIXME: source], dated 01/03/2018, and it lives under the TEXTUREPROJOFFSET(3G) banner — so if you ever need to cite it, that's the receipts. mwah 💋 no cap.