WCREATE_TERM0(3W)
Series 300 and 500 Only
NAME
wcreate_term0 − create Term0 window
SYNOPSIS
int wcreate_term0(wmfd,name,x,y,wincols,winrows,scrncols,scrnrows,bufcols,
bufrows,basefont,altfont,colormode,border);
int wmfd;
char *name;
int x,y,wincols,winrows,scrncols,scrnrows,bufcols,bufrows;
char *basefont,*altfont;
int colormode,border;
DESCRIPTION
wmfd
is an integer file descriptor for an opened window manager device interface.
name
a pointer to a path name that is used to make the device node that is associated with the new window.
x,y the device coordinates for the upper left corner of the contents portion of the window (ignoring the window borders), with respect to the upper left corner of the screen.
wincols,winrows
the width and height of the window in columns and rows. Note that each 2-byte character takes up two columns. This specifies the size of the contents portion of the window, and does not include space for a label and borders.
scrncols,scrnrows
the width and height of the terminal screen being emulated in columns and rows.
bufcols,bufrows
the width and height of the scroll buffer in columns and rows.
basefont,altfont
pointers to path names for the base and alternate font files to be used. If altfont is NULL, basefont will be used for both the base and the alternate font. HP-15 (2-byte) fonts may not be used for the alternate font. If altfont is a HP-15 font or if altfont is NULL and basefont is a HP-15 font, an error will result and the window will not be created.
colormode
enables color mode on color systems. A value of 2 indicates a color system. This parameter should always be set to 2.
border
chooses either thin or normal borders for the terminal window. A value of 1 indicates normal borders. A value of 0 indicates thin borders. If normal borders are chosen, there is a minimum size for the terminal, which is enforced. A normal border contains the window name and various symbols for manipulating the window. A thin border consists of a thin blank frame around the window with no name or symbols.
DISCUSSION
Create a Term0 window type with default characteristics. The width and height of the terminal screen must be no larger than the scroll buffer. Similarly, the size of the window must be no larger than the terminal screen. The terminal screen is used for screen-relative cursor addressing.
The default characteristics are:
∗ The window is offscreen (that is, not visible).
∗ The keyboard is not attached to the terminal emulator.
∗ The 8 alpha color pairs are initialized identically to the color pairs of the HP2627A terminal.
∗ Color pair 0 (white characters on black background) is selected.
∗ The basename of the window path name is used as the border label, if the border is not "thin".
∗ The cursor is at column 0, row 0, and is turned on (enabled).
∗ The terminal screen being emulated is positioned at the upper left of the scroll buffer.
∗ The window is positioned at the upper left of the terminal screen.
∗ There are no characters in the scroll buffer.
∗ The softkeys are in USER state, labeled f1 through f8, but are not displayed.
∗ There are no fonts in the cache other than basefont and altfont, and the basefont is active.
∗ The terminal emulator is in ASCII 8-bit mode.
∗ The "Keyboard" field in the configuration menu is set to match the keyboard which is actually present.
∗ Display Functions is not enabled.
∗ The left and right margins are set to 0 and the largest column of the scroll buffer.
∗ Tabs are set at column 9 and every 8th column thereafter.
∗ The window has a default icon image resembling a terminal.
∗ The border color is set to the values of environment variables; see wmstart(1).
∗ Fonts used in the border, icon, softkeys, and popup menu are set to the values of environment variables; see wmstart(1).
HARDWARE DEPENDENCIES
Series 500:
HP-15 (2-byte) fonts are not supported on Series 500.
SEE ALSO
DIAGNOSTICS
A return of -1 indicates failure; otherwise 0 is returned. See errno(2) for more information.
Hewlett-Packard Company — May 11, 2021