aboutsummaryrefslogtreecommitdiff
path: root/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texenv.gl
diff options
context:
space:
mode:
Diffstat (limited to 'nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texenv.gl')
-rw-r--r--nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texenv.gl183
1 files changed, 0 insertions, 183 deletions
diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texenv.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texenv.gl
deleted file mode 100644
index f33860972..000000000
--- a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texenv.gl
+++ /dev/null
@@ -1,183 +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(TexEnv, set texture environment parameters)
-_names(TexEnv,[fi])
-.EQ
-delim $$
-.EN
-.SH PARAMETERS
-_phead(_param1)
-Specifies a texture environment.
-Must be _const(TEXTURE_ENV).
-_phead(_param2)
-Specifies the symbolic name of a single-valued texture environment parameter.
-Must be _const(TEXTURE_ENV_MODE).
-_phead(_param3)
-Specifies a single symbolic constant, one of _const(MODULATE),
-_const(DECAL), _const(BLEND), or _const(REPLACE).
-_names(TexEnv,[fi]v)
-.SH PARAMETERS
-_phead(_param1)
-Specifies a texture environment.
-Must be _const(TEXTURE_ENV).
-_phead(_param2)
-Specifies the symbolic name of a texture environment parameter.
-Accepted values are _const(TEXTURE_ENV_MODE) and _const(TEXTURE_ENV_COLOR).
-_phead(_param3)
-Specifies a pointer to a parameter array that contains
-either a single symbolic constant or an RGBA color.
-.SH DESCRIPTION
-A texture environment specifies how texture values are interpreted
-when a fragment is textured.
-_param1 must be _const(TEXTURE_ENV).
-_param2 can be either _const(TEXTURE_ENV_MODE) or _const(TEXTURE_ENV_COLOR).
-.P
-If _param2 is _const(TEXTURE_ENV_MODE),
-then _param3 is (or points to) the symbolic name of a texture function.
-Four texture functions may be specified:
-_const(MODULATE),
-_const(DECAL),
-_const(BLEND), and
-_const(REPLACE).
-.P
-A texture function acts on the fragment to be textured using
-the texture image value that applies to the fragment
-(see _cmnd(TexParameter))
-and produces an RGBA color for that fragment.
-The following table shows how the RGBA color is produced for each
-of the three texture functions that can be chosen.
-$C$ is a triple of color values (RGB) and $A$ is the associated alpha value.
-RGBA values extracted from a texture image are in the range [0,1].
-The subscript $f$ refers to the incoming fragment,
-the subscript $t$ to the texture image,
-the subscript $c$ to the texture environment color,
-and subscript $v$ indicates a value produced by the texture function.
-.P
-A texture image can have up to four components per texture element
-(see _cmnd(TexImage1D), _cmnd(TexImage2D), _cmnd(TexImage3D),
-_cmnd(CopyTexImage1D), and _cmnd(CopyTexImage2D)).
-In a one-component image,
-$L sub t$ indicates that single component.
-A two-component image uses $L sub t$ and $A sub t$.
-A three-component image has only a color value, $C sub t$.
-A four-component image has both a color value $C sub t$
-and an alpha value $A sub t$.
-.sp
-.ne
-.TS
-center tab(:) ;
-cb cb s s s
-ci c c c c
-c c c c c.
-_
-Base internal:Texture functions
-format:_const(MODULATE):_const(DECAL):_const(BLEND):_const(REPLACE)
-_
-_const(ALPHA):$C sub v ~=~ C sub f$:undefined:$C sub v ~=~ C sub f$:$C sub v ~=~ C sub f$
-\^ :$A sub v ~=~ A sub f A sub t$:\^:$A sub v ~=~ A sub f$:$A sub v ~=~ A sub t$
-_
-_const(LUMINANCE):$C sub v ~=~ L sub t C sub f$:undefined:$C sub v ~=~ ( 1 - L sub t ) C sub f$:$C sub v ~=~ L sub t$
-: : :$+ L sub t C sub c$:
-1: $A sub v ~=~ A sub f$:\^: $A sub v ~=~ A sub f$:$A sub v ~=~ A sub f$
-_
-_const(LUMINANCE):$C sub v ~=~ L sub t C sub f$:undefined:$C sub v ~=~ ( 1 - L sub t ) C sub f $:$C sub v ~=~ L sub t$
-\\f3_ALPHA\fP: : : $+ L sub t C sub c$
-2:$A sub v ~=~ A sub t A sub f$:\^:$A sub v ~=~ A sub t A sub f$:$A sub v ~=~ A sub t$
-_
-_const(INTENSITY):$C sub v ~=~ C sub f I sub t$:undefined:$C sub v ~=~ ( 1 - I sub t ) C sub f$ :$C sub v ~=~ I sub t$
-: : :$+ I sub t C sub c$
-c\^ :$A sub v ~=~ A sub f I sub t$:\^:$A sub v ~=~ ( 1 - I sub t ) A sub f $:$A sub v ~=~ I sub t$
-: : :$+ I sub t A sub c$:
-_
-_const(RGB):$C sub v ~=~ C sub t C sub f$:$C sub v ~=~ C sub t$:$C sub v ~=~ (1 - C sub t) C sub f $:$C sub v ~=~ C sub t$
-: : : $+ C sub t C sub c$
-3:$A sub v ~=~ A sub f$:$A sub v ~=~ A sub f$:$A sub v ~=~ A sub f$:$A sub v ~=~ A sub f$
-_
-_const(RGBA):$C sub v ~=~ C sub t C sub f$:$C sub v ~=~ ( 1 - A sub t ) C sub f $:$C sub v ~=~ (1 - C sub t) C sub f $:$C sub v ~=~ C sub t$
-: :$+ A sub t C sub t$: $+ C sub t C sub c$
-4:$A sub v ~=~ A sub t A sub f$:$A sub v ~=~ A sub f$:$A sub v ~=~ A sub t A sub f$:$A sub v ~=~ A sub t$
-_
-.TE
-.bp
-If _param2 is _const(TEXTURE_ENV_COLOR),
-_param3 is a pointer to an array that holds an RGBA color consisting of four
-values.
-Integer color components are interpreted linearly such that the most
-positive integer maps to 1.0,
-and the most negative integer maps to -1.0.
-The values are clamped to the range [0,1] when they are specified.
-$C sub c$ takes these four values.
-.P
-_const(TEXTURE_ENV_MODE) defaults to _const(MODULATE) and
-_const(TEXTURE_ENV_COLOR) defaults to (0, 0, 0, 0).
-.SH NOTES
-_const(REPLACE) may only be used if the GL version is 1.1 or greater.
-.P
-Internal formats other than 1, 2, 3, or 4 may only be used if the GL
-version is 1.1 or greater.
-.P
-When the _arbstring(multitexture) extension is supported, _cmnd controls
-the texture environment for the current active texture unit, selected by
-_cmnd(ActiveTextureARB).
-.sh ERRORS
-_const(INVALID_ENUM) is generated when _param1 or _param2 is not
-one of the accepted defined values,
-or when _param3 should have a defined constant value
-(based on the value of _param2)
-and does not.
-.P
-_const(INVALID_OPERATION) is generated if _cmnd
-is executed between the execution of _cmnd(Begin)
-and the corresponding execution of _cmnd(End).
-.SH ASSOCIATED GETS
-_cmnd(GetTexEnv)
-.SH SEE ALSO
-_cmnd(ActiveTextureARB),
-_cmnd(CopyPixels),
-_cmnd(CopyTexImage1D),
-_cmnd(CopyTexImage2D),
-_cmnd(CopyTexSubImage1D),
-_cmnd(CopyTexSubImage2D),
-_cmnd(CopyTexSubImage3D),
-_cmnd(TexImage1D),
-_cmnd(TexImage2D),
-_cmnd(TexImage3D),
-_cmnd(TexParameter),
-_cmnd(TexSubImage1D),
-_cmnd(TexSubImage2D),
-_cmnd(TexSubImage3D)
-