FL Studio Dashboard 插件说明

Dashboard：组件 API

此页解说怎样为 Dashboard 自定义和创建新的组件。

基础

Dashboard 组件由初始化文件(*.INI)和图像(支持 *.BMP, *.JPG 和 *.TGA)构成，图像定义组件的外观(皮肤)。 INI 文件位于 Dashboard 的 Artwork 文件夹([FL Studio]/Plugins/Fruity/Generators/Dashboard/Artwork)，或者是这个文件夹的子文件夹。图像可以放置到任何地方，但最好与 INI 文件放在一起，这样可以直接引用图像，无需设置路径。

INI 文件包含以下几部分：

Info(信息) 

Properties(属性) (可选) 

Items(项目) (仅某些类型组件) 

每一部分包含一个或多个属性。一个属性看起来象这样：

propertyName=value (属性名称＝值)

使用很简单，链接图像文件最好用相对路径。链接的文件夹相对于 INI 位置或 Artwork 文件夹：

相对于 Artwork 文件夹：[文件夹]\image.bmp (链接到 Artwork\[文件夹]\image.bmp)。 

相对于 INI 文件： .\文件夹\image.bmp (链接到 Artwork\[INI 文件夹]\image.bmp)。 

INI 文件部分

INI 文件包含以下部分：

[Info] 部分

info 部分包括这些属性：

Name - 控件名称。要确保组件名称的唯一性。这个属性必须有。 

Kind - 组件类型。可能的值是：0 = DigiWheel(数字旋钮)；1 = Slider(滑杆)；2 = Wheel(旋钮)； 3 = Panel(面板)；4 = Switch(开关)；5 = Label(标签)；6 = Image(图像)；7 = Selector(选择器)；8 = Patch selector(音色选择器)；9 = Page selector(页选择器)；这个属性必须有。

Default(默认) - 表示这个类型的控件是默认控件(Default=1)或者不是默认控件(Default=0)。默认控件应用于面板预置中缺少控件的情况下(在此 dashboard 拷贝中没有安装)。例如，一个缺少旋钮的组件将被默认的旋钮组件替换。这个属性为可选。 

Background - 作为控件背景而被引用的图像文件。如果指定了背景，也就决定了控件的宽和高。如果允许用户创建透明的背景，需要指定一个 8-bit .bmp 文件(位图文件)。并不是所有控件支持透明。这个属性为可选。 

Foreground - 作为控件前景而被引用的图像文件。例如，这可以是滑杆上的推子。并不是所有控件用到此值 (例如页选择器)。这个属性为可选。 

[Properties] 部分

这部分是用来定义控件的属性值。全部为可选。你可以在这里设置组件检查器中能看到的全部属性。 

[Items] 部分

这部分只对于选择器和音色选择器有效，用来定义选择器中可能用到的值。值以文本行列表来指定(每一行为一个值)，其结尾用“＝”：

valueName=

对于音色选择器控件，也可以包括与乐器名称相对应的音色库和程序编号：

valueName=Bank MSB, Bank LSB, Program Number

举例：

[items]

100% Left=

50% Left=

Centered=

50% Right=

100% Right=

组件类型