diff options
author | Reinhard Tartler <siretart@tauware.de> | 2011-10-10 17:43:39 +0200 |
---|---|---|
committer | Reinhard Tartler <siretart@tauware.de> | 2011-10-10 17:43:39 +0200 |
commit | f4092abdf94af6a99aff944d6264bc1284e8bdd4 (patch) | |
tree | 2ac1c9cc16ceb93edb2c4382c088dac5aeafdf0f /nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalcoord.gl | |
parent | a840692edc9c6d19cd7c057f68e39c7d95eb767d (diff) | |
download | nx-libs-f4092abdf94af6a99aff944d6264bc1284e8bdd4.tar.gz nx-libs-f4092abdf94af6a99aff944d6264bc1284e8bdd4.tar.bz2 nx-libs-f4092abdf94af6a99aff944d6264bc1284e8bdd4.zip |
Imported nx-X11-3.1.0-1.tar.gznx-X11/3.1.0-1
Summary: Imported nx-X11-3.1.0-1.tar.gz
Keywords:
Imported nx-X11-3.1.0-1.tar.gz
into Git repository
Diffstat (limited to 'nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalcoord.gl')
-rw-r--r-- | nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalcoord.gl | 208 |
1 files changed, 208 insertions, 0 deletions
diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalcoord.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalcoord.gl new file mode 100644 index 000000000..bf4e76425 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalcoord.gl @@ -0,0 +1,208 @@ +_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(EvalCoord,evaluate enabled one- and two-dimensional maps) +.EQ +delim $$ +.EN +_names(EvalCoord,[1-2][fd]) +.SH PARAMETERS +_phead(_param1) +Specifies a value that is the domain coordinate $u$ to the basis function +defined in a previous _cmnd(Map1) or _cmnd(Map2) command. +_phead(_param2) +Specifies a value that is the domain coordinate $v$ to the basis function +defined in a previous _cmnd(Map2) command. +This argument is not present in a _cmnd(EvalCoord1) command. +_names(EvalCoord,[1-2][fd]v) +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to an array containing +either one or two domain coordinates. +The first coordinate is $u$. +The second coordinate is $v$, +which is present only in _cmnd(EvalCoord2) versions. +.SH DESCRIPTION +_cmnd(EvalCoord1) evaluates enabled one-dimensional maps at argument +_param1(1). +_cmnd(EvalCoord2) does the same for two-dimensional maps using +two domain values, +_param1(1) and _param2(1). +To define a map, call _cmnd(Map1) and _cmnd(Map2); to enable and +disable it, call _cmnd(Enable) and _cmnd(Disable). +.P +When one of the _cmnd(EvalCoord) commands is issued, +all currently enabled maps of the indicated dimension are evaluated. +Then, +for each enabled map, +it is as if the corresponding GL command had been issued with the +computed value. +That is, +if _const(MAP1_INDEX) or +_const(MAP2_INDEX) is enabled, +a _cmnd(Index) command is simulated. +If _const(MAP1_COLOR_4) or +_const(MAP2_COLOR_4) is enabled, +a _cmnd(Color) command is simulated. +If _const(MAP1_NORMAL) or _const(MAP2_NORMAL) is enabled, +a normal vector is produced, +and if any of +_const(MAP1_TEXTURE_COORD_1), +_const(MAP1_TEXTURE_COORD_2), +_const(MAP1_TEXTURE_COORD_3), +_const(MAP1_TEXTURE_COORD_4), +_const(MAP2_TEXTURE_COORD_1), +_const(MAP2_TEXTURE_COORD_2), +_const(MAP2_TEXTURE_COORD_3), or +_const(MAP2_TEXTURE_COORD_4) is enabled, then an appropriate _cmnd(TexCoord) command is simulated. +.P +For color, +color index, +normal, +and texture coordinates the GL uses evaluated values instead of current values for those evaluations +that are enabled, +and current values otherwise, +However, +the evaluated values do not update the current values. +Thus, if _cmnd(Vertex) commands are interspersed with _cmnd(EvalCoord) +commands, the color, +normal, +and texture coordinates associated with the _cmnd(Vertex) commands are not +affected by the values generated by the _cmnd(EvalCoord) commands, +but only by the most recent +_cmnd(Color), +_cmnd(Index), +_cmnd(Normal), and +_cmnd(TexCoord) commands. +.P +No commands are issued for maps that are not enabled. +If more than one texture evaluation is enabled for a particular dimension +(for example, _const(MAP2_TEXTURE_COORD_1) and +_const(MAP2_TEXTURE_COORD_2)), +then only the evaluation of the map that produces the larger +number of coordinates +(in this case, _const(MAP2_TEXTURE_COORD_2)) +is carried out. +_const(MAP1_VERTEX_4) overrides _const(MAP1_VERTEX_3), +and +_const(MAP2_VERTEX_4) overrides _const(MAP2_VERTEX_3), +in the same manner. +If neither a three- nor a four-component vertex map is enabled for the +specified dimension, +the _cmnd(EvalCoord) command is ignored. +.P +If you have enabled automatic normal generation, +by calling _cmnd(Enable) with argument _const(AUTO_NORMAL), +_cmnd(EvalCoord2) generates surface normals analytically, +regardless of the contents or enabling of the _const(MAP2_NORMAL) map. +Let +.sp +.ce +.EQ +bold m ~=~ {partial bold p} over {partial u} ~times~ + {partial bold p} over {partial v} +.EN +.ce 0 +.sp +.br +Then the generated normal $ bold n $ is +.br +.ce +$bold n ~=~ bold m over { || bold m || }$ +.ce 0 +.sp +.br +If automatic normal generation is disabled, +the corresponding normal map _const(MAP2_NORMAL), +if enabled, +is used to produce a normal. +If neither automatic normal generation nor a normal map is enabled, +no normal is generated for +_cmnd(EvalCoord2) commands. +.SH ASSOCIATED GETS +.nf +_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) +.br +_cmnd(IsEnabled) with argument _const(MAP2_VERTEX_3) +.br +_cmnd(IsEnabled) with argument _const(MAP2_VERTEX_4) +.br +_cmnd(IsEnabled) with argument _const(MAP2_INDEX) +.br +_cmnd(IsEnabled) with argument _const(MAP2_COLOR_4) +.br +_cmnd(IsEnabled) with argument _const(MAP2_NORMAL) +.br +_cmnd(IsEnabled) with argument _const(MAP2_TEXTURE_COORD_1) +.br +_cmnd(IsEnabled) with argument _const(MAP2_TEXTURE_COORD_2) +.br +_cmnd(IsEnabled) with argument _const(MAP2_TEXTURE_COORD_3) +.br +_cmnd(IsEnabled) with argument _const(MAP2_TEXTURE_COORD_4) +.br +_cmnd(IsEnabled) with argument _const(AUTO_NORMAL) +.br +_cmnd(GetMap) +.SH SEE ALSO +_cmnd(Begin), +_cmnd(Color), +_cmnd(Enable), +_cmnd(EvalMesh), +_cmnd(EvalPoint), +_cmnd(Index), +_cmnd(Map1), +_cmnd(Map2), +_cmnd(MapGrid), +_cmnd(Normal), +_cmnd(TexCoord), +_cmnd(Vertex) |