Uchusen Rockets ドキュメント

Uchusen Rockets 宇宙船 — line drawings and 3D views of rockets

出典つきの寸法から描いたロケットです。ページに置いて、分解して、回して見られる線画と彩色した3Dビューに加え、ロケットが本当に組み合わさるかを確かめる、型付きのデータモデルを備えています。

インストール

npm install @johnmorrisdotca/uchusen-rockets

最初に読む

• はじめにロケットをページに置き、分解し、見た目を変え、同じロケットをコードから読み取るまでを、10分ほどで体験します。

エントリーポイント

ガイド

やり方

• 見た目・視点・部品ロケットの描き方、見る向き、表示する部品を選びます。HTML、React、コードで同じ言葉を使います。
• 部品からロケットを組み立てる別々のロケットの部品を混ぜ、組み合わせが成り立つかを確かめ、three.js なしでメッシュと図面を作ります。
• エンジンの点火と飛行エンジンを全推力で点火し、公表されたタイムラインに沿って飛行をフェーズごとに再生し、図のどこが出典つきなのかを確認します。
• 同じ縮尺で並べるロケットを同じ基準線の上に同じ縮尺で、定規・人・建物とともに並べます。要素としても SVG のテキストとしても使えます。
• 自分のサイトに載せるスクリプトタグから単なる画像まで、ロケットをページに載せる6つの方法と、彩色したロケットのクレジットが一緒についていく仕組みを説明します。
• ジャーニーモード本物のロケットやSPXフリートの船で、地球から月や惑星まで飛ばします。実際の位置から出す打ち上げの時期、エンジンの噴射、向きの反転、数字を、ふつうの関数として使えます。
• React とその他のフレームワークReact ではラッパーで、Vue・Svelte・Angular・素の HTML ではカスタム要素として、ロケットを使います。どの例もビルドして、ブラウザーで開いて確かめています。
• すぐ使えるファイルと3Dモデル同梱の .glb と .svg をそのまま使い、build で自分用を作り、その中身も確認します。
• バンドラーと CDNunpkg、Vite、webpack からロケットを使う方法を、ビルドしてブラウザーで開いて確かめた例で説明します。
• TypeScript と NodeTypeScript でパッケージの型を使い、Node で DOM も three.js もなしに中核を使う方法を、型検査して実行した例で説明します。

解説

• 型式と出典つきの寸法ロケットがなぜ型式ごとに分かれているのか、数値がどう出典を示すのか、空欄や食い違いが何を意味するのかを説明します。
• ライセンス・クレジット・商標どれが MIT で、どれが CC BY 4.0、パブリックドメイン、ODbL なのか。表示するロケットにどのクレジットが付くのかを説明します。
• 設計データ、部品レコード、図面、メッシュ、要素がどうつながり、なぜ互いに食い違えないのかを説明します。

困ったとき・よくある質問

• 困ったときタグが何も出さない、3Dビューが出ない、彩色モデルが出ない理由と、エラーの意味を説明します。

アップグレード

• アップグレードバージョンの間で、プロジェクトが影響を受けうる変更と、驚かずに先へ進む方法を説明します。

• 変更履歴@johnmorrisdotca/uchusen-rockets 0.14.0 のソースから作成しました。
• すべてのエクスポートを1ページでapi.html
• 言語モデル向けのドキュメントllms.txt · llms-full.txt

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。