NAME

wcreate_graphics − create a graphics window type

SYNOPSIS

int wcreate_graphics(wmfd,wname,x,y,w,h,rasterw,rasterh, attributes,border);

int wmfd;
char *wname;
int x,y;
int w,h;
int rasterw,rasterh;
int attributes;
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.)

attributes
specifies whether the window should be non-retained, retained, or IMAGE. A value of 0 specifies non-retained. A value of 1 specifies retained as byte/pixel. A value of 2 specifies retained as bit/pixel. A value of 4 specifies IMAGE which also implies non-retained. IMAGE means that the user area of the window is mapped into the image planes while the border is displayed in the overlay planes.  This value only applies on the HP98730 display system.  All other values are reserved for future use and are currently invalid.

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). 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 attributes, called retained on Series 500, 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