Blackmagic Television Studio HD DVE features

I’m loving having DVE capability in the new ATEM TVS HD. It is not as rich as the ATEM 1 and 2 M/E’s but is a big improvement over the old TVS.

Although only a 2D DVE, it provides most of the Key and transition features of the bigger ATEM’s. By far the most useful feature I think is Picture-In-Picture and I was especially surprised to see the TVS HD support flying key.

I have been adding more DVE automation functionality to my PowerShell ATEM Switcher library and will have an update version that supports all TVS HD feature soon (although it will require the 7.0 firmware in all other ATEM’s you might want to automate from PowerShell). A beta 6.9 version of the switcherlib.dll is available from the downloads folder.

Some tips below for people who are new to the DVE capabilities found in the TVS HD.

The position values are defined from the center of the window. Maximum to have the center point hard left or right values are

x:-16.00 to 16.00

y:-9.00 to 9.00

The size of the window

X:0.00 to 1.00

So, if you wanted a ¼ of full screen size (1/2 width and height), the size would be 0.5 (aspect ratio is maintained by default)

And for top left, x= -8 & y= 4.5

In PowerShell I just define these values in an array.


= @(-8,4.5,.5,.5)

= @(8,4.5,.5,.5)

= @(8,-4.5,.5,.5)

= @(-8,-4.5,.5,.5)

Then I have a function you pass the array to




$script:usk1.FlyPositionX = $window[0]

$script:usk1.FlyPositionY = $window[1]

$script:usk1.FlySizeX = $window[2]

$script:usk1.FlySizeY = $window[3]


So to set the IP to top left

setPIPWindow $topLeft

You can also set the border to be a combination of pixels that are inside or outside the DVE window size

The Key Frame option lets you transition the PIP window to a new location.

Unfortunately, you can’t load position and size values directly into the A and B positions. You can only set the current values to one of these 2 so you would have to have the key off air to load up initial values. Once the key is on air you are limited to only the 2 presets, full screen, off screen in one of the 8 directions.

In PowerShell you can save the current position and size with



You can initiate the Fly with




Where the value after :: (which will be shown using intellisense) can be:

  • FlyKeyFrameA
  • FlyKeyFrameB
  • FlyKeyFrameFull
  • FlyKeyFrameInfinityTopLeft
  • FlyKeyFrameInfinityBottomRight
  • FlyKeyFrameInfinityCenter
  • FlyKeyFrameInfinityCenterOfKey
Squeeze the current program item to reveal the preview item.

The DVE transition can be set with PowerShell

$me1.TransitionStyle =

$me1.DVETransitionStyle =

Where the values after the :: can be…

  • SqueezeTopLeft
  • SqueesTop
  • SqueezeTopRight
  • Squeez bottomRight
  • PushTopLeft
  • PushBottomRight

Note: you can’t enable the DVE transition style if the USK key type is set to DVE and is on air.

There is also an option in the DVE transition to have a source that will fly across the screen as part of the transition to preview (Graphic Wipe). This should be a source that has the image you want in the center and transparent background.

The width should be less than 25% of the video standard width with the majority of the image have an alpha transparency (or black background).

For 720p the centre 320 horizontal pixels will be used for vertical strip

I’m yet to implement this in PowerShell.


11 thoughts on “Blackmagic Television Studio HD DVE features

  1. Hi Ian,

    Thanks for the rather astonishingly detailed resources here! I’ve only just discovered them and am slowly wading through.

    I’m looking for some kind of picture-in-picture solution for a live show I produce each month for a client. Currently I do a multi-cam shoot but only send out a single cam via a BMD Web Presenter and edit the streams together after the event, delivering the edit a few days later for online archive.

    The ATEM TVS HD (rack mounted version) seems like it could cut out my edit days and if twinned with a HyperDeck Studio Mini I could have a final program master from a live edit. All sounds wonderful. However I’m entirely new to switchers and am wondering how practical it is to do a P-I-P effect without using PowerShell/similar automated script. I’ll be using Mac and my scripting knowledge is limited. I remember lying awake at night with dread at some scripting involving ffmpeg years ago! I’d be happy to learn but I’m curious about the out-of-the-box usability of the ATEM system. Are there any presets I can load for DVE picture in picture?

    When I edit the multicam footage at the moment I’ll reserve the left hand vertical third of the frame for a cropped mid shot of a speaker talking as they stand next to a projection screen. The right hand vertical two thirds are a 4:3 aspect ratio PowerPoint. The left hand third cuts between different angles. That would probably be sufficient, however in the edited version I usually reverse the left/right sides when the speaker cross the projection screen so if they’re on the right side, I have them on the correct half of the screen with the PowerPoint displaying on the left. Is there a way either using the rack mounted buttons or perhaps the BMD software to quickly switch between those two layouts (left 1/3 – 2/3 to right 1/3 – 2/3)?

    Presumably if so my workflow would look something like:
    Cam 1, Cam 2, Cam 3 via SDI into the ATEM TVS HD;
    Laptop containing PowerPoint activated by a wireless ‘clicker’ into the ATEM TVS HD via HDMI
    Master Laptop running the software into the ATEM TVS HD via Ethernet?
    SDI output from the ATEM into the BMD Web Presenter (potentially containing audio as well or if not a mixed mono output via XLR)
    SDI output from the ATEM into the HyperDeck Studio Mini

    The ATEM TVS HD and the software on the Master Laptop would run and edit the show.

    Master Laptop also doubles as broadcaster (Vimeo/YouTube/ OBS/other Livestreaming service). Presumably it wouldn’t matter what was being displayed on this screen as the Web Presenter is kidding the computer into thinking the whole show is from the webcam.

    The HyperDeck would record it.

    The Web Presenter would stream it.

    Am I missing anything or does that sound right? Apologies for the monster of a post and thanks again for the resources you have here. I’m sure you’ve more than likely already covered the information somewhere on here so I’ll spend the weekend going through it!

    Best wishes,

    1. Sounds like TVS HD is perfect. Just not clear exactly when you would use the PIP and what would be in the PIP window vs the background.
      Unfortunately the ATEM software control keyboard shortcuts only work for simple program/preview cut/fade. If you wanted to change the PiP source quickly it really requires some simple scripting and some type of keypad control (Elgato Stream Deck, Midi device or X-Keys).
      Happy to help you get started with the scripting, hardware list above is perfect and I would probably suggest the Elgato Stream Deck for shortcuts that you can use while live presenting the show.

      1. Hi Ian,

        Thanks for the quick and detailed response. It’s a shame there’s no way to program the keys on the TVS HD to switch PiP or do it via software. Though I don’t think I’d necessarily need to switch the source, just the position. The source will always be a PowerPoint presentation from the same computer via HDMI.

        Basically the main source would be the slide show with the camera as the PiP. Because of the venue it’s almost impossible to expose the slideshow from the projection as well as the speaker so we usually ask the presenter to stand to the left or right of the screen then display a close or mid of the presenter as an overlay/ PiP while the PowerPoint fills the screen. I can send screen shots of previous edited events if it helps.

        If I wasn’t too bothered by switching from left to right position with the PiP would I be OK with just the TVS HD? I’d rather not add too much to my emergency shopping list (the next event is on the 27th of this month! ) : ) i.e. I presume I could just set it up at the beginning and leave it running.

        If it was a requirement to have an additional controller I can look into the Elgato/other. Though I wonder if there’s a similar device that could be rack mounted to either the size of the ATEM (2/3rds) or that fits into the same space as the HyperDeck Studio Mini? I.e. a 1/3 19″ rack? I’d rather not take up more desk space as the area is already quite cramped.

        I’m trying to make something as compact as possible for portability/easy one-person transport (along with the camera gear I have to carry) so if it could fit in a single rack case that would be great.

        Was thinking “1SKB-iSF2U Injection-Molded 2 RU Studio Flyer Rack Case”.

        Master Laptop on top.
        ATEM and HyperDeck Mini on the lower rack row.
        BMD Web Presenter on the upper rack row with 2/3rd remaining as empty space perhaps for a controller if essential, or maybe a pre-amp/mixer if I can find or build one to fit.

        Again, thanks for your patience with my long posts. Appreciate any further guidance.

        Best wishes,

      1. Oh, and easy to move the PiP location using script from a button, can even do it from a keyboard short cut (using the PowerShell Keyboard Hook add-in).

      2. Ha! I don’t doubt it : )

        Thanks for the tip – just stumbled across another video which seems to suggest it’ll do what I want within the software (which is to reposition the same source mid-flow. Not sure if this comment board will allow links so this is the video address after YouTube dot com


        It seems a little clunky I guess to use macros but I think in my context it should do a good enough job… better dust off the credit card. I’ll let you know how I get on!

        Thanks again,

  2. Yes, use a macro. The only issue is running a macro quickly. clicking the mouse on the laptop screen is a bit slow. Nice idea about the 1/3 rack size gadget for macro buttons. Given me an idea for a product 🙂

    1. Hi Ian,

      So I received my ATEM in the post today. All good fun so far (if maddening at times!). I am however wondering if there is a solution to my first major stumbling block.

      I’ve got a laptop sending out a PowerPoint via HDMI as Cam 2. I’ve got a camera sending out video and audio as Cam 1.

      I’ve figured how to mask (via Luma) the camera, to crop it so I’m only showing the centre frame where the speaker is standing (Fill Source Cam 2). I’ve repositioned it to the left of the frame and set that (via Upstream Key 1) as position A (and on the right of frame as position B) with the rate set to 0.00 – this means I can quickly and easily change between positions as required for the camera angle.

      However I can’t seem to be able to re-position my 4:3 aspect ratio PowerPoint behind it? It only stays in the centre meaning I see about 2/3rds of the slide with some black pillar boxes on one side and the video (Cam 1) on the opposite side. It would seem that between Luma/Chroma/Pattern/DVE there must be a way of repositioning and masking 2 seperate layers but it’s hidden from me for now. Do you know of any ‘obvious’ solution? I can’t see a way to create ‘multiple’ upstream keys’.

      What I’d love even more is if I could add another camera into the mix (a wide and a mid) so I could cut quickly to the wide for safety if the framing wasn’t perfect on the mid shot but not sure if that would be another key and in which case it may be one key too many.

      Other fun so far: getting a macbook to output 1080p 50/25 rather than the usual awkward resolutions (SwitchResX seems to work nicely), setting up the ATEM on new computers – I seem to be entering a different IP every time I turn the thing on (which is fine as it does eventually work but is clunky).

      Thanks for your time.

      All the best,

      1. Quick update – the best I’ve found so far is using DVE rather than Luma.

        Fill Source (Cam 2 / the PowerPoint). Get it masked and positioned for Set A & B.

        Then simply frame the camera to the left or right accordingly rather than the usual centre-frame. It’s a bit of a scary option as more potential for speakers walking entirely out of frame but I figure I’ll be recording the rushes anyway including the wide safety so I can always swap out afterwards if needs be.

        I’m going to look into Pattern next as I’m sure it should be possible via that effect too. I’ve also seen a few people discussing “holes” in the background. Presumably they’re referring to the rabbit hole of the ATEM world and a challenge to see how far you can hold your breath into it.

      2. Yea, when cropping the camera shot, you really want to send a return feed to the camera operator so they can see the program out in order to keep the subject in the cropped area.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s