MiruSuite Docs

Appearance

Other components ​

vMix Framer AutoCut ​

The vMix Framer component controls vMix to adjust an input's Pan X and Pan Y positions based on a target person's location in the image. This can be useful if your production requires automated cropping, e.g. from a 16:9 feed to a vertical 9:16 feed. Using the vMix Framer requires a video input and a person tracker component to be installed. Setup your vMix connection in the Switcher tab.

Available settings:

  • Control mode:
    • Automatic: The frame is automatically adjusted based on the target person's position.
    • Manual: The frame is only adjusted when the Adjust button is pressed.
  • Frame width: The width of the crop frame, relative to the width of the input frame. Acceptable values are in range 0-1.
  • Frame height: The height of the crop frame, relative to the height of the input frame. Acceptable values are in range 0-1.
  • vMix Input: This vMix input's Pan X and Pan Y properties will be manipulated to make the crop frame 'move' in vMix. The crop frame will be the bottom left part of this input with width and height as defined above.
  • vMix Layer: Select the input's overlay to manipulate in vMix. By default the main layer will be adjusted, but you can also choose to adjust any of the overlays 1-10.
  • Smooth framing: If enabled, the crop frame will move smoothly to the next position without jumping, simulating a real camera. This is ideal for slower movement. If disabled, the frame will always jump to the optimal position. More fast-paced settings might benefit from this.
    • Speed: Maximum movement speed of the frame. Ignored when smooth framing is disabled.
    • Sensitive Area: Width of the tracking border area relative to the input frame width. The crop frame is adjusted only when the target person is within this space. Smaller values keep the frame more stable, larger values make it more reactive. Ignored when smooth framing is disabled.
  • Return to center when lost: Return to the center position when the tracked subject is lost. If disabled, the frame will stay in position.

Positional Trigger AutoCut ​

The Positional Trigger component automatically switches to the device's switcher input when the Person Tracker's target person enters a configured trigger area. The trigger area is defined in PTZ space and can be learned directly from the current camera position. An optional delay prevents accidental cuts by requiring the person to remain inside the area for a set duration before the switch happens.

INFO

The Positional Trigger works independently from AutoCut. It can be used alongside any director or AutoCut role.

Available settings:

  • Delay: Set how long (in seconds, between 0 and 60) the target person must stay inside the trigger area before the switch is executed. A delay of 0 triggers the switch instantly when the person enters the area.

    TIP

    Use a small delay (e.g. 1–2 seconds) to avoid accidental triggers caused by the person briefly passing through the area.

  • Learn trigger area: Click the buttons to learn the left, top, right, or bottom border of the trigger area from the current camera position. Move the camera to the desired boundary and click the corresponding button to store it. Click the delete icon to remove all trigger area limits.

    WARNING

    The trigger area is defined in PTZ space (pan/tilt angles). The buttons learn the camera's borders, not the current target person's position! Make sure a PTZ Controller component is installed on the device before learning the area borders.

Requirements — the component will show an error state if any of the following are not met:

  • A switcher must be connected.
  • A switcher input must be configured for this device.
  • At least one trigger area border must be set manually or learned using the Learn buttons.

INFO

If no Person Tracker is installed on the device, the component will show a warning but remain enabled. No trigger will fire until a Person Tracker is added.

When the trigger fires, a notification will appear in MiruSuite confirming which switcher input was switched to.

AutoCut Roles AutoCut ​

These are marker component required to use AutoCut. They tell AutoCut the purpose of this device. Every device can have at most one role. The component checks if the required dependencies for this role are met and suggests adding missing components. For more information on AutoCut, see the AutoCut page.