¶ 📚 KeybordStudio V1 機能リファレンス
KeybordStudio V1 の全機能を、5つのスタジオ別に網羅した完全リファレンスです。
¶ 📋 目次
¶ 🖥️ 共通機能
5つのスタジオすべてで共有される機能です。
¶ ヘッダー
| 項目 | 説明 |
|---|---|
| アプリアイコン | クリックでページをリロード |
| スタジオタブ | Layout / Body / Keycap / PCB / Keymap の切替 |
| 言語切替 | 日本語 (JP) / 英語 (EN) |
| モード切替 (Simple/Advanced) | Keycap / Body で利用可能な詳細モード |
| 検索ボックス | パラメータ名で検索しハイライト |
| ヒント表示 | ツールチップ動画ON/OFF。F1 で Wiki ジャンプ |
| Wiki / GitHub | 公式 Wiki / リポジトリへ遷移 |
| Wiki Capture | キャプチャモードのトグル (オレンジでハイライト) |
¶ 📊 ステータスバー / Stats
| 項目 | 説明 |
|---|---|
| Estimated Weight | 現在のジオメトリの予想重量 |
| Estimated Cost | フィラメント単価設定に基づくコスト |
| Material Preset | PLA / ABS / PETG / TPU / PA-CF などの密度プリセット |
| AMS Slot | 色別の配分割合とスロット番号 |
| Filament TDS | ベンダー別TDSデータシート (引張強度・耐熱性など) |
V1 ではフィラメント TDS データベースがモジュール化されました。
対応ベンダー: BambuLab / Polymaker / eSun / Elegoo / SUNLU / Overture / Generic (合計 92 マテリアル)。
¶ 🗺️ ワークフローガイド
初回起動時、または ? メニュー → ワークフローガイド から開けるオンボーディング画面です。
5ステップ (Layout → Body → Keycap → PCB → Export) を順に案内し、各ステップで 「ここから始める」 ボタンが配置されています。
¶ ⚡ Quick Action Bar
3スタジオ (Layout / Body / Keycap) 共通のクイックアクションバーです。
| ボタン | アクション |
|---|---|
| 保存 | .kbsproj を保存 |
| 読み込み | .kbsproj を開く |
| エクスポート | スタジオ別のエクスポートダイアログ |
| Undo / Redo | スタジオごとに独立した履歴 |
¶ 💾 プロジェクトファイル (.kbsproj)
5スタジオの全状態 (Layout / Body / Keycap / PCB / Keymap / AMS / Gallery / カスタムフォント・SVG) を1ファイルにまとめてバックアップ・共有できるフォーマットです。
| 項目 | 説明 |
|---|---|
| 拡張子 | .kbsproj (内部はJSON) |
| 保存内容 | 全スタジオの state、ギャラリー、AMS、カスタムアセット (任意) |
| 互換性 | 旧形式 (Keycap Generator のプリセット) も自動判別して読み込み |
| プリフライト | 読み込み前に内容のサマリーを表示 |
¶ 📸 Wiki Capture
ヘッダーの「キャプチャ」ボタン (オレンジ) または Ctrl+Shift+S で起動。アプリ内のUI要素を直接スクリーンショットして ZIP でダウンロードできる Wiki 執筆支援機能です。
| 機能 | 説明 |
|---|---|
| キャプチャモード | カーソル下のUI要素をオレンジでハイライト、クリックでキャプチャ |
| ホバーツールチップ | 要素のID / クラス / サイズ / i18nキーを表示 |
| キュー (キャプチャ済み) | サムネイル一覧、削除可 |
| 一括キャプチャ | セクション単位 / ダイアログ単位 / スタジオ単位で連続撮影 |
| ZIP エクスポート | PNG画像 + manifest.md + metadata.json をまとめてダウンロード |
| Markdown コピー |  形式でクリップボードに |
| 自動ファイル名 | {section}_{id-or-i18n}_{lang}_{seq:003}.png |
¶ 🔧 MeshFixLib (非多様体エッジ修復)
KeybordStudio 独自の WASM 修復ライブラリ (v3.2.0) です。エクスポート時に自動で起動し、スライサーがエラーを出すような非多様体エッジを 0 にすることを保証 します。
¶ 多段修復パイプライン
| Pass | 内容 | 用途 |
|---|---|---|
| Pass 1 | 標準プロファイル (頂点マージ / 縮退三角形除去 / 法線整合 / 穴埋め) | 大半のケースをここで解決 |
| Pass 2 | 強化 (NM反復 200回 / EdgeFlip 60回 / 自己交差修復 / assumeClosedSolid) |
軽度の非多様体・自己交差 |
| Pass 3 | ボクセル再構築 (SDF + Marching Cubes / 解像度 256) | 任意の入力に対し2-多様体を保証 |
| Pass 4 | 高解像度ボクセル (解像度 384 / 投影オフ) | 最終手段 |
各 Pass の後で diagnose() を呼び、nonManifold > 0 の場合のみ次の Pass に進みます。
¶ 修復対象
- 重複頂点 / 縮退三角形 / 反対巻き重複面
- 法線方向の不整合
- 非多様体エッジ (>2 三角形が共有するエッジ)
- 非多様体頂点 (扇分離)
- 穴 (イヤークリッピング三角形分割)
- 自己交差 (BVH + 局所リメッシュ)
¶ 修復プロファイル
| プロファイル | 用途 |
|---|---|
| fast | 軽量、クリティカルな修復のみ |
| standard | 既定 |
| detail | 細部保持 (テキスト刻印など細い形状) |
| strong | 形状を多少崩しても確実に閉じる |
| slicer-compat | BambuStudio / OrcaSlicer 向け保守的設定 |
重要: STL / OBJ / 3MF の全エクスポートで MeshFixLib が共通で動作します。配列ビューでも全キーをまとめて修復します。
¶ 🔗 Slicer Bridge
Keycap Slicer Bridge と組み合わせて使うローカルブリッジ機能です。
| 機能 | 説明 |
|---|---|
| フィラメント自動検出 | BambuStudio / OrcaSlicer の現在の設定からフィラメント色・名前を取得 → AMSスロットに反映 |
| 直接送信 | 3MFをスライサーへ直接渡し、自動で開く |
| 24色対応 | 17色目以降は AMS HT スロットに自動振り分け |
| スプリットボタン | エクスポートボタンが緑 (BambuStudio) / ティール (OrcaSlicer) に着色 |
詳細は 関連ツール を参照。
¶ 📐 Layout Studio
2D パラメトリックでスイッチを配置し、ケース外形を編集するスタジオです。
¶ キーパレット
| 項目 | 説明 |
|---|---|
| 1U〜7U | 標準サイズのキーボタン |
| ロータリーエンコーダ | 円形フットプリント |
| スタビライザー | 2U / 6.25U / 7U / Spacebar 用 |
| ネジ穴 | M2 / M3 |
| PCB マウント | 角・センター |
¶ ライン編集ツール
| ツール | キー | 説明 |
|---|---|---|
| 直線 | L |
始点〜終点 |
| 矩形 | R |
角丸対応 |
| 円 | C |
半径指定 |
| 多角形 | P |
N角形 |
| ベジェ曲線 | B |
コントロールポイント編集 |
| フィレット | F |
選択角に半径Rで適用 |
| Gumball | G |
移動・回転・拡大縮小 |
¶ レイヤー
| 操作 | 説明 |
|---|---|
| 追加 | 新規レイヤー |
| ドラッグソート | 順序変更 |
| 可視性 | 👁 でON/OFF |
| ロック | 🔒 で編集禁止 |
| サムネイル | 各レイヤーのプレビュー |
| マージ | 下のレイヤーへ統合 |
¶ KLE インポート
KLE Raw Data を貼り付けると、配列・ラベル・色をそのままインポート。Body Generator が寸法を自動で取り出します。
¶ DXF エクスポート
PCB/プレート CNC 加工用に DXF を出力。Body Generator へ直接渡すこともできます。
¶ 🧱 Body Generator
ケース本体の3D設計スタジオです。Layout の配列が自動で読み込まれます。
¶ レイアウトプリセット
60% / 65% / 75% / TKL / Full / 40% / Alice / Macro / 1800 を内蔵。Layout から自動取り込みも可能。
¶ マウント方式
| 方式 | 特徴 |
|---|---|
| トレイマウント | ボトムケースに直接ネジ留め。シンプル＆コスト最小 |
| ガスケットマウント | プレートをラバーパッドで挟む高級感ある打鍵感 |
| トップマウント | プレートをトップケースにネジ留め |
| サンドイッチマウント | プレートをトップ＆ボトムで挟む |
¶ ケース造形
| 項目 | 説明 |
|---|---|
| ベゼル幅 | 上下左右のベゼル |
| コーナーR | ケース角の丸み |
| 面取り | 上面/底面のチャンファ |
| 壁の厚み | 2.4mm〜の側面厚 |
| プロファイル | High / Low / Custom |
¶ エルゴノミクス
| 項目 | 説明 |
|---|---|
| 傾斜角 | 5°〜10° の前傾 |
| ネガティブティルト | 後傾仕様 |
| コンフォートエッジ | 手首側エッジの面取り |
| 段階式フィート | 折り畳み・複数段階 |
¶ コネクティビティ
USB-C / Mini USB のポート位置・サイズ・マージン、補助コネクタ (Bluetooth on/off スイッチ等) を配置可能。
¶ アドオン
- ロータリーエンコーダ
- OLEDウィンドウ
- 三脚マウント (1/4インチネジ)
- バッテリースペース (BLE 対応)
¶ 刻印
天面・側面・底面それぞれにテキスト / SVG をエンボス・デボスで刻印。フォント選択は Keycap と共通の FontEngine3D を使用。
¶ AMS マルチカラー
| パーツ | 個別色設定 |
|---|---|
| トップ | エクストルーダ#1〜 |
| ボトム | 別色可 |
| プレート | 別色可 |
| ラバーパッド | TPU推奨 |
| フィート | TPU推奨 |
| 刻印 | 別エクストルーダ |
¶ PCB インポート + 衝突チェック (V1 NEW)
KiCad の 3D モデル (.step / .glb) を取り込み、ケースとの干渉を視覚化。干渉領域は赤くハイライトされます。
¶ 断面表示 (V1 NEW)
任意の平面でケースを切断し、内部構造を確認できます。組立ての検証に有効。
¶ 🎹 Keycap Studio
Keycap Generator V68.1 の全機能を継承。詳細は Keycap Generator Wiki と共通ですが、V1 で追加された機能を中心にまとめます。
¶ Simple モード / Advanced モード
| モード | 表示項目 |
|---|---|
| Simple | TEXT / COLOR / PROFILE / SIZE のみ |
| Advanced | 全パラメータ |
¶ 主要パラメータ群
| カテゴリ | 内容 |
|---|---|
| 基本サイズ | 基本ピッチ (19.05mm)、キーサイズ (1U〜10U)、スタビライザー |
| プロファイル | Cherry / OEM / SA / XDA / DSA / Custom |
| 構造 | 角の丸み (Squircle Fillet 0〜7mm)、壁厚、補強リブ、ホーミング突起 |
| 形状 | Rectangle / Rounded / Circle / Polygon / Star / ISO Enter、Taper、Dish (Cylindrical / Spherical / Flat) |
| テクスチャ | Ripple / Wood / Hammered + 画像テクスチャ |
| 変形 | Twist (ねじり)、Tilt (天面傾斜) |
| ステム | Cherry MX / Alps / Kailh Choc / Topre、Box Stem、Lego Stud |
| 公差テスト | ステム太さを 0.01mm 刻みで変えるテストプレート |
¶ 軸タイプ別生成 (V1 強化)
V1 では Cherry MX に加え、Alps / Kailh Choc / Topre 軸の高精度モデルを生成可能です。
¶ ステム強度 FEA (V1 NEW)
ステム部分に対して構造解析 (有限要素ベース) を実行。引張強度・曲げモーメントを AMSの現在のフィラメント に基づいて計算します。
| 入力 | 説明 |
|---|---|
| AMS スロット | 自動的に現在の本体フィラメントを参照 |
| 荷重 | 標準 4kgf (打鍵力)、最大 20kgf |
| 境界条件 | スイッチハウジング側固定 |
| 出力 | 説明 |
|---|---|
| 最大応力 | MPa |
| 安全率 | 引張強度 / 最大応力 |
| 疲労寿命 | サイクル数推定 |
| 判定 | OK / Warning / Critical |
¶ フォントマネージャー
| 項目 | 説明 |
|---|---|
| 対応形式 | .ttf / .otf / .woff / .json |
| 永続化 | IndexedDB |
| 3Dタイルプレビュー | 各フォントをタイル形式で一覧 |
| ターゲット別設定 | メイン文字 / サブ文字 / サイド印字に別フォント |
¶ SVG マネージャー
カスタムSVGを永続化保存し、ストックアイコンライブラリに「カスタム」カテゴリとして自動追加。
¶ スプルキット (Standard / CSK)
| 種類 | 説明 |
|---|---|
| Standard Sprue Kit | 文字リストから自動配置でランナー付きキットを生成 |
| CSK (Custom Sprue Kit) | ギャラリーのキーキャップを自由配置、キーごとにダイス向き設定 |
¶ 配列ビュー (V1 強化)
ON にすると Layout で配置した配列をそのままキーキャップで一括生成。エクスポート時、表示されているすべてのキーキャップが1ファイルに含まれます。
¶ ギャラリー
スナップショット保存 / 復元 / 一括色変更 / 一括エクスポートに対応。
¶ 🔌 PCB Studio
Layout から QMK / ZMK 互換の PCB 設計データを生成します。
| 機能 | 説明 |
|---|---|
| PCB 外形 | スイッチ配置に追従 |
| ダイオードフットプリント | SOD-123 / 1N4148W |
| MCU フットプリント | RP2040-Zero / Pro Micro / Elite-C |
| マトリクス自動配線 | 行/列 自動接続 |
| エクスポート | KiCad プロジェクト / Gerber (実験的) |
注意: PCB Studio は実験的機能です。本格的な設計には KiCad での仕上げを推奨します。
¶ ⌨️ Keymap Studio
QMK / VIA / ZMK 互換のキーマップ編集環境です。
| 機能 | 説明 |
|---|---|
| レイヤー管理 | Default / FN / Macro など複数レイヤー |
| キーピッカー | A〜Z / 数字 / 記号 / 修飾キー / メディア |
| マクロ編集 | 連続入力 / ディレイ |
| エクスポート | QMK keymap.c / VIA JSON / ZMK keymap.dts |
¶ キー設定パターン
| パターン | 説明 |
|---|---|
| Tap | 通常入力 |
| Hold | 長押しで別キー (Layer Tap / Mod Tap) |
| Tap Dance | タップ回数で動作変更 |
| Combo | 複数キーの同時押し |