diff options
author | Mike Gabriel <mike.gabriel@das-netzwerkteam.de> | 2015-02-02 15:02:49 +0100 |
---|---|---|
committer | Mike Gabriel <mike.gabriel@das-netzwerkteam.de> | 2015-02-02 15:02:49 +0100 |
commit | b16b9e4656e7199c2aec74a4c8ebc7a875d3ba73 (patch) | |
tree | 4361edef0d42d5bf5ac984ef72b4fac35426eae7 /nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map1.gl | |
parent | 0d5a83e986f39982c0924652a3662e60b1f23162 (diff) | |
download | nx-libs-b16b9e4656e7199c2aec74a4c8ebc7a875d3ba73.tar.gz nx-libs-b16b9e4656e7199c2aec74a4c8ebc7a875d3ba73.tar.bz2 nx-libs-b16b9e4656e7199c2aec74a4c8ebc7a875d3ba73.zip |
massive reduction of unneeded files
Diffstat (limited to 'nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map1.gl')
-rw-r--r-- | nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map1.gl | 268 |
1 files changed, 0 insertions, 268 deletions
diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map1.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map1.gl deleted file mode 100644 index c5d847a7f..000000000 --- a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map1.gl +++ /dev/null @@ -1,268 +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_ -_C_ eqn is automatically replaced with neqn for nroff -_header(Map1,define a one-dimensional evaluator) -_names(Map1,[fd]) -.EQ -delim $$ -.EN -.SH PARAMETERS -_phead(_param1) -Specifies the kind of values that are generated by the evaluator. -Symbolic constants -_const(MAP1_VERTEX_3), -_const(MAP1_VERTEX_4), -_const(MAP1_INDEX), -_const(MAP1_COLOR_4), -_const(MAP1_NORMAL), -_const(MAP1_TEXTURE_COORD_1), -_const(MAP1_TEXTURE_COORD_2), -_const(MAP1_TEXTURE_COORD_3), and -_const(MAP1_TEXTURE_COORD_4) are accepted. -_phead(_param2 _param3) -Specify a linear mapping of $u$, -as presented to _cmnd(EvalCoord1), -to $u hat$, -the variable that is evaluated by the equations specified by this command. -_phead(_param4) -Specifies the number of floats or doubles between -the beginning of one control point and the beginning of the next one -in the data structure referenced in _param6. -This allows control points to be embedded in arbitrary data structures. -The only constraint is that the values for a particular control point -must occupy contiguous memory locations. -_phead(_param5) -Specifies the number of control points. -Must be positive. -_phead(_param6) -Specifies a pointer to the array of control points. - -.SH DESCRIPTION -Evaluators provide a way to use polynomial or rational polynomial mapping -to produce vertices, -normals, -texture coordinates, -and colors. -The values produced by an evaluator are sent to further stages -of GL processing just as if they had been presented using -_cmnd(Vertex), -_cmnd(Normal), -_cmnd(TexCoord), and -_cmnd(Color) commands, -except that the generated values do not update the current normal, -texture coordinates, -or color. -.P -All polynomial or rational polynomial splines of any degree -(up to the maximum degree supported by the GL implementation) -can be described using evaluators. -These include almost all splines used in computer graphics: B-splines, -Bezier curves, Hermite splines, and so on. -.P -Evaluators define curves based on Bernstein polynomials. -Define $p ( u hat ^) $ as -.sp -.ce -$p ( u hat ^) ~~=~~ up 10 { sum from i=0 to n } B sub i sup n ( u hat ^) R sub i$ -.sp -where -$R sub i$ -is a control point and -$B sub i sup n ( u hat ^)$ -is the $i$th Bernstein polynomial of degree $n$ (_param5 = $n ~+~ 1$): -.sp -.ce -$B sub i sup n ( u hat ^) ~~=~~ left ( down 20 {cpile { n above i }} ~~ right ) u hat sup i ( 1 - u hat ^) sup { n - i }$ -.sp -Recall that -.sp -.ce -$0 sup 0 ~==~ 1 $ and $ left ( down 20 {cpile { n above ~0 }} ~~ right ) ~~==~~ 1 $ -.P -_cmnd is used to define the basis and to specify what kind of values -are produced. -Once defined, -a map can be enabled and disabled by calling _cmnd(Enable) and _cmnd(Disable) -with the map name, one of the nine predefined values for _param1 -described below. -_cmnd(EvalCoord1) evaluates the one-dimensional maps that are enabled. -When -.br -_cmnd(EvalCoord1) presents a value $u$, -the Bernstein functions are evaluated using $u hat$, where -.br - -.ce -$u hat ~~=~~ {u ~-~ _eqnparam2} over {_eqnparam3 ~-~ _eqnparam2}$ - -.br -.P -_param1 is a symbolic constant that indicates what kind of control points -are provided in _param6, -and what output is generated when the map is evaluated. -It can assume one of nine predefined values: -.TP 25 -_const(MAP1_VERTEX_3) -Each control point is three floating-point values representing -$x$, $y$, and $z$. -Internal _cmnd(Vertex3) commands are generated when the map is evaluated. -.TP -_const(MAP1_VERTEX_4) -Each control point is four floating-point values representing -$x$, $y$, $z$, and $w$. -Internal _cmnd(Vertex4) commands are generated when the map is evaluated. -.TP -_const(MAP1_INDEX) -Each control point is a single floating-point value representing a color index. -Internal _cmnd(Index) commands are generated when the map is evaluated -but the current index is not updated with the value of these _cmnd(Index) -commands. -.TP -_const(MAP1_COLOR_4) -Each control point is four floating-point values representing -red, green, blue, and alpha. -Internal _cmnd(Color4) commands are generated when the map is -evaluated but the current color is not updated with the value of these -_cmnd(Color4) commands. -.TP -_const(MAP1_NORMAL) -Each control point is three floating-point values representing -the $x$, $y$, and $z$ components of a normal vector. -Internal _cmnd(Normal) commands are generated when the map is -evaluated but the current normal is not updated with the value of -these _cmnd(Normal) commands. -.TP -_const(MAP1_TEXTURE_COORD_1) -Each control point is a single floating-point value representing -the $s$ texture coordinate. -Internal -.br -_cmnd(TexCoord1) commands are generated when the map is -evaluated but the current texture coordinates are not updated with the value -of these _cmnd(TexCoord) commands. -.TP -_const(MAP1_TEXTURE_COORD_2) -Each control point is two floating-point values representing -the $s$ and $t$ texture coordinates. -Internal -.br -_cmnd(TexCoord2) commands are generated when the map is -evaluated but the current texture coordinates are not updated with the value -of these _cmnd(TexCoord) commands. -.TP -_const(MAP1_TEXTURE_COORD_3) -Each control point is three floating-point values representing -the $s$, $t$, and $r$ texture coordinates. -Internal _cmnd(TexCoord3) commands are generated when the map is -evaluated but the current texture coordinates are not updated with the value -of these _cmnd(TexCoord) commands. -.TP -_const(MAP1_TEXTURE_COORD_4) -Each control point is four floating-point values representing -the $s$, $t$, $r$, and $q$ texture coordinates. -Internal -.br -_cmnd(TexCoord4) commands are generated when the map is evaluated but -the current texture coordinates are not updated with the value -of these _cmnd(TexCoord) commands. -.P -_param4, -_param5, and -_param6 define the array addressing for accessing the control points. -_param6 is the location of the first control point, -which occupies one, two, three, or four contiguous memory locations, -depending on which map is being defined. -_param5 is the number of control points in the array. -_param4 specifies how many float or double locations to advance the internal -memory pointer to reach the next control point. -.SH NOTES -As is the case with all GL commands that accept pointers to data, -it is as if the contents of _param6 were copied by _cmnd before _cmnd -returns. -Changes to the contents of _param6 have no effect after _cmnd is called. -.SH ERRORS -_const(INVALID_ENUM) is generated if _param1 is not an accepted value. -.P -_const(INVALID_VALUE) is generated if _param2 is equal to _param3. -.P -_const(INVALID_VALUE) is generated if _param4 is less than the number -of values in a control point. -.P -_const(INVALID_VALUE) is generated if _param5 is less than 1 or -greater than the return value of _const(MAX_EVAL_ORDER). -.P -_const(INVALID_OPERATION) is generated if _cmnd -is executed between the execution of -_cmnd(Begin) -and the corresponding execution of _cmnd(End). -.P -When the _arbstring(multitexture) extension is supported, -_const(INVALID_OPERATION) is generated if _cmnd is called and the value -of _arbconst(ACTIVE_TEXTURE) is not _arbconst(TEXTURE0). -.SH ASSOCIATED GETS -_cmnd(GetMap) -.br -_cmnd(Get) with argument _const(MAX_EVAL_ORDER) -.br -_cmnd(IsEnabled) with argument _const(MAP1_VERTEX_3) -.br -_cmnd(IsEnabled) with argument _const(MAP1_VERTEX_4) -.br -_cmnd(IsEnabled) with argument _const(MAP1_INDEX) -.br -_cmnd(IsEnabled) with argument _const(MAP1_COLOR_4) -.br -_cmnd(IsEnabled) with argument _const(MAP1_NORMAL) -.br -_cmnd(IsEnabled) with argument _const(MAP1_TEXTURE_COORD_1) -.br -_cmnd(IsEnabled) with argument _const(MAP1_TEXTURE_COORD_2) -.br -_cmnd(IsEnabled) with argument _const(MAP1_TEXTURE_COORD_3) -.br -_cmnd(IsEnabled) with argument _const(MAP1_TEXTURE_COORD_4) -.SH SEE ALSO -_cmnd(Begin), -_cmnd(Color), -_cmnd(Enable), -_cmnd(EvalCoord), -_cmnd(EvalMesh), -_cmnd(EvalPoint), -_cmnd(Map2), -_cmnd(MapGrid), -_cmnd(Normal), -_cmnd(TexCoord), -_cmnd(Vertex) |