winope(3G)
winope - creates a graphics window
As shipped in IRIX 6.5. First release of IRIX 6.5.
NAME winope - creates a graphics window FORTRAN 77 SPECIFICATION integer*4 function winope(name, length) character*(*) name integer*4 length PARAMETERS name expects the window title that is displayed on the left hand side of the title bar for the window. If you do not want a title, pass a zero-length string. length expects the length of the string in name. FUNCTION RETURN VALUE The returned value for this function is the graphics server and window identifier for the window just created. Use this value to identify the graphics window to other windowing functions. Only the lower 16 bits are significant, since a graphics window identifier is the value portion of a REDRAW event queue entry. If no additional windows are available, this function returns -1. DESCRIPTION winope creates a graphics window as defined by the current values of the window constraints on the currently selected display. This new window becomes the current window. If a call to foregr did not precede the winope call, it forks and runs the calling process in the background. The display on which the window is opened is determined by the currently selected host, server, and screen. The host defaults to the local client machine. You may change the host by calling dglope beforehand, or by calling winset with the identifier of an open window on another host. If neither of these calls precedes, the value of the environment variables DISPLAY, DGLSERVER, and REMOTEHOST are checked in that order. The current server defaults to 0. This too may be changed by a preceding winset; otherwise it may set by the environment variables above. The current screen defaults to 0. You can change it using the routine scrnse. Except for size and location, the graphics host maintains default values for the constraints on a window. You can change these default window constraints if you call the routines minsiz, maxsiz, keepas, prefsi, prefpo, stepun, fudge, iconsi, nobord, noport, imakeb, and foregr before you call winope. If a window's size and location (or both) are left unconstrained, the system allows the user to place and size the window. winope sets the graphics state of the new window (this includes window constraints) to its default values; there are listed in the table below. It also queues the pseudo devices INPTCH and REDRAW. __________________________________________ State | Default Value _________________________________________ acsize 0 afunct AFALWA backbu .FALSE. backfa .FALSE. blendf BFONE, BFZERO buffer mode single character position undefined clippl CPOFF color 0 color mode single color map (cmode and onemap) concav .FALSE. curvep undefined depth range Zmin, Zmax depthc .FALSE. drawmo NORMDR feedback mode off fogver FGOFF font 0 frontb .TRUE. frontf .FALSE. full screen mode off _________________________________________ | | __________________________________________________ State | Default Value _________________________________________________ glcomp GLCOLD 1 GLCZRA 1 (B and G models) 0 (other models) graphics position undefined linesm SMLOFF linest 0 (solid) linewi 1 lmcolo LMCCOL lmdef LIGHTn 0 LMODEL 0 MATERI 0 logico LOSRC lsrepe 1 mapcol no entries changed matrix ModelView undefined Projection undefined Single ortho2 matching window size Texture undefined mmode MSINGL name stack empty nmode NAUTO normal vector undefined overla 2 patchb undefined patchc undefined patchp undefined pattern 0 (solid) pick mode off picksi 10x10 pixmod standard pntsmo SMPOFF polymo PYMFIL _________________________________________________ | | _______________________________________________ State | Default Value ______________________________________________ polysm PYSMOF readso SRCAUT rectzo 1.0, 1.0 RGB color all components 0 (when RGB mode is entered) RGB shade range undefined RGB writemask all components 0xFF (when RGB mode is entered) scrbox SBRESE scrmas size of window scrsub SSOFF select mode off shade range 0, 7, Zmin, Zmax shadem GOURAU stenci disabled stensi 0 swrite all planes enabled tevbin 0 (off) texbin 0 (off) texgen TGOFF underl 0 viewpo size of window writem all planes enabled zbuffe .FALSE. zdraw .FALSE. zfunct ZFLEQU zsourc ZSRCDE zwrite all planes enabled ______________________________________________ | | Notes o Font 0 is a Helvetica-like font. o Zmin and Zmax are the minimum and maximum values that you can store in the z-buffer. These depend on the graphics hardware and are returned by getgde(GDZMIN) and getgde(GDZMAX). o On IRIS-4D B and G models, winope also sets lsback(.FALSE.) and resetl(.TRUE.). SEE ALSO dglope, foregr, fudge, iconsi, imakeb, keepas, minsiz, maxsiz, nobord, noport, prefsi, prefpo, scrnse, stepun, winclo, winset NOTES This routine is available only in immediate mode. When creating a window on a screen for which there is no window manage- ment, (i.e., on a screen for which the getgde inquiry GDSTYP returns GDSTNW), always preface the winope call with call prefpo(0, getgde(GDXPMA)-1, 0, getgde(GDYPMA)-1) This will guarantee compatible behavior should the screen have window management in the future. BUGS On the IRIS-4D GT and GTX models only, a window region which extends beyond 2048 in the horizontal dimension is wrapped around and mapped to a corresponding window region starting at 512. The bug is visible only if the window covers both regions.