Communityコーディング&開発github.com

ペーパーダイオラマ

ゲーム、ウェブページ、アニメーション、動画を、飛び出す紙のジオラマとしてブラウザで組む。ヒンジ、柔らかい影、ティルトシフトのマクロレンズ。題材は問わない。

ペーパーダイオラマ とは?

再利用できる紙工作の見た目。印刷された地面からカードがヒンジで立ち上がり、少し行き過ぎて落ち着き、温かい影を落とす。three.js でも Canvas、SVG、CSS でも作れる。画像生成は任意で、印刷用の型紙ではない。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xikhar/papercraft/tree/HEAD/skills/papercraft

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ペーパーダイオラマ は何をしますか?

1つのスタイル、あらゆる被写体:内側から見たポップアップジオラマ。繊維質なカードストックにインクで印刷され、切り抜かれたイラストカードが、プリントされた地面に蝶番で立つ。ばねのように跳ね上がり、少し行き過ぎてから落ち着き、地面や互いに柔らかく温かい影を落とす。これらを、あたかも本物の紙模型を撮影したかのように、長焦点マクロレンズで世界を見下ろし、浅いティルトシフトの焦点域で捉える。ここにあるすべてのものは、このスタイルで作られた出荷済みブラウザゲームから来ており、批評家ラウンドとユーザーフィードバックによって報われたものです。数値は装飾ではなく、検証された出発点です。ブリーフが常にこれらのデフォルト値に優先します。

このスキルは方法を教えます:スタイルを成立させる要素、任意の作品を構築して印刷する方法、照明、フレーミング、動作、そして検証方法。被写体の作品はあなた自身が作成します。assets/ 内のコードは、インポート可能な基盤(紙、カード、積層印刷、蝶番、光、レンズ、歩行フィールド)と、ある田舎の世界からの実例(読み物用)であり、新しい被写体を組み立てるための部品カタログではありません。

1. 素材モデル(何が紙として機能させるか)

毎回の実行でこれらを正しく設定してください。各行がその理由を示します。詳細と追加の数値は references/look.md にあります。

  1. すべては厚みのある平らなシートである。 形状は、切断、折り曲げ、重ね、スロットにはめ込むことによってのみ生まれ、彫刻によるボリュームからは決して生まれない。カードの厚さは、主役の高さの1.5~3%。厚みのない平面はシールのように見え、厚すぎるものはフォームボードのように見える。
  2. デッドマット。 拡散光のみ、ソフトなターミネーター(ラップ約0.3)、スペキュラーなし、反射なし、光沢なし。ごく一部を除き、クリップされるピクセルは約1%未満(小さな明るいパネルのみクリップ可)。 grazing angle での光沢は、プラスチックか濡れたように見える。
  3. 1つの暖色、低調、柔らかく彩色された影。 側面からのキーライト、カメラ軸から45~65度、上方向に45~55度(黄金時間と夕暮れ時のみ20~35度)、カメラに向かって少し寄せる。これにより、影は横と後ろに落ち、カメラから見えるようになる(カメラ後方からのキーライトはすべての影を隠す)。フロントフィルはキーライトの約1/4~1/3で、カメラ側のカードが灰色になるのを防ぐ。影はカードが地面に接する部分では鮮明で、隙間が広がるにつれて広がる(半影はギャップの約0.2~0.3倍)。影の色相は世界から来る:日中は暖かい地面に暖かい琥珀色、雪にはライラックブルー、水中では深いティール、夜にはネイビー。作品自体はどの環境でも暖かさを保つ。決して灰色や黒の影、フレーム上の色付きフォグやフィルターは使用しない。すべての自立した作品は地面に接していることが目に見えてわかる(コンタクトダークニング)。キーライトのみで影をチェックすること(look.md セクション8b)。
  4. すべてのプリントは小さな紙のコラージュである。 各塊状のシルエット内部:3~5色のインクを3段階以上の明度と1つの装飾で、ベースシートの上に後ろから前にカットレイヤーとして配置する。ベースシートには控えめな繊維(決して豪華なフェルトや織りではない)を使用する:最初に構造(四肢、段、屋根板の列、フレーム、パネル、バンド)、次にベースとコントラストする大胆なモチーフ(葉と花びら、リベットとパネルライン、鱗、スカラップ、ストライプ、窓)。各レイヤーは、その下にあるものに短く柔らかな暖かい影を落とし、光が当たる端に薄く淡い縁を見せる。大きなレイヤーはさらに均一な淡いカットエッジを見せる。この組み合わせが、ベクターフィルではなく紙の重なりとして読ませる。何もむき出し、薄すぎる、またはとがったものは禁止:作品の約2~3%未満の線は不可。モチーフは大きく数えられること(田舎の例の樹冠は15~25枚の葉を持ち、それぞれ樹冠の幅の約1/7)。印刷イラストレーションは、元のプロジェクトで最大の品質向上をもたらした(プレーンなカードに対して6回中6回のブラインド勝利)。キット:P.layer、P.parts、drawnPiece、P.marks、P.rim。
  5. カットエッジ。 シルエットのすぐ内側に細く濃い茶色の線(カードの厚みと印刷された輪郭、画面上で約1.5~2.5ピクセル)、そして光が当たる縁の内側にのみ淡いハイライト。決して全周に均一な淡いまたは白い帯(シールのハロー)を付けない。光らせない。破れさせない。折り目はカットではない:蝶番の基部やパネルの接合部にはエッジを付けない。どのカードも刃のように薄いスライバーとして横から見えてはならない。
  6. 世界を見下ろすマクロレンズ。 長焦点レンズ(垂直画角24~32度)、カメラは下向き40~55度。プリントされた地面はフレームのすべての端を超えて広がる:地平線、空、背景、本の端、テーブルは視界に入らない(ブリーフが文字通り本やUI内のページでない限り)。被写体のシーン上で、フレーム高さの約36~45%をカバーする1つのシャープバンド(計測:measure.py focusHeight >= 0.35)。上下に向かってぼけが大きくなり、1080pで半径12~18ピクセル(3Dテンプレート18、2Dテンプレート9(Canvasのblur()シグマ))。深度と画面高さの両方で駆動される。フレームの下端に重なる大きなぼやけた作品は、ミニチュアのスケール感を強く売り込む。
  7. ブリーフ独自のパレットを、紙の方法で構築する。 被写体、雰囲気、時間帯から色を導き出す(palettes.md セクション3)。決して例のシーンや出発点のパレットの16進数をそのまま使わない(ブラインドテストでは、宇宙ステーションに例の屋根や緑がコピーされた)。残るもの:作品がまとう1つの主要なファミリー。淡く彩度の低い地面の上に配置する(カードより約0.16~0.22明るく、約0.16~0.25彩度を下げる)。これにより、作品が色を運ぶ。すべての作品は、そのベースとコントラストする1つまたは2つのアクセントを持つ(さびたドームにクリーム色のリベット、オレンジの木に赤い葉)。同系色は禁止。ビデオゲームの緑ではなくセージ、白ではなくクリーム、黒ではなく暖かいインク。フレームの平均彩度(HSVのS)は約0.55~0.75。グレーディングは書かれた色を暖かくする(オリーブカーキの地面はマスタードに、灰色がかったティールセージは ) 。作者は地面と水を一段青く灰色にし、フレームをチェックする(measure.py --palette)。
  8. 密度が高く、塊状で、判読可能。 平らな場所に置かれた小道具ではなく、完全な模型の世界:約20種類、100~250個の作品(フレーム内に底面がある自立カード)。それらは4~8個の異なる作品からなる密集したグループを形成する(田舎の例:木、低木のカード、岩、花、動物。サンゴ礁:サンゴの頭、スポンジ、昆布、魚。宇宙ステーション:木箱、配管、ランプ、ロボット)。視界にある同一の小道具は最大約3つまで。シャープバンドは密集していること(measure.py barePct <= 約55)。開けた地面は主にその外側にある(小道、水、いくつかの空き地)。地面は平らに保つ:高さは、入れ子になった平行なカード(3~5枚の湾曲したセイル、明度が約10~15%ずつ異なる:丘、砂丘、土手、雪の吹きだまり)と露頭によって生み出される。決して盛り上がった地形ブロックではない(mechanisms.md セクション8)。主人公はスケールフィギュア(3Dで3.6単位、2Dで約3.2単位。場所のみのブリーフは数体のフィギュアを保持する)。フレーム高さの6~10%。あらゆる面から読め、歩く方向を向く小さな3D紙模型(約10~20枚のカード。各部分は正面のカードの背後にプロフィールカード。脚と腕は歩いた距離に応じてスイングするピボットに取り付けられる。前傾と旋回時のロール)。決して1枚の平らなカードではない。判読可能な顔、衣装のディテール、塊状のおもちゃのようなプロポーション、地面とコントラストする色を持ち、シャープバンド内に立つ(mechanisms.md セクション12、motion.md セクション8。例のシーンのheroDollは1つのモデル)。作品は彼に対して塊状である(サイズとレイアウト:worlds.md セクション8~9)。それ自体がランドマークである主人公はフレームの25~35%を占めてもよい。高いランドマークは、上端でカットされた積層フラットである。
  9. 歩かれたり、下に入ったり、中に入ったりするものは3Dで構築され、決して自立するフラットではない。 自立カードは、正面から見られ、その周りを歩かれるもの(木、低木、小道具、クリーチャー、遠景の丘)のみに使用する。歩行可能な高さはオープンな構造である:橋は、アーチ型のカットを持つ外側に傾斜した欄干の側面の間に、デッキランプとクラウンパネル(板を渡したもの)がある。桟橋、突堤、展望台は、支柱の上の板張りのデッキ(支柱の面を持つplatform()、隙間はベースまでカット)。階段は、2段の階段状の側桁の上の薄い踏板(蹴上げは主人公の高さの約1/8以下)。通路は、2枚のサイドカードの間の板張りのデッキ。印刷された面を持つ中実の箱(terrace())は、ブリーフが指定する石積み(岸壁、ステージ)にのみ使用し、自然の地形には決して使用しない。内部に入るものは、開口部を持つ箱折りである。水、小道、野原はページに印刷される。歩行ロジックは同じ構造を読み取る:デッキ上の足。欄干、壁、水は主人公を止める(WalkField、mechanisms.md セクション14)。
  10. 紙は折り目を中心に回転することで動く。 8~15%の行き過ぎと2~3サイクルの震えで速やかに立ち上がり、約1秒までに静止する。倒れるときはよりソフトに、地面に1回軽く叩きつける。パーツのタイミングを0.05~0.1秒ずらす。スケール、ストレッチ、フェードインは行わない。連続的な動き(アイドル時の揺れ、歩行時の上下動)は控えめに保つ:ユーザーは批評家依頼の上下動を2~3倍削減した。
  11. 音がある場合、それは柔らかく、低く、鈍く、まばらである。 ノイズベースのフラップ、ジェスチャーごとに1つ、少なくとも約0.5秒の間隔。

2. コードの前に:紙の仕様書を書く

このブロックを計画(またはメインファイルの先頭のコメント)に書き、すべての行に数値を入力します。次に、それを監査します:「この正確な仕様を、類似したプロンプトに対して書くだろうか?」もし「はい」なら、パレット、印刷されたモチーフ、シルエットを被写体自身の世界に向けて押し出す(火星のドームには、印刷されたリベットとパネルラインを持つさびた酸化鉄のカードを。サンゴ礁には、スカラップ状の縁を持つサンゴ、昆布、ティールの水のカードを。テンプレートの田舎のデフォルトは決して使わない)。被写体によって変わるもの:シルエットと印刷されたモチーフ、パレットとムードライト、形状を構築するメカニズム、主人公が歩くもの、レイアウト、そして紙のフラップの下にある世界独自の音。決して変わらないもの:法則1~11。

SUBJECT    世界とそのひねり(このプロジェクトだけが持つもの)、そして読者が最初に見るもの
STOCK      レイヤーごとの紙(カードストック / クラフト / 水彩紙 / 建築用紙 / ティッシュ / 段ボール)、繊維量
PALETTE    このブリーフから導き出された4~7色の16進数(palettes.md セクション3)、役割付き:地面の明/暗、主要ファミリー、
           2つのコントラストアクセント、インク、影の色合い、もや。例からコピーされたものは一切なし
LIGHT      キーライトの色 + 方向(方位角 / 仰角 度)、フロントフィル比率、影の色合い、夜間 / 実用的な光源
LENS       fov、ピッチ(40~55)、シャープバンドのフレームに対する割合、最大ブラー px@1080、フレーム下端に重なるもの
GROUND     この世界の床が何でできているか、そしてその独自の特徴(デッキプレート、砂の波紋、雪の吹きだまり、苔、
           タイル)。水はブリーフにある場合のみ
LAYOUT     被写体独自の導線(小道、廊下、海流、スキーコース、水路)、ランドマーク、主人公の位置、
           グループと空き地、作品の種類(15~25)
MOTION     使用するメカニズム、立ち上がり/倒れるタイミング、タイミングのずれ、アイドル時の揺れの振幅、カメラの挙動
SOUND      なし | フラップ + 足音(+ 音楽);レベル
BANNED     特徴(`look.md` セクション12)+ この作品が決してなってはならないもの
QA         キャプチャするフレーム/サイズと、それぞれが示すべきもの

3. 構築パスを選ぶ

タスクに必要なものだけを、必要なときに読む(すべてのファイルは references/ 内)。最初のフレームの前に最低限必要なもの:

  • 3Dシーンまたはゲーム: assets/templates/popup-3d/ から開始(harness.js はそのまま + あなた自身の scene.js)。three-js.md のセクション1、3、5、8、procedural-art.md の0、3、4、mechanisms.md の5、7、8、12、14、look.md の5、8b、11、palettes.md の3を読む。
  • 2Dシーン、イラスト、横スクロールゲーム: assets/templates/popup-2d/ から開始(harness-2d.js はそのまま + あなた自身の scene.js)。three-js.md の代わりに web-2d.md のセクション2~3を読むこと以外は同じ。
  • WebページまたはアプリUI、HUD、メニュー: paper-ui.md、web-2d.md のセクション4~5(CSSとSVG)、palettes.md の3。
  • ビデオ: motion.md のセクション11、次に2Dまたは3Dパスとその step() キャプチャ。
  • 非ブラウザエンジン(Godot、Unity、Unreal、Blender):engines.md(移植ノート、未テスト)とテクスチャファイル用の scripts/paper_textures.py。

その後、質問が出てきたら:

質問読むべきものキット
作品:小道具、キャラクター、建物、クリーチャー、機械、植物procedural-art.mdprintCard + P.layer / P.parts または drawnPiece
構造:十字、箱折り、プラットフォーム、積層フラット、橋、桟橋、階段mechanisms.md(14: 構築された地面)hinge、crossCard、layeredCard、boxFold、platform、WalkField
タイミング、ばね、パペット、カメラmotion.mdFlapSpring、windSway、FixedClock(lib/paper-motion.js)
無限の世界、主人公を追うカメラ、構図worlds.md例の scene.js のフィル
色;サウンドと音楽palettes.md;sound.mdassets/palettes.json;lib/paper-sound.js
計画、計測、批評、仕上げprocess.mdscripts/measure.py、scripts/ab_sheet.py

あなた自身の作品を書いてください。 assets/lib/ は、このスタイルのすべてのプロジェクトがインポートできる基盤です(自分のフォルダにコピーするには:three-js.md セクション1、web-2d.md セクション3)。あなたの世界のすべてのモノ(木やサンゴ、家やドーム、橋やガントリー、クリーチャー、主人公)は、リファレンスのレシピを使って被写体のためにデザインします。assets/examples/ とテンプレートのシーンは、そのようにして構築された1つの田舎の世界です。レシピがどのようにコードになるかを理解するためにそれらを読み、決して新しいパレットでそれらの部品から火星基地やサンゴ礁を組み立てないでください。シーンを置き換え、ハーネスは維持してください。examples/built-ground.js からの構造(bridge、stairs、ramp;terrace は石積みのみ)は、それが適合する場合、あなたのプリントを paints を通してインポートできます。ほとんどのブリーフは独自の構造(杭の上の桟橋、たるんだロープ橋、ガントリー)を必要とし、platform、boxFold、makeCard、hinge 上で同じ方法で構築します。

4. ワークフロー

  1. 仕様とターゲット。 紙の仕様を埋めます。ターゲット画像が1つある場合(ユーザー提供または生成)、scripts/measure.py で計測します。そうでなければ、仕様の数値がターゲットです。
  2. 1枚のテストカードで素材を証明する コンテンツを構築する前に行います。1枚の印刷されたカードが、最終的な光源とレンズの下で、印刷された地面の上に立っているもの(3D:?test、シーンが H.flags.TEST で分岐するようになったら:three-js.md セクション1)。チェック:マット、暖かいコンタクトシャドウ、カットエッジ(濃い線 + 光源側のハイライト)、繊維

関連スキル