/** 
 * FACILITY --- The Optional Facility Word Set
 *
 *  Copyright (C) Tektronix, Inc. 1998 - 2001. All rights reserved.
 *
 *  @see     GNU LGPL
 *  @author  Tektronix CTE              @(#) %derived_by: guidod %
 *  @version %version: 5.8 %
 *    (%date_modified: Mon Mar 12 10:32:17 2001 %)
 *
 *  @description
 *      There are the following primitive words for input and output:
 *
 *      KEY waits for a character typed on the keyboard and returns
 *      that character, but KEY does not return non-character
 *      input events like function keys pressed - use EKEY for 
 *      a more complete keyboard query.
 *      Furthermore, KEY? returns true if a key is available for
 *      reading using KEY (function key presses are not detected
 *      but discarded).
 *
 *      EMIT will display the character at the current cursor
 *      position, control characters take effect depending on the
 *      system. TYPE displays all the chars in the given string 
 *      buffer.
 *
 *      To get the current cursor position, use AT-XY.
 */
/*@{*/

#if defined(__version_control__) && defined(__GNUC__)
static char* id __attribute__((unused)) = 
"@(#) $Id: %full_filespec: facility-ext.c~5.8:csrc:bln_12xx!1 % $";
#endif

#define _P4_SOURCE 1

#include <pfe/pfe-base.h>
#include <pfe/def-xtra.h>

#include <time.h>

#include <pfe/term-sub.h>
#include <pfe/_missing.h>

/** AT-XY ( col row -- )
 * move the cursor position to the given row and column
 * of the screen. If the output device is not a terminal
 * this will have no effect but can still send an
 * escape sequence.
 */
FCode (p4_at_x_y)
{
    p4_gotoxy (SP[1], SP[0]);
    SP += 2;
}

/** KEY? ( -- flag )
 * if a character is available from the keyboard, return true.
 * The KEY word will retrieve the actual character.
 */
FCode (p4_key_question)
{
    FX_PUSH (P4_FLAG (p4_keypressed ()));
}

/* Facility Extension Words */

/** EKEY ( -- keycode )
 * return a keyboard event, the encoding may differ, esp.
 * that it can contain special keys.
 */
FCode (p4_ekey)
{
    FX_PUSH (p4_getekey ());
}

/** EKEY>CHAR ( keycode -- keycode false | char true )
 */
FCode (p4_ekey_to_char)
{
    --SP;
    SP[0] = P4_FLAG ((p4ucell) SP[1] < 0x100);
}

/** EKEY? ( -- flag )
 * check if a character is available from the keyboard
 * to be received - unlike KEY? it will not discard
 * non-visible codes.
 */
FCode (p4_ekey_question)
{
    FX_PUSH (P4_FLAG (p4_ekeypressed ()));
}

/** EMIT? ( -- flag )
 * if EMIT can safely output characters without
 * blocking the forth by waiting for an indefinite time.
 */
FCode (p4_emit_question)
{
    FX_PUSH (P4_TRUE);
}

/** MS ( n -- )
 * wait at least the specified milliseconds
 * (suspend the forth tasklet)
 */
FCode (p4_ms)
{
    p4_delay (*SP++);
}

/** TIMEamp;DATE ( -- sec min hrs day month year )
 * return the broken down current time
 */
FCode (p4_time_and_date)
{
    time_t t;
    struct tm *tm;
    
    time (&t);
    tm = localtime (&t);
    SP -= 6;
    SP[5] = tm->tm_sec;
    SP[4] = tm->tm_min;
    SP[3] = tm->tm_hour;
    SP[2] = tm->tm_mday;
    SP[1] = tm->tm_mon + 1;
    SP[0] = tm->tm_year + 1900;
}

/** PAGE ( -- )
 * CLRSCR
 */

extern FCode(p4_dot_clrscr);
#define p4_dot_clrscr_ p4_dot_clrscr

P4_LISTWORDS (facility) =
{
     (, ),
     (,		),
     (,		),
     (,		),
     (,		),
     (,	),
     (,		),
     (,		),
     (,		),
     (,	),

     (,	 ),
     (,	 ),
};
P4_COUNTWORDS (facility, "Facility + extensions");

/*@}*/