In addition to the published ports required by the Image Filter or Image Generator protocol, you can create other published input ports to appear as parameters in your VJ app.
You can use the following data types for non-protocol published input ports for FFGL plugins:
Data type | Scaled range | Shortened name | Notes |
---|---|---|---|
Real | 0 to 1 | 16 characters | |
2D Point | (0,0) to (1,1) | 14 characters | |
3D Point | (0,0,0) to (1,1,1) | 14 characters | |
4D Point | (0,0,0,0) to (1,1,1,1) | 14 characters | |
Integer | 0 to 1 | 16 characters | |
Boolean | 16 characters | ||
Text | 16 characters | ||
Color | 14 characters | ||
Image | 16 characters | Not supported in Resolume |
Since FFGL limits numeric values to the range 0 to 1, Vuo automatically scales parameter values from that range to the range you’ve specified in your composition (by right-clicking on the published input port, going to
, and editing Suggested Min and Suggested Max). For example, if you have a Real published input port with Suggested Min -10 and Suggested Max 10, your VJ app will show a slider from 0 to 1. Your composition will get an input value of -10 when the slider is at 0, -5 when the slider is at 0.25, and 10 when the slider is at 1.Since FFGL limits parameter names to 16 characters, Vuo shortens names if needed. For 2D, 3D, and 4D Point published input ports, Vuo creates a separate parameter for each coordinate (X, Y, Z, or W) and appends a space and the coordinate name to the parameter name. To fit in these 2 extra characters, Vuo shortens the rest of the name to 14 characters. Similarly, for Color published input ports, Vuo creates a separate parameter for each channel (R, G, B, or A).