JoyPro2 Discord GitHub
界面页面

修饰键

显示:

修饰键就是换挡按钮:按住它时,你的其他按钮会做别的事。一个按钮,多种用途。修饰键页面列出你配置文件中的换挡按钮,显示每个按钮用在哪里,并可以新建、重命名和删除它们。你在 绑定页面 上给绑定加上修饰键;导出会把它写入每款支持修饰键的游戏。

修饰键页面:左侧是修饰键库,右侧是选中的修饰键和新建修饰键修饰键页面:左侧是修饰键库,右侧是选中的修饰键和新建修饰键
修饰键页面:左侧是修饰键库,右侧是选中的修饰键和新建修饰键 (图片显示的是英文版应用。)
新手入门

#什么是修饰键

大多数摇杆的按钮比现代飞机的功能少。修饰键能让按钮数量翻倍:选一个按钮作为换挡按钮(通常是小指拨杆),按住它时,其他每个按钮都会获得第二种用途。

  • 不按住换挡按钮:扳机发射机炮。
  • 按住换挡按钮:同一个扳机投放武器。

#页面

  • 左侧:修饰键库。 每个修饰键一张卡片:一个复选框、它的按钮键帽(“BTN 5”)、名称、所属设备以及使用它的关联数量(“3 个绑定”)。
  • 右侧上方:选中的修饰键。 它的键帽、设备以及 使用它的关联:拥有该修饰键的每个关联。
  • 新建修饰键。 输入一个名称(“Pinky”),按 录制修饰键输入,再按下设备上的换挡按钮,然后按 创建修饰键。
  • 底部有 重命名 和 删除勾选的修饰键。

#创建你的第一个修饰键

  1. 输入一个名称,例如 Pinky。
  2. 按 录制修饰键输入,然后按下你想用作换挡按钮的按钮。
  3. 按 创建修饰键。
  4. 前往 绑定 页面,选择一个关联,把修饰键附加到它的绑定上。只有这样,修饰键才会在游戏中起作用。
在游戏中: 按住换挡按钮

下次导出后,这个绑定需要按住换挡按钮才能触发:在 DCS 中,修饰键会显示在该飞机的修饰键列表中,控制单元格中显示为“Pinky + JOY_BTN1”。不支持修饰键的游戏(见各游戏页面)会得到不带修饰键的绑定,检查功能会列出这类绑定。

高级

#详情

  • 临时修饰键。 还没有用在任何绑定上的修饰键无法保存在配置文件本身中(配置文件把修饰键和它们的绑定存在一起)。JoyPro 会把它保存在配置文件的历史记录中(drafts.json),直到你在绑定页面上把它附加到绑定;再次打开配置文件时它会回来。
  • 反转。 勾选后,修饰键在按钮 没有 按住时生效(“松开时的 shift”层)。
  • 同一个按钮用两次 会被拒绝:如果另一个修饰键已经使用了该设备和输入,创建修饰键 会提示(“输入已被修饰键‘Shift’使用。”)。
  • 重命名 会在所有使用该修饰键的绑定中更改它的名称(如果在绑定页面上选中了一个绑定,引擎会从那个关联开始)。游戏在下次导出时才会看到新名称。
  • 删除 会从配置文件的所有绑定上移除勾选的修饰键。绑定保留,只是不再带有该修饰键。JoyPro 会先询问,撤销(Ctrl+Z)可以恢复它们。
  • 如果一个修饰键按钮同时也作为普通按钮绑定,检查 会报告。
  • 多个修饰键可以组合使用(“Shift A + Shift B”);布局页面的绑定模式会在 带修饰键 下列出一个输入的所有组合。

创建修饰键

flowchart TD
  N["新修饰键:<br/>名称 + 录制"] --> C["创建修饰键"]
  C --> A["放在你选中的<br/>绑定上"]
  C -.-> T["临时修饰键:<br/>在绑定页面上附加"]
  T -.-> A
实线:在绑定页面上选中了绑定时。虚线:仅在没有选中绑定时;JoyPro 会保留它,直到你附加它。

导出时

flowchart TD
  P["带有修饰键<br/>'Pinky' 的绑定"] --> E["导出"]
  E --> D["DCS:飞机的<br/>修饰键列表,<br/>'Pinky + JOY_BTN1'"]
  E --> O["其他游戏:它们自己的<br/>组合键格式,或没有"]
每个游戏都以自己的格式获得修饰键。不支持修饰键的游戏得到不带修饰键的绑定。
整个修饰键页面整个修饰键页面
整个修饰键页面
技术细节

#页面的内部原理

视图模型:MainWindowViewModel.cs(RefreshModifiersAsync、CreateModifierOnSelectedBindAsync、RenameModifierAsync、DeleteSelectedModifiersEverywhereAsync、RecordModifierInputAsync),临时修饰键在 pendingModifiersByName 中,由自动保存保留(profile-history)。修饰键以 reformer 字符串(名称、设备、输入、是否反转)的形式写在绑定上。

引擎:engine binds modifier list 填充修饰键库,engine binds modifier add 把修饰键加到关联的绑定上,engine binds modifier rename 和 engine binds modifier remove 修改和删除它;之后页面会重新读取 engine binds list。录制使用与绑定页面相同的捕获服务(DirectInput 和键盘,录制超时和预热来自 设置 > 绑定)。

按游戏:DCS 把修饰键写入 <aircraft>\modifiers.lua 以及每个绑定的 reformers;IL-2 和使用注册表的游戏在有组合键语法时使用它们自己的语法,重新导入时会把名称带回来(导入)。

#参考资料

本页背后的功能文档,由代码仓库生成:

#本页上的每个控件

9 个控件,读取自程序的源代码:9 个已撰写,0 个附有源代码中的信息(工具提示、代码注释、引擎调用),0 个尚待扩充。

#刷新修饰键

按钮已撰写

重新读取配置文件的修饰键,并重建卡片,显示它们的使用次数。

不会更改任何内容。

更多详情(英文)

#返回绑定

按钮已撰写

回到“绑定”页面,你可以在那里给关联的绑定附加和取下修饰键。

#勾选以删除,或在“绑定”页面附加

复选框已撰写

为“删除所选”以及在“绑定”页面上附加而勾选该修饰键。

更多详情(英文)

#反转

复选框已撰写

工具提示 在未按住按钮时生效

新修饰键在它的按钮未被按住时生效。

适合两档开关:一档是普通层,另一档是 Shift 层。

更多详情(英文)

#录制修饰键输入

按钮已撰写

等待下一次按下,并用它填写“设备”和“输入”。

按下它,然后按 Shift 按钮。

更多详情(英文)

#创建修饰键

按钮已撰写

根据名称、设备、输入和“反转”创建修饰键。

如果选择了关联,它会直接放到该绑定上;否则它是一个临时修饰键,保存在配置文件中,直到你附加它。

更多详情(英文)

#重命名

按钮已撰写

在每个使用它的绑定中,把“来自”中的修饰键改名为“改为”中的名称。

在游戏中:下次导出后会显示新名称。

更多详情(英文)

#删除所选(整个配置文件)

按钮已撰写

从配置文件的每个绑定上取下每个勾选的修饰键;绑定保留,只是不再需要 Shift 按钮。

会先询问;Ctrl+Z 可以把它们找回来。

更多详情(英文)