toy-loops は何をしますか?
小さなペーパークラフトの世界(島、キャンプ場、映画セット)、俳優としての Claude、柔らかく暖かい光とミニチュアのような浅い被写界深度。すべてのオブジェクトはコードで構築され、すべてのフレームはその番号から計算されるため、ループは正確に閉じます。この見た目は、Pimbo のリファレンス anymation/3d_ref/style2 を reference-video-analysis スキルで分析したものから研究されました(初回パス: 3d_ref/style2/analysis/FIRST_PASS.md)。それらのリファレンスは非公開の学習教材です。技法はコピーしても、シーンはコピーしないでください。
ステータス: v1, 2026-11-18. このスキルで作成され、確認された作品:
claude_isla: Pimbo 承認("esta épica")。claude_fogata: 2 つ目のループ。director_hero: 2400x1200 の Web ヒーロー画像、2 色で作成。claude_pose: ライブ Web の目があるカットアウト。claude.glb: 3D モデル。
ファイル構成
コードは Pimbo の PC 上のフォルダ C:\Users\Pimbo\work\anymation\toy3d\skill にあります。以下のパスは、特に断りがない限り、その kit/ フォルダからの相対パスです。
| パス | 内容 |
|---|---|
lib/toy.py | 見た目: 白い面取りエッジ、形状、ライト、カメラ、レンダリング設定の紙質マテリアル |
lib/anim.py | アニメーター用ツール: イージング、Track(ポーズ間の補間)、スプリング、squash、arc、looped |
lib/chars.py | Claude: リグと 6 種類の目セット; フレームごとに .pose(...) を 1 回 |
lib/runner.py | シーンをフレームごとにレンダリング; すべてのシーンは runner.run(...) で終了 |
loops/<name>/scene.py | 1 つのループアニメーション |
stills/<name>/scene.py | 1 枚の静止画(T = 1) |
tools/make_loop.py | レンダリング、GIF 1080/720 と MP4 x1/x3 へのエンコード、QA、コンタクトシートを 1 コマンドで実行 |
tools/qa_loop.py | ループの継ぎ目、フレーム数、停止、リファレンスとの動きの比較 |
tools/duotone.py | 画像の青いモノクロームバージョン(Web ヒーロースタイル) |
tools/web_eyes.py | 目をオフにしてレンダリングした Claude の目がカーソルを追う Web ページ |
tools/claude_glb.py | Claude モデルを .glb(フラットカラー、白エッジ保持)として Blender 内で実行 |
out/<name>/ | 出力: frames/、ファイル群、sheet.jpg、qa.json |
完成した作品は anymation/toy3d/videos/<name>/ にコピーされます。Web 作品は anymation/toy3d/web/ に配置されます。
必要なもの:
- Blender 5.2: Pimbo のポータブルコピーは
anymation/tools/blenderにあります。他の環境では$BLENDERを設定するか、blenderを PATH に追加してください。 - ffmpeg を PATH に追加。
- Python(numpy、Pillow)をツール用にインストール。
Pimbo はスクリプトを実行しません。あなたが実行し、Pimbo に画像を見せます。
絶対に守るルール
- 作成前に表示する。 新しい世界やキャラクターを作る前に、2〜3 枚の静止画(
--frames ... --scale 0.5)をレンダリングし、Pimbo に選んでもらいます。見せる前にすべての画像を自分で確認してください。 pose(f)はフレームの純粋関数。 フレーム間で状態を保持せず、固定シードなしの乱数を使用せず、すべての周期運動はループごとに整数周期にします。ループの終わりをまたぐエフェクトにはlooped()を使用します。- アニメーターのようにアニメートする(
references/ANIMATION.md)。最初にドープシートを書き、次にイージングを適用したキーポーズを使用します。すべてのアクションの前に予備動作を、衝突時には押し潰しを、速度時には伸ばしを、腕にはオーバーラップを、そして 1 フレームの目の切り替えを行います。決して直線的に動かさないでください。 - QA に合格し(
make_loop.pyが PASS/FAIL を表示)、すべてのアクションをフレームごとに確認したストリップを見た場合のみ、ループは完了とみなします(下記「ストリップ」を参照)。 - 測定したものは [M]、目視したものは [V]、想定したものは [S] として明記します。
パイプライン
| ステップ | 内容 | コマンド(kit/ から) |
|---|---|---|
| 1 | アイデア: 場所、始まりとループバックのある小さなストーリー; 6〜9 秒 | Pimbo と相談 |
| 2 | 最も近いシーンをコピー: loops/claude_isla(昼、屋外)または loops/claude_fogata(夜、小道具、エフェクト) | |
| 3 | セットを構築、Claude を配置、照明とカメラを設定; 静止画を確認 | python tools/make_loop.py <name> --frames 0 --scale 0.5 |
| 4 | ドープシートのコメント、次にトラック; キーポーズをレンダリング | python tools/make_loop.py <name> --frames 44,62,66,71,77,81 |
| 5 | ループ全体を高速プレビュー | python tools/make_loop.py <name> --preview(8 フレームおき) |
| 6 | フルレンダリング + GIF + MP4 + QA | python tools/make_loop.py <name> |
| 7 | 各アクションのストリップ、修正、再レンダリング | 下記「ストリップ」を参照 |
| 8 | 完成ファイルを anymation/toy3d/videos/<name>/ にコピーし、Pimbo に送信 |
Pimbo の PC(RX 6800 XT)でのタイミング [M]:
- EEVEE: 1080x1080 フレームあたり約 0.7 秒。したがって、200 フレームのループは約 2.5 分かかります。
- Cycles: フレームあたり約 10 秒で、見た目はほぼ同じです。静止画のみに使用:
--engine cycles --samples 256で 2400x1200 の場合約 20 秒。
ストリップ。 アクションをフレームごとに確認するには:
ffmpeg -framerate 25 -start_number 56 -i out/<n>/frames/%04d.png -frames:v 30 -vf "crop=...,scale=260:-1,tile=6x5" -frames:v 1 strip.jpg
見た目の概要(詳細と数値: references/LOOK.md)
- トイスケール。 1 単位 = 1 m で、Claude の幅は約 9 cm。実際のカメラ被写界深度(70 mm、f/4.5-7)により、ミニチュアブラーが自動的に得られます。
- 紙質。 すべての立体物に
paper(...)が適用されます: マットな色、繊維の凹凸、柔らかな染み。面取りエッジには自動的に白エッジマテリアルが適用されます(box、prism、disc)。 - 色。 ビュートランスフォーム AgX、Punchy ルック。露出は昼で -1、夜で約 -0.35。
- 照明面: Claude の照明面はリファレンスに近い値(当方の #DA8D6C、リファレンス #EC815B)。
- 明るさ: 昼のフレームの平均明るさは 120〜140(リファレンス 91〜181)。
- ライト。 暖色のキーライトを高く前方に配置し、上面を前面より明るくします。弱い寒色フィルと暖色リムを追加します。発光するもの(炎、星、煙)には
flame_matとno_shadowを使用します。 - カメラ。 ループ中は静止(リファレンスではカットまたはプッシュイン時のみカメラを動かす)。
- GIF には正方形 1080。
- ヒーロー画像はワイドで、
shift_xで被写体を 3 分の 1 の位置に配置。
Claude の概要(references/CHARACTERS.md)
claude = Claude('claude', loc) と定義し、フレームごとに:
claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
- 目:
sq(四角)、happy(^ ^)、line(- -)、squeeze(> <)、dot(. .)、sad。 - 小道具: 保持する小道具は
claude.hand(side)にペアレント化。 - 手を振る: 手を振る腕はカメラに向いている方の腕。
Web 作品: ライブの目と 3D モデル
- ライブの目。
--eyes-offを指定してレンダリング(カットアウトの場合は--transparentも):python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes。ランナーは目を非表示にし、eyes.jsonを書き出します: 各目のピクセル中心と、顔の軸(ピクセル/mm 単位)。python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render with eyes>を実行。index.htmlと単一ファイル<dir>_un_archivo.htmlが書き出されます。- ページの動作:
- 目は顔の平面上に描画された SVG 図形で、傾いた顔でも遠近感が正しく保たれます。
- 減衰付きスプリングでポインターを追跡し、2.5〜5.5 秒ごとにまばたきします。
- ポインターが近いときは
^ ^、押している間は> <。 - クリック時に押し潰しと伸ばしのバウンス(
--heroの場合はなし。静止画を維持)。
- Chrome で playwright を通してテスト済み(ポインター左、右、上、下、近接、押下、解放): コンソールエラーなし。
- 3D モデル。
blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]を実行。約 27 KB の GLB ファイルが書き出され、幅は約 9 cm。再インポートして確認済み。 - シーンと
--eyes-off。 ビルド時に Claude をポーズするシーンは、pose(f)内でも再度ポーズする必要があります。--eyes-offはそこで効果を発揮します(stills/director_heroを参照)。
品質ゲート(tools/qa_loop.py)
FAIL:
- フレーム数が間違っている。
- 継ぎ目がある: 最後のフレームから最初のフレームへの変化が、通常の変化の 90 パーセンタイルより大きい。
WARN:
- 連続する同一フレーム(停止)。
- 動きが平均明るさの 0.8% 未満。測定 [M]: リファレンス r2/r3/r4 は 1.65/1.97/1.07%、
claude_islaは 0.89%、claude_fogataは 1.66%。
QA はセンス、演技、フレーミングを判断できません。これらは静止画とストリップで目視確認します。
既知のエラー(references/KNOWN_ERRORS.md)
再レンダリングが必要になるもの:
- 腕を約 70° 以上上げると、体の横に隠れる。
- 明るい発光が AgX で白飛びする:
flame_matを使用。 - サイドキーライトが前面を暗くする。
- 絶対的なグレーレベルで測定された夜のシーンが「静かすぎる」と感じられる。
- 湾曲した背景アークが狭すぎて、その端が見える。