MusicTheory

一个音乐理论库，包含 Swift 枚举中的 Key（调）, Pitch（音高）, Interval（音程）, Scale（音阶）和 Chord（和弦）表示。

• Swift 4.0+
• iOS 8.0+
• macOS 10.9+
• tvOS 9.0+
• watchOS 2.0+

pod 'MusicTheorySwift'

let package = Package(
  name: ...
  dependencies: [
    .package(url: "https://github.com/cemolcay/MusicTheory.git")
  ],
  targets: ...
)

MusicTheory 添加了一系列基本的枚举和结构体，你可以用它们来定义几乎所有与音乐相关的数据。最重要的包括 Pitch（音高）, Key（调）, Scale（音阶）和 Chord（和弦）。

所有数据类型都遵循 Codable, CustomStringConvertable 协议。
Pitch（音高）和 Accident（变音记号）结构体都遵循 RawPresentable 协议，使用 Int 作为原始值，并且遵循 ExpressibleByIntegerLiteral 协议，因此你可以直接使用 Int 来表示它们。

• 所有的调都可以使用 Key 结构体来定义。
• 它包含一个 KeyType，你可以在其中设置基础调，如 C, D, A, G，和一个 Accidental（变音记号），它可以是 .natural（自然）, .flat（降）, sharp（升）或更具体的如 .sharps(amount: 3)（升号，数量：3）。
• 你可以使用 Key（调）和八度音阶来创建 Pitch（音高）。
• 此外，你可以使用 MIDI 音符编号来创建 Pitch（音高）。音高的 rawValue 就是它的 MIDI 音符编号。
• Pitch（音高）, Key（调）, Accidental（变音记号）结构体是可比较的，并且定义了 + 和 - 自定义运算符，以便更容易进行计算。
• 此外，还有其他辅助函数或属性，如音符的频率。
• 你也可以直接使用字符串表示来定义它们。

let dFlat = Key(type: d, accidental: .flat)
let c4 = Pitch(key: Key(type: .c), octave: 4)
let aSharp: Key = "a#" // Key(type: .a, accidental: .sharp)
let gFlat3: Pitch = "gb3" // or "g♭3" or "Gb3" is Pitch(key: (type: .g, accidental: .flat), octave: 3)

• 音程是音高之间的半音数。
• 它们是 IntegerLiteral，你可以在它们之间、音符之间或音符类型之间进行加/减运算。
• 你可以使用它的品质、度数和半音属性来构建自定义音程。
• 你可以从音程构建音阶或和弦。
• 预定义了小、大、完全、增和减音程，最多可达 2 个八度音阶。

• ScaleType 枚举定义了许多现成的音阶。
• 此外，你可以通过 ScaleType.custom(intervals: [Interval], description: String) 创建自定义音阶类型。
• Scale（音阶） 使用音阶类型和根音调来定义音阶。
• 你可以在八度范围内生成音阶的音符。
• 你还可以生成音阶的 HarmonicField（和声场）。
• 和声场是音阶中所有可能的三和弦、七和弦或扩展和弦。

let c = Key(type: .c)
let maj: ScaleType = .major
let cMaj = Scale(type: maj, key: c)

• ChordType（和弦类型） 是一个包含 ChordPart（和弦组成部分） 的结构体，这些是和弦的构建块。
• 你可以使用 ChordType 来定义任何现有的和弦。
• 三度音、五度音、六度音、七度音和扩展音是 ChordType 的组成部分。
• 它们中的每一个也是遵循 ChordPart 协议的结构体。
• Chord（和弦） 使用类型和根音调来定义和弦。
• 你可以在任何八度范围内生成和弦的音符。
• 你可以生成任何和弦的转位。

let m13 = ChordType(
  third: .minor,
  seventh: .dominant,
  extensions: [
    ChordExtensionType(type: .thirteenth)
  ])
let cm13 = Chord(type: m13, key: Key(type: .c))

• 你可以使用 ChordProgression 枚举来生成和弦进行。
• 对于任何音阶，在任何和声场中，对于任何转位。

let progression = ChordProgression.i_ii_vi_iv
let cSharpHarmonicMinorTriadsProgression = progression.chords(
  for: cSharpHarmonicMinor,
  harmonicField: .triad,
  inversion: 0)

• Tempo（速度） 是一个辅助结构体，用于定义音乐应用中的时序。
• TimeSignature（拍号） 是每小节的节拍数和每个节拍的 NoteValue（音符时值）。
• 你可以通过 NoteValue（音符时值） 来计算任何速度下的音符持续时间。
• 音符时值定义了音符在一个节拍中的持续时间。 它可以是全音符、二分音符、四分音符、八分音符、十六分音符或三十二分音符。

• 和声功能是一种实用工具，用于在作曲时查找音阶中相关的音符或和弦。
• 你可以使用它来创建推荐引擎或和弦生成器。

• 你可以立即在 Xcode Playgrounds 中试验该库！
• 克隆项目后，为 Mac 目标构建它。
• 转到项目中的 playground 页面。
• 确保选择了 macOS 平台。
• 并确保在 playground 设置中选择了 "Build Active Scheme" 选项。
• 在 playground 页面中准备了一些配方，您可以立即运行它们。

完整的文档在这里

你可以在 MusicTheoryTests 目标中找到单元测试。
按 ⌘+U 运行测试。

这个库在我的 iOS, macOS, watchOS 和 tvOS 应用中经过了实战测试，快来看看吧！
KeyBud (iOS, watchOS, tvOS, macOS)
FretBud (iOS, watchOS, tvOS)
ChordBud (iOS)
ArpBud (iOS)
ScaleBud (iOS, AUv3, M1)
StepBud (iOS, AUv3, M1)
RhythmBud (iOS, AUv3, M1)
ArpBud 2 (iOS, AUv3, M1)
ChordBud 2 (iOS, AUv3, M1)
LoopBud (iOS, AUv3, M1)
Euclid Goes to Party (iOS, AUv3, M1)
SnakeBud (iOS, AUv3, M1)
MelodyBud (iOS, AUv3, M1)
ScaleBud 2 (iOS, AUv3, M1)
ShiftBud (iOS, AUv3, M1)
PolyBud (iOS, AUv3, M1)
PatternBud (iOS, AUv3, M1)
MIDI Motion (iOS, watchOS)
Textquencer (iOS, AUv3, M1)
In Theory (iOS, AUv3, M1)
BrainBud (iOS, AUv3, M1)
Binarhythmic (iOS, AUv3, M1)
Auto Bass (iOS, AUv3, M1)
BounceBud (iOS, AUv3, M1)
MuseBud (iOS, AUv3, M1)
Auto Fills (iOS, AUv3, M1)
Kebarp (iOS, AUv3, M1)
FuncBud (iOS, AUv3, M1)
Note to Be (iOS, AUv3, M1)
Harmonicc (iOS, AUv3, M1)