@onjmin/chord-parser
    Preparing search index...

    Interface DetectKeyChangesOptions

    detectKeyChanges のオプション。

    interface DetectKeyChangesOptions {
        flat?: boolean;
        hopSize?: number;
        minSegmentDuration?: number;
        switchMargin?: number;
        windowSize?: number;
    }

    Hierarchy (View Summary)

    Index

    Properties

    flat?: boolean

    主音名をフラット表記にする(既定はシャープ表記)。

    hopSize?: number

    窓をずらす幅(秒、=時間分解能)。未指定なら windowSize / 2。

    minSegmentDuration?: number

    これより短いセグメントは隣接区間へ吸収して除去する(秒、既定 0=無効)。 一瞬だけ別キーと誤判定される「ちらつき」を抑えるのに使う。

    switchMargin?: number

    キーの切り替えに必要な相関スコアの差(ヒステリシス、既定 0.08)。 現在のキーより新候補がこの値を超えて高いときだけ転調と見なす。 近親調(C↔G など)の細かなちらつきを抑え、明確な転調だけを拾う。 0 にすると毎窓で最良キーへ即座に切り替わる。

    windowSize?: number

    キー推定に用いる窓の長さ(秒)。未指定なら曲全体の長さ / 4。 キーの推定には数コード分のまとまった文脈が要るため、窓が小さすぎると 近親調にちらつく。大きすぎると短い転調を見逃す。曲調に応じて調整する。