pcb-product-render

PCB 製品レンダー

ユーザーが KiCad PCB を STEP／GLB にエクスポートし、リアルな製品画像としてレンダリングしたい場合に、このスキルを使用します。目指すのは、すっきりした製品写真またはレンダーであり、平面的な KiCad プレビューやベクター風の正投影図ではありません。

必須のワークフロー

1. プロジェクトのルートと、正式な .kicad_pcb を特定します。ユーザーが「最新の基板」と指定した場合は、レンダリング前に必ず STEP と GLB を再生成します。ファイル名だけを根拠に古い GLB を再利用してはいけません。
2. 最新の DRC レポートを実行します。ユーザーが続行を明示的に許可していない限り、違反があれば停止します（以前の許可が適用されるのは、そのプロジェクト／タスクに限られます）。引き継ぎにはレポートのパスと件数を記録します。
3. kicad-cli pcb export step と kicad-cli pcb export glb を、--force --no-dnp --subst-models を指定して実行します。GLB には、トラック、パッド、ゾーン、シルクスクリーン、ソルダーマスクを含め、対応している場合は --cut-vias-in-body も指定します。
4. レンダリング前に、エクスポートしたシーンを確認します。丸みのある基板外形と、すべての取り付け穴／切り欠き穴が存在することを確認します。不要な 3D ヘッダーモデルのみを削除し、フットプリントとパッドは残します。既知のベンダーモデルが見つからない場合は、Blender で決定的なフォールバックを作成し、フォールバックであることを明記します。
5. 少なくとも、ヒーロービュー、俯瞰に近いトップビュー、センサー／詳細ビュー、裏面ビューをレンダリングします。Cycles とノイズ除去を使用し、Blender の終了コードが成功したことだけでなく、実際の PNG を確認します。
6. 寸法、出力のタイムスタンプ、ギャラリー／サーバーの各エンドポイントを確認します。HTML ギャラリーがすでに存在する場合は、リンク切れを起こさずに更新できるよう、ファイル名を維持します。

マテリアルの目標

• 青いソルダーマスク：深いロイヤルブルーの LPI 樹脂で、非金属、適度な光沢があり、つや消しでも鏡面仕上げでもない質感にします。コートの粗さを低く抑えた滑らかなクリアコート、控えめなマイクロラフネス／バンプ、わずかな光学的深みを使用します。コントラストの強いプロシージャルな粒状感は避けます。
• むき出しの FR-4：落ち着いた温かみのある黄褐色／琥珀色のグラスファイバーで、ルーティングされたエッジにはわずかな曇りと半透明感を持たせます。透過、サブサーフェス、ボリューム吸収を制御し、柔らかなアンダーライトを使用します。ラミネート越しにステージのグラフィックがくっきりした縞模様として見えないよう、透明度を低く保ちます。開口部からは下のステージが見えてもかまいません。
• ENIG：露出した銅／パッドは、オレンジ色の塗料や生の銅ではなく、淡い金属光沢の金色に見えるようにします。ハイライトが白飛びしてディテールが失われないよう、粗さと照明を調整します。
• はんだ：元のモデルに乾燥したパッシブ部品のブロックがある場合は、パッドとの接合部に小さな銀色の SAC 風はんだフィレットを追加します。不規則で控えめな形状にし、明るい白い点にならないようにします。
• コネクターのプラスチック：わずかに温かみのあるグレーの変化、微細なバンプ、小さな物理的なエッジベベルを持つ、つや消しの成形ナイロンにします。不透明な白いブロックのような見た目は避けます。
• センサーハウジング：控えめな梨地テクスチャを持つ、つや消しのチャコール色の成形プラスチックにします。発光部／受光部のマテリアルは、ユーザーの参考画像に合わせます。

カメラとステージ

トップビューは、正投影の CAD ビューではなく、俯瞰に近い遠近感のある製品撮影にします。基板の厚み、部品の高さ、接地影が見えるように小さな傾きを残し、ステージの周囲には十分な余白を取ります。ダークなブルータリズム風／Marathon 風のステージは使用できますが、色付きのアクセントはオブジェクトを引き立てるものにし、主張しすぎないようにします。基板下のトレーサーやバックライトによってトップビューが図解のように見える場合は非表示にします。柔らかく自然な FR-4 の透過を生み出す場合に限り、残します。

現在のプロジェクト参照情報

このワークフローは、次のプロジェクトを対象に開発されました。

/home/h/Documents/AmericanEmbedded/AmericanEmbedded/VL53L9CX_Pi_Cam

重要なプロジェクト成果物：

• 基板：VL53L9CX_Pi_Cam.kicad_pcb（現在のシーンでは 31 mm × 25 mm）。
• エクスポート用ヘルパー：build/product-renders/export_board_3d.sh。
• Blender シーンビルダー：build/product-renders/build_product_scene.py。
• Blender ソース：build/product-renders/VL53L9CX_STEMMA_QT.glb。
• 最終シーン：build/product-renders/VL53L9CX_STEMMA_QT-product-renders.blend。
• PNG：VL53L9CX-STEMMA-QT-hero.png、VL53L9CX-STEMMA-QT-top.png、VL53L9CX-STEMMA-QT-sensor-detail.png、VL53L9CX-STEMMA-QT-back.png。
• ギャラリー：VL53L9CX-render-gallery.html。現在の設定では http://100.64.84.41:8765/ で配信されています。
• 最新の DRC レポート：build/render-review/drc-latest-render.rpt。ユーザーが以前設定した上書き設定のもとで現在のプロジェクトをレンダリングしましたが、違反が 12 件、未接続項目が 53 件あり、回路図との整合性にも問題が 1 件あります。

現在のプロジェクトでは、レンダリングされたスルーホールのピンヘッダーモデルを意図的に使用していません。フットプリントとパッドは KiCad に残っています。Y1 のベンダー提供 STEP ファイルがない場合は、Blender スクリプト内のカスタム発振器フォールバックで対応します。

引き継ぎ要件

出力ディレクトリ、利用可能な場合はギャラリーの URL、DRC のステータス、欠落モデルに対するフォールバックを報告してください。ローカルファイルには絶対パスでリンクしてください。生成画像を確認せずに、レンダリングをフォトリアリスティックだと表現しないでください。KiCad のフットプリント形状が簡略化されている場合は、ソースモデルに残る制限を明記してください。