Other Display Primitives

term_write(int col, int row, char *str, int count,

           int colorclass, int clear)

term_write_attr(int col, int row, int chartowrite,

                int attrtowrite)

term_clear()

term_position(int col, int row)

The following primitives provide low-level screen control. The term_clear( ) primitive clears the screen. The term_position( ) primitive positions the cursor to the indicated row and column. The term_write( ) primitive puts characters directly on the screen. It puts count characters from str on the screen at the row and column in the specified colorclass. If clear is nonzero, it clears the rest of the line. The term_write_attr( ) primitive writes a single character at the specified location on the screen. Unlike term_write( ), which takes a color class, this primitive takes a raw foreground/background color attribute pair. This primitive does nothing in Epsilon for Windows or under the X11 windowing system. For all these primitives, row and col start at 0, and the coordinate 0,0 refers to the upper left corner of the screen. If a keyboard macro is running, the term_ primitives are ignored.

fix_cursor() /* EEL subr. */ user int normal_cursor; user int overwrite_cursor; user int virtual_insert_cursor; user int virtual_overwrite_cursor; #define CURSOR_SHAPE(top, bot) ((top) * 1000 + (bot)) #define GUI_CURSOR_SHAPE(height, width, offset) \ ((offset * 1000 + (height)) * 1000 + (width)) int cursor_shape;
During screen refresh, Epsilon calls the EEL subroutine fix_cursor( ) to set the shape of the cursor. The subroutine chooses one of four variables depending upon the current modes, and copies its value into the cursor_shape variable, which holds the current cursor shape code. The Windows and X11 versions set the gui_cursor_shape variable in a similar way, from a different set of four variables. All these variables use values constructed by the GUI_CURSOR_SHAPE() or CURSOR_SHAPE() macros. See Cursor Shapes for details on these variables.

windows_set_font(char *title, int fnt_code)
The windows_set_font( ) primitive displays a Windows font selection dialog, allowing the user to pick a different font. It takes two parameters. Title specifies the title of the dialog box to display. The fnt_code says whether to set Epsilon's main font (FNT_SCREEN), the font for printing (FNT_PRINTER), or the font for Epsilon's dialogs (FNT_DIALOG). It's only available in the Windows GUI version of Epsilon. See the has_feature variable.

int using_oem_font(int screen) char using_new_font;
The using_oem_font( ) primitive returns a nonzero value if the specified screen's font uses the OEM character set, rather than the ANSI/Windows character set. It takes a screen number. This primitive always returns 0 under Unix. The primitive variable using_new_font will be nonzero whenever some screen's font has been changed since the end of the last screen refresh, or when a new screen has been created, for example by displaying a dialog.

Previous Up Next
Printf-style Format Strings Primitives and EEL Subroutines Highlighted Regions