# QGBoy

**Repository Path**: Morphlng/qgboy

## Basic Information

- **Project Name**: QGBoy
- **Description**: A gb/gbc emulator using gameboycore library. Ui wrapped by Qt5
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-03-29
- **Last Updated**: 2022-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QGBoy

### 介绍
A gb/gbc emulator using [gameboycore](https://github.com/nnarain/gameboycore) library. Ui wrapped by Qt5

### 软件架构
1. [gameboycore](https://github.com/nnarain/gameboycore)是一个不依赖任何第三方库的、纯C++11编写而成的GBC模拟器核心模块。它本身不能输出图像、声音，但你只需要使用它提供的[api](https://github.com/nnarain/gameboycore/blob/develop/src/gameboycore/include/gameboycore/gameboycore.h)，将数据提供给对应的第三方库即可实现一个完整的模拟器。

2. 本项目使用Qt对该库进行了封装，完成了图像与音频的输出。理论上，该项目可以跨平台部署，但开发过程中为了方便调试使用VS2019+Qt 5.15.2的环境进行构建。在其他平台部署，可以使用Qt Creator对项目进行重构，但需要注意一些预处理器的定义。


### 构建教程

1.  `git clone`本仓库
1.  使用Visual Studio打开`QGBoy.sln`
1.  以`release x64`模式构建

### 使用说明

1.  按键对应

| Keyboard | GameBoy Joypad |
| :------: | :------------: |
|    W     |       Up       |
|    A     |      Left      |
|    S     |      Down      |
|    D     |     Right      |
|    J     |       A        |
|    K     |       B        |
|  Enter   |     START      |
|  Shift   |     SELECT     |



### 参与贡献

1.  Fork 本仓库
2.  发起issue
3.  提交代码
4.  新建 Pull Request

### 鸣谢

|            [nnarain]([https://github.com/nnarain)            |              [CTurt](https://github.com/CTurt)               |
| :----------------------------------------------------------: | :----------------------------------------------------------: |
| <img width="60" src="https://avatars.githubusercontent.com/u/8395093?v=4"/> | <img width="60" src="https://avatars.githubusercontent.com/u/6132330?v=4"/> |