Add support for camera control

[GarthDB]

• I'm submitting a ...
  [ ] bug report
  [x] feature request
  [ ] question about the decisions made in the repository
  [ ] question about how to use this project

• Summary

I'm trying to dig into the Blackmagic Developer documentation and all I can see in the manual are the SDI camera control docs, however, the ATEM software now can control cameras over HDMI (BMPCC 4K, etc). I'm wondering if it is possible to add camera control support to this package.

I'll try throwing some commands at my ATEM Mini connected to a BMPCC 4K and see if I can get anything to work.

I would like the feature if possible. It would be so handy to do simple things like autofocus over a network command.

[Julusian]

This is not something we are likely to implement any time soon, as it could take a bit of work to interpret everything correctly and we dont have any blackmagic cameras to test it with.
However we will happily accept a pr if you want to give it a go. I remember seeing https://github.com/haydendonald/blackmagic-atem-nodered/blob/master/commands/cameraControl.js the other day, which could serve as a good reference/starting point

[GarthDB]

Excellent. Thanks.
I’m curious if the api for hdmi and sdi cameras/stems are the same.

[Julusian]

It is unlikely for them to be different, except for in small areas if they have different functionality

[Julusian]

I have recently been playing around with this in my C# library which has some unit tests, so it should be fairly straightforward to port to typescript.
https://github.com/LibAtem/LibAtem/tree/master/LibAtem/Commands/CameraControl
https://github.com/LibAtem/LibAtem/blob/master/LibAtem.State/Util/CameraControlUtil.cs#L45

[nitsuj102284]

Hi, @Julusian, have you had any progress with porting your code to TS? We would like to get camera control data from the ATEM.

[Julusian]

No, I havent done anything on this. I dont expect to have the time for a couple of months

[nitsuj102284]

@Julusian, are those the only files that had to be added to get the camera control data in your C# library? Assuming that the same could be added for TS.

[Julusian]

@nitsuj102284 There is also https://github.com/LibAtem/LibAtem/blob/master/LibAtem.State/CameraControllerState.cs and https://github.com/LibAtem/LibAtem/blob/master/LibAtem.State/Builder/CameraControllerUpdater.cs which are quite simple.
But yes, if you compare some of the other commands between the two libraries that should give a reference for how to go about porting it.
Unfortunately camera control is a quite annoying one to work with due to how it encodes the data, and the meaning of the enums was quite a bit of guesswork..

[haydendonald]

This is not something we are likely to implement any time soon, as it could take a bit of work to interpret everything correctly and we dont have any blackmagic cameras to test it with.
However we will happily accept a pr if you want to give it a go. I remember seeing https://github.com/haydendonald/blackmagic-atem-nodered/blob/master/commands/cameraControl.js the other day, which could serve as a good reference/starting point

Haha that's my own project :) (I am aiming to move away from development of the specifics of that project)
I can do a PR to add the feature.

Is there any documents on how to add the feature to this project?

[Julusian]

@haydendonald I have written up a bit of a guide on how to write commands for this library https://github.com/nrkno/tv-automation-atem-connection/blob/master/.github/CONTRIBUTING.md#api-stability

Let me know if anything is lacking or needs clarifying, I have probably overlooked something or am forgetting bits which are obvious to me :)

[nitsuj102284]

This is not something we are likely to implement any time soon, as it could take a bit of work to interpret everything correctly and we dont have any blackmagic cameras to test it with.
However we will happily accept a pr if you want to give it a go. I remember seeing https://github.com/haydendonald/blackmagic-atem-nodered/blob/master/commands/cameraControl.js the other day, which could serve as a good reference/starting point

Haha that's my own project :) (I am aiming to move away from development of the specifics of that project)
I can do a PR to add the feature.

Is there any documents on how to add the feature to this project?

@haydendonald, have you had any progress on adding the feature?

[haydendonald]

This is not something we are likely to implement any time soon, as it could take a bit of work to interpret everything correctly and we dont have any blackmagic cameras to test it with.
However we will happily accept a pr if you want to give it a go. I remember seeing https://github.com/haydendonald/blackmagic-atem-nodered/blob/master/commands/cameraControl.js the other day, which could serve as a good reference/starting point

Haha that's my own project :) (I am aiming to move away from development of the specifics of that project)
I can do a PR to add the feature.
Is there any documents on how to add the feature to this project?

@haydendonald, have you had any progress on adding the feature?

I have had some success but have not been able to test/implement all the features. I'll do a pull request but i'm not sure if it's good enough as features are not fully/correctly implemented and there may be bugs. (We are currently using it for a CCU and switcher)

You can grab it on my git as i forked it.