1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
|
<!--- $Id: ReadMe.html,v 3.6 2005-02-03 11:43:25+01 fred Exp fred $ --->
<HTML>
<HEAD>
<BASE HREF="http://www.thp.Uni-Duisburg.DE/Ygl/ReadMe.html">
<TITLE> Ygl Version 4.2 Description </TITLE>
</HEAD>
<BODY>
<H1> <IMG SRC="Smile.gif" ALIGN=MIDDLE ALT="Logo">
Ygl Version 4.2 Description </H1>
<H4>
<FONT SIZE=4>©</FONT>opyright 1993-2007 by
<A HREF="/~fred/">Fred Hucht (fred(AT)thp.Uni-Duisburg.DE)</A>
</H4>
<P>
<CITE><B>Ygl</B></CITE> is distributed in terms of the GNU LIBRARY
GENERAL PUBLIC LICENSE. Please see the file
<A HREF="LICENSE">LICENSE</A> for further details. You may not
distribute this project without this file (ReadMe.html) and the
LICENSE file included.
<P>
Here you can read the <A HREF="Changes.html">Changes history</A> and
the <A HREF="FAQ.html">Ygl FAQ</A>.
<H2> Description </H2>
<CITE><B>Ygl</B></CITE> emulates <A HREF="#SGI">SGI's GL</A> routines
under X11. It compiles fine under AIX >3.2, HP-UX >7.0, Linux
with XFree/Xorg, SunOS, ConvexOS, Mac A/UX, Mac OS/X and many others,
but needs an ANSI-C compiler (gcc is ok). It was written for two reasons:
<UL>
<LI> On our RS/6000 GT4 hardware, 2D <CITE><B>Ygl</B></CITE> is up to
twenty times faster (<TT>circf()</TT>) than GL (strange, isn't it?...)
<LI> 2D (and 3D using OpenGL) graphics runs on non GL hardware and
even on remote X-Servers.
</UL>
Included are most of the two-dimensional graphics routines, the queue
device routines, the query routines, doublebuffering, RGB mode with
dithering, window attribute routines, FORTRAN bindings and more (see
below).
<P>
3D stuff was added with version 4.0 using <A HREF="http://www.OpenGL.org">OpenGL</A> calls.
<P>
Since Version 2.8, all <CITE><B>Ygl</B></CITE> functions do have a
<A HREF="/cgi-bin/Man.pl?fortran">FORTRAN</A> interface. The
FORTRAN versions of all functions have an underscore appended, so the
FORTRAN compiler must append a '_' to all function names.
<A HREF="/cgi-bin/man.pl?f2c">f2c</A> does this,
<A HREF="/cgi-bin/Man.pl?xlf">xlf</A>
(under AIX 3.2) requires the option <TT>-qextname</TT>. See
<A HREF="smile_f77.f">smile_f77.f</A> for an example program. Set
<TT>FortranBindings</TT> to <TT>0</TT> in Imakefile or change
Makefile.std if you don't want these bindings. FORTRAN bindings are
not tested because I have no programs.f to test. If you find bugs,
feel free to report them to me.
<P>
You can always find the latest version of <CITE><B>Ygl</B></CITE> in
the directory
<A HREF="ftp://ftp.thp.Uni-Duisburg.de/pub/source/X11/">ftp.thp.Uni-Duisburg.de/pub/source/X11/</A>.
<P>
Note that <A HREF="http://www.perl.org">perl</A>,
<A HREF="http://www.python.org">python</A>
and <A HREF="http://www.tcl.tk/">tcl</A> bindings
for Ygl are available
<A HREF="http://www.aero.iitm.ernet.in/~prabhu/software/python.html">here</A>
thanks to Prabhu Ramachandran.
<H2> Details </H2>
<H3> Environment variables: </H3>
Several environment variables are referenced in the library to control
the behavior of <CITE><B>Ygl</B></CITE>:
<UL>
<LI> The environment variable <B>YGL_PRIVATECOLORMAP</B> or
<B>YGL_PCM</B> can be set to 1 to force
<CITE><B>Ygl</B></CITE> to use a private colormap. While GL
always uses a private colormap, <CITE><B>Ygl</B></CITE> uses
the global map by default to avoid technicolor effects on
X-Servers not capable of more than one colormap at a
time. <B>Note</B> that you can only redefine the color of
already drawn objects when you use a private colormap.
<LI> The environment variable <B>YGL_FLUSHTIME</B> or <B>YGL_FT</B>
(default value: 0.1) can be used to adjust the time in seconds
between flushes of the graphics pipeline. It can be set to 0
to disable the automatic update via interval timer. Setting
YGL_FLUSHTIME to -1 will put the X-Server into synchronous
mode (see <A HREF="/cgi-bin/man.pl?XSynchronize">XSynchronize</A>).
This mode seems to be veeeryyy slooow, but is good for
debugging...
<LI> The environment variable <B>YGL_BACKINGSTORE</B> or
<B>YGL_BS</B> can be set to 1 to enable BackingStore support
for all <CITE><B>Ygl</B></CITE> windows. With BackingStore,
the X-Server remembers the contents of a window when it gets
obscured or iconified. You must start your X-Server with the
option "-bs" ("+bs" on some systems) to use this feature.
<LI> The environment variables <B>YGL_CMAPVISUAL</B> or
<B>YGL_CV</B> and <B>YGL_RGBVISUAL</B> or <B>YGL_RV</B>
control the selection of visuals for cmapmode and RGBmode. Set
these variables to the visual id of the desired visual as
returned by xdpyinfo (both hex and decimal is ok). Setting one
of these variables to -1 forces <CITE><B>Ygl</B></CITE> to use
the default visual of the screen instead of the best visual.
<LI> The environment variable <B>YGL_SINGLEGC</B> or <B>YGL_GC</B>
can be set to 1 to force <CITE><B>Ygl</B></CITE> to use a
single graphics context for colormap windows. Per default
<CITE><B>Ygl</B></CITE> uses one GC for each color, i.e. 256
GCs for a 8 bit colormap window, because this speeds up
drawing with many color changes by a factor of 2 or so on many
systems. Using a single GC may be faster if you use many
mapcolor calls as in colormap animation. <B>Note</B> that if
the used colormap visual has more than 256 colors YGL_GC
defaults to 1.
<LI> The environment variable <B>YGL_PARENTWID</B> or
<B>YGL_PWID</B> controls the parent window of
<CITE><B>Ygl</B></CITE>. Per default the root window of the
default screen of the given display is the parent window of
windows opened with winopen(). Set this variable to the window
id of the desired window as returned by xwininfo (both hex and
decimal is ok).
<LI> <A NAME="dither"></A>The environment variable
<B>YGL_DITHERSIZE</B> or <B>YGL_DSZ</B> controls dithering in
RGB mode.With this variable you can specify the size of the
dither matrix. The default value is 4, leading to a 4x4 dither
matrix. Valid values range from 0 to 6. On a normal 8 bit
TrueColor visual ({3,3,2} bits {red,green,blue}) you obtain
113x113x49 = 625681 different "colors" with YGL_DSZ=4, leading
to an effective screen depth of approx. 19 bits. The other
values and the effective screendepth are:
<PRE>
| 8 bit (3-3-2) | 12 bit (4-4-4) | 16 bit (6-5-5)
YGL_DSZ| # colors (bits) | # colors (bits) | # colors (bits)
-------------------------------------------------------------
0,1 | 256 ( 8 ) | 4096 (12 ) | 65536 (16 )
2 | 10933 (13.4) | 226981 (17.8) | 3953125 (21.9)
3 | 114688 (16.8) | 2515456 (21.3) | 44531200 (25.4)
4 | 625681 (19.3) | 13997521 (23.7) | 249232081 (27.9)
5 | 2354176 (21.2) | 53157376 (25.7) | 949029376 (29.8)
6 | 6976981 (22.7) |158340421 (27.2) |2831006341 (31.4)
</PRE>
<B>Note</B> that dithering costs speed. You may set YGL_DSZ=0
to disable dithering. If you are lucky and have a 24 bit
TrueColor visual, YGL_DSZ is automatically set to zero.
</UL>
<H3> Doublebuffering: </H3>
<CITE><B>Ygl</B></CITE> supports doublebuffering via the XServer
extensions "DOUBLE-BUFFER" (new in X11R6.1) and "Multi-Buffering". The
related routines are <TT>doublebuffer()</TT>, <TT>swapbuffer()</TT>
and <TT>singlebuffer()</TT>.
<P>
<B>Notes:</B>
<DL>
<DT>OpenGL:<DD>
You can use the routine <TT>gsync()</TT> to wait for the next
vertical retrace. If you use doublebuffering, it might help to set
the environment variable <TT>__GL_SYNC_TO_VBLANK</TT> to 1 to swap
buffers at a vertical retrace.
<DT>X11R6.1:<DD>
If you have X11R6.1 or later, set <TT>DoubleBuffer</TT> to 1 in
Imakefile.
<DT>AIX < 3.2.5:<DD>
The extension "Multi-Buffering" is new in X11R5 and is included in
the lpp X11dev.src under AIX. To use doublebuffering you have to
link the "Multi-Buffering" extension into your X-Server (under AIX,
see /usr/lpp/X11/Xamples/README, "Linking the Sample Extensions
into the Server").
<DT>AIX >= 3.2.5:<DD>
You don't need to recompile the X-Server anymore to use
doublebuffering under AIX 3.2.5 (AIXWindows 1.2.3). You simply have
to add the option "-x mbx" to the X-Servers command line on
startup.
<DT>AIX >= 4.1:<DD>
You need the LPP X11.adt.ext to compile <CITE><B>Ygl</B></CITE>
with doublebuffering enabled.
</DL>
<H3> RGB mode: </H3>
<CITE><B>Ygl</B></CITE> can run in a per window RGB mode, if the
X-Server has a TrueColor or DirectColor
visual. <CITE><B>Ygl</B></CITE> will always select the appropiate
visual for the desired mode, independent of the default visual, i.e.:
<PRE>
Colormap mode <-> PseudoColor, StaticColor,
GrayScale, StaticGray,
TrueColor or DirectColor visual
RGB mode <-> TrueColor or DirectColor visual
</PRE>
A RGB mode window is a child of the initially created colormap mode
window. <CITE><B>Ygl</B></CITE> uses the property
<TT>WM_COLORMAP_WINDOWS</TT> to tell the window manager, which
colormaps are to be installed. To toggle the colormaps when a RGB
window is subwindow of a colormap window, use the window manager
function <TT>f.colormap</TT> in <A HREF="/cgi-bin/man.pl?twm.n">twm</A>
or <TT>f.next_cmap</TT> in <A HREF="/cgi-bin/Man.pl?mwm">mwm</A>.
<CITE><B>Ygl</B></CITE> will automatically dither all output if the
X-Server doesn't support 24 bits. See the section
<A HREF="#dither">environment variables</A> for details.
<H3>Multiple Expose events (REDRAW) in qread:</H3>
<CITE><B>Ygl</B></CITE> ignores all Expose events that have
e.xexpose.count != 0 (see
<A HREF="/cgi-bin/man.pl?XExposeEvent">XExposeEvent</A>(3X11)) AND all
Expose events when another Expose event for the same window is in the
Event queue. This procedure minimizes unnessesary
redraws. Nevertheless, a REDRAW event is generated when a window is
moved even when the contents of the window does not have to be
redrawn. This is to be compatible with SGI's GL, where no extra event
for window moves exist :-(
<H3>Automatic flushing of the graphics pipeline:</H3>
The process virtual interval timer (see
<A HREF="/cgi-bin/Man.pl?setitimer">setitimer</A>(3))
is used to flush the graphics pipeline every 0.1 seconds. This
interval is adjustable (see above). The system functions sleep() and
usleep() are covered by the library to flush the pipeline, too. This
had to be done because the GL hardware flushes the pipeline
automatically on every vertical retrace and has no command to
flush. <P>
<B>Note</B> that sleep() and usleep() always return 0. <P>
You can use "sleep(0)" to flush the graphics pipeline explicitly.
If you have problems with sleep() and usleep(), undefine COVERSLEEP in
header.h.
<H2> Supported routines </H2>
Finally a list of supported GL routines is included. For a detailed
description of the routines see the GL manuals in the Info-Explorer
(under AIX) or click at the command below.
<H3>Window related routines:</H3>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/minsize.htm">minsize</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/maxsize.htm">maxsize</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/prefsize.htm">prefsize</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/prefposition.htm">prefposition</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/stepunit.htm">stepunit</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/keepaspect.htm">keepaspect</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winopen.htm">winopen</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winclose.htm">winclose</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/gconfig.htm">gconfig</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/gexit.htm">gexit</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/wintitle.htm">wintitle</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winset.htm">winset</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winget.htm">winget</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getsize.htm">getsize</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getorigin.htm">getorigin</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getXdpy.htm">getXdpy</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getXdpy.htm">getXwid</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getbutton.htm">getbutton</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getvaluator.htm">getvaluator</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winmove.htm">winmove</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winposition.htm">winposition</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/ginit.htm">ginit</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winpop.htm">winpop</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winpush.htm">winpush</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/windepth.htm">windepth</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/swinopen.htm">swinopen</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winconstraints.htm">winconstraints</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/noport.htm">noport</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/noborder.htm">noborder</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winX.htm">winX</A>.
<BR><B>Note:</B>
The routine <TT>winX(Display *dpy, Window win)</TT> will
ignore the first argument <TT>dpy</TT>. <CITE><B>Ygl</B></CITE>
always uses the XServer specified in the environment variable DISPLAY.
<H3>Color related routines:</H3>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/RGBmode.htm">RGBmode</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/RGBcolor.htm">RGBcolor</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/cmode.htm">cmode</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/color.htm">color</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/mapcolor.htm">mapcolor</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getplanes.htm">getplanes</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getmcolor.htm">getmcolor</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getmcolors.htm">getmcolors</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getcolor.htm">getcolor</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/gRGBcolor.htm">gRGBcolor</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/c.htm">c3s, c3i, c3f</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/cpack.htm">cpack</A>.
<H3>Device related routines:</H3>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/tie.htm">tie</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/noise.htm">noise</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/isqueued.htm">isqueued</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/qdevice.htm">qdevice</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/unqdevice.htm">unqdevice</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/qreset.htm">qreset</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/qtest.htm">qtest</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/qread.htm">qread</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/qenter.htm">qenter</A>,
<BR>
<B>Notes:</B>
<UL>
<LI> Currently supported devices are:
REDRAW, KEYBD, INPUTCHANGE, LEFTMOUSE, MIDDLEMOUSE, RIGHTMOUSE
(MENUBUTTON), MOUSEX, MOUSEY, WINQUIT, and all individual keys as
F1KEY, ESCKEY, UPARROWKEY, and so on.
<LI> qenter does only support the REDRAW device.
</UL>
<H3>Menu routines:</H3>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/defpup.htm">defpup</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/newpup.htm">newpup</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/addtopup.htm">addtopup</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/dopup.htm">dopup</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/freepup.htm">freepup</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/setpup.htm">setpup</A>.
<BR><B>Note:</B>
The routines <TT>addpup()</TT> and <TT>defpup()</TT>
accept an additional modifier '%M'. If you define a submenu anchor
with '%M' instead of '%m', <CITE><B>Ygl</B></CITE> calls the function
defined with '%F' with the two arguments <TT>menu-return</TT> and
<TT>submenu-return</TT>, i.e.:
<PRE>
int callback(Int32 m, Int32 s) {
sleep(s);
switch(m) {
case 1: explode(); break;
case 2: implode(); break;
}
return(m << 8 + s);
}
main() {
...
sub = defpup("Seconds%t|1|2|3|4|5");
menu = defpup("Menu%t%F|Explode%M|Implode%M", callback, sub, sub);
...
}
</PRE>
See <TT>examples/popup.c</TT> for details.
<H3>Font routines:</H3>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/loadXfont.htm">loadXfont</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/font.htm">font</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getfont.htm">getfont</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getfontencoding.htm">getfontencoding</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getheight.htm">getheight</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getdescender.htm">getdescender</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/strwidth.htm">strwidth</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/charstr.htm">charstr</A>.
<H3>Doublebuffer routines:</H3>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/singlebuffer.htm">singlebuffer</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/doublebuffer.htm">doublebuffer</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/swapbuffers.htm">swapbuffers</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/frontbuffer.htm">frontbuffer</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/backbuffer.htm">backbuffer</A>.
<H3>Misc routines:</H3>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/winpop.htm">gflush</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/gsync.htm">gsync</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/gversion.htm">gversion</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rectzoom.htm">rectzoom</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rectread.htm">lrectread</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rectwrite.htm">lrectwrite</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rectcopy.htm">rectcopy</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/readsource.htm">readsource</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rectread.htm">rectread</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rectwrite.htm">rectwrite</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/readpixels.htm">readpixels</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/writepixels.htm">writepixels</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/readRGB.htm">readRGB</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/writeRGB.htm">writeRGB</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/blendfunction.htm">blendfunction</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/linewidth.htm">linewidth</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getlwidth.htm">getlwidth</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/deflinestyle.htm">deflinestyle</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/setlinestyle.htm">setlinestyle</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getlstyle.htm">getlstyle</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/lsrepeat.htm">lsrepeat</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getlsrepeat.htm">getlsrepeat</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/logicop.htm">logicop</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getdisplaymode.htm">getdisplaymode</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getgdesc.htm">getgdesc</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/setbell.htm">setbell</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/ringbell.htm">ringbell</A>.
<H3>Coordinate transformation routines:</H3>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/ortho.htm">ortho2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/viewport.htm">viewport</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getviewport.htm">getviewport</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/reshapeviewport.htm">reshapeviewport</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pushviewport.htm">pushviewport</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/popviewport.htm">popviewport</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getmatrix.htm">getmatrix</A>.
<H3>Drawing routines:</H3>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/clear.htm"> clear</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pnt.htm"> pnt2s, pnt2i, pnt2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/move.htm"> move2s, move2i, move2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rmv.htm"> rmv2s, rmv2i, rmv2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/draw.htm"> draw2s, draw2i, draw2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rdr.htm"> rdr2s, rdr2i, rdr2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/arc.htm"> arcs, arci, arc</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/arcf.htm"> arcfs, arcfi, arcf</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/circ.htm"> circs, circi, circ</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/circf.htm"> circfs, circfi, circf</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rect.htm"> rects, recti, rect</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rectf.htm"> rectfs, rectfi, rectf</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/sbox.htm"> sboxs, sboxi, sbox</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/sboxf.htm"> sboxfs, sboxfi, sboxf</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/concave.htm">concave</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pmv.htm"> pmv2s, pmv2i, pmv2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rpmv.htm"> rpmv2s, rpmv2i, rpmv2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pdr.htm"> pdr2s, pdr2i, pdr2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rpdr.htm"> rpdr2s, rpdr2i, rpdr2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pclos.htm"> pclos</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/poly.htm"> poly2s, poly2i, poly2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/polf.htm"> polf2s, polf2i, polf2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/bgnpoint.htm"> bgnpoint, endpoint</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/bgnline.htm"> bgnline, endline</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/bgnclosedline.htm">bgnclosedline, endclosedline</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/bgnpolygon.htm"> bgnpolygon, endpolygon</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/v.htm"> v2s, v2i, v2f, v2d</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/cmov.htm"> cmov2s, cmov2i, cmov2</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getcpos.htm">getcpos</A>.
<BR><B>Note:</B>
It's not possible to change drawing attributes (color, ...)
in the middle of a vertex pipeline in <CITE><B>Ygl</B></CITE>.
This affects the routines
<TT>{bgn|end}{point|line|closedline|polygon}()</TT> and
<TT>pdr(), rpdr()</TT>.
<H3>3D routines</H3>
<H4>Drawing:</H4>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/c.htm"> c4s, c4i, c4f</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/cmov.htm"> cmovs, cmovi, cmov</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pnt.htm"> pnts, pnti, pnt</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/move.htm"> moves, movei, move</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/draw.htm"> draws, drawi, draw</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rmv.htm"> rmvs, rmvi, rmv</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rdr.htm"> rdrs, rdri, rdr</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pmv.htm"> pmvs, pmvi, pmv</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rpmv.htm"> rpmvs, rpmvi, rpmv</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pdr.htm"> pdrs, pdri, pdr</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rpdr.htm"> rpdrs, rpdri, rpdr</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/polf.htm"> polfs, polfi, polf</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/v.htm"> v3s, v3i, v3f, v3d</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/v.htm"> v4s, v4i, v4f, v4d</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/swaptmesh.htm">swaptmesh</A>.
<H4>Coordinate Systems:</H4>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/ortho.htm">ortho</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/lookat.htm">lookat</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/window.htm">window</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/perspective.htm">perspective</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/polarview.htm">polarview</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rot.htm">rot</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/rotate.htm">rotate</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/scale.htm">scale</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/translate.htm">translate</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/loadmatrix.htm">loadmatrix</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/multmatrix.htm">multmatrix</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pushmatrix.htm">pushmatrix</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/popmatrix.htm">popmatrix</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getmmode.htm">getmmode</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/mmode.htm">mmode</A>.
<H4>Polygon specs:</H4>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/shademodel.htm">shademodel</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/n3f.htm">n3f</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/normal.htm">normal</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/backface.htm">backface</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/frontface.htm">frontface</A>.
<H4>z-Buffer:</H4>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/zbuffer.htm">zbuffer</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/zclear.htm">zclear</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/zdraw.htm">zdraw</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/zfunction.htm">zfunction</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/czclear.htm">czclear</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/depthcue.htm">depthcue</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/lRGBrange.htm">lRGBrange</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/lsetdepth.htm">lsetdepth</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/lshaderange.htm">lshaderange</A>.
<H4>Display lists:</H4>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/genobj.htm">genobj</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/isobj.htm">isobj</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/makeobj.htm">makeobj</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/getopenobj.htm">getopenobj</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/closeobj.htm">closeobj</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/callobj.htm">callobj</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/delobj.htm">delobj</A>.
<H4>Misc:</H4>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/lmbind.htm">lmbind</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/lmcolor.htm">lmcolor</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/lmdef.htm">lmdef</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/RGBwritemask.htm">RGBwritemask</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pushattributes.htm">pushattributes</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/popattributes.htm">popattributes</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/scrmask.htm">scrmask</A>.
<H4>Picking/Names:</H4>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pick.htm">pick</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/endpick.htm">endpick</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/picksize.htm">picksize</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/initnames.htm">initnames</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/loadname.htm">loadname</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/pushname.htm">pushname</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/popname.htm">popname</A>.
<H4>NOPs:</H4>
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/foreground.htm">foreground</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/drawmode.htm">drawmode</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/iconsize.htm">iconsize</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/overlay.htm">overlay</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/fullscrn.htm">fullscrn</A>,
<A HREF="http://inetsd01.boulder.ibm.com/pseries/en_US/infocenter/base/43_docs/libs/gl32tref/endfullscrn.htm">endfullscrn</A>.
<H3>Routines not in SGI's GL:</H3>
The following routines are added to standard GL:
<UL>
<LI><TT>GC getXgc(void) </TT><BR>
return current graphics context. You can for example use it to
draw lines xor'ed with the background:
<PRE>
#include <X11/X.h>
...
XSetFunction(getXdpy(), getXgc(), GXxor);
</PRE>
<B>Note:</B>
Since version 3.1, getXgc() is not supported anymore, as you
can use the routine logicop() to set the drawing function.
<P>
<LI><TT>Window getXdid() </TT><BR>
return window id of the current drawable. This id differs from
the window id returned by <TT>getXwid()</TT> when in RGB mode
or when using doublebuffering.<P>
<LI><TT>Int32 crectread(Screencoord x1, Screencoord y1,
Screencoord x2, Screencoord y2, Uint8 *data) </TT><BR>
read screen data to unsigned char array <TT>data</TT><P>
<LI><TT>void crectwrite(Screencoord x1, Screencoord y1,
Screencoord x2, Screencoord y2, Uint8 *data) </TT><BR>
write unsigned char array <TT>data</TT> to screen<P>
<LI><TT>void arcxs(Scoord x,Scoord y,Scoord rx,Scoord ry,Angle s,Angle e) <BR>
void arcxi(Icoord x,Icoord y,Icoord rx,Icoord ry,Angle s,Angle e) <BR>
void arcx(Coord x,Coord y,Coord rx,Coord ry,Angle s,Angle e) </TT><BR>
draw ellipses<P>
<LI><TT>void arcxfs(Scoord x,Scoord y,Scoord rx,Scoord ry,Angle s,Angle e) <BR>
void arcxfi(Icoord x,Icoord y,Icoord rx,Icoord ry,Angle s,Angle e) <BR>
void arcxf(Coord x,Coord y,Coord rx,Coord ry,Angle s,Angle e) </TT><BR>
draw filled ellipses<P>
<LI><TT>int gl2ppm(char *filename) </TT><BR>
write out active <CITE><B>Ygl</B></CITE> window to
<A HREF="/cgi-bin/man.pl?ppm.5">portable pixmap file</A>
<TT>'filename'</TT>. When <TT>filename[0] == '|'</TT>, uses
<TT>popen()</TT> instead of <TT>fopen()</TT>. <B>Note</B> that
<TT>gl2ppm()</TT> can also be used in a GL application. Just
add <TT>gl2ppm.o</TT> to the list of object files.
<P>
</UL>
<H2> Acknowledgements </H2>
The author would like to thank
Michael Staats (michael(AT)thp.Uni-Duisburg.DE) and
Ralf Meyer (ralf(AT)thp.Uni-Duisburg.DE) for some hints and tips.
<P>
<A NAME="SGI"></A> GL is a registered trademark of
<A HREF="http://www.sgi.com/">Silicon Graphics, Inc.</A>
</BODY>
</HTML>
|
