feat: 998: Add support for Apple ProRes decode SDK on Linux and Windows

[dpmacri]

Linked issues

Fixes #998

Summarize your change.

This change enables support for building in ProRes decode using the ProRes SDK provided by Apple (get freely by e-mailing prores@apple.com). The SDK is used only on Linux and Windows and is enabled by adding:
-DRV_DEPS_APPLE_PRORES_SDK_ZIP_PATH='<full path to SDK .zip file>' and
-DRV_FFMPEG_NON_FREE_DECODERS_TO_ENABLE="prores" to the rvcfg command.

The FFMPEG bit is needed to enable FFMPEG to allow the file type. The decoding is then done by calling out to the SDK from within MovieFFMpeg.cpp file via small wrappers in the newly added AppleProRes.cpp/.h files.

Describe the reason for the change.

To provide official support for ProRes decode on Linux and Windows.

Describe what you have tested and on which operating system.

Tested ProRes 422 and 4444 playback on Linux (Ubuntu 2024.04.1 LTS) and Windows 11. Also verified that macOS, which doesn't use this path, still builds and functions correctly.

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: dpmacri / name: Dean Macri (f4eb786)
• ✅ login: dpmacri / name: dpmacri (2ffde98)

[cedrik-fuoco-adsk]

Hi @dpmacri, I tried your branch with a media (ProRes 4444) and I got a lot of errors when loading the media:

...
ERROR: Expected to decode 5543936 bytes but decoded 5543305
ERROR: Expected to decode 5539840 bytes but decoded 5538668
ERROR: Expected to decode 5541888 bytes but decoded 5540534
ERROR: Expected to decode 5537792 bytes but decoded 5537523
ERROR: Expected to decode 5545984 bytes but decoded 5544803
ERROR: Expected to decode 5543936 bytes but decoded 5542725
ERROR: Expected to decode 5556224 bytes but decoded 5555950
...

My solution was the following changes:

Suggested change

	// Now decode the frame
	int bytesDecoded = PRDecodeFrame(prdecoder, videoPacket->data, videoPacket->size, &prpixbuf, kPRFullSize, 0);
	if (bytesDecoded != videoPacket->size)
	{
	av_log(avctx, AV_LOG_ERROR, "Expected to decode %d bytes but decoded %d\n", videoPacket->size, bytesDecoded);
	assert(0);
	return AVERROR(EINVAL);
	}
	// Now decode the frame
	// PRDecodeFrame returns the number of bytes consumed from the compressed
	// buffer, which may be less than videoPacket->size because the container
	// (MOV, MXF, MKV, etc.) can report a larger sample size than the actual
	// ProRes frame.  A negative return value indicates a decode error.
	int bytesDecoded = PRDecodeFrame(prdecoder, videoPacket->data, videoPacket->size, &prpixbuf, kPRFullSize, 0);
	if (bytesDecoded <= 0)
	{
	av_log(avctx, AV_LOG_ERROR, "PRDecodeFrame failed: returned %d (packet size %d)\n", bytesDecoded, videoPacket->size);
	return AVERROR(EINVAL);
	}