Quick NPanel [Blender addon]

cvELD Quick N-Panel

[English README](README_EN.md)

Blenderのサイドバー（Nパネル）カテゴリを一覧表示し、目的のパネルへすばやく切り替えるためのアドオンです。

3D View、Node Editor、Image Editorのヘッダーまたはショートカットからカテゴリ一覧を開き、選択したカテゴリを一時的な `Focused` タブにまとめて表示できます。

## 動作環境

- Blender 4.5 LTS以降

- ライセンス: GPL-3.0-or-later

## 主な機能

- Nパネルカテゴリをポップアップで一覧表示

- 選択したカテゴリを一時的な `Focused` タブへ集約

- 3D View、Node Editor、Image Editorに対応

- ヘッダーアイコンの表示位置を選択可能

- カテゴリの並び順、表示名、アイコンをカスタマイズ

- 不要なカテゴリを一覧から除外

- 選択中のカテゴリを管理リストから削除し、非表示状態を保存

- アドオン追加・削除後のカテゴリ差分を整合

- カテゴリごとのショートカットを登録

- カテゴリ名による検索

- 設定をJSONファイルへ保存・読み込み

- 設定変更の自動保存

- 7言語のUI表示

## 対応言語

- English (`en_US`、ソース言語・フォールバック)

- 日本語 (`ja_JP`)

- 简体中文 (`zh_HANS`)

- Español (`es`)

- 한국어 (`ko_KR`)

- Français (`fr_FR`)

- Italiano (`it_IT`)

表示言語はBlenderの **Edit > Preferences > Interface > Translation > Language** に従います。未翻訳または利用できないロケールでは英語が表示されます。

## インストール

1. 配布されたZIPファイルは展開せず、そのまま使用します。

2. Blenderで **Edit > Preferences > Add-ons** を開きます。

3. メニューから **Install from Disk** を選び、配布ZIPを指定します。

4. `cvELD Quick N-Panel` を有効にします。

## 基本的な使い方

1. 3D View、Node Editor、またはImage Editorを開きます。

2. ヘッダーのNパネルリストアイコンをクリックするか、設定したショートカットを押します。

3. 一覧から表示したいカテゴリを選択します。

4. 選択したカテゴリのパネルが一時的な `Focused` タブへ移動し、すぐに参照できる状態になります。

同じカテゴリをもう一度選択するとサイドバーを閉じられます。`Focused` タブを閉じるか別のカテゴリを選択すると、移動したパネルは元のカテゴリへ戻ります。

## 設定

Blenderのアドオン設定から、次の項目を変更できます。

### ヘッダーメニュー

- Nパネルリストアイコンの表示・非表示

- メインヘッダー左端、ツール設定ヘッダー、メインヘッダー右端から表示位置を選択

### カテゴリ

- 優先順位の変更

- 表示名の変更

- アイコンの変更

- 目のボタンによる一時的な一覧からの除外

- マイナスボタンによる選択カテゴリの削除

- カテゴリ一覧の再取得と差分整合

薄く表示されるカテゴリは、現在のエディターやモードでは利用できません。

マイナスボタンで削除したカテゴリは、プリファレンスとNパネルウィンドウの両方から非表示になり、その状態がJSONへ保存されます。**Nパネルカテゴリの差分を整合**を実行すると、意図的に削除したカテゴリを復活させるか確認ダイアログが表示されます。復活をオフにすれば、削除状態を維持したまま新規・消失カテゴリだけを整合できます。

### ショートカット

カテゴリの右クリックメニューから、カテゴリを直接開くショートカットを登録できます。ショートカットが失われた場合は、アドオン設定の復元機能を使用してください。

### 設定ファイル

カテゴリのカスタマイズ、意図的に削除したカテゴリ、ショートカット設定はJSON形式で保存できます。自動保存を有効にすると、変更時に設定ファイルが更新されます。

**設定をリセット**は現在のUI設定だけを初期状態へ戻し、保存済みJSONを上書きしません。その直後に **設定をロード**すると、リセット前に保存されていた状態へ戻せます。リセット後に別の設定を変更した場合は、自動保存によってJSONが更新されることがあります。

## 翻訳ファイル

UI翻訳は `translation/translation.csv` で管理されています。`en_US` 列がBlenderへ渡す英語のソース文字列で、その他の列が各ロケールの翻訳です。

翻訳を追加・編集するときは、CSVをUTF-8で保存し、英語ソースと各言語の対応関係を維持してください。セルが空の場合、その項目は英語へフォールバックします。

## クレジット

このアドオンはCleanPanelsのアイデアと一部の実装を基に再構成されています。

## ライセンス

GPL-3.0-or-later。詳細は [LICENSE](LICENSE) を参照してください。

公式サイト

https://example.com/

詳細

機能の説明、使い方など…

動作環境

Blender4.5以上

アップデート履歴

[2019-01-01: v0.1b] xxxxxxx

[2019-02-01: v1.0] xxxxxxx

...