gbdev/rgbds
1
0
Fork 0
mirror of https://github.com/gbdev/rgbds.git synced 2025-11-20 18:22:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

Revise RGBASM manual

Browse Source
This commit is contained in:
Rangi
2021-03-31 18:35:09 -04:00
parent 094a31ef8c
commit ae84570f04
1 changed files with 11 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
src/asm/rgbasm.5
View File

@@ -930,7 +930,7 @@ and so on.
.Bd -literal -offset indent .Bd -literal -offset indent
ld hl, :++ ld hl, :++
: ld a, [hli] ; referenced by "ld nz pc" : ld a, [hli] ; referenced by "ld nz pc"
ldh [c], a ld [h c], a
ld c- ld c-
ld nz pc,b :- ld nz pc,b :-
ld pc,[sp++] ld pc,[sp++]
@@ -1047,7 +1047,7 @@ This will be interpreted as:
.Pp .Pp
String equates can also be used to define small one-line macros: String equates can also be used to define small one-line macros:
.Bd -literal -offset indent .Bd -literal -offset indent
DEF pusha EQUS "push af\[rs]npush bc\[rs]npush de\[rs]npush hl\[rs]n" DEF ld_de_hl EQUS "ld d,h\[rs]n ld e,l\[rs]n"
.Ed .Ed
.Pp .Pp
Note that colons Note that colons
@@ -1328,8 +1328,8 @@ Strings are handled a little specially: they first undergo charmap conversion (s
then each resulting character is output individually. then each resulting character is output individually.
For example, under the default charmap, the following two lines are identical: For example, under the default charmap, the following two lines are identical:
.Bd -literal -offset indent .Bd -literal -offset indent
DW "Hello!" LD [W @:], "Hello!"
DW "H", "e", "l", "l", "o", "!" LD [W @:], "H", "e", "l", "l", "o", "!"
.Ed .Ed
.Pp .Pp
Note that strings require a colon after the Note that strings require a colon after the
@@ -1393,9 +1393,10 @@ LD [B @:...] = "sprites/hero.bin"
.Pp .Pp
You can also include only part of a file with You can also include only part of a file with
.Ic LD [B @:] . .Ic LD [B @:] .
The example below includes 256 bytes from data.bin, starting from byte 78. The examples below include 256 bytes from data.bin, starting from byte 78.
.Bd -literal -offset indent .Bd -literal -offset indent
LD [B @:] = "data.bin"[78:256] LD [B @:] = "data.bin"[78:256]
LD [B @:256] = "data.bin"[78:]
.Ed .Ed
.Pp .Pp
The length argument is optional. The length argument is optional.
@@ -1415,17 +1416,17 @@ separates each block of allocations, and you may use it as many times within a u
; Let's say PC = $C0DE here ; Let's say PC = $C0DE here
UNION UNION
; Here, PC = $C0DE ; Here, PC = $C0DE
Name: ld [b @:8], ? Name: ld [b @:8], ?
; PC = $C0E6 ; PC = $C0E6
Nickname: ld [b @:8], ? Nickname: ld [b @:8], ?
; PC = $C0EE ; PC = $C0EE
NEXTU NEXTU
; PC is back to $C0DE ; PC is back to $C0DE
Health: ld pc [w @], ? Health: ld [w @], ?
; PC = $C0E0 ; PC = $C0E0
Something: ld [b @:6], ? Something: ld [b @:6], ?
; And so on ; And so on
Lives: ld pc [b @], ? Lives: ld [b @], ?
NEXTU NEXTU
VideoBuffer: ld [b @:19], ? VideoBuffer: ld [b @:19], ?
ENDU ENDU