流体合成  1.1.11
巨集 | 类型定义 | 枚举 | 职能
设定.h文件参考

合成器设置。 更多...

巨集

#define FLUID_HINT_BOUNDED_BELOW   0x1
 提示FLUID_HINT_BOUNDED_BELOW指示应将FLUID_PortRangeHint的LowerBound字段视为有意义。 更多...
 
#define FLUID_HINT_BOUNDED_ABOVE   0x2
 提示FLUID_HINT_BOUNDED_ABOVE表示应该将FLUID_PortRangeHint的UpperBound字段视为有意义。 更多...
 
#define FLUID_HINT_TOGGLED   0x4
 提示FLUID_HINT_TOGGLED指示应将数据项视为布尔切换。 更多...
 
#define FLUID_HINT_SAMPLE_RATE   0x8
 提示FLUID_HINT_SAMPLE_RATE表示指定的任何界限都应解释为采样率的倍数。 更多...
 
#define FLUID_HINT_LOGARITHMIC   0x10
 提示FLUID_HINT_LOGARITHMIC表示用户可能会发现使用对数刻度查看值更直观。 更多...
 
#define FLUID_HINT_INTEGER   0x20
 提示FLUID_HINT_INTEGER指示用户界面可能希望提供仅采用整数值的步进控件。 更多...
 
#define FLUID_HINT_FILENAME   0x01
 字符串设置是一个文件名。
 
#define FLUID_HINT_OPTIONLIST   0x02
 设置是字符串选项的列表。
 

类型定义

类型def 虚空(* fluid_settings_foreach_option_t)(无效*数据,字符*名称,字符*选项)
 用于的回调函数类型 fluid_settings_foreach_option() 更多...
 
类型def 虚空(* fluid_settings_foreach_t)(void * 数据,char * 名称,int 类型)
 用于的回调函数类型 fluid_settings_foreach() 更多...
 

枚举

枚举 fluid_types_enum {
  FLUID_NO_TYPE = -1, FLUID_NUM_TYPE, FLUID_INT_TYPE, FLUID_STR_TYPE,
  FLUID_SET_TYPE
}
 设置类型。 更多...
 

职能

FLUIDSYNTH_API fluid_settings_tnew_fluid_settings (无效)
 创建一个新的设置对象。 更多...
 
FLUIDSYNTH_API无效 delete_fluid_settings (fluid_settings_t *设置)
 删除提供的设置对象。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_get_type (fluid_settings_t *设置,const 字符*名称)
 获取具有给定名称的设置类型。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_get_hints (fluid_settings_t *设置,const 字符*名称)
 以整数位图的形式获取命名设置的提示。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_is_realtime (fluid_settings_t *设置,const 字符*名称)
 询问设置是否可以实时更改。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_setstr (fluid_settings_t *设置,const 字符*名称,const 字符* 力量)
 为命名设置设置字符串值。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_copystr (fluid_settings_t *设置,const 字符*名称,char * 力量,int 伦)
 复制字符串设置的值。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_dupstr (fluid_settings_t *设置,const 字符*名称,char ** 力量)
 复制字符串设置的值。 更多...
 
FLUIDSYNTH_API FLUID_DEPRECATED 整型 fluid_settings_getstr (fluid_settings_t *设置,const 字符*名称,char ** 力量)
 获取字符串设置的值。 更多...
 
FLUIDSYNTH_API字符* fluid_settings_getstr_default (fluid_settings_t *设置,const 字符*名称)
 获取字符串设置的默认值。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_str_equal (fluid_settings_t *设置,const 字符*名称,const 字符*值)
 测试字符串设置的一些值。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_setnum (fluid_settings_t *设置,const 字符*名称,双值)
 为命名设置设置一个数值。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_getnum (fluid_settings_t *设置,const 字符*名称,双* 值)
 获取命名设置的数值。 更多...
 
FLUIDSYNTH_API翻倍 fluid_settings_getnum_default (fluid_settings_t *设置,const 字符*名称)
 获取命名数字(双精度)设置的默认值。 更多...
 
FLUIDSYNTH_API无效 fluid_settings_getnum_range (fluid_settings_t *设置,const 字符*名称,双* 分,双* 最高)
 获取数字设置的值范围。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_setint (fluid_settings_t *设置,const 字符*名称,int 值)
 为设置设置一个整数值。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_getint (fluid_settings_t *设置,const 字符*名称,int * 值)
 获取整数值设置。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_getint_default (fluid_settings_t *设置,const 字符*名称)
 获取整数设置的默认值。 更多...
 
FLUIDSYNTH_API无效 fluid_settings_getint_range (fluid_settings_t *设置,const 字符*名称,整数* 分,整数* 最高)
 获取整数设置的值范围。 更多...
 
FLUIDSYNTH_API无效 fluid_settings_foreach_option (fluid_settings_t *设置,常量字符*名称,无效*数据, fluid_settings_foreach_option_t 功能)
 迭代命名字符串设置的可用选项,为每个现有选项调用提供的回调函数。 更多...
 
FLUIDSYNTH_API 整型 fluid_settings_option_count (fluid_settings_t *设置,const 字符*名称)
 计算字符串设置的选项字符串值。 更多...
 
FLUIDSYNTH_API字符* fluid_settings_option_concat (fluid_settings_t *设置,const 字符*名称,const 字符*分隔符)
 连接字符串设置的选项以及之间的分隔符。 更多...
 
FLUIDSYNTH_API无效 fluid_settings_foreach (fluid_settings_t *设置,无效*数据, fluid_settings_foreach_t 功能)
 迭代设置对象中定义的现有设置,为每个设置调用提供的回调函数。 更多...
 

详细说明

合成器设置。

宏定义文档

◆ FLUID_HINT_BOUNDED_BELOW

#定义FLUID_HINT_BOUNDED_BELOW   0x1

提示FLUID_HINT_BOUNDED_BELOW指示应将FLUID_PortRangeHint的LowerBound字段视为有意义。

此字段中的值应视为有效范围的(含)下限。如果还指定了FLUID_HINT_SAMPLE_RATE,则LowerBound的值应乘以采样率。

被引用 delete_fluid_settings().

◆ FLUID_HINT_BOUNDED_ABOVE

#定义FLUID_HINT_BOUNDED_ABOVE   0x2

提示FLUID_HINT_BOUNDED_ABOVE表示应该将FLUID_PortRangeHint的UpperBound字段视为有意义。

此字段中的值应被视为有效范围的(包括)上限。如果还指定了FLUID_HINT_SAMPLE_RATE,则应该将UpperBound的值乘以采样率。

被引用 delete_fluid_settings().

◆ FLUID_HINT_TOGGLED

#定义FLUID_HINT_TOGGLED   0x4

提示FLUID_HINT_TOGGLED指示应将数据项视为布尔切换。

小于或等于零的数据应被视为“关闭”或“假”,而大于零的数据应被视为“开启”或“真”。 FLUID_HINT_TOGGLED不得与任何其他提示一起使用。

被引用 delete_fluid_player(), fluid_settings_copystr(), fluid_settings_dupstr(), fluid_settings_getstr(), fluid_settings_getstr_default(), fluid_settings_setstr()fluid_settings_str_equal().

◆ FLUID_HINT_SAMPLE_RATE

#定义FLUID_HINT_SAMPLE_RATE   0x8

提示FLUID_HINT_SAMPLE_RATE表示指定的任何界限都应解释为采样率的倍数。

例如,此提示可以结合使用LowerBound = 0和UpperBound = 0.5来请求从0Hz到Nyquist频率(一半采样率)的频率范围。完全支持范围的主机必须支持此提示才能保留含义。

◆ FLUID_HINT_LOGARITHMIC

#定义FLUID_HINT_LOGARITHMIC   0x10

提示FLUID_HINT_LOGARITHMIC表示用户可能会发现使用对数刻度查看值更直观。

这对于频率和增益特别有用。

◆ FLUID_HINT_INTEGER

#定义FLUID_HINT_INTEGER   0x20

提示FLUID_HINT_INTEGER指示用户界面可能希望提供仅采用整数值的步进控件。

不推荐使用:

由于存在整数设置类型,因此不使用此提示。

Typedef文档

◆ fluid_settings_foreach_option_t

类型def 虚空(* fluid_settings_foreach_option_t)(无效*数据,字符*名称,字符*选项)

用于的回调函数类型 fluid_settings_foreach_option()

参量
数据用户定义的数据指针
名称设定名称
选项此设置的字符串选项(遍历列表)

◆ fluid_settings_foreach_t

类型def 虚空(* fluid_settings_foreach_t)(void * 数据,char * 名称,int 类型)

用于的回调函数类型 fluid_settings_foreach()

参量
数据用户定义的数据指针
名称设定名称
类型设定类型(fluid_types_enum)

枚举类型文档

◆ fluid_types_enum

设置类型。

每个设置都有定义的类型:数字(双精度),整数,字符串或一组值。可以使用以下功能检索每个设置的类型 fluid_settings_get_type()

枚举器
FLUID_NO_TYPE 

未定义的类型。

FLUID_NUM_TYPE 

数字(双精度)

FLUID_INT_TYPE 

整数。

FLUID_STR_TYPE 

串。

FLUID_SET_TYPE 

一组值。

功能文件

◆ new_fluid_settings()

FLUIDSYNTH_API fluid_settings_t* new_fluid_settings ( 虚空  )

创建一个新的设置对象。

退货
指向设置对象的指针
例子:
example.c, 流体合成_arpeggio.c, 流体合成_fx.c, 流体合成_metronome.c, 流体合成_register_adriver.c流体合成_simple.c.

◆ delete_fluid_settings()

FLUIDSYNTH_API无效delete_fluid_settings ( fluid_settings_t 设定)

◆ fluid_settings_get_type()

FLUIDSYNTH_API 整型 fluid_settings_get_type ( fluid_settings_t 设定,
const 字符*  名称 
)

获取具有给定名称的设置类型。

参量
设定设置对象
名称设置名称
退货
命名设置的类型,或者 FLUID_NO_TYPE 当它不存在时

参考文献 FLUID_NO_TYPE.

◆ fluid_settings_get_hints()

FLUIDSYNTH_API 整型 fluid_settings_get_hints ( fluid_settings_t 设定,
const 字符*  名称 
)

以整数位图的形式获取命名设置的提示。

参量
设定设置对象
名称设置名称
退货
与命名设置关联的提示(如果存在),否则为零

参考文献 FLUID_INT_TYPE, FLUID_NUM_TYPEFLUID_STR_TYPE.

◆ fluid_settings_is_realtime()

FLUIDSYNTH_API 整型 fluid_settings_is_realtime ( fluid_settings_t 设定,
const 字符*  名称 
)

询问设置是否可以实时更改。

参量
设定设置对象
名称设置名称
退货
非零(如果设置可以实时更改)

参考文献 FLUID_INT_TYPE, FLUID_NUM_TYPEFLUID_STR_TYPE.

◆ fluid_settings_setstr()

FLUIDSYNTH_API 整型 fluid_settings_setstr ( fluid_settings_t 设定,
const 字符*  名称,
const 字符*  力量 
)

为命名设置设置字符串值。

参量
设定设置对象
名称设置名称
力量新的字符串值
退货
如果设置了值,则为1,否则为0
例子:
流体合成_register_adriver.c.

参考文献 FLUID_HINT_TOGGLED, FLUID_INT_TYPEFLUID_STR_TYPE.

被引用 fluid_synth_get_settings().

◆ fluid_settings_copystr()

FLUIDSYNTH_API 整型 fluid_settings_copystr ( fluid_settings_t 设定,
const 字符*  名称,
字符*  力量,
整型   
)

复制字符串设置的值。

参量
设定设置对象
名称设置名称
力量调用者提供的缓冲区将字符串值复制到
'str'缓冲区的大小(最多写入len个字节,该字节始终包含零终止符)
退货
如果值存在则为1,否则为0
以来
1.1.0

喜欢 fluid_settings_getstr() 但是是线程安全的。 256的大小应足以容纳字符串缓冲区。

参考文献 FLUID_HINT_TOGGLED, FLUID_INT_TYPEFLUID_STR_TYPE.

◆ fluid_settings_dupstr()

FLUIDSYNTH_API 整型 fluid_settings_dupstr ( fluid_settings_t 设定,
const 字符*  名称,
字符**  力量 
)

复制字符串设置的值。

参量
设定设置对象
名称设置名称
力量存储指向分配的重复字符串的指针的位置
退货
如果该值存在且已成功复制,则为1,否则为0
以来
1.1.0

喜欢 fluid_settings_copystr() 但分配一个新的字符串副本。调用者拥有该字符串,使用完该字符串后应使用free()将其释放。

参考文献 FLUID_ERR, FLUID_HINT_TOGGLED, FLUID_INT_TYPEFLUID_STR_TYPE.

被引用 delete_fluid_shell(), fluid_synth_get_settings()new_fluid_file_renderer().

◆ fluid_settings_getstr()

FLUIDSYNTH_API FLUID_DEPRECATED 整型 fluid_settings_getstr ( fluid_settings_t 设定,
const 字符*  名称,
字符**  力量 
)

获取字符串设置的值。

参量
设定设置对象
名称设置名称
力量存储指向设置字符串值的指针的位置
退货
如果值存在则为1,否则为0
不推荐使用:

如果该值不存在,则将'str'设置为NULL。否则,“ 力量”将指向该值。该应用程序不拥有返回的值,并且仅在将新值分配给给定名称的设置之前有效。

注意:在多线程环境中,调用者必须确保设置被读取。 fluid_settings_getstr() 在呼叫者使用设置值期间未分配。采用 fluid_settings_copystr() 要么 fluid_settings_dupstr() 没有这个限制。

参考文献 FLUID_HINT_TOGGLED, FLUID_INT_TYPEFLUID_STR_TYPE.

◆ fluid_settings_getstr_default()

FLUIDSYNTH_API字符* fluid_settings_getstr_default ( fluid_settings_t 设定,
const 字符*  名称 
)

获取字符串设置的默认值。

请注意,返回的字符串不属于调用方,因此不应对其进行修改或释放。

参量
设定设置对象
名称设置名称
退货
设置的默认字符串值(如果存在),否则为NULL

参考文献 FLUID_HINT_OPTIONLIST, FLUID_HINT_TOGGLED, FLUID_INT_TYPEFLUID_STR_TYPE.

◆ fluid_settings_str_equal()

FLUIDSYNTH_API 整型 fluid_settings_str_equal ( fluid_settings_t 设定,
const 字符*  名称,
const 字符*  s 
)

测试字符串设置的一些值。

参量
设定设置对象
名称设置名称
s要测试的字符串
退货
如果值存在且等于“ s”,则为1,否则为0

参考文献 FLUID_HINT_TOGGLED, FLUID_INT_TYPEFLUID_STR_TYPE.

被引用 new_fluid_midi_driver(), new_fluid_player()new_fluid_synth().

◆ fluid_settings_setnum()

FLUIDSYNTH_API 整型 fluid_settings_setnum ( fluid_settings_t 设定,
const 字符*  名称,
双   
)

为命名设置设置一个数值。

参量
设定设置对象
名称设置名称
新设置的值
退货
如果设置了值,则为1,否则为0

参考文献 FLUID_NUM_TYPE.

被引用 fluid_synth_get_settings().

◆ fluid_settings_getnum()

FLUIDSYNTH_API 整型 fluid_settings_getnum ( fluid_settings_t 设定,
const 字符*  名称,
双*   
)

获取命名设置的数值。

参量
设定设置对象
名称设置名称
变量指针,用于接收设置的数值
退货
如果值存在则为1,否则为0

参考文献 FLUID_NUM_TYPE.

被引用 fluid_synth_get_settings(), fluid_synth_write_s16(), new_fluid_file_renderer()new_fluid_synth().

◆ fluid_settings_getnum_default()

FLUIDSYNTH_API翻倍 fluid_settings_getnum_default ( fluid_settings_t 设定,
const 字符*  名称 
)

获取命名数字(双精度)设置的默认值。

参量
设定设置对象
名称设置名称
退货
如果命名设置存在,则为默认值,否则为0.0f

参考文献 FLUID_NUM_TYPE.

◆ fluid_settings_getnum_range()

FLUIDSYNTH_API无效fluid_settings_getnum_range ( fluid_settings_t 设定,
const 字符*  名称,
双*  ,
双*  最高 
)

获取数字设置的值范围。

参量
设定设置对象
名称设置名称
设定范围下限
最高设定范围上限

参考文献 FLUID_NUM_TYPE.

◆ fluid_settings_setint()

FLUIDSYNTH_API 整型 fluid_settings_setint ( fluid_settings_t 设定,
const 字符*  名称,
整型   
)

为设置设置一个整数值。

参量
设定设置对象
名称设置名称
新设置的整数值
退货
如果设置了值,则为1,否则为0

参考文献 FLUID_INT_TYPE.

被引用 fluid_synth_get_settings()new_fluid_synth().

◆ fluid_settings_getint()

FLUIDSYNTH_API 整型 fluid_settings_getint ( fluid_settings_t 设定,
const 字符*  名称,
整数*   
)

获取整数值设置。

参量
设定设置对象
名称设置名称
指向变量的指针,以接收设置的整数值
退货
如果值存在则为1,否则为0

参考文献 FLUID_INT_TYPE.

被引用 fluid_synth_get_settings(), fluid_synth_set_sample_rate(), new_fluid_file_renderer(), new_fluid_midi_router(), new_fluid_player(), new_fluid_server()new_fluid_synth().

◆ fluid_settings_getint_default()

FLUIDSYNTH_API 整型 fluid_settings_getint_default ( fluid_settings_t 设定,
const 字符*  名称 
)

获取整数设置的默认值。

参量
设定设置对象
名称设置名称
退货
设置的默认整数值,它存在,否则为零

参考文献 FLUID_INT_TYPE.

◆ fluid_settings_getint_range()

FLUIDSYNTH_API无效fluid_settings_getint_range ( fluid_settings_t 设定,
const 字符*  名称,
整数*  ,
整数*  最高 
)

获取整数设置的值范围。

参量
设定设置对象
名称设置名称
设定范围下限
最高设定范围上限

参考文献 FLUID_INT_TYPE.

◆ fluid_settings_foreach_option()

FLUIDSYNTH_API无效fluid_settings_foreach_option ( fluid_settings_t 设定,
const 字符*  名称,
无效*  数据,
fluid_settings_foreach_option_t  功能 
)

迭代命名字符串设置的可用选项,为每个现有选项调用提供的回调函数。

参量
设定设置对象
名称设置名称
数据任何用户提供的指针
功能每次迭代都要调用的回调函数

注意:从FluidSynth 1.1.0开始, 功能 每个选项均按字母顺序调用回调。以前的版本中未定义排序顺序。

参考文献 FLUID_STR_TYPE.

◆ fluid_settings_option_count()

FLUIDSYNTH_API 整型 fluid_settings_option_count ( fluid_settings_t 设定,
const 字符*  名称 
)

计算字符串设置的选项字符串值。

参量
设定设置对象
名称设定名称
退货
此字符串设置的选项计数(如果没有则为0,如果没有找到则为-1)
以来
1.1.0

参考文献 FLUID_STR_TYPE.

◆ fluid_settings_option_concat()

FLUIDSYNTH_API字符** fluid_settings_option_concat ( fluid_settings_t 设定,
const 字符*  名称,
const 字符*  分隔器 
)

连接字符串设置的选项以及之间的分隔符。

参量
设定设置对象
名称设定名称
分隔器选项之间使用的字符串(使用“,”时为NULL)
退货
错误时新分配的字符串或NULL(内存不足,无效设置) 名称 或不是字符串设置)。完成后释放字符串。
以来
1.1.0

参考文献 FLUID_ERR, FLUID_INT_TYPE, FLUID_NUM_TYPE, FLUID_SET_TYPEFLUID_STR_TYPE.

被引用 new_fluid_midi_driver().

◆ fluid_settings_foreach()

FLUIDSYNTH_API无效fluid_settings_foreach ( fluid_settings_t 设定,
无效*  数据,
fluid_settings_foreach_t  功能 
)

迭代设置对象中定义的现有设置,为每个设置调用提供的回调函数。

参量
设定设置对象
数据任何用户提供的指针
功能每次迭代都要调用的回调函数

注意:从FluidSynth 1.1.0开始, 功能 对于每个设置,都按字母顺序调用回调。以前的版本中未定义排序顺序。