lamina は何をしますか?
1つの機械、1つのモデル、1つのページ。読者は短い解説をスクロールし、その機械に何度も出会います。全体、内部、メカニズム単体、動作、分解図。すべてのフィギュアは同じ監査済み3Dモデルなので、ページ上の情報が互いに矛盾することはありません。
SKILL_DIR はこのファイルがあるフォルダです。examples/colibri/ は完全なページの例です(12gのロボットハチドリ、44パーツ、6つのフィギュア)。始める前にこれを読み、構造をコピーしてください。
cd "$SKILL_DIR" && npm install && npx playwright install chromium # 一度だけ
python examples/colibri/model.py --audit # モデル → colibri.glb、`audit passed` と表示されなければならない
node build.mjs examples/colibri # → out/colibri.html、単一のオフラインファイル
node scripts/shots.mjs out/colibri.html # すべてのフィギュアのスクリーンショット + コントロールチェック
bpy モジュールの代わりにBlenderを使う場合: blender -b -P examples/colibri/model.py -- --audit
ワークフロー
以下の順序で作業します。品質の大部分はステップ1~3、メッシュ作成前に決まります。
- まず真実を集める。 実際の数値を収集します。サイズ、質量、速度、歯数、減速比、限界値。それらを検索します。小さな純粋なモジュール(
kin.js)にまとめ、ページ内で出典を明記します。発明したパーツには発明した名前を付けます。実在のブランドではなく、モデルコードを持つ架空の製品として。 - 1つの入力。 機械を駆動する単一の変数に名前を付けます(クランク角度、ストローク、バルブ位置)。すべてのポーズとすべての読み取り値は、その変数の関数です。
- パーツリストとレイアウトを紙で設計。 アセンブリごとにグループ化された40以上のパーツ。それぞれが何の上に配置されるか。モデリングの前に数値でメカニズムをレイアウトします。ギア中心間距離 = (z1 + z2)·m / 2、シャフトの位置、何が何をクリアする必要があるか、すべてのシャフトがシェルをどこで貫通するか。リストを
model.pyの先頭に書きます。 - Blenderでモデリング(
blender/tdb.pyを使用。「モデリング」を参照)。 - 監査して干渉をゼロにする。
python model.py --auditがaudit passedを表示するまで繰り返します。 - ページを作成(
kit/page.jsを使用。「ページ」を参照)。4~7つのフィギュア。それぞれが1つの質問に答えます。 - 確認する。
node scripts/shots.mjs out/<name>.htmlでchecks passedと表示される必要があります。次に、出力されたすべてのPNGを確認します。すべてのチェックに合格するまで修正と繰り返しを行います。
ページの残りを書く前に、1つのフィギュア(完成した機械全体、ビルドしてスクリーンショットまで)をユーザーに早めに見せてください。
モデリング
曲線的なボディ、メカニズムの上のシェル、または互いにすれ違うように動くパーツを持つものはすべてBlenderでモデリングします。three.jsのプリミティブをタイプ入力して作るのではありません。目視で配置したプリミティブは、パーツが互いに突き抜ける原因になります。
- ボディは解析的表面であり、決して球体やそれを代用する旋盤加工品ではありません。 コントロールセクションを定義し、
splineで結合し、表面をpatch(surf, u0, u1, v0, v1, thick=0.7)でパネルに分割します。実際の厚み、パラメータ範囲をスキップした実際の隙間、すべてのエッジに面取りを施します。 part(name, bmesh, mat, asm, bevel, cut, explode, open, mats)は、1つの閉じたパーツをその親フレームに登録します。cut=[...]は正確なブーリアンで減算します。シェルを貫通するすべてのシャフト、脚、目、ケーブルに対応する穴を開けます。carve()は、パーツに溶接される前にピースを切り出します。- 1つの溶接構造は1つのパーツ(
join)です。キール、リングフレーム、プレート、ポスト、ボス。ボルト、ハッチ、通気口は、それらが属するパネルに融合されます。監査はパーツ間で行われるため、何を1つのパーツとするかを意図的に決定します。 - 動作:
joint(part, 'rev' | 'slide', axis, law, input)で、value = k·q + a·sin(h·q + p) + c + b·tanh(g·cos q)とします。rig_input(name, lo, hi, samples, rest)は監査がスイープする入力を宣言します。mate(a, b, depth)は噛み合う歯を宣言します。gear_info(...)はギアとラックを宣言します。frame(...)はジョイントを保持する空のオブジェクトです。anchor(name, at)は名前付きの点です。 - 接触は面一(0.05 mm隙間)、接線、またはリム面上です。 何かが何かにめり込んではいけません。浮いているパーツはバグです。ブラケットを取り付けてください。
- マテリアルは名前(
shell、orange= アクセントカラー、ink、dark、steel、brass、carbon、lens、membrane、pcb)です。ページがそれらに外観を与えます。mats={'orange': predicate}でパーツの領域を塗り分けます。
監査
blender/audit.py は、ページが使用するのと同じジョイント法則でモデルをすべての入力に対してポーズし、実際のメッシュで以下を証明します。
| チェック | 意味 |
|---|---|
| 干渉 | 静止時、すべてのサンプリングポーズ時、または分解時に、2つのパーツが互いに貫通しない。宣言されたマッチングは、深さまで重なり合う可能性がある。 |
| サポート | すべてのパーツが別のパーツに接触し、すべてが1つのアセンブリとしてまとまっている。 |
| ギア | 中心間距離 (z1 + z2)·m / 2、逆速度比、ラック移動量 = ピニオン角度 × ピッチ半径。 |
| 閉じている | すべてのパーツが閉じたボリュームである。シートは厚みを持つ。 |
各失敗は、ペア、ポーズ、深さ、点を特定します。ジオメトリを修正します。 移動、縮小、穴あけ、レイアウト変更、ストローク短縮を行います。決して、マッチングの深さを広げたり、パーツを削除したり、ポーズをスキップして監査を黙らせてはいけません。監査が実際の数値が合わないことを示した場合、ページの数値も変更します。実行できない場合(Blenderもbpyもない場合)は、その旨を述べ、モデルを完成したと見なさないでください。
ページ
kit/rig.js はGLBを読み込み、ポーズを適用します。rig.pose(inputs, {explode, focus, open})。kit/page.js がページです。
import {createPage} from 'lamina-kit/page.js';
const P = await createPage({title, model}); // model: {root, meshes, update(state)}
P.header({code, kicker, name, sub}); P.lead('…'); P.h2('01 — El conjunto', '…'); P.text('…');
P.figure({n: 1, title, cam: {az, el, d, ty, tz}, controls, step: (fig, dt) => state, readout: (fig, state) => html});
P.caption('<b>Fig 1.</b> …'); P.chain([...]); P.table([...]); P.footer(left, right); P.start();
- すべてのフィギュアに1つのレンダラー。 表示される各カードは、ポーズ、レンダリング、独自のキャンバスにコピーされます。フィギュアごとにWebGLコンテキストを作成するのは避けてください。
- フィギュアの
stepは、model.updateのための状態を返します。state.look(part, asm)は、すべてのメッシュに対して'solid'、'ghost'、'hide'のいずれかを返します。これにより、1つのモデルが機械全体、内部、メカニズム単体になります。 - コントロールは少数かつ実用的に。 最大でも一時停止、3つの速度、フィギュアごとに1つのスライダー(
P.range、P.speeds、data-pp)。ネイティブ入力のみ。コンソール、ダッシュボード、タイムライン、ステータスパネルは使用しません。 - 名前付きパーツ:
...P.partsPanel(PARTS)で、各パーツに1行の説明のボタンを追加します。1つを選択するか(またはフィギュア内でクリックする)、残りをゴースト表示にしてカメラをそのパーツに移動します。PARTSは[name, /regex/, line]です。 - 検討するフィギュア(この順序): 動作中の機械全体 · 内部(スライダーでシェルを持ち上げる) · メカニズム単体、スロー再生、スクラブ可能なフェーズ · 重要な動作、トレース付き · 補償機構またはリミッター · 名前付きパーツ付き分解図。最後に、数値の表。
文章
デフォルトはスペイン語(ユーザーの言語に合わせる)。簡潔に。2文のリード文。フィギュアごとに、見出し、何を見るべきかとその理由を2~3文で、フィギュア、そして1つの事実を含むキャプション。テキスト内のすべての数値はモデルから取得します。何が架空で、実際の数値がどこから来たのかを明記します。
外観
常にダーク。ページ #0e0f11、テキスト #ece8df、アクセントカラーは金 #d4a94e。各カードはモデルの背後に柔らかな光のプールを持ち、暗いパーツが輪郭を保つようにします。モデルは白と金。光沢のある白いシェル、金は orange マテリアルがマークする部分、下はグラファイトとスチール。テキストはInter、ラベル、数字、ボタンはスモールキャップスのJetBrains Mono。
暗いページ上の暗いパーツはエッジを失います。黒は少数のパーツに限定し、内部のメカニズムはスチール、アルミニウム、真鍮にし、fig*-part.png で選択した各パーツが背景に対して確認できるようにチェックしてください。
レビュー
ページを閲覧することはできません。フレームを読み取ることはできます。scripts/shots.mjs は top.png、figN.png、figN-part.png、phone.png を書き出し、すべての一時停止ボタンを押し、すべてのスライダーを動かし、パーツを選択し、コンソールエラーを報告します。その後、以下を確認します。
- モデル。 現在のファイルで
audit passed。一目で本物と読めること。4倍拡大でもむき出しの面がないこと。 - 各フィギュア。 1つの主題。カードの半分を占め、クリップされていない。カード内に影があること。読み取り値が正しいこと。
- 各コントロール。 キャプションが変更されると言っているものを実際に変更すること。
- テキスト。 すべての数値が読み取り値と表と一致すること。
- 電話表示。 390pxで1カラム。横スクロールがないこと。
確認できなかったこと(実際のGPUのフレームレートなど)があれば、それを明記してください。
クレジット
laminaは、teardown(elvarofficial)、anatomy(Ryan)、claude-motion(whaleyxbt)のアイデアを統合しています。すべてMITライセンス。CREDITS.mdを参照。