browser.tfile
Classes
Summary
Objects
Summary
TADS 3 Library - browser (Web UI) input/output manager
This module defines the low-level functions for handling input and output via the Web UI.
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 to make the UI selection pluggable, so that the same game can be compiled for either the traditional UI or the Web UI simply by plugging in the correct i/o module.
Summary of Classes
WebBannerWin WebWinOutputStream
Summary of Global Objects
browserGlobals commandWin statuslineBanner
Summary of Global Functions
aHref aHrefAlt aioClearScreen aioInputDialog aioInputEvent aioInputFile aioInputLineCancel aioInputLineTimeout aioLogInputEvent aioMorePrompt aioSay aioSetLogFile checkHtmlMode evtCharForScript initDisplay initUI readingEventScript readingScript statusHTML terminateUI
Global Functions
aHref (href, txt?, title?, flags, =, 0)
Generate a string to show hyperlinked text. The browser UI is always in HTML mode, so we unconditionally generate the hyperlink.
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?)
Generate a string to show hyperlinked text, with alternate text if we’re not in HTML mode. The browser UI is always in HTML mode, so we unconditionally generate the hyperlink.
aioClearScreen ( )
Clear the screen
aioInputDialog (icon, prompt, buttons, defaultButton, cancelButton)
Show an input dialog
aioInputEvent (timeout)
Read an input event
aioInputFile (prompt, dialogType, fileType, flags)
Show a file selector dialog
aioInputLineCancel (reset)
Cancel a suspended input line
aioInputLineTimeout (timeout)
Get a line of input from the keyboard, with timeout
aioLogInputEvent (evt)
Log an input event. We call this internally from each of the event input routines to add the event to any event or command log we’re creating.
aioMorePrompt ( )
Show a “More” prompt
aioSay (txt)
Write text to the main game window
aioSetLogFile (fname, typ, =, 1)
Set/remove the output logging file
checkHtmlMode ( )
Check to see if we’re in HTML mode
evtCharForScript (c)
Get an InEvtKey event parameter in suitable format for script file output. This returns the key as it appears in the event, except that ASCII control characters are translated to ‘[ctrl-X]’.
initDisplay ( )
Initialize the display. We call this when we first enter the interpreter, and again at each RESTART, to set up the main game window’s initial layout. We set up the conventional IF screen layout, with the status line across the top and the transcript/command window filling the rest of the display.
initUI ( )
Initialize the user interface. The library calls this once at the start of the interpreter session to set up the UI. For the Web UI, we create the HTTP server and send connection instructions to the client.
readingEventScript ( )
Is an event script active?
readingScript ( )
Is a script file active?
statusHTML (stage)
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 ( )
Shut down the user interface. The library calls this when the game is about to terminate.
TADS 3 Library Manual
Generated on 5/16/2013 from TADS version 3.1.3