VistaIOGetPixel(3)

📦 version 1.2.19, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 VistaIOGetPixel 💖

okay so bestie, we're in section 3 of the Library Functions Manual today, and this page is about VistaIOGetPixel and VistaIOSetPixel — the two lil functions that let you peek at a pixel and then absolutely rearrange it. get and set. that's the whole vibe. ✨

🌸 NAME 🌸

VistaIOGetPixel, VistaIOSetPixel — get and set pixel values

lowkey the entire personality of this page right here. one grabs, one gives. iconic duo behavior. 💅

✨ SYNOPSIS ✨

#include <vistaio.h>

VistaIODouble VistaIOGetPixel (image, band, row, column)
       VistaIOImage image;
       int band, row, column;

void VistaIOSetPixel (image, band, row, column, value)
       VistaIOImage image;
       int band, row, column;
       VistaIODouble value;

yes it's the old-school K&R-style declaration situation, we love a vintage moment. 🎀

🫶 ARGUMENTS 🫶

  • image — the image that's holding the pixel. this is the one you're reaching into. 🦋
  • band, row, column — the coordinates, fr fr. which band, which row, which column — like a little address for exactly one pixel. no cap. 📍
  • value — the pixel's new value. what you're setting it to. the glow-up. 💖

🔥 DESCRIPTION 🔥

VistaIOGetPixel fetches the value of the specified pixel and hands it back to you as a VistaIODouble. and if the image's actual pixel representation is something else? it casts, no big deal, it just does the conversion for you. considerate king behavior. 👑

VistaIOSetPixel sets the specified pixel to value, casting it to the image's actual pixel representation if necessary. so you can just toss it whatever and it'll make it fit. that's the way that it works. ✨

⭐ RETURN VALUES ⭐

VistaIOGetPixel returns the value of the specified pixel. that's it. that's the tea. 🍓

(VistaIOSetPixel returns void, so it's giving nothing back — it just does the thing and dips. 🙈)

🌈 SEE ALSO 🌈

VistaIOImage(3)

💜 NOTES 💜

If the image is known to have a particular pixel representation then the VistaIOPixel macro (see VistaIOImage(3)) can be used, instead, yielding greater efficiency.

translation bestie: if you already know what the pixel representation is, skip these and use the VistaIOPixel macro instead — it's faster. iykyk. 🔥

👑 AUTHOR 👑

Art Pope <pope@cs.ubc.ca>

Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>

legends, both of them. we stan. 🫶

and that's the whole page, bestie!! this was VistaIO Version 1.2.14, dated 24 April 1993 — yes she's an elder but she still slays, and we are obsessed. go forth and get and set those pixels. periodt. 💅✨🎀

📦 where this page comes from