Struct SpectrumAnalyzer 

pub struct SpectrumAnalyzer { /* private fields */ }

Register-based spectrum analyzer.

Maps YM2149 channel frequencies to note-aligned spectrum bins, showing the actual notes being played rather than FFT analysis.

Supports up to 4 PSGs (12 channels total) for multi-PSG configurations.

Implementations

impl SpectrumAnalyzer

pub fn new() -> Self

Create a new spectrum analyzer.

pub fn set_psg_count(&mut self, count: usize)

Set the number of active PSGs (1-4).

pub fn psg_count(&self) -> usize

Get the number of active PSGs.

pub fn channel_count(&self) -> usize

Get the number of active channels.

pub fn update(&mut self, channel_states: &ChannelStates)

Update spectrum from YM2149 channel states (single PSG, for backward compatibility).

Call this once per frame. Applies decay to previous values and updates bins based on current frequencies. Updates channels 0-2.

pub fn update_psg(&mut self, psg_index: usize, channel_states: &ChannelStates)

Update spectrum for a specific PSG (0-3).

Call this for each active PSG to update its 3 channels.

pub fn update_multi_psg( &mut self, register_banks: &[[u8; 16]], psg_count: usize, )

Update spectrum from multiple PSG register banks.

Call this once per frame with all PSG register states.

pub fn get_bins(&self) -> &[f32; 32]

Get combined spectrum bins (max across all channels).

pub fn channel_spectrum(&self, channel: usize) -> &[f32; 32]

Get spectrum for a specific channel (0-11 for multi-PSG).

pub fn all_channel_spectrums(&self) -> &[[f32; 32]; 12]

Get all per-channel spectrums (all 12 channels).

pub fn high_freq_ratio(&self, channel: usize) -> f32

Compute high frequency ratio (bins 8-15 vs total).

Useful for badges indicating “bright” or “treble” content.

Trait Implementations

impl Clone for SpectrumAnalyzer

fn clone(&self) -> SpectrumAnalyzer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for SpectrumAnalyzer

fn default() -> Self

Returns the “default value” for a type.