forge3d は何をしますか?
あなたは3Dジオメトリをうまく記述できます。しかし、単独では画像を計測したり、コードの出力を確認したり、モデル全体を視野に入れながら各パーツに完全に注意を払ったりすることはできません。forge3dはこれら3つを提供します:参照を計測し、すべてのビルドをその隣に表示し、モデルをパーツに分割して、それぞれを共有フレーム内で個別にスカルプトしてチェックします。外部で構築されたモデルには、参照と照合する仕組みがありません。
F3D="<このSKILL.mdがあるフォルダ>/scripts/f3d.py"
python3 "$F3D" doctor
新しいシェルを起動するときは、絶対パスのランチャーパスを使用してください。現在の作業フォルダで作業します。デスクトップに添付されたファイルを使用する場合は、「ユーザーが言及したファイル」の下にあるパスを使用し、それが別の場所にある場合は作業フォルダにコピーします。両方のファイルパスを引用符で囲みます。無人ビルドの場合は、図面からルーチンデザインの詳細を決定します。参照から構築します:ユーザーが指定しない限り、以前のモデルを再利用するために他のフォルダを探してはいけません。
既存のモデルを改訂する場合は、コピーで作業します。要求されたスロットを、完成した隣接スロットに対して再構築し、組み立てられたシーンで検査し、承認されたジオメトリを保持します。顔の修正では、既存の髪と体を全体にわたって使用できます。すべてのスロットを再構築すると、ユーザーの承認済み作業が破棄されます。
Blenderはすでにここにあります。 f3dはプライベートなヘッドレスBlender(bpyモジュール、~/.cache/forge3dにあります。サンドボックスがそのフォルダを禁止する場合はF3D_HOMEを設定)を実行します。Blenderアプリをインストール、ダウンロード、または検索しないでください。すべてのビルドはBlenderアプリで開くことができる.blendファイルを保存します。python3 "$F3D" python script.pyで任意のBlender Pythonスクリプトを実行できます。
f3dコマンドは5~120秒かかります。フォアグラウンドで実行し、ポーリングする代わりに1回の呼び出しで待機します(Codex:yield_time_msを120000以上に設定)。ワークファイルは/tmpではなく、作業フォルダに保管します。
全般の規約:メートル単位、Z軸上方向、被写体はz=0、x=y=0に立ち、-Y方向を向きます。+Xは正面図で見る側の右です。参照被写体は、--heightを渡さない限り高さ1.0です。
参照画像はデザイン図面であり、写真ではありません。 ターンアラウンドシートは、大まかに一致し自由にごまかす3つの図面です:プロフィール図は正面図が示すのと同じ目を描き、弓と耳はすべてのビューで見る側を向き、尾は表と裏で紙の同じ側にあります。それによって、どのパーツがあり、どれくらい大きく、どこにあり、どの色で、どのような詳細があるかがわかります。それを一貫した1つの3Dオブジェクトとして構築します。
どのルートを選ぶか
- キャラクター、クリーチャー、複数のものから成るもの -> 以下のパーツルート。
- いくつかの形状からなる単純なオブジェクト(マグカップ、剣、木箱、ローポリプロップ) -> 1つのスクリプトとキットを使用し、
python3 "$F3D" build model.py --ref refsを実行。references/modeling.mdを参照。 - Blockbench -> 上記のいずれかに加えて、以下の「Blockbench」を参照。
- 参照画像がない、または1つのビューしかない場合で、画像を生成できる場合 -> まずターンアラウンドシート(正面、左向き側面、背面;正投影、同じスケール、共通の地平線、真っ白な背景、フラットな照明、テキストなし)を作成します。プロンプトはreferences/reference-and-gen3d.mdを参照。
パーツルート
順番に、どれも飛ばさずに:(1) f3d ref を実行し、待機します。(2) 在庫を確認します。(3) blockout.py と f3d blockout を実行します。(4) f3d next を繰り返し実行します:それが生成すべきサブエージェントを指定します。このスキルはそれらを要求します:ビルダー、独立したレビューア、そして修復者。(5) model.py、f3d build を実行し、納品します。あなた自身の作業はレイアウトとメモの作成です。構築と判断はエージェントの仕事です。
1. 参照を計測する
python3 "$F3D" ref sheet.png -o refs (30~90秒) は、被写体を切り抜き、ターンアラウンドシートをビューに分割し、すべてのビューを座標グリッド上に配置し、被写体がインクの輪郭線で描かれているかどうかを報告します。何かを書き始める前に、これが完了するのを待ってください:後続のすべてのステップはその画像から計測され、その間に生のシートからタイプされたジオメトリはやり直す必要があります。refs/overview.pngを開き、ビュー名を確認します。間違っている場合は、--views front,right,back(読み順。rightはその画像で被写体が左を向いていることを意味し、leftは右を向いていることを意味し、skipは画像を無視します。例:背面の2番目のポーズ)を付けて再実行します。
2. 在庫を確認する
返信でパーツをリストアップします:それ自身のマテリアルを持つか、一体として外れるであろうすべてのものです。キャラクターの場合は通常9~14個です。キャラクターにはボディがあり、それは一つのパーツです:bodyは首、胴体、腰、および腰に続く脚を1つの連続したソリッドとして含み、その他すべてが載るベースです。衣服はその上にあるパーツです(on="body"):スカートやジャケットを、下のボディなしで構築すると、中空のチューブになってしまいます。次に頭(顔はこれに属します)、髪(長いまたは詳細な髪は2つのパーツ:前髪とサイドロックのhair_front、後ろのhair_back)、各衣服、各アクセサリー、腕と手、靴、尾。マテリアルが変わる場所、あるものが別のものの上に重なる場所、何かが繰り返される場所(ペアは1つのパーツ)で分割します。各パーツについて、ビューがごまかす箇所で3Dの真実を一度決定します:それがいくつあるか、実際にどこに座っているか、実際にどの方向を向いているか。衣服が関節を覆う場合は、その下の解剖学的構造を所有するスロットを指定します。たとえば、腕と手首はボディまたはアームスロットに配置し、カフはスリーブスロットに配置します。両方の太ももは、プロファイルで隠れている側も含めて骨盤に結合する必要があります。別のスロットがふくらはぎやストッキングを提供する場合は、on=を使用して解剖学的構造に取り付け、ツールが両側を独立してチェックできるようにします。
3. ブロックアウト
blockout.py を記述します:モデル全体を、大まかで塗装されていないプレースホルダー形状で表し、それぞれを正しい位置に正しいサイズで配置し、それぞれをスロットに割り当てます。これが、個別に構築されたパーツがフィットするための契約です。位置とサイズは refs/<view>_grid.png から読み取ります。
# blockout.py
from forge3d import kit as k
head = k.sphere(radii=(0.215, 0.20, 0.225), at=(0, 0.005, 0.635))
k.slot("head", head, review="face", note="小さな耳を持つちびヘッド。描かれた目の開口部、視線、眉、口に合わせてください。頬、鼻、あごをプロファイルから形成します。髪は眉の一部を覆います。")
skirt = k.cyl(r=0.235, r2=0.085, h=0.20, at=(0, 0, 0.17))
k.slot("skirt", skirt, on="torso", note="ベル型の紺色スカート、プリーツ入り、裾の近くに金の刺繍バンドが一周し、その下に白いスカラップのペチコートフリルがあります。")
bows = [k.box(size=(0.07, 0.10, 0.09), at=(sx * 0.275, 0.09, 0.645)) for sx in (-1, 1)]
k.slot("bows", bows, on="hair", note="金色のビーズが付いた水色のリボンリボンのペア。すべての絵はそれらを見る側に向けて描いています。3Dでは、頭の側面で外側と少し前方を向いて座っています。")
- 形状:
k.sphere(radii=)、k.box、k.cyl、k.loft、k.sweep(path, r=):大まかで問題ありません。 on=:パーツが載っている、または吊り下がっているスロット。パーツは、それが載っている完成したパーツに対して構築されるため、実際に載っているものだけを指定し、チェーンは短く保ちます。note=:パーツのビルダーが画像以上に知ることになるすべて。それが何であるか、そのマテリアルと色、それが持つすべての特徴、そしてビューがごまかす箇所であなたが決定した3Dの真実を述べてください。あいまいなメモはあいまいなパーツを生みます。review=:スロット名があいまいな場合に焦点を絞ったチェックを割り当てます。表情を運ぶパーツにはface、詳細な房にはhair、股関節から脚への接続を所有するボディにはjointを使用します。ユーザーが優先する別の機能にはdetailを使用します。通常のパーツはアセンブリレビューを共有します。通常のhead、hair、bodyの名前はすでにチェックを選択します。顔には1つの所有者を割り当てます。
python3 "$F3D" blockout blockout.py --ref refs # 10秒 -> parts/: plan.json, overview.png, スロットごとの作業指示書
parts/overview.png と parts/blockout_compare.png を開きます。参照のすべてのパーツには、おおよそ正しいサイズで正しい位置にスロットが必要です(アウトラインIoUが約0.8で十分)。修正して、それが維持されるまで再実行します。
4. f3d next で構築とレビュー
python3 "$F3D" next # すべてのパーツの状態と、今まさに生成すべき正確なエージェントを出力します
このスキルは明示的にサブエージェントを要求します。 f3d next が出力することを実行し、DONE と出力されるまで再度実行します:
- Codexでの複雑で参照駆動型のビルドの場合、リーダーとして
gpt-6.2-astraから始めてください。アカウントがgpt-6.2-solを提供し、スポーンツールがエージェントごとのモデルを受け入れる場合は、それをパーツビルダーに設定します。リーダーは計画、アセンブリ、最終検査に留めてください。Sol主導のセッションでもワークフロー全体を実行できます。クライアントがサブエージェントのモデル選択を公開しない場合は、モデルを設定せずにデフォルトを使用します。 - 最大3つの独立したジョブを同時にディスパッチします。新しいビルダーやレビューアには
spawn_agent、fork_turns: "none"、出力されたタスク名、努力量、メッセージを使用します。ワーカーが報告するのを待ってから、nextに準備完了のジョブを問い合わせます。各パーツに1つのアクティブな所有者を与えます。修理は、利用可能な場合はfollowup_taskを使用して元のビルダーに送信します。レビューアは独立したままです。 - すべてのビルダーは、フィット感とレンダリングを検査します。顔や詳細な髪は、独立したクローズアップ検査を受け、修理後には集中した検証を受けます。ボディまたは指定された詳細は、1つの独立したチェックを受けます。他のパーツは、ビルドレポートが構造上の問題を報告しない限り、アセンブリレビューを共有します。描かれた髪の交差を維持し、外側の衣服が覆っている場合でも、各太ももをフィットした股関節カットでチェックします。
f3d reviewは、完了したスロットを組み立てて画像を生成します。所有者ごとに修理を要求します。その2回目のパスでは、これらの所見と修理によるリグレッションを検証します。パーツが落ち着いたら、一度にビルドを提供します。キャップ時に未解決の所見を、最終保存シーンで検査します。
サブエージェントツールが存在しない場合のみ:各パーツをそのブリーフから自分で構築します(references/parts.mdを参照。直方体モデルの場合はreferences/blockbench.mdの「直方体パーツの構築」を参照)。同じ next スケジュールに従い、視覚的チェックにはreferences/review.mdを使用します。
5. 組み立てと納品
# model.py
from forge3d import kit as k
parts = k.assemble() # 各スロットにすべての完成パーツ、残りはグレーのブロックアウト形状
k.outline() # 図面のインク線をすべての個別ピースの周りに追加(f3d ref が線画を報告した場合)
k.export("out/name.glb") # .fbx .obj .stl .usdz .bbmodel も可能
python3 "$F3D" build model.py --ref refs (1~2分) はモデルをリントし、out/model_sheet.png と out/model_compare.png をレンダリングし、out/model.blend を保存します。f3d next が DONE と表示した後、自分で一度確認します:python3 "$F3D" view out/model.blend --views az40el10,az-40el10,az140el10,az0el-50 --tile 1024 --cols 2(最後の1つは下からのビュー)。レイアウトの所見は blockout.py で処理し、f3d blockout を再実行し、f3d next に従って影響を受けるスロットを再調整します。レビュー制限では、リストされた所見を納品前の最終保存ビルドと比較します。
完了の意味:f3d next が DONE と出力すること。クリーンなリント。すべての描かれた特徴が完全で、正確に一度だけ存在し、何も浮いておらず、中空でも埋もれてもいない3/4ビュー。すべてのビューでアウトラインIoUが約0.85以上。ただし、あなたがビューがごまかしていると判断した場合を除きます。
要求されたものを納品します:エクスポート、.blend、プレゼンテーションレンダリング(k.stage、k.camera、k.render、デフォルトのEEVEEエンジンを使用。references/modeling.mdを参照)。最終的な数値をユーザーに伝え、比較画像と3/4ビューを表示し、何が簡略化されているか、レビューで何が未解決のままか、どのビューの違いを意図的に残したかを明確に述べます。
顔が見えるキャラクターの場合、最終ステージングファイルから python3 "$F3D" portrait out/name.blend をレンダリングします。実際の髪、マテリアル、ライトを使用して、表情、目の深さ、頬と口の影を検査します。シートには、整列されたリファレンスクロップ、正面、プロファイル、両方の3/4クローズアップが含まれます。シーンに複数の顔スロットがある場合は、--slot で1つを選択します。
顔が広すぎる、狭すぎる、または平らに見える場合は、portrait out/name.blend --form を使用して、むき出しのあごと頬のプレーンを比較します。遮蔽されていないランドマークごとに、測定された正面リファレンス座標を使用して --span Z LEFT_X RIGHT_X を渡します。ツールはそこでのメッシュ幅を報告し、2つのリファレンスエンドポイントをマークします。
Blockbench
どの種類のBlockbenchモデルが求められているかを尋ねる(または推測する)。それらは異なる製品です:
- メッシュモデル(リファレンスに最も近い。スムーズな形状と実際のテクスチャ。Generic Model形式):上記のようにモデルを仕上げ、スクリプトで
k.export("out/name.bbmodel")を使用するか、python3 "$F3D" bb mesh model.py --ref refs -o out/name.bbmodelを実行します。すべてのオブジェクトは、名前付きの編集可能なメッシュになります。 - デザインされた直方体モデル(ボーン上のボックスとピクセルアートテクスチャ。Minecraft Mod、Bedrock/Javaエンティティ、アニメーターが必要とするもの)。複数のパーツからなる被写体は、ブロックアウトに
bb.plan(height=80, format="bedrock")という1行の追加でパーツルートをたどります。すべてのパーツはボーン上の直方体として構築され、bb.assemble()で結合されます。単純なモブやプロップは、bb.Modelを使用した1つのスクリプトです。 - ボクセルモデル(任意のモデルのブロック状の彫像、多数の直方体、リグなし):
python3 "$F3D" bb voxelize model.py --ref refs --height 48 -o out/name.bbmodel。
単に「Blockbenchで作って」と言われた場合は、直方体モデルを作成します。それがBlockbenchの目的であり、機械的、ブロック状、またはピクセルアートの被写体に適しています。柔らかく曲線的な図面(ちびキャラ、動物)の場合、または要求された場合にのみ、代わりにメッシュモデルを作成します。どちらを作成したか、もう一方も利用可能であることを伝えます。
Blockbenchがインストールされている場合、実際のアプリでファイルを確認します:python3 "$F3D" bb check out/name.bbmodel は、それをプライベートな非表示のBlockbench(オフライン、独自プロファイル)で開き、ロードされたものを報告し、Blockbench自身のビューを保存し、Blockbenchのエクスポーターを実行できます(--export bedrock:out/name.geo.json)。
API、形式、ピクセルアートのガイダンス:references/blockbench.mdを参照。Blockbenchスクリプトを書く前に読んでください。
問題が発生した場合
- パーツが不足している
…
[翻訳のため一部省略]