icetResetTiles(3)

💖 icetResetTiles — the IceT Reference, bestie edition 💖

okay so real quick, this is icetResetTiles(3) from the IceT Reference, and it's genuinely one of the most satisfying little functions in the whole library. it's giving "clear the whole group chat" energy and honestly? iconic. 🧹✨

---

🌸 NAME 🌸

icetResetTiles — clears out all tile definitions.

like, all of them. poof. gone. 💅

---

🎀 Synopsis 🎀

ok so first you gotta let IceT in, obviously:

#include <IceT.h>

and then the function itself is literally the simplest signature you've ever seen:

void icetResetTiles(   void   );

no arguments. no return value. no drama. she just does the thing. 👑

---

🦋 Description 🦋

so here's the tea, bestie. IceT thinks of its display as a big ol' set of tiles. and icetResetTiles does exactly what it says on the tin: it empties that set completely. every tile? bye. 🫶

and then, because a display with zero tiles is lowkey useless, you fill the set right back up again with calls to icetAddTile. that's the whole cycle. empty it, fill it, live your life. ✨

now here's the part people forget and I need you to remember it, okay? as a side effect, icetResetTiles also zeros out the renderable window size. that size lives in the state variables ICET_PHYSICAL_RENDER_WIDTH and ICET_PHYSICAL_RENDER_HEIGHT. so yeah, it's not just clearing tiles, it's resetting your dimensions to nothing too. 😭

don't panic tho — the size gets set back up again with calls to icetAddTile. she's not gone forever, she's just ✨reborn✨.

---

💀 Errors 💀

None.

literally none. she does not miss. 🎯

---

🙈 Warnings 🙈

None.

---

💅 Bugs 💅

None known.

(no cap. we love a function with a clean record. 👑)

---

🌈 Notes 🌈

okay this is the important one so lock in. 📝

as a rule, a call to icetResetTiles should always be followed with one or more calls to icetAddTile.

like, always. not "usually". not "if you feel like it". always.

because if you just reset and walk away? icetDrawFrame, icetCompositeImage, and icetGLDrawFrame will not work properly if no tiles are in existence. and that's not a vibe. that's a bug you caused. 😭 so please, for me, add those tiles back. 🫶

---

💜 Copyright 💜

Copyright (C)2003 Sandia Corporation

Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

This source code is released under the New BSD License.

---

⭐ See Also ⭐

• icetAddTile(3) — the other half of this whole situation. you need her. go read her. 🎀

---

mwah 💋 that's the whole page, bestie. this one comes from the IceT Reference and was dated September 26, 2014 — so she's an elder but she still ate. stay hydrated, add your tiles back, and slay. 💖✨🦋