🌀 BV Regional Select

Your BV Regional Prompt document is a bundle: a global prompt, a background prompt, and a whole stack of regions, each with its own prompt and geometry. Most of the time you hand the whole bundle to a compiler and walk away. But sometimes you want one slice - one region's prompt, say, or the background - as a first-class value you can inspect, render, or wire into something else. BV Regional Select is the picker that does that. It's the simplest member of the regional utility family, and it's the one everything else builds on.

How it works

Two inputs, both doing the obvious thing:

• regional - the BV document.
• scope (default region) - what to pull: global, background, or region. Pick region and you also set region, which names the specific region to select.

Three outputs: selection (a BV_REGIONAL_SELECTION object that carries the chosen slice), plus selected_id and selected_name (STRING) so you know exactly what got picked - handy when you're selecting by name and want to confirm the ID the document actually assigned, or when you're routing the selection into a display node.

Why the selection object matters

The selection output is the handoff format for the rest of the utility family:

• BV Regional Prompt Extract - takes a selection and produces its positive/negative AST, text, and source strings.
• BV Regional Mask Render - takes a selection and renders its mask plus pixel bounding box.

So the typical pattern is: Select → Prompt Extract (get the prompt text out for a text display or a prompt-processing node), and Select → Mask Render (get the geometry out as a real MASK you can use in ordinary ComfyUI maskland - composite, blur, invert, whatever). That's the bridge between the pack's document world and ComfyUI's ordinary image/mask world.

When you'd use it

Three honest cases. First, debugging: "which prompt is actually on region 3?" - Select it and read the text out. Second, mixing worlds: you want one region's geometry as a mask to feed a non-BV node (an inpaint mask, a ControlNet's conditioning mask). Third, workflow plumbing: you're building reusable Subgraph logic that needs "the background prompt, please" as a named output rather than buried in a document. If you're only ever feeding whole documents to compilers, you don't need Select - but the moment you need a slice, this is the clean way to get it.

Install

Search BV Node Pack in ComfyUI Manager, or:

cd ComfyUI/custom_nodes
git clone https://github.com/BlackVortexAI/bv_nodepack.git

Restart, hard-refresh with Ctrl + F5. No dependencies.

The honest take

Boring, tiny, and exactly what the regional system needs to stay composable. One practical note: scope defaults to region, so if you forget to change it you're asking for "which region?" on every run. Set it once per node and it's out of your way.