chord_descriptor.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: © 2018-2022 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#ifndef __AUDIO_CHORD_DESCRIPTOR_H__
#define __AUDIO_CHORD_DESCRIPTOR_H__
 
#include <cstdint>
 
#include "dsp/position.h"
#include "utils/yaml.h"
 
#define CHORD_DESCRIPTOR_SCHEMA_VERSION 2
 
#define CHORD_DESCRIPTOR_MAX_NOTES 48
 
enum class MusicalNote
{
  NOTE_C = 0,
  NOTE_CS,
  NOTE_D,
  NOTE_DS,
  NOTE_E,
  NOTE_F,
  NOTE_FS,
  NOTE_G,
  NOTE_GS,
  NOTE_A,
  NOTE_AS,
  NOTE_B
};
 
enum class ChordType
{
  CHORD_TYPE_NONE,
  CHORD_TYPE_MAJ,
  CHORD_TYPE_MIN,
  CHORD_TYPE_DIM,
  CHORD_TYPE_SUS4,
  CHORD_TYPE_SUS2,
  CHORD_TYPE_AUG,
  CHORD_TYPE_CUSTOM,
};
 
enum class ChordAccent
{
  CHORD_ACC_NONE,
  CHORD_ACC_7,
  CHORD_ACC_j7,
  /* NOTE: all accents below assume 7 */
  CHORD_ACC_b9,
  CHORD_ACC_9,
  CHORD_ACC_S9,
  CHORD_ACC_11,
  CHORD_ACC_b5_S11,
  CHORD_ACC_S5_b13,
  CHORD_ACC_6_13,
};
 
typedef struct ChordDescriptor
{
  bool has_bass;
 
  MusicalNote root_note;
 
  MusicalNote bass_note;
 
  ChordType type;
 
  ChordAccent accent;
 
  int notes[CHORD_DESCRIPTOR_MAX_NOTES];
 
  int inversion;
} ChordDescriptor;
 
ChordDescriptor *
chord_descriptor_new (
  MusicalNote root,
  int         has_bass,
  MusicalNote bass,
  ChordType   type,
  ChordAccent accent,
  int         inversion);
 
static inline int
chord_descriptor_get_max_inversion (const ChordDescriptor * const self)
{
  int max_inv = 2;
  switch (self->accent)
    {
    case ChordAccent::CHORD_ACC_NONE:
      break;
    case ChordAccent::CHORD_ACC_7:
    case ChordAccent::CHORD_ACC_j7:
    case ChordAccent::CHORD_ACC_b9:
    case ChordAccent::CHORD_ACC_9:
    case ChordAccent::CHORD_ACC_S9:
    case ChordAccent::CHORD_ACC_11:
      max_inv = 3;
      break;
    case ChordAccent::CHORD_ACC_b5_S11:
    case ChordAccent::CHORD_ACC_S5_b13:
    case ChordAccent::CHORD_ACC_6_13:
      max_inv = 4;
      break;
    default:
      break;
    }
 
  return max_inv;
}
 
static inline int
chord_descriptor_get_min_inversion (const ChordDescriptor * const self)
{
  return -chord_descriptor_get_max_inversion (self);
}
 
static inline int
chord_descriptor_are_notes_equal (int * notes_a, int * notes_b)
{
  /* 36 notes in Chord */
  for (int i = 0; i < 36; i++)
    {
      if (notes_a[i] != notes_b[i])
        return 0;
    }
  return 1;
}
 
static inline int
chord_descriptor_is_equal (ChordDescriptor * a, ChordDescriptor * b)
{
  return a->has_bass == b->has_bass && a->root_note == b->root_note
         && a->bass_note == b->bass_note && a->type == b->type
         && chord_descriptor_are_notes_equal (a->notes, b->notes)
         && a->inversion == b->inversion;
}
 
bool
chord_descriptor_is_key_in_chord (ChordDescriptor * chord, MusicalNote key);
 
bool
chord_descriptor_is_key_bass (ChordDescriptor * chord, MusicalNote key);
 
ChordDescriptor *
chord_descriptor_clone (const ChordDescriptor * src);
 
void
chord_descriptor_copy (ChordDescriptor * dest, const ChordDescriptor * src);
 
const char *
chord_descriptor_chord_type_to_string (ChordType type);
 
const char *
chord_descriptor_chord_accent_to_string (ChordAccent accent);
 
const char *
chord_descriptor_note_to_string (MusicalNote note);
 
char *
chord_descriptor_to_new_string (const ChordDescriptor * chord);
 
NONNULL void
chord_descriptor_to_string (const ChordDescriptor * chord, char * str);
 
NONNULL void
chord_descriptor_update_notes (ChordDescriptor * self);
 
NONNULL void
chord_descriptor_free (ChordDescriptor * self);
 
#endif