IMAGESTORE(3G)

✨ IMAGESTORE(3G) ✨

okay bestie, sit down, hydrate, and let me tell you about imageStore — the GLSL function that's literally just "here, take this texel, put it *there". it's in section 3G of the manual, and it's giving very much "I write pixels, that's my whole personality". 💅

---

🌸 NAME 🌸

imageStore — write a single texel into an image

like, one texel. singular. no cap.

---

🎀 DECLARATION 🎀

here's the whole friend group. twelve overloads, all named imageStore, all ready to vibe:

void imageStore(gimage1D image, int P, gvec4 data);

void imageStore(gimage2D image, ivec2 P, gvec4 data);

void imageStore(gimage3D image, ivec3 P, gvec4 data);

void imageStore(gimage2DRect image, ivec2 P, gvec4 data);

void imageStore(gimageCube image, ivec3 P, gvec4 data);

void imageStore(gbufferImage image, int P, gvec4 data);

void imageStore(gimage1DArray image, ivec2 P, gvec4 data);

void imageStore(gimage2DArray image, ivec3 P, gvec4 data);

void imageStore(gimageCubeArray image, ivec3 P, gvec4 data);

void imageStore(gimage2DMS image, ivec2 P, int sample, gvec4 data);

void imageStore(gimage2DMSArray image, ivec3 P, int sample, gvec4 data);

notice how the multisample girlies (gimage2DMS, gimage2DMSArray) get an extra int sample in there? yeah. they're built different. 👑

---

🦋 PARAMETERS 🦋

• image — the image unit you're storing a texel into. this is the destination, the final boss, the address on the envelope.
• P — the coordinate where the texel goes. where we're dropping it off. 📍
• sample — only shows up sometimes (multisample moment), and it says which sample inside the image you're storing into.
• data — the actual data getting stored into the image. the payload. the gift. 🎁

---

💖 DESCRIPTION 💖

so imageStore stores data into the texel at coordinate P, in the image specified by image. that's it, that's the whole job. for multi-sample stores, the sample number comes from sample.

when image, P, and sample all identify a valid texel, the bits used to represent data get converted to the format of the image unit — in the manner described in the OpenGL Specification — and then stored to that specified texel.

⚠️ key phrase alert: valid texel. if those three don't point at something real, that's not a "we'll figure it out" situation, bestie. check your coordinates. 🔥

---

⭐ VERSION SUPPORT ⭐

the vibe check on when imageStore was even allowed to exist. the table in the original is:

Function Name: imageStore

OpenGL Shading Language Version:

• 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 yeah. she didn't exist until GLSL 4.20, and then she ate every version after. iconic behavior, honestly. 💅✨

---

🌈 SEE ALSO 🌈

the whole entourage, go say hi:

• imageLoad()
• imageAtomicAdd()
• imageAtomicMin()
• imageAtomicMax()
• imageAtomicAnd()
• imageAtomicOr()
• imageAtomicXor()
• imageAtomicExchange()
• imageAtomicCompSwap()

---

💜 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 💜

Copyright © 2011-2014 Khronos Group

---

okay that's the whole page, bestie 🫶 go forth and store texels responsibly. this was [FIXME: source], dated 01/03/2018, and you can find her filed under IMAGESTORE(3G) — mwah, love u, bye 💖✨🎀