TIFFWRITEENCODEDSTRIP(3tiff)

💖 TIFFWRITEENCODEDSTRIP 💖

okay bestie, gather round, because this is the 3tiff page for TIFFWriteEncodedStrip, and it does exactly what it says on the tin: it compresses a strip of data and writes it into an open TIFF file. iconic behavior, no notes. this one lives in the LibTIFF manual, and she's a real one.

---

✨ SYNOPSIS ✨

#include <tiffio.h>

tmsize_t TIFFWriteEncodedStrip(TIFF *tif, uint32_t strip, void *buf,
tmsize_t size)

---

🌸 DESCRIPTION 🌸

so here's the tea 🍓: this function grabs size bytes of raw data out of buf, compresses it, and writes the result into the strip you asked for. and yes, it replaces any previously written data in that strip — no merge, no "aww let's keep both", it's a full glow-up swap. periodt.

now the little detail that trips people up: the value of strip is a "raw strip number". that means you, the caller, have to do the math yourself and account for whether the data is organized in separate planes (PlanarConfiguration = 2). the library is not doing that mental load for you, bestie. 🫶

---

🎀 NOTES 🎀

• the library writes encoded data using the native machine byte order. correctly implemented TIFF readers are expected to do any necessary byte-swapping so they can correctly process image data with BitsPerSample greater than 8. so if your reader is out here acting brand new about endianness, that's a them problem. 💀
• the strip number must be valid according to the current settings of the ImageLength and RowsPerStrip tags. fr fr, no vibes-based strip numbers.
• good news tho: an image can be dynamically grown by increasing the value of ImageLength prior to each call to TIFFWriteEncodedStrip. main character energy — she grows as she goes. 👑

---

💅 RETURN VALUES 💅

• -1 is returned if an error was encountered. 😭
• otherwise, the value of size is returned. slay. ✨

---

🌈 DIAGNOSTICS 🌈

all error messages are directed to the TIFFErrorExtR() routine. so that's where the drama gets reported. 📢

• %s: File not open for writing: — the file was opened for reading, not writing. bestie. you cannot write to a read-only file. that's not a vibe, that's a wall. 🧱
• Can not write scanlines to a tiled image: — the image is assumed to be organized in tiles because the TileWidth and TileLength tags have been set with TIFFSetField().
• %s: Must set "ImageWidth" before writing data\fP: — the image's width has not be set before the first write. see TIFFSetField() for information on how to do this.
• %s: Must set "PlanarConfiguration" before writing data: — the organization of data has not be defined before the first write. see TIFFSetField() for information on how to do this.
• %s: No space for strip arrays": — there was not enough space for the arrays that hold strip offsets and byte counts.

ngl, if you're seeing any of these, the move is: go set your tags with TIFFSetField() before you start writing. the library literally cannot read your mind, she's just a library. 🙈

---

🦋 SEE ALSO 🦋

• TIFFOpen (3tiff)
• TIFFWriteScanline (3tiff)
• TIFFWriteRawStrip (3tiff)
• libtiff (3tiff)

---

⭐ AUTHOR ⭐

LibTIFF contributors — legends, honestly. 👑

💜 COPYRIGHT 💜

1988-2025, LibTIFF contributors

---

and that's the whole page, bestie!! 💖 this was LibTIFF 4.7, dated Jun 27, 2026, written by the LibTIFF contributors, and you just read the TIFFWRITEENCODEDSTRIP(3tiff) manual like a true icon. go compress a strip. iykyk. 🎀✨