diff options
Diffstat (limited to 'nx-X11/extras/ogl-sample/main/doc/man/mangl/standard')
173 files changed, 27740 insertions, 0 deletions
diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/Distfile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/Distfile new file mode 100644 index 000000000..f720fc3e9 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/Distfile @@ -0,0 +1,142 @@ +# +# + +DISTDIR_SI = /xc/doc/man/GL/gl + +DISTFILES_SI = \ + Imakefile \ + accum.3gl \ + alphafunc.3gl \ + aretexturesresident.3gl \ + arrayelement.3gl \ + begin.3gl \ + bindtexture.3gl \ + bitmap.3gl \ + blendfunc.3gl \ + calllist.3gl \ + calllists.3gl \ + clear.3gl \ + clearaccum.3gl \ + clearcolor.3gl \ + cleardepth.3gl \ + clearindex.3gl \ + clearstencil.3gl \ + clipplane.3gl \ + color.3gl \ + colormask.3gl \ + colormaterial.3gl \ + colorpointer.3gl \ + copypixels.3gl \ + copyteximage1d.3gl \ + copyteximage2d.3gl \ + copytexsubimage1d.3gl \ + copytexsubimage2d.3gl \ + cullface.3gl \ + deletelists.3gl \ + deletetextures.3gl \ + depthfunc.3gl \ + depthmask.3gl \ + depthrange.3gl \ + drawarrays.3gl \ + drawbuffer.3gl \ + drawelements.3gl \ + drawpixels.3gl \ + edgeflag.3gl \ + edgeflagpointer.3gl \ + enable.3gl \ + enableclientstate.3gl \ + evalcoord.3gl \ + evalmesh.3gl \ + evalpoint.3gl \ + feedbackbuffer.3gl \ + finish.3gl \ + flush.3gl \ + fog.3gl \ + frontface.3gl \ + frustum.3gl \ + genlists.3gl \ + gentextures.3gl \ + get.3gl \ + getclipplane.3gl \ + geterror.3gl \ + getlight.3gl \ + getmap.3gl \ + getmaterial.3gl \ + getpixelmap.3gl \ + getpointerv.3gl \ + getpolygonstipple.3gl \ + getstring.3gl \ + gettexenv.3gl \ + gettexgen.3gl \ + getteximage.3gl \ + gettexlevelparameter.3gl \ + gettexparameter.3gl \ + hint.3gl \ + index.3gl \ + indexmask.3gl \ + indexpointer.3gl \ + initnames.3gl \ + interleavedarrays.3gl \ + isenabled.3gl \ + islist.3gl \ + istexture.3gl \ + light.3gl \ + lightmodel.3gl \ + linestipple.3gl \ + linewidth.3gl \ + listbase.3gl \ + loadidentity.3gl \ + loadmatrix.3gl \ + loadname.3gl \ + logicop.3gl \ + map1.3gl \ + map2.3gl \ + mapgrid.3gl \ + material.3gl \ + matrixmode.3gl \ + multmatrix.3gl \ + newlist.3gl \ + normal.3gl \ + normalpointer.3gl \ + ortho.3gl \ + passthrough.3gl \ + pixelmap.3gl \ + pixelstore.3gl \ + pixeltransfer.3gl \ + pixelzoom.3gl \ + pointsize.3gl \ + polygonmode.3gl \ + polygonoffset.3gl \ + polygonstipple.3gl \ + prioritizetextures.3gl \ + pushattrib.3gl \ + pushclientattrib.3gl \ + pushmatrix.3gl \ + pushname.3gl \ + rasterpos.3gl \ + readbuffer.3gl \ + readpixels.3gl \ + rect.3gl \ + rendermode.3gl \ + rotate.3gl \ + scale.3gl \ + scissor.3gl \ + selectbuffer.3gl \ + shademodel.3gl \ + stencilfunc.3gl \ + stencilmask.3gl \ + stencilop.3gl \ + texcoord.3gl \ + texcoordpointer.3gl \ + texenv.3gl \ + texgen.3gl \ + teximage1d.3gl \ + teximage2d.3gl \ + texparameter.3gl \ + texsubimage1d.3gl \ + texsubimage2d.3gl \ + translate.3gl \ + vertex.3gl \ + vertexpointer.3gl \ + viewport.3gl \ + $(NULL) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/GNUmakefile new file mode 100644 index 000000000..d17621346 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/GNUmakefile @@ -0,0 +1,95 @@ +#!gmake +# +# License Applicability. Except to the extent portions of this file are +# made subject to an alternative license as permitted in the SGI Free +# Software License B, Version 1.1 (the "License"), the contents of this +# file are subject only to the provisions of the License. You may not use +# this file except in compliance with the License. You may obtain a copy +# of the License at Silicon Graphics, Inc., attn: Legal Services, 1600 +# Amphitheatre Parkway, Mountain View, CA 94043-1351, or at: +# +# http://oss.sgi.com/projects/FreeB +# +# Note that, as provided in the License, the Software is distributed on an +# "AS IS" basis, with ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS +# DISCLAIMED, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES AND +# CONDITIONS OF MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS FOR A +# PARTICULAR PURPOSE, AND NON-INFRINGEMENT. +# +# Original Code. The Original Code is: OpenGL Sample Implementation, +# Version 1.2.1, released January 26, 2000, developed by Silicon Graphics, +# Inc. The Original Code is Copyright (c) 1991-2000 Silicon Graphics, Inc. +# Copyright in any portions created by third parties is as indicated +# elsewhere herein. All Rights Reserved. +# +# Additional Notice Provisions: The application programming interfaces +# established by SGI in conjunction with the Original Code are The +# OpenGL(R) Graphics System: A Specification (Version 1.2.1), released +# April 1, 1999; The OpenGL(R) Graphics System Utility Library (Version +# 1.3), released November 4, 1998; and OpenGL(R) Graphics with the X +# Window System(R) (Version 1.3), released October 19, 1998. This software +# was created using the OpenGL(R) version 1.2.1 Sample Implementation +# published by SGI, but has not been independently verified as being +# compliant with the OpenGL(R) version 1.2.1 Specification. +# + +# NOTES: +# - The file "lor-c.mn" contains the source for the List of Routines section +# of the C edition of the GL Reference Guide. The usual targets +# lor-c.p, lor-c.ps, and lor-c.psv exist for it; however, it does not have +# a .3g suffix because we don't want to include it as a on-line man page. +# The file should be generated!!! + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +DEPTH = ../.. +LANGOPT = c +PREFIX = gl +IDB_PATH = /usr/catman/g_man/cat3/standard + +MANPREF = man +include $(DEPTH)/mandefs + +APIFILE = $(ROOT)/usr/include/GL/gl.h + +VERSION = Version 1.2 +DATE = 24 September 1999 +RELEASE = 1.2.1 +MMFLAGS = -rs2 +M4OPTS = -B8192 + +LEGALSUF1 = 3g# +LEGALSUF2 = 3g# +LEGALSUF3 = 3g# +LEGALSUF4 = 3g# + +LOCALPRINTLISTFILTER = | sed -e '/^intro\.p$$/d' | (echo intro.p ; cat ) + +default: + $(MAKE) manpages + +headers headers_install libs libs_install apps: + +distsi: default + $(MAKE) $(COMMONPREF)$@ + +distoss: + $(MAKE) $(COMMONPREF)$@ + +manpages: $(patsubst %.gl,%.3gl,$(wildcard *.gl)) + +install: manpages + for file in *.3gl; do \ + install -D -m 644 $$file ${ROOT}/usr/man/man3/gl`basename $$file .3gl`.3gl ; \ + done + +const.diff: const.awk *.gl $(ROOT)/usr/include/GL/gl.h + awk -f const.awk $(ROOT)/usr/include/GL/gl.h *.gl | \ + sort | uniq > const.diff + +clobber: + rm -f *.3gl + +include $(DEPTH)/manrules +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/Imakefile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/Imakefile new file mode 100644 index 000000000..862abd608 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/Imakefile @@ -0,0 +1,874 @@ +XCOMM License Applicability. Except to the extent portions of this file are +XCOMM made subject to an alternative license as permitted in the SGI Free +XCOMM Software License B, Version 1.1 (the "License"), the contents of this +XCOMM file are subject only to the provisions of the License. You may not use +XCOMM this file except in compliance with the License. You may obtain a copy +XCOMM of the License at Silicon Graphics, Inc., attn: Legal Services, 1600 +XCOMM Amphitheatre Parkway, Mountain View, CA 94043-1351, or at: +XCOMM +XCOMM http://oss.sgi.com/projects/FreeB +XCOMM +XCOMM Note that, as provided in the License, the Software is distributed on an +XCOMM "AS IS" basis, with ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS +XCOMM DISCLAIMED, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES AND +XCOMM CONDITIONS OF MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS FOR A +XCOMM PARTICULAR PURPOSE, AND NON-INFRINGEMENT. +XCOMM +XCOMM Original Code. The Original Code is: OpenGL Sample Implementation, +XCOMM Version 1.2.1, released January 26, 2000, developed by Silicon Graphics, +XCOMM Inc. The Original Code is Copyright (c) 1991-2000 Silicon Graphics, Inc. +XCOMM Copyright in any portions created by third parties is as indicated +XCOMM elsewhere herein. All Rights Reserved. +XCOMM +XCOMM Additional Notice Provisions: The application programming interfaces +XCOMM established by SGI in conjunction with the Original Code are The +XCOMM OpenGL(R) Graphics System: A Specification (Version 1.2.1), released +XCOMM April 1, 1999; The OpenGL(R) Graphics System Utility Library (Version +XCOMM 1.3), released November 4, 1998; and OpenGL(R) Graphics with the X +XCOMM Window System(R) (Version 1.3), released October 19, 1998. This software +XCOMM was created using the OpenGL(R) version 1.2.1 Sample Implementation +XCOMM published by SGI, but has not been independently verified as being +XCOMM compliant with the OpenGL(R) version 1.2.1 Specification. +XCOMM + +#ifdef ManPageAlias +#undef ManPageAlias +#endif +#define ManPageAlias(file,destdir,alias) @@\ +alias.$(MANSUFFIX): file.$(MANSUFFIX) @@\ + echo .so `basename destdir`/file.$(MANSUFFIX) > alias.$(MANSUFFIX) @@\ + +MANSUFFIX = 3gl + +MAN_PAGES = \ +glAccum.$(MANSUFFIX) glAlphaFunc.$(MANSUFFIX) \ +glAreTexturesResident.$(MANSUFFIX) glArrayElement.$(MANSUFFIX) \ +glBegin.$(MANSUFFIX) glBindTexture.$(MANSUFFIX) \ +glBitmap.$(MANSUFFIX) glBlendColorEXT.$(MANSUFFIX) \ +glBlendFunc.$(MANSUFFIX) glCallList.$(MANSUFFIX) \ +glCallLists.$(MANSUFFIX) glClear.$(MANSUFFIX) \ +glClearAccum.$(MANSUFFIX) glClearColor.$(MANSUFFIX) \ +glClearDepth.$(MANSUFFIX) glClearIndex.$(MANSUFFIX) \ +glClearStencil.$(MANSUFFIX) glClipPlane.$(MANSUFFIX) \ +glColor3b.$(MANSUFFIX) glColor3bv.$(MANSUFFIX) \ +glColor3d.$(MANSUFFIX) glColor3dv.$(MANSUFFIX) \ +glColor3f.$(MANSUFFIX) glColor3fv.$(MANSUFFIX) \ +glColor3i.$(MANSUFFIX) glColor3iv.$(MANSUFFIX) \ +glColor3s.$(MANSUFFIX) glColor3sv.$(MANSUFFIX) \ +glColor3ub.$(MANSUFFIX) glColor3ubv.$(MANSUFFIX) \ +glColor3ui.$(MANSUFFIX) glColor3uiv.$(MANSUFFIX) \ +glColor3us.$(MANSUFFIX) glColor3usv.$(MANSUFFIX) \ +glColor4b.$(MANSUFFIX) glColor4bv.$(MANSUFFIX) \ +glColor4d.$(MANSUFFIX) glColor4dv.$(MANSUFFIX) \ +glColor4f.$(MANSUFFIX) glColor4fv.$(MANSUFFIX) \ +glColor4i.$(MANSUFFIX) glColor4iv.$(MANSUFFIX) \ +glColor4s.$(MANSUFFIX) glColor4sv.$(MANSUFFIX) \ +glColor4ub.$(MANSUFFIX) glColor4ubv.$(MANSUFFIX) \ +glColor4ui.$(MANSUFFIX) glColor4uiv.$(MANSUFFIX) \ +glColor4us.$(MANSUFFIX) glColor4usv.$(MANSUFFIX) \ +glColorMask.$(MANSUFFIX) glColorMaterial.$(MANSUFFIX) \ +glColorPointer.$(MANSUFFIX) glCopyPixels.$(MANSUFFIX) \ +glCopyTexImage1D.$(MANSUFFIX) glCopyTexImage2D.$(MANSUFFIX) \ +glCopyTexSubImage1D.$(MANSUFFIX) glCopyTexSubImage2D.$(MANSUFFIX) \ +glCullFace.$(MANSUFFIX) glDeleteLists.$(MANSUFFIX) \ +glDeleteTextures.$(MANSUFFIX) glDepthFunc.$(MANSUFFIX) \ +glDepthMask.$(MANSUFFIX) glDepthRange.$(MANSUFFIX) \ +glDisable.$(MANSUFFIX) glDisableClientState.$(MANSUFFIX) \ +glDrawArrays.$(MANSUFFIX) glDrawBuffer.$(MANSUFFIX) \ +glDrawElements.$(MANSUFFIX) glDrawPixels.$(MANSUFFIX) \ +glEdgeFlag.$(MANSUFFIX) glEdgeFlagPointer.$(MANSUFFIX) \ +glEdgeFlagv.$(MANSUFFIX) glEnable.$(MANSUFFIX) \ +glEnableClientState.$(MANSUFFIX) glEnd.$(MANSUFFIX) \ +glEndList.$(MANSUFFIX) glEvalCoord1d.$(MANSUFFIX) \ +glEvalCoord1dv.$(MANSUFFIX) glEvalCoord1f.$(MANSUFFIX) \ +glEvalCoord1fv.$(MANSUFFIX) glEvalCoord2d.$(MANSUFFIX) \ +glEvalCoord2dv.$(MANSUFFIX) glEvalCoord2f.$(MANSUFFIX) \ +glEvalCoord2fv.$(MANSUFFIX) glEvalMesh1.$(MANSUFFIX) \ +glEvalMesh2.$(MANSUFFIX) glEvalPoint1.$(MANSUFFIX) \ +glEvalPoint2.$(MANSUFFIX) glFeedbackBuffer.$(MANSUFFIX) \ +glFinish.$(MANSUFFIX) glFlush.$(MANSUFFIX) \ +glFogf.$(MANSUFFIX) glFogfv.$(MANSUFFIX) \ +glFogi.$(MANSUFFIX) glFogiv.$(MANSUFFIX) \ +glFrontFace.$(MANSUFFIX) glFrustum.$(MANSUFFIX) \ +glGenLists.$(MANSUFFIX) glGenTextures.$(MANSUFFIX) \ +glGetBooleanv.$(MANSUFFIX) glGetClipPlane.$(MANSUFFIX) \ +glGetDoublev.$(MANSUFFIX) glGetError.$(MANSUFFIX) \ +glGetFloatv.$(MANSUFFIX) glGetIntegerv.$(MANSUFFIX) \ +glGetLightfv.$(MANSUFFIX) glGetLightiv.$(MANSUFFIX) \ +glGetMapdv.$(MANSUFFIX) glGetMapfv.$(MANSUFFIX) \ +glGetMapiv.$(MANSUFFIX) glGetMaterialfv.$(MANSUFFIX) \ +glGetMaterialiv.$(MANSUFFIX) glGetPixelMapfv.$(MANSUFFIX) \ +glGetPixelMapuiv.$(MANSUFFIX) glGetPixelMapusv.$(MANSUFFIX) \ +glGetPointerv.$(MANSUFFIX) glGetPolygonStipple.$(MANSUFFIX) \ +glGetString.$(MANSUFFIX) glGetTexEnvfv.$(MANSUFFIX) \ +glGetTexEnviv.$(MANSUFFIX) glGetTexGendv.$(MANSUFFIX) \ +glGetTexGenfv.$(MANSUFFIX) glGetTexGeniv.$(MANSUFFIX) \ +glGetTexImage.$(MANSUFFIX) glGetTexLevelParameterfv.$(MANSUFFIX) \ +glGetTexLevelParameteriv.$(MANSUFFIX) glGetTexParameterfv.$(MANSUFFIX) \ +glGetTexParameteriv.$(MANSUFFIX) glHint.$(MANSUFFIX) \ +glIndexMask.$(MANSUFFIX) glIndexPointer.$(MANSUFFIX) \ +glIndexd.$(MANSUFFIX) glIndexdv.$(MANSUFFIX) \ +glIndexf.$(MANSUFFIX) glIndexfv.$(MANSUFFIX) \ +glIndexi.$(MANSUFFIX) glIndexiv.$(MANSUFFIX) \ +glIndexs.$(MANSUFFIX) glIndexsv.$(MANSUFFIX) \ +glIndexub.$(MANSUFFIX) glIndexubv.$(MANSUFFIX) \ +glInitNames.$(MANSUFFIX) glInterleavedArrays.$(MANSUFFIX) \ +glIsEnabled.$(MANSUFFIX) glIsList.$(MANSUFFIX) \ +glIsTexture.$(MANSUFFIX) glLightModelf.$(MANSUFFIX) \ +glLightModelfv.$(MANSUFFIX) glLightModeli.$(MANSUFFIX) \ +glLightModeliv.$(MANSUFFIX) glLightf.$(MANSUFFIX) \ +glLightfv.$(MANSUFFIX) glLighti.$(MANSUFFIX) \ +glLightiv.$(MANSUFFIX) glLineStipple.$(MANSUFFIX) \ +glLineWidth.$(MANSUFFIX) glListBase.$(MANSUFFIX) \ +glLoadIdentity.$(MANSUFFIX) glLoadMatrixd.$(MANSUFFIX) \ +glLoadMatrixf.$(MANSUFFIX) glLoadName.$(MANSUFFIX) \ +glLogicOp.$(MANSUFFIX) glMap1d.$(MANSUFFIX) \ +glMap1f.$(MANSUFFIX) glMap2d.$(MANSUFFIX) \ +glMap2f.$(MANSUFFIX) glMapGrid1d.$(MANSUFFIX) \ +glMapGrid1f.$(MANSUFFIX) glMapGrid2d.$(MANSUFFIX) \ +glMapGrid2f.$(MANSUFFIX) glMaterialf.$(MANSUFFIX) \ +glMaterialfv.$(MANSUFFIX) glMateriali.$(MANSUFFIX) \ +glMaterialiv.$(MANSUFFIX) glMatrixMode.$(MANSUFFIX) \ +glMultMatrixd.$(MANSUFFIX) glMultMatrixf.$(MANSUFFIX) \ +glNewList.$(MANSUFFIX) glNormal3b.$(MANSUFFIX) \ +glNormal3bv.$(MANSUFFIX) glNormal3d.$(MANSUFFIX) \ +glNormal3dv.$(MANSUFFIX) glNormal3f.$(MANSUFFIX) \ +glNormal3fv.$(MANSUFFIX) glNormal3i.$(MANSUFFIX) \ +glNormal3iv.$(MANSUFFIX) glNormal3s.$(MANSUFFIX) \ +glNormal3sv.$(MANSUFFIX) glNormalPointer.$(MANSUFFIX) \ +glOrtho.$(MANSUFFIX) glPassThrough.$(MANSUFFIX) \ +glPixelMapfv.$(MANSUFFIX) glPixelMapuiv.$(MANSUFFIX) \ +glPixelMapusv.$(MANSUFFIX) glPixelStoref.$(MANSUFFIX) \ +glPixelStorei.$(MANSUFFIX) glPixelTransferf.$(MANSUFFIX) \ +glPixelTransferi.$(MANSUFFIX) glPixelZoom.$(MANSUFFIX) \ +glPointSize.$(MANSUFFIX) glPolygonMode.$(MANSUFFIX) \ +glPolygonOffset.$(MANSUFFIX) glPolygonStipple.$(MANSUFFIX) \ +glPopAttrib.$(MANSUFFIX) glPopClientAttrib.$(MANSUFFIX) \ +glPopMatrix.$(MANSUFFIX) glPopName.$(MANSUFFIX) \ +glPrioritizeTextures.$(MANSUFFIX) glPushAttrib.$(MANSUFFIX) \ +glPushClientAttrib.$(MANSUFFIX) glPushMatrix.$(MANSUFFIX) \ +glPushName.$(MANSUFFIX) glRasterPos2d.$(MANSUFFIX) \ +glRasterPos2dv.$(MANSUFFIX) glRasterPos2f.$(MANSUFFIX) \ +glRasterPos2fv.$(MANSUFFIX) glRasterPos2i.$(MANSUFFIX) \ +glRasterPos2iv.$(MANSUFFIX) glRasterPos2s.$(MANSUFFIX) \ +glRasterPos2sv.$(MANSUFFIX) glRasterPos3d.$(MANSUFFIX) \ +glRasterPos3dv.$(MANSUFFIX) glRasterPos3f.$(MANSUFFIX) \ +glRasterPos3fv.$(MANSUFFIX) glRasterPos3i.$(MANSUFFIX) \ +glRasterPos3iv.$(MANSUFFIX) glRasterPos3s.$(MANSUFFIX) \ +glRasterPos3sv.$(MANSUFFIX) glRasterPos4d.$(MANSUFFIX) \ +glRasterPos4dv.$(MANSUFFIX) glRasterPos4f.$(MANSUFFIX) \ +glRasterPos4fv.$(MANSUFFIX) glRasterPos4i.$(MANSUFFIX) \ +glRasterPos4iv.$(MANSUFFIX) glRasterPos4s.$(MANSUFFIX) \ +glRasterPos4sv.$(MANSUFFIX) glReadBuffer.$(MANSUFFIX) \ +glReadPixels.$(MANSUFFIX) glRectd.$(MANSUFFIX) \ +glRectdv.$(MANSUFFIX) glRectf.$(MANSUFFIX) \ +glRectfv.$(MANSUFFIX) glRecti.$(MANSUFFIX) \ +glRectiv.$(MANSUFFIX) glRects.$(MANSUFFIX) \ +glRectsv.$(MANSUFFIX) glRenderMode.$(MANSUFFIX) \ +glRotated.$(MANSUFFIX) glRotatef.$(MANSUFFIX) \ +glScaled.$(MANSUFFIX) glScalef.$(MANSUFFIX) \ +glScissor.$(MANSUFFIX) glSelectBuffer.$(MANSUFFIX) \ +glShadeModel.$(MANSUFFIX) glStencilFunc.$(MANSUFFIX) \ +glStencilMask.$(MANSUFFIX) glStencilOp.$(MANSUFFIX) \ +glTexCoord1d.$(MANSUFFIX) glTexCoord1dv.$(MANSUFFIX) \ +glTexCoord1f.$(MANSUFFIX) glTexCoord1fv.$(MANSUFFIX) \ +glTexCoord1i.$(MANSUFFIX) glTexCoord1iv.$(MANSUFFIX) \ +glTexCoord1s.$(MANSUFFIX) glTexCoord1sv.$(MANSUFFIX) \ +glTexCoord2d.$(MANSUFFIX) glTexCoord2dv.$(MANSUFFIX) \ +glTexCoord2f.$(MANSUFFIX) glTexCoord2fv.$(MANSUFFIX) \ +glTexCoord2i.$(MANSUFFIX) glTexCoord2iv.$(MANSUFFIX) \ +glTexCoord2s.$(MANSUFFIX) glTexCoord2sv.$(MANSUFFIX) \ +glTexCoord3d.$(MANSUFFIX) glTexCoord3dv.$(MANSUFFIX) \ +glTexCoord3f.$(MANSUFFIX) glTexCoord3fv.$(MANSUFFIX) \ +glTexCoord3i.$(MANSUFFIX) glTexCoord3iv.$(MANSUFFIX) \ +glTexCoord3s.$(MANSUFFIX) glTexCoord3sv.$(MANSUFFIX) \ +glTexCoord4d.$(MANSUFFIX) glTexCoord4dv.$(MANSUFFIX) \ +glTexCoord4f.$(MANSUFFIX) glTexCoord4fv.$(MANSUFFIX) \ +glTexCoord4i.$(MANSUFFIX) glTexCoord4iv.$(MANSUFFIX) \ +glTexCoord4s.$(MANSUFFIX) glTexCoord4sv.$(MANSUFFIX) \ +glTexCoordPointer.$(MANSUFFIX) glTexEnvf.$(MANSUFFIX) \ +glTexEnvfv.$(MANSUFFIX) glTexEnvi.$(MANSUFFIX) \ +glTexEnviv.$(MANSUFFIX) glTexGend.$(MANSUFFIX) \ +glTexGendv.$(MANSUFFIX) glTexGenf.$(MANSUFFIX) \ +glTexGenfv.$(MANSUFFIX) glTexGeni.$(MANSUFFIX) \ +glTexGeniv.$(MANSUFFIX) glTexImage1D.$(MANSUFFIX) \ +glTexImage2D.$(MANSUFFIX) glTexParameterf.$(MANSUFFIX) \ +glTexParameterfv.$(MANSUFFIX) glTexParameteri.$(MANSUFFIX) \ +glTexParameteriv.$(MANSUFFIX) glTexSubImage1D.$(MANSUFFIX) \ +glTexSubImage2D.$(MANSUFFIX) glTranslated.$(MANSUFFIX) \ +glTranslatef.$(MANSUFFIX) glVertex2d.$(MANSUFFIX) \ +glVertex2dv.$(MANSUFFIX) glVertex2f.$(MANSUFFIX) \ +glVertex2fv.$(MANSUFFIX) glVertex2i.$(MANSUFFIX) \ +glVertex2iv.$(MANSUFFIX) glVertex2s.$(MANSUFFIX) \ +glVertex2sv.$(MANSUFFIX) glVertex3d.$(MANSUFFIX) \ +glVertex3dv.$(MANSUFFIX) glVertex3f.$(MANSUFFIX) \ +glVertex3fv.$(MANSUFFIX) glVertex3i.$(MANSUFFIX) \ +glVertex3iv.$(MANSUFFIX) glVertex3s.$(MANSUFFIX) \ +glVertex3sv.$(MANSUFFIX) glVertex4d.$(MANSUFFIX) \ +glVertex4dv.$(MANSUFFIX) glVertex4f.$(MANSUFFIX) \ +glVertex4fv.$(MANSUFFIX) glVertex4i.$(MANSUFFIX) \ +glVertex4iv.$(MANSUFFIX) glVertex4s.$(MANSUFFIX) \ +glVertex4sv.$(MANSUFFIX) glVertexPointer.$(MANSUFFIX) \ +glViewport.$(MANSUFFIX) + +LINK_NAMES = \ +glAccum.$(MANSUFFIX) glAlphaFunc.$(MANSUFFIX) \ +glAreTexturesResident.$(MANSUFFIX) glArrayElement.$(MANSUFFIX) \ +glBegin.$(MANSUFFIX) glBindTexture.$(MANSUFFIX) \ +glBitmap.$(MANSUFFIX) glBlendColorEXT.$(MANSUFFIX) \ +glBlendFunc.$(MANSUFFIX) glCallList.$(MANSUFFIX) \ +glCallLists.$(MANSUFFIX) glClear.$(MANSUFFIX) \ +glClearAccum.$(MANSUFFIX) glClearColor.$(MANSUFFIX) \ +glClearDepth.$(MANSUFFIX) glClearIndex.$(MANSUFFIX) \ +glClearStencil.$(MANSUFFIX) glClipPlane.$(MANSUFFIX) \ +glColor3b.$(MANSUFFIX) glColorMask.$(MANSUFFIX) \ +glColorMaterial.$(MANSUFFIX) glColorPointer.$(MANSUFFIX) \ +glCopyPixels.$(MANSUFFIX) glCopyTexImage1D.$(MANSUFFIX) \ +glCopyTexImage2D.$(MANSUFFIX) glCopyTexSubImage1D.$(MANSUFFIX) \ +glCopyTexSubImage2D.$(MANSUFFIX) glCullFace.$(MANSUFFIX) \ +glDeleteLists.$(MANSUFFIX) glDeleteTextures.$(MANSUFFIX) \ +glDepthFunc.$(MANSUFFIX) glDepthMask.$(MANSUFFIX) \ +glDepthRange.$(MANSUFFIX) glDrawArrays.$(MANSUFFIX) \ +glDrawBuffer.$(MANSUFFIX) glDrawElements.$(MANSUFFIX) \ +glDrawPixels.$(MANSUFFIX) glEdgeFlag.$(MANSUFFIX) \ +glEdgeFlagPointer.$(MANSUFFIX) glEnable.$(MANSUFFIX) \ +glEnableClientState.$(MANSUFFIX) glEvalCoord1d.$(MANSUFFIX) \ +glEvalMesh1.$(MANSUFFIX) glEvalPoint1.$(MANSUFFIX) \ +glFeedbackBuffer.$(MANSUFFIX) glFinish.$(MANSUFFIX) \ +glFlush.$(MANSUFFIX) glFogf.$(MANSUFFIX) \ +glFrontFace.$(MANSUFFIX) glFrustum.$(MANSUFFIX) \ +glGenLists.$(MANSUFFIX) glGenTextures.$(MANSUFFIX) \ +glGetBooleanv.$(MANSUFFIX) glGetClipPlane.$(MANSUFFIX) \ +glGetError.$(MANSUFFIX) glGetLightfv.$(MANSUFFIX) \ +glGetMapdv.$(MANSUFFIX) glGetMaterialfv.$(MANSUFFIX) \ +glGetPixelMapfv.$(MANSUFFIX) glGetPointerv.$(MANSUFFIX) \ +glGetPolygonStipple.$(MANSUFFIX) glGetString.$(MANSUFFIX) \ +glGetTexEnvfv.$(MANSUFFIX) glGetTexGendv.$(MANSUFFIX) \ +glGetTexImage.$(MANSUFFIX) glGetTexLevelParameterfv.$(MANSUFFIX) \ +glGetTexParameterfv.$(MANSUFFIX) glHint.$(MANSUFFIX) \ +glIndexMask.$(MANSUFFIX) glIndexPointer.$(MANSUFFIX) \ +glIndexd.$(MANSUFFIX) glInitNames.$(MANSUFFIX) \ +glInterleavedArrays.$(MANSUFFIX) glIsEnabled.$(MANSUFFIX) \ +glIsList.$(MANSUFFIX) glIsTexture.$(MANSUFFIX) \ +glLightModelf.$(MANSUFFIX) glLightf.$(MANSUFFIX) \ +glLineStipple.$(MANSUFFIX) glLineWidth.$(MANSUFFIX) \ +glListBase.$(MANSUFFIX) glLoadIdentity.$(MANSUFFIX) \ +glLoadMatrixd.$(MANSUFFIX) glLoadName.$(MANSUFFIX) \ +glLogicOp.$(MANSUFFIX) glMap1d.$(MANSUFFIX) \ +glMap2d.$(MANSUFFIX) glMapGrid1d.$(MANSUFFIX) \ +glMaterialf.$(MANSUFFIX) glMatrixMode.$(MANSUFFIX) \ +glMultMatrixd.$(MANSUFFIX) glNewList.$(MANSUFFIX) \ +glNormal3b.$(MANSUFFIX) glNormalPointer.$(MANSUFFIX) \ +glOrtho.$(MANSUFFIX) glPassThrough.$(MANSUFFIX) \ +glPixelMapfv.$(MANSUFFIX) glPixelStoref.$(MANSUFFIX) \ +glPixelTransferf.$(MANSUFFIX) glPixelZoom.$(MANSUFFIX) \ +glPointSize.$(MANSUFFIX) glPolygonMode.$(MANSUFFIX) \ +glPolygonOffset.$(MANSUFFIX) glPolygonStipple.$(MANSUFFIX) \ +glPrioritizeTextures.$(MANSUFFIX) glPushAttrib.$(MANSUFFIX) \ +glPushClientAttrib.$(MANSUFFIX) glPushMatrix.$(MANSUFFIX) \ +glPushName.$(MANSUFFIX) glRasterPos2d.$(MANSUFFIX) \ +glReadBuffer.$(MANSUFFIX) glReadPixels.$(MANSUFFIX) \ +glRectd.$(MANSUFFIX) glRenderMode.$(MANSUFFIX) \ +glRotated.$(MANSUFFIX) glScaled.$(MANSUFFIX) \ +glScissor.$(MANSUFFIX) glSelectBuffer.$(MANSUFFIX) \ +glShadeModel.$(MANSUFFIX) glStencilFunc.$(MANSUFFIX) \ +glStencilMask.$(MANSUFFIX) glStencilOp.$(MANSUFFIX) \ +glTexCoord1d.$(MANSUFFIX) glTexCoordPointer.$(MANSUFFIX) \ +glTexEnvf.$(MANSUFFIX) glTexGend.$(MANSUFFIX) \ +glTexImage1D.$(MANSUFFIX) glTexImage2D.$(MANSUFFIX) \ +glTexParameterf.$(MANSUFFIX) glTexSubImage1D.$(MANSUFFIX) \ +glTexSubImage2D.$(MANSUFFIX) glTranslated.$(MANSUFFIX) \ +glVertex2d.$(MANSUFFIX) glVertexPointer.$(MANSUFFIX) \ +glViewport.$(MANSUFFIX) + +ALIAS_NAMES = \ +glColor3bv.$(MANSUFFIX) glColor3d.$(MANSUFFIX) \ +glColor3dv.$(MANSUFFIX) glColor3f.$(MANSUFFIX) \ +glColor3fv.$(MANSUFFIX) glColor3i.$(MANSUFFIX) \ +glColor3iv.$(MANSUFFIX) glColor3s.$(MANSUFFIX) \ +glColor3sv.$(MANSUFFIX) glColor3ub.$(MANSUFFIX) \ +glColor3ubv.$(MANSUFFIX) glColor3ui.$(MANSUFFIX) \ +glColor3uiv.$(MANSUFFIX) glColor3us.$(MANSUFFIX) \ +glColor3usv.$(MANSUFFIX) glColor4b.$(MANSUFFIX) \ +glColor4bv.$(MANSUFFIX) glColor4d.$(MANSUFFIX) \ +glColor4dv.$(MANSUFFIX) glColor4f.$(MANSUFFIX) \ +glColor4fv.$(MANSUFFIX) glColor4i.$(MANSUFFIX) \ +glColor4iv.$(MANSUFFIX) glColor4s.$(MANSUFFIX) \ +glColor4sv.$(MANSUFFIX) glColor4ub.$(MANSUFFIX) \ +glColor4ubv.$(MANSUFFIX) glColor4ui.$(MANSUFFIX) \ +glColor4uiv.$(MANSUFFIX) glColor4us.$(MANSUFFIX) \ +glColor4usv.$(MANSUFFIX) glDisable.$(MANSUFFIX) \ +glDisableClientState.$(MANSUFFIX) glEdgeFlagv.$(MANSUFFIX) \ +glEnd.$(MANSUFFIX) glEndList.$(MANSUFFIX) \ +glEvalCoord1dv.$(MANSUFFIX) glEvalCoord1f.$(MANSUFFIX) \ +glEvalCoord1fv.$(MANSUFFIX) glEvalCoord2d.$(MANSUFFIX) \ +glEvalCoord2dv.$(MANSUFFIX) glEvalCoord2f.$(MANSUFFIX) \ +glEvalCoord2fv.$(MANSUFFIX) glEvalMesh2.$(MANSUFFIX) \ +glEvalPoint2.$(MANSUFFIX) glFogfv.$(MANSUFFIX) \ +glFogi.$(MANSUFFIX) glFogiv.$(MANSUFFIX) \ +glGetDoublev.$(MANSUFFIX) glGetFloatv.$(MANSUFFIX) \ +glGetIntegerv.$(MANSUFFIX) glGetLightiv.$(MANSUFFIX) \ +glGetMapfv.$(MANSUFFIX) glGetMapiv.$(MANSUFFIX) \ +glGetMaterialiv.$(MANSUFFIX) glGetPixelMapuiv.$(MANSUFFIX) \ +glGetPixelMapusv.$(MANSUFFIX) glGetTexEnviv.$(MANSUFFIX) \ +glGetTexGenfv.$(MANSUFFIX) glGetTexGeniv.$(MANSUFFIX) \ +glGetTexLevelParameteriv.$(MANSUFFIX) glGetTexParameteriv.$(MANSUFFIX) \ +glIndexdv.$(MANSUFFIX) glIndexf.$(MANSUFFIX) \ +glIndexfv.$(MANSUFFIX) glIndexi.$(MANSUFFIX) \ +glIndexiv.$(MANSUFFIX) glIndexs.$(MANSUFFIX) \ +glIndexsv.$(MANSUFFIX) glIndexub.$(MANSUFFIX) \ +glIndexubv.$(MANSUFFIX) glLightModelfv.$(MANSUFFIX) \ +glLightModeli.$(MANSUFFIX) glLightModeliv.$(MANSUFFIX) \ +glLightfv.$(MANSUFFIX) glLighti.$(MANSUFFIX) \ +glLightiv.$(MANSUFFIX) glLoadMatrixf.$(MANSUFFIX) \ +glMap1f.$(MANSUFFIX) glMap2f.$(MANSUFFIX) \ +glMapGrid1f.$(MANSUFFIX) glMapGrid2d.$(MANSUFFIX) \ +glMapGrid2f.$(MANSUFFIX) glMaterialfv.$(MANSUFFIX) \ +glMateriali.$(MANSUFFIX) glMaterialiv.$(MANSUFFIX) \ +glMultMatrixf.$(MANSUFFIX) glNormal3bv.$(MANSUFFIX) \ +glNormal3d.$(MANSUFFIX) glNormal3dv.$(MANSUFFIX) \ +glNormal3f.$(MANSUFFIX) glNormal3fv.$(MANSUFFIX) \ +glNormal3i.$(MANSUFFIX) glNormal3iv.$(MANSUFFIX) \ +glNormal3s.$(MANSUFFIX) glNormal3sv.$(MANSUFFIX) \ +glPixelMapuiv.$(MANSUFFIX) glPixelMapusv.$(MANSUFFIX) \ +glPixelStorei.$(MANSUFFIX) glPixelTransferi.$(MANSUFFIX) \ +glPopAttrib.$(MANSUFFIX) glPopClientAttrib.$(MANSUFFIX) \ +glPopMatrix.$(MANSUFFIX) glPopName.$(MANSUFFIX) \ +glRasterPos2dv.$(MANSUFFIX) glRasterPos2f.$(MANSUFFIX) \ +glRasterPos2fv.$(MANSUFFIX) glRasterPos2i.$(MANSUFFIX) \ +glRasterPos2iv.$(MANSUFFIX) glRasterPos2s.$(MANSUFFIX) \ +glRasterPos2sv.$(MANSUFFIX) glRasterPos3d.$(MANSUFFIX) \ +glRasterPos3dv.$(MANSUFFIX) glRasterPos3f.$(MANSUFFIX) \ +glRasterPos3fv.$(MANSUFFIX) glRasterPos3i.$(MANSUFFIX) \ +glRasterPos3iv.$(MANSUFFIX) glRasterPos3s.$(MANSUFFIX) \ +glRasterPos3sv.$(MANSUFFIX) glRasterPos4d.$(MANSUFFIX) \ +glRasterPos4dv.$(MANSUFFIX) glRasterPos4f.$(MANSUFFIX) \ +glRasterPos4fv.$(MANSUFFIX) glRasterPos4i.$(MANSUFFIX) \ +glRasterPos4iv.$(MANSUFFIX) glRasterPos4s.$(MANSUFFIX) \ +glRasterPos4sv.$(MANSUFFIX) glRectdv.$(MANSUFFIX) \ +glRectf.$(MANSUFFIX) glRectfv.$(MANSUFFIX) \ +glRecti.$(MANSUFFIX) glRectiv.$(MANSUFFIX) \ +glRects.$(MANSUFFIX) glRectsv.$(MANSUFFIX) \ +glRotatef.$(MANSUFFIX) glScalef.$(MANSUFFIX) \ +glTexCoord1dv.$(MANSUFFIX) glTexCoord1f.$(MANSUFFIX) \ +glTexCoord1fv.$(MANSUFFIX) glTexCoord1i.$(MANSUFFIX) \ +glTexCoord1iv.$(MANSUFFIX) glTexCoord1s.$(MANSUFFIX) \ +glTexCoord1sv.$(MANSUFFIX) glTexCoord2d.$(MANSUFFIX) \ +glTexCoord2dv.$(MANSUFFIX) glTexCoord2f.$(MANSUFFIX) \ +glTexCoord2fv.$(MANSUFFIX) glTexCoord2i.$(MANSUFFIX) \ +glTexCoord2iv.$(MANSUFFIX) glTexCoord2s.$(MANSUFFIX) \ +glTexCoord2sv.$(MANSUFFIX) glTexCoord3d.$(MANSUFFIX) \ +glTexCoord3dv.$(MANSUFFIX) glTexCoord3f.$(MANSUFFIX) \ +glTexCoord3fv.$(MANSUFFIX) glTexCoord3i.$(MANSUFFIX) \ +glTexCoord3iv.$(MANSUFFIX) glTexCoord3s.$(MANSUFFIX) \ +glTexCoord3sv.$(MANSUFFIX) glTexCoord4d.$(MANSUFFIX) \ +glTexCoord4dv.$(MANSUFFIX) glTexCoord4f.$(MANSUFFIX) \ +glTexCoord4fv.$(MANSUFFIX) glTexCoord4i.$(MANSUFFIX) \ +glTexCoord4iv.$(MANSUFFIX) glTexCoord4s.$(MANSUFFIX) \ +glTexCoord4sv.$(MANSUFFIX) glTexEnvfv.$(MANSUFFIX) \ +glTexEnvi.$(MANSUFFIX) glTexEnviv.$(MANSUFFIX) \ +glTexGendv.$(MANSUFFIX) glTexGenf.$(MANSUFFIX) \ +glTexGenfv.$(MANSUFFIX) glTexGeni.$(MANSUFFIX) \ +glTexGeniv.$(MANSUFFIX) glTexParameterfv.$(MANSUFFIX) \ +glTexParameteri.$(MANSUFFIX) glTexParameteriv.$(MANSUFFIX) \ +glTranslatef.$(MANSUFFIX) glVertex2dv.$(MANSUFFIX) \ +glVertex2f.$(MANSUFFIX) glVertex2fv.$(MANSUFFIX) \ +glVertex2i.$(MANSUFFIX) glVertex2iv.$(MANSUFFIX) \ +glVertex2s.$(MANSUFFIX) glVertex2sv.$(MANSUFFIX) \ +glVertex3d.$(MANSUFFIX) glVertex3dv.$(MANSUFFIX) \ +glVertex3f.$(MANSUFFIX) glVertex3fv.$(MANSUFFIX) \ +glVertex3i.$(MANSUFFIX) glVertex3iv.$(MANSUFFIX) \ +glVertex3s.$(MANSUFFIX) glVertex3sv.$(MANSUFFIX) \ +glVertex4d.$(MANSUFFIX) glVertex4dv.$(MANSUFFIX) \ +glVertex4f.$(MANSUFFIX) glVertex4fv.$(MANSUFFIX) \ +glVertex4i.$(MANSUFFIX) glVertex4iv.$(MANSUFFIX) \ +glVertex4s.$(MANSUFFIX) glVertex4sv.$(MANSUFFIX) + + +AllTarget($(MAN_PAGES)) + +list: + @for i in $(MAN_PAGES); do echo $$i; done; + +install_list: + @for i in $(MAN_PAGES); do echo $(LIBMANDIR)/$$i; done; + +install:: install.man + +clean:: + $(RM) $(LINK_NAMES) $(ALIAS_NAMES) + +InstallMultipleMan($(MAN_PAGES),$(LIBMANDIR)) + +LinkFile(glAccum.$(MANSUFFIX), accum.3gl) + +LinkFile(glAlphaFunc.$(MANSUFFIX), alphafunc.3gl) + +LinkFile(glAreTexturesResident.$(MANSUFFIX), aretexturesresident.3gl) + +LinkFile(glArrayElement.$(MANSUFFIX), arrayelement.3gl) + +LinkFile(glBegin.$(MANSUFFIX), begin.3gl) +ManPageAlias(glBegin, $(LIBMANDIR), glEnd) + +LinkFile(glBindTexture.$(MANSUFFIX), bindtexture.3gl) + +LinkFile(glBitmap.$(MANSUFFIX), bitmap.3gl) + +LinkFile(glBlendColorEXT.$(MANSUFFIX), blendcolorext.3gl) + +LinkFile(glBlendFunc.$(MANSUFFIX), blendfunc.3gl) + +LinkFile(glCallList.$(MANSUFFIX), calllist.3gl) + +LinkFile(glCallLists.$(MANSUFFIX), calllists.3gl) + +LinkFile(glClear.$(MANSUFFIX), clear.3gl) + +LinkFile(glClearAccum.$(MANSUFFIX), clearaccum.3gl) + +LinkFile(glClearColor.$(MANSUFFIX), clearcolor.3gl) + +LinkFile(glClearDepth.$(MANSUFFIX), cleardepth.3gl) + +LinkFile(glClearIndex.$(MANSUFFIX), clearindex.3gl) + +LinkFile(glClearStencil.$(MANSUFFIX), clearstencil.3gl) + +LinkFile(glClipPlane.$(MANSUFFIX), clipplane.3gl) + +LinkFile(glColor3b.$(MANSUFFIX), color.3gl) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3d) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3f) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3i) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3s) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3ub) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3ui) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3us) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4b) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4d) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4f) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4i) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4s) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4ub) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4ui) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4us) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3bv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3dv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3fv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3iv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3sv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3ubv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3uiv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor3usv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4bv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4dv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4fv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4iv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4sv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4ubv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4uiv) +ManPageAlias(glColor3b, $(LIBMANDIR), glColor4usv) + +LinkFile(glColorMask.$(MANSUFFIX), colormask.3gl) + +LinkFile(glColorMaterial.$(MANSUFFIX), colormaterial.3gl) + +LinkFile(glColorPointer.$(MANSUFFIX), colorpointer.3gl) + +LinkFile(glCopyPixels.$(MANSUFFIX), copypixels.3gl) + +LinkFile(glCopyTexImage1D.$(MANSUFFIX), copyteximage1d.3gl) + +LinkFile(glCopyTexImage2D.$(MANSUFFIX), copyteximage2d.3gl) + +LinkFile(glCopyTexSubImage1D.$(MANSUFFIX), copytexsubimage1d.3gl) + +LinkFile(glCopyTexSubImage2D.$(MANSUFFIX), copytexsubimage2d.3gl) + +LinkFile(glCullFace.$(MANSUFFIX), cullface.3gl) + +LinkFile(glDeleteLists.$(MANSUFFIX), deletelists.3gl) + +LinkFile(glDeleteTextures.$(MANSUFFIX), deletetextures.3gl) + +LinkFile(glDepthFunc.$(MANSUFFIX), depthfunc.3gl) + +LinkFile(glDepthMask.$(MANSUFFIX), depthmask.3gl) + +LinkFile(glDepthRange.$(MANSUFFIX), depthrange.3gl) + +LinkFile(glDrawArrays.$(MANSUFFIX), drawarrays.3gl) + +LinkFile(glDrawBuffer.$(MANSUFFIX), drawbuffer.3gl) + +LinkFile(glDrawElements.$(MANSUFFIX), drawelements.3gl) + +LinkFile(glDrawPixels.$(MANSUFFIX), drawpixels.3gl) + +LinkFile(glEdgeFlag.$(MANSUFFIX), edgeflag.3gl) +ManPageAlias(glEdgeFlag, $(LIBMANDIR), glEdgeFlagv) + +LinkFile(glEdgeFlagPointer.$(MANSUFFIX), edgeflagpointer.3gl) + +LinkFile(glEnable.$(MANSUFFIX), enable.3gl) +ManPageAlias(glEnable, $(LIBMANDIR), glDisable) + +LinkFile(glEnableClientState.$(MANSUFFIX), enableclientstate.3gl) +ManPageAlias(glEnableClientState, $(LIBMANDIR), glDisableClientState) + +LinkFile(glEvalCoord1d.$(MANSUFFIX), evalcoord.3gl) +ManPageAlias(glEvalCoord1d, $(LIBMANDIR), glEvalCoord1f) +ManPageAlias(glEvalCoord1d, $(LIBMANDIR), glEvalCoord2d) +ManPageAlias(glEvalCoord1d, $(LIBMANDIR), glEvalCoord2f) +ManPageAlias(glEvalCoord1d, $(LIBMANDIR), glEvalCoord1dv) +ManPageAlias(glEvalCoord1d, $(LIBMANDIR), glEvalCoord1fv) +ManPageAlias(glEvalCoord1d, $(LIBMANDIR), glEvalCoord2dv) +ManPageAlias(glEvalCoord1d, $(LIBMANDIR), glEvalCoord2fv) + +LinkFile(glEvalMesh1.$(MANSUFFIX), evalmesh.3gl) +ManPageAlias(glEvalMesh1, $(LIBMANDIR), glEvalMesh2) + +LinkFile(glEvalPoint1.$(MANSUFFIX), evalpoint.3gl) +ManPageAlias(glEvalPoint1, $(LIBMANDIR), glEvalPoint2) + +LinkFile(glFeedbackBuffer.$(MANSUFFIX), feedbackbuffer.3gl) + +LinkFile(glFinish.$(MANSUFFIX), finish.3gl) + +LinkFile(glFlush.$(MANSUFFIX), flush.3gl) + +LinkFile(glFogf.$(MANSUFFIX), fog.3gl) +ManPageAlias(glFogf, $(LIBMANDIR), glFogi) +ManPageAlias(glFogf, $(LIBMANDIR), glFogfv) +ManPageAlias(glFogf, $(LIBMANDIR), glFogiv) + +LinkFile(glFrontFace.$(MANSUFFIX), frontface.3gl) + +LinkFile(glFrustum.$(MANSUFFIX), frustum.3gl) + +LinkFile(glGenLists.$(MANSUFFIX), genlists.3gl) + +LinkFile(glGenTextures.$(MANSUFFIX), gentextures.3gl) + +LinkFile(glGetBooleanv.$(MANSUFFIX), get.3gl) +ManPageAlias(glGetBooleanv, $(LIBMANDIR), glGetDoublev) +ManPageAlias(glGetBooleanv, $(LIBMANDIR), glGetFloatv) +ManPageAlias(glGetBooleanv, $(LIBMANDIR), glGetIntegerv) + +LinkFile(glGetClipPlane.$(MANSUFFIX), getclipplane.3gl) + +LinkFile(glGetError.$(MANSUFFIX), geterror.3gl) + +LinkFile(glGetLightfv.$(MANSUFFIX), getlight.3gl) +ManPageAlias(glGetLightfv, $(LIBMANDIR), glGetLightiv) + +LinkFile(glGetMapdv.$(MANSUFFIX), getmap.3gl) +ManPageAlias(glGetMapdv, $(LIBMANDIR), glGetMapfv) +ManPageAlias(glGetMapdv, $(LIBMANDIR), glGetMapiv) + +LinkFile(glGetMaterialfv.$(MANSUFFIX), getmaterial.3gl) +ManPageAlias(glGetMaterialfv, $(LIBMANDIR), glGetMaterialiv) + +LinkFile(glGetPixelMapfv.$(MANSUFFIX), getpixelmap.3gl) +ManPageAlias(glGetPixelMapfv, $(LIBMANDIR), glGetPixelMapuiv) +ManPageAlias(glGetPixelMapfv, $(LIBMANDIR), glGetPixelMapusv) + +LinkFile(glGetPointerv.$(MANSUFFIX), getpointerv.3gl) + +LinkFile(glGetPolygonStipple.$(MANSUFFIX), getpolygonstipple.3gl) + +LinkFile(glGetString.$(MANSUFFIX), getstring.3gl) + +LinkFile(glGetTexEnvfv.$(MANSUFFIX), gettexenv.3gl) +ManPageAlias(glGetTexEnvfv, $(LIBMANDIR), glGetTexEnviv) + +LinkFile(glGetTexGendv.$(MANSUFFIX), gettexgen.3gl) +ManPageAlias(glGetTexGendv, $(LIBMANDIR), glGetTexGenfv) +ManPageAlias(glGetTexGendv, $(LIBMANDIR), glGetTexGeniv) + +LinkFile(glGetTexImage.$(MANSUFFIX), getteximage.3gl) + +LinkFile(glGetTexLevelParameterfv.$(MANSUFFIX), gettexlevelparameter.3gl) +ManPageAlias(glGetTexLevelParameterfv, $(LIBMANDIR), glGetTexLevelParameteriv) + +LinkFile(glGetTexParameterfv.$(MANSUFFIX), gettexparameter.3gl) +ManPageAlias(glGetTexParameterfv, $(LIBMANDIR), glGetTexParameteriv) + +LinkFile(glHint.$(MANSUFFIX), hint.3gl) + +LinkFile(glIndexd.$(MANSUFFIX), index.3gl) +ManPageAlias(glIndexd, $(LIBMANDIR), glIndexf) +ManPageAlias(glIndexd, $(LIBMANDIR), glIndexi) +ManPageAlias(glIndexd, $(LIBMANDIR), glIndexs) +ManPageAlias(glIndexd, $(LIBMANDIR), glIndexub) +ManPageAlias(glIndexd, $(LIBMANDIR), glIndexdv) +ManPageAlias(glIndexd, $(LIBMANDIR), glIndexfv) +ManPageAlias(glIndexd, $(LIBMANDIR), glIndexiv) +ManPageAlias(glIndexd, $(LIBMANDIR), glIndexsv) +ManPageAlias(glIndexd, $(LIBMANDIR), glIndexubv) + +LinkFile(glIndexMask.$(MANSUFFIX), indexmask.3gl) + +LinkFile(glIndexPointer.$(MANSUFFIX), indexpointer.3gl) + +LinkFile(glInitNames.$(MANSUFFIX), initnames.3gl) + +LinkFile(glInterleavedArrays.$(MANSUFFIX), interleavedarrays.3gl) + +LinkFile(glIsEnabled.$(MANSUFFIX), isenabled.3gl) + +LinkFile(glIsList.$(MANSUFFIX), islist.3gl) + +LinkFile(glIsTexture.$(MANSUFFIX), istexture.3gl) + +LinkFile(glLightf.$(MANSUFFIX), light.3gl) +ManPageAlias(glLightf, $(LIBMANDIR), glLighti) +ManPageAlias(glLightf, $(LIBMANDIR), glLightfv) +ManPageAlias(glLightf, $(LIBMANDIR), glLightiv) + +LinkFile(glLightModelf.$(MANSUFFIX), lightmodel.3gl) +ManPageAlias(glLightModelf, $(LIBMANDIR), glLightModeli) +ManPageAlias(glLightModelf, $(LIBMANDIR), glLightModelfv) +ManPageAlias(glLightModelf, $(LIBMANDIR), glLightModeliv) + +LinkFile(glLineStipple.$(MANSUFFIX), linestipple.3gl) + +LinkFile(glLineWidth.$(MANSUFFIX), linewidth.3gl) + +LinkFile(glListBase.$(MANSUFFIX), listbase.3gl) + +LinkFile(glLoadIdentity.$(MANSUFFIX), loadidentity.3gl) + +LinkFile(glLoadMatrixd.$(MANSUFFIX), loadmatrix.3gl) +ManPageAlias(glLoadMatrixd, $(LIBMANDIR), glLoadMatrixf) + +LinkFile(glLoadName.$(MANSUFFIX), loadname.3gl) + +LinkFile(glLogicOp.$(MANSUFFIX), logicop.3gl) + +LinkFile(glMap1d.$(MANSUFFIX), map1.3gl) +ManPageAlias(glMap1d, $(LIBMANDIR), glMap1f) + +LinkFile(glMap2d.$(MANSUFFIX), map2.3gl) +ManPageAlias(glMap2d, $(LIBMANDIR), glMap2f) + +LinkFile(glMapGrid1d.$(MANSUFFIX), mapgrid.3gl) +ManPageAlias(glMapGrid1d, $(LIBMANDIR), glMapGrid1f) +ManPageAlias(glMapGrid1d, $(LIBMANDIR), glMapGrid2d) +ManPageAlias(glMapGrid1d, $(LIBMANDIR), glMapGrid2f) + +LinkFile(glMaterialf.$(MANSUFFIX), material.3gl) +ManPageAlias(glMaterialf, $(LIBMANDIR), glMateriali) +ManPageAlias(glMaterialf, $(LIBMANDIR), glMaterialfv) +ManPageAlias(glMaterialf, $(LIBMANDIR), glMaterialiv) + +LinkFile(glMatrixMode.$(MANSUFFIX), matrixmode.3gl) + +LinkFile(glMultMatrixd.$(MANSUFFIX), multmatrix.3gl) +ManPageAlias(glMultMatrixd, $(LIBMANDIR), glMultMatrixf) + +LinkFile(glNewList.$(MANSUFFIX), newlist.3gl) +ManPageAlias(glNewList, $(LIBMANDIR), glEndList) + +LinkFile(glNormal3b.$(MANSUFFIX), normal.3gl) +ManPageAlias(glNormal3b, $(LIBMANDIR), glNormal3d) +ManPageAlias(glNormal3b, $(LIBMANDIR), glNormal3f) +ManPageAlias(glNormal3b, $(LIBMANDIR), glNormal3i) +ManPageAlias(glNormal3b, $(LIBMANDIR), glNormal3s) +ManPageAlias(glNormal3b, $(LIBMANDIR), glNormal3bv) +ManPageAlias(glNormal3b, $(LIBMANDIR), glNormal3dv) +ManPageAlias(glNormal3b, $(LIBMANDIR), glNormal3fv) +ManPageAlias(glNormal3b, $(LIBMANDIR), glNormal3iv) +ManPageAlias(glNormal3b, $(LIBMANDIR), glNormal3sv) + +LinkFile(glNormalPointer.$(MANSUFFIX), normalpointer.3gl) + +LinkFile(glOrtho.$(MANSUFFIX), ortho.3gl) + +LinkFile(glPassThrough.$(MANSUFFIX), passthrough.3gl) + +LinkFile(glPixelMapfv.$(MANSUFFIX), pixelmap.3gl) +ManPageAlias(glPixelMapfv, $(LIBMANDIR), glPixelMapuiv) +ManPageAlias(glPixelMapfv, $(LIBMANDIR), glPixelMapusv) + +LinkFile(glPixelStoref.$(MANSUFFIX), pixelstore.3gl) +ManPageAlias(glPixelStoref, $(LIBMANDIR), glPixelStorei) + +LinkFile(glPixelTransferf.$(MANSUFFIX), pixeltransfer.3gl) +ManPageAlias(glPixelTransferf, $(LIBMANDIR), glPixelTransferi) + +LinkFile(glPixelZoom.$(MANSUFFIX), pixelzoom.3gl) + +LinkFile(glPointSize.$(MANSUFFIX), pointsize.3gl) + +LinkFile(glPolygonMode.$(MANSUFFIX), polygonmode.3gl) + +LinkFile(glPolygonOffset.$(MANSUFFIX), polygonoffset.3gl) + +LinkFile(glPolygonStipple.$(MANSUFFIX), polygonstipple.3gl) + +LinkFile(glPrioritizeTextures.$(MANSUFFIX), prioritizetextures.3gl) + +LinkFile(glPushAttrib.$(MANSUFFIX), pushattrib.3gl) +ManPageAlias(glPushAttrib, $(LIBMANDIR), glPopAttrib) + +LinkFile(glPushClientAttrib.$(MANSUFFIX), pushclientattrib.3gl) +ManPageAlias(glPushClientAttrib, $(LIBMANDIR), glPopClientAttrib) + +LinkFile(glPushMatrix.$(MANSUFFIX), pushmatrix.3gl) +ManPageAlias(glPushMatrix, $(LIBMANDIR), glPopMatrix) + +LinkFile(glPushName.$(MANSUFFIX), pushname.3gl) +ManPageAlias(glPushName, $(LIBMANDIR), glPopName) + +LinkFile(glRasterPos2d.$(MANSUFFIX), rasterpos.3gl) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos2f) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos2i) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos2s) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos3d) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos3f) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos3i) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos3s) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos4d) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos4f) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos4i) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos4s) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos2dv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos2fv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos2iv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos2sv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos3dv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos3fv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos3iv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos3sv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos4dv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos4fv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos4iv) +ManPageAlias(glRasterPos2d, $(LIBMANDIR), glRasterPos4sv) + +LinkFile(glReadBuffer.$(MANSUFFIX), readbuffer.3gl) + +LinkFile(glReadPixels.$(MANSUFFIX), readpixels.3gl) + +LinkFile(glRectd.$(MANSUFFIX), rect.3gl) +ManPageAlias(glRectd, $(LIBMANDIR), glRectf) +ManPageAlias(glRectd, $(LIBMANDIR), glRecti) +ManPageAlias(glRectd, $(LIBMANDIR), glRects) +ManPageAlias(glRectd, $(LIBMANDIR), glRectdv) +ManPageAlias(glRectd, $(LIBMANDIR), glRectfv) +ManPageAlias(glRectd, $(LIBMANDIR), glRectiv) +ManPageAlias(glRectd, $(LIBMANDIR), glRectsv) + +LinkFile(glRenderMode.$(MANSUFFIX), rendermode.3gl) + +LinkFile(glRotated.$(MANSUFFIX), rotate.3gl) +ManPageAlias(glRotated, $(LIBMANDIR), glRotatef) + +LinkFile(glScaled.$(MANSUFFIX), scale.3gl) +ManPageAlias(glScaled, $(LIBMANDIR), glScalef) + +LinkFile(glScissor.$(MANSUFFIX), scissor.3gl) + +LinkFile(glSelectBuffer.$(MANSUFFIX), selectbuffer.3gl) + +LinkFile(glShadeModel.$(MANSUFFIX), shademodel.3gl) + +LinkFile(glStencilFunc.$(MANSUFFIX), stencilfunc.3gl) + +LinkFile(glStencilMask.$(MANSUFFIX), stencilmask.3gl) + +LinkFile(glStencilOp.$(MANSUFFIX), stencilop.3gl) + +LinkFile(glTexCoord1d.$(MANSUFFIX), texcoord.3gl) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord1f) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord1i) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord1s) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord2d) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord2f) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord2i) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord2s) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord3d) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord3f) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord3i) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord3s) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord4d) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord4f) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord4i) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord4s) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord1dv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord1fv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord1iv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord1sv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord2dv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord2fv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord2iv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord2sv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord3dv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord3fv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord3iv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord3sv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord4dv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord4fv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord4iv) +ManPageAlias(glTexCoord1d, $(LIBMANDIR), glTexCoord4sv) + +LinkFile(glTexCoordPointer.$(MANSUFFIX), texcoordpointer.3gl) + +LinkFile(glTexEnvf.$(MANSUFFIX), texenv.3gl) +ManPageAlias(glTexEnvf, $(LIBMANDIR), glTexEnvi) +ManPageAlias(glTexEnvf, $(LIBMANDIR), glTexEnvfv) +ManPageAlias(glTexEnvf, $(LIBMANDIR), glTexEnviv) + +LinkFile(glTexGend.$(MANSUFFIX), texgen.3gl) +ManPageAlias(glTexGend, $(LIBMANDIR), glTexGenf) +ManPageAlias(glTexGend, $(LIBMANDIR), glTexGeni) +ManPageAlias(glTexGend, $(LIBMANDIR), glTexGendv) +ManPageAlias(glTexGend, $(LIBMANDIR), glTexGenfv) +ManPageAlias(glTexGend, $(LIBMANDIR), glTexGeniv) + +LinkFile(glTexImage1D.$(MANSUFFIX), teximage1d.3gl) + +LinkFile(glTexImage2D.$(MANSUFFIX), teximage2d.3gl) + +LinkFile(glTexParameterf.$(MANSUFFIX), texparameter.3gl) +ManPageAlias(glTexParameterf, $(LIBMANDIR), glTexParameteri) +ManPageAlias(glTexParameterf, $(LIBMANDIR), glTexParameterfv) +ManPageAlias(glTexParameterf, $(LIBMANDIR), glTexParameteriv) + +LinkFile(glTexSubImage1D.$(MANSUFFIX), texsubimage1d.3gl) + +LinkFile(glTexSubImage2D.$(MANSUFFIX), texsubimage2d.3gl) + +LinkFile(glTranslated.$(MANSUFFIX), translate.3gl) +ManPageAlias(glTranslated, $(LIBMANDIR), glTranslatef) + +LinkFile(glVertex2d.$(MANSUFFIX), vertex.3gl) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex2f) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex2i) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex2s) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex3d) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex3f) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex3i) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex3s) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex4d) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex4f) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex4i) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex4s) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex2dv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex2fv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex2iv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex2sv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex3dv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex3fv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex3iv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex3sv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex4dv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex4fv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex4iv) +ManPageAlias(glVertex2d, $(LIBMANDIR), glVertex4sv) + +LinkFile(glVertexPointer.$(MANSUFFIX), vertexpointer.3gl) + +LinkFile(glViewport.$(MANSUFFIX), viewport.3gl) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/RULES b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/RULES new file mode 100644 index 000000000..e6871911d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/RULES @@ -0,0 +1,89 @@ +Rules for Open GL man pages: + + * Describe commands that differ only by a suffix on the same + page. Do this regardless of whether the commands take the + same or different arguments. For example, all 24 Vertex + commands are described on one page. + + Issue - current tools like to separate v and non-v commands. + + * Describe commands that operate in obvious pairs on the same + page. For example, Begin and End, or PushMatrix and PopMatrix. + + * Use the _header(desc) macro to begin a manpage. Write the + 1-line command description "desc" using the imperative tense. + For example: + + _header(Operate on the accumulation buffer) + + not + _header(Operates on the accumulation buffer) + + * The order of the entries on a manpage is + + header + PARAMETERS (unless the command takes no parameters) + DESCRIPTION + EXAMPLE (optional) + ERRORS (optional) + SEE ALSO + BUGS (optional) + NOTES (optional) + + * Use the _phead(param) macro to describe each parameter or + group of parameters. + + * Begin the description of in-only parameters with the phrase + "Specifies". + + * Begin the description of out-only parameters with the phrase + "Returns". + + * Begin the description of in-and-out parameters with the + phrase "Specifies and returns". If there is a difference + between what is specified and what is returned, use two + paragraphs for the description, the first beginning with + "Specifies" and the second beginning with "Returns". + + * Group like parameters into a single description. For example + "x,y Specify the x and y coordinates ...", or + "r,g,b Return the red, green, and blue color values ..." + + Possible tools issue. + + * Include the default value in the description of parameters + that directly specify GL state. + + * Refer to parameters using the _param# macro, never explicitly + by name. Note that this rules out clever English tricks that + count on the macro evaluating to a particular string. For + example, one cannot say "The second parameter is a floating + point _param2", where it is expected that _param2 will evaluate + to the string "value". + + * Use _cmnd to refer to the command being described. + + * Use _cmnd(basename) to refer to another command. Note that + basename does not include any prefix, it is added automatically + by the _cmnd() macro. + + * Use _const(basename) to refer to a constant. Note that + basename does not include any prefix, it is added automatically + by the _const() macro. + + * Use _hex(value) to refer to a hexidecimal value. + (This should not be required very often in the Open GL.) + + * List commands in the see also section in alphabetical order. + Include commands that return all the state that is set by + the command being documented. + +Limitations of the alpha release: + + * The header, command syntax, parameter descriptions, and see + also sections will be complete. + + * The command description may not be complete, but it will at + least exist. + + * The example section may not exist. diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/accum.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/accum.gl new file mode 100644 index 000000000..5245f738b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/accum.gl @@ -0,0 +1,170 @@ +_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(Accum,operate on the accumulation buffer) +_names(Accum) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the accumulation buffer operation. +Symbolic constants +_const(ACCUM), +_const(LOAD), +_const(ADD), +_const(MULT), +and +_const(RETURN) are accepted. +_phead(_param2) +Specifies a floating-point value used in the accumulation buffer operation. +_param1 determines how _param2 is used. +.SH DESCRIPTION +The accumulation buffer is an extended-range color buffer. +Images are not rendered into it. +Rather, +images rendered into one of the color buffers +are added to the contents of the accumulation buffer after rendering. +Effects such as antialiasing (of points, lines, and polygons), +motion blur, +and depth of field can be created +by accumulating images generated with different transformation matrices. +.P +Each pixel in the accumulation buffer consists of +red, green, blue, and alpha values. +The number of bits per component in the accumulation buffer +depends on the implementation. You can examine this number +by calling _cmnd(GetIntegerv) four times, +with arguments _const(ACCUM_RED_BITS), +_const(ACCUM_GREEN_BITS), +_const(ACCUM_BLUE_BITS), +and _const(ACCUM_ALPHA_BITS). +Regardless of the number of bits per component, +the range of values stored by each component is [\-1,\ 1]. +The accumulation buffer pixels are mapped one-to-one with frame buffer pixels. +.P +_cmnd operates on the accumulation buffer. +The first argument, _param1, +is a symbolic constant that selects an accumulation buffer operation. +The second argument, _param2, +is a floating-point value to be used in that operation. +Five operations are specified: +_const(ACCUM), _const(LOAD), _const(ADD), +_const(MULT), and _const(RETURN). +.P +All accumulation buffer operations are limited +to the area of the current scissor box and applied identically to +the red, green, blue, and alpha components of each pixel. +If a _cmnd operation results in a value outside the range [\-1,\ 1], +the contents of an accumulation buffer pixel component are undefined. +.P +The operations are as follows: +.TP 14 +_const(ACCUM) +Obtains R, G, B, and A values +from the buffer currently selected for reading (see _cmnd(ReadBuffer)). +Each component value is divided by $2 sup n^-^1$, +where $n$ is the number of bits allocated to each color component +in the currently selected buffer. +The result is a floating-point value in the range [0,\ 1], +which is multiplied by _param2 and added to the corresponding pixel component +in the accumulation buffer, +thereby updating the accumulation buffer. +.TP +_const(LOAD) +Similar to _const(ACCUM), +except that the current value in the accumulation buffer is not used +in the calculation of the new value. +That is, the R, G, B, and A values from the currently selected buffer +are divided by $2 sup n^-^1$, +multiplied by _param2, +and then stored in the corresponding accumulation buffer cell, +overwriting the current value. +.TP +_const(ADD) +Adds _param2 to each R, G, B, and A +in the accumulation buffer. +.TP +_const(MULT) +Multiplies each R, G, B, and A +in the accumulation buffer by _param2 and returns the scaled component +to its corresponding accumulation buffer location. +.TP +_const(RETURN) +Transfers accumulation buffer values +to the color buffer or buffers currently selected for writing. +Each R, G, B, and A component is multiplied by _param2, +then multiplied by $2 sup n^-^1$, +clamped to the range [0,$~2 sup n^-^1 $], and stored +in the corresponding display buffer cell. +The only fragment operations that are applied to this transfer are +pixel ownership, +scissor, +dithering, +and color writemasks. +.P +To clear the accumulation buffer, call _cmnd(ClearAccum) with R, G, B, +and A values to set it to, then call _cmnd(Clear) with the +accumulation buffer enabled. +.SH NOTES +Only pixels within the current scissor box are updated by a +_cmnd operation. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_OPERATION) is generated if there is no accumulation buffer. +.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(Get) with argument _const(ACCUM_RED_BITS) +.br +_cmnd(Get) with argument _const(ACCUM_GREEN_BITS) +.br +_cmnd(Get) with argument _const(ACCUM_BLUE_BITS) +.br +_cmnd(Get) with argument _const(ACCUM_ALPHA_BITS) +.SH SEE ALSO +_cmnd(Clear), +_cmnd(ClearAccum), +_cmnd(CopyPixels), +_cmnd(DrawBuffer), +_cmnd(Get), +_cmnd(ReadBuffer), +_cmnd(ReadPixels), +_cmnd(Scissor), +_cmnd(StencilOp) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/activetextureARB.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/activetextureARB.gl new file mode 100644 index 000000000..93afde44f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/activetextureARB.gl @@ -0,0 +1,70 @@ +_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,eqn|tbl)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(ActiveTextureARB, select active texture unit) +_names(ActiveTextureARB) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies which texture unit to make active. The number +of texture units is implementation dependent, but must be at least +two. _param1 must be one of _arbconstidx(TEXTURE), where +0 \(<= $ i $ < _arbconst(MAX_TEXTURE_UNITS), which is an +implementation-dependent value. The intial value is _arbconst(TEXTURE0). +.SH DESCRIPTION +_cmnd selects which texture unit subsequent texture state calls will +affect. The number of texture units an implementation supports is +implementation dependent, but must be at least 2. +.P +Vertex arrays are client-side GL resources, which are selected by the +_cmnd(ClientActiveTextureARB) routine. +.SH NOTES +_cmnd is only supported if _arbstring(multitexture) is included in the +string returned by _cmnd(GetString) when called with the argument +_const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of +_arbconstidx(TEXTURE), +.br +where 0 \(<= $ i $ < _arbconst(MAX_TEXTURE_UNITS). +.SH SEE ALSO +_cmnd(ClientActiveTextureARB), +_cmnd(GetIntegerv), +_cmnd(MultiTexCoordARB), +_cmnd(TexParameter) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/alphafunc.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/alphafunc.gl new file mode 100644 index 000000000..1bdc2f682 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/alphafunc.gl @@ -0,0 +1,128 @@ +_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(AlphaFunc,specify the alpha test function) +_names(AlphaFunc) +.SH PARAMETERS +_phead(_param1) +Specifies the alpha comparison function. +Symbolic constants +_const(NEVER), +_const(LESS), +_const(EQUAL), +_const(LEQUAL), +_const(GREATER), +_const(NOTEQUAL), +_const(GEQUAL), and +_const(ALWAYS) are accepted. The initial value is _const(ALWAYS). +_phead(_param2) +Specifies the reference value that incoming alpha values are compared to. +This value is clamped to the range [0,\ 1], +where 0 represents the lowest possible alpha value +and 1 the highest possible value. +The initial reference value is 0. +.SH DESCRIPTION +The alpha test discards fragments depending on the outcome of a comparison +between an incoming fragment's alpha value and a constant reference value. +_cmnd specifies the reference value and the comparison function. +The comparison is performed only if alpha testing is enabled. By +default, it is not enabled. +(See +_cmnd(Enable) and _cmnd(Disable) of _const(ALPHA_TEST).) +.P +_param1 and _param2 specify the conditions under which +the pixel is drawn. +The incoming alpha value is compared to _param2 +using the function specified by _param1. +If the value passes the comparison, +the incoming fragment is drawn +if it also passes subsequent stencil and depth buffer tests. +If the value fails the comparison, +no change is made to the frame buffer at that pixel location. The +comparison functions are as follows: +.TP 18 +_const(NEVER) +Never passes. +.TP +_const(LESS) +Passes if the incoming alpha value is less than the reference value. +.TP +_const(EQUAL) +Passes if the incoming alpha value is equal to the reference value. +.TP +_const(LEQUAL) +Passes if the incoming alpha value is less than or equal to the reference value. +.TP +_const(GREATER) +Passes if the incoming alpha value is greater than the reference value. +.TP +_const(NOTEQUAL) +Passes if the incoming alpha value is not equal to the reference value. +.TP +_const(GEQUAL) +Passes if the incoming alpha value is greater than or equal to +the reference value. +.TP +_const(ALWAYS) +Always passes (initial value). +.P +_cmnd operates on all pixel write operations, +including those resulting from the scan conversion of points, +lines, +polygons, +and bitmaps, +and from pixel draw and copy operations. +_cmnd does not affect screen clear operations. +.SH NOTES +Alpha testing is performed only in RGBA mode. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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(Get) with argument _const(ALPHA_TEST_FUNC) +.br +_cmnd(Get) with argument _const(ALPHA_TEST_REF) +.br +_cmnd(IsEnabled) with argument _const(ALPHA_TEST) +.SH SEE ALSO +_cmnd(BlendFunc), +_cmnd(Clear), +_cmnd(DepthFunc), +_cmnd(Enable), +_cmnd(StencilFunc) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/aretexturesresident.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/aretexturesresident.gl new file mode 100644 index 000000000..1aef150e7 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/aretexturesresident.gl @@ -0,0 +1,106 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(AreTexturesResident,determine if textures are loaded in texture memory) +_names(AreTexturesResident) +.SH PARAMETERS +_define(@<__n>@,@<_param1>@)_C_ +_define(@<__textures>@,@<_param2>@)_C_ +_define(@<__residences>@,@<_param3>@)_C_ +_phead(__n) +Specifies the number of textures to be queried. +_phead(__textures) +Specifies an array containing the names of the textures to be queried. +_phead(__residences) +Specifies an array in which the texture residence status is returned. +The residence status of a texture named by an element of __textures is +returned in the corresponding element of __residences. +.SH DESCRIPTION +GL establishes +a ``working set'' of textures that are resident in texture memory. +These textures can be bound to a texture target much more efficiently +than textures that are not resident. +.P +_cmnd queries the texture residence status of the __n textures named by +the elements of __textures. +If all the named textures are resident, +_cmnd returns _const(TRUE), +and the contents of __residences are undisturbed. +If not all the named textures are resident, _cmnd returns _const(FALSE), +and detailed status is returned in the __n elements of __residences. +If an element of __residences is _const(TRUE), then the texture named by +the corresponding element of __textures is resident. +.P +The residence status of a single bound texture may also be queried +by calling +_cmnd(GetTexParameter) with the \f2target\fP argument set to the +target to which the texture is bound, and the \f2pname\fP argument +set to _const(TEXTURE_RESIDENT). +This is the only way that the residence status of a default texture can be +queried. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +_cmnd returns the residency status of the textures at the time of +invocation. It does not guarantee that the textures will remain +resident at any other time. +.P +If textures reside in virtual memory (there is no texture memory), they +are considered always resident. +.P +Some implementations may not load a texture until the first use of +that texture. +.SH ERRORS +_const(INVALID_VALUE) is generated if __n is negative. +.P +_const(INVALID_VALUE) is generated if any element in __textures +is 0 or does not name a texture. In that case, the function returns +_const(FALSE) and the contents of _param3 is indeterminate. +.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(GetTexParameter) with parameter name _const(TEXTURE_RESIDENT) +retrieves the residence status of a currently bound texture. +.SH SEE ALSO +_cmnd(BindTexture), +_cmnd(GetTexParameter), +_cmnd(PrioritizeTextures), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/arrayelement.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/arrayelement.gl new file mode 100644 index 000000000..fa679b4a0 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/arrayelement.gl @@ -0,0 +1,106 @@ +_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_ +_C_ Anything on a line after _C_ is ignored +_C_ +_C_ A real line follows. +_C_ +_define(_filters,tbl|eqn)_C_ +_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ +_C_ Use GL not OpenGL +_C_ +_C_ Don't change the ordering of the main headers. +_C_ +_C_ C specification (or fortran) is handled automatically +_C_ +_C_ .TH is automatically added to the top of this file. +_C_ +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_C_ +_C_ The function name must appear in (APIFILE) (usually gl.h) as set in +_C_ Makefile. +_header(ArrayElement,render a vertex using the specified vertex array element) +_names(ArrayElement) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies an index into the enabled vertex data arrays. +.SH DESCRIPTION +_cmnd commands are used within _cmnd(Begin)/_cmnd(End) pairs to +specify vertex and attribute data for point, line, and polygon +primitives. If _const(VERTEX_ARRAY) is enabled when _cmnd is called, a +single vertex is drawn, using +vertex and attribute data taken from location _param1 of the enabled +arrays. If _const(VERTEX_ARRAY) is not enabled, no drawing occurs but +the attributes corresponding to the enabled arrays are modified. +.P +Use _cmnd to construct primitives by indexing vertex data, rather than +by streaming through arrays of data in first-to-last order. Because +each call specifies only a single vertex, it is possible to explicitly +specify per-primitive attributes such as a single normal per +individual triangle. +.P +Changes made to array data between the execution of _cmnd(Begin) and the +corresponding execution of _cmnd(End) may affect calls to _cmnd that are made +within the same _cmnd(Begin)/_cmnd(End) period in non-sequential ways. +That is, a call to +.br +_cmnd that precedes a change to array data may +access the changed data, and a call that follows a change to array data +may access original data. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +_cmnd is included in display lists. If _cmnd is entered into a +display list, the necessary array data (determined by the array +pointers and enables) is also entered into the display list. Because +the array pointers and enables are client-side state, their values +affect display lists when the lists are created, not when the lists +are executed. +.SH SEE ALSO +_cmnd(ClientActiveTextureARB), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(EdgeFlagPointer), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(NormalPointer), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) 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 new file mode 100644 index 000000000..6e08bb1b0 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/begin.gl @@ -0,0 +1,229 @@ +_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) + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/bindtexture.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/bindtexture.gl new file mode 100644 index 000000000..077b8b10c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/bindtexture.gl @@ -0,0 +1,128 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(BindTexture,bind a named texture to a texturing target) +_names(BindTexture) +.SH PARAMETERS +_phead(_param1) +Specifies the target to which the texture is bound. +Must be either +_const(TEXTURE_1D), +_const(TEXTURE_2D), or +_const(TEXTURE_3D). +_phead(_param2) +Specifies the name of a texture. +.SH DESCRIPTION +_cmnd lets you create or use a named texture. Calling _cmnd with +.br +_param1 set to +_const(TEXTURE_1D), _const(TEXTURE_2D), _const(TEXTURE_3D) and _param2 +set to the name +of the newtexture binds the texture name to the target. +When a texture is bound to a target, the previous binding for that +target is automatically broken. +.P +Texture names are unsigned integers. The value zero is reserved to +represent the default texture for each texture target. +Texture names and the corresponding texture contents are local to +the shared display-list space (see _cmnd(XCreateContext)) of the current +GL rendering context; +two rendering contexts share texture names only if they +also share display lists. +.P +You may use _cmnd(GenTextures) to generate a set of new texture names. +.P +When a texture is first bound, it assumes the dimensionality of its +target: A texture first bound to _const(TEXTURE_1D) becomes +one-dimensional, and a texture first bound to _const(TEXTURE_2D) becomes +two-dimensional, and a texture first bound to _const(TEXTURE_3D) becomes +a three-dimensional texture. The state of a one-dimensional texture +immediately after it is first bound is equivalent to the state of the +default _const(TEXTURE_1D) at GL initialization, and similarly for +two-, and three-dimensional textures. +.P +While a texture is bound, GL operations on the target to which it is +bound affect the bound texture, and queries of the target to which it +is bound return state from the bound texture. If texture mapping of +the dimensionality of the target to which a texture is bound is +active, the bound texture is used. +In effect, the texture targets become aliases for the textures currently +bound to them, and the texture name zero refers to the default textures +that were bound to them at initialization. +.P +A texture binding created with _cmnd remains active until a different +texture is bound to the same target, or until the bound texture is +deleted with _cmnd(DeleteTextures). +.P +Once created, a named texture may be re-bound to the target of the +matching dimensionality as often as needed. +It is usually much faster to use _cmnd to bind an existing named +texture to one of the texture targets than it is to reload the texture image +using _cmnd(TexImage1D), _cmnd(TexImage2D), or _cmnd(TexImage3D). +For additional control over performance, use +_cmnd(PrioritizeTextures). +.P +_cmnd is included in display lists. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _param2 has a dimensionality +that doesn't match that of _param1. +.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(Get) with argument _const(TEXTURE_BINDING_1D) +.br +_cmnd(Get) with argument _const(TEXTURE_BINDING_2D) +.br +_cmnd(Get) with argument _const(TEXTURE_BINDING_3D) +.SH SEE ALSO +_cmnd(AreTexturesResident), +_cmnd(DeleteTextures), +_cmnd(GenTextures), +_cmnd(Get), +.br +_cmnd(GetTexParameter), +_cmnd(IsTexture), +_cmnd(PrioritizeTextures), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/bitmap.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/bitmap.gl new file mode 100644 index 000000000..bd628ae9f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/bitmap.gl @@ -0,0 +1,138 @@ +_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(Bitmap,draw a bitmap) +_names(Bitmap) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2) +Specify the pixel width and height of the bitmap image. +_phead(_param3 _param4) +Specify the location of the origin in the bitmap image. +The origin is measured from the lower left corner of the bitmap, +with right and up being the positive axes. +_phead(_param5 _param6) +Specify the \f2x\fP and \f2y\fP offsets to be added to the current raster position +after the bitmap is drawn. +_phead(_param7) +Specifies the address of the bitmap image. +.SH DESCRIPTION +A bitmap is a binary image. +When drawn, +the bitmap is positioned relative to the current raster position, +and frame buffer pixels corresponding to 1's in the bitmap are +written using the current raster color or index. +Frame buffer pixels corresponding to 0's in the bitmap are not modified. +.P +_cmnd takes seven arguments. +The first pair specifies the width and height of the bitmap image. +The second pair specifies the location of the bitmap origin relative +to the lower left corner of the bitmap image. +The third pair of arguments specifies \f2x\fP and \f2y\fP offsets to be added +to the current raster position after the bitmap has been drawn. +The final argument is a pointer to the bitmap image itself. +.P +The bitmap image is interpreted like image data for the _cmnd(DrawPixels) +command, +with _param1 and _param2 corresponding to the width and height arguments +of that command, +and with \f2type\fP set to _const(BITMAP) +and \f2format\fP set to _const(COLOR_INDEX). +.BP +Modes specified using _cmnd(PixelStore) affect the +interpretation of bitmap image data; +modes specified using _cmnd(PixelTransfer) do not. +.P +If the current raster position is invalid, _cmnd is ignored. +Otherwise, +the lower left corner of the bitmap image is positioned at the window coordinates +.ce +.sp +$ x sub w ~=~ \(lf ~ x sub r ~-~ x sub o ~ \(rf $ +.br +.sp +.ce +$ y sub w ~=~ \(lf ~ y sub r ~-~ y sub o ~ \(rf $ +.sp +where $ ( x sub r , y sub r ) $ is the raster position +and $ ( x sub o , y sub o ) $ is the bitmap origin. +Fragments are then generated for each pixel corresponding to a 1 (one) +in the bitmap image. +These fragments are generated using the current raster \f2z\fP coordinate, +color or color index, and current raster texture coordinates. +They are then treated just as if they had been generated +by a point, line, or polygon, +including texture mapping, +.br +fogging, +and all per-fragment operations such as alpha and depth testing. +.P +After the bitmap has been drawn, +the \f2x\fP and \f2y\fP coordinates of the current raster position are offset by +_param5 and _param6. +No change is made to the \f2z\fP coordinate of the current raster position, +or to the current raster color, texture coordinates, or index. +.SH NOTES +To set a valid raster position outside the viewport, first set a valid +raster position inside the viewport, then call _cmnd(Bitmap) with NULL +as the _param7 parameter and with _param5 and _param6 set to +the offsets of the new raster position. This technique is useful when +panning an image around the viewport. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 or _param2 is negative. +.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(Get) with argument _const(CURRENT_RASTER_POSITION) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_COLOR) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_DISTANCE) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_INDEX) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_TEXTURE_COORDS) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_POSITION_VALID) +.SH SEE ALSO +_cmnd(DrawPixels), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(RasterPos) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/blendcolor.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/blendcolor.gl new file mode 100644 index 000000000..2bae420ab --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/blendcolor.gl @@ -0,0 +1,65 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(BlendColor, set the blend color) +_names(BlendColor) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2 _param3 _param4) +specify the components of _const(BLEND_COLOR) +.SH DESCRIPTION +The _const(BLEND_COLOR) may be used to calculate the source and destination +blending factors. The color components are clamped to the range [0,\ 1] +before being stored. See _cmnd(BlendFunc) for a complete description of the +blending operations. +Initially the _const(BLEND_COLOR) is set to (0, 0, 0, 0). +.SH NOTES +_cmnd is part of the _arbstring(imaging) subset. _cmnd is present only +if _arbstring(imaging) is returned when _cmnd(GetString) is called with +_const(EXTENSIONS) as its argument. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +.SH ASSOCIATED GETS +_cmnd(Get) with an argument of _const(BLEND_COLOR) +.SH SEE ALSO +_cmnd(BlendEquation), +_cmnd(BlendFunc), +_cmnd(GetString) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/blendequation.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/blendequation.gl new file mode 100644 index 000000000..f3c49cda3 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/blendequation.gl @@ -0,0 +1,163 @@ +_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(BlendEquation, set the blend equation) +_names(BlendEquation) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +specifies how source and destination colors are combined. +It must be _const(FUNC_ADD), _const(FUNC_SUBTRACT), +_const(FUNC_REVERSE_SUBTRACT), _const(MIN), _const(MAX). + +.SH DESCRIPTION +The blend equation determines how a new pixel (the ``source'' color) +is combined with a pixel already in the framebuffer (the ``destination'' +color). +.TP +_const(MIN) +sets the blend equation so that each component of the result color +is the minimum of the corresponding components of the source and destination +colors. +.TP +_const(MAX) +sets the blend equation so that each component of the result color +is the maximum of the corresponding components of the source and destination +colors. +.P +The remaining blend equations use the source and destination blend factors +specified by _cmnd(BlendFunc). +See _cmnd(BlendFunc) for a description of the various blend factors. +.P +In the equations that follow, source and destination +color components are referred to as +$(R sub s, G sub s, B sub s, A sub s )$ +and +$(R sub d, G sub d, B sub d, A sub d )$, +respectively. +The result color is referred to as +$(R sub r, G sub r, B sub r, A sub r )$. +The source and destination blend factors are denoted +$(s sub R, s sub G, s sub B, s sub A )$ and +$(d sub R, d sub G, d sub B, d sub A )$, respectively. +For these equations all color components are understood to have values +in the range [0,\ 1]. +.TP +_const(FUNC_ADD) +sets the blend equation so that the source and destination +data are added. +Each component of the source color is +multiplied by the corresponding source factor, then +each component of the destination color is multiplied +by the corresponding destination factor. +The result is the componentwise sum of the two products, clamped to the +range [0,\ 1]. +.P +.RS +.nf +.IP +$Rr ~=~ mark min (1, ~R sub s~s sub R ~+~ R sub d~d sub R )$ +$Gr ~=~ lineup min (1, ~G sub s~s sub G ~+~ G sub d~d sub G )$ +$Br ~=~ lineup min (1, ~B sub s~s sub B ~+~ B sub d~d sub B )$ +$Ar ~=~ lineup min (1, ~A sub s~s sub A ~+~ A sub d~d sub A )$ +.fi +.RE +.TP +_const(FUNC_SUBTRACT) +Is like _const(FUNC_ADD) except the product of the destination factor and +the destination color is componentwise subtracted from the product of the +source factor and the source color. +The result is clamped to the range [0,\ 1]. +.RS +.nf +.IP +$Rr ~=~ mark max (0 , ~R sub s~s sub R ~-~ R sub d~d sub R )$ +$Gr ~=~ lineup max (0 , ~G sub s~s sub G ~-~ G sub d~d sub G )$ +$Br ~=~ lineup max (0 , ~B sub s~s sub B ~-~ B sub d~d sub B )$ +$Ar ~=~ lineup max (0 , ~A sub s~s sub A ~-~ A sub d~d sub A )$ +.fi +.RE +.TP +_const(FUNC_REVERSE_SUBTRACT) +Is like _const(FUNC_ADD) except the product of the source factor and the +source color is componentwise subtracted from the product of the destination +factor and the destination color. +The result is clamped to the range [0,\ 1]. +.RS +.nf +.IP +$Rr ~=~ mark max (0 , ~R sub d~d sub R ~-~ R sub s~s sub R )$ +$Gr ~=~ lineup max (0 , ~G sub d~d sub G ~-~ G sub s~s sub G )$ +$Br ~=~ lineup max (0 , ~B sub d~d sub B ~-~ B sub s~s sub B )$ +$Ar ~=~ lineup max (0 , ~A sub d~d sub A ~-~ A sub s~s sub A )$ +.fi +.RE +.P +The _const(MIN) and _const(MAX) equations are useful for applications +that analyze +.br +image data (image thresholding against a constant color, +for example). +The _const(FUNC_ADD) equation is useful +for antialiasing and transparency, among other things. +.P +Initially, the blend equation is set to _const(FUNC_ADD). +.P +.SH NOTES +_cmnd is part of the _arbstring(imaging) subset. _cmnd is present only +if _arbstring(imaging) is returned when _cmnd(GetString) is called with +_const(EXTENSIONS) as its argument. +.P +The _const(MIN), and _const(MAX) equations do not use +the source or destination factors, only the source and destination colors. +.P +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of +_const(FUNC_ADD), _const(FUNC_SUBTRACT), _const(FUNC_REVERSE_SUBTRACT), +_const(MAX), or _const(MIN). +.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 +.TP +_cmnd(Get) with an argument of _const(BLEND_EQUATION) +.SH SEE ALSO +_cmnd(GetString), +_cmnd(BlendColor), +_cmnd(BlendFunc) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/blendfunc.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/blendfunc.gl new file mode 100644 index 000000000..7afec2732 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/blendfunc.gl @@ -0,0 +1,264 @@ +_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(BlendFunc, specify pixel arithmetic) +_names(BlendFunc) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies how the red, green, blue, +and alpha source blending factors are computed. +The following symbolic constants are accepted: +_const(ZERO), +_const(ONE), +_const(DST_COLOR), +_const(ONE_MINUS_DST_COLOR), +_const(SRC_ALPHA), +_const(ONE_MINUS_SRC_ALPHA), +_const(DST_ALPHA), +_const(ONE_MINUS_DST_ALPHA), and +_const(SRC_ALPHA_SATURATE). +The initial value is _const(ONE). +.TE + +Additionally, if the _arbstring(imaging) extension is supported, the +following constants are accepted: +_const(CONSTANT_COLOR), +_const(ONE_MINUS_CONSTANT_COLOR), +_const(CONSTANT_ALPHA), +_const(ONE_MINUS_CONSTANT_ALPHA). +_phead(_param2) +Specifies how the red, green, blue, +and alpha destination blending factors are computed. +Eight symbolic constants are accepted: +_const(ZERO), +_const(ONE), +_const(SRC_COLOR), +_const(ONE_MINUS_SRC_COLOR), +_const(SRC_ALPHA), +_const(ONE_MINUS_SRC_ALPHA), +_const(DST_ALPHA), and +_const(ONE_MINUS_DST_ALPHA). +The initial value is _const(ZERO). +.TE + +Additionally, if the _arbstring(imaging) extension is supported, the +following constants are accepted: +_const(CONSTANT_COLOR), +_const(ONE_MINUS_CONSTANT_COLOR), +_const(CONSTANT_ALPHA), +_const(ONE_MINUS_CONSTANT_ALPHA). +.SH DESCRIPTION +In RGBA mode, pixels can be drawn using a function that blends +the incoming (source) RGBA values with the RGBA values +that are already in the frame buffer (the destination values). +Blending is initially disabled. +Use _cmnd(Enable) and _cmnd(Disable) with argument _const(BLEND) +to enable and disable blending. +.P +_cmnd defines the operation of blending when it is enabled. +_param1 specifies which of nine methods is used to scale the +source color components. +_param2 specifies which of eight methods is used to scale the +destination color components. +The eleven possible methods are described in the following table. +Each method defines four scale factors, +one each for red, green, blue, and alpha. +.P +In the table and in subsequent equations, source and destination +color components are referred to as +$(R sub s , G sub s , B sub s , A sub s )$ and +$(R sub d , G sub d , B sub d , A sub d )$. +The color specified by _cmnd(BlendColor) is referred to as +$(R sub c , G sub c , B sub c , A sub c )$. +They are understood to have integer values between 0 and +$(k sub R , k sub G , k sub B , k sub A )$, +where +.P +.RS +.ce +$k sub c ~=~ 2 sup m sub c - 1$ +.RE +.P +and +$(m sub R , m sub G , m sub B , m sub A )$ +is the number of red, +green, +blue, +and alpha bitplanes. +.P +Source and destination scale factors are referred to as +$(s sub R , s sub G , s sub B , s sub A )$ and +$(d sub R , d sub G , d sub B , d sub A )$. +The scale factors described in the table, +denoted $(f sub R , f sub G , f sub B , f sub A )$, +represent either source or destination factors. +All scale factors have range [0,\ 1]. +.P +.TS +center; +lb cb +l c . +_ +Parameter $(f sub R , ~~ f sub G , ~~ f sub B , ~~ f sub A )$ +_ +_const(ZERO) $(0, ~0, ~0, ~0 )$ +_const(ONE) $(1, ~1, ~1, ~1 )$ +_const(SRC_COLOR) $(R sub s / k sub R , ~G sub s / k sub G , ~B sub s / k sub B , ~A sub s / k sub A )$ +_const(ONE_MINUS_SRC_COLOR) $(1, ~1, ~1, ~1 ) ~-~ (R sub s / k sub R , ~G sub s / k sub G , ~B sub s / k sub B , ~A sub s / k sub A )$ +_const(DST_COLOR) $(R sub d / k sub R , ~G sub d / k sub G , ~B sub d / k sub B , ~A sub d / k sub A )$ +_const(ONE_MINUS_DST_COLOR) $(1, ~1, ~1, ~1 ) ~-~ (R sub d / k sub R , ~G sub d / k sub G , ~B sub d / k sub B , ~A sub d / k sub A )$ +_const(SRC_ALPHA) $(A sub s / k sub A , ~A sub s / k sub A , ~A sub s / k sub A , ~A sub s / k sub A )$ +_const(ONE_MINUS_SRC_ALPHA) $(1, ~1, ~1, ~1 ) ~-~ (A sub s / k sub A , ~A sub s / k sub A , ~A sub s / k sub A , ~A sub s / k sub A )$ +_const(DST_ALPHA) $(A sub d / k sub A , ~A sub d / k sub A , ~A sub d / k sub A , ~A sub d / k sub A )$ +_const(ONE_MINUS_DST_ALPHA) $(1, ~1, ~1, ~1 ) ~-~ (A sub d / k sub A , ~A sub d / k sub A , ~A sub d / k sub A , ~A sub d / k sub A )$ +_const(SRC_ALPHA_SATURATE) $(i, ~i, ~i, ~1 )$ +_const(CONSTANT_COLOR) $(R sub c, G sub c, B sub c, A sub c)$ +_const(ONE_MINUS_CONSTANT_COLOR) $(1, ~1, ~1, ~1 ) ~-~ (R sub c, G sub c, B sub c, A sub c)$ +_const(CONSTANT_ALPHA) $(A sub c, A sub c, A sub c, A sub c)$ +_const(ONE_MINUS_CONSTANT_ALPHA) $(1, ~1, ~1, ~1 ) ~-~ (A sub c, A sub c, A sub c, A sub c)$ +_ +.TE +.sp +In the table, +.P +.RS +.nf +.IP +$i ~=~ min (A sub s , ~k sub A ~-~ A sub d ) ~/~ k sub A$ +.fi +.RE +.P +To determine the blended RGBA values of a pixel when drawing in RGBA mode, +the system uses the following equations: +.P +.RS +.nf +.IP +$R sub d ~=~ mark min ( k sub R, ~R sub s~s sub R~+~R sub d~d sub R )$ +$G sub d ~=~ lineup min ( k sub G, ~G sub s~s sub G~+~G sub d~d sub G )$ +$B sub d ~=~ lineup min ( k sub B, ~B sub s~s sub B~+~B sub d~d sub B )$ +$A sub d ~=~ lineup min ( k sub A, ~A sub s~s sub A~+~A sub d~d sub A )$ +.fi +.RE +.P +Despite the apparent precision of the above equations, +blending arithmetic is not exactly specified, +because blending operates with imprecise integer color values. +However, +a blend factor that should be equal to 1 +is guaranteed not to modify its multiplicand, +and a blend factor equal to 0 reduces its multiplicand to 0. +For example, +when _param1 is _const(SRC_ALPHA), +_param2 is _const(ONE_MINUS_SRC_ALPHA), +and $A sub s$ is equal to $k sub A$, +the equations reduce to simple replacement: +.P +.RS +.nf +.IP +$R sub d ~=~ mark R sub s$ +$G sub d ~=~ lineup G sub s$ +$B sub d ~=~ lineup B sub s$ +$A sub d ~=~ lineup A sub s$ +.fi +.RE +.P +.SH EXAMPLES +.P +Transparency is best implemented using blend function +(_const(SRC_ALPHA), _const(ONE_MINUS_SRC_ALPHA)) +with primitives sorted from farthest to nearest. +Note that this transparency calculation does not require +the presence of alpha bitplanes in the frame buffer. +.P +Blend function +(_const(SRC_ALPHA), _const(ONE_MINUS_SRC_ALPHA)) +is also useful for rendering antialiased points and lines +in arbitrary order. +.P +Polygon antialiasing is optimized using blend function +.br +(_const(SRC_ALPHA_SATURATE), _const(ONE)) +with polygons sorted from nearest to farthest. +(See the _cmnd(Enable), _cmnd(Disable) reference page and the +_const(POLYGON_SMOOTH) argument for information on polygon antialiasing.) +Destination alpha bitplanes, +which must be present for this blend function to operate correctly, +store the accumulated coverage. +.SH NOTES +Incoming (source) alpha is correctly thought of as a material opacity, +ranging from 1.0 ($K sub A$), representing complete opacity, +to 0.0 (0), representing complete +transparency. +.P +When more than one color buffer is enabled for drawing, +the GL performs blending separately for each enabled buffer, +using the contents of that buffer for destination color. +(See _cmnd(DrawBuffer).) +.P +Blending affects only RGBA rendering. +It is ignored by color index renderers. +.P +_const(CONSTANT_COLOR), _const(ONE_MINUS_CONSTANT_COLOR), +_const(CONSTANT_ALPHA), _const(ONE_MINUS_CONSTANT_ALPHA) are only +available if the _arbstring(imaging) is supported by your implementation. +.SH ERRORS +_const(INVALID_ENUM) is generated if either _param1 or _param2 is not an +accepted value. +.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(Get) with argument _const(BLEND_SRC) +.br +_cmnd(Get) with argument _const(BLEND_DST) +.br +_cmnd(IsEnabled) with argument _const(BLEND) +.br +.SH SEE ALSO +_cmnd(AlphaFunc), +_cmnd(BlendColor), +_cmnd(BlendEquation), +_cmnd(Clear), +_cmnd(DrawBuffer), +_cmnd(Enable), +_cmnd(LogicOp), +_cmnd(StencilFunc) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/c b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/c new file mode 100644 index 000000000..8cbb4d3ad --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/c @@ -0,0 +1,2 @@ +.Op + c +.ds BN \f6Graphics Reference, C Edition\f1 diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/calllist.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/calllist.gl new file mode 100644 index 000000000..340146bf7 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/calllist.gl @@ -0,0 +1,77 @@ +_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 +_header(CallList,execute a display list) +_names(CallList) +.SH PARAMETERS +_phead(_param1) +Specifies the integer name of the display list to be executed. +.SH DESCRIPTION +_cmnd causes the named display list to be executed. +The commands saved in the display list are executed in order, +just as if they were called without using a display list. +If _param1 has not been defined as a display list, +_cmnd is ignored. +.P +_cmnd can appear inside a display list. +To avoid the possibility of infinite recursion resulting from display lists +calling one another, +a limit is placed on the nesting level of display +lists during display-list execution. +This limit is at least 64, and it depends on the implementation. +.P +GL state is not saved and restored across a call to _cmnd. +Thus, +changes made to GL state during the execution of a display list +remain after execution of the display list is completed. +Use _cmnd(PushAttrib), +_cmnd(PopAttrib), +_cmnd(PushMatrix), +and _cmnd(PopMatrix) to preserve GL state across _cmnd calls. +.SH NOTES +Display lists can be executed between a call to _cmnd(Begin) +and the corresponding call to _cmnd(End), +as long as the display list includes only commands that are allowed +in this interval. +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(MAX_LIST_NESTING) +.br +_cmnd(IsList) +.SH SEE ALSO +_cmnd(CallLists), +_cmnd(DeleteLists), +_cmnd(GenLists), +_cmnd(NewList), +_cmnd(PushAttrib), +_cmnd(PushMatrix) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/calllists.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/calllists.gl new file mode 100644 index 000000000..c9a3ee0d5 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/calllists.gl @@ -0,0 +1,177 @@ +_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 +_header(CallLists,execute a list of display lists) +_names(CallLists) +.SH PARAMETERS +_phead(_param1) +Specifies the number of display lists to be executed. +_phead(_param2) +Specifies the type of values in _param3. +Symbolic constants +_const(BYTE), +_const(UNSIGNED_BYTE), +_const(SHORT), +_const(UNSIGNED_SHORT), +_const(INT), +_const(UNSIGNED_INT), +_const(FLOAT), +_const(2_BYTES), +_const(3_BYTES), and +_const(4_BYTES) are accepted. +_phead(_param3) +Specifies the address of an array of name offsets in the display list. +The pointer type is void because the offsets can be bytes, +shorts, +ints, +or floats, +depending on the value of _param2. +.SH DESCRIPTION +_cmnd causes each display list in the list of names passed as _param3 +to be executed. +As a result, +the commands saved in each display list are executed in order, +just as if they were called without using a display list. +Names of display lists that have not been defined are ignored. +.P +_cmnd provides an efficient means for executing more than one display list. +_param2 allows lists with various name formats to be accepted. +The formats are as follows: +.TP 25 +_const(BYTE) +_param3 is treated as an array of signed bytes, +each in the range \-128 through 127. +.TP +_const(UNSIGNED_BYTE) +_param3 is treated as an array of unsigned bytes, +each in the range 0 through 255. +.TP +_const(SHORT) +_param3 is treated as an array of signed two-byte integers, +each in the range \-32768 through 32767. +.TP +_const(UNSIGNED_SHORT) +_param3 is treated as an array of unsigned two-byte integers, +each in the range 0 through 65535. +.TP +_const(INT) +_param3 is treated as an array of signed four-byte integers. +.TP +_const(UNSIGNED_INT) +_param3 is treated as an array of unsigned four-byte integers. +.TP +_const(FLOAT) +_param3 is treated as an array of four-byte floating-point values. +.TP +_const(2_BYTES) +_param3 is treated as an array of unsigned bytes. +Each pair of bytes specifies a single display-list name. +The value of the pair is computed as 256 times the unsigned value +of the first byte plus the unsigned value of the second byte. +.TP +_const(3_BYTES) +_param3 is treated as an array of unsigned bytes. +Each triplet of bytes specifies a single display-list name. +The value of the triplet is computed as 65536 times the unsigned value +of the first byte, +plus 256 times the unsigned value of the second byte, +plus the unsigned value of the third byte. +.TP +_const(4_BYTES) +_param3 is treated as an array of unsigned bytes. +Each quadruplet of bytes specifies a single display-list name. +The value of the quadruplet is computed as 16777216 times the unsigned value +of the first byte, +plus 65536 times the unsigned value of the second byte, +plus 256 times the unsigned value of the third byte, +plus the unsigned value of the fourth byte. +.P +The list of display-list names is not null-terminated. +Rather, +_param1 specifies how many names are to be taken from _param3. +.P +An additional level of indirection is made available with the +_cmnd(ListBase) command, +which specifies an unsigned offset that is added to each display-list +name specified in _param3 before that display list is executed. +.P +_cmnd can appear inside a display list. +To avoid the possibility of infinite recursion resulting from display lists +calling one another, +a limit is placed on the nesting level of display +lists during display-list execution. +This limit must be at least 64, and it depends on the implementation. +.P +GL state is not saved and restored across a call to _cmnd. +Thus, +changes made to GL state during the execution of the display lists +remain after execution is completed. +Use _cmnd(PushAttrib), +_cmnd(PopAttrib), +_cmnd(PushMatrix), +and _cmnd(PopMatrix) to preserve GL state across _cmnd calls. +.SH NOTES +Display lists can be executed between a call to _cmnd(Begin) +and the corresponding call to _cmnd(End), +as long as the display list includes only commands that are allowed +in this interval. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is negative. +.P +_const(INVALID_ENUM) is generated if _param2 is not one of +_const(BYTE), +_const(UNSIGNED_BYTE), +_const(SHORT), +_const(UNSIGNED_SHORT), +_const(INT), +_const(UNSIGNED_INT), +_const(FLOAT), +_const(2_BYTES), +_const(3_BYTES), +_const(4_BYTES). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(LIST_BASE) +.br +_cmnd(Get) with argument _const(MAX_LIST_NESTING) +.br +_cmnd(IsList) +.SH SEE ALSO +_cmnd(CallList), +_cmnd(DeleteLists), +_cmnd(GenLists), +_cmnd(ListBase), +_cmnd(NewList), +_cmnd(PushAttrib), +.br +_cmnd(PushMatrix) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clear.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clear.gl new file mode 100644 index 000000000..b9d153b48 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clear.gl @@ -0,0 +1,115 @@ +_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(Clear,clear buffers to preset values) +_names(Clear) +.SH PARAMETERS +_phead(_param1) +Bitwise OR of masks that indicate the buffers to be cleared. +The four masks are +_const(COLOR_BUFFER_BIT), +_const(DEPTH_BUFFER_BIT), +_const(ACCUM_BUFFER_BIT), and +_const(STENCIL_BUFFER_BIT). +.SH DESCRIPTION +_cmnd sets the bitplane area of the window to values previously selected +by _cmnd(ClearColor), _cmnd(ClearIndex), _cmnd(ClearDepth), +_cmnd(ClearStencil), and _cmnd(ClearAccum). +Multiple color buffers can be cleared simultaneously by selecting +more than one buffer at a time using _cmnd(DrawBuffer). +.P +The pixel ownership test, +the scissor test, +dithering, and the buffer writemasks affect the operation of _cmnd. +The scissor box bounds the cleared region. +Alpha function, +blend function, +logical operation, +stenciling, +texture mapping, +and depth-buffering are ignored by _cmnd. +.P +_cmnd takes a single argument that is the bitwise OR of several +values indicating which buffer is to be cleared. +.P +The values are as follows: +.TP 28 +_const(COLOR_BUFFER_BIT) +Indicates the buffers currently enabled for color +writing. +.TP +_const(DEPTH_BUFFER_BIT) +Indicates the depth buffer. +.TP +_const(ACCUM_BUFFER_BIT) +Indicates the accumulation buffer. +.TP +_const(STENCIL_BUFFER_BIT) +Indicates the stencil buffer. +.P +The value to which each buffer is cleared depends on the setting of the +clear value for that buffer. +.SH NOTES +If a buffer is not present, +then a _cmnd directed at that buffer has no effect. +.SH ERRORS +_const(INVALID_VALUE) is generated if any bit other than the four defined +bits is set in _param1. +.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(Get) with argument _const(ACCUM_CLEAR_VALUE) +.br +_cmnd(Get) with argument _const(DEPTH_CLEAR_VALUE) +.br +_cmnd(Get) with argument _const(INDEX_CLEAR_VALUE) +.br +_cmnd(Get) with argument _const(COLOR_CLEAR_VALUE) +.br +_cmnd(Get) with argument _const(STENCIL_CLEAR_VALUE) +.SH SEE ALSO +_cmnd(ClearAccum), +_cmnd(ClearColor), +_cmnd(ClearDepth), +_cmnd(ClearIndex), +_cmnd(ClearStencil), +_cmnd(ColorMask), +_cmnd(DepthMask), +_cmnd(DrawBuffer), +_cmnd(Scissor), +_cmnd(StencilMask) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearaccum.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearaccum.gl new file mode 100644 index 000000000..9787d3324 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearaccum.gl @@ -0,0 +1,58 @@ +_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(ClearAccum,specify clear values for the accumulation buffer) +_names(ClearAccum) +.SH PARAMETERS +_phead(_param1 _param2 _param3 _param4) +Specify the red, green, blue, and alpha values used when the +accumulation buffer is cleared. +The initial values are all 0. +.SH DESCRIPTION +_cmnd specifies the red, green, blue, and alpha values used by _cmnd(Clear) +to clear the accumulation buffer. +.P +Values specified by _cmnd are clamped to the +range [-1,\ 1]. +.SH ERRORS +_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(Get) with argument _const(ACCUM_CLEAR_VALUE) +.SH SEE ALSO +_cmnd(Accum), +_cmnd(Clear) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearcolor.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearcolor.gl new file mode 100644 index 000000000..3272b0321 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearcolor.gl @@ -0,0 +1,57 @@ +_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(ClearColor,specify clear values for the color buffers) +_names(ClearColor) +.SH PARAMETERS +_phead(_param1 _param2 _param3 _param4) +Specify the red, green, blue, and alpha values used when the +color buffers are cleared. +The initial values are all 0. +.SH DESCRIPTION +_cmnd specifies the red, +green, +blue, +and alpha values used by _cmnd(Clear) to clear the color buffers. +Values specified by _cmnd are clamped to the range [0,\ 1]. +.SH ERRORS +_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(Get) with argument _const(COLOR_CLEAR_VALUE) +.SH SEE ALSO +_cmnd(Clear) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/cleardepth.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/cleardepth.gl new file mode 100644 index 000000000..d2b4a8e5d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/cleardepth.gl @@ -0,0 +1,53 @@ +_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(ClearDepth,specify the clear value for the depth buffer) +_names(ClearDepth) +.SH PARAMETERS +_phead(_param1) +Specifies the depth value used when the depth buffer is cleared. The +initial value is 1. +.SH DESCRIPTION +_cmnd specifies the depth value used by _cmnd(Clear) to clear the depth buffer. +Values specified by _cmnd are clamped to the range [0,\ 1]. +.SH ERRORS +_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(Get) with argument _const(DEPTH_CLEAR_VALUE) +.SH SEE ALSO +_cmnd(Clear) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearindex.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearindex.gl new file mode 100644 index 000000000..d46d44454 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearindex.gl @@ -0,0 +1,64 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(ClearIndex,specify the clear value for the color index buffers) +_names(ClearIndex) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the index used when the color index buffers are cleared. +The initial value is 0. +.SH DESCRIPTION +_cmnd specifies the index used by _cmnd(Clear) +to clear the color index buffers. +_param1 is not clamped. +Rather, +_param1 is converted to a fixed-point value with unspecified precision +to the right of the binary point. +The integer part of this value is then masked with $2 sup m^-^1$, +where $m$ is the number of bits in a color index stored in the frame buffer. +.SH ERRORS +_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(Get) with argument _const(INDEX_CLEAR_VALUE) +.br +_cmnd(Get) with argument _const(INDEX_BITS) +.SH SEE ALSO +_cmnd(Clear) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearstencil.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearstencil.gl new file mode 100644 index 000000000..e177e1b2c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clearstencil.gl @@ -0,0 +1,62 @@ +_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(ClearStencil,specify the clear value for the stencil buffer) +_names(ClearStencil) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the index used when the stencil buffer is cleared. +The initial value is 0. +.SH DESCRIPTION +_cmnd specifies the index used by _cmnd(Clear) to clear the stencil buffer. +_param1 is masked with $2 sup m^-^1$, +where $m$ is the number of bits in the stencil buffer. +.SH ERRORS +_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(Get) with argument _const(STENCIL_CLEAR_VALUE) +.br +_cmnd(Get) with argument _const(STENCIL_BITS) +.SH SEE ALSO +_cmnd(Clear), +_cmnd(StencilFunc), +_cmnd(StencilOp), +_cmnd(StencilMask) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clientactivetextureARB.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clientactivetextureARB.gl new file mode 100644 index 000000000..c09ca2377 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clientactivetextureARB.gl @@ -0,0 +1,71 @@ +_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,eqn|tbl)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(ClientActiveTextureARB, select active texture unit) +_names(ClientActiveTextureARB) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies which texture unit to make active. The number +of texture units is implementation dependent, but must be at least +two. _param1 must be one of _arbconstidx(TEXTURE) +where 0 \(<= $ i $ < _arbconst(MAX_TEXTURE_UNITS), which is an +implementation-dependent value. The initial value is +_arbconst(TEXTURE0). +.SH DESCRIPTION +_cmnd selects the vertex array client state parameters to be modified by +_cmnd(TexCoordPointer), and enabled or disabled with +_cmnd(EnableClientState) or _cmnd(DisableClientState), respectively, +when called with a parameter of _const(TEXTURE_COORD_ARRAY). +.SH NOTES +_cmnd is supported only if _arbstring(multitexture) is included in the +string returned by _cmnd(GetString) when called with the argument +_const(EXTENSIONS). +.P +_cmnd sets _arbconst(CLIENT_ACTIVE_TEXTURE) to the active texture unit. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of +_arbconstidx(TEXTURE), where +0 \(<= $ i $ < _arbconst(MAX_TEXTURE_UNITS). +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(DisableClientState), +_cmnd(EnableClientState), +_cmnd(MultiTexCoordARB), +_cmnd(TexCoordPointer) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clipplane.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clipplane.gl new file mode 100644 index 000000000..67e742d8e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/clipplane.gl @@ -0,0 +1,95 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(ClipPlane,specify a plane against which all geometry is clipped) +_names(ClipPlane) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies which clipping plane is being positioned. +Symbolic names of the form _const(CLIP_PLANE)\f2i\fP, +where \f2i\fP is an integer between 0 and _const(MAX_CLIP_PLANES)$^-^1$, +are accepted. +_phead(_param2) +Specifies the address of an array of four double-precision floating-point values. +These values are interpreted as a plane equation. +.SH DESCRIPTION +Geometry is always clipped against the boundaries of a six-plane frustum +in \f2x\fP, \f2y\fP, and \f2z\fP. +_cmnd allows the specification of additional planes, +not necessarily perpendicular to the \f2x\fP, \f2y\fP, or \f2z\fP axis, +against which all geometry is clipped. +To determine the maximum number of additional clipping planes, call +_cmnd(GetIntegerv) with argument _const(MAX_CLIP_PLANES). All +implementations support at least six such clipping planes. +Because the resulting clipping region is the intersection +of the defined half-spaces, +it is always convex. +.P +_cmnd specifies a half-space using a four-component plane equation. +When _cmnd is called, +_param2 is transformed by the inverse of the modelview matrix +and stored in the resulting eye coordinates. +Subsequent changes to the modelview matrix have no effect on the +stored plane-equation components. +If the dot product of the eye coordinates of a vertex with the +stored plane equation components is positive or zero, +the vertex is \f2in\f1 with respect to that clipping plane. +Otherwise, it is \f2out\fP. +.P +To enable and disable clipping planes, call +_cmnd(Enable) and _cmnd(Disable) with the argument +_const(CLIP_PLANE)\f2i\fP, +where \f2i\fP is the plane number. +.P +All clipping planes are initially defined as (0, 0, 0, 0) in eye coordinates +and are disabled. +.SH NOTES +It is always the case that _const(CLIP_PLANE)$i$ = _const(CLIP_PLANE0)$~+~i$. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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(GetClipPlane) +.br +_cmnd(IsEnabled) with argument _const(CLIP_PLANE)\f2i\fP +.SH SEE ALSO +_cmnd(Enable) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/color.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/color.gl new file mode 100644 index 000000000..b5e93b83e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/color.gl @@ -0,0 +1,103 @@ +_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(Color, set the current color) +_names(Color,[34]u*[bsifd]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2 _param3) +Specify new red, green, and blue values for the current color. +_phead(_param4) +Specifies a new alpha value for the current color. +Included only in the four-argument _cmnd(Color4) commands. +_names(Color,[34]u*[bsifd]v) +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to an array that contains red, green, blue, +and (sometimes) alpha values. +.SH DESCRIPTION +The GL stores both a current single-valued color index +and a current four-valued RGBA color. +_cmnd sets a new four-valued RGBA color. +_cmnd has two major variants: +_cmnd(Color3) and _cmnd(Color4). +_cmnd(Color3) variants specify new red, +green, +and blue values explicitly +and set the current alpha value to 1.0 (full intensity) implicitly. +_cmnd(Color4) variants specify all four color components explicitly. +.P +_cmnd(Color3b), _cmnd(Color4b), +_cmnd(Color3s), _cmnd(Color4s), _cmnd(Color3i), and _cmnd(Color4i) take +three or four signed byte, short, or long integers as arguments. +When \f3v\fP is appended to the name, +the color commands can take a pointer to an array of such values. +.P +Current color values are stored in floating-point format, +with unspecified mantissa and exponent sizes. +Unsigned integer color components, +when specified, +are linearly mapped to floating-point values such that the largest +representable value maps to 1.0 (full intensity), +and 0 maps to 0.0 (zero intensity). +Signed integer color components, +when specified, +are linearly mapped to floating-point values such that the most positive +representable value maps to 1.0, +and the most negative representable value maps to \-1.0. (Note that +this mapping does not convert 0 precisely to 0.0.) +Floating-point values are mapped directly. +.P +Neither floating-point nor signed integer values are clamped +to the range [0,1] before the current color is updated. +However, +color components are clamped to this range before they are interpolated +or written into a color buffer. +.SH NOTES +The initial value for the current color is (1, 1, 1, 1). +.P +The current color can be updated at any time. +In particular, +_cmnd can be called between a call to _cmnd(Begin) and the corresponding +call to _cmnd(End). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(CURRENT_COLOR) +.br +_cmnd(Get) with argument _const(RGBA_MODE) +.SH SEE ALSO +_cmnd(Index) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colormask.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colormask.gl new file mode 100644 index 000000000..ef26a9066 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colormask.gl @@ -0,0 +1,73 @@ +_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 +_C_ _define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(ColorMask,enable and disable writing of frame buffer color components) +_names(ColorMask) +.SH PARAMETERS +_phead(_param1 _param2 _param3 _param4) +Specify whether red, green, blue, and alpha can or cannot be written +into the frame buffer. +The initial values are all _const(TRUE), +indicating that the color components can be written. +.SH DESCRIPTION +_cmnd specifies whether the individual color components in the frame buffer +can or cannot be written. +If _param1 is _const(FALSE), +for example, +no change is made to the red component of any pixel in any of the +color buffers, +regardless of the drawing operation attempted. +.P +Changes to individual bits of components cannot be controlled. +Rather, +changes are either enabled or disabled for entire color components. +.SH ERRORS +_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(Get) with argument _const(COLOR_WRITEMASK) +.br +_cmnd(Get) with argument _const(RGBA_MODE) +.SH SEE ALSO +_cmnd(Clear), +_cmnd(Color), +_cmnd(ColorPointer), +_cmnd(DepthMask), +_cmnd(Index), +_cmnd(IndexPointer), +_cmnd(IndexMask), +_cmnd(StencilMask) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colormaterial.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colormaterial.gl new file mode 100644 index 000000000..e5fdaec48 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colormaterial.gl @@ -0,0 +1,108 @@ +_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(ColorMaterial,cause a material color to track the current color) +_names(ColorMaterial) +.SH PARAMETERS +_phead(_param1) +Specifies whether front, +back, +or both front and back material parameters should track the current color. +Accepted values are +_const(FRONT), +_const(BACK), +and _const(FRONT_AND_BACK). +The initial value is _const(FRONT_AND_BACK). +_phead(_param2) +Specifies which of several material parameters track the current color. +Accepted values are +_const(EMISSION), +_const(AMBIENT), +_const(DIFFUSE), +_const(SPECULAR), +and _const(AMBIENT_AND_DIFFUSE). +The initial value is _const(AMBIENT_AND_DIFFUSE). +.SH DESCRIPTION +_cmnd specifies which material parameters track the current color. +When _const(COLOR_MATERIAL) is enabled, +the material parameter or parameters specified by _param2, +of the material or materials specified by _param1, +track the current color at all times. +.P +To enable and disable _const(COLOR_MATERIAL), call +_cmnd(Enable) and _cmnd(Disable) with argument _const(COLOR_MATERIAL). +_const(COLOR_MATERIAL) is initially disabled. +.SH NOTES +_cmnd makes it possible to change a subset of material parameters for each +vertex using only the _cmnd(Color) command, +without calling _cmnd(Material). +If only such a subset of parameters is to be specified for each +vertex, calling _cmnd is preferable to calling _cmnd(Material). +.P +Call _cmnd before enabling _const(COLOR_MATERIAL). +.P +Calling _cmnd(DrawElements), _cmnd(DrawArrays), or _cmnd(DrawRangeElements) +may leave the current color indeterminate, if the color array is enabled. +If +_cmnd is enabled while the current color is indeterminate, the +lighting material state specified by _param1 and _param2 is also indeterminate. +.P +If the GL version is 1.1 or greater, and _const(COLOR_MATERIAL) is +enabled, evaluated color values affect the results of the lighting +equation as if the current color were being modified, but no change is +made to the tracking lighting parameter of the current color. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 or _param2 is not an +accepted value. +.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(IsEnabled) with argument _const(COLOR_MATERIAL) +.br +_cmnd(Get) with argument _const(COLOR_MATERIAL_PARAMETER) +.br +_cmnd(Get) with argument _const(COLOR_MATERIAL_FACE) +.SH SEE ALSO +_cmnd(Color), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(DrawRangeElements), +_cmnd(Enable), +_cmnd(Light), +_cmnd(LightModel), +_cmnd(Material) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colorpointer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colorpointer.gl new file mode 100644 index 000000000..b31ee7cbf --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colorpointer.gl @@ -0,0 +1,145 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_C_ the function name must appear in (APIFILE) (usually gl.h) as set in +_C_ Makefile. +_header(ColorPointer,define an array of colors) +_names(ColorPointer) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the number of components per color. Must be 3 or 4. +The initial value is 4. +_phead(_param2) +Specifies the data type of each color component in the array. +Symbolic constants +_const(BYTE), +_const(UNSIGNED_BYTE), +_const(SHORT), +_const(UNSIGNED_SHORT), +_const(INT), +_const(UNSIGNED_INT), +_const(FLOAT), +and +_const(DOUBLE) +are accepted. +The initial value is _const(FLOAT). +_phead(_param3) +Specifies the byte offset between consecutive colors. +If _param3 is 0 (the initial value), the colors are understood to be +tightly packed in the array. The initial value is 0. +_phead(_param4) +Specifies a pointer to the first component of the first color element +in the array. +.SH DESCRIPTION +_cmnd specifies the location and data format of an array of color components +to use when rendering. +_param1 specifies the number of components per color, and must be 3 or 4. +_param2 specifies the data type of each color component, and _param3 +specifies the byte stride from one color to the next allowing vertices and +attributes to be packed into a single array or stored in separate arrays. +(Single-array storage may be more efficient on some implementations; +see _cmnd(InterleavedArrays).) +.P +When a color array is specified, +_param1, _param2, _param3, and _param4 are saved as client-side +state. +.P +To enable and disable the color array, call _cmnd(EnableClientState) and +.br +_cmnd(DisableClientState) with the argument _const(COLOR_ARRAY). If +enabled, the color array is used when _cmnd(DrawArrays), +_cmnd(DrawElements), _cmnd(DrawRangeElements), or _cmnd(ArrayElement) is +called. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +The color array is initially disabled and isn't accessed when +_cmnd(ArrayElement), _cmnd(DrawArrays), _cmnd(DrawRangeElements), +or _cmnd(DrawElements) is called. +.P +Execution of _cmnd is not allowed between the execution of +_cmnd(Begin) and the corresponding execution of _cmnd(End), +but an error may or may not be generated. If no error is generated, +the operation is undefined. +.P +_cmnd is typically implemented on the client side. +.P +Color array parameters are client-side state and are therefore not saved +or restored by _cmnd(PushAttrib) and _cmnd(PopAttrib). +Use _cmnd(PushClientAttrib) and _cmnd(PopClientAttrib) instead. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is not 3 or 4. +.P +_const(INVALID_ENUM) is generated if _param2 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param3 is negative. +.SH ASSOCIATED GETS +_cmnd(IsEnabled) with argument _const(COLOR_ARRAY) +.br +_cmnd(Get) with argument _const(COLOR_ARRAY_SIZE) +.br +_cmnd(Get) with argument _const(COLOR_ARRAY_TYPE) +.br +_cmnd(Get) with argument _const(COLOR_ARRAY_STRIDE) +.br +_cmnd(GetPointerv) with argument _const(COLOR_ARRAY_POINTER) +.SH SEE ALSO +_C_ no queries or gets listed above, alphabetize commands, +_C_ seperate with commas not .br. no command appears in the associated gets +_C_ as well as in SEE ALSO. +_cmnd(ArrayElement), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(EdgeFlagPointer), +_cmnd(Enable), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(NormalPointer), +_cmnd(PopClientAttrib), +_cmnd(PushClientAttrib), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colorsubtable.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colorsubtable.gl new file mode 100644 index 000000000..9a426aa2d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colorsubtable.gl @@ -0,0 +1,127 @@ +_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)_C_ +_header(ColorSubTable,respecify a portion of a color table) +_names(ColorSubTable) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__start>@,@<_param2>@)_C_ +_define(@<__count>@,@<_param3>@)_C_ +_define(@<__format>@,@<_param4>@)_C_ +_define(@<__type>@,@<_param5>@)_C_ +_define(@<__table>@,@<_param6>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be one of +_const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), or +_const(POST_COLOR_MATRIX_COLOR_TABLE). +_phead(__start) +The starting index of the portion of the color table to be replaced. +_phead(__count) +The number of table entries to replace. +_phead(__format) +The format of the pixel data in __table. +The allowable values are +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(LUMINANCE), +_const(LUMINANCE_ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), and +_const(BGRA). +_phead(__type) +The type of the pixel data in __table. +The allowable values are +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(__table) +Pointer to a one-dimensional array of pixel data that is processed to +replace the specified region of the color table. +.SH DESCRIPTION +_cmnd is used to respecify a contiguous portion of a color table previously +defined using _cmnd(ColorTable). The pixels referenced by __table replace the +portion of the existing table from indices __start to +$_eqnparam2~+~_eqnparam3~-~1$, inclusive. This region may not include any +entries outside the range of the color table as it was originally specified. +It is not an error to specify a subtexture with width of 0, but such a +specification has no effect. +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.P +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_VALUE) is generated if $_eqnparam2~+~_eqnparam3~>~width$. +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.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(GetColorTable), +_cmnd(GetColorTableParameter) +.SH SEE ALSO +_cmnd(ColorSubTable), +_cmnd(ColorTableParameter), +_cmnd(CopyColorTable), +_cmnd(CopyColorSubTable), +_cmnd(GetColorTable) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colortable.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colortable.gl new file mode 100644 index 000000000..90b141d3d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colortable.gl @@ -0,0 +1,317 @@ +_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)_C_ +_header(ColorTable,define a color lookup table) +_names(ColorTable) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__internalformat>@,@<_param2>@)_C_ +_define(@<__width>@,@<_param3>@)_C_ +_define(@<__format>@,@<_param4>@)_C_ +_define(@<__type>@,@<_param5>@)_C_ +_define(@<__table>@,@<_param6>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be one of +_const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), +_const(POST_COLOR_MATRIX_COLOR_TABLE), +_const(PROXY_COLOR_TABLE), +_const(PROXY_POST_CONVOLUTION_COLOR_TABLE), +or +_const(PROXY_POST_COLOR_MATRIX_COLOR_TABLE). +_phead(__internalformat) +The internal format of the color table. +The allowable values are +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), and +_const(RGBA16). +_phead(__width) +The number of entries in the color lookup table specified by __table. +_phead(__format) +The format of the pixel data in __table. +The allowable values are +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(LUMINANCE), +_const(LUMINANCE_ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), and +_const(BGRA). +_phead(__type) +The type of the pixel data in __table. +The allowable values are +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(__table) +Pointer to a one-dimensional array of pixel data that is processed to +build the color table. +.SH DESCRIPTION +_cmnd may be used in two ways: +to test the actual size and color resolution of a lookup table +given a particular set of parameters, +or to load the contents of a color lookup +table. +Use the targets _const(PROXY_*) for the first case +and the other targets for the second case. +.P +If __target is _const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), +or +_const(POST_COLOR_MATRIX_COLOR_TABLE), +_cmnd builds a color lookup table from an array of pixels. +The pixel array specified by __width, __format, __type, and __table +is extracted from memory and +processed just as if _cmnd(DrawPixels) were called, but processing +stops after the final expansion to RGBA is completed. +.P +The four scale parameters and the four bias parameters that are defined +for the table are then used to scale and bias the R, G, B, and A components +of each pixel. +(Use _cmnd(ColorTableParameter) to set these scale and bias +parameters.) +.P +Next, the R, G, B, and A values are clamped to the range [0,\ 1]. +Each pixel is then converted to the internal format specified by +__internalformat. +This conversion simply maps the component values of the pixel (R, G, B, +and A) to the values included in the internal format (red, green, blue, +alpha, luminance, and intensity). The mapping is as follows: +.P +.TS +center; +lb cb cb cb cb cb cb +l c c c c c c. +_ +Internal Format Red Green Blue Alpha Luminance Intensity +_ +_const(ALPHA) A +_const(LUMINANCE) R +_const(LUMINANCE_ALPHA) A R +_const(INTENSITY) R +_const(RGB) R G B +_const(RGBA) R G B A +_ +.TE +.P +Finally, the red, green, blue, alpha, luminance, and/or intensity components of +the resulting pixels are stored in the color table. +They form a one-dimensional table with indices in the range +[0,\ __width\ \-\ 1]. +.P +If __target is _const(PROXY_*), +_cmnd recomputes and stores the values of the proxy color table's state +variables +_const(COLOR_TABLE_FORMAT), +_const(COLOR_TABLE_WIDTH), +_const(COLOR_TABLE_RED_SIZE), +_const(COLOR_TABLE_GREEN_SIZE), +_const(COLOR_TABLE_BLUE_SIZE), +_const(COLOR_TABLE_ALPHA_SIZE), +_const(COLOR_TABLE_LUMINANCE_SIZE), and +_const(COLOR_TABLE_INTENSITY_SIZE). +There is no effect on the image or state of any actual color table. +If the specified color table is too large to be supported, then all the +proxy state variables listed above are set to zero. +Otherwise, the color table could be supported by _cmnd +using the corresponding non-proxy target, +and the proxy state variables are set as if that target were being defined. +.P +The proxy state variables can be retrieved by calling +_cmnd(GetColorTableParameter) with a target of +_const(PROXY_*). +This allows the application to decide if a particular _cmnd +command would succeed, and to determine what the resulting color table +attributes would be. +.P +If a color table is enabled, and its width is non-zero, then its +contents are used to replace a subset of the components of each RGBA +pixel group, based on the internal format of the table. +.P +Each pixel group has color components (R, G, B, A) +that are in the range [0.0,\ 1.0]. +The color components are rescaled to +the size of the color lookup table to form an index. +Then a subset of the components based on the internal format of the table are +replaced by the table entry selected by that index. +If the color components and contents of the table are represented as follows: +.P +.TS +center; +cb cb +c l. +_ +Representation Meaning +_ +\f7r\fP Table index computed from \f7R\fP +\f7g\fP Table index computed from \f7G\fP +\f7b\fP Table index computed from \f7B\fP +\f7a\fP Table index computed from \f7A\fP +\f7L[i]\fP Luminance value at table index \f7i\fP +\f7I[i]\fP Intensity value at table index \f7i\fP +\f7R[i]\fP Red value at table index \f7i\fP +\f7G[i]\fP Green value at table index \f7i\fP +\f7B[i]\fP Blue value at table index \f7i\fP +\f7A[i]\fP Alpha value at table index \f7i\fP +_ +.TE +.P +then the result of color table lookup is as follows: +.P +.ne 10 +.TS +center; +l l s s s +l l l l l +l l l l l. +_ + Resulting Texture Components +Table Internal Format R G B A +_ +_const(ALPHA) R G B A[a] +_const(LUMINANCE) L[r] L[g] L[b] At +_const(LUMINANCE_ALPHA) L[r] L[g] L[b] A[a] +_const(INTENSITY) I[r] I[g] I[b] I[a] +_const(RGB) R[r] G[g] B[b] A +_const(RGBA) R[r] G[g] B[b] A[a] +_ +.TE +.P +When _const(COLOR_TABLE) is enabled, the colors resulting from +the pixel map operation (if it is enabled) are mapped +by the color lookup table before being passed to the convolution +operation. The colors resulting from the convolution operation +are modified by the post convolution color lookup table when +_const(POST_CONVOLUTION_COLOR_TABLE) +is enabled. These modified colors are then sent to the color matrix operation. +Finally, if _const(POST_COLOR_MATRIX_COLOR_TABLE) +is enabled, the colors resulting from the color matrix operation +are mapped by the post color matrix color lookup table before being +used by the histogram operation. +.P +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.P +If __target is set to _const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), +or _const(POST_COLOR_MATRIX_COLOR_TABLE), +then __width must be a power of two or a _const(INVALID_VALUE) +error is generated. +.P +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __internalformat is not one of the +allowable values. +.P +_const(INVALID_VALUE) is generated if __width is less than zero. +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.P +_const(TABLE_TOO_LARGE) is generated if the requested color table +is too large to be supported by the implementation, and __target is +not a _const(PROXY_*) target. +.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(GetColorTableParameter) +.SH SEE ALSO +_cmnd(ColorSubTable), +_cmnd(ColorTableParameter), +_cmnd(CopyColorTable), +_cmnd(CopyColorSubTable), +_cmnd(GetColorTable) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colortableparameter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colortableparameter.gl new file mode 100644 index 000000000..e4bcea3ee --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/colortableparameter.gl @@ -0,0 +1,94 @@ +_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(ColorTableParameter, set color lookup table parameters) +_names(ColorTableParameter,[fi]v) +.EQ +delim $$ +.EN +.SH PARAMETERS +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__pname>@,@<_param2>@)_C_ +_define(@<__params>@,@<_param3>@)_C_ +_phead(__target) +The target color table. +Must be +_const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), or +_const(POST_COLOR_MATRIX_COLOR_TABLE). +_phead(__pname) +The symbolic name of a texture color lookup table parameter. +Must be one of +_const(COLOR_TABLE_SCALE) or +_const(COLOR_TABLE_BIAS). +_phead(__params) +A pointer to an array where the values of the parameters are stored. +.SH DESCRIPTION +_cmnd is used to specify the scale factors and bias terms applied to +color components when they are loaded into a color table. __target +indicates which color table the scale and bias terms apply to; it +must be set to +_const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), or +_const(POST_COLOR_MATRIX_COLOR_TABLE). +.P +__pname must be _const(COLOR_TABLE_SCALE) to set the +scale factors. +In this case, __params points to an array of four values, which are +the scale factors for red, green, blue, and alpha, in that order. +.P +__pname must be _const(COLOR_TABLE_BIAS) to set the +bias terms. In this case, +__params points to an array of four values, which are the bias +terms for red, green, blue, and alpha, in that order. +.P +The color tables themselves are specified by +calling _cmnd(ColorTable). +.SH NOTES +_cmnd is available only if _arbstring(imaging) is returned from calling +_cmnd(GetString) with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target or __pname is not +an acceptable value. +.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(GetColorTableParameter) +.SH SEE ALSO +_cmnd(ColorTable), +_cmnd(PixelTransfer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/const.awk b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/const.awk new file mode 100644 index 000000000..05d1711c1 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/const.awk @@ -0,0 +1,104 @@ +# License Applicability. Except to the extent portions of this file are +# made subject to an alternative license as permitted in the SGI Free +# Software License B, Version 1.1 (the "License"), the contents of this +# file are subject only to the provisions of the License. You may not use +# this file except in compliance with the License. You may obtain a copy +# of the License at Silicon Graphics, Inc., attn: Legal Services, 1600 +# Amphitheatre Parkway, Mountain View, CA 94043-1351, or at: +# +# http://oss.sgi.com/projects/FreeB +# +# Note that, as provided in the License, the Software is distributed on an +# "AS IS" basis, with ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS +# DISCLAIMED, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES AND +# CONDITIONS OF MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS FOR A +# PARTICULAR PURPOSE, AND NON-INFRINGEMENT. +# +# Original Code. The Original Code is: OpenGL Sample Implementation, +# Version 1.2.1, released January 26, 2000, developed by Silicon Graphics, +# Inc. The Original Code is Copyright (c) 1991-2000 Silicon Graphics, Inc. +# Copyright in any portions created by third parties is as indicated +# elsewhere herein. All Rights Reserved. +# +# Additional Notice Provisions: The application programming interfaces +# established by SGI in conjunction with the Original Code are The +# OpenGL(R) Graphics System: A Specification (Version 1.2.1), released +# April 1, 1999; The OpenGL(R) Graphics System Utility Library (Version +# 1.3), released November 4, 1998; and OpenGL(R) Graphics with the X +# Window System(R) (Version 1.3), released October 19, 1998. This software +# was created using the OpenGL(R) version 1.2.1 Sample Implementation +# published by SGI, but has not been independently verified as being +# compliant with the OpenGL(R) version 1.2.1 Specification. +# + +# compare manpages to gl.h +# +# awk -f check.awk /usr/include/GL/gl.h *.gl +# +# only checks constants for now - routine names would be nice + +BEGIN { + mode = 0; +} + +# +# look for definitions in gl.h +# +$1 == "#define" { + if (NF > 2) { + token = substr($2,4); + IsDefined[token] = 1; + } + continue; +} + +# +# ignore comments in tex source +# +substr($1,1,3) == "_C_" { + continue; +} + +# +# check each field for a _const macro, extract the string when found +# + { + for (i=1; i <= length($0); i++) { + c = substr($0,i,1); + if (substr($0,i,6) == "_const") { + mode = 1; + i += 5; + } + else if (mode == 1) { + if (c == "(") { + mode = 2; + newtoken = ""; + } + } + else if (mode == 2) { + if (c == ")") { + IsSpecified[newtoken] = 1; + if (!IsDefined[newtoken]) { + printf("not in gl.h: "); + printf("%-20s ",FILENAME); + printf("%s\n",newtoken); + } + mode = 0; + } + else if (c == " ") { + } + else { + newtoken = sprintf("%s%s",newtoken,c); + } + } + + } +} + +END { + for (s in IsDefined) { + if (!IsSpecified[s]) { + printf("not in the manpages: %s\n",s); + } + } +} diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/convolutionfilter1d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/convolutionfilter1d.gl new file mode 100644 index 000000000..51b280424 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/convolutionfilter1d.gl @@ -0,0 +1,231 @@ +_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)_C_ +_header(ConvolutionFilter1D,define a one-dimensional convolution filter) +_names(ConvolutionFilter1D) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__internalformat>@,@<_param2>@)_C_ +_define(@<__width>@,@<_param3>@)_C_ +_define(@<__format>@,@<_param4>@)_C_ +_define(@<__type>@,@<_param5>@)_C_ +_define(@<__image>@,@<_param6>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be _const(CONVOLUTION_1D). +_phead(__internalformat) +The internal format of the convolution filter kernel. +The allowable values are +_const(ALPHA), +_const(LUMINANCE), +_const(LUMINANCE_ALPHA), +_const(INTENSITY), +_const(RGB), and +_const(RGBA). +_phead(__width) +The width of the pixel array referenced by __image. +_phead(__format) +The format of the pixel data in __image. +The allowable values are +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(__type) +The type of the pixel data in __image. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) +are accepted. +_phead(__image) +Pointer to a one-dimensional array of pixel data that is processed to +build the convolution filter kernel. +.SH DESCRIPTION +_cmnd builds a one-dimensional convolution filter kernel from an array of +pixels. +.sp +The pixel array specified by __width, __format, __type, and __image +is extracted from memory and +processed just as if _cmnd(DrawPixels) were called, but processing +stops after the final expansion to RGBA is completed. +.sp +The R, G, B, and A components of each pixel are next scaled by the four +1D _const(CONVOLUTION_FILTER_SCALE) parameters and biased by the +four 1D _const(CONVOLUTION_FILTER_BIAS) parameters. +(The scale and bias parameters are set by _cmnd(ConvolutionParameter) +using the _const(CONVOLUTION_1D) target and the names +_const(CONVOLUTION_FILTER_SCALE) and _const(CONVOLUTION_FILTER_BIAS). +The parameters themselves are vectors of four values that are applied to red, +green, blue, and alpha, in that order.) +The R, G, B, and A values are not clamped to [0,1] at any time during this +process. +.sp +Each pixel is then converted to the internal format specified by +__internalformat. +This conversion simply maps the component values of the pixel (R, G, B, +and A) to the values included in the internal format (red, green, blue, +alpha, luminance, and intensity). The mapping is as follows: +.sp +.TS +center; +lb cb cb cb cb cb cb +l c c c c c c. +_ +Internal Format Red Green Blue Alpha Luminance Intensity +_ +_const(ALPHA) A +_const(LUMINANCE) R +_const(LUMINANCE_ALPHA) A R +_const(INTENSITY) R +_const(RGB) R G B +_const(RGBA) R G B A +_ +.TE +.sp +The red, green, blue, alpha, luminance, and/or intensity components of +the resulting pixels are stored in floating-point rather than integer +format. +They form a one-dimensional filter kernel image indexed with coordinate +\f2i\fP such that \f2i\fP starts at 0 and increases from left to right. +Kernel location \f2i\fP is derived from the \f2i\fPth pixel, counting from 0. +.PP +Note that after a convolution is performed, the resulting color +components are also scaled by their corresponding +_const(POST_CONVOLUTION_c_SCALE) parameters and biased by their +corresponding _const(POST_CONVOLUTION_c_BIAS) parameters (where +\f2c\fP takes on the values \f3RED\fP, \f3GREEN\fP, \f3BLUE\fP, and +\f3ALPHA\fP). +These parameters are set by _cmnd(PixelTransfer). +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not +_const(CONVOLUTION_1D). +.P +_const(INVALID_ENUM) is generated if __internalformat is not one of the +allowable values. +.P +_const(INVALID_VALUE) is generated if __width is less than zero or greater +than the maximum supported value. +This value may be queried with _cmnd(GetConvolutionParameter) +using target _const(CONVOLUTION_1D) and name +_const(MAX_CONVOLUTION_WIDTH). +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param4 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param5 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param4 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetConvolutionParameter), _cmnd(GetConvolutionFilter) +.SH SEE ALSO +_cmnd(ConvolutionFilter2D), +_cmnd(SeparableFilter2D), +_cmnd(ConvolutionParameter), +_cmnd(PixelTransfer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/convolutionfilter2d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/convolutionfilter2d.gl new file mode 100644 index 000000000..df41d5d39 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/convolutionfilter2d.gl @@ -0,0 +1,246 @@ +_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)_C_ +_header(ConvolutionFilter2D,define a two-dimensional convolution filter) +_names(ConvolutionFilter2D) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__internalformat>@,@<_param2>@)_C_ +_define(@<__width>@,@<_param3>@)_C_ +_define(@<__height>@,@<_param4>@)_C_ +_define(@<__format>@,@<_param5>@)_C_ +_define(@<__type>@,@<_param6>@)_C_ +_define(@<__image>@,@<_param7>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be _const(CONVOLUTION_2D). +_phead(__internalformat) +The internal format of the convolution filter kernel. +The allowable values are +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(__width) +The width of the pixel array referenced by __image. +_phead(__height) +The height of the pixel array referenced by __image. +_phead(__format) +The format of the pixel data in __image. +The allowable values are +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(__type) +The type of the pixel data in __image. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) +are accepted. +_phead(__image) +Pointer to a two-dimensional array of pixel data that is processed to +build the convolution filter kernel. +.SH DESCRIPTION +_cmnd builds a two-dimensional convolution filter kernel from an array of +pixels. +.sp +The pixel array specified by __width, __height, __format, __type, and +__image is extracted from memory and processed just as if +_cmnd(DrawPixels) were called, but processing stops after the final +expansion to RGBA is completed. +.sp +The R, G, B, and A components of each pixel are next scaled by the four +2D _const(CONVOLUTION_FILTER_SCALE) parameters and biased by the +four 2D _const(CONVOLUTION_FILTER_BIAS) parameters. +(The scale and bias parameters are set by _cmnd(ConvolutionParameter) +using the _const(CONVOLUTION_2D) target and the names +_const(CONVOLUTION_FILTER_SCALE) and _const(CONVOLUTION_FILTER_BIAS). +The parameters themselves are vectors of four values that are applied to red, +green, blue, and alpha, in that order.) +The R, G, B, and A values are not clamped to [0,1] at any time during this +process. +.sp +Each pixel is then converted to the internal format specified by +__internalformat. +This conversion simply maps the component values of the pixel (R, G, B, +and A) to the values included in the internal format (red, green, blue, +alpha, luminance, and intensity). The mapping is as follows: +.sp +.TS +center; +lb cb cb cb cb cb cb +l c c c c c c. +_ +Internal Format Red Green Blue Alpha Luminance Intensity +_ +_const(ALPHA) A +_const(LUMINANCE) R +_const(LUMINANCE_ALPHA) A R +_const(INTENSITY) R +_const(RGB) R G B +_const(RGBA) R G B A +_ +.TE +.sp +The red, green, blue, alpha, luminance, and/or intensity components of +the resulting pixels are stored in floating-point rather than integer +format. +They form a two-dimensional filter kernel image indexed with coordinates +\f2i\fP and \f2j\fP such that \f2i\fP starts at zero and increases from left +to right, and \f2j\fP starts at zero and increases from bottom to top. +Kernel location \f2i,j\fP is derived from the \f2N\fPth pixel, +where \f2N\fP is \f2i\fP+\f2j\fP*__width. +.PP +Note that after a convolution is performed, the resulting color +components are also scaled by their corresponding +_const(POST_CONVOLUTION_c_SCALE) parameters and biased by their +corresponding _const(POST_CONVOLUTION_c_BIAS) parameters (where +\f2c\fP takes on the values \f3RED\fP, \f3GREEN\fP, \f3BLUE\fP, and +\f3ALPHA\fP). +These parameters are set by _cmnd(PixelTransfer). +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not +_const(CONVOLUTION_2D). +.P +_const(INVALID_ENUM) is generated if __internalformat is not one of the +allowable values. +.P +_const(INVALID_VALUE) is generated if __width is less than zero or greater +than the maximum supported value. +This value may be queried with _cmnd(GetConvolutionParameter) +using target _const(CONVOLUTION_2D) and name +_const(MAX_CONVOLUTION_WIDTH). +.P +_const(INVALID_VALUE) is generated if __height is less than zero or greater +than the maximum supported value. +This value may be queried with _cmnd(GetConvolutionParameter) +using target _const(CONVOLUTION_2D) and name +_const(MAX_CONVOLUTION_HEIGHT). +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param4 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param5 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param4 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetConvolutionParameter), _cmnd(GetConvolutionFilter) +.SH SEE ALSO +_cmnd(ConvolutionFilter1D), +_cmnd(SeparableFilter2D), +_cmnd(ConvolutionParameter), +_cmnd(PixelTransfer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/convolutionparameter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/convolutionparameter.gl new file mode 100644 index 000000000..089c78f82 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/convolutionparameter.gl @@ -0,0 +1,165 @@ +_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,eqn|tbl)_C_ +_header(ConvolutionParameter,set convolution parameters) +_names(ConvolutionParameter,[fi]) +.EQ +delim $$ +.EN +_define(@<__target>@,@<_param1(1)>@)_C_ +_define(@<__pname>@,@<_param2(1)>@)_C_ +_define(@<__param>@,@<_param3(1)>@)_C_ +.sp -1 +.SH PARAMETERS +_phead(__target) +The target for the convolution parameter. +Must be one of +_const(CONVOLUTION_1D), +_const(CONVOLUTION_2D), or +_const(SEPARABLE_2D). +_phead(__pname) +The parameter to be set. +Must be +_const(CONVOLUTION_BORDER_MODE). +_phead(__param) +The parameter value. +Must be one of +_const(REDUCE), _const(CONSTANT_BORDER), _const(REPLICATE_BORDER). +.sp 2 +_names(ConvolutionParameter,[fi]v) +_define(@<__targetv>@,@<_param1(2)>@)_C_ +_define(@<__pnamev>@,@<_param2(2)>@)_C_ +_define(@<__paramv>@,@<_param3(2)>@)_C_ +.sp -1 +.SH PARAMETERS +_phead(__targetv) +The target for the convolution parameter. +Must be one of +_const(CONVOLUTION_1D), +_const(CONVOLUTION_2D), or +_const(SEPARABLE_2D). +_phead(__pnamev) +The parameter to be set. +Must be one of +_const(CONVOLUTION_BORDER_MODE), +_const(CONVOLUTION_BORDER_COLOR), +_const(CONVOLUTION_FILTER_SCALE), or +_const(CONVOLUTION_FILTER_BIAS). +_phead(__paramv) +The parameter value. +If __pnamev is _const(CONVOLUTION_BORDER_MODE), __paramv must be one of +_const(REDUCE), _const(CONSTANT_BORDER), or _const(REPLICATE_BORDER). +Otherwise, must be a vector of four values (for red, green, blue, and alpha, +respectively) to be used for +scaling (when __pnamev is _const(CONVOLUTION_FILTER_SCALE)), or +biasing (when __pnamev is _const(CONVOLUTION_FILTER_BIAS)) a convolution +filter kernel or setting the constant border color (when __pnamev is +_const(CONVOLUTION_BORDER_COLOR). +.SH DESCRIPTION +_cmnd sets the value of a convolution parameter. +.sp +__target selects the convolution filter to be affected: +_const(CONVOLUTION_1D), +_const(CONVOLUTION_2D), or +_const(SEPARABLE_2D) +for the 1D, 2D, or separable 2D filter, respectively. +.sp +__pname selects the parameter to be changed. +_const(CONVOLUTION_FILTER_SCALE) and _const(CONVOLUTION_FILTER_BIAS) +affect the definition of the convolution filter kernel; see +_cmnd(ConvolutionFilter1D), _cmnd(ConvolutionFilter2D), and +_cmnd(SeparableFilter2D) for details. +In these cases, __paramv is an array of four values to be applied to +red, green, blue, and alpha values, respectively. The initial value for +_const(CONVOLUTION_FILTER_SCALE) is (1, 1, 1, 1), and the initial value +for _const(CONVOLUTION_FILTER_BIAS) is (0, 0, 0, 0). +.sp +A __pname value of _const(CONVOLUTION_BORDER_MODE) controls the +convolution border mode. The accepted modes are: +.TP +_const(REDUCE) +The image resulting from convolution is +smaller than the source image. +If the filter width is $Wf$ and height is $Hf$, +and the source image width is $Ws$ and height is $Hs$, +then the convolved image width will be $Ws ~-~ Wf ~+~ 1$ and height +will be $Hs ~-~ Hf ~+~ 1$. +(If this reduction would generate an image with zero or negative width +and/or height, the output is simply null, with no error generated.) +The coordinates of the image resulting from convolution are zero +through $Ws ~-~ Wf$ in width and zero through $Hs ~-~ Hf$ in +height. +.TP +_const(CONSTANT_BORDER) +The image resulting from convolution is the same size as the source image, and +processed as if the source image were surrounded by pixels with their color +specified by the _const(CONVOLUTION_BORDER_COLOR). +.TP +_const(REPLICATE_BORDER) +The image resulting from convolution is the same size as the source image, and +processed as if the outermost pixel on the border of the source image were +replicated. +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.P +In cases where errors can result from the specification of invalid +image dimensions, it is the dimensions after convolution that are +tested, not the dimensions of the source image. +For example, _cmnd(TexImage1D) requires power-of-two image size. +When _const(REDUCE) border mode is in effect, +the source image must be larger than the final power-of-two size +by one less than the size of the 1D filter kernel. +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __pname is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __pname is +_const(CONVOLUTION_BORDER_MODE) and __param is not one of +_const(REDUCE), _const(CONSTANT_BORDER), or _const(REPLICATE_BORDER). +.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(GetConvolutionParameter) +.SH SEE ALSO +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), +_cmnd(SeparableFilter2D), +_cmnd(GetConvolutionParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copycolorsubtable.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copycolorsubtable.gl new file mode 100644 index 000000000..f2ae390b4 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copycolorsubtable.gl @@ -0,0 +1,88 @@ +_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)_C_ +_header(CopyColorSubTable,respecify a portion of a color table) +_names(CopyColorSubTable) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__start>@,@<_param2>@)_C_ +_define(@<__x>@,@<_param3>@)_C_ +_define(@<__y>@,@<_param4>@)_C_ +_define(@<__count>@,@<_param5>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be one of +_const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), or +_const(POST_COLOR_MATRIX_COLOR_TABLE). +_phead(__start) +The starting index of the portion of the color table to be replaced. +_phead(__x __y) +The window coordinates of the left corner of the row of pixels to be +copied. +_phead(__count) +The number of table entries to replace. +.SH DESCRIPTION +_cmnd is used to respecify a contiguous portion of a color table previously +defined using _cmnd(ColorTable). The pixels copied from the framebuffer +replace the portion of the existing table from indices __start to +$_eqnparam2~+~_eqnparam3~-~1$, inclusive. This region may not include any +entries outside the range of the color table, as was originally specified. +It is not an error to specify a subtexture with width of 0, but such a +specification has no effect. +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.P +.SH ERRORS +_const(INVALID_VALUE) is generated if __target is not a previously defined +color table. +.P +_const(INVALID_VALUE) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_VALUE) is generated if $_eqnparam2~+~_eqnparam3~>~width$. +.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(GetColorTable), +_cmnd(GetColorTableParameter) +.SH SEE ALSO +_cmnd(ColorSubTable), +_cmnd(ColorTableParameter), +_cmnd(CopyColorTable), +_cmnd(CopyColorSubTable), +_cmnd(GetColorTable) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copycolortable.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copycolortable.gl new file mode 100644 index 000000000..9014b3328 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copycolortable.gl @@ -0,0 +1,173 @@ +_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(CopyColorTable,copy pixels into a color table) +_names(CopyColorTable) +.EQ +delim $$ +.EN +.SH PARAMETERS +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__internalformat>@,@<_param2>@)_C_ +_define(@<__x>@,@<_param3>@)_C_ +_define(@<__y>@,@<_param4>@)_C_ +_define(@<__width>@,@<_param5>@)_C_ +_phead(__target) +The color table target. Must be +_const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), +or _const(POST_COLOR_MATRIX_COLOR_TABLE). +_phead(__internalformat) +The internal storage format of the texture image. +Must be one of the following symbolic constants: +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), +_const(RGBA16). +_phead(__x) +The x coordinate of the lower-left corner of the pixel rectangle +to be transferred to the color table. +_phead(__y) +The y coordinate of the lower-left corner of the pixel rectangle +to be transferred to the color table. +_phead(__width) +The width of the pixel rectangle. +.SH DESCRIPTION +_cmnd loads a color table with pixels from the current +_const(READ_BUFFER) (rather than from main memory, as is the case for +_cmnd(ColorTable)). +.P +The screen-aligned pixel rectangle with lower-left corner at (__x,\ __y) +having width __width and height 1 +is loaded into the color table. If any pixels within +this region are outside the window that is associated with the GL +context, the values obtained for those pixels are undefined. +.P +The pixels in the rectangle are processed just as if +_cmnd(ReadPixels) were called, with __internalformat set to RGBA, +but processing stops after the final conversion to RGBA. +.P +The four scale parameters and the four bias parameters that are defined +for the table are then used to scale and bias the R, G, B, and A components +of each pixel. The scale and bias parameters are set by calling +_cmnd(ColorTableParameter). +.P +Next, the R, G, B, and A values are clamped to the range [0,1]. +Each pixel is then converted to the internal format specified by +__internalformat. This conversion simply maps the component values of the pixel (R, G, B, +and A) to the values included in the internal format (red, green, blue, +alpha, luminance, and intensity). The mapping is as follows: +.P +.TS +center; +lb cb cb cb cb cb cb +l c c c c c c. +_ +Internal Format Red Green Blue Alpha Luminance Intensity +_ +_const(ALPHA) A +_const(LUMINANCE) R +_const(LUMINANCE_ALPHA) A R +_const(INTENSITY) R +_const(RGB) R G B +_const(RGBA) R G B A +_ +.TE +.P +Finally, the red, green, blue, alpha, luminance, and/or intensity components of +the resulting pixels are stored in the color table. +They form a one-dimensional table with indices in the range +[0,\ __width\ \-\ 1]. +.P +.SH NOTES +_cmnd is available only if _arbstring(imaging) is returned from calling +_cmnd(GetString) with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated when __target is not one of the +allowable values. +.P +_const(INVALID_VALUE) is generated if __width is less than zero. +.P +_const(INVALID_VALUE) is generated if __internalformat is not one of the +allowable values. +.P +_const(TABLE_TOO_LARGE) is generated if the requested color table +is too large to be supported by the implementation. +.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(GetColorTable), +_cmnd(GetColorTableParameter) +.SH SEE ALSO +_cmnd(ColorTable), +_cmnd(ColorTableParameter), +_cmnd(ReadPixels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyconvolutionfilter1d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyconvolutionfilter1d.gl new file mode 100644 index 000000000..79e7ce94c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyconvolutionfilter1d.gl @@ -0,0 +1,177 @@ +_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)_C_ +_header(CopyConvolutionFilter1D,copy pixels into a one-dimensional convolution filter) +_names(CopyConvolutionFilter1D) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__internalformat>@,@<_param2>@)_C_ +_define(@<__x>@,@<_param3>@)_C_ +_define(@<__y>@,@<_param4>@)_C_ +_define(@<__width>@,@<_param5>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be _const(CONVOLUTION_1D). +_phead(__internalformat) +The internal format of the convolution filter kernel. +The allowable values are +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(__x __y) +The window space coordinates of the lower-left coordinate of the +pixel array to copy. +_phead(__width) +The width of the pixel array to copy. +.SH DESCRIPTION +_cmnd defines a one-dimensional convolution filter kernel with pixels +from the current _const(READ_BUFFER) (rather than from main memory, +as is the case for _cmnd(ConvolutionFilter1D)). +.sp +The screen-aligned pixel rectangle with lower-left corner at (__x,\ __y), +width __width and height 1 is used to define +the convolution filter. If any pixels within this region are +outside the window that is associated with the GL context, the +values obtained for those pixels are undefined. +.sp +The pixels in the rectangle are processed exactly as if _cmnd(ReadPixels) +had been called with \f2format\fP +set to RGBA, but the process stops just before final conversion. +The R, G, B, and A components of each pixel are next scaled by the four +1D _const(CONVOLUTION_FILTER_SCALE) parameters and biased by the +four 1D _const(CONVOLUTION_FILTER_BIAS) parameters. +(The scale and bias parameters are set by _cmnd(ConvolutionParameter) +using the _const(CONVOLUTION_1D) target and the names +_const(CONVOLUTION_FILTER_SCALE) and _const(CONVOLUTION_FILTER_BIAS). +The parameters themselves are vectors of four values that are applied to red, +green, blue, and alpha, in that order.) +The R, G, B, and A values are not clamped to [0,1] at any time during this +process. +.sp +Each pixel is then converted to the internal format specified by +__internalformat. +This conversion simply maps the component values of the pixel (R, G, B, +and A) to the values included in the internal format (red, green, blue, +alpha, luminance, and intensity). The mapping is as follows: +.sp +.TS +center; +lb cb cb cb cb cb cb +l c c c c c c. +_ +Internal Format Red Green Blue Alpha Luminance Intensity +_ +_const(ALPHA) A +_const(LUMINANCE) R +_const(LUMINANCE_ALPHA) A R +_const(INTENSITY) R +_const(RGB) R G B +_const(RGBA) R G B A +_ +.TE +.sp +The red, green, blue, alpha, luminance, and/or intensity components of +the resulting pixels are stored in floating-point rather than integer +format. +.sp +Pixel ordering is such that lower x screen coordinates correspond to +lower \f2i\fP filter image coordinates. +.PP +Note that after a convolution is performed, the resulting color +components are also scaled by their corresponding +_const(POST_CONVOLUTION_c_SCALE) parameters and biased by their +corresponding _const(POST_CONVOLUTION_c_BIAS) parameters (where +\f2c\fP takes on the values \f3RED\fP, \f3GREEN\fP, \f3BLUE\fP, and +\f3ALPHA\fP). +These parameters are set by _cmnd(PixelTransfer). +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not +_const(CONVOLUTION_1D). +.P +_const(INVALID_ENUM) is generated if __internalformat is not one of the +allowable values. +.P +_const(INVALID_VALUE) is generated if __width is less than zero or greater +than the maximum supported value. +This value may be queried with _cmnd(GetConvolutionParameter) +using target _const(CONVOLUTION_1D) and name +_const(MAX_CONVOLUTION_WIDTH). +.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(GetConvolutionParameter), _cmnd(GetConvolutionFilter) +.SH SEE ALSO +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionParameter), +_cmnd(PixelTransfer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyconvolutionfilter2d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyconvolutionfilter2d.gl new file mode 100644 index 000000000..3ecdc991a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyconvolutionfilter2d.gl @@ -0,0 +1,188 @@ +_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)_C_ +_header(CopyConvolutionFilter2D,copy pixels into a two-dimensional convolution filter) +_names(CopyConvolutionFilter2D) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__internalformat>@,@<_param2>@)_C_ +_define(@<__x>@,@<_param3>@)_C_ +_define(@<__y>@,@<_param4>@)_C_ +_define(@<__width>@,@<_param5>@)_C_ +_define(@<__height>@,@<_param6>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be _const(CONVOLUTION_2D). +_phead(__internalformat) +The internal format of the convolution filter kernel. +The allowable values are +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(__x __y) +The window space coordinates of the lower-left coordinate of the +pixel array to copy. +_phead(__width) +The width of the pixel array to copy. +_phead(__height) +The height of the pixel array to copy. +.SH DESCRIPTION +_cmnd defines a two-dimensional convolution filter kernel with pixels +from the current _const(READ_BUFFER) (rather than from main memory, +as is the case for _cmnd(ConvolutionFilter2D)). +.sp +The screen-aligned pixel rectangle with lower-left corner at (__x,\ __y), +width __width and height __height +is used to define the convolution filter. If any pixels within this +region are +outside the window that is associated with the GL context, the +values obtained for those pixels are undefined. +.sp +The pixels in the rectangle are processed +exactly as if _cmnd(ReadPixels) had been called with \f2format\fP +set to RGBA, but the process stops just before final conversion. +The R, G, B, and A components of each pixel are next scaled by the four +2D _const(CONVOLUTION_FILTER_SCALE) parameters and biased by the +four 2D _const(CONVOLUTION_FILTER_BIAS) parameters. +(The scale and bias parameters are set by _cmnd(ConvolutionParameter) +using the _const(CONVOLUTION_2D) target and the names +_const(CONVOLUTION_FILTER_SCALE) and _const(CONVOLUTION_FILTER_BIAS). +The parameters themselves are vectors of four values that are applied to red, +green, blue, and alpha, in that order.) +The R, G, B, and A values are not clamped to [0,1] at any time during this +process. +.sp +Each pixel is then converted to the internal format specified by +__internalformat. +This conversion simply maps the component values of the pixel (R, G, B, +and A) to the values included in the internal format (red, green, blue, +alpha, luminance, and intensity). The mapping is as follows: +.sp +.TS +center; +lb cb cb cb cb cb cb +l c c c c c c. +_ +Internal Format Red Green Blue Alpha Luminance Intensity +_ +_const(ALPHA) A +_const(LUMINANCE) R +_const(LUMINANCE_ALPHA) A R +_const(INTENSITY) R +_const(RGB) R G B +_const(RGBA) R G B A +_ +.TE +.sp +The red, green, blue, alpha, luminance, and/or intensity components of +the resulting pixels are stored in floating-point rather than integer +format. +.sp +Pixel ordering is such that lower x screen coordinates correspond to +lower \f2i\fP filter image coordinates, and lower y screen coordinates +correspond to lower \f2j\fP filter image coordinates. +.PP +Note that after a convolution is performed, the resulting color +components are also scaled by their corresponding +_const(POST_CONVOLUTION_c_SCALE) parameters and biased by their +corresponding _const(POST_CONVOLUTION_c_BIAS) parameters (where +\f2c\fP takes on the values \f3RED\fP, \f3GREEN\fP, \f3BLUE\fP, and +\f3ALPHA\fP). +These parameters are set by _cmnd(PixelTransfer). +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not +_const(CONVOLUTION_2D). +.P +_const(INVALID_ENUM) is generated if __internalformat is not one of the +allowable values. +.P +_const(INVALID_VALUE) is generated if __width is less than zero or greater +than the maximum supported value. +This value may be queried with _cmnd(GetConvolutionParameter) +using target _const(CONVOLUTION_2D) and name +_const(MAX_CONVOLUTION_WIDTH). +.P +_const(INVALID_VALUE) is generated if __height is less than zero or greater +than the maximum supported value. +This value may be queried with _cmnd(GetConvolutionParameter) +using target _const(CONVOLUTION_2D) and name +_const(MAX_CONVOLUTION_HEIGHT). +.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(GetConvolutionParameter), _cmnd(GetConvolutionFilter) +.SH SEE ALSO +_cmnd(ConvolutionFilter2D), +_cmnd(ConvolutionParameter), +_cmnd(PixelTransfer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copypixels.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copypixels.gl new file mode 100644 index 000000000..d7edced77 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copypixels.gl @@ -0,0 +1,258 @@ +_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,eqn)_C_ +_header(CopyPixels,copy pixels in the frame buffer) +_names(CopyPixels) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2) +Specify the window coordinates of the lower left corner +of the rectangular region of pixels to be copied. +_phead(_param3 _param4) +Specify the dimensions of the rectangular region of pixels to be copied. +Both must be nonnegative. +_phead(_param5) +Specifies whether color values, +depth values, +or stencil values are to be copied. +Symbolic constants +_const(COLOR), +_const(DEPTH), +and _const(STENCIL) are accepted. +.SH DESCRIPTION +_cmnd copies a screen-aligned rectangle of pixels +from the specified frame buffer location to a region relative to the +current raster position. +Its operation is well defined only if the entire pixel source region +is within the exposed portion of the window. +Results of copies from outside the window, +or from regions of the window that are not exposed, +are hardware dependent and undefined. +.P +_param1 and _param2 specify the window coordinates of +the lower left corner of the rectangular region to be copied. +_param3 and _param4 specify the dimensions of the +rectangular region to be copied. +Both _param3 and _param4 must not be negative. +.P +Several parameters control the processing of the pixel data +while it is being copied. +These parameters are set with three commands: +_cmnd(PixelTransfer), +_cmnd(PixelMap), and +_cmnd(PixelZoom). +This reference page describes the effects on _cmnd of most, +but not all, of the parameters specified by these three commands. +.P +_cmnd copies values from each pixel with the lower left-hand corner at +(_param1 + $i$, _param2 + $j$) for 0 \(<= $i$ < _param3 +and 0 \(<= $j$ < _param4. +This pixel is said to be the $i$th pixel in the $j$th row. +Pixels are copied in row order from the lowest to the highest row, +left to right in each row. +.P +_param5 specifies whether color, depth, or stencil data is to be copied. +The details of the transfer for each data type are as follows: +.TP 15 +_const(COLOR) +Indices or RGBA colors are read from the buffer currently specified as the +read source buffer (see _cmnd(ReadBuffer)). +If the GL is in color index mode, +each index that is read from this buffer is converted +to a fixed-point format with an unspecified +number of bits to the right of the binary point. +Each index is then shifted left by _const(INDEX_SHIFT) bits, +and added to _const(INDEX_OFFSET). +If _const(INDEX_SHIFT) is negative, +the shift is to the right. +In either case, zero bits fill otherwise unspecified bit locations in the +result. +If _const(MAP_COLOR) is true, +the index is replaced with the value that it references in lookup table +_const(PIXEL_MAP_I_TO_I). +Whether the lookup replacement of the index is done or not, +the integer part of the index is then ANDed with $2 sup b -1$, +where $b$ is the number of bits in a color index buffer. +.IP +If the GL is in RGBA mode, +the red, green, blue, and alpha components of each pixel that is read +are converted to an internal floating-point format with unspecified +precision. +The conversion maps the largest representable component value to 1.0, +and component value 0 to 0.0. +The resulting floating-point color values are then multiplied +by _const(c_SCALE) and added to _const(c_BIAS), +where \f2c\fP is RED, GREEN, BLUE, and ALPHA +for the respective color components. +The results are clamped to the range [0,1]. +If _const(MAP_COLOR) is true, +each color component is scaled by the size of lookup table +_const(PIXEL_MAP_c_TO_c), +then replaced by the value that it references in that table. +\f2c\fP is R, G, B, or A. +.IP +If the _arbstring(imaging) extension is supported, the color values may +be +additionally processed by color-table lookups, color-matrix +transformations, and convolution filters. +.IP +The GL then converts the resulting indices or RGBA colors to fragments +by attaching the current raster position \f2z\fP coordinate and +texture coordinates to each pixel, +then assigning window coordinates +($x sub r ~+~ i , y sub r ~+~ j$), +where ($x sub r , y sub r$) is the current raster position, +and the pixel was the $i$th pixel in the $j$th row. +These pixel fragments are then treated just like the fragments generated by +rasterizing points, lines, or polygons. +Texture mapping, +fog, +and all the fragment operations are applied before the fragments are written +to the frame buffer. +.TP +_const(DEPTH) +Depth values are read from the depth buffer and +converted directly to an internal floating-point format +with unspecified precision. +The resulting floating-point depth value is then multiplied +by _const(DEPTH_SCALE) and added to _const(DEPTH_BIAS). +The result is clamped to the range [0,1]. +.IP +The GL then converts the resulting depth components to fragments +by attaching the current raster position color or color index and +texture coordinates to each pixel, +then assigning window coordinates +($x sub r ~+~ i , y sub r ~+~ j$), +where ($x sub r , y sub r$) is the current raster position, +and the pixel was the $i$th pixel in the $j$th row. +These pixel fragments are then treated just like the fragments generated by +rasterizing points, lines, or polygons. +Texture mapping, +fog, +and all the fragment operations are applied before the fragments are written +to the frame buffer. +.TP +_const(STENCIL) +Stencil indices are read from the stencil buffer and +converted to an internal fixed-point format +with an unspecified number of bits to the right of the binary point. +Each fixed-point index is then shifted left by _const(INDEX_SHIFT) bits, +and added to _const(INDEX_OFFSET). +If _const(INDEX_SHIFT) is negative, +the shift is to the right. +In either case, zero bits fill otherwise unspecified bit locations in the +result. +If _const(MAP_STENCIL) is true, +the index is replaced with the value that it references in lookup table +_const(PIXEL_MAP_S_TO_S). +Whether the lookup replacement of the index is done or not, +the integer part of the index is then ANDed with $2 sup b -1$, +where $b$ is the number of bits in the stencil buffer. +The resulting stencil indices are then written to the stencil buffer +such that the index read from the $i$th location of the $j$th row +is written to location +($x sub r ~+~ i , y sub r ~+~ j$), +where ($x sub r , y sub r$) is the current raster position. +Only the pixel ownership test, +the scissor test, +and the stencil writemask affect these write operations. +.P +The rasterization described thus far assumes pixel zoom factors of 1.0. +If +.br +_cmnd(PixelZoom) is used to change the $x$ and $y$ pixel zoom factors, +pixels are converted to fragments as follows. +If ($x sub r$, $y sub r$) is the current raster position, +and a given pixel is in the $i$th location in the $j$th row of the source +pixel rectangle, +then fragments are generated for pixels whose centers are in the rectangle +with corners at +.P +.ce +($x sub r ~+~ zoom sub x^ i$, $y sub r ~+~ zoom sub y^j$) +.sp .5 +.ce + and +.sp .5 +.ce +($x sub r ~+~ zoom sub x^ (i ~+~ 1)$, $y sub r ~+~ zoom sub y^ ( j ~+~ 1 )$) +.P +where $zoom sub x$ is the value of _const(ZOOM_X) and +$zoom sub y$ is the value of _const(ZOOM_Y). +.SH EXAMPLES +To copy the color pixel in the lower left corner of the window to the current raster position, +use +.Ex +glCopyPixels(0, 0, 1, 1, _const(COLOR)); +.En +.SH NOTES +Modes specified by _cmnd(PixelStore) have no effect on the operation +of _cmnd. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param5 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if either _param3 or _param4 is negative. +.P +_const(INVALID_OPERATION) is generated if _param5 is _const(DEPTH) +and there is no depth buffer. +.P +_const(INVALID_OPERATION) is generated if _param5 is _const(STENCIL) +and there is no stencil buffer. +.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(Get) with argument _const(CURRENT_RASTER_POSITION) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_POSITION_VALID) +.SH SEE ALSO +_cmnd(ColorTable), +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), +_cmnd(DepthFunc), +_cmnd(DrawBuffer), +_cmnd(DrawPixels), +_cmnd(MatrixMode), +_cmnd(PixelMap), +_cmnd(PixelTransfer), +_cmnd(PixelZoom), +_cmnd(RasterPos), +_cmnd(ReadBuffer), +_cmnd(ReadPixels), +_cmnd(SeparableFilter2D), +_cmnd(StencilFunc) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyteximage1d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyteximage1d.gl new file mode 100644 index 000000000..007395ec5 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyteximage1d.gl @@ -0,0 +1,178 @@ +_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(CopyTexImage1D,copy pixels into a 1D texture image) +_names(CopyTexImage1D) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. +Must be _const(TEXTURE_1D). +_phead(_param2) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(_param3) +Specifies the internal format of the texture. +Must be one of the following symbolic constants: +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(RGB), +_const(R3_G3_B2), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(_param4 _param5) +Specify the window coordinates of the left corner +of the row of pixels to be copied. +_phead(_param6) +Specifies the width of the texture image. +Must be 0 or $2 sup n ~+~ 2*$_param7 for some integer $n$. +The height of the texture image is 1. +_phead(_param7) +Specifies the width of the border. +Must be either 0 or 1. +.SH DESCRIPTION +_cmnd defines a one-dimensional texture image with pixels from the current +_const(READ_BUFFER). +.P +The screen-aligned pixel row with left corner at $(_eqnparam4, _eqnparam5)$ +and with a length of $_eqnparam6~+~2~*~_eqnparam7$ +defines the texture array +at the mipmap level specified by _param2. +_param3 specifies the internal format of the texture array. +.P +The pixels in the row are processed exactly as if +_cmnd(CopyPixels) had been called, but the process stops just before +final conversion. +At this point all pixel component values are clamped to the range [0,\ 1] +and then converted to the texture's internal format for storage in the texel +array. +.P +Pixel ordering is such that lower $x$ screen coordinates correspond to +lower texture coordinates. +.P +If any of the pixels within the specified row of the current +_const(READ_BUFFER) are outside the window associated with the current +rendering context, then the values obtained for those pixels are undefined. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +Texturing has no effect in color index mode. +.P +1, 2, 3, and 4 are not accepted values for _param3. +.P +An image with 0 width indicates a NULL texture. +.P +When the _arbstring(imaging) extension is supported, the RGBA components +copied from the framebuffer may be processed by the imaging pipeline. See +_cmnd(TexImage1D) for specific details. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of the +allowable values. +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater +than $log sub 2 max$, +where $max$ is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if _param3 is not an +allowable value. +.P +_const(INVALID_VALUE) is generated if _param6 is less than 0 +or greater than +2 + _const(MAX_TEXTURE_SIZE), +or if it cannot be represented as $2 sup n ~+~ 2~*~(_eqnparam7)$ +for some integer value of \f2n\fP. +.P +_const(INVALID_VALUE) is generated if _param7 is not 0 or 1. +.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(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_1D) +.SH SEE ALSO +_cmnd(CopyPixels), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +.br +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyteximage2d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyteximage2d.gl new file mode 100644 index 000000000..b6bec2812 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copyteximage2d.gl @@ -0,0 +1,182 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(CopyTexImage2D,copy pixels into a 2D texture image) +_names(CopyTexImage2D) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. +Must be _const(TEXTURE_2D). +_phead(_param2) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(_param3) +Specifies the internal format of the texture. +Must be one of the following symbolic constants: +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(RGB), +_const(R3_G3_B2), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(_param4 _param5) +Specify the window coordinates of the lower left corner +of the rectangular region of pixels to be copied. +_phead(_param6) +Specifies the width of the texture image. +Must be 0 or $2 sup n ~+~ 2*$_param8 for some integer $n$. +_phead(_param7) +Specifies the height of the texture image. +Must be 0 or $2 sup m ~+~ 2*$_param8 for some integer $m$. +_phead(_param8) +Specifies the width of the border. +Must be either 0 or 1. +.SH DESCRIPTION +_cmnd defines a two-dimensional texture image with pixels from the current +_const(READ_BUFFER). +.P +The screen-aligned pixel rectangle with lower left corner at (_param4, +_param5) and with a width of _param6$~+~2~*~$_param8 and a height of +_param7$~+~2~*~$_param8 +defines the texture array +at the mipmap level specified by _param2. +_param3 specifies the internal format of the texture array. +.P +The pixels in the rectangle are processed exactly as if +_cmnd(CopyPixels) had been called, but the process stops just before +final conversion. +At this point all pixel component values are clamped to the range $[0,1]$ +and then converted to the texture's internal format for storage in the texel +array. +.P +Pixel ordering is such that lower $x$ and $y$ screen coordinates correspond to +lower $s$ and $t$ texture coordinates. +.P +If any of the pixels within the specified rectangle of the current +_const(READ_BUFFER) are outside the window associated with the current +rendering context, then the values obtained for those pixels are undefined. +.P +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +Texturing has no effect in color index mode. +.P +1, 2, 3, and 4 are not accepted values for _param3. +.P +An image with height or width of 0 indicates a NULL texture. +.P +When the _arbstring(imaging) extension is supported, the RGBA components +read from the framebuffer may be processed by the imaging pipeline. See +_cmnd(TexImage1D) for specific details. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not _const(TEXTURE_2D). +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater +than $log sub 2 max$, +where $max$ is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if _param6 or _param7 is less than 0, +greater than $2~+~$_const(MAX_TEXTURE_SIZE), or if _param6 or _param7 cannot be +represented as $2 sup k ~+~ 2~*~$_param8 for some integer +$k$. +.P +_const(INVALID_VALUE) is generated if _param8 is not 0 or 1. +.P +_const(INVALID_VALUE) is generated if _param3 is not one of the +allowable values. +.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(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_2D) +.SH SEE ALSO +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +.br +_cmnd(TexParameter) + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copytexsubimage1d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copytexsubimage1d.gl new file mode 100644 index 000000000..17a01d7c5 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copytexsubimage1d.gl @@ -0,0 +1,138 @@ +_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(CopyTexSubImage1D,copy a one-dimensional texture subimage) +_names(CopyTexSubImage1D) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. +Must be _const(TEXTURE_1D). +_phead(_param2) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(_param3) +Specifies the texel offset within the texture array. +_phead(_param4 _param5) +Specify the window coordinates of the left corner +of the row of pixels to be copied. +_phead(_param6) +Specifies the width of the texture subimage. +.SH DESCRIPTION +_cmnd replaces a portion of a one-dimensional +texture image with pixels from the current _const(READ_BUFFER) (rather +than from main memory, as is the case for _cmnd(TexSubImage1D)). +.P +The screen-aligned pixel row with left corner at (_param4,\ _param5), and with +length _param6 replaces the portion of the +texture array with x indices _param3 through $_eqnparam3 ~+~ _eqnparam6 ~-~ 1$, +inclusive. The destination in the texture array may not +include any texels outside the texture array as it was +originally specified. +.P +The pixels in the row are processed exactly as if +_cmnd(CopyPixels) had been called, but the process stops just before +final conversion. +At this point all pixel component values are clamped to the range [0,\ 1] +and then converted to the texture's internal format for storage in the texel +array. +.P +It is not an error to specify a subtexture with zero width, but +such a specification has no effect. +If any of the pixels within the specified row of the current +_const(READ_BUFFER) are outside the read window associated with the current +rendering context, then the values obtained for those pixels are undefined. +.P +No change is made to the \f2internalformat\fP, \f2width\fP, +or \f2border\fP parameters of the specified texture +array or to texel values outside the specified subregion. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +Texturing has no effect in color index mode. +.P +_cmnd(PixelStore) and _cmnd(PixelTransfer) modes affect texture images +in exactly the way they affect _cmnd(DrawPixels). +.P +When the _arbstring(imaging) extension is supported, the RGBA components +copied from the framebuffer may be processed by the imaging pipeline. See +_cmnd(TexImage1D) for specific details. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not _const(TEXTURE_1D). +.P +_const(INVALID_OPERATION) is generated if the texture array has not +been defined by a previous _cmnd(TexImage1D) or _cmnd(CopyTexImage1D) operation. +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2$>log sub 2$\f2 max\fP, +where \f2max\fP is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if _param5$ ~<~ ~-b$ +or if _param6$ ~<~ ~-b$, where $b$ +is the border width of the texture array. +.P +_const(INVALID_VALUE) is generated if $_eqnparam3 ~<~ ~-b$, or +$(_eqnparam3~+~_eqnparam6) ~>~ (w-b)$, +where $w$ is the _const(TEXTURE_WIDTH), and $b$ is the _const(TEXTURE_BORDER) +of the texture image being modified. +Note that $w$ includes twice the border width. +.P +.SH ASSOCIATED GETS +_cmnd(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_1D) +.SH SEE ALSO +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(ReadBuffer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexParameter), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copytexsubimage2d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copytexsubimage2d.gl new file mode 100644 index 000000000..850b17014 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copytexsubimage2d.gl @@ -0,0 +1,154 @@ +_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(CopyTexSubImage2D,copy a two-dimensional texture subimage) +_names(CopyTexSubImage2D) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. +Must be _const(TEXTURE_2D). +_phead(_param2) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(_param3) +Specifies a texel offset in the x direction within the texture array. +_phead(_param4) +Specifies a texel offset in the y direction within the texture array. +_phead(_param5 _param6) +Specify the window coordinates of the lower left corner +of the rectangular region of pixels to be copied. +_phead(_param7) +Specifies the width of the texture subimage. +_phead(_param8) +Specifies the height of the texture subimage. +.SH DESCRIPTION +_cmnd replaces a rectangular portion of a two-dimensional +texture image with pixels from the current _const(READ_BUFFER) (rather +than from main memory, as is the case for _cmnd(TexSubImage2D)). +.P +The screen-aligned pixel rectangle with lower left corner at +(_param5,\ _param6) and with +width _param7 and height _param8 replaces the portion of the +texture array with x indices _param3 through _param3$~+~$_param7$~-~$1, +inclusive, and y indices _param4 through _param4$~+~$_param8$~-~$1, +inclusive, at the mipmap level specified by _param2. +.P +The pixels in the rectangle are processed exactly as if +_cmnd(CopyPixels) had been called, but the process stops just before +final conversion. +At this point, all pixel component values are clamped to the range [0,\ 1] +and then converted to the texture's internal format for storage in the texel +array. +.P +The destination rectangle in the texture array may not include any texels +outside the texture array as it was originally specified. +It is not an error to specify a subtexture with zero width or height, but +such a specification has no effect. +.P +If any of the pixels within the specified rectangle of the current +_const(READ_BUFFER) are outside the read window associated with the current +rendering context, then the values obtained for those pixels are undefined. +.P +No change is made to the \f2internalformat\fP, \f2width\fP, +\f2height\fP, or \f2border\fP parameters of the specified texture +array or to texel values outside the specified subregion. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +Texturing has no effect in color index mode. +.P +_cmnd(PixelStore) and _cmnd(PixelTransfer) modes affect texture images +in exactly the way they affect _cmnd(DrawPixels). +.P +When the _arbstring(imaging) extension is supported, the RGBA components +read from the framebuffer may be processed by the imaging pipeline. See +_cmnd(TexImage1D) for specific details. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not _const(TEXTURE_2D). +.P +_const(INVALID_OPERATION) is generated if the texture array has not +been defined by a previous _cmnd(TexImage2D) or _cmnd(CopyTexImage2D) operation. +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater +than $log sub 2 max$, +where $max$ is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if _param5$ ~<~ ~-b$ or if +_param6$ ~<~ ~-b$, +where $b$ is the border width of the texture array. +.P +_const(INVALID_VALUE) is generated if $_eqnparam3 ~<~ -b$, +(_param3$~+~$_param7)$~>~(w ~-~b)$, +_param4$~<~ ~-b$, or +(_param4$~+~$_param8)$~>~(h ~-~b)$, +where $w$ is the _const(TEXTURE_WIDTH), +$h$ is the _const(TEXTURE_HEIGHT), +and $b$ is the _const(TEXTURE_BORDER) +of the texture image being modified. +Note that $w$ and $h$ +include twice the border width. +.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(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_2D) +.SH SEE ALSO +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage3D), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(ReadBuffer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexParameter), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copytexsubimage3d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copytexsubimage3d.gl new file mode 100644 index 000000000..5450cb10a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/copytexsubimage3d.gl @@ -0,0 +1,159 @@ +_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(CopyTexSubImage3D,copy a three-dimensional texture subimage) +_names(CopyTexSubImage3D) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. +Must be _const(TEXTURE_3D) +_phead(_param2) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(_param3) +Specifies a texel offset in the x direction within the texture array. +_phead(_param4) +Specifies a texel offset in the y direction within the texture array. +_phead(_param5) +Specifies a texel offset in the z direction within the texture array. +_phead(_param6 _param7) +Specify the window coordinates of the lower left corner +of the rectangular region of pixels to be copied. +_phead(_param8) +Specifies the width of the texture subimage. +_phead(_param9) +Specifies the height of the texture subimage. +.SH DESCRIPTION +_cmnd replaces a rectangular portion of a three-dimensional +texture image with pixels from the current _const(READ_BUFFER) (rather +than from main memory, as is the case for _cmnd(TexSubImage3D)). +.P +The screen-aligned pixel rectangle with lower left corner at +(_param6,\ _param7) and with +width _param8 and height _param9 replaces the portion of the +texture array with x indices _param3 through _param3$~+~$_param8$~-~$1, +inclusive, and y indices _param4 through _param4$~+~$_param9$~-~$1, +inclusive, at z index _param5 and at the mipmap level specified by _param2. +.P +The pixels in the rectangle are processed exactly as if +_cmnd(CopyPixels) had been called, but the process stops just before +final conversion. +At this point, all pixel component values are clamped to the range [0,\ 1] +and then converted to the texture's internal format for storage in the texel +array. +.P +The destination rectangle in the texture array may not include any texels +outside the texture array as it was originally specified. +It is not an error to specify a subtexture with zero width or height, but +such a specification has no effect. +.P +If any of the pixels within the specified rectangle of the current +_const(READ_BUFFER) are outside the read window associated with the current +rendering context, then the values obtained for those pixels are undefined. +.P +No change is made to the \f2internalformat\fP, \f2width\fP, +\f2height\fP, \f2depth\fP, or \f2border\fP parameters of the specified texture +array or to texel values outside the specified subregion. +.SH NOTES +_cmnd is available only if the GL version is 1.2 or greater. +.P +Texturing has no effect in color index mode. +.P +_cmnd(PixelStore) and _cmnd(PixelTransfer) modes affect texture images +in exactly the way they affect _cmnd(DrawPixels). +.P +When the _arbstring(imaging) extension is supported, the RGBA components +copied from the framebuffer may be processed by the imaging pipeline, as +if they were a two-dimensional texture. See _cmnd(TexImage2D) for +specific details. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not _const(TEXTURE_3D). +.P +_const(INVALID_OPERATION) is generated if the texture array has not +been defined by a previous _cmnd(TexImage3D) or _cmnd(CopyTexImage3D) operation. +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater +than $log sub 2^max$, +where $max$ is the returned value of _const(MAX_3D_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if _param6$ ~<~ ~-b$ or if +_param7$ ~<~ ~-b$, +where $b$ is the border width of the texture array. +.P +_const(INVALID_VALUE) is generated if $_eqnparam3 ~<~ -b$, +(_param3$~+~$_param8)$~>~(w ~-~b)$, +_param4$~<~ ~-b$, +(_param4$~+~$_param9)$~>~(h ~-~b)$, +_param5$~<~ ~-b$, or _param5$~>~(d ~-~b)$, +where $w$ is the _const(TEXTURE_WIDTH), +$h$ is the _const(TEXTURE_HEIGHT), +$d$ is the _const(TEXTURE_DEPTH), +and $b$ is the _const(TEXTURE_BORDER) +of the texture image being modified. +Note that $w$, $h$, and $d$ +include twice the border width. +.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(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_3D) +.SH SEE ALSO +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(ReadBuffer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexParameter), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/cullface.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/cullface.gl new file mode 100644 index 000000000..1a77d680c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/cullface.gl @@ -0,0 +1,75 @@ +_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(CullFace,specify whether front- or back-facing facets can be culled) +_names(CullFace) +.SH PARAMETERS +_phead(_param1) +Specifies whether front- or back-facing facets are candidates for culling. +Symbolic constants +_const(FRONT), _const(BACK), and _const(FRONT_AND_BACK) are accepted. +The initial value is _const(BACK). +.SH DESCRIPTION +_cmnd specifies whether front- or back-facing facets are culled +(as specified by \f2mode\fP) when facet culling is enabled. Facet +culling is initially disabled. +To enable and disable facet culling, call the +_cmnd(Enable) and _cmnd(Disable) commands +with the argument _const(CULL_FACE). +Facets include triangles, +quadrilaterals, +polygons, +and rectangles. +.P +_cmnd(FrontFace) specifies which of the clockwise and counterclockwise facets +are front-facing and back-facing. +See _cmnd(FrontFace). +.SH NOTES +If _param1 is _const(FRONT_AND_BACK), no facets are drawn, but other +primitives such as points and lines are drawn. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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(IsEnabled) with argument _const(CULL_FACE) +.br +_cmnd(Get) with argument _const(CULL_FACE_MODE) +.SH SEE ALSO +_cmnd(Enable), +_cmnd(FrontFace) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/deletelists.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/deletelists.gl new file mode 100644 index 000000000..b95fea9d2 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/deletelists.gl @@ -0,0 +1,64 @@ +_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 +_header(DeleteLists,delete a contiguous group of display lists) +_names(DeleteLists) +.SH PARAMETERS +_phead(_param1) +Specifies the integer name of the first display list to delete. +_phead(_param2) +Specifies the number of display lists to delete. +.SH DESCRIPTION +_cmnd causes a contiguous group of display lists to be deleted. +_param1 is the name of the first display list to be deleted, +and _param2 is the number of display lists to delete. +All display lists \fId\fP with _param1 \(<= \fId\fP \(<= _param1 + _param2 \- 1 +are deleted. +.P +All storage locations allocated to the specified display lists are freed, +and the names are available for reuse at a later time. +Names within the range that do not have an associated display list are ignored. +If _param2 is 0, nothing happens. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param2 is negative. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(CallList), +_cmnd(CallLists), +_cmnd(GenLists), +_cmnd(IsList), +_cmnd(NewList) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/deletetextures.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/deletetextures.gl new file mode 100644 index 000000000..f5ad0c0aa --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/deletetextures.gl @@ -0,0 +1,75 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(DeleteTextures,delete named textures) +_names(DeleteTextures) +.SH PARAMETERS +_phead(_param1) +Specifies the number of textures to be deleted. +_phead(_param2) +Specifies an array of textures to be deleted. +.SH DESCRIPTION +_cmnd deletes _param1 textures named by the elements of the array _param2. +After a texture is deleted, it has no contents or dimensionality, +and its name is free for reuse (for example by _cmnd(GenTextures)). +If a texture that is currently bound is deleted, the binding reverts +to 0 (the default texture). +.P +_cmnd silently ignores 0's and names that do not correspond to +existing textures. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is negative. +.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(IsTexture) +.SH SEE ALSO +_cmnd(AreTexturesResident), +_cmnd(BindTexture), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(GenTextures), +_cmnd(Get), +_cmnd(GetTexParameter), +_cmnd(PrioritizeTextures), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_C_ _cmnd(TexImage3D), +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/depthfunc.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/depthfunc.gl new file mode 100644 index 000000000..a41227688 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/depthfunc.gl @@ -0,0 +1,105 @@ +_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(DepthFunc,specify the value used for depth buffer comparisons) +_names(DepthFunc) +.SH PARAMETERS +_phead(_param1) +Specifies the depth comparison function. +Symbolic constants +_const(NEVER), +_const(LESS), +_const(EQUAL), +_const(LEQUAL), +_const(GREATER), +_const(NOTEQUAL), +_const(GEQUAL), and +_const(ALWAYS) are accepted. +The initial value is _const(LESS). +.SH DESCRIPTION +_cmnd specifies the function used to compare each incoming pixel depth value +with the depth value present in the depth buffer. +The comparison is performed only if depth testing is enabled. +(See _cmnd(Enable) and _cmnd(Disable) of _const(DEPTH_TEST).) +.P +_param1 specifies the conditions under which the pixel will be drawn. +The comparison functions are as follows: +.TP 16 +_const(NEVER) +Never passes. +.TP +_const(LESS) +Passes if the incoming depth value is less than the stored depth value. +.TP +_const(EQUAL) +Passes if the incoming depth value is equal to the stored depth value. +.TP +_const(LEQUAL) +Passes if the incoming depth value is less than or equal to +the stored depth value. +.TP +_const(GREATER) +Passes if the incoming depth value is greater than the stored depth value. +.TP +_const(NOTEQUAL) +Passes if the incoming depth value is not equal to the stored depth value. +.TP +_const(GEQUAL) +Passes if the incoming depth value is greater than or equal to +the stored depth value. +.TP +_const(ALWAYS) +Always passes. +.P +The initial value of _param1 is _const(LESS). +Initially, depth testing is disabled. +.NOTES +Even if the depth buffer exists and the depth mask is non-zero, the +depth buffer is not updated if the depth test is disabled. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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(Get) with argument _const(DEPTH_FUNC) +.br +_cmnd(IsEnabled) with argument _const(DEPTH_TEST) +.SH SEE ALSO +_cmnd(DepthRange), +_cmnd(Enable), +_cmnd(PolygonOffset) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/depthmask.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/depthmask.gl new file mode 100644 index 000000000..ef57b2ad3 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/depthmask.gl @@ -0,0 +1,63 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(DepthMask,enable or disable writing into the depth buffer) +_names(DepthMask) +.SH PARAMETERS +_phead(_param1) +Specifies whether the depth buffer is enabled for writing. +If _param1 is _const(FALSE), +depth buffer writing is disabled. +Otherwise, it is enabled. +Initially, depth buffer writing is enabled. +.SH DESCRIPTION +_cmnd specifies whether the depth buffer is enabled for writing. +If _param1 is _const(FALSE), +depth buffer writing is disabled. +Otherwise, it is enabled. +Initially, depth buffer writing is enabled. +.SH ERRORS +_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(Get) with argument _const(DEPTH_WRITEMASK) +.SH SEE ALSO +_cmnd(ColorMask), +_cmnd(DepthFunc), +_cmnd(DepthRange), +_cmnd(IndexMask), +_cmnd(StencilMask) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/depthrange.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/depthrange.gl new file mode 100644 index 000000000..b68b32e2a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/depthrange.gl @@ -0,0 +1,79 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(DepthRange,specify mapping of depth values from normalized device coordinates to window coordinates) +_names(DepthRange) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the mapping of the near clipping plane to window coordinates. +The initial value is 0. +_phead(_param2) +Specifies the mapping of the far clipping plane to window coordinates. +The initial value is 1. +.SH DESCRIPTION +After clipping and division by \f2w\fP, +depth coordinates range from \-1 to 1, +corresponding to the near and far clipping planes. +_cmnd specifies a linear mapping of the normalized depth coordinates +in this range to window depth coordinates. +Regardless of the actual depth buffer implementation, +window coordinate depth values are treated as though they range +from 0 through 1 (like color components). +Thus, +the values accepted by _cmnd are both clamped to this range +before they are accepted. +.P +The setting of (0,1) maps the near plane to 0 and +the far plane to 1. +With this mapping, +the depth buffer range is fully utilized. +.SH NOTES +It is not necessary that _param1 be less than _param2. +Reverse mappings such as $_eqnparam1 ~=~ 1$, and $_eqnparam2 ~=~ 0$ +are acceptable. +.SH ERRORS +_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(Get) with argument _const(DEPTH_RANGE) +.SH SEE ALSO +_cmnd(DepthFunc), +_cmnd(PolygonOffset), +_cmnd(Viewport) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawarrays.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawarrays.gl new file mode 100644 index 000000000..388988fad --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawarrays.gl @@ -0,0 +1,116 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_header(DrawArrays, render primitives from array data) +_names(DrawArrays) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies what kind of primitives to render. +Symbolic constants +_const(POINTS), +_const(LINE_STRIP), +_const(LINE_LOOP), +_const(LINES), +_const(TRIANGLE_STRIP), +_const(TRIANGLE_FAN), +_const(TRIANGLES), +_const(QUAD_STRIP), +_const(QUADS), +and _const(POLYGON) are accepted. +_phead(_param2) +Specifies the starting index in the enabled arrays. +_phead(_param3) +Specifies the number of indices to be rendered. +.SH DESCRIPTION +_cmnd specifies multiple geometric primitives +with very few subroutine calls. Instead of calling a GL procedure +to pass each individual vertex, normal, texture coordinate, edge +flag, or color, you can prespecify +separate arrays of vertices, normals, and colors and use them to +construct a sequence of primitives with a single +call to _cmnd. +.P +When _cmnd is called, it uses _param3 sequential elements from each +enabled array to construct a sequence of geometric primitives, +beginning with element _param2. _param1 specifies what kind of +primitives are constructed, and how the array elements +construct those primitives. If _const(VERTEX_ARRAY) is not enabled, no +geometric primitives are generated. +.P +Vertex attributes that are modified by _cmnd have an +unspecified value after _cmnd returns. For example, if +_const(COLOR_ARRAY) is enabled, the value of the current color is +undefined after _cmnd executes. Attributes that aren't +modified remain well defined. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +_cmnd is included in display lists. If _cmnd is entered into a +display list, +the necessary array data (determined by the array pointers and +enables) is also +entered into the display list. Because the array pointers and +enables are client-side state, their values affect display lists +when the lists are created, not when the lists are executed. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param3 is negative. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed between +the execution of _cmnd(Begin) and the corresponding _cmnd(End). +.SH SEE ALSO +_cmnd(ArrayElement), +_cmnd(ColorPointer), +_cmnd(DrawElements), +_cmnd(DrawRangeElements), +_cmnd(EdgeFlagPointer), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(NormalPointer), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawbuffer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawbuffer.gl new file mode 100644 index 000000000..52699d73e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawbuffer.gl @@ -0,0 +1,158 @@ +_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(DrawBuffer,specify which color buffers are to be drawn into) +_names(DrawBuffer) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies up to four color buffers to be drawn into. +Symbolic constants +_const(NONE), +_const(FRONT_LEFT), +_const(FRONT_RIGHT), +_const(BACK_LEFT), +_const(BACK_RIGHT), +_const(FRONT), +_const(BACK), +_const(LEFT), +_const(RIGHT), +_const(FRONT_AND_BACK), and +_const(AUX)\f2i\fP, +where \f2i\fP is between 0 and +.br +``_const(AUX_BUFFERS)'' \-1, +are accepted (_const(AUX_BUFFERS) is not the upper limit; use _cmnd(Get) +to query the number of available aux buffers.) +The initial value is _const(FRONT) for single-buffered contexts, +and _const(BACK) for double-buffered contexts. +.SH DESCRIPTION +When colors are written to the frame buffer, +they are written into the color buffers specified by _cmnd. +The specifications are as follows: +.TP 25 +_const(NONE) +No color buffers are written. +.TP +_const(FRONT_LEFT) +Only the front left color buffer is written. +.TP +_const(FRONT_RIGHT) +Only the front right color buffer is written. +.TP +_const(BACK_LEFT) +Only the back left color buffer is written. +.TP +_const(BACK_RIGHT) +Only the back right color buffer is written. +.TP +_const(FRONT) +Only the front left and front right color buffers are written. +If there is no front right color buffer, +only the front left color buffer is written. +.TP +_const(BACK) +Only the back left and back right color buffers are written. +If there is no back right color buffer, +only the back left color buffer is written. +.TP +_const(LEFT) +Only the front left and back left color buffers are written. +If there is no back left color buffer, +only the front left color buffer is written. +.TP +_const(RIGHT) +Only the front right and back right color buffers are written. +If there is no back right color buffer, +only the front right color buffer is written. +.BP +.TP +_const(FRONT_AND_BACK) +All the front and back color buffers +(front left, front right, back left, back right) +are written. +If there are no back color buffers, +only the front left and front right color buffers are written. +If there are no right color buffers, +only the front left and back left color buffers are written. +If there are no right or back color buffers, +only the front left color buffer is written. +.TP +_const(AUX)\f2i\fP +Only auxiliary color buffer \f2i\fP is written. +.P +If more than one color buffer is selected for drawing, +then blending or logical operations are computed and applied independently +for each color buffer and can produce different results in each buffer. +.P +Monoscopic contexts include only +.I left +buffers, and stereoscopic contexts include both +.I left +and +.I right +buffers. +Likewise, single-buffered contexts include only +.I front +buffers, and double-buffered contexts include both +.I front +and +.I back +buffers. +The context is selected at GL initialization. +.SH NOTES +It is always the case that _const(AUX)$i$ = _const(AUX0) + $i$. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_OPERATION) is generated if none of the buffers indicated +by _param1 exists. +.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(Get) with argument _const(DRAW_BUFFER) +.br +_cmnd(Get) with argument _const(AUX_BUFFERS) +.SH SEE ALSO +_cmnd(BlendFunc), +_cmnd(ColorMask), +_cmnd(IndexMask), +_cmnd(LogicOp), +_cmnd(ReadBuffer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawelements.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawelements.gl new file mode 100644 index 000000000..def9ede20 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawelements.gl @@ -0,0 +1,122 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_header(DrawElements, render primitives from array data) +_names(DrawElements) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies what kind of primitives to render. +Symbolic constants +_const(POINTS), +_const(LINE_STRIP), +_const(LINE_LOOP), +_const(LINES), +_const(TRIANGLE_STRIP), +_const(TRIANGLE_FAN), +_const(TRIANGLES), +_const(QUAD_STRIP), +_const(QUADS), +and _const(POLYGON) are accepted. +_phead(_param2) +Specifies the number of elements to be rendered. +_phead(_param3) +Specifies the type of the values in _param4. Must be one of +_const(UNSIGNED_BYTE), _const(UNSIGNED_SHORT), or +_const(UNSIGNED_INT). +_phead(_param4) +Specifies a pointer to the location where the indices are stored. +.SH DESCRIPTION +_cmnd specifies multiple geometric primitives +with very few subroutine calls. Instead of calling a GL function +to pass each individual vertex, normal, texture coordinate, edge +flag, or color, you can prespecify +separate arrays of vertices, normals, and so on and use them to +construct a sequence of primitives with a single +call to _cmnd. +.P +When _cmnd is called, it uses _param2 sequential elements from an +enabled array, starting at _param4 to construct a sequence of +geometric primitives. _param1 specifies what kind of primitives are +constructed, and how the array elements construct these primitives. If +more than one array is enabled, each is used. If +_const(VERTEX_ARRAY) is not enabled, no geometric primitives are +constructed. +.P +Vertex attributes that are modified by _cmnd have an +unspecified value after _cmnd returns. For example, if +_const(COLOR_ARRAY) is enabled, the value of the current color is +undefined after _cmnd executes. Attributes that aren't +modified maintain their previous values. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +_cmnd is included in display lists. If _cmnd is entered into a +display list, +the necessary array data (determined by the array pointers and +enables) is also +entered into the display list. Because the array pointers and +enables are client-side state, their values affect display lists +when the lists are created, not when the lists are executed. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param2 is negative. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed between +the execution of _cmnd(Begin) and the corresponding _cmnd(End). +.SH SEE ALSO +_cmnd(ArrayElement), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawRangeElements), +_cmnd(EdgeFlagPointer), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(NormalPointer), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawpixels.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawpixels.gl new file mode 100644 index 000000000..4bc21e919 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawpixels.gl @@ -0,0 +1,559 @@ +_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(DrawPixels,write a block of pixels to the frame buffer) +_names(DrawPixels) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2) +Specify the dimensions of the pixel rectangle to be written +into the frame buffer. +_phead(_param3) +Specifies the format of the pixel data. +Symbolic constants +_const(COLOR_INDEX), +_const(STENCIL_INDEX), +_const(DEPTH_COMPONENT), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA) are accepted. +_phead(_param4) +Specifies the data type for _param5. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) +are accepted. +_phead(_param5) +Specifies a pointer to the pixel data. +.SH DESCRIPTION +_cmnd reads pixel data from memory and writes it into the frame buffer +.br +relative to the current raster position, provided that the raster +position is valid. Use +.br +_cmnd(RasterPos) to set the current raster position; use +_cmnd(Get) with argument _const(CURRENT_RASTER_POSITION_VALID) +to determine if the specified raster position is valid, and +_cmnd(Get) with argument _const(CURRENT_RASTER_POSITION) +to query the raster position. +.P +Several parameters define the encoding of pixel data in memory +and control the processing of the pixel data +before it is placed in the frame buffer. +These parameters are set with four commands: +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(PixelMap), and _cmnd(PixelZoom). +This reference page describes the effects on _cmnd of many, +but not all, of the parameters specified by these four commands. +.P +Data is read from _param5 as a sequence of signed or unsigned bytes, +signed or unsigned shorts, signed or unsigned integers, or +single-precision floating-point values, depending on _param4. +When _param4 is one of _const(UNSIGNED_BYTE), _const(BYTE), +_const(UNSIGNED_SHORT), _const(SHORT), _const(UNSIGNED_INT), +_const(INT), or _const(FLOAT) each of these bytes, shorts, integers, or +floating-point values is interpreted as one color or depth component, or +one index, depending on _param3. +When _param4 is one of _const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_SHORT_5_6_5), _const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_5_5_5_1), _const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_10_10_10_2), each unsigned value is interpreted as +containing all the components for a single pixel, with the color +components arranged according to _param3. +When _param4 is one of _const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5_REV), _const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_1_5_5_5_REV), _const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_2_10_10_10_REV), each unsigned value is interpreted +as containing all color components, specified by _param3, for a single +pixel in a reversed order. Indices are always treated individually. +Color components are treated as groups of one, two, three, or four +values, again based on _param3. Both individual indices and groups of +components are referred to as pixels. +If _param4 is _const(BITMAP), the data must be unsigned bytes, and +_param3 must be either _const(COLOR_INDEX) or _const(STENCIL_INDEX). +Each unsigned byte is treated as eight 1-bit pixels, with bit ordering +determined by _const(UNPACK_LSB_FIRST) (see _cmnd(PixelStore)). +.P +_param1$~ times ~$_param2 pixels are read from memory, +starting at location _param5. +By default, these pixels are taken from adjacent memory locations, +except that after all _param1 pixels are read, +the read pointer is advanced to the next four-byte boundary. +The four-byte row alignment is specified by _cmnd(PixelStore) with +argument _const(UNPACK_ALIGNMENT), +and it can be set to one, two, four, or eight bytes. +Other pixel store parameters specify different read pointer advancements, +both before the first pixel is read +and after all _param1 pixels are read. +See the _cmnd(PixelStore) reference page for details on these options. +.P +The _param1$~ times ~$_param2 pixels that are read from memory are +each operated on in the same way, +based on the values of several parameters specified by _cmnd(PixelTransfer) +and _cmnd(PixelMap). +The details of these operations, +as well as the target buffer into which the pixels are drawn, +are specific to the format of the pixels, +as specified by _param3. +_param3 can assume one of 13 symbolic values: +.TP 10 +_const(COLOR_INDEX) +Each pixel is a single value, +a color index. +It is converted to fixed-point format, +with an unspecified number of bits to the right of the binary point, +regardless of the memory data type. +Floating-point values convert to true fixed-point values. +Signed and unsigned integer data is converted with all fraction bits +set to 0. +Bitmap data convert to either 0 or 1. +.IP +Each fixed-point index is then shifted left by _const(INDEX_SHIFT) bits +and added to _const(INDEX_OFFSET). +If _const(INDEX_SHIFT) is negative, +the shift is to the right. +In either case, zero bits fill otherwise unspecified bit locations in the +result. +.IP +If the GL is in RGBA mode, +the resulting index is converted to an RGBA pixel +with the help of the _const(PIXEL_MAP_I_TO_R), +_const(PIXEL_MAP_I_TO_G), +_const(PIXEL_MAP_I_TO_B), +and _const(PIXEL_MAP_I_TO_A) tables. +If the GL is in color index mode, +and if _const(MAP_COLOR) is true, +the index is replaced with the value that it references in lookup table +_const(PIXEL_MAP_I_TO_I). +Whether the lookup replacement of the index is done or not, +the integer part of the index is then ANDed with $2 sup b -1$, +where $b$ is the number of bits in a color index buffer. +.BP +.IP +The GL then converts the resulting indices or RGBA colors to fragments +by attaching the current raster position \f2z\fP coordinate and +texture coordinates to each pixel, +then assigning $x$ and $y$ window coordinates to the $n$th fragment such that +.sp +.RS +.ce +$x sub n ~=~ x sub r ~+~ n ~ roman mod ~ _eqnparam1$ +.sp +.ce +$y sub n ~=~ y sub r ~+~ \(lf n ^/^ _eqnparam1 ~ \(rf$ +.ce 0 +.sp +.RE +.IP +where ($x sub r , y sub r$) is the current raster position. +These pixel fragments are then treated just like the fragments generated by +rasterizing points, lines, or polygons. +Texture mapping, +fog, +and all the fragment operations are applied before the fragments are written +to the frame buffer. +.TP +_const(STENCIL_INDEX) +Each pixel is a single value, +a stencil index. +It is converted to fixed-point format, +with an unspecified number of bits to the right of the binary point, +regardless of the memory data type. +Floating-point values convert to true fixed-point values. +Signed and unsigned integer data is converted with all fraction bits +set to 0. +Bitmap data convert to either 0 or 1. +.IP +Each fixed-point index is then shifted left by _const(INDEX_SHIFT) bits, +and added to _const(INDEX_OFFSET). +If _const(INDEX_SHIFT) is negative, +the shift is to the right. +In either case, zero bits fill otherwise unspecified bit locations in the +result. +If _const(MAP_STENCIL) is true, +the index is replaced with the value that it references in lookup table +_const(PIXEL_MAP_S_TO_S). +Whether the lookup replacement of the index is done or not, +the integer part of the index is then ANDed with $2 sup b -1$, +where $b$ is the number of bits in the stencil buffer. +The resulting stencil indices are then written to the stencil buffer +such that the $n$th index is written to location +.P +.RS +.ce +$x sub n ~=~ x sub r ~+~ n ~ roman mod ~ _eqnparam1$ +.sp +.ce +$y sub n ~=~ y sub r ~+~ \(lf ~ n / _eqnparam1 ~ \(rf$ +.fi +.sp +.RE +.IP +where ($x sub r , y sub r$) is the current raster position. +Only the pixel ownership test, +the scissor test, +and the stencil writemask affect these write operations. +.TP +_const(DEPTH_COMPONENT) +Each pixel is a single-depth component. +Floating-point data is converted directly to an internal floating-point +format with unspecified precision. +Signed integer data is mapped linearly to the internal floating-point +format such that the most positive representable integer value maps to 1.0, +and the most negative representable value maps to \-1.0. +Unsigned integer data is mapped similarly: +the largest integer value maps to 1.0, +and 0 maps to 0.0. +The resulting floating-point depth value is then multiplied +by _const(DEPTH_SCALE) and added to _const(DEPTH_BIAS). +The result is clamped to the range [0,1]. +.IP +The GL then converts the resulting depth components to fragments +by attaching the current raster position color or color index and +texture coordinates to each pixel, +then assigning $x$ and $y$ window coordinates to the $n$th fragment such that +.P +.RS +.ce +$x sub n ~=~ x sub r ~+~ n ~ roman mod ~ _eqnparam1$ +.sp +.ce +$y sub n ~=~ y sub r ~+~ \(lf ~ n / _eqnparam1 ~ \(rf$ +.ce 0 +.sp +.RE +.IP +where ($x sub r , y sub r$) is the current raster position. +These pixel fragments are then treated just like the fragments generated by +rasterizing points, lines, or polygons. +Texture mapping, +fog, +and all the fragment operations are applied before the fragments are written +to the frame buffer. +.TP +_const(RGBA) +.TP +_const(BGRA) +_C_ .TP +_C_ const(ABGR_EXT) +Each pixel is a four-component group: for _const(RGBA), the red +component is first, followed by green, followed by blue, followed by +alpha; for _const(BGRA) the order is blue, green, red and then alpha. +_C_; for _const(ABGR_EXT) the order is alpha, blue, green, and then red. +Floating-point values are converted directly to an internal floating-point +format with unspecified precision. +Signed integer values are mapped linearly to the internal floating-point +format such that the most positive representable integer value maps to 1.0, +and the most negative representable value maps to \-1.0. (Note that +this mapping does not convert 0 precisely to 0.0.) +Unsigned integer data is mapped similarly: +the largest integer value maps to 1.0, +and 0 maps to 0.0. +The resulting floating-point color values are then multiplied +by _const(c_SCALE) and added to _const(c_BIAS), +where \f2c\fP is RED, GREEN, BLUE, and ALPHA +for the respective color components. +The results are clamped to the range [0,1]. +.IP +If _const(MAP_COLOR) is true, +each color component is scaled by the size of lookup table +_const(PIXEL_MAP_c_TO_c), +then replaced by the value that it references in that table. +\f2c\fP is R, G, B, or A respectively. +.BP +.IP +The GL then converts the resulting RGBA colors to fragments +by attaching the current raster position \f2z\fP coordinate and +texture coordinates to each pixel, +then assigning $x$ and $y$ window coordinates to the $n$th fragment such that +.P +.RS +.ce +$x sub n ~=~ x sub r ~+~ n ~ roman mod ~ _eqnparam1$ +.sp +.ce +$y sub n ~=~ y sub r ~+~ \(lf ~ n / _eqnparam1 ~ \(rf$ +.ce 0 +.sp +.RE +.IP +where ($x sub r , y sub r$) is the current raster position. +These pixel fragments are then treated just like the fragments generated by +rasterizing points, lines, or polygons. +Texture mapping, +fog, +and all the fragment operations are applied before the fragments are written +to the frame buffer. +.TP +_const(RED) +Each pixel is a single red component. +This component is converted to the internal floating-point format in +the same way the red component of an RGBA pixel is. It is +then converted to an RGBA pixel with green and blue set to 0, +and alpha set to 1. +After this conversion, the pixel is treated as if it had been read +as an RGBA pixel. +.TP +_const(GREEN) +Each pixel is a single green component. +This component is converted to the internal floating-point format in +the same way the green component of an RGBA pixel is. +It is then converted to an RGBA pixel with red and blue set to 0, +and alpha set to 1. +After this conversion, the pixel is treated as if it had been read +as an RGBA pixel. +.TP +_const(BLUE) +Each pixel is a single blue component. +This component is converted to the internal floating-point format in +the same way the blue component of an RGBA pixel is. +It is then converted to an RGBA pixel with red and green set to 0, +and alpha set to 1. +After this conversion, the pixel is treated as if it had been read +as an RGBA pixel. +.TP +_const(ALPHA) +Each pixel is a single alpha component. +This component is converted to the internal floating-point format in +the same way the alpha component of an RGBA pixel is. +It is then converted to an RGBA pixel with red, green, and blue set to 0. +After this conversion, the pixel is treated as if it had been read +as an RGBA pixel. +.BP +.TP +_const(RGB) +.TP +_const(BGR) +Each pixel is a three-component group: +red first, followed by green, followed by blue; for _const(BGR), the +first component is blue, followed by green and then red. +Each component is converted to the internal floating-point format in +the same way the red, green, and blue components of an RGBA pixel are. +The color triple is converted to an RGBA pixel with alpha set to 1. +After this conversion, the pixel is treated as if it had been read +as an RGBA pixel. +.TP +_const(LUMINANCE) +Each pixel is a single luminance component. +This component is converted to the internal floating-point format in +the same way the red component of an RGBA pixel is. +It is then converted to an RGBA pixel with red, green, and blue set to the +converted luminance value, +and alpha set to 1. +After this conversion, the pixel is treated as if it had been read +as an RGBA pixel. +.TP +_const(LUMINANCE_ALPHA) +Each pixel is a two-component group: +luminance first, followed by alpha. +The two components are converted to the internal floating-point format in +the same way the red component of an RGBA pixel is. +They are then converted to an RGBA pixel with red, green, and blue set to the +converted luminance value, +and alpha set to the converted alpha value. +After this conversion, the pixel is treated as if it had been read +as an RGBA pixel. +.P +The following table summarizes the meaning of the valid constants for the +\f2type\fP parameter: +.sp 2 +.TS +center; +lb lb +l l. +_ +Type Corresponding Type +_ +_const(UNSIGNED_BYTE) unsigned 8-bit integer +_const(BYTE) signed 8-bit integer +_const(BITMAP) single bits in unsigned 8-bit integers +_const(UNSIGNED_SHORT) unsigned 16-bit integer +_const(SHORT) signed 16-bit integer +_const(UNSIGNED_INT) unsigned 32-bit integer +_const(INT) 32-bit integer +_const(FLOAT) single-precision floating-point +_const(UNSIGNED_BYTE_3_3_2) unsigned 8-bit integer +_const(UNSIGNED_BYTE_2_3_3_REV) unsigned 8-bit integer with reversed component ordering +_const(UNSIGNED_SHORT_5_6_5) unsigned 16-bit integer +_const(UNSIGNED_SHORT_5_6_5_REV) unsigned 16-bit integer with reversed component ordering +_const(UNSIGNED_SHORT_4_4_4_4) unsigned 16-bit integer +_const(UNSIGNED_SHORT_4_4_4_4_REV) unsigned 16-bit integer with reversed component ordering +_const(UNSIGNED_SHORT_5_5_5_1) unsigned 16-bit integer +_const(UNSIGNED_SHORT_1_5_5_5_REV) unsigned 16-bit integer with reversed component ordering +_const(UNSIGNED_INT_8_8_8_8) unsigned 32-bit integer +_const(UNSIGNED_INT_8_8_8_8_REV) unsigned 32-bit integer with reversed component ordering +_const(UNSIGNED_INT_10_10_10_2) unsigned 32-bit integer +_const(UNSIGNED_INT_2_10_10_10_REV) unsigned 32-bit integer with reversed component ordering +_ +.TE +.sp +.BP +.P +The rasterization described so far assumes pixel zoom factors of 1. +If +.br +_cmnd(PixelZoom) is used to change the $x$ and $y$ pixel zoom factors, +pixels are converted to fragments as follows. +If ($x sub r$, $y sub r$) is the current raster position, +and a given pixel is in the $n$th column and $m$th row +of the pixel rectangle, +then fragments are generated for pixels whose centers are in the rectangle +with corners at +.sp +.RS +.ce +($x sub r ~+~ zoom sub x^ n$, $y sub r ~+~ zoom sub y^ m$) +.sp +.ce +($x sub r ~+~ zoom sub x^ (n ~+~ 1)$, $y sub r ~+~ zoom sub y^ ( m ~+~ 1 )$) +.ce 0 +.sp +.RE +.P +where $zoom sub x$ is the value of _const(ZOOM_X) and +$zoom sub y$ is the value of _const(ZOOM_Y). +.SH NOTES +_const(BGR) and _const(BGRA) are only valid for _param3 if the GL +version is 1.2 or greater. +.P +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) are only valid for _param4 if the +GL version is 1.2 or greater. +.SH ERRORS +_const(INVALID_VALUE) is generated if either _param1 or _param2 is negative. +.P +_const(INVALID_ENUM) is generated if _param3 or _param4 is not one of +the accepted values. +.P +_const(INVALID_OPERATION) is generated if _param3 is +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(RGBA), +_const(BGR), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), +or +_const(LUMINANCE_ALPHA), +and the GL is in color index mode. +.P +_const(INVALID_ENUM) is generated if _param4 is _const(BITMAP) and +_param3 is not either _const(COLOR_INDEX) or _const(STENCIL_INDEX). +.P +_const(INVALID_OPERATION) is generated if _param3 is _const(STENCIL_INDEX) +and there is no stencil buffer. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param3 is one +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), of +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param3 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param3 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param3 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(CURRENT_RASTER_POSITION) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_POSITION_VALID) +.SH SEE ALSO +_cmnd(AlphaFunc), +_cmnd(BlendFunc), +_cmnd(CopyPixels), +_cmnd(DepthFunc), +_cmnd(LogicOp), +_cmnd(PixelMap), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(PixelZoom), +_cmnd(RasterPos), +_cmnd(ReadPixels), +_cmnd(Scissor), +_cmnd(StencilFunc) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawrangeelements.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawrangeelements.gl new file mode 100644 index 000000000..054bc9b76 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/drawrangeelements.gl @@ -0,0 +1,145 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_header(DrawRangeElements, render primitives from array data) +_names(DrawRangeElements) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies what kind of primitives to render. +Symbolic constants +_const(POINTS), +_const(LINE_STRIP), +_const(LINE_LOOP), +_const(LINES), +_const(TRIANGLE_STRIP), +_const(TRIANGLE_FAN), +_const(TRIANGLES), +_const(QUAD_STRIP), +_const(QUADS), +and _const(POLYGON) are accepted. +_phead(_param2) +Specifies the minimum array index contained in _param6(1). +_phead(_param3) +Specifies the maximum array index contained in _param6(1). +_phead(_param4) +Specifies the number of elements to be rendered. +_phead(_param5) +Specifies the type of the values in _param4. Must be one of +_const(UNSIGNED_BYTE), _const(UNSIGNED_SHORT), or +_const(UNSIGNED_INT). +_phead(_param6) +Specifies a pointer to the location where the indices are stored. +.SH DESCRIPTION +_cmnd is a restricted form of _cmnd(DrawElements). _param1, _param2, _param3, +and _param4 match the corresponding arguments to _cmnd(DrawElements), with +the additional constraint that all values in the arrays _param4 must lie +between _param2 and _param3, inclusive. +.P +Implementations denote recommended maximum amounts of vertex and +.br +index data, +which may be queried by calling _cmnd(Get) with argument +_const(MAX_ELEMENTS_VERTICES) and _const(MAX_ELEMENTS_INDICES). +If $_eqnparam3 ~-~ _eqnparam2 ~+~ 1$ is greater than the value of +_const(MAX_ELEMENTS_VERTICES), or if _param4 is greater than the value of +_const(MAX_ELEMENTS_INDICES), then the call may operate at reduced +performance. There is no requirement that all vertices in the range +[_param2,\ _param3] be referenced. However, the implementation may +partially process unused vertices, reducing performance from what could +be achieved with an optimal index set. +.P +When _cmnd is called, it uses _param2 sequential elements from an +enabled array, starting at _param4 to construct a sequence of +geometric primitives. _param1 specifies what kind of primitives are +constructed, and how the array elements construct these primitives. If +more than one array is enabled, each is used. If +_const(VERTEX_ARRAY) is not enabled, no geometric primitives are +constructed. +.P +Vertex attributes that are modified by _cmnd have an +unspecified value after _cmnd returns. For example, if +_const(COLOR_ARRAY) is enabled, the value of the current color is +undefined after _cmnd executes. Attributes that aren't +modified maintain their previous values. +.SH NOTES +_cmnd is available only if the GL version is 1.2 or greater. +.P +_cmnd is included in display lists. If _cmnd is entered into a +display list, +the necessary array data (determined by the array pointers and +enables) is also +entered into the display list. Because the array pointers and +enables are client-side state, their values affect display lists +when the lists are created, not when the lists are executed. +.SH ERRORS +It is an error for indices to lie outside the range [_param2,\ _param3], +but implementations may not check for this situation. Such indices +cause implementation-dependent behavior. +.P +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param4 is negative. +.P +_const(INVALID_VALUE) is generated if _param3 $<$ _param2. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed between +the execution of _cmnd(Begin) and the corresponding _cmnd(End). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(MAX_ELEMENTS_VERTICES) +.P +_cmnd(Get) with argument _const(MAX_ELEMENTS_INDICES) +.SH SEE ALSO +_cmnd(ArrayElement), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(EdgeFlagPointer), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(NormalPointer), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/edgeflag.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/edgeflag.gl new file mode 100644 index 000000000..91c8ed4e1 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/edgeflag.gl @@ -0,0 +1,76 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(EdgeFlag,flag edges as either boundary or nonboundary) +_names(EdgeFlag) +.SH PARAMETERS +_phead(_param1) +Specifies the current edge flag value, +either _const(TRUE) or _const(FALSE). The initial value is _const(TRUE). +_names(EdgeFlagv) +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to an array that contains a single boolean element, +which replaces the current edge flag value. +.SH DESCRIPTION +Each vertex of a polygon, +separate triangle, +or separate quadrilateral specified between a _cmnd(Begin)/_cmnd(End) pair +is marked as the start of either a boundary or nonboundary edge. +If the current edge flag is true when the vertex is specified, +the vertex is marked as the start of a boundary edge. +Otherwise, the vertex is marked as the start of a nonboundary edge. +_cmnd sets the edge flag bit to _const(TRUE) if _param1 is _const(TRUE), +and to _const(FALSE) otherwise. +.P +The vertices of connected triangles and connected quadrilaterals are always +marked as boundary, +regardless of the value of the edge flag. +.P +Boundary and nonboundary edge flags on vertices are significant only if +_const(POLYGON_MODE) is set to _const(POINT) or _const(LINE). +See _cmnd(PolygonMode). +.SH NOTES +The current edge flag can be updated at any time. +In particular, +_cmnd can be called between a call to _cmnd(Begin) and the corresponding +call to _cmnd(End). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(EDGE_FLAG) +.SH SEE ALSO +_cmnd(Begin), +_cmnd(EdgeFlagPointer), +_cmnd(PolygonMode) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/edgeflagpointer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/edgeflagpointer.gl new file mode 100644 index 000000000..33ee881d0 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/edgeflagpointer.gl @@ -0,0 +1,122 @@ +_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_ Anything on a line after _C_ is ignored +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_C_ the function name must appear in (APIFILE) (usually gl.h) as set in +_C_ Makefile. +_header(EdgeFlagPointer,define an array of edge flags) +_names(EdgeFlagPointer) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the byte offset between consecutive edge flags. +If _param1 is 0 (the initial value), the edge flags are understood +to be tightly packed in the array. The initial value is 0. +_phead(_param2) +Specifies a pointer to the first edge flag in the array. The initial +value is zero. +.SH DESCRIPTION +_cmnd specifies the location and data format of an array of boolean edge +flags to use when rendering. _param1 specifies the byte stride from one +edge flag to the next allowing vertices and attributes +to be packed into a single array or stored in separate arrays. +(Single-array storage may be more efficient on some implementations; +see _cmnd(InterleavedArrays).) +.P +When an edge flag array is +specified, _param1 and _param2 are saved as client-side +state. +.P +To enable and disable the edge flag array, call _cmnd(EnableClientState) and +.br +_cmnd(DisableClientState) with +the argument _const(EDGE_FLAG_ARRAY). If enabled, the edge flag array is used +when _cmnd(DrawArrays), _cmnd(DrawElements), or _cmnd(ArrayElement) is called. +.P +Use _cmnd(DrawArrays) to construct a sequence of primitives (all of +the same type) +from prespecified vertex and vertex attribute arrays. +Use _cmnd(ArrayElement) to specify primitives +by indexing vertices and vertex attributes and _cmnd(DrawElements) to +construct a sequence of primitives by indexing vertices and vertex attributes. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +The edge flag array is initially disabled and it won't be accessed when +.br +_cmnd(ArrayElement), _cmnd(DrawElements) or _cmnd(DrawArrays) is called. +.P +Execution of _cmnd is not allowed between the execution of +_cmnd(Begin) and the corresponding execution of _cmnd(End), +but an error may or may not be generated. If no error is generated, +the operation is undefined. +.P +_cmnd is typically implemented on the client side. +.P +Edge flag array parameters are client-side state and are therefore +not saved or restored by _cmnd(PushAttrib) and _cmnd(PopAttrib). +Use _cmnd(PushClientAttrib) and +.br +_cmnd(PopClientAttrib) instead. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is negative. +.SH ASSOCIATED GETS +_cmnd(IsEnabled) with argument _const(EDGE_FLAG_ARRAY) +.br +_cmnd(Get) with argument _const(EDGE_FLAG_ARRAY_STRIDE) +.br +_cmnd(GetPointerv) with argument _const(EDGE_FLAG_ARRAY_POINTER) +.SH SEE ALSO +_cmnd(ArrayElement), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(Enable), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(NormalPointer), +_cmnd(PopClientAttrib), +.br +_cmnd(PushClientAttrib), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/enable.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/enable.gl new file mode 100644 index 000000000..763d92ab1 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/enable.gl @@ -0,0 +1,516 @@ +_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,eqn|tbl)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Enable, enable or disable server-side GL capabilities) +_names(Enable) +.SH PARAMETERS +_phead(_param1) +Specifies a symbolic constant indicating a GL capability. +_names(Disable) +.SH PARAMETERS +_phead(_param1) +Specifies a symbolic constant indicating a GL capability. +.SH DESCRIPTION +_cmnd and _cmnd(Disable) enable and disable various capabilities. +Use _cmnd(IsEnabled) or _cmnd(Get) to determine the current setting +of any capability. The initial value for each capability with the +exception of _const(DITHER) is _const(FALSE). The initial value for +_const(DITHER) is _const(TRUE). +.P +Both _cmnd(Enable) and _cmnd(Disable) take a single argument, _param1, +which can assume one of the following values: +.TP 25 +_const(ALPHA_TEST) +If enabled, +do alpha testing. See +_cmnd(AlphaFunc). +.TP +_const(AUTO_NORMAL) +If enabled, +generate normal vectors when either +_const(MAP2_VERTEX_3) or +_const(MAP2_VERTEX_4) is used to generate vertices. +See _cmnd(Map2). +.TP +_const(BLEND) +If enabled, +blend the incoming RGBA color values with the values in the color +buffers. See _cmnd(BlendFunc). +.TP +_const(CLIP_PLANE)\f2i\fP +If enabled, +clip geometry against user-defined clipping plane \f2i\fP. +See _cmnd(ClipPlane). +.TP +_const(COLOR_LOGIC_OP) +If enabled, +apply the currently selected logical operation to the incoming RGBA +color and color buffer values. See _cmnd(LogicOp). +.TP +_const(COLOR_MATERIAL) +If enabled, +have one or more material parameters track the current color. +See _cmnd(ColorMaterial). +.TP +_const(COLOR_TABLE) +If enabled, +preform a color table lookup on the incoming RGBA color values. +See _cmnd(ColorTable). +.TP +_const(CONVOLUTION_1D) +If enabled, +perform a 1D convolution operation on incoming RGBA color values. +See _cmnd(ConvolutionFilter1D). +.TP +_const(CONVOLUTION_2D) +If enabled, +perform a 2D convolution operation on incoming RGBA color values. +See _cmnd(ConvolutionFilter2D). +.TP +_const(CULL_FACE) +If enabled, +cull polygons based on their winding in window coordinates. +See _cmnd(CullFace). +.TP +_const(DEPTH_TEST) +If enabled, +do depth comparisons and update the depth buffer. Note that even if +the depth buffer exists and the depth mask is non-zero, the +depth buffer is not updated if the depth test is disabled. See +_cmnd(DepthFunc) and +.br +_cmnd(DepthRange). +.TP +_const(DITHER) +If enabled, +dither color components or indices before they are written to the +color buffer. +.TP +_const(FOG) +If enabled, +blend a fog color into the posttexturing color. +See _cmnd(Fog). +.TP +_const(HISTOGRAM) +If enabled, +histogram incoming RGBA color values. +See _cmnd(Histogram). +.TP +_const(INDEX_LOGIC_OP) +If enabled, +apply the currently selected logical operation to the incoming index and color +buffer indices. See +.br +_cmnd(LogicOp). +.TP +_const(LIGHT)\f2i\fP +If enabled, +include light \f2i\fP in the evaluation of the lighting +equation. See _cmnd(LightModel) and _cmnd(Light). +.TP +_const(LIGHTING) +If enabled, +use the current lighting parameters to compute the vertex color or index. +Otherwise, simply associate the current color or index with each +vertex. See +.br +_cmnd(Material), _cmnd(LightModel), and _cmnd(Light). +.TP +_const(LINE_SMOOTH) +If enabled, +draw lines with correct filtering. +Otherwise, +draw aliased lines. +See _cmnd(LineWidth). +.TP +_const(LINE_STIPPLE) +If enabled, +use the current line stipple pattern when drawing lines. See +_cmnd(LineStipple). +.TP +_const(MAP1_COLOR_4) +If enabled, +calls to +_cmnd(EvalCoord1), +_cmnd(EvalMesh1), and +_cmnd(EvalPoint1) generate RGBA values. +See _cmnd(Map1). +.TP +_const(MAP1_INDEX) +If enabled, +calls to +_cmnd(EvalCoord1), +_cmnd(EvalMesh1), and +_cmnd(EvalPoint1) generate color indices. +See _cmnd(Map1). +.TP +_const(MAP1_NORMAL) +If enabled, +calls to +_cmnd(EvalCoord1), +_cmnd(EvalMesh1), and +_cmnd(EvalPoint1) generate normals. +See _cmnd(Map1). +.TP +_const(MAP1_TEXTURE_COORD_1) +If enabled, +calls to +_cmnd(EvalCoord1), +_cmnd(EvalMesh1), and +_cmnd(EvalPoint1) generate +\f2s\fP +texture coordinates. +See _cmnd(Map1). +.TP +_const(MAP1_TEXTURE_COORD_2) +If enabled, +calls to +_cmnd(EvalCoord1), +_cmnd(EvalMesh1), and +_cmnd(EvalPoint1) generate +\f2s\fP and +\f2t\fP texture coordinates. +See _cmnd(Map1). +.TP +_const(MAP1_TEXTURE_COORD_3) +If enabled, +calls to +_cmnd(EvalCoord1), +_cmnd(EvalMesh1), and +_cmnd(EvalPoint1) generate +\f2s\fP, +\f2t\fP, and +\f2r\fP texture coordinates. +See _cmnd(Map1). +.TP +_const(MAP1_TEXTURE_COORD_4) +If enabled, +calls to +_cmnd(EvalCoord1), +_cmnd(EvalMesh1), and +_cmnd(EvalPoint1) generate +\f2s\fP, +\f2t\fP, +\f2r\fP, and +\f2q\fP texture coordinates. +See _cmnd(Map1). +.TP +_const(MAP1_VERTEX_3) +If enabled, +calls to +_cmnd(EvalCoord1), +_cmnd(EvalMesh1), and +_cmnd(EvalPoint1) generate +\f2x\fP, \f2y\fP, and \f2z\fP vertex coordinates. +See _cmnd(Map1). +.TP +_const(MAP1_VERTEX_4) +If enabled, +calls to +_cmnd(EvalCoord1), +_cmnd(EvalMesh1), and +_cmnd(EvalPoint1) generate +homogeneous +\f2x\fP, +\f2y\fP, +\f2z\fP, and +\f2w\fP vertex coordinates. +See _cmnd(Map1). +.TP +_const(MAP2_COLOR_4) +If enabled, +calls to +_cmnd(EvalCoord2), +_cmnd(EvalMesh2), and +_cmnd(EvalPoint2) generate RGBA values. +See _cmnd(Map2). +.TP +_const(MAP2_INDEX) +If enabled, +calls to +_cmnd(EvalCoord2), +_cmnd(EvalMesh2), and +_cmnd(EvalPoint2) generate color indices. +See _cmnd(Map2). +.TP +_const(MAP2_NORMAL) +If enabled, +calls to +_cmnd(EvalCoord2), +_cmnd(EvalMesh2), and +_cmnd(EvalPoint2) generate normals. +See _cmnd(Map2). +.TP +_const(MAP2_TEXTURE_COORD_1) +If enabled, +calls to +_cmnd(EvalCoord2), +_cmnd(EvalMesh2), and +_cmnd(EvalPoint2) generate +\f2s\fP +texture coordinates. +See _cmnd(Map2). +.TP +_const(MAP2_TEXTURE_COORD_2) +If enabled, +calls to +_cmnd(EvalCoord2), +_cmnd(EvalMesh2), and +_cmnd(EvalPoint2) generate +\f2s\fP and +\f2t\fP texture coordinates. +See _cmnd(Map2). +.TP +_const(MAP2_TEXTURE_COORD_3) +If enabled, +calls to +_cmnd(EvalCoord2), +_cmnd(EvalMesh2), and +_cmnd(EvalPoint2) generate +\f2s\fP, +\f2t\fP, and +\f2r\fP texture coordinates. +See _cmnd(Map2). +.TP +_const(MAP2_TEXTURE_COORD_4) +If enabled, +calls to +_cmnd(EvalCoord2), +_cmnd(EvalMesh2), and +_cmnd(EvalPoint2) generate +\f2s\fP, +\f2t\fP, +\f2r\fP, and +\f2q\fP texture coordinates. +See _cmnd(Map2). +.TP +_const(MAP2_VERTEX_3) +If enabled, +calls to +_cmnd(EvalCoord2), +_cmnd(EvalMesh2), and +_cmnd(EvalPoint2) generate +\f2x\fP, \f2y\fP, and \f2z\fP vertex coordinates. +See _cmnd(Map2). +.TP +_const(MAP2_VERTEX_4) +If enabled, +calls to +_cmnd(EvalCoord2), +_cmnd(EvalMesh2), and +_cmnd(EvalPoint2) generate +homogeneous +\f2x\fP, +\f2y\fP, +\f2z\fP, and +\f2w\fP vertex coordinates. +See _cmnd(Map2). +.TP +_const(MINMAX) +If enabled, +compute the minimum and maximum values of incoming RGBA color values. +See _cmnd(Minmax). +.TP +_const(NORMALIZE) +If enabled, +normal vectors specified with _cmnd(Normal) are scaled to unit length +after transformation. See _cmnd(Normal). +.TP +_const(POINT_SMOOTH) +If enabled, +draw points with proper filtering. +Otherwise, +draw aliased points. +See _cmnd(PointSize). +.TP +_const(POLYGON_OFFSET_FILL) +If enabled, and if the polygon is rendered in +_const(FILL) mode, an offset is added to depth values of a polygon's +fragments before the depth comparison is performed. +See _cmnd(PolygonOffset). +.TP +_const(POLYGON_OFFSET_LINE) +If enabled, and if the polygon is rendered in +_const(LINE) mode, an offset is added to depth values of a polygon's +fragments before the depth comparison is performed. See _cmnd(PolygonOffset). +.TP +_const(POLYGON_OFFSET_POINT) +If enabled, an offset is added to depth values of a polygon's fragments +before the depth comparison is performed, if the polygon is rendered in +_const(POINT) mode. See _cmnd(PolygonOffset). +.TP +_const(POLYGON_SMOOTH) +If enabled, draw polygons with proper filtering. +Otherwise, draw aliased polygons. For correct anti-aliased polygons, +an alpha buffer is needed and the polygons must be sorted front to +back. +.TP +_const(POLYGON_STIPPLE) +If enabled, +use the current polygon stipple pattern when rendering +polygons. See _cmnd(PolygonStipple). +.TP +_const(POST_COLOR_MATRIX_COLOR_TABLE) +If enabled, +preform a color table lookup on RGBA color values after color matrix +transformation. +See _cmnd(ColorTable). +.TP +_const(POST_CONVOLUTION_COLOR_TABLE) +If enabled, +preform a color table lookup on RGBA color values after convolution. +See _cmnd(ColorTable). +.TP +_const(RESCALE_NORMAL) +If enabled, normal vectors specified with _cmnd(Normal) are scaled to +unit length after transformation. See _cmnd(Normal). +.TP +_const(SEPARABLE_2D) +If enabled, perform a two-dimensional convolution operation using a separable +convolution filter on incoming RGBA color values. +See _cmnd(SeparableFilter2D). +.TP +_const(SCISSOR_TEST) +If enabled, +discard fragments that are outside the scissor rectangle. +See _cmnd(Scissor). +.TP +_const(STENCIL_TEST) +If enabled, +do stencil testing and update the stencil buffer. +See _cmnd(StencilFunc) and _cmnd(StencilOp). +.TP +_const(TEXTURE_1D) +If enabled, one-dimensional texturing is performed +(unless two- or three-dimensional texturing is also enabled). +See _cmnd(TexImage1D). +.TP +_const(TEXTURE_2D) +If enabled, two-dimensional texturing is performed +(unless three-dimensional texturing is also enabled). See _cmnd(TexImage2D). +.TP +_const(TEXTURE_3D) +If enabled, three-dimensional texturing is performed. See _cmnd(TexImage3D). +.TP +_const(TEXTURE_GEN_Q) +If enabled, +the \f2q\fP texture coordinate is computed using +the texture generation function defined with _cmnd(TexGen). +Otherwise, the current \f2q\fP texture coordinate is used. +See _cmnd(TexGen). +.TP +_const(TEXTURE_GEN_R) +If enabled, +the \f2r\fP texture coordinate is computed using +the texture generation function defined with _cmnd(TexGen). +Otherwise, the current \f2r\fP texture coordinate is used. +See _cmnd(TexGen). +.TP +_const(TEXTURE_GEN_S) +If enabled, +the \f2s\fP texture coordinate is computed using +the texture generation function defined with _cmnd(TexGen). +Otherwise, the current \f2s\fP texture coordinate is used. +See _cmnd(TexGen). +.TP +_const(TEXTURE_GEN_T) +If enabled, +the \f2t\fP texture coordinate is computed using +the texture generation function defined with _cmnd(TexGen). +Otherwise, the current \f2t\fP texture coordinate is used. +See _cmnd(TexGen). +.SH NOTES +_const(POLYGON_OFFSET_FILL), _const(POLYGON_OFFSET_LINE), +_const(POLYGON_OFFSET_POINT), +_const(COLOR_LOGIC_OP), and _const(INDEX_LOGIC_OP) are available +only if the GL version is 1.1 or greater. +.P +_const(RESCALE_NORMAL), and _const(TEXTURE_3D) are available only if the +GL version is 1.2 or greater. +.P +_const(COLOR_TABLE), _const(CONVOLUTION_1D), _const(CONVOLUTION_2D), +_const(HISTOGRAM), _const(MINMAX), +_const(POST_COLOR_MATRIX_COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), and +_const(SEPARABLE_2D) are available only if _arbstring(imaging) is returned +from _cmnd(Get) with an argument of _const(EXTENSIONS). +.P +If _arbstring(multitexture) is supported, _const(TEXTURE_1D), +_const(TEXTURE_2D), _const(TEXTURE_3D), _const(TEXTURE_GEN_S), +_const(TEXTURE_GEN_T), _const(TEXTURE_GEN_R), and _const(TEXTURE_GEN_Q) +enable or disable the respective state for the active texture unit +specified with _cmnd(ActiveTextureARB). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of the values +listed previously. +.P +_const(INVALID_OPERATION) is generated if _cmnd(Enable) or _cmnd(Disable) +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(AlphaFunc), +_cmnd(BlendFunc), +_cmnd(ClipPlane), +_cmnd(ColorMaterial), +_cmnd(CullFace), +_cmnd(DepthFunc), +_cmnd(DepthRange), +_cmnd(EnableClientState), +_cmnd(Fog), +_cmnd(Get), +_cmnd(IsEnabled), +_cmnd(Light), +_cmnd(LightModel), +_cmnd(LineWidth), +_cmnd(LineStipple), +_cmnd(LogicOp), +_cmnd(Map1), +_cmnd(Map2), +_cmnd(Material), +_cmnd(Normal), +_cmnd(PointSize), +_cmnd(PolygonMode), +_cmnd(PolygonOffset), +_cmnd(PolygonStipple), +_cmnd(Scissor), +_cmnd(StencilFunc), +_cmnd(StencilOp), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/enableclientstate.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/enableclientstate.gl new file mode 100644 index 000000000..a710edbea --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/enableclientstate.gl @@ -0,0 +1,134 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_header(EnableClientState, enable or disable client-side capability) +_names(EnableClientState) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the capability to enable. +Symbolic constants +_const(COLOR_ARRAY), +_const(EDGE_FLAG_ARRAY), +_const(INDEX_ARRAY), +_const(NORMAL_ARRAY), +_const(TEXTURE_COORD_ARRAY), and +_const(VERTEX_ARRAY) +are accepted. +_names(DisableClientState) +.SH PARAMETERS +_phead(_param1) +Specifies the capability to disable. +.SH DESCRIPTION +_cmnd and _cmnd(DisableClientState) +enable or disable individual client-side capabilities. By default, all +client-side capabilities are disabled. +Both +_cmnd(EnableClientState) and _cmnd(DisableClientState) take a +single argument, _param1, which can assume one of the following +values: +.TP 25 +_const(COLOR_ARRAY) +If enabled, the color array is enabled for writing and used during +rendering when _cmnd(ArrayElement), _cmnd(DrawArrays), +_cmnd(DrawElement), or _cmnd(DrawRangeElements) is called. See +_cmnd(ColorPointer). +.TP +_const(EDGE_FLAG_ARRAY) +If enabled, the edge flag array is enabled for writing and used during +rendering when _cmnd(ArrayElement), _cmnd(DrawArrays), +_cmnd(DrawElement), or _cmnd(DrawRangeElements) is called. See +_cmnd(EdgeFlagPointer). +.TP +_const(INDEX_ARRAY) +If enabled, the index array is enabled for writing and used during +rendering when _cmnd(ArrayElement), _cmnd(DrawArrays), +_cmnd(DrawElement), or _cmnd(DrawRangeElements) is called. See +_cmnd(IndexPointer). +.TP +_const(NORMAL_ARRAY) +If enabled, the normal array is enabled for writing and used during +rendering when _cmnd(ArrayElement), _cmnd(DrawArrays), +_cmnd(DrawElement), or _cmnd(DrawRangeElements) is called. See +_cmnd(NormalPointer). +.TP +_const(TEXTURE_COORD_ARRAY) +If enabled, the texture coordinate array is enabled for writing and used during +rendering when _cmnd(ArrayElement), _cmnd(DrawArrays), +_cmnd(DrawElement), or _cmnd(DrawRangeElements) is called. See +_cmnd(TexCoordPointer). +.TP +_const(VERTEX_ARRAY) +If enabled, the vertex array is enabled for writing and used during +rendering when _cmnd(ArrayElement), _cmnd(DrawArrays), +_cmnd(DrawElement), or _cmnd(DrawRangeElements) is called. See +_cmnd(VertexPointer). +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +If _arbstring(multitexture) is supported, enabling and disabling +_const(TEXTURE_COORD_ARRAY) affects the active client texture unit. +The active client texture unit is controlled with +_cmnd(ClientActiveTextureARB). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_cmnd is not allowed between the execution of _cmnd(Begin) and the +corresponding _cmnd(End), but an error may or may not be generated. If +no error is generated, the behavior is undefined. +.SH SEE ALSO +_cmnd(ArrayElement), +_cmnd(ClientActiveTextureARB), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(EdgeFlagPointer), +_cmnd(Enable), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(NormalPointer), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) 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) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalmesh.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalmesh.gl new file mode 100644 index 000000000..a5b363814 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalmesh.gl @@ -0,0 +1,189 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(EvalMesh, compute a one- or two-dimensional grid of points or lines) +_names(EvalMesh1) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +In _cmnd(EvalMesh1), specifies whether to compute a one-dimensional mesh of points or lines. +Symbolic constants +_const(POINT) and +_const(LINE) are accepted. +_phead(_param2 _param3) +Specify the first and last integer values for grid domain variable $i$. +_names(EvalMesh2) +.SH PARAMETERS +_phead(_param1) +In _cmnd(EvalMesh2), specifies whether to compute a two-dimensional mesh of points, lines, +or polygons. +Symbolic constants +_const(POINT), +_const(LINE), and +_const(FILL) are accepted. +_phead(_param2 _param3) +Specify the first and last integer values for grid domain variable $i$. +_phead(_param4 _param5) +Specify the first and last integer values for grid domain variable $j$. +.SH DESCRIPTION +_cmnd(MapGrid) and _cmnd are used in tandem to efficiently +generate and evaluate a series of evenly-spaced map domain values. +_cmnd steps through the integer domain of a one- or two-dimensional grid, +whose range is the domain of the evaluation maps specified by +_cmnd(Map1) and _cmnd(Map2). +_param1(1) determines whether the resulting vertices are connected as +points, +lines, +or filled polygons. +.P +In the one-dimensional case, +_cmnd(EvalMesh1), +the mesh is generated as if the following code fragment were executed: +.nf +.IP +\f7 +glBegin( \f2type\f7 ); +for ( i = _param2; i <= _param3; i += 1 ) + glEvalCoord1( i$^cdot^DELTA u ~+~ u sub 1$ ); +glEnd(); +\fP +.RE +.fi +where +.sp +.in +$ DELTA u ~=~ (u sub 2 ~-~ u sub 1 ) ^/^ n$ +.sp +.in 0 +.P +and $n$, $u sub 1$, and $u sub 2$ are the arguments to the most recent +_cmnd(MapGrid1) command. +\f2type\fP is _const(POINTS) if _param1(1) is _const(POINT), +or _const(LINES) if _param1(1) is _const(LINE). +.P +The one absolute numeric requirement is that if $i ~=~ n$, then the +value computed from $ i^cdot^DELTA u ~+~ u sub 1$ is exactly $u sub 2$. +.P +In the two-dimensional case, _cmnd(EvalMesh2), let +.nf +.IP +$ DELTA u ~=~ mark ( u sub 2 ~-~ u sub 1 ) ^/^ n$ +.sp +$ DELTA v ~=~ lineup ( v sub 2 ~-~ v sub 1 ) ^/^ m$, +.fi +.RE +.P +where $n$, $u sub 1$, $u sub 2$, $m$, $v sub 1$, and $v sub 2$ are the +arguments to the most recent _cmnd(MapGrid2) command. Then, if +_param1(2) is _const(FILL), the _cmnd(EvalMesh2) command is equivalent +to: +.nf +.IP +\f7 +for ( j = _param4; j < _param5; j += 1 ) { + glBegin( GL_QUAD_STRIP ); + for ( i = _param2; i <= _param3; i += 1 ) { + glEvalCoord2( i$^cdot^DELTA u ~+~ u sub 1$, j$^cdot^DELTA v ~+~ v sub 1$ ); + glEvalCoord2( i$^cdot^DELTA u ~+~ u sub 1$, (j+1)$^cdot^DELTA v ~+~ v sub 1$ ); + } + glEnd(); +} +\fP +.RE +.fi +.P +If _param1 is _const(LINE), then a call to _cmnd(EvalMesh2) is equivalent to: +.nf +.IP +\f7 +for ( j = _param4; j <= _param5; j += 1 ) { + glBegin( GL_LINE_STRIP ); + for ( i = _param2; i <= _param3; i += 1 ) + glEvalCoord2( i$^cdot^DELTA u ~+~ u sub 1$, j$^cdot^DELTA v ~+~ v sub 1$ ); + glEnd(); +} +.sp +for ( i = _param2; i <= _param3; i += 1 ) { + glBegin( GL_LINE_STRIP ); + for ( j = _param4; j <= _param4; j += 1 ) + glEvalCoord2( i$^cdot^DELTA u ~+~ u sub 1$, j$^cdot^DELTA v ~+~ v sub 1 $ ); + glEnd(); +} +\fP +.RE +.fi +.P +And finally, if _param1 is _const(POINT), then a call to +_cmnd(EvalMesh2) is equivalent to: +.nf +.IP +\f7 +glBegin( GL_POINTS ); +for ( j = _param4; j <= _param5; j += 1 ) + for ( i = _param2; i <= _param3; i += 1 ) + glEvalCoord2( i$^cdot^DELTA u ~+~ u sub 1$, j$^cdot^DELTA v ~+~ v sub 1$ ); +glEnd(); +\fP +.RE +.fi +.P +In all three cases, the only absolute numeric requirements are that if $i~=~n$, +then the value computed from $i^cdot^DELTA u ~+~ u sub 1$ is exactly $u +sub 2$, and if $j~=~m$, then the value computed from +$j ^cdot^ DELTA v ~+~ v sub 1$ is exactly $v sub 2$. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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(Get) with argument _const(MAP1_GRID_DOMAIN) +.br +_cmnd(Get) with argument _const(MAP2_GRID_DOMAIN) +.br +_cmnd(Get) with argument _const(MAP1_GRID_SEGMENTS) +.br +_cmnd(Get) with argument _const(MAP2_GRID_SEGMENTS) +.SH SEE ALSO +_cmnd(Begin), +_cmnd(EvalCoord), +_cmnd(EvalPoint), +_cmnd(Map1), +_cmnd(Map2), +_cmnd(MapGrid) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalpoint.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalpoint.gl new file mode 100644 index 000000000..34dcb717c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/evalpoint.gl @@ -0,0 +1,111 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(EvalPoint,generate and evaluate a single point in a mesh) +_names(EvalPoint,[12]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the integer value for grid domain variable $i$. +_phead(_param2) +Specifies the integer value for grid domain variable $j$ +(_cmnd(EvalPoint2) only). +.SH DESCRIPTION +_cmnd(MapGrid) and _cmnd(EvalMesh) are used in tandem to efficiently +generate and evaluate a series of evenly spaced map domain values. +_cmnd can be used to evaluate a single grid point in the same gridspace +that is traversed by _cmnd(EvalMesh). +Calling _cmnd(EvalPoint1) is equivalent to calling +.nf +.IP +\f7 +glEvalCoord1( i$^cdot^DELTA u ~+~ u sub 1$ ); +\fP +.RE +.fi +where +.sp +.in +$DELTA u ~=~ ( u sub 2 - u sub 1 ) ^/^ n$ +.in 0 +.sp +.P +and $n$, $u sub 1$, and $u sub 2$ +are the arguments to the most recent _cmnd(MapGrid1) command. +The one absolute numeric requirement is that if $i~=~n$, +then the value computed from +$i ^cdot^ DELTA u ~+~ u sub 1$ is exactly $u sub 2$. +.P +In the two-dimensional case, _cmnd(EvalPoint2), let +.nf +.IP +$DELTA u ~=~ mark ( u sub 2 - u sub 1 ) ^/^ n$ +.sp +$DELTA v ~=~ mark ( v sub 2 - v sub 1 ) ^/^ m,$ +.RE +.fi +.P +where $n$, $u sub 1$, $u sub 2$, $m$, $v sub 1$, and $v sub 2$ +are the arguments to the most recent _cmnd(MapGrid2) command. +Then the _cmnd(EvalPoint2) command is equivalent to calling +.nf +.IP +\f7 +glEvalCoord2( i$^cdot^DELTA u ~+~ u sub 1$, j$^cdot^DELTA v ~+~ v sub 1$ ); +\fP +.RE +.fi +The only absolute numeric requirements are that if $i~=~n$, +then the value computed from +$i ^cdot^DELTA u ~+~ u sub 1$ is exactly $u sub 2$, +and if $j~=~m$, then the value computed from +$i ^cdot^DELTA v ~+~ v sub 1$ is exactly $v sub 2$. +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(MAP1_GRID_DOMAIN) +.br +_cmnd(Get) with argument _const(MAP2_GRID_DOMAIN) +.br +_cmnd(Get) with argument _const(MAP1_GRID_SEGMENTS) +.br +_cmnd(Get) with argument _const(MAP2_GRID_SEGMENTS) +.SH SEE ALSO +_cmnd(EvalCoord), +_cmnd(EvalMesh), +_cmnd(Map1), +_cmnd(Map2), +_cmnd(MapGrid) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/feedbackbuffer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/feedbackbuffer.gl new file mode 100644 index 000000000..5d32f36df --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/feedbackbuffer.gl @@ -0,0 +1,237 @@ +_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(FeedbackBuffer,controls feedback mode) +_names(FeedbackBuffer) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the maximum number of values that can be written into _param3. +_phead(_param2) +Specifies a symbolic constant that describes the information +that will be returned for each vertex. +_const(2D), +_const(3D), +_const(3D_COLOR), +_const(3D_COLOR_TEXTURE), and +_const(4D_COLOR_TEXTURE) are accepted. +_phead(_param3) +Returns the feedback data. +.SH DESCRIPTION +The _cmnd function controls feedback. +Feedback, like selection, is a GL mode. +The mode is selected by calling +_cmnd(RenderMode) with _const(FEEDBACK). +When the GL is in feedback mode, +no pixels are produced by rasterization. +Instead, information about primitives that would have been +rasterized is fed back to the application using the GL. +.P +_cmnd has three arguments: +_param3 is a pointer to an array of floating-point values +into which feedback information is placed. +_param1 indicates the size of the array. +_param2 is a symbolic constant describing the information +that is fed back for each vertex. +_cmnd must be issued before feedback mode is enabled +(by calling _cmnd(RenderMode) with argument _const(FEEDBACK)). +Setting _const(FEEDBACK) without establishing the feedback buffer, +or calling _cmnd while the GL is in feedback mode, +is an error. +.P +When _cmnd(RenderMode) is called while in feedback mode, it returns the number of entries +placed in the feedback array, and resets the feedback array pointer to the base +of the feedback buffer. The returned value never exceeds _param1. If the feedback +data required more room than was available in _param3, +_cmnd(RenderMode) returns a negative value. +To take the GL out of feedback mode, call +_cmnd(RenderMode) with a parameter value other than _const(FEEDBACK). +.P +While in feedback mode, +each primitive, bitmap, or pixel rectangle that would be rasterized +generates a block of values that are copied into the feedback array. +If doing so would cause the number of entries to exceed the maximum, +the block is partially written so as to fill the array +(if there is any room left at all), +and an overflow flag is set. +Each block begins with a code indicating the primitive type, +followed by values that describe the primitive's vertices and +associated data. +Entries are also written for bitmaps and pixel rectangles. +Feedback occurs after polygon culling and _cmnd(PolygonMode) interpretation +of polygons has taken place, +so polygons that are culled are not returned in the feedback buffer. +It can also occur after polygons with more than three edges are broken up +into triangles, +if the GL implementation renders polygons by performing this decomposition. +.P +The _cmnd(PassThrough) command can be used to insert a marker +into the feedback buffer. +See _cmnd(PassThrough). +.P +Following is the grammar for the blocks of values written +into the feedback buffer. +Each primitive is indicated with a unique identifying value +followed by some number of vertices. +Polygon entries include an integer value indicating how many vertices follow. +A vertex is fed back as some number of floating-point values, +as determined by _param2. +Colors are fed back as four values in RGBA mode and one value +in color index mode. +.RS +.na +.sp +feedbackList \(<- feedbackItem feedbackList | feedbackItem +.sp +feedbackItem \(<- point | lineSegment | polygon | bitmap | pixelRectangle | passThru +.sp +point \(<- _const(POINT_TOKEN) vertex +.sp +lineSegment \(<- _const(LINE_TOKEN) vertex vertex | _const(LINE_RESET_TOKEN) vertex vertex +.sp +polygon \(<- _const(POLYGON_TOKEN) n polySpec +.sp +polySpec \(<- polySpec vertex | vertex vertex vertex +.sp +bitmap \(<- _const(BITMAP_TOKEN) vertex +.sp +pixelRectangle \(<- _const(DRAW_PIXEL_TOKEN) vertex | _const(COPY_PIXEL_TOKEN) vertex +.sp +passThru \(<- _const(PASS_THROUGH_TOKEN) value +.sp +vertex \(<- 2d | 3d | 3dColor | 3dColorTexture | 4dColorTexture +.sp +2d \(<- value value +.sp +3d \(<- value value value +.sp +3dColor \(<- value value value color +.sp +3dColorTexture \(<- value value value color tex +.sp +4dColorTexture \(<- value value value value color tex +.sp +color \(<- rgba | index +.sp +rgba \(<- value value value value +.sp +index \(<- value +.sp +tex \(<- value value value value +.sp +.RE +.P +.I value +is a floating-point number, +and +.I n +is a floating-point integer giving the number of vertices in the polygon. +_const(POINT_TOKEN), +_const(LINE_TOKEN), +_const(LINE_RESET_TOKEN), +_const(POLYGON_TOKEN), +_const(BITMAP_TOKEN), +_const(DRAW_PIXEL_TOKEN), +_const(COPY_PIXEL_TOKEN) and +_const(PASS_THROUGH_TOKEN) are symbolic floating-point constants. +_const(LINE_RESET_TOKEN) is returned whenever the line stipple pattern +is reset. +The data returned as a vertex depends on the feedback _param2. +.P +The following table gives the correspondence between _param2 +and the number of values per vertex. +\f2k\fP is 1 in color index mode and 4 in RGBA mode. +.sp +.ne +.TS +center tab(:); +lb lb cb cb cb +l l c c c. +_ +Type:Coordinates:Color:Texture:Total Number of Values +_ +_const(2D):\f2x\fP, \f2y\fP:::2 +_const(3D):\f2x\fP, \f2y\fP, \f2z\fP:::3 +_const(3D_COLOR):\f2x\fP, \f2y\fP, \f2z\fP:$k$::$3 ~+~ k$ +_const(3D_COLOR_TEXTURE):\f2x\fP, \f2y\fP, \f2z\fP,:$k$:4:$7 ~+~ k$ +_const(4D_COLOR_TEXTURE):\f2x\fP, \f2y\fP, \f2z\fP, \f2w\fP:$k$:4:$8 ~+~ k$ +_ +.TE + +.P +Feedback vertex coordinates are in window coordinates, +except \f2w\fP, +which is in clip coordinates. +Feedback colors are lighted, if lighting is enabled. +Feedback texture coordinates are generated, +if texture coordinate generation is enabled. +They are always transformed by the texture matrix. +.SH NOTES +_cmnd, when used in a display list, is not compiled into the display list +but is executed immediately. +.P +When the _arbstring(multitexture) extension is supported, _cmnd +returns only the texture coordinates of texture unit _arbconst(TEXTURE0). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param2 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param1 is negative. +.P +_const(INVALID_OPERATION) is generated if _cmnd is called while the +render mode is _const(FEEDBACK), +or if _cmnd(RenderMode) is called with argument _const(FEEDBACK) before +_cmnd is called at least once. +.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(Get) with argument _const(RENDER_MODE) +.br +_cmnd(Get) with argument _const(FEEDBACK_BUFFER_POINTER) +.br +_cmnd(Get) with argument _const(FEEDBACK_BUFFER_SIZE) +.br +_cmnd(Get) with argument _const(FEEDBACK_BUFFER_TYPE) +.SH SEE ALSO +_cmnd(Begin), +_cmnd(LineStipple), +_cmnd(PassThrough), +_cmnd(PolygonMode), +_cmnd(RenderMode), +_cmnd(SelectBuffer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/finish.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/finish.gl new file mode 100644 index 000000000..a10d3eddf --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/finish.gl @@ -0,0 +1,53 @@ +_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(Finish,block until all GL execution is complete) +_names(Finish) +.SH DESCRIPTION +_cmnd does not return until the effects of all previously +called GL commands are complete. +Such effects include all changes to GL state, +all changes to connection state, +and all changes to the frame buffer contents. +.SH NOTES +_cmnd requires a round trip to the server. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd is executed between +the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(Flush) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/flush.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/flush.gl new file mode 100644 index 000000000..357f1b50e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/flush.gl @@ -0,0 +1,65 @@ +_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(Flush,force execution of GL commands in finite time) +_names(Flush) +.SH DESCRIPTION +Different GL implementations buffer commands in several different locations, +including network buffers and the graphics accelerator itself. +_cmnd empties all of these buffers, +causing all issued commands to be executed as quickly as +they are accepted by the actual rendering engine. +Though this execution may not be completed in any particular +time period, +it does complete in finite time. +.P +Because any GL program might be executed over a network, +or on an accelerator that buffers commands, +all programs should call _cmnd whenever they count on having +all of their previously issued commands completed. +For example, +call _cmnd before waiting for user input that depends on +the generated image. +.SH NOTES +_cmnd can return at any time. +It does not wait until the execution of all previously +issued GL commands is complete. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(Finish) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/fog.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/fog.gl new file mode 100644 index 000000000..a6f4ff44e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/fog.gl @@ -0,0 +1,202 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Fog,specify fog parameters) +_names(Fog,[fi]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a single-valued fog parameter. +_const(FOG_MODE), +_const(FOG_DENSITY), +_const(FOG_START), +_const(FOG_END), +and +_const(FOG_INDEX) +are accepted. +_phead(_param2) +Specifies the value that _param1 will be set to. +_names(Fog,[fi]v) +.SH PARAMETERS +_phead(_param1) +Specifies a fog parameter. +_const(FOG_MODE), +_const(FOG_DENSITY), +_const(FOG_START), +_const(FOG_END), +_const(FOG_INDEX), +and +_const(FOG_COLOR) +are accepted. +_phead(_param2) +Specifies the value or values to be assigned to _param1. +_const(FOG_COLOR) requires an array of four values. +All other parameters accept an array containing only a single value. +.SH DESCRIPTION +Fog is initially disabled. +While enabled, fog affects rasterized geometry, +bitmaps, and pixel blocks, but not buffer clear operations. To enable +and disable fog, call _cmnd(Enable) and _cmnd(Disable) with argument +_const(FOG). +.P +_cmnd assigns the value or values in _param2 to the fog parameter +specified by _param1. +The following values are accepted for _param1: +.TP 20 +_const(FOG_MODE) +_param2 is a single integer or floating-point value that specifies +the equation to be used to compute the fog blend factor, $f$. +Three symbolic constants are accepted: +_const(LINEAR), +_const(EXP), +and _const(EXP2). +The equations corresponding to these symbolic constants are defined below. +The initial fog mode is _const(EXP). +.TP +_const(FOG_DENSITY) +_param2 is a single integer or floating-point value that specifies $density$, +the fog density used in both exponential fog equations. +Only nonnegative densities are accepted. +The initial fog density is 1. +.TP +_const(FOG_START) +_param2 is a single integer or floating-point value that specifies $start$, +the near distance used in the linear fog equation. +The initial near distance is 0. +.TP +_const(FOG_END) +_param2 is a single integer or floating-point value that specifies $end$, +the far distance used in the linear fog equation. +The initial far distance is 1. +.TP +_const(FOG_INDEX) +_param2 is a single integer or floating-point value that specifies +$i sub f$, +the fog color index. +The initial fog index is 0. +.TP +_const(FOG_COLOR) +_param2 contains four integer or floating-point values that specify +$C sub f$, the fog color. +Integer values are mapped linearly such that the most positive representable +value maps to 1.0, +and the most negative representable value maps to \-1.0. +Floating-point values are mapped directly. +After conversion, +all color components are clamped to the range [0,1]. +The initial fog color is (0, 0, 0, 0). +.P +Fog blends a fog color with each rasterized pixel fragment's posttexturing +color using a blending factor $f$. +Factor $f$ is computed in one of three ways, +depending on the fog mode. +Let $z$ be the distance in eye coordinates from the origin to the fragment +being fogged. +The equation for _const(LINEAR) fog is +.ce + +.EQ +f ~=~ {end ~-~ z} over {end ~-~ start} +.EN + +.RE +.P +The equation for _const(EXP) fog is +.ce + +.EQ +f ~=~ e sup {-^(density ~cdot~ z)} +.EN + +.P +The equation for _const(EXP2) fog is +.ce + +.EQ +f ~=~ e sup {-^(density ~cdot~ z)} sup 2 +.EN + +.P +Regardless of the fog mode, +$f$ is clamped to the range [0,\ 1] after it is computed. +Then, +if the GL is in RGBA color mode, +the fragment's red, green, and blue colors, represented by $C sub r$, +are replaced by +.sp +.ce +.EQ +{C sub r} sup prime ~=~ f^C sub r ~+~ (1 - f)^C sub f +.EN + +.sp +Fog does not affect a fragment's alpha component. +.P +In color index mode, the fragment's color index $i sub r$ is replaced by +.sp +.ce +.EQ +{i sub r} sup prime ~=~ i sub r ~+~ (1 - f)^i sub f +.EN +.P +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value, +or if _param1 is _const(FOG_MODE) and _param2 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param1 is _const(FOG_DENSITY), +and _param2 is negative. +.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(IsEnabled) with argument _const(FOG) +.br +_cmnd(Get) with argument _const(FOG_COLOR) +.br +_cmnd(Get) with argument _const(FOG_INDEX) +.br +_cmnd(Get) with argument _const(FOG_DENSITY) +.br +_cmnd(Get) with argument _const(FOG_START) +.br +_cmnd(Get) with argument _const(FOG_END) +.br +_cmnd(Get) with argument _const(FOG_MODE) +.SH SEE ALSO +_cmnd(Enable) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/frontface.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/frontface.gl new file mode 100644 index 000000000..ace895ad6 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/frontface.gl @@ -0,0 +1,83 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(FrontFace,define front- and back-facing polygons) +_names(FrontFace) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the orientation of front-facing polygons. +_const(CW) and _const(CCW) are accepted. +The initial value is _const(CCW). +.SH DESCRIPTION +In a scene composed entirely of opaque closed surfaces, +back-facing polygons are never visible. +Eliminating these invisible polygons has the obvious benefit +of speeding up the rendering of the image. +To enable and disable elimination of back-facing polygons, call _cmnd(Enable) +and _cmnd(Disable) with argument _const(CULL_FACE). +.P +The projection of a polygon to window coordinates is said to have +clockwise winding if an imaginary object following the path +from its first vertex, +its second vertex, +and so on, +to its last vertex, +and finally back to its first vertex, +moves in a clockwise direction about the interior of the polygon. +The polygon's winding is said to be counterclockwise if the imaginary +object following the same path moves in a counterclockwise direction +about the interior of the polygon. +_cmnd specifies whether polygons with clockwise winding in window coordinates, +or counterclockwise winding in window coordinates, +are taken to be front-facing. +Passing _const(CCW) to _param1 selects counterclockwise polygons as +front-facing; +_const(CW) selects clockwise polygons as front-facing. +By default, counterclockwise polygons are taken to be front-facing. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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(Get) with argument _const(FRONT_FACE) +.SH SEE ALSO +_cmnd(CullFace), +_cmnd(LightModel) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/frustum.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/frustum.gl new file mode 100644 index 000000000..9688b9a0e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/frustum.gl @@ -0,0 +1,142 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Frustum,multiply the current matrix by a perspective matrix) +_names(Frustum) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2) +Specify the coordinates for the left and right vertical clipping planes. +_phead(_param3 _param4) +Specify the coordinates for the bottom and top horizontal clipping planes. +_phead(_param5 _param6) +Specify the distances to the near and far depth clipping planes. +Both distances must be positive. +.SH DESCRIPTION +_cmnd describes a perspective matrix that produces a perspective projection. +The current matrix (see _cmnd(MatrixMode)) is multiplied by this matrix +and the result replaces the current matrix, as if +_cmnd(MultMatrix) were called with the following matrix +as its argument: +.P +.sp 5 +.ce +.EQ +down 150 +{left [ ~~~ { +down 165 matrix { + ccol { {{2 ~ _eqnparam5} over {_eqnparam2 ~-~ _eqnparam1}} above 0 above 0 above 0 } + ccol { 0 above {{2 ~ _eqnparam5} over {_eqnparam4 ~-~ _eqnparam3}} ~ above 0 above 0 } + ccol { A ~~~~ above B ~~~~ above C ~~~~ above -1 ~~~~} + ccol { 0 above 0 above D above 0} +}} +~~~ right ]} +.EN +.sp +.ce +.EQ +down 130 +{A ~=~ {_eqnparam2 ~+~ _eqnparam1} over {_eqnparam2 ~-~ _eqnparam1}} +.EN +.sp +.ce +.EQ +down 130 +{B ~=~ {_eqnparam4 ~+~ _eqnparam3} over {_eqnparam4 ~-~ _eqnparam3}} +.EN +.sp +.ce +.EQ +down 130 +{C ~=~ -{{_eqnparam6 ~+~ _eqnparam5} over {_eqnparam6 ~-~ _eqnparam5}}} +.EN +.sp +.ce +.EQ +down 130 +{D ~=~ -^{{2 ~ _eqnparam6 ~ _eqnparam5} over {_eqnparam6 ~-~ _eqnparam5}}} +.EN +.sp 2 +.P +Typically, the matrix mode is _const(PROJECTION), and +(_param1, _param3, \-_param5) and (_param2, _param4, \-_param5) +specify the points on the near clipping plane that are mapped +to the lower left and upper right corners of the window, +assuming that the eye is located at (0, 0, 0). +\-_param6 specifies the location of the far clipping plane. +Both _param5 and _param6 must be positive. +.P +Use _cmnd(PushMatrix) and _cmnd(PopMatrix) to save and restore +the current matrix stack. +.SH NOTES +Depth buffer precision is affected by the values specified for +_param5 and _param6. +The greater the ratio of _param6 to _param5 is, +the less effective the depth buffer will be at distinguishing between +surfaces that are near each other. +If +.sp +.ce +$r ~=~ _eqnparam6 over _eqnparam5$ +.sp +roughly $log sub 2 (r)$ bits of depth buffer precision are lost. +Because $r$ approaches infinity as _param5 approaches 0, +_param5 must never be set to 0. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param5 or _param6 is not +positive, or if _param1 = _param2, or _param3 = _param4. +.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(Get) with argument _const(MATRIX_MODE) +.br +_cmnd(Get) with argument _const(MODELVIEW_MATRIX) +.br +_cmnd(Get) with argument _const(PROJECTION_MATRIX) +.br +_cmnd(Get) with argument _const(TEXTURE_MATRIX) +.br +_cmnd(Get) with argument _const(COLOR_MATRIX) +.SH SEE ALSO +_cmnd(Ortho), +_cmnd(MatrixMode), +_cmnd(MultMatrix), +_cmnd(PushMatrix), +_cmnd(Viewport) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/genlists.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/genlists.gl new file mode 100644 index 000000000..35d5830e5 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/genlists.gl @@ -0,0 +1,66 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GenLists,generate a contiguous set of empty display lists) +_names(GenLists) +.SH PARAMETERS +_phead(_param1) +Specifies the number of contiguous empty display lists +to be generated. +.SH DESCRIPTION +_cmnd has one argument, _param1. +It returns an integer \f2n\fP such that _param1 contiguous +empty display lists, +named \f2n\fP, \f2n\fP+1, ..., \f2n\fP+_param1 \-1, +are created. +If _param1 is 0, +if there is no group of _param1 contiguous names available, +or if any error is generated, +no display lists are generated, +and 0 is returned. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is negative. +.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(IsList) +.SH SEE ALSO +_cmnd(CallList), +_cmnd(CallLists), +_cmnd(DeleteLists), +_cmnd(NewList) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gentextures.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gentextures.gl new file mode 100644 index 000000000..e20136d01 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gentextures.gl @@ -0,0 +1,77 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GenTextures,generate texture names) +_names(GenTextures) +.SH PARAMETERS +_phead(_param1) +Specifies the number of texture names to be generated. +_phead(_param2) +Specifies an array in which the generated texture names are stored. +.SH DESCRIPTION +_cmnd returns _param1 texture names in _param2. +There is no guarantee that the names form a contiguous set of integers; +however, it is guaranteed that none of the returned names was in use +immediately before the call to _cmnd. +.P +The generated textures have no dimensionality; they assume the dimensionality +of the texture target to which they are first bound +(see _cmnd(BindTexture)). +.P +Texture names returned by a call to _cmnd are not returned by +subsequent calls, unless they are first deleted with +_cmnd(DeleteTextures). +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is negative. +.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(IsTexture) +.SH SEE ALSO +_cmnd(BindTexture), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(DeleteTextures), +_cmnd(Get), +_cmnd(GetTexParameter), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/get.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/get.gl new file mode 100644 index 000000000..4928c44ab --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/get.gl @@ -0,0 +1,1791 @@ +_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(Get,return the value or values of a selected parameter) +_names(GetBooleanv) +_names(GetDoublev) +_names(GetFloatv) +_names(GetIntegerv) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the parameter value to be returned. +The symbolic constants in the list below are accepted. +_phead(_param2) +Returns the value or values of the specified parameter. +.SH DESCRIPTION +These four commands return values for simple state variables in GL. +_param1 is a symbolic constant indicating the state variable to be returned, +and _param2 is a pointer to an array of the indicated type in +which to place the returned data. +.P +Type conversion is performed if _param2 has a different type than +the state variable value being requested. +If _cmnd(GetBooleanv) is called, +a floating-point (or integer) value is converted to _const(FALSE) if +and only if it is 0.0 (or 0). +Otherwise, +it is converted to _const(TRUE). +If _cmnd(GetIntegerv) is called, boolean values are returned as +_const(TRUE) or _const(FALSE), and most floating-point values are +rounded to the nearest integer value. Floating-point colors and +normals, however, are returned with a linear mapping that maps 1.0 to +the most positive representable integer value, +and \-1.0 to the most negative representable integer value. +If _cmnd(GetFloatv) or _cmnd(GetDoublev) is called, +boolean values are returned as _const(TRUE) or _const(FALSE), +and integer values are converted to floating-point values. +.P +The following symbolic constants are accepted by _param1: +.TP 25 +_const(ACCUM_ALPHA_BITS) +_param2 returns one value, +the number of alpha bitplanes in the accumulation buffer. +.TP +_const(ACCUM_BLUE_BITS) +_param2 returns one value, +the number of blue bitplanes in the accumulation buffer. +.TP +_const(ACCUM_CLEAR_VALUE) +_param2 returns four values: +the red, green, blue, and alpha values used to clear the accumulation buffer. +Integer values, +if requested, +are linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer +value. The initial value is (0, 0, 0, 0). +See _cmnd(ClearAccum). +.TP +_const(ACCUM_GREEN_BITS) +_param2 returns one value, +the number of green bitplanes in the accumulation buffer. +.TP +_const(ACCUM_RED_BITS) +_param2 returns one value, +the number of red bitplanes in the accumulation buffer. +.TP +_arbconst(ACTIVE_TEXTURE) +_param2 returns a single value indicating the active multitexture unit. +The initial value is _arbconst(TEXTURE0). +See _cmnd(ActiveTextureARB). +.TP +_const(ALIASED_POINT_SIZE_RANGE) +_param2 returns two values, +the smallest and largest supported sizes for aliased points. +.TP +_const(ALIASED_LINE_WIDTH_RANGE) +_param2 returns two values, +the smallest and largest supported widths for aliased lines. +.TP +_const(ALPHA_BIAS) +_param2 returns one value, +the alpha bias factor used during pixel transfers. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(ALPHA_BITS) +_param2 returns one value, +the number of alpha bitplanes in each color buffer. +.TP +_const(ALPHA_SCALE) +_param2 returns one value, +the alpha scale factor used during pixel transfers. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(ALPHA_TEST) +_param2 returns a single boolean value indicating whether alpha testing +of fragments is enabled. The initial value is _const(FALSE). +See _cmnd(AlphaFunc). +.TP +_const(ALPHA_TEST_FUNC) +_param2 returns one value, +the symbolic name of the alpha test function. The initial value is +_const(ALWAYS). +See _cmnd(AlphaFunc). +.TP +_const(ALPHA_TEST_REF) +_param2 returns one value, +the reference value for the alpha test. The initial value is 0. +See _cmnd(AlphaFunc). +An integer value, +if requested, +is linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer value. +.TP +_const(ATTRIB_STACK_DEPTH) +_param2 returns one value, +the depth of the attribute stack. +If the stack is empty, +0 is returned. The initial value is 0. +See _cmnd(PushAttrib). +.TP +_const(AUTO_NORMAL) +_param2 returns a single boolean value indicating whether 2D map evaluation +automatically generates surface normals. The initial value is _const(FALSE). +See _cmnd(Map2). +.TP +_const(AUX_BUFFERS) +_param2 returns one value, +the number of auxiliary color buffers. The initial value is 0. +.TP +_const(BLEND) +_param2 returns a single boolean value indicating whether blending is +enabled. The initial value is _const(FALSE). +See _cmnd(BlendFunc). +.TP +_const(BLEND_COLOR) +_param2 returns four values, +the red, green, blue, and alpha values which are the components of +the blend color. +See _cmnd(BlendColor). +.TP +_const(BLEND_DST) +_param2 returns one value, +the symbolic constant identifying the destination blend +function. The initial value is _const(ZERO). +See _cmnd(BlendFunc). +.TP +_const(BLEND_EQUATION) +_param2 returns one value, a symbolic constant indicating whether +the blend equation is _const(FUNC_ADD), _const(MIN) or +_const(MAX). See _cmnd(BlendEquation). +.TP +_const(BLEND_SRC) +_param2 returns one value, +the symbolic constant identifying the source blend function. The initial +value is _const(ONE). +See _cmnd(BlendFunc). +.TP +_const(BLUE_BIAS) +_param2 returns one value, +the blue bias factor used during pixel transfers. The initial value is 0. +See +_cmnd(PixelTransfer). +.TP +_const(BLUE_BITS) +_param2 returns one value, +the number of blue bitplanes in each color buffer. +.TP +_const(BLUE_SCALE) +_param2 returns one value, +the blue scale factor used during pixel transfers. The initial value is 1. +See +_cmnd(PixelTransfer). +.TP +_arbconst(CLIENT_ACTIVE_TEXTURE) +_param2 returns a single integer value indicating the current client active +multitexture unit. The initial value is _arbconst(TEXTURE0). +See _cmnd(ClientActiveTextureARB). +.TP +_const(CLIENT_ATTRIB_STACK_DEPTH) +_param2 returns one value indicating the depth of the +attribute stack. The initial value is 0. +See _cmnd(PushClientAttrib). +.TP +_const(CLIP_PLANE)\f2i\fP +_param2 returns a single boolean value indicating whether the specified +clipping plane is enabled. The initial value is _const(FALSE). +See _cmnd(ClipPlane). +.TP +_const(COLOR_ARRAY) +_param2 returns a single boolean value indicating whether the color array is enabled. The initial value is _const(FALSE). +See _cmnd(ColorPointer). +.TP +_const(COLOR_ARRAY_SIZE) +_param2 returns one value, +the number of components per color in the color array. The initial value +is 4. See _cmnd(ColorPointer). +.TP +_const(COLOR_ARRAY_STRIDE) +_param2 returns one value, +the byte offset between consecutive colors in the color array. The initial +value is 0. +See _cmnd(ColorPointer). +.TP +_const(COLOR_ARRAY_TYPE) +_param2 returns one value, +the data type of each component in the color array. The initial value +is _const(FLOAT). See _cmnd(ColorPointer). +.TP +_const(COLOR_CLEAR_VALUE) +_param2 returns four values: +the red, green, blue, and alpha values used to clear the color buffers. +Integer values, +if requested, +are linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer +value. The initial value is (0, 0, 0, 0). +See _cmnd(ClearColor). +.TP +_const(COLOR_LOGIC_OP) +_param2 returns a single boolean value indicating whether a fragment's +RGBA color values are merged into the framebuffer using a logical +operation. The initial value is _const(FALSE). +See _cmnd(LogicOp). +.TP +_const(COLOR_MATERIAL) +_param2 returns a single boolean value indicating whether one or more +material parameters are tracking the current color. The initial value +is _const(FALSE). +See _cmnd(ColorMaterial). +.TP +_const(COLOR_MATERIAL_FACE) +_param2 returns one value, +a symbolic constant indicating which materials have a parameter that is +tracking the current color. The initial value is _const(FRONT_AND_BACK). +See _cmnd(ColorMaterial). +.TP +_const(COLOR_MATERIAL_PARAMETER) +_param2 returns one value, +a symbolic constant indicating which material parameters are +tracking the current color. The initial value is +_const(AMBIENT_AND_DIFFUSE). +See _cmnd(ColorMaterial). +.TP +_const(COLOR_MATRIX) +_param2 returns sixteen values: +the color matrix on the top of the color matrix stack. Initially +this matrix is the identity matrix. See _cmnd(PushMatrix). +.TP +_const(COLOR_MATRIX_STACK_DEPTH) +_param2 returns one value, +the maximum supported depth of the projection matrix stack. The value must +be at least 2. +See _cmnd(PushMatrix). +.TP +_const(COLOR_TABLE) +_param2 returns a single boolean value indicating whether the color table +lookup is enabled. +See _cmnd(ColorTable). +.TP +_const(COLOR_WRITEMASK) +_param2 returns four boolean values: +the red, green, blue, and alpha write enables for the color +buffers. The initial value is (_const(TRUE), _const(TRUE), +_const(TRUE), _const(TRUE)). +See _cmnd(ColorMask). +.TP +_const(CONVOLUTION_1D) +_param2 returns a single boolean value indicating whether 1D convolution +is enabled. The initial value is _const(FALSE). +See _cmnd(ConvolutionFilter1D). +.TP +_const(CONVOLUTION_2D) +_param2 returns a single boolean value indicating whether 2D convolution +is enabled. The initial value is _const(FALSE). +See _cmnd(ConvolutionFilter2D). +.TP +_const(CULL_FACE) +_param2 returns a single boolean value indicating whether polygon culling +is enabled. The initial value is _const(FALSE). +See _cmnd(CullFace). +.TP +_const(CULL_FACE_MODE) +_param2 returns one value, +a symbolic constant indicating which polygon faces are to be +culled. The initial value is _const(BACK). +See _cmnd(CullFace). +.TP +_const(CURRENT_COLOR) +_param2 returns four values: +the red, green, blue, and alpha values of the current color. +Integer values, +if requested, +are linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer value. +See _cmnd(Color). The initial value is (1, 1, 1, 1). +.TP +_const(CURRENT_INDEX) +_param2 returns one value, +the current color index. The initial value is 1. +See _cmnd(Index). +.TP +_const(CURRENT_NORMAL) +_param2 returns three values: +the \f2x\fP, \f2y\fP, and \f2z\fP values of the current normal. +Integer values, +if requested, +are linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer value. +The initial value is (0, 0, 1). See _cmnd(Normal). +.TP +_const(CURRENT_RASTER_COLOR) +_param2 returns four values: +the red, green, blue, and alpha values of the current raster position. +Integer values, +if requested, +are linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer +value. The initial value is (1, 1, 1, 1). +See _cmnd(RasterPos). +.TP +_const(CURRENT_RASTER_DISTANCE) +_param2 returns one value, +the distance from the eye to the current raster position. The initial +value is 0. +See _cmnd(RasterPos). +.TP +_const(CURRENT_RASTER_INDEX) +_param2 returns one value, +the color index of the current raster position. The initial value is 1. +See _cmnd(RasterPos). +.TP +_const(CURRENT_RASTER_POSITION) +_param2 returns four values: +the \f2x\fP, \f2y\fP, \f2z\fP, and \f2w\fP components of the current +raster position. +\f2x\fP, \f2y\fP, and \f2z\fP are in window coordinates, +and \f2w\fP is in clip coordinates. The initial value is (0, 0, 0, 1). +See _cmnd(RasterPos). +.TP +_const(CURRENT_RASTER_POSITION_VALID) +_param2 returns a single boolean value indicating whether the current +raster position is valid. The initial value is _const(TRUE). +See _cmnd(RasterPos). +.TP +_const(CURRENT_RASTER_TEXTURE_COORDS) +_param2 returns four values: +the \f2s\fP, \f2t\fP, \f2r\fP, and \f2q\fP +current raster texture coordinates. The initial value is (0, 0, 0, 1). +See _cmnd(RasterPos) and _cmnd(TexCoord). +.TP +_const(CURRENT_TEXTURE_COORDS) +_param2 returns four values: +the \f2s\fP, \f2t\fP, \f2r\fP, and \f2q\fP current texture +coordinates. The initial value is (0, 0, 0, 1). +See +_cmnd(TexCoord). +.TP +_const(DEPTH_BIAS) +_param2 returns one value, +the depth bias factor used during pixel transfers. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(DEPTH_BITS) +_param2 returns one value, +the number of bitplanes in the depth buffer. +.TP +_const(DEPTH_CLEAR_VALUE) +_param2 returns one value, +the value that is used to clear the depth buffer. +Integer values, +if requested, +are linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer +value. The initial value is 1. +See _cmnd(ClearDepth). +.TP +_const(DEPTH_FUNC) +_param2 returns one value, +the symbolic constant that indicates the depth comparison +function. The initial value is _const(LESS). +See _cmnd(DepthFunc). +.TP +_const(DEPTH_RANGE) +_param2 returns two values: +the near and far mapping limits for the depth buffer. +Integer values, +if requested, +are linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer +value. The initial value is (0, 1). +See _cmnd(DepthRange). +.TP +_const(DEPTH_SCALE) +_param2 returns one value, +the depth scale factor used during pixel transfers. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(DEPTH_TEST) +_param2 returns a single boolean value indicating whether depth testing +of fragments is enabled. The initial value is _const(FALSE). +See _cmnd(DepthFunc) and _cmnd(DepthRange). +.TP +_const(DEPTH_WRITEMASK) +_param2 returns a single boolean value indicating if the depth buffer +is enabled for writing. The initial value is _const(TRUE). +See _cmnd(DepthMask). +.TP +_const(DITHER) +_param2 returns a single boolean value indicating whether dithering of +fragment colors and indices is enabled. The initial value is _const(TRUE). +.TP +_const(DOUBLEBUFFER) +_param2 returns a single boolean value indicating whether double buffering +is supported. +.TP +_const(DRAW_BUFFER) +_param2 returns one value, +a symbolic constant indicating which buffers are being drawn to. +See _cmnd(DrawBuffer). The initial value is _const(BACK) if there +are back buffers, otherwise it is _const(FRONT). +.TP +_const(EDGE_FLAG) +_param2 returns a single boolean value indicating whether the current +edge flag is _const(TRUE) or _const(FALSE). The initial value is _const(TRUE). +See _cmnd(EdgeFlag). +.TP +_const(EDGE_FLAG_ARRAY) +_param2 returns a single boolean value indicating whether the edge +flag array is enabled. The initial value is _const(FALSE). +See _cmnd(EdgeFlagPointer). +.TP +_const(EDGE_FLAG_ARRAY_STRIDE) +_param2 returns one value, +the byte offset between consecutive edge flags in the edge flag +array. The initial value is 0. +See _cmnd(EdgeFlagPointer). +.TP +_const(FEEDBACK_BUFFER_SIZE) +_param2 returns one value, the size of the feedback buffer. See +_cmnd(FeedbackBuffer). +.TP +_const(FEEDBACK_BUFFER_TYPE) +_param2 returns one value, the type of the feedback buffer. See +_cmnd(FeedbackBuffer). +.TP +_const(FOG) +_param2 returns a single boolean value indicating whether fogging is +enabled. The initial value is _const(FALSE). +See _cmnd(Fog). +.TP +_const(FOG_COLOR) +_param2 returns four values: +the red, green, blue, and alpha components of the fog color. +Integer values, +if requested, +are linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer +value. The initial value is (0, 0, 0, 0). +See _cmnd(Fog). +.TP +_const(FOG_DENSITY) +_param2 returns one value, +the fog density parameter. The initial value is 1. +See _cmnd(Fog). +.TP +_const(FOG_END) +_param2 returns one value, +the end factor for the linear fog equation. The initial value is 1. +See _cmnd(Fog). +.TP +_const(FOG_HINT) +_param2 returns one value, +a symbolic constant indicating the mode of the fog hint. The initial value +is _const(DONT_CARE). +See _cmnd(Hint). +.TP +_const(FOG_INDEX) +_param2 returns one value, +the fog color index. The initial value is 0. +See _cmnd(Fog). +.TP +_const(FOG_MODE) +_param2 returns one value, +a symbolic constant indicating which fog equation is selected. The initial +value is _const(EXP). +See _cmnd(Fog). +.TP +_const(FOG_START) +_param2 returns one value, +the start factor for the linear fog equation. The initial value is 0. +See _cmnd(Fog). +.TP +_const(FRONT_FACE) +_param2 returns one value, +a symbolic constant indicating whether clockwise or counterclockwise +polygon winding is treated as front-facing. The initial value is +_const(CCW). +See _cmnd(FrontFace). +.TP +_const(GREEN_BIAS) +_param2 returns one value, +the green bias factor used during pixel transfers. The initial value is 0. +.TP +_const(GREEN_BITS) +_param2 returns one value, +the number of green bitplanes in each color buffer. +.TP +_const(GREEN_SCALE) +_param2 returns one value, +the green scale factor used during pixel transfers. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(HISTOGRAM) +_param2 returns a single boolean value indicating whether histogram is +enabled. The initial value is _const(FALSE). +See _cmnd(Histogram). +.TP +_const(INDEX_ARRAY) +_param2 returns a single boolean value indicating whether the color +index array is enabled. The initial value is _const(FALSE). +See _cmnd(IndexPointer). +.TP +_const(INDEX_ARRAY_STRIDE) +_param2 returns one value, +the byte offset between consecutive color indexes in the color index +array. The initial value is 0. +See _cmnd(IndexPointer). +.TP +_const(INDEX_ARRAY_TYPE) +_param2 returns one value, +the data type of indexes in the color index array. The initial value is +_const(FLOAT). +See _cmnd(IndexPointer). +.TP +_const(INDEX_BITS) +_param2 returns one value, +the number of bitplanes in each color index buffer. +.TP +_const(INDEX_CLEAR_VALUE) +_param2 returns one value, +the color index used to clear the color index buffers. The initial value +is 0. +See _cmnd(ClearIndex). +.TP +_const(INDEX_LOGIC_OP) +_param2 returns a single boolean value indicating whether a fragment's index +values are merged into the framebuffer using a logical +operation. The initial value is _const(FALSE). +See _cmnd(LogicOp). +.TP +_const(INDEX_MODE) +_param2 returns a single boolean value indicating whether the GL is in +color index mode (_const(TRUE)) or RGBA mode (_const(FALSE)). +.TP +_const(INDEX_OFFSET) +_param2 returns one value, +the offset added to color and stencil indices during pixel +transfers. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(INDEX_SHIFT) +_param2 returns one value, +the amount that color and stencil indices are shifted during pixel +transfers. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(INDEX_WRITEMASK) +_param2 returns one value, +a mask indicating which bitplanes of each color index buffer can be +written. The initial value is all 1's. +See _cmnd(IndexMask). +.TP +_const(LIGHT)\f2i\fP +_param2 returns a single boolean value indicating whether the specified +light is enabled. The initial value is _const(FALSE). +See _cmnd(Light) and _cmnd(LightModel). +.TP +_const(LIGHTING) +_param2 returns a single boolean value indicating whether lighting is +enabled. The initial value is _const(FALSE). +See _cmnd(LightModel). +.TP +_const(LIGHT_MODEL_AMBIENT) +_param2 returns four values: +the red, green, blue, and alpha components of the ambient intensity of +the entire scene. +Integer values, +if requested, +are linearly mapped from the internal floating-point representation such +that 1.0 returns the most positive representable integer value, +and \-1.0 returns the most negative representable integer +value. The initial value is (0.2, 0.2, 0.2, 1.0). +See _cmnd(LightModel). +.TP +_const(LIGHT_MODEL_COLOR_CONTROL) +_param2 returns single enumerated value indicating whether specular +reflection calculations are separated from normal lighting computations. +The initial value is _const(SINGLE_COLOR). +.TP +_const(LIGHT_MODEL_LOCAL_VIEWER) +_param2 returns a single boolean value indicating whether specular reflection +calculations treat the viewer as being local to the scene. The initial +value is _const(FALSE). +See _cmnd(LightModel). +.TP +_const(LIGHT_MODEL_TWO_SIDE) +_param2 returns a single boolean value indicating whether separate materials +are used to compute lighting for front- and back-facing +polygons. The initial value is _const(FALSE). +See _cmnd(LightModel). +.TP +_const(LINE_SMOOTH) +_param2 returns a single boolean value indicating whether antialiasing of +lines is enabled. The initial value is _const(FALSE). +See _cmnd(LineWidth). +.TP +_const(LINE_SMOOTH_HINT) +_param2 returns one value, +a symbolic constant indicating the mode of the line antialiasing +hint. The initial value is _const(DONT_CARE). +See _cmnd(Hint). +.TP +_const(LINE_STIPPLE) +_param2 returns a single boolean value indicating whether stippling of lines +is enabled. The initial value is _const(FALSE). +See _cmnd(LineStipple). +.TP +_const(LINE_STIPPLE_PATTERN) +_param2 returns one value, +the 16-bit line stipple pattern. The initial value is all 1's. +See _cmnd(LineStipple). +.TP +_const(LINE_STIPPLE_REPEAT) +_param2 returns one value, +the line stipple repeat factor. The initial value is 1. +See _cmnd(LineStipple). +.TP +_const(LINE_WIDTH) +_param2 returns one value, +the line width as specified with _cmnd(LineWidth). The initial value is +1. +.TP +_const(LINE_WIDTH_GRANULARITY) +_param2 returns one value, +the width difference between adjacent supported widths for antialiased lines. +See _cmnd(LineWidth). +.TP +_const(LINE_WIDTH_RANGE) +_param2 returns two values: +the smallest and largest supported widths for antialiased +lines. +See _cmnd(LineWidth). +.TP +_const(LIST_BASE) +_param2 returns one value, +the base offset added to all names in arrays presented to +_cmnd(CallLists). The initial value is 0. +See _cmnd(ListBase). +.TP +_const(LIST_INDEX) +_param2 returns one value, +the name of the display list currently under construction. +0 is returned if no display list is currently under +construction. The initial value is 0. +See _cmnd(NewList). +.TP +_const(LIST_MODE) +_param2 returns one value, +a symbolic constant indicating the construction mode of the display list +currently under construction. The initial value is 0. +See _cmnd(NewList). +.TP +_const(LOGIC_OP_MODE) +_param2 returns one value, +a symbolic constant indicating the selected logic operation +mode. The initial value is _const(COPY). +See _cmnd(LogicOp). +.TP +_const(MAP1_COLOR_4) +_param2 returns a single boolean value indicating whether +1D evaluation generates colors. The initial value is _const(FALSE). +See _cmnd(Map1). +.TP +_const(MAP1_GRID_DOMAIN) +_param2 returns two values: +the endpoints of the 1D map's grid domain. The initial value is (0, 1). +See _cmnd(MapGrid). +.TP +_const(MAP1_GRID_SEGMENTS) +_param2 returns one value, +the number of partitions in the 1D map's grid domain. The initial value +is 1. +See _cmnd(MapGrid). +.TP +_const(MAP1_INDEX) +_param2 returns a single boolean value indicating whether +1D evaluation generates color indices. The initial value is _const(FALSE). +See _cmnd(Map1). +.TP +_const(MAP1_NORMAL) +_param2 returns a single boolean value indicating whether +1D evaluation generates normals. The initial value is _const(FALSE). +See _cmnd(Map1). +.TP +_const(MAP1_TEXTURE_COORD_1) +_param2 returns a single boolean value indicating whether +1D evaluation generates 1D texture coordinates. The initial value is +_const(FALSE). +See _cmnd(Map1). +.TP +_const(MAP1_TEXTURE_COORD_2) +_param2 returns a single boolean value indicating whether +1D evaluation generates 2D texture coordinates. The initial value is +_const(FALSE). +See _cmnd(Map1). +.TP +_const(MAP1_TEXTURE_COORD_3) +_param2 returns a single boolean value indicating whether +1D evaluation generates 3D texture coordinates. The initial value is +_const(FALSE). +See _cmnd(Map1). +.TP +_const(MAP1_TEXTURE_COORD_4) +_param2 returns a single boolean value indicating whether +1D evaluation generates 4D texture coordinates. The initial value is +_const(FALSE). +See _cmnd(Map1). +.TP +_const(MAP1_VERTEX_3) +_param2 returns a single boolean value indicating whether +1D evaluation generates 3D vertex coordinates. The initial value is +_const(FALSE). +See _cmnd(Map1). +.TP +_const(MAP1_VERTEX_4) +_param2 returns a single boolean value indicating whether +1D evaluation generates 4D vertex coordinates. The initial value is +_const(FALSE). +See _cmnd(Map1). +.TP +_const(MAP2_COLOR_4) +_param2 returns a single boolean value indicating whether +2D evaluation generates colors. The initial value is _const(FALSE). +See _cmnd(Map2). +.TP +_const(MAP2_GRID_DOMAIN) +_param2 returns four values: +the endpoints of the 2D map's $i$ and $j$ grid domains. The initial value +is (0,1; 0,1). +See _cmnd(MapGrid). +.TP +_const(MAP2_GRID_SEGMENTS) +_param2 returns two values: +the number of partitions in the 2D map's $i$ and $j$ grid +domains. The initial value is (1,1). +See _cmnd(MapGrid). +.TP +_const(MAP2_INDEX) +_param2 returns a single boolean value indicating whether +2D evaluation generates color indices. The initial value is _const(FALSE). +See _cmnd(Map2). +.TP +_const(MAP2_NORMAL) +_param2 returns a single boolean value indicating whether +2D evaluation generates normals. The initial value is _const(FALSE). +See _cmnd(Map2). +.TP +_const(MAP2_TEXTURE_COORD_1) +_param2 returns a single boolean value indicating whether +2D evaluation generates 1D texture coordinates. The initial value is +_const(FALSE). +See _cmnd(Map2). +.TP +_const(MAP2_TEXTURE_COORD_2) +_param2 returns a single boolean value indicating whether +2D evaluation generates 2D texture coordinates. The initial value is +_const(FALSE). +See _cmnd(Map2). +.TP +_const(MAP2_TEXTURE_COORD_3) +_param2 returns a single boolean value indicating whether +2D evaluation generates 3D texture coordinates. The initial value is +_const(FALSE). +See _cmnd(Map2). +.TP +_const(MAP2_TEXTURE_COORD_4) +_param2 returns a single boolean value indicating whether +2D evaluation generates 4D texture coordinates. The initial value is +_const(FALSE). +See _cmnd(Map2). +.TP +_const(MAP2_VERTEX_3) +_param2 returns a single boolean value indicating whether +2D evaluation generates 3D vertex coordinates. The initial value is +_const(FALSE). +See _cmnd(Map2). +.TP +_const(MAP2_VERTEX_4) +_param2 returns a single boolean value indicating whether +2D evaluation generates 4D vertex coordinates. The initial value is +_const(FALSE). +See _cmnd(Map2). +.TP +_const(MAP_COLOR) +_param2 returns a single boolean value indicating if colors and +color indices are to be replaced by table lookup during pixel +transfers. The initial value is _const(FALSE). +See _cmnd(PixelTransfer). +.TP +_const(MAP_STENCIL) +_param2 returns a single boolean value indicating if stencil indices +are to be replaced by table lookup during pixel transfers. The initial +value is _const(FALSE). +See _cmnd(PixelTransfer). +.TP +_const(MATRIX_MODE) +_param2 returns one value, +a symbolic constant indicating which matrix stack is currently the +target of all matrix operations. The initial value is _const(MODELVIEW). +See _cmnd(MatrixMode). +.TP +_const(MAX_3D_TEXTURE_SIZE) +_param2 returns one value, +a rough estimate of the largest 3D texture that the GL can handle. +If the GL version is 1.2 or greater, use +_const(PROXY_TEXTURE_3D) to determine if a texture is too large. +See _cmnd(TexImage3D). +.TP +_const(MAX_CLIENT_ATTRIB_STACK_DEPTH) +_param2 returns one value indicating the maximum supported depth +of the client attribute stack. +See _cmnd(PushClientAttrib). +.TP +_const(MAX_ATTRIB_STACK_DEPTH) +_param2 returns one value, +the maximum supported depth of the attribute stack. The value must be at least 16. +See _cmnd(PushAttrib). +.TP +_const(MAX_CLIP_PLANES) +_param2 returns one value, +the maximum number of application-defined clipping planes. The value must be at least 6. +See _cmnd(ClipPlane). +.TP +_const(MAX_COLOR_MATRIX_STACK_DEPTH) +_param2 returns one value, the maximum supported depth of the color matrix +stack. The value must be at least 2. +See _cmnd(PushMatrix). +.TP +_const(MAX_ELEMENTS_INDICES) +_param2 returns one value, +the recommended maximum number of vertex array indices. See _cmnd(DrawRangeElements). +.TP +_const(MAX_ELEMENTS_VERTICES) +_param2 returns one value, +the recommended maximum number of vertex array vertices. See _cmnd(DrawRangeElements). +.TP +_const(MAX_EVAL_ORDER) +_param2 returns one value, +the maximum equation order supported by 1D and 2D +evaluators. The value must be at least 8. +See _cmnd(Map1) and _cmnd(Map2). +.TP +_const(MAX_LIGHTS) +_param2 returns one value, +the maximum number of lights. The value must be at least 8. +See _cmnd(Light). +.TP +_const(MAX_LIST_NESTING) +_param2 returns one value, +the maximum recursion depth allowed during display-list +traversal. The value must be at least 64. +See _cmnd(CallList). +.TP +_const(MAX_MODELVIEW_STACK_DEPTH) +_param2 returns one value, +the maximum supported depth of the modelview matrix stack. The value must +be at least 32. +See _cmnd(PushMatrix). +.TP +_const(MAX_NAME_STACK_DEPTH) +_param2 returns one value, +the maximum supported depth of the selection name stack. The value must be at least 64. +See _cmnd(PushName). +.TP +_const(MAX_PIXEL_MAP_TABLE) +_param2 returns one value, +the maximum supported size of a _cmnd(PixelMap) lookup table. +The value must be at least 32. +See _cmnd(PixelMap). +.TP +_const(MAX_PROJECTION_STACK_DEPTH) +_param2 returns one value, +the maximum supported depth of the projection matrix stack. The value must be at least 2. +See _cmnd(PushMatrix). +.TP +_const(MAX_TEXTURE_SIZE) +_param2 returns one value. +The value gives a rough estimate of the largest texture that +the GL can handle. +If the GL version is 1.1 or greater, use +_const(PROXY_TEXTURE_1D) or _const(PROXY_TEXTURE_2D) +to determine if a texture is too large. +See _cmnd(TexImage1D) and _cmnd(TexImage2D). +.TP +_const(MAX_TEXTURE_STACK_DEPTH) +_param2 returns one value, +the maximum supported depth of the texture matrix stack. The value must be at least 2. +See _cmnd(PushMatrix). +.TP +_arbconst(MAX_TEXTURE_UNITS) +_param2 returns a single value indicating the number of texture units +supported. The value must be at least 1. +See _cmnd(ActiveTextureARB). +.TP +_const(MAX_VIEWPORT_DIMS) +_param2 returns two values: +the maximum supported width and height of the viewport. +These must be at least as large as the visible dimensions of the display +being rendered to. +See _cmnd(Viewport). +.TP +_const(MINMAX) +_param2 returns a single boolean value indicating whether pixel minmax +values are computed. The initial value is _const(FALSE). +See _cmnd(Minmax). +.TP +_const(MODELVIEW_MATRIX) +_param2 returns sixteen values: +the modelview matrix on the top of the modelview matrix stack. Initially +this matrix is the identity matrix. See _cmnd(PushMatrix). +.TP +_const(MODELVIEW_STACK_DEPTH) +_param2 returns one value, +the number of matrices on the modelview matrix stack. +The initial value is 1. +See _cmnd(PushMatrix). +.TP +_const(NAME_STACK_DEPTH) +_param2 returns one value, +the number of names on the selection name stack. The initial value is 0. +See _cmnd(PushName). +.TP +_const(NORMAL_ARRAY) +_param2 returns a single boolean value, indicating whether the normal +array is enabled. The initial value is _const(FALSE). +See _cmnd(NormalPointer). +.TP +_const(NORMAL_ARRAY_STRIDE) +_param2 returns one value, +the byte offset between consecutive normals in the normal +array. The initial value is 0. +See _cmnd(NormalPointer). +.TP +_const(NORMAL_ARRAY_TYPE) +_param2 returns one value, +the data type of each coordinate in the normal array. The initial value is +_const(FLOAT). +See _cmnd(NormalPointer). +.TP +_const(NORMALIZE) +_param2 returns a single boolean value indicating whether normals are +automatically scaled to unit length after they have been transformed to +eye coordinates. The initial value is _const(FALSE). +See _cmnd(Normal). +.TP +_const(PACK_ALIGNMENT) +_param2 returns one value, +the byte alignment used for writing pixel data to memory. The initial +value is 4. +See _cmnd(PixelStore). +.TP +_const(PACK_IMAGE_HEIGHT) +_param2 returns one value, +the image height used for writing pixel data to memory. The initial +value is 0. +See _cmnd(PixelStore). +.TP +_const(PACK_LSB_FIRST) +_param2 returns a single boolean value indicating whether single-bit +pixels being written to memory are written first to the least significant +bit of each unsigned byte. The initial value is _const(FALSE). +See _cmnd(PixelStore). +.TP +_const(PACK_ROW_LENGTH) +_param2 returns one value, +the row length used for writing pixel data to memory. The initial value is +0. +See _cmnd(PixelStore). +.TP +_const(PACK_SKIP_IMAGES) +_param2 returns one value, +the number of pixel images skipped before the first pixel is written +into memory. The initial value is 0. +See _cmnd(PixelStore). +.TP +_const(PACK_SKIP_PIXELS) +_param2 returns one value, +the number of pixel locations skipped before the first pixel is written +into memory. The initial value is 0. +See _cmnd(PixelStore). +.TP +_const(PACK_SKIP_ROWS) +_param2 returns one value, +the number of rows of pixel locations skipped before the first pixel is written +into memory. The initial value is 0. +See _cmnd(PixelStore). +.TP +_const(PACK_SWAP_BYTES) +_param2 returns a single boolean value indicating whether the bytes of +two-byte and four-byte pixel indices and components are swapped before being +written to memory. The initial value is _const(FALSE). +See _cmnd(PixelStore). +.TP +_const(PERSPECTIVE_CORRECTION_HINT) +_param2 returns one value, +a symbolic constant indicating the mode of the perspective correction +hint. The initial value is _const(DONT_CARE). +See _cmnd(Hint). +.TP +_const(PIXEL_MAP_A_TO_A_SIZE) +_param2 returns one value, +the size of the alpha-to-alpha pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(PIXEL_MAP_B_TO_B_SIZE) +_param2 returns one value, +the size of the blue-to-blue pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(PIXEL_MAP_G_TO_G_SIZE) +_param2 returns one value, +the size of the green-to-green pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(PIXEL_MAP_I_TO_A_SIZE) +_param2 returns one value, +the size of the index-to-alpha pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(PIXEL_MAP_I_TO_B_SIZE) +_param2 returns one value, +the size of the index-to-blue pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(PIXEL_MAP_I_TO_G_SIZE) +_param2 returns one value, +the size of the index-to-green pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(PIXEL_MAP_I_TO_I_SIZE) +_param2 returns one value, +the size of the index-to-index pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(PIXEL_MAP_I_TO_R_SIZE) +_param2 returns one value, +the size of the index-to-red pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(PIXEL_MAP_R_TO_R_SIZE) +_param2 returns one value, +the size of the red-to-red pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(PIXEL_MAP_S_TO_S_SIZE) +_param2 returns one value, +the size of the stencil-to-stencil pixel translation table. +The initial value is 1. +See _cmnd(PixelMap). +.TP +_const(POINT_SIZE) +_param2 returns one value, +the point size as specified by _cmnd(PointSize). The initial value is 1. +.TP +_const(POINT_SIZE_GRANULARITY) +_param2 returns one value, +the size difference between adjacent supported sizes for antialiased points. +See _cmnd(PointSize). +.TP +_const(POINT_SIZE_RANGE) +_param2 returns two values: +the smallest and largest supported sizes for antialiased +points. The smallest size must be at most 1, and the largest size must +be at least 1. +See _cmnd(PointSize). +.TP +_const(POINT_SMOOTH) +_param2 returns a single boolean value indicating whether antialiasing of +points is enabled. The initial value is _const(FALSE). +See _cmnd(PointSize). +.TP +_const(POINT_SMOOTH_HINT) +_param2 returns one value, +a symbolic constant indicating the mode of the point antialiasing +hint. The initial value is _const(DONT_CARE). +See _cmnd(Hint). +.TP +_const(POLYGON_MODE) +_param2 returns two values: +symbolic constants indicating whether front-facing and back-facing polygons +are rasterized as points, lines, or filled polygons. The initial value is +_const(FILL). +See _cmnd(PolygonMode). +.TP +_const(POLYGON_OFFSET_FACTOR) +_param2 returns one value, +the scaling factor used to determine the variable offset that is added +to the depth value of each fragment generated when a polygon is +rasterized. The initial value is 0. +See _cmnd(PolygonOffset). +.TP +_const(POLYGON_OFFSET_UNITS) +_param2 returns one value. +This value is multiplied by an implementation-specific value and then +added to the depth value of each fragment +generated when a polygon is rasterized. The initial value is 0. +See _cmnd(PolygonOffset). +.TP +_const(POLYGON_OFFSET_FILL) +_param2 returns a single boolean value indicating whether polygon offset +is enabled for polygons in fill mode. The initial value is _const(FALSE). +See _cmnd(PolygonOffset). +.TP +_const(POLYGON_OFFSET_LINE) +_param2 returns a single boolean value indicating whether polygon offset +is enabled for polygons in line mode. The initial value is _const(FALSE). +See _cmnd(PolygonOffset). +.TP +_const(POLYGON_OFFSET_POINT) +_param2 returns a single boolean value indicating whether polygon offset +is enabled for polygons in point mode. The initial value is _const(FALSE). +See _cmnd(PolygonOffset). +.TP +_const(POLYGON_SMOOTH) +_param2 returns a single boolean value indicating whether antialiasing of +polygons is enabled. The initial value is _const(FALSE). +See _cmnd(PolygonMode). +.TP +_const(POLYGON_SMOOTH_HINT) +_param2 returns one value, +a symbolic constant indicating the mode of the polygon antialiasing +hint. The initial value is _const(DONT_CARE). +See _cmnd(Hint). +.TP +_const(POLYGON_STIPPLE) +_param2 returns a single boolean value indicating whether polygon +stippling is enabled. The initial value is _const(FALSE). +See _cmnd(PolygonStipple). +.TP +_const(POST_COLOR_MATRIX_COLOR_TABLE) +_param2 returns a single boolean value indicating whether post color +matrix transformation lookup is enabled. The initial value is +_const(FALSE). +See _cmnd(ColorTable). +.TP +_const(POST_COLOR_MATRIX_RED_BIAS) +_param2 returns one value, the red bias factor applied to RGBA fragments +after color matrix transformations. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(POST_COLOR_MATRIX_GREEN_BIAS) +_param2 returns one value, the green bias factor applied to RGBA fragments +after color matrix transformations. The initial value is 0. +See _cmnd(PixelTransfer) +.TP +_const(POST_COLOR_MATRIX_BLUE_BIAS) +_param2 returns one value, the blue bias factor applied to RGBA fragments +after color matrix transformations. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(POST_COLOR_MATRIX_ALPHA_BIAS) +_param2 returns one value, the alpha bias factor applied to RGBA fragments +after color matrix transformations. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(POST_COLOR_MATRIX_RED_SCALE) +_param2 returns one value, the red scale factor applied to RGBA fragments +after color matrix transformations. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(POST_COLOR_MATRIX_GREEN_SCALE) +_param2 returns one value, the green scale factor applied to RGBA fragments +after color matrix transformations. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(POST_COLOR_MATRIX_BLUE_SCALE) +_param2 returns one value, the blue scale factor applied to RGBA fragments +after color matrix transformations. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(POST_COLOR_MATRIX_ALPHA_SCALE) +_param2 returns one value, the alpha scale factor applied to RGBA fragments +after color matrix transformations. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(POST_CONVOLUTION_COLOR_TABLE) +_param2 returns a single boolean value indicating whether post convolution +lookup is enabled. The initial value is _const(FALSE). +See _cmnd(ColorTable). +.TP +_const(POST_CONVOLUTION_RED_BIAS) +_param2 returns one value, the red bias factor applied to RGBA fragments +after convolution. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(POST_CONVOLUTION_GREEN_BIAS) +_param2 returns one value, the green bias factor applied to RGBA fragments +after convolution. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(POST_CONVOLUTION_BLUE_BIAS) +_param2 returns one value, the blue bias factor applied to RGBA fragments +after convolution. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(POST_CONVOLUTION_ALPHA_BIAS) +_param2 returns one value, the alpha bias factor applied to RGBA fragments +after convolution. The initial value is 0. +See _cmnd(PixelTransfer). +.TP +_const(POST_CONVOLUTION_RED_SCALE) +_param2 returns one value, the red scale factor applied to RGBA fragments +after convolution. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(POST_CONVOLUTION_GREEN_SCALE) +_param2 returns one value, the green scale factor applied to RGBA fragments +after convolution. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(POST_CONVOLUTION_BLUE_SCALE) +_param2 returns one value, the blue scale factor applied to RGBA fragments +after convolution. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(POST_CONVOLUTION_ALPHA_SCALE) +_param2 returns one value, the alpha scale factor applied to RGBA fragments +after convolution. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(PROJECTION_MATRIX) +_param2 returns sixteen values: +the projection matrix on the top of the projection matrix +stack. Initially this matrix is the identity matrix. +See _cmnd(PushMatrix). +.TP +_const(PROJECTION_STACK_DEPTH) +_param2 returns one value, +the number of matrices on the projection matrix stack. +The initial value is 1. +See _cmnd(PushMatrix). +.TP +_const(READ_BUFFER) +_param2 returns one value, +a symbolic constant indicating which color buffer is selected for +reading. The initial value is _const(BACK) if there is a back buffer, +otherwise it is _const(FRONT). +See +_cmnd(ReadPixels) and _cmnd(Accum). +.TP +_const(RED_BIAS) +_param2 returns one value, +the red bias factor used during pixel transfers. The initial value is 0. +.TP +_const(RED_BITS) +_param2 returns one value, +the number of red bitplanes in each color buffer. +.TP +_const(RED_SCALE) +_param2 returns one value, +the red scale factor used during pixel transfers. The initial value is 1. +See _cmnd(PixelTransfer). +.TP +_const(RENDER_MODE) +_param2 returns one value, +a symbolic constant indicating whether the GL is in render, +select, +or feedback mode. The initial value is _const(RENDER). +See _cmnd(RenderMode). +.TP +_const(RESCALE_NORMAL) +_param2 returns single boolean value +indicating whether normal rescaling is enabled. +See _cmnd(Enable). +.TP +_const(RGBA_MODE) +_param2 returns a single boolean value indicating whether the GL is in RGBA +mode (true) or color index mode (false). +See _cmnd(Color). +.TP +_const(SCISSOR_BOX) +_param2 returns four values: +the $x$ and $y$ window coordinates of the scissor box, +followed by its width and height. +Initially the $x$ and $y$ window coordinates are both 0 and the +width and height are set to the size of the window. +See _cmnd(Scissor). +.TP +_const(SCISSOR_TEST) +_param2 returns a single boolean value indicating whether scissoring is +enabled. The initial value is _const(FALSE). +See _cmnd(Scissor). +.TP +_const(SELECTION_BUFFER_SIZE) +_param2 return one value, +the size of the selection buffer. +See _cmnd(SelectBuffer). +.TP +_const(SEPARABLE_2D) +_param2 returns a single boolean value indicating whether 2D separable +convolution is enabled. The initial value is _const(FALSE). +See _cmnd(SeparableFilter2D). +.TP +_const(SHADE_MODEL) +_param2 returns one value, +a symbolic constant indicating whether the shading mode is flat or +smooth. The initial value is _const(SMOOTH). +See _cmnd(ShadeModel). +.TP +_const(SMOOTH_LINE_WIDTH_RANGE) +_param2 returns two values, +the smallest and largest supported widths for antialiased lines. +See _cmnd(LineWidth). +.TP +_const(SMOOTH_LINE_WIDTH_GRANULARITY) +_param2 returns one value, +the granularity of widths for antialiased lines. +See _cmnd(LineWidth). +.TP +_const(SMOOTH_POINT_SIZE_RANGE) +_param2 returns two values, +the smallest and largest supported widths for antialiased points. +See _cmnd(PointSize). +.TP +_const(SMOOTH_POINT_SIZE_GRANULARITY) +_param2 returns one value, +the granularity of sizes for antialiased points. +See _cmnd(PointSize). +.TP +_const(STENCIL_BITS) +_param2 returns one value, +the number of bitplanes in the stencil buffer. +.TP +_const(STENCIL_CLEAR_VALUE) +_param2 returns one value, +the index to which the stencil bitplanes are cleared. The initial value is +0. +See _cmnd(ClearStencil). +.TP +_const(STENCIL_FAIL) +_param2 returns one value, +a symbolic constant indicating what action is taken when the stencil +test fails. The initial value is _const(KEEP). +See _cmnd(StencilOp). +.TP +_const(STENCIL_FUNC) +_param2 returns one value, +a symbolic constant indicating what function is used to compare the +stencil reference value with the stencil buffer value. The initial value +is _const(ALWAYS). +See _cmnd(StencilFunc). +.TP +_const(STENCIL_PASS_DEPTH_FAIL) +_param2 returns one value, +a symbolic constant indicating what action is taken when the stencil +test passes, +but the depth test fails. The initial value is _const(KEEP). +See _cmnd(StencilOp). +.TP +_const(STENCIL_PASS_DEPTH_PASS) +_param2 returns one value, +a symbolic constant indicating what action is taken when the stencil +test passes and the depth test passes. The initial value is _const(KEEP). +See _cmnd(StencilOp). +.TP +_const(STENCIL_REF) +_param2 returns one value, +the reference value that is compared with the contents of the stencil +buffer. The initial value is 0. +See _cmnd(StencilFunc). +.TP +_const(STENCIL_TEST) +_param2 returns a single boolean value indicating whether stencil testing +of fragments is enabled. The initial value is _const(FALSE). +See _cmnd(StencilFunc) and _cmnd(StencilOp). +.TP +_const(STENCIL_VALUE_MASK) +_param2 returns one value, +the mask that is used to mask both the stencil reference value and the +stencil buffer value before they are compared. The initial value is all 1's. +See _cmnd(StencilFunc). +.TP +_const(STENCIL_WRITEMASK) +_param2 returns one value, +the mask that controls writing of the stencil bitplanes. The initial value +is all 1's. See _cmnd(StencilMask). +.TP +_const(STEREO) +_param2 returns a single boolean value indicating whether stereo buffers +(left and right) are supported. +.TP +_const(SUBPIXEL_BITS) +_param2 returns one value, +an estimate of the number of bits of subpixel resolution that are used to +position rasterized geometry in window coordinates. The initial value +.br +is 4. +.TP +_const(TEXTURE_1D) +_param2 returns a single boolean value indicating whether 1D texture +mapping is enabled. The initial value is _const(FALSE). +See _cmnd(TexImage1D). +.TP +_const(TEXTURE_BINDING_1D) +_param2 returns a single value, the name of the texture +currently bound to the target _const(TEXTURE_1D). The initial value is 0. +See _cmnd(BindTexture). +.TP +_const(TEXTURE_2D) +_param2 returns a single boolean value indicating whether 2D texture +mapping is enabled. The initial value is _const(FALSE). +See _cmnd(TexImage2D). +.TP +_const(TEXTURE_BINDING_2D) +_param2 returns a single value, the name of the texture +currently bound to the target _const(TEXTURE_2D). The initial value is 0. +See _cmnd(BindTexture). +.TP +_const(TEXTURE_3D) +_param2 returns a single boolean value indicating whether 3D texture +mapping is enabled. The initial value is _const(FALSE). +See _cmnd(TexImage3D). +.TP +_const(TEXTURE_BINDING_3D) +_param2 returns a single value, the name of the texture +currently bound to the target _const(TEXTURE_3D). The initial value is 0. +See _cmnd(BindTexture). +.TP +_const(TEXTURE_COORD_ARRAY) +_param2 returns a single boolean value indicating whether the texture +coordinate array is enabled. The initial value is _const(FALSE). +See _cmnd(TexCoordPointer). +.TP +_const(TEXTURE_COORD_ARRAY_SIZE) +_param2 returns one value, +the number of coordinates per element in the texture coordinate +array. The initial value is 4. +See _cmnd(TexCoordPointer). +.TP +_const(TEXTURE_COORD_ARRAY_STRIDE) +_param2 returns one value, +the byte offset between consecutive elements in the texture coordinate +array. The initial value is 0. +See _cmnd(TexCoordPointer). +.TP +_const(TEXTURE_COORD_ARRAY_TYPE) +_param2 returns one value, +the data type of the coordinates in the texture coordinate +array. The initial value is _const(FLOAT). +See _cmnd(TexCoordPointer). +.TP +_const(TEXTURE_GEN_Q) +_param2 returns a single boolean value indicating whether automatic generation +of the \f2q\fP texture coordinate is enabled. The initial value is _const(FALSE). +See _cmnd(TexGen). +.TP +_const(TEXTURE_GEN_R) +_param2 returns a single boolean value indicating whether automatic generation +of the \f2r\fP texture coordinate is enabled. The initial value is _const(FALSE). +See _cmnd(TexGen). +.TP +_const(TEXTURE_GEN_S) +_param2 returns a single boolean value indicating whether automatic generation +of the \f2S\fP texture coordinate is enabled. The initial value is _const(FALSE). +See _cmnd(TexGen). +.TP +_const(TEXTURE_GEN_T) +_param2 returns a single boolean value indicating whether automatic generation +of the T texture coordinate is enabled. The initial value is _const(FALSE). +See _cmnd(TexGen). +.TP +_const(TEXTURE_MATRIX) +_param2 returns sixteen values: +the texture matrix on the top of the texture matrix stack. Initially this +matrix is the identity matrix. +See _cmnd(PushMatrix). +.TP +_const(TEXTURE_STACK_DEPTH) +_param2 returns one value, +the number of matrices on the texture matrix stack. +The initial value is 1. +See _cmnd(PushMatrix). +.TP +_const(UNPACK_ALIGNMENT) +_param2 returns one value, +the byte alignment used for reading pixel data from memory. The initial +value is 4. +See _cmnd(PixelStore). +.TP +_const(UNPACK_IMAGE_HEIGHT) +_param2 returns one value, +the image height used for reading pixel data from memory. The initial +is 0. +See _cmnd(PixelStore). +.TP +_const(UNPACK_LSB_FIRST) +_param2 returns a single boolean value indicating whether single-bit +pixels being read from memory are read first from the least significant +bit of each unsigned byte. The initial value is _const(FALSE). +See _cmnd(PixelStore). +.TP +_const(UNPACK_ROW_LENGTH) +_param2 returns one value, +the row length used for reading pixel data from memory. The initial value +is 0. +See _cmnd(PixelStore). +.TP +_const(UNPACK_SKIP_IMAGES) +_param2 returns one value, +the number of pixel images skipped before the first pixel is read +from memory. The initial value is 0. +See _cmnd(PixelStore). +.TP +_const(UNPACK_SKIP_PIXELS) +_param2 returns one value, +the number of pixel locations skipped before the first pixel is read +from memory. The initial value is 0. +See _cmnd(PixelStore). +.TP +_const(UNPACK_SKIP_ROWS) +_param2 returns one value, +the number of rows of pixel locations skipped before the first pixel is read +from memory. The initial value is 0. +See _cmnd(PixelStore). +.TP +_const(UNPACK_SWAP_BYTES) +_param2 returns a single boolean value indicating whether the bytes of +two-byte and four-byte pixel indices and components are swapped after being +read from memory. The initial value is _const(FALSE). +See _cmnd(PixelStore). +.TP +_const(VERTEX_ARRAY) +_param2 returns a single boolean value indicating whether the vertex +array is enabled. The initial value is _const(FALSE). +See _cmnd(VertexPointer). +.TP +_const(VERTEX_ARRAY_SIZE) +_param2 returns one value, +the number of coordinates per vertex in the vertex array. The initial +value is 4. +See _cmnd(VertexPointer). +.TP +_const(VERTEX_ARRAY_STRIDE) +_param2 returns one value, +the byte offset between consecutive vertices in the vertex +array. The initial value is 0. +See _cmnd(VertexPointer). +.TP +_const(VERTEX_ARRAY_TYPE) +_param2 returns one value, +the data type of each coordinate in the vertex array. The initial value is +_const(FLOAT). +See _cmnd(VertexPointer). +.TP +_const(VIEWPORT) +_param2 returns four values: +the $x$ and $y$ window coordinates of the viewport, +followed by its width and height. +Initially the $x$ and $y$ window coordinates are both set to 0, +and the width and height are set to the width and height of the window into +which the GL will do its rendering. +See _cmnd(Viewport). +.TP +_const(ZOOM_X) +_param2 returns one value, +the $x$ pixel zoom factor. The initial value is 1. +See _cmnd(PixelZoom). +.TP +_const(ZOOM_Y) +_param2 returns one value, +the $y$ pixel zoom factor. The initial value is 1. +See _cmnd(PixelZoom). +.P +Many of the boolean parameters can also be queried more easily using +_cmnd(IsEnabled). +.SH NOTES +_const(COLOR_LOGIC_OP), +_const(COLOR_ARRAY), +_const(COLOR_ARRAY_SIZE), +_const(COLOR_ARRAY_STRIDE), +_const(COLOR_ARRAY_TYPE), +_const(EDGE_FLAG_ARRAY), +_const(EDGE_FLAG_ARRAY_STRIDE), +_const(INDEX_ARRAY), +_const(INDEX_ARRAY_STRIDE), +_const(INDEX_ARRAY_TYPE), +_const(INDEX_LOGIC_OP), +_const(NORMAL_ARRAY), +_const(NORMAL_ARRAY_STRIDE), +_const(NORMAL_ARRAY_TYPE), +_const(POLYGON_OFFSET_UNITS), +_const(POLYGON_OFFSET_FACTOR), +_const(POLYGON_OFFSET_FILL), +_const(POLYGON_OFFSET_LINE), +_const(POLYGON_OFFSET_POINT), +_const(TEXTURE_COORD_ARRAY), +_const(TEXTURE_COORD_ARRAY_SIZE), +_const(TEXTURE_COORD_ARRAY_STRIDE), +_const(TEXTURE_COORD_ARRAY_TYPE), +_const(VERTEX_ARRAY), +_const(VERTEX_ARRAY_SIZE), +_const(VERTEX_ARRAY_STRIDE), and +_const(VERTEX_ARRAY_TYPE) +are available only if the GL version is 1.1 or greater. +.P +_const(ALIASED_POINT_SIZE_RANGE), +_const(ALIASED_POINT_SIZE_GRANULARITY), +_const(FEEDBACK_BUFFER_SIZE), +_const(FEEDBACK_BUFFER_TYPE), +_const(LIGHT_MODEL_AMBIENT), +_const(LIGHT_MODEL_COLOR_CONTROL), +_const(MAX_3D_TEXTURE_SIZE), +_const(MAX_ELEMENTS_INDICES), +_const(MAX_ELEMENTS_VERTICES), +_const(PACK_IMAGE_HEIGHT), +_const(PACK_SKIP_IMAGES), +_const(RESCALE_NORMAL), +_const(SELECTION_BUFFER_SIZE), +_const(SMOOTH_LINE_WIDTH_GRANULARITY), +_const(SMOOTH_LINE_WIDTH_RANGE), +_const(SMOOTH_POINT_SIZE_GRANULARITY), +_const(SMOOTH_POINT_SIZE_RANGE), +_const(TEXTURE_3D), +_const(TEXTURE_BINDING_3D), +_const(UNPACK_IMAGE_HEIGHT), and +_const(UNPACK_SKIP_IMAGES) +are available only if the GL version is 1.2 or greater. +.P +_const(LINE_WIDTH_GRANULARITY) was deprecated in GL version 1.2. Its +functionality was replaced by _const(SMOOTH_LINE_WIDTH_GRANULARITY). +.P +_const(LINE_WIDTH_RANGE) was deprecated in GL version 1.2. Its +functionality was replaced by _const(SMOOTH_LINE_WIDTH_RANGE). +.P +_const(POINT_SIZE_GRANULARITY) was deprecated in GL version 1.2. Its +functionality was replaced by _const(SMOOTH_POINT_SIZE_GRANULARITY). +.P +_const(POINT_SIZE_RANGE) was deprecated in GL version 1.2. Its +functionality was replaced by _const(SMOOTH_POINT_SIZE_RANGE). +.P +_const(BLEND_COLOR), +_const(BLEND_EQUATION), +_const(COLOR_MATRIX), +_const(COLOR_MATRIX_STACK_DEPTH), +_const(COLOR_TABLE), +_const(CONVOLUTION_1D), +_const(CONVOLUTION_2D), +_const(HISTOGRAM), +_const(MAX_COLOR_MATRIX_STACK_DEPTH), +_const(MINMAX), +_const(POST_COLOR_MATRIX_COLOR_TABLE), +_const(POST_COLOR_MATRIX_RED_BIAS), +_const(POST_COLOR_MATRIX_GREEN_BIAS), +_const(POST_COLOR_MATRIX_BLUE_BIAS), +_const(POST_COLOR_MATRIX_ALPHA_BIAS), +_const(POST_COLOR_MATRIX_RED_SCALE), +_const(POST_COLOR_MATRIX_GREEN_SCALE), +_const(POST_COLOR_MATRIX_BLUE_SCALE), +_const(POST_COLOR_MATRIX_ALPHA_SCALE), +_const(POST_CONVOLUTION_COLOR_TABLE), +_const(POST_CONVOLUTION_RED_BIAS), +_const(POST_CONVOLUTION_GREEN_BIAS), +_const(POST_CONVOLUTION_BLUE_BIAS), +_const(POST_CONVOLUTION_ALPHA_BIAS), +_const(POST_CONVOLUTION_RED_SCALE), +_const(POST_CONVOLUTION_GREEN_SCALE), +_const(POST_CONVOLUTION_BLUE_SCALE), +_const(POST_CONVOLUTION_ALPHA_SCALE), and +_const(SEPARABLE_2D) +are available only if _arbstring(imaging) is returned from _cmnd(Get) +when called with the argument _const(EXTENSIONS). +.P +_arbconst(ACTIVE_TEXTURE), +_arbconst(CLIENT_ACTIVE_TEXTURE), and +_arbconst(MAX_TEXTURE_UNITS) are available only if +_arbstring(multitexture) is returned from _cmnd(Get) when called with the +argument _const(EXTENSIONS). +.P +When the _arbstring(multitexture) extension is supported, the following +parameters return the associated value for the active texture unit: +_const(CURRENT_RASTER_TEXTURE_COORDS), +_const(TEXTURE_1D), _const(TEXTURE_BINDING_1D), +_const(TEXTURE_2D), _const(TEXTURE_BINDING_2D), +_const(TEXTURE_3D), _const(TEXTURE_BINDING_3D), +_const(TEXTURE_GEN_S), +_const(TEXTURE_GEN_T), +_const(TEXTURE_GEN_R), +_const(TEXTURE_GEN_Q), +_const(TEXTURE_MATRIX), and +_const(TEXTURE_STACK_DEPTH). +Likewise, the following parameters return the associated value for the +active client texture unit: +_const(TEXTURE_COORD_ARRAY), +_const(TEXTURE_COORD_ARRAY_SIZE), +_const(TEXTURE_COORD_ARRAY_STRIDE), +_const(TEXTURE_COORD_ARRAY_TYPE). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.P +.SH SEE ALSO +_cmnd(GetClipPlane), +_cmnd(GetColorTable), +_cmnd(GetColorTableParameter), +_cmnd(GetConvolutionFilter), +_cmnd(GetConvolutionParameter), +_cmnd(GetError), +_cmnd(GetHistogram), +_cmnd(GetHistogramParameter), +_cmnd(GetLight), +_cmnd(GetMap), +_cmnd(GetMaterial), +_cmnd(GetMinmax), +_cmnd(GetMinmaxParameter), +_cmnd(GetPixelMap), +_cmnd(GetPointerv), +_cmnd(GetPolygonStipple), +_cmnd(GetSeparableFilter), +_cmnd(GetString), +_cmnd(GetTexEnv), +_cmnd(GetTexGen), +_cmnd(GetTexImage), +_cmnd(GetTexLevelParameter), +_cmnd(GetTexParameter), +_cmnd(IsEnabled) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getclipplane.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getclipplane.gl new file mode 100644 index 000000000..d52878f61 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getclipplane.gl @@ -0,0 +1,67 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GetClipPlane,return the coefficients of the specified clipping plane) +_names(GetClipPlane) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a clipping plane. +The number of clipping planes depends on the implementation, +but at least six clipping planes are supported. +They are identified by symbolic names of the form _const(CLIP_PLANE)$i$ +where 0 \(<= $ i $ < _const(MAX_CLIP_PLANES). +_phead(_param2) +Returns four double-precision values that are the coefficients of the plane equation of _param1 in eye coordinates. +The initial value is (0, 0, 0, 0). +.SH DESCRIPTION +_cmnd returns in _param2 the four coefficients of the plane equation +for _param1. +.SH NOTES +It is always the case that _const(CLIP_PLANE)$i$ = _const(CLIP_PLANE0) + $i$. +.P +If an error is generated, +no change is made to the contents of _param2. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(ClipPlane) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getcolortable.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getcolortable.gl new file mode 100644 index 000000000..e801b8926 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getcolortable.gl @@ -0,0 +1,155 @@ +_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)_C_ +_header(GetColorTable,retrieve contents of a color lookup table) +_names(GetColorTable) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__format>@,@<_param2>@)_C_ +_define(@<__type>@,@<_param3>@)_C_ +_define(@<__table>@,@<_param4>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be _const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), +or +_const(POST_COLOR_MATRIX_COLOR_TABLE). +_phead(__format) +The format of the pixel data in __table. +The possible values are +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(LUMINANCE), +_const(LUMINANCE_ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), and +_const(BGRA). +_phead(__type) +The type of the pixel data in __table. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) +are accepted. +_phead(__table) +Pointer to a one-dimensional array of pixel data containing the contents +of the color table. +.SH DESCRIPTION +_cmnd returns in __table the contents of the color table specified +by __target. No pixel transfer operations are performed, but pixel +storage modes that are applicable to +_cmnd(ReadPixels) are performed. +.P +Color components that are requested in +the specified __format, but which are not included in the internal +format of the color lookup table, are returned as zero. The +assignments of internal color components to the components +requested by __format are +.P +.TS +center; +lb lb +l l. +_ +Internal Component Resulting Component +_ +red red +green green +blue blue +alpha alpha +luminance red +intensity red +_ +.TE + +.P +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.P +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and __format is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and __format is neither _const(RGBA) nor _const(BGRA). +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.SH SEE ALSO +_cmnd(ColorTable), +_cmnd(ColorTableParameter), +_cmnd(GetColorTableParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getcolortableparameter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getcolortableparameter.gl new file mode 100644 index 000000000..183f867f4 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getcolortableparameter.gl @@ -0,0 +1,124 @@ +_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(GetColorTableParameter, get color lookup table parameters) +_names(GetColorTableParameter,[fi]v) +.EQ +delim $$ +.EN +.SH PARAMETERS +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__pname>@,@<_param2>@)_C_ +_define(@<__params>@,@<_param3>@)_C_ +_phead(__target) +The target color table. +Must be +_const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), +_const(POST_COLOR_MATRIX_COLOR_TABLE), +_const(PROXY_COLOR_TABLE), +_const(PROXY_POST_CONVOLUTION_COLOR_TABLE), +_const(PROXY_POST_COLOR_MATRIX_COLOR_TABLE). +_phead(__pname) +The symbolic name of a color lookup table parameter. +Must be one of +_const(COLOR_TABLE_BIAS), +_const(COLOR_TABLE_SCALE), +_const(COLOR_TABLE_FORMAT), +_const(COLOR_TABLE_WIDTH), +_const(COLOR_TABLE_RED_SIZE), +_const(COLOR_TABLE_GREEN_SIZE), +_const(COLOR_TABLE_BLUE_SIZE), +_const(COLOR_TABLE_ALPHA_SIZE), +_const(COLOR_TABLE_LUMINANCE_SIZE), or +_const(COLOR_TABLE_INTENSITY_SIZE). +_phead(__params) +A pointer to an array where the values of the parameter will be stored. +.SH DESCRIPTION +Returns parameters specific to color table __target. +.P +When __pname is set to _const(COLOR_TABLE_SCALE) or +_const(COLOR_TABLE_BIAS), _cmnd returns the color +table scale or bias parameters for the table specified by __target. +For these queries, __target must be set to +_const(COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), +or _const(POST_COLOR_MATRIX_COLOR_TABLE) and +__params points to an array of four elements, which receive +the scale or bias factors for red, green, blue, and alpha, in that order. +.P +_cmnd can also be used to retrieve the format and size parameters +for a color table. For these queries, set __target to either the +color table target or the proxy color table target. +The format and size parameters are set by _cmnd(ColorTable). +.P +The following table lists the format and size parameters that may +be queried. +For each symbolic constant listed below for __pname, +__params must point to an array of the +given length, and receive the values indicated. +.P +.TS +center; +lb cb lb +l c l. +_ +Parameter N Meaning +_ +_const(COLOR_TABLE_FORMAT) 1 Internal format (e.g. _const(RGBA)) +_const(COLOR_TABLE_WIDTH) 1 Number of elements in table +_const(COLOR_TABLE_RED_SIZE) 1 Size of red component, in bits +_const(COLOR_TABLE_GREEN_SIZE) 1 Size of green component +_const(COLOR_TABLE_BLUE_SIZE) 1 Size of blue component +_const(COLOR_TABLE_ALPHA_SIZE) 1 Size of alpha component +_const(COLOR_TABLE_LUMINANCE_SIZE) 1 Size of luminance component +_const(COLOR_TABLE_INTENSITY_SIZE) 1 Size of intensity component +_ +.TE +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target or __pname is not +an acceptable value. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.SH SEE ALSO +_cmnd(ColorTable), +_cmnd(TexParameter), +_cmnd(ColorTableParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getconvolutionfilter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getconvolutionfilter.gl new file mode 100644 index 000000000..c81391012 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getconvolutionfilter.gl @@ -0,0 +1,158 @@ +_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)_C_ +_header(GetConvolutionFilter,get current 1D or 2D convolution filter kernel) +_names(GetConvolutionFilter) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__format>@,@<_param2>@)_C_ +_define(@<__type>@,@<_param3>@)_C_ +_define(@<__image>@,@<_param4>@)_C_ +.SH PARAMETERS +_phead(__target) +The filter to be retrieved. +Must be one of +_const(CONVOLUTION_1D) or +_const(CONVOLUTION_2D). +_phead(__format) +Format of the output image. +Must be one of +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA). +_phead(__type) +Data type of components in the output image. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) +are accepted. +_phead(__image) +Pointer to storage for the output image. +.SH DESCRIPTION +_cmnd returns the current 1D or 2D convolution filter kernel as an image. +The one- or two-dimensional image is placed in __image according to the +specifications in __format and __type. +No pixel transfer operations are performed on this image, but the relevant +pixel storage modes are applied. +.sp +Color components that are present in __format but not included in the +internal format of the filter are returned as zero. +The assignments of internal color components to the components of __format +are as follows. +.br +.bp +.TS +center; +lb lb +l l. +_ +Internal Component Resulting Component +_ +Red Red +Green Green +Blue Blue +Alpha Alpha +Luminance Red +Intensity Red +_ +.TE +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.P +The current separable 2D filter must be retrieved with +_cmnd(GetSeparableFilter) rather than _cmnd. +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param3 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param2 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param3 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param2 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetConvolutionParameter) +.SH SEE ALSO +_cmnd(GetSeparableFilter), +_cmnd(ConvolutionParameter), +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getconvolutionparameter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getconvolutionparameter.gl new file mode 100644 index 000000000..1ae71b3d7 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getconvolutionparameter.gl @@ -0,0 +1,121 @@ +_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)_C_ +_header(GetConvolutionParameter,get convolution parameters) +_names(GetConvolutionParameter,[fi]v) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__pname>@,@<_param2>@)_C_ +_define(@<__params>@,@<_param3>@)_C_ +.SH PARAMETERS +_phead(__target) +The filter whose parameters are to be retrieved. +Must be one of +_const(CONVOLUTION_1D), +_const(CONVOLUTION_2D), or +_const(SEPARABLE_2D). +_phead(__pname) +The parameter to be retrieved. +Must be one of +_const(CONVOLUTION_BORDER_MODE), +_const(CONVOLUTION_BORDER_COLOR), +_const(CONVOLUTION_FILTER_SCALE), +_const(CONVOLUTION_FILTER_BIAS), +_const(CONVOLUTION_FORMAT), +_const(CONVOLUTION_WIDTH), +_const(CONVOLUTION_HEIGHT), +_const(MAX_CONVOLUTION_WIDTH), or +_const(MAX_CONVOLUTION_HEIGHT). +_phead(__params) +Pointer to storage for the parameters to be retrieved. +.SH DESCRIPTION +_cmnd retrieves convolution parameters. +__target determines which convolution filter is queried. +__pname determines which parameter is returned: +.TP +_const(CONVOLUTION_BORDER_MODE) +The convolution border mode. +See _cmnd(ConvolutionParameter) for a list of border modes. +.TP +_const(CONVOLUTION_BORDER_COLOR) +The current convolution border color. +__params must be a pointer to an array of four elements, +which will receive the red, green, blue, and alpha border colors. +.TP +_const(CONVOLUTION_FILTER_SCALE) +The current filter scale factors. +__params must be a pointer to an array of four elements, +which will receive the red, green, blue, and alpha filter scale +factors in that order. +.TP +_const(CONVOLUTION_FILTER_BIAS) +The current filter bias factors. +__params must be a pointer to an array of four elements, +which will receive the red, green, blue, and alpha filter bias +terms in that order. +.TP +_const(CONVOLUTION_FORMAT) +The current internal format. +See _cmnd(ConvolutionFilter1D), _cmnd(ConvolutionFilter2D), +and _cmnd(SeparableFilter2D) for lists of allowable formats. +.TP +_const(CONVOLUTION_WIDTH) +The current filter image width. +.TP +_const(CONVOLUTION_HEIGHT) +The current filter image height. +.TP +_const(MAX_CONVOLUTION_WIDTH) +The maximum acceptable filter image width. +.TP +_const(MAX_CONVOLUTION_HEIGHT) +The maximum acceptable filter image height. +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __pname is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __target is _const(CONVOLUTION_1D) +and __pname is _const(CONVOLUTION_HEIGHT) or +_const(MAX_CONVOLUTION_HEIGHT). +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.SH SEE ALSO +_cmnd(GetConvolutionFilter), +_cmnd(GetSeparableFilter2D), +_cmnd(ConvolutionParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/geterror.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/geterror.gl new file mode 100644 index 000000000..944b957b4 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/geterror.gl @@ -0,0 +1,121 @@ +_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(GetError, return error information) +_names(GetError) +.SH DESCRIPTION +_cmnd returns the value of the error flag. +Each detectable error is assigned a numeric code and symbolic name. +When an error occurs, +the error flag is set to the appropriate error code value. +No other errors are recorded until _cmnd is called, +the error code is returned, +and the flag is reset to _const(NO_ERROR). +If a call to _cmnd returns _const(NO_ERROR), +there has been no detectable error since the last call to _cmnd, +or since the GL was initialized. +.P +To allow for distributed implementations, +there may be several error flags. +If any single error flag has recorded an error, +the value of that flag is returned +and that flag is reset to _const(NO_ERROR) +when _cmnd is called. +If more than one flag has recorded an error, +_cmnd returns and clears an arbitrary error flag value. +Thus, _cmnd should always be called in a loop, +until it returns _const(NO_ERROR), +if all error flags are to be reset. +.P +Initially, all error flags are set to _const(NO_ERROR). +.P +The following errors are currently defined: +.TP 30 +_const(NO_ERROR) +No error has been recorded. +The value of this symbolic constant is guaranteed to be 0. +.TP +_const(INVALID_ENUM) +An unacceptable value is specified for an enumerated argument. +The offending command is ignored, +and has no other side effect than to set the error flag. +.TP +_const(INVALID_VALUE) +A numeric argument is out of range. +The offending command is ignored, +and has no other side effect than to set the error flag. +.TP +_const(INVALID_OPERATION) +The specified operation is not allowed in the current state. +The offending command is ignored, +and has no other side effect than to set the error flag. +.TP +_const(STACK_OVERFLOW) +This command would cause a stack overflow. +The offending command is ignored, +and has no other side effect than to set the error flag. +.TP +_const(STACK_UNDERFLOW) +This command would cause a stack underflow. +The offending command is ignored, +and has no other side effect than to set the error flag. +.TP +_const(OUT_OF_MEMORY) +There is not enough memory left to execute the command. +The state of the GL is undefined, +except for the state of the error flags, +after this error is recorded. +.TP +_const(TABLE_TOO_LARGE) +The specified table exceeds the implementation's maximum supported table +size. The offending command is ignored, and has no other side effect +than to set the error flag. +.P +When an error flag is set, +results of a GL operation are undefined only if _const(OUT_OF_MEMORY) +has occurred. +In all other cases, +the command generating the error is ignored and has no effect on the GL state +or frame buffer contents. +If the generating command returns a value, it returns 0. +If _cmnd itself generates an error, it returns 0. +.SH NOTES +_const(TABLE_TOO_LARGE) was introduced in GL version 1.2. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +In this case _cmnd returns 0. diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gethistogram.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gethistogram.gl new file mode 100644 index 000000000..1de8aa80a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gethistogram.gl @@ -0,0 +1,154 @@ +_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)_C_ +_header(GetHistogram,get histogram table) +_names(GetHistogram) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__reset>@,@<_param2>@)_C_ +_define(@<__format>@,@<_param3>@)_C_ +_define(@<__type>@,@<_param4>@)_C_ +_define(@<__values>@,@<_param5>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be +_const(HISTOGRAM). +_phead(__reset) +If _const(TRUE), each component counter that is actually returned +is reset to zero. (Other counters are unaffected.) +If _const(FALSE), none of the counters in the histogram table is modified. +_phead(__format) +The format of values to be returned in __values. +Must be one of +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA). +_phead(__type) +The type of values to be returned in __values. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) +are accepted. +_phead(__values) +A pointer to storage for the returned histogram table. +.SH DESCRIPTION +_cmnd returns the current histogram table as a one-dimensional image +with the same width as the histogram. +No pixel transfer operations are performed on this image, but pixel storage +modes that are applicable to 1D images are honored. +.PP +Color components that are requested in the specified __format, but which +are not included in the internal format of the histogram, are returned as +zero. +.bp +The assignments of internal color components to the components +requested by __format are: +.TS +center; +lb lb +l l. +_ +Internal Component Resulting Component +_ +Red Red +Green Green +Blue Blue +Alpha Alpha +Luminance Red +_ +.TE + +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not _const(HISTOGRAM). +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and __format is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and __format is neither _const(RGBA) nor _const(BGRA). +.SH SEE ALSO +_cmnd(Histogram), +_cmnd(ResetHistogram), +_cmnd(GetHistogramParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gethistogramparameter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gethistogramparameter.gl new file mode 100644 index 000000000..8e87f0ac3 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gethistogramparameter.gl @@ -0,0 +1,110 @@ +_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)_C_ +_header(GetHistogramParameter,get histogram parameters) +_names(GetHistogramParameter,[fi]v) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__pname>@,@<_param2>@)_C_ +_define(@<__params>@,@<_param3>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be one of +_const(HISTOGRAM) or +_const(PROXY_HISTOGRAM). +_phead(__pname) +The name of the parameter to be retrieved. +Must be one of +_const(HISTOGRAM_WIDTH), +_const(HISTOGRAM_FORMAT), +_const(HISTOGRAM_RED_SIZE), +_const(HISTOGRAM_GREEN_SIZE), +_const(HISTOGRAM_BLUE_SIZE), +_const(HISTOGRAM_ALPHA_SIZE), +_const(HISTOGRAM_LUMINANCE_SIZE), or +_const(HISTOGRAM_SINK). +_phead(__params) +Pointer to storage for the returned values. +.SH DESCRIPTION +_cmnd is used to query parameter values for the current histogram or for +a proxy. The histogram state information may be queried by calling +_cmnd(GetHistogramParameter) with a __target of _const(HISTOGRAM) (to +obtain information for the current histogram table) or +_const(PROXY_HISTOGRAM) (to obtain information from the most recent +proxy request) and one of the following values for the __pname argument: +.P +.ne +.TS +center; +lb lb +l l. +_ +Parameter Description +_ +_const(HISTOGRAM_WIDTH) Histogram table width +_const(HISTOGRAM_FORMAT) Internal format +_const(HISTOGRAM_RED_SIZE) Red component counter size, in bits +_const(HISTOGRAM_GREEN_SIZE) Green component counter size, in bits +.TE +.bp +.TS +center; +lb lb +l l. +_ +Parameter Description +_ +_const(HISTOGRAM_BLUE_SIZE) Blue component counter size, in bits +_const(HISTOGRAM_ALPHA_SIZE) Alpha component counter size, in bits +_const(HISTOGRAM_LUMINANCE_SIZE) Luminance component counter size, in bits +_const(HISTOGRAM_SINK) Value of the \f2sink\fP parameter +_ +.TE + +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __pname is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.SH SEE ALSO +_cmnd(GetHistogram), +_cmnd(Histogram) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getlight.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getlight.gl new file mode 100644 index 000000000..14843c780 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getlight.gl @@ -0,0 +1,192 @@ +_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(GetLight,return light source parameter values) +_names(GetLight,[fi]v) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a light source. +The number of possible lights depends on the implementation, +but at least eight lights are supported. +They are identified by symbolic names of the form _const(LIGHT)$i$ +where 0 \(<= $ i $ < _const(MAX_LIGHTS). +_phead(_param2) +Specifies a light source parameter for _param1. +Accepted symbolic names are +_const(AMBIENT), +_const(DIFFUSE), +_const(SPECULAR), +_const(POSITION), +_const(SPOT_DIRECTION), +_const(SPOT_EXPONENT), +_const(SPOT_CUTOFF), +_const(CONSTANT_ATTENUATION), +_const(LINEAR_ATTENUATION), and +_const(QUADRATIC_ATTENUATION). +_phead(_param3) +Returns the requested data. +.SH DESCRIPTION +_cmnd returns in _param3 the value or values of a light source parameter. +_param1 names the light and is a symbolic name of the form _const(LIGHT)$i$ +for 0 \(<= $i$ < _const(MAX_LIGHTS), +where _const(MAX_LIGHTS) is an implementation dependent constant that is +greater than or equal to eight. +_param2 specifies one of ten light source parameters, +again by symbolic name. +.P +The following parameters are defined: +.TP 20 +_const(AMBIENT) +_param3 returns four integer or floating-point values representing the +ambient intensity of the light source. +Integer values, +when requested, +are linearly mapped from the internal floating-point representation +such that 1.0 maps to the most positive representable integer value, +and \-1.0 maps to the most negative representable integer value. +If the internal value is outside the range [\-1, 1], +the corresponding integer return value is undefined. The initial value is +(0, 0, 0, 1). +.TP +_const(DIFFUSE) +_param3 returns four integer or floating-point values representing the +diffuse intensity of the light source. +Integer values, +when requested, +are linearly mapped from the internal floating-point representation +such that 1.0 maps to the most positive representable integer value, +and \-1.0 maps to the most negative representable integer value. +If the internal value is outside the range [\-1, 1], +the corresponding integer return value is undefined. The initial value +for _const(LIGHT0) is (1, 1, 1, 1); for other lights, the +initial value is (0, 0, 0, 0). +.TP +_const(SPECULAR) +_param3 returns four integer or floating-point values representing the +specular intensity of the light source. +Integer values, +when requested, +are linearly mapped from the internal floating-point representation +such that 1.0 maps to the most positive representable integer value, +and \-1.0 maps to the most negative representable integer value. +If the internal value is outside the range [\-1, 1], +the corresponding integer return value is undefined. The initial value +for _const(LIGHT0) is (1, 1, 1, 1); for other lights, the +initial value is (0, 0, 0, 0). +.TP +_const(POSITION) +_param3 returns four integer or floating-point values representing the +position of the light source. +Integer values, +when requested, +are computed by rounding the internal floating-point values to the +nearest integer value. +The returned values are those maintained in eye coordinates. +They will not be equal to the values specified using _cmnd(Light), +unless the modelview matrix was identity at the time _cmnd(Light) was +called. The initial value is (0, 0, 1, 0). +.TP +_const(SPOT_DIRECTION) +_param3 returns three integer or floating-point values representing the +direction of the light source. +Integer values, +when requested, +are computed by rounding the internal floating-point values to the +nearest integer value. +The returned values are those maintained in eye coordinates. +They will not be equal to the values specified using _cmnd(Light), +unless the modelview matrix was identity at the time _cmnd(Light) was called. +Although spot direction is normalized before being used in the lighting +equation, +the returned values are the transformed versions of the specified values +prior to normalization. The initial value is (0, 0, \-1). +.TP +_const(SPOT_EXPONENT) +_param3 returns a single integer or floating-point value representing the +spot exponent of the light. +An integer value, +when requested, +is computed by rounding the internal floating-point representation to +the nearest integer. The initial value is 0. +.TP +_const(SPOT_CUTOFF) +_param3 returns a single integer or floating-point value representing the +spot cutoff angle of the light. +An integer value, +when requested, +is computed by rounding the internal floating-point representation to +the nearest integer. The initial value is 180. +.TP +_const(CONSTANT_ATTENUATION) +_param3 returns a single integer or floating-point value representing the +constant (not distance-related) attenuation of the light. +An integer value, +when requested, +is computed by rounding the internal floating-point representation to +the nearest integer. The initial value is 1. +.TP +_const(LINEAR_ATTENUATION ) +_param3 returns a single integer or floating-point value representing the +linear attenuation of the light. +An integer value, +when requested, +is computed by rounding the internal floating-point representation to +the nearest integer. The initial value is 0. +.TP +_const(QUADRATIC_ATTENUATION) +_param3 returns a single integer or floating-point value representing the +quadratic attenuation of the light. +An integer value, +when requested, +is computed by rounding the internal floating-point representation to +the nearest integer. The initial value is 0. +.SH NOTES +It is always the case that _const(LIGHT)$i$ = _const(LIGHT0) + $i$. +.P +If an error is generated, +no change is made to the contents of _param3. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 or _param2 is not an +accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(Light) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getmap.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getmap.gl new file mode 100644 index 000000000..ed322f092 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getmap.gl @@ -0,0 +1,132 @@ +_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(GetMap,return evaluator parameters) +_names(GetMap,[dfi]v) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the symbolic name of a map. +Accepted values are +_const(MAP1_COLOR_4), +_const(MAP1_INDEX), +_const(MAP1_NORMAL), +_const(MAP1_TEXTURE_COORD_1), +_const(MAP1_TEXTURE_COORD_2), +_const(MAP1_TEXTURE_COORD_3), +_const(MAP1_TEXTURE_COORD_4), +_const(MAP1_VERTEX_3), +_const(MAP1_VERTEX_4), +_const(MAP2_COLOR_4), +_const(MAP2_INDEX), +_const(MAP2_NORMAL), +_const(MAP2_TEXTURE_COORD_1), +_const(MAP2_TEXTURE_COORD_2), +_const(MAP2_TEXTURE_COORD_3), +_const(MAP2_TEXTURE_COORD_4), +_const(MAP2_VERTEX_3), and +_const(MAP2_VERTEX_4). +_phead(_param2) +Specifies which parameter to return. +Symbolic names +_const(COEFF), +_const(ORDER), and +_const(DOMAIN) are accepted. +_phead(_param3) +Returns the requested data. +.SH DESCRIPTION +_cmnd(Map1) and _cmnd(Map2) define evaluators. +_cmnd returns evaluator parameters. +_param1 chooses a map, +_param2 selects a specific parameter, +and _param3 points to storage where the values will be returned. +.P +The acceptable values for the _param1 parameter are described +in the _cmnd(Map1) and _cmnd(Map2) reference pages. +.P +_param2 can assume the following values: +.TP 15 +_const(COEFF) +_param3 returns the control points for the evaluator function. +One-dimensional evaluators return $order$ control points, +and two-dimensional evaluators return $uorder ~times~ vorder$ control points. +Each control point consists of one, two, three, or four integer, +single-precision floating-point, +or double-precision floating-point values, +depending on the type of the evaluator. +The GL returns two-dimensional control points in row-major order, +incrementing the $uorder$ index quickly +and the $vorder$ index after each row. +Integer values, +when requested, +are computed by rounding the internal floating-point values to the +nearest integer values. +.TP +_const(ORDER) +_param3 returns the order of the evaluator function. +One-dimensional evaluators return a single value, +$order$. The initial value is 1. +Two-dimensional evaluators return two values, +$uorder$ and $vorder$. The initial value is 1,1. +.TP +_const(DOMAIN) +_param3 returns the linear $u$ and $v$ mapping parameters. +One-dimensional evaluators return two values, +$u1$ and $u2$, +as specified by _cmnd(Map1). +Two-dimensional evaluators return four values +($u1$, $u2$, $v1$, and $v2$) +as specified by _cmnd(Map2). +Integer values, +when requested, +are computed by rounding the internal floating-point values to the +nearest integer values. +.SH NOTES +If an error is generated, +no change is made to the contents of _param3. +.SH ERRORS +_const(INVALID_ENUM) is generated if either _param1 or _param2 is not +an accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(EvalCoord), +_cmnd(Map1), +_cmnd(Map2) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getmaterial.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getmaterial.gl new file mode 100644 index 000000000..0df347ea3 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getmaterial.gl @@ -0,0 +1,138 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GetMaterial,return material parameters) +_names(GetMaterial,[fi]v) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies which of the two materials is being queried. +_const(FRONT) or _const(BACK) are accepted, +representing the front and back materials, respectively. +_phead(_param2) +Specifies the material parameter to return. +_const(AMBIENT), +_const(DIFFUSE), +_const(SPECULAR), +_const(EMISSION), +_const(SHININESS), and +_const(COLOR_INDEXES) +are accepted. +_phead(_param3) +Returns the requested data. +.SH DESCRIPTION +_cmnd returns in _param3 the value or values of parameter _param2 +of material _param1. Six parameters are defined: +.TP 22 +_const(AMBIENT) +_param3 returns four integer or floating-point values representing the +ambient reflectance of the material. +Integer values, +when requested, +are linearly mapped from the internal floating-point representation +such that 1.0 maps to the most positive representable integer value, +and \-1.0 maps to the most negative representable integer value. +If the internal value is outside the range [\-1, 1], +the corresponding integer return value is undefined. The initial value is +(0.2, 0.2, 0.2, 1.0) +.TP +_const(DIFFUSE) +_param3 returns four integer or floating-point values representing the +diffuse reflectance of the material. +Integer values, +when requested, +are linearly mapped from the internal floating-point representation +such that 1.0 maps to the most positive representable integer value, +and \-1.0 maps to the most negative representable integer value. +If the internal value is outside the range [\-1, 1], +the corresponding integer return value is undefined. The initial value is +(0.8, 0.8, 0.8, 1.0). +.TP +_const(SPECULAR) +_param3 returns four integer or floating-point values representing the +specular reflectance of the material. +Integer values, +when requested, +are linearly mapped from the internal floating-point representation +such that 1.0 maps to the most positive representable integer value, +and \-1.0 maps to the most negative representable integer value. +If the internal value is outside the range [\-1, 1], +the corresponding integer return value is undefined. The initial value is +(0, 0, 0, 1). +.TP +_const(EMISSION) +_param3 returns four integer or floating-point values representing the +emitted light intensity of the material. +Integer values, +when requested, +are linearly mapped from the internal floating-point representation +such that 1.0 maps to the most positive representable integer value, +and \-1.0 maps to the most negative representable integer value. +If the internal value is outside the range [\-1, 1.0], +the corresponding integer return value is undefined. The initial value is +(0, 0, 0, 1). +.TP +_const(SHININESS) +_param3 returns one integer or floating-point value representing the +specular exponent of the material. +Integer values, +when requested, +are computed by rounding the internal floating-point value to the +nearest integer value. The initial value is 0. +.TP +_const(COLOR_INDEXES) +_param3 returns three integer or floating-point values representing the +ambient, diffuse, and specular indices of the material. +These indices are used only for color index lighting. +(All the other parameters are used only for RGBA lighting.) +Integer values, +when requested, +are computed by rounding the internal floating-point values to the +nearest integer values. +.SH NOTES +If an error is generated, +no change is made to the contents of _param3. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 or _param2 is not an +accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(Material) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getminmax.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getminmax.gl new file mode 100644 index 000000000..b89b86f8d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getminmax.gl @@ -0,0 +1,161 @@ +_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)_C_ +_header(GetMinmax,get minimum and maximum pixel values) +_names(GetMinmax) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__reset>@,@<_param2>@)_C_ +_define(@<__format>@,@<_param3>@)_C_ +_define(@<__type>@,@<_param4>@)_C_ +_define(@<__values>@,@<_param5>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be +_const(MINMAX). +_phead(__reset) +If _const(TRUE), all entries in the minmax table that are actually +returned are reset to their initial values. (Other entries are unaltered.) +If _const(FALSE), the minmax table is unaltered. +_phead(__format) +The format of the data to be returned in __values. +Must be one of +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA). +_phead(__type) +The type of the data to be returned in __values. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) +are accepted. +_phead(__values) +A pointer to storage for the returned values. +.SH DESCRIPTION +_cmnd returns the accumulated minimum and maximum pixel values (computed on a +per-component basis) in a one-dimensional image of width 2. The first set +of return values are the minima, and the second set of return values +are the maxima. +The format of the return values is determined by __format, and their type is +determined by __type. +.PP +No pixel transfer operations are performed on the return values, but pixel +storage modes that are applicable to 1-dimensional images are performed. +Color components that are requested in the specified __format, but that +are not included in the internal format of the minmax table, are +returned as zero. The assignment of internal color components to the +components requested by __format are as follows: +.sp +.TS +center; +lb lb +l l. +_ +Internal Component Resulting Component +_ +Red Red +Green Green +Blue Blue +Alpha Alpha +Luminance Red +_ +.TE + +.PP +If __reset is _const(TRUE), the minmax table entries corresponding +to the return values are reset to their initial +values. Minimum and maximum values that are not returned are not +modified, even if __reset is _const(TRUE). +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not _const(MINMAX). +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and __format is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and __format is neither _const(RGBA) nor _const(BGRA). +.SH SEE ALSO +_cmnd(Minmax), +_cmnd(ResetMinmax), +_cmnd(GetMinmaxParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getminmaxparameter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getminmaxparameter.gl new file mode 100644 index 000000000..6a45e3c87 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getminmaxparameter.gl @@ -0,0 +1,83 @@ +_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)_C_ +_header(GetMinmaxParameter,get minmax parameters) +_names(GetMinmaxParameter,[fi]v) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__pname>@,@<_param2>@)_C_ +_define(@<__params>@,@<_param3>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be +_const(MINMAX). +_phead(__pname) +The parameter to be retrieved. +Must be one of +_const(MINMAX_FORMAT) or +_const(MINMAX_SINK). +_phead(__params) +A pointer to storage for the retrieved parameters. +.SH DESCRIPTION +_cmnd retrieves parameters for the current minmax table by setting +__pname to one of the following values: +.sp + +.TS +center; +lb lb +l l. +_ +Parameter Description +_ +_const(MINMAX_FORMAT) Internal format of minmax table +_const(MINMAX_SINK) Value of the \f2sink\fP parameter +_ +.TE + +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not _const(MINMAX). +.P +_const(INVALID_ENUM) is generated if __pname is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.SH SEE ALSO +_cmnd(Minmax), +_cmnd(GetMinmax) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getpixelmap.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getpixelmap.gl new file mode 100644 index 000000000..258102e2f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getpixelmap.gl @@ -0,0 +1,160 @@ +_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(GetPixelMap,return the specified pixel map) +_names(GetPixelMap,u*[ifs]v) +.SH PARAMETERS +_phead(_param1) +Specifies the name of the pixel map to return. +Accepted values are +_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), and +_const(PIXEL_MAP_A_TO_A). +_phead(_param2) +Returns the pixel map contents. +.SH DESCRIPTION +See the _cmnd(PixelMap) reference page for a description of the acceptable +values for the _param1 parameter. +_cmnd returns in _param2 the contents of the pixel map +specified in _param1. +Pixel maps are used during the execution of +_cmnd(ReadPixels), +_cmnd(DrawPixels), +_cmnd(CopyPixels), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(ColorTable), +_cmnd(ColorSubTable), +_cmnd(CopyColorTable), +_cmnd(CopyColorSubTable), +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), +_cmnd(SeparableFilter2D), +_cmnd(GetHistogram), +_cmnd(GetMinmax), and +_cmnd(GetTexImage) +to map color indices, +stencil indices, +color components, +and depth components to other values. +.P +Unsigned integer values, +if requested, +are linearly mapped from the internal fixed or floating-point representation +such that 1.0 maps to the largest representable integer value, +and 0.0 maps to 0. +Return unsigned integer values are undefined if the map value was +not in the range [0,1]. +.P +To determine the required size of _param1, +call _cmnd(Get) with the appropriate symbolic constant. +.SH NOTES +If an error is generated, +no change is made to the contents of _param2. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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 +.na +_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(ColorSubTable), +_cmnd(ColorTable), +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), +_cmnd(CopyColorSubTable), +_cmnd(CopyColorTable), +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(GetHistogram), +_cmnd(GetMinmax), +_cmnd(GetTexImage), +_cmnd(PixelMap), +_cmnd(PixelTransfer), +_cmnd(ReadPixels), +_cmnd(SeparableFilter2D), +_cmnd(TexImage1D), +_cmnd(TexImage1D), +_cmnd(TexImage2D) +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getpointerv.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getpointerv.gl new file mode 100644 index 000000000..5e29417c9 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getpointerv.gl @@ -0,0 +1,98 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_C_ the function name must appear in (APIFILE) (usually gl.h) as set in +_C_ Makefile. +_header(GetPointerv, return the address of the specified pointer) +_names(GetPointerv) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the array or buffer pointer to be returned. +Symbolic constants +_const(COLOR_ARRAY_POINTER), +_const(EDGE_FLAG_ARRAY_POINTER), +_const(FEEDBACK_BUFFER_POINTER), +_const(INDEX_ARRAY_POINTER), +_const(NORMAL_ARRAY_POINTER), +_const(TEXTURE_COORD_ARRAY_POINTER), +_const(SELECTION_BUFFER_POINTER), +and +_const(VERTEX_ARRAY_POINTER) +are accepted. +_phead(_param2) +Returns the pointer value specified by _param1. +.SH DESCRIPTION +_cmnd returns pointer information. _param1 +is a symbolic constant indicating the pointer to be returned, and +_param2 is a pointer to a location in which to place the returned data. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +The pointers are all client-side state. +.P +The initial value for each pointer is 0. +.P +When the _arbstring(multitexture) extension is supported, querying the +_const(TEXTURE_COORD_ARRAY_POINTER) returns the value for the active +client texture unit. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.SH SEE ALSO +_C_ no queries or gets listed above, alphabetize commands, +_C_ seperate with commas not .br. no command appears in the associated gets +_C_ as well as in SEE ALSO. +_cmnd(ArrayElement), +_cmnd(ClientActiveTextureARB), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(EdgeFlagPointer), +_cmnd(FeedbackBuffer), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(NormalPointer), +_cmnd(SelectBuffer), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getpolygonstipple.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getpolygonstipple.gl new file mode 100644 index 000000000..2c07bf01e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getpolygonstipple.gl @@ -0,0 +1,69 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GetPolygonStipple,return the polygon stipple pattern) +_names(GetPolygonStipple) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Returns the stipple pattern. The initial value is all 1's. +.SH DESCRIPTION +_cmnd returns to _param1 a $32 ~times~ 32$ polygon stipple pattern. +The pattern is packed into memory as if _cmnd(ReadPixels) +with both \f2height\fP and \f2width\fP of 32, +\f2type\fP of _const(BITMAP), +and \f2format\fP of _const(COLOR_INDEX) were called, +and the stipple pattern were stored in an internal $32 ~times~ 32$ color +index buffer. +Unlike _cmnd(ReadPixels), +however, +pixel transfer operations +(shift, offset, pixel map) +are not applied to the returned stipple image. +.SH NOTES +If an error is generated, +no change is made to the contents of _param1. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(PolygonStipple), +_cmnd(ReadPixels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getseparablefilter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getseparablefilter.gl new file mode 100644 index 000000000..0e340d85a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getseparablefilter.gl @@ -0,0 +1,163 @@ +_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)_C_ +_header(GetSeparableFilter,get separable convolution filter kernel images) +_names(GetSeparableFilter) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__format>@,@<_param2>@)_C_ +_define(@<__type>@,@<_param3>@)_C_ +_define(@<__row>@,@<_param4>@)_C_ +_define(@<__column>@,@<_param5>@)_C_ +_define(@<__span>@,@<_param6>@)_C_ +.SH PARAMETERS +_phead(__target) +The separable filter to be retrieved. +Must be +_const(SEPARABLE_2D). +_phead(__format) +Format of the output images. +Must be one of +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR) +_const(RGBA), +_const(BGRA), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA). +_phead(__type) +Data type of components in the output images. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) +are accepted. +_phead(__row) +Pointer to storage for the row filter image. +_phead(__column) +Pointer to storage for the column filter image. +_phead(__span) +Pointer to storage for the span filter image (currently unused). +.SH DESCRIPTION +_cmnd returns the two one-dimensional filter kernel images for the +current separable 2D convolution filter. +The row image is placed in __row and the column image is placed in +__column according to the specifications in __format and __type. +(In the current implementation, __span is not affected in any way.) +No pixel transfer operations are performed on the images, but the relevant +pixel storage modes are applied. +.sp +Color components that are present in __format but not included in the +internal format of the filters are returned as zero. +The assignments of internal color components to the components of __format +are as follows: +.sp + +.TS +center; +cb cb +l l. +_ +Internal Component Resulting Component +_ +Red Red +Green Green +Blue Blue +Alpha Alpha +Luminance Red +Intensity Red +_ +.TE + +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.P +Non-separable 2D filters must be retrieved with _cmnd(GetConvolutionFilter). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not _const(SEPARABLE_2D). +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and __format is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and __format is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetConvolutionParameter) +.SH SEE ALSO +_cmnd(GetConvolutionFilter), +_cmnd(ConvolutionParameter), +_cmnd(SeparableFilter2D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getstring.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getstring.gl new file mode 100644 index 000000000..5099f97ad --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getstring.gl @@ -0,0 +1,104 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GetString, return a string describing the current GL connection) +_names(GetString) +.SH PARAMETERS +_phead(_param1) +Specifies a symbolic constant, one of +_const(VENDOR), _const(RENDERER), _const(VERSION), or _const(EXTENSIONS). +.SH DESCRIPTION +_cmnd returns a pointer to a static string +describing some aspect of the current GL connection. +_param1 can be one of the following: +.TP 20 +_const(VENDOR) +Returns the company responsible for this GL implementation. +This name does not change from release to release. +.TP +_const(RENDERER) +Returns the name of the renderer. +This name is typically specific to a particular configuration of a hardware +platform. +It does not change from release to release. +.TP +_const(VERSION) +Returns a version or release number. +.TP +_const(EXTENSIONS) +Returns a space-separated list of supported extensions to GL. +.P +Because the GL does not include queries for the performance +characteristics of an implementation, some applications are written to +recognize known platforms and modify their GL usage based on known +performance characteristics of these platforms. +Strings _const(VENDOR) and _const(RENDERER) together uniquely specify +a platform. They do not change from release to release and should be used +by platform-recognition algorithms. +.P +Some applications want to make use of features that +are not part of the standard GL. These features +may be implemented as extensions to the standard GL. +The _const(EXTENSIONS) string is a space-separated +list of supported GL extensions. +(Extension names never contain a space character.) +.P +The _const(VERSION) string begins with a version number. +The version number uses one +of these forms: +.P +\f2major_number.minor_number\fP +.br +\f2major_number.minor_number.release_number\fP +.P +Vendor-specific information may follow the version +number. Its format depends on the implementation, but +a space always separates the version number and +the vendor-specific information. +.P +All strings are null-terminated. +.SH NOTES +If an error is generated, _cmnd returns 0. +.P +The client and server may support different versions or extensions. +_cmnd always returns a compatible version number or list of extensions. +The release number always describes the server. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexenv.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexenv.gl new file mode 100644 index 000000000..c64f44bcb --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexenv.gl @@ -0,0 +1,85 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GetTexEnv,return texture environment parameters) +_names(GetTexEnv,[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) +Returns the requested data. +.SH DESCRIPTION +_cmnd returns in _param3 selected values of a texture environment that +was specified with _cmnd(TexEnv). +_param1 specifies a texture environment. +Currently, only one texture environment is defined and supported: +_const(TEXTURE_ENV). +.P +_param2 names a specific texture environment parameter, as follows: +.TP 10 +_const(TEXTURE_ENV_MODE) +_param3 returns the single-valued texture environment mode, +a symbolic constant. The initial value is _const(MODULATE). +.TP +_const(TEXTURE_ENV_COLOR) +_param3 returns four integer or floating-point values that are the +texture environment color. +Integer values, +when requested, +are linearly mapped from the internal floating-point representation +such that 1.0 maps to the most positive representable integer, +and \-1.0 maps to the most negative representable integer. The initial +value is (0, 0, 0, 0). +.SH NOTES +If an error is generated, +no change is made to the contents of _param3. +.P +When the _arbstring(multitexture) extension is supported, _cmnd returns +the texture environment parameters for the active texture unit. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 or _param2 is not an +accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(TexEnv) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexgen.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexgen.gl new file mode 100644 index 000000000..b5d2c6e75 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexgen.gl @@ -0,0 +1,105 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GetTexGen,return texture coordinate generation parameters) +_names(GetTexGen,[dfi]v) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a texture coordinate. +Must be +_const(S), +_const(T), +_const(R), or +_const(Q). +_phead(_param2) +Specifies the symbolic name of the value(s) to be returned. +Must be either _const(TEXTURE_GEN_MODE) +or the name of one of the texture generation plane equations: +_const(OBJECT_PLANE) or _const(EYE_PLANE). +_phead(_param3) +Returns the requested data. +.SH DESCRIPTION +_cmnd returns in _param3 selected parameters of a texture coordinate +generation function that was specified using _cmnd(TexGen). +_param1 names one of the (\f2s\fP, \f2t\fP, \f2r\fP, \f2q\fP) +texture coordinates, +using the symbolic constant +_const(S), +_const(T), +_const(R), or +_const(Q). +.P +_param2 specifies one of three symbolic names: +.TP 28 +_const(TEXTURE_GEN_MODE) +_param3 returns the single-valued texture generation function, +a symbolic constant. The initial value is _const(EYE_LINEAR). +.TP +_const(OBJECT_PLANE) +_param3 returns the four plane equation coefficients that specify +object linear-coordinate generation. +Integer values, when requested, +are mapped directly from the internal floating-point representation. +.BP +.TP +_const(EYE_PLANE) +_param3 returns the four plane equation coefficients that specify +eye linear-coordinate generation. +Integer values, +when requested, +are mapped directly from the internal floating-point representation. +The returned values are those maintained in eye coordinates. +They are not equal to the values specified using _cmnd(TexGen), +unless the modelview matrix was identity when _cmnd(TexGen) was called. +.SH NOTES +If an error is generated, +no change is made to the contents of _param3. +.P +When the _arbstring(multitexture) extension is supported, _cmnd returns +the texture coordinate generation parameters for the active texture unit. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 or _param2 is not an +accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(TexGen) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getteximage.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getteximage.gl new file mode 100644 index 000000000..2c550c466 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/getteximage.gl @@ -0,0 +1,218 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GetTexImage,return a texture image) +_names(GetTexImage) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies which texture is to be obtained. +_const(TEXTURE_1D), _const(TEXTURE_2D), and _const(TEXTURE_3D) are accepted. +_phead(_param2) +Specifies the level-of-detail number of the desired image. +Level 0 is the base image level. +Level $n$ is the $n$th mipmap reduction image. +_phead(_param3) +Specifies a pixel format for the returned data. +The supported formats are +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(_param4) +Specifies a pixel type for the returned data. +The supported types are +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(_param5) +Returns the texture image. +Should be a pointer to an array of the type specified by _param4. +.SH DESCRIPTION +_cmnd returns a texture image into _param5. +_param1 specifies whether the desired texture image is one specified by +_cmnd(TexImage1D) (_const(TEXTURE_1D)), +_cmnd(TexImage2D) (_const(TEXTURE_2D)), or +_cmnd(TexImage3D) (_const(TEXTURE_3D)). +_param2 specifies the level-of-detail number of the desired image. +_param3 and _param4 specify the format and type of the desired image array. +See the reference pages _cmnd(TexImage1D) and _cmnd(DrawPixels) +for a description of the acceptable values for the _param3 and _param4 +parameters, respectively. +.P +To understand the operation of _cmnd, consider the selected internal +four-component texture image to be an RGBA color buffer the size of the image. +The semantics of _cmnd are then identical to those of _cmnd(ReadPixels), +with the exception that no pixel transfer operations are performed, +when called with the same _param3 and _param4, +with \f2x\fP and \f2y\fP set to 0, +\f2width\fP set to the width of the texture image +(including border if one was specified), +and \f2height\fP set to 1 for 1D images, +or to the height of the texture image +(including border if one was specified) +for 2D images. +.BP +Because the internal texture image is an RGBA image, +pixel formats _const(COLOR_INDEX), +_const(STENCIL_INDEX), +and _const(DEPTH_COMPONENT) are not accepted, +and pixel type _const(BITMAP) is not accepted. +.P +If the selected texture image does not contain four components, +the following mappings are applied. +Single-component textures are treated as RGBA buffers with red set +to the single-component value, +green set to 0, blue set to 0, and alpha set to 1. +Two-component textures are treated as RGBA buffers with red set to +the value of component zero, +alpha set to the value of component one, +and green and blue set to 0. +Finally, +three-component textures are treated as RGBA buffers with red set to +component zero, +green set to component one, +blue set to component two, +and alpha set to 1. +.P +To determine the required size of _param5, +use _cmnd(GetTexLevelParameter) to determine the dimensions of the +internal texture image, +then scale the required number of pixels by the storage required for +each pixel, +based on _param3 and _param4. +Be sure to take the pixel storage parameters into account, +especially _const(PACK_ALIGNMENT). +.SH NOTES +If an error is generated, +no change is made to the contents of _param5. +.P +When the _arbstring(multitexture) extension is supported, _cmnd returns +the texture image for the active texture unit. +.P +The types _const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), +_const(UNSIGNED_INT_2_10_10_10_REV), +and the formats +_const(BGR), and _const(BGRA) are available only if the GL version is +1.2 or greater. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1, _param3, or _param4 is not +an accepted value. +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater +than $log sub 2 max$, +where $max$ is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is returned if _param4 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) and _param3 is not _const(RGB). +.P +_const(INVALID_OPERATION) is returned if _param4 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV), and _param3 is neither _const(RGBA) +or _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetTexLevelParameter) with argument _const(TEXTURE_WIDTH) +.br +_cmnd(GetTexLevelParameter) with argument _const(TEXTURE_HEIGHT) +.br +_cmnd(GetTexLevelParameter) with argument _const(TEXTURE_BORDER) +.br +_cmnd(GetTexLevelParameter) with argument _const(TEXTURE_INTERNALFORMAT) +.br +_cmnd(Get) with arguments _const(PACK_ALIGNMENT) and others +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(DrawPixels), +_cmnd(ReadPixels), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D), +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexlevelparameter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexlevelparameter.gl new file mode 100644 index 000000000..01fdd7d73 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexlevelparameter.gl @@ -0,0 +1,184 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GetTexLevelParameter,return texture parameter values for a specific level of detail) +_names(GetTexLevelParameter,[fi]v) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the symbolic name of the target texture, +either _const(TEXTURE_1D), _const(TEXTURE_2D), _const(TEXTURE_3D), +_const(PROXY_TEXTURE_1D), _const(PROXY_TEXTURE_2D), or +_const(PROXY_TEXTURE_3D). +_phead(_param2) +Specifies the level-of-detail number of the desired image. +Level 0 is the base image level. +Level $n$ is the $n$th mipmap reduction image. +_phead(_param3) +Specifies the symbolic name of a texture parameter. +_const(TEXTURE_WIDTH), +_const(TEXTURE_HEIGHT), +_const(TEXTURE_DEPTH), +_const(TEXTURE_INTERNAL_FORMAT), +_const(TEXTURE_BORDER), +_const(TEXTURE_RED_SIZE), +_const(TEXTURE_GREEN_SIZE), +_const(TEXTURE_BLUE_SIZE), +_const(TEXTURE_ALPHA_SIZE), +_const(TEXTURE_LUMINANCE_SIZE), and +_const(TEXTURE_INTENSITY_SIZE) are accepted. +_phead(_param4) +Returns the requested data. +.SH DESCRIPTION +_cmnd returns in _param4 texture parameter values for a specific +level-of-detail value, +specified as _param2. +_param1 defines the target texture, +either _const(TEXTURE_1D), _const(TEXTURE_2D), _const(TEXTURE_3D), +_const(PROXY_TEXTURE_1D), +_const(PROXY_TEXTURE_2D), or +_const(PROXY_TEXTURE_3D). +.BR +.P +_const(MAX_TEXTURE_SIZE), and _const(MAX_3D_TEXTURE_SIZE) are not really +descriptive enough. +It has to report the largest square texture image that can be +accommodated with mipmaps and borders, +but a long skinny texture, or a texture without mipmaps and borders, may +easily fit in texture memory. +The proxy targets allow the user to more accurately query +whether the GL can accommodate a texture of a given configuration. +If the texture cannot be accommodated, the texture state variables, which +may be queried with _cmnd, are set to 0. If the texture can be accommodated, +the texture state values will be set as they would be set for a +non-proxy target. +.P +_param3 specifies the texture parameter whose value or values +will be returned. +.P +The accepted parameter names are as follows: +.TP 10 +_const(TEXTURE_WIDTH) +_param4 returns a single value, +the width of the texture image. +This value includes the border of the texture image. The initial value is +0. +.TP +_const(TEXTURE_HEIGHT) +_param4 returns a single value, +the height of the texture image. +This value includes the border of the texture image. The initial value is +0. +.TP +_const(TEXTURE_DEPTH) +_param4 returns a single value, +the depth of the texture image. +This value includes the border of the texture image. The initial value is +0. +.TP +_const(TEXTURE_INTERNAL_FORMAT) +_param4 returns a single value, +the internal format of the texture image. +.TP +_const(TEXTURE_BORDER) +_param4 returns a single value, +the width in pixels of the border of the texture image. The initial value +is 0. +.TP +_const(TEXTURE_RED_SIZE), +.TP +_const(TEXTURE_GREEN_SIZE), +.TP +_const(TEXTURE_BLUE_SIZE), +.TP +_const(TEXTURE_ALPHA_SIZE), +.TP +_const(TEXTURE_LUMINANCE_SIZE), +.TP +_const(TEXTURE_INTENSITY_SIZE) +The internal storage resolution of an individual component. +The resolution chosen by the GL will be a close match for the resolution +requested by the user with the component argument of _cmnd(TexImage1D), +_cmnd(TexImage2D), _cmnd(TexImage3D), _cmnd(CopyTexImage1D), and +_cmnd(CopyTexImage2D). The initial value is 0. +.SH NOTES +If an error is generated, +no change is made to the contents of _param4. +.P +_const(TEXTURE_INTERNAL_FORMAT) is available only if the GL version is +1.1 or greater. In version 1.0, use _const(TEXTURE_COMPONENTS) +instead. +.P +_const(PROXY_TEXTURE_1D) and _const(PROXY_TEXTURE_2D) are +available only if the GL version is 1.1 or greater. +.P +_const(TEXTURE_3D), _const(PROXY_TEXTURE_3D), and _const(TEXTURE_DEPTH) +are available only if the GL version is 1.2 or greater. +.P +When the _arbstring(multitexture) extension is supported, _cmnd returns +the texture level parameters for the active texture unit. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 or _param3 is not an +accepted value. +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater +than $ log sub 2$ \f2max\fP, +where \f2max\fP is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(GetTexParameter), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D), +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexparameter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexparameter.gl new file mode 100644 index 000000000..85d3d71d4 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/gettexparameter.gl @@ -0,0 +1,147 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(GetTexParameter,return texture parameter values) +_names(GetTexParameter,[fi]v) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the symbolic name of the target texture. +_const(TEXTURE_1D),_const(TEXTURE_2D), and _const(TEXTURE_3D) are accepted. +_phead(_param2) +Specifies the symbolic name of a texture parameter. +_const(TEXTURE_MAG_FILTER), +_const(TEXTURE_MIN_FILTER), +_const(TEXTURE_MIN_LOD), +_const(TEXTURE_MAX_LOD), +_const(TEXTURE_BASE_LEVEL), +_const(TEXTURE_MAX_LEVEL), +_const(TEXTURE_WRAP_S), +_const(TEXTURE_WRAP_T), +_const(TEXTURE_WRAP_R), +_const(TEXTURE_BORDER_COLOR), +_const(TEXTURE_PRIORITY), and +_const(TEXTURE_RESIDENT) are accepted. +_phead(_param3) +Returns the texture parameters. +.SH DESCRIPTION +_cmnd returns in _param3 the value or values of the texture parameter +specified as _param2. +_param1 defines the target texture, +either _const(TEXTURE_1D), _const(TEXTURE_2D), or _const(TEXTURE_3D) +to specify one-, two-, or three-dimensional texturing. +_param2 accepts the same symbols as _cmnd(TexParameter), +with the same interpretations: +.TP 35 +_const(TEXTURE_MAG_FILTER) +Returns the single-valued texture magnification filter, +a symbolic constant. The initial value is _const(LINEAR). +.TP +_const(TEXTURE_MIN_FILTER) +Returns the single-valued texture minification filter, +a symbolic constant. The initial value is _const(NEAREST_MIPMAP_LINEAR). +.TP +_const(TEXTURE_MIN_LOD) +Returns the single-valued texture minimum level-of-detail value. The +initial value is $-1000$. +.TP +_const(TEXTURE_MAX_LOD) +Returns the single-valued texture maximum level-of-detail value. The +initial value is 1000. +.TP +_const(TEXTURE_BASE_LEVEL) +Returns the single-valued base texture mipmap level. The initial value is 0. +.TP +_const(TEXTURE_MAX_LEVEL) +Returns the single-valued maximum texture mipmap array level. The initial +value is 1000. +.TP +_const(TEXTURE_WRAP_S) +Returns the single-valued wrapping function for texture coordinate $s$, +a symbolic constant. The initial value is _const(REPEAT). +.TP +_const(TEXTURE_WRAP_T) +Returns the single-valued wrapping function for texture coordinate $t$, +a symbolic constant. The initial value is _const(REPEAT). +.TP +_const(TEXTURE_WRAP_R) +Returns the single-valued wrapping function for texture coordinate $r$, +a symbolic constant. The initial value is _const(REPEAT). +.BP +.TP +_const(TEXTURE_BORDER_COLOR) +Returns four integer or floating-point numbers that comprise the RGBA color +of the texture border. +Floating-point values are returned in the range [0, 1]. +Integer values are returned as a linear mapping of the internal floating-point +representation such that 1.0 maps to the most positive representable +integer and \-1.0 maps to the most negative representable +integer. The initial value is (0, 0, 0, 0). +.TP +_const(TEXTURE_PRIORITY) +Returns the residence priority of the target texture (or the named +texture bound to it). The initial value is 1. +See _cmnd(PrioritizeTextures). +.TP +_const(TEXTURE_RESIDENT) +Returns the residence status of the target texture. +If the value returned in _param3 is _const(TRUE), the texture is +resident in texture memory. +See _cmnd(AreTexturesResident). +.SH NOTES +_const(TEXTURE_PRIORITY) and _const(TEXTURE_RESIDENT) are +available only if the GL version is 1.1 or greater. +.P +_const(TEXTURE_3D), +_const(TEXTURE_MIN_LOD), _const(TEXTURE_MAX_LOD), _const(TEXTURE_BASE_LEVEL), +_const(TEXTURE_MAX_LEVEL), and _const(TEXTURE_WRAP_R) are available only +if the GL version is 1.2 or greater. +.P +If an error is generated, +no change is made to the contents of _param3. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 or _param2 is not an +accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(AreTexturesResident), +_cmnd(PrioritizeTextures), +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/hint.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/hint.gl new file mode 100644 index 000000000..97b113562 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/hint.gl @@ -0,0 +1,118 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Hint,specify implementation-specific hints) +_names(Hint) +.SH PARAMETERS +_phead(_param1) +Specifies a symbolic constant indicating the behavior to be controlled. +_const(FOG_HINT), +_const(LINE_SMOOTH_HINT), +_const(PERSPECTIVE_CORRECTION_HINT), +_const(POINT_SMOOTH_HINT), and +_const(POLYGON_SMOOTH_HINT) are accepted. +_phead(_param2) +Specifies a symbolic constant indicating the desired behavior. +_const(FASTEST), +_const(NICEST), and +_const(DONT_CARE) are accepted. +.SH DESCRIPTION +Certain aspects of GL behavior, +when there is room for interpretation, +can be controlled with hints. +A hint is specified with two arguments. +_param1 is a symbolic +constant indicating the behavior to be controlled, +and _param2 is another symbolic constant indicating the desired +behavior. The initial value for each _param1 is _const(DONT_CARE). +_param2 can be one of the following: +.TP 20 +_const(FASTEST) +The most efficient option should be chosen. +.TP +_const(NICEST) +The most correct, +or highest quality, +option should be chosen. +.TP +_const(DONT_CARE) +No preference. +.P +Though the implementation aspects that can be hinted are well defined, +the interpretation of the hints depends on the implementation. +The hint aspects that can be specified with _param1, +along with suggested semantics, +are as follows: +.TP 20 +_const(FOG_HINT) +Indicates the accuracy of fog calculation. +If per-pixel fog calculation is not efficiently supported +by the GL implementation, +hinting _const(DONT_CARE) or _const(FASTEST) can result in per-vertex +calculation of fog effects. +.TP +_const(LINE_SMOOTH_HINT) +Indicates the sampling quality of antialiased lines. +If a larger filter function is applied, hinting _const(NICEST) can +result in more pixel fragments being generated during rasterization, +.TP +_const(PERSPECTIVE_CORRECTION_HINT) +Indicates the quality of color and texture coordinate interpolation. +If perspective-corrected parameter interpolation is not efficiently supported +by the GL implementation, +hinting _const(DONT_CARE) or _const(FASTEST) can result in simple linear +interpolation of colors and/or texture coordinates. +.TP +_const(POINT_SMOOTH_HINT) +Indicates the sampling quality of antialiased points. +If a larger filter function is applied, hinting _const(NICEST) can +result in more pixel fragments being generated during rasterization, +.TP +_const(POLYGON_SMOOTH_HINT) +Indicates the sampling quality of antialiased polygons. +Hinting _const(NICEST) can result in more pixel fragments being generated +during rasterization, +if a larger filter function is applied. +.SH NOTES +The interpretation of hints depends on the implementation. +Some implementations ignore _cmnd(Hint) settings. +.SH ERRORS +_const(INVALID_ENUM) is generated if either _param1 or _param2 is not +an accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/histogram.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/histogram.gl new file mode 100644 index 000000000..011a0782e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/histogram.gl @@ -0,0 +1,151 @@ +_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(Histogram,define histogram table) +_names(Histogram) +.EQ +delim $$ +.EN +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__width>@,@<_param2>@)_C_ +_define(@<__internalformat>@,@<_param3>@)_C_ +_define(@<__sink>@,@<_param4>@)_C_ +.SH PARAMETERS +_phead(__target) +The histogram whose parameters are to be set. +Must be one of +_const(HISTOGRAM) or +_const(PROXY_HISTOGRAM). +_phead(__width) +The number of entries in the histogram table. Must be a power of 2. +_phead(__internalformat) +The format of entries in the histogram table. +Must be one of +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(__sink) +If _const(TRUE), pixels will be consumed by the histogramming +process and no drawing or texture loading will take place. +If _const(FALSE), pixels will proceed to the minmax process after +histogramming. +.SH DESCRIPTION +When _const(HISTOGRAM) is enabled, RGBA color components are converted to +histogram table indices by clamping to the range [0,1], multiplying by +the width of the histogram table, and rounding to the nearest integer. +The table entries selected by the RGBA indices are then incremented. +(If the internal format of the histogram table includes luminance, then +the index derived from the R color component determines the luminance +table entry to be incremented.) If a histogram table entry is incremented +beyond its maximum value, then its value becomes undefined. (This is +not an error.) +.PP +Histogramming is performed only for RGBA pixels (though these may +be specified originally as color indices and converted to RGBA by +index table lookup). +Histogramming is enabled with _cmnd(Enable) and disabled with _cmnd(Disable). +.PP +When __target is _const(HISTOGRAM), _cmnd redefines the current +histogram table to have __width entries of the format specified by +__internalformat. +The entries are indexed 0 through $_eqnparam2 ~-~ 1$, and +all entries are initialized to zero. +The values in the previous histogram table, if any, are lost. +If __sink is _const(TRUE), then pixels are discarded after histogramming; +no further processing of the pixels takes place, and no drawing, +texture loading, or pixel readback will result. +.PP +When __target is _const(PROXY_HISTOGRAM), _cmnd computes all +state information as if the histogram table were to be redefined, +but does not actually define the new table. +If the requested histogram table is too large to be supported, then the +state information will be set to zero. +This provides a way to determine if a histogram table with the given +parameters can be supported. +.PP +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_VALUE) is generated if __width is less than zero or is +not a power of 2. +.P +_const(INVALID_ENUM) is generated if __internalformat is not one of the +allowable values. +.P +_const(TABLE_TOO_LARGE) is generated if __target is _const(HISTOGRAM) +and the histogram table specified is too large for the implementation. +.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(GetHistogramParameter) +.SH SEE ALSO +_cmnd(GetHistogram), +_cmnd(ResetHistogram) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/index.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/index.gl new file mode 100644 index 000000000..6d52d3b06 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/index.gl @@ -0,0 +1,77 @@ +_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(Index,set the current color index) +.P +_names(Index,u*[bsifd]) +.SH PARAMETERS +_phead(_param1) +Specifies the new value for the current color index. +.P +_names(Index,u*[bsifd]v) +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to a one-element array that contains +the new value for the current color index. +.SH DESCRIPTION +_cmnd updates the current (single-valued) color index. +It takes one argument, the new value for the current color index. +.P +The current index is stored as a floating-point value. +Integer values are converted directly to floating-point values, +with no special mapping. +The initial value is 1. +.P +Index values outside the representable range of the color index buffer +are not clamped. +However, +before an index is dithered (if enabled) and written to the frame buffer, +it is converted to fixed-point format. +Any bits in the integer portion of the resulting fixed-point value +that do not correspond to bits in the frame buffer are masked out. +.SH NOTES +_cmnd(Indexub) and _cmnd(Indexubv) are available only if the GL version is +1.1 or greater. +.P +The current index can be updated at any time. +In particular, +_cmnd can be called between a call to _cmnd(Begin) and the corresponding +call to _cmnd(End). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(CURRENT_INDEX) +.SH SEE ALSO +_cmnd(Color), +_cmnd(IndexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/indexmask.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/indexmask.gl new file mode 100644 index 000000000..239dbdf04 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/indexmask.gl @@ -0,0 +1,74 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(IndexMask,control the writing of individual bits in the color index buffers) +_names(IndexMask) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a bit mask to enable and disable the writing of individual bits +in the color index buffers. +Initially, the mask is all 1's. +.SH DESCRIPTION +_cmnd controls the writing of individual bits in the color index buffers. +The least significant $n$ bits of _param1, +where $n$ is the number of bits in a color index buffer, +specify a mask. +Where a 1 (one) appears in the mask, +it's possible to write to the corresponding bit in the color index +buffer (or buffers). +Where a 0 (zero) appears, +the corresponding bit is write-protected. +.P +This mask is used only in color index mode, +and it affects only the buffers currently selected for writing +(see _cmnd(DrawBuffer)). +Initially, all bits are enabled for writing. +.SH ERRORS +_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(Get) with argument _const(INDEX_WRITEMASK) +.SH SEE ALSO +_cmnd(ColorMask), +_cmnd(DepthMask), +_cmnd(DrawBuffer), +_cmnd(Index), +_cmnd(IndexPointer), +_cmnd(StencilMask) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/indexpointer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/indexpointer.gl new file mode 100644 index 000000000..fa8c1026b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/indexpointer.gl @@ -0,0 +1,138 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_C_ the function name must appear in (APIFILE) (usually gl.h) as set in +_C_ Makefile. +_header(IndexPointer,define an array of color indexes) +_names(IndexPointer) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the data type of each color index in the array. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(SHORT), +_const(INT), +_const(FLOAT), +and _const(DOUBLE) +are accepted. The initial value is _const(FLOAT). +_phead(_param2) +Specifies the byte offset between consecutive color indexes. +If _param2 is 0 (the initial value), the color indexes are understood to +be tightly packed in the array. +The initial value is 0. +_phead(_param3) +Specifies a pointer to the first index in the array. +The initial value is 0. +.SH DESCRIPTION +_cmnd specifies the location and data format of an array of color indexes +to use when rendering. +_param1 specifies the data type of +each color index and _param2 gives the byte stride from one +color index to the next allowing vertices and attributes +to be packed into a single array or stored in separate arrays. +(Single-array storage may be more efficient on some implementations; +see _cmnd(InterleavedArrays).) +.P +_param1, _param2, and _param3 are saved as client-side +state. +.P +The color index array is initially disabled. To enable and disable +the array, call _cmnd(EnableClientState) and +_cmnd(DisableClientState) with the argument _const(INDEX_ARRAY). If +enabled, the color index array is used when _cmnd(DrawArrays), +_cmnd(DrawElements) or _cmnd(ArrayElement) is called. +.P +Use _cmnd(DrawArrays) to construct a sequence of primitives (all of +the same type) from prespecified vertex and vertex attribute arrays. +Use _cmnd(ArrayElement) to specify primitives +by indexing vertices and vertex attributes and _cmnd(DrawElements) to +construct a sequence of primitives by indexing vertices and vertex attributes. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +The color index array is initially disabled, and it isn't accessed when +_cmnd(ArrayElement), _cmnd(DrawElements), or _cmnd(DrawArrays) is called. +.P +Execution of _cmnd is not allowed between +_cmnd(Begin) and the corresponding _cmnd(End), +but an error may or may not be generated. If an error is not generated, +the operation is undefined. +.P +_cmnd is typically implemented on the client side. +.P +Since the color index array parameters are client-side state, they are +not saved or restored by _cmnd(PushAttrib) and _cmnd(PopAttrib). +Use _cmnd(PushClientAttrib) and +_cmnd(PopClientAttrib) instead. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param2 is negative. +.SH ASSOCIATED GETS +_cmnd(IsEnabled) with argument _const(INDEX_ARRAY) +.br +_cmnd(Get) with argument _const(INDEX_ARRAY_TYPE) +.br +_cmnd(Get) with argument _const(INDEX_ARRAY_STRIDE) +.br +_cmnd(GetPointerv) with argument _const(INDEX_ARRAY_POINTER) +.SH SEE ALSO +_C_ no queries or gets listed above, alphabetize commands, +_C_ seperate with commas not .br. no command appears in the associated gets +_C_ as well as in SEE ALSO. +_cmnd(ArrayElement), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(EdgeFlagPointer), +_cmnd(Enable), +_cmnd(GetPointerv), +_cmnd(InterleavedArrays), +_cmnd(NormalPointer), +_cmnd(PopClientAttrib), +_cmnd(PushClientAttrib), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/initnames.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/initnames.gl new file mode 100644 index 000000000..1316454be --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/initnames.gl @@ -0,0 +1,57 @@ +_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 +_header(InitNames,initialize the name stack) +_names(InitNames) +.SH DESCRIPTION +The name stack is used during selection mode to allow sets of rendering +commands to be uniquely identified. +It consists of an ordered set of unsigned integers. +_cmnd causes the name stack to be initialized to its default empty state. +.P +The name stack is always empty while the render mode is not _const(SELECT). +Calls to _cmnd while the render mode is not _const(SELECT) are ignored. +.SH ERRORS +_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(Get) with argument _const(NAME_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(MAX_NAME_STACK_DEPTH) +.SH SEE ALSO +_cmnd(LoadName), +_cmnd(PushName), +_cmnd(RenderMode), +_cmnd(SelectBuffer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/interleavedarrays.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/interleavedarrays.gl new file mode 100644 index 000000000..0f8dfecdb --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/interleavedarrays.gl @@ -0,0 +1,130 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word +_C_ and don't use a period. +_header(InterleavedArrays, simultaneously specify and enable several interleaved arrays) +_names(InterleavedArrays) +.SH PARAMETERS +_phead(_param1) +Specifies the type of array to enable. Symbolic constants +_const(V2F), +_const(V3F), +_const(C4UB_V2F), +_const(C4UB_V3F), +_const(C3F_V3F), +_const(N3F_V3F), +_const(C4F_N3F_V3F), +_const(T2F_V3F), +_const(T4F_V4F), +_const(T2F_C4UB_V3F), +_const(T2F_C3F_V3F), +_const(T2F_N3F_V3F), +_const(T2F_C4F_N3F_V3F), +and +_const(T4F_C4F_N3F_V4F) +are accepted. +_phead(_param2) +Specifies the offset in bytes between each aggregate array element. +.SH DESCRIPTION +_cmnd lets you specify and enable individual color, +normal, +texture and vertex +arrays whose elements are part of a larger aggregate array element. +For some implementations, this is more efficient than specifying the arrays +separately. +.P +If _param2 is 0, the aggregate elements are stored consecutively. +Otherwise, _param2 bytes occur between the beginning of one +aggregate array element and the beginning of the next aggregate array +element. +.P +_param1 serves as a ``key'' +describing the extraction of individual arrays from the aggregate array. +If _param1 contains a T, then texture coordinates are +extracted from the interleaved array. If C is present, color values +are extracted. If N is present, normal coordinates are extracted. +Vertex coordinates are always extracted. +.P +The digits 2, 3, and 4 denote how many values are extracted. +F indicates that values are extracted as floating-point values. +Colors may also be extracted as 4 unsigned bytes if 4UB follows the +C. If a color is extracted as 4 unsigned bytes, the vertex +array element which follows is located at the first possible +floating-point aligned address. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +If _cmnd is called while compiling a display list, it is not +compiled into the list, and it is executed immediately. +.P +Execution of _cmnd is not allowed between the execution of +_cmnd(Begin) and the corresponding execution of _cmnd(End), +but an error may or may not be generated. If no error is generated, +the operation is undefined. +.P +_cmnd is typically implemented on the client side. +.P +Vertex array parameters are client-side state and are therefore not +saved or restored by _cmnd(PushAttrib) and _cmnd(PopAttrib). +Use _cmnd(PushClientAttrib) and _cmnd(PopClientAttrib) instead. +.P +When the _arbstring(multitexture) extension is supported, _cmnd +only updates the texture coordinate array for the active active texture +unit. The texture coordinate state for other client texture units is not +update, regardless if they are enabled or not. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param2 is negative. +.SH SEE ALSO +_cmnd(ArrayElement), +_cmnd(ClientActiveTextureARB), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(EdgeFlagPointer), +_cmnd(EnableClientState), +_cmnd(GetPointer), +_cmnd(IndexPointer), +_cmnd(NormalPointer), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/isenabled.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/isenabled.gl new file mode 100644 index 000000000..a5cf7e5fc --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/isenabled.gl @@ -0,0 +1,177 @@ +_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,eqn|tbl)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(IsEnabled, test whether a capability is enabled) +_names(IsEnabled) +.SH PARAMETERS +_phead(_param1) +Specifies a symbolic constant indicating a GL capability. +.SH DESCRIPTION +_cmnd returns _const(TRUE) if _param1 is an enabled capability +and returns _const(FALSE) otherwise. +Initially all capabilities except _const(DITHER) are disabled; +_const(DITHER) is initially enabled. +.P +The following capabilities are accepted for _param1: +.P + +.TS +lb lb +l l. +_ +Constant See +_ +_const(ALPHA_TEST) _cmnd(AlphaFunc) +_const(AUTO_NORMAL) _cmnd(EvalCoord) +_const(BLEND) _cmnd(BlendFunc), _cmnd(LogicOp) +_const(CLIP_PLANE)\f2i\fP _cmnd(ClipPlane) +_const(COLOR_ARRAY) _cmnd(ColorPointer) +_const(COLOR_LOGIC_OP) _cmnd(LogicOp) +_const(COLOR_MATERIAL) _cmnd(ColorMaterial) +_const(COLOR_TABLE) _cmnd(ColorTable) +_const(CONVOLUTION_1D) _cmnd(ConvolutionFilter1D) +_const(CONVOLUTION_2D) _cmnd(ConvolutionFilter2D) +_const(CULL_FACE) _cmnd(CullFace) +_const(DEPTH_TEST) _cmnd(DepthFunc), _cmnd(DepthRange) +_const(DITHER) _cmnd(Enable) +_const(EDGE_FLAG_ARRAY) _cmnd(EdgeFlagPointer) +_const(FOG) _cmnd(Fog) +_const(HISTOGRAM) _cmnd(Histogram) +_const(INDEX_ARRAY) _cmnd(IndexPointer) +_const(INDEX_LOGIC_OP) _cmnd(LogicOp) +_const(LIGHT)\f2i\fP _cmnd(LightModel), _cmnd(Light) +_const(LIGHTING) _cmnd(Material), _cmnd(LightModel), _cmnd(Light) +_const(LINE_SMOOTH) _cmnd(LineWidth) +_const(LINE_STIPPLE) _cmnd(LineStipple) +_const(MAP1_COLOR_4) _cmnd(Map1) +_const(MAP1_INDEX) _cmnd(Map1) +_const(MAP1_NORMAL) _cmnd(Map1) +_const(MAP1_TEXTURE_COORD_1) _cmnd(Map1) +_const(MAP1_TEXTURE_COORD_2) _cmnd(Map1) +_const(MAP1_TEXTURE_COORD_3) _cmnd(Map1) +_const(MAP1_TEXTURE_COORD_4) _cmnd(Map1) +_const(MAP2_COLOR_4) _cmnd(Map2) +_const(MAP2_INDEX) _cmnd(Map2) +_const(MAP2_NORMAL) _cmnd(Map2) +_const(MAP2_TEXTURE_COORD_1) _cmnd(Map2) +_const(MAP2_TEXTURE_COORD_2) _cmnd(Map2) +_const(MAP2_TEXTURE_COORD_3) _cmnd(Map2) +_const(MAP2_TEXTURE_COORD_4) _cmnd(Map2) +_const(MAP2_VERTEX_3) _cmnd(Map2) +_const(MAP2_VERTEX_4) _cmnd(Map2) +_const(MINMAX) _cmnd(Minmax) +_const(NORMAL_ARRAY) _cmnd(NormalPointer) +_const(NORMALIZE) _cmnd(Normal) +_const(POINT_SMOOTH) _cmnd(PointSize) +_const(POLYGON_SMOOTH) _cmnd(PolygonMode) +_const(POLYGON_OFFSET_FILL) _cmnd(PolygonOffset) +_const(POLYGON_OFFSET_LINE) _cmnd(PolygonOffset) +_const(POLYGON_OFFSET_POINT) _cmnd(PolygonOffset) +_const(POLYGON_STIPPLE) _cmnd(PolygonStipple) +_const(POST_COLOR_MATRIX_COLOR_TABLE) _cmnd(ColorTable) +_const(POST_CONVOLUTION_COLOR_TABLE) _cmnd(ColorTable) +_const(RESCALE_NORMAL) _cmnd(Normal) +_const(SCISSOR_TEST) _cmnd(Scissor) +_const(SEPARABLE_2D) _cmnd(SeparableFilter2D) +_const(STENCIL_TEST) _cmnd(StencilFunc), _cmnd(StencilOp) +_const(TEXTURE_1D) _cmnd(TexImage1D) +_const(TEXTURE_2D) _cmnd(TexImage2D) +_const(TEXTURE_3D) _cmnd(TexImage3D) +_const(TEXTURE_COORD_ARRAY) _cmnd(TexCoordPointer) +_const(TEXTURE_GEN_Q) _cmnd(TexGen) +_const(TEXTURE_GEN_R) _cmnd(TexGen) +_const(TEXTURE_GEN_S) _cmnd(TexGen) +_const(TEXTURE_GEN_T) _cmnd(TexGen) +_const(VERTEX_ARRAY) _cmnd(VertexPointer) +_ +.TE + +.SH NOTES +If an error is generated, +_cmnd returns 0. +.P +_const(COLOR_LOGIC_OP), +_const(COLOR_ARRAY), +_const(EDGE_FLAG_ARRAY), +_const(INDEX_ARRAY), +_const(INDEX_LOGIC_OP), +_const(NORMAL_ARRAY), +_const(POLYGON_OFFSET_FILL), +_const(POLYGON_OFFSET_LINE), +_const(POLYGON_OFFSET_POINT), +_const(TEXTURE_COORD_ARRAY), and +_const(VERTEX_ARRAY) +are available only +if the GL version is 1.1 or greater +.P +_const(RESCALE_NORMAL), and _const(TEXTURE_3D) are available only if the GL +version is 1.2 or greater. +.P +_const(COLOR_TABLE), _const(CONVOLUTION_1D), _const(CONVOLUTION_2D), +_const(HISTOGRAM), _const(MINMAX), +_const(POST_COLOR_MATRIX_COLOR_TABLE), +_const(POST_CONVOLUTION_COLOR_TABLE), and +_const(SEPARABLE_2D) are available only if _arbstring(imaging) is +returned when _cmnd(Get) is called with _const(EXTENSIONS). +.P +When the _arbstring(multitexture) extension is supported, the following +parameters return the associated value for the active texture unit. +_const(TEXTURE_1D), _const(TEXTURE_BINDING_1D), +_const(TEXTURE_2D), _const(TEXTURE_BINDING_2D), +_const(TEXTURE_3D), _const(TEXTURE_BINDING_3D), +_const(TEXTURE_GEN_S), +_const(TEXTURE_GEN_T), +_const(TEXTURE_GEN_R), +_const(TEXTURE_GEN_Q), +_const(TEXTURE_MATRIX), and +_const(TEXTURE_STACK_DEPTH). +Likewise, the following parameters return the associated value for the +active client texture unit: +_const(TEXTURE_COORD_ARRAY), +_const(TEXTURE_COORD_ARRAY_SIZE), +_const(TEXTURE_COORD_ARRAY_STRIDE), +_const(TEXTURE_COORD_ARRAY_TYPE). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(Enable), +_cmnd(EnableClientState), +_cmnd(Get) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/islist.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/islist.gl new file mode 100644 index 000000000..0bb918aac --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/islist.gl @@ -0,0 +1,55 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(IsList,determine if a name corresponds to a display-list) +_names(IsList) +.SH PARAMETERS +_phead(_param1) +Specifies a potential display-list name. +.SH DESCRIPTION +_cmnd returns _const(TRUE) if _param1 is the name +of a display list and returns _const(FALSE) otherwise. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of +_cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(CallList), +_cmnd(CallLists), +_cmnd(DeleteLists), +_cmnd(GenLists), +_cmnd(NewList) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/istexture.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/istexture.gl new file mode 100644 index 000000000..6358162e4 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/istexture.gl @@ -0,0 +1,63 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(IsTexture,determine if a name corresponds to a texture) +_names(IsTexture) +.SH PARAMETERS +_phead(_param1) +Specifies a value that may be the name of a texture. +.SH DESCRIPTION +_cmnd returns _const(TRUE) if _param1 is currently the name of a texture. +If _param1 is zero, or is a non-zero value that is not currently the +name of a texture, or if an error occurs, _cmnd returns _const(FALSE). +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.SH SEE ALSO +_cmnd(BindTexture), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(DeleteTextures), +_cmnd(GenTextures), +_cmnd(Get), +_cmnd(GetTexParameter), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/light.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/light.gl new file mode 100644 index 000000000..3b6da035d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/light.gl @@ -0,0 +1,240 @@ +_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(Light,set light source parameters) +_names(Light,[fi]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a light. +The number of lights depends on the implementation, +but at least eight lights are supported. +They are identified by symbolic names of the form _const(LIGHT)$i$ +where 0 \(<= $ i $ < _const(MAX_LIGHTS). +_phead(_param2) +Specifies a single-valued light source parameter for _param1. +_const(SPOT_EXPONENT), +_const(SPOT_CUTOFF), +_const(CONSTANT_ATTENUATION), +_const(LINEAR_ATTENUATION), and +_const(QUADRATIC_ATTENUATION) are accepted. +_phead(_param3) +Specifies the value that parameter _param2 of light source _param1 +will be set to. +_names(Light,[fi]v) +.SH PARAMETERS +_phead(_param1) +Specifies a light. +The number of lights depends on the implementation, but +at least eight lights are supported. +They are identified by symbolic names of the form _const(LIGHT)$i$ +where 0 \(<= $ i $ < _const(MAX_LIGHTS). +_phead(_param2) +Specifies a light source parameter for _param1. +_const(AMBIENT), +_const(DIFFUSE), +_const(SPECULAR), +_const(POSITION), +_const(SPOT_CUTOFF), +_const(SPOT_DIRECTION), +_const(SPOT_EXPONENT), +_const(CONSTANT_ATTENUATION), +_const(LINEAR_ATTENUATION), and +_const(QUADRATIC_ATTENUATION) are accepted. +_phead(_param3) +Specifies a pointer to the value or values that parameter _param2 +of light source _param1 will be set to. +.SH DESCRIPTION +_cmnd sets the values of individual light source parameters. +_param1 names the light and is a symbolic name of the form _const(LIGHT)$i$, +where 0 \(<= i < _const(MAX_LIGHTS). +_param2 specifies one of ten light source parameters, +again by symbolic name. +_param3 is either a single value or a pointer to an array that contains +the new values. +.P +To enable and disable lighting calculation, call _cmnd(Enable) +and _cmnd(Disable) with argument _const(LIGHTING). Lighting is +initially disabled. +When it is enabled, +light sources that are enabled contribute to the lighting calculation. +Light source $i$ is enabled and disabled using _cmnd(Enable) and +_cmnd(Disable) with argument _const(LIGHT)$i$. +.P +The ten light parameters are as follows: +.TP 20 +_const(AMBIENT) +_param3 contains four integer or floating-point values that specify +the ambient RGBA intensity of the light. +Integer values are mapped linearly such that the most positive representable +value maps to 1.0, +and the most negative representable value maps to \-1.0. +Floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +The initial ambient light intensity is (0, 0, 0, 1). +.TP +_const(DIFFUSE) +_param3 contains four integer or floating-point values that specify +the diffuse RGBA intensity of the light. +Integer values are mapped linearly such that the most positive representable +value maps to 1.0, +and the most negative representable value maps to \-1.0. +Floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +The initial value +for _const(LIGHT0) is (1, 1, 1, 1); for other lights, the +initial value is (0, 0, 0, 0). +.TP +_const(SPECULAR) +_param3 contains four integer or floating-point values that specify +the specular RGBA intensity of the light. +Integer values are mapped linearly such that the most positive representable +value maps to 1.0, +and the most negative representable value maps to \-1.0. +Floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +The initial value +for _const(LIGHT0) is (1, 1, 1, 1); for other lights, the +initial value is (0, 0, 0, 0). +.TP +_const(POSITION) +_param3 contains four integer or floating-point values that specify +the position of the light in homogeneous object coordinates. +Both integer and floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +.IP +The position is transformed by the modelview matrix when +_cmnd is called (just as if it were a point), +and it is stored in eye coordinates. +If the $w$ component of the position is 0, +the light is treated as a directional source. +Diffuse and specular lighting calculations take the light's direction, +but not its actual position, +into account, +and attenuation is disabled. +Otherwise, +diffuse and specular lighting calculations are based on the actual location +of the light in eye coordinates, +and attenuation is enabled. +The initial position is (0, 0, 1, 0); +thus, the initial light source is directional, +parallel to, and in the direction of the $-z$ axis. +.TP +_const(SPOT_DIRECTION) +_param3 contains three integer or floating-point values that specify +the direction of the light in homogeneous object coordinates. +Both integer and floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +.IP +The spot direction is transformed by the inverse of the modelview matrix when +_cmnd is called (just as if it were a normal), +and it is stored in eye coordinates. +It is significant only when _const(SPOT_CUTOFF) is not 180, +which it is initially. +The initial direction is (0, 0, \-1). +.TP +_const(SPOT_EXPONENT) +_param3 is a single integer or floating-point value that specifies +the intensity distribution of the light. +Integer and floating-point values are mapped directly. +Only values in the range [0,128] are accepted. +.IP +Effective light intensity is attenuated by the cosine of the angle between +the direction of the light and the direction from the light to the vertex +being lighted, +raised to the power of the spot exponent. +Thus, higher spot exponents result in a more focused light source, +regardless of the spot cutoff angle (see _const(SPOT_CUTOFF), next paragraph). +The initial spot exponent is 0, +resulting in uniform light distribution. +.TP +_const(SPOT_CUTOFF) +_param3 is a single integer or floating-point value that specifies +the maximum spread angle of a light source. +Integer and floating-point values are mapped directly. +Only values in the range [0,90] and the special value 180 +are accepted. +If the angle between the direction of the light and the direction from the +light to the vertex being lighted is greater than the spot cutoff angle, +the light is completely masked. +.BP +Otherwise, its intensity is controlled by the spot exponent and the +attenuation factors. +The initial spot cutoff is 180, +resulting in uniform light distribution. +.TP +_const(CONSTANT_ATTENUATION) +.TP +_const(LINEAR_ATTENUATION ) +.TP +_const(QUADRATIC_ATTENUATION) +_param3 is a single integer or floating-point value that specifies +one of the three light attenuation factors. +Integer and floating-point values are mapped directly. +Only nonnegative values are accepted. +If the light is positional, +rather than directional, +its intensity is attenuated by the reciprocal of the sum of the constant +factor, the linear factor times the distance between the light +and the vertex being lighted, +and the quadratic factor times the square of the same distance. +The initial attenuation factors are (1, 0, 0), +resulting in no attenuation. +.SH NOTES +It is always the case that _const(LIGHT)$i$ = _const(LIGHT0) + $i$. +.SH ERRORS +_const(INVALID_ENUM) is generated if either _param1 or _param2 +is not an accepted value. +.P +_const(INVALID_VALUE) is generated if a spot exponent value is specified +outside the range [0,128], +or if spot cutoff is specified outside the range [0,90] (except for the +special value 180), +or if a negative attenuation factor is specified. +.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(GetLight) +.br +_cmnd(IsEnabled) with argument _const(LIGHTING) +.SH SEE ALSO +_cmnd(ColorMaterial), +_cmnd(LightModel), +_cmnd(Material) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/lightmodel.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/lightmodel.gl new file mode 100644 index 000000000..15e6ef1de --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/lightmodel.gl @@ -0,0 +1,172 @@ +_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(LightModel,set the lighting model parameters) +_names(LightModel,[fi]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a single-valued lighting model parameter. +_const(LIGHT_MODEL_LOCAL_VIEWER), +_const(LIGHT_MODEL_COLOR_CONTROL), and +_const(LIGHT_MODEL_TWO_SIDE) are accepted. +_phead(_param2) +Specifies the value that _param2 will be set to. +_names(LightModel,[fi]v) +.SH PARAMETERS +_phead(_param1) +Specifies a lighting model parameter. +_const(LIGHT_MODEL_AMBIENT), +_const(LIGHT_MODEL_COLOR_CONTROL), +_const(LIGHT_MODEL_LOCAL_VIEWER), and +_const(LIGHT_MODEL_TWO_SIDE) are accepted. +_phead(_param2) +Specifies a pointer to the value or values that _param2 will be set to. +.SH DESCRIPTION +_cmnd sets the lighting model parameter. +_param1 names a parameter and _param2 gives the new value. +There are three lighting model parameters: +.TP 10 +_const(LIGHT_MODEL_AMBIENT) +_param2 contains four integer or floating-point values that specify +the ambient RGBA intensity of the entire scene. +Integer values are mapped linearly such that the most positive representable +value maps to 1.0, +and the most negative representable value maps to \-1.0. +Floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +The initial ambient scene intensity is (0.2, 0.2, 0.2, 1.0). +.TP +_const(LIGHT_MODEL_COLOR_CONTROL) +_param2 must be either _const(SEPARATE_SPECULAR_COLOR) or +_const(SINGLE_COLOR). +_const(SINGLE_COLOR) specifies that a single color is generated from the +lighting computation for a vertex. _const(SEPARATE_SPECULAR_COLOR) +specifies that the specular color computation of lighting be stored +separately from the remainder of the lighting computation. The specular +color is summed into the generated fragment's color after the application +of texture mapping (if enabled). The initial value is _const(SINGLE_COLOR). +.TP +_const(LIGHT_MODEL_LOCAL_VIEWER) +_param2 is a single integer or floating-point value that specifies +how specular reflection angles are computed. +If _param2 is 0 (or 0.0), specular reflection angles take the +view direction to be parallel to and in the direction of the -\f2z\fP axis, +regardless of the location of the vertex in eye coordinates. +Otherwise, specular reflections are computed from the origin +of the eye coordinate system. +The initial value is 0. +.TP +_const(LIGHT_MODEL_TWO_SIDE) +_param2 is a single integer or floating-point value that specifies +whether one- or two-sided lighting calculations are done for polygons. +It has no effect on the lighting calculations for points, +lines, +or bitmaps. +If _param2 is 0 (or 0.0), one-sided lighting is specified, +and only the \f2front\fP material parameters are used in the +lighting equation. +Otherwise, two-sided lighting is specified. +In this case, vertices of back-facing polygons are lighted using the +\f2back\fP material parameters, +and have their normals reversed before the lighting equation is evaluated. +Vertices of front-facing polygons are always lighted using the +\f2front\fP material parameters, +with no change to their normals. The initial value is 0. +.P +In RGBA mode, the lighted color of a vertex is the sum of +the material emission intensity, +the product of the material ambient reflectance and the lighting model full-scene +ambient intensity, +and the contribution of each enabled light source. +Each light source contributes the sum of three terms: +ambient, diffuse, and specular. +The ambient light source contribution is the product of the material ambient +reflectance and the light's ambient intensity. +The diffuse light source contribution is the product of the material diffuse +reflectance, +the light's diffuse intensity, +and the dot product of the vertex's normal with the normalized vector from +the vertex to the light source. +The specular light source contribution is the product of the material specular +reflectance, +the light's specular intensity, +and the dot product of the normalized vertex-to-eye and vertex-to-light +vectors, +raised to the power of the shininess of the material. +All three light source contributions are attenuated equally based on +the distance from the vertex to the light source and on light source +direction, spread exponent, and spread cutoff angle. +All dot products are replaced with 0 if they evaluate to a negative value. +.P +The alpha component of the resulting lighted color is set to the alpha value +of the material diffuse reflectance. +.P +In color index mode, +the value of the lighted index of a vertex ranges from the ambient +to the specular values passed to _cmnd(Material) using _const(COLOR_INDEXES). +Diffuse and specular coefficients, +computed with a (.30, .59, .11) weighting of the lights' colors, +the shininess of the material, +and the same reflection and attenuation equations as in the RGBA case, +determine how much above ambient the resulting index is. +.SH NOTES +_const(LIGHT_MODEL_COLOR_CONTROL) is available only if the GL version is +1.2 or greater. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_ENUM) is generated if _param1 is +_const(LIGHT_MODEL_COLOR_CONTROL) and _param2 is not one of +_const(SINGLE_COLOR) or _const(SEPARATE_SPECULAR_COLOR). +.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(Get) with argument _const(LIGHT_MODEL_AMBIENT) +.br +_cmnd(Get) with argument _const(LIGHT_MODEL_COLOR_CONTROL) +.br +_cmnd(Get) with argument _const(LIGHT_MODEL_LOCAL_VIEWER) +.br +_cmnd(Get) with argument _const(LIGHT_MODEL_TWO_SIDE) +.br +_cmnd(IsEnabled) with argument _const(LIGHTING) +.SH SEE ALSO +_cmnd(Light), +_cmnd(Material) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/linestipple.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/linestipple.gl new file mode 100644 index 000000000..4291fc679 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/linestipple.gl @@ -0,0 +1,100 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(LineStipple,specify the line stipple pattern) +_names(LineStipple) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a multiplier for each bit in the line stipple pattern. +If _param1 is 3, +for example, +each bit in the pattern is used three times +before the next bit in the pattern is used. +_param1 is clamped to the range [1, 256] and defaults to 1. +_phead(_param2) +Specifies a 16-bit integer whose bit pattern determines +which fragments of a line will be drawn when the line is rasterized. +Bit zero is used first; the default pattern is all 1's. +.SH DESCRIPTION +Line stippling masks out certain fragments produced by rasterization; +those fragments will not be drawn. +The masking is achieved by using three parameters: +the 16-bit line stipple pattern _param2, +the repeat count _param1, +and an integer stipple counter $s$. +.P +Counter $s$ is reset to 0 whenever _cmnd(Begin) is called, +and before each line segment of a _cmnd(Begin)(_const(LINES))/_cmnd(End) +sequence is generated. +It is incremented after each fragment of a unit width aliased line segment is generated, +or after each $i$ fragments of an $i$ width line segment are generated. +The $i$ fragments associated with count $s$ are masked out if +.sp +.ce +_param2 bit $(s ~/~ _eqnparam1) ~roman mod~ 16$ +.sp +is 0, otherwise these fragments are sent to the frame buffer. +Bit zero of _param2 is the least significant bit. +.P +Antialiased lines are treated as a sequence of $1 times width$ rectangles +for purposes of stippling. +Whether rectagle $s$ is rasterized or not depends on the fragment rule +described for aliased lines, +counting rectangles rather than groups of fragments. +.P +To enable and disable line stippling, call _cmnd(Enable) and _cmnd(Disable) +with argument _const(LINE_STIPPLE). +When enabled, +the line stipple pattern is applied as described above. +When disabled, +it is as if the pattern were all 1's. +Initially, line stippling is disabled. +.SH ERRORS +_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(Get) with argument _const(LINE_STIPPLE_PATTERN) +.br +_cmnd(Get) with argument _const(LINE_STIPPLE_REPEAT) +.br +_cmnd(IsEnabled) with argument _const(LINE_STIPPLE) +.SH SEE ALSO +_cmnd(LineWidth), +_cmnd(PolygonStipple) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/linewidth.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/linewidth.gl new file mode 100644 index 000000000..e8957cefc --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/linewidth.gl @@ -0,0 +1,113 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(LineWidth,specify the width of rasterized lines) +_names(LineWidth) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the width of rasterized lines. +The initial value is 1. +.SH DESCRIPTION +_cmnd specifies the rasterized width of both aliased and antialiased +lines. +Using a line width other than 1 has different effects, +depending on whether line antialiasing is enabled. +To enable and disable line antialiasing, call +_cmnd(Enable) and _cmnd(Disable) +with argument _const(LINE_SMOOTH). Line antialiasing is initially +disabled. +.P +If line antialiasing is disabled, +the actual width is determined by rounding the supplied width +to the nearest integer. +(If the rounding results in the value 0, +it is as if the line width were 1.) +If +$| DELTA x | ~>=~ | DELTA y |$, +\f2i\fP pixels are filled in each column that is rasterized, +where \f2i\fP is the rounded value of _param1. +Otherwise, +\f2i\fP pixels are filled in each row that is rasterized. +.P +If antialiasing is enabled, +line rasterization produces a fragment for each pixel square +that intersects the region lying within the rectangle having width +equal to the current line width, +length equal to the actual length of the line, +and centered on the mathematical line segment. +The coverage value for each fragment is the window coordinate area +of the intersection of the rectangular region with the corresponding +pixel square. +This value is saved and used in the final rasterization step. +.P +Not all widths can be supported when line antialiasing is enabled. If an +unsupported width is requested, the nearest supported width is used. +Only width 1 is guaranteed to be supported; others depend on the +implementation. Likewise, there is a range for aliased line widths as well. +To query the range of supported widths and the size +difference between supported widths within the range, call _cmnd(Get) +with arguments _const(ALIASED_LINE_WIDTH_RANGE), +_const(SMOOTH_LINE_WIDTH_RANGE), _const(SMOOTH_LINE_WIDTH_GRANULARITY). +.SH NOTES +The line width specified by _cmnd is always returned when _const(LINE_WIDTH) +is queried. +Clamping and rounding for aliased and antialiased lines have no effect +on the specified value. +.P +Nonantialiased line width may be clamped to an implementation-dependent +maximum. Call _cmnd(Get) with _const(ALIASED_LINE_WIDTH_RANGE) to +determine the maximum width. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is less than or equal to 0. +.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(Get) with argument _const(LINE_WIDTH) +.br +_cmnd(Get) with argument _const(ALIASED_LINE_WIDTH_RANGE) +.br +_cmnd(Get) with argument _const(SMOOTH_LINE_WIDTH_RANGE) +.br +_cmnd(Get) with argument _const(SMOOTH_LINE_WIDTH_GRANULARITY) +.br +_cmnd(IsEnabled) with argument _const(LINE_SMOOTH) +.SH SEE ALSO +_cmnd(Enable) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/listbase.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/listbase.gl new file mode 100644 index 000000000..486bdf8bb --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/listbase.gl @@ -0,0 +1,56 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(ListBase,set the display-list base for _cmnd(CallLists)) +_names(ListBase) +.SH PARAMETERS +_phead(_param1) +Specifies an integer offset that will be added to _cmnd(CallLists) +offsets to generate display-list names. +The initial value is 0. +.SH DESCRIPTION +_cmnd(CallLists) specifies an array of offsets. +Display-list names are generated by adding _param1 to each offset. +Names that reference valid display lists are executed; +the others are ignored. +.SH ERRORS +_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(Get) with argument _const(LIST_BASE) +.SH SEE ALSO +_cmnd(CallLists) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/loadidentity.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/loadidentity.gl new file mode 100644 index 000000000..33629650b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/loadidentity.gl @@ -0,0 +1,75 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(LoadIdentity,replace the current matrix with the identity matrix) +_names(LoadIdentity) +.SH DESCRIPTION +_cmnd replaces the current matrix with the identity matrix. +It is semantically equivalent to calling _cmnd(LoadMatrix) +with the identity matrix + +.ce + +.EQ +left ( down 20 { ~ matrix { + ccol { 1 above 0 above 0 above 0~ } + ccol { 0 above 1 above 0 above 0~ } + ccol { 0 above 0 above 1 above 0~ } + ccol { 0 above 0 above 0 above 1 } +} } ~~ right ) +.EN + + +but in some cases it is more efficient. +.SH ERRORS +_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(Get) with argument _const(MATRIX_MODE) +.br +_cmnd(Get) with argument _const(COLOR_MATRIX) +.br +_cmnd(Get) with argument _const(MODELVIEW_MATRIX) +.br +_cmnd(Get) with argument _const(PROJECTION_MATRIX) +.br +_cmnd(Get) with argument _const(TEXTURE_MATRIX) +.SH SEE ALSO +_cmnd(LoadMatrix), +_cmnd(MatrixMode), +_cmnd(MultMatrix), +_cmnd(PushMatrix) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/loadmatrix.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/loadmatrix.gl new file mode 100644 index 000000000..132b282f8 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/loadmatrix.gl @@ -0,0 +1,108 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(LoadMatrix,replace the current matrix with the specified matrix) +_names(LoadMatrix,[df]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to 16 consecutive values, which are used as the +elements of a $4 ~times~ 4$ column-major matrix. +.SH DESCRIPTION +_cmnd replaces the current matrix with the one whose elements are specified by +_param1. +The current matrix is the projection matrix, +modelview matrix, +or texture matrix, +depending on the current matrix mode +(see _cmnd(MatrixMode)). +.P +The current matrix, M, defines a transformation of coordinates. +For instance, assume M refers to the modelview matrix. +If $v ~=~ (v[0], v[1], v[2], v[3])$ is the set of object coordinates +of a vertex, +and _param1 points to an array of $16$ +single- or double-precision +floating-point values $m[0], m[1],. . .,m[15]$, +then the modelview transformation $M(v)$ does the following: +.P + +.ce +.EQ +down 130 +{M(v) ~ = ~ +{{ left ( matrix { + ccol { ~m[0] above m[1] above m[2] above m[3] ~} + ccol { ~m[4] above m[5] above m[6] above m[7] ~} + ccol { ~m[8] above m[9] above m[10] above m[11] ~} + ccol { ~m[12]~ above m[13]~ above m[14]~ above m[15]~} +} right ) } ~~ times ~~ +{left ( matrix { +ccol { ~v[0]~ above ~v[1]~ above ~v[2]~ above ~v[3]~ } +} right )} }} +.EN + +.sp +.P +Where ``$times$'' denotes matrix multiplication. +.P +Projection and texture transformations are similarly defined. +.SH NOTES +While the elements of the matrix may be specified with +single or double precision, the GL implementation may +store or operate on these values in less than single +precision. +.SH ERRORS +_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(Get) with argument _const(MATRIX_MODE) +.br +_cmnd(Get) with argument _const(COLOR_MATRIX) +.br +_cmnd(Get) with argument _const(MODELVIEW_MATRIX) +.br +_cmnd(Get) with argument _const(PROJECTION_MATRIX) +.br +_cmnd(Get) with argument _const(TEXTURE_MATRIX) +.SH SEE ALSO +_cmnd(LoadIdentity), +_cmnd(MatrixMode), +_cmnd(MultMatrix), +_cmnd(PushMatrix) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/loadname.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/loadname.gl new file mode 100644 index 000000000..ead3c0a69 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/loadname.gl @@ -0,0 +1,65 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(LoadName,load a name onto the name stack) +_names(LoadName) +.SH PARAMETERS +_phead(_param1) +Specifies a name that will replace the top value on the name stack. +.SH DESCRIPTION +The name stack is used during selection mode to allow sets of rendering +commands to be uniquely identified. +It consists of an ordered set of unsigned integers. +_cmnd causes _param1 to replace the value on the top of the name stack, +which is initially empty. +.P +The name stack is always empty while the render mode is not _const(SELECT). +Calls to _cmnd while the render mode is not _const(SELECT) are ignored. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd is called while the +name stack is empty. +.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(Get) with argument _const(NAME_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(MAX_NAME_STACK_DEPTH) +.SH SEE ALSO +_cmnd(InitNames), +_cmnd(PushName), +_cmnd(RenderMode), +_cmnd(SelectBuffer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/logicop.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/logicop.gl new file mode 100644 index 000000000..2f6d0b454 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/logicop.gl @@ -0,0 +1,129 @@ +_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,eqn|tbl)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(LogicOp,specify a logical pixel operation for color index rendering) +_names(LogicOp) +.SH PARAMETERS +_phead(_param1) +Specifies a symbolic constant that selects a logical operation. +The following symbols are accepted: +_const(CLEAR), +_const(SET), +_const(COPY), +_const(COPY_INVERTED), +_const(NOOP), +_const(INVERT), +_const(AND), +_const(NAND), +_const(OR), +_const(NOR), +_const(XOR), +_const(EQUIV), +_const(AND_REVERSE), +_const(AND_INVERTED), +_const(OR_REVERSE), and +_const(OR_INVERTED). The initial value is _const(COPY). +.SH DESCRIPTION +_cmnd specifies a logical operation that, +when enabled, +is applied between the incoming color index or RGBA color +and the color index or RGBA color at the corresponding location in the +frame buffer. +To enable or disable the logical operation, call +_cmnd(Enable) and _cmnd(Disable) +using the symbolic constant _const(COLOR_LOGIC_OP) for RGBA mode or +_const(INDEX_LOGIC_OP) for color index mode. The initial value is +disabled for both operations. +.P +.ne +.TS +center; +lb lb +l c. +_ +Opcode Resulting Operation +_ +_const(CLEAR) 0 +_const(SET) 1 +_const(COPY) s +_const(COPY_INVERTED) ~s +_const(NOOP) d +_const(INVERT) ~d +_const(AND) s & d +_const(NAND) ~(s & d) +_const(OR) s | d +_const(NOR) ~(s | d) +_const(XOR) s ^ d +_const(EQUIV) ~(s ^ d) +_const(AND_REVERSE) s & ~d +_const(AND_INVERTED) ~s & d +_const(OR_REVERSE) s | ~d +_const(OR_INVERTED) ~s | d +_ +.TE + +_param1 is a symbolic constant chosen from the list above. +In the explanation of the logical operations, +\f2s\fP represents the incoming color index and +\f2d\fP represents the index in the frame buffer. +Standard C-language operators are used. +As these bitwise operators suggest, +the logical operation is applied independently to each bit pair of the +source and destination indices or colors. +.SH NOTES +Color index logical operations are always supported. RGBA logical +operations are supported only if the GL version is 1.1 or greater. +.P +When more than one RGBA color or index buffer is enabled for drawing, +logical operations are performed separately for each enabled buffer, +using for the destination value the contents of that buffer +(see _cmnd(DrawBuffer)). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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(Get) with argument _const(LOGIC_OP_MODE). +.br +_cmnd(IsEnabled) with argument _const(COLOR_LOGIC_OP) or _const(INDEX_LOGIC_OP). +.SH SEE ALSO +_cmnd(AlphaFunc), +_cmnd(BlendFunc), +_cmnd(DrawBuffer), +_cmnd(Enable), +_cmnd(StencilOp) 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 new file mode 100644 index 000000000..c5d847a7f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map1.gl @@ -0,0 +1,268 @@ +_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) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map2.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map2.gl new file mode 100644 index 000000000..1293961aa --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/map2.gl @@ -0,0 +1,317 @@ +_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(Map2,define a two-dimensional evaluator) +_names(Map2,[fd]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the kind of values that are generated by the evaluator. +Symbolic constants +_const(MAP2_VERTEX_3), +_const(MAP2_VERTEX_4), +_const(MAP2_INDEX), +_const(MAP2_COLOR_4), +_const(MAP2_NORMAL), +_const(MAP2_TEXTURE_COORD_1), +_const(MAP2_TEXTURE_COORD_2), +_const(MAP2_TEXTURE_COORD_3), and +_const(MAP2_TEXTURE_COORD_4) are accepted. +_phead(_param2 _param3) +Specify a linear mapping of $u$, +as presented to _cmnd(EvalCoord2), +to $u hat$, +one of the two variables that are evaluated by the equations specified +by this command. Initially, _param2 is 0 and _param3 is 1. +_phead(_param4) +Specifies the number of floats or doubles between +the beginning of control point +$R sub ij$ +and the beginning of control point +$R sub { (i+1) j }$, +where $i$ and $j$ are the $u$ and $v$ control point indices, respectively. +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. The initial value of _param4 is 0. +_phead(_param5) +Specifies the dimension of the control point array in the $u$ axis. +Must be positive. The initial value is 1. +_phead(_param6 _param7) +Specify a linear mapping of $v$, +as presented to _cmnd(EvalCoord2), +to $v hat$, +one of the two variables that are evaluated by the equations specified +by this command. Initially, _param6 is 0 and _param7 is 1. +_phead(_param8) +Specifies the number of floats or doubles between +the beginning of control point +$R sub ij$ +and the beginning of control point +$R sub { i (j+1) }$, +where $i$ and $j$ are the $u$ and $v$ control point indices, respectively. +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. The initial value of _param8 is 0. +_phead(_param9) +Specifies the dimension of the control point array in the $v$ axis. +Must be positive. The initial value is 1. +_phead(_param10) +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 on 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 surfaces used in computer graphics, +including B-spline surfaces, +NURBS surfaces, +Bezier surfaces, and so on. +.P +Evaluators define surfaces based on bivariate Bernstein polynomials. +Define $p ( u hat , v hat ) $ as +.ce +.sp +.EQ +p ( u hat , v hat ) ~~=~~ + down 30 {{size 18 {sum}} from {size 8 {i~=~0}} to {size 9 {n}} } ~ + {{size 18 {sum}} from {size 8 {j~=~0}} to {size 9 {m}} } ~ + up 15 { B sub i sup n ( u hat ) ~ B sub j sup m ( v hat ) ~ R sub ij } +.EN +.sp +.P +where $R sub ij$ is a control point, +$B sub i sup n ( u hat )$ +is the $i$th Bernstein polynomial of degree +.br +$n$ (_param5 = $n ~+~ 1$) +.ce +.sp +.EQ +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 } +.EN +.sp +and $B sub j sup m ( v hat )$ +is the $j$th Bernstein polynomial of degree $m$ (_param9 = $m ~+~ 1$) +.ce +.sp +.EQ +B sub j sup m ( v hat ) ~~=~~ left ( ^down 20 {cpile { m above j }} ~^ right ) v hat sup j ( 1 - v hat ) sup { m - j } +.EN +.sp +Recall that +.ce +$0 sup 0 ~==~ 1 $ and $ left ( ^ down 20 {cpile { n above 0 }} ~^ right ) ~~==~~ 1 $ +.sp +_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. +When _cmnd(EvalCoord2) presents values $u$ and $v$, +the bivariate Bernstein polynomials are evaluated using $u hat$ and $v hat$, +where +.sp +.ce +$u hat ~~=~~ {u ~-~ _eqnparam2} over {_eqnparam3 ~-~ _eqnparam2}$ +.sp +.ce +$v hat ~~=~~ {v ~-~ _eqnparam6} over {_eqnparam7 ~-~ _eqnparam6}$ +.sp +_param1 is a symbolic constant that indicates what kind of control points +are provided in _param10, +and what output is generated when the map is evaluated. +It can assume one of nine predefined values: +.TP 25 +_const(MAP2_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(MAP2_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(MAP2_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(MAP2_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(MAP2_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(MAP2_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(MAP2_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(MAP2_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(MAP2_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, +_param8, +_param9, and +_param10 define the array addressing for accessing the control points. +_param10 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. +There are $ _eqnparam5 ~times~ _eqnparam9 $ control points in the array. +_param4 specifies how many float or double locations are skipped to advance +the internal memory pointer from control point +$R sub {i j} $ to control point $R sub {(i+1) j} $. +_param8 specifies how many float or double locations are skipped to advance +the internal memory pointer from control point +$R sub {i j} $ to control point $R sub {i (j+1) } $. +.SH NOTES +As is the case with all GL commands that accept pointers to data, +it is as if the contents of _param10 were copied by _cmnd before _cmnd +returns. +Changes to the contents of _param10 have no effect after _cmnd is called. +.P +Initially, _const(AUTO_NORMAL) is enabled. If _const(AUTO_NORMAL) is enabled, +normal vectors are generated when either +_const(MAP2_VERTEX_3) or _const(MAP2_VERTEX_4) is used to generate +vertices. +.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, +or if _param6 is equal to _param7. +.P +_const(INVALID_VALUE) is generated if either _param4 or _param8 +is less than the number of values in a control point. +.P +_const(INVALID_VALUE) is generated if either _param5 or _param9 +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(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) +.SH SEE ALSO +_cmnd(Begin), +_cmnd(Color), +_cmnd(Enable), +_cmnd(EvalCoord), +_cmnd(EvalMesh), +_cmnd(EvalPoint), +_cmnd(Map1), +_cmnd(MapGrid), +_cmnd(Normal), +_cmnd(TexCoord), +_cmnd(Vertex) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/mapgrid.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/mapgrid.gl new file mode 100644 index 000000000..fe4e4c2e2 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/mapgrid.gl @@ -0,0 +1,125 @@ +_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(MapGrid,define a one- or two-dimensional mesh) +_names(MapGrid,[12]u*[df]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the number of partitions in the grid range interval +[_param2, _param3]. +Must be positive. +_phead(_param2 _param3) +Specify the mappings for integer grid domain values $i~=~0$ and $i~=~_eqnparam1$. +_phead(_param4) +Specifies the number of partitions in the grid range interval +[_param5, _param6] +.br +(_cmnd(MapGrid2) only). +_phead(_param5 _param6) +Specify the mappings for integer grid domain values $j~=~0$ and $j~=~_eqnparam4$ +.br +(_cmnd(MapGrid2) only). +.SH DESCRIPTION +_cmnd and _cmnd(EvalMesh) are used together to efficiently +generate and evaluate a series of evenly-spaced map domain values. +_cmnd(EvalMesh) steps through the integer domain +of a one- or two-dimensional grid, +whose range is the domain of the evaluation maps specified by +_cmnd(Map1) and _cmnd(Map2). +.P +_cmnd(MapGrid1) and _cmnd(MapGrid2) specify the linear grid mappings +between the $i$ +(or $i$ and $j$) +integer grid coordinates, +to the $u$ +(or $u$ and $v$) +floating-point evaluation map coordinates. +See _cmnd(Map1) and _cmnd(Map2) for details of how $u$ and $v$ coordinates +are evaluated. +.P +_cmnd(MapGrid1) specifies a single linear mapping +such that integer grid coordinate 0 maps exactly to _param2, +and integer grid coordinate _param1 maps exactly to _param3. +All other integer grid coordinates $i$ are mapped so that +.sp +.ce +.EQ +u ~=~ i (_eqnparam3 - _eqnparam2) / _eqnparam1 ~+~ _eqnparam2 +.EN +.sp +_cmnd(MapGrid2) specifies two such linear mappings. +One maps integer grid coordinate $i~=~0$ exactly to _param2, +and integer grid coordinate $i~=~_eqnparam1$ exactly to _param3. +The other maps integer grid coordinate $j~=~0$ exactly to _param5, +and integer grid coordinate $j~=~_eqnparam4$ exactly to _param6. +Other integer grid coordinates $i$ and $j$ are mapped such that +.P +.ce +.EQ +u ~=~ i (_eqnparam3 - _eqnparam2) / _eqnparam1 ~+~ _eqnparam2 +.EN +.P +.ce +.EQ +v ~=~ j (_eqnparam6 - _eqnparam5) / _eqnparam4 ~+~ _eqnparam5 +.EN +.P +The mappings specified by _cmnd are used identically by +_cmnd(EvalMesh) and _cmnd(EvalPoint). +.SH ERRORS +_const(INVALID_VALUE) is generated if either _param1 or _param4 is not +positive. +.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(Get) with argument _const(MAP1_GRID_DOMAIN) +.br +_cmnd(Get) with argument _const(MAP2_GRID_DOMAIN) +.br +_cmnd(Get) with argument _const(MAP1_GRID_SEGMENTS) +.br +_cmnd(Get) with argument _const(MAP2_GRID_SEGMENTS) +.SH SEE ALSO +_cmnd(EvalCoord), +_cmnd(EvalMesh), +_cmnd(EvalPoint), +_cmnd(Map1), +_cmnd(Map2) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/material.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/material.gl new file mode 100644 index 000000000..900ec9109 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/material.gl @@ -0,0 +1,200 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Material,specify material parameters for the lighting model) +_names(Material,[fi]) +.SH PARAMETERS +_phead(_param1) +Specifies which face or faces are being updated. +Must be one of +_const(FRONT), +_const(BACK), or +_const(FRONT_AND_BACK). +_phead(_param2) +Specifies the single-valued material parameter of the face or faces +that is being updated. +Must be _const(SHININESS). +_phead(_param3) +Specifies the value that parameter _const(SHININESS) will be set to. +_names(Material,[fi]v) +.SH PARAMETERS +_phead(_param1) +Specifies which face or faces are being updated. +Must be one of +_const(FRONT), +_const(BACK), or +_const(FRONT_AND_BACK). +_phead(_param2) +Specifies the material parameter of the face or faces that is being updated. +Must be one of +_const(AMBIENT), +_const(DIFFUSE), +_const(SPECULAR), +_const(EMISSION), +_const(SHININESS), +_const(AMBIENT_AND_DIFFUSE), or +_const(COLOR_INDEXES). +_phead(_param3) +Specifies a pointer to the value or values that _param2 will be set to. +.SH DESCRIPTION +_cmnd assigns values to material parameters. +There are two matched sets of material parameters. +One, +the \f2front-facing\fP set, +is used to shade points, +lines, +bitmaps, +and all polygons +(when two-sided lighting is disabled), +or just front-facing polygons +(when two-sided lighting is enabled). +The other set, +\f2back-facing\fP, +is used to shade back-facing polygons only when two-sided lighting is enabled. +Refer to the _cmnd(LightModel) reference page for details concerning one- and +two-sided lighting calculations. +.P +_cmnd takes three arguments. +The first, +_param1, +specifies whether the +_const(FRONT) materials, the +_const(BACK) materials, or both +_const(FRONT_AND_BACK) materials will be modified. +The second, +_param2, +specifies which of several parameters in one or both sets will be modified. +The third, +_param3, +specifies what value or values will be assigned to the specified parameter. +.P +Material parameters are used in the lighting equation that is optionally +applied to each vertex. +The equation is discussed in the _cmnd(LightModel) reference page. +The parameters that can be specified using _cmnd, +and their interpretations by the lighting equation, are as follows: +.TP 20 +_const(AMBIENT) +_param3 contains four integer or floating-point values that specify +the ambient RGBA reflectance of the material. +Integer values are mapped linearly such that the most positive representable +value maps to 1.0, +and the most negative representable value maps to \-1.0. +Floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +The initial ambient reflectance for both front- and back-facing materials +is (0.2, 0.2, 0.2, 1.0). +.TP +_const(DIFFUSE) +_param3 contains four integer or floating-point values that specify +the diffuse RGBA reflectance of the material. +Integer values are mapped linearly such that the most positive representable +value maps to 1.0, +and the most negative representable value maps to \-1.0. +Floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +The initial diffuse reflectance for both front- and back-facing materials +is (0.8, 0.8, 0.8, 1.0). +.TP +_const(SPECULAR) +_param3 contains four integer or floating-point values that specify +the specular RGBA reflectance of the material. +Integer values are mapped linearly such that the most positive representable +value maps to 1.0, +and the most negative representable value maps to \-1.0. +Floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +The initial specular reflectance for both front- and back-facing materials +is (0, 0, 0, 1). +.TP +_const(EMISSION) +_param3 contains four integer or floating-point values that specify +the RGBA emitted light intensity of the material. +Integer values are mapped linearly such that the most positive representable +value maps to 1.0, +and the most negative representable value maps to \-1.0. +Floating-point values are mapped directly. +Neither integer nor floating-point values are clamped. +The initial emission intensity for both front- and back-facing materials +is (0, 0, 0, 1). +.TP +_const(SHININESS) +_param3 is a single integer or floating-point value that specifies +the RGBA specular exponent of the material. +Integer and floating-point values are mapped directly. +Only values in the range [0,128] are accepted. +The initial specular exponent for both front- and back-facing materials +is 0. +.TP +_const(AMBIENT_AND_DIFFUSE) +Equivalent to calling _cmnd twice with the same parameter values, +once with _const(AMBIENT) and once with _const(DIFFUSE). +.TP +_const(COLOR_INDEXES) +_param3 contains three integer or floating-point values specifying +the color indices for ambient, +diffuse, +and specular lighting. +These three values, +and _const(SHININESS), +are the only material values used by the color index mode lighting equation. +Refer to the _cmnd(LightModel) reference page for a discussion +of color index lighting. +.SH NOTES +The material parameters can be updated at any time. +In particular, +_cmnd can be called between a call to _cmnd(Begin) and the corresponding +call to _cmnd(End). +If only a single material parameter is to be changed per vertex, +however, +_cmnd(ColorMaterial) is preferred over _cmnd +(see _cmnd(ColorMaterial)). +.P +While the ambient, diffuse, specular and emission material parameters +all have alpha components, only the diffuse alpha component is used in +the lighting computation. +.SH ERRORS +_const(INVALID_ENUM) is generated if either _param1 or _param2 is not +an accepted value. +.P +_const(INVALID_VALUE) is generated if a specular exponent outside the range +[0,128] is specified. +.SH ASSOCIATED GETS +_cmnd(GetMaterial) +.SH SEE ALSO +_cmnd(ColorMaterial), +_cmnd(Light), +_cmnd(LightModel) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/matrixmode.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/matrixmode.gl new file mode 100644 index 000000000..3b478e4ae --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/matrixmode.gl @@ -0,0 +1,81 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(MatrixMode,specify which matrix is the current matrix) +_names(MatrixMode) +.SH PARAMETERS +_phead(_param1) +Specifies which matrix stack is the target +for subsequent matrix operations. +Three values are accepted: +_const(MODELVIEW), +_const(PROJECTION), and +_const(TEXTURE). +The initial value is _const(MODELVIEW). +.TE + +Additionally, if the _arbstring(imaging) extension is supported, +_const(COLOR) is also accepted. +.SH DESCRIPTION +_cmnd sets the current matrix mode. +_param1 can assume one of four values: +.TP 25 +_const(MODELVIEW) +Applies subsequent matrix operations to the modelview matrix stack. +.TP +_const(PROJECTION) +Applies subsequent matrix operations to the projection matrix stack. +.TP +_const(TEXTURE) +Applies subsequent matrix operations to the texture matrix stack. +.TP +_const(COLOR) +Applies subsequent matrix operations to the color matrix stack. +.P +To find out which matrix stack is currently the target of all matrix +operations, call _cmnd(Get) with argument _const(MATRIX_MODE). The initial +value is _const(MODELVIEW). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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(Get) with argument _const(MATRIX_MODE) +.SH SEE ALSO +_cmnd(LoadMatrix), +_cmnd(PushMatrix) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/minmax.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/minmax.gl new file mode 100644 index 000000000..e177e0139 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/minmax.gl @@ -0,0 +1,134 @@ +_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)_C_ +_header(Minmax,define minmax table) +_names(Minmax) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__internalformat>@,@<_param2>@)_C_ +_define(@<__sink>@,@<_param3>@)_C_ +.SH PARAMETERS +_phead(__target) +The minmax table whose parameters are to be set. +Must be +_const(MINMAX). +_phead(__internalformat) +The format of entries in the minmax table. +Must be one of +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(__sink) +If _const(TRUE), pixels will be consumed by the minmax +process and no drawing or texture loading will take place. +If _const(FALSE), pixels will proceed to the final conversion process after +minmax. +.SH DESCRIPTION +When _const(MINMAX) is enabled, the RGBA components of incoming pixels are +compared to the minimum and maximum values for each component, which are +stored in the 2-element minmax table. +(The first element stores the minima, and the second element stores +the maxima.) +If a pixel component is greater than the corresponding component +in the maximum element, then the maximum element is updated with the +pixel component value. +If a pixel component is less than the corresponding component in +the minimum element, then the minimum element is updated with the +pixel component value. +(In both cases, if the internal format of the minmax table includes +luminance, then the R color component of incoming pixels is used +for comparison.) +The contents of the minmax table may be retrieved at a later time +by calling _cmnd(GetMinmax). +The minmax operation is enabled or disabled by calling _cmnd(Enable) or +_cmnd(Disable), respectively, with an argument of _const(MINMAX). +.P +_cmnd redefines the current minmax table to have entries of the format +specified by __internalformat. +The maximum element is initialized with the smallest possible component +values, and the minimum element is initialized with the largest possible +component values. +The values in the previous minmax table, if any, are lost. +If __sink is _const(TRUE), then pixels are discarded after minmax; +no further processing of the pixels takes place, and no drawing, +texture loading, or pixel readback will result. +.P +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __internalformat is not one of the +allowable values. +.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(GetMinmaxParameter) +.SH SEE ALSO +_cmnd(GetMinmax), +_cmnd(ResetMinmax) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/multitexcoordARB.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/multitexcoordARB.gl new file mode 100644 index 000000000..944528cf8 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/multitexcoordARB.gl @@ -0,0 +1,102 @@ +_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(MultiTexCoordARB, set the current texture coordinates) +_names(MultiTexCoord,[1-4]u*[sifdb]ARB) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies texture unit whose coordinates should be modified. The number +of texture units is implementation dependent, but must be at least +two. Must be one of _arbconstidx(TEXTURE) where 0 \(<= $ i $ < +_arbconst(MAX_TEXTURE_UNITS), which is an implementation-dependent value. +_phead(_param2 _param3 _param4 _param5) +Specify _param2, _param3, _param4, and _param5 texture coordinates for +_param1 texture unit. Not all parameters are present in all forms +of the command. +_names(MultiTexCoord,[1-4]u*[sifdb]vARB) +.SH PARAMETERS +_phead(_param1) +Specifies texture unit whose coordinates should be modified. The number +of texture units is implementation dependent, but must be at least +two. Must be one of _arbconstidx(TEXTURE), +where 0 \(<= $ i $ < the implementation-dependent value of +_const(MAX_TEXTURE_UNITS_ARB). +_phead(_param2) +Specifies a pointer to an array of one, two, three, or four elements, +which in turn specify the _param2(1), _param3(1), _param4(1), +and _param5(1) texture coordinates. +.SH DESCRIPTION +_cmnd specifies texture coordinates in one, two, three, or four +dimensions. +_cmnd(MultiTexCoord1ARB) sets the current texture +coordinates to (_param2(1),\ 0,\ 0,\ 1); +a call to _cmnd(MultiTexCoord2ARB) +sets them to (_param2(1),\ _param3(1),\ 0,\ 1). +Similarly, _cmnd(MultiTexCoord3ARB) specifies the texture coordinates as +(_param2(1),\ _param3(1),\ _param4(1),\ 1), and +_cmnd(MultiTexCoord4ARB) +defines all four components explicitly as +(_param2(1),\ _param3(1),\ _param4(1),\ _param5(1)). +.P +The current texture coordinates are part of the data +that is associated with each vertex and with the current +raster position. +Initially, the values for +_param2(1), _param3(1), _param4(1), _param5(1) are (0,\ 0,\ 0,\ 1). +.P +.SH NOTES +_cmnd is only supported if _arbstring(multitexture) is included in the +string returned by _cmnd(GetString) when called with the argument +_const(EXTENSIONS). +.P +The current texture coordinates can be updated at any time. +In particular, +_cmnd can be called between a call to _cmnd(Begin) and the corresponding +call to _cmnd(End). +.P +It is always the case that _arbconstidx(TEXTURE) = _arbconst(TEXTURE0) + $i$. +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(CURRENT_TEXTURE_COORDS) with appropriate +texture unit selected. +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(ClientActiveTextureARB), +_cmnd(TexCoord), +_cmnd(TexCoordPointer), +_cmnd(Vertex) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/multmatrix.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/multmatrix.gl new file mode 100644 index 000000000..fe0af0ee5 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/multmatrix.gl @@ -0,0 +1,132 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(MultMatrix,multiply the current matrix with the specified matrix) +_names(MultMatrix,[df]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Points to 16 consecutive values that are used as the elements of +a $4 ~times~ 4$ column-major matrix. +.SH DESCRIPTION +_cmnd multiplies the current matrix with the one specified using _param1, and +replaces the current matrix with the product. +.P +The current matrix is determined by the current matrix mode (see _cmnd(MatrixMode)). It is either the projection matrix, +modelview matrix, +or the texture matrix. +.SH EXAMPLES +If the current matrix is $C$, and the coordinates +to be transformed are, $v ~=~ (v[0], v[1], v[2], v[3])$. +Then the current transformation is $C ~times~ v$, or +.sp +.ce +.EQ +down 130 +{{ left ( matrix { + ccol { c[0] above c[1] above c[2] above c[3] } + ccol { c[4] above c[5] above c[6] above c[7] } + ccol { c[8] above c[9] above c[10] above c[11] } + ccol { c[12]~ above c[13]~ above c[14]~ above c[15]~ } +} right ) } ~~ times ~~ +{left ( matrix { +ccol { v[0]~ above v[1]~ above v[2]~ above v[3]~ } +} right )} } +.EN +.sp +.P +Calling _cmnd with an argument of $_eqnparam1 ~=~ m[0], m[1], ..., m[15]$ +replaces the current transformation with $(C ~times~ M) ~times~ v$, +or +.sp +.ce +.EQ +down 130 +{{ left ( matrix { + ccol { c[0] above c[1] above c[2] above c[3] } + ccol { c[4] above c[5] above c[6] above c[7] } + ccol { c[8] above c[9] above c[10] above c[11] } + ccol { c[12]~ above c[13]~ above c[14]~ above c[15]~ } +} right ) } ~~ times ~~ +{ left ( matrix { + ccol { m[0] above m[1] above m[2] above m[3] } + ccol { m[4] above m[5] above m[6] above m[7] } + ccol { m[8] above m[9] above m[10] above m[11] } + ccol { m[12]~ above m[13]~ above m[14]~ above m[15]~ } +} right ) } ~~ times ~~ +{left ( matrix { +ccol { v[0]~ above v[1]~ above v[2]~ above v[3]~ } +} right )} } +.EN +.sp +.P +Where '$times$' denotes matrix multiplication, and +$v$ is represented as a $4 ~times~ 1$ matrix. +.br +.SH NOTES +While the elements of the matrix may be specified with +single or double precision, the GL may store or operate on these +values in less than single precision. +.P +In many computer languages $4 ~times~ 4$ arrays are represented +in row-major order. The transformations just described +represent these matrices in column-major order. +The order of the multiplication is important. For example, if the current +transformation is a rotation, and _cmnd is called with a translation matrix, +the translation is done directly on the coordinates to be transformed, +while the rotation is done on the results of that translation. +.SH ERRORS +_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(Get) with argument _const(MATRIX_MODE) +.br +_cmnd(Get) with argument _const(COLOR_MATRIX) +.br +_cmnd(Get) with argument _const(MODELVIEW_MATRIX) +.br +_cmnd(Get) with argument _const(PROJECTION_MATRIX) +.br +_cmnd(Get) with argument _const(TEXTURE_MATRIX) +.SH SEE ALSO +_cmnd(LoadIdentity), +_cmnd(LoadMatrix), +_cmnd(MatrixMode), +_cmnd(PushMatrix) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/newlist.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/newlist.gl new file mode 100644 index 000000000..495b3590b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/newlist.gl @@ -0,0 +1,163 @@ +_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 +_header(NewList,create or replace a display list) +_names(NewList) +.SH PARAMETERS +_phead(_param1) +Specifies the display-list name. +_phead(_param2) +Specifies the compilation mode, +which can be +_const(COMPILE) or +_const(COMPILE_AND_EXECUTE). +_names(EndList) +.SH DESCRIPTION +Display lists are groups of GL commands that have been stored +for subsequent execution. +Display lists are created with _cmnd. +All subsequent commands are placed in the display list, +in the order issued, +until _cmnd(EndList) is called. +.P +_cmnd has two arguments. +The first argument, +_param1(1), +is a positive integer that becomes the unique name for the display list. +Names can be created and reserved with _cmnd(GenLists) +and tested for uniqueness with _cmnd(IsList). +The second argument, +_param2(1), +is a symbolic constant that can assume one of two values: +.TP 30 +_const(COMPILE) +Commands are merely compiled. +.TP +_const(COMPILE_AND_EXECUTE) +Commands are executed as they are compiled into the display list. +.P +Certain commands are not compiled into the display list +but are executed immediately, +regardless of the display-list mode. +These commands are +_cmnd(AreTexturesResident), +_cmnd(ColorPointer), +_cmnd(DeleteLists), +_cmnd(DeleteTextures), +_cmnd(DisableClientState), +_cmnd(EdgeFlagPointer), +_cmnd(EnableClientState), +_cmnd(FeedbackBuffer), +_cmnd(Finish), +_cmnd(Flush), +_cmnd(GenLists), +_cmnd(GenTextures), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(IsEnabled), +_cmnd(IsList), +_cmnd(IsTexture), +_cmnd(NormalPointer), +_cmnd(PopClientAttrib), +_cmnd(PixelStore), +_cmnd(PushClientAttrib), +_cmnd(ReadPixels), +_cmnd(RenderMode), +_cmnd(SelectBuffer), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer), +and all of the _cmnd(Get) commands. +.P +Similarly, +_cmnd(TexImage1D), _cmnd(TexImage2D), and _cmnd(TexImage3D) +are executed immediately and not compiled into the display list when their +first argument is _const(PROXY_TEXTURE_1D), _const(PROXY_TEXTURE_1D), or +_const(PROXY_TEXTURE_3D), respectively. +.P +When the _arbstring(imaging) extension is supported, +_cmnd(Histogram) executes immediately when its argument is +_const(PROXY_HISTOGRAM). Similarly, _cmnd(ColorTable) executes +immediately when its first argument is _cmnd(PROXY_COLOR_TABLE), +_cmnd(PROXY_POST_CONVOLUTION_COLOR_TABLE), or +_cmnd(PROXY_POST_COLOR_MATRIX_COLOR_TABLE). +.P +When the _arbstring(multitexture) extension is supported, +_cmnd(ClientActiveTextureARB) is not compiled into display lists, but +executed immediately. +.P +When _cmnd(EndList) is encountered, +the display-list definition is completed by associating the list +with the unique name _param1(1) +(specified in the _cmnd(NewList) command). +If a display list with name _param1(1) already exists, +it is replaced only when _cmnd(EndList) is called. +.SH NOTES +_cmnd(CallList) and _cmnd(CallLists) can be entered into display lists. +Commands in the display list or lists executed by _cmnd(CallList) +or _cmnd(CallLists) are not included in the display list being created, +even if the list creation mode is _const(COMPILE_AND_EXECUTE). +.P +A display list is just a group of commands and arguments, so errors +generated by commands in a display list must be generated when the list is +executed. If the list is created in _const(COMPILE) mode, errors are +not generated until the list is executed. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1(1) is 0. +.P +_const(INVALID_ENUM) is generated if _param2(1) is not an accepted value. +.P +_const(INVALID_OPERATION) is generated if _cmnd(EndList) is called +without a preceding _cmnd(NewList), +or if _cmnd(NewList) is called while a display list is being defined. +.P +_const(INVALID_OPERATION) is generated if _cmnd(NewList) or _cmnd(EndList) +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.P +_const(OUT_OF_MEMORY) is generated if there is insufficient memory to +compile the display list. If the GL version is 1.1 or greater, no +change is made to the previous contents of the display list, if any, +and no other change is made to the GL state. (It is as if no attempt +had been made to create the new display list.) +.SH ASSOCIATED GETS +_cmnd(IsList) +.br +_cmnd(Get) with argument _const(LIST_INDEX) +.br +_cmnd(Get) with argument _const(LIST_MODE) +.SH SEE ALSO +_cmnd(CallList), +_cmnd(CallLists), +_cmnd(DeleteLists), +_cmnd(GenLists) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/normal.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/normal.gl new file mode 100644 index 000000000..d8d6d865c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/normal.gl @@ -0,0 +1,87 @@ +_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(Normal,set the current normal vector) +.EQ +delim $$ +.EN +_names(Normal,3[bdfis]) +.SH PARAMETERS +_phead(_param1 _param2 _param3) +Specify the $x$, $y$, and $z$ coordinates of the new current normal. +The initial value of the current normal is the unit vector, (0, 0, 1). +.P +_names(Normal,3[bsidf]v) +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to an array of three elements: +the $x$, $y$, and $z$ coordinates of the new current normal. +.P +.SH DESCRIPTION +The current normal is set to the given coordinates +whenever _cmnd is issued. +Byte, short, or integer arguments are converted to floating-point +format with a linear mapping that maps the most positive representable integer +value to 1.0, +and the most negative representable integer value to \-1.0. +.P +Normals specified with _cmnd need not have unit length. +If _const(NORMALIZE) is enabled, +then normals of any length specified with _cmnd are normalized after transformation. +If _const(RESCALE_NORMAL) is enabled, normals are scaled by a scaling factor +derived from the modelview matrix. _const(RESCALE_NORMAL) requires that the +originally specified normals were of unit length, and that the modelview +matrix contain only uniform scales for proper results. +To enable and disable normalization, call _cmnd(Enable) and _cmnd(Disable) +with either _const(NORMALIZE) or _const(RESCALE_NORMAL). +Normalization is initially disabled. +.SH NOTES +The current normal can be updated at any time. +In particular, _cmnd can be called between a call to _cmnd(Begin) and +the corresponding call to _cmnd(End). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(CURRENT_NORMAL) +.br +_cmnd(IsEnabled) with argument _const(NORMALIZE) +.br +_cmnd(IsEnabled) with argument _const(RESCALE_NORMAL) +.SH SEE ALSO +_cmnd(Begin), +_cmnd(Color), +_cmnd(Index), +_cmnd(NormalPointer), +_cmnd(TexCoord), +_cmnd(Vertex) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/normalpointer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/normalpointer.gl new file mode 100644 index 000000000..4b464d0e9 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/normalpointer.gl @@ -0,0 +1,138 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_C_ the function name must appear in (APIFILE) (usually gl.h) as set in +_C_ Makefile. +_header(NormalPointer,define an array of normals) +_names(NormalPointer) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the data type of each coordinate in the array. +Symbolic constants +_const(BYTE), +_const(SHORT), +_const(INT), +_const(FLOAT), and +_const(DOUBLE) +are accepted. The initial value is _const(FLOAT). +_phead(_param2) +Specifies the byte offset between consecutive normals. If _param2 is 0\- +the initial value\-the normals are understood to be tightly packed in +the array. +The initial value is 0. +_phead(_param3) +Specifies a pointer to the first coordinate of the first normal in the +array. +The initial value is 0. +.SH DESCRIPTION +_cmnd specifies the location and data format of an array of normals +to use when rendering. +_param1 specifies the data type of +the normal coordinates and _param2 gives the byte stride from one +normal to the next, allowing vertices and attributes +to be packed into a single array or stored in separate arrays. +(Single-array storage may be more efficient on some implementations; +see _cmnd(InterleavedArrays).) +When a normal array is specified, _param1, _param2, and _param3 are +saved as client-side state. +.P +To enable and disable the normal array, call _cmnd(EnableClientState) and +_cmnd(DisableClientState) with the argument _const(NORMAL_ARRAY). If +enabled, the normal array is used +when _cmnd(DrawArrays), _cmnd(DrawElements), or _cmnd(ArrayElement) is called. +.P +Use _cmnd(DrawArrays) to construct a sequence of primitives (all of the +same type) from prespecified vertex and vertex attribute arrays. +Use _cmnd(ArrayElement) to specify primitives +by indexing vertices and vertex attributes and _cmnd(DrawElements) to +construct a sequence of primitives by indexing vertices and vertex attributes. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +The normal array is initially disabled and isn't accessed when +_cmnd(ArrayElement), _cmnd(DrawElements), or _cmnd(DrawArrays) is called. +.P +Execution of _cmnd is not allowed between +_cmnd(Begin) and the corresponding _cmnd(End), +but an error may or may not be generated. If an error is not generated, +the operation is undefined. +.P +_cmnd is typically implemented on the client side. +.P +Since the normal array parameters are client-side state, they are not +saved or restored by _cmnd(PushAttrib) and _cmnd(PopAttrib). +Use _cmnd(PushClientAttrib) and +_cmnd(PopClientAttrib) instead. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param2 is negative. +.SH ASSOCIATED GETS +_cmnd(IsEnabled) with argument _const(NORMAL_ARRAY) +.br +_cmnd(Get) with argument _const(NORMAL_ARRAY_TYPE) +.br +_cmnd(Get) with argument _const(NORMAL_ARRAY_STRIDE) +.br +_cmnd(GetPointerv) with argument _const(NORMAL_ARRAY_POINTER) +.SH SEE ALSO +_C_ no queries or gets listed above, +_C_ alphabetize commands +_C_ seperate with commas not .br. +_C_ no command appears in the associated gets as well as in SEE ALSO. +_cmnd(ArrayElement), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(EdgeFlagPointer), +_cmnd(Enable), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(PopClientAttrib), +_cmnd(PushClientAttrib), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/ortho.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/ortho.gl new file mode 100644 index 000000000..d9887b90b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/ortho.gl @@ -0,0 +1,114 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Ortho,multiply the current matrix with an orthographic matrix) +_names(Ortho) +.SH PARAMETERS +_phead(_param1 _param2) +Specify the coordinates for the left and right vertical clipping planes. +_phead(_param3 _param4) +Specify the coordinates for the bottom and top horizontal clipping planes. +_phead(_param5 _param6) +Specify the distances to the nearer and farther depth clipping planes. +These values are negative if the plane is to be behind the viewer. +.SH DESCRIPTION +_cmnd describes a transformation that produces a parallel projection. +The current matrix (see _cmnd(MatrixMode)) is multiplied by this matrix +and the result replaces the current matrix, as if +_cmnd(MultMatrix) were called with the following matrix +as its argument: +.sp +.ce +.EQ +left ( matrix { + ccol { {2 over {_eqnparam2 - _eqnparam1}} above 0 above 0 above 0 } + ccol { 0 above {2 over {_eqnparam4 - _eqnparam3}} above 0 above 0 } + ccol { 0 above 0 above {-2 over {_eqnparam6 - _eqnparam5}} above 0 } + ccol { {t sub x}~ above {t sub y}~ above {t sub z}~ above 1~ } +} right ) +.EN +.BP +.P +where +.ce +.EQ +t sub x ~=~ -^{{_eqnparam2 ~+~ _eqnparam1} over {_eqnparam2 ~-~ _eqnparam1}} +.EN + +.ce +.EQ +t sub y ~=~ -^{{_eqnparam4 ~+~ _eqnparam3} over {_eqnparam4 ~-~ _eqnparam3}} +.EN + +.ce +.EQ +t sub z ~=~ -^{{_eqnparam6 ~+~ _eqnparam5} over {_eqnparam6 ~-~ _eqnparam5}} +.EN + +.RE +.P +Typically, the matrix mode is _const(PROJECTION), and +(_param1, _param3, \-_param5) and (_param2, _param4, \-_param5) +specify the points on the near clipping plane that are mapped +to the lower left and upper right corners of the window, +respectively, +assuming that the eye is located at (0, 0, 0). +\-_param6 specifies the location of the far clipping plane. +Both _param5 and _param6 can be either positive or negative. +.P +Use _cmnd(PushMatrix) and _cmnd(PopMatrix) to save and restore +the current matrix stack. +.SH ERRORS +_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(Get) with argument _const(MATRIX_MODE) +.br +_cmnd(Get) with argument _const(COLOR_MATRIX) +.br +_cmnd(Get) with argument _const(MODELVIEW_MATRIX) +.br +_cmnd(Get) with argument _const(PROJECTION_MATRIX) +.br +_cmnd(Get) with argument _const(TEXTURE_MATRIX) +.SH SEE ALSO +_cmnd(Frustum), +_cmnd(MatrixMode), +_cmnd(MultMatrix), +_cmnd(PushMatrix), +_cmnd(Viewport) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/passthrough.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/passthrough.gl new file mode 100644 index 000000000..14b9827db --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/passthrough.gl @@ -0,0 +1,72 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(PassThrough,place a marker in the feedback buffer) +_names(PassThrough) +.SH PARAMETERS +_phead(_param1) +Specifies a marker value to be placed in the feedback buffer +following a _const(PASS_THROUGH_TOKEN). +.SH DESCRIPTION +.P +Feedback is a GL render mode. +The mode is selected by calling +_cmnd(RenderMode) with _const(FEEDBACK). +When the GL is in feedback mode, +no pixels are produced by rasterization. +Instead, +information about primitives that would have been rasterized +is fed back to the application using the GL. +See the _cmnd(FeedbackBuffer) reference page for a description of the +feedback buffer and the values in it. +.P +_cmnd inserts a user-defined marker in the feedback buffer +when it is executed in feedback mode. +_param1 is returned as if it were a primitive; +it is indicated with its own unique identifying value: +_const(PASS_THROUGH_TOKEN). +The order of _cmnd commands with respect to the specification +of graphics primitives is maintained. +.SH NOTES +_cmnd is ignored if the GL is not in feedback mode. +.SH ERRORS +_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(Get) with argument _const(RENDER_MODE) +.SH SEE ALSO +_cmnd(FeedbackBuffer), +_cmnd(RenderMode) 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 new file mode 100644 index 000000000..9b3ddca84 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelmap.gl @@ -0,0 +1,250 @@ +_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) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelstore.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelstore.gl new file mode 100644 index 000000000..810f03a69 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelstore.gl @@ -0,0 +1,513 @@ +_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(PixelStore,set pixel storage modes) +_names(PixelStore,[fi]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the symbolic name of the parameter to be set. +Six values affect the packing of pixel data into memory: +_const(PACK_SWAP_BYTES), +_const(PACK_LSB_FIRST), +_const(PACK_ROW_LENGTH), +_const(PACK_IMAGE_HEIGHT), +_const(PACK_SKIP_PIXELS), +_const(PACK_SKIP_ROWS), +_const(PACK_SKIP_IMAGES), and +_const(PACK_ALIGNMENT). +Six more affect the unpacking of pixel data \f2from\fP memory: +_const(UNPACK_SWAP_BYTES), +_const(UNPACK_LSB_FIRST), +_const(UNPACK_ROW_LENGTH), +_const(UNPACK_IMAGE_HEIGHT), +_const(UNPACK_SKIP_PIXELS), +_const(UNPACK_SKIP_ROWS), +_const(UNPACK_SKIP_IMAGES), and +_const(UNPACK_ALIGNMENT). +_phead(_param2) +Specifies the value that _param1 is set to. +.SH DESCRIPTION + +_cmnd sets pixel storage modes that affect the operation of subsequent +_cmnd(DrawPixels) and _cmnd(ReadPixels) as well as the unpacking of +polygon stipple patterns (see _cmnd(PolygonStipple)), bitmaps (see +_cmnd(Bitmap)), texture patterns (see _cmnd(TexImage1D), +_cmnd(TexImage2D), _cmnd(TexImage3D), _cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), _cmnd(TexSubImage3D)). +Additionally, if the _arbstring(imaging) extension is supported, pixle +storage modes affect convlution filters +(see _cmnd(ConvolutionFilter1D), _cmnd(ConvolutionFilter2D), and +_cmnd(SeparableFilter2D), color table (see _cmnd(ColorTable), and +_cmnd(ColorSubTable), and unpacking histogram (See _cmnd(Histogram)), +and minmax (See _cmnd(Minmax)) data. +.P +_param1 is a symbolic constant indicating the parameter to be set, and +_param2 is the new value. Six of the twelve storage parameters affect +how pixel data is returned to client memory. +They are as follows: +.TP 10 +_const(PACK_SWAP_BYTES) +If true, +byte ordering for multibyte color components, +depth components, +color indices, +or stencil indices +is reversed. +That is, +if a four-byte component consists of bytes +$b sub 0$, +$b sub 1$, +$b sub 2$, +$b sub 3$, +it is stored in memory as +$b sub 3$, +$b sub 2$, +$b sub 1$, +$b sub 0$ +if _const(PACK_SWAP_BYTES) is true. +_const(PACK_SWAP_BYTES) has no effect on the memory order of components +within a pixel, +only on the order of bytes within components or indices. +For example, +the three components of a _const(RGB) format pixel are always stored with +red first, +green second, +and blue third, +regardless of the value of _const(PACK_SWAP_BYTES). +.TP +_const(PACK_LSB_FIRST) +If true, +bits are ordered within a byte from least significant to most significant; +otherwise, +the first bit in each byte is the most significant one. +This parameter is significant for bitmap data only. +.TP +_const(PACK_ROW_LENGTH) +If greater than 0, +_const(PACK_ROW_LENGTH) defines the number of pixels in a row. +If the first pixel of a row is placed at location $p$ in memory, +then the location of the first pixel of the next row is obtained by skipping +.sp +.ce +$k ~=~~ left { ^ lpile { n l above {a over s left ceiling { s n l } over a right ceiling}} ~~ lpile {s ~>=~ a above s ~<~ a }$ +.sp +components or indices, +where $n$ is the number of components or indices in a pixel, +$l$ is the number of pixels in a row +(_const(PACK_ROW_LENGTH) if it is greater than 0, +the $width$ argument to the pixel routine otherwise), +$a$ is the value of _const(PACK_ALIGNMENT), and +$s$ is the size, in bytes, of a single component +(if $ a < s$, then it is as if $a ~=~ s$). +In the case of 1-bit values, +the location of the next row is obtained by skipping +.sp +.ce +$k ~=~ 8 a left ceiling { n l } over { 8 a } ^ right ceiling$ +.sp +components or indices. +.IP +The word \f2component\fP in this description refers to the nonindex values +red, +green, +blue, +alpha, +and depth. +Storage format _const(RGB), +for example, +has three components per pixel: +first red, +then green, +and finally blue. +.TP +_const(PACK_IMAGE_HEIGHT) +If greater than 0, +_const(PACK_IMAGE_HEIGHT) defines the number of pixels in an image +three-dimensional texture volume. +Where ``image'' is defined by all pixels sharing the same third +dimension index. +If the first pixel of a row is placed at location $p$ in memory, +then the location of the first pixel of the next row is obtained by skipping +.sp +.ce +$k ~=~~ left { ~ lpile { n l h above {a over s left ceiling { s n l h } +over a ^ right ceiling}} ~~ lpile {s ~>=~ a above s ~<~ a }$ +.sp +components or indices, where $n$ is the number of components or indices +in a pixel, $l$ is the number of pixels in a row +(_const(PACK_ROW_LENGTH) if it is greater than 0, the +$width$ argument to _cmnd(TexImage3d) otherwise), $h$ is the number of +rows in a pixel image (_const(PACK_IMAGE_HEIGHT) if it is greater than +0, the $height$ arguemnt to the _cmnd(TexImage3D) routine otherwise), +$a$ is the value of +_const(PACK_ALIGNMENT), and $s$ is the size, in bytes, of a single +component (if $ a < s$, then it is as if $a = s$). +.IP +The word \f2component\fP in this description refers to the nonindex values +red, +green, +blue, +alpha, +and depth. +Storage format _const(RGB), +for example, +has three components per pixel: +first red, +then green, +and finally blue. +.TP +_const(PACK_SKIP_PIXELS), _const(PACK_SKIP_ROWS), and _const(PACK_SKIP_IMAGES) +These values are provided as a convenience to the programmer; +they provide no functionality that cannot be duplicated simply by +incrementing the pointer passed to _cmnd(ReadPixels). +Setting _const(PACK_SKIP_PIXELS) to $i$ is equivalent to incrementing +the pointer by $i n$ components or indices, +where $n$ is the number of components or indices in each pixel. +Setting _const(PACK_SKIP_ROWS) to $j$ is equivalent to incrementing +the pointer by $j m$ components or indices, +where $m$ is the number of components or indices per row, +as just computed in the _const(PACK_ROW_LENGTH) section. +Setting _const(PACK_SKIP_IMAGES) to $k$ is equivalent to incrementing +the pointer by $k p$, where $p$ is the number of components or indices +per image, as computed in the _const(PACK_IMAGE_HEIGHT) section. +.TP +_const(PACK_ALIGNMENT) +Specifies the alignment requirements for the start of each pixel row in memory. +The allowable values are +1 (byte-alignment), +2 (rows aligned to even-numbered bytes), +4 (word-alignment), and +8 (rows start on double-word boundaries). +.P +The other six of the twelve storage parameters affect how pixel data is +read from client memory. +These values are significant for _cmnd(DrawPixels), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D), +_cmnd(Bitmap), and +_cmnd(PolygonStipple). +.P +Additionally, if the _arbstring(imaging) extension is supported, +_cmnd(ColorTable), +_cmnd(ColorSubTable), +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), and +_cmnd(SeparableFilter2D). +They are as follows: +.TP +_const(UNPACK_SWAP_BYTES) +If true, +byte ordering for multibyte color components, +depth components, +color indices, +or stencil indices +is reversed. +That is, +if a four-byte component consists of bytes +$b sub 0$, +$b sub 1$, +$b sub 2$, +$b sub 3$, +it is taken from memory as +$b sub 3$, +$b sub 2$, +$b sub 1$, +$b sub 0$ +if _const(UNPACK_SWAP_BYTES) is true. +_const(UNPACK_SWAP_BYTES) has no effect on the memory order of components +within a pixel, +only on the order of bytes within components or indices. +For example, +the three components of a _const(RGB) format pixel are always stored with +red first, +green second, +and blue third, +regardless of the value of _const(UNPACK_SWAP_BYTES). +.TP +_const(UNPACK_LSB_FIRST) +If true, +bits are ordered within a byte from least significant to most significant; +otherwise, +the first bit in each byte is the most significant one. +This is relevant only for bitmap data. +.TP +_const(UNPACK_ROW_LENGTH) +If greater than 0, +_const(UNPACK_ROW_LENGTH) defines the number of pixels in a row. +If the first pixel of a row is placed at location $p$ in memory, +then the location of the first pixel of the next row is obtained by skipping +.sp +.ce +$k ~=~~ left { ~ lpile { n l above {a over s left ceiling { s n l } +over a ^ right ceiling}} ~~ lpile {s ~>=~ a above s ~<~ a }$ +.sp +components or indices, +where $n$ is the number of components or indices in a pixel, +$l$ is the number of pixels in a row +(_const(UNPACK_ROW_LENGTH) if it is greater than 0, +the $width$ argument to the pixel routine otherwise), +$a$ is the value of _const(UNPACK_ALIGNMENT), and +$s$ is the size, in bytes, of a single component +(if $ a < s$, then it is as if $a = s$). +In the case of 1-bit values, +the location of the next row is obtained by skipping +.sp +.ce +$k ~=~ 8 a left ceiling { n l } over { 8 a } right ceiling$ +.sp +components or indices. +.IP +The word \f2component\fP in this description refers to the nonindex values +red, +green, +blue, +alpha, +and depth. +Storage format _const(RGB), +for example, +has three components per pixel: +first red, +then green, +and finally blue. +.TP +_const(UNPACK_IMAGE_HEIGHT) +If greater than 0, +_const(UNPACK_IMAGE_HEIGHT) defines the number of pixels in an image of +a three-dimensional texture volume. Where ``image'' is defined by all +pixel sharing the same third dimension index. +If the first pixel of a row is placed at location $p$ in memory, +then the location of the first pixel of the next row is obtained by skipping +.sp +.ce +$k ~=~~ left {~ lpile { n l h above {a over s left ceiling { s n l h } +over a ^ right ceiling}} ~~ lpile {s ~ >=~ a above s ~<~ a }$ +.sp +components or indices, +where $n$ is the number of components or indices in a pixel, +$l$ is the number of pixels in a row +(_const(UNPACK_ROW_LENGTH) if it is greater than 0, +the $width$ argument to _cmnd(TexImage3D) otherwise), +$h$ is the number of rows in an image (_const(UNPACK_IMAGE_HEIGHT) if +it is greater than 0, the $height$ argument to _cmnd(TexImage3D) otherwise), +$a$ is the value of _const(UNPACK_ALIGNMENT), and +$s$ is the size, in bytes, of a single component +(if $ a < s$, then it is as if $a ~=~ s$). +.IP +The word \f2component\fP in this description refers to the nonindex values +red, +green, +blue, +alpha, +and depth. +Storage format _const(RGB), +for example, +has three components per pixel: +first red, +then green, +and finally blue. +.TP +_const(UNPACK_SKIP_PIXELS) and _const(UNPACK_SKIP_ROWS) +These values are provided as a convenience to the programmer; +they provide no functionality that cannot be duplicated by +incrementing the pointer passed to +_cmnd(DrawPixels), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(Bitmap), or +_cmnd(PolygonStipple). +Setting _const(UNPACK_SKIP_PIXELS) to $i$ is equivalent to incrementing +the pointer by $i n$ components or indices, +where $n$ is the number of components or indices in each pixel. +Setting _const(UNPACK_SKIP_ROWS) to $j$ is equivalent to incrementing +the pointer by $j k$ components or indices, +where $k$ is the number of components or indices per row, +as just computed in the _const(UNPACK_ROW_LENGTH) section. +.TP +_const(UNPACK_ALIGNMENT) +Specifies the alignment requirements for the start of each pixel row in memory. +The allowable values are +1 (byte-alignment), +2 (rows aligned to even-numbered bytes), +4 (word-alignment), and +8 (rows start on double-word boundaries). +.P +The following table gives the type, +initial value, +and range of valid values for each storage parameter +that can be set with _cmnd. +.sp + +.TS +center tab(:) delim($$) ; +lb cb cb cb +l c c c. +_ +_param1:Type:Initial Value:Valid Range +_ +_const(PACK_SWAP_BYTES):boolean:false:true or false +_const(PACK_LSB_FIRST):boolean:false:true or false +_const(PACK_ROW_LENGTH):integer:0:[0,\(if) +_const(PACK_IMAGE_HEIGHT):integer:0:[0, \(if) +_const(PACK_SKIP_ROWS):integer:0:[0,\(if) +_const(PACK_SKIP_PIXELS):integer:0:[0,\(if) +_const(PACK_SKIP_IMAGES):integer:0:[0,\(if) +_const(PACK_ALIGNMENT):integer:4:1, 2, 4, or 8 +_ +_const(UNPACK_SWAP_BYTES):boolean:false:true or false +_const(UNPACK_LSB_FIRST):boolean:false:true or false +_const(UNPACK_ROW_LENGTH):integer:0:[0,\(if) +_const(UNPACK_IMAGE_HEIGHT):integer:0:[0,\(if) +_const(UNPACK_SKIP_ROWS):integer:0:[0,\(if) +_const(UNPACK_SKIP_PIXELS):integer:0:[0,\(if) +_const(UNPACK_SKIP_IMAGES):integer:0:[0,\(if) +_const(UNPACK_ALIGNMENT):integer:4:1, 2, 4, or 8 +_ +.TE + +.sp +_cmnd(PixelStoref) can be used to set any pixel store parameter. +If the parameter type is boolean, +then if _param2 is 0, +the parameter is false; +otherwise it is set to true. +If _param1 is a integer type parameter, +_param2 is rounded to the nearest integer. +.P +Likewise, _cmnd(PixelStorei) can also be used to set any of the +pixel store parameters. +Boolean parameters are set to false if _param2 is 0 and true otherwise. +.SH NOTES +The pixel storage modes in effect when +_cmnd(DrawPixels), +_cmnd(ReadPixels), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D), +_cmnd(Bitmap), +or _cmnd(PolygonStipple) is placed in a display list control the interpretation +of memory data. +Likewise, if the _arbstring(imaging) extension is supported, the pixel +storage modes in effect when +_cmnd(ColorTable), +_cmnd(ColorSubTable), +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), of +_cmnd(SeparableFilter2D) is placed in a display list control the +intrepretation of memory data. +The pixel storage modes in effect when a display list is executed are +not significant. +.P +Pixel storage modes are client state and must be pushed and restored +using +.br +_cmnd(PushClientAttrib) and _cmnd(PopClientAttrib). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if a negative row length, +pixel skip, +or row skip value is specified, +or if alignment is specified as other than 1, 2, 4, or 8. +.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(Get) with argument _const(PACK_SWAP_BYTES) +.br +_cmnd(Get) with argument _const(PACK_LSB_FIRST) +.br +_cmnd(Get) with argument _const(PACK_ROW_LENGTH) +.br +_cmnd(Get) with argument _const(PACK_IMAGE_HEIGHT) +.br +_cmnd(Get) with argument _const(PACK_SKIP_ROWS) +.br +_cmnd(Get) with argument _const(PACK_SKIP_PIXELS) +.br +_cmnd(Get) with argument _const(PACK_SKIP_IMAGES) +.br +_cmnd(Get) with argument _const(PACK_ALIGNMENT) +.br +_cmnd(Get) with argument _const(UNPACK_SWAP_BYTES) +.br +_cmnd(Get) with argument _const(UNPACK_LSB_FIRST) +.br +_cmnd(Get) with argument _const(UNPACK_ROW_LENGTH) +.br +_cmnd(Get) with argument _const(UNPACK_IMAGE_HEIGHT) +.br +_cmnd(Get) with argument _const(UNPACK_SKIP_ROWS) +.br +_cmnd(Get) with argument _const(UNPACK_SKIP_PIXELS) +.br +_cmnd(Get) with argument _const(UNPACK_SKIP_IMAGES) +.br +_cmnd(Get) with argument _const(UNPACK_ALIGNMENT) +.SH SEE ALSO +_cmnd(Bitmap), +_cmnd(ColorTable), +_cmnd(ColorSubTable), +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), +_cmnd(SeparableFilter2D), +_cmnd(DrawPixels), +_cmnd(Histogram), +_cmnd(Minmax), +_cmnd(PixelMap), +_cmnd(PixelTransfer), +_cmnd(PixelZoom), +_cmnd(PolygonStipple), +_cmnd(PushClientAttrib), +_cmnd(ReadPixels), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixeltransfer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixeltransfer.gl new file mode 100644 index 000000000..81ad90f06 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixeltransfer.gl @@ -0,0 +1,446 @@ +_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(PixelTransfer, set pixel transfer modes) +_names(PixelTransfer,[fi]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the symbolic name of the pixel transfer parameter to be set. +Must be one of the following: +_const(MAP_COLOR), +_const(MAP_STENCIL), +_const(INDEX_SHIFT), +_const(INDEX_OFFSET), +_const(RED_SCALE), +_const(RED_BIAS), +_const(GREEN_SCALE), +_const(GREEN_BIAS), +_const(BLUE_SCALE), +_const(BLUE_BIAS), +_const(ALPHA_SCALE), +_const(ALPHA_BIAS), +_const(DEPTH_SCALE), or +_const(DEPTH_BIAS). +.IP +Additionally, if the _arbstring(imaging) extension is supported, the +following symbolic names are accepted: +_const(POST_COLOR_MATRIX_RED_SCALE), +_const(POST_COLOR_MATRIX_GREEN_SCALE), +_const(POST_COLOR_MATRIX_BLUE_SCALE), +_const(POST_COLOR_MATRIX_ALPHA_SCALE), +_const(POST_COLOR_MATRIX_RED_BIAS), +_const(POST_COLOR_MATRIX_GREEN_BIAS), +_const(POST_COLOR_MATRIX_BLUE_BIAS), +_const(POST_COLOR_MATRIX_ALPHA_BIAS), +_const(POST_CONVOLUTION_RED_SCALE), +_const(POST_CONVOLUTION_GREEN_SCALE), +_const(POST_CONVOLUTION_BLUE_SCALE), +_const(POST_CONVOLUTION_ALPHA_SCALE), +_const(POST_CONVOLUTION_RED_BIAS), +_const(POST_CONVOLUTION_GREEN_BIAS), +_const(POST_CONVOLUTION_BLUE_BIAS), and +_const(POST_CONVOLUTION_ALPHA_BIAS). +_phead(_param2) +Specifies the value that _param1 is set to. +.SH DESCRIPTION +_cmnd sets pixel transfer modes that affect the operation of subsequent +_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) commands. +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) are also affected. +The algorithms that are specified by pixel transfer modes operate on +pixels after they are read from the frame buffer +(_cmnd(CopyPixels) +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), and +_cmnd(ReadPixels)), +or unpacked from client memory +(_cmnd(DrawPixels), _cmnd(TexImage1D), _cmnd(TexImage2D), _cmnd(TexImage3D), +_cmnd(TexSubImage1D), _cmnd(TexSubImage2D), and _cmnd(TexSubImage3D)). +Pixel transfer operations happen in the same order, +and in the same manner, +regardless of the command that resulted in the pixel operation. +Pixel storage modes +(see _cmnd(PixelStore)) +control the unpacking of pixels being read from client memory, +and the packing of pixels being written back into client memory. +.P +Pixel transfer operations handle four fundamental pixel types: +\f2color\fP, +\f2color index\fP, +\f2depth\fP, and +\f2stencil\fP. +\f2Color\fP pixels consist of four floating-point values +with unspecified mantissa and exponent sizes, +scaled such that 0 represents zero intensity +and 1 represents full intensity. +\f2Color indices\fP comprise a single fixed-point value, +with unspecified precision to the right of the binary point. +\f2Depth\fP pixels comprise a single floating-point value, +with unspecified mantissa and exponent sizes, +scaled such that 0.0 represents the minimum depth buffer value, +and 1.0 represents the maximum depth buffer value. +Finally, +\f2stencil\fP pixels comprise a single fixed-point value, +with unspecified precision to the right of the binary point. +.BP +.P +The pixel transfer operations performed on the four basic pixel types are +as follows: +.TP 12 +Color +Each of the four color components is multiplied by a scale factor, +then added to a bias factor. +That is, +the red component is multiplied by _const(RED_SCALE), +then added to _const(RED_BIAS); +the green component is multiplied by _const(GREEN_SCALE), +then added to _const(GREEN_BIAS); +the blue component is multiplied by _const(BLUE_SCALE), +then added to _const(BLUE_BIAS); and +the alpha component is multiplied by _const(ALPHA_SCALE), +then added to _const(ALPHA_BIAS). +After all four color components are scaled and biased, +each is clamped to the range [0,1]. +All color, scale, and bias values are specified with _cmnd. +.IP +If _const(MAP_COLOR) is true, +each color component is scaled by the size of the corresponding +color-to-color map, +then replaced by the contents of that map indexed by the scaled component. +That is, +the red component is scaled by _const(PIXEL_MAP_R_TO_R_SIZE), +then replaced by the contents of _const(PIXEL_MAP_R_TO_R) indexed by itself. +The green component is scaled by _const(PIXEL_MAP_G_TO_G_SIZE), +then replaced by the contents of _const(PIXEL_MAP_G_TO_G) indexed by itself. +The blue component is scaled by _const(PIXEL_MAP_B_TO_B_SIZE), +then replaced by the contents of _const(PIXEL_MAP_B_TO_B) indexed by itself. +And +the alpha component is scaled by _const(PIXEL_MAP_A_TO_A_SIZE), +then replaced by the contents of _const(PIXEL_MAP_A_TO_A) indexed by itself. +All components taken from the maps are then clamped to the range [0,1]. +_const(MAP_COLOR) is specified with _cmnd. +The contents of the various maps are specified with _cmnd(PixelMap). +.IP +If the _arbstring(imaging) extension is supported, each of the four +color components may be scaled and biased after tranformation by the +color matrix. +That is, +the red component is multiplied by _const(POST_COLOR_MATRIX_RED_SCALE), +then added to _const(POST_COLOR_MATRIX_RED_BIAS); +the green component is multiplied by _const(POST_COLOR_MATRIX_GREEN_SCALE), +then added to _const(POST_COLOR_MATRIX_GREEN_BIAS); +the blue component is multiplied by _const(POST_COLOR_MATRIX_BLUE_SCALE), +then added to _const(POST_COLOR_MATRIX_BLUE_BIAS); and +the alpha component is multiplied by _const(POST_COLOR_MATRIX_ALPHA_SCALE), +then added to _const(POST_COLOR_MATRIX_ALPHA_BIAS). +After all four color components are scaled and biased, +each is clamped to the range [0,1]. +.IP +Similiarly, if the _arbstring(imaging) extension is supported, each of +the four color components may be scaled and biased after processing by +the enabled convolution filter. +That is, +the red component is multiplied by _const(POST_CONVOLUTION_RED_SCALE), +then added to _const(POST_CONVOLUTION_RED_BIAS); +the green component is multiplied by _const(POST_CONVOLUTION_GREEN_SCALE), +then added to _const(POST_CONVOLUTION_GREEN_BIAS); +the blue component is multiplied by _const(POST_CONVOLUTION_BLUE_SCALE), +then added to _const(POST_CONVOLUTION_BLUE_BIAS); and +the alpha component is multiplied by _const(POST_CONVOLUTION_ALPHA_SCALE), +then added to _const(POST_CONVOLUTION_ALPHA_BIAS). +After all four color components are scaled and biased, +each is clamped to the range [0,1]. +.TP +Color index +Each color index is shifted left by _const(INDEX_SHIFT) bits; any bits +beyond the number of fraction bits carried +by the fixed-point index are filled with zeros. +If _const(INDEX_SHIFT) is negative, +the shift is to the right, +again zero filled. +Then _const(INDEX_OFFSET) is added to the index. +_const(INDEX_SHIFT) and _const(INDEX_OFFSET) are specified with +.br +_cmnd. +.IP +From this point, operation diverges depending on the required format of +the resulting pixels. +If the resulting pixels are to be written to a color index buffer, +or if they are being read back to client memory in _const(COLOR_INDEX) format, +the pixels continue to be treated as indices. +If _const(MAP_COLOR) is true, +each index is masked by $2 sup n ~-~ 1$, +where $n$ is _const(PIXEL_MAP_I_TO_I_SIZE), +then replaced by the contents of _const(PIXEL_MAP_I_TO_I) indexed by the +masked value. +_const(MAP_COLOR) is specified with _cmnd. +The contents of the index map is specified with _cmnd(PixelMap). +.IP +If the resulting pixels are to be written to an RGBA color buffer, +or if they are read back to client memory in a format other than +_const(COLOR_INDEX), +the pixels are converted from indices to colors by referencing the +four maps +_const(PIXEL_MAP_I_TO_R), +_const(PIXEL_MAP_I_TO_G), +_const(PIXEL_MAP_I_TO_B), and +_const(PIXEL_MAP_I_TO_A). +Before being dereferenced, +the index is masked by $2 sup n ~-~ 1$, +where $n$ is +_const(PIXEL_MAP_I_TO_R_SIZE) for the red map, +_const(PIXEL_MAP_I_TO_G_SIZE) for the green map, +_const(PIXEL_MAP_I_TO_B_SIZE) for the blue map, and +_const(PIXEL_MAP_I_TO_A_SIZE) for the alpha map. +All components taken from the maps are then clamped to the range [0,1]. +The contents of the four maps is specified with _cmnd(PixelMap). +.TP +Depth +Each depth value is multiplied by _const(DEPTH_SCALE), +added to _const(DEPTH_BIAS), +then clamped to the range [0,1]. +.TP +Stencil +Each index is shifted _const(INDEX_SHIFT) bits just as a color index is, +then added to _const(INDEX_OFFSET). +If _const(MAP_STENCIL) is true, +each index is masked by $2 sup n ~-~ 1$, +where $n$ is _const(PIXEL_MAP_S_TO_S_SIZE), +then replaced by the contents of _const(PIXEL_MAP_S_TO_S) indexed by the +masked value. +.P +The following table gives the type, +initial value, +and range of valid values for each of the pixel transfer parameters +that are set with _cmnd. +.sp + +.TS +center tab(:); +lb cb cb cb +l c c c. +_ +_param1:Type:Initial Value:Valid Range +_ +_const(MAP_COLOR):boolean:false:true/false +_const(MAP_STENCIL):boolean:false:true/false +_const(INDEX_SHIFT):integer:0:(-\(if,\(if) +_const(INDEX_OFFSET):integer:0:(-\(if,\(if) +_const(RED_SCALE):float:1:(-\(if,\(if) +_const(GREEN_SCALE):float:1:(-\(if,\(if) +_const(BLUE_SCALE):float:1:(-\(if,\(if) +_const(ALPHA_SCALE):float:1:(-\(if,\(if) +_const(DEPTH_SCALE):float:1:(-\(if,\(if) +_const(RED_BIAS):float:0:(-\(if,\(if) +_const(GREEN_BIAS):float:0:(-\(if,\(if) +_const(BLUE_BIAS):float:0:(-\(if,\(if) +_const(ALPHA_BIAS):float:0:(-\(if,\(if) +_const(DEPTH_BIAS):float:0:(-\(if,\(if) +_const(POST_COLOR_MATRIX_RED_SCALE):float:1:(-\(if,\(if) +_const(POST_COLOR_MATRIX_GREEN_SCALE):float:1:(-\(if,\(if) +_const(POST_COLOR_MATRIX_BLUE_SCALE):float:1:(-\(if,\(if) +_const(POST_COLOR_MATRIX_ALPHA_SCALE):float:1:(-\(if,\(if) +_const(POST_COLOR_MATRIX_RED_BIAS):float:0:(-\(if,\(if) +_const(POST_COLOR_MATRIX_GREEN_BIAS):float:0:(-\(if,\(if) +_const(POST_COLOR_MATRIX_BLUE_BIAS):float:0:(-\(if,\(if) +_const(POST_COLOR_MATRIX_ALPHA_BIAS):float:0:(-\(if,\(if) +_const(POST_CONVOLUTION_RED_SCALE):float:1:(-\(if,\(if) +_const(POST_CONVOLUTION_GREEN_SCALE):float:1:(-\(if,\(if) +_const(POST_CONVOLUTION_BLUE_SCALE):float:1:(-\(if,\(if) +_const(POST_CONVOLUTION_ALPHA_SCALE):float:1:(-\(if,\(if) +_const(POST_CONVOLUTION_RED_BIAS):float:0:(-\(if,\(if) +_const(POST_CONVOLUTION_GREEN_BIAS):float:0:(-\(if,\(if) +_const(POST_CONVOLUTION_BLUE_BIAS):float:0:(-\(if,\(if) +_const(POST_CONVOLUTION_ALPHA_BIAS):float:0:(-\(if,\(if) +_ +.TE + +.sp +_cmnd(PixelTransferf) can be used to set any pixel transfer parameter. +If the parameter type is boolean, +0 implies false and any other value implies true. +If _param1 is an integer parameter, +_param2 is rounded to the nearest integer. +.P +Likewise, +_cmnd(PixelTransferi) can be used to set any of the +pixel transfer parameters. +Boolean parameters are set to false if _param2 is 0 and to true otherwise. +_param2 is converted to floating point before being assigned to real-valued parameters. +.SH NOTES +If a +_cmnd(ColorTable), +_cmnd(ColorSubTable), +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(ReadPixels), +_cmnd(SeparableFilter2D), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), or +_cmnd(TexSubImage3D). +command is placed in a display list +(see _cmnd(NewList) and _cmnd(CallList)), +the pixel transfer mode settings in effect when the display list is +.I executed +are the ones that are used. +They may be different from the settings when the command was compiled +into the display list. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not an accepted value. +.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(Get) with argument _const(MAP_COLOR) +.br +_cmnd(Get) with argument _const(MAP_STENCIL) +.br +_cmnd(Get) with argument _const(INDEX_SHIFT) +.br +_cmnd(Get) with argument _const(INDEX_OFFSET) +.br +_cmnd(Get) with argument _const(RED_SCALE) +.br +_cmnd(Get) with argument _const(RED_BIAS) +.br +_cmnd(Get) with argument _const(GREEN_SCALE) +.br +_cmnd(Get) with argument _const(GREEN_BIAS) +.br +_cmnd(Get) with argument _const(BLUE_SCALE) +.br +_cmnd(Get) with argument _const(BLUE_BIAS) +.br +_cmnd(Get) with argument _const(ALPHA_SCALE) +.br +_cmnd(Get) with argument _const(ALPHA_BIAS) +.br +_cmnd(Get) with argument _const(DEPTH_SCALE) +.br +_cmnd(Get) with argument _const(DEPTH_BIAS) +.br +_cmnd(Get) with argument _const(POST_COLOR_MATRIX_RED_SCALE) +.br +_cmnd(Get) with argument _const(POST_COLOR_MATRIX_RED_BIAS) +.br +_cmnd(Get) with argument _const(POST_COLOR_MATRIX_GREEN_SCALE) +.br +_cmnd(Get) with argument _const(POST_COLOR_MATRIX_GREEN_BIAS) +.br +_cmnd(Get) with argument _const(POST_COLOR_MATRIX_BLUE_SCALE) +.br +_cmnd(Get) with argument _const(POST_COLOR_MATRIX_BLUE_BIAS) +.br +_cmnd(Get) with argument _const(POST_COLOR_MATRIX_ALPHA_SCALE) +.br +_cmnd(Get) with argument _const(POST_COLOR_MATRIX_ALPHA_BIAS) +.br +_cmnd(Get) with argument _const(POST_CONVOLUTION_RED_SCALE) +.br +_cmnd(Get) with argument _const(POST_CONVOLUTION_RED_BIAS) +.br +_cmnd(Get) with argument _const(POST_CONVOLUTION_GREEN_SCALE) +.br +_cmnd(Get) with argument _const(POST_CONVOLUTION_GREEN_BIAS) +.br +_cmnd(Get) with argument _const(POST_CONVOLUTION_BLUE_SCALE) +.br +_cmnd(Get) with argument _const(POST_CONVOLUTION_BLUE_BIAS) +.br +_cmnd(Get) with argument _const(POST_CONVOLUTION_ALPHA_SCALE) +.br +_cmnd(Get) with argument _const(POST_CONVOLUTION_ALPHA_BIAS) +.SH SEE ALSO +_cmnd(CallList), +_cmnd(ColorTable), +_cmnd(ColorSubTable), +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(NewList), +_cmnd(PixelMap), +_cmnd(PixelStore), +_cmnd(PixelZoom), +_cmnd(ReadPixels), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelzoom.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelzoom.gl new file mode 100644 index 000000000..af53325ba --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pixelzoom.gl @@ -0,0 +1,75 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(PixelZoom,specify the pixel zoom factors) +_names(PixelZoom) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2) +Specify the $x$ and $y$ zoom factors for pixel write operations. +.SH DESCRIPTION +_cmnd specifies values for the $x$ and $y$ zoom factors. +During the execution of _cmnd(DrawPixels) or _cmnd(CopyPixels), +if ($xr $, $yr $) is the current raster position, +and a given element is in the $m$th row and $n$th column of the pixel rectangle, +then pixels whose centers are in the rectangle with corners at +.sp +.ce +($xr ~+~ n cdot _eqnparam1$, $yr ~+~ m cdot _eqnparam2$) +.sp +.ce +($xr ~+~ (n+1) cdot _eqnparam1$, $yr ~+~ (m+1) cdot _eqnparam2$) +.sp +are candidates for replacement. +Any pixel whose center lies on the bottom or left edge of this rectangular +region is also modified. +.P +Pixel zoom factors are not limited to positive values. +Negative zoom factors reflect the resulting image about the current +raster position. +.SH ERRORS +_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(Get) with argument _const(ZOOM_X) +.br +_cmnd(Get) with argument _const(ZOOM_Y) +.SH SEE ALSO +_cmnd(CopyPixels), +_cmnd(DrawPixels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pointsize.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pointsize.gl new file mode 100644 index 000000000..0795df0d8 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pointsize.gl @@ -0,0 +1,145 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(PointSize,specify the diameter of rasterized points) +_names(PointSize) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the diameter of rasterized points. +The initial value is 1. +.SH DESCRIPTION +_cmnd specifies the rasterized diameter of both aliased and antialiased +points. +Using a point size other than 1 has different effects, +depending on whether point antialiasing is enabled. +To enable and disable point antialiasing, call +_cmnd(Enable) and _cmnd(Disable) +with argument _const(POINT_SMOOTH). Point antialiasing is initially disabled. +.P +If point antialiasing is disabled, +the actual size is determined by rounding the supplied size +to the nearest integer. +(If the rounding results in the value 0, +it is as if the point size were 1.) +If the rounded size is odd, +then the center point +($ x $, $ y $) +of the pixel fragment that represents the point is computed as +.sp +.ce +( $ \(lf ~ x sub w ~ \(rf ~+~ .5 $, $ \(lf ~ y sub w ~ \(rf ~+~ .5 $) +.sp +where $w$ subscripts indicate window coordinates. +All pixels that lie within the square grid of the rounded size centered at +($ x $, $ y $) +make up the fragment. +If the size is even, +the center point is +.sp +.ce +( $ \(lf ~ x sub w ~+~ .5 ~ \(rf$, $ \(lf ~ y sub w ~+~ .5 ~ \(rf $) +.sp +and the rasterized fragment's centers are the half-integer window coordinates +within the square of the rounded size centered at +($ x $, $ y $). +All pixel fragments produced in rasterizing a nonantialiased point are +assigned the same associated data, +that of the vertex corresponding to the point. +.P +If antialiasing is enabled, +then point rasterization produces a fragment for each pixel square +that intersects the region lying within the circle having diameter +equal to the current point size and centered at the point's +($ x sub w $, $ y sub w $). +The coverage value for each fragment is the window coordinate area +of the intersection of the circular region with the corresponding pixel square. +This value is saved and used in the final rasterization step. +The data associated with each fragment is the data associated with +the point being rasterized. +.P +Not all sizes are supported when point antialiasing is enabled. +If an unsupported size is requested, +the nearest supported size is used. +Only size 1 is guaranteed to be supported; +others depend on the implementation. +To query the range of supported sizes and the size difference between +supported sizes within the range, call +_cmnd(Get) with arguments +_const(SMOOTH_POINT_SIZE_RANGE) and +_const(SMOOTH_POINT_SIZE_GRANULARITY). +For aliased points, query the supported ranges and granularity with +_cmnd(Get) with arguments +_const(ALIASED_POINT_SIZE_RANGE) and +_const(ALIASED_POINT_SIZE_GRANULARITY). +.SH NOTES +The point size specified by _cmnd is always returned when _const(POINT_SIZE) +is queried. +Clamping and rounding for aliased and antialiased points have no effect +on the specified value. +.P +A non-antialiased point size may be clamped to an implementation-dependent +maximum. +Although this maximum cannot be queried, +it must be no less than the maximum value for antialiased points, +rounded to the nearest integer value. +.P +_const(POINT_SIZE_RANGE) and _const(POINT_SIZE_GRANULARITY) are +deprecated in GL versions 1.2 and greater. Their functionality has been +replaced by _const(SMOOTH_POINT_SIZE_RANGE) and +_const(SMOOTH_POINT_SIZE_GRANULARITY). +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is less than or equal to 0. +.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(Get) with argument _const(POINT_SIZE) +.br +_cmnd(Get) with argument _const(ALIASED_POINT_SIZE_RANGE) +.br +_cmnd(Get) with argument _const(ALIASED_POINT_SIZE_GRANULARITY) +.br +_cmnd(Get) with argument _const(SMOOTH_POINT_SIZE_RANGE) +.br +_cmnd(Get) with argument _const(SMOOTH_POINT_SIZE_GRANULARITY) +.br +_cmnd(IsEnabled) with argument _const(POINT_SMOOTH) +.SH SEE ALSO +_cmnd(Enable) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/polygonmode.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/polygonmode.gl new file mode 100644 index 000000000..2a54f5d98 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/polygonmode.gl @@ -0,0 +1,117 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(PolygonMode,select a polygon rasterization mode) +_names(PolygonMode) +.SH PARAMETERS +_phead(_param1) +Specifies the polygons that _param2 applies to. +Must be +_const(FRONT) for front-facing polygons, +_const(BACK) for back-facing polygons, +or _const(FRONT_AND_BACK) for front- and back-facing polygons. +_phead(_param2) +Specifies how polygons will be rasterized. +Accepted values are +_const(POINT), +_const(LINE), and +_const(FILL). +The initial value is _const(FILL) for both front- and back-facing polygons. +.SH DESCRIPTION +_cmnd controls the interpretation of polygons for rasterization. +_param1 describes which polygons _param2 applies to: +front-facing polygons (_const(FRONT)), +back-facing polygons (_const(BACK)), +or both (_const(FRONT_AND_BACK)). +The polygon mode affects only the final rasterization of polygons. +In particular, +a polygon's vertices are lit and +the polygon is clipped and possibly culled before these modes are applied. +.P +Three modes are defined and can be specified in _param2: +.TP 14 +_const(POINT) +Polygon vertices that are marked as the start of a boundary edge +are drawn as points. +Point attributes such as +_const(POINT_SIZE) and +_const(POINT_SMOOTH) control +the rasterization of the points. +Polygon rasterization attributes other than _const(POLYGON_MODE) have no effect. +.TP +_const(LINE) +Boundary edges of the polygon are drawn as line segments. +They are treated as connected line segments for line stippling; +the line stipple counter and pattern are not reset between segments +(see _cmnd(LineStipple)). +Line attributes such as +_const(LINE_WIDTH) and +_const(LINE_SMOOTH) control +the rasterization of the lines. +Polygon rasterization attributes other than _const(POLYGON_MODE) have no effect. +.TP +_const(FILL) +The interior of the polygon is filled. +Polygon attributes such as +_const(POLYGON_STIPPLE) and +_const(POLYGON_SMOOTH) control the rasterization of the polygon. +.SH EXAMPLES +To draw a surface with filled back-facing polygons +and outlined front-facing polygons, +call +.Ex 1 +glPolygonMode(_const(FRONT), _const(LINE)); +.Ee +.SH NOTES +Vertices are marked as boundary or nonboundary with an edge flag. +Edge flags are generated internally by the GL when it decomposes +polygons; they can be set explicitly using _cmnd(EdgeFlag). +.SH ERRORS +_const(INVALID_ENUM) is generated if either _param1 or _param2 is not +an accepted value. +.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(Get) with argument _const(POLYGON_MODE) +.SH SEE ALSO +_cmnd(Begin), +_cmnd(EdgeFlag), +_cmnd(LineStipple), +_cmnd(LineWidth), +_cmnd(PointSize), +_cmnd(PolygonStipple) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/polygonoffset.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/polygonoffset.gl new file mode 100644 index 000000000..4ec2114e2 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/polygonoffset.gl @@ -0,0 +1,87 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(PolygonOffset, set the scale and units used to calculate depth values) +_names(PolygonOffset) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a scale factor that is used to create a variable +depth offset for each polygon. The initial value is 0. +_phead(_param2) +Is multiplied by an implementation-specific value to +create a constant depth offset. The initial value is 0. +.SH DESCRIPTION +When _const(POLYGON_OFFSET_FILL), _const(POLYGON_OFFSET_LINE), or +_const(POLYGON_OFFSET_POINT) is enabled, each +fragment's \f2depth\fP value will be offset after it is interpolated +from the \f2depth\fP values of the appropriate vertices. +The value of the offset is $_eqnparam1 ~*~ DZ ~~+~~ r ~*~ _eqnparam2$, +where $DZ~$ is a measurement of the change in depth relative to the screen +area of the polygon, and $r$ is the smallest value that is guaranteed to +produce a resolvable offset for a given implementation. +The offset is added before the depth test is performed and before +the value is written into the depth buffer. +.P +_cmnd is useful for rendering hidden-line images, for applying decals +to surfaces, and for rendering solids with highlighted edges. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +_cmnd has no effect on depth coordinates placed in the +feedback buffer. +.P +_cmnd has no effect on selection. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.bp +.SH ASSOCIATED GETS +_cmnd(IsEnabled) with argument +_const(POLYGON_OFFSET_FILL), +_const(POLYGON_OFFSET_LINE), +or _const(POLYGON_OFFSET_POINT). +.P +_cmnd(Get) with argument _const(POLYGON_OFFSET_FACTOR) or +_const(POLYGON_OFFSET_UNITS). +.SH SEE ALSO +_cmnd(DepthFunc), +_cmnd(Enable), +_cmnd(Get), +_cmnd(IsEnabled) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/polygonstipple.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/polygonstipple.gl new file mode 100644 index 000000000..d63cd4b53 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/polygonstipple.gl @@ -0,0 +1,97 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(PolygonStipple,set the polygon stippling pattern) +_names(PolygonStipple) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to a $32 ~times~ 32$ stipple pattern that will be unpacked +from memory in the same way that _cmnd(DrawPixels) unpacks pixels. +.SH DESCRIPTION +Polygon stippling, +like line stippling +(see _cmnd(LineStipple)), +masks out certain fragments produced by rasterization, +creating a pattern. +Stippling is independent of polygon antialiasing. +.P +_param1 is a pointer to a $32 ~times~ 32$ stipple pattern that is stored +in memory just like the pixel data supplied to a _cmnd(DrawPixels) +call with +.I +height +and +.I width +both equal to 32, a pixel format +of _const(COLOR_INDEX), and data type +of _const(BITMAP). +That is, +the stipple pattern is represented as a $32 ~times~ 32$ array +of 1-bit color indices packed in unsigned bytes. +_cmnd(PixelStore) parameters like _const(UNPACK_SWAP_BYTES) +and _const(UNPACK_LSB_FIRST) affect the assembling of the bits into a +stipple pattern. +Pixel transfer operations +(shift, offset, pixel map) +are not applied to the stipple image, +however. +.P +To enable and disable polygon stippling, call +_cmnd(Enable) and _cmnd(Disable) +with argument _const(POLYGON_STIPPLE). Polygon stippling is initially +disabled. If it's enabled, +a rasterized polygon fragment with window coordinates $x sub w$ and $y sub w$ +is sent to the next stage of the GL if and only if the +($x sub w~roman mod~32$)th bit in the ($y sub w~roman mod~32$)th row +of the stipple pattern is 1 (one). +When polygon stippling is disabled, it is as if the stipple pattern +consists of all 1's. +.SH ERRORS +_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(GetPolygonStipple) +.br +_cmnd(IsEnabled) with argument _const(POLYGON_STIPPLE) +.SH SEE ALSO +_cmnd(DrawPixels), +_cmnd(LineStipple), +_cmnd(PixelStore), +_cmnd(PixelTransfer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/prioritizetextures.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/prioritizetextures.gl new file mode 100644 index 000000000..bdbde4d8f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/prioritizetextures.gl @@ -0,0 +1,98 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(PrioritizeTextures, set texture residence priority) +_names(PrioritizeTextures) +.SH PARAMETERS +_define(@<__n>@,@<_param1>@)_C_ +_define(@<__textures>@,@<_param2>@)_C_ +_define(@<__priorities>@,@<_param3>@)_C_ +_phead(__n) +Specifies the number of textures to be prioritized. +_phead(__textures) +Specifies an array containing the names of the textures to be prioritized. +_phead(__priorities) +Specifies an array containing the texture priorities. +A priority given in an element of __priorities applies to the texture +named by the corresponding element of __textures. +.SH DESCRIPTION +_cmnd assigns the __n texture priorities given in __priorities to the +__n textures named in __textures. +.P +The GL establishes +a ``working set'' of textures that are resident in texture memory. +These textures may be bound to a texture target much more efficiently +than textures that are not resident. +By specifying a priority for each texture, +_cmnd allows applications to guide the GL implementation in determining +which textures should be resident. +.P +The priorities given in __priorities are clamped to the range [0,\1] +before they are assigned. +0 indicates the lowest priority; textures with priority 0 +are least likely to be resident. +1 indicates the highest priority; textures with priority 1 +are most likely to be resident. +However, textures are not guaranteed to be resident until they are used. +.P +_cmnd silently ignores attempts to prioritize texture 0, or any texture +name that does not correspond to an existing texture. +.P +_cmnd does not require that any of the textures named by __textures +be bound to a texture target. +_cmnd(TexParameter) may also be used to set a texture's priority, +but only if the texture is currently bound. +This is the only way to set the priority of a default texture. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.SH ERRORS +_const(INVALID_VALUE) is generated if __n is negative. +.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(GetTexParameter) with parameter name _const(TEXTURE_PRIORITY) +retrieves the priority of a currently bound texture. +.SH SEE ALSO +_cmnd(AreTexturesResident), +_cmnd(BindTexture), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexParameter) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushattrib.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushattrib.gl new file mode 100644 index 000000000..a1b1001b9 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushattrib.gl @@ -0,0 +1,279 @@ +_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,eqn|tbl)_C_ +_header(PushAttrib,push and pop the server attribute stack) +_names(PushAttrib) +.SH PARAMETERS +_phead(_param1) +Specifies a mask that indicates which attributes to save. Values for +_param1 are listed below. +_names(PopAttrib) +.SH DESCRIPTION +_cmnd takes one argument, +a mask that indicates which groups of state variables +to save on the attribute stack. +Symbolic constants are used to set bits in the mask. +_param1(1) +is typically constructed by ORing several of these constants together. +The special mask +_const(ALL_ATTRIB_BITS) +can be used to save all stackable states. +.P +The symbolic mask constants and their associated GL state are as follows +(the second column lists which attributes are saved): +.P +.TS +; +l l . +_const(ACCUM_BUFFER_BIT) Accumulation buffer clear value + +_const(COLOR_BUFFER_BIT) _const(ALPHA_TEST) enable bit + Alpha test function and reference value + _const(BLEND) enable bit + Blending source and destination functions + Constant blend color + Blending equation + _const(DITHER) enable bit + _const(DRAW_BUFFER) setting + _const(COLOR_LOGIC_OP) enable bit + _const(INDEX_LOGIC_OP) enable bit + Logic op function + Color mode and index mode clear values + Color mode and index mode writemasks + +_const(CURRENT_BIT) Current RGBA color + Current color index + Current normal vector + Current texture coordinates + Current raster position + _const(CURRENT_RASTER_POSITION_VALID) flag + RGBA color associated with current raster position + Color index associated with current raster position + Texture coordinates associated with current raster position + _const(EDGE_FLAG) flag + +_const(DEPTH_BUFFER_BIT) _const(DEPTH_TEST) enable bit + Depth buffer test function + Depth buffer clear value + _const(DEPTH_WRITEMASK) enable bit + +_const(ENABLE_BIT) _const(ALPHA_TEST) flag + _const(AUTO_NORMAL) flag + _const(BLEND) flag + Enable bits for the user-definable clipping planes + _const(COLOR_MATERIAL) + _const(CULL_FACE) flag + _const(DEPTH_TEST) flag + _const(DITHER) flag + _const(FOG) flag + _const(LIGHT)\f2i\fP where 0\ <= \f2i\fP<_const(MAX_LIGHTS) + _const(LIGHTING) flag + _const(LINE_SMOOTH) flag + _const(LINE_STIPPLE) flag + _const(COLOR_LOGIC_OP) flag + _const(INDEX_LOGIC_OP) flag + _const(MAP1_)\f2x\fP where \f2x\fP is a map type + _const(MAP2_)\f2x\fP where \f2x\fP is a map type + _const(NORMALIZE) flag + _const(POINT_SMOOTH) flag + _const(POLYGON_OFFSET_LINE) flag + _const(POLYGON_OFFSET_FILL) flag + _const(POLYGON_OFFSET_POINT) flag + _const(POLYGON_SMOOTH) flag + _const(POLYGON_STIPPLE) flag + _const(SCISSOR_TEST) flag + _const(STENCIL_TEST) flag + _const(TEXTURE_1D) flag + _const(TEXTURE_2D) flag + _const(TEXTURE_3D) flag + Flags _const(TEXTURE_GEN_)\f2x\fP where \f2x\fP is S, T, R, or Q + +_const(EVAL_BIT) _const(MAP1_)\f2x\fP enable bits, where \f2x\fP is a map type + _const(MAP2_)\f2x\fP enable bits, where \f2x\fP is a map type + 1D grid endpoints and divisions + 2D grid endpoints and divisions + _const(AUTO_NORMAL) enable bit + +_const(FOG_BIT) _const(FOG) enable bit + Fog color + Fog density + Linear fog start + Linear fog end + Fog index + _const(FOG_MODE) value + +_const(HINT_BIT) _const(PERSPECTIVE_CORRECTION_HINT) setting + _const(POINT_SMOOTH_HINT) setting + _const(LINE_SMOOTH_HINT) setting + _const(POLYGON_SMOOTH_HINT) setting + _const(FOG_HINT) setting + +_const(LIGHTING_BIT) _const(COLOR_MATERIAL) enable bit + _const(COLOR_MATERIAL_FACE) value + Color material parameters that are tracking the current color + Ambient scene color + _const(LIGHT_MODEL_LOCAL_VIEWER) value + _const(LIGHT_MODEL_TWO_SIDE) setting + _const(LIGHTING) enable bit + Enable bit for each light + Ambient, diffuse, and specular intensity for each light + Direction, position, exponent, and cutoff angle for each light + Constant, linear, and quadratic attenuation factors for each light + Ambient, diffuse, specular, and emissive color for each material + Ambient, diffuse, and specular color indices for each material + Specular exponent for each material + _const(SHADE_MODEL) setting + +_const(LINE_BIT) _const(LINE_SMOOTH) flag + _const(LINE_STIPPLE) enable bit + Line stipple pattern and repeat counter + Line width + +_const(LIST_BIT) _const(LIST_BASE) setting + +_const(PIXEL_MODE_BIT) _const(RED_BIAS) and _const(RED_SCALE) settings + _const(GREEN_BIAS) and _const(GREEN_SCALE) values + _const(BLUE_BIAS) and _const(BLUE_SCALE) + _const(ALPHA_BIAS) and _const(ALPHA_SCALE) + _const(DEPTH_BIAS) and _const(DEPTH_SCALE) + _const(INDEX_OFFSET) and _const(INDEX_SHIFT) values + _const(MAP_COLOR) and _const(MAP_STENCIL) flags + _const(ZOOM_X) and _const(ZOOM_Y) factors + _const(READ_BUFFER) setting + +_const(POINT_BIT) _const(POINT_SMOOTH) flag + Point size + +_const(POLYGON_BIT) _const(CULL_FACE) enable bit + _const(CULL_FACE_MODE) value + _const(FRONT_FACE) indicator + _const(POLYGON_MODE) setting + _const(POLYGON_SMOOTH) flag + _const(POLYGON_STIPPLE) enable bit + _const(POLYGON_OFFSET_FILL) flag + _const(POLYGON_OFFSET_LINE) flag + _const(POLYGON_OFFSET_POINT) flag + _const(POLYGON_OFFSET_FACTOR) + _const(POLYGON_OFFSET_UNITS) + +_const(POLYGON_STIPPLE_BIT) Polygon stipple image + +_const(SCISSOR_BIT) _const(SCISSOR_TEST) flag + Scissor box + +_const(STENCIL_BUFFER_BIT) _const(STENCIL_TEST) enable bit + Stencil function and reference value + Stencil value mask + Stencil fail, pass, and depth buffer pass actions + Stencil buffer clear value + Stencil buffer writemask + +_const(TEXTURE_BIT) Enable bits for the four texture coordinates + Border color for each texture image + Minification function for each texture image + Magnification function for each texture image + Texture coordinates and wrap mode for each texture image + Color and mode for each texture environment + Enable bits _const(TEXTURE_GEN_)\f2x\fP, \f2x\fP is S, T, R, and Q + _const(TEXTURE_GEN_MODE) setting for S, T, R, and Q + _cmnd(TexGen) plane equations for S, T, R, and Q + Current texture bindings (for example, _const(TEXTURE_BINDING_2D)) + +_const(TRANSFORM_BIT) Coefficients of the six clipping planes + Enable bits for the user-definable clipping planes + _const(MATRIX_MODE) value + _const(NORMALIZE) flag + _const(RESCALE_NORMAL) flag + +_const(VIEWPORT_BIT) Depth range (near and far) + Viewport origin and extent +.TE +.P +_cmnd(PopAttrib) restores the values of the state variables saved with the last +.br +_cmnd(PushAttrib) command. +Those not saved are left unchanged. +.P +It is an error to push attributes onto a full stack, +or to pop attributes off an empty stack. +In either case, the error flag is set +and no other change is made to GL state. +.P +Initially, the attribute stack is empty. +.SH NOTES +Not all values for GL state can be saved on the attribute stack. +For example, +render mode state, +and select and feedback state cannot be saved. +Client state must be saved with +_cmnd(PushClientAttrib). +.P +The depth of the attribute stack depends on the implementation, +but it must be at least 16. +.P +When the _arbstring(multitexture) extension is supported, pushing and +popping texture state applies to all supported texture units. +.SH ERRORS +_const(STACK_OVERFLOW) is generated if _cmnd(PushAttrib) is called while +the attribute stack is full. +.P +_const(STACK_UNDERFLOW) is generated if _cmnd(PopAttrib) is called while +the attribute stack is empty. +.P +_const(INVALID_OPERATION) is generated if _cmnd(PushAttrib) or _cmnd(PopAttrib) +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(ATTRIB_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(MAX_ATTRIB_STACK_DEPTH) +.SH SEE ALSO +_cmnd(Get), +_cmnd(GetClipPlane), +_cmnd(GetError), +_cmnd(GetLight), +_cmnd(GetMap), +_cmnd(GetMaterial), +.br +_cmnd(GetPixelMap), +_cmnd(GetPolygonStipple), +_cmnd(GetString), +_cmnd(GetTexEnv), +_cmnd(GetTexGen), +_cmnd(GetTexImage), +_cmnd(GetTexLevelParameter), +_cmnd(GetTexParameter), +_cmnd(IsEnabled), +_cmnd(PushClientAttrib) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushclientattrib.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushclientattrib.gl new file mode 100644 index 000000000..16d5284f0 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushclientattrib.gl @@ -0,0 +1,111 @@ +_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,eqn|tbl)_C_ +_header(PushClientAttrib,push and pop the client attribute stack) +_names(PushClientAttrib) +.SH PARAMETERS +_phead(_param1) +Specifies a mask that indicates which attributes to save. Values for +_param1 are listed below. +_names(PopClientAttrib) +.SH DESCRIPTION +_cmnd takes one argument, +a mask that indicates which groups of client-state variables +to save on the client attribute stack. +Symbolic constants are used to set bits in the mask. +_param1(1) +is typically constructed by OR'ing several of these constants together. +The special mask +_const(CLIENT_ALL_ATTRIB_BITS) +can be used to save all stackable client state. +.P +The symbolic mask constants and their associated GL client state are as follows +(the second column lists which attributes are saved): +.P +_const(CLIENT_PIXEL_STORE_BIT) Pixel storage modes +.br +_const(CLIENT_VERTEX_ARRAY_BIT) Vertex arrays (and enables) +.P +_cmnd(PopClientAttrib) restores the values of the client-state variables +saved with the last _cmnd(PushClientAttrib). +Those not saved are left unchanged. +.P +It is an error to push attributes onto a full client attribute stack, +or to pop attributes off an empty stack. +In either case, the error flag is set, +and no other change is made to GL state. +.P +Initially, the client attribute stack is empty. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +Not all values for GL client state can be saved on the attribute stack. +For example, select and feedback state cannot be saved. +.P +The depth of the attribute stack depends on the implementation, +but it must be at least 16. +.P +Use _cmnd(PushAttrib) and _cmnd(PopAttrib) to push and restore +state which is kept on the server. Only pixel storage modes and +vertex array state may be pushed and popped with +_cmnd(PushClientAttrib) and _cmnd(PopClientAttrib). +.P +When the _arbstring(multitexture) extension is supported, pushing and +popping client vertex array state apples to all supported texture units, +and the active client texture state. +.SH ERRORS +_const(STACK_OVERFLOW) is generated if _cmnd(PushClientAttrib) is called while +the attribute stack is full. +.P +_const(STACK_UNDERFLOW) is generated if _cmnd(PopClientAttrib) is called while +the attribute stack is empty. +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(ATTRIB_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(MAX_CLIENT_ATTRIB_STACK_DEPTH) +.SH SEE ALSO +_cmnd(ColorPointer), +_cmnd(DisableClientState), +_cmnd(EdgeFlagPointer), +_cmnd(EnableClientState), +_cmnd(Get), +_cmnd(GetError), +_cmnd(IndexPointer), +_cmnd(NormalPointer), +_cmnd(NewList), +_cmnd(PixelStore), +_cmnd(PushAttrib), +_cmnd(TexCoordPointer), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushmatrix.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushmatrix.gl new file mode 100644 index 000000000..5052213a8 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushmatrix.gl @@ -0,0 +1,107 @@ +_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 +_header(PushMatrix,push and pop the current matrix stack) +_names(PushMatrix) +_names(PopMatrix) +.SH DESCRIPTION +There is a stack of matrices for each of the matrix modes. +In _const(MODELVIEW) mode, +the stack depth is at least 32. +In the other modes, +_const(COLOR), const(PROJECTION), and _const(TEXTURE), +the depth is at least 2. +The current matrix in any mode is the matrix on the top of the stack +for that mode. +.P +_cmnd pushes the current matrix stack down by one, +duplicating the current matrix. +That is, +after a _cmnd call, +the matrix on top of the stack is identical to the one below it. +.P +_cmnd(PopMatrix) pops the current matrix stack, +replacing the current matrix with the one below it on the stack. +.P +Initially, each of the stacks contains one matrix, an identity matrix. +.P +It is an error to push a full matrix stack, +or to pop a matrix stack that contains only a single matrix. +In either case, the error flag is set +and no other change is made to GL state. +.SH ERRORS +_const(STACK_OVERFLOW) is generated if _cmnd(PushMatrix) is called while +the current matrix stack is full. +.P +_const(STACK_UNDERFLOW) is generated if _cmnd(PopMatrix) is called while +the current matrix stack contains only a single matrix. +.P +_const(INVALID_OPERATION) is generated if _cmnd(PushMatrix) or _cmnd(PopMatrix) +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(MATRIX_MODE) +.br +_cmnd(Get) with argument _const(COLOR_MATRIX) +.br +_cmnd(Get) with argument _const(MODELVIEW_MATRIX) +.br +_cmnd(Get) with argument _const(PROJECTION_MATRIX) +.br +_cmnd(Get) with argument _const(TEXTURE_MATRIX) +.br +_cmnd(Get) with argument _const(COLOR_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(MODELVIEW_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(PROJECTION_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(TEXTURE_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(MAX_MODELVIEW_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(MAX_PROJECTION_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(MAX_TEXTURE_STACK_DEPTH) +.SH SEE ALSO +_cmnd(Frustum), +_cmnd(LoadIdentity), +_cmnd(LoadMatrix), +_cmnd(MatrixMode), +_cmnd(MultMatrix), +_cmnd(Ortho), +_cmnd(Rotate), +_cmnd(Scale), +_cmnd(Translate), +_cmnd(Viewport) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushname.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushname.gl new file mode 100644 index 000000000..e78fbf51d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/pushname.gl @@ -0,0 +1,81 @@ +_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 +_header(PushName,push and pop the name stack) +_names(PushName) +.SH PARAMETERS +_phead(_param1) +Specifies a name that will be pushed onto the name stack. +_names(PopName) +.SH DESCRIPTION +The name stack is used during selection mode to allow sets of rendering +commands to be uniquely identified. +It consists of an ordered set of unsigned integers and is initially empty. +.P +_cmnd causes _param1(1) to be pushed onto the name stack. +_cmnd(PopName) pops one name off the top of the stack. +.P +The maximum name stack depth is implementation-dependent; call +_const(MAX_NAME_STACK_DEPTH) to find out the value for a particular +implementation. It is an +error to push a name onto a full stack, +or to pop a name off an empty stack. +It is also an error to manipulate the name stack between the execution of +_cmnd(Begin) and the corresponding execution of _cmnd(End). +In any of these cases, the error flag is set and no other change is +made to GL state. +.P +The name stack is always empty while the render mode is not _const(SELECT). +Calls to _cmnd(PushName) or _cmnd(PopName) while the render mode is not +_const(SELECT) are ignored. +.SH ERRORS +_const(STACK_OVERFLOW) is generated if _cmnd(PushName) is called while the +name stack is full. +.P +_const(STACK_UNDERFLOW) is generated if _cmnd(PopName) is called while the +name stack is empty. +.P +_const(INVALID_OPERATION) is generated if _cmnd(PushName) or _cmnd(PopName) +is executed between a call to _cmnd(Begin) and the corresponding call to +_cmnd(End). +.bp +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(NAME_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(MAX_NAME_STACK_DEPTH) +.SH SEE ALSO +_cmnd(InitNames), +_cmnd(LoadName), +_cmnd(RenderMode), +_cmnd(SelectBuffer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rasterpos.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rasterpos.gl new file mode 100644 index 000000000..b24bf8b44 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rasterpos.gl @@ -0,0 +1,173 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(RasterPos,specify the raster position for pixel operations) +_names(RasterPos,[2-4][sifd]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2 _param3 _param4) +Specify the $x$, $y$, $z$, and $w$ object coordinates +(if present) +for the raster position. +_names(RasterPos,[2-4][sifd]v) +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to an array of two, +three, +or four elements, +specifying $x$, $y$, $z$, and $w$ coordinates, respectively. +.SH DESCRIPTION +The GL maintains a 3D position in window coordinates. +This position, +called the raster position, +is used to position pixel and bitmap write operations. It is +maintained with subpixel accuracy. +See _cmnd(Bitmap), _cmnd(DrawPixels), and _cmnd(CopyPixels). +.P +The current raster position consists of three window coordinates +($x$, $y$, $z$), +a clip coordinate value ($w$), +an eye coordinate distance, +a valid bit, +and associated color data and texture coordinates. +The $w$ coordinate is a clip coordinate, +because $w$ is not projected to window coordinates. +_cmnd(RasterPos4) specifies object coordinates $x$, $y$, $z$, and $w$ +explicitly. +_cmnd(RasterPos3) specifies object coordinate $x$, $y$, and $z$ explicitly, +while $w$ is implicitly set to 1. +_cmnd(RasterPos2) uses the argument values for $x$ and $y$ while +implicitly setting $z$ and $w$ to 0 and 1. +.P +The object coordinates presented by _cmnd are treated just like those +of a _cmnd(Vertex) command: +They are transformed by the current modelview and projection matrices +and passed to the clipping stage. +If the vertex is not culled, +then it is projected and scaled to window coordinates, +which become the new current raster position, +and the _const(CURRENT_RASTER_POSITION_VALID) flag is set. +If the vertex +.I is +culled, +then the valid bit is cleared and the current raster position +and associated color and texture coordinates are undefined. +.P +The current raster position also includes some associated color data +and texture coordinates. +If lighting is enabled, +then _const(CURRENT_RASTER_COLOR) +(in RGBA mode) +or _const(CURRENT_RASTER_INDEX) +(in color index mode) +is set to the color produced by the lighting calculation +(see _cmnd(Light), _cmnd(LightModel), and +.br +_cmnd(ShadeModel)). +If lighting is disabled, +current color +(in RGBA mode, state variable _const(CURRENT_COLOR)) +or color index +(in color index mode, state variable _const(CURRENT_INDEX)) +is used to update the current raster color. +.P +Likewise, +_const(CURRENT_RASTER_TEXTURE_COORDS) is updated as a function +of _const(CURRENT_TEXTURE_COORDS), +based on the texture matrix and the texture generation functions +(see _cmnd(TexGen)). +Finally, +the distance from the origin of the eye coordinate system to the +vertex as transformed by only the modelview matrix replaces +_const(CURRENT_RASTER_DISTANCE). +.P +Initially, the current raster position is (0, 0, 0, 1), +the current raster distance is 0, +the valid bit is set, +the associated RGBA color is (1, 1, 1, 1), +the associated color index is 1, +and the associated texture coordinates are (0, 0, 0, 1). +In RGBA mode, +_const(CURRENT_RASTER_INDEX) is always 1; +in color index mode, +the current raster RGBA color always maintains its initial value. +.SH NOTES +The raster position is modified both by _cmnd and by _cmnd(Bitmap). +.P +When the raster position coordinates are invalid, +drawing commands that are based on the raster position are +ignored (that is, they do not result in changes to GL state). +.P +Calling _cmnd(DrawElements), or _cmnd(DrawRangeElements) may leave the +current color or index indeterminate. +If _cmnd is executed while the current color or index is indeterminate, the +current raster color or current raster index remains indeterminate. +.P +To set a valid raster position outside the viewport, first set a valid +raster position, then call _cmnd(Bitmap) with NULL as the \f2bitmap\fP +parameter. +.P +When the _arbstring(imaging) extension is supported, there are distinct +raster texture coordinates for each texture unit. Each texture unit's +current ratster texture coordinates are updated by _cmnd. +.SH ERRORS +_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(Get) with argument _const(CURRENT_RASTER_POSITION) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_POSITION_VALID) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_DISTANCE) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_COLOR) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_INDEX) +.br +_cmnd(Get) with argument _const(CURRENT_RASTER_TEXTURE_COORDS) +.SH SEE ALSO +_cmnd(Bitmap), +_cmnd(CopyPixels), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(DrawRangeElements), +_cmnd(DrawPixels), +_cmnd(TexCoord), +_cmnd(TexGen), +_cmnd(Vertex) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/readbuffer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/readbuffer.gl new file mode 100644 index 000000000..4d65606fc --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/readbuffer.gl @@ -0,0 +1,98 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(ReadBuffer,select a color buffer source for pixels) +_names(ReadBuffer) +.SH PARAMETERS +_phead(_param1) +Specifies a color buffer. +Accepted values are +_const(FRONT_LEFT), +_const(FRONT_RIGHT), +_const(BACK_LEFT), +_const(BACK_RIGHT), +_const(FRONT), +_const(BACK), +_const(LEFT), +_const(RIGHT), and +_const(AUX)\f2i\fP, +where \f2i\fP is between 0 and _const(AUX_BUFFERS) \-1. +.SH DESCRIPTION +_cmnd specifies a color buffer as the source for subsequent +_cmnd(ReadPixels), _cmnd(CopyTexImage1D), _cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), _cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), and +_cmnd(CopyPixels) commands. +_param1 accepts one of twelve or more predefined values. +(_const(AUX0) through _const(AUX3) are always defined.) +In a fully configured system, +_const(FRONT), +_const(LEFT), and +_const(FRONT_LEFT) all name the front left buffer, +_const(FRONT_RIGHT) and +_const(RIGHT) name the front right buffer, and +_const(BACK_LEFT) and +_const(BACK) name the back left buffer. +.P +Nonstereo double-buffered configurations have only a front left and a +back left buffer. +Single-buffered configurations have a front left and a front right +buffer if stereo, and only a front left buffer if nonstereo. +It is an error to specify a nonexistent buffer to _cmnd. +.P +_param1 is initially _const(FRONT) in single-buffered configurations, +and _const(BACK) in double-buffered configurations. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of the twelve +(or more) accepted values. +.P +_const(INVALID_OPERATION) is generated if _param1 specifies a buffer +that does not exist. +.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(Get) with argument _const(READ_BUFFER) +.SH SEE ALSO +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawBuffer), +_cmnd(ReadPixels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/readpixels.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/readpixels.gl new file mode 100644 index 000000000..ed699ffa1 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/readpixels.gl @@ -0,0 +1,357 @@ +_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(ReadPixels,read a block of pixels from the frame buffer) +_names(ReadPixels) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2) +Specify the window coordinates of the first pixel +that is read from the frame buffer. +This location is the lower left corner of a rectangular block of pixels. +_phead(_param3 _param4) +Specify the dimensions of the pixel rectangle. +_param3 and _param4 of one correspond to a single pixel. +_phead(_param5) +Specifies the format of the pixel data. +The following symbolic values are accepted: +_const(COLOR_INDEX), +_const(STENCIL_INDEX), +_const(DEPTH_COMPONENT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(_param6) +Specifies the data type of the pixel data. +Must be one of +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(_param7) +Returns the pixel data. +.SH DESCRIPTION +_cmnd returns pixel data from the frame buffer, +starting with the pixel whose lower left corner +is at location (_param1, _param2), +into client memory starting at location _param7. +Several parameters control the processing of the pixel data before +it is placed into client memory. +These parameters are set with three commands: +_cmnd(PixelStore), +_cmnd(PixelTransfer), and +_cmnd(PixelMap). +This reference page describes the effects on _cmnd of most, +but not all of the parameters specified by these three commands. +.P +When the _arbstring(imaging) extension is supported, the pixel data may +be processed by additional operations including color table lookup, +color matrix tranformations, convolutions, histograms and minimum and +maximun pixel value computations. +.P +_cmnd returns values from each pixel with lower left corner at +(_param1 + $i$, _param2 + $j$) for 0 \(<= $i$ < _param3 and +0 \(<= $j$ < _param4. +This pixel is said to be the $i$th pixel in the $j$th row. +Pixels are returned in row order from the lowest to the highest row, +left to right in each row. +.P +_param5 specifies the format for the returned pixel values; +accepted values are: +.TP 10 +_const(COLOR_INDEX) +Color indices are read from the color buffer +selected by _cmnd(ReadBuffer). +Each index is converted to fixed point, +shifted left or right depending on the value and sign of _const(INDEX_SHIFT), +and added to _const(INDEX_OFFSET). +If _const(MAP_COLOR) is _const(TRUE), +indices are replaced by their mappings in the table _const(PIXEL_MAP_I_TO_I). +.TP +_const(STENCIL_INDEX) +Stencil values are read from the stencil buffer. +Each index is converted to fixed point, +shifted left or right depending on the value and sign of _const(INDEX_SHIFT), +and added to _const(INDEX_OFFSET). +If _const(MAP_STENCIL) is _const(TRUE), +indices are replaced by their mappings in the table _const(PIXEL_MAP_S_TO_S). +.TP +_const(DEPTH_COMPONENT) +Depth values are read from the depth buffer. +Each component is converted to floating point such that the minimum depth +value maps to 0 and the maximum value maps to 1. +Each component is then multiplied by _const(DEPTH_SCALE), +added to _const(DEPTH_BIAS), +and finally clamped to the range [0,1]. +.TP +_const(RED) +.TP +_const(GREEN) +.TP +_const(BLUE) +.TP +_const(ALPHA) +.TP +_const(RGB) +.TP +_const(BGR) +.TP +_const(RGBA) +.TP +_const(BGRA) +.TP +_C_ _const(ABGR_EXT) +_const(LUMINANCE) +.TP +_const(LUMINANCE_ALPHA) +Processing differs depending on whether color buffers store color indices +or RGBA color components. +If color indices are stored, +they are read from the color buffer selected by _cmnd(ReadBuffer). +Each index is converted to fixed point, +shifted left or right depending on the value and sign of _const(INDEX_SHIFT), +and added to _const(INDEX_OFFSET). +Indices are then replaced by the red, +green, +blue, +and alpha values obtained by indexing the tables +_const(PIXEL_MAP_I_TO_R), +_const(PIXEL_MAP_I_TO_G), +_const(PIXEL_MAP_I_TO_B), and +_const(PIXEL_MAP_I_TO_A). +Each table must be of size $2 sup n$, but $n$ may be different for +different tables. +Before an index is used to look up a value in a table of +size $2 sup n$, it must be masked against $2 sup n - 1$. +.IP +If RGBA color components are stored in the color buffers, +they are read from the color buffer selected by _cmnd(ReadBuffer). +Each color component is converted to floating point such that zero intensity +maps to 0.0 and full intensity maps to 1.0. +Each component is then multiplied by _const(c_SCALE) and +added to _const(c_BIAS), +where \f2c\fP is RED, GREEN, BLUE, or ALPHA. +Finally, +if _const(MAP_COLOR) is _const(TRUE), +each component is clamped to the range [0,\ 1], +scaled to the size of its corresponding table, and is then +replaced by its mapping in the table +_const(PIXEL_MAP_c_TO_c), +where \f2c\fP is R, G, B, or A. +.IP +Unneeded data is then discarded. +For example, +_const(RED) discards the green, blue, and alpha components, +while _const(RGB) discards only the alpha component. +_const(LUMINANCE) computes a single-component value as the sum of +the red, +green, +and blue components, +and _const(LUMINANCE_ALPHA) does the same, +while keeping alpha as a second value. +The final values are clamped to the range [0,\ 1]. +.P +The shift, +scale, +bias, +and lookup factors just described are all specified by +.br +_cmnd(PixelTransfer). +The lookup table contents themselves are specified by _cmnd(PixelMap). +.P +Finally, the indices or components +are converted to the proper format, +as specified by _param6. +If _param5 is _const(COLOR_INDEX) or _const(STENCIL_INDEX) +and _param6 is not _const(FLOAT), +each index is masked with the mask value given in the following table. +If _param6 is _const(FLOAT), then each integer index is converted to +single-precision floating-point format. +.P +If _param5 is +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA) and _param6 is not _const(FLOAT), +each component is multiplied by the multiplier shown in the following table. +If type is _const(FLOAT), then each component is passed as is +(or converted to the client's single-precision floating-point format if +it is different from the one used by the GL). +.P +.TS +center tab(:); +l cb cb +l c c. +_ +_param6:index mask:component conversion +_ +.sp .5 +_const(UNSIGNED_BYTE):$2"^"8 - 1$:$(2"^"8 - 1) c$ +_const(BYTE):$2"^"7 - 1$:$[(2"^"8 - 1) c - 1] / 2$ +_const(BITMAP):$1$:$1$ +_const(UNSIGNED_SHORT):$2"^"16 - 1$:$(2"^"16 - 1) c$ +_const(SHORT):$2"^"15 - 1$:$[(2"^"16 - 1) c - 1] / 2$ +_const(UNSIGNED_INT):$2"^"32 - 1$:$(2"^"32 - 1) c$ +_const(INT):$2"^"31 - 1$:$[(2"^"32 - 1) c - 1] / 2$ +_const(FLOAT):none:$c$ +_ +.TE +.P +Return values are placed in memory as follows. +If _param5 is +_const(COLOR_INDEX), +_const(STENCIL_INDEX), +_const(DEPTH_COMPONENT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), or +_const(LUMINANCE), +a single value is returned and the data for the $i$th pixel in the $j$th row +is placed in location $(j)~_eqnparam3~+~i$. +_const(RGB) and _const(BGR) return three values, +_const(RGBA) and _const(BGRA) return four values, +_C_ and _const(ABGR_EXT) return four values, +and _const(LUMINANCE_ALPHA) returns two values for each pixel, +with all values corresponding to a single pixel occupying contiguous space +in _param7. +Storage parameters set by _cmnd(PixelStore), +such as _const(PACK_LSB_FIRST) and _const(PACK_SWAP_BYTES), +affect the way that data is written into memory. +See _cmnd(PixelStore) for a description. +.SH NOTES +Values for pixels that lie outside the window +connected to the current GL context are undefined. +.P +If an error is generated, +no change is made to the contents of _param7. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param5 or _param6 is not an +accepted value. +.P +_const(INVALID_ENUM) is generated if _param6 is _const(BITMAP) and _param5 is +not _const(COLOR_INDEX) or _const(STENCIL_INDEX). +.P +_const(INVALID_VALUE) is generated if either _param3 or _param4 is negative. +.P +_const(INVALID_OPERATION) is generated if _param5 is _const(COLOR_INDEX) +and the color buffers store RGBA color components. +.P +_const(INVALID_OPERATION) is generated if _param5 is _const(STENCIL_INDEX) +and there is no stencil buffer. +.P +_const(INVALID_OPERATION) is generated if _param5 is _const(DEPTH_COMPONENT) +and there is no depth buffer. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param6 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param5 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param6 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.P +The formats _const(BGR), and _const(BGRA) and types +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) are available only if the GL version +is 1.2 or greater. +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(INDEX_MODE) +.SH SEE ALSO +_cmnd(CopyPixels), +_cmnd(DrawPixels), +_cmnd(PixelMap), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +.br +_cmnd(ReadBuffer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rect.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rect.gl new file mode 100644 index 000000000..1b312a3b0 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rect.gl @@ -0,0 +1,77 @@ +_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,eqn)_C_ +_header(Rect,draw a rectangle) +_names(Rect,[dfis]) +.SH PARAMETERS +_phead(_param1 _param2) +Specify one vertex of a rectangle. +_phead(_param3 _param4) +Specify the opposite vertex of the rectangle. +_names(Rect,[dfis]v) +.BP +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to one vertex of a rectangle. +_phead(_param2) +Specifies a pointer to the opposite vertex of the rectangle. +.SH DESCRIPTION +_cmnd supports efficient specification of rectangles as two corner points. +Each +rectangle command takes four arguments, +organized either as two consecutive pairs of (\f2x\fP,\f2y\fP) coordinates, +or as two pointers to arrays, +each containing an (\f2x\fP,\f2y\fP) pair. +The resulting rectangle is defined in the \f2z\fP = 0 plane. +.P +_cmnd(Rect)(_param1(1), _param2(1), _param3(1), _param4(1)) +is exactly equivalent to the following sequence: +.Ex 6 +glBegin(_const(POLYGON)); +glVertex2(_param1(1), _param2(1)); +glVertex2(_param3(1), _param2(1)); +glVertex2(_param3(1), _param4(1)); +glVertex2(_param1(1), _param4(1)); +glEnd(); +.Ee +Note that if the second vertex is above and to the right of the first vertex, +the rectangle is constructed with a counterclockwise winding. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.SH SEE ALSO +_cmnd(Begin), +_cmnd(Vertex) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rendermode.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rendermode.gl new file mode 100644 index 000000000..52b8b6b37 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rendermode.gl @@ -0,0 +1,124 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(RenderMode,set rasterization mode) +_names(RenderMode) +.SH PARAMETERS +_phead(_param1) +Specifies the rasterization mode. +Three values are accepted: +_const(RENDER), +_const(SELECT), and +_const(FEEDBACK). +The initial value is _const(RENDER). +.SH DESCRIPTION +_cmnd sets the rasterization mode. +It takes one argument, +_param1, +which can assume one of three predefined values: +.TP 16 +_const(RENDER) +Render mode. Primitives are rasterized, +producing pixel fragments, +which are written into the frame buffer. +This is the normal mode +and also the default mode. +.TP +_const(SELECT) +Selection mode. +No pixel fragments are produced, +and no change to the frame buffer contents is made. +Instead, +a record of the names of primitives that would have been drawn +if the render mode had been _const(RENDER) is returned in a select buffer, +which must be created (see _cmnd(SelectBuffer)) before selection mode +is entered. +.TP +_const(FEEDBACK) +Feedback mode. +No pixel fragments are produced, +and no change to the frame buffer contents is made. +Instead, +the coordinates and attributes of vertices that would have been drawn +if the render mode had been _const(RENDER) is returned in a feedback buffer, +which must be created (see _cmnd(FeedbackBuffer)) before feedback mode +is entered. +.P +The return value of _cmnd is determined by the render mode at the time +_cmnd is called, +rather than by _param1. +The values returned for the three render modes are as follows: +.TP 16 +_const(RENDER) +0. +.TP +_const(SELECT) +The number of hit records transferred to the select buffer. +.TP +_const(FEEDBACK) +The number of values (not vertices) transferred to the feedback buffer. +.P +See the _cmnd(SelectBuffer) and _cmnd(FeedbackBuffer) reference pages for +more details concerning selection and feedback operation. +.SH NOTES +If an error is generated, +_cmnd returns 0 regardless of the current render mode. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of the three +accepted values. +.P +_const(INVALID_OPERATION) is generated if _cmnd(SelectBuffer) is called +while the render mode is _const(SELECT), +or if _cmnd is called with argument _const(SELECT) before +_cmnd(SelectBuffer) is called at least once. +.P +_const(INVALID_OPERATION) is generated if _cmnd(FeedbackBuffer) is called +while the render mode is _const(FEEDBACK), +or if _cmnd is called with argument _const(FEEDBACK) before +_cmnd(FeedbackBuffer) is called at least once. +.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(Get) with argument _const(RENDER_MODE) +.SH SEE ALSO +_cmnd(FeedbackBuffer), +_cmnd(InitNames), +_cmnd(LoadName), +_cmnd(PassThrough), +_cmnd(PushName), +_cmnd(SelectBuffer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/resethistogram.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/resethistogram.gl new file mode 100644 index 000000000..661c0adf9 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/resethistogram.gl @@ -0,0 +1,55 @@ +_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)_C_ +_header(ResetHistogram,reset histogram table entries to zero) +_names(ResetHistogram) +_define(@<__target>@,@<_param1>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be +_const(HISTOGRAM). +.SH DESCRIPTION +_cmnd resets all the elements of the current histogram table to zero. +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not _const(HISTOGRAM). +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.SH SEE ALSO +_cmnd(Histogram) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/resetminmax.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/resetminmax.gl new file mode 100644 index 000000000..e53419378 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/resetminmax.gl @@ -0,0 +1,58 @@ +_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)_C_ +_header(ResetMinmax,reset minmax table entries to initial values) +_names(ResetMinmax) +_define(@<__target>@,@<_param1>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be +_const(MINMAX). +.SH DESCRIPTION +_cmnd resets the elements of the current minmax table to their +initial values: the ``maximum'' element receives the minimum possible +component values, and the ``minimum'' element receives the maximum +possible component values. +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not _const(MINMAX). +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.SH SEE ALSO +_cmnd(Minmax) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rotate.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rotate.gl new file mode 100644 index 000000000..5700a28e4 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/rotate.gl @@ -0,0 +1,114 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Rotate,multiply the current matrix by a rotation matrix) +_names(Rotate,[df]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the angle of rotation, in degrees. +_phead(_param2 _param3 _param4) +Specify the \f2x\fP, \f2y\fP, and \f2z\fP coordinates of a vector, respectively. +.SH DESCRIPTION +_cmnd produces a rotation of _param1 degrees around +the vector $(_eqnparam2, _eqnparam3, _eqnparam4)$. +The current matrix (see _cmnd(MatrixMode)) is multiplied by a rotation +matrix with the product +replacing the current matrix, as if _cmnd(MultMatrix) were called +with the following matrix as its argument: +.P +.ce +.EQ +left ( ~ down 20 matrix { + ccol { + _eqnparam2 sup 2 (1 ^-^ c)~+~ c above + _eqnparam3 _eqnparam2 (1 ^-^ c)~+~ _eqnparam4 s above + _eqnparam2 _eqnparam4 (1 ^-^ c)~-~_eqnparam3 s above + ~0 + } + ccol { + ~~ _eqnparam2 _eqnparam3 (1 ^-^ c)~-~_eqnparam4 s above + ~~ _eqnparam3 sup 2 (1 ^-^ c)~+~ c above + ~~ _eqnparam3 _eqnparam4 (1 ^-^ c)~+~ _eqnparam2 s above + ~~ ~0 + } + ccol { + ~~ _eqnparam2 _eqnparam4 (1 ^-^ c)~+~ _eqnparam3 s above + ~~ _eqnparam3 _eqnparam4 (1 ^-^ c)~-~ _eqnparam2 s above + ~~ _eqnparam4 sup 2 (1 ^-^ c) ~+~ c above + ~~ ~0 + } + ccol { ~0 above ~0 above ~0 above ~1} +} ~~ right ) +.EN +.P +.sp +Where $c ~=~ cos (_eqnparam1)$, $s ~=~ sin (_eqnparam1)$, and +$||(~_eqnparam2, _eqnparam3, _eqnparam4~)|| ~=~ 1$ (if not, the GL +will normalize this vector). +.sp +.sp +.P +If the matrix mode is either _const(MODELVIEW) or _const(PROJECTION), +all objects drawn after _cmnd is called are rotated. +Use _cmnd(PushMatrix) and _cmnd(PopMatrix) to save and restore +the unrotated coordinate system. +.SH NOTES +This rotation follows the right-hand rule, so +if the vector $(_eqnparam2, _eqnparam3, _eqnparam4)$ points toward the +user, the rotation will be counterclockwise. +.SH ERRORS +_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(Get) with argument _const(MATRIX_MODE) +.br +_cmnd(Get) with argument _const(COLOR_MATRIX) +.br +_cmnd(Get) with argument _const(MODELVIEW_MATRIX) +.br +_cmnd(Get) with argument _const(PROJECTION_MATRIX) +.br +_cmnd(Get) with argument _const(TEXTURE_MATRIX) +.SH SEE ALSO +_cmnd(MatrixMode), +_cmnd(MultMatrix), +_cmnd(PushMatrix), +_cmnd(Scale), +_cmnd(Translate) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/scale.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/scale.gl new file mode 100644 index 000000000..392f7273b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/scale.gl @@ -0,0 +1,99 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Scale,multiply the current matrix by a general scaling matrix) +_names(Scale,[df]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2 _param3) +Specify scale factors along the \f2x\fP, \f2y\fP, and \f2z\fP axes, respectively. +.SH DESCRIPTION +_cmnd produces a nonuniform scaling along the \f2x\fP, \f2y\fP, and +\f2z\fP axes. +The three parameters indicate the desired scale factor along +each of the three axes. +.P +The current matrix +(see _cmnd(MatrixMode)) +is multiplied by this scale matrix, +and the product replaces the current matrix +as if _cmnd were called with the following matrix +as its argument: + +.P +.ce +.EQ +left ( ~ down 20 matrix { + ccol { ~_eqnparam1 above ~0 above ~0 above ~0 } + ccol { ~0 above ~_eqnparam2 above ~0 above ~0 } + ccol { ~0 above ~0 above ~_eqnparam3 above ~0 } + ccol { ~0 above ~0 above ~0 above ~1} +} ~~ right ) +.EN +.sp +If the matrix mode is either _const(MODELVIEW) or _const(PROJECTION), +all objects drawn after _cmnd is called are scaled. +.P +Use _cmnd(PushMatrix) and _cmnd(PopMatrix) to save and restore +the unscaled coordinate system. +.SH NOTES +If scale factors other than 1 are applied to the modelview matrix +and lighting is enabled, lighting often appears wrong. +In that case, enable automatic normalization of normals by +calling _cmnd(Enable) with the argument _const(NORMALIZE). +.SH ERRORS +_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(Get) with argument _const(MATRIX_MODE) +.br +_cmnd(Get) with argument _const(COLOR_MATRIX) +.br +_cmnd(Get) with argument _const(MODELVIEW_MATRIX) +.br +_cmnd(Get) with argument _const(PROJECTION_MATRIX) +.br +_cmnd(Get) with argument _const(TEXTURE_MATRIX) +.SH SEE ALSO +_cmnd(MatrixMode), +_cmnd(MultMatrix), +_cmnd(PushMatrix), +_cmnd(Rotate), +_cmnd(Translate) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/scissor.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/scissor.gl new file mode 100644 index 000000000..2665ff5ac --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/scissor.gl @@ -0,0 +1,81 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Scissor, define the scissor box) +_names(Scissor) +.SH PARAMETERS +_phead(_param1 _param2) +Specify the lower left corner of the scissor box. +Initially (0, 0). +_phead(_param3 _param4) +Specify the width and height of the scissor box. +When a GL context is first attached to a window, +_param3 and _param4 are set to the dimensions of that window. +.SH DESCRIPTION +_cmnd defines a rectangle, called the scissor box, +in window coordinates. +The first two arguments, +_param1 and _param2, +specify the lower left corner of the box. +_param3 and _param4 specify the width and height of the box. +.P +To enable and disable the scissor test, call +_cmnd(Enable) and _cmnd(Disable) with argument +_const(SCISSOR_TEST). The test is initially disabled. +While the test is enabled, only pixels that lie within the scissor box +can be modified by drawing commands. +Window coordinates have integer values at the shared corners of +frame buffer pixels. +\f7glScissor(0,0,1,1)\fP allows modification of only the lower left +pixel in the window, and \f7glScissor(0,0,0,0)\fP doesn't allow +modification of any pixels in the window. +.P +When the scissor test is disabled, +it is as though the scissor box includes the entire window. +.SH ERRORS +_const(INVALID_VALUE) is generated if either _param3 or _param4 is negative. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.bp +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(SCISSOR_BOX) +.br +_cmnd(IsEnabled) with argument _const(SCISSOR_TEST) +.SH SEE ALSO +_cmnd(Enable), +_cmnd(Viewport) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/selectbuffer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/selectbuffer.gl new file mode 100644 index 000000000..c1772410c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/selectbuffer.gl @@ -0,0 +1,127 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(SelectBuffer,establish a buffer for selection mode values) +_names(SelectBuffer) +.SH PARAMETERS +_phead(_param1) +Specifies the size of _param2. +_phead(_param2) +Returns the selection data. +.SH DESCRIPTION +_cmnd has two arguments: +_param2 is a pointer to an array of unsigned integers, +and _param1 indicates the size of the array. +_param2 returns values from the name stack +(see _cmnd(InitNames), _cmnd(LoadName), _cmnd(PushName)) +when the rendering mode is _const(SELECT) (see _cmnd(RenderMode)). +_cmnd must be issued before selection mode is enabled, +and it must not be issued while the rendering mode is _const(SELECT). +.P +A programmer can use selection to determine which primitives +are drawn into some region of a window. +The region is defined by the current modelview and perspective matrices. +.P +In selection mode, no pixel fragments are produced from rasterization. +Instead, +if a primitive or a raster position intersects the clipping +volume defined by the viewing frustum +and the user-defined clipping planes, +this primitive causes a selection hit. +(With polygons, no hit occurs if the polygon is culled.) +When a change is made to the name stack, +or when _cmnd(RenderMode) is called, +a hit record is copied to _param2 if any hits have occurred since the +last such event +(name stack change or +_cmnd(RenderMode) call). +The hit record consists of the number of names in the name stack at the +time of the event, followed by the minimum and maximum depth values +of all vertices that hit since the previous event, +followed by the name stack contents, +bottom name first. +.P +Depth values (which are in the range [0,1]) are multiplied by 2^32 - 1, +before being placed in the hit record. +.P +An internal index into _param2 is reset to 0 whenever selection mode +is entered. +Each time a hit record is copied into _param2, +the index is incremented to point to the cell just past the end +of the block of names \- that is, to the next available cell. +If the hit record is larger than the number of remaining locations in _param2, +as much data as can fit is copied, +and the overflow flag is set. +If the name stack is empty when a hit record is copied, +that record consists of 0 followed by the minimum and maximum depth values. +.P +To exit selection mode, call _cmnd(RenderMode) with an argument +other than _const(SELECT). +Whenever _cmnd(RenderMode) is called while the render mode is _const(SELECT), +it returns the number of hit records copied to _param2, +resets the overflow flag and the selection buffer pointer, +and initializes the name stack to be empty. +If the overflow bit was set when _cmnd(RenderMode) was called, +a negative hit record count is returned. +.SH NOTES +The contents of _param2 is undefined until _cmnd(RenderMode) is called +with an argument other than _const(SELECT). +.P +_cmnd(Begin)/_cmnd(End) primitives and calls to _cmnd(RasterPos) +can result in hits. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is negative. +.P +_const(INVALID_OPERATION) is generated if _cmnd is called while the +render mode is _const(SELECT), +or if _cmnd(RenderMode) is called with argument _const(SELECT) before +_cmnd is called at least once. +.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(Get) with argument _const(NAME_STACK_DEPTH) +.br +_cmnd(Get) with argument _const(SELECTION_BUFFER_SIZE) +.br +_cmnd(GetPointerv) with argument _const(SELECTION_BUFFER_POINTER) +.SH SEE ALSO +_cmnd(FeedbackBuffer), +_cmnd(InitNames), +_cmnd(LoadName), +_cmnd(PushName), +_cmnd(RenderMode) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/separablefilter2d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/separablefilter2d.gl new file mode 100644 index 000000000..dae44bb89 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/separablefilter2d.gl @@ -0,0 +1,254 @@ +_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)_C_ +_header(SeparableFilter2D,define a separable two-dimensional convolution filter) +_names(SeparableFilter2D) +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__internalformat>@,@<_param2>@)_C_ +_define(@<__width>@,@<_param3>@)_C_ +_define(@<__height>@,@<_param4>@)_C_ +_define(@<__format>@,@<_param5>@)_C_ +_define(@<__type>@,@<_param6>@)_C_ +_define(@<__row>@,@<_param7>@)_C_ +_define(@<__column>@,@<_param8>@)_C_ +.SH PARAMETERS +_phead(__target) +Must be _const(SEPARABLE_2D). +_phead(__internalformat) +The internal format of the convolution filter kernel. +The allowable values are +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(__width) +The number of elements in the pixel array referenced by __row. +(This is the width of the separable filter kernel.) +_phead(__height) +The number of elements in the pixel array referenced by __column. +(This is the height of the separable filter kernel.) +_phead(__format) +The format of the pixel data in __row and __column. +The allowable values are +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_const(INTENSITY), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(__type) +The type of the pixel data in __row and __column. +Symbolic constants +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) +are accepted. +_phead(__row) +Pointer to a one-dimensional array of pixel data that is processed to +build the row filter kernel. +_phead(__column) +Pointer to a one-dimensional array of pixel data that is processed to +build the column filter kernel. +.SH DESCRIPTION +_cmnd builds a two-dimensional separable convolution filter kernel from +two arrays of pixels. +.sp +The pixel arrays specified by (__width, __format, __type, __row) +and (__height, __format, __type, __column) are processed just as if +they had been passed to _cmnd(DrawPixels), +but processing stops after the final expansion to RGBA is completed. +.sp +Next, the R, G, B, and A components of all pixels in both arrays are scaled +by the four separable 2D _const(CONVOLUTION_FILTER_SCALE) parameters and +biased by the four separable 2D _const(CONVOLUTION_FILTER_BIAS) parameters. +(The scale and bias parameters are set by _cmnd(ConvolutionParameter) +using the _const(SEPARABLE_2D) target and the names +_const(CONVOLUTION_FILTER_SCALE) and _const(CONVOLUTION_FILTER_BIAS). +The parameters themselves are vectors of four values that are applied to red, +green, blue, and alpha, in that order.) +The R, G, B, and A values are not clamped to [0,1] at any time during this +process. +.sp +Each pixel is then converted to the internal format specified by +__internalformat. +This conversion simply maps the component values of the pixel (R, G, B, +and A) to the values included in the internal format (red, green, blue, +alpha, luminance, and intensity). The mapping is as follows: +.bp +.TS +center; +l c c c c c c. +_ +Internal Format Red Green Blue Alpha Luminance Intensity +_ +_const(LUMINANCE) R +_const(LUMINANCE_ALPHA) A R +_const(INTENSITY) R +_const(RGB) R G B +_const(RGBA) R G B A +_ +.TE + +.sp +The red, green, blue, alpha, luminance, and/or intensity components of +the resulting pixels are stored in floating-point rather than integer +format. +They form two one-dimensional filter kernel images. +The row image is indexed by coordinate \f2i\fP starting at zero and +increasing from left to right. +Each location in the row image is derived from element \f2i\fP of __row. +The column image is indexed by coordinate \f2j\fP starting at zero +and increasing from bottom to top. +Each location in the column image is derived from element \f2j\fP of __column. +.PP +Note that after a convolution is performed, the resulting color +components are also scaled by their corresponding +_const(POST_CONVOLUTION_c_SCALE) parameters and biased by their +corresponding _const(POST_CONVOLUTION_c_BIAS) parameters (where +\f2c\fP takes on the values \f3RED\fP, \f3GREEN\fP, \f3BLUE\fP, and +\f3ALPHA\fP). +These parameters are set by _cmnd(PixelTransfer). +.SH NOTES +_cmnd is present only if _arbstring(imaging) is returned when _cmnd(GetString) +is called with an argument of _const(EXTENSIONS). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not +_const(SEPARABLE_2D). +.P +_const(INVALID_ENUM) is generated if __internalformat is not one of the +allowable values. +.P +_const(INVALID_VALUE) is generated if __width is less than zero or greater +than the maximum supported value. +This value may be queried with _cmnd(GetConvolutionParameter) +using target _const(SEPARABLE_2D) and name +_const(MAX_CONVOLUTION_WIDTH). +.P +_const(INVALID_VALUE) is generated if __height is less than zero or greater +than the maximum supported value. +This value may be queried with _cmnd(GetConvolutionParameter) +using target _const(SEPARABLE_2D) and name +_const(MAX_CONVOLUTION_HEIGHT). +.P +_const(INVALID_ENUM) is generated if __format is not one of the allowable +values. +.P +_const(INVALID_ENUM) is generated if __type is not one of the allowable +values. +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param4 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param5 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param4 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetConvolutionParameter), _cmnd(GetSeparableFilter) +.SH SEE ALSO +_cmnd(ConvolutionFilter1D), +_cmnd(ConvolutionFilter2D), +_cmnd(ConvolutionParameter), +_cmnd(PixelTransfer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/shademodel.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/shademodel.gl new file mode 100644 index 000000000..8255bc3c7 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/shademodel.gl @@ -0,0 +1,104 @@ +_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(ShadeModel,select flat or smooth shading) +_names(ShadeModel) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a symbolic value representing a shading technique. +Accepted values are _const(FLAT) and _const(SMOOTH). +The initial value is _const(SMOOTH). +.SH DESCRIPTION +GL primitives can have either flat or smooth shading. +Smooth shading, +the default, +causes the computed colors of vertices to be interpolated as the +primitive is rasterized, +typically assigning different colors to each resulting pixel fragment. +Flat shading selects the computed color of just one vertex +and assigns it to all the pixel fragments +generated by rasterizing a single primitive. +In either case, the computed color of a vertex is the result of +lighting if lighting is enabled, +or it is the current color at the time the vertex was specified if +lighting is disabled. +.P +Flat and smooth shading are indistinguishable for points. +Starting when _cmnd(Begin) is issued and counting vertices and +primitives from 1, the GL gives each flat-shaded line segment $i$ the +computed color of vertex $i ~+~ 1$, its second vertex. +Counting similarly from 1, +the GL gives each flat-shaded polygon the computed color of the vertex listed +in the following table. +This is the last vertex to specify the polygon in all cases except single +polygons, +where the first vertex specifies the flat-shaded color. +.sp +.TS +center; +lb cb +l c . +_ +Primitive Type of Polygon $i$ Vertex +_ +Single polygon ($ i ~==~ 1 $) 1 +Triangle strip $i ~+~ 2$ +Triangle fan $i ~+~ 2$ +Independent triangle $ 3 i$ +Quad strip $2 i ~+~ 2$ +Independent quad $ 4 i $ +_ +.TE +.sp +Flat and smooth shading are specified by _cmnd with _param1 set to +_const(FLAT) and _const(SMOOTH), respectively. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is any value other than +_const(FLAT) or _const(SMOOTH). +.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(Get) with argument _const(SHADE_MODEL) +.SH SEE ALSO +_cmnd(Begin), +_cmnd(Color), +_cmnd(Light), +_cmnd(LightModel) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/stencilfunc.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/stencilfunc.gl new file mode 100644 index 000000000..7d284a33d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/stencilfunc.gl @@ -0,0 +1,159 @@ +_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(StencilFunc,set function and reference value for stencil testing) +.EQ +delim $$ +.EN +_names(StencilFunc) +.SH PARAMETERS +_phead(_param1) +Specifies the test function. +Eight tokens are valid: +_const(NEVER), +_const(LESS), +_const(LEQUAL), +_const(GREATER), +_const(GEQUAL), +_const(EQUAL), +_const(NOTEQUAL), and +_const(ALWAYS). The initial value is _const(ALWAYS). +_phead(_param2) +Specifies the reference value for the stencil test. +_param2 is clamped to the range [0,$2 sup n - 1$], +where $n$ is the number of bitplanes in the stencil buffer. The +initial value is 0. +_phead(_param3) +Specifies a mask that is ANDed with both the reference value +and the stored stencil value when the test is done. The initial value +is all 1's. +.SH DESCRIPTION +Stenciling, +like depth-buffering, +enables and disables drawing on a per-pixel basis. +You draw into the stencil planes using GL drawing primitives, +then render geometry and images, +using the stencil planes to mask out portions of the screen. +Stenciling is typically used in multipass rendering algorithms +to achieve special effects, +such as decals, +outlining, +and constructive solid geometry rendering. +.P +The stencil test conditionally eliminates a pixel based on the outcome +of a comparison between the reference value +and the value in the stencil buffer. +To enable and disable the test, call _cmnd(Enable) and _cmnd(Disable) +with argument _const(STENCIL_TEST). +To specify actions based on the outcome of the stencil test, call +_cmnd(StencilOp). +.P +_param1 is a symbolic constant that determines the stencil comparison function. +It accepts one of eight values, +shown in the following list. +_param2 is an integer reference value that is used in the stencil comparison. +It is clamped to the range [0,$2 sup n - 1$], +where $n$ is the number of bitplanes in the stencil buffer. +_param3 is bitwise ANDed with both the reference value +and the stored stencil value, +with the ANDed values participating in the comparison. +.P +If \f2stencil\fP represents the value stored in the corresponding +stencil buffer location, +the following list shows the effect of each comparison function +that can be specified by _param1. +Only if the comparison succeeds is the pixel passed through +to the next stage in the rasterization process +(see _cmnd(StencilOp)). +All tests treat \f2stencil\fP values as unsigned integers in the range +[0,$2 sup n - 1$], +where $n$ is the number of bitplanes in the stencil buffer. +.P +The following values are accepted by _param1: +.TP 18 +_const(NEVER) +Always fails. +.TP +_const(LESS) +Passes if ( _param2 & _param3 ) < ( \f2stencil\fP & _param3 ). +.TP +_const(LEQUAL) +Passes if ( _param2 & _param3 ) \(<= ( \f2stencil\fP & _param3 ). +.TP +_const(GREATER) +Passes if ( _param2 & _param3 ) > ( \f2stencil\fP & _param3 ). +.TP +_const(GEQUAL) +Passes if ( _param2 & _param3 ) \(>= ( \f2stencil\fP & _param3 ). +.TP +_const(EQUAL) +Passes if ( _param2 & _param3 ) = ( \f2stencil\fP & _param3 ). +.TP +_const(NOTEQUAL) +Passes if ( _param2 & _param3 ) \(!= ( \f2stencil\fP & _param3 ). +.TP +_const(ALWAYS) +Always passes. +.SH NOTES +Initially, the stencil test is disabled. +If there is no stencil buffer, +no stencil modification can occur and it is as if +the stencil test always passes. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of the eight +accepted values. +.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(Get) with argument _const(STENCIL_FUNC) +.br +_cmnd(Get) with argument _const(STENCIL_VALUE_MASK) +.br +_cmnd(Get) with argument _const(STENCIL_REF) +.br +_cmnd(Get) with argument _const(STENCIL_BITS) +.br +_cmnd(IsEnabled) with argument _const(STENCIL_TEST) +.SH SEE ALSO +_cmnd(AlphaFunc), +_cmnd(BlendFunc), +_cmnd(DepthFunc), +_cmnd(Enable), +_cmnd(IsEnabled), +_cmnd(LogicOp), +_cmnd(StencilOp) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/stencilmask.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/stencilmask.gl new file mode 100644 index 000000000..ac6c08010 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/stencilmask.gl @@ -0,0 +1,70 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(StencilMask,control the writing of individual bits in the stencil planes) +_names(StencilMask) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a bit mask to enable and disable writing of individual bits +in the stencil planes. +Initially, the mask is all 1's. +.SH DESCRIPTION +_cmnd controls the writing of individual bits in the stencil planes. +The least significant $n$ bits of _param1, +where $n$ is the number of bits in the stencil buffer, +specify a mask. +Where a 1 appears in the mask, +it's possible to write to the corresponding bit in the stencil buffer. +Where a 0 appears, +the corresponding bit is write-protected. +Initially, all bits are enabled for writing. +.SH ERRORS +_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(Get) with argument _const(STENCIL_WRITEMASK) +.br +_cmnd(Get) with argument _const(STENCIL_BITS) +.SH SEE ALSO +_cmnd(ColorMask), +_cmnd(DepthMask), +_cmnd(IndexMask), +_cmnd(StencilFunc), +_cmnd(StencilOp) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/stencilop.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/stencilop.gl new file mode 100644 index 000000000..6aa66736f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/stencilop.gl @@ -0,0 +1,155 @@ +_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(StencilOp,set stencil test actions) +.EQ +delim $$ +.EN +_names(StencilOp) +.SH PARAMETERS +_phead(_param1) +Specifies the action to take when the stencil test fails. +Six symbolic constants are accepted: +_const(KEEP), +_const(ZERO), +_const(REPLACE), +_const(INCR), +_const(DECR), and +_const(INVERT). The initial value is _const(KEEP). +_phead(_param2) +Specifies the stencil action when the stencil test passes, +but the depth test fails. +_param2 accepts the same symbolic constants as _param1. The initial value +is _const(KEEP). +_phead(_param3) +Specifies the stencil action when both the stencil test and the depth +test pass, or when the stencil test passes and either there is no +depth buffer or depth testing is not enabled. +_param3 accepts the same symbolic constants as _param1. The initial value +is _const(KEEP). +.SH DESCRIPTION +Stenciling, +like depth-buffering, +enables and disables drawing on a per-pixel basis. +You draw into the stencil planes using GL drawing primitives, +then render geometry and images, +using the stencil planes to mask out portions of the screen. +Stenciling is typically used in multipass rendering algorithms +to achieve special effects, +such as decals, +outlining, +and constructive solid geometry rendering. +.P +The stencil test conditionally eliminates a pixel based on the outcome +of a comparison between the value in the stencil buffer and a +reference value. To enable and disable the test, call _cmnd(Enable) +and _cmnd(Disable) with argument +_const(STENCIL_TEST); to control it, call _cmnd(StencilFunc). +.P +_cmnd takes three arguments that indicate what happens +to the stored stencil value while stenciling is enabled. +If the stencil test fails, +no change is made to the pixel's color or depth buffers, +and _param1 specifies what happens to the stencil buffer contents. +The following six actions are possible. +.TP 16 +_const( KEEP) +Keeps the current value. +.TP +_const( ZERO) +Sets the stencil buffer value to 0. +.TP +_const( REPLACE) +Sets the stencil buffer value to \f2ref\fP, +as specified by _cmnd(StencilFunc). +.TP +_const( INCR) +Increments the current stencil buffer value. +Clamps to the maximum representable unsigned value. +.TP +_const( DECR) +Decrements the current stencil buffer value. +Clamps to 0. +.TP +_const( INVERT) +Bitwise inverts the current stencil buffer value. +.P +Stencil buffer values are treated as unsigned integers. +When incremented and decremented, +values are clamped to 0 and $2 sup n - 1$, +where $n$ is the value returned by querying _const(STENCIL_BITS). +.P +The other two arguments to _cmnd specify stencil buffer actions +that depend on whether subsequent depth buffer tests succeed (_param3) +or fail (_param2) (see +.br +_cmnd(DepthFunc)). +The actions are specified using the same six symbolic constants as _param1. +Note that _param2 is ignored when there is no depth buffer, +or when the depth buffer is not enabled. +In these cases, _param1 and _param3 specify stencil action when the +stencil test fails and passes, +respectively. +.SH NOTES +Initially the stencil test is disabled. +If there is no stencil buffer, +no stencil modification can occur +and it is as if the stencil tests always pass, +regardless of any call to _cmnd. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1, +_param2, or _param3 is any value other than the six defined constant values. +.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(Get) with argument _const(STENCIL_FAIL) +.br +_cmnd(Get) with argument _const(STENCIL_PASS_DEPTH_PASS) +.br +_cmnd(Get) with argument _const(STENCIL_PASS_DEPTH_FAIL) +.br +_cmnd(Get) with argument _const(STENCIL_BITS) +.br +_cmnd(IsEnabled) with argument _const(STENCIL_TEST) +.SH SEE ALSO +_cmnd(AlphaFunc), +_cmnd(BlendFunc), +_cmnd(DepthFunc), +_cmnd(Enable), +_cmnd(LogicOp), +_cmnd(StencilFunc) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texcoord.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texcoord.gl new file mode 100644 index 000000000..ef5be9513 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texcoord.gl @@ -0,0 +1,92 @@ +_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(TexCoord, set the current texture coordinates) +_names(TexCoord,[1-4]u*[sifdb]) +.SH PARAMETERS +_phead(_param1 _param2 _param3 _param4) +Specify \f2s\fP, \f2t\fP, \f2r\fP, and \f2q\fP texture coordinates. +Not all parameters are present in all forms of the command. +_names(TexCoord,[1-4]u*[sifdb]v) +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to an array of one, two, three, or four elements, +which in turn specify the +\f2s\fP, +\f2t\fP, +\f2r\fP, and +\f2q\fP texture coordinates. +.SH DESCRIPTION +_cmnd specifies texture coordinates in +one, +two, +three, or +four dimensions. +_cmnd(TexCoord1) sets the current texture coordinates to +(_param1(1), 0, 0, 1); +a call to +.br +_cmnd(TexCoord2) sets them to +(_param1(1), _param2(1), 0, 1). +.BP +Similarly, _cmnd(TexCoord3) specifies the texture coordinates as +(_param1(1), _param2(1), _param3(1), 1), and +_cmnd(TexCoord4) defines all four components explicitly as +(_param1(1), _param2(1), _param3(1), _param4(1)). +.P +The current texture coordinates are part of the data +that is associated with each vertex and with the current +raster position. +Initially, the values for +\f2s\fP, +\f2t\fP, +\f2r\fP, and +\f2q\fP +are (0, 0, 0, 1). +.P +.SH NOTES +The current texture coordinates can be updated at any time. +In particular, +_cmnd can be called between a call to _cmnd(Begin) and the corresponding +call to _cmnd(End). +.P +When the _arbstring(imaging) extension is supported, _cmnd always +updates texture unit _arbconst(TEXTURE0). +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(CURRENT_TEXTURE_COORDS) +.SH SEE ALSO +_cmnd(TexCoordPointer), +_cmnd(Vertex) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texcoordpointer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texcoordpointer.gl new file mode 100644 index 000000000..327732aca --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texcoordpointer.gl @@ -0,0 +1,154 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_C_ the function name must appear in (APIFILE) (usually gl.h) as set in +_C_ Makefile. +_header(TexCoordPointer,define an array of texture coordinates) +_names(TexCoordPointer) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the number of coordinates per array element. Must be 1, 2, 3 +or 4. The initial value is 4. +_phead(_param2) +Specifies the data type of each texture coordinate. +Symbolic constants +_const(SHORT), +_const(INT), +_const(FLOAT), +or _const(DOUBLE) +are accepted. The initial value is _const(FLOAT). +_phead(_param3) +Specifies the byte offset between consecutive array elements. +If _param3 is 0, the array elements are understood +to be tightly packed. The initial value is 0. +_phead(_param4) +Specifies a pointer to the first coordinate of the first element in the +array. The initial value is 0. +.SH DESCRIPTION +_cmnd specifies the location and data format of an array of texture +coordinates to use when rendering. +_param1 specifies the number of coordinates per +element, and must be 1, 2, 3, or 4. +_param2 specifies the data type of each texture coordinate +and _param3 specifies the byte stride from one +array element to the next allowing vertices and attributes +to be packed into a single array or stored in separate arrays. +(Single-array storage may be more efficient on some implementations; +see +.br +_cmnd(InterleavedArrays).) +When a texture +coordinate array is specified, _param1, _param2, _param3, and _param4 +are saved client-side state. +.P +To enable and disable the texture coordinate array, call +_cmnd(EnableClientState) and _cmnd(DisableClientState) with the argument +_const(TEXTURE_COORD_ARRAY). If +enabled, the texture coordinate array is used +when _cmnd(DrawArrays), _cmnd(DrawElements), _cmnd(DrawRangeElements) or +_cmnd(ArrayElement) is called. +.P +Use _cmnd(DrawArrays) to construct a sequence of primitives (all of the +same type) from prespecified vertex and vertex attribute arrays. +Use _cmnd(ArrayElement) to specify primitives +by indexing vertices and vertex attributes and _cmnd(DrawElements) to +construct a sequence of primitives by indexing vertices and vertex attributes. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +The texture coordinate array is initially disabled and it won't be +accessed when +_cmnd(ArrayElement), _cmnd(DrawElements), _cmnd(DrawRangeElements), or +_cmnd(DrawArrays) is called. +.P +Execution of _cmnd is not allowed between the execution of +_cmnd(Begin) and the corresponding execution of _cmnd(End), +but an error may or may not be generated. If no error is generated, +the operation is undefined. +.P +_cmnd is typically implemented on the client side with no protocol. +.P +The texture coordinate array parameters are client-side state and are +therefore not saved or restored by _cmnd(PushAttrib) and _cmnd(PopAttrib). +Use _cmnd(PushClientAttrib) and +_cmnd(PopClientAttrib) instead. +.P +When the _arbstring(imaging) extension is supported, _cmnd updates the +texture coordinate array state of the active client texture unit, +specified with _cmnd(ClientActiveTextureARB). +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is not 1, 2, 3, or 4. +.P +_const(INVALID_ENUM) is generated if _param2 is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param3 is negative. +.SH ASSOCIATED GETS +_cmnd(IsEnabled) with argument _const(TEXTURE_COORD_ARRAY) +.br +_cmnd(Get) with argument _const(TEXTURE_COORD_ARRAY_SIZE) +.br +_cmnd(Get) with argument _const(TEXTURE_COORD_ARRAY_TYPE) +.br +_cmnd(GetPointerv) with argument _const(TEXTURE_COORD_ARRAY_POINTER) +.SH SEE ALSO +_C_ no queries or gets listed above, alphabetize commands, +_C_ seperate with commas not .br. no command appears in the associated gets +_C_ as well as in SEE ALSO. +_cmnd(ArrayElement), +_cmnd(ClientActiveTextureARB), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(DrawRangeElements), +_cmnd(EdgeFlagPointer), +_cmnd(Enable), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(NormalPointer), +_cmnd(PopClientAttrib), +_cmnd(PushClientAttrib), +_cmnd(TexCoord), +_cmnd(VertexPointer) 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 new file mode 100644 index 000000000..f33860972 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texenv.gl @@ -0,0 +1,183 @@ +_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) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texgen.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texgen.gl new file mode 100644 index 000000000..66e29f1be --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texgen.gl @@ -0,0 +1,243 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(TexGen,control the generation of texture coordinates) +_names(TexGen,[ifd]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a texture coordinate. +Must be one of _const(S), _const(T), _const(R), or _const(Q). +_phead(_param2) +Specifies the symbolic name of the texture-coordinate generation function. +Must be _const(TEXTURE_GEN_MODE). +_phead(_param3) +Specifies a single-valued texture generation parameter, +one of _const(OBJECT_LINEAR), _const(EYE_LINEAR), or _const(SPHERE_MAP). +_names(TexGen,[ifd]v) +.SH PARAMETERS +_phead(_param1) +Specifies a texture coordinate. +Must be one of _const(S), _const(T), _const(R), or _const(Q). +_phead(_param2) +Specifies the symbolic name of the texture-coordinate generation function +or function parameters. +Must be +_const(TEXTURE_GEN_MODE), +_const(OBJECT_PLANE), or +_const(EYE_PLANE). +_phead(_param3) +Specifies a pointer to an array of texture generation parameters. +If _param2 is _const(TEXTURE_GEN_MODE), +then the array must contain a single symbolic constant, +one of +_const(OBJECT_LINEAR), +_const(EYE_LINEAR), or +_const(SPHERE_MAP). +Otherwise, +_param3 holds the coefficients for the texture-coordinate generation function +specified by _param2. +.SH DESCRIPTION +_cmnd selects a texture-coordinate generation function +or supplies coefficients for one of the functions. +_param1 names one of the (\f2s\fP, \f2t\fP, \f2r\fP, \f2q\fP) texture +coordinates; it must be one of the symbols +_const(S), +_const(T), +_const(R), or +_const(Q). +_param2 must be one of three symbolic constants: +_const(TEXTURE_GEN_MODE), +_const(OBJECT_PLANE), or +_const(EYE_PLANE). +If _param2 is _const(TEXTURE_GEN_MODE), +then _param3 chooses a mode, +one of +_const(OBJECT_LINEAR), +_const(EYE_LINEAR), or +_const(SPHERE_MAP). +If _param2 is either _const(OBJECT_PLANE) or _const(EYE_PLANE), +_param3 contains coefficients for the corresponding +texture generation function. +.P +If the texture generation function is _const(OBJECT_LINEAR), +the function +.P +.ce +$g ~=~ p sub 1^x sub o ~+~ p sub 2^y sub o ~+~ p sub 3^z sub o ~+~ p sub 4^w sub o$ +.P +.br +is used, where $g$ is the value computed for the coordinate named in _param1, +$p sub 1$, +$p sub 2$, +$p sub 3$, +and +$p sub 4$ are the four values supplied in _param3, and +$x sub o$, +$y sub o$, +$z sub o$, and +$w sub o$ are the object coordinates of the vertex. +This function can be used, for example, to texture-map terrain using sea level +as a reference plane +(defined by $p sub 1$, $p sub 2$, $p sub 3$, and $p sub 4$). +The altitude of a terrain vertex is computed by the _const(OBJECT_LINEAR) +coordinate generation function as its distance from sea level; +that altitude can then be used to index the texture image to map white snow +onto peaks and green grass onto foothills. +.P +If the texture generation function is _const(EYE_LINEAR), the function +.P +.ce +$g ~=~ p sub 1 sup prime ^x sub e ~+~ p sub 2 sup prime ^y sub e ~+~ p sub 3 sup prime ^z sub e ~+~ p sub 4 sup prime ^w sub e$ +.P +.br +is used, where +.P +.ce +$( p sub 1 sup prime +~~p sub 2 sup prime~~p sub 3 sup prime~~ +{ p sub 4 sup prime}) ~=~ ( p sub 1~~ p sub 2~~ p sub 3~~ p sub 4 ) ~M sup -1$ +.P +.br +and +$x sub e$, +$y sub e$, +$z sub e$, and +$w sub e$ are the eye coordinates of the vertex, +$p sub 1$, +$p sub 2$, +$p sub 3$, +and +$p sub 4$ are the values supplied in _param3, and +$M$ is the modelview matrix when _cmnd is invoked. +If $M$ is poorly conditioned or singular, +texture coordinates generated by the resulting function may be inaccurate +or undefined. +.P +Note that the values in _param3 define a reference plane in eye coordinates. +The modelview matrix that is applied to them may not be the same one +in effect when the polygon vertices are transformed. +This function establishes a field of texture coordinates +that can produce dynamic contour lines on moving objects. +.P +If _param2 is _const(SPHERE_MAP) and _param1 is either +_const(S) or +_const(T), +$s$ and $t$ texture coordinates are generated as follows. +Let \f2u\fP be the unit vector pointing from the origin to the polygon vertex +(in eye coordinates). +Let \f2n\fP sup prime be the current normal, +after transformation to eye coordinates. +Let +.P +.ce +$f ~=~ ( f sub x~~f sub y~~f sub z ) sup T$ +be the reflection vector such that +.P +.ce +$f ~=~ u ~-~ 2 n sup prime n sup prime sup T u$ +.br +.P +Finally, let $ m ~=~ 2 sqrt { f sub x sup {~2} ~+~ f sub y sup {~2} ~+~ (f sub z ~+~ 1 ) sup 2}$. +Then the values assigned to the $s$ and $t$ texture coordinates are +.P +.ce 1 +$s ~=~ f sub x over m ~+~ 1 over 2$ +.sp +.ce 1 +$t ~=~ f sub y over m ~+~ 1 over 2$ +.P +To enable or disable a texture-coordinate generation function, call +_cmnd(Enable) or _cmnd(Disable) +with one of the symbolic texture-coordinate names +(_const(TEXTURE_GEN_S), +_const(TEXTURE_GEN_T), +_const(TEXTURE_GEN_R), or +_const(TEXTURE_GEN_Q)) as the argument. +When enabled, +the specified texture coordinate is computed +according to the generating function associated with that coordinate. +When disabled, +subsequent vertices take the specified texture coordinate +from the current set of texture coordinates. Initially, all texture +generation functions are set to _const(EYE_LINEAR) and are disabled. +Both $s$ plane equations are (1, 0, 0, 0), +both $t$ plane equations are (0, 1, 0, 0), +and all $r$ and $q$ plane equations are (0, 0, 0, 0). +.P +When the _arbstring(multitexture) extension is supported, _cmnd set the +texture generation parameters for the currently active texture unit, +selected with _cmnd(ActiveTextureARB). +.SH ERRORS +_const(INVALID_ENUM) is generated when _param1 or _param2 is not an +accepted defined value, +or when _param2 is _const(TEXTURE_GEN_MODE) and _param3 is not an +accepted defined value. +.P +_const(INVALID_ENUM) is generated when _param2 is _const(TEXTURE_GEN_MODE), +_param3 is _const(SPHERE_MAP), +and _param1 is either _const(R) or _const(Q). +.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(GetTexGen) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_GEN_S) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_GEN_T) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_GEN_R) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_GEN_Q) +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(CopyPixels), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(TexEnv), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexParameter), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/teximage1d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/teximage1d.gl new file mode 100644 index 000000000..e93a63ac5 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/teximage1d.gl @@ -0,0 +1,461 @@ +_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(TexImage1D,specify a one-dimensional texture image) +_names(TexImage1D) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. +Must be _const(TEXTURE_1D) or _const(PROXY_TEXTURE_1D). +_phead(_param2) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(_param3) +Specifies the number of color components in the texture. +Must be 1, 2, 3, or 4, or one of the following symbolic constants: +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(RGB), +_const(R3_G3_B2), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(_param4) +Specifies the width of the texture image. +Must be $2 sup n + 2 ( _eqnparam5 )$ for some integer $n$. All +implementations support texture images that are at least 64 texels +wide. The height of the 1D texture image is 1. +_phead(_param5) +Specifies the width of the border. +Must be either 0 or 1. +_phead(_param6) +Specifies the format of the pixel data. +The following symbolic values are accepted: +_const(COLOR_INDEX), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(_param7) +Specifies the data type of the pixel data. +The following symbolic values are accepted: +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(_param8) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +Texturing maps a portion of a specified texture image +onto each graphical primitive for which texturing is enabled. +To enable and disable one-dimensional texturing, call _cmnd(Enable) +and _cmnd(Disable) with argument _const(TEXTURE_1D). +.P +Texture images are defined with _cmnd. +The arguments describe the parameters of the texture image, +such as width, +width of the border, +level-of-detail number +(see _cmnd(TexParameter)), +and the internal resolution and format used to store the image. +The last three arguments describe how the image is represented in +memory; they are identical to the pixel formats used for +_cmnd(DrawPixels). +.P +If _param1 is _const(PROXY_TEXTURE_1D), no data is read from _param8, but +all of the texture image state is recalculated, checked for +consistency, and checked against the implementation's capabilities. +If the implementation cannot handle a texture of the +requested texture size, it sets all of the image state to 0, +but does not generate an error (see _cmnd(GetError)). To query for an +entire mipmap array, use an image array level greater than or equal to +1. +.P +If _param1 is _const(TEXTURE_1D), +data is read from _param8 as a sequence of signed or unsigned bytes, +shorts, +or longs, +or single-precision floating-point values, +depending on _param7. +These values are grouped into sets of one, +two, +three, +or four values, +depending on _param6, +to form elements. +If _param7 is _const(BITMAP), +the data is considered as a string of unsigned bytes +(and _param6 must be _const(COLOR_INDEX)). +Each data byte is treated as eight 1-bit elements, +with bit ordering determined by _const(UNPACK_LSB_FIRST) +(see _cmnd(PixelStore)). +.P +The first element corresponds to the left end of the texture array. +Subsequent elements progress left-to-right through the remaining texels +in the texture array. +The final element corresponds to the right end of the texture array. +.P +_param6 determines the composition of each element in _param8. +It can assume one of eleven symbolic values: +.TP 10 +_const(COLOR_INDEX) +Each element is a single value, +a color index. +The GL converts it to fixed point +(with an unspecified number of zero bits to the right of the binary point), +shifted left or right depending on the value and sign of _const(INDEX_SHIFT), +and added to _const(INDEX_OFFSET) +(see _cmnd(PixelTransfer)). +The resulting index is converted to a set of color components +using the +_const(PIXEL_MAP_I_TO_R), +_const(PIXEL_MAP_I_TO_G), +_const(PIXEL_MAP_I_TO_B), and +_const(PIXEL_MAP_I_TO_A) tables, +and clamped to the range [0,1]. +.TP +_const(RED) +Each element is a single red component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for green and blue, and 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS). +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(GREEN) +Each element is a single green component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for red and blue, and 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(BLUE) +Each element is a single blue component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for red and green, and 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(ALPHA) +Each element is a single alpha component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for red, green, and blue. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(RGB) +.TP +_const(BGR) +Each element is an RGB triple. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(RGBA) +.TP +_const(BGRA) +_C_ .TP +_C_ _const(ABGR_EXT) +Each element contains all four components. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(LUMINANCE) +Each element is a single luminance value. +The GL converts it to floating point, +then assembles it into an RGBA element by replicating the luminance value +three times for red, green, and blue and attaching 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(LUMINANCE_ALPHA) +Each element is a luminance/alpha pair. +The GL converts it to floating point, +then assembles it into an RGBA element by replicating the luminance value +three times for red, green, and blue. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] (see _cmnd(PixelTransfer)). +.P +If an application wants to store the texture at a certain +resolution or in a certain format, it can request the resolution +and format with _param3. The GL will choose an internal +representation that closely approximates that requested by _param3, but +it may not match exactly. +(The representations specified by _const(LUMINANCE), _const(LUMINANCE_ALPHA), _const(RGB), +and _const(RGBA) must match exactly. The numeric values 1, 2, 3, and 4 may also be used to +specify the preceding representations.) +.P +Use the _const(PROXY_TEXTURE_1D) target to try out a resolution and +format. The implementation will +update and recompute its best match for the requested storage resolution +and format. To query this state, call _cmnd(GetTexLevelParameter). +If the texture cannot be accommodated, texture state is set to 0. +.P +A one-component texture image uses only the red component of the RGBA +color from _param8. +A two-component image uses the R and A values. +A three-component image uses the R, G, and B values. +A four-component image uses all of the RGBA components. +.SH NOTES +Texturing has no effect in color index mode. +.P +If the _arbstring(imaging) extension is supported, RGBA elements may +also be processed by the imaging pipeline. The following stages may be +applied to an RGBA color before color component clamping to the range +[0,\ 1]: +.TP 3 +1. Color component replacement by the color table specified for +_const(COLOR_TABLE), if enabled. See _cmnd(ColorTable). +.TP +2. One-dimensional convolution filtering, if enabled. See +_cmnd(ConvolutionFilter1D). +.IP +If a convolution filter changes the __width of the texture (by +processing with a _const(CONVOLUTION_BORDER_MODE) of _const(REDUCE), for +example), the _param4 must $2 sup n + 2 ( _eqnparam5 )$, for some +integer $n$, after filtering. +.TP +3. RGBA components may be multiplied by _const(POST_CONVOLUTION_c_SCALE), +and added to _const(POST_CONVOLUTION_c_BIAS), if enabled. See +_cmnd(PixelTransfer). +.TP +4. Color component replacement by the color table specified for +_const(POST_CONVOLUTION_COLOR_TABLE), if enabled. See _cmnd(ColorTable). +.TP +5. Transformation by the color matrix. See _cmnd(MatrixMode). +.TP +6. RGBA components may be multiplied by _const(POST_COLOR_MATRIX_c_SCALE), +and added to _const(POST_COLOR_MATRIX_c_BIAS), if enabled. See +_cmnd(PixelTransfer). +.TP +7. Color component replacement by the color table specified for +_const(POST_COLOR_MATRIX_COLOR_TABLE), if enabled. See _cmnd(ColorTable). +.P +The texture image can be represented by the same data formats +as the pixels in a _cmnd(DrawPixels) command, +except that _const(STENCIL_INDEX) and _const(DEPTH_COMPONENT) +cannot be used. +_cmnd(PixelStore) and _cmnd(PixelTransfer) modes affect texture images +in exactly the way they affect _cmnd(DrawPixels). +.P +_C_ _const(ABGR_EXT) is +_C_ part of the _extname(EXT_abgr) extension, not part of +_C_ the core GL command set. If _extstring(EXT_abgr) is included +_C_ in the string returned by _cmnd(GetString), when called with +_C_ argument _const(EXTENSIONS), extension _extname(EXT_abgr) is +_C_ supported by the connection. +_C_ .P +_const(PROXY_TEXTURE_1D) may be used only if the GL version is 1.1 or greater. +.P +Internal formats other than 1, 2, 3, or 4 may be +used only if the GL version is 1.1 or greater. +.P +In GL version 1.1 or greater, +_param8 may be a null pointer. In this case texture memory is +allocated to accommodate a texture of width _param4. +You can then download subtextures to initialize the +texture memory. The image is undefined if the program tries to apply +an uninitialized portion of the texture image to a primitive. +.P +Formats _const(BGR), and _const(BGRA) and types +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) are available only if the GL version +is 1.2 or greater. +.P +When the _arbstring(multitexture) extension is supported, _cmnd +specifies the one-dimensional texture for the current texture unit, +specified with _cmnd(ActiveTextureARB). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not _const(TEXTURE_1D) +or _const(PROXY_TEXTURE_1D). +.P +_const(INVALID_ENUM) is generated if _param6 is not an accepted +format constant. +Format constants other than _const(STENCIL_INDEX) and _const(DEPTH_COMPONENT) +are accepted. +.P +_const(INVALID_ENUM) is generated if _param7 is not a type constant. +.P +_const(INVALID_ENUM) is generated if _param7 is _const(BITMAP) and +_param6 is not _const(COLOR_INDEX). +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater than $log +sub 2$\f2max\fP, +where \f2max\fP is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if _param3 is not 1, 2, 3, 4, or +one of the accepted resolution and format symbolic constants. +.P +_const(INVALID_VALUE) is generated if _param4 is less than 0 +or greater than 2 + _const(MAX_TEXTURE_SIZE), +or if it cannot be represented as $2 sup n ~+~ 2(_eqnparam5)$ +for some integer value of \f2n\fP. +.P +_const(INVALID_VALUE) is generated if _param5 is not 0 or 1. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param7 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param6 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param7 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param6 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_1D) +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(ColorTable), +_cmnd(ConvolutionFilter1D), +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(MatrixMode), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D), +_cmnd(TexParameter) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/teximage2d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/teximage2d.gl new file mode 100644 index 000000000..0e7203a99 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/teximage2d.gl @@ -0,0 +1,487 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(TexImage2D,specify a two-dimensional texture image) +_names(TexImage2D) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. +Must be _const(TEXTURE_2D) or _const(PROXY_TEXTURE_2D). +_phead(_param2) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(_param3) +Specifies the number of color components in the texture. +Must be 1, 2, 3, or 4, or one of the following symbolic constants: +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(_param4) +Specifies the width of the texture image. +Must be $2 sup n ~+~ 2 ( _eqnparam6 )$ for some integer $n$. All +implementations support texture images that are at least 64 texels +wide. +_phead(_param5) +Specifies the height of the texture image. +Must be $2 sup m ~+~ 2 ( _eqnparam6 )$ for some integer $m$. All +implementations support texture images that are at least 64 texels +high. +_phead(_param6) +Specifies the width of the border. +Must be either 0 or 1. +_phead(_param7) +Specifies the format of the pixel data. +The following symbolic values are accepted: +_const(COLOR_INDEX), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR) +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(_param8) +Specifies the data type of the pixel data. +The following symbolic values are accepted: +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(_param9) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +Texturing maps a portion of a specified texture image +onto each graphical primitive for which texturing is enabled. +To enable and disable two-dimensional texturing, call _cmnd(Enable) +and _cmnd(Disable) with argument _const(TEXTURE_2D). +.P +To define texture images, call _cmnd. +The arguments describe the parameters of the texture image, +such as height, +width, +width of the border, +level-of-detail number +(see _cmnd(TexParameter)), +and number of color components provided. +The last three arguments describe how the image is represented in memory; +they are identical to the pixel formats used for _cmnd(DrawPixels). +.P +If _param1 is _const(PROXY_TEXTURE_2D), no data is read from _param9, but +all of the texture image state is recalculated, checked for +consistency, and checked +against the implementation's capabilities. If the implementation cannot +handle a texture of the requested texture size, it sets +all of the image state to 0, +but does not generate an error (see _cmnd(GetError)). To query for an +entire mipmap array, use an image array level greater than or equal to +1. +.P +If _param1 is _const(TEXTURE_2D), +data is read from _param9 as a sequence of signed or unsigned bytes, +shorts, +or longs, +or single-precision floating-point values, +depending on _param8. +These values are grouped into sets of one, +two, +three, +or four values, +depending on _param7, +to form elements. +If _param8 is _const(BITMAP), +the data is considered as a string of unsigned bytes (and +_param7 must be _const(COLOR_INDEX)). +.bp +Each data byte is treated as eight 1-bit elements, +with bit ordering determined by _const(UNPACK_LSB_FIRST) +(see _cmnd(PixelStore)). +.P +The first element corresponds to the lower left corner of the texture +image. +Subsequent elements progress left-to-right through the remaining texels +in the lowest row of the texture image, and then in successively higher +rows of the texture image. +The final element corresponds to the upper right corner of the texture +image. +.P +_param7 determines the composition of each element in _param9. +It can assume one of eleven symbolic values: +.TP 10 +_const(COLOR_INDEX) +Each element is a single value, +a color index. +The GL converts it to fixed point +(with an unspecified number of zero bits to the right of the binary point), +shifted left or right depending on the value and sign of _const(INDEX_SHIFT), +and added to _const(INDEX_OFFSET) +(see +.br +_cmnd(PixelTransfer)). +The resulting index is converted to a set of color components +using the +_const(PIXEL_MAP_I_TO_R), +_const(PIXEL_MAP_I_TO_G), +_const(PIXEL_MAP_I_TO_B), and +_const(PIXEL_MAP_I_TO_A) tables, +and clamped to the range [0,1]. +.TP +_const(RED) +Each element is a single red component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for green and blue, and 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(GREEN) +Each element is a single green component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for red and blue, and 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(BLUE) +Each element is a single blue component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for red and green, and 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(ALPHA) +Each element is a single alpha component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for red, green, and blue. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(RGB) +.TP +_const(BGR) +Each element is an RGB triple. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see +.br +_cmnd(PixelTransfer)). +.TP +_const(RGBA) +.TP +_const(BGRA) +_C_ .TP +_C_ _const(ABGR_EXT) +Each element contains all four components. +Each component is multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(LUMINANCE) +Each element is a single luminance value. +The GL converts it to floating point, +then assembles it into an RGBA element by replicating the luminance value +three times for red, green, and blue and attaching 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(LUMINANCE_ALPHA) +Each element is a luminance/alpha pair. +The GL converts it to floating point, +then assembles it into an RGBA element by replicating the luminance value +three times for red, green, and blue. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see +.br +_cmnd(PixelTransfer)). +.P +Refer to the _cmnd(DrawPixels) reference page for a description of +the acceptable values for the _param8 parameter. +.P +If an application wants to store the texture at a certain +resolution or in a certain format, it can request the resolution +and format with _param3. The GL will choose an internal +representation that closely approximates that requested by _param3, but +it may not match exactly. +(The representations specified by _const(LUMINANCE), +_const(LUMINANCE_ALPHA), _const(RGB), +and _const(RGBA) must match exactly. The numeric values 1, 2, 3, and 4 +may also be used to specify the above representations.) +.P +Use the _const(PROXY_TEXTURE_2D) target to try out a resolution and +format. The implementation will +update and recompute its best match for the requested storage resolution +and format. To then query this state, call +_cmnd(GetTexLevelParameter). +If the texture cannot be accommodated, texture state is set to 0. +.P +A one-component texture image uses only the red component of the RGBA +color extracted from _param9. +A two-component image uses the R and A values. +A three-component image uses the R, G, and B values. +A four-component image uses all of the RGBA components. +.SH NOTES +Texturing has no effect in color index mode. +.P +If the _arbstring(imaging) extension is supported, RGBA elements may +also be processed by the imaging pipeline. The following stages may be +applied to an RGBA color before color component clamping to the range +[0,\ 1]: +.TP 3 +1. Color component replacement by the color table specified for +_const(COLOR_TABLE), if enabled. See _cmnd(ColorTable). +.TP +2. Two-dimensional Convolution filtering, if enabled. See +_cmnd(ConvolutionFilter1D). +.IP +If a convolution filter changes the __width of the texture (by +processing with a _const(CONVOLUTION_BORDER_MODE) of _const(REDUCE), for +example), the _param4 must $2 sup n + 2 ( _eqnparam5 )$, for some +integer $n$, and _param5 must be $2 sup m + ( _eqnparam6 )$, for some +integer $m$, after filtering. +.TP +3. RGBA components may be multiplied by _const(POST_CONVOLUTION_c_SCALE), +and added to _const(POST_CONVOLUTION_c_BIAS), if enabled. See +_cmnd(PixelTransfer). +.TP +4. Color component replacement by the color table specified for +_const(POST_CONVOLUTION_COLOR_TABLE), if enabled. See _cmnd(ColorTable). +.TP +5. Transformation by the color matrix. See _cmnd(MatrixMode). +.TP +6. RGBA components may be multiplied by _const(POST_COLOR_MATRIX_c_SCALE), +and added to _const(POST_COLOR_MATRIX_c_BIAS), if enabled. See +_cmnd(PixelTransfer). +.TP +7. Color component replacement by the color table specified for +_const(POST_COLOR_MATRIX_COLOR_TABLE), if enabled. See +_cmnd(ColorTable). +.P +The texture image can be represented by the same data formats +as the pixels in a _cmnd(DrawPixels) command, +except that _const(STENCIL_INDEX) and _const(DEPTH_COMPONENT) +cannot be used. +_cmnd(PixelStore) and _cmnd(PixelTransfer) modes affect texture images +in exactly the way they affect _cmnd(DrawPixels). +.P +_C_ _const(ABGR_EXT) is +_C_ part of the _extname(EXT_abgr) extension, not part of +_C_ the core GL command set. If _extstring(EXT_abgr) is included +_C_ in the string returned by _cmnd(GetString), when called with +_C_ argument _const(EXTENSIONS), extension _extname(EXT_abgr) is +_C_ supported by the GL. +.P +_cmnd and _const(PROXY_TEXTURE_2D) are available only if the GL +version is 1.1 or greater. +.P +Internal formats other than 1, 2, 3, or 4 may be used only if the GL +version is 1.1 or greater. +.P +In GL version 1.1 or greater, _param9 may be a null pointer. +In this case texture memory is +allocated to accommodate a texture of width _param4 and height _param5. +You can then download subtextures to initialize this +texture memory. +The image is undefined if the user tries to apply +an uninitialized portion of the texture image to a primitive. +.P +Formats _const(BGR), and _const(BGRA) and types +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) are available only if the GL version +is 1.2 or greater. +.P +When the _arbstring(multitexture) extension is supported, _cmnd +specifies the two-dimensional texture for the current texture unit, +specified with _cmnd(ActiveTextureARB). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not _const(TEXTURE_2D) +or _const(PROXY_TEXTURE_2D). +.P +_const(INVALID_ENUM) is generated if _param7 is not an accepted +format constant. +Format constants other than _const(STENCIL_INDEX) and _const(DEPTH_COMPONENT) +are accepted. +.P +_const(INVALID_ENUM) is generated if _param8 is not a type constant. +.P +_const(INVALID_ENUM) is generated if _param8 is _const(BITMAP) and +_param7 is not _const(COLOR_INDEX). +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater than $log +sub 2$\f2max\fP, +where \f2max\fP is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if _param3 is not 1, 2, 3, 4, or one of the +accepted resolution and format symbolic constants. +.P +_const(INVALID_VALUE) is generated if _param4 or _param5 is less than 0 +or greater than 2 + _const(MAX_TEXTURE_SIZE), +or if either cannot be represented as $2 sup k ~+~ 2(_eqnparam6)$ for some +integer value of \f2k\fP. +.P +_const(INVALID_VALUE) is generated if _param6 is not 0 or 1. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param8 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param7 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param8 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param7 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_2D) +.SH SEE ALSO +_cmnd(ColorTable), +_cmnd(ConvolutionFilter2D), +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(MatrixMode), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(SeparableFilter2D), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D), +_cmnd(TexParameter) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/teximage3d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/teximage3d.gl new file mode 100644 index 000000000..e857156cc --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/teximage3d.gl @@ -0,0 +1,488 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(TexImage3D,specify a three-dimensional texture image) +_names(TexImage3D) +.EQ +delim $$ +.EN +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__level>@,@<_param2>@)_C_ +_define(@<__internalformat>@,@<_param3>@)_C_ +_define(@<__width>@,@<_param4>@)_C_ +_define(@<__height>@,@<_param5>@)_C_ +_define(@<__depth>@,@<_param6>@)_C_ +_define(@<__border>@,@<_param7>@)_C_ +_define(@<__eqnborder>@,@<_eqnparam7>@)_C_ +_define(@<__format>@,@<_param8>@)_C_ +_define(@<__type>@,@<_param9>@)_C_ +_define(@<__pixels>@,@<_param10>@)_C_ +.SH PARAMETERS +_phead(__target) +Specifies the target texture. +Must be _const(TEXTURE_3D) or _const(PROXY_TEXTURE_3D). +_phead(__level) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level $n$ is the $n sup th$ mipmap reduction image. +_phead(__internalformat) +Specifies the number of color components in the texture. +Must be 1, 2, 3, or 4, or one of the following symbolic constants: +_const(ALPHA), +_const(ALPHA4), +_const(ALPHA8), +_const(ALPHA12), +_const(ALPHA16), +_const(LUMINANCE), +_const(LUMINANCE4), +_const(LUMINANCE8), +_const(LUMINANCE12), +_const(LUMINANCE16), +_const(LUMINANCE_ALPHA), +_const(LUMINANCE4_ALPHA4), +_const(LUMINANCE6_ALPHA2), +_const(LUMINANCE8_ALPHA8), +_const(LUMINANCE12_ALPHA4), +_const(LUMINANCE12_ALPHA12), +_const(LUMINANCE16_ALPHA16), +_const(INTENSITY), +_const(INTENSITY4), +_const(INTENSITY8), +_const(INTENSITY12), +_const(INTENSITY16), +_const(R3_G3_B2), +_const(RGB), +_const(RGB4), +_const(RGB5), +_const(RGB8), +_const(RGB10), +_const(RGB12), +_const(RGB16), +_const(RGBA), +_const(RGBA2), +_const(RGBA4), +_const(RGB5_A1), +_const(RGBA8), +_const(RGB10_A2), +_const(RGBA12), or +_const(RGBA16). +_phead(__width) +Specifies the width of the texture image. +Must be $2 sup n ~+~ 2 ( __eqnborder )$ for some integer $n$. All +implementations support texture images that are at least 64 texels +wide. +_phead(__height) +Specifies the height of the texture image. +Must be $2 sup m ~+~ 2 ( __eqnborder )$ for some integer $m$. All +implementations support texture images that are at least 64 texels +high. +_phead(__depth) +Specifies the depth of the texture image. +Must be $2 sup k ~+~ 2 ( __eqnborder )$ for some integer $k$. All +implementations support texture images that are at least 64 texels +deep. +_phead(__border) +Specifies the width of the border. +Must be either 0 or 1. +_phead(__format) +Specifies the format of the pixel data. +The following symbolic values are accepted: +_const(COLOR_INDEX), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(__type) +Specifies the data type of the pixel data. +The following symbolic values are accepted: +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT) +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(__pixels) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +Texturing maps a portion of a specified texture image +onto each graphical primitive for which texturing is enabled. +To enable and disable three-dimensional texturing, call _cmnd(Enable) +and _cmnd(Disable) with argument _const(TEXTURE_3D). +.P +To define texture images, call _cmnd. +The arguments describe the parameters of the texture image, +such as height, +width, depth, +width of the border, +level-of-detail number +(see _cmnd(TexParameter)), +and number of color components provided. +The last three arguments describe how the image is represented in memory; +they are identical to the pixel formats used for _cmnd(DrawPixels). +.P +If __target is _const(PROXY_TEXTURE_3D), no data is read from __pixels, but +all of the texture image state is recalculated, checked for +consistency, and checked +against the implementation's capabilities. If the implementation cannot +handle a texture of the requested texture size, it sets +all of the image state to 0, +but does not generate an error (see _cmnd(GetError)). To query for an +entire mipmap array, use an image array level greater than or equal to +1. +.P +If __target is _const(TEXTURE_3D), +data is read from __pixels as a sequence of signed or unsigned bytes, +shorts, +or longs, +or single-precision floating-point values, +depending on __type. +These values are grouped into sets of one, +two, +three, +or four values, +depending on __format, +to form elements. +If __type is _const(BITMAP), +the data is considered as a string of unsigned bytes (and +__format must be _const(COLOR_INDEX)). +Each data byte is treated as eight 1-bit elements, +with bit ordering determined by _const(UNPACK_LSB_FIRST) +(see _cmnd(PixelStore)). +.P +The first element corresponds to the lower left corner of the texture +image. +Subsequent elements progress left-to-right through the remaining texels +in the lowest row of the texture image, and then in successively higher +rows of the texture image. +The final element corresponds to the upper right corner of the texture +image. +.P +__format determines the composition of each element in __pixels. +It can assume one of eleven symbolic values: +.TP 10 +_const(COLOR_INDEX) +Each element is a single value, +a color index. +The GL converts it to fixed point +(with an unspecified number of zero bits to the right of the binary point), +shifted left or right depending on the value and sign of _const(INDEX_SHIFT), +and added to _const(INDEX_OFFSET) +(see +.br +_cmnd(PixelTransfer)). +The resulting index is converted to a set of color components +using the +_const(PIXEL_MAP_I_TO_R), +_const(PIXEL_MAP_I_TO_G), +_const(PIXEL_MAP_I_TO_B), and +_const(PIXEL_MAP_I_TO_A) tables, +and clamped to the range [0,1]. +.TP +_const(RED) +Each element is a single red component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for green and blue, and 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(GREEN) +Each element is a single green component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for red and blue, and 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(BLUE) +Each element is a single blue component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for red and green, and 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(ALPHA) +Each element is a single alpha component. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 0 for red, green, and blue. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(RGB) +.TP +_const(BGR) +Each element is an RGB triple. +The GL converts it to floating point and assembles it into an RGBA element +by attaching 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see +.br +_cmnd(PixelTransfer)). +.TP +_const(RGBA) +.TP +_const(BGRA) +_C_ .TP +_C_ _const(ABGR_EXT) +Each element contains all four components. +Each component is multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(LUMINANCE) +Each element is a single luminance value. +The GL converts it to floating point, +then assembles it into an RGBA element by replicating the luminance value +three times for red, green, and blue and attaching 1 for alpha. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see _cmnd(PixelTransfer)). +.TP +_const(LUMINANCE_ALPHA) +Each element is a luminance/alpha pair. +The GL converts it to floating point, +then assembles it into an RGBA element by replicating the luminance value +three times for red, green, and blue. +Each component is then multiplied by the signed scale factor _const(c_SCALE), +added to the signed bias _const(c_BIAS), +and clamped to the range [0,1] +(see +.br +_cmnd(PixelTransfer)). +.P +Refer to the _cmnd(DrawPixels) reference page for a description of +the acceptable values for the __type parameter. +.P +If an application wants to store the texture at a certain +resolution or in a certain format, it can request the resolution +and format with __internalformat. The GL will choose an internal +representation that closely approximates that requested by __internalformat, but +it may not match exactly. +(The representations specified by _const(LUMINANCE), +_const(LUMINANCE_ALPHA), _const(RGB), +and _const(RGBA) must match exactly. The numeric values 1, 2, 3, and 4 +may also be used to specify the above representations.) +.P +Use the _const(PROXY_TEXTURE_3D) target to try out a resolution and +format. The implementation will +update and recompute its best match for the requested storage resolution +and format. To then query this state, call +_cmnd(GetTexLevelParameter). +If the texture cannot be accommodated, texture state is set to 0. +.P +A one-component texture image uses only the red component of the RGBA +color extracted from __pixels. +A two-component image uses the R and A values. +A three-component image uses the R, G, and B values. +A four-component image uses all of the RGBA components. +.SH NOTES +Texturing has no effect in color index mode. +.P +The texture image can be represented by the same data formats +as the pixels in a _cmnd(DrawPixels) command, +except that _const(STENCIL_INDEX) and _const(DEPTH_COMPONENT) +cannot be used. +_cmnd(PixelStore) and _cmnd(PixelTransfer) modes affect texture images +in exactly the way they affect _cmnd(DrawPixels). +.P +_C_ _const(ABGR_EXT) is +_C_ part of the _extname(EXT_abgr) extension, not part of +_C_ the core GL command set. If _extstring(EXT_abgr) is included +_C_ in the string returned by _cmnd(GetString), when called with +_C_ argument _const(EXTENSIONS), extension _extname(EXT_abgr) is +_C_ supported by the GL. +.P +_cmnd is available only if the GL version is 1.2 or greater. +.P +Internal formats other than 1, 2, 3, or 4 may be used only if the GL +version is 1.1 or greater. +.P +__pixels may be a null pointer. +In this case texture memory is +allocated to accommodate a texture of width __width, height __height, +and depth __depth. +You can then download subtextures to initialize this +texture memory. +The image is undefined if the user tries to apply +an uninitialized portion of the texture image to a primitive. +.P +Formats _const(BGR), and _const(BGRA) and types +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) are available only if the GL version +is 1.2 or greater. +.P +When the _arbstring(multitexture) extension is supported, _cmnd +specifies the three-dimensional texture for the current texture unit, +specified with _cmnd(ActiveTextureARB). +.P +If the _arbstring(imaging) extension is supported, RGBA elements may +also be processed by the imaging pipeline. The following stages may be +applied to an RGBA color before color component clamping to the range +[0,\ 1]: +.TP 3 +1. Color component replacement by the color table specified for +_const(COLOR_TABLE), if enabled. See _cmnd(ColorTable). +.TP +2. Color component replacement by the color table specified for +_const(POST_CONVOLUTION_COLOR_TABLE), if enabled. See _cmnd(ColorTable). +.TP +3. Transformation by the color matrix. See _cmnd(MatrixMode). +.TP +4. RGBA components may be multiplied by _const(POST_COLOR_MATRIX_c_SCALE), +and added to _const(POST_COLOR_MATRIX_c_BIAS), if enabled. See +_cmnd(PixelTransfer). +.TP +5. Color component replacement by the color table specified for +_const(POST_COLOR_MATRIX_COLOR_TABLE), if enabled. See +_cmnd(ColorTable). +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not _const(TEXTURE_3D) +or _const(PROXY_TEXTURE_3D). +.P +_const(INVALID_ENUM) is generated if __format is not an accepted +format constant. +Format constants other than _const(STENCIL_INDEX) and _const(DEPTH_COMPONENT) +are accepted. +.P +_const(INVALID_ENUM) is generated if __type is not a type constant. +.P +_const(INVALID_ENUM) is generated if __type is _const(BITMAP) and +__format is not _const(COLOR_INDEX). +.P +_const(INVALID_VALUE) is generated if __level is less than 0. +.P +.P +_const(INVALID_VALUE) may be generated if __level is greater than $log +sub 2$\f2max\fP, +where \f2max\fP is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if __internalformat is not 1, 2, 3, 4, or one of the +accepted resolution and format symbolic constants. +.P +_const(INVALID_VALUE) is generated if __width, __height, or __depth +is less than 0 or greater than 2 + _const(MAX_TEXTURE_SIZE), +or if either cannot be represented as $2 sup k ~+~ 2( __eqnborder )$ for some +integer value of \f2k\fP. +.P +_const(INVALID_VALUE) is generated if __border is not 0 or 1. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param9 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param8 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param9 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param8 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_3D) +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D), +_cmnd(TexParameter) + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texparameter.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texparameter.gl new file mode 100644 index 000000000..47863ba2a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texparameter.gl @@ -0,0 +1,335 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(TexParameter, set texture parameters) +_names(TexParameter,[fi]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture, +which must be either _const(TEXTURE_1D), _const(TEXTURE_2D), or +_const(TEXTURE_3D). +_phead(_param2) +Specifies the symbolic name of a single-valued texture parameter. +_param2 can be one of the following: +_const(TEXTURE_MIN_FILTER), +_const(TEXTURE_MAG_FILTER), +_const(TEXTURE_MIN_LOD), +_const(TEXTURE_MAX_LOD), +_const(TEXTURE_BASE_LEVEL), +_const(TEXTURE_MAX_LEVEL), +_const(TEXTURE_WRAP_S), +_const(TEXTURE_WRAP_T), +_const(TEXTURE_WRAP_R), or +_const(TEXTURE_PRIORITY). +_phead(_param3) +Specifies the value of _param2. +_names(TexParameter,[fi]v) +.SH PARAMETERS +_phead(_param1) +Specifies the target texture, +which must be either _const(TEXTURE_1D), _const(TEXTURE_2D) or +_const(TEXTURE_3D). +_phead(_param2) +Specifies the symbolic name of a texture parameter. +_param2 can be one of the following: +_const(TEXTURE_MIN_FILTER), +_const(TEXTURE_MAG_FILTER), +_const(TEXTURE_MIN_LOD), +_const(TEXTURE_MAX_LOD), +_const(TEXTURE_BASE_LEVEL), +_const(TEXTURE_MAX_LEVEL), +_const(TEXTURE_WRAP_S), +_const(TEXTURE_WRAP_T), +_const(TEXTURE_WRAP_R), +_const(TEXTURE_BORDER_COLOR), or +_const(TEXTURE_PRIORITY). +_phead(_param3) +Specifies a pointer to an array where the value or values of _param2 +are stored. +.SH DESCRIPTION +Texture mapping is a technique that applies an image onto an object's surface +as if the image were a decal or cellophane shrink-wrap. +The image is created in texture space, +with an ($s$, $t$) coordinate system. +A texture is a one- or two-dimensional image and a set of parameters +that determine how samples are derived from the image. +.P +_cmnd assigns the value or values in _param3 to the texture parameter +specified as _param2. +_param1 defines the target texture, +either _const(TEXTURE_1D), _const(TEXTURE_2D), or _const(TEXTURE_3D). +The following symbols are accepted in _param2: +.TP 10 +_const(TEXTURE_MIN_FILTER) +The texture minifying function is used whenever the pixel being textured +maps to an area greater than one texture element. +There are six defined minifying functions. +Two of them use the nearest one or nearest four texture elements +to compute the texture value. +The other four use mipmaps. +.IP +A mipmap is an ordered set of arrays representing the same image +at progressively lower resolutions. +If the texture has dimensions $2 sup n ~times~ 2 sup m$, there are +$ bold max ( n, m ) + 1 $ mipmaps. +The first mipmap is the original texture, +with dimensions $2 sup n ~times~ 2 sup m$. +Each subsequent mipmap has dimensions $2 sup { k - 1 } ~times~ 2 sup { l - 1 }$, +where $2 sup k ~times~ 2 sup l$ are the dimensions of the previous mipmap, +until either $k ~=~ 0$ or $l~=~0$. +At that point, +subsequent mipmaps have dimension $ 1 ~times~ 2 sup { l - 1 } $ +or $ 2 sup { k - 1} ~times~ 1 $ until the final mipmap, +which has dimension $1 ~times~ 1$. +To define the mipmaps, call _cmnd(TexImage1D), _cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(CopyTexImage1D), or _cmnd(CopyTexImage2D) +with the \f2level\fP argument indicating the order of the mipmaps. +Level 0 is the original texture; +level $ bold max ( n, m ) $ is the final $1 ~times~ 1$ mipmap. +.IP +_param3 supplies a function for minifying the texture as one of the following: +.RS 10 +.TP 10 +_const(NEAREST) +Returns the value of the texture element that is nearest +(in Manhattan distance) +to the center of the pixel being textured. +.TP +_const(LINEAR) +Returns the weighted average of the four texture elements +that are closest to the center of the pixel being textured. +These can include border texture elements, +depending on the values of _const(TEXTURE_WRAP_S) and _const(TEXTURE_WRAP_T), +and on the exact mapping. +.TP +_const(NEAREST_MIPMAP_NEAREST) +Chooses the mipmap that most closely matches the size of the pixel +being textured and uses the _const(NEAREST) criterion +(the texture element nearest to the center of the pixel) +to produce a texture value. +.TP +_const(LINEAR_MIPMAP_NEAREST) +Chooses the mipmap that most closely matches the size of the pixel +being textured and uses the _const(LINEAR) criterion +(a weighted average of the four texture elements that are closest +to the center of the pixel) +to produce a texture value. +.TP +_const(NEAREST_MIPMAP_LINEAR) +Chooses the two mipmaps that most closely match the size of the pixel +being textured and uses the _const(NEAREST) criterion +(the texture element nearest to the center of the pixel) +to produce a texture value from each mipmap. +The final texture value is a weighted average of those two values. +.TP +_const(LINEAR_MIPMAP_LINEAR) +Chooses the two mipmaps that most closely match the size of the pixel +being textured and uses the _const(LINEAR) criterion +(a weighted average of the four texture elements that are closest +to the center of the pixel) +to produce a texture value from each mipmap. +The final texture value is a weighted average of those two values. +.RE +.IP +As more texture elements are sampled in the minification process, +fewer aliasing artifacts will be apparent. +While the _const(NEAREST) and _const(LINEAR) minification functions can be +faster than the other four, +they sample only one or four texture elements to determine the texture value +of the pixel being rendered and can produce moire patterns +or ragged transitions. +The initial value of _const(TEXTURE_MIN_FILTER) is +_const(NEAREST_MIPMAP_LINEAR). +.TP 10 +_const(TEXTURE_MAG_FILTER) +The texture magnification function is used when the pixel being textured +maps to an area less than or equal to one texture element. +It sets the texture magnification function to either _const(NEAREST) +or _const(LINEAR) (see below). _const(NEAREST) is generally faster +than _const(LINEAR), +but it can produce textured images with sharper edges +because the transition between texture elements is not as smooth. +The initial value of _const(TEXTURE_MAG_FILTER) is _const(LINEAR). +.RS 10 +.TP 10 +_const(NEAREST) +Returns the value of the texture element that is nearest +(in Manhattan distance) +to the center of the pixel being textured. +.TP +_const(LINEAR) +Returns the weighted average of the four texture elements +that are closest to the center of the pixel being textured. +These can include border texture elements, +depending on the values of _const(TEXTURE_WRAP_S) and _const(TEXTURE_WRAP_T), +and on the exact mapping. +.P +.RE +.P +.TP 10 +_const(TEXTURE_MIN_LOD) +Sets the minimum level-of-detail parameter. This floating-point value +limits the selection of highest resolution mipmap (lowest mipmap +level). The initial value is -1000. +.P +.TP 10 +_const(TEXTURE_MAX_LOD) +Sets the maximum level-of-detail parameter. This floating-point value +limits the selection of the lowest resolution mipmap (highest mipmap +level). The initial value is 1000. +.P +.TP 10 +_const(TEXTURE_BASE_LEVEL) +Specifies the index of the lowest defined mipmap level. This is an +integer value. The initial value is 0. +.P +.TP 10 +_const(TEXTURE_MAX_LEVEL) +Sets the index of the highest defined mipmap level. This is an integer +value. The initial value is 1000. +.P +.TP 10 +_const(TEXTURE_WRAP_S) +Sets the wrap parameter for texture coordinate $s$ to either +_const(CLAMP), _const(CLAMP_TO_EDGE), or _const(REPEAT). +_const(CLAMP) causes $s$ coordinates to be clamped to the range [0,1] +and is useful for preventing wrapping artifacts when mapping +a single image onto an object. +_const(CLAMP_TO_EDGE) causes $s$ coordinates to be clamped to the range +$left [ {1 over 2N}, 1 - {1 over 2N} right ]$, where $N$ is the size +of the texture in the direction of clamping. +_const(REPEAT) causes the integer part of the $s$ coordinate to be ignored; +the GL uses only the fractional part, +thereby creating a repeating pattern. +Border texture elements are accessed only if wrapping is set to _const(CLAMP). +Initially, _const(TEXTURE_WRAP_S) is set to _const(REPEAT). +.P +.TP 10 +_const(TEXTURE_WRAP_T) +Sets the wrap parameter for texture coordinate $t$ to either +_const(CLAMP), _const(CLAMP_TO_EDGE), or _const(REPEAT). +See the discussion under _const(TEXTURE_WRAP_S). +Initially, _const(TEXTURE_WRAP_T) is set to _const(REPEAT). +.TP 10 +_const(TEXTURE_WRAP_R) +Sets the wrap parameter for texture coordinate $r$ to either +_const(CLAMP), _const(CLAMP_TO_EDGE), or _const(REPEAT). +See the discussion under _const(TEXTURE_WRAP_S). +Initially, _const(TEXTURE_WRAP_R) is set to _const(REPEAT). +.TP +_const(TEXTURE_BORDER_COLOR) +Sets a border color. +_param3 contains four values that comprise the RGBA color +of the texture border. +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. +Initially, the border color is (0, 0, 0, 0). +.TP 10 +_const(TEXTURE_PRIORITY) +Specifies the texture residence priority of the currently bound texture. +Permissible values are in the range [0,\ 1]. +See _cmnd(PrioritizeTextures) and _cmnd(BindTexture) for more information. +.SH NOTES +_const(TEXTURE_3D), _const(TEXTURE_MIN_LOD), _const(TEXTURE_MAX_LOD), +_const(TEXTURE_BASE_LEVEL), and _const(TEXTURE_MAX_LEVEL) are only +available if the GL version is 1.2 or greater. +.P +Suppose that a program has enabled texturing +(by calling _cmnd(Enable) +with argument _const(TEXTURE_1D), _const(TEXTURE_2D), or _const(TEXTURE_3D)) +and has set _const(TEXTURE_MIN_FILTER) to one of the functions +that requires a mipmap. +If either the dimensions of the texture images currently defined +(with previous calls to _cmnd(TexImage1D), _cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(CopyTexImage1D), or _cmnd(CopyTexImage2D)) +do not follow the proper sequence for mipmaps +(described above), +or there are fewer texture images defined than are needed, +or the set of texture images have differing numbers of texture components, +then it is as if texture mapping were disabled. +.P +Linear filtering accesses the four nearest texture elements only in 2D +textures. +In 1D textures, linear filtering accesses the two nearest texture +elements. +.P +When the _arbstring(multitexture) extension is supported, _cmnd +specifies the texture parameters for the active texture unit, specified +by calling _cmnd(ActiveTextureARB). +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 or _param2 is not +one of the accepted defined values. +.P +_const(INVALID_ENUM) is generated if _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(GetTexParameter) +.br +_cmnd(GetTexLevelParameter) +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(BindTexture), +_cmnd(CopyPixels), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(PrioritizeTextures), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D) + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texsubimage1d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texsubimage1d.gl new file mode 100644 index 000000000..834f2a33b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texsubimage1d.gl @@ -0,0 +1,212 @@ +_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(TexSubImage1D,specify a one-dimensional texture subimage) +_names(TexSubImage1D) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. +Must be _const(TEXTURE_1D). +_phead(_param2) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(_param3) +Specifies a texel offset in the x direction within the texture array. +_phead(_param4) +Specifies the width of the texture subimage. +_phead(_param5) +Specifies the format of the pixel data. +The following symbolic values are accepted: +_const(COLOR_INDEX), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(_param6) +Specifies the data type of the pixel data. +The following symbolic values are accepted: +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(_param7) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +Texturing maps a portion of a specified texture image +onto each graphical primitive for which texturing is enabled. +To enable or disable one-dimensional texturing, call _cmnd(Enable) +and _cmnd(Disable) with argument _const(TEXTURE_1D). +.P +_cmnd redefines a contiguous subregion of an existing one-dimensional +texture image. +The texels referenced by _param7 replace the portion of the +existing texture array with x indices _param3 and +$_eqnparam3~+~_eqnparam4~-~1$,inclusive. +This region may not include any texels outside the range of the +texture array as it was originally specified. +It is not an error to specify a subtexture with width of 0, but +such a specification has no effect. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +Texturing has no effect in color index mode. +.P +_cmnd(PixelStore) and _cmnd(PixelTransfer) modes affect texture images +in exactly the way they affect _cmnd(DrawPixels). +.P +Formats _const(BGR), and _const(BGRA) and types +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) are available only if the GL version +is 1.2 or greater. +.P +When the _arbstring(multitexture) extension is supported, _cmnd +specifies a one-dimensional sub texture for the current texture unit, +specified with _cmnd(ActiveTextureARB). +.P +When the _arbstring(imaging) extension is supported, the RGBA components +specified in _param7 may be processed by the imaging pipeline. See +_cmnd(TexImage1D) for specific details. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not one of the +allowable values. +.P +_const(INVALID_OPERATION) is generated if the texture array has not +been defined by a previous _cmnd(TexImage1D) operation. +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater +than $log sub 2$\f2max\fP, +where \f2max\fP is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if $_eqnparam3 ~<~ ~-b$, +or if $(_eqnparam3~+~_eqnparam4) ~>~ (w ~-~ b)$, +where $w$ is the _const(TEXTURE_WIDTH), and $b$ is +the width of the _const(TEXTURE_BORDER) +of the texture image being modified. +Note that $w$ includes twice the border width. +.P +_const(INVALID_VALUE) is generated if _param4 is less than 0. +.P +_const(INVALID_ENUM) is generated if _param5 is not an accepted +format constant. +.P +_const(INVALID_ENUM) is generated if _param6 is not a type constant. +.P +_const(INVALID_ENUM) is generated if _param6 is _const(BITMAP) and +_param5 is not _const(COLOR_INDEX). +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param6 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param5 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param6 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_1D) +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexParameter), +_cmnd(TexSubImage2D), +_cmnd(TexSubImage3D) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texsubimage2d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texsubimage2d.gl new file mode 100644 index 000000000..b014f1f91 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texsubimage2d.gl @@ -0,0 +1,217 @@ +_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(TexSubImage2D,specify a two-dimensional texture subimage) +_names(TexSubImage2D) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. +Must be _const(TEXTURE_2D). +_phead(_param2) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(_param3) +Specifies a texel offset in the x direction within the texture array. +_phead(_param4) +Specifies a texel offset in the y direction within the texture array. +_phead(_param5) +Specifies the width of the texture subimage. +_phead(_param6) +Specifies the height of the texture subimage. +_phead(_param7) +Specifies the format of the pixel data. +The following symbolic values are accepted: +_const(COLOR_INDEX), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(_param8) +Specifies the data type of the pixel data. +The following symbolic values are accepted: +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(_param9) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +Texturing maps a portion of a specified texture image +onto each graphical primitive for which texturing is enabled. +To enable and disable two-dimensional texturing, call _cmnd(Enable) +and _cmnd(Disable) with argument _const(TEXTURE_2D). +.P +_cmnd redefines a contiguous subregion of an existing two-dimensional +texture image. +The texels referenced by _param9 replace the portion of the +existing texture array with x indices _param3 and $_eqnparam3~+~_eqnparam5~-~1$, +inclusive, +and y indices _param4 and $_eqnparam4~+~_eqnparam6~-~1$, inclusive. +This region may not include any texels outside the range of the +texture array as it was originally specified. +It is not an error to specify a subtexture with zero width or height, but +such a specification has no effect. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +Texturing has no effect in color index mode. +.P +_cmnd(PixelStore) and _cmnd(PixelTransfer) modes affect texture images +in exactly the way they affect _cmnd(DrawPixels). +.P +Formats _const(BGR), and _const(BGRA) and types +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) are available only if the GL version +is 1.2 or greater. +.P +When the _arbstring(multitexture) extension is supported, _cmnd +specifies a two-dimensional sub texture for the current texture unit, +specified with _cmnd(ActiveTextureARB). +.P +When the _arbstring(imaging) extension is supported, the RGBA components +specified in _param9 may be processed by the imaging pipeline. See +_cmnd(TexImage1D) for specific details. +.SH ERRORS +_const(INVALID_ENUM) is generated if _param1 is not _const(TEXTURE_2D). +.P +_const(INVALID_OPERATION) is generated if the texture array has not +been defined by a previous _cmnd(TexImage2D) operation. +.P +_const(INVALID_VALUE) is generated if _param2 is less than 0. +.P +_const(INVALID_VALUE) may be generated if _param2 is greater +than $log sub 2$\f2max\fP, +where \f2max\fP is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if $_eqnparam3 ~<~ ~-b$, +$(_eqnparam3~+~_eqnparam5) ~>~ (w~-~b)$, +$_eqnparam4 ~<~ ~-b$, or $(_eqnparam4 ~+~ _eqnparam6) ~>~ (h~-~b)$, +where $w$ is the _const(TEXTURE_WIDTH), +$h$ is the _const(TEXTURE_HEIGHT), and $b$ is the border width +of the texture image being modified. +Note that $w$ and $h$ include twice the border width. +.P +_const(INVALID_VALUE) is generated if _param5 or _param6 is less than 0. +.P +_const(INVALID_ENUM) is generated if _param7 is not an accepted +format constant. +.P +_const(INVALID_ENUM) is generated if _param8 is not a type constant. +.P +_const(INVALID_ENUM) is generated if _param8 is _const(BITMAP) and +_param7 is not _const(COLOR_INDEX). +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if _param8 is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and _param7 is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if _param8 is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and _param7 is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_2D) +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage3D), +_cmnd(TexParameter) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texsubimage3d.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texsubimage3d.gl new file mode 100644 index 000000000..be4d509fd --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/texsubimage3d.gl @@ -0,0 +1,241 @@ +_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(TexSubImage3D,specify a three-dimensional texture subimage) +_names(TexSubImage3D) +.EQ +delim $$ +.EN +_define(@<__target>@,@<_param1>@)_C_ +_define(@<__level>@,@<_param2>@)_C_ +_define(@<__xoffset>@,@<_param3>@)_C_ +_define(@<__eqnxoffset>@,@<_eqnparam3>@)_C_ +_define(@<__yoffset>@,@<_param4>@)_C_ +_define(@<__eqnyoffset>@,@<_eqnparam4>@)_C_ +_define(@<__zoffset>@,@<_param5>@)_C_ +_define(@<__eqnzoffset>@,@<_eqnparam5>@)_C_ +_define(@<__width>@,@<_param6>@)_C_ +_define(@<__eqnwidth>@,@<_eqnparam6>@)_C_ +_define(@<__height>@,@<_param7>@)_C_ +_define(@<__eqnheight>@,@<_eqnparam7>@)_C_ +_define(@<__depth>@,@<_param8>@)_C_ +_define(@<__eqndepth>@,@<_eqnparam8>@)_C_ +_define(@<__format>@,@<_param9>@)_C_ +_define(@<__type>@,@<_param10>@)_C_ +_define(@<__pixels>@,@<_param11>@)_C_ +.SH PARAMETERS +_phead(__target) +Specifies the target texture. +Must be _const(TEXTURE_3D). +_phead(__level) +Specifies the level-of-detail number. +Level 0 is the base image level. +Level \f2n\fP is the \f2n\fPth mipmap reduction image. +_phead(__xoffset) +Specifies a texel offset in the x direction within the texture array. +_phead(__yoffset) +Specifies a texel offset in the y direction within the texture array. +_phead(__zoffset) +Specifies a texel offset in the z direction within the texture array. +_phead(__width) +Specifies the width of the texture subimage. +_phead(__height) +Specifies the height of the texture subimage. +_phead(__depth) +Specifies the depth of the texture subimage. +_phead(__format) +Specifies the format of the pixel data. +The following symbolic values are accepted: +_const(COLOR_INDEX), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(BGR), +_const(RGBA), +_const(BGRA), +_C_ _const(ABGR_EXT), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(__type) +Specifies the data type of the pixel data. +The following symbolic values are accepted: +_const(UNSIGNED_BYTE), +_const(BYTE), +_const(BITMAP), +_const(UNSIGNED_SHORT), +_const(SHORT), +_const(UNSIGNED_INT), +_const(INT), +_const(FLOAT), +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(__pixels) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +Texturing maps a portion of a specified texture image +onto each graphical primitive for which texturing is enabled. +To enable and disable three-dimensional texturing, call _cmnd(Enable) +and _cmnd(Disable) with argument _const(TEXTURE_3D). +.P +_cmnd redefines a contiguous subregion of an existing three-dimensional +texture image. +The texels referenced by __pixels replace the portion of the +existing texture array with x indices __xoffset and +$__eqnxoffset ~+~ __eqnwidth ~-~ 1$, inclusive, +y indices __yoffset and $__eqnyoffset ~+~ __eqnheight ~-~ 1$, inclusive, +and z indices __zoffset and $__eqnzoffset ~+~ __eqndepth ~-~ 1$, inclusive. +This region may not include any texels outside the range of the +texture array as it was originally specified. +It is not an error to specify a subtexture with zero width, height, or +depth but such a specification has no effect. +.SH NOTES +_cmnd is available only if the GL version is 1.2 or greater. +.P +Texturing has no effect in color index mode. +.P +_cmnd(PixelStore) and _cmnd(PixelTransfer) modes affect texture images +in exactly the way they affect _cmnd(DrawPixels). +.P +Formats _const(BGR), and _const(BGRA) and types +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), +_const(UNSIGNED_SHORT_5_6_5_REV), +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), and +_const(UNSIGNED_INT_2_10_10_10_REV) are available only if the GL version +is 1.2 or greater. +.P +When the _arbstring(multitexture) extension is supported, _cmnd +specifies a three-dimensional sub texture for the current texture unit, +specified with _cmnd(ActiveTextureARB). +.P +When the _arbstring(imaging) extension is supported, the RGBA components +specified in __pixels may be processed by the imaging pipeline. See +_cmnd(TexImage3D) for specific details. +.SH ERRORS +_const(INVALID_ENUM) is generated if __target is not _const(TEXTURE_3D). +.P +_const(INVALID_OPERATION) is generated if the texture array has not +been defined by a previous _cmnd(TexImage3D) operation. +.P +_const(INVALID_VALUE) is generated if __level is less than 0. +.P +_const(INVALID_VALUE) may be generated if __level is greater +than $log sub 2$\f2max\fP, +where \f2max\fP is the returned value of _const(MAX_TEXTURE_SIZE). +.P +_const(INVALID_VALUE) is generated if $__eqnxoffset ~<~ ~-b$, +$(__eqnxoffset ~+~ __eqnwidth) ~>~ (w~-~b)$, +$__eqnyoffset ~<~ ~-b$, or $(__eqnyoffset ~+~ __eqnheight) ~>~ (h~-~b)$, +or $__eqnzoffset ~<~ ~-b$, or $(__eqnzoffset ~+~ __eqndepth) ~>~ (d~-~b)$, +where $w$ is the _const(TEXTURE_WIDTH), +$h$ is the _const(TEXTURE_HEIGHT), $d$ is the _const(TEXTURE_DEPTH) +and $b$ is the border width of the texture image being modified. +Note that $w$, $h$, and $d$ include twice the border width. +.P +_const(INVALID_VALUE) is generated if __width, __height, or __depth +is less than 0. +.P +_const(INVALID_ENUM) is generated if __format is not an accepted +format constant. +.P +_const(INVALID_ENUM) is generated if __type is not a type constant. +.P +_const(INVALID_ENUM) is generated if __type is _const(BITMAP) and +__format is not _const(COLOR_INDEX). +.P +_const(INVALID_OPERATION) is generated if _cmnd is executed +between the execution of _cmnd(Begin) and the corresponding +execution of _cmnd(End). +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_BYTE_3_3_2), +_const(UNSIGNED_BYTE_2_3_3_REV), +_const(UNSIGNED_SHORT_5_6_5), or +_const(UNSIGNED_SHORT_5_6_5_REV) +and __format is not _const(RGB). +.P +_const(INVALID_OPERATION) is generated if __type is one of +_const(UNSIGNED_SHORT_4_4_4_4), +_const(UNSIGNED_SHORT_4_4_4_4_REV), +_const(UNSIGNED_SHORT_5_5_5_1), +_const(UNSIGNED_SHORT_1_5_5_5_REV), +_const(UNSIGNED_INT_8_8_8_8), +_const(UNSIGNED_INT_8_8_8_8_REV), +_const(UNSIGNED_INT_10_10_10_2), or +_const(UNSIGNED_INT_2_10_10_10_REV) +and __format is neither _const(RGBA) nor _const(BGRA). +.SH ASSOCIATED GETS +_cmnd(GetTexImage) +.br +_cmnd(IsEnabled) with argument _const(TEXTURE_3D) +.SH SEE ALSO +_cmnd(ActiveTextureARB), +_cmnd(CopyTexImage1D), +_cmnd(CopyTexImage2D), +_cmnd(CopyTexSubImage1D), +_cmnd(CopyTexSubImage2D), +_cmnd(CopyTexSubImage3D), +_cmnd(DrawPixels), +_cmnd(PixelStore), +_cmnd(PixelTransfer), +_cmnd(TexEnv), +_cmnd(TexGen), +_cmnd(TexImage1D), +_cmnd(TexImage2D), +_cmnd(TexImage3D), +_cmnd(TexSubImage1D), +_cmnd(TexSubImage2D), +_cmnd(TexParameter) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/translate.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/translate.gl new file mode 100644 index 000000000..4b42d45a4 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/translate.gl @@ -0,0 +1,94 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Translate,multiply the current matrix by a translation matrix) +_names(Translate,[df]) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2 _param3) +Specify the \f2x\fP, \f2y\fP, and \f2z\fP coordinates of a translation vector. +.SH DESCRIPTION +_cmnd produces a translation by +$(_eqnparam1,_eqnparam2,_eqnparam3)$. +The current matrix +(see +.br +_cmnd(MatrixMode)) +is multiplied by this translation matrix, +with the product replacing the current matrix, as if +_cmnd(MultMatrix) were called with the following matrix +for its argument: +.sp +.ce +.EQ +left ( ~ down 20 matrix { + ccol { 1~~ above 0~~ above 0~~ above 0~~ } + ccol { 0~~ above 1~~ above 0~~ above 0~~ } + ccol { 0~~ above 0~~ above 1~~ above 0~~ } + ccol { _eqnparam1~ above _eqnparam2~ above _eqnparam3~ above 1} +} ~~right ) +.EN +.sp +.RE +If the matrix mode is either _const(MODELVIEW) or _const(PROJECTION), +all objects drawn after a call to _cmnd are translated. +.P +Use _cmnd(PushMatrix) and +_cmnd(PopMatrix) to save and restore +the untranslated coordinate system. +.SH ERRORS +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.bp +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(MATRIX_MODE) +.br +_cmnd(Get) with argument _const(COLOR_MATRIX) +.br +_cmnd(Get) with argument _const(MODELVIEW_MATRIX) +.br +_cmnd(Get) with argument _const(PROJECTION_MATRIX) +.br +_cmnd(Get) with argument _const(TEXTURE_MATRIX) +.SH SEE ALSO +_cmnd(MatrixMode), +_cmnd(MultMatrix), +_cmnd(PushMatrix), +_cmnd(Rotate), +_cmnd(Scale) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/vertex.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/vertex.gl new file mode 100644 index 000000000..a9ab1642f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/vertex.gl @@ -0,0 +1,76 @@ +_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(Vertex,specify a vertex) +_names(Vertex,[234]u*[sifdb]) +.SH PARAMETERS +_phead(_param1 _param2 _param3 _param4) +Specify \f2x\fP, \f2y\fP, \f2z\fP, and \f2w\fP coordinates of a vertex. +Not all parameters are present in all forms of the command. +_names(Vertex,[234]u*[sifdb]v) +.SH PARAMETERS +_phead(_param1) +Specifies a pointer to an array of two, three, or four elements. +The elements of a two-element array are \f2x\fP and \f2y\fP; +of a three-element array, \f2x\fP, \f2y\fP, and \f2z\fP; +and of a four-element array, \f2x\fP, \f2y\fP, \f2z\fP, and \f2w\fP. +.SH DESCRIPTION +_cmnd commands are used within _cmnd(Begin)/_cmnd(End) pairs to specify +point, line, and polygon vertices. +The current color, +normal, +and texture coordinates are associated with the vertex when _cmnd is called. +.P +When only \f2x\fP and \f2y\fP are specified, +\f2z\fP defaults to 0 and \f2w\fP defaults to 1. +When \f2x, y,\fP and \f2z\fP are specified, +\f2w\fP defaults to 1. +.SH NOTES +Invoking _cmnd outside of a _cmnd(Begin)/_cmnd(End) pair +results in undefined behavior. +.SH SEE ALSO +_cmnd(Begin), +_cmnd(CallList), +_cmnd(Color), +_cmnd(EdgeFlag), +_cmnd(EvalCoord), +_cmnd(Index), +_cmnd(Material), +.br +_cmnd(Normal), +_cmnd(Rect), +_cmnd(TexCoord), +_cmnd(VertexPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/vertexpointer.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/vertexpointer.gl new file mode 100644 index 000000000..b03af49de --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/vertexpointer.gl @@ -0,0 +1,143 @@ +_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 +_C_ A real line follows. +_define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ Use GL not OpenGL +_C_ Don't change the ordering of the main headers. +_C_ C specification (or fortran) is handled automatically +_C_ .TH is automatically added to the top of this file. +_C_ Below, use current tense, active do not capitalize the first word and dont +_C_ use a period. +_C_ the function name must appear in (APIFILE) (usually gl.h) as set in +_C_ Makefile. +_header(VertexPointer,define an array of vertex data) +_names(VertexPointer) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the number of coordinates per vertex; must be 2, 3, or +4. The initial value is 4. +_phead(_param2) +Specifies the data type of each coordinate in the array. +Symbolic constants +_const(SHORT), +_const(INT), +_const(FLOAT), +and _const(DOUBLE) +are accepted. The initial value is _const(FLOAT). +_phead(_param3) +Specifies the byte offset between consecutive +vertices. If _param3 is 0, the vertices are understood to be tightly packed in +the array. The initial value +is 0. +_phead(_param4) +Specifies a pointer to the first coordinate of the first vertex in the +array. The initial value is 0. +.SH DESCRIPTION +_cmnd specifies the location and data format of an array of vertex coordinates +to use when rendering. +_param1 specifies the number of coordinates per vertex and +_param2 the data type of +the coordinates. _param3 specifies the byte stride from one +vertex to the next allowing vertices and attributes +to be packed into a single array or stored in separate arrays. +(Single-array storage may be more efficient on some implementations; +see _cmnd(InterleavedArrays).) +When a vertex array is +specified, _param1, _param2, _param3, and _param4 are saved as client-side +state. +.P +To enable and disable the vertex array, call _cmnd(EnableClientState) and +.br +_cmnd(DisableClientState) with the argument _const(VERTEX_ARRAY). If +enabled, the vertex array is used when +_cmnd(DrawArrays), _cmnd(DrawElements), or _cmnd(ArrayElement) is called. +.P +Use _cmnd(DrawArrays) to construct a sequence of primitives (all of +the same type) +from prespecified vertex and vertex attribute arrays. +Use _cmnd(ArrayElement) to specify primitives +by indexing vertices and vertex attributes and _cmnd(DrawElements) to +construct a sequence of primitives by indexing vertices and vertex attributes. +.SH NOTES +_cmnd is available only if the GL version is 1.1 or greater. +.P +The vertex array is initially disabled and isn't accessed when +_cmnd(ArrayElement), _cmnd(DrawElements) or _cmnd(DrawArrays) is called. +.P +Execution of _cmnd is not allowed between the execution of +_cmnd(Begin) and the corresponding execution of _cmnd(End), +but an error may or may not be generated. If no error is generated, +the operation is undefined. +.P +_cmnd is typically implemented on the client side. +.P +Vertex array parameters are client-side state and are therefore not +saved or restored by _cmnd(PushAttrib) and _cmnd(PopAttrib). +Use _cmnd(PushClientAttrib) and _cmnd(PopClientAttrib) instead. +.SH ERRORS +_const(INVALID_VALUE) is generated if _param1 is not 2, 3, or 4. +.P +_const(INVALID_ENUM) is generated if _param2 is is not an accepted value. +.P +_const(INVALID_VALUE) is generated if _param3 is negative. +.SH ASSOCIATED GETS +_cmnd(IsEnabled) with argument _const(VERTEX_ARRAY) +.br +_cmnd(Get) with argument _const(VERTEX_ARRAY_SIZE) +.br +_cmnd(Get) with argument _const(VERTEX_ARRAY_TYPE) +.br +_cmnd(Get) with argument _const(VERTEX_ARRAY_STRIDE) +.br +_cmnd(GetPointerv) with argument _const(VERTEX_ARRAY_POINTER) +.SH SEE ALSO +_cmnd(ArrayElement), +_cmnd(ColorPointer), +_cmnd(DrawArrays), +_cmnd(DrawElements), +_cmnd(DrawRangeElements), +_cmnd(EdgeFlagPointer), +_cmnd(Enable), +_cmnd(GetPointerv), +_cmnd(IndexPointer), +_cmnd(InterleavedArrays), +_cmnd(NormalPointer), +_cmnd(PopClientAttrib), +_cmnd(PushClientAttrib), +_cmnd(TexCoordPointer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/viewport.gl b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/viewport.gl new file mode 100644 index 000000000..b923cb8e7 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/standard/viewport.gl @@ -0,0 +1,84 @@ +_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,eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_header(Viewport,set the viewport) +_names(Viewport) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2) +Specify the lower left corner of the viewport rectangle, +in pixels. The initial value is (0,0). +_phead(_param3 _param4) +Specify the width and height +of the viewport. +When a GL context is first attached to a window, +_param3 and _param4 are set to the dimensions of that window. +.SH DESCRIPTION +_cmnd specifies the affine transformation of $x$ and $y$ from +normalized device coordinates to window coordinates. +Let ($x sub nd$, $y sub nd$) be normalized device coordinates. +Then the window coordinates ($x sub w$, $y sub w$) are computed as follows: +.sp +.ce +.EQ +x sub w ~=~ ( x sub nd ~+~ 1 ) left ( _eqnparam3 over 2 right ) ~+~ _eqnparam1 +.EN +.sp +.ce +.EQ +y sub w ~=~ ( y sub nd ~+~ 1 ) left ( _eqnparam4 over 2 right ) ~+~ _eqnparam2 +.EN +.RE +.P +Viewport width and height are silently clamped +to a range that depends on the implementation. +To query this range, call _cmnd(Get) with argument +_const(MAX_VIEWPORT_DIMS). +.SH ERRORS +_const(INVALID_VALUE) is generated if either _param3 or _param4 is negative. +.P +_const(INVALID_OPERATION) is generated if _cmnd +is executed between the execution of _cmnd(Begin) +and the corresponding execution of _cmnd(End). +.bp +.SH ASSOCIATED GETS +_cmnd(Get) with argument _const(VIEWPORT) +.br +_cmnd(Get) with argument _const(MAX_VIEWPORT_DIMS) +.SH SEE ALSO +_cmnd(DepthRange) |