/usr/include/libinstpatch-1.0/libinstpatch/IpatchUnit.h is in libinstpatch-dev 1.0.0-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 | /*
* libInstPatch
* Copyright (C) 1999-2010 Joshua "Element" Green <jgreen@users.sourceforge.net>
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public License
* as published by the Free Software Foundation; version 2.1
* of the License only.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301, USA or on the web at http://www.gnu.org.
*/
/**
* SECTION: IpatchUnit
* @short_description: Unit conversion system
* @see_also:
* @stability: Stable
*
* System for registering unit types and conversion functions.
*/
#ifndef __IPATCH_UNIT_H__
#define __IPATCH_UNIT_H__
#include <glib.h>
#include <glib-object.h>
typedef struct _IpatchUnitInfo IpatchUnitInfo;
/* structure defining a unit type */
struct _IpatchUnitInfo
{
guint16 id; /* unit type ID */
guint8 digits; /* significant digits to display to user */
guint8 flags; /* IpatchUnitFlags */
GType value_type; /* unit value type */
char *name; /* name identifier (constant) */
char *label; /* unit label (translated) */
char *descr; /* unit description (translated) */
};
typedef enum
{
IPATCH_UNIT_LOGARITHMIC = 1 << 0, /* unit is logarithmic */
IPATCH_UNIT_USER = 1 << 1 /* a user friendly unit type */
} IpatchUnitFlags;
/**
* IpatchValueTransform:
* @src: Source value to transform from
* @dest: Destination value to transform to
*
* Transform from one value to another. The @src and @dest values have
* already been initialized to specific types and the transform function
* should convert/process them as necessary.
*/
typedef void (*IpatchValueTransform)(const GValue *src, GValue *dest);
/* built-in unit types */
typedef enum
{
IPATCH_UNIT_TYPE_NONE = 0, /* a NULL value */
IPATCH_UNIT_TYPE_INT = 1,
IPATCH_UNIT_TYPE_UINT = 2,
IPATCH_UNIT_TYPE_RANGE = 3,
IPATCH_UNIT_TYPE_DECIBELS = 4,
IPATCH_UNIT_TYPE_PERCENT = 5,
IPATCH_UNIT_TYPE_SEMITONES = 6,
IPATCH_UNIT_TYPE_CENTS = 7,
IPATCH_UNIT_TYPE_TIME_CENTS = 8,
IPATCH_UNIT_TYPE_SAMPLE_RATE = 9,
IPATCH_UNIT_TYPE_SAMPLES = 10,
IPATCH_UNIT_TYPE_HERTZ = 11,
IPATCH_UNIT_TYPE_SECONDS = 12,
IPATCH_UNIT_TYPE_MULTIPLIER = 13,
/* 128 - 159 reserved for IpatchUnit_DLS.h */
IPATCH_UNIT_TYPE_DLS_GAIN = 128,
IPATCH_UNIT_TYPE_DLS_ABS_TIME = 129,
IPATCH_UNIT_TYPE_DLS_REL_TIME = 130,
IPATCH_UNIT_TYPE_DLS_ABS_PITCH = 131,
IPATCH_UNIT_TYPE_DLS_REL_PITCH = 132,
IPATCH_UNIT_TYPE_DLS_PERCENT = 133,
/* 160 - 169 reserved for IpatchUnit_SF2.h */
IPATCH_UNIT_TYPE_SF2_ABS_PITCH = 160,
IPATCH_UNIT_TYPE_SF2_OFS_PITCH = 161,
IPATCH_UNIT_TYPE_SF2_ABS_TIME = 162,
IPATCH_UNIT_TYPE_SF2_OFS_TIME = 163,
IPATCH_UNIT_TYPE_CENTIBELS = 164,
IPATCH_UNIT_TYPE_32K_SAMPLES = 165,
IPATCH_UNIT_TYPE_TENTH_PERCENT = 166
} IpatchUnitType;
/* first dynamic unit type ID */
#define IPATCH_UNIT_TYPE_FIRST_DYNAMIC_ID 1024
/*
* Unit class types define domains of conversion, an example is the "user"
* unit class which is used to convert values to units digestable by a human.
* A conversion class is essentially a mapping between unit types, which can
* then be used to lookup conversion functions.
*/
typedef enum
{
IPATCH_UNIT_CLASS_NONE, /* a NULL value */
IPATCH_UNIT_CLASS_USER, /* "user" conversion class (for humans) */
IPATCH_UNIT_CLASS_DLS, /* DLS (native patch type) class */
IPATCH_UNIT_CLASS_COUNT /* NOT A VALID CLASS - count of classes */
} IpatchUnitClassType;
IpatchUnitInfo *ipatch_unit_info_new (void);
void ipatch_unit_info_free (IpatchUnitInfo *info);
guint16 ipatch_unit_register (const IpatchUnitInfo *info);
IpatchUnitInfo *ipatch_unit_lookup (guint16 id);
IpatchUnitInfo *ipatch_unit_lookup_by_name (const char *name);
void ipatch_unit_class_register_map (guint16 class_type, guint16 src_units,
guint16 dest_units);
IpatchUnitInfo *ipatch_unit_class_lookup_map (guint16 class_type,
guint16 src_units);
void ipatch_unit_conversion_register (guint16 src_units, guint16 dest_units,
IpatchValueTransform func);
IpatchValueTransform ipatch_unit_conversion_lookup (guint16 src_units,
guint16 dest_units,
gboolean *set);
gboolean ipatch_unit_convert (guint16 src_units, guint16 dest_units,
const GValue *src_val, GValue *dest_val);
double ipatch_unit_user_class_convert (guint16 src_units,
const GValue *src_val);
#endif
|