fpPS4 项目使用指南

核心功能概览

fpPS4 是基于 Free Pascal 开发的 PS4 兼容层（emulator），旨在通过软件模拟实现 PS4 应用程序的跨平台运行。项目采用模块化架构，涵盖从内核抽象到底层图形渲染的完整功能栈，核心能力包括 ELF 文件解析、GPU 指令转换、系统调用模拟等。

快速上手

3 分钟启动流程

1. 环境准备
   克隆项目仓库：git clone https://gitcode.com/gh_mirrors/fp/fpPS4
   ⚠️ 确保系统已安装 Free Pascal 编译器（建议 3.2.0+ 版本）和 Lazarus IDE。

2. 编译运行
   双击 fpPS4.lpi 打开项目，在 Lazarus 中点击「运行」按钮，程序将自动完成编译并启动模拟器核心。

3. 验证安装
   成功启动后，控制台会输出初始化日志，主窗口显示 "fpPS4 initialized" 即表示核心模块加载正常。

目录功能速查表

目录名	作用	关键文件
src/	主程序逻辑实现	ps4_libscepad.pas（手柄输入模块）、ps4_libscevideoout.pas（视频输出）
vulkan/	Vulkan 图形接口封装	vDevice.pas（设备管理）、vPipeline.pas（渲染管线）
shaders/	着色器模块的资源存储区	FLIP_TILE_A8R8G8B8_SRGB.comp（色彩转换着色器）
kernel/	内核系统调用模拟	ps4_libkernel.pas（核心函数封装）
spirv/	SPIR-V（着色器中间语言）处理	spirv.pas（指令解析）、SprvEmit.pas（代码生成）

深度解析

功能模块关联图

• 核心调用链：fpPS4.lpr（入口）→ ps4_program.pas（程序管理）→ kernel/（系统调用）→ vulkan/（图形渲染）
• 资源流转：src/ 中的输入模块（如 sce_pad_interface.pas）通过 sys/ 层抽象，将用户输入传递给 vulkan/vRender.pas 实现画面响应；shaders/ 目录的着色器文件经 spirv/ 模块编译后，由 vulkan/vShaderManager.pas 加载使用。

关键配置说明

• 项目配置：fpPS4.lpi 存储编译参数，可通过 Lazarus 的「项目选项」调整目标平台和依赖库。
• 资源管理：fpPS4.res 包含图标等静态资源，修改后需重新编译资源文件。

常见问题

编译失败怎么办？

💡 检查 tag.inc 中的版本定义是否与系统环境匹配，缺失依赖时可通过 static/ 目录下的静态库文件手动链接。

图形渲染异常？

⚠️ 确保 Vulkan SDK 已正确安装，vulkan/ 目录下的 Vulkan.pas 需与系统 Vulkan 运行时版本一致。