diff options
Diffstat (limited to 'nx-X11/extras/ogl-sample/main/doc/man')
272 files changed, 39455 insertions, 0 deletions
diff --git a/nx-X11/extras/ogl-sample/main/doc/man/macros/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/macros/GNUmakefile new file mode 100644 index 000000000..231d951e0 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/macros/GNUmakefile @@ -0,0 +1,48 @@ +#!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. +# +# $Date: 2004/03/14 08:29:07 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/macros/GNUmakefile,v 1.1.1.4 2004/03/14 08:29:07 eich Exp $ + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +default headers headers_install libs libs_install install apps: + +distsi distoss: + $(MAKE) $(COMMONPREF)$@ + +$(COMMONTARGS): % : $(COMMONPREF)% + +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/macros/mkhead.awk b/nx-X11/extras/ogl-sample/main/doc/man/macros/mkhead.awk new file mode 100644 index 000000000..07f6ce39b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/macros/mkhead.awk @@ -0,0 +1,290 @@ +# basename is set on the command line +# The regexp below is replaced by an expression to do case insensitive +# searching on the name of a GL function before running this program. +# +# Runs on 'gl.h' ('glu.h', 'glx.h') and locates the lines for the specified +# GL (glu, glx) function, then generates M4 definitions for man page +# +BEGIN { + found = 0 + numargs = 0 + newargs[0] = "" + stderr = "cat 1>&2" + vee = 0 + getnames(basename) + + for (j=0; j<numNames; j++) + { + rexpNames[j] = names[j] regExps[j] + head[j] = "" + numFound[j] = 0 + nargs[0] = 0 + } +} + +/extern/ { + cmdfield = 0; + # search for the command string + for (i = 3; i <= NF; i++) + { + name = $i; + if (index(name,"gl") == 1) + { + cmdfield = i; + # strip the gl, glu, or glX prefix + # note that the X of glX is not stripped! + if (index(name,"glu") == 1) + name = substr(name,4); + else + name = substr(name,3); + truename = name; + break; + } + } + if (cmdfield != 0) { + for (i=0; i<numNames; i++) + { + if (name ~ rexpNames[i]) + { # Found one - $cmdfield is the name, $2 through $(cmdfield-1) is + # the return type. The rest is the argument list. + match(name,names[i]) + if ((RLENGTH != length(names[i])) || (match(name,rexpNames[i]) != 1)) + continue + if (RLENGTH != length(name)) + continue + cname = name + names[i,numFound[i]] = truename + p = index($0,"(") + addargs(substr($0,p,length($0)-p-1),i) # Strips trailing semicolon + typestr = $2 + for (j = 3; j < cmdfield; j++) + { + typestr = typestr " " $j + } + head[i] = head[i] makeHead(truename,typestr,i) + numFound[i]++ + found++ + } + } + } +} + +END { + if (found == 0) { + if (basename == "xintro") { + numNames = 1; + numFound[0] = 1; + names[0,0] = "XIntro"; + } + else if (basename == "intro") { + numNames = 1; + numFound[0] = 1; + names[0,0] = "Intro"; + } + else { + printf "No GL call found that matches '%s'.\n", basename | stderr + printf "Edit macros/mkhead.awk to add a special name.\n" | stderr + } + } + printf "_define(_samething,@<.PP\n" + printf "The above subroutines are functionally equivalent;\n" + printf "they differ only in the specification of their parameters.\n" + printf ">@)dnl\n" + + printf "_define(_header,@<dnl\n" + printf "_setup()dnl\n" + printf "_define(_cname,$1)dnl\n" + printf ".TH %s$1 3G\n", prefix + printf ".SH NAME\n" + printf ".B \"" + for (i=0; i<numNames; i++) + for (j=0; j<numFound[i]; j++) + if ((i == (numNames-1)) && (j == (numFound[i]-1))) + printf "%s%s\n", prefix, names[i,j] + else + printf "%s%s, ", prefix, names[i,j] + printf "\\- $2\n" + printf ">@)dnl\n" + + printf "_define(_names,@<dnl\n" + printf "_ifelse($3,@<>@,.SH C SPECIFICATION\n)" + printf "_ifelse(" + for (i=0; i<numNames; i++) + { + printf "_namenum,@<%d>@,@<%s>@,dnl\n",i,head[i] + } + printf "ERROR)dnl\n" + printf "_define(@<_namenum>@,_incr(_namenum))>@)dnl\n" + +# if (found > 1) +# { +# printf "_samething()\n" +# } + maxArgs = 0 + for (i=0; i<numNames; i++) + if (maxArgs < nargs[i]) + maxArgs = nargs[i] + long = "" + for (j=1; j<=maxArgs; j++) + { + printf "_define(_param%d,@<",j + printf "_define(@<_tmpnum>@,_ifelse($#,0,_namenum,$1))dnl\n" + printf "_ifelse(" + for (i=0; i<numNames; i++) + { + printf "_tmpnum,@<%d>@,\\f2%s\\fP,dnl\n",i+1,args[j,i] + if (length(args[j,i]) > length(long)) + long = args[j,i] + } + printf "???)>@)dnl\n" + } +# next loop same as above, except does not italicize +# resulting definitions can be used in equations + for (j=1; j<=maxArgs; j++) + { + printf "_define(_eqnparam%d,@<",j + printf "_define(@<_tmpnum>@,_ifelse($#,0,_namenum,$1))dnl\n" + printf "_ifelse(" + for (i=0; i<numNames; i++) + { + printf "_tmpnum,@<%d>@,\"%s\",dnl\n",i+1,args[j,i] + if (length(args[j,i]) > length(long)) + long = args[j,i] + } + printf "???)>@)dnl\n" + } +# The following stuff is designed to find the longest argument so that +# the '.TP' indentation can be set in the first instaciation of _phead +# (thus the use of the '_first' macro as a flag). Things are complicated +# by the possibility of multiple arguments in the call to _phead. +# This is what _makelist is for: to turn a space separted multiple +# argument list into a comma separated one (commas can't be used in +# the original list because they have special meaning to m4). +# Unfortunately, this means that (currently) if the longest string is +# a multiple argument, the indentation will only be right if it occurs +# in the first _phead. This is because only the API file is scanned +# for arguments, and not the man page file, so this script can't know +# which instance of phead has the longest (multiple) argument. + + long = "\\fI" long "\\fP" + printf "_define(_phead,@<dnl\n" + printf "_ifdef(@<_first>@,@<.TP>@,@<.TP \\w'" + printf "_ifelse(_eval(_len(%s)>_len(_makelist($1))),1,",long + printf "%s,translit(_makelist($1),@<+>@,@<\\>@))\\ \\ 'u dnl\n", long + printf "_define(_first,first)>@)\n" + printf "translit(_makelist($1),@<+>@,@<,>@)>@)dnl\n" + printf "_define(_cmnd,@<\\%%_ifelse($1,@<>@,\\f3" prefix "@<>@_cname\\fP,dnl\n" + printf "\\f3" prefix "$1\\fP)>@)dnl\n" + printf "_define(_glcmnd,@<_ifelse($1,@<>@,\\f3gl@<>@_cname\\fP,dnl\n" + printf "\\f3gl$1\\fP)>@)dnl\n" + printf "_define(_glucmnd,@<_ifelse($1,@<>@,\\f3glu@<>@_cname\\fP,dnl\n" + printf "\\f3glu$1\\fP)>@)dnl\n" + printf "_define(_xcmnd,@<_ifelse($1,@<>@,\\f3X@<>@_cname\\fP,dnl\n" + printf "\\f3X$1\\fP)>@)dnl\n" +# printf "syscmd(@<${maCdIr}/mkname.awk>@ ${maCdIr}/pglspec >_tmpnam)dnl\n" +# printf "_include(_tmpnam)syscmd(rm -f _tmpnam)>@))dnl\n" +} + + + +# +# function to make the troff to typeset the function header +# +function makeHead(fname,type,i) +{ + fname = prefix fname + headString = sprintf("%s \\f3%s\\fP(",type,fname) + if (numargs > 0) + { + headString = headString "\n" + if (numargs > 1) + { + headString = headString sprintf("%s,\n",targs[1,i]) + headString = headString ".nf\n" + headString = headString sprintf(".ta \\w'\\f3%s \\fP%s( 'u\n",type,fname) + for (j=2; j<=numargs-1; j++) + headString = headString sprintf("\t%s,\n",targs[j,i]) + headString = headString sprintf("\t%s )\n",targs[numargs,i]) + headString = headString ".fi\n" + } + else + headString = headString sprintf("%s )\n.nf\n.fi\n",targs[numargs,i]) + } + else + headString = headString " void )\n.nf\n.fi\n" + return headString +} + +# Generates 'args' of untyped argument names +# Also generates 'targs' of typed argument names and 'nargs', the number +# of arguments. + +function addargs(arglist,i) +{ +# +# First strip leading '(' and trailing ')' +# + if (substr(arglist,1,1) == "(") + arglist = substr(arglist,2,length(arglist)) + while (substr(arglist,1,1) == " ") + arglist = substr(arglist,2,length(arglist)) + + if (substr(arglist,length(arglist),1) == ")") + arglist = substr(arglist,1,length(arglist)-1) + while (substr(arglist,length(arglist),1) == " ") + arglist = substr(arglist,1,length(arglist)-1) + + numargs = split(arglist,newargs, ",[ \t]") + if (newargs[1] == "void") + { + numargs = 0; + targs[1,i] = newargs[1]; + args[1,i] = newargs[1]; + } + if (nargs[i] < numargs) + nargs[i] = numargs; + + for (j=1; j<=numargs; j++) + { +# targs[j,i] italicizes the argument but not the type + targs[j,i] = newargs[j] + numWords = split(targs[j,i],words,"[ \t]") + args[j,i] = words[numWords] + targs[j,i] = words[1] + for (k=2; k<=numWords-1; k++) + targs[j,i] = targs[j,i] " " words[k] + targs[j,i] = targs[j,i] " \\fI" words[numWords] "\\fP" + sub(/\[.*\]/,"",args[j,i]) + gsub("[*()]","",args[j,i]) + } +} + +# +# Parse and save away the _names(name,regexp) declarations in the file +# for later use in matching the entries in the API file. +# + +function getnames(file) +{ + numNames = 0 + fname = file ".gl" + while (getline < fname) + { + if (index($0,"_names(") != 0) + { + start = index($0,"_names(") + 7 + stuff = substr($0,start,length($0)-start) + split(stuff,things,",") + names[numNames] = things[1] + regExps[numNames] = things[2] + numNames++ + } + } + close(fname) + if (numNames == 0) + { + names[0] = file + regExps[0] = "[1-9]*u*[lbsifd]*v*" + numNames++ + } +} diff --git a/nx-X11/extras/ogl-sample/main/doc/man/macros/mkhead.ftn.awk b/nx-X11/extras/ogl-sample/main/doc/man/macros/mkhead.ftn.awk new file mode 100644 index 000000000..669a41d8f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/macros/mkhead.ftn.awk @@ -0,0 +1,339 @@ +# FORTRAN version +# +# Scans the source text for a manual page and locates "_names" macro +# invocations. Looks up the names in gl.h (or glu.h or glx.h) and generates +# definitions for the OpenGL m4 man page macros (_cmnd, _param1, etc.) +# Extracts machine dependencies for the names and stores them in a file +# for later inclusion in the man page. (See glman shell script.) +# +# basename, prefix, machdeps, and machdepsout are set on the command line. +# The regexp below is replaced by an expression to do case insensitive +# searching on the name of a GL function before running this program. +# +BEGIN { + FS = " |\t|\\(" + basename = substr(basename,2,length(basename)-1) # strip leading 'f' + prefix = "f" prefix + found = 0 + numargs = 0 + newargs[0] = "" + stderr = "cat 1>&2" + vee = 0 + getnames("f" basename) + + for (j=0; j<numNames; j++) + { + rexpNames[j] = names[j] regExps[j] + head[j] = "" + numFound[j] = 0 + nargs[0] = 0 + } +} + +/extern/ { + cmdfield = 0; + # search for the command string + for (i = 3; i <= NF; i++) + { + name = $i; + if (index(name,"gl") == 1) + { + cmdfield = i; + # strip the gl, glu, or glX prefix + if (index(name,"glu") == 1 || index(name,"glX") == 1) + name = substr(name,4); + else + name = substr(name,3); + truename = name; + break; + } + } + if (cmdfield != 0) { + for (i=0; i<numNames; i++) + { + if (name ~ rexpNames[i]) + { # Found one - $cmdfield is the name, $2 through $(cmdfield-1) is + # the return type. The rest is the argument list. + match(name,names[i]) + if ((RLENGTH != length(names[i])) || (match(name,rexpNames[i]) != 1)) + continue + if (RLENGTH != length(name)) + continue + cname = name + names[i,numFound[i]] = truename + p = index($0,"(") + addargs(substr($0,p,length($0)-p-1),i) # Strips trailing semicolon + typestr = $2 + for (j = 3; j < cmdfield; j++) + { + typestr = typestr " " $j + } + head[i] = head[i] makeHead(truename,typestr,i) + numFound[i]++ + found++ + } + } + } +} + +END { + if (found == 0) { + if (basename == "glxintro") { + numNames = 1; + numFound[0] = 1; + names[0,0] = "Intro"; + } + else if (basename == "intro") { + numNames = 1; + numFound[0] = 1; + names[0,0] = "Intro"; + } + else { + printf "No GL call found that matches '%s'.\n", basename | stderr + printf "Edit macros/mkhead.awk to add a special name.\n" | stderr + } + } + printf "_define(_samething,@<.PP\n" + printf "The above subroutines are functionally equivalent;\n" + printf "they differ only in the specification of their parameters.\n" + printf ">@)dnl\n" + + printf "_define(_header,@<dnl\n" + printf "_setup()dnl\n" + printf "_define(_cname,$1)dnl\n" + printf ".TH %s$1 \n", prefix + printf ".SH NAME\n" + printf ".B \"" + for (i=0; i<numNames; i++) + for (j=0; j<numFound[i]; j++) + if ((i == (numNames-1)) && (j == (numFound[i]-1))) + printf "%s%s\n", prefix, names[i,j] + else + printf "%s%s, ", prefix, names[i,j] + printf "\\- $2\n" + printf ">@)dnl\n" + + printf "_define(_names,@<dnl\n" + printf "_ifelse($3,@<>@,.SH FORTRAN SPECIFICATION\n)" + printf "_ifelse(" + for (i=0; i<numNames; i++) + { + printf "_namenum,@<%d>@,@<%s>@,dnl\n",i,head[i] + } + printf "ERROR)dnl\n" + printf "_define(@<_namenum>@,_incr(_namenum))>@)dnl\n" + +# Define the _machdeps macro to include the machine dependencies +# extracted earlier: + + printf "_define(@<_machdeps>@,@<_sinclude(@<%s>@)>@)dnl\n", machdepsout + +# if (found > 1) +# { +# printf "_samething()\n" +# } + maxArgs = 0 + for (i=0; i<numNames; i++) + if (maxArgs < nargs[i]) + maxArgs = nargs[i] + long = "" + for (j=1; j<=maxArgs; j++) + { + printf "_define(_param%d,@<",j + printf "_define(@<_tmpnum>@,_ifelse($#,0,_namenum,$1))dnl\n" + printf "_ifelse(" + for (i=0; i<numNames; i++) + { + printf "_tmpnum,@<%d>@,\\f2%s\\fP,dnl\n",i+1,args[j,i] + if (length(args[j,i]) > length(long)) + long = args[j,i] + } + printf "???)>@)dnl\n" + } +# next loop same as above, except does not italicize +# resulting definitions can be used in equations + for (j=1; j<=maxArgs; j++) + { + printf "_define(_eqnparam%d,@<",j + printf "_define(@<_tmpnum>@,_ifelse($#,0,_namenum,$1))dnl\n" + printf "_ifelse(" + for (i=0; i<numNames; i++) + { + printf "_tmpnum,@<%d>@,\"%s\",dnl\n",i+1,args[j,i] + if (length(args[j,i]) > length(long)) + long = args[j,i] + } + printf "???)>@)dnl\n" + } +# The following stuff is designed to find the longest argument so that +# the '.TP' indentation can be set in the first instaciation of _phead +# (thus the use of the '_first' macro as a flag). Things are complicated +# by the possibility of multiple arguments in the call to _phead. +# This is what _makelist is for: to turn a space separted multiple +# argument list into a comma separated one (commas can't be used in +# the original list because they have special meaning to m4). +# Unfortunately, this means that (currently) if the longest string is +# a multiple argument, the indentation will only be right if it occurs +# in the first _phead. This is because only the API file is scanned +# for arguments, and not the man page file, so this script can't know +# which instance of phead has the longest (multiple) argument. + + long = "\\fI" long "\\fP" + printf "_define(_phead,@<dnl\n" + printf "_ifdef(@<_first>@,@<.TP>@,@<.TP \\w'" + printf "_ifelse(_eval(_len(%s)>_len(_makelist($1))),1,",long + printf "%s,translit(_makelist($1),@<+>@,@<\\>@))\\ \\ 'u dnl\n", long + printf "_define(_first,first)>@)\n" + printf "translit(_makelist($1),@<+>@,@<,>@)>@)dnl\n" + printf "_define(_cmnd,@<_ifelse($1,@<>@,\\f3" prefix "@<>@_cname\\fP,dnl\n" + printf "\\f3" prefix "$1\\fP)>@)dnl\n" + printf "_define(_glcmnd,@<_ifelse($1,@<>@,\\f3gl@<>@_cname\\fP,dnl\n" + printf "\\f3gl$1\\fP)>@)dnl\n" + printf "_define(_glucmnd,@<_ifelse($1,@<>@,\\f3glu@<>@_cname\\fP,dnl\n" + printf "\\f3glu$1\\fP)>@)dnl\n" + printf "_define(_xcmnd,@<_ifelse($1,@<>@,\\f3X@<>@_cname\\fP,dnl\n" + printf "\\f3X$1\\fP)>@)dnl\n" +# printf "syscmd(@<${maCdIr}/mkname.awk>@ ${maCdIr}/pglspec >_tmpnam)dnl\n" +# printf "_include(_tmpnam)syscmd(rm -f _tmpnam)>@))dnl\n" +} + + + +# +# function to make the troff to typeset the function header +# +function makeHead(fname,type,i) +{ + fname = prefix fname + headString = sprintf("%s \\f3%s\\fP(",fortranize(type,0),fname) + if (numargs > 0) + { + headString = headString "\n" + if (numargs > 1) + { + headString = headString sprintf("%s,\n",fortranize(targs[1,i],1)) + headString = headString ".nf\n" + headString = headString sprintf(".ta \\w'\\f3%s \\fP%s( 'u\n",fortranize(type,0),fname) + for (j=2; j<=numargs-1; j++) + headString = headString sprintf("\t%s,\n",fortranize(targs[j,i],1)) + headString = headString sprintf("\t%s )\n",fortranize(targs[numargs,i],1)) + headString = headString ".fi\n" + } + else + headString = headString sprintf("%s )\n.nf\n.fi\n",fortranize(targs[numargs,i],1)) + } + else + headString = headString " )\n.nf\n.fi\n" + return headString +} + + +# Convert a gl C type to the FORTRAN equivalent +# If flag = 1, then convert a function argument; +# else, convert a function return type. + +function fortranize(typedArg,flag) +{ + item = typedArg; + if (flag == 0) { # return type + sub(/void/,"SUBROUTINE",item) + } + # function argument or return type + if (item ~ /\*/) { + sub(/\*/,"",item); + sub(/const /,"",item) + if (item ~ /GLubyte/) + sub(/GLubyte/,"CHARACTER*256",item) + else + sub(/GL[^ ]*/,"CHARACTER*8",item) + } + else { + sub(/GLu*byte/,"INTEGER*1",item) + sub(/GLu*short/,"INTEGER*2",item) + sub(/GLu*int/,"INTEGER*4",item) + sub(/GLsizei/,"INTEGER*4",item) + sub(/GLfloat/,"REAL*4",item) + sub(/GLclampf/,"REAL*4",item) + sub(/GLdouble/,"REAL*8",item) + sub(/GLclampd/,"REAL*4",item) + sub(/GLboolean/,"LOGICAL*1",item) + sub(/GLenum/,"INTEGER*4",item) + sub(/GLbitfield/,"INTEGER*4",item) + } + return item +} + + +# Generates 'args' of untyped argument names +# Also generates 'targs' of typed argument names and 'nargs', the number +# of arguments. + +function addargs(arglist,i) +{ +# +# First strip leading '(' and trailing ')' +# + if (substr(arglist,1,1) == "(") + arglist = substr(arglist,2,length(arglist)) + while (substr(arglist,1,1) == " ") + arglist = substr(arglist,2,length(arglist)) + + if (substr(arglist,length(arglist),1) == ")") + arglist = substr(arglist,1,length(arglist)-1) + while (substr(arglist,length(arglist),1) == " ") + arglist = substr(arglist,1,length(arglist)-1) + + numargs = split(arglist,newargs, ",[ \t]") + if (newargs[1] == "void") + { + numargs = 0; + targs[1,i] = newargs[1]; + args[1,i] = newargs[1]; + } + if (nargs[i] < numargs) + nargs[i] = numargs; + + for (j=1; j<=numargs; j++) + { +# targs[j,i] italicizes the argument but not the type + targs[j,i] = newargs[j] + numWords = split(targs[j,i],words,"[ \t]") + args[j,i] = words[numWords] + targs[j,i] = words[1] + for (k=2; k<=numWords-1; k++) + targs[j,i] = targs[j,i] " " words[k] + targs[j,i] = targs[j,i] " \\fI" words[numWords] "\\fP" + sub(/\[.*\]/,"",args[j,i]) + gsub("[*()]","",args[j,i]) + } +} + +# +# Parse and save away the _names(name,regexp) declarations in the file +# for later use in matching the entries in the API file. +# + +function getnames(file) +{ + numNames = 0 + fname = file ".gl" + while (getline < fname) + { + if (index($0,"_names(") != 0) + { + start = index($0,"_names(") + 7 + stuff = substr($0,start,length($0)-start) + split(stuff,things,",") + names[numNames] = things[1] + regExps[numNames] = things[2] + numNames++ + } + } + close(fname) + if (numNames == 0) + { + names[0] = file + regExps[0] = "[1-9]*u*[lbsifd]*v*" + numNames++ + } +} diff --git a/nx-X11/extras/ogl-sample/main/doc/man/macros/setup b/nx-X11/extras/ogl-sample/main/doc/man/macros/setup new file mode 100644 index 000000000..74a69369c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/macros/setup @@ -0,0 +1,36 @@ +define(`_define',defn(`define'))dnl +define(`_ifdef',defn(`ifdef'))dnl +define(`_ifelse',defn(`ifelse'))dnl +define(`_eval',defn(`eval'))dnl +define(`_len',defn(`len'))dnl +define(`_incr',defn(`incr'))dnl +changecom()dnl +define(`_C_',defn(`dnl'))dnl +undefine(`define')undefine(`ifdef')dnl +undefine(`shift')undefine(`divert')undefine(`incr')dnl +undefine(`decr')undefine(`eval')undefine(`len')undefine(`index')dnl +undefine(`substr')undefine(`include')dnl +changequote(@<,>@)dnl +_define(_makelist,@<_dolist(translit($1,@< >@,@<,>@))>@)dnl +_define(_dolist,@<dnl +_ifelse($#,1,$1,$#,2,$1@<+ >@$2,$#,3,$1@<+ >@$2@<+ >@$3,$#,dnl +4,$1@<+ >@$2@<+ >@$3@<+ >@$4)>@)dnl +_define(_namenum,@<0>@)dnl +_define(_tmpnam,maketemp)dnl +_define(_const,@<\%\f3GL_$1\fP>@)dnl +_define(_arbconst,@<\%\f3GL_$1_ARB\fP>@)dnl +_define(_arbconstidx,@<\%\f3GL_$1\fP$i$\f3_ARB\fP>@)dnl +_define(_xconst,@<\%\f3$1\fP>@)dnl +_define(_extname,@<\%\f3$1\fP>@)dnl +_define(_arbstring,@<\%\f3GL_ARB_$1\fP>@)dnl +_define(_extstring,@<\%\f3GL_$1\fP>@)dnl +_define(_glxextstring,@<\%\f3GLX_$1\fP>@)dnl +_define(_glxconst,@<\%\f3GLX_$1\fP>@)dnl +_define(_glxerror,@<\%\f3GLX$1\fP>@)dnl +_define(_gluconst,@<\%\f3GLU_$1\fP>@)dnl +_define(_econst,@<bold \%GL_$1>@)dnl +_define(_hex,@<\%0x$1>@)dnl +_define(_setup,@<_ifdef(@<_filters>@,@<'\"! _filters() | mmdoc +>@)dnl +'\"macro stdmacro +>@)dnl diff --git a/nx-X11/extras/ogl-sample/main/doc/man/macros/setup.ftn b/nx-X11/extras/ogl-sample/main/doc/man/macros/setup.ftn new file mode 100644 index 000000000..b7ed065e9 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/macros/setup.ftn @@ -0,0 +1,31 @@ +define(`_define',defn(`define'))dnl +define(`_ifdef',defn(`ifdef'))dnl +define(`_ifelse',defn(`ifelse'))dnl +define(`_eval',defn(`eval'))dnl +define(`_len',defn(`len'))dnl +define(`_incr',defn(`incr'))dnl +define(`_sinclude',defn(`sinclude'))dnl +changecom()dnl +define(`_C_',defn(`dnl'))dnl +undefine(`define')undefine(`ifdef')dnl +undefine(`shift')undefine(`divert')undefine(`incr')dnl +undefine(`decr')undefine(`eval')undefine(`len')undefine(`index')dnl +undefine(`substr')undefine(`include')undefine(`sinclude')dnl +changequote(@<,>@)dnl +_define(_makelist,@<_dolist(translit($1,@< >@,@<,>@))>@)dnl +_define(_dolist,@<dnl +_ifelse($#,1,$1,$#,2,$1@<+ >@$2,$#,3,$1@<+ >@$2@<+ >@$3,$#,dnl +4,$1@<+ >@$2@<+ >@$3@<+ >@$4)>@)dnl +_define(_namenum,@<0>@)dnl +_define(_tmpnam,maketemp)dnl +_define(_const,@<\f3GL_$1\fP>@)dnl +_define(_xconst,@<\f3$1\fP>@)dnl +_define(_glxconst,@<\f3GLX_$1\fP>@)dnl +_define(_glxerror,@<\f3GLX$1\fP>@)dnl +_define(_gluconst,@<\f3GLU_$1\fP>@)dnl +_define(_econst,@<bold GL_$1>@)dnl +_define(_hex,@<@<$>@$1>@)dnl +_define(_setup,@<_ifdef(@<_filters>@,@<'\"! _filters() | mmdoc +>@)dnl +'\"macro stdmacro +>@)dnl diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mandefs b/nx-X11/extras/ogl-sample/main/doc/man/mandefs new file mode 100644 index 000000000..4b3bfb2d1 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mandefs @@ -0,0 +1,182 @@ +# 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. +# +# $XFree86$ + +# Common definitions for man page Makefiles + +MMDOC = sh -x $(DEPTH)/tools/mmdoc +MPATH = $(DEPTH)/macros +GETNAMES = awk -f $(DEPTH)/tools/getnames +ADDINST = awk -f $(DEPTH)/tools/addinst +MAN2HTML = $(DEPTH)/tools/man2html + +# Global version and (published) date values for man page footers. Can override +# for a particular directory by reassigning after the inclusion of mandefs. +VERSION = Version 1.0 +DATE = June 1991 + +# +# directories - these may exist under some or all of the man sections +# and correspond to option man pages +# we list them all here once + +OPTIONS = standard nfs dwb trans ftn emacs pascal pl1 5080 ada t3270 pfa diags \ + x11 xt noship sna sna_3770 sna_3270 sna_server sna_lu6.2 spaceball \ + x25 netvis netman softpc c++ sna_lu0-3 bsdlpr 4DDN dgl gpib slip \ + nonstandard libil pca t3270dft vc nqs seiko5500 vfr bvo tcp3270 \ + smt sqa fddi fddivis cc cmplrs dbx edge ld efast cdrom gltools \ + moregltools imagetools gldebug libsphere + +# Change /pubs/tools symbolic name to $(MPATH) in .so's +FIXPUBS = sed 's:^\.so[ ]*/pubs/tools/:.so $(MPATH)/:' + +# script to translate the first line of the manpage +# from '\"! tbl | eqn | mmdoc +# to '\" t e +# which is what the linux man command needs. + +ifeq ($(OS),Linux) +FIXROFF = awk '/\\\"!/ { gsub(/!/, ""); \ + gsub(/eqn/, "e"); \ + gsub(/tbl/, "t"); \ + gsub(/mmdoc/, ""); \ + gsub(/\|/, ""); print $0; next; } { print $0; }' +else +FIXROFF = cat +endif + +# Convert .TH lines to all uppercase when making online pages (mostly +# for GL man pages). If line is .TH \*(}x, don't uppercase it. +THTOUPPER = \ + sed '/^\.TH[^}]*$$/y/abcdefghijklmnopqrstuvwxyz/ABCDEFGHIJKLMNOPQRSTUVWXYZ/' + +# Add string definitions containing VERSION, DATE, and RELEASE (only +# the portion after the "-", if it exists) to man page input. Also +# define strings with print date (i.e. "now"), last modified date of +# input file, and result of "sum <input file>". +ADDSTRINGS = awk 'BEGIN { \ + first = 1; \ + if (split("$(RELEASE)", r, "-") > 1) \ + release = r[2]; \ + else \ + release="$(RELEASE)"; \ + } \ + first == 1 && $$0 !~ /^'"'"'\\"/ { \ + print ".ds Vn $(VERSION)"; \ + print ".ds Dt $(DATE)"; \ + print ".ds Re Release", release; \ + print ".ds Dp '"`date '+%b %d %H:%M'`"'"; \ + print ".ds Dm '"`ls -l $< | cut -c42-53`"'"; \ + print ".ds Xs '"`sum $<`"'"; \ + first = 0; \ + } \ + { print }' + +# If page doesn't start with a magic '\", add a default one. +ADDMAGIC = ( case `head -1 $<` in \ + "'\\\""*) cat $< ;; \ + _*) $(DEPTH)/tools/glman $(PREFIX) $(DEPTH) $< $(APIFILE) $(M4OPTS) ;; \ + *) echo "'\\\"macro stdmacro" ; cat $< ;; \ + esac ) | $(FIXPUBS) | $(ADDSTRINGS) | $(FIXROFF) + +# If GL page starts '\"!, second line is assumed to contain '\"macro stdmacro, +# and it is changed to '\"macro mn; if page doesn't start with '\", +# '\"macro mn is added (if it's not there already). Only use the "mn" +# macros for hardcopy; online man pages use stdmacro like all other man pages. +ADDGLMAGIC = ( case `head -1 $<` in \ + "'\\\"macro mn") cat $< ;; \ + "'\\\""!*) sed '2 s/stdmacro/mn/' $< ;; \ + _*) $(DEPTH)/tools/glman $(PREFIX) $(DEPTH) $< $(APIFILE) $(M4OPTS) ;; \ + *) echo "'\\\"macro mn" ; cat $< ;; \ + esac ) | $(FIXPUBS) | $(ADDSTRINGS) + +RUNMMDOC = TMMACRO=$(MPATH) PATH=$(DEPTH)/tools:$$PATH \ + OTHERFILES="$(MPATH)/Op $(LANGOPT) $(MPATH)/localmacs" \ + $(MMDOC) $(MMFLAGS) + + +LEGALBASE = [0-z+,%-]*# +LEGALSUF1 = [1-7]# +LEGALSUF2 = [1-7][a-z]# +LEGALSUF3 = [1-7]X11# +LEGALSUF4 = [1-7]Xt# +LEGALNAME1 = $(LEGALBASE).$(LEGALSUF1)# +LEGALNAME2 = $(LEGALBASE).$(LEGALSUF2)# +LEGALNAME3 = $(LEGALBASE).$(LEGALSUF3)# +LEGALNAME4 = $(LEGALBASE).$(LEGALSUF4)# +LISTLEGAL = find . \( -name '$(LEGALNAME1)' -o -name '$(LEGALNAME2)' \ + -o -name '$(LEGALNAME3)' -o -name '$(LEGALNAME4)' \) -print | \ + sed -e 's/^..//' -e '/\//d' + +# +# The following defintions are release-note specific. +# + +# File that should be included before each chapter is formatted +CHAPHEAD = Templates/cFront + +# Files that should be included before each appendix is formatted +APPDXHEAD = Templates/cFront Templates/aFront + +# Between start and end put file names for generating +# the TC files in the right order. + +BASE = ch*# +CHAPSUF = cmm# +APPSUF = amm# + +LEGALCHAP = $(BASE).$(CHAPSUF) +LEGALAPP = $(BASE).$(APPSUF) +RELNOTES = find . \( -name '$(LEGALCHAP)' -o -name '$(LEGALAPP)' \) -print | \ + sed -e 's/^..//' -e '/\//d' | sort + +TCFILES = ToC/TC.start ToC/ch*.TC ToC/TC.end + +MMFILES = `$(RELNOTES)` + +IXFILES = Index/ch*.IX + +CHAP_PP = pic $(CHAPHEAD) $? | tbl +APP_PP = pic $(APPDXHEAD) $? | tbl + +# these should to be macros, so they can be overridden +PSVIEWOPTS = -F1.2 -0,2-6,11 +PSVIEW = psview +# this scale and geom works to show 6x9 pages on a 1280x1024 +# display. +XPSVIEWOPTS = -wp -skipc -sc 1.1 -geom 660x1020 - +XPSVIEW = xpsview + +# this can be used under X for previewing +DITVIEW = xditview -geom 640x950 - + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/GNUmakefile new file mode 100644 index 000000000..08e5597f2 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/GNUmakefile @@ -0,0 +1,53 @@ +#!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. +# + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +SUBDIRS = \ + standard \ + ftn \ + html \ + html_ftn \ + $(NULL) + +default $(ALLTARGS): $(_FORCE) + $(SUBDIRS_MAKERULE) + +distoss: + $(MAKE) $(COMMONPREF)$@ + $(SUBDIRS_MAKERULE) + +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/README b/nx-X11/extras/ogl-sample/main/doc/man/mangl/README new file mode 100644 index 000000000..3a49cdc14 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/README @@ -0,0 +1,93 @@ +This directory has GL man pages. + +./style gives some style guidelines. + +./template is a template that can be used as a starting point + when writing new man pages. + +./standard contains man page source and a Makefile for making + various targets using nroff and troff. The suffix + for man page source in this directory is '.gl'. + +Two awk scripts and m4 are run over GL man page source before it is +processed in the same way that standard man pages are. This allows +a writer to avoid most annoying troff'isms. + Several macros are provided to simplify man page writing. These +are: + +_header(name,desc) + Gives the name of the command to be used at the + top and bottom of the man page and in the _cmnd macro + (below). Also give the one line description of the + command. + +_names(base,regexp) +_names(base,regexp,noheader) + Generates the 'C SPECIFICATIONS' for all forms of + a command with the indicated base name and an + extension matching the given regular expression. + This is done by using the name and expression to search the + known GL commands. A function header is generated for + each matching command. The second form of the command, + with a third argument (any argument will do) suppresses + the generation of the 'C SPECIFICATION' section heading + for the matched names (useful when a single man page + describes diverse commands). + +_cmnd Without an argument, generates the correctly prefixed and +_cmnd(arg) capitalized base command name. Use \& (troff zero-width + space) to separate it from immediately following letters, + digits, underscores or parentheses. With an argument, it + generates the prefixed command name (currently the argument + is not matched against the known GL commands). + The command is automatically emboldened. + +_param<i> Generates the italicized <i>th parameter to the command. +_param<i>(n) Without an argument, it gets the <i>th argument to forms + of the command matching the last _names() invocation. + With an argument, gives the <i>th argument to forms of + the command matching the nth _names() invocation. + +_eqnparam<i> Same as _param, but does not italicize, and can therefore +_eqnparam<i>(n) be used in equations. + +_phead(param) Used when generating a parameter description of 'param'. + Parameter description immediately follows. + +_const(arg) Generates a prefixed and emboldened GL constant 'arg'. +_econst(arg) Same as _const but for use inside equations. + +_hex(arg) Generates "0x'arg'". + +_C_ Comment; everything following up to and including the next + newline is ignored + +_define define an M4 macro. See the M4 man page. Most of the + M4 macros having common names that could clash with words + in the text have been undefined or redefined to have + underscores preceeding their names. Be sure to use _C_ + (or M4's 'dnl') at the end of a macro definition to + avoid extraneous newlines in the troff source. + +If '_filters' is defined before the use of '_header' (see the template +for an example that is commented out) then the processed text is run +through the shell commands given in '_filters' just before being sent to +troff. Useful when tables or equations appear in the text. + +Two standard macros may be redefined in special situations. '_basename' +is the base command name. Normally it is set to the filename of the +man page being generated, sans suffix, and appears in the banner on +every page of the man page. 'gl' is automatically prepended to this +name. '_samething' is the message to be printed when there are +multiple commands under the same heading. See the template for +commented out examples. + +Troff macro names .BR and .BP appear in various manpages. These are +placeholders for .br and .bp macros that were added for the Addison +Wesley publication, but are not valid for other printings. Since these +macros are not defined anywhere, they are ignored by troff/nroff. + +A final and important note: the file MUST begin with an '_' +(probably as in '_header' or '_define(_filters,...)_C_) or +the aforementioned processing will not be applied and you will +be obliged to use the frightful standard man page troff constructs. diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/Distfile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/Distfile new file mode 100644 index 000000000..b862546bd --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/Distfile @@ -0,0 +1,142 @@ +# +# + +DISTDIR_SI = /xc/doc/man/GL/gl_ftn + +DISTFILES_SI = \ + Imakefile \ + fglaccum.3gl \ + fglalphafunc.3gl \ + fglaretexturesresident.3gl \ + fglarrayelement.3gl \ + fglbegin.3gl \ + fglbindtexture.3gl \ + fglbitmap.3gl \ + fglblendfunc.3gl \ + fglcalllist.3gl \ + fglcalllists.3gl \ + fglclear.3gl \ + fglclearaccum.3gl \ + fglclearcolor.3gl \ + fglcleardepth.3gl \ + fglclearindex.3gl \ + fglclearstencil.3gl \ + fglclipplane.3gl \ + fglcolor.3gl \ + fglcolormask.3gl \ + fglcolormaterial.3gl \ + fglcolorpointer.3gl \ + fglcopypixels.3gl \ + fglcopyteximage1d.3gl \ + fglcopyteximage2d.3gl \ + fglcopytexsubimage1d.3gl \ + fglcopytexsubimage2d.3gl \ + fglcullface.3gl \ + fgldeletelists.3gl \ + fgldeletetextures.3gl \ + fgldepthfunc.3gl \ + fgldepthmask.3gl \ + fgldepthrange.3gl \ + fgldrawarrays.3gl \ + fgldrawbuffer.3gl \ + fgldrawelements.3gl \ + fgldrawpixels.3gl \ + fgledgeflag.3gl \ + fgledgeflagpointer.3gl \ + fglenable.3gl \ + fglenableclientstate.3gl \ + fglevalcoord.3gl \ + fglevalmesh.3gl \ + fglevalpoint.3gl \ + fglfeedbackbuffer.3gl \ + fglfinish.3gl \ + fglflush.3gl \ + fglfog.3gl \ + fglfrontface.3gl \ + fglfrustum.3gl \ + fglgenlists.3gl \ + fglgentextures.3gl \ + fglget.3gl \ + fglgetclipplane.3gl \ + fglgeterror.3gl \ + fglgetlight.3gl \ + fglgetmap.3gl \ + fglgetmaterial.3gl \ + fglgetpixelmap.3gl \ + fglgetpointerv.3gl \ + fglgetpolygonstipple.3gl \ + fglgetstring.3gl \ + fglgettexenv.3gl \ + fglgettexgen.3gl \ + fglgetteximage.3gl \ + fglgettexlevelparameter.3gl \ + fglgettexparameter.3gl \ + fglhint.3gl \ + fglindex.3gl \ + fglindexmask.3gl \ + fglindexpointer.3gl \ + fglinitnames.3gl \ + fglinterleavedarrays.3gl \ + fglisenabled.3gl \ + fglislist.3gl \ + fglistexture.3gl \ + fgllight.3gl \ + fgllightmodel.3gl \ + fgllinestipple.3gl \ + fgllinewidth.3gl \ + fgllistbase.3gl \ + fglloadidentity.3gl \ + fglloadmatrix.3gl \ + fglloadname.3gl \ + fgllogicop.3gl \ + fglmap1.3gl \ + fglmap2.3gl \ + fglmapgrid.3gl \ + fglmaterial.3gl \ + fglmatrixmode.3gl \ + fglmultmatrix.3gl \ + fglnewlist.3gl \ + fglnormal.3gl \ + fglnormalpointer.3gl \ + fglortho.3gl \ + fglpassthrough.3gl \ + fglpixelmap.3gl \ + fglpixelstore.3gl \ + fglpixeltransfer.3gl \ + fglpixelzoom.3gl \ + fglpointsize.3gl \ + fglpolygonmode.3gl \ + fglpolygonoffset.3gl \ + fglpolygonstipple.3gl \ + fglprioritizetextures.3gl \ + fglpushattrib.3gl \ + fglpushclientattrib.3gl \ + fglpushmatrix.3gl \ + fglpushname.3gl \ + fglrasterpos.3gl \ + fglreadbuffer.3gl \ + fglreadpixels.3gl \ + fglrect.3gl \ + fglrendermode.3gl \ + fglrotate.3gl \ + fglscale.3gl \ + fglscissor.3gl \ + fglselectbuffer.3gl \ + fglshademodel.3gl \ + fglstencilfunc.3gl \ + fglstencilmask.3gl \ + fglstencilop.3gl \ + fgltexcoord.3gl \ + fgltexcoordpointer.3gl \ + fgltexenv.3gl \ + fgltexgen.3gl \ + fglteximage1d.3gl \ + fglteximage2d.3gl \ + fgltexparameter.3gl \ + fgltexsubimage1d.3gl \ + fgltexsubimage2d.3gl \ + fgltranslate.3gl \ + fglvertex.3gl \ + fglvertexpointer.3gl \ + fglviewport.3gl \ + $(NULL) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/GNUmakefile new file mode 100644 index 000000000..c913364cb --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/GNUmakefile @@ -0,0 +1,100 @@ +#!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 = f +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 = 10 Nov 1998 +RELEASE = 1.0 +MMFLAGS = -rs2 + +LEGALSUF1 = gl# +LEGALSUF2 = gl# +LEGALSUF3 = gl# +LEGALSUF4 = gl# + +LOCALPRINTLISTFILTER = | sed -e '/^intro\.p$$/d' | (echo intro.p ; cat ) + +default: + $(MAKE) links + $(MAKE) manpages + +headers headers_install libs libs_install install apps: + +distsi: default + $(MAKE) $(COMMONPREF)$@ + +distoss: + $(MAKE) $(COMMONPREF)$@ + +links: + cd ../standard ; \ + for i in *.gl ; do \ + ( cd ../ftn ; if test ! -L fgl$$i ; then \ + /bin/ln -s ../standard/$$i fgl$$i; fi ); \ + done + +manpages: $(patsubst %.gl,%.3gl,$(wildcard *.gl)) + +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 + +clean: + rm -f *.gl + +clobber: clean + rm -f *.3gl + +include $(DEPTH)/manrules +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/Imakefile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/Imakefile new file mode 100644 index 000000000..2ccc9c282 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/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 = \ +fglAccum.$(MANSUFFIX) fglAlphaFunc.$(MANSUFFIX) \ +fglAreTexturesResident.$(MANSUFFIX) fglArrayElement.$(MANSUFFIX) \ +fglBegin.$(MANSUFFIX) fglBindTexture.$(MANSUFFIX) \ +fglBitmap.$(MANSUFFIX) fglBlendColorEXT.$(MANSUFFIX) \ +fglBlendFunc.$(MANSUFFIX) fglCallList.$(MANSUFFIX) \ +fglCallLists.$(MANSUFFIX) fglClear.$(MANSUFFIX) \ +fglClearAccum.$(MANSUFFIX) fglClearColor.$(MANSUFFIX) \ +fglClearDepth.$(MANSUFFIX) fglClearIndex.$(MANSUFFIX) \ +fglClearStencil.$(MANSUFFIX) fglClipPlane.$(MANSUFFIX) \ +fglColor3b.$(MANSUFFIX) fglColor3bv.$(MANSUFFIX) \ +fglColor3d.$(MANSUFFIX) fglColor3dv.$(MANSUFFIX) \ +fglColor3f.$(MANSUFFIX) fglColor3fv.$(MANSUFFIX) \ +fglColor3i.$(MANSUFFIX) fglColor3iv.$(MANSUFFIX) \ +fglColor3s.$(MANSUFFIX) fglColor3sv.$(MANSUFFIX) \ +fglColor3ub.$(MANSUFFIX) fglColor3ubv.$(MANSUFFIX) \ +fglColor3ui.$(MANSUFFIX) fglColor3uiv.$(MANSUFFIX) \ +fglColor3us.$(MANSUFFIX) fglColor3usv.$(MANSUFFIX) \ +fglColor4b.$(MANSUFFIX) fglColor4bv.$(MANSUFFIX) \ +fglColor4d.$(MANSUFFIX) fglColor4dv.$(MANSUFFIX) \ +fglColor4f.$(MANSUFFIX) fglColor4fv.$(MANSUFFIX) \ +fglColor4i.$(MANSUFFIX) fglColor4iv.$(MANSUFFIX) \ +fglColor4s.$(MANSUFFIX) fglColor4sv.$(MANSUFFIX) \ +fglColor4ub.$(MANSUFFIX) fglColor4ubv.$(MANSUFFIX) \ +fglColor4ui.$(MANSUFFIX) fglColor4uiv.$(MANSUFFIX) \ +fglColor4us.$(MANSUFFIX) fglColor4usv.$(MANSUFFIX) \ +fglColorMask.$(MANSUFFIX) fglColorMaterial.$(MANSUFFIX) \ +fglColorPointer.$(MANSUFFIX) fglCopyPixels.$(MANSUFFIX) \ +fglCopyTexImage1D.$(MANSUFFIX) fglCopyTexImage2D.$(MANSUFFIX) \ +fglCopyTexSubImage1D.$(MANSUFFIX) fglCopyTexSubImage2D.$(MANSUFFIX) \ +fglCullFace.$(MANSUFFIX) fglDeleteLists.$(MANSUFFIX) \ +fglDeleteTextures.$(MANSUFFIX) fglDepthFunc.$(MANSUFFIX) \ +fglDepthMask.$(MANSUFFIX) fglDepthRange.$(MANSUFFIX) \ +fglDisable.$(MANSUFFIX) fglDisableClientState.$(MANSUFFIX) \ +fglDrawArrays.$(MANSUFFIX) fglDrawBuffer.$(MANSUFFIX) \ +fglDrawElements.$(MANSUFFIX) fglDrawPixels.$(MANSUFFIX) \ +fglEdgeFlag.$(MANSUFFIX) fglEdgeFlagPointer.$(MANSUFFIX) \ +fglEdgeFlagv.$(MANSUFFIX) fglEnable.$(MANSUFFIX) \ +fglEnableClientState.$(MANSUFFIX) fglEnd.$(MANSUFFIX) \ +fglEndList.$(MANSUFFIX) fglEvalCoord1d.$(MANSUFFIX) \ +fglEvalCoord1dv.$(MANSUFFIX) fglEvalCoord1f.$(MANSUFFIX) \ +fglEvalCoord1fv.$(MANSUFFIX) fglEvalCoord2d.$(MANSUFFIX) \ +fglEvalCoord2dv.$(MANSUFFIX) fglEvalCoord2f.$(MANSUFFIX) \ +fglEvalCoord2fv.$(MANSUFFIX) fglEvalMesh1.$(MANSUFFIX) \ +fglEvalMesh2.$(MANSUFFIX) fglEvalPoint1.$(MANSUFFIX) \ +fglEvalPoint2.$(MANSUFFIX) fglFeedbackBuffer.$(MANSUFFIX) \ +fglFinish.$(MANSUFFIX) fglFlush.$(MANSUFFIX) \ +fglFogf.$(MANSUFFIX) fglFogfv.$(MANSUFFIX) \ +fglFogi.$(MANSUFFIX) fglFogiv.$(MANSUFFIX) \ +fglFrontFace.$(MANSUFFIX) fglFrustum.$(MANSUFFIX) \ +fglGenLists.$(MANSUFFIX) fglGenTextures.$(MANSUFFIX) \ +fglGetBooleanv.$(MANSUFFIX) fglGetClipPlane.$(MANSUFFIX) \ +fglGetDoublev.$(MANSUFFIX) fglGetError.$(MANSUFFIX) \ +fglGetFloatv.$(MANSUFFIX) fglGetIntegerv.$(MANSUFFIX) \ +fglGetLightfv.$(MANSUFFIX) fglGetLightiv.$(MANSUFFIX) \ +fglGetMapdv.$(MANSUFFIX) fglGetMapfv.$(MANSUFFIX) \ +fglGetMapiv.$(MANSUFFIX) fglGetMaterialfv.$(MANSUFFIX) \ +fglGetMaterialiv.$(MANSUFFIX) fglGetPixelMapfv.$(MANSUFFIX) \ +fglGetPixelMapuiv.$(MANSUFFIX) fglGetPixelMapusv.$(MANSUFFIX) \ +fglGetPointerv.$(MANSUFFIX) fglGetPolygonStipple.$(MANSUFFIX) \ +fglGetString.$(MANSUFFIX) fglGetTexEnvfv.$(MANSUFFIX) \ +fglGetTexEnviv.$(MANSUFFIX) fglGetTexGendv.$(MANSUFFIX) \ +fglGetTexGenfv.$(MANSUFFIX) fglGetTexGeniv.$(MANSUFFIX) \ +fglGetTexImage.$(MANSUFFIX) fglGetTexLevelParameterfv.$(MANSUFFIX) \ +fglGetTexLevelParameteriv.$(MANSUFFIX) fglGetTexParameterfv.$(MANSUFFIX) \ +fglGetTexParameteriv.$(MANSUFFIX) fglHint.$(MANSUFFIX) \ +fglIndexMask.$(MANSUFFIX) fglIndexPointer.$(MANSUFFIX) \ +fglIndexd.$(MANSUFFIX) fglIndexdv.$(MANSUFFIX) \ +fglIndexf.$(MANSUFFIX) fglIndexfv.$(MANSUFFIX) \ +fglIndexi.$(MANSUFFIX) fglIndexiv.$(MANSUFFIX) \ +fglIndexs.$(MANSUFFIX) fglIndexsv.$(MANSUFFIX) \ +fglIndexub.$(MANSUFFIX) fglIndexubv.$(MANSUFFIX) \ +fglInitNames.$(MANSUFFIX) fglInterleavedArrays.$(MANSUFFIX) \ +fglIsEnabled.$(MANSUFFIX) fglIsList.$(MANSUFFIX) \ +fglIsTexture.$(MANSUFFIX) fglLightModelf.$(MANSUFFIX) \ +fglLightModelfv.$(MANSUFFIX) fglLightModeli.$(MANSUFFIX) \ +fglLightModeliv.$(MANSUFFIX) fglLightf.$(MANSUFFIX) \ +fglLightfv.$(MANSUFFIX) fglLighti.$(MANSUFFIX) \ +fglLightiv.$(MANSUFFIX) fglLineStipple.$(MANSUFFIX) \ +fglLineWidth.$(MANSUFFIX) fglListBase.$(MANSUFFIX) \ +fglLoadIdentity.$(MANSUFFIX) fglLoadMatrixd.$(MANSUFFIX) \ +fglLoadMatrixf.$(MANSUFFIX) fglLoadName.$(MANSUFFIX) \ +fglLogicOp.$(MANSUFFIX) fglMap1d.$(MANSUFFIX) \ +fglMap1f.$(MANSUFFIX) fglMap2d.$(MANSUFFIX) \ +fglMap2f.$(MANSUFFIX) fglMapGrid1d.$(MANSUFFIX) \ +fglMapGrid1f.$(MANSUFFIX) fglMapGrid2d.$(MANSUFFIX) \ +fglMapGrid2f.$(MANSUFFIX) fglMaterialf.$(MANSUFFIX) \ +fglMaterialfv.$(MANSUFFIX) fglMateriali.$(MANSUFFIX) \ +fglMaterialiv.$(MANSUFFIX) fglMatrixMode.$(MANSUFFIX) \ +fglMultMatrixd.$(MANSUFFIX) fglMultMatrixf.$(MANSUFFIX) \ +fglNewList.$(MANSUFFIX) fglNormal3b.$(MANSUFFIX) \ +fglNormal3bv.$(MANSUFFIX) fglNormal3d.$(MANSUFFIX) \ +fglNormal3dv.$(MANSUFFIX) fglNormal3f.$(MANSUFFIX) \ +fglNormal3fv.$(MANSUFFIX) fglNormal3i.$(MANSUFFIX) \ +fglNormal3iv.$(MANSUFFIX) fglNormal3s.$(MANSUFFIX) \ +fglNormal3sv.$(MANSUFFIX) fglNormalPointer.$(MANSUFFIX) \ +fglOrtho.$(MANSUFFIX) fglPassThrough.$(MANSUFFIX) \ +fglPixelMapfv.$(MANSUFFIX) fglPixelMapuiv.$(MANSUFFIX) \ +fglPixelMapusv.$(MANSUFFIX) fglPixelStoref.$(MANSUFFIX) \ +fglPixelStorei.$(MANSUFFIX) fglPixelTransferf.$(MANSUFFIX) \ +fglPixelTransferi.$(MANSUFFIX) fglPixelZoom.$(MANSUFFIX) \ +fglPointSize.$(MANSUFFIX) fglPolygonMode.$(MANSUFFIX) \ +fglPolygonOffset.$(MANSUFFIX) fglPolygonStipple.$(MANSUFFIX) \ +fglPopAttrib.$(MANSUFFIX) fglPopClientAttrib.$(MANSUFFIX) \ +fglPopMatrix.$(MANSUFFIX) fglPopName.$(MANSUFFIX) \ +fglPrioritizeTextures.$(MANSUFFIX) fglPushAttrib.$(MANSUFFIX) \ +fglPushClientAttrib.$(MANSUFFIX) fglPushMatrix.$(MANSUFFIX) \ +fglPushName.$(MANSUFFIX) fglRasterPos2d.$(MANSUFFIX) \ +fglRasterPos2dv.$(MANSUFFIX) fglRasterPos2f.$(MANSUFFIX) \ +fglRasterPos2fv.$(MANSUFFIX) fglRasterPos2i.$(MANSUFFIX) \ +fglRasterPos2iv.$(MANSUFFIX) fglRasterPos2s.$(MANSUFFIX) \ +fglRasterPos2sv.$(MANSUFFIX) fglRasterPos3d.$(MANSUFFIX) \ +fglRasterPos3dv.$(MANSUFFIX) fglRasterPos3f.$(MANSUFFIX) \ +fglRasterPos3fv.$(MANSUFFIX) fglRasterPos3i.$(MANSUFFIX) \ +fglRasterPos3iv.$(MANSUFFIX) fglRasterPos3s.$(MANSUFFIX) \ +fglRasterPos3sv.$(MANSUFFIX) fglRasterPos4d.$(MANSUFFIX) \ +fglRasterPos4dv.$(MANSUFFIX) fglRasterPos4f.$(MANSUFFIX) \ +fglRasterPos4fv.$(MANSUFFIX) fglRasterPos4i.$(MANSUFFIX) \ +fglRasterPos4iv.$(MANSUFFIX) fglRasterPos4s.$(MANSUFFIX) \ +fglRasterPos4sv.$(MANSUFFIX) fglReadBuffer.$(MANSUFFIX) \ +fglReadPixels.$(MANSUFFIX) fglRectd.$(MANSUFFIX) \ +fglRectdv.$(MANSUFFIX) fglRectf.$(MANSUFFIX) \ +fglRectfv.$(MANSUFFIX) fglRecti.$(MANSUFFIX) \ +fglRectiv.$(MANSUFFIX) fglRects.$(MANSUFFIX) \ +fglRectsv.$(MANSUFFIX) fglRenderMode.$(MANSUFFIX) \ +fglRotated.$(MANSUFFIX) fglRotatef.$(MANSUFFIX) \ +fglScaled.$(MANSUFFIX) fglScalef.$(MANSUFFIX) \ +fglScissor.$(MANSUFFIX) fglSelectBuffer.$(MANSUFFIX) \ +fglShadeModel.$(MANSUFFIX) fglStencilFunc.$(MANSUFFIX) \ +fglStencilMask.$(MANSUFFIX) fglStencilOp.$(MANSUFFIX) \ +fglTexCoord1d.$(MANSUFFIX) fglTexCoord1dv.$(MANSUFFIX) \ +fglTexCoord1f.$(MANSUFFIX) fglTexCoord1fv.$(MANSUFFIX) \ +fglTexCoord1i.$(MANSUFFIX) fglTexCoord1iv.$(MANSUFFIX) \ +fglTexCoord1s.$(MANSUFFIX) fglTexCoord1sv.$(MANSUFFIX) \ +fglTexCoord2d.$(MANSUFFIX) fglTexCoord2dv.$(MANSUFFIX) \ +fglTexCoord2f.$(MANSUFFIX) fglTexCoord2fv.$(MANSUFFIX) \ +fglTexCoord2i.$(MANSUFFIX) fglTexCoord2iv.$(MANSUFFIX) \ +fglTexCoord2s.$(MANSUFFIX) fglTexCoord2sv.$(MANSUFFIX) \ +fglTexCoord3d.$(MANSUFFIX) fglTexCoord3dv.$(MANSUFFIX) \ +fglTexCoord3f.$(MANSUFFIX) fglTexCoord3fv.$(MANSUFFIX) \ +fglTexCoord3i.$(MANSUFFIX) fglTexCoord3iv.$(MANSUFFIX) \ +fglTexCoord3s.$(MANSUFFIX) fglTexCoord3sv.$(MANSUFFIX) \ +fglTexCoord4d.$(MANSUFFIX) fglTexCoord4dv.$(MANSUFFIX) \ +fglTexCoord4f.$(MANSUFFIX) fglTexCoord4fv.$(MANSUFFIX) \ +fglTexCoord4i.$(MANSUFFIX) fglTexCoord4iv.$(MANSUFFIX) \ +fglTexCoord4s.$(MANSUFFIX) fglTexCoord4sv.$(MANSUFFIX) \ +fglTexCoordPointer.$(MANSUFFIX) fglTexEnvf.$(MANSUFFIX) \ +fglTexEnvfv.$(MANSUFFIX) fglTexEnvi.$(MANSUFFIX) \ +fglTexEnviv.$(MANSUFFIX) fglTexGend.$(MANSUFFIX) \ +fglTexGendv.$(MANSUFFIX) fglTexGenf.$(MANSUFFIX) \ +fglTexGenfv.$(MANSUFFIX) fglTexGeni.$(MANSUFFIX) \ +fglTexGeniv.$(MANSUFFIX) fglTexImage1D.$(MANSUFFIX) \ +fglTexImage2D.$(MANSUFFIX) fglTexParameterf.$(MANSUFFIX) \ +fglTexParameterfv.$(MANSUFFIX) fglTexParameteri.$(MANSUFFIX) \ +fglTexParameteriv.$(MANSUFFIX) fglTexSubImage1D.$(MANSUFFIX) \ +fglTexSubImage2D.$(MANSUFFIX) fglTranslated.$(MANSUFFIX) \ +fglTranslatef.$(MANSUFFIX) fglVertex2d.$(MANSUFFIX) \ +fglVertex2dv.$(MANSUFFIX) fglVertex2f.$(MANSUFFIX) \ +fglVertex2fv.$(MANSUFFIX) fglVertex2i.$(MANSUFFIX) \ +fglVertex2iv.$(MANSUFFIX) fglVertex2s.$(MANSUFFIX) \ +fglVertex2sv.$(MANSUFFIX) fglVertex3d.$(MANSUFFIX) \ +fglVertex3dv.$(MANSUFFIX) fglVertex3f.$(MANSUFFIX) \ +fglVertex3fv.$(MANSUFFIX) fglVertex3i.$(MANSUFFIX) \ +fglVertex3iv.$(MANSUFFIX) fglVertex3s.$(MANSUFFIX) \ +fglVertex3sv.$(MANSUFFIX) fglVertex4d.$(MANSUFFIX) \ +fglVertex4dv.$(MANSUFFIX) fglVertex4f.$(MANSUFFIX) \ +fglVertex4fv.$(MANSUFFIX) fglVertex4i.$(MANSUFFIX) \ +fglVertex4iv.$(MANSUFFIX) fglVertex4s.$(MANSUFFIX) \ +fglVertex4sv.$(MANSUFFIX) fglVertexPointer.$(MANSUFFIX) \ +fglViewport.$(MANSUFFIX) + +LINK_NAMES = \ +fglAccum.$(MANSUFFIX) fglAlphaFunc.$(MANSUFFIX) \ +fglAreTexturesResident.$(MANSUFFIX) fglArrayElement.$(MANSUFFIX) \ +fglBegin.$(MANSUFFIX) fglBindTexture.$(MANSUFFIX) \ +fglBitmap.$(MANSUFFIX) fglBlendColorEXT.$(MANSUFFIX) \ +fglBlendFunc.$(MANSUFFIX) fglCallList.$(MANSUFFIX) \ +fglCallLists.$(MANSUFFIX) fglClear.$(MANSUFFIX) \ +fglClearAccum.$(MANSUFFIX) fglClearColor.$(MANSUFFIX) \ +fglClearDepth.$(MANSUFFIX) fglClearIndex.$(MANSUFFIX) \ +fglClearStencil.$(MANSUFFIX) fglClipPlane.$(MANSUFFIX) \ +fglColor3b.$(MANSUFFIX) fglColorMask.$(MANSUFFIX) \ +fglColorMaterial.$(MANSUFFIX) fglColorPointer.$(MANSUFFIX) \ +fglCopyPixels.$(MANSUFFIX) fglCopyTexImage1D.$(MANSUFFIX) \ +fglCopyTexImage2D.$(MANSUFFIX) fglCopyTexSubImage1D.$(MANSUFFIX) \ +fglCopyTexSubImage2D.$(MANSUFFIX) fglCullFace.$(MANSUFFIX) \ +fglDeleteLists.$(MANSUFFIX) fglDeleteTextures.$(MANSUFFIX) \ +fglDepthFunc.$(MANSUFFIX) fglDepthMask.$(MANSUFFIX) \ +fglDepthRange.$(MANSUFFIX) fglDrawArrays.$(MANSUFFIX) \ +fglDrawBuffer.$(MANSUFFIX) fglDrawElements.$(MANSUFFIX) \ +fglDrawPixels.$(MANSUFFIX) fglEdgeFlag.$(MANSUFFIX) \ +fglEdgeFlagPointer.$(MANSUFFIX) fglEnable.$(MANSUFFIX) \ +fglEnableClientState.$(MANSUFFIX) fglEvalCoord1d.$(MANSUFFIX) \ +fglEvalMesh1.$(MANSUFFIX) fglEvalPoint1.$(MANSUFFIX) \ +fglFeedbackBuffer.$(MANSUFFIX) fglFinish.$(MANSUFFIX) \ +fglFlush.$(MANSUFFIX) fglFogf.$(MANSUFFIX) \ +fglFrontFace.$(MANSUFFIX) fglFrustum.$(MANSUFFIX) \ +fglGenLists.$(MANSUFFIX) fglGenTextures.$(MANSUFFIX) \ +fglGetBooleanv.$(MANSUFFIX) fglGetClipPlane.$(MANSUFFIX) \ +fglGetError.$(MANSUFFIX) fglGetLightfv.$(MANSUFFIX) \ +fglGetMapdv.$(MANSUFFIX) fglGetMaterialfv.$(MANSUFFIX) \ +fglGetPixelMapfv.$(MANSUFFIX) fglGetPointerv.$(MANSUFFIX) \ +fglGetPolygonStipple.$(MANSUFFIX) fglGetString.$(MANSUFFIX) \ +fglGetTexEnvfv.$(MANSUFFIX) fglGetTexGendv.$(MANSUFFIX) \ +fglGetTexImage.$(MANSUFFIX) fglGetTexLevelParameterfv.$(MANSUFFIX) \ +fglGetTexParameterfv.$(MANSUFFIX) fglHint.$(MANSUFFIX) \ +fglIndexMask.$(MANSUFFIX) fglIndexPointer.$(MANSUFFIX) \ +fglIndexd.$(MANSUFFIX) fglInitNames.$(MANSUFFIX) \ +fglInterleavedArrays.$(MANSUFFIX) fglIsEnabled.$(MANSUFFIX) \ +fglIsList.$(MANSUFFIX) fglIsTexture.$(MANSUFFIX) \ +fglLightModelf.$(MANSUFFIX) fglLightf.$(MANSUFFIX) \ +fglLineStipple.$(MANSUFFIX) fglLineWidth.$(MANSUFFIX) \ +fglListBase.$(MANSUFFIX) fglLoadIdentity.$(MANSUFFIX) \ +fglLoadMatrixd.$(MANSUFFIX) fglLoadName.$(MANSUFFIX) \ +fglLogicOp.$(MANSUFFIX) fglMap1d.$(MANSUFFIX) \ +fglMap2d.$(MANSUFFIX) fglMapGrid1d.$(MANSUFFIX) \ +fglMaterialf.$(MANSUFFIX) fglMatrixMode.$(MANSUFFIX) \ +fglMultMatrixd.$(MANSUFFIX) fglNewList.$(MANSUFFIX) \ +fglNormal3b.$(MANSUFFIX) fglNormalPointer.$(MANSUFFIX) \ +fglOrtho.$(MANSUFFIX) fglPassThrough.$(MANSUFFIX) \ +fglPixelMapfv.$(MANSUFFIX) fglPixelStoref.$(MANSUFFIX) \ +fglPixelTransferf.$(MANSUFFIX) fglPixelZoom.$(MANSUFFIX) \ +fglPointSize.$(MANSUFFIX) fglPolygonMode.$(MANSUFFIX) \ +fglPolygonOffset.$(MANSUFFIX) fglPolygonStipple.$(MANSUFFIX) \ +fglPrioritizeTextures.$(MANSUFFIX) fglPushAttrib.$(MANSUFFIX) \ +fglPushClientAttrib.$(MANSUFFIX) fglPushMatrix.$(MANSUFFIX) \ +fglPushName.$(MANSUFFIX) fglRasterPos2d.$(MANSUFFIX) \ +fglReadBuffer.$(MANSUFFIX) fglReadPixels.$(MANSUFFIX) \ +fglRectd.$(MANSUFFIX) fglRenderMode.$(MANSUFFIX) \ +fglRotated.$(MANSUFFIX) fglScaled.$(MANSUFFIX) \ +fglScissor.$(MANSUFFIX) fglSelectBuffer.$(MANSUFFIX) \ +fglShadeModel.$(MANSUFFIX) fglStencilFunc.$(MANSUFFIX) \ +fglStencilMask.$(MANSUFFIX) fglStencilOp.$(MANSUFFIX) \ +fglTexCoord1d.$(MANSUFFIX) fglTexCoordPointer.$(MANSUFFIX) \ +fglTexEnvf.$(MANSUFFIX) fglTexGend.$(MANSUFFIX) \ +fglTexImage1D.$(MANSUFFIX) fglTexImage2D.$(MANSUFFIX) \ +fglTexParameterf.$(MANSUFFIX) fglTexSubImage1D.$(MANSUFFIX) \ +fglTexSubImage2D.$(MANSUFFIX) fglTranslated.$(MANSUFFIX) \ +fglVertex2d.$(MANSUFFIX) fglVertexPointer.$(MANSUFFIX) \ +fglViewport.$(MANSUFFIX) + +ALIAS_NAMES = \ +fglColor3bv.$(MANSUFFIX) fglColor3d.$(MANSUFFIX) \ +fglColor3dv.$(MANSUFFIX) fglColor3f.$(MANSUFFIX) \ +fglColor3fv.$(MANSUFFIX) fglColor3i.$(MANSUFFIX) \ +fglColor3iv.$(MANSUFFIX) fglColor3s.$(MANSUFFIX) \ +fglColor3sv.$(MANSUFFIX) fglColor3ub.$(MANSUFFIX) \ +fglColor3ubv.$(MANSUFFIX) fglColor3ui.$(MANSUFFIX) \ +fglColor3uiv.$(MANSUFFIX) fglColor3us.$(MANSUFFIX) \ +fglColor3usv.$(MANSUFFIX) fglColor4b.$(MANSUFFIX) \ +fglColor4bv.$(MANSUFFIX) fglColor4d.$(MANSUFFIX) \ +fglColor4dv.$(MANSUFFIX) fglColor4f.$(MANSUFFIX) \ +fglColor4fv.$(MANSUFFIX) fglColor4i.$(MANSUFFIX) \ +fglColor4iv.$(MANSUFFIX) fglColor4s.$(MANSUFFIX) \ +fglColor4sv.$(MANSUFFIX) fglColor4ub.$(MANSUFFIX) \ +fglColor4ubv.$(MANSUFFIX) fglColor4ui.$(MANSUFFIX) \ +fglColor4uiv.$(MANSUFFIX) fglColor4us.$(MANSUFFIX) \ +fglColor4usv.$(MANSUFFIX) fglDisable.$(MANSUFFIX) \ +fglDisableClientState.$(MANSUFFIX) fglEdgeFlagv.$(MANSUFFIX) \ +fglEnd.$(MANSUFFIX) fglEndList.$(MANSUFFIX) \ +fglEvalCoord1dv.$(MANSUFFIX) fglEvalCoord1f.$(MANSUFFIX) \ +fglEvalCoord1fv.$(MANSUFFIX) fglEvalCoord2d.$(MANSUFFIX) \ +fglEvalCoord2dv.$(MANSUFFIX) fglEvalCoord2f.$(MANSUFFIX) \ +fglEvalCoord2fv.$(MANSUFFIX) fglEvalMesh2.$(MANSUFFIX) \ +fglEvalPoint2.$(MANSUFFIX) fglFogfv.$(MANSUFFIX) \ +fglFogi.$(MANSUFFIX) fglFogiv.$(MANSUFFIX) \ +fglGetDoublev.$(MANSUFFIX) fglGetFloatv.$(MANSUFFIX) \ +fglGetIntegerv.$(MANSUFFIX) fglGetLightiv.$(MANSUFFIX) \ +fglGetMapfv.$(MANSUFFIX) fglGetMapiv.$(MANSUFFIX) \ +fglGetMaterialiv.$(MANSUFFIX) fglGetPixelMapuiv.$(MANSUFFIX) \ +fglGetPixelMapusv.$(MANSUFFIX) fglGetTexEnviv.$(MANSUFFIX) \ +fglGetTexGenfv.$(MANSUFFIX) fglGetTexGeniv.$(MANSUFFIX) \ +fglGetTexLevelParameteriv.$(MANSUFFIX) fglGetTexParameteriv.$(MANSUFFIX) \ +fglIndexdv.$(MANSUFFIX) fglIndexf.$(MANSUFFIX) \ +fglIndexfv.$(MANSUFFIX) fglIndexi.$(MANSUFFIX) \ +fglIndexiv.$(MANSUFFIX) fglIndexs.$(MANSUFFIX) \ +fglIndexsv.$(MANSUFFIX) fglIndexub.$(MANSUFFIX) \ +fglIndexubv.$(MANSUFFIX) fglLightModelfv.$(MANSUFFIX) \ +fglLightModeli.$(MANSUFFIX) fglLightModeliv.$(MANSUFFIX) \ +fglLightfv.$(MANSUFFIX) fglLighti.$(MANSUFFIX) \ +fglLightiv.$(MANSUFFIX) fglLoadMatrixf.$(MANSUFFIX) \ +fglMap1f.$(MANSUFFIX) fglMap2f.$(MANSUFFIX) \ +fglMapGrid1f.$(MANSUFFIX) fglMapGrid2d.$(MANSUFFIX) \ +fglMapGrid2f.$(MANSUFFIX) fglMaterialfv.$(MANSUFFIX) \ +fglMateriali.$(MANSUFFIX) fglMaterialiv.$(MANSUFFIX) \ +fglMultMatrixf.$(MANSUFFIX) fglNormal3bv.$(MANSUFFIX) \ +fglNormal3d.$(MANSUFFIX) fglNormal3dv.$(MANSUFFIX) \ +fglNormal3f.$(MANSUFFIX) fglNormal3fv.$(MANSUFFIX) \ +fglNormal3i.$(MANSUFFIX) fglNormal3iv.$(MANSUFFIX) \ +fglNormal3s.$(MANSUFFIX) fglNormal3sv.$(MANSUFFIX) \ +fglPixelMapuiv.$(MANSUFFIX) fglPixelMapusv.$(MANSUFFIX) \ +fglPixelStorei.$(MANSUFFIX) fglPixelTransferi.$(MANSUFFIX) \ +fglPopAttrib.$(MANSUFFIX) fglPopClientAttrib.$(MANSUFFIX) \ +fglPopMatrix.$(MANSUFFIX) fglPopName.$(MANSUFFIX) \ +fglRasterPos2dv.$(MANSUFFIX) fglRasterPos2f.$(MANSUFFIX) \ +fglRasterPos2fv.$(MANSUFFIX) fglRasterPos2i.$(MANSUFFIX) \ +fglRasterPos2iv.$(MANSUFFIX) fglRasterPos2s.$(MANSUFFIX) \ +fglRasterPos2sv.$(MANSUFFIX) fglRasterPos3d.$(MANSUFFIX) \ +fglRasterPos3dv.$(MANSUFFIX) fglRasterPos3f.$(MANSUFFIX) \ +fglRasterPos3fv.$(MANSUFFIX) fglRasterPos3i.$(MANSUFFIX) \ +fglRasterPos3iv.$(MANSUFFIX) fglRasterPos3s.$(MANSUFFIX) \ +fglRasterPos3sv.$(MANSUFFIX) fglRasterPos4d.$(MANSUFFIX) \ +fglRasterPos4dv.$(MANSUFFIX) fglRasterPos4f.$(MANSUFFIX) \ +fglRasterPos4fv.$(MANSUFFIX) fglRasterPos4i.$(MANSUFFIX) \ +fglRasterPos4iv.$(MANSUFFIX) fglRasterPos4s.$(MANSUFFIX) \ +fglRasterPos4sv.$(MANSUFFIX) fglRectdv.$(MANSUFFIX) \ +fglRectf.$(MANSUFFIX) fglRectfv.$(MANSUFFIX) \ +fglRecti.$(MANSUFFIX) fglRectiv.$(MANSUFFIX) \ +fglRects.$(MANSUFFIX) fglRectsv.$(MANSUFFIX) \ +fglRotatef.$(MANSUFFIX) fglScalef.$(MANSUFFIX) \ +fglTexCoord1dv.$(MANSUFFIX) fglTexCoord1f.$(MANSUFFIX) \ +fglTexCoord1fv.$(MANSUFFIX) fglTexCoord1i.$(MANSUFFIX) \ +fglTexCoord1iv.$(MANSUFFIX) fglTexCoord1s.$(MANSUFFIX) \ +fglTexCoord1sv.$(MANSUFFIX) fglTexCoord2d.$(MANSUFFIX) \ +fglTexCoord2dv.$(MANSUFFIX) fglTexCoord2f.$(MANSUFFIX) \ +fglTexCoord2fv.$(MANSUFFIX) fglTexCoord2i.$(MANSUFFIX) \ +fglTexCoord2iv.$(MANSUFFIX) fglTexCoord2s.$(MANSUFFIX) \ +fglTexCoord2sv.$(MANSUFFIX) fglTexCoord3d.$(MANSUFFIX) \ +fglTexCoord3dv.$(MANSUFFIX) fglTexCoord3f.$(MANSUFFIX) \ +fglTexCoord3fv.$(MANSUFFIX) fglTexCoord3i.$(MANSUFFIX) \ +fglTexCoord3iv.$(MANSUFFIX) fglTexCoord3s.$(MANSUFFIX) \ +fglTexCoord3sv.$(MANSUFFIX) fglTexCoord4d.$(MANSUFFIX) \ +fglTexCoord4dv.$(MANSUFFIX) fglTexCoord4f.$(MANSUFFIX) \ +fglTexCoord4fv.$(MANSUFFIX) fglTexCoord4i.$(MANSUFFIX) \ +fglTexCoord4iv.$(MANSUFFIX) fglTexCoord4s.$(MANSUFFIX) \ +fglTexCoord4sv.$(MANSUFFIX) fglTexEnvfv.$(MANSUFFIX) \ +fglTexEnvi.$(MANSUFFIX) fglTexEnviv.$(MANSUFFIX) \ +fglTexGendv.$(MANSUFFIX) fglTexGenf.$(MANSUFFIX) \ +fglTexGenfv.$(MANSUFFIX) fglTexGeni.$(MANSUFFIX) \ +fglTexGeniv.$(MANSUFFIX) fglTexParameterfv.$(MANSUFFIX) \ +fglTexParameteri.$(MANSUFFIX) fglTexParameteriv.$(MANSUFFIX) \ +fglTranslatef.$(MANSUFFIX) fglVertex2dv.$(MANSUFFIX) \ +fglVertex2f.$(MANSUFFIX) fglVertex2fv.$(MANSUFFIX) \ +fglVertex2i.$(MANSUFFIX) fglVertex2iv.$(MANSUFFIX) \ +fglVertex2s.$(MANSUFFIX) fglVertex2sv.$(MANSUFFIX) \ +fglVertex3d.$(MANSUFFIX) fglVertex3dv.$(MANSUFFIX) \ +fglVertex3f.$(MANSUFFIX) fglVertex3fv.$(MANSUFFIX) \ +fglVertex3i.$(MANSUFFIX) fglVertex3iv.$(MANSUFFIX) \ +fglVertex3s.$(MANSUFFIX) fglVertex3sv.$(MANSUFFIX) \ +fglVertex4d.$(MANSUFFIX) fglVertex4dv.$(MANSUFFIX) \ +fglVertex4f.$(MANSUFFIX) fglVertex4fv.$(MANSUFFIX) \ +fglVertex4i.$(MANSUFFIX) fglVertex4iv.$(MANSUFFIX) \ +fglVertex4s.$(MANSUFFIX) fglVertex4sv.$(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(fglAccum.$(MANSUFFIX), fglaccum.3gl) + +LinkFile(fglAlphaFunc.$(MANSUFFIX), fglalphafunc.3gl) + +LinkFile(fglAreTexturesResident.$(MANSUFFIX), fglaretexturesresident.3gl) + +LinkFile(fglArrayElement.$(MANSUFFIX), fglarrayelement.3gl) + +LinkFile(fglBegin.$(MANSUFFIX), fglbegin.3gl) +ManPageAlias(fglBegin, $(LIBMANDIR), fglEnd) + +LinkFile(fglBindTexture.$(MANSUFFIX), fglbindtexture.3gl) + +LinkFile(fglBitmap.$(MANSUFFIX), fglbitmap.3gl) + +LinkFile(fglBlendColorEXT.$(MANSUFFIX), fglblendcolorext.3gl) + +LinkFile(fglBlendFunc.$(MANSUFFIX), fglblendfunc.3gl) + +LinkFile(fglCallList.$(MANSUFFIX), fglcalllist.3gl) + +LinkFile(fglCallLists.$(MANSUFFIX), fglcalllists.3gl) + +LinkFile(fglClear.$(MANSUFFIX), fglclear.3gl) + +LinkFile(fglClearAccum.$(MANSUFFIX), fglclearaccum.3gl) + +LinkFile(fglClearColor.$(MANSUFFIX), fglclearcolor.3gl) + +LinkFile(fglClearDepth.$(MANSUFFIX), fglcleardepth.3gl) + +LinkFile(fglClearIndex.$(MANSUFFIX), fglclearindex.3gl) + +LinkFile(fglClearStencil.$(MANSUFFIX), fglclearstencil.3gl) + +LinkFile(fglClipPlane.$(MANSUFFIX), fglclipplane.3gl) + +LinkFile(fglColor3b.$(MANSUFFIX), fglcolor.3gl) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3d) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3f) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3i) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3s) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3ub) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3ui) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3us) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4b) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4d) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4f) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4i) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4s) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4ub) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4ui) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4us) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3bv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3dv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3fv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3iv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3sv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3ubv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3uiv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor3usv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4bv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4dv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4fv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4iv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4sv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4ubv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4uiv) +ManPageAlias(fglColor3b, $(LIBMANDIR), fglColor4usv) + +LinkFile(fglColorMask.$(MANSUFFIX), fglcolormask.3gl) + +LinkFile(fglColorMaterial.$(MANSUFFIX), fglcolormaterial.3gl) + +LinkFile(fglColorPointer.$(MANSUFFIX), fglcolorpointer.3gl) + +LinkFile(fglCopyPixels.$(MANSUFFIX), fglcopypixels.3gl) + +LinkFile(fglCopyTexImage1D.$(MANSUFFIX), fglcopyteximage1d.3gl) + +LinkFile(fglCopyTexImage2D.$(MANSUFFIX), fglcopyteximage2d.3gl) + +LinkFile(fglCopyTexSubImage1D.$(MANSUFFIX), fglcopytexsubimage1d.3gl) + +LinkFile(fglCopyTexSubImage2D.$(MANSUFFIX), fglcopytexsubimage2d.3gl) + +LinkFile(fglCullFace.$(MANSUFFIX), fglcullface.3gl) + +LinkFile(fglDeleteLists.$(MANSUFFIX), fgldeletelists.3gl) + +LinkFile(fglDeleteTextures.$(MANSUFFIX), fgldeletetextures.3gl) + +LinkFile(fglDepthFunc.$(MANSUFFIX), fgldepthfunc.3gl) + +LinkFile(fglDepthMask.$(MANSUFFIX), fgldepthmask.3gl) + +LinkFile(fglDepthRange.$(MANSUFFIX), fgldepthrange.3gl) + +LinkFile(fglDrawArrays.$(MANSUFFIX), fgldrawarrays.3gl) + +LinkFile(fglDrawBuffer.$(MANSUFFIX), fgldrawbuffer.3gl) + +LinkFile(fglDrawElements.$(MANSUFFIX), fgldrawelements.3gl) + +LinkFile(fglDrawPixels.$(MANSUFFIX), fgldrawpixels.3gl) + +LinkFile(fglEdgeFlag.$(MANSUFFIX), fgledgeflag.3gl) +ManPageAlias(fglEdgeFlag, $(LIBMANDIR), fglEdgeFlagv) + +LinkFile(fglEdgeFlagPointer.$(MANSUFFIX), fgledgeflagpointer.3gl) + +LinkFile(fglEnable.$(MANSUFFIX), fglenable.3gl) +ManPageAlias(fglEnable, $(LIBMANDIR), fglDisable) + +LinkFile(fglEnableClientState.$(MANSUFFIX), fglenableclientstate.3gl) +ManPageAlias(fglEnableClientState, $(LIBMANDIR), fglDisableClientState) + +LinkFile(fglEvalCoord1d.$(MANSUFFIX), fglevalcoord.3gl) +ManPageAlias(fglEvalCoord1d, $(LIBMANDIR), fglEvalCoord1f) +ManPageAlias(fglEvalCoord1d, $(LIBMANDIR), fglEvalCoord2d) +ManPageAlias(fglEvalCoord1d, $(LIBMANDIR), fglEvalCoord2f) +ManPageAlias(fglEvalCoord1d, $(LIBMANDIR), fglEvalCoord1dv) +ManPageAlias(fglEvalCoord1d, $(LIBMANDIR), fglEvalCoord1fv) +ManPageAlias(fglEvalCoord1d, $(LIBMANDIR), fglEvalCoord2dv) +ManPageAlias(fglEvalCoord1d, $(LIBMANDIR), fglEvalCoord2fv) + +LinkFile(fglEvalMesh1.$(MANSUFFIX), fglevalmesh.3gl) +ManPageAlias(fglEvalMesh1, $(LIBMANDIR), fglEvalMesh2) + +LinkFile(fglEvalPoint1.$(MANSUFFIX), fglevalpoint.3gl) +ManPageAlias(fglEvalPoint1, $(LIBMANDIR), fglEvalPoint2) + +LinkFile(fglFeedbackBuffer.$(MANSUFFIX), fglfeedbackbuffer.3gl) + +LinkFile(fglFinish.$(MANSUFFIX), fglfinish.3gl) + +LinkFile(fglFlush.$(MANSUFFIX), fglflush.3gl) + +LinkFile(fglFogf.$(MANSUFFIX), fglfog.3gl) +ManPageAlias(fglFogf, $(LIBMANDIR), fglFogi) +ManPageAlias(fglFogf, $(LIBMANDIR), fglFogfv) +ManPageAlias(fglFogf, $(LIBMANDIR), fglFogiv) + +LinkFile(fglFrontFace.$(MANSUFFIX), fglfrontface.3gl) + +LinkFile(fglFrustum.$(MANSUFFIX), fglfrustum.3gl) + +LinkFile(fglGenLists.$(MANSUFFIX), fglgenlists.3gl) + +LinkFile(fglGenTextures.$(MANSUFFIX), fglgentextures.3gl) + +LinkFile(fglGetBooleanv.$(MANSUFFIX), fglget.3gl) +ManPageAlias(fglGetBooleanv, $(LIBMANDIR), fglGetDoublev) +ManPageAlias(fglGetBooleanv, $(LIBMANDIR), fglGetFloatv) +ManPageAlias(fglGetBooleanv, $(LIBMANDIR), fglGetIntegerv) + +LinkFile(fglGetClipPlane.$(MANSUFFIX), fglgetclipplane.3gl) + +LinkFile(fglGetError.$(MANSUFFIX), fglgeterror.3gl) + +LinkFile(fglGetLightfv.$(MANSUFFIX), fglgetlight.3gl) +ManPageAlias(fglGetLightfv, $(LIBMANDIR), fglGetLightiv) + +LinkFile(fglGetMapdv.$(MANSUFFIX), fglgetmap.3gl) +ManPageAlias(fglGetMapdv, $(LIBMANDIR), fglGetMapfv) +ManPageAlias(fglGetMapdv, $(LIBMANDIR), fglGetMapiv) + +LinkFile(fglGetMaterialfv.$(MANSUFFIX), fglgetmaterial.3gl) +ManPageAlias(fglGetMaterialfv, $(LIBMANDIR), fglGetMaterialiv) + +LinkFile(fglGetPixelMapfv.$(MANSUFFIX), fglgetpixelmap.3gl) +ManPageAlias(fglGetPixelMapfv, $(LIBMANDIR), fglGetPixelMapuiv) +ManPageAlias(fglGetPixelMapfv, $(LIBMANDIR), fglGetPixelMapusv) + +LinkFile(fglGetPointerv.$(MANSUFFIX), fglgetpointerv.3gl) + +LinkFile(fglGetPolygonStipple.$(MANSUFFIX), fglgetpolygonstipple.3gl) + +LinkFile(fglGetString.$(MANSUFFIX), fglgetstring.3gl) + +LinkFile(fglGetTexEnvfv.$(MANSUFFIX), fglgettexenv.3gl) +ManPageAlias(fglGetTexEnvfv, $(LIBMANDIR), fglGetTexEnviv) + +LinkFile(fglGetTexGendv.$(MANSUFFIX), fglgettexgen.3gl) +ManPageAlias(fglGetTexGendv, $(LIBMANDIR), fglGetTexGenfv) +ManPageAlias(fglGetTexGendv, $(LIBMANDIR), fglGetTexGeniv) + +LinkFile(fglGetTexImage.$(MANSUFFIX), fglgetteximage.3gl) + +LinkFile(fglGetTexLevelParameterfv.$(MANSUFFIX), fglgettexlevelparameter.3gl) +ManPageAlias(fglGetTexLevelParameterfv, $(LIBMANDIR), fglGetTexLevelParameteriv) + +LinkFile(fglGetTexParameterfv.$(MANSUFFIX), fglgettexparameter.3gl) +ManPageAlias(fglGetTexParameterfv, $(LIBMANDIR), fglGetTexParameteriv) + +LinkFile(fglHint.$(MANSUFFIX), fglhint.3gl) + +LinkFile(fglIndexd.$(MANSUFFIX), fglindex.3gl) +ManPageAlias(fglIndexd, $(LIBMANDIR), fglIndexf) +ManPageAlias(fglIndexd, $(LIBMANDIR), fglIndexi) +ManPageAlias(fglIndexd, $(LIBMANDIR), fglIndexs) +ManPageAlias(fglIndexd, $(LIBMANDIR), fglIndexub) +ManPageAlias(fglIndexd, $(LIBMANDIR), fglIndexdv) +ManPageAlias(fglIndexd, $(LIBMANDIR), fglIndexfv) +ManPageAlias(fglIndexd, $(LIBMANDIR), fglIndexiv) +ManPageAlias(fglIndexd, $(LIBMANDIR), fglIndexsv) +ManPageAlias(fglIndexd, $(LIBMANDIR), fglIndexubv) + +LinkFile(fglIndexMask.$(MANSUFFIX), fglindexmask.3gl) + +LinkFile(fglIndexPointer.$(MANSUFFIX), fglindexpointer.3gl) + +LinkFile(fglInitNames.$(MANSUFFIX), fglinitnames.3gl) + +LinkFile(fglInterleavedArrays.$(MANSUFFIX), fglinterleavedarrays.3gl) + +LinkFile(fglIsEnabled.$(MANSUFFIX), fglisenabled.3gl) + +LinkFile(fglIsList.$(MANSUFFIX), fglislist.3gl) + +LinkFile(fglIsTexture.$(MANSUFFIX), fglistexture.3gl) + +LinkFile(fglLightf.$(MANSUFFIX), fgllight.3gl) +ManPageAlias(fglLightf, $(LIBMANDIR), fglLighti) +ManPageAlias(fglLightf, $(LIBMANDIR), fglLightfv) +ManPageAlias(fglLightf, $(LIBMANDIR), fglLightiv) + +LinkFile(fglLightModelf.$(MANSUFFIX), fgllightmodel.3gl) +ManPageAlias(fglLightModelf, $(LIBMANDIR), fglLightModeli) +ManPageAlias(fglLightModelf, $(LIBMANDIR), fglLightModelfv) +ManPageAlias(fglLightModelf, $(LIBMANDIR), fglLightModeliv) + +LinkFile(fglLineStipple.$(MANSUFFIX), fgllinestipple.3gl) + +LinkFile(fglLineWidth.$(MANSUFFIX), fgllinewidth.3gl) + +LinkFile(fglListBase.$(MANSUFFIX), fgllistbase.3gl) + +LinkFile(fglLoadIdentity.$(MANSUFFIX), fglloadidentity.3gl) + +LinkFile(fglLoadMatrixd.$(MANSUFFIX), fglloadmatrix.3gl) +ManPageAlias(fglLoadMatrixd, $(LIBMANDIR), fglLoadMatrixf) + +LinkFile(fglLoadName.$(MANSUFFIX), fglloadname.3gl) + +LinkFile(fglLogicOp.$(MANSUFFIX), fgllogicop.3gl) + +LinkFile(fglMap1d.$(MANSUFFIX), fglmap1.3gl) +ManPageAlias(fglMap1d, $(LIBMANDIR), fglMap1f) + +LinkFile(fglMap2d.$(MANSUFFIX), fglmap2.3gl) +ManPageAlias(fglMap2d, $(LIBMANDIR), fglMap2f) + +LinkFile(fglMapGrid1d.$(MANSUFFIX), fglmapgrid.3gl) +ManPageAlias(fglMapGrid1d, $(LIBMANDIR), fglMapGrid1f) +ManPageAlias(fglMapGrid1d, $(LIBMANDIR), fglMapGrid2d) +ManPageAlias(fglMapGrid1d, $(LIBMANDIR), fglMapGrid2f) + +LinkFile(fglMaterialf.$(MANSUFFIX), fglmaterial.3gl) +ManPageAlias(fglMaterialf, $(LIBMANDIR), fglMateriali) +ManPageAlias(fglMaterialf, $(LIBMANDIR), fglMaterialfv) +ManPageAlias(fglMaterialf, $(LIBMANDIR), fglMaterialiv) + +LinkFile(fglMatrixMode.$(MANSUFFIX), fglmatrixmode.3gl) + +LinkFile(fglMultMatrixd.$(MANSUFFIX), fglmultmatrix.3gl) +ManPageAlias(fglMultMatrixd, $(LIBMANDIR), fglMultMatrixf) + +LinkFile(fglNewList.$(MANSUFFIX), fglnewlist.3gl) +ManPageAlias(fglNewList, $(LIBMANDIR), fglEndList) + +LinkFile(fglNormal3b.$(MANSUFFIX), fglnormal.3gl) +ManPageAlias(fglNormal3b, $(LIBMANDIR), fglNormal3d) +ManPageAlias(fglNormal3b, $(LIBMANDIR), fglNormal3f) +ManPageAlias(fglNormal3b, $(LIBMANDIR), fglNormal3i) +ManPageAlias(fglNormal3b, $(LIBMANDIR), fglNormal3s) +ManPageAlias(fglNormal3b, $(LIBMANDIR), fglNormal3bv) +ManPageAlias(fglNormal3b, $(LIBMANDIR), fglNormal3dv) +ManPageAlias(fglNormal3b, $(LIBMANDIR), fglNormal3fv) +ManPageAlias(fglNormal3b, $(LIBMANDIR), fglNormal3iv) +ManPageAlias(fglNormal3b, $(LIBMANDIR), fglNormal3sv) + +LinkFile(fglNormalPointer.$(MANSUFFIX), fglnormalpointer.3gl) + +LinkFile(fglOrtho.$(MANSUFFIX), fglortho.3gl) + +LinkFile(fglPassThrough.$(MANSUFFIX), fglpassthrough.3gl) + +LinkFile(fglPixelMapfv.$(MANSUFFIX), fglpixelmap.3gl) +ManPageAlias(fglPixelMapfv, $(LIBMANDIR), fglPixelMapuiv) +ManPageAlias(fglPixelMapfv, $(LIBMANDIR), fglPixelMapusv) + +LinkFile(fglPixelStoref.$(MANSUFFIX), fglpixelstore.3gl) +ManPageAlias(fglPixelStoref, $(LIBMANDIR), fglPixelStorei) + +LinkFile(fglPixelTransferf.$(MANSUFFIX), fglpixeltransfer.3gl) +ManPageAlias(fglPixelTransferf, $(LIBMANDIR), fglPixelTransferi) + +LinkFile(fglPixelZoom.$(MANSUFFIX), fglpixelzoom.3gl) + +LinkFile(fglPointSize.$(MANSUFFIX), fglpointsize.3gl) + +LinkFile(fglPolygonMode.$(MANSUFFIX), fglpolygonmode.3gl) + +LinkFile(fglPolygonOffset.$(MANSUFFIX), fglpolygonoffset.3gl) + +LinkFile(fglPolygonStipple.$(MANSUFFIX), fglpolygonstipple.3gl) + +LinkFile(fglPrioritizeTextures.$(MANSUFFIX), fglprioritizetextures.3gl) + +LinkFile(fglPushAttrib.$(MANSUFFIX), fglpushattrib.3gl) +ManPageAlias(fglPushAttrib, $(LIBMANDIR), fglPopAttrib) + +LinkFile(fglPushClientAttrib.$(MANSUFFIX), fglpushclientattrib.3gl) +ManPageAlias(fglPushClientAttrib, $(LIBMANDIR), fglPopClientAttrib) + +LinkFile(fglPushMatrix.$(MANSUFFIX), fglpushmatrix.3gl) +ManPageAlias(fglPushMatrix, $(LIBMANDIR), fglPopMatrix) + +LinkFile(fglPushName.$(MANSUFFIX), fglpushname.3gl) +ManPageAlias(fglPushName, $(LIBMANDIR), fglPopName) + +LinkFile(fglRasterPos2d.$(MANSUFFIX), fglrasterpos.3gl) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos2f) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos2i) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos2s) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos3d) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos3f) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos3i) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos3s) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos4d) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos4f) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos4i) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos4s) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos2dv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos2fv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos2iv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos2sv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos3dv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos3fv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos3iv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos3sv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos4dv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos4fv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos4iv) +ManPageAlias(fglRasterPos2d, $(LIBMANDIR), fglRasterPos4sv) + +LinkFile(fglReadBuffer.$(MANSUFFIX), fglreadbuffer.3gl) + +LinkFile(fglReadPixels.$(MANSUFFIX), fglreadpixels.3gl) + +LinkFile(fglRectd.$(MANSUFFIX), fglrect.3gl) +ManPageAlias(fglRectd, $(LIBMANDIR), fglRectf) +ManPageAlias(fglRectd, $(LIBMANDIR), fglRecti) +ManPageAlias(fglRectd, $(LIBMANDIR), fglRects) +ManPageAlias(fglRectd, $(LIBMANDIR), fglRectdv) +ManPageAlias(fglRectd, $(LIBMANDIR), fglRectfv) +ManPageAlias(fglRectd, $(LIBMANDIR), fglRectiv) +ManPageAlias(fglRectd, $(LIBMANDIR), fglRectsv) + +LinkFile(fglRenderMode.$(MANSUFFIX), fglrendermode.3gl) + +LinkFile(fglRotated.$(MANSUFFIX), fglrotate.3gl) +ManPageAlias(fglRotated, $(LIBMANDIR), fglRotatef) + +LinkFile(fglScaled.$(MANSUFFIX), fglscale.3gl) +ManPageAlias(fglScaled, $(LIBMANDIR), fglScalef) + +LinkFile(fglScissor.$(MANSUFFIX), fglscissor.3gl) + +LinkFile(fglSelectBuffer.$(MANSUFFIX), fglselectbuffer.3gl) + +LinkFile(fglShadeModel.$(MANSUFFIX), fglshademodel.3gl) + +LinkFile(fglStencilFunc.$(MANSUFFIX), fglstencilfunc.3gl) + +LinkFile(fglStencilMask.$(MANSUFFIX), fglstencilmask.3gl) + +LinkFile(fglStencilOp.$(MANSUFFIX), fglstencilop.3gl) + +LinkFile(fglTexCoord1d.$(MANSUFFIX), fgltexcoord.3gl) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord1f) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord1i) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord1s) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord2d) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord2f) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord2i) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord2s) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord3d) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord3f) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord3i) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord3s) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord4d) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord4f) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord4i) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord4s) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord1dv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord1fv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord1iv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord1sv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord2dv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord2fv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord2iv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord2sv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord3dv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord3fv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord3iv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord3sv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord4dv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord4fv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord4iv) +ManPageAlias(fglTexCoord1d, $(LIBMANDIR), fglTexCoord4sv) + +LinkFile(fglTexCoordPointer.$(MANSUFFIX), fgltexcoordpointer.3gl) + +LinkFile(fglTexEnvf.$(MANSUFFIX), fgltexenv.3gl) +ManPageAlias(fglTexEnvf, $(LIBMANDIR), fglTexEnvi) +ManPageAlias(fglTexEnvf, $(LIBMANDIR), fglTexEnvfv) +ManPageAlias(fglTexEnvf, $(LIBMANDIR), fglTexEnviv) + +LinkFile(fglTexGend.$(MANSUFFIX), fgltexgen.3gl) +ManPageAlias(fglTexGend, $(LIBMANDIR), fglTexGenf) +ManPageAlias(fglTexGend, $(LIBMANDIR), fglTexGeni) +ManPageAlias(fglTexGend, $(LIBMANDIR), fglTexGendv) +ManPageAlias(fglTexGend, $(LIBMANDIR), fglTexGenfv) +ManPageAlias(fglTexGend, $(LIBMANDIR), fglTexGeniv) + +LinkFile(fglTexImage1D.$(MANSUFFIX), fglteximage1d.3gl) + +LinkFile(fglTexImage2D.$(MANSUFFIX), fglteximage2d.3gl) + +LinkFile(fglTexParameterf.$(MANSUFFIX), fgltexparameter.3gl) +ManPageAlias(fglTexParameterf, $(LIBMANDIR), fglTexParameteri) +ManPageAlias(fglTexParameterf, $(LIBMANDIR), fglTexParameterfv) +ManPageAlias(fglTexParameterf, $(LIBMANDIR), fglTexParameteriv) + +LinkFile(fglTexSubImage1D.$(MANSUFFIX), fgltexsubimage1d.3gl) + +LinkFile(fglTexSubImage2D.$(MANSUFFIX), fgltexsubimage2d.3gl) + +LinkFile(fglTranslated.$(MANSUFFIX), fgltranslate.3gl) +ManPageAlias(fglTranslated, $(LIBMANDIR), fglTranslatef) + +LinkFile(fglVertex2d.$(MANSUFFIX), fglvertex.3gl) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex2f) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex2i) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex2s) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex3d) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex3f) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex3i) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex3s) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex4d) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex4f) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex4i) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex4s) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex2dv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex2fv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex2iv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex2sv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex3dv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex3fv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex3iv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex3sv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex4dv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex4fv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex4iv) +ManPageAlias(fglVertex2d, $(LIBMANDIR), fglVertex4sv) + +LinkFile(fglVertexPointer.$(MANSUFFIX), fglvertexpointer.3gl) + +LinkFile(fglViewport.$(MANSUFFIX), fglviewport.3gl) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/f b/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/f new file mode 100644 index 000000000..c4b555609 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/ftn/f @@ -0,0 +1 @@ +.Op + f diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/html/Distfile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/html/Distfile new file mode 100644 index 000000000..eaf57c21f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/html/Distfile @@ -0,0 +1,141 @@ +# +# + +DISTDIR_SI = /xc/doc/hardcopy/GL/html/gl + +DISTFILES_SI = \ + accum.html \ + alphafunc.html \ + aretexturesresident.html \ + arrayelement.html \ + begin.html \ + bindtexture.html \ + bitmap.html \ + blendfunc.html \ + calllist.html \ + calllists.html \ + clear.html \ + clearaccum.html \ + clearcolor.html \ + cleardepth.html \ + clearindex.html \ + clearstencil.html \ + clipplane.html \ + color.html \ + colormask.html \ + colormaterial.html \ + colorpointer.html \ + copypixels.html \ + copyteximage1d.html \ + copyteximage2d.html \ + copytexsubimage1d.html \ + copytexsubimage2d.html \ + cullface.html \ + deletelists.html \ + deletetextures.html \ + depthfunc.html \ + depthmask.html \ + depthrange.html \ + drawarrays.html \ + drawbuffer.html \ + drawelements.html \ + drawpixels.html \ + edgeflag.html \ + edgeflagpointer.html \ + enable.html \ + enableclientstate.html \ + evalcoord.html \ + evalmesh.html \ + evalpoint.html \ + feedbackbuffer.html \ + finish.html \ + flush.html \ + fog.html \ + frontface.html \ + frustum.html \ + genlists.html \ + gentextures.html \ + get.html \ + getclipplane.html \ + geterror.html \ + getlight.html \ + getmap.html \ + getmaterial.html \ + getpixelmap.html \ + getpointerv.html \ + getpolygonstipple.html \ + getstring.html \ + gettexenv.html \ + gettexgen.html \ + getteximage.html \ + gettexlevelparameter.html \ + gettexparameter.html \ + hint.html \ + index.html \ + indexmask.html \ + indexpointer.html \ + initnames.html \ + interleavedarrays.html \ + isenabled.html \ + islist.html \ + istexture.html \ + light.html \ + lightmodel.html \ + linestipple.html \ + linewidth.html \ + listbase.html \ + loadidentity.html \ + loadmatrix.html \ + loadname.html \ + logicop.html \ + map1.html \ + map2.html \ + mapgrid.html \ + material.html \ + matrixmode.html \ + multmatrix.html \ + newlist.html \ + normal.html \ + normalpointer.html \ + ortho.html \ + passthrough.html \ + pixelmap.html \ + pixelstore.html \ + pixeltransfer.html \ + pixelzoom.html \ + pointsize.html \ + polygonmode.html \ + polygonoffset.html \ + polygonstipple.html \ + prioritizetextures.html \ + pushattrib.html \ + pushclientattrib.html \ + pushmatrix.html \ + pushname.html \ + rasterpos.html \ + readbuffer.html \ + readpixels.html \ + rect.html \ + rendermode.html \ + rotate.html \ + scale.html \ + scissor.html \ + selectbuffer.html \ + shademodel.html \ + stencilfunc.html \ + stencilmask.html \ + stencilop.html \ + texcoord.html \ + texcoordpointer.html \ + texenv.html \ + texgen.html \ + teximage1d.html \ + teximage2d.html \ + texparameter.html \ + texsubimage1d.html \ + texsubimage2d.html \ + translate.html \ + vertex.html \ + vertexpointer.html \ + viewport.html \ + $(NULL) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/html/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/html/GNUmakefile new file mode 100644 index 000000000..996e64ab7 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/html/GNUmakefile @@ -0,0 +1,67 @@ +#!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. +# + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +DEPTH = ../.. +LANGOPT = c +PREFIX = gl +MANSRC = ../standard + +MANPREF = man +include $(DEPTH)/mandefs + +# Dependencies are in the man page source directory +VPATH = $(shell cd $(MANSRC) ; pwd) + +default: + $(MAKE) html + +headers headers_install libs libs_install install apps: + +distsi: default + $(MAKE) $(COMMONPREF)$@ + +distoss: + $(MAKE) $(COMMONPREF)$@ + +html: $(patsubst %.3gl,%.html,$(notdir $(wildcard $(MANSRC)/*.3gl))) + +clobber: + rm -rf *.html + +include $(DEPTH)/manrules +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/html_ftn/Distfile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/html_ftn/Distfile new file mode 100644 index 000000000..18d86d2cf --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/html_ftn/Distfile @@ -0,0 +1,141 @@ +# +# + +DISTDIR_SI = /xc/doc/hardcopy/GL/html/gl_ftn + +DISTFILES_SI = \ + fglaccum.html \ + fglalphafunc.html \ + fglaretexturesresident.html \ + fglarrayelement.html \ + fglbegin.html \ + fglbindtexture.html \ + fglbitmap.html \ + fglblendfunc.html \ + fglcalllist.html \ + fglcalllists.html \ + fglclear.html \ + fglclearaccum.html \ + fglclearcolor.html \ + fglcleardepth.html \ + fglclearindex.html \ + fglclearstencil.html \ + fglclipplane.html \ + fglcolor.html \ + fglcolormask.html \ + fglcolormaterial.html \ + fglcolorpointer.html \ + fglcopypixels.html \ + fglcopyteximage1d.html \ + fglcopyteximage2d.html \ + fglcopytexsubimage1d.html \ + fglcopytexsubimage2d.html \ + fglcullface.html \ + fgldeletelists.html \ + fgldeletetextures.html \ + fgldepthfunc.html \ + fgldepthmask.html \ + fgldepthrange.html \ + fgldrawarrays.html \ + fgldrawbuffer.html \ + fgldrawelements.html \ + fgldrawpixels.html \ + fgledgeflag.html \ + fgledgeflagpointer.html \ + fglenable.html \ + fglenableclientstate.html \ + fglevalcoord.html \ + fglevalmesh.html \ + fglevalpoint.html \ + fglfeedbackbuffer.html \ + fglfinish.html \ + fglflush.html \ + fglfog.html \ + fglfrontface.html \ + fglfrustum.html \ + fglgenlists.html \ + fglgentextures.html \ + fglget.html \ + fglgetclipplane.html \ + fglgeterror.html \ + fglgetlight.html \ + fglgetmap.html \ + fglgetmaterial.html \ + fglgetpixelmap.html \ + fglgetpointerv.html \ + fglgetpolygonstipple.html \ + fglgetstring.html \ + fglgettexenv.html \ + fglgettexgen.html \ + fglgetteximage.html \ + fglgettexlevelparameter.html \ + fglgettexparameter.html \ + fglhint.html \ + fglindex.html \ + fglindexmask.html \ + fglindexpointer.html \ + fglinitnames.html \ + fglinterleavedarrays.html \ + fglisenabled.html \ + fglislist.html \ + fglistexture.html \ + fgllight.html \ + fgllightmodel.html \ + fgllinestipple.html \ + fgllinewidth.html \ + fgllistbase.html \ + fglloadidentity.html \ + fglloadmatrix.html \ + fglloadname.html \ + fgllogicop.html \ + fglmap1.html \ + fglmap2.html \ + fglmapgrid.html \ + fglmaterial.html \ + fglmatrixmode.html \ + fglmultmatrix.html \ + fglnewlist.html \ + fglnormal.html \ + fglnormalpointer.html \ + fglortho.html \ + fglpassthrough.html \ + fglpixelmap.html \ + fglpixelstore.html \ + fglpixeltransfer.html \ + fglpixelzoom.html \ + fglpointsize.html \ + fglpolygonmode.html \ + fglpolygonoffset.html \ + fglpolygonstipple.html \ + fglprioritizetextures.html \ + fglpushattrib.html \ + fglpushclientattrib.html \ + fglpushmatrix.html \ + fglpushname.html \ + fglrasterpos.html \ + fglreadbuffer.html \ + fglreadpixels.html \ + fglrect.html \ + fglrendermode.html \ + fglrotate.html \ + fglscale.html \ + fglscissor.html \ + fglselectbuffer.html \ + fglshademodel.html \ + fglstencilfunc.html \ + fglstencilmask.html \ + fglstencilop.html \ + fgltexcoord.html \ + fgltexcoordpointer.html \ + fgltexenv.html \ + fgltexgen.html \ + fglteximage1d.html \ + fglteximage2d.html \ + fgltexparameter.html \ + fgltexsubimage1d.html \ + fgltexsubimage2d.html \ + fgltranslate.html \ + fglvertex.html \ + fglvertexpointer.html \ + fglviewport.html \ + $(NULL) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/html_ftn/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/mangl/html_ftn/GNUmakefile new file mode 100644 index 000000000..b00948d05 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/html_ftn/GNUmakefile @@ -0,0 +1,67 @@ +#!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. +# + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +DEPTH = ../.. +LANGOPT = c +PREFIX = gl +MANSRC = ../ftn + +MANPREF = man +include $(DEPTH)/mandefs + +# Dependencies are in the man page source directory +VPATH = $(shell cd $(MANSRC) ; pwd) + +default: + $(MAKE) html + +headers headers_install libs libs_install install apps: + +distsi: default + $(MAKE) $(COMMONPREF)$@ + +distoss: + $(MAKE) $(COMMONPREF)$@ + +html: $(patsubst %.3gl,%.html,$(notdir $(wildcard $(MANSRC)/*.3gl))) + +clobber: + rm -rf *.html + +include $(DEPTH)/manrules +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/pages b/nx-X11/extras/ogl-sample/main/doc/man/mangl/pages new file mode 100644 index 000000000..338d5e260 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/pages @@ -0,0 +1,105 @@ +Each line corresponds to a single manpage text body. +Lines with comma-separated command names, and with the +parenthetical (both share one page description, two +entry points) do just that: they share a single text +body, but have multiple instantiations. Lines with +comma-separated command names, and with the +parenthetical (one page, one entry point) simply share +a single page. + +Accum +AlphaFunc +Begin, End (both share one page description, two entry points) +Bitmap +BlendFunc +CallList, CallLists (one page, one entry point) +Clear +ClearAccum +ClearColor +ClearDepth +ClearIndex +ClearStencil +ClipPlane +Color, Colorv (one page, one entry point) +ColorMask +ColorMaterial +CopyPixels +CullFace +DeleteList +DepthFunc +DepthRange +Disable, Enable (both share one page description, two entry points) +DrawBuffer +DrawPixels +EdgeFlag, EdgeFlagv (one page, one entry point) +EvalCoord, EvalCoordv (one page, one entry point) +EvalMesh +EvalPoint +FeedbackBuffer +Finish +Flush +Fogv +FrontFace +Frustum +GenLists +GetClipPlane +GetImage +GetLightv +GetMapv +GetMaterialv +GetTexEnvv +GetTexGenv +Getv +Hint +IndexMask +Index, Indexv (one page, one entry point) +InitNames +IsEnabled +IsList +LightModelv +Lightv +LineStipple +LineWidth +ListBase +LoadMatrix +LoadName +LogicOp +Map1, Map2 (one page, one entry point) +MapGrid1, MapGrid2 (one page, one entry point) +Materialv +MatrixMode +MultMatrix +NewList, EndList (both share one page description, two entry points) +Normal, Normalv (one page, one entry point) +Ortho +PassThrough +PixelMap +PixelStore +PixelTransfer +PointSize +PolygonMode +PolygonStipple +PushAttrib, PopAttrib (both share one page description, two entry points) +PushMatrix, PopMatrix (both share one page description, two entry points) +PushName, PopName (both share one page description, two entry points) +RasterPos, RasterPosv (one page, one entry point) +ReadPixels +ReadSource +Rect, Rectv (one page, one entry point) +RenderMode +Rotate +Scale +Scissor +SelectBuffer +ShadeModel +StencilFunc +StencilMask +StencilOp +TexCoord, TexCoordv (one page, one entry point) +TexEnvv +TexGenv +TexImage1d, TexImage2d (one page, one entry point) +TexParameter +Translate +Vertex, Vertexv (one page, one entry point) +Viewport 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) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/style b/nx-X11/extras/ogl-sample/main/doc/man/mangl/style new file mode 100644 index 000000000..0624efff2 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/style @@ -0,0 +1,4 @@ +The template gives the basic style. + +Don't use 'expects' in paramter descriptions; doing so will make Mark +unresponsible for his actions. diff --git a/nx-X11/extras/ogl-sample/main/doc/man/mangl/template b/nx-X11/extras/ogl-sample/main/doc/man/mangl/template new file mode 100644 index 000000000..204270b4f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/mangl/template @@ -0,0 +1,86 @@ +_C_ The first character in this file must be an '_'! +_C_ Anything on a line after _C_ is ignored +_C_ +_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_ +_C_ _define(_filters,tbl|eqn)_C_ +_C_ eqn is automatically replaced with neqn for nroff +_C_ +_C_ Uncomment the next line if you need a different basename +_C_ _define(@<_basename>@,specialName)_C_ +_C_ +_C_ Uncomment the next line if you want to change the 'same command' message +_C_ _define(@<_samething>@,All these commands do the same thing.)_C_ +_C_ +_header(Color,one line description of command) +_names(color,[0-9]u*[bsifd]) +.SH PARAMETERS +_phead(_param1) +Description of first parameter to _cmnd +_phead(_param2) +Description of second parameter +... +_phead(_paramN) +Description of last parameter +_names(color,[0-9]u*[bsifd]v) +.SH PARAMETERS +_phead(_param1) +Description of 1st parameter of the second command form +_samething +.SH DESCRIPTION +This command does something related to the GL. +Its name is _cmnd. +_param1 is the 1st argument for the last specified command form. +So is (in this case) _param1(2). +_param1(1) is the 1st parameter +of the first command form of _cmnd. +.SH EXAMPLES +.Ex 5 + _cmnd\&(_param1, _param2, _paramN); /* Do something */ +.SH NOTES +Use of the arguments _const(SILLY_VALUE) or _hex(ffe) may cause drowsiness. +.SH ERRORS +This command may cause errors. They cannot be detected. +.SH ASSOCIATED GETS +call foo with argument bar +.br +call foo2 with argument bar2 +.SH SEE ALSO +_cmnd(c), +_cmnd(clear), +_cmnd(drawbitmap), +_cmnd(n), +_cmnd(v) +.SH BUGS +_cmnd is not actually implemented. diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/GNUmakefile new file mode 100644 index 000000000..a1f8b2490 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/GNUmakefile @@ -0,0 +1,55 @@ +#!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. +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manglu/GNUmakefile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +SUBDIRS = \ + standard \ + ftn \ + html \ + html_ftn \ + $(NULL) + +default $(ALLTARGS): $(_FORCE) + $(SUBDIRS_MAKERULE) + +distoss: + $(MAKE) $(COMMONPREF)$@ + $(SUBDIRS_MAKERULE) + +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/Distfile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/Distfile new file mode 100644 index 000000000..6fcfa4df4 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/Distfile @@ -0,0 +1,64 @@ +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manglu/ftn/Distfile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ +# + +DISTDIR_SI = /xc/doc/man/GL/glu_ftn + +DISTFILES_SI = \ + Imakefile \ + fglubegincurve.3gl \ + fglubeginpolygon.3gl \ + fglubeginsurface.3gl \ + fglubegintrim.3gl \ + fglubuild1dmipmaplevels.3gl \ + fglubuild1dmipmaps.3gl \ + fglubuild2dmipmaplevels.3gl \ + fglubuild2dmipmaps.3gl \ + fglubuild3dmipmaplevels.3gl \ + fglubuild3dmipmaps.3gl \ + fglucheckextension.3gl \ + fglucylinder.3gl \ + fgludeletenurbsrenderer.3gl \ + fgludeletequadric.3gl \ + fgludeletetess.3gl \ + fgludisk.3gl \ + fgluerrorstring.3gl \ + fglugetnurbsproperty.3gl \ + fglugetstring.3gl \ + fglugettessproperty.3gl \ + fgluloadsamplingmatrices.3gl \ + fglulookat.3gl \ + fglunewnurbsrenderer.3gl \ + fglunewquadric.3gl \ + fglunewtess.3gl \ + fglunextcontour.3gl \ + fglunurbscallback.3gl \ + fglunurbscallbackdata.3gl \ + fglunurbscallbackdataext.3gl \ + fglunurbscurve.3gl \ + fglunurbsproperty.3gl \ + fglunurbssurface.3gl \ + fgluortho2d.3gl \ + fglupartialdisk.3gl \ + fgluperspective.3gl \ + fglupickmatrix.3gl \ + fgluproject.3gl \ + fglupwlcurve.3gl \ + fgluquadriccallback.3gl \ + fgluquadricdrawstyle.3gl \ + fgluquadricnormals.3gl \ + fgluquadricorientation.3gl \ + fgluquadrictexture.3gl \ + fgluscaleimage.3gl \ + fglusphere.3gl \ + fglutessbegincontour.3gl \ + fglutessbeginpolygon.3gl \ + fglutesscallback.3gl \ + fglutessendpolygon.3gl \ + fglutessnormal.3gl \ + fglutessproperty.3gl \ + fglutessvertex.3gl \ + fgluunproject.3gl \ + fgluunproject4.3gl \ + $(NULL) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/GNUmakefile new file mode 100644 index 000000000..7b60d2835 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/GNUmakefile @@ -0,0 +1,102 @@ +#!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. +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manglu/ftn/GNUmakefile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ + +# 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 = f +PREFIX = glu +IDB_PATH = /usr/catman/g_man/cat3/standard + +MANPREF = man +include $(DEPTH)/mandefs + +APIFILE = $(ROOT)/usr/include/GL/glu.h + +VERSION = Version 1.2 +DATE = 10 Nov 1998 +RELEASE = 1.0 +MMFLAGS = -rs2 + +LEGALSUF1 = gl# +LEGALSUF2 = gl# +LEGALSUF3 = gl# +LEGALSUF4 = gl# + +LOCALPRINTLISTFILTER = | sed -e '/^intro\.p$$/d' | (echo intro.p ; cat ) + +default: + $(MAKE) links + $(MAKE) manpages + +headers headers_install libs libs_install install apps: + +distsi: default + $(MAKE) $(COMMONPREF)$@ + +distoss: + $(MAKE) $(COMMONPREF)$@ + +links: + cd ../standard ; \ + for i in *.gl ; do \ + ( cd ../ftn ; if test ! -L fglu$$i ; then \ + /bin/ln -s ../standard/$$i fglu$$i; fi ) ; \ + done + +manpages: $(patsubst %.gl,%.3gl,$(wildcard *.gl)) + +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 + +clean: + rm -f *.gl + +clobber: clean + rm -f *.3gl + +include $(DEPTH)/manrules +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/Imakefile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/Imakefile new file mode 100644 index 000000000..f321c491f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/Imakefile @@ -0,0 +1,216 @@ +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 = \ +fgluBeginCurve.$(MANSUFFIX) fgluBeginPolygon.$(MANSUFFIX) \ +fgluBeginSurface.$(MANSUFFIX) fgluBeginTrim.$(MANSUFFIX) \ +fgluBuild1DMipmaps.$(MANSUFFIX) fgluBuild2DMipmaps.$(MANSUFFIX) \ +fgluCylinder.$(MANSUFFIX) fgluDeleteNurbsRenderer.$(MANSUFFIX) \ +fgluDeleteQuadric.$(MANSUFFIX) fgluDeleteTess.$(MANSUFFIX) \ +fgluDisk.$(MANSUFFIX) fgluEndCurve.$(MANSUFFIX) \ +fgluEndPolygon.$(MANSUFFIX) fgluEndSurface.$(MANSUFFIX) \ +fgluEndTrim.$(MANSUFFIX) fgluErrorString.$(MANSUFFIX) \ +fgluGetNurbsProperty.$(MANSUFFIX) fgluGetString.$(MANSUFFIX) \ +fgluGetTessProperty.$(MANSUFFIX) fgluLoadSamplingMatrices.$(MANSUFFIX) \ +fgluLookAt.$(MANSUFFIX) fgluNewNurbsRenderer.$(MANSUFFIX) \ +fgluNewQuadric.$(MANSUFFIX) fgluNewTess.$(MANSUFFIX) \ +fgluNextContour.$(MANSUFFIX) fgluNurbsCallback.$(MANSUFFIX) \ +fgluNurbsCallbackDataEXT.$(MANSUFFIX) fgluNurbsCurve.$(MANSUFFIX) \ +fgluNurbsProperty.$(MANSUFFIX) fgluNurbsSurface.$(MANSUFFIX) \ +fgluOrtho2D.$(MANSUFFIX) fgluPartialDisk.$(MANSUFFIX) \ +fgluPerspective.$(MANSUFFIX) fgluPickMatrix.$(MANSUFFIX) \ +fgluProject.$(MANSUFFIX) fgluPwlCurve.$(MANSUFFIX) \ +fgluQuadricCallback.$(MANSUFFIX) fgluQuadricDrawStyle.$(MANSUFFIX) \ +fgluQuadricNormals.$(MANSUFFIX) fgluQuadricOrientation.$(MANSUFFIX) \ +fgluQuadricTexture.$(MANSUFFIX) fgluScaleImage.$(MANSUFFIX) \ +fgluSphere.$(MANSUFFIX) fgluTessBeginContour.$(MANSUFFIX) \ +fgluTessBeginPolygon.$(MANSUFFIX) fgluTessCallback.$(MANSUFFIX) \ +fgluTessEndContour.$(MANSUFFIX) fgluTessEndPolygon.$(MANSUFFIX) \ +fgluTessNormal.$(MANSUFFIX) fgluTessProperty.$(MANSUFFIX) \ +fgluTessVertex.$(MANSUFFIX) fgluUnProject.$(MANSUFFIX) + +LINK_NAMES = \ +fgluBeginCurve.$(MANSUFFIX) fgluBeginPolygon.$(MANSUFFIX) \ +fgluBeginSurface.$(MANSUFFIX) fgluBeginTrim.$(MANSUFFIX) \ +fgluBuild1DMipmaps.$(MANSUFFIX) fgluBuild2DMipmaps.$(MANSUFFIX) \ +fgluCylinder.$(MANSUFFIX) fgluDeleteNurbsRenderer.$(MANSUFFIX) \ +fgluDeleteQuadric.$(MANSUFFIX) fgluDeleteTess.$(MANSUFFIX) \ +fgluDisk.$(MANSUFFIX) fgluErrorString.$(MANSUFFIX) \ +fgluGetNurbsProperty.$(MANSUFFIX) fgluGetString.$(MANSUFFIX) \ +fgluGetTessProperty.$(MANSUFFIX) fgluLoadSamplingMatrices.$(MANSUFFIX) \ +fgluLookAt.$(MANSUFFIX) fgluNewNurbsRenderer.$(MANSUFFIX) \ +fgluNewQuadric.$(MANSUFFIX) fgluNewTess.$(MANSUFFIX) \ +fgluNextContour.$(MANSUFFIX) fgluNurbsCallback.$(MANSUFFIX) \ +fgluNurbsCallbackDataEXT.$(MANSUFFIX) fgluNurbsCurve.$(MANSUFFIX) \ +fgluNurbsProperty.$(MANSUFFIX) fgluNurbsSurface.$(MANSUFFIX) \ +fgluOrtho2D.$(MANSUFFIX) fgluPartialDisk.$(MANSUFFIX) \ +fgluPerspective.$(MANSUFFIX) fgluPickMatrix.$(MANSUFFIX) \ +fgluProject.$(MANSUFFIX) fgluPwlCurve.$(MANSUFFIX) \ +fgluQuadricCallback.$(MANSUFFIX) fgluQuadricDrawStyle.$(MANSUFFIX) \ +fgluQuadricNormals.$(MANSUFFIX) fgluQuadricOrientation.$(MANSUFFIX) \ +fgluQuadricTexture.$(MANSUFFIX) fgluScaleImage.$(MANSUFFIX) \ +fgluSphere.$(MANSUFFIX) fgluTessBeginContour.$(MANSUFFIX) \ +fgluTessBeginPolygon.$(MANSUFFIX) fgluTessCallback.$(MANSUFFIX) \ +fgluTessEndPolygon.$(MANSUFFIX) fgluTessNormal.$(MANSUFFIX) \ +fgluTessProperty.$(MANSUFFIX) fgluTessVertex.$(MANSUFFIX) \ +fgluUnProject.$(MANSUFFIX) + +ALIAS_NAMES = \ +fgluEndCurve.$(MANSUFFIX) fgluEndPolygon.$(MANSUFFIX) \ +fgluEndSurface.$(MANSUFFIX) fgluEndTrim.$(MANSUFFIX) \ +fgluTessEndContour.$(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(fgluBeginCurve.$(MANSUFFIX), fglubegincurve.3gl) +ManPageAlias(fgluBeginCurve, $(LIBMANDIR), fgluEndCurve) + +LinkFile(fgluBeginPolygon.$(MANSUFFIX), fglubeginpolygon.3gl) +ManPageAlias(fgluBeginPolygon, $(LIBMANDIR), fgluEndPolygon) + +LinkFile(fgluBeginSurface.$(MANSUFFIX), fglubeginsurface.3gl) +ManPageAlias(fgluBeginSurface, $(LIBMANDIR), fgluEndSurface) + +LinkFile(fgluBeginTrim.$(MANSUFFIX), fglubegintrim.3gl) +ManPageAlias(fgluBeginTrim, $(LIBMANDIR), fgluEndTrim) + +LinkFile(fgluBuild1DMipmaps.$(MANSUFFIX), fglubuild1dmipmaps.3gl) + +LinkFile(fgluBuild2DMipmaps.$(MANSUFFIX), fglubuild2dmipmaps.3gl) + +LinkFile(fgluCylinder.$(MANSUFFIX), fglucylinder.3gl) + +LinkFile(fgluDeleteNurbsRenderer.$(MANSUFFIX), fgludeletenurbsrenderer.3gl) + +LinkFile(fgluDeleteQuadric.$(MANSUFFIX), fgludeletequadric.3gl) + +LinkFile(fgluDeleteTess.$(MANSUFFIX), fgludeletetess.3gl) + +LinkFile(fgluDisk.$(MANSUFFIX), fgludisk.3gl) + +LinkFile(fgluErrorString.$(MANSUFFIX), fgluerrorstring.3gl) + +LinkFile(fgluGetNurbsProperty.$(MANSUFFIX), fglugetnurbsproperty.3gl) + +LinkFile(fgluGetString.$(MANSUFFIX), fglugetstring.3gl) + +LinkFile(fgluGetTessProperty.$(MANSUFFIX), fglugettessproperty.3gl) + +LinkFile(fgluLoadSamplingMatrices.$(MANSUFFIX), fgluloadsamplingmatrices.3gl) + +LinkFile(fgluLookAt.$(MANSUFFIX), fglulookat.3gl) + +LinkFile(fgluNewNurbsRenderer.$(MANSUFFIX), fglunewnurbsrenderer.3gl) + +LinkFile(fgluNewQuadric.$(MANSUFFIX), fglunewquadric.3gl) + +LinkFile(fgluNewTess.$(MANSUFFIX), fglunewtess.3gl) + +LinkFile(fgluNextContour.$(MANSUFFIX), fglunextcontour.3gl) + +LinkFile(fgluNurbsCallback.$(MANSUFFIX), fglunurbscallback.3gl) + +LinkFile(fgluNurbsCallbackDataEXT.$(MANSUFFIX), fglunurbscallbackdataext.3gl) + +LinkFile(fgluNurbsCurve.$(MANSUFFIX), fglunurbscurve.3gl) + +LinkFile(fgluNurbsProperty.$(MANSUFFIX), fglunurbsproperty.3gl) + +LinkFile(fgluNurbsSurface.$(MANSUFFIX), fglunurbssurface.3gl) + +LinkFile(fgluOrtho2D.$(MANSUFFIX), fgluortho2d.3gl) + +LinkFile(fgluPartialDisk.$(MANSUFFIX), fglupartialdisk.3gl) + +LinkFile(fgluPerspective.$(MANSUFFIX), fgluperspective.3gl) + +LinkFile(fgluPickMatrix.$(MANSUFFIX), fglupickmatrix.3gl) + +LinkFile(fgluProject.$(MANSUFFIX), fgluproject.3gl) + +LinkFile(fgluPwlCurve.$(MANSUFFIX), fglupwlcurve.3gl) + +LinkFile(fgluQuadricCallback.$(MANSUFFIX), fgluquadriccallback.3gl) + +LinkFile(fgluQuadricDrawStyle.$(MANSUFFIX), fgluquadricdrawstyle.3gl) + +LinkFile(fgluQuadricNormals.$(MANSUFFIX), fgluquadricnormals.3gl) + +LinkFile(fgluQuadricOrientation.$(MANSUFFIX), fgluquadricorientation.3gl) + +LinkFile(fgluQuadricTexture.$(MANSUFFIX), fgluquadrictexture.3gl) + +LinkFile(fgluScaleImage.$(MANSUFFIX), fgluscaleimage.3gl) + +LinkFile(fgluSphere.$(MANSUFFIX), fglusphere.3gl) + +LinkFile(fgluTessBeginContour.$(MANSUFFIX), fglutessbegincontour.3gl) +ManPageAlias(fgluTessBeginContour, $(LIBMANDIR), fgluTessEndContour) + +LinkFile(fgluTessBeginPolygon.$(MANSUFFIX), fglutessbeginpolygon.3gl) + +LinkFile(fgluTessCallback.$(MANSUFFIX), fglutesscallback.3gl) + +LinkFile(fgluTessEndPolygon.$(MANSUFFIX), fglutessendpolygon.3gl) + +LinkFile(fgluTessNormal.$(MANSUFFIX), fglutessnormal.3gl) + +LinkFile(fgluTessProperty.$(MANSUFFIX), fglutessproperty.3gl) + +LinkFile(fgluTessVertex.$(MANSUFFIX), fglutessvertex.3gl) + +LinkFile(fgluUnProject.$(MANSUFFIX), fgluunproject.3gl) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/f b/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/f new file mode 100644 index 000000000..c4b555609 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/ftn/f @@ -0,0 +1 @@ +.Op + f diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/html/Distfile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/html/Distfile new file mode 100644 index 000000000..869ea4279 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/html/Distfile @@ -0,0 +1,63 @@ +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manglu/html/Distfile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ +# + +DISTDIR_SI = /xc/doc/hardcopy/GL/html/glu + +DISTFILES_SI = \ + begincurve.html \ + beginpolygon.html \ + beginsurface.html \ + begintrim.html \ + build1dmipmaplevels.html \ + build1dmipmaps.html \ + build2dmipmaplevels.html \ + build2dmipmaps.html \ + build3dmipmaplevels.html \ + build3dmipmaps.html \ + checkextension.html \ + cylinder.html \ + deletenurbsrenderer.html \ + deletequadric.html \ + deletetess.html \ + disk.html \ + errorstring.html \ + getnurbsproperty.html \ + getstring.html \ + gettessproperty.html \ + loadsamplingmatrices.html \ + lookat.html \ + newnurbsrenderer.html \ + newquadric.html \ + newtess.html \ + nextcontour.html \ + nurbscallback.html \ + nurbscallbackdata.html \ + nurbscallbackdataext.html \ + nurbscurve.html \ + nurbsproperty.html \ + nurbssurface.html \ + ortho2d.html \ + partialdisk.html \ + perspective.html \ + pickmatrix.html \ + project.html \ + pwlcurve.html \ + quadriccallback.html \ + quadricdrawstyle.html \ + quadricnormals.html \ + quadricorientation.html \ + quadrictexture.html \ + scaleimage.html \ + sphere.html \ + tessbegincontour.html \ + tessbeginpolygon.html \ + tesscallback.html \ + tessendpolygon.html \ + tessnormal.html \ + tessproperty.html \ + tessvertex.html \ + unproject.html \ + unproject4.html \ + $(NULL) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/html/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/html/GNUmakefile new file mode 100644 index 000000000..951e81e4f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/html/GNUmakefile @@ -0,0 +1,68 @@ +#!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. +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manglu/html/GNUmakefile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +DEPTH = ../.. +LANGOPT = c +PREFIX = gl +MANSRC = ../standard + +MANPREF = man +include $(DEPTH)/mandefs + +VPATH = $(shell cd $(MANSRC) ; pwd) + +default: + $(MAKE) html + +headers headers_install libs libs_install install apps: + +distsi: default + $(MAKE) $(COMMONPREF)$@ + +distoss: + $(MAKE) $(COMMONPREF)$@ + +html: $(patsubst %.3gl,%.html,$(notdir $(wildcard $(MANSRC)/*.3gl))) + +clobber: + rm -rf *.html + +include $(DEPTH)/manrules +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/html_ftn/Distfile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/html_ftn/Distfile new file mode 100644 index 000000000..ac281297a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/html_ftn/Distfile @@ -0,0 +1,63 @@ +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manglu/html_ftn/Distfile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ +# + +DISTDIR_SI = /xc/doc/hardcopy/GL/html/glu_ftn + +DISTFILES_SI = \ + fglubegincurve.html \ + fglubeginpolygon.html \ + fglubeginsurface.html \ + fglubegintrim.html \ + fglubuild1dmipmaplevels.html \ + fglubuild1dmipmaps.html \ + fglubuild2dmipmaplevels.html \ + fglubuild2dmipmaps.html \ + fglubuild3dmipmaplevels.html \ + fglubuild3dmipmaps.html \ + fglucheckextension.html \ + fglucylinder.html \ + fgludeletenurbsrenderer.html \ + fgludeletequadric.html \ + fgludeletetess.html \ + fgludisk.html \ + fgluerrorstring.html \ + fglugetnurbsproperty.html \ + fglugetstring.html \ + fglugettessproperty.html \ + fgluloadsamplingmatrices.html \ + fglulookat.html \ + fglunewnurbsrenderer.html \ + fglunewquadric.html \ + fglunewtess.html \ + fglunextcontour.html \ + fglunurbscallback.html \ + fglunurbscallbackdata.html \ + fglunurbscallbackdataext.html \ + fglunurbscurve.html \ + fglunurbsproperty.html \ + fglunurbssurface.html \ + fgluortho2d.html \ + fglupartialdisk.html \ + fgluperspective.html \ + fglupickmatrix.html \ + fgluproject.html \ + fglupwlcurve.html \ + fgluquadriccallback.html \ + fgluquadricdrawstyle.html \ + fgluquadricnormals.html \ + fgluquadricorientation.html \ + fgluquadrictexture.html \ + fgluscaleimage.html \ + fglusphere.html \ + fglutessbegincontour.html \ + fglutessbeginpolygon.html \ + fglutesscallback.html \ + fglutessendpolygon.html \ + fglutessnormal.html \ + fglutessproperty.html \ + fglutessvertex.html \ + fgluunproject.html \ + fgluunproject4.html \ + $(NULL) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/html_ftn/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/html_ftn/GNUmakefile new file mode 100644 index 000000000..53ffa276b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/html_ftn/GNUmakefile @@ -0,0 +1,69 @@ +#!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. +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manglu/html_ftn/GNUmakefile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +DEPTH = ../.. +LANGOPT = c +PREFIX = gl +MANSRC = ../ftn + +MANPREF = man +include $(DEPTH)/mandefs + +# Dependencies are in the man page source directory +VPATH = $(shell cd $(MANSRC) ; pwd) + +default: + $(MAKE) html + +headers headers_install libs libs_install install apps: + +distsi: default + $(MAKE) $(COMMONPREF)$@ + +distoss: + $(MAKE) $(COMMONPREF)$@ + +html: $(patsubst %.3gl,%.html,$(notdir $(wildcard $(MANSRC)/*.3gl))) + +clobber: + rm -rf *.html + +include $(DEPTH)/manrules +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/Distfile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/Distfile new file mode 100644 index 000000000..c78c971fd --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/Distfile @@ -0,0 +1,64 @@ +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manglu/standard/Distfile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ +# + +DISTDIR_SI = /xc/doc/man/GL/glu + +DISTFILES_SI = \ + Imakefile \ + begincurve.3gl \ + beginpolygon.3gl \ + beginsurface.3gl \ + begintrim.3gl \ + build1dmipmaplevels.3gl \ + build1dmipmaps.3gl \ + build2dmipmaplevels.3gl \ + build2dmipmaps.3gl \ + build3dmipmaplevels.3gl \ + build3dmipmaps.3gl \ + checkextension.3gl \ + cylinder.3gl \ + deletenurbsrenderer.3gl \ + deletequadric.3gl \ + deletetess.3gl \ + disk.3gl \ + errorstring.3gl \ + getnurbsproperty.3gl \ + getstring.3gl \ + gettessproperty.3gl \ + loadsamplingmatrices.3gl \ + lookat.3gl \ + newnurbsrenderer.3gl \ + newquadric.3gl \ + newtess.3gl \ + nextcontour.3gl \ + nurbscallback.3gl \ + nurbscallbackdata.3gl \ + nurbscallbackdataext.3gl \ + nurbscurve.3gl \ + nurbsproperty.3gl \ + nurbssurface.3gl \ + ortho2d.3gl \ + partialdisk.3gl \ + perspective.3gl \ + pickmatrix.3gl \ + project.3gl \ + pwlcurve.3gl \ + quadriccallback.3gl \ + quadricdrawstyle.3gl \ + quadricnormals.3gl \ + quadricorientation.3gl \ + quadrictexture.3gl \ + scaleimage.3gl \ + sphere.3gl \ + tessbegincontour.3gl \ + tessbeginpolygon.3gl \ + tesscallback.3gl \ + tessendpolygon.3gl \ + tessnormal.3gl \ + tessproperty.3gl \ + tessvertex.3gl \ + unproject.3gl \ + unproject4.3gl \ + $(NULL) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/GNUmakefile new file mode 100644 index 000000000..ac40be796 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/GNUmakefile @@ -0,0 +1,93 @@ +#!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. +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manglu/standard/GNUmakefile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ + +# 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 = glu +IDB_PATH = /usr/catman/g_man/cat3/standard + +MANPREF = man +include $(DEPTH)/mandefs + +APIFILE = $(ROOT)/usr/include/GL/glu.h + +VERSION = Version 1.2 +DATE = 6 March 1997 +RELEASE = 1.2.0 +MMFLAGS = -rs2 + +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/glu`basename $$file .3gl`.3gl ; \ + done + + +clobber: + rm -f *.3gl + +include $(DEPTH)/manrules +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/Imakefile b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/Imakefile new file mode 100644 index 000000000..fa72cb85a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/Imakefile @@ -0,0 +1,216 @@ +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 = \ +gluBeginCurve.$(MANSUFFIX) gluBeginPolygon.$(MANSUFFIX) \ +gluBeginSurface.$(MANSUFFIX) gluBeginTrim.$(MANSUFFIX) \ +gluBuild1DMipmaps.$(MANSUFFIX) gluBuild2DMipmaps.$(MANSUFFIX) \ +gluCylinder.$(MANSUFFIX) gluDeleteNurbsRenderer.$(MANSUFFIX) \ +gluDeleteQuadric.$(MANSUFFIX) gluDeleteTess.$(MANSUFFIX) \ +gluDisk.$(MANSUFFIX) gluEndCurve.$(MANSUFFIX) \ +gluEndPolygon.$(MANSUFFIX) gluEndSurface.$(MANSUFFIX) \ +gluEndTrim.$(MANSUFFIX) gluErrorString.$(MANSUFFIX) \ +gluGetNurbsProperty.$(MANSUFFIX) gluGetString.$(MANSUFFIX) \ +gluGetTessProperty.$(MANSUFFIX) gluLoadSamplingMatrices.$(MANSUFFIX) \ +gluLookAt.$(MANSUFFIX) gluNewNurbsRenderer.$(MANSUFFIX) \ +gluNewQuadric.$(MANSUFFIX) gluNewTess.$(MANSUFFIX) \ +gluNextContour.$(MANSUFFIX) gluNurbsCallback.$(MANSUFFIX) \ +gluNurbsCallbackDataEXT.$(MANSUFFIX) gluNurbsCurve.$(MANSUFFIX) \ +gluNurbsProperty.$(MANSUFFIX) gluNurbsSurface.$(MANSUFFIX) \ +gluOrtho2D.$(MANSUFFIX) gluPartialDisk.$(MANSUFFIX) \ +gluPerspective.$(MANSUFFIX) gluPickMatrix.$(MANSUFFIX) \ +gluProject.$(MANSUFFIX) gluPwlCurve.$(MANSUFFIX) \ +gluQuadricCallback.$(MANSUFFIX) gluQuadricDrawStyle.$(MANSUFFIX) \ +gluQuadricNormals.$(MANSUFFIX) gluQuadricOrientation.$(MANSUFFIX) \ +gluQuadricTexture.$(MANSUFFIX) gluScaleImage.$(MANSUFFIX) \ +gluSphere.$(MANSUFFIX) gluTessBeginContour.$(MANSUFFIX) \ +gluTessBeginPolygon.$(MANSUFFIX) gluTessCallback.$(MANSUFFIX) \ +gluTessEndContour.$(MANSUFFIX) gluTessEndPolygon.$(MANSUFFIX) \ +gluTessNormal.$(MANSUFFIX) gluTessProperty.$(MANSUFFIX) \ +gluTessVertex.$(MANSUFFIX) gluUnProject.$(MANSUFFIX) + +LINK_NAMES = \ +gluBeginCurve.$(MANSUFFIX) gluBeginPolygon.$(MANSUFFIX) \ +gluBeginSurface.$(MANSUFFIX) gluBeginTrim.$(MANSUFFIX) \ +gluBuild1DMipmaps.$(MANSUFFIX) gluBuild2DMipmaps.$(MANSUFFIX) \ +gluCylinder.$(MANSUFFIX) gluDeleteNurbsRenderer.$(MANSUFFIX) \ +gluDeleteQuadric.$(MANSUFFIX) gluDeleteTess.$(MANSUFFIX) \ +gluDisk.$(MANSUFFIX) gluErrorString.$(MANSUFFIX) \ +gluGetNurbsProperty.$(MANSUFFIX) gluGetString.$(MANSUFFIX) \ +gluGetTessProperty.$(MANSUFFIX) gluLoadSamplingMatrices.$(MANSUFFIX) \ +gluLookAt.$(MANSUFFIX) gluNewNurbsRenderer.$(MANSUFFIX) \ +gluNewQuadric.$(MANSUFFIX) gluNewTess.$(MANSUFFIX) \ +gluNextContour.$(MANSUFFIX) gluNurbsCallback.$(MANSUFFIX) \ +gluNurbsCallbackDataEXT.$(MANSUFFIX) gluNurbsCurve.$(MANSUFFIX) \ +gluNurbsProperty.$(MANSUFFIX) gluNurbsSurface.$(MANSUFFIX) \ +gluOrtho2D.$(MANSUFFIX) gluPartialDisk.$(MANSUFFIX) \ +gluPerspective.$(MANSUFFIX) gluPickMatrix.$(MANSUFFIX) \ +gluProject.$(MANSUFFIX) gluPwlCurve.$(MANSUFFIX) \ +gluQuadricCallback.$(MANSUFFIX) gluQuadricDrawStyle.$(MANSUFFIX) \ +gluQuadricNormals.$(MANSUFFIX) gluQuadricOrientation.$(MANSUFFIX) \ +gluQuadricTexture.$(MANSUFFIX) gluScaleImage.$(MANSUFFIX) \ +gluSphere.$(MANSUFFIX) gluTessBeginContour.$(MANSUFFIX) \ +gluTessBeginPolygon.$(MANSUFFIX) gluTessCallback.$(MANSUFFIX) \ +gluTessEndPolygon.$(MANSUFFIX) gluTessNormal.$(MANSUFFIX) \ +gluTessProperty.$(MANSUFFIX) gluTessVertex.$(MANSUFFIX) \ +gluUnProject.$(MANSUFFIX) + +ALIAS_NAMES = \ +gluEndCurve.$(MANSUFFIX) gluEndPolygon.$(MANSUFFIX) \ +gluEndSurface.$(MANSUFFIX) gluEndTrim.$(MANSUFFIX) \ +gluTessEndContour.$(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(gluBeginCurve.$(MANSUFFIX), begincurve.3gl) +ManPageAlias(gluBeginCurve, $(LIBMANDIR), gluEndCurve) + +LinkFile(gluBeginPolygon.$(MANSUFFIX), beginpolygon.3gl) +ManPageAlias(gluBeginPolygon, $(LIBMANDIR), gluEndPolygon) + +LinkFile(gluBeginSurface.$(MANSUFFIX), beginsurface.3gl) +ManPageAlias(gluBeginSurface, $(LIBMANDIR), gluEndSurface) + +LinkFile(gluBeginTrim.$(MANSUFFIX), begintrim.3gl) +ManPageAlias(gluBeginTrim, $(LIBMANDIR), gluEndTrim) + +LinkFile(gluBuild1DMipmaps.$(MANSUFFIX), build1dmipmaps.3gl) + +LinkFile(gluBuild2DMipmaps.$(MANSUFFIX), build2dmipmaps.3gl) + +LinkFile(gluCylinder.$(MANSUFFIX), cylinder.3gl) + +LinkFile(gluDeleteNurbsRenderer.$(MANSUFFIX), deletenurbsrenderer.3gl) + +LinkFile(gluDeleteQuadric.$(MANSUFFIX), deletequadric.3gl) + +LinkFile(gluDeleteTess.$(MANSUFFIX), deletetess.3gl) + +LinkFile(gluDisk.$(MANSUFFIX), disk.3gl) + +LinkFile(gluErrorString.$(MANSUFFIX), errorstring.3gl) + +LinkFile(gluGetNurbsProperty.$(MANSUFFIX), getnurbsproperty.3gl) + +LinkFile(gluGetString.$(MANSUFFIX), getstring.3gl) + +LinkFile(gluGetTessProperty.$(MANSUFFIX), gettessproperty.3gl) + +LinkFile(gluLoadSamplingMatrices.$(MANSUFFIX), loadsamplingmatrices.3gl) + +LinkFile(gluLookAt.$(MANSUFFIX), lookat.3gl) + +LinkFile(gluNewNurbsRenderer.$(MANSUFFIX), newnurbsrenderer.3gl) + +LinkFile(gluNewQuadric.$(MANSUFFIX), newquadric.3gl) + +LinkFile(gluNewTess.$(MANSUFFIX), newtess.3gl) + +LinkFile(gluNextContour.$(MANSUFFIX), nextcontour.3gl) + +LinkFile(gluNurbsCallback.$(MANSUFFIX), nurbscallback.3gl) + +LinkFile(gluNurbsCallbackDataEXT.$(MANSUFFIX), nurbscallbackdataext.3gl) + +LinkFile(gluNurbsCurve.$(MANSUFFIX), nurbscurve.3gl) + +LinkFile(gluNurbsProperty.$(MANSUFFIX), nurbsproperty.3gl) + +LinkFile(gluNurbsSurface.$(MANSUFFIX), nurbssurface.3gl) + +LinkFile(gluOrtho2D.$(MANSUFFIX), ortho2d.3gl) + +LinkFile(gluPartialDisk.$(MANSUFFIX), partialdisk.3gl) + +LinkFile(gluPerspective.$(MANSUFFIX), perspective.3gl) + +LinkFile(gluPickMatrix.$(MANSUFFIX), pickmatrix.3gl) + +LinkFile(gluProject.$(MANSUFFIX), project.3gl) + +LinkFile(gluPwlCurve.$(MANSUFFIX), pwlcurve.3gl) + +LinkFile(gluQuadricCallback.$(MANSUFFIX), quadriccallback.3gl) + +LinkFile(gluQuadricDrawStyle.$(MANSUFFIX), quadricdrawstyle.3gl) + +LinkFile(gluQuadricNormals.$(MANSUFFIX), quadricnormals.3gl) + +LinkFile(gluQuadricOrientation.$(MANSUFFIX), quadricorientation.3gl) + +LinkFile(gluQuadricTexture.$(MANSUFFIX), quadrictexture.3gl) + +LinkFile(gluScaleImage.$(MANSUFFIX), scaleimage.3gl) + +LinkFile(gluSphere.$(MANSUFFIX), sphere.3gl) + +LinkFile(gluTessBeginContour.$(MANSUFFIX), tessbegincontour.3gl) +ManPageAlias(gluTessBeginContour, $(LIBMANDIR), gluTessEndContour) + +LinkFile(gluTessBeginPolygon.$(MANSUFFIX), tessbeginpolygon.3gl) + +LinkFile(gluTessCallback.$(MANSUFFIX), tesscallback.3gl) + +LinkFile(gluTessEndPolygon.$(MANSUFFIX), tessendpolygon.3gl) + +LinkFile(gluTessNormal.$(MANSUFFIX), tessnormal.3gl) + +LinkFile(gluTessProperty.$(MANSUFFIX), tessproperty.3gl) + +LinkFile(gluTessVertex.$(MANSUFFIX), tessvertex.3gl) + +LinkFile(gluUnProject.$(MANSUFFIX), unproject.3gl) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/begincurve.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/begincurve.gl new file mode 100644 index 000000000..5ea082494 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/begincurve.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(BeginCurve, delimit a NURBS curve definition) +_names(BeginCurve) +_names(EndCurve,,noheader) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +.SH DESCRIPTION +Use _cmnd(BeginCurve) to mark the beginning of a NURBS +curve definition. +After +calling _cmnd(BeginCurve), make one or more calls to +_cmnd(NurbsCurve) to define the attributes of the curve. +Exactly one of the calls to _cmnd(NurbsCurve) must have +a curve type of _const(MAP1_VERTEX_3) or _const(MAP1_VERTEX_4). +To mark the end of the NURBS curve definition, call _cmnd(EndCurve). +.P +GL evaluators are used to render the NURBS curve as a series of line +segments. +Evaluator state is preserved during rendering +with _glcmnd(PushAttrib)(_const(EVAL_BIT)) and +_glcmnd(PopAttrib)(). +See the _glcmnd(PushAttrib) reference page for details on exactly what state +these calls preserve. +.SH EXAMPLE +The following commands render a textured NURBS curve with normals; +texture coordinates and normals are also specified as NURBS curves: +.sp +.Ex +gluBeginCurve(nobj); + gluNurbsCurve(nobj, ..., GL_MAP1_TEXTURE_COORD_2); + gluNurbsCurve(nobj, ..., GL_MAP1_NORMAL); + gluNurbsCurve(nobj, ..., GL_MAP1_VERTEX_4); +gluEndCurve(nobj); +.Ee +.SH SEE ALSO +_cmnd(BeginSurface), _cmnd(BeginTrim), _cmnd(NewNurbsRenderer), +_cmnd(NurbsCurve), +_glcmnd(PopAttrib), _glcmnd(PushAttrib) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/beginpolygon.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/beginpolygon.gl new file mode 100644 index 000000000..74c7ac6c2 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/beginpolygon.gl @@ -0,0 +1,89 @@ +_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(BeginPolygon, delimit a polygon description) +_names(BeginPolygon) +_names(EndPolygon,,noheader) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +.SH DESCRIPTION +_cmnd(BeginPolygon) and _cmnd(EndPolygon) delimit the definition of a +nonconvex polygon. +To define such a polygon, first call _cmnd(BeginPolygon). +Then define the contours of the polygon +by calling +_cmnd(TessVertex) for each vertex +and _cmnd(NextContour) to start each new contour. +Finally, call _cmnd(EndPolygon) +to signal the end of the definition. +See the _cmnd(TessVertex) and +_cmnd(NextContour) reference pages for more details. +.P +Once _cmnd(EndPolygon) is called, the polygon is tessellated, and the +resulting triangles are described through callbacks. +See _cmnd(TessCallback) for descriptions of the callback functions. +.SH NOTES +This command is obsolete and is provided for backward compatibility +only. Calls to _cmnd(BeginPolygon) are mapped to +_cmnd(TessBeginPolygon) +followed by +_cmnd(TessBeginContour). Calls to _cmnd(EndPolygon) are mapped +to _cmnd(TessEndContour) followed by _cmnd(TessEndPolygon). +.SH EXAMPLE +A quadrilateral with a triangular hole in it can be described like this: +.sp +.Ex +gluBeginPolygon(tobj); + gluTessVertex(tobj, v1, v1); + gluTessVertex(tobj, v2, v2); + gluTessVertex(tobj, v3, v3); + gluTessVertex(tobj, v4, v4); +gluNextContour(tobj, GLU_INTERIOR); + gluTessVertex(tobj, v5, v5); + gluTessVertex(tobj, v6, v6); + gluTessVertex(tobj, v7, v7); +gluEndPolygon(tobj); +.Ee +.SH SEE ALSO +_cmnd(NewTess), _cmnd(NextContour), _cmnd(TessCallback), _cmnd(TessVertex), +_cmnd(TessBeginPolygon), _cmnd(TessBeginContour) + + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/beginsurface.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/beginsurface.gl new file mode 100644 index 000000000..cd705af99 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/beginsurface.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(BeginSurface, delimit a NURBS surface definition) +_names(BeginSurface) +_names(EndSurface,,noheader) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +.SH DESCRIPTION +Use _cmnd(BeginSurface) to mark the beginning of a NURBS +surface definition. After +calling _cmnd(BeginSurface), make one or more calls to +_cmnd(NurbsSurface) to define the attributes of the surface. +Exactly one of these calls to _cmnd(NurbsSurface) must have a +surface type of _const(MAP2_VERTEX_3) or _const(MAP2_VERTEX_4). +To mark the end of the NURBS surface definition, call +_cmnd(EndSurface). +.P +Trimming of NURBS surfaces is supported with _cmnd(BeginTrim), +_cmnd(PwlCurve), _cmnd(NurbsCurve), and _cmnd(EndTrim). See the +_cmnd(BeginTrim) reference page for details. +.P +GL evaluators are used to render the NURBS surface as a set of polygons. +Evaluator state is preserved during rendering +with _glcmnd(PushAttrib)(_const(EVAL_BIT)) and +_glcmnd(PopAttrib)(). +See the _glcmnd(PushAttrib) reference page for details on exactly what state +these calls preserve. +.SH EXAMPLE +The following commands render a textured NURBS surface with normals; +the texture coordinates and normals are also described as NURBS surfaces: +.sp +.Ex +gluBeginSurface(nobj); + gluNurbsSurface(nobj, ..., GL_MAP2_TEXTURE_COORD_2); + gluNurbsSurface(nobj, ..., GL_MAP2_NORMAL); + gluNurbsSurface(nobj, ..., GL_MAP2_VERTEX_4); +gluEndSurface(nobj); +.Ee +.sp +.SH SEE ALSO +_cmnd(BeginCurve), _cmnd(BeginTrim), _cmnd(NewNurbsRenderer), +_cmnd(NurbsCurve), _cmnd(NurbsSurface), _cmnd(PwlCurve) + + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/begintrim.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/begintrim.gl new file mode 100644 index 000000000..a9df90666 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/begintrim.gl @@ -0,0 +1,120 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(BeginTrim, delimit a NURBS trimming loop definition) +_names(BeginTrim) +_names(EndTrim,,noheader) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +.SH DESCRIPTION +Use _cmnd(BeginTrim) to mark the beginning of a +trimming loop, and _cmnd(EndTrim) to mark the end +of a trimming loop. A trimming loop is +a set of oriented curve segments (forming a closed curve) that +define boundaries of a NURBS surface. You include these +trimming loops in the definition of a NURBS +surface, between calls to _cmnd(BeginSurface) and _cmnd(EndSurface). +.P +The definition for a NURBS surface can contain many +trimming loops. For example, if you wrote a definition +for a NURBS surface that resembled a rectangle with +a hole punched out, the definition would contain two +trimming loops. One loop would define the outer edge +of the rectangle; the other would define +the hole punched out of the rectangle. The definitions +of each of these trimming loops would be bracketed by a +_cmnd(BeginTrim)/_cmnd(EndTrim) pair. +.P +The definition of a single closed trimming loop can consist +of multiple curve segments, each described as a piecewise +linear curve (see _cmnd(PwlCurve)) or as a single NURBS +curve (see _cmnd(NurbsCurve)), or as a combination of +both in any order. The only library calls that can +appear in a trimming loop definition (between the calls +to _cmnd(BeginTrim) and _cmnd(EndTrim)) are +_cmnd(PwlCurve) and _cmnd(NurbsCurve). +.P +The area of the NURBS surface that is displayed is the +region in the domain to the left of the trimming curve +as the curve parameter increases. Thus, the retained +region of the NURBS surface is inside a +counterclockwise trimming loop and outside a clockwise +trimming loop. For the rectangle mentioned earlier, +the trimming loop for the outer edge of the rectangle runs +counterclockwise, while the trimming loop for the punched-out hole +runs clockwise. +.P +If you use more than one curve to define a single trimming +loop, the curve segments must form a closed loop (that is, +the endpoint of each curve must be the starting point of the +next curve, and the endpoint of the final curve must +be the starting point of the first curve). If the +endpoints of the curve are sufficiently close together +but not exactly coincident, they will be coerced to match. +If the endpoints are not sufficiently close, an error results +(see _cmnd(NurbsCallback)). +.P +If a trimming loop definition contains multiple curves, +the direction of the curves must be consistent (that is, the +inside must be to the left of all of the curves). Nested +trimming loops are legal as long as the curve orientations +alternate correctly. +If trimming curves are self-intersecting, +or intersect one another, an error results. +.P +If no trimming information is given +for a NURBS surface, the entire surface is drawn. +.SH EXAMPLE +This code fragment defines a trimming loop that consists of one +piecewise linear curve, and two NURBS curves: +.sp +.Ex +gluBeginTrim(nobj); + gluPwlCurve(..., GLU_MAP1_TRIM_2); + gluNurbsCurve(..., GLU_MAP1_TRIM_2); + gluNurbsCurve(..., GLU_MAP1_TRIM_3); +gluEndTrim(nobj); +.Ee +.SH SEE ALSO +_cmnd(BeginSurface), _cmnd(NewNurbsRenderer), _cmnd(NurbsCallback), +_cmnd(NurbsCurve), _cmnd(PwlCurve) + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build1dmipmaplevels.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build1dmipmaplevels.gl new file mode 100644 index 000000000..249494035 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build1dmipmaplevels.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Build1DMipmapLevels, builds a subset of one-dimensional mipmap levels) +_names(Build1DMipmapLevels) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. Must be _const(TEXTURE_1D). +_phead(_param2) +Requests the internal storage format of the texture image. The most +current version of the SGI implementation of GLU does not check this +value for validity before passing it on to the underlying OpenGL +implementation. A value that is not accepted by the OpenGL +implementation will lead to an OpenGL error. The benefit of not +checking this value at the GLU level is that OpenGL extensions can add +new internal texture formats without requiring a revision of the GLU +implementation. Older implementations of GLU check this value and +raise a GLU error if it is not 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(_param3) +Specifies the width in pixels of the texture image. +This should be a power of 2. +_phead(_param4) +Specifies the format of the pixel data. +Must be one of: +_const(COLOR_INDEX), +_const(DEPTH_COMPONENT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(RGBA), +_const(BGR), +_const(BGRA), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA). +_phead(_param5) +Specifies the data type for _param9. +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(_param6) +Specifies the mipmap level of the image data. +_phead(_param7) +Specifies the minimum mipmap level to pass to _glcmnd(TexImage1D). +_phead(_param8) +Specifies the maximum mipmap level to pass to _glcmnd(TexImage1D). +_phead(_param9) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +_cmnd builds a subset of prefiltered one-dimensional texture maps of decreasing +resolutions called a mipmap. This is used for the antialiasing of +texture mapped primitives. +.P +A return value of zero indicates success, otherwise a GLU error code is +returned (see _cmnd(ErrorString)). +.P +A series of mipmap levels from _param7 to _param8 is built by decimating +_param9 in half +until size $1 ~times~ 1$ is reached. At each level, each texel in the +halved mipmap level is an average of the corresponding two texels in the larger +mipmap level. +_glcmnd(TexImage1D) is called to load these mipmap levels from _param7 +to _param8. If _param8 is larger than the highest mipmap level for the +texture of the specified size, then a GLU error code is returned (see +_cmnd(ErrorString)) and nothing is loaded. +.P +For example, if _param6 is 2 and _param3 is 16, the +following levels are possible: $16 ~times~ 1$, $8 ~times~ 1$, $4 ~times~ 1$, +$2 ~times~ 1$, $1 ~times~ 1$. These correspond +to levels 2 through 6 respectively. +If _param7 is 3 and _param8 is 5, then only mipmap levels $8 ~times~ 1$, +$4 ~times~ 1$ and $2 ~times~ 1$ are +loaded. However, if _param8 is 7 then an error is returned and nothing is +loaded since _param8 is larger than the highest mipmap level which is, in +this case, 6. +.P +The highest mipmap level can be derived from the formula +${log sub 2} (_param3^{2 sup _param6})$. +.P +See the _glcmnd(TexImage1D) reference page for a description of the +acceptable values for _param5 parameter. See the _glcmnd(DrawPixels) +reference page for a description of the acceptable values +for _param6 parameter. +.bp +.SH NOTES +_cmnd is only available if the GLU version is 1.3 or greater. +.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 only available if the GL version +is 1.2 or greater. +.SH ERRORS +_gluconst(INVALID_VALUE) is returned if _param6 > _param7, _param7 < 0, +_param8 < _param7 or _param8 is > the highest mipmap level for _param9. +.P +_gluconst(INVALID_VALUE) is returned if _param3 is < 1. +.P +_gluconst(INVALID_ENUM) is returned if _param2, _param4, or _param5 are not +legal. +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_BYTE_3_3_2) or _const(UNSIGNED_BYTE_2_3_3_REV) +and _param4 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_SHORT_5_6_5) or _const(UNSIGNED_SHORT_5_6_5_REV) +and _param4 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_SHORT_4_4_4_4) or _const(UNSIGNED_SHORT_4_4_4_4_REV) +and _param4 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_SHORT_5_5_5_1) or _const(UNSIGNED_SHORT_1_5_5_5_REV) +and _param4 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_INT_8_8_8_8) or _const(UNSIGNED_INT_8_8_8_8_REV) +and _param4 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_INT_10_10_10_2) or _const(UNSIGNED_INT_2_10_10_10_REV) +and _param4 is neither _const(RGBA) nor _const(BGRA). +.SH SEE ALSO +_glcmnd(DrawPixels), _glcmnd(TexImage1D), _glcmnd(TexImage2D), +_glcmnd(TexImage3D), +_cmnd(Build1DMipmaps), _cmnd(Build2DMipmaps), _cmnd(Build3DMipmaps), +_cmnd(ErrorString), +_glcmnd(GetTexImage), +_glcmnd(GetTexLevelParameter), +_cmnd(Build2DMipmapLevels), _cmnd(Build3DMipmapLevels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build1dmipmaps.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build1dmipmaps.gl new file mode 100644 index 000000000..6f1eddd92 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build1dmipmaps.gl @@ -0,0 +1,235 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Build1DMipmaps, builds a one-dimensional mipmap) +_names(Build1DMipmaps) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. Must be _const(TEXTURE_1D). +_phead(_param2) +Requests the internal storage format of the texture image. The most +current version of the SGI implementation of GLU does not check this +value for validity before passing it on to the underlying OpenGL +implementation. A value that is not accepted by the OpenGL +implementation will lead to an OpenGL error. The benefit of not +checking this value at the GLU level is that OpenGL extensions can add +new internal texture formats without requiring a revision of the GLU +implementation. Older implementations of GLU check this value and +raise a GLU error if it is not 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(_param3) +Specifies the width, in pixels, of the texture image. +_phead(_param4) +Specifies the format of the pixel data. +Must be one of +_const(COLOR_INDEX), +_const(DEPTH_COMPONENT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(RGBA), +_const(BGR), +_const(BGRA), +_const(LUMINANCE), +_const(LUMINANCE_ALPHA). +_phead(_param5) +Specifies the data type for _param6. +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(_param6) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +_cmnd builds a series of prefiltered one-dimensional texture maps of decreasing +resolutions called a mipmap. This is used for the antialiasing of +texture mapped primitives. +.P +A return value of zero indicates success, otherwise a GLU error code is +returned (see _cmnd(ErrorString)). +.P +Initially, the _param3 of _param6 is checked to see if it is +a power of 2. If not, a copy of _param6 is scaled up or down to the +nearest power of 2. (If _param3 is exactly between powers of 2, then +the copy of _param6 will scale upwards.) This copy will be used for +subsequent mipmapping operations described below. +For example, if _param3 is 57 then a copy of _param6 +will scale up to 64 before mipmapping +takes place. +.P +Then, proxy textures (see _glcmnd(TexImage1D)) are used to determine if +the implementation can fit the requested texture. If not, _param3 is +continually halved until it fits. +.P +Next, a series of mipmap levels is built by decimating a copy of +_param6 in half +until size $1 ~times~ 1$ is reached. At each level, each texel in the +halved mipmap level is an average of the corresponding two texels in the larger +mipmap level. +.P +_glcmnd(TexImage1D) is called to load each of these mipmap levels. +Level 0 is a copy of _param6. +The highest level is ${log sub 2}(_param3)$. +For example, if _param3 is 64 and the implementation can store a texture of +this size, the following mipmap levels are +built: $64 ~times~ 1$, $32 ~times~ 1$, $16 ~times~ 1$, $8 ~times~ 1$, +$4 ~times~ 1$, $2 ~times~ 1$ and $1 ~times~ 1$. These correspond to +levels 0 through 6, respectively. +.P +See the _glcmnd(TexImage1D) reference page for a description of the +acceptable values for the _param5 parameter. See the _glcmnd(DrawPixels) +reference page for a description of the acceptable values +for the _param6 parameter. +.SH NOTES +Note that there is no direct way of querying the maximum level. This can +be derived indirectly via _glcmnd(GetTexLevelParameter). First, query +for the +width actually used at level 0. +(The width may not be equal to _param3 since +proxy textures might have scaled it to fit the implementation.) +Then the maximum +level can be derived from the formula ${log sub 2}(_param3)$. +.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 only available if the GL version +is 1.2 or greater, and if the GLU version is 1.3 or greater. +.SH ERRORS +_gluconst(INVALID_VALUE) is returned if _param3 is < 1. +.P +_gluconst(INVALID_ENUM) is returned if _param4 or _param5 are not legal. +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_BYTE_3_3_2) or _const(UNSIGNED_BYTE_2_3_3_REV) +and _param4 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_SHORT_5_6_5) or _const(UNSIGNED_SHORT_5_6_5_REV) +and _param4 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_SHORT_4_4_4_4) or _const(UNSIGNED_SHORT_4_4_4_4_REV) +and _param4 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_SHORT_5_5_5_1) or _const(UNSIGNED_SHORT_1_5_5_5_REV) +and _param4 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_INT_8_8_8_8) or _const(UNSIGNED_INT_8_8_8_8_REV) +and _param4 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param5 is _const(UNSIGNED_INT_10_10_10_2) or _const(UNSIGNED_INT_2_10_10_10_REV) +and _param4 is neither _const(RGBA) nor _const(BGRA). +.SH SEE ALSO +_glcmnd(DrawPixels), +_glcmnd(TexImage1D), +_glcmnd(TexImage2D), +_glcmnd(TexImage3D), +_cmnd(Build2DMipmaps), +_cmnd(Build3DMipmaps), +_cmnd(ErrorString), +_glcmnd(GetTexImage), +_glcmnd(GetTexLevelParameter), +_cmnd(Build1DMipmapLevels), +_cmnd(Build2DMipmapLevels), +_cmnd(Build3DMipmapLevels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build2dmipmaplevels.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build2dmipmaplevels.gl new file mode 100644 index 000000000..6c083a454 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build2dmipmaplevels.gl @@ -0,0 +1,234 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Build2DMipmapLevels, builds a subset of two-dimensional mipmap levels) +_names(Build2DMipmapLevels) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. Must be _const(TEXTURE_2D). +_phead(_param2) +Requests the internal storage format of the texture image. The most +current version of the SGI implementation of GLU does not check this +value for validity before passing it on to the underlying OpenGL +implementation. A value that is not accepted by the OpenGL +implementation will lead to an OpenGL error. The benefit of not +checking this value at the GLU level is that OpenGL extensions can add +new internal texture formats without requiring a revision of the GLU +implementation. Older implementations of GLU check this value and +raise a GLU error if it is not 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(_param3 _param4) +Specifies the width and height, respectively, in pixels of the texture image. +These should be a power of 2. +_phead(_param5) +Specifies the format of the pixel data. +Must be one of +_const(COLOR_INDEX), +_const(DEPTH_COMPONENT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(RGBA), +_const(BGR), +_const(BGRA), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA). +_phead(_param6) +Specifies the data type for _param10. +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) +Specifies the mipmap level of the image data. +_phead(_param8) +Specifies the minimum mipmap level to pass to _glcmnd(TexImage2D). +_phead(_param9) +Specifies the maximum mipmap level to pass to _glcmnd(TexImage2D). +_phead(_param10) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +_cmnd builds a subset of prefiltered two-dimensional texture maps of decreasing +resolutions called a mipmap. This is used for the antialiasing of +texture mapped primitives. +.P +A return value of zero indicates success, otherwise a GLU error code is +returned (see _cmnd(ErrorString)). +.P +A series of mipmap levels from _param8 to _param9 is built by decimating +_param10 in half along +both dimensions until size $1 ~times~ 1$ is reached. At each level, each texel in the +halved mipmap level is an average of the corresponding four texels in the larger +mipmap level. (In the case of rectangular images, the decimation will ultimately +reach an $N ~times~ 1$ or $1 ~times~ N$ configuration. Here, two texels are +averaged instead.) +_glcmnd(TexImage2D) is called to load these mipmap levels from _param8 +to _param9. If _param9 is larger than the highest mipmap level for the +texture of the specified size, then a GLU error code is returned (see +_cmnd(ErrorString)) and nothing is loaded. +.P +For example, if _param7 is 2 and _param3 is 16 and _param4 is 8, the +following levels are possible: $16 ~times~ 8$, $8 ~times~ 4$, $4 ~times~ 2$, +$2 ~times~ 1$, $1 ~times~ 1$. These correspond to levels 2 through 6 +respectively. If _param8 is 3 and _param9 is 5, then only mipmap levels +$8 ~times~ 4$, $4 ~times~ 2$ and $2 ~times~ 1$ are loaded. However, if _param9 +is 7 then an error is returned and nothing is loaded since _param9 is +larger than the highest mipmap level which is, in this case, 6. +.P +The highest mipmap level can be derived from the formula +log2(max(_param3,_param4)*(2^_param7)). +.P +See the _glcmnd(TexImage1D) reference page for a description of the +acceptable values for _param5 parameter. See the _glcmnd(DrawPixels) +reference page for a description of the acceptable values +for _param6 parameter. +.SH NOTES +_cmnd is only available if the GLU version is 1.3 or greater. +.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 only available if the GL version +is 1.2 or greater. +.SH ERRORS +_gluconst(INVALID_VALUE) is returned if _param7 > _param8, _param8 < 0, +_param9 < _param8 or _param9 is > the highest mipmap level for _param10. +.P +_gluconst(INVALID_VALUE) is returned if _param3 or _param4 is < 1. +.P +_gluconst(INVALID_ENUM) is returned if _param2, _param5, or _param6 is not +legal. +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_BYTE_3_3_2) or _const(UNSIGNED_BYTE_2_3_3_REV) +and _param5 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_SHORT_5_6_5) or _const(UNSIGNED_SHORT_5_6_5_REV) +and _param5 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_SHORT_4_4_4_4) or _const(UNSIGNED_SHORT_4_4_4_4_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_SHORT_5_5_5_1) or _const(UNSIGNED_SHORT_1_5_5_5_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_INT_8_8_8_8) or _const(UNSIGNED_INT_8_8_8_8_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _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 SEE ALSO +_glcmnd(DrawPixels), +_glcmnd(TexImage1D), +_glcmnd(TexImage2D), +_glcmnd(TexImage3D), +_cmnd(Build1DMipmaps), +_cmnd(Build2DMipmaps), +_cmnd(Build3DMipmaps), +_cmnd(ErrorString), +_glcmnd(GetTexImage), +_glcmnd(GetTexLevelParameter), +_cmnd(Build1DMipmapLevels), +_cmnd(Build3DMipmapLevels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build2dmipmaps.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build2dmipmaps.gl new file mode 100644 index 000000000..c20b52636 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build2dmipmaps.gl @@ -0,0 +1,242 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Build2DMipmaps, builds a two-dimensional mipmap) +_names(Build2DMipmaps) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. Must be _const(TEXTURE_2D). +_phead(_param2) +Requests the internal storage format of the texture image. The most +current version of the SGI implementation of GLU does not check this +value for validity before passing it on to the underlying OpenGL +implementation. A value that is not accepted by the OpenGL +implementation will lead to an OpenGL error. The benefit of not +checking this value at the GLU level is that OpenGL extensions can add +new internal texture formats without requiring a revision of the GLU +implementation. Older implementations of GLU check this value and +raise a GLU error if it is not 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(_param3 _param4) +Specifies in pixels the width and height, respectively, of the texture image. +_phead(_param5) +Specifies the format of the pixel data. +Must be one of +_const(COLOR_INDEX), +_const(DEPTH_COMPONENT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(RGBA), +_const(BGR), +_const(BGRA), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA). +_phead(_param6) +Specifies the data type for _param7. +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) +Specifies a pointer to the image data in memory. + + +.SH DESCRIPTION +_cmnd builds a series of prefiltered two-dimensional texture maps of decreasing +resolutions called a mipmap. This is used for the antialiasing of +texture-mapped primitives. +.P +A return value of zero indicates success, otherwise a GLU error code is +returned (see _cmnd(ErrorString)). +.P +Initially, the _param3 and _param4 of _param7 are checked to see if they +are a power of 2. If not, a copy of _param7 (not _param7), is scaled up +or down to the nearest power of 2. This copy will be used for subsequent +mipmapping operations described below. (If _param3 or _param4 is exactly +between powers of 2, then the copy of _param7 will scale upwards.) For +example, if _param3 is 57 and _param4 is 23 then a copy of _param7 will +scale up to 64 in _param3 and down to 16 in depth, before mipmapping takes +place. +.P +Then, proxy textures (see _glcmnd(TexImage2D)) are used to determine if +the implementation can fit the requested texture. If not, both dimensions +are continually halved until it fits. (If the OpenGL version is \(<= 1.0, +both maximum texture dimensions are clamped to the value returned +by _glcmnd(GetIntegerv) with the argument _const(MAX_TEXTURE_SIZE).) +.P +Next, a series of mipmap levels is built by decimating a copy of _param7 +in half along both dimensions until size $1 ~times~ 1$ is reached. At +each level, +each texel in the halved mipmap level is an average of the corresponding +four texels in the larger mipmap level. (In the case of rectangular +images, the decimation will ultimately reach an $N ~times~ 1$ or +$1 ~times~ N$ configuration. Here, two texels are averaged instead.) +.P +_glcmnd(TexImage2D) is called to load each of these mipmap levels. +Level 0 is a copy of _param7. The highest level is +${log sub 2} ( max (_eqnparam3,_eqnparam4))$. For example, +if _param3 is 64 and _param4 is 16 +and the implementation can store a texture of this size, the following +mipmap levels are built: $64 ~times~ 16$, $32 ~times~ 8$, $16 ~times~ 4$, +$8 ~times~ 2$, $4 ~times~ 1$, $2 ~times~ 1$ and $1 ~times~ 1$. These correspond to +levels 0 through 6, respectively. +.P +See the _glcmnd(TexImage1D) reference page for a description of the +acceptable values for _param5 parameter. See the _glcmnd(DrawPixels) +reference page for a description of the acceptable values +for _param6 parameter. +.SH NOTES + +Note that there is no direct way of querying the maximum level. This can +be derived indirectly via _glcmnd(GetTexLevelParameter). First, query +for the width and height actually used at level 0. (The width and +height may not be equal to _param3 and _param4 respectively since proxy +textures might have scaled them to fit the implementation.) Then the +maximum level can be derived from the formula +${log sub 2}( max (_param3,_param4))$. +.SH NOTES +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 only available if the GL version +is 1.2 or greater and if the GLU version is 1.3 or greater. +.SH ERRORS +_gluconst(INVALID_VALUE) is returned if _param3, or _param4 is < 1. +.P +_gluconst(INVALID_ENUM) is returned if _param2, _param5, or _param6 is not +legal. +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_BYTE_3_3_2) or _const(UNSIGNED_BYTE_2_3_3_REV) +and _param5 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_SHORT_5_6_5) or _const(UNSIGNED_SHORT_5_6_5_REV) +and _param5 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_SHORT_4_4_4_4) or _const(UNSIGNED_SHORT_4_4_4_4_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_SHORT_5_5_5_1) or _const(UNSIGNED_SHORT_1_5_5_5_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _const(UNSIGNED_INT_8_8_8_8) or _const(UNSIGNED_INT_8_8_8_8_REV) +and _param5 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param6 is _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 SEE ALSO +_glcmnd(DrawPixels), +_glcmnd(TexImage1D), +_glcmnd(TexImage2D), +_glcmnd(TexImage3D), +_cmnd(Build1DMipmaps), +_cmnd(Build3DMipmaps), +_cmnd(ErrorString), +_glcmnd(GetTexImage), +_glcmnd(GetTexLevelParameter), +_cmnd(Build1DMipmapLevels), +_cmnd(Build2DMipmapLevels), +_cmnd(Build3DMipmapLevels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build3dmipmaplevels.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build3dmipmaplevels.gl new file mode 100644 index 000000000..552743110 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build3dmipmaplevels.gl @@ -0,0 +1,236 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Build3DMipmapLevels, builds a subset of three-dimensional mipmap levels) +_names(Build3DMipmapLevels) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. Must be _const(TEXTURE_3D). +_phead(_param2) +Requests the internal storage format of the texture image. The most +current version of the SGI implementation of GLU does not check this +value for validity before passing it on to the underlying OpenGL +implementation. A value that is not accepted by the OpenGL +implementation will lead to an OpenGL error. The benefit of not +checking this value at the GLU level is that OpenGL extensions can add +new internal texture formats without requiring a revision of the GLU +implementation. Older implementations of GLU check this value and +raise a GLU error if it is not 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(_param3 _param4 _param5) +Specifies in pixels the width, height and depth respectively, of the texture +image. These should be a power of 2. +_phead(_param6) +Specifies the format of the pixel data. +Must be one of +_const(COLOR_INDEX), +_const(DEPTH_COMPONENT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(RGBA), +_const(BGR), +_const(BGRA), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA). +_phead(_param7) +Specifies the data type for _param11. +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(_param8) +Specifies the mipmap level of the image data. +_phead(_param9) +Specifies the minimum mipmap level to pass to _glcmnd(TexImage3D). +_phead(_param10) +Specifies the maximum mipmap level to pass to _glcmnd(TexImage3D). +_phead(_param11) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +_cmnd builds a subset of prefiltered three-dimensional texture maps of +decreasing resolutions called a mipmap. This is used for the antialiasing of +texture mapped primitives. +.P +A return value of zero indicates success, otherwise a GLU error code is +returned (see _cmnd(ErrorString)). +.P +A series of mipmap levels from _param9 to _param10 is built by +decimating _param11 in half along both dimensions until size $1 ~times~ 1 +~times~ 1$ is reached. At each level, each texel in the halved mipmap +level is an average of the corresponding eight texels in the larger +mipmap level. (If exactly one of the dimensions is 1, four texels are +averaged. If exactly two of the dimensions are 1, two texels are +averaged.) _glcmnd(TexImage3D) is called to load these mipmap levels +from _param9 to _param10. If _param10 is larger than the highest mipmap +level for the texture of the specified size, then a GLU error code is +returned (see _cmnd(ErrorString)) and nothing is loaded. +.P +For example, if _param8 is 2 and _param3 is 16, _param4 is 8 and _param5 +is 4, the following levels are possible: $16 ~times~ 8 ~times~ 4$, $8 ~times~ +4 ~times~ 2$, $4 ~times~ 2 ~times~ 1$, $2 ~times~ 1 ~times~ 1$, +$1 ~times~ 1 ~times~ 1$. +These correspond to levels 2 through 6 respectively. If _param9 is +3 and _param10 is 5, then only mipmap levels $8 ~times~ 4 ~times~ 2$, $4 +~times~ 2 ~times~ 1$ and $2 ~times~ 1 ~times~ 1$ are loaded. However, if +_param10 is 7 then an error is returned and nothing is loaded, since +_param10 is larger than the highest mipmap level which is, in this case, +6. +.P +The highest mipmap level can be derived from the formula +${log sub 2} ( max (_eqnparam3,_eqnparam4,_eqnparam5)^{2 sup _eqnparam8})$. +.P +See the _glcmnd(TexImage1D) reference page for a description of the +acceptable values for _param6 parameter. See the _glcmnd(DrawPixels) +reference page for a description of the acceptable values +for _param7 parameter. +.SH NOTES +_cmnd is only available if the GLU version is 1.3 or greater. +.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 only available if the GL version +is 1.2 or greater. +.SH ERRORS +_gluconst(INVALID_VALUE) is returned if _param8 > _param9, _param9 < 0, +_param10 < _param9 or _param10 is > the highest mipmap level for _param11. +.P +_gluconst(INVALID_VALUE) is returned if _param3, _param4, or _param5 is < 1. +.P +_gluconst(INVALID_ENUM) is returned if _param2, _param6, or _param7 is not +legal. +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_BYTE_3_3_2) or _const(UNSIGNED_BYTE_2_3_3_REV) +and _param6 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_SHORT_5_6_5) or _const(UNSIGNED_SHORT_5_6_5_REV) +and _param6 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_SHORT_4_4_4_4) or _const(UNSIGNED_SHORT_4_4_4_4_REV) +and _param6 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_SHORT_5_5_5_1) or _const(UNSIGNED_SHORT_1_5_5_5_REV) +and _param6 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_INT_8_8_8_8) or _const(UNSIGNED_INT_8_8_8_8_REV) +and _param6 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _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 SEE ALSO +_glcmnd(DrawPixels), +_glcmnd(TexImage1D), +_glcmnd(TexImage2D), +_glcmnd(TexImage3D), +_cmnd(Build1DMipmaps), +_cmnd(Build2DMipmaps), +_cmnd(Build3DMipmaps), +_cmnd(ErrorString), +_glcmnd(GetTexImage), +_glcmnd(GetTexLevelParameter), +_cmnd(Build1DMipmapLevels), +_cmnd(Build2DMipmapLevels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build3dmipmaps.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build3dmipmaps.gl new file mode 100644 index 000000000..ae083e22e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/build3dmipmaps.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Build3DMipmaps, builds a three-dimensional mipmap) +_names(Build3DMipmaps) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the target texture. Must be _const(TEXTURE_3D). +_phead(_param2) +Requests the internal storage format of the texture image. The most +current version of the SGI implementation of GLU does not check this +value for validity before passing it on to the underlying OpenGL +implementation. A value that is not accepted by the OpenGL +implementation will lead to an OpenGL error. The benefit of not +checking this value at the GLU level is that OpenGL extensions can add +new internal texture formats without requiring a revision of the GLU +implementation. Older implementations of GLU check this value and +raise a GLU error if it is not 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(_param3 _param4 _param5) +Specifies in pixels the width, height and depth respectively, in pixels +of the texture image. +_phead(_param6) +Specifies the format of the pixel data. +Must be one of +_const(COLOR_INDEX), +_const(DEPTH_COMPONENT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(RGBA), +_const(BGR), +_const(BGRA), +_const(LUMINANCE), or +_const(LUMINANCE_ALPHA). +_phead(_param7) +Specifies the data type for _param8. +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(_param8) +Specifies a pointer to the image data in memory. +.SH DESCRIPTION +_cmnd builds a series of prefiltered three-dimensional texture maps of +decreasing resolutions called a mipmap. This is used for the antialiasing of +texture-mapped primitives. +.P +A return value of zero indicates success, otherwise a GLU error code is +returned (see _cmnd(ErrorString)). +.P +Initially, the _param3, _param4 and _param5 of _param8 are checked to +see if they are a power of 2. If not, a copy of _param8 (not _param8), +is scaled up or down to the nearest power of 2. (If _param3, _param4 or +_param5 is exactly between powers of 2, then the copy of _param8 will +scale upwards.) This copy will be used for subsequent mipmapping +operations described below. For example, if _param3 is 57, _param4 is +23 and _param5 is 24 then a copy of _param8 will scale up to 64 in +width, down to 16 in height and up to 32 in depth, before mipmapping +takes place. +.P +Then, proxy textures (see _glcmnd(TexImage3D)) are used to determine if +the implementation can fit the requested texture. If not, all three dimensions +are continually halved until it fits. +.P +Next, a series of mipmap levels is built by decimating a copy of _param8 +in half along all three dimensions until size $1 ~times~ 1 ~times~ 1$ is +reached. At each level, each texel in the halved mipmap level is an +average of the corresponding eight texels in the larger mipmap +level. (If exactly one of the dimensions is 1, four texels are averaged. +If exactly two of the dimensions are 1, two texels are averaged.) +.P +_glcmnd(TexImage3D) is called to load each of these mipmap levels. +Level 0 is a copy of _param8. The highest level is +${log sub 2} ( max (_eqnparam3,_eqnparam4,_eqnparam5))$. +For example, if _param3 is 64, _param4 is +16 and _param5 is 32, and the implementation can store a texture of this +size, the following mipmap levels are built: $64 ~times~ 16 ~times~ 32$, +$32 ~times~ 8 ~times~ 16$, $16 ~times~ 4 ~times~ 8$, +$8 ~times~ 2 ~times~ 4$, $4 ~times~ 1 ~times~ 2$, +$2 ~times~ 1 ~times~ 1$ +and $1 ~times~ 1 ~times~ 1$. These correspond +to levels 0 through 6, respectively. +.P +See the _glcmnd(TexImage1D) reference page for a description of the +acceptable values for _param6 parameter. See the _glcmnd(DrawPixels) +reference page for a description of the acceptable values +for _param7 parameter. +.SH NOTES +Note that there is no direct way of querying the maximum level. This can +be derived indirectly via _glcmnd(GetTexLevelParameter). First, query +for the width, height and depth actually used at level 0. (The width, +height and depth may not be equal to _param3, _param4 and _param5 +respectively since proxy textures might have scaled them to fit the +implementation.) Then the maximum level can be derived from the formula +${log sub 2} ( max (_eqnparam3,_eqnparam4,_eqnparam5))$. +.P +_cmnd is only available if the GLU version is 1.3 or greater. +.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 only available if the GL version +is 1.2 or greater. +.SH ERRORS +_gluconst(INVALID_VALUE) is returned if _param3, _param4, or _param5 is < 1. +.P +_gluconst(INVALID_ENUM) is returned if _param2, _param6, or _param7 is not +legal. +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_BYTE_3_3_2) or _const(UNSIGNED_BYTE_2_3_3_REV) +and _param6 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_SHORT_5_6_5) or _const(UNSIGNED_SHORT_5_6_5_REV) +and _param6 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_SHORT_4_4_4_4) or _const(UNSIGNED_SHORT_4_4_4_4_REV) +and _param6 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_SHORT_5_5_5_1) or _const(UNSIGNED_SHORT_1_5_5_5_REV) +and _param6 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _const(UNSIGNED_INT_8_8_8_8) or _const(UNSIGNED_INT_8_8_8_8_REV) +and _param6 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param7 is _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 SEE ALSO +_glcmnd(DrawPixels), +_glcmnd(TexImage1D), +_glcmnd(TexImage2D), +_glcmnd(TexImage3D), +_cmnd(Build1DMipmaps), +_cmnd(Build3DMipmaps), +_cmnd(ErrorString), +_glcmnd(GetTexImage), +_glcmnd(GetTexLevelParameter), +_cmnd(Build1DMipmapLevels), +_cmnd(Build2DMipmapLevels), +_cmnd(Build3DMipmapLevels) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/c b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/c new file mode 100644 index 000000000..8cbb4d3ad --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/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/manglu/standard/checkextension.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/checkextension.gl new file mode 100644 index 000000000..8af968bc6 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/checkextension.gl @@ -0,0 +1,68 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(CheckExtension, determines if an extension name is supported) +_names(CheckExtension) +.SH PARAMETERS +_phead(_param1) +Specifies an extension name. +_phead(_param2) +Specifies a space-separated list of extension names supported. +.SH DESCRIPTION +_cmnd returns _const(TRUE) if _param1 is supported otherwise +_const(FALSE) is returned. +.P +This is used to check for the presence for OpenGL, GLU or GLX extension names +by passing the extension strings returned by _glcmnd(GetString), +_cmnd(GetString), _glcmnd(XGetClientString), +_glcmnd(XQueryExtensionsString), or _glcmnd(XQueryServerString), +respectively, as _param2. +.SH NOTES +Cases where one extension name is a substring of another are +correctly handled. +.P +There may or may not be leading or trailing blanks in _param2. +.P +Extension names should not contain embedded spaces. +.P +All strings are null-terminated. +.SH SEE ALSO +_glcmnd(GetString), +_cmnd(GetString), +_glcmnd(XGetClientString), +_glcmnd(XQueryExtensionsString), +_glcmnd(XQueryServerString) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/cylinder.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/cylinder.gl new file mode 100644 index 000000000..f50e3e60c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/cylinder.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Cylinder, draw a cylinder) +_names(Cylinder) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the quadrics object (created with _cmnd(NewQuadric)). +_phead(_param2) +Specifies the radius of the cylinder at \f2z\fP = 0. +_phead(_param3) +Specifies the radius of the cylinder at \f2z\fP = _param4. +_phead(_param4) +Specifies the height of the cylinder. +_phead(_param5) +Specifies the number of subdivisions around the \f2z\fP axis. +_phead(_param6) +Specifies the number of subdivisions along the \f2z\fP axis. +.SH DESCRIPTION +_cmnd draws a cylinder oriented along the \f2z\fP axis. The base of the cylinder +is placed at \f2z\fP = 0, and the top at $ z ~=~ _eqnparam4 $. Like a sphere, +a cylinder is subdivided around the \f2z\fP axis into slices, and along the +\f2z\fP axis into stacks. +.P +Note that if _param3 is set to 0.0, this routine generates a cone. +.P +If the orientation is set to _gluconst(OUTSIDE) +(with _cmnd(QuadricOrientation)), then any generated normals +point away from the \f2z\fP axis. Otherwise, they point toward the +\f2z\fP axis. +.P +If texturing is turned on (with _cmnd(QuadricTexture)), then texture +coordinates are generated so that \f2t\fP ranges linearly from 0.0 +at \f2z\fP = 0 to 1.0 at \f2z\fP = _param4, and \f2s\fP +ranges from 0.0 at the +\f2y\fP axis, to 0.25 at the +\f2x\fP axis, +to 0.5 at the -\f2y\fP axis, to 0.75 at the \-\f2x\fP axis, +and back to 1.0 at the +\f2y\fP axis. +.SH SEE ALSO +_cmnd(Disk), _cmnd(NewQuadric), _cmnd(PartialDisk), _cmnd(QuadricTexture), +_cmnd(Sphere) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/deletenurbsrenderer.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/deletenurbsrenderer.gl new file mode 100644 index 000000000..d46145dd9 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/deletenurbsrenderer.gl @@ -0,0 +1,52 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(DeleteNurbsRenderer, destroy a NURBS object) +_names(DeleteNurbsRenderer) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object to be destroyed. +.SH DESCRIPTION +_cmnd destroys the NURBS object (which was created with +_cmnd(NewNurbsRenderer)) and frees any memory it uses. +Once +_cmnd has been called, _param1 cannot be used again. +.SH SEE ALSO +_cmnd(NewNurbsRenderer) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/deletequadric.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/deletequadric.gl new file mode 100644 index 000000000..08932a89b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/deletequadric.gl @@ -0,0 +1,52 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(DeleteQuadric, destroy a quadrics object) +_names(DeleteQuadric) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the quadrics object to be destroyed. +.SH DESCRIPTION +_cmnd destroys the quadrics object (created with _cmnd(NewQuadric)) +and frees any memory it uses. +Once _cmnd has been called, _param1 cannot be used again. +.SH SEE ALSO +_cmnd(NewQuadric) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/deletetess.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/deletetess.gl new file mode 100644 index 000000000..de1465423 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/deletetess.gl @@ -0,0 +1,51 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(DeleteTess, destroy a tessellation object) +_names(DeleteTess) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object to destroy. +.SH DESCRIPTION +_cmnd destroys the indicated tessellation object (which was created +with _cmnd(NewTess)) and frees any memory that it used. +.SH SEE ALSO +_cmnd(BeginPolygon), _cmnd(NewTess), _cmnd(TessCallback) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/disk.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/disk.gl new file mode 100644 index 000000000..232cf7af5 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/disk.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Disk, draw a disk) +_names(Disk) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the quadrics object (created with _cmnd(NewQuadric)). +_phead(_param2) +Specifies the inner radius of the disk (may be 0). +_phead(_param3) +Specifies the outer radius of the disk. +_phead(_param4) +Specifies the number of subdivisions around the \f2z\fP axis. +_phead(_param5) +Specifies the number of concentric rings about the origin into which +the disk is subdivided. +.SH DESCRIPTION +_cmnd renders a disk on the \f2z\fP = 0 plane. The disk has a radius of +_param3, and contains a concentric circular hole with a radius +of _param2. If _param2 is 0, then no hole is generated. The disk is +subdivided around the \f2z\fP axis into slices (like pizza slices), and also +about the \f2z\fP axis into rings +(as specified by _param4 and _param5, respectively). +.P +With respect to orientation, the +\f2z\fP side of the disk is considered to be +"outside" (see _cmnd(QuadricOrientation)). +This means that if the +orientation is set to _gluconst(OUTSIDE), then any normals generated +point along the +\f2z\fP axis. Otherwise, they point along the \-\f2z\fP +axis. +.P +If texturing has been turned on (with _cmnd(QuadricTexture)), +texture coordinates are generated +linearly such that where $ r ~=~ _eqnparam3 $, the value at (\f2r\fP, 0, 0) is +(1, 0.5), at (0, \f2r\fP, 0) it is (0.5, 1), at (\-\f2r\fP, 0, 0) +it is (0, 0.5), and +at (0, \-\f2r\fP, 0) it is (0.5, 0). +.SH SEE ALSO +_cmnd(Cylinder), _cmnd(NewQuadric), _cmnd(PartialDisk), +_cmnd(QuadricOrientation), +_cmnd(QuadricTexture), _cmnd(Sphere) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/errorstring.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/errorstring.gl new file mode 100644 index 000000000..aae56d5ca --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/errorstring.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(ErrorString, produce an error string from a GL or GLU error code) +_names(ErrorString) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a GL or GLU error code. +.SH DESCRIPTION +_cmnd produces an error string from a GL or GLU error code. The string +is in ISO Latin 1 format. For example, +_cmnd(ErrorString)(_const(OUT_OF_MEMORY)) returns the string +\f2out of memory\fP. +.P +The standard GLU error codes are _gluconst(INVALID_ENUM), +_gluconst(INVALID_VALUE), +and _gluconst(OUT_OF_MEMORY). +Certain other GLU functions can return specialized error codes +through callbacks. +See the _glcmnd(GetError) reference page for the list of +GL error codes. +.SH ERRORS +_xconst(NULL) is returned if _param1 is not a valid GL or GLU error code. +.SH SEE ALSO +_glcmnd(GetError), +_cmnd(NurbsCallback), +_cmnd(QuadricCallback), +_cmnd(TessCallback) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/getnurbsproperty.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/getnurbsproperty.gl new file mode 100644 index 000000000..e27df675e --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/getnurbsproperty.gl @@ -0,0 +1,68 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(GetNurbsProperty, get a NURBS property) +_names(GetNurbsProperty) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +_phead(_param2) +Specifies the property whose value is to be fetched. Valid values are +_gluconst(CULLING), +_gluconst(SAMPLING_TOLERANCE), +_gluconst(DISPLAY_MODE), +_gluconst(AUTO_LOAD_MATRIX), +_gluconst(PARAMETRIC_TOLERANCE), +_gluconst(SAMPLING_METHOD), +_gluconst(U_STEP), +_gluconst(V_STEP) and +_gluconst(NURBS_MODE). +_phead(_param3) +Specifies a pointer to the location into which the value of the +named property is written. +.SH DESCRIPTION +_cmnd retrieves properties stored in a NURBS object. These +properties affect the way that NURBS curves and surfaces +are rendered. See the +_cmnd(NurbsProperty) reference page for information about what the +properties are and what they do. +.SH SEE ALSO +_cmnd(NewNurbsRenderer), +_cmnd(NurbsProperty) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/getstring.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/getstring.gl new file mode 100644 index 000000000..449d5de88 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/getstring.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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 GLU version or GLU extensions ) +_names(GetString) +.SH PARAMETERS +_phead(_param1) +Specifies a symbolic constant, one of +_gluconst(VERSION), or _gluconst(EXTENSIONS). +.SH DESCRIPTION +_cmnd returns a pointer to a static string describing the +GLU version or the GLU extensions that are supported. +.P +The version number is one of the following +forms: +.P +\f2major_number.minor_number\fP +.br +\f2major_number.minor_number.release_number\fP. +.P +The version string is of the following form: +.P +\f2version number<space>vendor-specific information\fP +.P +Vendor-specific information is optional. +Its format and contents depend on the implementation. +.P +The standard GLU contains a basic set of features and capabilities. +If a company or group of companies wish to support other features, +these may be included as extensions to the GLU. +If _param1 is +_gluconst(EXTENSIONS), then _cmnd +returns a space-separated list of names of supported GLU extensions. +(Extension names never contain spaces.) +.P +All strings are null-terminated. +.SH NOTES +_cmnd only returns information about GLU extensions. Call +@<\f3glGetString\fP>@dnl + to get a list of GL extensions. +.P +_cmnd is an initialization routine. Calling it after +a _glcmnd(NewList) results in undefined behavior. +.SH ERRORS +NULL is returned if _param1 is not +_gluconst(VERSION) or _gluconst(EXTENSIONS). +.P +.SH SEE ALSO +@<\f3glGetString\fP>@dnl + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/gettessproperty.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/gettessproperty.gl new file mode 100644 index 000000000..61b903b5a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/gettessproperty.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(GetTessProperty, get a tessellation object property) +_names(GetTessProperty) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +_phead(_param2) +Specifies the property whose value is to be fetched. Valid values are +_gluconst(TESS_WINDING_RULE), +_gluconst(TESS_BOUNDARY_ONLY), and +_gluconst(TESS_TOLERANCE). +_phead(_param3) +Specifies a pointer to the location into which the value of the +named property is written. +.SH DESCRIPTION +_cmnd retrieves properties stored in a tessellation object. These +properties affect the way that tessellation objects +are interpreted and rendered. See the +_cmnd(TessProperty) reference page for information about the +properties and what they do. +.SH SEE ALSO +_cmnd(NewTess), +_cmnd(TessProperty) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/loadsamplingmatrices.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/loadsamplingmatrices.gl new file mode 100644 index 000000000..232a0624b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/loadsamplingmatrices.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(LoadSamplingMatrices, load NURBS sampling and culling matrices) +_names(LoadSamplingMatrices) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +_phead(_param2) +Specifies a modelview matrix (as from a _glcmnd(GetFloatv) call). +_phead(_param3) +Specifies a projection matrix (as from a _glcmnd(GetFloatv) call). +_phead(_param4) +Specifies a viewport (as from a _glcmnd(GetIntegerv) call). +.SH DESCRIPTION +_cmnd uses _param2, _param3, and _param4 to recompute the sampling and culling +matrices stored in _param1. +The sampling matrix determines how finely a NURBS curve or surface +must be tessellated to satisfy the sampling tolerance (as determined by the +_gluconst(SAMPLING_TOLERANCE) property). +The culling matrix is used in deciding if a NURBS curve or surface +should be culled before +rendering (when the _gluconst(CULLING) property is turned on). +.P +_cmnd is necessary only if the _gluconst(AUTO_LOAD_MATRIX) property is turned +off (see _cmnd(NurbsProperty)). +Although it can be convenient to leave the _gluconst(AUTO_LOAD_MATRIX) +property turned on, there can be a performance penalty for doing so. +(A round trip to the GL server is needed to fetch the current values +of the modelview matrix, projection matrix, and viewport.) +.SH SEE ALSO +_cmnd(GetNurbsProperty), +_cmnd(NewNurbsRenderer), +_cmnd(NurbsProperty) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/lookat.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/lookat.gl new file mode 100644 index 000000000..09189de06 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/lookat.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(LookAt, define a viewing transformation) +_names(LookAt) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2 _param3) +Specifies the position of the eye point. +_phead(_param4 _param5 _param6) +Specifies the position of the reference point. +_phead(_param7 _param8 _param9) +Specifies the direction of the \f2up\fP vector. +.SH DESCRIPTION +_cmnd creates a viewing matrix derived from an eye point, a reference +point indicating the center of the scene, and an \f2UP\fP vector. +.P +The matrix +maps the reference point to the negative \f2z\fP axis and the +eye point to the origin. +When a typical projection matrix is used, +the center of the scene therefore maps to the center of the viewport. +Similarly, the direction described by the \f2UP\fP +vector projected onto the viewing plane is mapped to the positive \f2y\fP +axis so that it points upward in the viewport. +The \f2UP\fP vector must not be parallel to the line of sight from the +eye point to the reference point. +.P +Let +.sp +.EQ +F ~=~ left ( down 20 { ~ matrix { + ccol {_eqnparam4 above _eqnparam5 above _eqnparam6} + ccol { ~-~ above ~-~ above ~-~} + ccol {_eqnparam1 above _eqnparam2 above _eqnparam3} +} } ~~ right ) + +.EN + +.sp +Let \f2UP\fP be the vector $(_eqnparam7, _eqnparam8, _eqnparam9)$. +.P +Then normalize as follows: +.EQ +f ~=~ F over {|| F ||} +.EN +.P +.EQ +UP sup prime ~=~ UP over {|| UP ||} +.EN +.sp +.P +Finally, let $s ~=~ f ~times~ UP sup prime$, and $u ~=~ s ~times~ f$. +.P +.sp +M is then constructed as follows: +.EQ +M ~=~ left ( matrix { + ccol { ~s[0] above ~u[0] above -f[0] above 0 } + ccol { ~s[1] above ~u[1] above -f[1] above 0 } + ccol { ~s[2] above ~u[2] above -f[2] above 0 } + ccol { 0 above 0 above 0 above 1 } +} ~~right ) +.EN +.P +and _cmnd is equivalent to +.Ex +glMultMatrixf(M); +glTranslated (-eyex, -eyey, -eyez); +.Ee +.SH SEE ALSO +_glcmnd(Frustum), _cmnd(Perspective) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/newnurbsrenderer.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/newnurbsrenderer.gl new file mode 100644 index 000000000..f283c558d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/newnurbsrenderer.gl @@ -0,0 +1,51 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NewNurbsRenderer, create a NURBS object) +_names(NewNurbsRenderer) +.EQ +delim $$ +.EN +.SH DESCRIPTION +_cmnd creates and returns a pointer to +a new NURBS object. +This object must be referred to when calling +NURBS rendering and control functions. A return value of +0 means that there is not enough memory to allocate the object. +.SH SEE ALSO +_cmnd(BeginCurve), _cmnd(BeginSurface), _cmnd(BeginTrim), _cmnd(DeleteNurbsRenderer), _cmnd(NurbsCallback), _cmnd(NurbsProperty) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/newquadric.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/newquadric.gl new file mode 100644 index 000000000..32c9f4ae0 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/newquadric.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NewQuadric, create a quadrics object) +_names(NewQuadric) +.EQ +delim $$ +.EN +.SH DESCRIPTION +_cmnd creates and returns a pointer to +a new quadrics object. This object must be referred to when +calling quadrics rendering and control functions. A return value of +0 means that there is not enough memory to allocate the object. +.SH SEE ALSO +_cmnd(Cylinder), _cmnd(DeleteQuadric), _cmnd(Disk), +_cmnd(PartialDisk), _cmnd(QuadricCallback), _cmnd(QuadricDrawStyle), +_cmnd(QuadricNormals), _cmnd(QuadricOrientation), +_cmnd(QuadricTexture), +_cmnd(Sphere) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/newtess.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/newtess.gl new file mode 100644 index 000000000..e3883d042 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/newtess.gl @@ -0,0 +1,50 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NewTess, create a tessellation object) +_names(NewTess) +.EQ +delim $$ +.EN +.SH DESCRIPTION +_cmnd creates and returns a pointer to a new tessellation object. +This object must be referred to when calling +tessellation functions. A return value of +0 means that there is not enough memory to allocate the object. +.SH SEE ALSO +_cmnd(TessBeginPolygon), _cmnd(DeleteTess), _cmnd(TessCallback) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nextcontour.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nextcontour.gl new file mode 100644 index 000000000..2717d4dc4 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nextcontour.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NextContour, mark the beginning of another contour) +_names(NextContour) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +_phead(_param2) +Specifies the type of the contour being defined. Valid values are +_gluconst(EXTERIOR), +_gluconst(INTERIOR), +_gluconst(UNKNOWN), +_gluconst(CCW), and +_gluconst(CW). +.SH DESCRIPTION +_cmnd is used in describing polygons with multiple contours. After the first +contour has been described through a series of _cmnd(TessVertex) calls, +a _cmnd call indicates that the previous contour is complete and that the +next contour is about to begin. +Another series of _cmnd(TessVertex) calls is then used to describe the new +contour. This process can be repeated until all contours have been described. +.P +_param2 defines what type of contour follows. +The legal contour types are as follows: +.TP 18 +_gluconst(EXTERIOR) +An exterior contour defines an exterior boundary of the polygon. +.TP +_gluconst(INTERIOR) +An interior contour defines an interior boundary of the polygon (such as +a hole). +.TP +_gluconst(UNKNOWN) +An unknown contour is analyzed by the library to determine if it is interior +or exterior. +.TP +_gluconst(CCW), +.TP +_gluconst(CW) +The first _gluconst(CCW) or _gluconst(CW) contour defined is considered to +be exterior. All other contours are considered to be exterior if they +are oriented in the same direction (clockwise or counterclockwise) as +the first contour, and interior if they are not. +.P +If one contour is of type _gluconst(CCW) or _gluconst(CW), then all +contours must be of the same type (if they are not, then all _gluconst(CCW) +and _gluconst(CW) contours will be changed to _gluconst(UNKNOWN)). +.P +Note that there is no real difference between the _gluconst(CCW) and +_gluconst(CW) contour types. +.P +Before the first contour is described, _cmnd can be called to +define the type of the first contour. +If _cmnd is not called before the first contour, then the first contour is +marked _gluconst(EXTERIOR). +.P +This command is obsolete and is provided for backward compatibility +only. Calls to _cmnd are mapped to _cmnd(TessEndContour) +followed by +_cmnd(TessBeginContour). +.SH EXAMPLE +A quadrilateral with a triangular hole in it can be described as follows: +.sp +.Ex +gluBeginPolygon(tobj); + gluTessVertex(tobj, v1, v1); + gluTessVertex(tobj, v2, v2); + gluTessVertex(tobj, v3, v3); + gluTessVertex(tobj, v4, v4); +gluNextContour(tobj, GLU_INTERIOR); + gluTessVertex(tobj, v5, v5); + gluTessVertex(tobj, v6, v6); + gluTessVertex(tobj, v7, v7); +gluEndPolygon(tobj); +.Ee +.SH SEE ALSO +_cmnd(BeginPolygon), _cmnd(NewTess), _cmnd(TessCallback), _cmnd(TessVertex), +_cmnd(TessBeginContour) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscallback.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscallback.gl new file mode 100644 index 000000000..953d01bca --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscallback.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NurbsCallback, define a callback for a NURBS object) +_names(NurbsCallback) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +_phead(_param2) +Specifies the callback being defined. +Valid values are _gluconst(NURBS_BEGIN), _gluconst(NURBS_VERTEX), _gluconst(NURBS_NORMAL), _gluconst(NURBS_COLOR), _gluconst(NURBS_TEXTURE_COORD), _gluconst(NURBS_END), _gluconst(NURBS_BEGIN_DATA), _gluconst(NURBS_VERTEX_DATA), _gluconst(NURBS_NORMAL_DATA), _gluconst(NURBS_COLOR_DATA), _gluconst(NURBS_TEXTURE_COORD_DATA), _gluconst(NURBS_END_DATA), and _gluconst(NURBS_ERROR). +_phead(_param3) +Specifies the function that the callback calls. +.SH DESCRIPTION +_cmnd is used to define a callback to be used by a NURBS +object. +If the specified callback is already defined, then it is replaced. If +_param3 is NULL, then this callback will not get +invoked and the related data, if any, will be lost. +.P +Except the error callback, these callbacks are used by NURBS tessellator (when _gluconst(NURBS_MODE) is set to be _gluconst(NURBS_TESSELLATOR)) to return back the OpenGL +polygon primitives resulting from the tessellation. Note that there are two +versions of each callback: one with a user data pointer and one without. If both versions for a particular callback are specified then the callback with +the user data pointer will be used. Note that ``userData'' is a copy of the pointer that was specified at the last call to _cmnd(NurbsCallbackData). +.P +The error callback function is effective no matter which value that +_gluconst(NURBS_MODE) is set to. +All other callback functions are effective only when _gluconst(NURBS_MODE) +is set to _gluconst(NURBS_TESSELLATOR). +.P +The legal callbacks are as follows: +.TP 10 +_gluconst(NURBS_BEGIN) +The begin callback indicates the start of a primitive. The function +takes a single argument of type GLenum, which can be one of +_const(LINES), _const(LINE_STRIP), _const(TRIANGLE_FAN), _const(TRIANGLE_STRIP), _const(TRIANGLES), or _const(QUAD_STRIP). The +default begin callback function is NULL. The function prototype +for this callback looks like: +.RS +.Ex +void begin ( GLenum type ); +.Ee +.RE +.TP +_gluconst(NURBS_BEGIN_DATA) +The same as the _gluconst(NURBS_BEGIN) callback except that it takes an +additional pointer argument. This pointer is a copy of the pointer that +was specified at the last call to _cmnd(NurbsCallbackData). The +default callback function is NULL. The function prototype for this +callback function looks like: +.RS +.Ex +void beginData (GLenum type, void *userData); +.Ee +.RE +.TP +_gluconst(NURBS_VERTEX) +The vertex callback indicates a vertex of the primitive. The +coordinates of the vertex are stored in the parameter ``vertex''. All +the generated vertices have dimension 3, that is, homogeneous +coordinates have been transformed into affine coordinates. The default +vertex callback function is NULL. The function prototype for this +callback function looks like: +.RS +.Ex +void vertex ( GLfloat *vertex ); +.Ee +.RE +.TP +_gluconst(NURBS_VERTEX_DATA) +This is the same as the _gluconst(NURBS_VERTEX) callback, except that +it takes an additional pointer argument. This pointer is a copy of the +pointer that was specified at the last call to +_cmnd(NurbsCallbackData). The default callback function is NULL. The +function prototype for this callback function looks like: +.RS +.Ex +void vertexData ( GLfloat *vertex, void *userData ); +.Ee +.RE +.TP +_gluconst(NURBS_NORMAL) +The normal callback is invoked as the vertex normal is generated. +The components of the normal are stored in the parameter ``normal''. +In the case of a NURBS curve, the callback function is effective only when +the user provides a normal map (_const(MAP1_NORMAL)). +In the case of a NURBS surface, if a normal map (_const(MAP2_NORMAL)) is provided, then the generated normal is computed from the normal map. +If a normal map is not provided then a surface normal is computed in +a manner similar to that described for evaluators when _const(AUTO_NORMAL) +is enabled. +.bp +The default normal callback function is NULL. The function +prototype for this callback function looks like: +.RS +.Ex +void normal ( GLfloat *normal ); +.Ee +.RE +.TP +_gluconst(NURBS_NORMAL_DATA) +The same as the _gluconst(NURBS_NORMAL) callback except that it +takes an additional pointer argument. This pointer is a copy of the pointer +that was specified at the last call to _cmnd(NurbsCallbackData). The default callback function is NULL. The function prototype for this callback function looks like: +.RS +.Ex +void normalData ( GLfloat *normal, void *userData ); +.Ee +.RE +.TP +_gluconst(NURBS_COLOR) +The color callback is invoked as the color of a vertex is generated. +The components of the color are stored in the parameter ``color''. +This callback is effective only when the user provides a color map +(_const(MAP1_COLOR_4) or _const(MAP2_COLOR_4)). ``color'' contains four components: R,G,B,A. The default color callback function is NULL. The prototype for +this callback function looks like: +.RS +.Ex +void color ( GLfloat *color ); +.Ee +.RE +.TP +_gluconst(NURBS_COLOR_DATA) +The same as the _gluconst(NURBS_COLOR) callback except that it +takes an additional pointer argument. This pointer is a copy of the pointer +that was specified at the last call to _cmnd(NurbsCallbackData). The default callback function is NULL. The function prototype for this callback function looks like: +.RS +.Ex +void colorData ( GLfloat *color, void *userData ); +.Ee +.RE +.TP +_gluconst(NURBS_TEXTURE_COORD) +The texture callback is invoked as the texture coordinates +of a vertex are generated. These coordinates are stored in the parameter +``texCoord''. The number of texture coordinates can be 1, 2, 3, or 4 depending +on which type of texture map is specified +(_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), +_const(MAP2_TEXTURE_COORD_4)). +If no texture map is specified, this callback function will not be called. +.bp +The default texture callback function is NULL. The function prototype +for this callback function looks like: +.RS +.Ex +void texCoord ( GLfloat *texCoord ); +.Ee +.RE +.TP + _gluconst(NURBS_TEXTURE_COORD_DATA) +This is the same as the _gluconst(NURBS_TEXTURE_COORD) callback, except that it +takes an additional pointer argument. This pointer is a copy of the pointer +that was specified at the last call to _cmnd(NurbsCallbackData). The default callback function is NULL. The function prototype for this callback function looks like: +.RS +.Ex +void texCoordData (GLfloat *texCoord, void *userData); +.Ee +.RE +.TP +_gluconst(NURBS_END) +The end callback is invoked at the end of a primitive. The default end callback function is NULL. The function prototype for this callback function looks like: +.RS +.Ex +void end ( void ); +.Ee +.RE +.TP +_gluconst(NURBS_END_DATA) +This is the same as the _gluconst(NURBS_END) callback, except that it +takes an additional pointer argument. This pointer is a copy of the pointer +that was specified at the last call to _cmnd(NurbsCallbackData). The default callback function is NULL. The function prototype for this callback function looks like: +.RS +.Ex +void endData ( void *userData ); +.Ee +.RE +.TP +_gluconst(NURBS_ERROR) +The error function is called when an error is encountered. +Its single argument +is of type GLenum, and it indicates the specific error that occurred. +There are 37 errors unique to NURBS named +_gluconst(NURBS_ERROR1) through _gluconst(NURBS_ERROR37). +Character strings describing these errors can be retrieved with +_cmnd(ErrorString). +.bp +.SH NOTES +_cmnd is available only if the GLU version is 1.2 or greater. +.P +GLU version 1.2 supports only the _gluconst(ERROR) parameter for +_param2. The _gluconst(ERROR) value is deprecated in GLU version 1.3 in +favor of _gluconst(NURBS_ERROR). All other accepted values for _param3 +are available only if the GLU version is 1.3 or greater. +.SH SEE ALSO +_cmnd(ErrorString), +_cmnd(NewNurbsRenderer), +_cmnd(NurbsCallbackData), +_cmnd(NurbsProperty) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscallbackdata.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscallbackdata.gl new file mode 100644 index 000000000..95af5199a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscallbackdata.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NurbsCallbackData, set a user data pointer) +_names(NurbsCallbackData) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +_phead(_param2) +Specifies a pointer to the user's data. +.SH DESCRIPTION +_cmnd is used to pass a pointer to the application's data to NURBS +tessellator. A copy of this pointer will be passed by the tessellator +in the NURBS callback functions (set by _cmnd(NurbsCallback)). +.SH NOTES +_cmnd is available only if the GLU version is 1.3 or greater. +.SH SEE ALSO +_cmnd(NewNurbsRenderer), +_cmnd(NurbsCallback) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscallbackdataext.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscallbackdataext.gl new file mode 100644 index 000000000..168a3a9fd --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscallbackdataext.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NurbsCallbackDataEXT, set a user data pointer) +_names(NurbsCallbackDataEXT) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +_phead(_param2) +Specifies a pointer to the user's data. +.SH DESCRIPTION +_cmnd is used to pass a pointer to the application's data to NURBS +tessellator. A copy of this pointer will be passed by the tessellator +in the NURBS callback functions (set by _cmnd(NurbsCallback)). +.SH SEE ALSO +_cmnd(NurbsCallback) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscurve.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscurve.gl new file mode 100644 index 000000000..45dbb4235 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbscurve.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NurbsCurve, define the shape of a NURBS curve) +_names(NurbsCurve) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +_phead(_param2) +Specifies the number of knots in _param3. +_param2 equals the number of control points plus the order. +_phead(_param3) +Specifies an array of _param2 nondecreasing knot values. +_phead(_param4) +Specifies the offset (as a number of single-precision floating-point values) +between successive curve control points. +_phead(_param5) +Specifies a pointer to an array of control points. The coordinates must +agree with _param7, specified below. +_phead(_param6) +Specifies the order of the NURBS curve. _param6 equals degree + 1, hence +a cubic curve has an order of 4. +_phead(_param7) +Specifies the type of the curve. If this curve is defined within a +_cmnd(BeginCurve)/_cmnd(EndCurve) pair, then +the type can be any of the valid +one-dimensional evaluator types (such as _const(MAP1_VERTEX_3) or +_const(MAP1_COLOR_4)). Between a _cmnd(BeginTrim)/_cmnd(EndTrim) pair, +the only valid types are _gluconst(MAP1_TRIM_2) and _gluconst(MAP1_TRIM_3). +.SH DESCRIPTION +Use _cmnd to describe a NURBS curve. +.P +When _cmnd appears between a _cmnd(BeginCurve)/_cmnd(EndCurve) pair, it is +used to describe a curve to be rendered. +Positional, texture, and color coordinates are associated +by presenting each as a separate _cmnd between a +_cmnd(BeginCurve)/_cmnd(EndCurve) pair. No more than +one call to _cmnd for each of color, position, and texture +data can be made within a single _cmnd(BeginCurve)/_cmnd(EndCurve) +pair. Exactly one call must be made to describe the position of the +curve (a _param7 of _const(MAP1_VERTEX_3) or _const(MAP1_VERTEX_4)). +.P +When _cmnd appears between a _cmnd(BeginTrim)/_cmnd(EndTrim) pair, it is +used to describe a trimming curve on a NURBS surface. If _param7 is +_gluconst(MAP1_TRIM_2), then it describes a curve in two-dimensional (\f2u\fP +and \f2v\fP) +parameter space. If it is _gluconst(MAP1_TRIM_3), then it describes a +curve in two-dimensional homogeneous (\f2u\fP, \f2v\fP, and \f2w\fP) +parameter space. +See the _cmnd(BeginTrim) reference page for more discussion about trimming +curves. +.SH EXAMPLE +The following commands render a textured NURBS curve with normals: +.sp +.Ex +gluBeginCurve(nobj); + gluNurbsCurve(nobj, ..., GL_MAP1_TEXTURE_COORD_2); + gluNurbsCurve(nobj, ..., GL_MAP1_NORMAL); + gluNurbsCurve(nobj, ..., GL_MAP1_VERTEX_4); +gluEndCurve(nobj); +.Ee +.sp +.SH NOTES +To define trim curves which stitch well, use _cmnd(PwlCurve). +.SH SEE ALSO +_cmnd(BeginCurve), _cmnd(BeginTrim), _cmnd(NewNurbsRenderer), _cmnd(PwlCurve) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbsproperty.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbsproperty.gl new file mode 100644 index 000000000..6fbfbbc09 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbsproperty.gl @@ -0,0 +1,215 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NurbsProperty, set a NURBS property) +_names(NurbsProperty) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +_phead(_param2) +Specifies the property to be set. Valid values are +_gluconst(SAMPLING_TOLERANCE), +_gluconst(DISPLAY_MODE), +_gluconst(CULLING), +_gluconst(AUTO_LOAD_MATRIX), +_gluconst(PARAMETRIC_TOLERANCE), +_gluconst(SAMPLING_METHOD), +_gluconst(U_STEP), +_gluconst(V_STEP), or +_gluconst(NURBS_MODE). +_phead(_param3) +Specifies the value of the indicated property. +It may be a numeric value, or one of +_gluconst(OUTLINE_POLYGON), +_gluconst(FILL), +_gluconst(OUTLINE_PATCH), +_const(TRUE), +_const(FALSE), +_gluconst(PATH_LENGTH), +_gluconst(PARAMETRIC_ERROR), +_gluconst(DOMAIN_DISTANCE), +_gluconst(NURBS_RENDERER), or +_gluconst(NURBS_TESSELLATOR). +.SH DESCRIPTION +_cmnd is used to control properties stored in a NURBS object. These +properties affect the way that a NURBS curve is rendered. The accepted +values for _param2 are as follows: +.TP 15 +_gluconst(NURBS_MODE) +_param3 should be set to be either _gluconst(NURBS_RENDERER) or +_gluconst(NURBS_TESSELLATOR). When set to _gluconst(NURBS_RENDERER), NURBS objects +are tessellated into OpenGL primitives and sent to the pipeline for +rendering. When set to _gluconst(NURBS_TESSELLATOR), NURBS objects are +tessellated into OpenGL primitives but the vertices, normals, colors, and/or textures are +retrieved back through a callback interface (see _cmnd(NurbsCallback)). This allows the user to cache the +tessellated results for further processing. +The initial value is _gluconst(NURBS_RENDERER). +.TP +_gluconst(SAMPLING_METHOD) +Specifies how a NURBS surface should be +tessellated. +_param3 may be one of _gluconst(PATH_LENGTH), +_gluconst(PARAMETRIC_ERROR), _gluconst(DOMAIN_DISTANCE), +_gluconst(OBJECT_PATH_LENGTH), or +_gluconst(OBJECT_PARAMETRIC_ERROR). +When set to _gluconst(PATH_LENGTH), the surface is rendered so that +the maximum length, in +pixels, of the edges of the tessellation polygons is no greater than +what is specified by _gluconst(SAMPLING_TOLERANCE). +.IP +_gluconst(PARAMETRIC_ERROR) specifies that the surface is rendered in such a +way that the value specified by _gluconst(PARAMETRIC_TOLERANCE) describes the +maximum distance, in pixels, between the tessellation polygons and the +surfaces they approximate. +.IP +_gluconst(DOMAIN_DISTANCE) allows users to specify, in parametric coordinates, +how many sample points per unit length are taken in \f2u\fP, \f2v\fP +direction. +.IP +_gluconst(OBJECT_PATH_LENGTH) is similar to _gluconst(PATH_LENGTH) +except that it is view independent, that is, the surface is rendered so that the maximum length, in object space, of edges of the tessellation polygons is no greater than what is specified by _gluconst(SAMPLING_TOLERANCE). +.IP +_gluconst(OBJECT_PARAMETRIC_ERROR) is similar to _gluconst(PARAMETRIC_ERROR) except that it is view independent, that is, the surface is rendered in such a way that the value specified by _gluconst(PARAMETRIC_TOLERANCE) describes the maximum distance, in object space, between the tessellation polygons and the surfaces they approximate. +.IP +The initial value of _gluconst(SAMPLING_METHOD) is _gluconst(PATH_LENGTH). +.TP +_gluconst(SAMPLING_TOLERANCE) +Specifies the maximum length, in pixels or in object space length unit, +to use when the sampling method is set to _gluconst(PATH_LENGTH) or +_gluconst(OBJECT_PATH_LENGTH). +The NURBS code is conservative when rendering a curve +or surface, so the actual length can be somewhat shorter. The initial +value is 50.0 pixels. +.TP +_gluconst(PARAMETRIC_TOLERANCE) +Specifies the maximum distance, in pixels or in object space length unit, +to use when the sampling method is _gluconst(PARAMETRIC_ERROR) or +_gluconst(OBJECT_PARAMETRIC_ERROR). +The initial value is 0.5. +.TP +_gluconst(U_STEP) +Specifies the number of sample points per unit length taken +along the \f2u\fP axis in parametric coordinates. It is needed when +_gluconst(SAMPLING_METHOD) is set to _gluconst(DOMAIN_DISTANCE). +The initial value is 100. +.TP +_gluconst(V_STEP) +Specifies the number of sample points per unit length taken +along the \f2v\fP axis in parametric coordinate. It is needed when +_gluconst(SAMPLING_METHOD) is set to _gluconst(DOMAIN_DISTANCE). The initial +value is 100. +.TP +_gluconst(DISPLAY_MODE) +_param3 can be set to +_gluconst(OUTLINE_POLYGON), _gluconst(FILL), or +_gluconst(OUTLINE_PATCH). +When _gluconst(NURBS_MODE) is set to be _gluconst(NURBS_RENDERER), +_param3 defines how a NURBS surface should be rendered. +When _param3 is set to _gluconst(FILL), the surface is rendered as a +set of polygons. When _param3 is set to +_gluconst(OUTLINE_POLYGON), the NURBS library draws only the outlines +of the polygons created by tessellation. When _param3 is set to +_gluconst(OUTLINE_PATCH) just the outlines of patches and trim +curves defined by the user are drawn. +.IP +When _gluconst(NURBS_MODE) is set to be _gluconst(NURBS_TESSELLATOR), +_param3 defines how a NURBS surface should be tessellated. +When _gluconst(DISPLAY_MODE) is set to _gluconst(FILL) or +_gluconst(OUTLINE_POLYGON), +the NURBS surface is tessellated into OpenGL triangle primitives which can be +retrieved back through callback functions. If _gluconst(DISPLAY_MODE) is set to +_gluconst(OUTLINE_PATCH), only the outlines of the patches and trim curves are generated as a sequence of line strips which can be retrieved back through callback functions. +.IP +The initial value is _gluconst(FILL). +.TP +_gluconst(CULLING) +_param3 is a boolean value that, when set to _const(TRUE), indicates that +a NURBS curve should be discarded prior to tessellation if its control points +lie outside the current viewport. The initial value is _const(FALSE). +.TP +_gluconst(AUTO_LOAD_MATRIX) +_param3 is a boolean value. When set to _const(TRUE), the NURBS code +downloads the projection matrix, the modelview matrix, and the +viewport from the GL server to compute sampling and +culling +matrices for each NURBS curve that is rendered. Sampling and culling matrices +are required to determine the tessellation of a NURBS surface into line segments +or polygons and to cull a NURBS surface if it lies outside the viewport. +.IP +If this mode is set to _const(FALSE), then the program needs +to provide a projection matrix, a modelview matrix, and a viewport +for the NURBS renderer to use to construct sampling and culling matrices. +This can be done with the _cmnd(LoadSamplingMatrices) function. +This mode is initially set to _const(TRUE). +Changing it from _const(TRUE) to _const(FALSE) does not affect +the sampling and culling matrices until +_cmnd(LoadSamplingMatrices) +is called. +.SH NOTES +If _gluconst(AUTO_LOAD_MATRIX) is true, sampling and culling may be +executed incorrectly if NURBS routines are compiled into a display list. +.P +A _param2 of +_gluconst(PARAMETRIC_TOLERANCE), +_gluconst(SAMPLING_METHOD), +_gluconst(U_STEP), or +_gluconst(V_STEP), +or a _param3 of +_gluconst(PATH_LENGTH), +_gluconst(PARAMETRIC_ERROR), +_gluconst(DOMAIN_DISTANCE) +are only available if the GLU version is 1.1 or greater. They are not +valid parameters in GLU 1.0. +.P +_cmnd(GetString) can +be used to determine the GLU version. +.P +_gluconst(NURBS_MODE) is only availble if the GLU version is 1.3 or +greater. +.P +The _gluconst(OBJECT_PATH_LENGTH) and _gluconst(OBJECT_PARAMETRIC_ERROR) +values for the _gluconst(SAMPLING_METHOD) property are only available if +the GLU version is 1.3 or greater. +.SH SEE ALSO +_cmnd(GetNurbsProperty), +_cmnd(LoadSamplingMatrices), +_cmnd(NewNurbsRenderer), +_cmnd(GetString), +_cmnd(NurbsCallback) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbssurface.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbssurface.gl new file mode 100644 index 000000000..4c18c011b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/nurbssurface.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(NurbsSurface, define the shape of a NURBS surface) +_names(NurbsSurface) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +_phead(_param2) +Specifies the number of knots in the parametric \f2u\fP direction. +_phead(_param3) +Specifies an array of _param2 nondecreasing knot values in the parametric +\f2u\fP direction. +_phead(_param4) +Specifies the number of knots in the parametric \f2v\fP direction. +_phead(_param5) +Specifies an array of _param4 nondecreasing knot values in the parametric +\f2v\fP direction. +_phead(_param6) +Specifies the offset (as a number of single-precision floating point values) +between successive control points in the parametric \f2u\fP direction +in _param8. +_phead(_param7) +Specifies the offset (in single-precision floating-point values) +between successive control points in the parametric \f2v\fP direction +in _param8. +_phead(_param8) +Specifies an array containing control points for the NURBS surface. +The offsets between successive control points in the parametric \f2u\fP +and \f2v\fP directions are given by _param6 and _param7. +_phead(_param9) +Specifies the order of the NURBS surface in the parametric \f2u\fP +direction. The order is one more than the degree, hence +a surface that is cubic in \f2u\fP has a \f2u\fP order of 4. +_phead(_param10) +Specifies the order of the NURBS surface in the parametric \f2v\fP +direction. The order is one more than the degree, hence +a surface that is cubic in \f2v\fP has a \f2v\fP order of 4. +_phead(_param11) +Specifies type of the surface. _param11 can be any of the valid +two-dimensional evaluator types (such as _const(MAP2_VERTEX_3) or +_const(MAP2_COLOR_4)). +.SH DESCRIPTION +Use _cmnd within a NURBS (Non-Uniform Rational B-Spline) surface +definition to describe the shape of a NURBS surface (before +any trimming). To mark the beginning of +a NURBS surface definition, use the _cmnd(BeginSurface) command. +To mark the end of a NURBS surface definition, use the +_cmnd(EndSurface) command. Call _cmnd within a NURBS +surface definition only. +.P +Positional, texture, and color coordinates are associated +with a surface by presenting each as a separate _cmnd between a +_cmnd(BeginSurface)/_cmnd(EndSurface) pair. No more than +one call to _cmnd for each of color, position, and texture +data can be made within a single _cmnd(BeginSurface)/_cmnd(EndSurface) +pair. Exactly one call must be made to describe the position of the +surface (a _param11 of _const(MAP2_VERTEX_3) or _const(MAP2_VERTEX_4)). +.P +A NURBS surface can be trimmed by using the commands +_cmnd(NurbsCurve) and _cmnd(PwlCurve) between calls to +_cmnd(BeginTrim) and _cmnd(EndTrim). +.P +Note that a _cmnd with _param2 knots in the \f2u\fP direction +and _param4 knots in the \f2v\fP direction with orders +_param9 and _param10 must have +(_param2 - _param9) $times$ (_param4 - _param10) control points. +.SH EXAMPLE +The following commands render a textured NURBS surface with normals; +the texture coordinates and normals are also NURBS surfaces: +.sp +.Ex +gluBeginSurface(nobj); + gluNurbsSurface(nobj, ..., GL_MAP2_TEXTURE_COORD_2); + gluNurbsSurface(nobj, ..., GL_MAP2_NORMAL); + gluNurbsSurface(nobj, ..., GL_MAP2_VERTEX_4); +gluEndSurface(nobj); +.Ee +.sp +.SH SEE ALSO +_cmnd(BeginSurface), _cmnd(BeginTrim), _cmnd(NewNurbsRenderer), +_cmnd(NurbsCurve), +_cmnd(PwlCurve) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/ortho2d.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/ortho2d.gl new file mode 100644 index 000000000..920690c8a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/ortho2d.gl @@ -0,0 +1,54 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Ortho2D, define a 2D orthographic projection matrix) +_names(Ortho2D) +.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. +.SH DESCRIPTION +_cmnd sets up a two-dimensional orthographic viewing region. +This is equivalent to calling _glcmnd(Ortho) with $ near ~=~ -1 $ and +$ far ~=~ 1 $. +.SH SEE ALSO +_glcmnd(Ortho), _cmnd(Perspective) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/partialdisk.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/partialdisk.gl new file mode 100644 index 000000000..a96755ebf --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/partialdisk.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(PartialDisk, draw an arc of a disk) +_names(PartialDisk) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies a quadrics object (created with _cmnd(NewQuadric)). +_phead(_param2) +Specifies the inner radius of the partial disk (can be 0). +_phead(_param3) +Specifies the outer radius of the partial disk. +_phead(_param4) +Specifies the number of subdivisions around the \f2z\fP axis. +_phead(_param5) +Specifies the number of concentric rings about the origin into which +the partial disk is subdivided. +_phead(_param6) +Specifies the starting angle, in degrees, of the disk portion. +_phead(_param7) +Specifies the sweep angle, in degrees, of the disk portion. +.SH DESCRIPTION +_cmnd renders a partial disk on the $ z ~=~ 0 $ plane. A partial disk is +similar to a full disk, except that only the subset of the disk from +_param6 through _param6 + _param7 is included (where 0 degrees is along the ++\f2y\f axis, +90 degrees along the +\f2x\fP axis, 180 degrees along the \-\f2y\fP axis, and +270 degrees along the \-\f2x\fP axis). +.P +The partial disk has a radius of +_param3, and contains a concentric circular hole with a radius +of _param2. If _param2 is 0, then no hole is generated. The partial disk is +subdivided around the \f2z\fP axis into slices (like pizza slices), and also +about the \f2z\fP axis into rings +(as specified by _param4 and _param5, respectively). +.P +With respect to orientation, the +\f2z\fP +side of the partial disk is considered to +be outside (see _cmnd(QuadricOrientation)). +This means that if the +orientation is set to _gluconst(OUTSIDE), then any normals generated +point along the +\f2z\fP axis. Otherwise, they point along the \-\f2z\fP +axis. +.P +If texturing is turned on (with _cmnd(QuadricTexture)), texture +coordinates are generated +linearly such that where $ r ~=~ _eqnparam3 $, the value at (\f2r\fP, 0, 0) is +(1.0, 0.5), at (0, \f2r\fP, 0) it is (0.5, 1.0), at (\-\f2r\fP, 0, 0) +it is (0.0, 0.5), and +at (0, \-\f2r\fP, 0) it is (0.5, 0.0). +.SH SEE ALSO +_cmnd(Cylinder), _cmnd(Disk), _cmnd(NewQuadric), _cmnd(QuadricOrientation), +_cmnd(QuadricTexture), +_cmnd(Sphere) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/perspective.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/perspective.gl new file mode 100644 index 000000000..c33fdbd91 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/perspective.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Perspective, set up a perspective projection matrix) +_names(Perspective) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the field of view angle, in degrees, in the \f2y\fP direction. +_phead(_param2) +Specifies the aspect ratio that determines +the field of view in the \f2x\fP direction. +The aspect ratio is the ratio of \f2x\fP (width) to \f2y\fP (height). +_phead(_param3) +Specifies the distance from the viewer to the near clipping plane +(always positive). +_phead(_param4) +Specifies the distance from the viewer to the far clipping plane +(always positive). +.SH DESCRIPTION +_cmnd specifies a viewing frustum into the world coordinate system. +In general, the aspect ratio in _cmnd should match the aspect ratio +of the associated viewport. For example, $ _eqnparam2 ~=~ 2.0 $ means +the viewer's +angle of view is twice as wide in \f2x\fP as it is in \f2y\fP. +If the viewport is +twice as wide as it is tall, it displays the image without distortion. +.P +The matrix generated by _cmnd is multipled by the current matrix, +just as if _glcmnd(MultMatrix) were called with the generated matrix. +To load the perspective matrix onto the current matrix stack instead, +precede the call to _cmnd with a call to _glcmnd(LoadIdentity). +.P +Given \f2f\fP defined as follows: +.sp +.ce +.EQ +f ~=~ cotangent"("{_eqnparam1 over 2}")" +.EN +.bp +The generated matrix is +.sp +.ce +.EQ +left ( ~~ down 130 { matrix { + ccol { {f over _eqnparam2} above 0 above 0 above 0 } + ccol { 0 above f above 0 above 0 } + ccol { 0 above 0 above {{_eqnparam4 + _eqnparam3} over {_eqnparam3 - _eqnparam4}} above -1 } + ccol { 0 above 0 above {{2 * _eqnparam4 * _eqnparam3} over {_eqnparam3 - _eqnparam4}} above 0} +}} ~~~ right ) +.EN + +.SH NOTES +Depth buffer precision is affected by the values specified for +_param3 and _param4. +The greater the ratio of _param4 to _param3 is, +the less effective the depth buffer will be at distinguishing between +surfaces that are near each other. +If +.sp +.ce +$r ~=~ _eqnparam4 over _eqnparam3$ +.sp +.P +roughly $log sub 2 r$ bits of depth buffer precision are lost. +Because $r$ approaches infinity as _param3 approaches 0, +_param3 must never be set to 0. +.SH SEE ALSO +_glcmnd(Frustum), _glcmnd(LoadIdentity), +_glcmnd(MultMatrix), _cmnd(Ortho2D) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/pickmatrix.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/pickmatrix.gl new file mode 100644 index 000000000..42d20c0f1 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/pickmatrix.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(PickMatrix, define a picking region) +_names(PickMatrix) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2) +Specify the center of a picking region in window coordinates. +_phead(_param3 _param4) +Specify the width and height, respectively, of the picking region in window +coordinates. +_phead(_param5) +Specifies the current viewport (as from a _glcmnd(GetIntegerv) call). +.SH DESCRIPTION +_cmnd creates a projection matrix that can be used to restrict drawing +to a small region of the viewport. +This is typically useful to +determine what objects are being drawn near the cursor. +Use _cmnd to +restrict drawing to a small region around the cursor. +Then, +enter selection mode (with _glcmnd(RenderMode)) and rerender the scene. +All primitives that would have been drawn near +the cursor are identified and stored in the selection buffer. +.P +The matrix created by _cmnd is multiplied by the current matrix just +as if _glcmnd(MultMatrix) is called with the generated matrix. +To effectively use the generated pick matrix for picking, +first call _glcmnd(LoadIdentity) to load an identity matrix onto the +perspective matrix stack. +Then call _cmnd, +and finally, call a command (such as _cmnd(Perspective)) +to multiply the perspective matrix by the pick matrix. +.P +When using _cmnd to pick NURBS, be careful to turn off the NURBS +property +_gluconst(AUTO_LOAD_MATRIX). If _gluconst(AUTO_LOAD_MATRIX) is not +turned off, then any NURBS surface rendered is subdivided differently with +the pick matrix than the way it was subdivided without the pick matrix. +.bp +.SH EXAMPLE +When rendering a scene as follows: +.sp +.Ex +glMatrixMode(GL_PROJECTION); +glLoadIdentity(); +gluPerspective(...); +glMatrixMode(GL_MODELVIEW); +/* Draw the scene */ +.Ee +.sp +a portion of the viewport can be selected as a pick region like this: +.sp +.Ex +glMatrixMode(GL_PROJECTION); +glLoadIdentity(); +gluPickMatrix(x, y, width, height, viewport); +gluPerspective(...); +glMatrixMode(GL_MODELVIEW); +/* Draw the scene */ +.Ee +.SH SEE ALSO +_glcmnd(Get), +_glcmnd(LoadIndentity), +_glcmnd(MultMatrix), +_glcmnd(RenderMode), +_cmnd(Perspective) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/project.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/project.gl new file mode 100644 index 000000000..51068e539 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/project.gl @@ -0,0 +1,91 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Project, map object coordinates to window coordinates) +_names(Project) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2 _param3) +Specify the object coordinates. +_phead(_param4) +Specifies the current modelview matrix (as from a _glcmnd(GetDoublev) call). +_phead(_param5) +Specifies the current projection matrix (as from a _glcmnd(GetDoublev) call). +_phead(_param6) +Specifies the current viewport (as from a _glcmnd(GetIntegerv) call). +_phead(_param7 _param8 _param9) +Return the computed window coordinates. +.SH DESCRIPTION +_cmnd transforms the specified object coordinates into window coordinates +using _param4, _param5, and _param6. The result is stored +in _param7, _param8, and _param9. A return value of +_const(TRUE) indicates success, a return value of _const(FALSE) +indicates failure. +.P +To compute the coordinates, +let $v ~=~ (_eqnparam1, _eqnparam2, _eqnparam3, 1.0)$ +represented as a matrix with 4 rows and 1 column. +Then _cmnd computes $v sup prime$ +as follows: +.sp +.EQ +v sup prime ~=~ P ~times~ M ~times~ v +.EN +.sp +where $P$ is the current projection matrix _param5, $M$ is the current +modelview matrix _param4 (both represented as +$4 times 4$ matrices in column-major order) and '$times$' represents +matrix multiplication. +.P +The window coordinates are then computed as follows: +.sp +.EQ +_eqnparam7 ~=~ _eqnparam6 (0) ~+~ _eqnparam6 (2) ~*~ (v sup prime (0) ~+~ 1)~/~2 +.EN +.sp +.EQ +_eqnparam8 ~=~ _eqnparam6 (1) ~+~ _eqnparam6 (3)~*~(v sup prime (1) ~+~ 1)~/~2 .EN +.sp +.EQ +_eqnparam9 ~=~ (v sup prime (2) ~+~ 1)~/~ 2 +.EN +.sp +.SH SEE ALSO +_glcmnd(Get), _cmnd(UnProject) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/pwlcurve.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/pwlcurve.gl new file mode 100644 index 000000000..52f391d54 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/pwlcurve.gl @@ -0,0 +1,78 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(PwlCurve, describe a piecewise linear NURBS trimming curve) +_names(PwlCurve) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the NURBS object (created with _cmnd(NewNurbsRenderer)). +_phead(_param2) +Specifies the number of points on the curve. +_phead(_param3) +Specifies an array containing the curve points. +_phead(_param4) +Specifies the offset (a number of single-precision floating-point values) +between points on the curve. +_phead(_param5) +Specifies the type of curve. +Must be either _gluconst(MAP1_TRIM_2) or _gluconst(MAP1_TRIM_3). +.SH DESCRIPTION +_cmnd describes a piecewise linear trimming curve for a NURBS surface. +A piecewise linear curve consists of a list of +coordinates of points in the parameter space for the +NURBS surface to be trimmed. These points are connected +with line segments to form a curve. If the curve is +an approximation to a curve that is not piecewise linear, +the points should be close enough in parameter space that the +resulting path appears curved at the resolution used in the application. +.P +If _param5 is +_gluconst(MAP1_TRIM_2), then it describes a curve in two-dimensional (\f2u\fP +and \f2v\fP) parameter space. If it is _gluconst(MAP1_TRIM_3), then it +describes a curve in two-dimensional homogeneous (\f2u\fP, \f2v\fP, +and \f2w\fP) parameter space. +See the _cmnd(BeginTrim) reference page for more information +about trimming curves. +.SH NOTES +To describe a trim curve that closely follows the contours of a NURBS +surface, call _cmnd(NurbsCurve). +.SH SEE ALSO +_cmnd(BeginCurve), _cmnd(BeginTrim), _cmnd(NewNurbsRenderer), _cmnd(NurbsCurve) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadriccallback.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadriccallback.gl new file mode 100644 index 000000000..2bca1c052 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadriccallback.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(QuadricCallback, define a callback for a quadrics object) +_names(QuadricCallback) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the quadrics object (created with _cmnd(NewQuadric)). +_phead(_param2) +Specifies the callback being defined. +The only valid value is _gluconst(ERROR). +_phead(_param3) +Specifies the function to be called. +.SH DESCRIPTION +_cmnd is used to define a new callback to be used by a quadrics object. +If the specified callback is already defined, then it is replaced. If +_param3 is NULL, then any existing callback is erased. +.P +The one legal callback is _gluconst(ERROR): +.TP 15 +_gluconst(ERROR) +The function is called when an error is encountered. Its single argument +is of type GLenum, and it indicates the specific error that occurred. +Character strings describing these errors can be retrieved with the +_cmnd(ErrorString) call. +.SH SEE ALSO +_cmnd(ErrorString), _cmnd(NewQuadric) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadricdrawstyle.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadricdrawstyle.gl new file mode 100644 index 000000000..2c3c3497c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadricdrawstyle.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(QuadricDrawStyle, specify the draw style desired for quadrics) +_names(QuadricDrawStyle) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the quadrics object (created with _cmnd(NewQuadric)). +_phead(_param2) +Specifies the desired draw style. Valid values are +_gluconst(FILL), +_gluconst(LINE), +_gluconst(SILHOUETTE), and +_gluconst(POINT). +.SH DESCRIPTION +_cmnd specifies the draw style for quadrics rendered with +_param1. The legal values are as follows: +.TP 15 +_gluconst(FILL) +Quadrics are rendered with polygon primitives. The polygons +are drawn in a counterclockwise fashion with respect to their +normals (as defined with _cmnd(QuadricOrientation)). +.TP +_gluconst(LINE) +Quadrics are rendered as a set of lines. +.TP +_gluconst(SILHOUETTE) +Quadrics are rendered as a set of lines, except that edges separating +coplanar faces will not be drawn. +.TP +_gluconst(POINT) +Quadrics are rendered as a set of points. +.SH SEE ALSO +_cmnd(NewQuadric), _cmnd(QuadricNormals), _cmnd(QuadricOrientation), +_cmnd(QuadricTexture) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadricnormals.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadricnormals.gl new file mode 100644 index 000000000..5cdc7de54 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadricnormals.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(QuadricNormals, specify what kind of normals are desired for quadrics) +_names(QuadricNormals) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifes the quadrics object (created with _cmnd(NewQuadric)). +_phead(_param2) +Specifies the desired type of normals. Valid values are +_gluconst(NONE), +_gluconst(FLAT), and +_gluconst(SMOOTH). +.SH DESCRIPTION +_cmnd specifies what kind of normals are desired for quadrics rendered with +_param1. The legal values are as follows: +.TP 15 +_gluconst(NONE) +No normals are generated. +.TP +_gluconst(FLAT) +One normal is generated for every facet of a quadric. +.TP +_gluconst(SMOOTH) +One normal is generated for every vertex of a quadric. This is the +initial value. +.SH SEE ALSO +_cmnd(NewQuadric), _cmnd(QuadricDrawStyle), _cmnd(QuadricOrientation), +_cmnd(QuadricTexture) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadricorientation.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadricorientation.gl new file mode 100644 index 000000000..ff48fc326 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadricorientation.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(QuadricOrientation, specify inside/outside orientation for quadrics) +_names(QuadricOrientation) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the quadrics object (created with _cmnd(NewQuadric)). +_phead(_param2) +Specifies the desired orientation. Valid values are +_gluconst(OUTSIDE) and +_gluconst(INSIDE). +.SH DESCRIPTION +_cmnd specifies what kind of orientation is desired for quadrics rendered +with _param1. The _param2 values are as follows: +.TP 15 +_gluconst(OUTSIDE) +Quadrics are drawn with normals pointing outward (the initial value). +.TP +_gluconst(INSIDE) +Quadrics are drawn with normals pointing inward. +.P +Note that the interpretation of \f2outward\fP and \f2inward\fP depends on the +quadric being drawn. +.SH SEE ALSO +_cmnd(NewQuadric), _cmnd(QuadricDrawStyle), _cmnd(QuadricNormals), +_cmnd(QuadricTexture) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadrictexture.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadrictexture.gl new file mode 100644 index 000000000..a621e390f --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/quadrictexture.gl @@ -0,0 +1,60 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(QuadricTexture, specify if texturing is desired for quadrics) +_names(QuadricTexture) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the quadrics object (created with _cmnd(NewQuadric)). +_phead(_param2) +Specifies a flag indicating if texture coordinates should be generated. +.SH DESCRIPTION +_cmnd specifies if texture coordinates should be generated +for quadrics rendered with _param1. +If the value of _param2 is _const(TRUE), then texture coordinates +are generated, and if _param2 is _const(FALSE), they are not. The +initial value is _const(FALSE). +.P +The manner in which texture coordinates are generated depends +upon the specific quadric rendered. +.SH SEE ALSO +_cmnd(NewQuadric), _cmnd(QuadricDrawStyle), _cmnd(QuadricNormals), +_cmnd(QuadricOrientation) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/scaleimage.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/scaleimage.gl new file mode 100644 index 000000000..426ec9a5d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/scaleimage.gl @@ -0,0 +1,175 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(ScaleImage, scale an image to an arbitrary size) +_names(ScaleImage) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the format of the pixel data. +The following symbolic values are valid: +_const(COLOR_INDEX), +_const(STENCIL_INDEX), +_const(DEPTH_COMPONENT), +_const(RED), +_const(GREEN), +_const(BLUE), +_const(ALPHA), +_const(RGB), +_const(RGBA), +_const(BGR), +_const(BGRA), +_const(LUMINANCE), and +_const(LUMINANCE_ALPHA). +_phead(_param2 _param3) +Specify in pixels the width and height, respectively, of the source image. +_phead(_param4) +Specifies the data type for _param5. 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), and +_const(UNSIGNED_INT_2_10_10_10_REV). +_phead(_param5) +Specifies a pointer to the source image. +_phead(_param6 _param7) +Specify the width and height, respectively, in pixels of the destination image. +_phead(_param8) +Specifies the data type for _param9. 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(_param9) +Specifies a pointer to the destination image. +.SH DESCRIPTION +_cmnd scales a pixel image using the appropriate pixel store modes to +unpack data from the source image and pack data into the destination image. +.P +When shrinking an image, _cmnd uses a box filter to sample the source image +and create pixels for the destination image. When magnifying an image, +the pixels from the source image are linearly interpolated to create the +destination image. +.P +A return value of zero indicates success, otherwise a GLU error code is returned (see _cmnd(ErrorString)). +.P +See the _glcmnd(ReadPixels) reference page for a description of +the acceptable values for the _param1, _param4, and _param8 parameters. +.SH NOTES +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 only available if the GL version +is 1.2 or greater. +.SH ERRORS +_gluconst(INVALID_VALUE) is returned if _param2, _param3, _param6, or _param7 +is negative. +.P +_gluconst(INVALID_ENUM) is returned if _param1, _param4, or _param8 is not +legal. +.P +_gluconst(INVALID_OPERATION) is returned if _param4 or _param8 is +_const(UNSIGNED_BYTE_3_3_2) or _const(UNSIGNED_BYTE_2_3_3_REV) +and _param1 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param4 or _param8 is +_const(UNSIGNED_SHORT_5_6_5) or _const(UNSIGNED_SHORT_5_6_5_REV) +and _param1 is not _const(RGB). +.P +_gluconst(INVALID_OPERATION) is returned if _param4 or _param8 is +_const(UNSIGNED_SHORT_4_4_4_4) or _const(UNSIGNED_SHORT_4_4_4_4_REV) +and _param1 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param4 or _param8 is +_const(UNSIGNED_SHORT_5_5_5_1) or _const(UNSIGNED_SHORT_1_5_5_5_REV) +and _param1 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param4 or _param8 is +_const(UNSIGNED_INT_8_8_8_8) or _const(UNSIGNED_INT_8_8_8_8_REV) +and _param1 is neither _const(RGBA) nor _const(BGRA). +.P +_gluconst(INVALID_OPERATION) is returned if _param4 or _param8 is +_const(UNSIGNED_INT_10_10_10_2) or _const(UNSIGNED_INT_2_10_10_10_REV) +and _param1 is neither _const(RGBA) nor _const(BGRA). +.SH SEE ALSO +_glcmnd(DrawPixels), _glcmnd(ReadPixels), _cmnd(Build1DMipmaps), _cmnd(Build2DMipmaps), +_cmnd(Build3DMipmaps), +.BR +_cmnd(ErrorString) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/sphere.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/sphere.gl new file mode 100644 index 000000000..f124ea346 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/sphere.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(Sphere, draw a sphere) +_names(Sphere) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the quadrics object (created with _cmnd(NewQuadric)). +_phead(_param2) +Specifies the radius of the sphere. +_phead(_param3) +Specifies the number of subdivisions around the \f2z\fP axis +(similar to lines of longitude). +_phead(_param4) +Specifies the number of subdivisions along the \f2z\fP axis +(similar to lines of latitude). +.SH DESCRIPTION +_cmnd draws a sphere of the given radius centered around the origin. The +sphere is subdivided around the \f2z\fP axis into slices and along the +\f2z\fP axis +into stacks (similar to lines of longitude and latitude). +.P +If the orientation is set to _gluconst(OUTSIDE) +(with _cmnd(QuadricOrientation)), then any normals generated +point away from the center of the sphere. +Otherwise, they point toward the center of the sphere. +.P +If texturing is turned on (with _cmnd(QuadricTexture)), then texture +coordinates are +generated so that \f2t\fP ranges from 0.0 at $ z ~=~ -^_eqnparam2 $ to 1.0 at +$ z ~=~ _eqnparam2 $ (\f2t\fP increases linearly along longitudinal +lines), +and \f2s\fP ranges from 0.0 at the +\f2y\fP axis, to 0.25 at the ++\f2x\fP axis, +to 0.5 at the \-\f2y\fP axis, to 0.75 at the \-\f2x\fP axis, and back to 1.0 +at the +\f2y\fP axis. +.SH SEE ALSO +_cmnd(Cylinder), _cmnd(Disk), _cmnd(NewQuadric), +_cmnd(PartialDisk), _cmnd(QuadricOrientation), +_cmnd(QuadricTexture) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessbegincontour.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessbegincontour.gl new file mode 100644 index 000000000..d3cc68626 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessbegincontour.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(TessBeginContour, delimit a contour description) +_names(TessBeginContour) +_names(TessEndContour,,noheader) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +.SH DESCRIPTION +_cmnd(TessBeginContour) and _cmnd(TessEndContour) delimit the definition of a +polygon contour. Within each _cmnd(TessBeginContour)/_cmnd(TessEndContour) +pair, there can be zero or more calls to _cmnd(TessVertex). The vertices +specify a closed contour (the last vertex of each contour is automatically linked +to the first). See the _cmnd(TessVertex) reference page for more details. +_cmnd can only be called between _cmnd(TessBeginPolygon) and _cmnd(TessEndPolygon). +.SH SEE ALSO +_cmnd(NewTess), _cmnd(TessBeginPolygon), _cmnd(TessVertex), +_cmnd(TessCallback), +_cmnd(TessProperty), _cmnd(TessNormal), +_cmnd(TessEndPolygon) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessbeginpolygon.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessbeginpolygon.gl new file mode 100644 index 000000000..4252b3c25 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessbeginpolygon.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(TessBeginPolygon, delimit a polygon description) +_names(TessBeginPolygon) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +_phead(_param2) +Specifies a pointer to user polygon data. +.SH DESCRIPTION +_cmnd(TessBeginPolygon) and _cmnd(TessEndPolygon) delimit the definition of a +convex, concave or self-intersecting polygon. Within each _cmnd(TessBeginPolygon)/_cmnd(TessEndPolygon) +pair, there must be one or more calls to _cmnd(TessBeginContour)/_cmnd(TessEndContour). +Within each contour, there are zero or more calls to _cmnd(TessVertex). The vertices +specify a closed contour (the last vertex of each contour is automatically linked +to the first). See the _cmnd(TessVertex), _cmnd(TessBeginContour), and +_cmnd(TessEndContour) reference pages for more details. +.P +_param2 is a pointer to a user-defined data structure. If the appropriate callback(s) +are specified (see _cmnd(TessCallback)), then this pointer is returned to the +callback function(s). Thus, it is a convenient way to store per-polygon information. +.P +Once _cmnd(TessEndPolygon) is called, the polygon is tessellated, and the +resulting triangles are described through callbacks. +See _cmnd(TessCallback) for descriptions of the callback functions. +.SH EXAMPLE +A quadrilateral with a triangular hole in it can be described as follows: +.sp +.Ex +gluTessBeginPolygon(tobj, NULL); + gluTessBeginContour(tobj); + gluTessVertex(tobj, v1, v1); + gluTessVertex(tobj, v2, v2); + gluTessVertex(tobj, v3, v3); + gluTessVertex(tobj, v4, v4); + gluTessEndContour(tobj); +.bp + gluTessBeginContour(tobj); + gluTessVertex(tobj, v5, v5); + gluTessVertex(tobj, v6, v6); + gluTessVertex(tobj, v7, v7); + gluTessEndContour(tobj); +gluTessEndPolygon(tobj); +.Ee +.sp +.SH SEE ALSO +_cmnd(NewTess), _cmnd(TessBeginContour), _cmnd(TessVertex), +_cmnd(TessCallback), +_cmnd(TessProperty), _cmnd(TessNormal), +_cmnd(TessEndPolygon) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tesscallback.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tesscallback.gl new file mode 100644 index 000000000..efaf5160a --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tesscallback.gl @@ -0,0 +1,307 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(TessCallback, define a callback for a tessellation object) +_names(TessCallback) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +_phead(_param2) +Specifies the callback being defined. The following values are valid: +_gluconst(TESS_BEGIN), +_gluconst(TESS_BEGIN_DATA), +_gluconst(TESS_EDGE_FLAG), +_gluconst(TESS_EDGE_FLAG_DATA), +_gluconst(TESS_VERTEX), +_gluconst(TESS_VERTEX_DATA), +_gluconst(TESS_END), +_gluconst(TESS_END_DATA), +_gluconst(TESS_COMBINE), +_gluconst(TESS_COMBINE_DATA), +_gluconst(TESS_ERROR), and +_gluconst(TESS_ERROR_DATA). +_phead(_param3) +Specifies the function to be called. +.SH DESCRIPTION +_cmnd is used to indicate a callback to be used by a tessellation object. +If the specified callback is already defined, then it is replaced. If +_param3 is NULL, then the existing callback becomes undefined. +.P +These callbacks are used by the tessellation object to describe how a +polygon specified by the user is broken into triangles. Note that there +are two versions of each callback: one with user-specified polygon data +and one without. If both versions of a particular callback are specified, +then the callback with user-specified polygon data will be used. Note +that the \f2polygon_data\fP parameter used by some of the functions is +a copy of the pointer that was specified when +_cmnd(TessBeginPolygon) was called. The legal callbacks are as follows: +.TP 10 +_gluconst(TESS_BEGIN) +The begin callback is invoked like _glcmnd(Begin) to indicate the start of +a (triangle) primitive. The function takes a single argument of type +GLenum. If the _gluconst(TESS_BOUNDARY_ONLY) property is set to +_const(FALSE), then the argument is set to either +_const(TRIANGLE_FAN), _const(TRIANGLE_STRIP), or _const(TRIANGLES). If +the _gluconst(TESS_BOUNDARY_ONLY) property is set to _const(TRUE), +then the argument will be set to _const(LINE_LOOP). The function +prototype for this callback is: +.RS +.Ex +void begin ( GLenum type ); +.Ee +.RE +.TP +_gluconst(TESS_BEGIN_DATA) +The same as the _gluconst(TESS_BEGIN) callback except that it +takes an additional pointer argument. This pointer is identical to the +opaque pointer provided when +_cmnd(TessBeginPolygon) was called. The function prototype for this callback +is: +.RS +.Ex +void beginData ( GLenum type, void *polygon_data ); +.Ee +.RE +.TP +_gluconst(TESS_EDGE_FLAG) +The edge flag callback is similar to _glcmnd(EdgeFlag). The function +takes a single boolean flag that indicates which edges lie on the +polygon boundary. If the flag is _const(TRUE), then each vertex +that follows begins an edge that lies on the polygon boundary, that is, +an edge that separates an interior region from an exterior one. +If the flag is _const(FALSE), then each vertex that follows begins an edge +that lies in the polygon interior. The edge flag callback (if defined) is +invoked before the first vertex callback. +.IP +Since triangle fans and triangle strips do not support edge flags, the begin +callback is not called with _const(TRIANGLE_FAN) or _const(TRIANGLE_STRIP) +if a non-NULL edge flag callback is provided. (If the callback is +initialized to NULL, there is no impact on performance). Instead, the fans and +strips are converted to independent triangles. The function prototype +for this callback is: +.RS +.Ex +void edgeFlag ( GLboolean flag ); +.Ee +.RE +.TP +_gluconst(TESS_EDGE_FLAG_DATA) +The same as the _gluconst(TESS_EDGE_FLAG) callback except that it takes an additional pointer +argument. This pointer is identical to the opaque pointer provided when +_cmnd(TessBeginPolygon) was called. The function prototype for this callback +is: +.RS +.Ex +void edgeFlagData ( GLboolean flag, void *polygon_data ); +.Ee +.RE +.TP +_gluconst(TESS_VERTEX) +The vertex callback is invoked between the begin and end callbacks. +It is similar to _glcmnd(Vertex), and it defines the vertices of the triangles +created by the tessellation process. The function +takes a pointer as its only argument. This pointer is identical to +the opaque pointer provided by the user when the vertex was described +(see _cmnd(TessVertex)). The function prototype for this callback is: +.RS +.Ex +void vertex ( void *vertex_data ); +.Ee +.RE +.TP +_gluconst(TESS_VERTEX_DATA) +The same as the _gluconst(TESS_VERTEX) callback except that it takes an additional pointer +argument. This pointer is identical to the opaque pointer provided when +_cmnd(TessBeginPolygon) was called. The function prototype for this callback +is: +.RS +.Ex +void vertexData ( void *vertex_data, void *polygon_data ); +.Ee +.RE +.TP +_gluconst(TESS_END) +The end callback serves the same purpose as _glcmnd(End). It indicates the +end of a primitive and it takes no arguments. The function prototype for this +callback is: +.RS +.Ex +void end ( void ); +.Ee +.RE +.TP +_gluconst(TESS_END_DATA) +The same as the _gluconst(TESS_END) callback except that it takes an additional pointer +argument. This pointer is identical to the opaque pointer provided when +_cmnd(TessBeginPolygon) was called. The function prototype for this callback +is: +.RS +.Ex +void endData ( void *polygon_data); +.Ee +.RE +.TP 10 +_gluconst(TESS_COMBINE) +The combine callback is called to create a new vertex when the tessellation +detects an intersection, or wishes to merge features. The function takes +four arguments: an array of three elements each of type GLdouble, an array +of four pointers, an array of four elements each of type GLfloat, and a +pointer to a pointer. The prototype is: +.RS +.Ex +void combine( GLdouble coords[3], void *vertex_data[4], + GLfloat weight[4], void **outData ); +.Ee +.RE +.IP +The vertex is defined as a linear combination of up to four existing vertices, +stored in \f2vertex_data\fP. The coefficients of the linear +combination are given by \f2weight\fP; these weights always add up to 1. +All vertex pointers are valid even when some of the weights are 0. +\f2coords\fP gives the location of the new vertex. +.IP +The user must allocate another vertex, interpolate parameters using +\f2vertex_data\fP and \f2weight\fP, and return the new vertex pointer in +\f2outData\fP. This handle is supplied during rendering callbacks. +The user is responsible for freeing the memory some time after +_cmnd(TessEndPolygon) is called. +.IP +For example, if the polygon lies in an arbitrary plane in 3-space, +and a color is associated with each vertex, the +_gluconst(TESS_COMBINE) callback might look like this: +.RS +.Ex +void myCombine( GLdouble coords[3], VERTEX *d[4], + GLfloat w[4], VERTEX **dataOut ) +{ + VERTEX *new = new_vertex(); + + new->x = coords[0]; + new->y = coords[1]; + new->z = coords[2]; + new->r = w[0]*d[0]->r + w[1]*d[1]->r + w[2]*d[2]->r + w[3]*d[3]->r; + new->g = w[0]*d[0]->g + w[1]*d[1]->g + w[2]*d[2]->g + w[3]*d[3]->g; + new->b = w[0]*d[0]->b + w[1]*d[1]->b + w[2]*d[2]->b + w[3]*d[3]->b; + new->a = w[0]*d[0]->a + w[1]*d[1]->a + w[2]*d[2]->a + w[3]*d[3]->a; + *dataOut = new; +} +.Ee +.RE +.IP +If the tessellation detects an intersection, then the _gluconst(TESS_COMBINE) or +_gluconst(TESS_COMBINE_DATA) callback (see below) must be defined, and it must +write a non-NULL pointer into \f2dataOut\fP. Otherwise the +_gluconst(TESS_NEED_COMBINE_CALLBACK) error occurs, and no +output is generated. +.TP +_gluconst(TESS_COMBINE_DATA) +The same as the _gluconst(TESS_COMBINE) callback except that it takes an additional pointer +argument. This pointer is identical to the opaque pointer provided when +_cmnd(TessBeginPolygon) was called. The function prototype for this callback +is: +.RS +.Ex +void combineData ( GLdouble coords[3], void *vertex_data[4], + GLfloat weight[4], void **outData, + void *polygon_data ); +.Ee +.RE +.TP 10 +_gluconst(TESS_ERROR) +The error callback is called when an error is encountered. The one argument +is of type GLenum; it indicates the specific error that occurred and will be +set to one of _gluconst(TESS_MISSING_BEGIN_POLYGON), _gluconst(TESS_MISSING_END_POLYGON), +_gluconst(TESS_MISSING_BEGIN_CONTOUR), _gluconst(TESS_MISSING_END_CONTOUR), +_gluconst(TESS_COORD_TOO_LARGE), _gluconst(TESS_NEED_COMBINE_CALLBACK) or +_gluconst(OUT_OF_MEMORY). Character +strings describing these errors can be retrieved with the +_cmnd(ErrorString) call. The function prototype for this callback is: +.RS +.Ex +void error ( GLenum errno ); +.Ee +.RE +.IP +The GLU library will recover from the first four +errors by inserting the missing call(s). +_gluconst(TESS_COORD_TOO_LARGE) indicates that some vertex coordinate exceeded +the predefined constant _gluconst(TESS_MAX_COORD) in absolute value, and +that the value has been clamped. (Coordinate values must be small +enough so that two can be multiplied together without overflow.) +_gluconst(TESS_NEED_COMBINE_CALLBACK) indicates that the tessellation +detected an intersection between two edges in the input data, and the +_gluconst(TESS_COMBINE) or _gluconst(TESS_COMBINE_DATA) callback was +not provided. No output is generated. _gluconst(OUT_OF_MEMORY) indicates +that there is not enough memory so no output is generated. +.TP +_gluconst(TESS_ERROR_DATA) +The same as the _gluconst(TESS_ERROR) callback except that it takes an additional pointer +argument. This pointer is identical to the opaque pointer provided when +_cmnd(TessBeginPolygon) was called. The function prototype for this callback +is: +.RS +.Ex +void errorData ( GLenum errno, void *polygon_data ); +.Ee +.RE +.SH EXAMPLE +Polygons tessellated can be rendered directly like this: +.sp +.Ex +gluTessCallback(tobj, GLU_TESS_BEGIN, glBegin); +gluTessCallback(tobj, GLU_TESS_VERTEX, glVertex3dv); +gluTessCallback(tobj, GLU_TESS_END, glEnd); +gluTessCallback(tobj, GLU_TESS_COMBINE, myCombine); +gluTessBeginPolygon(tobj, NULL); + gluTessBeginContour(tobj); + gluTessVertex(tobj, v, v); + ... + gluTessEndContour(tobj); +gluTessEndPolygon(tobj); +.Ee +.sp +Typically, the tessellated polygon should be stored in a display list so that +it does not need to be retessellated every time it is rendered. +.SH SEE ALSO +_glcmnd(Begin), _glcmnd(EdgeFlag), _glcmnd(Vertex), _cmnd(NewTess), +_cmnd(ErrorString), _cmnd(TessVertex), +_cmnd(TessBeginPolygon), +_cmnd(TessBeginContour), _cmnd(TessProperty), _cmnd(TessNormal) + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessendpolygon.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessendpolygon.gl new file mode 100644 index 000000000..f9b3608ec --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessendpolygon.gl @@ -0,0 +1,86 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(TessEndPolygon, delimit a polygon description) +_names(TessEndPolygon) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +.SH DESCRIPTION +_cmnd(TessBeginPolygon) and _cmnd(TessEndPolygon) delimit the definition of a +convex, concave or self-intersecting polygon. Within each _cmnd(TessBeginPolygon)/_cmnd(TessEndPolygon) +pair, there must be one or more calls to _cmnd(TessBeginContour)/_cmnd(TessEndContour). +Within each contour, there are zero or more calls to _cmnd(TessVertex). The vertices +specify a closed contour (the last vertex of each contour is automatically linked +to the first). See the _cmnd(TessVertex), _cmnd(TessBeginContour) and +_cmnd(TessEndContour) reference pages for more details. +.P +Once _cmnd(TessEndPolygon) is called, the polygon is tessellated, and the +resulting triangles are described through callbacks. +See _cmnd(TessCallback) for descriptions of the callback functions. +.SH EXAMPLE +A quadrilateral with a triangular hole in it can be described like this: +.sp +.Ex +gluTessBeginPolygon(tobj, NULL); + gluTessBeginContour(tobj); + gluTessVertex(tobj, v1, v1); + gluTessVertex(tobj, v2, v2); + gluTessVertex(tobj, v3, v3); + gluTessVertex(tobj, v4, v4); + gluTessEndContour(tobj); + gluTessBeginContour(tobj); + gluTessVertex(tobj, v5, v5); + gluTessVertex(tobj, v6, v6); + gluTessVertex(tobj, v7, v7); + gluTessEndContour(tobj); +gluTessEndPolygon(tobj); +.Ee +.bp +In the above example the pointers, $v1$ through $v7$, +should point to different +addresses, +since the values stored at these addresses will not be read by +the tesselator until _cmnd(TessEndPolygon) is called. +.SH SEE ALSO +_cmnd(NewTess), _cmnd(TessBeginContour), _cmnd(TessVertex), +_cmnd(TessCallback), +_cmnd(TessProperty), _cmnd(TessNormal), +_cmnd(TessBeginPolygon) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessnormal.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessnormal.gl new file mode 100644 index 000000000..aae2c9a76 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessnormal.gl @@ -0,0 +1,78 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(TessNormal, specify a normal for a polygon) +_names(TessNormal) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +_phead(_param2) +Specifies the first component of the normal. +_phead(_param3) +Specifies the second component of the normal. +_phead(_param4) +Specifies the third component of the normal. +.SH DESCRIPTION +_cmnd describes a normal for a polygon that the program is defining. +All input data will be projected onto a plane perpendicular to one of +the three coordinate axes before tessellation and all output triangles +will be oriented CCW with +respect to the normal (CW orientation can be obtained by reversing the +sign of the supplied normal). For example, if you know that all polygons +lie in the x-y plane, call _cmnd(TessNormal)(tess, 0.0, 0.0, 1.0) +before rendering any polygons. +.P +If the supplied normal is (0.0, 0.0, 0.0) (the initial value), the normal is +determined as follows. The direction of the normal, up to its sign, is +found by fitting a plane to the vertices, without regard to how the +vertices are connected. It is expected that the input data lies approximately +in the plane; otherwise, projection perpendicular to one of the three +coordinate axes may substantially change the geometry. The sign of the +normal is chosen so that the sum of the signed areas of all input +contours is nonnegative (where a CCW contour has positive area). +.P +The supplied normal persists until it is changed by another call to +_cmnd(TessNormal). +.SH SEE ALSO +_cmnd(TessBeginPolygon), +_cmnd(TessEndPolygon) + + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessproperty.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessproperty.gl new file mode 100644 index 000000000..e3363069b --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessproperty.gl @@ -0,0 +1,112 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(TessProperty, set a tessellation object property) +_names(TessProperty) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +_phead(_param2) +Specifies the property to be set. Valid values are +_gluconst(TESS_WINDING_RULE), +_gluconst(TESS_BOUNDARY_ONLY), +_gluconst(TESS_TOLERANCE). +_phead(_param3) +Specifies the value of the indicated property. +.SH DESCRIPTION +_cmnd is used to control properties stored in a tessellation object. These +properties affect the way that the polygons are interpreted and rendered. +The legal values for _param2 are as follows: +.TP 15 +_gluconst(TESS_WINDING_RULE) +Determines which parts of the polygon are on the "interior". +_param3 may be set to one of _gluconst(TESS_WINDING_ODD), +_gluconst(TESS_WINDING_NONZERO), _gluconst(TESS_WINDING_POSITIVE), or +_gluconst(TESS_WINDING_NEGATIVE), or _gluconst(TESS_WINDING_ABS_GEQ_TWO). +.IP +To understand how the winding rule works, consider that the input +contours partition the plane into regions. The winding rule determines which +of these regions are inside the polygon. +.IP +For a single contour C, the winding number of a point x is simply the signed +number of revolutions we make around x as we travel once around C +(where CCW is positive). When there are several contours, the individual +winding numbers are summed. This procedure associates a signed integer +value with each point x in the plane. Note that the winding number is the +same for all points in a single region. +.bp +.IP +The winding rule classifies a region as "inside" if its winding number +belongs to the chosen category (odd, nonzero, positive, negative, or +absolute value of at least two). The previous GLU tessellator (prior to +GLU 1.2) used the "odd" rule. The "nonzero" rule is another common way to +define the interior. The other three rules are useful for polygon CSG +operations. +.TP +_gluconst(TESS_BOUNDARY_ONLY) +Is a boolean value ("value" should be set +to GL_TRUE or GL_FALSE). When set to GL_TRUE, a set of closed contours +separating the polygon interior and exterior are returned instead of a +tessellation. Exterior contours are oriented CCW with respect to the +normal; interior contours are oriented CW. The _gluconst(TESS_BEGIN) +and _gluconst(TESS_BEGIN_DATA) callbacks use the type GL_LINE_LOOP for +each contour. +.TP +_gluconst(TESS_TOLERANCE) +Specifies a tolerance for merging features to reduce the size of the output. +For example, two vertices that are very close to each other might be +replaced by a single vertex. The tolerance is multiplied by the largest +coordinate magnitude of any input vertex; this specifies the maximum +distance that any feature can move as the result of a single merge +operation. If a single feature takes part in several merge operations, the +total distance moved could be larger. +.IP +Feature merging is completely optional; the tolerance is only a hint. +The implementation is free to merge in some cases and not in others, or to +never merge features at all. The initial tolerance is 0. +.IP +The current implementation merges vertices only if they are exactly +coincident, regardless of the current tolerance. A vertex is spliced into +an edge only if the implementation is unable to distinguish which side of +the edge the vertex lies on. Two edges are merged only when both endpoints +are identical. +.SH SEE ALSO +_cmnd(GetTessProperty), +_cmnd(NewTess) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessvertex.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessvertex.gl new file mode 100644 index 000000000..10beb5cbb --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/tessvertex.gl @@ -0,0 +1,112 @@ +_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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(TessVertex, specify a vertex on a polygon) +_names(TessVertex) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1) +Specifies the tessellation object (created with _cmnd(NewTess)). +_phead(_param2) +Specifies the location of the vertex. +_phead(_param3) +Specifies an opaque pointer passed back to the program with the vertex callback +(as specified by _cmnd(TessCallback)). +.SH DESCRIPTION +_cmnd describes a vertex on a polygon that the program defines. Successive +_cmnd calls describe a closed contour. For example, +to describe a quadrilateral _cmnd should be called four times. +_cmnd can only be called between _cmnd(TessBeginContour) and +_cmnd(TessEndContour). +.P +_param3 normally points to a structure containing the vertex +location, as well as other per-vertex attributes such as color and normal. +This pointer is passed back to the user through the _gluconst(TESS_VERTEX) +or _gluconst(TESS_VERTEX_DATA) callback after tessellation +(see the _cmnd(TessCallback) reference page). +.SH EXAMPLE +A quadrilateral with a triangular hole in it can be described as follows: +.sp +.Ex +gluTessBeginPolygon(tobj, NULL); + gluTessBeginContour(tobj); + gluTessVertex(tobj, v1, v1); + gluTessVertex(tobj, v2, v2); + gluTessVertex(tobj, v3, v3); + gluTessVertex(tobj, v4, v4); + gluTessEndContour(tobj); + gluTessBeginContour(tobj); + gluTessVertex(tobj, v5, v5); + gluTessVertex(tobj, v6, v6); + gluTessVertex(tobj, v7, v7); + gluTessEndContour(tobj); +gluTessEndPolygon(tobj); +.Ee +.sp +.SH NOTES +It is a common error to use a local variable for _param2 or _param3 and store +values into it as part of a loop. +For example: +.Ex +for (i = 0; i < NVERTICES; ++i) { + GLdouble data[3]; + data[0] = vertex[i][0]; + data[1] = vertex[i][1]; + data[2] = vertex[i][2]; + gluTessVertex(tobj, data, data); + } +.Ee +.P +This doesn't work. +Because the pointers specified by _param2 and _param3 might not be +dereferenced until _cmnd(TessEndPolygon) is executed, +all the vertex coordinates but the very last set could be overwritten +before tessellation begins. +.P +Two common symptoms of this problem are consists of a single point +(when a local variable is used for _param3) and a +_gluconst(TESS_NEED_COMBINE_CALLBACK) error (when a local variable is +used for _param2). +.SH SEE ALSO +_cmnd(TessBeginPolygon), _cmnd(NewTess), _cmnd(TessBeginContour), +_cmnd(TessCallback), +_cmnd(TessProperty), _cmnd(TessNormal), +_cmnd(TessEndPolygon) + + diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/unproject.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/unproject.gl new file mode 100644 index 000000000..513fd70f1 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/unproject.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(UnProject, map window coordinates to object coordinates) +_names(UnProject) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2 _param3) +Specify the window coordinates to be mapped. +_phead(_param4) +Specifies the modelview matrix (as from a _glcmnd(GetDoublev) call). +_phead(_param5) +Specifies the projection matrix (as from a _glcmnd(GetDoublev) call). +_phead(_param6) +Specifies the viewport (as from a _glcmnd(GetIntegerv) call). +_phead(_param7 _param8 _param9) +Returns the computed object coordinates. +.SH DESCRIPTION +_cmnd maps the specified window coordinates into object +coordinates using _param4, _param5, and _param6. +The result is stored in _param7, _param8, and _param9. A return value of +_const(TRUE) indicates success; a return value of _const(FALSE) +indicates failure. +.P +To compute the coordinates (_param7, _param8, and _param9), +_cmnd multiplies the normalized device coordinates by the inverse of +_param4*_param5 as follows: + +.P +.ce +.EQ +left ( down 70 {cpile { ~_eqnparam7 above ~_eqnparam8 above ~_eqnparam9 +above ~W}} ~~ right ) ~=~ INV(P M) +left ( down 140 {cpile { +{ {2(_eqnparam1 ~-~ _eqnparam6[0])} over {_eqnparam6 [2]} ~-~ 1 } +above +{ {2(_eqnparam2 ~-~ _eqnparam6[1])} over {_eqnparam6[3]} ~-~ 1 } +above +{ 2(_eqnparam3) ~-~ 1 } +above +1}} ~~ right ) +.EN +.bp +$INV()$ denotes matrix inversion. +W is an unused variable, included for consistent matrix notation. +.SH SEE ALSO +_glcmnd(Get), _cmnd(Project) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/unproject4.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/unproject4.gl new file mode 100644 index 000000000..37faf217d --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglu/standard/unproject4.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_ $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +_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(UnProject4, map window and clip coordinates to object coordinates) +_names(UnProject4) +.EQ +delim $$ +.EN +.SH PARAMETERS +_phead(_param1 _param2 _param3) +Specify the window coordinates to be mapped. +_phead(_param4) +Specify the clip w coordinate to be mapped. +_phead(_param5) +Specifies the modelview matrix (as from a _glcmnd(GetDoublev) call). +_phead(_param6) +Specifies the projection matrix (as from a _glcmnd(GetDoublev) call). +_phead(_param7) +Specifies the viewport (as from a _glcmnd(GetIntegerv) call). +_phead(_param8 _param9) +Specifies the near and far planes (as from a _glcmnd(GetDoublev) call). +_phead(_param10 _param11 _param12 _param13) +Returns the computed object coordinates. +.SH DESCRIPTION +_cmnd maps the specified window coordinates _param1, _param2 and _param3 +and its clip w coordinate _param4 +into object +coordinates (_param10, _param11, _param12, _param13) +using _param5, _param6 and _param7. _param4 can be other than +1 as for vertices in _glcmnd(FeedbackBuffer) when data type +_const(4D_COLOR_TEXTURE) is returned. +This also handles the case +where the _param8 and _param9 planes are different from the default, +0 and 1, respectively. +A return +value of _const(TRUE) indicates success; a return value of _const(FALSE) +indicates failure. +.P +To compute the coordinates (_param10, _param11, _param12 and _param13), +_cmnd multiplies the normalized device coordinates by the inverse of +_param5*_param6 as follows: + +.P +.ce +.EQ +left ( down 70 {cpile { ~_eqnparam10 above ~_eqnparam11 above ~_eqnparam12 +above ~_eqnparam13}} ~~ right ) ~=~ INV(P M) +left ( down 140 {cpile { +{ {2(_eqnparam1 ~-~ _eqnparam7[0])} over {_eqnparam7[2]} ~-~ 1 } +above +{ {2(_eqnparam2 ~-~ _eqnparam7[1])} over {_eqnparam7[3]} ~-~ 1 } +above +{ {2(_eqnparam3 ~-~ _eqnparam8)} over {(_eqnparam9 ~-~ _eqnparam8)} ~-~ 1 } +above +_eqnparam4}} ~~ right ) +.EN +.sp +$INV()$ denotes matrix inversion. +.P +_cmnd is equivalent to _cmnd(UnProject) when _param4 is 1, _param8 is 0 and +_param9 is 1. +.SH NOTES +_cmnd is available only if the GLU version is 1.3 or greater. +.SH SEE ALSO +_glcmnd(Get), +_glcmnd(FeedbackBuffer), +_cmnd(Project), +_cmnd(UnProject) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglw/Distfile b/nx-X11/extras/ogl-sample/main/doc/man/manglw/Distfile new file mode 100644 index 000000000..6bf42c0e1 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglw/Distfile @@ -0,0 +1,11 @@ +# +# + +DISTDIR_SI = /xc/doc/man/GL/glw + +DISTFILES_SI = \ + glwcreatemdrawingarea.3gl \ + glwdrawingarea.3gl \ + glwdrawingareamakecurrent.3gl \ + glwdrawingareaswapbuffers.3gl \ + $(NULL) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglw/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/manglw/GNUmakefile new file mode 100644 index 000000000..d87aa5187 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglw/GNUmakefile @@ -0,0 +1,83 @@ +#!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. +# + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +DEPTH = .. +LANGOPT = c +PREFIX = GLw +IDB_PATH = /usr/share/catman/g_man/cat3/glw + +MANPREF = man +include $(DEPTH)/mandefs + +APIFILE = $(ROOT)/usr/include/GL/gl.h + +VERSION = Version 1.0 +DATE = Aug 1998 +MMFLAGS = -rs2 + +LEGALSUF1 = gl# +LEGALSUF2 = gl# +LEGALSUF3 = gl# +LEGALSUF4 = gl# +LEGALSUF5 = gl# + +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/`basename $$file .3gl`.3gl ; \ + done + +clobber: + rm -f *.3gl + +include $(DEPTH)/manrules +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwcreatemdrawingarea.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwcreatemdrawingarea.gl new file mode 100644 index 000000000..ab839f737 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwcreatemdrawingarea.gl @@ -0,0 +1,50 @@ +.\" ** +.\" ** (c) Copyright 1993, 1994, 1995, 1996 Silicon Graphics, Inc. +.\" ** +.\" ** (c) Copyright 1989, 1990, 1991 Open Software Foundation, Inc. +.\" ** All Rights Reserved. +.\" ** +.\" ** (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company +.\" ** +.\" ** (c) Copyright 1987, 1988 by Digital Equipment Corporation, +.\" ** Maynard, MA. All Rights Reserved. +.\" ** +.\" ** +.TH GLwCreateMDrawingArea 3X "" "" "" "" +.SH NAME +\fBGLwCreateMDrawingArea \(em Create a Motif/OpenGL Drawing Widget.\fP +.iX "GLwCreateMDrawingArea" +.iX "creation functions" +.sp 1 +.SH SYNOPSIS +\fB#include <X11/GLw/GLwMDrawA.h>\fP +.br +Widget \fBGLwCreateMDrawingArea\fP( Widget \fIparent\fP, + String \fIname\fP, + ArgList \fIarglist\fP, + Cardinal \fIargcount\fP ) +.fi +\fP +.SH DESCRIPTION +\fBGLwCreateMDrawingArea\fP creates an instance of a GLwMDrawingArea +widget and returns the associated widget ID. +.sp 1 +.IP "\fIparent\fP" .95i +Specifies the parent widget ID +.IP "\fIname\fP" .95i +Specifies the name of the created widget +.IP "\fIarglist\fP" .95i +Specifies the argument list +.IP "\fIargcount\fP" .95i +Specifies the number of attribute/value pairs in the argument list +(\fIarglist\fP) +.sp 1 +.PP +For a complete definition of GLwMDrawingArea and its associated resources, see +\fBGLwDrawingArea(3X)\fP. +.sp 1 +.SH RETURN VALUE +Returns the GLwMDrawingArea widget ID. +.sp 1 +.SH SEE ALSO +\fBGLwDrawingArea(3X)\fP. diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwdrawingarea.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwdrawingarea.gl new file mode 100644 index 000000000..f25a4f5c6 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwdrawingarea.gl @@ -0,0 +1,485 @@ +.\" ** +.\" ** (c) Copyright 1993, 1994, 1995, 1996 Silicon Graphics, Inc. +.\" ** +.\" ** (c) Copyright 1989, 1990, 1991 Open Software Foundation, Inc. +.\" ** All Rights Reserved. +.\" ** +.\" ** (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company +.\" ** +.\" ** (c) Copyright 1987, 1988 by Digital Equipment Corporation, +.\" ** Maynard, MA. All Rights Reserved. +.\" ** +.\" ** +.TH GLwDrawingArea 3X "" "" "" "" +.SH NAME +\fBGLwDrawingArea, GLwMDrawingArea \(em OpenGL drawing widgets.\fP +.iX "GLwDrawingArea" "GLwMDrawingArea" +.iX "widget class" "OpenGL" "Draw" +.sp 1 +.SH SYNOPSIS +\fB#include <X11/GLw/GLwDrawA.h> +.br +\fBld ... -lGLw -lGL -l<anywidgetlibrary> -lXext -lXt -lX11 -lm +.sp +\fB#include <X11/GLw/GLwMDrawA.h> +.br +\fBld ... -lGLw -lGL -lXm -lXext -lXt -lX11 -lm +.sp 1 +.SH DESCRIPTION +\fBGLwDrawingArea\fP and \fBGLwMDrawingArea\fP are widgets suitable +for OpenGL drawing. They +provide a window with the appropriate visual and colormaps needed for +OpenGL, based on supplied parameters. GLwDrawingArea and +GLwMDrawingArea also provide +callbacks for redraw, resize, input, and initialization. +.PP +GLwDrawingArea is not a part of any widget set, but depends only on Xt. +GLwDrawingArea can be used with any widget set. GLwMDrawingArea +is identical to +GLwDrawingArea except that it is a subclass of the Motif\(Tm widget +class XmPrimitive and +has resources and defaults suitable for use with Motif. For example, +GLwMDrawingArea provides the default Motif background and foreground colors +for resources, and deals better with keyboard traversal. Although the +GLwDrawingArea widget can be used in a Motif program, it is recommended that +GLwMDrawingArea be used instead. +.PP +Since both GLwDrawingArea and GLwMDrawingArea +widgets behave almost identically, the +remainder of this manual page will refer only to GLwDrawingArea, except when +the behaviors differ. Unless explicitly stated, all statements +about GLwDrawingArea also apply to GLwMDrawingArea. +.PP +Among the information provided when creating a GLwDrawingArea is +information necessary to determine the visual. This may be provided +in three ways, all of them through resources. A specific visualInfo +structure may be passed in. (This visualInfo must have been obtained +elsewhere; it is the application designer's responsibility to make +sure that it is compatible with the OpenGL rendering done by the +application). Alternatively, an attribute list may be provided. This +attribute list is formatted identically to that used for direct open +GL programming. Finally, each attribute can be specified as an +individual resource. The latter method is the simplest, and is the +only method that works from resource files. +.PP +In addition to allocating the visual, the GLwDrawingArea will also +allocate the colormap unless one is provided by the application. (If +one is provided it is the application writer's responsibility to +guarantee compatibility between the colormap and the visual). If +an application creates multiple GLwDrawingAreas with the same visual, +the same colormap will be used. (However the colormap +will not be shared among separate applications). +.PP +Creating the widget does not actually create the window until it is +realized, and consequently, the application should not perform any +OpenGL operations +to the window immediately after creation. Instead the application +must wait until after it has realized the window. Alternatively, the +\fBginit\fP callback may be used to indicate when the window has been +created. Upon receiving this callback, the application can perform +all OpenGL initialization for the window, and can subsequently perform +other operations on it. The initialization is discussed in more +detail below. +.PP +Applications select which GLwDrawingArea they are accessing using either +\fBglXMakeCurrent\fP or the convenience function +\fBGLwDrawingAreaMakeCurrent\fP which uses a widget instead of a +display and window. If there is only one GLwDrawingArea this need +only be called once, however if there is more than one GLwDrawingArea +it should be called at the start of each callback. +Callbacks in this case include not only +callbacks provided by the widget itself, but any other callback that +leads to GL activity such as a timeout or a workproc. +.PP +If an application is using double buffering, it may call +\fBGLwDrawingAreaSwapBuffers\fP instead of \fBglXSwapBuffers\fP. This +allows the use of the widget instead of the display and window. +.ne 5 +.SS "GLwDrawingArea Classes" +GLwDrawingArea inherits behavior and resources from the \fBCore\fP class. +.br +The class pointer is \fBglwDrawingAreaWidgetClass\fP. +.br +The class name is \fBGLwDrawingArea\fP. +.PP +.ne 5 +.SS "GLwMDrawingArea Classes" +GLwMDrawingArea inherits behavior and resources from the +\fBXmPrimitive\fP and \fBCore\fP classes. +.br +The class pointer is \fBglwMDrawingAreaWidgetClass\fP. +.br +The class name is \fBGLwMDrawingArea\fP. +.sp 1 +.SS "New Resources" +The following tables define a set of widget resources used by the programmer +to specify data. The programmer can also set the resource values for the +inherited classes to set attributes for this widget. To reference a +resource by name or by class in a .Xdefaults file, remove the \fBGLwN\fP or +\fBGLwC\fP prefix and use the remaining letters. +There are two tables included. The first table includes resources +that correspond directly to the attributes used by \fBglXChooseVisual\fP. +As with \fBglXChooseVisual\fP, all Boolean resources default to FALSE +and all integer resources default to 0, except redSize, greenSize and +blueSize which default to 1. These resources can all be +set only at creation time, and are used to determine the visual. If +either the \fIGLwNattribList\fP or \fIGLwNvisualInfo\fP resource is +set, these resources are ignored. The specific meaning of these +resources is discussed in the \fBglXChooseVisual\fP manual page and +will not be discussed here. +.sp 1 +.ne 18 +.TS +center allbox; +lBp8 lBp8 lBp8 lBp8 +lp8 lp8 lp8 lp8. +Name Class Type OpenGL attribute +GLwNbufferSize GLwCBufferSize int GLX_BUFFER_SIZE +GLwNlevel GLwCLevel int GLX_LEVEL +GLwNrgba GLwCRgba Boolean GLX_RGBA +GLwNdoublebuffer GLwCDoublebuffer Boolean GLX_DOUBLEBUFFER +GLwNstereo GLwCStereo Boolean GLX_STEREO +GLwNauxBuffers GLwCAuxBuffers Boolean GLX_AUX_BUFFERS +GLwNredSize GLwCColorSize int GLX_RED_SIZE +GLwNgreenSize GLwCColorSize int GLX_GREEN_SIZE +GLwNblueSize GLwCColorSize int GLX_BLUE_SIZE +GLwNalphaSize GLwCAlphaSize int GLX_ALPHA_SIZE +GLwNdepthSize GLwCDepthSize int GLX_DEPTH_SIZE +GLwNstencilSize GLwCStencilSize int GLX_STENCIL_SIZE +GLwNaccumRedSize GLwCAccumColorSize int GLX_ACCUM_RED_SIZE +GLwNaccumGreenSize GLwCAccumColorSize int GLX_ACCUM_GREEN_SIZE +GLwNaccumBlueSize GLwCAccumColorSize int GLX_ACCUM_BLUE_SIZE +GLwNaccumAlphaSize GLwCAccumAlphaSize int GLX_ACCUM_ALPHA_SIZE +.TE +.sp 1 +.PP +The following table lists other resources of the GLwDrawingArea +widget. each of these will be described subsequently. +The codes in the access column indicate if the given resource can be +set at creation time (\fBC\fP), +set by using \fBXtSetValues\fP (\fBS\fP), +retrieved by using \fBXtGetValues\fP (\fBG\fP), or is not applicable +(\fBN/A\fP). +.sp 1 +.ne 12 +.TS +center; +lp8B lp8B lp8B lp8B lp8B +lp8 lp8 lp8 lp8 lp8. +Name Class Type Def Acc +_ +GLwNallocateBackground GLwCAllocateColors Boolean F CG +GLwNallocateOtherColors GLwCAllocateColors Boolean F CG +GLwNattribList GLwCAttribList int * NULL CG +GLwNexposeCallback GLwCCallback XtCallbackList NULL C +GLwNginitCallback GLwCCallback XtCallbackList NULL C +GLwNinputCallback GLwCCallback XtCallbackList NULL C +GLwNinstallBackground GLwCInstallBackground Boolean T CG +GLwNinstallColormap GLwCInstallColormap Boolean T CG +GLwNresizeCallback GLwCCallback XtCallbackList NULL C +GLwNvisualInfo GLwCVisualInfo XVisualInfo* NULL CG +.TE +.sp 1 +.IP "\fBGLwNallocateBackground\fP" +If TRUE, the background pixel and pixmap will be allocated if +appropriate using the newly calculated colormap and visual. If FALSE, +they will retain values calculated using the parent's colormap and +visual. Applications which wish to have X clear their background for +them will usually set this to TRUE. Applications clearing their own +background will often set this to FALSE, although they may set this to +TRUE if they query the background for their own use. One reason to +leave this resource FALSE is that if color index mode is in use this +avoid using up a pixel from the newly allocated colormap. Also, on +hardware that supports only one colormap, the application may need to +do more careful color allocation to avoid flashing between the OpenGL +colormap and the default X colormap. +(Note that because of the way Xt works, the background colors +are originally calculated using the default colormap; if this resource +is set they can be recalculated correctly. If a colormap was +explicitly supplied to the widget rather than being dynamically +calculated, these resources are always calculated using that colormap.) +.IP "\fBGLwNallocateOtherColors\fP" +This is similar to \fBGLwNallocateBackground\fP, but allocates other +colors normally allocated by widgets. Although the GLwDrawingArea +and GLwMDrawingArea widget do not make use of these colors the +application may choose to query them. For the non-Motif +GLwDrawingArea widget there are no other colors allocated, so this +resource is a no-op. For the Motif GLwMDrawingArea are widget, the +XmPrimitive resources \fBXmNforeground\fP, \fBXmNhighlightColor\fP, +and \fBXmNhighlightPixmap\fP are calculated. +.IP "\fBGLwNattribList\fP" +Contains the list of attributes suitable for a call to +\fBglXChooseVisual\fP. If this resource is NULL, it is calculated +based on the attribute resources. If it is not NULL, the attribute +resources are ignored. +.IP "\fBGLwNexposeCallback\fP" +Specifies the list of callbacks that is +called when the widget receives an exposure event. +The callback reason is \fBGLwCR_EXPOSE\fP. +The callback structure also includes the exposure event. The +application will generally want to redraw the scene. +.IP "\fBGLwNginitCallback\fP" +Specifies the list of callbacks that is +called when the widget is first realized. Since no OpenGL operations can +be done before the widget is realized, this callback can be used to +perform any appropriate OpenGL initialization such as creating a context. +The callback reason is \fBGLwCR_GINIT\fP. +.IP "\fBGLwNinputCallback\fP" +Specifies the list of callbacks that is +called when the widget receives a keyboard +or mouse event. By default, the input callback is called on each key +press and key release, on each mouse button press and release, and +whenever the mouse is moved while a button is pressed. However this +can be changed by providing a different translation table. +The callback structure also includes the input event. +The callback reason is \fBGLwCR_INPUT\fP. +.IP "" +The input callback is provided as a programming convenience, as it +provides a convenient way to catch all input events. However, a more +modular program can often be obtained by providing specific actions and +translations in the application rather than using a single catch all +callback. Use of explicit translations can also provide for more +customization. +.IP "\fBGLwNinstallBackground\fP" +If set to TRUE, the background is installed on the window. If set to +FALSE, the window has no background. This resource has no effect +unless \fBGLwNallocateBackground\fP is also TRUE. +.IP "\fBGLwNinstallColormap\fP" +If set to TRUE, the widget will call \fIXSetWMColormapWindows\fP to +tell the window manager to install the colormap when the window's +shell has focus. If set to FALSE, this will not be called. For +applications with multiple GLwDrawingAreas sharing a single colormap, +it is most efficient to set this resource to TRUE for exactly one +GLwDrawingArea with each colormap. If an application needs +additional control over the order of colormaps, this resource can be +set to FALSE, with the application calling \fIXSetWMColormapWindows\fP +explicitly. +.IP "\fBGLwNresizeCallback\fP" +Specifies the list of callbacks that is +called when the GLwDrawingArea is resized. +The callback reason is \fBGLwCR_RESIZE\fP. +.IP "\fBGLwNvisualInfo\fP" +Contains a pointer to the window's visual info structure. If NULL, +the visualInfo is calculated at widget creation time based on the +\fIGLwNattributeList\fP resource (which is itself calculated from the +various resources). If \fBGLwNvisualInfo\fP is not NULL the +\fIGLwNattributList\fP and the attribute resources are ignored. +.sp 1 +.SS "Inherited Resources" +Both GLwDrawingArea and GLwMDrawingArea inherit behavior and resources +from the core superclass. Other than the behavior of the colormap and +background resources described previously, all defaults are the same as +for core. +.PP +In addition, the Motif version GLwMDrawingArea also inherits from XmPrimitive. +The behavior of the color resources has been described previously. +The \fITraversalOn\fP resource is disabled for this widget, but if +keyboard input is required it should be enabled. (Also, the +application should call \fBXmProcessTraversal(widget, XmTRAVERSE_CURRENT)\fP +whenever mouse button 1 is clicked in the widget. This is similar to +the requirements of the Motif Drawing area.) Because Motif gets +confused by having multiple visuals in one top level shell, +\fBXmNhighlightOnEnter\fP has been disabled, and +\fBXmNhighlightThickness\fP has been set to 0. +.SS "Callback Information" +A pointer to the following structure is passed to each callback: +.sp 1 +.ne 6 +.nf +.ta .25i 1.3i +\fBtypedef struct\fP +{ + \fBint\fP \fIreason\fP; + \fBXEvent\fP \fI*event\fP; + \fBDimension\fP \fIwidth, height\fP; +} \fBGLwDrawingAreaCallbackStruct\fP; +.fi +.sp 1 +.IP "\fIreason\fP" .75i +Indicates why the callback was invoked. Appropriate values are +stated in the above resource descriptions. For Motif programmers, the +values \fBGLwCR_EXPOSE\fP, \fBGLwCR_RESIZE\fP, and \fBGLwCR_INPUT\fP +are equal to \fBXmCR_EXPOSE\fP, \fBXmCR_RESIZE\fP, and +\fBXmCR_INPUT\fP respectively. \fBGLwCR_GINIT\fP does not have a +Motif equivalent. +.IP "\fIevent\fP" .75i +Points to the \fBXEvent\fP that triggered the callback. +This is NULL for \fBGLwNginitCallback and \fBGLwNresizeCallback\fP. +.IP "\fIwidth\fP and \fIheight\fP" .75i +Are set to the width and height of the window. +.br +.ne 10 +.sp 1 \"Adds space before the SS +.SS "Translations" +GLwDrawingArea has the translations listed below. +\fB +.nf +.ta 1.5i +.ne 5 +<KeyDown>: glwInput() +<KeyUp>: glwInput() +<BtnDown>: glwInput() +<BtnUp>: glwInput() +<BtnMotion>: glwInput() +.fi +.PP +GLwMDrawingArea has the following additional translation: +\fB +.nf +.ta 1.5i +<Key>osfHelp: PrimitiveHelp() +.fi +.PP +An application wishing to catch other events than these defaults can +do so by installing a different translation table. +\fP +.sp 1 \"Adds space before the SS +.SS "Action Routines" +The GLwDrawingArea has the following action routine: +.IP "\fBglwInput()\fP:" +Called whenever one of the above translations specifies that input has +occurred. Its sole purpose is to call the input callback. +.sp 1 +.SH INITIALIZATION +.PP +When the widget is initially created (e.g. through +\fBXtCreateWidget(3X)\fP) the associated window is not actually +created. Instead, window creation is delayed until the widget is +realized. However, \fBglXchooseVisual\fP is called immediately, so +information based on its results is available. +.PP +Between the time the widget is created and it is realized, +the following apply: +.TP +\(bu +No OpenGL operations can be done to the window +.TP +\(bu +No resize callbacks are generated. +.TP +\(bu +The normal window is available (XtWindow returns NULL). +.TP +\(bu +\fBGLwDrawingAreaMakeCurrent\fP (and \fBglXMakeCurrent\fP) should not +be called. +.PP +When the widget is realized, the following actions take place: +.PP +.TP +\(bu +The window is created. +.TP +\(bu +The \fBginit\fP callback is called. The user may use this callback to +perform any needed OpenGL initialization to the window. +.sp 1 +.SH NOTES +.PP +When using the input callback to receive keyboard input, the keycode +in the event must be converted to a KeySym. Use +\fBXLookupKeysym(3X)\fP or \fBXLookupString(3X)\fP to do the +conversion. Keyboard input can also be dealt using translations, in +which case no such conversion is required. +.PP +Motif programmers should keep in mind that OSF uses virtual +bindings and replaces some of the key bindings. As a common example, +if the ESC key is to be used to exit the program (as it often is in GL +programs), the translation should specify <key>osfCancel instead of +<key>Escape. +.PP +Motif programmers may also create a GLwMDrawingArea widget with the Motif +style \fBGLwCreateMDrawingArea\fP. +.sp 1 +.ne 10 +.SH EXAMPLE +Here are some code fragments that create a GLwDrawingArea widget, and manage +the appropriate callbacks. +.sp +.nf +\f(CW + #include <stdlib.h> + #include <X11/GLw/GLwDrawA.h> + static GLXContext glx_context; /* assume only one context */ + . . . + + main() + { + Arg args[10]; + int n; + + Widget parent; /* The parent of the gl widget */ + Widget glw; /* The GLwDrawingArea widget */ + . . . + + /* Create the widget using RGB mode. This can also be set + * in an X Defaults file + */ + n = 0; + XtSetArg(args[n], GLwNrgba, True); n++; + glw = XtCreateManagedWidget("glw", glwDrawingAreaWidgetClass, + parent, args, n); + XtAddCallback(glw, GLwNexposeCallback, exposeCB, NULL); + XtAddCallback(glw, GLwNresizeCallback, resizeCB, NULL); + XtAddCallback(glw, GLwNginitCallback, ginitCB, NULL); + /* Also add input callback if needed */ + . . . + } + + static void + exposeCB(Widget w, XtPointer client_data, + GLwDrawingAreaCallbackStruct *call_data) + { + GLwDrawingAreaMakeCurrent(w, glx_context); + /* redraw the display */ + } + + static void + resizeCB(Widget w, XtPointer client_data, + GLwDrawingAreaCallbackStruct *call_data) + { + GLwDrawingAreaMakeCurrent(w, glx_context); + /* perform any resize actions */ + } + + static void + ginitCB(Widget w, XtPointer client_data, + GLwDrawingAreaCallbackStruct *call_data) + { + Arg args[1]; + XVisualInfo *vi; + + XtSetArg(args[0], GLwNvisualInfo, &vi); + XtGetValues(w, args, 1); + + /* create a visual context */ + glx_context = glXCreateContext(XtDisplay(w), vi, + NULL, GL_FALSE); + GLwDrawingAreaMakeCurrent(w, glx_context); + /* Perform any necessary graphics initialization.*/ + } +\fP +.fi +.P +The Motif program need only differ by including +\fBGLwMDrawingArea.h\fP instead of \fBGLwDrawingArea.h\fP and by creating a widget of type +\fBGLwMDrawingAreaWidgetClass\fP instead of \fBGLwDrawingAreaWidgetClass\fP. As an +alternative, the Motif program could use \fBGLwCreateMDraw(3X)\fP instead. +.sp 1 +.SH WARNINGS +.PP +If a GLwDrawingArea widget is created as a child of an already realized +widget, the GLwDrawingArea widget will be created immediately, without giving +the user an opportunity to add the \fBginit\fP callback. In such a +case, initialization should be done immediately after creating the +widget rather than by using the callback. +.PP +If the non-Motif GLwDrawingArea widget is used in a Motif program and +keyboard traversal is attempted, the behavior is undefined if the user +traverses into the GLwDrawingArea widget. +.SH SEE ALSO +\fBglXChooseVisual(3G)\fP, \fBGLwDrawingAreaMakeCurrent(3X)\fP, +\fBglXMakeCurrent(3G)\fP, \fBGLwDrawingAreaSwapBuffers(3X)\fP +\fBGLwCreateMDraw(3X)\fP, \fBCore(3X)\fP, \fBXmPrimitive(3X)\fP, +\fBVirtualBindings(3X)\fP, \fBXSetWMColormapWindows(3X11)\fP +and the OpenGL spec. diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwdrawingareamakecurrent.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwdrawingareamakecurrent.gl new file mode 100644 index 000000000..de51e4d51 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwdrawingareamakecurrent.gl @@ -0,0 +1,30 @@ +.\" ** +.\" ** (c) Copyright 1993, 1994, 1995, 1996 Silicon Graphics, Inc. +.\" ** +.\" ** (c) Copyright 1989, 1990, 1991 Open Software Foundation, Inc. +.\" ** All Rights Reserved. +.\" ** +.\" ** (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company +.\" ** +.\" ** (c) Copyright 1987, 1988 by Digital Equipment Corporation, +.\" ** Maynard, MA. All Rights Reserved. +.\" ** +.\" ** +.TH GLwDrawingAreaMakeCurrent 3X "" "" "" "" +.SH NAME +\fBGLwDrawingAreaMakeCurrent \(em Make the current GLwDrawingArea current.\fP +.iX "GLwDrawingAreaMakeCurrent" +.iX "GLwDrawingArea" +.sp 1 +.SH SYNOPSIS +\fB#include <X11/GLw/GLwDraw.h>\fP +.br +void \fBGLwDrawingAreaMakeCurrent\fP( Widget \fIw\fP, + GLXContext \fIctx\fP ) +.fi +.SH DESCRIPTION +\fBGLwDrawingAreaMakeCurrent\fP is a front end to \fBglXMakeCurrent\fP, +however instead of passing in a Display and a Window, a Widget is +passed in. +.SH SEE ALSO +\fBGLwMDrawingArea(3X)\fP, \fBglXMakeCurrent(3G)\fP. diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwdrawingareaswapbuffers.gl b/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwdrawingareaswapbuffers.gl new file mode 100644 index 000000000..c7a28b411 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manglw/glwdrawingareaswapbuffers.gl @@ -0,0 +1,30 @@ +.\" ** +.\" ** (c) Copyright 1993, 1994, 1995, 1996 Silicon Graphics, Inc. +.\" ** +.\" ** (c) Copyright 1989, 1990, 1991 Open Software Foundation, Inc. +.\" ** All Rights Reserved. +.\" ** +.\" ** (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company +.\" ** +.\" ** (c) Copyright 1987, 1988 by Digital Equipment Corporation, +.\" ** Maynard, MA. All Rights Reserved. +.\" ** +.\" ** +.TH GLwDrawingAreaSwapBuffers 3X "" "" "" "" +.SH NAME +\fBGLwDrawingAreaSwapBuffers \(em Swap buffers in a GLwDrawingArea.\fP +.iX "GLwDrawingAreaSwapBuffers" +.iX "GLwDrawingArea" +.sp 1 +.SH SYNOPSIS +\fB#include <X11/GLw/GLwDraw.h>\fP +.br +void \fBGLwDrawingAreaSwapBuffers\fP( Widget \fIw\fP ) +.br +.fi +.SH DESCRIPTION +\fBGLwDrawingAreaSwapBuffers\fP is a front end to \fBglXSwapBuffers\fP, +however instead of passing in a Display and a Window, a Widget is +passed in. +.SH SEE ALSO +\fBGLwMDrawingArea(3X)\fP, \fBglXSwapBuffers(3G)\fP. diff --git a/nx-X11/extras/ogl-sample/main/doc/man/manrules b/nx-X11/extras/ogl-sample/main/doc/man/manrules new file mode 100644 index 000000000..8f8543c76 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/manrules @@ -0,0 +1,181 @@ +# +# 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. +# +# $Date: 2004/03/14 08:29:07 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/manrules,v 1.1.1.4 2004/03/14 08:29:07 eich Exp $ + +# Generic rules for making manpages +# +# Usage: +# make <name>.psv # view page with $(PSVIEW) (no file created) +# make <name>.xpsv # view page with $(XPSVIEW) (no file created) +# make <name>.dit # view page with $(DITVIEW) (no file created) +# make <name>.p # print page (no file created) +# make <name>.ps # create PostScript for page +# make <name>.z # create online packed version; view with +# # man -d <name>.z +# make <name>.tr # create troff source for man page +# make print-list # writes a list of the hardcopy (.p) targets +# # for the current directory to stdout +# +# make default # the standard SGI targets +# make install +# make clean +# make clobber +# +# + +TT = /tmp/mmdoc$$$$ + +# To provide override, define MANPREF +$(MANPREF)default: $(MANPREF)_force + @$(LISTLEGAL) \ + | sed -e 's/\.$(LEGALSUF1)$$/.z/' -e 's/\.$(LEGALSUF2)$$/.z/' \ + -e 's/\.$(LEGALSUF3)$$/.z/' -e 's/\.$(LEGALSUF4)$$/.z/' \ + | xargs -l4 $(MAKE) + +# remove all .z, .ps, and unsuffixed versions of legal man filenames (except +# a, c, f, and p). +$(MANPREF)clean: + find . \( -name '*.z' -o -name '*.ps' \) -print | xargs rm -f + $(LISTLEGAL) \ + | sed -e 's/\.$(LEGALSUF1)$$//' -e 's/\.$(LEGALSUF2)$$//' \ + -e 's/\.$(LEGALSUF3)$$//' -e 's/\.$(LEGALSUF4)$$//' \ + | sed '/^[acfp]$$/d' \ + | xargs rm -f + rm -f $(LDIRT) + +$(MANPREF)clobber: $(MANPREF)clean + +# +# Define generic build rules +# +# Some directories have multiple sections in them (like 3c, 3, 3x, etc) +# and so we must define more than 1 default rule. +# +# The .mn suffix is for pages that are part of the printed GL Reference Manual +# but not of the online man pages. +# +.SUFFIXES:.z .p .ps .dit .tr .psv .xpsv .1 .1c .1g .1m .1w .1X .2 .2b .3 .3a .3b .3c .3f .gl .3m .3n .3p .3r .3s .3t .3w .3x .3y .4 .5 .5w .6 .6d .7 .7p .7m .3X11 .3Xt .3i .mn .3l .3gl .html + +.gl.3gl: + @echo "\t$(MMDOC) Op=$(LANGOPT) $< > $@" + @$(ADDMAGIC) | $(THTOUPPER) > $@ + +.1.z .1c.z .1g.z .1m.z .1w.z .1X.z .2.z .2b.z .3.z .3a.z .3f.z .3c.z .3p.z .3y.z .3r.z .3x.z .3n.z .3w.z .3s.z .3b.z .3m.z .3t.z .4.z .5.z .5w.z .6.z .6d.z .7.z .7p.z .7m.z .gl.z .3X11.z .3Xt.z .3i.z .3l.z: + @echo "\t$(MMDOC) Op=$(LANGOPT) $< | pack > $*.z" + @$(ADDMAGIC) | $(THTOUPPER) > $(TT) ; $(RUNMMDOC) $(TT) > $* ; \ + rm -f $(TT) + @rm -f $*.z; pack -f $* > /dev/null + +.1.p .1c.p .1g.p .1m.p .1w.p .1X.p .2.p .2b.p .3.p .3a.p .3f.p .3c.p .3p.p .3y.p .3r.p .3x.p .3n.p .3w.p .3s.p .3b.p .3m.p .3t.p .4.p .5.p .5w.p .6.p .6d.p .7.p .7p.p .7m.p .3X11.p .3Xt.p .3i.p .3l.p: + @echo "\t$(MMDOC) -Tpsc -rC5 Op=$(LANGOPT) $<" + @$(ADDMAGIC) > $(TT) ; $(RUNMMDOC) -Tpsc -rC5 $(TT) ; rm -f $(TT) + +.gl.p .mn.p: + @echo "\t$(MMDOC) -Tpsc -rC5 Op=$(LANGOPT) $<" + @$(ADDGLMAGIC) > $(TT) ; $(RUNMMDOC) -Tpsc -rC5 $(TT) ; rm -f $(TT) + +.1.ps .1c.ps .1g.ps .1m.ps .1w.ps .1X.ps .2.ps .2b.ps .3.ps .3a.ps .3f.ps .3c.ps .3p.ps .3y.ps .3r.ps .3x.ps .3n.ps .3w.ps .3s.ps .3b.ps .3m.ps .3t.ps .4.ps .5.ps .5w.ps .6.ps .6d.ps .7.ps .7p.ps .7m.ps .3X11.ps .3Xt.ps .3i.ps .3l.ps: + @echo "\t$(MMDOC) -TPS Op=$(LANGOPT) $< > $@" + @$(ADDMAGIC) > $(TT) ; $(RUNMMDOC) -TPS $(TT) > $@ ; rm -f $(TT) + +.gl.ps .mn.ps: + @echo "\t$(MMDOC) -TPS Op=$(LANGOPT) $< > $@" + @$(ADDGLMAGIC) > $(TT) ; $(RUNMMDOC) -TPS $(TT) > $@ ; rm -f $(TT) + +.gl.tr .mn.tr: +# @echo "\t$(ADDGLMAGIC) $< > $@" + @$(ADDGLMAGIC) > $@ + +.tr.ps: + @echo "\t$(MMDOC) -TPS Op=$(LANGOPT) $< > $@" + @$(RUNMMDOC) -TPS $< > $@ + +.1.psv .1c.psv .1g.psv .1m.psv .1w.psv .1X.psv .2.psv .2b.psv .3.psv .3a.psv.3f.psv .3c.psv .3p.psv .3y.psv .3r.psv .3x.psv .3n.psv .3w.psv .3s.psv .3b.psv .3m.psv .3t.psv .4.psv .5.psv .5w.psv .6.psv .6d.psv .7.psv .7p.psv .7m.psv .3X11.psv .3Xt.psv .3i.psv .3l.psv: + @echo "\t$(MMDOC) -TPS -rC4 Op=$(LANGOPT) $< | $(PSVIEW) $(PSVIEWOPTS)" + @$(ADDMAGIC) > $(TT) ; $(RUNMMDOC) -TPS -rC4 $(TT) | $(PSVIEW) $(PSVIEWOPTS); rm -f $(TT) + +.gl.psv .mn.psv: + @echo "\t$(MMDOC) -TPS -rC4 Op=$(LANGOPT) $< | $(PSVIEW) $(PSVIEWOPTS)" + @$(ADDGLMAGIC) > $(TT) ; $(RUNMMDOC) -TPS -rC4 $(TT) | $(PSVIEW) $(PSVIEWOPTS); rm -f $(TT) + +.1.xpsv .1c.xpsv .1g.xpsv .1m.xpsv .1w.xpsv .1X.xpsv .2.xpsv .2b.xpsv .3.xpsv .3a.xpsv .3f.xpsv .3c.xpsv .3p.xpsv .3y.xpsv .3r.xpsv .3x.xpsv .3n.xpsv .3w.xpsv .3s.xpsv .3b.xpsv .3m.xpsv .3t.xpsv .4.xpsv .5.xpsv .5w.xpsv .6.xpsv .6d.xpsv .7.xpsv .7p.xpsv .7m.xpsv .3X11.xpsv .3Xt.xpsv .3i.xpsv .3l.xpsv .3il.xpsv: + @echo "\t$(MMDOC) -TPS -rC4 Op=$(LANGOPT) $< | $(XPSVIEW) $(XPSVIEWOPTS)" + @$(ADDMAGIC) > $(TT) ; $(RUNMMDOC) -TPS -rC4 $(TT) | $(XPSVIEW) $(XPSVIEWOPTS); rm -f $(TT) + +.gl.xpsv .mn.xpsv: + @echo "\t$(MMDOC) -TPS -rC4 Op=$(LANGOPT) $< | $(XPSVIEW) $(XPSVIEWOPTS)" + @$(ADDGLMAGIC) > $(TT) ; $(RUNMMDOC) -TPS -rC4 $(TT) | $(XPSVIEW) $(XPSVIEWOPTS); rm -f $(TT) + +.1.dit .1c.dit .1g.dit .1m.dit .1w.dit .1X.dit .2.dit .2b.dit .3.dit .3a.dit .3f.dit .3c.dit .3p.dit .3y.dit .3r.dit .3x.dit .3n.dit .3w.dit .3s.dit .3b.dit .3m.dit .3t.dit .4.dit .5.dit .5w.dit .6.dit .6d.dit .7.dit .7p.dit .7m.dit .3X11.dit .3Xt.dit .3i.dit .3l.dit: + @echo "\t$(MMDOC) -TX100 -rC4 Op=$(LANGOPT) $< | $(DITVIEW)" + @$(ADDMAGIC) > $(TT) ; $(RUNMMDOC) -TX100 -rC4 $(TT) | $(DITVIEW) + +.gl.dit .mn.dit: + @echo "\t$(MMDOC) -TX100 -rC4 Op=$(LANGOPT) $< | $(DITVIEW)" + @$(ADDGLMAGIC) > $(TT) ; $(RUNMMDOC) -TX100 -rC4 $(TT) | $(DITVIEW) + +# The Irix man -d option must have a full pathname. This assumes +# that $(VPATH) is the full pathname to the dependency directory. +ifeq ($(OS),IRIX) +.3gl.html: + man -d $(VPATH)/$(<F) | $(MAN2HTML) > $@ +endif +ifeq ($(OS),Linux) +.3gl.html: + man -M . $< | $(MAN2HTML) > $@ +endif + +# write a list of the hardcopy (.p) targets for the current directory to stdout +# use LOCALPRINTLISTFILTER to do directory-dependent filtering, e.g reordering +# to put intro.p first +print-list: $(MANPREF)_force + @$(LISTLEGAL) \ + | sed -e 's/\.$(LEGALSUF1)$$/.p/' -e 's/\.$(LEGALSUF2)$$/.p/' \ + -e 's/\.$(LEGALSUF3)$$/.p/' -e 's/\.$(LEGALSUF4)$$/.p/' \ + | sort -t. +0 -1 \ + $(LOCALPRINTLISTFILTER) + +$(MANPREF)install: $(MANPREF)default MakeOtherInstalls + $(INSTALL) -idb $(IDB_TAG) -m 444 -F $(IDB_PATH) *.z + +# only look for aliases in legal man page filenames +MakeOtherInstalls: $(MANPREF)_force + @echo "\tmaking symlink install lines" + @$(LISTLEGAL) \ + | xargs $(GETNAMES) opt=$(LANGOPT) \ + | $(ADDINST) $(IDB_TAG) $(IDB_PATH) $(INSTALL) > $(TT); \ + sh $(TT); rm -f $(TT) + +$(MANPREF)_force: diff --git a/nx-X11/extras/ogl-sample/main/doc/man/tools/GNUmakefile b/nx-X11/extras/ogl-sample/main/doc/man/tools/GNUmakefile new file mode 100644 index 000000000..15593a2d2 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/tools/GNUmakefile @@ -0,0 +1,49 @@ +#!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. +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/tools/GNUmakefile,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ + +COMMONPREF = standard +include $(ROOT)/usr/include/make/commondefs + +default headers headers_install libs libs_install install apps: + chmod +x mdate.pl mmdoc glman + +distsi distoss: + $(MAKE) $(COMMONPREF)$@ + +$(COMMONTARGS): % : $(COMMONPREF)% + +include $(COMMONRULES) diff --git a/nx-X11/extras/ogl-sample/main/doc/man/tools/constCheck.pl b/nx-X11/extras/ogl-sample/main/doc/man/tools/constCheck.pl new file mode 100644 index 000000000..391435706 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/tools/constCheck.pl @@ -0,0 +1,160 @@ +#! /usr/sbin/perl +# +# 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. +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/tools/constCheck.pl,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ + +#----------------------------------------------------------------------------- +# +# Command line options +# + +use Getopt::Std; +getopts( 'v' ); + +$verbose = 1 if $opt_v; + +#----------------------------------------------------------------------------- +# +# Configuration Variables +# + +$ROOT = $ENV{'ROOT'}; + +#----------------------------------------------------------------------------- +# +# Reference Files +# + +$gl_h = "$ROOT/usr/include/GL/gl.h"; +$glu_h = "$ROOT/usr/include/GL/glu.h"; +$glx_h = "$ROOT/usr/include/GL/glx.h"; +$glxtokens_h = "$ROOT/usr/include/GL/glxtokens.h"; + + +#----------------------------------------------------------------------------- +# +# Build lookup tables +# + +%glTokens = (); +open( INFILE, "$gl_h" ); +while ( <INFILE> ) { + $glTokens{$1} = 1 if /^\#\s*define\s+GL_([\w\d_]+)/; +} +close( INFILE ); + +%gluTokens = (); +open( INFILE, "$glu_h" ); +while ( <INFILE> ) { + $gluTokens{$1} = 1 if /^\#\s*define\s+GLU_([\w\d_]+)/; +} +close( INFILE ); + +%glxTokens = (); +open( INFILE, "$glx_h" ); +while ( <INFILE> ) { + $glxTokens{$1} = 1 if /^\#\s*define\s+GLX_([\w\d_]+)/; +} +close( INFILE ); + +open( INFILE, "$glxtokens_h" ); +while ( <INFILE> ) { + $glxTokens{$1} = 1 if /^\#\s*define\s+GLX_([\w\d_]+)/; +} +close( INFILE ); + + +#----------------------------------------------------------------------------- +# +# Check files +# + +$fmt = "[%s:%d] Undefined %s constant : '%s'\n"; + +foreach $file ( @ARGV ) { + $line = 1; + open( INFILE, "$file" ) || ( warn "Unable to open file '$file'\n", next ); + + print "Checking '$file' ...\n" if $verbose; + + while ( <INFILE> ) { + @words = split; + @tokens = grep( /_\w*const\([\w\d_]+\)/, @words ); + + foreach ( @tokens ) { + /(_\w*const)\(([\w\d]+)\)/; + $constTag = $1; + $token = $2; + + SWITCH : { + $constTag =~ /_const|_econst|_extstring/ + && do { + printf( $fmt, $file, $line, "GL", $token) + unless $glTokens{$token} == 1; + last SWITCH; + }; + + # + # _arbconst's tack an extra "_ARB" onto the end of the + # token. We need to check that. + # + $constTag =~ /_arbconst/ + && do { + $arbToken = $token . "_ARB"; + printf( $fmt, $file, $line, "GL", $token) + unless $glTokens{$arbToken} == 1; + last SWITCH; + }; + + $constTag =~ /_gluconst/ + && do { + printf( $fmt, $file, $line, "GLU", $token) + unless $gluTokens{$token} == 1; + last SWITCH; + }; + + $constTag =~ /_glxconst|_glxerror|_glxextstring/ + && do { + printf( $fmt, $file, $line, "GLX", $token) + unless $glxTokens{$token} == 1; + last SWITCH; + }; + } + } + + $line++; + } + close( INFILE ); +} diff --git a/nx-X11/extras/ogl-sample/main/doc/man/tools/glman b/nx-X11/extras/ogl-sample/main/doc/man/tools/glman new file mode 100644 index 000000000..248fd8d6c --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/tools/glman @@ -0,0 +1,57 @@ +#! /bin/sh +# +# 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. +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/tools/glman,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ + +# $1 is the value of $PREFIX, $2 is the value of $DEPTH, +# $3 is the target name, and $4 is the api file name. +# $5 is M4 options (if any) + +bNamE=`echo $3 | sed -e s/\\\..*//` +maCdIr=$2/macros +export maCdIr +m4opts=$5 + +case `pwd` in + *ftn) mKHeaD=mkhead.ftn.awk ; SeTUp=setup.ftn ;; + *) mKHeaD=mkhead.awk ; SeTUp=setup ;; +esac + +trap "rm -rf glmanm4.$$" 0 1 2 15 + +aPiFile=${4:-$ROOT/usr/include/GL/gl.h} + +awk -f $2/macros/$mKHeaD -v prefix=$1 -v basename=$bNamE $aPiFile >glmanm4.$$ +cat $2/macros/$SeTUp glmanm4.$$ $3 | m4 $m4opts diff --git a/nx-X11/extras/ogl-sample/main/doc/man/tools/man2html b/nx-X11/extras/ogl-sample/main/doc/man/tools/man2html new file mode 100644 index 000000000..4953a6632 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/tools/man2html @@ -0,0 +1,608 @@ +#!/usr/bin/perl +#!/usr/local/bin/perl +##---------------------------------------------------------------------------## +## File: +## @(#) man2html 1.2 97/08/12 12:57:30 @(#) +## Author: +## Earl Hood, ehood@medusa.acs.uci.edu +## Description: +## man2html is a Perl program to convert formatted nroff output +## to HTML. +## +## Recommend command-line options based on platform: +## +## Platform Options +## --------------------------------------------------------------------- +## c2mp <None, the defaults should be okay> +## hp9000s700/800 -leftm 1 -topm 8 +## sun4 -sun +## --------------------------------------------------------------------- +## +##---------------------------------------------------------------------------## +## Copyright (C) 1995-1997 Earl Hood, ehood@medusa.acs.uci.edu +## +## This program is free software; you can redistribute it and/or modify +## it under the terms of the GNU General Public License as published by +## the Free Software Foundation; either version 2 of the License, or +## (at your option) any later version. +## +## This program is distributed in the hope that it will be useful, +## but WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +## GNU General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with this program; if not, write to the Free Software +## Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA +## 02111-1307, USA +##---------------------------------------------------------------------------## + +package Man2Html; + +use Getopt::Long; + +($PROG = $0) =~ s/.*\///; +$VERSION = "3.0.1"; + +## Input and outputs filehandles +$InFH = \*STDIN unless $InFH; +$OutFH = \*STDOUT unless $OutFH; + +## Backspace character: Used in overstriking detection +*bs = \"\b"; + +## Hash of section titles and their HTML tag wrapper. +## This list allows customization of what HTML tag is used for +## a given section head. +## +## The section title can be a regular expression. Therefore, one must +## be careful about quoting special characters. +## +%SectionHead = ( + + '\S.*OPTIONS.*' => '<H2>', + 'AUTHORS?' => '<H2>', + 'BUGS' => '<H2>', + 'COMPATIBILITY' => '<H2>', + 'DEPENDENCIES' => '<H2>', + 'DESCRIPTION' => '<H2>', + 'DIAGNOSTICS' => '<H2>', + 'ENVIRONMENT' => '<H2>', + 'ERRORS' => '<H2>', + 'EXAMPLES' => '<H2>', + 'EXTERNAL INFLUENCES' => '<H2>', + 'FILES' => '<H2>', + 'LIMITATIONS' => '<H2>', + 'NAME' => '<H2>', + 'NOTES?' => '<H2>', + 'OPTIONS' => '<H2>', + 'REFERENCES' => '<H2>', + 'RETURN VALUE' => '<H2>', + 'SECTION.*:' => '<H2>', + 'SEE ALSO' => '<H2>', + 'STANDARDS CONFORMANCE' => '<H2>', + 'STYLE CONVENTION' => '<H2>', + 'SYNOPSIS' => '<H2>', + 'SYNTAX' => '<H2>', + 'WARNINGS' => '<H2>', + '\s+Section.*:' => '<H3>', + +); + +## Fallback tag if above is not found +$HeadFallback = '<H2>'; + +## Other gobals + +$Bare = 0; # Skip printing HTML head/foot flag +$BTag = 'B'; # Overstrike tag +$CgiUrl = ''; # CGI URL expression +$Compress = 0; # Do blank line compression flag +$K = 0; # Do keyword search processing flag +$NoDepage = 0; # Do not strip page information +$NoHeads = 0; # Do no header detection flag +$SeeAlso = 0; # Do only SEE ALSO xrefs flag +$Solaris = 0; # Solaris keyword search processing flag +$Sun = 0; # Headers not overstriken flag +$Title = ''; # Title +$UTag = 'I'; # Underline tag +$ftsz = 7; # Bottome margin size +$hdsz = 7; # Top margin size +$leftm = ''; # Left margin pad +$leftmsz = 0; # Left margin size +$pgsz = 66; # Size of page size +$txsz = 52; # Text body length size + +############################################################################# +## Main Block +############################################################################# +{ + if (get_cli_opts()) { + if ($K) { + man_k(); + } else { + do_it(); + } + } else { + usage(); + } +} + +############################################################################# +## Subroutines +############################################################################# + +sub do_it { + + ## Define while loop and then eval it when used. The reason + ## is to avoid the regular expression reevaulation in the + ## section head detection code. + + $doitcode =<<'EndOfDoItCode'; + + my($line, $tmp, $i, $head, $preindent, $see_also, $do); + + $see_also = !$SeeAlso; + print $OutFH "<!-- Manpage converted by man2html $VERSION -->\n"; + LOOP: while(!eof($InFH)) { + $blank = 0; + for ($i=0; $i < $hdsz; $i++) { + last LOOP unless defined($_ = <$InFH>); + } + for ($i=0; $i < $txsz; $i++) { + last LOOP unless defined($_ = <$InFH>); + + ## Check if compress consecutive blank lines + if ($Compress and !/\S/) { + if ($blank) { next; } else { $blank = 1; } + } else { + $blank = 0; + } + + ## Try to check if line space is needed at page boundaries ## + if (!$NoDepage && ($i==0 || $i==($txsz-1)) && !/^\s*$/) { + /^(\s*)/; $tmp = length($1); + if ($do) { + if ($tmp < $preindent) { print $OutFH "\n"; } + } else { + $do = 1; + } + $preindent = $tmp; + } else { + $do = 0; $preindent = 0; + } + + ## Interpret line + $line = $_; + entitize(\$_); # Convert [$<>] to entity references + + ## Check for 'SEE ALSO' link only + if (!$see_also && $CgiUrl && $SeeAlso) { + ($tmp = $line) =~ s/.\010//go; + if ($tmp =~ /^\s*SEE\s+ALSO\s*$/o) { $see_also = 1; } + else { $see_also = 0; } + } + + ## Create anchor links for manpage references + s/((((.\010)+)?[\+_\.\w-])+\(((.\010)+)? + \d((.\010)+)?\w?\)) + /make_xref($1) + /geox if $see_also; + + ## Emphasize underlined words + # s/((_\010[^_])+[\.\(\)_]?(_\010[^_])+\)?)/emphasize($1)/oge; + # s/((_\010[^_])+([\.\(\)_]?(_\010[^_])+)?)/emphasize($1)/oge; + # + # The previous expressions were trying to be clever about + # detecting underlined text which contain non-alphanumeric + # characters. nroff will not underline non-alphanumeric + # characters in an underlined phrase, and the above was trying + # to detect that. It does not work all the time, and it + # screws up other text, so a simplified expression is used. + + s/((_\010[^_])+)/emphasize($1)/oge; + + $secth = 0; + ## Check for strong text and headings + if ($Sun || /.\010./o) { + if (!$NoHeads) { + $line =~ s/.\010//go; + $tmp = $HeadFallback; +EndOfDoItCode + + ## Create switch statement for detecting a heading + ## + $doitcode .= "HEADSW: {\n"; + foreach $head (keys %SectionHead) { + $doitcode .= join("", "\$tmp = '$SectionHead{$head}', ", + "\$secth = 1, last HEADSW ", + "if \$line =~ /^$leftm$head/o;\n"); + } + $doitcode .= "}\n"; + + ## Rest of routine + ## + $doitcode .=<<'EndOfDoItCode'; + if ($secth || $line =~ /^$leftm\S/o) { + chop $line; + $_ = $tmp . $line . $tmp; + s%<([^>]*)>$%</$1>%; + $_ = "\n</PRE>\n" . $_ . "<PRE>\n"; + } else { + s/(((.\010)+.)+)/strongize($1)/oge; + } + } else { + s/(((.\010)+.)+)/strongize($1)/oge; + } + } + print $OutFH $_; + } + + for ($i=0; $i < $ftsz; $i++) { + last LOOP unless defined($_ = <$InFH>); + } + } +EndOfDoItCode + + + ## Perform processing. + + printhead() unless $Bare; + print $OutFH "<PRE>\n"; + eval $doitcode; # $doitcode defined above + print $OutFH "</PRE>\n"; + printtail() unless $Bare; +} + +##--------------------------------------------------------------------------- +## +sub get_cli_opts { + return 0 unless + GetOptions( + "bare", # Leave out HTML, HEAD, BODY tags. + "belem=s", # HTML Element for overstriked text (def: "B") + "botm=i", # Number of lines for bottom margin (def: 7) + "cgiurl=s", # CGI URL for linking to other manpages + "cgiurlexp=s", # CGI URL Perl expr for linking to other manpages + "compress", # Compress consecutive blank lines + "headmap=s", # Filename of user section head map file + "k", # Process input from 'man -k' output. + "leftm=i", # Character width of left margin (def: 0) + "nodepage", # Do not remove pagination lines + "noheads", # Do not detect for section heads + "pgsize=i", # Number of lines in a page (def: 66) + "seealso", # Link to other manpages only in the SEE ALSO section + "solaris", # Parse 'man -k' output from a solaris system + "sun", # Section heads are not overstriked in input + "title=s", # Title of manpage (def: Not defined) + "topm=i", # Number of lines for top margin (def: 7) + "uelem=s", # HTML Element for underlined text (def: "I") + + "help" # Short usage message + ); + return 0 if defined($opt_help); + + $pgsz = $opt_pgsize || $pgsz; + if (defined($opt_nodepage)) { + $hdsz = 0; + $ftsz = 0; + } else { + $hdsz = $opt_topm if defined($opt_topm); + $ftsz = $opt_botm if defined($opt_botm); + } + $txsz = $pgsz - ($hdsz + $ftsz); + $leftmsz = $opt_leftm if defined($opt_leftm); + $leftm = ' ' x $leftmsz; + + $Bare = defined($opt_bare); + $Compress = defined($opt_compress); + $K = defined($opt_k); + $NoDepage = defined($opt_nodepage); + $NoHeads = defined($opt_noheads); + $SeeAlso = defined($opt_seealso); + $Solaris = defined($opt_solaris); + $Sun = defined($opt_sun); + + $Title = $opt_title || $Title; + $CgiUrl = $opt_cgiurlexp || + ($opt_cgiurl ? qq{return "$opt_cgiurl"} : ''); + + $BTag = $opt_belem || $BTag; + $UTag = $opt_uelem || $UTag; + $BTag =~ s/[<>]//g; + $UTag =~ s/[<>]//g; + + if (defined($opt_headmap)) { + require $opt_headmap or warn "Unable to read $opt_headmap\n"; + } + 1; +} + +##--------------------------------------------------------------------------- +sub printhead { + print $OutFH "<HTML>\n"; + print $OutFH "<HEAD>\n", + "<TITLE>$Title</TITLE>\n", + "</HEAD>\n" if $Title; + print $OutFH "<BODY>\n"; + print $OutFH "<H1>$Title</H1>\n", + "<HR>\n" if $Title; +} + +##--------------------------------------------------------------------------- +sub printtail { + print $OutFH <<EndOfRef; +<HR> +<ADDRESS> +Man(1) output converted with +<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a> +</ADDRESS> +</BODY> +</HTML> +EndOfRef +} + +##--------------------------------------------------------------------------- +sub emphasize { + my($txt) = shift; + $txt =~ s/.\010//go; + $txt = "<$UTag>$txt</$UTag>"; + $txt; +} + +##--------------------------------------------------------------------------- +sub strongize { + my($txt) = shift; + $txt =~ s/.\010//go; + $txt = "<$BTag>$txt</$BTag>"; + $txt; +} + +##--------------------------------------------------------------------------- +sub entitize { + my($txt) = shift; + + ## Check for special characters in overstrike text ## + $$txt =~ s/_\010\&/strike('_', '&')/geo; + $$txt =~ s/_\010</strike('_', '<')/geo; + $$txt =~ s/_\010>/strike('_', '>')/geo; + + $$txt =~ s/(\&\010)+\&/strike('&', '&')/geo; + $$txt =~ s/(<\010)+</strike('<', '<')/geo; + $$txt =~ s/(>\010)+>/strike('>', '>')/geo; + + ## Check for special characters in regular text. Must be careful + ## to check before/after character in expression because it might be + ## a special character. + $$txt =~ s/([^\010]\&[^\010])/htmlize2($1)/geo; + $$txt =~ s/([^\010]<[^\010])/htmlize2($1)/geo; + $$txt =~ s/([^\010]>[^\010])/htmlize2($1)/geo; +} + +##--------------------------------------------------------------------------- +## escape special characters in a string, in-place +## +sub htmlize { + my($str) = shift; + $$str =~ s/&/\&/g; + $$str =~ s/</\</g; + $$str =~ s/>/\>/g; + $$str; +} + +##--------------------------------------------------------------------------- +## htmlize2() is used by entitize. +## +sub htmlize2 { + my($str) = shift; + $str =~ s/&/\&/g; + $str =~ s/</\</g; + $str =~ s/>/\>/g; + $str; +} + +##--------------------------------------------------------------------------- +## strike converts HTML special characters in overstriked text +## into entity references. The entities are overstriked so +## strongize() and emphasize() will recognize the entity to be +## wrapped in tags. +## +sub strike { + my($w, $char) = @_; + my($ret); + if ($w eq '_') { + if ($char eq '&') { + $ret = "_$bs\&_${bs}a_${bs}m_${bs}p_${bs};"; + } elsif ($char eq '<') { + $ret = "_$bs\&_${bs}l_${bs}t_${bs};"; + } elsif ($char eq '>') { + $ret = "_$bs\&_${bs}g_${bs}t_${bs};"; + } else { + warn qq|Unrecognized character, "$char", passed to strike()\n|; + } + } else { + if ($char eq '&') { + $ret = "\&$bs\&a${bs}am${bs}mp${bs}p;${bs};"; + } elsif ($char eq '<') { + $ret = "\&$bs\&l${bs}lt${bs}t;${bs};"; + } elsif ($char eq '>') { + $ret = "\&$bs\&g${bs}gt${bs}t;${bs};"; + } else { + warn qq|Unrecognized character, "$char", passed to strike()\n|; + } + } + $ret; +} + +##--------------------------------------------------------------------------- +## make_xref() converts a manpage crossreference into a hyperlink. +## +sub make_xref { + my $str = shift; + $str =~ s/.\010//go; # Remove overstriking + + if ($CgiUrl) { + my($title,$section,$subsection) = + ($str =~ /([\+_\.\w-]+)\((\d)(\w?)\)/); + + $title =~ s/\+/%2B/g; + my($href) = (eval $CgiUrl); + qq|<B><A HREF="$href">$str</A></B>|; + } else { + qq|<B>$str</B>|; + } +} + +##--------------------------------------------------------------------------- +## man_k() process a keyword search. The problem we have is there +## is no standard for keyword search results from man. Solaris +## systems have a different enough format to warrent dealing +## with it as a special case. For other cases, we try our best. +## Unfortunately, there are some lines of results that may be +## skipped. +## +sub man_k { + my($line,$refs,$section,$subsection,$desc,$i, + %Sec1, %Sec1sub, %Sec2, %Sec2sub, %Sec3, %Sec3sub, + %Sec4, %Sec4sub, %Sec5, %Sec5sub, %Sec6, %Sec6sub, + %Sec7, %Sec7sub, %Sec8, %Sec8sub, %Sec9, %Sec9sub, + %SecN, %SecNsub, %SecNsec); + + printhead() unless $Bare; + print $OutFH "<!-- Man keyword results converted by ", + "man2html $VERSION -->\n"; + + while ($line = <$InFH>) { + next if $line !~ /\(\d\w?\)\s+-\s/; # check if line can be handled + ($refs,$section,$subsection,$desc) = + $line =~ /^\s*(.*)\((\d)(\w?)\)\s*-\s*(.*)$/; + + if ($Solaris) { + $refs =~ s/^\s*([\+_\.\w-]+)\s+([\+_\.\w-]+)\s*$/$1/; + # <topic> <manpage> + } else { + $refs =~ s/\s(and|or)\s/,/gi; # Convert and/or to commas + $refs =~ s/^[^:\s]:\s*//; # Remove prefixed whatis path + } + $refs =~ s/\s//g; # Remove all whitespace + $refs =~ s/,/, /g; # Put space after comma + htmlize(\$desc); # Check for special chars in desc + $desc =~ s/^(.)/\U$1/; # Uppercase first letter in desc + + if ($section eq '1') { + $Sec1{$refs} = $desc; $Sec1sub{$refs} = $subsection; + } elsif ($section eq '2') { + $Sec2{$refs} = $desc; $Sec2sub{$refs} = $subsection; + } elsif ($section eq '3') { + $Sec3{$refs} = $desc; $Sec3sub{$refs} = $subsection; + } elsif ($section eq '4') { + $Sec4{$refs} = $desc; $Sec4sub{$refs} = $subsection; + } elsif ($section eq '5') { + $Sec5{$refs} = $desc; $Sec5sub{$refs} = $subsection; + } elsif ($section eq '6') { + $Sec6{$refs} = $desc; $Sec6sub{$refs} = $subsection; + } elsif ($section eq '7') { + $Sec7{$refs} = $desc; $Sec7sub{$refs} = $subsection; + } elsif ($section eq '8') { + $Sec8{$refs} = $desc; $Sec8sub{$refs} = $subsection; + } elsif ($section eq '9') { + $Sec9{$refs} = $desc; $Sec9sub{$refs} = $subsection; + } else { # Catch all + $SecN{$refs} = $desc; $SecNsec{$refs} = $section; + $SecNsub{$refs} = $subsection; + } + } + print_mank_sec(\%Sec1, 1, \%Sec1sub); + print_mank_sec(\%Sec2, 2, \%Sec2sub); + print_mank_sec(\%Sec3, 3, \%Sec3sub); + print_mank_sec(\%Sec4, 4, \%Sec4sub); + print_mank_sec(\%Sec5, 5, \%Sec5sub); + print_mank_sec(\%Sec6, 6, \%Sec6sub); + print_mank_sec(\%Sec7, 7, \%Sec7sub); + print_mank_sec(\%Sec8, 8, \%Sec8sub); + print_mank_sec(\%Sec9, 9, \%Sec9sub); + print_mank_sec(\%SecN, 'N', \%SecNsub, \%SecNsec); + + printtail() unless $Bare; +} +##--------------------------------------------------------------------------- +## print_mank_sec() prints out manpage cross-refs of a specific section. +## +sub print_mank_sec { + my($sec, $sect, $secsub, $secsec) = @_; + my(@array, @refs, $href, $item, $title, $subsection, $i, $section, + $xref); + $section = $sect; + + @array = sort keys %$sec; + if ($#array >= 0) { + print $OutFH "<H2>Section $section</H2>\n", + "<DL COMPACT>\n"; + foreach $item (@array) { + @refs = split(/,/, $item); + $section = $secsec->{$item} if $sect eq 'N'; + $subsection = $secsub->{$item}; + if ($CgiUrl) { + ($title = $refs[0]) =~ s/\(\)//g; # watch out for extra ()'s + $xref = eval $CgiUrl; + } + print $OutFH "<DT>\n"; + $i = 0; + foreach (@refs) { + if ($CgiUrl) { + print $OutFH qq|<B><A HREF="$xref">$_</A></B>|; + } else { + print $OutFH $_; + } + print $OutFH ", " if $i < $#refs; + $i++; + } + print $OutFH " ($section$subsection)\n", + "</DT><DD>\n", + $sec->{$item}, "</DD>\n"; + } + print $OutFH "</DL>\n"; + } +} + +##--------------------------------------------------------------------------- +## +sub usage { + print $OutFH <<EndOfUsage; +Usage: $PROG [ options ] < infile > outfile +Options: + -bare : Do not put in HTML, HEAD, BODY tags + -belem <elem> : HTML Element for overstriked text (def: "B") + -botm <#> : Number of lines for bottom margin (def: 7) + -cgiurl <url> : URL for linking to other manpages + -cgiurlexp <url> : Perl expression URL for linking to other manpages + -compress : Compress consective blank lines + -headmap <file> : Filename of user section head map file + -help : This message + -k : Process a keyword search result + -leftm <#> : Character width of left margin (def: 0) + -nodepage : Do not remove pagination lines + -noheads : Turn off section head detection + -pgsize <#> : Number of lines in a page (def: 66) + -seealso : Link to other manpages only in the SEE ALSO section + -solaris : Process keyword search result in Solaris format + -sun : Section heads are not overstriked in input + -title <string> : Title of manpage (def: Not defined) + -topm <#> : Number of lines for top margin (def: 7) + -uelem <elem> : HTML Element for underlined text (def: "I") + +Description: + $PROG takes formatted manpages from STDIN and converts it to HTML sent + to STDOUT. The -topm and -botm arguments are the number of lines to the + main body text and NOT to the running headers/footers. + +Version: + $VERSION + Copyright (C) 1995-1997 Earl Hood, ehood\@medusa.acs.uci.edu + $PROG comes with ABSOLUTELY NO WARRANTY and $PROG may be copied only + under the terms of the GNU General Public License, which may be found in + the $PROG distribution. + +EndOfUsage + exit 0; +} diff --git a/nx-X11/extras/ogl-sample/main/doc/man/tools/mdate.pl b/nx-X11/extras/ogl-sample/main/doc/man/tools/mdate.pl new file mode 100644 index 000000000..43fd2df79 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/tools/mdate.pl @@ -0,0 +1,50 @@ +#!/usr/bin/perl +# +# 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. +# +# $Date: 2004/03/14 08:29:09 $ $Revision: 1.1.1.4 $ +# $Header: /cvs/xorg/xc/extras/ogl-sample/main/doc/man/tools/mdate.pl,v 1.1.1.4 2004/03/14 08:29:09 eich Exp $ + +foreach (@ARGV) { + ($dev,$ino,$mode,$nlink,$uid,$gid,$rdev,$size,$atime, + $mtime,$ctime,$blksize,$blocks) = stat($_); + + if ($mtime) { + ($tm_sec,$tm_min,$tm_hour,$tm_mday,$tm_mon,$tm_year,$tm_wday, + $tm_yday,$tm_isdst) = localtime($mtime); + + if ($tm_mday) { + print "-rd", $tm_mday, " -rm", $tm_mon, " -ry", $tm_year, "\n"; + } + } +} diff --git a/nx-X11/extras/ogl-sample/main/doc/man/tools/mmdoc b/nx-X11/extras/ogl-sample/main/doc/man/tools/mmdoc new file mode 100644 index 000000000..e4a0f8de8 --- /dev/null +++ b/nx-X11/extras/ogl-sample/main/doc/man/tools/mmdoc @@ -0,0 +1,224 @@ +#! /bin/sh + +# $XFree86$ + +set -x + +# @(#)mmdoc 1.21 /doccenter/tmadm/src/shell/s.mmdoc +# general documentation generator +# +# Files begining with a ".TH" macro are treated as manual pages. +# Files whose first line is +# '\" x +# where "x" is a string begining with "c", "e", "t" are also treated as +# manual pages. +# Files whose first line is +# '\"! text +# are processed by the command line "text" with the file provided +# as the standard input. +# Files whose first line is +# '\"macro name +# where "name" is the name of a file in TMMACRO will be run off with +# that macro package. "name"s begining "-" will be flag arguments +# to nroff. +# All others are handed to nroff with -cm and mmdoc +# +# Assumes mdate.pl will be found by the current search path. +# +umask 0 # nroff must be able to write into files it closes +while [ -n "$1" ] +do + case $1 in + -D ) + DrafT=-rC3 + export DrafT + ;; + -T* ) + TERM=`expr $1 : '-T\(.*\)'` + case ${TERM} in + eps) + post="|deps" + flavor=troff + ;; + aps) + post="|apsend b=m305" + flavor=troff + ;; + Aps) # This is a fake out so that collections + # can be sent as a unit to APS-5 + # instead of series of calls. Used only by + # collection routine 'tcol_final' + post= + flavor=troff + TERM=aps + ;; + image) + post="|apsend b=m305 d=i" + flavor=troff + TERM=aps + ;; + i300) + post="|dimpress" + flavor=troff + ;; + 8300) + post="|dimpress" + flavor=troff + TERM=aps + ;; + psc) + post="|psdit |lp -oh" + flavor=troff + export TERM + ;; + + PS) + post="|psdit" + flavor=troff + TERM=psc + export TERM + ;; + X100) + post="" + flavor=troff + TERM=X100 + export TERM + ;; + *) + post= + flavor=nroff + ;; + esac + export post flavor + ;; + -r[ymd]* ) + DocdatE="$DocdatE $1" + export DocdatE + dateset=yes + ;; + -?* ) + flags="$flags $1" + export flags + ;; + - | * ) + break + esac + shift +done +if [ $# = 0 ] +then + set -- - +fi +for i +{ + if [ "$i" != "-" -a ! -s "$i" ] + then + echo "Cannot input file: $i" + continue + fi + case $i in + - ) + ;; + * ) + Line1=`line <$i` + if [ ! "${dateset}" ] + then + # DocdatE is intentionally capitalized that way + # to cut the possibility of env name collision. + DocdatE=`mdate.pl $i` + export DocdatE + fi + esac + + MacrO=${TMMACRO} + + case "${Line1}" in + .TH* | "'\\\" "[cet]* ) + man -T${TERM} -d ${DocdatE} $* + ;; + "'\\\"!"* ) + cmd=`echo "${Line1}" | sed 's/^....//'` + if [ "$flavor" != troff ] + then + cmd=`echo " ${cmd} " | sed 's/ eqn / neqn /'` + fi + Line1=`sed -n -e 2p -e 2q ${i}` + export Line1 + if [ "$flavor" = troff ] + then + eval '<$i' $cmd + #eval `parse "$cmd" ${i}` + else + TERM=lp + eval '<$i' $cmd + fi + ;; + "'\\\"macro"* ) + cmd=`echo "${Line1}" | + sed ' s/.."macro//'" + s:[ ]\([^- ]\): ${TMMACRO?}/\1:g"` + cmd=`echo $cmd|sed "s;[ ]*.*/stdmacro;${MacrO?}/strings.mm ${MacrO?}/stdmacro;"` + cmd="$cmd $OTHERFILES" + if [ "$flavor" = troff ] + then + case "$cmd" in + *stdmacro*) + case "$flags" in + *-rs[0-9]*) + ;; + *) + flags="${flags} -rs1" + esac + esac + eval troff -T${TERM} ${DrafT} ${DocdatE} ${flags} ${cmd} $i ${post} + else + eval nroff ${DrafT} ${DocdatE} ${flags} ${cmd} $i + fi + ;; + "'\\\"text"* ) + cmd=`echo "${Line1}" | + sed ' s/.."text//'" + s:[ ]\([^- ]\): ${TMMACRO?}/\1:g"` + cmd=`echo $cmd|sed "s;[ ]*.*/docmacs;${MacrO?}/docmacs;"` + if [ "$flavor" = troff ] + then + eval troff -T${TERM} ${DrafT} ${DocdatE} ${flags} ${cmd} $i ${post} + else + eval nroff ${DrafT} ${DocdatE} ${flags} ${cmd} $i + fi + ;; + .tH* ) + # Right now 2/12/85 this stuff not used for DSG work. + # No enhancements to do troff done yet. + # Will do as necessary + if [ -r ${TMMACRO}/mandocvar ] + then + . ${TMMACRO}/mandocvar + fi + nroff -T${TERM} ${DocdatE} ${flags} \ + -can ${MacrO?}/mandoc ${i} | + col + ;; + .pH* | '' | * ) + if [ -r ${TMMACRO}/mmdocvar ] + then + . ${TMMACRO}/mmdocvar + fi + if [ "$flavor" = troff ] + then + eval troff -T${TERM} -rW${Width:-5}i \ + -rL${Length:-8.5}i \ + ${DocdatE} ${DrafT} ${flags} \ + /usr/bin/mmt $i ${post} + else + TERM=lp + nroff -T${TERM} -u${Overstrike:-1} -rW${Width:-79} \ + -rO${Offset:-0} -rL${Length:-66} \ + ${DocdatE} ${DrafT} ${flags} \ + ${MacrO?}/newmm \ + ${MacrO?}/mmdoc ${TMMACRO}/custom $i | + col + fi + ;; + esac +} |