QLab 3 OSC Video Effect Controls

Tips & Tricks

Colors can't be sent over OSC. This is something that may change, but for now, those inputs won't respond to incoming OSC, which only sends strings and numbers.

"Input X" and "Input Y" are protocol inputs for the Quartz Composer Image Filter protocol, which QLab uses. As such, their key strings are "_protocolInput_X" and "_protocolInput_Y". It's not pretty, and it's not clear what's going on, so those key strings are in the Notes column below.

Color Controls

OSC Select Cue: /cue/{number}/doEffect 1

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Saturation 0 2
Brightness -1 1
Contrast .250 4.0
Hue_Angle -180 180

Exposure

OSC Select Cue: /cue/{number}/doEffect 2

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Exposure_Value -10 10

Gamma

OSC Select Cue: /cue/{number}/doEffect 3

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Power .100 3

Sepia Monochrome

OSC Select Cue: /cue/{number}/doEffect 4

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 1 0 = Sepia 1 = Monochrome
Intensity 0 1
Color .? ?

Min Max Invert

OSC Select Cue: /cue/{number}/doEffect 5

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 3 0 = Minimum Component 1 = Maximum Component 2 = Color Invert

White Point

OSC Select Cue: /cue/{number}/doEffect 6

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Color ? ?

Box / Disc / Gaussian Blurs

OSC Select Cue: /cue/{number}/doEffect 7

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Blur 0 2 0 = Box Blur 1 = Disc Blur 2 = Gaussian Blur
Radius 0 100

Motion Blur

OSC Select Cue: /cue/{number}/doEffect 8

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Angle -180 180
Radius 0 100

Sharpen Luminance

OSC Select Cue: /cue/{number}/doEffect 9

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Sharpness 0 2

Unsharp Mask

OSC Select Cue: /cue/{number}/doEffect 10

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Radius 0 100
Intensity 0 1

Zoom Blur

OSC Select Cue: /cue/{number}/doEffect 11

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Amount 0 200

Pixellation

OSC Select Cue: /cue/{number}/doEffect 12

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 1 0 = Pixellate 1 = Hexagonal Pixellate
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Scale 1 100

Screen

OSC Select Cue: /cue/{number}/doEffect 13

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 3 0 = Dot Screen 1 = Line Screen 2 = Hatched Screen 3 = Circular Screen
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Scale 1 100
Angle -180 180
Width 2 50
Sharpness 0 1

Zoom Blur

OSC Select Cue: /cue/{number}/doEffect 14

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 1 0 = Bloom 1 = Gloom
Radius 0 100
Intensity 0 1

CMYK Halftone

OSC Select Cue: /cue/{number}/doEffect 15

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Input X ? ? _protocolInput_X
Input Y ? ? _protocolInput_Y
Width 2 100
Angle -180 180
Sharpness 0 1
Gray_Component_Replacement 0 100
Under_Color_Removal 0 1

Color Posterize

OSC Select Cue: /cue/{number}/doEffect 16

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Levels 2 30

Crystalize and Pointillize

OSC Select Cue: /cue/{number}/doEffect 17

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 1 0 = Crystallize 1 = Pointillize
Input X ? ? _protocolInput_X
Input Y ? ? _protocolInput_Y
Radius 1 100

Edge Work

OSC Select Cue: /cue/{number}/doEffect 18

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 1 0 = Edge Work 1 = Edges
Radius 0 20
Intensity 0 10

Kaleidoscope

OSC Select Cue: /cue/{number}/doEffect 19

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Count 1 64
Angle -180 180

Median and Comic Effect

OSC Select Cue: /cue/{number}/doEffect 20

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 1 0 = Median 1 = Comic Effect

Noise Reduction

OSC Select Cue: /cue/{number}/doEffect 21

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Noise_Level 0 1
Intensity 0 2

Circle Splash / Hole Distortion

OSC Select Cue: /cue/{number}/doEffect 22

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 1 0 = Circle Splash 1 = Hole
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Radius 0 1000

Pinch / Bump Distortion

OSC Select Cue: /cue/{number}/doEffect 23

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 2 0 = Pinch 1 = Bump 2 = Bump Linear
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Radius 1 600
Scale 0 2
Angle_Bump_Linear 0 360 keystring unknown

Torus / Lens Distortion

OSC Select Cue: /cue/{number}/doEffect 24

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Radius 0 500
Width 0 200
Refraction -5 5

Twirl / Circular Wrap / Vortex

OSC Select Cue: /cue/{number}/doEffect 25

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 2 0 = Twirl 1 = Circular Wrap 2 = Vortex
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Radius 1 800
Angle -180 180

Glass Lozenge

OSC Select Cue: /cue/{number}/doEffect 26

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Point_1_X 0 1
Point_1_Y 0 1
Point_2_X 0 1
Point_2_Y 0 1
Radius 0 1000
Refraction -5 5

Op Tile

OSC Select Cue: /cue/{number}/doEffect 27

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Scale .1 10
Angle -180 180
Width 1 1000

Perspective Tile

OSC Select Cue: /cue/{number}/doEffect 28

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Top_Left_X 0 1
Top_Left_Y 0 1
Top_Right_X 0 1
Top_Right_Y 0 1
Bottom_RIght_X 0 1
Bottom_Right_Y 0 1
Bottom_Left_X 0 1
Bottom_Left_Y 0 1

Quad Tile

OSC Select Cue: /cue/{number}/doEffect 29

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 2 0 = Fourfold Translated Tile 1 = Fourfold Reflected Tile 2 = Parallelogram Tile
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Angle -180 180
Acute Angle -180 180
Width 1 200

Reflected Tile

OSC Select Cue: /cue/{number}/doEffect 30

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 3 0 = Glide Reflected Tile 1 = Sixfold Reflected Tile
2 = Eightfold Reflected Tile 3 = Twelvefold Reflected Tile
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Angle -180 180
Width 1 200

Rotated Tile

OSC Select Cue: /cue/{number}/doEffect 31

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max Notes
Choose_Effect 0 2 0 = Triangle Tile 1 = Fourfold Rotated Tile 2 = Sixfold Rotated Tile
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Angle -180 180
Width 1 200

Titles

OSC Select Cue: /cue/{number}/doEffect 32

OSC Change Parameter: /cue/{number]/effectSet {keystring} value

{keystring} Value Min Value Max
Text n/a n/a Text in double quotes. "Hello World"
Font_Name n/a n/a Font Name* in double quotes "Comic Sans"
Font_Size 0 600
Input X 0 1 _protocolInput_X
Input Y 0 1 _protocolInput_Y
Text_Color ? ?
Show_Cue_Image 0 1 0 = Off 1=On
Blend_Mode 0 21 0 = Addition

1 = Color Blend Mode

2 = Color Burn Blend Mode

3 = Color Dodge Blend Mode

4 = Darken Blend Mode

5 = Difference Blend Mode

6 = Exclusion Blend Mode

7 = Hard Light Blend Mode

8 = Hue Blend Mode

9 = Lighten Blend Mode

10 = Luminosity Blend Mode

11 = Maximum

12 = Minimum

13 = Multiply

14 = Overlay Blend Mode

15 = Saturation Blend Mode

16 = Screen Blend Mode

17 = Soft Light Blend Mode

18 = Source Atop

19 = Source In

20 = Source Out

21 = Source Over

|

*Get the font's name from Font Book.app, in your /Applications/Utilities folder. It's the "PostScript name".