gbdev / gbdev/awesome-gbdev

Possible addition gbz80-pseudoOps

Open
#135 10 comments 5 reactions 1 assignee Claimed by @ISSOtm View on GitHub
addition meta
Dominant language
No language data
Stars
4.5k
Forks
195
PR merge metrics
No merged PRs in 30d

Description

I have been working on a library that I think other Game Boy developers could make use of. It is hosted here https://github.com/joeldipops/gbz80-pseudoOps

I'm spruiking my own work so I don't feel qualified to answer the question "Is it awesome" but I think it fits the three criteria

**It must be in a minimal working state;**
Although I intend for the library to continue to grow and improve, I believe in its current state it is already useful. The 20 or so macros already written are working and reasonably well documented.

**It must have a clear purpose or provide something interesting**
The purpose is to
a) polyfill operations that feel like they could exist on the gameboy CPU but don't, for example moving data from one memory address to another `ldAny [LcdControl], LCD_ON` or 16 bit subtraction `sub16 HL, BC`
b) Make rgbasm code more readable, through the above polyfills and intuitive constant names.

**It must provide a minimal documentation briefly describing what is the project and how to make use of it.**
There's a README.md with instructions for including the library and documenting most of the macros, including size, cycle counts and flags affected.

My only concern is that I'm worried I'm the only person that would find this stuff useful. I haven't seen anyone else that dislikes gbhw.inc and it's "rSCY" style naming, and I've completely ignored some advice I've read not to indent asm code as I would an OOP language.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.