diff options
Diffstat (limited to 'nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/begin.gl')
-rw-r--r-- | nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/begin.gl | 229 |
1 files changed, 0 insertions, 229 deletions
diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/begin.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/begin.gl deleted file mode 100644 index 6e08bb1b0..000000000 --- a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/begin.gl +++ /dev/null @@ -1,229 +0,0 @@ -_C_ License Applicability. Except to the extent portions of this file are -_C_ made subject to an alternative license as permitted in the SGI Free -_C_ Software License B, Version 1.1 (the "License"), the contents of this -_C_ file are subject only to the provisions of the License. You may not use -_C_ this file except in compliance with the License. You may obtain a copy -_C_ of the License at Silicon Graphics, Inc., attn: Legal Services, 1600 -_C_ Amphitheatre Parkway, Mountain View, CA 94043-1351, or at: -_C_ -_C_ http://oss.sgi.com/projects/FreeB -_C_ -_C_ Note that, as provided in the License, the Software is distributed on an -_C_ "AS IS" basis, with ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS -_C_ DISCLAIMED, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES AND -_C_ CONDITIONS OF MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS FOR A -_C_ PARTICULAR PURPOSE, AND NON-INFRINGEMENT. -_C_ -_C_ Original Code. The Original Code is: OpenGL Sample Implementation, -_C_ Version 1.2.1, released January 26, 2000, developed by Silicon Graphics, -_C_ Inc. The Original Code is Copyright (c) 1991-2000 Silicon Graphics, Inc. -_C_ Copyright in any portions created by third parties is as indicated -_C_ elsewhere herein. All Rights Reserved. -_C_ -_C_ Additional Notice Provisions: The application programming interfaces -_C_ established by SGI in conjunction with the Original Code are The -_C_ OpenGL(R) Graphics System: A Specification (Version 1.2.1), released -_C_ April 1, 1999; The OpenGL(R) Graphics System Utility Library (Version -_C_ 1.3), released November 4, 1998; and OpenGL(R) Graphics with the X -_C_ Window System(R) (Version 1.3), released October 19, 1998. This software -_C_ was created using the OpenGL(R) version 1.2.1 Sample Implementation -_C_ published by SGI, but has not been independently verified as being -_C_ compliant with the OpenGL(R) version 1.2.1 Specification. -_C_ -_C_ The first character in this file must be an '_'! -_C_ Anything on a line after _C_ is ignored -_define(_filters,tbl|eqn)_C_ -_header(Begin,delimit the vertices of a primitive or a group of like primitives) -_names(Begin) -.EQ -delim $$ -.EN -.SH PARAMETERS -_phead(_param1) -Specifies the primitive or primitives that will be created from vertices -presented between _cmnd(Begin) and the subsequent _cmnd(End). -Ten symbolic constants are accepted: -_const(POINTS), -_const(LINES), -_const(LINE_STRIP), -_const(LINE_LOOP), -_const(TRIANGLES), -_const(TRIANGLE_STRIP), -_const(TRIANGLE_FAN), -_const(QUADS), -_const(QUAD_STRIP), and -_const(POLYGON). -_names(End) -.SH DESCRIPTION -_cmnd(Begin) and _cmnd(End) delimit the vertices that define a primitive or -a group of like primitives. -_cmnd(Begin) accepts a single argument that specifies in which of ten ways the -vertices are interpreted. -Taking $n$ as an integer count starting at one, -and $N$ as the total number of vertices specified, -the interpretations are as follows: -.TP 23 -_const(POINTS) -Treats each vertex as a single point. -Vertex $n$ defines point $n$. -$N$ points are drawn. -.TP -_const(LINES) -Treats each pair of vertices as an independent line segment. -Vertices $2n^-^1$ and $2n$ define line $n$. -$N/2$ lines are drawn. -.TP -_const(LINE_STRIP) -Draws a connected group of line segments from the first vertex -to the last. -Vertices $n$ and $n~+~1$ define line $n$. -$N^-^1$ lines are drawn. -.TP -_const(LINE_LOOP) -Draws a connected group of line segments from the first vertex -to the last, -then back to the first. -Vertices $n$ and $n~+~1$ define line $n$. -The last line, however, is defined by vertices $N$ and $1$. -$N$ lines are drawn. -.TP -_const(TRIANGLES) -Treats each triplet of vertices as an independent triangle. -Vertices $3n^-^2$, $3n^-^1$, and $3n$ define triangle $n$. -$N/3$ triangles are drawn. -.BP -.TP -_const(TRIANGLE_STRIP) -Draws a connected group of triangles. One triangle is defined for each -vertex presented after the first two vertices. For odd $n$, vertices -$n$, $n~+~1$, and $n~+~2$ define triangle $n$. For even $n$, vertices -$n~+~1$, $n$, and $n~+~2$ define triangle $n$. $N^-^2$ triangles are -drawn. -.TP -_const(TRIANGLE_FAN) -Draws a connected group of triangles. -One triangle is defined for each vertex presented after the first two vertices. -Vertices $1$, -$n~+~1$, -and $n~+~2$ define triangle $n$. -$N^-^2$ triangles are drawn. -.TP -_const(QUADS) -Treats each group of four vertices as an independent quadrilateral. -Vertices $4n^-^3$, $4n^-^2$, $4n^-^1$, and $4n$ -define quadrilateral $n$. -$N/4$ quadrilaterals are drawn. -.TP -_const(QUAD_STRIP) -Draws a connected group of quadrilaterals. -One quadrilateral is defined for each pair of vertices presented -after the first pair. -Vertices $2n^-^1$, $2n$, $2n~+~2$, and $2n~+~1$ define quadrilateral $n$. -$N/2^-^1$ quadrilaterals are drawn. -Note that the order in which vertices are used to construct a quadrilateral -from strip data is different from that used with independent data. -.TP -_const(POLYGON) -Draws a single, -convex polygon. -Vertices $1$ through $N$ define this polygon. -.P -Only a subset of GL commands can be used between _cmnd(Begin) and _cmnd(End). -The commands are -_cmnd(Vertex), -_cmnd(Color), -_cmnd(Index), -_cmnd(Normal), -_cmnd(TexCoord), -_cmnd(EvalCoord), -_cmnd(EvalPoint), -_cmnd(ArrayElement), -_cmnd(Material), and -_cmnd(EdgeFlag). -Also, -it is acceptable to use -_cmnd(CallList) or -_cmnd(CallLists) to execute -display lists that include only the preceding commands. -If any other GL command is executed between _cmnd(Begin) and _cmnd(End), -the error flag is set and the command is ignored. -.P -Regardless of the value chosen for _param1(1), -there is no limit to the number of vertices that can be defined -between _cmnd(Begin) and _cmnd(End). -Lines, -triangles, -quadrilaterals, -and polygons that are incompletely specified are not drawn. -Incomplete specification results when either too few vertices are -provided to specify even a single primitive or when an incorrect multiple -of vertices is specified. The incomplete primitive is ignored; the rest are drawn. -.P -The minimum specification of vertices -for each primitive is as follows: -1 for a point, -2 for a line, -3 for a triangle, -4 for a quadrilateral, -and 3 for a polygon. -Modes that require a certain multiple of vertices are -_const(LINES) (2), -_const(TRIANGLES) (3), -_const(QUADS) (4), -and _const(QUAD_STRIP) (2). -.SH ERRORS -_const(INVALID_ENUM) is generated if _param1(1) is set to an unaccepted value. -.P -_const(INVALID_OPERATION) is generated if _cmnd(Begin) is executed between a -_cmnd(Begin) -and the corresponding execution of _cmnd(End). -.P -_const(INVALID_OPERATION) is generated if _cmnd(End) is executed without being -preceded by a _cmnd(Begin). -.P -_const(INVALID_OPERATION) is generated if a command other than -_cmnd(Vertex), -_cmnd(Color), -_cmnd(Index), -_cmnd(Normal), -_cmnd(TexCoord), -_cmnd(EvalCoord), -_cmnd(EvalPoint), -_cmnd(ArrayElement), -_cmnd(Material), -_cmnd(EdgeFlag), -_cmnd(CallList), or -_cmnd(CallLists) is executed between -the execution of _cmnd(Begin) and the corresponding -execution _cmnd(End). -.P -Execution of -_cmnd(EnableClientState), -_cmnd(DisableClientState), -_cmnd(EdgeFlagPointer), -_cmnd(TexCoordPointer), -_cmnd(ColorPointer), -_cmnd(IndexPointer), -_cmnd(NormalPointer), -.br -_cmnd(VertexPointer), -_cmnd(InterleavedArrays), or -_cmnd(PixelStore) is not allowed after a call to _cmnd(Begin) and before -the corresponding call to _cmnd(End), -but an error may or may not be generated. -.SH SEE ALSO -_cmnd(ArrayElement), -_cmnd(CallList), -_cmnd(CallLists), -_cmnd(Color), -_cmnd(EdgeFlag), -_cmnd(EvalCoord), -.br -_cmnd(EvalPoint), -_cmnd(Index), -_cmnd(Material), -_cmnd(Normal), -_cmnd(TexCoord), -_cmnd(Vertex) - - |