arsd.pixmaprecorder

Pixmap Recorder is an auxiliary library for rendering video files from Pixmap frames by piping them to FFmpeg.

Tips and tricks

$(TIP Combining this module with Pixmap Presenter is really straightforward.

In the most simplistic case, set up a PixmapRecorder before running the presenter. Then call pixmapRecorder.record(presenter.framebuffer)

at the end of the drawing callback in the eventloop.

auto recorder = new PixmapRecorder(60, /* … */);
scope(exit) {
	const recorderStatus = recorder.stopRecording();
}

return presenter.eventLoop(delegate() {
	// […]
	recorder.record(presenter.framebuffer);
	return LoopCtrl.redrawIn(16);
}

)

Examples

Getting started

1. Install FFmpeg (the CLI version). - Debian derivatives (with FFmpeg in their repos): apt install ffmpeg - Homebew: brew install ffmpeg - Chocolatey: choco install ffmpeg - Links to pre-built binaries can be found on <https://ffmpeg.org/download.html>. 2. Determine where you’ve installed FFmpeg to. Ideally, it’s somewhere within “PATH” so it can be run from the command-line by just doing ffmpeg. Otherwise, you’ll need the specific path to the executable to pass it to the constructor of PixmapRecorder.

import arsd.pixmaprecorder;
import arsd.pixmappaint;

/++
	This demo renders a 1280×720 video at 30 FPS
	fading from white (#FFF) to blue (#00F).
 +/
int main() {
	// Instantiate a recorder.
	auto recorder = new PixmapRecorder(
		30,        // Video framerate [=FPS]
		"out.mkv", // Output path to write the video file to.
	);

	// We will use this framebuffer later on to provide image data
	// to the encoder.
	auto frame = Pixmap(1280, 720);

	for (int light = 0xFF; light >= 0; --light) {
		auto color = Color(light, light, 0xFF);
		frame.clear(color);

		// Record the current frame.
		// The video resolution to use is derived from the first frame.
		recorder.put(frame);
	}

	// End and finalize the recording process.
	return recorder.stopRecording();
}