IMG_LoadPNM_IO(3)

🦋 IMG_LoadPNM_IO(3) — a page from the SDL_image3 FUNCTIONS manual 🦋

🎀 NAME 🎀

IMG_LoadPNM_IO — load a PNM image directly. That’s the headline, bestie, and it is serving exactly what it says on the tin. ✨

🌸 SYNOPSIS 🌸

#include <SDL3_image/SDL_image.h>

SDL_Surface * IMG_LoadPNM_IO(SDL_IOStream *src);

💖 DESCRIPTION 💖

Okay so picture this: you already know, like, for sure that the image you have is a PNM image. In that case you can call IMG_LoadPNM_IO, and it will skip SDL_image’s file format detection routines. Shortcut era ⚡

Generally, though, it’s better to use the abstract interfaces. Also important: there is only an SDL_IOStream interface available here — that’s the whole interface menu, no cap. 💅

🫶 FUNCTION PARAMETERS 🫶

• src — an SDL_IOStream to load image data from. That’s the plug, bestie. 🫶

😭 RETURN VALUE 😭

Returns a SDL surface, or NULL on error. So if it comes back NULL, that’s the error timeline, not a vibe. 💀

👑 AVAILABILITY 👑

This function is available since SDL_image 3.0.0. Iconic behavior, honestly. 👑

👀 SEE ALSO 👀

These are the other format-specific besties — go say hi: 🌈

• IMG_LoadAVIF_IO(3)
• IMG_LoadBMP_IO(3)
• IMG_LoadCUR_IO(3)
• IMG_LoadGIF_IO(3)
• IMG_LoadICO_IO(3)
• IMG_LoadJPG_IO(3)
• IMG_LoadJXL_IO(3)
• IMG_LoadLBM_IO(3)
• IMG_LoadPCX_IO(3)
• IMG_LoadPNG_IO(3)
• IMG_LoadQOI_IO(3)
• IMG_LoadSVG_IO(3)
• IMG_LoadTGA_IO(3)
• IMG_LoadTIF_IO(3)
• IMG_LoadWEBP_IO(3)
• IMG_LoadXCF_IO(3)
• IMG_LoadXPM_IO(3)
• IMG_LoadXV_IO(3)

---

🎀 cute little sign-off: this page’s source is the SDL_image manual, its version is SDL_image 3.4.4, and the footer didn’t give a date — so I’m not inventing one, bestie. Stay slay out there! 🫶🌈