VBI(3pm)

✨ VBI(3pm) ✨

okay bestie, so this is VBI, page 3 of the perl manual, and yeah it's one of those User Contributed Perl Documentation situations 💅. No cap, it's niche, it's giving broadcast-teletext-girlie, and we're gonna get through it together.

---

🌸 NAME 🌸

Video::Capture::VBI — literally just: functions to manipulate vbi fields & lines. that's the whole job. she's focused. 💖

---

🎀 SYNOPSIS 🎀

use Video::Capture::VBI;

that's it. that's the vibe check. one line and you're in. ✨

---

🦋 DESCRIPTION 🦋

• new — bestie this makes you a brand new VBI decoder object 🫶. and like, here's the thing: VBI decoding often needs state, and this object is literally the little container where that state lives. she holds the memories so you don't have to. iconic behavior honestly.
• reset — (NYI) ⚠️ okay so heads up, this one is not yet implemented, so don't come for me. when it does work, its whole thing is resetting the state — like, say, after you switch a channel and you need her to forget everything and start fresh. main character amnesia arc, but make it a decoder. 😭

---

👑 CONSTANTS / MASK OPERATORS 👑

so these constants exist and they're available for you, periodt. if you want the thorough definition, go read ETS 300 706 — the manpage said so, not me. iykyk 📺

VTX_SUB 0x003f7f # S1..S4 field mask

VTX_C4  0x000080 # erase page
VTX_C5  0x004000 # newsflash
VTX_C6  0x008000 # subtitle
VTX_C7  0x010000 # suppress header
VTX_C8  0x020000 # update indicator
VTX_C9  0x040000 # interrupted sequence
VTX_C10 0x080000 # inhibit display
VTX_C11 0x100000 # magazine serial

VTX_C12 0x200000 # ... option ...
VTX_C13 0x400000 # ... character ...
VTX_C14 0x800000 # ... set

---

💜 the mask functions 💜

okay so all of these mask functions do the exact same little trick: you hand them a single CTRL bitfield, and they hand you back the corresponding subfield. that's it. they're basically little sieves for bits. 🧚

VTX_S1  (shift    )&15 } # S1
VTX_S2  (shift>> 4)& 7 } # S2
VTX_S3  (shift>> 8)&15 } # S3
VTX_S4  (shift>>12)& 3 } # S4
VTX_NOC (shift>>21)& 7 } # national character set...

fr fr, VTX_NOC is your national character set girlie — she's the one that decides which alphabet-flavored letters you're getting. 🌈

---

and that's the whole page, bestie, we ate and left no crumbs 💅. this was page VBI(3pm) from perl v5.40.1, dated 2025-04-13 — go forth and decode some vbi fields, you gorgeous nerd 🎀✨💖