curve.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: © 2020, 2023 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#ifndef __AUDIO_CURVE_H__
#define __AUDIO_CURVE_H__
 
#include <stdbool.h>
 
#include "utils/yaml.h"
 
#include <glib/gi18n.h>
 
#define CURVE_OPTIONS_SCHEMA_VERSION 1
 
#define CURVE_SUPERELLIPSE_CURVINESS_BOUND 0.82
#define CURVE_EXPONENT_CURVINESS_BOUND 0.95
#define CURVE_VITAL_CURVINESS_BOUND 1.00
 
typedef enum CurveAlgorithm
{
  CURVE_ALGORITHM_EXPONENT,
 
  CURVE_ALGORITHM_SUPERELLIPSE,
 
  CURVE_ALGORITHM_VITAL,
 
  CURVE_ALGORITHM_PULSE,
 
  CURVE_ALGORITHM_LOGARITHMIC,
 
  NUM_CURVE_ALGORITHMS,
} CurveAlgorithm;
 
static const cyaml_strval_t curve_algorithm_strings[] = {
  {N_ ("Exponent"),      CURVE_ALGORITHM_EXPONENT    },
  { N_ ("Superellipse"), CURVE_ALGORITHM_SUPERELLIPSE},
  { N_ ("Vital"),        CURVE_ALGORITHM_VITAL       },
  { N_ ("Pulse"),        CURVE_ALGORITHM_PULSE       },
  { N_ ("Logarithmic"),  CURVE_ALGORITHM_LOGARITHMIC },
};
 
typedef struct CurveOptions
{
  int schema_version;
 
  CurveAlgorithm algo;
 
  double curviness;
} CurveOptions;
 
static const cyaml_schema_field_t curve_options_fields_schema[] = {
  YAML_FIELD_INT (CurveOptions, schema_version),
  YAML_FIELD_ENUM (CurveOptions, algo, curve_algorithm_strings),
  YAML_FIELD_FLOAT (CurveOptions, curviness),
 
  CYAML_FIELD_END
};
 
static const cyaml_schema_value_t curve_options_schema = {
  CYAML_VALUE_MAPPING (
    CYAML_FLAG_POINTER,
    CurveOptions,
    curve_options_fields_schema),
};
 
typedef struct CurveFadePreset
{
  char *       id;
  char *       label;
  CurveOptions opts;
} CurveFadePreset;
 
NONNULL void
curve_opts_init (CurveOptions * opts);
 
RETURNS_NONNULL
GPtrArray *
curve_get_fade_presets (void);
 
void
curve_algorithm_get_localized_name (CurveAlgorithm algo, char * buf);
 
gboolean
curve_algorithm_get_g_settings_mapping (
  GValue *   value,
  GVariant * variant,
  gpointer   user_data);
 
GVariant *
curve_algorithm_set_g_settings_mapping (
  const GValue *       value,
  const GVariantType * expected_type,
  gpointer             user_data);
 
HOT NONNULL double
curve_get_normalized_y (double x, CurveOptions * opts, int start_higher);
 
PURE bool
curve_options_are_equal (const CurveOptions * a, const CurveOptions * b);
 
#endif