◼ COMMAND REFERENCE — v1.2

背景 #FAFAF8 / インク #0c0c0c。標準テーマ。

別名: light mode

背景 #000000 / インク #F0EDE6。ダークモード。

別名: dark mode

注: オブジェクトのfillは元のlight-modeの色を保持しており、描画時に resolveFill() で反転される（破壊的変更なし）。

背景 #DCDBD5（暖かい石色）/ アクセント #1600A2（エレクトリックコバルト）。

別名: grey, gray mode, grey mode

ターミナルの出力ログをクリア。キャンバスは無変更。

clear と同じ。

getUserMedia を呼び、右上にPIP (220×165 / モバイル 128×170) を配置。赤い REC ドットが点滅、◼ BLACK MIRROR ラベルは mix-blend-mode: difference。

フレームを掴むとドラッグで移動可能。ホバーで × クローズが表示。

別名: Black Mirror on

トラックを全解放してPIPを閉じる。タブを閉じなくてもカメラのインジケーターはすぐに消える。

別名: Black Mirror-off

キャンバス全体とビュー (scale / tx / ty) を <name> で保存。

名前ルール: [a-zA-Z0-9][a-zA-Z0-9_\-. ]{0,40}

> save biwako-study
→ serializing...
→ 23 object(s)
[SUCCESS] Snapshot 'biwako-study' committed.

保存済みのスナップショット一覧。新しい順。

指定のスナップショットに戻す。選択状態はリセットされ、ビューも復元される。

選択オブジェクト（無ければ全体）をネイティブSVGに書き出し。すべてのプリミティブが対応:

• circle → <ellipse>
• square → <rect>
• triangle → <polygon>
• arrow → <line> + <polygon> 頭
• text → <text dominant-baseline="hanging">
• stroke → <path M…Q…>
• image → <image>
• 回転は <g transform="rotate(θ cx cy)"> でラップ

現在のプロジェクトを .json で書き出し。ヘッダの SAVE ボタンと同等。

プロジェクト + 登録済みスペル全部を1つの .json に。自分のBMセットアップの完全バックアップ。

別名: exportall

スペルだけ。名前を空白区切りで指定すると、それだけを含む。無指定なら全ユーザースペル。

別名: exportspells

選択オブジェクト（無ければ全体）をbbox切り抜きの透過PNGで書き出し。3× DPR上限でメモリスパイク抑止。

登録済みコマンド全部を [preset] または [ user ] タグ付きで列挙。

新しいスペルを登録。名前の制約: [a-z0-9][a-z0-9_-]{0,30}。

> register hi BM.log('hello, spellbook!')
→ compiling...
→ persisting...
[OK] $hi — try it now.

既存スペルに別名を付ける。短縮名を作りたい時に。

ユーザースペルを削除。プリセットは削除できない。

別名: unregister

JSONペイロードをターミナルに貼るだけでスペル登録。形式:

{
  "command": "my-spell",
  "action": "BM.log('hello from JSON')"
}

スキーマチェックが通ると IndexedDB にバインドされ、以後 $my-spell で呼べる。

選択オブジェクトを ±400px (x) / ±300px (y) の範囲でランダムに移動。

ビューの中心に 80×80 の四角を 3×3 で配置。ワイヤーフレームの下敷きに。

全オブジェクトのストローク（と存在すればfill）を #0044CC に。"Biwako Silence" パレット。

Export セクション参照。

選択画像をグレースケール化（grayscale(100%) contrast(110%) brightness(95%)）。オフスクリーンcanvasでdataURLを書き換え、元画像はそのまま残さない（上書き）。

使い方

• $fetch-img — 1枚 (biwako)
• $fetch-img ocean — 1枚 (キーワード ocean)
• $fetch-img ocean 9 — 9枚（上限 25）

公開画像フィードから取得、ランダム回転と余白でキャンバスに散布。CORS安全な画像は永続化可能、ブロックされた画像はプレースホルダで代替。

シェアモーダルを開く。

• Copy URL — CompressionStream でgzip → base64url → コピー。開いた側でそのまま復元。
• Open in New Tab — 同じURLを新規タブでプレビュー。
• Download .json — ファイル配布。

指定スペルのJSONをクリップボードへ。Slack / X / gist / 友人のDM に貼り、彼らがペーストすれば自動登録。

ターミナル内でクイックリファレンスを表示。登録済みスペル数と主要コマンドをまとめて確認できる。

別名: ?

詳細なマニュアルパネルを開く。Escで閉じる。

別名: man, docs

YouTube イースターエッグのアニメーションを発火。別名 yt, youtube.com。

内部の S.objects 配列をダンプ。スペル作成時のデバッグに。

入力のパース結果を返す。スペル作成時の引数挙動確認に。

選択オブジェクトを共通の辺に揃える: left / right / top / bottom / center-x / center-y。

3つ以上の選択オブジェクト間のギャップを均等化。水平 / 垂直を別コマンドに。

選択オブジェクトを仮想グループ化。S に groups マップを追加し、ヒットテストがグループを優先する。

描画順を直接操作。raise / lower で1段ずつ、bring-front / send-back で両端に。

選択オブジェクトを水平/垂直反転。

名前付きパレットを一括適用（biwako / ink-brush / crt / ...）。$biwako-blue をベースに多色化。

$monoclo の兄弟コマンド。duotone <hex1> <hex2> で2色マッピング。

選択画像にピクセルグレインを散らす。amount で強度調整。

黄色い付箋風テキストオブジェクト。リサイズ可・回転可。ブレスト専用。

クリックで✓が入る小さなトグル付きテキスト。TODO用。

矢印+ラベルをまとめた一発作成。画面キャプチャに注釈をつけるワークフロー向け。

PIPスロットでカウントダウン。0で通知。集中作業支援。

キャンバス上のオブジェクトをtype別に集計。

テキストオブジェクトの本文・タグから検索し、マッチしたものを点滅ハイライト。

Web Speech API でテキストを読み上げる。配信やプレゼンテーションに。

Web Speech Recognition で音声入力。認識結果をテキストオブジェクトとして配置。

プロンプトをAIに渡し、返ってきたJSONをそのまま登録。fetch で OpenAI / Anthropic / Gemini 互換APIを叩く設計に。

ストローク生成順を記録しておき、アニメーションで再生。制作プロセスの記録に。

オブジェクトに layer タグを付与し、表示/非表示を切替。最小限の階層化。

BM.all()                 // array of every object on the canvas
BM.getSelected()         // array of currently-selected objects
BM.redraw()              // mark dirty, re-render
BM.save()                // commit to IndexedDB
BM.log(msg, cls?)        // print to the terminal
                         //   cls: 't-ok' | 't-err' | 't-dim'
BM.create(type, data)    // new object; type =
                         //   'circle' | 'square' | 'triangle'
                         //   | 'arrow' | 'text' | 'image' | 'stroke'
BM.translate(obj, dx, dy)
BM.viewCenter()          // { x, y } in world coords
BM.rand(a, b)            // random float in [a, b)
BM.exportSvg(targets?)   // same as $svg (default: selection or all)

最小のスペル例:

{
  "command": "spread",
  "action": "const sel = BM.getSelected(); if (!sel.length) { BM.log('select first.', 't-err'); return; } for (const o of sel) BM.translate(o, BM.rand(-600, 600), 0); BM.log('spread ' + sel.length + ' object(s) horizontally.');"
}

ターミナルに貼るだけで $spread が恒久登録される。