WINDOW(3W)
NAME
window − summary of window library routines
DISCUSSION
The window library, /usr/lib/libwindow.a, contains routines that do window functions normally done by commands, for example, moving, selecting, or changing the size of a window. Window library routines also allow programs to do functions not attainable through commands, for example, event detection, user-defined icons, or changing graphics window softkeys.
Programs that call window library routines must be sure to link the window library (−lwindow).
The /usr/include/window.h header file contains many useful type and constant definitions used by window library routines. Programs should use these definitions when calling window library routines.
Window library routines are summarized below. For more information on each routine, consult its reference page.
Window Management Routines
wcreate_graphics(3W) Create a graphics window type device interface.
wcreate_term0(3W) Create a Term0 window type device interface.
wdestroy(3W) Destroy a window.
wdfltpos(3W) Return the default location for the next window or icon to create; also return the next default name.
wgetname(3W) Return the path name of a window’s window type device interface.
wgetscreen(3W) Get information (resolution, etc) about the current display screen device.
wget_see_thru(3W) Get the see_thru color index.
winit(3W) Initialize a communication path with the window manager or a window type device interface.
wminquire(3W) Return the value of a window system environment variable.
wmkill(3W) Kill the window manager and the window system.
wmpathmake(3W) Build a path name from a window system environment variable and a user-supplied suffix.
wmrepaint(3W) Repaint all windows and the desk top.
wset_see_thru(3W) Set the see_thru color index.
wshuffle(3W) Shuffle windows up or down through the display stack.
wterminate(3W) Release window manager or window type resources allocated by winit(3W).
Window Manipulation Routines
wautodestroy(3W) Set or determine a window’s autodestroy status; used with wrecover(3W).
wautoselect(3W) Set or determine a Term0 window’s autoselect status.
wautotop(3W) Set or determine a Term0 window’s autotop status.
wbanner(3W) Set or determine a window’s border type (thin, normal, or no border).
wbottom(3W) Display a window as the bottom window in the display stack, or determine if a window is bottom.
wconceal(3W) Conceal a window, or determine if a window is concealed.
wgetbcolor(3W) Get a window’s border foreground and background colors.
wgetbcoords(3W) Get coordinate information (x,y pixel location, and pixel width and height) for a window’s border.
wgetcoords(3W) Get coordinate information (x,y pixel location, pixel width and height, pan position, raster width and height) for a window’s user (contents) area.
wmove(3W) Change a window’s x,y pixel location.
wpan(3W) Change the view into a graphics window’s raster.
wpauseoutput(3W) Pause or resume output to a Term0 window.
wrecover(3W) Set or determine a window’s recover state; used with wautodestroy(3W).
wselect(3W) Set or determine a window’s selected status; i.e., whether the keyboard is attached to a window.
wsetbcolor(3W) Set the foreground and background colors of a window’s border.
wsetlabel(3W) Change a window’s label, displayed in the window’s border.
wsize(3W) Change a window’s size.
wtop(3W) Display a window as the top window in the display stack, or determine if a window is top.
Icon Manipulation Routines
wgeticonpos(3W) Return an icon’s x,y pixel location.
wiconic(3W) Set or determine whether a window is displayed as an icon or normal.
wseticon(3W) Change a window’s icon to the representation given in an icon file.
wseticonpos(3W) Set a the x,y location of a window’s icon.
Event Detection Routines
weventclear(3W) Clear event(s) for a window.
weventpoll(3W) Poll for event(s) that may have occurred in a window.
wgetsigmask(3W) Return the current event mask for a window.
wsetsigmask(3W) Set the event mask for a window.
Locator and Echo Routines
wgetecho(3W) Get information about a window’s echo (pointer).
wgetlocator(3W) Return the locator’s current x,y pixel location and a mask representing which locator buttons are currently pressed.
wgetrasterecho(3W) Return information about the echo’s image for a given window.
wget_hw_sprite_color(3W)
Get the color indexes used for the sprite when using the hardware support for sprites.
wscrn_sprite_mode(3W) Set or determine whether a window is in full-screen sprite control mode.
wsetecho(3W) Set a window’s echo to a specific type; used with wsetrasterecho(3W) when creating user-defined echoes.
wsetlocator(3W) Set the locator’s position, relative to a window.
wsetrasterecho(3W) Set a user-defined echo type for a window; used with wsetecho(3W).
wset_hw_sprite_color(3W)
Set the color indexes used for displaying the sprite when using hardware support.
Graphics Window Scroll Bar Routines
wscroll_get(3W) Get information about a graphics window’s scroll bars.
wscroll_set(3W) Set information about a graphics window’s scroll bars.
Graphics Window Hotspot Rectangle Routines
whotspot_create(3W) Create a hotspot rectangle in a graphics window.
whotspot_delete(3W) Delete a hotspot rectangle from a graphics window.
whotspot_get(3W) Return information about a specific hotspot rectangle in a given graphics window.
whotspot_set(3W) Set information for a specific hotspot rectangle in a given graphics window.
User-Defined Menu Routines
wmenu_activate(3W) Activate a user-defined pop-up menu for a window.
wmenu_create(3W) Create a pop-up menu for a window.
wmenu_delete(3W) Delete (remove) a pop-up menu from a window.
wmenu_eventread(3W) Determine which item was selected from a pop-up menu in a window.
wmenu_item(3W) Specify or change an item in a window’s pop-up menu.
Graphics Window Input Routines
wgskbd(3W) Set or determine the graphics window input mode (Mode 0, 1, or 2).
winput_conf(3W) Set or determine the configuration of a graphics window’s input channel.
winput_getroute(3W) Return the path name of a window to which a window’s input is routed.
winput_read(3W) Read event_code packets (defined in window.h) from a graphics window.
winput_setroute(3W) Reroute a graphics window’s input to a different graphics window.
winput_widpath(3W) Return the path name of a graphics window, given the window’s window id.
Graphics Window Softkey Routines
wsfk_mode(3W) Turn graphics window softkeys on or off.
wsfk_prog(3W) Define the softkeys for a graphics window.
Term0 Font Management Routines
altfont_term0(3W) Set or determine the current Term0 alternate font.
basefont_term0(3W) Set or determine the current Term0 base font.
fontgetid_term0(3W) Return the font ID of a Term0 font, if the font is currently loaded.
fontgetname_term0(3W) Return the path name of a font file for a loaded Term0 font.
fontload_term0(3W) Load a Term0 font.
fontreplaceall_term0(3W) Replace the current base and alternate font with new base and alternate fonts.
fontsize_term0(3W) Return the pixel width and height of all loaded fonts. (All loaded fonts must be the same size.)
fontswap_term0(3W) Replace a loaded Term0 font with a font that is currently not loaded.
fromxy_term0(3W) Convert x,y pixel coordinates to column and row coordinates, based on the current font size.
toxy_term0(3W) Convert column and row coordinates to x,y pixel coordinates, based on the current font size.
EXAMPLES
The following example compiles a program, named winprog.c, that calls window library routines.
cc winprog.c −lwindow
SEE ALSO
Hewlett-Packard Company — May 11, 2021