Series 300 and 500 Only

NAME

wcreate_graphics − create a graphics window type

SYNOPSIS

int wcreate_graphics(wmfd,wname,x,y,w,h,rasterw,rasterh,retained,border);
int wmfd;
char *wname;
int x,y;
int w,h;
int rasterw,rasterh;
int retained;
int border;

DESCRIPTION

wmfd
is an integer file descriptor for an opened window manager device interface. 

wname
a pointer to a path name to use as the name of the window’s window type device interface. Also the base name (see basename(1)) is known as the window name. By default, the window name is used as the window label in the window’s border. The window type device interface is used for communicating with the window. wname is also a pointer to a path name that should be use for doing Starbase graphics to the contents window.  This is the device to which gopen is applied. 

x,y the device coordinates for the upper left corner of the drawing area of the window with respect to the upper left corner of the screen. 

w,h the width and height of the screen view into the virtual raster in device coordinates. 

rasterw,rasterh
the width and height of the virtual raster.  (Also the maximum values that w and h can have for the life of the window.)

retained
specifies whether the window should be retained or non-retained.  A zero value specifies non-retained, a one value specifies retained as byte/pixel, and a two value specifies retained as bit/pixel.

border
chooses either thin, normal, or no border for the window. A value of 0 indicates a thin border.  A value of 1 indicates a normal border. A value of 2 indicates no border (null border type), which is supported on only the graphics window type.  If a normal border is chosen, there is a minimum enforced size for the window.  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 graphics window type with default characteristics. 

HARDWARE DEPENDENCIES

Series 500:
For retained, a non-zero value specifies retained, a zero value specifies non-retained. 

Only the thin and normal border types are supported on Series 500; the null border type is not supported. 

SEE ALSO

wcreate_term0(3W),wdestroy(3W). 

DIAGNOSTICS

A return of -1 indicates failure; otherwise 0 is returned.  See errno(2) for more information.

Hewlett-Packard Company  —  May 11, 2021