
p5.jsのスケッチを動画化する方法
今まではスケッチを録画するのにp5.capture使っていたんですが長尺動画を作ろうとするとフレーム数が多くて上手くできない…webmで書き出せばできなくもないけど…
品質的に画像で書き出してFFmpegで動画にした方が…あーだこーだ…
そこでGeminiに相談しながらてんやわんやしたらNode.jsとやらでいい感じにできたのでそれを共有します。
御託はいい、はじめよう。
※この記事はMac環境での操作を前提としています。
1. 必要なツール
・Node.js
・FFmpeg
これらを事前にインストールします。
Node.js:JavaScriptをブラウザ上ではなく、PC上で動かすための実行環境です。今回はPuppeteerやFFmpegを動かす「全体の土台」として使用します。
FFmpeg:動画や音声を変換・編集するための非常に強力なコマンドラインツールです。画像データを受け取って高画質なMP4動画に書き出す「映像変換の本体」として機能します。
2. ディレクトリ作成と初期化
ターミナルで作業用フォルダを作成・移動する
ターミナルで以下のコマンドを実行します。
mkdir p5-renderer
cd p5-rendererNode.jsプロジェクトを初期化する
npm init -ypackage.json が生成され、ライブラリを管理できるようになります。
必要なライブラリをインストールする
npm install puppeteer fluent-ffmpegpuppeteer:ブラウザを画面に表示させず、バックグラウンドで自動操作するためのライブラリです。p5.jsの描画を裏で1フレームずつ正確に実行・キャプチャする役割を担います。
fluent-ffmpeg:動画処理ソフト「FFmpeg」をNode.jsから簡単に扱うためのライブラリです。キャプチャした画像をディスクに保存せず、直接動画(MP4)へリアルタイム変換して繋ぎ合わせる役割を担います。
3. ファイルの準備
HTML(録画したいスケッチ)を用意
自分で用意した録画したいスケッチファイル(僕の場合はindex.htmlとsketch.js)のファイルをディレクトリに追加します。
⚠️sketch.jsのsetup()内にnoLoop()を必ず追加します。
function setup() {
createCanvas(800, 800);
noLoop(); // ★これを絶対に追加!
// 以下の処理...
}render.js 側から1フレームずつ描画(redraw())を制御するため、setup() の中で自動ループを止める必要があります。
render.jsの作成
render.jsという名前でファイルを作成します。
render.jsの中身はこちらをコピペします↓↓
const puppeteer = require('puppeteer');
const ffmpeg = require('fluent-ffmpeg');
const path = require('path');
const { PassThrough } = require('stream');
(async () => {
// ★ 設定項目
const startFrame = 1; // 録画を開始するフレーム
const durationFrames = 60 * 10; // 実際に録画するフレーム数
const totalFrames = startFrame + durationFrames; // 全実行フレーム数
// 出力ファイル名(日付つき)
const dateStr = new Date().toISOString().slice(2, 10).replace(/-/g, '');
const outputPath = path.join(__dirname, `${dateStr}_stream.mp4`);
// FFmpegの設定とパイプ(Stream)の準備
const inputStream = new PassThrough();
const command = ffmpeg(inputStream)
.inputFormat('image2pipe')
.inputFPS(60)
.outputOptions([
'-c:v libx264',
'-pix_fmt yuv420p',
])
.output(outputPath)
.on('start', () => console.log('FFmpeg処理を開始しました...'))
.on('error', (err) => console.error('FFmpegエラー:', err))
.on('end', () => console.log(`動画の作成が完了しました: ${outputPath}`));
command.run();
// Puppeteerの起動
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto(`file://${path.join(__dirname, 'index.html')}`);
for (let i = 0; i < totalFrames; i++) {
// 1フレーム分描画を進める
await page.evaluate(() => redraw());
// 指定した開始フレーム以降のみFFmpegへ書き出す
if (i >= startFrame) {
const base64Data = await page.evaluate(() => {
const canvas = document.querySelector('canvas');
return canvas.toDataURL('image/png').replace(/^data:image\/png;base64,/, '');
});
const buffer = Buffer.from(base64Data, 'base64');
inputStream.write(buffer);
}
// 進捗ログの表示
if (i % 600 === 0) {
if (i < startFrame) {
console.log(`スキップ中 (ウォームアップ): ${i} / ${startFrame} フレーム`);
} else {
const recorded = i - startFrame;
console.log(`録画中: ${recorded} / ${durationFrames} フレーム完了`);
}
}
}
// ストリームの終了処理
inputStream.end();
await browser.close();
})();以下の部分を自分用に設定します。
startFrame:何フレーム目から録画を開始するのか
durationFrames:何フレームの間録画するのか
inputFPS():スケッチのFPSに合わせる
今回は60fpsなので60×10で10秒。
つまり、1フレーム待ったあとに10秒間録画する状態になっています。
※動画のサイズは、p5.jsの `createCanvas()` で指定したサイズになります。
ディレクトリ構造が以下のようになっていればOKです。
p5-renderer/
├── index.html
├── sketch.js
├── render.js
├── package.json
├── package-lock.json
└── node_modules/4. 動画化の実行
ターミナルでコマンドを実行
node render.js以下のように表示されると思います。
FFmpeg処理を開始しました...
スキップ中 (ウォームアップ): 0 / 1 フレーム
録画中: 500 / 600 フレーム完了待ち時間なのでこの間は法に触れない限り何しててもOKです。(※ただしPCがスリープすると処理が止まるので注意)
途中で辞めたい場合はcontrol + cで止まります。
ディレクトリ内に "今日の日付"_stream.mp4 の動画ファイルができていたら完成です。
僕の環境では30秒の動画で1分かからないくらいでした。
別のスケッチを新たに動画化したい場合
index.html と sketch.js を差し替える
ターミナルで node render.js を実行する
これだけで簡単に高品質な動画を書き出すことができます!
さいごに
スケッチの録画方法はずっと右往左往しながら試行錯誤して暗中模索からの跳梁跋扈だったんですけどこの方法でやってる感じ今は全部これで良さそうだなって思ってます。
書き出しに時間かかりますが1時間以上の高画質の録画も可能でした。
なるべくわかりやすいように書いたつもりですが何かわからないことがあればお気軽にお聞きください。