==============================================
 VocalPitchMonitor v1.0.0
 リアルタイム ボーカル 音程モニター
==============================================

高精度リアルタイムピッチ検出。
スクロールグラフ・鍵盤シンセ・5種音名表記で
ボーカル練習を可視化。

公式サイト: https://isgk.net/vocalpitchmonitor/


----------------------------------------------
 インストール
----------------------------------------------

【Windows】
- VocalPitchMonitor_1.0.0_x64-setup.exe (NSIS) 実行
- VocalPitchMonitor_1.0.0_x64_ja-JP.msi (MSI) 実行
- ウィザードに従ってインストール

【ポータブル版】
- VocalPitchMonitor_1.0.0_portable_x64.zip 解凍
- VocalPitchMonitor.exe を任意フォルダに配置
- ダブルクリックで起動 (インストール不要)

※ macOS / Linux / Android / iOS は未対応 (今後対応予定)。


----------------------------------------------
 動作環境
----------------------------------------------

OS         : Windows 10 (1803 以降) / Windows 11 — x64
マイク      : 内蔵マイク or USB マイク
推奨メモリ   : 2 GB 以上


----------------------------------------------
 基本操作
----------------------------------------------

▼ 起動
▶ 開始 ボタン → マイク権限許可 → リアルタイム検出開始

▼ 鍵盤シンセ (左端)
- タップ: 単音再生 + グラフ記録
- 押しっぱなし: サステイン (持続音)
- ドラッグ: スライド演奏 (別の音へ移行)

▼ グラフ操作
- ホイール: 縦軸ズーム (Shift+ホイール: 横軸)
- ドラッグ: 縦パン
- 鍵盤外タップ/ホバー: その位置の音名 + Hz 表示

▼ コントロール
- ⏸ HOLD: 画面凍結
- 🎯 追従: 現在ピッチを画面中央に自動センタリング
- ⏺ REC: 録音
- ▶ 再生: 録音再生 + ピッチ検出グラフ
- ⚙ 設定: 言語/音名/しきい値/履歴秒数/フレームレート


----------------------------------------------
 音名表記 (5種)
----------------------------------------------

英米式  : C  C#  D  D#  E  F  F#  G  G#  A  A#  B
ドイツ式 : C  Cis D  Dis E  F  Fis G  Gis A  B   H
伊太利式 : Do Do# Re Re# Mi Fa Fa# Sol Sol# La La# Si
         (日本語UI: ド ド# レ レ# ミ ファ ファ# ソ ソ# ラ ラ# シ)
日本式  : 一点ハ 嬰ハ 一点ニ … (大字/小字/一点/二点/…)
カラオケ式: lowlowC lowC mid1C mid2C hiC hihiC


----------------------------------------------
 マッチ表示 (3色)
----------------------------------------------

声        : 空色 — リアルタイム検出ピッチ
鍵盤参照   : オレンジ — 鍵盤押下位置
一致      : ライム — ±50cent 一致時、鍵盤線が変色

50cent (半音の半分) 以内で一致判定。
チューナー精度の "in-tune" 基準。


----------------------------------------------
 エクスポート
----------------------------------------------

⚙ 設定 → エクスポートセクション

WAV  : 16-bit PCM mono
MIDI : 音符分割 → MIDI 形式
CSV  : 数値解析用 (時刻・ピッチ・信頼度)


----------------------------------------------
 マイク自己検出抑止 (鍵盤再生時)
----------------------------------------------

ヘッドホン推奨。スピーカー使用時は echo cancellation
で大半の自己検出をキャンセル。


----------------------------------------------
 バージョン履歴
----------------------------------------------

【v1.0.0】2026-05-01
- 初版リリース
- リアルタイムピッチ検出
- スクロールピッチグラフ (1〜30秒可変)
- 5種音名表記 (英米/独/伊/日/カラオケ)
- 鍵盤シンセサイザー (タップ/サステイン/スライド)
- 3色マッチ表示 (声/鍵盤/一致)
- HOLD・追従・録音・再生
- MIDI/CSV/WAV エクスポート
- マイク + システム音声 切替
- 入力レベルメーター + ノイズゲート
- 多言語対応 (日本語 / English)
- Windows NSIS / MSI インストーラ


----------------------------------------------
 ライセンス・連絡先
----------------------------------------------

著作権    : © 2026 isgk.net
配布      : https://isgk.net/vocalpitchmonitor/

不具合報告・機能要望はサイトからどうぞ。

----------------------------------------------
