Resolve issue #575: Rename text commands

This commit is contained in:
Rangi
2018-11-17 13:33:03 -05:00
parent c05a2d255b
commit 3202c4f3df
123 changed files with 1869 additions and 1745 deletions

View File

@@ -3,47 +3,12 @@
Defined in [macros/scripts/text.asm](/macros/scripts/text.asm) and [home/text.asm:TextCommands](/home/text.asm).
## `$00`: <code>text <i>text</i></code>
## `$00`: `text_start`
Start writing text until `"@"`.
Start writing text until `"@"`. The text can use [control characters](#control-characters).
## `$4E`: <code>next <i>text</i></code>
Move a line down.
## `$4F`: <code>line <i>text</i></code>
Start writing at the bottom line.
## `$50`: <code>page <i>text</i></code>
Start a new Pokédex page.
## `$51`: <code>para <i>text</i></code>
Start a new paragraph.
## `$55`: <code>cont <i>text</i></code>
Scroll to the next line.
## `$57`: `done`
End a text box.
## `$58`: `prompt`
Prompt the player to end a text box (initiating some other event).
## `$01`: <code>text_from_ram <i>address</i></code>
## `$01`: <code>text_ram <i>address</i></code>
Write text from a RAM address.
@@ -81,19 +46,19 @@ Pushes text up two lines and sets the `bc` cursor to the border tile below the
first character column of the text box.
## `$08`: `start_asm`
## `$08`: `text_asm`
Start interpreting assembly code.
## `$09`: <code>deciram <i>address</i>, <i>bytes</i>, <i>digits</i></code>
## `$09`: <code>text_decimal <i>address</i>, <i>bytes</i>, <i>digits</i></code>
Read *bytes* bytes from *address* and print them as a *digits*-digit number.
## `$0A`: `interpret_data`
## `$0A`: `text_pause`
Exit.
Pause for 30 frames unless A or B is pressed.
## `$0B`: `sound_dex_fanfare_50_79`
@@ -101,12 +66,12 @@ Exit.
Play `SFX_DEX_FANFARE_50_79`.
## `$0C`: <code>limited_interpret_data <i>n</i></code>
## `$0C`: <code>text_dots <i>n</i></code>
Print *n* `"…"`s.
Print *n* `"…"`s, pausing for 10 frames after each; interrupt if A or B is pressed.
## `$0D`: `link_wait_button`
## `$0D`: `text_linkwaitbutton`
Wait for button press; show arrow.
@@ -154,7 +119,7 @@ Write text from one of the following addresses (listed in [data/text_buffers.asm
6. `BattleMonNick`
## `$15`: `current_day`
## `$15`: `text_today`
Print the weekday.
@@ -164,6 +129,51 @@ Print the weekday.
Write text from a different bank.
## `$00`: `text_start`
## `$50`: `text_end`
Start writing regular text again after a special command.
Stops processing text commands.
# Control characters
These get interpreted in the context of printing regular text. Macros exist to conveniently place the control characters.
## `$00`: <code>text <i>text</i></code>
Start writing text until `"@"`. (Not actually a control character, but shorter than `text_start` followed by `db`.)
## `$4E`, `"<NEXT>"`: <code>next <i>text</i></code>
Move a line down.
## `$4F`, `"<LINE>"`: <code>line <i>text</i></code>
Start writing at the bottom line.
## `$50`, `"@"`: <code>page <i>text</i></code>
Start a new Pokédex page.
## `$51`, `"<PARA>"`: <code>para <i>text</i></code>
Start a new paragraph.
## `$55`, `"<CONT>"`: <code>cont <i>text</i></code>
Scroll to the next line.
## `$57`, `"<DONE>"`: `done`
End a text box.
## `$58`, `"<PROMPT>"`: `prompt`
Prompt the player to end a text box (initiating some other event).