From deabfe4ffbd574cdcd0d2af1e6376667d0db896c Mon Sep 17 00:00:00 2001
From: Thorsten Bus <thorsten@buss-labs.de>
Date: Mon, 30 Mar 2026 08:58:48 +0200
Subject: [PATCH] feat(bundle): add .probundle reader, writer, and wrapper for
 presentation bundles

ProPresenter .probundle files are ZIP archives containing a single .pro
presentation with embedded media assets. This adds read/write support
verified against actual ProPresenter 7 exports.

- PresentationBundle: wrapper class (Song + media files + .pro filename)
- ProBundleReader: reads .probundle ZIPs, applies Zip64Fixer for PP exports
- ProBundleWriter: writes standard ZIP with media-first entry order
- ProFileGenerator: media URLs now include URL.local with LocalRelativePath
- 9 tests covering error handling, round-trip, PP export compat, ZIP format
- ref/TestBild.probundle: verified importable by ProPresenter 7
---
 php/bin/regen-test-bundles.php     |  41 ++++
 php/src/PresentationBundle.php     | 107 +++++++++
 php/src/ProBundleReader.php        | 100 ++++++++
 php/src/ProBundleWriter.php        |  77 ++++++
 php/tests/ProBundleTest.php        | 361 +++++++++++++++++++++++++++++
 ref/Media/test-background.png      | Bin 0 -> 717 bytes
 ref/RestBildExportFromPP.probundle | Bin 0 -> 2126 bytes
 ref/TestBild.probundle             | Bin 0 -> 1232 bytes
 8 files changed, 686 insertions(+)
 create mode 100644 php/bin/regen-test-bundles.php
 create mode 100644 php/src/PresentationBundle.php
 create mode 100644 php/src/ProBundleReader.php
 create mode 100644 php/src/ProBundleWriter.php
 create mode 100644 php/tests/ProBundleTest.php
 create mode 100644 ref/Media/test-background.png
 create mode 100644 ref/RestBildExportFromPP.probundle
 create mode 100644 ref/TestBild.probundle

diff --git a/php/bin/regen-test-bundles.php b/php/bin/regen-test-bundles.php
new file mode 100644
index 0000000..7894cfe
--- /dev/null
+++ b/php/bin/regen-test-bundles.php
@@ -0,0 +1,41 @@
+<?php
+
+require_once dirname(__DIR__) . '/vendor/autoload.php';
+
+use ProPresenter\Parser\PresentationBundle;
+use ProPresenter\Parser\ProBundleWriter;
+use ProPresenter\Parser\ProFileGenerator;
+
+$image = imagecreatetruecolor(200, 150);
+$blue = imagecolorallocate($image, 30, 60, 180);
+imagefill($image, 0, 0, $blue);
+$white = imagecolorallocate($image, 255, 255, 255);
+imagestring($image, 5, 10, 10, 'ProPresenter', $white);
+$tmpPng = tempnam(sys_get_temp_dir(), 'testbild-') . '.png';
+imagepng($image, $tmpPng);
+$imageBytes = file_get_contents($tmpPng);
+unlink($tmpPng);
+
+$refDir = dirname(__DIR__, 2) . '/ref';
+$mediaAbsPath = '/Users/thorsten/AI/propresenter/ref/Media/test-background.png';
+
+$song = ProFileGenerator::generate(
+    'TestBild',
+    [
+        [
+            'name' => 'Verse 1',
+            'color' => [0.0, 0.0, 0.0, 1.0],
+            'slides' => [
+                [
+                    'media' => 'file://' . $mediaAbsPath,
+                    'format' => 'png',
+                ],
+            ],
+        ],
+    ],
+    [['name' => 'normal', 'groupNames' => ['Verse 1']]],
+);
+
+$bundle = new PresentationBundle($song, 'TestBild.pro', [$mediaAbsPath => $imageBytes]);
+ProBundleWriter::write($bundle, $refDir . '/TestBild.probundle');
+echo "TestBild.probundle written\n";
diff --git a/php/src/PresentationBundle.php b/php/src/PresentationBundle.php
new file mode 100644
index 0000000..4c6ce24
--- /dev/null
+++ b/php/src/PresentationBundle.php
@@ -0,0 +1,107 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ProPresenter\Parser;
+
+use Rv\Data\Presentation;
+
+/**
+ * Top-level wrapper for a ProPresenter presentation bundle (.probundle).
+ *
+ * A .probundle is a ZIP archive containing a single .pro presentation file
+ * together with all its referenced media assets (images, videos, audio).
+ * This is the Pro7 successor to the Pro6 .pro6x format.
+ *
+ * Archive layout:
+ *   SongName.pro          ← Protobuf-encoded presentation
+ *   Media/image.jpg       ← Referenced media files
+ *   Media/video.mp4
+ */
+class PresentationBundle
+{
+    private Song $song;
+
+    /** @var array<string, string> relative path => raw bytes */
+    private array $mediaFiles;
+
+    private string $proFilename;
+
+    public function __construct(
+        Song $song,
+        string $proFilename,
+        array $mediaFiles = [],
+    ) {
+        $this->song = $song;
+        $this->proFilename = $proFilename;
+        $this->mediaFiles = $mediaFiles;
+    }
+
+    /**
+     * The embedded presentation/song.
+     */
+    public function getSong(): Song
+    {
+        return $this->song;
+    }
+
+    /**
+     * Filename of the .pro file inside the archive.
+     */
+    public function getProFilename(): string
+    {
+        return $this->proFilename;
+    }
+
+    /**
+     * Name of the presentation (from the embedded Song).
+     */
+    public function getName(): string
+    {
+        return $this->song->getName();
+    }
+
+    /**
+     * Access the underlying protobuf Presentation.
+     */
+    public function getPresentation(): Presentation
+    {
+        return $this->song->getPresentation();
+    }
+
+    // ─── Media files ───
+
+    /**
+     * All media files in the bundle.
+     *
+     * @return array<string, string> relative path => raw bytes
+     */
+    public function getMediaFiles(): array
+    {
+        return $this->mediaFiles;
+    }
+
+    /**
+     * Number of media files in the bundle.
+     */
+    public function getMediaFileCount(): int
+    {
+        return count($this->mediaFiles);
+    }
+
+    /**
+     * Check if a specific media file exists in the bundle.
+     */
+    public function hasMediaFile(string $path): bool
+    {
+        return isset($this->mediaFiles[$path]);
+    }
+
+    /**
+     * Get a specific media file's raw bytes.
+     */
+    public function getMediaFile(string $path): ?string
+    {
+        return $this->mediaFiles[$path] ?? null;
+    }
+}
diff --git a/php/src/ProBundleReader.php b/php/src/ProBundleReader.php
new file mode 100644
index 0000000..7d95077
--- /dev/null
+++ b/php/src/ProBundleReader.php
@@ -0,0 +1,100 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ProPresenter\Parser;
+
+use InvalidArgumentException;
+use RuntimeException;
+use Rv\Data\Presentation;
+use ZipArchive;
+
+final class ProBundleReader
+{
+    public static function read(string $filePath): PresentationBundle
+    {
+        if ($filePath === '' || !is_file($filePath)) {
+            throw new InvalidArgumentException(sprintf('Bundle file not found: %s', $filePath));
+        }
+
+        $size = filesize($filePath);
+        if ($size === false) {
+            throw new RuntimeException(sprintf('Unable to determine file size: %s', $filePath));
+        }
+
+        if ($size === 0) {
+            throw new RuntimeException(sprintf('Bundle file is empty: %s', $filePath));
+        }
+
+        $rawBytes = file_get_contents($filePath);
+        if ($rawBytes === false) {
+            throw new RuntimeException(sprintf('Unable to read bundle file: %s', $filePath));
+        }
+
+        $fixedBytes = Zip64Fixer::fix($rawBytes);
+
+        $tempPath = tempnam(sys_get_temp_dir(), 'probundle-');
+        if ($tempPath === false) {
+            throw new RuntimeException('Unable to create temporary file for bundle archive.');
+        }
+
+        $zip = new ZipArchive();
+        $isOpen = false;
+
+        try {
+            if (file_put_contents($tempPath, $fixedBytes) === false) {
+                throw new RuntimeException(sprintf('Unable to write temporary bundle archive: %s', $filePath));
+            }
+
+            if ($zip->open($tempPath) !== true) {
+                throw new RuntimeException(sprintf('Failed to open bundle archive: %s', $filePath));
+            }
+            $isOpen = true;
+
+            $proFilename = self::findProFile($zip, $filePath);
+
+            $proBytes = $zip->getFromName($proFilename);
+            if ($proBytes === false) {
+                throw new RuntimeException(sprintf('Unable to read .pro entry %s: %s', $proFilename, $filePath));
+            }
+
+            $presentation = new Presentation();
+            $presentation->mergeFromString($proBytes);
+            $song = new Song($presentation);
+
+            $mediaFiles = [];
+            for ($i = 0; $i < $zip->numFiles; $i++) {
+                $name = $zip->getNameIndex($i);
+                if ($name === false || $name === $proFilename) {
+                    continue;
+                }
+
+                $contents = $zip->getFromIndex($i);
+                if ($contents === false) {
+                    throw new RuntimeException(sprintf('Unable to read ZIP entry %s: %s', $name, $filePath));
+                }
+
+                $mediaFiles[$name] = $contents;
+            }
+
+            return new PresentationBundle($song, $proFilename, $mediaFiles);
+        } finally {
+            if ($isOpen) {
+                $zip->close();
+            }
+            @unlink($tempPath);
+        }
+    }
+
+    private static function findProFile(ZipArchive $zip, string $filePath): string
+    {
+        for ($i = 0; $i < $zip->numFiles; $i++) {
+            $name = $zip->getNameIndex($i);
+            if ($name !== false && str_ends_with(strtolower($name), '.pro')) {
+                return $name;
+            }
+        }
+
+        throw new RuntimeException(sprintf('No .pro file found in bundle archive: %s', $filePath));
+    }
+}
diff --git a/php/src/ProBundleWriter.php b/php/src/ProBundleWriter.php
new file mode 100644
index 0000000..d9ce66f
--- /dev/null
+++ b/php/src/ProBundleWriter.php
@@ -0,0 +1,77 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ProPresenter\Parser;
+
+use InvalidArgumentException;
+use RuntimeException;
+use ZipArchive;
+
+final class ProBundleWriter
+{
+    public static function write(PresentationBundle $bundle, string $filePath): void
+    {
+        $directory = dirname($filePath);
+        if (!is_dir($directory)) {
+            throw new InvalidArgumentException(sprintf('Target directory does not exist: %s', $directory));
+        }
+
+        $tempPath = tempnam(sys_get_temp_dir(), 'probundle-');
+        if ($tempPath === false) {
+            throw new RuntimeException('Unable to create temporary file for bundle archive.');
+        }
+
+        $zip = new ZipArchive();
+        $isOpen = false;
+
+        try {
+            $openResult = $zip->open($tempPath, ZipArchive::CREATE | ZipArchive::OVERWRITE);
+            if ($openResult !== true) {
+                throw new RuntimeException(sprintf('Failed to create bundle archive: %s', $filePath));
+            }
+            $isOpen = true;
+
+            foreach ($bundle->getMediaFiles() as $entryName => $contents) {
+                self::addEntry($zip, $entryName, $contents, $filePath);
+            }
+
+            $proBytes = $bundle->getPresentation()->serializeToString();
+            self::addEntry($zip, $bundle->getProFilename(), $proBytes, $filePath);
+
+            if (!$zip->close()) {
+                throw new RuntimeException(sprintf('Failed to finalize bundle archive: %s', $filePath));
+            }
+            $isOpen = false;
+
+            self::moveTempFileToTarget($tempPath, $filePath);
+        } finally {
+            if ($isOpen) {
+                $zip->close();
+            }
+            if (is_file($tempPath)) {
+                @unlink($tempPath);
+            }
+        }
+    }
+
+    private static function addEntry(ZipArchive $zip, string $entryName, string $contents, string $filePath): void
+    {
+        if (!$zip->addFromString($entryName, $contents)) {
+            throw new RuntimeException(sprintf('Failed to add ZIP entry %s: %s', $entryName, $filePath));
+        }
+    }
+
+    private static function moveTempFileToTarget(string $tempPath, string $filePath): void
+    {
+        if (@rename($tempPath, $filePath)) {
+            return;
+        }
+
+        if (@copy($tempPath, $filePath) && @unlink($tempPath)) {
+            return;
+        }
+
+        throw new RuntimeException(sprintf('Unable to write bundle file: %s', $filePath));
+    }
+}
diff --git a/php/tests/ProBundleTest.php b/php/tests/ProBundleTest.php
new file mode 100644
index 0000000..4dc6752
--- /dev/null
+++ b/php/tests/ProBundleTest.php
@@ -0,0 +1,361 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ProPresenter\Parser\Tests;
+
+use InvalidArgumentException;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+use ProPresenter\Parser\PresentationBundle;
+use ProPresenter\Parser\ProBundleReader;
+use ProPresenter\Parser\ProBundleWriter;
+use ProPresenter\Parser\ProFileGenerator;
+use RuntimeException;
+use ZipArchive;
+
+class ProBundleTest extends TestCase
+{
+    private string $tmpDir;
+
+    protected function setUp(): void
+    {
+        $this->tmpDir = sys_get_temp_dir() . '/propresenter-bundle-test-' . uniqid();
+        mkdir($this->tmpDir, 0777, true);
+    }
+
+    protected function tearDown(): void
+    {
+        if (!is_dir($this->tmpDir)) {
+            return;
+        }
+
+        $this->removeDirectoryRecursively($this->tmpDir);
+    }
+
+    #[Test]
+    public function readerThrowsWhenFileNotFound(): void
+    {
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('Bundle file not found');
+
+        ProBundleReader::read('/nonexistent/path.probundle');
+    }
+
+    #[Test]
+    public function readerThrowsWhenFileIsEmpty(): void
+    {
+        $emptyFile = $this->tmpDir . '/empty.probundle';
+        file_put_contents($emptyFile, '');
+
+        $this->expectException(RuntimeException::class);
+        $this->expectExceptionMessage('Bundle file is empty');
+
+        ProBundleReader::read($emptyFile);
+    }
+
+    #[Test]
+    public function writerThrowsWhenTargetDirectoryMissing(): void
+    {
+        $bundle = new PresentationBundle(
+            ProFileGenerator::generate('Dummy', [
+                ['name' => 'V1', 'color' => [0, 0, 0, 1], 'slides' => [['text' => 'x']]],
+            ], [['name' => 'n', 'groupNames' => ['V1']]]),
+            'Dummy.pro',
+        );
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('Target directory does not exist');
+
+        ProBundleWriter::write($bundle, '/nonexistent/dir/out.probundle');
+    }
+
+    #[Test]
+    public function writeAndReadBundleWithRealImage(): void
+    {
+        $imagePath = $this->tmpDir . '/test-background.png';
+        $this->createTestPngImage($imagePath, 200, 150);
+        $imageBytes = file_get_contents($imagePath);
+        $this->assertNotFalse($imageBytes);
+
+        $song = ProFileGenerator::generate(
+            'Bundle Test Song',
+            [
+                [
+                    'name' => 'Verse 1',
+                    'color' => [0.2, 0.4, 0.8, 1.0],
+                    'slides' => [
+                        ['text' => 'Amazing Grace, how sweet the sound'],
+                        ['text' => 'That saved a wretch like me'],
+                    ],
+                ],
+                [
+                    'name' => 'Chorus',
+                    'color' => [0.8, 0.2, 0.2, 1.0],
+                    'slides' => [
+                        ['text' => 'I once was lost, but now am found'],
+                    ],
+                ],
+            ],
+            [
+                ['name' => 'normal', 'groupNames' => ['Verse 1', 'Chorus']],
+            ],
+        );
+
+        $bundle = new PresentationBundle(
+            $song,
+            'Bundle Test Song.pro',
+            ['Media/test-background.png' => $imageBytes],
+        );
+
+        $bundlePath = $this->tmpDir . '/BundleTestSong.probundle';
+        ProBundleWriter::write($bundle, $bundlePath);
+
+        $this->assertFileExists($bundlePath);
+        $this->assertGreaterThan(0, filesize($bundlePath));
+
+        $zip = new ZipArchive();
+        $this->assertTrue($zip->open($bundlePath) === true);
+        $this->assertNotFalse($zip->locateName('Bundle Test Song.pro'));
+        $this->assertNotFalse($zip->locateName('Media/test-background.png'));
+        $this->assertSame(2, $zip->numFiles);
+        $zip->close();
+
+        $readBundle = ProBundleReader::read($bundlePath);
+
+        $this->assertSame('Bundle Test Song', $readBundle->getName());
+        $this->assertSame('Bundle Test Song.pro', $readBundle->getProFilename());
+        $this->assertSame(1, $readBundle->getMediaFileCount());
+        $this->assertTrue($readBundle->hasMediaFile('Media/test-background.png'));
+        $this->assertSame($imageBytes, $readBundle->getMediaFile('Media/test-background.png'));
+
+        $readSong = $readBundle->getSong();
+        $this->assertSame('Bundle Test Song', $readSong->getName());
+        $this->assertCount(2, $readSong->getGroups());
+        $this->assertCount(3, $readSong->getSlides());
+    }
+
+    #[Test]
+    public function writeAndReadBundleWithMultipleMediaFiles(): void
+    {
+        $image1Path = $this->tmpDir . '/slide1.png';
+        $image2Path = $this->tmpDir . '/slide2.png';
+        $this->createTestPngImage($image1Path, 100, 100);
+        $this->createTestPngImage($image2Path, 320, 240);
+
+        $image1Bytes = file_get_contents($image1Path);
+        $image2Bytes = file_get_contents($image2Path);
+        $this->assertNotFalse($image1Bytes);
+        $this->assertNotFalse($image2Bytes);
+
+        $song = ProFileGenerator::generate(
+            'Multi Media Song',
+            [
+                [
+                    'name' => 'Verse 1',
+                    'color' => [0.1, 0.2, 0.3, 1.0],
+                    'slides' => [
+                        ['text' => 'Slide with media'],
+                    ],
+                ],
+            ],
+            [
+                ['name' => 'normal', 'groupNames' => ['Verse 1']],
+            ],
+        );
+
+        $bundle = new PresentationBundle(
+            $song,
+            'Multi Media Song.pro',
+            [
+                'Media/slide1.png' => $image1Bytes,
+                'Media/slide2.png' => $image2Bytes,
+            ],
+        );
+
+        $bundlePath = $this->tmpDir . '/MultiMedia.probundle';
+        ProBundleWriter::write($bundle, $bundlePath);
+
+        $readBundle = ProBundleReader::read($bundlePath);
+
+        $this->assertSame(2, $readBundle->getMediaFileCount());
+        $this->assertTrue($readBundle->hasMediaFile('Media/slide1.png'));
+        $this->assertTrue($readBundle->hasMediaFile('Media/slide2.png'));
+        $this->assertSame($image1Bytes, $readBundle->getMediaFile('Media/slide1.png'));
+        $this->assertSame($image2Bytes, $readBundle->getMediaFile('Media/slide2.png'));
+    }
+
+    #[Test]
+    public function writeAndReadBundleWithoutMediaFiles(): void
+    {
+        $song = ProFileGenerator::generate(
+            'No Media Song',
+            [
+                [
+                    'name' => 'Verse 1',
+                    'color' => [0.1, 0.2, 0.3, 1.0],
+                    'slides' => [
+                        ['text' => 'Just lyrics, no media'],
+                    ],
+                ],
+            ],
+            [
+                ['name' => 'normal', 'groupNames' => ['Verse 1']],
+            ],
+        );
+
+        $bundle = new PresentationBundle($song, 'No Media Song.pro');
+
+        $bundlePath = $this->tmpDir . '/NoMedia.probundle';
+        ProBundleWriter::write($bundle, $bundlePath);
+
+        $readBundle = ProBundleReader::read($bundlePath);
+
+        $this->assertSame('No Media Song', $readBundle->getName());
+        $this->assertSame(0, $readBundle->getMediaFileCount());
+        $this->assertFalse($readBundle->hasMediaFile('anything'));
+        $this->assertNull($readBundle->getMediaFile('anything'));
+    }
+
+    #[Test]
+    public function readerHandlesProPresenterExportedBundle(): void
+    {
+        $ppExportPath = dirname(__DIR__, 2) . '/ref/RestBildExportFromPP.probundle';
+        if (!is_file($ppExportPath)) {
+            $this->markTestSkipped('PP-exported reference file not available');
+        }
+
+        $bundle = ProBundleReader::read($ppExportPath);
+
+        $this->assertSame('TestBild', $bundle->getName());
+        $this->assertSame('TestBild.pro', $bundle->getProFilename());
+        $this->assertSame(1, $bundle->getMediaFileCount());
+
+        $slide = $bundle->getSong()->getSlides()[0];
+        $this->assertTrue($slide->hasMedia());
+        $this->assertStringStartsWith('file:///', $slide->getMediaUrl());
+        $this->assertSame('png', $slide->getMediaFormat());
+    }
+
+    #[Test]
+    public function writeProducesStandardZipWithAbsoluteMediaPaths(): void
+    {
+        $imagePath = $this->tmpDir . '/bg.png';
+        $this->createTestPngImage($imagePath, 100, 100);
+        $imageBytes = file_get_contents($imagePath);
+        $this->assertNotFalse($imageBytes);
+
+        $mediaAbsPath = '/Users/test/Media/bg.png';
+
+        $song = ProFileGenerator::generate(
+            'ZipFormatTest',
+            [
+                [
+                    'name' => 'V1',
+                    'color' => [0, 0, 0, 1],
+                    'slides' => [
+                        [
+                            'media' => 'file://' . $mediaAbsPath,
+                            'format' => 'png',
+                        ],
+                    ],
+                ],
+            ],
+            [['name' => 'normal', 'groupNames' => ['V1']]],
+        );
+
+        $bundle = new PresentationBundle(
+            $song,
+            'ZipFormatTest.pro',
+            [$mediaAbsPath => $imageBytes],
+        );
+
+        $bundlePath = $this->tmpDir . '/ZipFormatTest.probundle';
+        ProBundleWriter::write($bundle, $bundlePath);
+
+        $zip = new ZipArchive();
+        $this->assertTrue($zip->open($bundlePath) === true);
+        $this->assertSame(2, $zip->numFiles);
+
+        $mediaIdx = $zip->locateName($mediaAbsPath);
+        $this->assertNotFalse($mediaIdx, 'Media entry should use absolute path with leading /');
+
+        $proIdx = $zip->locateName('ZipFormatTest.pro');
+        $this->assertNotFalse($proIdx);
+        $this->assertGreaterThan($mediaIdx, $proIdx, 'Media entries should come before .pro entry');
+
+        $zip->close();
+
+        $readBundle = ProBundleReader::read($bundlePath);
+        $this->assertSame('ZipFormatTest', $readBundle->getName());
+        $this->assertTrue($readBundle->hasMediaFile($mediaAbsPath));
+        $this->assertSame($imageBytes, $readBundle->getMediaFile($mediaAbsPath));
+    }
+
+    #[Test]
+    public function bundleWrapperExposesAllProperties(): void
+    {
+        $song = ProFileGenerator::generate(
+            'Wrapper Test',
+            [
+                [
+                    'name' => 'V1',
+                    'color' => [0, 0, 0, 1],
+                    'slides' => [['text' => 'Hello']],
+                ],
+            ],
+            [['name' => 'normal', 'groupNames' => ['V1']]],
+        );
+
+        $bundle = new PresentationBundle(
+            $song,
+            'Wrapper Test.pro',
+            ['Media/bg.jpg' => 'fake-jpeg-bytes'],
+        );
+
+        $this->assertSame('Wrapper Test', $bundle->getName());
+        $this->assertSame('Wrapper Test.pro', $bundle->getProFilename());
+        $this->assertSame($song, $bundle->getSong());
+        $this->assertSame($song->getPresentation(), $bundle->getPresentation());
+        $this->assertSame(1, $bundle->getMediaFileCount());
+        $this->assertTrue($bundle->hasMediaFile('Media/bg.jpg'));
+        $this->assertSame('fake-jpeg-bytes', $bundle->getMediaFile('Media/bg.jpg'));
+        $this->assertSame(['Media/bg.jpg' => 'fake-jpeg-bytes'], $bundle->getMediaFiles());
+    }
+
+    private function createTestPngImage(string $path, int $width, int $height): void
+    {
+        $image = imagecreatetruecolor($width, $height);
+        $this->assertNotFalse($image);
+
+        $blue = imagecolorallocate($image, 30, 60, 180);
+        $this->assertNotFalse($blue);
+        imagefill($image, 0, 0, $blue);
+
+        $white = imagecolorallocate($image, 255, 255, 255);
+        $this->assertNotFalse($white);
+        imagestring($image, 5, 10, 10, 'ProPresenter', $white);
+
+        imagepng($image, $path);
+    }
+
+    private function removeDirectoryRecursively(string $path): void
+    {
+        foreach (scandir($path) ?: [] as $entry) {
+            if ($entry === '.' || $entry === '..') {
+                continue;
+            }
+
+            $entryPath = $path . '/' . $entry;
+            if (is_dir($entryPath)) {
+                $this->removeDirectoryRecursively($entryPath);
+                continue;
+            }
+
+            @unlink($entryPath);
+        }
+
+        @rmdir($path);
+    }
+
+}
diff --git a/ref/Media/test-background.png b/ref/Media/test-background.png
new file mode 100644
index 0000000000000000000000000000000000000000..a1941a82231be4f745374065e29d0d8620e2e80c
GIT binary patch
literal 717
zcmeAS@N?(olHy`uVBq!ia0vp^CxCbw2NRGK*%#mkq&N#aB8wRq_>O=u<5X=vX$A(S
zdQTU}kcv5PZ(Yp2<-pMJaM>xDw@PnW*39-hpptWmU8SWa!TMPJtSRrSyL{elcr)Kx
z`03N*>$m4`*#7?iFP0znoZT%OJUFltM_&Iqz5H>a&5zID=bwGQ{dY@^A9v#1*!w>&
ze=M+)lk-XZ&RJgmkD+GU=3h=Zttw$_Bg|v%E??h$J4JI>WzBca<8Mm~ul$IcJY8+S
z*}UhES{@%*{>kWnf8FPPm&v<}YNemm->W^eamm!>8`CCzY`P<})#7<@r0BK1t2aM;
z<=<EHq~*O->E=nZv#-wTxVcZXZcp{<yFWkH7Zuc9dAI!Fk#Mfp_mT|OX<v^wE{}Iw
z<C(2;pG*C`VgGx<$DePePL-Oz+H~=~r$$-pIp;fWP4X>Uaoqmt<7wsditDuZm}h<d
xnLqEtO&yy(ht2*ucsWI=w78BEq=&&jrl)Db2Mxm3#skwQgQu&X%Q~loCIAN6BzFJ+

literal 0
HcmV?d00001

diff --git a/ref/RestBildExportFromPP.probundle b/ref/RestBildExportFromPP.probundle
new file mode 100644
index 0000000000000000000000000000000000000000..50cf7026486416dfb4d0d2ee902224704f1cd400
GIT binary patch
literal 2126
zcmeGde@s<X_}s^@_pZtEp&NTJR_vt-p5Fa^??EQ--goZ{MCpx;uxap!hXGIC^F0Wg
z{BTCCY?CG-n-*-<!VN_nGd3kcrD!$RO3Pu16`@;-M9hKKpmTXV)*n<f|LC92-96v=
zcD~==`M%GU9T5qEzRoq(Zd<cUczAYxZ2*bD_EgXl2-+&2_XUELo(h}ltFG|++{Hng
z-w!K2!Ae^tW83U0E_K^<3>LYcE8h|DRaF!}=C9a6fOv4hFeiKghA;qLbLBj~oV1V_
zU!Ikz=3@9M{tp>-`jvgI91KkU%&kEHVh8k}Xikky0Kib6rOI1&zcqH{%bi#3VDAs_
zf0j6wJQjKENKU`i`&Ep!p{8*CC-sNl9N)8l)9tQXZR_JkM+Z;z__}(=XYWN$XP91Z
z=*l!Mx((d?{qyz_clz|?RNIB|p5Gd3a+bN@-hOTR;)FjfDQS~?%2ZuF18P3#zNdI!
zw&oqr7q@S?c=^n?#cNN$STkiB9IM)OY5Liwmen5#tv7yb80l~Sm6>g<n`~5@&ID=`
zuGbIOo;&$obNk7XgA@C{OFSjrcyjBiZ$9kkzW(zQ2Woz57`Ie)A3Re2_2E~C`c~ET
z?&-LCccMPvue)@+{p`Tg<jvtCsx$R+0b5<59Lp-VUL)6hK{t-C7?~XMG+SCa_;-g#
znX(h6Hu+T1<`<3*W{i#;s%{O|rS^(tlXrcszYMKQ?>#Tf*f%Qq)&}kW?cc{>#xPnE
zcb3XKUVz^x$kKAuPNi_4YoUl<Ia<5Td-eRCa1lL#i)ah345ieIOCsRYOX8&nofj-X
zZ5}5RjD$Jb82g|xJ|dn-UT$2OY+_lS=Qx(<%&SSOq|pj;G8CkdDngFe98i{MC#0Q7
zRumSA$SGQkVRcFj8TAMNdowl~;)z_$uCOf9c#4IxQ+7g*;dv;rf(Cg}5*;+dXtINO
zCZAj)r8&C77uf0cT6DvBMUq68fucyOkV8m<ir}OmB{@YI2@aa4_@ZJmO_#kCT60Vu
zZabcbXiLb0WT3l`6doZ~p`k20vHc2-JwdDh5i4sPrHHJ+%4MCAx{{@kn&TE}SqjJv
z>H;X5mmI3fLV>0P$f-zx3QJK?bs$Yfyedl+OA(pNP7|tGA=4SNDU{Pz`--{4_ixzK
zuo%qZK-fCSh>Qd|${|2m5H%<{X^y1@n${SUtf%LWLD%Y_C5}ddjMeBKN(={O73YfP
zk&~4<M&K2MwHn?bJ~pKE&9Sg5ixgExkkJ$wVs0L%*TF$rq(#JuB99o^93-`pQm-e?
zX1l+Jj$h@Y#z?buDb3#!l@ftxKuQZiCZ&YKQ#v1>{vvx?BniwQ0Cp4RD)PTDPysHY
zkO+YNglX+u&iVs(S2kftiumh!7)o+@zrSGq-E{o39gDS;umu3<%_Cg#|I}by+0oJK
p=2^pD>gfE4UVwHYL=+nnf|zgabZZ{huU*+u(fX|ce>#1L_75^%bn^fJ

literal 0
HcmV?d00001

diff --git a/ref/TestBild.probundle b/ref/TestBild.probundle
new file mode 100644
index 0000000000000000000000000000000000000000..bfcf631f7b5324f9160746f138eac278193064f4
GIT binary patch
literal 1232
zcmWIWW@Zs#U}E54_~=#_qh4sHIGvG!;VcsagDnFCgMMgnYEiL%Nk)EAaY<^PzN4pp
zK~a7|QEG8&UP)?^eo<<gzHe$uW}<#cYH^8fQetv;dQpC9UW#5pUixdE55>=)PI{D-
zknrH^mjX_vOX>|3QtZMLL~e>dU|(XvZKKpJDe<GP!QgR7u3aV@+p;Qu@#7P^Ec5eY
z&+L7A;KGN3o0>DXd*w%7JM+zY!KC8O*riL=4*rVxyGHZ<>fJT>ax0AQNBwwt`SI)R
z&+~8m`}bden*6spcXg$0EH((a$Njh5`=@Zx+5YqQpU<z||F_(`SHAqwog2UH_3Cvt
zOq%@J^Ut}+xPSc%({4YD_p@B9m6)x3Ci$&i{QX*M*W&Qhv*qU==X-On|I;zsCN_8f
z%{|ZiqvYfx{+)bLUw`*`-Sm^YyR(+gzj}YQ?UurmSDs2=R;$g~rM&s-qsoFMFShPo
zZEj!v^nUo~B~SN;ynN=ldGq>nuXgP8-;(G5_0?{B`)lH&S7Ix-|9LR6VBPialX$LW
z#`l}+^_NFIp1HPYzW3ifiT|q)9-p7T%x~(feYZ+J?p^K{`P%Zib)N4h-RQzQ|6V@M
zeEPZT^_K55(rf?Cw10otS9Z2-``Le%6_&0mw(RH=S|a>^#=K>m@+KV7()>R2dFHLF
z(|bKfXcj{NN{lm>Ej<1c7~{3f3=BNL7!Lu)qf=%MFanG6j|QFY5_S}M>-TKpmiNb8
zJES?aBzBZt->uEDEI-s#i^FKei8W_t%rlgld_mSx;9#q^;|K1T9iOC+v_9znp&533
z?&=+z#7fPd-?8fN(knewvA+0Q&GPH-TAPjMb~o!KI~AN`>0j>}K1Fp_<f#Uusm$(v
z4xjHZ1uB)^O7hzAu3T=)SE=;Rn(y3qhc`dCyLR{5xQYia`y@+Z3=Q;hUqmqntyBmO
z@m?&rS%zQUJzDAU-lLnUEN6bVjSHH-*oE^>2AhqsNI)i&U!=>HYqOeUd>039Q8l|)
z9}-qtIrGbZ3kjCqzfE55DOv|SCo^4_WLIfvDn7N);1HME{QA3{+gg$e0?Z?x7Ug?#
zOi=mW#3Q(%HA8QC$+H=!Ogs<YUcRr@?AQyn-rWbE)yT!)I1@krnDYK(DXwm&?g25D
z4@7EXOpFtXR&wj5Humt%QoFa^+)yF4RnsWJ)p3?i&;h5V4_G$)L?4pe_;Kgf_d<PY
z{_%4{PKS4|oPP0_(7zns{o7~B`dE}?9z3}EOC{Hp3Dz(FH;Y}1O!0cHRCk$Mx!Pv-
z^u;Qka@Xvxr~J){y!yIm;*;`8p<81@Q)Bh6rA`fbT3EDx&N;P{@%;BAbp6<tT<&@}
zU*qrH#M}K3j~iIo^0-+C3b2QMu<E(*_CNUAUx8-zM9~_K-Pg@U|E)N-pE1Cjk;$GJ
ycd-CWCt$Fx5kyf`NT6GVo*p3<F)(av`~*y;$f+~Ho0SbD%LIf=fwU+Khz9_%!z9-L

literal 0
HcmV?d00001