OSC: Overlay Commands

Control overlays — toggle visibility, position, scale, and configure text overlay properties.

Overlay control

Address	Args	Description
/pmix/overlay/{n}/toggle	—	Toggle overlay for slot n
/pmix/overlay/{n}/position	float, float	Set X, Y position (0–1, center = 0.5)
/pmix/overlay/{n}/scale	float	Set scale (0.1–10, default 1.0)
/pmix/overlay/{n}/rotation	float	Set rotation in degrees (-180 to 180)
/pmix/overlay/{n}/opacity	float	Set opacity (0–1, image overlays only)
/pmix/overlay/enabled	int 0/1	Set global overlay visibility
/pmix/overlay/clear	—	Clear all overlays

Text overlay properties

Address	Args	Description
/pmix/overlay/{n}/text	string	Set text content
/pmix/overlay/{n}/fontSize	float	Set font size
/pmix/overlay/{n}/fontName	string	Set font name (e.g., Futura-Bold)
/pmix/overlay/{n}/textAlignment	string	left, center, right
/pmix/overlay/{n}/textColor	float x4	Set text color (R, G, B, A each 0–1)
/pmix/overlay/{n}/bgColor	float x4	Set background color (R, G, B, A each 0–1)
/pmix/overlay/{n}/bold	int 0/1	Set bold style
/pmix/overlay/{n}/italic	int 0/1	Set italic style
/pmix/overlay/{n}/uppercase	int 0/1	Set uppercase
/pmix/overlay/{n}/cornerRadius	float	Set background corner radius
/pmix/overlay/{n}/padding	float, float	Set padding (horizontal, vertical)

Examples

# Toggle overlay on slot 2
oscsend <ipad-ip> 9000 /pmix/overlay/2/toggle

# Position overlay at top-left
oscsend <ipad-ip> 9000 /pmix/overlay/2/position ff 0.25 0.25

# Scale to 150%
oscsend <ipad-ip> 9000 /pmix/overlay/2/scale f 1.5

# Set text content and style
oscsend <ipad-ip> 9000 /pmix/overlay/3/text s "BREAKING NEWS"
oscsend <ipad-ip> 9000 /pmix/overlay/3/fontSize f 64.0
oscsend <ipad-ip> 9000 /pmix/overlay/3/textColor ffff 1.0 0.0 0.0 1.0
oscsend <ipad-ip> 9000 /pmix/overlay/3/bold i 1
oscsend <ipad-ip> 9000 /pmix/overlay/3/uppercase i 1

# Clear all overlays
oscsend <ipad-ip> 9000 /pmix/overlay/clear