console.tfilesource file

TADS 3 Library - console input/output manager

This module defines the low-level functions for handling input and output via the traditional interpreter's user interface, using the local keyboard and console via the "tads-io" function set.

The functions in this module are designed primarily for internal use within the library itself. Games should use the higher level objects and functions defined in input.t and output.t instead of directly calling the functions defined here. The reason for separating these functions is so that we can substitute the Web UI versions for games that wish to use the Web UI insetad of the traditional console UI.

Summary of Classes  


Summary of Global Objects  


Summary of Global Functions  

aHref  aHrefAlt  aioClearScreen  aioInputDialog  aioInputEvent  aioInputFile  aioInputLineCancel  aioInputLineTimeout  aioMorePrompt  aioSay  aioSetLogFile  checkHtmlMode  initDisplay  initUI  statusHTML  terminateUI 

Global Functions  

aHref (href, txt?, title?, flags, =, 0)console.t[189]

Generate a string to show hyperlinked text. If we're not in HTML mode, we'll simply return the text without the hyperlink; otherwise, we'll return the text with a hyperlink to the given HREF.

If the display text is included, we'll generate the entire link, including the <A HREF> tag, the hyperlinked text contents, and the </A> end tag. If the text is omitted, we'll simply generate the <A HREF> tag itself, leaving it to the caller to display the text and the </A>.

The optional 'flags' is a combination of AHREF_xxx flags indicating any special properties of the hyperlink.

aHrefAlt (href, linkedText, altText, title?)console.t[224]
Generate a string to show hyperlinked text, with alternate text if we're not in HTML mode. If we're in HTML mode, we'll return linkedTxt linked to the given HREF; if we're in plain text mode, we'll return the alternate text as-is.

aioClearScreen ( )console.t[165]
Clear the screen

aioInputDialog (icon, prompt, buttons, defaultButton, cancelButton)console.t[145]
Show an input dialog

aioInputEvent (timeout)console.t[113]
Read an input event

aioInputFile (prompt, dialogType, fileType, flags)console.t[135]
Show a file selector dialog

aioInputLineCancel (reset)console.t[102]
Cancel a suspended input line

aioInputLineTimeout (timeout)console.t[93]
Get a line of input from the keyboard, with timeout

aioMorePrompt ( )console.t[124]
Show a "More" prompt

aioSay (txt)console.t[83]
Write text to the main game window

aioSetLogFile (fname, logType?)console.t[155]
Set/remove the output logging file

checkHtmlMode ( )console.t[61]
Check to see if we're in HTML mode

initDisplay ( )console.t[39]
Initialize the display. The library calls this at the start of the game, and after each RESTART, to set up the layout of the game window.

initUI ( )console.t[31]
Initialize the user interface. The library calls this once at the start of the interpreter session to set up the UI. For the console interpreter, we don't need to do anything here; the interpreter takes care of setting up the display window for us.

statusHTML (stage)console.t[249]
Generate HTML to wrap the left/right portions of the status line. The basic status line has three stages: stage 0 precedes the left portion, stage 1 comes between the left and right portions, and stage 2 follows the right portion. If we're listing exits, we get two more stages: stage 3 precedes the exit listing, stage 4 follows it.

terminateUI ( )console.t[52]
Shut down the user interface. The library calls this once just before the game is about to terminate.

TADS 3 Library Manual
Generated on 5/16/2013 from TADS version 3.1.3