PitchName.cpp File Reference

Utilities for converting from frequency to pitch and from pitch to absolute (e.g., C4 for middle C) or nominal (A through G#) pitch name. More...

#include "PitchName.h"
#include "Internat.h"
#include <math.h>

Include dependency graph for PitchName.cpp:

Go to the source code of this file.

Functions
double	FreqToMIDInote (const double freq)
double	MIDInoteToFreq (const double dMIDInote)
unsigned int	PitchIndex (const double dMIDInote)
int	PitchOctave (const double dMIDInote)
TranslatableString	PitchName (const double dMIDInote, const PitchNameChoice choice)
TranslatableString	PitchName_Absolute (const double dMIDInote, const PitchNameChoice choice)
double	PitchToMIDInote (const unsigned int nPitchIndex, const int nPitchOctave)
double	PitchToFreq (const unsigned int nPitchIndex, const int nPitchOctave)

Detailed Description

Utilities for converting from frequency to pitch and from pitch to absolute (e.g., C4 for middle C) or nominal (A through G#) pitch name.

Definition in file PitchName.cpp.

Function Documentation

FreqToMIDInote()

double FreqToMIDInote

(

const double

freq

)

Definition at line 23 of file PitchName.cpp.

{
   // Make the calculation relative to A440 (A4), note number 69.
   return (69.0 + (12.0 * (log(freq / 440.0) / log(2.0))));
}

Referenced by FrequencyPlotDialog::PlotPaint().

Here is the caller graph for this function:

MIDInoteToFreq()

double MIDInoteToFreq

(

const double

dMIDInote

)

Definition at line 29 of file PitchName.cpp.

{
   return (440.0 * pow(2.0, (dMIDInote - 69.0) / 12.0));
}

Referenced by PitchToFreq().

Here is the caller graph for this function:

PitchIndex()

unsigned int PitchIndex

(

const double

dMIDInote

)

Definition at line 34 of file PitchName.cpp.

{
   // MIDI numbers can be negative. Round in the right direction.
   double dRound = (dMIDInote < 0.0) ? -0.5 : 0.5;
   int nPitchIndex = ((int)(dMIDInote + dRound) % 12);
 
   // Because of the modulo, we know we're within 12 of positive, if dMIDInote is negative.
   if (nPitchIndex < 0)
      nPitchIndex += 12;
 
   return nPitchIndex;
}

Referenced by PitchName().

Here is the caller graph for this function:

PitchName()

TranslatableString PitchName	(	const double	dMIDInote,
		const PitchNameChoice	choice
	)

Definition at line 54 of file PitchName.cpp.

{
   static const TranslatableString sharpnames[12] = {
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("C"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("C\u266f"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("D"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("D\u266f"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("E"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("F"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("F\u266f"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("G"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("G\u266f"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("A"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("A\u266f"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("B"),
   };
 
   static const TranslatableString flatnames[12] = {
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("C"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("D\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("D"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("E\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("E"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("F"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("G\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("G"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("A\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("A"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("B\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("B"),
   };
 
   static const TranslatableString bothnames[12] = {
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("C"),
     /* i18n-hint: Two, alternate names of a musical note in the 12-tone chromatic scale */
      XO("C\u266f/D\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("D"),
      /* i18n-hint: Two, alternate names of a musical note in the 12-tone chromatic scale */
      XO("D\u266f/E\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("E"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("F"),
      /* i18n-hint: Two, alternate names of a musical note in the 12-tone chromatic scale */
      XO("F\u266f/G\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("G"),
      /* i18n-hint: Two, alternate names of a musical note in the 12-tone chromatic scale */
      XO("G\u266f/A\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("A"),
      /* i18n-hint: Two, alternate names of a musical note in the 12-tone chromatic scale */
      XO("A\u266f/B\u266d"),
      /* i18n-hint: Name of a musical note in the 12-tone chromatic scale */
      XO("B"),
   };
 
   const TranslatableString *table = nullptr;
   switch ( choice ) {
      case PitchNameChoice::Sharps: table = sharpnames; break;
      case PitchNameChoice::Flats: table = flatnames; break;
      case PitchNameChoice::Both: table = bothnames; break;
      default: wxASSERT(false); break;
   }
 
   return table[PitchIndex(dMIDInote)];
}

References Both, Flats, PitchIndex(), Sharps, and XO().

Referenced by PitchName_Absolute().

Here is the call graph for this function:

Here is the caller graph for this function:

PitchName_Absolute()

TranslatableString PitchName_Absolute	(	const double	dMIDInote,
		const PitchNameChoice	choice
	)

Definition at line 148 of file PitchName.cpp.

{
   // The format string is not localized.  Should it be?
   return Verbatim( wxT("%s%d") )
      .Format( PitchName(dMIDInote, choice), PitchOctave(dMIDInote) );
}

References TranslatableString::Format(), PitchName(), PitchOctave(), Verbatim(), and wxT().

Referenced by FrequencyPlotDialog::PlotPaint().

Here is the call graph for this function:

Here is the caller graph for this function:

PitchOctave()

int PitchOctave

(

const double

dMIDInote

)

Definition at line 47 of file PitchName.cpp.

{
   double dRound = (dMIDInote < 0.0) ? -0.5 : 0.5;
   return ((int)((dMIDInote + dRound) / 12.0) - 1);
}

Referenced by PitchName_Absolute().

Here is the caller graph for this function:

PitchToFreq()

double PitchToFreq	(	const unsigned int	nPitchIndex,
		const int	nPitchOctave
	)

Definition at line 160 of file PitchName.cpp.

{
   return MIDInoteToFreq(PitchToMIDInote(nPitchIndex, nPitchOctave));
}

References MIDInoteToFreq(), and PitchToMIDInote().

Here is the call graph for this function:

PitchToMIDInote()

double PitchToMIDInote	(	const unsigned int	nPitchIndex,
		const int	nPitchOctave
	)

Definition at line 155 of file PitchName.cpp.

{
   return ((double)nPitchIndex + (((double)nPitchOctave + 1.0) * 12.0));
}

Referenced by PitchToFreq().

Here is the caller graph for this function: