RGBASM-OLD(5) File Formats Manual RGBASM-OLD(5) (NAME) rgbasm-old - (DESCRIPTION) rgbasm(5) . RGBDS . ( ) . (REMOVED) . . LD LDH (rgbasm -l) 0.7.0 0.8.0 . rgbasm(1) `LD' `LDH' $FF00-$FFFF -L . 0.6.0 rgbasm(1) -l . `LDH' -L -l rgbasm(1) . NOP HALT (rgbasm -H) 0.7.0 0.8.0 . rgbasm(1) `NOP' `HALT' -h . 0.6.0 rgbasm(1) -H . `NOP' `HALT' -h -H rgbasm(1) . (Nested macro definitions) 0.4.2 . ( ENDM ) . : MACRO outer DEF definition EQUS """ MACRO inner println (\1) - (\\1) \nENDM""" {definition} PURGE definition ENDM outer 10 inner 3 ; prints 7 DS (Negative DS) 0.3.2 . << >> @ RAM . UNION . (Section-local charmaps) 0.3.9 0.4.0 . CHARMAP SECTION `main' SECTION . PUSHC POPC . __FILE__ __LINE__ 0.6.0 0.7.0 . WARN FAIL . _PI 0.5.0 0.6.0 . `3.141592653' . __DATE__ __TIME__ 1.0.0 . `__ISO_8601_LOCAL__' . (Treating multi-character strings as numbers) 0.9.0 1.0.0 . CHARMAP . : CHARMAP "X", $12 CHARMAP "Y", $34 LD BC, "XY" CHARMAP : CHARMAP "X", $12 CHARMAP "Y", $34 CHARMAP "", 'X', 'Y' LD BC, CHARVAL("", 0) << 8 | CHARVAL("", 1) : CHARMAP "X", $12 CHARMAP "Y", $34 LD BC, 'X' << 8 | 'Y' : CHARMAP "X", $12 CHARMAP "Y", $34 CHARMAP "", 'X' << 8 | 'Y' LD BC, '' (Treating strings as numbers) 1.0.0 . CHARVAL . `LD A, "R"', `LD A, 'R'' . `CP STRUPR("\1")', CHARVAL `CP CHARVAL(STRUPR("\1"))' . rgbgfx -f/--fix -F/--fix-and-save 0.6.0 . `rgbgfx -c/--colors' . `-c embedded', PNG . rgbgfx -D/--debug 0.6.0 . (REPLACED) . . DEF (Defining constants and variables without DEF) 0.7.0 0.8.0 . EQU, EQUS, =, RB, RW, RL . DEF . EQUS `{interpolation}' . (Defining macros like labels) 0.6.0 0.7.0 . `name: MACRO' . `MACRO name' . EQUS `{interpolation}' . SET (Defining variables with SET) 0.5.2 0.6.0 . `name SET value' . `DEF name = value' . (Global labels without colons) 0.4.0 0.5.0 . . `Label:' `Label::'. '\,' ('\,' in strings within macro arguments) 0.5.0 0.7.0 . . . '*' ('*' comments) 0.4.1 0.5.0 . `*' . `;' . STRIN STRRIN STRSUB CHARSUB 1.0.0 . . STRIN, STRFIND; STRRIN, STRRFIND; STRSUB, STRSLICE; CHARSUB, STRCHAR . STRSLICE . PRINTT PRINTI PRINTV PRINTF 0.5.0 0.6.0 . . PRINT PRINTLN STRFMT `{interpolation}' . IMPORT XREF 0.4.0 . . . GLOBAL XDEF 0.4.2 0.5.0 . EXPORT . HOME CODE DATA BSS 0.3.0 0.4.0 . HOME, ROM0; CODE DATA, ROMX; BSS, WRAM0 . JP [HL] 0.3.0 0.4.0 . `JP HL' . LDI A, HL LDD A, HL 0.3.0 0.4.0 . `LDI A, [HL]' `LDD A, [HL]' ( `LD A, [HLI]' `LD A, [HLD]'; `LD A, [HL+]' `LD A, [HL-]') . LDIO 0.9.0 1.0.0 . `LDH' . LD [C], A LD A, [C] 0.9.0 1.0.0 . `LDH [C], A' `LDH A, [C]' . `LD [$FF00+C], A' `LD A, [$FF00+C]' 0.9.0 0.9.1 . LDH [n8], A LDH A, [n8] 0.9.0 1.0.0 . `LDH' <<>> $00 $FF $FF00 $FFFF . `LDH [n16], A' `LDH A, [n16]' . LD HL, [SP + e8] 0.3.0 0.4.0 . `LD HL, SP + e8' . LDHL SP, e8 ASMotor RGBDS . `LD HL, SP + e8' . OPT z 0.4.0 0.5.0 . OPT p . rgbasm -i 0.6.0 0.8.0 . -I --include . rgbfix -O/--overwrite 1.0.0 . `-Wno-overwrite' . rgbgfx -h/--horizontal 0.6.0 . -Z --columns . rgbgfx --output-* 0.7.0 0.8.0 . --auto-* . (CHANGED) (breaking changes) . (Trigonometry function units) 0.6.0 . . << >> . <<>> (turns) . : o `SIN(0.25) == 0.00002', 0.25 = 0.25 / 65536.0 = 0.000004 = 0.000008 sin (0.000008 ) = 0.00002 o `SIN(16384.0) == 1.0', 16384.0 = 16384.0 / 65536.0 = 0.25 = / 2 sin ( / 2) = 1 o `ASIN(1.0) == 16384.0' : o `SIN(0.25) == 1.0', 0.25 = 0.25 = / 2 sin ( / 2) = 1 o `SIN(16384.0) == 0.0', 16384 = 16384 = 32768 sin (32768 ) = 0 o `ASIN(1.0) == 0.25' % (% operator behavior with negative dividend or divisor) 0.5.0 . ( ) `%' ( ). : o `13 % 10 == 3' o `-13 % 10 == -3' o `13 % -10 == 3' o `-13 % -10 == -3' : o `13 % 10 == 3' o `-13 % 10 == 7' o `13 % -10 == -7' o `-13 % -10 == -3' ** (** operator associativity) 0.9.0 . `**' . : `p ** q ** r == (p ** q) ** r'. : `p ** q ** r == p ** (q ** r)'. (BUGS) . . (Space between exported labels' colons) 0.7.0 . `Label: :'. `Label::' . (Space between label and colon) 0.9.0 . () `Label :' `Label ::'. `Label' `:' `::' . `Label:' `Label::' . (Extra underscores in integer constants) 1.0.0 . ( ) . `q' . ADD r16 HL (ADD r16 with implicit first HL operand) 0.5.0 . `ADD BC' `ADD HL, BC' `DE', `HL', `SP'. `HL' . = SET (= instead of SET) 0.4.0 . = SET = SET . SET . (SEE ALSO) rgbasm(1), gbz80(7), rgbds(5), rgbds(7) (HISTORY) rgbasm(1) Carsten Sorensen ASMotor Justin Lloyd RGBDS . https://github.com/gbdev/rgbds . Linux 6.12.107+deb13-amd64 August 1, 2026 Linux 6.12.107+deb13-amd64