Viewport(3I)

✨ Viewport(3I) ✨

okay so bestie, we're in the InterViews Reference Manual today and the vibe is: scrolling. buckle up 🎀

💖 NAME 💖

Viewport — a scrollable view, aka the little window that lets you peek at a bigger thing and slide it around 💅

🌸 SYNOPSIS 🌸

#include <InterViews/viewport.h>

🦋 DESCRIPTION 🦋

okay so Viewport is a subclass of MonoScene, and its whole thing is that it gives its component exactly as much space as the component wants — and it figures out how much that is from the component's shape. no negotiation, no shrinking, the component gets what it asks for, periodt.

that space then gets clipped down to the viewport's own size (because we can't just be showing everything, that's not the assignment), and the viewport keeps a perspective around to control which portion of the component is actually visible on screen. it's giving "camera operator for a widget" fr fr 🎥

and here's a cute lil detail: if the component is smaller than the viewport's canvas, the leftover background of the viewport gets filled in with a light gray pattern. so it's never just empty, it's got texture ✨

👑 PUBLIC OPERATIONS 👑

• Viewport(Interactor* = nil, Alignment = Center) — construct a brand new viewport, slay. if the interactor isn't nil, it gets inserted as the viewport's component. the second parameter decides where the component sits relative to the viewport. alignment matters, bestie 💅
• Insert(Interactor*) — set the component interactor. that's it, that's the move.
• void Change(Interactor*) — okay so important lore: a viewport does not propagate changes. so if the component's shape changes, the viewport just resizes the component according to the new shape. no drama, no cascade, just a resize 🫶
• void Remove(Interactor*) — take the component interactor out. bye bestie 👋
• virtual void Adjust(Perspective&) — change the viewport's perspective to the one you hand it. this will cause the desired area of the component to actually get drawn, so like, stuff happens on screen 💖
• void AdjustTo(float px, float py, float zx, float zy) — short-hand for explicitly manipulating the viewport's perspective.
• void AdjustBy(float dpx, float dpy, float dzx, float dzy) — short-hand for explicitly manipulating the viewport's perspective.
• void ScrollTo(float px, float py) — short-hand for explicitly manipulating the viewport's perspective.
• void ScrollXTo(float px) — short-hand for explicitly manipulating the viewport's perspective.
• void ScrollYTo(float py) — short-hand for explicitly manipulating the viewport's perspective.
• void ScrollBy(float dpx, float dpy) — short-hand for explicitly manipulating the viewport's perspective.
• void ScrollXBy(float dpx) — short-hand for explicitly manipulating the viewport's perspective.
• void ScrollYBy(float dpy) — short-hand for explicitly manipulating the viewport's perspective.
• void ZoomTo(float zx, float zy) — short-hand for explicitly manipulating the viewport's perspective.
• void ZoomXTo(float zx) — short-hand for explicitly manipulating the viewport's perspective.
• void ZoomYTo(float zy) — short-hand for explicitly manipulating the viewport's perspective.
• void ZoomBy(float dzx, float dzy) — short-hand for explicitly manipulating the viewport's perspective.
• void ZoomXBy(float dzx) — short-hand for explicitly manipulating the viewport's perspective.
• void ZoomYBy(float dzy) — short-hand for explicitly manipulating the viewport's perspective.
• float XPos() — short-hand for retrieving info about the current perspective.
• float YPos() — short-hand for retrieving info about the current perspective.
• float XMag() — short-hand for retrieving info about the current perspective.
• float YMag() — short-hand for retrieving info about the current perspective.

🌈 SEE ALSO 🌈

• Perspective(3I)
• Scene(3I)
• Shape(3I)

go read those next, iykyk 💜

this whole page came to you from the InterViews era, dated 10 February 1988 — and yeah, Viewport(3I) is the one and only. iconic behavior from a 1988 manpage ngl 💀✨