Get Scene Item Properties

Get the source properties of a scene item

Parameters

Connectionrequired
Select

Select the configured OBS Studio Connection to connect to

  • Select Any to trigger on any connection
Scenerequired
String

Select the scene from this dropdown list, you can also manually enter a scene name.

Sourcerequired
String

Select the source from this dropdown list, you can also manually enter a scene name.

Variables

The following variables will be populated after executing this sub-action:

DescriptionExample
props._jsonstring

Everything above in a json format

props.bounds.alignmentstring

The alignment of the bounding box

props.bounds.typestring

The type of bounding box

OBS_BOUNDS_STRETCH, OBS_BOUNDS_SCALE_INNER, OBS_BOUNDS_SCALE_OUTER, OBS_BOUNDS_SCALE_TO_WIDTH, OBS_BOUNDS_SCALE_TO_HEIGHT, OBS_BOUNDS_MAX_ONLY or OBS_BOUNDS_NONE
props.bounds.xnumber

The width of the bounding box

props.bounds.ynumber

The height of the bounding box

props.crop.bottomnumber

The number of pixels cropped off the bottom of the source before scaling

props.crop.leftnumber

The number of pixels cropped off the left of the source before scaling

props.crop.rightnumber

The number of pixels cropped off the right of the source before scaling

props.crop.topnumber

The number of pixels cropped off the top of the source before scaling

props.groupChildren[#].<one of these above>any

List of children (if this item is a group)

props.heightnumber

Scene item height (base source height multiplied by the vertical scaling factor)

props.itemIdstring

The scene Item id

props.lockedboolean

If the source's transform is locked

true
props.message-idstring

The id of the message

props.mutedboolean

If the source is muted

true
props.namestring

Scene Item name

props.position.alignmentstring

The point on the source that the item is manipulated from. The sum of 1=Left or 2=Right, and 4=Top or 8=Bottom, or omit to centre on that axis

props.position.xnumber

The x position of the source from the left

props.position.ynumber

The y position of the source from the top

props.rotationnumber

The clockwise rotation of the item in degrees around the point of alignment

props.scale.filterstring

The scale filter of the source

OBS_SCALE_DISABLE, OBS_SCALE_POINT, OBS_SCALE_BICUBIC, OBS_SCALE_BILINEAR, OBS_SCALE_LANCZOS or OBS_SCALE_AREA
props.scale.xnumber

The x-scale factor of the source

props.scale.ynumber

The y-scale factor of the source

props.sourceHeightnumber

Base source (without scaling) of the source

props.sourceWidthnumber

Base width (without scaling) of the source

props.statusstring

The status of the sub-action

props.visibleboolean

If the source is visible

true
props.widthnumber

Scene item width (base source width multiplied by the horizontal scaling factor)

C# Usage

public string ObsGetSceneItemProperties(string scene, string source, int connection = 0)