aboutsummaryrefslogtreecommitdiff
path: root/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelmap.gl
diff options
context:
space:
mode:
Diffstat (limited to 'nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelmap.gl')
-rw-r--r--nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelmap.gl250
1 files changed, 0 insertions, 250 deletions
diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelmap.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelmap.gl
deleted file mode 100644
index 9b3ddca84..000000000
--- a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelmap.gl
+++ /dev/null
@@ -1,250 +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(PixelMap,set up pixel transfer maps)
-_names(PixelMap,u*[fis]v)
-.EQ
-delim $$
-.EN
-.SH PARAMETERS
-_phead(_param1)
-.na
-Specifies a symbolic map name.
-Must be one of the following:
-_const(PIXEL_MAP_I_TO_I),
-_const(PIXEL_MAP_S_TO_S),
-_const(PIXEL_MAP_I_TO_R),
-_const(PIXEL_MAP_I_TO_G),
-_const(PIXEL_MAP_I_TO_B),
-_const(PIXEL_MAP_I_TO_A),
-_const(PIXEL_MAP_R_TO_R),
-_const(PIXEL_MAP_G_TO_G),
-_const(PIXEL_MAP_B_TO_B), or
-_const(PIXEL_MAP_A_TO_A).
-_phead(_param2)
-Specifies the size of the map being defined.
-_phead(_param3)
-Specifies an array of _param2 values.
-.SH DESCRIPTION
-_cmnd sets up translation tables,
-or \f2maps\fP,
-used by
-_cmnd(CopyPixels),
-_cmnd(CopyTexImage1D),
-_cmnd(CopyTexImage2D),
-_cmnd(CopyTexSubImage1D),
-_cmnd(CopyTexSubImage2D),
-_cmnd(CopyTexSubImage3D),
-_cmnd(DrawPixels),
-_cmnd(ReadPixels),
-_cmnd(TexImage1D),
-_cmnd(TexImage2D),
-_cmnd(TexImage3D),
-_cmnd(TexSubImage1D),
-_cmnd(TexSubImage2D), and
-_cmnd(TexSubImage3D).
-Additionally, if the _arbstring(imaging) subset is supported, the
-routines
-_cmnd(ColorTable),
-_cmnd(ColorSubTable),
-_cmnd(ConvolutionFilter1D),
-_cmnd(ConvolutionFilter2D),
-_cmnd(Histogram),
-_cmnd(Minmax), and
-_cmnd(SeparableFilter2D).
-Use of these maps is described completely in the
-_cmnd(PixelTransfer) reference page,
-and partly in the reference pages for the pixel and texture image commands.
-Only the specification of the maps is described in this reference page.
-.P
-_param1 is a symbolic map name,
-indicating one of ten maps to set.
-_param2 specifies the number of entries in the map,
-and _param3 is a pointer to an array of _param2 map values.
-.P
-The ten maps are as follows:
-.TP 30
-_const(PIXEL_MAP_I_TO_I)
-Maps color indices to color indices.
-.TP
-_const(PIXEL_MAP_S_TO_S)
-Maps stencil indices to stencil indices.
-.TP
-_const(PIXEL_MAP_I_TO_R)
-Maps color indices to red components.
-.TP
-_const(PIXEL_MAP_I_TO_G)
-Maps color indices to green components.
-.TP
-_const(PIXEL_MAP_I_TO_B)
-Maps color indices to blue components.
-.TP
-_const(PIXEL_MAP_I_TO_A)
-Maps color indices to alpha components.
-.TP
-_const(PIXEL_MAP_R_TO_R)
-Maps red components to red components.
-.TP
-_const(PIXEL_MAP_G_TO_G)
-Maps green components to green components.
-.TP
-_const(PIXEL_MAP_B_TO_B)
-Maps blue components to blue components.
-.TP
-_const(PIXEL_MAP_A_TO_A)
-Maps alpha components to alpha components.
-.P
-The entries in a map can be specified as single-precision
-floating-point numbers,
-unsigned short integers,
-or unsigned long integers.
-Maps that store color component values
-(all but _const(PIXEL_MAP_I_TO_I) and _const(PIXEL_MAP_S_TO_S))
-retain their values in floating-point format,
-with unspecified mantissa and exponent sizes.
-Floating-point values specified by _cmnd(PixelMapfv) are converted directly
-to the internal floating-point format of these maps,
-then clamped to the range [0,1].
-Unsigned integer values specified by _cmnd(PixelMapusv) and
-_cmnd(PixelMapuiv) are converted linearly such that
-the largest representable integer maps to 1.0,
-and 0 maps to 0.0.
-.P
-Maps that store indices,
-_const(PIXEL_MAP_I_TO_I) and _const(PIXEL_MAP_S_TO_S),
-retain their values in fixed-point format,
-with an unspecified number of bits to the right of the binary point.
-Floating-point values specified by _cmnd(PixelMapfv) are converted directly
-to the internal fixed-point format of these maps.
-Unsigned integer values specified by _cmnd(PixelMapusv) and
-_cmnd(PixelMapuiv) specify integer values,
-with all 0's to the right of the binary point.
-.P
-The following table shows the initial sizes and values for each of the maps.
-Maps that are indexed by either color or stencil indices must have
-_param2 = $2 sup n$ for some $n$ or the results are undefined.
-The maximum allowable size for each map depends on the implementation
-and can be determined by calling _cmnd(Get) with argument
-_const(MAX_PIXEL_MAP_TABLE).
-The single maximum applies to all maps; it is at
-least 32.
-.bp
-.TS
-center tab(:) delim($$) ;
-lb cb cb cb cb
-l c c c c.
-_
-_param1:Lookup Index:Lookup Value:Initial Size:Initial Value
-_
-_const(PIXEL_MAP_I_TO_I):color index:color index:1:0
-_const(PIXEL_MAP_S_TO_S):stencil index :stencil index :1:0
-_const(PIXEL_MAP_I_TO_R):color index :R:1:0
-_const(PIXEL_MAP_I_TO_G):color index :G:1:0
-_const(PIXEL_MAP_I_TO_B):color index:B:1:0
-_const(PIXEL_MAP_I_TO_A):color index:A:1:0
-_const(PIXEL_MAP_R_TO_R):R:R:1:0
-_const(PIXEL_MAP_G_TO_G):G:G:1:0
-_const(PIXEL_MAP_B_TO_B):B:B:1:0
-_const(PIXEL_MAP_A_TO_A):A:A:1:0
-_
-.TE
-
-.RE
-.SH ERRORS
-_const(INVALID_ENUM) is generated if _param1 is not an accepted value.
-.P
-_const(INVALID_VALUE) is generated if _param2 is less than one
-or larger than _const(MAX_PIXEL_MAP_TABLE).
-.P
-_const(INVALID_VALUE) is generated if _param1 is
-_const(PIXEL_MAP_I_TO_I),
-_const(PIXEL_MAP_S_TO_S),
-_const(PIXEL_MAP_I_TO_R),
-_const(PIXEL_MAP_I_TO_G),
-_const(PIXEL_MAP_I_TO_B), or
-_const(PIXEL_MAP_I_TO_A),
-and _param2 is not a power of two.
-.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(GetPixelMap)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_I_TO_I_SIZE)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_S_TO_S_SIZE)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_I_TO_R_SIZE)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_I_TO_G_SIZE)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_I_TO_B_SIZE)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_I_TO_A_SIZE)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_R_TO_R_SIZE)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_G_TO_G_SIZE)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_B_TO_B_SIZE)
-.br
-_cmnd(Get) with argument _const(PIXEL_MAP_A_TO_A_SIZE)
-.br
-_cmnd(Get) with argument _const(MAX_PIXEL_MAP_TABLE)
-.SH SEE ALSO
-_cmnd(ColorTable),
-_cmnd(ColorSubTable),
-_cmnd(ConvolutionFilter1D),
-_cmnd(ConvolutionFilter2D),
-_cmnd(CopyPixels),
-_cmnd(CopyTexImage1D),
-_cmnd(CopyTexImage2D),
-_cmnd(CopyTexSubImage1D),
-_cmnd(CopyTexSubImage2D),
-_cmnd(DrawPixels),
-_cmnd(Histogram),
-_cmnd(Minmax),
-_cmnd(PixelStore),
-_cmnd(PixelTransfer),
-_cmnd(ReadPixels),
-_cmnd(SeparableFilter2D),
-_cmnd(TexImage1D),
-_cmnd(TexImage2D),
-_cmnd(TexImage3D),
-_cmnd(TexSubImage1D),
-_cmnd(TexSubImage2D),
-_cmnd(TexSubImage3D)