NativeFX 项目教程

NativeFX 项目教程

NativeFX Native Rendering integration for JavaFX (13 and beyond) 项目地址: https://gitcode.com/gh_mirrors/na/NativeFX

1. 项目介绍

NativeFX 是一个为 JavaFX 提供原生渲染支持的开源项目。它通过使用 Boost IPC 在多个进程之间共享内存，从而实现了在 JavaFX 场景图中集成原生渲染的功能。与其它解决方案不同，NativeFX 使用官方 API，无需任何变通方法，并且在单独的进程中进行原生渲染，即使出现问题也不会导致 JVM 崩溃，非常适合需要稳健解决方案的场景。

2. 项目快速启动

环境要求

• Java >= 11
• C++11 兼容的编译器（如 GCC、Clang、Visual Studio 2017-19）
• CMake >= 3.9
• 互联网连接（依赖项自动下载）
• IDE：Gradle 插件（非命令行使用必需）

构建 NativeFX

使用 IDE

1. 在您喜欢的 IDE 中打开 NativeFX Gradle 项目（已测试使用 VSCode）。
2. 通过调用以下任务来构建项目：

   gradlew clean assemble
   

使用命令行

1. 导航到 NativeFX Gradle 项目目录（例如 path/to/NativeFX/）。
2. 输入以下命令：
   • Linux/macOS/Cygwin/其他 Unix shell：

     ./gradlew clean assemble
     

   • Windows (CMD)：

     gradlew clean assemble
     

测试 NativeFX

步骤 1：编译并运行 sample-server

1. 导航到 sample-servers/sample-server/ 目录。
2. 创建并进入 build 目录：

   mkdir build
   cd build
   

3. 使用 CMake 配置并构建项目：
   • Linux/macOS/Cygwin/其他 Unix shell：

     cmake ..
     make
     ./sample-server -n _mem_1
     

   • Windows (CMD)：

     cmake -DCMAKE_GENERATOR_PLATFORM=x64 ..
     MSBuild.exe sample-server.sln /property:Configuration=Release /property:Platform=x64
     Release\x64\sample-server.exe -n _mem_1
     

步骤 2：运行示例 JavaFX 应用程序

1. 导航回 NativeFX 项目目录（例如 path/to/NativeFX/）。
2. 运行以下命令：
   • Linux/macOS/Cygwin/其他 Unix shell：

     ./gradlew run
     

   • Windows (CMD)：

     gradlew run
     

3. 点击“Connect”按钮。

3. 应用案例和最佳实践

应用案例

• 集成原生应用程序：NativeFX 允许将原生应用程序（如 OpenGL、Qt 应用程序或 Blink/WebKit）集成到 JavaFX 场景图中。
• 性能优化：通过使用 PixelBuffer API，NativeFX 提供了比传统 CPU 缓冲区更高效的渲染方式，性能提升约 50%。

最佳实践

• 使用最新 JavaFX 版本：NativeFX 兼容 JDK13 和 JavaFX 13，建议使用最新版本以获得最佳性能和功能支持。
• 配置环境变量：在 Windows 上，确保 MSBuild.exe 在 PATH 中，以便 CMake 能够正确配置项目。

4. 典型生态项目

• DriftFX：一个使用内部 API 进行直接纹理共享的项目，适用于需要更高性能的场景。
• JavaFX：作为 NativeFX 的基础框架，JavaFX 提供了丰富的 UI 组件和强大的场景图支持。
• Boost IPC：用于进程间通信，是 NativeFX 实现原生渲染的关键技术。

NativeFX Native Rendering integration for JavaFX (13 and beyond) 项目地址: https://gitcode.com/gh_mirrors/na/NativeFX