> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fabl.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Viz Flowics

> Control Vizrt Viz Flowics cloud graphics — take overlays on and off air, update text and images from your rundown, and toggle overlays — over its Graphics Control API.

The **Viz Flowics** device controls Viz Flowics cloud HTML5 graphics, so a rundown item can put an overlay on air and feed it live values from your page.

## Connection

Viz Flowics is a cloud service, so there is no host to reach on your network. Provide the **graphics token** for the package you want to drive; the **API base URL** is already set and rarely needs changing.

## Commands

| Command           | What it does                                                 |
| ----------------- | ------------------------------------------------------------ |
| Take in           | Takes an overlay on air                                      |
| Take out          | Takes an overlay off air                                     |
| Toggle            | Switches an overlay between in and out                       |
| Take in with text | Takes an overlay in and sets a text control in the same call |
| Set text control  | Updates a text control, whether the overlay is in or out     |
| Set image control | Sets an image control from a URL                             |

Text values are token-substituted, so a control can be driven straight from a field on your page.

<Note>
  Triggering a second overlay in the same region automatically takes the first one out. You do not need a separate take-out action when swapping looks within a region.
</Note>

<Warning>
  A control can only be addressed if it has been given a **Control API ID** in the Flowics editor, and the package has been republished since. A control without one cannot be reached, and the call will not find it.
</Warning>

Images must already be hosted in the Flowics Assets Library. A raw Control API command is available for the output, playlist, timer and list families.

## State and triggers

The device reports its connection state, the last action, the last overlay addressed, and the last error. A trigger fires when the connection changes.