Both Modes
Both modes have two Fields that will always appear.
The Scene Field controls the scene to use. Choose the scene where the source you would like to modify or listen to is located. The Actions below will only impact the sources within the selected scene.
The Source Field controls which source within the selected scene the Action should operate on. This Field is required for any of the Actions below to function properly. These Actions will not impact usage of the source in other scenes than the selected scene.
The Actions below are designed to allow MIDI devices to control these aspects of sources without having to do it manually. Thus, it is expected that you know the functions and use cases of these Actions within OBS Studio before integrating them in a Binding.
Input Mode
Visibility
This input Action changes the visibility of the selected source within the selected scene. The Visibility icon in the Sources dock within OBS Studio will be updated accordingly.
The Visibility output Field controls what visibility to listen for.
Locking
This input Action changes the lock status of the selected source within the selected scene. The Lock icon in the Sources dock within OBS Studio will be updated accordingly.
The Lock Status output Field controls what lock status to listen for.
Position
This input Action changes the position of the selected source on the selected scene. This Action acts just like when editing the Position fields in the transform window within OBS Studio.
The Position output Fields control where to place the selected source on the selected scene using the xy-coordinate system. The origin is located in the top left corner with values increasing from left to right and top to bottom. Values can range from -90,000 to 90,000 in each direction as OBS Studio’s transform window allows.
Scale
This input Action changes the scale of the selected source on the selected scene.
The Scale output Fields control how big the selected source should appear on the selected scene using a percentage system. A scale value of 100% in either direction indicates the source is rendered at its native resolution in that direction. For example, a 1080p camera with a 100% scale will be rendered on the selected scene as 1920x1080. Values for these Fields can be as large as the OBS canvas allows, and can also be negative to allow inverse scaling.
The semantics of this Action have changed many times - this should be the final such change.
Rotation
This input Action changes the rotation of the selected source on the selected scene. This Action acts just like when editing the Rotation field in the transform window within OBS Studio.
The Rotation output Field controls the rotation of the selected source on the selected scene. Values are represented in degrees from 0-360, and will rotate in the clockwise direction as the values increase.
Crop
This input Action changes the cropping box of the selected source on the selected scene. This Action acts just like when editing the Crop fields in the transform window within OBS Studio.
The Crop output Fields control the crop distances of the selected source on the selected scene in their respective directions. Values can only be as large as the native resolution of the source.
Alignment
This input Action changes the positional alignment of the selected source on the selected scene. This Action acts just like when editing the Positional Alignment field in the transform window within OBS Studio.
The Positional Alignment output Field controls the positional alignment of the selected source on the selected scene. This is just where the position coordinates are placed relative to the source rendering.
Scale Filtering
This input Action changes the scale filtering of the selected source on the selected scene. This Action acts just like when editing the Scale Filtering field within OBS Studio.
The Scale Filtering output Field controls the scale filtering of the selected source on the selected scene.
Blending Mode
This input Action changes the blending mode of the selected source on the selected scene. This Action acts just like when editing the Blending Mode field within OBS Studio.
The Blending Mode output Field controls the blending mode of the selected source on the selected scene.
Bounding Box Type
This input Action changes the bounding box of the selected source on the selected scene. This Action acts just like when editing the Bounding Box field in the transform window within OBS Studio.
The Bounding Box Type output Field controls the bounding box of the selected source on the selected scene.
Bounding Box Size
This input Action changes the size of the bounding box of the selected source on the selected scene. This Action acts just like when editing the Bounding Box Size fields in the transform window within OBS Studio.
The Size output Fields control the bounding box size of the selected source on the selected scene.
Bounding Box Alignment
This input Action changes the alignment of the bounding box of the selected source on the selected scene. This Action acts just like when editing the Alignment in Bounding Box field in the transform window within OBS Studio.
The Alignment output Field controls the alignment of the bounding box of the selected source on the selected scene.
Output Mode
Visibility Changed
This output Action occurs when the visibility of the selected source within the selected scene changes, usually when the Visibility icon in the Sources dock within OBS Studio is clicked.
The Visibility input Field controls what visibility to listen for.
Locked
This output Action occurs when the lock status of the selected source within the selected scene changes, usually when the Lock icon in the Sources dock within OBS Studio is clicked.
The Lock Status input Field controls what lock status to listen for.
Position Changed
This output Action occurs when the position of the selected source on the selected scene changes, usually when the source is moved around.
The Position input Fields control what positions are valid using the xy-coordinate system. The origin is located in the top left corner with values increasing from left to right and top to bottom. Values can range from -90,000 to 90,000 in each direction as OBS Studio’s transform window allows.
Scale Changed
This output Action occurs when the scale of the selected source on the selected scene changes.
The Scale input Fields control what scale values are valid using a percentage system. A scale value of 100% in either direction indicates the source is rendered at its native resolution in that direction. For example, a 1080p camera with a 100% scale will be rendered on the selected scene as 1920x1080. Values for these Fields can be as large as the OBS canvas allows, and can also be negative.
Rotated
This output Action occurs when the selected source on the selected scene is rotated.
The Rotation input Field controls what rotations are valid. Values are represented in degrees from 0-360.
Crop Changed
This output Action occurs when the cropping box of the selected source on the selected scene changes.
The Crop input Fields control what crop distances are valid. Values can only be as large as the native resolution of the source.
Realigned
This output Action occurs when the positional alignment of the selected source on the selected scene changes.
The Positional Alignment input Field controls what positional alignments are valid.
Scale Filtering Changed
This output Action occurs when the scale filtering of the selected source on the selected scene changes.
The Scale Filtering input Field controls what scale filterings are valid.
Blending Mode Changed
This output Action occurs when the blending mode of the selected source on the selected scene changes.
The Blending Mode input Field controls what blending modes are valid.
Bounding Box Type Changed
This output Action occurs when the bounding box of the selected source on the selected scene changes.
The Bounding Box Type input Field controls what bounding box types are valid.
Bounding Box Resized
This output Action occurs when the size of the bounding box of the selected source on the selected scene changes.
The Size input Fields control what bounding box size dimensions are valid.
Bounding Box Realigned
This output Action occurs when the alignment of the bounding box of the selected source on the selected scene changes.
The Alignment input Field controls what bounding box alignments are valid.