TIFFWRITEENCODEDTILE(3tiff)

💅 TIFFWRITEENCODEDTILE 💅

okay bestie, welcome to the TIFFWRITEENCODEDTILE page from the 3tiff manual (yes that's the LibTIFF one, the icon itself) 🌸

---

✨ NAME ✨

TIFFWriteEncodedTile — compress a tile's worth of data and write it into an open TIFF file. it's giving "squish it and ship it" fr fr 💖

---

🦋 SYNOPSIS 🦋

#include <tiffio.h>

tmsize_t TIFFWriteEncodedTile(TIFF *tif, uint32_t tile, void *buf,
tmsize_t size)

---

🌈 DESCRIPTION 🌈

so here's the tea ☕ — this function takes size bytes of raw data sitting in buf, compresses all of it, and appends the result to the end of the tile you picked. no cap.

lowkey the most important thing to know: tile is a "raw tile number". meaning you, the caller, have to handle whether the data is organized in separate planes or not (PlanarConfiguration = 2). that's a you problem, bestie, not the library's 🙈

but wait — TIFFComputeTile() has your back: it does that adjustment automatically when it converts an (x,y,z,sample) coordinate quadruple into a tile number. slay 👑

---

🎀 NOTES 🎀

the library writes the encoded data using the native machine byte order. so any TIFF reader that's actually implemented correctly is expected to do whatever byte-swapping is needed to process image data where BitsPerSample is greater than 8. that's the deal, that's the arrangement 🤝

---

⭐ RETURN VALUES ⭐

• -1 comes back if an error was encountered. sad girl hours 😭
• otherwise, you get back the value of size. we love a successful return 💖

---

💀 DIAGNOSTICS 💀

every single error message gets directed to the TIFFErrorExtR() routine. here's the whole roster, no skips:

• %s: File not open for writing: the file was opened for reading, not writing. wrong vibe entirely 🙅‍♀️
• Can not write tiles to a stripped image: the image is assumed to be organized in strips, because neither the TileWidth nor the TileLength tags were set with TIFFSetField().
• %s: Must set "ImageWidth" before writing data: the image's width hadn't been set before the first write. check TIFFSetField() to see how to do that.
• %s: Must set "PlanarConfiguration" before writing data: the organization of the data wasn't defined before the first write. again, TIFFSetField() is where the answers live.
• %s: No space for tile arrays": there just wasn't enough space for the arrays that hold the tile offsets and byte counts. rip 🪦

---

🔥 SEE ALSO 🔥

• TIFFOpen (3tiff)
• TIFFWriteTile (3tiff)
• TIFFWriteRawTile (3tiff)
• libtiff (3tiff)

---

👑 AUTHOR 👑

LibTIFF contributors 🫶

---

🌸 COPYRIGHT 🌸

1988-2025, LibTIFF contributors

---

and that's the whole page bestie, you ate that 💅✨

version 4.7 · Jun 27, 2026 — mwah, go write some tiles 💖🎀🦋