Frame(3I)

💖 Frame(3I) 💖

okay so bestie, welcome to the InterViews Reference Manual ✨ and today's main character is the whole frame family: Frame, ShadowFrame, MarginFrame, ShowFrame, TitleFrame, and BorderFrame. they're all about being the surrounding interactor, and honestly? iconic behavior. 🫶

🌸 NAME 🌸

Frame, ShadowFrame, MarginFrame, ShowFrame, TitleFrame, BorderFrame — literally just the surrounding interactor, no cap 💅

✨ SYNOPSIS ✨

#include <InterViews/frame.h>

that's it. that's the include. go off. 🎀

🦋 DESCRIPTION 🦋

so a frame is a monoscene subclass that outlines another interactor. it's giving "I'm the decorative bestie holding your whole look together." 💖

a shadow frame draws an outline with a drop shadow. yes, it's serving depth. a margin frame surrounds its component with horizontal and vertical glue — personal space, but make it structural. 🌈

a show frame is an abstract class that changes its appearance in response to an EnterEvent or a LeaveEvent. it's reactive, it's dramatic, it's aware of you. 😭

a title frame provides a banner that it displays in reverse video when it receives an EnterEvent — that's the glow-up moment, fr fr.

a border frame draws an outline using a solid pattern when it receives an EnterEvent, and draws the outline using a gray pattern when it receives a LeaveEvent. so when you leave, it dims. relatable. 💀

👑 PUBLIC OPERATIONS 👑

• Frame(Interactor*, int width = 1) — construct a frame. if the given interactor is not nil, it gets inserted as the frame's component. the frame extends width pixels outside of the interactor, so it's like a little halo of pixels. ✨
• ShadowFrame(Interactor*, int h = 1, int v = 1) — construct a shadow frame. the h and v ShadowFrame parameters specify the width of the horizontal and vertical shadows, respectively. positive values for these parameters specify shadows falling to the right and below the interactor, respectively; negative values specify shadows falling to the left and above. so yes bestie, negative numbers = shadow going the other way, that's the whole vibe check. 💅
• MarginFrame — construct a margin frame. four whole constructors, because we contain multitudes:

MarginFrame(Interactor* = nil, int margin = 0)
MarginFrame(Interactor*, int margin, int shrink, int stretch)
MarginFrame(Interactor*, int hmargin, int vmargin)
MarginFrame(Interactor*, int hm, int hshr, int hstr, int vm, int vshr,
int vstr)

• the first constructor puts rigid, fixed-sized glue around the component 🌸
• the second surrounds it with fixed-sized glue of the given shrinkability and stretchability 🧚
• independent horizontal and vertical margins are set with the third constructor 🎀
• the last constructor allows full specification of the margin frame's horizontal and vertical margins, shrinkabilities, and stretchabilities. full control. main character energy. 👑

• virtual void ShowFrame::HandleInput(Event&) — ShowFrame objects listen for EnterEvent and LeaveEvent. when an EnterEvent is received, ShowFrame::Handle calls InsideFrame(true); when an LeaveEvent is received, it calls InsideFrame(false). for any other event, it calls HandleInput. ShowFrame::InsideFrame does nothing. ShowFrame::HandleInput calls Handle on the frame's component. that's the whole chain of command, bestie, no notes. 🫶
• TitleFrame(Banner*, Interactor*, int width = 1) — construct a title frame with the given banner. TitleFrame::InsideFrame highlights and unhighlights the banner. slay. ⭐
• BorderFrame(Interactor*, int width = 1) — construct a border frame. BorderFrame::InsideFrame highlights and unhighlights the border. periodt. 💜

🔒 PROTECTED OPERATIONS 🔒

• Frame(Interactor*, int, int, int, int) — this constructor is used by subclasses to explicitly set the widths of each line in the outline. the integers specify the width of the left, bottom, right, and top lines, respectively. order matters, don't mix them up, iykyk. 🙈

🌟 SEE ALSO 🌟

Banner(3I), Event(3I), Glue(3I), Scene(3I) — go read those too, they're all part of the friend group. 🦋

and that's the whole page, bestie!! this one came from InterViews, dated 15 June 1987 🎀 mwah, take care of your frames, they take care of you 💖✨