View source for Status

The '''status''' command displays the inventory screen.

== Syntax ==

status();

== Remarks ==

The inventory screen is a [[text mode]] screen that lists all [[inventory item]]s that are currently in the player's inventory (meaning they have a [[OBJECT File (AGI)|room number]] value of 255). The items are displayed in two columns, with the left column left-justified and the right column right-justified. The screen includes header text "You are carrying:" centered on the top line. If there are no items in the player's inventory, "Nothing" is displayed, centered just below the header. The colors for the inventory screen are always black text on a white background; the '''[[set.text.attribute]]''' command does not affect the inventory screen.

There are two modes for the inventory screen, depending on the value of [[reserved flag]] [[f13 (inventory selection enabled)]]. If f13 (inventory selection enabled) is reset to FALSE, AGI halts the game while the inventory screen is displayed, until the player presses any key. The game then returns to the [[graphics]] screen and resumes.

If f13 (inventory selection enabled) is set to TRUE, the inventory screen enables the player to select an item. The player can use the cursor keys to highlight an item. Pressing ENTER chooses the item, while pressing ESC cancels the selection. AGI then returns to the [[graphics]] screen and resumes. 

[[Reserved variable]] [[v25 (selected inventory item)]] is set to selected item's index from the [[OBJECT File (AGI)|OBJECT file]]. If ESC was pressed, v25 is set to 255. If there is nothing to select, v25 is set to 0. Note that if v25 is set to the index number of any item in the player's inventory prior to calling '''status''', that item will be selected by default when the inventory screen is displayed.

== Possible Errors ==

Do not use the '''status''' command when the [[text screen]] is active. Because of the way AGI handles color settings, the '''status''' command will clear the screen to black (not white) and doesn't display the header, but the items still show as black text on white background. After the '''status''' screen is dismissed, AGI will also go back to the the [[graphics]] screen even if called from the text screen.

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
reset(inv_select_enabled);
status();  [ just  displays inventory; no selection possible
...
set(inv_select_enabled);  [ enable selection
selectedItem = 0;         [ make sure nothing is pre-selected
status();
if(selectedItem !=0 && selectedItem != 255)
  { [ if something was selected
  v90 = selectedItem;
  v90 += 200; [ item views are offset by 200
  show.obj.v(v90);
  }
</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:'''
| 124 (0x7C hex)
|}

== See Also ==

[[Inventory Item Commands]]<br />
[[Category:Commands]]<br />