An(other?) ATEM DVE Animation Generator

Questions about ATEM Switchers, Camera Converter and everything live!
  • Author
  • Message
Offline

pancake

  • Posts: 20
  • Joined: Mon Nov 29, 2021 6:55 am
  • Real Name: Karel de Bakker

An(other?) ATEM DVE Animation Generator

PostFri Dec 24, 2021 10:50 am

ATEM-DVE-Animation-Generator.png
Animation Generator GUI
ATEM-DVE-Animation-Generator.png (109.99 KiB) Viewed 1511 times


What is it?
It's a two-keyframe animation tool for ATEM Mini series switchers. It animates (DVE) keyers or Supersource boxes. The animations themselves run on the switcher through macro's that the tool exports.
I created this in the past 10 days. It took that much time because I set myself a few interesting challenges:
  • Should have no dependencies or third party code, so it's entirely frameworkless
  • Should not rely on external content (on other words: makes no HTTP calls, ever, in other words, runs perfectly on a local machine disconnected from the interwebs)
  • Should come in one self-contained HTML file with inline CSS and JavaScript

Requirements: only a modern web browser (Safari, Chrome, Firefox, Edge).

People will probably comment that tools like this exist. I have only found a British guy that runs easing animations through the ATEM API through an Arduino (ouch!), and I looked a few seconds at a YouTube video from someone who animated Supersource boxes. But those were linear animations, so I stopped watching after three seconds. Linear animations are in the ATEM, they hurt my eyes. Besides, using something that already exists, where's the fun in that? ;)

There's still a lot to improve and test, but have a go at it:

https://pimz.com/ATEM/ATEM-DVE-Animation-generator.html

Yeah, that runs online. You can just save the file (choose "Save as..." in your web browser) for offline use and it will work.

device_animate.png
device_animate.png (3.78 KiB) Viewed 1511 times

Every "device" and "animate" combo has its own set of animation presets.

animation_presets.png
animation_presets.png (8.27 KiB) Viewed 1511 times

You can create your own presets, delete the defaults, etc. Keep in mind that loading a preset (shortcut: doubleclick its name in the list) will overwrite what you currently have on stage. The default presets were created for 30fps, so they run too fast for 60fps, but you could double the number of frames in the animation properties.

Will continue in following message, because three attachments is the max...
Last edited by pancake on Fri Dec 24, 2021 11:33 am, edited 2 times in total.
Offline

pancake

  • Posts: 20
  • Joined: Mon Nov 29, 2021 6:55 am
  • Real Name: Karel de Bakker

Re: An(other?) ATEM DVE Animation Generator

PostFri Dec 24, 2021 11:01 am

animation_properties.png
animation_properties.png (13.69 KiB) Viewed 1398 times

"Animation properties" is a mini-spreadsheet where the values of the seven properties that can be animated are listed, in their "from" and "to" keyframes. In addition, there's the option to define the number of frames in which this has to happen, and a delay (in frames).
When you click in a cell in the "from" or "to" column, and there is a deviation in their values, the curve-editor will become active:

curve_presets.png
curve_presets.png (10.06 KiB) Viewed 1398 times

It's just a cubic Bezier curve with two handles, which is quite limiting in terms of complex animations. I've created a far more advanced curve editor for a different project in the past (written in Cocoa, for macOS), and that might have been nice here too. But then I thought: "it's just some boxes that need to move on screen", and I stuck with this. If you're in dire need for more complex animation, then let me know and I'll look into adding a more advanced curve editor.

download.png
download.png (4.08 KiB) Viewed 1398 times

And then, when you're happy with the animation you've created, it's time to download it as an ATEM macro file. Just type in a name and an index (it's 1-based, so index 1 is the first macro on the macro pane in ATEM Software control or the "1" macro button on the Extreme). Your web browser will probably bark at you because of security concerns downloading an XML file, but you can train it to keep quiet.

In general, it takes me less than 4 seconds to download an animation from the editor and have it uploaded ("restored") to one of our ATEMs through ATEM Software Control.

So yeah, this is my take on how DVE keyframe animations on these switchers should look like. Keyframe animation should definitely not work like the "A/B keyframe" on the machines themselves. Although I'm well aware that that option has a great advantage over macro-driven animations: the values get calculated in real time, so you can change the animation while it's running halfway and things will still end well.

As I've written earlier, I'm impressed with what the ATEM Mini's can do, hardware-wise, but in my opinion there's a lot of room for improvement in the software (either ATEM Software Control or in the machines themselves).

Use it to your advantage, or tell me it's useless, and (hopefully) convince me to improve it... :D
Last edited by pancake on Fri Dec 24, 2021 12:14 pm, edited 3 times in total.
Offline
User avatar

Roman Pytkin Pekarek

  • Posts: 2049
  • Joined: Tue Oct 30, 2012 1:11 pm
  • Location: SVK

Re: An(other?) ATEM DVE Animation Generator

PostSat Dec 25, 2021 12:25 am

Nice work .. How about support for nonMINI ATEMs ?
http://tally.pytkin.sk
http://chucktv.eu
http://www.stonepp.tv
http://www.media-planet.sk
Offline

pancake

  • Posts: 20
  • Joined: Mon Nov 29, 2021 6:55 am
  • Real Name: Karel de Bakker

Re: An(other?) ATEM DVE Animation Generator

PostSat Dec 25, 2021 6:42 am

Roman Pytkin Pekarek wrote:How about support for nonMINI ATEMs ?

I've been thinking about that. There will be a few issues I'd have to solve, which I think are not really difficult:
  • I'd need to know the exact name of the device how it gets written in the macro files
  • I'd need to know the number of "mixEffectBlocks" for the "mixEffectBlockIndex" for that device, and you'd have to be able to choose this.
  • I'd need to know the number of keyers for each mixEffectBlock
  • I'd need to know the number of Supersources in the device
Can I find this easily somewhere?

But you can already just import a macro that this "app" generates, and you'll just get a warning that the macro was for a different device. But it will always be for mixEffectBlock 0, because the ATEM Mini's don't have more of these.
Offline

Jeff P

  • Posts: 81
  • Joined: Wed Sep 01, 2021 2:50 pm
  • Location: Maine, USA
  • Real Name: Jeff Pierce

Re: An(other?) ATEM DVE Animation Generator

PostSat Dec 25, 2021 2:01 pm

Wow, nicely done Karel.

I have to admit, when I first read your post I didn't quite understand the functionality. But when I loaded the tool and began playing around with it, I got it immediately. Your UI is very intuitive.

Thanks for doing this!
Offline

pancake

  • Posts: 20
  • Joined: Mon Nov 29, 2021 6:55 am
  • Real Name: Karel de Bakker

Re: An(other?) ATEM DVE Animation Generator

PostSat Dec 25, 2021 5:17 pm

Jeff P wrote:Wow, nicely done Karel.

Thanks Jeff! You sort of challenged me to create this in the thread about the keyers limitation (turned out to be a DVE limitation) ;)
Jeff P wrote:I have to admit, when I first read your post I didn't quite understand the functionality.

Yeah, it's not that straightforward to explain, even to people who know their ATEM stuff. I tried to explain to my girlfriend what I'd been up to for the past 10 days, but I gave up. "Moving some boxes around on screen, nicely"...

BTW, had a brief look at MixEffect you pointed me to. I haven't found the time to run it on my iPad yet, but from the App Store screenshots it indeed seems like a nice piece of work. Interestingly, the developer came to a couple of the exact same conclusions I did: "you need Supersource presets" and "all four Supersource boxes need a different colour in the UI". Will check it out, hopefully tomorrow.
Offline

Gert

  • Posts: 20
  • Joined: Sat Apr 06, 2013 4:01 pm
  • Location: Herpen, Netherlands

Re: An(other?) ATEM DVE Animation Generator

PostMon Dec 27, 2021 3:08 pm

Roman Pytkin Pekarek wrote:Nice work .. How about support for nonMINI ATEMs ?


+1
Atem 2M/E 4K; Atem 4M/E 4K; 10x Panasonic PTZ camera's; Panasonic RP150 Controller; Panasonic RP 60 controller; 3x Panasonic PX270; 3x Hyperdeck mini; Cleanswitch 12x12; Smartscope 4K; Videoassist 4k
Offline

pancake

  • Posts: 20
  • Joined: Mon Nov 29, 2021 6:55 am
  • Real Name: Karel de Bakker

Re: An(other?) ATEM DVE Animation Generator

PostMon Jan 03, 2022 4:25 pm

Roman Pytkin Pekarek wrote:How about support for nonMINI ATEMs ?
As I wrote earlier: I'd need to know the names for those devices to get them right into the generated macros. But for v0.2 I just scanned for the names for all supported devices in the macOS "ATEM Software Control" binary blob, because obviously, the software itself will have to know the supported device names, and the strings didn't seem to be mangled (why would they be?).

I ended up with:
  • ATEM Mini
  • ATEM Mini Pro
  • ATEM Mini Pro ISO
  • ATEM Mini Extreme
  • ATEM Mini Extreme ISO
  • ATEM Television Studio
  • ATEM 1 M/E Production Switcher
  • ATEM 2 M/E Production Switcher
  • ATEM Production Studio 4K
  • ATEM 1 M/E Production Studio 4K
  • ATEM 2 M/E Production Studio 4K
  • ATEM 2 M/E Broadcast Studio 4K
  • ATEM 4 M/E Broadcast Studio 4K
  • ATEM Television Studio HD
  • ATEM Television Studio Pro HD
  • ATEM Television Studio Pro 4K
  • ATEM Constellation 8K
After thinking some more about the remark from Roman in another thread ("But U have SuperSource too , with 4 DVEs (totaly 6 DVEs)"), I figured it might be fun to just mix and match the boxes from both the keyers and the Supersource (when present). I can now effectively animate 2 keyers and 4 boxes simultaneously on a Mini Extreme:

sixboxes.gif
sixboxes.gif (38.64 KiB) Viewed 947 times

Obviously, the keyers will be on top, and the Supersource has to be on air.
Note the "Switcher" dropdown menu at the top. This is for 2 M/E and 4 M/E ATEMs. Basically, you can create animations and save presets on each M/E individually. They're being remembered/saved at the M/E level.

Neat new feature: set the input for your boxes and save this in the generated macro:

setsource.gif
setsource.gif (21.78 KiB) Viewed 947 times

It's a bit hidden away, below the animation curve presets.

NOTE: I quickly glanced over the specs from most of the ATEMs on the BMD website to find the number of keyers, cameras, color generators, etc. But the list I created will probably not be accurate/complete (some of the supported devices aren't listed on the BMD website anymore). If your ATEM seems to be missing features, then just post the right numbers here, like this:
Code: Select all
production_st4k: {
   name: 'ATEM Production Studio 4K',
   switchers: 1,
   keyers: 1,
   supersource: 0,
   cameras: 8,
   mediaplayers: 2,
   colors: 2
   },

But note that the software only supports one Supersource (index 0) for now (as far as I can tell, only the Constellation has 2 Supersources).

Check it out and let me know if you can use it: https://pimz.com/ATEM
Offline
User avatar

Roman Pytkin Pekarek

  • Posts: 2049
  • Joined: Tue Oct 30, 2012 1:11 pm
  • Location: SVK

Re: An(other?) ATEM DVE Animation Generator

PostTue Jan 04, 2022 12:08 am

Good Job
http://tally.pytkin.sk
http://chucktv.eu
http://www.stonepp.tv
http://www.media-planet.sk
Offline
User avatar

Tobias Dieterich

  • Posts: 131
  • Joined: Tue Nov 27, 2012 8:51 am
  • Location: Friedrichshafen, Germany

Re: An(other?) ATEM DVE Animation Generator

PostFri Jun 24, 2022 6:06 pm

Hey,

could you update the tool for the new Constellation HD 2M/E and 4 M/E?
Tobias Dieterich | T.D. Video Engineering | www.tdvideo.de
Offline

pancake

  • Posts: 20
  • Joined: Mon Nov 29, 2021 6:55 am
  • Real Name: Karel de Bakker

Re: An(other?) ATEM DVE Animation Generator

PostMon Jun 27, 2022 5:56 am

Tobias Dieterich wrote:could you update the tool for the new Constellation HD 2M/E and 4 M/E?

Just got PM'd with this question, I'm not getting any notifications from this thread anymore (not sure why).

If you want your switcher supported, just post the data I'm requesting a few posts back.
Offline

DavisJones

  • Posts: 12
  • Joined: Sat Sep 11, 2021 11:26 pm
  • Real Name: Davis Jones

Re: An(other?) ATEM DVE Animation Generator

PostMon Jun 27, 2022 6:16 am

pancake wrote:If you want your switcher supported, just post the data I'm requesting a few posts back.

hopefully my 2ME Constellation will arrive soon and I can post the info you need. thanks for checking in.
Offline
User avatar

David_Anderson

  • Posts: 376
  • Joined: Tue Jul 28, 2015 11:24 pm

Re: An(other?) ATEM DVE Animation Generator

PostTue Jun 28, 2022 1:13 am

Don't see any supersource for the ATEM 2 M/E Production studio. Not supported?

Best,

David
David Anderson
Leading Edge Multimedia
https://leadingedgemultimedia.com
(888) 336-LEMM

Return to Live Production

Who is online

Users browsing this forum: No registered users and 24 guests