/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Python 1.1 / Doc / libgl.tex

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 67 6c 7d 7d 0d | 5c 62 69 6d 6f 64 69 6e |de{gl}}.|\bimodin|
|00000030| 64 65 78 7b 67 6c 7d 0d | 0d 54 68 69 73 20 6d 6f |dex{gl}.|.This mo|
|00000040| 64 75 6c 65 20 70 72 6f | 76 69 64 65 73 20 61 63 |dule pro|vides ac|
|00000050| 63 65 73 73 20 74 6f 20 | 74 68 65 20 53 69 6c 69 |cess to |the Sili|
|00000060| 63 6f 6e 20 47 72 61 70 | 68 69 63 73 0d 7b 5c 65 |con Grap|hics.{\e|
|00000070| 6d 20 47 72 61 70 68 69 | 63 73 20 4c 69 62 72 61 |m Graphi|cs Libra|
|00000080| 72 79 7d 2e 0d 49 74 20 | 69 73 20 61 76 61 69 6c |ry}..It |is avail|
|00000090| 61 62 6c 65 20 6f 6e 6c | 79 20 6f 6e 20 53 69 6c |able onl|y on Sil|
|000000a0| 69 63 6f 6e 20 47 72 61 | 70 68 69 63 73 20 6d 61 |icon Gra|phics ma|
|000000b0| 63 68 69 6e 65 73 2e 0d | 0d 5c 73 74 72 6f 6e 67 |chines..|.\strong|
|000000c0| 7b 57 61 72 6e 69 6e 67 | 3a 7d 0d 53 6f 6d 65 20 |{Warning|:}.Some |
|000000d0| 69 6c 6c 65 67 61 6c 20 | 63 61 6c 6c 73 20 74 6f |illegal |calls to|
|000000e0| 20 74 68 65 20 47 4c 20 | 6c 69 62 72 61 72 79 20 | the GL |library |
|000000f0| 63 61 75 73 65 20 74 68 | 65 20 50 79 74 68 6f 6e |cause th|e Python|
|00000100| 20 69 6e 74 65 72 70 72 | 65 74 65 72 20 74 6f 20 | interpr|eter to |
|00000110| 64 75 6d 70 0d 63 6f 72 | 65 2e 0d 49 6e 20 70 61 |dump.cor|e..In pa|
|00000120| 72 74 69 63 75 6c 61 72 | 2c 20 74 68 65 20 75 73 |rticular|, the us|
|00000130| 65 20 6f 66 20 6d 6f 73 | 74 20 47 4c 20 63 61 6c |e of mos|t GL cal|
|00000140| 6c 73 20 69 73 20 75 6e | 73 61 66 65 20 62 65 66 |ls is un|safe bef|
|00000150| 6f 72 65 20 74 68 65 20 | 66 69 72 73 74 0d 77 69 |ore the |first.wi|
|00000160| 6e 64 6f 77 20 69 73 20 | 6f 70 65 6e 65 64 2e 0d |ndow is |opened..|
|00000170| 0d 54 68 65 20 6d 6f 64 | 75 6c 65 20 69 73 20 74 |.The mod|ule is t|
|00000180| 6f 6f 20 6c 61 72 67 65 | 20 74 6f 20 64 6f 63 75 |oo large| to docu|
|00000190| 6d 65 6e 74 20 68 65 72 | 65 20 69 6e 20 69 74 73 |ment her|e in its|
|000001a0| 20 65 6e 74 69 72 65 74 | 79 2c 20 62 75 74 20 74 | entiret|y, but t|
|000001b0| 68 65 0d 66 6f 6c 6c 6f | 77 69 6e 67 20 73 68 6f |he.follo|wing sho|
|000001c0| 75 6c 64 20 68 65 6c 70 | 20 79 6f 75 20 74 6f 20 |uld help| you to |
|000001d0| 67 65 74 20 73 74 61 72 | 74 65 64 2e 0d 54 68 65 |get star|ted..The|
|000001e0| 20 70 61 72 61 6d 65 74 | 65 72 20 63 6f 6e 76 65 | paramet|er conve|
|000001f0| 6e 74 69 6f 6e 73 20 66 | 6f 72 20 74 68 65 20 43 |ntions f|or the C|
|00000200| 20 66 75 6e 63 74 69 6f | 6e 73 20 61 72 65 20 74 | functio|ns are t|
|00000210| 72 61 6e 73 6c 61 74 65 | 64 20 74 6f 20 50 79 74 |ranslate|d to Pyt|
|00000220| 68 6f 6e 20 61 73 0d 66 | 6f 6c 6c 6f 77 73 3a 0d |hon as.f|ollows:.|
|00000230| 0d 5c 62 65 67 69 6e 7b | 69 74 65 6d 69 7a 65 7d |.\begin{|itemize}|
|00000240| 0d 5c 69 74 65 6d 0d 41 | 6c 6c 20 28 73 68 6f 72 |.\item.A|ll (shor|
|00000250| 74 2c 20 6c 6f 6e 67 2c | 20 75 6e 73 69 67 6e 65 |t, long,| unsigne|
|00000260| 64 29 20 69 6e 74 20 76 | 61 6c 75 65 73 20 61 72 |d) int v|alues ar|
|00000270| 65 20 72 65 70 72 65 73 | 65 6e 74 65 64 20 62 79 |e repres|ented by|
|00000280| 20 50 79 74 68 6f 6e 0d | 69 6e 74 65 67 65 72 73 | Python.|integers|
|00000290| 2e 0d 5c 69 74 65 6d 0d | 41 6c 6c 20 66 6c 6f 61 |..\item.|All floa|
|000002a0| 74 20 61 6e 64 20 64 6f | 75 62 6c 65 20 76 61 6c |t and do|uble val|
|000002b0| 75 65 73 20 61 72 65 20 | 72 65 70 72 65 73 65 6e |ues are |represen|
|000002c0| 74 65 64 20 62 79 20 50 | 79 74 68 6f 6e 20 66 6c |ted by P|ython fl|
|000002d0| 6f 61 74 69 6e 67 20 70 | 6f 69 6e 74 0d 6e 75 6d |oating p|oint.num|
|000002e0| 62 65 72 73 2e 0d 49 6e | 20 6d 6f 73 74 20 63 61 |bers..In| most ca|
|000002f0| 73 65 73 2c 20 50 79 74 | 68 6f 6e 20 69 6e 74 65 |ses, Pyt|hon inte|
|00000300| 67 65 72 73 20 61 72 65 | 20 61 6c 73 6f 20 61 6c |gers are| also al|
|00000310| 6c 6f 77 65 64 2e 0d 5c | 69 74 65 6d 0d 41 6c 6c |lowed..\|item.All|
|00000320| 20 61 72 72 61 79 73 20 | 61 72 65 20 72 65 70 72 | arrays |are repr|
|00000330| 65 73 65 6e 74 65 64 20 | 62 79 20 6f 6e 65 2d 64 |esented |by one-d|
|00000340| 69 6d 65 6e 73 69 6f 6e | 61 6c 20 50 79 74 68 6f |imension|al Pytho|
|00000350| 6e 20 6c 69 73 74 73 2e | 0d 49 6e 20 6d 6f 73 74 |n lists.|.In most|
|00000360| 20 63 61 73 65 73 2c 20 | 74 75 70 6c 65 73 20 61 | cases, |tuples a|
|00000370| 72 65 20 61 6c 73 6f 20 | 61 6c 6c 6f 77 65 64 2e |re also |allowed.|
|00000380| 0d 5c 69 74 65 6d 0d 5c | 62 65 67 69 6e 7b 73 6c |.\item.\|begin{sl|
|00000390| 6f 70 70 79 70 61 72 7d | 0d 41 6c 6c 20 73 74 72 |oppypar}|.All str|
|000003a0| 69 6e 67 20 61 6e 64 20 | 63 68 61 72 61 63 74 65 |ing and |characte|
|000003b0| 72 20 61 72 67 75 6d 65 | 6e 74 73 20 61 72 65 20 |r argume|nts are |
|000003c0| 72 65 70 72 65 73 65 6e | 74 65 64 20 62 79 20 50 |represen|ted by P|
|000003d0| 79 74 68 6f 6e 20 73 74 | 72 69 6e 67 73 2c 0d 66 |ython st|rings,.f|
|000003e0| 6f 72 20 69 6e 73 74 61 | 6e 63 65 2c 0d 5c 63 6f |or insta|nce,.\co|
|000003f0| 64 65 7b 77 69 6e 6f 70 | 65 6e 28 27 48 69 20 54 |de{winop|en('Hi T|
|00000400| 68 65 72 65 21 27 29 7d | 0d 61 6e 64 0d 5c 63 6f |here!')}|.and.\co|
|00000410| 64 65 7b 72 6f 74 61 74 | 65 28 39 30 30 2c 20 27 |de{rotat|e(900, '|
|00000420| 7a 27 29 7d 2e 0d 5c 65 | 6e 64 7b 73 6c 6f 70 70 |z')}..\e|nd{slopp|
|00000430| 79 70 61 72 7d 0d 5c 69 | 74 65 6d 0d 41 6c 6c 20 |ypar}.\i|tem.All |
|00000440| 28 73 68 6f 72 74 2c 20 | 6c 6f 6e 67 2c 20 75 6e |(short, |long, un|
|00000450| 73 69 67 6e 65 64 29 20 | 69 6e 74 65 67 65 72 20 |signed) |integer |
|00000460| 61 72 67 75 6d 65 6e 74 | 73 20 6f 72 20 72 65 74 |argument|s or ret|
|00000470| 75 72 6e 20 76 61 6c 75 | 65 73 20 74 68 61 74 20 |urn valu|es that |
|00000480| 61 72 65 0d 6f 6e 6c 79 | 20 75 73 65 64 20 74 6f |are.only| used to|
|00000490| 20 73 70 65 63 69 66 79 | 20 74 68 65 20 6c 65 6e | specify| the len|
|000004a0| 67 74 68 20 6f 66 20 61 | 6e 20 61 72 72 61 79 20 |gth of a|n array |
|000004b0| 61 72 67 75 6d 65 6e 74 | 20 61 72 65 20 6f 6d 69 |argument| are omi|
|000004c0| 74 74 65 64 2e 0d 46 6f | 72 20 65 78 61 6d 70 6c |tted..Fo|r exampl|
|000004d0| 65 2c 20 74 68 65 20 43 | 20 63 61 6c 6c 0d 0d 5c |e, the C| call..\|
|000004e0| 62 63 6f 64 65 5c 62 65 | 67 69 6e 7b 76 65 72 62 |bcode\be|gin{verb|
|000004f0| 61 74 69 6d 7d 0d 6c 6d | 64 65 66 28 64 65 66 74 |atim}.lm|def(deft|
|00000500| 79 70 65 2c 20 69 6e 64 | 65 78 2c 20 6e 70 2c 20 |ype, ind|ex, np, |
|00000510| 70 72 6f 70 73 29 0d 5c | 65 6e 64 7b 76 65 72 62 |props).\|end{verb|
|00000520| 61 74 69 6d 7d 5c 65 63 | 6f 64 65 0d 0d 69 73 20 |atim}\ec|ode..is |
|00000530| 74 72 61 6e 73 6c 61 74 | 65 64 20 74 6f 20 50 79 |translat|ed to Py|
|00000540| 74 68 6f 6e 20 61 73 0d | 0d 5c 62 63 6f 64 65 5c |thon as.|.\bcode\|
|00000550| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0d |begin{ve|rbatim}.|
|00000560| 6c 6d 64 65 66 28 64 65 | 66 74 79 70 65 2c 20 69 |lmdef(de|ftype, i|
|00000570| 6e 64 65 78 2c 20 70 72 | 6f 70 73 29 0d 5c 65 6e |ndex, pr|ops).\en|
|00000580| 64 7b 76 65 72 62 61 74 | 69 6d 7d 5c 65 63 6f 64 |d{verbat|im}\ecod|
|00000590| 65 0d 0d 5c 69 74 65 6d | 0d 4f 75 74 70 75 74 20 |e..\item|.Output |
|000005a0| 61 72 67 75 6d 65 6e 74 | 73 20 61 72 65 20 6f 6d |argument|s are om|
|000005b0| 69 74 74 65 64 20 66 72 | 6f 6d 20 74 68 65 20 61 |itted fr|om the a|
|000005c0| 72 67 75 6d 65 6e 74 20 | 6c 69 73 74 3b 20 74 68 |rgument |list; th|
|000005d0| 65 79 20 61 72 65 0d 74 | 72 61 6e 73 6d 69 74 74 |ey are.t|ransmitt|
|000005e0| 65 64 20 61 73 20 66 75 | 6e 63 74 69 6f 6e 20 72 |ed as fu|nction r|
|000005f0| 65 74 75 72 6e 20 76 61 | 6c 75 65 73 20 69 6e 73 |eturn va|lues ins|
|00000600| 74 65 61 64 2e 0d 49 66 | 20 6d 6f 72 65 20 74 68 |tead..If| more th|
|00000610| 61 6e 20 6f 6e 65 20 76 | 61 6c 75 65 20 6d 75 73 |an one v|alue mus|
|00000620| 74 20 62 65 20 72 65 74 | 75 72 6e 65 64 2c 20 74 |t be ret|urned, t|
|00000630| 68 65 20 72 65 74 75 72 | 6e 20 76 61 6c 75 65 20 |he retur|n value |
|00000640| 69 73 20 61 20 74 75 70 | 6c 65 2e 0d 49 66 20 74 |is a tup|le..If t|
|00000650| 68 65 20 43 20 66 75 6e | 63 74 69 6f 6e 20 68 61 |he C fun|ction ha|
|00000660| 73 20 62 6f 74 68 20 61 | 20 72 65 67 75 6c 61 72 |s both a| regular|
|00000670| 20 72 65 74 75 72 6e 20 | 76 61 6c 75 65 20 28 74 | return |value (t|
|00000680| 68 61 74 20 69 73 20 6e | 6f 74 20 6f 6d 69 74 74 |hat is n|ot omitt|
|00000690| 65 64 0d 62 65 63 61 75 | 73 65 20 6f 66 20 74 68 |ed.becau|se of th|
|000006a0| 65 20 70 72 65 76 69 6f | 75 73 20 72 75 6c 65 29 |e previo|us rule)|
|000006b0| 20 61 6e 64 20 61 6e 20 | 6f 75 74 70 75 74 20 61 | and an |output a|
|000006c0| 72 67 75 6d 65 6e 74 2c | 20 74 68 65 20 72 65 74 |rgument,| the ret|
|000006d0| 75 72 6e 20 76 61 6c 75 | 65 0d 63 6f 6d 65 73 20 |urn valu|e.comes |
|000006e0| 66 69 72 73 74 20 69 6e | 20 74 68 65 20 74 75 70 |first in| the tup|
|000006f0| 6c 65 2e 0d 45 78 61 6d | 70 6c 65 73 3a 20 74 68 |le..Exam|ples: th|
|00000700| 65 20 43 20 63 61 6c 6c | 0d 0d 5c 62 63 6f 64 65 |e C call|..\bcode|
|00000710| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00000720| 0d 67 65 74 6d 63 6f 6c | 6f 72 28 69 2c 20 26 72 |.getmcol|or(i, &r|
|00000730| 65 64 2c 20 26 67 72 65 | 65 6e 2c 20 26 62 6c 75 |ed, &gre|en, &blu|
|00000740| 65 29 0d 5c 65 6e 64 7b | 76 65 72 62 61 74 69 6d |e).\end{|verbatim|
|00000750| 7d 5c 65 63 6f 64 65 0d | 0d 69 73 20 74 72 61 6e |}\ecode.|.is tran|
|00000760| 73 6c 61 74 65 64 20 74 | 6f 20 50 79 74 68 6f 6e |slated t|o Python|
|00000770| 20 61 73 0d 0d 5c 62 63 | 6f 64 65 5c 62 65 67 69 | as..\bc|ode\begi|
|00000780| 6e 7b 76 65 72 62 61 74 | 69 6d 7d 0d 72 65 64 2c |n{verbat|im}.red,|
|00000790| 20 67 72 65 65 6e 2c 20 | 62 6c 75 65 20 3d 20 67 | green, |blue = g|
|000007a0| 65 74 6d 63 6f 6c 6f 72 | 28 69 29 0d 5c 65 6e 64 |etmcolor|(i).\end|
|000007b0| 7b 76 65 72 62 61 74 69 | 6d 7d 5c 65 63 6f 64 65 |{verbati|m}\ecode|
|000007c0| 0d 0d 5c 65 6e 64 7b 69 | 74 65 6d 69 7a 65 7d 0d |..\end{i|temize}.|
|000007d0| 0d 54 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 66 |.The fol|lowing f|
|000007e0| 75 6e 63 74 69 6f 6e 73 | 20 61 72 65 20 6e 6f 6e |unctions| are non|
|000007f0| 2d 73 74 61 6e 64 61 72 | 64 20 6f 72 20 68 61 76 |-standar|d or hav|
|00000800| 65 20 73 70 65 63 69 61 | 6c 20 61 72 67 75 6d 65 |e specia|l argume|
|00000810| 6e 74 0d 63 6f 6e 76 65 | 6e 74 69 6f 6e 73 3a 0d |nt.conve|ntions:.|
|00000820| 0d 5c 72 65 6e 65 77 63 | 6f 6d 6d 61 6e 64 7b 5c |.\renewc|ommand{\|
|00000830| 69 6e 64 65 78 73 75 62 | 69 74 65 6d 7d 7b 28 69 |indexsub|item}{(i|
|00000840| 6e 20 6d 6f 64 75 6c 65 | 20 67 6c 29 7d 0d 5c 62 |n module| gl)}.\b|
|00000850| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 76 |egin{fun|cdesc}{v|
|00000860| 61 72 72 61 79 7d 7b 61 | 72 67 75 6d 65 6e 74 7d |array}{a|rgument}|
|00000870| 0d 25 4a 48 58 58 58 20 | 74 68 65 20 61 72 67 75 |.%JHXXX |the argu|
|00000880| 6d 65 6e 74 2d 61 72 67 | 75 6d 65 6e 74 20 61 64 |ment-arg|ument ad|
|00000890| 64 65 64 0d 45 71 75 69 | 76 61 6c 65 6e 74 20 74 |ded.Equi|valent t|
|000008a0| 6f 20 62 75 74 20 66 61 | 73 74 65 72 20 74 68 61 |o but fa|ster tha|
|000008b0| 6e 20 61 20 6e 75 6d 62 | 65 72 20 6f 66 0d 5c 63 |n a numb|er of.\c|
|000008c0| 6f 64 65 7b 76 33 64 28 | 29 7d 0d 63 61 6c 6c 73 |ode{v3d(|)}.calls|
|000008d0| 2e 0d 54 68 65 20 5c 76 | 61 72 7b 61 72 67 75 6d |..The \v|ar{argum|
|000008e0| 65 6e 74 7d 20 69 73 20 | 61 20 6c 69 73 74 20 28 |ent} is |a list (|
|000008f0| 6f 72 20 74 75 70 6c 65 | 29 20 6f 66 20 70 6f 69 |or tuple|) of poi|
|00000900| 6e 74 73 2e 0d 45 61 63 | 68 20 70 6f 69 6e 74 20 |nts..Eac|h point |
|00000910| 6d 75 73 74 20 62 65 20 | 61 20 74 75 70 6c 65 20 |must be |a tuple |
|00000920| 6f 66 20 63 6f 6f 72 64 | 69 6e 61 74 65 73 0d 5c |of coord|inates.\|
|00000930| 63 6f 64 65 7b 28 5c 76 | 61 72 7b 78 7d 2c 20 5c |code{(\v|ar{x}, \|
|00000940| 76 61 72 7b 79 7d 2c 20 | 5c 76 61 72 7b 7a 7d 29 |var{y}, |\var{z})|
|00000950| 7d 20 6f 72 20 5c 63 6f | 64 65 7b 28 5c 76 61 72 |} or \co|de{(\var|
|00000960| 7b 78 7d 2c 20 5c 76 61 | 72 7b 79 7d 29 7d 2e 0d |{x}, \va|r{y})}..|
|00000970| 54 68 65 20 70 6f 69 6e | 74 73 20 6d 61 79 20 62 |The poin|ts may b|
|00000980| 65 20 32 2d 20 6f 72 20 | 33 2d 64 69 6d 65 6e 73 |e 2- or |3-dimens|
|00000990| 69 6f 6e 61 6c 20 62 75 | 74 20 6d 75 73 74 20 61 |ional bu|t must a|
|000009a0| 6c 6c 20 68 61 76 65 20 | 74 68 65 0d 73 61 6d 65 |ll have |the.same|
|000009b0| 20 64 69 6d 65 6e 73 69 | 6f 6e 2e 0d 46 6c 6f 61 | dimensi|on..Floa|
|000009c0| 74 20 61 6e 64 20 69 6e | 74 20 76 61 6c 75 65 73 |t and in|t values|
|000009d0| 20 6d 61 79 20 62 65 20 | 6d 69 78 65 64 20 68 6f | may be |mixed ho|
|000009e0| 77 65 76 65 72 2e 0d 54 | 68 65 20 70 6f 69 6e 74 |wever..T|he point|
|000009f0| 73 20 61 72 65 20 61 6c | 77 61 79 73 20 63 6f 6e |s are al|ways con|
|00000a00| 76 65 72 74 65 64 20 74 | 6f 20 33 44 20 64 6f 75 |verted t|o 3D dou|
|00000a10| 62 6c 65 20 70 72 65 63 | 69 73 69 6f 6e 20 70 6f |ble prec|ision po|
|00000a20| 69 6e 74 73 0d 62 79 20 | 61 73 73 75 6d 69 6e 67 |ints.by |assuming|
|00000a30| 20 5c 63 6f 64 65 7b 5c | 76 61 72 7b 7a 7d 20 3d | \code{\|var{z} =|
|00000a40| 20 30 2e 30 7d 20 69 66 | 20 6e 65 63 65 73 73 61 | 0.0} if| necessa|
|00000a50| 72 79 20 28 61 73 20 69 | 6e 64 69 63 61 74 65 64 |ry (as i|ndicated|
|00000a60| 20 69 6e 20 74 68 65 20 | 6d 61 6e 20 70 61 67 65 | in the |man page|
|00000a70| 29 2c 0d 61 6e 64 20 66 | 6f 72 20 65 61 63 68 20 |),.and f|or each |
|00000a80| 70 6f 69 6e 74 0d 5c 63 | 6f 64 65 7b 76 33 64 28 |point.\c|ode{v3d(|
|00000a90| 29 7d 0d 69 73 20 63 61 | 6c 6c 65 64 2e 0d 5c 65 |)}.is ca|lled..\e|
|00000aa0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00000ab0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 6e |egin{fun|cdesc}{n|
|00000ac0| 76 61 72 72 61 79 7d 7b | 7d 0d 45 71 75 69 76 61 |varray}{|}.Equiva|
|00000ad0| 6c 65 6e 74 20 74 6f 20 | 62 75 74 20 66 61 73 74 |lent to |but fast|
|00000ae0| 65 72 20 74 68 61 6e 20 | 61 20 6e 75 6d 62 65 72 |er than |a number|
|00000af0| 20 6f 66 0d 5c 63 6f 64 | 65 7b 6e 33 66 7d 0d 61 | of.\cod|e{n3f}.a|
|00000b00| 6e 64 0d 5c 63 6f 64 65 | 7b 76 33 66 7d 0d 63 61 |nd.\code|{v3f}.ca|
|00000b10| 6c 6c 73 2e 0d 54 68 65 | 20 61 72 67 75 6d 65 6e |lls..The| argumen|
|00000b20| 74 20 69 73 20 61 6e 20 | 61 72 72 61 79 20 28 6c |t is an |array (l|
|00000b30| 69 73 74 20 6f 72 20 74 | 75 70 6c 65 29 20 6f 66 |ist or t|uple) of|
|00000b40| 20 70 61 69 72 73 20 6f | 66 20 6e 6f 72 6d 61 6c | pairs o|f normal|
|00000b50| 73 20 61 6e 64 20 70 6f | 69 6e 74 73 2e 0d 45 61 |s and po|ints..Ea|
|00000b60| 63 68 20 70 61 69 72 20 | 69 73 20 61 20 74 75 70 |ch pair |is a tup|
|00000b70| 6c 65 20 6f 66 20 61 20 | 70 6f 69 6e 74 20 61 6e |le of a |point an|
|00000b80| 64 20 61 20 6e 6f 72 6d | 61 6c 20 66 6f 72 20 74 |d a norm|al for t|
|00000b90| 68 61 74 20 70 6f 69 6e | 74 2e 0d 45 61 63 68 20 |hat poin|t..Each |
|00000ba0| 70 6f 69 6e 74 20 6f 72 | 20 6e 6f 72 6d 61 6c 20 |point or| normal |
|00000bb0| 6d 75 73 74 20 62 65 20 | 61 20 74 75 70 6c 65 20 |must be |a tuple |
|00000bc0| 6f 66 20 63 6f 6f 72 64 | 69 6e 61 74 65 73 0d 5c |of coord|inates.\|
|00000bd0| 63 6f 64 65 7b 28 5c 76 | 61 72 7b 78 7d 2c 20 5c |code{(\v|ar{x}, \|
|00000be0| 76 61 72 7b 79 7d 2c 20 | 5c 76 61 72 7b 7a 7d 29 |var{y}, |\var{z})|
|00000bf0| 7d 2e 0d 54 68 72 65 65 | 20 63 6f 6f 72 64 69 6e |}..Three| coordin|
|00000c00| 61 74 65 73 20 6d 75 73 | 74 20 62 65 20 67 69 76 |ates mus|t be giv|
|00000c10| 65 6e 2e 0d 46 6c 6f 61 | 74 20 61 6e 64 20 69 6e |en..Floa|t and in|
|00000c20| 74 20 76 61 6c 75 65 73 | 20 6d 61 79 20 62 65 20 |t values| may be |
|00000c30| 6d 69 78 65 64 2e 0d 46 | 6f 72 20 65 61 63 68 20 |mixed..F|or each |
|00000c40| 70 61 69 72 2c 0d 5c 63 | 6f 64 65 7b 6e 33 66 28 |pair,.\c|ode{n3f(|
|00000c50| 29 7d 0d 69 73 20 63 61 | 6c 6c 65 64 20 66 6f 72 |)}.is ca|lled for|
|00000c60| 20 74 68 65 20 6e 6f 72 | 6d 61 6c 2c 20 61 6e 64 | the nor|mal, and|
|00000c70| 20 74 68 65 6e 0d 5c 63 | 6f 64 65 7b 76 33 66 28 | then.\c|ode{v3f(|
|00000c80| 29 7d 0d 69 73 20 63 61 | 6c 6c 65 64 20 66 6f 72 |)}.is ca|lled for|
|00000c90| 20 74 68 65 20 70 6f 69 | 6e 74 2e 0d 5c 65 6e 64 | the poi|nt..\end|
|00000ca0| 7b 66 75 6e 63 64 65 73 | 63 7d 0d 0d 5c 62 65 67 |{funcdes|c}..\beg|
|00000cb0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 76 6e 61 |in{funcd|esc}{vna|
|00000cc0| 72 72 61 79 7d 7b 7d 0d | 53 69 6d 69 6c 61 72 20 |rray}{}.|Similar |
|00000cd0| 74 6f 20 0d 5c 63 6f 64 | 65 7b 6e 76 61 72 72 61 |to .\cod|e{nvarra|
|00000ce0| 79 28 29 7d 0d 62 75 74 | 20 74 68 65 20 70 61 69 |y()}.but| the pai|
|00000cf0| 72 73 20 68 61 76 65 20 | 74 68 65 20 70 6f 69 6e |rs have |the poin|
|00000d00| 74 20 66 69 72 73 74 20 | 61 6e 64 20 74 68 65 20 |t first |and the |
|00000d10| 6e 6f 72 6d 61 6c 20 73 | 65 63 6f 6e 64 2e 0d 5c |normal s|econd..\|
|00000d20| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000d30| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000d40| 6e 75 72 62 73 73 75 72 | 66 61 63 65 7d 7b 73 5f |nurbssur|face}{s_|
|00000d50| 6b 5c 2c 20 74 5f 6b 5c | 2c 20 63 74 6c 5c 2c 20 |k\, t_k\|, ctl\, |
|00000d60| 73 5f 6f 72 64 5c 2c 20 | 74 5f 6f 72 64 5c 2c 20 |s_ord\, |t_ord\, |
|00000d70| 74 79 70 65 7d 0d 25 20 | 58 58 58 20 73 5f 6b 5b |type}.% |XXX s_k[|
|00000d80| 5d 2c 20 74 5f 6b 5b 5d | 2c 20 63 74 6c 5b 5d 5b |], t_k[]|, ctl[][|
|00000d90| 5d 0d 25 5c 69 74 65 6d | 62 72 65 61 6b 0d 44 65 |].%\item|break.De|
|00000da0| 66 69 6e 65 73 20 61 20 | 6e 75 72 62 73 20 73 75 |fines a |nurbs su|
|00000db0| 72 66 61 63 65 2e 0d 54 | 68 65 20 64 69 6d 65 6e |rface..T|he dimen|
|00000dc0| 73 69 6f 6e 73 20 6f 66 | 0d 5c 63 6f 64 65 7b 5c |sions of|.\code{\|
|00000dd0| 76 61 72 7b 63 74 6c 7d | 5b 5d 5b 5d 7d 0d 61 72 |var{ctl}|[][]}.ar|
|00000de0| 65 20 63 6f 6d 70 75 74 | 65 64 20 61 73 20 66 6f |e comput|ed as fo|
|00000df0| 6c 6c 6f 77 73 3a 0d 5c | 63 6f 64 65 7b 5b 6c 65 |llows:.\|code{[le|
|00000e00| 6e 28 5c 76 61 72 7b 73 | 5f 6b 7d 29 20 2d 20 5c |n(\var{s|_k}) - \|
|00000e10| 76 61 72 7b 73 5f 6f 72 | 64 7d 5d 7d 2c 0d 5c 63 |var{s_or|d}]},.\c|
|00000e20| 6f 64 65 7b 5b 6c 65 6e | 28 5c 76 61 72 7b 74 5f |ode{[len|(\var{t_|
|00000e30| 6b 7d 29 20 2d 20 5c 76 | 61 72 7b 74 5f 6f 72 64 |k}) - \v|ar{t_ord|
|00000e40| 7d 5d 7d 2e 0d 5c 65 6e | 64 7b 66 75 6e 63 64 65 |}]}..\en|d{funcde|
|00000e50| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000e60| 64 65 73 63 7d 7b 6e 75 | 72 62 73 63 75 72 76 65 |desc}{nu|rbscurve|
|00000e70| 7d 7b 6b 6e 6f 74 73 5c | 2c 20 63 74 6c 70 6f 69 |}{knots\|, ctlpoi|
|00000e80| 6e 74 73 5c 2c 20 6f 72 | 64 65 72 5c 2c 20 74 79 |nts\, or|der\, ty|
|00000e90| 70 65 7d 0d 44 65 66 69 | 6e 65 73 20 61 20 6e 75 |pe}.Defi|nes a nu|
|00000ea0| 72 62 73 20 63 75 72 76 | 65 2e 0d 54 68 65 20 6c |rbs curv|e..The l|
|00000eb0| 65 6e 67 74 68 20 6f 66 | 20 63 74 6c 70 6f 69 6e |ength of| ctlpoin|
|00000ec0| 74 73 20 69 73 0d 5c 63 | 6f 64 65 7b 6c 65 6e 28 |ts is.\c|ode{len(|
|00000ed0| 5c 76 61 72 7b 6b 6e 6f | 74 73 7d 29 20 2d 20 5c |\var{kno|ts}) - \|
|00000ee0| 76 61 72 7b 6f 72 64 65 | 72 7d 7d 2e 0d 5c 65 6e |var{orde|r}}..\en|
|00000ef0| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00000f00| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 70 77 |gin{func|desc}{pw|
|00000f10| 6c 63 75 72 76 65 7d 7b | 70 6f 69 6e 74 73 5c 2c |lcurve}{|points\,|
|00000f20| 20 74 79 70 65 7d 0d 44 | 65 66 69 6e 65 73 20 61 | type}.D|efines a|
|00000f30| 20 70 69 65 63 65 77 69 | 73 65 2d 6c 69 6e 65 61 | piecewi|se-linea|
|00000f40| 72 20 63 75 72 76 65 2e | 0d 5c 76 61 72 7b 70 6f |r curve.|.\var{po|
|00000f50| 69 6e 74 73 7d 0d 69 73 | 20 61 20 6c 69 73 74 20 |ints}.is| a list |
|00000f60| 6f 66 20 70 6f 69 6e 74 | 73 2e 0d 5c 76 61 72 7b |of point|s..\var{|
|00000f70| 74 79 70 65 7d 0d 6d 75 | 73 74 20 62 65 0d 5c 63 |type}.mu|st be.\c|
|00000f80| 6f 64 65 7b 4e 5f 53 54 | 7d 2e 0d 5c 65 6e 64 7b |ode{N_ST|}..\end{|
|00000f90| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00000fa0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 70 69 63 6b |n{funcde|sc}{pick|
|00000fb0| 7d 7b 6e 7d 0d 5c 66 75 | 6e 63 6c 69 6e 65 7b 73 |}{n}.\fu|ncline{s|
|00000fc0| 65 6c 65 63 74 7d 7b 6e | 7d 0d 54 68 65 20 6f 6e |elect}{n|}.The on|
|00000fd0| 6c 79 20 61 72 67 75 6d | 65 6e 74 20 74 6f 20 74 |ly argum|ent to t|
|00000fe0| 68 65 73 65 20 66 75 6e | 63 74 69 6f 6e 73 20 73 |hese fun|ctions s|
|00000ff0| 70 65 63 69 66 69 65 73 | 20 74 68 65 20 64 65 73 |pecifies| the des|
|00001000| 69 72 65 64 20 73 69 7a | 65 20 6f 66 20 74 68 65 |ired siz|e of the|
|00001010| 0d 70 69 63 6b 20 6f 72 | 20 73 65 6c 65 63 74 20 |.pick or| select |
|00001020| 62 75 66 66 65 72 2e 0d | 5c 65 6e 64 7b 66 75 6e |buffer..|\end{fun|
|00001030| 63 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00001040| 75 6e 63 64 65 73 63 7d | 7b 65 6e 64 70 69 63 6b |uncdesc}|{endpick|
|00001050| 7d 7b 7d 0d 5c 66 75 6e | 63 6c 69 6e 65 7b 65 6e |}{}.\fun|cline{en|
|00001060| 64 73 65 6c 65 63 74 7d | 7b 7d 0d 54 68 65 73 65 |dselect}|{}.These|
|00001070| 20 66 75 6e 63 74 69 6f | 6e 73 20 68 61 76 65 20 | functio|ns have |
|00001080| 6e 6f 20 61 72 67 75 6d | 65 6e 74 73 2e 0d 54 68 |no argum|ents..Th|
|00001090| 65 79 20 72 65 74 75 72 | 6e 20 61 20 6c 69 73 74 |ey retur|n a list|
|000010a0| 20 6f 66 20 69 6e 74 65 | 67 65 72 73 20 72 65 70 | of inte|gers rep|
|000010b0| 72 65 73 65 6e 74 69 6e | 67 20 74 68 65 20 75 73 |resentin|g the us|
|000010c0| 65 64 20 70 61 72 74 20 | 6f 66 20 74 68 65 0d 70 |ed part |of the.p|
|000010d0| 69 63 6b 2f 73 65 6c 65 | 63 74 20 62 75 66 66 65 |ick/sele|ct buffe|
|000010e0| 72 2e 0d 4e 6f 20 6d 65 | 74 68 6f 64 20 69 73 20 |r..No me|thod is |
|000010f0| 70 72 6f 76 69 64 65 64 | 20 74 6f 20 64 65 74 65 |provided| to dete|
|00001100| 63 74 20 62 75 66 66 65 | 72 20 6f 76 65 72 72 75 |ct buffe|r overru|
|00001110| 6e 2e 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |n..\end{|funcdesc|
|00001120| 7d 0d 0d 48 65 72 65 20 | 69 73 20 61 20 74 69 6e |}..Here |is a tin|
|00001130| 79 20 62 75 74 20 63 6f | 6d 70 6c 65 74 65 20 65 |y but co|mplete e|
|00001140| 78 61 6d 70 6c 65 20 47 | 4c 20 70 72 6f 67 72 61 |xample G|L progra|
|00001150| 6d 20 69 6e 20 50 79 74 | 68 6f 6e 3a 0d 0d 5c 62 |m in Pyt|hon:..\b|
|00001160| 63 6f 64 65 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |code\beg|in{verba|
|00001170| 74 69 6d 7d 0d 69 6d 70 | 6f 72 74 20 67 6c 2c 20 |tim}.imp|ort gl, |
|00001180| 47 4c 2c 20 74 69 6d 65 | 0d 0d 64 65 66 20 6d 61 |GL, time|..def ma|
|00001190| 69 6e 28 29 3a 0d 20 20 | 20 20 67 6c 2e 66 6f 72 |in():.  |  gl.for|
|000011a0| 65 67 72 6f 75 6e 64 28 | 29 0d 20 20 20 20 67 6c |eground(|).    gl|
|000011b0| 2e 70 72 65 66 70 6f 73 | 69 74 69 6f 6e 28 35 30 |.prefpos|ition(50|
|000011c0| 30 2c 20 39 30 30 2c 20 | 35 30 30 2c 20 39 30 30 |0, 900, |500, 900|
|000011d0| 29 0d 20 20 20 20 77 20 | 3d 20 67 6c 2e 77 69 6e |).    w |= gl.win|
|000011e0| 6f 70 65 6e 28 27 43 72 | 69 73 73 43 72 6f 73 73 |open('Cr|issCross|
|000011f0| 27 29 0d 20 20 20 20 67 | 6c 2e 6f 72 74 68 6f 32 |').    g|l.ortho2|
|00001200| 28 30 2e 30 2c 20 34 30 | 30 2e 30 2c 20 30 2e 30 |(0.0, 40|0.0, 0.0|
|00001210| 2c 20 34 30 30 2e 30 29 | 0d 20 20 20 20 67 6c 2e |, 400.0)|.    gl.|
|00001220| 63 6f 6c 6f 72 28 47 4c | 2e 57 48 49 54 45 29 0d |color(GL|.WHITE).|
|00001230| 20 20 20 20 67 6c 2e 63 | 6c 65 61 72 28 29 0d 20 |    gl.c|lear(). |
|00001240| 20 20 20 67 6c 2e 63 6f | 6c 6f 72 28 47 4c 2e 52 |   gl.co|lor(GL.R|
|00001250| 45 44 29 0d 20 20 20 20 | 67 6c 2e 62 67 6e 6c 69 |ED).    |gl.bgnli|
|00001260| 6e 65 28 29 0d 20 20 20 | 20 67 6c 2e 76 32 66 28 |ne().   | gl.v2f(|
|00001270| 30 2e 30 2c 20 30 2e 30 | 29 0d 20 20 20 20 67 6c |0.0, 0.0|).    gl|
|00001280| 2e 76 32 66 28 34 30 30 | 2e 30 2c 20 34 30 30 2e |.v2f(400|.0, 400.|
|00001290| 30 29 0d 20 20 20 20 67 | 6c 2e 65 6e 64 6c 69 6e |0).    g|l.endlin|
|000012a0| 65 28 29 0d 20 20 20 20 | 67 6c 2e 62 67 6e 6c 69 |e().    |gl.bgnli|
|000012b0| 6e 65 28 29 0d 20 20 20 | 20 67 6c 2e 76 32 66 28 |ne().   | gl.v2f(|
|000012c0| 34 30 30 2e 30 2c 20 30 | 2e 30 29 0d 20 20 20 20 |400.0, 0|.0).    |
|000012d0| 67 6c 2e 76 32 66 28 30 | 2e 30 2c 20 34 30 30 2e |gl.v2f(0|.0, 400.|
|000012e0| 30 29 0d 20 20 20 20 67 | 6c 2e 65 6e 64 6c 69 6e |0).    g|l.endlin|
|000012f0| 65 28 29 0d 20 20 20 20 | 74 69 6d 65 2e 73 6c 65 |e().    |time.sle|
|00001300| 65 70 28 35 29 0d 0d 6d | 61 69 6e 28 29 0d 5c 65 |ep(5)..m|ain().\e|
|00001310| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 5c 65 63 6f |nd{verba|tim}\eco|
|00001320| 64 65 0d 0d 5c 73 65 63 | 74 69 6f 6e 7b 53 74 61 |de..\sec|tion{Sta|
|00001330| 6e 64 61 72 64 20 4d 6f | 64 75 6c 65 73 20 5c 73 |ndard Mo|dules \s|
|00001340| 65 63 74 63 6f 64 65 7b | 47 4c 7d 20 61 6e 64 20 |ectcode{|GL} and |
|00001350| 5c 73 65 63 74 63 6f 64 | 65 7b 44 45 56 49 43 45 |\sectcod|e{DEVICE|
|00001360| 7d 7d 0d 5c 73 74 6d 6f | 64 69 6e 64 65 78 7b 47 |}}.\stmo|dindex{G|
|00001370| 4c 7d 0d 5c 73 74 6d 6f | 64 69 6e 64 65 78 7b 44 |L}.\stmo|dindex{D|
|00001380| 45 56 49 43 45 7d 0d 0d | 54 68 65 73 65 20 6d 6f |EVICE}..|These mo|
|00001390| 64 75 6c 65 73 20 64 65 | 66 69 6e 65 20 74 68 65 |dules de|fine the|
|000013a0| 20 63 6f 6e 73 74 61 6e | 74 73 20 75 73 65 64 20 | constan|ts used |
|000013b0| 62 79 20 74 68 65 20 53 | 69 6c 69 63 6f 6e 20 47 |by the S|ilicon G|
|000013c0| 72 61 70 68 69 63 73 0d | 7b 5c 65 6d 20 47 72 61 |raphics.|{\em Gra|
|000013d0| 70 68 69 63 73 20 4c 69 | 62 72 61 72 79 7d 0d 74 |phics Li|brary}.t|
|000013e0| 68 61 74 20 43 20 70 72 | 6f 67 72 61 6d 6d 65 72 |hat C pr|ogrammer|
|000013f0| 73 20 66 69 6e 64 20 69 | 6e 20 74 68 65 20 68 65 |s find i|n the he|
|00001400| 61 64 65 72 20 66 69 6c | 65 73 0d 5c 66 69 6c 65 |ader fil|es.\file|
|00001410| 7b 3c 67 6c 2f 67 6c 2e | 68 3e 7d 0d 61 6e 64 0d |{<gl/gl.|h>}.and.|
|00001420| 5c 66 69 6c 65 7b 3c 67 | 6c 2f 64 65 76 69 63 65 |\file{<g|l/device|
|00001430| 2e 68 3e 7d 2e 0d 52 65 | 61 64 20 74 68 65 20 6d |.h>}..Re|ad the m|
|00001440| 6f 64 75 6c 65 20 73 6f | 75 72 63 65 20 66 69 6c |odule so|urce fil|
|00001450| 65 73 20 66 6f 72 20 64 | 65 74 61 69 6c 73 2e 0d |es for d|etails..|
+--------+-------------------------+-------------------------+--------+--------+