NohBoard 键盘可视化工具安装与配置指南

1. 项目基础介绍和主要编程语言

项目基础介绍

NohBoard 是一个免费且易于使用的键盘可视化工具，专门设计用于在屏幕上实时显示用户的键盘操作。该项目起源于对图形化界面的需求，特别适用于游戏直播、教学演示和内容创作等场景。NohBoard 提供了高度自定义的功能，用户可以根据个人喜好调整键盘布局、按键样式、颜色方案等，使其能够完美融入各种应用场景。

主要编程语言

NohBoard 主要使用 C# 编程语言进行开发。C# 是一种面向对象的现代化编程语言，基于 .NET Framework 平台，特别适合 Windows 应用程序的开发。选择 C# 是因为开发团队在过去十年中主要使用该语言，能够更高效地实现复杂功能并提供更好的用户体验。

2. 项目使用的关键技术和框架

关键技术

• GDI+ 图形渲染: NohBoard 使用 Windows 的图形设备接口 GDI+ 进行图形绘制和渲染，这比最初使用的 DirectX 方案更加简单高效，同时保证了良好的兼容性。
• 键盘钩子技术: 通过底层键盘钩子技术实时捕获键盘输入事件，确保按键操作的准确显示。
• JSON 配置文件: 使用 JSON 格式存储键盘布局和样式配置，便于用户自定义和分享。

框架

• .NET Framework 4.5+: 项目基于 .NET Framework 开发，这是一个成熟的 Windows 应用程序开发框架，提供了丰富的类库和运行时环境。
• Windows Forms: 使用 Windows Forms 构建用户界面，提供了直观的配置界面和实时显示窗口。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装 NohBoard 之前，请确保您的系统满足以下要求：

系统要求:

• 操作系统: Windows 7 或更高版本
• .NET Framework: 4.5 或更高版本
• 内存: 至少 2GB RAM
• 磁盘空间: 50MB 可用空间

必要软件:

• Git (用于克隆项目代码)
• Visual Studio 2019 或更高版本 (可选，用于代码编译)

详细安装步骤

步骤 1: 克隆项目代码

打开命令提示符或 PowerShell，导航到您希望存放项目的目录，然后运行以下命令：

git clone https://gitcode.com/gh_mirrors/no/NohBoard.git

步骤 2: 导航到项目目录

cd NohBoard

步骤 3: 打开解决方案文件

使用 Visual Studio 打开项目目录中的 NohBoard/NohBoard.sln 解决方案文件。

步骤 4: 构建项目

在 Visual Studio 中，选择"生成"菜单，然后选择"生成解决方案"。这将编译整个项目并生成可执行文件。

步骤 5: 运行应用程序

构建成功后，您可以在 NohBoard/NohBoard/bin/Debug 或 NohBoard/NohBoard/bin/Release 目录中找到 NohBoard.exe 可执行文件。双击运行即可启动应用程序。

步骤 6: 配置键盘布局

NohBoard 提供了丰富的预设键盘布局，位于 keyboards/ 目录下。您可以选择适合的布局或创建自定义布局：

• 标准布局: keyboards/Normal/ 包含各种标准键盘布局
• 游戏布局: keyboards/GamesLegacy/ 提供游戏专用布局
• 主题布局: keyboards/TheCore/ 和 keyboards/joao7yt/ 提供特色主题

步骤 7: 自定义样式配置

通过编辑样式文件(.style)可以自定义按键外观：

{
  "Normal": {
    "BackgroundColor": "#FF000000",
    "BorderColor": "#FFFFFFFF",
    "TextColor": "#FFFFFFFF"
  },
  "Pressed": {
    "BackgroundColor": "#FFFFFFFF",
    "BorderColor": "#FFFFFFFF",
    "TextColor": "#FF000000"
  }
}

配置示例

基本键盘配置示例:

{
  "Name": "US International Keyboard",
  "Type": "Keyboard",
  "Keys": [
    {
      "Code": 65,
      "Text": "A",
      "Bounds": [100, 100, 50, 50]
    }
  ]
}

鼠标配置示例:

{
  "Name": "Mouse Controls",
  "Type": "Mouse",
  "Elements": [
    {
      "Code": 1,
      "Text": "LMB",
      "Bounds": [200, 200, 40, 40]
    }
  ]
}

使用技巧

1. 实时显示: NohBoard 会实时显示按键状态，按下时按键会高亮显示
2. 多布局支持: 可以同时加载多个键盘布局并在不同场景间切换
3. 透明背景: 支持设置透明背景，便于在直播软件中使用
4. 自定义热键: 可以通过配置文件设置显示/隐藏热键

故障排除

如果遇到运行问题，请检查：

• .NET Framework 版本是否满足要求
• 显卡驱动是否为最新版本
• 系统权限是否允许应用程序运行

NohBoard 作为一个开源项目，持续接收社区贡献和改进。如果您在使用过程中发现任何问题或有改进建议，欢迎参与项目开发。