Andrew Branscom: Andrew Branscom moved page Display to Display Command without leaving a redirect

2026-03-29T01:33:25Z

Andrew Branscom moved page Display to Display Command without leaving a redirect

← Older revision	Revision as of 21:33, 28 March 2026
(No difference)

Andrew Branscom: 2 revisions imported

2025-02-16T20:22:26Z

2 revisions imported

← Older revision	Revision as of 16:22, 16 February 2025
(No difference)

Andrew Branscom: 1 revision imported

2024-06-03T04:55:23Z

1 revision imported

← Older revision	Revision as of 00:55, 3 June 2024
(No difference)

Andrew Branscom: 1 revision imported

2022-01-28T16:19:38Z

1 revision imported

New page

The '''display''' command displays text at a specified row and column.

== Syntax ==

display([[number|byt]] ROW, [[number|byt]]COL, [[message|msg]] mMSG);<br />
display([[number|byt]] ROW, [[number|byt]] COL, "message text");

== Remarks ==

This command takes a numbers as arguments. '''[[display.v]]''' also displays text, but all arguments are [[variable|variables]].

The text of [[message]] '''mMSG''' is displayed at row '''ROW''' and column '''COL''', using the background and foreground colors set by the most recent '''[[set.text.attribute]]''' command. Note that unlike the '''[[print]]''' commands, the '''display''' command does not include a border around the message text.

The '''display''' command is mostly used on the [[text screen]]. Typical uses for the text screen are to display help screens, or passages of text from in game items such as books, letters, etc.

The '''display''' command will also display text messages on the [[graphics screen]]. Care must be taken in this case, because the text does not automatically clear. Also, if a [[screen object]] moves over the displayed text, the text will be erased pixel by pixel as the the object moves past. The programmer should take care to be sure the displayed text will not be accidentally erased by moving objects.

A typical use of the '''display''' command on the graphics screen is to add text to credit screens, or maybe to provide changing text on signs or such.

== Possible Errors ==

If you pass a row value greater than 24, your text will not display at all. If you pass a column value greater than 39, the first character of the display message will be placed slightly below the desired '''ROW''' value, with a vertical offset in pixels equal to INT('''COL'''/40), in a column equal to the '''COL''' value MOD 40, and the rest of the display message will be left aligned, one row below the desired '''ROW''' value.

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
text.screen(); [ change to text screen so we can use all colors
set.text.attribute(3, 0); [ cyan text on black background
display(6, 10, "Burma Shave");
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in all AGI versions.
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 103 (0x67 hex)
|}

== See Also ==

'''[[display.v]]'''<br />
'''[[set.text.attribute]]'''<br />
[[Category:Commands]]<br />

Display Command - Revision history

Andrew Branscom: Andrew Branscom moved page Display to Display Command without leaving a redirect

Andrew Branscom: 2 revisions imported

Andrew Branscom: 1 revision imported

Andrew Branscom: 1 revision imported