Difference between revisions of "AGI Command Reference - Text Management Commands"

From AGI Wiki
Jump to navigationJump to search
(Blanked the page)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
[[Tutorials and Guides|Tutorials and Guides Table of Contents]]<br />
 
[[AGI Command Reference|AGI Command Reference Index]]<br />
 
  
<div align="center">
 
Page:
 
[[AGI Command Reference - Arithmetic Commands|1]] |
 
[[AGI Command Reference - Commands to Load and unLoad Resources|2]] |
 
[[AGI Command Reference - Program Control Commands|3]] |
 
[[AGI Command Reference - Object Control Commands|4]] |
 
[[AGI Command Reference - Object Description Commands|5]] |
 
[[AGI Command Reference - Object Motion Control Commands|6]] |
 
[[AGI Command Reference - Inventory Item Management Commands|7]] |
 
[[AGI Command Reference - Picture Resource Management Commands|8]] |
 
[[AGI Command Reference - Sound Resource Management Commands|9]] |
 
[[AGI Command Reference - Text Management Commands|10]] |
 
[[AGI Command Reference - String Management Commands|11]] |
 
[[AGI Command Reference - Initialization Commands|12]] |
 
[[AGI Command Reference - Menu Management Commands|13]] |
 
[[AGI Command Reference - Test Commands|14]] |
 
[[AGI Command Reference - Other Commands|15]] |
 
[[AGI Command Reference - Unknown Commands|16]]
 
</div><br />
 
 
<div align="center"><span style="font-size: 22pt">Text Management Commands</span><br />
 
''By [[Chris Cromer]]''</div>
 
 
&nbsp;
 
 
== <br />prevent.input(); ==
 
 
<blockquote>Prevents the user from entering anything using the keyboard.</blockquote>
 
 
== accept.input(); ==
 
 
<blockquote>Allows the user to enter text using the keyboard.</blockquote>
 
 
== print(n); print.v(n); ==
 
 
<blockquote>Opens a text window in the center of the screen, where a message number n (or Var(n)) from the messages field of the current LOGIC resource is displayed. Output mode is determined by Flag(15).
 
The message is a NULL-terminated string of text. In addition to letters, digits, and other symbols, the string may contain:<br />
 
<br />
 
* Newline character (0Ah);
 
* Format element:
 
** %v - at this place the output will include a decimal value of variable with the given number.
 
** %m - the text of the message with the given number is inserted at this place.
 
** %0 - the name of the item with the given number is inserted at this place.
 
** %w - a vocabulary word with the given number is inserted at this place.
 
** %s - a string variable with the given number is inserted at this place.
 
** %g - a message with this number from message field of Logic(0) is inserted at this place.<br />
 
<br />
 
For v format, you can add a vertical line and a number of characters the output should take. In this case leading zeros are not suppressed in the output. Example: %v34 | 2 When you write your messages, remember that the interpreter wraps the text between the lines as needed when the message is displayed.</blockquote>
 
 
== display(R, C, N); display.v(R, C, N); ==
 
 
<blockquote>Prints a message number N (Var(N)) in the row R (Var(R)), starting with the column C (Var(C)). No window is created, so it is up to the programmer to erase the output when it is no longer needed.</blockquote>
 
 
== print.at(n, x, y, l); print.at.v(n, x, y, l); ==
 
 
<blockquote>Analogous to print but the programmer can specify the window location. x, y, and l are constants specifying coordinates of the top left corner of the window and its width in character cells of a 40x25 screen.</blockquote>
 
 
== version(); ==
 
 
<blockquote>Prints interpreter version in the center of the screen.</blockquote>
 
 
== text.screen(); ==
 
 
<blockquote>The screen switches to the text mode 40x25.</blockquote>
 
 
== graphics(); ==
 
 
<blockquote>The screen returns to the graphics mode. The picture on the screen is restored.</blockquote>
 
 
== set.cursor.char(n); ==
 
 
<blockquote>First byte of the message n is user as a text mode cursor.</blockquote>
 
 
== set.text.attribute(F, B); ==
 
 
<blockquote>Sets foreground and background colors for display, get_num, and get_string commands.</blockquote>
 
 
== clear.lines(n, m, C); ==
 
 
<blockquote>Clears text lines from n to m using color C.</blockquote>
 
 
== clear.text.rect(x1, y1, x2, y2, C); ==
 
 
<blockquote>Clears a rectangular area with top left corner coordinates (x1,y1) and bottom right coordinates (x2,y2) using color C.</blockquote>
 
 
== status.line.on(); ==
 
 
<blockquote>Shows the status line containing the current score and sound status (on/off).</blockquote>
 
 
== status.line.off(); ==
 
 
<blockquote>Removes the status line.</blockquote>
 
 
&nbsp;
 
 
<div align="center">
 
Page:
 
[[AGI Command Reference - Arithmetic Commands|1]] |
 
[[AGI Command Reference - Commands to Load and unLoad Resources|2]] |
 
[[AGI Command Reference - Program Control Commands|3]] |
 
[[AGI Command Reference - Object Control Commands|4]] |
 
[[AGI Command Reference - Object Description Commands|5]] |
 
[[AGI Command Reference - Object Motion Control Commands|6]] |
 
[[AGI Command Reference - Inventory Item Management Commands|7]] |
 
[[AGI Command Reference - Picture Resource Management Commands|8]] |
 
[[AGI Command Reference - Sound Resource Management Commands|9]] |
 
[[AGI Command Reference - Text Management Commands|10]] |
 
[[AGI Command Reference - String Management Commands|11]] |
 
[[AGI Command Reference - Initialization Commands|12]] |
 
[[AGI Command Reference - Menu Management Commands|13]] |
 
[[AGI Command Reference - Test Commands|14]] |
 
[[AGI Command Reference - Other Commands|15]] |
 
[[AGI Command Reference - Unknown Commands|16]]
 
</div><br />
 
 
[[Tutorials and Guides|Tutorials and Guides Table of Contents]]<br />
 
[[AGI Command Reference|AGI Command Reference Index]]
 
 
<span style="float: left">[[AGI Command Reference - Sound Resource Management Commands|&lt; Previous: Sound Resource Management Commands]]</span><span style="float: right">[[AGI Command Reference - String Management Commands|Next: String Management Commands &gt;]]</span>
 
 
&nbsp;
 
 
[[Category:Logic]]
 
[[Category:Commands]]
 
[[Category:References]]
 
[[Category:Tutorials]]
 

Latest revision as of 19:58, 22 March 2019