@end example
@defmac attrib-mask bit...
-Bitfield constructor. The symbolic @var{bit} arguments are replaced
-with their corresponding numeric values and combined with @code{logior}
-at compile-time. The symbolic arguments known to this bitfield
-constructor are:
+Bitfield constructor. The symbolic @var{bit} arguments are replaced with
+their corresponding numeric values and combined with @code{logior} at
+compile-time. The symbolic arguments known to this bitfield constructor
+are:
@code{current}, @code{point}, @code{line}, @code{polygon},
@code{polygon-stipple}, @code{pixel-mode}, @code{lighting}, @code{fog},
@end defmac
@defmac version-1-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{multisample-bit}, @code{multisample},
@end defmac
@defmac arb-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{multisample-bit-arb}, @code{multisample-arb},
@end defmac
@defmac ext-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{multisample-bit-ext}, @code{multisample-ext},
@end defmac
@defmac 3dfx-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{multisample-bit-3dfx}, @code{multisample-3dfx},
@end defmac
@defmac clear-buffer-mask bit...
-Bitfield constructor. The symbolic @var{bit} arguments are replaced
-with their corresponding numeric values and combined with @code{logior}
-at compile-time. The symbolic arguments known to this bitfield
-constructor are:
+Bitfield constructor. The symbolic @var{bit} arguments are replaced with
+their corresponding numeric values and combined with @code{logior} at
+compile-time. The symbolic arguments known to this bitfield constructor
+are:
@code{depth-buffer}, @code{accum-buffer}, @code{stencil-buffer},
@code{color-buffer}, @code{coverage-buffer-bit-nv}.
@end defmac
@defmac client-attrib-mask bit...
-Bitfield constructor. The symbolic @var{bit} arguments are replaced
-with their corresponding numeric values and combined with @code{logior}
-at compile-time. The symbolic arguments known to this bitfield
-constructor are:
+Bitfield constructor. The symbolic @var{bit} arguments are replaced with
+their corresponding numeric values and combined with @code{logior} at
+compile-time. The symbolic arguments known to this bitfield constructor
+are:
@code{client-pixel-store}, @code{client-vertex-array},
@code{client-all-attrib}.
@end defmac
@defmac version-3-0 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{map-read-bit}, @code{map-write-bit},
@end defmac
@defmac arb-map-buffer-range bit...
-Bitfield constructor. The symbolic @var{bit} arguments are replaced
-with their corresponding numeric values and combined with @code{logior}
-at compile-time. The symbolic arguments known to this bitfield
-constructor are:
+Bitfield constructor. The symbolic @var{bit} arguments are replaced with
+their corresponding numeric values and combined with @code{logior} at
+compile-time. The symbolic arguments known to this bitfield constructor
+are:
@code{map-read}, @code{map-write}, @code{map-invalidate-range},
@code{map-invalidate-buffer}, @code{map-flush-explicit},
@end defmac
@defmac ext-map-buffer-range enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{map-read-bit-ext}, @code{map-write-bit-ext},
@end defmac
@defmac version-4-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{context-flag-debug-bit}, @code{num-shading-language-versions},
@end defmac
@defmac khr-debug enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{context-flag-debug-bit}, @code{debug-output-synchronous},
@end defmac
@defmac arb-robustness enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{context-flag-robust-access-bit-arb},
@end defmac
@defmac arb-separate-shader-objects enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-shader-bit}, @code{fragment-shader-bit},
@end defmac
@defmac arb-compute-shader enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compute-shader-bit}, @code{max-compute-shared-memory-size},
@end defmac
@defmac ext-separate-shader-objects enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-shader-bit-ext}, @code{fragment-shader-bit-ext},
@code{all-shader-bits-ext}, @code{program-separable-ext},
-@code{program-pipeline-binding-ext}, @code{active-program-ext}.
+@code{active-program-ext}, @code{program-pipeline-binding-ext},
+@code{active-program-ext}.
@end defmac
@defmac ext-shader-image-load-store enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-array-barrier-bit-ext},
@end defmac
@defmac arb-shader-image-load-store enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-array-barrier-bit},
@end defmac
@defmac arb-shader-storage-buffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{shader-storage-barrier-bit}, @code{shader-storage-buffer},
@end defmac
@defmac intel-map-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{layout-default-intel}, @code{layout-linear-intel},
@end defmac
@defmac boolean enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{false}, @code{true}.
@end defmac
-@defmac primitive-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+@defmac begin-mode enum
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{points}, @code{lines}, @code{line-loop}, @code{line-strip},
@end defmac
@defmac version-3-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{lines-adjacency}, @code{line-strip-adjacency},
@end defmac
@defmac arb-geometry-shader-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{lines-adjacency-arb}, @code{line-strip-adjacency-arb},
@end defmac
@defmac nv-geometry-program-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{lines-adjacency-ext}, @code{line-strip-adjacency-ext},
@end defmac
@defmac arb-tessellation-shader enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{patches}, @code{uniform-block-referenced-by-tess-control-shader},
@end defmac
@defmac nv-gpu-shader-5 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{patches}, @code{int64-nv}, @code{unsigned-int64-nv},
@end defmac
@defmac accum-op enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{accum}, @code{load}, @code{return}, @code{mult}, @code{add}.
@end defmac
@defmac alpha-function enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{never}, @code{less}, @code{equal}, @code{lequal}, @code{greater},
@end defmac
@defmac blending-factor-dest enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{zero}, @code{one}, @code{src-color}, @code{one-minus-src-color},
@end defmac
@defmac blending-factor-src enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{zero}, @code{one}, @code{dst-color}, @code{one-minus-dst-color},
@end defmac
@defmac blend-equation-mode-ext enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{logic-op}, @code{func-add-ext}, @code{min-ext}, @code{max-ext},
@end defmac
@defmac color-material-face enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{front}, @code{back}, @code{front-and-back}.
@end defmac
@defmac color-material-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{ambient}, @code{diffuse}, @code{specular}, @code{emission},
@end defmac
@defmac color-pointer-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{byte}, @code{unsigned-byte}, @code{short}, @code{unsigned-short},
@end defmac
@defmac color-table-parameter-p-name-sgi enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{color-table-scale-sgi}, @code{color-table-bias-sgi}.
@end defmac
@defmac color-table-target-sgi enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{color-table-sgi}, @code{post-convolution-color-table-sgi},
@end defmac
@defmac convolution-border-mode-ext enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{reduce-ext}.
@end defmac
@defmac convolution-parameter-ext enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{convolution-border-mode-ext}, @code{convolution-filter-scale-ext},
@end defmac
@defmac convolution-target-ext enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{convolution-1d-ext}, @code{convolution-2d-ext}.
@end defmac
@defmac cull-face-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{front}, @code{back}, @code{front-and-back}.
@end defmac
@defmac depth-function enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{never}, @code{less}, @code{equal}, @code{lequal}, @code{greater},
@end defmac
@defmac draw-buffer-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{none}, @code{front-left}, @code{front-right}, @code{back-left},
@end defmac
@defmac oes-framebuffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fog}, @code{lighting}, @code{texture-1d}, @code{texture-2d},
@end defmac
@defmac enable-cap enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fog}, @code{lighting}, @code{texture-1d}, @code{texture-2d},
@end defmac
@defmac error-code enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{no-error}, @code{invalid-enum}, @code{invalid-value},
@end defmac
@defmac arb-framebuffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{invalid-framebuffer-operation},
@end defmac
@defmac ext-framebuffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{invalid-framebuffer-operation-ext},
@end defmac
@defmac feedback-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{2d}, @code{3d}, @code{3d-color}, @code{3d-color-texture},
@end defmac
@defmac feed-back-token enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pass-through-token}, @code{point-token}, @code{line-token},
@end defmac
@defmac ffd-mask-sgix bit...
-Bitfield constructor. The symbolic @var{bit} arguments are replaced
-with their corresponding numeric values and combined with @code{logior}
-at compile-time. The symbolic arguments known to this bitfield
-constructor are:
+Bitfield constructor. The symbolic @var{bit} arguments are replaced with
+their corresponding numeric values and combined with @code{logior} at
+compile-time. The symbolic arguments known to this bitfield constructor
+are:
@code{texture-deformation-bit-sgix},
@code{geometry-deformation-bit-sgix}.
@end defmac
@defmac ffd-target-sgix enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{geometry-deformation-sgix}, @code{texture-deformation-sgix}.
@end defmac
@defmac fog-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{linear}, @code{exp}, @code{exp2}, @code{fog-func-sgis}.
@end defmac
@defmac fog-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fog-color}, @code{fog-density}, @code{fog-end}, @code{fog-index},
@end defmac
@defmac fragment-light-model-parameter-sgix enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-light-model-local-viewer-sgix},
@end defmac
@defmac front-face-direction enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{cw}, @code{ccw}.
@end defmac
@defmac get-color-table-parameter-p-name-sgi enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{color-table-scale-sgi}, @code{color-table-bias-sgi},
@end defmac
@defmac get-convolution-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{convolution-border-mode-ext}, @code{convolution-filter-scale-ext},
@end defmac
@defmac get-histogram-parameter-p-name-ext enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{histogram-width-ext}, @code{histogram-format-ext},
@end defmac
@defmac get-map-query enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{coeff}, @code{order}, @code{domain}.
@end defmac
@defmac get-minmax-parameter-p-name-ext enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{minmax-format-ext}, @code{minmax-sink-ext}.
@end defmac
@defmac get-pixel-map enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-map-i-to-i}, @code{pixel-map-s-to-s},
@end defmac
@defmac get-pointerv-p-name enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-array-pointer}, @code{normal-array-pointer},
@end defmac
@defmac get-p-name enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{current-color}, @code{current-index}, @code{current-normal},
@end defmac
-@defmac ext-vertex-weighting enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{modelview0-stack-depth-ext}, @code{modelview0-matrix-ext},
-@code{modelview0-ext}, @code{modelview1-stack-depth-ext},
-@code{modelview1-matrix-ext}, @code{vertex-weighting-ext},
-@code{modelview1-ext}, @code{current-vertex-weight-ext},
-@code{vertex-weight-array-ext}, @code{vertex-weight-array-size-ext},
-@code{vertex-weight-array-type-ext},
-@code{vertex-weight-array-stride-ext},
-@code{vertex-weight-array-pointer-ext}.
-
-@end defmac
-
@defmac qcom-alpha-test enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{alpha-test-qcom}, @code{alpha-test-func-qcom},
@end defmac
@defmac ext-unpack-subimage enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{unpack-row-length}, @code{unpack-skip-rows},
@end defmac
@defmac ext-multiview-draw-buffers enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{draw-buffer-ext}, @code{read-buffer-ext}, @code{draw-buffer-ext},
@end defmac
@defmac nv-read-buffer enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{read-buffer-nv}.
@end defmac
@defmac get-texture-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-mag-filter}, @code{texture-min-filter},
@end defmac
@defmac nv-texture-border-clamp enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-border-color-nv}, @code{clamp-to-border-nv}.
@end defmac
@defmac hint-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{dont-care}, @code{fastest}, @code{nicest}.
@end defmac
@defmac hint-target enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{perspective-correction-hint}, @code{point-smooth-hint},
@end defmac
@defmac histogram-target-ext enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{histogram-ext}, @code{proxy-histogram-ext}.
@end defmac
@defmac index-pointer-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{short}, @code{int}, @code{float}, @code{double}.
@end defmac
@defmac light-env-mode-sgix enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{replace}, @code{modulate}, @code{add}.
@end defmac
@defmac light-env-parameter-sgix enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{light-env-mode-sgix}.
@end defmac
@defmac light-model-color-control enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{single-color}, @code{separate-specular-color}.
@end defmac
@defmac light-model-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{light-model-ambient}, @code{light-model-local-viewer},
@end defmac
@defmac light-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{ambient}, @code{diffuse}, @code{specular}, @code{position},
@end defmac
@defmac list-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compile}, @code{compile-and-execute}.
@end defmac
@defmac data-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{byte}, @code{unsigned-byte}, @code{short}, @code{unsigned-short},
@end defmac
@defmac oes-element-index-uint bit...
-Bitfield constructor. The symbolic @var{bit} arguments are replaced
-with their corresponding numeric values and combined with @code{logior}
-at compile-time. The symbolic arguments known to this bitfield
-constructor are:
+Bitfield constructor. The symbolic @var{bit} arguments are replaced with
+their corresponding numeric values and combined with @code{logior} at
+compile-time. The symbolic arguments known to this bitfield constructor
+are:
.
@end defmac
@defmac oes-texture-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{half-float-oes}.
@end defmac
@defmac ext-vertex-attrib-64-bit enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{double-mat2-ext}, @code{double-mat3-ext}, @code{double-mat4-ext},
@end defmac
@defmac arb-half-float-vertex enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{half-float}.
@end defmac
@defmac arb-half-float-pixel enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{half-float-arb}.
@end defmac
@defmac nv-half-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{half-float-nv}.
@end defmac
@defmac apple-float-pixels enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{half-apple}, @code{rgba-float32-apple}, @code{rgb-float32-apple},
@end defmac
@defmac arb-es2-compatibility enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fixed}, @code{implementation-color-read-type},
@end defmac
@defmac oes-fixed-point enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fixed-oes}.
@end defmac
@defmac nv-vertex-attrib-integer-64-bit enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{int64-nv}, @code{unsigned-int64-nv}.
@end defmac
@defmac list-name-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{byte}, @code{unsigned-byte}, @code{short}, @code{unsigned-short},
@end defmac
@defmac list-parameter-name enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{list-priority-sgix}.
@end defmac
@defmac logic-op enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{clear}, @code{and}, @code{and-reverse}, @code{copy},
@end defmac
@defmac map-target enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{map1-color-4}, @code{map1-index}, @code{map1-normal},
@end defmac
@defmac material-face enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{front}, @code{back}, @code{front-and-back}.
@end defmac
@defmac material-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{emission}, @code{shininess}, @code{ambient-and-diffuse},
@end defmac
@defmac matrix-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{modelview}, @code{projection}, @code{texture}.
@end defmac
@defmac mesh-mode-1 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point}, @code{line}.
@end defmac
@defmac mesh-mode-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point}, @code{line}, @code{fill}.
@end defmac
@defmac minmax-target-ext enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{minmax-ext}.
@end defmac
@defmac normal-pointer-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{byte}, @code{short}, @code{int}, @code{float}, @code{double}.
@end defmac
@defmac pixel-copy-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{color}, @code{depth}, @code{stencil}.
@end defmac
@defmac ext-discard-framebuffer enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{color-ext}, @code{depth-ext}, @code{stencil-ext}.
@end defmac
@defmac pixel-format enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
-@code{red-ext}.
+@code{color-index}, @code{stencil-index}, @code{depth-component},
+@code{red}, @code{green}, @code{blue}, @code{alpha}, @code{rgb},
+@code{rgba}, @code{luminance}, @code{luminance-alpha}, @code{abgr-ext},
+@code{cmyk-ext}, @code{cmyka-ext}, @code{ycrcb-422-sgix},
+@code{ycrcb-444-sgix}.
@end defmac
@defmac oes-depth-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{red-ext}.
@end defmac
@defmac ext-texture-rg enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{red-ext}, @code{rg-ext}, @code{r8-ext}, @code{rg8-ext}.
@end defmac
@defmac pixel-map enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-map-i-to-i}, @code{pixel-map-s-to-s},
@end defmac
@defmac pixel-store-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{unpack-swap-bytes}, @code{unpack-lsb-first},
@end defmac
@defmac pixel-store-resample-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{resample-replicate-sgix}, @code{resample-zero-fill-sgix},
@end defmac
@defmac pixel-store-subsample-rate enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-subsample-4444-sgix}, @code{pixel-subsample-2424-sgix},
@end defmac
@defmac pixel-tex-gen-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
-@code{none}, @code{pixel-tex-gen-alpha-replace-sgix},
+@code{none}, @code{rgb}, @code{rgba}, @code{luminance},
+@code{luminance-alpha}, @code{pixel-tex-gen-alpha-replace-sgix},
@code{pixel-tex-gen-alpha-no-replace-sgix},
@code{pixel-tex-gen-alpha-ms-sgix}, @code{pixel-tex-gen-alpha-ls-sgix}.
@end defmac
@defmac pixel-tex-gen-parameter-name-sgis enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-fragment-rgb-source-sgis},
@end defmac
@defmac pixel-transfer-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{map-color}, @code{map-stencil}, @code{index-shift},
@end defmac
@defmac pixel-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{bitmap}, @code{byte}, @code{unsigned-byte}, @code{short},
@end defmac
@defmac point-parameter-name-sgis enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point-size-min-sgis}, @code{point-size-max-sgis},
@end defmac
@defmac polygon-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point}, @code{line}, @code{fill}.
@end defmac
@defmac read-buffer-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{front-left}, @code{front-right}, @code{back-left},
@end defmac
@defmac rendering-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{render}, @code{feedback}, @code{select}.
@end defmac
@defmac sample-pattern-sgis enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{1pass-sgis}, @code{2pass-0-sgis}, @code{2pass-1-sgis},
@end defmac
@defmac separable-target-ext enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{separable-2d-ext}.
@end defmac
@defmac shading-model enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{flat}, @code{smooth}.
@end defmac
@defmac stencil-function enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{never}, @code{less}, @code{equal}, @code{lequal}, @code{greater},
@end defmac
@defmac stencil-op enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{zero}, @code{keep}, @code{replace}, @code{incr}, @code{decr},
@end defmac
@defmac string-name enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vendor}, @code{renderer}, @code{version}, @code{extensions}.
@end defmac
@defmac tex-coord-pointer-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{short}, @code{int}, @code{float}, @code{double}.
@end defmac
@defmac texture-coord-name enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{s}, @code{t}, @code{r}, @code{q}.
@end defmac
@defmac texture-env-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{modulate}, @code{decal}, @code{blend}, @code{replace-ext},
@end defmac
@defmac texture-env-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-env-mode}, @code{texture-env-color}.
@end defmac
@defmac texture-env-target enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-env}.
@end defmac
@defmac texture-filter-func-sgis enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{filter4-sgis}.
@end defmac
@defmac texture-gen-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{eye-linear}, @code{object-linear}, @code{sphere-map},
@end defmac
@defmac texture-gen-parameter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-gen-mode}, @code{object-plane}, @code{eye-plane},
@end defmac
@defmac oes-texture-cube-map enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-gen-mode}, @code{normal-map-oes},
@end defmac
@defmac texture-mag-filter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{nearest}, @code{linear}, @code{linear-detail-sgis},
@end defmac
@defmac texture-min-filter enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{nearest}, @code{linear}, @code{nearest-mipmap-nearest},
@end defmac
@defmac texture-parameter-name enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-mag-filter}, @code{texture-min-filter},
@end defmac
@defmac texture-target enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-1d}, @code{texture-2d}, @code{proxy-texture-1d},
@end defmac
@defmac texture-wrap-mode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{clamp}, @code{repeat}, @code{clamp-to-border-sgis},
@end defmac
@defmac pixel-internal-format enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{r3-g3-b2}, @code{alpha4}, @code{alpha8}, @code{alpha12},
@end defmac
@defmac oes-rgb-8-rgba-8 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgb8}, @code{rgba8}.
@end defmac
@defmac interleaved-array-format enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{v2f}, @code{v3f}, @code{c4ub-v2f}, @code{c4ub-v3f},
@end defmac
@defmac vertex-pointer-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{short}, @code{int}, @code{float}, @code{double}.
@end defmac
@defmac clip-plane-name enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{clip-plane0}, @code{clip-plane1}, @code{clip-plane2},
@end defmac
@defmac light-name enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{light0}, @code{light1}, @code{light2}, @code{light3},
@end defmac
@defmac ext-abgr enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{abgr-ext}.
@end defmac
@defmac version-1-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{constant-color}, @code{one-minus-constant-color},
@end defmac
@defmac ext-blend-color enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{constant-color-ext}, @code{one-minus-constant-color-ext},
@end defmac
@defmac ext-blend-minmax enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{func-add}, @code{func-add-ext}, @code{min}, @code{min-ext},
@end defmac
@defmac version-2-0 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{blend-equation-rgb}, @code{vertex-attrib-array-enabled},
@end defmac
@defmac ext-blend-equation-separate enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{blend-equation-rgb-ext}, @code{blend-equation-alpha-ext}.
@end defmac
@defmac oes-blend-equation-separate enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{blend-equation-rgb-oes}, @code{blend-equation-alpha-oes}.
@end defmac
@defmac ext-blend-subtract enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{func-subtract}, @code{func-subtract-ext},
@end defmac
@defmac oes-blend-subtract enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{func-add-oes}, @code{blend-equation-oes},
@end defmac
@defmac ext-cmyka enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{cmyk-ext}, @code{cmyka-ext}, @code{pack-cmyk-hint-ext},
@end defmac
@defmac ext-convolution enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{convolution-1d-ext}, @code{convolution-2d-ext},
@end defmac
@defmac ext-histogram enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{histogram-ext}, @code{proxy-histogram-ext},
@end defmac
@defmac ext-packed-pixels enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{unsigned-byte-3-3-2-ext}, @code{unsigned-short-4-4-4-4-ext},
@end defmac
@defmac ext-texture-type-2-10-10-10-rev enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{polygon-offset-ext}, @code{polygon-offset-factor-ext},
@end defmac
@defmac ext-polygon-offset enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{polygon-offset-ext}, @code{polygon-offset-factor-ext},
@end defmac
@defmac ext-rescale-normal enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rescale-normal-ext}.
@end defmac
@defmac ext-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{alpha4-ext}, @code{alpha8-ext}, @code{alpha12-ext},
@end defmac
-@defmac arm-rgba-8 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{rgba8-oes}.
-
-@end defmac
-
@defmac ext-texture-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-priority-ext}, @code{texture-resident-ext},
@end defmac
@defmac ext-texture-3d enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pack-skip-images-ext}, @code{pack-image-height-ext},
@end defmac
@defmac oes-texture-3d enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-3d-binding-oes}, @code{texture-3d-oes},
@end defmac
@defmac ext-vertex-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-array-ext}, @code{normal-array-ext},
@end defmac
@defmac sgix-interlace enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{interlace-sgix}.
@end defmac
@defmac sgis-detail-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{detail-texture-2d-sgis}, @code{detail-texture-2d-binding-sgis},
@end defmac
@defmac sgis-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{multisample-sgis}, @code{sample-alpha-to-mask-sgis},
@end defmac
+@defmac nv-multisample-coverage enum
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
+known to this enumerated value form are:
+
+@code{coverage-samples-nv}, @code{color-samples-nv}.
+
+@end defmac
+
@defmac sgis-sharpen-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{linear-sharpen-sgis}, @code{linear-sharpen-alpha-sgis},
@end defmac
@defmac sgi-color-matrix enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{color-matrix-sgi}, @code{color-matrix-stack-depth-sgi},
@end defmac
@defmac sgi-texture-color-table enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-color-table-sgi}, @code{proxy-texture-color-table-sgi}.
@end defmac
@defmac sgix-texture-add-env enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-env-bias-sgix}.
@end defmac
-@defmac arb-shadow-ambient enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{texture-compare-fail-value-arb}.
-
-@end defmac
-
@defmac sgix-shadow-ambient enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{shadow-ambient-sgix}.
@end defmac
@defmac version-1-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{blend-dst-rgb}, @code{blend-src-rgb}, @code{blend-dst-alpha},
@end defmac
@defmac ext-blend-func-separate enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{blend-dst-rgb-ext}, @code{blend-src-rgb-ext},
@end defmac
@defmac oes-blend-func-separate enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{blend-dst-rgb-oes}, @code{blend-src-rgb-oes},
@end defmac
@defmac ext-422-pixels enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{422-ext}, @code{422-rev-ext}, @code{422-average-ext},
@end defmac
@defmac sgi-color-table enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{color-table-sgi}, @code{post-convolution-color-table-sgi},
@end defmac
@defmac arb-vertex-array-bgra enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{bgr-ext}, @code{bgra-ext}.
@end defmac
@defmac ext-bgra enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{bgr-ext}, @code{bgra-ext}.
@end defmac
-@defmac ext-paletted-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{color-index1-ext}, @code{color-index2-ext},
-@code{color-index4-ext}, @code{color-index8-ext},
-@code{color-index12-ext}, @code{color-index16-ext},
-@code{texture-index-size-ext}.
-
-@end defmac
-
-@defmac ext-draw-range-elements enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{max-elements-vertices-ext}, @code{max-elements-indices-ext}.
-
-@end defmac
-
-@defmac win-phong-shading enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{phong-win}, @code{phong-hint-win}.
-
-@end defmac
-
-@defmac win-specular-fog enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{fog-specular-texture-win}.
-
-@end defmac
-
-@defmac ext-clip-volume-hint enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{clip-volume-clipping-hint-ext}.
-
-@end defmac
-
@defmac sgis-texture-select enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{dual-alpha4-sgis}, @code{dual-alpha8-sgis},
@end defmac
@defmac arb-point-parameters enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point-size-min-arb}, @code{point-size-max-arb},
@end defmac
@defmac ext-point-parameters enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point-size-min-ext}, @code{point-size-max-ext},
@end defmac
@defmac sgis-point-parameters enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point-size-min-sgis}, @code{point-size-max-sgis},
@end defmac
@defmac sgis-fog-function enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fog-func-sgis}, @code{fog-func-points-sgis},
@end defmac
@defmac arb-texture-border-clamp enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{clamp-to-border-arb}.
@end defmac
@defmac sgis-texture-border-clamp enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{clamp-to-border-sgis}.
@end defmac
@defmac sgix-texture-multi-buffer enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-multi-buffer-hint-sgix}.
@end defmac
@defmac sgis-texture-edge-clamp enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{clamp-to-edge-sgis}.
@end defmac
@defmac sgis-texture-4d enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pack-skip-volumes-sgis}, @code{pack-image-depth-sgis},
@end defmac
@defmac sgix-pixel-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-tex-gen-sgix}, @code{pixel-tex-gen-mode-sgix}.
@end defmac
@defmac sgis-texture-lod enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-min-lod-sgis}, @code{texture-max-lod-sgis},
@end defmac
@defmac sgix-pixel-tiles enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-tile-best-alignment-sgix},
@end defmac
@defmac sgis-texture-filter-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{filter4-sgis}, @code{texture-filter4-size-sgis}.
@end defmac
@defmac sgix-sprite enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sprite-sgix}, @code{sprite-mode-sgix}, @code{sprite-axis-sgix},
@end defmac
@defmac hp-convolution-border-modes enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{ignore-border-hp}, @code{constant-border-hp},
@end defmac
-@defmac hp-image-transform enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{image-scale-x-hp}, @code{image-scale-y-hp},
-@code{image-translate-x-hp}, @code{image-translate-y-hp},
-@code{image-rotate-angle-hp}, @code{image-rotate-origin-x-hp},
-@code{image-rotate-origin-y-hp}, @code{image-mag-filter-hp},
-@code{image-min-filter-hp}, @code{image-cubic-weight-hp},
-@code{cubic-hp}, @code{average-hp}, @code{image-transform-2d-hp},
-@code{post-image-transform-color-table-hp},
-@code{proxy-post-image-transform-color-table-hp}.
-
-@end defmac
-
-@defmac hp-occlusion-test enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{occlusion-test-hp}, @code{occlusion-test-result-hp}.
-
-@end defmac
-
-@defmac hp-texture-lighting enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{texture-lighting-mode-hp}, @code{texture-post-specular-hp},
-@code{texture-pre-specular-hp}.
-
-@end defmac
-
@defmac sgix-clipmap enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{linear-clipmap-linear-sgix}, @code{texture-clipmap-center-sgix},
@end defmac
@defmac sgix-texture-scale-bias enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{post-texture-filter-bias-sgix},
@end defmac
@defmac sgix-reference-plane enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{reference-plane-sgix}, @code{reference-plane-equation-sgix}.
@end defmac
@defmac sgix-ir-instrument-1 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{ir-instrument1-sgix}.
@end defmac
@defmac sgix-instruments enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{instrument-buffer-pointer-sgix},
@end defmac
@defmac sgix-list-priority enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{list-priority-sgix}.
@end defmac
@defmac sgix-calligraphic-fragment enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{calligraphic-fragment-sgix}.
@end defmac
@defmac sgix-impact-pixel-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-tex-gen-q-ceiling-sgix}, @code{pixel-tex-gen-q-round-sgix},
@end defmac
@defmac sgix-framezoom enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{framezoom-sgix}, @code{framezoom-factor-sgix},
@end defmac
@defmac sgix-texture-lod-bias enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-lod-bias-s-sgix}, @code{texture-lod-bias-t-sgix},
@end defmac
@defmac sgis-generate-mipmap enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{generate-mipmap-sgis}, @code{generate-mipmap-hint-sgis}.
@end defmac
@defmac sgix-polynomial-ffd enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{geometry-deformation-sgix}, @code{texture-deformation-sgix},
@end defmac
@defmac sgix-fog-offset enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fog-offset-sgix}, @code{fog-offset-value-sgix}.
@end defmac
@defmac sgix-shadow enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-compare-sgix}, @code{texture-compare-operator-sgix},
@end defmac
@defmac arb-depth-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-component16-arb}, @code{depth-component24-arb},
@end defmac
@defmac sgix-depth-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-component16-sgix}, @code{depth-component24-sgix},
@end defmac
@defmac oes-depth-24 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-component24-oes}.
@end defmac
@defmac oes-depth-32 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-component32-oes}.
@end defmac
@defmac ext-compiled-vertex-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{array-element-lock-first-ext},
@end defmac
@defmac ext-cull-vertex enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{cull-vertex-ext}, @code{cull-vertex-eye-position-ext},
@end defmac
@defmac ext-index-array-formats enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{iui-v2f-ext}, @code{iui-v3f-ext}, @code{iui-n3f-v2f-ext},
@end defmac
@defmac ext-index-func enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{index-test-ext}, @code{index-test-func-ext},
@end defmac
@defmac ext-index-material enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{index-material-ext}, @code{index-material-parameter-ext},
@end defmac
@defmac sgix-ycrcb enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{ycrcb-422-sgix}, @code{ycrcb-444-sgix}.
@end defmac
@defmac sunx-general-triangle-list enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{restart-sun}, @code{replace-middle-sun},
@end defmac
@defmac sunx-constant-data enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{unpack-constant-data-sunx}, @code{texture-constant-data-sunx}.
@end defmac
@defmac sun-global-alpha enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{global-alpha-sun}, @code{global-alpha-factor-sun}.
@end defmac
@defmac sgis-texture-color-mask enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-color-writemask-sgis}.
@end defmac
@defmac sgis-point-line-texgen enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{eye-distance-to-point-sgis}, @code{object-distance-to-point-sgis},
@end defmac
@defmac ext-separate-specular-color enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{light-model-color-control-ext}, @code{single-color-ext},
@end defmac
@defmac ext-shared-texture-palette enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{shared-texture-palette-ext}.
@end defmac
@defmac ati-text-fragment-shader enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{text-fragment-shader-ati}.
@end defmac
@defmac ext-color-buffer-half-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{framebuffer-attachment-component-type-ext}, @code{r16f-ext},
@end defmac
@defmac oes-surfaceless-context enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{framebuffer-undefined-oes}.
@end defmac
@defmac arb-texture-rg enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rg}, @code{rg-integer}, @code{r8}, @code{r16}, @code{rg8},
@end defmac
@defmac arb-cl-event enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sync-cl-event-arb}, @code{sync-cl-event-complete-arb}.
@end defmac
@defmac arb-debug-output enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{debug-output-synchronous-arb},
@end defmac
@defmac arb-get-program-binary enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{program-binary-retrievable-hint}, @code{program-binary-length},
@end defmac
@defmac arb-viewport-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-viewports}, @code{viewport-subpixel-bits},
@end defmac
@defmac arb-explicit-uniform-location enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-uniform-locations}.
@end defmac
@defmac arb-internalformat-query-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{internalformat-supported}, @code{internalformat-preferred},
@end defmac
@defmac arb-vertex-attrib-binding enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-binding}, @code{vertex-attrib-relative-offset},
@end defmac
@defmac arb-texture-view enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-view-min-level}, @code{texture-view-num-levels},
@end defmac
@defmac sgix-depth-pass-instrument enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-pass-instrument-sgix},
@end defmac
@defmac sgix-fragments-instrument enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragments-instrument-sgix},
@end defmac
@defmac sgix-convolution-accuracy enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{convolution-hint-sgix}.
@end defmac
@defmac sgix-ycrcba enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{ycrcb-sgix}, @code{ycrcba-sgix}.
@end defmac
@defmac sgix-slim enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{unpack-compressed-size-sgix},
@end defmac
@defmac sgix-blend-alpha-minmax enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{alpha-min-sgix}, @code{alpha-max-sgix}.
@end defmac
@defmac sgix-scalebias-hint enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{scalebias-hint-sgix}.
@end defmac
@defmac sgix-async enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{async-marker-sgix}.
@end defmac
@defmac sgix-async-histogram enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{async-histogram-sgix}, @code{max-async-histogram-sgix}.
@end defmac
@defmac ext-pixel-transform enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-transform-2d-ext}, @code{pixel-mag-filter-ext},
@end defmac
@defmac ext-light-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-material-ext}, @code{fragment-normal-ext},
@end defmac
@defmac sgis-pixel-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-texture-sgis}, @code{pixel-fragment-rgb-source-sgis},
@end defmac
@defmac sgix-line-quality-hint enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{line-quality-hint-sgix}.
@end defmac
@defmac sgix-async-pixel enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{async-tex-image-sgix}, @code{async-draw-pixels-sgix},
@end defmac
@defmac sgix-texture-coordinate-clamp enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-max-clamp-s-sgix}, @code{texture-max-clamp-t-sgix},
-@code{texture-max-clamp-r-sgix}.
+@code{texture-max-clamp-r-sgix}, @code{fog-factor-to-alpha-sgix}.
@end defmac
@defmac arb-texture-mirrored-repeat enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{mirrored-repeat-arb}.
@end defmac
@defmac ibm-texture-mirrored-repeat enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{mirrored-repeat-ibm}.
@end defmac
@defmac oes-texture-mirrored-repeat enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{mirrored-repeat-oes}.
@end defmac
@defmac s3-s-3-tc enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgb-s3tc}, @code{rgb4-s3tc}, @code{rgba-s3tc}, @code{rgba4-s3tc},
@end defmac
@defmac sgix-vertex-preclip enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-preclip-sgix}, @code{vertex-preclip-hint-sgix}.
@end defmac
@defmac ext-texture-compression-s-3-tc enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-rgb-s3tc-dxt1-ext},
@end defmac
@defmac angle-texture-compression-dxt-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-rgba-s3tc-dxt3-angle}.
@end defmac
@defmac angle-texture-compression-dxt-5 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-rgba-s3tc-dxt5-angle}.
@end defmac
@defmac intel-parallel-arrays enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{parallel-arrays-intel},
@end defmac
@defmac sgix-fragment-lighting enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-lighting-sgix}, @code{fragment-color-material-sgix},
@end defmac
@defmac sgix-resample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pack-resample-sgix}, @code{unpack-resample-sgix},
@end defmac
-@defmac ext-coordinate-frame enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{tangent-array-ext}, @code{binormal-array-ext},
-@code{current-tangent-ext}, @code{current-binormal-ext},
-@code{tangent-array-type-ext}, @code{tangent-array-stride-ext},
-@code{binormal-array-type-ext}, @code{binormal-array-stride-ext},
-@code{tangent-array-pointer-ext}, @code{binormal-array-pointer-ext},
-@code{map1-tangent-ext}, @code{map2-tangent-ext},
-@code{map1-binormal-ext}, @code{map2-binormal-ext}.
-
-@end defmac
-
@defmac version-1-5 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fog-coord-src}, @code{fog-coord}, @code{current-fog-coord},
@end defmac
@defmac ext-fog-coord enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fog-coordinate-source-ext}, @code{fog-coordinate-ext},
@end defmac
@defmac ext-secondary-color enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{color-sum-ext}, @code{current-secondary-color-ext},
@end defmac
@defmac arb-vertex-program enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{color-sum-arb}, @code{vertex-program-arb},
@end defmac
@defmac version-2-1 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{current-raster-secondary-color}, @code{pixel-pack-buffer},
@end defmac
+@defmac sgix-icc-texture enum
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
+known to this enumerated value form are:
+
+@code{smooth-point-size-range}, @code{smooth-point-size-granularity},
+@code{smooth-line-width-range}, @code{smooth-line-width-granularity},
+@code{aliased-point-size-range}, @code{aliased-line-width-range}.
+
+@end defmac
+
@defmac rend-screen-coordinates enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{screen-coordinates-rend}, @code{inverted-screen-w-rend}.
@end defmac
@defmac arb-multitexture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture0-arb}, @code{texture1-arb}, @code{texture2-arb},
@end defmac
@defmac oes-texture-env-crossbar enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture0}, @code{texture1}, @code{texture2}, @code{texture3},
@end defmac
@defmac arb-transpose-matrix enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{transpose-modelview-matrix-arb},
@end defmac
@defmac arb-texture-env-combine enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{subtract-arb}, @code{combine-arb}, @code{combine-rgb-arb},
-@code{combine-alpha-arb}, @code{rgb-scale-arb}, @code{add-signed-arb},
-@code{interpolate-arb}, @code{constant-arb}, @code{primary-color-arb},
-@code{previous-arb}, @code{source0-rgb-arb}, @code{source1-rgb-arb},
-@code{source2-rgb-arb}, @code{source0-alpha-arb},
-@code{source1-alpha-arb}, @code{source2-alpha-arb},
-@code{operand0-rgb-arb}, @code{operand1-rgb-arb},
-@code{operand2-rgb-arb}, @code{operand0-alpha-arb},
-@code{operand1-alpha-arb}, @code{operand2-alpha-arb},
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
+known to this enumerated value form are:
+
@code{subtract-arb}.
@end defmac
@defmac arb-texture-compression enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-alpha-arb}, @code{compressed-luminance-arb},
@end defmac
@defmac nv-fence enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{all-completed-nv}, @code{fence-status-nv},
@end defmac
@defmac version-3-1 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-rectangle}, @code{texture-binding-rectangle},
@end defmac
@defmac arb-texture-rectangle enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-rectangle-arb}, @code{texture-binding-rectangle-arb},
@end defmac
@defmac nv-texture-rectangle enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-rectangle-nv}, @code{texture-binding-rectangle-nv},
@end defmac
@defmac ext-packed-depth-stencil enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-stencil-ext}, @code{unsigned-int-24-8-ext},
@end defmac
@defmac nv-packed-depth-stencil enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-stencil-nv}, @code{unsigned-int-24-8-nv}.
@end defmac
@defmac oes-packed-depth-stencil enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-stencil-oes}, @code{unsigned-int-24-8-oes},
@end defmac
@defmac ext-texture-lod-bias enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-texture-lod-bias-ext}, @code{texture-filter-control-ext},
@end defmac
@defmac ext-texture-filter-anisotropic enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-max-anisotropy-ext},
@end defmac
-@defmac nv-texture-env-combine-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+@defmac ext-vertex-weighting enum
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
-@code{combine4-nv}, @code{source3-rgb-nv}, @code{source3-alpha-nv},
-@code{operand3-rgb-nv}, @code{operand3-alpha-nv}.
+@code{modelview1-stack-depth-ext}, @code{modelview-matrix1-ext},
+@code{vertex-weighting-ext}, @code{modelview1-ext},
+@code{current-vertex-weight-ext}, @code{vertex-weight-array-ext},
+@code{vertex-weight-array-size-ext},
+@code{vertex-weight-array-type-ext},
+@code{vertex-weight-array-stride-ext},
+@code{vertex-weight-array-pointer-ext}.
@end defmac
@defmac nv-light-max-exponent enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-shininess-nv}, @code{max-spot-exponent-nv}.
@end defmac
@defmac ext-stencil-wrap enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{incr-wrap-ext}, @code{decr-wrap-ext}.
@end defmac
@defmac oes-stencil-wrap enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{incr-wrap-oes}, @code{decr-wrap-oes}.
@end defmac
@defmac ext-texture-cube-map enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{normal-map-ext}, @code{reflection-map-ext},
@end defmac
@defmac nv-texgen-reflection enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
-@code{normal-map-nv}, @code{reflection-map-nv}.
+@code{normal-map}, @code{reflection-map}.
@end defmac
@defmac arb-texture-cube-map enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{normal-map-arb}, @code{reflection-map-arb},
@end defmac
@defmac nv-vertex-array-range enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-array-range-nv}, @code{vertex-array-range-length-nv},
@end defmac
@defmac apple-vertex-array-range enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-array-range-apple}, @code{vertex-array-range-length-apple},
@end defmac
@defmac nv-register-combiners enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{register-combiners-nv}, @code{variable-a-nv},
@code{unsigned-invert-nv}, @code{expand-normal-nv},
@code{expand-negate-nv}, @code{half-bias-normal-nv},
@code{half-bias-negate-nv}, @code{signed-identity-nv},
-@code{signed-negate-nv}, @code{scale-by-two-nv},
+@code{unsigned-negate-nv}, @code{scale-by-two-nv},
@code{scale-by-four-nv}, @code{scale-by-one-half-nv},
@code{bias-by-negative-one-half-nv}, @code{combiner-input-nv},
@code{combiner-mapping-nv}, @code{combiner-component-usage-nv},
@end defmac
@defmac nv-register-combiners-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{per-stage-constants-nv}.
@end defmac
@defmac nv-primitive-restart enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{primitive-restart-nv}, @code{primitive-restart-index-nv}.
@end defmac
@defmac nv-fog-distance enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
-@code{fog-distance-mode-nv}, @code{eye-radial-nv},
+@code{fog-gen-mode-nv}, @code{eye-radial-nv},
@code{eye-plane-absolute-nv}.
@end defmac
@defmac nv-texgen-emboss enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{emboss-light-nv}, @code{emboss-constant-nv}, @code{emboss-map-nv}.
@end defmac
@defmac ingr-color-clamp enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{red-min-clamp-ingr}, @code{green-min-clamp-ingr},
@end defmac
@defmac ingr-interlace-read enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{interlace-read-ingr}.
@end defmac
@defmac ext-texture-env-combine enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{combine-ext}, @code{combine-rgb-ext}, @code{combine-alpha-ext},
@end defmac
+@defmac nv-texture-env-combine-4 enum
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
+known to this enumerated value form are:
+
+@code{combine4-nv}, @code{source3-rgb-nv}, @code{source3-alpha-nv},
+@code{operand3-rgb-nv}, @code{operand3-alpha-nv}.
+
+@end defmac
+
@defmac sgix-subsample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pack-subsample-rate-sgix}, @code{unpack-subsample-rate-sgix},
@end defmac
@defmac ext-texture-perturb-normal enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{perturb-ext}, @code{texture-normal-ext}.
@end defmac
@defmac apple-specular-vector enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{light-model-specular-vector-apple}.
@end defmac
@defmac apple-transform-hint enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{transform-hint-apple}.
@end defmac
@defmac apple-client-storage enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{unpack-client-storage-apple}.
@end defmac
@defmac apple-object-purgeable enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{buffer-object-apple}, @code{released-apple},
@end defmac
@defmac arb-vertex-array-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-array-binding}.
@end defmac
@defmac apple-vertex-array-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-array-binding-apple}.
@end defmac
@defmac apple-texture-range enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-range-length-apple}, @code{texture-range-pointer-apple},
@end defmac
@defmac apple-ycbcr-422 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{ycbcr-422-apple}, @code{unsigned-short-8-8-apple},
@end defmac
@defmac mesa-ycbcr-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{unsigned-short-8-8-mesa}, @code{unsigned-short-8-8-rev-mesa},
@end defmac
@defmac sun-slice-accum enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{slice-accum-sun}.
@end defmac
@defmac sun-mesh-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{quad-mesh-sun}, @code{triangle-mesh-sun}.
@end defmac
@defmac nv-vertex-program enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-program-nv}, @code{vertex-state-program-nv},
@end defmac
@defmac arb-depth-clamp enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-clamp}.
@end defmac
@defmac nv-depth-clamp enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-clamp-nv}.
@end defmac
@defmac arb-fragment-program enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-program-arb}, @code{vertex-attrib-array-enabled-arb},
@end defmac
@defmac arb-vertex-blend enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-vertex-units-arb}, @code{active-vertex-units-arb},
@end defmac
@defmac oes-matrix-palette enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-vertex-units-oes}, @code{weight-array-oes},
@end defmac
@defmac arb-texture-env-dot-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{dot3-rgb-arb}, @code{dot3-rgba-arb}.
@end defmac
@defmac img-texture-env-enhanced-fixed-function enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{dot3-rgba-img}, @code{modulate-color-img},
@end defmac
@defmac 3dfx-texture-compression-fxt1 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-rgb-fxt1-3dfx}, @code{compressed-rgba-fxt1-3dfx}.
@end defmac
@defmac nv-evaluators enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{eval-2d-nv}, @code{eval-triangular-2d-nv},
@code{map-tessellation-nv}, @code{map-attrib-u-order-nv},
@code{map-attrib-v-order-nv}, @code{eval-fractional-tessellation-nv},
-@code{eval-vertex-attrib0-nv}, @code{eval-vertex-attrib1-nv},
-@code{eval-vertex-attrib2-nv}, @code{eval-vertex-attrib3-nv},
-@code{eval-vertex-attrib4-nv}, @code{eval-vertex-attrib5-nv},
-@code{eval-vertex-attrib6-nv}, @code{eval-vertex-attrib7-nv},
-@code{eval-vertex-attrib8-nv}, @code{eval-vertex-attrib9-nv},
-@code{eval-vertex-attrib10-nv}, @code{eval-vertex-attrib11-nv},
-@code{eval-vertex-attrib12-nv}, @code{eval-vertex-attrib13-nv},
-@code{eval-vertex-attrib14-nv}, @code{eval-vertex-attrib15-nv},
+@code{eval-vertex-atrrib0-nv}, @code{eval-vertex-atrrib1-nv},
+@code{eval-vertex-atrrib2-nv}, @code{eval-vertex-atrrib3-nv},
+@code{eval-vertex-atrrib4-nv}, @code{eval-vertex-atrrib5-nv},
+@code{eval-vertex-atrrib6-nv}, @code{eval-vertex-atrrib7-nv},
+@code{eval-vertex-atrrib8-nv}, @code{eval-vertex-atrrib9-nv},
+@code{eval-vertex-atrrib10-nv}, @code{eval-vertex-atrrib11-nv},
+@code{eval-vertex-atrrib12-nv}, @code{eval-vertex-atrrib13-nv},
+@code{eval-vertex-atrrib14-nv}, @code{eval-vertex-atrrib15-nv},
@code{max-map-tessellation-nv}, @code{max-rational-eval-order-nv}.
@end defmac
@defmac nv-tessellation-program-5 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-program-patch-attribs-nv}, @code{tess-control-program-nv},
@end defmac
@defmac nv-texture-shader enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{offset-texture-rectangle-nv},
@code{dsdt-mag-intensity-nv}, @code{shader-consistent-nv},
@code{texture-shader-nv}, @code{shader-operation-nv},
@code{cull-modes-nv}, @code{offset-texture-matrix-nv},
-@code{offset-texture-2d-matrix-nv}, @code{offset-texture-scale-nv},
-@code{offset-texture-2d-scale-nv}, @code{offset-texture-bias-nv},
+@code{offset-texture-scale-nv}, @code{offset-texture-bias-nv},
+@code{offset-texture-2d-matrix-nv}, @code{offset-texture-2d-scale-nv},
@code{offset-texture-2d-bias-nv}, @code{previous-texture-input-nv},
@code{const-eye-nv}, @code{pass-through-nv}, @code{cull-fragment-nv},
@code{offset-texture-2d-nv}, @code{dependent-ar-texture-2d-nv},
@end defmac
@defmac nv-vdpau-interop enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{surface-state-nv}, @code{surface-registered-nv},
@end defmac
@defmac nv-texture-shader-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{dot-product-texture-3d-nv}.
@end defmac
@defmac ext-texture-env-dot-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{dot3-rgb-ext}, @code{dot3-rgba-ext}.
@end defmac
@defmac amd-program-binary-z400 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{z400-binary-amd}.
@end defmac
@defmac oes-get-program-binary enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{program-binary-length-oes}, @code{num-program-binary-formats-oes},
@end defmac
@defmac ati-texture-mirror-once enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{mirror-clamp-ati}, @code{mirror-clamp-to-edge-ati}.
@end defmac
@defmac ext-texture-mirror-clamp enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{mirror-clamp-ext}, @code{mirror-clamp-to-edge-ext},
@end defmac
@defmac ati-texture-env-combine-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{modulate-add-ati}, @code{modulate-signed-add-ati},
@end defmac
@defmac amd-stencil-operation-extended enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{set-amd}, @code{replace-value-amd}, @code{stencil-op-value-amd},
@end defmac
@defmac mesa-packed-depth-stencil enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-stencil-mesa}, @code{unsigned-int-24-8-mesa},
@end defmac
@defmac mesa-trace enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{trace-all-bits-mesa}, @code{trace-operations-bit-mesa},
@end defmac
@defmac mesa-pack-invert enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pack-invert-mesa}.
@end defmac
@defmac mesax-texture-stack enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-1d-stack-mesax}, @code{texture-2d-stack-mesax},
@end defmac
@defmac mesa-shader-debug enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{debug-object-mesa}, @code{debug-print-mesa},
@end defmac
@defmac ati-vertex-array-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{static-ati}, @code{dynamic-ati}, @code{preserve-ati},
@end defmac
@defmac arb-vertex-buffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{buffer-size-arb}, @code{buffer-usage-arb},
@end defmac
@defmac ati-element-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{element-array-ati}, @code{element-array-type-ati},
@end defmac
@defmac ati-vertex-streams enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-vertex-streams-ati}, @code{vertex-stream0-ati},
@end defmac
@defmac ati-envmap-bumpmap enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{bump-rot-matrix-ati}, @code{bump-rot-matrix-size-ati},
@end defmac
@defmac ext-vertex-shader enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-shader-ext}, @code{vertex-shader-binding-ext},
@end defmac
@defmac amd-compressed-atc-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{atc-rgba-interpolated-alpha-amd}, @code{atc-rgb-amd},
@end defmac
@defmac ati-pn-triangles enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pn-triangles-ati}, @code{max-pn-triangles-tesselation-level-ati},
@end defmac
@defmac amd-compressed-3dc-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{3dc-x-amd}, @code{3dc-xy-amd}.
@end defmac
@defmac ati-meminfo enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vbo-free-memory-ati}, @code{texture-free-memory-ati},
@end defmac
@defmac ati-separate-stencil enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{stencil-back-func-ati}, @code{stencil-back-pass-depth-fail-ati},
@end defmac
@defmac arb-texture-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgba32f-arb}, @code{rgb32f-arb}, @code{alpha32f-arb},
@end defmac
@defmac ati-texture-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgba-float32-ati}, @code{rgb-float32-ati},
@end defmac
@defmac arb-color-buffer-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgba-float-mode-arb}, @code{clamp-vertex-color-arb},
@end defmac
@defmac ati-pixel-format-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
-@code{rgba-float-mode-ati}, @code{color-clear-unclamped-value-ati}.
+@code{type-rgba-float-ati}, @code{color-clear-unclamped-value-ati}.
@end defmac
@defmac qcom-writeonly-rendering enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{writeonly-rendering-qcom}.
@end defmac
@defmac arb-draw-buffers enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-draw-buffers-arb}, @code{draw-buffer0-arb},
@end defmac
@defmac ati-draw-buffers enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-draw-buffers-ati}, @code{draw-buffer0-ati},
@end defmac
@defmac nv-draw-buffers enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-draw-buffers-nv}, @code{draw-buffer0-nv},
@end defmac
@defmac amd-sample-positions enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{subsample-distance-amd}.
@end defmac
@defmac arb-matrix-palette enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{matrix-palette-arb}, @code{max-matrix-palette-stack-depth-arb},
@end defmac
@defmac arb-shadow enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-compare-mode-arb}, @code{texture-compare-func-arb},
@end defmac
@defmac ext-shadow-samplers enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-compare-mode-ext}, @code{texture-compare-func-ext},
@end defmac
@defmac ext-texture-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compare-ref-depth-to-texture-ext},
@end defmac
@defmac arb-seamless-cube-map enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-cube-map-seamless}.
@end defmac
@defmac nv-texture-shader-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{offset-projective-texture-2d-nv},
@end defmac
@defmac arb-point-sprite enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point-sprite-arb}, @code{coord-replace-arb}.
@end defmac
@defmac nv-point-sprite enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point-sprite-nv}, @code{coord-replace-nv},
@end defmac
@defmac oes-point-sprite enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point-sprite-arb}, @code{coord-replace-arb}.
@end defmac
@defmac arb-occlusion-query enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{query-counter-bits-arb}, @code{current-query-arb},
@end defmac
@defmac nv-occlusion-query enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-counter-bits-nv}, @code{current-occlusion-query-id-nv},
@end defmac
@defmac ext-occlusion-query-boolean enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{current-query-ext}, @code{query-result-ext},
@end defmac
@defmac nv-fragment-program enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-fragment-program-local-parameters-nv},
@end defmac
@defmac nv-copy-depth-to-color enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-stencil-to-rgba-nv}, @code{depth-stencil-to-bgra-nv}.
@end defmac
@defmac nv-pixel-data-range enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{write-pixel-data-range-nv}, @code{read-pixel-data-range-nv},
@end defmac
@defmac arb-gpu-shader-5 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{geometry-shader-invocations},
@end defmac
@defmac nv-float-buffer enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{float-r-nv}, @code{float-rg-nv}, @code{float-rgb-nv},
@end defmac
@defmac nv-texture-expand-normal enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-unsigned-remap-mode-nv}.
@end defmac
@defmac ext-depth-bounds-test enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-bounds-test-ext}, @code{depth-bounds-ext}.
@end defmac
@defmac oes-mapbuffer enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{write-only-oes}, @code{buffer-access-oes},
@end defmac
@defmac nv-shader-buffer-store enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{read-write}, @code{write-only},
@end defmac
@defmac arb-timer-query enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{time-elapsed}, @code{timestamp}.
@end defmac
@defmac ext-timer-query enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{time-elapsed-ext}.
@end defmac
@defmac arb-pixel-buffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-pack-buffer-arb}, @code{pixel-unpack-buffer-arb},
@end defmac
@defmac ext-pixel-buffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pixel-pack-buffer-ext}, @code{pixel-unpack-buffer-ext},
@end defmac
@defmac nv-s-rgb-formats enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{etc1-srgb8-nv}, @code{srgb8-nv}, @code{sluminance-alpha-nv},
@end defmac
@defmac ext-stencil-clear-tag enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{stencil-tag-bits-ext}, @code{stencil-clear-tag-value-ext}.
@end defmac
@defmac nv-vertex-program-2-option enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-program-exec-instructions-nv},
@end defmac
@defmac nv-fragment-program-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-program-exec-instructions-nv},
@end defmac
@defmac arb-blend-func-extended enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{src1-color}, @code{one-minus-src1-color},
@end defmac
@defmac nv-vertex-program-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-array-integer-nv}.
@end defmac
@defmac version-3-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-array-divisor}.
@end defmac
@defmac arb-instanced-arrays enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-array-divisor-arb}.
@end defmac
@defmac angle-instanced-arrays enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-array-divisor-angle}.
@end defmac
@defmac nv-instanced-arrays enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-array-divisor-nv}.
@end defmac
@defmac nv-gpu-program-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{min-program-texel-offset-nv}, @code{max-program-texel-offset-nv},
@end defmac
@defmac ext-stencil-two-side enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{stencil-test-two-side-ext}, @code{active-stencil-face-ext}.
@end defmac
@defmac arb-sampler-objects enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sampler-binding}.
@end defmac
@defmac ati-fragment-shader enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-shader-ati}, @code{reg-0-ati}, @code{reg-1-ati},
@end defmac
@defmac oml-interlace enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{interlace-oml}, @code{interlace-read-oml}.
@end defmac
@defmac oml-subsample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{format-subsample-24-24-oml}, @code{format-subsample-244-244-oml}.
@end defmac
@defmac oml-resample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pack-resample-oml}, @code{unpack-resample-oml},
@end defmac
@defmac oes-point-size-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{point-size-array-type-oes}, @code{point-size-array-stride-oes},
@end defmac
@defmac oes-matrix-get enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{modelview-matrix-float-as-int-bits-oes},
@end defmac
@defmac apple-vertex-program-evaluators enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-map1-apple}, @code{vertex-attrib-map2-apple},
@end defmac
@defmac apple-fence enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{draw-pixels-apple}, @code{fence-apple}.
@end defmac
@defmac apple-element-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{element-array-apple}, @code{element-array-type-apple},
@end defmac
@defmac arb-uniform-buffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{uniform-buffer}, @code{uniform-buffer-binding},
@end defmac
@defmac apple-flush-buffer-range enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{buffer-serialized-modify-apple},
@end defmac
@defmac apple-aux-depth-stencil enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{aux-depth-stencil-apple}.
@end defmac
@defmac apple-row-bytes enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pack-row-bytes-apple}, @code{unpack-row-bytes-apple}.
@end defmac
@defmac apple-rgb-422 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgb-422-apple}, @code{unsigned-short-8-8-apple},
@end defmac
@defmac ext-texture-s-rgb-decode enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-srgb-decode-ext}, @code{decode-ext},
@end defmac
@defmac ext-debug-label enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{program-pipeline-object-ext}, @code{program-object-ext},
@end defmac
@defmac ext-shader-framebuffer-fetch enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-shader-discards-samples-ext}.
@end defmac
@defmac apple-sync enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sync-object-apple}, @code{max-server-wait-timeout-apple},
@end defmac
@defmac arb-shader-objects enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-shader}, @code{fragment-shader-arb},
@end defmac
@defmac arb-vertex-shader enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-shader}, @code{fragment-shader-arb},
@end defmac
@defmac arb-fragment-shader enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-shader}, @code{fragment-shader-arb},
@end defmac
@defmac nv-vertex-program-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-shader}, @code{fragment-shader-arb},
@end defmac
@defmac oes-standard-derivatives enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-shader-derivative-hint-oes}.
@end defmac
@defmac ext-geometry-shader-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-varying-components-ext}, @code{geometry-shader-ext},
@end defmac
@defmac oes-compressed-paletted-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{palette4-rgb8-oes}, @code{palette4-rgba8-oes},
@end defmac
@defmac oes-read-format enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{implementation-color-read-type-oes},
@end defmac
@defmac oes-draw-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-crop-rect-oes}.
@end defmac
@defmac mesa-program-debug enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{fragment-program-position-mesa},
@end defmac
@defmac amd-performance-monitor enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{counter-type-amd}, @code{counter-range-amd},
@end defmac
@defmac qcom-extended-get enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-width-qcom}, @code{texture-height-qcom},
@end defmac
@defmac img-texture-compression-pvrtc enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-rgb-pvrtc-4bppv1-img},
@end defmac
@defmac img-shader-binary enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sgx-binary-img}.
@end defmac
@defmac arb-texture-buffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-buffer-arb}, @code{max-texture-buffer-size-arb},
@end defmac
@defmac ext-texture-buffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-buffer-ext}, @code{max-texture-buffer-size-ext},
@end defmac
@defmac arb-occlusion-query-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{any-samples-passed}.
@end defmac
@defmac arb-sample-shading enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sample-shading-arb}, @code{min-sample-shading-value-arb}.
@end defmac
@defmac ext-packed-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{r11f-g11f-b10f-ext}, @code{unsigned-int-10f-11f-11f-rev-ext},
@end defmac
@defmac ext-texture-shared-exponent enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgb9-e5-ext}, @code{unsigned-int-5-9-9-9-rev-ext},
@end defmac
@defmac ext-texture-s-rgb enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{srgb-ext}, @code{srgb8-ext}, @code{srgb-alpha-ext},
@end defmac
@defmac ext-texture-compression-latc enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-luminance-latc1-ext},
@end defmac
@defmac ext-transform-feedback enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{transform-feedback-varying-max-length},
@end defmac
@defmac nv-transform-feedback enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{transform-feedback-varying-max-length},
@end defmac
@defmac ext-framebuffer-blit enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{draw-framebuffer-binding-ext}, @code{read-framebuffer-ext},
@end defmac
@defmac angle-framebuffer-blit enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{framebuffer-binding-angle}, @code{renderbuffer-binding-angle},
@end defmac
@defmac nv-framebuffer-blit enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{read-framebuffer-nv}, @code{draw-framebuffer-nv},
@end defmac
@defmac angle-framebuffer-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{renderbuffer-samples-angle},
@end defmac
@defmac ext-framebuffer-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{renderbuffer-samples-ext},
@end defmac
@defmac nv-framebuffer-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{renderbuffer-samples-nv},
@end defmac
@defmac nv-framebuffer-multisample-coverage enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{renderbuffer-coverage-samples-nv},
@end defmac
@defmac arb-depth-buffer-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-component32f}, @code{depth32f-stencil8},
@end defmac
@defmac nv-fbo-color-attachments enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-color-attachments-nv}.
@end defmac
@defmac oes-stencil-1 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{stencil-index1-oes}.
@end defmac
@defmac oes-stencil-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{stencil-index4-oes}.
@end defmac
@defmac oes-stencil-8 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{stencil-index8-oes}.
@end defmac
@defmac oes-vertex-half-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{half-float-oes}.
@end defmac
@defmac version-4-1 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgb565}.
@end defmac
@defmac oes-compressed-etc1-rgb8-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{etc1-rgb8-oes}.
@end defmac
@defmac oes-egl-image-external enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-external-oes}, @code{sampler-external-oes},
@end defmac
@defmac arb-es3-compatibility enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{primitive-restart-fixed-index},
@end defmac
@defmac ext-multisampled-render-to-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{framebuffer-attachment-texture-samples-ext}.
@end defmac
@defmac ext-texture-integer enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgba32ui}, @code{rgba32ui-ext}, @code{rgb32ui},
@end defmac
@defmac arb-vertex-type-2-10-10-10-rev enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{int-2-10-10-10-rev}.
@end defmac
@defmac nv-parameter-buffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-program-parameter-buffer-bindings-nv},
@end defmac
@defmac nv-depth-buffer-float enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-component32f-nv}, @code{depth32f-stencil8-nv},
@end defmac
@defmac arb-shading-language-include enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{shader-include-arb}, @code{named-string-length-arb},
@end defmac
@defmac arb-framebuffer-s-rgb enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{framebuffer-srgb}.
@end defmac
@defmac ext-framebuffer-s-rgb enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{framebuffer-srgb-ext}, @code{framebuffer-srgb-capable-ext}.
@end defmac
@defmac arb-texture-compression-rgtc enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-red-rgtc1}, @code{compressed-signed-red-rgtc1},
@end defmac
@defmac ext-texture-compression-rgtc enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-red-rgtc1-ext}, @code{compressed-signed-red-rgtc1-ext},
@end defmac
@defmac ext-gpu-shader-4 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sampler-1d-array-ext}, @code{sampler-2d-array-ext},
@end defmac
@defmac nv-shadow-samplers-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sampler-2d-array-shadow-nv}.
@end defmac
@defmac nv-shadow-samplers-cube enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sampler-cube-shadow-nv}.
@end defmac
@defmac ext-bindable-uniform enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-vertex-bindable-uniforms-ext},
@end defmac
@defmac arb-shader-subroutine enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{active-subroutines}, @code{active-subroutine-uniforms},
@end defmac
@defmac oes-vertex-type-10-10-10-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{unsigned-int-10-10-10-2-oes}, @code{int-10-10-10-2-oes}.
@end defmac
@defmac nv-conditional-render enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{query-wait-nv}, @code{query-no-wait-nv},
@end defmac
-@defmac nv-multisample-coverage enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{color-samples-nv}.
-
-@end defmac
-
@defmac arb-transform-feedback-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{transform-feedback}, @code{transform-feedback-paused},
@end defmac
@defmac nv-transform-feedback-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{transform-feedback-nv},
@end defmac
@defmac nv-present-video enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{frame-nv}, @code{fields-nv}, @code{current-time-nv},
@end defmac
@defmac nv-depth-nonlinear enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-component16-nonlinear-nv}.
@end defmac
@defmac ext-direct-state-access enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{program-matrix-ext}, @code{transpose-program-matrix-ext},
@end defmac
@defmac arb-texture-swizzle enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-swizzle-r}, @code{texture-swizzle-g},
@end defmac
@defmac ext-texture-swizzle enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-swizzle-r-ext}, @code{texture-swizzle-g-ext},
@end defmac
@defmac arb-provoking-vertex enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{quads-follow-provoking-vertex-convention},
@end defmac
@defmac ext-provoking-vertex enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{quads-follow-provoking-vertex-convention-ext},
@end defmac
@defmac arb-texture-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sample-position}, @code{sample-mask}, @code{sample-mask-value},
@end defmac
@defmac nv-explicit-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sample-position-nv}, @code{sample-mask-nv},
@end defmac
@defmac nv-gpu-program-5 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-geometry-program-invocations-nv},
@end defmac
-@defmac version-4-0 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{min-program-texture-gather-offset},
-@code{max-program-texture-gather-offset}, @code{texture-cube-map-array},
-@code{texture-binding-cube-map-array},
-@code{proxy-texture-cube-map-array}, @code{sampler-cube-map-array},
-@code{sampler-cube-map-array-shadow}, @code{int-sampler-cube-map-array},
-@code{unsigned-int-sampler-cube-map-array}.
-
-@end defmac
-
@defmac arb-texture-gather enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
-@code{min-program-texture-gather-offset-arb},
-@code{max-program-texture-gather-offset-arb},
-@code{max-program-texture-gather-components-arb}.
+@code{min-program-texture-gather-offset},
+@code{max-program-texture-gather-offset},
+@code{max-program-texture-gather-components-arb},
+@code{max-program-texture-gather-components}.
@end defmac
@defmac arb-transform-feedback-3 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-transform-feedback-buffers}, @code{max-vertex-streams}.
@end defmac
@defmac arb-texture-compression-bptc enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-rgba-bptc-unorm-arb},
@end defmac
@defmac nv-coverage-sample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{coverage-component-nv}, @code{coverage-component4-nv},
@end defmac
@defmac nv-shader-buffer-load enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{buffer-gpu-address-nv}, @code{gpu-address-nv},
@end defmac
@defmac nv-vertex-buffer-unified-memory enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vertex-attrib-array-unified-nv}, @code{element-array-unified-nv},
@end defmac
@defmac arb-copy-buffer enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{copy-read-buffer-binding}, @code{copy-read-buffer},
@end defmac
@defmac arb-draw-indirect enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{draw-indirect-buffer}, @code{draw-indirect-buffer-binding}.
@end defmac
@defmac arb-gpu-shader-fp-64 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{double-mat2}, @code{double-mat3}, @code{double-mat4},
@end defmac
@defmac arm-mali-shader-binary enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{mali-shader-binary-arm}.
@end defmac
-@defmac arm-mali-program-binary enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{mali-program-binary-arm}.
-
-@end defmac
-
@defmac qcom-driver-control enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{perfmon-global-mode-qcom}.
@end defmac
@defmac qcom-binning-control enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{binning-control-hint-qcom}, @code{cpu-optimized-qcom},
@end defmac
@defmac viv-shader-binary enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{shader-binary-viv}.
@end defmac
-@defmac amd-vertex-shader-tessellator enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+@defmac amd-vertex-shader-tesselator enum
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sampler-buffer-amd}, @code{int-sampler-buffer-amd},
@end defmac
@defmac arb-texture-cube-map-array enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-cube-map-array}, @code{texture-binding-cube-map-array},
@end defmac
@defmac ext-texture-snorm enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{alpha-snorm}, @code{luminance-snorm},
@end defmac
@defmac amd-blend-minmax-factor enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{factor-min-amd}, @code{factor-max-amd}.
@end defmac
@defmac amd-depth-clamp-separate enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-clamp-near-amd}, @code{depth-clamp-far-amd}.
@end defmac
@defmac nv-video-capture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{video-buffer-nv}, @code{video-buffer-binding-nv},
@end defmac
@defmac nv-texture-multisample enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-coverage-samples-nv}, @code{texture-color-samples-nv}.
@end defmac
@defmac arb-texture-rgb-10-a-2-ui enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgb10-a2ui}.
@end defmac
@defmac nv-path-rendering enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{path-format-svg-nv}, @code{path-format-ps-nv},
@end defmac
@defmac ext-framebuffer-multisample-blit-scaled enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{scaled-resolve-fastest-ext}, @code{scaled-resolve-nicest-ext}.
@end defmac
@defmac arb-map-buffer-alignment enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{min-map-buffer-alignment}.
@end defmac
@defmac nv-deep-texture-3d enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-deep-3d-texture-width-height-nv},
@end defmac
@defmac ext-x-11-sync-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sync-x11-fence-ext}.
@end defmac
@defmac arb-stencil-texturing enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{depth-stencil-texture-mode}.
@end defmac
@defmac nv-compute-program-5 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compute-program-nv}, @code{compute-program-parameter-buffer-nv}.
@end defmac
@defmac arb-sync enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-server-wait-timeout}, @code{object-type},
@end defmac
@defmac arb-compressed-texture-pixel-storage enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{unpack-compressed-block-width},
@end defmac
@defmac arb-texture-storage enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-immutable-format}.
@end defmac
@defmac img-program-binary enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sgx-program-binary-img}.
@end defmac
@defmac img-multisampled-render-to-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{renderbuffer-samples-img},
@end defmac
@defmac img-texture-compression-pvrtc-2 enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-rgba-pvrtc-2bppv2-img},
@end defmac
@defmac amd-debug-output enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{max-debug-message-length-amd},
@end defmac
@defmac amd-name-gen-delete enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{data-buffer-amd}, @code{performance-monitor-amd},
@end defmac
@defmac amd-pinned-memory enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{external-virtual-memory-buffer-amd}.
@end defmac
@defmac amd-query-buffer-object enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{query-buffer-amd}, @code{query-buffer-binding-amd},
@end defmac
@defmac amd-sparse-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{virtual-page-size-x-amd}, @code{virtual-page-size-y-amd},
@end defmac
@defmac arb-texture-buffer-range enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-buffer-offset}, @code{texture-buffer-size},
@end defmac
@defmac dmp-shader-binary enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{shader-binary-dmp}.
@end defmac
@defmac fj-shader-binary-gccso enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{gccso-shader-binary-fj}.
@end defmac
@defmac arb-shader-atomic-counters enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{atomic-counter-buffer}, @code{atomic-counter-buffer-binding},
@code{max-fragment-atomic-counters},
@code{max-combined-atomic-counters},
@code{max-atomic-counter-buffer-size},
+@code{max-atomic-counter-buffer-bindings},
@code{active-atomic-counter-buffers},
@code{uniform-atomic-counter-buffer-index},
-@code{unsigned-int-atomic-counter},
-@code{max-atomic-counter-buffer-bindings}.
+@code{unsigned-int-atomic-counter}.
@end defmac
@defmac arb-program-interface-query enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{uniform}, @code{uniform-block}, @code{program-input},
@end defmac
@defmac arb-framebuffer-no-attachments enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{framebuffer-default-width}, @code{framebuffer-default-height},
@end defmac
@defmac arb-internalformat-query enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{num-sample-counts}.
@end defmac
@defmac angle-translated-shader-source enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{translated-shader-source-length-angle}.
@end defmac
@defmac angle-texture-usage enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-usage-angle}, @code{framebuffer-attachment-angle},
@end defmac
@defmac angle-pack-reverse-row-order enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pack-reverse-row-order-angle}.
@end defmac
@defmac angle-depth-texture enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{program-binary-angle}.
@end defmac
@defmac gl-khr-texture-compression-astc-ldr enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{compressed-rgba-astc-4x4-khr},
@end defmac
-@defmac ibm-rasterpos-clip enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{raster-position-unclipped-ibm}.
-
-@end defmac
-
-@defmac ibm-cull-vertex enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{cull-vertex-ibm}.
-
-@end defmac
-
-@defmac ibm-static-data enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{all-static-data-ibm}, @code{static-vertex-array-ibm},
-@code{vertex-array-list-ibm}, @code{normal-array-list-ibm},
-@code{color-array-list-ibm}, @code{index-array-list-ibm},
-@code{texture-coord-array-list-ibm}, @code{edge-flag-array-list-ibm},
-@code{fog-coordinate-array-list-ibm},
-@code{secondary-color-array-list-ibm},
-@code{vertex-array-list-stride-ibm},
-@code{normal-array-list-stride-ibm}, @code{color-array-list-stride-ibm},
-@code{index-array-list-stride-ibm},
-@code{texture-coord-array-list-stride-ibm},
-@code{edge-flag-array-list-stride-ibm},
-@code{fog-coordinate-array-list-stride-ibm},
-@code{secondary-color-array-list-stride-ibm}.
-
-@end defmac
-
-@defmac pgi-misc-hints enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{prefer-doublebuffer-hint-pgi}, @code{conserve-memory-hint-pgi},
-@code{reclaim-memory-hint-pgi}, @code{native-graphics-handle-pgi},
-@code{native-graphics-begin-hint-pgi},
-@code{native-graphics-end-hint-pgi}, @code{always-fast-hint-pgi},
-@code{always-soft-hint-pgi}, @code{allow-draw-obj-hint-pgi},
-@code{allow-draw-win-hint-pgi}, @code{allow-draw-frg-hint-pgi},
-@code{allow-draw-mem-hint-pgi}, @code{strict-depthfunc-hint-pgi},
-@code{strict-lighting-hint-pgi}, @code{strict-scissor-hint-pgi},
-@code{full-stipple-hint-pgi}, @code{clip-near-hint-pgi},
-@code{clip-far-hint-pgi}, @code{wide-line-hint-pgi},
-@code{back-normals-hint-pgi}.
-
-@end defmac
-
-@defmac pgi-vertex-hints enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
-known to this enumerated value form are:
-
-@code{vertex-data-hint-pgi}, @code{vertex-consistent-hint-pgi},
-@code{material-side-hint-pgi}, @code{max-vertex-hint-pgi},
-@code{vertex23-bit-pgi}, @code{vertex4-bit-pgi}, @code{color3-bit-pgi},
-@code{color4-bit-pgi}, @code{edgeflag-bit-pgi}, @code{index-bit-pgi},
-@code{mat-ambient-bit-pgi}, @code{mat-ambient-and-diffuse-bit-pgi},
-@code{mat-diffuse-bit-pgi}, @code{mat-emission-bit-pgi},
-@code{mat-color-indexes-bit-pgi}, @code{mat-shininess-bit-pgi},
-@code{mat-specular-bit-pgi}, @code{normal-bit-pgi},
-@code{texcoord1-bit-pgi}, @code{texcoord2-bit-pgi},
-@code{texcoord3-bit-pgi}, @code{texcoord4-bit-pgi}.
-
-@end defmac
-
@c %end of fragment
@copying
This section of the manual was derived from the upstream OpenGL
-documentation. Each function's documentation has its own copyright
-statement; for full details, see the upstream documentation. The
+documentation. Each function's documentation has its own copyright
+statement; for full details, see the upstream documentation. The
copyright notices and licenses present in this section are as follows.
-Copyright @copyright{} 1991-2006 Silicon Graphics, Inc. This document
-is licensed under the SGI Free Software B License. For details, see
+Copyright @copyright{} 1991-2006 Silicon Graphics, Inc. This document is
+licensed under the SGI Free Software B License. For details, see
@uref{http://oss.sgi.com/projects/FreeB/,http://oss.sgi.com/projects/FreeB/}.
-Copyright @copyright{} 2003-2005 3Dlabs Inc. Ltd. This material may be
+Copyright @copyright{} 2003-2005 3Dlabs Inc. Ltd. This material may be
distributed subject to the terms and conditions set forth in the Open
Publication License, v 1.0, 8 June 1999.
@uref{http://opencontent.org/openpub/,http://opencontent.org/openpub/}.
-Copyright @copyright{} 2005 Addison-Wesley. This material may be
+Copyright @copyright{} 2005 Addison-Wesley. This material may be
distributed subject to the terms and conditions set forth in the Open
Publication License, v 1.0, 8 June 1999.
@uref{http://opencontent.org/openpub/,http://opencontent.org/openpub/}.
-Copyright @copyright{} 2006 Khronos Group. This material may be
+Copyright @copyright{} 2006 Khronos Group. This material may be
distributed subject to the terms and conditions set forth in the Open
Publication License, v 1.0, 8 June 1999.
@uref{http://opencontent.org/openpub/,http://opencontent.org/openpub/}.
@table @asis
@item @var{op}
-Specifies the accumulation buffer operation. Symbolic constants
+Specifies the accumulation buffer operation. Symbolic constants
@code{GL_ACCUM}, @code{GL_LOAD}, @code{GL_ADD}, @code{GL_MULT}, and
@code{GL_RETURN} are accepted.
@item @var{value}
Specifies a floating-point value used in the accumulation buffer
-operation. @var{op} determines how @var{value} is used.
+operation. @var{op} determines how @var{value} is used.
@end table
-The accumulation buffer is an extended-range color buffer. Images are
-not rendered into it. Rather, images rendered into one of the color
+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
+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.
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
+alpha values. The number of bits per component in the accumulation
+buffer depends on the implementation. You can examine this number by
calling @code{glGetIntegerv} four times, with arguments
@code{GL_ACCUM_RED_BITS}, @code{GL_ACCUM_GREEN_BITS},
-@code{GL_ACCUM_BLUE_BITS}, and @code{GL_ACCUM_ALPHA_BITS}. Regardless
-of the number of bits per component, the range of values stored by each
-component is @r{[-1,1]}. The accumulation buffer pixels are mapped
+@code{GL_ACCUM_BLUE_BITS}, and @code{GL_ACCUM_ALPHA_BITS}. Regardless of
+the number of bits per component, the range of values stored by each
+component is @r{[-1,1]}. The accumulation buffer pixels are mapped
one-to-one with frame buffer pixels.
-@code{glAccum} operates on the accumulation buffer. The first argument,
+@code{glAccum} operates on the accumulation buffer. The first argument,
@var{op}, is a symbolic constant that selects an accumulation buffer
-operation. The second argument, @var{value}, is a floating-point value
-to be used in that operation. Five operations are specified:
+operation. The second argument, @var{value}, is a floating-point value
+to be used in that operation. Five operations are specified:
@code{GL_ACCUM}, @code{GL_LOAD}, @code{GL_ADD}, @code{GL_MULT}, and
@code{GL_RETURN}.
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 @code{glAccum} operation results
-in a value outside the range @r{[-1,1]}, the contents of an accumulation
+alpha components of each pixel. If a @code{glAccum} operation results in
+a value outside the range @r{[-1,1]}, the contents of an accumulation
buffer pixel component are undefined.
The operations are as follows:
@table @asis
@item @code{GL_ACCUM}
Obtains R, G, B, and A values from the buffer currently selected for
-reading (see @code{glReadBuffer}). Each component value is divided by
+reading (see @code{glReadBuffer}). Each component value is divided by
@r{2^@var{n}-1}, where @r{@var{n}} is the number of bits allocated to
-each color component in the currently selected buffer. The result is a
+each color component in the currently selected buffer. The result is a
floating-point value in the range @r{[0,1]}, which is multiplied by
@var{value} and added to the corresponding pixel component in the
accumulation buffer, thereby updating the accumulation buffer.
@item @code{GL_RETURN}
Transfers accumulation buffer values to the color buffer or buffers
-currently selected for writing. Each R, G, B, and A component is
+currently selected for writing. Each R, G, B, and A component is
multiplied by @var{value}, then multiplied by @r{2^@var{n}-1}, clamped
to the range @r{[0,2^@var{n}-1]}, and stored in the corresponding
-display buffer cell. The only fragment operations that are applied to
+display buffer cell. The only fragment operations that are applied to
this transfer are pixel ownership, scissor, dithering, and color
writemasks.
@table @asis
@item @var{texture}
-Specifies which texture unit to make active. The number of texture
-units is implementation dependent, but must be at least two.
-@var{texture} must be one of @code{GL_TEXTURE}@r{@var{i}}, where i
-ranges from 0 to the larger of (@code{GL_MAX_TEXTURE_COORDS} - 1) and
-(@code{GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS} - 1). The initial value is
+Specifies which texture unit to make active. The number of texture units
+is implementation dependent, but must be at least two. @var{texture}
+must be one of @code{GL_TEXTURE}@r{@var{i}}, where i ranges from 0 to
+the larger of (@code{GL_MAX_TEXTURE_COORDS} - 1) and
+(@code{GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS} - 1). The initial value is
@code{GL_TEXTURE0}.
@end table
@code{glActiveTexture} selects which texture unit subsequent texture
-state calls will affect. The number of texture units an implementation
+state calls will affect. The number of texture units an implementation
supports is implementation dependent, but must be at least 2.
Vertex arrays are client-side GL resources, which are selected by the
@table @asis
@item @var{func}
-Specifies the alpha comparison function. Symbolic constants
+Specifies the alpha comparison function. Symbolic constants
@code{GL_NEVER}, @code{GL_LESS}, @code{GL_EQUAL}, @code{GL_LEQUAL},
@code{GL_GREATER}, @code{GL_NOTEQUAL}, @code{GL_GEQUAL}, and
-@code{GL_ALWAYS} are accepted. The initial value is @code{GL_ALWAYS}.
+@code{GL_ALWAYS} are accepted. The initial value is @code{GL_ALWAYS}.
@item @var{ref}
Specifies the reference value that incoming alpha values are compared
-to. This value is clamped to the range @r{[0,1]}, where 0 represents
-the lowest possible alpha value and 1 the highest possible value. The
+to. This value is clamped to the range @r{[0,1]}, where 0 represents the
+lowest possible alpha value and 1 the highest possible value. The
initial reference value is 0.
@end table
The alpha test discards fragments depending on the outcome of a
comparison between an incoming fragment's alpha value and a constant
-reference value. @code{glAlphaFunc} 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
-@code{glEnable} and @code{glDisable} of @code{GL_ALPHA_TEST}.)
+reference value. @code{glAlphaFunc} 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 @code{glEnable}
+and @code{glDisable} of @code{GL_ALPHA_TEST}.)
@var{func} and @var{ref} specify the conditions under which the pixel is
-drawn. The incoming alpha value is compared to @var{ref} using the
-function specified by @var{func}. If the value passes the comparison,
+drawn. The incoming alpha value is compared to @var{ref} using the
+function specified by @var{func}. 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:
+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:
@table @asis
@item @code{GL_NEVER}
@code{glAlphaFunc} 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. @code{glAlphaFunc}
+bitmaps, and from pixel draw and copy operations. @code{glAlphaFunc}
does not affect screen clear operations.
@code{GL_INVALID_ENUM} is generated if @var{func} is not an accepted
@end table
GL establishes a ``working set'' of textures that are resident in
-texture memory. These textures can be bound to a texture target much
+texture memory. These textures can be bound to a texture target much
more efficiently than textures that are not resident.
@code{glAreTexturesResident} queries the texture residence status of the
-@var{n} textures named by the elements of @var{textures}. If all the
+@var{n} textures named by the elements of @var{textures}. If all the
named textures are resident, @code{glAreTexturesResident} returns
-@code{GL_TRUE}, and the contents of @var{residences} are undisturbed. If
+@code{GL_TRUE}, and the contents of @var{residences} are undisturbed. If
not all the named textures are resident, @code{glAreTexturesResident}
returns @code{GL_FALSE}, and detailed status is returned in the @var{n}
-elements of @var{residences}. If an element of @var{residences} is
+elements of @var{residences}. If an element of @var{residences} is
@code{GL_TRUE}, then the texture named by the corresponding element of
@var{textures} is resident.
The residence status of a single bound texture may also be queried by
calling @code{glGetTexParameter} with the @var{target} argument set to
the target to which the texture is bound, and the @var{pname} argument
-set to @code{GL_TEXTURE_RESIDENT}. This is the only way that the
+set to @code{GL_TEXTURE_RESIDENT}. This is the only way that the
residence status of a default texture can be queried.
@code{GL_INVALID_VALUE} is generated if @var{n} is negative.
@code{GL_INVALID_VALUE} is generated if any element in @var{textures} is
-0 or does not name a texture. In that case, the function returns
+0 or does not name a texture. In that case, the function returns
@code{GL_FALSE} and the contents of @var{residences} is indeterminate.
@code{GL_INVALID_OPERATION} is generated if @code{glAreTexturesResident}
@code{glArrayElement} commands are used within
@code{glBegin}/@code{glEnd} pairs to specify vertex and attribute data
-for point, line, and polygon primitives. If @code{GL_VERTEX_ARRAY} is
+for point, line, and polygon primitives. If @code{GL_VERTEX_ARRAY} is
enabled when @code{glArrayElement} is called, a single vertex is drawn,
using vertex and attribute data taken from location @var{i} of the
-enabled arrays. If @code{GL_VERTEX_ARRAY} is not enabled, no drawing
+enabled arrays. If @code{GL_VERTEX_ARRAY} is not enabled, no drawing
occurs but the attributes corresponding to the enabled arrays are
modified.
Use @code{glArrayElement} 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
+order. Because each call specifies only a single vertex, it is possible
to explicitly specify per-primitive attributes such as a single normal
for each triangle.
Changes made to array data between the execution of @code{glBegin} and
the corresponding execution of @code{glEnd} may affect calls to
@code{glArrayElement} that are made within the same
-@code{glBegin}/@code{glEnd} period in nonsequential ways. That is, a
+@code{glBegin}/@code{glEnd} period in nonsequential ways. That is, a
call to @code{glArrayElement} 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.
@end table
In order to create an executable, there must be a way to specify the
-list of things that will be linked together. Program objects provide
-this mechanism. Shaders that are to be linked together in a program
+list of things that will be linked together. Program objects provide
+this mechanism. Shaders that are to be linked together in a program
object must first be attached to that program object.
@code{glAttachShader} attaches the shader object specified by
-@var{shader} to the program object specified by @var{program}. This
+@var{shader} to the program object specified by @var{program}. This
indicates that @var{shader} will be included in link operations that
will be performed on @var{program}.
All operations that can be performed on a shader object are valid
-whether or not the shader object is attached to a program object. It is
+whether or not the shader object is attached to a program object. It is
permissible to attach a shader object to a program object before source
code has been loaded into the shader object or before the shader object
-has been compiled. It is permissible to attach multiple shader objects
+has been compiled. It is permissible to attach multiple shader objects
of the same type because each may contain a portion of the complete
-shader. It is also permissible to attach a shader object to more than
-one program object. If a shader object is deleted while it is attached
+shader. It is also permissible to attach a shader object to more than
+one program object. If a shader object is deleted while it is attached
to a program object, it will be flagged for deletion, and deletion will
not occur until @code{glDetachShader} is called to detach it from all
program objects to which it is attached.
@table @asis
@item @var{target}
Specifies the target type of query object established between
-@code{glBeginQuery} and the subsequent @code{glEndQuery}. The symbolic
+@code{glBeginQuery} and the subsequent @code{glEndQuery}. The symbolic
constant must be @code{GL_SAMPLES_PASSED}.
@item @var{id}
@end table
@code{glBeginQuery} and @code{glEndQuery} delimit the boundaries of a
-query object. If a query object with name @var{id} does not yet exist
-it is created.
+query object. If a query object with name @var{id} does not yet exist it
+is created.
When @code{glBeginQuery} is executed, the query object's samples-passed
-counter is reset to 0. Subsequent rendering will increment the counter
-once for every sample that passes the depth test. When
-@code{glEndQuery} is executed, the samples-passed counter is assigned to
-the query object's result value. This value can be queried by calling
+counter is reset to 0. Subsequent rendering will increment the counter
+once for every sample that passes the depth test. When @code{glEndQuery}
+is executed, the samples-passed counter is assigned to the query
+object's result value. This value can be queried by calling
@code{glGetQueryObject} with @var{pname}@code{GL_QUERY_RESULT}.
Querying the @code{GL_QUERY_RESULT} implicitly flushes the GL pipeline
until the rendering delimited by the query object has completed and the
-result is available. @code{GL_QUERY_RESULT_AVAILABLE} can be queried to
+result is available. @code{GL_QUERY_RESULT_AVAILABLE} can be queried to
determine if the result is immediately available or if the rendering is
not yet complete.
@table @asis
@item @var{mode}
Specifies the primitive or primitives that will be created from vertices
-presented between @code{glBegin} and the subsequent @code{glEnd}. Ten
+presented between @code{glBegin} and the subsequent @code{glEnd}. Ten
symbolic constants are accepted: @code{GL_POINTS}, @code{GL_LINES},
@code{GL_LINE_STRIP}, @code{GL_LINE_LOOP}, @code{GL_TRIANGLES},
@code{GL_TRIANGLE_STRIP}, @code{GL_TRIANGLE_FAN}, @code{GL_QUADS},
@end table
@code{glBegin} and @code{glEnd} delimit the vertices that define a
-primitive or a group of like primitives. @code{glBegin} accepts a
-single argument that specifies in which of ten ways the vertices are
-interpreted. Taking @r{@var{n}} as an integer count starting at one,
-and @r{@var{N}} as the total number of vertices specified, the
+primitive or a group of like primitives. @code{glBegin} accepts a single
+argument that specifies in which of ten ways the vertices are
+interpreted. Taking @r{@var{n}} as an integer count starting at one, and
+@r{@var{N}} as the total number of vertices specified, the
interpretations are as follows:
@table @asis
@item @code{GL_POINTS}
-Treats each vertex as a single point. Vertex @r{@var{n}} defines point
-@r{@var{n}}. @r{@var{N}} points are drawn.
+Treats each vertex as a single point. Vertex @r{@var{n}} defines point
+@r{@var{n}}. @r{@var{N}} points are drawn.
@item @code{GL_LINES}
-Treats each pair of vertices as an independent line segment. Vertices
-@r{2@var{n}-1} and @r{2@var{n}} define line @r{@var{n}}. @r{@var{N}/2}
+Treats each pair of vertices as an independent line segment. Vertices
+@r{2@var{n}-1} and @r{2@var{n}} define line @r{@var{n}}. @r{@var{N}/2}
lines are drawn.
@item @code{GL_LINE_STRIP}
Draws a connected group of line segments from the first vertex to the
-last. Vertices @r{@var{n}} and @r{@var{n}+1} define line @r{@var{n}}.
+last. Vertices @r{@var{n}} and @r{@var{n}+1} define line @r{@var{n}}.
@r{@var{N}-1} lines are drawn.
@item @code{GL_LINE_LOOP}
Draws a connected group of line segments from the first vertex to the
-last, then back to the first. Vertices @r{@var{n}} and @r{@var{n}+1}
-define line @r{@var{n}}. The last line, however, is defined by vertices
-@r{@var{N}} and @r{1}. @r{@var{N}} lines are drawn.
+last, then back to the first. Vertices @r{@var{n}} and @r{@var{n}+1}
+define line @r{@var{n}}. The last line, however, is defined by vertices
+@r{@var{N}} and @r{1}. @r{@var{N}} lines are drawn.
@item @code{GL_TRIANGLES}
-Treats each triplet of vertices as an independent triangle. Vertices
+Treats each triplet of vertices as an independent triangle. Vertices
@r{3@var{n}-2}, @r{3@var{n}-1}, and @r{3@var{n}} define triangle
-@r{@var{n}}. @r{@var{N}/3} triangles are drawn.
+@r{@var{n}}. @r{@var{N}/3} triangles are drawn.
@item @code{GL_TRIANGLE_STRIP}
-Draws a connected group of triangles. One triangle is defined for each
-vertex presented after the first two vertices. For odd @r{@var{n}},
+Draws a connected group of triangles. One triangle is defined for each
+vertex presented after the first two vertices. For odd @r{@var{n}},
vertices @r{@var{n}}, @r{@var{n}+1}, and @r{@var{n}+2} define triangle
-@r{@var{n}}. For even @r{@var{n}}, vertices @r{@var{n}+1}, @r{@var{n}},
-and @r{@var{n}+2} define triangle @r{@var{n}}. @r{@var{N}-2} triangles
+@r{@var{n}}. For even @r{@var{n}}, vertices @r{@var{n}+1}, @r{@var{n}},
+and @r{@var{n}+2} define triangle @r{@var{n}}. @r{@var{N}-2} triangles
are drawn.
@item @code{GL_TRIANGLE_FAN}
-Draws a connected group of triangles. One triangle is defined for each
-vertex presented after the first two vertices. Vertices @r{1},
+Draws a connected group of triangles. One triangle is defined for each
+vertex presented after the first two vertices. Vertices @r{1},
@r{@var{n}+1}, and @r{@var{n}+2} define triangle @r{@var{n}}.
@r{@var{N}-2} triangles are drawn.
@item @code{GL_QUADS}
Treats each group of four vertices as an independent quadrilateral.
Vertices @r{4@var{n}-3}, @r{4@var{n}-2}, @r{4@var{n}-1}, and
-@r{4@var{n}} define quadrilateral @r{@var{n}}. @r{@var{N}/4}
+@r{4@var{n}} define quadrilateral @r{@var{n}}. @r{@var{N}/4}
quadrilaterals are drawn.
@item @code{GL_QUAD_STRIP}
-Draws a connected group of quadrilaterals. One quadrilateral is defined
-for each pair of vertices presented after the first pair. Vertices
+Draws a connected group of quadrilaterals. One quadrilateral is defined
+for each pair of vertices presented after the first pair. Vertices
@r{2@var{n}-1}, @r{2@var{n}}, @r{2@var{n}+2}, and @r{2@var{n}+1}
-define quadrilateral @r{@var{n}}. @r{@var{N}/2-1} quadrilaterals are
-drawn. Note that the order in which vertices are used to construct a
+define quadrilateral @r{@var{n}}. @r{@var{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.
@item @code{GL_POLYGON}
-Draws a single, convex polygon. Vertices @r{1} through @r{@var{N}}
+Draws a single, convex polygon. Vertices @r{1} through @r{@var{N}}
define this polygon.
@end table
Only a subset of GL commands can be used between @code{glBegin} and
-@code{glEnd}. The commands are @code{glVertex}, @code{glColor},
+@code{glEnd}. The commands are @code{glVertex}, @code{glColor},
@code{glSecondaryColor}, @code{glIndex}, @code{glNormal},
@code{glFogCoord}, @code{glTexCoord}, @code{glMultiTexCoord},
@code{glVertexAttrib}, @code{glEvalCoord}, @code{glEvalPoint},
-@code{glArrayElement}, @code{glMaterial}, and @code{glEdgeFlag}. Also,
+@code{glArrayElement}, @code{glMaterial}, and @code{glEdgeFlag}. Also,
it is acceptable to use @code{glCallList} or @code{glCallLists} to
-execute display lists that include only the preceding commands. If any
+execute display lists that include only the preceding commands. If any
other GL command is executed between @code{glBegin} and @code{glEnd},
the error flag is set and the command is ignored.
Regardless of the value chosen for @var{mode}, there is no limit to the
number of vertices that can be defined between @code{glBegin} and
-@code{glEnd}. Lines, triangles, quadrilaterals, and polygons that are
-incompletely specified are not drawn. Incomplete specification results
+@code{glEnd}. 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
+primitive or when an incorrect multiple of vertices is specified. The
incomplete primitive is ignored; the rest are drawn.
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
+and 3 for a polygon. Modes that require a certain multiple of vertices
are @code{GL_LINES} (2), @code{GL_TRIANGLES} (3), @code{GL_QUADS} (4),
and @code{GL_QUAD_STRIP} (2).
@code{glBindAttribLocation} is used to associate a user-defined
attribute variable in the program object specified by @var{program} with
-a generic vertex attribute index. The name of the user-defined
-attribute variable is passed as a null terminated string in @var{name}.
-The generic vertex attribute index to be bound to this variable is
-specified by @var{index}. When @var{program} is made part of current
-state, values provided via the generic vertex attribute @var{index} will
-modify the value of the user-defined attribute variable specified by
-@var{name}.
+a generic vertex attribute index. The name of the user-defined attribute
+variable is passed as a null terminated string in @var{name}. The
+generic vertex attribute index to be bound to this variable is specified
+by @var{index}. When @var{program} is made part of current state, values
+provided via the generic vertex attribute @var{index} will modify the
+value of the user-defined attribute variable specified by @var{name}.
If @var{name} refers to a matrix attribute variable, @var{index} refers
-to the first column of the matrix. Other matrix columns are then
+to the first column of the matrix. Other matrix columns are then
automatically bound to locations @var{index+1} for a matrix of type
mat2; @var{index+1} and @var{index+2} for a matrix of type mat3; and
@var{index+1}, @var{index+2}, and @var{index+3} for a matrix of type
This command makes it possible for vertex shaders to use descriptive
names for attribute variables rather than generic variables that are
-numbered from 0 to @code{GL_MAX_VERTEX_ATTRIBS} -1. The values sent to
+numbered from 0 to @code{GL_MAX_VERTEX_ATTRIBS} -1. The values sent to
each generic attribute index are part of current state, just like
standard vertex attributes such as color, normal, and vertex position.
If a different program object is made current by calling
Attribute variable name-to-generic attribute index bindings for a
program object can be explicitly assigned at any time by calling
-@code{glBindAttribLocation}. Attribute bindings do not go into effect
-until @code{glLinkProgram} is called. After a program object has been
+@code{glBindAttribLocation}. Attribute bindings do not go into effect
+until @code{glLinkProgram} is called. After a program object has been
linked successfully, the index values for generic attributes remain
fixed (and their values can be queried) until the next link command
occurs.
Applications are not allowed to bind any of the standard OpenGL vertex
attributes using this command, as they are bound automatically when
-needed. Any attribute binding that occurs after the program object has
+needed. Any attribute binding that occurs after the program object has
been linked will not take effect until the next time the program object
is linked.
@table @asis
@item @var{target}
-Specifies the target to which the buffer object is bound. The symbolic
+Specifies the target to which the buffer object is bound. The symbolic
constant must be @code{GL_ARRAY_BUFFER}, @code{GL_ELEMENT_ARRAY_BUFFER},
@code{GL_PIXEL_PACK_BUFFER}, or @code{GL_PIXEL_UNPACK_BUFFER}.
@code{GL_ARRAY_BUFFER}, @code{GL_ELEMENT_ARRAY_BUFFER},
@code{GL_PIXEL_PACK_BUFFER} or @code{GL_PIXEL_UNPACK_BUFFER} and
@var{buffer} set to the name of the new buffer object binds the buffer
-object name to the target. When a buffer object is bound to a target,
+object name to the target. When a buffer object is bound to a target,
the previous binding for that target is automatically broken.
-Buffer object names are unsigned integers. The value zero is reserved,
+Buffer object names are unsigned integers. The value zero is reserved,
but there is no default buffer object for each buffer object target.
Instead, @var{buffer} set to zero effectively unbinds any buffer object
previously bound, and restores client memory usage for that buffer
-object target. Buffer object names and the corresponding buffer object
+object target. Buffer object names and the corresponding buffer object
contents are local to the shared display-list space (see
@code{glXCreateContext}) of the current GL rendering context; two
rendering contexts share buffer object names only if they also share
While a non-zero buffer object name is bound, GL operations on the
target to which it is bound affect the bound buffer object, and queries
of the target to which it is bound return state from the bound buffer
-object. While buffer object name zero is bound, as in the initial
-state, attempts to modify or query state on the target to which it is
-bound generates an @code{GL_INVALID_OPERATION} error.
+object. While buffer object name zero is bound, as in the initial state,
+attempts to modify or query state on the target to which it is bound
+generates an @code{GL_INVALID_OPERATION} error.
When vertex array pointer state is changed, for example by a call to
@code{glNormalPointer}, the current buffer object binding
(@code{GL_ARRAY_BUFFER_BINDING}) is copied into the corresponding client
state for the vertex array type being changed, for example
-@code{GL_NORMAL_ARRAY_BUFFER_BINDING}. While a non-zero buffer object
-is bound to the @code{GL_ARRAY_BUFFER} target, the vertex array pointer
+@code{GL_NORMAL_ARRAY_BUFFER_BINDING}. While a non-zero buffer object is
+bound to the @code{GL_ARRAY_BUFFER} target, the vertex array pointer
parameter that is traditionally interpreted as a pointer to client-side
memory is instead interpreted as an offset within the buffer object
measured in basic machine units.
@code{glGetCompressedTexImage}, @code{glGetConvolutionFilter},
@code{glGetHistogram}, @code{glGetMinmax}, @code{glGetPixelMap},
@code{glGetPolygonStipple}, @code{glGetSeparableFilter},
-@code{glGetTexImage}, and @code{glReadPixels}. The pointer parameter
+@code{glGetTexImage}, and @code{glReadPixels}. The pointer parameter
that is traditionally interpreted as a pointer to client-side memory
where the pixels are to be packed is instead interpreted as an offset
within the buffer object measured in basic machine units.
@code{glDrawPixels}, @code{glPixelMap}, @code{glPolygonStipple},
@code{glSeparableFilter2D}, @code{glTexImage1D}, @code{glTexImage2D},
@code{glTexImage3D}, @code{glTexSubImage1D}, @code{glTexSubImage2D}, and
-@code{glTexSubImage3D}. The pointer parameter that is traditionally
+@code{glTexSubImage3D}. The pointer parameter that is traditionally
interpreted as a pointer to client-side memory from which the pixels are
to be unpacked is instead interpreted as an offset within the buffer
object measured in basic machine units.
until the bound buffer object is deleted with @code{glDeleteBuffers}.
Once created, a named buffer object may be re-bound to any target as
-often as needed. However, the GL implementation may make choices about
+often as needed. However, the GL implementation may make choices about
how to optimize the storage of a buffer object based on its initial
binding target.
@table @asis
@item @var{target}
-Specifies the target to which the texture is bound. Must be either
+Specifies the target to which the texture is bound. Must be either
@code{GL_TEXTURE_1D}, @code{GL_TEXTURE_2D}, @code{GL_TEXTURE_3D}, or
@code{GL_TEXTURE_CUBE_MAP}.
@end table
-@code{glBindTexture} lets you create or use a named texture. Calling
+@code{glBindTexture} lets you create or use a named texture. Calling
@code{glBindTexture} with @var{target} set to @code{GL_TEXTURE_1D},
@code{GL_TEXTURE_2D}, @code{GL_TEXTURE_3D} or @code{GL_TEXTURE_CUBE_MAP}
and @var{texture} set to the name of the new texture binds the texture
-name to the target. When a texture is bound to a target, the previous
+name to the target. When a texture is bound to a target, the previous
binding for that target is automatically broken.
-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 @code{glXCreateContext}) of the current GL
-rendering context; two rendering contexts share texture names only if
-they also share display lists.
+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 @code{glXCreateContext}) of the current GL rendering context;
+two rendering contexts share texture names only if they also share
+display lists.
You may use @code{glGenTextures} to generate a set of new texture names.
texture, a texture first bound to @code{GL_TEXTURE_2D} becomes
two-dimensional texture, a texture first bound to @code{GL_TEXTURE_3D}
becomes three-dimensional texture, and a texture first bound to
-@code{GL_TEXTURE_CUBE_MAP} becomes a cube-mapped texture. The state of
-a one-dimensional texture immediately after it is first bound is
+@code{GL_TEXTURE_CUBE_MAP} becomes a cube-mapped texture. The state of a
+one-dimensional texture immediately after it is first bound is
equivalent to the state of the default @code{GL_TEXTURE_1D} at GL
initialization, and similarly for two- and three-dimensional textures
and cube-mapped textures.
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 is active
-on the target to which a texture is bound, the bound texture is used. In
+bound return state from the bound texture. If texture mapping is active
+on the target to which a texture is bound, 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.
texture is deleted with @code{glDeleteTextures}.
Once created, a named texture may be re-bound to its same original
-target as often as needed. It is usually much faster to use
+target as often as needed. It is usually much faster to use
@code{glBindTexture} to bind an existing named texture to one of the
texture targets than it is to reload the texture image using
-@code{glTexImage1D}, @code{glTexImage2D}, or @code{glTexImage3D}. For
+@code{glTexImage1D}, @code{glTexImage2D}, or @code{glTexImage3D}. For
additional control over performance, use @code{glPrioritizeTextures}.
@code{glBindTexture} is included in display lists.
@item @var{xorig}
@itemx @var{yorig}
-Specify the location of the origin in the bitmap image. The origin is
+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.
@end table
-A bitmap is a binary image. When drawn, the bitmap is positioned
+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
+color or index. Frame buffer pixels corresponding to 0's in the bitmap
are not modified.
-@code{glBitmap} takes seven arguments. The first pair specifies the
-width and height of the bitmap image. The second pair specifies the
+@code{glBitmap} 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 @var{x} and @var{y}
+bitmap image. The third pair of arguments specifies @var{x} and @var{y}
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.
+been drawn. The final argument is a pointer to the bitmap image itself.
If a non-zero named buffer object is bound to the
@code{GL_PIXEL_UNPACK_BUFFER} target (see @code{glBindBuffer}) while a
@code{glDrawPixels} command, with @var{width} and @var{height}
corresponding to the width and height arguments of that command, and
with @var{type} set to @code{GL_BITMAP} and @var{format} set to
-@code{GL_COLOR_INDEX}. Modes specified using @code{glPixelStore} affect
+@code{GL_COLOR_INDEX}. Modes specified using @code{glPixelStore} affect
the interpretation of bitmap image data; modes specified using
@code{glPixelTransfer} do not.
@r{@var{y}_@var{w}=⌊@var{y}_@var{r}-@var{y}_@var{o},⌋}
where @r{(@var{x}_@var{r},@var{y}_@var{r})} is the raster position and
-@r{(@var{x}_@var{o},@var{y}_@var{o})} is the bitmap origin. Fragments
+@r{(@var{x}_@var{o},@var{y}_@var{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
+bitmap image. These fragments are generated using the current raster
@var{z} 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, fogging, and
-all per-fragment operations such as alpha and depth testing.
+coordinates. They are then treated just as if they had been generated by
+a point, line, or polygon, including texture mapping, fogging, and all
+per-fragment operations such as alpha and depth testing.
After the bitmap has been drawn, the @var{x} and @var{y} coordinates of
the current raster position are offset by @var{xmove} and @var{ymove}.
@end table
The @code{GL_BLEND_COLOR} may be used to calculate the source and
-destination blending factors. The color components are clamped to the
-range @r{[0,1]} before being stored. See @code{glBlendFunc} for a
-complete description of the blending operations. Initially the
+destination blending factors. The color components are clamped to the
+range @r{[0,1]} before being stored. See @code{glBlendFunc} for a
+complete description of the blending operations. Initially the
@code{GL_BLEND_COLOR} is set to (0, 0, 0, 0).
@code{GL_INVALID_OPERATION} is generated if @code{glBlendColor} is
@table @asis
@item @var{modeRGB}
specifies the RGB blend equation, how the red, green, and blue
-components of the source and destination colors are combined. It must
-be @code{GL_FUNC_ADD}, @code{GL_FUNC_SUBTRACT},
+components of the source and destination colors are combined. It must be
+@code{GL_FUNC_ADD}, @code{GL_FUNC_SUBTRACT},
@code{GL_FUNC_REVERSE_SUBTRACT}, @code{GL_MIN}, @code{GL_MAX}.
@item @var{modeAlpha}
specifies the alpha blend equation, how the alpha component of the
-source and destination colors are combined. It must be
+source and destination colors are combined. It must be
@code{GL_FUNC_ADD}, @code{GL_FUNC_SUBTRACT},
@code{GL_FUNC_REVERSE_SUBTRACT}, @code{GL_MIN}, @code{GL_MAX}.
The blend equations determines how a new pixel (the ''source'' color) is
combined with a pixel already in the framebuffer (the ''destination''
-color). This function specifies one blend equation for the RGB-color
+color). This function specifies one blend equation for the RGB-color
components and one blend equation for the alpha component.
The blend equations use the source and destination blend factors
are referred to as
@r{(@var{R}_@var{s},@var{G}_@var{s}@var{B}_@var{s}@var{A}_@var{s})} and
@r{(@var{R}_@var{d},@var{G}_@var{d}@var{B}_@var{d}@var{A}_@var{d})},
-respectively. The result color is referred to as
-@r{(@var{R}_@var{r},@var{G}_@var{r}@var{B}_@var{r}@var{A}_@var{r})}. The
+respectively. The result color is referred to as
+@r{(@var{R}_@var{r},@var{G}_@var{r}@var{B}_@var{r}@var{A}_@var{r})}. The
source and destination blend factors are denoted
@r{(@var{s}_@var{R},@var{s}_@var{G}@var{s}_@var{B}@var{s}_@var{A})} and
@r{(@var{d}_@var{R},@var{d}_@var{G}@var{d}_@var{B}@var{d}_@var{A})},
-respectively. For these equations all color components are understood
-to have values in the range @r{[0,1]}.
+respectively. For these equations all color components are understood to
+have values in the range @r{[0,1]}.
@table @asis
@item @strong{Mode}
The @code{GL_MIN} and @code{GL_MAX} equations are useful for
applications that analyze image data (image thresholding against a
-constant color, for example). The @code{GL_FUNC_ADD} equation is useful
+constant color, for example). The @code{GL_FUNC_ADD} equation is useful
for antialiasing and transparency, among other things.
Initially, both the RGB blend equation and the alpha blend equation are
@table @asis
@item @var{mode}
-specifies how source and destination colors are combined. It must be
+specifies how source and destination colors are combined. It must be
@code{GL_FUNC_ADD}, @code{GL_FUNC_SUBTRACT},
@code{GL_FUNC_REVERSE_SUBTRACT}, @code{GL_MIN}, @code{GL_MAX}.
The blend equations determine how a new pixel (the ''source'' color) is
combined with a pixel already in the framebuffer (the ''destination''
-color). This function sets both the RGB blend equation and the alpha
+color). This function sets both the RGB blend equation and the alpha
blend equation to a single equation.
These equations use the source and destination blend factors specified
-by either @code{glBlendFunc} or @code{glBlendFuncSeparate}. See
+by either @code{glBlendFunc} or @code{glBlendFuncSeparate}. See
@code{glBlendFunc} or @code{glBlendFuncSeparate} for a description of
the various blend factors.
are referred to as
@r{(@var{R}_@var{s},@var{G}_@var{s}@var{B}_@var{s}@var{A}_@var{s})} and
@r{(@var{R}_@var{d},@var{G}_@var{d}@var{B}_@var{d}@var{A}_@var{d})},
-respectively. The result color is referred to as
-@r{(@var{R}_@var{r},@var{G}_@var{r}@var{B}_@var{r}@var{A}_@var{r})}. The
+respectively. The result color is referred to as
+@r{(@var{R}_@var{r},@var{G}_@var{r}@var{B}_@var{r}@var{A}_@var{r})}. The
source and destination blend factors are denoted
@r{(@var{s}_@var{R},@var{s}_@var{G}@var{s}_@var{B}@var{s}_@var{A})} and
@r{(@var{d}_@var{R},@var{d}_@var{G}@var{d}_@var{B}@var{d}_@var{A})},
-respectively. For these equations all color components are understood
-to have values in the range @r{[0,1]}.
+respectively. For these equations all color components are understood to
+have values in the range @r{[0,1]}.
@table @asis
@item @strong{Mode}
The @code{GL_MIN} and @code{GL_MAX} equations are useful for
applications that analyze image data (image thresholding against a
-constant color, for example). The @code{GL_FUNC_ADD} equation is useful
+constant color, for example). The @code{GL_FUNC_ADD} equation is useful
for antialiasing and transparency, among other things.
Initially, both the RGB blend equation and the alpha blend equation are
@item @var{dstRGB}
Specifies how the red, green, and blue destination blending factors are
-computed. The following symbolic constants are accepted:
-@code{GL_ZERO}, @code{GL_ONE}, @code{GL_SRC_COLOR},
-@code{GL_ONE_MINUS_SRC_COLOR}, @code{GL_DST_COLOR},
-@code{GL_ONE_MINUS_DST_COLOR}, @code{GL_SRC_ALPHA},
+computed. The following symbolic constants are accepted: @code{GL_ZERO},
+@code{GL_ONE}, @code{GL_SRC_COLOR}, @code{GL_ONE_MINUS_SRC_COLOR},
+@code{GL_DST_COLOR}, @code{GL_ONE_MINUS_DST_COLOR}, @code{GL_SRC_ALPHA},
@code{GL_ONE_MINUS_SRC_ALPHA}, @code{GL_DST_ALPHA},
-@code{GL_ONE_MINUS_DST_ALPHA}. @code{GL_CONSTANT_COLOR},
+@code{GL_ONE_MINUS_DST_ALPHA}. @code{GL_CONSTANT_COLOR},
@code{GL_ONE_MINUS_CONSTANT_COLOR}, @code{GL_CONSTANT_ALPHA}, and
-@code{GL_ONE_MINUS_CONSTANT_ALPHA}. The initial value is
-@code{GL_ZERO}.
+@code{GL_ONE_MINUS_CONSTANT_ALPHA}. The initial value is @code{GL_ZERO}.
@item @var{srcAlpha}
-Specified how the alpha source blending factor is computed. The same
-symbolic constants are accepted as for @var{srcRGB}. The initial value
+Specified how the alpha source blending factor is computed. The same
+symbolic constants are accepted as for @var{srcRGB}. The initial value
is @code{GL_ONE}.
@item @var{dstAlpha}
-Specified how the alpha destination blending factor is computed. The
-same symbolic constants are accepted as for @var{dstRGB}. The initial
+Specified how the alpha destination blending factor is computed. The
+same symbolic constants are accepted as for @var{dstRGB}. The initial
value is @code{GL_ZERO}.
@end table
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 @code{glEnable} and @code{glDisable} with argument
+the frame buffer (the destination values). Blending is initially
+disabled. Use @code{glEnable} and @code{glDisable} with argument
@code{GL_BLEND} to enable and disable blending.
@code{glBlendFuncSeparate} defines the operation of blending when it is
-enabled. @var{srcRGB} specifies which method is used to scale the
-source RGB-color components. @var{dstRGB} specifies which method is
-used to scale the destination RGB-color components. Likewise,
-@var{srcAlpha} specifies which method is used to scale the source alpha
-color component, and @var{dstAlpha} specifies which method is used to
-scale the destination alpha component. The possible methods are
-described in the following table. Each method defines four scale
-factors, one each for red, green, blue, and alpha.
+enabled. @var{srcRGB} specifies which method is used to scale the source
+RGB-color components. @var{dstRGB} specifies which method is used to
+scale the destination RGB-color components. Likewise, @var{srcAlpha}
+specifies which method is used to scale the source alpha color
+component, and @var{dstAlpha} specifies which method is used to scale
+the destination alpha component. The possible methods are described in
+the following table. Each method defines four scale factors, one each
+for red, green, blue, and alpha.
In the table and in subsequent equations, source and destination color
components are referred to as
@r{(@var{R}_@var{s},@var{G}_@var{s}@var{B}_@var{s}@var{A}_@var{s})} and
-@r{(@var{R}_@var{d},@var{G}_@var{d}@var{B}_@var{d}@var{A}_@var{d})}. The
+@r{(@var{R}_@var{d},@var{G}_@var{d}@var{B}_@var{d}@var{A}_@var{d})}. The
color specified by @code{glBlendColor} is referred to as
@r{(@var{R}_@var{c},@var{G}_@var{c}@var{B}_@var{c}@var{A}_@var{c})}.
They are understood to have integer values between 0 and
Source and destination scale factors are referred to as
@r{(@var{s}_@var{R},@var{s}_@var{G}@var{s}_@var{B}@var{s}_@var{A})} and
-@r{(@var{d}_@var{R},@var{d}_@var{G}@var{d}_@var{B}@var{d}_@var{A})}. All
+@r{(@var{d}_@var{R},@var{d}_@var{G}@var{d}_@var{B}@var{d}_@var{A})}. All
scale factors have range @r{[0,1]}.
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
+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
+factor equal to 0 reduces its multiplicand to 0. For example, when
@var{srcRGB} is @code{GL_SRC_ALPHA}, @var{dstRGB} is
@code{GL_ONE_MINUS_SRC_ALPHA}, and @r{@var{A}_@var{s}} is equal to
@r{@var{k}_@var{A}}, the equations reduce to simple replacement:
@table @asis
@item @var{sfactor}
Specifies how the red, green, blue, and alpha source blending factors
-are computed. The following symbolic constants are accepted:
+are computed. The following symbolic constants are accepted:
@code{GL_ZERO}, @code{GL_ONE}, @code{GL_SRC_COLOR},
@code{GL_ONE_MINUS_SRC_COLOR}, @code{GL_DST_COLOR},
@code{GL_ONE_MINUS_DST_COLOR}, @code{GL_SRC_ALPHA},
@item @var{dfactor}
Specifies how the red, green, blue, and alpha destination blending
-factors are computed. The following symbolic constants are accepted:
+factors are computed. The following symbolic constants are accepted:
@code{GL_ZERO}, @code{GL_ONE}, @code{GL_SRC_COLOR},
@code{GL_ONE_MINUS_SRC_COLOR}, @code{GL_DST_COLOR},
@code{GL_ONE_MINUS_DST_COLOR}, @code{GL_SRC_ALPHA},
@code{GL_ONE_MINUS_SRC_ALPHA}, @code{GL_DST_ALPHA},
-@code{GL_ONE_MINUS_DST_ALPHA}. @code{GL_CONSTANT_COLOR},
+@code{GL_ONE_MINUS_DST_ALPHA}. @code{GL_CONSTANT_COLOR},
@code{GL_ONE_MINUS_CONSTANT_COLOR}, @code{GL_CONSTANT_ALPHA}, and
-@code{GL_ONE_MINUS_CONSTANT_ALPHA}. The initial value is
-@code{GL_ZERO}.
+@code{GL_ONE_MINUS_CONSTANT_ALPHA}. The initial value is @code{GL_ZERO}.
@end table
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 @code{glEnable} and @code{glDisable} with argument
+the frame buffer (the destination values). Blending is initially
+disabled. Use @code{glEnable} and @code{glDisable} with argument
@code{GL_BLEND} to enable and disable blending.
@code{glBlendFunc} defines the operation of blending when it is enabled.
@var{sfactor} specifies which method is used to scale the source color
-components. @var{dfactor} specifies which method is used to scale the
-destination color components. The possible methods are described in the
-following table. Each method defines four scale factors, one each for
-red, green, blue, and alpha. In the table and in subsequent equations,
+components. @var{dfactor} specifies which method is used to scale the
+destination color components. The possible methods are described in the
+following table. Each method defines four scale factors, one each for
+red, green, blue, and alpha. In the table and in subsequent equations,
source and destination color components are referred to as
@r{(@var{R}_@var{s},@var{G}_@var{s}@var{B}_@var{s}@var{A}_@var{s})} and
-@r{(@var{R}_@var{d},@var{G}_@var{d}@var{B}_@var{d}@var{A}_@var{d})}. The
+@r{(@var{R}_@var{d},@var{G}_@var{d}@var{B}_@var{d}@var{A}_@var{d})}. The
color specified by @code{glBlendColor} is referred to as
@r{(@var{R}_@var{c},@var{G}_@var{c}@var{B}_@var{c}@var{A}_@var{c})}.
They are understood to have integer values between 0 and
Source and destination scale factors are referred to as
@r{(@var{s}_@var{R},@var{s}_@var{G}@var{s}_@var{B}@var{s}_@var{A})} and
-@r{(@var{d}_@var{R},@var{d}_@var{G}@var{d}_@var{B}@var{d}_@var{A})}. The
+@r{(@var{d}_@var{R},@var{d}_@var{G}@var{d}_@var{B}@var{d}_@var{A})}. The
scale factors described in the table, denoted
@r{(@var{f}_@var{R},@var{f}_@var{G}@var{f}_@var{B}@var{f}_@var{A})},
-represent either source or destination factors. All scale factors have
+represent either source or destination factors. All scale factors have
range @r{[0,1]}.
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
+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
+factor equal to 0 reduces its multiplicand to 0. For example, when
@var{sfactor} is @code{GL_SRC_ALPHA}, @var{dfactor} is
@code{GL_ONE_MINUS_SRC_ALPHA}, and @r{@var{A}_@var{s}} is equal to
@r{@var{k}_@var{A}}, the equations reduce to simple replacement:
@table @asis
@item @var{target}
-Specifies the target buffer object. The symbolic constant must be
+Specifies the target buffer object. The symbolic constant must be
@code{GL_ARRAY_BUFFER}, @code{GL_ELEMENT_ARRAY_BUFFER},
@code{GL_PIXEL_PACK_BUFFER}, or @code{GL_PIXEL_UNPACK_BUFFER}.
initialization, or @code{NULL} if no data is to be copied.
@item @var{usage}
-Specifies the expected usage pattern of the data store. The symbolic
+Specifies the expected usage pattern of the data store. The symbolic
constant must be @code{GL_STREAM_DRAW}, @code{GL_STREAM_READ},
@code{GL_STREAM_COPY}, @code{GL_STATIC_DRAW}, @code{GL_STATIC_READ},
@code{GL_STATIC_COPY}, @code{GL_DYNAMIC_DRAW}, @code{GL_DYNAMIC_READ},
@end table
@code{glBufferData} creates a new data store for the buffer object
-currently bound to @var{target}. Any pre-existing data store is
-deleted. The new data store is created with the specified @var{size} in
-bytes and @var{usage}. If @var{data} is not @code{NULL}, the data store
-is initialized with data from this pointer. In its initial state, the
-new data store is not mapped, it has a @code{NULL} mapped pointer, and
-its mapped access is @code{GL_READ_WRITE}.
+currently bound to @var{target}. Any pre-existing data store is deleted.
+The new data store is created with the specified @var{size} in bytes and
+@var{usage}. If @var{data} is not @code{NULL}, the data store is
+initialized with data from this pointer. In its initial state, the new
+data store is not mapped, it has a @code{NULL} mapped pointer, and its
+mapped access is @code{GL_READ_WRITE}.
@var{usage} is a hint to the GL implementation as to how a buffer
-object's data store will be accessed. This enables the GL
-implementation to make more intelligent decisions that may significantly
-impact buffer object performance. It does not, however, constrain the
-actual usage of the data store. @var{usage} can be broken down into two
-parts: first, the frequency of access (modification and usage), and
-second, the nature of that access. The frequency of access may be one
-of these:
+object's data store will be accessed. This enables the GL implementation
+to make more intelligent decisions that may significantly impact buffer
+object performance. It does not, however, constrain the actual usage of
+the data store. @var{usage} can be broken down into two parts: first,
+the frequency of access (modification and usage), and second, the nature
+of that access. The frequency of access may be one of these:
@table @asis
@item STREAM
@table @asis
@item @var{target}
-Specifies the target buffer object. The symbolic constant must be
+Specifies the target buffer object. The symbolic constant must be
@code{GL_ARRAY_BUFFER}, @code{GL_ELEMENT_ARRAY_BUFFER},
@code{GL_PIXEL_PACK_BUFFER}, or @code{GL_PIXEL_UNPACK_BUFFER}.
@end table
@code{glBufferSubData} redefines some or all of the data store for the
-buffer object currently bound to @var{target}. Data starting at byte
+buffer object currently bound to @var{target}. Data starting at byte
offset @var{offset} and extending for @var{size} bytes is copied to the
-data store from the memory pointed to by @var{data}. An error is thrown
+data store from the memory pointed to by @var{data}. An error is thrown
if @var{offset} and @var{size} together define a range beyond the bounds
of the buffer object's data store.
Specifies the number of display lists to be executed.
@item @var{type}
-Specifies the type of values in @var{lists}. Symbolic constants
+Specifies the type of values in @var{lists}. Symbolic constants
@code{GL_BYTE}, @code{GL_UNSIGNED_BYTE}, @code{GL_SHORT},
@code{GL_UNSIGNED_SHORT}, @code{GL_INT}, @code{GL_UNSIGNED_INT},
@code{GL_FLOAT}, @code{GL_2_BYTES}, @code{GL_3_BYTES}, and
@end table
@code{glCallLists} causes each display list in the list of names passed
-as @var{lists} to be executed. As a result, the commands saved in each
+as @var{lists} 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
+using a display list. Names of display lists that have not been defined
are ignored.
@code{glCallLists} provides an efficient means for executing more than
-one display list. @var{type} allows lists with various name formats to
-be accepted. The formats are as follows:
+one display list. @var{type} allows lists with various name formats to
+be accepted. The formats are as follows:
@table @asis
@item @code{GL_BYTE}
@var{lists} is treated as an array of four-byte floating-point values.
@item @code{GL_2_BYTES}
-@var{lists} 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.
+@var{lists} 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.
@item @code{GL_3_BYTES}
-@var{lists} is treated as an array of unsigned bytes. Each triplet of
-bytes specifies a single display-list name. The value of the triplet is
+@var{lists} 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.
@item @code{GL_4_BYTES}
-@var{lists} 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.
+@var{lists} 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.
@end table
-The list of display-list names is not null-terminated. Rather, @var{n}
+The list of display-list names is not null-terminated. Rather, @var{n}
specifies how many names are to be taken from @var{lists}.
An additional level of indirection is made available with the
added to each display-list name specified in @var{lists} before that
display list is executed.
-@code{glCallLists} can appear inside a display list. To avoid the
+@code{glCallLists} 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
+during display-list execution. This limit must be at least 64, and it
depends on the implementation.
GL state is not saved and restored across a call to @code{glCallLists}.
Thus, changes made to GL state during the execution of the display lists
-remain after execution is completed. Use @code{glPushAttrib},
+remain after execution is completed. Use @code{glPushAttrib},
@code{glPopAttrib}, @code{glPushMatrix}, and @code{glPopMatrix} to
preserve GL state across @code{glCallLists} calls.
@end table
-@code{glCallList} causes the named display list to be executed. The
+@code{glCallList} 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 @var{list} has not
+they were called without using a display list. If @var{list} has not
been defined as a display list, @code{glCallList} is ignored.
-@code{glCallList} can appear inside a display list. To avoid the
+@code{glCallList} 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.
+during display-list execution. This limit is at least 64, and it depends
+on the implementation.
GL state is not saved and restored across a call to @code{glCallList}.
Thus, changes made to GL state during the execution of a display list
-remain after execution of the display list is completed. Use
+remain after execution of the display list is completed. Use
@code{glPushAttrib}, @code{glPopAttrib}, @code{glPushMatrix}, and
@code{glPopMatrix} to preserve GL state across @code{glCallList} calls.
@itemx @var{blue}
@itemx @var{alpha}
Specify the red, green, blue, and alpha values used when the
-accumulation buffer is cleared. The initial values are all 0.
+accumulation buffer is cleared. The initial values are all 0.
@end table
@itemx @var{blue}
@itemx @var{alpha}
Specify the red, green, blue, and alpha values used when the color
-buffers are cleared. The initial values are all 0.
+buffers are cleared. The initial values are all 0.
@end table
@code{glClearColor} specifies the red, green, blue, and alpha values
-used by @code{glClear} to clear the color buffers. Values specified by
+used by @code{glClear} to clear the color buffers. Values specified by
@code{glClearColor} are clamped to the range @r{[0,1]}.
@code{GL_INVALID_OPERATION} is generated if @code{glClearColor} is
@table @asis
@item @var{depth}
-Specifies the depth value used when the depth buffer is cleared. The
+Specifies the depth value used when the depth buffer is cleared. The
initial value is 1.
@end table
@code{glClearDepth} specifies the depth value used by @code{glClear} to
-clear the depth buffer. Values specified by @code{glClearDepth} are
+clear the depth buffer. Values specified by @code{glClearDepth} are
clamped to the range @r{[0,1]}.
@code{GL_INVALID_OPERATION} is generated if @code{glClearDepth} is
@table @asis
@item @var{c}
-Specifies the index used when the color index buffers are cleared. The
+Specifies the index used when the color index buffers are cleared. The
initial value is 0.
@end table
@code{glClearIndex} specifies the index used by @code{glClear} to clear
-the color index buffers. @var{c} is not clamped. Rather, @var{c} is
+the color index buffers. @var{c} is not clamped. Rather, @var{c} 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
+of the binary point. The integer part of this value is then masked with
@r{2^@var{m}-1}, where @r{@var{m}} is the number of bits in a color
index stored in the frame buffer.
@table @asis
@item @var{s}
-Specifies the index used when the stencil buffer is cleared. The
-initial value is 0.
+Specifies the index used when the stencil buffer is cleared. The initial
+value is 0.
@end table
@code{glClearStencil} specifies the index used by @code{glClear} to
-clear the stencil buffer. @var{s} is masked with @r{2^@var{m}-1}, where
+clear the stencil buffer. @var{s} is masked with @r{2^@var{m}-1}, where
@r{@var{m}} is the number of bits in the stencil buffer.
@code{GL_INVALID_OPERATION} is generated if @code{glClearStencil} is
@table @asis
@item @var{mask}
-Bitwise OR of masks that indicate the buffers to be cleared. The four
+Bitwise OR of masks that indicate the buffers to be cleared. The four
masks are @code{GL_COLOR_BUFFER_BIT}, @code{GL_DEPTH_BUFFER_BIT},
@code{GL_ACCUM_BUFFER_BIT}, and @code{GL_STENCIL_BUFFER_BIT}.
than one buffer at a time using @code{glDrawBuffer}.
The pixel ownership test, the scissor test, dithering, and the buffer
-writemasks affect the operation of @code{glClear}. The scissor box
-bounds the cleared region. Alpha function, blend function, logical
+writemasks affect the operation of @code{glClear}. The scissor box
+bounds the cleared region. Alpha function, blend function, logical
operation, stenciling, texture mapping, and depth-buffering are ignored
by @code{glClear}.
@table @asis
@item @var{texture}
-Specifies which texture unit to make active. The number of texture
-units is implementation dependent, but must be at least two.
-@var{texture} must be one of @code{GL_TEXTURE}@r{@var{i}}, where i
-ranges from 0 to the value of @code{GL_MAX_TEXTURE_COORDS} - 1, which is
-an implementation-dependent value. The initial value is
-@code{GL_TEXTURE0}.
+Specifies which texture unit to make active. The number of texture units
+is implementation dependent, but must be at least two. @var{texture}
+must be one of @code{GL_TEXTURE}@r{@var{i}}, where i ranges from 0 to
+the value of @code{GL_MAX_TEXTURE_COORDS} - 1, which is an
+implementation-dependent value. The initial value is @code{GL_TEXTURE0}.
@end table
@table @asis
@item @var{plane}
-Specifies which clipping plane is being positioned. Symbolic names of
+Specifies which clipping plane is being positioned. Symbolic names of
the form @code{GL_CLIP_PLANE}@var{i}, where @var{i} is an integer
between 0 and @code{GL_MAX_CLIP_PLANES}@r{-1}, are accepted.
@item @var{equation}
Specifies the address of an array of four double-precision
-floating-point values. These values are interpreted as a plane
-equation.
+floating-point values. These values are interpreted as a plane equation.
@end table
Geometry is always clipped against the boundaries of a six-plane frustum
-in @var{x}, @var{y}, and @var{z}. @code{glClipPlane} allows the
+in @var{x}, @var{y}, and @var{z}. @code{glClipPlane} allows the
specification of additional planes, not necessarily perpendicular to the
@var{x}, @var{y}, or @var{z} axis, against which all geometry is
-clipped. To determine the maximum number of additional clipping planes,
-call @code{glGetIntegerv} with argument @code{GL_MAX_CLIP_PLANES}. All
-implementations support at least six such clipping planes. Because the
+clipped. To determine the maximum number of additional clipping planes,
+call @code{glGetIntegerv} with argument @code{GL_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.
@code{glClipPlane} specifies a half-space using a four-component plane
-equation. When @code{glClipPlane} is called, @var{equation} is
+equation. When @code{glClipPlane} is called, @var{equation} 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
+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 @var{in} with
-respect to that clipping plane. Otherwise, it is @var{out}.
+respect to that clipping plane. Otherwise, it is @var{out}.
To enable and disable clipping planes, call @code{glEnable} and
@code{glDisable} with the argument @code{GL_CLIP_PLANE}@var{i}, where
@itemx @var{blue}
@itemx @var{alpha}
Specify whether red, green, blue, and alpha can or cannot be written
-into the frame buffer. The initial values are all @code{GL_TRUE},
+into the frame buffer. The initial values are all @code{GL_TRUE},
indicating that the color components can be written.
@end table
@code{glColorMask} specifies whether the individual color components in
-the frame buffer can or cannot be written. If @var{red} is
+the frame buffer can or cannot be written. If @var{red} is
@code{GL_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.
-Changes to individual bits of components cannot be controlled. Rather,
+Changes to individual bits of components cannot be controlled. Rather,
changes are either enabled or disabled for entire color components.
@code{GL_INVALID_OPERATION} is generated if @code{glColorMask} is
@table @asis
@item @var{face}
Specifies whether front, back, or both front and back material
-parameters should track the current color. Accepted values are
-@code{GL_FRONT}, @code{GL_BACK}, and @code{GL_FRONT_AND_BACK}. The
+parameters should track the current color. Accepted values are
+@code{GL_FRONT}, @code{GL_BACK}, and @code{GL_FRONT_AND_BACK}. The
initial value is @code{GL_FRONT_AND_BACK}.
@item @var{mode}
Specifies which of several material parameters track the current color.
Accepted values are @code{GL_EMISSION}, @code{GL_AMBIENT},
@code{GL_DIFFUSE}, @code{GL_SPECULAR}, and
-@code{GL_AMBIENT_AND_DIFFUSE}. The initial value is
+@code{GL_AMBIENT_AND_DIFFUSE}. The initial value is
@code{GL_AMBIENT_AND_DIFFUSE}.
@end table
@code{glColorMaterial} specifies which material parameters track the
-current color. When @code{GL_COLOR_MATERIAL} is enabled, the material
+current color. When @code{GL_COLOR_MATERIAL} is enabled, the material
parameter or parameters specified by @var{mode}, of the material or
materials specified by @var{face}, track the current color at all times.
@table @asis
@item @var{size}
-Specifies the number of components per color. Must be 3 or 4. The
+Specifies the number of components per color. Must be 3 or 4. The
initial value is 4.
@item @var{type}
-Specifies the data type of each color component in the array. Symbolic
+Specifies the data type of each color component in the array. Symbolic
constants @code{GL_BYTE}, @code{GL_UNSIGNED_BYTE}, @code{GL_SHORT},
@code{GL_UNSIGNED_SHORT}, @code{GL_INT}, @code{GL_UNSIGNED_INT},
-@code{GL_FLOAT}, and @code{GL_DOUBLE} are accepted. The initial value
-is @code{GL_FLOAT}.
+@code{GL_FLOAT}, and @code{GL_DOUBLE} are accepted. The initial value is
+@code{GL_FLOAT}.
@item @var{stride}
-Specifies the byte offset between consecutive colors. If @var{stride}
-is 0, the colors are understood to be tightly packed in the array. The
+Specifies the byte offset between consecutive colors. If @var{stride} is
+0, the colors are understood to be tightly packed in the array. The
initial value is 0.
@item @var{pointer}
Specifies a pointer to the first component of the first color element in
-the array. The initial value is 0.
+the array. The initial value is 0.
@end table
@code{glColorPointer} specifies the location and data format of an array
-of color components to use when rendering. @var{size} specifies the
-number of components per color, and must be 3 or 4. @var{type}
-specifies the data type of each color component, and @var{stride}
-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 @code{glInterleavedArrays}.)
+of color components to use when rendering. @var{size} specifies the
+number of components per color, and must be 3 or 4. @var{type} specifies
+the data type of each color component, and @var{stride} 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
+@code{glInterleavedArrays}.)
If a non-zero named buffer object is bound to the @code{GL_ARRAY_BUFFER}
target (see @code{glBindBuffer}) while a color array is specified,
@var{pointer} is treated as a byte offset into the buffer object's data
-store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
+store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
is saved as color vertex array client-side state
(@code{GL_COLOR_ARRAY_BUFFER_BINDING}).
The number of table entries to replace.
@item @var{format}
-The format of the pixel data in @var{data}. The allowable values are
+The format of the pixel data in @var{data}. The allowable values are
@code{GL_RED}, @code{GL_GREEN}, @code{GL_BLUE}, @code{GL_ALPHA},
@code{GL_LUMINANCE}, @code{GL_LUMINANCE_ALPHA}, @code{GL_RGB},
@code{GL_BGR}, @code{GL_RGBA}, and @code{GL_BGRA}.
@item @var{type}
-The type of the pixel data in @var{data}. The allowable values are
+The type of the pixel data in @var{data}. The allowable values are
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_UNSIGNED_SHORT},
@code{GL_SHORT}, @code{GL_UNSIGNED_INT}, @code{GL_INT}, @code{GL_FLOAT},
@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
@end table
@code{glColorSubTable} is used to respecify a contiguous portion of a
-color table previously defined using @code{glColorTable}. The pixels
+color table previously defined using @code{glColorTable}. The pixels
referenced by @var{data} replace the portion of the existing table from
-indices @var{start} to @r{@var{start}+@var{count}-1}, inclusive. This
+indices @var{start} to @r{@var{start}+@var{count}-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
+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.
If a non-zero named buffer object is bound to the
@table @asis
@item @var{target}
-The target color table. Must be @code{GL_COLOR_TABLE},
+The target color table. Must be @code{GL_COLOR_TABLE},
@code{GL_POST_CONVOLUTION_COLOR_TABLE}, or
@code{GL_POST_COLOR_MATRIX_COLOR_TABLE}.
@item @var{pname}
-The symbolic name of a texture color lookup table parameter. Must be
-one of @code{GL_COLOR_TABLE_SCALE} or @code{GL_COLOR_TABLE_BIAS}.
+The symbolic name of a texture color lookup table parameter. Must be one
+of @code{GL_COLOR_TABLE_SCALE} or @code{GL_COLOR_TABLE_BIAS}.
@item @var{params}
A pointer to an array where the values of the parameters are stored.
@code{glColorTableParameter} is used to specify the scale factors and
bias terms applied to color components when they are loaded into a color
-table. @var{target} indicates which color table the scale and bias
-terms apply to; it must be set to @code{GL_COLOR_TABLE},
+table. @var{target} indicates which color table the scale and bias terms
+apply to; it must be set to @code{GL_COLOR_TABLE},
@code{GL_POST_CONVOLUTION_COLOR_TABLE}, or
@code{GL_POST_COLOR_MATRIX_COLOR_TABLE}.
@var{pname} must be @code{GL_COLOR_TABLE_SCALE} to set the scale
-factors. In this case, @var{params} points to an array of four values,
+factors. In this case, @var{params} points to an array of four values,
which are the scale factors for red, green, blue, and alpha, in that
order.
-@var{pname} must be @code{GL_COLOR_TABLE_BIAS} to set the bias terms. In
+@var{pname} must be @code{GL_COLOR_TABLE_BIAS} to set the bias terms. In
this case, @var{params} points to an array of four values, which are the
bias terms for red, green, blue, and alpha, in that order.
@code{GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE}.
@item @var{internalformat}
-The internal format of the color table. The allowable values are
+The internal format of the color table. The allowable values are
@code{GL_ALPHA}, @code{GL_ALPHA4}, @code{GL_ALPHA8}, @code{GL_ALPHA12},
@code{GL_ALPHA16}, @code{GL_LUMINANCE}, @code{GL_LUMINANCE4},
@code{GL_LUMINANCE8}, @code{GL_LUMINANCE12}, @code{GL_LUMINANCE16},
The number of entries in the color lookup table specified by @var{data}.
@item @var{format}
-The format of the pixel data in @var{data}. The allowable values are
+The format of the pixel data in @var{data}. The allowable values are
@code{GL_RED}, @code{GL_GREEN}, @code{GL_BLUE}, @code{GL_ALPHA},
@code{GL_LUMINANCE}, @code{GL_LUMINANCE_ALPHA}, @code{GL_RGB},
@code{GL_BGR}, @code{GL_RGBA}, and @code{GL_BGRA}.
@item @var{type}
-The type of the pixel data in @var{data}. The allowable values are
+The type of the pixel data in @var{data}. The allowable values are
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_UNSIGNED_SHORT},
@code{GL_SHORT}, @code{GL_UNSIGNED_INT}, @code{GL_INT}, @code{GL_FLOAT},
@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
@code{glColorTable} 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
+or to load the contents of a color lookup table. Use the targets
@code{GL_PROXY_*} for the first case and the other targets for the
second case.
If @var{target} is @code{GL_COLOR_TABLE},
@code{GL_POST_CONVOLUTION_COLOR_TABLE}, or
@code{GL_POST_COLOR_MATRIX_COLOR_TABLE}, @code{glColorTable} builds a
-color lookup table from an array of pixels. The pixel array specified
-by @var{width}, @var{format}, @var{type}, and @var{data} is extracted
-from memory and processed just as if @code{glDrawPixels} were called,
-but processing stops after the final expansion to RGBA is completed.
+color lookup table from an array of pixels. The pixel array specified by
+@var{width}, @var{format}, @var{type}, and @var{data} is extracted from
+memory and processed just as if @code{glDrawPixels} were called, but
+processing stops after the final expansion to RGBA is completed.
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 @code{glColorTableParameter} to set
-these scale and bias parameters.)
+components of each pixel. (Use @code{glColorTableParameter} to set these
+scale and bias parameters.)
-Next, the R, G, B, and A values are clamped to the range @r{[0,1]}. Each
+Next, the R, G, B, and A values are clamped to the range @r{[0,1]}. Each
pixel is then converted to the internal format specified by
-@var{internalformat}. This conversion simply maps the component values
+@var{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
+format (red, green, blue, alpha, luminance, and intensity). The mapping
is as follows:
@end table
Finally, the red, green, blue, alpha, luminance, and/or intensity
-components of the resulting pixels are stored in the color table. They
+components of the resulting pixels are stored in the color table. They
form a one-dimensional table with indices in the range
@r{[0,@var{width}-1]}.
@code{GL_COLOR_TABLE_RED_SIZE}, @code{GL_COLOR_TABLE_GREEN_SIZE},
@code{GL_COLOR_TABLE_BLUE_SIZE}, @code{GL_COLOR_TABLE_ALPHA_SIZE},
@code{GL_COLOR_TABLE_LUMINANCE_SIZE}, and
-@code{GL_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
+@code{GL_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
+are set to zero. Otherwise, the color table could be supported by
@code{glColorTable} using the corresponding non-proxy target, and the
proxy state variables are set as if that target were being defined.
The proxy state variables can be retrieved by calling
-@code{glGetColorTableParameter} with a target of @code{GL_PROXY_*}. This
+@code{glGetColorTableParameter} with a target of @code{GL_PROXY_*}. This
allows the application to decide if a particular @code{glColorTable}
command would succeed, and to determine what the resulting color table
attributes would be.
pixel group, based on the internal format of the table.
Each pixel group has color components (R, G, B, A) that are in the range
-@r{[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
+@r{[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
+entry selected by that index. If the color components and contents of
the table are represented as follows:
When @code{GL_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
+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
-@code{GL_POST_CONVOLUTION_COLOR_TABLE} is enabled. These modified
-colors are then sent to the color matrix operation. Finally, if
+@code{GL_POST_CONVOLUTION_COLOR_TABLE} is enabled. These modified colors
+are then sent to the color matrix operation. Finally, if
@code{GL_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.
Specify new red, green, and blue values for the current color.
@item @var{alpha}
-Specifies a new alpha value for the current color. Included only in the
+Specifies a new alpha value for the current color. Included only in the
four-argument @code{glColor4} commands.
@end table
The GL stores both a current single-valued color index and a current
-four-valued RGBA color. @code{glColor} sets a new four-valued RGBA
-color. @code{glColor} has two major variants: @code{glColor3} and
-@code{glColor4}. @code{glColor3} variants specify new red, green, and
+four-valued RGBA color. @code{glColor} sets a new four-valued RGBA
+color. @code{glColor} has two major variants: @code{glColor3} and
+@code{glColor4}. @code{glColor3} variants specify new red, green, and
blue values explicitly and set the current alpha value to 1.0 (full
-intensity) implicitly. @code{glColor4} variants specify all four color
+intensity) implicitly. @code{glColor4} variants specify all four color
components explicitly.
@code{glColor3b}, @code{glColor4b}, @code{glColor3s}, @code{glColor4s},
@code{glColor3i}, and @code{glColor4i} take three or four signed byte,
-short, or long integers as arguments. When @strong{v} is appended to
-the name, the color commands can take a pointer to an array of such
-values.
+short, or long integers as arguments. When @strong{v} is appended to the
+name, the color commands can take a pointer to an array of such values.
Current color values are stored in floating-point format, with
-unspecified mantissa and exponent sizes. Unsigned integer color
+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,
+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 @r{-1.0}. (Note that this mapping does not
+representable value maps to @r{-1.0}. (Note that this mapping does not
convert 0 precisely to 0.0.) Floating-point values are mapped directly.
Neither floating-point nor signed integer values are clamped to the
-range @r{[0,1]} before the current color is updated. However, color
+range @r{[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.
stored in the shader object specified by @var{shader}.
The compilation status will be stored as part of the shader object's
-state. This value will be set to @code{GL_TRUE} if the shader was
+state. This value will be set to @code{GL_TRUE} if the shader was
compiled without errors and is ready for use, and @code{GL_FALSE}
-otherwise. It can be queried by calling @code{glGetShader} with
+otherwise. It can be queried by calling @code{glGetShader} with
arguments @var{shader} and @code{GL_COMPILE_STATUS}.
Compilation of a shader can fail for a number of reasons as specified by
-the OpenGL Shading Language Specification. Whether or not the
+the OpenGL Shading Language Specification. Whether or not the
compilation was successful, information about the compilation can be
obtained from the shader object's information log by calling
@code{glGetShaderInfoLog}.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_1D} or
+Specifies the target texture. Must be @code{GL_TEXTURE_1D} or
@code{GL_PROXY_TEXTURE_1D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{internalformat}
@var{data}.
@item @var{width}
-Specifies the width of the texture image including the border if any. If
+Specifies the width of the texture image including the border if any. If
the GL version does not support non-power-of-two sizes, this value must
-be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
+be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
implementations support texture images that are at least 64 texels wide.
The height of the 1D texture image is 1.
@item @var{border}
-Specifies the width of the border. Must be either 0 or 1.
+Specifies the width of the border. Must be either 0 or 1.
@item @var{imageSize}
Specifies the number of unsigned bytes of image data starting at the
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable one-dimensional texturing, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_1D}.
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 @code{glGetError}). To query for an entire mipmap array, use
+error (see @code{glGetError}). To query for an entire mipmap array, use
an image array level greater than or equal to 1.
@var{internalformat} must be extension-specified compressed-texture
-format. When a texture is loaded with @code{glTexImage1D} using a
+format. When a texture is loaded with @code{glTexImage1D} using a
generic compressed texture format (e.g., @code{GL_COMPRESSED_RGB}) the
-GL selects from one of its extensions supporting compressed textures. In
+GL selects from one of its extensions supporting compressed textures. In
order to load the compressed texture image using
@code{glCompressedTexImage1D}, query the compressed texture image's size
and format using @code{glGetTexLevelParameter}.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_2D},
+Specifies the target texture. Must be @code{GL_TEXTURE_2D},
@code{GL_PROXY_TEXTURE_2D}, @code{GL_TEXTURE_CUBE_MAP_POSITIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_X},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_Y},
@code{GL_PROXY_TEXTURE_CUBE_MAP}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{internalformat}
@var{data}.
@item @var{width}
-Specifies the width of the texture image including the border if any. If
+Specifies the width of the texture image including the border if any. If
the GL version does not support non-power-of-two sizes, this value must
-be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
+be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
implementations support 2D texture images that are at least 64 texels
wide and cube-mapped texture images that are at least 16 texels wide.
Specifies the height of the texture image including the border if any.
If the GL version does not support non-power-of-two sizes, this value
must be Must be @r{2^@var{n}+2(@var{border},)} for some integer
-@r{@var{n}}. All implementations support 2D texture images that are at
+@r{@var{n}}. All implementations support 2D texture images that are at
least 64 texels high and cube-mapped texture images that are at least 16
texels high.
@item @var{border}
-Specifies the width of the border. Must be either 0 or 1.
+Specifies the width of the border. Must be either 0 or 1.
@item @var{imageSize}
Specifies the number of unsigned bytes of image data starting at the
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call @code{glEnable} and
-@code{glDisable} with argument @code{GL_TEXTURE_2D}. To enable and
+@code{glDisable} with argument @code{GL_TEXTURE_2D}. To enable and
disable texturing using cube-mapped textures, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_CUBE_MAP}.
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 @code{glGetError}). To query for an entire mipmap array, use
+error (see @code{glGetError}). To query for an entire mipmap array, use
an image array level greater than or equal to 1.
@var{internalformat} must be an extension-specified compressed-texture
-format. When a texture is loaded with @code{glTexImage2D} using a
+format. When a texture is loaded with @code{glTexImage2D} using a
generic compressed texture format (e.g., @code{GL_COMPRESSED_RGB}), the
-GL selects from one of its extensions supporting compressed textures. In
+GL selects from one of its extensions supporting compressed textures. In
order to load the compressed texture image using
@code{glCompressedTexImage2D}, query the compressed texture image's size
and format using @code{glGetTexLevelParameter}.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_3D} or
+Specifies the target texture. Must be @code{GL_TEXTURE_3D} or
@code{GL_PROXY_TEXTURE_3D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{internalformat}
@var{data}.
@item @var{width}
-Specifies the width of the texture image including the border if any. If
+Specifies the width of the texture image including the border if any. If
the GL version does not support non-power-of-two sizes, this value must
-be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
+be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
implementations support 3D texture images that are at least 16 texels
wide.
texels high.
@item @var{depth}
-Specifies the depth of the texture image including the border if any. If
+Specifies the depth of the texture image including the border if any. If
the GL version does not support non-power-of-two sizes, this value must
-be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
+be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
implementations support 3D texture images that are at least 16 texels
deep.
@item @var{border}
-Specifies the width of the border. Must be either 0 or 1.
+Specifies the width of the border. Must be either 0 or 1.
@item @var{imageSize}
Specifies the number of unsigned bytes of image data starting at the
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_3D}.
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 @code{glGetError}). To query for an entire mipmap array, use
+error (see @code{glGetError}). To query for an entire mipmap array, use
an image array level greater than or equal to 1.
@var{internalformat} must be an extension-specified compressed-texture
-format. When a texture is loaded with @code{glTexImage2D} using a
+format. When a texture is loaded with @code{glTexImage2D} using a
generic compressed texture format (e.g., @code{GL_COMPRESSED_RGB}), the
-GL selects from one of its extensions supporting compressed textures. In
+GL selects from one of its extensions supporting compressed textures. In
order to load the compressed texture image using
@code{glCompressedTexImage3D}, query the compressed texture image's size
and format using @code{glGetTexLevelParameter}.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_1D}.
+Specifies the target texture. Must be @code{GL_TEXTURE_1D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{xoffset}
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable one-dimensional texturing, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_1D}.
@code{glCompressedTexSubImage1D} redefines a contiguous subregion of an
-existing one-dimensional texture image. The texels referenced by
+existing one-dimensional texture image. The texels referenced by
@var{data} replace the portion of the existing texture array with x
indices @var{xoffset} and @r{@var{xoffset}+@var{width}-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
+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.
@var{format} must be an extension-specified compressed-texture format.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_2D},
+Specifies the target texture. Must be @code{GL_TEXTURE_2D},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_X},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_Y},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_Z}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{xoffset}
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call @code{glEnable} and
-@code{glDisable} with argument @code{GL_TEXTURE_2D}. To enable and
+@code{glDisable} with argument @code{GL_TEXTURE_2D}. To enable and
disable texturing using cube-mapped texture, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_CUBE_MAP}.
@code{glCompressedTexSubImage2D} redefines a contiguous subregion of an
-existing two-dimensional texture image. The texels referenced by
+existing two-dimensional texture image. The texels referenced by
@var{data} replace the portion of the existing texture array with x
indices @var{xoffset} and @r{@var{xoffset}+@var{width}-1}, and the y
indices @var{yoffset} and @r{@var{yoffset}+@var{height}-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
+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.
@var{format} must be an extension-specified compressed-texture format.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_3D}.
+Specifies the target texture. Must be @code{GL_TEXTURE_3D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{xoffset}
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_3D}.
@code{glCompressedTexSubImage3D} redefines a contiguous subregion of an
-existing three-dimensional texture image. The texels referenced by
+existing three-dimensional texture image. The texels referenced by
@var{data} replace the portion of the existing texture array with x
indices @var{xoffset} and @r{@var{xoffset}+@var{width}-1}, and the y
indices @var{yoffset} and @r{@var{yoffset}+@var{height}-1}, and the z
indices @var{zoffset} and @r{@var{zoffset}+@var{depth}-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
+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.
@var{format} must be an extension-specified compressed-texture format.
Must be @code{GL_CONVOLUTION_1D}.
@item @var{internalformat}
-The internal format of the convolution filter kernel. The allowable
+The internal format of the convolution filter kernel. The allowable
values are @code{GL_ALPHA}, @code{GL_ALPHA4}, @code{GL_ALPHA8},
@code{GL_ALPHA12}, @code{GL_ALPHA16}, @code{GL_LUMINANCE},
@code{GL_LUMINANCE4}, @code{GL_LUMINANCE8}, @code{GL_LUMINANCE12},
The width of the pixel array referenced by @var{data}.
@item @var{format}
-The format of the pixel data in @var{data}. The allowable values are
+The format of the pixel data in @var{data}. The allowable values are
@code{GL_ALPHA}, @code{GL_LUMINANCE}, @code{GL_LUMINANCE_ALPHA},
@code{GL_INTENSITY}, @code{GL_RGB}, and @code{GL_RGBA}.
@item @var{type}
-The type of the pixel data in @var{data}. Symbolic constants
+The type of the pixel data in @var{data}. Symbolic constants
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
The R, G, B, and A components of each pixel are next scaled by the four
1D @code{GL_CONVOLUTION_FILTER_SCALE} parameters and biased by the four
-1D @code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
+1D @code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
parameters are set by @code{glConvolutionParameter} using the
@code{GL_CONVOLUTION_1D} target and the names
@code{GL_CONVOLUTION_FILTER_SCALE} and
-@code{GL_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.
+@code{GL_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.
Each pixel is then converted to the internal format specified by
-@var{internalformat}. This conversion simply maps the component values
+@var{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
+format (red, green, blue, alpha, luminance, and intensity). The mapping
is as follows:
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
+format. They form a one-dimensional filter kernel image indexed with
coordinate @var{i} such that @var{i} starts at 0 and increases from left
-to right. Kernel location @var{i} is derived from the @var{i}th pixel,
+to right. Kernel location @var{i} is derived from the @var{i}th pixel,
counting from 0.
Note that after a convolution is performed, the resulting color
@code{GL_POST_CONVOLUTION_c_SCALE} parameters and biased by their
corresponding @code{GL_POST_CONVOLUTION_c_BIAS} parameters (where
@var{c} takes on the values @strong{RED}, @strong{GREEN}, @strong{BLUE},
-and @strong{ALPHA}). These parameters are set by
-@code{glPixelTransfer}.
+and @strong{ALPHA}). These parameters are set by @code{glPixelTransfer}.
@code{GL_INVALID_ENUM} is generated if @var{target} is not
@code{GL_CONVOLUTION_1D}.
allowable values.
@code{GL_INVALID_VALUE} is generated if @var{width} is less than zero or
-greater than the maximum supported value. This value may be queried
-with @code{glGetConvolutionParameter} using target
-@code{GL_CONVOLUTION_1D} and name @code{GL_MAX_CONVOLUTION_WIDTH}.
+greater than the maximum supported value. This value may be queried with
+@code{glGetConvolutionParameter} using target @code{GL_CONVOLUTION_1D}
+and name @code{GL_MAX_CONVOLUTION_WIDTH}.
@code{GL_INVALID_OPERATION} is generated if @var{format} is one of
@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
Must be @code{GL_CONVOLUTION_2D}.
@item @var{internalformat}
-The internal format of the convolution filter kernel. The allowable
+The internal format of the convolution filter kernel. The allowable
values are @code{GL_ALPHA}, @code{GL_ALPHA4}, @code{GL_ALPHA8},
@code{GL_ALPHA12}, @code{GL_ALPHA16}, @code{GL_LUMINANCE},
@code{GL_LUMINANCE4}, @code{GL_LUMINANCE8}, @code{GL_LUMINANCE12},
The height of the pixel array referenced by @var{data}.
@item @var{format}
-The format of the pixel data in @var{data}. The allowable values are
+The format of the pixel data in @var{data}. The allowable values are
@code{GL_RED}, @code{GL_GREEN}, @code{GL_BLUE}, @code{GL_ALPHA},
@code{GL_RGB}, @code{GL_BGR}, @code{GL_RGBA}, @code{GL_BGRA},
@code{GL_LUMINANCE}, and @code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-The type of the pixel data in @var{data}. Symbolic constants
+The type of the pixel data in @var{data}. Symbolic constants
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
The R, G, B, and A components of each pixel are next scaled by the four
2D @code{GL_CONVOLUTION_FILTER_SCALE} parameters and biased by the four
-2D @code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
+2D @code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
parameters are set by @code{glConvolutionParameter} using the
@code{GL_CONVOLUTION_2D} target and the names
@code{GL_CONVOLUTION_FILTER_SCALE} and
-@code{GL_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.
+@code{GL_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.
Each pixel is then converted to the internal format specified by
-@var{internalformat}. This conversion simply maps the component values
+@var{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
+format (red, green, blue, alpha, luminance, and intensity). The mapping
is as follows:
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
+format. They form a two-dimensional filter kernel image indexed with
coordinates @var{i} and @var{j} such that @var{i} starts at zero and
increases from left to right, and @var{j} starts at zero and increases
-from bottom to top. Kernel location @var{i,j} is derived from the
+from bottom to top. Kernel location @var{i,j} is derived from the
@var{N}th pixel, where @var{N} is @var{i}+@var{j}*@var{width}.
Note that after a convolution is performed, the resulting color
@code{GL_POST_CONVOLUTION_c_SCALE} parameters and biased by their
corresponding @code{GL_POST_CONVOLUTION_c_BIAS} parameters (where
@var{c} takes on the values @strong{RED}, @strong{GREEN}, @strong{BLUE},
-and @strong{ALPHA}). These parameters are set by
-@code{glPixelTransfer}.
+and @strong{ALPHA}). These parameters are set by @code{glPixelTransfer}.
@code{GL_INVALID_ENUM} is generated if @var{target} is not
@code{GL_CONVOLUTION_2D}.
allowable values.
@code{GL_INVALID_VALUE} is generated if @var{width} is less than zero or
-greater than the maximum supported value. This value may be queried
-with @code{glGetConvolutionParameter} using target
-@code{GL_CONVOLUTION_2D} and name @code{GL_MAX_CONVOLUTION_WIDTH}.
+greater than the maximum supported value. This value may be queried with
+@code{glGetConvolutionParameter} using target @code{GL_CONVOLUTION_2D}
+and name @code{GL_MAX_CONVOLUTION_WIDTH}.
@code{GL_INVALID_VALUE} is generated if @var{height} is less than zero
-or greater than the maximum supported value. This value may be queried
+or greater than the maximum supported value. This value may be queried
with @code{glGetConvolutionParameter} using target
@code{GL_CONVOLUTION_2D} and name @code{GL_MAX_CONVOLUTION_HEIGHT}.
@table @asis
@item @var{target}
-The target for the convolution parameter. Must be one of
+The target for the convolution parameter. Must be one of
@code{GL_CONVOLUTION_1D}, @code{GL_CONVOLUTION_2D}, or
@code{GL_SEPARABLE_2D}.
@item @var{pname}
-The parameter to be set. Must be @code{GL_CONVOLUTION_BORDER_MODE}.
+The parameter to be set. Must be @code{GL_CONVOLUTION_BORDER_MODE}.
@item @var{params}
-The parameter value. Must be one of @code{GL_REDUCE},
+The parameter value. Must be one of @code{GL_REDUCE},
@code{GL_CONSTANT_BORDER}, @code{GL_REPLICATE_BORDER}.
@code{GL_CONVOLUTION_FILTER_SCALE} and @code{GL_CONVOLUTION_FILTER_BIAS}
affect the definition of the convolution filter kernel; see
@code{glConvolutionFilter1D}, @code{glConvolutionFilter2D}, and
-@code{glSeparableFilter2D} for details. In these cases, @var{params}v
-is an array of four values to be applied to red, green, blue, and alpha
-values, respectively. The initial value for
+@code{glSeparableFilter2D} for details. In these cases, @var{params}v is
+an array of four values to be applied to red, green, blue, and alpha
+values, respectively. The initial value for
@code{GL_CONVOLUTION_FILTER_SCALE} is (1, 1, 1, 1), and the initial
value for @code{GL_CONVOLUTION_FILTER_BIAS} is (0, 0, 0, 0).
A @var{pname} value of @code{GL_CONVOLUTION_BORDER_MODE} controls the
-convolution border mode. The accepted modes are:
+convolution border mode. The accepted modes are:
@table @asis
@item @code{GL_REDUCE}
If the filter width is @r{@var{Wf}} and height is @r{@var{Hf}}, and the
source image width is @r{@var{Ws}} and height is @r{@var{Hs}}, then the
convolved image width will be @r{@var{Ws}-@var{Wf}+1} and height will be
-@r{@var{Hs}-@var{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
+@r{@var{Hs}-@var{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 @r{@var{Ws}-@var{Wf}} in width and zero
through @r{@var{Hs}-@var{Hf}} in height.
@end table
@code{glCopyColorSubTable} is used to respecify a contiguous portion of
-a color table previously defined using @code{glColorTable}. The pixels
+a color table previously defined using @code{glColorTable}. The pixels
copied from the framebuffer replace the portion of the existing table
-from indices @var{start} to @r{@var{start}+@var{x}-1}, inclusive. This
+from indices @var{start} to @r{@var{start}+@var{x}-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
+as was originally specified. It is not an error to specify a subtexture
with width of 0, but such a specification has no effect.
@code{GL_INVALID_VALUE} is generated if @var{target} is not a previously
@table @asis
@item @var{target}
-The color table target. Must be @code{GL_COLOR_TABLE},
+The color table target. Must be @code{GL_COLOR_TABLE},
@code{GL_POST_CONVOLUTION_COLOR_TABLE}, or
@code{GL_POST_COLOR_MATRIX_COLOR_TABLE}.
@item @var{internalformat}
-The internal storage format of the texture image. Must be one of the
+The internal storage format of the texture image. Must be one of the
following symbolic constants: @code{GL_ALPHA}, @code{GL_ALPHA4},
@code{GL_ALPHA8}, @code{GL_ALPHA12}, @code{GL_ALPHA16},
@code{GL_LUMINANCE}, @code{GL_LUMINANCE4}, @code{GL_LUMINANCE8},
The screen-aligned pixel rectangle with lower-left corner at (@var{x},\
@var{y}) having width @var{width} and height 1 is loaded into the color
-table. If any pixels within this region are outside the window that is
+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.
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
+components of each pixel. The scale and bias parameters are set by
calling @code{glColorTableParameter}.
-Next, the R, G, B, and A values are clamped to the range @r{[0,1]}. Each
+Next, the R, G, B, and A values are clamped to the range @r{[0,1]}. Each
pixel is then converted to the internal format specified by
-@var{internalformat}. This conversion simply maps the component values
+@var{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
+format (red, green, blue, alpha, luminance, and intensity). The mapping
is as follows:
@end table
Finally, the red, green, blue, alpha, luminance, and/or intensity
-components of the resulting pixels are stored in the color table. They
+components of the resulting pixels are stored in the color table. They
form a one-dimensional table with indices in the range
@r{[0,@var{width}-1]}.
Must be @code{GL_CONVOLUTION_1D}.
@item @var{internalformat}
-The internal format of the convolution filter kernel. The allowable
+The internal format of the convolution filter kernel. The allowable
values are @code{GL_ALPHA}, @code{GL_ALPHA4}, @code{GL_ALPHA8},
@code{GL_ALPHA12}, @code{GL_ALPHA16}, @code{GL_LUMINANCE},
@code{GL_LUMINANCE4}, @code{GL_LUMINANCE8}, @code{GL_LUMINANCE12},
The screen-aligned pixel rectangle with lower-left corner at (@var{x},\
@var{y}), width @var{width} and height 1 is used to define the
-convolution filter. If any pixels within this region are outside 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.
The pixels in the rectangle are processed exactly as if
@code{glReadPixels} had been called with @var{format} set to RGBA, but
-the process stops just before final conversion. The R, G, B, and A
+the process stops just before final conversion. The R, G, B, and A
components of each pixel are next scaled by the four 1D
@code{GL_CONVOLUTION_FILTER_SCALE} parameters and biased by the four 1D
-@code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
+@code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
parameters are set by @code{glConvolutionParameter} using the
@code{GL_CONVOLUTION_1D} target and the names
@code{GL_CONVOLUTION_FILTER_SCALE} and
-@code{GL_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.
+@code{GL_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.
Each pixel is then converted to the internal format specified by
-@var{internalformat}. This conversion simply maps the component values
+@var{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
+format (red, green, blue, alpha, luminance, and intensity). The mapping
is as follows:
@code{GL_POST_CONVOLUTION_c_SCALE} parameters and biased by their
corresponding @code{GL_POST_CONVOLUTION_c_BIAS} parameters (where
@var{c} takes on the values @strong{RED}, @strong{GREEN}, @strong{BLUE},
-and @strong{ALPHA}). These parameters are set by
-@code{glPixelTransfer}.
+and @strong{ALPHA}). These parameters are set by @code{glPixelTransfer}.
@code{GL_INVALID_ENUM} is generated if @var{target} is not
@code{GL_CONVOLUTION_1D}.
of the allowable values.
@code{GL_INVALID_VALUE} is generated if @var{width} is less than zero or
-greater than the maximum supported value. This value may be queried
-with @code{glGetConvolutionParameter} using target
-@code{GL_CONVOLUTION_1D} and name @code{GL_MAX_CONVOLUTION_WIDTH}.
+greater than the maximum supported value. This value may be queried with
+@code{glGetConvolutionParameter} using target @code{GL_CONVOLUTION_1D}
+and name @code{GL_MAX_CONVOLUTION_WIDTH}.
@code{GL_INVALID_OPERATION} is generated if
@code{glCopyConvolutionFilter1D} is executed between the execution of
Must be @code{GL_CONVOLUTION_2D}.
@item @var{internalformat}
-The internal format of the convolution filter kernel. The allowable
+The internal format of the convolution filter kernel. The allowable
values are @code{GL_ALPHA}, @code{GL_ALPHA4}, @code{GL_ALPHA8},
@code{GL_ALPHA12}, @code{GL_ALPHA16}, @code{GL_LUMINANCE},
@code{GL_LUMINANCE4}, @code{GL_LUMINANCE8}, @code{GL_LUMINANCE12},
The screen-aligned pixel rectangle with lower-left corner at (@var{x},\
@var{y}), width @var{width} and height @var{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.
+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.
The pixels in the rectangle are processed exactly as if
@code{glReadPixels} had been called with @var{format} set to RGBA, but
-the process stops just before final conversion. The R, G, B, and A
+the process stops just before final conversion. The R, G, B, and A
components of each pixel are next scaled by the four 2D
@code{GL_CONVOLUTION_FILTER_SCALE} parameters and biased by the four 2D
-@code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
+@code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
parameters are set by @code{glConvolutionParameter} using the
@code{GL_CONVOLUTION_2D} target and the names
@code{GL_CONVOLUTION_FILTER_SCALE} and
-@code{GL_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.
+@code{GL_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.
Each pixel is then converted to the internal format specified by
-@var{internalformat}. This conversion simply maps the component values
+@var{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
+format (red, green, blue, alpha, luminance, and intensity). The mapping
is as follows:
@code{GL_POST_CONVOLUTION_c_SCALE} parameters and biased by their
corresponding @code{GL_POST_CONVOLUTION_c_BIAS} parameters (where
@var{c} takes on the values @strong{RED}, @strong{GREEN}, @strong{BLUE},
-and @strong{ALPHA}). These parameters are set by
-@code{glPixelTransfer}.
+and @strong{ALPHA}). These parameters are set by @code{glPixelTransfer}.
@code{GL_INVALID_ENUM} is generated if @var{target} is not
@code{GL_CONVOLUTION_2D}.
of the allowable values.
@code{GL_INVALID_VALUE} is generated if @var{width} is less than zero or
-greater than the maximum supported value. This value may be queried
-with @code{glGetConvolutionParameter} using target
-@code{GL_CONVOLUTION_2D} and name @code{GL_MAX_CONVOLUTION_WIDTH}.
+greater than the maximum supported value. This value may be queried with
+@code{glGetConvolutionParameter} using target @code{GL_CONVOLUTION_2D}
+and name @code{GL_MAX_CONVOLUTION_WIDTH}.
@code{GL_INVALID_VALUE} is generated if @var{height} is less than zero
-or greater than the maximum supported value. This value may be queried
+or greater than the maximum supported value. This value may be queried
with @code{glGetConvolutionParameter} using target
@code{GL_CONVOLUTION_2D} and name @code{GL_MAX_CONVOLUTION_HEIGHT}.
@item @var{type}
Specifies whether color values, depth values, or stencil values are to
-be copied. Symbolic constants @code{GL_COLOR}, @code{GL_DEPTH}, and
+be copied. Symbolic constants @code{GL_COLOR}, @code{GL_DEPTH}, and
@code{GL_STENCIL} are accepted.
@end table
@code{glCopyPixels} 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
+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.
@var{x} and @var{y} specify the window coordinates of the lower left
-corner of the rectangular region to be copied. @var{width} and
+corner of the rectangular region to be copied. @var{width} and
@var{height} specify the dimensions of the rectangular region to be
-copied. Both @var{width} and @var{height} must not be negative.
+copied. Both @var{width} and @var{height} must not be negative.
Several parameters control the processing of the pixel data while it is
-being copied. These parameters are set with three commands:
-@code{glPixelTransfer}, @code{glPixelMap}, and @code{glPixelZoom}. This
+being copied. These parameters are set with three commands:
+@code{glPixelTransfer}, @code{glPixelMap}, and @code{glPixelZoom}. This
reference page describes the effects on @code{glCopyPixels} of most, but
not all, of the parameters specified by these three commands.
@code{glCopyPixels} copies values from each pixel with the lower
left-hand corner at @r{(@var{x}+@var{i},@var{y}+@var{j})} for
-@r{0<=@var{i}<@var{width}} and @r{0<=@var{j}<@var{height}}. This pixel
-is said to be the @r{@var{i}}th pixel in the @r{@var{j}}th row. Pixels
+@r{0<=@var{i}<@var{width}} and @r{0<=@var{j}<@var{height}}. This pixel
+is said to be the @r{@var{i}}th pixel in the @r{@var{j}}th row. Pixels
are copied in row order from the lowest to the highest row, left to
right in each row.
@var{type} specifies whether color, depth, or stencil data is to be
-copied. The details of the transfer for each data type are as follows:
+copied. The details of the transfer for each data type are as follows:
@table @asis
@item @code{GL_COLOR}
Indices or RGBA colors are read from the buffer currently specified as
-the read source buffer (see @code{glReadBuffer}). If the GL is in color
+the read source buffer (see @code{glReadBuffer}). 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
-@code{GL_INDEX_SHIFT} bits, and added to @code{GL_INDEX_OFFSET}. If
-@code{GL_INDEX_SHIFT} is negative, the shift is to the right. In either
+the binary point. Each index is then shifted left by
+@code{GL_INDEX_SHIFT} bits, and added to @code{GL_INDEX_OFFSET}. If
+@code{GL_INDEX_SHIFT} is negative, the shift is to the right. In either
case, zero bits fill otherwise unspecified bit locations in the result.
If @code{GL_MAP_COLOR} is true, the index is replaced with the value
-that it references in lookup table @code{GL_PIXEL_MAP_I_TO_I}. Whether
+that it references in lookup table @code{GL_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 @r{2^@var{b}-1}, where @r{@var{b}} is the
number of bits in a color index buffer.
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
+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
@code{GL_c_SCALE} and added to @code{GL_c_BIAS}, where @var{c} is RED,
-GREEN, BLUE, and ALPHA for the respective color components. The results
-are clamped to the range [0,1]. If @code{GL_MAP_COLOR} is true, each
+GREEN, BLUE, and ALPHA for the respective color components. The results
+are clamped to the range [0,1]. If @code{GL_MAP_COLOR} is true, each
color component is scaled by the size of lookup table
@code{GL_PIXEL_MAP_c_TO_c}, then replaced by the value that it
-references in that table. @var{c} is R, G, B, or A.
+references in that table. @var{c} is R, G, B, or A.
If the @code{ARB_imaging} extension is supported, the color values may
be additionally processed by color-table lookups, color-matrix
@r{(@var{x}_@var{r},@var{y}_@var{r})} is the current raster position,
and the pixel was the @r{@var{i}}th pixel in the @r{@var{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.
+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.
@item @code{GL_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
-@code{GL_DEPTH_SCALE} and added to @code{GL_DEPTH_BIAS}. The result is
-clamped to the range [0,1].
+internal floating-point format with unspecified precision. The resulting
+floating-point depth value is then multiplied by @code{GL_DEPTH_SCALE}
+and added to @code{GL_DEPTH_BIAS}. The result is clamped to the range
+[0,1].
The GL then converts the resulting depth components to fragments by
attaching the current raster position color or color index and texture
@r{(@var{x}_@var{r},@var{y}_@var{r})} is the current raster position,
and the pixel was the @r{@var{i}}th pixel in the @r{@var{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.
+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.
@item @code{GL_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 @code{GL_INDEX_SHIFT} bits, and added to @code{GL_INDEX_OFFSET}. If
-@code{GL_INDEX_SHIFT} is negative, the shift is to the right. In either
+right of the binary point. Each fixed-point index is then shifted left
+by @code{GL_INDEX_SHIFT} bits, and added to @code{GL_INDEX_OFFSET}. If
+@code{GL_INDEX_SHIFT} is negative, the shift is to the right. In either
case, zero bits fill otherwise unspecified bit locations in the result.
If @code{GL_MAP_STENCIL} is true, the index is replaced with the value
-that it references in lookup table @code{GL_PIXEL_MAP_S_TO_S}. Whether
+that it references in lookup table @code{GL_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 @r{2^@var{b}-1}, where @r{@var{b}} is the
-number of bits in the stencil buffer. The resulting stencil indices are
+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
@r{@var{i}}th location of the @r{@var{j}}th row is written to location
@r{(@var{x}_@var{r}+@var{i},@var{y}_@var{r}+@var{j})}, where
The rasterization described thus far assumes pixel zoom factors of 1.0.
If @code{glPixelZoom} is used to change the @r{@var{x}} and @r{@var{y}}
-pixel zoom factors, pixels are converted to fragments as follows. If
+pixel zoom factors, pixels are converted to fragments as follows. If
@r{(@var{x}_@var{r},@var{y}_@var{r})} is the current raster position,
and a given pixel is in the @r{@var{i}}th location in the @r{@var{j}}th
row of the source pixel rectangle, then fragments are generated for
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_1D}.
+Specifies the target texture. Must be @code{GL_TEXTURE_1D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{internalformat}
-Specifies the internal format of the texture. Must be one of the
+Specifies the internal format of the texture. Must be one of the
following symbolic constants: @code{GL_ALPHA}, @code{GL_ALPHA4},
@code{GL_ALPHA8}, @code{GL_ALPHA12}, @code{GL_ALPHA16},
@code{GL_COMPRESSED_ALPHA}, @code{GL_COMPRESSED_LUMINANCE},
to be copied.
@item @var{width}
-Specifies the width of the texture image. Must be 0 or
-@r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. The
-height of the texture image is 1.
+Specifies the width of the texture image. Must be 0 or
+@r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. The height
+of the texture image is 1.
@item @var{border}
-Specifies the width of the border. Must be either 0 or 1.
+Specifies the width of the border. Must be either 0 or 1.
@end table
@var{internalformat} specifies the internal format of the texture array.
The pixels in the row are processed exactly as if @code{glCopyPixels}
-had been called, but the process stops just before final conversion. At
+had been called, but the process stops just before final conversion. At
this point all pixel component values are clamped to the range @r{[0,1]}
and then converted to the texture's internal format for storage in the
texel array.
pixels from the current @code{GL_READ_BUFFER}.
When @var{internalformat} is one of the sRGB types, the GL does not
-automatically convert the source pixels to the sRGB color space. In
-this case, the @code{glPixelMap} function can be used to accomplish the
+automatically convert the source pixels to the sRGB color space. In this
+case, the @code{glPixelMap} function can be used to accomplish the
conversion.
@code{GL_INVALID_ENUM} is generated if @var{target} is not one of the
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_2D},
+Specifies the target texture. Must be @code{GL_TEXTURE_2D},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_X},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_Y},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_Z}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{internalformat}
-Specifies the internal format of the texture. Must be one of the
+Specifies the internal format of the texture. Must be one of the
following symbolic constants: @code{GL_ALPHA}, @code{GL_ALPHA4},
@code{GL_ALPHA8}, @code{GL_ALPHA12}, @code{GL_ALPHA16},
@code{GL_COMPRESSED_ALPHA}, @code{GL_COMPRESSED_LUMINANCE},
rectangular region of pixels to be copied.
@item @var{width}
-Specifies the width of the texture image. Must be 0 or
+Specifies the width of the texture image. Must be 0 or
@r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}.
@item @var{height}
-Specifies the height of the texture image. Must be 0 or
+Specifies the height of the texture image. Must be 0 or
@r{2^@var{m}+2(@var{border},)} for some integer @r{@var{m}}.
@item @var{border}
-Specifies the width of the border. Must be either 0 or 1.
+Specifies the width of the border. Must be either 0 or 1.
@end table
The screen-aligned pixel rectangle with lower left corner at (@var{x},
@var{y}) and with a width of @r{@var{width}+2(@var{border},)} and a
height of @r{@var{height}+2(@var{border},)} defines the texture array
-at the mipmap level specified by @var{level}. @var{internalformat}
+at the mipmap level specified by @var{level}. @var{internalformat}
specifies the internal format of the texture array.
The pixels in the rectangle are processed exactly as if
@code{glCopyPixels} had been called, but the process stops just before
-final conversion. At this point all pixel component values are clamped
+final conversion. At this point all pixel component values are clamped
to the range @r{[0,1]} and then converted to the texture's internal
format for storage in the texel array.
undefined.
When @var{internalformat} is one of the sRGB types, the GL does not
-automatically convert the source pixels to the sRGB color space. In
-this case, the @code{glPixelMap} function can be used to accomplish the
+automatically convert the source pixels to the sRGB color space. In this
+case, the @code{glPixelMap} function can be used to accomplish the
conversion.
@code{GL_INVALID_ENUM} is generated if @var{target} is not
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_1D}.
+Specifies the target texture. Must be @code{GL_TEXTURE_1D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{xoffset}
The screen-aligned pixel row with left corner at (@var{x},\ @var{y}),
and with length @var{width} replaces the portion of the texture array
with x indices @var{xoffset} through @r{@var{xoffset}+@var{width}-1},
-inclusive. The destination in the texture array may not include any
+inclusive. The destination in the texture array may not include any
texels outside the texture array as it was originally specified.
The pixels in the row are processed exactly as if @code{glCopyPixels}
-had been called, but the process stops just before final conversion. At
+had been called, but the process stops just before final conversion. At
this point, all pixel component values are clamped to the range
@r{[0,1]} and then converted to the texture's internal format for
storage in the texel array.
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
+specification has no effect. If any of the pixels within the specified
row of the current @code{GL_READ_BUFFER} are outside the read window
associated with the current rendering context, then the values obtained
for those pixels are undefined.
@code{GL_INVALID_VALUE} is generated if @r{@var{xoffset}<-@var{b}}, or
@r{(@var{xoffset}+@var{width},)>(@var{w}-@var{b},)}, where @r{@var{w}}
is the @code{GL_TEXTURE_WIDTH} and @r{@var{b}} is the
-@code{GL_TEXTURE_BORDER} of the texture image being modified. Note that
+@code{GL_TEXTURE_BORDER} of the texture image being modified. Note that
@r{@var{w}} includes twice the border width.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_2D},
+Specifies the target texture. Must be @code{GL_TEXTURE_2D},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_X},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_Y},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_Z}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{xoffset}
The pixels in the rectangle are processed exactly as if
@code{glCopyPixels} had been called, but the process stops just before
-final conversion. At this point, all pixel component values are clamped
+final conversion. At this point, all pixel component values are clamped
to the range @r{[0,1]} and then converted to the texture's internal
format for storage in the texel array.
The destination rectangle in the texture array may not include any
-texels outside the texture array as it was originally specified. It is
+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.
@r{(@var{yoffset}+@var{height},)>(@var{h}-@var{b},)}, where @r{@var{w}}
is the @code{GL_TEXTURE_WIDTH}, @r{@var{h}} is the
@code{GL_TEXTURE_HEIGHT}, and @r{@var{b}} is the
-@code{GL_TEXTURE_BORDER} of the texture image being modified. Note that
+@code{GL_TEXTURE_BORDER} of the texture image being modified. Note that
@r{@var{w}} and @r{@var{h}} include twice the border width.
@code{GL_INVALID_OPERATION} is generated if @code{glCopyTexSubImage2D}
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_3D}
+Specifies the target texture. Must be @code{GL_TEXTURE_3D}
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{xoffset}
The pixels in the rectangle are processed exactly as if
@code{glCopyPixels} had been called, but the process stops just before
-final conversion. At this point, all pixel component values are clamped
+final conversion. At this point, all pixel component values are clamped
to the range @r{[0,1]} and then converted to the texture's internal
format for storage in the texel array.
The destination rectangle in the texture array may not include any
-texels outside the texture array as it was originally specified. It is
+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.
@r{(@var{zoffset}+1,)>(@var{d}-@var{b},)}, where @r{@var{w}} is the
@code{GL_TEXTURE_WIDTH}, @r{@var{h}} is the @code{GL_TEXTURE_HEIGHT},
@r{@var{d}} is the @code{GL_TEXTURE_DEPTH}, and @r{@var{b}} is the
-@code{GL_TEXTURE_BORDER} of the texture image being modified. Note that
+@code{GL_TEXTURE_BORDER} of the texture image being modified. Note that
@r{@var{w}}, @r{@var{h}}, and @r{@var{d}} include twice the border
width.
Creates a program object.
@code{glCreateProgram} creates an empty program object and returns a
-non-zero value by which it can be referenced. A program object is an
-object to which shader objects can be attached. This provides a
+non-zero value by which it can be referenced. A program object is an
+object to which shader objects can be attached. This provides a
mechanism to specify the shader objects that will be linked to create a
-program. It also provides a means for checking the compatibility of the
+program. It also provides a means for checking the compatibility of the
shaders that will be used to create a program (for instance, checking
-the compatibility between a vertex shader and a fragment shader). When
+the compatibility between a vertex shader and a fragment shader). When
no longer needed as part of a program object, shader objects can be
detached.
One or more executables are created in a program object by successfully
attaching shader objects to it with @code{glAttachShader}, successfully
compiling the shader objects with @code{glCompileShader}, and
-successfully linking the program object with @code{glLinkProgram}. These
+successfully linking the program object with @code{glLinkProgram}. These
executables are made part of current state when @code{glUseProgram} is
-called. Program objects can be deleted by calling
-@code{glDeleteProgram}. The memory associated with the program object
+called. Program objects can be deleted by calling
+@code{glDeleteProgram}. The memory associated with the program object
will be deleted when it is no longer part of current rendering state for
any context.
@table @asis
@item @var{shaderType}
-Specifies the type of shader to be created. Must be either
+Specifies the type of shader to be created. Must be either
@code{GL_VERTEX_SHADER} or @code{GL_FRAGMENT_SHADER}.
@end table
@code{glCreateShader} creates an empty shader object and returns a
-non-zero value by which it can be referenced. A shader object is used
-to maintain the source code strings that define a shader.
-@var{shaderType} indicates the type of shader to be created. Two types
-of shaders are supported. A shader of type @code{GL_VERTEX_SHADER} is a
-shader that is intended to run on the programmable vertex processor and
-replace the fixed functionality vertex processing in OpenGL. A shader
-of type @code{GL_FRAGMENT_SHADER} is a shader that is intended to run on
-the programmable fragment processor and replace the fixed functionality
+non-zero value by which it can be referenced. A shader object is used to
+maintain the source code strings that define a shader. @var{shaderType}
+indicates the type of shader to be created. Two types of shaders are
+supported. A shader of type @code{GL_VERTEX_SHADER} is a shader that is
+intended to run on the programmable vertex processor and replace the
+fixed functionality vertex processing in OpenGL. A shader of type
+@code{GL_FRAGMENT_SHADER} is a shader that is intended to run on the
+programmable fragment processor and replace the fixed functionality
fragment processing in OpenGL.
When created, a shader object's @code{GL_SHADER_TYPE} parameter is set
@table @asis
@item @var{mode}
Specifies whether front- or back-facing facets are candidates for
-culling. Symbolic constants @code{GL_FRONT}, @code{GL_BACK}, and
-@code{GL_FRONT_AND_BACK} are accepted. The initial value is
+culling. Symbolic constants @code{GL_FRONT}, @code{GL_BACK}, and
+@code{GL_FRONT_AND_BACK} are accepted. The initial value is
@code{GL_BACK}.
@end table
@code{glCullFace} specifies whether front- or back-facing facets are
-culled (as specified by @var{mode}) when facet culling is enabled. Facet
-culling is initially disabled. To enable and disable facet culling,
-call the @code{glEnable} and @code{glDisable} commands with the argument
-@code{GL_CULL_FACE}. Facets include triangles, quadrilaterals,
-polygons, and rectangles.
+culled (as specified by @var{mode}) when facet culling is enabled. Facet
+culling is initially disabled. To enable and disable facet culling, call
+the @code{glEnable} and @code{glDisable} commands with the argument
+@code{GL_CULL_FACE}. Facets include triangles, quadrilaterals, polygons,
+and rectangles.
@code{glFrontFace} specifies which of the clockwise and counterclockwise
-facets are front-facing and back-facing. See @code{glFrontFace}.
+facets are front-facing and back-facing. See @code{glFrontFace}.
@code{GL_INVALID_ENUM} is generated if @var{mode} is not an accepted
value.
@end table
@code{glDeleteBuffers} deletes @var{n} buffer objects named by the
-elements of the array @var{buffers}. After a buffer object is deleted,
+elements of the array @var{buffers}. After a buffer object is deleted,
it has no contents, and its name is free for reuse (for example by
-@code{glGenBuffers}). If a buffer object that is currently bound is
+@code{glGenBuffers}). If a buffer object that is currently bound is
deleted, the binding reverts to 0 (the absence of any buffer object,
which reverts to client memory usage).
@end table
@code{glDeleteLists} causes a contiguous group of display lists to be
-deleted. @var{list} is the name of the first display list to be
-deleted, and @var{range} is the number of display lists to delete. All
-display lists @r{@var{d}} with
-@r{@var{list}<=@var{d}<=@var{list}+@var{range}-1} are deleted.
+deleted. @var{list} is the name of the first display list to be deleted,
+and @var{range} is the number of display lists to delete. All display
+lists @r{@var{d}} with @r{@var{list}<=@var{d}<=@var{list}+@var{range}-1}
+are deleted.
All storage locations allocated to the specified display lists are
-freed, and the names are available for reuse at a later time. Names
+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 @var{range} is 0, nothing happens.
+ignored. If @var{range} is 0, nothing happens.
@code{GL_INVALID_VALUE} is generated if @var{range} is negative.
If a program object is in use as part of current rendering state, it
will be flagged for deletion, but it will not be deleted until it is no
-longer part of current state for any rendering context. If a program
+longer part of current state for any rendering context. If a program
object to be deleted has shader objects attached to it, those shader
objects will be automatically detached but not deleted unless they have
already been flagged for deletion by a previous call to
-@code{glDeleteShader}. A value of 0 for @var{program} will be silently
+@code{glDeleteShader}. A value of 0 for @var{program} will be silently
ignored.
To determine whether a program object has been flagged for deletion,
@end table
@code{glDeleteQueries} deletes @var{n} query objects named by the
-elements of the array @var{ids}. After a query object is deleted, it
-has no contents, and its name is free for reuse (for example by
+elements of the array @var{ids}. After a query object is deleted, it has
+no contents, and its name is free for reuse (for example by
@code{glGenQueries}).
@code{glDeleteQueries} silently ignores 0's and names that do not
@end table
@code{glDeleteShader} frees the memory and invalidates the name
-associated with the shader object specified by @var{shader}. This
+associated with the shader object specified by @var{shader}. This
command effectively undoes the effects of a call to
@code{glCreateShader}.
will be flagged for deletion, but it will not be deleted until it is no
longer attached to any program object, for any rendering context (i.e.,
it must be detached from wherever it was attached before it will be
-deleted). A value of 0 for @var{shader} will be silently ignored.
+deleted). A value of 0 for @var{shader} will be silently ignored.
To determine whether an object has been flagged for deletion, call
@code{glGetShader} with arguments @var{shader} and
@end table
@code{glDeleteTextures} deletes @var{n} textures named by the elements
-of the array @var{textures}. After a texture is deleted, it has no
+of the array @var{textures}. After a texture is deleted, it has no
contents or dimensionality, and its name is free for reuse (for example
-by @code{glGenTextures}). If a texture that is currently bound is
+by @code{glGenTextures}). If a texture that is currently bound is
deleted, the binding reverts to 0 (the default texture).
@code{glDeleteTextures} silently ignores 0's and names that do not
@table @asis
@item @var{func}
-Specifies the depth comparison function. Symbolic constants
+Specifies the depth comparison function. Symbolic constants
@code{GL_NEVER}, @code{GL_LESS}, @code{GL_EQUAL}, @code{GL_LEQUAL},
@code{GL_GREATER}, @code{GL_NOTEQUAL}, @code{GL_GEQUAL}, and
-@code{GL_ALWAYS} are accepted. The initial value is @code{GL_LESS}.
+@code{GL_ALWAYS} are accepted. The initial value is @code{GL_LESS}.
@end table
@code{glDepthFunc} 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
+pixel depth value with the depth value present in the depth buffer. The
+comparison is performed only if depth testing is enabled. (See
@code{glEnable} and @code{glDisable} of @code{GL_DEPTH_TEST}.)
@var{func} specifies the conditions under which the pixel will be drawn.
@end table
-The initial value of @var{func} is @code{GL_LESS}. Initially, depth
-testing is disabled. If depth testing is disabled or if no depth buffer
+The initial value of @var{func} is @code{GL_LESS}. Initially, depth
+testing is disabled. If depth testing is disabled or if no depth buffer
exists, it is as if the depth test always passes.
@code{GL_INVALID_ENUM} is generated if @var{func} is not an accepted
@table @asis
@item @var{flag}
-Specifies whether the depth buffer is enabled for writing. If
-@var{flag} is @code{GL_FALSE}, depth buffer writing is disabled.
-Otherwise, it is enabled. Initially, depth buffer writing is enabled.
+Specifies whether the depth buffer is enabled for writing. If @var{flag}
+is @code{GL_FALSE}, depth buffer writing is disabled. Otherwise, it is
+enabled. Initially, depth buffer writing is enabled.
@end table
@code{glDepthMask} specifies whether the depth buffer is enabled for
-writing. If @var{flag} is @code{GL_FALSE}, depth buffer writing is
-disabled. Otherwise, it is enabled. Initially, depth buffer writing is
+writing. If @var{flag} is @code{GL_FALSE}, depth buffer writing is
+disabled. Otherwise, it is enabled. Initially, depth buffer writing is
enabled.
@code{GL_INVALID_OPERATION} is generated if @code{glDepthMask} is
After clipping and division by @var{w}, depth coordinates range from
@r{-1} to 1, corresponding to the near and far clipping planes.
@code{glDepthRange} 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 @code{glDepthRange} are both
-clamped to this range before they are accepted.
+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 @code{glDepthRange} are both clamped to
+this range before they are accepted.
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.
@end table
@code{glDetachShader} detaches the shader object specified by
-@var{shader} from the program object specified by @var{program}. This
+@var{shader} from the program object specified by @var{program}. This
command can be used to undo the effect of the command
@code{glAttachShader}.
@table @asis
@item @var{mode}
-Specifies what kind of primitives to render. Symbolic constants
+Specifies what kind of primitives to render. Symbolic constants
@code{GL_POINTS}, @code{GL_LINE_STRIP}, @code{GL_LINE_LOOP},
@code{GL_LINES}, @code{GL_TRIANGLE_STRIP}, @code{GL_TRIANGLE_FAN},
@code{GL_TRIANGLES}, @code{GL_QUAD_STRIP}, @code{GL_QUADS}, and
@end table
@code{glDrawArrays} specifies multiple geometric primitives with very
-few subroutine calls. Instead of calling a GL procedure to pass each
+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
When @code{glDrawArrays} is called, it uses @var{count} sequential
elements from each enabled array to construct a sequence of geometric
-primitives, beginning with element @var{first}. @var{mode} specifies
+primitives, beginning with element @var{first}. @var{mode} specifies
what kind of primitives are constructed and how the array elements
-construct those primitives. If @code{GL_VERTEX_ARRAY} is not enabled,
-no geometric primitives are generated.
+construct those primitives. If @code{GL_VERTEX_ARRAY} is not enabled, no
+geometric primitives are generated.
Vertex attributes that are modified by @code{glDrawArrays} have an
-unspecified value after @code{glDrawArrays} returns. For example, if
+unspecified value after @code{glDrawArrays} returns. For example, if
@code{GL_COLOR_ARRAY} is enabled, the value of the current color is
-undefined after @code{glDrawArrays} executes. Attributes that aren't
+undefined after @code{glDrawArrays} executes. Attributes that aren't
modified remain well defined.
@code{GL_INVALID_ENUM} is generated if @var{mode} is not an accepted
@end table
@code{glDrawBuffers} defines an array of buffers into which fragment
-color values or fragment data will be written. If no fragment shader is
+color values or fragment data will be written. If no fragment shader is
active, rendering operations will generate only one fragment color per
fragment and it will be written into each of the buffers specified by
-@var{bufs}. If a fragment shader is active and it writes a value to the
+@var{bufs}. If a fragment shader is active and it writes a value to the
output variable @code{gl_FragColor}, then that value will be written
-into each of the buffers specified by @var{bufs}. If a fragment shader
+into each of the buffers specified by @var{bufs}. If a fragment shader
is active and it writes a value to one or more elements of the output
array variable @code{gl_FragData[]}, then the value of
@code{gl_FragData[0] } will be written into the first buffer specified
by @var{bufs}, the value of @code{gl_FragData[1] } will be written into
the second buffer specified by @var{bufs}, and so on up to
-@code{gl_FragData[n-1]}. The draw buffer used for @code{gl_FragData[n]}
+@code{gl_FragData[n-1]}. The draw buffer used for @code{gl_FragData[n]}
and beyond is implicitly set to be @code{GL_NONE}.
The symbolic constants contained in @var{bufs} may be any of the
@end table
Except for @code{GL_NONE}, the preceding symbolic constants may not
-appear more than once in @var{bufs}. The maximum number of draw buffers
+appear more than once in @var{bufs}. The maximum number of draw buffers
supported is implementation dependent and can be queried by calling
-@code{glGet} with the argument @code{GL_MAX_DRAW_BUFFERS}. The number
-of auxiliary buffers can be queried by calling @code{glGet} with the
+@code{glGet} with the argument @code{GL_MAX_DRAW_BUFFERS}. The number of
+auxiliary buffers can be queried by calling @code{glGet} with the
argument @code{GL_AUX_BUFFERS}.
@code{GL_INVALID_ENUM} is generated if one of the values in @var{bufs}
@table @asis
@item @var{mode}
-Specifies up to four color buffers to be drawn into. Symbolic constants
+Specifies up to four color buffers to be drawn into. Symbolic constants
@code{GL_NONE}, @code{GL_FRONT_LEFT}, @code{GL_FRONT_RIGHT},
@code{GL_BACK_LEFT}, @code{GL_BACK_RIGHT}, @code{GL_FRONT},
@code{GL_BACK}, @code{GL_LEFT}, @code{GL_RIGHT},
@end table
When colors are written to the frame buffer, they are written into the
-color buffers specified by @code{glDrawBuffer}. The specifications are
+color buffers specified by @code{glDrawBuffer}. The specifications are
as follows:
@table @asis
Only the back right color buffer is written.
@item @code{GL_FRONT}
-Only the front left and front right color buffers are written. If there
+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.
@item @code{GL_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.
+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.
@item @code{GL_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.
+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.
@item @code{GL_RIGHT}
-Only the front right and back right color buffers are written. If there
+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.
@item @code{GL_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
+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.
+are written. If there are no right or back color buffers, only the front
+left color buffer is written.
@item @code{GL_AUX}@var{i}
Only auxiliary color buffer @var{i} is written.
buffer and can produce different results in each buffer.
Monoscopic contexts include only @var{left} buffers, and stereoscopic
-contexts include both @var{left} and @var{right} buffers. Likewise,
+contexts include both @var{left} and @var{right} buffers. Likewise,
single-buffered contexts include only @var{front} buffers, and
double-buffered contexts include both @var{front} and @var{back}
-buffers. The context is selected at GL initialization.
+buffers. The context is selected at GL initialization.
@code{GL_INVALID_ENUM} is generated if @var{mode} is not an accepted
value.
@table @asis
@item @var{mode}
-Specifies what kind of primitives to render. Symbolic constants
+Specifies what kind of primitives to render. Symbolic constants
@code{GL_POINTS}, @code{GL_LINE_STRIP}, @code{GL_LINE_LOOP},
@code{GL_LINES}, @code{GL_TRIANGLE_STRIP}, @code{GL_TRIANGLE_FAN},
@code{GL_TRIANGLES}, @code{GL_QUAD_STRIP}, @code{GL_QUADS}, and
Specifies the number of elements to be rendered.
@item @var{type}
-Specifies the type of the values in @var{indices}. Must be one of
+Specifies the type of the values in @var{indices}. Must be one of
@code{GL_UNSIGNED_BYTE}, @code{GL_UNSIGNED_SHORT}, or
@code{GL_UNSIGNED_INT}.
@end table
@code{glDrawElements} specifies multiple geometric primitives with very
-few subroutine calls. Instead of calling a GL function to pass each
+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
When @code{glDrawElements} is called, it uses @var{count} sequential
elements from an enabled array, starting at @var{indices} to construct a
-sequence of geometric primitives. @var{mode} specifies what kind of
+sequence of geometric primitives. @var{mode} 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
+primitives. If more than one array is enabled, each is used. If
@code{GL_VERTEX_ARRAY} is not enabled, no geometric primitives are
constructed.
Vertex attributes that are modified by @code{glDrawElements} have an
-unspecified value after @code{glDrawElements} returns. For example, if
+unspecified value after @code{glDrawElements} returns. For example, if
@code{GL_COLOR_ARRAY} is enabled, the value of the current color is
-undefined after @code{glDrawElements} executes. Attributes that aren't
+undefined after @code{glDrawElements} executes. Attributes that aren't
modified maintain their previous values.
@code{GL_INVALID_ENUM} is generated if @var{mode} is not an accepted
frame buffer.
@item @var{format}
-Specifies the format of the pixel data. Symbolic constants
+Specifies the format of the pixel data. Symbolic constants
@code{GL_COLOR_INDEX}, @code{GL_STENCIL_INDEX},
@code{GL_DEPTH_COMPONENT}, @code{GL_RGB}, @code{GL_BGR}, @code{GL_RGBA},
@code{GL_BGRA}, @code{GL_RED}, @code{GL_GREEN}, @code{GL_BLUE},
accepted.
@item @var{type}
-Specifies the data type for @var{data}. Symbolic constants
+Specifies the data type for @var{data}. Symbolic constants
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
@code{glDrawPixels} reads pixel data from memory and writes it into the
frame buffer relative to the current raster position, provided that the
-raster position is valid. Use @code{glRasterPos} or @code{glWindowPos}
+raster position is valid. Use @code{glRasterPos} or @code{glWindowPos}
to set the current raster position; use @code{glGet} with argument
@code{GL_CURRENT_RASTER_POSITION_VALID} to determine if the specified
raster position is valid, and @code{glGet} with argument
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:
+frame buffer. These parameters are set with four commands:
@code{glPixelStore}, @code{glPixelTransfer}, @code{glPixelMap}, and
-@code{glPixelZoom}. This reference page describes the effects on
+@code{glPixelZoom}. This reference page describes the effects on
@code{glDrawPixels} of many, but not all, of the parameters specified by
these four commands.
Data is read from @var{data} as a sequence of signed or unsigned bytes,
signed or unsigned shorts, signed or unsigned integers, or
-single-precision floating-point values, depending on @var{type}. When
+single-precision floating-point values, depending on @var{type}. When
@var{type} is one of @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, or @code{GL_FLOAT} each of these bytes, shorts, integers,
or floating-point values is interpreted as one color or depth component,
-or one index, depending on @var{format}. When @var{type} is one of
+or one index, depending on @var{format}. When @var{type} is one of
@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_SHORT_5_6_5},
@code{GL_UNSIGNED_SHORT_4_4_4_4}, @code{GL_UNSIGNED_SHORT_5_5_5_1},
@code{GL_UNSIGNED_INT_8_8_8_8}, or @code{GL_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
-@var{format}. When @var{type} is one of
+@var{format}. When @var{type} is one of
@code{GL_UNSIGNED_BYTE_2_3_3_REV}, @code{GL_UNSIGNED_SHORT_5_6_5_REV},
@code{GL_UNSIGNED_SHORT_4_4_4_4_REV},
@code{GL_UNSIGNED_SHORT_1_5_5_5_REV},
@code{GL_UNSIGNED_INT_8_8_8_8_REV}, or
@code{GL_UNSIGNED_INT_2_10_10_10_REV}, each unsigned value is
interpreted as containing all color components, specified by
-@var{format}, 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 @var{format}. Both
-individual indices and groups of components are referred to as pixels.
-If @var{type} is @code{GL_BITMAP}, the data must be unsigned bytes, and
+@var{format}, 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 @var{format}. Both individual
+indices and groups of components are referred to as pixels. If
+@var{type} is @code{GL_BITMAP}, the data must be unsigned bytes, and
@var{format} must be either @code{GL_COLOR_INDEX} or
-@code{GL_STENCIL_INDEX}. Each unsigned byte is treated as eight 1-bit
+@code{GL_STENCIL_INDEX}. Each unsigned byte is treated as eight 1-bit
pixels, with bit ordering determined by @code{GL_UNPACK_LSB_FIRST} (see
@code{glPixelStore}).
@r{@var{width}×@var{height}} pixels are read from memory, starting at
-location @var{data}. By default, these pixels are taken from adjacent
+location @var{data}. By default, these pixels are taken from adjacent
memory locations, except that after all @var{width} pixels are read, the
-read pointer is advanced to the next four-byte boundary. The four-byte
+read pointer is advanced to the next four-byte boundary. The four-byte
row alignment is specified by @code{glPixelStore} with argument
@code{GL_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
-@var{width} pixels are read. See the @code{glPixelStore} reference page
+eight bytes. Other pixel store parameters specify different read pointer
+advancements, both before the first pixel is read and after all
+@var{width} pixels are read. See the @code{glPixelStore} reference page
for details on these options.
If a non-zero named buffer object is bound to the
parameters specified by @code{glPixelTransfer} and @code{glPixelMap}.
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 @var{format}. @var{format} can assume one of 13 symbolic
+specified by @var{format}. @var{format} can assume one of 13 symbolic
values:
@table @asis
@item @code{GL_COLOR_INDEX}
-Each pixel is a single value, a color index. It is converted to
+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
+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.
Each fixed-point index is then shifted left by @code{GL_INDEX_SHIFT}
-bits and added to @code{GL_INDEX_OFFSET}. If @code{GL_INDEX_SHIFT} is
-negative, the shift is to the right. In either case, zero bits fill
+bits and added to @code{GL_INDEX_OFFSET}. If @code{GL_INDEX_SHIFT} is
+negative, the shift is to the right. In either case, zero bits fill
otherwise unspecified bit locations in the result.
If the GL is in RGBA mode, the resulting index is converted to an RGBA
pixel with the help of the @code{GL_PIXEL_MAP_I_TO_R},
@code{GL_PIXEL_MAP_I_TO_G}, @code{GL_PIXEL_MAP_I_TO_B}, and
-@code{GL_PIXEL_MAP_I_TO_A} tables. If the GL is in color index mode,
-and if @code{GL_MAP_COLOR} is true, the index is replaced with the value
-that it references in lookup table @code{GL_PIXEL_MAP_I_TO_I}. Whether
+@code{GL_PIXEL_MAP_I_TO_A} tables. If the GL is in color index mode, and
+if @code{GL_MAP_COLOR} is true, the index is replaced with the value
+that it references in lookup table @code{GL_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 @r{2^@var{b}-1}, where @r{@var{b}} is the
number of bits in a color index buffer.
@r{@var{x}_@var{n}=@var{x}_@var{r}+@var{n}%@var{width}}@r{@var{y}_@var{n}=@var{y}_@var{r}+⌊@var{n}/@var{width},⌋}
where @r{(@var{x}_@var{r},@var{y}_@var{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.
+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.
@item @code{GL_STENCIL_INDEX}
-Each pixel is a single value, a stencil index. It is converted to
+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
+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.
Each fixed-point index is then shifted left by @code{GL_INDEX_SHIFT}
-bits, and added to @code{GL_INDEX_OFFSET}. If @code{GL_INDEX_SHIFT} is
-negative, the shift is to the right. In either case, zero bits fill
-otherwise unspecified bit locations in the result. If
+bits, and added to @code{GL_INDEX_OFFSET}. If @code{GL_INDEX_SHIFT} is
+negative, the shift is to the right. In either case, zero bits fill
+otherwise unspecified bit locations in the result. If
@code{GL_MAP_STENCIL} is true, the index is replaced with the value that
-it references in lookup table @code{GL_PIXEL_MAP_S_TO_S}. Whether the
+it references in lookup table @code{GL_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 @r{2^@var{b}-1}, where @r{@var{b}} is the
-number of bits in the stencil buffer. The resulting stencil indices are
+number of bits in the stencil buffer. The resulting stencil indices are
then written to the stencil buffer such that the @r{@var{n}}th index is
written to location
@r{@var{x}_@var{n}=@var{x}_@var{r}+@var{n}%@var{width}}@r{@var{y}_@var{n}=@var{y}_@var{r}+⌊@var{n}/@var{width},⌋}
where @r{(@var{x}_@var{r},@var{y}_@var{r})} is the current raster
-position. Only the pixel ownership test, the scissor test, and the
+position. Only the pixel ownership test, the scissor test, and the
stencil writemask affect these write operations.
@item @code{GL_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
+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
-@r{-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 @code{GL_DEPTH_SCALE}
-and added to @code{GL_DEPTH_BIAS}. The result is clamped to the range
-@r{[0,1]}.
+@r{-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 @code{GL_DEPTH_SCALE} and added to
+@code{GL_DEPTH_BIAS}. The result is clamped to the range @r{[0,1]}.
The GL then converts the resulting depth components to fragments by
attaching the current raster position color or color index and texture
@r{@var{x}_@var{n}=@var{x}_@var{r}+@var{n}%@var{width}}@r{@var{y}_@var{n}=@var{y}_@var{r}+⌊@var{n}/@var{width},⌋}
where @r{(@var{x}_@var{r},@var{y}_@var{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.
+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.
@item @code{GL_RGBA}
@item @code{GL_BGRA}
component is first, followed by green, followed by blue, followed by
alpha; for @code{GL_BGRA} the order is blue, green, red and then alpha.
Floating-point values are converted directly to an internal
-floating-point format with unspecified precision. Signed integer values
+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 @r{-1.0}. (Note that this mapping
+negative representable value maps to @r{-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
+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
@code{GL_c_SCALE} and added to @code{GL_c_BIAS}, where @var{c} is RED,
-GREEN, BLUE, and ALPHA for the respective color components. The results
+GREEN, BLUE, and ALPHA for the respective color components. The results
are clamped to the range @r{[0,1]}.
If @code{GL_MAP_COLOR} is true, each color component is scaled by the
size of lookup table @code{GL_PIXEL_MAP_c_TO_c}, then replaced by the
-value that it references in that table. @var{c} is R, G, B, or A
+value that it references in that table. @var{c} is R, G, B, or A
respectively.
The GL then converts the resulting RGBA colors to fragments by attaching
@r{@var{x}_@var{n}=@var{x}_@var{r}+@var{n}%@var{width}}@r{@var{y}_@var{n}=@var{y}_@var{r}+⌊@var{n}/@var{width},⌋}
where @r{(@var{x}_@var{r},@var{y}_@var{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.
+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.
@item @code{GL_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
+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.
@item @code{GL_GREEN}
-Each pixel is a single green component. This component is converted to
+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
+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.
@item @code{GL_BLUE}
-Each pixel is a single blue component. This component is converted to
+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
+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.
@item @code{GL_ALPHA}
-Each pixel is a single alpha component. This component is converted to
+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.
+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.
@item @code{GL_RGB}
@item @code{GL_BGR}
Each pixel is a three-component group: red first, followed by green,
followed by blue; for @code{GL_BGR}, the first component is blue,
-followed by green and then red. Each component is converted to the
+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
+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.
@item @code{GL_LUMINANCE}
-Each pixel is a single luminance component. This component is converted
+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,
+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.
+1. After this conversion, the pixel is treated as if it had been read as
+an RGBA pixel.
@item @code{GL_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
+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
-The rasterization described so far assumes pixel zoom factors of 1. If
+The rasterization described so far assumes pixel zoom factors of 1. If
@code{glPixelZoom} is used to change the @r{@var{x}} and @r{@var{y}}
-pixel zoom factors, pixels are converted to fragments as follows. If
+pixel zoom factors, pixels are converted to fragments as follows. If
@r{(@var{x}_@var{r},@var{y}_@var{r})} is the current raster position,
and a given pixel is in the @r{@var{n}}th column and @r{@var{m}}th row
of the pixel rectangle, then fragments are generated for pixels whose
@table @asis
@item @var{mode}
-Specifies what kind of primitives to render. Symbolic constants
+Specifies what kind of primitives to render. Symbolic constants
@code{GL_POINTS}, @code{GL_LINE_STRIP}, @code{GL_LINE_LOOP},
@code{GL_LINES}, @code{GL_TRIANGLE_STRIP}, @code{GL_TRIANGLE_FAN},
@code{GL_TRIANGLES}, @code{GL_QUAD_STRIP}, @code{GL_QUADS}, and
Specifies the number of elements to be rendered.
@item @var{type}
-Specifies the type of the values in @var{indices}. Must be one of
+Specifies the type of the values in @var{indices}. Must be one of
@code{GL_UNSIGNED_BYTE}, @code{GL_UNSIGNED_SHORT}, or
@code{GL_UNSIGNED_INT}.
@end table
@code{glDrawRangeElements} is a restricted form of
-@code{glDrawElements}. @var{mode}, @var{start}, @var{end}, and
+@code{glDrawElements}. @var{mode}, @var{start}, @var{end}, and
@var{count} match the corresponding arguments to @code{glDrawElements},
with the additional constraint that all values in the arrays @var{count}
must lie between @var{start} and @var{end}, inclusive.
Implementations denote recommended maximum amounts of vertex and index
data, which may be queried by calling @code{glGet} with argument
-@code{GL_MAX_ELEMENTS_VERTICES} and @code{GL_MAX_ELEMENTS_INDICES}. If
+@code{GL_MAX_ELEMENTS_VERTICES} and @code{GL_MAX_ELEMENTS_INDICES}. If
@r{@var{end}-@var{start}+1} is greater than the value of
@code{GL_MAX_ELEMENTS_VERTICES}, or if @var{count} is greater than the
value of @code{GL_MAX_ELEMENTS_INDICES}, then the call may operate at
-reduced performance. There is no requirement that all vertices in the
-range @r{[@var{start},@var{end}]} be referenced. However, the
+reduced performance. There is no requirement that all vertices in the
+range @r{[@var{start},@var{end}]} be referenced. However, the
implementation may partially process unused vertices, reducing
performance from what could be achieved with an optimal index set.
When @code{glDrawRangeElements} is called, it uses @var{count}
sequential elements from an enabled array, starting at @var{start} to
-construct a sequence of geometric primitives. @var{mode} specifies what
+construct a sequence of geometric primitives. @var{mode} 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
+these primitives. If more than one array is enabled, each is used. If
@code{GL_VERTEX_ARRAY} is not enabled, no geometric primitives are
constructed.
Vertex attributes that are modified by @code{glDrawRangeElements} have
-an unspecified value after @code{glDrawRangeElements} returns. For
+an unspecified value after @code{glDrawRangeElements} returns. For
example, if @code{GL_COLOR_ARRAY} is enabled, the value of the current
-color is undefined after @code{glDrawRangeElements} executes. Attributes
+color is undefined after @code{glDrawRangeElements} executes. Attributes
that aren't modified maintain their previous values.
It is an error for indices to lie outside the range
@r{[@var{start},@var{end}]}, but implementations may not check for this
-situation. Such indices cause implementation-dependent behavior.
+situation. Such indices cause implementation-dependent behavior.
@code{GL_INVALID_ENUM} is generated if @var{mode} is not an accepted
value.
@table @asis
@item @var{stride}
-Specifies the byte offset between consecutive edge flags. If
+Specifies the byte offset between consecutive edge flags. If
@var{stride} is 0, the edge flags are understood to be tightly packed in
-the array. The initial value is 0.
+the array. The initial value is 0.
@item @var{pointer}
-Specifies a pointer to the first edge flag in the array. The initial
+Specifies a pointer to the first edge flag in the array. The initial
value is 0.
@end table
@code{glEdgeFlagPointer} specifies the location and data format of an
-array of boolean edge flags to use when rendering. @var{stride}
+array of boolean edge flags to use when rendering. @var{stride}
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.
If a non-zero named buffer object is bound to the @code{GL_ARRAY_BUFFER}
target (see @code{glBindBuffer}) while an edge flag array is specified,
@var{pointer} is treated as a byte offset into the buffer object's data
-store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
+store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
is saved as edge flag vertex array client-side state
(@code{GL_EDGE_FLAG_ARRAY_BUFFER_BINDING}).
To enable and disable the edge flag array, call
@code{glEnableClientState} and @code{glDisableClientState} with the
-argument @code{GL_EDGE_FLAG_ARRAY}. If enabled, the edge flag array is
+argument @code{GL_EDGE_FLAG_ARRAY}. If enabled, the edge flag array is
used when @code{glDrawArrays}, @code{glMultiDrawArrays},
@code{glDrawElements}, @code{glMultiDrawElements},
@code{glDrawRangeElements}, or @code{glArrayElement} is called.
@table @asis
@item @var{flag}
Specifies the current edge flag value, either @code{GL_TRUE} or
-@code{GL_FALSE}. The initial value is @code{GL_TRUE}.
+@code{GL_FALSE}. The initial value is @code{GL_TRUE}.
@end table
Each vertex of a polygon, separate triangle, or separate quadrilateral
specified between a @code{glBegin}/@code{glEnd} 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. @code{glEdgeFlag} sets the edge flag bit to
+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. @code{glEdgeFlag} sets the edge flag bit to
@code{GL_TRUE} if @var{flag} is @code{GL_TRUE} and to @code{GL_FALSE}
otherwise.
always marked as boundary, regardless of the value of the edge flag.
Boundary and nonboundary edge flags on vertices are significant only if
-@code{GL_POLYGON_MODE} is set to @code{GL_POINT} or @code{GL_LINE}. See
+@code{GL_POLYGON_MODE} is set to @code{GL_POINT} or @code{GL_LINE}. See
@code{glPolygonMode}.
@end deftypefun
@table @asis
@item @var{cap}
-Specifies the capability to enable. Symbolic constants
+Specifies the capability to enable. Symbolic constants
@code{GL_COLOR_ARRAY}, @code{GL_EDGE_FLAG_ARRAY},
@code{GL_FOG_COORD_ARRAY}, @code{GL_INDEX_ARRAY},
@code{GL_NORMAL_ARRAY}, @code{GL_SECONDARY_COLOR_ARRAY},
@end table
@code{glEnableClientState} and @code{glDisableClientState} enable or
-disable individual client-side capabilities. By default, all
-client-side capabilities are disabled. Both @code{glEnableClientState}
-and @code{glDisableClientState} take a single argument, @var{cap}, which
-can assume one of the following values:
+disable individual client-side capabilities. By default, all client-side
+capabilities are disabled. Both @code{glEnableClientState} and
+@code{glDisableClientState} take a single argument, @var{cap}, which can
+assume one of the following values:
@table @asis
@item @code{GL_COLOR_ARRAY}
rendering when @code{glArrayElement}, @code{glDrawArrays},
@code{glDrawElements},
@code{glDrawRangeElements}@code{glMultiDrawArrays}, or
-@code{glMultiDrawElements} is called. See @code{glColorPointer}.
+@code{glMultiDrawElements} is called. See @code{glColorPointer}.
@item @code{GL_EDGE_FLAG_ARRAY}
If enabled, the edge flag array is enabled for writing and used during
rendering when @code{glArrayElement}, @code{glDrawArrays},
@code{glDrawElements},
@code{glDrawRangeElements}@code{glMultiDrawArrays}, or
-@code{glMultiDrawElements} is called. See @code{glEdgeFlagPointer}.
+@code{glMultiDrawElements} is called. See @code{glEdgeFlagPointer}.
@item @code{GL_FOG_COORD_ARRAY}
If enabled, the fog coordinate array is enabled for writing and used
during rendering when @code{glArrayElement}, @code{glDrawArrays},
@code{glDrawElements},
@code{glDrawRangeElements}@code{glMultiDrawArrays}, or
-@code{glMultiDrawElements} is called. See @code{glFogCoordPointer}.
+@code{glMultiDrawElements} is called. See @code{glFogCoordPointer}.
@item @code{GL_INDEX_ARRAY}
If enabled, the index array is enabled for writing and used during
rendering when @code{glArrayElement}, @code{glDrawArrays},
@code{glDrawElements},
@code{glDrawRangeElements}@code{glMultiDrawArrays}, or
-@code{glMultiDrawElements} is called. See @code{glIndexPointer}.
+@code{glMultiDrawElements} is called. See @code{glIndexPointer}.
@item @code{GL_NORMAL_ARRAY}
If enabled, the normal array is enabled for writing and used during
rendering when @code{glArrayElement}, @code{glDrawArrays},
@code{glDrawElements},
@code{glDrawRangeElements}@code{glMultiDrawArrays}, or
-@code{glMultiDrawElements} is called. See @code{glNormalPointer}.
+@code{glMultiDrawElements} is called. See @code{glNormalPointer}.
@item @code{GL_SECONDARY_COLOR_ARRAY}
If enabled, the secondary color array is enabled for writing and used
during rendering when @code{glArrayElement}, @code{glDrawArrays},
@code{glDrawElements},
@code{glDrawRangeElements}@code{glMultiDrawArrays}, or
-@code{glMultiDrawElements} is called. See @code{glColorPointer}.
+@code{glMultiDrawElements} is called. See @code{glColorPointer}.
@item @code{GL_TEXTURE_COORD_ARRAY}
If enabled, the texture coordinate array is enabled for writing and used
during rendering when @code{glArrayElement}, @code{glDrawArrays},
@code{glDrawElements},
@code{glDrawRangeElements}@code{glMultiDrawArrays}, or
-@code{glMultiDrawElements} is called. See @code{glTexCoordPointer}.
+@code{glMultiDrawElements} is called. See @code{glTexCoordPointer}.
@item @code{GL_VERTEX_ARRAY}
If enabled, the vertex array is enabled for writing and used during
rendering when @code{glArrayElement}, @code{glDrawArrays},
@code{glDrawElements},
@code{glDrawRangeElements}@code{glMultiDrawArrays}, or
-@code{glMultiDrawElements} is called. See @code{glVertexPointer}.
+@code{glMultiDrawElements} is called. See @code{glVertexPointer}.
@end table
@code{glEnableClientState} is not allowed between the execution of
@code{glBegin} and the corresponding @code{glEnd}, but an error may or
-may not be generated. If no error is generated, the behavior is
+may not be generated. If no error is generated, the behavior is
undefined.
@end deftypefun
@end table
@code{glEnableVertexAttribArray} enables the generic vertex attribute
-array specified by @var{index}. @code{glDisableVertexAttribArray}
-disables the generic vertex attribute array specified by @var{index}. By
+array specified by @var{index}. @code{glDisableVertexAttribArray}
+disables the generic vertex attribute array specified by @var{index}. By
default, all client-side capabilities are disabled, including all
-generic vertex attribute arrays. If enabled, the values in the generic
+generic vertex attribute arrays. If enabled, the values in the generic
vertex attribute array will be accessed and used for rendering when
calls are made to vertex array commands such as @code{glDrawArrays},
@code{glDrawElements}, @code{glDrawRangeElements},
@end table
@code{glEnable} and @code{glDisable} enable and disable various
-capabilities. Use @code{glIsEnabled} or @code{glGet} to determine the
-current setting of any capability. The initial value for each
-capability with the exception of @code{GL_DITHER} and
-@code{GL_MULTISAMPLE} is @code{GL_FALSE}. The initial value for
-@code{GL_DITHER} and @code{GL_MULTISAMPLE} is @code{GL_TRUE}.
+capabilities. Use @code{glIsEnabled} or @code{glGet} to determine the
+current setting of any capability. The initial value for each capability
+with the exception of @code{GL_DITHER} and @code{GL_MULTISAMPLE} is
+@code{GL_FALSE}. The initial value for @code{GL_DITHER} and
+@code{GL_MULTISAMPLE} is @code{GL_TRUE}.
Both @code{glEnable} and @code{glDisable} take a single argument,
@var{cap}, which can assume one of the following values:
@item @code{GL_ALPHA_TEST}
-If enabled, do alpha testing. See @code{glAlphaFunc}.
+If enabled, do alpha testing. See @code{glAlphaFunc}.
@item @code{GL_AUTO_NORMAL}
If enabled, generate normal vectors when either @code{GL_MAP2_VERTEX_3}
-or @code{GL_MAP2_VERTEX_4} is used to generate vertices. See
+or @code{GL_MAP2_VERTEX_4} is used to generate vertices. See
@code{glMap2}.
@item @code{GL_BLEND}
If enabled, blend the computed fragment color values with the values in
-the color buffers. See @code{glBlendFunc}.
+the color buffers. See @code{glBlendFunc}.
@item @code{GL_CLIP_PLANE}@var{i}
If enabled, apply the currently selected logical operation to the
-computed fragment color and color buffer values. See @code{glLogicOp}.
+computed fragment color and color buffer values. See @code{glLogicOp}.
@item @code{GL_COLOR_MATERIAL}
If enabled, have one or more material parameters track the current
-color. See @code{glColorMaterial}.
+color. See @code{glColorMaterial}.
@item @code{GL_COLOR_SUM}
If enabled and no fragment shader is active, add the secondary color
-value to the computed fragment color. See @code{glSecondaryColor}.
+value to the computed fragment color. See @code{glSecondaryColor}.
@item @code{GL_COLOR_TABLE}
If enabled, perform a color table lookup on the incoming RGBA color
-values. See @code{glColorTable}.
+values. See @code{glColorTable}.
@item @code{GL_CONVOLUTION_1D}
If enabled, perform a 1D convolution operation on incoming RGBA color
-values. See @code{glConvolutionFilter1D}.
+values. See @code{glConvolutionFilter1D}.
@item @code{GL_CONVOLUTION_2D}
If enabled, perform a 2D convolution operation on incoming RGBA color
-values. See @code{glConvolutionFilter2D}.
+values. See @code{glConvolutionFilter2D}.
@item @code{GL_CULL_FACE}
@item @code{GL_DEPTH_TEST}
-If enabled, do depth comparisons and update the depth buffer. Note that
+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
+depth buffer is not updated if the depth test is disabled. See
@code{glDepthFunc} and @code{glDepthRange}.
@item @code{GL_DITHER}
If enabled and no fragment shader is active, blend a fog color into the
-post-texturing color. See @code{glFog}.
+post-texturing color. See @code{glFog}.
@item @code{GL_HISTOGRAM}
-If enabled, histogram incoming RGBA color values. See
+If enabled, histogram incoming RGBA color values. See
@code{glHistogram}.
@item @code{GL_INDEX_LOGIC_OP}
If enabled, apply the currently selected logical operation to the
-incoming index and color buffer indices. See @code{glLogicOp}.
+incoming index and color buffer indices. See @code{glLogicOp}.
@item @code{GL_LIGHT}@var{i}
If enabled, include light @var{i} in the evaluation of the lighting
-equation. See @code{glLightModel} and @code{glLight}.
+equation. See @code{glLightModel} and @code{glLight}.
@item @code{GL_LIGHTING}
If enabled and no vertex shader is active, use the current lighting
-parameters to compute the vertex color or index. Otherwise, simply
-associate the current color or index with each vertex. See
+parameters to compute the vertex color or index. Otherwise, simply
+associate the current color or index with each vertex. See
@code{glMaterial}, @code{glLightModel}, and @code{glLight}.
@item @code{GL_LINE_SMOOTH}
-If enabled, draw lines with correct filtering. Otherwise, draw aliased
-lines. See @code{glLineWidth}.
+If enabled, draw lines with correct filtering. Otherwise, draw aliased
+lines. See @code{glLineWidth}.
@item @code{GL_LINE_STIPPLE}
-If enabled, use the current line stipple pattern when drawing lines. See
+If enabled, use the current line stipple pattern when drawing lines. See
@code{glLineStipple}.
@item @code{GL_MAP1_COLOR_4}
If enabled, calls to @code{glEvalCoord1}, @code{glEvalMesh1}, and
-@code{glEvalPoint1} generate RGBA values. See @code{glMap1}.
+@code{glEvalPoint1} generate RGBA values. See @code{glMap1}.
@item @code{GL_MAP1_INDEX}
If enabled, calls to @code{glEvalCoord1}, @code{glEvalMesh1}, and
-@code{glEvalPoint1} generate color indices. See @code{glMap1}.
+@code{glEvalPoint1} generate color indices. See @code{glMap1}.
@item @code{GL_MAP1_NORMAL}
If enabled, calls to @code{glEvalCoord1}, @code{glEvalMesh1}, and
-@code{glEvalPoint1} generate normals. See @code{glMap1}.
+@code{glEvalPoint1} generate normals. See @code{glMap1}.
@item @code{GL_MAP1_TEXTURE_COORD_1}
If enabled, calls to @code{glEvalCoord1}, @code{glEvalMesh1}, and
-@code{glEvalPoint1} generate @var{s} texture coordinates. See
+@code{glEvalPoint1} generate @var{s} texture coordinates. See
@code{glMap1}.
@item @code{GL_MAP1_TEXTURE_COORD_2}
If enabled, calls to @code{glEvalCoord1}, @code{glEvalMesh1}, and
@code{glEvalPoint1} generate @var{s}, @var{t}, and @var{r} texture
-coordinates. See @code{glMap1}.
+coordinates. See @code{glMap1}.
@item @code{GL_MAP1_TEXTURE_COORD_4}
If enabled, calls to @code{glEvalCoord1}, @code{glEvalMesh1}, and
@code{glEvalPoint1} generate @var{s}, @var{t}, @var{r}, and @var{q}
-texture coordinates. See @code{glMap1}.
+texture coordinates. See @code{glMap1}.
@item @code{GL_MAP1_VERTEX_3}
If enabled, calls to @code{glEvalCoord1}, @code{glEvalMesh1}, and
@code{glEvalPoint1} generate @var{x}, @var{y}, and @var{z} vertex
-coordinates. See @code{glMap1}.
+coordinates. See @code{glMap1}.
@item @code{GL_MAP1_VERTEX_4}
If enabled, calls to @code{glEvalCoord1}, @code{glEvalMesh1}, and
@code{glEvalPoint1} generate homogeneous @var{x}, @var{y}, @var{z}, and
-@var{w} vertex coordinates. See @code{glMap1}.
+@var{w} vertex coordinates. See @code{glMap1}.
@item @code{GL_MAP2_COLOR_4}
If enabled, calls to @code{glEvalCoord2}, @code{glEvalMesh2}, and
-@code{glEvalPoint2} generate RGBA values. See @code{glMap2}.
+@code{glEvalPoint2} generate RGBA values. See @code{glMap2}.
@item @code{GL_MAP2_INDEX}
If enabled, calls to @code{glEvalCoord2}, @code{glEvalMesh2}, and
-@code{glEvalPoint2} generate color indices. See @code{glMap2}.
+@code{glEvalPoint2} generate color indices. See @code{glMap2}.
@item @code{GL_MAP2_NORMAL}
If enabled, calls to @code{glEvalCoord2}, @code{glEvalMesh2}, and
-@code{glEvalPoint2} generate normals. See @code{glMap2}.
+@code{glEvalPoint2} generate normals. See @code{glMap2}.
@item @code{GL_MAP2_TEXTURE_COORD_1}
If enabled, calls to @code{glEvalCoord2}, @code{glEvalMesh2}, and
-@code{glEvalPoint2} generate @var{s} texture coordinates. See
+@code{glEvalPoint2} generate @var{s} texture coordinates. See
@code{glMap2}.
@item @code{GL_MAP2_TEXTURE_COORD_2}
If enabled, calls to @code{glEvalCoord2}, @code{glEvalMesh2}, and
@code{glEvalPoint2} generate @var{s}, @var{t}, and @var{r} texture
-coordinates. See @code{glMap2}.
+coordinates. See @code{glMap2}.
@item @code{GL_MAP2_TEXTURE_COORD_4}
If enabled, calls to @code{glEvalCoord2}, @code{glEvalMesh2}, and
@code{glEvalPoint2} generate @var{s}, @var{t}, @var{r}, and @var{q}
-texture coordinates. See @code{glMap2}.
+texture coordinates. See @code{glMap2}.
@item @code{GL_MAP2_VERTEX_3}
If enabled, calls to @code{glEvalCoord2}, @code{glEvalMesh2}, and
@code{glEvalPoint2} generate @var{x}, @var{y}, and @var{z} vertex
-coordinates. See @code{glMap2}.
+coordinates. See @code{glMap2}.
@item @code{GL_MAP2_VERTEX_4}
If enabled, calls to @code{glEvalCoord2}, @code{glEvalMesh2}, and
@code{glEvalPoint2} generate homogeneous @var{x}, @var{y}, @var{z}, and
-@var{w} vertex coordinates. See @code{glMap2}.
+@var{w} vertex coordinates. See @code{glMap2}.
@item @code{GL_MINMAX}
If enabled, compute the minimum and maximum values of incoming RGBA
-color values. See @code{glMinmax}.
+color values. See @code{glMinmax}.
@item @code{GL_MULTISAMPLE}
If enabled, use multiple fragment samples in computing the final color
-of a pixel. See @code{glSampleCoverage}.
+of a pixel. See @code{glSampleCoverage}.
@item @code{GL_NORMALIZE}
If enabled and no vertex shader is active, normal vectors are normalized
-to unit length after transformation and before lighting. This method is
-generally less efficient than @code{GL_RESCALE_NORMAL}. See
+to unit length after transformation and before lighting. This method is
+generally less efficient than @code{GL_RESCALE_NORMAL}. See
@code{glNormal} and @code{glNormalPointer}.
@item @code{GL_POINT_SMOOTH}
-If enabled, draw points with proper filtering. Otherwise, draw aliased
-points. See @code{glPointSize}.
+If enabled, draw points with proper filtering. Otherwise, draw aliased
+points. See @code{glPointSize}.
@item @code{GL_POINT_SPRITE}
If enabled, calculate texture coordinates for points based on texture
-environment and point parameter settings. Otherwise texture coordinates
+environment and point parameter settings. Otherwise texture coordinates
are constant across points.
@item @code{GL_POLYGON_OFFSET_FILL}
If enabled, and if the polygon is rendered in @code{GL_FILL} mode, an
offset is added to depth values of a polygon's fragments before the
-depth comparison is performed. See @code{glPolygonOffset}.
+depth comparison is performed. See @code{glPolygonOffset}.
@item @code{GL_POLYGON_OFFSET_LINE}
If enabled, and if the polygon is rendered in @code{GL_LINE} mode, an
offset is added to depth values of a polygon's fragments before the
-depth comparison is performed. See @code{glPolygonOffset}.
+depth comparison is performed. See @code{glPolygonOffset}.
@item @code{GL_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
-@code{GL_POINT} mode. See @code{glPolygonOffset}.
+@code{GL_POINT} mode. See @code{glPolygonOffset}.
@item @code{GL_POLYGON_SMOOTH}
-If enabled, draw polygons with proper filtering. Otherwise, draw
-aliased polygons. For correct antialiased polygons, an alpha buffer is
-needed and the polygons must be sorted front to back.
+If enabled, draw polygons with proper filtering. Otherwise, draw aliased
+polygons. For correct antialiased polygons, an alpha buffer is needed
+and the polygons must be sorted front to back.
@item @code{GL_POLYGON_STIPPLE}
If enabled, use the current polygon stipple pattern when rendering
-polygons. See @code{glPolygonStipple}.
+polygons. See @code{glPolygonStipple}.
@item @code{GL_POST_COLOR_MATRIX_COLOR_TABLE}
If enabled, perform a color table lookup on RGBA color values after
-color matrix transformation. See @code{glColorTable}.
+color matrix transformation. See @code{glColorTable}.
@item @code{GL_POST_CONVOLUTION_COLOR_TABLE}
If enabled, perform a color table lookup on RGBA color values after
-convolution. See @code{glColorTable}.
+convolution. See @code{glColorTable}.
@item @code{GL_RESCALE_NORMAL}
If enabled and no vertex shader is active, normal vectors are scaled
after transformation and before lighting by a factor computed from the
-modelview matrix. If the modelview matrix scales space uniformly, this
-has the effect of restoring the transformed normal to unit length. This
-method is generally more efficient than @code{GL_NORMALIZE}. See
+modelview matrix. If the modelview matrix scales space uniformly, this
+has the effect of restoring the transformed normal to unit length. This
+method is generally more efficient than @code{GL_NORMALIZE}. See
@code{glNormal} and @code{glNormalPointer}.
@item @code{GL_SAMPLE_ALPHA_TO_COVERAGE}
If enabled, compute a temporary coverage value where each bit is
-determined by the alpha value at the corresponding sample location. The
+determined by the alpha value at the corresponding sample location. The
temporary coverage value is then ANDed with the fragment coverage value.
@item @code{GL_SAMPLE_ALPHA_TO_ONE}
If enabled, the fragment's coverage is ANDed with the temporary coverage
-value. If @code{GL_SAMPLE_COVERAGE_INVERT} is set to @code{GL_TRUE},
-invert the coverage value. See @code{glSampleCoverage}.
+value. If @code{GL_SAMPLE_COVERAGE_INVERT} is set to @code{GL_TRUE},
+invert the coverage value. See @code{glSampleCoverage}.
@item @code{GL_SEPARABLE_2D}
If enabled, perform a two-dimensional convolution operation using a
-separable convolution filter on incoming RGBA color values. See
+separable convolution filter on incoming RGBA color values. See
@code{glSeparableFilter2D}.
@item @code{GL_SCISSOR_TEST}
@item @code{GL_STENCIL_TEST}
-If enabled, do stencil testing and update the stencil buffer. See
+If enabled, do stencil testing and update the stencil buffer. See
@code{glStencilFunc} and @code{glStencilOp}.
@item @code{GL_TEXTURE_1D}
If enabled and no fragment shader is active, one-dimensional texturing
is performed (unless two- or three-dimensional or cube-mapped texturing
-is also enabled). See @code{glTexImage1D}.
+is also enabled). See @code{glTexImage1D}.
@item @code{GL_TEXTURE_2D}
If enabled and no fragment shader is active, two-dimensional texturing
is performed (unless three-dimensional or cube-mapped texturing is also
-enabled). See @code{glTexImage2D}.
+enabled). See @code{glTexImage2D}.
@item @code{GL_TEXTURE_3D}
If enabled and no fragment shader is active, three-dimensional texturing
-is performed (unless cube-mapped texturing is also enabled). See
+is performed (unless cube-mapped texturing is also enabled). See
@code{glTexImage3D}.
@item @code{GL_TEXTURE_CUBE_MAP}
If enabled and no fragment shader is active, cube-mapped texturing is
-performed. See @code{glTexImage2D}.
+performed. See @code{glTexImage2D}.
@item @code{GL_TEXTURE_GEN_Q}
If enabled and no vertex shader is active, the @var{q} texture
coordinate is computed using the texture generation function defined
-with @code{glTexGen}. Otherwise, the current @var{q} texture coordinate
-is used. See @code{glTexGen}.
+with @code{glTexGen}. Otherwise, the current @var{q} texture coordinate
+is used. See @code{glTexGen}.
@item @code{GL_TEXTURE_GEN_R}
If enabled and no vertex shader is active, the @var{r} texture
coordinate is computed using the texture generation function defined
-with @code{glTexGen}. Otherwise, the current @var{r} texture coordinate
-is used. See @code{glTexGen}.
+with @code{glTexGen}. Otherwise, the current @var{r} texture coordinate
+is used. See @code{glTexGen}.
@item @code{GL_TEXTURE_GEN_S}
If enabled and no vertex shader is active, the @var{s} texture
coordinate is computed using the texture generation function defined
-with @code{glTexGen}. Otherwise, the current @var{s} texture coordinate
-is used. See @code{glTexGen}.
+with @code{glTexGen}. Otherwise, the current @var{s} texture coordinate
+is used. See @code{glTexGen}.
@item @code{GL_TEXTURE_GEN_T}
If enabled and no vertex shader is active, the @var{t} texture
coordinate is computed using the texture generation function defined
-with @code{glTexGen}. Otherwise, the current @var{t} texture coordinate
-is used. See @code{glTexGen}.
+with @code{glTexGen}. Otherwise, the current @var{t} texture coordinate
+is used. See @code{glTexGen}.
@item @code{GL_VERTEX_PROGRAM_POINT_SIZE}
If enabled and a vertex shader is active, it specifies that the GL will
choose between front and back colors based on the polygon's face
-direction of which the vertex being shaded is a part. It has no effect
+direction of which the vertex being shaded is a part. It has no effect
on points or lines.
@end table
@item @var{v}
Specifies a value that is the domain coordinate @r{@var{v}} to the basis
-function defined in a previous @code{glMap2} command. This argument is
+function defined in a previous @code{glMap2} command. This argument is
not present in a @code{glEvalCoord1} command.
@end table
@code{glEvalCoord1} evaluates enabled one-dimensional maps at argument
-@var{u}. @code{glEvalCoord2} does the same for two-dimensional maps
-using two domain values, @var{u} and @var{v}. To define a map, call
+@var{u}. @code{glEvalCoord2} does the same for two-dimensional maps
+using two domain values, @var{u} and @var{v}. To define a map, call
@code{glMap1} and @code{glMap2}; to enable and disable it, call
@code{glEnable} and @code{glDisable}.
When one of the @code{glEvalCoord} commands is issued, all currently
-enabled maps of the indicated dimension are evaluated. Then, for each
+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 @code{GL_MAP1_INDEX} or
+with the computed value. That is, if @code{GL_MAP1_INDEX} or
@code{GL_MAP2_INDEX} is enabled, a @code{glIndex} command is simulated.
If @code{GL_MAP1_COLOR_4} or @code{GL_MAP2_COLOR_4} is enabled, a
-@code{glColor} command is simulated. If @code{GL_MAP1_NORMAL} or
+@code{glColor} command is simulated. If @code{GL_MAP1_NORMAL} or
@code{GL_MAP2_NORMAL} is enabled, a normal vector is produced, and if
any of @code{GL_MAP1_TEXTURE_COORD_1}, @code{GL_MAP1_TEXTURE_COORD_2},
@code{GL_MAP1_TEXTURE_COORD_3}, @code{GL_MAP1_TEXTURE_COORD_4},
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 @code{glVertex} commands are
+do not update the current values. Thus, if @code{glVertex} commands are
interspersed with @code{glEvalCoord} commands, the color, normal, and
texture coordinates associated with the @code{glVertex} commands are not
affected by the values generated by the @code{glEvalCoord} commands, but
only by the most recent @code{glColor}, @code{glIndex}, @code{glNormal},
and @code{glTexCoord} commands.
-No commands are issued for maps that are not enabled. If more than one
+No commands are issued for maps that are not enabled. If more than one
texture evaluation is enabled for a particular dimension (for example,
@code{GL_MAP2_TEXTURE_COORD_1} and @code{GL_MAP2_TEXTURE_COORD_2}), then
only the evaluation of the map that produces the larger number of
coordinates (in this case, @code{GL_MAP2_TEXTURE_COORD_2}) is carried
-out. @code{GL_MAP1_VERTEX_4} overrides @code{GL_MAP1_VERTEX_3}, and
+out. @code{GL_MAP1_VERTEX_4} overrides @code{GL_MAP1_VERTEX_3}, and
@code{GL_MAP2_VERTEX_4} overrides @code{GL_MAP2_VERTEX_3}, in the same
-manner. If neither a three- nor a four-component vertex map is enabled
+manner. If neither a three- nor a four-component vertex map is enabled
for the specified dimension, the @code{glEvalCoord} command is ignored.
If you have enabled automatic normal generation, by calling
@code{glEnable} with argument @code{GL_AUTO_NORMAL}, @code{glEvalCoord2}
generates surface normals analytically, regardless of the contents or
-enabling of the @code{GL_MAP2_NORMAL} map. Let
+enabling of the @code{GL_MAP2_NORMAL} map. Let
@r{@code{m}=∂@code{p},/∂@var{u},,×∂@code{p},/∂@var{v},,}
@r{@code{n}=@code{m}/∥@code{m},∥,}
If automatic normal generation is disabled, the corresponding normal map
-@code{GL_MAP2_NORMAL}, if enabled, is used to produce a normal. If
+@code{GL_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 @code{glEvalCoord2} commands.
@table @asis
@item @var{mode}
In @code{glEvalMesh1}, specifies whether to compute a one-dimensional
-mesh of points or lines. Symbolic constants @code{GL_POINT} and
+mesh of points or lines. Symbolic constants @code{GL_POINT} and
@code{GL_LINE} are accepted.
@item @var{i1}
generate and evaluate a series of evenly-spaced map domain values.
@code{glEvalMesh} steps through the integer domain of a one- or
two-dimensional grid, whose range is the domain of the evaluation maps
-specified by @code{glMap1} and @code{glMap2}. @var{mode} determines
+specified by @code{glMap1} and @code{glMap2}. @var{mode} determines
whether the resulting vertices are connected as points, lines, or filled
polygons.
@r{Δ@var{u}=(@var{u}_2-@var{u}_1,)/@var{n}}
and @r{@var{n}}, @r{@var{u}_1}, and @r{@var{u}_2} are the arguments to
-the most recent @code{glMapGrid1} command. @var{type} is
+the most recent @code{glMapGrid1} command. @var{type} is
@code{GL_POINTS} if @var{mode} is @code{GL_POINT}, or @code{GL_LINES} if
@var{mode} is @code{GL_LINE}.
where @r{@var{n}}, @r{@var{u}_1}, @r{@var{u}_2}, @r{@var{m}},
@r{@var{v}_1}, and @r{@var{v}_2} are the arguments to the most recent
-@code{glMapGrid2} command. Then, if @var{mode} is @code{GL_FILL}, the
+@code{glMapGrid2} command. Then, if @var{mode} is @code{GL_FILL}, the
@code{glEvalMesh2} command is equivalent to:
@code{glMapGrid} and @code{glEvalMesh} are used in tandem to efficiently
generate and evaluate a series of evenly spaced map domain values.
@code{glEvalPoint} can be used to evaluate a single grid point in the
-same gridspace that is traversed by @code{glEvalMesh}. Calling
+same gridspace that is traversed by @code{glEvalMesh}. Calling
@code{glEvalPoint1} is equivalent to calling where
@r{Δ@var{u}=(@var{u}_2-@var{u}_1,)/@var{n}}
@end example
and @r{@var{n}}, @r{@var{u}_1}, and @r{@var{u}_2} are the arguments to
-the most recent @code{glMapGrid1} command. The one absolute numeric
+the most recent @code{glMapGrid1} command. The one absolute numeric
requirement is that if @r{@var{i}=@var{n}}, then the value computed from
@r{@var{i}·Δ@var{u}+@var{u}_1} is exactly @r{@var{u}_2}.
where @r{@var{n}}, @r{@var{u}_1}, @r{@var{u}_2}, @r{@var{m}},
@r{@var{v}_1}, and @r{@var{v}_2} are the arguments to the most recent
-@code{glMapGrid2} command. Then the @code{glEvalPoint2} command is
+@code{glMapGrid2} command. Then the @code{glEvalPoint2} command is
equivalent to calling The only absolute numeric requirements are that if
@r{@var{i}=@var{n}}, then the value computed from
@r{@var{i}·Δ@var{u}+@var{u}_1} is exactly @r{@var{u}_2}, and if
@item @var{type}
Specifies a symbolic constant that describes the information that will
-be returned for each vertex. @code{GL_2D}, @code{GL_3D},
+be returned for each vertex. @code{GL_2D}, @code{GL_3D},
@code{GL_3D_COLOR}, @code{GL_3D_COLOR_TEXTURE}, and
@code{GL_4D_COLOR_TEXTURE} are accepted.
@end table
-The @code{glFeedbackBuffer} function controls feedback. Feedback, like
-selection, is a GL mode. The mode is selected by calling
-@code{glRenderMode} with @code{GL_FEEDBACK}. When the GL is in feedback
-mode, no pixels are produced by rasterization. Instead, information
+The @code{glFeedbackBuffer} function controls feedback. Feedback, like
+selection, is a GL mode. The mode is selected by calling
+@code{glRenderMode} with @code{GL_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.
@code{glFeedbackBuffer} has three arguments: @var{buffer} is a pointer
to an array of floating-point values into which feedback information is
-placed. @var{size} indicates the size of the array. @var{type} is a
+placed. @var{size} indicates the size of the array. @var{type} is a
symbolic constant describing the information that is fed back for each
-vertex. @code{glFeedbackBuffer} must be issued before feedback mode is
+vertex. @code{glFeedbackBuffer} must be issued before feedback mode is
enabled (by calling @code{glRenderMode} with argument
-@code{GL_FEEDBACK}). Setting @code{GL_FEEDBACK} without establishing
-the feedback buffer, or calling @code{glFeedbackBuffer} while the GL is
-in feedback mode, is an error.
+@code{GL_FEEDBACK}). Setting @code{GL_FEEDBACK} without establishing the
+feedback buffer, or calling @code{glFeedbackBuffer} while the GL is in
+feedback mode, is an error.
When @code{glRenderMode} 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 @var{size}. If the feedback data required more room
+feedback array pointer to the base of the feedback buffer. The returned
+value never exceeds @var{size}. If the feedback data required more room
than was available in @var{buffer}, @code{glRenderMode} returns a
-negative value. To take the GL out of feedback mode, call
+negative value. To take the GL out of feedback mode, call
@code{glRenderMode} with a parameter value other than
@code{GL_FEEDBACK}.
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
+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
+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
+that describe the primitive's vertices and associated data. Entries are
+also written for bitmaps and pixel rectangles. Feedback occurs after
polygon culling and @code{glPolygonMode} 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
+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.
The @code{glPassThrough} command can be used to insert a marker into the
-feedback buffer. See @code{glPassThrough}.
+feedback buffer. See @code{glPassThrough}.
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
+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 @var{type}.
Colors are fed back as four values in RGBA mode and one value in color
index mode.
@code{GL_DRAW_PIXEL_TOKEN}, @code{GL_COPY_PIXEL_TOKEN} and
@code{GL_PASS_THROUGH_TOKEN} are symbolic floating-point constants.
@code{GL_LINE_RESET_TOKEN} is returned whenever the line stipple pattern
-is reset. The data returned as a vertex depends on the feedback
+is reset. The data returned as a vertex depends on the feedback
@var{type}.
The following table gives the correspondence between @var{type} and the
-number of values per vertex. @var{k} is 1 in color index mode and 4 in
+number of values per vertex. @var{k} is 1 in color index mode and 4 in
RGBA mode.
@end table
Feedback vertex coordinates are in window coordinates, except @var{w},
-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
+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.
@code{GL_INVALID_ENUM} is generated if @var{type} is not an accepted
Block until all GL execution is complete.
@code{glFinish} does not return until the effects of all previously
-called GL commands are complete. Such effects include all changes to GL
+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.
Different GL implementations buffer commands in several different
locations, including network buffers and the graphics accelerator
-itself. @code{glFlush} empties all of these buffers, causing all issued
+itself. @code{glFlush} 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
+rendering engine. Though this execution may not be completed in any
particular time period, it does complete in finite time.
Because any GL program might be executed over a network, or on an
accelerator that buffers commands, all programs should call
@code{glFlush} whenever they count on having all of their previously
-issued commands completed. For example, call @code{glFlush} before
+issued commands completed. For example, call @code{glFlush} before
waiting for user input that depends on the generated image.
@code{GL_INVALID_OPERATION} is generated if @code{glFlush} is executed
@table @asis
@item @var{type}
-Specifies the data type of each fog coordinate. Symbolic constants
-@code{GL_FLOAT}, or @code{GL_DOUBLE} are accepted. The initial value is
+Specifies the data type of each fog coordinate. Symbolic constants
+@code{GL_FLOAT}, or @code{GL_DOUBLE} are accepted. The initial value is
@code{GL_FLOAT}.
@item @var{stride}
-Specifies the byte offset between consecutive fog coordinates. If
+Specifies the byte offset between consecutive fog coordinates. If
@var{stride} is 0, the array elements are understood to be tightly
-packed. The initial value is 0.
+packed. The initial value is 0.
@item @var{pointer}
Specifies a pointer to the first coordinate of the first fog coordinate
-in the array. The initial value is 0.
+in the array. The initial value is 0.
@end table
@code{glFogCoordPointer} specifies the location and data format of an
-array of fog coordinates to use when rendering. @var{type} specifies
-the data type of each fog coordinate, and @var{stride} specifies the
-byte stride from one fog coordinate to the next, allowing vertices and
+array of fog coordinates to use when rendering. @var{type} specifies the
+data type of each fog coordinate, and @var{stride} specifies the byte
+stride from one fog coordinate to the next, allowing vertices and
attributes to be packed into a single array or stored in separate
arrays.
If a non-zero named buffer object is bound to the @code{GL_ARRAY_BUFFER}
target (see @code{glBindBuffer}) while a fog coordinate array is
specified, @var{pointer} is treated as a byte offset into the buffer
-object's data store. Also, the buffer object binding
+object's data store. Also, the buffer object binding
(@code{GL_ARRAY_BUFFER_BINDING}) is saved as fog coordinate vertex array
client-side state (@code{GL_FOG_COORD_ARRAY_BUFFER_BINDING}).
To enable and disable the fog coordinate array, call
@code{glEnableClientState} and @code{glDisableClientState} with the
-argument @code{GL_FOG_COORD_ARRAY}. If enabled, the fog coordinate
-array is used when @code{glDrawArrays}, @code{glMultiDrawArrays},
+argument @code{GL_FOG_COORD_ARRAY}. If enabled, the fog coordinate array
+is used when @code{glDrawArrays}, @code{glMultiDrawArrays},
@code{glDrawElements}, @code{glMultiDrawElements},
@code{glDrawRangeElements}, or @code{glArrayElement} is called.
@end table
@code{glFogCoord} specifies the fog coordinate that is associated with
-each vertex and the current raster position. The value specified is
+each vertex and the current raster position. The value specified is
interpolated and used in computing the fog color (see @code{glFog}).
@end deftypefun
@table @asis
@item @var{pname}
-Specifies a single-valued fog parameter. @code{GL_FOG_MODE},
+Specifies a single-valued fog parameter. @code{GL_FOG_MODE},
@code{GL_FOG_DENSITY}, @code{GL_FOG_START}, @code{GL_FOG_END},
@code{GL_FOG_INDEX}, and @code{GL_FOG_COORD_SRC} are accepted.
@end table
-Fog is initially disabled. While enabled, fog affects rasterized
-geometry, bitmaps, and pixel blocks, but not buffer clear operations. To
+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 @code{glEnable} and @code{glDisable} with
argument @code{GL_FOG}.
@code{glFog} assigns the value or values in @var{params} to the fog
-parameter specified by @var{pname}. The following values are accepted
+parameter specified by @var{pname}. The following values are accepted
for @var{pname}:
@table @asis
@var{params} is a single integer or floating-point value that specifies
the equation to be used to compute the fog blend factor, @r{@var{f}}.
Three symbolic constants are accepted: @code{GL_LINEAR}, @code{GL_EXP},
-and @code{GL_EXP2}. The equations corresponding to these symbolic
-constants are defined below. The initial fog mode is @code{GL_EXP}.
+and @code{GL_EXP2}. The equations corresponding to these symbolic
+constants are defined below. The initial fog mode is @code{GL_EXP}.
@item @code{GL_FOG_DENSITY}
@var{params} is a single integer or floating-point value that specifies
@r{@var{density}}, the fog density used in both exponential fog
-equations. Only nonnegative densities are accepted. The initial fog
+equations. Only nonnegative densities are accepted. The initial fog
density is 1.
@item @code{GL_FOG_START}
@var{params} is a single integer or floating-point value that specifies
-@r{@var{start}}, the near distance used in the linear fog equation. The
+@r{@var{start}}, the near distance used in the linear fog equation. The
initial near distance is 0.
@item @code{GL_FOG_END}
@var{params} is a single integer or floating-point value that specifies
-@r{@var{end}}, the far distance used in the linear fog equation. The
+@r{@var{end}}, the far distance used in the linear fog equation. The
initial far distance is 1.
@item @code{GL_FOG_INDEX}
@var{params} is a single integer or floating-point value that specifies
-@r{@var{i}_@var{f}}, the fog color index. The initial fog index is 0.
+@r{@var{i}_@var{f}}, the fog color index. The initial fog index is 0.
@item @code{GL_FOG_COLOR}
@var{params} contains four integer or floating-point values that specify
-@r{@var{C}_@var{f}}, the fog color. Integer values are mapped linearly
+@r{@var{C}_@var{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 @r{-1.0}. Floating-point
-values are mapped directly. After conversion, all color components are
-clamped to the range @r{[0,1]}. The initial fog color is (0, 0, 0, 0).
+most negative representable value maps to @r{-1.0}. Floating-point
+values are mapped directly. After conversion, all color components are
+clamped to the range @r{[0,1]}. The initial fog color is (0, 0, 0, 0).
@item @code{GL_FOG_COORD_SRC}
@var{params} contains either of the following symbolic constants:
-@code{GL_FOG_COORD} or @code{GL_FRAGMENT_DEPTH}. @code{GL_FOG_COORD}
+@code{GL_FOG_COORD} or @code{GL_FRAGMENT_DEPTH}. @code{GL_FOG_COORD}
specifies that the current fog coordinate should be used as distance
-value in the fog color computation. @code{GL_FRAGMENT_DEPTH} specifies
+value in the fog color computation. @code{GL_FRAGMENT_DEPTH} specifies
that the current fragment depth should be used as distance value in the
fog computation.
@end table
Fog blends a fog color with each rasterized pixel fragment's
-post-texturing color using a blending factor @r{@var{f}}. Factor
+post-texturing color using a blending factor @r{@var{f}}. Factor
@r{@var{f}} is computed in one of three ways, depending on the fog mode.
Let @r{@var{c}} be either the distance in eye coordinate from the origin
(in the case that the @code{GL_FOG_COORD_SRC} is
@code{GL_FRAGMENT_DEPTH}) or the current fog coordinate (in the case
-that @code{GL_FOG_COORD_SRC} is @code{GL_FOG_COORD}). The equation for
+that @code{GL_FOG_COORD_SRC} is @code{GL_FOG_COORD}). The equation for
@code{GL_LINEAR} fog is
@r{@var{f}=@var{end}-@var{c},/@var{end}-@var{start},}
@r{@var{f}=@var{e}^-(@var{density}·@var{c},),^2}
Regardless of the fog mode, @r{@var{f}} is clamped to the range
-@r{[0,1]} after it is computed. Then, if the GL is in RGBA color mode,
+@r{[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
@r{@var{C}_@var{r}}, are replaced by
@table @asis
@item @var{mode}
-Specifies the orientation of front-facing polygons. @code{GL_CW} and
-@code{GL_CCW} are accepted. The initial value is @code{GL_CCW}.
+Specifies the orientation of front-facing polygons. @code{GL_CW} and
+@code{GL_CCW} are accepted. The initial value is @code{GL_CCW}.
@end table
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
-@code{glEnable} and @code{glDisable} with argument @code{GL_CULL_FACE}.
+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 @code{glEnable} and
+@code{glDisable} with argument @code{GL_CULL_FACE}.
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
+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.
@code{glFrontFace} specifies whether polygons with clockwise winding in
window coordinates, or counterclockwise winding in window coordinates,
-are taken to be front-facing. Passing @code{GL_CCW} to @var{mode}
+are taken to be front-facing. Passing @code{GL_CCW} to @var{mode}
selects counterclockwise polygons as front-facing; @code{GL_CW} selects
-clockwise polygons as front-facing. By default, counterclockwise
+clockwise polygons as front-facing. By default, counterclockwise
polygons are taken to be front-facing.
@code{GL_INVALID_ENUM} is generated if @var{mode} is not an accepted
@item @var{nearVal}
@itemx @var{farVal}
-Specify the distances to the near and far depth clipping planes. Both
+Specify the distances to the near and far depth clipping planes. Both
distances must be positive.
@end table
@code{glFrustum} describes a perspective matrix that produces a
-perspective projection. The current matrix (see @code{glMatrixMode}) is
+perspective projection. The current matrix (see @code{glMatrixMode}) is
multiplied by this matrix and the result replaces the current matrix, as
if @code{glMultMatrix} were called with the following matrix as its
argument:
@r{(@var{right},@var{top}-@var{nearVal})} 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).
-@r{-@var{farVal}} specifies the location of the far clipping plane. Both
+@r{-@var{farVal}} specifies the location of the far clipping plane. Both
@var{nearVal} and @var{farVal} must be positive.
Use @code{glPushMatrix} and @code{glPopMatrix} to save and restore the
@end table
@code{glGenBuffers} returns @var{n} buffer object names in
-@var{buffers}. There is no guarantee that the names form a contiguous
+@var{buffers}. 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 @code{glGenBuffers}.
@end table
-@code{glGenLists} has one argument, @var{range}. It returns an integer
+@code{glGenLists} has one argument, @var{range}. It returns an integer
@var{n} such that @var{range} contiguous empty display lists, named
@r{@var{n}}, @r{@var{n}+1}, @r{@var{...}}, @r{@var{n}+@var{range}-1},
-are created. If @var{range} is 0, if there is no group of @var{range}
+are created. If @var{range} is 0, if there is no group of @var{range}
contiguous names available, or if any error is generated, no display
lists are generated, and 0 is returned.
@end table
@code{glGetActiveAttrib} returns information about an active attribute
-variable in the program object specified by @var{program}. The number
-of active attributes can be obtained by calling @code{glGetProgram} with
-the value @code{GL_ACTIVE_ATTRIBUTES}. A value of 0 for @var{index}
-selects the first active attribute variable. Permissible values for
+variable in the program object specified by @var{program}. The number of
+active attributes can be obtained by calling @code{glGetProgram} with
+the value @code{GL_ACTIVE_ATTRIBUTES}. A value of 0 for @var{index}
+selects the first active attribute variable. Permissible values for
@var{index} range from 0 to the number of active attribute variables
minus 1.
A vertex shader may use either built-in attribute variables,
-user-defined attribute variables, or both. Built-in attribute variables
+user-defined attribute variables, or both. Built-in attribute variables
have a prefix of "gl_" and reference conventional OpenGL vertex
attribtes (e.g., @var{gl_Vertex}, @var{gl_Normal}, etc., see the OpenGL
Shading Language specification for a complete list.) User-defined
attribute variables have arbitrary names and obtain their values through
-numbered generic vertex attributes. An attribute variable (either
+numbered generic vertex attributes. An attribute variable (either
built-in or user-defined) is considered active if it is determined
during the link operation that it may be accessed during program
-execution. Therefore, @var{program} should have previously been the
+execution. Therefore, @var{program} should have previously been the
target of a call to @code{glLinkProgram}, but it is not necessary for it
to have been linked successfully.
The size of the character buffer required to store the longest attribute
variable name in @var{program} can be obtained by calling
@code{glGetProgram} with the value
-@code{GL_ACTIVE_ATTRIBUTE_MAX_LENGTH}. This value should be used to
+@code{GL_ACTIVE_ATTRIBUTE_MAX_LENGTH}. This value should be used to
allocate a buffer of sufficient size to store the returned attribute
-name. The size of this character buffer is passed in @var{bufSize}, and
+name. The size of this character buffer is passed in @var{bufSize}, and
a pointer to this character buffer is passed in @var{name}.
@code{glGetActiveAttrib} returns the name of the attribute variable
indicated by @var{index}, storing it in the character buffer specified
-by @var{name}. The string returned will be null terminated. The actual
+by @var{name}. The string returned will be null terminated. The actual
number of characters written into this buffer is returned in
@var{length}, and this count does not include the null termination
-character. If the length of the returned string is not required, a
-value of @code{NULL} can be passed in the @var{length} argument.
+character. If the length of the returned string is not required, a value
+of @code{NULL} can be passed in the @var{length} argument.
The @var{type} argument will return a pointer to the attribute
-variable's data type. The symbolic constants @code{GL_FLOAT},
+variable's data type. The symbolic constants @code{GL_FLOAT},
@code{GL_FLOAT_VEC2}, @code{GL_FLOAT_VEC3}, @code{GL_FLOAT_VEC4},
@code{GL_FLOAT_MAT2}, @code{GL_FLOAT_MAT3}, @code{GL_FLOAT_MAT4},
@code{GL_FLOAT_MAT2x3}, @code{GL_FLOAT_MAT2x4}, @code{GL_FLOAT_MAT3x2},
@code{GL_FLOAT_MAT3x4}, @code{GL_FLOAT_MAT4x2}, or
-@code{GL_FLOAT_MAT4x3} may be returned. The @var{size} argument will
+@code{GL_FLOAT_MAT4x3} may be returned. The @var{size} argument will
return the size of the attribute, in units of the type returned in
@var{type}.
user-defined attribute variable names.
This function will return as much information as it can about the
-specified active attribute variable. If no information is available,
-@var{length} will be 0, and @var{name} will be an empty string. This
+specified active attribute variable. If no information is available,
+@var{length} will be 0, and @var{name} will be an empty string. This
situation could occur if this function is called after a link operation
-that failed. If an error occurs, the return values @var{length},
+that failed. If an error occurs, the return values @var{length},
@var{size}, @var{type}, and @var{name} will be unmodified.
@code{GL_INVALID_VALUE} is generated if @var{program} is not a value
@end table
@code{glGetActiveUniform} returns information about an active uniform
-variable in the program object specified by @var{program}. The number
-of active uniform variables can be obtained by calling
-@code{glGetProgram} with the value @code{GL_ACTIVE_UNIFORMS}. A value
-of 0 for @var{index} selects the first active uniform variable.
-Permissible values for @var{index} range from 0 to the number of active
-uniform variables minus 1.
+variable in the program object specified by @var{program}. The number of
+active uniform variables can be obtained by calling @code{glGetProgram}
+with the value @code{GL_ACTIVE_UNIFORMS}. A value of 0 for @var{index}
+selects the first active uniform variable. Permissible values for
+@var{index} range from 0 to the number of active uniform variables minus
+1.
Shaders may use either built-in uniform variables, user-defined uniform
-variables, or both. Built-in uniform variables have a prefix of "gl_"
+variables, or both. Built-in uniform variables have a prefix of "gl_"
and reference existing OpenGL state or values derived from such state
(e.g., @var{gl_Fog}, @var{gl_ModelViewMatrix}, etc., see the OpenGL
Shading Language specification for a complete list.) User-defined
uniform variables have arbitrary names and obtain their values from the
-application through calls to @code{glUniform}. A uniform variable
+application through calls to @code{glUniform}. A uniform variable
(either built-in or user-defined) is considered active if it is
determined during the link operation that it may be accessed during
-program execution. Therefore, @var{program} should have previously been
+program execution. Therefore, @var{program} should have previously been
the target of a call to @code{glLinkProgram}, but it is not necessary
for it to have been linked successfully.
variable name in @var{program} can be obtained by calling
@code{glGetProgram} with the value @code{GL_ACTIVE_UNIFORM_MAX_LENGTH}.
This value should be used to allocate a buffer of sufficient size to
-store the returned uniform variable name. The size of this character
+store the returned uniform variable name. The size of this character
buffer is passed in @var{bufSize}, and a pointer to this character
buffer is passed in @var{name.}
@code{glGetActiveUniform} returns the name of the uniform variable
indicated by @var{index}, storing it in the character buffer specified
-by @var{name}. The string returned will be null terminated. The actual
+by @var{name}. The string returned will be null terminated. The actual
number of characters written into this buffer is returned in
@var{length}, and this count does not include the null termination
-character. If the length of the returned string is not required, a
-value of @code{NULL} can be passed in the @var{length} argument.
+character. If the length of the returned string is not required, a value
+of @code{NULL} can be passed in the @var{length} argument.
The @var{type} argument will return a pointer to the uniform variable's
-data type. The symbolic constants @code{GL_FLOAT},
-@code{GL_FLOAT_VEC2}, @code{GL_FLOAT_VEC3}, @code{GL_FLOAT_VEC4},
-@code{GL_INT}, @code{GL_INT_VEC2}, @code{GL_INT_VEC3},
-@code{GL_INT_VEC4}, @code{GL_BOOL}, @code{GL_BOOL_VEC2},
-@code{GL_BOOL_VEC3}, @code{GL_BOOL_VEC4}, @code{GL_FLOAT_MAT2},
-@code{GL_FLOAT_MAT3}, @code{GL_FLOAT_MAT4}, @code{GL_FLOAT_MAT2x3},
-@code{GL_FLOAT_MAT2x4}, @code{GL_FLOAT_MAT3x2}, @code{GL_FLOAT_MAT3x4},
-@code{GL_FLOAT_MAT4x2}, @code{GL_FLOAT_MAT4x3}, @code{GL_SAMPLER_1D},
-@code{GL_SAMPLER_2D}, @code{GL_SAMPLER_3D}, @code{GL_SAMPLER_CUBE},
+data type. The symbolic constants @code{GL_FLOAT}, @code{GL_FLOAT_VEC2},
+@code{GL_FLOAT_VEC3}, @code{GL_FLOAT_VEC4}, @code{GL_INT},
+@code{GL_INT_VEC2}, @code{GL_INT_VEC3}, @code{GL_INT_VEC4},
+@code{GL_BOOL}, @code{GL_BOOL_VEC2}, @code{GL_BOOL_VEC3},
+@code{GL_BOOL_VEC4}, @code{GL_FLOAT_MAT2}, @code{GL_FLOAT_MAT3},
+@code{GL_FLOAT_MAT4}, @code{GL_FLOAT_MAT2x3}, @code{GL_FLOAT_MAT2x4},
+@code{GL_FLOAT_MAT3x2}, @code{GL_FLOAT_MAT3x4}, @code{GL_FLOAT_MAT4x2},
+@code{GL_FLOAT_MAT4x3}, @code{GL_SAMPLER_1D}, @code{GL_SAMPLER_2D},
+@code{GL_SAMPLER_3D}, @code{GL_SAMPLER_CUBE},
@code{GL_SAMPLER_1D_SHADOW}, or @code{GL_SAMPLER_2D_SHADOW} may be
returned.
If one or more elements of an array are active, the name of the array is
returned in @var{name}, the type is returned in @var{type}, and the
@var{size} parameter returns the highest array element index used, plus
-one, as determined by the compiler and/or linker. Only one active
+one, as determined by the compiler and/or linker. Only one active
uniform variable will be reported for a uniform array.
Uniform variables that are declared as structures or arrays of
-structures will not be returned directly by this function. Instead,
-each of these uniform variables will be reduced to its fundamental
-components containing the "." and "[]" operators such that each of the
-names is valid as an argument to @code{glGetUniformLocation}. Each of
-these reduced uniform variables is counted as one active uniform
-variable and is assigned an index. A valid name cannot be a structure,
-an array of structures, or a subcomponent of a vector or matrix.
-
-The size of the uniform variable will be returned in @var{size}. Uniform
-variables other than arrays will have a size of 1. Structures and
-arrays of structures will be reduced as described earlier, such that
-each of the names returned will be a data type in the earlier list. If
-this reduction results in an array, the size returned will be as
-described for uniform arrays; otherwise, the size returned will be 1.
+structures will not be returned directly by this function. Instead, each
+of these uniform variables will be reduced to its fundamental components
+containing the "." and "[]" operators such that each of the names is
+valid as an argument to @code{glGetUniformLocation}. Each of these
+reduced uniform variables is counted as one active uniform variable and
+is assigned an index. A valid name cannot be a structure, an array of
+structures, or a subcomponent of a vector or matrix.
+
+The size of the uniform variable will be returned in @var{size}. Uniform
+variables other than arrays will have a size of 1. Structures and arrays
+of structures will be reduced as described earlier, such that each of
+the names returned will be a data type in the earlier list. If this
+reduction results in an array, the size returned will be as described
+for uniform arrays; otherwise, the size returned will be 1.
The list of active uniform variables may include both built-in uniform
variables (which begin with the prefix "gl_") as well as user-defined
uniform variable names.
This function will return as much information as it can about the
-specified active uniform variable. If no information is available,
-@var{length} will be 0, and @var{name} will be an empty string. This
+specified active uniform variable. If no information is available,
+@var{length} will be 0, and @var{name} will be an empty string. This
situation could occur if this function is called after a link operation
-that failed. If an error occurs, the return values @var{length},
+that failed. If an error occurs, the return values @var{length},
@var{size}, @var{type}, and @var{name} will be unmodified.
@code{GL_INVALID_VALUE} is generated if @var{program} is not a value
@end table
@code{glGetAttachedShaders} returns the names of the shader objects
-attached to @var{program}. The names of shader objects that are
-attached to @var{program} will be returned in @var{shaders.} The actual
-number of shader names written into @var{shaders} is returned in
-@var{count.} If no shader objects are attached to @var{program},
-@var{count} is set to 0. The maximum number of shader names that may be
-returned in @var{shaders} is specified by @var{maxCount}.
+attached to @var{program}. The names of shader objects that are attached
+to @var{program} will be returned in @var{shaders.} The actual number of
+shader names written into @var{shaders} is returned in @var{count.} If
+no shader objects are attached to @var{program}, @var{count} is set to
+0. The maximum number of shader names that may be returned in
+@var{shaders} is specified by @var{maxCount}.
If the number of names actually returned is not required (for instance,
if it has just been obtained by calling @code{glGetProgram}), a value of
-@code{NULL} may be passed for count. If no shader objects are attached
-to @var{program}, a value of 0 will be returned in @var{count}. The
+@code{NULL} may be passed for count. If no shader objects are attached
+to @var{program}, a value of 0 will be returned in @var{count}. The
actual number of attached shaders can be obtained by calling
@code{glGetProgram} with the value @code{GL_ATTACHED_SHADERS}.
@code{glGetAttribLocation} queries the previously linked program object
specified by @var{program} for the attribute variable specified by
@var{name} and returns the index of the generic vertex attribute that is
-bound to that attribute variable. If @var{name} is a matrix attribute
-variable, the index of the first column of the matrix is returned. If
+bound to that attribute variable. If @var{name} is a matrix attribute
+variable, the index of the first column of the matrix is returned. If
the named attribute variable is not an active attribute in the specified
program object or if @var{name} starts with the reserved prefix "gl_", a
value of -1 is returned.
The association between an attribute variable name and a generic
attribute index can be specified at any time by calling
-@code{glBindAttribLocation}. Attribute bindings do not go into effect
-until @code{glLinkProgram} is called. After a program object has been
+@code{glBindAttribLocation}. Attribute bindings do not go into effect
+until @code{glLinkProgram} is called. After a program object has been
linked successfully, the index values for attribute variables remain
-fixed until the next link command occurs. The attribute values can only
+fixed until the next link command occurs. The attribute values can only
be queried after a link if the link was successful.
@code{glGetAttribLocation} returns the binding that actually went into
effect the last time @code{glLinkProgram} was called for the specified
-program object. Attribute bindings that have been specified since the
+program object. Attribute bindings that have been specified since the
last link operation are not returned by @code{glGetAttribLocation}.
@code{GL_INVALID_OPERATION} is generated if @var{program} is not a value
@table @asis
@item @var{target}
-Specifies the target buffer object. The symbolic constant must be
+Specifies the target buffer object. The symbolic constant must be
@code{GL_ARRAY_BUFFER}, @code{GL_ELEMENT_ARRAY_BUFFER},
@code{GL_PIXEL_PACK_BUFFER}, or @code{GL_PIXEL_UNPACK_BUFFER}.
@item @var{value}
-Specifies the symbolic name of a buffer object parameter. Accepted
+Specifies the symbolic name of a buffer object parameter. Accepted
values are @code{GL_BUFFER_ACCESS}, @code{GL_BUFFER_MAPPED},
@code{GL_BUFFER_SIZE}, or @code{GL_BUFFER_USAGE}.
@table @asis
@item @code{GL_BUFFER_ACCESS}
@var{params} returns the access policy set while mapping the buffer
-object. The initial value is @code{GL_READ_WRITE}.
+object. The initial value is @code{GL_READ_WRITE}.
@item @code{GL_BUFFER_MAPPED}
@var{params} returns a flag indicating whether the buffer object is
-currently mapped. The initial value is @code{GL_FALSE}.
+currently mapped. The initial value is @code{GL_FALSE}.
@item @code{GL_BUFFER_SIZE}
@var{params} returns the size of the buffer object, measured in bytes.
The initial value is 0.
@item @code{GL_BUFFER_USAGE}
-@var{params} returns the buffer object's usage pattern. The initial
+@var{params} returns the buffer object's usage pattern. The initial
value is @code{GL_STATIC_DRAW}.
@end table
@table @asis
@item @var{target}
-Specifies the target buffer object. The symbolic constant must be
+Specifies the target buffer object. The symbolic constant must be
@code{GL_ARRAY_BUFFER}, @code{GL_ELEMENT_ARRAY_BUFFER},
@code{GL_PIXEL_PACK_BUFFER}, or @code{GL_PIXEL_UNPACK_BUFFER}.
@item @var{pname}
-Specifies the pointer to be returned. The symbolic constant must be
+Specifies the pointer to be returned. The symbolic constant must be
@code{GL_BUFFER_MAP_POINTER}.
@item @var{params}
@end table
-@code{glGetBufferPointerv} returns pointer information. @var{pname} is
-a symbolic constant indicating the pointer to be returned, which must be
+@code{glGetBufferPointerv} returns pointer information. @var{pname} is a
+symbolic constant indicating the pointer to be returned, which must be
@code{GL_BUFFER_MAP_POINTER}, the pointer to which the buffer object's
-data store is mapped. If the data store is not currently mapped,
-@code{NULL} is returned. @var{params} is a pointer to a location in
+data store is mapped. If the data store is not currently mapped,
+@code{NULL} is returned. @var{params} is a pointer to a location in
which to place the returned pointer value.
@code{GL_INVALID_ENUM} is generated if @var{target} or @var{pname} is
@table @asis
@item @var{target}
-Specifies the target buffer object. The symbolic constant must be
+Specifies the target buffer object. The symbolic constant must be
@code{GL_ARRAY_BUFFER}, @code{GL_ELEMENT_ARRAY_BUFFER},
@code{GL_PIXEL_PACK_BUFFER}, or @code{GL_PIXEL_UNPACK_BUFFER}.
@end table
@code{glGetBufferSubData} returns some or all of the data from the
-buffer object currently bound to @var{target}. Data starting at byte
+buffer object currently bound to @var{target}. Data starting at byte
offset @var{offset} and extending for @var{size} bytes is copied from
-the data store to the memory pointed to by @var{data}. An error is
+the data store to the memory pointed to by @var{data}. An error is
thrown if the buffer object is currently mapped, or if @var{offset} and
@var{size} together define a range beyond the bounds of the buffer
object's data store.
@table @asis
@item @var{plane}
-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
-@code{GL_CLIP_PLANE}@r{@var{i}} where i ranges from 0 to the value of
-@code{GL_MAX_CLIP_PLANES} - 1.
+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 @code{GL_CLIP_PLANE}@r{@var{i}}
+where i ranges from 0 to the value of @code{GL_MAX_CLIP_PLANES} - 1.
@item @var{equation}
Returns four double-precision values that are the coefficients of the
-plane equation of @var{plane} in eye coordinates. The initial value is
+plane equation of @var{plane} in eye coordinates. The initial value is
(0, 0, 0, 0).
@end table
@table @asis
@item @var{target}
-The target color table. Must be @code{GL_COLOR_TABLE},
+The target color table. Must be @code{GL_COLOR_TABLE},
@code{GL_POST_CONVOLUTION_COLOR_TABLE},
@code{GL_POST_COLOR_MATRIX_COLOR_TABLE}, @code{GL_PROXY_COLOR_TABLE},
@code{GL_PROXY_POST_CONVOLUTION_COLOR_TABLE}, or
@code{GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE}.
@item @var{pname}
-The symbolic name of a color lookup table parameter. Must be one of
+The symbolic name of a color lookup table parameter. Must be one of
@code{GL_COLOR_TABLE_BIAS}, @code{GL_COLOR_TABLE_SCALE},
@code{GL_COLOR_TABLE_FORMAT}, @code{GL_COLOR_TABLE_WIDTH},
@code{GL_COLOR_TABLE_RED_SIZE}, @code{GL_COLOR_TABLE_GREEN_SIZE},
When @var{pname} is set to @code{GL_COLOR_TABLE_SCALE} or
@code{GL_COLOR_TABLE_BIAS}, @code{glGetColorTableParameter} returns the
color table scale or bias parameters for the table specified by
-@var{target}. For these queries, @var{target} must be set to
+@var{target}. For these queries, @var{target} must be set to
@code{GL_COLOR_TABLE}, @code{GL_POST_CONVOLUTION_COLOR_TABLE}, or
@code{GL_POST_COLOR_MATRIX_COLOR_TABLE} and @var{params} points to an
array of four elements, which receive the scale or bias factors for red,
green, blue, and alpha, in that order.
@code{glGetColorTableParameter} can also be used to retrieve the format
-and size parameters for a color table. For these queries, set
+and size parameters for a color table. For these queries, set
@var{target} to either the color table target or the proxy color table
-target. The format and size parameters are set by @code{glColorTable}.
+target. The format and size parameters are set by @code{glColorTable}.
The following table lists the format and size parameters that may be
-queried. For each symbolic constant listed below for @var{pname},
+queried. For each symbolic constant listed below for @var{pname},
@var{params} must point to an array of the given length and receive the
values indicated.
or @code{GL_POST_COLOR_MATRIX_COLOR_TABLE}.
@item @var{format}
-The format of the pixel data in @var{table}. The possible values are
+The format of the pixel data in @var{table}. The possible values are
@code{GL_RED}, @code{GL_GREEN}, @code{GL_BLUE}, @code{GL_ALPHA},
@code{GL_LUMINANCE}, @code{GL_LUMINANCE_ALPHA}, @code{GL_RGB},
@code{GL_BGR}, @code{GL_RGBA}, and @code{GL_BGRA}.
@item @var{type}
-The type of the pixel data in @var{table}. Symbolic constants
+The type of the pixel data in @var{table}. Symbolic constants
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
@end table
@code{glGetColorTable} returns in @var{table} the contents of the color
-table specified by @var{target}. No pixel transfer operations are
+table specified by @var{target}. No pixel transfer operations are
performed, but pixel storage modes that are applicable to
@code{glReadPixels} are performed.
Color components that are requested in the specified @var{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
+are returned as zero. The assignments of internal color components to
the components requested by @var{format} are
@table @asis
@table @asis
@item @var{target}
-Specifies which texture is to be obtained. @code{GL_TEXTURE_1D},
+Specifies which texture is to be obtained. @code{GL_TEXTURE_1D},
@code{GL_TEXTURE_2D}, and
@code{GL_TEXTURE_3D}@code{GL_TEXTURE_CUBE_MAP_POSITIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_Z} are accepted.
@item @var{lod}
-Specifies the level-of-detail number of the desired image. Level 0 is
-the base image level. Level @r{@var{n}} is the @r{@var{n}}th mipmap
+Specifies the level-of-detail number of the desired image. Level 0 is
+the base image level. Level @r{@var{n}} is the @r{@var{n}}th mipmap
reduction image.
@item @var{img}
@end table
@code{glGetCompressedTexImage} returns the compressed texture image
-associated with @var{target} and @var{lod} into @var{img}. @var{img}
+associated with @var{target} and @var{lod} into @var{img}. @var{img}
should be an array of @code{GL_TEXTURE_COMPRESSED_IMAGE_SIZE} bytes.
@var{target} specifies whether the desired texture image was one
specified by @code{glTexImage1D} (@code{GL_TEXTURE_1D}),
@code{glTexImage2D} (@code{GL_TEXTURE_2D} or any of
@code{GL_TEXTURE_CUBE_MAP_*}), or @code{glTexImage3D}
-(@code{GL_TEXTURE_3D}). @var{lod} specifies the level-of-detail number
+(@code{GL_TEXTURE_3D}). @var{lod} specifies the level-of-detail number
of the desired image.
If a non-zero named buffer object is bound to the
To minimize errors, first verify that the texture is compressed by
calling @code{glGetTexLevelParameter} with argument
-@code{GL_TEXTURE_COMPRESSED}. If the texture is compressed, then
+@code{GL_TEXTURE_COMPRESSED}. If the texture is compressed, then
determine the amount of memory required to store the compressed texture
by calling @code{glGetTexLevelParameter} with argument
-@code{GL_TEXTURE_COMPRESSED_IMAGE_SIZE}. Finally, retrieve the internal
+@code{GL_TEXTURE_COMPRESSED_IMAGE_SIZE}. Finally, retrieve the internal
format of the texture by calling @code{glGetTexLevelParameter} with
-argument @code{GL_TEXTURE_INTERNAL_FORMAT}. To store the texture for
+argument @code{GL_TEXTURE_INTERNAL_FORMAT}. To store the texture for
later use, associate the internal format and size with the retrieved
-texture image. These data can be used by the respective texture or
+texture image. These data can be used by the respective texture or
subtexture loading routine used for loading @var{target} textures.
@code{GL_INVALID_VALUE} is generated if @var{lod} is less than zero or
@table @asis
@item @var{target}
-The filter to be retrieved. Must be one of @code{GL_CONVOLUTION_1D} or
+The filter to be retrieved. Must be one of @code{GL_CONVOLUTION_1D} or
@code{GL_CONVOLUTION_2D}.
@item @var{format}
-Format of the output image. Must be one of @code{GL_RED},
+Format of the output image. Must be one of @code{GL_RED},
@code{GL_GREEN}, @code{GL_BLUE}, @code{GL_ALPHA}, @code{GL_RGB},
@code{GL_BGR}, @code{GL_RGBA}, @code{GL_BGRA}, @code{GL_LUMINANCE}, or
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Data type of components in the output image. Symbolic constants
+Data type of components in the output image. Symbolic constants
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
@end table
@code{glGetConvolutionFilter} returns the current 1D or 2D convolution
-filter kernel as an image. The one- or two-dimensional image is placed
+filter kernel as an image. The one- or two-dimensional image is placed
in @var{image} according to the specifications in @var{format} and
-@var{type}. No pixel transfer operations are performed on this image,
+@var{type}. No pixel transfer operations are performed on this image,
but the relevant pixel storage modes are applied.
If a non-zero named buffer object is bound to the
into the buffer object's data store.
Color components that are present in @var{format} but not included in
-the internal format of the filter are returned as zero. The assignments
+the internal format of the filter are returned as zero. The assignments
of internal color components to the components of @var{format} are as
follows.
@table @asis
@item @var{target}
-The filter whose parameters are to be retrieved. Must be one of
+The filter whose parameters are to be retrieved. Must be one of
@code{GL_CONVOLUTION_1D}, @code{GL_CONVOLUTION_2D}, or
@code{GL_SEPARABLE_2D}.
@item @var{pname}
-The parameter to be retrieved. Must be one of
+The parameter to be retrieved. Must be one of
@code{GL_CONVOLUTION_BORDER_MODE}, @code{GL_CONVOLUTION_BORDER_COLOR},
@code{GL_CONVOLUTION_FILTER_SCALE}, @code{GL_CONVOLUTION_FILTER_BIAS},
@code{GL_CONVOLUTION_FORMAT}, @code{GL_CONVOLUTION_WIDTH},
@end table
@code{glGetConvolutionParameter} retrieves convolution parameters.
-@var{target} determines which convolution filter is queried. @var{pname}
+@var{target} determines which convolution filter is queried. @var{pname}
determines which parameter is returned:
@table @asis
@item @code{GL_CONVOLUTION_BORDER_MODE}
-The convolution border mode. See @code{glConvolutionParameter} for a
+The convolution border mode. See @code{glConvolutionParameter} for a
list of border modes.
@item @code{GL_CONVOLUTION_BORDER_COLOR}
-The current convolution border color. @var{params} must be a pointer to
+The current convolution border color. @var{params} must be a pointer to
an array of four elements, which will receive the red, green, blue, and
alpha border colors.
@item @code{GL_CONVOLUTION_FILTER_SCALE}
-The current filter scale factors. @var{params} must be a pointer to an
+The current filter scale factors. @var{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.
@item @code{GL_CONVOLUTION_FILTER_BIAS}
-The current filter bias factors. @var{params} must be a pointer to an
+The current filter bias factors. @var{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.
@item @code{GL_CONVOLUTION_FORMAT}
-The current internal format. See @code{glConvolutionFilter1D},
+The current internal format. See @code{glConvolutionFilter1D},
@code{glConvolutionFilter2D}, and @code{glSeparableFilter2D} for lists
of allowable formats.
@deftypefun GLenum glGetError
Return error information.
-@code{glGetError} 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
+@code{glGetError} 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 @code{glGetError} is called, the error
-code is returned, and the flag is reset to @code{GL_NO_ERROR}. If a
-call to @code{glGetError} returns @code{GL_NO_ERROR}, there has been no
+code is returned, and the flag is reset to @code{GL_NO_ERROR}. If a call
+to @code{glGetError} returns @code{GL_NO_ERROR}, there has been no
detectable error since the last call to @code{glGetError}, or since the
GL was initialized.
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 @code{GL_NO_ERROR} when
-@code{glGetError} is called. If more than one flag has recorded an
+flags. If any single error flag has recorded an error, the value of that
+flag is returned and that flag is reset to @code{GL_NO_ERROR} when
+@code{glGetError} is called. If more than one flag has recorded an
error, @code{glGetError} returns and clears an arbitrary error flag
-value. Thus, @code{glGetError} should always be called in a loop, until
+value. Thus, @code{glGetError} should always be called in a loop, until
it returns @code{GL_NO_ERROR}, if all error flags are to be reset.
Initially, all error flags are set to @code{GL_NO_ERROR}.
@table @asis
@item @code{GL_NO_ERROR}
-No error has been recorded. The value of this symbolic constant is
+No error has been recorded. The value of this symbolic constant is
guaranteed to be 0.
@item @code{GL_INVALID_ENUM}
-An unacceptable value is specified for an enumerated argument. The
+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.
@item @code{GL_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.
+A numeric argument is out of range. The offending command is ignored and
+has no other side effect than to set the error flag.
@item @code{GL_INVALID_OPERATION}
-The specified operation is not allowed in the current state. The
+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.
@item @code{GL_STACK_OVERFLOW}
-This command would cause a stack overflow. The offending command is
+This command would cause a stack overflow. The offending command is
ignored and has no other side effect than to set the error flag.
@item @code{GL_STACK_UNDERFLOW}
-This command would cause a stack underflow. The offending command is
+This command would cause a stack underflow. The offending command is
ignored and has no other side effect than to set the error flag.
@item @code{GL_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
+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.
@item @code{GL_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.
+size. The offending command is ignored and has no other side effect than
+to set the error flag.
@end table
When an error flag is set, results of a GL operation are undefined only
-if @code{GL_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 @code{glGetError} itself generates an error, it
-returns 0.
+if @code{GL_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 @code{glGetError} itself generates an error, it returns 0.
@code{GL_INVALID_OPERATION} is generated if @code{glGetError} is
executed between the execution of @code{glBegin} and the corresponding
-execution of @code{glEnd}. In this case, @code{glGetError} returns 0.
+execution of @code{glEnd}. In this case, @code{glGetError} returns 0.
@end deftypefun
Must be one of @code{GL_HISTOGRAM} or @code{GL_PROXY_HISTOGRAM}.
@item @var{pname}
-The name of the parameter to be retrieved. Must be one of
+The name of the parameter to be retrieved. Must be one of
@code{GL_HISTOGRAM_WIDTH}, @code{GL_HISTOGRAM_FORMAT},
@code{GL_HISTOGRAM_RED_SIZE}, @code{GL_HISTOGRAM_GREEN_SIZE},
@code{GL_HISTOGRAM_BLUE_SIZE}, @code{GL_HISTOGRAM_ALPHA_SIZE},
@end table
@code{glGetHistogramParameter} is used to query parameter values for the
-current histogram or for a proxy. The histogram state information may
-be queried by calling @code{glGetHistogramParameter} with a @var{target}
-of @code{GL_HISTOGRAM} (to obtain information for the current histogram
+current histogram or for a proxy. The histogram state information may be
+queried by calling @code{glGetHistogramParameter} with a @var{target} of
+@code{GL_HISTOGRAM} (to obtain information for the current histogram
table) or @code{GL_PROXY_HISTOGRAM} (to obtain information from the most
recent proxy request) and one of the following values for the
@var{pname} argument:
@item @var{reset}
If @code{GL_TRUE}, each component counter that is actually returned is
-reset to zero. (Other counters are unaffected.) If @code{GL_FALSE},
-none of the counters in the histogram table is modified.
+reset to zero. (Other counters are unaffected.) If @code{GL_FALSE}, none
+of the counters in the histogram table is modified.
@item @var{format}
-The format of values to be returned in @var{values}. Must be one of
+The format of values to be returned in @var{values}. Must be one of
@code{GL_RED}, @code{GL_GREEN}, @code{GL_BLUE}, @code{GL_ALPHA},
@code{GL_RGB}, @code{GL_BGR}, @code{GL_RGBA}, @code{GL_BGRA},
@code{GL_LUMINANCE}, or @code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-The type of values to be returned in @var{values}. Symbolic constants
+The type of values to be returned in @var{values}. Symbolic constants
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
@end table
@code{glGetHistogram} returns the current histogram table as a
-one-dimensional image with the same width as the histogram. No pixel
+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.
Color components that are requested in the specified @var{format}, but
which are not included in the internal format of the histogram, are
-returned as zero. The assignments of internal color components to the
+returned as zero. The assignments of internal color components to the
components requested by @var{format} are:
@table @asis
@table @asis
@item @var{light}
-Specifies a light source. The number of possible lights depends on the
-implementation, but at least eight lights are supported. They are
+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 @code{GL_LIGHT}@r{@var{i}}
where @r{@var{i}} ranges from 0 to the value of @code{GL_MAX_LIGHTS} -
1.
@item @var{pname}
-Specifies a light source parameter for @var{light}. Accepted symbolic
+Specifies a light source parameter for @var{light}. Accepted symbolic
names are @code{GL_AMBIENT}, @code{GL_DIFFUSE}, @code{GL_SPECULAR},
@code{GL_POSITION}, @code{GL_SPOT_DIRECTION}, @code{GL_SPOT_EXPONENT},
@code{GL_SPOT_CUTOFF}, @code{GL_CONSTANT_ATTENUATION},
@end table
@code{glGetLight} returns in @var{params} the value or values of a light
-source parameter. @var{light} names the light and is a symbolic name of
+source parameter. @var{light} names the light and is a symbolic name of
the form @code{GL_LIGHT}@r{@var{i}} where i ranges from 0 to the value
-of @code{GL_MAX_LIGHTS} - 1. @code{GL_MAX_LIGHTS} is an implementation
-dependent constant that is greater than or equal to eight. @var{pname}
+of @code{GL_MAX_LIGHTS} - 1. @code{GL_MAX_LIGHTS} is an implementation
+dependent constant that is greater than or equal to eight. @var{pname}
specifies one of ten light source parameters, again by symbolic name.
The following parameters are defined:
@table @asis
@item @code{GL_AMBIENT}
@var{params} returns four integer or floating-point values representing
-the ambient intensity of the light source. Integer values, when
+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 @r{-1.0} maps to the most negative representable
-integer value. If the internal value is outside the range @r{[-1,1]},
-the corresponding integer return value is undefined. The initial value
+integer value. If the internal value is outside the range @r{[-1,1]},
+the corresponding integer return value is undefined. The initial value
is (0, 0, 0, 1).
@item @code{GL_DIFFUSE}
@var{params} returns four integer or floating-point values representing
-the diffuse intensity of the light source. Integer values, when
+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 @r{-1.0} maps to the most negative representable
-integer value. If the internal value is outside the range @r{[-1,1]},
-the corresponding integer return value is undefined. The initial value
+integer value. If the internal value is outside the range @r{[-1,1]},
+the corresponding integer return value is undefined. The initial value
for @code{GL_LIGHT0} is (1, 1, 1, 1); for other lights, the initial
value is (0, 0, 0, 0).
@item @code{GL_SPECULAR}
@var{params} returns four integer or floating-point values representing
-the specular intensity of the light source. Integer values, when
+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 @r{-1.0} maps to the most negative representable
-integer value. If the internal value is outside the range @r{[-1,1]},
-the corresponding integer return value is undefined. The initial value
+integer value. If the internal value is outside the range @r{[-1,1]},
+the corresponding integer return value is undefined. The initial value
for @code{GL_LIGHT0} is (1, 1, 1, 1); for other lights, the initial
value is (0, 0, 0, 0).
@item @code{GL_POSITION}
@var{params} returns four integer or floating-point values representing
-the position of the light source. Integer values, when requested, are
+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
+integer value. The returned values are those maintained in eye
+coordinates. They will not be equal to the values specified using
@code{glLight}, unless the modelview matrix was identity at the time
-@code{glLight} was called. The initial value is (0, 0, 1, 0).
+@code{glLight} was called. The initial value is (0, 0, 1, 0).
@item @code{GL_SPOT_DIRECTION}
@var{params} returns three integer or floating-point values representing
-the direction of the light source. Integer values, when requested, are
+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
+integer value. The returned values are those maintained in eye
+coordinates. They will not be equal to the values specified using
@code{glLight}, unless the modelview matrix was identity at the time
-@code{glLight} was called. Although spot direction is normalized before
+@code{glLight} 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
+transformed versions of the specified values prior to normalization. The
initial value is @r{(0,0-1)}.
@item @code{GL_SPOT_EXPONENT}
@var{params} returns a single integer or floating-point value
-representing the spot exponent of the light. An integer value, when
+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.
+representation to the nearest integer. The initial value is 0.
@item @code{GL_SPOT_CUTOFF}
@var{params} returns a single integer or floating-point value
-representing the spot cutoff angle of the light. An integer value, when
+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.
+representation to the nearest integer. The initial value is 180.
@item @code{GL_CONSTANT_ATTENUATION}
@var{params} 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
+light. An integer value, when requested, is computed by rounding the
+internal floating-point representation to the nearest integer. The
initial value is 1.
@item @code{GL_LINEAR_ATTENUATION}
@var{params} 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.
+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.
@item @code{GL_QUADRATIC_ATTENUATION}
@var{params} returns a single integer or floating-point value
-representing the quadratic attenuation of the light. An integer 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.
+representation to the nearest integer. The initial value is 0.
@end table
@table @asis
@item @var{target}
-Specifies the symbolic name of a map. Accepted values are
+Specifies the symbolic name of a map. Accepted values are
@code{GL_MAP1_COLOR_4}, @code{GL_MAP1_INDEX}, @code{GL_MAP1_NORMAL},
@code{GL_MAP1_TEXTURE_COORD_1}, @code{GL_MAP1_TEXTURE_COORD_2},
@code{GL_MAP1_TEXTURE_COORD_3}, @code{GL_MAP1_TEXTURE_COORD_4},
@code{GL_MAP2_VERTEX_3}, and @code{GL_MAP2_VERTEX_4}.
@item @var{query}
-Specifies which parameter to return. Symbolic names @code{GL_COEFF},
+Specifies which parameter to return. Symbolic names @code{GL_COEFF},
@code{GL_ORDER}, and @code{GL_DOMAIN} are accepted.
@item @var{v}
@end table
-@code{glMap1} and @code{glMap2} define evaluators. @code{glGetMap}
-returns evaluator parameters. @var{target} chooses a map, @var{query}
+@code{glMap1} and @code{glMap2} define evaluators. @code{glGetMap}
+returns evaluator parameters. @var{target} chooses a map, @var{query}
selects a specific parameter, and @var{v} points to storage where the
values will be returned.
@var{v} returns the control points for the evaluator function.
One-dimensional evaluators return @r{@var{order}} control points, and
two-dimensional evaluators return @r{@var{uorder}×@var{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 @r{@var{uorder}} index quickly and the @r{@var{vorder}} index after
-each row. Integer values, when requested, are computed by rounding the
+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
+@r{@var{uorder}} index quickly and the @r{@var{vorder}} index after each
+row. Integer values, when requested, are computed by rounding the
internal floating-point values to the nearest integer values.
@item @code{GL_ORDER}
-@var{v} returns the order of the evaluator function. One-dimensional
-evaluators return a single value, @r{@var{order}}. The initial value is
-1. Two-dimensional evaluators return two values, @r{@var{uorder}} and
-@r{@var{vorder}}. The initial value is 1,1.
+@var{v} returns the order of the evaluator function. One-dimensional
+evaluators return a single value, @r{@var{order}}. The initial value is
+1. Two-dimensional evaluators return two values, @r{@var{uorder}} and
+@r{@var{vorder}}. The initial value is 1,1.
@item @code{GL_DOMAIN}
@var{v} returns the linear @r{@var{u}} and @r{@var{v}} mapping
-parameters. One-dimensional evaluators return two values, @r{@var{u1}}
-and @r{@var{u2}}, as specified by @code{glMap1}. Two-dimensional
+parameters. One-dimensional evaluators return two values, @r{@var{u1}}
+and @r{@var{u2}}, as specified by @code{glMap1}. Two-dimensional
evaluators return four values (@r{@var{u1}}, @r{@var{u2}}, @r{@var{v1}},
-and @r{@var{v2}}) as specified by @code{glMap2}. Integer values, when
+and @r{@var{v2}}) as specified by @code{glMap2}. Integer values, when
requested, are computed by rounding the internal floating-point values
to the nearest integer values.
@table @asis
@item @var{face}
-Specifies which of the two materials is being queried. @code{GL_FRONT}
+Specifies which of the two materials is being queried. @code{GL_FRONT}
or @code{GL_BACK} are accepted, representing the front and back
materials, respectively.
@item @var{pname}
-Specifies the material parameter to return. @code{GL_AMBIENT},
+Specifies the material parameter to return. @code{GL_AMBIENT},
@code{GL_DIFFUSE}, @code{GL_SPECULAR}, @code{GL_EMISSION},
@code{GL_SHININESS}, and @code{GL_COLOR_INDEXES} are accepted.
@end table
@code{glGetMaterial} returns in @var{params} the value or values of
-parameter @var{pname} of material @var{face}. Six parameters are
+parameter @var{pname} of material @var{face}. Six parameters are
defined:
@table @asis
@item @code{GL_AMBIENT}
@var{params} 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 @r{-1.0} maps to the most negative representable
-integer value. If the internal value is outside the range @r{[-1,1]},
-the corresponding integer return value is undefined. The initial value
-is (0.2, 0.2, 0.2, 1.0)
+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
+@r{-1.0} maps to the most negative representable integer value. If the
+internal value is outside the range @r{[-1,1]}, the corresponding
+integer return value is undefined. The initial value is (0.2, 0.2, 0.2,
+1.0)
@item @code{GL_DIFFUSE}
@var{params} 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 @r{-1.0} maps to the most negative representable
-integer value. If the internal value is outside the range @r{[-1,1]},
-the corresponding integer return value is undefined. The initial value
-is (0.8, 0.8, 0.8, 1.0).
+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
+@r{-1.0} maps to the most negative representable integer value. If the
+internal value is outside the range @r{[-1,1]}, the corresponding
+integer return value is undefined. The initial value is (0.8, 0.8, 0.8,
+1.0).
@item @code{GL_SPECULAR}
@var{params} returns four integer or floating-point values representing
-the specular reflectance of the material. Integer values, when
+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 @r{-1.0} maps to the most negative representable
-integer value. If the internal value is outside the range @r{[-1,1]},
-the corresponding integer return value is undefined. The initial value
+integer value. If the internal value is outside the range @r{[-1,1]},
+the corresponding integer return value is undefined. The initial value
is (0, 0, 0, 1).
@item @code{GL_EMISSION}
@var{params} returns four integer or floating-point values representing
-the emitted light intensity of the material. Integer values, when
+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 @r{-1.0} maps to the most negative representable
-integer value. If the internal value is outside the range @r{[-1,1]},
-the corresponding integer return value is undefined. The initial value
+integer value. If the internal value is outside the range @r{[-1,1]},
+the corresponding integer return value is undefined. The initial value
is (0, 0, 0, 1).
@item @code{GL_SHININESS}
@var{params} returns one integer or floating-point value representing
-the specular exponent of the material. Integer values, when requested,
+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.
+nearest integer value. The initial value is 0.
@item @code{GL_COLOR_INDEXES}
@var{params} 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
+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.
Must be @code{GL_MINMAX}.
@item @var{pname}
-The parameter to be retrieved. Must be one of @code{GL_MINMAX_FORMAT}
-or @code{GL_MINMAX_SINK}.
+The parameter to be retrieved. Must be one of @code{GL_MINMAX_FORMAT} or
+@code{GL_MINMAX_SINK}.
@item @var{params}
A pointer to storage for the retrieved parameters.
@item @var{reset}
If @code{GL_TRUE}, all entries in the minmax table that are actually
-returned are reset to their initial values. (Other entries are
+returned are reset to their initial values. (Other entries are
unaltered.) If @code{GL_FALSE}, the minmax table is unaltered.
@item @var{format}
-The format of the data to be returned in @var{values}. Must be one of
+The format of the data to be returned in @var{values}. Must be one of
@code{GL_RED}, @code{GL_GREEN}, @code{GL_BLUE}, @code{GL_ALPHA},
@code{GL_RGB}, @code{GL_BGR}, @code{GL_RGBA}, @code{GL_BGRA},
@code{GL_LUMINANCE}, or @code{GL_LUMINANCE_ALPHA}.
@item @var{types}
-The type of the data to be returned in @var{values}. Symbolic constants
+The type of the data to be returned in @var{values}. Symbolic constants
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
@code{glGetMinmax} 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
+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 @var{format}, and their type is determined by @var{types}.
If a non-zero named buffer object is bound to the
No pixel transfer operations are performed on the return values, but
pixel storage modes that are applicable to one-dimensional images are
-performed. Color components that are requested in the specified
+performed. Color components that are requested in the specified
@var{format}, but that are not included in the internal format of the
-minmax table, are returned as zero. The assignment of internal color
+minmax table, are returned as zero. The assignment of internal color
components to the components requested by @var{format} are as follows:
@end table
If @var{reset} is @code{GL_TRUE}, the minmax table entries corresponding
-to the return values are reset to their initial values. Minimum and
+to the return values are reset to their initial values. Minimum and
maximum values that are not returned are not modified, even if
@var{reset} is @code{GL_TRUE}.
@table @asis
@item @var{map}
-Specifies the name of the pixel map to return. Accepted values are
+Specifies the name of the pixel map to return. Accepted values are
@code{GL_PIXEL_MAP_I_TO_I}, @code{GL_PIXEL_MAP_S_TO_S},
@code{GL_PIXEL_MAP_I_TO_R}, @code{GL_PIXEL_MAP_I_TO_G},
@code{GL_PIXEL_MAP_I_TO_B}, @code{GL_PIXEL_MAP_I_TO_A},
@end table
See the @code{glPixelMap} reference page for a description of the
-acceptable values for the @var{map} parameter. @code{glGetPixelMap}
+acceptable values for the @var{map} parameter. @code{glGetPixelMap}
returns in @var{data} the contents of the pixel map specified in
-@var{map}. Pixel maps are used during the execution of
+@var{map}. Pixel maps are used during the execution of
@code{glReadPixels}, @code{glDrawPixels}, @code{glCopyPixels},
@code{glTexImage1D}, @code{glTexImage2D}, @code{glTexImage3D},
@code{glTexSubImage1D}, @code{glTexSubImage2D}, @code{glTexSubImage3D},
@code{glCopyTexImage1D}, @code{glCopyTexImage2D},
@code{glCopyTexSubImage1D}, @code{glCopyTexSubImage2D}, and
-@code{glCopyTexSubImage3D}. to map color indices, stencil indices,
-color components, and depth components to other values.
+@code{glCopyTexSubImage3D}. to map color indices, stencil indices, color
+components, and depth components to other values.
If a non-zero named buffer object is bound to the
@code{GL_PIXEL_PACK_BUFFER} target (see @code{glBindBuffer}) while a
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
+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].
@table @asis
@item @var{pname}
-Specifies the array or buffer pointer to be returned. Symbolic
-constants @code{GL_COLOR_ARRAY_POINTER},
-@code{GL_EDGE_FLAG_ARRAY_POINTER}, @code{GL_FOG_COORD_ARRAY_POINTER},
-@code{GL_FEEDBACK_BUFFER_POINTER}, @code{GL_INDEX_ARRAY_POINTER},
-@code{GL_NORMAL_ARRAY_POINTER}, @code{GL_SECONDARY_COLOR_ARRAY_POINTER},
+Specifies the array or buffer pointer to be returned. Symbolic constants
+@code{GL_COLOR_ARRAY_POINTER}, @code{GL_EDGE_FLAG_ARRAY_POINTER},
+@code{GL_FOG_COORD_ARRAY_POINTER}, @code{GL_FEEDBACK_BUFFER_POINTER},
+@code{GL_INDEX_ARRAY_POINTER}, @code{GL_NORMAL_ARRAY_POINTER},
+@code{GL_SECONDARY_COLOR_ARRAY_POINTER},
@code{GL_SELECTION_BUFFER_POINTER},
@code{GL_TEXTURE_COORD_ARRAY_POINTER}, or @code{GL_VERTEX_ARRAY_POINTER}
are accepted.
@end table
-@code{glGetPointerv} returns pointer information. @var{pname} is a
+@code{glGetPointerv} returns pointer information. @var{pname} is a
symbolic constant indicating the pointer to be returned, and
@var{params} is a pointer to a location in which to place the returned
data.
object was bound to the @code{GL_ARRAY_BUFFER} target (see
@code{glBindBuffer}) when the desired pointer was previously specified,
the pointer returned is a byte offset into the buffer object's data
-store. Buffer objects are only available in OpenGL versions 1.5 and
+store. Buffer objects are only available in OpenGL versions 1.5 and
greater.
@code{GL_INVALID_ENUM} is generated if @var{pname} is not an accepted
@table @asis
@item @var{pattern}
-Returns the stipple pattern. The initial value is all 1's.
+Returns the stipple pattern. The initial value is all 1's.
@end table
@code{glGetPolygonStipple} returns to @var{pattern} a @r{32×32} polygon
-stipple pattern. The pattern is packed into memory as if
+stipple pattern. The pattern is packed into memory as if
@code{glReadPixels} with both @var{height} and @var{width} of 32,
@var{type} of @code{GL_BITMAP}, and @var{format} of
@code{GL_COLOR_INDEX} were called, and the stipple pattern were stored
-in an internal @r{32×32} color index buffer. Unlike
-@code{glReadPixels}, however, pixel transfer operations (shift, offset,
-pixel map) are not applied to the returned stipple image.
+in an internal @r{32×32} color index buffer. Unlike @code{glReadPixels},
+however, pixel transfer operations (shift, offset, pixel map) are not
+applied to the returned stipple image.
If a non-zero named buffer object is bound to the
@code{GL_PIXEL_PACK_BUFFER} target (see @code{glBindBuffer}) while a
@end table
@code{glGetProgramInfoLog} returns the information log for the specified
-program object. The information log for a program object is modified
-when the program object is linked or validated. The string that is
+program object. The information log for a program object is modified
+when the program object is linked or validated. The string that is
returned will be null terminated.
@code{glGetProgramInfoLog} returns in @var{infoLog} as much of the
information log as it can, up to a maximum of @var{maxLength}
-characters. The number of characters actually returned, excluding the
-null termination character, is specified by @var{length}. If the length
+characters. The number of characters actually returned, excluding the
+null termination character, is specified by @var{length}. If the length
of the returned string is not required, a value of @code{NULL} can be
-passed in the @var{length} argument. The size of the buffer required to
+passed in the @var{length} argument. The size of the buffer required to
store the returned information log can be obtained by calling
@code{glGetProgram} with the value @code{GL_INFO_LOG_LENGTH}.
The information log for a program object is either an empty string, or a
string containing information about the last link operation, or a string
-containing information about the last validation operation. It may
+containing information about the last validation operation. It may
contain diagnostic messages, warning messages, and other information.
When a program object is created, its information log will be a string
of length 0.
Specifies the program object to be queried.
@item @var{pname}
-Specifies the object parameter. Accepted symbolic names are
+Specifies the object parameter. Accepted symbolic names are
@code{GL_DELETE_STATUS}, @code{GL_LINK_STATUS},
@code{GL_VALIDATE_STATUS}, @code{GL_INFO_LOG_LENGTH},
@code{GL_ATTACHED_SHADERS}, @code{GL_ACTIVE_ATTRIBUTES},
@end table
@code{glGetProgram} returns in @var{params} the value of a parameter for
-a specific program object. The following parameters are defined:
+a specific program object. The following parameters are defined:
@table @asis
@item @code{GL_DELETE_STATUS}
@var{params} returns the number of characters in the information log for
@var{program} including the null termination character (i.e., the size
-of the character buffer required to store the information log). If
+of the character buffer required to store the information log). If
@var{program} has no information log, a value of 0 is returned.
@item @code{GL_ATTACHED_SHADERS}
@var{params} returns the length of the longest active uniform variable
name for @var{program}, including the null termination character (i.e.,
the size of the character buffer required to store the longest uniform
-variable name). If no active uniform variables exist, 0 is returned.
+variable name). If no active uniform variables exist, 0 is returned.
@end table
@table @asis
@item @var{target}
-Specifies a query object target. Must be @code{GL_SAMPLES_PASSED}.
+Specifies a query object target. Must be @code{GL_SAMPLES_PASSED}.
@item @var{pname}
-Specifies the symbolic name of a query object target parameter. Accepted
+Specifies the symbolic name of a query object target parameter. Accepted
values are @code{GL_CURRENT_QUERY} or @code{GL_QUERY_COUNTER_BITS}.
@item @var{params}
@code{glGetQueryiv} returns in @var{params} a selected parameter of the
query object target specified by @var{target}.
-@var{pname} names a specific query object target parameter. When
+@var{pname} names a specific query object target parameter. When
@var{target} is @code{GL_SAMPLES_PASSED}, @var{pname} can be as follows:
@table @asis
@item @code{GL_CURRENT_QUERY}
@var{params} returns the name of the currently active occlusion query
-object. If no occlusion query is active, 0 is returned. The initial
+object. If no occlusion query is active, 0 is returned. The initial
value is 0.
@item @code{GL_QUERY_COUNTER_BITS}
@var{params} returns the number of bits in the query counter used to
-accumulate passing samples. If the number of bits returned is 0, the
+accumulate passing samples. If the number of bits returned is 0, the
implementation does not support a query counter, and the results
obtained from @code{glGetQueryObject} are useless.
Specifies the name of a query object.
@item @var{pname}
-Specifies the symbolic name of a query object parameter. Accepted
-values are @code{GL_QUERY_RESULT} or @code{GL_QUERY_RESULT_AVAILABLE}.
+Specifies the symbolic name of a query object parameter. Accepted values
+are @code{GL_QUERY_RESULT} or @code{GL_QUERY_RESULT_AVAILABLE}.
@item @var{params}
Returns the requested data.
@code{glGetQueryObject} returns in @var{params} a selected parameter of
the query object specified by @var{id}.
-@var{pname} names a specific query object parameter. @var{pname} can be
+@var{pname} names a specific query object parameter. @var{pname} can be
as follows:
@table @asis
@item @code{GL_QUERY_RESULT}
@var{params} returns the value of the query object's passed samples
-counter. The initial value is 0.
+counter. The initial value is 0.
@item @code{GL_QUERY_RESULT_AVAILABLE}
@var{params} returns whether the passed samples counter is immediately
-available. If a delay would occur waiting for the query result,
-@code{GL_FALSE} is returned. Otherwise, @code{GL_TRUE} is returned,
+available. If a delay would occur waiting for the query result,
+@code{GL_FALSE} is returned. Otherwise, @code{GL_TRUE} is returned,
which also indicates that the results of all previous queries are
available as well.
@table @asis
@item @var{target}
-The separable filter to be retrieved. Must be @code{GL_SEPARABLE_2D}.
+The separable filter to be retrieved. Must be @code{GL_SEPARABLE_2D}.
@item @var{format}
-Format of the output images. Must be one of @code{GL_RED},
+Format of the output images. Must be one of @code{GL_RED},
@code{GL_GREEN}, @code{GL_BLUE}, @code{GL_ALPHA}, @code{GL_RGB},
@code{GL_BGR}@code{GL_RGBA}, @code{GL_BGRA}, @code{GL_LUMINANCE}, or
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Data type of components in the output images. Symbolic constants
+Data type of components in the output images. Symbolic constants
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
@end table
@code{glGetSeparableFilter} returns the two one-dimensional filter
-kernel images for the current separable 2D convolution filter. The row
+kernel images for the current separable 2D convolution filter. The row
image is placed in @var{row} and the column image is placed in
@var{column} according to the specifications in @var{format} and
-@var{type}. (In the current implementation, @var{span} is not affected
+@var{type}. (In the current implementation, @var{span} is not affected
in any way.) No pixel transfer operations are performed on the images,
but the relevant pixel storage modes are applied.
store.
Color components that are present in @var{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
-@var{format} are as follows:
+the internal format of the filters are returned as zero. The assignments
+of internal color components to the components of @var{format} are as
+follows:
@end table
@code{glGetShaderInfoLog} returns the information log for the specified
-shader object. The information log for a shader object is modified when
-the shader is compiled. The string that is returned will be null
+shader object. The information log for a shader object is modified when
+the shader is compiled. The string that is returned will be null
terminated.
@code{glGetShaderInfoLog} returns in @var{infoLog} as much of the
information log as it can, up to a maximum of @var{maxLength}
-characters. The number of characters actually returned, excluding the
-null termination character, is specified by @var{length}. If the length
+characters. The number of characters actually returned, excluding the
+null termination character, is specified by @var{length}. If the length
of the returned string is not required, a value of @code{NULL} can be
-passed in the @var{length} argument. The size of the buffer required to
+passed in the @var{length} argument. The size of the buffer required to
store the returned information log can be obtained by calling
@code{glGetShader} with the value @code{GL_INFO_LOG_LENGTH}.
The information log for a shader object is a string that may contain
diagnostic messages, warning messages, and other information about the
-last compile operation. When a shader object is created, its
-information log will be a string of length 0.
+last compile operation. When a shader object is created, its information
+log will be a string of length 0.
@code{GL_INVALID_VALUE} is generated if @var{shader} is not a value
generated by OpenGL.
@end table
@code{glGetShaderSource} returns the concatenation of the source code
-strings from the shader object specified by @var{shader}. The source
+strings from the shader object specified by @var{shader}. The source
code strings for a shader object are the result of a previous call to
-@code{glShaderSource}. The string returned by the function will be null
+@code{glShaderSource}. The string returned by the function will be null
terminated.
@code{glGetShaderSource} returns in @var{source} as much of the source
-code string as it can, up to a maximum of @var{bufSize} characters. The
+code string as it can, up to a maximum of @var{bufSize} characters. The
number of characters actually returned, excluding the null termination
-character, is specified by @var{length}. If the length of the returned
+character, is specified by @var{length}. If the length of the returned
string is not required, a value of @code{NULL} can be passed in the
-@var{length} argument. The size of the buffer required to store the
+@var{length} argument. The size of the buffer required to store the
returned source code string can be obtained by calling
@code{glGetShader} with the value @code{GL_SHADER_SOURCE_LENGTH}.
Specifies the shader object to be queried.
@item @var{pname}
-Specifies the object parameter. Accepted symbolic names are
+Specifies the object parameter. Accepted symbolic names are
@code{GL_SHADER_TYPE}, @code{GL_DELETE_STATUS},
@code{GL_COMPILE_STATUS}, @code{GL_INFO_LOG_LENGTH},
@code{GL_SHADER_SOURCE_LENGTH}.
@end table
@code{glGetShader} returns in @var{params} the value of a parameter for
-a specific shader object. The following parameters are defined:
+a specific shader object. The following parameters are defined:
@table @asis
@item @code{GL_SHADER_TYPE}
@item @code{GL_INFO_LOG_LENGTH}
@var{params} returns the number of characters in the information log for
@var{shader} including the null termination character (i.e., the size of
-the character buffer required to store the information log). If
+the character buffer required to store the information log). If
@var{shader} has no information log, a value of 0 is returned.
@item @code{GL_SHADER_SOURCE_LENGTH}
@var{params} returns the length of the concatenation of the source
strings that make up the shader source for the @var{shader}, including
-the null termination character. (i.e., the size of the character buffer
-required to store the shader source). If no source code exists, 0 is
+the null termination character. (i.e., the size of the character buffer
+required to store the shader source). If no source code exists, 0 is
returned.
@end table
@end table
@code{glGetString} returns a pointer to a static string describing some
-aspect of the current GL connection. @var{name} can be one of the
+aspect of the current GL connection. @var{name} can be one of the
following:
@table @asis
@item @code{GL_VENDOR}
-Returns the company responsible for this GL implementation. This name
+Returns the company responsible for this GL implementation. This name
does not change from release to release.
@item @code{GL_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.
+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.
@item @code{GL_VERSION}
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
-@code{GL_VENDOR} and @code{GL_RENDERER} together uniquely specify a
-platform. They do not change from release to release and should be used
-by platform-recognition algorithms.
+performance characteristics of these platforms. Strings @code{GL_VENDOR}
+and @code{GL_RENDERER} together uniquely specify a platform. They do not
+change from release to release and should be used by
+platform-recognition algorithms.
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 @code{GL_EXTENSIONS} string is a space-separated list
-of supported GL extensions. (Extension names never contain a space
+standard GL. These features may be implemented as extensions to the
+standard GL. The @code{GL_EXTENSIONS} string is a space-separated list
+of supported GL extensions. (Extension names never contain a space
character.)
The @code{GL_VERSION} and @code{GL_SHADING_LANGUAGE_VERSION} strings
-begin with a version number. The version number uses one of these
-forms:
+begin with a version number. The version number uses one of these forms:
@var{major_number.minor_number}@var{major_number.minor_number.release_number}
-Vendor-specific information may follow the version number. Its format
+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.
@table @asis
@item @var{target}
-Specifies a texture environment. May be @code{GL_TEXTURE_ENV},
+Specifies a texture environment. May be @code{GL_TEXTURE_ENV},
@code{GL_TEXTURE_FILTER_CONTROL}, or @code{GL_POINT_SPRITE}.
@item @var{pname}
-Specifies the symbolic name of a texture environment parameter. Accepted
+Specifies the symbolic name of a texture environment parameter. Accepted
values are @code{GL_TEXTURE_ENV_MODE}, @code{GL_TEXTURE_ENV_COLOR},
@code{GL_TEXTURE_LOD_BIAS}, @code{GL_COMBINE_RGB},
@code{GL_COMBINE_ALPHA}, @code{GL_SRC0_RGB}, @code{GL_SRC1_RGB},
@end table
@code{glGetTexEnv} returns in @var{params} selected values of a texture
-environment that was specified with @code{glTexEnv}. @var{target}
+environment that was specified with @code{glTexEnv}. @var{target}
specifies a texture environment.
When @var{target} is @code{GL_TEXTURE_FILTER_CONTROL}, @var{pname} must
-be @code{GL_TEXTURE_LOD_BIAS}. When @var{target} is
+be @code{GL_TEXTURE_LOD_BIAS}. When @var{target} is
@code{GL_POINT_SPRITE}, @var{pname} must be @code{GL_COORD_REPLACE}.
When @var{target} is @code{GL_TEXTURE_ENV}, @var{pname} can be
@code{GL_TEXTURE_ENV_MODE}, @code{GL_TEXTURE_ENV_COLOR},
@table @asis
@item @code{GL_TEXTURE_ENV_MODE}
@var{params} returns the single-valued texture environment mode, a
-symbolic constant. The initial value is @code{GL_MODULATE}.
+symbolic constant. The initial value is @code{GL_MODULATE}.
@item @code{GL_TEXTURE_ENV_COLOR}
@var{params} returns four integer or floating-point values that are the
-texture environment color. Integer values, when requested, are linearly
+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 @r{-1.0} maps to
-the most negative representable integer. The initial value is (0, 0, 0,
+the most negative representable integer. The initial value is (0, 0, 0,
0).
@item @code{GL_TEXTURE_LOD_BIAS}
@var{params} returns a single floating-point value that is the texture
-level-of-detail bias. The initial value is 0.
+level-of-detail bias. The initial value is 0.
@item @code{GL_COMBINE_RGB}
@var{params} returns a single symbolic constant value representing the
-current RGB combine mode. The initial value is @code{GL_MODULATE}.
+current RGB combine mode. The initial value is @code{GL_MODULATE}.
@item @code{GL_COMBINE_ALPHA}
@var{params} returns a single symbolic constant value representing the
-current alpha combine mode. The initial value is @code{GL_MODULATE}.
+current alpha combine mode. The initial value is @code{GL_MODULATE}.
@item @code{GL_SRC0_RGB}
@var{params} returns a single symbolic constant value representing the
-texture combiner zero's RGB source. The initial value is
+texture combiner zero's RGB source. The initial value is
@code{GL_TEXTURE}.
@item @code{GL_SRC1_RGB}
@var{params} returns a single symbolic constant value representing the
-texture combiner one's RGB source. The initial value is
+texture combiner one's RGB source. The initial value is
@code{GL_PREVIOUS}.
@item @code{GL_SRC2_RGB}
@var{params} returns a single symbolic constant value representing the
-texture combiner two's RGB source. The initial value is
+texture combiner two's RGB source. The initial value is
@code{GL_CONSTANT}.
@item @code{GL_SRC0_ALPHA}
@var{params} returns a single symbolic constant value representing the
-texture combiner zero's alpha source. The initial value is
+texture combiner zero's alpha source. The initial value is
@code{GL_TEXTURE}.
@item @code{GL_SRC1_ALPHA}
@var{params} returns a single symbolic constant value representing the
-texture combiner one's alpha source. The initial value is
+texture combiner one's alpha source. The initial value is
@code{GL_PREVIOUS}.
@item @code{GL_SRC2_ALPHA}
@var{params} returns a single symbolic constant value representing the
-texture combiner two's alpha source. The initial value is
+texture combiner two's alpha source. The initial value is
@code{GL_CONSTANT}.
@item @code{GL_OPERAND0_RGB}
@var{params} returns a single symbolic constant value representing the
-texture combiner zero's RGB operand. The initial value is
+texture combiner zero's RGB operand. The initial value is
@code{GL_SRC_COLOR}.
@item @code{GL_OPERAND1_RGB}
@var{params} returns a single symbolic constant value representing the
-texture combiner one's RGB operand. The initial value is
+texture combiner one's RGB operand. The initial value is
@code{GL_SRC_COLOR}.
@item @code{GL_OPERAND2_RGB}
@var{params} returns a single symbolic constant value representing the
-texture combiner two's RGB operand. The initial value is
+texture combiner two's RGB operand. The initial value is
@code{GL_SRC_ALPHA}.
@item @code{GL_OPERAND0_ALPHA}
@var{params} returns a single symbolic constant value representing the
-texture combiner zero's alpha operand. The initial value is
+texture combiner zero's alpha operand. The initial value is
@code{GL_SRC_ALPHA}.
@item @code{GL_OPERAND1_ALPHA}
@var{params} returns a single symbolic constant value representing the
-texture combiner one's alpha operand. The initial value is
+texture combiner one's alpha operand. The initial value is
@code{GL_SRC_ALPHA}.
@item @code{GL_OPERAND2_ALPHA}
@var{params} returns a single symbolic constant value representing the
-texture combiner two's alpha operand. The initial value is
+texture combiner two's alpha operand. The initial value is
@code{GL_SRC_ALPHA}.
@item @code{GL_RGB_SCALE}
@var{params} returns a single floating-point value representing the
-current RGB texture combiner scaling factor. The initial value is 1.0.
+current RGB texture combiner scaling factor. The initial value is 1.0.
@item @code{GL_ALPHA_SCALE}
@var{params} returns a single floating-point value representing the
-current alpha texture combiner scaling factor. The initial value is
-1.0.
+current alpha texture combiner scaling factor. The initial value is 1.0.
@item @code{GL_COORD_REPLACE}
@var{params} returns a single boolean value representing the current
-point sprite texture coordinate replacement enable state. The initial
+point sprite texture coordinate replacement enable state. The initial
value is @code{GL_FALSE}.
@end table
@table @asis
@item @var{coord}
-Specifies a texture coordinate. Must be @code{GL_S}, @code{GL_T},
+Specifies a texture coordinate. Must be @code{GL_S}, @code{GL_T},
@code{GL_R}, or @code{GL_Q}.
@item @var{pname}
-Specifies the symbolic name of the value(s) to be returned. Must be
+Specifies the symbolic name of the value(s) to be returned. Must be
either @code{GL_TEXTURE_GEN_MODE} or the name of one of the texture
generation plane equations: @code{GL_OBJECT_PLANE} or
@code{GL_EYE_PLANE}.
@code{glGetTexGen} returns in @var{params} selected parameters of a
texture coordinate generation function that was specified using
-@code{glTexGen}. @var{coord} names one of the (@var{s}, @var{t},
+@code{glTexGen}. @var{coord} names one of the (@var{s}, @var{t},
@var{r}, @var{q}) texture coordinates, using the symbolic constant
@code{GL_S}, @code{GL_T}, @code{GL_R}, or @code{GL_Q}.
@table @asis
@item @code{GL_TEXTURE_GEN_MODE}
@var{params} returns the single-valued texture generation function, a
-symbolic constant. The initial value is @code{GL_EYE_LINEAR}.
+symbolic constant. The initial value is @code{GL_EYE_LINEAR}.
@item @code{GL_OBJECT_PLANE}
@var{params} 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.
+object linear-coordinate generation. Integer values, when requested, are
+mapped directly from the internal floating-point representation.
@item @code{GL_EYE_PLANE}
@var{params} 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
+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 @code{glTexGen}, unless the
modelview matrix was identity when @code{glTexGen} was called.
@table @asis
@item @var{target}
-Specifies which texture is to be obtained. @code{GL_TEXTURE_1D},
+Specifies which texture is to be obtained. @code{GL_TEXTURE_1D},
@code{GL_TEXTURE_2D}, @code{GL_TEXTURE_3D},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_Z} are accepted.
@item @var{level}
-Specifies the level-of-detail number of the desired image. Level 0 is
-the base image level. Level @r{@var{n}} is the @r{@var{n}}th mipmap
+Specifies the level-of-detail number of the desired image. Level 0 is
+the base image level. Level @r{@var{n}} is the @r{@var{n}}th mipmap
reduction image.
@item @var{format}
-Specifies a pixel format for the returned data. The supported formats
+Specifies a pixel format for the returned data. The supported formats
are @code{GL_RED}, @code{GL_GREEN}, @code{GL_BLUE}, @code{GL_ALPHA},
@code{GL_RGB}, @code{GL_BGR}, @code{GL_RGBA}, @code{GL_BGRA},
@code{GL_LUMINANCE}, and @code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies a pixel type for the returned data. The supported types are
+Specifies a pixel type for the returned data. The supported types are
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_UNSIGNED_SHORT},
@code{GL_SHORT}, @code{GL_UNSIGNED_INT}, @code{GL_INT}, @code{GL_FLOAT},
@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
@code{GL_UNSIGNED_INT_2_10_10_10_REV}.
@item @var{img}
-Returns the texture image. Should be a pointer to an array of the type
+Returns the texture image. Should be a pointer to an array of the type
specified by @var{type}.
@end table
specified by @code{glTexImage1D} (@code{GL_TEXTURE_1D}),
@code{glTexImage2D} (@code{GL_TEXTURE_2D} or any of
@code{GL_TEXTURE_CUBE_MAP_*}), or @code{glTexImage3D}
-(@code{GL_TEXTURE_3D}). @var{level} specifies the level-of-detail
-number of the desired image. @var{format} and @var{type} specify the
-format and type of the desired image array. See the reference pages
+(@code{GL_TEXTURE_3D}). @var{level} specifies the level-of-detail number
+of the desired image. @var{format} and @var{type} specify the format and
+type of the desired image array. See the reference pages
@code{glTexImage1D} and @code{glDrawPixels} for a description of the
acceptable values for the @var{format} and @var{type} parameters,
respectively.
To understand the operation of @code{glGetTexImage}, consider the
selected internal four-component texture image to be an RGBA color
-buffer the size of the image. The semantics of @code{glGetTexImage} are
+buffer the size of the image. The semantics of @code{glGetTexImage} are
then identical to those of @code{glReadPixels}, with the exception that
no pixel transfer operations are performed, when called with the same
@var{format} and @var{type}, with @var{x} and @var{y} set to 0,
@var{width} set to the width of the texture image (including border if
one was specified), and @var{height} set to 1 for 1D images, or to the
height of the texture image (including border if one was specified) for
-2D images. Because the internal texture image is an RGBA image, pixel
+2D images. Because the internal texture image is an RGBA image, pixel
formats @code{GL_COLOR_INDEX}, @code{GL_STENCIL_INDEX}, and
@code{GL_DEPTH_COMPONENT} are not accepted, and pixel type
@code{GL_BITMAP} is not accepted.
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.
+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.
To determine the required size of @var{img}, use
@code{glGetTexLevelParameter} to determine the dimensions of the
@code{GL_PROXY_TEXTURE_CUBE_MAP}.
@item @var{level}
-Specifies the level-of-detail number of the desired image. Level 0 is
-the base image level. Level @r{@var{n}} is the @r{@var{n}}th mipmap
+Specifies the level-of-detail number of the desired image. Level 0 is
+the base image level. Level @r{@var{n}} is the @r{@var{n}}th mipmap
reduction image.
@item @var{pname}
@code{GL_PROXY_TEXTURE_CUBE_MAP}.
@code{GL_MAX_TEXTURE_SIZE}, and @code{GL_MAX_3D_TEXTURE_SIZE} are not
-really descriptive enough. It has to report the largest square texture
+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
+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 @code{glGetTexLevelParameter}, are set to 0.
@var{params} returns a single value, the width of the texture image.
-This value includes the border of the texture image. The initial value
+This value includes the border of the texture image. The initial value
is 0.
@item @code{GL_TEXTURE_HEIGHT}
@var{params} returns a single value, the height of the texture image.
-This value includes the border of the texture image. The initial value
+This value includes the border of the texture image. The initial value
is 0.
@item @code{GL_TEXTURE_DEPTH}
@var{params} returns a single value, the depth of the texture image.
-This value includes the border of the texture image. The initial value
+This value includes the border of the texture image. The initial value
is 0.
@item @code{GL_TEXTURE_INTERNAL_FORMAT}
@var{params} returns a single value, the width in pixels of the border
-of the texture image. The initial value is 0.
+of the texture image. The initial value is 0.
@item @code{GL_TEXTURE_RED_SIZE},
@item @code{GL_TEXTURE_GREEN_SIZE},
@item @code{GL_TEXTURE_DEPTH_SIZE}
-The internal storage resolution of an individual component. The
+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
@code{glTexImage1D}, @code{glTexImage2D}, @code{glTexImage3D},
-@code{glCopyTexImage1D}, and @code{glCopyTexImage2D}. The initial value
+@code{glCopyTexImage1D}, and @code{glCopyTexImage2D}. The initial value
is 0.
@item @code{GL_TEXTURE_COMPRESSED}
@var{params} returns a single boolean value indicating if the texture
-image is stored in a compressed internal format. The initiali value is
+image is stored in a compressed internal format. The initiali value is
@code{GL_FALSE}.
@item @code{GL_TEXTURE_COMPRESSED_IMAGE_SIZE}
@table @asis
@item @var{target}
-Specifies the symbolic name of the target texture. @code{GL_TEXTURE_1D},
+Specifies the symbolic name of the target texture. @code{GL_TEXTURE_1D},
@code{GL_TEXTURE_2D}, @code{GL_TEXTURE_3D}, and
@code{GL_TEXTURE_CUBE_MAP} are accepted.
@end table
@code{glGetTexParameter} returns in @var{params} the value or values of
-the texture parameter specified as @var{pname}. @var{target} defines
-the target texture, either @code{GL_TEXTURE_1D}, @code{GL_TEXTURE_2D},
+the texture parameter specified as @var{pname}. @var{target} defines the
+target texture, either @code{GL_TEXTURE_1D}, @code{GL_TEXTURE_2D},
@code{GL_TEXTURE_3D}, or @code{GL_TEXTURE_CUBE_MAP}, to specify one-,
-two-, or three-dimensional or cube-mapped texturing. @var{pname}
-accepts the same symbols as @code{glTexParameter}, with the same
+two-, or three-dimensional or cube-mapped texturing. @var{pname} accepts
+the same symbols as @code{glTexParameter}, with the same
interpretations:
@table @asis
@item @code{GL_TEXTURE_MAG_FILTER}
Returns the single-valued texture magnification filter, a symbolic
-constant. The initial value is @code{GL_LINEAR}.
+constant. The initial value is @code{GL_LINEAR}.
@item @code{GL_TEXTURE_MIN_FILTER}
Returns the single-valued texture minification filter, a symbolic
-constant. The initial value is @code{GL_NEAREST_MIPMAP_LINEAR}.
+constant. The initial value is @code{GL_NEAREST_MIPMAP_LINEAR}.
@item @code{GL_TEXTURE_MIN_LOD}
-Returns the single-valued texture minimum level-of-detail value. The
+Returns the single-valued texture minimum level-of-detail value. The
initial value is @r{-1000}.
@item @code{GL_TEXTURE_MAX_LOD}
-Returns the single-valued texture maximum level-of-detail value. The
+Returns the single-valued texture maximum level-of-detail value. The
initial value is 1000.
@item @code{GL_TEXTURE_BASE_LEVEL}
-Returns the single-valued base texture mipmap level. The initial value
+Returns the single-valued base texture mipmap level. The initial value
is 0.
@item @code{GL_TEXTURE_MAX_LEVEL}
-Returns the single-valued maximum texture mipmap array level. The
+Returns the single-valued maximum texture mipmap array level. The
initial value is 1000.
@item @code{GL_TEXTURE_WRAP_S}
Returns the single-valued wrapping function for texture coordinate
-@r{@var{s}}, a symbolic constant. The initial value is
-@code{GL_REPEAT}.
+@r{@var{s}}, a symbolic constant. The initial value is @code{GL_REPEAT}.
@item @code{GL_TEXTURE_WRAP_T}
Returns the single-valued wrapping function for texture coordinate
-@r{@var{t}}, a symbolic constant. The initial value is
-@code{GL_REPEAT}.
+@r{@var{t}}, a symbolic constant. The initial value is @code{GL_REPEAT}.
@item @code{GL_TEXTURE_WRAP_R}
Returns the single-valued wrapping function for texture coordinate
-@r{@var{r}}, a symbolic constant. The initial value is
-@code{GL_REPEAT}.
+@r{@var{r}}, a symbolic constant. The initial value is @code{GL_REPEAT}.
@item @code{GL_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 @r{[0,1]}. Integer values are returned as a linear mapping of the
+color of the texture border. Floating-point values are returned in the
+range @r{[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 @r{-1.0} maps to the most negative
-representable integer. The initial value is (0, 0, 0, 0).
+representable integer. The initial value is (0, 0, 0, 0).
@item @code{GL_TEXTURE_PRIORITY}
Returns the residence priority of the target texture (or the named
-texture bound to it). The initial value is 1. See
+texture bound to it). The initial value is 1. See
@code{glPrioritizeTextures}.
@item @code{GL_TEXTURE_RESIDENT}
-Returns the residence status of the target texture. If the value
+Returns the residence status of the target texture. If the value
returned in @var{params} is @code{GL_TRUE}, the texture is resident in
-texture memory. See @code{glAreTexturesResident}.
+texture memory. See @code{glAreTexturesResident}.
@item @code{GL_TEXTURE_COMPARE_MODE}
Returns a single-valued texture comparison mode, a symbolic constant.
-The initial value is @code{GL_NONE}. See @code{glTexParameter}.
+The initial value is @code{GL_NONE}. See @code{glTexParameter}.
@item @code{GL_TEXTURE_COMPARE_FUNC}
Returns a single-valued texture comparison function, a symbolic
-constant. The initial value is @code{GL_LEQUAL}. See
+constant. The initial value is @code{GL_LEQUAL}. See
@code{glTexParameter}.
@item @code{GL_DEPTH_TEXTURE_MODE}
Returns a single-valued texture format indicating how the depth values
-should be converted into color components. The initial value is
-@code{GL_LUMINANCE}. See @code{glTexParameter}.
+should be converted into color components. The initial value is
+@code{GL_LUMINANCE}. See @code{glTexParameter}.
@item @code{GL_GENERATE_MIPMAP}
Returns a single boolean value indicating if automatic mipmap level
-updates are enabled. See @code{glTexParameter}.
+updates are enabled. See @code{glTexParameter}.
@end table
@code{glGetUniformLocation } returns an integer that represents the
location of a specific uniform variable within a program object.
@var{name} must be a null terminated string that contains no white
-space. @var{name} must be an active uniform variable name in
+space. @var{name} must be an active uniform variable name in
@var{program} that is not a structure, an array of structures, or a
-subcomponent of a vector or a matrix. This function returns -1 if
+subcomponent of a vector or a matrix. This function returns -1 if
@var{name} does not correspond to an active uniform variable in
@var{program} or if @var{name} starts with the reserved prefix "gl_".
Uniform variables that are structures or arrays of structures may be
queried by calling @code{glGetUniformLocation} for each field within the
-structure. The array element operator "[]" and the structure field
+structure. The array element operator "[]" and the structure field
operator "." may be used in @var{name} in order to select elements
-within an array or fields within a structure. The result of using these
+within an array or fields within a structure. The result of using these
operators is not allowed to be another structure, an array of
-structures, or a subcomponent of a vector or a matrix. Except if the
+structures, or a subcomponent of a vector or a matrix. Except if the
last part of @var{name} indicates a uniform variable array, the location
of the first element of an array can be retrieved by using the name of
the array, or by using the name appended by "[0]".
The actual locations assigned to uniform variables are not known until
-the program object is linked successfully. After linking has occurred,
+the program object is linked successfully. After linking has occurred,
the command @code{glGetUniformLocation} can be used to obtain the
-location of a uniform variable. This location value can then be passed
+location of a uniform variable. This location value can then be passed
to @code{glUniform} to set the value of the uniform variable or to
@code{glGetUniform} in order to query the current value of the uniform
-variable. After a program object has been linked successfully, the
-index values for uniform variables remain fixed until the next link
-command occurs. Uniform variable locations and values can only be
-queried after a link if the link was successful.
+variable. After a program object has been linked successfully, the index
+values for uniform variables remain fixed until the next link command
+occurs. Uniform variable locations and values can only be queried after
+a link if the link was successful.
@code{GL_INVALID_VALUE} is generated if @var{program} is not a value
generated by OpenGL.
@end table
@code{glGetUniform} returns in @var{params} the value(s) of the
-specified uniform variable. The type of the uniform variable specified
-by @var{location} determines the number of values returned. If the
+specified uniform variable. The type of the uniform variable specified
+by @var{location} determines the number of values returned. If the
uniform variable is defined in the shader as a boolean, int, or float, a
-single value will be returned. If it is defined as a vec2, ivec2, or
-bvec2, two values will be returned. If it is defined as a vec3, ivec3,
-or bvec3, three values will be returned, and so on. To query values
+single value will be returned. If it is defined as a vec2, ivec2, or
+bvec2, two values will be returned. If it is defined as a vec3, ivec3,
+or bvec3, three values will be returned, and so on. To query values
stored in uniform variables declared as arrays, call @code{glGetUniform}
-for each element of the array. To query values stored in uniform
+for each element of the array. To query values stored in uniform
variables declared as structures, call @code{glGetUniform} for each
-field in the structure. The values for uniform variables declared as a
+field in the structure. The values for uniform variables declared as a
matrix will be returned in column major order.
The locations assigned to uniform variables are not known until the
-program object is linked. After linking has occurred, the command
+program object is linked. After linking has occurred, the command
@code{glGetUniformLocation} can be used to obtain the location of a
-uniform variable. This location value can then be passed to
+uniform variable. This location value can then be passed to
@code{glGetUniform} in order to query the current value of the uniform
-variable. After a program object has been linked successfully, the
-index values for uniform variables remain fixed until the next link
-command occurs. The uniform variable values can only be queried after a
-link if the link was successful.
+variable. After a program object has been linked successfully, the index
+values for uniform variables remain fixed until the next link command
+occurs. The uniform variable values can only be queried after a link if
+the link was successful.
@code{GL_INVALID_VALUE} is generated if @var{program} is not a value
generated by OpenGL.
@item @var{pname}
Specifies the symbolic name of the generic vertex attribute parameter to
-be returned. Must be @code{GL_VERTEX_ATTRIB_ARRAY_POINTER}.
+be returned. Must be @code{GL_VERTEX_ATTRIB_ARRAY_POINTER}.
@item @var{pointer}
Returns the pointer value.
@item @var{pname}
Specifies the symbolic name of the vertex attribute parameter to be
-queried. Accepted values are
+queried. Accepted values are
@code{GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING},
@code{GL_VERTEX_ATTRIB_ARRAY_ENABLED},
@code{GL_VERTEX_ATTRIB_ARRAY_SIZE},
@end table
@code{glGetVertexAttrib} returns in @var{params} the value of a generic
-vertex attribute parameter. The generic vertex attribute to be queried
+vertex attribute parameter. The generic vertex attribute to be queried
is specified by @var{index}, and the parameter to be queried is
specified by @var{pname}.
@var{params} returns a single value, the name of the buffer object
currently bound to the binding point corresponding to generic vertex
-attribute array @var{index}. If no buffer object is bound, 0 is
-returned. The initial value is 0.
+attribute array @var{index}. If no buffer object is bound, 0 is
+returned. The initial value is 0.
@item @code{GL_VERTEX_ATTRIB_ARRAY_ENABLED}
@var{params} returns a single value that is non-zero (true) if the
vertex attribute array for @var{index} is enabled and 0 (false) if it is
-disabled. The initial value is @code{GL_FALSE}.
+disabled. The initial value is @code{GL_FALSE}.
@item @code{GL_VERTEX_ATTRIB_ARRAY_SIZE}
@var{params} returns a single value, the size of the vertex attribute
-array for @var{index}. The size is the number of values for each
-element of the vertex attribute array, and it will be 1, 2, 3, or 4. The
-initial value is 4.
+array for @var{index}. The size is the number of values for each element
+of the vertex attribute array, and it will be 1, 2, 3, or 4. The initial
+value is 4.
@item @code{GL_VERTEX_ATTRIB_ARRAY_STRIDE}
@var{params} returns a single value, the array stride for (number of
bytes between successive elements in) the vertex attribute array for
-@var{index}. A value of 0 indicates that the array elements are stored
-sequentially in memory. The initial value is 0.
+@var{index}. A value of 0 indicates that the array elements are stored
+sequentially in memory. The initial value is 0.
@item @code{GL_VERTEX_ATTRIB_ARRAY_TYPE}
@var{params} returns a single value, a symbolic constant indicating the
-array type for the vertex attribute array for @var{index}. Possible
+array type for the vertex attribute array for @var{index}. Possible
values are @code{GL_BYTE}, @code{GL_UNSIGNED_BYTE}, @code{GL_SHORT},
@code{GL_UNSIGNED_SHORT}, @code{GL_INT}, @code{GL_UNSIGNED_INT},
-@code{GL_FLOAT}, and @code{GL_DOUBLE}. The initial value is
+@code{GL_FLOAT}, and @code{GL_DOUBLE}. The initial value is
@code{GL_FLOAT}.
@item @code{GL_VERTEX_ATTRIB_ARRAY_NORMALIZED}
@var{params} returns a single value that is non-zero (true) if
fixed-point data types for the vertex attribute array indicated by
@var{index} are normalized when they are converted to floating point,
-and 0 (false) otherwise. The initial value is @code{GL_FALSE}.
+and 0 (false) otherwise. The initial value is @code{GL_FALSE}.
@item @code{GL_CURRENT_VERTEX_ATTRIB}
@var{params} returns four values that represent the current value for
-the generic vertex attribute specified by index. Generic vertex
+the generic vertex attribute specified by index. Generic vertex
attribute 0 is unique in that it has no current state, so an error will
-be generated if @var{index} is 0. The initial value for all other
+be generated if @var{index} is 0. The initial value for all other
generic vertex attributes is (0,0,0,1).
@end table
@table @asis
@item @var{pname}
-Specifies the parameter value to be returned. The symbolic constants in
+Specifies the parameter value to be returned. The symbolic constants in
the list below are accepted.
@item @var{params}
type in which to place the returned data.
Type conversion is performed if @var{params} has a different type than
-the state variable value being requested. If @code{glGetBooleanv} is
+the state variable value being requested. If @code{glGetBooleanv} is
called, a floating-point (or integer) value is converted to
-@code{GL_FALSE} if and only if it is 0.0 (or 0). Otherwise, it is
-converted to @code{GL_TRUE}. If @code{glGetIntegerv} is called, boolean
+@code{GL_FALSE} if and only if it is 0.0 (or 0). Otherwise, it is
+converted to @code{GL_TRUE}. If @code{glGetIntegerv} is called, boolean
values are returned as @code{GL_TRUE} or @code{GL_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 @r{-1.0} to the most negative representable integer value. If
+and @r{-1.0} to the most negative representable integer value. If
@code{glGetFloatv} or @code{glGetDoublev} is called, boolean values are
returned as @code{GL_TRUE} or @code{GL_FALSE}, and integer values are
converted to floating-point values.
@var{params} 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
+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
-@r{-1.0} returns the most negative representable integer value. The
-initial value is (0, 0, 0, 0). See @code{glClearAccum}.
+@r{-1.0} returns the most negative representable integer value. The
+initial value is (0, 0, 0, 0). See @code{glClearAccum}.
@item @code{GL_ACCUM_GREEN_BITS}
@var{params} returns a single value indicating the active multitexture
-unit. The initial value is @code{GL_TEXTURE0}. See
+unit. The initial value is @code{GL_TEXTURE0}. See
@code{glActiveTexture}.
@item @code{GL_ALIASED_POINT_SIZE_RANGE}
@var{params} returns one value, the alpha bias factor used during pixel
-transfers. The initial value is 0. See @code{glPixelTransfer}.
+transfers. The initial value is 0. See @code{glPixelTransfer}.
@item @code{GL_ALPHA_BITS}
@var{params} returns one value, the alpha scale factor used during pixel
-transfers. The initial value is 1. See @code{glPixelTransfer}.
+transfers. The initial value is 1. See @code{glPixelTransfer}.
@item @code{GL_ALPHA_TEST}
@var{params} returns a single boolean value indicating whether alpha
-testing of fragments is enabled. The initial value is @code{GL_FALSE}.
+testing of fragments is enabled. The initial value is @code{GL_FALSE}.
See @code{glAlphaFunc}.
@item @code{GL_ALPHA_TEST_FUNC}@var{params} returns one value,
-the symbolic name of the alpha test function. The initial value is
-@code{GL_ALWAYS}. See @code{glAlphaFunc}.
+the symbolic name of the alpha test function. The initial value is
+@code{GL_ALWAYS}. See @code{glAlphaFunc}.
@item @code{GL_ALPHA_TEST_REF}
@var{params} returns one value, the reference value for the alpha test.
-The initial value is 0. See @code{glAlphaFunc}. An integer value, if
+The initial value is 0. See @code{glAlphaFunc}. 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 @r{-1.0} returns the most negative representable
@var{params} returns a single value, the name of the buffer object
-currently bound to the target @code{GL_ARRAY_BUFFER}. If no buffer
-object is bound to this target, 0 is returned. The initial value is 0.
+currently bound to the target @code{GL_ARRAY_BUFFER}. If no buffer
+object is bound to this target, 0 is returned. The initial value is 0.
See @code{glBindBuffer}.
@item @code{GL_ATTRIB_STACK_DEPTH}
-@var{params} returns one value, the depth of the attribute stack. If
-the stack is empty, 0 is returned. The initial value is 0. See
+@var{params} returns one value, the depth of the attribute stack. If the
+stack is empty, 0 is returned. The initial value is 0. See
@code{glPushAttrib}.
@item @code{GL_AUTO_NORMAL}
@var{params} returns a single boolean value indicating whether 2D map
-evaluation automatically generates surface normals. The initial value
-is @code{GL_FALSE}. See @code{glMap2}.
+evaluation automatically generates surface normals. The initial value is
+@code{GL_FALSE}. See @code{glMap2}.
@item @code{GL_AUX_BUFFERS}
@var{params} returns a single boolean value indicating whether blending
-is enabled. The initial value is @code{GL_FALSE}. See
+is enabled. The initial value is @code{GL_FALSE}. See
@code{glBlendFunc}.
@item @code{GL_BLEND_COLOR}
@var{params} returns four values, the red, green, blue, and alpha values
-which are the components of the blend color. See @code{glBlendColor}.
+which are the components of the blend color. See @code{glBlendColor}.
@item @code{GL_BLEND_DST_ALPHA}
@var{params} returns one value, the symbolic constant identifying the
-alpha destination blend function. The initial value is @code{GL_ZERO}.
+alpha destination blend function. The initial value is @code{GL_ZERO}.
See @code{glBlendFunc} and @code{glBlendFuncSeparate}.
@item @code{GL_BLEND_DST_RGB}
@var{params} returns one value, the symbolic constant identifying the
-RGB destination blend function. The initial value is @code{GL_ZERO}.
-See @code{glBlendFunc} and @code{glBlendFuncSeparate}.
+RGB destination blend function. The initial value is @code{GL_ZERO}. See
+@code{glBlendFunc} and @code{glBlendFuncSeparate}.
@item @code{GL_BLEND_EQUATION_RGB}
@var{params} returns one value, a symbolic constant indicating whether
the RGB blend equation is @code{GL_FUNC_ADD}, @code{GL_FUNC_SUBTRACT},
-@code{GL_FUNC_REVERSE_SUBTRACT}, @code{GL_MIN} or @code{GL_MAX}. See
+@code{GL_FUNC_REVERSE_SUBTRACT}, @code{GL_MIN} or @code{GL_MAX}. See
@code{glBlendEquationSeparate}.
@item @code{GL_BLEND_EQUATION_ALPHA}
@var{params} returns one value, a symbolic constant indicating whether
the Alpha blend equation is @code{GL_FUNC_ADD}, @code{GL_FUNC_SUBTRACT},
-@code{GL_FUNC_REVERSE_SUBTRACT}, @code{GL_MIN} or @code{GL_MAX}. See
+@code{GL_FUNC_REVERSE_SUBTRACT}, @code{GL_MIN} or @code{GL_MAX}. See
@code{glBlendEquationSeparate}.
@item @code{GL_BLEND_SRC_ALPHA}
@var{params} returns one value, the symbolic constant identifying the
-alpha source blend function. The initial value is @code{GL_ONE}. See
+alpha source blend function. The initial value is @code{GL_ONE}. See
@code{glBlendFunc} and @code{glBlendFuncSeparate}.
@item @code{GL_BLEND_SRC_RGB}
@var{params} returns one value, the symbolic constant identifying the
-RGB source blend function. The initial value is @code{GL_ONE}. See
+RGB source blend function. The initial value is @code{GL_ONE}. See
@code{glBlendFunc} and @code{glBlendFuncSeparate}.
@item @code{GL_BLUE_BIAS}
@var{params} returns one value, the blue bias factor used during pixel
-transfers. The initial value is 0. See @code{glPixelTransfer}.
+transfers. The initial value is 0. See @code{glPixelTransfer}.
@item @code{GL_BLUE_BITS}
@var{params} returns one value, the blue scale factor used during pixel
-transfers. The initial value is 1. See @code{glPixelTransfer}.
+transfers. The initial value is 1. See @code{glPixelTransfer}.
@item @code{GL_CLIENT_ACTIVE_TEXTURE}
@var{params} returns a single integer value indicating the current
-client active multitexture unit. The initial value is
-@code{GL_TEXTURE0}. See @code{glClientActiveTexture}.
+client active multitexture unit. The initial value is
+@code{GL_TEXTURE0}. See @code{glClientActiveTexture}.
@item @code{GL_CLIENT_ATTRIB_STACK_DEPTH}
@var{params} returns one value indicating the depth of the attribute
-stack. The initial value is 0. See @code{glPushClientAttrib}.
+stack. The initial value is 0. See @code{glPushClientAttrib}.
@item @code{GL_CLIP_PLANE}@var{i}
@var{params} returns a single boolean value indicating whether the
-specified clipping plane is enabled. The initial value is
-@code{GL_FALSE}. See @code{glClipPlane}.
+specified clipping plane is enabled. The initial value is
+@code{GL_FALSE}. See @code{glClipPlane}.
@item @code{GL_COLOR_ARRAY}
@var{params} returns a single boolean value indicating whether the color
-array is enabled. The initial value is @code{GL_FALSE}. See
+array is enabled. The initial value is @code{GL_FALSE}. See
@code{glColorPointer}.
@item @code{GL_COLOR_ARRAY_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-associated with the color array. This buffer object would have been
+associated with the color array. This buffer object would have been
bound to the target @code{GL_ARRAY_BUFFER} at the time of the most
-recent call to @code{glColorPointer}. If no buffer object was bound to
-this target, 0 is returned. The initial value is 0. See
+recent call to @code{glColorPointer}. If no buffer object was bound to
+this target, 0 is returned. The initial value is 0. See
@code{glBindBuffer}.
@item @code{GL_COLOR_ARRAY_SIZE}
@var{params} returns one value, the number of components per color in
-the color array. The initial value is 4. See @code{glColorPointer}.
+the color array. The initial value is 4. See @code{glColorPointer}.
@item @code{GL_COLOR_ARRAY_STRIDE}
@var{params} returns one value, the byte offset between consecutive
-colors in the color array. The initial value is 0. See
+colors in the color array. The initial value is 0. See
@code{glColorPointer}.
@item @code{GL_COLOR_ARRAY_TYPE}
@var{params} returns one value, the data type of each component in the
-color array. The initial value is @code{GL_FLOAT}. See
+color array. The initial value is @code{GL_FLOAT}. See
@code{glColorPointer}.
@item @code{GL_COLOR_CLEAR_VALUE}
@var{params} returns four values: the red, green, blue, and alpha values
-used to clear the color buffers. Integer values, if requested, are
+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
-@r{-1.0} returns the most negative representable integer value. The
-initial value is (0, 0, 0, 0). See @code{glClearColor}.
+@r{-1.0} returns the most negative representable integer value. The
+initial value is (0, 0, 0, 0). See @code{glClearColor}.
@item @code{GL_COLOR_LOGIC_OP}
@var{params} 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 @code{GL_FALSE}. See
+logical operation. The initial value is @code{GL_FALSE}. See
@code{glLogicOp}.
@item @code{GL_COLOR_MATERIAL}
@var{params} returns a single boolean value indicating whether one or
-more material parameters are tracking the current color. The initial
-value is @code{GL_FALSE}. See @code{glColorMaterial}.
+more material parameters are tracking the current color. The initial
+value is @code{GL_FALSE}. See @code{glColorMaterial}.
@item @code{GL_COLOR_MATERIAL_FACE}
@var{params} returns one value, a symbolic constant indicating which
-materials have a parameter that is tracking the current color. The
-initial value is @code{GL_FRONT_AND_BACK}. See @code{glColorMaterial}.
+materials have a parameter that is tracking the current color. The
+initial value is @code{GL_FRONT_AND_BACK}. See @code{glColorMaterial}.
@item @code{GL_COLOR_MATERIAL_PARAMETER}
@var{params} returns one value, a symbolic constant indicating which
-material parameters are tracking the current color. The initial value
-is @code{GL_AMBIENT_AND_DIFFUSE}. See @code{glColorMaterial}.
+material parameters are tracking the current color. The initial value is
+@code{GL_AMBIENT_AND_DIFFUSE}. See @code{glColorMaterial}.
@item @code{GL_COLOR_MATRIX}
@var{params} returns sixteen values: the color matrix on the top of the
-color matrix stack. Initially this matrix is the identity matrix. See
+color matrix stack. Initially this matrix is the identity matrix. See
@code{glPushMatrix}.
@item @code{GL_COLOR_MATRIX_STACK_DEPTH}
@var{params} returns one value, the maximum supported depth of the
-projection matrix stack. The value must be at least 2. See
+projection matrix stack. The value must be at least 2. See
@code{glPushMatrix}.
@item @code{GL_COLOR_SUM}
@var{params} returns a single boolean value indicating whether primary
-and secondary color sum is enabled. See @code{glSecondaryColor}.
+and secondary color sum is enabled. See @code{glSecondaryColor}.
@item @code{GL_COLOR_TABLE}
@var{params} returns a single boolean value indicating whether the color
-table lookup is enabled. See @code{glColorTable}.
+table lookup is enabled. See @code{glColorTable}.
@item @code{GL_COLOR_WRITEMASK}
@var{params} returns four boolean values: the red, green, blue, and
-alpha write enables for the color buffers. The initial value is
-(@code{GL_TRUE}, @code{GL_TRUE}, @code{GL_TRUE}, @code{GL_TRUE}). See
+alpha write enables for the color buffers. The initial value is
+(@code{GL_TRUE}, @code{GL_TRUE}, @code{GL_TRUE}, @code{GL_TRUE}). See
@code{glColorMask}.
@item @code{GL_COMPRESSED_TEXTURE_FORMATS}
@var{params} returns a list of symbolic constants of length
@code{GL_NUM_COMPRESSED_TEXTURE_FORMATS} indicating which compressed
-texture formats are available. See @code{glCompressedTexImage2D}.
+texture formats are available. See @code{glCompressedTexImage2D}.
@item @code{GL_CONVOLUTION_1D}
@var{params} returns a single boolean value indicating whether 1D
-convolution is enabled. The initial value is @code{GL_FALSE}. See
+convolution is enabled. The initial value is @code{GL_FALSE}. See
@code{glConvolutionFilter1D}.
@item @code{GL_CONVOLUTION_2D}
@var{params} returns a single boolean value indicating whether 2D
-convolution is enabled. The initial value is @code{GL_FALSE}. See
+convolution is enabled. The initial value is @code{GL_FALSE}. See
@code{glConvolutionFilter2D}.
@item @code{GL_CULL_FACE}
@var{params} returns a single boolean value indicating whether polygon
-culling is enabled. The initial value is @code{GL_FALSE}. See
+culling is enabled. The initial value is @code{GL_FALSE}. See
@code{glCullFace}.
@item @code{GL_CULL_FACE_MODE}
@var{params} returns one value, a symbolic constant indicating which
-polygon faces are to be culled. The initial value is @code{GL_BACK}.
-See @code{glCullFace}.
+polygon faces are to be culled. The initial value is @code{GL_BACK}. See
+@code{glCullFace}.
@item @code{GL_CURRENT_COLOR}
@var{params} returns four values: the red, green, blue, and alpha values
-of the current color. Integer values, if requested, are linearly mapped
+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 @r{-1.0} returns the
-most negative representable integer value. The initial value is (1, 1,
-1, 1). See @code{glColor}.
+most negative representable integer value. The initial value is (1, 1,
+1, 1). See @code{glColor}.
@item @code{GL_CURRENT_FOG_COORD}
-@var{params} returns one value, the current fog coordinate. The initial
-value is 0. See @code{glFogCoord}.
+@var{params} returns one value, the current fog coordinate. The initial
+value is 0. See @code{glFogCoord}.
@item @code{GL_CURRENT_INDEX}
-@var{params} returns one value, the current color index. The initial
-value is 1. See @code{glIndex}.
+@var{params} returns one value, the current color index. The initial
+value is 1. See @code{glIndex}.
@item @code{GL_CURRENT_NORMAL}
@var{params} returns three values: the @var{x}, @var{y}, and @var{z}
-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
-@r{-1.0} returns the most negative representable integer value. The
-initial value is (0, 0, 1). See @code{glNormal}.
+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 @r{-1.0}
+returns the most negative representable integer value. The initial value
+is (0, 0, 1). See @code{glNormal}.
@item @code{GL_CURRENT_PROGRAM}
@var{params} returns one value, the name of the program object that is
-currently active, or 0 if no program object is active. See
+currently active, or 0 if no program object is active. See
@code{glUseProgram}.
@item @code{GL_CURRENT_RASTER_COLOR}
@var{params} returns four values: the red, green, blue, and alpha color
-values of the current raster position. Integer values, if requested,
-are linearly mapped from the internal floating-point representation such
+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
-@r{-1.0} returns the most negative representable integer value. The
-initial value is (1, 1, 1, 1). See @code{glRasterPos}.
+@r{-1.0} returns the most negative representable integer value. The
+initial value is (1, 1, 1, 1). See @code{glRasterPos}.
@item @code{GL_CURRENT_RASTER_DISTANCE}
@var{params} returns one value, the distance from the eye to the current
-raster position. The initial value is 0. See @code{glRasterPos}.
+raster position. The initial value is 0. See @code{glRasterPos}.
@item @code{GL_CURRENT_RASTER_INDEX}
@var{params} returns one value, the color index of the current raster
-position. The initial value is 1. See @code{glRasterPos}.
+position. The initial value is 1. See @code{glRasterPos}.
@item @code{GL_CURRENT_RASTER_POSITION}
@var{params} returns four values: the @var{x}, @var{y}, @var{z}, and
-@var{w} components of the current raster position. @var{x}, @var{y},
-and @var{z} are in window coordinates, and @var{w} is in clip
-coordinates. The initial value is (0, 0, 0, 1). See
-@code{glRasterPos}.
+@var{w} components of the current raster position. @var{x}, @var{y}, and
+@var{z} are in window coordinates, and @var{w} is in clip coordinates.
+The initial value is (0, 0, 0, 1). See @code{glRasterPos}.
@item @code{GL_CURRENT_RASTER_POSITION_VALID}
@var{params} returns a single boolean value indicating whether the
-current raster position is valid. The initial value is @code{GL_TRUE}.
+current raster position is valid. The initial value is @code{GL_TRUE}.
See @code{glRasterPos}.
@item @code{GL_CURRENT_RASTER_SECONDARY_COLOR}
@var{params} returns four values: the red, green, blue, and alpha
-secondary color values of the current raster position. Integer values,
+secondary color 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 @r{-1.0} returns the most negative representable
-integer value. The initial value is (1, 1, 1, 1). See
+integer value. The initial value is (1, 1, 1, 1). See
@code{glRasterPos}.
@item @code{GL_CURRENT_RASTER_TEXTURE_COORDS}
@var{params} returns four values: the @var{s}, @var{t}, @var{r}, and
-@var{q} texture coordinates of the current raster position. The initial
-value is (0, 0, 0, 1). See @code{glRasterPos} and
+@var{q} texture coordinates of the current raster position. The initial
+value is (0, 0, 0, 1). See @code{glRasterPos} and
@code{glMultiTexCoord}.
@item @code{GL_CURRENT_SECONDARY_COLOR}
@var{params} returns four values: the red, green, blue, and alpha values
-of the current secondary color. Integer values, if requested, are
+of the current secondary 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
-@r{-1.0} returns the most negative representable integer value. The
-initial value is (0, 0, 0, 0). See @code{glSecondaryColor}.
+@r{-1.0} returns the most negative representable integer value. The
+initial value is (0, 0, 0, 0). See @code{glSecondaryColor}.
@item @code{GL_CURRENT_TEXTURE_COORDS}
@var{params} returns four values: the @var{s}, @var{t}, @var{r}, and
-@var{q} current texture coordinates. The initial value is (0, 0, 0, 1).
+@var{q} current texture coordinates. The initial value is (0, 0, 0, 1).
See @code{glMultiTexCoord}.
@item @code{GL_DEPTH_BIAS}
@var{params} returns one value, the depth bias factor used during pixel
-transfers. The initial value is 0. See @code{glPixelTransfer}.
+transfers. The initial value is 0. See @code{glPixelTransfer}.
@item @code{GL_DEPTH_BITS}
@var{params} 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 @r{-1.0} returns the most
-negative representable integer value. The initial value is 1. See
+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 @r{-1.0} returns the most
+negative representable integer value. The initial value is 1. See
@code{glClearDepth}.
@item @code{GL_DEPTH_FUNC}
@var{params} returns one value, the symbolic constant that indicates the
-depth comparison function. The initial value is @code{GL_LESS}. See
+depth comparison function. The initial value is @code{GL_LESS}. See
@code{glDepthFunc}.
@item @code{GL_DEPTH_RANGE}
@var{params} 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 @r{-1.0} returns the most
-negative representable integer value. The initial value is (0, 1). See
+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 @r{-1.0} returns the most
+negative representable integer value. The initial value is (0, 1). See
@code{glDepthRange}.
@item @code{GL_DEPTH_SCALE}
@var{params} returns one value, the depth scale factor used during pixel
-transfers. The initial value is 1. See @code{glPixelTransfer}.
+transfers. The initial value is 1. See @code{glPixelTransfer}.
@item @code{GL_DEPTH_TEST}
@var{params} returns a single boolean value indicating whether depth
-testing of fragments is enabled. The initial value is @code{GL_FALSE}.
+testing of fragments is enabled. The initial value is @code{GL_FALSE}.
See @code{glDepthFunc} and @code{glDepthRange}.
@item @code{GL_DEPTH_WRITEMASK}
@var{params} returns a single boolean value indicating if the depth
-buffer is enabled for writing. The initial value is @code{GL_TRUE}. See
+buffer is enabled for writing. The initial value is @code{GL_TRUE}. See
@code{glDepthMask}.
@item @code{GL_DITHER}
@var{params} returns a single boolean value indicating whether dithering
-of fragment colors and indices is enabled. The initial value is
+of fragment colors and indices is enabled. The initial value is
@code{GL_TRUE}.
@item @code{GL_DOUBLEBUFFER}
@var{params} returns one value, a symbolic constant indicating which
-buffers are being drawn to. See @code{glDrawBuffer}. The initial value
+buffers are being drawn to. See @code{glDrawBuffer}. The initial value
is @code{GL_BACK} if there are back buffers, otherwise it is
@code{GL_FRONT}.
@var{params} returns one value, a symbolic constant indicating which
-buffers are being drawn to by the corresponding output color. See
-@code{glDrawBuffers}. The initial value of @code{GL_DRAW_BUFFER0} is
+buffers are being drawn to by the corresponding output color. See
+@code{glDrawBuffers}. The initial value of @code{GL_DRAW_BUFFER0} is
@code{GL_BACK} if there are back buffers, otherwise it is
-@code{GL_FRONT}. The initial values of draw buffers for all other
-output colors is @code{GL_NONE}.
+@code{GL_FRONT}. The initial values of draw buffers for all other output
+colors is @code{GL_NONE}.
@item @code{GL_EDGE_FLAG}
@var{params} returns a single boolean value indicating whether the
-current edge flag is @code{GL_TRUE} or @code{GL_FALSE}. The initial
-value is @code{GL_TRUE}. See @code{glEdgeFlag}.
+current edge flag is @code{GL_TRUE} or @code{GL_FALSE}. The initial
+value is @code{GL_TRUE}. See @code{glEdgeFlag}.
@item @code{GL_EDGE_FLAG_ARRAY}
@var{params} returns a single boolean value indicating whether the edge
-flag array is enabled. The initial value is @code{GL_FALSE}. See
+flag array is enabled. The initial value is @code{GL_FALSE}. See
@code{glEdgeFlagPointer}.
@item @code{GL_EDGE_FLAG_ARRAY_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-associated with the edge flag array. This buffer object would have been
+associated with the edge flag array. This buffer object would have been
bound to the target @code{GL_ARRAY_BUFFER} at the time of the most
-recent call to @code{glEdgeFlagPointer}. If no buffer object was bound
-to this target, 0 is returned. The initial value is 0. See
+recent call to @code{glEdgeFlagPointer}. If no buffer object was bound
+to this target, 0 is returned. The initial value is 0. See
@code{glBindBuffer}.
@item @code{GL_EDGE_FLAG_ARRAY_STRIDE}
@var{params} returns one value, the byte offset between consecutive edge
-flags in the edge flag array. The initial value is 0. See
+flags in the edge flag array. The initial value is 0. See
@code{glEdgeFlagPointer}.
@item @code{GL_ELEMENT_ARRAY_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-currently bound to the target @code{GL_ELEMENT_ARRAY_BUFFER}. If no
-buffer object is bound to this target, 0 is returned. The initial value
-is 0. See @code{glBindBuffer}.
+currently bound to the target @code{GL_ELEMENT_ARRAY_BUFFER}. If no
+buffer object is bound to this target, 0 is returned. The initial value
+is 0. See @code{glBindBuffer}.
@item @code{GL_FEEDBACK_BUFFER_SIZE}
-@var{params} returns one value, the size of the feedback buffer. See
+@var{params} returns one value, the size of the feedback buffer. See
@code{glFeedbackBuffer}.
@item @code{GL_FEEDBACK_BUFFER_TYPE}
-@var{params} returns one value, the type of the feedback buffer. See
+@var{params} returns one value, the type of the feedback buffer. See
@code{glFeedbackBuffer}.
@item @code{GL_FOG}
@var{params} returns a single boolean value indicating whether fogging
-is enabled. The initial value is @code{GL_FALSE}. See @code{glFog}.
+is enabled. The initial value is @code{GL_FALSE}. See @code{glFog}.
@item @code{GL_FOG_COORD_ARRAY}
@var{params} returns a single boolean value indicating whether the fog
-coordinate array is enabled. The initial value is @code{GL_FALSE}. See
+coordinate array is enabled. The initial value is @code{GL_FALSE}. See
@code{glFogCoordPointer}.
@item @code{GL_FOG_COORD_ARRAY_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-associated with the fog coordinate array. This buffer object would have
+associated with the fog coordinate array. This buffer object would have
been bound to the target @code{GL_ARRAY_BUFFER} at the time of the most
-recent call to @code{glFogCoordPointer}. If no buffer object was bound
-to this target, 0 is returned. The initial value is 0. See
+recent call to @code{glFogCoordPointer}. If no buffer object was bound
+to this target, 0 is returned. The initial value is 0. See
@code{glBindBuffer}.
@item @code{GL_FOG_COORD_ARRAY_STRIDE}
@var{params} returns one value, the byte offset between consecutive fog
-coordinates in the fog coordinate array. The initial value is 0. See
+coordinates in the fog coordinate array. The initial value is 0. See
@code{glFogCoordPointer}.
@item @code{GL_FOG_COORD_ARRAY_TYPE}
@var{params} returns one value, the type of the fog coordinate array.
-The initial value is @code{GL_FLOAT}. See @code{glFogCoordPointer}.
+The initial value is @code{GL_FLOAT}. See @code{glFogCoordPointer}.
@item @code{GL_FOG_COORD_SRC}
@var{params} returns one value, a symbolic constant indicating the
-source of the fog coordinate. The initial value is
-@code{GL_FRAGMENT_DEPTH}. See @code{glFog}.
+source of the fog coordinate. The initial value is
+@code{GL_FRAGMENT_DEPTH}. See @code{glFog}.
@item @code{GL_FOG_COLOR}
@var{params} returns four values: the red, green, blue, and alpha
-components of the fog color. Integer values, if requested, are linearly
+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 @r{-1.0}
-returns the most negative representable integer value. The initial
-value is (0, 0, 0, 0). See @code{glFog}.
+returns the most negative representable integer value. The initial value
+is (0, 0, 0, 0). See @code{glFog}.
@item @code{GL_FOG_DENSITY}
-@var{params} returns one value, the fog density parameter. The initial
-value is 1. See @code{glFog}.
+@var{params} returns one value, the fog density parameter. The initial
+value is 1. See @code{glFog}.
@item @code{GL_FOG_END}
@var{params} returns one value, the end factor for the linear fog
-equation. The initial value is 1. See @code{glFog}.
+equation. The initial value is 1. See @code{glFog}.
@item @code{GL_FOG_HINT}
@var{params} returns one value, a symbolic constant indicating the mode
-of the fog hint. The initial value is @code{GL_DONT_CARE}. See
+of the fog hint. The initial value is @code{GL_DONT_CARE}. See
@code{glHint}.
@item @code{GL_FOG_INDEX}
-@var{params} returns one value, the fog color index. The initial value
-is 0. See @code{glFog}.
+@var{params} returns one value, the fog color index. The initial value
+is 0. See @code{glFog}.
@item @code{GL_FOG_MODE}
@var{params} returns one value, a symbolic constant indicating which fog
-equation is selected. The initial value is @code{GL_EXP}. See
+equation is selected. The initial value is @code{GL_EXP}. See
@code{glFog}.
@item @code{GL_FOG_START}
@var{params} returns one value, the start factor for the linear fog
-equation. The initial value is 0. See @code{glFog}.
+equation. The initial value is 0. See @code{glFog}.
@item @code{GL_FRAGMENT_SHADER_DERIVATIVE_HINT}
@var{params} returns one value, a symbolic constant indicating the mode
-of the derivative accuracy hint for fragment shaders. The initial value
-is @code{GL_DONT_CARE}. See @code{glHint}.
+of the derivative accuracy hint for fragment shaders. The initial value
+is @code{GL_DONT_CARE}. See @code{glHint}.
@item @code{GL_FRONT_FACE}
@var{params} returns one value, a symbolic constant indicating whether
clockwise or counterclockwise polygon winding is treated as
-front-facing. The initial value is @code{GL_CCW}. See
+front-facing. The initial value is @code{GL_CCW}. See
@code{glFrontFace}.
@item @code{GL_GENERATE_MIPMAP_HINT}
@var{params} returns one value, a symbolic constant indicating the mode
-of the mipmap generation filtering hint. The initial value is
-@code{GL_DONT_CARE}. See @code{glHint}.
+of the mipmap generation filtering hint. The initial value is
+@code{GL_DONT_CARE}. See @code{glHint}.
@item @code{GL_GREEN_BIAS}
@var{params} returns one value, the green bias factor used during pixel
-transfers. The initial value is 0.
+transfers. The initial value is 0.
@item @code{GL_GREEN_BITS}
@var{params} returns one value, the green scale factor used during pixel
-transfers. The initial value is 1. See @code{glPixelTransfer}.
+transfers. The initial value is 1. See @code{glPixelTransfer}.
@item @code{GL_HISTOGRAM}
@var{params} returns a single boolean value indicating whether histogram
-is enabled. The initial value is @code{GL_FALSE}. See
+is enabled. The initial value is @code{GL_FALSE}. See
@code{glHistogram}.
@item @code{GL_INDEX_ARRAY}
@var{params} returns a single boolean value indicating whether the color
-index array is enabled. The initial value is @code{GL_FALSE}. See
+index array is enabled. The initial value is @code{GL_FALSE}. See
@code{glIndexPointer}.
@item @code{GL_INDEX_ARRAY_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-associated with the color index array. This buffer object would have
+associated with the color index array. This buffer object would have
been bound to the target @code{GL_ARRAY_BUFFER} at the time of the most
-recent call to @code{glIndexPointer}. If no buffer object was bound to
-this target, 0 is returned. The initial value is 0. See
+recent call to @code{glIndexPointer}. If no buffer object was bound to
+this target, 0 is returned. The initial value is 0. See
@code{glBindBuffer}.
@item @code{GL_INDEX_ARRAY_STRIDE}
@var{params} returns one value, the byte offset between consecutive
-color indexes in the color index array. The initial value is 0. See
+color indexes in the color index array. The initial value is 0. See
@code{glIndexPointer}.
@item @code{GL_INDEX_ARRAY_TYPE}
@var{params} returns one value, the data type of indexes in the color
-index array. The initial value is @code{GL_FLOAT}. See
+index array. The initial value is @code{GL_FLOAT}. See
@code{glIndexPointer}.
@item @code{GL_INDEX_BITS}
@var{params} returns one value, the color index used to clear the color
-index buffers. The initial value is 0. See @code{glClearIndex}.
+index buffers. The initial value is 0. See @code{glClearIndex}.
@item @code{GL_INDEX_LOGIC_OP}
@var{params} 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 @code{GL_FALSE}. See @code{glLogicOp}.
+operation. The initial value is @code{GL_FALSE}. See @code{glLogicOp}.
@item @code{GL_INDEX_MODE}
@var{params} returns one value, the offset added to color and stencil
-indices during pixel transfers. The initial value is 0. See
+indices during pixel transfers. The initial value is 0. See
@code{glPixelTransfer}.
@item @code{GL_INDEX_SHIFT}
@var{params} returns one value, the amount that color and stencil
-indices are shifted during pixel transfers. The initial value is 0. See
+indices are shifted during pixel transfers. The initial value is 0. See
@code{glPixelTransfer}.
@item @code{GL_INDEX_WRITEMASK}
@var{params} returns one value, a mask indicating which bitplanes of
-each color index buffer can be written. The initial value is all 1's.
+each color index buffer can be written. The initial value is all 1's.
See @code{glIndexMask}.
@item @code{GL_LIGHT}@var{i}
@var{params} returns a single boolean value indicating whether the
-specified light is enabled. The initial value is @code{GL_FALSE}. See
+specified light is enabled. The initial value is @code{GL_FALSE}. See
@code{glLight} and @code{glLightModel}.
@item @code{GL_LIGHTING}
@var{params} returns a single boolean value indicating whether lighting
-is enabled. The initial value is @code{GL_FALSE}. See
+is enabled. The initial value is @code{GL_FALSE}. See
@code{glLightModel}.
@item @code{GL_LIGHT_MODEL_AMBIENT}
@var{params} 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 @r{-1.0} returns the most negative
-representable integer value. The initial value is (0.2, 0.2, 0.2, 1.0).
-See @code{glLightModel}.
+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 @r{-1.0} returns the most negative representable
+integer value. The initial value is (0.2, 0.2, 0.2, 1.0). See
+@code{glLightModel}.
@item @code{GL_LIGHT_MODEL_COLOR_CONTROL}
@var{params} returns a single boolean value indicating whether specular
reflection calculations treat the viewer as being local to the scene.
-The initial value is @code{GL_FALSE}. See @code{glLightModel}.
+The initial value is @code{GL_FALSE}. See @code{glLightModel}.
@item @code{GL_LIGHT_MODEL_TWO_SIDE}
@var{params} returns a single boolean value indicating whether separate
materials are used to compute lighting for front- and back-facing
-polygons. The initial value is @code{GL_FALSE}. See
-@code{glLightModel}.
+polygons. The initial value is @code{GL_FALSE}. See @code{glLightModel}.
@item @code{GL_LINE_SMOOTH}
@var{params} returns a single boolean value indicating whether
-antialiasing of lines is enabled. The initial value is @code{GL_FALSE}.
+antialiasing of lines is enabled. The initial value is @code{GL_FALSE}.
See @code{glLineWidth}.
@item @code{GL_LINE_SMOOTH_HINT}
@var{params} returns one value, a symbolic constant indicating the mode
-of the line antialiasing hint. The initial value is
-@code{GL_DONT_CARE}. See @code{glHint}.
+of the line antialiasing hint. The initial value is @code{GL_DONT_CARE}.
+See @code{glHint}.
@item @code{GL_LINE_STIPPLE}
@var{params} returns a single boolean value indicating whether stippling
-of lines is enabled. The initial value is @code{GL_FALSE}. See
+of lines is enabled. The initial value is @code{GL_FALSE}. See
@code{glLineStipple}.
@item @code{GL_LINE_STIPPLE_PATTERN}
-@var{params} returns one value, the 16-bit line stipple pattern. The
-initial value is all 1's. See @code{glLineStipple}.
+@var{params} returns one value, the 16-bit line stipple pattern. The
+initial value is all 1's. See @code{glLineStipple}.
@item @code{GL_LINE_STIPPLE_REPEAT}
-@var{params} returns one value, the line stipple repeat factor. The
-initial value is 1. See @code{glLineStipple}.
+@var{params} returns one value, the line stipple repeat factor. The
+initial value is 1. See @code{glLineStipple}.
@item @code{GL_LINE_WIDTH}
@var{params} returns one value, the line width as specified with
-@code{glLineWidth}. The initial value is 1.
+@code{glLineWidth}. The initial value is 1.
@item @code{GL_LINE_WIDTH_GRANULARITY}
@var{params} returns one value, the width difference between adjacent
-supported widths for antialiased lines. See @code{glLineWidth}.
+supported widths for antialiased lines. See @code{glLineWidth}.
@item @code{GL_LINE_WIDTH_RANGE}
@var{params} returns two values: the smallest and largest supported
-widths for antialiased lines. See @code{glLineWidth}.
+widths for antialiased lines. See @code{glLineWidth}.
@item @code{GL_LIST_BASE}
@var{params} returns one value, the base offset added to all names in
-arrays presented to @code{glCallLists}. The initial value is 0. See
+arrays presented to @code{glCallLists}. The initial value is 0. See
@code{glListBase}.
@item @code{GL_LIST_INDEX}
@var{params} 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 @code{glNewList}.
+under construction. 0 is returned if no display list is currently under
+construction. The initial value is 0. See @code{glNewList}.
@item @code{GL_LIST_MODE}
@var{params} returns one value, a symbolic constant indicating the
-construction mode of the display list currently under construction. The
-initial value is 0. See @code{glNewList}.
+construction mode of the display list currently under construction. The
+initial value is 0. See @code{glNewList}.
@item @code{GL_LOGIC_OP_MODE}
@var{params} returns one value, a symbolic constant indicating the
-selected logic operation mode. The initial value is @code{GL_COPY}. See
+selected logic operation mode. The initial value is @code{GL_COPY}. See
@code{glLogicOp}.
@item @code{GL_MAP1_COLOR_4}
@var{params} returns a single boolean value indicating whether 1D
-evaluation generates colors. The initial value is @code{GL_FALSE}. See
+evaluation generates colors. The initial value is @code{GL_FALSE}. See
@code{glMap1}.
@item @code{GL_MAP1_GRID_DOMAIN}
@var{params} returns two values: the endpoints of the 1D map's grid
-domain. The initial value is (0, 1). See @code{glMapGrid}.
+domain. The initial value is (0, 1). See @code{glMapGrid}.
@item @code{GL_MAP1_GRID_SEGMENTS}
@var{params} returns one value, the number of partitions in the 1D map's
-grid domain. The initial value is 1. See @code{glMapGrid}.
+grid domain. The initial value is 1. See @code{glMapGrid}.
@item @code{GL_MAP1_INDEX}
@var{params} returns a single boolean value indicating whether 1D
-evaluation generates color indices. The initial value is
-@code{GL_FALSE}. See @code{glMap1}.
+evaluation generates color indices. The initial value is
+@code{GL_FALSE}. See @code{glMap1}.
@item @code{GL_MAP1_NORMAL}
@var{params} returns a single boolean value indicating whether 1D
-evaluation generates normals. The initial value is @code{GL_FALSE}. See
+evaluation generates normals. The initial value is @code{GL_FALSE}. See
@code{glMap1}.
@item @code{GL_MAP1_TEXTURE_COORD_1}
@var{params} returns a single boolean value indicating whether 1D
-evaluation generates 1D texture coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap1}.
+evaluation generates 1D texture coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap1}.
@item @code{GL_MAP1_TEXTURE_COORD_2}
@var{params} returns a single boolean value indicating whether 1D
-evaluation generates 2D texture coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap1}.
+evaluation generates 2D texture coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap1}.
@item @code{GL_MAP1_TEXTURE_COORD_3}
@var{params} returns a single boolean value indicating whether 1D
-evaluation generates 3D texture coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap1}.
+evaluation generates 3D texture coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap1}.
@item @code{GL_MAP1_TEXTURE_COORD_4}
@var{params} returns a single boolean value indicating whether 1D
-evaluation generates 4D texture coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap1}.
+evaluation generates 4D texture coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap1}.
@item @code{GL_MAP1_VERTEX_3}
@var{params} returns a single boolean value indicating whether 1D
-evaluation generates 3D vertex coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap1}.
+evaluation generates 3D vertex coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap1}.
@item @code{GL_MAP1_VERTEX_4}
@var{params} returns a single boolean value indicating whether 1D
-evaluation generates 4D vertex coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap1}.
+evaluation generates 4D vertex coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap1}.
@item @code{GL_MAP2_COLOR_4}
@var{params} returns a single boolean value indicating whether 2D
-evaluation generates colors. The initial value is @code{GL_FALSE}. See
+evaluation generates colors. The initial value is @code{GL_FALSE}. See
@code{glMap2}.
@item @code{GL_MAP2_GRID_DOMAIN}
@var{params} returns four values: the endpoints of the 2D map's
-@r{@var{i}} and @r{@var{j}} grid domains. The initial value is (0,1;
-0,1). See @code{glMapGrid}.
+@r{@var{i}} and @r{@var{j}} grid domains. The initial value is (0,1;
+0,1). See @code{glMapGrid}.
@item @code{GL_MAP2_GRID_SEGMENTS}
@var{params} returns two values: the number of partitions in the 2D
-map's @r{@var{i}} and @r{@var{j}} grid domains. The initial value is
-(1,1). See @code{glMapGrid}.
+map's @r{@var{i}} and @r{@var{j}} grid domains. The initial value is
+(1,1). See @code{glMapGrid}.
@item @code{GL_MAP2_INDEX}
@var{params} returns a single boolean value indicating whether 2D
-evaluation generates color indices. The initial value is
-@code{GL_FALSE}. See @code{glMap2}.
+evaluation generates color indices. The initial value is
+@code{GL_FALSE}. See @code{glMap2}.
@item @code{GL_MAP2_NORMAL}
@var{params} returns a single boolean value indicating whether 2D
-evaluation generates normals. The initial value is @code{GL_FALSE}. See
+evaluation generates normals. The initial value is @code{GL_FALSE}. See
@code{glMap2}.
@item @code{GL_MAP2_TEXTURE_COORD_1}
@var{params} returns a single boolean value indicating whether 2D
-evaluation generates 1D texture coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap2}.
+evaluation generates 1D texture coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap2}.
@item @code{GL_MAP2_TEXTURE_COORD_2}
@var{params} returns a single boolean value indicating whether 2D
-evaluation generates 2D texture coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap2}.
+evaluation generates 2D texture coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap2}.
@item @code{GL_MAP2_TEXTURE_COORD_3}
@var{params} returns a single boolean value indicating whether 2D
-evaluation generates 3D texture coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap2}.
+evaluation generates 3D texture coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap2}.
@item @code{GL_MAP2_TEXTURE_COORD_4}
@var{params} returns a single boolean value indicating whether 2D
-evaluation generates 4D texture coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap2}.
+evaluation generates 4D texture coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap2}.
@item @code{GL_MAP2_VERTEX_3}
@var{params} returns a single boolean value indicating whether 2D
-evaluation generates 3D vertex coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap2}.
+evaluation generates 3D vertex coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap2}.
@item @code{GL_MAP2_VERTEX_4}
@var{params} returns a single boolean value indicating whether 2D
-evaluation generates 4D vertex coordinates. The initial value is
-@code{GL_FALSE}. See @code{glMap2}.
+evaluation generates 4D vertex coordinates. The initial value is
+@code{GL_FALSE}. See @code{glMap2}.
@item @code{GL_MAP_COLOR}
@var{params} 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 @code{GL_FALSE}. See @code{glPixelTransfer}.
+The initial value is @code{GL_FALSE}. See @code{glPixelTransfer}.
@item @code{GL_MAP_STENCIL}
@var{params} returns a single boolean value indicating if stencil
-indices are to be replaced by table lookup during pixel transfers. The
-initial value is @code{GL_FALSE}. See @code{glPixelTransfer}.
+indices are to be replaced by table lookup during pixel transfers. The
+initial value is @code{GL_FALSE}. See @code{glPixelTransfer}.
@item @code{GL_MATRIX_MODE}
@var{params} returns one value, a symbolic constant indicating which
-matrix stack is currently the target of all matrix operations. The
-initial value is @code{GL_MODELVIEW}. See @code{glMatrixMode}.
+matrix stack is currently the target of all matrix operations. The
+initial value is @code{GL_MODELVIEW}. See @code{glMatrixMode}.
@item @code{GL_MAX_3D_TEXTURE_SIZE}
@var{params} returns one value, a rough estimate of the largest 3D
-texture that the GL can handle. The value must be at least 16. If the
-GL version is 1.2 or greater, use @code{GL_PROXY_TEXTURE_3D} to
-determine if a texture is too large. See @code{glTexImage3D}.
+texture that the GL can handle. The value must be at least 16. If the GL
+version is 1.2 or greater, use @code{GL_PROXY_TEXTURE_3D} to determine
+if a texture is too large. See @code{glTexImage3D}.
@item @code{GL_MAX_CLIENT_ATTRIB_STACK_DEPTH}
@var{params} returns one value indicating the maximum supported depth of
-the client attribute stack. See @code{glPushClientAttrib}.
+the client attribute stack. See @code{glPushClientAttrib}.
@item @code{GL_MAX_ATTRIB_STACK_DEPTH}
@var{params} returns one value, the maximum supported depth of the
-attribute stack. The value must be at least 16. See
-@code{glPushAttrib}.
+attribute stack. The value must be at least 16. See @code{glPushAttrib}.
@item @code{GL_MAX_CLIP_PLANES}
@var{params} returns one value, the maximum number of
-application-defined clipping planes. The value must be at least 6. See
+application-defined clipping planes. The value must be at least 6. See
@code{glClipPlane}.
@item @code{GL_MAX_COLOR_MATRIX_STACK_DEPTH}
@var{params} returns one value, the maximum supported depth of the color
-matrix stack. The value must be at least 2. See @code{glPushMatrix}.
+matrix stack. The value must be at least 2. See @code{glPushMatrix}.
@item @code{GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS}
@var{params} returns one value, the maximum supported texture image
units that can be used to access texture maps from the vertex shader and
-the fragment processor combined. If both the vertex shader and the
+the fragment processor combined. If both the vertex shader and the
fragment processing stage access the same texture image unit, then that
-counts as using two texture image units against this limit. The value
-must be at least 2. See @code{glActiveTexture}.
+counts as using two texture image units against this limit. The value
+must be at least 2. See @code{glActiveTexture}.
@item @code{GL_MAX_CUBE_MAP_TEXTURE_SIZE}
-@var{params} returns one value. The value gives a rough estimate of the
-largest cube-map texture that the GL can handle. The value must be at
-least 16. If the GL version is 1.3 or greater, use
+@var{params} returns one value. The value gives a rough estimate of the
+largest cube-map texture that the GL can handle. The value must be at
+least 16. If the GL version is 1.3 or greater, use
@code{GL_PROXY_TEXTURE_CUBE_MAP} to determine if a texture is too large.
See @code{glTexImage2D}.
@var{params} returns one value, the maximum number of simultaneous
output colors allowed from a fragment shader using the
-@code{gl_FragData} built-in array. The value must be at least 1. See
+@code{gl_FragData} built-in array. The value must be at least 1. See
@code{glDrawBuffers}.
@item @code{GL_MAX_ELEMENTS_INDICES}
@var{params} returns one value, the recommended maximum number of vertex
-array indices. See @code{glDrawRangeElements}.
+array indices. See @code{glDrawRangeElements}.
@item @code{GL_MAX_ELEMENTS_VERTICES}
@var{params} returns one value, the recommended maximum number of vertex
-array vertices. See @code{glDrawRangeElements}.
+array vertices. See @code{glDrawRangeElements}.
@item @code{GL_MAX_EVAL_ORDER}
@var{params} returns one value, the maximum equation order supported by
-1D and 2D evaluators. The value must be at least 8. See @code{glMap1}
+1D and 2D evaluators. The value must be at least 8. See @code{glMap1}
and @code{glMap2}.
@item @code{GL_MAX_FRAGMENT_UNIFORM_COMPONENTS}
@var{params} returns one value, the maximum number of individual
floating-point, integer, or boolean values that can be held in uniform
-variable storage for a fragment shader. The value must be at least 64.
+variable storage for a fragment shader. The value must be at least 64.
See @code{glUniform}.
@item @code{GL_MAX_LIGHTS}
-@var{params} returns one value, the maximum number of lights. The value
-must be at least 8. See @code{glLight}.
+@var{params} returns one value, the maximum number of lights. The value
+must be at least 8. See @code{glLight}.
@item @code{GL_MAX_LIST_NESTING}
@var{params} returns one value, the maximum recursion depth allowed
-during display-list traversal. The value must be at least 64. See
+during display-list traversal. The value must be at least 64. See
@code{glCallList}.
@item @code{GL_MAX_MODELVIEW_STACK_DEPTH}
@var{params} returns one value, the maximum supported depth of the
-modelview matrix stack. The value must be at least 32. See
+modelview matrix stack. The value must be at least 32. See
@code{glPushMatrix}.
@item @code{GL_MAX_NAME_STACK_DEPTH}
@var{params} returns one value, the maximum supported depth of the
-selection name stack. The value must be at least 64. See
+selection name stack. The value must be at least 64. See
@code{glPushName}.
@item @code{GL_MAX_PIXEL_MAP_TABLE}
@var{params} returns one value, the maximum supported size of a
-@code{glPixelMap} lookup table. The value must be at least 32. See
+@code{glPixelMap} lookup table. The value must be at least 32. See
@code{glPixelMap}.
@item @code{GL_MAX_PROJECTION_STACK_DEPTH}
@var{params} returns one value, the maximum supported depth of the
-projection matrix stack. The value must be at least 2. See
+projection matrix stack. The value must be at least 2. See
@code{glPushMatrix}.
@item @code{GL_MAX_TEXTURE_COORDS}
@var{params} returns one value, the maximum number of texture coordinate
-sets available to vertex and fragment shaders. The value must be at
-least 2. See @code{glActiveTexture} and @code{glClientActiveTexture}.
+sets available to vertex and fragment shaders. The value must be at
+least 2. See @code{glActiveTexture} and @code{glClientActiveTexture}.
@item @code{GL_MAX_TEXTURE_IMAGE_UNITS}
@var{params} returns one value, the maximum supported texture image
units that can be used to access texture maps from the fragment shader.
-The value must be at least 2. See @code{glActiveTexture}.
+The value must be at least 2. See @code{glActiveTexture}.
@item @code{GL_MAX_TEXTURE_LOD_BIAS}
@var{params} returns one value, the maximum, absolute value of the
-texture level-of-detail bias. The value must be at least 4.
+texture level-of-detail bias. The value must be at least 4.
@item @code{GL_MAX_TEXTURE_SIZE}
-@var{params} returns one value. The value gives a rough estimate of the
-largest texture that the GL can handle. The value must be at least 64.
+@var{params} returns one value. The value gives a rough estimate of the
+largest texture that the GL can handle. The value must be at least 64.
If the GL version is 1.1 or greater, use @code{GL_PROXY_TEXTURE_1D} or
-@code{GL_PROXY_TEXTURE_2D} to determine if a texture is too large. See
+@code{GL_PROXY_TEXTURE_2D} to determine if a texture is too large. See
@code{glTexImage1D} and @code{glTexImage2D}.
@item @code{GL_MAX_TEXTURE_STACK_DEPTH}
@var{params} returns one value, the maximum supported depth of the
-texture matrix stack. The value must be at least 2. See
+texture matrix stack. The value must be at least 2. See
@code{glPushMatrix}.
@item @code{GL_MAX_TEXTURE_UNITS}
@var{params} returns a single value indicating the number of
-conventional texture units supported. Each conventional texture unit
+conventional texture units supported. Each conventional texture unit
includes both a texture coordinate set and a texture image unit.
Conventional texture units may be used for fixed-function (non-shader)
-rendering. The value must be at least 2. Additional texture coordinate
+rendering. The value must be at least 2. Additional texture coordinate
sets and texture image units may be accessed from vertex and fragment
-shaders. See @code{glActiveTexture} and @code{glClientActiveTexture}.
+shaders. See @code{glActiveTexture} and @code{glClientActiveTexture}.
@item @code{GL_MAX_VARYING_FLOATS}
@var{params} returns one value, the maximum number of interpolators
available for processing varying variables used by vertex and fragment
-shaders. This value represents the number of individual floating-point
+shaders. This value represents the number of individual floating-point
values that can be interpolated; varying variables declared as vectors,
-matrices, and arrays will all consume multiple interpolators. The value
+matrices, and arrays will all consume multiple interpolators. The value
must be at least 32.
@item @code{GL_MAX_VERTEX_ATTRIBS}
@var{params} returns one value, the maximum number of 4-component
-generic vertex attributes accessible to a vertex shader. The value must
-be at least 16. See @code{glVertexAttrib}.
+generic vertex attributes accessible to a vertex shader. The value must
+be at least 16. See @code{glVertexAttrib}.
@item @code{GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS}
@var{params} returns one value, the maximum supported texture image
units that can be used to access texture maps from the vertex shader.
-The value may be 0. See @code{glActiveTexture}.
+The value may be 0. See @code{glActiveTexture}.
@item @code{GL_MAX_VERTEX_UNIFORM_COMPONENTS}
@var{params} returns one value, the maximum number of individual
floating-point, integer, or boolean values that can be held in uniform
-variable storage for a vertex shader. The value must be at least 512.
+variable storage for a vertex shader. The value must be at least 512.
See @code{glUniform}.
@item @code{GL_MAX_VIEWPORT_DIMS}
@var{params} 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 @code{glViewport}.
+of the viewport. These must be at least as large as the visible
+dimensions of the display being rendered to. See @code{glViewport}.
@item @code{GL_MINMAX}
@var{params} returns a single boolean value indicating whether pixel
-minmax values are computed. The initial value is @code{GL_FALSE}. See
+minmax values are computed. The initial value is @code{GL_FALSE}. See
@code{glMinmax}.
@item @code{GL_MODELVIEW_MATRIX}
@var{params} returns sixteen values: the modelview matrix on the top of
-the modelview matrix stack. Initially this matrix is the identity
-matrix. See @code{glPushMatrix}.
+the modelview matrix stack. Initially this matrix is the identity
+matrix. See @code{glPushMatrix}.
@item @code{GL_MODELVIEW_STACK_DEPTH}
@var{params} returns one value, the number of matrices on the modelview
-matrix stack. The initial value is 1. See @code{glPushMatrix}.
+matrix stack. The initial value is 1. See @code{glPushMatrix}.
@item @code{GL_NAME_STACK_DEPTH}
@var{params} returns one value, the number of names on the selection
-name stack. The initial value is 0. See @code{glPushName}.
+name stack. The initial value is 0. See @code{glPushName}.
@item @code{GL_NORMAL_ARRAY}
@var{params} returns a single boolean value, indicating whether the
-normal array is enabled. The initial value is @code{GL_FALSE}. See
+normal array is enabled. The initial value is @code{GL_FALSE}. See
@code{glNormalPointer}.
@item @code{GL_NORMAL_ARRAY_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-associated with the normal array. This buffer object would have been
+associated with the normal array. This buffer object would have been
bound to the target @code{GL_ARRAY_BUFFER} at the time of the most
-recent call to @code{glNormalPointer}. If no buffer object was bound to
-this target, 0 is returned. The initial value is 0. See
+recent call to @code{glNormalPointer}. If no buffer object was bound to
+this target, 0 is returned. The initial value is 0. See
@code{glBindBuffer}.
@item @code{GL_NORMAL_ARRAY_STRIDE}
@var{params} returns one value, the byte offset between consecutive
-normals in the normal array. The initial value is 0. See
+normals in the normal array. The initial value is 0. See
@code{glNormalPointer}.
@item @code{GL_NORMAL_ARRAY_TYPE}
@var{params} returns one value, the data type of each coordinate in the
-normal array. The initial value is @code{GL_FLOAT}. See
+normal array. The initial value is @code{GL_FLOAT}. See
@code{glNormalPointer}.
@item @code{GL_NORMALIZE}
@var{params} 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 @code{GL_FALSE}. See
+to eye coordinates. The initial value is @code{GL_FALSE}. See
@code{glNormal}.
@item @code{GL_NUM_COMPRESSED_TEXTURE_FORMATS}
@var{params} returns a single integer value indicating the number of
-available compressed texture formats. The minimum value is 0. See
+available compressed texture formats. The minimum value is 0. See
@code{glCompressedTexImage2D}.
@item @code{GL_PACK_ALIGNMENT}
@var{params} returns one value, the byte alignment used for writing
-pixel data to memory. The initial value is 4. See @code{glPixelStore}.
+pixel data to memory. The initial value is 4. See @code{glPixelStore}.
@item @code{GL_PACK_IMAGE_HEIGHT}
@var{params} returns one value, the image height used for writing pixel
-data to memory. The initial value is 0. See @code{glPixelStore}.
+data to memory. The initial value is 0. See @code{glPixelStore}.
@item @code{GL_PACK_LSB_FIRST}
@var{params} 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
-@code{GL_FALSE}. See @code{glPixelStore}.
+significant bit of each unsigned byte. The initial value is
+@code{GL_FALSE}. See @code{glPixelStore}.
@item @code{GL_PACK_ROW_LENGTH}
@var{params} returns one value, the row length used for writing pixel
-data to memory. The initial value is 0. See @code{glPixelStore}.
+data to memory. The initial value is 0. See @code{glPixelStore}.
@item @code{GL_PACK_SKIP_IMAGES}
@var{params} returns one value, the number of pixel images skipped
-before the first pixel is written into memory. The initial value is 0.
+before the first pixel is written into memory. The initial value is 0.
See @code{glPixelStore}.
@item @code{GL_PACK_SKIP_PIXELS}
@var{params} returns one value, the number of pixel locations skipped
-before the first pixel is written into memory. The initial value is 0.
+before the first pixel is written into memory. The initial value is 0.
See @code{glPixelStore}.
@item @code{GL_PACK_SKIP_ROWS}
@var{params} 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 @code{glPixelStore}.
+skipped before the first pixel is written into memory. The initial value
+is 0. See @code{glPixelStore}.
@item @code{GL_PACK_SWAP_BYTES}
@var{params} 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 @code{GL_FALSE}.
+before being written to memory. The initial value is @code{GL_FALSE}.
See @code{glPixelStore}.
@item @code{GL_PERSPECTIVE_CORRECTION_HINT}
@var{params} returns one value, a symbolic constant indicating the mode
-of the perspective correction hint. The initial value is
-@code{GL_DONT_CARE}. See @code{glHint}.
+of the perspective correction hint. The initial value is
+@code{GL_DONT_CARE}. See @code{glHint}.
@item @code{GL_PIXEL_MAP_A_TO_A_SIZE}
@var{params} returns one value, the size of the alpha-to-alpha pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_MAP_B_TO_B_SIZE}
@var{params} returns one value, the size of the blue-to-blue pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_MAP_G_TO_G_SIZE}
@var{params} returns one value, the size of the green-to-green pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_MAP_I_TO_A_SIZE}
@var{params} returns one value, the size of the index-to-alpha pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_MAP_I_TO_B_SIZE}
@var{params} returns one value, the size of the index-to-blue pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_MAP_I_TO_G_SIZE}
@var{params} returns one value, the size of the index-to-green pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_MAP_I_TO_I_SIZE}
@var{params} returns one value, the size of the index-to-index pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_MAP_I_TO_R_SIZE}
@var{params} returns one value, the size of the index-to-red pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_MAP_R_TO_R_SIZE}
@var{params} returns one value, the size of the red-to-red pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_MAP_S_TO_S_SIZE}
@var{params} returns one value, the size of the stencil-to-stencil pixel
-translation table. The initial value is 1. See @code{glPixelMap}.
+translation table. The initial value is 1. See @code{glPixelMap}.
@item @code{GL_PIXEL_PACK_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-currently bound to the target @code{GL_PIXEL_PACK_BUFFER}. If no buffer
-object is bound to this target, 0 is returned. The initial value is 0.
+currently bound to the target @code{GL_PIXEL_PACK_BUFFER}. If no buffer
+object is bound to this target, 0 is returned. The initial value is 0.
See @code{glBindBuffer}.
@item @code{GL_PIXEL_UNPACK_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-currently bound to the target @code{GL_PIXEL_UNPACK_BUFFER}. If no
-buffer object is bound to this target, 0 is returned. The initial value
-is 0. See @code{glBindBuffer}.
+currently bound to the target @code{GL_PIXEL_UNPACK_BUFFER}. If no
+buffer object is bound to this target, 0 is returned. The initial value
+is 0. See @code{glBindBuffer}.
@item @code{GL_POINT_DISTANCE_ATTENUATION}
@var{params} returns three values, the coefficients for computing the
-attenuation value for points. See @code{glPointParameter}.
+attenuation value for points. See @code{glPointParameter}.
@item @code{GL_POINT_FADE_THRESHOLD_SIZE}
@var{params} returns one value, the point size threshold for determining
-the point size. See @code{glPointParameter}.
+the point size. See @code{glPointParameter}.
@item @code{GL_POINT_SIZE}
@var{params} returns one value, the point size as specified by
-@code{glPointSize}. The initial value is 1.
+@code{glPointSize}. The initial value is 1.
@item @code{GL_POINT_SIZE_GRANULARITY}
@var{params} returns one value, the size difference between adjacent
-supported sizes for antialiased points. See @code{glPointSize}.
+supported sizes for antialiased points. See @code{glPointSize}.
@item @code{GL_POINT_SIZE_MAX}
@var{params} returns one value, the upper bound for the attenuated point
-sizes. The initial value is 0.0. See @code{glPointParameter}.
+sizes. The initial value is 0.0. See @code{glPointParameter}.
@item @code{GL_POINT_SIZE_MIN}
@var{params} returns one value, the lower bound for the attenuated point
-sizes. The initial value is 1.0. See @code{glPointParameter}.
+sizes. The initial value is 1.0. See @code{glPointParameter}.
@item @code{GL_POINT_SIZE_RANGE}
@var{params} 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 @code{glPointSize}.
+sizes for antialiased points. The smallest size must be at most 1, and
+the largest size must be at least 1. See @code{glPointSize}.
@item @code{GL_POINT_SMOOTH}
@var{params} returns a single boolean value indicating whether
-antialiasing of points is enabled. The initial value is
-@code{GL_FALSE}. See @code{glPointSize}.
+antialiasing of points is enabled. The initial value is @code{GL_FALSE}.
+See @code{glPointSize}.
@item @code{GL_POINT_SMOOTH_HINT}
@var{params} returns one value, a symbolic constant indicating the mode
-of the point antialiasing hint. The initial value is
-@code{GL_DONT_CARE}. See @code{glHint}.
+of the point antialiasing hint. The initial value is
+@code{GL_DONT_CARE}. See @code{glHint}.
@item @code{GL_POINT_SPRITE}
@var{params} returns a single boolean value indicating whether point
-sprite is enabled. The initial value is @code{GL_FALSE}.
+sprite is enabled. The initial value is @code{GL_FALSE}.
@item @code{GL_POLYGON_MODE}
@var{params} 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 @code{GL_FILL}. See
+or filled polygons. The initial value is @code{GL_FILL}. See
@code{glPolygonMode}.
@item @code{GL_POLYGON_OFFSET_FACTOR}
@var{params} 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
+generated when a polygon is rasterized. The initial value is 0. See
@code{glPolygonOffset}.
@item @code{GL_POLYGON_OFFSET_UNITS}
-@var{params} returns one value. This value is multiplied by an
+@var{params} 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 @code{glPolygonOffset}.
+fragment generated when a polygon is rasterized. The initial value is 0.
+See @code{glPolygonOffset}.
@item @code{GL_POLYGON_OFFSET_FILL}
@var{params} returns a single boolean value indicating whether polygon
-offset is enabled for polygons in fill mode. The initial value is
-@code{GL_FALSE}. See @code{glPolygonOffset}.
+offset is enabled for polygons in fill mode. The initial value is
+@code{GL_FALSE}. See @code{glPolygonOffset}.
@item @code{GL_POLYGON_OFFSET_LINE}
@var{params} returns a single boolean value indicating whether polygon
-offset is enabled for polygons in line mode. The initial value is
-@code{GL_FALSE}. See @code{glPolygonOffset}.
+offset is enabled for polygons in line mode. The initial value is
+@code{GL_FALSE}. See @code{glPolygonOffset}.
@item @code{GL_POLYGON_OFFSET_POINT}
@var{params} returns a single boolean value indicating whether polygon
-offset is enabled for polygons in point mode. The initial value is
-@code{GL_FALSE}. See @code{glPolygonOffset}.
+offset is enabled for polygons in point mode. The initial value is
+@code{GL_FALSE}. See @code{glPolygonOffset}.
@item @code{GL_POLYGON_SMOOTH}
@var{params} returns a single boolean value indicating whether
-antialiasing of polygons is enabled. The initial value is
-@code{GL_FALSE}. See @code{glPolygonMode}.
+antialiasing of polygons is enabled. The initial value is
+@code{GL_FALSE}. See @code{glPolygonMode}.
@item @code{GL_POLYGON_SMOOTH_HINT}
@var{params} returns one value, a symbolic constant indicating the mode
-of the polygon antialiasing hint. The initial value is
-@code{GL_DONT_CARE}. See @code{glHint}.
+of the polygon antialiasing hint. The initial value is
+@code{GL_DONT_CARE}. See @code{glHint}.
@item @code{GL_POLYGON_STIPPLE}
@var{params} returns a single boolean value indicating whether polygon
-stippling is enabled. The initial value is @code{GL_FALSE}. See
+stippling is enabled. The initial value is @code{GL_FALSE}. See
@code{glPolygonStipple}.
@item @code{GL_POST_COLOR_MATRIX_COLOR_TABLE}
@var{params} returns a single boolean value indicating whether post
-color matrix transformation lookup is enabled. The initial value is
-@code{GL_FALSE}. See @code{glColorTable}.
+color matrix transformation lookup is enabled. The initial value is
+@code{GL_FALSE}. See @code{glColorTable}.
@item @code{GL_POST_COLOR_MATRIX_RED_BIAS}
@var{params} returns one value, the red bias factor applied to RGBA
-fragments after color matrix transformations. The initial value is 0.
+fragments after color matrix transformations. The initial value is 0.
See @code{glPixelTransfer}.
@item @code{GL_POST_COLOR_MATRIX_GREEN_BIAS}
@var{params} returns one value, the green bias factor applied to RGBA
-fragments after color matrix transformations. The initial value is 0.
+fragments after color matrix transformations. The initial value is 0.
See @code{glPixelTransfer}
@item @code{GL_POST_COLOR_MATRIX_BLUE_BIAS}
@var{params} returns one value, the blue bias factor applied to RGBA
-fragments after color matrix transformations. The initial value is 0.
+fragments after color matrix transformations. The initial value is 0.
See @code{glPixelTransfer}.
@item @code{GL_POST_COLOR_MATRIX_ALPHA_BIAS}
@var{params} returns one value, the alpha bias factor applied to RGBA
-fragments after color matrix transformations. The initial value is 0.
+fragments after color matrix transformations. The initial value is 0.
See @code{glPixelTransfer}.
@item @code{GL_POST_COLOR_MATRIX_RED_SCALE}
@var{params} returns one value, the red scale factor applied to RGBA
-fragments after color matrix transformations. The initial value is 1.
+fragments after color matrix transformations. The initial value is 1.
See @code{glPixelTransfer}.
@item @code{GL_POST_COLOR_MATRIX_GREEN_SCALE}
@var{params} returns one value, the green scale factor applied to RGBA
-fragments after color matrix transformations. The initial value is 1.
+fragments after color matrix transformations. The initial value is 1.
See @code{glPixelTransfer}.
@item @code{GL_POST_COLOR_MATRIX_BLUE_SCALE}
@var{params} returns one value, the blue scale factor applied to RGBA
-fragments after color matrix transformations. The initial value is 1.
+fragments after color matrix transformations. The initial value is 1.
See @code{glPixelTransfer}.
@item @code{GL_POST_COLOR_MATRIX_ALPHA_SCALE}
@var{params} returns one value, the alpha scale factor applied to RGBA
-fragments after color matrix transformations. The initial value is 1.
+fragments after color matrix transformations. The initial value is 1.
See @code{glPixelTransfer}.
@item @code{GL_POST_CONVOLUTION_COLOR_TABLE}
@var{params} returns a single boolean value indicating whether post
-convolution lookup is enabled. The initial value is @code{GL_FALSE}.
-See @code{glColorTable}.
+convolution lookup is enabled. The initial value is @code{GL_FALSE}. See
+@code{glColorTable}.
@item @code{GL_POST_CONVOLUTION_RED_BIAS}
@var{params} returns one value, the red bias factor applied to RGBA
-fragments after convolution. The initial value is 0. See
+fragments after convolution. The initial value is 0. See
@code{glPixelTransfer}.
@item @code{GL_POST_CONVOLUTION_GREEN_BIAS}
@var{params} returns one value, the green bias factor applied to RGBA
-fragments after convolution. The initial value is 0. See
+fragments after convolution. The initial value is 0. See
@code{glPixelTransfer}.
@item @code{GL_POST_CONVOLUTION_BLUE_BIAS}
@var{params} returns one value, the blue bias factor applied to RGBA
-fragments after convolution. The initial value is 0. See
+fragments after convolution. The initial value is 0. See
@code{glPixelTransfer}.
@item @code{GL_POST_CONVOLUTION_ALPHA_BIAS}
@var{params} returns one value, the alpha bias factor applied to RGBA
-fragments after convolution. The initial value is 0. See
+fragments after convolution. The initial value is 0. See
@code{glPixelTransfer}.
@item @code{GL_POST_CONVOLUTION_RED_SCALE}
@var{params} returns one value, the red scale factor applied to RGBA
-fragments after convolution. The initial value is 1. See
+fragments after convolution. The initial value is 1. See
@code{glPixelTransfer}.
@item @code{GL_POST_CONVOLUTION_GREEN_SCALE}
@var{params} returns one value, the green scale factor applied to RGBA
-fragments after convolution. The initial value is 1. See
+fragments after convolution. The initial value is 1. See
@code{glPixelTransfer}.
@item @code{GL_POST_CONVOLUTION_BLUE_SCALE}
@var{params} returns one value, the blue scale factor applied to RGBA
-fragments after convolution. The initial value is 1. See
+fragments after convolution. The initial value is 1. See
@code{glPixelTransfer}.
@item @code{GL_POST_CONVOLUTION_ALPHA_SCALE}
@var{params} returns one value, the alpha scale factor applied to RGBA
-fragments after convolution. The initial value is 1. See
+fragments after convolution. The initial value is 1. See
@code{glPixelTransfer}.
@item @code{GL_PROJECTION_MATRIX}
@var{params} returns sixteen values: the projection matrix on the top of
-the projection matrix stack. Initially this matrix is the identity
-matrix. See @code{glPushMatrix}.
+the projection matrix stack. Initially this matrix is the identity
+matrix. See @code{glPushMatrix}.
@item @code{GL_PROJECTION_STACK_DEPTH}
@var{params} returns one value, the number of matrices on the projection
-matrix stack. The initial value is 1. See @code{glPushMatrix}.
+matrix stack. The initial value is 1. See @code{glPushMatrix}.
@item @code{GL_READ_BUFFER}
@var{params} returns one value, a symbolic constant indicating which
-color buffer is selected for reading. The initial value is
+color buffer is selected for reading. The initial value is
@code{GL_BACK} if there is a back buffer, otherwise it is
-@code{GL_FRONT}. See @code{glReadPixels} and @code{glAccum}.
+@code{GL_FRONT}. See @code{glReadPixels} and @code{glAccum}.
@item @code{GL_RED_BIAS}
@var{params} returns one value, the red bias factor used during pixel
-transfers. The initial value is 0.
+transfers. The initial value is 0.
@item @code{GL_RED_BITS}
@var{params} returns one value, the red scale factor used during pixel
-transfers. The initial value is 1. See @code{glPixelTransfer}.
+transfers. The initial value is 1. See @code{glPixelTransfer}.
@item @code{GL_RENDER_MODE}
@var{params} returns one value, a symbolic constant indicating whether
-the GL is in render, select, or feedback mode. The initial value is
-@code{GL_RENDER}. See @code{glRenderMode}.
+the GL is in render, select, or feedback mode. The initial value is
+@code{GL_RENDER}. See @code{glRenderMode}.
@item @code{GL_RESCALE_NORMAL}
@var{params} returns single boolean value indicating whether normal
-rescaling is enabled. See @code{glEnable}.
+rescaling is enabled. See @code{glEnable}.
@item @code{GL_RGBA_MODE}
@var{params} returns a single boolean value indicating whether the GL is
-in RGBA mode (true) or color index mode (false). See @code{glColor}.
+in RGBA mode (true) or color index mode (false). See @code{glColor}.
@item @code{GL_SAMPLE_BUFFERS}
@var{params} returns a single integer value indicating the number of
-sample buffers associated with the framebuffer. See
+sample buffers associated with the framebuffer. See
@code{glSampleCoverage}.
@item @code{GL_SAMPLE_COVERAGE_VALUE}
@var{params} returns a single positive floating-point value indicating
-the current sample coverage value. See @code{glSampleCoverage}.
+the current sample coverage value. See @code{glSampleCoverage}.
@item @code{GL_SAMPLE_COVERAGE_INVERT}
@var{params} returns a single boolean value indicating if the temporary
-coverage value should be inverted. See @code{glSampleCoverage}.
+coverage value should be inverted. See @code{glSampleCoverage}.
@item @code{GL_SAMPLES}
@var{params} returns a single integer value indicating the coverage mask
-size. See @code{glSampleCoverage}.
+size. See @code{glSampleCoverage}.
@item @code{GL_SCISSOR_BOX}
@var{params} returns four values: the @r{@var{x}} and @r{@var{y}} window
coordinates of the scissor box, followed by its width and height.
Initially the @r{@var{x}} and @r{@var{y}} window coordinates are both 0
-and the width and height are set to the size of the window. See
+and the width and height are set to the size of the window. See
@code{glScissor}.
@item @code{GL_SCISSOR_TEST}
@var{params} returns a single boolean value indicating whether
-scissoring is enabled. The initial value is @code{GL_FALSE}. See
+scissoring is enabled. The initial value is @code{GL_FALSE}. See
@code{glScissor}.
@item @code{GL_SECONDARY_COLOR_ARRAY}
@var{params} returns a single boolean value indicating whether the
-secondary color array is enabled. The initial value is @code{GL_FALSE}.
+secondary color array is enabled. The initial value is @code{GL_FALSE}.
See @code{glSecondaryColorPointer}.
@item @code{GL_SECONDARY_COLOR_ARRAY_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-associated with the secondary color array. This buffer object would
-have been bound to the target @code{GL_ARRAY_BUFFER} at the time of the
-most recent call to @code{glSecondaryColorPointer}. If no buffer object
-was bound to this target, 0 is returned. The initial value is 0. See
+associated with the secondary color array. This buffer object would have
+been bound to the target @code{GL_ARRAY_BUFFER} at the time of the most
+recent call to @code{glSecondaryColorPointer}. If no buffer object was
+bound to this target, 0 is returned. The initial value is 0. See
@code{glBindBuffer}.
@item @code{GL_SECONDARY_COLOR_ARRAY_SIZE}
@var{params} returns one value, the number of components per color in
-the secondary color array. The initial value is 3. See
+the secondary color array. The initial value is 3. See
@code{glSecondaryColorPointer}.
@item @code{GL_SECONDARY_COLOR_ARRAY_STRIDE}
@var{params} returns one value, the byte offset between consecutive
-colors in the secondary color array. The initial value is 0. See
+colors in the secondary color array. The initial value is 0. See
@code{glSecondaryColorPointer}.
@item @code{GL_SECONDARY_COLOR_ARRAY_TYPE}
@var{params} returns one value, the data type of each component in the
-secondary color array. The initial value is @code{GL_FLOAT}. See
+secondary color array. The initial value is @code{GL_FLOAT}. See
@code{glSecondaryColorPointer}.
@item @code{GL_SELECTION_BUFFER_SIZE}
-@var{params} return one value, the size of the selection buffer. See
+@var{params} return one value, the size of the selection buffer. See
@code{glSelectBuffer}.
@item @code{GL_SEPARABLE_2D}
@var{params} returns a single boolean value indicating whether 2D
-separable convolution is enabled. The initial value is @code{GL_FALSE}.
+separable convolution is enabled. The initial value is @code{GL_FALSE}.
See @code{glSeparableFilter2D}.
@item @code{GL_SHADE_MODEL}
@var{params} returns one value, a symbolic constant indicating whether
-the shading mode is flat or smooth. The initial value is
-@code{GL_SMOOTH}. See @code{glShadeModel}.
+the shading mode is flat or smooth. The initial value is
+@code{GL_SMOOTH}. See @code{glShadeModel}.
@item @code{GL_SMOOTH_LINE_WIDTH_RANGE}
@var{params} returns two values, the smallest and largest supported
-widths for antialiased lines. See @code{glLineWidth}.
+widths for antialiased lines. See @code{glLineWidth}.
@item @code{GL_SMOOTH_LINE_WIDTH_GRANULARITY}
@var{params} returns one value, the granularity of widths for
-antialiased lines. See @code{glLineWidth}.
+antialiased lines. See @code{glLineWidth}.
@item @code{GL_SMOOTH_POINT_SIZE_RANGE}
@var{params} returns two values, the smallest and largest supported
-widths for antialiased points. See @code{glPointSize}.
+widths for antialiased points. See @code{glPointSize}.
@item @code{GL_SMOOTH_POINT_SIZE_GRANULARITY}
@var{params} returns one value, the granularity of sizes for antialiased
-points. See @code{glPointSize}.
+points. See @code{glPointSize}.
@item @code{GL_STENCIL_BACK_FAIL}
@var{params} returns one value, a symbolic constant indicating what
action is taken for back-facing polygons when the stencil test fails.
-The initial value is @code{GL_KEEP}. See @code{glStencilOpSeparate}.
+The initial value is @code{GL_KEEP}. See @code{glStencilOpSeparate}.
@item @code{GL_STENCIL_BACK_FUNC}
@var{params} returns one value, a symbolic constant indicating what
function is used for back-facing polygons to compare the stencil
-reference value with the stencil buffer value. The initial value is
-@code{GL_ALWAYS}. See @code{glStencilFuncSeparate}.
+reference value with the stencil buffer value. The initial value is
+@code{GL_ALWAYS}. See @code{glStencilFuncSeparate}.
@item @code{GL_STENCIL_BACK_PASS_DEPTH_FAIL}
@var{params} returns one value, a symbolic constant indicating what
action is taken for back-facing polygons when the stencil test passes,
-but the depth test fails. The initial value is @code{GL_KEEP}. See
+but the depth test fails. The initial value is @code{GL_KEEP}. See
@code{glStencilOpSeparate}.
@item @code{GL_STENCIL_BACK_PASS_DEPTH_PASS}
@var{params} returns one value, a symbolic constant indicating what
action is taken for back-facing polygons when the stencil test passes
-and the depth test passes. The initial value is @code{GL_KEEP}. See
+and the depth test passes. The initial value is @code{GL_KEEP}. See
@code{glStencilOpSeparate}.
@item @code{GL_STENCIL_BACK_REF}
@var{params} returns one value, the reference value that is compared
-with the contents of the stencil buffer for back-facing polygons. The
-initial value is 0. See @code{glStencilFuncSeparate}.
+with the contents of the stencil buffer for back-facing polygons. The
+initial value is 0. See @code{glStencilFuncSeparate}.
@item @code{GL_STENCIL_BACK_VALUE_MASK}
@var{params} returns one value, the mask that is used for back-facing
polygons to mask both the stencil reference value and the stencil buffer
-value before they are compared. The initial value is all 1's. See
+value before they are compared. The initial value is all 1's. See
@code{glStencilFuncSeparate}.
@item @code{GL_STENCIL_BACK_WRITEMASK}
@var{params} returns one value, the mask that controls writing of the
-stencil bitplanes for back-facing polygons. The initial value is all
-1's. See @code{glStencilMaskSeparate}.
+stencil bitplanes for back-facing polygons. The initial value is all
+1's. See @code{glStencilMaskSeparate}.
@item @code{GL_STENCIL_BITS}
@var{params} returns one value, the index to which the stencil bitplanes
-are cleared. The initial value is 0. See @code{glClearStencil}.
+are cleared. The initial value is 0. See @code{glClearStencil}.
@item @code{GL_STENCIL_FAIL}
@var{params} returns one value, a symbolic constant indicating what
-action is taken when the stencil test fails. The initial value is
-@code{GL_KEEP}. See @code{glStencilOp}. If the GL version is 2.0 or
+action is taken when the stencil test fails. The initial value is
+@code{GL_KEEP}. See @code{glStencilOp}. If the GL version is 2.0 or
greater, this stencil state only affects non-polygons and front-facing
-polygons. Back-facing polygons use separate stencil state. See
+polygons. Back-facing polygons use separate stencil state. See
@code{glStencilOpSeparate}.
@item @code{GL_STENCIL_FUNC}
@var{params} 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 @code{GL_ALWAYS}. See
-@code{glStencilFunc}. If the GL version is 2.0 or greater, this stencil
-state only affects non-polygons and front-facing polygons. Back-facing
-polygons use separate stencil state. See @code{glStencilFuncSeparate}.
+buffer value. The initial value is @code{GL_ALWAYS}. See
+@code{glStencilFunc}. If the GL version is 2.0 or greater, this stencil
+state only affects non-polygons and front-facing polygons. Back-facing
+polygons use separate stencil state. See @code{glStencilFuncSeparate}.
@item @code{GL_STENCIL_PASS_DEPTH_FAIL}
@var{params} 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 @code{GL_KEEP}. See @code{glStencilOp}. If the GL
+The initial value is @code{GL_KEEP}. See @code{glStencilOp}. If the GL
version is 2.0 or greater, this stencil state only affects non-polygons
-and front-facing polygons. Back-facing polygons use separate stencil
-state. See @code{glStencilOpSeparate}.
+and front-facing polygons. Back-facing polygons use separate stencil
+state. See @code{glStencilOpSeparate}.
@item @code{GL_STENCIL_PASS_DEPTH_PASS}
@var{params} 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 @code{GL_KEEP}. See @code{glStencilOp}. If the GL
+The initial value is @code{GL_KEEP}. See @code{glStencilOp}. If the GL
version is 2.0 or greater, this stencil state only affects non-polygons
-and front-facing polygons. Back-facing polygons use separate stencil
-state. See @code{glStencilOpSeparate}.
+and front-facing polygons. Back-facing polygons use separate stencil
+state. See @code{glStencilOpSeparate}.
@item @code{GL_STENCIL_REF}
@var{params} returns one value, the reference value that is compared
-with the contents of the stencil buffer. The initial value is 0. See
-@code{glStencilFunc}. If the GL version is 2.0 or greater, this stencil
-state only affects non-polygons and front-facing polygons. Back-facing
-polygons use separate stencil state. See @code{glStencilFuncSeparate}.
+with the contents of the stencil buffer. The initial value is 0. See
+@code{glStencilFunc}. If the GL version is 2.0 or greater, this stencil
+state only affects non-polygons and front-facing polygons. Back-facing
+polygons use separate stencil state. See @code{glStencilFuncSeparate}.
@item @code{GL_STENCIL_TEST}
@var{params} returns a single boolean value indicating whether stencil
-testing of fragments is enabled. The initial value is @code{GL_FALSE}.
+testing of fragments is enabled. The initial value is @code{GL_FALSE}.
See @code{glStencilFunc} and @code{glStencilOp}.
@item @code{GL_STENCIL_VALUE_MASK}
@var{params} 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 @code{glStencilFunc}. If
-the GL version is 2.0 or greater, this stencil state only affects
-non-polygons and front-facing polygons. Back-facing polygons use
-separate stencil state. See @code{glStencilFuncSeparate}.
+compared. The initial value is all 1's. See @code{glStencilFunc}. If the
+GL version is 2.0 or greater, this stencil state only affects
+non-polygons and front-facing polygons. Back-facing polygons use
+separate stencil state. See @code{glStencilFuncSeparate}.
@item @code{GL_STENCIL_WRITEMASK}
@var{params} returns one value, the mask that controls writing of the
-stencil bitplanes. The initial value is all 1's. See
-@code{glStencilMask}. If the GL version is 2.0 or greater, this stencil
-state only affects non-polygons and front-facing polygons. Back-facing
-polygons use separate stencil state. See @code{glStencilMaskSeparate}.
+stencil bitplanes. The initial value is all 1's. See
+@code{glStencilMask}. If the GL version is 2.0 or greater, this stencil
+state only affects non-polygons and front-facing polygons. Back-facing
+polygons use separate stencil state. See @code{glStencilMaskSeparate}.
@item @code{GL_STEREO}
@var{params} returns one value, an estimate of the number of bits of
subpixel resolution that are used to position rasterized geometry in
-window coordinates. The value must be at least 4.
+window coordinates. The value must be at least 4.
@item @code{GL_TEXTURE_1D}
@var{params} returns a single boolean value indicating whether 1D
-texture mapping is enabled. The initial value is @code{GL_FALSE}. See
+texture mapping is enabled. The initial value is @code{GL_FALSE}. See
@code{glTexImage1D}.
@item @code{GL_TEXTURE_BINDING_1D}
@var{params} returns a single value, the name of the texture currently
-bound to the target @code{GL_TEXTURE_1D}. The initial value is 0. See
+bound to the target @code{GL_TEXTURE_1D}. The initial value is 0. See
@code{glBindTexture}.
@item @code{GL_TEXTURE_2D}
@var{params} returns a single boolean value indicating whether 2D
-texture mapping is enabled. The initial value is @code{GL_FALSE}. See
+texture mapping is enabled. The initial value is @code{GL_FALSE}. See
@code{glTexImage2D}.
@item @code{GL_TEXTURE_BINDING_2D}
@var{params} returns a single value, the name of the texture currently
-bound to the target @code{GL_TEXTURE_2D}. The initial value is 0. See
+bound to the target @code{GL_TEXTURE_2D}. The initial value is 0. See
@code{glBindTexture}.
@item @code{GL_TEXTURE_3D}
@var{params} returns a single boolean value indicating whether 3D
-texture mapping is enabled. The initial value is @code{GL_FALSE}. See
+texture mapping is enabled. The initial value is @code{GL_FALSE}. See
@code{glTexImage3D}.
@item @code{GL_TEXTURE_BINDING_3D}
@var{params} returns a single value, the name of the texture currently
-bound to the target @code{GL_TEXTURE_3D}. The initial value is 0. See
+bound to the target @code{GL_TEXTURE_3D}. The initial value is 0. See
@code{glBindTexture}.
@item @code{GL_TEXTURE_BINDING_CUBE_MAP}
@var{params} returns a single value, the name of the texture currently
-bound to the target @code{GL_TEXTURE_CUBE_MAP}. The initial value is 0.
+bound to the target @code{GL_TEXTURE_CUBE_MAP}. The initial value is 0.
See @code{glBindTexture}.
@item @code{GL_TEXTURE_COMPRESSION_HINT}
@var{params} returns a single value indicating the mode of the texture
-compression hint. The initial value is @code{GL_DONT_CARE}.
+compression hint. The initial value is @code{GL_DONT_CARE}.
@item @code{GL_TEXTURE_COORD_ARRAY}
@var{params} returns a single boolean value indicating whether the
-texture coordinate array is enabled. The initial value is
-@code{GL_FALSE}. See @code{glTexCoordPointer}.
+texture coordinate array is enabled. The initial value is
+@code{GL_FALSE}. See @code{glTexCoordPointer}.
@item @code{GL_TEXTURE_COORD_ARRAY_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-associated with the texture coordinate array. This buffer object would
+associated with the texture coordinate array. This buffer object would
have been bound to the target @code{GL_ARRAY_BUFFER} at the time of the
-most recent call to @code{glTexCoordPointer}. If no buffer object was
-bound to this target, 0 is returned. The initial value is 0. See
+most recent call to @code{glTexCoordPointer}. If no buffer object was
+bound to this target, 0 is returned. The initial value is 0. See
@code{glBindBuffer}.
@item @code{GL_TEXTURE_COORD_ARRAY_SIZE}
@var{params} returns one value, the number of coordinates per element in
-the texture coordinate array. The initial value is 4. See
+the texture coordinate array. The initial value is 4. See
@code{glTexCoordPointer}.
@item @code{GL_TEXTURE_COORD_ARRAY_STRIDE}
@var{params} returns one value, the byte offset between consecutive
-elements in the texture coordinate array. The initial value is 0. See
+elements in the texture coordinate array. The initial value is 0. See
@code{glTexCoordPointer}.
@item @code{GL_TEXTURE_COORD_ARRAY_TYPE}
@var{params} returns one value, the data type of the coordinates in the
-texture coordinate array. The initial value is @code{GL_FLOAT}. See
+texture coordinate array. The initial value is @code{GL_FLOAT}. See
@code{glTexCoordPointer}.
@item @code{GL_TEXTURE_CUBE_MAP}
@var{params} returns a single boolean value indicating whether
-cube-mapped texture mapping is enabled. The initial value is
-@code{GL_FALSE}. See @code{glTexImage2D}.
+cube-mapped texture mapping is enabled. The initial value is
+@code{GL_FALSE}. See @code{glTexImage2D}.
@item @code{GL_TEXTURE_GEN_Q}
@var{params} returns a single boolean value indicating whether automatic
-generation of the @var{q} texture coordinate is enabled. The initial
-value is @code{GL_FALSE}. See @code{glTexGen}.
+generation of the @var{q} texture coordinate is enabled. The initial
+value is @code{GL_FALSE}. See @code{glTexGen}.
@item @code{GL_TEXTURE_GEN_R}
@var{params} returns a single boolean value indicating whether automatic
-generation of the @var{r} texture coordinate is enabled. The initial
-value is @code{GL_FALSE}. See @code{glTexGen}.
+generation of the @var{r} texture coordinate is enabled. The initial
+value is @code{GL_FALSE}. See @code{glTexGen}.
@item @code{GL_TEXTURE_GEN_S}
@var{params} returns a single boolean value indicating whether automatic
-generation of the @var{S} texture coordinate is enabled. The initial
-value is @code{GL_FALSE}. See @code{glTexGen}.
+generation of the @var{S} texture coordinate is enabled. The initial
+value is @code{GL_FALSE}. See @code{glTexGen}.
@item @code{GL_TEXTURE_GEN_T}
@var{params} returns a single boolean value indicating whether automatic
-generation of the T texture coordinate is enabled. The initial value is
-@code{GL_FALSE}. See @code{glTexGen}.
+generation of the T texture coordinate is enabled. The initial value is
+@code{GL_FALSE}. See @code{glTexGen}.
@item @code{GL_TEXTURE_MATRIX}
@var{params} returns sixteen values: the texture matrix on the top of
-the texture matrix stack. Initially this matrix is the identity matrix.
+the texture matrix stack. Initially this matrix is the identity matrix.
See @code{glPushMatrix}.
@item @code{GL_TEXTURE_STACK_DEPTH}
@var{params} returns one value, the number of matrices on the texture
-matrix stack. The initial value is 1. See @code{glPushMatrix}.
+matrix stack. The initial value is 1. See @code{glPushMatrix}.
@item @code{GL_TRANSPOSE_COLOR_MATRIX}
@var{params} returns 16 values, the elements of the color matrix in
-row-major order. See @code{glLoadTransposeMatrix}.
+row-major order. See @code{glLoadTransposeMatrix}.
@item @code{GL_TRANSPOSE_MODELVIEW_MATRIX}
@var{params} returns 16 values, the elements of the modelview matrix in
-row-major order. See @code{glLoadTransposeMatrix}.
+row-major order. See @code{glLoadTransposeMatrix}.
@item @code{GL_TRANSPOSE_PROJECTION_MATRIX}
@var{params} returns 16 values, the elements of the projection matrix in
-row-major order. See @code{glLoadTransposeMatrix}.
+row-major order. See @code{glLoadTransposeMatrix}.
@item @code{GL_TRANSPOSE_TEXTURE_MATRIX}
@var{params} returns 16 values, the elements of the texture matrix in
-row-major order. See @code{glLoadTransposeMatrix}.
+row-major order. See @code{glLoadTransposeMatrix}.
@item @code{GL_UNPACK_ALIGNMENT}
@var{params} returns one value, the byte alignment used for reading
-pixel data from memory. The initial value is 4. See
-@code{glPixelStore}.
+pixel data from memory. The initial value is 4. See @code{glPixelStore}.
@item @code{GL_UNPACK_IMAGE_HEIGHT}
@var{params} returns one value, the image height used for reading pixel
-data from memory. The initial is 0. See @code{glPixelStore}.
+data from memory. The initial is 0. See @code{glPixelStore}.
@item @code{GL_UNPACK_LSB_FIRST}
@var{params} 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
-@code{GL_FALSE}. See @code{glPixelStore}.
+significant bit of each unsigned byte. The initial value is
+@code{GL_FALSE}. See @code{glPixelStore}.
@item @code{GL_UNPACK_ROW_LENGTH}
@var{params} returns one value, the row length used for reading pixel
-data from memory. The initial value is 0. See @code{glPixelStore}.
+data from memory. The initial value is 0. See @code{glPixelStore}.
@item @code{GL_UNPACK_SKIP_IMAGES}
@var{params} returns one value, the number of pixel images skipped
-before the first pixel is read from memory. The initial value is 0. See
+before the first pixel is read from memory. The initial value is 0. See
@code{glPixelStore}.
@item @code{GL_UNPACK_SKIP_PIXELS}
@var{params} returns one value, the number of pixel locations skipped
-before the first pixel is read from memory. The initial value is 0. See
+before the first pixel is read from memory. The initial value is 0. See
@code{glPixelStore}.
@item @code{GL_UNPACK_SKIP_ROWS}
@var{params} 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 @code{glPixelStore}.
+skipped before the first pixel is read from memory. The initial value is
+0. See @code{glPixelStore}.
@item @code{GL_UNPACK_SWAP_BYTES}
@var{params} 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 @code{GL_FALSE}. See
+being read from memory. The initial value is @code{GL_FALSE}. See
@code{glPixelStore}.
@item @code{GL_VERTEX_ARRAY}
@var{params} returns a single boolean value indicating whether the
-vertex array is enabled. The initial value is @code{GL_FALSE}. See
+vertex array is enabled. The initial value is @code{GL_FALSE}. See
@code{glVertexPointer}.
@item @code{GL_VERTEX_ARRAY_BUFFER_BINDING}
@var{params} returns a single value, the name of the buffer object
-associated with the vertex array. This buffer object would have been
+associated with the vertex array. This buffer object would have been
bound to the target @code{GL_ARRAY_BUFFER} at the time of the most
-recent call to @code{glVertexPointer}. If no buffer object was bound to
-this target, 0 is returned. The initial value is 0. See
+recent call to @code{glVertexPointer}. If no buffer object was bound to
+this target, 0 is returned. The initial value is 0. See
@code{glBindBuffer}.
@item @code{GL_VERTEX_ARRAY_SIZE}
@var{params} returns one value, the number of coordinates per vertex in
-the vertex array. The initial value is 4. See @code{glVertexPointer}.
+the vertex array. The initial value is 4. See @code{glVertexPointer}.
@item @code{GL_VERTEX_ARRAY_STRIDE}
@var{params} returns one value, the byte offset between consecutive
-vertices in the vertex array. The initial value is 0. See
+vertices in the vertex array. The initial value is 0. See
@code{glVertexPointer}.
@item @code{GL_VERTEX_ARRAY_TYPE}
@var{params} returns one value, the data type of each coordinate in the
-vertex array. The initial value is @code{GL_FLOAT}. See
+vertex array. The initial value is @code{GL_FLOAT}. See
@code{glVertexPointer}.
@item @code{GL_VERTEX_PROGRAM_POINT_SIZE}
@var{params} returns a single boolean value indicating whether vertex
-program point size mode is enabled. If enabled, and a vertex shader is
+program point size mode is enabled. If enabled, and a vertex shader is
active, then the point size is taken from the shader built-in
-@code{gl_PointSize}. If disabled, and a vertex shader is active, then
+@code{gl_PointSize}. If disabled, and a vertex shader is active, then
the point size is taken from the point state as specified by
-@code{glPointSize}. The initial value is @code{GL_FALSE}.
+@code{glPointSize}. The initial value is @code{GL_FALSE}.
@item @code{GL_VERTEX_PROGRAM_TWO_SIDE}
@var{params} returns a single boolean value indicating whether vertex
-program two-sided color mode is enabled. If enabled, and a vertex
-shader is active, then the GL chooses the back color output for
-back-facing polygons, and the front color output for non-polygons and
-front-facing polygons. If disabled, and a vertex shader is active, then
-the front color output is always selected. The initial value is
-@code{GL_FALSE}.
+program two-sided color mode is enabled. If enabled, and a vertex shader
+is active, then the GL chooses the back color output for back-facing
+polygons, and the front color output for non-polygons and front-facing
+polygons. If disabled, and a vertex shader is active, then the front
+color output is always selected. The initial value is @code{GL_FALSE}.
@item @code{GL_VIEWPORT}
@var{params} returns four values: the @r{@var{x}} and @r{@var{y}} window
-coordinates of the viewport, followed by its width and height. Initially
+coordinates of the viewport, followed by its width and height. Initially
the @r{@var{x}} and @r{@var{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 @code{glViewport}.
+into which the GL will do its rendering. See @code{glViewport}.
@item @code{GL_ZOOM_X}
-@var{params} returns one value, the @r{@var{x}} pixel zoom factor. The
-initial value is 1. See @code{glPixelZoom}.
+@var{params} returns one value, the @r{@var{x}} pixel zoom factor. The
+initial value is 1. See @code{glPixelZoom}.
@item @code{GL_ZOOM_Y}
-@var{params} returns one value, the @r{@var{y}} pixel zoom factor. The
-initial value is 1. See @code{glPixelZoom}.
+@var{params} returns one value, the @r{@var{y}} pixel zoom factor. The
+initial value is 1. See @code{glPixelZoom}.
@end table
@end table
Certain aspects of GL behavior, when there is room for interpretation,
-can be controlled with hints. A hint is specified with two arguments.
+can be controlled with hints. A hint is specified with two arguments.
@var{target} is a symbolic constant indicating the behavior to be
controlled, and @var{mode} is another symbolic constant indicating the
-desired behavior. The initial value for each @var{target} is
-@code{GL_DONT_CARE}. @var{mode} can be one of the following:
+desired behavior. The initial value for each @var{target} is
+@code{GL_DONT_CARE}. @var{mode} can be one of the following:
@table @asis
@item @code{GL_FASTEST}
@end table
Though the implementation aspects that can be hinted are well defined,
-the interpretation of the hints depends on the implementation. The hint
+the interpretation of the hints depends on the implementation. The hint
aspects that can be specified with @var{target}, along with suggested
semantics, are as follows:
@item @code{GL_FOG_HINT}
-Indicates the accuracy of fog calculation. If per-pixel fog calculation
+Indicates the accuracy of fog calculation. If per-pixel fog calculation
is not efficiently supported by the GL implementation, hinting
@code{GL_DONT_CARE} or @code{GL_FASTEST} can result in per-vertex
calculation of fog effects.
@item @code{GL_LINE_SMOOTH_HINT}
-Indicates the sampling quality of antialiased lines. If a larger filter
+Indicates the sampling quality of antialiased lines. If a larger filter
function is applied, hinting @code{GL_NICEST} can result in more pixel
fragments being generated during rasterization.
Indicates the quality of color, texture coordinate, and fog coordinate
-interpolation. If perspective-corrected parameter interpolation is not
+interpolation. If perspective-corrected parameter interpolation is not
efficiently supported by the GL implementation, hinting
@code{GL_DONT_CARE} or @code{GL_FASTEST} can result in simple linear
interpolation of colors and/or texture coordinates.
@item @code{GL_POINT_SMOOTH_HINT}
-Indicates the sampling quality of antialiased points. If a larger
-filter function is applied, hinting @code{GL_NICEST} can result in more
-pixel fragments being generated during rasterization.
+Indicates the sampling quality of antialiased points. If a larger filter
+function is applied, hinting @code{GL_NICEST} can result in more pixel
+fragments being generated during rasterization.
@item @code{GL_POLYGON_SMOOTH_HINT}
-Indicates the sampling quality of antialiased polygons. Hinting
+Indicates the sampling quality of antialiased polygons. Hinting
@code{GL_NICEST} can result in more pixel fragments being generated
during rasterization, if a larger filter function is applied.
Hinting @code{GL_FASTEST} indicates that texture images should be
compressed as quickly as possible, while @code{GL_NICEST} indicates that
texture images should be compressed with as little image quality loss as
-possible. @code{GL_NICEST} should be selected if the texture is to be
+possible. @code{GL_NICEST} should be selected if the texture is to be
retrieved by @code{glGetCompressedTexImage} for reuse.
@end table
@table @asis
@item @var{target}
-The histogram whose parameters are to be set. Must be one of
+The histogram whose parameters are to be set. Must be one of
@code{GL_HISTOGRAM} or @code{GL_PROXY_HISTOGRAM}.
@item @var{width}
-The number of entries in the histogram table. Must be a power of 2.
+The number of entries in the histogram table. Must be a power of 2.
@item @var{internalformat}
-The format of entries in the histogram table. Must be one of
+The format of entries in the histogram table. Must be one of
@code{GL_ALPHA}, @code{GL_ALPHA4}, @code{GL_ALPHA8}, @code{GL_ALPHA12},
@code{GL_ALPHA16}, @code{GL_LUMINANCE}, @code{GL_LUMINANCE4},
@code{GL_LUMINANCE8}, @code{GL_LUMINANCE12}, @code{GL_LUMINANCE16},
@item @var{sink}
If @code{GL_TRUE}, pixels will be consumed by the histogramming process
-and no drawing or texture loading will take place. If @code{GL_FALSE},
+and no drawing or texture loading will take place. If @code{GL_FALSE},
pixels will proceed to the minmax process after histogramming.
@end table
When @code{GL_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
+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.)
+undefined. (This is not an error.)
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 @code{glEnable} and
+table lookup). Histogramming is enabled with @code{glEnable} and
disabled with @code{glDisable}.
When @var{target} is @code{GL_HISTOGRAM}, @code{glHistogram} redefines
the current histogram table to have @var{width} entries of the format
-specified by @var{internalformat}. The entries are indexed 0 through
-@r{@var{width}-1}, and all entries are initialized to zero. The values
-in the previous histogram table, if any, are lost. If @var{sink} is
+specified by @var{internalformat}. The entries are indexed 0 through
+@r{@var{width}-1}, and all entries are initialized to zero. The values
+in the previous histogram table, if any, are lost. If @var{sink} is
@code{GL_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.
When @var{target} is @code{GL_PROXY_HISTOGRAM}, @code{glHistogram}
computes all state information as if the histogram table were to be
-redefined, but does not actually define the new table. If the requested
+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
+will be set to zero. This provides a way to determine if a histogram
table with the given parameters can be supported.
@table @asis
@item @var{mask}
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.
+bits in the color index buffers. Initially, the mask is all 1's.
@end table
@code{glIndexMask} controls the writing of individual bits in the color
-index buffers. The least significant @r{@var{n}} bits of @var{mask},
+index buffers. The least significant @r{@var{n}} bits of @var{mask},
where @r{@var{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
+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.
This mask is used only in color index mode, and it affects only the
@table @asis
@item @var{type}
-Specifies the data type of each color index in the array. Symbolic
+Specifies the data type of each color index in the array. Symbolic
constants @code{GL_UNSIGNED_BYTE}, @code{GL_SHORT}, @code{GL_INT},
-@code{GL_FLOAT}, and @code{GL_DOUBLE} are accepted. The initial value
-is @code{GL_FLOAT}.
+@code{GL_FLOAT}, and @code{GL_DOUBLE} are accepted. The initial value is
+@code{GL_FLOAT}.
@item @var{stride}
-Specifies the byte offset between consecutive color indexes. If
+Specifies the byte offset between consecutive color indexes. If
@var{stride} is 0, the color indexes are understood to be tightly packed
-in the array. The initial value is 0.
+in the array. The initial value is 0.
@item @var{pointer}
-Specifies a pointer to the first index in the array. The initial value
+Specifies a pointer to the first index in the array. The initial value
is 0.
@end table
@code{glIndexPointer} specifies the location and data format of an array
-of color indexes to use when rendering. @var{type} specifies the data
+of color indexes to use when rendering. @var{type} specifies the data
type of each color index and @var{stride} specifies 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.
If a non-zero named buffer object is bound to the @code{GL_ARRAY_BUFFER}
target (see @code{glBindBuffer}) while a color index array is specified,
@var{pointer} is treated as a byte offset into the buffer object's data
-store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
+store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
is saved as color index vertex array client-side state
(@code{GL_INDEX_ARRAY_BUFFER_BINDING}).
To enable and disable the color index array, call
@code{glEnableClientState} and @code{glDisableClientState} with the
-argument @code{GL_INDEX_ARRAY}. If enabled, the color index array is
+argument @code{GL_INDEX_ARRAY}. If enabled, the color index array is
used when @code{glDrawArrays}, @code{glMultiDrawArrays},
@code{glDrawElements}, @code{glMultiDrawElements},
@code{glDrawRangeElements}, or @code{glArrayElement} is called.
@end table
-@code{glIndex} updates the current (single-valued) color index. It
-takes one argument, the new value for the current color index.
+@code{glIndex} updates the current (single-valued) color index. It takes
+one argument, the new value for the current color index.
-The current index is stored as a floating-point value. Integer values
+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.
+mapping. The initial value is 1.
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
+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.
Initialize the name stack.
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. @code{glInitNames} causes the name stack to be
+commands to be uniquely identified. It consists of an ordered set of
+unsigned integers. @code{glInitNames} causes the name stack to be
initialized to its default empty state.
The name stack is always empty while the render mode is not
-@code{GL_SELECT}. Calls to @code{glInitNames} while the render mode is
+@code{GL_SELECT}. Calls to @code{glInitNames} while the render mode is
not @code{GL_SELECT} are ignored.
@code{GL_INVALID_OPERATION} is generated if @code{glInitNames} is
@table @asis
@item @var{format}
-Specifies the type of array to enable. Symbolic constants
-@code{GL_V2F}, @code{GL_V3F}, @code{GL_C4UB_V2F}, @code{GL_C4UB_V3F},
+Specifies the type of array to enable. Symbolic constants @code{GL_V2F},
+@code{GL_V3F}, @code{GL_C4UB_V2F}, @code{GL_C4UB_V3F},
@code{GL_C3F_V3F}, @code{GL_N3F_V3F}, @code{GL_C4F_N3F_V3F},
@code{GL_T2F_V3F}, @code{GL_T4F_V4F}, @code{GL_T2F_C4UB_V3F},
@code{GL_T2F_C3F_V3F}, @code{GL_T2F_N3F_V3F}, @code{GL_T2F_C4F_N3F_V3F},
@code{glInterleavedArrays} 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
+aggregate array element. For some implementations, this is more
efficient than specifying the arrays separately.
If @var{stride} is 0, the aggregate elements are stored consecutively.
element.
@var{format} serves as a ``key'' describing the extraction of individual
-arrays from the aggregate array. If @var{format} 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.
+arrays from the aggregate array. If @var{format} 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.
-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.
+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.
@code{GL_INVALID_ENUM} is generated if @var{format} is not an accepted
value.
@end table
@code{glIsBuffer} returns @code{GL_TRUE} if @var{buffer} is currently
-the name of a buffer object. If @var{buffer} is zero, or is a non-zero
+the name of a buffer object. If @var{buffer} is zero, or is a non-zero
value that is not currently the name of a buffer object, or if an error
occurs, @code{glIsBuffer} returns @code{GL_FALSE}.
@end table
@code{glIsEnabled} returns @code{GL_TRUE} if @var{cap} is an enabled
-capability and returns @code{GL_FALSE} otherwise. Initially all
+capability and returns @code{GL_FALSE} otherwise. Initially all
capabilities except @code{GL_DITHER} are disabled; @code{GL_DITHER} is
initially enabled.
@code{glIsProgram} returns @code{GL_TRUE} if @var{program} is the name
of a program object previously created with @code{glCreateProgram} and
-not yet deleted with @code{glDeleteProgram}. If @var{program} is zero
-or a non-zero value that is not the name of a program object, or if an
+not yet deleted with @code{glDeleteProgram}. If @var{program} is zero or
+a non-zero value that is not the name of a program object, or if an
error occurs, @code{glIsProgram} returns @code{GL_FALSE}.
@code{GL_INVALID_OPERATION} is generated if @code{glIsProgram} is
@end table
@code{glIsQuery} returns @code{GL_TRUE} if @var{id} is currently the
-name of a query object. If @var{id} is zero, or is a non-zero value
-that is not currently the name of a query object, or if an error occurs,
+name of a query object. If @var{id} is zero, or is a non-zero value that
+is not currently the name of a query object, or if an error occurs,
@code{glIsQuery} returns @code{GL_FALSE}.
A name returned by @code{glGenQueries}, but not yet associated with a
@code{glIsShader} returns @code{GL_TRUE} if @var{shader} is the name of
a shader object previously created with @code{glCreateShader} and not
-yet deleted with @code{glDeleteShader}. If @var{shader} is zero or a
+yet deleted with @code{glDeleteShader}. If @var{shader} is zero or a
non-zero value that is not the name of a shader object, or if an error
occurs, @code{glIsShader } returns @code{GL_FALSE}.
@end table
@code{glIsTexture} returns @code{GL_TRUE} if @var{texture} is currently
-the name of a texture. If @var{texture} is zero, or is a non-zero value
+the name of a texture. If @var{texture} is zero, or is a non-zero value
that is not currently the name of a texture, or if an error occurs,
@code{glIsTexture} returns @code{GL_FALSE}.
@end table
-@code{glLightModel} sets the lighting model parameter. @var{pname}
-names a parameter and @var{params} gives the new value. There are three
+@code{glLightModel} sets the lighting model parameter. @var{pname} names
+a parameter and @var{params} gives the new value. There are three
lighting model parameters:
@table @asis
@var{params} contains four integer or floating-point values that specify
-the ambient RGBA intensity of the entire scene. Integer values are
+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 @r{-1.0}.
-Floating-point values are mapped directly. Neither integer nor
-floating-point values are clamped. The initial ambient scene intensity
+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).
@item @code{GL_LIGHT_MODEL_COLOR_CONTROL}
@var{params} must be either @code{GL_SEPARATE_SPECULAR_COLOR} or
-@code{GL_SINGLE_COLOR}. @code{GL_SINGLE_COLOR} specifies that a single
+@code{GL_SINGLE_COLOR}. @code{GL_SINGLE_COLOR} specifies that a single
color is generated from the lighting computation for a vertex.
@code{GL_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
+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 @code{GL_SINGLE_COLOR}.
@var{params} is a single integer or floating-point value that specifies
-how specular reflection angles are computed. If @var{params} is 0 (or
+how specular reflection angles are computed. If @var{params} is 0 (or
0.0), specular reflection angles take the view direction to be parallel
to and in the direction of the -@var{z} 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.
+of the vertex in eye coordinates. Otherwise, specular reflections are
+computed from the origin of the eye coordinate system. The initial value
+is 0.
@item @code{GL_LIGHT_MODEL_TWO_SIDE}
@var{params} 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 @var{params} is 0 (or 0.0), one-sided lighting is
-specified, and only the @var{front} 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 @var{back}
+bitmaps. If @var{params} is 0 (or 0.0), one-sided lighting is specified,
+and only the @var{front} 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 @var{back}
material parameters and have their normals reversed before the lighting
-equation is evaluated. Vertices of front-facing polygons are always
+equation is evaluated. Vertices of front-facing polygons are always
lighted using the @var{front} material parameters, with no change to
-their normals. The initial value is 0.
+their normals. The initial value is 0.
@end table
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
+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
+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
+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
+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
+exponent, and spread cutoff angle. All dot products are replaced with 0
if they evaluate to a negative value.
The alpha component of the resulting lighted color is set to the alpha
In color index mode, the value of the lighted index of a vertex ranges
from the ambient to the specular values passed to @code{glMaterial}
-using @code{GL_COLOR_INDEXES}. Diffuse and specular coefficients,
+using @code{GL_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
@table @asis
@item @var{light}
-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 @code{GL_LIGHT}@r{@var{i}}, where i ranges
-from 0 to the value of @code{GL_MAX_LIGHTS} - 1.
+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 @code{GL_LIGHT}@r{@var{i}}, where i ranges from 0 to
+the value of @code{GL_MAX_LIGHTS} - 1.
@item @var{pname}
Specifies a single-valued light source parameter for @var{light}.
@code{glLight} sets the values of individual light source parameters.
@var{light} names the light and is a symbolic name of the form
@code{GL_LIGHT}@r{@var{i}}, where i ranges from 0 to the value of
-@code{GL_MAX_LIGHTS} - 1. @var{pname} specifies one of ten light source
-parameters, again by symbolic name. @var{params} is either a single
+@code{GL_MAX_LIGHTS} - 1. @var{pname} specifies one of ten light source
+parameters, again by symbolic name. @var{params} is either a single
value or a pointer to an array that contains the new values.
To enable and disable lighting calculation, call @code{glEnable} and
-@code{glDisable} with argument @code{GL_LIGHTING}. Lighting is
-initially disabled. When it is enabled, light sources that are enabled
-contribute to the lighting calculation. Light source @r{@var{i}} is
-enabled and disabled using @code{glEnable} and @code{glDisable} with
-argument @code{GL_LIGHT}@r{@var{i}}.
+@code{glDisable} with argument @code{GL_LIGHTING}. Lighting is initially
+disabled. When it is enabled, light sources that are enabled contribute
+to the lighting calculation. Light source @r{@var{i}} is enabled and
+disabled using @code{glEnable} and @code{glDisable} with argument
+@code{GL_LIGHT}@r{@var{i}}.
The ten light parameters are as follows:
@table @asis
@item @code{GL_AMBIENT}
@var{params} contains four integer or floating-point values that specify
-the ambient RGBA intensity of the light. Integer values are mapped
+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 @r{-1.0}.
-Floating-point values are mapped directly. Neither integer nor
-floating-point values are clamped. The initial ambient light intensity
+Floating-point values are mapped directly. Neither integer nor
+floating-point values are clamped. The initial ambient light intensity
is (0, 0, 0, 1).
@item @code{GL_DIFFUSE}
@var{params} contains four integer or floating-point values that specify
-the diffuse RGBA intensity of the light. Integer values are mapped
+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 @r{-1.0}.
-Floating-point values are mapped directly. Neither integer nor
-floating-point values are clamped. The initial value for
+Floating-point values are mapped directly. Neither integer nor
+floating-point values are clamped. The initial value for
@code{GL_LIGHT0} is (1, 1, 1, 1); for other lights, the initial value is
(0, 0, 0, 1).
@item @code{GL_SPECULAR}
@var{params} contains four integer or floating-point values that specify
-the specular RGBA intensity of the light. Integer values are mapped
+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 @r{-1.0}.
-Floating-point values are mapped directly. Neither integer nor
-floating-point values are clamped. The initial value for
+Floating-point values are mapped directly. Neither integer nor
+floating-point values are clamped. The initial value for
@code{GL_LIGHT0} is (1, 1, 1, 1); for other lights, the initial value is
(0, 0, 0, 1).
@item @code{GL_POSITION}
@var{params} 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
+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.
The position is transformed by the modelview matrix when @code{glLight}
is called (just as if it were a point), and it is stored in eye
-coordinates. If the @r{@var{w}} component of the position is 0, the
-light is treated as a directional source. Diffuse and specular lighting
+coordinates. If the @r{@var{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
+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
+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 @r{-@var{z}} axis.
@item @code{GL_SPOT_DIRECTION}
@var{params} 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
+Both integer and floating-point values are mapped directly. Neither
integer nor floating-point values are clamped.
The spot direction is transformed by the upper 3x3 of the modelview
matrix when @code{glLight} is called, and it is stored in eye
-coordinates. It is significant only when @code{GL_SPOT_CUTOFF} is not
-180, which it is initially. The initial direction is @r{(0,0-1)}.
+coordinates. It is significant only when @code{GL_SPOT_CUTOFF} is not
+180, which it is initially. The initial direction is @r{(0,0-1)}.
@item @code{GL_SPOT_EXPONENT}
@var{params} 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 @r{[0,128]} are
+the intensity distribution of the light. Integer and floating-point
+values are mapped directly. Only values in the range @r{[0,128]} are
accepted.
Effective light intensity is attenuated by the cosine of the angle
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 @code{GL_SPOT_CUTOFF}, next
-paragraph). The initial spot exponent is 0, resulting in uniform light
+paragraph). The initial spot exponent is 0, resulting in uniform light
distribution.
@item @code{GL_SPOT_CUTOFF}
@var{params} 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 @r{[0,90]} and the
-special value 180 are accepted. If the angle between the direction of
+the maximum spread angle of a light source. Integer and floating-point
+values are mapped directly. Only values in the range @r{[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.
Otherwise, its intensity is controlled by the spot exponent and the
-attenuation factors. The initial spot cutoff is 180, resulting in
+attenuation factors. The initial spot cutoff is 180, resulting in
uniform light distribution.
@item @code{GL_CONSTANT_ATTENUATION}
@item @code{GL_LINEAR_ATTENUATION}
@item @code{GL_QUADRATIC_ATTENUATION}
@var{params} 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
+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.
@table @asis
@item @var{factor}
-Specifies a multiplier for each bit in the line stipple pattern. If
+Specifies a multiplier for each bit in the line stipple pattern. If
@var{factor} is 3, for example, each bit in the pattern is used three
-times before the next bit in the pattern is used. @var{factor} is
+times before the next bit in the pattern is used. @var{factor} is
clamped to the range [1, 256] and defaults to 1.
@item @var{pattern}
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
+of a line will be drawn when the line is rasterized. Bit zero is used
first; the default pattern is all 1's.
@end table
Line stippling masks out certain fragments produced by rasterization;
-those fragments will not be drawn. The masking is achieved by using
+those fragments will not be drawn. The masking is achieved by using
three parameters: the 16-bit line stipple pattern @var{pattern}, the
repeat count @var{factor}, and an integer stipple counter @r{@var{s}}.
Counter @r{@var{s}} is reset to 0 whenever @code{glBegin} is called and
before each line segment of a
-@code{glBegin}(@code{GL_LINES})/@code{glEnd} sequence is generated. It
+@code{glBegin}(@code{GL_LINES})/@code{glEnd} sequence is generated. It
is incremented after each fragment of a unit width aliased line segment
is generated or after each @r{@var{i}} fragments of an @r{@var{i}} width
-line segment are generated. The @r{@var{i}} fragments associated with
+line segment are generated. The @r{@var{i}} fragments associated with
count @r{@var{s}} are masked out if
@var{pattern} bit @r{(@var{s}/@var{factor},)%16}
-is 0, otherwise these fragments are sent to the frame buffer. Bit zero
+is 0, otherwise these fragments are sent to the frame buffer. Bit zero
of @var{pattern} is the least significant bit.
Antialiased lines are treated as a sequence of @r{1×@var{width}}
-rectangles for purposes of stippling. Whether rectangle @r{@var{s}} is
+rectangles for purposes of stippling. Whether rectangle @r{@var{s}} is
rasterized or not depends on the fragment rule described for aliased
lines, counting rectangles rather than groups of fragments.
To enable and disable line stippling, call @code{glEnable} and
-@code{glDisable} with argument @code{GL_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.
+@code{glDisable} with argument @code{GL_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.
@code{GL_INVALID_OPERATION} is generated if @code{glLineStipple} is
executed between the execution of @code{glBegin} and the corresponding
@table @asis
@item @var{width}
-Specifies the width of rasterized lines. The initial value is 1.
+Specifies the width of rasterized lines. The initial value is 1.
@end table
@code{glLineWidth} 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
+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 @code{glEnable} and @code{glDisable}
-with argument @code{GL_LINE_SMOOTH}. Line antialiasing is initially
+with argument @code{GL_LINE_SMOOTH}. Line antialiasing is initially
disabled.
If line antialiasing is disabled, the actual width is determined by
-rounding the supplied width to the nearest integer. (If the rounding
+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
@r{∣Δ@var{x},∣>=∣Δ@var{y},∣}, @var{i} pixels are filled in each column
that is rasterized, where @var{i} is the rounded value of @var{width}.
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
+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.
+square. This value is saved and used in the final rasterization step.
-Not all widths can be supported when line antialiasing is enabled. If
-an unsupported width is requested, the nearest supported width is used.
+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
+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 @code{glGet} with
arguments @code{GL_ALIASED_LINE_WIDTH_RANGE},
@code{GL_SMOOTH_LINE_WIDTH_RANGE}, and
@end table
@code{glLinkProgram} links the program object specified by
-@var{program}. If any shader objects of type @code{GL_VERTEX_SHADER}
-are attached to @var{program}, they will be used to create an executable
-that will run on the programmable vertex processor. If any shader
+@var{program}. If any shader objects of type @code{GL_VERTEX_SHADER} are
+attached to @var{program}, they will be used to create an executable
+that will run on the programmable vertex processor. If any shader
objects of type @code{GL_FRAGMENT_SHADER} are attached to @var{program},
they will be used to create an executable that will run on the
programmable fragment processor.
The status of the link operation will be stored as part of the program
-object's state. This value will be set to @code{GL_TRUE} if the program
+object's state. This value will be set to @code{GL_TRUE} if the program
object was linked without errors and is ready for use, and
-@code{GL_FALSE} otherwise. It can be queried by calling
+@code{GL_FALSE} otherwise. It can be queried by calling
@code{glGetProgram} with arguments @var{program} and
@code{GL_LINK_STATUS}.
uniform variables belonging to @var{program} will be initialized to 0,
and each of the program object's active uniform variables will be
assigned a location that can be queried by calling
-@code{glGetUniformLocation}. Also, any active user-defined attribute
+@code{glGetUniformLocation}. Also, any active user-defined attribute
variables that have not been bound to a generic vertex attribute index
will be bound to one at this time.
Linking of a program object can fail for a number of reasons as
-specified in the @var{OpenGL Shading Language Specification}. The
+specified in the @var{OpenGL Shading Language Specification}. The
following lists some of the conditions that will cause a link error.
@itemize
When a program object has been successfully linked, the program object
can be made part of current state by calling @code{glUseProgram}.
Whether or not the link operation was successful, the program object's
-information log will be overwritten. The information log can be
+information log will be overwritten. The information log can be
retrieved by calling @code{glGetProgramInfoLog}.
@code{glLinkProgram} will also install the generated executables as part
of the current rendering state if the link operation was successful and
the specified program object is already currently in use as a result of
-a previous call to @code{glUseProgram}. If the program object currently
+a previous call to @code{glUseProgram}. If the program object currently
in use is relinked unsuccessfully, its link status will be set to
@code{GL_FALSE} , but the executables and associated state will remain
part of the current state until a subsequent call to @code{glUseProgram}
-removes it from use. After it is removed from use, it cannot be made
+removes it from use. After it is removed from use, it cannot be made
part of current state until it has been successfully relinked.
If @var{program} contains shader objects of type @code{GL_VERTEX_SHADER}
but does not contain shader objects of type @code{GL_FRAGMENT_SHADER},
the vertex shader will be linked against the implicit interface for
-fixed functionality fragment processing. Similarly, if @var{program}
+fixed functionality fragment processing. Similarly, if @var{program}
contains shader objects of type @code{GL_FRAGMENT_SHADER} but it does
not contain shader objects of type @code{GL_VERTEX_SHADER}, the fragment
shader will be linked against the implicit interface for fixed
functionality vertex processing.
The program object's information log is updated and the program is
-generated at the time of the link operation. After the link operation,
+generated at the time of the link operation. After the link operation,
applications are free to modify attached shader objects, compile
attached shader objects, detach shader objects, delete shader objects,
-and attach additional shader objects. None of these operations affects
+and attach additional shader objects. None of these operations affects
the information log or the program that is part of the program object.
@code{GL_INVALID_VALUE} is generated if @var{program} is not a value
@table @asis
@item @var{base}
Specifies an integer offset that will be added to @code{glCallLists}
-offsets to generate display-list names. The initial value is 0.
+offsets to generate display-list names. The initial value is 0.
@end table
-@code{glCallLists} specifies an array of offsets. Display-list names
-are generated by adding @var{base} to each offset. Names that reference
+@code{glCallLists} specifies an array of offsets. Display-list names are
+generated by adding @var{base} to each offset. Names that reference
valid display lists are executed; the others are ignored.
@code{GL_INVALID_OPERATION} is generated if @code{glListBase} is
Replace the current matrix with the identity matrix.
@code{glLoadIdentity} replaces the current matrix with the identity
-matrix. It is semantically equivalent to calling @code{glLoadMatrix}
+matrix. It is semantically equivalent to calling @code{glLoadMatrix}
with the identity matrix
@end table
@code{glLoadMatrix} replaces the current matrix with the one whose
-elements are specified by @var{m}. The current matrix is the projection
+elements are specified by @var{m}. The current matrix is the projection
matrix, modelview matrix, or texture matrix, depending on the current
matrix mode (see @code{glMatrixMode}).
-The current matrix, M, defines a transformation of coordinates. For
-instance, assume M refers to the modelview matrix. If
+The current matrix, M, defines a transformation of coordinates. For
+instance, assume M refers to the modelview matrix. If
@r{@var{v}=(@var{v}[0,],@var{v}[1,]@var{v}[2,]@var{v}[3,])} is the
set of object coordinates of a vertex, and @var{m} points to an array of
@r{16} single- or double-precision floating-point values
@end table
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
+commands to be uniquely identified. It consists of an ordered set of
unsigned integers and is initially empty.
@code{glLoadName} causes @var{name} to replace the value on the top of
the name stack.
The name stack is always empty while the render mode is not
-@code{GL_SELECT}. Calls to @code{glLoadName} while the render mode is
+@code{GL_SELECT}. Calls to @code{glLoadName} while the render mode is
not @code{GL_SELECT} are ignored.
@code{GL_INVALID_OPERATION} is generated if @code{glLoadName} is called
@end table
@code{glLoadTransposeMatrix} replaces the current matrix with the one
-whose elements are specified by @var{m}. The current matrix is the
+whose elements are specified by @var{m}. The current matrix is the
projection matrix, modelview matrix, or texture matrix, depending on the
current matrix mode (see @code{glMatrixMode}).
-The current matrix, M, defines a transformation of coordinates. For
-instance, assume M refers to the modelview matrix. If
+The current matrix, M, defines a transformation of coordinates. For
+instance, assume M refers to the modelview matrix. If
@r{@var{v}=(@var{v}[0,],@var{v}[1,]@var{v}[2,]@var{v}[3,])} is the
set of object coordinates of a vertex, and @var{m} points to an array of
@r{16} single- or double-precision floating-point values
@table @asis
@item @var{opcode}
-Specifies a symbolic constant that selects a logical operation. The
+Specifies a symbolic constant that selects a logical operation. The
following symbols are accepted: @code{GL_CLEAR}, @code{GL_SET},
@code{GL_COPY}, @code{GL_COPY_INVERTED}, @code{GL_NOOP},
@code{GL_INVERT}, @code{GL_AND}, @code{GL_NAND}, @code{GL_OR},
index or RGBA color at the corresponding location in the frame buffer.
To enable or disable the logical operation, call @code{glEnable} and
@code{glDisable} using the symbolic constant @code{GL_COLOR_LOGIC_OP}
-for RGBA mode or @code{GL_INDEX_LOGIC_OP} for color index mode. The
+for RGBA mode or @code{GL_INDEX_LOGIC_OP} for color index mode. The
initial value is disabled for both operations.
@end table
-@var{opcode} is a symbolic constant chosen from the list above. In the
+@var{opcode} is a symbolic constant chosen from the list above. In the
explanation of the logical operations, @var{s} represents the incoming
color index and @var{d} represents the index in the frame buffer.
-Standard C-language operators are used. As these bitwise operators
+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.
@item @var{stride}
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 @var{points}. 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.
+referenced in @var{points}. 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.
@item @var{order}
-Specifies the number of control points. Must be positive.
+Specifies the number of control points. Must be positive.
@item @var{points}
Specifies a pointer to the array of control points.
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
+using evaluators. These include almost all splines used in computer
graphics: B-splines, Bezier curves, Hermite splines, and so on.
-Evaluators define curves based on Bernstein polynomials. Define
+Evaluators define curves based on Bernstein polynomials. Define
@r{@var{p}(@var{u}^,)} as
@r{@var{p}(@var{u}^,)=Σ@var{i}=0@var{n}@var{B}_@var{i},^@var{n}(@var{u}^,)@var{R}_@var{i}}
@r{0^0==1} and @r{((@var{n}), (0),,)==1}
@code{glMap1} 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
+values are produced. Once defined, a map can be enabled and disabled by
calling @code{glEnable} and @code{glDisable} with the map name, one of
the nine predefined values for @var{target} described below.
@code{glEvalCoord1} evaluates the one-dimensional maps that are enabled.
@var{target} is a symbolic constant that indicates what kind of control
points are provided in @var{points}, and what output is generated when
-the map is evaluated. It can assume one of nine predefined values:
+the map is evaluated. It can assume one of nine predefined values:
@table @asis
@item @code{GL_MAP1_VERTEX_3}
Each control point is three floating-point values representing
-@r{@var{x}}, @r{@var{y}}, and @r{@var{z}}. Internal @code{glVertex3}
+@r{@var{x}}, @r{@var{y}}, and @r{@var{z}}. Internal @code{glVertex3}
commands are generated when the map is evaluated.
@item @code{GL_MAP1_VERTEX_4}
Each control point is four floating-point values representing
-@r{@var{x}}, @r{@var{y}}, @r{@var{z}}, and @r{@var{w}}. Internal
+@r{@var{x}}, @r{@var{y}}, @r{@var{z}}, and @r{@var{w}}. Internal
@code{glVertex4} commands are generated when the map is evaluated.
@item @code{GL_MAP1_INDEX}
Each control point is a single floating-point value representing a color
-index. Internal @code{glIndex} commands are generated when the map is
+index. Internal @code{glIndex} commands are generated when the map is
evaluated but the current index is not updated with the value of these
@code{glIndex} commands.
@item @code{GL_MAP1_COLOR_4}
Each control point is four floating-point values representing red,
-green, blue, and alpha. Internal @code{glColor4} commands are generated
+green, blue, and alpha. Internal @code{glColor4} commands are generated
when the map is evaluated but the current color is not updated with the
value of these @code{glColor4} commands.
@item @code{GL_MAP1_TEXTURE_COORD_1}
Each control point is a single floating-point value representing the
-@r{@var{s}} texture coordinate. Internal @code{glTexCoord1} commands
-are generated when the map is evaluated but the current texture
-coordinates are not updated with the value of these @code{glTexCoord}
-commands.
+@r{@var{s}} texture coordinate. Internal @code{glTexCoord1} commands are
+generated when the map is evaluated but the current texture coordinates
+are not updated with the value of these @code{glTexCoord} commands.
@item @code{GL_MAP1_TEXTURE_COORD_2}
Each control point is two floating-point values representing the
-@r{@var{s}} and @r{@var{t}} texture coordinates. Internal
+@r{@var{s}} and @r{@var{t}} texture coordinates. Internal
@code{glTexCoord2} commands are generated when the map is evaluated but
the current texture coordinates are not updated with the value of these
@code{glTexCoord} commands.
@item @code{GL_MAP1_TEXTURE_COORD_3}
Each control point is three floating-point values representing the
-@r{@var{s}}, @r{@var{t}}, and @r{@var{r}} texture coordinates. Internal
+@r{@var{s}}, @r{@var{t}}, and @r{@var{r}} texture coordinates. Internal
@code{glTexCoord3} commands are generated when the map is evaluated but
the current texture coordinates are not updated with the value of these
@code{glTexCoord} commands.
@item @code{GL_MAP1_TEXTURE_COORD_4}
Each control point is four floating-point values representing the
@r{@var{s}}, @r{@var{t}}, @r{@var{r}}, and @r{@var{q}} texture
-coordinates. Internal @code{glTexCoord4} commands are generated when
-the map is evaluated but the current texture coordinates are not updated
+coordinates. Internal @code{glTexCoord4} commands are generated when the
+map is evaluated but the current texture coordinates are not updated
with the value of these @code{glTexCoord} commands.
@end table
@var{stride}, @var{order}, and @var{points} define the array addressing
-for accessing the control points. @var{points} is the location of the
+for accessing the control points. @var{points} 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. @var{order}
-is the number of control points in the array. @var{stride} specifies
-how many float or double locations to advance the internal memory
-pointer to reach the next control point.
+memory locations, depending on which map is being defined. @var{order}
+is the number of control points in the array. @var{stride} specifies how
+many float or double locations to advance the internal memory pointer to
+reach the next control point.
@code{GL_INVALID_ENUM} is generated if @var{target} is not an accepted
value.
@itemx @var{u2}
Specify a linear mapping of @r{@var{u}}, as presented to
@code{glEvalCoord2}, to @r{@var{u}^}, one of the two variables that are
-evaluated by the equations specified by this command. Initially,
+evaluated by the equations specified by this command. Initially,
@var{u1} is 0 and @var{u2} is 1.
@item @var{ustride}
the @r{@var{u}} and @r{@var{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
+must occupy contiguous memory locations. The initial value of
@var{ustride} is 0.
@item @var{uorder}
Specifies the dimension of the control point array in the @r{@var{u}}
-axis. Must be positive. The initial value is 1.
+axis. Must be positive. The initial value is 1.
@item @var{v1}
@itemx @var{v2}
Specify a linear mapping of @r{@var{v}}, as presented to
@code{glEvalCoord2}, to @r{@var{v}^}, one of the two variables that are
-evaluated by the equations specified by this command. Initially,
+evaluated by the equations specified by this command. Initially,
@var{v1} is 0 and @var{v2} is 1.
@item @var{vstride}
the @r{@var{u}} and @r{@var{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
+must occupy contiguous memory locations. The initial value of
@var{vstride} is 0.
@item @var{vorder}
Specifies the dimension of the control point array in the @r{@var{v}}
-axis. Must be positive. The initial value is 1.
+axis. Must be positive. The initial value is 1.
@item @var{points}
Specifies a pointer to the array of control points.
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
+using evaluators. These include almost all surfaces used in computer
graphics, including B-spline surfaces, NURBS surfaces, Bezier surfaces,
and so on.
Recall that @r{0^0==1} and @r{((@var{n}), (0),,)==1}
@code{glMap2} 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
+values are produced. Once defined, a map can be enabled and disabled by
calling @code{glEnable} and @code{glDisable} with the map name, one of
-the nine predefined values for @var{target}, described below. When
+the nine predefined values for @var{target}, described below. When
@code{glEvalCoord2} presents values @r{@var{u}} and @r{@var{v}}, the
bivariate Bernstein polynomials are evaluated using @r{@var{u}^} and
@r{@var{v}^}, where
@var{target} is a symbolic constant that indicates what kind of control
points are provided in @var{points}, and what output is generated when
-the map is evaluated. It can assume one of nine predefined values:
+the map is evaluated. It can assume one of nine predefined values:
@table @asis
@item @code{GL_MAP2_VERTEX_3}
Each control point is three floating-point values representing
-@r{@var{x}}, @r{@var{y}}, and @r{@var{z}}. Internal @code{glVertex3}
+@r{@var{x}}, @r{@var{y}}, and @r{@var{z}}. Internal @code{glVertex3}
commands are generated when the map is evaluated.
@item @code{GL_MAP2_VERTEX_4}
Each control point is four floating-point values representing
-@r{@var{x}}, @r{@var{y}}, @r{@var{z}}, and @r{@var{w}}. Internal
+@r{@var{x}}, @r{@var{y}}, @r{@var{z}}, and @r{@var{w}}. Internal
@code{glVertex4} commands are generated when the map is evaluated.
@item @code{GL_MAP2_INDEX}
Each control point is a single floating-point value representing a color
-index. Internal @code{glIndex} commands are generated when the map is
+index. Internal @code{glIndex} commands are generated when the map is
evaluated but the current index is not updated with the value of these
@code{glIndex} commands.
@item @code{GL_MAP2_COLOR_4}
Each control point is four floating-point values representing red,
-green, blue, and alpha. Internal @code{glColor4} commands are generated
+green, blue, and alpha. Internal @code{glColor4} commands are generated
when the map is evaluated but the current color is not updated with the
value of these @code{glColor4} commands.
@item @code{GL_MAP2_TEXTURE_COORD_1}
Each control point is a single floating-point value representing the
-@r{@var{s}} texture coordinate. Internal @code{glTexCoord1} commands
-are generated when the map is evaluated but the current texture
-coordinates are not updated with the value of these @code{glTexCoord}
-commands.
+@r{@var{s}} texture coordinate. Internal @code{glTexCoord1} commands are
+generated when the map is evaluated but the current texture coordinates
+are not updated with the value of these @code{glTexCoord} commands.
@item @code{GL_MAP2_TEXTURE_COORD_2}
Each control point is two floating-point values representing the
-@r{@var{s}} and @r{@var{t}} texture coordinates. Internal
+@r{@var{s}} and @r{@var{t}} texture coordinates. Internal
@code{glTexCoord2} commands are generated when the map is evaluated but
the current texture coordinates are not updated with the value of these
@code{glTexCoord} commands.
@item @code{GL_MAP2_TEXTURE_COORD_3}
Each control point is three floating-point values representing the
-@r{@var{s}}, @r{@var{t}}, and @r{@var{r}} texture coordinates. Internal
+@r{@var{s}}, @r{@var{t}}, and @r{@var{r}} texture coordinates. Internal
@code{glTexCoord3} commands are generated when the map is evaluated but
the current texture coordinates are not updated with the value of these
@code{glTexCoord} commands.
@item @code{GL_MAP2_TEXTURE_COORD_4}
Each control point is four floating-point values representing the
@r{@var{s}}, @r{@var{t}}, @r{@var{r}}, and @r{@var{q}} texture
-coordinates. Internal @code{glTexCoord4} commands are generated when
-the map is evaluated but the current texture coordinates are not updated
+coordinates. Internal @code{glTexCoord4} commands are generated when the
+map is evaluated but the current texture coordinates are not updated
with the value of these @code{glTexCoord} commands.
@end table
@var{ustride}, @var{uorder}, @var{vstride}, @var{vorder}, and
@var{points} define the array addressing for accessing the control
-points. @var{points} is the location of the first control point, which
+points. @var{points} 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 @r{@var{uorder}×@var{vorder}}
-control points in the array. @var{ustride} specifies how many float or
+on which map is being defined. There are @r{@var{uorder}×@var{vorder}}
+control points in the array. @var{ustride} specifies how many float or
double locations are skipped to advance the internal memory pointer from
control point @r{@var{R}_@var{i}@var{j},} to control point
-@r{@var{R}_(@var{i}+1,)@var{j},}. @var{vstride} specifies how many
+@r{@var{R}_(@var{i}+1,)@var{j},}. @var{vstride} specifies how many
float or double locations are skipped to advance the internal memory
pointer from control point @r{@var{R}_@var{i}@var{j},} to control point
@r{@var{R}_@var{i}(@var{j}+1,),}.
@table @asis
@item @var{target}
-Specifies the target buffer object being mapped. The symbolic constant
+Specifies the target buffer object being mapped. The symbolic constant
must be @code{GL_ARRAY_BUFFER}, @code{GL_ELEMENT_ARRAY_BUFFER},
@code{GL_PIXEL_PACK_BUFFER}, or @code{GL_PIXEL_UNPACK_BUFFER}.
@item @var{access}
Specifies the access policy, indicating whether it will be possible to
read from, write to, or both read from and write to the buffer object's
-mapped data store. The symbolic constant must be @code{GL_READ_ONLY},
+mapped data store. The symbolic constant must be @code{GL_READ_ONLY},
@code{GL_WRITE_ONLY}, or @code{GL_READ_WRITE}.
@end table
@code{glMapBuffer} maps to the client's address space the entire data
-store of the buffer object currently bound to @var{target}. The data
-can then be directly read and/or written relative to the returned
-pointer, depending on the specified @var{access} policy. If the GL is
-unable to map the buffer object's data store, @code{glMapBuffer}
-generates an error and returns @code{NULL}. This may occur for
-system-specific reasons, such as low virtual memory availability.
+store of the buffer object currently bound to @var{target}. The data can
+then be directly read and/or written relative to the returned pointer,
+depending on the specified @var{access} policy. If the GL is unable to
+map the buffer object's data store, @code{glMapBuffer} generates an
+error and returns @code{NULL}. This may occur for system-specific
+reasons, such as low virtual memory availability.
If a mapped data store is accessed in a way inconsistent with the
specified @var{access} policy, no error is generated, but performance
may be negatively impacted and system errors, including program
-termination, may result. Unlike the @var{usage} parameter of
+termination, may result. Unlike the @var{usage} parameter of
@code{glBufferData}, @var{access} is not a hint, and does in fact
constrain the usage of the mapped data store on some GL implementations.
In order to achieve the highest performance available, a buffer object's
@var{usage} and @var{access} parameters.
A mapped data store must be unmapped with @code{glUnmapBuffer} before
-its buffer object is used. Otherwise an error will be generated by any
+its buffer object is used. Otherwise an error will be generated by any
GL command that attempts to dereference the buffer object's data store.
When a data store is unmapped, the pointer to its data store becomes
-invalid. @code{glUnmapBuffer} returns @code{GL_TRUE} unless the data
+invalid. @code{glUnmapBuffer} returns @code{GL_TRUE} unless the data
store contents have become corrupt during the time the data store was
-mapped. This can occur for system-specific reasons that affect the
-availability of graphics memory, such as screen mode changes. In such
+mapped. This can occur for system-specific reasons that affect the
+availability of graphics memory, such as screen mode changes. In such
situations, @code{GL_FALSE} is returned and the data store contents are
-undefined. An application must detect this rare condition and
+undefined. An application must detect this rare condition and
reinitialize the data store.
A buffer object's mapped data store is automatically unmapped when the
@code{GL_READ_ONLY}, @code{GL_WRITE_ONLY}, or @code{GL_READ_WRITE}.
@code{GL_OUT_OF_MEMORY} is generated when @code{glMapBuffer} is executed
-if the GL is unable to map the buffer object's data store. This may
+if the GL is unable to map the buffer object's data store. This may
occur for a variety of system-specific reasons, such as the absence of
sufficient remaining virtual memory.
@table @asis
@item @var{un}
Specifies the number of partitions in the grid range interval [@var{u1},
-@var{u2}]. Must be positive.
+@var{u2}]. Must be positive.
@item @var{u1}
@itemx @var{u2}
@code{glMapGrid1} and @code{glMapGrid2} specify the linear grid mappings
between the @r{@var{i}} (or @r{@var{i}} and @r{@var{j}}) integer grid
coordinates, to the @r{@var{u}} (or @r{@var{u}} and @r{@var{v}})
-floating-point evaluation map coordinates. See @code{glMap1} and
+floating-point evaluation map coordinates. See @code{glMap1} and
@code{glMap2} for details of how @r{@var{u}} and @r{@var{v}} coordinates
are evaluated.
@code{glMapGrid1} specifies a single linear mapping such that integer
grid coordinate 0 maps exactly to @var{u1}, and integer grid coordinate
-@var{un} maps exactly to @var{u2}. All other integer grid coordinates
+@var{un} maps exactly to @var{u2}. All other integer grid coordinates
@r{@var{i}} are mapped so that
@r{@var{u}=@var{i}(@var{u2}-@var{u1},)/@var{un}+@var{u1}}
-@code{glMapGrid2} specifies two such linear mappings. One maps integer
+@code{glMapGrid2} specifies two such linear mappings. One maps integer
grid coordinate @r{@var{i}=0} exactly to @var{u1}, and integer grid
-coordinate @r{@var{i}=@var{un}} exactly to @var{u2}. The other maps
+coordinate @r{@var{i}=@var{un}} exactly to @var{u2}. The other maps
integer grid coordinate @r{@var{j}=0} exactly to @var{v1}, and integer
-grid coordinate @r{@var{j}=@var{vn}} exactly to @var{v2}. Other integer
+grid coordinate @r{@var{j}=@var{vn}} exactly to @var{v2}. Other integer
grid coordinates @r{@var{i}} and @r{@var{j}} are mapped such that
@r{@var{u}=@var{i}(@var{u2}-@var{u1},)/@var{un}+@var{u1}}
@table @asis
@item @var{face}
-Specifies which face or faces are being updated. Must be one of
+Specifies which face or faces are being updated. Must be one of
@code{GL_FRONT}, @code{GL_BACK}, or @code{GL_FRONT_AND_BACK}.
@item @var{pname}
Specifies the single-valued material parameter of the face or faces that
-is being updated. Must be @code{GL_SHININESS}.
+is being updated. Must be @code{GL_SHININESS}.
@item @var{param}
Specifies the value that parameter @code{GL_SHININESS} will be set to.
@end table
-@code{glMaterial} assigns values to material parameters. There are two
-matched sets of material parameters. One, the @var{front-facing} 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, @var{back-facing}, is
-used to shade back-facing polygons only when two-sided lighting is
-enabled. Refer to the @code{glLightModel} reference page for details
-concerning one- and two-sided lighting calculations.
+@code{glMaterial} assigns values to material parameters. There are two
+matched sets of material parameters. One, the @var{front-facing} 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, @var{back-facing}, is used to shade
+back-facing polygons only when two-sided lighting is enabled. Refer to
+the @code{glLightModel} reference page for details concerning one- and
+two-sided lighting calculations.
-@code{glMaterial} takes three arguments. The first, @var{face},
+@code{glMaterial} takes three arguments. The first, @var{face},
specifies whether the @code{GL_FRONT} materials, the @code{GL_BACK}
materials, or both @code{GL_FRONT_AND_BACK} materials will be modified.
The second, @var{pname}, specifies which of several parameters in one or
-both sets will be modified. The third, @var{params}, specifies what
+both sets will be modified. The third, @var{params}, specifies what
value or values will be assigned to the specified parameter.
Material parameters are used in the lighting equation that is optionally
-applied to each vertex. The equation is discussed in the
-@code{glLightModel} reference page. The parameters that can be
-specified using @code{glMaterial}, and their interpretations by the
-lighting equation, are as follows:
+applied to each vertex. The equation is discussed in the
+@code{glLightModel} reference page. The parameters that can be specified
+using @code{glMaterial}, and their interpretations by the lighting
+equation, are as follows:
@table @asis
@item @code{GL_AMBIENT}
@var{params} contains four integer or floating-point values that specify
-the ambient RGBA reflectance of the material. Integer values are mapped
+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 @r{-1.0}.
-Floating-point values are mapped directly. Neither integer nor
-floating-point values are clamped. The initial ambient reflectance for
+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).
@item @code{GL_DIFFUSE}
@var{params} contains four integer or floating-point values that specify
-the diffuse RGBA reflectance of the material. Integer values are mapped
+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 @r{-1.0}.
-Floating-point values are mapped directly. Neither integer nor
-floating-point values are clamped. The initial diffuse reflectance for
+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).
@item @code{GL_SPECULAR}
@var{params} 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 @r{-1.0}.
-Floating-point values are mapped directly. Neither integer nor
-floating-point values are clamped. The initial specular reflectance for
+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 @r{-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).
@item @code{GL_EMISSION}
@var{params} contains four integer or floating-point values that specify
-the RGBA emitted light intensity of the material. Integer values are
+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 @r{-1.0}.
-Floating-point values are mapped directly. Neither integer nor
-floating-point values are clamped. The initial emission intensity for
+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).
@item @code{GL_SHININESS}
@var{params} 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 @r{[0,128]} are
-accepted. The initial specular exponent for both front- and back-facing
+the RGBA specular exponent of the material. Integer and floating-point
+values are mapped directly. Only values in the range @r{[0,128]} are
+accepted. The initial specular exponent for both front- and back-facing
materials is 0.
@item @code{GL_AMBIENT_AND_DIFFUSE}
@item @code{GL_COLOR_INDEXES}
@var{params} contains three integer or floating-point values specifying
-the color indices for ambient, diffuse, and specular lighting. These
+the color indices for ambient, diffuse, and specular lighting. These
three values, and @code{GL_SHININESS}, are the only material values used
-by the color index mode lighting equation. Refer to the
+by the color index mode lighting equation. Refer to the
@code{glLightModel} reference page for a discussion of color index
lighting.
@table @asis
@item @var{mode}
Specifies which matrix stack is the target for subsequent matrix
-operations. Three values are accepted: @code{GL_MODELVIEW},
-@code{GL_PROJECTION}, and @code{GL_TEXTURE}. The initial value is
-@code{GL_MODELVIEW}. Additionally, if the @code{ARB_imaging} extension
+operations. Three values are accepted: @code{GL_MODELVIEW},
+@code{GL_PROJECTION}, and @code{GL_TEXTURE}. The initial value is
+@code{GL_MODELVIEW}. Additionally, if the @code{ARB_imaging} extension
is supported, @code{GL_COLOR} is also accepted.
@end table
-@code{glMatrixMode} sets the current matrix mode. @var{mode} can assume
+@code{glMatrixMode} sets the current matrix mode. @var{mode} can assume
one of four values:
@table @asis
@end table
To find out which matrix stack is currently the target of all matrix
-operations, call @code{glGet} with argument @code{GL_MATRIX_MODE}. The
+operations, call @code{glGet} with argument @code{GL_MATRIX_MODE}. The
initial value is @code{GL_MODELVIEW}.
@code{GL_INVALID_ENUM} is generated if @var{mode} is not an accepted
@table @asis
@item @var{target}
-The minmax table whose parameters are to be set. Must be
+The minmax table whose parameters are to be set. Must be
@code{GL_MINMAX}.
@item @var{internalformat}
-The format of entries in the minmax table. Must be one of
+The format of entries in the minmax table. Must be one of
@code{GL_ALPHA}, @code{GL_ALPHA4}, @code{GL_ALPHA8}, @code{GL_ALPHA12},
@code{GL_ALPHA16}, @code{GL_LUMINANCE}, @code{GL_LUMINANCE4},
@code{GL_LUMINANCE8}, @code{GL_LUMINANCE12}, @code{GL_LUMINANCE16},
@item @var{sink}
If @code{GL_TRUE}, pixels will be consumed by the minmax process and no
-drawing or texture loading will take place. If @code{GL_FALSE}, pixels
+drawing or texture loading will take place. If @code{GL_FALSE}, pixels
will proceed to the final conversion process after minmax.
@end table
When @code{GL_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 two-element minmax table. (The first element stores
+are stored in the two-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
+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
+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 @code{glGetMinmax}. The minmax
+retrieved at a later time by calling @code{glGetMinmax}. The minmax
operation is enabled or disabled by calling @code{glEnable} or
@code{glDisable}, respectively, with an argument of @code{GL_MINMAX}.
@code{glMinmax} redefines the current minmax table to have entries of
-the format specified by @var{internalformat}. The maximum element is
+the format specified by @var{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 @var{sink} is
+element is initialized with the largest possible component values. The
+values in the previous minmax table, if any, are lost. If @var{sink} is
@code{GL_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.
@table @asis
@item @var{mode}
-Specifies what kind of primitives to render. Symbolic constants
+Specifies what kind of primitives to render. Symbolic constants
@code{GL_POINTS}, @code{GL_LINE_STRIP}, @code{GL_LINE_LOOP},
@code{GL_LINES}, @code{GL_TRIANGLE_STRIP}, @code{GL_TRIANGLE_FAN},
@code{GL_TRIANGLES}, @code{GL_QUAD_STRIP}, @code{GL_QUADS}, and
@end table
@code{glMultiDrawArrays} specifies multiple sets of geometric primitives
-with very few subroutine calls. Instead of calling a GL procedure to
+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
When @code{glMultiDrawArrays} is called, it uses @var{count} sequential
elements from each enabled array to construct a sequence of geometric
-primitives, beginning with element @var{first}. @var{mode} specifies
+primitives, beginning with element @var{first}. @var{mode} specifies
what kind of primitives are constructed, and how the array elements
-construct those primitives. If @code{GL_VERTEX_ARRAY} is not enabled,
-no geometric primitives are generated.
+construct those primitives. If @code{GL_VERTEX_ARRAY} is not enabled, no
+geometric primitives are generated.
Vertex attributes that are modified by @code{glMultiDrawArrays} have an
-unspecified value after @code{glMultiDrawArrays} returns. For example,
+unspecified value after @code{glMultiDrawArrays} returns. For example,
if @code{GL_COLOR_ARRAY} is enabled, the value of the current color is
-undefined after @code{glMultiDrawArrays} executes. Attributes that
+undefined after @code{glMultiDrawArrays} executes. Attributes that
aren't modified remain well defined.
@code{GL_INVALID_ENUM} is generated if @var{mode} is not an accepted
@table @asis
@item @var{mode}
-Specifies what kind of primitives to render. Symbolic constants
+Specifies what kind of primitives to render. Symbolic constants
@code{GL_POINTS}, @code{GL_LINE_STRIP}, @code{GL_LINE_LOOP},
@code{GL_LINES}, @code{GL_TRIANGLE_STRIP}, @code{GL_TRIANGLE_FAN},
@code{GL_TRIANGLES}, @code{GL_QUAD_STRIP}, @code{GL_QUADS}, and
Points to an array of the elements counts.
@item @var{type}
-Specifies the type of the values in @var{indices}. Must be one of
+Specifies the type of the values in @var{indices}. Must be one of
@code{GL_UNSIGNED_BYTE}, @code{GL_UNSIGNED_SHORT}, or
@code{GL_UNSIGNED_INT}.
@end table
@code{glMultiDrawElements} specifies multiple sets of geometric
-primitives with very few subroutine calls. Instead of calling a GL
+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
elements are specified.
Vertex attributes that are modified by @code{glMultiDrawElements} have
-an unspecified value after @code{glMultiDrawElements} returns. For
+an unspecified value after @code{glMultiDrawElements} returns. For
example, if @code{GL_COLOR_ARRAY} is enabled, the value of the current
-color is undefined after @code{glMultiDrawElements} executes. Attributes
+color is undefined after @code{glMultiDrawElements} executes. Attributes
that aren't modified maintain their previous values.
@code{GL_INVALID_ENUM} is generated if @var{mode} is not an accepted
@table @asis
@item @var{target}
-Specifies the texture unit whose coordinates should be modified. The
+Specifies the texture unit whose coordinates should be modified. The
number of texture units is implementation dependent, but must be at
-least two. Symbolic constant must be one of
+least two. Symbolic constant must be one of
@code{GL_TEXTURE}@r{@var{i}}, where i ranges from 0 to
@code{GL_MAX_TEXTURE_COORDS} - 1, which is an implementation-dependent
value.
@itemx @var{r}
@itemx @var{q}
Specify @var{s}, @var{t}, @var{r}, and @var{q} texture coordinates for
-@var{target} texture unit. Not all parameters are present in all forms
+@var{target} texture unit. Not all parameters are present in all forms
of the command.
@end table
@code{glMultiTexCoord} specifies texture coordinates in one, two, three,
-or four dimensions. @code{glMultiTexCoord1} sets the current texture
+or four dimensions. @code{glMultiTexCoord1} sets the current texture
coordinates to @r{(@var{s},001)}; a call to @code{glMultiTexCoord2} sets
-them to @r{(@var{s},@var{t}01)}. Similarly, @code{glMultiTexCoord3}
+them to @r{(@var{s},@var{t}01)}. Similarly, @code{glMultiTexCoord3}
specifies the texture coordinates as @r{(@var{s},@var{t}@var{r}1)}, and
@code{glMultiTexCoord4} defines all four components explicitly as
@r{(@var{s},@var{t}@var{r}@var{q})}.
The current texture coordinates are part of the data that is associated
-with each vertex and with the current raster position. Initially, the
+with each vertex and with the current raster position. Initially, the
values for @r{(@var{s},@var{t}@var{r}@var{q})} are @r{(0,001)}.
using @var{m}, and replaces the current matrix with the product.
The current matrix is determined by the current matrix mode (see
-@code{glMatrixMode}). It is either the projection matrix, modelview
+@code{glMatrixMode}). It is either the projection matrix, modelview
matrix, or the texture matrix.
@code{GL_INVALID_OPERATION} is generated if @code{glMultMatrix} is
product.
The current matrix is determined by the current matrix mode (see
-@code{glMatrixMode}). It is either the projection matrix, modelview
+@code{glMatrixMode}). It is either the projection matrix, modelview
matrix, or the texture matrix.
@code{GL_INVALID_OPERATION} is generated if @code{glMultTransposeMatrix}
@end table
Display lists are groups of GL commands that have been stored for
-subsequent execution. Display lists are created with @code{glNewList}.
+subsequent execution. Display lists are created with @code{glNewList}.
All subsequent commands are placed in the display list, in the order
issued, until @code{glEndList} is called.
-@code{glNewList} has two arguments. The first argument, @var{list}, is
-a positive integer that becomes the unique name for the display list.
+@code{glNewList} has two arguments. The first argument, @var{list}, is a
+positive integer that becomes the unique name for the display list.
Names can be created and reserved with @code{glGenLists} and tested for
-uniqueness with @code{glIsList}. The second argument, @var{mode}, is a
+uniqueness with @code{glIsList}. The second argument, @var{mode}, is a
symbolic constant that can assume one of two values:
@table @asis
@end table
Certain commands are not compiled into the display list but are executed
-immediately, regardless of the display-list mode. These commands are
+immediately, regardless of the display-list mode. These commands are
@code{glAreTexturesResident}, @code{glColorPointer},
@code{glDeleteLists}, @code{glDeleteTextures},
@code{glDisableClientState}, @code{glEdgeFlagPointer},
When @code{glEndList} is encountered, the display-list definition is
completed by associating the list with the unique name @var{list}
-(specified in the @code{glNewList} command). If a display list with
-name @var{list} already exists, it is replaced only when
-@code{glEndList} is called.
+(specified in the @code{glNewList} command). If a display list with name
+@var{list} already exists, it is replaced only when @code{glEndList} is
+called.
@code{GL_INVALID_VALUE} is generated if @var{list} is 0.
the corresponding execution of @code{glEnd}.
@code{GL_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.)
+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.)
@end deftypefun
@table @asis
@item @var{type}
-Specifies the data type of each coordinate in the array. Symbolic
+Specifies the data type of each coordinate in the array. Symbolic
constants @code{GL_BYTE}, @code{GL_SHORT}, @code{GL_INT},
-@code{GL_FLOAT}, and @code{GL_DOUBLE} are accepted. The initial value
-is @code{GL_FLOAT}.
+@code{GL_FLOAT}, and @code{GL_DOUBLE} are accepted. The initial value is
+@code{GL_FLOAT}.
@item @var{stride}
-Specifies the byte offset between consecutive normals. If @var{stride}
-is 0, the normals are understood to be tightly packed in the array. The
+Specifies the byte offset between consecutive normals. If @var{stride}
+is 0, the normals are understood to be tightly packed in the array. The
initial value is 0.
@item @var{pointer}
Specifies a pointer to the first coordinate of the first normal in the
-array. The initial value is 0.
+array. The initial value is 0.
@end table
@code{glNormalPointer} specifies the location and data format of an
-array of normals to use when rendering. @var{type} specifies the data
+array of normals to use when rendering. @var{type} specifies the data
type of each normal coordinate, and @var{stride} specifies 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.
If a non-zero named buffer object is bound to the @code{GL_ARRAY_BUFFER}
target (see @code{glBindBuffer}) while a normal array is specified,
@var{pointer} is treated as a byte offset into the buffer object's data
-store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
+store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
is saved as normal vertex array client-side state
(@code{GL_NORMAL_ARRAY_BUFFER_BINDING}).
To enable and disable the normal array, call @code{glEnableClientState}
and @code{glDisableClientState} with the argument
-@code{GL_NORMAL_ARRAY}. If enabled, the normal array is used when
+@code{GL_NORMAL_ARRAY}. If enabled, the normal array is used when
@code{glDrawArrays}, @code{glMultiDrawArrays}, @code{glDrawElements},
@code{glMultiDrawElements}, @code{glDrawRangeElements}, or
@code{glArrayElement} is called.
@itemx @var{ny}
@itemx @var{nz}
Specify the @r{@var{x}}, @r{@var{y}}, and @r{@var{z}} coordinates of the
-new current normal. The initial value of the current normal is the unit
+new current normal. The initial value of the current normal is the unit
vector, (0, 0, 1).
@end table
The current normal is set to the given coordinates whenever
-@code{glNormal} is issued. Byte, short, or integer arguments are
+@code{glNormal} 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 @r{-1.0}.
-Normals specified with @code{glNormal} need not have unit length. If
+Normals specified with @code{glNormal} need not have unit length. If
@code{GL_NORMALIZE} is enabled, then normals of any length specified
-with @code{glNormal} are normalized after transformation. If
+with @code{glNormal} are normalized after transformation. If
@code{GL_RESCALE_NORMAL} is enabled, normals are scaled by a scaling
-factor derived from the modelview matrix. @code{GL_RESCALE_NORMAL}
+factor derived from the modelview matrix. @code{GL_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 @code{glEnable} and
+results. To enable and disable normalization, call @code{glEnable} and
@code{glDisable} with either @code{GL_NORMALIZE} or
-@code{GL_RESCALE_NORMAL}. Normalization is initially disabled.
+@code{GL_RESCALE_NORMAL}. Normalization is initially disabled.
@end deftypefun
@end table
@code{glOrtho} describes a transformation that produces a parallel
-projection. The current matrix (see @code{glMatrixMode}) is multiplied
+projection. The current matrix (see @code{glMatrixMode}) is multiplied
by this matrix and the result replaces the current matrix, as if
@code{glMultMatrix} were called with the following matrix as its
argument:
@r{(@var{right},@var{top}-@var{nearVal})} 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). @r{-@var{farVal}} specifies the location of the far clipping plane.
+0). @r{-@var{farVal}} specifies the location of the far clipping plane.
Both @var{nearVal} and @var{farVal} can be either positive or negative.
Use @code{glPushMatrix} and @code{glPopMatrix} to save and restore the
-Feedback is a GL render mode. The mode is selected by calling
-@code{glRenderMode} with @code{GL_FEEDBACK}. When the GL is in feedback
-mode, no pixels are produced by rasterization. Instead, information
+Feedback is a GL render mode. The mode is selected by calling
+@code{glRenderMode} with @code{GL_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 @code{glFeedbackBuffer} reference
-page for a description of the feedback buffer and the values in it.
+application using the GL. See the @code{glFeedbackBuffer} reference page
+for a description of the feedback buffer and the values in it.
@code{glPassThrough} inserts a user-defined marker in the feedback
-buffer when it is executed in feedback mode. @var{token} is returned as
+buffer when it is executed in feedback mode. @var{token} is returned as
if it were a primitive; it is indicated with its own unique identifying
-value: @code{GL_PASS_THROUGH_TOKEN}. The order of @code{glPassThrough}
+value: @code{GL_PASS_THROUGH_TOKEN}. The order of @code{glPassThrough}
commands with respect to the specification of graphics primitives is
maintained.
@table @asis
@item @var{map}
-Specifies a symbolic map name. Must be one of the following:
+Specifies a symbolic map name. Must be one of the following:
@code{GL_PIXEL_MAP_I_TO_I}, @code{GL_PIXEL_MAP_S_TO_S},
@code{GL_PIXEL_MAP_I_TO_R}, @code{GL_PIXEL_MAP_I_TO_G},
@code{GL_PIXEL_MAP_I_TO_B}, @code{GL_PIXEL_MAP_I_TO_A},
@code{glCopyTexSubImage3D}, @code{glDrawPixels}, @code{glReadPixels},
@code{glTexImage1D}, @code{glTexImage2D}, @code{glTexImage3D},
@code{glTexSubImage1D}, @code{glTexSubImage2D}, and
-@code{glTexSubImage3D}. Additionally, if the @code{ARB_imaging} subset
+@code{glTexSubImage3D}. Additionally, if the @code{ARB_imaging} subset
is supported, the routines @code{glColorTable}, @code{glColorSubTable},
@code{glConvolutionFilter1D}, @code{glConvolutionFilter2D},
-@code{glHistogram}, @code{glMinmax}, and @code{glSeparableFilter2D}. Use
+@code{glHistogram}, @code{glMinmax}, and @code{glSeparableFilter2D}. Use
of these maps is described completely in the @code{glPixelTransfer}
reference page, and partly in the reference pages for the pixel and
-texture image commands. Only the specification of the maps is described
+texture image commands. Only the specification of the maps is described
in this reference page.
@var{map} is a symbolic map name, indicating one of ten maps to set.
@end table
The entries in a map can be specified as single-precision floating-point
-numbers, unsigned short integers, or unsigned int integers. Maps that
+numbers, unsigned short integers, or unsigned int integers. Maps that
store color component values (all but @code{GL_PIXEL_MAP_I_TO_I} and
@code{GL_PIXEL_MAP_S_TO_S}) retain their values in floating-point
-format, with unspecified mantissa and exponent sizes. Floating-point
+format, with unspecified mantissa and exponent sizes. Floating-point
values specified by @code{glPixelMapfv} are converted directly to the
internal floating-point format of these maps, then clamped to the range
-[0,1]. Unsigned integer values specified by @code{glPixelMapusv} and
+[0,1]. Unsigned integer values specified by @code{glPixelMapusv} and
@code{glPixelMapuiv} are converted linearly such that the largest
representable integer maps to 1.0, and 0 maps to 0.0.
@code{GL_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 @code{glPixelMapfv} are converted
-directly to the internal fixed-point format of these maps. Unsigned
+directly to the internal fixed-point format of these maps. Unsigned
integer values specified by @code{glPixelMapusv} and
@code{glPixelMapuiv} specify integer values, with all 0's to the right
of the binary point.
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 @var{mapsize} = @r{2^@var{n}} for some @r{@var{n}} or the results
-are undefined. The maximum allowable size for each map depends on the
+maps. Maps that are indexed by either color or stencil indices must have
+@var{mapsize} = @r{2^@var{n}} for some @r{@var{n}} or the results are
+undefined. The maximum allowable size for each map depends on the
implementation and can be determined by calling @code{glGet} with
-argument @code{GL_MAX_PIXEL_MAP_TABLE}. The single maximum applies to
+argument @code{GL_MAX_PIXEL_MAP_TABLE}. The single maximum applies to
all maps; it is at least 32.
@table @asis
@table @asis
@item @var{pname}
-Specifies the symbolic name of the parameter to be set. Six values
+Specifies the symbolic name of the parameter to be set. Six values
affect the packing of pixel data into memory: @code{GL_PACK_SWAP_BYTES},
@code{GL_PACK_LSB_FIRST}, @code{GL_PACK_ROW_LENGTH},
@code{GL_PACK_IMAGE_HEIGHT}, @code{GL_PACK_SKIP_PIXELS},
@code{GL_PACK_SKIP_ROWS}, @code{GL_PACK_SKIP_IMAGES}, and
-@code{GL_PACK_ALIGNMENT}. Six more affect the unpacking of pixel data
+@code{GL_PACK_ALIGNMENT}. Six more affect the unpacking of pixel data
@var{from} memory: @code{GL_UNPACK_SWAP_BYTES},
@code{GL_UNPACK_LSB_FIRST}, @code{GL_UNPACK_ROW_LENGTH},
@code{GL_UNPACK_IMAGE_HEIGHT}, @code{GL_UNPACK_SKIP_PIXELS},
@code{glHistogram}), and minmax (See @code{glMinmax}) data.
@var{pname} is a symbolic constant indicating the parameter to be set,
-and @var{param} is the new value. Six of the twelve storage parameters
-affect how pixel data is returned to client memory. They are as
-follows:
+and @var{param} is the new value. Six of the twelve storage parameters
+affect how pixel data is returned to client memory. They are as follows:
@table @asis
@item @code{GL_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
+color indices, or stencil indices is reversed. That is, if a four-byte
component consists of bytes @r{@var{b}_0}, @r{@var{b}_1}, @r{@var{b}_2},
@r{@var{b}_3}, it is stored in memory as @r{@var{b}_3}, @r{@var{b}_2},
@r{@var{b}_1}, @r{@var{b}_0} if @code{GL_PACK_SWAP_BYTES} is true.
@code{GL_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 @code{GL_RGB} format
+or indices. For example, the three components of a @code{GL_RGB} format
pixel are always stored with red first, green second, and blue third,
regardless of the value of @code{GL_PACK_SWAP_BYTES}.
@item @code{GL_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.
+significant one. This parameter is significant for bitmap data only.
@item @code{GL_PACK_ROW_LENGTH}
If greater than 0, @code{GL_PACK_ROW_LENGTH} defines the number of
-pixels in a row. If the first pixel of a row is placed at location
+pixels in a row. If the first pixel of a row is placed at location
@r{@var{p}} in memory, then the location of the first pixel of the next
row is obtained by skipping
argument to the pixel routine otherwise), @r{@var{a}} is the value of
@code{GL_PACK_ALIGNMENT}, and @r{@var{s}} is the size, in bytes, of a
single component (if @r{@var{a}<@var{s}}, then it is as if
-@r{@var{a}=@var{s}}). In the case of 1-bit values, the location of the
+@r{@var{a}=@var{s}}). In the case of 1-bit values, the location of the
next row is obtained by skipping
@r{@var{k}=8@var{a}⌈@var{n}@var{l},/8@var{a},,⌉}
components or indices.
The word @var{component} in this description refers to the nonindex
-values red, green, blue, alpha, and depth. Storage format
-@code{GL_RGB}, for example, has three components per pixel: first red,
-then green, and finally blue.
+values red, green, blue, alpha, and depth. Storage format @code{GL_RGB},
+for example, has three components per pixel: first red, then green, and
+finally blue.
@item @code{GL_PACK_IMAGE_HEIGHT}
If greater than 0, @code{GL_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
+defined by all pixels sharing the same third dimension index. If the
first pixel of a row is placed at location @r{@var{p}} in memory, then
the location of the first pixel of the next row is obtained by skipping
@r{@var{a}<@var{s}}, then it is as if @r{@var{a}=@var{s}}).
The word @var{component} in this description refers to the nonindex
-values red, green, blue, alpha, and depth. Storage format
-@code{GL_RGB}, for example, has three components per pixel: first red,
-then green, and finally blue.
+values red, green, blue, alpha, and depth. Storage format @code{GL_RGB},
+for example, has three components per pixel: first red, then green, and
+finally blue.
@item @code{GL_PACK_SKIP_PIXELS}, @code{GL_PACK_SKIP_ROWS}, and @code{GL_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 @code{glReadPixels}. Setting
+incrementing the pointer passed to @code{glReadPixels}. Setting
@code{GL_PACK_SKIP_PIXELS} to @r{@var{i}} is equivalent to incrementing
the pointer by @r{@var{i}@var{n}} components or indices, where
@r{@var{n}} is the number of components or indices in each pixel.
Setting @code{GL_PACK_SKIP_ROWS} to @r{@var{j}} is equivalent to
incrementing the pointer by @r{@var{j}@var{m}} components or indices,
where @r{@var{m}} is the number of components or indices per row, as
-just computed in the @code{GL_PACK_ROW_LENGTH} section. Setting
+just computed in the @code{GL_PACK_ROW_LENGTH} section. Setting
@code{GL_PACK_SKIP_IMAGES} to @r{@var{k}} is equivalent to incrementing
the pointer by @r{@var{k}@var{p}}, where @r{@var{p}} is the number of
components or indices per image, as computed in the
@item @code{GL_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
+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).
@end table
The other six of the twelve storage parameters affect how pixel data is
-read from client memory. These values are significant for
+read from client memory. These values are significant for
@code{glDrawPixels}, @code{glTexImage1D}, @code{glTexImage2D},
@code{glTexImage3D}, @code{glTexSubImage1D}, @code{glTexSubImage2D},
@code{glTexSubImage3D}, @code{glBitmap}, and @code{glPolygonStipple}.
Additionally, if the @code{ARB_imaging} extension is supported,
@code{glColorTable}, @code{glColorSubTable},
@code{glConvolutionFilter1D}, @code{glConvolutionFilter2D}, and
-@code{glSeparableFilter2D}. They are as follows:
+@code{glSeparableFilter2D}. They are as follows:
@table @asis
@item @code{GL_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
+color indices, or stencil indices is reversed. That is, if a four-byte
component consists of bytes @r{@var{b}_0}, @r{@var{b}_1}, @r{@var{b}_2},
@r{@var{b}_3}, it is taken from memory as @r{@var{b}_3}, @r{@var{b}_2},
@r{@var{b}_1}, @r{@var{b}_0} if @code{GL_UNPACK_SWAP_BYTES} is true.
@code{GL_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 @code{GL_RGB} format
+or indices. For example, the three components of a @code{GL_RGB} format
pixel are always stored with red first, green second, and blue third,
regardless of the value of @code{GL_UNPACK_SWAP_BYTES}.
@item @code{GL_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.
+significant one. This is relevant only for bitmap data.
@item @code{GL_UNPACK_ROW_LENGTH}
If greater than 0, @code{GL_UNPACK_ROW_LENGTH} defines the number of
-pixels in a row. If the first pixel of a row is placed at location
+pixels in a row. If the first pixel of a row is placed at location
@r{@var{p}} in memory, then the location of the first pixel of the next
row is obtained by skipping
@r{@var{width}} argument to the pixel routine otherwise), @r{@var{a}} is
the value of @code{GL_UNPACK_ALIGNMENT}, and @r{@var{s}} is the size, in
bytes, of a single component (if @r{@var{a}<@var{s}}, then it is as if
-@r{@var{a}=@var{s}}). In the case of 1-bit values, the location of the
+@r{@var{a}=@var{s}}). In the case of 1-bit values, the location of the
next row is obtained by skipping
@r{@var{k}=8@var{a}⌈@var{n}@var{l},/8@var{a},,⌉}
components or indices.
The word @var{component} in this description refers to the nonindex
-values red, green, blue, alpha, and depth. Storage format
-@code{GL_RGB}, for example, has three components per pixel: first red,
-then green, and finally blue.
+values red, green, blue, alpha, and depth. Storage format @code{GL_RGB},
+for example, has three components per pixel: first red, then green, and
+finally blue.
@item @code{GL_UNPACK_IMAGE_HEIGHT}
If greater than 0, @code{GL_UNPACK_IMAGE_HEIGHT} defines the number of
-pixels in an image of a three-dimensional texture volume. Where
+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 @r{@var{p}} in
+index. If the first pixel of a row is placed at location @r{@var{p}} in
memory, then the location of the first pixel of the next row is obtained
by skipping
@r{@var{a}<@var{s}}, then it is as if @r{@var{a}=@var{s}}).
The word @var{component} in this description refers to the nonindex
-values red, green, blue, alpha, and depth. Storage format
-@code{GL_RGB}, for example, has three components per pixel: first red,
-then green, and finally blue.
+values red, green, blue, alpha, and depth. Storage format @code{GL_RGB},
+for example, has three components per pixel: first red, then green, and
+finally blue.
@item @code{GL_UNPACK_SKIP_PIXELS} and @code{GL_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 @code{glDrawPixels}, @code{glTexImage1D},
@code{glTexImage2D}, @code{glTexSubImage1D}, @code{glTexSubImage2D},
-@code{glBitmap}, or @code{glPolygonStipple}. Setting
+@code{glBitmap}, or @code{glPolygonStipple}. Setting
@code{GL_UNPACK_SKIP_PIXELS} to @r{@var{i}} is equivalent to
incrementing the pointer by @r{@var{i}@var{n}} components or indices,
where @r{@var{n}} is the number of components or indices in each pixel.
@item @code{GL_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
+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).
@end table
-@code{glPixelStoref} can be used to set any pixel store parameter. If
+@code{glPixelStoref} can be used to set any pixel store parameter. If
the parameter type is boolean, then if @var{param} is 0, the parameter
-is false; otherwise it is set to true. If @var{pname} is a integer type
+is false; otherwise it is set to true. If @var{pname} is a integer type
parameter, @var{param} is rounded to the nearest integer.
Likewise, @code{glPixelStorei} can also be used to set any of the pixel
-store parameters. Boolean parameters are set to false if @var{param} is
+store parameters. Boolean parameters are set to false if @var{param} is
0 and true otherwise.
@code{GL_INVALID_ENUM} is generated if @var{pname} is not an accepted
routines @code{glColorTable}, @code{glColorSubTable},
@code{glConvolutionFilter1D}, @code{glConvolutionFilter2D},
@code{glHistogram}, @code{glMinmax}, and @code{glSeparableFilter2D} are
-also affected. The algorithms that are specified by pixel transfer
-modes operate on pixels after they are read from the frame buffer
+also affected. The algorithms that are specified by pixel transfer modes
+operate on pixels after they are read from the frame buffer
(@code{glCopyPixels}@code{glCopyTexImage1D}, @code{glCopyTexImage2D},
@code{glCopyTexSubImage1D}, @code{glCopyTexSubImage2D},
@code{glCopyTexSubImage3D}, and @code{glReadPixels}), or unpacked from
client memory (@code{glDrawPixels}, @code{glTexImage1D},
@code{glTexImage2D}, @code{glTexImage3D}, @code{glTexSubImage1D},
-@code{glTexSubImage2D}, and @code{glTexSubImage3D}). Pixel transfer
+@code{glTexSubImage2D}, and @code{glTexSubImage3D}). 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 @code{glPixelStore}) control the unpacking of pixels being
-read from client memory and the packing of pixels being written back
-into client memory.
+of the command that resulted in the pixel operation. Pixel storage modes
+(see @code{glPixelStore}) control the unpacking of pixels being read
+from client memory and the packing of pixels being written back into
+client memory.
Pixel transfer operations handle four fundamental pixel types:
@var{color}, @var{color index}, @var{depth}, and @var{stencil}.
@var{Color} 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. @var{Color indices}
+zero intensity and 1 represents full intensity. @var{Color indices}
comprise a single fixed-point value, with unspecified precision to the
-right of the binary point. @var{Depth} pixels comprise a single
+right of the binary point. @var{Depth} 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, @var{stencil}
-pixels comprise a single fixed-point value, with unspecified precision
-to the right of the binary point.
+represents the maximum depth buffer value. Finally, @var{stencil} pixels
+comprise a single fixed-point value, with unspecified precision to the
+right of the binary point.
The pixel transfer operations performed on the four basic pixel types
are as follows:
@table @asis
@item @var{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
+added to a bias factor. That is, the red component is multiplied by
@code{GL_RED_SCALE}, then added to @code{GL_RED_BIAS}; the green
component is multiplied by @code{GL_GREEN_SCALE}, then added to
@code{GL_GREEN_BIAS}; the blue component is multiplied by
@code{GL_BLUE_SCALE}, then added to @code{GL_BLUE_BIAS}; and the alpha
component is multiplied by @code{GL_ALPHA_SCALE}, then added to
-@code{GL_ALPHA_BIAS}. After all four color components are scaled and
-biased, each is clamped to the range @r{[0,1]}. All color, scale, and
+@code{GL_ALPHA_BIAS}. After all four color components are scaled and
+biased, each is clamped to the range @r{[0,1]}. All color, scale, and
bias values are specified with @code{glPixelTransfer}.
If @code{GL_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
+contents of that map indexed by the scaled component. That is, the red
component is scaled by @code{GL_PIXEL_MAP_R_TO_R_SIZE}, then replaced by
-the contents of @code{GL_PIXEL_MAP_R_TO_R} indexed by itself. The green
+the contents of @code{GL_PIXEL_MAP_R_TO_R} indexed by itself. The green
component is scaled by @code{GL_PIXEL_MAP_G_TO_G_SIZE}, then replaced by
-the contents of @code{GL_PIXEL_MAP_G_TO_G} indexed by itself. The blue
+the contents of @code{GL_PIXEL_MAP_G_TO_G} indexed by itself. The blue
component is scaled by @code{GL_PIXEL_MAP_B_TO_B_SIZE}, then replaced by
-the contents of @code{GL_PIXEL_MAP_B_TO_B} indexed by itself. And the
+the contents of @code{GL_PIXEL_MAP_B_TO_B} indexed by itself. And the
alpha component is scaled by @code{GL_PIXEL_MAP_A_TO_A_SIZE}, then
replaced by the contents of @code{GL_PIXEL_MAP_A_TO_A} indexed by
-itself. All components taken from the maps are then clamped to the
-range @r{[0,1]}. @code{GL_MAP_COLOR} is specified with
-@code{glPixelTransfer}. The contents of the various maps are specified
-with @code{glPixelMap}.
+itself. All components taken from the maps are then clamped to the range
+@r{[0,1]}. @code{GL_MAP_COLOR} is specified with @code{glPixelTransfer}.
+The contents of the various maps are specified with @code{glPixelMap}.
If the @code{ARB_imaging} extension is supported, each of the four color
components may be scaled and biased after transformation by the color
-matrix. That is, the red component is multiplied by
+matrix. That is, the red component is multiplied by
@code{GL_POST_COLOR_MATRIX_RED_SCALE}, then added to
@code{GL_POST_COLOR_MATRIX_RED_BIAS}; the green component is multiplied
by @code{GL_POST_COLOR_MATRIX_GREEN_SCALE}, then added to
by @code{GL_POST_COLOR_MATRIX_BLUE_SCALE}, then added to
@code{GL_POST_COLOR_MATRIX_BLUE_BIAS}; and the alpha component is
multiplied by @code{GL_POST_COLOR_MATRIX_ALPHA_SCALE}, then added to
-@code{GL_POST_COLOR_MATRIX_ALPHA_BIAS}. After all four color components
+@code{GL_POST_COLOR_MATRIX_ALPHA_BIAS}. After all four color components
are scaled and biased, each is clamped to the range @r{[0,1]}.
Similarly, if the @code{ARB_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
+enabled convolution filter. That is, the red component is multiplied by
@code{GL_POST_CONVOLUTION_RED_SCALE}, then added to
@code{GL_POST_CONVOLUTION_RED_BIAS}; the green component is multiplied
by @code{GL_POST_CONVOLUTION_GREEN_SCALE}, then added to
by @code{GL_POST_CONVOLUTION_BLUE_SCALE}, then added to
@code{GL_POST_CONVOLUTION_BLUE_BIAS}; and the alpha component is
multiplied by @code{GL_POST_CONVOLUTION_ALPHA_SCALE}, then added to
-@code{GL_POST_CONVOLUTION_ALPHA_BIAS}. After all four color components
+@code{GL_POST_CONVOLUTION_ALPHA_BIAS}. After all four color components
are scaled and biased, each is clamped to the range @r{[0,1]}.
@item @var{Color index}
Each color index is shifted left by @code{GL_INDEX_SHIFT} bits; any bits
beyond the number of fraction bits carried by the fixed-point index are
-filled with zeros. If @code{GL_INDEX_SHIFT} is negative, the shift is
-to the right, again zero filled. Then @code{GL_INDEX_OFFSET} is added
-to the index. @code{GL_INDEX_SHIFT} and @code{GL_INDEX_OFFSET} are
+filled with zeros. If @code{GL_INDEX_SHIFT} is negative, the shift is to
+the right, again zero filled. Then @code{GL_INDEX_OFFSET} is added to
+the index. @code{GL_INDEX_SHIFT} and @code{GL_INDEX_OFFSET} are
specified with @code{glPixelTransfer}.
From this point, operation diverges depending on the required format of
-the resulting pixels. If the resulting pixels are to be written to a
+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
@code{GL_COLOR_INDEX} format, the pixels continue to be treated as
-indices. If @code{GL_MAP_COLOR} is true, each index is masked by
+indices. If @code{GL_MAP_COLOR} is true, each index is masked by
@r{2^@var{n}-1}, where @r{@var{n}} is @code{GL_PIXEL_MAP_I_TO_I_SIZE},
then replaced by the contents of @code{GL_PIXEL_MAP_I_TO_I} indexed by
-the masked value. @code{GL_MAP_COLOR} is specified with
-@code{glPixelTransfer}. The contents of the index map is specified with
+the masked value. @code{GL_MAP_COLOR} is specified with
+@code{glPixelTransfer}. The contents of the index map is specified with
@code{glPixelMap}.
If the resulting pixels are to be written to an RGBA color buffer, or if
@code{GL_COLOR_INDEX}, the pixels are converted from indices to colors
by referencing the four maps @code{GL_PIXEL_MAP_I_TO_R},
@code{GL_PIXEL_MAP_I_TO_G}, @code{GL_PIXEL_MAP_I_TO_B}, and
-@code{GL_PIXEL_MAP_I_TO_A}. Before being dereferenced, the index is
+@code{GL_PIXEL_MAP_I_TO_A}. Before being dereferenced, the index is
masked by @r{2^@var{n}-1}, where @r{@var{n}} is
@code{GL_PIXEL_MAP_I_TO_R_SIZE} for the red map,
@code{GL_PIXEL_MAP_I_TO_G_SIZE} for the green map,
@code{GL_PIXEL_MAP_I_TO_B_SIZE} for the blue map, and
-@code{GL_PIXEL_MAP_I_TO_A_SIZE} for the alpha map. All components taken
-from the maps are then clamped to the range @r{[0,1]}. The contents of
+@code{GL_PIXEL_MAP_I_TO_A_SIZE} for the alpha map. All components taken
+from the maps are then clamped to the range @r{[0,1]}. The contents of
the four maps is specified with @code{glPixelMap}.
@item @var{Depth}
@item @var{Stencil}
Each index is shifted @code{GL_INDEX_SHIFT} bits just as a color index
-is, then added to @code{GL_INDEX_OFFSET}. If @code{GL_MAP_STENCIL} is
+is, then added to @code{GL_INDEX_OFFSET}. If @code{GL_MAP_STENCIL} is
true, each index is masked by @r{2^@var{n}-1}, where @r{@var{n}} is
@code{GL_PIXEL_MAP_S_TO_S_SIZE}, then replaced by the contents of
@code{GL_PIXEL_MAP_S_TO_S} indexed by the masked value.
@code{glPixelTransferf} 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 @var{pname} is an integer parameter, @var{param} is
+implies true. If @var{pname} is an integer parameter, @var{param} is
rounded to the nearest integer.
Likewise, @code{glPixelTransferi} can be used to set any of the pixel
-transfer parameters. Boolean parameters are set to false if @var{param}
-is 0 and to true otherwise. @var{param} is converted to floating point
+transfer parameters. Boolean parameters are set to false if @var{param}
+is 0 and to true otherwise. @var{param} is converted to floating point
before being assigned to real-valued parameters.
@code{GL_INVALID_ENUM} is generated if @var{pname} is not an accepted
@end table
@code{glPixelZoom} specifies values for the @r{@var{x}} and @r{@var{y}}
-zoom factors. During the execution of @code{glDrawPixels} or
+zoom factors. During the execution of @code{glDrawPixels} or
@code{glCopyPixels}, if (@r{@var{xr}}, @r{@var{yr}}) is the current
raster position, and a given element is in the @r{@var{m}}th row and
@r{@var{n}}th column of the pixel rectangle, then pixels whose centers
(@r{@var{xr}+(@var{n}+1,)·@var{xfactor}},
@r{@var{yr}+(@var{m}+1,)·@var{yfactor}})
-are candidates for replacement. Any pixel whose center lies on the
+are candidates for replacement. Any pixel whose center lies on the
bottom or left edge of this rectangular region is also modified.
-Pixel zoom factors are not limited to positive values. Negative zoom
+Pixel zoom factors are not limited to positive values. Negative zoom
factors reflect the resulting image about the current raster position.
@code{GL_INVALID_OPERATION} is generated if @code{glPixelZoom} is
@table @asis
@item @var{pname}
-Specifies a single-valued point parameter. @code{GL_POINT_SIZE_MIN},
+Specifies a single-valued point parameter. @code{GL_POINT_SIZE_MIN},
@code{GL_POINT_SIZE_MAX}, @code{GL_POINT_FADE_THRESHOLD_SIZE}, and
@code{GL_POINT_SPRITE_COORD_ORIGIN} are accepted.
@var{params} is a single floating-point value that specifies the minimum
-point size. The default value is 0.0.
+point size. The default value is 0.0.
@item @code{GL_POINT_SIZE_MAX}
@var{params} is a single floating-point value that specifies the maximum
-point size. The default value is 1.0.
+point size. The default value is 1.0.
@item @code{GL_POINT_FADE_THRESHOLD_SIZE}
@var{params} is a single floating-point value that specifies the
threshold value to which point sizes are clamped if they exceed the
-specified value. The default value is 1.0.
+specified value. The default value is 1.0.
@item @code{GL_POINT_DISTANCE_ATTENUATION}
@var{params} is an array of three floating-point values that specify the
-coefficients used for scaling the computed point size. The default
+coefficients used for scaling the computed point size. The default
values are @r{(1,00)}.
@item @code{GL_POINT_SPRITE_COORD_ORIGIN}
@table @asis
@item @var{size}
-Specifies the diameter of rasterized points. The initial value is 1.
+Specifies the diameter of rasterized points. The initial value is 1.
@end table
@code{glPointSize} 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
+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 @code{glEnable} and
-@code{glDisable} with argument @code{GL_POINT_SMOOTH}. Point
+@code{glDisable} with argument @code{GL_POINT_SMOOTH}. Point
antialiasing is initially disabled.
The specified point size is multiplied with a distance attenuation
(@var{otherwise}),}
If point antialiasing is disabled, the actual size is determined by
-rounding the supplied size to the nearest integer. (If the rounding
+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 (@r{@var{x}}, @r{@var{y}}) of
the pixel fragment that represents the point is computed as
@r{(⌊@var{x}_@var{w},⌋+.5,⌊@var{y}_@var{w},⌋+.5)}
-where @r{@var{w}} subscripts indicate window coordinates. All pixels
+where @r{@var{w}} subscripts indicate window coordinates. All pixels
that lie within the square grid of the rounded size centered at
-(@r{@var{x}}, @r{@var{y}}) make up the fragment. If the size is even,
+(@r{@var{x}}, @r{@var{y}}) make up the fragment. If the size is even,
the center point is
@r{(⌊@var{x}_@var{w}+.5,⌋,⌊@var{y}_@var{w}+.5,⌋)}
and the rasterized fragment's centers are the half-integer window
coordinates within the square of the rounded size centered at
-@r{(@var{x},@var{y})}. All pixel fragments produced in rasterizing a
+@r{(@var{x},@var{y})}. All pixel fragments produced in rasterizing a
nonantialiased point are assigned the same associated data, that of the
vertex corresponding to the point.
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 @r{(@var{x}_@var{w},@var{y}_@var{w})}. The coverage value for
+point's @r{(@var{x}_@var{w},@var{y}_@var{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.
+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.
-Not all sizes are supported when point antialiasing is enabled. If an
-unsupported size is requested, the nearest supported size is used. Only
+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
+implementation. To query the range of supported sizes and the size
difference between supported sizes within the range, call @code{glGet}
with arguments @code{GL_SMOOTH_POINT_SIZE_RANGE} and
-@code{GL_SMOOTH_POINT_SIZE_GRANULARITY}. For aliased points, query the
+@code{GL_SMOOTH_POINT_SIZE_GRANULARITY}. For aliased points, query the
supported ranges and granularity with @code{glGet} with arguments
@code{GL_ALIASED_POINT_SIZE_RANGE}.
@table @asis
@item @var{face}
-Specifies the polygons that @var{mode} applies to. Must be
+Specifies the polygons that @var{mode} applies to. Must be
@code{GL_FRONT} for front-facing polygons, @code{GL_BACK} for
back-facing polygons, or @code{GL_FRONT_AND_BACK} for front- and
back-facing polygons.
@item @var{mode}
-Specifies how polygons will be rasterized. Accepted values are
-@code{GL_POINT}, @code{GL_LINE}, and @code{GL_FILL}. The initial value
+Specifies how polygons will be rasterized. Accepted values are
+@code{GL_POINT}, @code{GL_LINE}, and @code{GL_FILL}. The initial value
is @code{GL_FILL} for both front- and back-facing polygons.
@end table
@code{glPolygonMode} controls the interpretation of polygons for
-rasterization. @var{face} describes which polygons @var{mode} applies
+rasterization. @var{face} describes which polygons @var{mode} applies
to: front-facing polygons (@code{GL_FRONT}), back-facing polygons
-(@code{GL_BACK}), or both (@code{GL_FRONT_AND_BACK}). The polygon mode
-affects only the final rasterization of polygons. In particular, a
+(@code{GL_BACK}), or both (@code{GL_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.
@table @asis
@item @code{GL_POINT}
Polygon vertices that are marked as the start of a boundary edge are
-drawn as points. Point attributes such as @code{GL_POINT_SIZE} and
-@code{GL_POINT_SMOOTH} control the rasterization of the points. Polygon
+drawn as points. Point attributes such as @code{GL_POINT_SIZE} and
+@code{GL_POINT_SMOOTH} control the rasterization of the points. Polygon
rasterization attributes other than @code{GL_POLYGON_MODE} have no
effect.
@item @code{GL_LINE}
-Boundary edges of the polygon are drawn as line segments. They are
+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
-@code{glLineStipple}). Line attributes such as @code{GL_LINE_WIDTH} and
-@code{GL_LINE_SMOOTH} control the rasterization of the lines. Polygon
+@code{glLineStipple}). Line attributes such as @code{GL_LINE_WIDTH} and
+@code{GL_LINE_SMOOTH} control the rasterization of the lines. Polygon
rasterization attributes other than @code{GL_POLYGON_MODE} have no
effect.
@item @code{GL_FILL}
-The interior of the polygon is filled. Polygon attributes such as
+The interior of the polygon is filled. Polygon attributes such as
@code{GL_POLYGON_STIPPLE} and @code{GL_POLYGON_SMOOTH} control the
rasterization of the polygon.
@table @asis
@item @var{factor}
Specifies a scale factor that is used to create a variable depth offset
-for each polygon. The initial value is 0.
+for each polygon. The initial value is 0.
@item @var{units}
Is multiplied by an implementation-specific value to create a constant
-depth offset. The initial value is 0.
+depth offset. The initial value is 0.
@end table
When @code{GL_POLYGON_OFFSET_FILL}, @code{GL_POLYGON_OFFSET_LINE}, or
@code{GL_POLYGON_OFFSET_POINT} is enabled, each fragment's @var{depth}
value will be offset after it is interpolated from the @var{depth}
-values of the appropriate vertices. The value of the offset is
+values of the appropriate vertices. The value of the offset is
@r{@var{factor}×@var{DZ}+@var{r}×@var{units}}, where @r{@var{DZ}} is a
measurement of the change in depth relative to the screen area of the
polygon, and @r{@var{r}} is the smallest value that is guaranteed to
-produce a resolvable offset for a given implementation. The offset is
+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.
@var{pattern} is a pointer to a @r{32×32} stipple pattern that is stored
in memory just like the pixel data supplied to a @code{glDrawPixels}
call with height and @var{width} both equal to 32, a pixel format of
-@code{GL_COLOR_INDEX}, and data type of @code{GL_BITMAP}. That is, the
+@code{GL_COLOR_INDEX}, and data type of @code{GL_BITMAP}. That is, the
stipple pattern is represented as a @r{32×32} array of 1-bit color
-indices packed in unsigned bytes. @code{glPixelStore} parameters like
+indices packed in unsigned bytes. @code{glPixelStore} parameters like
@code{GL_UNPACK_SWAP_BYTES} and @code{GL_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.
+assembling of the bits into a stipple pattern. Pixel transfer operations
+(shift, offset, pixel map) are not applied to the stipple image,
+however.
If a non-zero named buffer object is bound to the
@code{GL_PIXEL_UNPACK_BUFFER} target (see @code{glBindBuffer}) while a
into the buffer object's data store.
To enable and disable polygon stippling, call @code{glEnable} and
-@code{glDisable} with argument @code{GL_POLYGON_STIPPLE}. Polygon
-stippling is initially disabled. If it's enabled, a rasterized polygon
+@code{glDisable} with argument @code{GL_POLYGON_STIPPLE}. Polygon
+stippling is initially disabled. If it's enabled, a rasterized polygon
fragment with window coordinates @r{@var{x}_@var{w}} and
@r{@var{y}_@var{w}} is sent to the next stage of the GL if and only if
the (@r{@var{x}_@var{w}%32})th bit in the (@r{@var{y}_@var{w}%32})th row
-of the stipple pattern is 1 (one). When polygon stippling is disabled,
+of the stipple pattern is 1 (one). When polygon stippling is disabled,
it is as if the stipple pattern consists of all 1's.
@code{GL_INVALID_OPERATION} is generated if a non-zero buffer object
prioritized.
@item @var{priorities}
-Specifies an array containing the texture priorities. A priority given
+Specifies an array containing the texture priorities. A priority given
in an element of @var{priorities} applies to the texture named by the
corresponding element of @var{textures}.
in @var{priorities} to the @var{n} textures named in @var{textures}.
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
+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, @code{glPrioritizeTextures} allows
applications to guide the GL implementation in determining which
textures should be resident.
The priorities given in @var{priorities} are clamped to the range
-@r{[0,1]} before they are assigned. 0 indicates the lowest priority;
-textures with priority 0 are least likely to be resident. 1 indicates
+@r{[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.
+resident. However, textures are not guaranteed to be resident until they
+are used.
@code{glPrioritizeTextures} silently ignores attempts to prioritize
texture 0 or any texture name that does not correspond to an existing
@code{glPrioritizeTextures} does not require that any of the textures
named by @var{textures} be bound to a texture target.
@code{glTexParameter} 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
+only if the texture is currently bound. This is the only way to set the
priority of a default texture.
@code{GL_INVALID_VALUE} is generated if @var{n} is negative.
@table @asis
@item @var{mask}
-Specifies a mask that indicates which attributes to save. Values for
+Specifies a mask that indicates which attributes to save. Values for
@var{mask} are listed below.
@end table
@code{glPushAttrib} 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. @var{mask} is typically
+groups of state variables to save on the attribute stack. Symbolic
+constants are used to set bits in the mask. @var{mask} is typically
constructed by specifying the bitwise-or of several of these constants
-together. The special mask @code{GL_ALL_ATTRIB_BITS} can be used to
-save all stackable states.
+together. The special mask @code{GL_ALL_ATTRIB_BITS} can be used to save
+all stackable states.
The symbolic mask constants and their associated GL state are as follows
(the second column lists which attributes are saved):
@end table
@code{glPopAttrib} restores the values of the state variables saved with
-the last @code{glPushAttrib} command. Those not saved are left
+the last @code{glPushAttrib} command. Those not saved are left
unchanged.
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
+off an empty stack. In either case, the error flag is set and no other
change is made to GL state.
Initially, the attribute stack is empty.
@table @asis
@item @var{mask}
-Specifies a mask that indicates which attributes to save. Values for
+Specifies a mask that indicates which attributes to save. Values for
@var{mask} are listed below.
@end table
@code{glPushClientAttrib} 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. @var{mask}
+stack. Symbolic constants are used to set bits in the mask. @var{mask}
is typically constructed by specifying the bitwise-or of several of
-these constants together. The special mask
+these constants together. The special mask
@code{GL_CLIENT_ALL_ATTRIB_BITS} can be used to save all stackable
client state.
@code{GL_CLIENT_VERTEX_ARRAY_BIT} Vertex arrays (and enables)
@code{glPopClientAttrib} restores the values of the client-state
-variables saved with the last @code{glPushClientAttrib}. Those not
-saved are left unchanged.
+variables saved with the last @code{glPushClientAttrib}. Those not saved
+are left unchanged.
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
+to pop attributes off an empty stack. In either case, the error flag is
set, and no other change is made to GL state.
Initially, the client attribute stack is empty.
@deftypefunx void glPopMatrix
Push and pop the current matrix stack.
-There is a stack of matrices for each of the matrix modes. In
-@code{GL_MODELVIEW} mode, the stack depth is at least 32. In the other
+There is a stack of matrices for each of the matrix modes. In
+@code{GL_MODELVIEW} mode, the stack depth is at least 32. In the other
modes, @code{GL_COLOR}, @code{GL_PROJECTION}, and @code{GL_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.
+depth is at least 2. The current matrix in any mode is the matrix on the
+top of the stack for that mode.
@code{glPushMatrix} pushes the current matrix stack down by one,
-duplicating the current matrix. That is, after a @code{glPushMatrix}
+duplicating the current matrix. That is, after a @code{glPushMatrix}
call, the matrix on top of the stack is identical to the one below it.
@code{glPopMatrix} pops the current matrix stack, replacing the current
Initially, each of the stacks contains one matrix, an identity matrix.
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.
+contains only a single matrix. In either case, the error flag is set and
+no other change is made to GL state.
@code{GL_STACK_OVERFLOW} is generated if @code{glPushMatrix} is called
while the current matrix stack is full.
@end table
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
+commands to be uniquely identified. It consists of an ordered set of
unsigned integers and is initially empty.
@code{glPushName} causes @var{name} to be pushed onto the name stack.
The maximum name stack depth is implementation-dependent; call
@code{GL_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
+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 @code{glBegin} and the corresponding
-execution of @code{glEnd}. In any of these cases, the error flag is set
+execution of @code{glEnd}. In any of these cases, the error flag is set
and no other change is made to GL state.
The name stack is always empty while the render mode is not
-@code{GL_SELECT}. Calls to @code{glPushName} or @code{glPopName} while
+@code{GL_SELECT}. Calls to @code{glPushName} or @code{glPopName} while
the render mode is not @code{GL_SELECT} are ignored.
@code{GL_STACK_OVERFLOW} is generated if @code{glPushName} is called
@end table
-The GL maintains a 3D position in window coordinates. This position,
+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
+operations. It is maintained with subpixel accuracy. See
@code{glBitmap}, @code{glDrawPixels}, and @code{glCopyPixels}.
The current raster position consists of three window coordinates
(@r{@var{x}}, @r{@var{y}}, @r{@var{z}}), a clip coordinate value
(@r{@var{w}}), an eye coordinate distance, a valid bit, and associated
-color data and texture coordinates. The @r{@var{w}} coordinate is a
-clip coordinate, because @r{@var{w}} is not projected to window
-coordinates. @code{glRasterPos4} specifies object coordinates
-@r{@var{x}}, @r{@var{y}}, @r{@var{z}}, and @r{@var{w}} explicitly.
+color data and texture coordinates. The @r{@var{w}} coordinate is a clip
+coordinate, because @r{@var{w}} is not projected to window coordinates.
+@code{glRasterPos4} specifies object coordinates @r{@var{x}},
+@r{@var{y}}, @r{@var{z}}, and @r{@var{w}} explicitly.
@code{glRasterPos3} specifies object coordinate @r{@var{x}},
@r{@var{y}}, and @r{@var{z}} explicitly, while @r{@var{w}} is implicitly
-set to 1. @code{glRasterPos2} uses the argument values for @r{@var{x}}
+set to 1. @code{glRasterPos2} uses the argument values for @r{@var{x}}
and @r{@var{y}} while implicitly setting @r{@var{z}} and @r{@var{w}} to
0 and 1.
The object coordinates presented by @code{glRasterPos} are treated just
like those of a @code{glVertex} 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
+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 @code{GL_CURRENT_RASTER_POSITION_VALID} flag is set. If the vertex
+the @code{GL_CURRENT_RASTER_POSITION_VALID} flag is set. If the vertex
@var{is} culled, then the valid bit is cleared and the current raster
position and associated color and texture coordinates are undefined.
The current raster position also includes some associated color data and
-texture coordinates. If lighting is enabled, then
+texture coordinates. If lighting is enabled, then
@code{GL_CURRENT_RASTER_COLOR} (in RGBA mode) or
@code{GL_CURRENT_RASTER_INDEX} (in color index mode) is set to the color
produced by the lighting calculation (see @code{glLight},
-@code{glLightModel}, and @code{glShadeModel}). If lighting is disabled,
+@code{glLightModel}, and @code{glShadeModel}). If lighting is disabled,
current color (in RGBA mode, state variable @code{GL_CURRENT_COLOR}) or
color index (in color index mode, state variable
@code{GL_CURRENT_INDEX}) is used to update the current raster color.
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,
+texture coordinates are (0, 0, 0, 1). In RGBA mode,
@code{GL_CURRENT_RASTER_INDEX} is always 1; in color index mode, the
current raster RGBA color always maintains its initial value.
@table @asis
@item @var{mode}
-Specifies a color buffer. Accepted values are @code{GL_FRONT_LEFT},
+Specifies a color buffer. Accepted values are @code{GL_FRONT_LEFT},
@code{GL_FRONT_RIGHT}, @code{GL_BACK_LEFT}, @code{GL_BACK_RIGHT},
@code{GL_FRONT}, @code{GL_BACK}, @code{GL_LEFT}, @code{GL_RIGHT}, and
@code{GL_AUX}@var{i}, where @var{i} is between 0 and the value of
subsequent @code{glReadPixels}, @code{glCopyTexImage1D},
@code{glCopyTexImage2D}, @code{glCopyTexSubImage1D},
@code{glCopyTexSubImage2D}, @code{glCopyTexSubImage3D}, and
-@code{glCopyPixels} commands. @var{mode} accepts one of twelve or more
-predefined values. (@code{GL_AUX0} through @code{GL_AUX3} are always
+@code{glCopyPixels} commands. @var{mode} accepts one of twelve or more
+predefined values. (@code{GL_AUX0} through @code{GL_AUX3} are always
defined.) In a fully configured system, @code{GL_FRONT}, @code{GL_LEFT},
and @code{GL_FRONT_LEFT} all name the front left buffer,
@code{GL_FRONT_RIGHT} and @code{GL_RIGHT} name the front right buffer,
and @code{GL_BACK_LEFT} and @code{GL_BACK} name the back left buffer.
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
-@code{glReadBuffer}.
+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 @code{glReadBuffer}.
@var{mode} is initially @code{GL_FRONT} in single-buffered
configurations and @code{GL_BACK} in double-buffered configurations.
@item @var{x}
@itemx @var{y}
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
+frame buffer. This location is the lower left corner of a rectangular
block of pixels.
@item @var{width}
@itemx @var{height}
-Specify the dimensions of the pixel rectangle. @var{width} and
+Specify the dimensions of the pixel rectangle. @var{width} and
@var{height} of one correspond to a single pixel.
@item @var{format}
-Specifies the format of the pixel data. The following symbolic values
+Specifies the format of the pixel data. The following symbolic values
are accepted: @code{GL_COLOR_INDEX}, @code{GL_STENCIL_INDEX},
@code{GL_DEPTH_COMPONENT}, @code{GL_RED}, @code{GL_GREEN},
@code{GL_BLUE}, @code{GL_ALPHA}, @code{GL_RGB}, @code{GL_BGR},
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type of the pixel data. Must be one of
+Specifies the data type of the pixel data. Must be one of
@code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
@code{glReadPixels} returns pixel data from the frame buffer, starting
with the pixel whose lower left corner is at location (@var{x},
-@var{y}), into client memory starting at location @var{data}. Several
+@var{y}), into client memory starting at location @var{data}. Several
parameters control the processing of the pixel data before it is placed
-into client memory. These parameters are set with three commands:
-@code{glPixelStore}, @code{glPixelTransfer}, and @code{glPixelMap}. This
+into client memory. These parameters are set with three commands:
+@code{glPixelStore}, @code{glPixelTransfer}, and @code{glPixelMap}. This
reference page describes the effects on @code{glReadPixels} of most, but
not all of the parameters specified by these three commands.
@code{glReadPixels} returns values from each pixel with lower left
corner at @r{(@var{x}+@var{i},@var{y}+@var{j})} for
-@r{0<=@var{i}<@var{width}} and @r{0<=@var{j}<@var{height}}. This pixel
-is said to be the @r{@var{i}}th pixel in the @r{@var{j}}th row. Pixels
+@r{0<=@var{i}<@var{width}} and @r{0<=@var{j}<@var{height}}. This pixel
+is said to be the @r{@var{i}}th pixel in the @r{@var{j}}th row. Pixels
are returned in row order from the lowest to the highest row, left to
right in each row.
@table @asis
@item @code{GL_COLOR_INDEX}
Color indices are read from the color buffer selected by
-@code{glReadBuffer}. Each index is converted to fixed point, shifted
+@code{glReadBuffer}. Each index is converted to fixed point, shifted
left or right depending on the value and sign of @code{GL_INDEX_SHIFT},
-and added to @code{GL_INDEX_OFFSET}. If @code{GL_MAP_COLOR} is
+and added to @code{GL_INDEX_OFFSET}. If @code{GL_MAP_COLOR} is
@code{GL_TRUE}, indices are replaced by their mappings in the table
@code{GL_PIXEL_MAP_I_TO_I}.
@item @code{GL_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 @code{GL_INDEX_SHIFT}, and added to @code{GL_INDEX_OFFSET}.
-If @code{GL_MAP_STENCIL} is @code{GL_TRUE}, indices are replaced by
-their mappings in the table @code{GL_PIXEL_MAP_S_TO_S}.
+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
+@code{GL_INDEX_SHIFT}, and added to @code{GL_INDEX_OFFSET}. If
+@code{GL_MAP_STENCIL} is @code{GL_TRUE}, indices are replaced by their
+mappings in the table @code{GL_PIXEL_MAP_S_TO_S}.
@item @code{GL_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
+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
@code{GL_DEPTH_SCALE}, added to @code{GL_DEPTH_BIAS}, and finally
clamped to the range @r{[0,1]}.
@item @code{GL_LUMINANCE}
@item @code{GL_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 @code{glReadBuffer}. Each index
+indices or RGBA color components. If color indices are stored, they are
+read from the color buffer selected by @code{glReadBuffer}. Each index
is converted to fixed point, shifted left or right depending on the
value and sign of @code{GL_INDEX_SHIFT}, and added to
-@code{GL_INDEX_OFFSET}. Indices are then replaced by the red, green,
+@code{GL_INDEX_OFFSET}. Indices are then replaced by the red, green,
blue, and alpha values obtained by indexing the tables
@code{GL_PIXEL_MAP_I_TO_R}, @code{GL_PIXEL_MAP_I_TO_G},
-@code{GL_PIXEL_MAP_I_TO_B}, and @code{GL_PIXEL_MAP_I_TO_A}. Each table
+@code{GL_PIXEL_MAP_I_TO_B}, and @code{GL_PIXEL_MAP_I_TO_A}. Each table
must be of size @r{2^@var{n}}, but @r{@var{n}} may be different for
-different tables. Before an index is used to look up a value in a table
+different tables. Before an index is used to look up a value in a table
of size @r{2^@var{n}}, it must be masked against @r{2^@var{n}-1}.
If RGBA color components are stored in the color buffers, they are read
-from the color buffer selected by @code{glReadBuffer}. Each color
+from the color buffer selected by @code{glReadBuffer}. 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 @code{GL_c_SCALE} and added to @code{GL_c_BIAS}, where
-@var{c} is RED, GREEN, BLUE, or ALPHA. Finally, if @code{GL_MAP_COLOR}
-is @code{GL_TRUE}, each component is clamped to the range @r{[0,1]},
-scaled to the size of its corresponding table, and is then replaced by
-its mapping in the table @code{GL_PIXEL_MAP_c_TO_c}, where @var{c} is R,
-G, B, or A.
-
-Unneeded data is then discarded. For example, @code{GL_RED} discards
-the green, blue, and alpha components, while @code{GL_RGB} discards only
-the alpha component. @code{GL_LUMINANCE} computes a single-component
-value as the sum of the red, green, and blue components, and
+to 0.0 and full intensity maps to 1.0. Each component is then multiplied
+by @code{GL_c_SCALE} and added to @code{GL_c_BIAS}, where @var{c} is
+RED, GREEN, BLUE, or ALPHA. Finally, if @code{GL_MAP_COLOR} is
+@code{GL_TRUE}, each component is clamped to the range @r{[0,1]}, scaled
+to the size of its corresponding table, and is then replaced by its
+mapping in the table @code{GL_PIXEL_MAP_c_TO_c}, where @var{c} is R, G,
+B, or A.
+
+Unneeded data is then discarded. For example, @code{GL_RED} discards the
+green, blue, and alpha components, while @code{GL_RGB} discards only the
+alpha component. @code{GL_LUMINANCE} computes a single-component value
+as the sum of the red, green, and blue components, and
@code{GL_LUMINANCE_ALPHA} does the same, while keeping alpha as a second
-value. The final values are clamped to the range @r{[0,1]}.
+value. The final values are clamped to the range @r{[0,1]}.
@end table
The shift, scale, bias, and lookup factors just described are all
-specified by @code{glPixelTransfer}. The lookup table contents
+specified by @code{glPixelTransfer}. The lookup table contents
themselves are specified by @code{glPixelMap}.
Finally, the indices or components are converted to the proper format,
-as specified by @var{type}. If @var{format} is @code{GL_COLOR_INDEX} or
+as specified by @var{type}. If @var{format} is @code{GL_COLOR_INDEX} or
@code{GL_STENCIL_INDEX} and @var{type} is not @code{GL_FLOAT}, each
-index is masked with the mask value given in the following table. If
+index is masked with the mask value given in the following table. If
@var{type} is @code{GL_FLOAT}, then each integer index is converted to
single-precision floating-point format.
@code{GL_ALPHA}, @code{GL_RGB}, @code{GL_BGR}, @code{GL_RGBA},
@code{GL_BGRA}, @code{GL_LUMINANCE}, or @code{GL_LUMINANCE_ALPHA} and
@var{type} is not @code{GL_FLOAT}, each component is multiplied by the
-multiplier shown in the following table. If type is @code{GL_FLOAT},
+multiplier shown in the following table. If type is @code{GL_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).
@end table
-Return values are placed in memory as follows. If @var{format} is
+Return values are placed in memory as follows. If @var{format} is
@code{GL_COLOR_INDEX}, @code{GL_STENCIL_INDEX},
@code{GL_DEPTH_COMPONENT}, @code{GL_RED}, @code{GL_GREEN},
@code{GL_BLUE}, @code{GL_ALPHA}, or @code{GL_LUMINANCE}, a single value
is returned and the data for the @r{@var{i}}th pixel in the
@r{@var{j}}th row is placed in location
-@r{(@var{j},)@var{width}+@var{i}}. @code{GL_RGB} and @code{GL_BGR}
+@r{(@var{j},)@var{width}+@var{i}}. @code{GL_RGB} and @code{GL_BGR}
return three values, @code{GL_RGBA} and @code{GL_BGRA} return four
values, and @code{GL_LUMINANCE_ALPHA} returns two values for each pixel,
with all values corresponding to a single pixel occupying contiguous
-space in @var{data}. Storage parameters set by @code{glPixelStore},
-such as @code{GL_PACK_LSB_FIRST} and @code{GL_PACK_SWAP_BYTES}, affect
-the way that data is written into memory. See @code{glPixelStore} for a
+space in @var{data}. Storage parameters set by @code{glPixelStore}, such
+as @code{GL_PACK_LSB_FIRST} and @code{GL_PACK_SWAP_BYTES}, affect the
+way that data is written into memory. See @code{glPixelStore} for a
description.
@code{GL_INVALID_ENUM} is generated if @var{format} or @var{type} is not
@end table
@code{glRect} supports efficient specification of rectangles as two
-corner points. Each rectangle command takes four arguments, organized
+corner points. Each rectangle command takes four arguments, organized
either as two consecutive pairs of @r{(@var{x},@var{y})} coordinates or
as two pointers to arrays, each containing an @r{(@var{x},@var{y})}
-pair. The resulting rectangle is defined in the @r{@var{z}=0} plane.
+pair. The resulting rectangle is defined in the @r{@var{z}=0} plane.
@code{glRect}(@var{x1}, @var{y1}, @var{x2}, @var{y2}) is exactly
equivalent to the following sequence: Note that if the second vertex is
@table @asis
@item @var{mode}
-Specifies the rasterization mode. Three values are accepted:
-@code{GL_RENDER}, @code{GL_SELECT}, and @code{GL_FEEDBACK}. The initial
+Specifies the rasterization mode. Three values are accepted:
+@code{GL_RENDER}, @code{GL_SELECT}, and @code{GL_FEEDBACK}. The initial
value is @code{GL_RENDER}.
@end table
-@code{glRenderMode} sets the rasterization mode. It takes one argument,
+@code{glRenderMode} sets the rasterization mode. It takes one argument,
@var{mode}, which can assume one of three predefined values:
@table @asis
@item @code{GL_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.
+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.
@item @code{GL_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
+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
@code{GL_RENDER} is returned in a select buffer, which must be created
(see @code{glSelectBuffer}) before selection mode is entered.
@item @code{GL_FEEDBACK}
-Feedback mode. No pixel fragments are produced, and no change to the
-frame buffer contents is made. Instead, the coordinates and attributes
+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
@code{GL_RENDER} is returned in a feedback buffer, which must be created
(see @code{glFeedbackBuffer}) before feedback mode is entered.
@end table
@code{glRotate} produces a rotation of @var{angle} degrees around the
-vector @r{(@var{x},@var{y}@var{z})}. The current matrix (see
+vector @r{(@var{x},@var{y}@var{z})}. The current matrix (see
@code{glMatrixMode}) is multiplied by a rotation matrix with the product
replacing the current matrix, as if @code{glMultMatrix} were called with
the following matrix as its argument:
If the matrix mode is either @code{GL_MODELVIEW} or
@code{GL_PROJECTION}, all objects drawn after @code{glRotate} is called
-are rotated. Use @code{glPushMatrix} and @code{glPopMatrix} to save and
+are rotated. Use @code{glPushMatrix} and @code{glPopMatrix} to save and
restore the unrotated coordinate system.
@code{GL_INVALID_OPERATION} is generated if @code{glRotate} is executed
@table @asis
@item @var{value}
-Specify a single floating-point sample coverage value. The value is
-clamped to the range @r{[0,1]}. The initial value is 1.0.
+Specify a single floating-point sample coverage value. The value is
+clamped to the range @r{[0,1]}. The initial value is 1.0.
@item @var{invert}
Specify a single boolean value representing if the coverage masks should
-be inverted. @code{GL_TRUE} and @code{GL_FALSE} are accepted. The
+be inverted. @code{GL_TRUE} and @code{GL_FALSE} are accepted. The
initial value is @code{GL_FALSE}.
@end table
Multisampling samples a pixel multiple times at various
implementation-dependent subpixel locations to generate antialiasing
-effects. Multisampling transparently antialiases points, lines,
+effects. Multisampling transparently antialiases points, lines,
polygons, bitmaps, and images if it is enabled.
@var{value} is used in constructing a temporary mask used in determining
-which samples will be used in resolving the final fragment color. This
+which samples will be used in resolving the final fragment color. This
mask is bitwise-anded with the coverage mask generated from the
-multisampling computation. If the @var{invert} flag is set, the
+multisampling computation. If the @var{invert} flag is set, the
temporary mask is inverted (all bits flipped) and then the bitwise-and
is computed.
Provided an implementation supports multisample buffers, and
multisampling is enabled, then a pixel's final color is generated by
-combining several samples per pixel. Each sample contains color, depth,
+combining several samples per pixel. Each sample contains color, depth,
and stencil information, allowing those operations to be performed on
each sample.
@end table
@code{glScale} produces a nonuniform scaling along the @var{x}, @var{y},
-and @var{z} axes. The three parameters indicate the desired scale
-factor along each of the three axes.
+and @var{z} axes. The three parameters indicate the desired scale factor
+along each of the three axes.
The current matrix (see @code{glMatrixMode}) is multiplied by this scale
matrix, and the product replaces the current matrix as if
@table @asis
@item @var{x}
@itemx @var{y}
-Specify the lower left corner of the scissor box. Initially (0, 0).
+Specify the lower left corner of the scissor box. Initially (0, 0).
@item @var{width}
@itemx @var{height}
-Specify the width and height of the scissor box. When a GL context is
+Specify the width and height of the scissor box. When a GL context is
first attached to a window, @var{width} and @var{height} are set to the
dimensions of that window.
@end table
@code{glScissor} defines a rectangle, called the scissor box, in window
-coordinates. The first two arguments, @var{x} and @var{y}, specify the
-lower left corner of the box. @var{width} and @var{height} specify the
+coordinates. The first two arguments, @var{x} and @var{y}, specify the
+lower left corner of the box. @var{width} and @var{height} specify the
width and height of the box.
To enable and disable the scissor test, call @code{glEnable} and
-@code{glDisable} with argument @code{GL_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
+@code{glDisable} with argument @code{GL_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. @code{glScissor(0,0,1,1)} allows modification of only the lower
+pixels. @code{glScissor(0,0,1,1)} allows modification of only the lower
left pixel in the window, and @code{glScissor(0,0,0,0)} doesn't allow
modification of any pixels in the window.
@table @asis
@item @var{size}
-Specifies the number of components per color. Must be 3.
+Specifies the number of components per color. Must be 3.
@item @var{type}
-Specifies the data type of each color component in the array. Symbolic
+Specifies the data type of each color component in the array. Symbolic
constants @code{GL_BYTE}, @code{GL_UNSIGNED_BYTE}, @code{GL_SHORT},
@code{GL_UNSIGNED_SHORT}, @code{GL_INT}, @code{GL_UNSIGNED_INT},
-@code{GL_FLOAT}, or @code{GL_DOUBLE} are accepted. The initial value is
+@code{GL_FLOAT}, or @code{GL_DOUBLE} are accepted. The initial value is
@code{GL_FLOAT}.
@item @var{stride}
-Specifies the byte offset between consecutive colors. If @var{stride}
-is 0, the colors are understood to be tightly packed in the array. The
+Specifies the byte offset between consecutive colors. If @var{stride} is
+0, the colors are understood to be tightly packed in the array. The
initial value is 0.
@item @var{pointer}
Specifies a pointer to the first component of the first color element in
-the array. The initial value is 0.
+the array. The initial value is 0.
@end table
@code{glSecondaryColorPointer} specifies the location and data format of
-an array of color components to use when rendering. @var{size}
-specifies the number of components per color, and must be 3. @var{type}
-specifies the data type of each color component, and @var{stride}
-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.
+an array of color components to use when rendering. @var{size} specifies
+the number of components per color, and must be 3. @var{type} specifies
+the data type of each color component, and @var{stride} 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.
If a non-zero named buffer object is bound to the @code{GL_ARRAY_BUFFER}
target (see @code{glBindBuffer}) while a secondary color array is
specified, @var{pointer} is treated as a byte offset into the buffer
-object's data store. Also, the buffer object binding
+object's data store. Also, the buffer object binding
(@code{GL_ARRAY_BUFFER_BINDING}) is saved as secondary color vertex
array client-side state
(@code{GL_SECONDARY_COLOR_ARRAY_BUFFER_BINDING}).
To enable and disable the secondary color array, call
@code{glEnableClientState} and @code{glDisableClientState} with the
-argument @code{GL_SECONDARY_COLOR_ARRAY}. If enabled, the secondary
+argument @code{GL_SECONDARY_COLOR_ARRAY}. If enabled, the secondary
color array is used when @code{glArrayElement}, @code{glDrawArrays},
@code{glMultiDrawArrays}, @code{glDrawElements},
@code{glMultiDrawElements}, or @code{glDrawRangeElements} is called.
associated with every vertex.
The secondary color is interpolated and applied to each fragment during
-rasterization when @code{GL_COLOR_SUM} is enabled. When lighting is
+rasterization when @code{GL_COLOR_SUM} is enabled. When lighting is
enabled, and @code{GL_SEPARATE_SPECULAR_COLOR} is specified, the value
of the secondary color is assigned the value computed from the specular
-term of the lighting computation. Both the primary and secondary
-current colors are applied to each fragment, regardless of the state of
-@code{GL_COLOR_SUM}, under such conditions. When
+term of the lighting computation. Both the primary and secondary current
+colors are applied to each fragment, regardless of the state of
+@code{GL_COLOR_SUM}, under such conditions. When
@code{GL_SEPARATE_SPECULAR_COLOR} is specified, the value returned from
querying the current secondary color is undefined.
@code{glSecondaryColor3b}, @code{glSecondaryColor3s}, and
@code{glSecondaryColor3i} take three signed byte, short, or long
-integers as arguments. When @strong{v} is appended to the name, the
+integers as arguments. When @strong{v} is appended to the name, the
color commands can take a pointer to an array of such values.
Color values are stored in floating-point format, with unspecified
-mantissa and exponent sizes. Unsigned integer color components, when
+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,
+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 @r{-1.0}. (Note that this mapping does not convert 0
-precisely to 0.0). Floating-point values are mapped directly.
+value maps to @r{-1.0}. (Note that this mapping does not convert 0
+precisely to 0.0). Floating-point values are mapped directly.
Neither floating-point nor signed integer values are clamped to the
-range @r{[0,1]} before the current color is updated. However, color
+range @r{[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.
@code{glSelectBuffer} has two arguments: @var{buffer} is a pointer to an
array of unsigned integers, and @var{size} indicates the size of the
-array. @var{buffer} returns values from the name stack (see
+array. @var{buffer} returns values from the name stack (see
@code{glInitNames}, @code{glLoadName}, @code{glPushName}) when the
rendering mode is @code{GL_SELECT} (see @code{glRenderMode}).
@code{glSelectBuffer} must be issued before selection mode is enabled,
and it must not be issued while the rendering mode is @code{GL_SELECT}.
A programmer can use selection to determine which primitives are drawn
-into some region of a window. The region is defined by the current
+into some region of a window. The region is defined by the current
modelview and perspective matrices.
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
+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 @code{glRenderMode} is called, a hit record is copied to
@var{buffer} if any hits have occurred since the last such event (name
-stack change or @code{glRenderMode} call). The hit record consists of
+stack change or @code{glRenderMode} 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
@r{2^32-1}, before being placed in the hit record.
An internal index into @var{buffer} is reset to 0 whenever selection
-mode is entered. Each time a hit record is copied into @var{buffer},
-the index is incremented to point to the cell just past the end of the
-block of names\(emthat is, to the next available cell If the hit record
-is larger than the number of remaining locations in @var{buffer}, 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.
+mode is entered. Each time a hit record is copied into @var{buffer}, the
+index is incremented to point to the cell just past the end of the block
+of names\(emthat is, to the next available cell If the hit record is
+larger than the number of remaining locations in @var{buffer}, 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.
To exit selection mode, call @code{glRenderMode} with an argument other
-than @code{GL_SELECT}. Whenever @code{glRenderMode} is called while the
+than @code{GL_SELECT}. Whenever @code{glRenderMode} is called while the
render mode is @code{GL_SELECT}, it returns the number of hit records
copied to @var{buffer}, resets the overflow flag and the selection
-buffer pointer, and initializes the name stack to be empty. If the
+buffer pointer, and initializes the name stack to be empty. If the
overflow bit was set when @code{glRenderMode} was called, a negative hit
record count is returned.
Must be @code{GL_SEPARABLE_2D}.
@item @var{internalformat}
-The internal format of the convolution filter kernel. The allowable
+The internal format of the convolution filter kernel. The allowable
values are @code{GL_ALPHA}, @code{GL_ALPHA4}, @code{GL_ALPHA8},
@code{GL_ALPHA12}, @code{GL_ALPHA16}, @code{GL_LUMINANCE},
@code{GL_LUMINANCE4}, @code{GL_LUMINANCE8}, @code{GL_LUMINANCE12},
@code{GL_RGB10_A2}, @code{GL_RGBA12}, or @code{GL_RGBA16}.
@item @var{width}
-The number of elements in the pixel array referenced by @var{row}. (This
+The number of elements in the pixel array referenced by @var{row}. (This
is the width of the separable filter kernel.)
@item @var{height}
(This is the height of the separable filter kernel.)
@item @var{format}
-The format of the pixel data in @var{row} and @var{column}. The
+The format of the pixel data in @var{row} and @var{column}. The
allowable values are @code{GL_RED}, @code{GL_GREEN}, @code{GL_BLUE},
@code{GL_ALPHA}, @code{GL_RGB}, @code{GL_BGR}, @code{GL_RGBA},
@code{GL_BGRA}, @code{GL_INTENSITY}, @code{GL_LUMINANCE}, and
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-The type of the pixel data in @var{row} and @var{column}. Symbolic
+The type of the pixel data in @var{row} and @var{column}. Symbolic
constants @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
Next, the R, G, B, and A components of all pixels in both arrays are
scaled by the four separable 2D @code{GL_CONVOLUTION_FILTER_SCALE}
parameters and biased by the four separable 2D
-@code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
+@code{GL_CONVOLUTION_FILTER_BIAS} parameters. (The scale and bias
parameters are set by @code{glConvolutionParameter} using the
@code{GL_SEPARABLE_2D} target and the names
@code{GL_CONVOLUTION_FILTER_SCALE} and
-@code{GL_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.
+@code{GL_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.
Each pixel is then converted to the internal format specified by
-@var{internalformat}. This conversion simply maps the component values
+@var{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
+format (red, green, blue, alpha, luminance, and intensity). The mapping
is as follows:
@table @asis
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
+format. They form two one-dimensional filter kernel images. The row
image is indexed by coordinate @var{i} starting at zero and increasing
-from left to right. Each location in the row image is derived from
-element @var{i} of @var{row}. The column image is indexed by coordinate
-@var{j} starting at zero and increasing from bottom to top. Each
+from left to right. Each location in the row image is derived from
+element @var{i} of @var{row}. The column image is indexed by coordinate
+@var{j} starting at zero and increasing from bottom to top. Each
location in the column image is derived from element @var{j} of
@var{column}.
@code{GL_POST_CONVOLUTION_c_SCALE} parameters and biased by their
corresponding @code{GL_POST_CONVOLUTION_c_BIAS} parameters (where
@var{c} takes on the values @strong{RED}, @strong{GREEN}, @strong{BLUE},
-and @strong{ALPHA}). These parameters are set by
-@code{glPixelTransfer}.
+and @strong{ALPHA}). These parameters are set by @code{glPixelTransfer}.
@code{GL_INVALID_ENUM} is generated if @var{target} is not
@code{GL_SEPARABLE_2D}.
allowable values.
@code{GL_INVALID_VALUE} is generated if @var{width} is less than zero or
-greater than the maximum supported value. This value may be queried
-with @code{glGetConvolutionParameter} using target
-@code{GL_SEPARABLE_2D} and name @code{GL_MAX_CONVOLUTION_WIDTH}.
+greater than the maximum supported value. This value may be queried with
+@code{glGetConvolutionParameter} using target @code{GL_SEPARABLE_2D} and
+name @code{GL_MAX_CONVOLUTION_WIDTH}.
@code{GL_INVALID_VALUE} is generated if @var{height} is less than zero
-or greater than the maximum supported value. This value may be queried
+or greater than the maximum supported value. This value may be queried
with @code{glGetConvolutionParameter} using target
@code{GL_SEPARABLE_2D} and name @code{GL_MAX_CONVOLUTION_HEIGHT}.
@table @asis
@item @var{mode}
-Specifies a symbolic value representing a shading technique. Accepted
-values are @code{GL_FLAT} and @code{GL_SMOOTH}. The initial value is
+Specifies a symbolic value representing a shading technique. Accepted
+values are @code{GL_FLAT} and @code{GL_SMOOTH}. The initial value is
@code{GL_SMOOTH}.
@end table
-GL primitives can have either flat or smooth shading. Smooth shading,
+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
+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
+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.
-Flat and smooth shading are indistinguishable for points. Starting when
+Flat and smooth shading are indistinguishable for points. Starting when
@code{glBegin} is issued and counting vertices and primitives from 1,
the GL gives each flat-shaded line segment @r{@var{i}} the computed
-color of vertex @r{@var{i}+1}, its second vertex. Counting similarly
+color of vertex @r{@var{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.
+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.
@end table
@code{glShaderSource} sets the source code in @var{shader} to the source
-code in the array of strings specified by @var{string}. Any source code
-previously stored in the shader object is completely replaced. The
-number of strings in the array is specified by @var{count}. If
+code in the array of strings specified by @var{string}. Any source code
+previously stored in the shader object is completely replaced. The
+number of strings in the array is specified by @var{count}. If
@var{length} is @code{NULL}, each string is assumed to be null
-terminated. If @var{length} is a value other than @code{NULL}, it
-points to an array containing a string length for each of the
-corresponding elements of @var{string}. Each element in the
-@var{length} array may contain the length of the corresponding string
-(the null character is not counted as part of the string length) or a
-value less than 0 to indicate that the string is null terminated. The
-source code strings are not scanned or parsed at this time; they are
-simply copied into the specified shader object.
+terminated. If @var{length} is a value other than @code{NULL}, it points
+to an array containing a string length for each of the corresponding
+elements of @var{string}. Each element in the @var{length} array may
+contain the length of the corresponding string (the null character is
+not counted as part of the string length) or a value less than 0 to
+indicate that the string is null terminated. The source code strings are
+not scanned or parsed at this time; they are simply copied into the
+specified shader object.
@code{GL_INVALID_VALUE} is generated if @var{shader} is not a value
generated by OpenGL.
@table @asis
@item @var{face}
-Specifies whether front and/or back stencil state is updated. Three
+Specifies whether front and/or back stencil state is updated. Three
symbolic constants are valid: @code{GL_FRONT}, @code{GL_BACK}, and
@code{GL_FRONT_AND_BACK}.
@item @var{func}
-Specifies the test function. Eight symbolic constants are valid:
+Specifies the test function. Eight symbolic constants are valid:
@code{GL_NEVER}, @code{GL_LESS}, @code{GL_LEQUAL}, @code{GL_GREATER},
@code{GL_GEQUAL}, @code{GL_EQUAL}, @code{GL_NOTEQUAL}, and
-@code{GL_ALWAYS}. The initial value is @code{GL_ALWAYS}.
+@code{GL_ALWAYS}. The initial value is @code{GL_ALWAYS}.
@item @var{ref}
-Specifies the reference value for the stencil test. @var{ref} is
-clamped to the range @r{[0,2^@var{n}-1]}, where @r{@var{n}} is the
-number of bitplanes in the stencil buffer. The initial value is 0.
+Specifies the reference value for the stencil test. @var{ref} is clamped
+to the range @r{[0,2^@var{n}-1]}, where @r{@var{n}} is the number of
+bitplanes in the stencil buffer. The initial value is 0.
@item @var{mask}
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
+stored stencil value when the test is done. The initial value is all
1's.
@end table
Stenciling, like depth-buffering, enables and disables drawing on a
-per-pixel basis. You draw into the stencil planes using GL drawing
+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
+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.
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 @code{glEnable} and
-@code{glDisable} with argument @code{GL_STENCIL_TEST}. To specify
+buffer. To enable and disable the test, call @code{glEnable} and
+@code{glDisable} with argument @code{GL_STENCIL_TEST}. To specify
actions based on the outcome of the stencil test, call
@code{glStencilOp} or @code{glStencilOpSeparate}.
set to @code{GL_FRONT_AND_BACK}.
@var{func} is a symbolic constant that determines the stencil comparison
-function. It accepts one of eight values, shown in the following list.
+function. It accepts one of eight values, shown in the following list.
@var{ref} is an integer reference value that is used in the stencil
-comparison. It is clamped to the range @r{[0,2^@var{n}-1]}, where
-@r{@var{n}} is the number of bitplanes in the stencil buffer. @var{mask}
+comparison. It is clamped to the range @r{[0,2^@var{n}-1]}, where
+@r{@var{n}} is the number of bitplanes in the stencil buffer. @var{mask}
is bitwise ANDed with both the reference value and the stored stencil
value, with the ANDed values participating in the comparison.
If @var{stencil} 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 @var{func}. Only if the
+comparison function that can be specified by @var{func}. Only if the
comparison succeeds is the pixel passed through to the next stage in the
-rasterization process (see @code{glStencilOp}). All tests treat
+rasterization process (see @code{glStencilOp}). All tests treat
@var{stencil} values as unsigned integers in the range
@r{[0,2^@var{n}-1]}, where @r{@var{n}} is the number of bitplanes in the
stencil buffer.
@table @asis
@item @var{func}
-Specifies the test function. Eight symbolic constants are valid:
+Specifies the test function. Eight symbolic constants are valid:
@code{GL_NEVER}, @code{GL_LESS}, @code{GL_LEQUAL}, @code{GL_GREATER},
@code{GL_GEQUAL}, @code{GL_EQUAL}, @code{GL_NOTEQUAL}, and
-@code{GL_ALWAYS}. The initial value is @code{GL_ALWAYS}.
+@code{GL_ALWAYS}. The initial value is @code{GL_ALWAYS}.
@item @var{ref}
-Specifies the reference value for the stencil test. @var{ref} is
-clamped to the range @r{[0,2^@var{n}-1]}, where @r{@var{n}} is the
-number of bitplanes in the stencil buffer. The initial value is 0.
+Specifies the reference value for the stencil test. @var{ref} is clamped
+to the range @r{[0,2^@var{n}-1]}, where @r{@var{n}} is the number of
+bitplanes in the stencil buffer. The initial value is 0.
@item @var{mask}
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
+stored stencil value when the test is done. The initial value is all
1's.
@end table
Stenciling, like depth-buffering, enables and disables drawing on a
-per-pixel basis. Stencil planes are first drawn into using GL drawing
+per-pixel basis. Stencil planes are first drawn into using GL drawing
primitives, then geometry and images are rendered using the stencil
-planes to mask out portions of the screen. Stenciling is typically used
+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.
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 @code{glEnable} and
-@code{glDisable} with argument @code{GL_STENCIL_TEST}. To specify
+buffer. To enable and disable the test, call @code{glEnable} and
+@code{glDisable} with argument @code{GL_STENCIL_TEST}. To specify
actions based on the outcome of the stencil test, call
@code{glStencilOp} or @code{glStencilOpSeparate}.
parameters; one affects back-facing polygons, and the other affects
front-facing polygons as well as other non-polygon primitives.
@code{glStencilFunc} sets both front and back stencil state to the same
-values. Use @code{glStencilFuncSeparate} to set front and back stencil
+values. Use @code{glStencilFuncSeparate} to set front and back stencil
state to different values.
@var{func} is a symbolic constant that determines the stencil comparison
-function. It accepts one of eight values, shown in the following list.
+function. It accepts one of eight values, shown in the following list.
@var{ref} is an integer reference value that is used in the stencil
-comparison. It is clamped to the range @r{[0,2^@var{n}-1]}, where
-@r{@var{n}} is the number of bitplanes in the stencil buffer. @var{mask}
+comparison. It is clamped to the range @r{[0,2^@var{n}-1]}, where
+@r{@var{n}} is the number of bitplanes in the stencil buffer. @var{mask}
is bitwise ANDed with both the reference value and the stored stencil
value, with the ANDed values participating in the comparison.
If @var{stencil} 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 @var{func}. Only if the
+comparison function that can be specified by @var{func}. Only if the
comparison succeeds is the pixel passed through to the next stage in the
-rasterization process (see @code{glStencilOp}). All tests treat
+rasterization process (see @code{glStencilOp}). All tests treat
@var{stencil} values as unsigned integers in the range
@r{[0,2^@var{n}-1]}, where @r{@var{n}} is the number of bitplanes in the
stencil buffer.
@item @var{mask}
Specifies a bit mask to enable and disable writing of individual bits in
-the stencil planes. Initially, the mask is all 1's.
+the stencil planes. Initially, the mask is all 1's.
@end table
@code{glStencilMaskSeparate} controls the writing of individual bits in
-the stencil planes. The least significant @r{@var{n}} bits of
+the stencil planes. The least significant @r{@var{n}} bits of
@var{mask}, where @r{@var{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.
+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.
There can be two separate @var{mask} writemasks; one affects back-facing
polygons, and the other affects front-facing polygons as well as other
-non-polygon primitives. @code{glStencilMask} sets both front and back
+non-polygon primitives. @code{glStencilMask} sets both front and back
stencil writemasks to the same values, as if
@code{glStencilMaskSeparate} were called with @var{face} set to
@code{GL_FRONT_AND_BACK}.
@table @asis
@item @var{mask}
Specifies a bit mask to enable and disable writing of individual bits in
-the stencil planes. Initially, the mask is all 1's.
+the stencil planes. Initially, the mask is all 1's.
@end table
@code{glStencilMask} controls the writing of individual bits in the
-stencil planes. The least significant @r{@var{n}} bits of @var{mask},
+stencil planes. The least significant @r{@var{n}} bits of @var{mask},
where @r{@var{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
+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.
There can be two separate @var{mask} writemasks; one affects back-facing
polygons, and the other affects front-facing polygons as well as other
-non-polygon primitives. @code{glStencilMask} sets both front and back
-stencil writemasks to the same values. Use @code{glStencilMaskSeparate}
+non-polygon primitives. @code{glStencilMask} sets both front and back
+stencil writemasks to the same values. Use @code{glStencilMaskSeparate}
to set front and back stencil writemasks to different values.
@code{GL_INVALID_OPERATION} is generated if @code{glStencilMask} is
@table @asis
@item @var{face}
-Specifies whether front and/or back stencil state is updated. Three
+Specifies whether front and/or back stencil state is updated. Three
symbolic constants are valid: @code{GL_FRONT}, @code{GL_BACK}, and
@code{GL_FRONT_AND_BACK}.
@item @var{sfail}
-Specifies the action to take when the stencil test fails. Eight
-symbolic constants are accepted: @code{GL_KEEP}, @code{GL_ZERO},
+Specifies the action to take when the stencil test fails. Eight symbolic
+constants are accepted: @code{GL_KEEP}, @code{GL_ZERO},
@code{GL_REPLACE}, @code{GL_INCR}, @code{GL_INCR_WRAP}, @code{GL_DECR},
-@code{GL_DECR_WRAP}, and @code{GL_INVERT}. The initial value is
+@code{GL_DECR_WRAP}, and @code{GL_INVERT}. The initial value is
@code{GL_KEEP}.
@item @var{dpfail}
Specifies the stencil action when the stencil test passes, but the depth
-test fails. @var{dpfail} accepts the same symbolic constants as
-@var{sfail}. The initial value is @code{GL_KEEP}.
+test fails. @var{dpfail} accepts the same symbolic constants as
+@var{sfail}. The initial value is @code{GL_KEEP}.
@item @var{dppass}
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. @var{dppass} accepts the same
-symbolic constants as @var{sfail}. The initial value is @code{GL_KEEP}.
+buffer or depth testing is not enabled. @var{dppass} accepts the same
+symbolic constants as @var{sfail}. The initial value is @code{GL_KEEP}.
@end table
Stenciling, like depth-buffering, enables and disables drawing on a
-per-pixel basis. You draw into the stencil planes using GL drawing
+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
+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.
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 @code{glEnable} and
+value. To enable and disable the test, call @code{glEnable} and
@code{glDisable} with argument @code{GL_STENCIL_TEST}; to control it,
call @code{glStencilFunc} or @code{glStencilFuncSeparate}.
to @code{GL_FRONT_AND_BACK}.
@code{glStencilOpSeparate} takes three arguments that indicate what
-happens to the stored stencil value while stenciling is enabled. If the
+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 @var{sfail} specifies what happens to the stencil buffer
-contents. The following eight actions are possible.
+contents. The following eight actions are possible.
@table @asis
@item @code{GL_KEEP}
@code{glStencilFunc}.
@item @code{GL_INCR}
-Increments the current stencil buffer value. Clamps to the maximum
+Increments the current stencil buffer value. Clamps to the maximum
representable unsigned value.
@item @code{GL_INCR_WRAP}
-Increments the current stencil buffer value. Wraps stencil buffer value
+Increments the current stencil buffer value. Wraps stencil buffer value
to zero when incrementing the maximum representable unsigned value.
@item @code{GL_DECR}
-Decrements the current stencil buffer value. Clamps to 0.
+Decrements the current stencil buffer value. Clamps to 0.
@item @code{GL_DECR_WRAP}
-Decrements the current stencil buffer value. Wraps stencil buffer value
+Decrements the current stencil buffer value. Wraps stencil buffer value
to the maximum representable unsigned value when decrementing a stencil
buffer value of zero.
@end table
-Stencil buffer values are treated as unsigned integers. When
-incremented and decremented, values are clamped to 0 and
-@r{2^@var{n}-1}, where @r{@var{n}} is the value returned by querying
-@code{GL_STENCIL_BITS}.
+Stencil buffer values are treated as unsigned integers. When incremented
+and decremented, values are clamped to 0 and @r{2^@var{n}-1}, where
+@r{@var{n}} is the value returned by querying @code{GL_STENCIL_BITS}.
The other two arguments to @code{glStencilOpSeparate} specify stencil
buffer actions that depend on whether subsequent depth buffer tests
succeed (@var{dppass}) or fail (@var{dpfail}) (see @code{glDepthFunc}).
The actions are specified using the same eight symbolic constants as
-@var{sfail}. Note that @var{dpfail} is ignored when there is no depth
-buffer, or when the depth buffer is not enabled. In these cases,
+@var{sfail}. Note that @var{dpfail} is ignored when there is no depth
+buffer, or when the depth buffer is not enabled. In these cases,
@var{sfail} and @var{dppass} specify stencil action when the stencil
test fails and passes, respectively.
@table @asis
@item @var{sfail}
-Specifies the action to take when the stencil test fails. Eight
-symbolic constants are accepted: @code{GL_KEEP}, @code{GL_ZERO},
+Specifies the action to take when the stencil test fails. Eight symbolic
+constants are accepted: @code{GL_KEEP}, @code{GL_ZERO},
@code{GL_REPLACE}, @code{GL_INCR}, @code{GL_INCR_WRAP}, @code{GL_DECR},
-@code{GL_DECR_WRAP}, and @code{GL_INVERT}. The initial value is
+@code{GL_DECR_WRAP}, and @code{GL_INVERT}. The initial value is
@code{GL_KEEP}.
@item @var{dpfail}
Specifies the stencil action when the stencil test passes, but the depth
-test fails. @var{dpfail} accepts the same symbolic constants as
-@var{sfail}. The initial value is @code{GL_KEEP}.
+test fails. @var{dpfail} accepts the same symbolic constants as
+@var{sfail}. The initial value is @code{GL_KEEP}.
@item @var{dppass}
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. @var{dppass} accepts the same
-symbolic constants as @var{sfail}. The initial value is @code{GL_KEEP}.
+buffer or depth testing is not enabled. @var{dppass} accepts the same
+symbolic constants as @var{sfail}. The initial value is @code{GL_KEEP}.
@end table
Stenciling, like depth-buffering, enables and disables drawing on a
-per-pixel basis. You draw into the stencil planes using GL drawing
+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
+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.
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 @code{glEnable} and
+value. To enable and disable the test, call @code{glEnable} and
@code{glDisable} with argument @code{GL_STENCIL_TEST}; to control it,
call @code{glStencilFunc} or @code{glStencilFuncSeparate}.
@var{dppass} parameters; one affects back-facing polygons, and the other
affects front-facing polygons as well as other non-polygon primitives.
@code{glStencilOp} sets both front and back stencil state to the same
-values. Use @code{glStencilOpSeparate} to set front and back stencil
+values. Use @code{glStencilOpSeparate} to set front and back stencil
state to different values.
@code{glStencilOp} takes three arguments that indicate what happens to
-the stored stencil value while stenciling is enabled. If the stencil
+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
-@var{sfail} specifies what happens to the stencil buffer contents. The
+@var{sfail} specifies what happens to the stencil buffer contents. The
following eight actions are possible.
@table @asis
@code{glStencilFunc}.
@item @code{GL_INCR}
-Increments the current stencil buffer value. Clamps to the maximum
+Increments the current stencil buffer value. Clamps to the maximum
representable unsigned value.
@item @code{GL_INCR_WRAP}
-Increments the current stencil buffer value. Wraps stencil buffer value
+Increments the current stencil buffer value. Wraps stencil buffer value
to zero when incrementing the maximum representable unsigned value.
@item @code{GL_DECR}
-Decrements the current stencil buffer value. Clamps to 0.
+Decrements the current stencil buffer value. Clamps to 0.
@item @code{GL_DECR_WRAP}
-Decrements the current stencil buffer value. Wraps stencil buffer value
+Decrements the current stencil buffer value. Wraps stencil buffer value
to the maximum representable unsigned value when decrementing a stencil
buffer value of zero.
@end table
-Stencil buffer values are treated as unsigned integers. When
-incremented and decremented, values are clamped to 0 and
-@r{2^@var{n}-1}, where @r{@var{n}} is the value returned by querying
-@code{GL_STENCIL_BITS}.
+Stencil buffer values are treated as unsigned integers. When incremented
+and decremented, values are clamped to 0 and @r{2^@var{n}-1}, where
+@r{@var{n}} is the value returned by querying @code{GL_STENCIL_BITS}.
The other two arguments to @code{glStencilOp} specify stencil buffer
actions that depend on whether subsequent depth buffer tests succeed
-(@var{dppass}) or fail (@var{dpfail}) (see @code{glDepthFunc}). The
+(@var{dppass}) or fail (@var{dpfail}) (see @code{glDepthFunc}). The
actions are specified using the same eight symbolic constants as
-@var{sfail}. Note that @var{dpfail} is ignored when there is no depth
-buffer, or when the depth buffer is not enabled. In these cases,
+@var{sfail}. Note that @var{dpfail} is ignored when there is no depth
+buffer, or when the depth buffer is not enabled. In these cases,
@var{sfail} and @var{dppass} specify stencil action when the stencil
test fails and passes, respectively.
@table @asis
@item @var{size}
-Specifies the number of coordinates per array element. Must be 1, 2, 3,
-or 4. The initial value is 4.
+Specifies the number of coordinates per array element. Must be 1, 2, 3,
+or 4. The initial value is 4.
@item @var{type}
-Specifies the data type of each texture coordinate. Symbolic constants
+Specifies the data type of each texture coordinate. Symbolic constants
@code{GL_SHORT}, @code{GL_INT}, @code{GL_FLOAT}, or @code{GL_DOUBLE} are
-accepted. The initial value is @code{GL_FLOAT}.
+accepted. The initial value is @code{GL_FLOAT}.
@item @var{stride}
Specifies the byte offset between consecutive texture coordinate sets.
If @var{stride} is 0, the array elements are understood to be tightly
-packed. The initial value is 0.
+packed. The initial value is 0.
@item @var{pointer}
Specifies a pointer to the first coordinate of the first texture
-coordinate set in the array. The initial value is 0.
+coordinate set in the array. The initial value is 0.
@end table
@code{glTexCoordPointer} specifies the location and data format of an
-array of texture coordinates to use when rendering. @var{size}
-specifies the number of coordinates per texture coordinate set, and must
-be 1, 2, 3, or 4. @var{type} specifies the data type of each texture
-coordinate, and @var{stride} specifies the byte stride from one texture
-coordinate set 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
-@code{glInterleavedArrays}.)
+array of texture coordinates to use when rendering. @var{size} specifies
+the number of coordinates per texture coordinate set, and must be 1, 2,
+3, or 4. @var{type} specifies the data type of each texture coordinate,
+and @var{stride} specifies the byte stride from one texture coordinate
+set 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 @code{glInterleavedArrays}.)
If a non-zero named buffer object is bound to the @code{GL_ARRAY_BUFFER}
target (see @code{glBindBuffer}) while a texture coordinate array is
specified, @var{pointer} is treated as a byte offset into the buffer
-object's data store. Also, the buffer object binding
+object's data store. Also, the buffer object binding
(@code{GL_ARRAY_BUFFER_BINDING}) is saved as texture coordinate vertex
array client-side state (@code{GL_TEXTURE_COORD_ARRAY_BUFFER_BINDING}).
To enable and disable a texture coordinate array, call
@code{glEnableClientState} and @code{glDisableClientState} with the
-argument @code{GL_TEXTURE_COORD_ARRAY}. If enabled, the texture
+argument @code{GL_TEXTURE_COORD_ARRAY}. If enabled, the texture
coordinate array is used when @code{glArrayElement},
@code{glDrawArrays}, @code{glMultiDrawArrays}, @code{glDrawElements},
@code{glMultiDrawElements}, or @code{glDrawRangeElements} is called.
@itemx @var{t}
@itemx @var{r}
@itemx @var{q}
-Specify @var{s}, @var{t}, @var{r}, and @var{q} texture coordinates. Not
+Specify @var{s}, @var{t}, @var{r}, and @var{q} texture coordinates. Not
all parameters are present in all forms of the command.
@end table
@code{glTexCoord} specifies texture coordinates in one, two, three, or
-four dimensions. @code{glTexCoord1} sets the current texture
-coordinates to @r{(@var{s},001)}; a call to @code{glTexCoord2} sets them
-to @r{(@var{s},@var{t}01)}. Similarly, @code{glTexCoord3} specifies the
+four dimensions. @code{glTexCoord1} sets the current texture coordinates
+to @r{(@var{s},001)}; a call to @code{glTexCoord2} sets them to
+@r{(@var{s},@var{t}01)}. Similarly, @code{glTexCoord3} specifies the
texture coordinates as @r{(@var{s},@var{t}@var{r}1)}, and
@code{glTexCoord4} defines all four components explicitly as
@r{(@var{s},@var{t}@var{r}@var{q})}.
The current texture coordinates are part of the data that is associated
-with each vertex and with the current raster position. Initially, the
+with each vertex and with the current raster position. Initially, the
values for @var{s}, @var{t}, @var{r}, and @var{q} are (0, 0, 0, 1).
@table @asis
@item @var{target}
-Specifies a texture environment. May be @code{GL_TEXTURE_ENV},
+Specifies a texture environment. May be @code{GL_TEXTURE_ENV},
@code{GL_TEXTURE_FILTER_CONTROL} or @code{GL_POINT_SPRITE}.
@item @var{pname}
Specifies the symbolic name of a single-valued texture environment
-parameter. May be either @code{GL_TEXTURE_ENV_MODE},
+parameter. May be either @code{GL_TEXTURE_ENV_MODE},
@code{GL_TEXTURE_LOD_BIAS}, @code{GL_COMBINE_RGB},
@code{GL_COMBINE_ALPHA}, @code{GL_SRC0_RGB}, @code{GL_SRC1_RGB},
@code{GL_SRC2_RGB}, @code{GL_SRC0_ALPHA}, @code{GL_SRC1_ALPHA},
@end table
A texture environment specifies how texture values are interpreted when
-a fragment is textured. When @var{target} is
+a fragment is textured. When @var{target} is
@code{GL_TEXTURE_FILTER_CONTROL}, @var{pname} must be
-@code{GL_TEXTURE_LOD_BIAS}. When @var{target} is @code{GL_TEXTURE_ENV},
+@code{GL_TEXTURE_LOD_BIAS}. When @var{target} is @code{GL_TEXTURE_ENV},
@var{pname} can be @code{GL_TEXTURE_ENV_MODE},
@code{GL_TEXTURE_ENV_COLOR}, @code{GL_COMBINE_RGB},
@code{GL_COMBINE_ALPHA}, @code{GL_RGB_SCALE}, @code{GL_ALPHA_SCALE},
@code{GL_SRC0_ALPHA}, @code{GL_SRC1_ALPHA}, or @code{GL_SRC2_ALPHA}.
If @var{pname} is @code{GL_TEXTURE_ENV_MODE}, then @var{params} is (or
-points to) the symbolic name of a texture function. Six texture
+points to) the symbolic name of a texture function. Six texture
functions may be specified: @code{GL_ADD}, @code{GL_MODULATE},
@code{GL_DECAL}, @code{GL_BLEND}, @code{GL_REPLACE}, or
@code{GL_COMBINE}.
The following table shows the correspondence of filtered texture values
@r{@var{R}_@var{t}}, @r{@var{G}_@var{t}}, @r{@var{B}_@var{t}},
@r{@var{A}_@var{t}}, @r{@var{L}_@var{t}}, @r{@var{I}_@var{t}} to texture
-source components. @r{@var{C}_@var{s}} and @r{@var{A}_@var{s}} are used
+source components. @r{@var{C}_@var{s}} and @r{@var{A}_@var{s}} are used
by the texture functions described below.
A texture function acts on the fragment to be textured using the texture
image value that applies to the fragment (see @code{glTexParameter}) and
-produces an RGBA color for that fragment. The following table shows how
+produces an RGBA color for that fragment. The following table shows how
the RGBA color is produced for each of the first five texture functions
-that can be chosen. @r{@var{C}} is a triple of color values (RGB) and
-@r{@var{A}} is the associated alpha value. RGBA values extracted from a
-texture image are in the range [0,1]. The subscript @r{@var{p}} refers
+that can be chosen. @r{@var{C}} is a triple of color values (RGB) and
+@r{@var{A}} is the associated alpha value. RGBA values extracted from a
+texture image are in the range [0,1]. The subscript @r{@var{p}} refers
to the color computed from the previous texture stage (or the incoming
fragment if processing texture stage 0), the subscript @r{@var{s}} to
the texture source color, the subscript @r{@var{c}} to the texture
The following describes how the texture sources, as specified by
@code{GL_SRC0_RGB}, @code{GL_SRC1_RGB}, @code{GL_SRC2_RGB},
@code{GL_SRC0_ALPHA}, @code{GL_SRC1_ALPHA}, and @code{GL_SRC2_ALPHA},
-are combined to produce a final texture color. In the following tables,
+are combined to produce a final texture color. In the following tables,
@code{GL_SRC0_c} is represented by @r{@var{Arg0}}, @code{GL_SRC1_c} is
represented by @r{@var{Arg1}}, and @code{GL_SRC2_c} is represented by
@r{@var{Arg2}}.
Likewise, @code{GL_COMBINE_ALPHA} accepts any of @code{GL_REPLACE},
@code{GL_MODULATE}, @code{GL_ADD}, @code{GL_ADD_SIGNED},
-@code{GL_INTERPOLATE}, or @code{GL_SUBTRACT}. The following table
+@code{GL_INTERPOLATE}, or @code{GL_SUBTRACT}. The following table
describes how alpha values are combined:
and clamped to the range @r{[0,1]}.
If @var{pname} is @code{GL_TEXTURE_ENV_COLOR}, @var{params} is a pointer
-to an array that holds an RGBA color consisting of four values. Integer
+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
+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.
@r{@var{C}_@var{c}} takes these four values.
If @var{target} is @code{GL_POINT_SPRITE} and @var{pname} is
@code{GL_COORD_REPLACE}, the boolean value specified is used to either
-enable or disable point sprite texture coordinate replacement. The
+enable or disable point sprite texture coordinate replacement. The
default value is @code{GL_FALSE}.
@code{GL_INVALID_ENUM} is generated when @var{target} or @var{pname} is
@table @asis
@item @var{coord}
-Specifies a texture coordinate. Must be one of @code{GL_S},
-@code{GL_T}, @code{GL_R}, or @code{GL_Q}.
+Specifies a texture coordinate. Must be one of @code{GL_S}, @code{GL_T},
+@code{GL_R}, or @code{GL_Q}.
@item @var{pname}
Specifies the symbolic name of the texture-coordinate generation
-function. Must be @code{GL_TEXTURE_GEN_MODE}.
+function. Must be @code{GL_TEXTURE_GEN_MODE}.
@item @var{param}
Specifies a single-valued texture generation parameter, one of
@end table
@code{glTexGen} selects a texture-coordinate generation function or
-supplies coefficients for one of the functions. @var{coord} names one
-of the (@var{s}, @var{t}, @var{r}, @var{q}) texture coordinates; it must
-be one of the symbols @code{GL_S}, @code{GL_T}, @code{GL_R}, or
-@code{GL_Q}. @var{pname} must be one of three symbolic constants:
+supplies coefficients for one of the functions. @var{coord} names one of
+the (@var{s}, @var{t}, @var{r}, @var{q}) texture coordinates; it must be
+one of the symbols @code{GL_S}, @code{GL_T}, @code{GL_R}, or
+@code{GL_Q}. @var{pname} must be one of three symbolic constants:
@code{GL_TEXTURE_GEN_MODE}, @code{GL_OBJECT_PLANE}, or
-@code{GL_EYE_PLANE}. If @var{pname} is @code{GL_TEXTURE_GEN_MODE}, then
+@code{GL_EYE_PLANE}. If @var{pname} is @code{GL_TEXTURE_GEN_MODE}, then
@var{params} chooses a mode, one of @code{GL_OBJECT_LINEAR},
@code{GL_EYE_LINEAR}, @code{GL_SPHERE_MAP}, @code{GL_NORMAL_MAP}, or
-@code{GL_REFLECTION_MAP}. If @var{pname} is either
+@code{GL_REFLECTION_MAP}. If @var{pname} is either
@code{GL_OBJECT_PLANE} or @code{GL_EYE_PLANE}, @var{params} contains
coefficients for the corresponding texture generation function.
named in @var{coord}, @r{@var{p}_1}, @r{@var{p}_2}, @r{@var{p}_3}, and
@r{@var{p}_4} are the four values supplied in @var{params}, and
@r{@var{x}_@var{o}}, @r{@var{y}_@var{o}}, @r{@var{z}_@var{o}}, and
-@r{@var{w}_@var{o}} are the object coordinates of the vertex. This
+@r{@var{w}_@var{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 @r{@var{p}_1}, @r{@var{p}_2},
-@r{@var{p}_3}, and @r{@var{p}_4}). The altitude of a terrain vertex is
+@r{@var{p}_3}, and @r{@var{p}_4}). The altitude of a terrain vertex is
computed by the @code{GL_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
@r{@var{w}_@var{e}} are the eye coordinates of the vertex,
@r{@var{p}_1}, @r{@var{p}_2}, @r{@var{p}_3}, and @r{@var{p}_4} are the
values supplied in @var{params}, and @r{@var{M}} is the modelview matrix
-when @code{glTexGen} is invoked. If @r{@var{M}} is poorly conditioned
-or singular, texture coordinates generated by the resulting function may
-be inaccurate or undefined.
+when @code{glTexGen} is invoked. If @r{@var{M}} is poorly conditioned or
+singular, texture coordinates generated by the resulting function may be
+inaccurate or undefined.
Note that the values in @var{params} 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
+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.
If the texture generation function is @code{GL_SPHERE_MAP} and
@var{coord} is either @code{GL_S} or @code{GL_T}, @r{@var{s}} and
-@r{@var{t}} texture coordinates are generated as follows. Let @var{u}
-be the unit vector pointing from the origin to the polygon vertex (in
-eye coordinates). Let @var{n} sup prime be the current normal, after
-transformation to eye coordinates. Let
+@r{@var{t}} texture coordinates are generated as follows. Let @var{u} be
+the unit vector pointing from the origin to the polygon vertex (in eye
+coordinates). Let @var{n} sup prime be the current normal, after
+transformation to eye coordinates. Let
@r{@var{f}=(@var{f}_@var{x}@var{f}_@var{y}@var{f}_@var{z},)^@var{T}}
be the reflection vector such that
@code{glEnable} or @code{glDisable} with one of the symbolic
texture-coordinate names (@code{GL_TEXTURE_GEN_S},
@code{GL_TEXTURE_GEN_T}, @code{GL_TEXTURE_GEN_R}, or
-@code{GL_TEXTURE_GEN_Q}) as the argument. When enabled, the specified
+@code{GL_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
-@code{GL_EYE_LINEAR} and are disabled. Both @r{@var{s}} plane equations
+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
+@code{GL_EYE_LINEAR} and are disabled. Both @r{@var{s}} plane equations
are (1, 0, 0, 0), both @r{@var{t}} plane equations are (0, 1, 0, 0), and
all @r{@var{r}} and @r{@var{q}} plane equations are (0, 0, 0, 0).
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_1D} or
+Specifies the target texture. Must be @code{GL_TEXTURE_1D} or
@code{GL_PROXY_TEXTURE_1D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{internalFormat}
-Specifies the number of color components in the texture. Must be 1, 2,
+Specifies the number of color components in the texture. Must be 1, 2,
3, or 4, or one of the following symbolic constants: @code{GL_ALPHA},
@code{GL_ALPHA4}, @code{GL_ALPHA8}, @code{GL_ALPHA12},
@code{GL_ALPHA16}, @code{GL_COMPRESSED_ALPHA},
@code{GL_SRGB_ALPHA}, or @code{GL_SRGB8_ALPHA8}.
@item @var{width}
-Specifies the width of the texture image including the border if any. If
+Specifies the width of the texture image including the border if any. If
the GL version does not support non-power-of-two sizes, this value must
-be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
+be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
implementations support texture images that are at least 64 texels wide.
The height of the 1D texture image is 1.
@item @var{border}
-Specifies the width of the border. Must be either 0 or 1.
+Specifies the width of the border. Must be either 0 or 1.
@item @var{format}
-Specifies the format of the pixel data. The following symbolic values
+Specifies the format of the pixel data. The following symbolic values
are accepted: @code{GL_COLOR_INDEX}, @code{GL_RED}, @code{GL_GREEN},
@code{GL_BLUE}, @code{GL_ALPHA}, @code{GL_RGB}, @code{GL_BGR},
@code{GL_RGBA}, @code{GL_BGRA}, @code{GL_LUMINANCE}, and
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type of the pixel data. The following symbolic
-values are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE},
-@code{GL_BITMAP}, @code{GL_UNSIGNED_SHORT}, @code{GL_SHORT},
-@code{GL_UNSIGNED_INT}, @code{GL_INT}, @code{GL_FLOAT},
-@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
-@code{GL_UNSIGNED_SHORT_5_6_5}, @code{GL_UNSIGNED_SHORT_5_6_5_REV},
-@code{GL_UNSIGNED_SHORT_4_4_4_4}, @code{GL_UNSIGNED_SHORT_4_4_4_4_REV},
-@code{GL_UNSIGNED_SHORT_5_5_5_1}, @code{GL_UNSIGNED_SHORT_1_5_5_5_REV},
-@code{GL_UNSIGNED_INT_8_8_8_8}, @code{GL_UNSIGNED_INT_8_8_8_8_REV},
-@code{GL_UNSIGNED_INT_10_10_10_2}, and
-@code{GL_UNSIGNED_INT_2_10_10_10_REV}.
+Specifies the data type of the pixel data. The following symbolic values
+are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
+@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
+@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
+@code{GL_UNSIGNED_BYTE_2_3_3_REV}, @code{GL_UNSIGNED_SHORT_5_6_5},
+@code{GL_UNSIGNED_SHORT_5_6_5_REV}, @code{GL_UNSIGNED_SHORT_4_4_4_4},
+@code{GL_UNSIGNED_SHORT_4_4_4_4_REV}, @code{GL_UNSIGNED_SHORT_5_5_5_1},
+@code{GL_UNSIGNED_SHORT_1_5_5_5_REV}, @code{GL_UNSIGNED_INT_8_8_8_8},
+@code{GL_UNSIGNED_INT_8_8_8_8_REV}, @code{GL_UNSIGNED_INT_10_10_10_2},
+and @code{GL_UNSIGNED_INT_2_10_10_10_REV}.
@item @var{data}
Specifies a pointer to the image data in memory.
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable one-dimensional texturing, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_1D}.
-Texture images are defined with @code{glTexImage1D}. The arguments
+Texture images are defined with @code{glTexImage1D}. The arguments
describe the parameters of the texture image, such as width, width of
the border, level-of-detail number (see @code{glTexParameter}), and the
-internal resolution and format used to store the image. The last three
+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 @code{glDrawPixels}.
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 @code{glGetError}). To query for an entire mipmap array, use
+error (see @code{glGetError}). To query for an entire mipmap array, use
an image array level greater than or equal to 1.
If @var{target} is @code{GL_TEXTURE_1D}, data is read from @var{data} as
a sequence of signed or unsigned bytes, shorts, or longs, or
-single-precision floating-point values, depending on @var{type}. These
+single-precision floating-point values, depending on @var{type}. These
values are grouped into sets of one, two, three, or four values,
-depending on @var{format}, to form elements. If @var{type} is
+depending on @var{format}, to form elements. If @var{type} is
@code{GL_BITMAP}, the data is considered as a string of unsigned bytes
-(and @var{format} must be @code{GL_COLOR_INDEX}). Each data byte is
+(and @var{format} must be @code{GL_COLOR_INDEX}). Each data byte is
treated as eight 1-bit elements, with bit ordering determined by
@code{GL_UNPACK_LSB_FIRST} (see @code{glPixelStore}).
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
+in the texture array. The final element corresponds to the right end of
the texture array.
@var{format} determines the composition of each element in @var{data}.
@table @asis
@item @code{GL_COLOR_INDEX}
-Each element is a single value, a color index. The GL converts it to
+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
@code{GL_INDEX_SHIFT}, and added to @code{GL_INDEX_OFFSET} (see
-@code{glPixelTransfer}). The resulting index is converted to a set of
+@code{glPixelTransfer}). The resulting index is converted to a set of
color components using the @code{GL_PIXEL_MAP_I_TO_R},
@code{GL_PIXEL_MAP_I_TO_G}, @code{GL_PIXEL_MAP_I_TO_B}, and
@code{GL_PIXEL_MAP_I_TO_A} tables, and clamped to the range [0,1].
@item @code{GL_RED}
-Each element is a single red component. The GL converts it to floating
+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
+blue, and 1 for alpha. Each component is then multiplied by the signed
scale factor @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_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 @code{GL_c_SCALE}, added to the signed bias
+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 @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_BLUE}
-Each element is a single blue component. The GL converts it to floating
+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
+green, and 1 for alpha. Each component is then multiplied by the signed
scale factor @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_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 @code{GL_c_SCALE}, added to the signed bias
-@code{GL_c_BIAS}, and clamped to the range [0,1] (see
-@code{glPixelTransfer}).
+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 @code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
+clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_INTENSITY}
-Each element is a single intensity value. The GL converts it to
-floating point, then assembles it into an RGBA element by replicating
-the intensity value three times for red, green, blue, and alpha. Each
+Each element is a single intensity value. The GL converts it to floating
+point, then assembles it into an RGBA element by replicating the
+intensity value three times for red, green, blue, and alpha. Each
component is then multiplied by the signed scale factor
@code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_RGB}
@item @code{GL_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
+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
@code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_RGBA}
@item @code{GL_BGRA}
-Each element contains all four components. Each component is multiplied
+Each element contains all four components. Each component is multiplied
by the signed scale factor @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_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
+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
@code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_LUMINANCE_ALPHA}
-Each element is a luminance/alpha pair. The GL converts it to floating
+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
+luminance value three times for red, green, and blue. Each component is
then multiplied by the signed scale factor @code{GL_c_SCALE}, added to
the signed bias @code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_DEPTH_COMPONENT}
-Each element is a single depth value. The GL converts it to floating
+Each element is a single depth value. The GL converts it to floating
point, multiplies by the signed scale factor @code{GL_DEPTH_SCALE}, adds
the signed bias @code{GL_DEPTH_BIAS}, and clamps to the range [0,1] (see
@code{glPixelTransfer}).
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
-@var{internalFormat}. The GL will choose an internal representation
-that closely approximates that requested by @var{internalFormat}, but it
-may not match exactly. (The representations specified by
+@var{internalFormat}. The GL will choose an internal representation that
+closely approximates that requested by @var{internalFormat}, but it may
+not match exactly. (The representations specified by
@code{GL_LUMINANCE}, @code{GL_LUMINANCE_ALPHA}, @code{GL_RGB}, and
-@code{GL_RGBA} must match exactly. The numeric values 1, 2, 3, and 4
-may also be used to specify the above representations.)
+@code{GL_RGBA} must match exactly. The numeric values 1, 2, 3, and 4 may
+also be used to specify the above representations.)
If the @var{internalFormat} parameter is one of the generic compressed
formats, @code{GL_COMPRESSED_ALPHA}, @code{GL_COMPRESSED_INTENSITY},
@code{GL_COMPRESSED_LUMINANCE}, @code{GL_COMPRESSED_LUMINANCE_ALPHA},
@code{GL_COMPRESSED_RGB}, or @code{GL_COMPRESSED_RGBA}, the GL will
replace the internal format with the symbolic constant for a specific
-internal format and compress the texture before storage. If no
+internal format and compress the texture before storage. If no
corresponding internal format is available, or the GL can not compress
that image for any reason, the internal format is instead replaced with
a corresponding base internal format.
@code{GL_SLUMINANCE}, @code{GL_SLUMINANCE8}, @code{GL_SLUMINANCE_ALPHA},
or @code{GL_SLUMINANCE8_ALPHA8}, the texture is treated as if the red,
green, blue, or luminance components are encoded in the sRGB color
-space. Any alpha component is left unchanged. The conversion from the
+space. Any alpha component is left unchanged. The conversion from the
sRGB encoded component @r{@var{c}_@var{s}} to a linear component
@r{@var{c}_@var{l}} is:
Assume @r{@var{c}_@var{s}} is the sRGB component in the range [0,1].
Use the @code{GL_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 then query this state,
-call @code{glGetTexLevelParameter}. If the texture cannot be
+format. The implementation will update and recompute its best match for
+the requested storage resolution and format. To then query this state,
+call @code{glGetTexLevelParameter}. If the texture cannot be
accommodated, texture state is set to 0.
A one-component texture image uses only the red component of the RGBA
-color from @var{data}. A two-component image uses the R and A values. A
-three-component image uses the R, G, and B values. A four-component
+color from @var{data}. 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.
Depth textures can be treated as LUMINANCE, INTENSITY or ALPHA textures
-during texture filtering and application. Image-based shadowing can be
+during texture filtering and application. Image-based shadowing can be
enabled by comparing texture r coordinates to depth texture values to
-generate a boolean result. See @code{glTexParameter} for details on
+generate a boolean result. See @code{glTexParameter} for details on
texture comparison.
@code{GL_INVALID_ENUM} is generated if @var{target} is not
@code{GL_TEXTURE_1D} or @code{GL_PROXY_TEXTURE_1D}.
@code{GL_INVALID_ENUM} is generated if @var{format} is not an accepted
-format constant. Format constants other than @code{GL_STENCIL_INDEX}
-are accepted.
+format constant. Format constants other than @code{GL_STENCIL_INDEX} are
+accepted.
@code{GL_INVALID_ENUM} is generated if @var{type} is not a type
constant.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_2D},
+Specifies the target texture. Must be @code{GL_TEXTURE_2D},
@code{GL_PROXY_TEXTURE_2D}, @code{GL_TEXTURE_CUBE_MAP_POSITIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_X},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_Y},
@code{GL_PROXY_TEXTURE_CUBE_MAP}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{internalFormat}
-Specifies the number of color components in the texture. Must be 1, 2,
+Specifies the number of color components in the texture. Must be 1, 2,
3, or 4, or one of the following symbolic constants: @code{GL_ALPHA},
@code{GL_ALPHA4}, @code{GL_ALPHA8}, @code{GL_ALPHA12},
@code{GL_ALPHA16}, @code{GL_COMPRESSED_ALPHA},
@code{GL_SRGB_ALPHA}, or @code{GL_SRGB8_ALPHA8}.
@item @var{width}
-Specifies the width of the texture image including the border if any. If
+Specifies the width of the texture image including the border if any. If
the GL version does not support non-power-of-two sizes, this value must
-be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
+be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
implementations support texture images that are at least 64 texels wide.
@item @var{height}
high.
@item @var{border}
-Specifies the width of the border. Must be either 0 or 1.
+Specifies the width of the border. Must be either 0 or 1.
@item @var{format}
-Specifies the format of the pixel data. The following symbolic values
+Specifies the format of the pixel data. The following symbolic values
are accepted: @code{GL_COLOR_INDEX}, @code{GL_RED}, @code{GL_GREEN},
@code{GL_BLUE}, @code{GL_ALPHA}, @code{GL_RGB}, @code{GL_BGR},
@code{GL_RGBA}, @code{GL_BGRA}, @code{GL_LUMINANCE}, and
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type of the pixel data. The following symbolic
-values are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE},
-@code{GL_BITMAP}, @code{GL_UNSIGNED_SHORT}, @code{GL_SHORT},
-@code{GL_UNSIGNED_INT}, @code{GL_INT}, @code{GL_FLOAT},
-@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
-@code{GL_UNSIGNED_SHORT_5_6_5}, @code{GL_UNSIGNED_SHORT_5_6_5_REV},
-@code{GL_UNSIGNED_SHORT_4_4_4_4}, @code{GL_UNSIGNED_SHORT_4_4_4_4_REV},
-@code{GL_UNSIGNED_SHORT_5_5_5_1}, @code{GL_UNSIGNED_SHORT_1_5_5_5_REV},
-@code{GL_UNSIGNED_INT_8_8_8_8}, @code{GL_UNSIGNED_INT_8_8_8_8_REV},
-@code{GL_UNSIGNED_INT_10_10_10_2}, and
-@code{GL_UNSIGNED_INT_2_10_10_10_REV}.
+Specifies the data type of the pixel data. The following symbolic values
+are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
+@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
+@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
+@code{GL_UNSIGNED_BYTE_2_3_3_REV}, @code{GL_UNSIGNED_SHORT_5_6_5},
+@code{GL_UNSIGNED_SHORT_5_6_5_REV}, @code{GL_UNSIGNED_SHORT_4_4_4_4},
+@code{GL_UNSIGNED_SHORT_4_4_4_4_REV}, @code{GL_UNSIGNED_SHORT_5_5_5_1},
+@code{GL_UNSIGNED_SHORT_1_5_5_5_REV}, @code{GL_UNSIGNED_INT_8_8_8_8},
+@code{GL_UNSIGNED_INT_8_8_8_8_REV}, @code{GL_UNSIGNED_INT_10_10_10_2},
+and @code{GL_UNSIGNED_INT_2_10_10_10_REV}.
@item @var{data}
Specifies a pointer to the image data in memory.
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call @code{glEnable} and
-@code{glDisable} with argument @code{GL_TEXTURE_2D}. To enable and
+@code{glDisable} with argument @code{GL_TEXTURE_2D}. To enable and
disable texturing using cube-mapped texture, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_CUBE_MAP}.
-To define texture images, call @code{glTexImage2D}. The arguments
+To define texture images, call @code{glTexImage2D}. The arguments
describe the parameters of the texture image, such as height, width,
width of the border, level-of-detail number (see @code{glTexParameter}),
-and number of color components provided. The last three arguments
+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 @code{glDrawPixels}.
If @var{target} is @code{GL_PROXY_TEXTURE_2D} or
@code{GL_PROXY_TEXTURE_CUBE_MAP}, no data is read from @var{data}, but
all of the texture image state is recalculated, checked for consistency,
-and checked against the implementation's capabilities. If the
+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
-@code{glGetError}). To query for an entire mipmap array, use an image
+@code{glGetError}). To query for an entire mipmap array, use an image
array level greater than or equal to 1.
If @var{target} is @code{GL_TEXTURE_2D}, or one of the
@code{GL_TEXTURE_CUBE_MAP} targets, data is read from @var{data} as a
sequence of signed or unsigned bytes, shorts, or longs, or
-single-precision floating-point values, depending on @var{type}. These
+single-precision floating-point values, depending on @var{type}. These
values are grouped into sets of one, two, three, or four values,
-depending on @var{format}, to form elements. If @var{type} is
+depending on @var{format}, to form elements. If @var{type} is
@code{GL_BITMAP}, the data is considered as a string of unsigned bytes
-(and @var{format} must be @code{GL_COLOR_INDEX}). Each data byte is
+(and @var{format} must be @code{GL_COLOR_INDEX}). Each data byte is
treated as eight 1-bit elements, with bit ordering determined by
@code{GL_UNPACK_LSB_FIRST} (see @code{glPixelStore}).
the buffer object's data store.
The first element corresponds to the lower left corner of the texture
-image. Subsequent elements progress left-to-right through the remaining
+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
+higher rows of the texture image. The final element corresponds to the
upper right corner of the texture image.
@var{format} determines the composition of each element in @var{data}.
@table @asis
@item @code{GL_COLOR_INDEX}
-Each element is a single value, a color index. The GL converts it to
+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
@code{GL_INDEX_SHIFT}, and added to @code{GL_INDEX_OFFSET} (see
-@code{glPixelTransfer}). The resulting index is converted to a set of
+@code{glPixelTransfer}). The resulting index is converted to a set of
color components using the @code{GL_PIXEL_MAP_I_TO_R},
@code{GL_PIXEL_MAP_I_TO_G}, @code{GL_PIXEL_MAP_I_TO_B}, and
@code{GL_PIXEL_MAP_I_TO_A} tables, and clamped to the range [0,1].
@item @code{GL_RED}
-Each element is a single red component. The GL converts it to floating
+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
+blue, and 1 for alpha. Each component is then multiplied by the signed
scale factor @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_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 @code{GL_c_SCALE}, added to the signed bias
+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 @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_BLUE}
-Each element is a single blue component. The GL converts it to floating
+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
+green, and 1 for alpha. Each component is then multiplied by the signed
scale factor @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_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 @code{GL_c_SCALE}, added to the signed bias
-@code{GL_c_BIAS}, and clamped to the range [0,1] (see
-@code{glPixelTransfer}).
+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 @code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
+clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_INTENSITY}
-Each element is a single intensity value. The GL converts it to
-floating point, then assembles it into an RGBA element by replicating
-the intensity value three times for red, green, blue, and alpha. Each
+Each element is a single intensity value. The GL converts it to floating
+point, then assembles it into an RGBA element by replicating the
+intensity value three times for red, green, blue, and alpha. Each
component is then multiplied by the signed scale factor
@code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_RGB}
@item @code{GL_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
+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
@code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_RGBA}
@item @code{GL_BGRA}
-Each element contains all four components. Each component is multiplied
+Each element contains all four components. Each component is multiplied
by the signed scale factor @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_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
+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
@code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_LUMINANCE_ALPHA}
-Each element is a luminance/alpha pair. The GL converts it to floating
+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
+luminance value three times for red, green, and blue. Each component is
then multiplied by the signed scale factor @code{GL_c_SCALE}, added to
the signed bias @code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_DEPTH_COMPONENT}
-Each element is a single depth value. The GL converts it to floating
+Each element is a single depth value. The GL converts it to floating
point, multiplies by the signed scale factor @code{GL_DEPTH_SCALE}, adds
the signed bias @code{GL_DEPTH_BIAS}, and clamps to the range [0,1] (see
@code{glPixelTransfer}).
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
-@var{internalFormat}. The GL will choose an internal representation
-that closely approximates that requested by @var{internalFormat}, but it
-may not match exactly. (The representations specified by
+@var{internalFormat}. The GL will choose an internal representation that
+closely approximates that requested by @var{internalFormat}, but it may
+not match exactly. (The representations specified by
@code{GL_LUMINANCE}, @code{GL_LUMINANCE_ALPHA}, @code{GL_RGB}, and
-@code{GL_RGBA} must match exactly. The numeric values 1, 2, 3, and 4
-may also be used to specify the above representations.)
+@code{GL_RGBA} must match exactly. The numeric values 1, 2, 3, and 4 may
+also be used to specify the above representations.)
If the @var{internalFormat} parameter is one of the generic compressed
formats, @code{GL_COMPRESSED_ALPHA}, @code{GL_COMPRESSED_INTENSITY},
@code{GL_COMPRESSED_LUMINANCE}, @code{GL_COMPRESSED_LUMINANCE_ALPHA},
@code{GL_COMPRESSED_RGB}, or @code{GL_COMPRESSED_RGBA}, the GL will
replace the internal format with the symbolic constant for a specific
-internal format and compress the texture before storage. If no
+internal format and compress the texture before storage. If no
corresponding internal format is available, or the GL can not compress
that image for any reason, the internal format is instead replaced with
a corresponding base internal format.
@code{GL_SLUMINANCE}, @code{GL_SLUMINANCE8}, @code{GL_SLUMINANCE_ALPHA},
or @code{GL_SLUMINANCE8_ALPHA8}, the texture is treated as if the red,
green, blue, or luminance components are encoded in the sRGB color
-space. Any alpha component is left unchanged. The conversion from the
+space. Any alpha component is left unchanged. The conversion from the
sRGB encoded component @r{@var{c}_@var{s}} to a linear component
@r{@var{c}_@var{l}} is:
Assume @r{@var{c}_@var{s}} is the sRGB component in the range [0,1].
Use the @code{GL_PROXY_TEXTURE_2D} or @code{GL_PROXY_TEXTURE_CUBE_MAP}
-target to try out a resolution and format. The implementation will
+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
-@code{glGetTexLevelParameter}. If the texture cannot be accommodated,
+and format. To then query this state, call
+@code{glGetTexLevelParameter}. If the texture cannot be accommodated,
texture state is set to 0.
A one-component texture image uses only the red component of the RGBA
-color extracted from @var{data}. A two-component image uses the R and A
-values. A three-component image uses the R, G, and B values. A
+color extracted from @var{data}. 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.
Depth textures can be treated as LUMINANCE, INTENSITY or ALPHA textures
-during texture filtering and application. Image-based shadowing can be
+during texture filtering and application. Image-based shadowing can be
enabled by comparing texture r coordinates to depth texture values to
-generate a boolean result. See @code{glTexParameter} for details on
+generate a boolean result. See @code{glTexParameter} for details on
texture comparison.
@code{GL_INVALID_ENUM} is generated if @var{target} is not
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_3D} or
+Specifies the target texture. Must be @code{GL_TEXTURE_3D} or
@code{GL_PROXY_TEXTURE_3D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @r{@var{n}} is the @r{@var{n}^@var{th}} mipmap reduction image.
@item @var{internalFormat}
-Specifies the number of color components in the texture. Must be 1, 2,
+Specifies the number of color components in the texture. Must be 1, 2,
3, or 4, or one of the following symbolic constants: @code{GL_ALPHA},
@code{GL_ALPHA4}, @code{GL_ALPHA8}, @code{GL_ALPHA12},
@code{GL_ALPHA16}, @code{GL_COMPRESSED_ALPHA},
@code{GL_SRGB_ALPHA}, or @code{GL_SRGB8_ALPHA8}.
@item @var{width}
-Specifies the width of the texture image including the border if any. If
+Specifies the width of the texture image including the border if any. If
the GL version does not support non-power-of-two sizes, this value must
-be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
+be @r{2^@var{n}+2(@var{border},)} for some integer @r{@var{n}}. All
implementations support 3D texture images that are at least 16 texels
wide.
texels high.
@item @var{depth}
-Specifies the depth of the texture image including the border if any. If
+Specifies the depth of the texture image including the border if any. If
the GL version does not support non-power-of-two sizes, this value must
-be @r{2^@var{k}+2(@var{border},)} for some integer @r{@var{k}}. All
+be @r{2^@var{k}+2(@var{border},)} for some integer @r{@var{k}}. All
implementations support 3D texture images that are at least 16 texels
deep.
@item @var{border}
-Specifies the width of the border. Must be either 0 or 1.
+Specifies the width of the border. Must be either 0 or 1.
@item @var{format}
-Specifies the format of the pixel data. The following symbolic values
+Specifies the format of the pixel data. The following symbolic values
are accepted: @code{GL_COLOR_INDEX}, @code{GL_RED}, @code{GL_GREEN},
@code{GL_BLUE}, @code{GL_ALPHA}, @code{GL_RGB}, @code{GL_BGR},
@code{GL_RGBA}, @code{GL_BGRA}, @code{GL_LUMINANCE}, and
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type of the pixel data. The following symbolic
-values are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE},
-@code{GL_BITMAP}, @code{GL_UNSIGNED_SHORT}, @code{GL_SHORT},
-@code{GL_UNSIGNED_INT}, @code{GL_INT}, @code{GL_FLOAT},
-@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
-@code{GL_UNSIGNED_SHORT_5_6_5}, @code{GL_UNSIGNED_SHORT_5_6_5_REV},
-@code{GL_UNSIGNED_SHORT_4_4_4_4}, @code{GL_UNSIGNED_SHORT_4_4_4_4_REV},
-@code{GL_UNSIGNED_SHORT_5_5_5_1}, @code{GL_UNSIGNED_SHORT_1_5_5_5_REV},
-@code{GL_UNSIGNED_INT_8_8_8_8}, @code{GL_UNSIGNED_INT_8_8_8_8_REV},
-@code{GL_UNSIGNED_INT_10_10_10_2}, and
-@code{GL_UNSIGNED_INT_2_10_10_10_REV}.
+Specifies the data type of the pixel data. The following symbolic values
+are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
+@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
+@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
+@code{GL_UNSIGNED_BYTE_2_3_3_REV}, @code{GL_UNSIGNED_SHORT_5_6_5},
+@code{GL_UNSIGNED_SHORT_5_6_5_REV}, @code{GL_UNSIGNED_SHORT_4_4_4_4},
+@code{GL_UNSIGNED_SHORT_4_4_4_4_REV}, @code{GL_UNSIGNED_SHORT_5_5_5_1},
+@code{GL_UNSIGNED_SHORT_1_5_5_5_REV}, @code{GL_UNSIGNED_INT_8_8_8_8},
+@code{GL_UNSIGNED_INT_8_8_8_8_REV}, @code{GL_UNSIGNED_INT_10_10_10_2},
+and @code{GL_UNSIGNED_INT_2_10_10_10_REV}.
@item @var{data}
Specifies a pointer to the image data in memory.
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_3D}.
-To define texture images, call @code{glTexImage3D}. The arguments
+To define texture images, call @code{glTexImage3D}. The arguments
describe the parameters of the texture image, such as height, width,
depth, width of the border, level-of-detail number (see
-@code{glTexParameter}), and number of color components provided. The
+@code{glTexParameter}), 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 @code{glDrawPixels}.
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 @code{glGetError}). To query for an entire mipmap array, use
+error (see @code{glGetError}). To query for an entire mipmap array, use
an image array level greater than or equal to 1.
If @var{target} is @code{GL_TEXTURE_3D}, data is read from @var{data} as
a sequence of signed or unsigned bytes, shorts, or longs, or
-single-precision floating-point values, depending on @var{type}. These
+single-precision floating-point values, depending on @var{type}. These
values are grouped into sets of one, two, three, or four values,
-depending on @var{format}, to form elements. If @var{type} is
+depending on @var{format}, to form elements. If @var{type} is
@code{GL_BITMAP}, the data is considered as a string of unsigned bytes
-(and @var{format} must be @code{GL_COLOR_INDEX}). Each data byte is
+(and @var{format} must be @code{GL_COLOR_INDEX}). Each data byte is
treated as eight 1-bit elements, with bit ordering determined by
@code{GL_UNPACK_LSB_FIRST} (see @code{glPixelStore}).
the buffer object's data store.
The first element corresponds to the lower left corner of the texture
-image. Subsequent elements progress left-to-right through the remaining
+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
+higher rows of the texture image. The final element corresponds to the
upper right corner of the texture image.
@var{format} determines the composition of each element in @var{data}.
@table @asis
@item @code{GL_COLOR_INDEX}
-Each element is a single value, a color index. The GL converts it to
+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
@code{GL_INDEX_SHIFT}, and added to @code{GL_INDEX_OFFSET} (see
-@code{glPixelTransfer}). The resulting index is converted to a set of
+@code{glPixelTransfer}). The resulting index is converted to a set of
color components using the @code{GL_PIXEL_MAP_I_TO_R},
@code{GL_PIXEL_MAP_I_TO_G}, @code{GL_PIXEL_MAP_I_TO_B}, and
@code{GL_PIXEL_MAP_I_TO_A} tables, and clamped to the range [0,1].
@item @code{GL_RED}
-Each element is a single red component. The GL converts it to floating
+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
+blue, and 1 for alpha. Each component is then multiplied by the signed
scale factor @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_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 @code{GL_c_SCALE}, added to the signed bias
+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 @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_BLUE}
-Each element is a single blue component. The GL converts it to floating
+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
+green, and 1 for alpha. Each component is then multiplied by the signed
scale factor @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_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 @code{GL_c_SCALE}, added to the signed bias
-@code{GL_c_BIAS}, and clamped to the range [0,1] (see
-@code{glPixelTransfer}).
+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 @code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
+clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_INTENSITY}
-Each element is a single intensity value. The GL converts it to
-floating point, then assembles it into an RGBA element by replicating
-the intensity value three times for red, green, blue, and alpha. Each
+Each element is a single intensity value. The GL converts it to floating
+point, then assembles it into an RGBA element by replicating the
+intensity value three times for red, green, blue, and alpha. Each
component is then multiplied by the signed scale factor
@code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_RGB}
@item @code{GL_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
+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
@code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_RGBA}
@item @code{GL_BGRA}
-Each element contains all four components. Each component is multiplied
+Each element contains all four components. Each component is multiplied
by the signed scale factor @code{GL_c_SCALE}, added to the signed bias
@code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
@item @code{GL_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
+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
@code{GL_c_SCALE}, added to the signed bias @code{GL_c_BIAS}, and
clamped to the range [0,1] (see @code{glPixelTransfer}).
@item @code{GL_LUMINANCE_ALPHA}
-Each element is a luminance/alpha pair. The GL converts it to floating
+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
+luminance value three times for red, green, and blue. Each component is
then multiplied by the signed scale factor @code{GL_c_SCALE}, added to
the signed bias @code{GL_c_BIAS}, and clamped to the range [0,1] (see
@code{glPixelTransfer}).
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
-@var{internalFormat}. The GL will choose an internal representation
-that closely approximates that requested by @var{internalFormat}, but it
-may not match exactly. (The representations specified by
+@var{internalFormat}. The GL will choose an internal representation that
+closely approximates that requested by @var{internalFormat}, but it may
+not match exactly. (The representations specified by
@code{GL_LUMINANCE}, @code{GL_LUMINANCE_ALPHA}, @code{GL_RGB}, and
-@code{GL_RGBA} must match exactly. The numeric values 1, 2, 3, and 4
-may also be used to specify the above representations.)
+@code{GL_RGBA} must match exactly. The numeric values 1, 2, 3, and 4 may
+also be used to specify the above representations.)
If the @var{internalFormat} parameter is one of the generic compressed
formats, @code{GL_COMPRESSED_ALPHA}, @code{GL_COMPRESSED_INTENSITY},
@code{GL_COMPRESSED_LUMINANCE}, @code{GL_COMPRESSED_LUMINANCE_ALPHA},
@code{GL_COMPRESSED_RGB}, or @code{GL_COMPRESSED_RGBA}, the GL will
replace the internal format with the symbolic constant for a specific
-internal format and compress the texture before storage. If no
+internal format and compress the texture before storage. If no
corresponding internal format is available, or the GL can not compress
that image for any reason, the internal format is instead replaced with
a corresponding base internal format.
@code{GL_SLUMINANCE}, @code{GL_SLUMINANCE8}, @code{GL_SLUMINANCE_ALPHA},
or @code{GL_SLUMINANCE8_ALPHA8}, the texture is treated as if the red,
green, blue, or luminance components are encoded in the sRGB color
-space. Any alpha component is left unchanged. The conversion from the
+space. Any alpha component is left unchanged. The conversion from the
sRGB encoded component @r{@var{c}_@var{s}} to a linear component
@r{@var{c}_@var{l}} is:
Assume @r{@var{c}_@var{s}} is the sRGB component in the range [0,1].
Use the @code{GL_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 @code{glGetTexLevelParameter}. If the texture cannot be
+format. The implementation will update and recompute its best match for
+the requested storage resolution and format. To then query this state,
+call @code{glGetTexLevelParameter}. If the texture cannot be
accommodated, texture state is set to 0.
A one-component texture image uses only the red component of the RGBA
-color extracted from @var{data}. A two-component image uses the R and A
-values. A three-component image uses the R, G, and B values. A
+color extracted from @var{data}. 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.
@code{GL_INVALID_ENUM} is generated if @var{target} is not
@code{GL_TEXTURE_3D} or @code{GL_PROXY_TEXTURE_3D}.
@code{GL_INVALID_ENUM} is generated if @var{format} is not an accepted
-format constant. Format constants other than @code{GL_STENCIL_INDEX}
-and @code{GL_DEPTH_COMPONENT} are accepted.
+format constant. Format constants other than @code{GL_STENCIL_INDEX} and
+@code{GL_DEPTH_COMPONENT} are accepted.
@code{GL_INVALID_ENUM} is generated if @var{type} is not a type
constant.
@end table
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
+surface as if the image were a decal or cellophane shrink-wrap. The
image is created in texture space, with an (@r{@var{s}}, @r{@var{t}})
-coordinate system. A texture is a one- or two-dimensional image and a
+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.
@code{glTexParameter} assigns the value or values in @var{params} to the
-texture parameter specified as @var{pname}. @var{target} defines the
+texture parameter specified as @var{pname}. @var{target} defines the
target texture, either @code{GL_TEXTURE_1D}, @code{GL_TEXTURE_2D}, or
-@code{GL_TEXTURE_3D}. The following symbols are accepted in
-@var{pname}:
+@code{GL_TEXTURE_3D}. The following symbols are accepted in @var{pname}:
@table @asis
@item @code{GL_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
+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.
A mipmap is an ordered set of arrays representing the same image at
-progressively lower resolutions. If the texture has dimensions
+progressively lower resolutions. If the texture has dimensions
@r{2^@var{n}×2^@var{m}}, there are @r{@var{max}(@var{n},@var{m})+1}
-mipmaps. The first mipmap is the original texture, with dimensions
-@r{2^@var{n}×2^@var{m}}. Each subsequent mipmap has dimensions
+mipmaps. The first mipmap is the original texture, with dimensions
+@r{2^@var{n}×2^@var{m}}. Each subsequent mipmap has dimensions
@r{2^@var{k}-1,×2^@var{l}-1,}, where @r{2^@var{k}×2^@var{l}} are the
dimensions of the previous mipmap, until either @r{@var{k}=0} or
-@r{@var{l}=0}. At that point, subsequent mipmaps have dimension
+@r{@var{l}=0}. At that point, subsequent mipmaps have dimension
@r{1×2^@var{l}-1,} or @r{2^@var{k}-1,×1} until the final mipmap, which
-has dimension @r{1×1}. To define the mipmaps, call @code{glTexImage1D},
+has dimension @r{1×1}. To define the mipmaps, call @code{glTexImage1D},
@code{glTexImage2D}, @code{glTexImage3D}, @code{glCopyTexImage1D}, or
@code{glCopyTexImage2D} with the @var{level} argument indicating the
-order of the mipmaps. Level 0 is the original texture; level
+order of the mipmaps. Level 0 is the original texture; level
@r{@var{max}(@var{n},@var{m})} is the final @r{1×1} mipmap.
@var{params} supplies a function for minifying the texture as one of the
following:
As more texture elements are sampled in the minification process, fewer
-aliasing artifacts will be apparent. While the @code{GL_NEAREST} and
+aliasing artifacts will be apparent. While the @code{GL_NEAREST} and
@code{GL_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
-@code{GL_TEXTURE_MIN_FILTER} is @code{GL_NEAREST_MIPMAP_LINEAR}.
+or ragged transitions. The initial value of @code{GL_TEXTURE_MIN_FILTER}
+is @code{GL_NEAREST_MIPMAP_LINEAR}.
@item @code{GL_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
+maps to an area less than or equal to one texture element. It sets the
texture magnification function to either @code{GL_NEAREST} or
-@code{GL_LINEAR} (see below). @code{GL_NEAREST} is generally faster
-than @code{GL_LINEAR}, but it can produce textured images with sharper
-edges because the transition between texture elements is not as smooth.
-The initial value of @code{GL_TEXTURE_MAG_FILTER} is @code{GL_LINEAR}.
+@code{GL_LINEAR} (see below). @code{GL_NEAREST} is generally faster than
+@code{GL_LINEAR}, but it can produce textured images with sharper edges
+because the transition between texture elements is not as smooth. The
+initial value of @code{GL_TEXTURE_MAG_FILTER} is @code{GL_LINEAR}.
@end table
@item @code{GL_LINEAR}
Returns the weighted average of the four texture elements that are
-closest to the center of the pixel being textured. These can include
+closest to the center of the pixel being textured. These can include
border texture elements, depending on the values of
@code{GL_TEXTURE_WRAP_S} and @code{GL_TEXTURE_WRAP_T}, and on the exact
mapping.
Chooses the two mipmaps that most closely match the size of the pixel
being textured and uses the @code{GL_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.
+from each mipmap. The final texture value is a weighted average of those
+two values.
@item @code{GL_LINEAR_MIPMAP_LINEAR}
Chooses the two mipmaps that most closely match the size of the pixel
being textured and uses the @code{GL_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
+the pixel) to produce a texture value from each mipmap. The final
texture value is a weighted average of those two values.
@end table
@item @code{GL_LINEAR}
Returns the weighted average of the four texture elements that are
-closest to the center of the pixel being textured. These can include
+closest to the center of the pixel being textured. These can include
border texture elements, depending on the values of
@code{GL_TEXTURE_WRAP_S} and @code{GL_TEXTURE_WRAP_T}, and on the exact
mapping.
@table @asis
@item @code{GL_TEXTURE_MIN_LOD}
-Sets the minimum level-of-detail parameter. This floating-point value
+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.
@table @asis
@item @code{GL_TEXTURE_MAX_LOD}
-Sets the maximum level-of-detail parameter. This floating-point value
+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.
+level). The initial value is 1000.
@end table
@table @asis
@item @code{GL_TEXTURE_BASE_LEVEL}
-Specifies the index of the lowest defined mipmap level. This is an
-integer value. The initial value is 0.
+Specifies the index of the lowest defined mipmap level. This is an
+integer value. The initial value is 0.
@end table
@table @asis
@item @code{GL_TEXTURE_MAX_LEVEL}
-Sets the index of the highest defined mipmap level. This is an integer
-value. The initial value is 1000.
+Sets the index of the highest defined mipmap level. This is an integer
+value. The initial value is 1000.
@end table
@item @code{GL_TEXTURE_WRAP_S}
Sets the wrap parameter for texture coordinate @r{@var{s}} to either
@code{GL_CLAMP}, @code{GL_CLAMP_TO_BORDER}, @code{GL_CLAMP_TO_EDGE},
-@code{GL_MIRRORED_REPEAT}, or @code{GL_REPEAT}. @code{GL_CLAMP} causes
+@code{GL_MIRRORED_REPEAT}, or @code{GL_REPEAT}. @code{GL_CLAMP} causes
@r{@var{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. @code{GL_CLAMP_TO_BORDER} causes the @r{@var{s}} coordinate to
+object. @code{GL_CLAMP_TO_BORDER} causes the @r{@var{s}} coordinate to
be clamped to the range @r{[-1/2@var{N},,1+1/2@var{N},]}, where
@r{@var{N}} is the size of the texture in the direction of
clamping.@code{GL_CLAMP_TO_EDGE} causes @r{@var{s}} coordinates to be
is the size of the texture in the direction of clamping.
@code{GL_REPEAT} causes the integer part of the @r{@var{s}} coordinate
to be ignored; the GL uses only the fractional part, thereby creating a
-repeating pattern. @code{GL_MIRRORED_REPEAT} causes the @r{@var{s}}
+repeating pattern. @code{GL_MIRRORED_REPEAT} causes the @r{@var{s}}
coordinate to be set to the fractional part of the texture coordinate if
the integer part of @r{@var{s}} is even; if the integer part of
@r{@var{s}} is odd, then the @r{@var{s}} texture coordinate is set to
@r{1-@var{frac}(@var{s},)}, where @r{@var{frac}(@var{s},)} represents
-the fractional part of @r{@var{s}}. Border texture elements are
-accessed only if wrapping is set to @code{GL_CLAMP} or
-@code{GL_CLAMP_TO_BORDER}. Initially, @code{GL_TEXTURE_WRAP_S} is set
-to @code{GL_REPEAT}.
+the fractional part of @r{@var{s}}. Border texture elements are accessed
+only if wrapping is set to @code{GL_CLAMP} or @code{GL_CLAMP_TO_BORDER}.
+Initially, @code{GL_TEXTURE_WRAP_S} is set to @code{GL_REPEAT}.
@end table
@item @code{GL_TEXTURE_WRAP_T}
Sets the wrap parameter for texture coordinate @r{@var{t}} to either
@code{GL_CLAMP}, @code{GL_CLAMP_TO_BORDER}, @code{GL_CLAMP_TO_EDGE},
-@code{GL_MIRRORED_REPEAT}, or @code{GL_REPEAT}. See the discussion
-under @code{GL_TEXTURE_WRAP_S}. Initially, @code{GL_TEXTURE_WRAP_T} is
-set to @code{GL_REPEAT}.
+@code{GL_MIRRORED_REPEAT}, or @code{GL_REPEAT}. See the discussion under
+@code{GL_TEXTURE_WRAP_S}. Initially, @code{GL_TEXTURE_WRAP_T} is set to
+@code{GL_REPEAT}.
@item @code{GL_TEXTURE_WRAP_R}
Sets the wrap parameter for texture coordinate @r{@var{r}} to either
@code{GL_CLAMP}, @code{GL_CLAMP_TO_BORDER}, @code{GL_CLAMP_TO_EDGE},
-@code{GL_MIRRORED_REPEAT}, or @code{GL_REPEAT}. See the discussion
-under @code{GL_TEXTURE_WRAP_S}. Initially, @code{GL_TEXTURE_WRAP_R} is
-set to @code{GL_REPEAT}.
+@code{GL_MIRRORED_REPEAT}, or @code{GL_REPEAT}. See the discussion under
+@code{GL_TEXTURE_WRAP_S}. Initially, @code{GL_TEXTURE_WRAP_R} is set to
+@code{GL_REPEAT}.
@item @code{GL_TEXTURE_BORDER_COLOR}
-Sets a border color. @var{params} contains four values that comprise
-the RGBA color of the texture border. Integer color components are
+Sets a border color. @var{params} 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
+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).
@item @code{GL_TEXTURE_PRIORITY}
Specifies the texture residence priority of the currently bound texture.
-Permissible values are in the range @r{[0,1]}. See
+Permissible values are in the range @r{[0,1]}. See
@code{glPrioritizeTextures} and @code{glBindTexture} for more
information.
@item @code{GL_TEXTURE_COMPARE_MODE}
Specifies the texture comparison mode for currently bound depth
-textures. That is, a texture whose internal format is
+textures. That is, a texture whose internal format is
@code{GL_DEPTH_COMPONENT_*}; see @code{glTexImage2D}) Permissible values
are:
@code{GL_TEXTURE_COMPARE_MODE} is set to @code{GL_COMPARE_R_TO_TEXTURE}.
Permissible values are: where @r{@var{r}} is the current interpolated
texture coordinate, and @r{@var{D}_@var{t}} is the depth texture value
-sampled from the currently bound depth texture. @r{@var{result}} is
+sampled from the currently bound depth texture. @r{@var{result}} is
assigned to the either the luminance, intensity, or alpha (as specified
by @code{GL_DEPTH_TEXTURE_MODE}.)
@item @code{GL_DEPTH_TEXTURE_MODE}
Specifies a single symbolic constant indicating how depth values should
-be treated during filtering and texture application. Accepted values
-are @code{GL_LUMINANCE}, @code{GL_INTENSITY}, and @code{GL_ALPHA}. The
+be treated during filtering and texture application. Accepted values are
+@code{GL_LUMINANCE}, @code{GL_INTENSITY}, and @code{GL_ALPHA}. The
initial value is @code{GL_LUMINANCE}.
@item @code{GL_GENERATE_MIPMAP}
Specifies a boolean value that indicates if all levels of a mipmap array
should be automatically updated when any modification to the base level
-mipmap is done. The initial value is @code{GL_FALSE}.
+mipmap is done. The initial value is @code{GL_FALSE}.
@end table
@item @code{GL_COMPARE_R_TO_TEXTURE}
Specifies that the interpolated and clamped @r{@var{r}} texture
coordinate should be compared to the value in the currently bound depth
-texture. See the discussion of @code{GL_TEXTURE_COMPARE_FUNC} for
-details of how the comparison is evaluated. The result of the
-comparison is assigned to luminance, intensity, or alpha (as specified
-by @code{GL_DEPTH_TEXTURE_MODE}).
+texture. See the discussion of @code{GL_TEXTURE_COMPARE_FUNC} for
+details of how the comparison is evaluated. The result of the comparison
+is assigned to luminance, intensity, or alpha (as specified by
+@code{GL_DEPTH_TEXTURE_MODE}).
@item @code{GL_NONE}
Specifies that the luminance, intensity, or alpha (as specified by
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_1D}.
+Specifies the target texture. Must be @code{GL_TEXTURE_1D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{xoffset}
Specifies the width of the texture subimage.
@item @var{format}
-Specifies the format of the pixel data. The following symbolic values
+Specifies the format of the pixel data. The following symbolic values
are accepted: @code{GL_COLOR_INDEX}, @code{GL_RED}, @code{GL_GREEN},
@code{GL_BLUE}, @code{GL_ALPHA}, @code{GL_RGB}, @code{GL_BGR},
@code{GL_RGBA}, @code{GL_BGRA}, @code{GL_LUMINANCE}, and
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type of the pixel data. The following symbolic
-values are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE},
-@code{GL_BITMAP}, @code{GL_UNSIGNED_SHORT}, @code{GL_SHORT},
-@code{GL_UNSIGNED_INT}, @code{GL_INT}, @code{GL_FLOAT},
-@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
-@code{GL_UNSIGNED_SHORT_5_6_5}, @code{GL_UNSIGNED_SHORT_5_6_5_REV},
-@code{GL_UNSIGNED_SHORT_4_4_4_4}, @code{GL_UNSIGNED_SHORT_4_4_4_4_REV},
-@code{GL_UNSIGNED_SHORT_5_5_5_1}, @code{GL_UNSIGNED_SHORT_1_5_5_5_REV},
-@code{GL_UNSIGNED_INT_8_8_8_8}, @code{GL_UNSIGNED_INT_8_8_8_8_REV},
-@code{GL_UNSIGNED_INT_10_10_10_2}, and
-@code{GL_UNSIGNED_INT_2_10_10_10_REV}.
+Specifies the data type of the pixel data. The following symbolic values
+are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
+@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
+@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
+@code{GL_UNSIGNED_BYTE_2_3_3_REV}, @code{GL_UNSIGNED_SHORT_5_6_5},
+@code{GL_UNSIGNED_SHORT_5_6_5_REV}, @code{GL_UNSIGNED_SHORT_4_4_4_4},
+@code{GL_UNSIGNED_SHORT_4_4_4_4_REV}, @code{GL_UNSIGNED_SHORT_5_5_5_1},
+@code{GL_UNSIGNED_SHORT_1_5_5_5_REV}, @code{GL_UNSIGNED_INT_8_8_8_8},
+@code{GL_UNSIGNED_INT_8_8_8_8_REV}, @code{GL_UNSIGNED_INT_10_10_10_2},
+and @code{GL_UNSIGNED_INT_2_10_10_10_REV}.
@item @var{data}
Specifies a pointer to the image data in memory.
@end table
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 @code{glEnable} and
-@code{glDisable} with argument @code{GL_TEXTURE_1D}.
+graphical primitive for which texturing is enabled. To enable or disable
+one-dimensional texturing, call @code{glEnable} and @code{glDisable}
+with argument @code{GL_TEXTURE_1D}.
@code{glTexSubImage1D} redefines a contiguous subregion of an existing
-one-dimensional texture image. The texels referenced by @var{data}
+one-dimensional texture image. The texels referenced by @var{data}
replace the portion of the existing texture array with x indices
-@var{xoffset} and @r{@var{xoffset}+@var{width}-1}, inclusive. This
+@var{xoffset} and @r{@var{xoffset}+@var{width}-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
+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.
If a non-zero named buffer object is bound to the
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_2D},
+Specifies the target texture. Must be @code{GL_TEXTURE_2D},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_X},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_X},
@code{GL_TEXTURE_CUBE_MAP_POSITIVE_Y},
@code{GL_TEXTURE_CUBE_MAP_NEGATIVE_Z}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{xoffset}
Specifies the height of the texture subimage.
@item @var{format}
-Specifies the format of the pixel data. The following symbolic values
+Specifies the format of the pixel data. The following symbolic values
are accepted: @code{GL_COLOR_INDEX}, @code{GL_RED}, @code{GL_GREEN},
@code{GL_BLUE}, @code{GL_ALPHA}, @code{GL_RGB}, @code{GL_BGR},
@code{GL_RGBA}, @code{GL_BGRA}, @code{GL_LUMINANCE}, and
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type of the pixel data. The following symbolic
-values are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE},
-@code{GL_BITMAP}, @code{GL_UNSIGNED_SHORT}, @code{GL_SHORT},
-@code{GL_UNSIGNED_INT}, @code{GL_INT}, @code{GL_FLOAT},
-@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
-@code{GL_UNSIGNED_SHORT_5_6_5}, @code{GL_UNSIGNED_SHORT_5_6_5_REV},
-@code{GL_UNSIGNED_SHORT_4_4_4_4}, @code{GL_UNSIGNED_SHORT_4_4_4_4_REV},
-@code{GL_UNSIGNED_SHORT_5_5_5_1}, @code{GL_UNSIGNED_SHORT_1_5_5_5_REV},
-@code{GL_UNSIGNED_INT_8_8_8_8}, @code{GL_UNSIGNED_INT_8_8_8_8_REV},
-@code{GL_UNSIGNED_INT_10_10_10_2}, and
-@code{GL_UNSIGNED_INT_2_10_10_10_REV}.
+Specifies the data type of the pixel data. The following symbolic values
+are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
+@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
+@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
+@code{GL_UNSIGNED_BYTE_2_3_3_REV}, @code{GL_UNSIGNED_SHORT_5_6_5},
+@code{GL_UNSIGNED_SHORT_5_6_5_REV}, @code{GL_UNSIGNED_SHORT_4_4_4_4},
+@code{GL_UNSIGNED_SHORT_4_4_4_4_REV}, @code{GL_UNSIGNED_SHORT_5_5_5_1},
+@code{GL_UNSIGNED_SHORT_1_5_5_5_REV}, @code{GL_UNSIGNED_INT_8_8_8_8},
+@code{GL_UNSIGNED_INT_8_8_8_8_REV}, @code{GL_UNSIGNED_INT_10_10_10_2},
+and @code{GL_UNSIGNED_INT_2_10_10_10_REV}.
@item @var{data}
Specifies a pointer to the image data in memory.
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_2D}.
@code{glTexSubImage2D} redefines a contiguous subregion of an existing
-two-dimensional texture image. The texels referenced by @var{data}
+two-dimensional texture image. The texels referenced by @var{data}
replace the portion of the existing texture array with x indices
@var{xoffset} and @r{@var{xoffset}+@var{width}-1}, inclusive, and y
indices @var{yoffset} and @r{@var{yoffset}+@var{height}-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
+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.
@r{(@var{yoffset}+@var{height},)>(@var{h}-@var{b},)}, where @r{@var{w}}
is the @code{GL_TEXTURE_WIDTH}, @r{@var{h}} is the
@code{GL_TEXTURE_HEIGHT}, and @r{@var{b}} is the border width of the
-texture image being modified. Note that @r{@var{w}} and @r{@var{h}}
+texture image being modified. Note that @r{@var{w}} and @r{@var{h}}
include twice the border width.
@code{GL_INVALID_VALUE} is generated if @var{width} or @var{height} is
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GL_TEXTURE_3D}.
+Specifies the target texture. Must be @code{GL_TEXTURE_3D}.
@item @var{level}
-Specifies the level-of-detail number. Level 0 is the base image level.
+Specifies the level-of-detail number. Level 0 is the base image level.
Level @var{n} is the @var{n}th mipmap reduction image.
@item @var{xoffset}
Specifies the depth of the texture subimage.
@item @var{format}
-Specifies the format of the pixel data. The following symbolic values
+Specifies the format of the pixel data. The following symbolic values
are accepted: @code{GL_COLOR_INDEX}, @code{GL_RED}, @code{GL_GREEN},
@code{GL_BLUE}, @code{GL_ALPHA}, @code{GL_RGB}, @code{GL_BGR},
@code{GL_RGBA}, @code{GL_BGRA}, @code{GL_LUMINANCE}, and
@code{GL_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type of the pixel data. The following symbolic
-values are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE},
-@code{GL_BITMAP}, @code{GL_UNSIGNED_SHORT}, @code{GL_SHORT},
-@code{GL_UNSIGNED_INT}, @code{GL_INT}, @code{GL_FLOAT},
-@code{GL_UNSIGNED_BYTE_3_3_2}, @code{GL_UNSIGNED_BYTE_2_3_3_REV},
-@code{GL_UNSIGNED_SHORT_5_6_5}, @code{GL_UNSIGNED_SHORT_5_6_5_REV},
-@code{GL_UNSIGNED_SHORT_4_4_4_4}, @code{GL_UNSIGNED_SHORT_4_4_4_4_REV},
-@code{GL_UNSIGNED_SHORT_5_5_5_1}, @code{GL_UNSIGNED_SHORT_1_5_5_5_REV},
-@code{GL_UNSIGNED_INT_8_8_8_8}, @code{GL_UNSIGNED_INT_8_8_8_8_REV},
-@code{GL_UNSIGNED_INT_10_10_10_2}, and
-@code{GL_UNSIGNED_INT_2_10_10_10_REV}.
+Specifies the data type of the pixel data. The following symbolic values
+are accepted: @code{GL_UNSIGNED_BYTE}, @code{GL_BYTE}, @code{GL_BITMAP},
+@code{GL_UNSIGNED_SHORT}, @code{GL_SHORT}, @code{GL_UNSIGNED_INT},
+@code{GL_INT}, @code{GL_FLOAT}, @code{GL_UNSIGNED_BYTE_3_3_2},
+@code{GL_UNSIGNED_BYTE_2_3_3_REV}, @code{GL_UNSIGNED_SHORT_5_6_5},
+@code{GL_UNSIGNED_SHORT_5_6_5_REV}, @code{GL_UNSIGNED_SHORT_4_4_4_4},
+@code{GL_UNSIGNED_SHORT_4_4_4_4_REV}, @code{GL_UNSIGNED_SHORT_5_5_5_1},
+@code{GL_UNSIGNED_SHORT_1_5_5_5_REV}, @code{GL_UNSIGNED_INT_8_8_8_8},
+@code{GL_UNSIGNED_INT_8_8_8_8_REV}, @code{GL_UNSIGNED_INT_10_10_10_2},
+and @code{GL_UNSIGNED_INT_2_10_10_10_REV}.
@item @var{data}
Specifies a pointer to the image data in memory.
@end table
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call @code{glEnable} and
@code{glDisable} with argument @code{GL_TEXTURE_3D}.
@code{glTexSubImage3D} redefines a contiguous subregion of an existing
-three-dimensional texture image. The texels referenced by @var{data}
+three-dimensional texture image. The texels referenced by @var{data}
replace the portion of the existing texture array with x indices
@var{xoffset} and @r{@var{xoffset}+@var{width}-1}, inclusive, y indices
@var{yoffset} and @r{@var{yoffset}+@var{height}-1}, inclusive, and z
indices @var{zoffset} and @r{@var{zoffset}+@var{depth}-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
+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.
@end table
@code{glTranslate} produces a translation by
-@r{(@var{x},@var{y}@var{z})}. The current matrix (see
+@r{(@var{x},@var{y}@var{z})}. The current matrix (see
@code{glMatrixMode}) is multiplied by this translation matrix, with the
product replacing the current matrix, as if @code{glMultMatrix} were
called with the following matrix for its argument:
@end table
@code{glUniform} modifies the value of a uniform variable or a uniform
-variable array. The location of the uniform variable to be modified is
+variable array. The location of the uniform variable to be modified is
specified by @var{location}, which should be a value returned by
-@code{glGetUniformLocation}. @code{glUniform} operates on the program
+@code{glGetUniformLocation}. @code{glUniform} operates on the program
object that was made part of current state by calling
@code{glUseProgram}.
The commands @code{glUniform@{1|2|3|4@}@{f|i@}} are used to change the
value of the uniform variable specified by @var{location} using the
-values passed as arguments. The number specified in the command should
+values passed as arguments. The number specified in the command should
match the number of components in the data type of the specified uniform
variable (e.g., @code{1} for float, int, bool; @code{2} for vec2, ivec2,
-bvec2, etc.). The suffix @code{f} indicates that floating-point values
+bvec2, etc.). The suffix @code{f} indicates that floating-point values
are being passed; the suffix @code{i} indicates that integer values are
being passed, and this type should also match the data type of the
-specified uniform variable. The @code{i} variants of this function
+specified uniform variable. The @code{i} variants of this function
should be used to provide values for uniform variables defined as int,
-ivec2, ivec3, ivec4, or arrays of these. The @code{f} variants should
-be used to provide values for uniform variables of type float, vec2,
-vec3, vec4, or arrays of these. Either the @code{i} or the @code{f}
-variants may be used to provide values for uniform variables of type
-bool, bvec2, bvec3, bvec4, or arrays of these. The uniform variable
-will be set to false if the input value is 0 or 0.0f, and it will be set
-to true otherwise.
+ivec2, ivec3, ivec4, or arrays of these. The @code{f} variants should be
+used to provide values for uniform variables of type float, vec2, vec3,
+vec4, or arrays of these. Either the @code{i} or the @code{f} variants
+may be used to provide values for uniform variables of type bool, bvec2,
+bvec3, bvec4, or arrays of these. The uniform variable will be set to
+false if the input value is 0 or 0.0f, and it will be set to true
+otherwise.
All active uniform variables defined in a program object are initialized
-to 0 when the program object is linked successfully. They retain the
+to 0 when the program object is linked successfully. They retain the
values assigned to them by a call to @code{glUniform } until the next
successful link operation occurs on the program object, when they are
once again initialized to 0.
The commands @code{glUniform@{1|2|3|4@}@{f|i@}v} can be used to modify a
-single uniform variable or a uniform variable array. These commands
-pass a count and a pointer to the values to be loaded into a uniform
-variable or a uniform variable array. A count of 1 should be used if
-modifying the value of a single uniform variable, and a count of 1 or
-greater can be used to modify an entire array or part of an array. When
-loading @var{n} elements starting at an arbitrary position @var{m} in a
-uniform variable array, elements @var{m} + @var{n} - 1 in the array will
-be replaced with the new values. If @var{m} + @var{n} - 1 is larger
-than the size of the uniform variable array, values for all array
-elements beyond the end of the array will be ignored. The number
-specified in the name of the command indicates the number of components
-for each element in @var{value}, and it should match the number of
-components in the data type of the specified uniform variable (e.g.,
-@code{1} for float, int, bool; @code{2} for vec2, ivec2, bvec2, etc.).
-The data type specified in the name of the command must match the data
-type for the specified uniform variable as described previously for
+single uniform variable or a uniform variable array. These commands pass
+a count and a pointer to the values to be loaded into a uniform variable
+or a uniform variable array. A count of 1 should be used if modifying
+the value of a single uniform variable, and a count of 1 or greater can
+be used to modify an entire array or part of an array. When loading
+@var{n} elements starting at an arbitrary position @var{m} in a uniform
+variable array, elements @var{m} + @var{n} - 1 in the array will be
+replaced with the new values. If @var{m} + @var{n} - 1 is larger than
+the size of the uniform variable array, values for all array elements
+beyond the end of the array will be ignored. The number specified in the
+name of the command indicates the number of components for each element
+in @var{value}, and it should match the number of components in the data
+type of the specified uniform variable (e.g., @code{1} for float, int,
+bool; @code{2} for vec2, ivec2, bvec2, etc.). The data type specified in
+the name of the command must match the data type for the specified
+uniform variable as described previously for
@code{glUniform@{1|2|3|4@}@{f|i@}}.
For uniform variable arrays, each element of the array is considered to
be of the type indicated in the name of the command (e.g.,
@code{glUniform3f} or @code{glUniform3fv} can be used to load a uniform
-variable array of type vec3). The number of elements of the uniform
+variable array of type vec3). The number of elements of the uniform
variable array to be modified is specified by @var{count}
The commands @code{glUniformMatrix@{2|3|4|2x3|3x2|2x4|4x2|3x4|4x3@}fv}
-are used to modify a matrix or an array of matrices. The numbers in the
-command name are interpreted as the dimensionality of the matrix. The
+are used to modify a matrix or an array of matrices. The numbers in the
+command name are interpreted as the dimensionality of the matrix. The
number @code{2} indicates a 2 × 2 matrix (i.e., 4 values), the number
@code{3} indicates a 3 × 3 matrix (i.e., 9 values), and the number
-@code{4} indicates a 4 × 4 matrix (i.e., 16 values). Non-square matrix
+@code{4} indicates a 4 × 4 matrix (i.e., 16 values). Non-square matrix
dimensionality is explicit, with the first number representing the
number of columns and the second number representing the number of rows.
For example, @code{2x4} indicates a 2 × 4 matrix with 2 columns and 4
-rows (i.e., 8 values). If @var{transpose} is @code{GL_FALSE}, each
-matrix is assumed to be supplied in column major order. If
+rows (i.e., 8 values). If @var{transpose} is @code{GL_FALSE}, each
+matrix is assumed to be supplied in column major order. If
@var{transpose} is @code{GL_TRUE}, each matrix is assumed to be supplied
-in row major order. The @var{count} argument indicates the number of
-matrices to be passed. A count of 1 should be used if modifying the
+in row major order. The @var{count} argument indicates the number of
+matrices to be passed. A count of 1 should be used if modifying the
value of a single matrix, and a count greater than 1 can be used to
modify an array of matrices.
@end table
@code{glUseProgram} installs the program object specified by
-@var{program} as part of current rendering state. One or more
+@var{program} as part of current rendering state. One or more
executables are created in a program object by successfully attaching
shader objects to it with @code{glAttachShader}, successfully compiling
the shader objects with @code{glCompileShader}, and successfully linking
The executable that is installed on the vertex processor is expected to
implement any or all of the desired functionality from the preceding
-list. Similarly, if an executable is installed on the fragment
+list. Similarly, if an executable is installed on the fragment
processor, the OpenGL fixed functionality will be disabled as follows.
@itemize
While a program object is in use, applications are free to modify
attached shader objects, compile attached shader objects, attach
-additional shader objects, and detach or delete shader objects. None of
+additional shader objects, and detach or delete shader objects. None of
these operations will affect the executables that are part of the
-current state. However, relinking the program object that is currently
+current state. However, relinking the program object that is currently
in use will install the program object as part of the current rendering
state if the link operation was successful (see @code{glLinkProgram} ).
If the program object currently in use is relinked unsuccessfully, its
link status will be set to @code{GL_FALSE}, but the executables and
associated state will remain part of the current state until a
-subsequent call to @code{glUseProgram} removes it from use. After it is
+subsequent call to @code{glUseProgram} removes it from use. After it is
removed from use, it cannot be made part of current state until it has
been successfully relinked.
@end table
@code{glValidateProgram} checks to see whether the executables contained
-in @var{program} can execute given the current OpenGL state. The
+in @var{program} can execute given the current OpenGL state. The
information generated by the validation process will be stored in
-@var{program}'s information log. The validation information may consist
+@var{program}'s information log. The validation information may consist
of an empty string, or it may be a string containing information about
how the current program object interacts with the rest of current OpenGL
-state. This provides a way for OpenGL implementers to convey more
+state. This provides a way for OpenGL implementers to convey more
information about why the current program is inefficient, suboptimal,
failing to execute, and so on.
The status of the validation operation will be stored as part of the
-program object's state. This value will be set to @code{GL_TRUE} if the
-validation succeeded, and @code{GL_FALSE} otherwise. It can be queried
+program object's state. This value will be set to @code{GL_TRUE} if the
+validation succeeded, and @code{GL_FALSE} otherwise. It can be queried
by calling @code{glGetProgram} with arguments @var{program} and
-@code{GL_VALIDATE_STATUS}. If validation is successful, @var{program}
-is guaranteed to execute given the current state. Otherwise,
-@var{program} is guaranteed to not execute.
+@code{GL_VALIDATE_STATUS}. If validation is successful, @var{program} is
+guaranteed to execute given the current state. Otherwise, @var{program}
+is guaranteed to not execute.
This function is typically useful only during application development.
The informational string stored in the information log is completely
Specifies the index of the generic vertex attribute to be modified.
@item @var{size}
-Specifies the number of components per generic vertex attribute. Must
-be 1, 2, 3, or 4. The initial value is 4.
+Specifies the number of components per generic vertex attribute. Must be
+1, 2, 3, or 4. The initial value is 4.
@item @var{type}
-Specifies the data type of each component in the array. Symbolic
+Specifies the data type of each component in the array. Symbolic
constants @code{GL_BYTE}, @code{GL_UNSIGNED_BYTE}, @code{GL_SHORT},
@code{GL_UNSIGNED_SHORT}, @code{GL_INT}, @code{GL_UNSIGNED_INT},
-@code{GL_FLOAT}, or @code{GL_DOUBLE} are accepted. The initial value is
+@code{GL_FLOAT}, or @code{GL_DOUBLE} are accepted. The initial value is
@code{GL_FLOAT}.
@item @var{normalized}
@item @var{stride}
Specifies the byte offset between consecutive generic vertex attributes.
If @var{stride} is 0, the generic vertex attributes are understood to be
-tightly packed in the array. The initial value is 0.
+tightly packed in the array. The initial value is 0.
@item @var{pointer}
Specifies a pointer to the first component of the first generic vertex
-attribute in the array. The initial value is 0.
+attribute in the array. The initial value is 0.
@end table
@code{glVertexAttribPointer} specifies the location and data format of
the array of generic vertex attributes at index @var{index} to use when
-rendering. @var{size} specifies the number of components per attribute
-and must be 1, 2, 3, or 4. @var{type} specifies the data type of each
+rendering. @var{size} specifies the number of components per attribute
+and must be 1, 2, 3, or 4. @var{type} specifies the data type of each
component, and @var{stride} specifies the byte stride from one attribute
to the next, allowing vertices and attributes to be packed into a single
-array or stored in separate arrays. If set to @code{GL_TRUE},
+array or stored in separate arrays. If set to @code{GL_TRUE},
@var{normalized} indicates that values stored in an integer format are
to be mapped to the range [-1,1] (for signed values) or [0,1] (for
unsigned values) when they are accessed and converted to floating point.
If a non-zero named buffer object is bound to the @code{GL_ARRAY_BUFFER}
target (see @code{glBindBuffer}) while a generic vertex attribute array
is specified, @var{pointer} is treated as a byte offset into the buffer
-object's data store. Also, the buffer object binding
+object's data store. Also, the buffer object binding
(@code{GL_ARRAY_BUFFER_BINDING}) is saved as generic vertex attribute
array client-side state (@code{GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING})
for index @var{index}.
To enable and disable a generic vertex attribute array, call
@code{glEnableVertexAttribArray} and @code{glDisableVertexAttribArray}
-with @var{index}. If enabled, the generic vertex attribute array is
-used when @code{glArrayElement}, @code{glDrawArrays},
+with @var{index}. If enabled, the generic vertex attribute array is used
+when @code{glArrayElement}, @code{glDrawArrays},
@code{glMultiDrawArrays}, @code{glDrawElements},
@code{glMultiDrawElements}, or @code{glDrawRangeElements} is called.
OpenGL defines a number of standard vertex attributes that applications
can modify with standard API entry points (color, normal, texture
-coordinates, etc.). The @code{glVertexAttrib} family of entry points
+coordinates, etc.). The @code{glVertexAttrib} family of entry points
allows an application to pass generic vertex attributes in numbered
locations.
Generic attributes are defined as four-component values that are
-organized into an array. The first entry of this array is numbered 0,
+organized into an array. The first entry of this array is numbered 0,
and the size of the array is specified by the implementation-dependent
-constant @code{GL_MAX_VERTEX_ATTRIBS}. Individual elements of this
-array can be modified with a @code{glVertexAttrib} call that specifies
-the index of the element to be modified and a value for that element.
+constant @code{GL_MAX_VERTEX_ATTRIBS}. Individual elements of this array
+can be modified with a @code{glVertexAttrib} call that specifies the
+index of the element to be modified and a value for that element.
These commands can be used to specify one, two, three, or all four
-components of the generic vertex attribute specified by @var{index}. A
+components of the generic vertex attribute specified by @var{index}. A
@code{1} in the name of the command indicates that only one value is
passed, and it will be used to modify the first component of the generic
-vertex attribute. The second and third components will be set to 0, and
-the fourth component will be set to 1. Similarly, a @code{2} in the
-name of the command indicates that values are provided for the first two
+vertex attribute. The second and third components will be set to 0, and
+the fourth component will be set to 1. Similarly, a @code{2} in the name
+of the command indicates that values are provided for the first two
components, the third component will be set to 0, and the fourth
-component will be set to 1. A @code{3} in the name of the command
+component will be set to 1. A @code{3} in the name of the command
indicates that values are provided for the first three components and
the fourth component will be set to 1, whereas a @code{4} in the name
indicates that values are provided for all four components.
The letters @code{s}, @code{f}, @code{i}, @code{d}, @code{ub},
@code{us}, and @code{ui} indicate whether the arguments are of type
short, float, int, double, unsigned byte, unsigned short, or unsigned
-int. When @code{v} is appended to the name, the commands can take a
-pointer to an array of such values. The commands containing @code{N}
+int. When @code{v} is appended to the name, the commands can take a
+pointer to an array of such values. The commands containing @code{N}
indicate that the arguments will be passed as fixed-point values that
are scaled to a normalized range according to the component conversion
-rules defined by the OpenGL specification. Signed values are understood
+rules defined by the OpenGL specification. Signed values are understood
to represent fixed-point values in the range [-1,1], and unsigned values
are understood to represent fixed-point values in the range [0,1].
OpenGL Shading Language attribute variables are allowed to be of type
-mat2, mat3, or mat4. Attributes of these types may be loaded using the
-@code{glVertexAttrib} entry points. Matrices must be loaded into
+mat2, mat3, or mat4. Attributes of these types may be loaded using the
+@code{glVertexAttrib} entry points. Matrices must be loaded into
successive generic attribute slots in column major order, with one
column of the matrix in each generic attribute slot.
A user-defined attribute variable declared in a vertex shader can be
bound to a generic attribute index by calling
-@code{glBindAttribLocation}. This allows an application to use more
-descriptive variable names in a vertex shader. A subsequent change to
+@code{glBindAttribLocation}. This allows an application to use more
+descriptive variable names in a vertex shader. A subsequent change to
the specified generic vertex attribute will be immediately reflected as
a change to the corresponding attribute variable in the vertex shader.
different program object is used.
An application may freely modify generic vertex attributes that are not
-bound to a named vertex shader attribute variable. These values are
+bound to a named vertex shader attribute variable. These values are
simply maintained as part of current state and will not be accessed by
-the vertex shader. If a generic vertex attribute bound to an attribute
+the vertex shader. If a generic vertex attribute bound to an attribute
variable in a vertex shader is not updated while the vertex shader is
executing, the vertex shader will repeatedly use the current value for
the generic vertex attribute.
The generic vertex attribute with index 0 is the same as the vertex
-position attribute previously defined by OpenGL. A @code{glVertex2},
+position attribute previously defined by OpenGL. A @code{glVertex2},
@code{glVertex3}, or @code{glVertex4} command is completely equivalent
to the corresponding @code{glVertexAttrib} command with an index
-argument of 0. A vertex shader can access generic vertex attribute 0 by
-using the built-in attribute variable @var{gl_Vertex}. There are no
-current values for generic vertex attribute 0. This is the only generic
+argument of 0. A vertex shader can access generic vertex attribute 0 by
+using the built-in attribute variable @var{gl_Vertex}. There are no
+current values for generic vertex attribute 0. This is the only generic
vertex attribute with this property; calls to set other standard vertex
attributes can be freely mixed with calls to set any of the other
generic vertex attributes.
@table @asis
@item @var{size}
-Specifies the number of coordinates per vertex. Must be 2, 3, or 4. The
+Specifies the number of coordinates per vertex. Must be 2, 3, or 4. The
initial value is 4.
@item @var{type}
-Specifies the data type of each coordinate in the array. Symbolic
+Specifies the data type of each coordinate in the array. Symbolic
constants @code{GL_SHORT}, @code{GL_INT}, @code{GL_FLOAT}, or
-@code{GL_DOUBLE} are accepted. The initial value is @code{GL_FLOAT}.
+@code{GL_DOUBLE} are accepted. The initial value is @code{GL_FLOAT}.
@item @var{stride}
-Specifies the byte offset between consecutive vertices. If @var{stride}
-is 0, the vertices are understood to be tightly packed in the array. The
+Specifies the byte offset between consecutive vertices. If @var{stride}
+is 0, the vertices are understood to be tightly packed in the array. The
initial value is 0.
@item @var{pointer}
Specifies a pointer to the first coordinate of the first vertex in the
-array. The initial value is 0.
+array. The initial value is 0.
@end table
@code{glVertexPointer} specifies the location and data format of an
-array of vertex coordinates to use when rendering. @var{size} specifies
-the number of coordinates per vertex, and must be 2, 3, or 4. @var{type}
+array of vertex coordinates to use when rendering. @var{size} specifies
+the number of coordinates per vertex, and must be 2, 3, or 4. @var{type}
specifies the data type of each coordinate, and @var{stride} 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
+arrays. (Single-array storage may be more efficient on some
implementations; see @code{glInterleavedArrays}.)
If a non-zero named buffer object is bound to the @code{GL_ARRAY_BUFFER}
target (see @code{glBindBuffer}) while a vertex array is specified,
@var{pointer} is treated as a byte offset into the buffer object's data
-store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
+store. Also, the buffer object binding (@code{GL_ARRAY_BUFFER_BINDING})
is saved as vertex array client-side state
(@code{GL_VERTEX_ARRAY_BUFFER_BINDING}).
To enable and disable the vertex array, call @code{glEnableClientState}
and @code{glDisableClientState} with the argument
-@code{GL_VERTEX_ARRAY}. If enabled, the vertex array is used when
+@code{GL_VERTEX_ARRAY}. If enabled, the vertex array is used when
@code{glArrayElement}, @code{glDrawArrays}, @code{glMultiDrawArrays},
@code{glDrawElements}, @code{glMultiDrawElements}, or
@code{glDrawRangeElements} is called.
@end table
@code{glVertex} commands are used within @code{glBegin}/@code{glEnd}
-pairs to specify point, line, and polygon vertices. The current color,
+pairs to specify point, line, and polygon vertices. The current color,
normal, texture coordinates, and fog coordinate are associated with the
vertex when @code{glVertex} is called.
When only @r{@var{x}} and @r{@var{y}} are specified, @r{@var{z}}
-defaults to 0 and @r{@var{w}} defaults to 1. When @r{@var{x}},
+defaults to 0 and @r{@var{w}} defaults to 1. When @r{@var{x}},
@r{@var{y}}, and @r{@var{z}} are specified, @r{@var{w}} defaults to 1.
@end deftypefun
@table @asis
@item @var{x}
@itemx @var{y}
-Specify the lower left corner of the viewport rectangle, in pixels. The
+Specify the lower left corner of the viewport rectangle, in pixels. The
initial value is (0,0).
@item @var{width}
@itemx @var{height}
-Specify the width and height of the viewport. When a GL context is
-first attached to a window, @var{width} and @var{height} are set to the
+Specify the width and height of the viewport. When a GL context is first
+attached to a window, @var{width} and @var{height} are set to the
dimensions of that window.
@end table
@code{glViewport} specifies the affine transformation of @r{@var{x}} and
@r{@var{y}} from normalized device coordinates to window coordinates.
Let @r{(@var{x}_@var{nd},@var{y}_@var{nd})} be normalized device
-coordinates. Then the window coordinates
+coordinates. Then the window coordinates
@r{(@var{x}_@var{w},@var{y}_@var{w})} are computed as follows:
@r{@var{x}_@var{w}=(@var{x}_@var{nd}+1,)(@var{width}/2,)+@var{x}}
@r{@var{y}_@var{w}=(@var{y}_@var{nd}+1,)(@var{height}/2,)+@var{y}}
Viewport width and height are silently clamped to a range that depends
-on the implementation. To query this range, call @code{glGet} with
+on the implementation. To query this range, call @code{glGet} with
argument @code{GL_MAX_VIEWPORT_DIMS}.
@code{GL_INVALID_VALUE} is generated if either @var{width} or
@end table
-The GL maintains a 3D position in window coordinates. This position,
+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
+operations. It is maintained with subpixel accuracy. See
@code{glBitmap}, @code{glDrawPixels}, and @code{glCopyPixels}.
@code{glWindowPos2} specifies the @r{@var{x}} and @r{@var{y}}
coordinates, while @r{@var{z}} is implicitly set to 0.
-@code{glWindowPos3} specifies all three coordinates. The @r{@var{w}}
+@code{glWindowPos3} specifies all three coordinates. The @r{@var{w}}
coordinate of the current raster position is always set to 1.0.
@code{glWindowPos} directly updates the @r{@var{x}} and @r{@var{y}}
coordinates of the current raster position with the values specified.
That is, the values are neither transformed by the current modelview and
-projection matrices, nor by the viewport-to-window transform. The
+projection matrices, nor by the viewport-to-window transform. The
@r{@var{z}} coordinate of the current raster position is updated in the
following manner:
where @r{@var{n}} is @code{GL_DEPTH_RANGE}'s near value, and @r{@var{f}}
-is @code{GL_DEPTH_RANGE}'s far value. See @code{glDepthRange}.
+is @code{GL_DEPTH_RANGE}'s far value. See @code{glDepthRange}.
The specified coordinates are not clip-tested, causing the raster
position to always be valid.
The current raster position also includes some associated color data and
-texture coordinates. If lighting is enabled, then
+texture coordinates. If lighting is enabled, then
@code{GL_CURRENT_RASTER_COLOR} (in RGBA mode) or
@code{GL_CURRENT_RASTER_INDEX} (in color index mode) is set to the color
produced by the lighting calculation (see @code{glLight},
-@code{glLightModel}, and @code{glShadeModel}). If lighting is disabled,
+@code{glLightModel}, and @code{glShadeModel}). If lighting is disabled,
current color (in RGBA mode, state variable @code{GL_CURRENT_COLOR}) or
color index (in color index mode, state variable
@code{GL_CURRENT_INDEX}) is used to update the current raster color.
Likewise, @code{GL_CURRENT_RASTER_TEXTURE_COORDS} is updated as a
function of @code{GL_CURRENT_TEXTURE_COORDS}, based on the texture
-matrix and the texture generation functions (see @code{glTexGen}). The
+matrix and the texture generation functions (see @code{glTexGen}). The
@code{GL_CURRENT_RASTER_DISTANCE} is set to the
@code{GL_CURRENT_FOG_COORD}.
@copying
This section of the manual was derived from the upstream OpenGL
-documentation. Each function's documentation has its own copyright
-statement; for full details, see the upstream documentation. The
+documentation. Each function's documentation has its own copyright
+statement; for full details, see the upstream documentation. The
copyright notices and licenses present in this section are as follows.
-Copyright @copyright{} 1991-2006 Silicon Graphics, Inc. This document
-is licensed under the SGI Free Software B License. For details, see
+Copyright @copyright{} 1991-2006 Silicon Graphics, Inc. This document is
+licensed under the SGI Free Software B License. For details, see
@uref{http://oss.sgi.com/projects/FreeB/,http://oss.sgi.com/projects/FreeB/}.
@end copying
@end table
Use @code{gluBeginCurve} to mark the beginning of a NURBS curve
-definition. After calling @code{gluBeginCurve}, make one or more calls
-to @code{gluNurbsCurve} to define the attributes of the curve. Exactly
+definition. After calling @code{gluBeginCurve}, make one or more calls
+to @code{gluNurbsCurve} to define the attributes of the curve. Exactly
one of the calls to @code{gluNurbsCurve} must have a curve type of
-@code{GLU_MAP1_VERTEX_3} or @code{GLU_MAP1_VERTEX_4}. To mark the end
-of the NURBS curve definition, call @code{gluEndCurve}.
+@code{GLU_MAP1_VERTEX_3} or @code{GLU_MAP1_VERTEX_4}. To mark the end of
+the NURBS curve definition, call @code{gluEndCurve}.
GL evaluators are used to render the NURBS curve as a series of line
-segments. Evaluator state is preserved during rendering with
-@code{glPushAttrib}(@code{GLU_EVAL_BIT}) and @code{glPopAttrib}(). See
+segments. Evaluator state is preserved during rendering with
+@code{glPushAttrib}(@code{GLU_EVAL_BIT}) and @code{glPopAttrib}(). See
the @code{glPushAttrib} reference page for details on exactly what state
these calls preserve.
@end table
@code{gluBeginPolygon} and @code{gluEndPolygon} delimit the definition
-of a nonconvex polygon. To define such a polygon, first call
-@code{gluBeginPolygon}. Then define the contours of the polygon by
+of a nonconvex polygon. To define such a polygon, first call
+@code{gluBeginPolygon}. Then define the contours of the polygon by
calling @code{gluTessVertex} for each vertex and @code{gluNextContour}
-to start each new contour. Finally, call @code{gluEndPolygon} to signal
-the end of the definition. See the @code{gluTessVertex} and
+to start each new contour. Finally, call @code{gluEndPolygon} to signal
+the end of the definition. See the @code{gluTessVertex} and
@code{gluNextContour} reference pages for more details.
Once @code{gluEndPolygon} is called, the polygon is tessellated, and the
-resulting triangles are described through callbacks. See
+resulting triangles are described through callbacks. See
@code{gluTessCallback} for descriptions of the callback functions.
@end deftypefun
@end table
Use @code{gluBeginSurface} to mark the beginning of a NURBS surface
-definition. After calling @code{gluBeginSurface}, make one or more
-calls to @code{gluNurbsSurface} to define the attributes of the surface.
+definition. After calling @code{gluBeginSurface}, make one or more calls
+to @code{gluNurbsSurface} to define the attributes of the surface.
Exactly one of these calls to @code{gluNurbsSurface} must have a surface
-type of @code{GLU_MAP2_VERTEX_3} or @code{GLU_MAP2_VERTEX_4}. To mark
+type of @code{GLU_MAP2_VERTEX_3} or @code{GLU_MAP2_VERTEX_4}. To mark
the end of the NURBS surface definition, call @code{gluEndSurface}.
Trimming of NURBS surfaces is supported with @code{gluBeginTrim},
-@code{gluPwlCurve}, @code{gluNurbsCurve}, and @code{gluEndTrim}. See
-the @code{gluBeginTrim} reference page for details.
+@code{gluPwlCurve}, @code{gluNurbsCurve}, and @code{gluEndTrim}. See the
+@code{gluBeginTrim} reference page for details.
GL evaluators are used to render the NURBS surface as a set of polygons.
Evaluator state is preserved during rendering with
-@code{glPushAttrib}(@code{GLU_EVAL_BIT}) and @code{glPopAttrib}. See
-the @code{glPushAttrib} reference page for details on exactly what state
+@code{glPushAttrib}(@code{GLU_EVAL_BIT}) and @code{glPopAttrib}. See the
+@code{glPushAttrib} reference page for details on exactly what state
these calls preserve.
@end deftypefun
@end table
Use @code{gluBeginTrim} to mark the beginning of a trimming loop and
-@code{gluEndTrim} 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
+@code{gluEndTrim} 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 @code{gluBeginSurface}
and @code{gluEndSurface}.
-The definition for a NURBS surface can contain many trimming loops. For
+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
+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
@code{gluBeginTrim}/@code{gluEndTrim} pair.
The definition of a single closed trimming loop can consist of multiple
curve segments, each described as a piecewise linear curve (see
@code{gluPwlCurve}) or as a single NURBS curve (see
-@code{gluNurbsCurve}), or as a combination of both in any order. The
+@code{gluNurbsCurve}), 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 @code{gluBeginTrim} and @code{gluEndTrim}) are
@code{gluPwlCurve} and @code{gluNurbsCurve}.
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
+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
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
+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
+coincident, they will be coerced to match. If the endpoints are not
sufficiently close, an error results (see @code{gluNurbsCallback}).
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
+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.
If no trimming information is given for a NURBS surface, the entire
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GLU_TEXTURE_1D}.
+Specifies the target texture. Must be @code{GLU_TEXTURE_1D}.
@item @var{internalFormat}
-Requests the internal storage format of the texture image. The most
+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
+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: @code{GLU_ALPHA}, @code{GLU_ALPHA4}, @code{GLU_ALPHA8},
@code{GLU_ALPHA12}, @code{GLU_ALPHA16}, @code{GLU_LUMINANCE},
@code{GLU_RGBA16}.
@item @var{width}
-Specifies the width in pixels of the texture image. This should be a
+Specifies the width in pixels of the texture image. This should be a
power of 2.
@item @var{format}
-Specifies the format of the pixel data. Must be one of:
+Specifies the format of the pixel data. Must be one of:
@code{GLU_COLOR_INDEX}, @code{GLU_DEPTH_COMPONENT}, @code{GLU_RED},
@code{GLU_GREEN}, @code{GLU_BLUE}, @code{GLU_ALPHA}, @code{GLU_RGB},
@code{GLU_RGBA}, @code{GLU_BGR}, @code{GLU_BGRA}, @code{GLU_LUMINANCE},
or @code{GLU_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type for @var{data}. Must be one of:
+Specifies the data type for @var{data}. Must be one of:
@code{GLU_UNSIGNED_BYTE}, @code{GLU_BYTE}, @code{GLU_BITMAP},
@code{GLU_UNSIGNED_SHORT}, @code{GLU_SHORT}, @code{GLU_UNSIGNED_INT},
@code{GLU_INT}, @code{GLU_FLOAT}, @code{GLU_UNSIGNED_BYTE_3_3_2},
returned (see @code{gluErrorString}).
A series of mipmap levels from @var{base} to @var{max} is built by
-decimating @var{data} in half until size @r{1×1} is reached. At each
+decimating @var{data} in half until size @r{1×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. @code{glTexImage1D}
-is called to load these mipmap levels from @var{base} to @var{max}. If
+corresponding two texels in the larger mipmap level. @code{glTexImage1D}
+is called to load these mipmap levels from @var{base} to @var{max}. If
@var{max} is larger than the highest mipmap level for the texture of the
specified size, then a GLU error code is returned (see
@code{gluErrorString}) and nothing is loaded.
For example, if @var{level} is 2 and @var{width} is 16, the following
-levels are possible: @r{16×1}, @r{8×1}, @r{4×1}, @r{2×1}, @r{1×1}. These
-correspond to levels 2 through 6 respectively. If @var{base} is 3 and
+levels are possible: @r{16×1}, @r{8×1}, @r{4×1}, @r{2×1}, @r{1×1}. These
+correspond to levels 2 through 6 respectively. If @var{base} is 3 and
@var{max} is 5, then only mipmap levels @r{8×1}, @r{4×1} and @r{2×1} are
-loaded. However, if @var{max} is 7, then an error is returned and
+loaded. However, if @var{max} is 7, then an error is returned and
nothing is loaded since @var{max} is larger than the highest mipmap
level which is, in this case, 6.
@r{@var{log}_2(@var{width}×2^@var{level},)}.
See the @code{glTexImage1D} reference page for a description of the
-acceptable values for @var{type} parameter. See the @code{glDrawPixels}
+acceptable values for @var{type} parameter. See the @code{glDrawPixels}
reference page for a description of the acceptable values for
@var{level} parameter.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GLU_TEXTURE_1D}.
+Specifies the target texture. Must be @code{GLU_TEXTURE_1D}.
@item @var{internalFormat}
-Requests the internal storage format of the texture image. The most
+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
+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: @code{GLU_ALPHA}, @code{GLU_ALPHA4}, @code{GLU_ALPHA8},
@code{GLU_ALPHA12}, @code{GLU_ALPHA16}, @code{GLU_LUMINANCE},
Specifies the width, in pixels, of the texture image.
@item @var{format}
-Specifies the format of the pixel data. Must be one of
+Specifies the format of the pixel data. Must be one of
@code{GLU_COLOR_INDEX}, @code{GLU_DEPTH_COMPONENT}, @code{GLU_RED},
@code{GLU_GREEN}, @code{GLU_BLUE}, @code{GLU_ALPHA}, @code{GLU_RGB},
@code{GLU_RGBA}, @code{GLU_BGR}, @code{GLU_BGRA}, @code{GLU_LUMINANCE},
or @code{GLU_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type for @var{data}. Must be one of
+Specifies the data type for @var{data}. Must be one of
@code{GLU_UNSIGNED_BYTE}, @code{GLU_BYTE}, @code{GLU_BITMAP},
@code{GLU_UNSIGNED_SHORT}, @code{GLU_SHORT}, @code{GLU_UNSIGNED_INT},
@code{GLU_INT}, @code{GLU_FLOAT}, @code{GLU_UNSIGNED_BYTE_3_3_2},
@end table
@code{gluBuild1DMipmaps} 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.
+texture maps of decreasing resolutions called a mipmap. This is used for
+the antialiasing of texture mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see @code{gluErrorString}).
Initially, the @var{width} of @var{data} is checked to see if it is a
-power of 2. If not, a copy of @var{data} is scaled up or down to the
-nearest power of 2. (If @var{width} is exactly between powers of 2,
-then the copy of @var{data} will scale upwards.) This copy will be used
-for subsequent mipmapping operations described below. For example, if
+power of 2. If not, a copy of @var{data} is scaled up or down to the
+nearest power of 2. (If @var{width} is exactly between powers of 2, then
+the copy of @var{data} will scale upwards.) This copy will be used for
+subsequent mipmapping operations described below. For example, if
@var{width} is 57, then a copy of @var{data} will scale up to 64 before
mipmapping takes place.
Then, proxy textures (see @code{glTexImage1D}) are used to determine if
-the implementation can fit the requested texture. If not, @var{width}
-is continually halved until it fits.
+the implementation can fit the requested texture. If not, @var{width} is
+continually halved until it fits.
Next, a series of mipmap levels is built by decimating a copy of
-@var{data} in half until size @r{1×1} is reached. At each level, each
+@var{data} in half until size @r{1×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.
-@code{glTexImage1D} is called to load each of these mipmap levels. Level
-0 is a copy of @var{data}. The highest level is
-@r{@var{log}_2,(@var{width},)}. For example, if @var{width} is 64 and
+@code{glTexImage1D} is called to load each of these mipmap levels. Level
+0 is a copy of @var{data}. The highest level is
+@r{@var{log}_2,(@var{width},)}. For example, if @var{width} is 64 and
the implementation can store a texture of this size, the following
mipmap levels are built: @r{64×1}, @r{32×1}, @r{16×1}, @r{8×1}, @r{4×1},
-@r{2×1}, and @r{1×1}. These correspond to levels 0 through 6,
+@r{2×1}, and @r{1×1}. These correspond to levels 0 through 6,
respectively.
See the @code{glTexImage1D} reference page for a description of the
-acceptable values for the @var{type} parameter. See the
+acceptable values for the @var{type} parameter. See the
@code{glDrawPixels} reference page for a description of the acceptable
values for the @var{data} parameter.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GLU_TEXTURE_2D}.
+Specifies the target texture. Must be @code{GLU_TEXTURE_2D}.
@item @var{internalFormat}
-Requests the internal storage format of the texture image. The most
+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
+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: @code{GLU_ALPHA}, @code{GLU_ALPHA4}, @code{GLU_ALPHA8},
@code{GLU_ALPHA12}, @code{GLU_ALPHA16}, @code{GLU_LUMINANCE},
@item @var{width}
@itemx @var{height}
Specifies the width and height, respectively, in pixels of the texture
-image. These should be a power of 2.
+image. These should be a power of 2.
@item @var{format}
-Specifies the format of the pixel data. Must be one of
+Specifies the format of the pixel data. Must be one of
@code{GLU_COLOR_INDEX}, @code{GLU_DEPTH_COMPONENT}, @code{GLU_RED},
@code{GLU_GREEN}, @code{GLU_BLUE}, @code{GLU_ALPHA}, @code{GLU_RGB},
@code{GLU_RGBA}, @code{GLU_BGR}, @code{GLU_BGRA}, @code{GLU_LUMINANCE},
or @code{GLU_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type for @var{data}. Must be one of
+Specifies the data type for @var{data}. Must be one of
@code{GLU_UNSIGNED_BYTE}, @code{GLU_BYTE}, @code{GLU_BITMAP},
@code{GLU_UNSIGNED_SHORT}, @code{GLU_SHORT}, @code{GLU_UNSIGNED_INT},
@code{GLU_INT}, @code{GLU_FLOAT}, @code{GLU_UNSIGNED_BYTE_3_3_2},
A series of mipmap levels from @var{base} to @var{max} is built by
decimating @var{data} in half along both dimensions until size @r{1×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
+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
-@r{@var{N}×1} or @r{1×@var{N}} configuration. Here, two texels are
+@r{@var{N}×1} or @r{1×@var{N}} configuration. Here, two texels are
averaged instead.) @code{glTexImage2D} is called to load these mipmap
-levels from @var{base} to @var{max}. If @var{max} is larger than the
+levels from @var{base} to @var{max}. If @var{max} is larger than the
highest mipmap level for the texture of the specified size, then a GLU
error code is returned (see @code{gluErrorString}) and nothing is
loaded.
For example, if @var{level} is 2 and @var{width} is 16 and @var{height}
is 8, the following levels are possible: @r{16×8}, @r{8×4}, @r{4×2},
-@r{2×1}, @r{1×1}. These correspond to levels 2 through 6 respectively.
+@r{2×1}, @r{1×1}. These correspond to levels 2 through 6 respectively.
If @var{base} is 3 and @var{max} is 5, then only mipmap levels @r{8×4},
-@r{4×2}, and @r{2×1} are loaded. However, if @var{max} is 7, then an
+@r{4×2}, and @r{2×1} are loaded. However, if @var{max} is 7, then an
error is returned and nothing is loaded since @var{max} is larger than
the highest mipmap level which is, in this case, 6.
@r{@var{log}_2(@var{max}(@var{width},@var{height})×2^@var{level},)}.
See the @code{glTexImage1D} reference page for a description of the
-acceptable values for @var{format} parameter. See the
+acceptable values for @var{format} parameter. See the
@code{glDrawPixels} reference page for a description of the acceptable
values for @var{type} parameter.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GLU_TEXTURE_2D}.
+Specifies the target texture. Must be @code{GLU_TEXTURE_2D}.
@item @var{internalFormat}
-Requests the internal storage format of the texture image. The most
+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
+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: @code{GLU_ALPHA}, @code{GLU_ALPHA4}, @code{GLU_ALPHA8},
@code{GLU_ALPHA12}, @code{GLU_ALPHA16}, @code{GLU_LUMINANCE},
image.
@item @var{format}
-Specifies the format of the pixel data. Must be one of
+Specifies the format of the pixel data. Must be one of
@code{GLU_COLOR_INDEX}, @code{GLU_DEPTH_COMPONENT}, @code{GLU_RED},
@code{GLU_GREEN}, @code{GLU_BLUE}, @code{GLU_ALPHA}, @code{GLU_RGB},
@code{GLU_RGBA}, @code{GLU_BGR}, @code{GLU_BGRA}, @code{GLU_LUMINANCE},
or @code{GLU_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type for @var{data}. Must be one of
+Specifies the data type for @var{data}. Must be one of
@code{GLU_UNSIGNED_BYTE}, @code{GLU_BYTE}, @code{GLU_BITMAP},
@code{GLU_UNSIGNED_SHORT}, @code{GLU_SHORT}, @code{GLU_UNSIGNED_INT},
@code{GLU_INT}, @code{GLU_FLOAT}, @code{GLU_UNSIGNED_BYTE_3_3_2},
@end table
@code{gluBuild2DMipmaps} 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.
+texture maps of decreasing resolutions called a mipmap. This is used for
+the antialiasing of texture-mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see @code{gluErrorString}).
Initially, the @var{width} and @var{height} of @var{data} are checked to
-see if they are a power of 2. If not, a copy of @var{data} (not
-@var{data}), is scaled up or down to the nearest power of 2. This copy
-will be used for subsequent mipmapping operations described below. (If
+see if they are a power of 2. If not, a copy of @var{data} (not
+@var{data}), is scaled up or down to the nearest power of 2. This copy
+will be used for subsequent mipmapping operations described below. (If
@var{width} or @var{height} is exactly between powers of 2, then the
copy of @var{data} will scale upwards.) For example, if @var{width} is
57 and @var{height} is 23, then a copy of @var{data} will scale up to 64
in @var{width} and down to 16 in depth, before mipmapping takes place.
Then, proxy textures (see @code{glTexImage2D}) 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
+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 @code{glGetIntegerv} with the argument
@code{GLU_MAX_TEXTURE_SIZE}.)
Next, a series of mipmap levels is built by decimating a copy of
@var{data} in half along both dimensions until size @r{1×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
+the corresponding four texels in the larger mipmap level. (In the case
of rectangular images, the decimation will ultimately reach an
-@r{@var{N}×1} or @r{1×@var{N}} configuration. Here, two texels are
+@r{@var{N}×1} or @r{1×@var{N}} configuration. Here, two texels are
averaged instead.)
-@code{glTexImage2D} is called to load each of these mipmap levels. Level
-0 is a copy of @var{data}. The highest level is
-@r{@var{log}_2,(@var{max}(@var{width},@var{height}),)}. For example,
+@code{glTexImage2D} is called to load each of these mipmap levels. Level
+0 is a copy of @var{data}. The highest level is
+@r{@var{log}_2,(@var{max}(@var{width},@var{height}),)}. For example,
if @var{width} is 64 and @var{height} is 16 and the implementation can
store a texture of this size, the following mipmap levels are built:
@r{64×16}, @r{32×8}, @r{16×4}, @r{8×2}, @r{4×1}, @r{2×1}, and @r{1×1}
These correspond to levels 0 through 6, respectively.
See the @code{glTexImage1D} reference page for a description of the
-acceptable values for @var{format} parameter. See the
+acceptable values for @var{format} parameter. See the
@code{glDrawPixels} reference page for a description of the acceptable
values for @var{type} parameter.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GLU_TEXTURE_3D}.
+Specifies the target texture. Must be @code{GLU_TEXTURE_3D}.
@item @var{internalFormat}
-Requests the internal storage format of the texture image. The most
+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
+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: @code{GLU_ALPHA}, @code{GLU_ALPHA4}, @code{GLU_ALPHA8},
@code{GLU_ALPHA12}, @code{GLU_ALPHA16}, @code{GLU_LUMINANCE},
@itemx @var{height}
@itemx @var{depth}
Specifies in pixels the width, height and depth respectively, of the
-texture image. These should be a power of 2.
+texture image. These should be a power of 2.
@item @var{format}
-Specifies the format of the pixel data. Must be one of
+Specifies the format of the pixel data. Must be one of
@code{GLU_COLOR_INDEX}, @code{GLU_DEPTH_COMPONENT}, @code{GLU_RED},
@code{GLU_GREEN}, @code{GLU_BLUE}, @code{GLU_ALPHA}, @code{GLU_RGB},
@code{GLU_RGBA}, @code{GLU_BGR}, @code{GLU_BGRA}, @code{GLU_LUMINANCE},
or @code{GLU_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type for @var{data}. Must be one of
+Specifies the data type for @var{data}. Must be one of
@code{GLU_UNSIGNED_BYTE}, @code{GLU_BYTE}, @code{GLU_BITMAP},
@code{GLU_UNSIGNED_SHORT}, @code{GLU_SHORT}, @code{GLU_UNSIGNED_INT},
@code{GLU_INT}, @code{GLU_FLOAT}, @code{GLU_UNSIGNED_BYTE_3_3_2},
@code{gluBuild3DMipmapLevels} 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.
+mipmap. This is used for the antialiasing of texture mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see @code{gluErrorString}).
A series of mipmap levels from @var{base} to @var{max} is built by
decimating @var{data} in half along both dimensions until size @r{1×1×1}
-is reached. At each level, each texel in the halved mipmap level is an
+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
+(If exactly one of the dimensions is 1, four texels are averaged. If
exactly two of the dimensions are 1, two texels are averaged.)
@code{glTexImage3D} is called to load these mipmap levels from
-@var{base} to @var{max}. If @var{max} is larger than the highest mipmap
+@var{base} to @var{max}. If @var{max} is larger than the highest mipmap
level for the texture of the specified size, then a GLU error code is
returned (see @code{gluErrorString}) and nothing is loaded.
For example, if @var{level} is 2 and @var{width} is 16, @var{height} is
8 and @var{depth} is 4, the following levels are possible: @r{16×8×4},
-@r{8×4×2}, @r{4×2×1}, @r{2×1×1}, @r{1×1×1}. These correspond to levels
-2 through 6 respectively. If @var{base} is 3 and @var{max} is 5, then
-only mipmap levels @r{8×4×2}, @r{4×2×1}, and @r{2×1×1} are loaded.
-However, if @var{max} is 7, then an error is returned and nothing is
-loaded, since @var{max} is larger than the highest mipmap level which
-is, in this case, 6.
+@r{8×4×2}, @r{4×2×1}, @r{2×1×1}, @r{1×1×1}. These correspond to levels 2
+through 6 respectively. If @var{base} is 3 and @var{max} is 5, then only
+mipmap levels @r{8×4×2}, @r{4×2×1}, and @r{2×1×1} are loaded. However,
+if @var{max} is 7, then an error is returned and nothing is loaded,
+since @var{max} is larger than the highest mipmap level which is, in
+this case, 6.
The highest mipmap level can be derived from the formula
@r{@var{log}_2(@var{max}(@var{width},@var{height}@var{depth})×2^@var{level},)}.
See the @code{glTexImage1D} reference page for a description of the
-acceptable values for @var{format} parameter. See the
+acceptable values for @var{format} parameter. See the
@code{glDrawPixels} reference page for a description of the acceptable
values for @var{type} parameter.
@table @asis
@item @var{target}
-Specifies the target texture. Must be @code{GLU_TEXTURE_3D}.
+Specifies the target texture. Must be @code{GLU_TEXTURE_3D}.
@item @var{internalFormat}
-Requests the internal storage format of the texture image. The most
+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
+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: @code{GLU_ALPHA}, @code{GLU_ALPHA4}, @code{GLU_ALPHA8},
@code{GLU_ALPHA12}, @code{GLU_ALPHA16}, @code{GLU_LUMINANCE},
of the texture image.
@item @var{format}
-Specifies the format of the pixel data. Must be one of
+Specifies the format of the pixel data. Must be one of
@code{GLU_COLOR_INDEX}, @code{GLU_DEPTH_COMPONENT}, @code{GLU_RED},
@code{GLU_GREEN}, @code{GLU_BLUE}, @code{GLU_ALPHA}, @code{GLU_RGB},
@code{GLU_RGBA}, @code{GLU_BGR}, @code{GLU_BGRA}, @code{GLU_LUMINANCE},
or @code{GLU_LUMINANCE_ALPHA}.
@item @var{type}
-Specifies the data type for @var{data}. Must be one of:
+Specifies the data type for @var{data}. Must be one of:
@code{GLU_UNSIGNED_BYTE}, @code{GLU_BYTE}, @code{GLU_BITMAP},
@code{GLU_UNSIGNED_SHORT}, @code{GLU_SHORT}, @code{GLU_UNSIGNED_INT},
@code{GLU_INT}, @code{GLU_FLOAT}, @code{GLU_UNSIGNED_BYTE_3_3_2},
@code{gluBuild3DMipmaps} 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.
+mipmap. This is used for the antialiasing of texture-mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see @code{gluErrorString}).
Initially, the @var{width}, @var{height} and @var{depth} of @var{data}
-are checked to see if they are a power of 2. If not, a copy of
-@var{data} is made and scaled up or down to the nearest power of 2. (If
+are checked to see if they are a power of 2. If not, a copy of
+@var{data} is made and scaled up or down to the nearest power of 2. (If
@var{width}, @var{height}, or @var{depth} is exactly between powers of
2, then the copy of @var{data} will scale upwards.) This copy will be
-used for subsequent mipmapping operations described below. For example,
+used for subsequent mipmapping operations described below. For example,
if @var{width} is 57, @var{height} is 23, and @var{depth} is 24, then a
copy of @var{data} will scale up to 64 in width, down to 16 in height,
and up to 32 in depth before mipmapping takes place.
Then, proxy textures (see @code{glTexImage3D}) are used to determine if
-the implementation can fit the requested texture. If not, all three
+the implementation can fit the requested texture. If not, all three
dimensions are continually halved until it fits.
Next, a series of mipmap levels is built by decimating a copy of
@var{data} in half along all three dimensions until size @r{1×1×1} is
-reached. At each level, each texel in the halved mipmap level is an
+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
+(If exactly one of the dimensions is 1, four texels are averaged. If
exactly two of the dimensions are 1, two texels are averaged.)
-@code{glTexImage3D} is called to load each of these mipmap levels. Level
-0 is a copy of @var{data}. The highest level is
-@r{@var{log}_2,(@var{max}(@var{width},@var{height}@var{depth}),)}. For
+@code{glTexImage3D} is called to load each of these mipmap levels. Level
+0 is a copy of @var{data}. The highest level is
+@r{@var{log}_2,(@var{max}(@var{width},@var{height}@var{depth}),)}. For
example, if @var{width} is 64, @var{height} is 16, and @var{depth} is
32, and the implementation can store a texture of this size, the
following mipmap levels are built: @r{64×16×32}, @r{32×8×16},
-@r{16×4×8}, @r{8×2×4}, @r{4×1×2}, @r{2×1×1}, and @r{1×1×1}. These
+@r{16×4×8}, @r{8×2×4}, @r{4×1×2}, @r{2×1×1}, and @r{1×1×1}. These
correspond to levels 0 through 6, respectively.
See the @code{glTexImage1D} reference page for a description of the
-acceptable values for @var{format} parameter. See the
+acceptable values for @var{format} parameter. See the
@code{glDrawPixels} reference page for a description of the acceptable
values for @var{type} parameter.
@end table
-@code{gluCylinder} draws a cylinder oriented along the @var{z} axis. The
+@code{gluCylinder} draws a cylinder oriented along the @var{z} axis. The
base of the cylinder is placed at @var{z} = 0 and the top at
-@r{@var{z}=@var{height}}. Like a sphere, a cylinder is subdivided
-around the @var{z} axis into slices and along the @var{z} axis into
-stacks.
+@r{@var{z}=@var{height}}. Like a sphere, a cylinder is subdivided around
+the @var{z} axis into slices and along the @var{z} axis into stacks.
Note that if @var{top} is set to 0.0, this routine generates a cone.
If the orientation is set to @code{GLU_OUTSIDE} (with
@code{gluQuadricOrientation}), then any generated normals point away
-from the @var{z} axis. Otherwise, they point toward the @var{z} axis.
+from the @var{z} axis. Otherwise, they point toward the @var{z} axis.
If texturing is turned on (with @code{gluQuadricTexture}), then texture
coordinates are generated so that @var{t} ranges linearly from 0.0 at
@end table
@code{gluDeleteQuadric} destroys the quadrics object (created with
-@code{gluNewQuadric}) and frees any memory it uses. Once
+@code{gluNewQuadric}) and frees any memory it uses. Once
@code{gluDeleteQuadric} has been called, @var{quad} cannot be used
again.
@end table
-@code{gluDisk} renders a disk on the @var{z} = 0 plane. The disk has a
+@code{gluDisk} renders a disk on the @var{z} = 0 plane. The disk has a
radius of @var{outer} and contains a concentric circular hole with a
-radius of @var{inner}. If @var{inner} is 0, then no hole is generated.
+radius of @var{inner}. If @var{inner} is 0, then no hole is generated.
The disk is subdivided around the @var{z} axis into slices (like pizza
slices) and also about the @var{z} axis into rings (as specified by
@var{slices} and @var{loops}, respectively).
With respect to orientation, the +@var{z} side of the disk is considered
-to be ``outside'' (see @code{gluQuadricOrientation}). This means that
-if the orientation is set to @code{GLU_OUTSIDE}, then any normals
-generated point along the +@var{z} axis. Otherwise, they point along
-the \-@var{z} axis.
+to be ``outside'' (see @code{gluQuadricOrientation}). This means that if
+the orientation is set to @code{GLU_OUTSIDE}, then any normals generated
+point along the +@var{z} axis. Otherwise, they point along the \-@var{z}
+axis.
If texturing has been turned on (with @code{gluQuadricTexture}), texture
coordinates are generated linearly such that where
@end table
@code{gluErrorString} produces an error string from a GL or GLU error
-code. The string is in ISO Latin 1 format. For example,
+code. The string is in ISO Latin 1 format. For example,
@code{gluErrorString}(@code{GLU_OUT_OF_MEMORY}) returns the string
@var{out of memory}.
The standard GLU error codes are @code{GLU_INVALID_ENUM},
-@code{GLU_INVALID_VALUE}, and @code{GLU_OUT_OF_MEMORY}. Certain other
-GLU functions can return specialized error codes through callbacks. See
+@code{GLU_INVALID_VALUE}, and @code{GLU_OUT_OF_MEMORY}. Certain other
+GLU functions can return specialized error codes through callbacks. See
the @code{glGetError} reference page for the list of GL error codes.
@code{NULL} is returned if @var{error} is not a valid GL or GLU error
Specifies the NURBS object (created with @code{gluNewNurbsRenderer}).
@item @var{property}
-Specifies the property whose value is to be fetched. Valid values are
+Specifies the property whose value is to be fetched. Valid values are
@code{GLU_CULLING}, @code{GLU_SAMPLING_TOLERANCE},
@code{GLU_DISPLAY_MODE}, @code{GLU_AUTO_LOAD_MATRIX},
@code{GLU_PARAMETRIC_TOLERANCE}, @code{GLU_SAMPLING_METHOD},
@end table
@code{gluGetNurbsProperty} retrieves properties stored in a NURBS
-object. These properties affect the way that NURBS curves and surfaces
-are rendered. See the @code{gluNurbsProperty} reference page for
+object. These properties affect the way that NURBS curves and surfaces
+are rendered. See the @code{gluNurbsProperty} reference page for
information about what the properties are and what they do.
@end deftypefun
@var{version number<space>vendor-specific information}
-Vendor-specific information is optional. Its format and contents depend
+Vendor-specific information is optional. Its format and contents depend
on the implementation.
-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 @var{name} is
+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 @var{name} is
@code{GLU_EXTENSIONS}, then @code{gluGetString} returns a
-space-separated list of names of supported GLU extensions. (Extension
+space-separated list of names of supported GLU extensions. (Extension
names never contain spaces.)
All strings are null-terminated.
Specifies the tessellation object (created with @code{gluNewTess}).
@item @var{which}
-Specifies the property whose value is to be fetched. Valid values are
+Specifies the property whose value is to be fetched. Valid values are
@code{GLU_TESS_WINDING_RULE}, @code{GLU_TESS_BOUNDARY_ONLY}, and
@code{GLU_TESS_TOLERANCE}.
@end table
@code{gluGetTessProperty} retrieves properties stored in a tessellation
-object. These properties affect the way that tessellation objects are
-interpreted and rendered. See the @code{gluTessProperty} reference page
+object. These properties affect the way that tessellation objects are
+interpreted and rendered. See the @code{gluTessProperty} reference page
for information about the properties and what they do.
@end deftypefun
@code{gluLoadSamplingMatrices} uses @var{model}, @var{perspective}, and
@var{view} to recompute the sampling and culling matrices stored in
-@var{nurb}. The sampling matrix determines how finely a NURBS curve or
+@var{nurb}. The sampling matrix determines how finely a NURBS curve or
surface must be tessellated to satisfy the sampling tolerance (as
-determined by the @code{GLU_SAMPLING_TOLERANCE} property). The culling
+determined by the @code{GLU_SAMPLING_TOLERANCE} property). The culling
matrix is used in deciding if a NURBS curve or surface should be culled
before rendering (when the @code{GLU_CULLING} property is turned on).
@code{gluLoadSamplingMatrices} is necessary only if the
@code{GLU_AUTO_LOAD_MATRIX} property is turned off (see
-@code{gluNurbsProperty}). Although it can be convenient to leave the
+@code{gluNurbsProperty}). Although it can be convenient to leave the
@code{GLU_AUTO_LOAD_MATRIX} property turned on, there can be a
-performance penalty for doing so. (A round trip to the GL server is
+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.)
vector.
The matrix maps the reference point to the negative @var{z} axis and the
-eye point to the origin. When a typical projection matrix is used, 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 @var{UP} vector projected onto
the viewing plane is mapped to the positive @var{y} axis so that it
-points upward in the viewport. The @var{UP} vector must not be parallel
+points upward in the viewport. The @var{UP} vector must not be parallel
to the line of sight from the eye point to the reference point.
Let
Create a NURBS object.
@code{gluNewNurbsRenderer} 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.
+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.
@end deftypefun
Create a quadrics object.
@code{gluNewQuadric} 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
+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.
@end deftypefun
Create a tessellation object.
@code{gluNewTess} 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
+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.
@end deftypefun
Specifies the tessellation object (created with @code{gluNewTess}).
@item @var{type}
-Specifies the type of the contour being defined. Valid values are
+Specifies the type of the contour being defined. Valid values are
@code{GLU_EXTERIOR}, @code{GLU_INTERIOR}, @code{GLU_UNKNOWN},
@code{GLU_CCW}, and @code{GLU_CW}.
@end table
@code{gluNextContour} is used in describing polygons with multiple
-contours. After the first contour has been described through a series
-of @code{gluTessVertex} calls, a @code{gluNextContour} call indicates
-that the previous contour is complete and that the next contour is about
-to begin. Another series of @code{gluTessVertex} calls is then used to
-describe the new contour. This process can be repeated until all
+contours. After the first contour has been described through a series of
+@code{gluTessVertex} calls, a @code{gluNextContour} call indicates that
+the previous contour is complete and that the next contour is about to
+begin. Another series of @code{gluTessVertex} calls is then used to
+describe the new contour. This process can be repeated until all
contours have been described.
-@var{type} defines what type of contour follows. The legal contour
-types are as follows:
+@var{type} defines what type of contour follows. The legal contour types
+are as follows:
@table @asis
@item @code{GLU_EXTERIOR}
@item @code{GLU_CCW},
@item @code{GLU_CW}
The first @code{GLU_CCW} or @code{GLU_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.
+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.
@end table
@code{GLU_CW} contour types.
Before the first contour is described, @code{gluNextContour} can be
-called to define the type of the first contour. If
-@code{gluNextContour} is not called before the first contour, then the
-first contour is marked @code{GLU_EXTERIOR}.
+called to define the type of the first contour. If @code{gluNextContour}
+is not called before the first contour, then the first contour is marked
+@code{GLU_EXTERIOR}.
This command is obsolete and is provided for backward compatibility
-only. Calls to @code{gluNextContour} are mapped to
+only. Calls to @code{gluNextContour} are mapped to
@code{gluTessEndContour} followed by @code{gluTessBeginContour}.
@end deftypefun
@end table
@code{gluNurbsCallbackDataEXT} is used to pass a pointer to the
-application's data to NURBS tessellator. A copy of this pointer will be
+application's data to NURBS tessellator. A copy of this pointer will be
passed by the tessellator in the NURBS callback functions (set by
@code{gluNurbsCallback}).
@end table
@code{gluNurbsCallbackData} is used to pass a pointer to the
-application's data to NURBS tessellator. A copy of this pointer will be
+application's data to NURBS tessellator. A copy of this pointer will be
passed by the tessellator in the NURBS callback functions (set by
@code{gluNurbsCallback}).
Specifies the NURBS object (created with @code{gluNewNurbsRenderer}).
@item @var{which}
-Specifies the callback being defined. Valid values are
+Specifies the callback being defined. Valid values are
@code{GLU_NURBS_BEGIN}, @code{GLU_NURBS_VERTEX},
@code{GLU_NURBS_NORMAL}, @code{GLU_NURBS_COLOR},
@code{GLU_NURBS_TEXTURE_COORD}, @code{GLU_NURBS_END},
@end table
@code{gluNurbsCallback} 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 @var{CallBackFunc} is NULL, then this callback will not
-get invoked and the related data, if any, will be lost.
+NURBS object. If the specified callback is already defined, then it is
+replaced. If @var{CallBackFunc} is NULL, then this callback will not get
+invoked and the related data, if any, will be lost.
Except the error callback, these callbacks are used by NURBS tessellator
(when @code{GLU_NURBS_MODE} is set to be @code{GLU_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
+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
+pointer will be used. Note that ``userData'' is a copy of the pointer
that was specified at the last call to @code{gluNurbsCallbackData}.
The error callback function is effective no matter which value that
-@code{GLU_NURBS_MODE} is set to. All other callback functions are
+@code{GLU_NURBS_MODE} is set to. All other callback functions are
effective only when @code{GLU_NURBS_MODE} is set to
@code{GLU_NURBS_TESSELLATOR}.
@item @code{GLU_NURBS_BEGIN}
-The begin callback indicates the start of a primitive. The function
+The begin callback indicates the start of a primitive. The function
takes a single argument of type GLenum, which can be one of
@code{GLU_LINES}, @code{GLU_LINE_STRIP}, @code{GLU_TRIANGLE_FAN},
@code{GLU_TRIANGLE_STRIP}, @code{GLU_TRIANGLES}, or
-@code{GLU_QUAD_STRIP}. The default begin callback function is NULL. The
+@code{GLU_QUAD_STRIP}. The default begin callback function is NULL. The
function prototype for this callback looks like:
@item @code{GLU_NURBS_BEGIN_DATA}
The same as the @code{GLU_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 @code{gluNurbsCallbackData}. The
-default callback function is NULL. The function prototype for this
+additional pointer argument. This pointer is a copy of the pointer that
+was specified at the last call to @code{gluNurbsCallbackData}. The
+default callback function is NULL. The function prototype for this
callback function looks like:
@item @code{GLU_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:
+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:
@item @code{GLU_NURBS_VERTEX_DATA}
This is the same as the @code{GLU_NURBS_VERTEX} callback, except that it
-takes an additional pointer argument. This pointer is a copy of the
+takes an additional pointer argument. This pointer is a copy of the
pointer that was specified at the last call to
-@code{gluNurbsCallbackData}. The default callback function is NULL. The
+@code{gluNurbsCallbackData}. The default callback function is NULL. The
function prototype for this callback function looks like:
@item @code{GLU_NURBS_NORMAL}
-The normal callback is invoked as the vertex normal is generated. The
+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 (@code{GLU_MAP1_NORMAL}). In the case of a
+user provides a normal map (@code{GLU_MAP1_NORMAL}). In the case of a
NURBS surface, if a normal map (@code{GLU_MAP2_NORMAL}) is provided,
-then the generated normal is computed from the normal map. If a normal
+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 @code{GLU_AUTO_NORMAL} is
-enabled. The default normal callback function is NULL. The function
+enabled. The default normal callback function is NULL. The function
prototype for this callback function looks like:
@item @code{GLU_NURBS_NORMAL_DATA}
The same as the @code{GLU_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 @code{gluNurbsCallbackData}. The
-default callback function is NULL. The function prototype for this
+additional pointer argument. This pointer is a copy of the pointer that
+was specified at the last call to @code{gluNurbsCallbackData}. The
+default callback function is NULL. The function prototype for this
callback function looks like:
@item @code{GLU_NURBS_COLOR}
-The color callback is invoked as the color of a vertex is generated. The
+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
-(@code{GLU_MAP1_COLOR_4} or @code{GLU_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:
+(@code{GLU_MAP1_COLOR_4} or @code{GLU_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:
@item @code{GLU_NURBS_COLOR_DATA}
The same as the @code{GLU_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 @code{gluNurbsCallbackData}. The
-default callback function is NULL. The function prototype for this
+additional pointer argument. This pointer is a copy of the pointer that
+was specified at the last call to @code{gluNurbsCallbackData}. The
+default callback function is NULL. The function prototype for this
callback function looks like:
@item @code{GLU_NURBS_TEXTURE_COORD}
The texture callback is invoked as the texture coordinates of a vertex
-are generated. These coordinates are stored in the parameter
+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
(@code{GLU_MAP1_TEXTURE_COORD_1}, @code{GLU_MAP1_TEXTURE_COORD_2},
@code{GLU_MAP1_TEXTURE_COORD_3}, @code{GLU_MAP1_TEXTURE_COORD_4},
@code{GLU_MAP2_TEXTURE_COORD_1}, @code{GLU_MAP2_TEXTURE_COORD_2},
-@code{GLU_MAP2_TEXTURE_COORD_3}, @code{GLU_MAP2_TEXTURE_COORD_4}). If
-no texture map is specified, this callback function will not be called.
-The default texture callback function is NULL. The function prototype
-for this callback function looks like:
+@code{GLU_MAP2_TEXTURE_COORD_3}, @code{GLU_MAP2_TEXTURE_COORD_4}). If no
+texture map is specified, this callback function will not be called. The
+default texture callback function is NULL. The function prototype for
+this callback function looks like:
@item @code{GLU_NURBS_TEXTURE_COORD_DATA}
This is the same as the @code{GLU_NURBS_TEXTURE_COORD} callback, except
-that it takes an additional pointer argument. This pointer is a copy of
+that it takes an additional pointer argument. This pointer is a copy of
the pointer that was specified at the last call to
-@code{gluNurbsCallbackData}. The default callback function is NULL. The
+@code{gluNurbsCallbackData}. The default callback function is NULL. The
function prototype for this callback function looks like:
@item @code{GLU_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
+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:
@item @code{GLU_NURBS_END_DATA}
This is the same as the @code{GLU_NURBS_END} callback, except that it
-takes an additional pointer argument. This pointer is a copy of the
+takes an additional pointer argument. This pointer is a copy of the
pointer that was specified at the last call to
-@code{gluNurbsCallbackData}. The default callback function is NULL. The
+@code{gluNurbsCallbackData}. The default callback function is NULL. The
function prototype for this callback function looks like:
@item @code{GLU_NURBS_ERROR}
-The error function is called when an error is encountered. Its single
+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
-@code{GLU_NURBS_ERROR1} through @code{GLU_NURBS_ERROR37}. Character
+occurred. There are 37 errors unique to NURBS, named
+@code{GLU_NURBS_ERROR1} through @code{GLU_NURBS_ERROR37}. Character
strings describing these errors can be retrieved with
@code{gluErrorString}.
Specifies the NURBS object (created with @code{gluNewNurbsRenderer}).
@item @var{knotCount}
-Specifies the number of knots in @var{knots}. @var{knotCount} equals
-the number of control points plus the order.
+Specifies the number of knots in @var{knots}. @var{knotCount} equals the
+number of control points plus the order.
@item @var{knots}
Specifies an array of @var{knotCount} nondecreasing knot values.
values) between successive curve control points.
@item @var{control}
-Specifies a pointer to an array of control points. The coordinates must
+Specifies a pointer to an array of control points. The coordinates must
agree with @var{type}, specified below.
@item @var{order}
-Specifies the order of the NURBS curve. @var{order} equals degree + 1,
+Specifies the order of the NURBS curve. @var{order} equals degree + 1,
hence a cubic curve has an order of 4.
@item @var{type}
-Specifies the type of the curve. If this curve is defined within a
+Specifies the type of the curve. If this curve is defined within a
@code{gluBeginCurve}/@code{gluEndCurve} pair, then the type can be any
of the valid one-dimensional evaluator types (such as
-@code{GLU_MAP1_VERTEX_3} or @code{GLU_MAP1_COLOR_4}). Between a
+@code{GLU_MAP1_VERTEX_3} or @code{GLU_MAP1_COLOR_4}). Between a
@code{gluBeginTrim}/@code{gluEndTrim} pair, the only valid types are
@code{GLU_MAP1_TRIM_2} and @code{GLU_MAP1_TRIM_3}.
When @code{gluNurbsCurve} appears between a
@code{gluBeginCurve}/@code{gluEndCurve} pair, it is used to describe a
-curve to be rendered. Positional, texture, and color coordinates are
+curve to be rendered. Positional, texture, and color coordinates are
associated by presenting each as a separate @code{gluNurbsCurve} between
-a @code{gluBeginCurve}/@code{gluEndCurve} pair. No more than one call
-to @code{gluNurbsCurve} for each of color, position, and texture data
-can be made within a single @code{gluBeginCurve}/@code{gluEndCurve}
-pair. Exactly one call must be made to describe the position of the
-curve (a @var{type} of @code{GLU_MAP1_VERTEX_3} or
-@code{GLU_MAP1_VERTEX_4}).
+a @code{gluBeginCurve}/@code{gluEndCurve} pair. No more than one call to
+@code{gluNurbsCurve} for each of color, position, and texture data can
+be made within a single @code{gluBeginCurve}/@code{gluEndCurve} pair.
+Exactly one call must be made to describe the position of the curve (a
+@var{type} of @code{GLU_MAP1_VERTEX_3} or @code{GLU_MAP1_VERTEX_4}).
When @code{gluNurbsCurve} appears between a
@code{gluBeginTrim}/@code{gluEndTrim} pair, it is used to describe a
-trimming curve on a NURBS surface. If @var{type} is
+trimming curve on a NURBS surface. If @var{type} is
@code{GLU_MAP1_TRIM_2}, then it describes a curve in two-dimensional
-(@var{u} and @var{v}) parameter space. If it is @code{GLU_MAP1_TRIM_3},
+(@var{u} and @var{v}) parameter space. If it is @code{GLU_MAP1_TRIM_3},
then it describes a curve in two-dimensional homogeneous (@var{u},
-@var{v}, and @var{w}) parameter space. See the @code{gluBeginTrim}
+@var{v}, and @var{w}) parameter space. See the @code{gluBeginTrim}
reference page for more discussion about trimming curves.
@end deftypefun
Specifies the NURBS object (created with @code{gluNewNurbsRenderer}).
@item @var{property}
-Specifies the property to be set. Valid values are
+Specifies the property to be set. Valid values are
@code{GLU_SAMPLING_TOLERANCE}, @code{GLU_DISPLAY_MODE},
@code{GLU_CULLING}, @code{GLU_AUTO_LOAD_MATRIX},
@code{GLU_PARAMETRIC_TOLERANCE}, @code{GLU_SAMPLING_METHOD},
@code{GLU_U_STEP}, @code{GLU_V_STEP}, or @code{GLU_NURBS_MODE}.
@item @var{value}
-Specifies the value of the indicated property. It may be a numeric
-value or one of @code{GLU_OUTLINE_POLYGON}, @code{GLU_FILL},
+Specifies the value of the indicated property. It may be a numeric value
+or one of @code{GLU_OUTLINE_POLYGON}, @code{GLU_FILL},
@code{GLU_OUTLINE_PATCH}, @code{GLU_TRUE}, @code{GLU_FALSE},
@code{GLU_PATH_LENGTH}, @code{GLU_PARAMETRIC_ERROR},
@code{GLU_DOMAIN_DISTANCE}, @code{GLU_NURBS_RENDERER}, or
@end table
@code{gluNurbsProperty} is used to control properties stored in a NURBS
-object. These properties affect the way that a NURBS curve is rendered.
+object. These properties affect the way that a NURBS curve is rendered.
The accepted values for @var{property} are as follows:
@table @asis
@item @code{GLU_NURBS_MODE}
@var{value} should be set to be either @code{GLU_NURBS_RENDERER} or
-@code{GLU_NURBS_TESSELLATOR}. When set to @code{GLU_NURBS_RENDERER},
+@code{GLU_NURBS_TESSELLATOR}. When set to @code{GLU_NURBS_RENDERER},
NURBS objects are tessellated into OpenGL primitives and sent to the
-pipeline for rendering. When set to @code{GLU_NURBS_TESSELLATOR}, NURBS
+pipeline for rendering. When set to @code{GLU_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 @code{gluNurbsCallback}). This allows the user to cache
-the tessellated results for further processing. The initial value is
+interface (see @code{gluNurbsCallback}). This allows the user to cache
+the tessellated results for further processing. The initial value is
@code{GLU_NURBS_RENDERER}.
@item @code{GLU_SAMPLING_METHOD}
-Specifies how a NURBS surface should be tessellated. @var{value} may be
+Specifies how a NURBS surface should be tessellated. @var{value} may be
one of @code{GLU_PATH_LENGTH}, @code{GLU_PARAMETRIC_ERROR},
@code{GLU_DOMAIN_DISTANCE}, @code{GLU_OBJECT_PATH_LENGTH}, or
-@code{GLU_OBJECT_PARAMETRIC_ERROR}. When set to @code{GLU_PATH_LENGTH},
+@code{GLU_OBJECT_PARAMETRIC_ERROR}. When set to @code{GLU_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 @code{GLU_SAMPLING_TOLERANCE}.
@item @code{GLU_SAMPLING_TOLERANCE}
Specifies the maximum length, in pixels or in object space length unit,
to use when the sampling method is set to @code{GLU_PATH_LENGTH} or
-@code{GLU_OBJECT_PATH_LENGTH}. The NURBS code is conservative when
+@code{GLU_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.
+shorter. The initial value is 50.0 pixels.
@item @code{GLU_PARAMETRIC_TOLERANCE}
Specifies the maximum distance, in pixels or in object space length
unit, to use when the sampling method is @code{GLU_PARAMETRIC_ERROR} or
-@code{GLU_OBJECT_PARAMETRIC_ERROR}. The initial value is 0.5.
+@code{GLU_OBJECT_PARAMETRIC_ERROR}. The initial value is 0.5.
@item @code{GLU_U_STEP}
Specifies the number of sample points per unit length taken along the
-@var{u} axis in parametric coordinates. It is needed when
-@code{GLU_SAMPLING_METHOD} is set to @code{GLU_DOMAIN_DISTANCE}. The
+@var{u} axis in parametric coordinates. It is needed when
+@code{GLU_SAMPLING_METHOD} is set to @code{GLU_DOMAIN_DISTANCE}. The
initial value is 100.
@item @code{GLU_V_STEP}
Specifies the number of sample points per unit length taken along the
-@var{v} axis in parametric coordinate. It is needed when
-@code{GLU_SAMPLING_METHOD} is set to @code{GLU_DOMAIN_DISTANCE}. The
+@var{v} axis in parametric coordinate. It is needed when
+@code{GLU_SAMPLING_METHOD} is set to @code{GLU_DOMAIN_DISTANCE}. The
initial value is 100.
@item @code{GLU_DISPLAY_MODE}
@var{value} can be set to @code{GLU_OUTLINE_POLYGON}, @code{GLU_FILL},
-or @code{GLU_OUTLINE_PATCH}. When @code{GLU_NURBS_MODE} is set to be
+or @code{GLU_OUTLINE_PATCH}. When @code{GLU_NURBS_MODE} is set to be
@code{GLU_NURBS_RENDERER}, @var{value} defines how a NURBS surface
-should be rendered. When @var{value} is set to @code{GLU_FILL}, the
-surface is rendered as a set of polygons. When @var{value} is set to
+should be rendered. When @var{value} is set to @code{GLU_FILL}, the
+surface is rendered as a set of polygons. When @var{value} is set to
@code{GLU_OUTLINE_POLYGON}, the NURBS library draws only the outlines of
-the polygons created by tessellation. When @var{value} is set to
+the polygons created by tessellation. When @var{value} is set to
@code{GLU_OUTLINE_PATCH} just the outlines of patches and trim curves
defined by the user are drawn.
When @code{GLU_NURBS_MODE} is set to be @code{GLU_NURBS_TESSELLATOR},
-@var{value} defines how a NURBS surface should be tessellated. When
+@var{value} defines how a NURBS surface should be tessellated. When
@code{GLU_DISPLAY_MODE} is set to @code{GLU_FILL} or
@code{GLU_OUTLINE_POLYGON}, the NURBS surface is tessellated into OpenGL
triangle primitives that can be retrieved back through callback
-functions. If @code{GLU_DISPLAY_MODE} is set to
+functions. If @code{GLU_DISPLAY_MODE} is set to
@code{GLU_OUTLINE_PATCH}, only the outlines of the patches and trim
curves are generated as a sequence of line strips that can be retrieved
back through callback functions.
@item @code{GLU_CULLING}
@var{value} is a boolean value that, when set to @code{GLU_TRUE},
indicates that a NURBS curve should be discarded prior to tessellation
-if its control points lie outside the current viewport. The initial
+if its control points lie outside the current viewport. The initial
value is @code{GLU_FALSE}.
@item @code{GLU_AUTO_LOAD_MATRIX}
-@var{value} is a boolean value. When set to @code{GLU_TRUE}, the NURBS
+@var{value} is a boolean value. When set to @code{GLU_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
+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.
If this mode is set to @code{GLU_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 @code{gluLoadSamplingMatrices} function. This mode
-is initially set to @code{GLU_TRUE}. Changing it from @code{GLU_TRUE}
-to @code{GLU_FALSE} does not affect the sampling and culling matrices
-until @code{gluLoadSamplingMatrices} is called.
+NURBS renderer to use to construct sampling and culling matrices. This
+can be done with the @code{gluLoadSamplingMatrices} function. This mode
+is initially set to @code{GLU_TRUE}. Changing it from @code{GLU_TRUE} to
+@code{GLU_FALSE} does not affect the sampling and culling matrices until
+@code{gluLoadSamplingMatrices} is called.
@end table
@var{control}.
@item @var{control}
-Specifies an array containing control points for the NURBS surface. The
+Specifies an array containing control points for the NURBS surface. The
offsets between successive control points in the parametric @var{u} and
@var{v} directions are given by @var{sStride} and @var{tStride}.
@item @var{sOrder}
Specifies the order of the NURBS surface in the parametric @var{u}
-direction. The order is one more than the degree, hence a surface that
+direction. The order is one more than the degree, hence a surface that
is cubic in @var{u} has a @var{u} order of 4.
@item @var{tOrder}
Specifies the order of the NURBS surface in the parametric @var{v}
-direction. The order is one more than the degree, hence a surface that
+direction. The order is one more than the degree, hence a surface that
is cubic in @var{v} has a @var{v} order of 4.
@item @var{type}
-Specifies type of the surface. @var{type} can be any of the valid
+Specifies type of the surface. @var{type} can be any of the valid
two-dimensional evaluator types (such as @code{GLU_MAP2_VERTEX_3} or
@code{GLU_MAP2_COLOR_4}).
Use @code{gluNurbsSurface} 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 @code{gluBeginSurface} command. To mark the end of
-a NURBS surface definition, use the @code{gluEndSurface} command. Call
+(before any trimming). To mark the beginning of a NURBS surface
+definition, use the @code{gluBeginSurface} command. To mark the end of a
+NURBS surface definition, use the @code{gluEndSurface} command. Call
@code{gluNurbsSurface} within a NURBS surface definition only.
Positional, texture, and color coordinates are associated with a surface
by presenting each as a separate @code{gluNurbsSurface} between a
-@code{gluBeginSurface}/@code{gluEndSurface} pair. No more than one call
+@code{gluBeginSurface}/@code{gluEndSurface} pair. No more than one call
to @code{gluNurbsSurface} for each of color, position, and texture data
can be made within a single @code{gluBeginSurface}/@code{gluEndSurface}
-pair. Exactly one call must be made to describe the position of the
+pair. Exactly one call must be made to describe the position of the
surface (a @var{type} of @code{GLU_MAP2_VERTEX_3} or
@code{GLU_MAP2_VERTEX_4}).
along the \-@var{x} axis).
The partial disk has a radius of @var{outer} and contains a concentric
-circular hole with a radius of @var{inner}. If @var{inner} is 0, then
-no hole is generated. The partial disk is subdivided around the @var{z}
+circular hole with a radius of @var{inner}. If @var{inner} is 0, then no
+hole is generated. The partial disk is subdivided around the @var{z}
axis into slices (like pizza slices) and also about the @var{z} axis
into rings (as specified by @var{slices} and @var{loops}, respectively).
With respect to orientation, the +@var{z} side of the partial disk is
-considered to be outside (see @code{gluQuadricOrientation}). This means
+considered to be outside (see @code{gluQuadricOrientation}). This means
that if the orientation is set to @code{GLU_OUTSIDE}, then any normals
-generated point along the +@var{z} axis. Otherwise, they point along
-the \-@var{z} axis.
+generated point along the +@var{z} axis. Otherwise, they point along the
+\-@var{z} axis.
If texturing is turned on (with @code{gluQuadricTexture}), texture
coordinates are generated linearly such that where
@item @var{aspect}
Specifies the aspect ratio that determines the field of view in the
-@var{x} direction. The aspect ratio is the ratio of @var{x} (width) to
+@var{x} direction. The aspect ratio is the ratio of @var{x} (width) to
@var{y} (height).
@item @var{zNear}
@end table
@code{gluPerspective} specifies a viewing frustum into the world
-coordinate system. In general, the aspect ratio in
-@code{gluPerspective} should match the aspect ratio of the associated
-viewport. For example, @r{@var{aspect}=2.0} means the viewer's angle of
-view is twice as wide in @var{x} as it is in @var{y}. If the viewport
-is twice as wide as it is tall, it displays the image without
-distortion.
+coordinate system. In general, the aspect ratio in @code{gluPerspective}
+should match the aspect ratio of the associated viewport. For example,
+@r{@var{aspect}=2.0} means the viewer's angle of view is twice as wide
+in @var{x} as it is in @var{y}. If the viewport is twice as wide as it
+is tall, it displays the image without distortion.
The matrix generated by @code{gluPerspective} is multipled by the
current matrix, just as if @code{glMultMatrix} were called with the
-generated matrix. To load the perspective matrix onto the current
-matrix stack instead, precede the call to @code{gluPerspective} with a
-call to @code{glLoadIdentity}.
+generated matrix. To load the perspective matrix onto the current matrix
+stack instead, precede the call to @code{gluPerspective} with a call to
+@code{glLoadIdentity}.
Given @var{f} defined as follows:
@end table
@code{gluPickMatrix} 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
+restrict drawing to a small region of the viewport. This is typically
+useful to determine what objects are being drawn near the cursor. Use
@code{gluPickMatrix} to restrict drawing to a small region around the
-cursor. Then, enter selection mode (with @code{glRenderMode}) and
-rerender the scene. All primitives that would have been drawn near the
+cursor. Then, enter selection mode (with @code{glRenderMode}) and
+rerender the scene. All primitives that would have been drawn near the
cursor are identified and stored in the selection buffer.
The matrix created by @code{gluPickMatrix} is multiplied by the current
matrix just as if @code{glMultMatrix} is called with the generated
-matrix. To effectively use the generated pick matrix for picking, first
+matrix. To effectively use the generated pick matrix for picking, first
call @code{glLoadIdentity} to load an identity matrix onto the
-perspective matrix stack. Then call @code{gluPickMatrix}, and, finally,
+perspective matrix stack. Then call @code{gluPickMatrix}, and, finally,
call a command (such as @code{gluPerspective}) to multiply the
perspective matrix by the pick matrix.
When using @code{gluPickMatrix} to pick NURBS, be careful to turn off
-the NURBS property @code{GLU_AUTO_LOAD_MATRIX}. If
+the NURBS property @code{GLU_AUTO_LOAD_MATRIX}. If
@code{GLU_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.
@end table
@code{gluProject} transforms the specified object coordinates into
-window coordinates using @var{model}, @var{proj}, and @var{view}. The
-result is stored in @var{winX}, @var{winY}, and @var{winZ}. A return
+window coordinates using @var{model}, @var{proj}, and @var{view}. The
+result is stored in @var{winX}, @var{winY}, and @var{winZ}. A return
value of @code{GLU_TRUE} indicates success, a return value of
@code{GLU_FALSE} indicates failure.
To compute the coordinates, let
@r{@var{v}=(@var{objX},@var{objY}@var{objZ}1.0)} represented as a matrix
-with 4 rows and 1 column. Then @code{gluProject} computes @r{@var{v}^″}
+with 4 rows and 1 column. Then @code{gluProject} computes @r{@var{v}^″}
as follows:
@r{@var{v}^″=@var{P}×@var{M}×@var{v}}
values) between points on the curve.
@item @var{type}
-Specifies the type of curve. Must be either @code{GLU_MAP1_TRIM_2} or
+Specifies the type of curve. Must be either @code{GLU_MAP1_TRIM_2} or
@code{GLU_MAP1_TRIM_3}.
@end table
@code{gluPwlCurve} describes a piecewise linear trimming curve for a
-NURBS surface. A piecewise linear curve consists of a list of
+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.
+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.
If @var{type} is @code{GLU_MAP1_TRIM_2}, then it describes a curve in
-two-dimensional (@var{u} and @var{v}) parameter space. If it is
+two-dimensional (@var{u} and @var{v}) parameter space. If it is
@code{GLU_MAP1_TRIM_3}, then it describes a curve in two-dimensional
-homogeneous (@var{u}, @var{v}, and @var{w}) parameter space. See the
+homogeneous (@var{u}, @var{v}, and @var{w}) parameter space. See the
@code{gluBeginTrim} reference page for more information about trimming
curves.
Specifies the quadrics object (created with @code{gluNewQuadric}).
@item @var{which}
-Specifies the callback being defined. The only valid value is
+Specifies the callback being defined. The only valid value is
@code{GLU_ERROR}.
@item @var{CallBackFunc}
@end table
@code{gluQuadricCallback} 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 @var{CallBackFunc} is NULL, then any existing
-callback is erased.
+a quadrics object. If the specified callback is already defined, then it
+is replaced. If @var{CallBackFunc} is NULL, then any existing callback
+is erased.
The one legal callback is @code{GLU_ERROR}:
@table @asis
@item @code{GLU_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 @code{gluErrorString} call.
+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
+@code{gluErrorString} call.
@end table
Specifies the quadrics object (created with @code{gluNewQuadric}).
@item @var{draw}
-Specifies the desired draw style. Valid values are @code{GLU_FILL},
+Specifies the desired draw style. Valid values are @code{GLU_FILL},
@code{GLU_LINE}, @code{GLU_SILHOUETTE}, and @code{GLU_POINT}.
@end table
@code{gluQuadricDrawStyle} specifies the draw style for quadrics
-rendered with @var{quad}. The legal values are as follows:
+rendered with @var{quad}. The legal values are as follows:
@table @asis
@item @code{GLU_FILL}
-Quadrics are rendered with polygon primitives. The polygons are drawn
-in a counterclockwise fashion with respect to their normals (as defined
+Quadrics are rendered with polygon primitives. The polygons are drawn in
+a counterclockwise fashion with respect to their normals (as defined
with @code{gluQuadricOrientation}).
@item @code{GLU_LINE}
Specifies the quadrics object (created with @code{gluNewQuadric}).
@item @var{normal}
-Specifies the desired type of normals. Valid values are
-@code{GLU_NONE}, @code{GLU_FLAT}, and @code{GLU_SMOOTH}.
+Specifies the desired type of normals. Valid values are @code{GLU_NONE},
+@code{GLU_FLAT}, and @code{GLU_SMOOTH}.
@end table
@code{gluQuadricNormals} specifies what kind of normals are desired for
-quadrics rendered with @var{quad}. The legal values are as follows:
+quadrics rendered with @var{quad}. The legal values are as follows:
@table @asis
@item @code{GLU_NONE}
One normal is generated for every facet of a quadric.
@item @code{GLU_SMOOTH}
-One normal is generated for every vertex of a quadric. This is the
+One normal is generated for every vertex of a quadric. This is the
initial value.
@end table
Specifies the quadrics object (created with @code{gluNewQuadric}).
@item @var{orientation}
-Specifies the desired orientation. Valid values are @code{GLU_OUTSIDE}
+Specifies the desired orientation. Valid values are @code{GLU_OUTSIDE}
and @code{GLU_INSIDE}.
@end table
@code{gluQuadricOrientation} specifies what kind of orientation is
-desired for quadrics rendered with @var{quad}. The @var{orientation}
+desired for quadrics rendered with @var{quad}. The @var{orientation}
values are as follows:
@table @asis
@end table
@code{gluQuadricTexture} specifies if texture coordinates should be
-generated for quadrics rendered with @var{quad}. If the value of
+generated for quadrics rendered with @var{quad}. If the value of
@var{texture} is @code{GLU_TRUE}, then texture coordinates are
-generated, and if @var{texture} is @code{GLU_FALSE}, they are not. The
+generated, and if @var{texture} is @code{GLU_FALSE}, they are not. The
initial value is @code{GLU_FALSE}.
The manner in which texture coordinates are generated depends upon the
@table @asis
@item @var{format}
-Specifies the format of the pixel data. The following symbolic values
+Specifies the format of the pixel data. The following symbolic values
are valid: @code{GLU_COLOR_INDEX}, @code{GLU_STENCIL_INDEX},
@code{GLU_DEPTH_COMPONENT}, @code{GLU_RED}, @code{GLU_GREEN},
@code{GLU_BLUE}, @code{GLU_ALPHA}, @code{GLU_RGB}, @code{GLU_RGBA},
image.
@item @var{typeIn}
-Specifies the data type for @var{dataIn}. Must be one of
+Specifies the data type for @var{dataIn}. Must be one of
@code{GLU_UNSIGNED_BYTE}, @code{GLU_BYTE}, @code{GLU_BITMAP},
@code{GLU_UNSIGNED_SHORT}, @code{GLU_SHORT}, @code{GLU_UNSIGNED_INT},
@code{GLU_INT}, @code{GLU_FLOAT}, @code{GLU_UNSIGNED_BYTE_3_3_2},
image.
@item @var{typeOut}
-Specifies the data type for @var{dataOut}. Must be one of
+Specifies the data type for @var{dataOut}. Must be one of
@code{GLU_UNSIGNED_BYTE}, @code{GLU_BYTE}, @code{GLU_BITMAP},
@code{GLU_UNSIGNED_SHORT}, @code{GLU_SHORT}, @code{GLU_UNSIGNED_INT},
@code{GLU_INT}, @code{GLU_FLOAT}, @code{GLU_UNSIGNED_BYTE_3_3_2},
@end table
@code{gluSphere} draws a sphere of the given radius centered around the
-origin. The sphere is subdivided around the @var{z} axis into slices
-and along the @var{z} axis into stacks (similar to lines of longitude
-and latitude).
+origin. The sphere is subdivided around the @var{z} axis into slices and
+along the @var{z} axis into stacks (similar to lines of longitude and
+latitude).
If the orientation is set to @code{GLU_OUTSIDE} (with
@code{gluQuadricOrientation}), then any normals generated point away
-from the center of the sphere. Otherwise, they point toward the center
+from the center of the sphere. Otherwise, they point toward the center
of the sphere.
If texturing is turned on (with @code{gluQuadricTexture}), then texture
@end table
@code{gluTessBeginContour} and @code{gluTessEndContour} delimit the
-definition of a polygon contour. Within each
+definition of a polygon contour. Within each
@code{gluTessBeginContour}/@code{gluTessEndContour} pair, there can be
-zero or more calls to @code{gluTessVertex}. The vertices specify a
+zero or more calls to @code{gluTessVertex}. The vertices specify a
closed contour (the last vertex of each contour is automatically linked
-to the first). See the @code{gluTessVertex} reference page for more
-details. @code{gluTessBeginContour} can only be called between
+to the first). See the @code{gluTessVertex} reference page for more
+details. @code{gluTessBeginContour} can only be called between
@code{gluTessBeginPolygon} and @code{gluTessEndPolygon}.
@end deftypefun
@end table
@code{gluTessBeginPolygon} and @code{gluTessEndPolygon} delimit the
-definition of a convex, concave or self-intersecting polygon. Within
+definition of a convex, concave or self-intersecting polygon. Within
each @code{gluTessBeginPolygon}/@code{gluTessEndPolygon} pair, there
must be one or more calls to
-@code{gluTessBeginContour}/@code{gluTessEndContour}. Within each
-contour, there are zero or more calls to @code{gluTessVertex}. The
+@code{gluTessBeginContour}/@code{gluTessEndContour}. Within each
+contour, there are zero or more calls to @code{gluTessVertex}. The
vertices specify a closed contour (the last vertex of each contour is
-automatically linked to the first). See the @code{gluTessVertex},
+automatically linked to the first). See the @code{gluTessVertex},
@code{gluTessBeginContour}, and @code{gluTessEndContour} reference pages
for more details.
-@var{data} is a pointer to a user-defined data structure. If the
+@var{data} is a pointer to a user-defined data structure. If the
appropriate callback(s) are specified (see @code{gluTessCallback}), then
-this pointer is returned to the callback function(s). Thus, it is a
+this pointer is returned to the callback function(s). Thus, it is a
convenient way to store per-polygon information.
Once @code{gluTessEndPolygon} is called, the polygon is tessellated, and
-the resulting triangles are described through callbacks. See
+the resulting triangles are described through callbacks. See
@code{gluTessCallback} for descriptions of the callback functions.
@end deftypefun
Specifies the tessellation object (created with @code{gluNewTess}).
@item @var{which}
-Specifies the callback being defined. The following values are valid:
+Specifies the callback being defined. The following values are valid:
@code{GLU_TESS_BEGIN}, @code{GLU_TESS_BEGIN_DATA},
@code{GLU_TESS_EDGE_FLAG}, @code{GLU_TESS_EDGE_FLAG_DATA},
@code{GLU_TESS_VERTEX}, @code{GLU_TESS_VERTEX_DATA},
@end table
@code{gluTessCallback} 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 @var{CallBackFunc} is NULL, then the existing
+tessellation object. If the specified callback is already defined, then
+it is replaced. If @var{CallBackFunc} is NULL, then the existing
callback becomes undefined.
These callbacks are used by the tessellation object to describe how a
-polygon specified by the user is broken into triangles. Note that there
+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
+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 @var{polygon_data} parameter used by some of the
+used. Note that the @var{polygon_data} parameter used by some of the
functions is a copy of the pointer that was specified when
-@code{gluTessBeginPolygon} was called. The legal callbacks are as
+@code{gluTessBeginPolygon} was called. The legal callbacks are as
follows:
@table @asis
@item @code{GLU_TESS_BEGIN}
The begin callback is invoked like @code{glBegin} to indicate the start
-of a (triangle) primitive. The function takes a single argument of type
-GLenum. If the @code{GLU_TESS_BOUNDARY_ONLY} property is set to
+of a (triangle) primitive. The function takes a single argument of type
+GLenum. If the @code{GLU_TESS_BOUNDARY_ONLY} property is set to
@code{GLU_FALSE}, then the argument is set to either
@code{GLU_TRIANGLE_FAN}, @code{GLU_TRIANGLE_STRIP}, or
-@code{GLU_TRIANGLES}. If the @code{GLU_TESS_BOUNDARY_ONLY} property is
+@code{GLU_TRIANGLES}. If the @code{GLU_TESS_BOUNDARY_ONLY} property is
set to @code{GLU_TRUE}, then the argument will be set to
-@code{GLU_LINE_LOOP}. The function prototype for this callback is:
+@code{GLU_LINE_LOOP}. The function prototype for this callback is:
@item @code{GLU_TESS_BEGIN_DATA}
The same as the @code{GLU_TESS_BEGIN} callback except that it takes an
-additional pointer argument. This pointer is identical to the opaque
-pointer provided when @code{gluTessBeginPolygon} was called. The
+additional pointer argument. This pointer is identical to the opaque
+pointer provided when @code{gluTessBeginPolygon} was called. The
function prototype for this callback is:
@item @code{GLU_TESS_EDGE_FLAG}
-The edge flag callback is similar to @code{glEdgeFlag}. The function
+The edge flag callback is similar to @code{glEdgeFlag}. The function
takes a single boolean flag that indicates which edges lie on the
-polygon boundary. If the flag is @code{GLU_TRUE}, then each vertex that
+polygon boundary. If the flag is @code{GLU_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 @code{GLU_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.
+edge that separates an interior region from an exterior one. If the flag
+is @code{GLU_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.
Since triangle fans and triangle strips do not support edge flags, the
begin callback is not called with @code{GLU_TRIANGLE_FAN} or
@code{GLU_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:
+performance). Instead, the fans and strips are converted to independent
+triangles. The function prototype for this callback is:
@item @code{GLU_TESS_EDGE_FLAG_DATA}
The same as the @code{GLU_TESS_EDGE_FLAG} callback except that it takes
-an additional pointer argument. This pointer is identical to the opaque
-pointer provided when @code{gluTessBeginPolygon} was called. The
+an additional pointer argument. This pointer is identical to the opaque
+pointer provided when @code{gluTessBeginPolygon} was called. The
function prototype for this callback is:
@item @code{GLU_TESS_VERTEX}
-The vertex callback is invoked between the begin and end callbacks. It
+The vertex callback is invoked between the begin and end callbacks. It
is similar to @code{glVertex}, 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
+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
-@code{gluTessVertex}). The function prototype for this callback is:
+@code{gluTessVertex}). The function prototype for this callback is:
@item @code{GLU_TESS_VERTEX_DATA}
The same as the @code{GLU_TESS_VERTEX} callback except that it takes an
-additional pointer argument. This pointer is identical to the opaque
-pointer provided when @code{gluTessBeginPolygon} was called. The
+additional pointer argument. This pointer is identical to the opaque
+pointer provided when @code{gluTessBeginPolygon} was called. The
function prototype for this callback is:
@item @code{GLU_TESS_END}
-The end callback serves the same purpose as @code{glEnd}. It indicates
-the end of a primitive and it takes no arguments. The function
-prototype for this callback is:
+The end callback serves the same purpose as @code{glEnd}. It indicates
+the end of a primitive and it takes no arguments. The function prototype
+for this callback is:
@item @code{GLU_TESS_END_DATA}
The same as the @code{GLU_TESS_END} callback except that it takes an
-additional pointer argument. This pointer is identical to the opaque
-pointer provided when @code{gluTessBeginPolygon} was called. The
+additional pointer argument. This pointer is identical to the opaque
+pointer provided when @code{gluTessBeginPolygon} was called. The
function prototype for this callback is:
@item @code{GLU_TESS_COMBINE}
The combine callback is called to create a new vertex when the
-tessellation detects an intersection or wishes to merge features. 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:
+type GLfloat, and a pointer to a pointer. The prototype is:
The vertex is defined as a linear combination of up to four existing
-vertices, stored in @var{vertex_data}. The coefficients of the linear
+vertices, stored in @var{vertex_data}. The coefficients of the linear
combination are given by @var{weight}; these weights always add up to 1.
All vertex pointers are valid even when some of the weights are 0.
@var{coords} gives the location of the new vertex.
The user must allocate another vertex, interpolate parameters using
@var{vertex_data} and @var{weight}, and return the new vertex pointer in
-@var{outData}. This handle is supplied during rendering callbacks. The
+@var{outData}. This handle is supplied during rendering callbacks. The
user is responsible for freeing the memory some time after
@code{gluTessEndPolygon} is called.
If the tessellation detects an intersection, then the
@code{GLU_TESS_COMBINE} or @code{GLU_TESS_COMBINE_DATA} callback (see
below) must be defined, and it must write a non-NULL pointer into
-@var{dataOut}. Otherwise the @code{GLU_TESS_NEED_COMBINE_CALLBACK}
-error occurs, and no output is generated.
+@var{dataOut}. Otherwise the @code{GLU_TESS_NEED_COMBINE_CALLBACK} error
+occurs, and no output is generated.
@item @code{GLU_TESS_COMBINE_DATA}
The same as the @code{GLU_TESS_COMBINE} callback except that it takes an
-additional pointer argument. This pointer is identical to the opaque
-pointer provided when @code{gluTessBeginPolygon} was called. The
+additional pointer argument. This pointer is identical to the opaque
+pointer provided when @code{gluTessBeginPolygon} was called. The
function prototype for this callback is:
@item @code{GLU_TESS_ERROR}
-The error callback is called when an error is encountered. The one
+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
@code{GLU_TESS_MISSING_BEGIN_POLYGON},
@code{GLU_TESS_MISSING_END_CONTOUR}, @code{GLU_TESS_COORD_TOO_LARGE},
@code{GLU_TESS_NEED_COMBINE_CALLBACK}, or @code{GLU_OUT_OF_MEMORY}.
Character strings describing these errors can be retrieved with the
-@code{gluErrorString} call. The function prototype for this callback
-is:
+@code{gluErrorString} call. The function prototype for this callback is:
The GLU library will recover from the first four errors by inserting the
-missing call(s). @code{GLU_TESS_COORD_TOO_LARGE} indicates that some
+missing call(s). @code{GLU_TESS_COORD_TOO_LARGE} indicates that some
vertex coordinate exceeded the predefined constant
@code{GLU_TESS_MAX_COORD} in absolute value, and that the value has been
-clamped. (Coordinate values must be small enough so that two can be
+clamped. (Coordinate values must be small enough so that two can be
multiplied together without overflow.)
@code{GLU_TESS_NEED_COMBINE_CALLBACK} indicates that the tessellation
detected an intersection between two edges in the input data, and the
@code{GLU_TESS_COMBINE} or @code{GLU_TESS_COMBINE_DATA} callback was not
-provided. No output is generated. @code{GLU_OUT_OF_MEMORY} indicates
+provided. No output is generated. @code{GLU_OUT_OF_MEMORY} indicates
that there is not enough memory so no output is generated.
@item @code{GLU_TESS_ERROR_DATA}
The same as the @code{GLU_TESS_ERROR} callback except that it takes an
-additional pointer argument. This pointer is identical to the opaque
-pointer provided when @code{gluTessBeginPolygon} was called. The
+additional pointer argument. This pointer is identical to the opaque
+pointer provided when @code{gluTessBeginPolygon} was called. The
function prototype for this callback is:
@end table
@end table
@code{gluTessBeginPolygon} and @code{gluTessEndPolygon} delimit the
-definition of a convex, concave, or self-intersecting polygon. Within
+definition of a convex, concave, or self-intersecting polygon. Within
each @code{gluTessBeginPolygon}/@code{gluTessEndPolygon} pair, there
must be one or more calls to
-@code{gluTessBeginContour}/@code{gluTessEndContour}. Within each
-contour, there are zero or more calls to @code{gluTessVertex}. The
+@code{gluTessBeginContour}/@code{gluTessEndContour}. Within each
+contour, there are zero or more calls to @code{gluTessVertex}. The
vertices specify a closed contour (the last vertex of each contour is
-automatically linked to the first). See the @code{gluTessVertex},
+automatically linked to the first). See the @code{gluTessVertex},
@code{gluTessBeginContour}, and @code{gluTessEndContour} reference pages
for more details.
Once @code{gluTessEndPolygon} is called, the polygon is tessellated, and
-the resulting triangles are described through callbacks. See
+the resulting triangles are described through callbacks. See
@code{gluTessCallback} for descriptions of the callback functions.
@end deftypefun
@end table
@code{gluTessNormal} 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
+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 @code{gluTessNormal}(tess, 0.0, 0.0, 1.0) before rendering
any polygons.
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
+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
+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
+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).
Specifies the tessellation object (created with @code{gluNewTess}).
@item @var{which}
-Specifies the property to be set. Valid values are
+Specifies the property to be set. Valid values are
@code{GLU_TESS_WINDING_RULE}, @code{GLU_TESS_BOUNDARY_ONLY}, and
@code{GLU_TESS_TOLERANCE}.
@end table
@code{gluTessProperty} 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 @var{which} are as
+tessellation object. These properties affect the way that the polygons
+are interpreted and rendered. The legal values for @var{which} are as
follows:
@table @asis
@code{GLU_TESS_WINDING_ABS_GEQ_TWO}.
To understand how the winding rule works, consider that the input
-contours partition the plane into regions. The winding rule determines
+contours partition the plane into regions. The winding rule determines
which of these regions are inside the polygon.
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.
+(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.
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.
+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.
@item @code{GLU_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
+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 @code{GLU_TESS_BEGIN} and
+are oriented CW. The @code{GLU_TESS_BEGIN} and
@code{GLU_TESS_BEGIN_DATA} callbacks use the type GL_LINE_LOOP for each
contour.
@item @code{GLU_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
+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
+merge operation. If a single feature takes part in several merge
operations, the total distance moved could be larger.
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.
+to never merge features at all. The initial tolerance is 0.
The current implementation merges vertices only if they are exactly
-coincident, regardless of the current tolerance. A vertex is spliced
+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.
+side of the edge the vertex lies on. Two edges are merged only when both
+endpoints are identical.
@end table
@end table
@code{gluTessVertex} describes a vertex on a polygon that the program
-defines. Successive @code{gluTessVertex} calls describe a closed
-contour. For example, to describe a quadrilateral, @code{gluTessVertex}
-should be called four times. @code{gluTessVertex} can only be called
+defines. Successive @code{gluTessVertex} calls describe a closed
+contour. For example, to describe a quadrilateral, @code{gluTessVertex}
+should be called four times. @code{gluTessVertex} can only be called
between @code{gluTessBeginContour} and @code{gluTessEndContour}.
@var{data} 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
+normal. This pointer is passed back to the user through the
@code{GLU_TESS_VERTEX} or @code{GLU_TESS_VERTEX_DATA} callback after
tessellation (see the @code{gluTessCallback} reference page).
@code{gluUnProject4} maps the specified window coordinatesi: @var{winX},
@var{winY}, and @var{winZ} and its clip w coordinate @var{clipW} into
object coordinates @r{(@var{objX},@var{objY}@var{objZ}@var{objW})} using
-@var{model}, @var{proj}, and @var{view}. @var{clipW} can be other than
-1 as for vertices in @code{glFeedbackBuffer} when data type
-@code{GLU_4D_COLOR_TEXTURE} is returned. This also handles the case
+@var{model}, @var{proj}, and @var{view}. @var{clipW} can be other than 1
+as for vertices in @code{glFeedbackBuffer} when data type
+@code{GLU_4D_COLOR_TEXTURE} is returned. This also handles the case
where the @var{nearVal} and @var{farVal} planes are different from the
-default, 0 and 1, respectively. A return value of @code{GLU_TRUE}
+default, 0 and 1, respectively. A return value of @code{GLU_TRUE}
indicates success; a return value of @code{GLU_FALSE} indicates failure.
To compute the coordinates
@end table
@code{gluUnProject} maps the specified window coordinates into object
-coordinates using @var{model}, @var{proj}, and @var{view}. The result
-is stored in @var{objX}, @var{objY}, and @var{objZ}. A return value of
+coordinates using @var{model}, @var{proj}, and @var{view}. The result is
+stored in @var{objX}, @var{objY}, and @var{objZ}. A return value of
@code{GLU_TRUE} indicates success; a return value of @code{GLU_FALSE}
indicates failure.
@r{((@var{objX}), (@var{objY}), (@var{objZ}),
(@var{W}),)=@var{INV}(@var{P}@var{M},)((2(@var{winX}-@var{view}[0,],),/@var{view}[2,],-1),
(2(@var{winY}-@var{view}[1,],),/@var{view}[3,],-1),
-(2(@var{winZ},)-1), (1),)}@r{@var{INV}} denotes matrix inversion. W is
+(2(@var{winZ},)-1), (1),)}@r{@var{INV}} denotes matrix inversion. W is
an unused variable, included for consistent matrix notation.
@end deftypefun
@end example
@defmac glx-string-name enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{vendor}, @code{version}, @code{extensions}.
@end defmac
@defmac glx-error-code enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{bad-screen}, @code{bad-attribute}, @code{no-extension},
@end defmac
@defmac glx-drawable-type-mask enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{window-bit}, @code{pixmap-bit}, @code{pbuffer-bit},
@end defmac
@defmac glx-render-type-mask enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{rgba-bit}, @code{color-index-bit}, @code{rgba-bit-sgix},
@end defmac
@defmac glx-sync-type enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{sync-frame-sgix}, @code{sync-swap-sgix}.
@end defmac
@defmac glx-event-mask enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pbuffer-clobber-mask}, @code{buffer-clobber-mask-sgix},
@end defmac
@defmac glx-pbuffer-clobber-mask enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{front-left-buffer-bit}, @code{front-right-buffer-bit},
@end defmac
@defmac glx-hyperpipe-type-mask enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{hyperpipe-display-pipe-sgix}, @code{hyperpipe-render-pipe-sgix}.
@end defmac
@defmac glx-hyperpipe-attrib enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{pipe-rect-sgix}, @code{pipe-rect-limits-sgix},
@end defmac
@defmac glx-hyperpipe-misc enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{hyperpipe-pipe-name-length-sgix}.
@end defmac
@defmac glx-bind-to-texture-target-mask enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{texture-1d-bit-ext}, @code{texture-2d-bit-ext},
@end defmac
@defmac glx-context-flags enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{context-debug-bit-arb}, @code{context-forward-compatible-bit-arb},
@end defmac
@defmac glx-context-profile-mask enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{context-core-profile-bit-arb},
@end defmac
@defmac glx-attribute enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{use-gl}, @code{buffer-size}, @code{level}, @code{rgba},
@end defmac
@defmac nv-present-video enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{num-video-slots-nv}.
@end defmac
@defmac ext-swap-control enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{swap-interval-ext}, @code{max-swap-interval-ext}.
@end defmac
@defmac ext-swap-control-tear enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{late-swaps-tear-ext}.
@end defmac
@defmac ext-buffer-age enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{back-buffer-age-ext}.
@end defmac
@defmac glx-amd-gpu-association enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{gpu-vendor-amd}, @code{gpu-renderer-string-amd},
@end defmac
@defmac glx-arb-create-context-robustness enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{lose-context-on-reset-arb},
@end defmac
@defmac arb-create-context-profile enum
-Enumerated value. The symbolic @var{enum} argument is replaced with its
-corresponding numeric value at compile-time. The symbolic arguments
+Enumerated value. The symbolic @var{enum} argument is replaced with its
+corresponding numeric value at compile-time. The symbolic arguments
known to this enumerated value form are:
@code{context-profile-mask-arb}.
@copying
This section of the manual was derived from the upstream OpenGL
-documentation. Each function's documentation has its own copyright
-statement; for full details, see the upstream documentation. The
+documentation. Each function's documentation has its own copyright
+statement; for full details, see the upstream documentation. The
copyright notices and licenses present in this section are as follows.
-Copyright @copyright{} 1991-2006 Silicon Graphics, Inc. This document
-is licensed under the SGI Free Software B License. For details, see
+Copyright @copyright{} 1991-2006 Silicon Graphics, Inc. This document is
+licensed under the SGI Free Software B License. For details, see
@uref{http://oss.sgi.com/projects/FreeB/,http://oss.sgi.com/projects/FreeB/}.
@end copying
Specifies the screen number.
@item @var{attrib_list}
-Specifies a list of attribute/value pairs. The last attribute must be
+Specifies a list of attribute/value pairs. The last attribute must be
@code{None}.
@item @var{nelements}
@code{glXChooseFBConfig} returns GLX frame buffer configurations that
match the attributes specified in @var{attrib_list}, or @code{NULL} if
-no matches are found. If @var{attrib_list} is @code{NULL}, then
+no matches are found. If @var{attrib_list} is @code{NULL}, then
@code{glXChooseFBConfig} returns an array of GLX frame buffer
-configurations that are available on the specified screen. If an error
+configurations that are available on the specified screen. If an error
occurs, no frame buffer configurations exist on the specified screen, or
if no frame buffer configurations match the specified attributes, then
-@code{NULL} is returned. Use @code{XFree} to free the memory returned
-by @code{glXChooseFBConfig}.
+@code{NULL} is returned. Use @code{XFree} to free the memory returned by
+@code{glXChooseFBConfig}.
All attributes in @var{attrib_list}, including boolean attributes, are
-immediately followed by the corresponding desired value. The list is
-terminated with @code{None}. If an attribute is not specified in
+immediately followed by the corresponding desired value. The list is
+terminated with @code{None}. If an attribute is not specified in
@var{attrib_list}, then the default value (see below) is used (and the
-attribute is said to be specified implicitly). For example, if
+attribute is said to be specified implicitly). For example, if
@code{GLX_STEREO} is not specified, then it is assumed to be
-@code{False}. For some attributes, the default is @code{GLX_DONT_CARE},
+@code{False}. For some attributes, the default is @code{GLX_DONT_CARE},
meaning that any value is OK for this attribute, so the attribute will
not be checked.
-Attributes are matched in an attribute-specific manner. Some of the
+Attributes are matched in an attribute-specific manner. Some of the
attributes, such as @code{GLX_LEVEL}, must match the specified value
exactly; others, such as, @code{GLX_RED_SIZE} must meet or exceed the
-specified minimum values. If more than one GLX frame buffer
+specified minimum values. If more than one GLX frame buffer
configuration is found, then a list of configurations, sorted according
-to the ``best'' match criteria, is returned. The match criteria for
-each attribute and the exact sorting order is defined below.
+to the ``best'' match criteria, is returned. The match criteria for each
+attribute and the exact sorting order is defined below.
The interpretations of the various GLX visual attributes are as follows:
Must be followed by a valid XID that indicates the desired GLX frame
-buffer configuration. When a @code{GLX_FBCONFIG_ID} is specified, all
-attributes are ignored. The default value is @code{GLX_DONT_CARE}.
+buffer configuration. When a @code{GLX_FBCONFIG_ID} is specified, all
+attributes are ignored. The default value is @code{GLX_DONT_CARE}.
@item @code{GLX_BUFFER_SIZE}
Must be followed by a nonnegative integer that indicates the desired
-color index buffer size. The smallest index buffer of at least the
-specified size is preferred. This attribute is ignored if
-@code{GLX_COLOR_INDEX_BIT} is not set in @code{GLX_RENDER_TYPE}. The
+color index buffer size. The smallest index buffer of at least the
+specified size is preferred. This attribute is ignored if
+@code{GLX_COLOR_INDEX_BIT} is not set in @code{GLX_RENDER_TYPE}. The
default value is 0.
@item @code{GLX_LEVEL}
-Must be followed by an integer buffer-level specification. This
-specification is honored exactly. Buffer level 0 corresponds to the
-default frame buffer of the display. Buffer level 1 is the first
-overlay frame buffer, level two the second overlay frame buffer, and so
-on. Negative buffer levels correspond to underlay frame buffers. The
-default value is 0.
+Must be followed by an integer buffer-level specification. This
+specification is honored exactly. Buffer level 0 corresponds to the
+default frame buffer of the display. Buffer level 1 is the first overlay
+frame buffer, level two the second overlay frame buffer, and so on.
+Negative buffer levels correspond to underlay frame buffers. The default
+value is 0.
@item @code{GLX_DOUBLEBUFFER}
-Must be followed by @code{True} or @code{False}. If @code{True} is
+Must be followed by @code{True} or @code{False}. If @code{True} is
specified, then only double-buffered frame buffer configurations are
considered; if @code{False} is specified, then only single-buffered
-frame buffer configurations are considered. The default value is
+frame buffer configurations are considered. The default value is
@code{GLX_DONT_CARE}.
@item @code{GLX_STEREO}
-Must be followed by @code{True} or @code{False}. If @code{True} is
+Must be followed by @code{True} or @code{False}. If @code{True} is
specified, then only stereo frame buffer configurations are considered;
if @code{False} is specified, then only monoscopic frame buffer
-configurations are considered. The default value is @code{False}.
+configurations are considered. The default value is @code{False}.
@item @code{GLX_AUX_BUFFERS}
Must be followed by a nonnegative integer that indicates the desired
-number of auxiliary buffers. Configurations with the smallest number of
+number of auxiliary buffers. Configurations with the smallest number of
auxiliary buffers that meet or exceed the specified number are
-preferred. The default value is 0.
+preferred. The default value is 0.
@item @code{GLX_RED_SIZE}, @code{GLX_GREEN_SIZE}, @code{GLX_BLUE_SIZE}, @code{GLX_ALPHA_SIZE}
Each attribute, if present, must be followed by a nonnegative minimum
-size specification or @code{GLX_DONT_CARE}. The largest available total
+size specification or @code{GLX_DONT_CARE}. The largest available total
RGBA color buffer size (sum of @code{GLX_RED_SIZE},
@code{GLX_GREEN_SIZE}, @code{GLX_BLUE_SIZE}, and @code{GLX_ALPHA_SIZE})
of at least the minimum size specified for each color component is
-preferred. If the requested number of bits for a color component is 0
-or @code{GLX_DONT_CARE}, it is not considered. The default value for
-each color component is 0.
+preferred. If the requested number of bits for a color component is 0 or
+@code{GLX_DONT_CARE}, it is not considered. The default value for each
+color component is 0.
@item @code{GLX_DEPTH_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, frame buffer configurations with no depth buffer are
-preferred. Otherwise, the largest available depth buffer of at least
-the minimum size is preferred. The default value is 0.
+preferred. Otherwise, the largest available depth buffer of at least the
+minimum size is preferred. The default value is 0.
@item @code{GLX_STENCIL_SIZE}
Must be followed by a nonnegative integer that indicates the desired
-number of stencil bitplanes. The smallest stencil buffer of at least
-the specified size is preferred. If the desired value is zero, frame
-buffer configurations with no stencil buffer are preferred. The default
-value is 0.
+number of stencil bitplanes. The smallest stencil buffer of at least the
+specified size is preferred. If the desired value is zero, frame buffer
+configurations with no stencil buffer are preferred. The default value
+is 0.
@item @code{GLX_ACCUM_RED_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, frame buffer configurations with no red accumulation
-buffer are preferred. Otherwise, the largest possible red accumulation
-buffer of at least the minimum size is preferred. The default value is
+buffer are preferred. Otherwise, the largest possible red accumulation
+buffer of at least the minimum size is preferred. The default value is
0.
@item @code{GLX_ACCUM_GREEN_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, frame buffer configurations with no green accumulation
-buffer are preferred. Otherwise, the largest possible green
-accumulation buffer of at least the minimum size is preferred. The
-default value is 0.
+buffer are preferred. Otherwise, the largest possible green accumulation
+buffer of at least the minimum size is preferred. The default value is
+0.
@item @code{GLX_ACCUM_BLUE_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, frame buffer configurations with no blue accumulation
-buffer are preferred. Otherwise, the largest possible blue accumulation
-buffer of at least the minimum size is preferred. The default value is
+buffer are preferred. Otherwise, the largest possible blue accumulation
+buffer of at least the minimum size is preferred. The default value is
0.
@item @code{GLX_ACCUM_ALPHA_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, frame buffer configurations with no alpha accumulation
-buffer are preferred. Otherwise, the largest possible alpha
-accumulation buffer of at least the minimum size is preferred. The
-default value is 0.
+buffer are preferred. Otherwise, the largest possible alpha accumulation
+buffer of at least the minimum size is preferred. The default value is
+0.
@item @code{GLX_RENDER_TYPE}
Must be followed by a mask indicating which OpenGL rendering modes the
-frame buffer configuration must support. Valid bits are
-@code{GLX_RGBA_BIT} and @code{GLX_COLOR_INDEX_BIT}. If the mask is set
+frame buffer configuration must support. Valid bits are
+@code{GLX_RGBA_BIT} and @code{GLX_COLOR_INDEX_BIT}. If the mask is set
to @code{GLX_RGBA_BIT} | @code{GLX_COLOR_INDEX_BIT}, then only frame
buffer configurations that can be bound to both RGBA contexts and color
-index contexts will be considered. The default value is
+index contexts will be considered. The default value is
@code{GLX_RGBA_BIT}.
@item @code{GLX_DRAWABLE_TYPE}
Must be followed by a mask indicating which GLX drawable types the frame
-buffer configuration must support. Valid bits are
-@code{GLX_WINDOW_BIT}, @code{GLX_PIXMAP_BIT}, and
-@code{GLX_PBUFFER_BIT}. For example, if mask is set to
-@code{GLX_WINDOW_BIT} | @code{GLX_PIXMAP_BIT}, only frame buffer
-configurations that support both windows and GLX pixmaps will be
-considered. The default value is @code{GLX_WINDOW_BIT}.
+buffer configuration must support. Valid bits are @code{GLX_WINDOW_BIT},
+@code{GLX_PIXMAP_BIT}, and @code{GLX_PBUFFER_BIT}. For example, if mask
+is set to @code{GLX_WINDOW_BIT} | @code{GLX_PIXMAP_BIT}, only frame
+buffer configurations that support both windows and GLX pixmaps will be
+considered. The default value is @code{GLX_WINDOW_BIT}.
@item @code{GLX_X_RENDERABLE}
-Must be followed by @code{True} or @code{False}. If @code{True} is
+Must be followed by @code{True} or @code{False}. If @code{True} is
specified, then only frame buffer configurations that have associated X
visuals (and can be used to render to Windows and/or GLX pixmaps) will
-be considered. The default value is @code{GLX_DONT_CARE}.
+be considered. The default value is @code{GLX_DONT_CARE}.
@item @code{GLX_X_VISUAL_TYPE}
Must be followed by one of @code{GLX_TRUE_COLOR},
@code{GLX_DIRECT_COLOR}, @code{GLX_PSEUDO_COLOR},
@code{GLX_STATIC_COLOR}, @code{GLX_GRAY_SCALE}, or
-@code{GLX_STATIC_GRAY}, indicating the desired X visual type. Not all
-frame buffer configurations have an associated X visual. If
+@code{GLX_STATIC_GRAY}, indicating the desired X visual type. Not all
+frame buffer configurations have an associated X visual. If
@code{GLX_DRAWABLE_TYPE} is specified in @var{attrib_list} and the mask
that follows does not have @code{GLX_WINDOW_BIT} set, then this value is
-ignored. It is also ignored if @code{GLX_X_RENDERABLE} is specified as
-@code{False}. RGBA rendering may be supported for visuals of type
+ignored. It is also ignored if @code{GLX_X_RENDERABLE} is specified as
+@code{False}. RGBA rendering may be supported for visuals of type
@code{GLX_TRUE_COLOR}, @code{GLX_DIRECT_COLOR}, @code{GLX_PSEUDO_COLOR},
or @code{GLX_STATIC_COLOR}, but color index rendering is only supported
for visuals of type @code{GLX_PSEUDO_COLOR} or @code{GLX_STATIC_COLOR}
-(i.e., single-channel visuals). The tokens @code{GLX_GRAY_SCALE} and
+(i.e., single-channel visuals). The tokens @code{GLX_GRAY_SCALE} and
@code{GLX_STATIC_GRAY} will not match current OpenGL enabled visuals,
-but are included for future use. The default value for
+but are included for future use. The default value for
@code{GLX_X_VISUAL_TYPE} is @code{GLX_DONT_CARE}.
@item @code{GLX_CONFIG_CAVEAT}
Must be followed by one of @code{GLX_NONE}, @code{GLX_SLOW_CONFIG},
-@code{GLX_NON_CONFORMANT_CONFIG}. If @code{GLX_NONE} is specified, then
+@code{GLX_NON_CONFORMANT_CONFIG}. If @code{GLX_NONE} is specified, then
only frame buffer configurations with no caveats will be considered; if
@code{GLX_SLOW_CONFIG} is specified, then only slow frame buffer
configurations will be considered; if @code{GLX_NON_CONFORMANT_CONFIG}
is specified, then only nonconformant frame buffer configurations will
-be considered. The default value is @code{GLX_DONT_CARE}.
+be considered. The default value is @code{GLX_DONT_CARE}.
@item @code{GLX_TRANSPARENT_TYPE}
Must be followed by one of @code{GLX_NONE}, @code{GLX_TRANSPARENT_RGB},
-@code{GLX_TRANSPARENT_INDEX}. If @code{GLX_NONE} is specified, then
-only opaque frame buffer configurations will be considered; if
+@code{GLX_TRANSPARENT_INDEX}. If @code{GLX_NONE} is specified, then only
+opaque frame buffer configurations will be considered; if
@code{GLX_TRANSPARENT_RGB} is specified, then only transparent frame
buffer configurations that support RGBA rendering will be considered; if
@code{GLX_TRANSPARENT_INDEX} is specified, then only transparent frame
buffer configurations that support color index rendering will be
-considered. The default value is @code{GLX_NONE}.
+considered. The default value is @code{GLX_NONE}.
@item @code{GLX_TRANSPARENT_INDEX_VALUE}
Must be followed by an integer value indicating the transparent index
value; the value must be between 0 and the maximum frame buffer value
-for indices. Only frame buffer configurations that use the specified
-transparent index value will be considered. The default value is
-@code{GLX_DONT_CARE}. This attribute is ignored unless
+for indices. Only frame buffer configurations that use the specified
+transparent index value will be considered. The default value is
+@code{GLX_DONT_CARE}. This attribute is ignored unless
@code{GLX_TRANSPARENT_TYPE} is included in @var{attrib_list} and
specified as @code{GLX_TRANSPARENT_INDEX}.
Must be followed by an integer value indicating the transparent red
value; the value must be between 0 and the maximum frame buffer value
-for red. Only frame buffer configurations that use the specified
-transparent red value will be considered. The default value is
-@code{GLX_DONT_CARE}. This attribute is ignored unless
+for red. Only frame buffer configurations that use the specified
+transparent red value will be considered. The default value is
+@code{GLX_DONT_CARE}. This attribute is ignored unless
@code{GLX_TRANSPARENT_TYPE} is included in @var{attrib_list} and
specified as @code{GLX_TRANSPARENT_RGB}.
Must be followed by an integer value indicating the transparent green
value; the value must be between 0 and the maximum frame buffer value
-for green. Only frame buffer configurations that use the specified
-transparent green value will be considered. The default value is
-@code{GLX_DONT_CARE}. This attribute is ignored unless
+for green. Only frame buffer configurations that use the specified
+transparent green value will be considered. The default value is
+@code{GLX_DONT_CARE}. This attribute is ignored unless
@code{GLX_TRANSPARENT_TYPE} is included in @var{attrib_list} and
specified as @code{GLX_TRANSPARENT_RGB}.
Must be followed by an integer value indicating the transparent blue
value; the value must be between 0 and the maximum frame buffer value
-for blue. Only frame buffer configurations that use the specified
-transparent blue value will be considered. The default value is
-@code{GLX_DONT_CARE}. This attribute is ignored unless
+for blue. Only frame buffer configurations that use the specified
+transparent blue value will be considered. The default value is
+@code{GLX_DONT_CARE}. This attribute is ignored unless
@code{GLX_TRANSPARENT_TYPE} is included in @var{attrib_list} and
specified as @code{GLX_TRANSPARENT_RGB}.
Must be followed by an integer value indicating the transparent alpha
value; the value must be between 0 and the maximum frame buffer value
-for alpha. Only frame buffer configurations that use the specified
-transparent alpha value will be considered. The default value is
+for alpha. Only frame buffer configurations that use the specified
+transparent alpha value will be considered. The default value is
@code{GLX_DONT_CARE}.
@end table
When more than one GLX frame buffer configuration matches the specified
-attributes, a list of matching configurations is returned. The list is
+attributes, a list of matching configurations is returned. The list is
sorted according to the following precedence rules, which are applied in
ascending order (i.e., configurations that are considered equal by a
lower numbered rule are sorted by the higher numbered rule):
@item 2.
Larger total number of RGBA color components (@code{GLX_RED_SIZE},
@code{GLX_GREEN_SIZE}, @code{GLX_BLUE_SIZE}, plus @code{GLX_ALPHA_SIZE})
-that have higher number of bits. If the requested number of bits in
+that have higher number of bits. If the requested number of bits in
@var{attrib_list} is zero or @code{GLX_DONT_CARE} for a particular color
component, then the number of bits for that component is not considered.
Larger total number of accumulation buffer color components
(@code{GLX_ACCUM_RED_SIZE}, @code{GLX_ACCUM_GREEN_SIZE},
@code{GLX_ACCUM_BLUE_SIZE}, plus @code{GLX_ACCUM_ALPHA_SIZE}) that have
-higher number of bits. If the requested number of bits in
+higher number of bits. If the requested number of bits in
@var{attrib_list} is zero or @code{GLX_DONT_CARE} for a particular color
component, then the number of bits for that component is not considered.
@item @var{attribList}
Specifies a list of boolean attributes and integer attribute/value
-pairs. The last attribute must be @code{None}.
+pairs. The last attribute must be @code{None}.
@end table
@code{glXChooseVisual} returns a pointer to an XVisualInfo structure
-describing the visual that best meets a minimum specification. The
+describing the visual that best meets a minimum specification. The
boolean GLX attributes of the visual that is returned will match the
specified values, and the integer GLX attributes will meet or exceed the
-specified minimum values. If all other attributes are equivalent, then
+specified minimum values. If all other attributes are equivalent, then
TrueColor and PseudoColor visuals have priority over DirectColor and
-StaticColor visuals, respectively. If no conforming visual exists,
-@code{NULL} is returned. To free the data returned by this function,
-use @code{XFree}.
+StaticColor visuals, respectively. If no conforming visual exists,
+@code{NULL} is returned. To free the data returned by this function, use
+@code{XFree}.
All boolean GLX attributes default to @code{False} except
-@code{GLX_USE_GL}, which defaults to @code{True}. All integer GLX
-attributes default to zero. Default specifications are superseded by
-attributes included in @var{attribList}. Boolean attributes included in
-@var{attribList} are understood to be @code{True}. Integer attributes
+@code{GLX_USE_GL}, which defaults to @code{True}. All integer GLX
+attributes default to zero. Default specifications are superseded by
+attributes included in @var{attribList}. Boolean attributes included in
+@var{attribList} are understood to be @code{True}. Integer attributes
and enumerated type attributes are followed immediately by the
-corresponding desired or minimum value. The list must be terminated
-with @code{None}.
+corresponding desired or minimum value. The list must be terminated with
+@code{None}.
The interpretations of the various GLX visual attributes are as follows:
@table @asis
@item @code{GLX_USE_GL}
-Ignored. Only visuals that can be rendered with GLX are considered.
+Ignored. Only visuals that can be rendered with GLX are considered.
@item @code{GLX_BUFFER_SIZE}
Must be followed by a nonnegative integer that indicates the desired
-color index buffer size. The smallest index buffer of at least the
-specified size is preferred. Ignored if @code{GLX_RGBA} is asserted.
+color index buffer size. The smallest index buffer of at least the
+specified size is preferred. Ignored if @code{GLX_RGBA} is asserted.
@item @code{GLX_LEVEL}
-Must be followed by an integer buffer-level specification. This
-specification is honored exactly. Buffer level zero corresponds to the
-main frame buffer of the display. Buffer level one is the first overlay
+Must be followed by an integer buffer-level specification. This
+specification is honored exactly. Buffer level zero corresponds to the
+main frame buffer of the display. Buffer level one is the first overlay
frame buffer, level two the second overlay frame buffer, and so on.
Negative buffer levels correspond to underlay frame buffers.
Otherwise, only PseudoColor and StaticColor visuals are considered.
@item @code{GLX_DOUBLEBUFFER}
-If present, only double-buffered visuals are considered. Otherwise,
-only single-buffered visuals are considered.
+If present, only double-buffered visuals are considered. Otherwise, only
+single-buffered visuals are considered.
@item @code{GLX_STEREO}
-If present, only stereo visuals are considered. Otherwise, only
+If present, only stereo visuals are considered. Otherwise, only
monoscopic visuals are considered.
@item @code{GLX_AUX_BUFFERS}
Must be followed by a nonnegative integer that indicates the desired
-number of auxiliary buffers. Visuals with the smallest number of
+number of auxiliary buffers. Visuals with the smallest number of
auxiliary buffers that meets or exceeds the specified number are
preferred.
@item @code{GLX_RED_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, the smallest available red buffer is preferred.
Otherwise, the largest available red buffer of at least the minimum size
is preferred.
@item @code{GLX_GREEN_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, the smallest available green buffer is preferred.
Otherwise, the largest available green buffer of at least the minimum
size is preferred.
@item @code{GLX_BLUE_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, the smallest available blue buffer is preferred.
Otherwise, the largest available blue buffer of at least the minimum
size is preferred.
@item @code{GLX_ALPHA_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, the smallest available alpha buffer is preferred.
Otherwise, the largest available alpha buffer of at least the minimum
size is preferred.
@item @code{GLX_DEPTH_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
-value is zero, visuals with no depth buffer are preferred. Otherwise,
+Must be followed by a nonnegative minimum size specification. If this
+value is zero, visuals with no depth buffer are preferred. Otherwise,
the largest available depth buffer of at least the minimum size is
preferred.
@item @code{GLX_STENCIL_SIZE}
Must be followed by a nonnegative integer that indicates the desired
-number of stencil bitplanes. The smallest stencil buffer of at least
-the specified size is preferred. If the desired value is zero, visuals
-with no stencil buffer are preferred.
+number of stencil bitplanes. The smallest stencil buffer of at least the
+specified size is preferred. If the desired value is zero, visuals with
+no stencil buffer are preferred.
@item @code{GLX_ACCUM_RED_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, visuals with no red accumulation buffer are preferred.
Otherwise, the largest possible red accumulation buffer of at least the
minimum size is preferred.
@item @code{GLX_ACCUM_GREEN_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, visuals with no green accumulation buffer are preferred.
Otherwise, the largest possible green accumulation buffer of at least
the minimum size is preferred.
@item @code{GLX_ACCUM_BLUE_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, visuals with no blue accumulation buffer are preferred.
Otherwise, the largest possible blue accumulation buffer of at least the
minimum size is preferred.
@item @code{GLX_ACCUM_ALPHA_SIZE}
-Must be followed by a nonnegative minimum size specification. If this
+Must be followed by a nonnegative minimum size specification. If this
value is zero, visuals with no alpha accumulation buffer are preferred.
Otherwise, the largest possible alpha accumulation buffer of at least
the minimum size is preferred.
@end table
@code{glXCopyContext} copies selected groups of state variables from
-@var{src} to @var{dst}. @var{mask} indicates which groups of state
-variables are to be copied. @var{mask} contains the bitwise OR of the
+@var{src} to @var{dst}. @var{mask} indicates which groups of state
+variables are to be copied. @var{mask} contains the bitwise OR of the
same symbolic names that are passed to the GL command
-@code{glPushAttrib}. The single symbolic constant
+@code{glPushAttrib}. The single symbolic constant
@code{GLX_ALL_ATTRIB_BITS} can be used to copy the maximum possible
portion of rendering state.
The copy can be done only if the renderers named by @var{src} and
-@var{dst} share an address space. Two rendering contexts share an
+@var{dst} share an address space. Two rendering contexts share an
address space if both are nondirect using the same server, or if both
-are direct and owned by a single process. Note that in the nondirect
+are direct and owned by a single process. Note that in the nondirect
case it is not necessary for the calling threads to share an address
space, only for their related rendering contexts to share an address
space.
-Not all values for GL state can be copied. For example, pixel pack and
+Not all values for GL state can be copied. For example, pixel pack and
unpack state, render mode state, and select and feedback state are not
-copied. The state that can be copied is exactly the state that is
+copied. The state that can be copied is exactly the state that is
manipulated by the GL command @code{glPushAttrib}.
An implicit @code{glFlush} is done by @code{glXCopyContext} if @var{src}
@item @var{vis}
Specifies the visual that defines the frame buffer resources available
-to the rendering context. It is a pointer to an @code{XVisualInfo}
+to the rendering context. It is a pointer to an @code{XVisualInfo}
structure, not a visual ID or a pointer to a @code{Visual}.
@item @var{shareList}
-Specifies the context with which to share display lists. @code{NULL}
+Specifies the context with which to share display lists. @code{NULL}
indicates that no sharing is to take place.
@item @var{direct}
@end table
@code{glXCreateContext} creates a GLX rendering context and returns its
-handle. This context can be used to render into both windows and GLX
-pixmaps. If @code{glXCreateContext} fails to create a rendering
-context, @code{NULL} is returned.
+handle. This context can be used to render into both windows and GLX
+pixmaps. If @code{glXCreateContext} fails to create a rendering context,
+@code{NULL} is returned.
If @var{direct} is @code{True}, then a direct rendering context is
created if the implementation supports direct rendering, if the
connection is to an X server that is local, and if a direct rendering
-context is available. (An implementation may return an indirect context
+context is available. (An implementation may return an indirect context
when @var{direct} is @code{True}.) If @var{direct} is @code{False}, then
a rendering context that renders through the X server is always created.
Direct rendering provides a performance advantage in some
-implementations. However, direct rendering contexts cannot be shared
+implementations. However, direct rendering contexts cannot be shared
outside a single process, and they may be unable to render to GLX
pixmaps.
If @var{shareList} is not @code{NULL}, then all display-list indexes and
definitions are shared by context @var{shareList} and by the newly
-created context. An arbitrary number of contexts can share a single
-display-list space. However, all rendering contexts that share a single
-display-list space must themselves exist in the same address space. Two
+created context. An arbitrary number of contexts can share a single
+display-list space. However, all rendering contexts that share a single
+display-list space must themselves exist in the same address space. Two
rendering contexts share an address space if both are nondirect using
the same server, or if both are direct and owned by a single process.
Note that in the nondirect case, it is not necessary for the calling
@end table
@code{glXCreateGLXPixmap} creates an off-screen rendering area and
-returns its XID. Any GLX rendering context that was created with
-respect to @var{vis} can be used to render into this off-screen area.
-Use @code{glXMakeCurrent} to associate the rendering area with a GLX
+returns its XID. Any GLX rendering context that was created with respect
+to @var{vis} can be used to render into this off-screen area. Use
+@code{glXMakeCurrent} to associate the rendering area with a GLX
rendering context.
The X pixmap identified by @var{pixmap} is used as the front left buffer
-of the resulting off-screen rendering area. All other buffers specified
+of the resulting off-screen rendering area. All other buffers specified
by @var{vis}, including color buffers other than the front left buffer,
-are created without externally visible names. GLX pixmaps with
-double-buffering are supported. However, @code{glXSwapBuffers} is
+are created without externally visible names. GLX pixmaps with
+double-buffering are supported. However, @code{glXSwapBuffers} is
ignored by these pixmaps.
Some implementations may not support GLX pixmaps with direct rendering
context.
@item @var{render_type}
-Specifies the type of the context to be created. Must be one of
+Specifies the type of the context to be created. Must be one of
@code{GLX_RGBA_TYPE} or @code{GLX_COLOR_INDEX_TYPE}.
@item @var{share_list}
-Specifies the context with which to share display lists. @code{NULL}
+Specifies the context with which to share display lists. @code{NULL}
indicates that no sharing is to take place.
@item @var{share_list}
@end table
@code{glXCreateNewContext} creates a GLX rendering context and returns
-its handle. This context can be used to render into GLX windows,
-pixmaps, or pixel buffers. If @code{glXCreateNewContext} fails to
-create a rendering context, @code{NULL} is returned.
+its handle. This context can be used to render into GLX windows,
+pixmaps, or pixel buffers. If @code{glXCreateNewContext} fails to create
+a rendering context, @code{NULL} is returned.
If @var{render_type} is @code{GLX_RGBA_TYPE}, then a context that
-supports RGBA rendering is created. If @var{config} is
+supports RGBA rendering is created. If @var{config} is
@code{GLX_COLOR_INDEX_TYPE}, then context supporting color-index
rendering is created.
If @var{render_type} is not @code{NULL}, then all display-list indexes
and definitions are shared by context @var{render_type} and by the newly
-created context. An arbitrary number of contexts can share a single
-display-list space. However, all rendering contexts that share a single
-display-list space must themselves exist in the same address space. Two
+created context. An arbitrary number of contexts can share a single
+display-list space. However, all rendering contexts that share a single
+display-list space must themselves exist in the same address space. Two
rendering contexts share an address space if both are nondirect using
the same server, or if both are direct and owned by a single process.
Note that in the nondirect case, it is not necessary for the calling
If @var{share_list} is @code{True}, then a direct-rendering context is
created if the implementation supports direct rendering, if the
connection is to an X server that is local, and if a direct-rendering
-context is available. (An implementation may return an indirect context
+context is available. (An implementation may return an indirect context
when @var{share_list} is @code{True}.) If @var{share_list} is
@code{False}, then a rendering context that renders through the X server
-is always created. Direct rendering provides a performance advantage in
-some implementations. However, direct-rendering contexts cannot be
+is always created. Direct rendering provides a performance advantage in
+some implementations. However, direct-rendering contexts cannot be
shared outside a single process, and they may be unable to render to GLX
pixmaps.
@item @var{attrib_list}
Specifies a list of attribute value pairs, which must be terminated with
-@code{None} or @code{NULL}. Accepted attributes are
+@code{None} or @code{NULL}. Accepted attributes are
@code{GLX_PBUFFER_WIDTH}, @code{GLX_PBUFFER_HEIGHT},
@code{GLX_PRESERVED_CONTENTS}, and @code{GLX_LARGEST_PBUFFER}.
@end table
@code{glXCreatePbuffer} creates an off-screen rendering area and returns
-its XID. Any GLX rendering context that was created with respect to
-@var{config} can be used to render into this window. Use
+its XID. Any GLX rendering context that was created with respect to
+@var{config} can be used to render into this window. Use
@code{glXMakeContextCurrent} to associate the rendering area with a GLX
rendering context.
@table @asis
@item @code{GLX_PBUFFER_WIDTH}
-Specify the pixel width of the requested GLXPbuffer. The default value
+Specify the pixel width of the requested GLXPbuffer. The default value
is 0.
@item @code{GLX_PBUFFER_HEIGHT}
-Specify the pixel height of the requested GLXPbuffer. The default value
+Specify the pixel height of the requested GLXPbuffer. The default value
is 0.
@item @code{GLX_LARGEST_PBUFFER}
Specify to obtain the largest available pixel buffer, if the requested
-allocation would have failed. The width and height of the allocated
+allocation would have failed. The width and height of the allocated
pixel buffer will never exceed the specified @code{GLX_PBUFFER_WIDTH} or
-@code{GLX_PBUFFER_HEIGHT}, respectively. Use @code{glXQueryDrawable} to
-retrieve the dimensions of the allocated pixel buffer. The default
-value is @code{False}.
+@code{GLX_PBUFFER_HEIGHT}, respectively. Use @code{glXQueryDrawable} to
+retrieve the dimensions of the allocated pixel buffer. The default value
+is @code{False}.
@item @code{GLX_PRESERVED_CONTENTS}
Specify if the contents of the pixel buffer should be preserved when a
-resource conflict occurs. If set to @code{False}, the contents of the
-pixel buffer may be lost at any time. If set to @code{True}, or not
+resource conflict occurs. If set to @code{False}, the contents of the
+pixel buffer may be lost at any time. If set to @code{True}, or not
specified in @var{attrib_list}, then the contents of the pixel buffer
will be preserved (most likely by copying the contents into main system
-memory from the frame buffer). In either case, the client can register
+memory from the frame buffer). In either case, the client can register
(using @code{glXSelectEvent}, to receive pixel buffer clobber events
that are generated when the pbuffer contents have been preserved or
damaged.
@end table
GLXPbuffers contain the color and ancillary buffers specified by
-@var{config}. It is possible to create a pixel buffer with back buffers
+@var{config}. It is possible to create a pixel buffer with back buffers
and to swap those buffers using @code{glXSwapBuffers}.
@code{BadAlloc} is generated if there are insufficient resources to
Specifies the X pixmap to be used as the rendering area.
@item @var{attrib_list}
-Currently unused. This must be set to @code{NULL} or be an empty list
+Currently unused. This must be set to @code{NULL} or be an empty list
(i.e., one in which the first element is @code{None}).
@end table
@code{glXCreatePixmap} creates an off-screen rendering area and returns
-its XID. Any GLX rendering context that was created with respect to
-@var{config} can be used to render into this window. Use
+its XID. Any GLX rendering context that was created with respect to
+@var{config} can be used to render into this window. Use
@code{glXMakeCurrent} to associate the rendering area with a GLX
rendering context.
Specifies the X window to be used as the rendering area.
@item @var{attrib_list}
-Currently unused. This must be set to @code{NULL} or be an empty list
+Currently unused. This must be set to @code{NULL} or be an empty list
(i.e., one in which the first element is @code{None}).
@end table
@code{glXCreateWindow} creates an on-screen rendering area from an
existing X window that was created with a visual matching @var{config}.
-The XID of the GLXWindow is returned. Any GLX rendering context that
-was created with respect to @var{config} can be used to render into this
-window. Use @code{glXMakeContextCurrent} to associate the rendering
-area with a GLX rendering context.
+The XID of the GLXWindow is returned. Any GLX rendering context that was
+created with respect to @var{config} can be used to render into this
+window. Use @code{glXMakeContextCurrent} to associate the rendering area
+with a GLX rendering context.
@code{BadMatch} is generated if @var{win} was not created with a visual
that corresponds to @var{config}.
@end table
If the GLX rendering context @var{ctx} is not current to any thread,
-@code{glXDestroyContext} destroys it immediately. Otherwise, @var{ctx}
-is destroyed when it becomes not current to any thread. In either case,
+@code{glXDestroyContext} destroys it immediately. Otherwise, @var{ctx}
+is destroyed when it becomes not current to any thread. In either case,
the resource ID referenced by @var{ctx} is freed immediately.
@code{GLXBadContext} is generated if @var{ctx} is not a valid GLX
@end table
If the GLX pixmap @var{pix} is not current to any client,
-@code{glXDestroyGLXPixmap} destroys it immediately. Otherwise,
-@var{pix} is destroyed when it becomes not current to any client. In
-either case, the resource ID is freed immediately.
+@code{glXDestroyGLXPixmap} destroys it immediately. Otherwise, @var{pix}
+is destroyed when it becomes not current to any client. In either case,
+the resource ID is freed immediately.
@code{GLXBadPixmap} is generated if @var{pix} is not a valid GLX pixmap.
@end table
@code{glXFreeContextEXT} frees the client-side part of a GLXContext that
-was created with @code{glXImportContextEXT}. @code{glXFreeContextEXT}
+was created with @code{glXImportContextEXT}. @code{glXFreeContextEXT}
does not free the server-side context information or the XID associated
with the server-side context.
@code{glXFreeContextEXT} is part of the @code{EXT_import_context}
-extension, not part of the core GLX command set. If
+extension, not part of the core GLX command set. If
_glxextstring(EXT_import_context) is included in the string returned by
@code{glXQueryExtensionsString}, when called with argument
@code{GLX_EXTENSIONS}, extension @code{EXT_vertex_array} is supported.
Specifies the connection to the X server.
@item @var{name}
-Specifies which string is returned. The symbolic constants
+Specifies which string is returned. The symbolic constants
@code{GLX_VENDOR}, @code{GLX_VERSION}, and @code{GLX_EXTENSIONS} are
accepted.
@end table
@code{glXGetClientString} returns a string describing some aspect of the
-client library. The possible values for @var{name} are
-@code{GLX_VENDOR}, @code{GLX_VERSION}, and @code{GLX_EXTENSIONS}. If
+client library. The possible values for @var{name} are
+@code{GLX_VENDOR}, @code{GLX_VERSION}, and @code{GLX_EXTENSIONS}. If
@var{name} is not set to one of these values, @code{glXGetClientString}
-returns @code{NULL}. The format and contents of the vendor string is
+returns @code{NULL}. The format and contents of the vendor string is
implementation dependent.
The extensions string is null-terminated and contains a space-separated
-list of extension names. (The extension names never contain spaces.) If
+list of extension names. (The extension names never contain spaces.) If
there are no extensions to GLX, then the empty string is returned.
The version string is laid out as follows:
<major_version.minor_version><space><vendor-specific info>
Both the major and minor portions of the version number are of arbitrary
-length. The vendor-specific information is optional. However, if it is
+length. The vendor-specific information is optional. However, if it is
present, the format and contents are implementation specific.
@end deftypefun
Specifies the connection to the X server.
@item @var{vis}
-Specifies the visual to be queried. It is a pointer to an
+Specifies the visual to be queried. It is a pointer to an
@code{XVisualInfo} structure, not a visual ID or a pointer to a
@code{Visual}.
@code{False} otherwise.
@item @code{GLX_BUFFER_SIZE}
-Number of bits per color buffer. For RGBA visuals,
+Number of bits per color buffer. For RGBA visuals,
@code{GLX_BUFFER_SIZE} is the sum of @code{GLX_RED_SIZE},
@code{GLX_GREEN_SIZE}, @code{GLX_BLUE_SIZE}, and @code{GLX_ALPHA_SIZE}.
For color index visuals, @code{GLX_BUFFER_SIZE} is the size of the color
indexes.
@item @code{GLX_LEVEL}
-Frame buffer level of the visual. Level zero is the default frame
-buffer. Positive levels correspond to frame buffers that overlay the
+Frame buffer level of the visual. Level zero is the default frame
+buffer. Positive levels correspond to frame buffers that overlay the
default buffer, and negative levels correspond to frame buffers that
underlay the default buffer.
otherwise.
@item @code{GLX_AUX_BUFFERS}
-Number of auxiliary color buffers that are available. Zero indicates
+Number of auxiliary color buffers that are available. Zero indicates
that no auxiliary color buffers exist.
@item @code{GLX_RED_SIZE}
-Number of bits of red stored in each color buffer. Undefined if
+Number of bits of red stored in each color buffer. Undefined if
@code{GLX_RGBA} is @code{False}.
@item @code{GLX_GREEN_SIZE}
-Number of bits of green stored in each color buffer. Undefined if
+Number of bits of green stored in each color buffer. Undefined if
@code{GLX_RGBA} is @code{False}.
@item @code{GLX_BLUE_SIZE}
-Number of bits of blue stored in each color buffer. Undefined if
+Number of bits of blue stored in each color buffer. Undefined if
@code{GLX_RGBA} is @code{False}.
@item @code{GLX_ALPHA_SIZE}
-Number of bits of alpha stored in each color buffer. Undefined if
+Number of bits of alpha stored in each color buffer. Undefined if
@code{GLX_RGBA} is @code{False}.
@item @code{GLX_DEPTH_SIZE}
@end table
The X protocol allows a single visual ID to be instantiated with
-different numbers of bits per pixel. Windows or GLX pixmaps that will
-be rendered with OpenGL, however, must be instantiated with a color
-buffer depth of @code{GLX_BUFFER_SIZE}.
+different numbers of bits per pixel. Windows or GLX pixmaps that will be
+rendered with OpenGL, however, must be instantiated with a color buffer
+depth of @code{GLX_BUFFER_SIZE}.
Although a GLX implementation can export many visuals that support GL
-rendering, it must support at least one RGBA visual. This visual must
+rendering, it must support at least one RGBA visual. This visual must
have at least one color buffer, a stencil buffer of at least 1 bit, a
-depth buffer of at least 12 bits, and an accumulation buffer. Alpha
-bitplanes are optional in this visual. However, its color buffer size
+depth buffer of at least 12 bits, and an accumulation buffer. Alpha
+bitplanes are optional in this visual. However, its color buffer size
must be as great as that of the deepest @code{TrueColor},
@code{DirectColor}, @code{PseudoColor}, or @code{StaticColor} visual
supported on level zero, and it must itself be made available on level
In addition, if the X server exports a @code{PseudoColor} or
@code{StaticColor} visual on framebuffer level 0, a color index visual
-is also required on that level. It must have at least one color buffer,
+is also required on that level. It must have at least one color buffer,
a stencil buffer of at least 1 bit, and a depth buffer of at least 12
-bits. This visual must have as many color bitplanes as the deepest
+bits. This visual must have as many color bitplanes as the deepest
@code{PseudoColor} or @code{StaticColor} visual supported on level 0.
Applications are best written to select the visual that most closely
-meets their requirements. Creating windows or GLX pixmaps with
+meets their requirements. Creating windows or GLX pixmaps with
unnecessary buffers can result in reduced rendering performance as well
as poor resource allocation.
value, @code{glXGetContextIDEXT} does not flush any pending events.
@code{glXGetContextIDEXT} is part of the @code{EXT_import_context}
-extension, not part of the core GLX command set. If
+extension, not part of the core GLX command set. If
_glxextstring(EXT_import_context) is included in the string returned by
@code{glXQueryExtensionsString}, when called with argument
@code{GLX_EXTENSIONS}, extension @code{EXT_import_context} is supported.
Return the current context.
@code{glXGetCurrentContext} returns the current context, as specified by
-@code{glXMakeCurrent}. If there is no current context, @code{NULL} is
+@code{glXMakeCurrent}. If there is no current context, @code{NULL} is
returned.
-@code{glXGetCurrentContext} returns client-side information. It does
-not make a round trip to the server.
+@code{glXGetCurrentContext} returns client-side information. It does not
+make a round trip to the server.
@code{glXGetCurrentDisplay} returns the display for the current context.
If no context is current, @code{NULL} is returned.
-@code{glXGetCurrentDisplay} returns client-side information. It does
-not make a round-trip to the server, and therefore does not flush any
+@code{glXGetCurrentDisplay} returns client-side information. It does not
+make a round-trip to the server, and therefore does not flush any
pending events.
@end deftypefun
Return the current drawable.
@code{glXGetCurrentDrawable} returns the current drawable, as specified
-by @code{glXMakeCurrent}. If there is no current drawable, @code{None}
+by @code{glXMakeCurrent}. If there is no current drawable, @code{None}
is returned.
-@code{glXGetCurrentDrawable} returns client-side information. It does
+@code{glXGetCurrentDrawable} returns client-side information. It does
not make a round trip to the server.
@end deftypefun
Return the current drawable.
@code{glXGetCurrentReadDrawable} returns the current read drawable, as
-specified by @code{read} parameter of @code{glXMakeContextCurrent}. If
+specified by @code{read} parameter of @code{glXMakeContextCurrent}. If
there is no current drawable, @code{None} is returned.
-@code{glXGetCurrentReadDrawable} returns client-side information. It
+@code{glXGetCurrentReadDrawable} returns client-side information. It
does not make a round-trip to the server.
@end deftypefun
@code{glXGetFBConfigAttrib} sets @var{value} to the @var{attribute}
value of GLX drawables created with respect to @var{config}.
@code{glXGetFBConfigAttrib} returns an error code if it fails for any
-reason. Otherwise, @code{Success} is returned.
+reason. Otherwise, @code{Success} is returned.
@var{attribute} is one of the following:
@item @code{GLX_BUFFER_SIZE}
-Number of bits per color buffer. If the frame buffer configuration
+Number of bits per color buffer. If the frame buffer configuration
supports RGBA contexts, then @code{GLX_BUFFER_SIZE} is the sum of
@code{GLX_RED_SIZE}, @code{GLX_GREEN_SIZE}, @code{GLX_BLUE_SIZE}, and
-@code{GLX_ALPHA_SIZE}. If the frame buffer configuration supports only
+@code{GLX_ALPHA_SIZE}. If the frame buffer configuration supports only
color index contexts, @code{GLX_BUFFER_SIZE} is the size of the color
indexes.
@item @code{GLX_LEVEL}
-Frame buffer level of the configuration. Level zero is the default
-frame buffer. Positive levels correspond to frame buffers that overlay
-the default buffer, and negative levels correspond to frame buffers that
+Frame buffer level of the configuration. Level zero is the default frame
+buffer. Positive levels correspond to frame buffers that overlay the
+default buffer, and negative levels correspond to frame buffers that
underlie the default buffer.
@item @code{GLX_DOUBLEBUFFER}
@item @code{GLX_AUX_BUFFERS}
-Number of auxiliary color buffers that are available. Zero indicates
+Number of auxiliary color buffers that are available. Zero indicates
that no auxiliary color buffers exist.
@item @code{GLX_RED_SIZE}
-Number of bits of red stored in each color buffer. Undefined if RGBA
+Number of bits of red stored in each color buffer. Undefined if RGBA
contexts are not supported by the frame buffer configuration.
@item @code{GLX_GREEN_SIZE}
-Number of bits of green stored in each color buffer. Undefined if RGBA
+Number of bits of green stored in each color buffer. Undefined if RGBA
contexts are not supported by the frame buffer configuration.
@item @code{GLX_BLUE_SIZE}
-Number of bits of blue stored in each color buffer. Undefined if RGBA
+Number of bits of blue stored in each color buffer. Undefined if RGBA
contexts are not supported by the frame buffer configuration.
@item @code{GLX_ALPHA_SIZE}
-Number of bits of alpha stored in each color buffer. Undefined if RGBA
+Number of bits of alpha stored in each color buffer. Undefined if RGBA
contexts are not supported by the frame buffer configuration.
@item @code{GLX_DEPTH_SIZE}
Mask indicating what type of GLX contexts can be made current to the
-frame buffer configuration. Valid bits are @code{GLX_RGBA_BIT} and
+frame buffer configuration. Valid bits are @code{GLX_RGBA_BIT} and
@code{GLX_COLOR_INDEX_BIT}.
@item @code{GLX_DRAWABLE_TYPE}
Mask indicating what drawable types the frame buffer configuration
-supports. Valid bits are @code{GLX_WINDOW_BIT}, @code{GLX_PIXMAP_BIT},
+supports. Valid bits are @code{GLX_WINDOW_BIT}, @code{GLX_PIXMAP_BIT},
and @code{GLX_PBUFFER_BIT}.
@item @code{GLX_X_RENDERABLE}
@item @code{GLX_X_VISUAL_TYPE}
-Visual type of associated visual. The returned value will be one of:
+Visual type of associated visual. The returned value will be one of:
@code{GLX_TRUE_COLOR}, @code{GLX_DIRECT_COLOR}, @code{GLX_PSEUDO_COLOR},
@code{GLX_STATIC_COLOR}, @code{GLX_GRAY_SCALE}, @code{GLX_STATIC_GRAY},
or @code{GLX_NONE}, if there is no associated visual (i.e., if
Integer value between 0 and the maximum frame buffer value for indices,
indicating the transparent index value for the frame buffer
-configuration. Undefined if @code{GLX_TRANSPARENT_TYPE} is not
+configuration. Undefined if @code{GLX_TRANSPARENT_TYPE} is not
@code{GLX_TRANSPARENT_INDEX}.
@item @code{GLX_TRANSPARENT_RED_VALUE}
Integer value between 0 and the maximum frame buffer value for green,
indicating the transparent green value for the frame buffer
-configuration. Undefined if @code{GLX_TRANSPARENT_TYPE} is not
+configuration. Undefined if @code{GLX_TRANSPARENT_TYPE} is not
@code{GLX_TRANSPARENT_RGB}.
@item @code{GLX_TRANSPARENT_BLUE_VALUE}
Integer value between 0 and the maximum frame buffer value for blue,
indicating the transparent blue value for the frame buffer
-configuration. Undefined if @code{GLX_TRANSPARENT_TYPE} is not
+configuration. Undefined if @code{GLX_TRANSPARENT_TYPE} is not
@code{GLX_TRANSPARENT_RGB}.
@item @code{GLX_TRANSPARENT_ALPHA_VALUE}
Integer value between 0 and the maximum frame buffer value for alpha,
indicating the transparent blue value for the frame buffer
-configuration. Undefined if @code{GLX_TRANSPARENT_TYPE} is not
+configuration. Undefined if @code{GLX_TRANSPARENT_TYPE} is not
@code{GLX_TRANSPARENT_RGB}.
@item @code{GLX_MAX_PBUFFER_WIDTH}
The maximum number of pixels (width times height) for a pixel buffer.
Note that this value may be less than @code{GLX_MAX_PBUFFER_WIDTH} times
-@code{GLX_MAX_PBUFFER_HEIGHT}. Also, this value is static and assumes
+@code{GLX_MAX_PBUFFER_HEIGHT}. Also, this value is static and assumes
that no other pixel buffers or X resources are contending for the frame
-buffer memory. As a result, it may not be possible to allocate a pixel
+buffer memory. As a result, it may not be possible to allocate a pixel
buffer of the size given by @code{GLX_MAX_PBUFFER_PIXELS}.
@end table
Applications should choose the frame buffer configuration that most
-closely meets their requirements. Creating windows, GLX pixmaps, or GLX
+closely meets their requirements. Creating windows, GLX pixmaps, or GLX
pixel buffers with unnecessary buffers can result in reduced rendering
performance as well as poor resource allocation.
@code{GLX_NO_EXTENSION} is returned if @var{dpy} does not support the
-GLX extension. @code{GLX_BAD_ATTRIBUTE} is returned if @var{attribute}
+GLX extension. @code{GLX_BAD_ATTRIBUTE} is returned if @var{attribute}
is not a valid GLX attribute.
@end deftypefun
@end table
@code{glXGetFBConfigs} returns a list of all GLXFBConfigs available on
-the screen specified by @var{screen}. Use @code{glXGetFBConfigAttrib}
-to obtain attribute values from a specific GLXFBConfig.
+the screen specified by @var{screen}. Use @code{glXGetFBConfigAttrib} to
+obtain attribute values from a specific GLXFBConfig.
@end deftypefun
@end table
@code{glXGetProcAddress} returns the address of the function specified
-in @var{procName}. This is necessary in environments where the OpenGL
+in @var{procName}. This is necessary in environments where the OpenGL
link library exports a different set of functions than the runtime
library.
Specifies the connection to the X server.
@item @var{draw}
-Specifies a GLX drawable. Must be a GLX pixel buffer or a window.
+Specifies a GLX drawable. Must be a GLX pixel buffer or a window.
@item @var{event_mask}
Returns the events that are selected for @var{draw}.
If @var{config} is a valid GLX frame buffer configuration and it has an
associated X Visual, then information describing that visual is
-returned; otherwise @code{NULL} is returned. Use @code{XFree} to free
+returned; otherwise @code{NULL} is returned. Use @code{XFree} to free
the data returned.
Returns @code{NULL} if @var{config} is not a valid GLXFBConfig.
@end table
@code{glXImportContextEXT} creates a GLXContext given the XID of an
-existing GLXContext. It may be used in place of
-@code{glXCreateContext}, to share another process's indirect rendering
-context.
+existing GLXContext. It may be used in place of @code{glXCreateContext},
+to share another process's indirect rendering context.
Only the server-side context information can be shared between X
clients; client-side state, such as pixel storage modes, cannot be
-shared. Thus, @code{glXImportContextEXT} must allocate memory to store
-client-side information. This memory is freed by calling
+shared. Thus, @code{glXImportContextEXT} must allocate memory to store
+client-side information. This memory is freed by calling
@code{glXFreeContextEXT}.
-This call does not create a new XID. It merely makes an existing object
-available to the importing client (Display *). Like any XID, it goes
+This call does not create a new XID. It merely makes an existing object
+available to the importing client (Display *). Like any XID, it goes
away when the creating client drops its connection or the ID is
-explicitly deleted. Note that this is when the XID goes away. The
-object goes away when the XID goes away AND the context is not current
-to any thread.
+explicitly deleted. Note that this is when the XID goes away. The object
+goes away when the XID goes away AND the context is not current to any
+thread.
If @var{contextID} refers to a direct rendering context then no error is
generated but @code{glXImportContextEXT} returns NULL.
@code{glXImportContextEXT} is part of the @code{EXT_import_context}
-extension, not part of the core GLX command set. If
+extension, not part of the core GLX command set. If
_glxextstring(EXT_import_context) is included in the string returned by
@code{glXQueryExtensionsString}, when called with argument
@code{GLX_EXTENSIONS}, extension @code{EXT_import_context} is supported.
@end table
@code{glXIsDirect} returns @code{True} if @var{ctx} is a direct
-rendering context, @code{False} otherwise. Direct rendering contexts
+rendering context, @code{False} otherwise. Direct rendering contexts
pass rendering commands directly from the calling process's address
-space to the rendering system, bypassing the X server. Nondirect
+space to the rendering system, bypassing the X server. Nondirect
rendering contexts pass all rendering commands to the X server.
@code{GLXBadContext} is generated if @var{ctx} is not a valid GLX
Specifies the connection to the X server.
@item @var{draw}
-Specifies a GLX drawable to render into. Must be an XID representing a
+Specifies a GLX drawable to render into. Must be an XID representing a
GLXWindow, GLXPixmap, or GLXPbuffer.
@item @var{read}
-Specifies a GLX drawable to read from. Must be an XID representing a
+Specifies a GLX drawable to read from. Must be an XID representing a
GLXWindow, GLXPixmap, or GLXPbuffer.
@item @var{ctx}
@end table
@code{glXMakeContextCurrent} binds @var{ctx} to the current rendering
-thread and to the @var{draw} and @var{read} GLX drawables. @var{draw}
+thread and to the @var{draw} and @var{read} GLX drawables. @var{draw}
and @var{read} may be the same.
@var{draw} is used for all OpenGL operations except:
Any pixel data that are read based on the value of
-@code{GLX_READ_BUFFER}. Note that accumulation operations use the value
+@code{GLX_READ_BUFFER}. Note that accumulation operations use the value
of @code{GLX_READ_BUFFER}, but are not allowed unless @var{draw} is
identical to @var{read}.
context is flushed and replaced by @var{ctx}.
The first time that @var{ctx} is made current, the viewport and scissor
-dimensions are set to the size of the @var{draw} drawable. The viewport
+dimensions are set to the size of the @var{draw} drawable. The viewport
and scissor are not modified when @var{ctx} is subsequently made
current.
@code{None} and @var{ctx} set to @code{NULL}.
@code{glXMakeContextCurrent} returns @code{True} if it is successful,
-@code{False} otherwise. If @code{False} is returned, the previously
+@code{False} otherwise. If @code{False} is returned, the previously
current rendering context and drawable (if any) remain unchanged.
@code{BadMatch} is generated if @var{draw} and @var{read} are not
Specifies the connection to the X server.
@item @var{drawable}
-Specifies a GLX drawable. Must be either an X window ID or a GLX pixmap
+Specifies a GLX drawable. Must be either an X window ID or a GLX pixmap
ID.
@item @var{ctx}
@code{glXMakeCurrent} does two things: It makes @var{ctx} the current
GLX rendering context of the calling thread, replacing the previously
current context if there was one, and it attaches @var{ctx} to a GLX
-drawable, either a window or a GLX pixmap. As a result of these two
+drawable, either a window or a GLX pixmap. As a result of these two
actions, subsequent GL rendering calls use rendering context @var{ctx}
-to modify GLX drawable @var{drawable} (for reading and writing). Because
+to modify GLX drawable @var{drawable} (for reading and writing). Because
@code{glXMakeCurrent} always replaces the current rendering context with
@var{ctx}, there can be only one current context per thread.
is released.
The first time @var{ctx} is made current to any thread, its viewport is
-set to the full size of @var{drawable}. Subsequent calls by any thread
+set to the full size of @var{drawable}. Subsequent calls by any thread
to @code{glXMakeCurrent} with @var{ctx} have no effect on its viewport.
To release the current context without assigning a new one, call
@var{ctx} set to @code{NULL}.
@code{glXMakeCurrent} returns @code{True} if it is successful,
-@code{False} otherwise. If @code{False} is returned, the previously
+@code{False} otherwise. If @code{False} is returned, the previously
current rendering context and drawable (if any) remain unchanged.
@code{BadMatch} is generated if @var{drawable} was not created with the
-same X screen and visual as @var{ctx}. It is also generated if
+same X screen and visual as @var{ctx}. It is also generated if
@var{drawable} is @code{None} and @var{ctx} is not @code{NULL}.
@code{BadAccess} is generated if @var{ctx} was current to another thread
Specifies a GLX rendering context.
@item @var{attribute}
-Specifies that a context parameter should be retrieved. Must be one of
+Specifies that a context parameter should be retrieved. Must be one of
@code{GLX_SHARED_CONTEXT_EXT}, @code{GLX_VISUAL_ID_EXT}, or
@code{GLX_SCREEN_EXT}.
@end table
@code{glXQueryContextInfoEXT} sets @var{value} to the value of
-@var{attribute} with respect to @var{ctx}. @code{glXQueryContextInfoEXT}
-returns an error code if it fails for any reason. Otherwise,
+@var{attribute} with respect to @var{ctx}. @code{glXQueryContextInfoEXT}
+returns an error code if it fails for any reason. Otherwise,
@code{Success} is returned.
@var{attribute} may be one of the following:
This call may cause a round-trip to the server.
@code{glXQueryContextInfoEXT} is part of the @code{EXT_import_context}
-extension, not part of the core GLX command set. If
+extension, not part of the core GLX command set. If
_glxextstring(EXT_import_context) is included in the string returned by
@code{glXQueryExtensionsString}, when called with argument
@code{GLX_EXTENSIONS}, extension @code{EXT_import_context} is supported.
Specifies a GLX rendering context.
@item @var{attribute}
-Specifies that a context parameter should be retrieved. Must be one of
+Specifies that a context parameter should be retrieved. Must be one of
@code{GLX_FBCONFIG_ID}, @code{GLX_RENDER_TYPE}, or @code{GLX_SCREEN}.
@item @var{value}
@end table
@code{glXQueryContext} sets @var{value} to the value of @var{attribute}
-with respect to @var{ctx}. @var{attribute} may be one of the following:
+with respect to @var{ctx}. @var{attribute} may be one of the following:
@table @asis
@item @code{GLX_FBCONFIG_ID}
Specifies the GLX drawable to be queried.
@item @var{attribute}
-Specifies the attribute to be returned. Must be one of
-@code{GLX_WIDTH}, @code{GLX_HEIGHT}, @code{GLX_PRESERVED_CONTENTS},
+Specifies the attribute to be returned. Must be one of @code{GLX_WIDTH},
+@code{GLX_HEIGHT}, @code{GLX_PRESERVED_CONTENTS},
@code{GLX_LARGEST_PBUFFER}, or @code{GLX_FBCONFIG_ID}.
@item @var{value}
@item @code{GLX_LARGEST_PBUFFER}
Returns the value set when @code{glXCreatePbuffer} was called to create
-the GLXPbuffer. If @code{False} is returned, then the call to
+the GLXPbuffer. If @code{False} is returned, then the call to
@code{glXCreatePbuffer} will fail to create a GLXPbuffer if the
requested size is larger than the implementation maximum or available
-resources. If @code{True} is returned, a GLXPbuffer of the maximum
+resources. If @code{True} is returned, a GLXPbuffer of the maximum
availble size (if less than the requested width and height) is created.
@item @code{GLX_FBCONFIG_ID}
If @var{draw} is a GLXWindow or GLXPixmap and @var{attribute} is set to
@code{GLX_PRESERVED_CONTENTS} or @code{GLX_LARGETST_PBUFFER}, the
-contents of @var{value} are undefined. If @var{attribute} is not one of
+contents of @var{value} are undefined. If @var{attribute} is not one of
the attributes listed above, the contents of @var{value} are unedfined.
A @code{GLXBadDrawable} is generated if @var{draw} is not a valid
@end table
@code{glXQueryExtensionsString} returns a pointer to a string describing
-which GLX extensions are supported on the connection. The string is
+which GLX extensions are supported on the connection. The string is
null-terminated and contains a space-separated list of extension names.
(The extension names themselves never contain spaces.) If there are no
extensions to GLX, then the empty string is returned.
@code{glXQueryExtension} returns @code{True} if the X server of
connection @var{dpy} supports the GLX extension, @code{False} otherwise.
If @code{True} is returned, then @var{errorBase} and @var{eventBase}
-return the error base and event base of the GLX extension. These values
+return the error base and event base of the GLX extension. These values
should be added to the constant error and event values to determine the
-actual event or error values. Otherwise, @var{errorBase} and
+actual event or error values. Otherwise, @var{errorBase} and
@var{eventBase} are unchanged.
@var{errorBase} and @var{eventBase} do not return values if they are
@code{glXQueryServerString} returns a pointer to a static,
null-terminated string describing some aspect of the server's GLX
-extension. The possible values for @var{name} and the format of the
-strings is the same as for @code{glXGetClientString}. If @var{name} is
+extension. The possible values for @var{name} and the format of the
+strings is the same as for @code{glXGetClientString}. If @var{name} is
not set to a recognized value, @code{NULL} is returned.
@end deftypefun
@code{glXQueryVersion} returns the major and minor version numbers of
the GLX extension implemented by the server associated with connection
-@var{dpy}. Implementations with the same major version number are
-upward compatible, meaning that the implementation with the higher minor
-number is a superset of the version with the lower minor number.
+@var{dpy}. Implementations with the same major version number are upward
+compatible, meaning that the implementation with the higher minor number
+is a superset of the version with the lower minor number.
@var{major} and @var{minor} do not return values if they are specified
as @code{NULL}.
Specifies the connection to the X server.
@item @var{draw}
-Specifies a GLX drawable. Must be a GLX pixel buffer or a window.
+Specifies a GLX drawable. Must be a GLX pixel buffer or a window.
@item @var{event_mask}
Specifies the events to be returned for @var{draw}.
@end table
@code{glXSelectEvent} sets the GLX event mask for a GLX pixel buffer or
-a window. Calling @code{glXSelectEvent} overrides any previous event
-mask that was set by the client for @var{draw}. Note that it does not
+a window. Calling @code{glXSelectEvent} overrides any previous event
+mask that was set by the client for @var{draw}. Note that it does not
affect the event masks that other clients may have specified for
@var{draw} since each client rendering to @var{draw} has a separate
event mask for it.
Currently, only one GLX event, @code{GLX_PBUFFER_CLOBBER_MASK}, can be
-selected. The following data is returned to the client when a
+selected. The following data is returned to the client when a
@code{GLX_PBUFFER_CLOBBER_MASK} event occurs:
typedef struct @{
@item
GLXDrawable @var{drawable};
-/* i.d. of Drawable */
+/* i.d. of Drawable */
@item
unsigned int @var{buffer_mask};
@end table
A single X server operation can cause several buffer clobber events to
-be sent. (e.g., a single GLX pixel buffer may be damaged and cause
-multiple buffer clobber events to be generated). Each event specifies
+be sent. (e.g., a single GLX pixel buffer may be damaged and cause
+multiple buffer clobber events to be generated). Each event specifies
one region of the GLX drawable that was affected by the X Server
-operation. The @var{buffer_mask} field indicates which color buffers
-and ancillary buffers were affected. All the buffer clobber events
-generated by a single X server action are guaranteed to be contiguous in
-the event queue. The conditions under which this event is generated and
-the @var{event_type} varies, depending on the type of the GLX drawable.
+operation. The @var{buffer_mask} field indicates which color buffers and
+ancillary buffers were affected. All the buffer clobber events generated
+by a single X server action are guaranteed to be contiguous in the event
+queue. The conditions under which this event is generated and the
+@var{event_type} varies, depending on the type of the GLX drawable.
When the @code{GLX_AUX_BUFFERS_BIT} is set in @var{buffer_mask}, then
-@var{aux_buffer} is set to indicate which buffer was affected. If more
+@var{aux_buffer} is set to indicate which buffer was affected. If more
than one aux buffer was affected, then additional events are generated
-as part of the same contiguous event group. Each additional event will
+as part of the same contiguous event group. Each additional event will
have only the @code{GLX_AUX_BUFFERS_BIT} set in @var{buffer_mask}, and
-the @var{aux_buffer} field will be set appropriately. For nonstereo
+the @var{aux_buffer} field will be set appropriately. For nonstereo
drawables, @code{GLX_FRONT_LEFT_BUFFER_BIT} and
@code{GLX_BACK_LEFT_BUFFER_BIT} are used to specify the front and back
color buffers.
For preserved GLX pixel buffers, a buffer clobber event with type
@code{GLX_SAVED} is generated whenever the contents of the GLX pixel
-buffer is moved out of offscreen memory. The event(s) describes which
-portions of the GLX pixel buffer were affected. Clients who receive
-many buffer clobber events, referring to different save actions, should
+buffer is moved out of offscreen memory. The event(s) describes which
+portions of the GLX pixel buffer were affected. Clients who receive many
+buffer clobber events, referring to different save actions, should
consider freeing the GLX pixel buffer resource in order to prevent the
system from thrashing due to insufficient resources.
For an unpreserved GLXPbuffer, a buffer clobber event, with type
@code{GLX_DAMAGED}, is generated whenever a portion of the GLX pixel
-buffer becomes invalid. The client may wish to regenerate the invalid
+buffer becomes invalid. The client may wish to regenerate the invalid
portions of the GLX pixel buffer.
For Windows, buffer clobber events, with type @code{GLX_SAVED}, occur
whenever an ancillary buffer, associated with the window, gets clobbered
-or moved out of off-screen memory. The event contains information
+or moved out of off-screen memory. The event contains information
indicating which color buffers and ancillary buffers\(emand which
portions of those buffers\(emwere affected.
@code{glXSwapBuffers} promotes the contents of the back buffer of
@var{drawable} to become the contents of the front buffer of
-@var{drawable}. The contents of the back buffer then become undefined.
+@var{drawable}. The contents of the back buffer then become undefined.
The update typically takes place during the vertical retrace of the
monitor, rather than immediately after @code{glXSwapBuffers} is called.
@code{glXSwapBuffers} performs an implicit @code{glFlush} before it
-returns. Subsequent OpenGL commands may be issued immediately after
+returns. Subsequent OpenGL commands may be issued immediately after
calling @code{glXSwapBuffers}, but are not executed until the buffer
exchange is completed.
@code{glXUseXFont} generates @var{count} display lists, named
@var{listBase} through @r{@var{listBase}+@var{count}-1}, each containing
-a single @code{glBitmap} command. The parameters of the @code{glBitmap}
+a single @code{glBitmap} command. The parameters of the @code{glBitmap}
command of display list @r{@var{listBase}+@var{i}} are derived from
-glyph @r{@var{first}+@var{i}}. Bitmap parameters @r{@var{xorig}},
+glyph @r{@var{first}+@var{i}}. Bitmap parameters @r{@var{xorig}},
@r{@var{yorig}}, @r{@var{width}}, and @r{@var{height}} are computed from
font metrics as @r{@var{descent}-1}, @r{-@var{lbearing}},
@r{@var{rbearing}-@var{lbearing}}, and @r{@var{ascent}+@var{descent}},
-respectively. @r{@var{xmove}} is taken from the glyph's @r{@var{width}}
-metric, and @r{@var{ymove}} is set to zero. Finally, the glyph's image
+respectively. @r{@var{xmove}} is taken from the glyph's @r{@var{width}}
+metric, and @r{@var{ymove}} is set to zero. Finally, the glyph's image
is converted to the appropriate format for @code{glBitmap}.
Using @code{glXUseXFont} may be more efficient than accessing the X font
each bitmap until it is accessed.
Empty display lists are created for all glyphs that are requested and
-are not defined in @var{font}. @code{glXUseXFont} is ignored if there
-is no current GLX context.
+are not defined in @var{font}. @code{glXUseXFont} is ignored if there is
+no current GLX context.
@code{BadFont} is generated if @var{font} is not a valid font.
Complete GL execution prior to subsequent X calls.
GL rendering calls made prior to @code{glXWaitGL} are guaranteed to be
-executed before X rendering calls made after @code{glXWaitGL}. Although
+executed before X rendering calls made after @code{glXWaitGL}. Although
this same result can be achieved using @code{glFinish}, @code{glXWaitGL}
does not require a round trip to the server, and it is therefore more
efficient in cases where client and server are on separate machines.
Complete X execution prior to subsequent GL calls.
X rendering calls made prior to @code{glXWaitX} are guaranteed to be
-executed before GL rendering calls made after @code{glXWaitX}. Although
+executed before GL rendering calls made after @code{glXWaitX}. Although
the same result can be achieved using @code{XSync}, @code{glXWaitX} does
not require a round trip to the server, and it is therefore more
efficient in cases where client and server are on separate machines.
arb-shader-storage-buffer-object
intel-map-texture
boolean
- primitive-type
+ begin-mode
version-3-2
arb-geometry-shader-4
nv-geometry-program-4
get-pixel-map
get-pointerv-p-name
get-p-name
- ext-vertex-weighting
qcom-alpha-test
ext-unpack-subimage
ext-multiview-draw-buffers
ext-polygon-offset
ext-rescale-normal
ext-texture
- arm-rgba-8
ext-texture-object
ext-texture-3d
oes-texture-3d
sgix-interlace
sgis-detail-texture
sgis-multisample
+ nv-multisample-coverage
sgis-sharpen-texture
sgi-color-matrix
sgi-texture-color-table
sgix-texture-add-env
- arb-shadow-ambient
sgix-shadow-ambient
version-1-4
ext-blend-func-separate
sgi-color-table
arb-vertex-array-bgra
ext-bgra
- ext-paletted-texture
- ext-draw-range-elements
- win-phong-shading
- win-specular-fog
- ext-clip-volume-hint
sgis-texture-select
arb-point-parameters
ext-point-parameters
sgis-texture-filter-4
sgix-sprite
hp-convolution-border-modes
- hp-image-transform
- hp-occlusion-test
- hp-texture-lighting
sgix-clipmap
sgix-texture-scale-bias
sgix-reference-plane
intel-parallel-arrays
sgix-fragment-lighting
sgix-resample
- ext-coordinate-frame
version-1-5
ext-fog-coord
ext-secondary-color
arb-vertex-program
version-2-1
+ sgix-icc-texture
rend-screen-coordinates
arb-multitexture
oes-texture-env-crossbar
oes-packed-depth-stencil
ext-texture-lod-bias
ext-texture-filter-anisotropic
- nv-texture-env-combine-4
+ ext-vertex-weighting
nv-light-max-exponent
ext-stencil-wrap
oes-stencil-wrap
ingr-color-clamp
ingr-interlace-read
ext-texture-env-combine
+ nv-texture-env-combine-4
sgix-subsample
ext-texture-perturb-normal
apple-specular-vector
arb-shader-subroutine
oes-vertex-type-10-10-10-2
nv-conditional-render
- nv-multisample-coverage
arb-transform-feedback-2
nv-transform-feedback-2
nv-present-video
arb-texture-multisample
nv-explicit-multisample
nv-gpu-program-5
- version-4-0
arb-texture-gather
arb-transform-feedback-3
arb-texture-compression-bptc
arb-draw-indirect
arb-gpu-shader-fp-64
arm-mali-shader-binary
- arm-mali-program-binary
qcom-driver-control
qcom-binning-control
viv-shader-binary
- amd-vertex-shader-tessellator
+ amd-vertex-shader-tesselator
arb-texture-cube-map-array
ext-texture-snorm
amd-blend-minmax-factor
angle-texture-usage
angle-pack-reverse-row-order
angle-depth-texture
- gl-khr-texture-compression-astc-ldr
- ibm-rasterpos-clip
- ibm-cull-vertex
- ibm-static-data
- pgi-misc-hints
- pgi-vertex-hints))
+ gl-khr-texture-compression-astc-ldr))
(define-bitfield
attrib-mask
(fragment-shader-bit-ext 2)
(all-shader-bits-ext 4294967295)
(program-separable-ext 33368)
+ (active-program-ext 33369)
(program-pipeline-binding-ext 33370)
(active-program-ext 35725))
(define-enumeration boolean (false 0) (true 1))
(define-enumeration
- primitive-type
+ begin-mode
(points 0)
(lines 1)
(line-loop 2)
(post-color-matrix-color-table-sgi 32978)
(texture-color-table-sgi 32956))
-(define-enumeration
- ext-vertex-weighting
- (modelview0-stack-depth-ext 2979)
- (modelview0-matrix-ext 2982)
- (modelview0-ext 5888)
- (modelview1-stack-depth-ext 34050)
- (modelview1-matrix-ext 34054)
- (vertex-weighting-ext 34057)
- (modelview1-ext 34058)
- (current-vertex-weight-ext 34059)
- (vertex-weight-array-ext 34060)
- (vertex-weight-array-size-ext 34061)
- (vertex-weight-array-type-ext 34062)
- (vertex-weight-array-stride-ext 34063)
- (vertex-weight-array-pointer-ext 34064))
-
(define-enumeration
qcom-alpha-test
(alpha-test-qcom 3008)
(depth-ext 6145)
(stencil-ext 6146))
-(define-enumeration pixel-format (red-ext 6403))
+(define-enumeration
+ pixel-format
+ (color-index 6400)
+ (stencil-index 6401)
+ (depth-component 6402)
+ (red 6403)
+ (green 6404)
+ (blue 6405)
+ (alpha 6406)
+ (rgb 6407)
+ (rgba 6408)
+ (luminance 6409)
+ (luminance-alpha 6410)
+ (abgr-ext 32768)
+ (cmyk-ext 32780)
+ (cmyka-ext 32781)
+ (ycrcb-422-sgix 33211)
+ (ycrcb-444-sgix 33212))
(define-enumeration
oes-depth-texture
(define-enumeration
pixel-tex-gen-mode
(none 0)
+ (rgb 6407)
+ (rgba 6408)
+ (luminance 6409)
+ (luminance-alpha 6410)
(pixel-tex-gen-alpha-replace-sgix 33159)
(pixel-tex-gen-alpha-no-replace-sgix 33160)
(pixel-tex-gen-alpha-ms-sgix 33162)
(proxy-texture-2d-ext 32868)
(texture-too-large-ext 32869))
-(define-enumeration arm-rgba-8 (rgba8-oes 32856))
-
(define-enumeration
ext-texture-object
(texture-priority-ext 32870)
(sample-mask-invert-sgis 32939)
(sample-pattern-sgis 32940))
+(define-enumeration
+ nv-multisample-coverage
+ (coverage-samples-nv 32937)
+ (color-samples-nv 36384))
+
(define-enumeration
sgis-sharpen-texture
(linear-sharpen-sgis 32941)
sgix-texture-add-env
(texture-env-bias-sgix 32958))
-(define-enumeration
- arb-shadow-ambient
- (texture-compare-fail-value-arb 32959))
-
(define-enumeration
sgix-shadow-ambient
(shadow-ambient-sgix 32959))
(bgr-ext 32992)
(bgra-ext 32993))
-(define-enumeration
- ext-paletted-texture
- (color-index1-ext 32994)
- (color-index2-ext 32995)
- (color-index4-ext 32996)
- (color-index8-ext 32997)
- (color-index12-ext 32998)
- (color-index16-ext 32999)
- (texture-index-size-ext 33005))
-
-(define-enumeration
- ext-draw-range-elements
- (max-elements-vertices-ext 33000)
- (max-elements-indices-ext 33001))
-
-(define-enumeration
- win-phong-shading
- (phong-win 33002)
- (phong-hint-win 33003))
-
-(define-enumeration
- win-specular-fog
- (fog-specular-texture-win 33004))
-
-(define-enumeration
- ext-clip-volume-hint
- (clip-volume-clipping-hint-ext 33008))
-
(define-enumeration
sgis-texture-select
(dual-alpha4-sgis 33040)
(replicate-border-hp 33107)
(convolution-border-color-hp 33108))
-(define-enumeration
- hp-image-transform
- (image-scale-x-hp 33109)
- (image-scale-y-hp 33110)
- (image-translate-x-hp 33111)
- (image-translate-y-hp 33112)
- (image-rotate-angle-hp 33113)
- (image-rotate-origin-x-hp 33114)
- (image-rotate-origin-y-hp 33115)
- (image-mag-filter-hp 33116)
- (image-min-filter-hp 33117)
- (image-cubic-weight-hp 33118)
- (cubic-hp 33119)
- (average-hp 33120)
- (image-transform-2d-hp 33121)
- (post-image-transform-color-table-hp 33122)
- (proxy-post-image-transform-color-table-hp 33123))
-
-(define-enumeration
- hp-occlusion-test
- (occlusion-test-hp 33125)
- (occlusion-test-result-hp 33126))
-
-(define-enumeration
- hp-texture-lighting
- (texture-lighting-mode-hp 33127)
- (texture-post-specular-hp 33128)
- (texture-pre-specular-hp 33129))
-
(define-enumeration
sgix-clipmap
(linear-clipmap-linear-sgix 33136)
sgix-texture-coordinate-clamp
(texture-max-clamp-s-sgix 33641)
(texture-max-clamp-t-sgix 33642)
- (texture-max-clamp-r-sgix 33643))
+ (texture-max-clamp-r-sgix 33643)
+ (fog-factor-to-alpha-sgix 33647))
(define-enumeration
arb-texture-mirrored-repeat
(resample-zero-fill-sgix 33839)
(resample-decimate-sgix 33840))
-(define-enumeration
- ext-coordinate-frame
- (tangent-array-ext 33849)
- (binormal-array-ext 33850)
- (current-tangent-ext 33851)
- (current-binormal-ext 33852)
- (tangent-array-type-ext 33854)
- (tangent-array-stride-ext 33855)
- (binormal-array-type-ext 33856)
- (binormal-array-stride-ext 33857)
- (tangent-array-pointer-ext 33858)
- (binormal-array-pointer-ext 33859)
- (map1-tangent-ext 33860)
- (map2-tangent-ext 33861)
- (map1-binormal-ext 33862)
- (map2-binormal-ext 33863))
-
(define-enumeration
version-1-5
(fog-coord-src 33872)
(compressed-sluminance 35914)
(compressed-sluminance-alpha 35915))
+(define-enumeration
+ sgix-icc-texture
+ (smooth-point-size-range 2834)
+ (smooth-point-size-granularity 2835)
+ (smooth-line-width-range 2850)
+ (smooth-line-width-granularity 2851)
+ (aliased-point-size-range 33901)
+ (aliased-line-width-range 33902))
+
(define-enumeration
rend-screen-coordinates
(screen-coordinates-rend 33936)
(define-enumeration
arb-texture-env-combine
- (subtract-arb 34023)
- (combine-arb 34160)
- (combine-rgb-arb 34161)
- (combine-alpha-arb 34162)
- (rgb-scale-arb 34163)
- (add-signed-arb 34164)
- (interpolate-arb 34165)
- (constant-arb 34166)
- (primary-color-arb 34167)
- (previous-arb 34168)
- (source0-rgb-arb 34176)
- (source1-rgb-arb 34177)
- (source2-rgb-arb 34178)
- (source0-alpha-arb 34184)
- (source1-alpha-arb 34185)
- (source2-alpha-arb 34186)
- (operand0-rgb-arb 34192)
- (operand1-rgb-arb 34193)
- (operand2-rgb-arb 34194)
- (operand0-alpha-arb 34200)
- (operand1-alpha-arb 34201)
- (operand2-alpha-arb 34202)
(subtract-arb 34023))
(define-enumeration
(max-texture-max-anisotropy-ext 34047))
(define-enumeration
- nv-texture-env-combine-4
- (combine4-nv 34051)
- (source3-rgb-nv 34179)
- (source3-alpha-nv 34187)
- (operand3-rgb-nv 34195)
- (operand3-alpha-nv 34203))
+ ext-vertex-weighting
+ (modelview1-stack-depth-ext 34050)
+ (modelview-matrix1-ext 34054)
+ (vertex-weighting-ext 34057)
+ (modelview1-ext 34058)
+ (current-vertex-weight-ext 34059)
+ (vertex-weight-array-ext 34060)
+ (vertex-weight-array-size-ext 34061)
+ (vertex-weight-array-type-ext 34062)
+ (vertex-weight-array-stride-ext 34063)
+ (vertex-weight-array-pointer-ext 34064))
(define-enumeration
nv-light-max-exponent
(define-enumeration
nv-texgen-reflection
- (normal-map-nv 34065)
- (reflection-map-nv 34066))
+ (normal-map 34065)
+ (reflection-map 34066))
(define-enumeration
arb-texture-cube-map
(half-bias-normal-nv 34106)
(half-bias-negate-nv 34107)
(signed-identity-nv 34108)
- (signed-negate-nv 34109)
+ (unsigned-negate-nv 34109)
(scale-by-two-nv 34110)
(scale-by-four-nv 34111)
(scale-by-one-half-nv 34112)
(define-enumeration
nv-fog-distance
- (fog-distance-mode-nv 34138)
+ (fog-gen-mode-nv 34138)
(eye-radial-nv 34139)
(eye-plane-absolute-nv 34140))
(operand1-alpha-ext 34201)
(operand2-alpha-ext 34202))
+(define-enumeration
+ nv-texture-env-combine-4
+ (combine4-nv 34051)
+ (source3-rgb-nv 34179)
+ (source3-alpha-nv 34187)
+ (operand3-rgb-nv 34195)
+ (operand3-alpha-nv 34203))
+
(define-enumeration
sgix-subsample
(pack-subsample-rate-sgix 34208)
(map-attrib-u-order-nv 34499)
(map-attrib-v-order-nv 34500)
(eval-fractional-tessellation-nv 34501)
- (eval-vertex-attrib0-nv 34502)
- (eval-vertex-attrib1-nv 34503)
- (eval-vertex-attrib2-nv 34504)
- (eval-vertex-attrib3-nv 34505)
- (eval-vertex-attrib4-nv 34506)
- (eval-vertex-attrib5-nv 34507)
- (eval-vertex-attrib6-nv 34508)
- (eval-vertex-attrib7-nv 34509)
- (eval-vertex-attrib8-nv 34510)
- (eval-vertex-attrib9-nv 34511)
- (eval-vertex-attrib10-nv 34512)
- (eval-vertex-attrib11-nv 34513)
- (eval-vertex-attrib12-nv 34514)
- (eval-vertex-attrib13-nv 34515)
- (eval-vertex-attrib14-nv 34516)
- (eval-vertex-attrib15-nv 34517)
+ (eval-vertex-atrrib0-nv 34502)
+ (eval-vertex-atrrib1-nv 34503)
+ (eval-vertex-atrrib2-nv 34504)
+ (eval-vertex-atrrib3-nv 34505)
+ (eval-vertex-atrrib4-nv 34506)
+ (eval-vertex-atrrib5-nv 34507)
+ (eval-vertex-atrrib6-nv 34508)
+ (eval-vertex-atrrib7-nv 34509)
+ (eval-vertex-atrrib8-nv 34510)
+ (eval-vertex-atrrib9-nv 34511)
+ (eval-vertex-atrrib10-nv 34512)
+ (eval-vertex-atrrib11-nv 34513)
+ (eval-vertex-atrrib12-nv 34514)
+ (eval-vertex-atrrib13-nv 34515)
+ (eval-vertex-atrrib14-nv 34516)
+ (eval-vertex-atrrib15-nv 34517)
(max-map-tessellation-nv 34518)
(max-rational-eval-order-nv 34519))
(shader-operation-nv 34527)
(cull-modes-nv 34528)
(offset-texture-matrix-nv 34529)
- (offset-texture-2d-matrix-nv 34529)
(offset-texture-scale-nv 34530)
- (offset-texture-2d-scale-nv 34530)
(offset-texture-bias-nv 34531)
+ (offset-texture-2d-matrix-nv 34529)
+ (offset-texture-2d-scale-nv 34530)
(offset-texture-2d-bias-nv 34531)
(previous-texture-input-nv 34532)
(const-eye-nv 34533)
(define-enumeration
ati-pixel-format-float
- (rgba-float-mode-ati 34848)
+ (type-rgba-float-ati 34848)
(color-clear-unclamped-value-ati 34869))
(define-enumeration
(query-by-region-wait-nv 36373)
(query-by-region-no-wait-nv 36374))
-(define-enumeration
- nv-multisample-coverage
- (color-samples-nv 36384))
-
(define-enumeration
arb-transform-feedback-2
(transform-feedback 36386)
(max-program-subroutine-num-nv 36677))
(define-enumeration
- version-4-0
+ arb-texture-gather
(min-program-texture-gather-offset 36446)
(max-program-texture-gather-offset 36447)
- (texture-cube-map-array 36873)
- (texture-binding-cube-map-array 36874)
- (proxy-texture-cube-map-array 36875)
- (sampler-cube-map-array 36876)
- (sampler-cube-map-array-shadow 36877)
- (int-sampler-cube-map-array 36878)
- (unsigned-int-sampler-cube-map-array 36879))
-
-(define-enumeration
- arb-texture-gather
- (min-program-texture-gather-offset-arb 36446)
- (max-program-texture-gather-offset-arb 36447)
- (max-program-texture-gather-components-arb 36767))
+ (max-program-texture-gather-components-arb 36767)
+ (max-program-texture-gather-components 36767))
(define-enumeration
arb-transform-feedback-3
arm-mali-shader-binary
(mali-shader-binary-arm 36704))
-(define-enumeration
- arm-mali-program-binary
- (mali-program-binary-arm 36705))
-
(define-enumeration
qcom-driver-control
(perfmon-global-mode-qcom 36768))
(shader-binary-viv 36804))
(define-enumeration
- amd-vertex-shader-tessellator
+ amd-vertex-shader-tesselator
(sampler-buffer-amd 36865)
(int-sampler-buffer-amd 36866)
(unsigned-int-sampler-buffer-amd 36867)
(max-fragment-atomic-counters 37590)
(max-combined-atomic-counters 37591)
(max-atomic-counter-buffer-size 37592)
+ (max-atomic-counter-buffer-bindings 37596)
(active-atomic-counter-buffers 37593)
(uniform-atomic-counter-buffer-index 37594)
- (unsigned-int-atomic-counter 37595)
- (max-atomic-counter-buffer-bindings 37596))
+ (unsigned-int-atomic-counter 37595))
(define-enumeration
arb-program-interface-query
(compressed-srgb8-alpha8-astc-12x10-khr 37852)
(compressed-srgb8-alpha8-astc-12x12-khr 37853))
-(define-enumeration
- ibm-rasterpos-clip
- (raster-position-unclipped-ibm 103010))
-
-(define-enumeration
- ibm-cull-vertex
- (cull-vertex-ibm 103050))
-
-(define-enumeration
- ibm-static-data
- (all-static-data-ibm 103060)
- (static-vertex-array-ibm 103061)
- (vertex-array-list-ibm 103070)
- (normal-array-list-ibm 103071)
- (color-array-list-ibm 103072)
- (index-array-list-ibm 103073)
- (texture-coord-array-list-ibm 103074)
- (edge-flag-array-list-ibm 103075)
- (fog-coordinate-array-list-ibm 103076)
- (secondary-color-array-list-ibm 103077)
- (vertex-array-list-stride-ibm 103080)
- (normal-array-list-stride-ibm 103081)
- (color-array-list-stride-ibm 103082)
- (index-array-list-stride-ibm 103083)
- (texture-coord-array-list-stride-ibm 103084)
- (edge-flag-array-list-stride-ibm 103085)
- (fog-coordinate-array-list-stride-ibm 103086)
- (secondary-color-array-list-stride-ibm 103087))
-
-(define-enumeration
- pgi-misc-hints
- (prefer-doublebuffer-hint-pgi 107000)
- (conserve-memory-hint-pgi 107005)
- (reclaim-memory-hint-pgi 107006)
- (native-graphics-handle-pgi 107010)
- (native-graphics-begin-hint-pgi 107011)
- (native-graphics-end-hint-pgi 107012)
- (always-fast-hint-pgi 107020)
- (always-soft-hint-pgi 107021)
- (allow-draw-obj-hint-pgi 107022)
- (allow-draw-win-hint-pgi 107023)
- (allow-draw-frg-hint-pgi 107024)
- (allow-draw-mem-hint-pgi 107025)
- (strict-depthfunc-hint-pgi 107030)
- (strict-lighting-hint-pgi 107031)
- (strict-scissor-hint-pgi 107032)
- (full-stipple-hint-pgi 107033)
- (clip-near-hint-pgi 107040)
- (clip-far-hint-pgi 107041)
- (wide-line-hint-pgi 107042)
- (back-normals-hint-pgi 107043))
-
-(define-enumeration
- pgi-vertex-hints
- (vertex-data-hint-pgi 107050)
- (vertex-consistent-hint-pgi 107051)
- (material-side-hint-pgi 107052)
- (max-vertex-hint-pgi 107053)
- (vertex23-bit-pgi 4)
- (vertex4-bit-pgi 8)
- (color3-bit-pgi 65536)
- (color4-bit-pgi 131072)
- (edgeflag-bit-pgi 262144)
- (index-bit-pgi 524288)
- (mat-ambient-bit-pgi 1048576)
- (mat-ambient-and-diffuse-bit-pgi 2097152)
- (mat-diffuse-bit-pgi 4194304)
- (mat-emission-bit-pgi 8388608)
- (mat-color-indexes-bit-pgi 16777216)
- (mat-shininess-bit-pgi 33554432)
- (mat-specular-bit-pgi 67108864)
- (normal-bit-pgi 134217728)
- (texcoord1-bit-pgi 268435456)
- (texcoord2-bit-pgi 536870912)
- (texcoord3-bit-pgi 1073741824)
- (texcoord4-bit-pgi 2147483648))
-
;;;
;;; Derived from upstream OpenGL documentation.
;;;
-;;; Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is
-;;; licensed under the SGI Free Software B License. For details, see
+;;; Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is licensed
+;;; under the SGI Free Software B License. For details, see
;;; http://oss.sgi.com/projects/FreeB/ (http://oss.sgi.com/projects/FreeB/).
;;;
-;;; Copyright (C) 2003-2005 3Dlabs Inc. Ltd. This material may be
+;;; Copyright (C) 2003-2005 3Dlabs Inc. Ltd. This material may be
;;; distributed subject to the terms and conditions set forth in the Open
-;;; Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/
+;;; Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/
;;; (http://opencontent.org/openpub/).
;;;
-;;; Copyright (C) 2005 Addison-Wesley. This material may be distributed
+;;; Copyright (C) 2005 Addison-Wesley. This material may be distributed
;;; subject to the terms and conditions set forth in the Open Publication
-;;; License, v 1.0, 8 June 1999. http://opencontent.org/openpub/
+;;; License, v 1.0, 8 June 1999. http://opencontent.org/openpub/
;;; (http://opencontent.org/openpub/).
;;;
-;;; Copyright (C) 2006 Khronos Group. This material may be distributed
+;;; Copyright (C) 2006 Khronos Group. This material may be distributed
;;; subject to the terms and conditions set forth in the Open Publication
-;;; License, v 1.0, 8 June 1999. http://opencontent.org/openpub/
+;;; License, v 1.0, 8 June 1999. http://opencontent.org/openpub/
;;; (http://opencontent.org/openpub/).
;;;
;;; Automatically generated; you probably don't want to edit this. To
"Operate on the accumulation buffer.
OP
- Specifies the accumulation buffer operation. Symbolic constants
+ Specifies the accumulation buffer operation. Symbolic constants
`GL_ACCUM', `GL_LOAD', `GL_ADD', `GL_MULT', and `GL_RETURN' are
accepted.
VALUE
Specifies a floating-point value used in the accumulation buffer
- operation. OP determines how VALUE is used.
+ operation. OP determines how VALUE is used.
-The accumulation buffer is an extended-range color buffer. Images are
-not rendered into it. Rather, images rendered into one of the color
+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
+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.
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
+alpha values. The number of bits per component in the accumulation
+buffer depends on the implementation. You can examine this number by
calling `glGetIntegerv' four times, with arguments `GL_ACCUM_RED_BITS',
`GL_ACCUM_GREEN_BITS', `GL_ACCUM_BLUE_BITS', and `GL_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
+stored by each component is [-1,1] . The accumulation buffer pixels are
mapped one-to-one with frame buffer pixels.
-`glAccum' operates on the accumulation buffer. The first argument, OP,
+`glAccum' operates on the accumulation buffer. The first argument, OP,
is a symbolic constant that selects an accumulation buffer operation.
The second argument, VALUE, is a floating-point value to be used in that
-operation. Five operations are specified: `GL_ACCUM', `GL_LOAD',
+operation. Five operations are specified: `GL_ACCUM', `GL_LOAD',
`GL_ADD', `GL_MULT', and `GL_RETURN'.
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 `glAccum' operation results in a
+alpha components of each pixel. If a `glAccum' operation results in a
value outside the range [-1,1] , the contents of an accumulation buffer
pixel component are undefined.
`GL_ACCUM'
Obtains R, G, B, and A values from the buffer currently selected
- for reading (see `glReadBuffer'). Each component value is divided
+ for reading (see `glReadBuffer'). Each component value is divided
by 2^N-1 , where N is the number of bits allocated to each color
- component in the currently selected buffer. The result is a
+ component in the currently selected buffer. The result is a
floating-point value in the range [0,1] , which is multiplied by
VALUE and added to the corresponding pixel component in the
accumulation buffer, thereby updating the accumulation buffer.
`GL_LOAD'
Similar to `GL_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
+ value. That is, the R, G, B, and A values from the currently
selected buffer are divided by 2^N-1 , multiplied by VALUE, and
then stored in the corresponding accumulation buffer cell,
overwriting the current value.
`GL_RETURN'
Transfers accumulation buffer values to the color buffer or buffers
- currently selected for writing. Each R, G, B, and A component is
+ currently selected for writing. Each R, G, B, and A component is
multiplied by VALUE, then multiplied by 2^N-1 , clamped to the
range [0,2^N-1] , and stored in the corresponding display buffer
- cell. The only fragment operations that are applied to this
+ cell. The only fragment operations that are applied to this
transfer are pixel ownership, scissor, dithering, and color
writemasks.
"Select active texture unit.
TEXTURE
- Specifies which texture unit to make active. The number of texture
+ Specifies which texture unit to make active. The number of texture
units is implementation dependent, but must be at least two.
TEXTURE must be one of `GL_TEXTURE' I , where i ranges from 0 to
the larger of (`GL_MAX_TEXTURE_COORDS' - 1) and
- (`GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS' - 1). The initial value is
+ (`GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS' - 1). The initial value is
`GL_TEXTURE0'.
`glActiveTexture' selects which texture unit subsequent texture state
-calls will affect. The number of texture units an implementation
+calls will affect. The number of texture units an implementation
supports is implementation dependent, but must be at least 2.
Vertex arrays are client-side GL resources, which are selected by the
"Specify the alpha test function.
FUNC
- Specifies the alpha comparison function. Symbolic constants
+ Specifies the alpha comparison function. Symbolic constants
`GL_NEVER', `GL_LESS', `GL_EQUAL', `GL_LEQUAL', `GL_GREATER',
- `GL_NOTEQUAL', `GL_GEQUAL', and `GL_ALWAYS' are accepted. The
+ `GL_NOTEQUAL', `GL_GEQUAL', and `GL_ALWAYS' are accepted. The
initial value is `GL_ALWAYS'.
REF
Specifies the reference value that incoming alpha values are
- compared to. This value is clamped to the range [0,1] , where 0
+ 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.
+ possible value. The initial reference value is 0.
The alpha test discards fragments depending on the outcome of a
comparison between an incoming fragment's alpha value and a constant
-reference value. `glAlphaFunc' 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 `glEnable' and
+reference value. `glAlphaFunc' 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 `glEnable' and
`glDisable' of `GL_ALPHA_TEST'.)
-FUNC and REF specify the conditions under which the pixel is drawn. The
+FUNC and REF specify the conditions under which the pixel is drawn. The
incoming alpha value is compared to REF using the function specified by
-FUNC. 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:
+FUNC. 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:
`GL_NEVER'
Never passes.
`glAlphaFunc' 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. `glAlphaFunc' does
-not affect screen clear operations.
+bitmaps, and from pixel draw and copy operations. `glAlphaFunc' does not
+affect screen clear operations.
`GL_INVALID_ENUM' is generated if FUNC is not an accepted value.
RESIDENCES
Specifies an array in which the texture residence status is
- returned. The residence status of a texture named by an element of
+ returned. The residence status of a texture named by an element of
TEXTURES is returned in the corresponding element of RESIDENCES.
GL establishes a ``working set'' of textures that are resident in
-texture memory. These textures can be bound to a texture target much
+texture memory. These textures can be bound to a texture target much
more efficiently than textures that are not resident.
`glAreTexturesResident' queries the texture residence status of the N
-textures named by the elements of TEXTURES. If all the named textures
+textures named by the elements of TEXTURES. If all the named textures
are resident, `glAreTexturesResident' returns `GL_TRUE', and the
-contents of RESIDENCES are undisturbed. If not all the named textures
+contents of RESIDENCES are undisturbed. If not all the named textures
are resident, `glAreTexturesResident' returns `GL_FALSE', and detailed
-status is returned in the N elements of RESIDENCES. If an element of
+status is returned in the N elements of RESIDENCES. If an element of
RESIDENCES is `GL_TRUE', then the texture named by the corresponding
element of TEXTURES is resident.
The residence status of a single bound texture may also be queried by
calling `glGetTexParameter' with the TARGET argument set to the target
to which the texture is bound, and the PNAME argument set to
-`GL_TEXTURE_RESIDENT'. This is the only way that the residence status
-of a default texture can be queried.
+`GL_TEXTURE_RESIDENT'. This is the only way that the residence status of
+a default texture can be queried.
`GL_INVALID_VALUE' is generated if N is negative.
`GL_INVALID_VALUE' is generated if any element in TEXTURES is 0 or does
-not name a texture. In that case, the function returns `GL_FALSE' and
+not name a texture. In that case, the function returns `GL_FALSE' and
the contents of RESIDENCES is indeterminate.
`GL_INVALID_OPERATION' is generated if `glAreTexturesResident' is
`glArrayElement' commands are used within `glBegin'/`glEnd' pairs to
specify vertex and attribute data for point, line, and polygon
-primitives. If `GL_VERTEX_ARRAY' is enabled when `glArrayElement' is
+primitives. If `GL_VERTEX_ARRAY' is enabled when `glArrayElement' is
called, a single vertex is drawn, using vertex and attribute data taken
-from location I of the enabled arrays. If `GL_VERTEX_ARRAY' is not
+from location I of the enabled arrays. If `GL_VERTEX_ARRAY' is not
enabled, no drawing occurs but the attributes corresponding to the
enabled arrays are modified.
Changes made to array data between the execution of `glBegin' and the
corresponding execution of `glEnd' may affect calls to `glArrayElement'
that are made within the same `glBegin'/`glEnd' period in nonsequential
-ways. That is, a call to `glArrayElement' that precedes a change to
+ways. That is, a call to `glArrayElement' 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.
Specifies the shader object that is to be attached.
In order to create an executable, there must be a way to specify the
-list of things that will be linked together. Program objects provide
-this mechanism. Shaders that are to be linked together in a program
-object must first be attached to that program object. `glAttachShader'
+list of things that will be linked together. Program objects provide
+this mechanism. Shaders that are to be linked together in a program
+object must first be attached to that program object. `glAttachShader'
attaches the shader object specified by SHADER to the program object
-specified by PROGRAM. This indicates that SHADER will be included in
+specified by PROGRAM. This indicates that SHADER will be included in
link operations that will be performed on PROGRAM.
All operations that can be performed on a shader object are valid
-whether or not the shader object is attached to a program object. It is
+whether or not the shader object is attached to a program object. It is
permissible to attach a shader object to a program object before source
code has been loaded into the shader object or before the shader object
-has been compiled. It is permissible to attach multiple shader objects
+has been compiled. It is permissible to attach multiple shader objects
of the same type because each may contain a portion of the complete
-shader. It is also permissible to attach a shader object to more than
-one program object. If a shader object is deleted while it is attached
+shader. It is also permissible to attach a shader object to more than
+one program object. If a shader object is deleted while it is attached
to a program object, it will be flagged for deletion, and deletion will
not occur until `glDetachShader' is called to detach it from all program
objects to which it is attached.
TARGET
Specifies the target type of query object established between
- `glBeginQuery' and the subsequent `glEndQuery'. The symbolic
+ `glBeginQuery' and the subsequent `glEndQuery'. The symbolic
constant must be `GL_SAMPLES_PASSED'.
ID
Specifies the name of a query object.
`glBeginQuery' and `glEndQuery' delimit the boundaries of a query
-object. If a query object with name ID does not yet exist it is
-created.
+object. If a query object with name ID does not yet exist it is created.
When `glBeginQuery' is executed, the query object's samples-passed
-counter is reset to 0. Subsequent rendering will increment the counter
-once for every sample that passes the depth test. When `glEndQuery' is
+counter is reset to 0. Subsequent rendering will increment the counter
+once for every sample that passes the depth test. When `glEndQuery' is
executed, the samples-passed counter is assigned to the query object's
-result value. This value can be queried by calling `glGetQueryObject'
+result value. This value can be queried by calling `glGetQueryObject'
with PNAME`GL_QUERY_RESULT'.
Querying the `GL_QUERY_RESULT' implicitly flushes the GL pipeline until
the rendering delimited by the query object has completed and the result
-is available. `GL_QUERY_RESULT_AVAILABLE' can be queried to determine
-if the result is immediately available or if the rendering is not yet
+is available. `GL_QUERY_RESULT_AVAILABLE' can be queried to determine if
+the result is immediately available or if the rendering is not yet
complete.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_SAMPLES_PASSED'.
`GL_QUAD_STRIP', and `GL_POLYGON'.
`glBegin' and `glEnd' delimit the vertices that define a primitive or a
-group of like primitives. `glBegin' 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:
+group of like primitives. `glBegin' 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:
`GL_POINTS'
- Treats each vertex as a single point. Vertex N defines point N . N
+ Treats each vertex as a single point. Vertex N defines point N . N
points are drawn.
`GL_LINES'
Treats each pair of vertices as an independent line segment.
- Vertices 2\u2062N-1 and 2\u2062N define line N . N/2 lines are drawn.
+ Vertices 2\u2062N-1 and 2\u2062N define line N . N/2 lines are drawn.
`GL_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.
+ the last. Vertices N and N+1 define line N . N-1 lines are drawn.
`GL_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.
+ 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.
`GL_TRIANGLES'
Treats each triplet of vertices as an independent triangle.
- Vertices 3\u2062N-2 , 3\u2062N-1 , and 3\u2062N define triangle N . N/3 triangles
+ Vertices 3\u2062N-2 , 3\u2062N-1 , and 3\u2062N define triangle N . N/3 triangles
are drawn.
`GL_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
+ 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.
`GL_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.
+ 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.
`GL_QUADS'
Treats each group of four vertices as an independent quadrilateral.
N/4 quadrilaterals are drawn.
`GL_QUAD_STRIP'
- Draws a connected group of quadrilaterals. One quadrilateral is
+ Draws a connected group of quadrilaterals. One quadrilateral is
defined for each pair of vertices presented after the first pair.
Vertices 2\u2062N-1 , 2\u2062N , 2\u2062N+2 , and 2\u2062N+1 define quadrilateral N .
- N/2-1 quadrilaterals are drawn. Note that the order in which
+ 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.
`GL_POLYGON'
- Draws a single, convex polygon. Vertices 1 through N define this
+ Draws a single, convex polygon. Vertices 1 through N define this
polygon.
Only a subset of GL commands can be used between `glBegin' and `glEnd'.
The commands are `glVertex', `glColor', `glSecondaryColor', `glIndex',
`glNormal', `glFogCoord', `glTexCoord', `glMultiTexCoord',
`glVertexAttrib', `glEvalCoord', `glEvalPoint', `glArrayElement',
-`glMaterial', and `glEdgeFlag'. Also, it is acceptable to use
+`glMaterial', and `glEdgeFlag'. Also, it is acceptable to use
`glCallList' or `glCallLists' to execute display lists that include only
-the preceding commands. If any other GL command is executed between
+the preceding commands. If any other GL command is executed between
`glBegin' and `glEnd', the error flag is set and the command is ignored.
Regardless of the value chosen for MODE, there is no limit to the number
-of vertices that can be defined between `glBegin' and `glEnd'. Lines,
+of vertices that can be defined between `glBegin' and `glEnd'. Lines,
triangles, quadrilaterals, and polygons that are incompletely specified
-are not drawn. Incomplete specification results when either too few
+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.
+incorrect multiple of vertices is specified. The incomplete primitive is
+ignored; the rest are drawn.
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
+and 3 for a polygon. Modes that require a certain multiple of vertices
are `GL_LINES' (2), `GL_TRIANGLES' (3), `GL_QUADS' (4), and
`GL_QUAD_STRIP' (2).
`glBindAttribLocation' is used to associate a user-defined attribute
variable in the program object specified by PROGRAM with a generic
-vertex attribute index. The name of the user-defined attribute variable
-is passed as a null terminated string in NAME. The generic vertex
-attribute index to be bound to this variable is specified by INDEX. When
+vertex attribute index. The name of the user-defined attribute variable
+is passed as a null terminated string in NAME. The generic vertex
+attribute index to be bound to this variable is specified by INDEX. When
PROGRAM is made part of current state, values provided via the generic
vertex attribute INDEX will modify the value of the user-defined
attribute variable specified by NAME.
If NAME refers to a matrix attribute variable, INDEX refers to the first
-column of the matrix. Other matrix columns are then automatically bound
+column of the matrix. Other matrix columns are then automatically bound
to locations INDEX+1 for a matrix of type mat2; INDEX+1 and INDEX+2 for
a matrix of type mat3; and INDEX+1, INDEX+2, and INDEX+3 for a matrix of
type mat4.
This command makes it possible for vertex shaders to use descriptive
names for attribute variables rather than generic variables that are
-numbered from 0 to `GL_MAX_VERTEX_ATTRIBS' -1. The values sent to each
+numbered from 0 to `GL_MAX_VERTEX_ATTRIBS' -1. The values sent to each
generic attribute index are part of current state, just like standard
-vertex attributes such as color, normal, and vertex position. If a
+vertex attributes such as color, normal, and vertex position. If a
different program object is made current by calling `glUseProgram', the
generic vertex attributes are tracked in such a way that the same values
will be observed by attributes in the new program object that are also
Attribute variable name-to-generic attribute index bindings for a
program object can be explicitly assigned at any time by calling
-`glBindAttribLocation'. Attribute bindings do not go into effect until
-`glLinkProgram' is called. After a program object has been linked
+`glBindAttribLocation'. Attribute bindings do not go into effect until
+`glLinkProgram' is called. After a program object has been linked
successfully, the index values for generic attributes remain fixed (and
their values can be queried) until the next link command occurs.
Applications are not allowed to bind any of the standard OpenGL vertex
attributes using this command, as they are bound automatically when
-needed. Any attribute binding that occurs after the program object has
+needed. Any attribute binding that occurs after the program object has
been linked will not take effect until the next time the program object
is linked.
"Bind a named buffer object.
TARGET
- Specifies the target to which the buffer object is bound. The
+ Specifies the target to which the buffer object is bound. The
symbolic constant must be `GL_ARRAY_BUFFER',
`GL_ELEMENT_ARRAY_BUFFER', `GL_PIXEL_PACK_BUFFER', or
`GL_PIXEL_UNPACK_BUFFER'.
BUFFER
Specifies the name of a buffer object.
-`glBindBuffer' lets you create or use a named buffer object. Calling
+`glBindBuffer' lets you create or use a named buffer object. Calling
`glBindBuffer' with TARGET set to `GL_ARRAY_BUFFER',
`GL_ELEMENT_ARRAY_BUFFER', `GL_PIXEL_PACK_BUFFER' or
`GL_PIXEL_UNPACK_BUFFER' and BUFFER set to the name of the new buffer
-object binds the buffer object name to the target. When a buffer object
+object binds the buffer object name to the target. When a buffer object
is bound to a target, the previous binding for that target is
automatically broken.
-Buffer object names are unsigned integers. The value zero is reserved,
+Buffer object names are unsigned integers. The value zero is reserved,
but there is no default buffer object for each buffer object target.
Instead, BUFFER set to zero effectively unbinds any buffer object
previously bound, and restores client memory usage for that buffer
-object target. Buffer object names and the corresponding buffer object
+object target. Buffer object names and the corresponding buffer object
contents are local to the shared display-list space (see
`glXCreateContext') of the current GL rendering context; two rendering
contexts share buffer object names only if they also share display
While a non-zero buffer object name is bound, GL operations on the
target to which it is bound affect the bound buffer object, and queries
of the target to which it is bound return state from the bound buffer
-object. While buffer object name zero is bound, as in the initial
-state, attempts to modify or query state on the target to which it is
-bound generates an `GL_INVALID_OPERATION' error.
+object. While buffer object name zero is bound, as in the initial state,
+attempts to modify or query state on the target to which it is bound
+generates an `GL_INVALID_OPERATION' error.
When vertex array pointer state is changed, for example by a call to
`glNormalPointer', the current buffer object binding
(`GL_ARRAY_BUFFER_BINDING') is copied into the corresponding client
state for the vertex array type being changed, for example
-`GL_NORMAL_ARRAY_BUFFER_BINDING'. While a non-zero buffer object is
+`GL_NORMAL_ARRAY_BUFFER_BINDING'. While a non-zero buffer object is
bound to the `GL_ARRAY_BUFFER' target, the vertex array pointer
parameter that is traditionally interpreted as a pointer to client-side
memory is instead interpreted as an offset within the buffer object
target, the following commands are affected: `glGetCompressedTexImage',
`glGetConvolutionFilter', `glGetHistogram', `glGetMinmax',
`glGetPixelMap', `glGetPolygonStipple', `glGetSeparableFilter',
-`glGetTexImage', and `glReadPixels'. The pointer parameter that is
+`glGetTexImage', and `glReadPixels'. The pointer parameter that is
traditionally interpreted as a pointer to client-side memory where the
pixels are to be packed is instead interpreted as an offset within the
buffer object measured in basic machine units.
`glConvolutionFilter2D', `glDrawPixels', `glPixelMap',
`glPolygonStipple', `glSeparableFilter2D', `glTexImage1D',
`glTexImage2D', `glTexImage3D', `glTexSubImage1D', `glTexSubImage2D',
-and `glTexSubImage3D'. The pointer parameter that is traditionally
+and `glTexSubImage3D'. The pointer parameter that is traditionally
interpreted as a pointer to client-side memory from which the pixels are
to be unpacked is instead interpreted as an offset within the buffer
object measured in basic machine units.
bound buffer object is deleted with `glDeleteBuffers'.
Once created, a named buffer object may be re-bound to any target as
-often as needed. However, the GL implementation may make choices about
+often as needed. However, the GL implementation may make choices about
how to optimize the storage of a buffer object based on its initial
binding target.
"Bind a named texture to a texturing target.
TARGET
- Specifies the target to which the texture is bound. Must be either
+ Specifies the target to which the texture is bound. Must be either
`GL_TEXTURE_1D', `GL_TEXTURE_2D', `GL_TEXTURE_3D', or
`GL_TEXTURE_CUBE_MAP'.
TEXTURE
Specifies the name of a texture.
-`glBindTexture' lets you create or use a named texture. Calling
+`glBindTexture' lets you create or use a named texture. Calling
`glBindTexture' with TARGET set to `GL_TEXTURE_1D', `GL_TEXTURE_2D',
`GL_TEXTURE_3D' or `GL_TEXTURE_CUBE_MAP' and TEXTURE set to the name of
-the new texture binds the texture name to the target. When a texture is
+the new texture binds the texture name to the target. When a texture is
bound to a target, the previous binding for that target is automatically
broken.
-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 `glXCreateContext') of the current GL rendering
-context; two rendering contexts share texture names only if they also
-share display lists.
+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 `glXCreateContext') of the current GL rendering context; two
+rendering contexts share texture names only if they also share display
+lists.
You may use `glGenTextures' to generate a set of new texture names.
a texture first bound to `GL_TEXTURE_2D' becomes two-dimensional
texture, a texture first bound to `GL_TEXTURE_3D' becomes
three-dimensional texture, and a texture first bound to
-`GL_TEXTURE_CUBE_MAP' becomes a cube-mapped texture. The state of a
+`GL_TEXTURE_CUBE_MAP' becomes a cube-mapped texture. The state of a
one-dimensional texture immediately after it is first bound is
equivalent to the state of the default `GL_TEXTURE_1D' at GL
initialization, and similarly for two- and three-dimensional textures
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 is active
-on the target to which a texture is bound, the bound texture is used. In
+bound return state from the bound texture. If texture mapping is active
+on the target to which a texture is bound, 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.
texture is deleted with `glDeleteTextures'.
Once created, a named texture may be re-bound to its same original
-target as often as needed. It is usually much faster to use
+target as often as needed. It is usually much faster to use
`glBindTexture' to bind an existing named texture to one of the texture
targets than it is to reload the texture image using `glTexImage1D',
-`glTexImage2D', or `glTexImage3D'. For additional control over
+`glTexImage2D', or `glTexImage3D'. For additional control over
performance, use `glPrioritizeTextures'.
`glBindTexture' is included in display lists.
XORIG
YORIG
- Specify the location of the origin in the bitmap image. The origin
+ 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.
BITMAP
Specifies the address of the bitmap image.
-A bitmap is a binary image. When drawn, the bitmap is positioned
+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
+color or index. Frame buffer pixels corresponding to 0's in the bitmap
are not modified.
-`glBitmap' 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 X and Y 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.
+`glBitmap' 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 X and Y 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.
If a non-zero named buffer object is bound to the
`GL_PIXEL_UNPACK_BUFFER' target (see `glBindBuffer') while a bitmap
The bitmap image is interpreted like image data for the `glDrawPixels'
command, with WIDTH and HEIGHT corresponding to the width and height
arguments of that command, and with TYPE set to `GL_BITMAP' and FORMAT
-set to `GL_COLOR_INDEX'. Modes specified using `glPixelStore' affect
-the interpretation of bitmap image data; modes specified using
+set to `GL_COLOR_INDEX'. Modes specified using `glPixelStore' affect the
+interpretation of bitmap image data; modes specified using
`glPixelTransfer' do not.
If the current raster position is invalid, `glBitmap' is ignored.
Y_W=⌊Y_R-Y_O,⌋
where (X_R,Y_R) is the raster position and (X_O,Y_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
+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 Z coordinate, color or color index, and current raster
-texture coordinates. They are then treated just as if they had been
+texture coordinates. They are then treated just as if they had been
generated by a point, line, or polygon, including texture mapping,
fogging, and all per-fragment operations such as alpha and depth
testing.
After the bitmap has been drawn, the X and Y coordinates of the current
-raster position are offset by XMOVE and YMOVE. No change is made to the
+raster position are offset by XMOVE and YMOVE. No change is made to the
Z coordinate of the current raster position, or to the current raster
color, texture coordinates, or index.
specify the components of `GL_BLEND_COLOR'
The `GL_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 `glBlendFunc' for a complete description of
-the blending operations. Initially the `GL_BLEND_COLOR' is set to (0,
-0, 0, 0).
+blending factors. The color components are clamped to the range [0,1]
+before being stored. See `glBlendFunc' for a complete description of the
+blending operations. Initially the `GL_BLEND_COLOR' is set to (0, 0, 0,
+0).
`GL_INVALID_OPERATION' is generated if `glBlendColor' is executed
between the execution of `glBegin' and the corresponding execution of
MODERGB
specifies the RGB blend equation, how the red, green, and blue
- components of the source and destination colors are combined. It
+ components of the source and destination colors are combined. It
must be `GL_FUNC_ADD', `GL_FUNC_SUBTRACT',
`GL_FUNC_REVERSE_SUBTRACT', `GL_MIN', `GL_MAX'.
MODEALPHA
specifies the alpha blend equation, how the alpha component of the
- source and destination colors are combined. It must be
+ source and destination colors are combined. It must be
`GL_FUNC_ADD', `GL_FUNC_SUBTRACT', `GL_FUNC_REVERSE_SUBTRACT',
`GL_MIN', `GL_MAX'.
The blend equations determines how a new pixel (the ''source'' color) is
combined with a pixel already in the framebuffer (the ''destination''
-color). This function specifies one blend equation for the RGB-color
+color). This function specifies one blend equation for the RGB-color
components and one blend equation for the alpha component.
The blend equations use the source and destination blend factors
-specified by either `glBlendFunc' or `glBlendFuncSeparate'. See
+specified by either `glBlendFunc' or `glBlendFuncSeparate'. See
`glBlendFunc' or `glBlendFuncSeparate' for a description of the various
blend factors.
In the equations that follow, source and destination color components
are referred to as (R_S,G_SB_SA_S) and (R_D,G_DB_DA_D) , respectively.
-The result color is referred to as (R_R,G_RB_RA_R) . The source and
+The result color is referred to as (R_R,G_RB_RA_R) . The source and
destination blend factors are denoted (S_R,S_GS_BS_A) and
-(D_R,D_GD_BD_A) , respectively. For these equations all color
-components are understood to have values in the range [0,1] .
+(D_R,D_GD_BD_A) , respectively. For these equations all color components
+are understood to have values in the range [0,1] .
*Mode*
*RGB Components*, *Alpha Component*
The `GL_MIN' and `GL_MAX' equations are useful for applications that
analyze image data (image thresholding against a constant color, for
-example). The `GL_FUNC_ADD' equation is useful for antialiasing and
+example). The `GL_FUNC_ADD' equation is useful for antialiasing and
transparency, among other things.
Initially, both the RGB blend equation and the alpha blend equation are
blend equation.
MODE
- specifies how source and destination colors are combined. It must
+ specifies how source and destination colors are combined. It must
be `GL_FUNC_ADD', `GL_FUNC_SUBTRACT', `GL_FUNC_REVERSE_SUBTRACT',
`GL_MIN', `GL_MAX'.
The blend equations determine how a new pixel (the ''source'' color) is
combined with a pixel already in the framebuffer (the ''destination''
-color). This function sets both the RGB blend equation and the alpha
+color). This function sets both the RGB blend equation and the alpha
blend equation to a single equation.
These equations use the source and destination blend factors specified
-by either `glBlendFunc' or `glBlendFuncSeparate'. See `glBlendFunc' or
+by either `glBlendFunc' or `glBlendFuncSeparate'. See `glBlendFunc' or
`glBlendFuncSeparate' for a description of the various blend factors.
In the equations that follow, source and destination color components
are referred to as (R_S,G_SB_SA_S) and (R_D,G_DB_DA_D) , respectively.
-The result color is referred to as (R_R,G_RB_RA_R) . The source and
+The result color is referred to as (R_R,G_RB_RA_R) . The source and
destination blend factors are denoted (S_R,S_GS_BS_A) and
-(D_R,D_GD_BD_A) , respectively. For these equations all color
-components are understood to have values in the range [0,1] .
+(D_R,D_GD_BD_A) , respectively. For these equations all color components
+are understood to have values in the range [0,1] .
*Mode*
*RGB Components*, *Alpha Component*
The `GL_MIN' and `GL_MAX' equations are useful for applications that
analyze image data (image thresholding against a constant color, for
-example). The `GL_FUNC_ADD' equation is useful for antialiasing and
+example). The `GL_FUNC_ADD' equation is useful for antialiasing and
transparency, among other things.
Initially, both the RGB blend equation and the alpha blend equation are
SRCRGB
Specifies how the red, green, and blue blending factors are
- computed. The following symbolic constants are accepted:
- `GL_ZERO', `GL_ONE', `GL_SRC_COLOR', `GL_ONE_MINUS_SRC_COLOR',
- `GL_DST_COLOR', `GL_ONE_MINUS_DST_COLOR', `GL_SRC_ALPHA',
- `GL_ONE_MINUS_SRC_ALPHA', `GL_DST_ALPHA', `GL_ONE_MINUS_DST_ALPHA',
- `GL_CONSTANT_COLOR', `GL_ONE_MINUS_CONSTANT_COLOR',
- `GL_CONSTANT_ALPHA', `GL_ONE_MINUS_CONSTANT_ALPHA', and
- `GL_SRC_ALPHA_SATURATE'. The initial value is `GL_ONE'.
+ computed. The following symbolic constants are accepted: `GL_ZERO',
+ `GL_ONE', `GL_SRC_COLOR', `GL_ONE_MINUS_SRC_COLOR', `GL_DST_COLOR',
+ `GL_ONE_MINUS_DST_COLOR', `GL_SRC_ALPHA', `GL_ONE_MINUS_SRC_ALPHA',
+ `GL_DST_ALPHA', `GL_ONE_MINUS_DST_ALPHA', `GL_CONSTANT_COLOR',
+ `GL_ONE_MINUS_CONSTANT_COLOR', `GL_CONSTANT_ALPHA',
+ `GL_ONE_MINUS_CONSTANT_ALPHA', and `GL_SRC_ALPHA_SATURATE'. The
+ initial value is `GL_ONE'.
DSTRGB
Specifies how the red, green, and blue destination blending factors
- are computed. The following symbolic constants are accepted:
+ are computed. The following symbolic constants are accepted:
`GL_ZERO', `GL_ONE', `GL_SRC_COLOR', `GL_ONE_MINUS_SRC_COLOR',
`GL_DST_COLOR', `GL_ONE_MINUS_DST_COLOR', `GL_SRC_ALPHA',
`GL_ONE_MINUS_SRC_ALPHA', `GL_DST_ALPHA', `GL_ONE_MINUS_DST_ALPHA'.
`GL_CONSTANT_COLOR', `GL_ONE_MINUS_CONSTANT_COLOR',
- `GL_CONSTANT_ALPHA', and `GL_ONE_MINUS_CONSTANT_ALPHA'. The
- initial value is `GL_ZERO'.
+ `GL_CONSTANT_ALPHA', and `GL_ONE_MINUS_CONSTANT_ALPHA'. The initial
+ value is `GL_ZERO'.
SRCALPHA
- Specified how the alpha source blending factor is computed. The
- same symbolic constants are accepted as for SRCRGB. The initial
+ Specified how the alpha source blending factor is computed. The
+ same symbolic constants are accepted as for SRCRGB. The initial
value is `GL_ONE'.
DSTALPHA
Specified how the alpha destination blending factor is computed.
- The same symbolic constants are accepted as for DSTRGB. The
- initial value is `GL_ZERO'.
+ The same symbolic constants are accepted as for DSTRGB. The initial
+ value is `GL_ZERO'.
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 `glEnable' and `glDisable' with argument `GL_BLEND' to
+the frame buffer (the destination values). Blending is initially
+disabled. Use `glEnable' and `glDisable' with argument `GL_BLEND' to
enable and disable blending.
`glBlendFuncSeparate' defines the operation of blending when it is
-enabled. SRCRGB specifies which method is used to scale the source
-RGB-color components. DSTRGB specifies which method is used to scale
-the destination RGB-color components. Likewise, SRCALPHA specifies
-which method is used to scale the source alpha color component, and
-DSTALPHA specifies which method is used to scale the destination alpha
-component. The possible methods are described in the following table.
-Each method defines four scale factors, one each for red, green, blue,
-and alpha.
+enabled. SRCRGB specifies which method is used to scale the source
+RGB-color components. DSTRGB specifies which method is used to scale the
+destination RGB-color components. Likewise, SRCALPHA specifies which
+method is used to scale the source alpha color component, and DSTALPHA
+specifies which method is used to scale the destination alpha component.
+The possible methods are described in the following table. Each method
+defines four scale factors, one each for red, green, blue, and alpha.
In the table and in subsequent equations, source and destination color
-components are referred to as (R_S,G_SB_SA_S) and (R_D,G_DB_DA_D) . The
+components are referred to as (R_S,G_SB_SA_S) and (R_D,G_DB_DA_D) . The
color specified by `glBlendColor' is referred to as (R_C,G_CB_CA_C) .
They are understood to have integer values between 0 and (K_R,K_GK_BK_A)
, where
bitplanes.
Source and destination scale factors are referred to as (S_R,S_GS_BS_A)
-and (D_R,D_GD_BD_A) . All scale factors have range [0,1] .
+and (D_R,D_GD_BD_A) . All scale factors have range [0,1] .
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
+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
+factor equal to 0 reduces its multiplicand to 0. For example, when
SRCRGB is `GL_SRC_ALPHA', DSTRGB is `GL_ONE_MINUS_SRC_ALPHA', and A_S is
equal to K_A , the equations reduce to simple replacement:
SFACTOR
Specifies how the red, green, blue, and alpha source blending
- factors are computed. The following symbolic constants are
+ factors are computed. The following symbolic constants are
accepted: `GL_ZERO', `GL_ONE', `GL_SRC_COLOR',
`GL_ONE_MINUS_SRC_COLOR', `GL_DST_COLOR', `GL_ONE_MINUS_DST_COLOR',
`GL_SRC_ALPHA', `GL_ONE_MINUS_SRC_ALPHA', `GL_DST_ALPHA',
`GL_ONE_MINUS_DST_ALPHA', `GL_CONSTANT_COLOR',
`GL_ONE_MINUS_CONSTANT_COLOR', `GL_CONSTANT_ALPHA',
- `GL_ONE_MINUS_CONSTANT_ALPHA', and `GL_SRC_ALPHA_SATURATE'. The
+ `GL_ONE_MINUS_CONSTANT_ALPHA', and `GL_SRC_ALPHA_SATURATE'. The
initial value is `GL_ONE'.
DFACTOR
Specifies how the red, green, blue, and alpha destination blending
- factors are computed. The following symbolic constants are
+ factors are computed. The following symbolic constants are
accepted: `GL_ZERO', `GL_ONE', `GL_SRC_COLOR',
`GL_ONE_MINUS_SRC_COLOR', `GL_DST_COLOR', `GL_ONE_MINUS_DST_COLOR',
`GL_SRC_ALPHA', `GL_ONE_MINUS_SRC_ALPHA', `GL_DST_ALPHA',
- `GL_ONE_MINUS_DST_ALPHA'. `GL_CONSTANT_COLOR',
+ `GL_ONE_MINUS_DST_ALPHA'. `GL_CONSTANT_COLOR',
`GL_ONE_MINUS_CONSTANT_COLOR', `GL_CONSTANT_ALPHA', and
- `GL_ONE_MINUS_CONSTANT_ALPHA'. The initial value is `GL_ZERO'.
+ `GL_ONE_MINUS_CONSTANT_ALPHA'. The initial value is `GL_ZERO'.
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 `glEnable' and `glDisable' with argument `GL_BLEND' to
+the frame buffer (the destination values). Blending is initially
+disabled. Use `glEnable' and `glDisable' with argument `GL_BLEND' to
enable and disable blending.
`glBlendFunc' defines the operation of blending when it is enabled.
SFACTOR specifies which method is used to scale the source color
-components. DFACTOR specifies which method is used to scale the
-destination color components. The possible methods are described in the
-following table. Each method defines four scale factors, one each for
-red, green, blue, and alpha. In the table and in subsequent equations,
+components. DFACTOR specifies which method is used to scale the
+destination color components. The possible methods are described in the
+following table. Each method defines four scale factors, one each for
+red, green, blue, and alpha. In the table and in subsequent equations,
source and destination color components are referred to as
-(R_S,G_SB_SA_S) and (R_D,G_DB_DA_D) . The color specified by
-`glBlendColor' is referred to as (R_C,G_CB_CA_C) . They are understood
+(R_S,G_SB_SA_S) and (R_D,G_DB_DA_D) . The color specified by
+`glBlendColor' is referred to as (R_C,G_CB_CA_C) . They are understood
to have integer values between 0 and (K_R,K_GK_BK_A) , where
K_C=2^M_C,-1
bitplanes.
Source and destination scale factors are referred to as (S_R,S_GS_BS_A)
-and (D_R,D_GD_BD_A) . The scale factors described in the table, denoted
-(F_R,F_GF_BF_A) , represent either source or destination factors. All
+and (D_R,D_GD_BD_A) . The scale factors described in the table, denoted
+(F_R,F_GF_BF_A) , represent either source or destination factors. All
scale factors have range [0,1] .
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
+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
+factor equal to 0 reduces its multiplicand to 0. For example, when
SFACTOR is `GL_SRC_ALPHA', DFACTOR is `GL_ONE_MINUS_SRC_ALPHA', and A_S
is equal to K_A , the equations reduce to simple replacement:
"Creates and initializes a buffer object's data store.
TARGET
- Specifies the target buffer object. The symbolic constant must be
+ Specifies the target buffer object. The symbolic constant must be
`GL_ARRAY_BUFFER', `GL_ELEMENT_ARRAY_BUFFER',
`GL_PIXEL_PACK_BUFFER', or `GL_PIXEL_UNPACK_BUFFER'.
for initialization, or `NULL' if no data is to be copied.
USAGE
- Specifies the expected usage pattern of the data store. The
+ Specifies the expected usage pattern of the data store. The
symbolic constant must be `GL_STREAM_DRAW', `GL_STREAM_READ',
`GL_STREAM_COPY', `GL_STATIC_DRAW', `GL_STATIC_READ',
`GL_STATIC_COPY', `GL_DYNAMIC_DRAW', `GL_DYNAMIC_READ', or
`GL_DYNAMIC_COPY'.
`glBufferData' creates a new data store for the buffer object currently
-bound to TARGET. Any pre-existing data store is deleted. The new data
-store is created with the specified SIZE in bytes and USAGE. If DATA is
+bound to TARGET. Any pre-existing data store is deleted. The new data
+store is created with the specified SIZE in bytes and USAGE. If DATA is
not `NULL', the data store is initialized with data from this pointer.
In its initial state, the new data store is not mapped, it has a `NULL'
mapped pointer, and its mapped access is `GL_READ_WRITE'.
USAGE is a hint to the GL implementation as to how a buffer object's
-data store will be accessed. This enables the GL implementation to make
+data store will be accessed. This enables the GL implementation to make
more intelligent decisions that may significantly impact buffer object
-performance. It does not, however, constrain the actual usage of the
-data store. USAGE can be broken down into two parts: first, the
+performance. It does not, however, constrain the actual usage of the
+data store. USAGE can be broken down into two parts: first, the
frequency of access (modification and usage), and second, the nature of
-that access. The frequency of access may be one of these:
+that access. The frequency of access may be one of these:
STREAM
The data store contents will be modified once and used at most a
"Updates a subset of a buffer object's data store.
TARGET
- Specifies the target buffer object. The symbolic constant must be
+ Specifies the target buffer object. The symbolic constant must be
`GL_ARRAY_BUFFER', `GL_ELEMENT_ARRAY_BUFFER',
`GL_PIXEL_PACK_BUFFER', or `GL_PIXEL_UNPACK_BUFFER'.
data store.
`glBufferSubData' redefines some or all of the data store for the buffer
-object currently bound to TARGET. Data starting at byte offset OFFSET
+object currently bound to TARGET. Data starting at byte offset OFFSET
and extending for SIZE bytes is copied to the data store from the memory
-pointed to by DATA. An error is thrown if OFFSET and SIZE together
+pointed to by DATA. An error is thrown if OFFSET and SIZE together
define a range beyond the bounds of the buffer object's data store.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_ARRAY_BUFFER',
Specifies the number of display lists to be executed.
TYPE
- Specifies the type of values in LISTS. Symbolic constants
+ Specifies the type of values in LISTS. Symbolic constants
`GL_BYTE', `GL_UNSIGNED_BYTE', `GL_SHORT', `GL_UNSIGNED_SHORT',
`GL_INT', `GL_UNSIGNED_INT', `GL_FLOAT', `GL_2_BYTES',
`GL_3_BYTES', and `GL_4_BYTES' are accepted.
LISTS
Specifies the address of an array of name offsets in the display
- list. The pointer type is void because the offsets can be bytes,
+ list. The pointer type is void because the offsets can be bytes,
shorts, ints, or floats, depending on the value of TYPE.
`glCallLists' causes each display list in the list of names passed as
-LISTS to be executed. As a result, the commands saved in each display
+LISTS 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
+display list. Names of display lists that have not been defined are
ignored.
`glCallLists' provides an efficient means for executing more than one
-display list. TYPE allows lists with various name formats to be
-accepted. The formats are as follows:
+display list. TYPE allows lists with various name formats to be
+accepted. The formats are as follows:
`GL_BYTE'
LISTS is treated as an array of signed bytes, each in the range
LISTS is treated as an array of four-byte floating-point values.
`GL_2_BYTES'
- LISTS is treated as an array of unsigned bytes. Each pair of bytes
- specifies a single display-list name. The value of the pair is
+ LISTS 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.
`GL_3_BYTES'
- LISTS is treated as an array of unsigned bytes. Each triplet of
- bytes specifies a single display-list name. The value of the
+ LISTS 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.
`GL_4_BYTES'
- LISTS is treated as an array of unsigned bytes. Each quadruplet of
- bytes specifies a single display-list name. The value of the
+ LISTS 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.
-The list of display-list names is not null-terminated. Rather, N
+The list of display-list names is not null-terminated. Rather, N
specifies how many names are to be taken from LISTS.
An additional level of indirection is made available with the
to each display-list name specified in LISTS before that display list is
executed.
-`glCallLists' 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.
+`glCallLists' 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.
-GL state is not saved and restored across a call to `glCallLists'. Thus,
+GL state is not saved and restored across a call to `glCallLists'. Thus,
changes made to GL state during the execution of the display lists
-remain after execution is completed. Use `glPushAttrib', `glPopAttrib',
+remain after execution is completed. Use `glPushAttrib', `glPopAttrib',
`glPushMatrix', and `glPopMatrix' to preserve GL state across
`glCallLists' calls.
LIST
Specifies the integer name of the display list to be executed.
-`glCallList' causes the named display list to be executed. The commands
+`glCallList' 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 LIST has not been defined as a
+called without using a display list. If LIST has not been defined as a
display list, `glCallList' is ignored.
-`glCallList' can appear inside a display list. To avoid the possibility
+`glCallList' 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.
+display-list execution. This limit is at least 64, and it depends on the
+implementation.
-GL state is not saved and restored across a call to `glCallList'. Thus,
+GL state is not saved and restored across a call to `glCallList'. Thus,
changes made to GL state during the execution of a display list remain
-after execution of the display list is completed. Use `glPushAttrib',
+after execution of the display list is completed. Use `glPushAttrib',
`glPopAttrib', `glPushMatrix', and `glPopMatrix' to preserve GL state
across `glCallList' calls.")
ALPHA
Specify the red, green, blue, and alpha values used when the
- accumulation buffer is cleared. The initial values are all 0.
+ accumulation buffer is cleared. The initial values are all 0.
`glClearAccum' specifies the red, green, blue, and alpha values used by
`glClear' to clear the accumulation buffer.
ALPHA
Specify the red, green, blue, and alpha values used when the color
- buffers are cleared. The initial values are all 0.
+ buffers are cleared. The initial values are all 0.
`glClearColor' specifies the red, green, blue, and alpha values used by
-`glClear' to clear the color buffers. Values specified by
-`glClearColor' are clamped to the range [0,1] .
+`glClear' to clear the color buffers. Values specified by `glClearColor'
+are clamped to the range [0,1] .
`GL_INVALID_OPERATION' is generated if `glClearColor' is executed
between the execution of `glBegin' and the corresponding execution of
The initial value is 1.
`glClearDepth' specifies the depth value used by `glClear' to clear the
-depth buffer. Values specified by `glClearDepth' are clamped to the
+depth buffer. Values specified by `glClearDepth' are clamped to the
range [0,1] .
`GL_INVALID_OPERATION' is generated if `glClearDepth' is executed
The initial value is 0.
`glClearIndex' specifies the index used by `glClear' to clear the color
-index buffers. C is not clamped. Rather, C 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^M-1 , where
-M is the number of bits in a color index stored in the frame buffer.
+index buffers. C is not clamped. Rather, C 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^M-1 , where M is the
+number of bits in a color index stored in the frame buffer.
`GL_INVALID_OPERATION' is generated if `glClearIndex' is executed
between the execution of `glBegin' and the corresponding execution of
"Specify the clear value for the stencil buffer.
S
- Specifies the index used when the stencil buffer is cleared. The
+ Specifies the index used when the stencil buffer is cleared. The
initial value is 0.
`glClearStencil' specifies the index used by `glClear' to clear the
-stencil buffer. S is masked with 2^M-1 , where M is the number of bits
+stencil buffer. S is masked with 2^M-1 , where M is the number of bits
in the stencil buffer.
`GL_INVALID_OPERATION' is generated if `glClearStencil' is executed
"Clear buffers to preset values.
MASK
- Bitwise OR of masks that indicate the buffers to be cleared. The
+ Bitwise OR of masks that indicate the buffers to be cleared. The
four masks are `GL_COLOR_BUFFER_BIT', `GL_DEPTH_BUFFER_BIT',
`GL_ACCUM_BUFFER_BIT', and `GL_STENCIL_BUFFER_BIT'.
`glClear' sets the bitplane area of the window to values previously
selected by `glClearColor', `glClearIndex', `glClearDepth',
-`glClearStencil', and `glClearAccum'. Multiple color buffers can be
+`glClearStencil', and `glClearAccum'. Multiple color buffers can be
cleared simultaneously by selecting more than one buffer at a time using
`glDrawBuffer'.
The pixel ownership test, the scissor test, dithering, and the buffer
-writemasks affect the operation of `glClear'. The scissor box bounds
-the cleared region. Alpha function, blend function, logical operation,
+writemasks affect the operation of `glClear'. The scissor box bounds the
+cleared region. Alpha function, blend function, logical operation,
stenciling, texture mapping, and depth-buffering are ignored by
`glClear'.
"Select active texture unit.
TEXTURE
- Specifies which texture unit to make active. The number of texture
+ Specifies which texture unit to make active. The number of texture
units is implementation dependent, but must be at least two.
TEXTURE must be one of `GL_TEXTURE' I , where i ranges from 0 to
the value of `GL_MAX_TEXTURE_COORDS' - 1, which is an
- implementation-dependent value. The initial value is
- `GL_TEXTURE0'.
+ implementation-dependent value. The initial value is `GL_TEXTURE0'.
`glClientActiveTexture' selects the vertex array client state parameters
to be modified by `glTexCoordPointer', and enabled or disabled with
"Specify a plane against which all geometry is clipped.
PLANE
- Specifies which clipping plane is being positioned. Symbolic names
+ Specifies which clipping plane is being positioned. Symbolic names
of the form `GL_CLIP_PLANE'I, where I is an integer between 0 and
`GL_MAX_CLIP_PLANES' -1 , are accepted.
EQUATION
Specifies the address of an array of four double-precision
- floating-point values. These values are interpreted as a plane
+ floating-point values. These values are interpreted as a plane
equation.
Geometry is always clipped against the boundaries of a six-plane frustum
-in X, Y, and Z. `glClipPlane' allows the specification of additional
+in X, Y, and Z. `glClipPlane' allows the specification of additional
planes, not necessarily perpendicular to the X, Y, or Z axis, against
-which all geometry is clipped. To determine the maximum number of
+which all geometry is clipped. To determine the maximum number of
additional clipping planes, call `glGetIntegerv' with argument
-`GL_MAX_CLIP_PLANES'. All implementations support at least six such
-clipping planes. Because the resulting clipping region is the
+`GL_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.
`glClipPlane' specifies a half-space using a four-component plane
-equation. When `glClipPlane' is called, EQUATION is transformed by the
+equation. When `glClipPlane' is called, EQUATION 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. 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 IN with respect to that clipping plane.
Otherwise, it is OUT.
ALPHA
Specify whether red, green, blue, and alpha can or cannot be
- written into the frame buffer. The initial values are all
+ written into the frame buffer. The initial values are all
`GL_TRUE', indicating that the color components can be written.
`glColorMask' specifies whether the individual color components in the
-frame buffer can or cannot be written. If RED is `GL_FALSE', for
+frame buffer can or cannot be written. If RED is `GL_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.
-Changes to individual bits of components cannot be controlled. Rather,
+Changes to individual bits of components cannot be controlled. Rather,
changes are either enabled or disabled for entire color components.
`GL_INVALID_OPERATION' is generated if `glColorMask' is executed between
FACE
Specifies whether front, back, or both front and back material
- parameters should track the current color. Accepted values are
- `GL_FRONT', `GL_BACK', and `GL_FRONT_AND_BACK'. The initial value
+ parameters should track the current color. Accepted values are
+ `GL_FRONT', `GL_BACK', and `GL_FRONT_AND_BACK'. The initial value
is `GL_FRONT_AND_BACK'.
MODE
Specifies which of several material parameters track the current
- color. Accepted values are `GL_EMISSION', `GL_AMBIENT',
- `GL_DIFFUSE', `GL_SPECULAR', and `GL_AMBIENT_AND_DIFFUSE'. The
+ color. Accepted values are `GL_EMISSION', `GL_AMBIENT',
+ `GL_DIFFUSE', `GL_SPECULAR', and `GL_AMBIENT_AND_DIFFUSE'. The
initial value is `GL_AMBIENT_AND_DIFFUSE'.
`glColorMaterial' specifies which material parameters track the current
-color. When `GL_COLOR_MATERIAL' is enabled, the material parameter or
+color. When `GL_COLOR_MATERIAL' is enabled, the material parameter or
parameters specified by MODE, of the material or materials specified by
FACE, track the current color at all times.
To enable and disable `GL_COLOR_MATERIAL', call `glEnable' and
-`glDisable' with argument `GL_COLOR_MATERIAL'. `GL_COLOR_MATERIAL' is
+`glDisable' with argument `GL_COLOR_MATERIAL'. `GL_COLOR_MATERIAL' is
initially disabled.
`GL_INVALID_ENUM' is generated if FACE or MODE is not an accepted value.
"Define an array of colors.
SIZE
- Specifies the number of components per color. Must be 3 or 4. The
+ Specifies the number of components per color. Must be 3 or 4. The
initial value is 4.
TYPE
Specifies the data type of each color component in the array.
Symbolic constants `GL_BYTE', `GL_UNSIGNED_BYTE', `GL_SHORT',
`GL_UNSIGNED_SHORT', `GL_INT', `GL_UNSIGNED_INT', `GL_FLOAT', and
- `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
+ `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
STRIDE
- Specifies the byte offset between consecutive colors. If STRIDE is
- 0, the colors are understood to be tightly packed in the array. The
+ Specifies the byte offset between consecutive colors. If STRIDE is
+ 0, the colors are understood to be tightly packed in the array. The
initial value is 0.
POINTER
Specifies a pointer to the first component of the first color
- element in the array. The initial value is 0.
+ element in the array. The initial value is 0.
`glColorPointer' specifies the location and data format of an array of
-color components to use when rendering. SIZE specifies the number of
-components per color, and must be 3 or 4. TYPE specifies the data type
+color components to use when rendering. SIZE specifies the number of
+components per color, and must be 3 or 4. TYPE specifies the data type
of each color component, and STRIDE 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
+single array or stored in separate arrays. (Single-array storage may be
more efficient on some implementations; see `glInterleavedArrays'.)
If a non-zero named buffer object is bound to the `GL_ARRAY_BUFFER'
target (see `glBindBuffer') while a color array is specified, POINTER is
-treated as a byte offset into the buffer object's data store. Also, the
+treated as a byte offset into the buffer object's data store. Also, the
buffer object binding (`GL_ARRAY_BUFFER_BINDING') is saved as color
vertex array client-side state (`GL_COLOR_ARRAY_BUFFER_BINDING').
buffer object binding.
To enable and disable the color array, call `glEnableClientState' and
-`glDisableClientState' with the argument `GL_COLOR_ARRAY'. If enabled,
+`glDisableClientState' with the argument `GL_COLOR_ARRAY'. If enabled,
the color array is used when `glDrawArrays', `glMultiDrawArrays',
`glDrawElements', `glMultiDrawElements', `glDrawRangeElements', or
`glArrayElement' is called.
The number of table entries to replace.
FORMAT
- The format of the pixel data in DATA. The allowable values are
+ The format of the pixel data in DATA. The allowable values are
`GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA', `GL_LUMINANCE',
`GL_LUMINANCE_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', and `GL_BGRA'.
TYPE
- The type of the pixel data in DATA. The allowable values are
+ The type of the pixel data in DATA. The allowable values are
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_UNSIGNED_SHORT', `GL_SHORT',
`GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT', `GL_UNSIGNED_BYTE_3_3_2',
`GL_UNSIGNED_BYTE_2_3_3_REV', `GL_UNSIGNED_SHORT_5_6_5',
to replace the specified region of the color table.
`glColorSubTable' is used to respecify a contiguous portion of a color
-table previously defined using `glColorTable'. The pixels referenced by
+table previously defined using `glColorTable'. The pixels referenced by
DATA replace the portion of the existing table from indices START to
-START+COUNT-1 , inclusive. This region may not include any entries
-outside the range of the color table as it was originally specified. It
+START+COUNT-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.
"Set color lookup table parameters.
TARGET
- The target color table. Must be `GL_COLOR_TABLE',
+ The target color table. Must be `GL_COLOR_TABLE',
`GL_POST_CONVOLUTION_COLOR_TABLE', or
`GL_POST_COLOR_MATRIX_COLOR_TABLE'.
PNAME
- The symbolic name of a texture color lookup table parameter. Must
+ The symbolic name of a texture color lookup table parameter. Must
be one of `GL_COLOR_TABLE_SCALE' or `GL_COLOR_TABLE_BIAS'.
PARAMS
`glColorTableParameter' 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 `GL_COLOR_TABLE',
+table. TARGET indicates which color table the scale and bias terms apply
+to; it must be set to `GL_COLOR_TABLE',
`GL_POST_CONVOLUTION_COLOR_TABLE', or
`GL_POST_COLOR_MATRIX_COLOR_TABLE'.
-PNAME must be `GL_COLOR_TABLE_SCALE' to set the scale factors. In this
+PNAME must be `GL_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.
-PNAME must be `GL_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.
+PNAME must be `GL_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.
The color tables themselves are specified by calling `glColorTable'.
`GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE'.
INTERNALFORMAT
- The internal format of the color table. The allowable values are
+ The internal format of the color table. The allowable values are
`GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16',
`GL_LUMINANCE', `GL_LUMINANCE4', `GL_LUMINANCE8', `GL_LUMINANCE12',
`GL_LUMINANCE16', `GL_LUMINANCE_ALPHA', `GL_LUMINANCE4_ALPHA4',
The number of entries in the color lookup table specified by DATA.
FORMAT
- The format of the pixel data in DATA. The allowable values are
+ The format of the pixel data in DATA. The allowable values are
`GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA', `GL_LUMINANCE',
`GL_LUMINANCE_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', and `GL_BGRA'.
TYPE
- The type of the pixel data in DATA. The allowable values are
+ The type of the pixel data in DATA. The allowable values are
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_UNSIGNED_SHORT', `GL_SHORT',
`GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT', `GL_UNSIGNED_BYTE_3_3_2',
`GL_UNSIGNED_BYTE_2_3_3_REV', `GL_UNSIGNED_SHORT_5_6_5',
`glColorTable' 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
+or to load the contents of a color lookup table. Use the targets
`GL_PROXY_*' for the first case and the other targets for the second
case.
If TARGET is `GL_COLOR_TABLE', `GL_POST_CONVOLUTION_COLOR_TABLE', or
`GL_POST_COLOR_MATRIX_COLOR_TABLE', `glColorTable' builds a color lookup
-table from an array of pixels. The pixel array specified by WIDTH,
+table from an array of pixels. The pixel array specified by WIDTH,
FORMAT, TYPE, and DATA is extracted from memory and processed just as if
`glDrawPixels' were called, but processing stops after the final
expansion to RGBA is completed.
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 `glColorTableParameter' to set these
+components of each pixel. (Use `glColorTableParameter' to set these
scale and bias parameters.)
-Next, the R, G, B, and A values are clamped to the range [0,1] . Each
+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
+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
+(red, green, blue, alpha, luminance, and intensity). The mapping is as
follows:
R , G , B , A , ,
Finally, the red, green, blue, alpha, luminance, and/or intensity
-components of the resulting pixels are stored in the color table. They
+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] .
If TARGET is `GL_PROXY_*', `glColorTable' recomputes and stores the
`GL_COLOR_TABLE_RED_SIZE', `GL_COLOR_TABLE_GREEN_SIZE',
`GL_COLOR_TABLE_BLUE_SIZE', `GL_COLOR_TABLE_ALPHA_SIZE',
`GL_COLOR_TABLE_LUMINANCE_SIZE', and `GL_COLOR_TABLE_INTENSITY_SIZE'.
-There is no effect on the image or state of any actual color table. If
+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 `glColorTable' using the corresponding
+proxy state variables listed above are set to zero. Otherwise, the color
+table could be supported by `glColorTable' using the corresponding
non-proxy target, and the proxy state variables are set as if that
target were being defined.
The proxy state variables can be retrieved by calling
-`glGetColorTableParameter' with a target of `GL_PROXY_*'. This allows
+`glGetColorTableParameter' with a target of `GL_PROXY_*'. This allows
the application to decide if a particular `glColorTable' command would
succeed, and to determine what the resulting color table attributes
would be.
pixel group, based on the internal format of the table.
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
+[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
+selected by that index. If the color components and contents of the
table are represented as follows:
When `GL_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
+before being passed to the convolution operation. The colors resulting
from the convolution operation are modified by the post convolution
color lookup table when `GL_POST_CONVOLUTION_COLOR_TABLE' is enabled.
These modified colors are then sent to the color matrix operation.
Specify new red, green, and blue values for the current color.
ALPHA
- Specifies a new alpha value for the current color. Included only
- in the four-argument `glColor4' commands.
+ Specifies a new alpha value for the current color. Included only in
+ the four-argument `glColor4' commands.
The GL stores both a current single-valued color index and a current
-four-valued RGBA color. `glColor' sets a new four-valued RGBA color.
-`glColor' has two major variants: `glColor3' and `glColor4'. `glColor3'
+four-valued RGBA color. `glColor' sets a new four-valued RGBA color.
+`glColor' has two major variants: `glColor3' and `glColor4'. `glColor3'
variants specify new red, green, and blue values explicitly and set the
-current alpha value to 1.0 (full intensity) implicitly. `glColor4'
+current alpha value to 1.0 (full intensity) implicitly. `glColor4'
variants specify all four color components explicitly.
`glColor3b', `glColor4b', `glColor3s', `glColor4s', `glColor3i', and
`glColor4i' take three or four signed byte, short, or long integers as
-arguments. When *v* is appended to the name, the color commands can
-take a pointer to an array of such values.
+arguments. When *v* is appended to the name, the color commands can take
+a pointer to an array of such values.
Current color values are stored in floating-point format, with
-unspecified mantissa and exponent sizes. Unsigned integer color
+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,
+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
+representable value maps to -1.0 . (Note that this mapping does not
convert 0 precisely to 0.0.) Floating-point values are mapped directly.
Neither floating-point nor signed integer values are clamped to the
-range [0,1] before the current color is updated. However, color
+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.")
in the shader object specified by SHADER.
The compilation status will be stored as part of the shader object's
-state. This value will be set to `GL_TRUE' if the shader was compiled
-without errors and is ready for use, and `GL_FALSE' otherwise. It can
-be queried by calling `glGetShader' with arguments SHADER and
+state. This value will be set to `GL_TRUE' if the shader was compiled
+without errors and is ready for use, and `GL_FALSE' otherwise. It can be
+queried by calling `glGetShader' with arguments SHADER and
`GL_COMPILE_STATUS'.
Compilation of a shader can fail for a number of reasons as specified by
-the OpenGL Shading Language Specification. Whether or not the
+the OpenGL Shading Language Specification. Whether or not the
compilation was successful, information about the compilation can be
obtained from the shader object's information log by calling
`glGetShaderInfoLog'.
"Specify a one-dimensional texture image in a compressed format.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_1D' or
+ Specifies the target texture. Must be `GL_TEXTURE_1D' or
`GL_PROXY_TEXTURE_1D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
Specifies the format of the compressed image data stored at address
WIDTH
Specifies the width of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^N+2\u2061(BORDER,) for some integer N . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^N+2\u2061(BORDER,) 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.
+ wide. The height of the 1D texture image is 1.
BORDER
- Specifies the width of the border. Must be either 0 or 1.
+ Specifies the width of the border. Must be either 0 or 1.
IMAGESIZE
Specifies the number of unsigned bytes of image data starting at
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable one-dimensional texturing, call `glEnable' and `glDisable' with
argument `GL_TEXTURE_1D'.
If TARGET is `GL_PROXY_TEXTURE_1D', no data is read from DATA, 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
-`glGetError'). To query for an entire mipmap array, use an image array
-level greater than or equal to 1.
+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 `glGetError').
+To query for an entire mipmap array, use an image array level greater
+than or equal to 1.
INTERNALFORMAT must be extension-specified compressed-texture format.
When a texture is loaded with `glTexImage1D' using a generic compressed
texture format (e.g., `GL_COMPRESSED_RGB') the GL selects from one of
-its extensions supporting compressed textures. In order to load the
+its extensions supporting compressed textures. In order to load the
compressed texture image using `glCompressedTexImage1D', query the
compressed texture image's size and format using
`glGetTexLevelParameter'.
"Specify a two-dimensional texture image in a compressed format.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_2D',
+ Specifies the target texture. Must be `GL_TEXTURE_2D',
`GL_PROXY_TEXTURE_2D', `GL_TEXTURE_CUBE_MAP_POSITIVE_X',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_X', `GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Y', `GL_TEXTURE_CUBE_MAP_POSITIVE_Z',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Z', or `GL_PROXY_TEXTURE_CUBE_MAP'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
Specifies the format of the compressed image data stored at address
WIDTH
Specifies the width of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^N+2\u2061(BORDER,) for some integer N . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^N+2\u2061(BORDER,) for some integer N . All
implementations support 2D texture images that are at least 64
texels wide and cube-mapped texture images that are at least 16
texels wide.
HEIGHT
Specifies the height of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be Must be 2^N+2\u2061(BORDER,) for some integer N . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be Must be 2^N+2\u2061(BORDER,) for some integer N . All
implementations support 2D texture images that are at least 64
texels high and cube-mapped texture images that are at least 16
texels high.
BORDER
- Specifies the width of the border. Must be either 0 or 1.
+ Specifies the width of the border. Must be either 0 or 1.
IMAGESIZE
Specifies the number of unsigned bytes of image data starting at
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call `glEnable' and `glDisable' with
-argument `GL_TEXTURE_2D'. To enable and disable texturing using
+argument `GL_TEXTURE_2D'. To enable and disable texturing using
cube-mapped textures, call `glEnable' and `glDisable' with argument
`GL_TEXTURE_CUBE_MAP'.
If TARGET is `GL_PROXY_TEXTURE_2D', no data is read from DATA, 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
-`glGetError'). To query for an entire mipmap array, use an image array
-level greater than or equal to 1.
+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 `glGetError').
+To query for an entire mipmap array, use an image array level greater
+than or equal to 1.
INTERNALFORMAT must be an extension-specified compressed-texture format.
When a texture is loaded with `glTexImage2D' using a generic compressed
texture format (e.g., `GL_COMPRESSED_RGB'), the GL selects from one of
-its extensions supporting compressed textures. In order to load the
+its extensions supporting compressed textures. In order to load the
compressed texture image using `glCompressedTexImage2D', query the
compressed texture image's size and format using
`glGetTexLevelParameter'.
"Specify a three-dimensional texture image in a compressed format.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_3D' or
+ Specifies the target texture. Must be `GL_TEXTURE_3D' or
`GL_PROXY_TEXTURE_3D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
Specifies the format of the compressed image data stored at address
WIDTH
Specifies the width of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^N+2\u2061(BORDER,) for some integer N . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^N+2\u2061(BORDER,) for some integer N . All
implementations support 3D texture images that are at least 16
texels wide.
HEIGHT
Specifies the height of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^N+2\u2061(BORDER,) for some integer N . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^N+2\u2061(BORDER,) for some integer N . All
implementations support 3D texture images that are at least 16
texels high.
DEPTH
Specifies the depth of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^N+2\u2061(BORDER,) for some integer N . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^N+2\u2061(BORDER,) for some integer N . All
implementations support 3D texture images that are at least 16
texels deep.
BORDER
- Specifies the width of the border. Must be either 0 or 1.
+ Specifies the width of the border. Must be either 0 or 1.
IMAGESIZE
Specifies the number of unsigned bytes of image data starting at
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call `glEnable' and `glDisable'
with argument `GL_TEXTURE_3D'.
If TARGET is `GL_PROXY_TEXTURE_3D', no data is read from DATA, 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
-`glGetError'). To query for an entire mipmap array, use an image array
-level greater than or equal to 1.
+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 `glGetError').
+To query for an entire mipmap array, use an image array level greater
+than or equal to 1.
INTERNALFORMAT must be an extension-specified compressed-texture format.
When a texture is loaded with `glTexImage2D' using a generic compressed
texture format (e.g., `GL_COMPRESSED_RGB'), the GL selects from one of
-its extensions supporting compressed textures. In order to load the
+its extensions supporting compressed textures. In order to load the
compressed texture image using `glCompressedTexImage3D', query the
compressed texture image's size and format using
`glGetTexLevelParameter'.
"Specify a one-dimensional texture subimage in a compressed format.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_1D'.
+ Specifies the target texture. Must be `GL_TEXTURE_1D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable one-dimensional texturing, call `glEnable' and `glDisable' with
argument `GL_TEXTURE_1D'.
`glCompressedTexSubImage1D' redefines a contiguous subregion of an
-existing one-dimensional texture image. The texels referenced by DATA
+existing one-dimensional texture image. The texels referenced by DATA
replace the portion of the existing texture array with x indices XOFFSET
-and XOFFSET+WIDTH-1 , inclusive. This region may not include any texels
+and XOFFSET+WIDTH-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.
-FORMAT must be an extension-specified compressed-texture format. The
+FORMAT must be an extension-specified compressed-texture format. The
FORMAT of the compressed texture image is selected by the GL
implementation that compressed it (see `glTexImage1D'), and should be
queried at the time the texture was compressed with
"Specify a two-dimensional texture subimage in a compressed format.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_2D',
+ Specifies the target texture. Must be `GL_TEXTURE_2D',
`GL_TEXTURE_CUBE_MAP_POSITIVE_X', `GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
`GL_TEXTURE_CUBE_MAP_POSITIVE_Y', `GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
`GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call `glEnable' and `glDisable' with
-argument `GL_TEXTURE_2D'. To enable and disable texturing using
+argument `GL_TEXTURE_2D'. To enable and disable texturing using
cube-mapped texture, call `glEnable' and `glDisable' with argument
`GL_TEXTURE_CUBE_MAP'.
`glCompressedTexSubImage2D' redefines a contiguous subregion of an
-existing two-dimensional texture image. The texels referenced by DATA
+existing two-dimensional texture image. The texels referenced by DATA
replace the portion of the existing texture array with x indices XOFFSET
and XOFFSET+WIDTH-1 , and the y indices YOFFSET and YOFFSET+HEIGHT-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
+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.
-FORMAT must be an extension-specified compressed-texture format. The
+FORMAT must be an extension-specified compressed-texture format. The
FORMAT of the compressed texture image is selected by the GL
implementation that compressed it (see `glTexImage2D') and should be
queried at the time the texture was compressed with
"Specify a three-dimensional texture subimage in a compressed format.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_3D'.
+ Specifies the target texture. Must be `GL_TEXTURE_3D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call `glEnable' and `glDisable'
with argument `GL_TEXTURE_3D'.
`glCompressedTexSubImage3D' redefines a contiguous subregion of an
-existing three-dimensional texture image. The texels referenced by DATA
+existing three-dimensional texture image. The texels referenced by DATA
replace the portion of the existing texture array with x indices XOFFSET
and XOFFSET+WIDTH-1 , and the y indices YOFFSET and YOFFSET+HEIGHT-1 ,
-and the z indices ZOFFSET and ZOFFSET+DEPTH-1 , inclusive. This region
+and the z indices ZOFFSET and ZOFFSET+DEPTH-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
+was originally specified. It is not an error to specify a subtexture
with width of 0, but such a specification has no effect.
-FORMAT must be an extension-specified compressed-texture format. The
+FORMAT must be an extension-specified compressed-texture format. The
FORMAT of the compressed texture image is selected by the GL
implementation that compressed it (see `glTexImage3D') and should be
queried at the time the texture was compressed with
Must be `GL_CONVOLUTION_1D'.
INTERNALFORMAT
- The internal format of the convolution filter kernel. The
- allowable values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8',
- `GL_ALPHA12', `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4',
- `GL_LUMINANCE8', `GL_LUMINANCE12', `GL_LUMINANCE16',
- `GL_LUMINANCE_ALPHA', `GL_LUMINANCE4_ALPHA4',
- `GL_LUMINANCE6_ALPHA2', `GL_LUMINANCE8_ALPHA8',
- `GL_LUMINANCE12_ALPHA4', `GL_LUMINANCE12_ALPHA12',
- `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY', `GL_INTENSITY4',
- `GL_INTENSITY8', `GL_INTENSITY12', `GL_INTENSITY16', `GL_R3_G3_B2',
- `GL_RGB', `GL_RGB4', `GL_RGB5', `GL_RGB8', `GL_RGB10', `GL_RGB12',
- `GL_RGB16', `GL_RGBA', `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1',
- `GL_RGBA8', `GL_RGB10_A2', `GL_RGBA12', or `GL_RGBA16'.
+ The internal format of the convolution filter kernel. The allowable
+ values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12',
+ `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4', `GL_LUMINANCE8',
+ `GL_LUMINANCE12', `GL_LUMINANCE16', `GL_LUMINANCE_ALPHA',
+ `GL_LUMINANCE4_ALPHA4', `GL_LUMINANCE6_ALPHA2',
+ `GL_LUMINANCE8_ALPHA8', `GL_LUMINANCE12_ALPHA4',
+ `GL_LUMINANCE12_ALPHA12', `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY',
+ `GL_INTENSITY4', `GL_INTENSITY8', `GL_INTENSITY12',
+ `GL_INTENSITY16', `GL_R3_G3_B2', `GL_RGB', `GL_RGB4', `GL_RGB5',
+ `GL_RGB8', `GL_RGB10', `GL_RGB12', `GL_RGB16', `GL_RGBA',
+ `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1', `GL_RGBA8', `GL_RGB10_A2',
+ `GL_RGBA12', or `GL_RGBA16'.
WIDTH
The width of the pixel array referenced by DATA.
FORMAT
- The format of the pixel data in DATA. The allowable values are
+ The format of the pixel data in DATA. The allowable values are
`GL_ALPHA', `GL_LUMINANCE', `GL_LUMINANCE_ALPHA', `GL_INTENSITY',
`GL_RGB', and `GL_RGBA'.
TYPE
- The type of the pixel data in DATA. Symbolic constants
+ The type of the pixel data in DATA. Symbolic constants
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
The R, G, B, and A components of each pixel are next scaled by the four
1D `GL_CONVOLUTION_FILTER_SCALE' parameters and biased by the four 1D
-`GL_CONVOLUTION_FILTER_BIAS' parameters. (The scale and bias parameters
+`GL_CONVOLUTION_FILTER_BIAS' parameters. (The scale and bias parameters
are set by `glConvolutionParameter' using the `GL_CONVOLUTION_1D' target
and the names `GL_CONVOLUTION_FILTER_SCALE' and
-`GL_CONVOLUTION_FILTER_BIAS'. The parameters themselves are vectors of
+`GL_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.
Each pixel is then converted to the internal format specified by
-INTERNALFORMAT. This conversion simply maps the component values of the
+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
+(red, green, blue, alpha, luminance, and intensity). The mapping is as
follows:
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
+format. They form a one-dimensional filter kernel image indexed with
coordinate I such that I starts at 0 and increases from left to right.
Kernel location I is derived from the Ith pixel, counting from 0.
components are also scaled by their corresponding
`GL_POST_CONVOLUTION_c_SCALE' parameters and biased by their
corresponding `GL_POST_CONVOLUTION_c_BIAS' parameters (where C takes on
-the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
+the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
set by `glPixelTransfer'.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_CONVOLUTION_1D'.
values.
`GL_INVALID_VALUE' is generated if WIDTH is less than zero or greater
-than the maximum supported value. This value may be queried with
+than the maximum supported value. This value may be queried with
`glGetConvolutionParameter' using target `GL_CONVOLUTION_1D' and name
`GL_MAX_CONVOLUTION_WIDTH'.
Must be `GL_CONVOLUTION_2D'.
INTERNALFORMAT
- The internal format of the convolution filter kernel. The
- allowable values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8',
- `GL_ALPHA12', `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4',
- `GL_LUMINANCE8', `GL_LUMINANCE12', `GL_LUMINANCE16',
- `GL_LUMINANCE_ALPHA', `GL_LUMINANCE4_ALPHA4',
- `GL_LUMINANCE6_ALPHA2', `GL_LUMINANCE8_ALPHA8',
- `GL_LUMINANCE12_ALPHA4', `GL_LUMINANCE12_ALPHA12',
- `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY', `GL_INTENSITY4',
- `GL_INTENSITY8', `GL_INTENSITY12', `GL_INTENSITY16', `GL_R3_G3_B2',
- `GL_RGB', `GL_RGB4', `GL_RGB5', `GL_RGB8', `GL_RGB10', `GL_RGB12',
- `GL_RGB16', `GL_RGBA', `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1',
- `GL_RGBA8', `GL_RGB10_A2', `GL_RGBA12', or `GL_RGBA16'.
+ The internal format of the convolution filter kernel. The allowable
+ values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12',
+ `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4', `GL_LUMINANCE8',
+ `GL_LUMINANCE12', `GL_LUMINANCE16', `GL_LUMINANCE_ALPHA',
+ `GL_LUMINANCE4_ALPHA4', `GL_LUMINANCE6_ALPHA2',
+ `GL_LUMINANCE8_ALPHA8', `GL_LUMINANCE12_ALPHA4',
+ `GL_LUMINANCE12_ALPHA12', `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY',
+ `GL_INTENSITY4', `GL_INTENSITY8', `GL_INTENSITY12',
+ `GL_INTENSITY16', `GL_R3_G3_B2', `GL_RGB', `GL_RGB4', `GL_RGB5',
+ `GL_RGB8', `GL_RGB10', `GL_RGB12', `GL_RGB16', `GL_RGBA',
+ `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1', `GL_RGBA8', `GL_RGB10_A2',
+ `GL_RGBA12', or `GL_RGBA16'.
WIDTH
The width of the pixel array referenced by DATA.
The height of the pixel array referenced by DATA.
FORMAT
- The format of the pixel data in DATA. The allowable values are
+ The format of the pixel data in DATA. The allowable values are
`GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR',
`GL_RGBA', `GL_BGRA', `GL_LUMINANCE', and `GL_LUMINANCE_ALPHA'.
TYPE
- The type of the pixel data in DATA. Symbolic constants
+ The type of the pixel data in DATA. Symbolic constants
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
The R, G, B, and A components of each pixel are next scaled by the four
2D `GL_CONVOLUTION_FILTER_SCALE' parameters and biased by the four 2D
-`GL_CONVOLUTION_FILTER_BIAS' parameters. (The scale and bias parameters
+`GL_CONVOLUTION_FILTER_BIAS' parameters. (The scale and bias parameters
are set by `glConvolutionParameter' using the `GL_CONVOLUTION_2D' target
and the names `GL_CONVOLUTION_FILTER_SCALE' and
-`GL_CONVOLUTION_FILTER_BIAS'. The parameters themselves are vectors of
+`GL_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.
Each pixel is then converted to the internal format specified by
-INTERNALFORMAT. This conversion simply maps the component values of the
+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
+(red, green, blue, alpha, luminance, and intensity). The mapping is as
follows:
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
+format. They form a two-dimensional filter kernel image indexed with
coordinates I and J such that I starts at zero and increases from left
-to right, and J starts at zero and increases from bottom to top. Kernel
+to right, and J starts at zero and increases from bottom to top. Kernel
location I,J is derived from the Nth pixel, where N is I+J*WIDTH.
Note that after a convolution is performed, the resulting color
components are also scaled by their corresponding
`GL_POST_CONVOLUTION_c_SCALE' parameters and biased by their
corresponding `GL_POST_CONVOLUTION_c_BIAS' parameters (where C takes on
-the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
+the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
set by `glPixelTransfer'.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_CONVOLUTION_2D'.
values.
`GL_INVALID_VALUE' is generated if WIDTH is less than zero or greater
-than the maximum supported value. This value may be queried with
+than the maximum supported value. This value may be queried with
`glGetConvolutionParameter' using target `GL_CONVOLUTION_2D' and name
`GL_MAX_CONVOLUTION_WIDTH'.
`GL_INVALID_VALUE' is generated if HEIGHT is less than zero or greater
-than the maximum supported value. This value may be queried with
+than the maximum supported value. This value may be queried with
`glGetConvolutionParameter' using target `GL_CONVOLUTION_2D' and name
`GL_MAX_CONVOLUTION_HEIGHT'.
"Set convolution parameters.
TARGET
- The target for the convolution parameter. Must be one of
+ The target for the convolution parameter. Must be one of
`GL_CONVOLUTION_1D', `GL_CONVOLUTION_2D', or `GL_SEPARABLE_2D'.
PNAME
- The parameter to be set. Must be `GL_CONVOLUTION_BORDER_MODE'.
+ The parameter to be set. Must be `GL_CONVOLUTION_BORDER_MODE'.
PARAMS
- The parameter value. Must be one of `GL_REDUCE',
+ The parameter value. Must be one of `GL_REDUCE',
`GL_CONSTANT_BORDER', `GL_REPLICATE_BORDER'.
`GL_CONVOLUTION_1D', `GL_CONVOLUTION_2D', or `GL_SEPARABLE_2D' for the
1D, 2D, or separable 2D filter, respectively.
-PNAME selects the parameter to be changed. `GL_CONVOLUTION_FILTER_SCALE'
+PNAME selects the parameter to be changed. `GL_CONVOLUTION_FILTER_SCALE'
and `GL_CONVOLUTION_FILTER_BIAS' affect the definition of the
convolution filter kernel; see `glConvolutionFilter1D',
-`glConvolutionFilter2D', and `glSeparableFilter2D' for details. In
-these cases, PARAMSv is an array of four values to be applied to red,
-green, blue, and alpha values, respectively. The initial value for
+`glConvolutionFilter2D', and `glSeparableFilter2D' for details. In these
+cases, PARAMSv is an array of four values to be applied to red, green,
+blue, and alpha values, respectively. The initial value for
`GL_CONVOLUTION_FILTER_SCALE' is (1, 1, 1, 1), and the initial value for
`GL_CONVOLUTION_FILTER_BIAS' is (0, 0, 0, 0).
A PNAME value of `GL_CONVOLUTION_BORDER_MODE' controls the convolution
-border mode. The accepted modes are:
+border mode. The accepted modes are:
`GL_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. 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
+ 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
The number of table entries to replace.
`glCopyColorSubTable' is used to respecify a contiguous portion of a
-color table previously defined using `glColorTable'. The pixels copied
+color table previously defined using `glColorTable'. The pixels copied
from the framebuffer replace the portion of the existing table from
-indices START to START+X-1 , inclusive. This region may not include any
+indices START to START+X-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,
+specified. It is not an error to specify a subtexture with width of 0,
but such a specification has no effect.
`GL_INVALID_VALUE' is generated if TARGET is not a previously defined
"Copy pixels into a color table.
TARGET
- The color table target. Must be `GL_COLOR_TABLE',
+ The color table target. Must be `GL_COLOR_TABLE',
`GL_POST_CONVOLUTION_COLOR_TABLE', or
`GL_POST_COLOR_MATRIX_COLOR_TABLE'.
INTERNALFORMAT
- The internal storage format of the texture image. Must be one of
+ The internal storage format of the texture image. Must be one of
the following symbolic constants: `GL_ALPHA', `GL_ALPHA4',
`GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16', `GL_LUMINANCE',
`GL_LUMINANCE4', `GL_LUMINANCE8', `GL_LUMINANCE12',
`glColorTable').
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
+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.
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
+components of each pixel. The scale and bias parameters are set by
calling `glColorTableParameter'.
-Next, the R, G, B, and A values are clamped to the range [0,1] . Each
+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
+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
+(red, green, blue, alpha, luminance, and intensity). The mapping is as
follows:
R , G , B , A , ,
Finally, the red, green, blue, alpha, luminance, and/or intensity
-components of the resulting pixels are stored in the color table. They
+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] .
Must be `GL_CONVOLUTION_1D'.
INTERNALFORMAT
- The internal format of the convolution filter kernel. The
- allowable values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8',
- `GL_ALPHA12', `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4',
- `GL_LUMINANCE8', `GL_LUMINANCE12', `GL_LUMINANCE16',
- `GL_LUMINANCE_ALPHA', `GL_LUMINANCE4_ALPHA4',
- `GL_LUMINANCE6_ALPHA2', `GL_LUMINANCE8_ALPHA8',
- `GL_LUMINANCE12_ALPHA4', `GL_LUMINANCE12_ALPHA12',
- `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY', `GL_INTENSITY4',
- `GL_INTENSITY8', `GL_INTENSITY12', `GL_INTENSITY16', `GL_R3_G3_B2',
- `GL_RGB', `GL_RGB4', `GL_RGB5', `GL_RGB8', `GL_RGB10', `GL_RGB12',
- `GL_RGB16', `GL_RGBA', `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1',
- `GL_RGBA8', `GL_RGB10_A2', `GL_RGBA12', or `GL_RGBA16'.
+ The internal format of the convolution filter kernel. The allowable
+ values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12',
+ `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4', `GL_LUMINANCE8',
+ `GL_LUMINANCE12', `GL_LUMINANCE16', `GL_LUMINANCE_ALPHA',
+ `GL_LUMINANCE4_ALPHA4', `GL_LUMINANCE6_ALPHA2',
+ `GL_LUMINANCE8_ALPHA8', `GL_LUMINANCE12_ALPHA4',
+ `GL_LUMINANCE12_ALPHA12', `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY',
+ `GL_INTENSITY4', `GL_INTENSITY8', `GL_INTENSITY12',
+ `GL_INTENSITY16', `GL_R3_G3_B2', `GL_RGB', `GL_RGB4', `GL_RGB5',
+ `GL_RGB8', `GL_RGB10', `GL_RGB12', `GL_RGB16', `GL_RGBA',
+ `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1', `GL_RGBA8', `GL_RGB10_A2',
+ `GL_RGBA12', or `GL_RGBA16'.
X
Y
main memory, as is the case for `glConvolutionFilter1D').
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
+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.
The pixels in the rectangle are processed exactly as if `glReadPixels'
had been called with FORMAT 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 `GL_CONVOLUTION_FILTER_SCALE' parameters
-and biased by the four 1D `GL_CONVOLUTION_FILTER_BIAS' parameters. (The
+before final conversion. The R, G, B, and A components of each pixel are
+next scaled by the four 1D `GL_CONVOLUTION_FILTER_SCALE' parameters and
+biased by the four 1D `GL_CONVOLUTION_FILTER_BIAS' parameters. (The
scale and bias parameters are set by `glConvolutionParameter' using the
`GL_CONVOLUTION_1D' target and the names `GL_CONVOLUTION_FILTER_SCALE'
-and `GL_CONVOLUTION_FILTER_BIAS'. The parameters themselves are vectors
+and `GL_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.
Each pixel is then converted to the internal format specified by
-INTERNALFORMAT. This conversion simply maps the component values of the
+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
+(red, green, blue, alpha, luminance, and intensity). The mapping is as
follows:
components are also scaled by their corresponding
`GL_POST_CONVOLUTION_c_SCALE' parameters and biased by their
corresponding `GL_POST_CONVOLUTION_c_BIAS' parameters (where C takes on
-the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
+the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
set by `glPixelTransfer'.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_CONVOLUTION_1D'.
allowable values.
`GL_INVALID_VALUE' is generated if WIDTH is less than zero or greater
-than the maximum supported value. This value may be queried with
+than the maximum supported value. This value may be queried with
`glGetConvolutionParameter' using target `GL_CONVOLUTION_1D' and name
`GL_MAX_CONVOLUTION_WIDTH'.
Must be `GL_CONVOLUTION_2D'.
INTERNALFORMAT
- The internal format of the convolution filter kernel. The
- allowable values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8',
- `GL_ALPHA12', `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4',
- `GL_LUMINANCE8', `GL_LUMINANCE12', `GL_LUMINANCE16',
- `GL_LUMINANCE_ALPHA', `GL_LUMINANCE4_ALPHA4',
- `GL_LUMINANCE6_ALPHA2', `GL_LUMINANCE8_ALPHA8',
- `GL_LUMINANCE12_ALPHA4', `GL_LUMINANCE12_ALPHA12',
- `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY', `GL_INTENSITY4',
- `GL_INTENSITY8', `GL_INTENSITY12', `GL_INTENSITY16', `GL_R3_G3_B2',
- `GL_RGB', `GL_RGB4', `GL_RGB5', `GL_RGB8', `GL_RGB10', `GL_RGB12',
- `GL_RGB16', `GL_RGBA', `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1',
- `GL_RGBA8', `GL_RGB10_A2', `GL_RGBA12', or `GL_RGBA16'.
+ The internal format of the convolution filter kernel. The allowable
+ values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12',
+ `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4', `GL_LUMINANCE8',
+ `GL_LUMINANCE12', `GL_LUMINANCE16', `GL_LUMINANCE_ALPHA',
+ `GL_LUMINANCE4_ALPHA4', `GL_LUMINANCE6_ALPHA2',
+ `GL_LUMINANCE8_ALPHA8', `GL_LUMINANCE12_ALPHA4',
+ `GL_LUMINANCE12_ALPHA12', `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY',
+ `GL_INTENSITY4', `GL_INTENSITY8', `GL_INTENSITY12',
+ `GL_INTENSITY16', `GL_R3_G3_B2', `GL_RGB', `GL_RGB4', `GL_RGB5',
+ `GL_RGB8', `GL_RGB10', `GL_RGB12', `GL_RGB16', `GL_RGBA',
+ `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1', `GL_RGBA8', `GL_RGB10_A2',
+ `GL_RGBA12', or `GL_RGBA16'.
X
Y
The pixels in the rectangle are processed exactly as if `glReadPixels'
had been called with FORMAT 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 `GL_CONVOLUTION_FILTER_SCALE' parameters
-and biased by the four 2D `GL_CONVOLUTION_FILTER_BIAS' parameters. (The
+before final conversion. The R, G, B, and A components of each pixel are
+next scaled by the four 2D `GL_CONVOLUTION_FILTER_SCALE' parameters and
+biased by the four 2D `GL_CONVOLUTION_FILTER_BIAS' parameters. (The
scale and bias parameters are set by `glConvolutionParameter' using the
`GL_CONVOLUTION_2D' target and the names `GL_CONVOLUTION_FILTER_SCALE'
-and `GL_CONVOLUTION_FILTER_BIAS'. The parameters themselves are vectors
+and `GL_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.
Each pixel is then converted to the internal format specified by
-INTERNALFORMAT. This conversion simply maps the component values of the
+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
+(red, green, blue, alpha, luminance, and intensity). The mapping is as
follows:
components are also scaled by their corresponding
`GL_POST_CONVOLUTION_c_SCALE' parameters and biased by their
corresponding `GL_POST_CONVOLUTION_c_BIAS' parameters (where C takes on
-the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
+the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
set by `glPixelTransfer'.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_CONVOLUTION_2D'.
allowable values.
`GL_INVALID_VALUE' is generated if WIDTH is less than zero or greater
-than the maximum supported value. This value may be queried with
+than the maximum supported value. This value may be queried with
`glGetConvolutionParameter' using target `GL_CONVOLUTION_2D' and name
`GL_MAX_CONVOLUTION_WIDTH'.
`GL_INVALID_VALUE' is generated if HEIGHT is less than zero or greater
-than the maximum supported value. This value may be queried with
+than the maximum supported value. This value may be queried with
`glGetConvolutionParameter' using target `GL_CONVOLUTION_2D' and name
`GL_MAX_CONVOLUTION_HEIGHT'.
HEIGHT
Specify the dimensions of the rectangular region of pixels to be
- copied. Both must be nonnegative.
+ copied. Both must be nonnegative.
TYPE
Specifies whether color values, depth values, or stencil values are
- to be copied. Symbolic constants `GL_COLOR', `GL_DEPTH', and
+ to be copied. Symbolic constants `GL_COLOR', `GL_DEPTH', and
`GL_STENCIL' are accepted.
`glCopyPixels' 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
+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.
X and Y specify the window coordinates of the lower left corner of the
-rectangular region to be copied. WIDTH and HEIGHT specify the
-dimensions of the rectangular region to be copied. Both WIDTH and
-HEIGHT must not be negative.
+rectangular region to be copied. WIDTH and HEIGHT specify the dimensions
+of the rectangular region to be copied. Both WIDTH and HEIGHT must not
+be negative.
Several parameters control the processing of the pixel data while it is
-being copied. These parameters are set with three commands:
-`glPixelTransfer', `glPixelMap', and `glPixelZoom'. This reference page
+being copied. These parameters are set with three commands:
+`glPixelTransfer', `glPixelMap', and `glPixelZoom'. This reference page
describes the effects on `glCopyPixels' of most, but not all, of the
parameters specified by these three commands.
`glCopyPixels' copies values from each pixel with the lower left-hand
-corner at (X+I,Y+J) for 0<=I<WIDTH and 0<=J<HEIGHT . This pixel is said
-to be the I th pixel in the J th row. Pixels are copied in row order
+corner at (X+I,Y+J) for 0<=I<WIDTH and 0<=J<HEIGHT . 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.
TYPE specifies whether color, depth, or stencil data is to be copied.
`GL_COLOR'
Indices or RGBA colors are read from the buffer currently specified
- as the read source buffer (see `glReadBuffer'). If the GL is in
+ as the read source buffer (see `glReadBuffer'). 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 `GL_INDEX_SHIFT' bits, and added to `GL_INDEX_OFFSET'. If
- `GL_INDEX_SHIFT' is negative, the shift is to the right. In either
+ bits to the right of the binary point. Each index is then shifted
+ left by `GL_INDEX_SHIFT' bits, and added to `GL_INDEX_OFFSET'. If
+ `GL_INDEX_SHIFT' is negative, the shift is to the right. In either
case, zero bits fill otherwise unspecified bit locations in the
- result. If `GL_MAP_COLOR' is true, the index is replaced with the
+ result. If `GL_MAP_COLOR' is true, the index is replaced with the
value that it references in lookup table `GL_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^B-1 , where B is the
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
+ 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 `GL_c_SCALE' and added to
- `GL_c_BIAS', where C is RED, GREEN, BLUE, and ALPHA for the
- respective color components. The results are clamped to the range
- [0,1]. If `GL_MAP_COLOR' is true, each color component is scaled
- by the size of lookup table `GL_PIXEL_MAP_c_TO_c', then replaced by
- the value that it references in that table. C is R, G, B, or A.
+ component value 0 to 0.0. The resulting floating-point color values
+ are then multiplied by `GL_c_SCALE' and added to `GL_c_BIAS', where
+ C is RED, GREEN, BLUE, and ALPHA for the respective color
+ components. The results are clamped to the range [0,1]. If
+ `GL_MAP_COLOR' is true, each color component is scaled by the size
+ of lookup table `GL_PIXEL_MAP_c_TO_c', then replaced by the value
+ that it references in that table. C is R, G, B, or A.
If the `ARB_imaging' extension is supported, the color values may
be additionally processed by color-table lookups, color-matrix
fragments by attaching the current raster position Z coordinate and
texture coordinates to each pixel, then assigning window
coordinates (X_R+I,Y_R+J) , where (X_R,Y_R) is the current raster
- position, and the pixel was the I th pixel in the J th row. These
+ 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,
+ 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.
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
- `GL_DEPTH_SCALE' and added to `GL_DEPTH_BIAS'. The result is
+ `GL_DEPTH_SCALE' and added to `GL_DEPTH_BIAS'. The result is
clamped to the range [0,1].
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_R+I,Y_R+J) , where (X_R,Y_R) is the current raster
- position, and the pixel was the I th pixel in the J th row. These
+ 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,
+ 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.
`GL_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
+ to the right of the binary point. Each fixed-point index is then
shifted left by `GL_INDEX_SHIFT' bits, and added to
- `GL_INDEX_OFFSET'. If `GL_INDEX_SHIFT' is negative, the shift is
- to the right. In either case, zero bits fill otherwise unspecified
- bit locations in the result. If `GL_MAP_STENCIL' is true, the
- index is replaced with the value that it references in lookup table
- `GL_PIXEL_MAP_S_TO_S'. Whether the lookup replacement of the index
+ `GL_INDEX_OFFSET'. If `GL_INDEX_SHIFT' is negative, the shift is to
+ the right. In either case, zero bits fill otherwise unspecified bit
+ locations in the result. If `GL_MAP_STENCIL' is true, the index is
+ replaced with the value that it references in lookup table
+ `GL_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^B-1 , where B is the number of bits in the stencil buffer. The
+ 2^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_R+I,Y_R+J) , where (X_R,Y_R) is the current
- raster position. Only the pixel ownership test, the scissor test,
+ raster position. Only the pixel ownership test, the scissor test,
and the stencil writemask affect these write operations.
The rasterization described thus far assumes pixel zoom factors of 1.0.
If `glPixelZoom' is used to change the X and Y pixel zoom factors,
-pixels are converted to fragments as follows. If (X_R,Y_R) is the
+pixels are converted to fragments as follows. If (X_R,Y_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
"Copy pixels into a 1D texture image.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_1D'.
+ Specifies the target texture. Must be `GL_TEXTURE_1D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
- Specifies the internal format of the texture. Must be one of the
+ Specifies the internal format of the texture. Must be one of the
following symbolic constants: `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8',
`GL_ALPHA12', `GL_ALPHA16', `GL_COMPRESSED_ALPHA',
`GL_COMPRESSED_LUMINANCE', `GL_COMPRESSED_LUMINANCE_ALPHA',
pixels to be copied.
WIDTH
- Specifies the width of the texture image. Must be 0 or
- 2^N+2\u2061(BORDER,) for some integer N . The height of the texture
+ Specifies the width of the texture image. Must be 0 or
+ 2^N+2\u2061(BORDER,) for some integer N . The height of the texture
image is 1.
BORDER
- Specifies the width of the border. Must be either 0 or 1.
+ Specifies the width of the border. Must be either 0 or 1.
`glCopyTexImage1D' defines a one-dimensional texture image with pixels
from the current `GL_READ_BUFFER'.
The screen-aligned pixel row with left corner at (X,Y) and with a length
of WIDTH+2\u2061(BORDER,) defines the texture array at the mipmap level
-specified by LEVEL. INTERNALFORMAT specifies the internal format of the
+specified by LEVEL. INTERNALFORMAT specifies the internal format of the
texture array.
The pixels in the row are processed exactly as if `glCopyPixels' 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
+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.
Pixel ordering is such that lower X screen coordinates correspond to
from the current `GL_READ_BUFFER'.
When INTERNALFORMAT is one of the sRGB types, the GL does not
-automatically convert the source pixels to the sRGB color space. In
-this case, the `glPixelMap' function can be used to accomplish the
+automatically convert the source pixels to the sRGB color space. In this
+case, the `glPixelMap' function can be used to accomplish the
conversion.
`GL_INVALID_ENUM' is generated if TARGET is not one of the allowable
"Copy pixels into a 2D texture image.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_2D',
+ Specifies the target texture. Must be `GL_TEXTURE_2D',
`GL_TEXTURE_CUBE_MAP_POSITIVE_X', `GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
`GL_TEXTURE_CUBE_MAP_POSITIVE_Y', `GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
`GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
- Specifies the internal format of the texture. Must be one of the
+ Specifies the internal format of the texture. Must be one of the
following symbolic constants: `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8',
`GL_ALPHA12', `GL_ALPHA16', `GL_COMPRESSED_ALPHA',
`GL_COMPRESSED_LUMINANCE', `GL_COMPRESSED_LUMINANCE_ALPHA',
rectangular region of pixels to be copied.
WIDTH
- Specifies the width of the texture image. Must be 0 or
+ Specifies the width of the texture image. Must be 0 or
2^N+2\u2061(BORDER,) for some integer N .
HEIGHT
- Specifies the height of the texture image. Must be 0 or
+ Specifies the height of the texture image. Must be 0 or
2^M+2\u2061(BORDER,) for some integer M .
BORDER
- Specifies the width of the border. Must be either 0 or 1.
+ Specifies the width of the border. Must be either 0 or 1.
`glCopyTexImage2D' defines a two-dimensional texture image, or cube-map
texture image with pixels from the current `GL_READ_BUFFER'.
INTERNALFORMAT specifies the internal format of the texture array.
The pixels in the rectangle are processed exactly as if `glCopyPixels'
-had been called, but the process stops just before final conversion. At
+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.
undefined.
When INTERNALFORMAT is one of the sRGB types, the GL does not
-automatically convert the source pixels to the sRGB color space. In
-this case, the `glPixelMap' function can be used to accomplish the
+automatically convert the source pixels to the sRGB color space. In this
+case, the `glPixelMap' function can be used to accomplish the
conversion.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_TEXTURE_2D',
"Copy a one-dimensional texture subimage.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_1D'.
+ Specifies the target texture. Must be `GL_TEXTURE_1D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies the texel offset within the texture array.
The screen-aligned pixel row with left corner at (X,\\ Y), and with
length WIDTH replaces the portion of the texture array with x indices
-XOFFSET through XOFFSET+WIDTH-1 , inclusive. The destination in the
+XOFFSET through XOFFSET+WIDTH-1 , inclusive. The destination in the
texture array may not include any texels outside the texture array as it
was originally specified.
The pixels in the row are processed exactly as if `glCopyPixels' 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.
+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.
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
+specification has no effect. If any of the pixels within the specified
row of the current `GL_READ_BUFFER' are outside the read window
associated with the current rendering context, then the values obtained
for those pixels are undefined.
`GL_INVALID_VALUE' is generated if XOFFSET<-B , or
(XOFFSET+WIDTH,)>(W-B,) , where W is the `GL_TEXTURE_WIDTH' and B is the
-`GL_TEXTURE_BORDER' of the texture image being modified. Note that W
+`GL_TEXTURE_BORDER' of the texture image being modified. Note that W
includes twice the border width.")
(define-gl-procedures
"Copy a two-dimensional texture subimage.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_2D',
+ Specifies the target texture. Must be `GL_TEXTURE_2D',
`GL_TEXTURE_CUBE_MAP_POSITIVE_X', `GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
`GL_TEXTURE_CUBE_MAP_POSITIVE_Y', `GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
`GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
level specified by LEVEL.
The pixels in the rectangle are processed exactly as if `glCopyPixels'
-had been called, but the process stops just before final conversion. At
+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.
The destination rectangle in the texture array may not include any
-texels outside the texture array as it was originally specified. It is
+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.
`GL_INVALID_VALUE' is generated if XOFFSET<-B , (XOFFSET+WIDTH,)>(W-B,)
, YOFFSET<-B , or (YOFFSET+HEIGHT,)>(H-B,) , where W is the
`GL_TEXTURE_WIDTH', H is the `GL_TEXTURE_HEIGHT', and B is the
-`GL_TEXTURE_BORDER' of the texture image being modified. Note that W
-and H include twice the border width.
+`GL_TEXTURE_BORDER' of the texture image being modified. Note that W and
+H include twice the border width.
`GL_INVALID_OPERATION' is generated if `glCopyTexSubImage2D' is executed
between the execution of `glBegin' and the corresponding execution of
"Copy a three-dimensional texture subimage.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_3D'
+ Specifies the target texture. Must be `GL_TEXTURE_3D'
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
and at the mipmap level specified by LEVEL.
The pixels in the rectangle are processed exactly as if `glCopyPixels'
-had been called, but the process stops just before final conversion. At
+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.
The destination rectangle in the texture array may not include any
-texels outside the texture array as it was originally specified. It is
+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.
, YOFFSET<-B , (YOFFSET+HEIGHT,)>(H-B,) , ZOFFSET<-B , or
(ZOFFSET+1,)>(D-B,) , where W is the `GL_TEXTURE_WIDTH', H is the
`GL_TEXTURE_HEIGHT', D is the `GL_TEXTURE_DEPTH', and B is the
-`GL_TEXTURE_BORDER' of the texture image being modified. Note that W ,
-H , and D include twice the border width.
+`GL_TEXTURE_BORDER' of the texture image being modified. Note that W , H
+, and D include twice the border width.
`GL_INVALID_OPERATION' is generated if `glCopyTexSubImage3D' is executed
between the execution of `glBegin' and the corresponding execution of
"Creates a program object.
`glCreateProgram' creates an empty program object and returns a non-zero
-value by which it can be referenced. A program object is an object to
-which shader objects can be attached. This provides a mechanism to
-specify the shader objects that will be linked to create a program. It
+value by which it can be referenced. A program object is an object to
+which shader objects can be attached. This provides a mechanism to
+specify the shader objects that will be linked to create a program. It
also provides a means for checking the compatibility of the shaders that
will be used to create a program (for instance, checking the
-compatibility between a vertex shader and a fragment shader). When no
+compatibility between a vertex shader and a fragment shader). When no
longer needed as part of a program object, shader objects can be
detached.
One or more executables are created in a program object by successfully
attaching shader objects to it with `glAttachShader', successfully
compiling the shader objects with `glCompileShader', and successfully
-linking the program object with `glLinkProgram'. These executables are
-made part of current state when `glUseProgram' is called. Program
-objects can be deleted by calling `glDeleteProgram'. The memory
+linking the program object with `glLinkProgram'. These executables are
+made part of current state when `glUseProgram' is called. Program
+objects can be deleted by calling `glDeleteProgram'. The memory
associated with the program object will be deleted when it is no longer
part of current rendering state for any context.
"Creates a shader object.
SHADERTYPE
- Specifies the type of shader to be created. Must be either
+ Specifies the type of shader to be created. Must be either
`GL_VERTEX_SHADER' or `GL_FRAGMENT_SHADER'.
`glCreateShader' creates an empty shader object and returns a non-zero
-value by which it can be referenced. A shader object is used to
-maintain the source code strings that define a shader. SHADERTYPE
-indicates the type of shader to be created. Two types of shaders are
-supported. A shader of type `GL_VERTEX_SHADER' is a shader that is
-intended to run on the programmable vertex processor and replace the
-fixed functionality vertex processing in OpenGL. A shader of type
-`GL_FRAGMENT_SHADER' is a shader that is intended to run on the
-programmable fragment processor and replace the fixed functionality
-fragment processing in OpenGL.
+value by which it can be referenced. A shader object is used to maintain
+the source code strings that define a shader. SHADERTYPE indicates the
+type of shader to be created. Two types of shaders are supported. A
+shader of type `GL_VERTEX_SHADER' is a shader that is intended to run on
+the programmable vertex processor and replace the fixed functionality
+vertex processing in OpenGL. A shader of type `GL_FRAGMENT_SHADER' is a
+shader that is intended to run on the programmable fragment processor
+and replace the fixed functionality fragment processing in OpenGL.
When created, a shader object's `GL_SHADER_TYPE' parameter is set to
either `GL_VERTEX_SHADER' or `GL_FRAGMENT_SHADER', depending on the
MODE
Specifies whether front- or back-facing facets are candidates for
- culling. Symbolic constants `GL_FRONT', `GL_BACK', and
- `GL_FRONT_AND_BACK' are accepted. The initial value is `GL_BACK'.
+ culling. Symbolic constants `GL_FRONT', `GL_BACK', and
+ `GL_FRONT_AND_BACK' are accepted. The initial value is `GL_BACK'.
`glCullFace' specifies whether front- or back-facing facets are culled
-(as specified by MODE) when facet culling is enabled. Facet culling is
-initially disabled. To enable and disable facet culling, call the
+(as specified by MODE) when facet culling is enabled. Facet culling is
+initially disabled. To enable and disable facet culling, call the
`glEnable' and `glDisable' commands with the argument `GL_CULL_FACE'.
Facets include triangles, quadrilaterals, polygons, and rectangles.
`glFrontFace' specifies which of the clockwise and counterclockwise
-facets are front-facing and back-facing. See `glFrontFace'.
+facets are front-facing and back-facing. See `glFrontFace'.
`GL_INVALID_ENUM' is generated if MODE is not an accepted value.
Specifies an array of buffer objects to be deleted.
`glDeleteBuffers' deletes N buffer objects named by the elements of the
-array BUFFERS. After a buffer object is deleted, it has no contents,
-and its name is free for reuse (for example by `glGenBuffers'). If a
-buffer object that is currently bound is deleted, the binding reverts to
-0 (the absence of any buffer object, which reverts to client memory
-usage).
+array BUFFERS. After a buffer object is deleted, it has no contents, and
+its name is free for reuse (for example by `glGenBuffers'). If a buffer
+object that is currently bound is deleted, the binding reverts to 0 (the
+absence of any buffer object, which reverts to client memory usage).
`glDeleteBuffers' silently ignores 0's and names that do not correspond
to existing buffer objects.
Specifies the number of display lists to delete.
`glDeleteLists' causes a contiguous group of display lists to be
-deleted. LIST is the name of the first display list to be deleted, and
-RANGE is the number of display lists to delete. All display lists D
-with LIST<=D<=LIST+RANGE-1 are deleted.
+deleted. LIST is the name of the first display list to be deleted, and
+RANGE is the number of display lists to delete. All display lists D with
+LIST<=D<=LIST+RANGE-1 are deleted.
All storage locations allocated to the specified display lists are
-freed, and the names are available for reuse at a later time. Names
+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 RANGE is 0, nothing happens.
+ignored. If RANGE is 0, nothing happens.
`GL_INVALID_VALUE' is generated if RANGE is negative.
Specifies the program object to be deleted.
`glDeleteProgram' frees the memory and invalidates the name associated
-with the program object specified by PROGRAM. This command effectively
+with the program object specified by PROGRAM. This command effectively
undoes the effects of a call to `glCreateProgram'.
If a program object is in use as part of current rendering state, it
will be flagged for deletion, but it will not be deleted until it is no
-longer part of current state for any rendering context. If a program
+longer part of current state for any rendering context. If a program
object to be deleted has shader objects attached to it, those shader
objects will be automatically detached but not deleted unless they have
already been flagged for deletion by a previous call to
-`glDeleteShader'. A value of 0 for PROGRAM will be silently ignored.
+`glDeleteShader'. A value of 0 for PROGRAM will be silently ignored.
To determine whether a program object has been flagged for deletion,
call `glGetProgram' with arguments PROGRAM and `GL_DELETE_STATUS'.
Specifies an array of query objects to be deleted.
`glDeleteQueries' deletes N query objects named by the elements of the
-array IDS. After a query object is deleted, it has no contents, and its
+array IDS. After a query object is deleted, it has no contents, and its
name is free for reuse (for example by `glGenQueries').
`glDeleteQueries' silently ignores 0's and names that do not correspond
Specifies the shader object to be deleted.
`glDeleteShader' frees the memory and invalidates the name associated
-with the shader object specified by SHADER. This command effectively
+with the shader object specified by SHADER. This command effectively
undoes the effects of a call to `glCreateShader'.
If a shader object to be deleted is attached to a program object, it
will be flagged for deletion, but it will not be deleted until it is no
longer attached to any program object, for any rendering context (i.e.,
it must be detached from wherever it was attached before it will be
-deleted). A value of 0 for SHADER will be silently ignored.
+deleted). A value of 0 for SHADER will be silently ignored.
To determine whether an object has been flagged for deletion, call
`glGetShader' with arguments SHADER and `GL_DELETE_STATUS'.
Specifies an array of textures to be deleted.
`glDeleteTextures' deletes N textures named by the elements of the array
-TEXTURES. After a texture is deleted, it has no contents or
+TEXTURES. After a texture is deleted, it has no contents or
dimensionality, and its name is free for reuse (for example by
-`glGenTextures'). If a texture that is currently bound is deleted, the
+`glGenTextures'). If a texture that is currently bound is deleted, the
binding reverts to 0 (the default texture).
`glDeleteTextures' silently ignores 0's and names that do not correspond
"Specify the value used for depth buffer comparisons.
FUNC
- Specifies the depth comparison function. Symbolic constants
+ Specifies the depth comparison function. Symbolic constants
`GL_NEVER', `GL_LESS', `GL_EQUAL', `GL_LEQUAL', `GL_GREATER',
- `GL_NOTEQUAL', `GL_GEQUAL', and `GL_ALWAYS' are accepted. The
+ `GL_NOTEQUAL', `GL_GEQUAL', and `GL_ALWAYS' are accepted. The
initial value is `GL_LESS'.
`glDepthFunc' 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
+depth value with the depth value present in the depth buffer. The
+comparison is performed only if depth testing is enabled. (See
`glEnable' and `glDisable' of `GL_DEPTH_TEST'.)
-FUNC specifies the conditions under which the pixel will be drawn. The
+FUNC specifies the conditions under which the pixel will be drawn. The
comparison functions are as follows:
`GL_NEVER'
`GL_ALWAYS'
Always passes.
-The initial value of FUNC is `GL_LESS'. Initially, depth testing is
-disabled. If depth testing is disabled or if no depth buffer exists, it
+The initial value of FUNC is `GL_LESS'. Initially, depth testing is
+disabled. If depth testing is disabled or if no depth buffer exists, it
is as if the depth test always passes.
`GL_INVALID_ENUM' is generated if FUNC is not an accepted value.
"Enable or disable writing into the depth buffer.
FLAG
- Specifies whether the depth buffer is enabled for writing. If FLAG
- is `GL_FALSE', depth buffer writing is disabled. Otherwise, it is
- enabled. Initially, depth buffer writing is enabled.
+ Specifies whether the depth buffer is enabled for writing. If FLAG
+ is `GL_FALSE', depth buffer writing is disabled. Otherwise, it is
+ enabled. Initially, depth buffer writing is enabled.
`glDepthMask' specifies whether the depth buffer is enabled for writing.
-If FLAG is `GL_FALSE', depth buffer writing is disabled. Otherwise, it
-is enabled. Initially, depth buffer writing is enabled.
+If FLAG is `GL_FALSE', depth buffer writing is disabled. Otherwise, it
+is enabled. Initially, depth buffer writing is enabled.
`GL_INVALID_OPERATION' is generated if `glDepthMask' is executed between
the execution of `glBegin' and the corresponding execution of `glEnd'.")
NEARVAL
Specifies the mapping of the near clipping plane to window
- coordinates. The initial value is 0.
+ coordinates. The initial value is 0.
FARVAL
Specifies the mapping of the far clipping plane to window
- coordinates. The initial value is 1.
+ coordinates. The initial value is 1.
After clipping and division by W, depth coordinates range from -1 to 1,
-corresponding to the near and far clipping planes. `glDepthRange'
+corresponding to the near and far clipping planes. `glDepthRange'
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 `glDepthRange' are both clamped to this range before
-they are accepted.
+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 `glDepthRange' are both clamped to this range before they
+are accepted.
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.
Specifies the shader object to be detached.
`glDetachShader' detaches the shader object specified by SHADER from the
-program object specified by PROGRAM. This command can be used to undo
+program object specified by PROGRAM. This command can be used to undo
the effect of the command `glAttachShader'.
If SHADER has already been flagged for deletion by a call to
"Render primitives from array data.
MODE
- Specifies what kind of primitives to render. Symbolic constants
+ Specifies what kind of primitives to render. Symbolic constants
`GL_POINTS', `GL_LINE_STRIP', `GL_LINE_LOOP', `GL_LINES',
`GL_TRIANGLE_STRIP', `GL_TRIANGLE_FAN', `GL_TRIANGLES',
`GL_QUAD_STRIP', `GL_QUADS', and `GL_POLYGON' are accepted.
Specifies the number of indices to be rendered.
`glDrawArrays' specifies multiple geometric primitives with very few
-subroutine calls. Instead of calling a GL procedure to pass each
+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
When `glDrawArrays' is called, it uses COUNT sequential elements from
each enabled array to construct a sequence of geometric primitives,
-beginning with element FIRST. MODE specifies what kind of primitives
-are constructed and how the array elements construct those primitives.
-If `GL_VERTEX_ARRAY' is not enabled, no geometric primitives are
-generated.
+beginning with element FIRST. MODE specifies what kind of primitives are
+constructed and how the array elements construct those primitives. If
+`GL_VERTEX_ARRAY' is not enabled, no geometric primitives are generated.
Vertex attributes that are modified by `glDrawArrays' have an
-unspecified value after `glDrawArrays' returns. For example, if
+unspecified value after `glDrawArrays' returns. For example, if
`GL_COLOR_ARRAY' is enabled, the value of the current color is undefined
-after `glDrawArrays' executes. Attributes that aren't modified remain
+after `glDrawArrays' executes. Attributes that aren't modified remain
well defined.
`GL_INVALID_ENUM' is generated if MODE is not an accepted value.
into which fragment colors or data values will be written.
`glDrawBuffers' defines an array of buffers into which fragment color
-values or fragment data will be written. If no fragment shader is
+values or fragment data will be written. If no fragment shader is
active, rendering operations will generate only one fragment color per
fragment and it will be written into each of the buffers specified by
-BUFS. If a fragment shader is active and it writes a value to the
-output variable `gl_FragColor', then that value will be written into
-each of the buffers specified by BUFS. If a fragment shader is active
-and it writes a value to one or more elements of the output array
-variable `gl_FragData[]', then the value of `gl_FragData[0] ' will be
-written into the first buffer specified by BUFS, the value of
-`gl_FragData[1] ' will be written into the second buffer specified by
-BUFS, and so on up to `gl_FragData[n-1]'. The draw buffer used for
-`gl_FragData[n]' and beyond is implicitly set to be `GL_NONE'.
+BUFS. If a fragment shader is active and it writes a value to the output
+variable `gl_FragColor', then that value will be written into each of
+the buffers specified by BUFS. If a fragment shader is active and it
+writes a value to one or more elements of the output array variable
+`gl_FragData[]', then the value of `gl_FragData[0] ' will be written
+into the first buffer specified by BUFS, the value of `gl_FragData[1] '
+will be written into the second buffer specified by BUFS, and so on up
+to `gl_FragData[n-1]'. The draw buffer used for `gl_FragData[n]' and
+beyond is implicitly set to be `GL_NONE'.
The symbolic constants contained in BUFS may be any of the following:
The fragment color/data value is written into auxiliary buffer `i'.
Except for `GL_NONE', the preceding symbolic constants may not appear
-more than once in BUFS. The maximum number of draw buffers supported is
+more than once in BUFS. The maximum number of draw buffers supported is
implementation dependent and can be queried by calling `glGet' with the
-argument `GL_MAX_DRAW_BUFFERS'. The number of auxiliary buffers can be
+argument `GL_MAX_DRAW_BUFFERS'. The number of auxiliary buffers can be
queried by calling `glGet' with the argument `GL_AUX_BUFFERS'.
`GL_INVALID_ENUM' is generated if one of the values in BUFS is not an
"Specify which color buffers are to be drawn into.
MODE
- Specifies up to four color buffers to be drawn into. Symbolic
+ Specifies up to four color buffers to be drawn into. Symbolic
constants `GL_NONE', `GL_FRONT_LEFT', `GL_FRONT_RIGHT',
`GL_BACK_LEFT', `GL_BACK_RIGHT', `GL_FRONT', `GL_BACK', `GL_LEFT',
`GL_RIGHT', `GL_FRONT_AND_BACK', and `GL_AUX'I, where I is between
contexts.
When colors are written to the frame buffer, they are written into the
-color buffers specified by `glDrawBuffer'. The specifications are as
+color buffers specified by `glDrawBuffer'. The specifications are as
follows:
`GL_NONE'
Only the back right color buffer is written.
`GL_FRONT'
- Only the front left and front right color buffers are written. If
+ 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.
`GL_BACK'
- Only the back left and back right color buffers are written. If
+ 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.
`GL_LEFT'
- Only the front left and back left color buffers are written. If
+ 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.
`GL_RIGHT'
- Only the front right and back right color buffers are written. If
+ 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.
`GL_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
+ 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
+ color buffers are written. If there are no right or back color
buffers, only the front left color buffer is written.
`GL_AUX'I
buffer and can produce different results in each buffer.
Monoscopic contexts include only LEFT buffers, and stereoscopic contexts
-include both LEFT and RIGHT buffers. Likewise, single-buffered contexts
+include both LEFT and RIGHT buffers. Likewise, single-buffered contexts
include only FRONT buffers, and double-buffered contexts include both
-FRONT and BACK buffers. The context is selected at GL initialization.
+FRONT and BACK buffers. The context is selected at GL initialization.
`GL_INVALID_ENUM' is generated if MODE is not an accepted value.
"Render primitives from array data.
MODE
- Specifies what kind of primitives to render. Symbolic constants
+ Specifies what kind of primitives to render. Symbolic constants
`GL_POINTS', `GL_LINE_STRIP', `GL_LINE_LOOP', `GL_LINES',
`GL_TRIANGLE_STRIP', `GL_TRIANGLE_FAN', `GL_TRIANGLES',
`GL_QUAD_STRIP', `GL_QUADS', and `GL_POLYGON' are accepted.
Specifies the number of elements to be rendered.
TYPE
- Specifies the type of the values in INDICES. Must be one of
+ Specifies the type of the values in INDICES. Must be one of
`GL_UNSIGNED_BYTE', `GL_UNSIGNED_SHORT', or `GL_UNSIGNED_INT'.
INDICES
Specifies a pointer to the location where the indices are stored.
`glDrawElements' specifies multiple geometric primitives with very few
-subroutine calls. Instead of calling a GL function to pass each
+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
When `glDrawElements' is called, it uses COUNT sequential elements from
an enabled array, starting at INDICES to construct a sequence of
-geometric primitives. MODE 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 `GL_VERTEX_ARRAY' is
+geometric primitives. MODE 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 `GL_VERTEX_ARRAY' is
not enabled, no geometric primitives are constructed.
Vertex attributes that are modified by `glDrawElements' have an
-unspecified value after `glDrawElements' returns. For example, if
+unspecified value after `glDrawElements' returns. For example, if
`GL_COLOR_ARRAY' is enabled, the value of the current color is undefined
-after `glDrawElements' executes. Attributes that aren't modified
+after `glDrawElements' executes. Attributes that aren't modified
maintain their previous values.
`GL_INVALID_ENUM' is generated if MODE is not an accepted value.
the frame buffer.
FORMAT
- Specifies the format of the pixel data. Symbolic constants
+ Specifies the format of the pixel data. Symbolic constants
`GL_COLOR_INDEX', `GL_STENCIL_INDEX', `GL_DEPTH_COMPONENT',
`GL_RGB', `GL_BGR', `GL_RGBA', `GL_BGRA', `GL_RED', `GL_GREEN',
`GL_BLUE', `GL_ALPHA', `GL_LUMINANCE', and `GL_LUMINANCE_ALPHA' are
accepted.
TYPE
- Specifies the data type for DATA. Symbolic constants
+ Specifies the data type for DATA. Symbolic constants
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
`glDrawPixels' reads pixel data from memory and writes it into the frame
buffer relative to the current raster position, provided that the raster
-position is valid. Use `glRasterPos' or `glWindowPos' to set the
-current raster position; use `glGet' with argument
+position is valid. Use `glRasterPos' or `glWindowPos' to set the current
+raster position; use `glGet' with argument
`GL_CURRENT_RASTER_POSITION_VALID' to determine if the specified raster
position is valid, and `glGet' with argument
`GL_CURRENT_RASTER_POSITION' to query the raster position.
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:
-`glPixelStore', `glPixelTransfer', `glPixelMap', and `glPixelZoom'. This
+frame buffer. These parameters are set with four commands:
+`glPixelStore', `glPixelTransfer', `glPixelMap', and `glPixelZoom'. This
reference page describes the effects on `glDrawPixels' of many, but not
all, of the parameters specified by these four commands.
Data is read from DATA as a sequence of signed or unsigned bytes, signed
or unsigned shorts, signed or unsigned integers, or single-precision
-floating-point values, depending on TYPE. When TYPE is one of
+floating-point values, depending on TYPE. When TYPE is one of
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_UNSIGNED_SHORT', `GL_SHORT',
`GL_UNSIGNED_INT', `GL_INT', or `GL_FLOAT' each of these bytes, shorts,
integers, or floating-point values is interpreted as one color or depth
-component, or one index, depending on FORMAT. When TYPE is one of
+component, or one index, depending on FORMAT. When TYPE is one of
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_SHORT_5_6_5',
`GL_UNSIGNED_SHORT_4_4_4_4', `GL_UNSIGNED_SHORT_5_5_5_1',
`GL_UNSIGNED_INT_8_8_8_8', or `GL_UNSIGNED_INT_10_10_10_2', each
`GL_UNSIGNED_SHORT_1_5_5_5_REV', `GL_UNSIGNED_INT_8_8_8_8_REV', or
`GL_UNSIGNED_INT_2_10_10_10_REV', each unsigned value is interpreted as
containing all color components, specified by FORMAT, for a single pixel
-in a reversed order. Indices are always treated individually. Color
+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 FORMAT. Both individual indices and groups of components
-are referred to as pixels. If TYPE is `GL_BITMAP', the data must be
+again based on FORMAT. Both individual indices and groups of components
+are referred to as pixels. If TYPE is `GL_BITMAP', the data must be
unsigned bytes, and FORMAT must be either `GL_COLOR_INDEX' or
-`GL_STENCIL_INDEX'. Each unsigned byte is treated as eight 1-bit
-pixels, with bit ordering determined by `GL_UNPACK_LSB_FIRST' (see
+`GL_STENCIL_INDEX'. Each unsigned byte is treated as eight 1-bit pixels,
+with bit ordering determined by `GL_UNPACK_LSB_FIRST' (see
`glPixelStore').
-WIDTH×HEIGHT pixels are read from memory, starting at location DATA. By
+WIDTH×HEIGHT pixels are read from memory, starting at location DATA. By
default, these pixels are taken from adjacent memory locations, except
that after all WIDTH pixels are read, the read pointer is advanced to
-the next four-byte boundary. The four-byte row alignment is specified
-by `glPixelStore' with argument `GL_UNPACK_ALIGNMENT', and it can be set
-to one, two, four, or eight bytes. Other pixel store parameters specify
+the next four-byte boundary. The four-byte row alignment is specified by
+`glPixelStore' with argument `GL_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 WIDTH pixels are read. See the `glPixelStore' reference
+and after all WIDTH pixels are read. See the `glPixelStore' reference
page for details on these options.
If a non-zero named buffer object is bound to the
The WIDTH×HEIGHT pixels that are read from memory are each operated on
in the same way, based on the values of several parameters specified by
-`glPixelTransfer' and `glPixelMap'. The details of these operations, as
+`glPixelTransfer' and `glPixelMap'. 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 FORMAT. FORMAT can assume
+to the format of the pixels, as specified by FORMAT. FORMAT can assume
one of 13 symbolic values:
`GL_COLOR_INDEX'
- Each pixel is a single value, a color index. It is converted to
+ 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
+ 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.
+ to 0. Bitmap data convert to either 0 or 1.
Each fixed-point index is then shifted left by `GL_INDEX_SHIFT'
- bits and added to `GL_INDEX_OFFSET'. If `GL_INDEX_SHIFT' is
- negative, the shift is to the right. In either case, zero bits
- fill otherwise unspecified bit locations in the result.
+ bits and added to `GL_INDEX_OFFSET'. If `GL_INDEX_SHIFT' is
+ negative, the shift is to the right. In either case, zero bits fill
+ otherwise unspecified bit locations in the result.
If the GL is in RGBA mode, the resulting index is converted to an
RGBA pixel with the help of the `GL_PIXEL_MAP_I_TO_R',
`GL_PIXEL_MAP_I_TO_G', `GL_PIXEL_MAP_I_TO_B', and
- `GL_PIXEL_MAP_I_TO_A' tables. If the GL is in color index mode,
- and if `GL_MAP_COLOR' is true, the index is replaced with the value
- that it references in lookup table `GL_PIXEL_MAP_I_TO_I'. Whether
+ `GL_PIXEL_MAP_I_TO_A' tables. If the GL is in color index mode, and
+ if `GL_MAP_COLOR' is true, the index is replaced with the value
+ that it references in lookup table `GL_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^B-1 , where B is the number
of bits in a color index buffer.
coordinates to the N th fragment such that X_N=X_R+N%WIDTH
Y_N=Y_R+⌊N/WIDTH,⌋
- where (X_R,Y_R) is the current raster position. These pixel
+ where (X_R,Y_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
+ rasterizing points, lines, or polygons. Texture mapping, fog, and
all the fragment operations are applied before the fragments are
written to the frame buffer.
`GL_STENCIL_INDEX'
- Each pixel is a single value, a stencil index. It is converted to
+ 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
+ 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.
+ to 0. Bitmap data convert to either 0 or 1.
Each fixed-point index is then shifted left by `GL_INDEX_SHIFT'
- bits, and added to `GL_INDEX_OFFSET'. If `GL_INDEX_SHIFT' is
- negative, the shift is to the right. In either case, zero bits
- fill otherwise unspecified bit locations in the result. If
+ bits, and added to `GL_INDEX_OFFSET'. If `GL_INDEX_SHIFT' is
+ negative, the shift is to the right. In either case, zero bits fill
+ otherwise unspecified bit locations in the result. If
`GL_MAP_STENCIL' is true, the index is replaced with the value that
- it references in lookup table `GL_PIXEL_MAP_S_TO_S'. Whether the
+ it references in lookup table `GL_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^B-1 , where B is the number of bits
- in the stencil buffer. The resulting stencil indices are then
+ 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
X_N=X_R+N%WIDTH Y_N=Y_R+⌊N/WIDTH,⌋
- where (X_R,Y_R) is the current raster position. Only the pixel
+ where (X_R,Y_R) is the current raster position. Only the pixel
ownership test, the scissor test, and the stencil writemask affect
these write operations.
`GL_DEPTH_COMPONENT'
- Each pixel is a single-depth component. Floating-point data is
+ 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
+ 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
+ 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 `GL_DEPTH_SCALE' and added to `GL_DEPTH_BIAS'. The result is
+ 0.0. The resulting floating-point depth value is then multiplied by
+ `GL_DEPTH_SCALE' and added to `GL_DEPTH_BIAS'. The result is
clamped to the range [0,1] .
The GL then converts the resulting depth components to fragments by
X_N=X_R+N%WIDTH Y_N=Y_R+⌊N/WIDTH,⌋
- where (X_R,Y_R) is the current raster position. These pixel
+ where (X_R,Y_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
+ rasterizing points, lines, or polygons. Texture mapping, fog, and
all the fragment operations are applied before the fragments are
written to the frame buffer.
Each pixel is a four-component group: For `GL_RGBA', the red
component is first, followed by green, followed by blue, followed
by alpha; for `GL_BGRA' the order is blue, green, red and then
- alpha. Floating-point values are converted directly to an internal
- floating-point format with unspecified precision. Signed integer
+ alpha. 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
+ 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
+ 1.0, and 0 maps to 0.0. The resulting floating-point color values
are then multiplied by `GL_c_SCALE' and added to `GL_c_BIAS', where
C is RED, GREEN, BLUE, and ALPHA for the respective color
- components. The results are clamped to the range [0,1] .
+ components. The results are clamped to the range [0,1] .
If `GL_MAP_COLOR' is true, each color component is scaled by the
size of lookup table `GL_PIXEL_MAP_c_TO_c', then replaced by the
- value that it references in that table. C is R, G, B, or A
+ value that it references in that table. C is R, G, B, or A
respectively.
The GL then converts the resulting RGBA colors to fragments by
X_N=X_R+N%WIDTH Y_N=Y_R+⌊N/WIDTH,⌋
- where (X_R,Y_R) is the current raster position. These pixel
+ where (X_R,Y_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
+ rasterizing points, lines, or polygons. Texture mapping, fog, and
all the fragment operations are applied before the fragments are
written to the frame buffer.
`GL_RED'
- Each pixel is a single red component. This component is converted
+ 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
+ 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.
`GL_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.
+ 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.
`GL_BLUE'
- Each pixel is a single blue component. This component is converted
+ 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
+ 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.
`GL_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.
+ 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.
`GL_RGB'
`GL_BGR'
Each pixel is a three-component group: red first, followed by
green, followed by blue; for `GL_BGR', the first component is blue,
- followed by green and then red. Each component is converted to the
+ 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.
+ 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.
`GL_LUMINANCE'
- Each pixel is a single luminance component. This component is
+ 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
+ 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
+ value, and alpha set to 1. After this conversion, the pixel is
treated as if it had been read as an RGBA pixel.
`GL_LUMINANCE_ALPHA'
Each pixel is a two-component group: luminance first, followed by
- alpha. The two components are converted to the internal
+ 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.
+ 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.
The following table summarizes the meaning of the valid constants for
the TYPE parameter:
-The rasterization described so far assumes pixel zoom factors of 1. If
+The rasterization described so far assumes pixel zoom factors of 1. If
`glPixelZoom' is used to change the X and Y pixel zoom factors, pixels
-are converted to fragments as follows. If (X_R,Y_R) is the current
+are converted to fragments as follows. If (X_R,Y_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
"Render primitives from array data.
MODE
- Specifies what kind of primitives to render. Symbolic constants
+ Specifies what kind of primitives to render. Symbolic constants
`GL_POINTS', `GL_LINE_STRIP', `GL_LINE_LOOP', `GL_LINES',
`GL_TRIANGLE_STRIP', `GL_TRIANGLE_FAN', `GL_TRIANGLES',
`GL_QUAD_STRIP', `GL_QUADS', and `GL_POLYGON' are accepted.
Specifies the number of elements to be rendered.
TYPE
- Specifies the type of the values in INDICES. Must be one of
+ Specifies the type of the values in INDICES. Must be one of
`GL_UNSIGNED_BYTE', `GL_UNSIGNED_SHORT', or `GL_UNSIGNED_INT'.
INDICES
Specifies a pointer to the location where the indices are stored.
-`glDrawRangeElements' is a restricted form of `glDrawElements'. MODE,
+`glDrawRangeElements' is a restricted form of `glDrawElements'. MODE,
START, END, and COUNT match the corresponding arguments to
`glDrawElements', with the additional constraint that all values in the
arrays COUNT must lie between START and END, inclusive.
Implementations denote recommended maximum amounts of vertex and index
data, which may be queried by calling `glGet' with argument
-`GL_MAX_ELEMENTS_VERTICES' and `GL_MAX_ELEMENTS_INDICES'. If
-END-START+1 is greater than the value of `GL_MAX_ELEMENTS_VERTICES', or
-if COUNT is greater than the value of `GL_MAX_ELEMENTS_INDICES', then
-the call may operate at reduced performance. There is no requirement
-that all vertices in the range [START,END] be referenced. However, the
+`GL_MAX_ELEMENTS_VERTICES' and `GL_MAX_ELEMENTS_INDICES'. If END-START+1
+is greater than the value of `GL_MAX_ELEMENTS_VERTICES', or if COUNT is
+greater than the value of `GL_MAX_ELEMENTS_INDICES', then the call may
+operate at reduced performance. There is no requirement that all
+vertices in the range [START,END] be referenced. However, the
implementation may partially process unused vertices, reducing
performance from what could be achieved with an optimal index set.
When `glDrawRangeElements' is called, it uses COUNT sequential elements
from an enabled array, starting at START to construct a sequence of
-geometric primitives. MODE 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 `GL_VERTEX_ARRAY' is
+geometric primitives. MODE 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 `GL_VERTEX_ARRAY' is
not enabled, no geometric primitives are constructed.
Vertex attributes that are modified by `glDrawRangeElements' have an
-unspecified value after `glDrawRangeElements' returns. For example, if
+unspecified value after `glDrawRangeElements' returns. For example, if
`GL_COLOR_ARRAY' is enabled, the value of the current color is undefined
-after `glDrawRangeElements' executes. Attributes that aren't modified
+after `glDrawRangeElements' executes. Attributes that aren't modified
maintain their previous values.
It is an error for indices to lie outside the range [START,END] , but
-implementations may not check for this situation. Such indices cause
+implementations may not check for this situation. Such indices cause
implementation-dependent behavior.
`GL_INVALID_ENUM' is generated if MODE is not an accepted value.
"Define an array of edge flags.
STRIDE
- Specifies the byte offset between consecutive edge flags. If
- STRIDE is 0, the edge flags are understood to be tightly packed in
- the array. The initial value is 0.
+ Specifies the byte offset between consecutive edge flags. If STRIDE
+ is 0, the edge flags are understood to be tightly packed in the
+ array. The initial value is 0.
POINTER
- Specifies a pointer to the first edge flag in the array. The
+ Specifies a pointer to the first edge flag in the array. The
initial value is 0.
`glEdgeFlagPointer' specifies the location and data format of an array
-of boolean edge flags to use when rendering. STRIDE specifies the byte
+of boolean edge flags to use when rendering. STRIDE 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.
binding.
To enable and disable the edge flag array, call `glEnableClientState'
-and `glDisableClientState' with the argument `GL_EDGE_FLAG_ARRAY'. If
+and `glDisableClientState' with the argument `GL_EDGE_FLAG_ARRAY'. If
enabled, the edge flag array is used when `glDrawArrays',
`glMultiDrawArrays', `glDrawElements', `glMultiDrawElements',
`glDrawRangeElements', or `glArrayElement' is called.
FLAG
Specifies the current edge flag value, either `GL_TRUE' or
- `GL_FALSE'. The initial value is `GL_TRUE'.
+ `GL_FALSE'. The initial value is `GL_TRUE'.
Each vertex of a polygon, separate triangle, or separate quadrilateral
specified between a `glBegin'/`glEnd' pair is marked as the start of
-either a boundary or nonboundary edge. If the current edge flag is true
+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. `glEdgeFlag' sets the edge flag bit to `GL_TRUE' if
+boundary edge. Otherwise, the vertex is marked as the start of a
+nonboundary edge. `glEdgeFlag' sets the edge flag bit to `GL_TRUE' if
FLAG is `GL_TRUE' and to `GL_FALSE' otherwise.
The vertices of connected triangles and connected quadrilaterals are
always marked as boundary, regardless of the value of the edge flag.
Boundary and nonboundary edge flags on vertices are significant only if
-`GL_POLYGON_MODE' is set to `GL_POINT' or `GL_LINE'. See
+`GL_POLYGON_MODE' is set to `GL_POINT' or `GL_LINE'. See
`glPolygonMode'.")
(define-gl-procedures
"Enable or disable client-side capability.
CAP
- Specifies the capability to enable. Symbolic constants
+ Specifies the capability to enable. Symbolic constants
`GL_COLOR_ARRAY', `GL_EDGE_FLAG_ARRAY', `GL_FOG_COORD_ARRAY',
`GL_INDEX_ARRAY', `GL_NORMAL_ARRAY', `GL_SECONDARY_COLOR_ARRAY',
`GL_TEXTURE_COORD_ARRAY', and `GL_VERTEX_ARRAY' are accepted.
`glEnableClientState' and `glDisableClientState' enable or disable
-individual client-side capabilities. By default, all client-side
-capabilities are disabled. Both `glEnableClientState' and
+individual client-side capabilities. By default, all client-side
+capabilities are disabled. Both `glEnableClientState' and
`glDisableClientState' take a single argument, CAP, which can assume one
of the following values:
If enabled, the color array is enabled for writing and used during
rendering when `glArrayElement', `glDrawArrays', `glDrawElements',
`glDrawRangeElements'`glMultiDrawArrays', or `glMultiDrawElements'
- is called. See `glColorPointer'.
+ is called. See `glColorPointer'.
`GL_EDGE_FLAG_ARRAY'
If enabled, the edge flag array is enabled for writing and used
during rendering when `glArrayElement', `glDrawArrays',
`glDrawElements', `glDrawRangeElements'`glMultiDrawArrays', or
- `glMultiDrawElements' is called. See `glEdgeFlagPointer'.
+ `glMultiDrawElements' is called. See `glEdgeFlagPointer'.
`GL_FOG_COORD_ARRAY'
If enabled, the fog coordinate array is enabled for writing and
used during rendering when `glArrayElement', `glDrawArrays',
`glDrawElements', `glDrawRangeElements'`glMultiDrawArrays', or
- `glMultiDrawElements' is called. See `glFogCoordPointer'.
+ `glMultiDrawElements' is called. See `glFogCoordPointer'.
`GL_INDEX_ARRAY'
If enabled, the index array is enabled for writing and used during
rendering when `glArrayElement', `glDrawArrays', `glDrawElements',
`glDrawRangeElements'`glMultiDrawArrays', or `glMultiDrawElements'
- is called. See `glIndexPointer'.
+ is called. See `glIndexPointer'.
`GL_NORMAL_ARRAY'
If enabled, the normal array is enabled for writing and used during
rendering when `glArrayElement', `glDrawArrays', `glDrawElements',
`glDrawRangeElements'`glMultiDrawArrays', or `glMultiDrawElements'
- is called. See `glNormalPointer'.
+ is called. See `glNormalPointer'.
`GL_SECONDARY_COLOR_ARRAY'
If enabled, the secondary color array is enabled for writing and
used during rendering when `glArrayElement', `glDrawArrays',
`glDrawElements', `glDrawRangeElements'`glMultiDrawArrays', or
- `glMultiDrawElements' is called. See `glColorPointer'.
+ `glMultiDrawElements' is called. See `glColorPointer'.
`GL_TEXTURE_COORD_ARRAY'
If enabled, the texture coordinate array is enabled for writing and
used during rendering when `glArrayElement', `glDrawArrays',
`glDrawElements', `glDrawRangeElements'`glMultiDrawArrays', or
- `glMultiDrawElements' is called. See `glTexCoordPointer'.
+ `glMultiDrawElements' is called. See `glTexCoordPointer'.
`GL_VERTEX_ARRAY'
If enabled, the vertex array is enabled for writing and used during
rendering when `glArrayElement', `glDrawArrays', `glDrawElements',
`glDrawRangeElements'`glMultiDrawArrays', or `glMultiDrawElements'
- is called. See `glVertexPointer'.
+ is called. See `glVertexPointer'.
`GL_INVALID_ENUM' is generated if CAP is not an accepted value.
or disabled.
`glEnableVertexAttribArray' enables the generic vertex attribute array
-specified by INDEX. `glDisableVertexAttribArray' disables the generic
-vertex attribute array specified by INDEX. By default, all client-side
+specified by INDEX. `glDisableVertexAttribArray' disables the generic
+vertex attribute array specified by INDEX. By default, all client-side
capabilities are disabled, including all generic vertex attribute
-arrays. If enabled, the values in the generic vertex attribute array
+arrays. If enabled, the values in the generic vertex attribute array
will be accessed and used for rendering when calls are made to vertex
array commands such as `glDrawArrays', `glDrawElements',
`glDrawRangeElements', `glArrayElement', `glMultiDrawElements', or
CAP
Specifies a symbolic constant indicating a GL capability.
-`glEnable' and `glDisable' enable and disable various capabilities. Use
+`glEnable' and `glDisable' enable and disable various capabilities. Use
`glIsEnabled' or `glGet' to determine the current setting of any
-capability. The initial value for each capability with the exception of
-`GL_DITHER' and `GL_MULTISAMPLE' is `GL_FALSE'. The initial value for
+capability. The initial value for each capability with the exception of
+`GL_DITHER' and `GL_MULTISAMPLE' is `GL_FALSE'. The initial value for
`GL_DITHER' and `GL_MULTISAMPLE' is `GL_TRUE'.
Both `glEnable' and `glDisable' take a single argument, CAP, which can
`GL_ALPHA_TEST'
- If enabled, do alpha testing. See `glAlphaFunc'.
+ If enabled, do alpha testing. See `glAlphaFunc'.
`GL_AUTO_NORMAL'
If enabled, generate normal vectors when either `GL_MAP2_VERTEX_3'
- or `GL_MAP2_VERTEX_4' is used to generate vertices. See `glMap2'.
+ or `GL_MAP2_VERTEX_4' is used to generate vertices. See `glMap2'.
`GL_BLEND'
If enabled, blend the computed fragment color values with the
- values in the color buffers. See `glBlendFunc'.
+ values in the color buffers. See `glBlendFunc'.
`GL_CLIP_PLANE'I
If enabled, apply the currently selected logical operation to the
- computed fragment color and color buffer values. See `glLogicOp'.
+ computed fragment color and color buffer values. See `glLogicOp'.
`GL_COLOR_MATERIAL'
If enabled, have one or more material parameters track the current
- color. See `glColorMaterial'.
+ color. See `glColorMaterial'.
`GL_COLOR_SUM'
If enabled and no fragment shader is active, add the secondary
- color value to the computed fragment color. See
- `glSecondaryColor'.
+ color value to the computed fragment color. See `glSecondaryColor'.
`GL_COLOR_TABLE'
If enabled, perform a color table lookup on the incoming RGBA color
- values. See `glColorTable'.
+ values. See `glColorTable'.
`GL_CONVOLUTION_1D'
If enabled, perform a 1D convolution operation on incoming RGBA
- color values. See `glConvolutionFilter1D'.
+ color values. See `glConvolutionFilter1D'.
`GL_CONVOLUTION_2D'
If enabled, perform a 2D convolution operation on incoming RGBA
- color values. See `glConvolutionFilter2D'.
+ color values. See `glConvolutionFilter2D'.
`GL_CULL_FACE'
If enabled, cull polygons based on their winding in window
- coordinates. See `glCullFace'.
+ coordinates. See `glCullFace'.
`GL_DEPTH_TEST'
- If enabled, do depth comparisons and update the depth buffer. Note
+ 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 `glDepthFunc' and `glDepthRange'.
+ disabled. See `glDepthFunc' and `glDepthRange'.
`GL_DITHER'
If enabled and no fragment shader is active, blend a fog color into
- the post-texturing color. See `glFog'.
+ the post-texturing color. See `glFog'.
`GL_HISTOGRAM'
- If enabled, histogram incoming RGBA color values. See
+ If enabled, histogram incoming RGBA color values. See
`glHistogram'.
`GL_INDEX_LOGIC_OP'
If enabled, apply the currently selected logical operation to the
- incoming index and color buffer indices. See `glLogicOp'.
+ incoming index and color buffer indices. See `glLogicOp'.
`GL_LIGHT'I
If enabled, include light I in the evaluation of the lighting
- equation. See `glLightModel' and `glLight'.
+ equation. See `glLightModel' and `glLight'.
`GL_LIGHTING'
If enabled and no vertex shader is active, use the current lighting
- parameters to compute the vertex color or index. Otherwise, simply
- associate the current color or index with each vertex. See
+ parameters to compute the vertex color or index. Otherwise, simply
+ associate the current color or index with each vertex. See
`glMaterial', `glLightModel', and `glLight'.
`GL_LINE_SMOOTH'
- If enabled, draw lines with correct filtering. Otherwise, draw
- aliased lines. See `glLineWidth'.
+ If enabled, draw lines with correct filtering. Otherwise, draw
+ aliased lines. See `glLineWidth'.
`GL_LINE_STIPPLE'
If enabled, use the current line stipple pattern when drawing
- lines. See `glLineStipple'.
+ lines. See `glLineStipple'.
`GL_MAP1_COLOR_4'
If enabled, calls to `glEvalCoord1', `glEvalMesh1', and
- `glEvalPoint1' generate RGBA values. See `glMap1'.
+ `glEvalPoint1' generate RGBA values. See `glMap1'.
`GL_MAP1_INDEX'
If enabled, calls to `glEvalCoord1', `glEvalMesh1', and
- `glEvalPoint1' generate color indices. See `glMap1'.
+ `glEvalPoint1' generate color indices. See `glMap1'.
`GL_MAP1_NORMAL'
If enabled, calls to `glEvalCoord1', `glEvalMesh1', and
- `glEvalPoint1' generate normals. See `glMap1'.
+ `glEvalPoint1' generate normals. See `glMap1'.
`GL_MAP1_TEXTURE_COORD_1'
If enabled, calls to `glEvalCoord1', `glEvalMesh1', and
- `glEvalPoint1' generate S texture coordinates. See `glMap1'.
+ `glEvalPoint1' generate S texture coordinates. See `glMap1'.
`GL_MAP1_TEXTURE_COORD_2'
If enabled, calls to `glEvalCoord1', `glEvalMesh1', and
- `glEvalPoint1' generate S and T texture coordinates. See `glMap1'.
+ `glEvalPoint1' generate S and T texture coordinates. See `glMap1'.
`GL_MAP1_TEXTURE_COORD_3'
If enabled, calls to `glEvalCoord1', `glEvalMesh1', and
- `glEvalPoint1' generate S, T, and R texture coordinates. See
+ `glEvalPoint1' generate S, T, and R texture coordinates. See
`glMap1'.
`GL_MAP1_TEXTURE_COORD_4'
If enabled, calls to `glEvalCoord1', `glEvalMesh1', and
- `glEvalPoint1' generate S, T, R, and Q texture coordinates. See
+ `glEvalPoint1' generate S, T, R, and Q texture coordinates. See
`glMap1'.
`GL_MAP1_VERTEX_3'
If enabled, calls to `glEvalCoord1', `glEvalMesh1', and
- `glEvalPoint1' generate X, Y, and Z vertex coordinates. See
+ `glEvalPoint1' generate X, Y, and Z vertex coordinates. See
`glMap1'.
`GL_MAP1_VERTEX_4'
If enabled, calls to `glEvalCoord1', `glEvalMesh1', and
`glEvalPoint1' generate homogeneous X, Y, Z, and W vertex
- coordinates. See `glMap1'.
+ coordinates. See `glMap1'.
`GL_MAP2_COLOR_4'
If enabled, calls to `glEvalCoord2', `glEvalMesh2', and
- `glEvalPoint2' generate RGBA values. See `glMap2'.
+ `glEvalPoint2' generate RGBA values. See `glMap2'.
`GL_MAP2_INDEX'
If enabled, calls to `glEvalCoord2', `glEvalMesh2', and
- `glEvalPoint2' generate color indices. See `glMap2'.
+ `glEvalPoint2' generate color indices. See `glMap2'.
`GL_MAP2_NORMAL'
If enabled, calls to `glEvalCoord2', `glEvalMesh2', and
- `glEvalPoint2' generate normals. See `glMap2'.
+ `glEvalPoint2' generate normals. See `glMap2'.
`GL_MAP2_TEXTURE_COORD_1'
If enabled, calls to `glEvalCoord2', `glEvalMesh2', and
- `glEvalPoint2' generate S texture coordinates. See `glMap2'.
+ `glEvalPoint2' generate S texture coordinates. See `glMap2'.
`GL_MAP2_TEXTURE_COORD_2'
If enabled, calls to `glEvalCoord2', `glEvalMesh2', and
- `glEvalPoint2' generate S and T texture coordinates. See `glMap2'.
+ `glEvalPoint2' generate S and T texture coordinates. See `glMap2'.
`GL_MAP2_TEXTURE_COORD_3'
If enabled, calls to `glEvalCoord2', `glEvalMesh2', and
- `glEvalPoint2' generate S, T, and R texture coordinates. See
+ `glEvalPoint2' generate S, T, and R texture coordinates. See
`glMap2'.
`GL_MAP2_TEXTURE_COORD_4'
If enabled, calls to `glEvalCoord2', `glEvalMesh2', and
- `glEvalPoint2' generate S, T, R, and Q texture coordinates. See
+ `glEvalPoint2' generate S, T, R, and Q texture coordinates. See
`glMap2'.
`GL_MAP2_VERTEX_3'
If enabled, calls to `glEvalCoord2', `glEvalMesh2', and
- `glEvalPoint2' generate X, Y, and Z vertex coordinates. See
+ `glEvalPoint2' generate X, Y, and Z vertex coordinates. See
`glMap2'.
`GL_MAP2_VERTEX_4'
If enabled, calls to `glEvalCoord2', `glEvalMesh2', and
`glEvalPoint2' generate homogeneous X, Y, Z, and W vertex
- coordinates. See `glMap2'.
+ coordinates. See `glMap2'.
`GL_MINMAX'
If enabled, compute the minimum and maximum values of incoming RGBA
- color values. See `glMinmax'.
+ color values. See `glMinmax'.
`GL_MULTISAMPLE'
If enabled, use multiple fragment samples in computing the final
- color of a pixel. See `glSampleCoverage'.
+ color of a pixel. See `glSampleCoverage'.
`GL_NORMALIZE'
`GL_POINT_SMOOTH'
- If enabled, draw points with proper filtering. Otherwise, draw
- aliased points. See `glPointSize'.
+ If enabled, draw points with proper filtering. Otherwise, draw
+ aliased points. See `glPointSize'.
`GL_POINT_SPRITE'
If enabled, calculate texture coordinates for points based on
- texture environment and point parameter settings. Otherwise
- texture coordinates are constant across points.
+ texture environment and point parameter settings. Otherwise texture
+ coordinates are constant across points.
`GL_POLYGON_OFFSET_FILL'
If enabled, and if the polygon is rendered in `GL_FILL' mode, an
offset is added to depth values of a polygon's fragments before the
- depth comparison is performed. See `glPolygonOffset'.
+ depth comparison is performed. See `glPolygonOffset'.
`GL_POLYGON_OFFSET_LINE'
If enabled, and if the polygon is rendered in `GL_LINE' mode, an
offset is added to depth values of a polygon's fragments before the
- depth comparison is performed. See `glPolygonOffset'.
+ depth comparison is performed. See `glPolygonOffset'.
`GL_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 `GL_POINT' mode. See `glPolygonOffset'.
+ is rendered in `GL_POINT' mode. See `glPolygonOffset'.
`GL_POLYGON_SMOOTH'
- If enabled, draw polygons with proper filtering. Otherwise, draw
- aliased polygons. For correct antialiased polygons, an alpha
- buffer is needed and the polygons must be sorted front to back.
+ If enabled, draw polygons with proper filtering. Otherwise, draw
+ aliased polygons. For correct antialiased polygons, an alpha buffer
+ is needed and the polygons must be sorted front to back.
`GL_POLYGON_STIPPLE'
If enabled, use the current polygon stipple pattern when rendering
- polygons. See `glPolygonStipple'.
+ polygons. See `glPolygonStipple'.
`GL_POST_COLOR_MATRIX_COLOR_TABLE'
If enabled, perform a color table lookup on RGBA color values after
- color matrix transformation. See `glColorTable'.
+ color matrix transformation. See `glColorTable'.
`GL_POST_CONVOLUTION_COLOR_TABLE'
If enabled, perform a color table lookup on RGBA color values after
- convolution. See `glColorTable'.
+ convolution. See `glColorTable'.
`GL_RESCALE_NORMAL'
If enabled and no vertex shader is active, normal vectors are
scaled after transformation and before lighting by a factor
- computed from the modelview matrix. If the modelview matrix scales
+ computed from the modelview matrix. If the modelview matrix scales
space uniformly, this has the effect of restoring the transformed
- normal to unit length. This method is generally more efficient
- than `GL_NORMALIZE'. See `glNormal' and `glNormalPointer'.
+ normal to unit length. This method is generally more efficient than
+ `GL_NORMALIZE'. See `glNormal' and `glNormalPointer'.
`GL_SAMPLE_ALPHA_TO_COVERAGE'
If enabled, the fragment's coverage is ANDed with the temporary
- coverage value. If `GL_SAMPLE_COVERAGE_INVERT' is set to
- `GL_TRUE', invert the coverage value. See `glSampleCoverage'.
+ coverage value. If `GL_SAMPLE_COVERAGE_INVERT' is set to `GL_TRUE',
+ invert the coverage value. See `glSampleCoverage'.
`GL_SEPARABLE_2D'
If enabled, perform a two-dimensional convolution operation using a
- separable convolution filter on incoming RGBA color values. See
+ separable convolution filter on incoming RGBA color values. See
`glSeparableFilter2D'.
`GL_SCISSOR_TEST'
If enabled, discard fragments that are outside the scissor
- rectangle. See `glScissor'.
+ rectangle. See `glScissor'.
`GL_STENCIL_TEST'
- If enabled, do stencil testing and update the stencil buffer. See
+ If enabled, do stencil testing and update the stencil buffer. See
`glStencilFunc' and `glStencilOp'.
`GL_TEXTURE_1D'
If enabled and no fragment shader is active, one-dimensional
texturing is performed (unless two- or three-dimensional or
- cube-mapped texturing is also enabled). See `glTexImage1D'.
+ cube-mapped texturing is also enabled). See `glTexImage1D'.
`GL_TEXTURE_2D'
If enabled and no fragment shader is active, two-dimensional
texturing is performed (unless three-dimensional or cube-mapped
- texturing is also enabled). See `glTexImage2D'.
+ texturing is also enabled). See `glTexImage2D'.
`GL_TEXTURE_3D'
If enabled and no fragment shader is active, three-dimensional
texturing is performed (unless cube-mapped texturing is also
- enabled). See `glTexImage3D'.
+ enabled). See `glTexImage3D'.
`GL_TEXTURE_CUBE_MAP'
If enabled and no fragment shader is active, cube-mapped texturing
- is performed. See `glTexImage2D'.
+ is performed. See `glTexImage2D'.
`GL_TEXTURE_GEN_Q'
If enabled and no vertex shader is active, the Q texture coordinate
is computed using the texture generation function defined with
- `glTexGen'. Otherwise, the current Q texture coordinate is used.
+ `glTexGen'. Otherwise, the current Q texture coordinate is used.
See `glTexGen'.
`GL_TEXTURE_GEN_R'
If enabled and no vertex shader is active, the R texture coordinate
is computed using the texture generation function defined with
- `glTexGen'. Otherwise, the current R texture coordinate is used.
+ `glTexGen'. Otherwise, the current R texture coordinate is used.
See `glTexGen'.
`GL_TEXTURE_GEN_S'
If enabled and no vertex shader is active, the S texture coordinate
is computed using the texture generation function defined with
- `glTexGen'. Otherwise, the current S texture coordinate is used.
+ `glTexGen'. Otherwise, the current S texture coordinate is used.
See `glTexGen'.
`GL_TEXTURE_GEN_T'
If enabled and no vertex shader is active, the T texture coordinate
is computed using the texture generation function defined with
- `glTexGen'. Otherwise, the current T texture coordinate is used.
+ `glTexGen'. Otherwise, the current T texture coordinate is used.
See `glTexGen'.
`GL_VERTEX_PROGRAM_POINT_SIZE'
If enabled and a vertex shader is active, it specifies that the GL
will choose between front and back colors based on the polygon's
- face direction of which the vertex being shaded is a part. It has
+ face direction of which the vertex being shaded is a part. It has
no effect on points or lines.
`GL_INVALID_ENUM' is generated if CAP is not one of the values listed
V
Specifies a value that is the domain coordinate V to the basis
- function defined in a previous `glMap2' command. This argument is
+ function defined in a previous `glMap2' command. This argument is
not present in a `glEvalCoord1' command.
`glEvalCoord1' evaluates enabled one-dimensional maps at argument U.
`glEvalCoord2' does the same for two-dimensional maps using two domain
-values, U and V. To define a map, call `glMap1' and `glMap2'; to enable
+values, U and V. To define a map, call `glMap1' and `glMap2'; to enable
and disable it, call `glEnable' and `glDisable'.
When one of the `glEvalCoord' commands is issued, all currently enabled
-maps of the indicated dimension are evaluated. Then, for each 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 `GL_MAP1_INDEX' or `GL_MAP2_INDEX' is
-enabled, a `glIndex' command is simulated. If `GL_MAP1_COLOR_4' or
-`GL_MAP2_COLOR_4' is enabled, a `glColor' command is simulated. If
+computed value. That is, if `GL_MAP1_INDEX' or `GL_MAP2_INDEX' is
+enabled, a `glIndex' command is simulated. If `GL_MAP1_COLOR_4' or
+`GL_MAP2_COLOR_4' is enabled, a `glColor' command is simulated. If
`GL_MAP1_NORMAL' or `GL_MAP2_NORMAL' is enabled, a normal vector is
produced, and if any of `GL_MAP1_TEXTURE_COORD_1',
`GL_MAP1_TEXTURE_COORD_2', `GL_MAP1_TEXTURE_COORD_3',
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 `glVertex' commands are
+do not update the current values. Thus, if `glVertex' commands are
interspersed with `glEvalCoord' commands, the color, normal, and texture
coordinates associated with the `glVertex' commands are not affected by
the values generated by the `glEvalCoord' commands, but only by the most
recent `glColor', `glIndex', `glNormal', and `glTexCoord' commands.
-No commands are issued for maps that are not enabled. If more than one
+No commands are issued for maps that are not enabled. If more than one
texture evaluation is enabled for a particular dimension (for example,
`GL_MAP2_TEXTURE_COORD_1' and `GL_MAP2_TEXTURE_COORD_2'), then only the
evaluation of the map that produces the larger number of coordinates (in
-this case, `GL_MAP2_TEXTURE_COORD_2') is carried out. `GL_MAP1_VERTEX_4'
+this case, `GL_MAP2_TEXTURE_COORD_2') is carried out. `GL_MAP1_VERTEX_4'
overrides `GL_MAP1_VERTEX_3', and `GL_MAP2_VERTEX_4' overrides
-`GL_MAP2_VERTEX_3', in the same manner. If neither a three- nor a
+`GL_MAP2_VERTEX_3', in the same manner. If neither a three- nor a
four-component vertex map is enabled for the specified dimension, the
`glEvalCoord' command is ignored.
If you have enabled automatic normal generation, by calling `glEnable'
with argument `GL_AUTO_NORMAL', `glEvalCoord2' generates surface normals
analytically, regardless of the contents or enabling of the
-`GL_MAP2_NORMAL' map. Let
+`GL_MAP2_NORMAL' map. Let
`m'=∂`p',/∂U,,×∂`p',/∂V,,
Then the generated normal `n' is `n'=`m'/∥`m',∥,
If automatic normal generation is disabled, the corresponding normal map
-`GL_MAP2_NORMAL', if enabled, is used to produce a normal. If neither
+`GL_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 `glEvalCoord2' commands.")
MODE
In `glEvalMesh1', specifies whether to compute a one-dimensional
- mesh of points or lines. Symbolic constants `GL_POINT' and
+ mesh of points or lines. Symbolic constants `GL_POINT' and
`GL_LINE' are accepted.
I1
I .
`glMapGrid' and `glEvalMesh' are used in tandem to efficiently generate
-and evaluate a series of evenly-spaced map domain values. `glEvalMesh'
+and evaluate a series of evenly-spaced map domain values. `glEvalMesh'
steps through the integer domain of a one- or two-dimensional grid,
whose range is the domain of the evaluation maps specified by `glMap1'
-and `glMap2'. MODE determines whether the resulting vertices are
+and `glMap2'. MODE determines whether the resulting vertices are
connected as points, lines, or filled polygons.
In the one-dimensional case, `glEvalMesh1', the mesh is generated as if
ΔU=(U_2-U_1,)/N
and N , U_1 , and U_2 are the arguments to the most recent `glMapGrid1'
-command. TYPE is `GL_POINTS' if MODE is `GL_POINT', or `GL_LINES' if
+command. TYPE is `GL_POINTS' if MODE is `GL_POINT', or `GL_LINES' if
MODE is `GL_LINE'.
The one absolute numeric requirement is that if I=N , then the value
ΔV=(V_2-V_1,)/M
where N , U_1 , U_2 , M , V_1 , and V_2 are the arguments to the most
-recent `glMapGrid2' command. Then, if MODE is `GL_FILL', the
+recent `glMapGrid2' command. Then, if MODE is `GL_FILL', the
`glEvalMesh2' command is equivalent to:
(`glEvalPoint2' only).
`glMapGrid' and `glEvalMesh' are used in tandem to efficiently generate
-and evaluate a series of evenly spaced map domain values. `glEvalPoint'
+and evaluate a series of evenly spaced map domain values. `glEvalPoint'
can be used to evaluate a single grid point in the same gridspace that
-is traversed by `glEvalMesh'. Calling `glEvalPoint1' is equivalent to
+is traversed by `glEvalMesh'. Calling `glEvalPoint1' is equivalent to
calling where ΔU=(U_2-U_1,)/N
);
and N , U_1 , and U_2 are the arguments to the most recent `glMapGrid1'
-command. The one absolute numeric requirement is that if I=N , then the
+command. The one absolute numeric requirement is that if I=N , then the
value computed from I·ΔU+U_1 is exactly U_2 .
In the two-dimensional case, `glEvalPoint2', let
ΔU=(U_2-U_1,)/N ΔV=(V_2-V_1,)/M
where N , U_1 , U_2 , M , V_1 , and V_2 are the arguments to the most
-recent `glMapGrid2' command. Then the `glEvalPoint2' command is
+recent `glMapGrid2' command. Then the `glEvalPoint2' command is
equivalent to calling The only absolute numeric requirements are that if
I=N , then the value computed from I·ΔU+U_1 is exactly U_2 , and if J=M
, then the value computed from J·ΔV+V_1 is exactly V_2 .
TYPE
Specifies a symbolic constant that describes the information that
- will be returned for each vertex. `GL_2D', `GL_3D', `GL_3D_COLOR',
+ will be returned for each vertex. `GL_2D', `GL_3D', `GL_3D_COLOR',
`GL_3D_COLOR_TEXTURE', and `GL_4D_COLOR_TEXTURE' are accepted.
BUFFER
Returns the feedback data.
-The `glFeedbackBuffer' function controls feedback. Feedback, like
-selection, is a GL mode. The mode is selected by calling `glRenderMode'
-with `GL_FEEDBACK'. When the GL is in feedback mode, no pixels are
-produced by rasterization. Instead, information about primitives that
+The `glFeedbackBuffer' function controls feedback. Feedback, like
+selection, is a GL mode. The mode is selected by calling `glRenderMode'
+with `GL_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.
`glFeedbackBuffer' has three arguments: BUFFER is a pointer to an array
-of floating-point values into which feedback information is placed. SIZE
-indicates the size of the array. TYPE is a symbolic constant describing
-the information that is fed back for each vertex. `glFeedbackBuffer'
+of floating-point values into which feedback information is placed. SIZE
+indicates the size of the array. TYPE is a symbolic constant describing
+the information that is fed back for each vertex. `glFeedbackBuffer'
must be issued before feedback mode is enabled (by calling
-`glRenderMode' with argument `GL_FEEDBACK'). Setting `GL_FEEDBACK'
+`glRenderMode' with argument `GL_FEEDBACK'). Setting `GL_FEEDBACK'
without establishing the feedback buffer, or calling `glFeedbackBuffer'
while the GL is in feedback mode, is an error.
When `glRenderMode' 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 SIZE. If the feedback data required more room than was
-available in BUFFER, `glRenderMode' returns a negative value. To take
+array pointer to the base of the feedback buffer. The returned value
+never exceeds SIZE. If the feedback data required more room than was
+available in BUFFER, `glRenderMode' returns a negative value. To take
the GL out of feedback mode, call `glRenderMode' with a parameter value
other than `GL_FEEDBACK'.
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
+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
+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
+that describe the primitive's vertices and associated data. Entries are
+also written for bitmaps and pixel rectangles. Feedback occurs after
polygon culling and `glPolygonMode' 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
+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.
The `glPassThrough' command can be used to insert a marker into the
-feedback buffer. See `glPassThrough'.
+feedback buffer. See `glPassThrough'.
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 TYPE. Colors
+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 TYPE. Colors
are fed back as four values in RGBA mode and one value in color index
mode.
value value index ← value tex ← value value value value
VALUE is a floating-point number, and N is a floating-point integer
-giving the number of vertices in the polygon. `GL_POINT_TOKEN',
+giving the number of vertices in the polygon. `GL_POINT_TOKEN',
`GL_LINE_TOKEN', `GL_LINE_RESET_TOKEN', `GL_POLYGON_TOKEN',
`GL_BITMAP_TOKEN', `GL_DRAW_PIXEL_TOKEN', `GL_COPY_PIXEL_TOKEN' and
`GL_PASS_THROUGH_TOKEN' are symbolic floating-point constants.
`GL_LINE_RESET_TOKEN' is returned whenever the line stipple pattern is
-reset. The data returned as a vertex depends on the feedback TYPE.
+reset. The data returned as a vertex depends on the feedback TYPE.
The following table gives the correspondence between TYPE and the number
-of values per vertex. K is 1 in color index mode and 4 in RGBA mode.
+of values per vertex. K is 1 in color index mode and 4 in RGBA mode.
X, Y, Z, W, K , 4 , 8+K
Feedback vertex coordinates are in window coordinates, except W, 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
+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.
`GL_INVALID_ENUM' is generated if TYPE is not an accepted value.
"Block until all GL execution is complete.
`glFinish' 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
+commands are complete. Such effects include all changes to GL state, all
+changes to connection state, and all changes to the frame buffer
contents.
`GL_INVALID_OPERATION' is generated if `glFinish' is executed between
Different GL implementations buffer commands in several different
locations, including network buffers and the graphics accelerator
-itself. `glFlush' empties all of these buffers, causing all issued
+itself. `glFlush' 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
+rendering engine. Though this execution may not be completed in any
particular time period, it does complete in finite time.
Because any GL program might be executed over a network, or on an
accelerator that buffers commands, all programs should call `glFlush'
whenever they count on having all of their previously issued commands
-completed. For example, call `glFlush' before waiting for user input
+completed. For example, call `glFlush' before waiting for user input
that depends on the generated image.
`GL_INVALID_OPERATION' is generated if `glFlush' is executed between the
"Define an array of fog coordinates.
TYPE
- Specifies the data type of each fog coordinate. Symbolic constants
- `GL_FLOAT', or `GL_DOUBLE' are accepted. The initial value is
+ Specifies the data type of each fog coordinate. Symbolic constants
+ `GL_FLOAT', or `GL_DOUBLE' are accepted. The initial value is
`GL_FLOAT'.
STRIDE
- Specifies the byte offset between consecutive fog coordinates. If
+ Specifies the byte offset between consecutive fog coordinates. If
STRIDE is 0, the array elements are understood to be tightly
- packed. The initial value is 0.
+ packed. The initial value is 0.
POINTER
Specifies a pointer to the first coordinate of the first fog
- coordinate in the array. The initial value is 0.
+ coordinate in the array. The initial value is 0.
`glFogCoordPointer' specifies the location and data format of an array
-of fog coordinates to use when rendering. TYPE specifies the data type
+of fog coordinates to use when rendering. TYPE specifies the data type
of each fog coordinate, and STRIDE specifies the byte stride from one
fog coordinate to the next, allowing vertices and attributes to be
packed into a single array or stored in separate arrays.
To enable and disable the fog coordinate array, call
`glEnableClientState' and `glDisableClientState' with the argument
-`GL_FOG_COORD_ARRAY'. If enabled, the fog coordinate array is used when
+`GL_FOG_COORD_ARRAY'. If enabled, the fog coordinate array is used when
`glDrawArrays', `glMultiDrawArrays', `glDrawElements',
`glMultiDrawElements', `glDrawRangeElements', or `glArrayElement' is
called.
Specify the fog distance.
`glFogCoord' specifies the fog coordinate that is associated with each
-vertex and the current raster position. The value specified is
+vertex and the current raster position. The value specified is
interpolated and used in computing the fog color (see `glFog').")
(define-gl-procedures
"Specify fog parameters.
PNAME
- Specifies a single-valued fog parameter. `GL_FOG_MODE',
+ Specifies a single-valued fog parameter. `GL_FOG_MODE',
`GL_FOG_DENSITY', `GL_FOG_START', `GL_FOG_END', `GL_FOG_INDEX', and
`GL_FOG_COORD_SRC' are accepted.
PARAM
Specifies the value that PNAME will be set to.
-Fog is initially disabled. While enabled, fog affects rasterized
-geometry, bitmaps, and pixel blocks, but not buffer clear operations. To
+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 `glEnable' and `glDisable' with argument
`GL_FOG'.
`glFog' assigns the value or values in PARAMS to the fog parameter
-specified by PNAME. The following values are accepted for PNAME:
+specified by PNAME. The following values are accepted for PNAME:
`GL_FOG_MODE'
PARAMS is a single integer or floating-point value that specifies
- the equation to be used to compute the fog blend factor, F . Three
+ the equation to be used to compute the fog blend factor, F . Three
symbolic constants are accepted: `GL_LINEAR', `GL_EXP', and
- `GL_EXP2'. The equations corresponding to these symbolic constants
- are defined below. The initial fog mode is `GL_EXP'.
+ `GL_EXP2'. The equations corresponding to these symbolic constants
+ are defined below. The initial fog mode is `GL_EXP'.
`GL_FOG_DENSITY'
PARAMS 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.
+ Only nonnegative densities are accepted. The initial fog density is
+ 1.
`GL_FOG_START'
PARAMS is a single integer or floating-point value that specifies
- START , the near distance used in the linear fog equation. The
+ START , the near distance used in the linear fog equation. The
initial near distance is 0.
`GL_FOG_END'
PARAMS 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.
+ END , the far distance used in the linear fog equation. The initial
+ far distance is 1.
`GL_FOG_INDEX'
PARAMS is a single integer or floating-point value that specifies
- I_F , the fog color index. The initial fog index is 0.
+ I_F , the fog color index. The initial fog index is 0.
`GL_FOG_COLOR'
PARAMS contains four integer or floating-point values that specify
- C_F , the fog color. Integer values are mapped linearly such that
+ C_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).
+ 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).
`GL_FOG_COORD_SRC'
PARAMS contains either of the following symbolic constants:
- `GL_FOG_COORD' or `GL_FRAGMENT_DEPTH'. `GL_FOG_COORD' specifies
+ `GL_FOG_COORD' or `GL_FRAGMENT_DEPTH'. `GL_FOG_COORD' specifies
that the current fog coordinate should be used as distance value in
- the fog color computation. `GL_FRAGMENT_DEPTH' specifies that the
+ the fog color computation. `GL_FRAGMENT_DEPTH' specifies that the
current fragment depth should be used as distance value in the fog
computation.
Fog blends a fog color with each rasterized pixel fragment's
-post-texturing color using a blending factor F . Factor F is computed
-in one of three ways, depending on the fog mode. Let C be either the
+post-texturing color using a blending factor F . Factor F is computed in
+one of three ways, depending on the fog mode. Let C be either the
distance in eye coordinate from the origin (in the case that the
`GL_FOG_COORD_SRC' is `GL_FRAGMENT_DEPTH') or the current fog coordinate
-(in the case that `GL_FOG_COORD_SRC' is `GL_FOG_COORD'). The equation
+(in the case that `GL_FOG_COORD_SRC' is `GL_FOG_COORD'). The equation
for `GL_LINEAR' fog is F=END-C,/END-START,
The equation for `GL_EXP' fog is F=E^-(DENSITY·C,),
The equation for `GL_EXP2' fog is F=E^-(DENSITY·C,),^2
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,
+computed. Then, if the GL is in RGBA color mode, the fragment's red,
green, and blue colors, represented by C_R , are replaced by
C_R,^″=F×C_R+(1-F,)×C_F
"Define front- and back-facing polygons.
MODE
- Specifies the orientation of front-facing polygons. `GL_CW' and
- `GL_CCW' are accepted. The initial value is `GL_CCW'.
+ Specifies the orientation of front-facing polygons. `GL_CW' and
+ `GL_CCW' are accepted. The initial value is `GL_CCW'.
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 `glEnable'
-and `glDisable' with argument `GL_CULL_FACE'.
+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 `glEnable' and
+`glDisable' with argument `GL_CULL_FACE'.
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
+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.
`glFrontFace' specifies whether polygons with clockwise winding in
window coordinates, or counterclockwise winding in window coordinates,
-are taken to be front-facing. Passing `GL_CCW' to MODE selects
+are taken to be front-facing. Passing `GL_CCW' to MODE selects
counterclockwise polygons as front-facing; `GL_CW' selects clockwise
-polygons as front-facing. By default, counterclockwise polygons are
+polygons as front-facing. By default, counterclockwise polygons are
taken to be front-facing.
`GL_INVALID_ENUM' is generated if MODE is not an accepted value.
Both distances must be positive.
`glFrustum' describes a perspective matrix that produces a perspective
-projection. The current matrix (see `glMatrixMode') is multiplied by
+projection. The current matrix (see `glMatrixMode') is multiplied by
this matrix and the result replaces the current matrix, as if
`glMultMatrix' were called with the following matrix as its argument:
Typically, the matrix mode is `GL_PROJECTION', and (LEFT,BOTTOM-NEARVAL)
and (RIGHT,TOP-NEARVAL) 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). -FARVAL specifies the
-location of the far clipping plane. Both NEARVAL and FARVAL must be
+assuming that the eye is located at (0, 0, 0). -FARVAL specifies the
+location of the far clipping plane. Both NEARVAL and FARVAL must be
positive.
Use `glPushMatrix' and `glPopMatrix' to save and restore the current
Specifies an array in which the generated buffer object names are
stored.
-`glGenBuffers' returns N buffer object names in BUFFERS. There is no
+`glGenBuffers' returns N buffer object names in BUFFERS. 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 `glGenBuffers'.
Specifies the number of contiguous empty display lists to be
generated.
-`glGenLists' has one argument, RANGE. It returns an integer N such that
+`glGenLists' has one argument, RANGE. It returns an integer N such that
RANGE contiguous empty display lists, named N , N+1 , ... , N+RANGE-1 ,
-are created. If RANGE is 0, if there is no group of RANGE contiguous
+are created. If RANGE is 0, if there is no group of RANGE contiguous
names available, or if any error is generated, no display lists are
generated, and 0 is returned.
Specifies an array in which the generated query object names are
stored.
-`glGenQueries' returns N query object names in IDS. There is no
+`glGenQueries' returns N query object names in IDS. 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 `glGenQueries'.
TEXTURES
Specifies an array in which the generated texture names are stored.
-`glGenTextures' returns N texture names in TEXTURES. There is no
+`glGenTextures' returns N texture names in TEXTURES. 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 `glGenTextures'.
attribute variable.
`glGetActiveAttrib' returns information about an active attribute
-variable in the program object specified by PROGRAM. The number of
+variable in the program object specified by PROGRAM. The number of
active attributes can be obtained by calling `glGetProgram' with the
-value `GL_ACTIVE_ATTRIBUTES'. A value of 0 for INDEX selects the first
-active attribute variable. Permissible values for INDEX range from 0 to
+value `GL_ACTIVE_ATTRIBUTES'. A value of 0 for INDEX selects the first
+active attribute variable. Permissible values for INDEX range from 0 to
the number of active attribute variables minus 1.
A vertex shader may use either built-in attribute variables,
-user-defined attribute variables, or both. Built-in attribute variables
+user-defined attribute variables, or both. Built-in attribute variables
have a prefix of \"gl_\" and reference conventional OpenGL vertex
attribtes (e.g., GL_VERTEX, GL_NORMAL, etc., see the OpenGL Shading
Language specification for a complete list.) User-defined attribute
variables have arbitrary names and obtain their values through numbered
-generic vertex attributes. An attribute variable (either built-in or
+generic vertex attributes. An attribute variable (either built-in or
user-defined) is considered active if it is determined during the link
-operation that it may be accessed during program execution. Therefore,
+operation that it may be accessed during program execution. Therefore,
PROGRAM should have previously been the target of a call to
`glLinkProgram', but it is not necessary for it to have been linked
successfully.
The size of the character buffer required to store the longest attribute
variable name in PROGRAM can be obtained by calling `glGetProgram' with
-the value `GL_ACTIVE_ATTRIBUTE_MAX_LENGTH'. This value should be used
-to allocate a buffer of sufficient size to store the returned attribute
-name. The size of this character buffer is passed in BUFSIZE, and a
+the value `GL_ACTIVE_ATTRIBUTE_MAX_LENGTH'. This value should be used to
+allocate a buffer of sufficient size to store the returned attribute
+name. The size of this character buffer is passed in BUFSIZE, and a
pointer to this character buffer is passed in NAME.
`glGetActiveAttrib' returns the name of the attribute variable indicated
-by INDEX, storing it in the character buffer specified by NAME. The
-string returned will be null terminated. The actual number of
-characters written into this buffer is returned in LENGTH, and this
-count does not include the null termination character. If the length of
-the returned string is not required, a value of `NULL' can be passed in
-the LENGTH argument.
+by INDEX, storing it in the character buffer specified by NAME. The
+string returned will be null terminated. The actual number of characters
+written into this buffer is returned in LENGTH, and this count does not
+include the null termination character. If the length of the returned
+string is not required, a value of `NULL' can be passed in the LENGTH
+argument.
The TYPE argument will return a pointer to the attribute variable's data
-type. The symbolic constants `GL_FLOAT', `GL_FLOAT_VEC2',
+type. The symbolic constants `GL_FLOAT', `GL_FLOAT_VEC2',
`GL_FLOAT_VEC3', `GL_FLOAT_VEC4', `GL_FLOAT_MAT2', `GL_FLOAT_MAT3',
`GL_FLOAT_MAT4', `GL_FLOAT_MAT2x3', `GL_FLOAT_MAT2x4',
`GL_FLOAT_MAT3x2', `GL_FLOAT_MAT3x4', `GL_FLOAT_MAT4x2', or
-`GL_FLOAT_MAT4x3' may be returned. The SIZE argument will return the
+`GL_FLOAT_MAT4x3' may be returned. The SIZE argument will return the
size of the attribute, in units of the type returned in TYPE.
The list of active attribute variables may include both built-in
user-defined attribute variable names.
This function will return as much information as it can about the
-specified active attribute variable. If no information is available,
-LENGTH will be 0, and NAME will be an empty string. This situation
-could occur if this function is called after a link operation that
-failed. If an error occurs, the return values LENGTH, SIZE, TYPE, and
-NAME will be unmodified.
+specified active attribute variable. If no information is available,
+LENGTH will be 0, and NAME will be an empty string. This situation could
+occur if this function is called after a link operation that failed. If
+an error occurs, the return values LENGTH, SIZE, TYPE, and NAME will be
+unmodified.
`GL_INVALID_VALUE' is generated if PROGRAM is not a value generated by
OpenGL.
variable.
`glGetActiveUniform' returns information about an active uniform
-variable in the program object specified by PROGRAM. The number of
+variable in the program object specified by PROGRAM. The number of
active uniform variables can be obtained by calling `glGetProgram' with
-the value `GL_ACTIVE_UNIFORMS'. A value of 0 for INDEX selects the
-first active uniform variable. Permissible values for INDEX range from
-0 to the number of active uniform variables minus 1.
+the value `GL_ACTIVE_UNIFORMS'. A value of 0 for INDEX selects the first
+active uniform variable. Permissible values for INDEX range from 0 to
+the number of active uniform variables minus 1.
Shaders may use either built-in uniform variables, user-defined uniform
-variables, or both. Built-in uniform variables have a prefix of \"gl_\"
+variables, or both. Built-in uniform variables have a prefix of \"gl_\"
and reference existing OpenGL state or values derived from such state
(e.g., GL_FOG, GL_MODELVIEWMATRIX, etc., see the OpenGL Shading Language
specification for a complete list.) User-defined uniform variables have
arbitrary names and obtain their values from the application through
-calls to `glUniform'. A uniform variable (either built-in or
+calls to `glUniform'. A uniform variable (either built-in or
user-defined) is considered active if it is determined during the link
-operation that it may be accessed during program execution. Therefore,
+operation that it may be accessed during program execution. Therefore,
PROGRAM should have previously been the target of a call to
`glLinkProgram', but it is not necessary for it to have been linked
successfully.
The size of the character buffer required to store the longest uniform
variable name in PROGRAM can be obtained by calling `glGetProgram' with
-the value `GL_ACTIVE_UNIFORM_MAX_LENGTH'. This value should be used to
+the value `GL_ACTIVE_UNIFORM_MAX_LENGTH'. This value should be used to
allocate a buffer of sufficient size to store the returned uniform
-variable name. The size of this character buffer is passed in BUFSIZE,
+variable name. The size of this character buffer is passed in BUFSIZE,
and a pointer to this character buffer is passed in NAME.
`glGetActiveUniform' returns the name of the uniform variable indicated
-by INDEX, storing it in the character buffer specified by NAME. The
-string returned will be null terminated. The actual number of
-characters written into this buffer is returned in LENGTH, and this
-count does not include the null termination character. If the length of
-the returned string is not required, a value of `NULL' can be passed in
-the LENGTH argument.
+by INDEX, storing it in the character buffer specified by NAME. The
+string returned will be null terminated. The actual number of characters
+written into this buffer is returned in LENGTH, and this count does not
+include the null termination character. If the length of the returned
+string is not required, a value of `NULL' can be passed in the LENGTH
+argument.
The TYPE argument will return a pointer to the uniform variable's data
-type. The symbolic constants `GL_FLOAT', `GL_FLOAT_VEC2',
+type. The symbolic constants `GL_FLOAT', `GL_FLOAT_VEC2',
`GL_FLOAT_VEC3', `GL_FLOAT_VEC4', `GL_INT', `GL_INT_VEC2',
`GL_INT_VEC3', `GL_INT_VEC4', `GL_BOOL', `GL_BOOL_VEC2', `GL_BOOL_VEC3',
`GL_BOOL_VEC4', `GL_FLOAT_MAT2', `GL_FLOAT_MAT3', `GL_FLOAT_MAT4',
If one or more elements of an array are active, the name of the array is
returned in NAME, the type is returned in TYPE, and the SIZE parameter
returns the highest array element index used, plus one, as determined by
-the compiler and/or linker. Only one active uniform variable will be
+the compiler and/or linker. Only one active uniform variable will be
reported for a uniform array.
Uniform variables that are declared as structures or arrays of
-structures will not be returned directly by this function. Instead,
-each of these uniform variables will be reduced to its fundamental
-components containing the \".\" and \"[]\" operators such that each of the
-names is valid as an argument to `glGetUniformLocation'. Each of these
-reduced uniform variables is counted as one active uniform variable and
-is assigned an index. A valid name cannot be a structure, an array of
+structures will not be returned directly by this function. Instead, each
+of these uniform variables will be reduced to its fundamental components
+containing the \".\" and \"[]\" operators such that each of the names is
+valid as an argument to `glGetUniformLocation'. Each of these reduced
+uniform variables is counted as one active uniform variable and is
+assigned an index. A valid name cannot be a structure, an array of
structures, or a subcomponent of a vector or matrix.
-The size of the uniform variable will be returned in SIZE. Uniform
-variables other than arrays will have a size of 1. Structures and
-arrays of structures will be reduced as described earlier, such that
-each of the names returned will be a data type in the earlier list. If
-this reduction results in an array, the size returned will be as
-described for uniform arrays; otherwise, the size returned will be 1.
+The size of the uniform variable will be returned in SIZE. Uniform
+variables other than arrays will have a size of 1. Structures and arrays
+of structures will be reduced as described earlier, such that each of
+the names returned will be a data type in the earlier list. If this
+reduction results in an array, the size returned will be as described
+for uniform arrays; otherwise, the size returned will be 1.
The list of active uniform variables may include both built-in uniform
variables (which begin with the prefix \"gl_\") as well as user-defined
uniform variable names.
This function will return as much information as it can about the
-specified active uniform variable. If no information is available,
-LENGTH will be 0, and NAME will be an empty string. This situation
-could occur if this function is called after a link operation that
-failed. If an error occurs, the return values LENGTH, SIZE, TYPE, and
-NAME will be unmodified.
+specified active uniform variable. If no information is available,
+LENGTH will be 0, and NAME will be an empty string. This situation could
+occur if this function is called after a link operation that failed. If
+an error occurs, the return values LENGTH, SIZE, TYPE, and NAME will be
+unmodified.
`GL_INVALID_VALUE' is generated if PROGRAM is not a value generated by
OpenGL.
shader objects.
`glGetAttachedShaders' returns the names of the shader objects attached
-to PROGRAM. The names of shader objects that are attached to PROGRAM
-will be returned in SHADERS. The actual number of shader names written
-into SHADERS is returned in COUNT. If no shader objects are attached to
-PROGRAM, COUNT is set to 0. The maximum number of shader names that may
+to PROGRAM. The names of shader objects that are attached to PROGRAM
+will be returned in SHADERS. The actual number of shader names written
+into SHADERS is returned in COUNT. If no shader objects are attached to
+PROGRAM, COUNT is set to 0. The maximum number of shader names that may
be returned in SHADERS is specified by MAXCOUNT.
If the number of names actually returned is not required (for instance,
if it has just been obtained by calling `glGetProgram'), a value of
-`NULL' may be passed for count. If no shader objects are attached to
-PROGRAM, a value of 0 will be returned in COUNT. The actual number of
+`NULL' may be passed for count. If no shader objects are attached to
+PROGRAM, a value of 0 will be returned in COUNT. The actual number of
attached shaders can be obtained by calling `glGetProgram' with the
value `GL_ATTACHED_SHADERS'.
`glGetAttribLocation' queries the previously linked program object
specified by PROGRAM for the attribute variable specified by NAME and
returns the index of the generic vertex attribute that is bound to that
-attribute variable. If NAME is a matrix attribute variable, the index
-of the first column of the matrix is returned. If the named attribute
+attribute variable. If NAME is a matrix attribute variable, the index of
+the first column of the matrix is returned. If the named attribute
variable is not an active attribute in the specified program object or
if NAME starts with the reserved prefix \"gl_\", a value of -1 is
returned.
The association between an attribute variable name and a generic
attribute index can be specified at any time by calling
-`glBindAttribLocation'. Attribute bindings do not go into effect until
-`glLinkProgram' is called. After a program object has been linked
+`glBindAttribLocation'. Attribute bindings do not go into effect until
+`glLinkProgram' is called. After a program object has been linked
successfully, the index values for attribute variables remain fixed
-until the next link command occurs. The attribute values can only be
-queried after a link if the link was successful. `glGetAttribLocation'
+until the next link command occurs. The attribute values can only be
+queried after a link if the link was successful. `glGetAttribLocation'
returns the binding that actually went into effect the last time
-`glLinkProgram' was called for the specified program object. Attribute
+`glLinkProgram' was called for the specified program object. Attribute
bindings that have been specified since the last link operation are not
returned by `glGetAttribLocation'.
"Return parameters of a buffer object.
TARGET
- Specifies the target buffer object. The symbolic constant must be
+ Specifies the target buffer object. The symbolic constant must be
`GL_ARRAY_BUFFER', `GL_ELEMENT_ARRAY_BUFFER',
`GL_PIXEL_PACK_BUFFER', or `GL_PIXEL_UNPACK_BUFFER'.
VALUE
- Specifies the symbolic name of a buffer object parameter. Accepted
+ Specifies the symbolic name of a buffer object parameter. Accepted
values are `GL_BUFFER_ACCESS', `GL_BUFFER_MAPPED',
`GL_BUFFER_SIZE', or `GL_BUFFER_USAGE'.
`GL_BUFFER_ACCESS'
PARAMS returns the access policy set while mapping the buffer
- object. The initial value is `GL_READ_WRITE'.
+ object. The initial value is `GL_READ_WRITE'.
`GL_BUFFER_MAPPED'
PARAMS returns a flag indicating whether the buffer object is
- currently mapped. The initial value is `GL_FALSE'.
+ currently mapped. The initial value is `GL_FALSE'.
`GL_BUFFER_SIZE'
PARAMS returns the size of the buffer object, measured in bytes.
The initial value is 0.
`GL_BUFFER_USAGE'
- PARAMS returns the buffer object's usage pattern. The initial
- value is `GL_STATIC_DRAW'.
+ PARAMS returns the buffer object's usage pattern. The initial value
+ is `GL_STATIC_DRAW'.
`GL_INVALID_ENUM' is generated if TARGET or VALUE is not an accepted
value.
"Return the pointer to a mapped buffer object's data store.
TARGET
- Specifies the target buffer object. The symbolic constant must be
+ Specifies the target buffer object. The symbolic constant must be
`GL_ARRAY_BUFFER', `GL_ELEMENT_ARRAY_BUFFER',
`GL_PIXEL_PACK_BUFFER', or `GL_PIXEL_UNPACK_BUFFER'.
PNAME
- Specifies the pointer to be returned. The symbolic constant must
- be `GL_BUFFER_MAP_POINTER'.
+ Specifies the pointer to be returned. The symbolic constant must be
+ `GL_BUFFER_MAP_POINTER'.
PARAMS
Returns the pointer value specified by PNAME.
-`glGetBufferPointerv' returns pointer information. PNAME is a symbolic
+`glGetBufferPointerv' returns pointer information. PNAME is a symbolic
constant indicating the pointer to be returned, which must be
`GL_BUFFER_MAP_POINTER', the pointer to which the buffer object's data
-store is mapped. If the data store is not currently mapped, `NULL' is
-returned. PARAMS is a pointer to a location in which to place the
+store is mapped. If the data store is not currently mapped, `NULL' is
+returned. PARAMS is a pointer to a location in which to place the
returned pointer value.
`GL_INVALID_ENUM' is generated if TARGET or PNAME is not an accepted
"Returns a subset of a buffer object's data store.
TARGET
- Specifies the target buffer object. The symbolic constant must be
+ Specifies the target buffer object. The symbolic constant must be
`GL_ARRAY_BUFFER', `GL_ELEMENT_ARRAY_BUFFER',
`GL_PIXEL_PACK_BUFFER', or `GL_PIXEL_UNPACK_BUFFER'.
returned.
`glGetBufferSubData' returns some or all of the data from the buffer
-object currently bound to TARGET. Data starting at byte offset OFFSET
+object currently bound to TARGET. Data starting at byte offset OFFSET
and extending for SIZE bytes is copied from the data store to the memory
-pointed to by DATA. An error is thrown if the buffer object is
-currently mapped, or if OFFSET and SIZE together define a range beyond
-the bounds of the buffer object's data store.
+pointed to by DATA. An error is thrown if the buffer object is currently
+mapped, or if OFFSET and SIZE together define a range beyond the bounds
+of the buffer object's data store.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_ARRAY_BUFFER',
`GL_ELEMENT_ARRAY_BUFFER', `GL_PIXEL_PACK_BUFFER', or
"Return the coefficients of the specified clipping plane.
PLANE
- Specifies a clipping plane. The number of clipping planes depends
+ 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
+ supported. They are identified by symbolic names of the form
`GL_CLIP_PLANE' I where i ranges from 0 to the value of
`GL_MAX_CLIP_PLANES' - 1.
EQUATION
Returns four double-precision values that are the coefficients of
- the plane equation of PLANE in eye coordinates. The initial value
+ the plane equation of PLANE in eye coordinates. The initial value
is (0, 0, 0, 0).
`glGetClipPlane' returns in EQUATION the four coefficients of the plane
"Get color lookup table parameters.
TARGET
- The target color table. Must be `GL_COLOR_TABLE',
+ The target color table. Must be `GL_COLOR_TABLE',
`GL_POST_CONVOLUTION_COLOR_TABLE',
`GL_POST_COLOR_MATRIX_COLOR_TABLE', `GL_PROXY_COLOR_TABLE',
`GL_PROXY_POST_CONVOLUTION_COLOR_TABLE', or
`GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE'.
PNAME
- The symbolic name of a color lookup table parameter. Must be one
- of `GL_COLOR_TABLE_BIAS', `GL_COLOR_TABLE_SCALE',
+ The symbolic name of a color lookup table parameter. Must be one of
+ `GL_COLOR_TABLE_BIAS', `GL_COLOR_TABLE_SCALE',
`GL_COLOR_TABLE_FORMAT', `GL_COLOR_TABLE_WIDTH',
`GL_COLOR_TABLE_RED_SIZE', `GL_COLOR_TABLE_GREEN_SIZE',
`GL_COLOR_TABLE_BLUE_SIZE', `GL_COLOR_TABLE_ALPHA_SIZE',
When PNAME is set to `GL_COLOR_TABLE_SCALE' or `GL_COLOR_TABLE_BIAS',
`glGetColorTableParameter' returns the color table scale or bias
-parameters for the table specified by TARGET. For these queries, TARGET
+parameters for the table specified by TARGET. For these queries, TARGET
must be set to `GL_COLOR_TABLE', `GL_POST_CONVOLUTION_COLOR_TABLE', or
`GL_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.
`glGetColorTableParameter' 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
+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 `glColorTable'.
The following table lists the format and size parameters that may be
-queried. For each symbolic constant listed below for PNAME, PARAMS must
+queried. For each symbolic constant listed below for PNAME, PARAMS must
point to an array of the given length and receive the values indicated.
`GL_POST_COLOR_MATRIX_COLOR_TABLE'.
FORMAT
- The format of the pixel data in TABLE. The possible values are
+ The format of the pixel data in TABLE. The possible values are
`GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA', `GL_LUMINANCE',
`GL_LUMINANCE_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', and `GL_BGRA'.
TYPE
- The type of the pixel data in TABLE. Symbolic constants
+ The type of the pixel data in TABLE. Symbolic constants
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
contents of the color table.
`glGetColorTable' returns in TABLE the contents of the color table
-specified by TARGET. No pixel transfer operations are performed, but
+specified by TARGET. No pixel transfer operations are performed, but
pixel storage modes that are applicable to `glReadPixels' are performed.
If a non-zero named buffer object is bound to the `GL_PIXEL_PACK_BUFFER'
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
+returned as zero. The assignments of internal color components to the
components requested by FORMAT are
*Internal Component*
"Return a compressed texture image.
TARGET
- Specifies which texture is to be obtained. `GL_TEXTURE_1D',
+ Specifies which texture is to be obtained. `GL_TEXTURE_1D',
`GL_TEXTURE_2D', and
`GL_TEXTURE_3D'`GL_TEXTURE_CUBE_MAP_POSITIVE_X',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_X', `GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
and `GL_TEXTURE_CUBE_MAP_NEGATIVE_Z' are accepted.
LOD
- 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
+ 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.
IMG
Returns the compressed texture image.
`glGetCompressedTexImage' returns the compressed texture image
-associated with TARGET and LOD into IMG. IMG should be an array of
-`GL_TEXTURE_COMPRESSED_IMAGE_SIZE' bytes. TARGET specifies whether the
+associated with TARGET and LOD into IMG. IMG should be an array of
+`GL_TEXTURE_COMPRESSED_IMAGE_SIZE' bytes. TARGET specifies whether the
desired texture image was one specified by `glTexImage1D'
(`GL_TEXTURE_1D'), `glTexImage2D' (`GL_TEXTURE_2D' or any of
-`GL_TEXTURE_CUBE_MAP_*'), or `glTexImage3D' (`GL_TEXTURE_3D'). LOD
+`GL_TEXTURE_CUBE_MAP_*'), or `glTexImage3D' (`GL_TEXTURE_3D'). LOD
specifies the level-of-detail number of the desired image.
If a non-zero named buffer object is bound to the `GL_PIXEL_PACK_BUFFER'
If the texture is compressed, then determine the amount of memory
required to store the compressed texture by calling
`glGetTexLevelParameter' with argument
-`GL_TEXTURE_COMPRESSED_IMAGE_SIZE'. Finally, retrieve the internal
+`GL_TEXTURE_COMPRESSED_IMAGE_SIZE'. Finally, retrieve the internal
format of the texture by calling `glGetTexLevelParameter' with argument
-`GL_TEXTURE_INTERNAL_FORMAT'. To store the texture for later use,
+`GL_TEXTURE_INTERNAL_FORMAT'. To store the texture for later use,
associate the internal format and size with the retrieved texture image.
These data can be used by the respective texture or subtexture loading
routine used for loading TARGET textures.
"Get current 1D or 2D convolution filter kernel.
TARGET
- The filter to be retrieved. Must be one of `GL_CONVOLUTION_1D' or
+ The filter to be retrieved. Must be one of `GL_CONVOLUTION_1D' or
`GL_CONVOLUTION_2D'.
FORMAT
- Format of the output image. Must be one of `GL_RED', `GL_GREEN',
+ Format of the output image. Must be one of `GL_RED', `GL_GREEN',
`GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', `GL_BGRA',
`GL_LUMINANCE', or `GL_LUMINANCE_ALPHA'.
TYPE
- Data type of components in the output image. Symbolic constants
+ Data type of components in the output image. Symbolic constants
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
Pointer to storage for the output image.
`glGetConvolutionFilter' 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.
+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.
If a non-zero named buffer object is bound to the `GL_PIXEL_PACK_BUFFER'
target (see `glBindBuffer') while a convolution filter is requested,
IMAGE is treated as a byte offset into the buffer object's data store.
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 format of the filter are returned as zero. The assignments of
internal color components to the components of FORMAT are as follows.
*Internal Component*
"Get convolution parameters.
TARGET
- The filter whose parameters are to be retrieved. Must be one of
+ The filter whose parameters are to be retrieved. Must be one of
`GL_CONVOLUTION_1D', `GL_CONVOLUTION_2D', or `GL_SEPARABLE_2D'.
PNAME
- The parameter to be retrieved. Must be one of
+ The parameter to be retrieved. Must be one of
`GL_CONVOLUTION_BORDER_MODE', `GL_CONVOLUTION_BORDER_COLOR',
`GL_CONVOLUTION_FILTER_SCALE', `GL_CONVOLUTION_FILTER_BIAS',
`GL_CONVOLUTION_FORMAT', `GL_CONVOLUTION_WIDTH',
PARAMS
Pointer to storage for the parameters to be retrieved.
-`glGetConvolutionParameter' retrieves convolution parameters. TARGET
-determines which convolution filter is queried. PNAME determines which
+`glGetConvolutionParameter' retrieves convolution parameters. TARGET
+determines which convolution filter is queried. PNAME determines which
parameter is returned:
`GL_CONVOLUTION_BORDER_MODE'
- The convolution border mode. See `glConvolutionParameter' for a
+ The convolution border mode. See `glConvolutionParameter' for a
list of border modes.
`GL_CONVOLUTION_BORDER_COLOR'
- The current convolution border color. PARAMS must be a pointer to
+ 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.
`GL_CONVOLUTION_FILTER_SCALE'
- The current filter scale factors. PARAMS must be a pointer to an
+ 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.
`GL_CONVOLUTION_FILTER_BIAS'
- The current filter bias factors. PARAMS must be a pointer to an
+ 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.
`GL_CONVOLUTION_FORMAT'
- The current internal format. See `glConvolutionFilter1D',
+ The current internal format. See `glConvolutionFilter1D',
`glConvolutionFilter2D', and `glSeparableFilter2D' for lists of
allowable formats.
((glGetError -> GLenum))
"Return error information.
-`glGetError' 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
+`glGetError' 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 `glGetError' is called, the error code is returned,
-and the flag is reset to `GL_NO_ERROR'. If a call to `glGetError'
+and the flag is reset to `GL_NO_ERROR'. If a call to `glGetError'
returns `GL_NO_ERROR', there has been no detectable error since the last
call to `glGetError', or since the GL was initialized.
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 `GL_NO_ERROR' when
-`glGetError' is called. If more than one flag has recorded an error,
-`glGetError' returns and clears an arbitrary error flag value. Thus,
+flags. If any single error flag has recorded an error, the value of that
+flag is returned and that flag is reset to `GL_NO_ERROR' when
+`glGetError' is called. If more than one flag has recorded an error,
+`glGetError' returns and clears an arbitrary error flag value. Thus,
`glGetError' should always be called in a loop, until it returns
`GL_NO_ERROR', if all error flags are to be reset.
The following errors are currently defined:
`GL_NO_ERROR'
- No error has been recorded. The value of this symbolic constant is
+ No error has been recorded. The value of this symbolic constant is
guaranteed to be 0.
`GL_INVALID_ENUM'
- An unacceptable value is specified for an enumerated argument. The
+ 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.
`GL_INVALID_VALUE'
- A numeric argument is out of range. The offending command is
+ A numeric argument is out of range. The offending command is
ignored and has no other side effect than to set the error flag.
`GL_INVALID_OPERATION'
- The specified operation is not allowed in the current state. The
+ 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.
`GL_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.
+ This command would cause a stack overflow. The offending command is
+ ignored and has no other side effect than to set the error flag.
`GL_STACK_UNDERFLOW'
- This command would cause a stack underflow. The offending command
+ This command would cause a stack underflow. The offending command
is ignored and has no other side effect than to set the error flag.
`GL_OUT_OF_MEMORY'
- There is not enough memory left to execute the command. The state
+ 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.
`GL_TABLE_TOO_LARGE'
The specified table exceeds the implementation's maximum supported
- table size. The offending command is ignored and has no other side
+ table size. The offending command is ignored and has no other side
effect than to set the error flag.
When an error flag is set, results of a GL operation are undefined only
-if `GL_OUT_OF_MEMORY' has occurred. In all other cases, the command
+if `GL_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 `glGetError' itself generates an error, it returns 0.
+frame buffer contents. If the generating command returns a value, it
+returns 0. If `glGetError' itself generates an error, it returns 0.
`GL_INVALID_OPERATION' is generated if `glGetError' is executed between
the execution of `glBegin' and the corresponding execution of `glEnd'.
Must be one of `GL_HISTOGRAM' or `GL_PROXY_HISTOGRAM'.
PNAME
- The name of the parameter to be retrieved. Must be one of
+ The name of the parameter to be retrieved. Must be one of
`GL_HISTOGRAM_WIDTH', `GL_HISTOGRAM_FORMAT',
`GL_HISTOGRAM_RED_SIZE', `GL_HISTOGRAM_GREEN_SIZE',
`GL_HISTOGRAM_BLUE_SIZE', `GL_HISTOGRAM_ALPHA_SIZE',
Pointer to storage for the returned values.
`glGetHistogramParameter' is used to query parameter values for the
-current histogram or for a proxy. The histogram state information may
-be queried by calling `glGetHistogramParameter' with a TARGET of
+current histogram or for a proxy. The histogram state information may be
+queried by calling `glGetHistogramParameter' with a TARGET of
`GL_HISTOGRAM' (to obtain information for the current histogram table)
or `GL_PROXY_HISTOGRAM' (to obtain information from the most recent
proxy request) and one of the following values for the PNAME argument:
RESET
If `GL_TRUE', each component counter that is actually returned is
- reset to zero. (Other counters are unaffected.) If `GL_FALSE',
- none of the counters in the histogram table is modified.
+ reset to zero. (Other counters are unaffected.) If `GL_FALSE', none
+ of the counters in the histogram table is modified.
FORMAT
- The format of values to be returned in VALUES. Must be one of
+ The format of values to be returned in VALUES. Must be one of
`GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR',
`GL_RGBA', `GL_BGRA', `GL_LUMINANCE', or `GL_LUMINANCE_ALPHA'.
TYPE
- The type of values to be returned in VALUES. Symbolic constants
+ The type of values to be returned in VALUES. Symbolic constants
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
A pointer to storage for the returned histogram table.
`glGetHistogram' returns the current histogram table as a
-one-dimensional image with the same width as the histogram. No pixel
+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.
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. The assignments of internal color components to the components
+as zero. The assignments of internal color components to the components
requested by FORMAT are:
*Internal Component*
"Return light source parameter values.
LIGHT
- Specifies a light source. The number of possible lights depends on
- the implementation, but at least eight lights are supported. They
+ 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 `GL_LIGHT' I where I
ranges from 0 to the value of `GL_MAX_LIGHTS' - 1.
PNAME
- Specifies a light source parameter for LIGHT. Accepted symbolic
+ Specifies a light source parameter for LIGHT. Accepted symbolic
names are `GL_AMBIENT', `GL_DIFFUSE', `GL_SPECULAR', `GL_POSITION',
`GL_SPOT_DIRECTION', `GL_SPOT_EXPONENT', `GL_SPOT_CUTOFF',
`GL_CONSTANT_ATTENUATION', `GL_LINEAR_ATTENUATION', and
Returns the requested data.
`glGetLight' returns in PARAMS the value or values of a light source
-parameter. LIGHT names the light and is a symbolic name of the form
+parameter. LIGHT names the light and is a symbolic name of the form
`GL_LIGHT'I where i ranges from 0 to the value of `GL_MAX_LIGHTS' - 1.
`GL_MAX_LIGHTS' is an implementation dependent constant that is greater
-than or equal to eight. PNAME specifies one of ten light source
+than or equal to eight. PNAME specifies one of ten light source
parameters, again by symbolic name.
The following parameters are defined:
`GL_AMBIENT'
PARAMS returns four integer or floating-point values representing
- the ambient intensity of the light source. Integer values, when
+ 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
+ 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).
`GL_DIFFUSE'
PARAMS returns four integer or floating-point values representing
- the diffuse intensity of the light source. Integer values, when
+ 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
+ representable integer value. If the internal value is outside the
range [-1,1] , the corresponding integer return value is undefined.
The initial value for `GL_LIGHT0' is (1, 1, 1, 1); for other
lights, the initial value is (0, 0, 0, 0).
`GL_SPECULAR'
PARAMS returns four integer or floating-point values representing
- the specular intensity of the light source. Integer values, when
+ 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
+ representable integer value. If the internal value is outside the
range [-1,1] , the corresponding integer return value is undefined.
The initial value for `GL_LIGHT0' is (1, 1, 1, 1); for other
lights, the initial value is (0, 0, 0, 0).
`GL_POSITION'
PARAMS returns four integer or floating-point values representing
- the position of the light source. Integer values, when requested,
+ 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
+ nearest integer value. The returned values are those maintained in
+ eye coordinates. They will not be equal to the values specified
using `glLight', unless the modelview matrix was identity at the
- time `glLight' was called. The initial value is (0, 0, 1, 0).
+ time `glLight' was called. The initial value is (0, 0, 1, 0).
`GL_SPOT_DIRECTION'
PARAMS returns three integer or floating-point values representing
- the direction of the light source. Integer values, when requested,
+ 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
+ nearest integer value. The returned values are those maintained in
+ eye coordinates. They will not be equal to the values specified
using `glLight', unless the modelview matrix was identity at the
- time `glLight' was called. Although spot direction is normalized
+ time `glLight' 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) .
+ normalization. The initial value is (0,0-1) .
`GL_SPOT_EXPONENT'
PARAMS 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.
+ 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.
`GL_SPOT_CUTOFF'
PARAMS returns a single integer or floating-point value
- representing the spot cutoff angle of the light. An integer 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.
+ representation to the nearest integer. The initial value is 180.
`GL_CONSTANT_ATTENUATION'
PARAMS 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
+ light. An integer value, when requested, is computed by rounding
the internal floating-point representation to the nearest integer.
The initial value is 1.
`GL_LINEAR_ATTENUATION'
PARAMS 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.
+ 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.
`GL_QUADRATIC_ATTENUATION'
PARAMS returns a single integer or floating-point value
- representing the quadratic attenuation of the light. An integer
+ 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
+ floating-point representation to the nearest integer. The initial
value is 0.
`GL_INVALID_ENUM' is generated if LIGHT or PNAME is not an accepted
"Return evaluator parameters.
TARGET
- Specifies the symbolic name of a map. Accepted values are
+ Specifies the symbolic name of a map. Accepted values are
`GL_MAP1_COLOR_4', `GL_MAP1_INDEX', `GL_MAP1_NORMAL',
`GL_MAP1_TEXTURE_COORD_1', `GL_MAP1_TEXTURE_COORD_2',
`GL_MAP1_TEXTURE_COORD_3', `GL_MAP1_TEXTURE_COORD_4',
`GL_MAP2_VERTEX_4'.
QUERY
- Specifies which parameter to return. Symbolic names `GL_COEFF',
+ Specifies which parameter to return. Symbolic names `GL_COEFF',
`GL_ORDER', and `GL_DOMAIN' are accepted.
V
Returns the requested data.
-`glMap1' and `glMap2' define evaluators. `glGetMap' returns evaluator
-parameters. TARGET chooses a map, QUERY selects a specific parameter,
+`glMap1' and `glMap2' define evaluators. `glGetMap' returns evaluator
+parameters. TARGET chooses a map, QUERY selects a specific parameter,
and V points to storage where the values will be returned.
The acceptable values for the TARGET parameter are described in the
two-dimensional evaluators return UORDER×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
+ 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
+ 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.
`GL_ORDER'
- V returns the order of the evaluator function. One-dimensional
- evaluators return a single value, ORDER . The initial value is 1.
+ V 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.
`GL_DOMAIN'
- V returns the linear U and V mapping parameters. One-dimensional
+ V returns the linear U and V mapping parameters. One-dimensional
evaluators return two values, U1 and U2 , as specified by `glMap1'.
Two-dimensional evaluators return four values ( U1 , U2 , V1 , and
- V2 ) as specified by `glMap2'. Integer values, when requested, are
+ V2 ) as specified by `glMap2'. Integer values, when requested, are
computed by rounding the internal floating-point values to the
nearest integer values.
"Return material parameters.
FACE
- Specifies which of the two materials is being queried. `GL_FRONT'
+ Specifies which of the two materials is being queried. `GL_FRONT'
or `GL_BACK' are accepted, representing the front and back
materials, respectively.
PNAME
- Specifies the material parameter to return. `GL_AMBIENT',
+ Specifies the material parameter to return. `GL_AMBIENT',
`GL_DIFFUSE', `GL_SPECULAR', `GL_EMISSION', `GL_SHININESS', and
`GL_COLOR_INDEXES' are accepted.
Returns the requested data.
`glGetMaterial' returns in PARAMS the value or values of parameter PNAME
-of material FACE. Six parameters are defined:
+of material FACE. Six parameters are defined:
`GL_AMBIENT'
PARAMS returns four integer or floating-point values representing
- the ambient reflectance of the material. Integer values, when
+ 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
+ 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)
`GL_DIFFUSE'
PARAMS returns four integer or floating-point values representing
- the diffuse reflectance of the material. Integer values, when
+ 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
+ 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).
`GL_SPECULAR'
PARAMS returns four integer or floating-point values representing
- the specular reflectance of the material. Integer values, when
+ 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
+ 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).
`GL_EMISSION'
PARAMS returns four integer or floating-point values representing
- the emitted light intensity of the material. Integer values, when
+ 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
+ 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).
`GL_SHININESS'
PARAMS returns one integer or floating-point value representing the
- specular exponent of the material. Integer values, when requested,
+ 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.
+ nearest integer value. The initial value is 0.
`GL_COLOR_INDEXES'
PARAMS 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
+ 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.
Must be `GL_MINMAX'.
PNAME
- The parameter to be retrieved. Must be one of `GL_MINMAX_FORMAT'
- or `GL_MINMAX_SINK'.
+ The parameter to be retrieved. Must be one of `GL_MINMAX_FORMAT' or
+ `GL_MINMAX_SINK'.
PARAMS
A pointer to storage for the retrieved parameters.
RESET
If `GL_TRUE', all entries in the minmax table that are actually
- returned are reset to their initial values. (Other entries are
+ returned are reset to their initial values. (Other entries are
unaltered.) If `GL_FALSE', the minmax table is unaltered.
FORMAT
- The format of the data to be returned in VALUES. Must be one of
+ The format of the data to be returned in VALUES. Must be one of
`GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR',
`GL_RGBA', `GL_BGRA', `GL_LUMINANCE', or `GL_LUMINANCE_ALPHA'.
TYPES
- The type of the data to be returned in VALUES. Symbolic constants
+ The type of the data to be returned in VALUES. Symbolic constants
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
`glGetMinmax' 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
+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 TYPES.
If a non-zero named buffer object is bound to the `GL_PIXEL_PACK_BUFFER'
No pixel transfer operations are performed on the return values, but
pixel storage modes that are applicable to one-dimensional images are
-performed. Color components that are requested in the specified FORMAT,
+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:
+are returned as zero. The assignment of internal color components to the
+components requested by FORMAT are as follows:
Red
If RESET is `GL_TRUE', the minmax table entries corresponding to the
-return values are reset to their initial values. Minimum and maximum
+return values are reset to their initial values. Minimum and maximum
values that are not returned are not modified, even if RESET is
`GL_TRUE'.
"Return the specified pixel map.
MAP
- Specifies the name of the pixel map to return. Accepted values are
+ Specifies the name of the pixel map to return. Accepted values are
`GL_PIXEL_MAP_I_TO_I', `GL_PIXEL_MAP_S_TO_S',
`GL_PIXEL_MAP_I_TO_R', `GL_PIXEL_MAP_I_TO_G',
`GL_PIXEL_MAP_I_TO_B', `GL_PIXEL_MAP_I_TO_A',
Returns the pixel map contents.
See the `glPixelMap' reference page for a description of the acceptable
-values for the MAP parameter. `glGetPixelMap' returns in DATA the
-contents of the pixel map specified in MAP. Pixel maps are used during
+values for the MAP parameter. `glGetPixelMap' returns in DATA the
+contents of the pixel map specified in MAP. Pixel maps are used during
the execution of `glReadPixels', `glDrawPixels', `glCopyPixels',
`glTexImage1D', `glTexImage2D', `glTexImage3D', `glTexSubImage1D',
`glTexSubImage2D', `glTexSubImage3D', `glCopyTexImage1D',
`glCopyTexImage2D', `glCopyTexSubImage1D', `glCopyTexSubImage2D', and
-`glCopyTexSubImage3D'. to map color indices, stencil indices, color
+`glCopyTexSubImage3D'. to map color indices, stencil indices, color
components, and depth components to other values.
If a non-zero named buffer object is bound to the `GL_PIXEL_PACK_BUFFER'
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
+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].
"Return the address of the specified pointer.
PNAME
- Specifies the array or buffer pointer to be returned. Symbolic
+ Specifies the array or buffer pointer to be returned. Symbolic
constants `GL_COLOR_ARRAY_POINTER', `GL_EDGE_FLAG_ARRAY_POINTER',
`GL_FOG_COORD_ARRAY_POINTER', `GL_FEEDBACK_BUFFER_POINTER',
`GL_INDEX_ARRAY_POINTER', `GL_NORMAL_ARRAY_POINTER',
PARAMS
Returns the pointer value specified by PNAME.
-`glGetPointerv' returns pointer information. PNAME is a symbolic
+`glGetPointerv' returns pointer information. PNAME is a symbolic
constant indicating the pointer to be returned, and PARAMS is a pointer
to a location in which to place the returned data.
`GL_SELECTION_BUFFER_POINTER', if a non-zero named buffer object was
bound to the `GL_ARRAY_BUFFER' target (see `glBindBuffer') when the
desired pointer was previously specified, the pointer returned is a byte
-offset into the buffer object's data store. Buffer objects are only
+offset into the buffer object's data store. Buffer objects are only
available in OpenGL versions 1.5 and greater.
`GL_INVALID_ENUM' is generated if PNAME is not an accepted value.")
"Return the polygon stipple pattern.
PATTERN
- Returns the stipple pattern. The initial value is all 1's.
+ Returns the stipple pattern. The initial value is all 1's.
`glGetPolygonStipple' returns to PATTERN a 32×32 polygon stipple
-pattern. The pattern is packed into memory as if `glReadPixels' with
+pattern. The pattern is packed into memory as if `glReadPixels' with
both HEIGHT and WIDTH of 32, TYPE of `GL_BITMAP', and FORMAT of
`GL_COLOR_INDEX' were called, and the stipple pattern were stored in an
-internal 32×32 color index buffer. Unlike `glReadPixels', however,
-pixel transfer operations (shift, offset, pixel map) are not applied to
-the returned stipple image.
+internal 32×32 color index buffer. Unlike `glReadPixels', however, pixel
+transfer operations (shift, offset, pixel map) are not applied to the
+returned stipple image.
If a non-zero named buffer object is bound to the `GL_PIXEL_PACK_BUFFER'
target (see `glBindBuffer') while a polygon stipple pattern is
information log.
`glGetProgramInfoLog' returns the information log for the specified
-program object. The information log for a program object is modified
-when the program object is linked or validated. The string that is
+program object. The information log for a program object is modified
+when the program object is linked or validated. The string that is
returned will be null terminated.
`glGetProgramInfoLog' returns in INFOLOG as much of the information log
-as it can, up to a maximum of MAXLENGTH characters. The number of
+as it can, up to a maximum of MAXLENGTH characters. The number of
characters actually returned, excluding the null termination character,
-is specified by LENGTH. If the length of the returned string is not
-required, a value of `NULL' can be passed in the LENGTH argument. The
+is specified by LENGTH. If the length of the returned string is not
+required, a value of `NULL' can be passed in the LENGTH argument. The
size of the buffer required to store the returned information log can be
obtained by calling `glGetProgram' with the value `GL_INFO_LOG_LENGTH'.
The information log for a program object is either an empty string, or a
string containing information about the last link operation, or a string
-containing information about the last validation operation. It may
+containing information about the last validation operation. It may
contain diagnostic messages, warning messages, and other information.
When a program object is created, its information log will be a string
of length 0.
Specifies the program object to be queried.
PNAME
- Specifies the object parameter. Accepted symbolic names are
+ Specifies the object parameter. Accepted symbolic names are
`GL_DELETE_STATUS', `GL_LINK_STATUS', `GL_VALIDATE_STATUS',
`GL_INFO_LOG_LENGTH', `GL_ATTACHED_SHADERS',
`GL_ACTIVE_ATTRIBUTES', `GL_ACTIVE_ATTRIBUTE_MAX_LENGTH',
Returns the requested object parameter.
`glGetProgram' returns in PARAMS the value of a parameter for a specific
-program object. The following parameters are defined:
+program object. The following parameters are defined:
`GL_DELETE_STATUS'
PARAMS returns the number of characters in the information log for
PROGRAM including the null termination character (i.e., the size of
- the character buffer required to store the information log). If
+ the character buffer required to store the information log). If
PROGRAM has no information log, a value of 0 is returned.
`GL_ATTACHED_SHADERS'
PARAMS returns the length of the longest active attribute name for
PROGRAM, including the null termination character (i.e., the size
of the character buffer required to store the longest attribute
- name). If no active attributes exist, 0 is returned.
+ name). If no active attributes exist, 0 is returned.
`GL_ACTIVE_UNIFORMS'
PARAMS returns the length of the longest active uniform variable
name for PROGRAM, including the null termination character (i.e.,
the size of the character buffer required to store the longest
- uniform variable name). If no active uniform variables exist, 0 is
+ uniform variable name). If no active uniform variables exist, 0 is
returned.
`GL_INVALID_VALUE' is generated if PROGRAM is not a value generated by
"Return parameters of a query object target.
TARGET
- Specifies a query object target. Must be `GL_SAMPLES_PASSED'.
+ Specifies a query object target. Must be `GL_SAMPLES_PASSED'.
PNAME
Specifies the symbolic name of a query object target parameter.
`glGetQueryiv' returns in PARAMS a selected parameter of the query
object target specified by TARGET.
-PNAME names a specific query object target parameter. When TARGET is
+PNAME names a specific query object target parameter. When TARGET is
`GL_SAMPLES_PASSED', PNAME can be as follows:
`GL_CURRENT_QUERY'
PARAMS returns the name of the currently active occlusion query
- object. If no occlusion query is active, 0 is returned. The
- initial value is 0.
+ object. If no occlusion query is active, 0 is returned. The initial
+ value is 0.
`GL_QUERY_COUNTER_BITS'
PARAMS returns the number of bits in the query counter used to
- accumulate passing samples. If the number of bits returned is 0,
+ accumulate passing samples. If the number of bits returned is 0,
the implementation does not support a query counter, and the
results obtained from `glGetQueryObject' are useless.
Specifies the name of a query object.
PNAME
- Specifies the symbolic name of a query object parameter. Accepted
+ Specifies the symbolic name of a query object parameter. Accepted
values are `GL_QUERY_RESULT' or `GL_QUERY_RESULT_AVAILABLE'.
PARAMS
`glGetQueryObject' returns in PARAMS a selected parameter of the query
object specified by ID.
-PNAME names a specific query object parameter. PNAME can be as follows:
+PNAME names a specific query object parameter. PNAME can be as follows:
`GL_QUERY_RESULT'
PARAMS returns the value of the query object's passed samples
- counter. The initial value is 0.
+ counter. The initial value is 0.
`GL_QUERY_RESULT_AVAILABLE'
PARAMS returns whether the passed samples counter is immediately
- available. If a delay would occur waiting for the query result,
- `GL_FALSE' is returned. Otherwise, `GL_TRUE' is returned, which
+ available. If a delay would occur waiting for the query result,
+ `GL_FALSE' is returned. Otherwise, `GL_TRUE' is returned, which
also indicates that the results of all previous queries are
available as well.
"Get separable convolution filter kernel images.
TARGET
- The separable filter to be retrieved. Must be `GL_SEPARABLE_2D'.
+ The separable filter to be retrieved. Must be `GL_SEPARABLE_2D'.
FORMAT
- Format of the output images. Must be one of `GL_RED', `GL_GREEN',
+ Format of the output images. Must be one of `GL_RED', `GL_GREEN',
`GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR'`GL_RGBA', `GL_BGRA',
`GL_LUMINANCE', or `GL_LUMINANCE_ALPHA'.
TYPE
- Data type of components in the output images. Symbolic constants
+ Data type of components in the output images. Symbolic constants
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
Pointer to storage for the span filter image (currently unused).
`glGetSeparableFilter' 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.
+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.
If a non-zero named buffer object is bound to the `GL_PIXEL_PACK_BUFFER'
target (see `glBindBuffer') while a separable convolution filter is
buffer object's data store.
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 format of the filters are returned as zero. The assignments of
internal color components to the components of FORMAT are as follows:
information log.
`glGetShaderInfoLog' returns the information log for the specified
-shader object. The information log for a shader object is modified when
-the shader is compiled. The string that is returned will be null
+shader object. The information log for a shader object is modified when
+the shader is compiled. The string that is returned will be null
terminated.
`glGetShaderInfoLog' returns in INFOLOG as much of the information log
-as it can, up to a maximum of MAXLENGTH characters. The number of
+as it can, up to a maximum of MAXLENGTH characters. The number of
characters actually returned, excluding the null termination character,
-is specified by LENGTH. If the length of the returned string is not
-required, a value of `NULL' can be passed in the LENGTH argument. The
+is specified by LENGTH. If the length of the returned string is not
+required, a value of `NULL' can be passed in the LENGTH argument. The
size of the buffer required to store the returned information log can be
obtained by calling `glGetShader' with the value `GL_INFO_LOG_LENGTH'.
The information log for a shader object is a string that may contain
diagnostic messages, warning messages, and other information about the
-last compile operation. When a shader object is created, its
-information log will be a string of length 0.
+last compile operation. When a shader object is created, its information
+log will be a string of length 0.
`GL_INVALID_VALUE' is generated if SHADER is not a value generated by
OpenGL.
code string.
`glGetShaderSource' returns the concatenation of the source code strings
-from the shader object specified by SHADER. The source code strings for
+from the shader object specified by SHADER. The source code strings for
a shader object are the result of a previous call to `glShaderSource'.
The string returned by the function will be null terminated.
`glGetShaderSource' returns in SOURCE as much of the source code string
-as it can, up to a maximum of BUFSIZE characters. The number of
+as it can, up to a maximum of BUFSIZE characters. The number of
characters actually returned, excluding the null termination character,
-is specified by LENGTH. If the length of the returned string is not
-required, a value of `NULL' can be passed in the LENGTH argument. The
+is specified by LENGTH. If the length of the returned string is not
+required, a value of `NULL' can be passed in the LENGTH argument. The
size of the buffer required to store the returned source code string can
be obtained by calling `glGetShader' with the value
`GL_SHADER_SOURCE_LENGTH'.
Specifies the shader object to be queried.
PNAME
- Specifies the object parameter. Accepted symbolic names are
+ Specifies the object parameter. Accepted symbolic names are
`GL_SHADER_TYPE', `GL_DELETE_STATUS', `GL_COMPILE_STATUS',
`GL_INFO_LOG_LENGTH', `GL_SHADER_SOURCE_LENGTH'.
Returns the requested object parameter.
`glGetShader' returns in PARAMS the value of a parameter for a specific
-shader object. The following parameters are defined:
+shader object. The following parameters are defined:
`GL_SHADER_TYPE'
PARAMS returns `GL_VERTEX_SHADER' if SHADER is a vertex shader
`GL_INFO_LOG_LENGTH'
PARAMS returns the number of characters in the information log for
SHADER including the null termination character (i.e., the size of
- the character buffer required to store the information log). If
+ the character buffer required to store the information log). If
SHADER has no information log, a value of 0 is returned.
`GL_SHADER_SOURCE_LENGTH'
PARAMS returns the length of the concatenation of the source
strings that make up the shader source for the SHADER, including
- the null termination character. (i.e., the size of the character
- buffer required to store the shader source). If no source code
+ the null termination character. (i.e., the size of the character
+ buffer required to store the shader source). If no source code
exists, 0 is returned.
`GL_INVALID_VALUE' is generated if SHADER is not a value generated by
`GL_VERSION', `GL_SHADING_LANGUAGE_VERSION', or `GL_EXTENSIONS'.
`glGetString' returns a pointer to a static string describing some
-aspect of the current GL connection. NAME can be one of the following:
+aspect of the current GL connection. NAME can be one of the following:
`GL_VENDOR'
- Returns the company responsible for this GL implementation. This
+ Returns the company responsible for this GL implementation. This
name does not change from release to release.
`GL_RENDERER'
- Returns the name of the renderer. This name is typically specific
- to a particular configuration of a hardware platform. It does not
+ 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.
`GL_VERSION'
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 `GL_VENDOR' and
-`GL_RENDERER' together uniquely specify a platform. They do not change
+performance characteristics of these platforms. Strings `GL_VENDOR' and
+`GL_RENDERER' together uniquely specify a platform. They do not change
from release to release and should be used by platform-recognition
algorithms.
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 `GL_EXTENSIONS' string is a space-separated list of
-supported GL extensions. (Extension names never contain a space
+standard GL. These features may be implemented as extensions to the
+standard GL. The `GL_EXTENSIONS' string is a space-separated list of
+supported GL extensions. (Extension names never contain a space
character.)
The `GL_VERSION' and `GL_SHADING_LANGUAGE_VERSION' strings begin with a
-version number. The version number uses one of these forms:
+version number. The version number uses one of these forms:
MAJOR_NUMBER.MINOR_NUMBERMAJOR_NUMBER.MINOR_NUMBER.RELEASE_NUMBER
-Vendor-specific information may follow the version number. Its format
+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.
"Return texture environment parameters.
TARGET
- Specifies a texture environment. May be `GL_TEXTURE_ENV',
+ Specifies a texture environment. May be `GL_TEXTURE_ENV',
`GL_TEXTURE_FILTER_CONTROL', or `GL_POINT_SPRITE'.
PNAME
Returns the requested data.
`glGetTexEnv' returns in PARAMS selected values of a texture environment
-that was specified with `glTexEnv'. TARGET specifies a texture
+that was specified with `glTexEnv'. TARGET specifies a texture
environment.
When TARGET is `GL_TEXTURE_FILTER_CONTROL', PNAME must be
-`GL_TEXTURE_LOD_BIAS'. When TARGET is `GL_POINT_SPRITE', PNAME must be
-`GL_COORD_REPLACE'. When TARGET is `GL_TEXTURE_ENV', PNAME can be
+`GL_TEXTURE_LOD_BIAS'. When TARGET is `GL_POINT_SPRITE', PNAME must be
+`GL_COORD_REPLACE'. When TARGET is `GL_TEXTURE_ENV', PNAME can be
`GL_TEXTURE_ENV_MODE', `GL_TEXTURE_ENV_COLOR', `GL_COMBINE_RGB',
`GL_COMBINE_ALPHA', `GL_RGB_SCALE', `GL_ALPHA_SCALE', `GL_SRC0_RGB',
`GL_SRC1_RGB', `GL_SRC2_RGB', `GL_SRC0_ALPHA', `GL_SRC1_ALPHA', or
`GL_TEXTURE_ENV_MODE'
PARAMS returns the single-valued texture environment mode, a
- symbolic constant. The initial value is `GL_MODULATE'.
+ symbolic constant. The initial value is `GL_MODULATE'.
`GL_TEXTURE_ENV_COLOR'
PARAMS returns four integer or floating-point values that are the
- texture environment color. Integer values, when requested, are
+ 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
+ -1.0 maps to the most negative representable integer. The initial
value is (0, 0, 0, 0).
`GL_TEXTURE_LOD_BIAS'
PARAMS returns a single floating-point value that is the texture
- level-of-detail bias. The initial value is 0.
+ level-of-detail bias. The initial value is 0.
`GL_COMBINE_RGB'
PARAMS returns a single symbolic constant value representing the
- current RGB combine mode. The initial value is `GL_MODULATE'.
+ current RGB combine mode. The initial value is `GL_MODULATE'.
`GL_COMBINE_ALPHA'
PARAMS returns a single symbolic constant value representing the
- current alpha combine mode. The initial value is `GL_MODULATE'.
+ current alpha combine mode. The initial value is `GL_MODULATE'.
`GL_SRC0_RGB'
PARAMS returns a single symbolic constant value representing the
- texture combiner zero's RGB source. The initial value is
+ texture combiner zero's RGB source. The initial value is
`GL_TEXTURE'.
`GL_SRC1_RGB'
PARAMS returns a single symbolic constant value representing the
- texture combiner one's RGB source. The initial value is
+ texture combiner one's RGB source. The initial value is
`GL_PREVIOUS'.
`GL_SRC2_RGB'
PARAMS returns a single symbolic constant value representing the
- texture combiner two's RGB source. The initial value is
+ texture combiner two's RGB source. The initial value is
`GL_CONSTANT'.
`GL_SRC0_ALPHA'
PARAMS returns a single symbolic constant value representing the
- texture combiner zero's alpha source. The initial value is
+ texture combiner zero's alpha source. The initial value is
`GL_TEXTURE'.
`GL_SRC1_ALPHA'
PARAMS returns a single symbolic constant value representing the
- texture combiner one's alpha source. The initial value is
+ texture combiner one's alpha source. The initial value is
`GL_PREVIOUS'.
`GL_SRC2_ALPHA'
PARAMS returns a single symbolic constant value representing the
- texture combiner two's alpha source. The initial value is
+ texture combiner two's alpha source. The initial value is
`GL_CONSTANT'.
`GL_OPERAND0_RGB'
PARAMS returns a single symbolic constant value representing the
- texture combiner zero's RGB operand. The initial value is
+ texture combiner zero's RGB operand. The initial value is
`GL_SRC_COLOR'.
`GL_OPERAND1_RGB'
PARAMS returns a single symbolic constant value representing the
- texture combiner one's RGB operand. The initial value is
+ texture combiner one's RGB operand. The initial value is
`GL_SRC_COLOR'.
`GL_OPERAND2_RGB'
PARAMS returns a single symbolic constant value representing the
- texture combiner two's RGB operand. The initial value is
+ texture combiner two's RGB operand. The initial value is
`GL_SRC_ALPHA'.
`GL_OPERAND0_ALPHA'
PARAMS returns a single symbolic constant value representing the
- texture combiner zero's alpha operand. The initial value is
+ texture combiner zero's alpha operand. The initial value is
`GL_SRC_ALPHA'.
`GL_OPERAND1_ALPHA'
PARAMS returns a single symbolic constant value representing the
- texture combiner one's alpha operand. The initial value is
+ texture combiner one's alpha operand. The initial value is
`GL_SRC_ALPHA'.
`GL_OPERAND2_ALPHA'
PARAMS returns a single symbolic constant value representing the
- texture combiner two's alpha operand. The initial value is
+ texture combiner two's alpha operand. The initial value is
`GL_SRC_ALPHA'.
`GL_RGB_SCALE'
PARAMS returns a single floating-point value representing the
- current RGB texture combiner scaling factor. The initial value is
+ current RGB texture combiner scaling factor. The initial value is
1.0.
`GL_ALPHA_SCALE'
PARAMS returns a single floating-point value representing the
- current alpha texture combiner scaling factor. The initial value
- is 1.0.
+ current alpha texture combiner scaling factor. The initial value is
+ 1.0.
`GL_COORD_REPLACE'
PARAMS returns a single boolean value representing the current
- point sprite texture coordinate replacement enable state. The
+ point sprite texture coordinate replacement enable state. The
initial value is `GL_FALSE'.
`GL_INVALID_ENUM' is generated if TARGET or PNAME is not an accepted
"Return texture coordinate generation parameters.
COORD
- Specifies a texture coordinate. Must be `GL_S', `GL_T', `GL_R', or
+ Specifies a texture coordinate. Must be `GL_S', `GL_T', `GL_R', or
`GL_Q'.
PNAME
- Specifies the symbolic name of the value(s) to be returned. Must
- be either `GL_TEXTURE_GEN_MODE' or the name of one of the texture
+ Specifies the symbolic name of the value(s) to be returned. Must be
+ either `GL_TEXTURE_GEN_MODE' or the name of one of the texture
generation plane equations: `GL_OBJECT_PLANE' or `GL_EYE_PLANE'.
PARAMS
`GL_TEXTURE_GEN_MODE'
PARAMS returns the single-valued texture generation function, a
- symbolic constant. The initial value is `GL_EYE_LINEAR'.
+ symbolic constant. The initial value is `GL_EYE_LINEAR'.
`GL_OBJECT_PLANE'
PARAMS returns the four plane equation coefficients that specify
- object linear-coordinate generation. Integer values, when
+ object linear-coordinate generation. Integer values, when
requested, are mapped directly from the internal floating-point
representation.
`GL_EYE_PLANE'
PARAMS returns the four plane equation coefficients that specify
- eye linear-coordinate generation. Integer values, when requested,
+ 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
+ representation. The returned values are those maintained in eye
+ coordinates. They are not equal to the values specified using
`glTexGen', unless the modelview matrix was identity when
`glTexGen' was called.
"Return a texture image.
TARGET
- Specifies which texture is to be obtained. `GL_TEXTURE_1D',
+ Specifies which texture is to be obtained. `GL_TEXTURE_1D',
`GL_TEXTURE_2D', `GL_TEXTURE_3D', `GL_TEXTURE_CUBE_MAP_POSITIVE_X',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_X', `GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Y', `GL_TEXTURE_CUBE_MAP_POSITIVE_Z',
and `GL_TEXTURE_CUBE_MAP_NEGATIVE_Z' are accepted.
LEVEL
- 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
+ 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.
FORMAT
- Specifies a pixel format for the returned data. The supported
+ Specifies a pixel format for the returned data. The supported
formats are `GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA', `GL_RGB',
`GL_BGR', `GL_RGBA', `GL_BGRA', `GL_LUMINANCE', and
`GL_LUMINANCE_ALPHA'.
TYPE
- Specifies a pixel type for the returned data. The supported types
+ Specifies a pixel type for the returned data. The supported types
are `GL_UNSIGNED_BYTE', `GL_BYTE', `GL_UNSIGNED_SHORT', `GL_SHORT',
`GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT', `GL_UNSIGNED_BYTE_3_3_2',
`GL_UNSIGNED_BYTE_2_3_3_REV', `GL_UNSIGNED_SHORT_5_6_5',
`GL_UNSIGNED_INT_2_10_10_10_REV'.
IMG
- Returns the texture image. Should be a pointer to an array of the
+ Returns the texture image. Should be a pointer to an array of the
type specified by TYPE.
-`glGetTexImage' returns a texture image into IMG. TARGET specifies
+`glGetTexImage' returns a texture image into IMG. TARGET specifies
whether the desired texture image is one specified by `glTexImage1D'
(`GL_TEXTURE_1D'), `glTexImage2D' (`GL_TEXTURE_2D' or any of
-`GL_TEXTURE_CUBE_MAP_*'), or `glTexImage3D' (`GL_TEXTURE_3D'). LEVEL
-specifies the level-of-detail number of the desired image. FORMAT and
-TYPE specify the format and type of the desired image array. See the
+`GL_TEXTURE_CUBE_MAP_*'), or `glTexImage3D' (`GL_TEXTURE_3D'). LEVEL
+specifies the level-of-detail number of the desired image. FORMAT and
+TYPE specify the format and type of the desired image array. See the
reference pages `glTexImage1D' and `glDrawPixels' for a description of
the acceptable values for the FORMAT and TYPE parameters, respectively.
To understand the operation of `glGetTexImage', consider the selected
internal four-component texture image to be an RGBA color buffer the
-size of the image. The semantics of `glGetTexImage' are then identical
+size of the image. The semantics of `glGetTexImage' are then identical
to those of `glReadPixels', with the exception that no pixel transfer
operations are performed, when called with the same FORMAT and TYPE,
with X and Y set to 0, WIDTH set to the width of the texture image
(including border if one was specified), and HEIGHT set to 1 for 1D
images, or to the height of the texture image (including border if one
-was specified) for 2D images. Because the internal texture image is an
+was specified) for 2D images. Because the internal texture image is an
RGBA image, pixel formats `GL_COLOR_INDEX', `GL_STENCIL_INDEX', and
`GL_DEPTH_COMPONENT' are not accepted, and pixel type `GL_BITMAP' is not
accepted.
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.
+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.
To determine the required size of IMG, use `glGetTexLevelParameter' 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 FORMAT and TYPE. Be sure to take the pixel storage parameters into
+on FORMAT and TYPE. Be sure to take the pixel storage parameters into
account, especially `GL_PACK_ALIGNMENT'.
`GL_INVALID_ENUM' is generated if TARGET, FORMAT, or TYPE is not an
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Z', or `GL_PROXY_TEXTURE_CUBE_MAP'.
LEVEL
- 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
+ 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.
PNAME
Returns the requested data.
`glGetTexLevelParameter' returns in PARAMS texture parameter values for
-a specific level-of-detail value, specified as LEVEL. TARGET defines
-the target texture, either `GL_TEXTURE_1D', `GL_TEXTURE_2D',
+a specific level-of-detail value, specified as LEVEL. TARGET defines the
+target texture, either `GL_TEXTURE_1D', `GL_TEXTURE_2D',
`GL_TEXTURE_3D', `GL_PROXY_TEXTURE_1D', `GL_PROXY_TEXTURE_2D',
`GL_PROXY_TEXTURE_3D', `GL_TEXTURE_CUBE_MAP_POSITIVE_X',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_X', `GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Z', or `GL_PROXY_TEXTURE_CUBE_MAP'.
`GL_MAX_TEXTURE_SIZE', and `GL_MAX_3D_TEXTURE_SIZE' are not really
-descriptive enough. It has to report the largest square texture image
+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
+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 `glGetTexLevelParameter', are set to 0. If
-the texture can be accommodated, the texture state values will be set as
+which may be queried with `glGetTexLevelParameter', 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.
PNAME specifies the texture parameter whose value or values will be
`GL_TEXTURE_WIDTH'
- PARAMS returns a single value, the width of the texture image. This
- value includes the border of the texture image. The initial value
+ PARAMS returns a single value, the width of the texture image. This
+ value includes the border of the texture image. The initial value
is 0.
`GL_TEXTURE_HEIGHT'
PARAMS returns a single value, the height of the texture image.
- This value includes the border of the texture image. The initial
+ This value includes the border of the texture image. The initial
value is 0.
`GL_TEXTURE_DEPTH'
- PARAMS returns a single value, the depth of the texture image. This
- value includes the border of the texture image. The initial value
+ PARAMS returns a single value, the depth of the texture image. This
+ value includes the border of the texture image. The initial value
is 0.
`GL_TEXTURE_INTERNAL_FORMAT'
PARAMS returns a single value, the width in pixels of the border of
- the texture image. The initial value is 0.
+ the texture image. The initial value is 0.
`GL_TEXTURE_RED_SIZE',
`GL_TEXTURE_GREEN_SIZE',
`GL_TEXTURE_DEPTH_SIZE'
- The internal storage resolution of an individual component. The
+ 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
`glTexImage1D', `glTexImage2D', `glTexImage3D', `glCopyTexImage1D',
- and `glCopyTexImage2D'. The initial value is 0.
+ and `glCopyTexImage2D'. The initial value is 0.
`GL_TEXTURE_COMPRESSED'
PARAMS returns a single boolean value indicating if the texture
- image is stored in a compressed internal format. The initiali
- value is `GL_FALSE'.
+ image is stored in a compressed internal format. The initiali value
+ is `GL_FALSE'.
`GL_TEXTURE_COMPRESSED_IMAGE_SIZE'
"Return texture parameter values.
TARGET
- Specifies the symbolic name of the target texture. `GL_TEXTURE_1D',
+ Specifies the symbolic name of the target texture. `GL_TEXTURE_1D',
`GL_TEXTURE_2D', `GL_TEXTURE_3D', and `GL_TEXTURE_CUBE_MAP' are
accepted.
Returns the texture parameters.
`glGetTexParameter' returns in PARAMS the value or values of the texture
-parameter specified as PNAME. TARGET defines the target texture, either
+parameter specified as PNAME. TARGET defines the target texture, either
`GL_TEXTURE_1D', `GL_TEXTURE_2D', `GL_TEXTURE_3D', or
`GL_TEXTURE_CUBE_MAP', to specify one-, two-, or three-dimensional or
-cube-mapped texturing. PNAME accepts the same symbols as
+cube-mapped texturing. PNAME accepts the same symbols as
`glTexParameter', with the same interpretations:
`GL_TEXTURE_MAG_FILTER'
Returns the single-valued texture magnification filter, a symbolic
- constant. The initial value is `GL_LINEAR'.
+ constant. The initial value is `GL_LINEAR'.
`GL_TEXTURE_MIN_FILTER'
Returns the single-valued texture minification filter, a symbolic
- constant. The initial value is `GL_NEAREST_MIPMAP_LINEAR'.
+ constant. The initial value is `GL_NEAREST_MIPMAP_LINEAR'.
`GL_TEXTURE_MIN_LOD'
Returns the single-valued texture minimum level-of-detail value.
The initial value is 1000.
`GL_TEXTURE_BASE_LEVEL'
- Returns the single-valued base texture mipmap level. The initial
+ Returns the single-valued base texture mipmap level. The initial
value is 0.
`GL_TEXTURE_MAX_LEVEL'
- Returns the single-valued maximum texture mipmap array level. The
+ Returns the single-valued maximum texture mipmap array level. The
initial value is 1000.
`GL_TEXTURE_WRAP_S'
Returns the single-valued wrapping function for texture coordinate
- S , a symbolic constant. The initial value is `GL_REPEAT'.
+ S , a symbolic constant. The initial value is `GL_REPEAT'.
`GL_TEXTURE_WRAP_T'
Returns the single-valued wrapping function for texture coordinate
- T , a symbolic constant. The initial value is `GL_REPEAT'.
+ T , a symbolic constant. The initial value is `GL_REPEAT'.
`GL_TEXTURE_WRAP_R'
Returns the single-valued wrapping function for texture coordinate
- R , a symbolic constant. The initial value is `GL_REPEAT'.
+ R , a symbolic constant. The initial value is `GL_REPEAT'.
`GL_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
+ 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
+ maps to the most negative representable integer. The initial value
is (0, 0, 0, 0).
`GL_TEXTURE_PRIORITY'
Returns the residence priority of the target texture (or the named
- texture bound to it). The initial value is 1. See
+ texture bound to it). The initial value is 1. See
`glPrioritizeTextures'.
`GL_TEXTURE_RESIDENT'
- Returns the residence status of the target texture. If the value
+ Returns the residence status of the target texture. If the value
returned in PARAMS is `GL_TRUE', the texture is resident in texture
- memory. See `glAreTexturesResident'.
+ memory. See `glAreTexturesResident'.
`GL_TEXTURE_COMPARE_MODE'
Returns a single-valued texture comparison mode, a symbolic
- constant. The initial value is `GL_NONE'. See `glTexParameter'.
+ constant. The initial value is `GL_NONE'. See `glTexParameter'.
`GL_TEXTURE_COMPARE_FUNC'
Returns a single-valued texture comparison function, a symbolic
- constant. The initial value is `GL_LEQUAL'. See `glTexParameter'.
+ constant. The initial value is `GL_LEQUAL'. See `glTexParameter'.
`GL_DEPTH_TEXTURE_MODE'
Returns a single-valued texture format indicating how the depth
- values should be converted into color components. The initial
- value is `GL_LUMINANCE'. See `glTexParameter'.
+ values should be converted into color components. The initial value
+ is `GL_LUMINANCE'. See `glTexParameter'.
`GL_GENERATE_MIPMAP'
Returns a single boolean value indicating if automatic mipmap level
- updates are enabled. See `glTexParameter'.
+ updates are enabled. See `glTexParameter'.
`GL_INVALID_ENUM' is generated if TARGET or PNAME is not an accepted
value.
uniform variable whose location is to be queried.
`glGetUniformLocation ' returns an integer that represents the location
-of a specific uniform variable within a program object. NAME must be a
-null terminated string that contains no white space. NAME must be an
+of a specific uniform variable within a program object. NAME must be a
+null terminated string that contains no white space. NAME must be an
active uniform variable name in PROGRAM that is not a structure, an
-array of structures, or a subcomponent of a vector or a matrix. This
+array of structures, or a subcomponent of a vector or a matrix. This
function returns -1 if NAME does not correspond to an active uniform
variable in PROGRAM or if NAME starts with the reserved prefix \"gl_\".
Uniform variables that are structures or arrays of structures may be
queried by calling `glGetUniformLocation' for each field within the
-structure. The array element operator \"[]\" and the structure field
+structure. The array element operator \"[]\" and the structure field
operator \".\" may be used in NAME in order to select elements within an
-array or fields within a structure. The result of using these operators
+array or fields within a structure. The result of using these operators
is not allowed to be another structure, an array of structures, or a
-subcomponent of a vector or a matrix. Except if the last part of NAME
+subcomponent of a vector or a matrix. Except if the last part of NAME
indicates a uniform variable array, the location of the first element of
an array can be retrieved by using the name of the array, or by using
the name appended by \"[0]\".
The actual locations assigned to uniform variables are not known until
-the program object is linked successfully. After linking has occurred,
+the program object is linked successfully. After linking has occurred,
the command `glGetUniformLocation' can be used to obtain the location of
-a uniform variable. This location value can then be passed to
+a uniform variable. This location value can then be passed to
`glUniform' to set the value of the uniform variable or to
`glGetUniform' in order to query the current value of the uniform
-variable. After a program object has been linked successfully, the
-index values for uniform variables remain fixed until the next link
-command occurs. Uniform variable locations and values can only be
-queried after a link if the link was successful.
+variable. After a program object has been linked successfully, the index
+values for uniform variables remain fixed until the next link command
+occurs. Uniform variable locations and values can only be queried after
+a link if the link was successful.
`GL_INVALID_VALUE' is generated if PROGRAM is not a value generated by
OpenGL.
Returns the value of the specified uniform variable.
`glGetUniform' returns in PARAMS the value(s) of the specified uniform
-variable. The type of the uniform variable specified by LOCATION
-determines the number of values returned. If the uniform variable is
+variable. The type of the uniform variable specified by LOCATION
+determines the number of values returned. If the uniform variable is
defined in the shader as a boolean, int, or float, a single value will
-be returned. If it is defined as a vec2, ivec2, or bvec2, two values
-will be returned. If it is defined as a vec3, ivec3, or bvec3, three
-values will be returned, and so on. To query values stored in uniform
+be returned. If it is defined as a vec2, ivec2, or bvec2, two values
+will be returned. If it is defined as a vec3, ivec3, or bvec3, three
+values will be returned, and so on. To query values stored in uniform
variables declared as arrays, call `glGetUniform' for each element of
-the array. To query values stored in uniform variables declared as
-structures, call `glGetUniform' for each field in the structure. The
+the array. To query values stored in uniform variables declared as
+structures, call `glGetUniform' for each field in the structure. The
values for uniform variables declared as a matrix will be returned in
column major order.
The locations assigned to uniform variables are not known until the
-program object is linked. After linking has occurred, the command
+program object is linked. After linking has occurred, the command
`glGetUniformLocation' can be used to obtain the location of a uniform
-variable. This location value can then be passed to `glGetUniform' in
-order to query the current value of the uniform variable. After a
+variable. This location value can then be passed to `glGetUniform' in
+order to query the current value of the uniform variable. After a
program object has been linked successfully, the index values for
-uniform variables remain fixed until the next link command occurs. The
+uniform variables remain fixed until the next link command occurs. The
uniform variable values can only be queried after a link if the link was
successful.
PNAME
Specifies the symbolic name of the generic vertex attribute
- parameter to be returned. Must be
- `GL_VERTEX_ATTRIB_ARRAY_POINTER'.
+ parameter to be returned. Must be `GL_VERTEX_ATTRIB_ARRAY_POINTER'.
POINTER
Returns the pointer value.
-`glGetVertexAttribPointerv' returns pointer information. INDEX is the
+`glGetVertexAttribPointerv' returns pointer information. INDEX is the
generic vertex attribute to be queried, PNAME is a symbolic constant
indicating the pointer to be returned, and PARAMS is a pointer to a
location in which to place the returned data.
PNAME
Specifies the symbolic name of the vertex attribute parameter to be
- queried. Accepted values are
+ queried. Accepted values are
`GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING',
`GL_VERTEX_ATTRIB_ARRAY_ENABLED', `GL_VERTEX_ATTRIB_ARRAY_SIZE',
`GL_VERTEX_ATTRIB_ARRAY_STRIDE', `GL_VERTEX_ATTRIB_ARRAY_TYPE',
Returns the requested data.
`glGetVertexAttrib' returns in PARAMS the value of a generic vertex
-attribute parameter. The generic vertex attribute to be queried is
+attribute parameter. The generic vertex attribute to be queried is
specified by INDEX, and the parameter to be queried is specified by
PNAME.
PARAMS returns a single value, the name of the buffer object
currently bound to the binding point corresponding to generic
- vertex attribute array INDEX. If no buffer object is bound, 0 is
- returned. The initial value is 0.
+ vertex attribute array INDEX. If no buffer object is bound, 0 is
+ returned. The initial value is 0.
`GL_VERTEX_ATTRIB_ARRAY_ENABLED'
PARAMS returns a single value that is non-zero (true) if the vertex
attribute array for INDEX is enabled and 0 (false) if it is
- disabled. The initial value is `GL_FALSE'.
+ disabled. The initial value is `GL_FALSE'.
`GL_VERTEX_ATTRIB_ARRAY_SIZE'
PARAMS returns a single value, the size of the vertex attribute
- array for INDEX. The size is the number of values for each element
- of the vertex attribute array, and it will be 1, 2, 3, or 4. The
+ array for INDEX. The size is the number of values for each element
+ of the vertex attribute array, and it will be 1, 2, 3, or 4. The
initial value is 4.
`GL_VERTEX_ATTRIB_ARRAY_STRIDE'
PARAMS returns a single value, the array stride for (number of
bytes between successive elements in) the vertex attribute array
- for INDEX. A value of 0 indicates that the array elements are
- stored sequentially in memory. The initial value is 0.
+ for INDEX. A value of 0 indicates that the array elements are
+ stored sequentially in memory. The initial value is 0.
`GL_VERTEX_ATTRIB_ARRAY_TYPE'
PARAMS returns a single value, a symbolic constant indicating the
- array type for the vertex attribute array for INDEX. Possible
+ array type for the vertex attribute array for INDEX. Possible
values are `GL_BYTE', `GL_UNSIGNED_BYTE', `GL_SHORT',
`GL_UNSIGNED_SHORT', `GL_INT', `GL_UNSIGNED_INT', `GL_FLOAT', and
- `GL_DOUBLE'. The initial value is `GL_FLOAT'.
+ `GL_DOUBLE'. The initial value is `GL_FLOAT'.
`GL_VERTEX_ATTRIB_ARRAY_NORMALIZED'
PARAMS returns a single value that is non-zero (true) if
fixed-point data types for the vertex attribute array indicated by
INDEX are normalized when they are converted to floating point, and
- 0 (false) otherwise. The initial value is `GL_FALSE'.
+ 0 (false) otherwise. The initial value is `GL_FALSE'.
`GL_CURRENT_VERTEX_ATTRIB'
PARAMS returns four values that represent the current value for the
- generic vertex attribute specified by index. Generic vertex
+ generic vertex attribute specified by index. Generic vertex
attribute 0 is unique in that it has no current state, so an error
- will be generated if INDEX is 0. The initial value for all other
+ will be generated if INDEX is 0. The initial value for all other
generic vertex attributes is (0,0,0,1).
All of the parameters except `GL_CURRENT_VERTEX_ATTRIB' represent
"Return the value or values of a selected parameter.
PNAME
- Specifies the parameter value to be returned. The symbolic
+ Specifies the parameter value to be returned. The symbolic
constants in the list below are accepted.
PARAMS
which to place the returned data.
Type conversion is performed if PARAMS has a different type than the
-state variable value being requested. If `glGetBooleanv' is called, a
+state variable value being requested. If `glGetBooleanv' is called, a
floating-point (or integer) value is converted to `GL_FALSE' if and only
-if it is 0.0 (or 0). Otherwise, it is converted to `GL_TRUE'. If
+if it is 0.0 (or 0). Otherwise, it is converted to `GL_TRUE'. If
`glGetIntegerv' is called, boolean values are returned as `GL_TRUE' or
`GL_FALSE', and most floating-point values are rounded to the nearest
-integer value. Floating-point colors and normals, however, are returned
+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 `glGetFloatv' or `glGetDoublev' is called, boolean values are
PARAMS returns four values: the red, green, blue, and alpha values
- used to clear the accumulation buffer. Integer values, if
+ 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 `glClearAccum'.
+ representable integer value. The initial value is (0, 0, 0, 0). See
+ `glClearAccum'.
`GL_ACCUM_GREEN_BITS'
PARAMS returns a single value indicating the active multitexture
- unit. The initial value is `GL_TEXTURE0'. See `glActiveTexture'.
+ unit. The initial value is `GL_TEXTURE0'. See `glActiveTexture'.
`GL_ALIASED_POINT_SIZE_RANGE'
PARAMS returns one value, the alpha bias factor used during pixel
- transfers. The initial value is 0. See `glPixelTransfer'.
+ transfers. The initial value is 0. See `glPixelTransfer'.
`GL_ALPHA_BITS'
PARAMS returns one value, the alpha scale factor used during pixel
- transfers. The initial value is 1. See `glPixelTransfer'.
+ transfers. The initial value is 1. See `glPixelTransfer'.
`GL_ALPHA_TEST'
PARAMS returns a single boolean value indicating whether alpha
- testing of fragments is enabled. The initial value is `GL_FALSE'.
+ testing of fragments is enabled. The initial value is `GL_FALSE'.
See `glAlphaFunc'.
`GL_ALPHA_TEST_FUNC'PARAMS returns one value,
- the symbolic name of the alpha test function. The initial value is
- `GL_ALWAYS'. See `glAlphaFunc'.
+ the symbolic name of the alpha test function. The initial value is
+ `GL_ALWAYS'. See `glAlphaFunc'.
`GL_ALPHA_TEST_REF'
PARAMS returns one value, the reference value for the alpha test.
- The initial value is 0. See `glAlphaFunc'. An integer value, if
+ The initial value is 0. See `glAlphaFunc'. 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
PARAMS returns a single value, the name of the buffer object
- currently bound to the target `GL_ARRAY_BUFFER'. If no buffer
- object is bound to this target, 0 is returned. The initial value
- is 0. See `glBindBuffer'.
+ currently bound to the target `GL_ARRAY_BUFFER'. If no buffer
+ object is bound to this target, 0 is returned. The initial value is
+ 0. See `glBindBuffer'.
`GL_ATTRIB_STACK_DEPTH'
- PARAMS returns one value, the depth of the attribute stack. If the
- stack is empty, 0 is returned. The initial value is 0. See
+ PARAMS returns one value, the depth of the attribute stack. If the
+ stack is empty, 0 is returned. The initial value is 0. See
`glPushAttrib'.
`GL_AUTO_NORMAL'
PARAMS returns a single boolean value indicating whether 2D map
- evaluation automatically generates surface normals. The initial
- value is `GL_FALSE'. See `glMap2'.
+ evaluation automatically generates surface normals. The initial
+ value is `GL_FALSE'. See `glMap2'.
`GL_AUX_BUFFERS'
PARAMS returns a single boolean value indicating whether blending
- is enabled. The initial value is `GL_FALSE'. See `glBlendFunc'.
+ is enabled. The initial value is `GL_FALSE'. See `glBlendFunc'.
`GL_BLEND_COLOR'
PARAMS returns four values, the red, green, blue, and alpha values
- which are the components of the blend color. See `glBlendColor'.
+ which are the components of the blend color. See `glBlendColor'.
`GL_BLEND_DST_ALPHA'
PARAMS returns one value, the symbolic constant identifying the
- alpha destination blend function. The initial value is `GL_ZERO'.
+ alpha destination blend function. The initial value is `GL_ZERO'.
See `glBlendFunc' and `glBlendFuncSeparate'.
`GL_BLEND_DST_RGB'
PARAMS returns one value, the symbolic constant identifying the RGB
- destination blend function. The initial value is `GL_ZERO'. See
+ destination blend function. The initial value is `GL_ZERO'. See
`glBlendFunc' and `glBlendFuncSeparate'.
`GL_BLEND_EQUATION_RGB'
PARAMS returns one value, a symbolic constant indicating whether
the RGB blend equation is `GL_FUNC_ADD', `GL_FUNC_SUBTRACT',
- `GL_FUNC_REVERSE_SUBTRACT', `GL_MIN' or `GL_MAX'. See
+ `GL_FUNC_REVERSE_SUBTRACT', `GL_MIN' or `GL_MAX'. See
`glBlendEquationSeparate'.
`GL_BLEND_EQUATION_ALPHA'
PARAMS returns one value, a symbolic constant indicating whether
the Alpha blend equation is `GL_FUNC_ADD', `GL_FUNC_SUBTRACT',
- `GL_FUNC_REVERSE_SUBTRACT', `GL_MIN' or `GL_MAX'. See
+ `GL_FUNC_REVERSE_SUBTRACT', `GL_MIN' or `GL_MAX'. See
`glBlendEquationSeparate'.
`GL_BLEND_SRC_ALPHA'
PARAMS returns one value, the symbolic constant identifying the
- alpha source blend function. The initial value is `GL_ONE'. See
+ alpha source blend function. The initial value is `GL_ONE'. See
`glBlendFunc' and `glBlendFuncSeparate'.
`GL_BLEND_SRC_RGB'
PARAMS returns one value, the symbolic constant identifying the RGB
- source blend function. The initial value is `GL_ONE'. See
+ source blend function. The initial value is `GL_ONE'. See
`glBlendFunc' and `glBlendFuncSeparate'.
`GL_BLUE_BIAS'
PARAMS returns one value, the blue bias factor used during pixel
- transfers. The initial value is 0. See `glPixelTransfer'.
+ transfers. The initial value is 0. See `glPixelTransfer'.
`GL_BLUE_BITS'
PARAMS returns one value, the blue scale factor used during pixel
- transfers. The initial value is 1. See `glPixelTransfer'.
+ transfers. The initial value is 1. See `glPixelTransfer'.
`GL_CLIENT_ACTIVE_TEXTURE'
PARAMS returns a single integer value indicating the current client
- active multitexture unit. The initial value is `GL_TEXTURE0'. See
+ active multitexture unit. The initial value is `GL_TEXTURE0'. See
`glClientActiveTexture'.
`GL_CLIENT_ATTRIB_STACK_DEPTH'
PARAMS returns one value indicating the depth of the attribute
- stack. The initial value is 0. See `glPushClientAttrib'.
+ stack. The initial value is 0. See `glPushClientAttrib'.
`GL_CLIP_PLANE'I
PARAMS returns a single boolean value indicating whether the
- specified clipping plane is enabled. The initial value is
- `GL_FALSE'. See `glClipPlane'.
+ specified clipping plane is enabled. The initial value is
+ `GL_FALSE'. See `glClipPlane'.
`GL_COLOR_ARRAY'
PARAMS returns a single boolean value indicating whether the color
- array is enabled. The initial value is `GL_FALSE'. See
+ array is enabled. The initial value is `GL_FALSE'. See
`glColorPointer'.
`GL_COLOR_ARRAY_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- associated with the color array. This buffer object would have
- been bound to the target `GL_ARRAY_BUFFER' at the time of the most
- recent call to `glColorPointer'. If no buffer object was bound to
- this target, 0 is returned. The initial value is 0. See
+ associated with the color array. This buffer object would have been
+ bound to the target `GL_ARRAY_BUFFER' at the time of the most
+ recent call to `glColorPointer'. If no buffer object was bound to
+ this target, 0 is returned. The initial value is 0. See
`glBindBuffer'.
`GL_COLOR_ARRAY_SIZE'
PARAMS returns one value, the number of components per color in the
- color array. The initial value is 4. See `glColorPointer'.
+ color array. The initial value is 4. See `glColorPointer'.
`GL_COLOR_ARRAY_STRIDE'
PARAMS returns one value, the byte offset between consecutive
- colors in the color array. The initial value is 0. See
+ colors in the color array. The initial value is 0. See
`glColorPointer'.
`GL_COLOR_ARRAY_TYPE'
PARAMS returns one value, the data type of each component in the
- color array. The initial value is `GL_FLOAT'. See
- `glColorPointer'.
+ color array. The initial value is `GL_FLOAT'. See `glColorPointer'.
`GL_COLOR_CLEAR_VALUE'
PARAMS returns four values: the red, green, blue, and alpha values
- used to clear the color buffers. Integer values, if requested, are
+ 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 `glClearColor'.
+ value. The initial value is (0, 0, 0, 0). See `glClearColor'.
`GL_COLOR_LOGIC_OP'
PARAMS 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 `GL_FALSE'. See
+ a logical operation. The initial value is `GL_FALSE'. See
`glLogicOp'.
`GL_COLOR_MATERIAL'
PARAMS returns a single boolean value indicating whether one or
- more material parameters are tracking the current color. The
- initial value is `GL_FALSE'. See `glColorMaterial'.
+ more material parameters are tracking the current color. The
+ initial value is `GL_FALSE'. See `glColorMaterial'.
`GL_COLOR_MATERIAL_FACE'
PARAMS returns one value, a symbolic constant indicating which
- materials have a parameter that is tracking the current color. The
- initial value is `GL_FRONT_AND_BACK'. See `glColorMaterial'.
+ materials have a parameter that is tracking the current color. The
+ initial value is `GL_FRONT_AND_BACK'. See `glColorMaterial'.
`GL_COLOR_MATERIAL_PARAMETER'
PARAMS returns one value, a symbolic constant indicating which
- material parameters are tracking the current color. The initial
- value is `GL_AMBIENT_AND_DIFFUSE'. See `glColorMaterial'.
+ material parameters are tracking the current color. The initial
+ value is `GL_AMBIENT_AND_DIFFUSE'. See `glColorMaterial'.
`GL_COLOR_MATRIX'
PARAMS returns sixteen values: the color matrix on the top of the
- color matrix stack. Initially this matrix is the identity matrix.
+ color matrix stack. Initially this matrix is the identity matrix.
See `glPushMatrix'.
`GL_COLOR_MATRIX_STACK_DEPTH'
PARAMS returns one value, the maximum supported depth of the
- projection matrix stack. The value must be at least 2. See
+ projection matrix stack. The value must be at least 2. See
`glPushMatrix'.
`GL_COLOR_SUM'
PARAMS returns a single boolean value indicating whether primary
- and secondary color sum is enabled. See `glSecondaryColor'.
+ and secondary color sum is enabled. See `glSecondaryColor'.
`GL_COLOR_TABLE'
PARAMS returns a single boolean value indicating whether the color
- table lookup is enabled. See `glColorTable'.
+ table lookup is enabled. See `glColorTable'.
`GL_COLOR_WRITEMASK'
PARAMS returns four boolean values: the red, green, blue, and alpha
- write enables for the color buffers. The initial value is
- (`GL_TRUE', `GL_TRUE', `GL_TRUE', `GL_TRUE'). See `glColorMask'.
+ write enables for the color buffers. The initial value is
+ (`GL_TRUE', `GL_TRUE', `GL_TRUE', `GL_TRUE'). See `glColorMask'.
`GL_COMPRESSED_TEXTURE_FORMATS'
PARAMS returns a list of symbolic constants of length
`GL_NUM_COMPRESSED_TEXTURE_FORMATS' indicating which compressed
- texture formats are available. See `glCompressedTexImage2D'.
+ texture formats are available. See `glCompressedTexImage2D'.
`GL_CONVOLUTION_1D'
PARAMS returns a single boolean value indicating whether 1D
- convolution is enabled. The initial value is `GL_FALSE'. See
+ convolution is enabled. The initial value is `GL_FALSE'. See
`glConvolutionFilter1D'.
`GL_CONVOLUTION_2D'
PARAMS returns a single boolean value indicating whether 2D
- convolution is enabled. The initial value is `GL_FALSE'. See
+ convolution is enabled. The initial value is `GL_FALSE'. See
`glConvolutionFilter2D'.
`GL_CULL_FACE'
PARAMS returns a single boolean value indicating whether polygon
- culling is enabled. The initial value is `GL_FALSE'. See
+ culling is enabled. The initial value is `GL_FALSE'. See
`glCullFace'.
`GL_CULL_FACE_MODE'
PARAMS returns one value, a symbolic constant indicating which
- polygon faces are to be culled. The initial value is `GL_BACK'.
- See `glCullFace'.
+ polygon faces are to be culled. The initial value is `GL_BACK'. See
+ `glCullFace'.
`GL_CURRENT_COLOR'
PARAMS returns four values: the red, green, blue, and alpha values
- of the current color. Integer values, if requested, are linearly
+ 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. The initial
- value is (1, 1, 1, 1). See `glColor'.
+ returns the most negative representable integer value. The initial
+ value is (1, 1, 1, 1). See `glColor'.
`GL_CURRENT_FOG_COORD'
- PARAMS returns one value, the current fog coordinate. The initial
- value is 0. See `glFogCoord'.
+ PARAMS returns one value, the current fog coordinate. The initial
+ value is 0. See `glFogCoord'.
`GL_CURRENT_INDEX'
- PARAMS returns one value, the current color index. The initial
- value is 1. See `glIndex'.
+ PARAMS returns one value, the current color index. The initial
+ value is 1. See `glIndex'.
`GL_CURRENT_NORMAL'
PARAMS returns three values: the X, Y, and Z values of the current
- normal. Integer values, if requested, are linearly mapped from the
+ 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 `glNormal'.
+ most negative representable integer value. The initial value is (0,
+ 0, 1). See `glNormal'.
`GL_CURRENT_PROGRAM'
PARAMS returns one value, the name of the program object that is
- currently active, or 0 if no program object is active. See
+ currently active, or 0 if no program object is active. See
`glUseProgram'.
`GL_CURRENT_RASTER_COLOR'
PARAMS returns four values: the red, green, blue, and alpha color
- values of the current raster position. Integer values, if
+ 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 `glRasterPos'.
+ representable integer value. The initial value is (1, 1, 1, 1). See
+ `glRasterPos'.
`GL_CURRENT_RASTER_DISTANCE'
PARAMS returns one value, the distance from the eye to the current
- raster position. The initial value is 0. See `glRasterPos'.
+ raster position. The initial value is 0. See `glRasterPos'.
`GL_CURRENT_RASTER_INDEX'
PARAMS returns one value, the color index of the current raster
- position. The initial value is 1. See `glRasterPos'.
+ position. The initial value is 1. See `glRasterPos'.
`GL_CURRENT_RASTER_POSITION'
PARAMS returns four values: the X, Y, Z, and W components of the
- current raster position. X, Y, and Z are in window coordinates,
- and W is in clip coordinates. The initial value is (0, 0, 0, 1).
- See `glRasterPos'.
+ current raster position. X, Y, and Z are in window coordinates, and
+ W is in clip coordinates. The initial value is (0, 0, 0, 1). See
+ `glRasterPos'.
`GL_CURRENT_RASTER_POSITION_VALID'
PARAMS returns a single boolean value indicating whether the
- current raster position is valid. The initial value is `GL_TRUE'.
+ current raster position is valid. The initial value is `GL_TRUE'.
See `glRasterPos'.
`GL_CURRENT_RASTER_SECONDARY_COLOR'
PARAMS returns four values: the red, green, blue, and alpha
- secondary color values of the current raster position. Integer
+ secondary color 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 `glRasterPos'.
+ negative representable integer value. The initial value is (1, 1,
+ 1, 1). See `glRasterPos'.
`GL_CURRENT_RASTER_TEXTURE_COORDS'
PARAMS returns four values: the S, T, R, and Q texture coordinates
- of the current raster position. The initial value is (0, 0, 0, 1).
+ of the current raster position. The initial value is (0, 0, 0, 1).
See `glRasterPos' and `glMultiTexCoord'.
`GL_CURRENT_SECONDARY_COLOR'
PARAMS returns four values: the red, green, blue, and alpha values
- of the current secondary color. Integer values, if requested, are
+ of the current secondary 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 `glSecondaryColor'.
+ value. The initial value is (0, 0, 0, 0). See `glSecondaryColor'.
`GL_CURRENT_TEXTURE_COORDS'
PARAMS returns four values: the S, T, R, and Q current texture
- coordinates. The initial value is (0, 0, 0, 1). See
+ coordinates. The initial value is (0, 0, 0, 1). See
`glMultiTexCoord'.
`GL_DEPTH_BIAS'
PARAMS returns one value, the depth bias factor used during pixel
- transfers. The initial value is 0. See `glPixelTransfer'.
+ transfers. The initial value is 0. See `glPixelTransfer'.
`GL_DEPTH_BITS'
PARAMS returns one value, the value that is used to clear the depth
- buffer. Integer values, if requested, are linearly mapped from the
+ 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.
+ most negative representable integer value. The initial value is 1.
See `glClearDepth'.
`GL_DEPTH_FUNC'
PARAMS returns one value, the symbolic constant that indicates the
- depth comparison function. The initial value is `GL_LESS'. See
+ depth comparison function. The initial value is `GL_LESS'. See
`glDepthFunc'.
`GL_DEPTH_RANGE'
PARAMS returns two values: the near and far mapping limits for the
- depth buffer. Integer values, if requested, are linearly mapped
+ 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 `glDepthRange'.
+ returns the most negative representable integer value. The initial
+ value is (0, 1). See `glDepthRange'.
`GL_DEPTH_SCALE'
PARAMS returns one value, the depth scale factor used during pixel
- transfers. The initial value is 1. See `glPixelTransfer'.
+ transfers. The initial value is 1. See `glPixelTransfer'.
`GL_DEPTH_TEST'
PARAMS returns a single boolean value indicating whether depth
- testing of fragments is enabled. The initial value is `GL_FALSE'.
+ testing of fragments is enabled. The initial value is `GL_FALSE'.
See `glDepthFunc' and `glDepthRange'.
`GL_DEPTH_WRITEMASK'
PARAMS returns a single boolean value indicating if the depth
- buffer is enabled for writing. The initial value is `GL_TRUE'. See
+ buffer is enabled for writing. The initial value is `GL_TRUE'. See
`glDepthMask'.
`GL_DITHER'
PARAMS returns a single boolean value indicating whether dithering
- of fragment colors and indices is enabled. The initial value is
+ of fragment colors and indices is enabled. The initial value is
`GL_TRUE'.
`GL_DOUBLEBUFFER'
PARAMS returns one value, a symbolic constant indicating which
- buffers are being drawn to. See `glDrawBuffer'. The initial value
+ buffers are being drawn to. See `glDrawBuffer'. The initial value
is `GL_BACK' if there are back buffers, otherwise it is `GL_FRONT'.
`GL_DRAW_BUFFER'I
PARAMS returns one value, a symbolic constant indicating which
- buffers are being drawn to by the corresponding output color. See
- `glDrawBuffers'. The initial value of `GL_DRAW_BUFFER0' is
+ buffers are being drawn to by the corresponding output color. See
+ `glDrawBuffers'. The initial value of `GL_DRAW_BUFFER0' is
`GL_BACK' if there are back buffers, otherwise it is `GL_FRONT'.
The initial values of draw buffers for all other output colors is
`GL_NONE'.
PARAMS returns a single boolean value indicating whether the
- current edge flag is `GL_TRUE' or `GL_FALSE'. The initial value is
- `GL_TRUE'. See `glEdgeFlag'.
+ current edge flag is `GL_TRUE' or `GL_FALSE'. The initial value is
+ `GL_TRUE'. See `glEdgeFlag'.
`GL_EDGE_FLAG_ARRAY'
PARAMS returns a single boolean value indicating whether the edge
- flag array is enabled. The initial value is `GL_FALSE'. See
+ flag array is enabled. The initial value is `GL_FALSE'. See
`glEdgeFlagPointer'.
`GL_EDGE_FLAG_ARRAY_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- associated with the edge flag array. This buffer object would have
+ associated with the edge flag array. This buffer object would have
been bound to the target `GL_ARRAY_BUFFER' at the time of the most
- recent call to `glEdgeFlagPointer'. If no buffer object was bound
- to this target, 0 is returned. The initial value is 0. See
+ recent call to `glEdgeFlagPointer'. If no buffer object was bound
+ to this target, 0 is returned. The initial value is 0. See
`glBindBuffer'.
`GL_EDGE_FLAG_ARRAY_STRIDE'
PARAMS returns one value, the byte offset between consecutive edge
- flags in the edge flag array. The initial value is 0. See
+ flags in the edge flag array. The initial value is 0. See
`glEdgeFlagPointer'.
`GL_ELEMENT_ARRAY_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- currently bound to the target `GL_ELEMENT_ARRAY_BUFFER'. If no
- buffer object is bound to this target, 0 is returned. The initial
- value is 0. See `glBindBuffer'.
+ currently bound to the target `GL_ELEMENT_ARRAY_BUFFER'. If no
+ buffer object is bound to this target, 0 is returned. The initial
+ value is 0. See `glBindBuffer'.
`GL_FEEDBACK_BUFFER_SIZE'
- PARAMS returns one value, the size of the feedback buffer. See
+ PARAMS returns one value, the size of the feedback buffer. See
`glFeedbackBuffer'.
`GL_FEEDBACK_BUFFER_TYPE'
- PARAMS returns one value, the type of the feedback buffer. See
+ PARAMS returns one value, the type of the feedback buffer. See
`glFeedbackBuffer'.
`GL_FOG'
PARAMS returns a single boolean value indicating whether fogging is
- enabled. The initial value is `GL_FALSE'. See `glFog'.
+ enabled. The initial value is `GL_FALSE'. See `glFog'.
`GL_FOG_COORD_ARRAY'
PARAMS returns a single boolean value indicating whether the fog
- coordinate array is enabled. The initial value is `GL_FALSE'. See
+ coordinate array is enabled. The initial value is `GL_FALSE'. See
`glFogCoordPointer'.
`GL_FOG_COORD_ARRAY_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- associated with the fog coordinate array. This buffer object would
+ associated with the fog coordinate array. This buffer object would
have been bound to the target `GL_ARRAY_BUFFER' at the time of the
- most recent call to `glFogCoordPointer'. If no buffer object was
- bound to this target, 0 is returned. The initial value is 0. See
+ most recent call to `glFogCoordPointer'. If no buffer object was
+ bound to this target, 0 is returned. The initial value is 0. See
`glBindBuffer'.
`GL_FOG_COORD_ARRAY_STRIDE'
PARAMS returns one value, the byte offset between consecutive fog
- coordinates in the fog coordinate array. The initial value is 0.
+ coordinates in the fog coordinate array. The initial value is 0.
See `glFogCoordPointer'.
`GL_FOG_COORD_ARRAY_TYPE'
- PARAMS returns one value, the type of the fog coordinate array. The
- initial value is `GL_FLOAT'. See `glFogCoordPointer'.
+ PARAMS returns one value, the type of the fog coordinate array. The
+ initial value is `GL_FLOAT'. See `glFogCoordPointer'.
`GL_FOG_COORD_SRC'
PARAMS returns one value, a symbolic constant indicating the source
- of the fog coordinate. The initial value is `GL_FRAGMENT_DEPTH'.
+ of the fog coordinate. The initial value is `GL_FRAGMENT_DEPTH'.
See `glFog'.
`GL_FOG_COLOR'
PARAMS returns four values: the red, green, blue, and alpha
- components of the fog color. Integer values, if requested, are
+ 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 `glFog'.
+ value. The initial value is (0, 0, 0, 0). See `glFog'.
`GL_FOG_DENSITY'
- PARAMS returns one value, the fog density parameter. The initial
- value is 1. See `glFog'.
+ PARAMS returns one value, the fog density parameter. The initial
+ value is 1. See `glFog'.
`GL_FOG_END'
PARAMS returns one value, the end factor for the linear fog
- equation. The initial value is 1. See `glFog'.
+ equation. The initial value is 1. See `glFog'.
`GL_FOG_HINT'
PARAMS returns one value, a symbolic constant indicating the mode
- of the fog hint. The initial value is `GL_DONT_CARE'. See
- `glHint'.
+ of the fog hint. The initial value is `GL_DONT_CARE'. See `glHint'.
`GL_FOG_INDEX'
- PARAMS returns one value, the fog color index. The initial value
- is 0. See `glFog'.
+ PARAMS returns one value, the fog color index. The initial value is
+ 0. See `glFog'.
`GL_FOG_MODE'
PARAMS returns one value, a symbolic constant indicating which fog
- equation is selected. The initial value is `GL_EXP'. See `glFog'.
+ equation is selected. The initial value is `GL_EXP'. See `glFog'.
`GL_FOG_START'
PARAMS returns one value, the start factor for the linear fog
- equation. The initial value is 0. See `glFog'.
+ equation. The initial value is 0. See `glFog'.
`GL_FRAGMENT_SHADER_DERIVATIVE_HINT'
PARAMS returns one value, a symbolic constant indicating the mode
- of the derivative accuracy hint for fragment shaders. The initial
- value is `GL_DONT_CARE'. See `glHint'.
+ of the derivative accuracy hint for fragment shaders. The initial
+ value is `GL_DONT_CARE'. See `glHint'.
`GL_FRONT_FACE'
PARAMS returns one value, a symbolic constant indicating whether
clockwise or counterclockwise polygon winding is treated as
- front-facing. The initial value is `GL_CCW'. See `glFrontFace'.
+ front-facing. The initial value is `GL_CCW'. See `glFrontFace'.
`GL_GENERATE_MIPMAP_HINT'
PARAMS returns one value, a symbolic constant indicating the mode
- of the mipmap generation filtering hint. The initial value is
- `GL_DONT_CARE'. See `glHint'.
+ of the mipmap generation filtering hint. The initial value is
+ `GL_DONT_CARE'. See `glHint'.
`GL_GREEN_BIAS'
PARAMS returns one value, the green bias factor used during pixel
- transfers. The initial value is 0.
+ transfers. The initial value is 0.
`GL_GREEN_BITS'
PARAMS returns one value, the green scale factor used during pixel
- transfers. The initial value is 1. See `glPixelTransfer'.
+ transfers. The initial value is 1. See `glPixelTransfer'.
`GL_HISTOGRAM'
PARAMS returns a single boolean value indicating whether histogram
- is enabled. The initial value is `GL_FALSE'. See `glHistogram'.
+ is enabled. The initial value is `GL_FALSE'. See `glHistogram'.
`GL_INDEX_ARRAY'
PARAMS returns a single boolean value indicating whether the color
- index array is enabled. The initial value is `GL_FALSE'. See
+ index array is enabled. The initial value is `GL_FALSE'. See
`glIndexPointer'.
`GL_INDEX_ARRAY_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- associated with the color index array. This buffer object would
+ associated with the color index array. This buffer object would
have been bound to the target `GL_ARRAY_BUFFER' at the time of the
- most recent call to `glIndexPointer'. If no buffer object was
- bound to this target, 0 is returned. The initial value is 0. See
+ most recent call to `glIndexPointer'. If no buffer object was bound
+ to this target, 0 is returned. The initial value is 0. See
`glBindBuffer'.
`GL_INDEX_ARRAY_STRIDE'
PARAMS returns one value, the byte offset between consecutive color
- indexes in the color index array. The initial value is 0. See
+ indexes in the color index array. The initial value is 0. See
`glIndexPointer'.
`GL_INDEX_ARRAY_TYPE'
PARAMS returns one value, the data type of indexes in the color
- index array. The initial value is `GL_FLOAT'. See
- `glIndexPointer'.
+ index array. The initial value is `GL_FLOAT'. See `glIndexPointer'.
`GL_INDEX_BITS'
PARAMS returns one value, the color index used to clear the color
- index buffers. The initial value is 0. See `glClearIndex'.
+ index buffers. The initial value is 0. See `glClearIndex'.
`GL_INDEX_LOGIC_OP'
PARAMS 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 `GL_FALSE'. See
+ logical operation. The initial value is `GL_FALSE'. See
`glLogicOp'.
`GL_INDEX_MODE'
PARAMS returns one value, the offset added to color and stencil
- indices during pixel transfers. The initial value is 0. See
+ indices during pixel transfers. The initial value is 0. See
`glPixelTransfer'.
`GL_INDEX_SHIFT'
PARAMS returns one value, the amount that color and stencil indices
- are shifted during pixel transfers. The initial value is 0. See
+ are shifted during pixel transfers. The initial value is 0. See
`glPixelTransfer'.
`GL_INDEX_WRITEMASK'
PARAMS returns one value, a mask indicating which bitplanes of each
- color index buffer can be written. The initial value is all 1's.
+ color index buffer can be written. The initial value is all 1's.
See `glIndexMask'.
`GL_LIGHT'I
PARAMS returns a single boolean value indicating whether the
- specified light is enabled. The initial value is `GL_FALSE'. See
+ specified light is enabled. The initial value is `GL_FALSE'. See
`glLight' and `glLightModel'.
`GL_LIGHTING'
PARAMS returns a single boolean value indicating whether lighting
- is enabled. The initial value is `GL_FALSE'. See `glLightModel'.
+ is enabled. The initial value is `GL_FALSE'. See `glLightModel'.
`GL_LIGHT_MODEL_AMBIENT'
PARAMS returns four values: the red, green, blue, and alpha
- components of the ambient intensity of the entire scene. Integer
+ 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 `glLightModel'.
+ negative representable integer value. The initial value is (0.2,
+ 0.2, 0.2, 1.0). See `glLightModel'.
`GL_LIGHT_MODEL_COLOR_CONTROL'
PARAMS returns single enumerated value indicating whether specular
reflection calculations are separated from normal lighting
- computations. The initial value is `GL_SINGLE_COLOR'.
+ computations. The initial value is `GL_SINGLE_COLOR'.
`GL_LIGHT_MODEL_LOCAL_VIEWER'
PARAMS returns a single boolean value indicating whether specular
reflection calculations treat the viewer as being local to the
- scene. The initial value is `GL_FALSE'. See `glLightModel'.
+ scene. The initial value is `GL_FALSE'. See `glLightModel'.
`GL_LIGHT_MODEL_TWO_SIDE'
PARAMS returns a single boolean value indicating whether separate
materials are used to compute lighting for front- and back-facing
- polygons. The initial value is `GL_FALSE'. See `glLightModel'.
+ polygons. The initial value is `GL_FALSE'. See `glLightModel'.
`GL_LINE_SMOOTH'
PARAMS returns a single boolean value indicating whether
- antialiasing of lines is enabled. The initial value is `GL_FALSE'.
+ antialiasing of lines is enabled. The initial value is `GL_FALSE'.
See `glLineWidth'.
`GL_LINE_SMOOTH_HINT'
PARAMS returns one value, a symbolic constant indicating the mode
- of the line antialiasing hint. The initial value is
- `GL_DONT_CARE'. See `glHint'.
+ of the line antialiasing hint. The initial value is `GL_DONT_CARE'.
+ See `glHint'.
`GL_LINE_STIPPLE'
PARAMS returns a single boolean value indicating whether stippling
- of lines is enabled. The initial value is `GL_FALSE'. See
+ of lines is enabled. The initial value is `GL_FALSE'. See
`glLineStipple'.
`GL_LINE_STIPPLE_PATTERN'
- PARAMS returns one value, the 16-bit line stipple pattern. The
- initial value is all 1's. See `glLineStipple'.
+ PARAMS returns one value, the 16-bit line stipple pattern. The
+ initial value is all 1's. See `glLineStipple'.
`GL_LINE_STIPPLE_REPEAT'
- PARAMS returns one value, the line stipple repeat factor. The
- initial value is 1. See `glLineStipple'.
+ PARAMS returns one value, the line stipple repeat factor. The
+ initial value is 1. See `glLineStipple'.
`GL_LINE_WIDTH'
PARAMS returns one value, the line width as specified with
- `glLineWidth'. The initial value is 1.
+ `glLineWidth'. The initial value is 1.
`GL_LINE_WIDTH_GRANULARITY'
PARAMS returns one value, the width difference between adjacent
- supported widths for antialiased lines. See `glLineWidth'.
+ supported widths for antialiased lines. See `glLineWidth'.
`GL_LINE_WIDTH_RANGE'
PARAMS returns two values: the smallest and largest supported
- widths for antialiased lines. See `glLineWidth'.
+ widths for antialiased lines. See `glLineWidth'.
`GL_LIST_BASE'
PARAMS returns one value, the base offset added to all names in
- arrays presented to `glCallLists'. The initial value is 0. See
+ arrays presented to `glCallLists'. The initial value is 0. See
`glListBase'.
`GL_LIST_INDEX'
PARAMS 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 `glNewList'.
+ under construction. 0 is returned if no display list is currently
+ under construction. The initial value is 0. See `glNewList'.
`GL_LIST_MODE'
PARAMS returns one value, a symbolic constant indicating the
construction mode of the display list currently under construction.
- The initial value is 0. See `glNewList'.
+ The initial value is 0. See `glNewList'.
`GL_LOGIC_OP_MODE'
PARAMS returns one value, a symbolic constant indicating the
- selected logic operation mode. The initial value is `GL_COPY'. See
+ selected logic operation mode. The initial value is `GL_COPY'. See
`glLogicOp'.
`GL_MAP1_COLOR_4'
PARAMS returns a single boolean value indicating whether 1D
- evaluation generates colors. The initial value is `GL_FALSE'. See
+ evaluation generates colors. The initial value is `GL_FALSE'. See
`glMap1'.
`GL_MAP1_GRID_DOMAIN'
PARAMS returns two values: the endpoints of the 1D map's grid
- domain. The initial value is (0, 1). See `glMapGrid'.
+ domain. The initial value is (0, 1). See `glMapGrid'.
`GL_MAP1_GRID_SEGMENTS'
PARAMS returns one value, the number of partitions in the 1D map's
- grid domain. The initial value is 1. See `glMapGrid'.
+ grid domain. The initial value is 1. See `glMapGrid'.
`GL_MAP1_INDEX'
PARAMS returns a single boolean value indicating whether 1D
- evaluation generates color indices. The initial value is
- `GL_FALSE'. See `glMap1'.
+ evaluation generates color indices. The initial value is
+ `GL_FALSE'. See `glMap1'.
`GL_MAP1_NORMAL'
PARAMS returns a single boolean value indicating whether 1D
- evaluation generates normals. The initial value is `GL_FALSE'. See
+ evaluation generates normals. The initial value is `GL_FALSE'. See
`glMap1'.
`GL_MAP1_TEXTURE_COORD_1'
PARAMS returns a single boolean value indicating whether 1D
- evaluation generates 1D texture coordinates. The initial value is
- `GL_FALSE'. See `glMap1'.
+ evaluation generates 1D texture coordinates. The initial value is
+ `GL_FALSE'. See `glMap1'.
`GL_MAP1_TEXTURE_COORD_2'
PARAMS returns a single boolean value indicating whether 1D
- evaluation generates 2D texture coordinates. The initial value is
- `GL_FALSE'. See `glMap1'.
+ evaluation generates 2D texture coordinates. The initial value is
+ `GL_FALSE'. See `glMap1'.
`GL_MAP1_TEXTURE_COORD_3'
PARAMS returns a single boolean value indicating whether 1D
- evaluation generates 3D texture coordinates. The initial value is
- `GL_FALSE'. See `glMap1'.
+ evaluation generates 3D texture coordinates. The initial value is
+ `GL_FALSE'. See `glMap1'.
`GL_MAP1_TEXTURE_COORD_4'
PARAMS returns a single boolean value indicating whether 1D
- evaluation generates 4D texture coordinates. The initial value is
- `GL_FALSE'. See `glMap1'.
+ evaluation generates 4D texture coordinates. The initial value is
+ `GL_FALSE'. See `glMap1'.
`GL_MAP1_VERTEX_3'
PARAMS returns a single boolean value indicating whether 1D
- evaluation generates 3D vertex coordinates. The initial value is
- `GL_FALSE'. See `glMap1'.
+ evaluation generates 3D vertex coordinates. The initial value is
+ `GL_FALSE'. See `glMap1'.
`GL_MAP1_VERTEX_4'
PARAMS returns a single boolean value indicating whether 1D
- evaluation generates 4D vertex coordinates. The initial value is
- `GL_FALSE'. See `glMap1'.
+ evaluation generates 4D vertex coordinates. The initial value is
+ `GL_FALSE'. See `glMap1'.
`GL_MAP2_COLOR_4'
PARAMS returns a single boolean value indicating whether 2D
- evaluation generates colors. The initial value is `GL_FALSE'. See
+ evaluation generates colors. The initial value is `GL_FALSE'. See
`glMap2'.
`GL_MAP2_GRID_DOMAIN'
PARAMS returns four values: the endpoints of the 2D map's I and J
- grid domains. The initial value is (0,1; 0,1). See `glMapGrid'.
+ grid domains. The initial value is (0,1; 0,1). See `glMapGrid'.
`GL_MAP2_GRID_SEGMENTS'
PARAMS returns two values: the number of partitions in the 2D map's
- I and J grid domains. The initial value is (1,1). See
- `glMapGrid'.
+ I and J grid domains. The initial value is (1,1). See `glMapGrid'.
`GL_MAP2_INDEX'
PARAMS returns a single boolean value indicating whether 2D
- evaluation generates color indices. The initial value is
- `GL_FALSE'. See `glMap2'.
+ evaluation generates color indices. The initial value is
+ `GL_FALSE'. See `glMap2'.
`GL_MAP2_NORMAL'
PARAMS returns a single boolean value indicating whether 2D
- evaluation generates normals. The initial value is `GL_FALSE'. See
+ evaluation generates normals. The initial value is `GL_FALSE'. See
`glMap2'.
`GL_MAP2_TEXTURE_COORD_1'
PARAMS returns a single boolean value indicating whether 2D
- evaluation generates 1D texture coordinates. The initial value is
- `GL_FALSE'. See `glMap2'.
+ evaluation generates 1D texture coordinates. The initial value is
+ `GL_FALSE'. See `glMap2'.
`GL_MAP2_TEXTURE_COORD_2'
PARAMS returns a single boolean value indicating whether 2D
- evaluation generates 2D texture coordinates. The initial value is
- `GL_FALSE'. See `glMap2'.
+ evaluation generates 2D texture coordinates. The initial value is
+ `GL_FALSE'. See `glMap2'.
`GL_MAP2_TEXTURE_COORD_3'
PARAMS returns a single boolean value indicating whether 2D
- evaluation generates 3D texture coordinates. The initial value is
- `GL_FALSE'. See `glMap2'.
+ evaluation generates 3D texture coordinates. The initial value is
+ `GL_FALSE'. See `glMap2'.
`GL_MAP2_TEXTURE_COORD_4'
PARAMS returns a single boolean value indicating whether 2D
- evaluation generates 4D texture coordinates. The initial value is
- `GL_FALSE'. See `glMap2'.
+ evaluation generates 4D texture coordinates. The initial value is
+ `GL_FALSE'. See `glMap2'.
`GL_MAP2_VERTEX_3'
PARAMS returns a single boolean value indicating whether 2D
- evaluation generates 3D vertex coordinates. The initial value is
- `GL_FALSE'. See `glMap2'.
+ evaluation generates 3D vertex coordinates. The initial value is
+ `GL_FALSE'. See `glMap2'.
`GL_MAP2_VERTEX_4'
PARAMS returns a single boolean value indicating whether 2D
- evaluation generates 4D vertex coordinates. The initial value is
- `GL_FALSE'. See `glMap2'.
+ evaluation generates 4D vertex coordinates. The initial value is
+ `GL_FALSE'. See `glMap2'.
`GL_MAP_COLOR'
PARAMS 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 `GL_FALSE'. See
- `glPixelTransfer'.
+ transfers. The initial value is `GL_FALSE'. See `glPixelTransfer'.
`GL_MAP_STENCIL'
PARAMS returns a single boolean value indicating if stencil indices
- are to be replaced by table lookup during pixel transfers. The
- initial value is `GL_FALSE'. See `glPixelTransfer'.
+ are to be replaced by table lookup during pixel transfers. The
+ initial value is `GL_FALSE'. See `glPixelTransfer'.
`GL_MATRIX_MODE'
PARAMS returns one value, a symbolic constant indicating which
- matrix stack is currently the target of all matrix operations. The
- initial value is `GL_MODELVIEW'. See `glMatrixMode'.
+ matrix stack is currently the target of all matrix operations. The
+ initial value is `GL_MODELVIEW'. See `glMatrixMode'.
`GL_MAX_3D_TEXTURE_SIZE'
PARAMS returns one value, a rough estimate of the largest 3D
- texture that the GL can handle. The value must be at least 16. If
+ texture that the GL can handle. The value must be at least 16. If
the GL version is 1.2 or greater, use `GL_PROXY_TEXTURE_3D' to
- determine if a texture is too large. See `glTexImage3D'.
+ determine if a texture is too large. See `glTexImage3D'.
`GL_MAX_CLIENT_ATTRIB_STACK_DEPTH'
PARAMS returns one value indicating the maximum supported depth of
- the client attribute stack. See `glPushClientAttrib'.
+ the client attribute stack. See `glPushClientAttrib'.
`GL_MAX_ATTRIB_STACK_DEPTH'
PARAMS returns one value, the maximum supported depth of the
- attribute stack. The value must be at least 16. See
- `glPushAttrib'.
+ attribute stack. The value must be at least 16. See `glPushAttrib'.
`GL_MAX_CLIP_PLANES'
PARAMS returns one value, the maximum number of application-defined
- clipping planes. The value must be at least 6. See `glClipPlane'.
+ clipping planes. The value must be at least 6. See `glClipPlane'.
`GL_MAX_COLOR_MATRIX_STACK_DEPTH'
PARAMS returns one value, the maximum supported depth of the color
- matrix stack. The value must be at least 2. See `glPushMatrix'.
+ matrix stack. The value must be at least 2. See `glPushMatrix'.
`GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS'
PARAMS returns one value, the maximum supported texture image units
that can be used to access texture maps from the vertex shader and
- the fragment processor combined. If both the vertex shader and the
+ the fragment processor combined. If both the vertex shader and the
fragment processing stage access the same texture image unit, then
that counts as using two texture image units against this limit.
- The value must be at least 2. See `glActiveTexture'.
+ The value must be at least 2. See `glActiveTexture'.
`GL_MAX_CUBE_MAP_TEXTURE_SIZE'
- PARAMS returns one value. The value gives a rough estimate of the
- largest cube-map texture that the GL can handle. The value must be
- at least 16. If the GL version is 1.3 or greater, use
+ PARAMS returns one value. The value gives a rough estimate of the
+ largest cube-map texture that the GL can handle. The value must be
+ at least 16. If the GL version is 1.3 or greater, use
`GL_PROXY_TEXTURE_CUBE_MAP' to determine if a texture is too large.
See `glTexImage2D'.
PARAMS returns one value, the maximum number of simultaneous output
colors allowed from a fragment shader using the `gl_FragData'
- built-in array. The value must be at least 1. See
- `glDrawBuffers'.
+ built-in array. The value must be at least 1. See `glDrawBuffers'.
`GL_MAX_ELEMENTS_INDICES'
PARAMS returns one value, the recommended maximum number of vertex
- array indices. See `glDrawRangeElements'.
+ array indices. See `glDrawRangeElements'.
`GL_MAX_ELEMENTS_VERTICES'
PARAMS returns one value, the recommended maximum number of vertex
- array vertices. See `glDrawRangeElements'.
+ array vertices. See `glDrawRangeElements'.
`GL_MAX_EVAL_ORDER'
PARAMS returns one value, the maximum equation order supported by
- 1D and 2D evaluators. The value must be at least 8. See `glMap1'
+ 1D and 2D evaluators. The value must be at least 8. See `glMap1'
and `glMap2'.
`GL_MAX_FRAGMENT_UNIFORM_COMPONENTS'
PARAMS returns one value, the maximum number of individual
floating-point, integer, or boolean values that can be held in
- uniform variable storage for a fragment shader. The value must be
- at least 64. See `glUniform'.
+ uniform variable storage for a fragment shader. The value must be
+ at least 64. See `glUniform'.
`GL_MAX_LIGHTS'
- PARAMS returns one value, the maximum number of lights. The value
- must be at least 8. See `glLight'.
+ PARAMS returns one value, the maximum number of lights. The value
+ must be at least 8. See `glLight'.
`GL_MAX_LIST_NESTING'
PARAMS returns one value, the maximum recursion depth allowed
- during display-list traversal. The value must be at least 64. See
+ during display-list traversal. The value must be at least 64. See
`glCallList'.
`GL_MAX_MODELVIEW_STACK_DEPTH'
PARAMS returns one value, the maximum supported depth of the
- modelview matrix stack. The value must be at least 32. See
+ modelview matrix stack. The value must be at least 32. See
`glPushMatrix'.
`GL_MAX_NAME_STACK_DEPTH'
PARAMS returns one value, the maximum supported depth of the
- selection name stack. The value must be at least 64. See
+ selection name stack. The value must be at least 64. See
`glPushName'.
`GL_MAX_PIXEL_MAP_TABLE'
PARAMS returns one value, the maximum supported size of a
- `glPixelMap' lookup table. The value must be at least 32. See
+ `glPixelMap' lookup table. The value must be at least 32. See
`glPixelMap'.
`GL_MAX_PROJECTION_STACK_DEPTH'
PARAMS returns one value, the maximum supported depth of the
- projection matrix stack. The value must be at least 2. See
+ projection matrix stack. The value must be at least 2. See
`glPushMatrix'.
`GL_MAX_TEXTURE_COORDS'
PARAMS returns one value, the maximum number of texture coordinate
- sets available to vertex and fragment shaders. The value must be
- at least 2. See `glActiveTexture' and `glClientActiveTexture'.
+ sets available to vertex and fragment shaders. The value must be at
+ least 2. See `glActiveTexture' and `glClientActiveTexture'.
`GL_MAX_TEXTURE_IMAGE_UNITS'
PARAMS returns one value, the maximum supported texture image units
that can be used to access texture maps from the fragment shader.
- The value must be at least 2. See `glActiveTexture'.
+ The value must be at least 2. See `glActiveTexture'.
`GL_MAX_TEXTURE_LOD_BIAS'
PARAMS returns one value, the maximum, absolute value of the
- texture level-of-detail bias. The value must be at least 4.
+ texture level-of-detail bias. The value must be at least 4.
`GL_MAX_TEXTURE_SIZE'
- PARAMS returns one value. The value gives a rough estimate of the
- largest texture that the GL can handle. The value must be at least
- 64. If the GL version is 1.1 or greater, use `GL_PROXY_TEXTURE_1D'
+ PARAMS returns one value. The value gives a rough estimate of the
+ largest texture that the GL can handle. The value must be at least
+ 64. If the GL version is 1.1 or greater, use `GL_PROXY_TEXTURE_1D'
or `GL_PROXY_TEXTURE_2D' to determine if a texture is too large.
See `glTexImage1D' and `glTexImage2D'.
PARAMS returns one value, the maximum supported depth of the
- texture matrix stack. The value must be at least 2. See
+ texture matrix stack. The value must be at least 2. See
`glPushMatrix'.
`GL_MAX_TEXTURE_UNITS'
PARAMS returns a single value indicating the number of conventional
- texture units supported. Each conventional texture unit includes
+ texture units supported. Each conventional texture unit includes
both a texture coordinate set and a texture image unit.
Conventional texture units may be used for fixed-function
- (non-shader) rendering. The value must be at least 2. Additional
+ (non-shader) rendering. The value must be at least 2. Additional
texture coordinate sets and texture image units may be accessed
- from vertex and fragment shaders. See `glActiveTexture' and
+ from vertex and fragment shaders. See `glActiveTexture' and
`glClientActiveTexture'.
`GL_MAX_VARYING_FLOATS'
PARAMS returns one value, the maximum number of interpolators
available for processing varying variables used by vertex and
- fragment shaders. This value represents the number of individual
+ fragment shaders. This value represents the number of individual
floating-point values that can be interpolated; varying variables
declared as vectors, matrices, and arrays will all consume multiple
- interpolators. The value must be at least 32.
+ interpolators. The value must be at least 32.
`GL_MAX_VERTEX_ATTRIBS'
PARAMS returns one value, the maximum number of 4-component generic
- vertex attributes accessible to a vertex shader. The value must be
- at least 16. See `glVertexAttrib'.
+ vertex attributes accessible to a vertex shader. The value must be
+ at least 16. See `glVertexAttrib'.
`GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS'
PARAMS returns one value, the maximum supported texture image units
- that can be used to access texture maps from the vertex shader. The
- value may be 0. See `glActiveTexture'.
+ that can be used to access texture maps from the vertex shader. The
+ value may be 0. See `glActiveTexture'.
`GL_MAX_VERTEX_UNIFORM_COMPONENTS'
PARAMS returns one value, the maximum number of individual
floating-point, integer, or boolean values that can be held in
- uniform variable storage for a vertex shader. The value must be at
- least 512. See `glUniform'.
+ uniform variable storage for a vertex shader. The value must be at
+ least 512. See `glUniform'.
`GL_MAX_VIEWPORT_DIMS'
PARAMS 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 `glViewport'.
+ of the viewport. These must be at least as large as the visible
+ dimensions of the display being rendered to. See `glViewport'.
`GL_MINMAX'
PARAMS returns a single boolean value indicating whether pixel
- minmax values are computed. The initial value is `GL_FALSE'. See
+ minmax values are computed. The initial value is `GL_FALSE'. See
`glMinmax'.
`GL_MODELVIEW_MATRIX'
PARAMS returns sixteen values: the modelview matrix on the top of
- the modelview matrix stack. Initially this matrix is the identity
- matrix. See `glPushMatrix'.
+ the modelview matrix stack. Initially this matrix is the identity
+ matrix. See `glPushMatrix'.
`GL_MODELVIEW_STACK_DEPTH'
PARAMS returns one value, the number of matrices on the modelview
- matrix stack. The initial value is 1. See `glPushMatrix'.
+ matrix stack. The initial value is 1. See `glPushMatrix'.
`GL_NAME_STACK_DEPTH'
PARAMS returns one value, the number of names on the selection name
- stack. The initial value is 0. See `glPushName'.
+ stack. The initial value is 0. See `glPushName'.
`GL_NORMAL_ARRAY'
PARAMS returns a single boolean value, indicating whether the
- normal array is enabled. The initial value is `GL_FALSE'. See
+ normal array is enabled. The initial value is `GL_FALSE'. See
`glNormalPointer'.
`GL_NORMAL_ARRAY_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- associated with the normal array. This buffer object would have
+ associated with the normal array. This buffer object would have
been bound to the target `GL_ARRAY_BUFFER' at the time of the most
- recent call to `glNormalPointer'. If no buffer object was bound to
- this target, 0 is returned. The initial value is 0. See
+ recent call to `glNormalPointer'. If no buffer object was bound to
+ this target, 0 is returned. The initial value is 0. See
`glBindBuffer'.
`GL_NORMAL_ARRAY_STRIDE'
PARAMS returns one value, the byte offset between consecutive
- normals in the normal array. The initial value is 0. See
+ normals in the normal array. The initial value is 0. See
`glNormalPointer'.
`GL_NORMAL_ARRAY_TYPE'
PARAMS returns one value, the data type of each coordinate in the
- normal array. The initial value is `GL_FLOAT'. See
+ normal array. The initial value is `GL_FLOAT'. See
`glNormalPointer'.
`GL_NORMALIZE'
PARAMS 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 `GL_FALSE'.
+ transformed to eye coordinates. The initial value is `GL_FALSE'.
See `glNormal'.
`GL_NUM_COMPRESSED_TEXTURE_FORMATS'
PARAMS returns a single integer value indicating the number of
- available compressed texture formats. The minimum value is 0. See
+ available compressed texture formats. The minimum value is 0. See
`glCompressedTexImage2D'.
`GL_PACK_ALIGNMENT'
PARAMS returns one value, the byte alignment used for writing pixel
- data to memory. The initial value is 4. See `glPixelStore'.
+ data to memory. The initial value is 4. See `glPixelStore'.
`GL_PACK_IMAGE_HEIGHT'
PARAMS returns one value, the image height used for writing pixel
- data to memory. The initial value is 0. See `glPixelStore'.
+ data to memory. The initial value is 0. See `glPixelStore'.
`GL_PACK_LSB_FIRST'
PARAMS 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
- `GL_FALSE'. See `glPixelStore'.
+ significant bit of each unsigned byte. The initial value is
+ `GL_FALSE'. See `glPixelStore'.
`GL_PACK_ROW_LENGTH'
PARAMS returns one value, the row length used for writing pixel
- data to memory. The initial value is 0. See `glPixelStore'.
+ data to memory. The initial value is 0. See `glPixelStore'.
`GL_PACK_SKIP_IMAGES'
PARAMS returns one value, the number of pixel images skipped before
- the first pixel is written into memory. The initial value is 0.
- See `glPixelStore'.
+ the first pixel is written into memory. The initial value is 0. See
+ `glPixelStore'.
`GL_PACK_SKIP_PIXELS'
PARAMS returns one value, the number of pixel locations skipped
- before the first pixel is written into memory. The initial value
- is 0. See `glPixelStore'.
+ before the first pixel is written into memory. The initial value is
+ 0. See `glPixelStore'.
`GL_PACK_SKIP_ROWS'
PARAMS 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 `glPixelStore'.
+ skipped before the first pixel is written into memory. The initial
+ value is 0. See `glPixelStore'.
`GL_PACK_SWAP_BYTES'
PARAMS 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 `GL_FALSE'.
+ before being written to memory. The initial value is `GL_FALSE'.
See `glPixelStore'.
`GL_PERSPECTIVE_CORRECTION_HINT'
PARAMS returns one value, a symbolic constant indicating the mode
- of the perspective correction hint. The initial value is
- `GL_DONT_CARE'. See `glHint'.
+ of the perspective correction hint. The initial value is
+ `GL_DONT_CARE'. See `glHint'.
`GL_PIXEL_MAP_A_TO_A_SIZE'
PARAMS returns one value, the size of the alpha-to-alpha pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_MAP_B_TO_B_SIZE'
PARAMS returns one value, the size of the blue-to-blue pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_MAP_G_TO_G_SIZE'
PARAMS returns one value, the size of the green-to-green pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_MAP_I_TO_A_SIZE'
PARAMS returns one value, the size of the index-to-alpha pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_MAP_I_TO_B_SIZE'
PARAMS returns one value, the size of the index-to-blue pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_MAP_I_TO_G_SIZE'
PARAMS returns one value, the size of the index-to-green pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_MAP_I_TO_I_SIZE'
PARAMS returns one value, the size of the index-to-index pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_MAP_I_TO_R_SIZE'
PARAMS returns one value, the size of the index-to-red pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_MAP_R_TO_R_SIZE'
PARAMS returns one value, the size of the red-to-red pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_MAP_S_TO_S_SIZE'
PARAMS returns one value, the size of the stencil-to-stencil pixel
- translation table. The initial value is 1. See `glPixelMap'.
+ translation table. The initial value is 1. See `glPixelMap'.
`GL_PIXEL_PACK_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- currently bound to the target `GL_PIXEL_PACK_BUFFER'. If no buffer
- object is bound to this target, 0 is returned. The initial value
- is 0. See `glBindBuffer'.
+ currently bound to the target `GL_PIXEL_PACK_BUFFER'. If no buffer
+ object is bound to this target, 0 is returned. The initial value is
+ 0. See `glBindBuffer'.
`GL_PIXEL_UNPACK_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- currently bound to the target `GL_PIXEL_UNPACK_BUFFER'. If no
- buffer object is bound to this target, 0 is returned. The initial
- value is 0. See `glBindBuffer'.
+ currently bound to the target `GL_PIXEL_UNPACK_BUFFER'. If no
+ buffer object is bound to this target, 0 is returned. The initial
+ value is 0. See `glBindBuffer'.
`GL_POINT_DISTANCE_ATTENUATION'
PARAMS returns three values, the coefficients for computing the
- attenuation value for points. See `glPointParameter'.
+ attenuation value for points. See `glPointParameter'.
`GL_POINT_FADE_THRESHOLD_SIZE'
PARAMS returns one value, the point size threshold for determining
- the point size. See `glPointParameter'.
+ the point size. See `glPointParameter'.
`GL_POINT_SIZE'
PARAMS returns one value, the point size as specified by
- `glPointSize'. The initial value is 1.
+ `glPointSize'. The initial value is 1.
`GL_POINT_SIZE_GRANULARITY'
PARAMS returns one value, the size difference between adjacent
- supported sizes for antialiased points. See `glPointSize'.
+ supported sizes for antialiased points. See `glPointSize'.
`GL_POINT_SIZE_MAX'
PARAMS returns one value, the upper bound for the attenuated point
- sizes. The initial value is 0.0. See `glPointParameter'.
+ sizes. The initial value is 0.0. See `glPointParameter'.
`GL_POINT_SIZE_MIN'
PARAMS returns one value, the lower bound for the attenuated point
- sizes. The initial value is 1.0. See `glPointParameter'.
+ sizes. The initial value is 1.0. See `glPointParameter'.
`GL_POINT_SIZE_RANGE'
PARAMS 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 `glPointSize'.
+ for antialiased points. The smallest size must be at most 1, and
+ the largest size must be at least 1. See `glPointSize'.
`GL_POINT_SMOOTH'
PARAMS returns a single boolean value indicating whether
- antialiasing of points is enabled. The initial value is
- `GL_FALSE'. See `glPointSize'.
+ antialiasing of points is enabled. The initial value is `GL_FALSE'.
+ See `glPointSize'.
`GL_POINT_SMOOTH_HINT'
PARAMS returns one value, a symbolic constant indicating the mode
- of the point antialiasing hint. The initial value is
- `GL_DONT_CARE'. See `glHint'.
+ of the point antialiasing hint. The initial value is
+ `GL_DONT_CARE'. See `glHint'.
`GL_POINT_SPRITE'
PARAMS returns a single boolean value indicating whether point
- sprite is enabled. The initial value is `GL_FALSE'.
+ sprite is enabled. The initial value is `GL_FALSE'.
`GL_POLYGON_MODE'
PARAMS 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 `GL_FILL'. See
+ lines, or filled polygons. The initial value is `GL_FILL'. See
`glPolygonMode'.
`GL_POLYGON_OFFSET_FACTOR'
PARAMS 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 `glPolygonOffset'.
+ generated when a polygon is rasterized. The initial value is 0. See
+ `glPolygonOffset'.
`GL_POLYGON_OFFSET_UNITS'
- PARAMS returns one value. This value is multiplied by an
+ PARAMS 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 `glPolygonOffset'.
+ each fragment generated when a polygon is rasterized. The initial
+ value is 0. See `glPolygonOffset'.
`GL_POLYGON_OFFSET_FILL'
PARAMS returns a single boolean value indicating whether polygon
- offset is enabled for polygons in fill mode. The initial value is
- `GL_FALSE'. See `glPolygonOffset'.
+ offset is enabled for polygons in fill mode. The initial value is
+ `GL_FALSE'. See `glPolygonOffset'.
`GL_POLYGON_OFFSET_LINE'
PARAMS returns a single boolean value indicating whether polygon
- offset is enabled for polygons in line mode. The initial value is
- `GL_FALSE'. See `glPolygonOffset'.
+ offset is enabled for polygons in line mode. The initial value is
+ `GL_FALSE'. See `glPolygonOffset'.
`GL_POLYGON_OFFSET_POINT'
PARAMS returns a single boolean value indicating whether polygon
- offset is enabled for polygons in point mode. The initial value is
- `GL_FALSE'. See `glPolygonOffset'.
+ offset is enabled for polygons in point mode. The initial value is
+ `GL_FALSE'. See `glPolygonOffset'.
`GL_POLYGON_SMOOTH'
PARAMS returns a single boolean value indicating whether
- antialiasing of polygons is enabled. The initial value is
- `GL_FALSE'. See `glPolygonMode'.
+ antialiasing of polygons is enabled. The initial value is
+ `GL_FALSE'. See `glPolygonMode'.
`GL_POLYGON_SMOOTH_HINT'
PARAMS returns one value, a symbolic constant indicating the mode
- of the polygon antialiasing hint. The initial value is
- `GL_DONT_CARE'. See `glHint'.
+ of the polygon antialiasing hint. The initial value is
+ `GL_DONT_CARE'. See `glHint'.
`GL_POLYGON_STIPPLE'
PARAMS returns a single boolean value indicating whether polygon
- stippling is enabled. The initial value is `GL_FALSE'. See
+ stippling is enabled. The initial value is `GL_FALSE'. See
`glPolygonStipple'.
`GL_POST_COLOR_MATRIX_COLOR_TABLE'
PARAMS returns a single boolean value indicating whether post color
- matrix transformation lookup is enabled. The initial value is
- `GL_FALSE'. See `glColorTable'.
+ matrix transformation lookup is enabled. The initial value is
+ `GL_FALSE'. See `glColorTable'.
`GL_POST_COLOR_MATRIX_RED_BIAS'
PARAMS returns one value, the red bias factor applied to RGBA
- fragments after color matrix transformations. The initial value is
- 0. See `glPixelTransfer'.
+ fragments after color matrix transformations. The initial value is
+ 0. See `glPixelTransfer'.
`GL_POST_COLOR_MATRIX_GREEN_BIAS'
PARAMS returns one value, the green bias factor applied to RGBA
- fragments after color matrix transformations. The initial value is
- 0. See `glPixelTransfer'
+ fragments after color matrix transformations. The initial value is
+ 0. See `glPixelTransfer'
`GL_POST_COLOR_MATRIX_BLUE_BIAS'
PARAMS returns one value, the blue bias factor applied to RGBA
- fragments after color matrix transformations. The initial value is
- 0. See `glPixelTransfer'.
+ fragments after color matrix transformations. The initial value is
+ 0. See `glPixelTransfer'.
`GL_POST_COLOR_MATRIX_ALPHA_BIAS'
PARAMS returns one value, the alpha bias factor applied to RGBA
- fragments after color matrix transformations. The initial value is
- 0. See `glPixelTransfer'.
+ fragments after color matrix transformations. The initial value is
+ 0. See `glPixelTransfer'.
`GL_POST_COLOR_MATRIX_RED_SCALE'
PARAMS returns one value, the red scale factor applied to RGBA
- fragments after color matrix transformations. The initial value is
- 1. See `glPixelTransfer'.
+ fragments after color matrix transformations. The initial value is
+ 1. See `glPixelTransfer'.
`GL_POST_COLOR_MATRIX_GREEN_SCALE'
PARAMS returns one value, the green scale factor applied to RGBA
- fragments after color matrix transformations. The initial value is
- 1. See `glPixelTransfer'.
+ fragments after color matrix transformations. The initial value is
+ 1. See `glPixelTransfer'.
`GL_POST_COLOR_MATRIX_BLUE_SCALE'
PARAMS returns one value, the blue scale factor applied to RGBA
- fragments after color matrix transformations. The initial value is
- 1. See `glPixelTransfer'.
+ fragments after color matrix transformations. The initial value is
+ 1. See `glPixelTransfer'.
`GL_POST_COLOR_MATRIX_ALPHA_SCALE'
PARAMS returns one value, the alpha scale factor applied to RGBA
- fragments after color matrix transformations. The initial value is
- 1. See `glPixelTransfer'.
+ fragments after color matrix transformations. The initial value is
+ 1. See `glPixelTransfer'.
`GL_POST_CONVOLUTION_COLOR_TABLE'
PARAMS returns a single boolean value indicating whether post
- convolution lookup is enabled. The initial value is `GL_FALSE'.
- See `glColorTable'.
+ convolution lookup is enabled. The initial value is `GL_FALSE'. See
+ `glColorTable'.
`GL_POST_CONVOLUTION_RED_BIAS'
PARAMS returns one value, the red bias factor applied to RGBA
- fragments after convolution. The initial value is 0. See
+ fragments after convolution. The initial value is 0. See
`glPixelTransfer'.
`GL_POST_CONVOLUTION_GREEN_BIAS'
PARAMS returns one value, the green bias factor applied to RGBA
- fragments after convolution. The initial value is 0. See
+ fragments after convolution. The initial value is 0. See
`glPixelTransfer'.
`GL_POST_CONVOLUTION_BLUE_BIAS'
PARAMS returns one value, the blue bias factor applied to RGBA
- fragments after convolution. The initial value is 0. See
+ fragments after convolution. The initial value is 0. See
`glPixelTransfer'.
`GL_POST_CONVOLUTION_ALPHA_BIAS'
PARAMS returns one value, the alpha bias factor applied to RGBA
- fragments after convolution. The initial value is 0. See
+ fragments after convolution. The initial value is 0. See
`glPixelTransfer'.
`GL_POST_CONVOLUTION_RED_SCALE'
PARAMS returns one value, the red scale factor applied to RGBA
- fragments after convolution. The initial value is 1. See
+ fragments after convolution. The initial value is 1. See
`glPixelTransfer'.
`GL_POST_CONVOLUTION_GREEN_SCALE'
PARAMS returns one value, the green scale factor applied to RGBA
- fragments after convolution. The initial value is 1. See
+ fragments after convolution. The initial value is 1. See
`glPixelTransfer'.
`GL_POST_CONVOLUTION_BLUE_SCALE'
PARAMS returns one value, the blue scale factor applied to RGBA
- fragments after convolution. The initial value is 1. See
+ fragments after convolution. The initial value is 1. See
`glPixelTransfer'.
`GL_POST_CONVOLUTION_ALPHA_SCALE'
PARAMS returns one value, the alpha scale factor applied to RGBA
- fragments after convolution. The initial value is 1. See
+ fragments after convolution. The initial value is 1. See
`glPixelTransfer'.
`GL_PROJECTION_MATRIX'
PARAMS returns sixteen values: the projection matrix on the top of
- the projection matrix stack. Initially this matrix is the identity
- matrix. See `glPushMatrix'.
+ the projection matrix stack. Initially this matrix is the identity
+ matrix. See `glPushMatrix'.
`GL_PROJECTION_STACK_DEPTH'
PARAMS returns one value, the number of matrices on the projection
- matrix stack. The initial value is 1. See `glPushMatrix'.
+ matrix stack. The initial value is 1. See `glPushMatrix'.
`GL_READ_BUFFER'
PARAMS returns one value, a symbolic constant indicating which
- color buffer is selected for reading. The initial value is
+ color buffer is selected for reading. The initial value is
`GL_BACK' if there is a back buffer, otherwise it is `GL_FRONT'.
See `glReadPixels' and `glAccum'.
PARAMS returns one value, the red bias factor used during pixel
- transfers. The initial value is 0.
+ transfers. The initial value is 0.
`GL_RED_BITS'
PARAMS returns one value, the red scale factor used during pixel
- transfers. The initial value is 1. See `glPixelTransfer'.
+ transfers. The initial value is 1. See `glPixelTransfer'.
`GL_RENDER_MODE'
PARAMS returns one value, a symbolic constant indicating whether
- the GL is in render, select, or feedback mode. The initial value
- is `GL_RENDER'. See `glRenderMode'.
+ the GL is in render, select, or feedback mode. The initial value is
+ `GL_RENDER'. See `glRenderMode'.
`GL_RESCALE_NORMAL'
PARAMS returns single boolean value indicating whether normal
- rescaling is enabled. See `glEnable'.
+ rescaling is enabled. See `glEnable'.
`GL_RGBA_MODE'
PARAMS returns a single boolean value indicating whether the GL is
- in RGBA mode (true) or color index mode (false). See `glColor'.
+ in RGBA mode (true) or color index mode (false). See `glColor'.
`GL_SAMPLE_BUFFERS'
PARAMS returns a single integer value indicating the number of
- sample buffers associated with the framebuffer. See
+ sample buffers associated with the framebuffer. See
`glSampleCoverage'.
`GL_SAMPLE_COVERAGE_VALUE'
PARAMS returns a single positive floating-point value indicating
- the current sample coverage value. See `glSampleCoverage'.
+ the current sample coverage value. See `glSampleCoverage'.
`GL_SAMPLE_COVERAGE_INVERT'
PARAMS returns a single boolean value indicating if the temporary
- coverage value should be inverted. See `glSampleCoverage'.
+ coverage value should be inverted. See `glSampleCoverage'.
`GL_SAMPLES'
PARAMS returns a single integer value indicating the coverage mask
- size. See `glSampleCoverage'.
+ size. See `glSampleCoverage'.
`GL_SCISSOR_BOX'
PARAMS returns four values: the X and Y window coordinates of the
- scissor box, followed by its width and height. Initially the X and
+ 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 `glScissor'.
+ the size of the window. See `glScissor'.
`GL_SCISSOR_TEST'
PARAMS returns a single boolean value indicating whether scissoring
- is enabled. The initial value is `GL_FALSE'. See `glScissor'.
+ is enabled. The initial value is `GL_FALSE'. See `glScissor'.
`GL_SECONDARY_COLOR_ARRAY'
PARAMS returns a single boolean value indicating whether the
- secondary color array is enabled. The initial value is `GL_FALSE'.
+ secondary color array is enabled. The initial value is `GL_FALSE'.
See `glSecondaryColorPointer'.
`GL_SECONDARY_COLOR_ARRAY_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- associated with the secondary color array. This buffer object
- would have been bound to the target `GL_ARRAY_BUFFER' at the time
- of the most recent call to `glSecondaryColorPointer'. If no buffer
- object was bound to this target, 0 is returned. The initial value
- is 0. See `glBindBuffer'.
+ associated with the secondary color array. This buffer object would
+ have been bound to the target `GL_ARRAY_BUFFER' at the time of the
+ most recent call to `glSecondaryColorPointer'. If no buffer object
+ was bound to this target, 0 is returned. The initial value is 0.
+ See `glBindBuffer'.
`GL_SECONDARY_COLOR_ARRAY_SIZE'
PARAMS returns one value, the number of components per color in the
- secondary color array. The initial value is 3. See
+ secondary color array. The initial value is 3. See
`glSecondaryColorPointer'.
`GL_SECONDARY_COLOR_ARRAY_STRIDE'
PARAMS returns one value, the byte offset between consecutive
- colors in the secondary color array. The initial value is 0. See
+ colors in the secondary color array. The initial value is 0. See
`glSecondaryColorPointer'.
`GL_SECONDARY_COLOR_ARRAY_TYPE'
PARAMS returns one value, the data type of each component in the
- secondary color array. The initial value is `GL_FLOAT'. See
+ secondary color array. The initial value is `GL_FLOAT'. See
`glSecondaryColorPointer'.
`GL_SELECTION_BUFFER_SIZE'
- PARAMS return one value, the size of the selection buffer. See
+ PARAMS return one value, the size of the selection buffer. See
`glSelectBuffer'.
`GL_SEPARABLE_2D'
PARAMS returns a single boolean value indicating whether 2D
- separable convolution is enabled. The initial value is `GL_FALSE'.
+ separable convolution is enabled. The initial value is `GL_FALSE'.
See `glSeparableFilter2D'.
`GL_SHADE_MODEL'
PARAMS returns one value, a symbolic constant indicating whether
- the shading mode is flat or smooth. The initial value is
- `GL_SMOOTH'. See `glShadeModel'.
+ the shading mode is flat or smooth. The initial value is
+ `GL_SMOOTH'. See `glShadeModel'.
`GL_SMOOTH_LINE_WIDTH_RANGE'
PARAMS returns two values, the smallest and largest supported
- widths for antialiased lines. See `glLineWidth'.
+ widths for antialiased lines. See `glLineWidth'.
`GL_SMOOTH_LINE_WIDTH_GRANULARITY'
PARAMS returns one value, the granularity of widths for antialiased
- lines. See `glLineWidth'.
+ lines. See `glLineWidth'.
`GL_SMOOTH_POINT_SIZE_RANGE'
PARAMS returns two values, the smallest and largest supported
- widths for antialiased points. See `glPointSize'.
+ widths for antialiased points. See `glPointSize'.
`GL_SMOOTH_POINT_SIZE_GRANULARITY'
PARAMS returns one value, the granularity of sizes for antialiased
- points. See `glPointSize'.
+ points. See `glPointSize'.
`GL_STENCIL_BACK_FAIL'
PARAMS returns one value, a symbolic constant indicating what
action is taken for back-facing polygons when the stencil test
- fails. The initial value is `GL_KEEP'. See `glStencilOpSeparate'.
+ fails. The initial value is `GL_KEEP'. See `glStencilOpSeparate'.
`GL_STENCIL_BACK_FUNC'
PARAMS returns one value, a symbolic constant indicating what
function is used for back-facing polygons to compare the stencil
- reference value with the stencil buffer value. The initial value
- is `GL_ALWAYS'. See `glStencilFuncSeparate'.
+ reference value with the stencil buffer value. The initial value is
+ `GL_ALWAYS'. See `glStencilFuncSeparate'.
`GL_STENCIL_BACK_PASS_DEPTH_FAIL'
PARAMS returns one value, a symbolic constant indicating what
action is taken for back-facing polygons when the stencil test
- passes, but the depth test fails. The initial value is `GL_KEEP'.
+ passes, but the depth test fails. The initial value is `GL_KEEP'.
See `glStencilOpSeparate'.
`GL_STENCIL_BACK_PASS_DEPTH_PASS'
PARAMS returns one value, a symbolic constant indicating what
action is taken for back-facing polygons when the stencil test
- passes and the depth test passes. The initial value is `GL_KEEP'.
+ passes and the depth test passes. The initial value is `GL_KEEP'.
See `glStencilOpSeparate'.
`GL_STENCIL_BACK_REF'
PARAMS returns one value, the reference value that is compared with
- the contents of the stencil buffer for back-facing polygons. The
- initial value is 0. See `glStencilFuncSeparate'.
+ the contents of the stencil buffer for back-facing polygons. The
+ initial value is 0. See `glStencilFuncSeparate'.
`GL_STENCIL_BACK_VALUE_MASK'
PARAMS returns one value, the mask that is used for back-facing
polygons to mask both the stencil reference value and the stencil
- buffer value before they are compared. The initial value is all
- 1's. See `glStencilFuncSeparate'.
+ buffer value before they are compared. The initial value is all
+ 1's. See `glStencilFuncSeparate'.
`GL_STENCIL_BACK_WRITEMASK'
PARAMS returns one value, the mask that controls writing of the
- stencil bitplanes for back-facing polygons. The initial value is
- all 1's. See `glStencilMaskSeparate'.
+ stencil bitplanes for back-facing polygons. The initial value is
+ all 1's. See `glStencilMaskSeparate'.
`GL_STENCIL_BITS'
PARAMS returns one value, the index to which the stencil bitplanes
- are cleared. The initial value is 0. See `glClearStencil'.
+ are cleared. The initial value is 0. See `glClearStencil'.
`GL_STENCIL_FAIL'
PARAMS returns one value, a symbolic constant indicating what
- action is taken when the stencil test fails. The initial value is
- `GL_KEEP'. See `glStencilOp'. If the GL version is 2.0 or
- greater, this stencil state only affects non-polygons and
- front-facing polygons. Back-facing polygons use separate stencil
- state. See `glStencilOpSeparate'.
+ action is taken when the stencil test fails. The initial value is
+ `GL_KEEP'. See `glStencilOp'. If the GL version is 2.0 or greater,
+ this stencil state only affects non-polygons and front-facing
+ polygons. Back-facing polygons use separate stencil state. See
+ `glStencilOpSeparate'.
`GL_STENCIL_FUNC'
PARAMS 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 `GL_ALWAYS'. See
- `glStencilFunc'. If the GL version is 2.0 or greater, this stencil
+ stencil buffer value. The initial value is `GL_ALWAYS'. See
+ `glStencilFunc'. If the GL version is 2.0 or greater, this stencil
state only affects non-polygons and front-facing polygons.
- Back-facing polygons use separate stencil state. See
+ Back-facing polygons use separate stencil state. See
`glStencilFuncSeparate'.
`GL_STENCIL_PASS_DEPTH_FAIL'
PARAMS 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 `GL_KEEP'. See `glStencilOp'. If the
- GL version is 2.0 or greater, this stencil state only affects
- non-polygons and front-facing polygons. Back-facing polygons use
- separate stencil state. See `glStencilOpSeparate'.
+ fails. The initial value is `GL_KEEP'. See `glStencilOp'. If the GL
+ version is 2.0 or greater, this stencil state only affects
+ non-polygons and front-facing polygons. Back-facing polygons use
+ separate stencil state. See `glStencilOpSeparate'.
`GL_STENCIL_PASS_DEPTH_PASS'
PARAMS 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 `GL_KEEP'. See `glStencilOp'. If
- the GL version is 2.0 or greater, this stencil state only affects
- non-polygons and front-facing polygons. Back-facing polygons use
- separate stencil state. See `glStencilOpSeparate'.
+ passes. The initial value is `GL_KEEP'. See `glStencilOp'. If the
+ GL version is 2.0 or greater, this stencil state only affects
+ non-polygons and front-facing polygons. Back-facing polygons use
+ separate stencil state. See `glStencilOpSeparate'.
`GL_STENCIL_REF'
PARAMS returns one value, the reference value that is compared with
- the contents of the stencil buffer. The initial value is 0. See
- `glStencilFunc'. If the GL version is 2.0 or greater, this stencil
+ the contents of the stencil buffer. The initial value is 0. See
+ `glStencilFunc'. If the GL version is 2.0 or greater, this stencil
state only affects non-polygons and front-facing polygons.
- Back-facing polygons use separate stencil state. See
+ Back-facing polygons use separate stencil state. See
`glStencilFuncSeparate'.
`GL_STENCIL_TEST'
PARAMS returns a single boolean value indicating whether stencil
- testing of fragments is enabled. The initial value is `GL_FALSE'.
+ testing of fragments is enabled. The initial value is `GL_FALSE'.
See `glStencilFunc' and `glStencilOp'.
`GL_STENCIL_VALUE_MASK'
PARAMS 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 `glStencilFunc'.
- If the GL version is 2.0 or greater, this stencil state only
- affects non-polygons and front-facing polygons. Back-facing
- polygons use separate stencil state. See `glStencilFuncSeparate'.
+ are compared. The initial value is all 1's. See `glStencilFunc'. If
+ the GL version is 2.0 or greater, this stencil state only affects
+ non-polygons and front-facing polygons. Back-facing polygons use
+ separate stencil state. See `glStencilFuncSeparate'.
`GL_STENCIL_WRITEMASK'
PARAMS returns one value, the mask that controls writing of the
- stencil bitplanes. The initial value is all 1's. See
- `glStencilMask'. If the GL version is 2.0 or greater, this stencil
+ stencil bitplanes. The initial value is all 1's. See
+ `glStencilMask'. If the GL version is 2.0 or greater, this stencil
state only affects non-polygons and front-facing polygons.
- Back-facing polygons use separate stencil state. See
+ Back-facing polygons use separate stencil state. See
`glStencilMaskSeparate'.
`GL_STEREO'
PARAMS returns one value, an estimate of the number of bits of
subpixel resolution that are used to position rasterized geometry
- in window coordinates. The value must be at least 4.
+ in window coordinates. The value must be at least 4.
`GL_TEXTURE_1D'
PARAMS returns a single boolean value indicating whether 1D texture
- mapping is enabled. The initial value is `GL_FALSE'. See
+ mapping is enabled. The initial value is `GL_FALSE'. See
`glTexImage1D'.
`GL_TEXTURE_BINDING_1D'
PARAMS returns a single value, the name of the texture currently
- bound to the target `GL_TEXTURE_1D'. The initial value is 0. See
+ bound to the target `GL_TEXTURE_1D'. The initial value is 0. See
`glBindTexture'.
`GL_TEXTURE_2D'
PARAMS returns a single boolean value indicating whether 2D texture
- mapping is enabled. The initial value is `GL_FALSE'. See
+ mapping is enabled. The initial value is `GL_FALSE'. See
`glTexImage2D'.
`GL_TEXTURE_BINDING_2D'
PARAMS returns a single value, the name of the texture currently
- bound to the target `GL_TEXTURE_2D'. The initial value is 0. See
+ bound to the target `GL_TEXTURE_2D'. The initial value is 0. See
`glBindTexture'.
`GL_TEXTURE_3D'
PARAMS returns a single boolean value indicating whether 3D texture
- mapping is enabled. The initial value is `GL_FALSE'. See
+ mapping is enabled. The initial value is `GL_FALSE'. See
`glTexImage3D'.
`GL_TEXTURE_BINDING_3D'
PARAMS returns a single value, the name of the texture currently
- bound to the target `GL_TEXTURE_3D'. The initial value is 0. See
+ bound to the target `GL_TEXTURE_3D'. The initial value is 0. See
`glBindTexture'.
`GL_TEXTURE_BINDING_CUBE_MAP'
PARAMS returns a single value, the name of the texture currently
- bound to the target `GL_TEXTURE_CUBE_MAP'. The initial value is 0.
+ bound to the target `GL_TEXTURE_CUBE_MAP'. The initial value is 0.
See `glBindTexture'.
`GL_TEXTURE_COMPRESSION_HINT'
PARAMS returns a single value indicating the mode of the texture
- compression hint. The initial value is `GL_DONT_CARE'.
+ compression hint. The initial value is `GL_DONT_CARE'.
`GL_TEXTURE_COORD_ARRAY'
PARAMS returns a single boolean value indicating whether the
- texture coordinate array is enabled. The initial value is
- `GL_FALSE'. See `glTexCoordPointer'.
+ texture coordinate array is enabled. The initial value is
+ `GL_FALSE'. See `glTexCoordPointer'.
`GL_TEXTURE_COORD_ARRAY_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- associated with the texture coordinate array. This buffer object
+ associated with the texture coordinate array. This buffer object
would have been bound to the target `GL_ARRAY_BUFFER' at the time
- of the most recent call to `glTexCoordPointer'. If no buffer
- object was bound to this target, 0 is returned. The initial value
- is 0. See `glBindBuffer'.
+ of the most recent call to `glTexCoordPointer'. If no buffer object
+ was bound to this target, 0 is returned. The initial value is 0.
+ See `glBindBuffer'.
`GL_TEXTURE_COORD_ARRAY_SIZE'
PARAMS returns one value, the number of coordinates per element in
- the texture coordinate array. The initial value is 4. See
+ the texture coordinate array. The initial value is 4. See
`glTexCoordPointer'.
`GL_TEXTURE_COORD_ARRAY_STRIDE'
PARAMS returns one value, the byte offset between consecutive
- elements in the texture coordinate array. The initial value is 0.
+ elements in the texture coordinate array. The initial value is 0.
See `glTexCoordPointer'.
`GL_TEXTURE_COORD_ARRAY_TYPE'
PARAMS returns one value, the data type of the coordinates in the
- texture coordinate array. The initial value is `GL_FLOAT'. See
+ texture coordinate array. The initial value is `GL_FLOAT'. See
`glTexCoordPointer'.
`GL_TEXTURE_CUBE_MAP'
PARAMS returns a single boolean value indicating whether
- cube-mapped texture mapping is enabled. The initial value is
- `GL_FALSE'. See `glTexImage2D'.
+ cube-mapped texture mapping is enabled. The initial value is
+ `GL_FALSE'. See `glTexImage2D'.
`GL_TEXTURE_GEN_Q'
PARAMS returns a single boolean value indicating whether automatic
- generation of the Q texture coordinate is enabled. The initial
- value is `GL_FALSE'. See `glTexGen'.
+ generation of the Q texture coordinate is enabled. The initial
+ value is `GL_FALSE'. See `glTexGen'.
`GL_TEXTURE_GEN_R'
PARAMS returns a single boolean value indicating whether automatic
- generation of the R texture coordinate is enabled. The initial
- value is `GL_FALSE'. See `glTexGen'.
+ generation of the R texture coordinate is enabled. The initial
+ value is `GL_FALSE'. See `glTexGen'.
`GL_TEXTURE_GEN_S'
PARAMS returns a single boolean value indicating whether automatic
- generation of the S texture coordinate is enabled. The initial
- value is `GL_FALSE'. See `glTexGen'.
+ generation of the S texture coordinate is enabled. The initial
+ value is `GL_FALSE'. See `glTexGen'.
`GL_TEXTURE_GEN_T'
PARAMS returns a single boolean value indicating whether automatic
- generation of the T texture coordinate is enabled. The initial
- value is `GL_FALSE'. See `glTexGen'.
+ generation of the T texture coordinate is enabled. The initial
+ value is `GL_FALSE'. See `glTexGen'.
`GL_TEXTURE_MATRIX'
PARAMS returns sixteen values: the texture matrix on the top of the
- texture matrix stack. Initially this matrix is the identity
- matrix. See `glPushMatrix'.
+ texture matrix stack. Initially this matrix is the identity matrix.
+ See `glPushMatrix'.
`GL_TEXTURE_STACK_DEPTH'
PARAMS returns one value, the number of matrices on the texture
- matrix stack. The initial value is 1. See `glPushMatrix'.
+ matrix stack. The initial value is 1. See `glPushMatrix'.
`GL_TRANSPOSE_COLOR_MATRIX'
PARAMS returns 16 values, the elements of the color matrix in
- row-major order. See `glLoadTransposeMatrix'.
+ row-major order. See `glLoadTransposeMatrix'.
`GL_TRANSPOSE_MODELVIEW_MATRIX'
PARAMS returns 16 values, the elements of the modelview matrix in
- row-major order. See `glLoadTransposeMatrix'.
+ row-major order. See `glLoadTransposeMatrix'.
`GL_TRANSPOSE_PROJECTION_MATRIX'
PARAMS returns 16 values, the elements of the projection matrix in
- row-major order. See `glLoadTransposeMatrix'.
+ row-major order. See `glLoadTransposeMatrix'.
`GL_TRANSPOSE_TEXTURE_MATRIX'
PARAMS returns 16 values, the elements of the texture matrix in
- row-major order. See `glLoadTransposeMatrix'.
+ row-major order. See `glLoadTransposeMatrix'.
`GL_UNPACK_ALIGNMENT'
PARAMS returns one value, the byte alignment used for reading pixel
- data from memory. The initial value is 4. See `glPixelStore'.
+ data from memory. The initial value is 4. See `glPixelStore'.
`GL_UNPACK_IMAGE_HEIGHT'
PARAMS returns one value, the image height used for reading pixel
- data from memory. The initial is 0. See `glPixelStore'.
+ data from memory. The initial is 0. See `glPixelStore'.
`GL_UNPACK_LSB_FIRST'
PARAMS 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
- `GL_FALSE'. See `glPixelStore'.
+ significant bit of each unsigned byte. The initial value is
+ `GL_FALSE'. See `glPixelStore'.
`GL_UNPACK_ROW_LENGTH'
PARAMS returns one value, the row length used for reading pixel
- data from memory. The initial value is 0. See `glPixelStore'.
+ data from memory. The initial value is 0. See `glPixelStore'.
`GL_UNPACK_SKIP_IMAGES'
PARAMS returns one value, the number of pixel images skipped before
- the first pixel is read from memory. The initial value is 0. See
+ the first pixel is read from memory. The initial value is 0. See
`glPixelStore'.
`GL_UNPACK_SKIP_PIXELS'
PARAMS returns one value, the number of pixel locations skipped
- before the first pixel is read from memory. The initial value is
- 0. See `glPixelStore'.
+ before the first pixel is read from memory. The initial value is 0.
+ See `glPixelStore'.
`GL_UNPACK_SKIP_ROWS'
PARAMS 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 `glPixelStore'.
+ skipped before the first pixel is read from memory. The initial
+ value is 0. See `glPixelStore'.
`GL_UNPACK_SWAP_BYTES'
PARAMS 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 `GL_FALSE'. See
+ after being read from memory. The initial value is `GL_FALSE'. See
`glPixelStore'.
`GL_VERTEX_ARRAY'
PARAMS returns a single boolean value indicating whether the vertex
- array is enabled. The initial value is `GL_FALSE'. See
+ array is enabled. The initial value is `GL_FALSE'. See
`glVertexPointer'.
`GL_VERTEX_ARRAY_BUFFER_BINDING'
PARAMS returns a single value, the name of the buffer object
- associated with the vertex array. This buffer object would have
+ associated with the vertex array. This buffer object would have
been bound to the target `GL_ARRAY_BUFFER' at the time of the most
- recent call to `glVertexPointer'. If no buffer object was bound to
- this target, 0 is returned. The initial value is 0. See
+ recent call to `glVertexPointer'. If no buffer object was bound to
+ this target, 0 is returned. The initial value is 0. See
`glBindBuffer'.
`GL_VERTEX_ARRAY_SIZE'
PARAMS returns one value, the number of coordinates per vertex in
- the vertex array. The initial value is 4. See `glVertexPointer'.
+ the vertex array. The initial value is 4. See `glVertexPointer'.
`GL_VERTEX_ARRAY_STRIDE'
PARAMS returns one value, the byte offset between consecutive
- vertices in the vertex array. The initial value is 0. See
+ vertices in the vertex array. The initial value is 0. See
`glVertexPointer'.
`GL_VERTEX_ARRAY_TYPE'
PARAMS returns one value, the data type of each coordinate in the
- vertex array. The initial value is `GL_FLOAT'. See
+ vertex array. The initial value is `GL_FLOAT'. See
`glVertexPointer'.
`GL_VERTEX_PROGRAM_POINT_SIZE'
PARAMS returns a single boolean value indicating whether vertex
- program point size mode is enabled. If enabled, and a vertex
- shader is active, then the point size is taken from the shader
- built-in `gl_PointSize'. If disabled, and a vertex shader is
- active, then the point size is taken from the point state as
- specified by `glPointSize'. The initial value is `GL_FALSE'.
+ program point size mode is enabled. If enabled, and a vertex shader
+ is active, then the point size is taken from the shader built-in
+ `gl_PointSize'. If disabled, and a vertex shader is active, then
+ the point size is taken from the point state as specified by
+ `glPointSize'. The initial value is `GL_FALSE'.
`GL_VERTEX_PROGRAM_TWO_SIDE'
PARAMS returns a single boolean value indicating whether vertex
- program two-sided color mode is enabled. If enabled, and a vertex
+ program two-sided color mode is enabled. If enabled, and a vertex
shader is active, then the GL chooses the back color output for
back-facing polygons, and the front color output for non-polygons
- and front-facing polygons. If disabled, and a vertex shader is
- active, then the front color output is always selected. The
- initial value is `GL_FALSE'.
+ and front-facing polygons. If disabled, and a vertex shader is
+ active, then the front color output is always selected. The initial
+ value is `GL_FALSE'.
`GL_VIEWPORT'
PARAMS returns four values: the X and Y window coordinates of the
- viewport, followed by its width and height. Initially the X and Y
+ 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 `glViewport'.
+ its rendering. See `glViewport'.
`GL_ZOOM_X'
- PARAMS returns one value, the X pixel zoom factor. The initial
- value is 1. See `glPixelZoom'.
+ PARAMS returns one value, the X pixel zoom factor. The initial
+ value is 1. See `glPixelZoom'.
`GL_ZOOM_Y'
- PARAMS returns one value, the Y pixel zoom factor. The initial
- value is 1. See `glPixelZoom'.
+ PARAMS returns one value, the Y pixel zoom factor. The initial
+ value is 1. See `glPixelZoom'.
Many of the boolean parameters can also be queried more easily using
`glIsEnabled'.
TARGET
Specifies a symbolic constant indicating the behavior to be
- controlled. `GL_FOG_HINT', `GL_GENERATE_MIPMAP_HINT',
+ controlled. `GL_FOG_HINT', `GL_GENERATE_MIPMAP_HINT',
`GL_LINE_SMOOTH_HINT', `GL_PERSPECTIVE_CORRECTION_HINT',
`GL_POINT_SMOOTH_HINT', `GL_POLYGON_SMOOTH_HINT',
`GL_TEXTURE_COMPRESSION_HINT', and
`GL_FASTEST', `GL_NICEST', and `GL_DONT_CARE' are accepted.
Certain aspects of GL behavior, when there is room for interpretation,
-can be controlled with hints. A hint is specified with two arguments.
+can be controlled with hints. A hint is specified with two arguments.
TARGET is a symbolic constant indicating the behavior to be controlled,
and MODE is another symbolic constant indicating the desired behavior.
-The initial value for each TARGET is `GL_DONT_CARE'. MODE can be one of
+The initial value for each TARGET is `GL_DONT_CARE'. MODE can be one of
the following:
`GL_FASTEST'
No preference.
Though the implementation aspects that can be hinted are well defined,
-the interpretation of the hints depends on the implementation. The hint
+the interpretation of the hints depends on the implementation. The hint
aspects that can be specified with TARGET, along with suggested
semantics, are as follows:
`GL_FOG_HINT'
- Indicates the accuracy of fog calculation. If per-pixel fog
+ Indicates the accuracy of fog calculation. If per-pixel fog
calculation is not efficiently supported by the GL implementation,
hinting `GL_DONT_CARE' or `GL_FASTEST' can result in per-vertex
calculation of fog effects.
`GL_LINE_SMOOTH_HINT'
- Indicates the sampling quality of antialiased lines. If a larger
+ Indicates the sampling quality of antialiased lines. If a larger
filter function is applied, hinting `GL_NICEST' can result in more
pixel fragments being generated during rasterization.
Indicates the quality of color, texture coordinate, and fog
- coordinate interpolation. If perspective-corrected parameter
+ coordinate interpolation. If perspective-corrected parameter
interpolation is not efficiently supported by the GL
implementation, hinting `GL_DONT_CARE' or `GL_FASTEST' can result
in simple linear interpolation of colors and/or texture
`GL_POINT_SMOOTH_HINT'
- Indicates the sampling quality of antialiased points. If a larger
+ Indicates the sampling quality of antialiased points. If a larger
filter function is applied, hinting `GL_NICEST' can result in more
pixel fragments being generated during rasterization.
`GL_POLYGON_SMOOTH_HINT'
- Indicates the sampling quality of antialiased polygons. Hinting
+ Indicates the sampling quality of antialiased polygons. Hinting
`GL_NICEST' can result in more pixel fragments being generated
during rasterization, if a larger filter function is applied.
Indicates the quality and performance of the compressing texture
- images. Hinting `GL_FASTEST' indicates that texture images should
+ images. Hinting `GL_FASTEST' indicates that texture images should
be compressed as quickly as possible, while `GL_NICEST' indicates
that texture images should be compressed with as little image
- quality loss as possible. `GL_NICEST' should be selected if the
+ quality loss as possible. `GL_NICEST' should be selected if the
texture is to be retrieved by `glGetCompressedTexImage' for reuse.
`GL_INVALID_ENUM' is generated if either TARGET or MODE is not an
"Define histogram table.
TARGET
- The histogram whose parameters are to be set. Must be one of
+ The histogram whose parameters are to be set. Must be one of
`GL_HISTOGRAM' or `GL_PROXY_HISTOGRAM'.
WIDTH
- The number of entries in the histogram table. Must be a power of
- 2.
+ The number of entries in the histogram table. Must be a power of 2.
INTERNALFORMAT
- The format of entries in the histogram table. Must be one of
+ The format of entries in the histogram table. Must be one of
`GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16',
`GL_LUMINANCE', `GL_LUMINANCE4', `GL_LUMINANCE8', `GL_LUMINANCE12',
`GL_LUMINANCE16', `GL_LUMINANCE_ALPHA', `GL_LUMINANCE4_ALPHA4',
SINK
If `GL_TRUE', pixels will be consumed by the histogramming process
- and no drawing or texture loading will take place. If `GL_FALSE',
+ and no drawing or texture loading will take place. If `GL_FALSE',
pixels will proceed to the minmax process after histogramming.
When `GL_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 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.)
+beyond its maximum value, then its value becomes undefined. (This is not
+an error.)
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 `glEnable' and disabled
+table lookup). Histogramming is enabled with `glEnable' and disabled
with `glDisable'.
When TARGET is `GL_HISTOGRAM', `glHistogram' redefines the current
histogram table to have WIDTH entries of the format specified by
-INTERNALFORMAT. The entries are indexed 0 through WIDTH-1 , and all
-entries are initialized to zero. The values in the previous histogram
-table, if any, are lost. If SINK is `GL_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.
+INTERNALFORMAT. The entries are indexed 0 through WIDTH-1 , and all
+entries are initialized to zero. The values in the previous histogram
+table, if any, are lost. If SINK is `GL_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.
When TARGET is `GL_PROXY_HISTOGRAM', `glHistogram' 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
+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.
MASK
Specifies a bit mask to enable and disable the writing of
- individual bits in the color index buffers. Initially, the mask is
+ individual bits in the color index buffers. Initially, the mask is
all 1's.
`glIndexMask' controls the writing of individual bits in the color index
-buffers. The least significant N bits of MASK, 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.
+buffers. The least significant N bits of MASK, 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.
This mask is used only in color index mode, and it affects only the
-buffers currently selected for writing (see `glDrawBuffer'). Initially,
+buffers currently selected for writing (see `glDrawBuffer'). Initially,
all bits are enabled for writing.
`GL_INVALID_OPERATION' is generated if `glIndexMask' is executed between
"Define an array of color indexes.
TYPE
- Specifies the data type of each color index in the array. Symbolic
+ Specifies the data type of each color index in the array. Symbolic
constants `GL_UNSIGNED_BYTE', `GL_SHORT', `GL_INT', `GL_FLOAT', and
- `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
+ `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
STRIDE
- Specifies the byte offset between consecutive color indexes. If
+ Specifies the byte offset between consecutive color indexes. If
STRIDE is 0, the color indexes are understood to be tightly packed
- in the array. The initial value is 0.
+ in the array. The initial value is 0.
POINTER
- Specifies a pointer to the first index in the array. The initial
+ Specifies a pointer to the first index in the array. The initial
value is 0.
`glIndexPointer' specifies the location and data format of an array of
-color indexes to use when rendering. TYPE specifies the data type of
+color indexes to use when rendering. TYPE specifies the data type of
each color index and STRIDE specifies 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.
buffer object binding.
To enable and disable the color index array, call `glEnableClientState'
-and `glDisableClientState' with the argument `GL_INDEX_ARRAY'. If
+and `glDisableClientState' with the argument `GL_INDEX_ARRAY'. If
enabled, the color index array is used when `glDrawArrays',
`glMultiDrawArrays', `glDrawElements', `glMultiDrawElements',
`glDrawRangeElements', or `glArrayElement' is called.
-`glIndex' updates the current (single-valued) color index. It takes one
+`glIndex' updates the current (single-valued) color index. It takes one
argument, the new value for the current color index.
-The current index is stored as a floating-point value. Integer values
+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.
+mapping. The initial value is 1.
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
+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.")
"Initialize the name stack.
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. `glInitNames' causes the name stack to be
-initialized to its default empty state.
+commands to be uniquely identified. It consists of an ordered set of
+unsigned integers. `glInitNames' causes the name stack to be initialized
+to its default empty state.
The name stack is always empty while the render mode is not `GL_SELECT'.
Calls to `glInitNames' while the render mode is not `GL_SELECT' are
"Simultaneously specify and enable several interleaved arrays.
FORMAT
- Specifies the type of array to enable. Symbolic constants
- `GL_V2F', `GL_V3F', `GL_C4UB_V2F', `GL_C4UB_V3F', `GL_C3F_V3F',
- `GL_N3F_V3F', `GL_C4F_N3F_V3F', `GL_T2F_V3F', `GL_T4F_V4F',
- `GL_T2F_C4UB_V3F', `GL_T2F_C3F_V3F', `GL_T2F_N3F_V3F',
- `GL_T2F_C4F_N3F_V3F', and `GL_T4F_C4F_N3F_V4F' are accepted.
+ Specifies the type of array to enable. Symbolic constants `GL_V2F',
+ `GL_V3F', `GL_C4UB_V2F', `GL_C4UB_V3F', `GL_C3F_V3F', `GL_N3F_V3F',
+ `GL_C4F_N3F_V3F', `GL_T2F_V3F', `GL_T4F_V4F', `GL_T2F_C4UB_V3F',
+ `GL_T2F_C3F_V3F', `GL_T2F_N3F_V3F', `GL_T2F_C4F_N3F_V3F', and
+ `GL_T4F_C4F_N3F_V4F' are accepted.
STRIDE
Specifies the offset in bytes between each aggregate array element.
`glInterleavedArrays' 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
+aggregate array element. For some implementations, this is more
efficient than specifying the arrays separately.
If STRIDE is 0, the aggregate elements are stored consecutively.
array element and the beginning of the next aggregate array element.
FORMAT serves as a ``key'' describing the extraction of individual
-arrays from the aggregate array. If FORMAT 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.
+arrays from the aggregate array. If FORMAT 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.
-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.
+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.
`GL_INVALID_ENUM' is generated if FORMAT is not an accepted value.
Specifies a value that may be the name of a buffer object.
`glIsBuffer' returns `GL_TRUE' if BUFFER is currently the name of a
-buffer object. If BUFFER is zero, or is a non-zero value that is not
+buffer object. If BUFFER is zero, or is a non-zero value that is not
currently the name of a buffer object, or if an error occurs,
`glIsBuffer' returns `GL_FALSE'.
Specifies a symbolic constant indicating a GL capability.
`glIsEnabled' returns `GL_TRUE' if CAP is an enabled capability and
-returns `GL_FALSE' otherwise. Initially all capabilities except
+returns `GL_FALSE' otherwise. Initially all capabilities except
`GL_DITHER' are disabled; `GL_DITHER' is initially enabled.
The following capabilities are accepted for CAP:
`glIsProgram' returns `GL_TRUE' if PROGRAM is the name of a program
object previously created with `glCreateProgram' and not yet deleted
-with `glDeleteProgram'. If PROGRAM is zero or a non-zero value that is
+with `glDeleteProgram'. If PROGRAM is zero or a non-zero value that is
not the name of a program object, or if an error occurs, `glIsProgram'
returns `GL_FALSE'.
Specifies a value that may be the name of a query object.
`glIsQuery' returns `GL_TRUE' if ID is currently the name of a query
-object. If ID is zero, or is a non-zero value that is not currently the
+object. If ID is zero, or is a non-zero value that is not currently the
name of a query object, or if an error occurs, `glIsQuery' returns
`GL_FALSE'.
`glIsShader' returns `GL_TRUE' if SHADER is the name of a shader object
previously created with `glCreateShader' and not yet deleted with
-`glDeleteShader'. If SHADER is zero or a non-zero value that is not the
+`glDeleteShader'. If SHADER is zero or a non-zero value that is not the
name of a shader object, or if an error occurs, `glIsShader ' returns
`GL_FALSE'.
Specifies a value that may be the name of a texture.
`glIsTexture' returns `GL_TRUE' if TEXTURE is currently the name of a
-texture. If TEXTURE is zero, or is a non-zero value that is not
+texture. If TEXTURE is zero, or is a non-zero value that is not
currently the name of a texture, or if an error occurs, `glIsTexture'
returns `GL_FALSE'.
PARAM
Specifies the value that PARAM will be set to.
-`glLightModel' sets the lighting model parameter. PNAME names a
-parameter and PARAMS gives the new value. There are three lighting
-model parameters:
+`glLightModel' sets the lighting model parameter. PNAME names a
+parameter and PARAMS gives the new value. There are three lighting model
+parameters:
`GL_LIGHT_MODEL_AMBIENT'
PARAMS contains four integer or floating-point values that specify
- the ambient RGBA intensity of the entire scene. Integer values are
+ 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
+ . 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).
`GL_LIGHT_MODEL_COLOR_CONTROL'
PARAMS must be either `GL_SEPARATE_SPECULAR_COLOR' or
- `GL_SINGLE_COLOR'. `GL_SINGLE_COLOR' specifies that a single color
+ `GL_SINGLE_COLOR'. `GL_SINGLE_COLOR' specifies that a single color
is generated from the lighting computation for a vertex.
`GL_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
+ 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 `GL_SINGLE_COLOR'.
+ (if enabled). The initial value is `GL_SINGLE_COLOR'.
`GL_LIGHT_MODEL_LOCAL_VIEWER'
PARAMS is a single integer or floating-point value that specifies
- how specular reflection angles are computed. If PARAMS is 0 (or
+ how specular reflection angles are computed. If PARAMS is 0 (or
0.0), specular reflection angles take the view direction to be
parallel to and in the direction of the -Z axis, regardless of the
- location of the vertex in eye coordinates. Otherwise, specular
+ 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.
+ system. The initial value is 0.
`GL_LIGHT_MODEL_TWO_SIDE'
PARAMS 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 PARAMS is 0 (or 0.0), one-sided
- lighting is specified, and only the FRONT 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 BACK material parameters and have their normals
- reversed before the lighting equation is evaluated. Vertices of
- front-facing polygons are always lighted using the FRONT material
- parameters, with no change to their normals. The initial value is
- 0.
+ polygons. It has no effect on the lighting calculations for points,
+ lines, or bitmaps. If PARAMS is 0 (or 0.0), one-sided lighting is
+ specified, and only the FRONT 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
+ BACK material parameters and have their normals reversed before the
+ lighting equation is evaluated. Vertices of front-facing polygons
+ are always lighted using the FRONT material parameters, with no
+ change to their normals. The initial value is 0.
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
+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
+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
+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
+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
+exponent, and spread cutoff angle. All dot products are replaced with 0
if they evaluate to a negative value.
The alpha component of the resulting lighted color is set to the alpha
In color index mode, the value of the lighted index of a vertex ranges
from the ambient to the specular values passed to `glMaterial' using
-`GL_COLOR_INDEXES'. Diffuse and specular coefficients, computed with a
+`GL_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.
"Set light source parameters.
LIGHT
- Specifies a light. The number of lights depends on the
- implementation, but at least eight lights are supported. They are
+ 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 `GL_LIGHT' I , where i
ranges from 0 to the value of `GL_MAX_LIGHTS' - 1.
Specifies the value that parameter PNAME of light source LIGHT will
be set to.
-`glLight' sets the values of individual light source parameters. LIGHT
+`glLight' sets the values of individual light source parameters. LIGHT
names the light and is a symbolic name of the form `GL_LIGHT'I , where i
-ranges from 0 to the value of `GL_MAX_LIGHTS' - 1. PNAME specifies one
-of ten light source parameters, again by symbolic name. PARAMS is
-either a single value or a pointer to an array that contains the new
-values.
+ranges from 0 to the value of `GL_MAX_LIGHTS' - 1. PNAME specifies one
+of ten light source parameters, again by symbolic name. PARAMS is either
+a single value or a pointer to an array that contains the new values.
To enable and disable lighting calculation, call `glEnable' and
-`glDisable' with argument `GL_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 `glEnable' and `glDisable' with argument `GL_LIGHT'I .
+`glDisable' with argument `GL_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
+`glEnable' and `glDisable' with argument `GL_LIGHT'I .
The ten light parameters are as follows:
`GL_AMBIENT'
PARAMS contains four integer or floating-point values that specify
- the ambient RGBA intensity of the light. Integer values are mapped
+ 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
+ Floating-point values are mapped directly. Neither integer nor
+ floating-point values are clamped. The initial ambient light
intensity is (0, 0, 0, 1).
`GL_DIFFUSE'
PARAMS contains four integer or floating-point values that specify
- the diffuse RGBA intensity of the light. Integer values are mapped
+ 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
+ Floating-point values are mapped directly. Neither integer nor
+ floating-point values are clamped. The initial value for
`GL_LIGHT0' is (1, 1, 1, 1); for other lights, the initial value is
(0, 0, 0, 1).
`GL_SPECULAR'
PARAMS 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
+ 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
`GL_LIGHT0' is (1, 1, 1, 1); for other lights, the initial value is
(0, 0, 0, 1).
`GL_POSITION'
PARAMS 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
+ 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.
The position is transformed by the modelview matrix when `glLight'
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
+ 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,
+ 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
+ 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.
`GL_SPOT_DIRECTION'
PARAMS 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
+ 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.
The spot direction is transformed by the upper 3x3 of the modelview
matrix when `glLight' is called, and it is stored in eye
- coordinates. It is significant only when `GL_SPOT_CUTOFF' is not
- 180, which it is initially. The initial direction is (0,0-1) .
+ coordinates. It is significant only when `GL_SPOT_CUTOFF' is not
+ 180, which it is initially. The initial direction is (0,0-1) .
`GL_SPOT_EXPONENT'
PARAMS 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.
+ the intensity distribution of the light. Integer and floating-point
+ values are mapped directly. Only values in the range [0,128] are
+ accepted.
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
+ exponent. Thus, higher spot exponents result in a more focused
light source, regardless of the spot cutoff angle (see
- `GL_SPOT_CUTOFF', next paragraph). The initial spot exponent is 0,
+ `GL_SPOT_CUTOFF', next paragraph). The initial spot exponent is 0,
resulting in uniform light distribution.
`GL_SPOT_CUTOFF'
PARAMS 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. Otherwise, its intensity is
- controlled by the spot exponent and the attenuation factors. The
- initial spot cutoff is 180, resulting in uniform light
- distribution.
+ 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. Otherwise, its intensity is controlled
+ by the spot exponent and the attenuation factors. The initial spot
+ cutoff is 180, resulting in uniform light distribution.
`GL_CONSTANT_ATTENUATION'
`GL_LINEAR_ATTENUATION'
`GL_QUADRATIC_ATTENUATION'
PARAMS 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,
+ 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
+ the square of the same distance. The initial attenuation factors
are (1, 0, 0), resulting in no attenuation.
`GL_INVALID_ENUM' is generated if either LIGHT or PNAME is not an
"Specify the line stipple pattern.
FACTOR
- Specifies a multiplier for each bit in the line stipple pattern. If
+ Specifies a multiplier for each bit in the line stipple pattern. If
FACTOR is 3, for example, each bit in the pattern is used three
- times before the next bit in the pattern is used. FACTOR is
- clamped to the range [1, 256] and defaults to 1.
+ times before the next bit in the pattern is used. FACTOR is clamped
+ to the range [1, 256] and defaults to 1.
PATTERN
Specifies a 16-bit integer whose bit pattern determines which
- fragments of a line will be drawn when the line is rasterized. Bit
+ fragments of a line will be drawn when the line is rasterized. Bit
zero is used first; the default pattern is all 1's.
Line stippling masks out certain fragments produced by rasterization;
-those fragments will not be drawn. The masking is achieved by using
+those fragments will not be drawn. The masking is achieved by using
three parameters: the 16-bit line stipple pattern PATTERN, the repeat
count FACTOR, and an integer stipple counter S .
line segment of a `glBegin'(`GL_LINES')/`glEnd' 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
+segment are generated. The I fragments associated with count S are
masked out if
PATTERN bit (S/FACTOR,)%16
-is 0, otherwise these fragments are sent to the frame buffer. Bit zero
+is 0, otherwise these fragments are sent to the frame buffer. Bit zero
of PATTERN is the least significant bit.
Antialiased lines are treated as a sequence of 1×WIDTH rectangles for
-purposes of stippling. Whether rectangle S is rasterized or not depends
+purposes of stippling. Whether rectangle S is rasterized or not depends
on the fragment rule described for aliased lines, counting rectangles
rather than groups of fragments.
To enable and disable line stippling, call `glEnable' and `glDisable'
-with argument `GL_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.
+with argument `GL_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.
`GL_INVALID_OPERATION' is generated if `glLineStipple' is executed
between the execution of `glBegin' and the corresponding execution of
"Specify the width of rasterized lines.
WIDTH
- Specifies the width of rasterized lines. The initial value is 1.
+ Specifies the width of rasterized lines. The initial value is 1.
`glLineWidth' 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
+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 `glEnable' and `glDisable' with
-argument `GL_LINE_SMOOTH'. Line antialiasing is initially disabled.
+argument `GL_LINE_SMOOTH'. Line antialiasing is initially disabled.
If line antialiasing is disabled, the actual width is determined by
-rounding the supplied width to the nearest integer. (If the rounding
+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
∣ΔX,∣>=∣ΔY,∣ , I pixels are filled in each column that is rasterized,
-where I is the rounded value of WIDTH. Otherwise, I pixels are filled
-in each row that is rasterized.
+where I is the rounded value of WIDTH. Otherwise, I pixels are filled in
+each row that is rasterized.
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
+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.
+square. This value is saved and used in the final rasterization step.
-Not all widths can be supported when line antialiasing is enabled. If
-an unsupported width is requested, the nearest supported width is used.
+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
+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 `glGet' with arguments
`GL_ALIASED_LINE_WIDTH_RANGE', `GL_SMOOTH_LINE_WIDTH_RANGE', and
`GL_SMOOTH_LINE_WIDTH_GRANULARITY'.
PROGRAM
Specifies the handle of the program object to be linked.
-`glLinkProgram' links the program object specified by PROGRAM. If any
+`glLinkProgram' links the program object specified by PROGRAM. If any
shader objects of type `GL_VERTEX_SHADER' are attached to PROGRAM, they
will be used to create an executable that will run on the programmable
-vertex processor. If any shader objects of type `GL_FRAGMENT_SHADER'
-are attached to PROGRAM, they will be used to create an executable that
-will run on the programmable fragment processor.
+vertex processor. If any shader objects of type `GL_FRAGMENT_SHADER' are
+attached to PROGRAM, they will be used to create an executable that will
+run on the programmable fragment processor.
The status of the link operation will be stored as part of the program
-object's state. This value will be set to `GL_TRUE' if the program
+object's state. This value will be set to `GL_TRUE' if the program
object was linked without errors and is ready for use, and `GL_FALSE'
-otherwise. It can be queried by calling `glGetProgram' with arguments
+otherwise. It can be queried by calling `glGetProgram' with arguments
PROGRAM and `GL_LINK_STATUS'.
As a result of a successful link operation, all active user-defined
uniform variables belonging to PROGRAM will be initialized to 0, and
each of the program object's active uniform variables will be assigned a
-location that can be queried by calling `glGetUniformLocation'. Also,
+location that can be queried by calling `glGetUniformLocation'. Also,
any active user-defined attribute variables that have not been bound to
a generic vertex attribute index will be bound to one at this time.
Linking of a program object can fail for a number of reasons as
-specified in the OPENGL SHADING LANGUAGE SPECIFICATION. The following
+specified in the OPENGL SHADING LANGUAGE SPECIFICATION. The following
lists some of the conditions that will cause a link error.
* The storage limit for uniform variables has been exceeded.
attribute matrices.
When a program object has been successfully linked, the program object
-can be made part of current state by calling `glUseProgram'. Whether or
+can be made part of current state by calling `glUseProgram'. Whether or
not the link operation was successful, the program object's information
-log will be overwritten. The information log can be retrieved by
-calling `glGetProgramInfoLog'.
+log will be overwritten. The information log can be retrieved by calling
+`glGetProgramInfoLog'.
`glLinkProgram' will also install the generated executables as part of
the current rendering state if the link operation was successful and the
specified program object is already currently in use as a result of a
-previous call to `glUseProgram'. If the program object currently in use
+previous call to `glUseProgram'. If the program object currently in use
is relinked unsuccessfully, its link status will be set to `GL_FALSE' ,
but the executables and associated state will remain part of the current
state until a subsequent call to `glUseProgram' removes it from use.
If PROGRAM contains shader objects of type `GL_VERTEX_SHADER' but does
not contain shader objects of type `GL_FRAGMENT_SHADER', the vertex
shader will be linked against the implicit interface for fixed
-functionality fragment processing. Similarly, if PROGRAM contains
-shader objects of type `GL_FRAGMENT_SHADER' but it does not contain
-shader objects of type `GL_VERTEX_SHADER', the fragment shader will be
-linked against the implicit interface for fixed functionality vertex
+functionality fragment processing. Similarly, if PROGRAM contains shader
+objects of type `GL_FRAGMENT_SHADER' but it does not contain shader
+objects of type `GL_VERTEX_SHADER', the fragment shader will be linked
+against the implicit interface for fixed functionality vertex
processing.
The program object's information log is updated and the program is
-generated at the time of the link operation. After the link operation,
+generated at the time of the link operation. After the link operation,
applications are free to modify attached shader objects, compile
attached shader objects, detach shader objects, delete shader objects,
-and attach additional shader objects. None of these operations affects
+and attach additional shader objects. None of these operations affects
the information log or the program that is part of the program object.
`GL_INVALID_VALUE' is generated if PROGRAM is not a value generated by
BASE
Specifies an integer offset that will be added to `glCallLists'
- offsets to generate display-list names. The initial value is 0.
+ offsets to generate display-list names. The initial value is 0.
-`glCallLists' specifies an array of offsets. Display-list names are
-generated by adding BASE to each offset. Names that reference valid
+`glCallLists' specifies an array of offsets. Display-list names are
+generated by adding BASE to each offset. Names that reference valid
display lists are executed; the others are ignored.
`GL_INVALID_OPERATION' is generated if `glListBase' is executed between
elements of a 4×4 column-major matrix.
`glLoadMatrix' replaces the current matrix with the one whose elements
-are specified by M. The current matrix is the projection matrix,
+are specified by M. The current matrix is the projection matrix,
modelview matrix, or texture matrix, depending on the current matrix
mode (see `glMatrixMode').
-The current matrix, M, defines a transformation of coordinates. For
-instance, assume M refers to the modelview matrix. If
+The current matrix, M, defines a transformation of coordinates. For
+instance, assume M refers to the modelview matrix. If
V=(V\u2061[0,],V\u2061[1,]V\u2061[2,]V\u2061[3,]) is the set of object coordinates of a
vertex, and M points to an array of 16 single- or double-precision
floating-point values M={M\u2061[0,],M\u2061[1,]...M\u2061[15,]} , then the modelview
Specifies a name that will replace the top value on the name stack.
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
+commands to be uniquely identified. It consists of an ordered set of
unsigned integers and is initially empty.
`glLoadName' causes NAME to replace the value on the top of the name
elements of a 4×4 row-major matrix.
`glLoadTransposeMatrix' replaces the current matrix with the one whose
-elements are specified by M. The current matrix is the projection
+elements are specified by M. The current matrix is the projection
matrix, modelview matrix, or texture matrix, depending on the current
matrix mode (see `glMatrixMode').
-The current matrix, M, defines a transformation of coordinates. For
-instance, assume M refers to the modelview matrix. If
+The current matrix, M, defines a transformation of coordinates. For
+instance, assume M refers to the modelview matrix. If
V=(V\u2061[0,],V\u2061[1,]V\u2061[2,]V\u2061[3,]) is the set of object coordinates of a
vertex, and M points to an array of 16 single- or double-precision
floating-point values M={M\u2061[0,],M\u2061[1,]...M\u2061[15,]} , then the modelview
"Specify a logical pixel operation for color index rendering.
OPCODE
- Specifies a symbolic constant that selects a logical operation. The
+ Specifies a symbolic constant that selects a logical operation. The
following symbols are accepted: `GL_CLEAR', `GL_SET', `GL_COPY',
`GL_COPY_INVERTED', `GL_NOOP', `GL_INVERT', `GL_AND', `GL_NAND',
`GL_OR', `GL_NOR', `GL_XOR', `GL_EQUIV', `GL_AND_REVERSE',
- `GL_AND_INVERTED', `GL_OR_REVERSE', and `GL_OR_INVERTED'. The
+ `GL_AND_INVERTED', `GL_OR_REVERSE', and `GL_OR_INVERTED'. The
initial value is `GL_COPY'.
`glLogicOp' 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
+RGBA color at the corresponding location in the frame buffer. To enable
or disable the logical operation, call `glEnable' and `glDisable' using
the symbolic constant `GL_COLOR_LOGIC_OP' for RGBA mode or
-`GL_INDEX_LOGIC_OP' for color index mode. The initial value is disabled
+`GL_INDEX_LOGIC_OP' for color index mode. The initial value is disabled
for both operations.
`GL_OR_INVERTED'
~s | d
-OPCODE is a symbolic constant chosen from the list above. In the
+OPCODE is a symbolic constant chosen from the list above. In the
explanation of the logical operations, S represents the incoming color
-index and D represents the index in the frame buffer. Standard
-C-language operators are used. As these bitwise operators suggest, the
+index and D 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.
STRIDE
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 POINTS. This allows control points to be
- embedded in arbitrary data structures. The only constraint is that
+ structure referenced in POINTS. 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.
ORDER
- Specifies the number of control points. Must be positive.
+ Specifies the number of control points. Must be positive.
POINTS
Specifies a pointer to the array of control points.
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
+using evaluators. These include almost all splines used in computer
graphics: B-splines, Bezier curves, Hermite splines, and so on.
-Evaluators define curves based on Bernstein polynomials. Define P\u2061(U^,)
+Evaluators define curves based on Bernstein polynomials. Define P\u2061(U^,)
as
P\u2061(U^,)=ΣI=0NB_I,^N\u2061(U^,)\u2062R_I
0^0==1 and ((N), (0),,)==1
`glMap1' 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 `glEnable' and `glDisable' with the map name, one of the nine
-predefined values for TARGET described below. `glEvalCoord1' evaluates
-the one-dimensional maps that are enabled. When `glEvalCoord1' presents
-a value U , the Bernstein functions are evaluated using U^ , where
+are produced. Once defined, a map can be enabled and disabled by calling
+`glEnable' and `glDisable' with the map name, one of the nine predefined
+values for TARGET described below. `glEvalCoord1' evaluates the
+one-dimensional maps that are enabled. When `glEvalCoord1' presents a
+value U , the Bernstein functions are evaluated using U^ , where
U^=U-U1,/U2-U1,
TARGET is a symbolic constant that indicates what kind of control points
are provided in POINTS, and what output is generated when the map is
-evaluated. It can assume one of nine predefined values:
+evaluated. It can assume one of nine predefined values:
`GL_MAP1_VERTEX_3'
Each control point is three floating-point values representing X ,
- Y , and Z . Internal `glVertex3' commands are generated when the
+ Y , and Z . Internal `glVertex3' commands are generated when the
map is evaluated.
`GL_MAP1_VERTEX_4'
Each control point is four floating-point values representing X , Y
- , Z , and W . Internal `glVertex4' commands are generated when the
+ , Z , and W . Internal `glVertex4' commands are generated when the
map is evaluated.
`GL_MAP1_INDEX'
Each control point is a single floating-point value representing a
- color index. Internal `glIndex' commands are generated when the
- map is evaluated but the current index is not updated with the
- value of these `glIndex' commands.
+ color index. Internal `glIndex' commands are generated when the map
+ is evaluated but the current index is not updated with the value of
+ these `glIndex' commands.
`GL_MAP1_COLOR_4'
Each control point is four floating-point values representing red,
- green, blue, and alpha. Internal `glColor4' commands are generated
+ green, blue, and alpha. Internal `glColor4' commands are generated
when the map is evaluated but the current color is not updated with
the value of these `glColor4' commands.
`GL_MAP1_NORMAL'
Each control point is three floating-point values representing the
- X , Y , and Z components of a normal vector. Internal `glNormal'
+ X , Y , and Z components of a normal vector. Internal `glNormal'
commands are generated when the map is evaluated but the current
normal is not updated with the value of these `glNormal' commands.
`GL_MAP1_TEXTURE_COORD_1'
Each control point is a single floating-point value representing
- the S texture coordinate. Internal `glTexCoord1' commands are
+ the S texture coordinate. Internal `glTexCoord1' commands are
generated when the map is evaluated but the current texture
coordinates are not updated with the value of these `glTexCoord'
commands.
`GL_MAP1_TEXTURE_COORD_2'
Each control point is two floating-point values representing the S
- and T texture coordinates. Internal `glTexCoord2' commands are
+ and T texture coordinates. Internal `glTexCoord2' commands are
generated when the map is evaluated but the current texture
coordinates are not updated with the value of these `glTexCoord'
commands.
`GL_MAP1_TEXTURE_COORD_3'
Each control point is three floating-point values representing the
- S , T , and R texture coordinates. Internal `glTexCoord3' commands
+ S , T , and R texture coordinates. Internal `glTexCoord3' commands
are generated when the map is evaluated but the current texture
coordinates are not updated with the value of these `glTexCoord'
commands.
`GL_MAP1_TEXTURE_COORD_4'
Each control point is four floating-point values representing the S
- , T , R , and Q texture coordinates. Internal `glTexCoord4'
+ , T , R , and Q texture coordinates. Internal `glTexCoord4'
commands are generated when the map is evaluated but the current
texture coordinates are not updated with the value of these
`glTexCoord' commands.
STRIDE, ORDER, and POINTS define the array addressing for accessing the
-control points. POINTS 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. ORDER is the number of control
-points in the array. STRIDE specifies how many float or double
-locations to advance the internal memory pointer to reach the next
-control point.
+control points. POINTS 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. ORDER is the number of control points in
+the array. STRIDE specifies how many float or double locations to
+advance the internal memory pointer to reach the next control point.
`GL_INVALID_ENUM' is generated if TARGET is not an accepted value.
Specify a linear mapping of U , as presented to `glEvalCoord2', to
U^ , one of the two variables that are evaluated by the equations
- specified by this command. Initially, U1 is 0 and U2 is 1.
+ specified by this command. Initially, U1 is 0 and U2 is 1.
USTRIDE
Specifies the number of floats or doubles between the beginning of
control point R_IJ and the beginning of control point R_(I+1,)\u2062J, ,
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 USTRIDE is 0.
+ structures. The only constraint is that the values for a particular
+ control point must occupy contiguous memory locations. The initial
+ value of USTRIDE is 0.
UORDER
Specifies the dimension of the control point array in the U axis.
- Must be positive. The initial value is 1.
+ Must be positive. The initial value is 1.
V1
V2
Specify a linear mapping of V , as presented to `glEvalCoord2', to
V^ , one of the two variables that are evaluated by the equations
- specified by this command. Initially, V1 is 0 and V2 is 1.
+ specified by this command. Initially, V1 is 0 and V2 is 1.
VSTRIDE
Specifies the number of floats or doubles between the beginning of
control point R_IJ and the beginning of control point R_I\u2061(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 VSTRIDE is 0.
+ structures. The only constraint is that the values for a particular
+ control point must occupy contiguous memory locations. The initial
+ value of VSTRIDE is 0.
VORDER
Specifies the dimension of the control point array in the V axis.
- Must be positive. The initial value is 1.
+ Must be positive. The initial value is 1.
POINTS
Specifies a pointer to the array of control points.
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
+using evaluators. These include almost all surfaces used in computer
graphics, including B-spline surfaces, NURBS surfaces, Bezier surfaces,
and so on.
Recall that 0^0==1 and ((N), (0),,)==1
`glMap2' 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 `glEnable' and `glDisable' with the map name, one of the nine
-predefined values for TARGET, described below. When `glEvalCoord2'
-presents values U and V , the bivariate Bernstein polynomials are
-evaluated using U^ and V^ , where
+are produced. Once defined, a map can be enabled and disabled by calling
+`glEnable' and `glDisable' with the map name, one of the nine predefined
+values for TARGET, described below. When `glEvalCoord2' presents values
+U and V , the bivariate Bernstein polynomials are evaluated using U^ and
+V^ , where
U^=U-U1,/U2-U1,
TARGET is a symbolic constant that indicates what kind of control points
are provided in POINTS, and what output is generated when the map is
-evaluated. It can assume one of nine predefined values:
+evaluated. It can assume one of nine predefined values:
`GL_MAP2_VERTEX_3'
Each control point is three floating-point values representing X ,
- Y , and Z . Internal `glVertex3' commands are generated when the
+ Y , and Z . Internal `glVertex3' commands are generated when the
map is evaluated.
`GL_MAP2_VERTEX_4'
Each control point is four floating-point values representing X , Y
- , Z , and W . Internal `glVertex4' commands are generated when the
+ , Z , and W . Internal `glVertex4' commands are generated when the
map is evaluated.
`GL_MAP2_INDEX'
Each control point is a single floating-point value representing a
- color index. Internal `glIndex' commands are generated when the
- map is evaluated but the current index is not updated with the
- value of these `glIndex' commands.
+ color index. Internal `glIndex' commands are generated when the map
+ is evaluated but the current index is not updated with the value of
+ these `glIndex' commands.
`GL_MAP2_COLOR_4'
Each control point is four floating-point values representing red,
- green, blue, and alpha. Internal `glColor4' commands are generated
+ green, blue, and alpha. Internal `glColor4' commands are generated
when the map is evaluated but the current color is not updated with
the value of these `glColor4' commands.
`GL_MAP2_NORMAL'
Each control point is three floating-point values representing the
- X , Y , and Z components of a normal vector. Internal `glNormal'
+ X , Y , and Z components of a normal vector. Internal `glNormal'
commands are generated when the map is evaluated but the current
normal is not updated with the value of these `glNormal' commands.
`GL_MAP2_TEXTURE_COORD_1'
Each control point is a single floating-point value representing
- the S texture coordinate. Internal `glTexCoord1' commands are
+ the S texture coordinate. Internal `glTexCoord1' commands are
generated when the map is evaluated but the current texture
coordinates are not updated with the value of these `glTexCoord'
commands.
`GL_MAP2_TEXTURE_COORD_2'
Each control point is two floating-point values representing the S
- and T texture coordinates. Internal `glTexCoord2' commands are
+ and T texture coordinates. Internal `glTexCoord2' commands are
generated when the map is evaluated but the current texture
coordinates are not updated with the value of these `glTexCoord'
commands.
`GL_MAP2_TEXTURE_COORD_3'
Each control point is three floating-point values representing the
- S , T , and R texture coordinates. Internal `glTexCoord3' commands
+ S , T , and R texture coordinates. Internal `glTexCoord3' commands
are generated when the map is evaluated but the current texture
coordinates are not updated with the value of these `glTexCoord'
commands.
`GL_MAP2_TEXTURE_COORD_4'
Each control point is four floating-point values representing the S
- , T , R , and Q texture coordinates. Internal `glTexCoord4'
+ , T , R , and Q texture coordinates. Internal `glTexCoord4'
commands are generated when the map is evaluated but the current
texture coordinates are not updated with the value of these
`glTexCoord' commands.
USTRIDE, UORDER, VSTRIDE, VORDER, and POINTS define the array addressing
-for accessing the control points. POINTS is the location of the first
+for accessing the control points. POINTS 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
-UORDER×VORDER control points in the array. USTRIDE specifies how many
+locations, depending on which map is being defined. There are
+UORDER×VORDER control points in the array. USTRIDE specifies how many
float or double locations are skipped to advance the internal memory
-pointer from control point R_I\u2062J, to control point R_(I+1,)\u2062J, . VSTRIDE
+pointer from control point R_I\u2062J, to control point R_(I+1,)\u2062J, . VSTRIDE
specifies how many float or double locations are skipped to advance the
internal memory pointer from control point R_I\u2062J, to control point
R_I\u2061(J+1,), .
"Map a buffer object's data store.
TARGET
- Specifies the target buffer object being mapped. The symbolic
+ Specifies the target buffer object being mapped. The symbolic
constant must be `GL_ARRAY_BUFFER', `GL_ELEMENT_ARRAY_BUFFER',
`GL_PIXEL_PACK_BUFFER', or `GL_PIXEL_UNPACK_BUFFER'.
ACCESS
Specifies the access policy, indicating whether it will be possible
to read from, write to, or both read from and write to the buffer
- object's mapped data store. The symbolic constant must be
+ object's mapped data store. The symbolic constant must be
`GL_READ_ONLY', `GL_WRITE_ONLY', or `GL_READ_WRITE'.
`glMapBuffer' maps to the client's address space the entire data store
-of the buffer object currently bound to TARGET. The data can then be
+of the buffer object currently bound to TARGET. The data can then be
directly read and/or written relative to the returned pointer, depending
-on the specified ACCESS policy. If the GL is unable to map the buffer
+on the specified ACCESS policy. If the GL is unable to map the buffer
object's data store, `glMapBuffer' generates an error and returns
-`NULL'. This may occur for system-specific reasons, such as low virtual
+`NULL'. This may occur for system-specific reasons, such as low virtual
memory availability.
If a mapped data store is accessed in a way inconsistent with the
specified ACCESS policy, no error is generated, but performance may be
negatively impacted and system errors, including program termination,
-may result. Unlike the USAGE parameter of `glBufferData', ACCESS is not
+may result. Unlike the USAGE parameter of `glBufferData', ACCESS is not
a hint, and does in fact constrain the usage of the mapped data store on
-some GL implementations. In order to achieve the highest performance
+some GL implementations. In order to achieve the highest performance
available, a buffer object's data store should be used in ways
consistent with both its specified USAGE and ACCESS parameters.
A mapped data store must be unmapped with `glUnmapBuffer' before its
-buffer object is used. Otherwise an error will be generated by any GL
+buffer object is used. Otherwise an error will be generated by any GL
command that attempts to dereference the buffer object's data store.
When a data store is unmapped, the pointer to its data store becomes
-invalid. `glUnmapBuffer' returns `GL_TRUE' unless the data store
+invalid. `glUnmapBuffer' returns `GL_TRUE' unless the data store
contents have become corrupt during the time the data store was mapped.
This can occur for system-specific reasons that affect the availability
-of graphics memory, such as screen mode changes. In such situations,
-`GL_FALSE' is returned and the data store contents are undefined. An
+of graphics memory, such as screen mode changes. In such situations,
+`GL_FALSE' is returned and the data store contents are undefined. An
application must detect this rare condition and reinitialize the data
store.
`GL_WRITE_ONLY', or `GL_READ_WRITE'.
`GL_OUT_OF_MEMORY' is generated when `glMapBuffer' is executed if the GL
-is unable to map the buffer object's data store. This may occur for a
+is unable to map the buffer object's data store. This may occur for a
variety of system-specific reasons, such as the absence of sufficient
remaining virtual memory.
UN
Specifies the number of partitions in the grid range interval [U1,
- U2]. Must be positive.
+ U2]. Must be positive.
U1
U2
(`glMapGrid2' only).
`glMapGrid' and `glEvalMesh' are used together to efficiently generate
-and evaluate a series of evenly-spaced map domain values. `glEvalMesh'
+and evaluate a series of evenly-spaced map domain values. `glEvalMesh'
steps through the integer domain of a one- or two-dimensional grid,
whose range is the domain of the evaluation maps specified by `glMap1'
and `glMap2'.
`glMapGrid1' and `glMapGrid2' 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 `glMap1' and `glMap2'
-for details of how U and V coordinates are evaluated.
+floating-point evaluation map coordinates. See `glMap1' and `glMap2' for
+details of how U and V coordinates are evaluated.
`glMapGrid1' specifies a single linear mapping such that integer grid
coordinate 0 maps exactly to U1, and integer grid coordinate UN maps
-exactly to U2. All other integer grid coordinates I are mapped so that
+exactly to U2. All other integer grid coordinates I are mapped so that
U=I\u2061(U2-U1,)/UN+U1
-`glMapGrid2' specifies two such linear mappings. One maps integer grid
+`glMapGrid2' specifies two such linear mappings. One maps integer grid
coordinate I=0 exactly to U1, and integer grid coordinate I=UN exactly
-to U2. The other maps integer grid coordinate J=0 exactly to V1, and
-integer grid coordinate J=VN exactly to V2. Other integer grid
+to U2. The other maps integer grid coordinate J=0 exactly to V1, and
+integer grid coordinate J=VN exactly to V2. Other integer grid
coordinates I and J are mapped such that
U=I\u2061(U2-U1,)/UN+U1
"Specify material parameters for the lighting model.
FACE
- Specifies which face or faces are being updated. Must be one of
+ Specifies which face or faces are being updated. Must be one of
`GL_FRONT', `GL_BACK', or `GL_FRONT_AND_BACK'.
PNAME
Specifies the single-valued material parameter of the face or faces
- that is being updated. Must be `GL_SHININESS'.
+ that is being updated. Must be `GL_SHININESS'.
PARAM
Specifies the value that parameter `GL_SHININESS' will be set to.
-`glMaterial' assigns values to material parameters. There are two
-matched sets of material parameters. One, the FRONT-FACING set, is used
+`glMaterial' assigns values to material parameters. There are two
+matched sets of material parameters. One, the FRONT-FACING 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, BACK-FACING, is used to shade
-back-facing polygons only when two-sided lighting is enabled. Refer to
+lighting is enabled). The other set, BACK-FACING, is used to shade
+back-facing polygons only when two-sided lighting is enabled. Refer to
the `glLightModel' reference page for details concerning one- and
two-sided lighting calculations.
-`glMaterial' takes three arguments. The first, FACE, specifies whether
+`glMaterial' takes three arguments. The first, FACE, specifies whether
the `GL_FRONT' materials, the `GL_BACK' materials, or both
-`GL_FRONT_AND_BACK' materials will be modified. The second, PNAME,
+`GL_FRONT_AND_BACK' materials will be modified. The second, PNAME,
specifies which of several parameters in one or both sets will be
-modified. The third, PARAMS, specifies what value or values will be
+modified. The third, PARAMS, specifies what value or values will be
assigned to the specified parameter.
Material parameters are used in the lighting equation that is optionally
-applied to each vertex. The equation is discussed in the `glLightModel'
-reference page. The parameters that can be specified using
-`glMaterial', and their interpretations by the lighting equation, are as
-follows:
+applied to each vertex. The equation is discussed in the `glLightModel'
+reference page. The parameters that can be specified using `glMaterial',
+and their interpretations by the lighting equation, are as follows:
`GL_AMBIENT'
PARAMS contains four integer or floating-point values that specify
- the ambient RGBA reflectance of the material. Integer values are
+ 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
+ . 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).
`GL_DIFFUSE'
PARAMS contains four integer or floating-point values that specify
- the diffuse RGBA reflectance of the material. Integer values are
+ 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
+ . 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).
`GL_SPECULAR'
PARAMS contains four integer or floating-point values that specify
- the specular RGBA reflectance of the material. Integer values are
+ 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).
+ . 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).
`GL_EMISSION'
PARAMS contains four integer or floating-point values that specify
- the RGBA emitted light intensity of the material. Integer values
+ 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
+ . 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).
`GL_SHININESS'
PARAMS 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.
+ 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.
`GL_AMBIENT_AND_DIFFUSE'
Equivalent to calling `glMaterial' twice with the same parameter
PARAMS contains three integer or floating-point values specifying
the color indices for ambient, diffuse, and specular lighting.
These three values, and `GL_SHININESS', are the only material
- values used by the color index mode lighting equation. Refer to
- the `glLightModel' reference page for a discussion of color index
+ values used by the color index mode lighting equation. Refer to the
+ `glLightModel' reference page for a discussion of color index
lighting.
`GL_INVALID_ENUM' is generated if either FACE or PNAME is not an
MODE
Specifies which matrix stack is the target for subsequent matrix
- operations. Three values are accepted: `GL_MODELVIEW',
- `GL_PROJECTION', and `GL_TEXTURE'. The initial value is
- `GL_MODELVIEW'. Additionally, if the `ARB_imaging' extension is
+ operations. Three values are accepted: `GL_MODELVIEW',
+ `GL_PROJECTION', and `GL_TEXTURE'. The initial value is
+ `GL_MODELVIEW'. Additionally, if the `ARB_imaging' extension is
supported, `GL_COLOR' is also accepted.
-`glMatrixMode' sets the current matrix mode. MODE can assume one of
-four values:
+`glMatrixMode' sets the current matrix mode. MODE can assume one of four
+values:
`GL_MODELVIEW'
Applies subsequent matrix operations to the modelview matrix stack.
Applies subsequent matrix operations to the color matrix stack.
To find out which matrix stack is currently the target of all matrix
-operations, call `glGet' with argument `GL_MATRIX_MODE'. The initial
+operations, call `glGet' with argument `GL_MATRIX_MODE'. The initial
value is `GL_MODELVIEW'.
`GL_INVALID_ENUM' is generated if MODE is not an accepted value.
"Define minmax table.
TARGET
- The minmax table whose parameters are to be set. Must be
+ The minmax table whose parameters are to be set. Must be
`GL_MINMAX'.
INTERNALFORMAT
- The format of entries in the minmax table. Must be one of
+ The format of entries in the minmax table. Must be one of
`GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16',
`GL_LUMINANCE', `GL_LUMINANCE4', `GL_LUMINANCE8', `GL_LUMINANCE12',
`GL_LUMINANCE16', `GL_LUMINANCE_ALPHA', `GL_LUMINANCE4_ALPHA4',
SINK
If `GL_TRUE', pixels will be consumed by the minmax process and no
- drawing or texture loading will take place. If `GL_FALSE', pixels
+ drawing or texture loading will take place. If `GL_FALSE', pixels
will proceed to the final conversion process after minmax.
When `GL_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 two-element minmax table. (The first element stores the
+stored in the two-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
+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
+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 `glGetMinmax'. The minmax operation is
+at a later time by calling `glGetMinmax'. The minmax operation is
enabled or disabled by calling `glEnable' or `glDisable', respectively,
with an argument of `GL_MINMAX'.
`glMinmax' redefines the current minmax table to have entries of the
-format specified by INTERNALFORMAT. The maximum element is initialized
+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 `GL_TRUE', then
+initialized with the largest possible component values. The values in
+the previous minmax table, if any, are lost. If SINK is `GL_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.
"Render multiple sets of primitives from array data.
MODE
- Specifies what kind of primitives to render. Symbolic constants
+ Specifies what kind of primitives to render. Symbolic constants
`GL_POINTS', `GL_LINE_STRIP', `GL_LINE_LOOP', `GL_LINES',
`GL_TRIANGLE_STRIP', `GL_TRIANGLE_FAN', `GL_TRIANGLES',
`GL_QUAD_STRIP', `GL_QUADS', and `GL_POLYGON' are accepted.
Specifies the size of the first and count
`glMultiDrawArrays' specifies multiple sets of geometric primitives with
-very few subroutine calls. Instead of calling a GL procedure to pass
+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
When `glMultiDrawArrays' is called, it uses COUNT sequential elements
from each enabled array to construct a sequence of geometric primitives,
-beginning with element FIRST. MODE specifies what kind of primitives
-are constructed, and how the array elements construct those primitives.
-If `GL_VERTEX_ARRAY' is not enabled, no geometric primitives are
-generated.
+beginning with element FIRST. MODE specifies what kind of primitives are
+constructed, and how the array elements construct those primitives. If
+`GL_VERTEX_ARRAY' is not enabled, no geometric primitives are generated.
Vertex attributes that are modified by `glMultiDrawArrays' have an
-unspecified value after `glMultiDrawArrays' returns. For example, if
+unspecified value after `glMultiDrawArrays' returns. For example, if
`GL_COLOR_ARRAY' is enabled, the value of the current color is undefined
-after `glMultiDrawArrays' executes. Attributes that aren't modified
+after `glMultiDrawArrays' executes. Attributes that aren't modified
remain well defined.
`GL_INVALID_ENUM' is generated if MODE is not an accepted value.
elements.
MODE
- Specifies what kind of primitives to render. Symbolic constants
+ Specifies what kind of primitives to render. Symbolic constants
`GL_POINTS', `GL_LINE_STRIP', `GL_LINE_LOOP', `GL_LINES',
`GL_TRIANGLE_STRIP', `GL_TRIANGLE_FAN', `GL_TRIANGLES',
`GL_QUAD_STRIP', `GL_QUADS', and `GL_POLYGON' are accepted.
Points to an array of the elements counts.
TYPE
- Specifies the type of the values in INDICES. Must be one of
+ Specifies the type of the values in INDICES. Must be one of
`GL_UNSIGNED_BYTE', `GL_UNSIGNED_SHORT', or `GL_UNSIGNED_INT'.
INDICES
Specifies the size of the COUNT array.
`glMultiDrawElements' specifies multiple sets of 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 `glMultiDrawElements'.
+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
+`glMultiDrawElements'.
`glMultiDrawElements' is identical in operation to `glDrawElements'
except that PRIMCOUNT separate lists of elements are specified.
Vertex attributes that are modified by `glMultiDrawElements' have an
-unspecified value after `glMultiDrawElements' returns. For example, if
+unspecified value after `glMultiDrawElements' returns. For example, if
`GL_COLOR_ARRAY' is enabled, the value of the current color is undefined
-after `glMultiDrawElements' executes. Attributes that aren't modified
+after `glMultiDrawElements' executes. Attributes that aren't modified
maintain their previous values.
`GL_INVALID_ENUM' is generated if MODE is not an accepted value.
TARGET
Specifies the texture unit whose coordinates should be modified.
The number of texture units is implementation dependent, but must
- be at least two. Symbolic constant must be one of `GL_TEXTURE' I ,
+ be at least two. Symbolic constant must be one of `GL_TEXTURE' I ,
where i ranges from 0 to `GL_MAX_TEXTURE_COORDS' - 1, which is an
implementation-dependent value.
Not all parameters are present in all forms of the command.
`glMultiTexCoord' specifies texture coordinates in one, two, three, or
-four dimensions. `glMultiTexCoord1' sets the current texture
-coordinates to (S,001) ; a call to `glMultiTexCoord2' sets them to
-(S,T01) . Similarly, `glMultiTexCoord3' specifies the texture
-coordinates as (S,TR1) , and `glMultiTexCoord4' defines all four
-components explicitly as (S,TRQ) .
+four dimensions. `glMultiTexCoord1' sets the current texture coordinates
+to (S,001) ; a call to `glMultiTexCoord2' sets them to (S,T01) .
+Similarly, `glMultiTexCoord3' specifies the texture coordinates as
+(S,TR1) , and `glMultiTexCoord4' defines all four components explicitly
+as (S,TRQ) .
The current texture coordinates are part of the data that is associated
-with each vertex and with the current raster position. Initially, the
+with each vertex and with the current raster position. Initially, the
values for (S,TRQ) are (0,001) .")
(define-gl-procedures
using M, and replaces the current matrix with the product.
The current matrix is determined by the current matrix mode (see
-`glMatrixMode'). It is either the projection matrix, modelview matrix,
+`glMatrixMode'). It is either the projection matrix, modelview matrix,
or the texture matrix.
`GL_INVALID_OPERATION' is generated if `glMultMatrix' is executed
specified using M, and replaces the current matrix with the product.
The current matrix is determined by the current matrix mode (see
-`glMatrixMode'). It is either the projection matrix, modelview matrix,
+`glMatrixMode'). It is either the projection matrix, modelview matrix,
or the texture matrix.
`GL_INVALID_OPERATION' is generated if `glMultTransposeMatrix' is
`GL_COMPILE_AND_EXECUTE'.
Display lists are groups of GL commands that have been stored for
-subsequent execution. Display lists are created with `glNewList'. All
+subsequent execution. Display lists are created with `glNewList'. All
subsequent commands are placed in the display list, in the order issued,
until `glEndList' is called.
-`glNewList' has two arguments. The first argument, LIST, is a positive
-integer that becomes the unique name for the display list. Names can be
+`glNewList' has two arguments. The first argument, LIST, is a positive
+integer that becomes the unique name for the display list. Names can be
created and reserved with `glGenLists' and tested for uniqueness with
-`glIsList'. The second argument, MODE, is a symbolic constant that can
+`glIsList'. The second argument, MODE, is a symbolic constant that can
assume one of two values:
`GL_COMPILE'
Commands are executed as they are compiled into the display list.
Certain commands are not compiled into the display list but are executed
-immediately, regardless of the display-list mode. These commands are
+immediately, regardless of the display-list mode. These commands are
`glAreTexturesResident', `glColorPointer', `glDeleteLists',
`glDeleteTextures', `glDisableClientState', `glEdgeFlagPointer',
`glEnableClientState', `glFeedbackBuffer', `glFinish', `glFlush',
`GL_PROXY_TEXTURE_3D', respectively.
When the `ARB_imaging' extension is supported, `glHistogram' executes
-immediately when its argument is `GL_PROXY_HISTOGRAM'. Similarly,
+immediately when its argument is `GL_PROXY_HISTOGRAM'. Similarly,
`glColorTable' executes immediately when its first argument is
`GL_PROXY_COLOR_TABLE', `GL_PROXY_POST_CONVOLUTION_COLOR_TABLE', or
`GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE'.
When `glEndList' is encountered, the display-list definition is
completed by associating the list with the unique name LIST (specified
-in the `glNewList' command). If a display list with name LIST already
+in the `glNewList' command). If a display list with name LIST already
exists, it is replaced only when `glEndList' is called.
`GL_INVALID_VALUE' is generated if LIST is 0.
execution of `glEnd'.
`GL_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.)")
+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.)")
(define-gl-procedures
((glNormalPointer
"Define an array of normals.
TYPE
- Specifies the data type of each coordinate in the array. Symbolic
+ Specifies the data type of each coordinate in the array. Symbolic
constants `GL_BYTE', `GL_SHORT', `GL_INT', `GL_FLOAT', and
- `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
+ `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
STRIDE
- Specifies the byte offset between consecutive normals. If STRIDE
- is 0, the normals are understood to be tightly packed in the array.
+ Specifies the byte offset between consecutive normals. If STRIDE is
+ 0, the normals are understood to be tightly packed in the array.
The initial value is 0.
POINTER
Specifies a pointer to the first coordinate of the first normal in
- the array. The initial value is 0.
+ the array. The initial value is 0.
`glNormalPointer' specifies the location and data format of an array of
-normals to use when rendering. TYPE specifies the data type of each
+normals to use when rendering. TYPE specifies the data type of each
normal coordinate, and STRIDE specifies 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
+array or stored in separate arrays. (Single-array storage may be more
efficient on some implementations; see `glInterleavedArrays'.)
If a non-zero named buffer object is bound to the `GL_ARRAY_BUFFER'
target (see `glBindBuffer') while a normal array is specified, POINTER
-is treated as a byte offset into the buffer object's data store. Also,
+is treated as a byte offset into the buffer object's data store. Also,
the buffer object binding (`GL_ARRAY_BUFFER_BINDING') is saved as normal
vertex array client-side state (`GL_NORMAL_ARRAY_BUFFER_BINDING').
binding.
To enable and disable the normal array, call `glEnableClientState' and
-`glDisableClientState' with the argument `GL_NORMAL_ARRAY'. If enabled,
+`glDisableClientState' with the argument `GL_NORMAL_ARRAY'. If enabled,
the normal array is used when `glDrawArrays', `glMultiDrawArrays',
`glDrawElements', `glMultiDrawElements', `glDrawRangeElements', or
`glArrayElement' is called.
The current normal is set to the given coordinates whenever `glNormal'
-is issued. Byte, short, or integer arguments are converted to
+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 .
-Normals specified with `glNormal' need not have unit length. If
+Normals specified with `glNormal' need not have unit length. If
`GL_NORMALIZE' is enabled, then normals of any length specified with
-`glNormal' are normalized after transformation. If `GL_RESCALE_NORMAL'
+`glNormal' are normalized after transformation. If `GL_RESCALE_NORMAL'
is enabled, normals are scaled by a scaling factor derived from the
-modelview matrix. `GL_RESCALE_NORMAL' requires that the originally
+modelview matrix. `GL_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
+contain only uniform scales for proper results. To enable and disable
normalization, call `glEnable' and `glDisable' with either
-`GL_NORMALIZE' or `GL_RESCALE_NORMAL'. Normalization is initially
+`GL_NORMALIZE' or `GL_RESCALE_NORMAL'. Normalization is initially
disabled.")
(define-gl-procedures
FARVAL
Specify the distances to the nearer and farther depth clipping
- planes. These values are negative if the plane is to be behind the
+ planes. These values are negative if the plane is to be behind the
viewer.
`glOrtho' describes a transformation that produces a parallel
-projection. The current matrix (see `glMatrixMode') is multiplied by
+projection. The current matrix (see `glMatrixMode') is multiplied by
this matrix and the result replaces the current matrix, as if
`glMultMatrix' were called with the following matrix as its argument:
Typically, the matrix mode is `GL_PROJECTION', and (LEFT,BOTTOM-NEARVAL)
and (RIGHT,TOP-NEARVAL) 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). -FARVAL
-specifies the location of the far clipping plane. Both NEARVAL and
+respectively, assuming that the eye is located at (0, 0, 0). -FARVAL
+specifies the location of the far clipping plane. Both NEARVAL and
FARVAL can be either positive or negative.
Use `glPushMatrix' and `glPopMatrix' to save and restore the current
-Feedback is a GL render mode. The mode is selected by calling
-`glRenderMode' with `GL_FEEDBACK'. When the GL is in feedback mode, no
-pixels are produced by rasterization. Instead, information about
+Feedback is a GL render mode. The mode is selected by calling
+`glRenderMode' with `GL_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 `glFeedbackBuffer' reference page for
+application using the GL. See the `glFeedbackBuffer' reference page for
a description of the feedback buffer and the values in it.
`glPassThrough' inserts a user-defined marker in the feedback buffer
-when it is executed in feedback mode. TOKEN is returned as if it were a
+when it is executed in feedback mode. TOKEN is returned as if it were a
primitive; it is indicated with its own unique identifying value:
-`GL_PASS_THROUGH_TOKEN'. The order of `glPassThrough' commands with
+`GL_PASS_THROUGH_TOKEN'. The order of `glPassThrough' commands with
respect to the specification of graphics primitives is maintained.
`GL_INVALID_OPERATION' is generated if `glPassThrough' is executed
"Set up pixel transfer maps.
MAP
- Specifies a symbolic map name. Must be one of the following:
+ Specifies a symbolic map name. Must be one of the following:
`GL_PIXEL_MAP_I_TO_I', `GL_PIXEL_MAP_S_TO_S',
`GL_PIXEL_MAP_I_TO_R', `GL_PIXEL_MAP_I_TO_G',
`GL_PIXEL_MAP_I_TO_B', `GL_PIXEL_MAP_I_TO_A',
`glCopyTexSubImage1D', `glCopyTexSubImage2D', `glCopyTexSubImage3D',
`glDrawPixels', `glReadPixels', `glTexImage1D', `glTexImage2D',
`glTexImage3D', `glTexSubImage1D', `glTexSubImage2D', and
-`glTexSubImage3D'. Additionally, if the `ARB_imaging' subset is
+`glTexSubImage3D'. Additionally, if the `ARB_imaging' subset is
supported, the routines `glColorTable', `glColorSubTable',
`glConvolutionFilter1D', `glConvolutionFilter2D', `glHistogram',
-`glMinmax', and `glSeparableFilter2D'. Use of these maps is described
+`glMinmax', and `glSeparableFilter2D'. Use of these maps is described
completely in the `glPixelTransfer' reference page, and partly in the
-reference pages for the pixel and texture image commands. Only the
+reference pages for the pixel and texture image commands. Only the
specification of the maps is described in this reference page.
-MAP is a symbolic map name, indicating one of ten maps to set. MAPSIZE
+MAP is a symbolic map name, indicating one of ten maps to set. MAPSIZE
specifies the number of entries in the map, and VALUES is a pointer to
an array of MAPSIZE map values.
Maps alpha components to alpha components.
The entries in a map can be specified as single-precision floating-point
-numbers, unsigned short integers, or unsigned int integers. Maps that
+numbers, unsigned short integers, or unsigned int integers. Maps that
store color component values (all but `GL_PIXEL_MAP_I_TO_I' and
`GL_PIXEL_MAP_S_TO_S') retain their values in floating-point format,
-with unspecified mantissa and exponent sizes. Floating-point values
+with unspecified mantissa and exponent sizes. Floating-point values
specified by `glPixelMapfv' are converted directly to the internal
floating-point format of these maps, then clamped to the range [0,1].
Unsigned integer values specified by `glPixelMapusv' and `glPixelMapuiv'
`GL_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 `glPixelMapfv' are converted directly
-to the internal fixed-point format of these maps. Unsigned integer
+to the internal fixed-point format of these maps. Unsigned integer
values specified by `glPixelMapusv' and `glPixelMapuiv' specify integer
values, with all 0's to the right of the binary point.
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 MAPSIZE = 2^N for some N or the results are undefined. The maximum
+maps. Maps that are indexed by either color or stencil indices must have
+MAPSIZE = 2^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 `glGet' with argument `GL_MAX_PIXEL_MAP_TABLE'.
The single maximum applies to all maps; it is at least 32.
"Set pixel storage modes.
PNAME
- Specifies the symbolic name of the parameter to be set. Six values
+ Specifies the symbolic name of the parameter to be set. Six values
affect the packing of pixel data into memory: `GL_PACK_SWAP_BYTES',
`GL_PACK_LSB_FIRST', `GL_PACK_ROW_LENGTH', `GL_PACK_IMAGE_HEIGHT',
`GL_PACK_SKIP_PIXELS', `GL_PACK_SKIP_ROWS', `GL_PACK_SKIP_IMAGES',
- and `GL_PACK_ALIGNMENT'. Six more affect the unpacking of pixel
+ and `GL_PACK_ALIGNMENT'. Six more affect the unpacking of pixel
data FROM memory: `GL_UNPACK_SWAP_BYTES', `GL_UNPACK_LSB_FIRST',
`GL_UNPACK_ROW_LENGTH', `GL_UNPACK_IMAGE_HEIGHT',
`GL_UNPACK_SKIP_PIXELS', `GL_UNPACK_SKIP_ROWS',
polygon stipple patterns (see `glPolygonStipple'), bitmaps (see
`glBitmap'), texture patterns (see `glTexImage1D', `glTexImage2D',
`glTexImage3D', `glTexSubImage1D', `glTexSubImage2D',
-`glTexSubImage3D'). Additionally, if the `ARB_imaging' extension is
+`glTexSubImage3D'). Additionally, if the `ARB_imaging' extension is
supported, pixel storage modes affect convolution filters (see
`glConvolutionFilter1D', `glConvolutionFilter2D', and
`glSeparableFilter2D', color table (see `glColorTable', and
minmax (See `glMinmax') data.
PNAME is a symbolic constant indicating the parameter to be set, and
-PARAM is the new value. Six of the twelve storage parameters affect how
-pixel data is returned to client memory. They are as follows:
+PARAM is the new value. Six of the twelve storage parameters affect how
+pixel data is returned to client memory. They are as follows:
`GL_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_0 , B_1 , B_2 ,
- B_3 , it is stored in memory as B_3 , B_2 , B_1 , B_0 if
- `GL_PACK_SWAP_BYTES' is true. `GL_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, color indices, or stencil indices is reversed. That is,
+ if a four-byte component consists of bytes B_0 , B_1 , B_2 , B_3 ,
+ it is stored in memory as B_3 , B_2 , B_1 , B_0 if
+ `GL_PACK_SWAP_BYTES' is true. `GL_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 `GL_RGB' format pixel are always stored with red
first, green second, and blue third, regardless of the value of
`GL_PACK_SWAP_BYTES'.
`GL_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
+ significant one. This parameter is significant for bitmap data
only.
`GL_PACK_ROW_LENGTH'
If greater than 0, `GL_PACK_ROW_LENGTH' defines the number of
- pixels in a row. If the first pixel of a row is placed at location
+ 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
(`GL_PACK_ROW_LENGTH' if it is greater than 0, the WIDTH argument
to the pixel routine otherwise), A is the value of
`GL_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
+ 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
K=8\u2062A\u2062⌈N\u2062L,/8\u2062A,,⌉
components or indices.
The word COMPONENT in this description refers to the nonindex
- values red, green, blue, alpha, and depth. Storage format
- `GL_RGB', for example, has three components per pixel: first red,
- then green, and finally blue.
+ values red, green, blue, alpha, and depth. Storage format `GL_RGB',
+ for example, has three components per pixel: first red, then green,
+ and finally blue.
`GL_PACK_IMAGE_HEIGHT'
If greater than 0, `GL_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
+ 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
component (if A<S , then it is as if A=S ).
The word COMPONENT in this description refers to the nonindex
- values red, green, blue, alpha, and depth. Storage format
- `GL_RGB', for example, has three components per pixel: first red,
- then green, and finally blue.
+ values red, green, blue, alpha, and depth. Storage format `GL_RGB',
+ for example, has three components per pixel: first red, then green,
+ and finally blue.
`GL_PACK_SKIP_PIXELS', `GL_PACK_SKIP_ROWS', and `GL_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 `glReadPixels'. Setting
+ incrementing the pointer passed to `glReadPixels'. Setting
`GL_PACK_SKIP_PIXELS' to I is equivalent to incrementing the
pointer by I\u2062N components or indices, where N is the number of
- components or indices in each pixel. Setting `GL_PACK_SKIP_ROWS'
- to J is equivalent to incrementing the pointer by J\u2062M components or
+ components or indices in each pixel. Setting `GL_PACK_SKIP_ROWS' to
+ J is equivalent to incrementing the pointer by J\u2062M components or
indices, where M is the number of components or indices per row, as
- just computed in the `GL_PACK_ROW_LENGTH' section. Setting
+ just computed in the `GL_PACK_ROW_LENGTH' section. Setting
`GL_PACK_SKIP_IMAGES' to K is equivalent to incrementing the
pointer by K\u2062P , where P is the number of components or indices per
image, as computed in the `GL_PACK_IMAGE_HEIGHT' section.
`GL_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).
+ 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).
The other six of the twelve storage parameters affect how pixel data is
-read from client memory. These values are significant for
+read from client memory. These values are significant for
`glDrawPixels', `glTexImage1D', `glTexImage2D', `glTexImage3D',
`glTexSubImage1D', `glTexSubImage2D', `glTexSubImage3D', `glBitmap', and
`glPolygonStipple'.
Additionally, if the `ARB_imaging' extension is supported,
`glColorTable', `glColorSubTable', `glConvolutionFilter1D',
-`glConvolutionFilter2D', and `glSeparableFilter2D'. They are as
-follows:
+`glConvolutionFilter2D', and `glSeparableFilter2D'. They are as follows:
`GL_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_0 , B_1 , B_2 ,
- B_3 , it is taken from memory as B_3 , B_2 , B_1 , B_0 if
- `GL_UNPACK_SWAP_BYTES' is true. `GL_UNPACK_SWAP_BYTES' has no
+ components, color indices, or stencil indices is reversed. That is,
+ if a four-byte component consists of bytes B_0 , B_1 , B_2 , B_3 ,
+ it is taken from memory as B_3 , B_2 , B_1 , B_0 if
+ `GL_UNPACK_SWAP_BYTES' is true. `GL_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
+ the order of bytes within components or indices. For example, the
three components of a `GL_RGB' format pixel are always stored with
red first, green second, and blue third, regardless of the value of
`GL_UNPACK_SWAP_BYTES'.
`GL_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.
+ significant one. This is relevant only for bitmap data.
`GL_UNPACK_ROW_LENGTH'
If greater than 0, `GL_UNPACK_ROW_LENGTH' defines the number of
- pixels in a row. If the first pixel of a row is placed at location
+ 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
(`GL_UNPACK_ROW_LENGTH' if it is greater than 0, the WIDTH argument
to the pixel routine otherwise), A is the value of
`GL_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
+ 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
K=8\u2062A\u2062⌈N\u2062L,/8\u2062A,,⌉
components or indices.
The word COMPONENT in this description refers to the nonindex
- values red, green, blue, alpha, and depth. Storage format
- `GL_RGB', for example, has three components per pixel: first red,
- then green, and finally blue.
+ values red, green, blue, alpha, and depth. Storage format `GL_RGB',
+ for example, has three components per pixel: first red, then green,
+ and finally blue.
`GL_UNPACK_IMAGE_HEIGHT'
If greater than 0, `GL_UNPACK_IMAGE_HEIGHT' defines the number of
- pixels in an image of a three-dimensional texture volume. Where
+ 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
+ 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
component (if A<S , then it is as if A=S ).
The word COMPONENT in this description refers to the nonindex
- values red, green, blue, alpha, and depth. Storage format
- `GL_RGB', for example, has three components per pixel: first red,
- then green, and finally blue.
+ values red, green, blue, alpha, and depth. Storage format `GL_RGB',
+ for example, has three components per pixel: first red, then green,
+ and finally blue.
`GL_UNPACK_SKIP_PIXELS' and `GL_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 `glDrawPixels', `glTexImage1D',
`glTexImage2D', `glTexSubImage1D', `glTexSubImage2D', `glBitmap',
- or `glPolygonStipple'. Setting `GL_UNPACK_SKIP_PIXELS' to I is
+ or `glPolygonStipple'. Setting `GL_UNPACK_SKIP_PIXELS' to I is
equivalent to incrementing the pointer by I\u2062N components or
indices, where N is the number of components or indices in each
- pixel. Setting `GL_UNPACK_SKIP_ROWS' to J is equivalent to
+ pixel. Setting `GL_UNPACK_SKIP_ROWS' to J is equivalent to
incrementing the pointer by J\u2062K components or indices, where K is
the number of components or indices per row, as just computed in
the `GL_UNPACK_ROW_LENGTH' section.
`GL_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).
+ 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).
The following table gives the type, initial value, and range of valid
values for each storage parameter that can be set with `glPixelStore'.
`GL_UNPACK_ALIGNMENT'
integer , 4 , 1, 2, 4, or 8
-`glPixelStoref' can be used to set any pixel store parameter. If the
+`glPixelStoref' can be used to set any pixel store parameter. If the
parameter type is boolean, then if PARAM is 0, the parameter is false;
-otherwise it is set to true. If PNAME is a integer type parameter,
-PARAM is rounded to the nearest integer.
+otherwise it is set to true. If PNAME is a integer type parameter, PARAM
+is rounded to the nearest integer.
Likewise, `glPixelStorei' can also be used to set any of the pixel store
-parameters. Boolean parameters are set to false if PARAM is 0 and true
+parameters. Boolean parameters are set to false if PARAM is 0 and true
otherwise.
`GL_INVALID_ENUM' is generated if PNAME is not an accepted value.
PNAME
Specifies the symbolic name of the pixel transfer parameter to be
- set. Must be one of the following: `GL_MAP_COLOR',
+ set. Must be one of the following: `GL_MAP_COLOR',
`GL_MAP_STENCIL', `GL_INDEX_SHIFT', `GL_INDEX_OFFSET',
`GL_RED_SCALE', `GL_RED_BIAS', `GL_GREEN_SCALE', `GL_GREEN_BIAS',
`GL_BLUE_SCALE', `GL_BLUE_BIAS', `GL_ALPHA_SCALE', `GL_ALPHA_BIAS',
`glCopyTexSubImage1D', `glCopyTexSubImage2D', `glCopyTexSubImage3D',
`glDrawPixels', `glReadPixels', `glTexImage1D', `glTexImage2D',
`glTexImage3D', `glTexSubImage1D', `glTexSubImage2D', and
-`glTexSubImage3D' commands. Additionally, if the `ARB_imaging' subset
-is supported, the routines `glColorTable', `glColorSubTable',
+`glTexSubImage3D' commands. Additionally, if the `ARB_imaging' subset is
+supported, the routines `glColorTable', `glColorSubTable',
`glConvolutionFilter1D', `glConvolutionFilter2D', `glHistogram',
-`glMinmax', and `glSeparableFilter2D' are also affected. The algorithms
+`glMinmax', and `glSeparableFilter2D' are also affected. The algorithms
that are specified by pixel transfer modes operate on pixels after they
are read from the frame buffer (`glCopyPixels'`glCopyTexImage1D',
`glCopyTexImage2D', `glCopyTexSubImage1D', `glCopyTexSubImage2D',
`glCopyTexSubImage3D', and `glReadPixels'), or unpacked from client
memory (`glDrawPixels', `glTexImage1D', `glTexImage2D', `glTexImage3D',
-`glTexSubImage1D', `glTexSubImage2D', and `glTexSubImage3D'). Pixel
+`glTexSubImage1D', `glTexSubImage2D', and `glTexSubImage3D'). Pixel
transfer operations happen in the same order, and in the same manner,
-regardless of the command that resulted in the pixel operation. Pixel
+regardless of the command that resulted in the pixel operation. Pixel
storage modes (see `glPixelStore') control the unpacking of pixels being
read from client memory and the packing of pixels being written back
into client memory.
Pixel transfer operations handle four fundamental pixel types: COLOR,
-COLOR INDEX, DEPTH, and STENCIL. COLOR pixels consist of four
+COLOR INDEX, DEPTH, and STENCIL. COLOR 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. COLOR INDICES comprise a single fixed-point value, with
-unspecified precision to the right of the binary point. DEPTH pixels
+intensity. COLOR INDICES comprise a single fixed-point value, with
+unspecified precision to the right of the binary point. DEPTH 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,
+value, and 1.0 represents the maximum depth buffer value. Finally,
STENCIL pixels comprise a single fixed-point value, with unspecified
precision to the right of the binary point.
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
+ then added to a bias factor. That is, the red component is
multiplied by `GL_RED_SCALE', then added to `GL_RED_BIAS'; the
green component is multiplied by `GL_GREEN_SCALE', then added to
`GL_GREEN_BIAS'; the blue component is multiplied by
`GL_BLUE_SCALE', then added to `GL_BLUE_BIAS'; and the alpha
component is multiplied by `GL_ALPHA_SCALE', then added to
- `GL_ALPHA_BIAS'. After all four color components are scaled and
- biased, each is clamped to the range [0,1] . All color, scale, and
+ `GL_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 `glPixelTransfer'.
If `GL_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
+ contents of that map indexed by the scaled component. That is, the
red component is scaled by `GL_PIXEL_MAP_R_TO_R_SIZE', then
replaced by the contents of `GL_PIXEL_MAP_R_TO_R' indexed by
- itself. The green component is scaled by
+ itself. The green component is scaled by
`GL_PIXEL_MAP_G_TO_G_SIZE', then replaced by the contents of
- `GL_PIXEL_MAP_G_TO_G' indexed by itself. The blue component is
+ `GL_PIXEL_MAP_G_TO_G' indexed by itself. The blue component is
scaled by `GL_PIXEL_MAP_B_TO_B_SIZE', then replaced by the contents
- of `GL_PIXEL_MAP_B_TO_B' indexed by itself. And the alpha
- component is scaled by `GL_PIXEL_MAP_A_TO_A_SIZE', then replaced by
- the contents of `GL_PIXEL_MAP_A_TO_A' indexed by itself. All
- components taken from the maps are then clamped to the range [0,1]
- . `GL_MAP_COLOR' is specified with `glPixelTransfer'. The
- contents of the various maps are specified with `glPixelMap'.
+ of `GL_PIXEL_MAP_B_TO_B' indexed by itself. And the alpha component
+ is scaled by `GL_PIXEL_MAP_A_TO_A_SIZE', then replaced by the
+ contents of `GL_PIXEL_MAP_A_TO_A' indexed by itself. All components
+ taken from the maps are then clamped to the range [0,1] .
+ `GL_MAP_COLOR' is specified with `glPixelTransfer'. The contents of
+ the various maps are specified with `glPixelMap'.
If the `ARB_imaging' extension is supported, each of the four color
components may be scaled and biased after transformation by the
- color matrix. That is, the red component is multiplied by
+ color matrix. That is, the red component is multiplied by
`GL_POST_COLOR_MATRIX_RED_SCALE', then added to
`GL_POST_COLOR_MATRIX_RED_BIAS'; the green component is multiplied
by `GL_POST_COLOR_MATRIX_GREEN_SCALE', then added to
by `GL_POST_COLOR_MATRIX_BLUE_SCALE', then added to
`GL_POST_COLOR_MATRIX_BLUE_BIAS'; and the alpha component is
multiplied by `GL_POST_COLOR_MATRIX_ALPHA_SCALE', then added to
- `GL_POST_COLOR_MATRIX_ALPHA_BIAS'. After all four color components
+ `GL_POST_COLOR_MATRIX_ALPHA_BIAS'. After all four color components
are scaled and biased, each is clamped to the range [0,1] .
Similarly, if the `ARB_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
+ the enabled convolution filter. That is, the red component is
multiplied by `GL_POST_CONVOLUTION_RED_SCALE', then added to
`GL_POST_CONVOLUTION_RED_BIAS'; the green component is multiplied
by `GL_POST_CONVOLUTION_GREEN_SCALE', then added to
by `GL_POST_CONVOLUTION_BLUE_SCALE', then added to
`GL_POST_CONVOLUTION_BLUE_BIAS'; and the alpha component is
multiplied by `GL_POST_CONVOLUTION_ALPHA_SCALE', then added to
- `GL_POST_CONVOLUTION_ALPHA_BIAS'. After all four color components
+ `GL_POST_CONVOLUTION_ALPHA_BIAS'. After all four color components
are scaled and biased, each is clamped to the range [0,1] .
COLOR INDEX
Each color index is shifted left by `GL_INDEX_SHIFT' bits; any bits
beyond the number of fraction bits carried by the fixed-point index
- are filled with zeros. If `GL_INDEX_SHIFT' is negative, the shift
- is to the right, again zero filled. Then `GL_INDEX_OFFSET' is
- added to the index. `GL_INDEX_SHIFT' and `GL_INDEX_OFFSET' are
- specified with `glPixelTransfer'.
+ are filled with zeros. If `GL_INDEX_SHIFT' is negative, the shift
+ is to the right, again zero filled. Then `GL_INDEX_OFFSET' is added
+ to the index. `GL_INDEX_SHIFT' and `GL_INDEX_OFFSET' are specified
+ with `glPixelTransfer'.
From this point, operation diverges depending on the required
- format of the resulting pixels. If the resulting pixels are to be
+ 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 `GL_COLOR_INDEX' format, the pixels continue to be
- treated as indices. If `GL_MAP_COLOR' is true, each index is
- masked by 2^N-1 , where N is `GL_PIXEL_MAP_I_TO_I_SIZE', then
- replaced by the contents of `GL_PIXEL_MAP_I_TO_I' indexed by the
- masked value. `GL_MAP_COLOR' is specified with `glPixelTransfer'.
- The contents of the index map is specified with `glPixelMap'.
+ treated as indices. If `GL_MAP_COLOR' is true, each index is masked
+ by 2^N-1 , where N is `GL_PIXEL_MAP_I_TO_I_SIZE', then replaced by
+ the contents of `GL_PIXEL_MAP_I_TO_I' indexed by the masked value.
+ `GL_MAP_COLOR' is specified with `glPixelTransfer'. The contents of
+ the index map is specified with `glPixelMap'.
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
`GL_COLOR_INDEX', the pixels are converted from indices to colors
by referencing the four maps `GL_PIXEL_MAP_I_TO_R',
`GL_PIXEL_MAP_I_TO_G', `GL_PIXEL_MAP_I_TO_B', and
- `GL_PIXEL_MAP_I_TO_A'. Before being dereferenced, the index is
+ `GL_PIXEL_MAP_I_TO_A'. Before being dereferenced, the index is
masked by 2^N-1 , where N is `GL_PIXEL_MAP_I_TO_R_SIZE' for the red
map, `GL_PIXEL_MAP_I_TO_G_SIZE' for the green map,
`GL_PIXEL_MAP_I_TO_B_SIZE' for the blue map, and
- `GL_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 `glPixelMap'.
+ `GL_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 `glPixelMap'.
DEPTH
Each depth value is multiplied by `GL_DEPTH_SCALE', added to
STENCIL
Each index is shifted `GL_INDEX_SHIFT' bits just as a color index
- is, then added to `GL_INDEX_OFFSET'. If `GL_MAP_STENCIL' is true,
+ is, then added to `GL_INDEX_OFFSET'. If `GL_MAP_STENCIL' is true,
each index is masked by 2^N-1 , where N is
`GL_PIXEL_MAP_S_TO_S_SIZE', then replaced by the contents of
`GL_PIXEL_MAP_S_TO_S' indexed by the masked value.
`GL_POST_CONVOLUTION_ALPHA_BIAS'
float , 0 , (-∞,∞)
-`glPixelTransferf' can be used to set any pixel transfer parameter. If
+`glPixelTransferf' 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 PNAME is an integer parameter, PARAM is rounded to the
+implies true. If PNAME is an integer parameter, PARAM is rounded to the
nearest integer.
Likewise, `glPixelTransferi' can be used to set any of the pixel
-transfer parameters. Boolean parameters are set to false if PARAM is 0
-and to true otherwise. PARAM is converted to floating point before
-being assigned to real-valued parameters.
+transfer parameters. Boolean parameters are set to false if PARAM is 0
+and to true otherwise. PARAM is converted to floating point before being
+assigned to real-valued parameters.
`GL_INVALID_ENUM' is generated if PNAME is not an accepted value.
Specify the X and Y zoom factors for pixel write operations.
-`glPixelZoom' specifies values for the X and Y zoom factors. During the
+`glPixelZoom' specifies values for the X and Y zoom factors. During the
execution of `glDrawPixels' or `glCopyPixels', 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
(XR+(N+1,)·XFACTOR , YR+(M+1,)·YFACTOR )
-are candidates for replacement. Any pixel whose center lies on the
+are candidates for replacement. Any pixel whose center lies on the
bottom or left edge of this rectangular region is also modified.
-Pixel zoom factors are not limited to positive values. Negative zoom
+Pixel zoom factors are not limited to positive values. Negative zoom
factors reflect the resulting image about the current raster position.
`GL_INVALID_OPERATION' is generated if `glPixelZoom' is executed between
"Specify point parameters.
PNAME
- Specifies a single-valued point parameter. `GL_POINT_SIZE_MIN',
+ Specifies a single-valued point parameter. `GL_POINT_SIZE_MIN',
`GL_POINT_SIZE_MAX', `GL_POINT_FADE_THRESHOLD_SIZE', and
`GL_POINT_SPRITE_COORD_ORIGIN' are accepted.
PARAMS is a single floating-point value that specifies the minimum
- point size. The default value is 0.0.
+ point size. The default value is 0.0.
`GL_POINT_SIZE_MAX'
PARAMS is a single floating-point value that specifies the maximum
- point size. The default value is 1.0.
+ point size. The default value is 1.0.
`GL_POINT_FADE_THRESHOLD_SIZE'
PARAMS is a single floating-point value that specifies the
threshold value to which point sizes are clamped if they exceed the
- specified value. The default value is 1.0.
+ specified value. The default value is 1.0.
`GL_POINT_DISTANCE_ATTENUATION'
PARAMS is an array of three floating-point values that specify the
- coefficients used for scaling the computed point size. The default
+ coefficients used for scaling the computed point size. The default
values are (1,00) .
`GL_POINT_SPRITE_COORD_ORIGIN'
PARAMS is a single enum specifying the point sprite texture
- coordinate origin, either `GL_LOWER_LEFT' or `GL_UPPER_LEFT'. The
+ coordinate origin, either `GL_LOWER_LEFT' or `GL_UPPER_LEFT'. The
default value is `GL_UPPER_LEFT'.
`GL_INVALID_VALUE' is generated If the value specified for
"Specify the diameter of rasterized points.
SIZE
- Specifies the diameter of rasterized points. The initial value is
+ Specifies the diameter of rasterized points. The initial value is
1.
`glPointSize' 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
+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 `glEnable' and `glDisable' with
-argument `GL_POINT_SMOOTH'. Point antialiasing is initially disabled.
+argument `GL_POINT_SMOOTH'. Point antialiasing is initially disabled.
The specified point size is multiplied with a distance attenuation
factor and clamped to the specified point size range, and further
If multisampling is enabled, the point may be faded by modifying the
point alpha value (see `glSampleCoverage') instead of allowing the point
-width to go below a given threshold (see `glPointParameter'). In this
+width to go below a given threshold (see `glPointParameter'). In this
case, the width is further modified in the following manner:
POINTWIDTH={(POINTSIZE), (THRESHOLD)\u2062(POINTSIZE>=THRESHOLD),
(OTHERWISE),
If point antialiasing is disabled, the actual size is determined by
-rounding the supplied size to the nearest integer. (If the rounding
+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
(⌊X_W,⌋+.5,⌊Y_W,⌋+.5)
-where W subscripts indicate window coordinates. All pixels that lie
+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
+the fragment. If the size is even, the center point is
(⌊X_W+.5,⌋,⌊Y_W+.5,⌋)
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_W,Y_W) . The coverage value for each fragment is the window
+point's (X_W,Y_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
+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.
-Not all sizes are supported when point antialiasing is enabled. If an
-unsupported size is requested, the nearest supported size is used. Only
+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
+implementation. To query the range of supported sizes and the size
difference between supported sizes within the range, call `glGet' with
arguments `GL_SMOOTH_POINT_SIZE_RANGE' and
-`GL_SMOOTH_POINT_SIZE_GRANULARITY'. For aliased points, query the
+`GL_SMOOTH_POINT_SIZE_GRANULARITY'. For aliased points, query the
supported ranges and granularity with `glGet' with arguments
`GL_ALIASED_POINT_SIZE_RANGE'.
"Select a polygon rasterization mode.
FACE
- Specifies the polygons that MODE applies to. Must be `GL_FRONT'
- for front-facing polygons, `GL_BACK' for back-facing polygons, or
+ Specifies the polygons that MODE applies to. Must be `GL_FRONT' for
+ front-facing polygons, `GL_BACK' for back-facing polygons, or
`GL_FRONT_AND_BACK' for front- and back-facing polygons.
MODE
- Specifies how polygons will be rasterized. Accepted values are
- `GL_POINT', `GL_LINE', and `GL_FILL'. The initial value is
+ Specifies how polygons will be rasterized. Accepted values are
+ `GL_POINT', `GL_LINE', and `GL_FILL'. The initial value is
`GL_FILL' for both front- and back-facing polygons.
`glPolygonMode' controls the interpretation of polygons for
-rasterization. FACE describes which polygons MODE applies to:
+rasterization. FACE describes which polygons MODE applies to:
front-facing polygons (`GL_FRONT'), back-facing polygons (`GL_BACK'), or
-both (`GL_FRONT_AND_BACK'). The polygon mode affects only the final
-rasterization of polygons. In particular, a polygon's vertices are lit
+both (`GL_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.
`GL_POINT'
Polygon vertices that are marked as the start of a boundary edge
- are drawn as points. Point attributes such as `GL_POINT_SIZE' and
- `GL_POINT_SMOOTH' control the rasterization of the points. Polygon
+ are drawn as points. Point attributes such as `GL_POINT_SIZE' and
+ `GL_POINT_SMOOTH' control the rasterization of the points. Polygon
rasterization attributes other than `GL_POLYGON_MODE' have no
effect.
`GL_LINE'
- Boundary edges of the polygon are drawn as line segments. They are
+ 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
- `glLineStipple'). Line attributes such as `GL_LINE_WIDTH' and
- `GL_LINE_SMOOTH' control the rasterization of the lines. Polygon
+ `glLineStipple'). Line attributes such as `GL_LINE_WIDTH' and
+ `GL_LINE_SMOOTH' control the rasterization of the lines. Polygon
rasterization attributes other than `GL_POLYGON_MODE' have no
effect.
`GL_FILL'
- The interior of the polygon is filled. Polygon attributes such as
+ The interior of the polygon is filled. Polygon attributes such as
`GL_POLYGON_STIPPLE' and `GL_POLYGON_SMOOTH' control the
rasterization of the polygon.
FACTOR
Specifies a scale factor that is used to create a variable depth
- offset for each polygon. The initial value is 0.
+ offset for each polygon. The initial value is 0.
UNITS
Is multiplied by an implementation-specific value to create a
- constant depth offset. The initial value is 0.
+ constant depth offset. The initial value is 0.
When `GL_POLYGON_OFFSET_FILL', `GL_POLYGON_OFFSET_LINE', or
`GL_POLYGON_OFFSET_POINT' is enabled, each fragment's DEPTH value will
be offset after it is interpolated from the DEPTH values of the
-appropriate vertices. The value of the offset is FACTOR×DZ+R×UNITS ,
+appropriate vertices. The value of the offset is FACTOR×DZ+R×UNITS ,
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
+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.
PATTERN is a pointer to a 32×32 stipple pattern that is stored in memory
just like the pixel data supplied to a `glDrawPixels' call with height
and WIDTH both equal to 32, a pixel format of `GL_COLOR_INDEX', and data
-type of `GL_BITMAP'. That is, the stipple pattern is represented as a
+type of `GL_BITMAP'. That is, the stipple pattern is represented as a
32×32 array of 1-bit color indices packed in unsigned bytes.
`glPixelStore' parameters like `GL_UNPACK_SWAP_BYTES' and
`GL_UNPACK_LSB_FIRST' affect the assembling of the bits into a stipple
-pattern. Pixel transfer operations (shift, offset, pixel map) are not
+pattern. Pixel transfer operations (shift, offset, pixel map) are not
applied to the stipple image, however.
If a non-zero named buffer object is bound to the
buffer object's data store.
To enable and disable polygon stippling, call `glEnable' and `glDisable'
-with argument `GL_POLYGON_STIPPLE'. Polygon stippling is initially
-disabled. If it's enabled, a rasterized polygon fragment with window
+with argument `GL_POLYGON_STIPPLE'. Polygon stippling is initially
+disabled. If it's enabled, a rasterized polygon fragment with window
coordinates X_W and Y_W is sent to the next stage of the GL if and only
if the (X_W%32 )th bit in the (Y_W%32 )th row of the stipple pattern is
-1 (one). When polygon stippling is disabled, it is as if the stipple
+1 (one). When polygon stippling is disabled, it is as if the stipple
pattern consists of all 1's.
`GL_INVALID_OPERATION' is generated if a non-zero buffer object name is
prioritized.
PRIORITIES
- Specifies an array containing the texture priorities. A priority
+ 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.
PRIORITIES to the N textures named in TEXTURES.
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
+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, `glPrioritizeTextures' allows applications to
guide the GL implementation in determining which textures should be
resident.
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
+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.
or any texture name that does not correspond to an existing texture.
`glPrioritizeTextures' does not require that any of the textures named
-by TEXTURES be bound to a texture target. `glTexParameter' may also be
+by TEXTURES be bound to a texture target. `glTexParameter' 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.
+bound. This is the only way to set the priority of a default texture.
`GL_INVALID_VALUE' is generated if N is negative.
"Push and pop the server attribute stack.
MASK
- Specifies a mask that indicates which attributes to save. Values
+ Specifies a mask that indicates which attributes to save. Values
for MASK are listed below.
`glPushAttrib' 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. MASK is typically constructed by
-specifying the bitwise-or of several of these constants together. The
+state variables to save on the attribute stack. Symbolic constants are
+used to set bits in the mask. MASK is typically constructed by
+specifying the bitwise-or of several of these constants together. The
special mask `GL_ALL_ATTRIB_BITS' can be used to save all stackable
states.
Viewport origin and extent
`glPopAttrib' restores the values of the state variables saved with the
-last `glPushAttrib' command. Those not saved are left unchanged.
+last `glPushAttrib' command. Those not saved are left unchanged.
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
+off an empty stack. In either case, the error flag is set and no other
change is made to GL state.
Initially, the attribute stack is empty.
"Push and pop the client attribute stack.
MASK
- Specifies a mask that indicates which attributes to save. Values
+ Specifies a mask that indicates which attributes to save. Values
for MASK are listed below.
`glPushClientAttrib' 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. MASK is typically
+Symbolic constants are used to set bits in the mask. MASK is typically
constructed by specifying the bitwise-or of several of these constants
-together. The special mask `GL_CLIENT_ALL_ATTRIB_BITS' can be used to
+together. The special mask `GL_CLIENT_ALL_ATTRIB_BITS' can be used to
save all stackable client state.
The symbolic mask constants and their associated GL client state are as
`GL_CLIENT_VERTEX_ARRAY_BIT' Vertex arrays (and enables)
`glPopClientAttrib' restores the values of the client-state variables
-saved with the last `glPushClientAttrib'. Those not saved are left
+saved with the last `glPushClientAttrib'. Those not saved are left
unchanged.
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
+to pop attributes off an empty stack. In either case, the error flag is
set, and no other change is made to GL state.
Initially, the client attribute stack is empty.
((glPushMatrix -> void) (glPopMatrix -> void))
"Push and pop the current matrix stack.
-There is a stack of matrices for each of the matrix modes. In
-`GL_MODELVIEW' mode, the stack depth is at least 32. In the other
-modes, `GL_COLOR', `GL_PROJECTION', and `GL_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.
+There is a stack of matrices for each of the matrix modes. In
+`GL_MODELVIEW' mode, the stack depth is at least 32. In the other modes,
+`GL_COLOR', `GL_PROJECTION', and `GL_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.
`glPushMatrix' pushes the current matrix stack down by one, duplicating
-the current matrix. That is, after a `glPushMatrix' call, the matrix on
+the current matrix. That is, after a `glPushMatrix' call, the matrix on
top of the stack is identical to the one below it.
`glPopMatrix' pops the current matrix stack, replacing the current
Initially, each of the stacks contains one matrix, an identity matrix.
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.
+contains only a single matrix. In either case, the error flag is set and
+no other change is made to GL state.
`GL_STACK_OVERFLOW' is generated if `glPushMatrix' is called while the
current matrix stack is full.
Specifies a name that will be pushed onto the name stack.
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
+commands to be uniquely identified. It consists of an ordered set of
unsigned integers and is initially empty.
-`glPushName' causes NAME to be pushed onto the name stack. `glPopName'
+`glPushName' causes NAME to be pushed onto the name stack. `glPopName'
pops one name off the top of the stack.
The maximum name stack depth is implementation-dependent; call
`GL_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
+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 `glBegin' and the corresponding
-execution of `glEnd'. In any of these cases, the error flag is set and
+execution of `glEnd'. In any of these cases, the error flag is set and
no other change is made to GL state.
The name stack is always empty while the render mode is not `GL_SELECT'.
Specify the X , Y , Z , and W object coordinates (if present) for
the raster position.
-The GL maintains a 3D position in window coordinates. This position,
+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 `glBitmap',
+operations. It is maintained with subpixel accuracy. See `glBitmap',
`glDrawPixels', and `glCopyPixels'.
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. `glRasterPos4' specifies object coordinates X , Y , Z ,
-and W explicitly. `glRasterPos3' specifies object coordinate X , Y ,
-and Z explicitly, while W is implicitly set to 1. `glRasterPos2' uses
-the argument values for X and Y while implicitly setting Z and W to 0
-and 1.
+bit, and associated color data and texture coordinates. The W coordinate
+is a clip coordinate, because W is not projected to window coordinates.
+`glRasterPos4' specifies object coordinates X , Y , Z , and W
+explicitly. `glRasterPos3' specifies object coordinate X , Y , and Z
+explicitly, while W is implicitly set to 1. `glRasterPos2' uses the
+argument values for X and Y while implicitly setting Z and W to 0 and 1.
The object coordinates presented by `glRasterPos' are treated just like
those of a `glVertex' command: They are transformed by the current
-modelview and projection matrices and passed to the clipping stage. If
+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
-`GL_CURRENT_RASTER_POSITION_VALID' flag is set. If the vertex IS
-culled, then the valid bit is cleared and the current raster position
-and associated color and texture coordinates are undefined.
+`GL_CURRENT_RASTER_POSITION_VALID' flag is set. If the vertex IS culled,
+then the valid bit is cleared and the current raster position and
+associated color and texture coordinates are undefined.
The current raster position also includes some associated color data and
-texture coordinates. If lighting is enabled, then
+texture coordinates. If lighting is enabled, then
`GL_CURRENT_RASTER_COLOR' (in RGBA mode) or `GL_CURRENT_RASTER_INDEX'
(in color index mode) is set to the color produced by the lighting
-calculation (see `glLight', `glLightModel', and `glShadeModel'). If
+calculation (see `glLight', `glLightModel', and `glShadeModel'). If
lighting is disabled, current color (in RGBA mode, state variable
`GL_CURRENT_COLOR') or color index (in color index mode, state variable
`GL_CURRENT_INDEX') is used to update the current raster color.
Likewise, `GL_CURRENT_RASTER_TEXTURE_COORDS' is updated as a function of
`GL_CURRENT_TEXTURE_COORDS', based on the texture matrix and the texture
-generation functions (see `glTexGen'). Finally, the distance from the
+generation functions (see `glTexGen'). Finally, the distance from the
origin of the eye coordinate system to the vertex as transformed by only
the modelview matrix replaces `GL_CURRENT_RASTER_DISTANCE'.
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,
+texture coordinates are (0, 0, 0, 1). In RGBA mode,
`GL_CURRENT_RASTER_INDEX' is always 1; in color index mode, the current
raster RGBA color always maintains its initial value.
"Select a color buffer source for pixels.
MODE
- Specifies a color buffer. Accepted values are `GL_FRONT_LEFT',
+ Specifies a color buffer. Accepted values are `GL_FRONT_LEFT',
`GL_FRONT_RIGHT', `GL_BACK_LEFT', `GL_BACK_RIGHT', `GL_FRONT',
`GL_BACK', `GL_LEFT', `GL_RIGHT', and `GL_AUX'I, where I is between
0 and the value of `GL_AUX_BUFFERS' minus 1.
`glReadBuffer' specifies a color buffer as the source for subsequent
`glReadPixels', `glCopyTexImage1D', `glCopyTexImage2D',
`glCopyTexSubImage1D', `glCopyTexSubImage2D', `glCopyTexSubImage3D', and
-`glCopyPixels' commands. MODE accepts one of twelve or more predefined
-values. (`GL_AUX0' through `GL_AUX3' are always defined.) In a fully
+`glCopyPixels' commands. MODE accepts one of twelve or more predefined
+values. (`GL_AUX0' through `GL_AUX3' are always defined.) In a fully
configured system, `GL_FRONT', `GL_LEFT', and `GL_FRONT_LEFT' all name
the front left buffer, `GL_FRONT_RIGHT' and `GL_RIGHT' name the front
right buffer, and `GL_BACK_LEFT' and `GL_BACK' name the back left
buffer.
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
-`glReadBuffer'.
+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 `glReadBuffer'.
MODE is initially `GL_FRONT' in single-buffered configurations and
`GL_BACK' in double-buffered configurations.
Y
Specify the window coordinates of the first pixel that is read from
- the frame buffer. This location is the lower left corner of a
+ the frame buffer. This location is the lower left corner of a
rectangular block of pixels.
WIDTH
HEIGHT
- Specify the dimensions of the pixel rectangle. WIDTH and HEIGHT of
+ Specify the dimensions of the pixel rectangle. WIDTH and HEIGHT of
one correspond to a single pixel.
FORMAT
- Specifies the format of the pixel data. The following symbolic
+ Specifies the format of the pixel data. The following symbolic
values are accepted: `GL_COLOR_INDEX', `GL_STENCIL_INDEX',
`GL_DEPTH_COMPONENT', `GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA',
`GL_RGB', `GL_BGR', `GL_RGBA', `GL_BGRA', `GL_LUMINANCE', and
`GL_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type of the pixel data. Must be one of
+ Specifies the data type of the pixel data. Must be one of
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
`glReadPixels' returns pixel data from the frame buffer, starting with
the pixel whose lower left corner is at location (X, Y), into client
-memory starting at location DATA. Several parameters control the
+memory starting at location DATA. Several parameters control the
processing of the pixel data before it is placed into client memory.
These parameters are set with three commands: `glPixelStore',
-`glPixelTransfer', and `glPixelMap'. This reference page describes the
+`glPixelTransfer', and `glPixelMap'. This reference page describes the
effects on `glReadPixels' of most, but not all of the parameters
specified by these three commands.
maximum pixel value computations.
`glReadPixels' returns values from each pixel with lower left corner at
-(X+I,Y+J) for 0<=I<WIDTH and 0<=J<HEIGHT . This pixel is said to be the
-I th pixel in the J th row. Pixels are returned in row order from the
+(X+I,Y+J) for 0<=I<WIDTH and 0<=J<HEIGHT . 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.
FORMAT specifies the format for the returned pixel values; accepted
`GL_COLOR_INDEX'
Color indices are read from the color buffer selected by
- `glReadBuffer'. Each index is converted to fixed point, shifted
+ `glReadBuffer'. Each index is converted to fixed point, shifted
left or right depending on the value and sign of `GL_INDEX_SHIFT',
- and added to `GL_INDEX_OFFSET'. If `GL_MAP_COLOR' is `GL_TRUE',
+ and added to `GL_INDEX_OFFSET'. If `GL_MAP_COLOR' is `GL_TRUE',
indices are replaced by their mappings in the table
`GL_PIXEL_MAP_I_TO_I'.
`GL_STENCIL_INDEX'
- Stencil values are read from the stencil buffer. Each index is
+ 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 `GL_INDEX_SHIFT', and added to `GL_INDEX_OFFSET'.
If `GL_MAP_STENCIL' is `GL_TRUE', indices are replaced by their
mappings in the table `GL_PIXEL_MAP_S_TO_S'.
`GL_DEPTH_COMPONENT'
- Depth values are read from the depth buffer. Each component is
+ 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
+ to 0 and the maximum value maps to 1. Each component is then
multiplied by `GL_DEPTH_SCALE', added to `GL_DEPTH_BIAS', and
finally clamped to the range [0,1] .
`GL_LUMINANCE'
`GL_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 `glReadBuffer'.
- Each index is converted to fixed point, shifted left or right
- depending on the value and sign of `GL_INDEX_SHIFT', and added to
- `GL_INDEX_OFFSET'. Indices are then replaced by the red, green,
+ indices or RGBA color components. If color indices are stored, they
+ are read from the color buffer selected by `glReadBuffer'. Each
+ index is converted to fixed point, shifted left or right depending
+ on the value and sign of `GL_INDEX_SHIFT', and added to
+ `GL_INDEX_OFFSET'. Indices are then replaced by the red, green,
blue, and alpha values obtained by indexing the tables
`GL_PIXEL_MAP_I_TO_R', `GL_PIXEL_MAP_I_TO_G',
- `GL_PIXEL_MAP_I_TO_B', and `GL_PIXEL_MAP_I_TO_A'. Each table must
+ `GL_PIXEL_MAP_I_TO_B', and `GL_PIXEL_MAP_I_TO_A'. Each table must
be of size 2^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^N ,
it must be masked against 2^N-1 .
If RGBA color components are stored in the color buffers, they are
- read from the color buffer selected by `glReadBuffer'. Each color
+ read from the color buffer selected by `glReadBuffer'. 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
+ maps to 0.0 and full intensity maps to 1.0. Each component is then
multiplied by `GL_c_SCALE' and added to `GL_c_BIAS', where C is
- RED, GREEN, BLUE, or ALPHA. Finally, if `GL_MAP_COLOR' is
+ RED, GREEN, BLUE, or ALPHA. Finally, if `GL_MAP_COLOR' is
`GL_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 `GL_PIXEL_MAP_c_TO_c', where C is R, G, B, or
A.
- Unneeded data is then discarded. For example, `GL_RED' discards
- the green, blue, and alpha components, while `GL_RGB' discards only
- the alpha component. `GL_LUMINANCE' computes a single-component
- value as the sum of the red, green, and blue components, and
+ Unneeded data is then discarded. For example, `GL_RED' discards the
+ green, blue, and alpha components, while `GL_RGB' discards only the
+ alpha component. `GL_LUMINANCE' computes a single-component value
+ as the sum of the red, green, and blue components, and
`GL_LUMINANCE_ALPHA' does the same, while keeping alpha as a second
- value. The final values are clamped to the range [0,1] .
+ value. The final values are clamped to the range [0,1] .
The shift, scale, bias, and lookup factors just described are all
-specified by `glPixelTransfer'. The lookup table contents themselves
-are specified by `glPixelMap'.
+specified by `glPixelTransfer'. The lookup table contents themselves are
+specified by `glPixelMap'.
Finally, the indices or components are converted to the proper format,
-as specified by TYPE. If FORMAT is `GL_COLOR_INDEX' or
+as specified by TYPE. If FORMAT is `GL_COLOR_INDEX' or
`GL_STENCIL_INDEX' and TYPE is not `GL_FLOAT', each index is masked with
-the mask value given in the following table. If TYPE is `GL_FLOAT',
-then each integer index is converted to single-precision floating-point
+the mask value given in the following table. If TYPE is `GL_FLOAT', then
+each integer index is converted to single-precision floating-point
format.
If FORMAT is `GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA', `GL_RGB',
`GL_BGR', `GL_RGBA', `GL_BGRA', `GL_LUMINANCE', or `GL_LUMINANCE_ALPHA'
and TYPE is not `GL_FLOAT', each component is multiplied by the
-multiplier shown in the following table. If type is `GL_FLOAT', then
+multiplier shown in the following table. If type is `GL_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).
`GL_FLOAT'
none , C
-Return values are placed in memory as follows. If FORMAT is
+Return values are placed in memory as follows. If FORMAT is
`GL_COLOR_INDEX', `GL_STENCIL_INDEX', `GL_DEPTH_COMPONENT', `GL_RED',
`GL_GREEN', `GL_BLUE', `GL_ALPHA', or `GL_LUMINANCE', a single value is
returned and the data for the I th pixel in the J th row is placed in
-location (J,)\u2062WIDTH+I . `GL_RGB' and `GL_BGR' return three values,
+location (J,)\u2062WIDTH+I . `GL_RGB' and `GL_BGR' return three values,
`GL_RGBA' and `GL_BGRA' return four values, and `GL_LUMINANCE_ALPHA'
returns two values for each pixel, with all values corresponding to a
-single pixel occupying contiguous space in DATA. Storage parameters set
+single pixel occupying contiguous space in DATA. Storage parameters set
by `glPixelStore', such as `GL_PACK_LSB_FIRST' and `GL_PACK_SWAP_BYTES',
-affect the way that data is written into memory. See `glPixelStore' for
+affect the way that data is written into memory. See `glPixelStore' for
a description.
`GL_INVALID_ENUM' is generated if FORMAT or TYPE is not an accepted
Specify the opposite vertex of the rectangle.
`glRect' supports efficient specification of rectangles as two corner
-points. Each rectangle command takes four arguments, organized either
-as two consecutive pairs of (X,Y) coordinates or as two pointers to
-arrays, each containing an (X,Y) pair. The resulting rectangle is
-defined in the Z=0 plane.
+points. Each rectangle command takes four arguments, organized either as
+two consecutive pairs of (X,Y) coordinates or as two pointers to arrays,
+each containing an (X,Y) pair. The resulting rectangle is defined in the
+Z=0 plane.
`glRect'(X1, Y1, X2, Y2) is exactly equivalent to the following
sequence: Note that if the second vertex is above and to the right of
"Set rasterization mode.
MODE
- Specifies the rasterization mode. Three values are accepted:
- `GL_RENDER', `GL_SELECT', and `GL_FEEDBACK'. The initial value is
+ Specifies the rasterization mode. Three values are accepted:
+ `GL_RENDER', `GL_SELECT', and `GL_FEEDBACK'. The initial value is
`GL_RENDER'.
-`glRenderMode' sets the rasterization mode. It takes one argument,
-MODE, which can assume one of three predefined values:
+`glRenderMode' sets the rasterization mode. It takes one argument, MODE,
+which can assume one of three predefined values:
`GL_RENDER'
- Render mode. Primitives are rasterized, producing pixel fragments,
- which are written into the frame buffer. This is the normal mode
+ 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.
`GL_SELECT'
- Selection mode. No pixel fragments are produced, and no change to
- the frame buffer contents is made. Instead, a record of the names
+ 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 `GL_RENDER' is returned in a select buffer, which must be
created (see `glSelectBuffer') before selection mode is entered.
`GL_FEEDBACK'
- Feedback mode. No pixel fragments are produced, and no change to
- the frame buffer contents is made. Instead, the coordinates and
+ 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 `GL_RENDER' is returned in a feedback buffer, which
must be created (see `glFeedbackBuffer') before feedback mode is
entered.
The return value of `glRenderMode' is determined by the render mode at
-the time `glRenderMode' is called, rather than by MODE. The values
+the time `glRenderMode' is called, rather than by MODE. The values
returned for the three render modes are as follows:
`GL_RENDER'
If the matrix mode is either `GL_MODELVIEW' or `GL_PROJECTION', all
-objects drawn after `glRotate' is called are rotated. Use
-`glPushMatrix' and `glPopMatrix' to save and restore the unrotated
-coordinate system.
+objects drawn after `glRotate' is called are rotated. Use `glPushMatrix'
+and `glPopMatrix' to save and restore the unrotated coordinate system.
`GL_INVALID_OPERATION' is generated if `glRotate' is executed between
the execution of `glBegin' and the corresponding execution of `glEnd'.")
"Specify multisample coverage parameters.
VALUE
- Specify a single floating-point sample coverage value. The value
- is clamped to the range [0,1] . The initial value is 1.0.
+ Specify a single floating-point sample coverage value. The value is
+ clamped to the range [0,1] . The initial value is 1.0.
INVERT
Specify a single boolean value representing if the coverage masks
- should be inverted. `GL_TRUE' and `GL_FALSE' are accepted. The
+ should be inverted. `GL_TRUE' and `GL_FALSE' are accepted. The
initial value is `GL_FALSE'.
Multisampling samples a pixel multiple times at various
implementation-dependent subpixel locations to generate antialiasing
-effects. Multisampling transparently antialiases points, lines,
+effects. Multisampling transparently antialiases points, lines,
polygons, bitmaps, and images if it is enabled.
VALUE is used in constructing a temporary mask used in determining which
-samples will be used in resolving the final fragment color. This mask
-is bitwise-anded with the coverage mask generated from the multisampling
-computation. If the INVERT flag is set, the temporary mask is inverted
+samples will be used in resolving the final fragment color. This mask is
+bitwise-anded with the coverage mask generated from the multisampling
+computation. If the INVERT flag is set, the temporary mask is inverted
(all bits flipped) and then the bitwise-and is computed.
If an implementation does not have any multisample buffers available, or
Provided an implementation supports multisample buffers, and
multisampling is enabled, then a pixel's final color is generated by
-combining several samples per pixel. Each sample contains color, depth,
+combining several samples per pixel. Each sample contains color, depth,
and stencil information, allowing those operations to be performed on
each sample.
Specify scale factors along the X, Y, and Z axes, respectively.
-`glScale' produces a nonuniform scaling along the X, Y, and Z axes. The
+`glScale' produces a nonuniform scaling along the X, Y, and Z axes. The
three parameters indicate the desired scale factor along each of the
three axes.
X
Y
- Specify the lower left corner of the scissor box. Initially (0,
- 0).
+ Specify the lower left corner of the scissor box. Initially (0, 0).
WIDTH
HEIGHT
- Specify the width and height of the scissor box. When a GL context
+ Specify the width and height of the scissor box. When a GL context
is first attached to a window, WIDTH and HEIGHT are set to the
dimensions of that window.
`glScissor' defines a rectangle, called the scissor box, in window
-coordinates. The first two arguments, X and Y, specify the lower left
-corner of the box. WIDTH and HEIGHT specify the width and height of the
+coordinates. The first two arguments, X and Y, specify the lower left
+corner of the box. WIDTH and HEIGHT specify the width and height of the
box.
To enable and disable the scissor test, call `glEnable' and `glDisable'
-with argument `GL_SCISSOR_TEST'. The test is initially disabled. While
+with argument `GL_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. `glScissor(0,0,1,1)' allows
+modified by drawing commands. Window coordinates have integer values at
+the shared corners of frame buffer pixels. `glScissor(0,0,1,1)' allows
modification of only the lower left pixel in the window, and
`glScissor(0,0,0,0)' doesn't allow modification of any pixels in the
window.
"Define an array of secondary colors.
SIZE
- Specifies the number of components per color. Must be 3.
+ Specifies the number of components per color. Must be 3.
TYPE
Specifies the data type of each color component in the array.
Symbolic constants `GL_BYTE', `GL_UNSIGNED_BYTE', `GL_SHORT',
`GL_UNSIGNED_SHORT', `GL_INT', `GL_UNSIGNED_INT', `GL_FLOAT', or
- `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
+ `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
STRIDE
- Specifies the byte offset between consecutive colors. If STRIDE is
- 0, the colors are understood to be tightly packed in the array. The
+ Specifies the byte offset between consecutive colors. If STRIDE is
+ 0, the colors are understood to be tightly packed in the array. The
initial value is 0.
POINTER
Specifies a pointer to the first component of the first color
- element in the array. The initial value is 0.
+ element in the array. The initial value is 0.
`glSecondaryColorPointer' specifies the location and data format of an
-array of color components to use when rendering. SIZE specifies the
-number of components per color, and must be 3. TYPE specifies the data
+array of color components to use when rendering. SIZE specifies the
+number of components per color, and must be 3. TYPE specifies the data
type of each color component, and STRIDE 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.
To enable and disable the secondary color array, call
`glEnableClientState' and `glDisableClientState' with the argument
-`GL_SECONDARY_COLOR_ARRAY'. If enabled, the secondary color array is
+`GL_SECONDARY_COLOR_ARRAY'. If enabled, the secondary color array is
used when `glArrayElement', `glDrawArrays', `glMultiDrawArrays',
`glDrawElements', `glMultiDrawElements', or `glDrawRangeElements' is
called.
associated with every vertex.
The secondary color is interpolated and applied to each fragment during
-rasterization when `GL_COLOR_SUM' is enabled. When lighting is enabled,
+rasterization when `GL_COLOR_SUM' is enabled. When lighting is enabled,
and `GL_SEPARATE_SPECULAR_COLOR' is specified, the value of the
secondary color is assigned the value computed from the specular term of
-the lighting computation. Both the primary and secondary current colors
+the lighting computation. Both the primary and secondary current colors
are applied to each fragment, regardless of the state of `GL_COLOR_SUM',
-under such conditions. When `GL_SEPARATE_SPECULAR_COLOR' is specified,
+under such conditions. When `GL_SEPARATE_SPECULAR_COLOR' is specified,
the value returned from querying the current secondary color is
undefined.
`glSecondaryColor3b', `glSecondaryColor3s', and `glSecondaryColor3i'
-take three signed byte, short, or long integers as arguments. When *v*
+take three signed byte, short, or long integers as arguments. When *v*
is appended to the name, the color commands can take a pointer to an
array of such values.
Color values are stored in floating-point format, with unspecified
-mantissa and exponent sizes. Unsigned integer color components, when
+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,
+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.
+value maps to -1.0 . (Note that this mapping does not convert 0
+precisely to 0.0). Floating-point values are mapped directly.
Neither floating-point nor signed integer values are clamped to the
-range [0,1] before the current color is updated. However, color
+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.")
Returns the selection data.
`glSelectBuffer' has two arguments: BUFFER is a pointer to an array of
-unsigned integers, and SIZE indicates the size of the array. BUFFER
+unsigned integers, and SIZE indicates the size of the array. BUFFER
returns values from the name stack (see `glInitNames', `glLoadName',
`glPushName') when the rendering mode is `GL_SELECT' (see
-`glRenderMode'). `glSelectBuffer' must be issued before selection mode
+`glRenderMode'). `glSelectBuffer' must be issued before selection mode
is enabled, and it must not be issued while the rendering mode is
`GL_SELECT'.
A programmer can use selection to determine which primitives are drawn
-into some region of a window. The region is defined by the current
+into some region of a window. The region is defined by the current
modelview and perspective matrices.
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
+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 `glRenderMode' is called, a hit record is copied to
BUFFER if any hits have occurred since the last such event (name stack
-change or `glRenderMode' call). The hit record consists of the number
-of names in the name stack at the time of the event, followed by the
+change or `glRenderMode' 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.
before being placed in the hit record.
An internal index into BUFFER is reset to 0 whenever selection mode is
-entered. Each time a hit record is copied into BUFFER, the index is
+entered. Each time a hit record is copied into BUFFER, the index is
incremented to point to the cell just past the end of the block of
names\\(emthat is, to the next available cell If the hit record is larger
than the number of remaining locations in BUFFER, as much data as can
-fit is copied, and the overflow flag is set. If the name stack is empty
+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.
To exit selection mode, call `glRenderMode' with an argument other than
-`GL_SELECT'. Whenever `glRenderMode' is called while the render mode is
+`GL_SELECT'. Whenever `glRenderMode' is called while the render mode is
`GL_SELECT', it returns the number of hit records copied to BUFFER,
resets the overflow flag and the selection buffer pointer, and
-initializes the name stack to be empty. If the overflow bit was set
-when `glRenderMode' was called, a negative hit record count is returned.
+initializes the name stack to be empty. If the overflow bit was set when
+`glRenderMode' was called, a negative hit record count is returned.
`GL_INVALID_VALUE' is generated if SIZE is negative.
Must be `GL_SEPARABLE_2D'.
INTERNALFORMAT
- The internal format of the convolution filter kernel. The
- allowable values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8',
- `GL_ALPHA12', `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4',
- `GL_LUMINANCE8', `GL_LUMINANCE12', `GL_LUMINANCE16',
- `GL_LUMINANCE_ALPHA', `GL_LUMINANCE4_ALPHA4',
- `GL_LUMINANCE6_ALPHA2', `GL_LUMINANCE8_ALPHA8',
- `GL_LUMINANCE12_ALPHA4', `GL_LUMINANCE12_ALPHA12',
- `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY', `GL_INTENSITY4',
- `GL_INTENSITY8', `GL_INTENSITY12', `GL_INTENSITY16', `GL_R3_G3_B2',
- `GL_RGB', `GL_RGB4', `GL_RGB5', `GL_RGB8', `GL_RGB10', `GL_RGB12',
- `GL_RGB16', `GL_RGBA', `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1',
- `GL_RGBA8', `GL_RGB10_A2', `GL_RGBA12', or `GL_RGBA16'.
+ The internal format of the convolution filter kernel. The allowable
+ values are `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12',
+ `GL_ALPHA16', `GL_LUMINANCE', `GL_LUMINANCE4', `GL_LUMINANCE8',
+ `GL_LUMINANCE12', `GL_LUMINANCE16', `GL_LUMINANCE_ALPHA',
+ `GL_LUMINANCE4_ALPHA4', `GL_LUMINANCE6_ALPHA2',
+ `GL_LUMINANCE8_ALPHA8', `GL_LUMINANCE12_ALPHA4',
+ `GL_LUMINANCE12_ALPHA12', `GL_LUMINANCE16_ALPHA16', `GL_INTENSITY',
+ `GL_INTENSITY4', `GL_INTENSITY8', `GL_INTENSITY12',
+ `GL_INTENSITY16', `GL_R3_G3_B2', `GL_RGB', `GL_RGB4', `GL_RGB5',
+ `GL_RGB8', `GL_RGB10', `GL_RGB12', `GL_RGB16', `GL_RGBA',
+ `GL_RGBA2', `GL_RGBA4', `GL_RGB5_A1', `GL_RGBA8', `GL_RGB10_A2',
+ `GL_RGBA12', or `GL_RGBA16'.
WIDTH
- The number of elements in the pixel array referenced by ROW. (This
+ The number of elements in the pixel array referenced by ROW. (This
is the width of the separable filter kernel.)
HEIGHT
(This is the height of the separable filter kernel.)
FORMAT
- The format of the pixel data in ROW and COLUMN. The allowable
+ The format of the pixel data in ROW and COLUMN. The allowable
values are `GL_RED', `GL_GREEN', `GL_BLUE', `GL_ALPHA', `GL_RGB',
`GL_BGR', `GL_RGBA', `GL_BGRA', `GL_INTENSITY', `GL_LUMINANCE', and
`GL_LUMINANCE_ALPHA'.
TYPE
- The type of the pixel data in ROW and COLUMN. Symbolic constants
+ The type of the pixel data in ROW and COLUMN. Symbolic constants
`GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP', `GL_UNSIGNED_SHORT',
`GL_SHORT', `GL_UNSIGNED_INT', `GL_INT', `GL_FLOAT',
`GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
Next, the R, G, B, and A components of all pixels in both arrays are
scaled by the four separable 2D `GL_CONVOLUTION_FILTER_SCALE' parameters
and biased by the four separable 2D `GL_CONVOLUTION_FILTER_BIAS'
-parameters. (The scale and bias parameters are set by
+parameters. (The scale and bias parameters are set by
`glConvolutionParameter' using the `GL_SEPARABLE_2D' target and the
names `GL_CONVOLUTION_FILTER_SCALE' and `GL_CONVOLUTION_FILTER_BIAS'.
The parameters themselves are vectors of four values that are applied to
are not clamped to [0,1] at any time during this process.
Each pixel is then converted to the internal format specified by
-INTERNALFORMAT. This conversion simply maps the component values of the
+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
+(red, green, blue, alpha, luminance, and intensity). The mapping is as
follows:
*Internal Format*
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
+format. They form two one-dimensional filter kernel images. The row
image is indexed by coordinate I starting at zero and increasing from
-left to right. Each location in the row image is derived from element I
-of ROW. The column image is indexed by coordinate J starting at zero
-and increasing from bottom to top. Each location in the column image is
+left to right. Each location in the row image is derived from element I
+of ROW. The column image is indexed by coordinate J starting at zero and
+increasing from bottom to top. Each location in the column image is
derived from element J of COLUMN.
Note that after a convolution is performed, the resulting color
components are also scaled by their corresponding
`GL_POST_CONVOLUTION_c_SCALE' parameters and biased by their
corresponding `GL_POST_CONVOLUTION_c_BIAS' parameters (where C takes on
-the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
+the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These parameters are
set by `glPixelTransfer'.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_SEPARABLE_2D'.
values.
`GL_INVALID_VALUE' is generated if WIDTH is less than zero or greater
-than the maximum supported value. This value may be queried with
+than the maximum supported value. This value may be queried with
`glGetConvolutionParameter' using target `GL_SEPARABLE_2D' and name
`GL_MAX_CONVOLUTION_WIDTH'.
`GL_INVALID_VALUE' is generated if HEIGHT is less than zero or greater
-than the maximum supported value. This value may be queried with
+than the maximum supported value. This value may be queried with
`glGetConvolutionParameter' using target `GL_SEPARABLE_2D' and name
`GL_MAX_CONVOLUTION_HEIGHT'.
MODE
Specifies a symbolic value representing a shading technique.
- Accepted values are `GL_FLAT' and `GL_SMOOTH'. The initial value
- is `GL_SMOOTH'.
+ Accepted values are `GL_FLAT' and `GL_SMOOTH'. The initial value is
+ `GL_SMOOTH'.
-GL primitives can have either flat or smooth shading. Smooth shading,
+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
+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
+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.
-Flat and smooth shading are indistinguishable for points. Starting when
+Flat and smooth shading are indistinguishable for points. Starting when
`glBegin' 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
+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
+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.
Specifies an array of string lengths.
`glShaderSource' sets the source code in SHADER to the source code in
-the array of strings specified by STRING. Any source code previously
-stored in the shader object is completely replaced. The number of
-strings in the array is specified by COUNT. If LENGTH is `NULL', each
-string is assumed to be null terminated. If LENGTH is a value other
-than `NULL', it points to an array containing a string length for each
-of the corresponding elements of STRING. Each element in the LENGTH
-array may contain the length of the corresponding string (the null
-character is not counted as part of the string length) or a value less
-than 0 to indicate that the string is null terminated. The source code
-strings are not scanned or parsed at this time; they are simply copied
-into the specified shader object.
+the array of strings specified by STRING. Any source code previously
+stored in the shader object is completely replaced. The number of
+strings in the array is specified by COUNT. If LENGTH is `NULL', each
+string is assumed to be null terminated. If LENGTH is a value other than
+`NULL', it points to an array containing a string length for each of the
+corresponding elements of STRING. Each element in the LENGTH array may
+contain the length of the corresponding string (the null character is
+not counted as part of the string length) or a value less than 0 to
+indicate that the string is null terminated. The source code strings are
+not scanned or parsed at this time; they are simply copied into the
+specified shader object.
`GL_INVALID_VALUE' is generated if SHADER is not a value generated by
OpenGL.
"Set front and/or back function and reference value for stencil testing.
FACE
- Specifies whether front and/or back stencil state is updated. Three
+ Specifies whether front and/or back stencil state is updated. Three
symbolic constants are valid: `GL_FRONT', `GL_BACK', and
`GL_FRONT_AND_BACK'.
FUNC
- Specifies the test function. Eight symbolic constants are valid:
+ Specifies the test function. Eight symbolic constants are valid:
`GL_NEVER', `GL_LESS', `GL_LEQUAL', `GL_GREATER', `GL_GEQUAL',
- `GL_EQUAL', `GL_NOTEQUAL', and `GL_ALWAYS'. The initial value is
+ `GL_EQUAL', `GL_NOTEQUAL', and `GL_ALWAYS'. The initial value is
`GL_ALWAYS'.
REF
- Specifies the reference value for the stencil test. REF is clamped
+ Specifies the reference value for the stencil test. REF is clamped
to the range [0,2^N-1] , where N is the number of bitplanes in the
- stencil buffer. The initial value is 0.
+ stencil buffer. The initial value is 0.
MASK
Specifies a mask that is ANDed with both the reference value and
- the stored stencil value when the test is done. The initial value
+ the stored stencil value when the test is done. The initial value
is all 1's.
Stenciling, like depth-buffering, enables and disables drawing on a
-per-pixel basis. You draw into the stencil planes using GL drawing
+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
+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.
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 `glEnable' and `glDisable'
-with argument `GL_STENCIL_TEST'. To specify actions based on the
-outcome of the stencil test, call `glStencilOp' or
-`glStencilOpSeparate'.
+buffer. To enable and disable the test, call `glEnable' and `glDisable'
+with argument `GL_STENCIL_TEST'. To specify actions based on the outcome
+of the stencil test, call `glStencilOp' or `glStencilOpSeparate'.
There can be two separate sets of FUNC, REF, and MASK parameters; one
affects back-facing polygons, and the other affects front-facing
-polygons as well as other non-polygon primitives. `glStencilFunc' sets
+polygons as well as other non-polygon primitives. `glStencilFunc' sets
both front and back stencil state to the same values, as if
`glStencilFuncSeparate' were called with FACE set to
`GL_FRONT_AND_BACK'.
FUNC is a symbolic constant that determines the stencil comparison
-function. It accepts one of eight values, shown in the following list.
+function. It accepts one of eight values, shown in the following list.
REF is an integer reference value that is used in the stencil
-comparison. It is clamped to the range [0,2^N-1] , where N is the
-number of bitplanes in the stencil buffer. MASK is bitwise ANDed with
-both the reference value and the stored stencil value, with the ANDed
-values participating in the comparison.
+comparison. It is clamped to the range [0,2^N-1] , where N is the number
+of bitplanes in the stencil buffer. MASK is bitwise ANDed with both the
+reference value and the stored stencil value, with the ANDed values
+participating in the comparison.
If STENCIL 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 FUNC. Only if the comparison succeeds
+function that can be specified by FUNC. Only if the comparison succeeds
is the pixel passed through to the next stage in the rasterization
-process (see `glStencilOp'). All tests treat STENCIL values as unsigned
+process (see `glStencilOp'). All tests treat STENCIL values as unsigned
integers in the range [0,2^N-1] , where N is the number of bitplanes in
the stencil buffer.
"Set front and back function and reference value for stencil testing.
FUNC
- Specifies the test function. Eight symbolic constants are valid:
+ Specifies the test function. Eight symbolic constants are valid:
`GL_NEVER', `GL_LESS', `GL_LEQUAL', `GL_GREATER', `GL_GEQUAL',
- `GL_EQUAL', `GL_NOTEQUAL', and `GL_ALWAYS'. The initial value is
+ `GL_EQUAL', `GL_NOTEQUAL', and `GL_ALWAYS'. The initial value is
`GL_ALWAYS'.
REF
- Specifies the reference value for the stencil test. REF is clamped
+ Specifies the reference value for the stencil test. REF is clamped
to the range [0,2^N-1] , where N is the number of bitplanes in the
- stencil buffer. The initial value is 0.
+ stencil buffer. The initial value is 0.
MASK
Specifies a mask that is ANDed with both the reference value and
- the stored stencil value when the test is done. The initial value
+ the stored stencil value when the test is done. The initial value
is all 1's.
Stenciling, like depth-buffering, enables and disables drawing on a
-per-pixel basis. Stencil planes are first drawn into using GL drawing
+per-pixel basis. Stencil planes are first drawn into using GL drawing
primitives, then geometry and images are rendered using the stencil
-planes to mask out portions of the screen. Stenciling is typically used
+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.
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 `glEnable' and `glDisable'
-with argument `GL_STENCIL_TEST'. To specify actions based on the
-outcome of the stencil test, call `glStencilOp' or
-`glStencilOpSeparate'.
+buffer. To enable and disable the test, call `glEnable' and `glDisable'
+with argument `GL_STENCIL_TEST'. To specify actions based on the outcome
+of the stencil test, call `glStencilOp' or `glStencilOpSeparate'.
There can be two separate sets of FUNC, REF, and MASK parameters; one
affects back-facing polygons, and the other affects front-facing
-polygons as well as other non-polygon primitives. `glStencilFunc' sets
-both front and back stencil state to the same values. Use
+polygons as well as other non-polygon primitives. `glStencilFunc' sets
+both front and back stencil state to the same values. Use
`glStencilFuncSeparate' to set front and back stencil state to different
values.
FUNC is a symbolic constant that determines the stencil comparison
-function. It accepts one of eight values, shown in the following list.
+function. It accepts one of eight values, shown in the following list.
REF is an integer reference value that is used in the stencil
-comparison. It is clamped to the range [0,2^N-1] , where N is the
-number of bitplanes in the stencil buffer. MASK is bitwise ANDed with
-both the reference value and the stored stencil value, with the ANDed
-values participating in the comparison.
+comparison. It is clamped to the range [0,2^N-1] , where N is the number
+of bitplanes in the stencil buffer. MASK is bitwise ANDed with both the
+reference value and the stored stencil value, with the ANDed values
+participating in the comparison.
If STENCIL 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 FUNC. Only if the comparison succeeds
+function that can be specified by FUNC. Only if the comparison succeeds
is the pixel passed through to the next stage in the rasterization
-process (see `glStencilOp'). All tests treat STENCIL values as unsigned
+process (see `glStencilOp'). All tests treat STENCIL values as unsigned
integers in the range [0,2^N-1] , where N is the number of bitplanes in
the stencil buffer.
FACE
Specifies whether the front and/or back stencil writemask is
- updated. Three symbolic constants are valid: `GL_FRONT',
- `GL_BACK', and `GL_FRONT_AND_BACK'.
+ updated. Three symbolic constants are valid: `GL_FRONT', `GL_BACK',
+ and `GL_FRONT_AND_BACK'.
MASK
Specifies a bit mask to enable and disable writing of individual
- bits in the stencil planes. Initially, the mask is all 1's.
+ bits in the stencil planes. Initially, the mask is all 1's.
`glStencilMaskSeparate' controls the writing of individual bits in the
-stencil planes. The least significant N bits of MASK, where N is the
-number of bits in the stencil buffer, specify a mask. Where a 1 appears
+stencil planes. The least significant N bits of MASK, 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.
+stencil buffer. Where a 0 appears, the corresponding bit is
+write-protected. Initially, all bits are enabled for writing.
There can be two separate MASK writemasks; one affects back-facing
polygons, and the other affects front-facing polygons as well as other
-non-polygon primitives. `glStencilMask' sets both front and back
-stencil writemasks to the same values, as if `glStencilMaskSeparate'
-were called with FACE set to `GL_FRONT_AND_BACK'.
+non-polygon primitives. `glStencilMask' sets both front and back stencil
+writemasks to the same values, as if `glStencilMaskSeparate' were called
+with FACE set to `GL_FRONT_AND_BACK'.
`GL_INVALID_OPERATION' is generated if `glStencilMaskSeparate' is
executed between the execution of `glBegin' and the corresponding
MASK
Specifies a bit mask to enable and disable writing of individual
- bits in the stencil planes. Initially, the mask is all 1's.
+ bits in the stencil planes. Initially, the mask is all 1's.
`glStencilMask' controls the writing of individual bits in the stencil
-planes. The least significant N bits of MASK, where N is the number of
-bits in the stencil buffer, specify a mask. Where a 1 appears in the
+planes. The least significant N bits of MASK, 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.
+buffer. Where a 0 appears, the corresponding bit is write-protected.
Initially, all bits are enabled for writing.
There can be two separate MASK writemasks; one affects back-facing
polygons, and the other affects front-facing polygons as well as other
-non-polygon primitives. `glStencilMask' sets both front and back
-stencil writemasks to the same values. Use `glStencilMaskSeparate' to
-set front and back stencil writemasks to different values.
+non-polygon primitives. `glStencilMask' sets both front and back stencil
+writemasks to the same values. Use `glStencilMaskSeparate' to set front
+and back stencil writemasks to different values.
`GL_INVALID_OPERATION' is generated if `glStencilMask' is executed
between the execution of `glBegin' and the corresponding execution of
"Set front and/or back stencil test actions.
FACE
- Specifies whether front and/or back stencil state is updated. Three
+ Specifies whether front and/or back stencil state is updated. Three
symbolic constants are valid: `GL_FRONT', `GL_BACK', and
`GL_FRONT_AND_BACK'.
SFAIL
- Specifies the action to take when the stencil test fails. Eight
+ Specifies the action to take when the stencil test fails. Eight
symbolic constants are accepted: `GL_KEEP', `GL_ZERO',
`GL_REPLACE', `GL_INCR', `GL_INCR_WRAP', `GL_DECR', `GL_DECR_WRAP',
- and `GL_INVERT'. The initial value is `GL_KEEP'.
+ and `GL_INVERT'. The initial value is `GL_KEEP'.
DPFAIL
Specifies the stencil action when the stencil test passes, but the
- depth test fails. DPFAIL accepts the same symbolic constants as
- SFAIL. The initial value is `GL_KEEP'.
+ depth test fails. DPFAIL accepts the same symbolic constants as
+ SFAIL. The initial value is `GL_KEEP'.
DPPASS
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. DPPASS accepts
- the same symbolic constants as SFAIL. The initial value is
+ is no depth buffer or depth testing is not enabled. DPPASS accepts
+ the same symbolic constants as SFAIL. The initial value is
`GL_KEEP'.
Stenciling, like depth-buffering, enables and disables drawing on a
-per-pixel basis. You draw into the stencil planes using GL drawing
+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
+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.
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 `glEnable' and `glDisable'
+value. To enable and disable the test, call `glEnable' and `glDisable'
with argument `GL_STENCIL_TEST'; to control it, call `glStencilFunc' or
`glStencilFuncSeparate'.
There can be two separate sets of SFAIL, DPFAIL, and DPPASS parameters;
one affects back-facing polygons, and the other affects front-facing
-polygons as well as other non-polygon primitives. `glStencilOp' sets
+polygons as well as other non-polygon primitives. `glStencilOp' sets
both front and back stencil state to the same values, as if
`glStencilOpSeparate' were called with FACE set to `GL_FRONT_AND_BACK'.
`glStencilOpSeparate' takes three arguments that indicate what happens
-to the stored stencil value while stenciling is enabled. If the stencil
+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
-SFAIL specifies what happens to the stencil buffer contents. The
+SFAIL specifies what happens to the stencil buffer contents. The
following eight actions are possible.
`GL_KEEP'
`glStencilFunc'.
`GL_INCR'
- Increments the current stencil buffer value. Clamps to the maximum
+ Increments the current stencil buffer value. Clamps to the maximum
representable unsigned value.
`GL_INCR_WRAP'
- Increments the current stencil buffer value. Wraps stencil buffer
+ Increments the current stencil buffer value. Wraps stencil buffer
value to zero when incrementing the maximum representable unsigned
value.
`GL_DECR'
- Decrements the current stencil buffer value. Clamps to 0.
+ Decrements the current stencil buffer value. Clamps to 0.
`GL_DECR_WRAP'
- Decrements the current stencil buffer value. Wraps stencil buffer
+ Decrements the current stencil buffer value. Wraps stencil buffer
value to the maximum representable unsigned value when decrementing
a stencil buffer value of zero.
`GL_INVERT'
Bitwise inverts the current stencil buffer value.
-Stencil buffer values are treated as unsigned integers. When
-incremented and decremented, values are clamped to 0 and 2^N-1 , where N
-is the value returned by querying `GL_STENCIL_BITS'.
+Stencil buffer values are treated as unsigned integers. When incremented
+and decremented, values are clamped to 0 and 2^N-1 , where N is the
+value returned by querying `GL_STENCIL_BITS'.
The other two arguments to `glStencilOpSeparate' specify stencil buffer
actions that depend on whether subsequent depth buffer tests succeed
-(DPPASS) or fail (DPFAIL) (see `glDepthFunc'). The actions are
-specified using the same eight symbolic constants as SFAIL. Note that
-DPFAIL is ignored when there is no depth buffer, or when the depth
-buffer is not enabled. In these cases, SFAIL and DPPASS specify stencil
-action when the stencil test fails and passes, respectively.
+(DPPASS) or fail (DPFAIL) (see `glDepthFunc'). The actions are specified
+using the same eight symbolic constants as SFAIL. Note that DPFAIL is
+ignored when there is no depth buffer, or when the depth buffer is not
+enabled. In these cases, SFAIL and DPPASS specify stencil action when
+the stencil test fails and passes, respectively.
`GL_INVALID_ENUM' is generated if FACE is any value other than
`GL_FRONT', `GL_BACK', or `GL_FRONT_AND_BACK'.
"Set front and back stencil test actions.
SFAIL
- Specifies the action to take when the stencil test fails. Eight
+ Specifies the action to take when the stencil test fails. Eight
symbolic constants are accepted: `GL_KEEP', `GL_ZERO',
`GL_REPLACE', `GL_INCR', `GL_INCR_WRAP', `GL_DECR', `GL_DECR_WRAP',
- and `GL_INVERT'. The initial value is `GL_KEEP'.
+ and `GL_INVERT'. The initial value is `GL_KEEP'.
DPFAIL
Specifies the stencil action when the stencil test passes, but the
- depth test fails. DPFAIL accepts the same symbolic constants as
- SFAIL. The initial value is `GL_KEEP'.
+ depth test fails. DPFAIL accepts the same symbolic constants as
+ SFAIL. The initial value is `GL_KEEP'.
DPPASS
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. DPPASS accepts
- the same symbolic constants as SFAIL. The initial value is
+ is no depth buffer or depth testing is not enabled. DPPASS accepts
+ the same symbolic constants as SFAIL. The initial value is
`GL_KEEP'.
Stenciling, like depth-buffering, enables and disables drawing on a
-per-pixel basis. You draw into the stencil planes using GL drawing
+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
+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.
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 `glEnable' and `glDisable'
+value. To enable and disable the test, call `glEnable' and `glDisable'
with argument `GL_STENCIL_TEST'; to control it, call `glStencilFunc' or
`glStencilFuncSeparate'.
There can be two separate sets of SFAIL, DPFAIL, and DPPASS parameters;
one affects back-facing polygons, and the other affects front-facing
-polygons as well as other non-polygon primitives. `glStencilOp' sets
-both front and back stencil state to the same values. Use
+polygons as well as other non-polygon primitives. `glStencilOp' sets
+both front and back stencil state to the same values. Use
`glStencilOpSeparate' to set front and back stencil state to different
values.
`glStencilOp' takes three arguments that indicate what happens to the
-stored stencil value while stenciling is enabled. If the stencil test
+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
-SFAIL specifies what happens to the stencil buffer contents. The
+SFAIL specifies what happens to the stencil buffer contents. The
following eight actions are possible.
`GL_KEEP'
`glStencilFunc'.
`GL_INCR'
- Increments the current stencil buffer value. Clamps to the maximum
+ Increments the current stencil buffer value. Clamps to the maximum
representable unsigned value.
`GL_INCR_WRAP'
- Increments the current stencil buffer value. Wraps stencil buffer
+ Increments the current stencil buffer value. Wraps stencil buffer
value to zero when incrementing the maximum representable unsigned
value.
`GL_DECR'
- Decrements the current stencil buffer value. Clamps to 0.
+ Decrements the current stencil buffer value. Clamps to 0.
`GL_DECR_WRAP'
- Decrements the current stencil buffer value. Wraps stencil buffer
+ Decrements the current stencil buffer value. Wraps stencil buffer
value to the maximum representable unsigned value when decrementing
a stencil buffer value of zero.
`GL_INVERT'
Bitwise inverts the current stencil buffer value.
-Stencil buffer values are treated as unsigned integers. When
-incremented and decremented, values are clamped to 0 and 2^N-1 , where N
-is the value returned by querying `GL_STENCIL_BITS'.
+Stencil buffer values are treated as unsigned integers. When incremented
+and decremented, values are clamped to 0 and 2^N-1 , where N is the
+value returned by querying `GL_STENCIL_BITS'.
The other two arguments to `glStencilOp' specify stencil buffer actions
that depend on whether subsequent depth buffer tests succeed (DPPASS) or
-fail (DPFAIL) (see `glDepthFunc'). The actions are specified using the
-same eight symbolic constants as SFAIL. Note that DPFAIL is ignored
-when there is no depth buffer, or when the depth buffer is not enabled.
-In these cases, SFAIL and DPPASS specify stencil action when the stencil
+fail (DPFAIL) (see `glDepthFunc'). The actions are specified using the
+same eight symbolic constants as SFAIL. Note that DPFAIL is ignored when
+there is no depth buffer, or when the depth buffer is not enabled. In
+these cases, SFAIL and DPPASS specify stencil action when the stencil
test fails and passes, respectively.
`GL_INVALID_ENUM' is generated if SFAIL, DPFAIL, or DPPASS is any value
"Define an array of texture coordinates.
SIZE
- Specifies the number of coordinates per array element. Must be 1,
- 2, 3, or 4. The initial value is 4.
+ Specifies the number of coordinates per array element. Must be 1,
+ 2, 3, or 4. The initial value is 4.
TYPE
- Specifies the data type of each texture coordinate. Symbolic
+ Specifies the data type of each texture coordinate. Symbolic
constants `GL_SHORT', `GL_INT', `GL_FLOAT', or `GL_DOUBLE' are
- accepted. The initial value is `GL_FLOAT'.
+ accepted. The initial value is `GL_FLOAT'.
STRIDE
Specifies the byte offset between consecutive texture coordinate
- sets. If STRIDE is 0, the array elements are understood to be
- tightly packed. The initial value is 0.
+ sets. If STRIDE is 0, the array elements are understood to be
+ tightly packed. The initial value is 0.
POINTER
Specifies a pointer to the first coordinate of the first texture
- coordinate set in the array. The initial value is 0.
+ coordinate set in the array. The initial value is 0.
`glTexCoordPointer' specifies the location and data format of an array
-of texture coordinates to use when rendering. SIZE specifies the number
+of texture coordinates to use when rendering. SIZE specifies the number
of coordinates per texture coordinate set, and must be 1, 2, 3, or 4.
TYPE specifies the data type of each texture coordinate, and STRIDE
specifies the byte stride from one texture coordinate set 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
+stored in separate arrays. (Single-array storage may be more efficient
on some implementations; see `glInterleavedArrays'.)
If a non-zero named buffer object is bound to the `GL_ARRAY_BUFFER'
target (see `glBindBuffer') while a texture coordinate array is
specified, POINTER is treated as a byte offset into the buffer object's
-data store. Also, the buffer object binding (`GL_ARRAY_BUFFER_BINDING')
+data store. Also, the buffer object binding (`GL_ARRAY_BUFFER_BINDING')
is saved as texture coordinate vertex array client-side state
(`GL_TEXTURE_COORD_ARRAY_BUFFER_BINDING').
To enable and disable a texture coordinate array, call
`glEnableClientState' and `glDisableClientState' with the argument
-`GL_TEXTURE_COORD_ARRAY'. If enabled, the texture coordinate array is
+`GL_TEXTURE_COORD_ARRAY'. If enabled, the texture coordinate array is
used when `glArrayElement', `glDrawArrays', `glMultiDrawArrays',
`glDrawElements', `glMultiDrawElements', or `glDrawRangeElements' is
called.
Q
- Specify S, T, R, and Q texture coordinates. Not all parameters are
+ Specify S, T, R, and Q texture coordinates. Not all parameters are
present in all forms of the command.
`glTexCoord' specifies texture coordinates in one, two, three, or four
-dimensions. `glTexCoord1' sets the current texture coordinates to
-(S,001) ; a call to `glTexCoord2' sets them to (S,T01) . Similarly,
+dimensions. `glTexCoord1' sets the current texture coordinates to
+(S,001) ; a call to `glTexCoord2' sets them to (S,T01) . Similarly,
`glTexCoord3' specifies the texture coordinates as (S,TR1) , and
`glTexCoord4' defines all four components explicitly as (S,TRQ) .
The current texture coordinates are part of the data that is associated
-with each vertex and with the current raster position. Initially, the
+with each vertex and with the current raster position. Initially, the
values for S, T, R, and Q are (0, 0, 0, 1).")
(define-gl-procedures
"Set texture environment parameters.
TARGET
- Specifies a texture environment. May be `GL_TEXTURE_ENV',
+ Specifies a texture environment. May be `GL_TEXTURE_ENV',
`GL_TEXTURE_FILTER_CONTROL' or `GL_POINT_SPRITE'.
PNAME
Specifies the symbolic name of a single-valued texture environment
- parameter. May be either `GL_TEXTURE_ENV_MODE',
+ parameter. May be either `GL_TEXTURE_ENV_MODE',
`GL_TEXTURE_LOD_BIAS', `GL_COMBINE_RGB', `GL_COMBINE_ALPHA',
`GL_SRC0_RGB', `GL_SRC1_RGB', `GL_SRC2_RGB', `GL_SRC0_ALPHA',
`GL_SRC1_ALPHA', `GL_SRC2_ALPHA', `GL_OPERAND0_RGB',
when specifying the `GL_RGB_SCALE' or `GL_ALPHA_SCALE'.
A texture environment specifies how texture values are interpreted when
-a fragment is textured. When TARGET is `GL_TEXTURE_FILTER_CONTROL',
-PNAME must be `GL_TEXTURE_LOD_BIAS'. When TARGET is `GL_TEXTURE_ENV',
+a fragment is textured. When TARGET is `GL_TEXTURE_FILTER_CONTROL',
+PNAME must be `GL_TEXTURE_LOD_BIAS'. When TARGET is `GL_TEXTURE_ENV',
PNAME can be `GL_TEXTURE_ENV_MODE', `GL_TEXTURE_ENV_COLOR',
`GL_COMBINE_RGB', `GL_COMBINE_ALPHA', `GL_RGB_SCALE', `GL_ALPHA_SCALE',
`GL_SRC0_RGB', `GL_SRC1_RGB', `GL_SRC2_RGB', `GL_SRC0_ALPHA',
`GL_SRC1_ALPHA', or `GL_SRC2_ALPHA'.
If PNAME is `GL_TEXTURE_ENV_MODE', then PARAMS is (or points to) the
-symbolic name of a texture function. Six texture functions may be
+symbolic name of a texture function. Six texture functions may be
specified: `GL_ADD', `GL_MODULATE', `GL_DECAL', `GL_BLEND',
`GL_REPLACE', or `GL_COMBINE'.
The following table shows the correspondence of filtered texture values
-R_T , G_T , B_T , A_T , L_T , I_T to texture source components. C_S and
+R_T , G_T , B_T , A_T , L_T , I_T to texture source components. C_S and
A_S are used by the texture functions described below.
A texture function acts on the fragment to be textured using the texture
image value that applies to the fragment (see `glTexParameter') and
-produces an RGBA color for that fragment. The following table shows how
+produces an RGBA color for that fragment. The following table shows how
the RGBA color is produced for each of the first five 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 P refers to the color computed from
+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 P refers to the color computed from
the previous texture stage (or the incoming fragment if processing
texture stage 0), the subscript S to the texture source color, the
subscript C to the texture environment color, and the subscript V
The following describes how the texture sources, as specified by
`GL_SRC0_RGB', `GL_SRC1_RGB', `GL_SRC2_RGB', `GL_SRC0_ALPHA',
`GL_SRC1_ALPHA', and `GL_SRC2_ALPHA', are combined to produce a final
-texture color. In the following tables, `GL_SRC0_c' is represented by
+texture color. In the following tables, `GL_SRC0_c' is represented by
ARG0 , `GL_SRC1_c' is represented by ARG1 , and `GL_SRC2_c' is
represented by ARG2 .
each of the 3 (RGB) or 4 (RGBA) components on output.
Likewise, `GL_COMBINE_ALPHA' accepts any of `GL_REPLACE', `GL_MODULATE',
-`GL_ADD', `GL_ADD_SIGNED', `GL_INTERPOLATE', or `GL_SUBTRACT'. The
+`GL_ADD', `GL_ADD_SIGNED', `GL_INTERPOLATE', or `GL_SUBTRACT'. The
following table describes how alpha values are combined:
the currently bound texture, C_C represents the constant
texture-environment color, C_F represents the primary color of the
incoming fragment, and C_P represents the color computed from the
-previous texture stage or C_F if processing texture stage 0. Likewise,
+previous texture stage or C_F if processing texture stage 0. Likewise,
A_S , A_C , A_F , and A_P represent the respective alpha values.
The following table describes the values assigned to ARG0 , ARG1 , and
to the range [0,1] .
If PNAME is `GL_TEXTURE_ENV_COLOR', PARAMS is a pointer to an array that
-holds an RGBA color consisting of four values. Integer color components
+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_C takes these four
-values.
+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_C takes these four values.
If PNAME is `GL_TEXTURE_LOD_BIAS', the value specified is added to the
texture level-of-detail parameter, that selects which mipmap, or mipmaps
If TARGET is `GL_POINT_SPRITE' and PNAME is `GL_COORD_REPLACE', the
boolean value specified is used to either enable or disable point sprite
-texture coordinate replacement. The default value is `GL_FALSE'.
+texture coordinate replacement. The default value is `GL_FALSE'.
`GL_INVALID_ENUM' is generated when TARGET or PNAME is not one of the
accepted defined values, or when PARAMS should have a defined constant
"Control the generation of texture coordinates.
COORD
- Specifies a texture coordinate. Must be one of `GL_S', `GL_T',
+ Specifies a texture coordinate. Must be one of `GL_S', `GL_T',
`GL_R', or `GL_Q'.
PNAME
Specifies the symbolic name of the texture-coordinate generation
- function. Must be `GL_TEXTURE_GEN_MODE'.
+ function. Must be `GL_TEXTURE_GEN_MODE'.
PARAM
Specifies a single-valued texture generation parameter, one of
`GL_NORMAL_MAP', or `GL_REFLECTION_MAP'.
`glTexGen' selects a texture-coordinate generation function or supplies
-coefficients for one of the functions. COORD names one of the (S, T, R,
+coefficients for one of the functions. COORD names one of the (S, T, R,
Q) texture coordinates; it must be one of the symbols `GL_S', `GL_T',
-`GL_R', or `GL_Q'. PNAME must be one of three symbolic constants:
-`GL_TEXTURE_GEN_MODE', `GL_OBJECT_PLANE', or `GL_EYE_PLANE'. If PNAME
-is `GL_TEXTURE_GEN_MODE', then PARAMS chooses a mode, one of
+`GL_R', or `GL_Q'. PNAME must be one of three symbolic constants:
+`GL_TEXTURE_GEN_MODE', `GL_OBJECT_PLANE', or `GL_EYE_PLANE'. If PNAME is
+`GL_TEXTURE_GEN_MODE', then PARAMS chooses a mode, one of
`GL_OBJECT_LINEAR', `GL_EYE_LINEAR', `GL_SPHERE_MAP', `GL_NORMAL_MAP',
-or `GL_REFLECTION_MAP'. If PNAME is either `GL_OBJECT_PLANE' or
+or `GL_REFLECTION_MAP'. If PNAME is either `GL_OBJECT_PLANE' or
`GL_EYE_PLANE', PARAMS contains coefficients for the corresponding
texture generation function.
COORD, P_1 , P_2 , P_3 , and P_4 are the four values supplied in PARAMS,
and X_O , Y_O , Z_O , and W_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_1 , P_2 , P_3 , and P_4 ). The
+level as a reference plane (defined by P_1 , P_2 , P_3 , and P_4 ). The
altitude of a terrain vertex is computed by the `GL_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
and X_E , Y_E , Z_E , and W_E are the eye coordinates of the vertex, P_1
, P_2 , P_3 , and P_4 are the values supplied in PARAMS, and M is the
-modelview matrix when `glTexGen' is invoked. If M is poorly conditioned
+modelview matrix when `glTexGen' is invoked. If M is poorly conditioned
or singular, texture coordinates generated by the resulting function may
be inaccurate or undefined.
Note that the values in PARAMS 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
+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.
If the texture generation function is `GL_SPHERE_MAP' and COORD is
either `GL_S' or `GL_T', S and T texture coordinates are generated as
-follows. Let U be the unit vector pointing from the origin to the
-polygon vertex (in eye coordinates). Let N sup prime be the current
-normal, after transformation to eye coordinates. Let
+follows. Let U be the unit vector pointing from the origin to the
+polygon vertex (in eye coordinates). Let N sup prime be the current
+normal, after transformation to eye coordinates. Let
F=(F_X\u2062F_Y\u2062F_Z,)^T be the reflection vector such that
F=U-2\u2062N^″\u2062N^″,^T\u2062U
-Finally, let M=2\u2062√(F_X,^2+F_Y,^2+(F_Z+1,)^2,) . Then the values
-assigned to the S and T texture coordinates are
+Finally, let M=2\u2062√(F_X,^2+F_Y,^2+(F_Z+1,)^2,) . Then the values assigned
+to the S and T texture coordinates are
S=F_X/M+1/2
To enable or disable a texture-coordinate generation function, call
`glEnable' or `glDisable' with one of the symbolic texture-coordinate
names (`GL_TEXTURE_GEN_S', `GL_TEXTURE_GEN_T', `GL_TEXTURE_GEN_R', or
-`GL_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
-`GL_EYE_LINEAR' and are disabled. Both S plane equations are (1, 0, 0,
+`GL_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
+`GL_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).
"Specify a one-dimensional texture image.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_1D' or
+ Specifies the target texture. Must be `GL_TEXTURE_1D' or
`GL_PROXY_TEXTURE_1D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
- Specifies the number of color components in the texture. Must be
- 1, 2, 3, or 4, or one of the following symbolic constants:
- `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16',
+ Specifies the number of color components in the texture. Must be 1,
+ 2, 3, or 4, or one of the following symbolic constants: `GL_ALPHA',
+ `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16',
`GL_COMPRESSED_ALPHA', `GL_COMPRESSED_LUMINANCE',
`GL_COMPRESSED_LUMINANCE_ALPHA', `GL_COMPRESSED_INTENSITY',
`GL_COMPRESSED_RGB', `GL_COMPRESSED_RGBA', `GL_DEPTH_COMPONENT',
WIDTH
Specifies the width of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^N+2\u2061(BORDER,) for some integer N . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^N+2\u2061(BORDER,) 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.
+ wide. The height of the 1D texture image is 1.
BORDER
- Specifies the width of the border. Must be either 0 or 1.
+ Specifies the width of the border. Must be either 0 or 1.
FORMAT
- Specifies the format of the pixel data. The following symbolic
+ Specifies the format of the pixel data. The following symbolic
values are accepted: `GL_COLOR_INDEX', `GL_RED', `GL_GREEN',
`GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', `GL_BGRA',
`GL_LUMINANCE', and `GL_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type of the pixel data. The following symbolic
+ Specifies the data type of the pixel data. The following symbolic
values are accepted: `GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP',
`GL_UNSIGNED_SHORT', `GL_SHORT', `GL_UNSIGNED_INT', `GL_INT',
`GL_FLOAT', `GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable one-dimensional texturing, call `glEnable' and `glDisable' with
argument `GL_TEXTURE_1D'.
-Texture images are defined with `glTexImage1D'. The arguments describe
+Texture images are defined with `glTexImage1D'. The arguments describe
the parameters of the texture image, such as width, width of the border,
level-of-detail number (see `glTexParameter'), and the internal
-resolution and format used to store the image. The last three arguments
+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 `glDrawPixels'.
If TARGET is `GL_PROXY_TEXTURE_1D', no data is read from DATA, 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
-`glGetError'). To query for an entire mipmap array, use an image array
-level greater than or equal to 1.
+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 `glGetError').
+To query for an entire mipmap array, use an image array level greater
+than or equal to 1.
If TARGET is `GL_TEXTURE_1D', data is read from DATA 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
+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 `GL_BITMAP', the data is considered as a string of
-unsigned bytes (and FORMAT must be `GL_COLOR_INDEX'). Each data byte is
+elements. If TYPE is `GL_BITMAP', the data is considered as a string of
+unsigned bytes (and FORMAT must be `GL_COLOR_INDEX'). Each data byte is
treated as eight 1-bit elements, with bit ordering determined by
`GL_UNPACK_LSB_FIRST' (see `glPixelStore').
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
+in the texture array. The final element corresponds to the right end of
the texture array.
-FORMAT determines the composition of each element in DATA. It can
-assume one of these symbolic values:
+FORMAT determines the composition of each element in DATA. It can assume
+one of these symbolic values:
`GL_COLOR_INDEX'
- Each element is a single value, a color index. The GL converts it
+ 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 `GL_INDEX_SHIFT', and added to `GL_INDEX_OFFSET'
- (see `glPixelTransfer'). The resulting index is converted to a set
+ (see `glPixelTransfer'). The resulting index is converted to a set
of color components using the `GL_PIXEL_MAP_I_TO_R',
`GL_PIXEL_MAP_I_TO_G', `GL_PIXEL_MAP_I_TO_B', and
`GL_PIXEL_MAP_I_TO_A' tables, and clamped to the range [0,1].
`GL_RED'
- Each element is a single red component. The GL converts it to
+ 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
+ for green and blue, and 1 for alpha. Each component is then
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_GREEN'
- Each element is a single green component. The GL converts it to
+ 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
+ for red and blue, and 1 for alpha. Each component is then
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_BLUE'
- Each element is a single blue component. The GL converts it to
+ 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
+ for red and green, and 1 for alpha. Each component is then
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_ALPHA'
- Each element is a single alpha component. The GL converts it to
+ 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
+ for red, green, and blue. Each component is then multiplied by the
signed scale factor `GL_c_SCALE', added to the signed bias
`GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_INTENSITY'
- Each element is a single intensity value. The GL converts it to
+ Each element is a single intensity value. The GL converts it to
floating point, then assembles it into an RGBA element by
replicating the intensity value three times for red, green, blue,
- and alpha. Each component is then multiplied by the signed scale
+ and alpha. Each component is then multiplied by the signed scale
factor `GL_c_SCALE', added to the signed bias `GL_c_BIAS', and
clamped to the range [0,1] (see `glPixelTransfer').
`GL_RGB'
`GL_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 `GL_c_SCALE', added to the signed bias `GL_c_BIAS', and
- clamped to the range [0,1] (see `glPixelTransfer').
+ 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
+ `GL_c_SCALE', added to the signed bias `GL_c_BIAS', and clamped to
+ the range [0,1] (see `glPixelTransfer').
`GL_RGBA'
`GL_BGRA'
- Each element contains all four components. Each component is
+ Each element contains all four components. Each component is
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_LUMINANCE'
- Each element is a single luminance value. The GL converts it to
+ 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
+ blue and attaching 1 for alpha. Each component is then multiplied
by the signed scale factor `GL_c_SCALE', added to the signed bias
`GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_LUMINANCE_ALPHA'
- Each element is a luminance/alpha pair. The GL converts it to
+ 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
+ blue. Each component is then multiplied by the signed scale factor
`GL_c_SCALE', added to the signed bias `GL_c_BIAS', and clamped to
the range [0,1] (see `glPixelTransfer').
`GL_DEPTH_COMPONENT'
- Each element is a single depth value. The GL converts it to
+ Each element is a single depth value. The GL converts it to
floating point, multiplies by the signed scale factor
`GL_DEPTH_SCALE', adds the signed bias `GL_DEPTH_BIAS', and clamps
to the range [0,1] (see `glPixelTransfer').
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
+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 `GL_LUMINANCE',
-`GL_LUMINANCE_ALPHA', `GL_RGB', and `GL_RGBA' must match exactly. The
+match exactly. (The representations specified by `GL_LUMINANCE',
+`GL_LUMINANCE_ALPHA', `GL_RGB', and `GL_RGBA' must match exactly. The
numeric values 1, 2, 3, and 4 may also be used to specify the above
representations.)
`GL_COMPRESSED_LUMINANCE', `GL_COMPRESSED_LUMINANCE_ALPHA',
`GL_COMPRESSED_RGB', or `GL_COMPRESSED_RGBA', the GL will replace the
internal format with the symbolic constant for a specific internal
-format and compress the texture before storage. If no corresponding
+format and compress the texture before storage. If no corresponding
internal format is available, or the GL can not compress that image for
any reason, the internal format is instead replaced with a corresponding
base internal format.
`GL_SRGB_ALPHA', `GL_SRGB8_ALPHA8', `GL_SLUMINANCE', `GL_SLUMINANCE8',
`GL_SLUMINANCE_ALPHA', or `GL_SLUMINANCE8_ALPHA8', the texture is
treated as if the red, green, blue, or luminance components are encoded
-in the sRGB color space. Any alpha component is left unchanged. The
+in the sRGB color space. Any alpha component is left unchanged. The
conversion from the sRGB encoded component C_S to a linear component C_L
is:
Use the `GL_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 then query this state, call
-`glGetTexLevelParameter'. If the texture cannot be accommodated,
-texture state is set to 0.
+requested storage resolution and format. To then query this state, call
+`glGetTexLevelParameter'. If the texture cannot be accommodated, texture
+state is set to 0.
A one-component texture image uses only the red component of the RGBA
-color from DATA. A two-component image uses the R and A values. A
-three-component image uses the R, G, and B values. A four-component
+color from DATA. 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.
Depth textures can be treated as LUMINANCE, INTENSITY or ALPHA textures
-during texture filtering and application. \xa0Image-based shadowing\xa0can\xa0be
+during texture filtering and application.\xa0Image-based shadowing\xa0can\xa0be
\xa0enabled\xa0by\xa0comparing texture r coordinates to depth texture values to
-generate a boolean result. See `glTexParameter' for details on texture
+generate a boolean result. See `glTexParameter' for details on texture
comparison.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_TEXTURE_1D' or
`GL_PROXY_TEXTURE_1D'.
`GL_INVALID_ENUM' is generated if FORMAT is not an accepted format
-constant. Format constants other than `GL_STENCIL_INDEX' are accepted.
+constant. Format constants other than `GL_STENCIL_INDEX' are accepted.
`GL_INVALID_ENUM' is generated if TYPE is not a type constant.
"Specify a two-dimensional texture image.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_2D',
+ Specifies the target texture. Must be `GL_TEXTURE_2D',
`GL_PROXY_TEXTURE_2D', `GL_TEXTURE_CUBE_MAP_POSITIVE_X',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_X', `GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Y', `GL_TEXTURE_CUBE_MAP_POSITIVE_Z',
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Z', or `GL_PROXY_TEXTURE_CUBE_MAP'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
- Specifies the number of color components in the texture. Must be
- 1, 2, 3, or 4, or one of the following symbolic constants:
- `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16',
+ Specifies the number of color components in the texture. Must be 1,
+ 2, 3, or 4, or one of the following symbolic constants: `GL_ALPHA',
+ `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16',
`GL_COMPRESSED_ALPHA', `GL_COMPRESSED_LUMINANCE',
`GL_COMPRESSED_LUMINANCE_ALPHA', `GL_COMPRESSED_INTENSITY',
`GL_COMPRESSED_RGB', `GL_COMPRESSED_RGBA', `GL_DEPTH_COMPONENT',
WIDTH
Specifies the width of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^N+2\u2061(BORDER,) for some integer N . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^N+2\u2061(BORDER,) for some integer N . All
implementations support texture images that are at least 64 texels
wide.
HEIGHT
Specifies the height of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^M+2\u2061(BORDER,) for some integer M . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^M+2\u2061(BORDER,) for some integer M . All
implementations support texture images that are at least 64 texels
high.
BORDER
- Specifies the width of the border. Must be either 0 or 1.
+ Specifies the width of the border. Must be either 0 or 1.
FORMAT
- Specifies the format of the pixel data. The following symbolic
+ Specifies the format of the pixel data. The following symbolic
values are accepted: `GL_COLOR_INDEX', `GL_RED', `GL_GREEN',
`GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', `GL_BGRA',
`GL_LUMINANCE', and `GL_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type of the pixel data. The following symbolic
+ Specifies the data type of the pixel data. The following symbolic
values are accepted: `GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP',
`GL_UNSIGNED_SHORT', `GL_SHORT', `GL_UNSIGNED_INT', `GL_INT',
`GL_FLOAT', `GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call `glEnable' and `glDisable' with
-argument `GL_TEXTURE_2D'. To enable and disable texturing using
+argument `GL_TEXTURE_2D'. To enable and disable texturing using
cube-mapped texture, call `glEnable' and `glDisable' with argument
`GL_TEXTURE_CUBE_MAP'.
-To define texture images, call `glTexImage2D'. The arguments describe
+To define texture images, call `glTexImage2D'. The arguments describe
the parameters of the texture image, such as height, width, width of the
border, level-of-detail number (see `glTexParameter'), and number of
-color components provided. The last three arguments describe how the
+color components provided. The last three arguments describe how the
image is represented in memory; they are identical to the pixel formats
used for `glDrawPixels'.
If TARGET is `GL_PROXY_TEXTURE_2D' or `GL_PROXY_TEXTURE_CUBE_MAP', no
data is read from DATA, 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
+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 `glGetError'). To query for an
+0, but does not generate an error (see `glGetError'). To query for an
entire mipmap array, use an image array level greater than or equal to
1.
If TARGET is `GL_TEXTURE_2D', or one of the `GL_TEXTURE_CUBE_MAP'
targets, data is read from DATA 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 `GL_BITMAP', the data is considered as a string of unsigned bytes
-(and FORMAT must be `GL_COLOR_INDEX'). Each data byte is treated as
-eight 1-bit elements, with bit ordering determined by
-`GL_UNPACK_LSB_FIRST' (see `glPixelStore').
+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
+`GL_BITMAP', the data is considered as a string of unsigned bytes (and
+FORMAT must be `GL_COLOR_INDEX'). Each data byte is treated as eight
+1-bit elements, with bit ordering determined by `GL_UNPACK_LSB_FIRST'
+(see `glPixelStore').
If a non-zero named buffer object is bound to the
`GL_PIXEL_UNPACK_BUFFER' target (see `glBindBuffer') while a texture
object's data store.
The first element corresponds to the lower left corner of the texture
-image. Subsequent elements progress left-to-right through the remaining
+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
+higher rows of the texture image. The final element corresponds to the
upper right corner of the texture image.
-FORMAT determines the composition of each element in DATA. It can
-assume one of these symbolic values:
+FORMAT determines the composition of each element in DATA. It can assume
+one of these symbolic values:
`GL_COLOR_INDEX'
- Each element is a single value, a color index. The GL converts it
+ 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 `GL_INDEX_SHIFT', and added to `GL_INDEX_OFFSET'
- (see `glPixelTransfer'). The resulting index is converted to a set
+ (see `glPixelTransfer'). The resulting index is converted to a set
of color components using the `GL_PIXEL_MAP_I_TO_R',
`GL_PIXEL_MAP_I_TO_G', `GL_PIXEL_MAP_I_TO_B', and
`GL_PIXEL_MAP_I_TO_A' tables, and clamped to the range [0,1].
`GL_RED'
- Each element is a single red component. The GL converts it to
+ 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
+ for green and blue, and 1 for alpha. Each component is then
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_GREEN'
- Each element is a single green component. The GL converts it to
+ 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
+ for red and blue, and 1 for alpha. Each component is then
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_BLUE'
- Each element is a single blue component. The GL converts it to
+ 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
+ for red and green, and 1 for alpha. Each component is then
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_ALPHA'
- Each element is a single alpha component. The GL converts it to
+ 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
+ for red, green, and blue. Each component is then multiplied by the
signed scale factor `GL_c_SCALE', added to the signed bias
`GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_INTENSITY'
- Each element is a single intensity value. The GL converts it to
+ Each element is a single intensity value. The GL converts it to
floating point, then assembles it into an RGBA element by
replicating the intensity value three times for red, green, blue,
- and alpha. Each component is then multiplied by the signed scale
+ and alpha. Each component is then multiplied by the signed scale
factor `GL_c_SCALE', added to the signed bias `GL_c_BIAS', and
clamped to the range [0,1] (see `glPixelTransfer').
`GL_RGB'
`GL_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 `GL_c_SCALE', added to the signed bias `GL_c_BIAS', and
- clamped to the range [0,1] (see `glPixelTransfer').
+ 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
+ `GL_c_SCALE', added to the signed bias `GL_c_BIAS', and clamped to
+ the range [0,1] (see `glPixelTransfer').
`GL_RGBA'
`GL_BGRA'
- Each element contains all four components. Each component is
+ Each element contains all four components. Each component is
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_LUMINANCE'
- Each element is a single luminance value. The GL converts it to
+ 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
+ blue and attaching 1 for alpha. Each component is then multiplied
by the signed scale factor `GL_c_SCALE', added to the signed bias
`GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_LUMINANCE_ALPHA'
- Each element is a luminance/alpha pair. The GL converts it to
+ 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
+ blue. Each component is then multiplied by the signed scale factor
`GL_c_SCALE', added to the signed bias `GL_c_BIAS', and clamped to
the range [0,1] (see `glPixelTransfer').
`GL_DEPTH_COMPONENT'
- Each element is a single depth value. The GL converts it to
+ Each element is a single depth value. The GL converts it to
floating point, multiplies by the signed scale factor
`GL_DEPTH_SCALE', adds the signed bias `GL_DEPTH_BIAS', and clamps
to the range [0,1] (see `glPixelTransfer').
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
+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 `GL_LUMINANCE',
-`GL_LUMINANCE_ALPHA', `GL_RGB', and `GL_RGBA' must match exactly. The
+match exactly. (The representations specified by `GL_LUMINANCE',
+`GL_LUMINANCE_ALPHA', `GL_RGB', and `GL_RGBA' must match exactly. The
numeric values 1, 2, 3, and 4 may also be used to specify the above
representations.)
`GL_COMPRESSED_LUMINANCE', `GL_COMPRESSED_LUMINANCE_ALPHA',
`GL_COMPRESSED_RGB', or `GL_COMPRESSED_RGBA', the GL will replace the
internal format with the symbolic constant for a specific internal
-format and compress the texture before storage. If no corresponding
+format and compress the texture before storage. If no corresponding
internal format is available, or the GL can not compress that image for
any reason, the internal format is instead replaced with a corresponding
base internal format.
`GL_SRGB_ALPHA', `GL_SRGB8_ALPHA8', `GL_SLUMINANCE', `GL_SLUMINANCE8',
`GL_SLUMINANCE_ALPHA', or `GL_SLUMINANCE8_ALPHA8', the texture is
treated as if the red, green, blue, or luminance components are encoded
-in the sRGB color space. Any alpha component is left unchanged. The
+in the sRGB color space. Any alpha component is left unchanged. The
conversion from the sRGB encoded component C_S to a linear component C_L
is:
Assume C_S is the sRGB component in the range [0,1].
Use the `GL_PROXY_TEXTURE_2D' or `GL_PROXY_TEXTURE_CUBE_MAP' target to
-try out a resolution and format. The implementation will update and
+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 `glGetTexLevelParameter'. If
-the texture cannot be accommodated, texture state is set to 0.
+format. To then query this state, call `glGetTexLevelParameter'. If the
+texture cannot be accommodated, texture state is set to 0.
A one-component texture image uses only the red component of the RGBA
-color extracted from DATA. A two-component image uses the R and A
-values. A three-component image uses the R, G, and B values. A
+color extracted from DATA. 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.
Depth textures can be treated as LUMINANCE, INTENSITY or ALPHA textures
-during texture filtering and application. \xa0Image-based shadowing\xa0can\xa0be
+during texture filtering and application.\xa0Image-based shadowing\xa0can\xa0be
\xa0enabled\xa0by\xa0comparing texture r coordinates to depth texture values to
-generate a boolean result. See `glTexParameter' for details on texture
+generate a boolean result. See `glTexParameter' for details on texture
comparison.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_TEXTURE_2D',
"Specify a three-dimensional texture image.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_3D' or
+ Specifies the target texture. Must be `GL_TEXTURE_3D' or
`GL_PROXY_TEXTURE_3D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the N^TH mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the N^TH mipmap reduction image.
INTERNALFORMAT
- Specifies the number of color components in the texture. Must be
- 1, 2, 3, or 4, or one of the following symbolic constants:
- `GL_ALPHA', `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16',
+ Specifies the number of color components in the texture. Must be 1,
+ 2, 3, or 4, or one of the following symbolic constants: `GL_ALPHA',
+ `GL_ALPHA4', `GL_ALPHA8', `GL_ALPHA12', `GL_ALPHA16',
`GL_COMPRESSED_ALPHA', `GL_COMPRESSED_LUMINANCE',
`GL_COMPRESSED_LUMINANCE_ALPHA', `GL_COMPRESSED_INTENSITY',
`GL_COMPRESSED_RGB', `GL_COMPRESSED_RGBA', `GL_LUMINANCE',
WIDTH
Specifies the width of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^N+2\u2061(BORDER,) for some integer N . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^N+2\u2061(BORDER,) for some integer N . All
implementations support 3D texture images that are at least 16
texels wide.
HEIGHT
Specifies the height of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^M+2\u2061(BORDER,) for some integer M . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^M+2\u2061(BORDER,) for some integer M . All
implementations support 3D texture images that are at least 16
texels high.
DEPTH
Specifies the depth of the texture image including the border if
- any. If the GL version does not support non-power-of-two sizes,
- this value must be 2^K+2\u2061(BORDER,) for some integer K . All
+ any. If the GL version does not support non-power-of-two sizes,
+ this value must be 2^K+2\u2061(BORDER,) for some integer K . All
implementations support 3D texture images that are at least 16
texels deep.
BORDER
- Specifies the width of the border. Must be either 0 or 1.
+ Specifies the width of the border. Must be either 0 or 1.
FORMAT
- Specifies the format of the pixel data. The following symbolic
+ Specifies the format of the pixel data. The following symbolic
values are accepted: `GL_COLOR_INDEX', `GL_RED', `GL_GREEN',
`GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', `GL_BGRA',
`GL_LUMINANCE', and `GL_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type of the pixel data. The following symbolic
+ Specifies the data type of the pixel data. The following symbolic
values are accepted: `GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP',
`GL_UNSIGNED_SHORT', `GL_SHORT', `GL_UNSIGNED_INT', `GL_INT',
`GL_FLOAT', `GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call `glEnable' and `glDisable'
with argument `GL_TEXTURE_3D'.
-To define texture images, call `glTexImage3D'. The arguments describe
+To define texture images, call `glTexImage3D'. The arguments describe
the parameters of the texture image, such as height, width, depth, width
of the border, level-of-detail number (see `glTexParameter'), and number
-of color components provided. The last three arguments describe how the
+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 `glDrawPixels'.
If TARGET is `GL_PROXY_TEXTURE_3D', no data is read from DATA, 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
-`glGetError'). To query for an entire mipmap array, use an image array
-level greater than or equal to 1.
+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 `glGetError').
+To query for an entire mipmap array, use an image array level greater
+than or equal to 1.
If TARGET is `GL_TEXTURE_3D', data is read from DATA 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
+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 `GL_BITMAP', the data is considered as a string of
-unsigned bytes (and FORMAT must be `GL_COLOR_INDEX'). Each data byte is
+elements. If TYPE is `GL_BITMAP', the data is considered as a string of
+unsigned bytes (and FORMAT must be `GL_COLOR_INDEX'). Each data byte is
treated as eight 1-bit elements, with bit ordering determined by
`GL_UNPACK_LSB_FIRST' (see `glPixelStore').
object's data store.
The first element corresponds to the lower left corner of the texture
-image. Subsequent elements progress left-to-right through the remaining
+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
+higher rows of the texture image. The final element corresponds to the
upper right corner of the texture image.
-FORMAT determines the composition of each element in DATA. It can
-assume one of these symbolic values:
+FORMAT determines the composition of each element in DATA. It can assume
+one of these symbolic values:
`GL_COLOR_INDEX'
- Each element is a single value, a color index. The GL converts it
+ 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 `GL_INDEX_SHIFT', and added to `GL_INDEX_OFFSET'
- (see `glPixelTransfer'). The resulting index is converted to a set
+ (see `glPixelTransfer'). The resulting index is converted to a set
of color components using the `GL_PIXEL_MAP_I_TO_R',
`GL_PIXEL_MAP_I_TO_G', `GL_PIXEL_MAP_I_TO_B', and
`GL_PIXEL_MAP_I_TO_A' tables, and clamped to the range [0,1].
`GL_RED'
- Each element is a single red component. The GL converts it to
+ 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
+ for green and blue, and 1 for alpha. Each component is then
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_GREEN'
- Each element is a single green component. The GL converts it to
+ 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
+ for red and blue, and 1 for alpha. Each component is then
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_BLUE'
- Each element is a single blue component. The GL converts it to
+ 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
+ for red and green, and 1 for alpha. Each component is then
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_ALPHA'
- Each element is a single alpha component. The GL converts it to
+ 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
+ for red, green, and blue. Each component is then multiplied by the
signed scale factor `GL_c_SCALE', added to the signed bias
`GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_INTENSITY'
- Each element is a single intensity value. The GL converts it to
+ Each element is a single intensity value. The GL converts it to
floating point, then assembles it into an RGBA element by
replicating the intensity value three times for red, green, blue,
- and alpha. Each component is then multiplied by the signed scale
+ and alpha. Each component is then multiplied by the signed scale
factor `GL_c_SCALE', added to the signed bias `GL_c_BIAS', and
clamped to the range [0,1] (see `glPixelTransfer').
`GL_RGB'
`GL_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 `GL_c_SCALE', added to the signed bias `GL_c_BIAS', and
- clamped to the range [0,1] (see `glPixelTransfer').
+ 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
+ `GL_c_SCALE', added to the signed bias `GL_c_BIAS', and clamped to
+ the range [0,1] (see `glPixelTransfer').
`GL_RGBA'
`GL_BGRA'
- Each element contains all four components. Each component is
+ Each element contains all four components. Each component is
multiplied by the signed scale factor `GL_c_SCALE', added to the
signed bias `GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_LUMINANCE'
- Each element is a single luminance value. The GL converts it to
+ 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
+ blue and attaching 1 for alpha. Each component is then multiplied
by the signed scale factor `GL_c_SCALE', added to the signed bias
`GL_c_BIAS', and clamped to the range [0,1] (see
`glPixelTransfer').
`GL_LUMINANCE_ALPHA'
- Each element is a luminance/alpha pair. The GL converts it to
+ 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
+ blue. Each component is then multiplied by the signed scale factor
`GL_c_SCALE', added to the signed bias `GL_c_BIAS', and clamped to
the range [0,1] (see `glPixelTransfer').
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
+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 `GL_LUMINANCE',
-`GL_LUMINANCE_ALPHA', `GL_RGB', and `GL_RGBA' must match exactly. The
+match exactly. (The representations specified by `GL_LUMINANCE',
+`GL_LUMINANCE_ALPHA', `GL_RGB', and `GL_RGBA' must match exactly. The
numeric values 1, 2, 3, and 4 may also be used to specify the above
representations.)
`GL_COMPRESSED_LUMINANCE', `GL_COMPRESSED_LUMINANCE_ALPHA',
`GL_COMPRESSED_RGB', or `GL_COMPRESSED_RGBA', the GL will replace the
internal format with the symbolic constant for a specific internal
-format and compress the texture before storage. If no corresponding
+format and compress the texture before storage. If no corresponding
internal format is available, or the GL can not compress that image for
any reason, the internal format is instead replaced with a corresponding
base internal format.
`GL_SRGB_ALPHA', `GL_SRGB8_ALPHA8', `GL_SLUMINANCE', `GL_SLUMINANCE8',
`GL_SLUMINANCE_ALPHA', or `GL_SLUMINANCE8_ALPHA8', the texture is
treated as if the red, green, blue, or luminance components are encoded
-in the sRGB color space. Any alpha component is left unchanged. The
+in the sRGB color space. Any alpha component is left unchanged. The
conversion from the sRGB encoded component C_S to a linear component C_L
is:
Use the `GL_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
-`glGetTexLevelParameter'. If the texture cannot be accommodated,
-texture state is set to 0.
+requested storage resolution and format. To then query this state, call
+`glGetTexLevelParameter'. If the texture cannot be accommodated, texture
+state is set to 0.
A one-component texture image uses only the red component of the RGBA
-color extracted from DATA. A two-component image uses the R and A
-values. A three-component image uses the R, G, and B values. A
+color extracted from DATA. 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.
`GL_INVALID_ENUM' is generated if TARGET is not `GL_TEXTURE_3D' or
`GL_PROXY_TEXTURE_3D'.
`GL_INVALID_ENUM' is generated if FORMAT is not an accepted format
-constant. Format constants other than `GL_STENCIL_INDEX' and
+constant. Format constants other than `GL_STENCIL_INDEX' and
`GL_DEPTH_COMPONENT' are accepted.
`GL_INVALID_ENUM' is generated if TYPE is not a type constant.
Specifies the value of PNAME.
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
+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.
`glTexParameter' assigns the value or values in PARAMS to the texture
-parameter specified as PNAME. TARGET defines the target texture, either
-`GL_TEXTURE_1D', `GL_TEXTURE_2D', or `GL_TEXTURE_3D'. The following
+parameter specified as PNAME. TARGET defines the target texture, either
+`GL_TEXTURE_1D', `GL_TEXTURE_2D', or `GL_TEXTURE_3D'. The following
symbols are accepted in PNAME:
`GL_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
+ 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.
A mipmap is an ordered set of arrays representing the same image at
- progressively lower resolutions. If the texture has dimensions
- 2^N×2^M , there are MAX\u2061(N,M)+1 mipmaps. The first mipmap is the
- original texture, with dimensions 2^N×2^M . Each subsequent mipmap
+ progressively lower resolutions. If the texture has dimensions
+ 2^N×2^M , there are MAX\u2061(N,M)+1 mipmaps. The first mipmap is the
+ original texture, with dimensions 2^N×2^M . Each subsequent mipmap
has dimensions 2^K-1,×2^L-1, , where 2^K×2^L are the dimensions of
- the previous mipmap, until either K=0 or L=0 . At that point,
+ the previous mipmap, until either K=0 or L=0 . At that point,
subsequent mipmaps have dimension 1×2^L-1, or 2^K-1,×1 until the
- final mipmap, which has dimension 1×1 . To define the mipmaps,
- call `glTexImage1D', `glTexImage2D', `glTexImage3D',
- `glCopyTexImage1D', or `glCopyTexImage2D' with the LEVEL argument
- indicating the order of the mipmaps. Level 0 is the original
- texture; level MAX\u2061(N,M) is the final 1×1 mipmap.
+ final mipmap, which has dimension 1×1 . To define the mipmaps, call
+ `glTexImage1D', `glTexImage2D', `glTexImage3D', `glCopyTexImage1D',
+ or `glCopyTexImage2D' with the LEVEL argument indicating the order
+ of the mipmaps. Level 0 is the original texture; level MAX\u2061(N,M) is
+ the final 1×1 mipmap.
PARAMS supplies a function for minifying the texture as one of the
following:
As more texture elements are sampled in the minification process,
- fewer aliasing artifacts will be apparent. While the `GL_NEAREST'
+ fewer aliasing artifacts will be apparent. While the `GL_NEAREST'
and `GL_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
+ patterns or ragged transitions. The initial value of
`GL_TEXTURE_MIN_FILTER' is `GL_NEAREST_MIPMAP_LINEAR'.
`GL_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 `GL_NEAREST'
- or `GL_LINEAR' (see below). `GL_NEAREST' is generally faster than
+ or `GL_LINEAR' (see below). `GL_NEAREST' is generally faster than
`GL_LINEAR', but it can produce textured images with sharper edges
because the transition between texture elements is not as smooth.
The initial value of `GL_TEXTURE_MAG_FILTER' is `GL_LINEAR'.
`GL_LINEAR'
Returns the weighted average of the four texture elements that are
- closest to the center of the pixel being textured. These can
+ closest to the center of the pixel being textured. These can
include border texture elements, depending on the values of
`GL_TEXTURE_WRAP_S' and `GL_TEXTURE_WRAP_T', and on the exact
mapping.
Chooses the two mipmaps that most closely match the size of the
pixel being textured and uses the `GL_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
+ texture value from each mipmap. The final texture value is a
weighted average of those two values.
`GL_LINEAR_MIPMAP_LINEAR'
Chooses the two mipmaps that most closely match the size of the
pixel being textured and uses the `GL_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
+ of the pixel) to produce a texture value from each mipmap. The
final texture value is a weighted average of those two values.
`GL_NEAREST'
`GL_LINEAR'
Returns the weighted average of the four texture elements that are
- closest to the center of the pixel being textured. These can
+ closest to the center of the pixel being textured. These can
include border texture elements, depending on the values of
`GL_TEXTURE_WRAP_S' and `GL_TEXTURE_WRAP_T', and on the exact
mapping.
`GL_TEXTURE_MIN_LOD'
- Sets the minimum level-of-detail parameter. This floating-point
+ 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.
+ mipmap level). The initial value is -1000.
`GL_TEXTURE_MAX_LOD'
- Sets the maximum level-of-detail parameter. This floating-point
+ 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.
+ mipmap level). The initial value is 1000.
`GL_TEXTURE_BASE_LEVEL'
- Specifies the index of the lowest defined mipmap level. This is an
- integer value. The initial value is 0.
+ Specifies the index of the lowest defined mipmap level. This is an
+ integer value. The initial value is 0.
`GL_TEXTURE_MAX_LEVEL'
- Sets the index of the highest defined mipmap level. This is an
- integer value. The initial value is 1000.
+ Sets the index of the highest defined mipmap level. This is an
+ integer value. The initial value is 1000.
`GL_TEXTURE_WRAP_S'
Sets the wrap parameter for texture coordinate S to either
`GL_CLAMP', `GL_CLAMP_TO_BORDER', `GL_CLAMP_TO_EDGE',
- `GL_MIRRORED_REPEAT', or `GL_REPEAT'. `GL_CLAMP' causes S
+ `GL_MIRRORED_REPEAT', or `GL_REPEAT'. `GL_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. `GL_CLAMP_TO_BORDER' causes the S coordinate to be clamped
+ object. `GL_CLAMP_TO_BORDER' causes the S coordinate to be clamped
to the range [-1/2N,,1+1/2N,] , where N is the size of the texture
in the direction of clamping.`GL_CLAMP_TO_EDGE' causes S
coordinates to be clamped to the range [1/2N,,1-1/2N,] , where N is
- the size of the texture in the direction of clamping. `GL_REPEAT'
+ the size of the texture in the direction of clamping. `GL_REPEAT'
causes the integer part of the S coordinate to be ignored; the GL
uses only the fractional part, thereby creating a repeating
- pattern. `GL_MIRRORED_REPEAT' causes the S coordinate to be set to
+ pattern. `GL_MIRRORED_REPEAT' causes the S coordinate to be set to
the fractional part of the texture coordinate if the integer part
of S is even; if the integer part of S is odd, then the S texture
coordinate is set to 1-FRAC\u2061(S,) , where FRAC\u2061(S,) represents the
- fractional part of S . Border texture elements are accessed only
- if wrapping is set to `GL_CLAMP' or `GL_CLAMP_TO_BORDER'.
- Initially, `GL_TEXTURE_WRAP_S' is set to `GL_REPEAT'.
+ fractional part of S . Border texture elements are accessed only if
+ wrapping is set to `GL_CLAMP' or `GL_CLAMP_TO_BORDER'. Initially,
+ `GL_TEXTURE_WRAP_S' is set to `GL_REPEAT'.
`GL_TEXTURE_WRAP_T'
Sets the wrap parameter for texture coordinate T to either
`GL_CLAMP', `GL_CLAMP_TO_BORDER', `GL_CLAMP_TO_EDGE',
- `GL_MIRRORED_REPEAT', or `GL_REPEAT'. See the discussion under
- `GL_TEXTURE_WRAP_S'. Initially, `GL_TEXTURE_WRAP_T' is set to
+ `GL_MIRRORED_REPEAT', or `GL_REPEAT'. See the discussion under
+ `GL_TEXTURE_WRAP_S'. Initially, `GL_TEXTURE_WRAP_T' is set to
`GL_REPEAT'.
`GL_TEXTURE_WRAP_R'
Sets the wrap parameter for texture coordinate R to either
`GL_CLAMP', `GL_CLAMP_TO_BORDER', `GL_CLAMP_TO_EDGE',
- `GL_MIRRORED_REPEAT', or `GL_REPEAT'. See the discussion under
- `GL_TEXTURE_WRAP_S'. Initially, `GL_TEXTURE_WRAP_R' is set to
+ `GL_MIRRORED_REPEAT', or `GL_REPEAT'. See the discussion under
+ `GL_TEXTURE_WRAP_S'. Initially, `GL_TEXTURE_WRAP_R' is set to
`GL_REPEAT'.
`GL_TEXTURE_BORDER_COLOR'
- Sets a border color. PARAMS contains four values that comprise the
- RGBA color of the texture border. Integer color components are
+ Sets a border color. PARAMS 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
+ 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).
`GL_TEXTURE_PRIORITY'
Specifies the texture residence priority of the currently bound
- texture. Permissible values are in the range [0,1] . See
+ texture. Permissible values are in the range [0,1] . See
`glPrioritizeTextures' and `glBindTexture' for more information.
`GL_TEXTURE_COMPARE_MODE'
Specifies the texture comparison mode for currently bound depth
- textures. That is, a texture whose internal format is
+ textures. That is, a texture whose internal format is
`GL_DEPTH_COMPONENT_*'; see `glTexImage2D') Permissible values are:
`GL_TEXTURE_COMPARE_FUNC'
`GL_TEXTURE_COMPARE_MODE' is set to `GL_COMPARE_R_TO_TEXTURE'.
Permissible values are: where R is the current interpolated texture
coordinate, and D_T is the depth texture value sampled from the
- currently bound depth texture. RESULT is assigned to the either
- the luminance, intensity, or alpha (as specified by
+ currently bound depth texture. RESULT is assigned to the either the
+ luminance, intensity, or alpha (as specified by
`GL_DEPTH_TEXTURE_MODE'.)
`GL_DEPTH_TEXTURE_MODE'
`GL_GENERATE_MIPMAP'
Specifies a boolean value that indicates if all levels of a mipmap
array should be automatically updated when any modification to the
- base level mipmap is done. The initial value is `GL_FALSE'.
+ base level mipmap is done. The initial value is `GL_FALSE'.
`GL_COMPARE_R_TO_TEXTURE'
Specifies that the interpolated and clamped R texture coordinate
should be compared to the value in the currently bound depth
- texture. See the discussion of `GL_TEXTURE_COMPARE_FUNC' for
- details of how the comparison is evaluated. The result of the
+ texture. See the discussion of `GL_TEXTURE_COMPARE_FUNC' for
+ details of how the comparison is evaluated. The result of the
comparison is assigned to luminance, intensity, or alpha (as
specified by `GL_DEPTH_TEXTURE_MODE').
"Specify a one-dimensional texture subimage.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_1D'.
+ Specifies the target texture. Must be `GL_TEXTURE_1D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
Specifies the width of the texture subimage.
FORMAT
- Specifies the format of the pixel data. The following symbolic
+ Specifies the format of the pixel data. The following symbolic
values are accepted: `GL_COLOR_INDEX', `GL_RED', `GL_GREEN',
`GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', `GL_BGRA',
`GL_LUMINANCE', and `GL_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type of the pixel data. The following symbolic
+ Specifies the data type of the pixel data. The following symbolic
values are accepted: `GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP',
`GL_UNSIGNED_SHORT', `GL_SHORT', `GL_UNSIGNED_INT', `GL_INT',
`GL_FLOAT', `GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
Specifies a pointer to the image data in memory.
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 `glEnable' and `glDisable' with
-argument `GL_TEXTURE_1D'.
+graphical primitive for which texturing is enabled. To enable or disable
+one-dimensional texturing, call `glEnable' and `glDisable' with argument
+`GL_TEXTURE_1D'.
`glTexSubImage1D' redefines a contiguous subregion of an existing
-one-dimensional texture image. The texels referenced by DATA replace
-the portion of the existing texture array with x indices XOFFSET and
-XOFFSET+WIDTH-1 , inclusive. This region may not include any texels
+one-dimensional texture image. The texels referenced by DATA replace the
+portion of the existing texture array with x indices XOFFSET and
+XOFFSET+WIDTH-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.
`GL_INVALID_VALUE' is generated if XOFFSET<-B , or if
(XOFFSET+WIDTH,)>(W-B,) , where W is the `GL_TEXTURE_WIDTH', and B is
the width of the `GL_TEXTURE_BORDER' of the texture image being
-modified. Note that W includes twice the border width.
+modified. Note that W includes twice the border width.
`GL_INVALID_VALUE' is generated if WIDTH is less than 0.
"Specify a two-dimensional texture subimage.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_2D',
+ Specifies the target texture. Must be `GL_TEXTURE_2D',
`GL_TEXTURE_CUBE_MAP_POSITIVE_X', `GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
`GL_TEXTURE_CUBE_MAP_POSITIVE_Y', `GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
`GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
`GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
Specifies the height of the texture subimage.
FORMAT
- Specifies the format of the pixel data. The following symbolic
+ Specifies the format of the pixel data. The following symbolic
values are accepted: `GL_COLOR_INDEX', `GL_RED', `GL_GREEN',
`GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', `GL_BGRA',
`GL_LUMINANCE', and `GL_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type of the pixel data. The following symbolic
+ Specifies the data type of the pixel data. The following symbolic
values are accepted: `GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP',
`GL_UNSIGNED_SHORT', `GL_SHORT', `GL_UNSIGNED_INT', `GL_INT',
`GL_FLOAT', `GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call `glEnable' and `glDisable' with
argument `GL_TEXTURE_2D'.
`glTexSubImage2D' redefines a contiguous subregion of an existing
-two-dimensional texture image. The texels referenced by DATA replace
-the portion of the existing texture array with x indices XOFFSET and
+two-dimensional texture image. The texels referenced by DATA replace the
+portion of the existing texture array with x indices XOFFSET and
XOFFSET+WIDTH-1 , inclusive, and y indices YOFFSET and YOFFSET+HEIGHT-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.
+, 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.
If a non-zero named buffer object is bound to the
`GL_PIXEL_UNPACK_BUFFER' target (see `glBindBuffer') while a texture
`GL_INVALID_VALUE' is generated if XOFFSET<-B , (XOFFSET+WIDTH,)>(W-B,)
, YOFFSET<-B , or (YOFFSET+HEIGHT,)>(H-B,) , where W is the
`GL_TEXTURE_WIDTH', H is the `GL_TEXTURE_HEIGHT', and B is the border
-width of the texture image being modified. Note that W and H include
+width of the texture image being modified. Note that W and H include
twice the border width.
`GL_INVALID_VALUE' is generated if WIDTH or HEIGHT is less than 0.
"Specify a three-dimensional texture subimage.
TARGET
- Specifies the target texture. Must be `GL_TEXTURE_3D'.
+ Specifies the target texture. Must be `GL_TEXTURE_3D'.
LEVEL
- Specifies the level-of-detail number. Level 0 is the base image
- level. Level N is the Nth mipmap reduction image.
+ Specifies the level-of-detail number. Level 0 is the base image
+ level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
Specifies the depth of the texture subimage.
FORMAT
- Specifies the format of the pixel data. The following symbolic
+ Specifies the format of the pixel data. The following symbolic
values are accepted: `GL_COLOR_INDEX', `GL_RED', `GL_GREEN',
`GL_BLUE', `GL_ALPHA', `GL_RGB', `GL_BGR', `GL_RGBA', `GL_BGRA',
`GL_LUMINANCE', and `GL_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type of the pixel data. The following symbolic
+ Specifies the data type of the pixel data. The following symbolic
values are accepted: `GL_UNSIGNED_BYTE', `GL_BYTE', `GL_BITMAP',
`GL_UNSIGNED_SHORT', `GL_SHORT', `GL_UNSIGNED_INT', `GL_INT',
`GL_FLOAT', `GL_UNSIGNED_BYTE_3_3_2', `GL_UNSIGNED_BYTE_2_3_3_REV',
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
-graphical primitive for which texturing is enabled. To enable and
+graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call `glEnable' and `glDisable'
with argument `GL_TEXTURE_3D'.
`glTexSubImage3D' redefines a contiguous subregion of an existing
-three-dimensional texture image. The texels referenced by DATA replace
+three-dimensional texture image. The texels referenced by DATA replace
the portion of the existing texture array with x indices XOFFSET and
XOFFSET+WIDTH-1 , inclusive, y indices YOFFSET and YOFFSET+HEIGHT-1 ,
-inclusive, and z indices ZOFFSET and ZOFFSET+DEPTH-1 , inclusive. This
+inclusive, and z indices ZOFFSET and ZOFFSET+DEPTH-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
+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.
, YOFFSET<-B , or (YOFFSET+HEIGHT,)>(H-B,) , or ZOFFSET<-B , or
(ZOFFSET+DEPTH,)>(D-B,) , where W is the `GL_TEXTURE_WIDTH', H is the
`GL_TEXTURE_HEIGHT', D is the `GL_TEXTURE_DEPTH' and B is the border
-width of the texture image being modified. Note that W , H , and D
+width of the texture image being modified. Note that W , H , and D
include twice the border width.
`GL_INVALID_VALUE' is generated if WIDTH, HEIGHT, or DEPTH is less than
Specify the X, Y, and Z coordinates of a translation vector.
-`glTranslate' produces a translation by (X,YZ) . The current matrix
-(see `glMatrixMode') is multiplied by this translation matrix, with the
+`glTranslate' produces a translation by (X,YZ) . The current matrix (see
+`glMatrixMode') is multiplied by this translation matrix, with the
product replacing the current matrix, as if `glMultMatrix' were called
with the following matrix for its argument:
variable.
`glUniform' modifies the value of a uniform variable or a uniform
-variable array. The location of the uniform variable to be modified is
+variable array. The location of the uniform variable to be modified is
specified by LOCATION, which should be a value returned by
-`glGetUniformLocation'. `glUniform' operates on the program object that
+`glGetUniformLocation'. `glUniform' operates on the program object that
was made part of current state by calling `glUseProgram'.
The commands `glUniform{1|2|3|4}{f|i}' are used to change the value of
the uniform variable specified by LOCATION using the values passed as
-arguments. The number specified in the command should match the number
+arguments. The number specified in the command should match the number
of components in the data type of the specified uniform variable (e.g.,
-`1' for float, int, bool; `2' for vec2, ivec2, bvec2, etc.). The suffix
+`1' for float, int, bool; `2' for vec2, ivec2, bvec2, etc.). The suffix
`f' indicates that floating-point values are being passed; the suffix
`i' indicates that integer values are being passed, and this type should
-also match the data type of the specified uniform variable. The `i'
+also match the data type of the specified uniform variable. The `i'
variants of this function should be used to provide values for uniform
-variables defined as int, ivec2, ivec3, ivec4, or arrays of these. The
+variables defined as int, ivec2, ivec3, ivec4, or arrays of these. The
`f' variants should be used to provide values for uniform variables of
-type float, vec2, vec3, vec4, or arrays of these. Either the `i' or the
+type float, vec2, vec3, vec4, or arrays of these. Either the `i' or the
`f' variants may be used to provide values for uniform variables of type
-bool, bvec2, bvec3, bvec4, or arrays of these. The uniform variable
-will be set to false if the input value is 0 or 0.0f, and it will be set
-to true otherwise.
+bool, bvec2, bvec3, bvec4, or arrays of these. The uniform variable will
+be set to false if the input value is 0 or 0.0f, and it will be set to
+true otherwise.
All active uniform variables defined in a program object are initialized
-to 0 when the program object is linked successfully. They retain the
+to 0 when the program object is linked successfully. They retain the
values assigned to them by a call to `glUniform ' until the next
successful link operation occurs on the program object, when they are
once again initialized to 0.
The commands `glUniform{1|2|3|4}{f|i}v' can be used to modify a single
-uniform variable or a uniform variable array. These commands pass a
+uniform variable or a uniform variable array. These commands pass a
count and a pointer to the values to be loaded into a uniform variable
-or a uniform variable array. A count of 1 should be used if modifying
+or a uniform variable array. A count of 1 should be used if modifying
the value of a single uniform variable, and a count of 1 or greater can
-be used to modify an entire array or part of an array. When loading N
+be used to modify an entire array or part of an array. When loading N
elements starting at an arbitrary position M in a uniform variable
array, elements M + N - 1 in the array will be replaced with the new
-values. If M + N - 1 is larger than the size of the uniform variable
+values. If M + N - 1 is larger than the size of the uniform variable
array, values for all array elements beyond the end of the array will be
-ignored. The number specified in the name of the command indicates the
+ignored. The number specified in the name of the command indicates the
number of components for each element in VALUE, and it should match the
number of components in the data type of the specified uniform variable
-(e.g., `1' for float, int, bool; `2' for vec2, ivec2, bvec2, etc.). The
+(e.g., `1' for float, int, bool; `2' for vec2, ivec2, bvec2, etc.). The
data type specified in the name of the command must match the data type
for the specified uniform variable as described previously for
`glUniform{1|2|3|4}{f|i}'.
For uniform variable arrays, each element of the array is considered to
be of the type indicated in the name of the command (e.g., `glUniform3f'
or `glUniform3fv' can be used to load a uniform variable array of type
-vec3). The number of elements of the uniform variable array to be
+vec3). The number of elements of the uniform variable array to be
modified is specified by COUNT
The commands `glUniformMatrix{2|3|4|2x3|3x2|2x4|4x2|3x4|4x3}fv' are used
-to modify a matrix or an array of matrices. The numbers in the command
-name are interpreted as the dimensionality of the matrix. The number
-`2' indicates a 2 × 2 matrix (i.e., 4 values), the number `3' indicates
-a 3 × 3 matrix (i.e., 9 values), and the number `4' indicates a 4 × 4
-matrix (i.e., 16 values). Non-square matrix dimensionality is explicit,
-with the first number representing the number of columns and the second
-number representing the number of rows. For example, `2x4' indicates a
-2 × 4 matrix with 2 columns and 4 rows (i.e., 8 values). If TRANSPOSE
-is `GL_FALSE', each matrix is assumed to be supplied in column major
-order. If TRANSPOSE is `GL_TRUE', each matrix is assumed to be supplied
-in row major order. The COUNT argument indicates the number of matrices
-to be passed. A count of 1 should be used if modifying the value of a
-single matrix, and a count greater than 1 can be used to modify an array
-of matrices.
+to modify a matrix or an array of matrices. The numbers in the command
+name are interpreted as the dimensionality of the matrix. The number `2'
+indicates a 2 × 2 matrix (i.e., 4 values), the number `3' indicates a 3
+× 3 matrix (i.e., 9 values), and the number `4' indicates a 4 × 4 matrix
+(i.e., 16 values). Non-square matrix dimensionality is explicit, with
+the first number representing the number of columns and the second
+number representing the number of rows. For example, `2x4' indicates a 2
+× 4 matrix with 2 columns and 4 rows (i.e., 8 values). If TRANSPOSE is
+`GL_FALSE', each matrix is assumed to be supplied in column major order.
+If TRANSPOSE is `GL_TRUE', each matrix is assumed to be supplied in row
+major order. The COUNT argument indicates the number of matrices to be
+passed. A count of 1 should be used if modifying the value of a single
+matrix, and a count greater than 1 can be used to modify an array of
+matrices.
`GL_INVALID_OPERATION' is generated if there is no current program
object.
be used as part of current rendering state.
`glUseProgram' installs the program object specified by PROGRAM as part
-of current rendering state. One or more executables are created in a
+of current rendering state. One or more executables are created in a
program object by successfully attaching shader objects to it with
`glAttachShader', successfully compiling the shader objects with
`glCompileShader', and successfully linking the program object with
The executable that is installed on the vertex processor is expected to
implement any or all of the desired functionality from the preceding
-list. Similarly, if an executable is installed on the fragment
+list. Similarly, if an executable is installed on the fragment
processor, the OpenGL fixed functionality will be disabled as follows.
* Texture application is not applied.
While a program object is in use, applications are free to modify
attached shader objects, compile attached shader objects, attach
-additional shader objects, and detach or delete shader objects. None of
+additional shader objects, and detach or delete shader objects. None of
these operations will affect the executables that are part of the
-current state. However, relinking the program object that is currently
+current state. However, relinking the program object that is currently
in use will install the program object as part of the current rendering
-state if the link operation was successful (see `glLinkProgram' ). If
+state if the link operation was successful (see `glLinkProgram' ). If
the program object currently in use is relinked unsuccessfully, its link
status will be set to `GL_FALSE', but the executables and associated
state will remain part of the current state until a subsequent call to
-`glUseProgram' removes it from use. After it is removed from use, it
+`glUseProgram' removes it from use. After it is removed from use, it
cannot be made part of current state until it has been successfully
relinked.
If PROGRAM contains shader objects of type `GL_VERTEX_SHADER' but it
does not contain shader objects of type `GL_FRAGMENT_SHADER', an
executable will be installed on the vertex processor, but fixed
-functionality will be used for fragment processing. Similarly, if
+functionality will be used for fragment processing. Similarly, if
PROGRAM contains shader objects of type `GL_FRAGMENT_SHADER' but it does
not contain shader objects of type `GL_VERTEX_SHADER', an executable
will be installed on the fragment processor, but fixed functionality
-will be used for vertex processing. If PROGRAM is 0, the programmable
+will be used for vertex processing. If PROGRAM is 0, the programmable
processors will be disabled, and fixed functionality will be used for
both vertex and fragment processing.
Specifies the handle of the program object to be validated.
`glValidateProgram' checks to see whether the executables contained in
-PROGRAM can execute given the current OpenGL state. The information
+PROGRAM can execute given the current OpenGL state. The information
generated by the validation process will be stored in PROGRAM's
-information log. The validation information may consist of an empty
+information log. The validation information may consist of an empty
string, or it may be a string containing information about how the
current program object interacts with the rest of current OpenGL state.
This provides a way for OpenGL implementers to convey more information
execute, and so on.
The status of the validation operation will be stored as part of the
-program object's state. This value will be set to `GL_TRUE' if the
-validation succeeded, and `GL_FALSE' otherwise. It can be queried by
+program object's state. This value will be set to `GL_TRUE' if the
+validation succeeded, and `GL_FALSE' otherwise. It can be queried by
calling `glGetProgram' with arguments PROGRAM and `GL_VALIDATE_STATUS'.
If validation is successful, PROGRAM is guaranteed to execute given the
-current state. Otherwise, PROGRAM is guaranteed to not execute.
+current state. Otherwise, PROGRAM is guaranteed to not execute.
This function is typically useful only during application development.
The informational string stored in the information log is completely
SIZE
Specifies the number of components per generic vertex attribute.
- Must be 1, 2, 3, or 4. The initial value is 4.
+ Must be 1, 2, 3, or 4. The initial value is 4.
TYPE
- Specifies the data type of each component in the array. Symbolic
+ Specifies the data type of each component in the array. Symbolic
constants `GL_BYTE', `GL_UNSIGNED_BYTE', `GL_SHORT',
`GL_UNSIGNED_SHORT', `GL_INT', `GL_UNSIGNED_INT', `GL_FLOAT', or
- `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
+ `GL_DOUBLE' are accepted. The initial value is `GL_FLOAT'.
NORMALIZED
Specifies whether fixed-point data values should be normalized
STRIDE
Specifies the byte offset between consecutive generic vertex
- attributes. If STRIDE is 0, the generic vertex attributes are
- understood to be tightly packed in the array. The initial value is
+ attributes. If STRIDE is 0, the generic vertex attributes are
+ understood to be tightly packed in the array. The initial value is
0.
POINTER
Specifies a pointer to the first component of the first generic
- vertex attribute in the array. The initial value is 0.
+ vertex attribute in the array. The initial value is 0.
`glVertexAttribPointer' specifies the location and data format of the
array of generic vertex attributes at index INDEX to use when rendering.
SIZE specifies the number of components per attribute and must be 1, 2,
-3, or 4. TYPE specifies the data type of each component, and STRIDE
+3, or 4. TYPE specifies the data type of each component, and STRIDE
specifies the byte stride from one attribute to the next, allowing
vertices and attributes to be packed into a single array or stored in
-separate arrays. If set to `GL_TRUE', NORMALIZED indicates that values
+separate arrays. If set to `GL_TRUE', NORMALIZED indicates that values
stored in an integer format are to be mapped to the range [-1,1] (for
signed values) or [0,1] (for unsigned values) when they are accessed and
-converted to floating point. Otherwise, values will be converted to
+converted to floating point. Otherwise, values will be converted to
floats directly without normalization.
If a non-zero named buffer object is bound to the `GL_ARRAY_BUFFER'
target (see `glBindBuffer') while a generic vertex attribute array is
specified, POINTER is treated as a byte offset into the buffer object's
-data store. Also, the buffer object binding (`GL_ARRAY_BUFFER_BINDING')
+data store. Also, the buffer object binding (`GL_ARRAY_BUFFER_BINDING')
is saved as generic vertex attribute array client-side state
(`GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING') for index INDEX.
OpenGL defines a number of standard vertex attributes that applications
can modify with standard API entry points (color, normal, texture
-coordinates, etc.). The `glVertexAttrib' family of entry points allows
+coordinates, etc.). The `glVertexAttrib' family of entry points allows
an application to pass generic vertex attributes in numbered locations.
Generic attributes are defined as four-component values that are
-organized into an array. The first entry of this array is numbered 0,
+organized into an array. The first entry of this array is numbered 0,
and the size of the array is specified by the implementation-dependent
-constant `GL_MAX_VERTEX_ATTRIBS'. Individual elements of this array can
+constant `GL_MAX_VERTEX_ATTRIBS'. Individual elements of this array can
be modified with a `glVertexAttrib' call that specifies the index of the
element to be modified and a value for that element.
These commands can be used to specify one, two, three, or all four
-components of the generic vertex attribute specified by INDEX. A `1' in
+components of the generic vertex attribute specified by INDEX. A `1' in
the name of the command indicates that only one value is passed, and it
will be used to modify the first component of the generic vertex
-attribute. The second and third components will be set to 0, and the
-fourth component will be set to 1. Similarly, a `2' in the name of the
+attribute. The second and third components will be set to 0, and the
+fourth component will be set to 1. Similarly, a `2' in the name of the
command indicates that values are provided for the first two components,
the third component will be set to 0, and the fourth component will be
-set to 1. A `3' in the name of the command indicates that values are
+set to 1. A `3' in the name of the command indicates that values are
provided for the first three components and the fourth component will be
set to 1, whereas a `4' in the name indicates that values are provided
for all four components.
The letters `s', `f', `i', `d', `ub', `us', and `ui' indicate whether
the arguments are of type short, float, int, double, unsigned byte,
-unsigned short, or unsigned int. When `v' is appended to the name, the
-commands can take a pointer to an array of such values. The commands
+unsigned short, or unsigned int. When `v' is appended to the name, the
+commands can take a pointer to an array of such values. The commands
containing `N' indicate that the arguments will be passed as fixed-point
values that are scaled to a normalized range according to the component
-conversion rules defined by the OpenGL specification. Signed values are
+conversion rules defined by the OpenGL specification. Signed values are
understood to represent fixed-point values in the range [-1,1], and
unsigned values are understood to represent fixed-point values in the
range [0,1].
OpenGL Shading Language attribute variables are allowed to be of type
-mat2, mat3, or mat4. Attributes of these types may be loaded using the
-`glVertexAttrib' entry points. Matrices must be loaded into successive
+mat2, mat3, or mat4. Attributes of these types may be loaded using the
+`glVertexAttrib' entry points. Matrices must be loaded into successive
generic attribute slots in column major order, with one column of the
matrix in each generic attribute slot.
A user-defined attribute variable declared in a vertex shader can be
bound to a generic attribute index by calling `glBindAttribLocation'.
This allows an application to use more descriptive variable names in a
-vertex shader. A subsequent change to the specified generic vertex
+vertex shader. A subsequent change to the specified generic vertex
attribute will be immediately reflected as a change to the corresponding
attribute variable in the vertex shader.
different program object is used.
An application may freely modify generic vertex attributes that are not
-bound to a named vertex shader attribute variable. These values are
+bound to a named vertex shader attribute variable. These values are
simply maintained as part of current state and will not be accessed by
-the vertex shader. If a generic vertex attribute bound to an attribute
+the vertex shader. If a generic vertex attribute bound to an attribute
variable in a vertex shader is not updated while the vertex shader is
executing, the vertex shader will repeatedly use the current value for
the generic vertex attribute.
The generic vertex attribute with index 0 is the same as the vertex
-position attribute previously defined by OpenGL. A `glVertex2',
+position attribute previously defined by OpenGL. A `glVertex2',
`glVertex3', or `glVertex4' command is completely equivalent to the
-corresponding `glVertexAttrib' command with an index argument of 0. A
+corresponding `glVertexAttrib' command with an index argument of 0. A
vertex shader can access generic vertex attribute 0 by using the
-built-in attribute variable GL_VERTEX. There are no current values for
-generic vertex attribute 0. This is the only generic vertex attribute
+built-in attribute variable GL_VERTEX. There are no current values for
+generic vertex attribute 0. This is the only generic vertex attribute
with this property; calls to set other standard vertex attributes can be
freely mixed with calls to set any of the other generic vertex
attributes.
"Define an array of vertex data.
SIZE
- Specifies the number of coordinates per vertex. Must be 2, 3, or
- 4. The initial value is 4.
+ Specifies the number of coordinates per vertex. Must be 2, 3, or 4.
+ The initial value is 4.
TYPE
- Specifies the data type of each coordinate in the array. Symbolic
+ Specifies the data type of each coordinate in the array. Symbolic
constants `GL_SHORT', `GL_INT', `GL_FLOAT', or `GL_DOUBLE' are
- accepted. The initial value is `GL_FLOAT'.
+ accepted. The initial value is `GL_FLOAT'.
STRIDE
- Specifies the byte offset between consecutive vertices. If STRIDE
+ Specifies the byte offset between consecutive vertices. If STRIDE
is 0, the vertices are understood to be tightly packed in the
- array. The initial value is 0.
+ array. The initial value is 0.
POINTER
Specifies a pointer to the first coordinate of the first vertex in
- the array. The initial value is 0.
+ the array. The initial value is 0.
`glVertexPointer' specifies the location and data format of an array of
-vertex coordinates to use when rendering. SIZE specifies the number of
-coordinates per vertex, and must be 2, 3, or 4. TYPE specifies the data
+vertex coordinates to use when rendering. SIZE specifies the number of
+coordinates per vertex, and must be 2, 3, or 4. TYPE specifies the data
type of each coordinate, and STRIDE 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
+single array or stored in separate arrays. (Single-array storage may be
more efficient on some implementations; see `glInterleavedArrays'.)
If a non-zero named buffer object is bound to the `GL_ARRAY_BUFFER'
target (see `glBindBuffer') while a vertex array is specified, POINTER
-is treated as a byte offset into the buffer object's data store. Also,
+is treated as a byte offset into the buffer object's data store. Also,
the buffer object binding (`GL_ARRAY_BUFFER_BINDING') is saved as vertex
array client-side state (`GL_VERTEX_ARRAY_BUFFER_BINDING').
buffer object binding.
To enable and disable the vertex array, call `glEnableClientState' and
-`glDisableClientState' with the argument `GL_VERTEX_ARRAY'. If enabled,
+`glDisableClientState' with the argument `GL_VERTEX_ARRAY'. If enabled,
the vertex array is used when `glArrayElement', `glDrawArrays',
`glMultiDrawArrays', `glDrawElements', `glMultiDrawElements', or
`glDrawRangeElements' is called.
W
- Specify X, Y, Z, and W coordinates of a vertex. Not all parameters
+ Specify X, Y, Z, and W coordinates of a vertex. Not all parameters
are present in all forms of the command.
`glVertex' commands are used within `glBegin'/`glEnd' pairs to specify
-point, line, and polygon vertices. The current color, normal, texture
+point, line, and polygon vertices. The current color, normal, texture
coordinates, and fog coordinate are associated with the vertex when
`glVertex' is called.
WIDTH
HEIGHT
- Specify the width and height of the viewport. When a GL context is
+ Specify the width and height of the viewport. When a GL context is
first attached to a window, WIDTH and HEIGHT are set to the
dimensions of that window.
`glViewport' specifies the affine transformation of X and Y from
-normalized device coordinates to window coordinates. Let (X_ND,Y_ND) be
-normalized device coordinates. Then the window coordinates (X_W,Y_W)
-are computed as follows:
+normalized device coordinates to window coordinates. Let (X_ND,Y_ND) be
+normalized device coordinates. Then the window coordinates (X_W,Y_W) are
+computed as follows:
X_W=(X_ND+1,)\u2062(WIDTH/2,)+X
Y_W=(Y_ND+1,)\u2062(HEIGHT/2,)+Y
Viewport width and height are silently clamped to a range that depends
-on the implementation. To query this range, call `glGet' with argument
+on the implementation. To query this range, call `glGet' with argument
`GL_MAX_VIEWPORT_DIMS'.
`GL_INVALID_VALUE' is generated if either WIDTH or HEIGHT is negative.
Specify the X , Y , Z coordinates for the raster position.
-The GL maintains a 3D position in window coordinates. This position,
+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 `glBitmap',
+operations. It is maintained with subpixel accuracy. See `glBitmap',
`glDrawPixels', and `glCopyPixels'.
`glWindowPos2' specifies the X and Y coordinates, while Z is implicitly
-set to 0. `glWindowPos3' specifies all three coordinates. The W
+set to 0. `glWindowPos3' specifies all three coordinates. The W
coordinate of the current raster position is always set to 1.0.
`glWindowPos' directly updates the X and Y coordinates of the current
-raster position with the values specified. That is, the values are
+raster position with the values specified. That is, the values are
neither transformed by the current modelview and projection matrices,
-nor by the viewport-to-window transform. The Z coordinate of the
-current raster position is updated in the following manner:
+nor by the viewport-to-window transform. The Z coordinate of the current
+raster position is updated in the following manner:
Z={(N), (F), (N+Z×(F-N,),)\u2062(IF\u2062Z<=0), (IF\u2062Z>=1), (`otherwise',),
where N is `GL_DEPTH_RANGE''s near value, and F is `GL_DEPTH_RANGE''s
-far value. See `glDepthRange'.
+far value. See `glDepthRange'.
The specified coordinates are not clip-tested, causing the raster
position to always be valid.
The current raster position also includes some associated color data and
-texture coordinates. If lighting is enabled, then
+texture coordinates. If lighting is enabled, then
`GL_CURRENT_RASTER_COLOR' (in RGBA mode) or `GL_CURRENT_RASTER_INDEX'
(in color index mode) is set to the color produced by the lighting
-calculation (see `glLight', `glLightModel', and `glShadeModel'). If
+calculation (see `glLight', `glLightModel', and `glShadeModel'). If
lighting is disabled, current color (in RGBA mode, state variable
`GL_CURRENT_COLOR') or color index (in color index mode, state variable
`GL_CURRENT_INDEX') is used to update the current raster color.
Likewise, `GL_CURRENT_RASTER_TEXTURE_COORDS' is updated as a function of
`GL_CURRENT_TEXTURE_COORDS', based on the texture matrix and the texture
-generation functions (see `glTexGen'). The `GL_CURRENT_RASTER_DISTANCE'
+generation functions (see `glTexGen'). The `GL_CURRENT_RASTER_DISTANCE'
is set to the `GL_CURRENT_FOG_COORD'.
;;;
;;; Derived from upstream OpenGL documentation.
;;;
-;;; Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is
-;;; licensed under the SGI Free Software B License. For details, see
+;;; Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is licensed
+;;; under the SGI Free Software B License. For details, see
;;; http://oss.sgi.com/projects/FreeB/ (http://oss.sgi.com/projects/FreeB/).
;;;
;;; Automatically generated; you probably don't want to edit this. To
Use `gluBeginCurve' to mark the beginning of a NURBS curve definition.
After calling `gluBeginCurve', make one or more calls to `gluNurbsCurve'
-to define the attributes of the curve. Exactly one of the calls to
+to define the attributes of the curve. Exactly one of the calls to
`gluNurbsCurve' must have a curve type of `GLU_MAP1_VERTEX_3' or
-`GLU_MAP1_VERTEX_4'. To mark the end of the NURBS curve definition,
-call `gluEndCurve'.
+`GLU_MAP1_VERTEX_4'. To mark the end of the NURBS curve definition, call
+`gluEndCurve'.
GL evaluators are used to render the NURBS curve as a series of line
-segments. Evaluator state is preserved during rendering with
-`glPushAttrib'(`GLU_EVAL_BIT') and `glPopAttrib'(). See the
+segments. Evaluator state is preserved during rendering with
+`glPushAttrib'(`GLU_EVAL_BIT') and `glPopAttrib'(). See the
`glPushAttrib' reference page for details on exactly what state these
calls preserve.")
Specifies the tessellation object (created with `gluNewTess').
`gluBeginPolygon' and `gluEndPolygon' delimit the definition of a
-nonconvex polygon. To define such a polygon, first call
-`gluBeginPolygon'. Then define the contours of the polygon by calling
+nonconvex polygon. To define such a polygon, first call
+`gluBeginPolygon'. Then define the contours of the polygon by calling
`gluTessVertex' for each vertex and `gluNextContour' to start each new
-contour. Finally, call `gluEndPolygon' to signal the end of the
-definition. See the `gluTessVertex' and `gluNextContour' reference
-pages for more details.
+contour. Finally, call `gluEndPolygon' to signal the end of the
+definition. See the `gluTessVertex' and `gluNextContour' reference pages
+for more details.
Once `gluEndPolygon' is called, the polygon is tessellated, and the
-resulting triangles are described through callbacks. See
+resulting triangles are described through callbacks. See
`gluTessCallback' for descriptions of the callback functions.")
(define-glu-procedures
Specifies the NURBS object (created with `gluNewNurbsRenderer').
Use `gluBeginSurface' to mark the beginning of a NURBS surface
-definition. After calling `gluBeginSurface', make one or more calls to
-`gluNurbsSurface' to define the attributes of the surface. Exactly one
+definition. After calling `gluBeginSurface', make one or more calls to
+`gluNurbsSurface' to define the attributes of the surface. Exactly one
of these calls to `gluNurbsSurface' must have a surface type of
-`GLU_MAP2_VERTEX_3' or `GLU_MAP2_VERTEX_4'. To mark the end of the
-NURBS surface definition, call `gluEndSurface'.
+`GLU_MAP2_VERTEX_3' or `GLU_MAP2_VERTEX_4'. To mark the end of the NURBS
+surface definition, call `gluEndSurface'.
Trimming of NURBS surfaces is supported with `gluBeginTrim',
-`gluPwlCurve', `gluNurbsCurve', and `gluEndTrim'. See the
-`gluBeginTrim' reference page for details.
+`gluPwlCurve', `gluNurbsCurve', and `gluEndTrim'. See the `gluBeginTrim'
+reference page for details.
GL evaluators are used to render the NURBS surface as a set of polygons.
Evaluator state is preserved during rendering with
-`glPushAttrib'(`GLU_EVAL_BIT') and `glPopAttrib'. See the
-`glPushAttrib' reference page for details on exactly what state these
-calls preserve.")
+`glPushAttrib'(`GLU_EVAL_BIT') and `glPopAttrib'. See the `glPushAttrib'
+reference page for details on exactly what state these calls preserve.")
(define-glu-procedures
((gluBeginTrim (nurb GLUnurbs*) -> void)
Specifies the NURBS object (created with `gluNewNurbsRenderer').
Use `gluBeginTrim' to mark the beginning of a trimming loop and
-`gluEndTrim' to mark the end of a trimming loop. A trimming loop is a
+`gluEndTrim' 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
+boundaries of a NURBS surface. You include these trimming loops in the
definition of a NURBS surface, between calls to `gluBeginSurface' and
`gluEndSurface'.
-The definition for a NURBS surface can contain many trimming loops. For
+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
+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
`gluBeginTrim'/`gluEndTrim' pair.
The definition of a single closed trimming loop can consist of multiple
curve segments, each described as a piecewise linear curve (see
`gluPwlCurve') or as a single NURBS curve (see `gluNurbsCurve'), 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
-`gluBeginTrim' and `gluEndTrim') are `gluPwlCurve' and `gluNurbsCurve'.
+combination of both in any order. The only library calls that can appear
+in a trimming loop definition (between the calls to `gluBeginTrim' and
+`gluEndTrim') are `gluPwlCurve' and `gluNurbsCurve'.
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
+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
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
+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
+coincident, they will be coerced to match. If the endpoints are not
sufficiently close, an error results (see `gluNurbsCallback').
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
+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.
If no trimming information is given for a NURBS surface, the entire
"Builds a subset of one-dimensional mipmap levels.
TARGET
- Specifies the target texture. Must be `GLU_TEXTURE_1D'.
+ Specifies the target texture. Must be `GLU_TEXTURE_1D'.
INTERNALFORMAT
- 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: `GLU_ALPHA',
- `GLU_ALPHA4', `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16',
- `GLU_LUMINANCE', `GLU_LUMINANCE4', `GLU_LUMINANCE8',
- `GLU_LUMINANCE12', `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA',
- `GLU_LUMINANCE4_ALPHA4', `GLU_LUMINANCE6_ALPHA2',
- `GLU_LUMINANCE8_ALPHA8', `GLU_LUMINANCE12_ALPHA4',
- `GLU_LUMINANCE12_ALPHA12', `GLU_LUMINANCE16_ALPHA16',
- `GLU_INTENSITY', `GLU_INTENSITY4', `GLU_INTENSITY8',
- `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB', `GLU_R3_G3_B2',
- `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10', `GLU_RGB12',
- `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4', `GLU_RGB5_A1',
- `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or `GLU_RGBA16'.
+ 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: `GLU_ALPHA', `GLU_ALPHA4',
+ `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16', `GLU_LUMINANCE',
+ `GLU_LUMINANCE4', `GLU_LUMINANCE8', `GLU_LUMINANCE12',
+ `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA', `GLU_LUMINANCE4_ALPHA4',
+ `GLU_LUMINANCE6_ALPHA2', `GLU_LUMINANCE8_ALPHA8',
+ `GLU_LUMINANCE12_ALPHA4', `GLU_LUMINANCE12_ALPHA12',
+ `GLU_LUMINANCE16_ALPHA16', `GLU_INTENSITY', `GLU_INTENSITY4',
+ `GLU_INTENSITY8', `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB',
+ `GLU_R3_G3_B2', `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10',
+ `GLU_RGB12', `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4',
+ `GLU_RGB5_A1', `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or
+ `GLU_RGBA16'.
WIDTH
- Specifies the width in pixels of the texture image. This should be
+ Specifies the width in pixels of the texture image. This should be
a power of 2.
FORMAT
- Specifies the format of the pixel data. Must be one of:
+ Specifies the format of the pixel data. Must be one of:
`GLU_COLOR_INDEX', `GLU_DEPTH_COMPONENT', `GLU_RED', `GLU_GREEN',
`GLU_BLUE', `GLU_ALPHA', `GLU_RGB', `GLU_RGBA', `GLU_BGR',
`GLU_BGRA', `GLU_LUMINANCE', or `GLU_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type for DATA. Must be one of:
+ Specifies the data type for DATA. Must be one of:
`GLU_UNSIGNED_BYTE', `GLU_BYTE', `GLU_BITMAP',
`GLU_UNSIGNED_SHORT', `GLU_SHORT', `GLU_UNSIGNED_INT', `GLU_INT',
`GLU_FLOAT', `GLU_UNSIGNED_BYTE_3_3_2',
Specifies a pointer to the image data in memory.
`gluBuild1DMipmapLevels' 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.
+texture maps of decreasing resolutions called a mipmap. This is used for
+the antialiasing of texture mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see `gluErrorString').
A series of mipmap levels from BASE to MAX is built by decimating DATA
-in half until size 1×1 is reached. At each level, each texel in the
+in half until size 1×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. `glTexImage1D' is called to load these mipmap
-levels from BASE to MAX. If MAX is larger than the highest mipmap level
+larger mipmap level. `glTexImage1D' is called to load these mipmap
+levels from BASE to MAX. If MAX is larger than the highest mipmap level
for the texture of the specified size, then a GLU error code is returned
(see `gluErrorString') and nothing is loaded.
For example, if LEVEL is 2 and WIDTH is 16, the following levels are
-possible: 16×1 , 8×1 , 4×1 , 2×1 , 1×1 . These correspond to levels 2
-through 6 respectively. If BASE is 3 and MAX is 5, then only mipmap
-levels 8×1 , 4×1 and 2×1 are loaded. However, if MAX is 7, then an
-error is returned and nothing is loaded since MAX is larger than the
-highest mipmap level which is, in this case, 6.
+possible: 16×1 , 8×1 , 4×1 , 2×1 , 1×1 . These correspond to levels 2
+through 6 respectively. If BASE is 3 and MAX is 5, then only mipmap
+levels 8×1 , 4×1 and 2×1 are loaded. However, if MAX is 7, then an error
+is returned and nothing is loaded since MAX is larger than the highest
+mipmap level which is, in this case, 6.
The highest mipmap level can be derived from the formula
LOG_2\u2061(WIDTH×2^LEVEL,) .
See the `glTexImage1D' reference page for a description of the
-acceptable values for TYPE parameter. See the `glDrawPixels' reference
+acceptable values for TYPE parameter. See the `glDrawPixels' reference
page for a description of the acceptable values for LEVEL parameter.
`GLU_INVALID_VALUE' is returned if LEVEL > BASE, BASE < 0, MAX < BASE or
"Builds a one-dimensional mipmap.
TARGET
- Specifies the target texture. Must be `GLU_TEXTURE_1D'.
+ Specifies the target texture. Must be `GLU_TEXTURE_1D'.
INTERNALFORMAT
- 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: `GLU_ALPHA',
- `GLU_ALPHA4', `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16',
- `GLU_LUMINANCE', `GLU_LUMINANCE4', `GLU_LUMINANCE8',
- `GLU_LUMINANCE12', `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA',
- `GLU_LUMINANCE4_ALPHA4', `GLU_LUMINANCE6_ALPHA2',
- `GLU_LUMINANCE8_ALPHA8', `GLU_LUMINANCE12_ALPHA4',
- `GLU_LUMINANCE12_ALPHA12', `GLU_LUMINANCE16_ALPHA16',
- `GLU_INTENSITY', `GLU_INTENSITY4', `GLU_INTENSITY8',
- `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB', `GLU_R3_G3_B2',
- `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10', `GLU_RGB12',
- `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4', `GLU_RGB5_A1',
- `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or `GLU_RGBA16'.
+ 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: `GLU_ALPHA', `GLU_ALPHA4',
+ `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16', `GLU_LUMINANCE',
+ `GLU_LUMINANCE4', `GLU_LUMINANCE8', `GLU_LUMINANCE12',
+ `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA', `GLU_LUMINANCE4_ALPHA4',
+ `GLU_LUMINANCE6_ALPHA2', `GLU_LUMINANCE8_ALPHA8',
+ `GLU_LUMINANCE12_ALPHA4', `GLU_LUMINANCE12_ALPHA12',
+ `GLU_LUMINANCE16_ALPHA16', `GLU_INTENSITY', `GLU_INTENSITY4',
+ `GLU_INTENSITY8', `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB',
+ `GLU_R3_G3_B2', `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10',
+ `GLU_RGB12', `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4',
+ `GLU_RGB5_A1', `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or
+ `GLU_RGBA16'.
WIDTH
Specifies the width, in pixels, of the texture image.
FORMAT
- Specifies the format of the pixel data. Must be one of
+ Specifies the format of the pixel data. Must be one of
`GLU_COLOR_INDEX', `GLU_DEPTH_COMPONENT', `GLU_RED', `GLU_GREEN',
`GLU_BLUE', `GLU_ALPHA', `GLU_RGB', `GLU_RGBA', `GLU_BGR',
`GLU_BGRA', `GLU_LUMINANCE', or `GLU_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type for DATA. Must be one of
+ Specifies the data type for DATA. Must be one of
`GLU_UNSIGNED_BYTE', `GLU_BYTE', `GLU_BITMAP',
`GLU_UNSIGNED_SHORT', `GLU_SHORT', `GLU_UNSIGNED_INT', `GLU_INT',
`GLU_FLOAT', `GLU_UNSIGNED_BYTE_3_3_2',
Specifies a pointer to the image data in memory.
`gluBuild1DMipmaps' 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.
+texture maps of decreasing resolutions called a mipmap. This is used for
+the antialiasing of texture mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see `gluErrorString').
-Initially, the WIDTH of DATA is checked to see if it is a power of 2. If
-not, a copy of DATA is scaled up or down to the nearest power of 2. (If
+Initially, the WIDTH of DATA is checked to see if it is a power of 2. If
+not, a copy of DATA is scaled up or down to the nearest power of 2. (If
WIDTH is exactly between powers of 2, then the copy of DATA will scale
upwards.) This copy will be used for subsequent mipmapping operations
-described below. For example, if WIDTH is 57, then a copy of DATA will
+described below. For example, if WIDTH is 57, then a copy of DATA will
scale up to 64 before mipmapping takes place.
Then, proxy textures (see `glTexImage1D') are used to determine if the
-implementation can fit the requested texture. If not, WIDTH is
+implementation can fit the requested texture. If not, WIDTH is
continually halved until it fits.
Next, a series of mipmap levels is built by decimating a copy of DATA in
-half until size 1×1 is reached. At each level, each texel in the halved
+half until size 1×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.
-`glTexImage1D' is called to load each of these mipmap levels. Level 0
-is a copy of DATA. The highest level is LOG_2,\u2061(WIDTH,) . For example,
-if WIDTH is 64 and the implementation can store a texture of this size,
-the following mipmap levels are built: 64×1 , 32×1 , 16×1 , 8×1 , 4×1 ,
-2×1 , and 1×1 . These correspond to levels 0 through 6, respectively.
+`glTexImage1D' is called to load each of these mipmap levels. Level 0 is
+a copy of DATA. The highest level is LOG_2,\u2061(WIDTH,) . For example, if
+WIDTH is 64 and the implementation can store a texture of this size, the
+following mipmap levels are built: 64×1 , 32×1 , 16×1 , 8×1 , 4×1 , 2×1
+, and 1×1 . These correspond to levels 0 through 6, respectively.
See the `glTexImage1D' reference page for a description of the
-acceptable values for the TYPE parameter. See the `glDrawPixels'
+acceptable values for the TYPE parameter. See the `glDrawPixels'
reference page for a description of the acceptable values for the DATA
parameter.
"Builds a subset of two-dimensional mipmap levels.
TARGET
- Specifies the target texture. Must be `GLU_TEXTURE_2D'.
+ Specifies the target texture. Must be `GLU_TEXTURE_2D'.
INTERNALFORMAT
- 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: `GLU_ALPHA',
- `GLU_ALPHA4', `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16',
- `GLU_LUMINANCE', `GLU_LUMINANCE4', `GLU_LUMINANCE8',
- `GLU_LUMINANCE12', `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA',
- `GLU_LUMINANCE4_ALPHA4', `GLU_LUMINANCE6_ALPHA2',
- `GLU_LUMINANCE8_ALPHA8', `GLU_LUMINANCE12_ALPHA4',
- `GLU_LUMINANCE12_ALPHA12', `GLU_LUMINANCE16_ALPHA16',
- `GLU_INTENSITY', `GLU_INTENSITY4', `GLU_INTENSITY8',
- `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB', `GLU_R3_G3_B2',
- `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10', `GLU_RGB12',
- `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4', `GLU_RGB5_A1',
- `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or `GLU_RGBA16'.
+ 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: `GLU_ALPHA', `GLU_ALPHA4',
+ `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16', `GLU_LUMINANCE',
+ `GLU_LUMINANCE4', `GLU_LUMINANCE8', `GLU_LUMINANCE12',
+ `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA', `GLU_LUMINANCE4_ALPHA4',
+ `GLU_LUMINANCE6_ALPHA2', `GLU_LUMINANCE8_ALPHA8',
+ `GLU_LUMINANCE12_ALPHA4', `GLU_LUMINANCE12_ALPHA12',
+ `GLU_LUMINANCE16_ALPHA16', `GLU_INTENSITY', `GLU_INTENSITY4',
+ `GLU_INTENSITY8', `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB',
+ `GLU_R3_G3_B2', `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10',
+ `GLU_RGB12', `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4',
+ `GLU_RGB5_A1', `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or
+ `GLU_RGBA16'.
WIDTH
HEIGHT
Specifies the width and height, respectively, in pixels of the
- texture image. These should be a power of 2.
+ texture image. These should be a power of 2.
FORMAT
- Specifies the format of the pixel data. Must be one of
+ Specifies the format of the pixel data. Must be one of
`GLU_COLOR_INDEX', `GLU_DEPTH_COMPONENT', `GLU_RED', `GLU_GREEN',
`GLU_BLUE', `GLU_ALPHA', `GLU_RGB', `GLU_RGBA', `GLU_BGR',
`GLU_BGRA', `GLU_LUMINANCE', or `GLU_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type for DATA. Must be one of
+ Specifies the data type for DATA. Must be one of
`GLU_UNSIGNED_BYTE', `GLU_BYTE', `GLU_BITMAP',
`GLU_UNSIGNED_SHORT', `GLU_SHORT', `GLU_UNSIGNED_INT', `GLU_INT',
`GLU_FLOAT', `GLU_UNSIGNED_BYTE_3_3_2',
Specifies a pointer to the image data in memory.
`gluBuild2DMipmapLevels' 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.
+texture maps of decreasing resolutions called a mipmap. This is used for
+the antialiasing of texture mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see `gluErrorString').
A series of mipmap levels from BASE to MAX is built by decimating DATA
-in half along both dimensions until size 1×1 is reached. At each level,
+in half along both dimensions until size 1×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
+four texels in the larger mipmap level. (In the case of rectangular
images, the decimation will ultimately reach an N×1 or 1×N
-configuration. Here, two texels are averaged instead.) `glTexImage2D'
-is called to load these mipmap levels from BASE to MAX. If MAX is
-larger than the highest mipmap level for the texture of the specified
-size, then a GLU error code is returned (see `gluErrorString') and
-nothing is loaded.
+configuration. Here, two texels are averaged instead.) `glTexImage2D' is
+called to load these mipmap levels from BASE to MAX. If MAX is larger
+than the highest mipmap level for the texture of the specified size,
+then a GLU error code is returned (see `gluErrorString') and nothing is
+loaded.
For example, if LEVEL is 2 and WIDTH is 16 and HEIGHT is 8, the
-following levels are possible: 16×8 , 8×4 , 4×2 , 2×1 , 1×1 . These
-correspond to levels 2 through 6 respectively. If BASE is 3 and MAX is
-5, then only mipmap levels 8×4 , 4×2 , and 2×1 are loaded. However, if
+following levels are possible: 16×8 , 8×4 , 4×2 , 2×1 , 1×1 . These
+correspond to levels 2 through 6 respectively. If BASE is 3 and MAX is
+5, then only mipmap levels 8×4 , 4×2 , and 2×1 are loaded. However, if
MAX is 7, then an error is returned and nothing is loaded since MAX is
larger than the highest mipmap level which is, in this case, 6.
LOG_2\u2061(MAX\u2061(WIDTH,HEIGHT)×2^LEVEL,) .
See the `glTexImage1D' reference page for a description of the
-acceptable values for FORMAT parameter. See the `glDrawPixels'
-reference page for a description of the acceptable values for TYPE
-parameter.
+acceptable values for FORMAT parameter. See the `glDrawPixels' reference
+page for a description of the acceptable values for TYPE parameter.
`GLU_INVALID_VALUE' is returned if LEVEL > BASE, BASE < 0, MAX < BASE,
or MAX is > the highest mipmap level for DATA.
"Builds a two-dimensional mipmap.
TARGET
- Specifies the target texture. Must be `GLU_TEXTURE_2D'.
+ Specifies the target texture. Must be `GLU_TEXTURE_2D'.
INTERNALFORMAT
- 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: `GLU_ALPHA',
- `GLU_ALPHA4', `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16',
- `GLU_LUMINANCE', `GLU_LUMINANCE4', `GLU_LUMINANCE8',
- `GLU_LUMINANCE12', `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA',
- `GLU_LUMINANCE4_ALPHA4', `GLU_LUMINANCE6_ALPHA2',
- `GLU_LUMINANCE8_ALPHA8', `GLU_LUMINANCE12_ALPHA4',
- `GLU_LUMINANCE12_ALPHA12', `GLU_LUMINANCE16_ALPHA16',
- `GLU_INTENSITY', `GLU_INTENSITY4', `GLU_INTENSITY8',
- `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB', `GLU_R3_G3_B2',
- `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10', `GLU_RGB12',
- `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4', `GLU_RGB5_A1',
- `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or `GLU_RGBA16'.
+ 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: `GLU_ALPHA', `GLU_ALPHA4',
+ `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16', `GLU_LUMINANCE',
+ `GLU_LUMINANCE4', `GLU_LUMINANCE8', `GLU_LUMINANCE12',
+ `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA', `GLU_LUMINANCE4_ALPHA4',
+ `GLU_LUMINANCE6_ALPHA2', `GLU_LUMINANCE8_ALPHA8',
+ `GLU_LUMINANCE12_ALPHA4', `GLU_LUMINANCE12_ALPHA12',
+ `GLU_LUMINANCE16_ALPHA16', `GLU_INTENSITY', `GLU_INTENSITY4',
+ `GLU_INTENSITY8', `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB',
+ `GLU_R3_G3_B2', `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10',
+ `GLU_RGB12', `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4',
+ `GLU_RGB5_A1', `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or
+ `GLU_RGBA16'.
WIDTH
HEIGHT
texture image.
FORMAT
- Specifies the format of the pixel data. Must be one of
+ Specifies the format of the pixel data. Must be one of
`GLU_COLOR_INDEX', `GLU_DEPTH_COMPONENT', `GLU_RED', `GLU_GREEN',
`GLU_BLUE', `GLU_ALPHA', `GLU_RGB', `GLU_RGBA', `GLU_BGR',
`GLU_BGRA', `GLU_LUMINANCE', or `GLU_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type for DATA. Must be one of
+ Specifies the data type for DATA. Must be one of
`GLU_UNSIGNED_BYTE', `GLU_BYTE', `GLU_BITMAP',
`GLU_UNSIGNED_SHORT', `GLU_SHORT', `GLU_UNSIGNED_INT', `GLU_INT',
`GLU_FLOAT', `GLU_UNSIGNED_BYTE_3_3_2',
Specifies a pointer to the image data in memory.
`gluBuild2DMipmaps' 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.
+texture maps of decreasing resolutions called a mipmap. This is used for
+the antialiasing of texture-mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see `gluErrorString').
Initially, the WIDTH and HEIGHT of DATA are checked to see if they are a
-power of 2. If not, a copy of DATA (not DATA), is scaled up or down to
-the nearest power of 2. This copy will be used for subsequent
-mipmapping operations described below. (If WIDTH or HEIGHT is exactly
-between powers of 2, then the copy of DATA will scale upwards.) For
-example, if WIDTH is 57 and HEIGHT is 23, then a copy of DATA will scale
-up to 64 in WIDTH and down to 16 in depth, before mipmapping takes
-place.
+power of 2. If not, a copy of DATA (not DATA), is scaled up or down to
+the nearest power of 2. This copy will be used for subsequent mipmapping
+operations described below. (If WIDTH or HEIGHT is exactly between
+powers of 2, then the copy of DATA will scale upwards.) For example, if
+WIDTH is 57 and HEIGHT is 23, then a copy of DATA will scale up to 64 in
+WIDTH and down to 16 in depth, before mipmapping takes place.
Then, proxy textures (see `glTexImage2D') 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 \\(<=
+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 `glGetIntegerv' with the argument `GLU_MAX_TEXTURE_SIZE'.)
Next, a series of mipmap levels is built by decimating a copy of DATA in
-half along both dimensions until size 1×1 is reached. At each level,
+half along both dimensions until size 1×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
+four texels in the larger mipmap level. (In the case of rectangular
images, the decimation will ultimately reach an N×1 or 1×N
-configuration. Here, two texels are averaged instead.)
+configuration. Here, two texels are averaged instead.)
-`glTexImage2D' is called to load each of these mipmap levels. Level 0
-is a copy of DATA. The highest level is LOG_2,\u2061(MAX\u2061(WIDTH,HEIGHT),) .
-For example, if WIDTH is 64 and HEIGHT is 16 and the implementation can
+`glTexImage2D' is called to load each of these mipmap levels. Level 0 is
+a copy of DATA. The highest level is LOG_2,\u2061(MAX\u2061(WIDTH,HEIGHT),) . For
+example, if WIDTH is 64 and HEIGHT is 16 and the implementation can
store a texture of this size, the following mipmap levels are built:
64×16 , 32×8 , 16×4 , 8×2 , 4×1 , 2×1 , and 1×1 These correspond to
levels 0 through 6, respectively.
See the `glTexImage1D' reference page for a description of the
-acceptable values for FORMAT parameter. See the `glDrawPixels'
-reference page for a description of the acceptable values for TYPE
-parameter.
+acceptable values for FORMAT parameter. See the `glDrawPixels' reference
+page for a description of the acceptable values for TYPE parameter.
`GLU_INVALID_VALUE' is returned if WIDTH or HEIGHT is < 1.
"Builds a subset of three-dimensional mipmap levels.
TARGET
- Specifies the target texture. Must be `GLU_TEXTURE_3D'.
+ Specifies the target texture. Must be `GLU_TEXTURE_3D'.
INTERNALFORMAT
- 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: `GLU_ALPHA',
- `GLU_ALPHA4', `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16',
- `GLU_LUMINANCE', `GLU_LUMINANCE4', `GLU_LUMINANCE8',
- `GLU_LUMINANCE12', `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA',
- `GLU_LUMINANCE4_ALPHA4', `GLU_LUMINANCE6_ALPHA2',
- `GLU_LUMINANCE8_ALPHA8', `GLU_LUMINANCE12_ALPHA4',
- `GLU_LUMINANCE12_ALPHA12', `GLU_LUMINANCE16_ALPHA16',
- `GLU_INTENSITY', `GLU_INTENSITY4', `GLU_INTENSITY8',
- `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB', `GLU_R3_G3_B2',
- `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10', `GLU_RGB12',
- `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4', `GLU_RGB5_A1',
- `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or `GLU_RGBA16'.
+ 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: `GLU_ALPHA', `GLU_ALPHA4',
+ `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16', `GLU_LUMINANCE',
+ `GLU_LUMINANCE4', `GLU_LUMINANCE8', `GLU_LUMINANCE12',
+ `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA', `GLU_LUMINANCE4_ALPHA4',
+ `GLU_LUMINANCE6_ALPHA2', `GLU_LUMINANCE8_ALPHA8',
+ `GLU_LUMINANCE12_ALPHA4', `GLU_LUMINANCE12_ALPHA12',
+ `GLU_LUMINANCE16_ALPHA16', `GLU_INTENSITY', `GLU_INTENSITY4',
+ `GLU_INTENSITY8', `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB',
+ `GLU_R3_G3_B2', `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10',
+ `GLU_RGB12', `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4',
+ `GLU_RGB5_A1', `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or
+ `GLU_RGBA16'.
WIDTH
HEIGHT
DEPTH
Specifies in pixels the width, height and depth respectively, of
- the texture image. These should be a power of 2.
+ the texture image. These should be a power of 2.
FORMAT
- Specifies the format of the pixel data. Must be one of
+ Specifies the format of the pixel data. Must be one of
`GLU_COLOR_INDEX', `GLU_DEPTH_COMPONENT', `GLU_RED', `GLU_GREEN',
`GLU_BLUE', `GLU_ALPHA', `GLU_RGB', `GLU_RGBA', `GLU_BGR',
`GLU_BGRA', `GLU_LUMINANCE', or `GLU_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type for DATA. Must be one of
+ Specifies the data type for DATA. Must be one of
`GLU_UNSIGNED_BYTE', `GLU_BYTE', `GLU_BITMAP',
`GLU_UNSIGNED_SHORT', `GLU_SHORT', `GLU_UNSIGNED_INT', `GLU_INT',
`GLU_FLOAT', `GLU_UNSIGNED_BYTE_3_3_2',
`gluBuild3DMipmapLevels' 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.
+mipmap. This is used for the antialiasing of texture mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see `gluErrorString').
A series of mipmap levels from BASE to MAX is built by decimating DATA
-in half along both dimensions until size 1×1×1 is reached. At each
+in half along both dimensions until size 1×1×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
+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.) `glTexImage3D' is called to
-load these mipmap levels from BASE to MAX. If MAX is larger than the
+load these mipmap levels from BASE to MAX. If MAX is larger than the
highest mipmap level for the texture of the specified size, then a GLU
error code is returned (see `gluErrorString') and nothing is loaded.
For example, if LEVEL is 2 and WIDTH is 16, HEIGHT is 8 and DEPTH is 4,
the following levels are possible: 16×8×4 , 8×4×2 , 4×2×1 , 2×1×1 ,
-1×1×1 . These correspond to levels 2 through 6 respectively. If BASE
-is 3 and MAX is 5, then only mipmap levels 8×4×2 , 4×2×1 , and 2×1×1 are
-loaded. However, if MAX is 7, then an error is returned and nothing is
+1×1×1 . These correspond to levels 2 through 6 respectively. If BASE is
+3 and MAX is 5, then only mipmap levels 8×4×2 , 4×2×1 , and 2×1×1 are
+loaded. However, if MAX is 7, then an error is returned and nothing is
loaded, since MAX is larger than the highest mipmap level which is, in
this case, 6.
LOG_2\u2061(MAX\u2061(WIDTH,HEIGHTDEPTH)×2^LEVEL,) .
See the `glTexImage1D' reference page for a description of the
-acceptable values for FORMAT parameter. See the `glDrawPixels'
-reference page for a description of the acceptable values for TYPE
-parameter.
+acceptable values for FORMAT parameter. See the `glDrawPixels' reference
+page for a description of the acceptable values for TYPE parameter.
`GLU_INVALID_VALUE' is returned if LEVEL > BASE, BASE < 0, MAX < BASE,
or MAX is > the highest mipmap level for DATA.
"Builds a three-dimensional mipmap.
TARGET
- Specifies the target texture. Must be `GLU_TEXTURE_3D'.
+ Specifies the target texture. Must be `GLU_TEXTURE_3D'.
INTERNALFORMAT
- 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: `GLU_ALPHA',
- `GLU_ALPHA4', `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16',
- `GLU_LUMINANCE', `GLU_LUMINANCE4', `GLU_LUMINANCE8',
- `GLU_LUMINANCE12', `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA',
- `GLU_LUMINANCE4_ALPHA4', `GLU_LUMINANCE6_ALPHA2',
- `GLU_LUMINANCE8_ALPHA8', `GLU_LUMINANCE12_ALPHA4',
- `GLU_LUMINANCE12_ALPHA12', `GLU_LUMINANCE16_ALPHA16',
- `GLU_INTENSITY', `GLU_INTENSITY4', `GLU_INTENSITY8',
- `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB', `GLU_R3_G3_B2',
- `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10', `GLU_RGB12',
- `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4', `GLU_RGB5_A1',
- `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or `GLU_RGBA16'.
+ 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: `GLU_ALPHA', `GLU_ALPHA4',
+ `GLU_ALPHA8', `GLU_ALPHA12', `GLU_ALPHA16', `GLU_LUMINANCE',
+ `GLU_LUMINANCE4', `GLU_LUMINANCE8', `GLU_LUMINANCE12',
+ `GLU_LUMINANCE16', `GLU_LUMINANCE_ALPHA', `GLU_LUMINANCE4_ALPHA4',
+ `GLU_LUMINANCE6_ALPHA2', `GLU_LUMINANCE8_ALPHA8',
+ `GLU_LUMINANCE12_ALPHA4', `GLU_LUMINANCE12_ALPHA12',
+ `GLU_LUMINANCE16_ALPHA16', `GLU_INTENSITY', `GLU_INTENSITY4',
+ `GLU_INTENSITY8', `GLU_INTENSITY12', `GLU_INTENSITY16', `GLU_RGB',
+ `GLU_R3_G3_B2', `GLU_RGB4', `GLU_RGB5', `GLU_RGB8', `GLU_RGB10',
+ `GLU_RGB12', `GLU_RGB16', `GLU_RGBA', `GLU_RGBA2', `GLU_RGBA4',
+ `GLU_RGB5_A1', `GLU_RGBA8', `GLU_RGB10_A2', `GLU_RGBA12', or
+ `GLU_RGBA16'.
WIDTH
HEIGHT
pixels of the texture image.
FORMAT
- Specifies the format of the pixel data. Must be one of
+ Specifies the format of the pixel data. Must be one of
`GLU_COLOR_INDEX', `GLU_DEPTH_COMPONENT', `GLU_RED', `GLU_GREEN',
`GLU_BLUE', `GLU_ALPHA', `GLU_RGB', `GLU_RGBA', `GLU_BGR',
`GLU_BGRA', `GLU_LUMINANCE', or `GLU_LUMINANCE_ALPHA'.
TYPE
- Specifies the data type for DATA. Must be one of:
+ Specifies the data type for DATA. Must be one of:
`GLU_UNSIGNED_BYTE', `GLU_BYTE', `GLU_BITMAP',
`GLU_UNSIGNED_SHORT', `GLU_SHORT', `GLU_UNSIGNED_INT', `GLU_INT',
`GLU_FLOAT', `GLU_UNSIGNED_BYTE_3_3_2',
Specifies a pointer to the image data in memory.
`gluBuild3DMipmaps' 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.
+texture maps of decreasing resolutions called a mipmap. This is used for
+the antialiasing of texture-mapped primitives.
A return value of zero indicates success, otherwise a GLU error code is
returned (see `gluErrorString').
Initially, the WIDTH, HEIGHT and DEPTH of DATA are checked to see if
-they are a power of 2. If not, a copy of DATA is made and scaled up or
-down to the nearest power of 2. (If WIDTH, HEIGHT, or DEPTH is exactly
+they are a power of 2. If not, a copy of DATA is made and scaled up or
+down to the nearest power of 2. (If WIDTH, HEIGHT, or DEPTH is exactly
between powers of 2, then the copy of DATA will scale upwards.) This
copy will be used for subsequent mipmapping operations described below.
For example, if WIDTH is 57, HEIGHT is 23, and DEPTH is 24, then a copy
in depth before mipmapping takes place.
Then, proxy textures (see `glTexImage3D') are used to determine if the
-implementation can fit the requested texture. If not, all three
+implementation can fit the requested texture. If not, all three
dimensions are continually halved until it fits.
Next, a series of mipmap levels is built by decimating a copy of DATA in
-half along all three dimensions until size 1×1×1 is reached. At each
+half along all three dimensions until size 1×1×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
+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.)
-`glTexImage3D' is called to load each of these mipmap levels. Level 0
-is a copy of DATA. The highest level is
-LOG_2,\u2061(MAX\u2061(WIDTH,HEIGHTDEPTH),) . For example, if WIDTH is 64, HEIGHT
-is 16, and DEPTH is 32, and the implementation can store a texture of
-this size, the following mipmap levels are built: 64×16×32 , 32×8×16 ,
-16×4×8 , 8×2×4 , 4×1×2 , 2×1×1 , and 1×1×1 . These correspond to levels
-0 through 6, respectively.
+`glTexImage3D' is called to load each of these mipmap levels. Level 0 is
+a copy of DATA. The highest level is LOG_2,\u2061(MAX\u2061(WIDTH,HEIGHTDEPTH),) .
+For example, if WIDTH is 64, HEIGHT is 16, and DEPTH is 32, and the
+implementation can store a texture of this size, the following mipmap
+levels are built: 64×16×32 , 32×8×16 , 16×4×8 , 8×2×4 , 4×1×2 , 2×1×1 ,
+and 1×1×1 . These correspond to levels 0 through 6, respectively.
See the `glTexImage1D' reference page for a description of the
-acceptable values for FORMAT parameter. See the `glDrawPixels'
-reference page for a description of the acceptable values for TYPE
-parameter.
+acceptable values for FORMAT parameter. See the `glDrawPixels' reference
+page for a description of the acceptable values for TYPE parameter.
`GLU_INVALID_VALUE' is returned if WIDTH, HEIGHT, or DEPTH is < 1.
STACKS
Specifies the number of subdivisions along the Z axis.
-`gluCylinder' draws a cylinder oriented along the Z axis. The base of
-the cylinder is placed at Z = 0 and the top at Z=HEIGHT . Like a
-sphere, a cylinder is subdivided around the Z axis into slices and along
-the Z axis into stacks.
+`gluCylinder' draws a cylinder oriented along the Z axis. The base of
+the cylinder is placed at Z = 0 and the top at Z=HEIGHT . Like a sphere,
+a cylinder is subdivided around the Z axis into slices and along the Z
+axis into stacks.
Note that if TOP is set to 0.0, this routine generates a cone.
If the orientation is set to `GLU_OUTSIDE' (with
`gluQuadricOrientation'), then any generated normals point away from the
-Z axis. Otherwise, they point toward the Z axis.
+Z axis. Otherwise, they point toward the Z axis.
If texturing is turned on (with `gluQuadricTexture'), then texture
coordinates are generated so that T ranges linearly from 0.0 at Z = 0 to
Specifies the NURBS object to be destroyed.
`gluDeleteNurbsRenderer' destroys the NURBS object (which was created
-with `gluNewNurbsRenderer') and frees any memory it uses. Once
+with `gluNewNurbsRenderer') and frees any memory it uses. Once
`gluDeleteNurbsRenderer' has been called, NURB cannot be used again.")
(define-glu-procedures
Specifies the quadrics object to be destroyed.
`gluDeleteQuadric' destroys the quadrics object (created with
-`gluNewQuadric') and frees any memory it uses. Once `gluDeleteQuadric'
+`gluNewQuadric') and frees any memory it uses. Once `gluDeleteQuadric'
has been called, QUAD cannot be used again.")
(define-glu-procedures
Specifies the number of concentric rings about the origin into
which the disk is subdivided.
-`gluDisk' renders a disk on the Z = 0 plane. The disk has a radius of
-OUTER and contains a concentric circular hole with a radius of INNER. If
-INNER is 0, then no hole is generated. The disk is subdivided around
-the Z axis into slices (like pizza slices) and also about the Z axis
-into rings (as specified by SLICES and LOOPS, respectively).
+`gluDisk' renders a disk on the Z = 0 plane. The disk has a radius of
+OUTER and contains a concentric circular hole with a radius of INNER. If
+INNER is 0, then no hole is generated. The disk is subdivided around the
+Z axis into slices (like pizza slices) and also about the Z axis into
+rings (as specified by SLICES and LOOPS, respectively).
With respect to orientation, the +Z side of the disk is considered to be
-``outside'' (see `gluQuadricOrientation'). This means that if the
+``outside'' (see `gluQuadricOrientation'). This means that if the
orientation is set to `GLU_OUTSIDE', then any normals generated point
-along the +Z axis. Otherwise, they point along the \\-Z axis.
+along the +Z axis. Otherwise, they point along the \\-Z axis.
If texturing has been turned on (with `gluQuadricTexture'), texture
coordinates are generated linearly such that where R=OUTER , the value
Specifies a GL or GLU error code.
`gluErrorString' produces an error string from a GL or GLU error code.
-The string is in ISO Latin 1 format. For example,
+The string is in ISO Latin 1 format. For example,
`gluErrorString'(`GLU_OUT_OF_MEMORY') returns the string OUT OF MEMORY.
The standard GLU error codes are `GLU_INVALID_ENUM',
-`GLU_INVALID_VALUE', and `GLU_OUT_OF_MEMORY'. Certain other GLU
-functions can return specialized error codes through callbacks. See the
+`GLU_INVALID_VALUE', and `GLU_OUT_OF_MEMORY'. Certain other GLU
+functions can return specialized error codes through callbacks. See the
`glGetError' reference page for the list of GL error codes.
`NULL' is returned if ERROR is not a valid GL or GLU error code.")
Specifies the NURBS object (created with `gluNewNurbsRenderer').
PROPERTY
- Specifies the property whose value is to be fetched. Valid values
+ Specifies the property whose value is to be fetched. Valid values
are `GLU_CULLING', `GLU_SAMPLING_TOLERANCE', `GLU_DISPLAY_MODE',
`GLU_AUTO_LOAD_MATRIX', `GLU_PARAMETRIC_TOLERANCE',
`GLU_SAMPLING_METHOD', `GLU_U_STEP', `GLU_V_STEP', and
`gluGetNurbsProperty' retrieves properties stored in a NURBS object.
These properties affect the way that NURBS curves and surfaces are
-rendered. See the `gluNurbsProperty' reference page for information
+rendered. See the `gluNurbsProperty' reference page for information
about what the properties are and what they do.")
(define-glu-procedures
VERSION NUMBER<SPACE>VENDOR-SPECIFIC INFORMATION
-Vendor-specific information is optional. Its format and contents depend
+Vendor-specific information is optional. Its format and contents depend
on the implementation.
-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 NAME is `GLU_EXTENSIONS',
-then `gluGetString' returns a space-separated list of names of supported
-GLU extensions. (Extension names never contain spaces.)
+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 NAME is `GLU_EXTENSIONS', then
+`gluGetString' returns a space-separated list of names of supported GLU
+extensions. (Extension names never contain spaces.)
All strings are null-terminated.
Specifies the tessellation object (created with `gluNewTess').
WHICH
- Specifies the property whose value is to be fetched. Valid values
+ Specifies the property whose value is to be fetched. Valid values
are `GLU_TESS_WINDING_RULE', `GLU_TESS_BOUNDARY_ONLY', and
`GLU_TESS_TOLERANCE'.
named property is written.
`gluGetTessProperty' retrieves properties stored in a tessellation
-object. These properties affect the way that tessellation objects are
-interpreted and rendered. See the `gluTessProperty' reference page for
+object. These properties affect the way that tessellation objects are
+interpreted and rendered. See the `gluTessProperty' reference page for
information about the properties and what they do.")
(define-glu-procedures
Specifies a viewport (as from a `glGetIntegerv' call).
`gluLoadSamplingMatrices' uses MODEL, PERSPECTIVE, and VIEW to recompute
-the sampling and culling matrices stored in NURB. The sampling matrix
+the sampling and culling matrices stored in NURB. The sampling matrix
determines how finely a NURBS curve or surface must be tessellated to
satisfy the sampling tolerance (as determined by the
-`GLU_SAMPLING_TOLERANCE' property). The culling matrix is used in
+`GLU_SAMPLING_TOLERANCE' property). The culling matrix is used in
deciding if a NURBS curve or surface should be culled before rendering
(when the `GLU_CULLING' property is turned on).
`gluLoadSamplingMatrices' is necessary only if the
`GLU_AUTO_LOAD_MATRIX' property is turned off (see `gluNurbsProperty').
Although it can be convenient to leave the `GLU_AUTO_LOAD_MATRIX'
-property turned on, there can be a performance penalty for doing so. (A
+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.)")
reference point indicating the center of the scene, and an UP vector.
The matrix maps the reference point to the negative Z axis and the eye
-point to the origin. When a typical projection matrix is used, the
+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 UP vector projected onto the
viewing plane is mapped to the positive Y axis so that it points upward
-in the viewport. The UP vector must not be parallel to the line of
-sight from the eye point to the reference point.
+in the viewport. The UP vector must not be parallel to the line of sight
+from the eye point to the reference point.
Let
"Create a NURBS object.
`gluNewNurbsRenderer' 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.")
+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.")
(define-glu-procedures
((gluNewQuadric -> GLUquadric*))
`gluNewQuadric' 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
+control functions. A return value of 0 means that there is not enough
memory to allocate the object.")
(define-glu-procedures
"Create a tessellation object.
`gluNewTess' creates and returns a pointer to a new tessellation object.
-This object must be referred to when calling tessellation functions. A
+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.")
Specifies the tessellation object (created with `gluNewTess').
TYPE
- Specifies the type of the contour being defined. Valid values are
+ Specifies the type of the contour being defined. Valid values are
`GLU_EXTERIOR', `GLU_INTERIOR', `GLU_UNKNOWN', `GLU_CCW', and
`GLU_CW'.
After the first contour has been described through a series of
`gluTessVertex' calls, a `gluNextContour' call indicates that the
previous contour is complete and that the next contour is about to
-begin. Another series of `gluTessVertex' calls is then used to describe
-the new contour. This process can be repeated until all contours have
+begin. Another series of `gluTessVertex' calls is then used to describe
+the new contour. This process can be repeated until all contours have
been described.
-TYPE defines what type of contour follows. The legal contour types are
+TYPE defines what type of contour follows. The legal contour types are
as follows:
`GLU_EXTERIOR'
`GLU_CCW',
`GLU_CW'
The first `GLU_CCW' or `GLU_CW' contour defined is considered to be
- exterior. All other contours are considered to be exterior if they
+ 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.
contour types.
Before the first contour is described, `gluNextContour' can be called to
-define the type of the first contour. If `gluNextContour' is not called
+define the type of the first contour. If `gluNextContour' is not called
before the first contour, then the first contour is marked
`GLU_EXTERIOR'.
This command is obsolete and is provided for backward compatibility
-only. Calls to `gluNextContour' are mapped to `gluTessEndContour'
+only. Calls to `gluNextContour' are mapped to `gluTessEndContour'
followed by `gluTessBeginContour'.")
(define-glu-procedures
Specifies a pointer to the user's data.
`gluNurbsCallbackDataEXT' is used to pass a pointer to the application's
-data to NURBS tessellator. A copy of this pointer will be passed by the
+data to NURBS tessellator. A copy of this pointer will be passed by the
tessellator in the NURBS callback functions (set by `gluNurbsCallback').")
(define-glu-procedures
Specifies a pointer to the user's data.
`gluNurbsCallbackData' is used to pass a pointer to the application's
-data to NURBS tessellator. A copy of this pointer will be passed by the
+data to NURBS tessellator. A copy of this pointer will be passed by the
tessellator in the NURBS callback functions (set by `gluNurbsCallback').")
(define-glu-procedures
Specifies the NURBS object (created with `gluNewNurbsRenderer').
WHICH
- Specifies the callback being defined. Valid values are
+ Specifies the callback being defined. Valid values are
`GLU_NURBS_BEGIN', `GLU_NURBS_VERTEX', `GLU_NURBS_NORMAL',
`GLU_NURBS_COLOR', `GLU_NURBS_TEXTURE_COORD', `GLU_NURBS_END',
`GLU_NURBS_BEGIN_DATA', `GLU_NURBS_VERTEX_DATA',
Specifies the function that the callback calls.
`gluNurbsCallback' 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 CALLBACKFUNC is NULL, then this callback will not get
+object. If the specified callback is already defined, then it is
+replaced. If CALLBACKFUNC is NULL, then this callback will not get
invoked and the related data, if any, will be lost.
Except the error callback, these callbacks are used by NURBS tessellator
(when `GLU_NURBS_MODE' is set to be `GLU_NURBS_TESSELLATOR') to return
-back the OpenGL polygon primitives resulting from the tessellation. Note
+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
+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 `gluNurbsCallbackData'.
The error callback function is effective no matter which value that
-`GLU_NURBS_MODE' is set to. All other callback functions are effective
+`GLU_NURBS_MODE' is set to. All other callback functions are effective
only when `GLU_NURBS_MODE' is set to `GLU_NURBS_TESSELLATOR'.
The legal callbacks are as follows:
`GLU_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 `GLU_LINES', `GLU_LINE_STRIP', `GLU_TRIANGLE_FAN',
- `GLU_TRIANGLE_STRIP', `GLU_TRIANGLES', or `GLU_QUAD_STRIP'. The
- default begin callback function is NULL. The function prototype
- for this callback looks like:
+ The begin callback indicates the start of a primitive. The function
+ takes a single argument of type GLenum, which can be one of
+ `GLU_LINES', `GLU_LINE_STRIP', `GLU_TRIANGLE_FAN',
+ `GLU_TRIANGLE_STRIP', `GLU_TRIANGLES', or `GLU_QUAD_STRIP'. The
+ default begin callback function is NULL. The function prototype for
+ this callback looks like:
`GLU_NURBS_BEGIN_DATA'
The same as the `GLU_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 `gluNurbsCallbackData'. The
- default callback function is NULL. The function prototype for this
+ additional pointer argument. This pointer is a copy of the pointer
+ that was specified at the last call to `gluNurbsCallbackData'. The
+ default callback function is NULL. The function prototype for this
callback function looks like:
`GLU_NURBS_VERTEX'
- The vertex callback indicates a vertex of the primitive. The
+ 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
+ coordinates have been transformed into affine coordinates. The
+ default vertex callback function is NULL. The function prototype
for this callback function looks like:
`GLU_NURBS_VERTEX_DATA'
This is the same as the `GLU_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
- `gluNurbsCallbackData'. The default callback function is NULL. The
+ takes an additional pointer argument. This pointer is a copy of the
+ pointer that was specified at the last call to
+ `gluNurbsCallbackData'. The default callback function is NULL. The
function prototype for this callback function looks like:
`GLU_NURBS_NORMAL'
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
- (`GLU_MAP1_NORMAL'). In the case of a NURBS surface, if a normal
+ (`GLU_MAP1_NORMAL'). In the case of a NURBS surface, if a normal
map (`GLU_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 `GLU_AUTO_NORMAL' is enabled. The
- default normal callback function is NULL. The function prototype
- for this callback function looks like:
+ 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 `GLU_AUTO_NORMAL' is enabled. The default
+ normal callback function is NULL. The function prototype for this
+ callback function looks like:
`GLU_NURBS_NORMAL_DATA'
The same as the `GLU_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 `gluNurbsCallbackData'. The
- default callback function is NULL. The function prototype for this
+ additional pointer argument. This pointer is a copy of the pointer
+ that was specified at the last call to `gluNurbsCallbackData'. The
+ default callback function is NULL. The function prototype for this
callback function looks like:
`GLU_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
+ generated. The components of the color are stored in the parameter
``color.'' This callback is effective only when the user provides a
- color map (`GLU_MAP1_COLOR_4' or `GLU_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
+ color map (`GLU_MAP1_COLOR_4' or `GLU_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:
`GLU_NURBS_COLOR_DATA'
The same as the `GLU_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 `gluNurbsCallbackData'. The
- default callback function is NULL. The function prototype for this
+ additional pointer argument. This pointer is a copy of the pointer
+ that was specified at the last call to `gluNurbsCallbackData'. The
+ default callback function is NULL. The function prototype for this
callback function looks like:
`GLU_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
+ 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
(`GLU_MAP1_TEXTURE_COORD_1', `GLU_MAP1_TEXTURE_COORD_2',
`GLU_MAP1_TEXTURE_COORD_3', `GLU_MAP1_TEXTURE_COORD_4',
`GLU_MAP2_TEXTURE_COORD_1', `GLU_MAP2_TEXTURE_COORD_2',
- `GLU_MAP2_TEXTURE_COORD_3', `GLU_MAP2_TEXTURE_COORD_4'). If no
+ `GLU_MAP2_TEXTURE_COORD_3', `GLU_MAP2_TEXTURE_COORD_4'). If no
texture map is specified, this callback function will not be
- called. The default texture callback function is NULL. The
- function prototype for this callback function looks like:
+ called. The default texture callback function is NULL. The function
+ prototype for this callback function looks like:
`GLU_NURBS_TEXTURE_COORD_DATA'
This is the same as the `GLU_NURBS_TEXTURE_COORD' callback, except
- that it takes an additional pointer argument. This pointer is a
+ that it takes an additional pointer argument. This pointer is a
copy of the pointer that was specified at the last call to
- `gluNurbsCallbackData'. The default callback function is NULL. The
+ `gluNurbsCallbackData'. The default callback function is NULL. The
function prototype for this callback function looks like:
`GLU_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
+ 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:
`GLU_NURBS_END_DATA'
This is the same as the `GLU_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
- `gluNurbsCallbackData'. The default callback function is NULL. The
+ takes an additional pointer argument. This pointer is a copy of the
+ pointer that was specified at the last call to
+ `gluNurbsCallbackData'. The default callback function is NULL. The
function prototype for this callback function looks like:
`GLU_NURBS_ERROR'
- The error function is called when an error is encountered. Its
+ 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
- `GLU_NURBS_ERROR1' through `GLU_NURBS_ERROR37'. Character strings
+ error that occurred. There are 37 errors unique to NURBS, named
+ `GLU_NURBS_ERROR1' through `GLU_NURBS_ERROR37'. Character strings
describing these errors can be retrieved with `gluErrorString'.
Specifies the NURBS object (created with `gluNewNurbsRenderer').
KNOTCOUNT
- Specifies the number of knots in KNOTS. KNOTCOUNT equals the
- number of control points plus the order.
+ Specifies the number of knots in KNOTS. KNOTCOUNT equals the number
+ of control points plus the order.
KNOTS
Specifies an array of KNOTCOUNT nondecreasing knot values.
floating-point values) between successive curve control points.
CONTROL
- Specifies a pointer to an array of control points. The coordinates
+ Specifies a pointer to an array of control points. The coordinates
must agree with TYPE, specified below.
ORDER
- Specifies the order of the NURBS curve. ORDER equals degree + 1,
+ Specifies the order of the NURBS curve. ORDER equals degree + 1,
hence a cubic curve has an order of 4.
TYPE
- Specifies the type of the curve. If this curve is defined within a
+ Specifies the type of the curve. If this curve is defined within a
`gluBeginCurve'/`gluEndCurve' pair, then the type can be any of the
valid one-dimensional evaluator types (such as `GLU_MAP1_VERTEX_3'
- or `GLU_MAP1_COLOR_4'). Between a `gluBeginTrim'/`gluEndTrim'
- pair, the only valid types are `GLU_MAP1_TRIM_2' and
- `GLU_MAP1_TRIM_3'.
+ or `GLU_MAP1_COLOR_4'). Between a `gluBeginTrim'/`gluEndTrim' pair,
+ the only valid types are `GLU_MAP1_TRIM_2' and `GLU_MAP1_TRIM_3'.
Use `gluNurbsCurve' to describe a NURBS curve.
When `gluNurbsCurve' appears between a `gluBeginCurve'/`gluEndCurve'
-pair, it is used to describe a curve to be rendered. Positional,
+pair, it is used to describe a curve to be rendered. Positional,
texture, and color coordinates are associated by presenting each as a
separate `gluNurbsCurve' between a `gluBeginCurve'/`gluEndCurve' pair.
No more than one call to `gluNurbsCurve' for each of color, position,
and texture data can be made within a single
-`gluBeginCurve'/`gluEndCurve' pair. Exactly one call must be made to
+`gluBeginCurve'/`gluEndCurve' pair. Exactly one call must be made to
describe the position of the curve (a TYPE of `GLU_MAP1_VERTEX_3' or
`GLU_MAP1_VERTEX_4').
When `gluNurbsCurve' appears between a `gluBeginTrim'/`gluEndTrim' pair,
-it is used to describe a trimming curve on a NURBS surface. If TYPE is
+it is used to describe a trimming curve on a NURBS surface. If TYPE is
`GLU_MAP1_TRIM_2', then it describes a curve in two-dimensional (U and
-V) parameter space. If it is `GLU_MAP1_TRIM_3', then it describes a
-curve in two-dimensional homogeneous (U, V, and W) parameter space. See
+V) parameter space. If it is `GLU_MAP1_TRIM_3', then it describes a
+curve in two-dimensional homogeneous (U, V, and W) parameter space. See
the `gluBeginTrim' reference page for more discussion about trimming
curves.")
Specifies the NURBS object (created with `gluNewNurbsRenderer').
PROPERTY
- Specifies the property to be set. Valid values are
+ Specifies the property to be set. Valid values are
`GLU_SAMPLING_TOLERANCE', `GLU_DISPLAY_MODE', `GLU_CULLING',
`GLU_AUTO_LOAD_MATRIX', `GLU_PARAMETRIC_TOLERANCE',
`GLU_SAMPLING_METHOD', `GLU_U_STEP', `GLU_V_STEP', or
`GLU_NURBS_MODE'.
VALUE
- Specifies the value of the indicated property. It may be a numeric
+ Specifies the value of the indicated property. It may be a numeric
value or one of `GLU_OUTLINE_POLYGON', `GLU_FILL',
`GLU_OUTLINE_PATCH', `GLU_TRUE', `GLU_FALSE', `GLU_PATH_LENGTH',
`GLU_PARAMETRIC_ERROR', `GLU_DOMAIN_DISTANCE',
`GLU_NURBS_RENDERER', or `GLU_NURBS_TESSELLATOR'.
`gluNurbsProperty' is used to control properties stored in a NURBS
-object. These properties affect the way that a NURBS curve is rendered.
+object. These properties affect the way that a NURBS curve is rendered.
The accepted values for PROPERTY are as follows:
`GLU_NURBS_MODE'
VALUE should be set to be either `GLU_NURBS_RENDERER' or
- `GLU_NURBS_TESSELLATOR'. When set to `GLU_NURBS_RENDERER', NURBS
+ `GLU_NURBS_TESSELLATOR'. When set to `GLU_NURBS_RENDERER', NURBS
objects are tessellated into OpenGL primitives and sent to the
- pipeline for rendering. When set to `GLU_NURBS_TESSELLATOR', NURBS
+ pipeline for rendering. When set to `GLU_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 `gluNurbsCallback'). This allows the user
- to cache the tessellated results for further processing. The
+ callback interface (see `gluNurbsCallback'). This allows the user
+ to cache the tessellated results for further processing. The
initial value is `GLU_NURBS_RENDERER'.
`GLU_SAMPLING_METHOD'
- Specifies how a NURBS surface should be tessellated. VALUE may be
+ Specifies how a NURBS surface should be tessellated. VALUE may be
one of `GLU_PATH_LENGTH', `GLU_PARAMETRIC_ERROR',
`GLU_DOMAIN_DISTANCE', `GLU_OBJECT_PATH_LENGTH', or
- `GLU_OBJECT_PARAMETRIC_ERROR'. When set to `GLU_PATH_LENGTH', the
+ `GLU_OBJECT_PARAMETRIC_ERROR'. When set to `GLU_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 `GLU_SAMPLING_TOLERANCE'.
`GLU_SAMPLING_TOLERANCE'
Specifies the maximum length, in pixels or in object space length
unit, to use when the sampling method is set to `GLU_PATH_LENGTH'
- or `GLU_OBJECT_PATH_LENGTH'. The NURBS code is conservative when
+ or `GLU_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.
+ shorter. The initial value is 50.0 pixels.
`GLU_PARAMETRIC_TOLERANCE'
Specifies the maximum distance, in pixels or in object space length
unit, to use when the sampling method is `GLU_PARAMETRIC_ERROR' or
- `GLU_OBJECT_PARAMETRIC_ERROR'. The initial value is 0.5.
+ `GLU_OBJECT_PARAMETRIC_ERROR'. The initial value is 0.5.
`GLU_U_STEP'
Specifies the number of sample points per unit length taken along
- the U axis in parametric coordinates. It is needed when
- `GLU_SAMPLING_METHOD' is set to `GLU_DOMAIN_DISTANCE'. The initial
+ the U axis in parametric coordinates. It is needed when
+ `GLU_SAMPLING_METHOD' is set to `GLU_DOMAIN_DISTANCE'. The initial
value is 100.
`GLU_V_STEP'
Specifies the number of sample points per unit length taken along
- the V axis in parametric coordinate. It is needed when
- `GLU_SAMPLING_METHOD' is set to `GLU_DOMAIN_DISTANCE'. The initial
+ the V axis in parametric coordinate. It is needed when
+ `GLU_SAMPLING_METHOD' is set to `GLU_DOMAIN_DISTANCE'. The initial
value is 100.
`GLU_DISPLAY_MODE'
VALUE can be set to `GLU_OUTLINE_POLYGON', `GLU_FILL', or
- `GLU_OUTLINE_PATCH'. When `GLU_NURBS_MODE' is set to be
+ `GLU_OUTLINE_PATCH'. When `GLU_NURBS_MODE' is set to be
`GLU_NURBS_RENDERER', VALUE defines how a NURBS surface should be
- rendered. When VALUE is set to `GLU_FILL', the surface is rendered
- as a set of polygons. When VALUE is set to `GLU_OUTLINE_POLYGON',
+ rendered. When VALUE is set to `GLU_FILL', the surface is rendered
+ as a set of polygons. When VALUE is set to `GLU_OUTLINE_POLYGON',
the NURBS library draws only the outlines of the polygons created
- by tessellation. When VALUE is set to `GLU_OUTLINE_PATCH' just the
+ by tessellation. When VALUE is set to `GLU_OUTLINE_PATCH' just the
outlines of patches and trim curves defined by the user are drawn.
When `GLU_NURBS_MODE' is set to be `GLU_NURBS_TESSELLATOR', VALUE
- defines how a NURBS surface should be tessellated. When
+ defines how a NURBS surface should be tessellated. When
`GLU_DISPLAY_MODE' is set to `GLU_FILL' or `GLU_OUTLINE_POLYGON',
the NURBS surface is tessellated into OpenGL triangle primitives
- that can be retrieved back through callback functions. If
+ that can be retrieved back through callback functions. If
`GLU_DISPLAY_MODE' is set to `GLU_OUTLINE_PATCH', only the outlines
of the patches and trim curves are generated as a sequence of line
strips that can be retrieved back through callback functions.
`GLU_CULLING'
VALUE is a boolean value that, when set to `GLU_TRUE', indicates
that a NURBS curve should be discarded prior to tessellation if its
- control points lie outside the current viewport. The initial value
+ control points lie outside the current viewport. The initial value
is `GLU_FALSE'.
`GLU_AUTO_LOAD_MATRIX'
- VALUE is a boolean value. When set to `GLU_TRUE', the NURBS code
+ VALUE is a boolean value. When set to `GLU_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
+ 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.
If this mode is set to `GLU_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 `gluLoadSamplingMatrices'
- function. This mode is initially set to `GLU_TRUE'. Changing it
+ matrices. This can be done with the `gluLoadSamplingMatrices'
+ function. This mode is initially set to `GLU_TRUE'. Changing it
from `GLU_TRUE' to `GLU_FALSE' does not affect the sampling and
culling matrices until `gluLoadSamplingMatrices' is called.")
SORDER
Specifies the order of the NURBS surface in the parametric U
- direction. The order is one more than the degree, hence a surface
+ direction. The order is one more than the degree, hence a surface
that is cubic in U has a U order of 4.
TORDER
Specifies the order of the NURBS surface in the parametric V
- direction. The order is one more than the degree, hence a surface
+ direction. The order is one more than the degree, hence a surface
that is cubic in V has a V order of 4.
TYPE
- Specifies type of the surface. TYPE can be any of the valid
+ Specifies type of the surface. TYPE can be any of the valid
two-dimensional evaluator types (such as `GLU_MAP2_VERTEX_3' or
`GLU_MAP2_COLOR_4').
Use `gluNurbsSurface' 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
-`gluBeginSurface' command. To mark the end of a NURBS surface
-definition, use the `gluEndSurface' command. Call `gluNurbsSurface'
+trimming). To mark the beginning of a NURBS surface definition, use the
+`gluBeginSurface' command. To mark the end of a NURBS surface
+definition, use the `gluEndSurface' command. Call `gluNurbsSurface'
within a NURBS surface definition only.
Positional, texture, and color coordinates are associated with a surface
by presenting each as a separate `gluNurbsSurface' between a
-`gluBeginSurface'/`gluEndSurface' pair. No more than one call to
+`gluBeginSurface'/`gluEndSurface' pair. No more than one call to
`gluNurbsSurface' for each of color, position, and texture data can be
-made within a single `gluBeginSurface'/`gluEndSurface' pair. Exactly
-one call must be made to describe the position of the surface (a TYPE of
+made within a single `gluBeginSurface'/`gluEndSurface' pair. Exactly one
+call must be made to describe the position of the surface (a TYPE of
`GLU_MAP2_VERTEX_3' or `GLU_MAP2_VERTEX_4').
A NURBS surface can be trimmed by using the commands `gluNurbsCurve' and
Specify the coordinates for the bottom and top horizontal clipping
planes.
-`gluOrtho2D' sets up a two-dimensional orthographic viewing region. This
+`gluOrtho2D' sets up a two-dimensional orthographic viewing region. This
is equivalent to calling `glOrtho' with NEAR=-1 and FAR=1 .")
(define-glu-procedures
SWEEP
Specifies the sweep angle, in degrees, of the disk portion.
-`gluPartialDisk' 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 START through START + SWEEP is included (where 0 degrees is along
-the +\\f2y\\f axis, 90 degrees along the +X axis, 180 degrees along the
-\\-Y axis, and 270 degrees along the \\-X axis).
+`gluPartialDisk' 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
+START through START + SWEEP is included (where 0 degrees is along the
++\\f2y\\f axis, 90 degrees along the +X axis, 180 degrees along the \\-Y
+axis, and 270 degrees along the \\-X axis).
The partial disk has a radius of OUTER and contains a concentric
-circular hole with a radius of INNER. If INNER is 0, then no hole is
-generated. The partial disk is subdivided around the Z axis into slices
+circular hole with a radius of INNER. If INNER is 0, then no hole is
+generated. The partial disk is subdivided around the Z axis into slices
(like pizza slices) and also about the Z axis into rings (as specified
by SLICES and LOOPS, respectively).
With respect to orientation, the +Z side of the partial disk is
-considered to be outside (see `gluQuadricOrientation'). This means that
+considered to be outside (see `gluQuadricOrientation'). This means that
if the orientation is set to `GLU_OUTSIDE', then any normals generated
-point along the +Z axis. Otherwise, they point along the \\-Z axis.
+point along the +Z axis. Otherwise, they point along the \\-Z axis.
If texturing is turned on (with `gluQuadricTexture'), texture
coordinates are generated linearly such that where R=OUTER , the value
ASPECT
Specifies the aspect ratio that determines the field of view in the
- X direction. The aspect ratio is the ratio of X (width) to Y
+ X direction. The aspect ratio is the ratio of X (width) to Y
(height).
ZNEAR
(always positive).
`gluPerspective' specifies a viewing frustum into the world coordinate
-system. In general, the aspect ratio in `gluPerspective' should match
-the aspect ratio of the associated viewport. For example, ASPECT=2.0
-means the viewer's angle of view is twice as wide in X as it is in Y. If
+system. In general, the aspect ratio in `gluPerspective' should match
+the aspect ratio of the associated viewport. For example, ASPECT=2.0
+means the viewer's angle of view is twice as wide in X as it is in Y. If
the viewport is twice as wide as it is tall, it displays the image
without distortion.
Specifies the current viewport (as from a `glGetIntegerv' call).
`gluPickMatrix' 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
+drawing to a small region of the viewport. This is typically useful to
+determine what objects are being drawn near the cursor. Use
`gluPickMatrix' to restrict drawing to a small region around the cursor.
Then, enter selection mode (with `glRenderMode') and rerender the scene.
All primitives that would have been drawn near the cursor are identified
and stored in the selection buffer.
The matrix created by `gluPickMatrix' is multiplied by the current
-matrix just as if `glMultMatrix' is called with the generated matrix. To
+matrix just as if `glMultMatrix' is called with the generated matrix. To
effectively use the generated pick matrix for picking, first call
`glLoadIdentity' to load an identity matrix onto the perspective matrix
-stack. Then call `gluPickMatrix', and, finally, call a command (such as
+stack. Then call `gluPickMatrix', and, finally, call a command (such as
`gluPerspective') to multiply the perspective matrix by the pick matrix.
When using `gluPickMatrix' to pick NURBS, be careful to turn off the
-NURBS property `GLU_AUTO_LOAD_MATRIX'. If `GLU_AUTO_LOAD_MATRIX' is not
+NURBS property `GLU_AUTO_LOAD_MATRIX'. If `GLU_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.")
Return the computed window coordinates.
`gluProject' transforms the specified object coordinates into window
-coordinates using MODEL, PROJ, and VIEW. The result is stored in WINX,
-WINY, and WINZ. A return value of `GLU_TRUE' indicates success, a
-return value of `GLU_FALSE' indicates failure.
+coordinates using MODEL, PROJ, and VIEW. The result is stored in WINX,
+WINY, and WINZ. A return value of `GLU_TRUE' indicates success, a return
+value of `GLU_FALSE' indicates failure.
To compute the coordinates, let V=(OBJX,OBJYOBJZ1.0) represented as a
-matrix with 4 rows and 1 column. Then `gluProject' computes V^″ as
+matrix with 4 rows and 1 column. Then `gluProject' computes V^″ as
follows:
V^″=P×M×V
values) between points on the curve.
TYPE
- Specifies the type of curve. Must be either `GLU_MAP1_TRIM_2' or
+ Specifies the type of curve. Must be either `GLU_MAP1_TRIM_2' or
`GLU_MAP1_TRIM_3'.
`gluPwlCurve' 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
+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.
If TYPE is `GLU_MAP1_TRIM_2', then it describes a curve in
-two-dimensional (U and V) parameter space. If it is `GLU_MAP1_TRIM_3',
+two-dimensional (U and V) parameter space. If it is `GLU_MAP1_TRIM_3',
then it describes a curve in two-dimensional homogeneous (U, V, and W)
-parameter space. See the `gluBeginTrim' reference page for more
+parameter space. See the `gluBeginTrim' reference page for more
information about trimming curves.")
(define-glu-procedures
Specifies the quadrics object (created with `gluNewQuadric').
WHICH
- Specifies the callback being defined. The only valid value is
+ Specifies the callback being defined. The only valid value is
`GLU_ERROR'.
CALLBACKFUNC
Specifies the function to be called.
`gluQuadricCallback' 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 CALLBACKFUNC is NULL, then any existing callback is
+quadrics object. If the specified callback is already defined, then it
+is replaced. If CALLBACKFUNC is NULL, then any existing callback is
erased.
The one legal callback is `GLU_ERROR':
`GLU_ERROR'
- The function is called when an error is encountered. Its single
+ 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
+ that occurred. Character strings describing these errors can be
retrieved with the `gluErrorString' call.")
(define-glu-procedures
Specifies the quadrics object (created with `gluNewQuadric').
DRAW
- Specifies the desired draw style. Valid values are `GLU_FILL',
+ Specifies the desired draw style. Valid values are `GLU_FILL',
`GLU_LINE', `GLU_SILHOUETTE', and `GLU_POINT'.
`gluQuadricDrawStyle' specifies the draw style for quadrics rendered
-with QUAD. The legal values are as follows:
+with QUAD. The legal values are as follows:
`GLU_FILL'
- Quadrics are rendered with polygon primitives. The polygons are
+ Quadrics are rendered with polygon primitives. The polygons are
drawn in a counterclockwise fashion with respect to their normals
(as defined with `gluQuadricOrientation').
Specifies the quadrics object (created with `gluNewQuadric').
NORMAL
- Specifies the desired type of normals. Valid values are
- `GLU_NONE', `GLU_FLAT', and `GLU_SMOOTH'.
+ Specifies the desired type of normals. Valid values are `GLU_NONE',
+ `GLU_FLAT', and `GLU_SMOOTH'.
`gluQuadricNormals' specifies what kind of normals are desired for
-quadrics rendered with QUAD. The legal values are as follows:
+quadrics rendered with QUAD. The legal values are as follows:
`GLU_NONE'
No normals are generated.
One normal is generated for every facet of a quadric.
`GLU_SMOOTH'
- One normal is generated for every vertex of a quadric. This is the
+ One normal is generated for every vertex of a quadric. This is the
initial value.")
(define-glu-procedures
Specifies the quadrics object (created with `gluNewQuadric').
ORIENTATION
- Specifies the desired orientation. Valid values are `GLU_OUTSIDE'
+ Specifies the desired orientation. Valid values are `GLU_OUTSIDE'
and `GLU_INSIDE'.
`gluQuadricOrientation' specifies what kind of orientation is desired
-for quadrics rendered with QUAD. The ORIENTATION values are as follows:
+for quadrics rendered with QUAD. The ORIENTATION values are as follows:
`GLU_OUTSIDE'
Quadrics are drawn with normals pointing outward (the initial
generated.
`gluQuadricTexture' specifies if texture coordinates should be generated
-for quadrics rendered with QUAD. If the value of TEXTURE is `GLU_TRUE',
+for quadrics rendered with QUAD. If the value of TEXTURE is `GLU_TRUE',
then texture coordinates are generated, and if TEXTURE is `GLU_FALSE',
-they are not. The initial value is `GLU_FALSE'.
+they are not. The initial value is `GLU_FALSE'.
The manner in which texture coordinates are generated depends upon the
specific quadric rendered.")
"Scale an image to an arbitrary size.
FORMAT
- Specifies the format of the pixel data. The following symbolic
+ Specifies the format of the pixel data. The following symbolic
values are valid: `GLU_COLOR_INDEX', `GLU_STENCIL_INDEX',
`GLU_DEPTH_COMPONENT', `GLU_RED', `GLU_GREEN', `GLU_BLUE',
`GLU_ALPHA', `GLU_RGB', `GLU_RGBA', `GLU_BGR', `GLU_BGRA',
image.
TYPEIN
- Specifies the data type for DATAIN. Must be one of
+ Specifies the data type for DATAIN. Must be one of
`GLU_UNSIGNED_BYTE', `GLU_BYTE', `GLU_BITMAP',
`GLU_UNSIGNED_SHORT', `GLU_SHORT', `GLU_UNSIGNED_INT', `GLU_INT',
`GLU_FLOAT', `GLU_UNSIGNED_BYTE_3_3_2',
destination image.
TYPEOUT
- Specifies the data type for DATAOUT. Must be one of
+ Specifies the data type for DATAOUT. Must be one of
`GLU_UNSIGNED_BYTE', `GLU_BYTE', `GLU_BITMAP',
`GLU_UNSIGNED_SHORT', `GLU_SHORT', `GLU_UNSIGNED_INT', `GLU_INT',
`GLU_FLOAT', `GLU_UNSIGNED_BYTE_3_3_2',
destination image.
When shrinking an image, `gluScaleImage' uses a box filter to sample the
-source image and create pixels for the destination image. When
+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.
lines of latitude).
`gluSphere' draws a sphere of the given radius centered around the
-origin. The sphere is subdivided around the Z axis into slices and
-along the Z axis into stacks (similar to lines of longitude and
-latitude).
+origin. The sphere is subdivided around the Z axis into slices and along
+the Z axis into stacks (similar to lines of longitude and latitude).
If the orientation is set to `GLU_OUTSIDE' (with
`gluQuadricOrientation'), then any normals generated point away from the
-center of the sphere. Otherwise, they point toward the center of the
+center of the sphere. Otherwise, they point toward the center of the
sphere.
If texturing is turned on (with `gluQuadricTexture'), then texture
Specifies the tessellation object (created with `gluNewTess').
`gluTessBeginContour' and `gluTessEndContour' delimit the definition of
-a polygon contour. Within each
-`gluTessBeginContour'/`gluTessEndContour' pair, there can be zero or
-more calls to `gluTessVertex'. The vertices specify a closed contour
-(the last vertex of each contour is automatically linked to the first).
-See the `gluTessVertex' reference page for more details.
-`gluTessBeginContour' can only be called between `gluTessBeginPolygon'
-and `gluTessEndPolygon'.")
+a polygon contour. Within each `gluTessBeginContour'/`gluTessEndContour'
+pair, there can be zero or more calls to `gluTessVertex'. The vertices
+specify a closed contour (the last vertex of each contour is
+automatically linked to the first). See the `gluTessVertex' reference
+page for more details. `gluTessBeginContour' can only be called between
+`gluTessBeginPolygon' and `gluTessEndPolygon'.")
(define-glu-procedures
((gluTessBeginPolygon
Specifies a pointer to user polygon data.
`gluTessBeginPolygon' and `gluTessEndPolygon' delimit the definition of
-a convex, concave or self-intersecting polygon. Within each
+a convex, concave or self-intersecting polygon. Within each
`gluTessBeginPolygon'/`gluTessEndPolygon' pair, there must be one or
-more calls to `gluTessBeginContour'/`gluTessEndContour'. Within each
-contour, there are zero or more calls to `gluTessVertex'. The vertices
+more calls to `gluTessBeginContour'/`gluTessEndContour'. Within each
+contour, there are zero or more calls to `gluTessVertex'. The vertices
specify a closed contour (the last vertex of each contour is
-automatically linked to the first). See the `gluTessVertex',
+automatically linked to the first). See the `gluTessVertex',
`gluTessBeginContour', and `gluTessEndContour' reference pages for more
details.
-DATA is a pointer to a user-defined data structure. If the appropriate
+DATA is a pointer to a user-defined data structure. If the appropriate
callback(s) are specified (see `gluTessCallback'), then this pointer is
-returned to the callback function(s). Thus, it is a convenient way to
+returned to the callback function(s). Thus, it is a convenient way to
store per-polygon information.
Once `gluTessEndPolygon' is called, the polygon is tessellated, and the
-resulting triangles are described through callbacks. See
+resulting triangles are described through callbacks. See
`gluTessCallback' for descriptions of the callback functions.")
(define-glu-procedures
Specifies the tessellation object (created with `gluNewTess').
WHICH
- Specifies the callback being defined. The following values are
+ Specifies the callback being defined. The following values are
valid: `GLU_TESS_BEGIN', `GLU_TESS_BEGIN_DATA',
`GLU_TESS_EDGE_FLAG', `GLU_TESS_EDGE_FLAG_DATA', `GLU_TESS_VERTEX',
`GLU_TESS_VERTEX_DATA', `GLU_TESS_END', `GLU_TESS_END_DATA',
Specifies the function to be called.
`gluTessCallback' 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 CALLBACKFUNC is NULL, then the existing callback
+tessellation object. If the specified callback is already defined, then
+it is replaced. If CALLBACKFUNC is NULL, then the existing callback
becomes undefined.
These callbacks are used by the tessellation object to describe how a
-polygon specified by the user is broken into triangles. Note that there
+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
+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 POLYGON_DATA parameter used by some of the
-functions is a copy of the pointer that was specified when
-`gluTessBeginPolygon' was called. The legal callbacks are as follows:
+used. Note that the POLYGON_DATA parameter used by some of the functions
+is a copy of the pointer that was specified when `gluTessBeginPolygon'
+was called. The legal callbacks are as follows:
`GLU_TESS_BEGIN'
The begin callback is invoked like `glBegin' to indicate the start
- of a (triangle) primitive. The function takes a single argument of
- type GLenum. If the `GLU_TESS_BOUNDARY_ONLY' property is set to
+ of a (triangle) primitive. The function takes a single argument of
+ type GLenum. If the `GLU_TESS_BOUNDARY_ONLY' property is set to
`GLU_FALSE', then the argument is set to either `GLU_TRIANGLE_FAN',
- `GLU_TRIANGLE_STRIP', or `GLU_TRIANGLES'. If the
+ `GLU_TRIANGLE_STRIP', or `GLU_TRIANGLES'. If the
`GLU_TESS_BOUNDARY_ONLY' property is set to `GLU_TRUE', then the
- argument will be set to `GLU_LINE_LOOP'. The function prototype
- for this callback is:
+ argument will be set to `GLU_LINE_LOOP'. The function prototype for
+ this callback is:
`GLU_TESS_BEGIN_DATA'
The same as the `GLU_TESS_BEGIN' callback except that it takes an
- additional pointer argument. This pointer is identical to the
- opaque pointer provided when `gluTessBeginPolygon' was called. The
+ additional pointer argument. This pointer is identical to the
+ opaque pointer provided when `gluTessBeginPolygon' was called. The
function prototype for this callback is:
`GLU_TESS_EDGE_FLAG'
- The edge flag callback is similar to `glEdgeFlag'. The function
+ The edge flag callback is similar to `glEdgeFlag'. The function
takes a single boolean flag that indicates which edges lie on the
- polygon boundary. If the flag is `GLU_TRUE', then each vertex that
+ polygon boundary. If the flag is `GLU_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
+ an edge that separates an interior region from an exterior one. If
the flag is `GLU_FALSE', then each vertex that follows begins an
- edge that lies in the polygon interior. The edge flag callback (if
+ edge that lies in the polygon interior. The edge flag callback (if
defined) is invoked before the first vertex callback.
Since triangle fans and triangle strips do not support edge flags,
the begin callback is not called with `GLU_TRIANGLE_FAN' or
`GLU_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:
+ performance). Instead, the fans and strips are converted to
+ independent triangles. The function prototype for this callback is:
`GLU_TESS_EDGE_FLAG_DATA'
The same as the `GLU_TESS_EDGE_FLAG' callback except that it takes
- an additional pointer argument. This pointer is identical to the
- opaque pointer provided when `gluTessBeginPolygon' was called. The
+ an additional pointer argument. This pointer is identical to the
+ opaque pointer provided when `gluTessBeginPolygon' was called. The
function prototype for this callback is:
`GLU_TESS_VERTEX'
The vertex callback is invoked between the begin and end callbacks.
It is similar to `glVertex', 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
+ 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 `gluTessVertex'). The function prototype for this callback
- is:
+ (see `gluTessVertex'). The function prototype for this callback is:
`GLU_TESS_VERTEX_DATA'
The same as the `GLU_TESS_VERTEX' callback except that it takes an
- additional pointer argument. This pointer is identical to the
- opaque pointer provided when `gluTessBeginPolygon' was called. The
+ additional pointer argument. This pointer is identical to the
+ opaque pointer provided when `gluTessBeginPolygon' was called. The
function prototype for this callback is:
`GLU_TESS_END'
- The end callback serves the same purpose as `glEnd'. It indicates
- the end of a primitive and it takes no arguments. The function
+ The end callback serves the same purpose as `glEnd'. It indicates
+ the end of a primitive and it takes no arguments. The function
prototype for this callback is:
`GLU_TESS_END_DATA'
The same as the `GLU_TESS_END' callback except that it takes an
- additional pointer argument. This pointer is identical to the
- opaque pointer provided when `gluTessBeginPolygon' was called. The
+ additional pointer argument. This pointer is identical to the
+ opaque pointer provided when `gluTessBeginPolygon' was called. The
function prototype for this callback is:
`GLU_TESS_COMBINE'
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
+ elements each of type GLfloat, and a pointer to a pointer. The
prototype is:
The vertex is defined as a linear combination of up to four
- existing vertices, stored in VERTEX_DATA. The coefficients of the
+ existing vertices, stored in VERTEX_DATA. The coefficients of the
linear combination are given by WEIGHT; these weights always add up
- to 1. All vertex pointers are valid even when some of the weights
- are 0. COORDS gives the location of the new vertex.
+ to 1. All vertex pointers are valid even when some of the weights
+ are 0. COORDS gives the location of the new vertex.
The user must allocate another vertex, interpolate parameters using
VERTEX_DATA and WEIGHT, and return the new vertex pointer in
- OUTDATA. This handle is supplied during rendering callbacks. The
+ OUTDATA. This handle is supplied during rendering callbacks. The
user is responsible for freeing the memory some time after
`gluTessEndPolygon' is called.
`GLU_TESS_COMBINE_DATA'
The same as the `GLU_TESS_COMBINE' callback except that it takes an
- additional pointer argument. This pointer is identical to the
- opaque pointer provided when `gluTessBeginPolygon' was called. The
+ additional pointer argument. This pointer is identical to the
+ opaque pointer provided when `gluTessBeginPolygon' was called. The
function prototype for this callback is:
`GLU_TESS_ERROR'
- The error callback is called when an error is encountered. The one
+ 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
`GLU_TESS_MISSING_BEGIN_POLYGON', `GLU_TESS_MISSING_END_POLYGON',
`GLU_TESS_MISSING_BEGIN_CONTOUR', `GLU_TESS_MISSING_END_CONTOUR',
`GLU_TESS_COORD_TOO_LARGE', `GLU_TESS_NEED_COMBINE_CALLBACK', or
- `GLU_OUT_OF_MEMORY'. Character strings describing these errors can
- be retrieved with the `gluErrorString' call. The function
- prototype for this callback is:
+ `GLU_OUT_OF_MEMORY'. Character strings describing these errors can
+ be retrieved with the `gluErrorString' call. The function prototype
+ for this callback is:
The GLU library will recover from the first four errors by
- inserting the missing call(s). `GLU_TESS_COORD_TOO_LARGE'
- indicates that some vertex coordinate exceeded the predefined
- constant `GLU_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.)
+ inserting the missing call(s). `GLU_TESS_COORD_TOO_LARGE' indicates
+ that some vertex coordinate exceeded the predefined constant
+ `GLU_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.)
`GLU_TESS_NEED_COMBINE_CALLBACK' indicates that the tessellation
detected an intersection between two edges in the input data, and
the `GLU_TESS_COMBINE' or `GLU_TESS_COMBINE_DATA' callback was not
- provided. No output is generated. `GLU_OUT_OF_MEMORY' indicates
+ provided. No output is generated. `GLU_OUT_OF_MEMORY' indicates
that there is not enough memory so no output is generated.
`GLU_TESS_ERROR_DATA'
The same as the `GLU_TESS_ERROR' callback except that it takes an
- additional pointer argument. This pointer is identical to the
- opaque pointer provided when `gluTessBeginPolygon' was called. The
+ additional pointer argument. This pointer is identical to the
+ opaque pointer provided when `gluTessBeginPolygon' was called. The
function prototype for this callback is:
Specifies the tessellation object (created with `gluNewTess').
`gluTessBeginPolygon' and `gluTessEndPolygon' delimit the definition of
-a convex, concave, or self-intersecting polygon. Within each
+a convex, concave, or self-intersecting polygon. Within each
`gluTessBeginPolygon'/`gluTessEndPolygon' pair, there must be one or
-more calls to `gluTessBeginContour'/`gluTessEndContour'. Within each
-contour, there are zero or more calls to `gluTessVertex'. The vertices
+more calls to `gluTessBeginContour'/`gluTessEndContour'. Within each
+contour, there are zero or more calls to `gluTessVertex'. The vertices
specify a closed contour (the last vertex of each contour is
-automatically linked to the first). See the `gluTessVertex',
+automatically linked to the first). See the `gluTessVertex',
`gluTessBeginContour', and `gluTessEndContour' reference pages for more
details.
Once `gluTessEndPolygon' is called, the polygon is tessellated, and the
-resulting triangles are described through callbacks. See
+resulting triangles are described through callbacks. See
`gluTessCallback' for descriptions of the callback functions.")
(define-glu-procedures
Specifies the third component of the normal.
`gluTessNormal' 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
+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
+normal). For example, if you know that all polygons lie in the x-y
plane, call `gluTessNormal'(tess, 0.0, 0.0, 1.0) before rendering any
polygons.
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
+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
+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
+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).
Specifies the tessellation object (created with `gluNewTess').
WHICH
- Specifies the property to be set. Valid values are
+ Specifies the property to be set. Valid values are
`GLU_TESS_WINDING_RULE', `GLU_TESS_BOUNDARY_ONLY', and
`GLU_TESS_TOLERANCE'.
Specifies the value of the indicated property.
`gluTessProperty' 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 WHICH are as follows:
+object. These properties affect the way that the polygons are
+interpreted and rendered. The legal values for WHICH are as follows:
`GLU_TESS_WINDING_RULE'
- Determines which parts of the polygon are on the ``interior''. DATA
+ Determines which parts of the polygon are on the ``interior''. DATA
may be set to one of `GLU_TESS_WINDING_ODD',
`GLU_TESS_WINDING_NONZERO', `GLU_TESS_WINDING_POSITIVE',
`GLU_TESS_WINDING_NEGATIVE', or `GLU_TESS_WINDING_ABS_GEQ_TWO'.
To understand how the winding rule works, consider that the input
- contours partition the plane into regions. The winding rule
+ contours partition the plane into regions. The winding rule
determines which of these regions are inside the polygon.
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
+ 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.
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
+ 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.
`GLU_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
- `GLU_TESS_BEGIN' and `GLU_TESS_BEGIN_DATA' callbacks use the type
- GL_LINE_LOOP for each contour.
+ 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 `GLU_TESS_BEGIN'
+ and `GLU_TESS_BEGIN_DATA' callbacks use the type GL_LINE_LOOP for
+ each contour.
`GLU_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
+ 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
+ the result of a single merge operation. If a single feature takes
part in several merge operations, the total distance moved could be
larger.
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.
+ 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.
The current implementation merges vertices only if they are exactly
- coincident, regardless of the current tolerance. A vertex is
+ 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
+ distinguish which side of the edge the vertex lies on. Two edges
are merged only when both endpoints are identical.")
(define-glu-procedures
vertex callback (as specified by `gluTessCallback').
`gluTessVertex' describes a vertex on a polygon that the program
-defines. Successive `gluTessVertex' calls describe a closed contour.
-For example, to describe a quadrilateral, `gluTessVertex' should be
-called four times. `gluTessVertex' can only be called between
+defines. Successive `gluTessVertex' calls describe a closed contour. For
+example, to describe a quadrilateral, `gluTessVertex' should be called
+four times. `gluTessVertex' can only be called between
`gluTessBeginContour' and `gluTessEndContour'.
DATA normally points to a structure containing the vertex location, as
-well as other per-vertex attributes such as color and normal. This
+well as other per-vertex attributes such as color and normal. This
pointer is passed back to the user through the `GLU_TESS_VERTEX' or
`GLU_TESS_VERTEX_DATA' callback after tessellation (see the
`gluTessCallback' reference page).")
`gluUnProject4' maps the specified window coordinatesi: WINX, WINY, and
WINZ and its clip w coordinate CLIPW into object coordinates
-(OBJX,OBJYOBJZOBJW) using MODEL, PROJ, and VIEW. CLIPW can be other
-than 1 as for vertices in `glFeedbackBuffer' when data type
-`GLU_4D_COLOR_TEXTURE' is returned. This also handles the case where
-the NEARVAL and FARVAL planes are different from the default, 0 and 1,
-respectively. A return value of `GLU_TRUE' indicates success; a return
+(OBJX,OBJYOBJZOBJW) using MODEL, PROJ, and VIEW. CLIPW can be other than
+1 as for vertices in `glFeedbackBuffer' when data type
+`GLU_4D_COLOR_TEXTURE' is returned. This also handles the case where the
+NEARVAL and FARVAL planes are different from the default, 0 and 1,
+respectively. A return value of `GLU_TRUE' indicates success; a return
value of `GLU_FALSE' indicates failure.
To compute the coordinates (OBJX,OBJYOBJZOBJW) , `gluUnProject4'
Returns the computed object coordinates.
`gluUnProject' maps the specified window coordinates into object
-coordinates using MODEL, PROJ, and VIEW. The result is stored in OBJX,
-OBJY, and OBJZ. A return value of `GLU_TRUE' indicates success; a
-return value of `GLU_FALSE' indicates failure.
+coordinates using MODEL, PROJ, and VIEW. The result is stored in OBJX,
+OBJY, and OBJZ. A return value of `GLU_TRUE' indicates success; a return
+value of `GLU_FALSE' indicates failure.
To compute the coordinates (OBJX,OBJYOBJZ) , `gluUnProject' multiplies
the normalized device coordinates by the inverse of MODEL * PROJ as
((OBJX), (OBJY), (OBJZ),
(W),)=INV\u2061(P\u2062M,)\u2062((2\u2061(WINX-VIEW\u2061[0,],),/VIEW\u2061[2,],-1),
(2\u2061(WINY-VIEW\u2061[1,],),/VIEW\u2061[3,],-1), (2\u2061(WINZ,)-1), (1),) INV denotes
-matrix inversion. W is an unused variable, included for consistent
+matrix inversion. W is an unused variable, included for consistent
matrix notation.")
;;;
;;; Derived from upstream OpenGL documentation.
;;;
-;;; Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is
-;;; licensed under the SGI Free Software B License. For details, see
+;;; Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is licensed
+;;; under the SGI Free Software B License. For details, see
;;; http://oss.sgi.com/projects/FreeB/ (http://oss.sgi.com/projects/FreeB/).
;;;
;;; Automatically generated; you probably don't want to edit this. To
Specifies the screen number.
ATTRIB_LIST
- Specifies a list of attribute/value pairs. The last attribute must
+ Specifies a list of attribute/value pairs. The last attribute must
be `None'.
NELEMENTS
`glXChooseFBConfig' returns GLX frame buffer configurations that match
the attributes specified in ATTRIB_LIST, or `NULL' if no matches are
-found. If ATTRIB_LIST is `NULL', then `glXChooseFBConfig' returns an
+found. If ATTRIB_LIST is `NULL', then `glXChooseFBConfig' returns an
array of GLX frame buffer configurations that are available on the
-specified screen. If an error occurs, no frame buffer configurations
+specified screen. If an error occurs, no frame buffer configurations
exist on the specified screen, or if no frame buffer configurations
-match the specified attributes, then `NULL' is returned. Use `XFree' to
+match the specified attributes, then `NULL' is returned. Use `XFree' to
free the memory returned by `glXChooseFBConfig'.
All attributes in ATTRIB_LIST, including boolean attributes, are
-immediately followed by the corresponding desired value. The list is
-terminated with `None'. If an attribute is not specified in
-ATTRIB_LIST, then the default value (see below) is used (and the
-attribute is said to be specified implicitly). For example, if
-`GLX_STEREO' is not specified, then it is assumed to be `False'. For
-some attributes, the default is `GLX_DONT_CARE', meaning that any value
-is OK for this attribute, so the attribute will not be checked.
-
-Attributes are matched in an attribute-specific manner. Some of the
+immediately followed by the corresponding desired value. The list is
+terminated with `None'. If an attribute is not specified in ATTRIB_LIST,
+then the default value (see below) is used (and the attribute is said to
+be specified implicitly). For example, if `GLX_STEREO' is not specified,
+then it is assumed to be `False'. For some attributes, the default is
+`GLX_DONT_CARE', meaning that any value is OK for this attribute, so the
+attribute will not be checked.
+
+Attributes are matched in an attribute-specific manner. Some of the
attributes, such as `GLX_LEVEL', must match the specified value exactly;
others, such as, `GLX_RED_SIZE' must meet or exceed the specified
-minimum values. If more than one GLX frame buffer configuration is
+minimum values. If more than one GLX frame buffer configuration is
found, then a list of configurations, sorted according to the ``best''
-match criteria, is returned. The match criteria for each attribute and
+match criteria, is returned. The match criteria for each attribute and
the exact sorting order is defined below.
The interpretations of the various GLX visual attributes are as follows:
Must be followed by a valid XID that indicates the desired GLX
- frame buffer configuration. When a `GLX_FBCONFIG_ID' is specified,
- all attributes are ignored. The default value is `GLX_DONT_CARE'.
+ frame buffer configuration. When a `GLX_FBCONFIG_ID' is specified,
+ all attributes are ignored. The default value is `GLX_DONT_CARE'.
`GLX_BUFFER_SIZE'
Must be followed by a nonnegative integer that indicates the
- desired color index buffer size. The smallest index buffer of at
- least the specified size is preferred. This attribute is ignored
- if `GLX_COLOR_INDEX_BIT' is not set in `GLX_RENDER_TYPE'. The
- default value is 0.
+ desired color index buffer size. The smallest index buffer of at
+ least the specified size is preferred. This attribute is ignored if
+ `GLX_COLOR_INDEX_BIT' is not set in `GLX_RENDER_TYPE'. The default
+ value is 0.
`GLX_LEVEL'
- Must be followed by an integer buffer-level specification. This
- specification is honored exactly. Buffer level 0 corresponds to
- the default frame buffer of the display. Buffer level 1 is the
- first overlay frame buffer, level two the second overlay frame
- buffer, and so on. Negative buffer levels correspond to underlay
- frame buffers. The default value is 0.
+ Must be followed by an integer buffer-level specification. This
+ specification is honored exactly. Buffer level 0 corresponds to the
+ default frame buffer of the display. Buffer level 1 is the first
+ overlay frame buffer, level two the second overlay frame buffer,
+ and so on. Negative buffer levels correspond to underlay frame
+ buffers. The default value is 0.
`GLX_DOUBLEBUFFER'
- Must be followed by `True' or `False'. If `True' is specified,
- then only double-buffered frame buffer configurations are
- considered; if `False' is specified, then only single-buffered
- frame buffer configurations are considered. The default value is
+ Must be followed by `True' or `False'. If `True' is specified, then
+ only double-buffered frame buffer configurations are considered; if
+ `False' is specified, then only single-buffered frame buffer
+ configurations are considered. The default value is
`GLX_DONT_CARE'.
`GLX_STEREO'
- Must be followed by `True' or `False'. If `True' is specified,
- then only stereo frame buffer configurations are considered; if
- `False' is specified, then only monoscopic frame buffer
- configurations are considered. The default value is `False'.
+ Must be followed by `True' or `False'. If `True' is specified, then
+ only stereo frame buffer configurations are considered; if `False'
+ is specified, then only monoscopic frame buffer configurations are
+ considered. The default value is `False'.
`GLX_AUX_BUFFERS'
Must be followed by a nonnegative integer that indicates the
- desired number of auxiliary buffers. Configurations with the
+ desired number of auxiliary buffers. Configurations with the
smallest number of auxiliary buffers that meet or exceed the
- specified number are preferred. The default value is 0.
+ specified number are preferred. The default value is 0.
`GLX_RED_SIZE', `GLX_GREEN_SIZE', `GLX_BLUE_SIZE', `GLX_ALPHA_SIZE'
Each attribute, if present, must be followed by a nonnegative
- minimum size specification or `GLX_DONT_CARE'. The largest
+ minimum size specification or `GLX_DONT_CARE'. The largest
available total RGBA color buffer size (sum of `GLX_RED_SIZE',
`GLX_GREEN_SIZE', `GLX_BLUE_SIZE', and `GLX_ALPHA_SIZE') of at
least the minimum size specified for each color component is
- preferred. If the requested number of bits for a color component
- is 0 or `GLX_DONT_CARE', it is not considered. The default value
- for each color component is 0.
+ preferred. If the requested number of bits for a color component is
+ 0 or `GLX_DONT_CARE', it is not considered. The default value for
+ each color component is 0.
`GLX_DEPTH_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, frame buffer configurations with no depth
- buffer are preferred. Otherwise, the largest available depth
- buffer of at least the minimum size is preferred. The default
- value is 0.
+ buffer are preferred. Otherwise, the largest available depth buffer
+ of at least the minimum size is preferred. The default value is 0.
`GLX_STENCIL_SIZE'
Must be followed by a nonnegative integer that indicates the
- desired number of stencil bitplanes. The smallest stencil buffer
- of at least the specified size is preferred. If the desired value
- is zero, frame buffer configurations with no stencil buffer are
- preferred. The default value is 0.
+ desired number of stencil bitplanes. The smallest stencil buffer of
+ at least the specified size is preferred. If the desired value is
+ zero, frame buffer configurations with no stencil buffer are
+ preferred. The default value is 0.
`GLX_ACCUM_RED_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, frame buffer configurations with no red
- accumulation buffer are preferred. Otherwise, the largest possible
+ accumulation buffer are preferred. Otherwise, the largest possible
red accumulation buffer of at least the minimum size is preferred.
The default value is 0.
`GLX_ACCUM_GREEN_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, frame buffer configurations with no green
- accumulation buffer are preferred. Otherwise, the largest possible
+ accumulation buffer are preferred. Otherwise, the largest possible
green accumulation buffer of at least the minimum size is
- preferred. The default value is 0.
+ preferred. The default value is 0.
`GLX_ACCUM_BLUE_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, frame buffer configurations with no blue
- accumulation buffer are preferred. Otherwise, the largest possible
+ accumulation buffer are preferred. Otherwise, the largest possible
blue accumulation buffer of at least the minimum size is preferred.
The default value is 0.
`GLX_ACCUM_ALPHA_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, frame buffer configurations with no alpha
- accumulation buffer are preferred. Otherwise, the largest possible
+ accumulation buffer are preferred. Otherwise, the largest possible
alpha accumulation buffer of at least the minimum size is
- preferred. The default value is 0.
+ preferred. The default value is 0.
`GLX_RENDER_TYPE'
Must be followed by a mask indicating which OpenGL rendering modes
- the frame buffer configuration must support. Valid bits are
- `GLX_RGBA_BIT' and `GLX_COLOR_INDEX_BIT'. If the mask is set to
+ the frame buffer configuration must support. Valid bits are
+ `GLX_RGBA_BIT' and `GLX_COLOR_INDEX_BIT'. If the mask is set to
`GLX_RGBA_BIT' | `GLX_COLOR_INDEX_BIT', then only frame buffer
configurations that can be bound to both RGBA contexts and color
- index contexts will be considered. The default value is
+ index contexts will be considered. The default value is
`GLX_RGBA_BIT'.
`GLX_DRAWABLE_TYPE'
Must be followed by a mask indicating which GLX drawable types the
- frame buffer configuration must support. Valid bits are
- `GLX_WINDOW_BIT', `GLX_PIXMAP_BIT', and `GLX_PBUFFER_BIT'. For
+ frame buffer configuration must support. Valid bits are
+ `GLX_WINDOW_BIT', `GLX_PIXMAP_BIT', and `GLX_PBUFFER_BIT'. For
example, if mask is set to `GLX_WINDOW_BIT' | `GLX_PIXMAP_BIT',
only frame buffer configurations that support both windows and GLX
- pixmaps will be considered. The default value is `GLX_WINDOW_BIT'.
+ pixmaps will be considered. The default value is `GLX_WINDOW_BIT'.
`GLX_X_RENDERABLE'
- Must be followed by `True' or `False'. If `True' is specified,
- then only frame buffer configurations that have associated X
- visuals (and can be used to render to Windows and/or GLX pixmaps)
- will be considered. The default value is `GLX_DONT_CARE'.
+ Must be followed by `True' or `False'. If `True' is specified, then
+ only frame buffer configurations that have associated X visuals
+ (and can be used to render to Windows and/or GLX pixmaps) will be
+ considered. The default value is `GLX_DONT_CARE'.
`GLX_X_VISUAL_TYPE'
Must be followed by one of `GLX_TRUE_COLOR', `GLX_DIRECT_COLOR',
`GLX_PSEUDO_COLOR', `GLX_STATIC_COLOR', `GLX_GRAY_SCALE', or
- `GLX_STATIC_GRAY', indicating the desired X visual type. Not all
- frame buffer configurations have an associated X visual. If
+ `GLX_STATIC_GRAY', indicating the desired X visual type. Not all
+ frame buffer configurations have an associated X visual. If
`GLX_DRAWABLE_TYPE' is specified in ATTRIB_LIST and the mask that
follows does not have `GLX_WINDOW_BIT' set, then this value is
- ignored. It is also ignored if `GLX_X_RENDERABLE' is specified as
- `False'. RGBA rendering may be supported for visuals of type
+ ignored. It is also ignored if `GLX_X_RENDERABLE' is specified as
+ `False'. RGBA rendering may be supported for visuals of type
`GLX_TRUE_COLOR', `GLX_DIRECT_COLOR', `GLX_PSEUDO_COLOR', or
`GLX_STATIC_COLOR', but color index rendering is only supported for
visuals of type `GLX_PSEUDO_COLOR' or `GLX_STATIC_COLOR' (i.e.,
- single-channel visuals). The tokens `GLX_GRAY_SCALE' and
+ single-channel visuals). The tokens `GLX_GRAY_SCALE' and
`GLX_STATIC_GRAY' will not match current OpenGL enabled visuals,
- but are included for future use. The default value for
+ but are included for future use. The default value for
`GLX_X_VISUAL_TYPE' is `GLX_DONT_CARE'.
`GLX_CONFIG_CAVEAT'
Must be followed by one of `GLX_NONE', `GLX_SLOW_CONFIG',
- `GLX_NON_CONFORMANT_CONFIG'. If `GLX_NONE' is specified, then only
+ `GLX_NON_CONFORMANT_CONFIG'. If `GLX_NONE' is specified, then only
frame buffer configurations with no caveats will be considered; if
`GLX_SLOW_CONFIG' is specified, then only slow frame buffer
configurations will be considered; if `GLX_NON_CONFORMANT_CONFIG'
is specified, then only nonconformant frame buffer configurations
- will be considered. The default value is `GLX_DONT_CARE'.
+ will be considered. The default value is `GLX_DONT_CARE'.
`GLX_TRANSPARENT_TYPE'
Must be followed by one of `GLX_NONE', `GLX_TRANSPARENT_RGB',
- `GLX_TRANSPARENT_INDEX'. If `GLX_NONE' is specified, then only
+ `GLX_TRANSPARENT_INDEX'. If `GLX_NONE' is specified, then only
opaque frame buffer configurations will be considered; if
`GLX_TRANSPARENT_RGB' is specified, then only transparent frame
buffer configurations that support RGBA rendering will be
considered; if `GLX_TRANSPARENT_INDEX' is specified, then only
transparent frame buffer configurations that support color index
- rendering will be considered. The default value is `GLX_NONE'.
+ rendering will be considered. The default value is `GLX_NONE'.
`GLX_TRANSPARENT_INDEX_VALUE'
Must be followed by an integer value indicating the transparent
index value; the value must be between 0 and the maximum frame
- buffer value for indices. Only frame buffer configurations that
- use the specified transparent index value will be considered. The
- default value is `GLX_DONT_CARE'. This attribute is ignored unless
+ buffer value for indices. Only frame buffer configurations that use
+ the specified transparent index value will be considered. The
+ default value is `GLX_DONT_CARE'. This attribute is ignored unless
`GLX_TRANSPARENT_TYPE' is included in ATTRIB_LIST and specified as
`GLX_TRANSPARENT_INDEX'.
Must be followed by an integer value indicating the transparent red
value; the value must be between 0 and the maximum frame buffer
- value for red. Only frame buffer configurations that use the
- specified transparent red value will be considered. The default
- value is `GLX_DONT_CARE'. This attribute is ignored unless
+ value for red. Only frame buffer configurations that use the
+ specified transparent red value will be considered. The default
+ value is `GLX_DONT_CARE'. This attribute is ignored unless
`GLX_TRANSPARENT_TYPE' is included in ATTRIB_LIST and specified as
`GLX_TRANSPARENT_RGB'.
Must be followed by an integer value indicating the transparent
green value; the value must be between 0 and the maximum frame
- buffer value for green. Only frame buffer configurations that use
- the specified transparent green value will be considered. The
- default value is `GLX_DONT_CARE'. This attribute is ignored unless
+ buffer value for green. Only frame buffer configurations that use
+ the specified transparent green value will be considered. The
+ default value is `GLX_DONT_CARE'. This attribute is ignored unless
`GLX_TRANSPARENT_TYPE' is included in ATTRIB_LIST and specified as
`GLX_TRANSPARENT_RGB'.
Must be followed by an integer value indicating the transparent
blue value; the value must be between 0 and the maximum frame
- buffer value for blue. Only frame buffer configurations that use
- the specified transparent blue value will be considered. The
- default value is `GLX_DONT_CARE'. This attribute is ignored unless
+ buffer value for blue. Only frame buffer configurations that use
+ the specified transparent blue value will be considered. The
+ default value is `GLX_DONT_CARE'. This attribute is ignored unless
`GLX_TRANSPARENT_TYPE' is included in ATTRIB_LIST and specified as
`GLX_TRANSPARENT_RGB'.
Must be followed by an integer value indicating the transparent
alpha value; the value must be between 0 and the maximum frame
- buffer value for alpha. Only frame buffer configurations that use
- the specified transparent alpha value will be considered. The
+ buffer value for alpha. Only frame buffer configurations that use
+ the specified transparent alpha value will be considered. The
default value is `GLX_DONT_CARE'.
When more than one GLX frame buffer configuration matches the specified
-attributes, a list of matching configurations is returned. The list is
+attributes, a list of matching configurations is returned. The list is
sorted according to the following precedence rules, which are applied in
ascending order (i.e., configurations that are considered equal by a
lower numbered rule are sorted by the higher numbered rule):
2.
Larger total number of RGBA color components (`GLX_RED_SIZE',
`GLX_GREEN_SIZE', `GLX_BLUE_SIZE', plus `GLX_ALPHA_SIZE') that have
- higher number of bits. If the requested number of bits in
+ higher number of bits. If the requested number of bits in
ATTRIB_LIST is zero or `GLX_DONT_CARE' for a particular color
component, then the number of bits for that component is not
considered.
Larger total number of accumulation buffer color components
(`GLX_ACCUM_RED_SIZE', `GLX_ACCUM_GREEN_SIZE',
`GLX_ACCUM_BLUE_SIZE', plus `GLX_ACCUM_ALPHA_SIZE') that have
- higher number of bits. If the requested number of bits in
+ higher number of bits. If the requested number of bits in
ATTRIB_LIST is zero or `GLX_DONT_CARE' for a particular color
component, then the number of bits for that component is not
considered.
ATTRIBLIST
Specifies a list of boolean attributes and integer attribute/value
- pairs. The last attribute must be `None'.
+ pairs. The last attribute must be `None'.
`glXChooseVisual' returns a pointer to an XVisualInfo structure
-describing the visual that best meets a minimum specification. The
+describing the visual that best meets a minimum specification. The
boolean GLX attributes of the visual that is returned will match the
specified values, and the integer GLX attributes will meet or exceed the
-specified minimum values. If all other attributes are equivalent, then
+specified minimum values. If all other attributes are equivalent, then
TrueColor and PseudoColor visuals have priority over DirectColor and
-StaticColor visuals, respectively. If no conforming visual exists,
-`NULL' is returned. To free the data returned by this function, use
+StaticColor visuals, respectively. If no conforming visual exists,
+`NULL' is returned. To free the data returned by this function, use
`XFree'.
All boolean GLX attributes default to `False' except `GLX_USE_GL', which
-defaults to `True'. All integer GLX attributes default to zero. Default
+defaults to `True'. All integer GLX attributes default to zero. Default
specifications are superseded by attributes included in ATTRIBLIST.
Boolean attributes included in ATTRIBLIST are understood to be `True'.
Integer attributes and enumerated type attributes are followed
-immediately by the corresponding desired or minimum value. The list
-must be terminated with `None'.
+immediately by the corresponding desired or minimum value. The list must
+be terminated with `None'.
The interpretations of the various GLX visual attributes are as follows:
`GLX_USE_GL'
- Ignored. Only visuals that can be rendered with GLX are
- considered.
+ Ignored. Only visuals that can be rendered with GLX are considered.
`GLX_BUFFER_SIZE'
Must be followed by a nonnegative integer that indicates the
- desired color index buffer size. The smallest index buffer of at
- least the specified size is preferred. Ignored if `GLX_RGBA' is
+ desired color index buffer size. The smallest index buffer of at
+ least the specified size is preferred. Ignored if `GLX_RGBA' is
asserted.
`GLX_LEVEL'
- Must be followed by an integer buffer-level specification. This
- specification is honored exactly. Buffer level zero corresponds to
- the main frame buffer of the display. Buffer level one is the
- first overlay frame buffer, level two the second overlay frame
- buffer, and so on. Negative buffer levels correspond to underlay
- frame buffers.
+ Must be followed by an integer buffer-level specification. This
+ specification is honored exactly. Buffer level zero corresponds to
+ the main frame buffer of the display. Buffer level one is the first
+ overlay frame buffer, level two the second overlay frame buffer,
+ and so on. Negative buffer levels correspond to underlay frame
+ buffers.
`GLX_RGBA'
If present, only TrueColor and DirectColor visuals are considered.
Otherwise, only PseudoColor and StaticColor visuals are considered.
`GLX_DOUBLEBUFFER'
- If present, only double-buffered visuals are considered. Otherwise,
+ If present, only double-buffered visuals are considered. Otherwise,
only single-buffered visuals are considered.
`GLX_STEREO'
- If present, only stereo visuals are considered. Otherwise, only
+ If present, only stereo visuals are considered. Otherwise, only
monoscopic visuals are considered.
`GLX_AUX_BUFFERS'
Must be followed by a nonnegative integer that indicates the
- desired number of auxiliary buffers. Visuals with the smallest
+ desired number of auxiliary buffers. Visuals with the smallest
number of auxiliary buffers that meets or exceeds the specified
number are preferred.
`GLX_RED_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, the smallest available red buffer is preferred.
Otherwise, the largest available red buffer of at least the minimum
size is preferred.
`GLX_GREEN_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, the smallest available green buffer is
- preferred. Otherwise, the largest available green buffer of at
+ preferred. Otherwise, the largest available green buffer of at
least the minimum size is preferred.
`GLX_BLUE_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, the smallest available blue buffer is
- preferred. Otherwise, the largest available blue buffer of at
- least the minimum size is preferred.
+ preferred. Otherwise, the largest available blue buffer of at least
+ the minimum size is preferred.
`GLX_ALPHA_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, the smallest available alpha buffer is
- preferred. Otherwise, the largest available alpha buffer of at
+ preferred. Otherwise, the largest available alpha buffer of at
least the minimum size is preferred.
`GLX_DEPTH_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, visuals with no depth buffer are preferred.
Otherwise, the largest available depth buffer of at least the
minimum size is preferred.
`GLX_STENCIL_SIZE'
Must be followed by a nonnegative integer that indicates the
- desired number of stencil bitplanes. The smallest stencil buffer
- of at least the specified size is preferred. If the desired value
- is zero, visuals with no stencil buffer are preferred.
+ desired number of stencil bitplanes. The smallest stencil buffer of
+ at least the specified size is preferred. If the desired value is
+ zero, visuals with no stencil buffer are preferred.
`GLX_ACCUM_RED_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, visuals with no red accumulation buffer are
- preferred. Otherwise, the largest possible red accumulation buffer
+ preferred. Otherwise, the largest possible red accumulation buffer
of at least the minimum size is preferred.
`GLX_ACCUM_GREEN_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, visuals with no green accumulation buffer are
- preferred. Otherwise, the largest possible green accumulation
+ preferred. Otherwise, the largest possible green accumulation
buffer of at least the minimum size is preferred.
`GLX_ACCUM_BLUE_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, visuals with no blue accumulation buffer are
- preferred. Otherwise, the largest possible blue accumulation
- buffer of at least the minimum size is preferred.
+ preferred. Otherwise, the largest possible blue accumulation buffer
+ of at least the minimum size is preferred.
`GLX_ACCUM_ALPHA_SIZE'
- Must be followed by a nonnegative minimum size specification. If
+ Must be followed by a nonnegative minimum size specification. If
this value is zero, visuals with no alpha accumulation buffer are
- preferred. Otherwise, the largest possible alpha accumulation
+ preferred. Otherwise, the largest possible alpha accumulation
buffer of at least the minimum size is preferred.
`NULL' is returned if an undefined GLX attribute is encountered in
Specifies which portions of SRC state are to be copied to DST.
`glXCopyContext' copies selected groups of state variables from SRC to
-DST. MASK indicates which groups of state variables are to be copied.
+DST. MASK indicates which groups of state variables are to be copied.
MASK contains the bitwise OR of the same symbolic names that are passed
-to the GL command `glPushAttrib'. The single symbolic constant
+to the GL command `glPushAttrib'. The single symbolic constant
`GLX_ALL_ATTRIB_BITS' can be used to copy the maximum possible portion
of rendering state.
The copy can be done only if the renderers named by SRC and DST share an
-address space. Two rendering contexts share an address space if both
-are nondirect using the same server, or if both are direct and owned by
-a single process. Note that in the nondirect case it is not necessary
-for the calling threads to share an address space, only for their
-related rendering contexts to share an address space.
+address space. Two rendering contexts share an address space if both are
+nondirect using the same server, or if both are direct and owned by a
+single process. Note that in the nondirect case it is not necessary for
+the calling threads to share an address space, only for their related
+rendering contexts to share an address space.
-Not all values for GL state can be copied. For example, pixel pack and
+Not all values for GL state can be copied. For example, pixel pack and
unpack state, render mode state, and select and feedback state are not
-copied. The state that can be copied is exactly the state that is
+copied. The state that can be copied is exactly the state that is
manipulated by the GL command `glPushAttrib'.
An implicit `glFlush' is done by `glXCopyContext' if SRC is the current
VIS
Specifies the visual that defines the frame buffer resources
- available to the rendering context. It is a pointer to an
+ available to the rendering context. It is a pointer to an
`XVisualInfo' structure, not a visual ID or a pointer to a
`Visual'.
SHARELIST
- Specifies the context with which to share display lists. `NULL'
+ Specifies the context with which to share display lists. `NULL'
indicates that no sharing is to take place.
DIRECT
(`False').
`glXCreateContext' creates a GLX rendering context and returns its
-handle. This context can be used to render into both windows and GLX
-pixmaps. If `glXCreateContext' fails to create a rendering context,
+handle. This context can be used to render into both windows and GLX
+pixmaps. If `glXCreateContext' fails to create a rendering context,
`NULL' is returned.
If DIRECT is `True', then a direct rendering context is created if the
server that is local, and if a direct rendering context is available.
(An implementation may return an indirect context when DIRECT is
`True'.) If DIRECT is `False', then a rendering context that renders
-through the X server is always created. Direct rendering provides a
-performance advantage in some implementations. However, direct
-rendering contexts cannot be shared outside a single process, and they
-may be unable to render to GLX pixmaps.
+through the X server is always created. Direct rendering provides a
+performance advantage in some implementations. However, direct rendering
+contexts cannot be shared outside a single process, and they may be
+unable to render to GLX pixmaps.
If SHARELIST is not `NULL', then all display-list indexes and
definitions are shared by context SHARELIST and by the newly created
-context. An arbitrary number of contexts can share a single
-display-list space. However, all rendering contexts that share a single
-display-list space must themselves exist in the same address space. Two
-rendering contexts share an address space if both are nondirect using
-the same server, or if both are direct and owned by a single process.
-Note that in the nondirect case, it is not necessary for the calling
-threads to share an address space, only for their related rendering
-contexts to share an address space.
+context. An arbitrary number of contexts can share a single display-list
+space. However, all rendering contexts that share a single display-list
+space must themselves exist in the same address space. Two rendering
+contexts share an address space if both are nondirect using the same
+server, or if both are direct and owned by a single process. Note that
+in the nondirect case, it is not necessary for the calling threads to
+share an address space, only for their related rendering contexts to
+share an address space.
If the GL version is 1.1 or greater, then all texture objects except
object 0 are shared by any contexts that share display lists.
VIS
Specifies the visual that defines the structure of the rendering
- area. It is a pointer to an `XVisualInfo' structure, not a visual
+ area. It is a pointer to an `XVisualInfo' structure, not a visual
ID or a pointer to a `Visual'.
PIXMAP
buffer of the off-screen rendering area.
`glXCreateGLXPixmap' creates an off-screen rendering area and returns
-its XID. Any GLX rendering context that was created with respect to VIS
-can be used to render into this off-screen area. Use `glXMakeCurrent'
-to associate the rendering area with a GLX rendering context.
+its XID. Any GLX rendering context that was created with respect to VIS
+can be used to render into this off-screen area. Use `glXMakeCurrent' to
+associate the rendering area with a GLX rendering context.
The X pixmap identified by PIXMAP is used as the front left buffer of
-the resulting off-screen rendering area. All other buffers specified by
+the resulting off-screen rendering area. All other buffers specified by
VIS, including color buffers other than the front left buffer, are
-created without externally visible names. GLX pixmaps with
-double-buffering are supported. However, `glXSwapBuffers' is ignored by
+created without externally visible names. GLX pixmaps with
+double-buffering are supported. However, `glXSwapBuffers' is ignored by
these pixmaps.
Some implementations may not support GLX pixmaps with direct rendering
the context.
RENDER_TYPE
- Specifies the type of the context to be created. Must be one of
+ Specifies the type of the context to be created. Must be one of
`GLX_RGBA_TYPE' or `GLX_COLOR_INDEX_TYPE'.
SHARE_LIST
- Specifies the context with which to share display lists. `NULL'
+ Specifies the context with which to share display lists. `NULL'
indicates that no sharing is to take place.
SHARE_LIST
(`False').
`glXCreateNewContext' creates a GLX rendering context and returns its
-handle. This context can be used to render into GLX windows, pixmaps,
-or pixel buffers. If `glXCreateNewContext' fails to create a rendering
+handle. This context can be used to render into GLX windows, pixmaps, or
+pixel buffers. If `glXCreateNewContext' fails to create a rendering
context, `NULL' is returned.
If RENDER_TYPE is `GLX_RGBA_TYPE', then a context that supports RGBA
-rendering is created. If CONFIG is `GLX_COLOR_INDEX_TYPE', then context
+rendering is created. If CONFIG is `GLX_COLOR_INDEX_TYPE', then context
supporting color-index rendering is created.
If RENDER_TYPE is not `NULL', then all display-list indexes and
definitions are shared by context RENDER_TYPE and by the newly created
-context. An arbitrary number of contexts can share a single
-display-list space. However, all rendering contexts that share a single
-display-list space must themselves exist in the same address space. Two
-rendering contexts share an address space if both are nondirect using
-the same server, or if both are direct and owned by a single process.
-Note that in the nondirect case, it is not necessary for the calling
-threads to share an address space, only for their related rendering
-contexts to share an address space.
+context. An arbitrary number of contexts can share a single display-list
+space. However, all rendering contexts that share a single display-list
+space must themselves exist in the same address space. Two rendering
+contexts share an address space if both are nondirect using the same
+server, or if both are direct and owned by a single process. Note that
+in the nondirect case, it is not necessary for the calling threads to
+share an address space, only for their related rendering contexts to
+share an address space.
If SHARE_LIST is `True', then a direct-rendering context is created if
the implementation supports direct rendering, if the connection is to an
X server that is local, and if a direct-rendering context is available.
(An implementation may return an indirect context when SHARE_LIST is
`True'.) If SHARE_LIST is `False', then a rendering context that renders
-through the X server is always created. Direct rendering provides a
-performance advantage in some implementations. However,
-direct-rendering contexts cannot be shared outside a single process, and
-they may be unable to render to GLX pixmaps.
+through the X server is always created. Direct rendering provides a
+performance advantage in some implementations. However, direct-rendering
+contexts cannot be shared outside a single process, and they may be
+unable to render to GLX pixmaps.
`NULL' is returned if execution fails on the client side.
ATTRIB_LIST
Specifies a list of attribute value pairs, which must be terminated
- with `None' or `NULL'. Accepted attributes are
- `GLX_PBUFFER_WIDTH', `GLX_PBUFFER_HEIGHT',
- `GLX_PRESERVED_CONTENTS', and `GLX_LARGEST_PBUFFER'.
+ with `None' or `NULL'. Accepted attributes are `GLX_PBUFFER_WIDTH',
+ `GLX_PBUFFER_HEIGHT', `GLX_PRESERVED_CONTENTS', and
+ `GLX_LARGEST_PBUFFER'.
`glXCreatePbuffer' creates an off-screen rendering area and returns its
-XID. Any GLX rendering context that was created with respect to CONFIG
-can be used to render into this window. Use `glXMakeContextCurrent' to
+XID. Any GLX rendering context that was created with respect to CONFIG
+can be used to render into this window. Use `glXMakeContextCurrent' to
associate the rendering area with a GLX rendering context.
The accepted attributes for a GLXPbuffer are:
`GLX_PBUFFER_WIDTH'
- Specify the pixel width of the requested GLXPbuffer. The default
+ Specify the pixel width of the requested GLXPbuffer. The default
value is 0.
`GLX_PBUFFER_HEIGHT'
- Specify the pixel height of the requested GLXPbuffer. The default
+ Specify the pixel height of the requested GLXPbuffer. The default
value is 0.
`GLX_LARGEST_PBUFFER'
Specify to obtain the largest available pixel buffer, if the
- requested allocation would have failed. The width and height of
- the allocated pixel buffer will never exceed the specified
- `GLX_PBUFFER_WIDTH' or `GLX_PBUFFER_HEIGHT', respectively. Use
+ requested allocation would have failed. The width and height of the
+ allocated pixel buffer will never exceed the specified
+ `GLX_PBUFFER_WIDTH' or `GLX_PBUFFER_HEIGHT', respectively. Use
`glXQueryDrawable' to retrieve the dimensions of the allocated
- pixel buffer. The default value is `False'.
+ pixel buffer. The default value is `False'.
`GLX_PRESERVED_CONTENTS'
Specify if the contents of the pixel buffer should be preserved
- when a resource conflict occurs. If set to `False', the contents
- of the pixel buffer may be lost at any time. If set to `True', or
- not specified in ATTRIB_LIST, then the contents of the pixel buffer
+ when a resource conflict occurs. If set to `False', the contents of
+ the pixel buffer may be lost at any time. If set to `True', or not
+ specified in ATTRIB_LIST, then the contents of the pixel buffer
will be preserved (most likely by copying the contents into main
- system memory from the frame buffer). In either case, the client
+ system memory from the frame buffer). In either case, the client
can register (using `glXSelectEvent', to receive pixel buffer
clobber events that are generated when the pbuffer contents have
been preserved or damaged.
Specifies the X pixmap to be used as the rendering area.
ATTRIB_LIST
- Currently unused. This must be set to `NULL' or be an empty list
+ Currently unused. This must be set to `NULL' or be an empty list
(i.e., one in which the first element is `None').
`glXCreatePixmap' creates an off-screen rendering area and returns its
-XID. Any GLX rendering context that was created with respect to CONFIG
-can be used to render into this window. Use `glXMakeCurrent' to
+XID. Any GLX rendering context that was created with respect to CONFIG
+can be used to render into this window. Use `glXMakeCurrent' to
associate the rendering area with a GLX rendering context.
`BadMatch' is generated if PIXMAP was not created with a visual that
`BadMatch' is generated if CONFIG does not support rendering to windows
(e.g., `GLX_DRAWABLE_TYPE' does not contain `GLX_WINDOW_BIT').
-`BadWindow' is generated if PIXMAP is not a valid window XID. `BadAlloc'
+`BadWindow' is generated if PIXMAP is not a valid window XID. `BadAlloc'
is generated if there is already a GLXFBConfig associated with PIXMAP.
`BadAlloc' is generated if the X server cannot allocate a new GLX
Specifies the X window to be used as the rendering area.
ATTRIB_LIST
- Currently unused. This must be set to `NULL' or be an empty list
+ Currently unused. This must be set to `NULL' or be an empty list
(i.e., one in which the first element is `None').
`glXCreateWindow' creates an on-screen rendering area from an existing X
-window that was created with a visual matching CONFIG. The XID of the
-GLXWindow is returned. Any GLX rendering context that was created with
-respect to CONFIG can be used to render into this window. Use
+window that was created with a visual matching CONFIG. The XID of the
+GLXWindow is returned. Any GLX rendering context that was created with
+respect to CONFIG can be used to render into this window. Use
`glXMakeContextCurrent' to associate the rendering area with a GLX
rendering context.
Specifies the GLX context to be destroyed.
If the GLX rendering context CTX is not current to any thread,
-`glXDestroyContext' destroys it immediately. Otherwise, CTX is
-destroyed when it becomes not current to any thread. In either case,
-the resource ID referenced by CTX is freed immediately.
+`glXDestroyContext' destroys it immediately. Otherwise, CTX is destroyed
+when it becomes not current to any thread. In either case, the resource
+ID referenced by CTX is freed immediately.
`GLXBadContext' is generated if CTX is not a valid GLX context.")
Specifies the GLX pixmap to be destroyed.
If the GLX pixmap PIX is not current to any client,
-`glXDestroyGLXPixmap' destroys it immediately. Otherwise, PIX is
-destroyed when it becomes not current to any client. In either case,
-the resource ID is freed immediately.
+`glXDestroyGLXPixmap' destroys it immediately. Otherwise, PIX is
+destroyed when it becomes not current to any client. In either case, the
+resource ID is freed immediately.
`GLXBadPixmap' is generated if PIX is not a valid GLX pixmap.")
Specifies a GLX rendering context.
`glXFreeContextEXT' frees the client-side part of a GLXContext that was
-created with `glXImportContextEXT'. `glXFreeContextEXT' does not free
+created with `glXImportContextEXT'. `glXFreeContextEXT' does not free
the server-side context information or the XID associated with the
server-side context.
`glXFreeContextEXT' is part of the `EXT_import_context' extension, not
-part of the core GLX command set. If _glxextstring(EXT_import_context)
+part of the core GLX command set. If _glxextstring(EXT_import_context)
is included in the string returned by `glXQueryExtensionsString', when
called with argument `GLX_EXTENSIONS', extension `EXT_vertex_array' is
supported.
Specifies the connection to the X server.
NAME
- Specifies which string is returned. The symbolic constants
+ Specifies which string is returned. The symbolic constants
`GLX_VENDOR', `GLX_VERSION', and `GLX_EXTENSIONS' are accepted.
`glXGetClientString' returns a string describing some aspect of the
-client library. The possible values for NAME are `GLX_VENDOR',
-`GLX_VERSION', and `GLX_EXTENSIONS'. If NAME is not set to one of these
-values, `glXGetClientString' returns `NULL'. The format and contents of
+client library. The possible values for NAME are `GLX_VENDOR',
+`GLX_VERSION', and `GLX_EXTENSIONS'. If NAME is not set to one of these
+values, `glXGetClientString' returns `NULL'. The format and contents of
the vendor string is implementation dependent.
The extensions string is null-terminated and contains a space-separated
-list of extension names. (The extension names never contain spaces.) If
+list of extension names. (The extension names never contain spaces.) If
there are no extensions to GLX, then the empty string is returned.
The version string is laid out as follows:
<major_version.minor_version><space><vendor-specific info>
Both the major and minor portions of the version number are of arbitrary
-length. The vendor-specific information is optional. However, if it is
+length. The vendor-specific information is optional. However, if it is
present, the format and contents are implementation specific.")
(define-glx-procedures
Specifies the connection to the X server.
VIS
- Specifies the visual to be queried. It is a pointer to an
+ Specifies the visual to be queried. It is a pointer to an
`XVisualInfo' structure, not a visual ID or a pointer to a
`Visual'.
Returns the requested value.
`glXGetConfig' sets VALUE to the ATTRIB value of windows or GLX pixmaps
-created with respect to VIS. `glXGetConfig' returns an error code if it
-fails for any reason. Otherwise, zero is returned.
+created with respect to VIS. `glXGetConfig' returns an error code if it
+fails for any reason. Otherwise, zero is returned.
ATTRIB is one of the following:
otherwise.
`GLX_BUFFER_SIZE'
- Number of bits per color buffer. For RGBA visuals,
+ Number of bits per color buffer. For RGBA visuals,
`GLX_BUFFER_SIZE' is the sum of `GLX_RED_SIZE', `GLX_GREEN_SIZE',
- `GLX_BLUE_SIZE', and `GLX_ALPHA_SIZE'. For color index visuals,
+ `GLX_BLUE_SIZE', and `GLX_ALPHA_SIZE'. For color index visuals,
`GLX_BUFFER_SIZE' is the size of the color indexes.
`GLX_LEVEL'
- Frame buffer level of the visual. Level zero is the default frame
- buffer. Positive levels correspond to frame buffers that overlay
+ Frame buffer level of the visual. Level zero is the default frame
+ buffer. Positive levels correspond to frame buffers that overlay
the default buffer, and negative levels correspond to frame buffers
that underlay the default buffer.
otherwise.
`GLX_AUX_BUFFERS'
- Number of auxiliary color buffers that are available. Zero
+ Number of auxiliary color buffers that are available. Zero
indicates that no auxiliary color buffers exist.
`GLX_RED_SIZE'
- Number of bits of red stored in each color buffer. Undefined if
+ Number of bits of red stored in each color buffer. Undefined if
`GLX_RGBA' is `False'.
`GLX_GREEN_SIZE'
- Number of bits of green stored in each color buffer. Undefined if
+ Number of bits of green stored in each color buffer. Undefined if
`GLX_RGBA' is `False'.
`GLX_BLUE_SIZE'
- Number of bits of blue stored in each color buffer. Undefined if
+ Number of bits of blue stored in each color buffer. Undefined if
`GLX_RGBA' is `False'.
`GLX_ALPHA_SIZE'
- Number of bits of alpha stored in each color buffer. Undefined if
+ Number of bits of alpha stored in each color buffer. Undefined if
`GLX_RGBA' is `False'.
`GLX_DEPTH_SIZE'
Number of bits of alpha stored in the accumulation buffer.
The X protocol allows a single visual ID to be instantiated with
-different numbers of bits per pixel. Windows or GLX pixmaps that will
-be rendered with OpenGL, however, must be instantiated with a color
-buffer depth of `GLX_BUFFER_SIZE'.
+different numbers of bits per pixel. Windows or GLX pixmaps that will be
+rendered with OpenGL, however, must be instantiated with a color buffer
+depth of `GLX_BUFFER_SIZE'.
Although a GLX implementation can export many visuals that support GL
-rendering, it must support at least one RGBA visual. This visual must
+rendering, it must support at least one RGBA visual. This visual must
have at least one color buffer, a stencil buffer of at least 1 bit, a
-depth buffer of at least 12 bits, and an accumulation buffer. Alpha
-bitplanes are optional in this visual. However, its color buffer size
+depth buffer of at least 12 bits, and an accumulation buffer. Alpha
+bitplanes are optional in this visual. However, its color buffer size
must be as great as that of the deepest `TrueColor', `DirectColor',
`PseudoColor', or `StaticColor' visual supported on level zero, and it
must itself be made available on level zero.
In addition, if the X server exports a `PseudoColor' or `StaticColor'
visual on framebuffer level 0, a color index visual is also required on
-that level. It must have at least one color buffer, a stencil buffer of
-at least 1 bit, and a depth buffer of at least 12 bits. This visual
-must have as many color bitplanes as the deepest `PseudoColor' or
+that level. It must have at least one color buffer, a stencil buffer of
+at least 1 bit, and a depth buffer of at least 12 bits. This visual must
+have as many color bitplanes as the deepest `PseudoColor' or
`StaticColor' visual supported on level 0.
Applications are best written to select the visual that most closely
-meets their requirements. Creating windows or GLX pixmaps with
+meets their requirements. Creating windows or GLX pixmaps with
unnecessary buffers can result in reduced rendering performance as well
as poor resource allocation.
value, `glXGetContextIDEXT' does not flush any pending events.
`glXGetContextIDEXT' is part of the `EXT_import_context' extension, not
-part of the core GLX command set. If _glxextstring(EXT_import_context)
+part of the core GLX command set. If _glxextstring(EXT_import_context)
is included in the string returned by `glXQueryExtensionsString', when
called with argument `GLX_EXTENSIONS', extension `EXT_import_context' is
supported.
"Return the current context.
`glXGetCurrentContext' returns the current context, as specified by
-`glXMakeCurrent'. If there is no current context, `NULL' is returned.
+`glXMakeCurrent'. If there is no current context, `NULL' is returned.
-`glXGetCurrentContext' returns client-side information. It does not
-make a round trip to the server.")
+`glXGetCurrentContext' returns client-side information. It does not make
+a round trip to the server.")
(define-glx-procedures
((glXGetCurrentDisplay -> Display-*))
"Get display for current context.
-`glXGetCurrentDisplay' returns the display for the current context. If
+`glXGetCurrentDisplay' returns the display for the current context. If
no context is current, `NULL' is returned.
-`glXGetCurrentDisplay' returns client-side information. It does not
-make a round-trip to the server, and therefore does not flush any
-pending events.")
+`glXGetCurrentDisplay' returns client-side information. It does not make
+a round-trip to the server, and therefore does not flush any pending
+events.")
(define-glx-procedures
((glXGetCurrentDrawable -> GLXDrawable))
"Return the current drawable.
`glXGetCurrentDrawable' returns the current drawable, as specified by
-`glXMakeCurrent'. If there is no current drawable, `None' is returned.
+`glXMakeCurrent'. If there is no current drawable, `None' is returned.
-`glXGetCurrentDrawable' returns client-side information. It does not
+`glXGetCurrentDrawable' returns client-side information. It does not
make a round trip to the server.")
(define-glx-procedures
"Return the current drawable.
`glXGetCurrentReadDrawable' returns the current read drawable, as
-specified by `read' parameter of `glXMakeContextCurrent'. If there is
-no current drawable, `None' is returned.
+specified by `read' parameter of `glXMakeContextCurrent'. If there is no
+current drawable, `None' is returned.
-`glXGetCurrentReadDrawable' returns client-side information. It does
-not make a round-trip to the server.")
+`glXGetCurrentReadDrawable' returns client-side information. It does not
+make a round-trip to the server.")
(define-glx-procedures
((glXGetFBConfigAttrib
Returns the requested value.
`glXGetFBConfigAttrib' sets VALUE to the ATTRIBUTE value of GLX
-drawables created with respect to CONFIG. `glXGetFBConfigAttrib'
-returns an error code if it fails for any reason. Otherwise, `Success'
-is returned.
+drawables created with respect to CONFIG. `glXGetFBConfigAttrib' returns
+an error code if it fails for any reason. Otherwise, `Success' is
+returned.
ATTRIBUTE is one of the following:
`GLX_BUFFER_SIZE'
- Number of bits per color buffer. If the frame buffer configuration
+ Number of bits per color buffer. If the frame buffer configuration
supports RGBA contexts, then `GLX_BUFFER_SIZE' is the sum of
`GLX_RED_SIZE', `GLX_GREEN_SIZE', `GLX_BLUE_SIZE', and
- `GLX_ALPHA_SIZE'. If the frame buffer configuration supports only
+ `GLX_ALPHA_SIZE'. If the frame buffer configuration supports only
color index contexts, `GLX_BUFFER_SIZE' is the size of the color
indexes.
`GLX_LEVEL'
- Frame buffer level of the configuration. Level zero is the default
- frame buffer. Positive levels correspond to frame buffers that
+ Frame buffer level of the configuration. Level zero is the default
+ frame buffer. Positive levels correspond to frame buffers that
overlay the default buffer, and negative levels correspond to frame
buffers that underlie the default buffer.
`GLX_AUX_BUFFERS'
- Number of auxiliary color buffers that are available. Zero
+ Number of auxiliary color buffers that are available. Zero
indicates that no auxiliary color buffers exist.
`GLX_RED_SIZE'
- Number of bits of red stored in each color buffer. Undefined if
+ Number of bits of red stored in each color buffer. Undefined if
RGBA contexts are not supported by the frame buffer configuration.
`GLX_GREEN_SIZE'
- Number of bits of green stored in each color buffer. Undefined if
+ Number of bits of green stored in each color buffer. Undefined if
RGBA contexts are not supported by the frame buffer configuration.
`GLX_BLUE_SIZE'
- Number of bits of blue stored in each color buffer. Undefined if
+ Number of bits of blue stored in each color buffer. Undefined if
RGBA contexts are not supported by the frame buffer configuration.
`GLX_ALPHA_SIZE'
- Number of bits of alpha stored in each color buffer. Undefined if
+ Number of bits of alpha stored in each color buffer. Undefined if
RGBA contexts are not supported by the frame buffer configuration.
`GLX_DEPTH_SIZE'
Mask indicating what type of GLX contexts can be made current to
- the frame buffer configuration. Valid bits are `GLX_RGBA_BIT' and
+ the frame buffer configuration. Valid bits are `GLX_RGBA_BIT' and
`GLX_COLOR_INDEX_BIT'.
`GLX_DRAWABLE_TYPE'
Mask indicating what drawable types the frame buffer configuration
- supports. Valid bits are `GLX_WINDOW_BIT', `GLX_PIXMAP_BIT', and
+ supports. Valid bits are `GLX_WINDOW_BIT', `GLX_PIXMAP_BIT', and
`GLX_PBUFFER_BIT'.
`GLX_X_RENDERABLE'
`GLX_X_VISUAL_TYPE'
- Visual type of associated visual. The returned value will be one
+ Visual type of associated visual. The returned value will be one
of: `GLX_TRUE_COLOR', `GLX_DIRECT_COLOR', `GLX_PSEUDO_COLOR',
`GLX_STATIC_COLOR', `GLX_GRAY_SCALE', `GLX_STATIC_GRAY', or
`GLX_NONE', if there is no associated visual (i.e., if
Integer value between 0 and the maximum frame buffer value for
indices, indicating the transparent index value for the frame
- buffer configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
+ buffer configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
`GLX_TRANSPARENT_INDEX'.
`GLX_TRANSPARENT_RED_VALUE'
Integer value between 0 and the maximum frame buffer value for red,
indicating the transparent red value for the frame buffer
- configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
+ configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
`GLX_TRANSPARENT_RGB'.
`GLX_TRANSPARENT_GREEN_VALUE'
Integer value between 0 and the maximum frame buffer value for
green, indicating the transparent green value for the frame buffer
- configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
+ configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
`GLX_TRANSPARENT_RGB'.
`GLX_TRANSPARENT_BLUE_VALUE'
Integer value between 0 and the maximum frame buffer value for
blue, indicating the transparent blue value for the frame buffer
- configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
+ configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
`GLX_TRANSPARENT_RGB'.
`GLX_TRANSPARENT_ALPHA_VALUE'
Integer value between 0 and the maximum frame buffer value for
alpha, indicating the transparent blue value for the frame buffer
- configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
+ configuration. Undefined if `GLX_TRANSPARENT_TYPE' is not
`GLX_TRANSPARENT_RGB'.
`GLX_MAX_PBUFFER_WIDTH'
The maximum number of pixels (width times height) for a pixel
- buffer. Note that this value may be less than
- `GLX_MAX_PBUFFER_WIDTH' times `GLX_MAX_PBUFFER_HEIGHT'. Also, this
+ buffer. Note that this value may be less than
+ `GLX_MAX_PBUFFER_WIDTH' times `GLX_MAX_PBUFFER_HEIGHT'. Also, this
value is static and assumes that no other pixel buffers or X
- resources are contending for the frame buffer memory. As a result,
+ resources are contending for the frame buffer memory. As a result,
it may not be possible to allocate a pixel buffer of the size given
by `GLX_MAX_PBUFFER_PIXELS'.
Applications should choose the frame buffer configuration that most
-closely meets their requirements. Creating windows, GLX pixmaps, or GLX
+closely meets their requirements. Creating windows, GLX pixmaps, or GLX
pixel buffers with unnecessary buffers can result in reduced rendering
performance as well as poor resource allocation.
`GLX_NO_EXTENSION' is returned if DPY does not support the GLX
-extension. `GLX_BAD_ATTRIBUTE' is returned if ATTRIBUTE is not a valid
+extension. `GLX_BAD_ATTRIBUTE' is returned if ATTRIBUTE is not a valid
GLX attribute.")
(define-glx-procedures
Returns the number of GLXFBConfigs returned.
`glXGetFBConfigs' returns a list of all GLXFBConfigs available on the
-screen specified by SCREEN. Use `glXGetFBConfigAttrib' to obtain
+screen specified by SCREEN. Use `glXGetFBConfigAttrib' to obtain
attribute values from a specific GLXFBConfig.")
(define-glx-procedures
to be returned.
`glXGetProcAddress' returns the address of the function specified in
-PROCNAME. This is necessary in environments where the OpenGL link
+PROCNAME. This is necessary in environments where the OpenGL link
library exports a different set of functions than the runtime library.")
(define-glx-procedures
Specifies the connection to the X server.
DRAW
- Specifies a GLX drawable. Must be a GLX pixel buffer or a window.
+ Specifies a GLX drawable. Must be a GLX pixel buffer or a window.
EVENT_MASK
Returns the events that are selected for DRAW.
If CONFIG is a valid GLX frame buffer configuration and it has an
associated X Visual, then information describing that visual is
-returned; otherwise `NULL' is returned. Use `XFree' to free the data
+returned; otherwise `NULL' is returned. Use `XFree' to free the data
returned.
Returns `NULL' if CONFIG is not a valid GLXFBConfig.")
Specifies a GLX rendering context.
`glXImportContextEXT' creates a GLXContext given the XID of an existing
-GLXContext. It may be used in place of `glXCreateContext', to share
+GLXContext. It may be used in place of `glXCreateContext', to share
another process's indirect rendering context.
Only the server-side context information can be shared between X
clients; client-side state, such as pixel storage modes, cannot be
-shared. Thus, `glXImportContextEXT' must allocate memory to store
-client-side information. This memory is freed by calling
+shared. Thus, `glXImportContextEXT' must allocate memory to store
+client-side information. This memory is freed by calling
`glXFreeContextEXT'.
-This call does not create a new XID. It merely makes an existing object
-available to the importing client (Display *). Like any XID, it goes
+This call does not create a new XID. It merely makes an existing object
+available to the importing client (Display *). Like any XID, it goes
away when the creating client drops its connection or the ID is
-explicitly deleted. Note that this is when the XID goes away. The
-object goes away when the XID goes away AND the context is not current
-to any thread.
+explicitly deleted. Note that this is when the XID goes away. The object
+goes away when the XID goes away AND the context is not current to any
+thread.
If CONTEXTID refers to a direct rendering context then no error is
generated but `glXImportContextEXT' returns NULL.
`glXImportContextEXT' is part of the `EXT_import_context' extension, not
-part of the core GLX command set. If _glxextstring(EXT_import_context)
+part of the core GLX command set. If _glxextstring(EXT_import_context)
is included in the string returned by `glXQueryExtensionsString', when
called with argument `GLX_EXTENSIONS', extension `EXT_import_context' is
supported.
Specifies the GLX context that is being queried.
`glXIsDirect' returns `True' if CTX is a direct rendering context,
-`False' otherwise. Direct rendering contexts pass rendering commands
+`False' otherwise. Direct rendering contexts pass rendering commands
directly from the calling process's address space to the rendering
-system, bypassing the X server. Nondirect rendering contexts pass all
+system, bypassing the X server. Nondirect rendering contexts pass all
rendering commands to the X server.
`GLXBadContext' is generated if CTX is not a valid GLX context.")
Specifies the connection to the X server.
DRAW
- Specifies a GLX drawable to render into. Must be an XID
+ Specifies a GLX drawable to render into. Must be an XID
representing a GLXWindow, GLXPixmap, or GLXPbuffer.
READ
- Specifies a GLX drawable to read from. Must be an XID representing
+ Specifies a GLX drawable to read from. Must be an XID representing
a GLXWindow, GLXPixmap, or GLXPbuffer.
CTX
Specifies the GLX context to be bound to READ and CTX.
`glXMakeContextCurrent' binds CTX to the current rendering thread and to
-the DRAW and READ GLX drawables. DRAW and READ may be the same.
+the DRAW and READ GLX drawables. DRAW and READ may be the same.
DRAW is used for all OpenGL operations except:
context is flushed and replaced by CTX.
The first time that CTX is made current, the viewport and scissor
-dimensions are set to the size of the DRAW drawable. The viewport and
+dimensions are set to the size of the DRAW drawable. The viewport and
scissor are not modified when CTX is subsequently made current.
To release the current context without assigning a new one, call
`NULL'.
`glXMakeContextCurrent' returns `True' if it is successful, `False'
-otherwise. If `False' is returned, the previously current rendering
+otherwise. If `False' is returned, the previously current rendering
context and drawable (if any) remain unchanged.
`BadMatch' is generated if DRAW and READ are not compatible.
Specifies the connection to the X server.
DRAWABLE
- Specifies a GLX drawable. Must be either an X window ID or a GLX
+ Specifies a GLX drawable. Must be either an X window ID or a GLX
pixmap ID.
CTX
`glXMakeCurrent' does two things: It makes CTX the current GLX rendering
context of the calling thread, replacing the previously current context
if there was one, and it attaches CTX to a GLX drawable, either a window
-or a GLX pixmap. As a result of these two actions, subsequent GL
+or a GLX pixmap. As a result of these two actions, subsequent GL
rendering calls use rendering context CTX to modify GLX drawable
-DRAWABLE (for reading and writing). Because `glXMakeCurrent' always
+DRAWABLE (for reading and writing). Because `glXMakeCurrent' always
replaces the current rendering context with CTX, there can be only one
current context per thread.
is released.
The first time CTX is made current to any thread, its viewport is set to
-the full size of DRAWABLE. Subsequent calls by any thread to
+the full size of DRAWABLE. Subsequent calls by any thread to
`glXMakeCurrent' with CTX have no effect on its viewport.
To release the current context without assigning a new one, call
drawable (if any) remain unchanged.
`BadMatch' is generated if DRAWABLE was not created with the same X
-screen and visual as CTX. It is also generated if DRAWABLE is `None'
-and CTX is not `NULL'.
+screen and visual as CTX. It is also generated if DRAWABLE is `None' and
+CTX is not `NULL'.
`BadAccess' is generated if CTX was current to another thread at the
time `glXMakeCurrent' was called.
Specifies a GLX rendering context.
ATTRIBUTE
- Specifies that a context parameter should be retrieved. Must be
- one of `GLX_SHARED_CONTEXT_EXT', `GLX_VISUAL_ID_EXT', or
+ Specifies that a context parameter should be retrieved. Must be one
+ of `GLX_SHARED_CONTEXT_EXT', `GLX_VISUAL_ID_EXT', or
`GLX_SCREEN_EXT'.
VALUE
Contains the return value for ATTRIBUTE.
`glXQueryContextInfoEXT' sets VALUE to the value of ATTRIBUTE with
-respect to CTX. `glXQueryContextInfoEXT' returns an error code if it
-fails for any reason. Otherwise, `Success' is returned.
+respect to CTX. `glXQueryContextInfoEXT' returns an error code if it
+fails for any reason. Otherwise, `Success' is returned.
ATTRIBUTE may be one of the following:
This call may cause a round-trip to the server.
`glXQueryContextInfoEXT' is part of the `EXT_import_context' extension,
-not part of the core GLX command set. If
+not part of the core GLX command set. If
_glxextstring(EXT_import_context) is included in the string returned by
`glXQueryExtensionsString', when called with argument `GLX_EXTENSIONS',
extension `EXT_import_context' is supported.
Specifies a GLX rendering context.
ATTRIBUTE
- Specifies that a context parameter should be retrieved. Must be
- one of `GLX_FBCONFIG_ID', `GLX_RENDER_TYPE', or `GLX_SCREEN'.
+ Specifies that a context parameter should be retrieved. Must be one
+ of `GLX_FBCONFIG_ID', `GLX_RENDER_TYPE', or `GLX_SCREEN'.
VALUE
Contains the return value for ATTRIBUTE.
`glXQueryContext' sets VALUE to the value of ATTRIBUTE with respect to
-CTX. ATTRIBUTE may be one of the following:
+CTX. ATTRIBUTE may be one of the following:
`GLX_FBCONFIG_ID'
Returns the XID of the GLXFBConfig associated with CTX.
Specifies the GLX drawable to be queried.
ATTRIBUTE
- Specifies the attribute to be returned. Must be one of
- `GLX_WIDTH', `GLX_HEIGHT', `GLX_PRESERVED_CONTENTS',
- `GLX_LARGEST_PBUFFER', or `GLX_FBCONFIG_ID'.
+ Specifies the attribute to be returned. Must be one of `GLX_WIDTH',
+ `GLX_HEIGHT', `GLX_PRESERVED_CONTENTS', `GLX_LARGEST_PBUFFER', or
+ `GLX_FBCONFIG_ID'.
VALUE
Contains the return value for ATTRIBUTE.
`GLX_LARGEST_PBUFFER'
Returns the value set when `glXCreatePbuffer' was called to create
- the GLXPbuffer. If `False' is returned, then the call to
+ the GLXPbuffer. If `False' is returned, then the call to
`glXCreatePbuffer' will fail to create a GLXPbuffer if the
requested size is larger than the implementation maximum or
- available resources. If `True' is returned, a GLXPbuffer of the
+ available resources. If `True' is returned, a GLXPbuffer of the
maximum availble size (if less than the requested width and height)
is created.
If DRAW is a GLXWindow or GLXPixmap and ATTRIBUTE is set to
`GLX_PRESERVED_CONTENTS' or `GLX_LARGETST_PBUFFER', the contents of
-VALUE are undefined. If ATTRIBUTE is not one of the attributes listed
+VALUE are undefined. If ATTRIBUTE is not one of the attributes listed
above, the contents of VALUE are unedfined.
A `GLXBadDrawable' is generated if DRAW is not a valid GLXDrawable.")
Specifies the screen number.
`glXQueryExtensionsString' returns a pointer to a string describing
-which GLX extensions are supported on the connection. The string is
+which GLX extensions are supported on the connection. The string is
null-terminated and contains a space-separated list of extension names.
(The extension names themselves never contain spaces.) If there are no
extensions to GLX, then the empty string is returned.")
Returns the base event code of the GLX server extension.
`glXQueryExtension' returns `True' if the X server of connection DPY
-supports the GLX extension, `False' otherwise. If `True' is returned,
+supports the GLX extension, `False' otherwise. If `True' is returned,
then ERRORBASE and EVENTBASE return the error base and event base of the
-GLX extension. These values should be added to the constant error and
-event values to determine the actual event or error values. Otherwise,
+GLX extension. These values should be added to the constant error and
+event values to determine the actual event or error values. Otherwise,
ERRORBASE and EVENTBASE are unchanged.
ERRORBASE and EVENTBASE do not return values if they are specified as
`GLX_VERSION', or `GLX_EXTENSIONS'.
`glXQueryServerString' returns a pointer to a static, null-terminated
-string describing some aspect of the server's GLX extension. The
+string describing some aspect of the server's GLX extension. The
possible values for NAME and the format of the strings is the same as
-for `glXGetClientString'. If NAME is not set to a recognized value,
+for `glXGetClientString'. If NAME is not set to a recognized value,
`NULL' is returned.")
(define-glx-procedures
Specifies the connection to the X server.
DRAW
- Specifies a GLX drawable. Must be a GLX pixel buffer or a window.
+ Specifies a GLX drawable. Must be a GLX pixel buffer or a window.
EVENT_MASK
Specifies the events to be returned for DRAW.
`glXSelectEvent' sets the GLX event mask for a GLX pixel buffer or a
-window. Calling `glXSelectEvent' overrides any previous event mask that
-was set by the client for DRAW. Note that it does not affect the event
+window. Calling `glXSelectEvent' overrides any previous event mask that
+was set by the client for DRAW. Note that it does not affect the event
masks that other clients may have specified for DRAW since each client
rendering to DRAW has a separate event mask for it.
Currently, only one GLX event, `GLX_PBUFFER_CLOBBER_MASK', can be
-selected. The following data is returned to the client when a
+selected. The following data is returned to the client when a
`GLX_PBUFFER_CLOBBER_MASK' event occurs:
typedef struct {
/* display the event was read from */
GLXDrawable DRAWABLE;
- /* i.d. of Drawable */
+ /* i.d. of Drawable */
unsigned int BUFFER_MASK;
/* mask indicating affected buffers */
Accumulation buffer
A single X server operation can cause several buffer clobber events to
-be sent. (e.g., a single GLX pixel buffer may be damaged and cause
-multiple buffer clobber events to be generated). Each event specifies
+be sent. (e.g., a single GLX pixel buffer may be damaged and cause
+multiple buffer clobber events to be generated). Each event specifies
one region of the GLX drawable that was affected by the X Server
-operation. The BUFFER_MASK field indicates which color buffers and
-ancillary buffers were affected. All the buffer clobber events
-generated by a single X server action are guaranteed to be contiguous in
-the event queue. The conditions under which this event is generated and
-the EVENT_TYPE varies, depending on the type of the GLX drawable.
+operation. The BUFFER_MASK field indicates which color buffers and
+ancillary buffers were affected. All the buffer clobber events generated
+by a single X server action are guaranteed to be contiguous in the event
+queue. The conditions under which this event is generated and the
+EVENT_TYPE varies, depending on the type of the GLX drawable.
When the `GLX_AUX_BUFFERS_BIT' is set in BUFFER_MASK, then AUX_BUFFER is
-set to indicate which buffer was affected. If more than one aux buffer
+set to indicate which buffer was affected. If more than one aux buffer
was affected, then additional events are generated as part of the same
-contiguous event group. Each additional event will have only the
+contiguous event group. Each additional event will have only the
`GLX_AUX_BUFFERS_BIT' set in BUFFER_MASK, and the AUX_BUFFER field will
-be set appropriately. For nonstereo drawables,
+be set appropriately. For nonstereo drawables,
`GLX_FRONT_LEFT_BUFFER_BIT' and `GLX_BACK_LEFT_BUFFER_BIT' are used to
specify the front and back color buffers.
For preserved GLX pixel buffers, a buffer clobber event with type
`GLX_SAVED' is generated whenever the contents of the GLX pixel buffer
-is moved out of offscreen memory. The event(s) describes which portions
-of the GLX pixel buffer were affected. Clients who receive many buffer
+is moved out of offscreen memory. The event(s) describes which portions
+of the GLX pixel buffer were affected. Clients who receive many buffer
clobber events, referring to different save actions, should consider
freeing the GLX pixel buffer resource in order to prevent the system
from thrashing due to insufficient resources.
For an unpreserved GLXPbuffer, a buffer clobber event, with type
`GLX_DAMAGED', is generated whenever a portion of the GLX pixel buffer
-becomes invalid. The client may wish to regenerate the invalid portions
+becomes invalid. The client may wish to regenerate the invalid portions
of the GLX pixel buffer.
For Windows, buffer clobber events, with type `GLX_SAVED', occur
whenever an ancillary buffer, associated with the window, gets clobbered
-or moved out of off-screen memory. The event contains information
+or moved out of off-screen memory. The event contains information
indicating which color buffers and ancillary buffers\\(emand which
portions of those buffers\\(emwere affected.
Specifies the drawable whose buffers are to be swapped.
`glXSwapBuffers' promotes the contents of the back buffer of DRAWABLE to
-become the contents of the front buffer of DRAWABLE. The contents of
-the back buffer then become undefined. The update typically takes place
+become the contents of the front buffer of DRAWABLE. The contents of the
+back buffer then become undefined. The update typically takes place
during the vertical retrace of the monitor, rather than immediately
after `glXSwapBuffers' is called.
Specifies the index of the first display list to be generated.
`glXUseXFont' generates COUNT display lists, named LISTBASE through
-LISTBASE+COUNT-1 , each containing a single `glBitmap' command. The
+LISTBASE+COUNT-1 , each containing a single `glBitmap' command. The
parameters of the `glBitmap' command of display list LISTBASE+I are
-derived from glyph FIRST+I . Bitmap parameters XORIG , YORIG , WIDTH ,
+derived from glyph FIRST+I . Bitmap parameters XORIG , YORIG , WIDTH ,
and HEIGHT are computed from font metrics as DESCENT-1 , -LBEARING ,
-RBEARING-LBEARING , and ASCENT+DESCENT , respectively. XMOVE is taken
-from the glyph's WIDTH metric, and YMOVE is set to zero. Finally, the
+RBEARING-LBEARING , and ASCENT+DESCENT , respectively. XMOVE is taken
+from the glyph's WIDTH metric, and YMOVE is set to zero. Finally, the
glyph's image is converted to the appropriate format for `glBitmap'.
Using `glXUseXFont' may be more efficient than accessing the X font and
bitmap until it is accessed.
Empty display lists are created for all glyphs that are requested and
-are not defined in FONT. `glXUseXFont' is ignored if there is no
-current GLX context.
+are not defined in FONT. `glXUseXFont' is ignored if there is no current
+GLX context.
`BadFont' is generated if FONT is not a valid font.
"Complete GL execution prior to subsequent X calls.
GL rendering calls made prior to `glXWaitGL' are guaranteed to be
-executed before X rendering calls made after `glXWaitGL'. Although this
+executed before X rendering calls made after `glXWaitGL'. Although this
same result can be achieved using `glFinish', `glXWaitGL' does not
require a round trip to the server, and it is therefore more efficient
in cases where client and server are on separate machines.
"Complete X execution prior to subsequent GL calls.
X rendering calls made prior to `glXWaitX' are guaranteed to be executed
-before GL rendering calls made after `glXWaitX'. Although the same
+before GL rendering calls made after `glXWaitX'. Although the same
result can be achieved using `XSync', `glXWaitX' does not require a
round trip to the server, and it is therefore more efficient in cases
where client and server are on separate machines.
but will not directly affect transform feedback state. Instead, the indexed <constant>GL_TRANSFORM_FEEDBACK_BUFFER</constant>\r
bindings must be used through a call to <citerefentry><refentrytitle>glBindBufferBase</refentrytitle></citerefentry>\r
or <citerefentry><refentrytitle>glBindBufferRange</refentrytitle></citerefentry>. This will affect the generic\r
- <constant>GL_TRANSFORM_FEEDBACK_BUFFER</constant> binding.\r
+ <constant>GL_TRANSFORM_FEEDABCK_BUFFER</constant> binding.\r
</para>\r
<para>\r
Likewise, the <constant>GL_UNIFORM_BUFFER</constant> buffer binding point may be used, but does not directly affect\r
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>colorNumber</parameter> is greater than or equal to <constant>GL_MAX_DRAW_BUFFERS</constant>.\r
</para>\r
<para>\r
- <constant>GL_INVALID_VALUE</constant> is generated if <parameter>colorNumber</parameter> is greater than or equal to <constant>GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</constant>\r
- and <parameter>index</parameter> is greater than or equal to the value of <constant>GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</constant>.\r
+ <constant>GL_INVALID_VALUE</constant> is generated if <parameter>colorNumber</parameter> is greater than or equal to <constant>GL_MAX_DUAL_SOURCE_DRAW_BUFERS</constant>\r
+ and <parameter>index</parameter> is greater than or equal to one.\r
</para>\r
<para>\r
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>index</parameter> is greater than one.\r
<refsect1 id="errors"><title>Errors</title>\r
<para>\r
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>unit</parameter> is greater than or equal to the value of\r
- <constant>GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS</constant>.\r
+ <constant>GL_MAX_COMBIED_TEXTURE_IMAGE_UNITS</constant>.\r
</para>\r
<para>\r
<constant>GL_INVALID_OPERATION</constant> is generated if <parameter>sampler</parameter> is not zero or a name previously\r
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
<para>
- <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_SRC_RGB</constant>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_SRC</constant>
</para>
<para>
- <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_SRC_ALPHA</constant>
- </para>
- <para>
- <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_DST_RGB</constant>
- </para>
- <para>
- <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_DST_ALPHA</constant>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_DST</constant>
</para>
<para>
<citerefentry><refentrytitle>glIsEnabled</refentrytitle></citerefentry> with argument <constant>GL_BLEND</constant>
<listitem>\r
<para>\r
<constant>GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER</constant> is returned if the value of <constant>GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</constant>\r
- is <constant>GL_NONE</constant> for any color attachment point(s) named by <constant>GL_DRAW_BUFFERi</constant>.\r
+ is <constant>GL_NONE</constant> for any color attachment point(s) named by <constant>GL_DRAWBUFFERi</constant>.\r
</para>\r
</listitem>\r
<listitem>\r
<refsect1 id="description"><title>Description</title>\r
<para>\r
<function>glClearBuffer*</function> clears the specified buffer to the specified value(s). If <parameter>buffer</parameter> is\r
- <constant>GL_COLOR</constant>, a particular draw buffer <constant>GL_DRAW
_BUFFER<parameter>i</parameter></constant> is specified
\r+ <constant>GL_COLOR</constant>, a particular draw buffer <constant>GL_DRAWBUFFER<parameter>i</parameter></constant> is specified\r
by passing <parameter>i</parameter> as <parameter>drawBuffer</parameter>. In this case, <parameter>value</parameter> points to\r
a four-element vector specifying the R, G, B and A color to clear that draw buffer to. If <parameter>buffer</parameter> is\r
one of <constant>GL_FRONT</constant>, <constant>GL_BACK</constant>, <constant>GL_LEFT</constant>, <constant>GL_RIGHT</constant>,\r
</para>
<para>
If <parameter>target</parameter> is <constant>GL_PROXY_TEXTURE_2D</constant>, <constant>GL_PROXY_TEXTURE_1D_ARRAY</constant>
- or <constant>GL_PROXY_
TEXTURE_CUBE_MAP</constant>, no data is read from <parameter>data</parameter>, but
+ or <constant>GL_PROXY_CUBE_MAP</constant>, no data is read from <parameter>data</parameter>, 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
<listitem>
<para>
Specifies the width of the texture image.
+ Must be 0 or
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup n + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer
+ <inlineequation><mml:math><mml:mi mathvariant="italic">n</mml:mi></mml:math></inlineequation>.
The height of the texture image is 1.
</para>
</listitem>
<term><parameter>border</parameter></term>
<listitem>
<para>
- Must be 0.
+ Specifies the width of the border.
+ Must be either 0 or 1.
</para>
</listitem>
</varlistentry>
<!-- eqn: width + 2 ( border ): -->
<mml:mrow>
<mml:mi mathvariant="italic">width</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>
defines the texture array
<constant>GL_MAX_TEXTURE_SIZE</constant>.
</para>
<para>
- <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0.
+ <constant>GL_INVALID_VALUE</constant> is generated if non-power-of-two textures are not supported and the <parameter>width</parameter> cannot be represented as
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup n + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer value of <emphasis>n</emphasis>.
+ </para>
+ <para>
+ <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0 or 1.
</para>
<para>
<constant>GL_INVALID_OPERATION</constant> is generated if <parameter>internalformat</parameter> is
<listitem>
<para>
Specifies the width of the texture image.
+ Must be 0 or
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup n + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer
+ <inlineequation><mml:math><mml:mi mathvariant="italic">n</mml:mi></mml:math></inlineequation>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Specifies the height of the texture image.
+ Must be 0 or
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup m + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">m</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer
+ <inlineequation><mml:math><mml:mi mathvariant="italic">m</mml:mi></mml:math></inlineequation>.
</para>
</listitem>
</varlistentry>
<term><parameter>border</parameter></term>
<listitem>
<para>
- Must be 0.
+ Specifies the width of the border.
+ Must be either 0 or 1.
</para>
</listitem>
</varlistentry>
<!-- eqn: width + 2 ( border ): -->
<mml:mrow>
<mml:mi mathvariant="italic">width</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>
and a height of
<!-- eqn: height + 2 ( border ): -->
<mml:mrow>
<mml:mi mathvariant="italic">height</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>
defines the texture array
is the returned value of <constant>GL_MAX_TEXTURE_SIZE</constant>.
</para>
<para>
- <constant>GL_INVALID_VALUE</constant> is generated if either <parameter>width</parameter> or <parameter>height</parameter> is less than 0
+ <constant>GL_INVALID_VALUE</constant> is generated if <parameter>width</parameter> is less than 0
or greater than
<constant>GL_MAX_TEXTURE_SIZE</constant>.
</para>
<para>
- <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0.
+ <constant>GL_INVALID_VALUE</constant> is generated if non-power-of-two textures are not supported and the <parameter>width</parameter> or <parameter>depth</parameter> cannot be represented as
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup k + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">k</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer
+ <inlineequation><mml:math><mml:mi mathvariant="italic">k</mml:mi></mml:math></inlineequation>.
+ </para>
+ <para>
+ <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0 or 1.
</para>
<para>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>internalformat</parameter> is not an
than from main memory, as is the case for <citerefentry><refentrytitle>glTexSubImage1D</refentrytitle></citerefentry>).
</para>
<para>
- The screen-aligned pixel row with left corner at (<parameter>x</parameter>, <parameter>y</parameter>), and with
+ The screen-aligned pixel row with left corner at (<parameter>x</parameter>,
\ <parameter>y</parameter>), and with
length <parameter>width</parameter> replaces the portion of the
texture array with x indices <parameter>xoffset</parameter> through
<inlineequation><mml:math>
rendering context, then the values obtained for those pixels are undefined.
</para>
<para>
- No change is made to the <emphasis>internalformat</emphasis> or <emphasis>width</emphasis> parameters of the specified texture
+ No change is made to the <emphasis>internalformat</emphasis>, <emphasis>width</emphasis>,
+ or <emphasis>border</emphasis> parameters of the specified texture
array or to texel values outside the specified subregion.
</para>
</refsect1>
</refsect1>
<refsect1 id="errors"><title>Errors</title>
<para>
- <constant>GL_INVALID_ENUM</constant> is generated if <parameter>target</parameter> is not <constant>GL_TEXTURE_1D</constant>.
+ <constant>GL_INVALID_ENUM</constant> is generated if
/<parameter>target</parameter> is not <constant>GL_TEXTURE_1D</constant>.
</para>
<para>
<constant>GL_INVALID_OPERATION</constant> is generated if the texture array has not
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
where
<inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_WIDTH</constant>
+ is the <constant>GL_TEXTURE_WIDTH</constant> and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">b</mml:mi></mml:math></inlineequation>
+ is the <constant>GL_TEXTURE_BORDER</constant>
of the texture image being modified.
+ Note that
+ <inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
+ includes twice the border width.
+ </para>
+ <para>
</para>
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
rendering context, then the values obtained for those pixels are undefined.
</para>
<para>
- No change is made to the <emphasis>internalformat</emphasis>, <emphasis>width</emphasis> or
- <emphasis>height</emphasis> parameters of the specified texture
+ No change is made to the <emphasis>internalformat</emphasis>, <emphasis>width</emphasis>,
+ <emphasis>height</emphasis>, or <emphasis>border</emphasis> parameters of the specified texture
array or to texel values outside the specified subregion.
</para>
</refsect1>
<constant>GL_TEXTURE_CUBE_MAP_NEGATIVE_X</constant>,
<constant>GL_TEXTURE_CUBE_MAP_POSITIVE_Y</constant>,
<constant>GL_TEXTURE_CUBE_MAP_NEGATIVE_Y</constant>,
- <constant>GL_TEXTURE_CUBE_MAP_POSITIVE_Z</constant>,
- <constant>GL_TEXTURE_CUBE_MAP_NEGATIVE_Z</constant>, or
- <constant>GL_TEXTURE_1D_ARRAY</constant>.
+ <constant>GL_TEXTURE_CUBE_MAP_POSITIVE_Z</constant>, or
+ <constant>GL_TEXTURE_CUBE_MAP_NEGATIVE_Z</constant>.
</para>
<para>
<constant>GL_INVALID_OPERATION</constant> is generated if the texture array has not been
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mrow>
- <mml:mi mathvariant="italic">w</mml:mi>
- </mml:mrow>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
where
<inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_WIDTH</constant>, and
+ is the <constant>GL_TEXTURE_WIDTH</constant>,
<inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_HEIGHT</constant>
+ is the <constant>GL_TEXTURE_HEIGHT</constant>,
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">b</mml:mi></mml:math></inlineequation>
+ is the <constant>GL_TEXTURE_BORDER</constant>
of the texture image being modified.
+ Note that
+ <inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>
+ include twice the border width.
</para>
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
</para>
<para>
No change is made to the <emphasis>internalformat</emphasis>, <emphasis>width</emphasis>,
- <emphasis>height</emphasis>, or <emphasis>depth</emphasis> parameters of the specified texture
+ <emphasis>height</emphasis>, <emphasis>depth</emphasis>, or <emphasis>border</emphasis> parameters of the specified texture
array or to texel values outside the specified subregion.
</para>
</refsect1>
</refsect1>
<refsect1 id="errors"><title>Errors</title>
<para>
- <constant>GL_INVALID_ENUM</constant> is generated if <parameter>target</parameter> is not <constant>GL_TEXTURE_3D</constant> or <constant>GL_TEXTURE_2D_ARRAY</constant>.
+ <constant>GL_INVALID_ENUM</constant> is generated if /<parameter>target</parameter> is not <constant>GL_TEXTURE_3D</constant>.
</para>
<para>
<constant>GL_INVALID_OPERATION</constant> is generated if the texture array has not
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
<mml:mrow>
<mml:mi mathvariant="italic">zoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
where
<inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
is the <constant>GL_TEXTURE_WIDTH</constant>,
<inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_HEIGHT</constant>, and
+ is the <constant>GL_TEXTURE_HEIGHT</constant>,
<inlineequation><mml:math><mml:mi mathvariant="italic">d</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_DEPTH</constant>
+ is the <constant>GL_TEXTURE_DEPTH</constant>,
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">b</mml:mi></mml:math></inlineequation>
+ is the <constant>GL_TEXTURE_BORDER</constant>
of the texture image being modified.
+ Note that
+ <inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>,
+ <inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>,
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">d</mml:mi></mml:math></inlineequation>
+ include twice the border width.
</para>
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
<para><constant>GL_INVALID_ENUM</constant> is generated if the GL is bound
to a framebuffer object and one or more of the values in <parameter>bufs</parameter>
is anything other than <constant>GL_NONE</constant> or one of the
- <constant>GL_COLOR_ATTACHMENT<emphasis>n</emphasis></constant> tokens.</para>
+ <constant>GL_COLOR_ATTACHMENTS<emphasis>n</emphasis></constant> tokens.</para>
<para><constant>GL_INVALID_ENUM</constant> is generated if
<parameter>n</parameter> is less than 0.</para>
<refsect1 id="description"><title>Description</title>\r
<para>\r
<function>glFlushMappedBufferRange</function> indicates that modifications have been made to a range of a mapped buffer.\r
- The buffer must previously have been mapped with the <constant>GL_MAP_FLUSH_EXPLICIT
_BIT</constant> flag. <parameter>offset</parameter>
\r+ The buffer must previously have been mapped with the <constant>GL_MAP_FLUSH_EXPLICIT</constant> flag. <parameter>offset</parameter>\r
and <parameter>length</parameter> indicate the modified subrange of the mapping, in basic units. The specified subrange to flush\r
is relative to the start of the currently mapped range of the buffer. <function>glFlushMappedBufferRange</function> may be called\r
multiple times to indicate distinct subranges of the mapping which require flushing.\r
</para>\r
<para>\r
<constant>GL_INVALID_OPERATION</constant> is generated if the buffer bound to <parameter>target</parameter> is not\r
- mapped, or is mapped without the <constant>GL_MAP_FLUSH_EXPLICIT_BIT</constant> flag.\r
+ mapped, or is mapped without the <constant>GL_MAP_FLUSH_EXPLICIT</constant> flag.\r
</para>\r
</refsect1>\r
<refsect1 id="seealso"><title>See Also</title>\r
<para>\r
Specifies the attachment point of the framebuffer. <parameter>attachment</parameter> must be\r
<constant>GL_COLOR_ATTACHMENT<emphasis>i</emphasis></constant>, <constant>GL_DEPTH_ATTACHMENT</constant>,\r
- <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMENT</constant>.\r
+ <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMMENT</constant>.\r
</para>\r
</listitem>\r
</varlistentry>\r
<para>\r
<parameter>attachment</parameter> specifies the logical attachment of the framebuffer and must be\r
<constant>GL_COLOR_ATTACHMENT<emphasis>i</emphasis></constant>, <constant>GL_DEPTH_ATTACHMENT</constant>,\r
- <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMENT</constant>.\r
+ <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMMENT</constant>.\r
<emphasis>i</emphasis> in <constant>GL_COLOR_ATTACHMENT<emphasis>i</emphasis></constant> may range from zero to\r
the value of <constant>GL_MAX_COLOR_ATTACHMENTS</constant> - 1. Attaching a level of a texture to\r
<constant>GL_DEPTH_STENCIL_ATTACHMENT</constant> is equivalent to attaching that level to both the\r
<para>\r
Specifies the attachment point of the framebuffer. <parameter>attachment</parameter> must be\r
<constant>GL_COLOR_ATTACHMENT<emphasis>i</emphasis></constant>, <constant>GL_DEPTH_ATTACHMENT</constant>,\r
- <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMENT</constant>.\r
+ <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMMENT</constant>.\r
</para>\r
</listitem>\r
</varlistentry>\r
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><constant>GL_LINE_WIDTH_GRANULARITY</constant></term>
+ <listitem>
+ <para>
+ </para>
+ <para>
+ <parameter>params</parameter> returns one value,
+ the width difference between adjacent supported widths for antialiased lines.
+ See <citerefentry><refentrytitle>glLineWidth</refentrytitle></citerefentry>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><constant>GL_LINE_WIDTH_RANGE</constant></term>
+ <listitem>
+ <para>
+ </para>
+ <para>
+ <parameter>params</parameter> returns two values:
+ the smallest and largest supported widths for antialiased
+ lines.
+ See <citerefentry><refentrytitle>glLineWidth</refentrytitle></citerefentry>.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><constant>GL_LOGIC_OP_MODE</constant></term>
<listitem>
</listitem>
</varlistentry>
<varlistentry>
- <term><constant>GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</constant></term>
+ <term><constant>GL_MAX_DUALSOURCE_DRAW_BUFFERS</constant></term>
<listitem>
<para>
</para>
<parameter>params</parameter> returns one value.
The value gives a rough estimate of the largest rectangular texture that
the GL can handle. The value must be at least 1024.
- Use <constant>GL_PROXY_TEXTURE_RECTANGLE</constant>
+ Use <constant>GL_PROXY_RECTANGLE_TEXTURE</constant>
to determine if a texture is too large.
See <citerefentry><refentrytitle>glTexImage2D</refentrytitle></citerefentry>.
</para>
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><constant>GL_PROGRAM_POINT_SIZE</constant></term>
- <listitem>
- <para>
- </para>
- <para>
- <parameter>params</parameter> returns a single boolean value indicating whether vertex
- program point size mode is enabled. If enabled, then the
- point size is taken from the shader built-in <code>gl_PointSize</code>. If disabled,
- then the point size is taken from the point state as specified
- by <citerefentry><refentrytitle>glPointSize</refentrytitle></citerefentry>.
- The initial value is <constant>GL_FALSE</constant>.
- </para>
- </listitem>
- </varlistentry>
<varlistentry>
<term><constant>GL_PROVOKING_VERTEX</constant></term>
<listitem>
</listitem>
</varlistentry>
<varlistentry>
- <term><constant>GL_TEXTURE_BINDING_BUFFER</constant></term>
+ <term><constant>GL_TEXTURE_BUFFER_BINDING</constant></term>
<listitem>
<para>
</para>
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><constant>GL_VERTEX_PROGRAM_POINT_SIZE</constant></term>
+ <listitem>
+ <para>
+ </para>
+ <para>
+ <parameter>params</parameter> returns a single boolean value indicating whether vertex
+ program point size mode is enabled. If enabled, and a vertex shader is active, then the
+ point size is taken from the shader built-in <code>gl_PointSize</code>. If disabled,
+ and a vertex shader is active, then the point size is taken from the point state as specified
+ by <citerefentry><refentrytitle>glPointSize</refentrytitle></citerefentry>.
+ The initial value is <constant>GL_FALSE</constant>.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><constant>GL_VIEWPORT</constant></term>
<listitem>
</para>
<para>
<constant>GL_MAX_RECTANGLE_TEXTURE_SIZE</constant>, <constant>GL_MAX_TEXTURE_BUFFER_SIZE</constant>,
- <constant>GL_UNIFORM_BUFFER_BINDING</constant>, <constant>GL_TEXTURE_BINDING_BUFFER</constant>,
+ <constant>GL_UNIFORM_BUFFER_BINDING</constant>, <constant>GL_TEXTURE_BUFFER_BINDING</constant>,
<constant>GL_MAX_VERTEX_UNIFORM_BLOCKS</constant>, <constant>GL_MAX_FRAGMENT_UNIFORM_BLOCKS</constant>,
<constant>GL_MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS</constant>, <constant>GL_MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS</constant>
<constant>GL_MAX_COMBINED_UNIFORM_BLOCKS</constant>, <constant>GL_MAX_UNIFORM_BLOCK_SIZE</constant>,
the GL version is 3.2 or greater.
</para>
<para>
- <constant>GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</constant>, <constant>GL_SAMPLER_BINDING</constant>, and
+ <constant>GL_MAX_DUALSOURCE_DRAW_BUFFERS</constant>, <constant>GL_SAMPLER_BINDING</constant>, and
<constant>GL_TIMESTAMP</constant> are available only if the GL version is 3.3 or greater.
</para>
</refsect1>
<constant>GL_INT_VEC2</constant>,
<constant>GL_INT_VEC3</constant>,
<constant>GL_INT_VEC4</constant>,
- <constant>GL_UNSIGNED_INT</constant>,
+ <constant>GL_UNSIGNED_INT_VEC</constant>,
<constant>GL_UNSIGNED_INT_VEC2</constant>,
<constant>GL_UNSIGNED_INT_VEC3</constant>, or
<constant>GL_UNSIGNED_INT_VEC4</constant> may be returned. The
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
<para><citerefentry><refentrytitle>glGet</refentrytitle></citerefentry>
- with argument
- <constant>GL_MAX_VERTEX_UNIFORM_COMPONENTS</constant>,
+ with argument <constant>GL_MAX_VERTEX_UNIFORM_COMPONENTS</constant>,
<constant>GL_MAX_GEOMETRY_UNIFORM_COMPONENTS</constant>,
- <constant>GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</constant>,
- <constant>GL_MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS</constant>,
- <constant>GL_MAX_COMBINED_GEOMETRY_UNIFORM_COMPONENTS</constant>,
- <constant>GL_MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS</constant>.</para>
+ <constant>GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</constant>, or
+ <constant>GL_MAX_COMBINED_UNIFORM_COMPONENTS</constant>.</para>
<para><citerefentry><refentrytitle>glGetProgram</refentrytitle></citerefentry>
with argument <constant>GL_ACTIVE_UNIFORMS</constant> or
<paramdef>GLuint <parameter>program</parameter></paramdef>\r
<paramdef>GLuint <parameter>uniformBlockIndex</parameter></paramdef>\r
<paramdef>GLenum <parameter>pname</parameter></paramdef>\r
- <paramdef>GLint
*<parameter>params</parameter></paramdef>
\r+ <paramdef>GLint <parameter>params</parameter></paramdef>\r
</funcprototype>\r
</funcsynopsis>\r
</refsynopsisdiv>\r
</refsect1>\r
<refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group. \r
+ Copyright <trademark class="copyright"></trademark> 2010 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
<para><citerefentry><refentrytitle>glGet</refentrytitle></citerefentry>\r
with argument <constant>GL_MAX_VERTEX_UNIFORM_COMPONENTS</constant>,\r
<constant>GL_MAX_GEOMETRY_UNIFORM_COMPONENTS</constant>,\r
- <constant>GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</constant>,\r
- <constant>GL_MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS</constant>,\r
- <constant>GL_MAX_COMBINED_GEOMETRY_UNIFORM_COMPONENTS</constant>,\r
- <constant>GL_MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS</constant>.</para>\r
+ <constant>GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</constant>, or\r
+ <constant>GL_MAX_COMBINED_UNIFORM_COMPONENTS</constant>.</para>\r
\r
<para><citerefentry><refentrytitle>glGetProgram</refentrytitle></citerefentry>\r
with argument <constant>GL_ACTIVE_UNIFORMS</constant> or\r
<?xml version="1.0" encoding="UTF-8"?>\r
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"\r
"http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">\r
-<refentry id="glGetBufferParameter">\r
+<refentry id="glGetBufferParameteriv">\r
<refmeta>\r
<refmetainfo>\r
<copyright>\r
<paramdef>GLint * <parameter>data</parameter></paramdef>\r
</funcprototype>\r
</funcsynopsis>\r
- <funcsynopsis>\r
- <funcprototype>\r
- <funcdef>void <function>glGetBufferParameteri64v</function></funcdef>\r
- <paramdef>GLenum <parameter>target</parameter></paramdef>\r
- <paramdef>GLenum <parameter>value</parameter></paramdef>\r
- <paramdef>GLint64 * <parameter>data</parameter></paramdef>\r
- </funcprototype>\r
- </funcsynopsis>\r
</refsynopsisdiv>\r
<refsect1 id="parameters"><title>Parameters</title>\r
<variablelist>\r
If an error is generated,\r
no change is made to the contents of <parameter>data</parameter>.\r
</para>\r
- <para>\r
- <function>glGetBufferParameteri64v</function> is available only if the GL version is 3.2 or higher.\r
- </para>\r
</refsect1>\r
<refsect1 id="errors"><title>Errors</title>\r
<para>\r
<refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
Copyright <trademark class="copyright"></trademark> 2005 Addison-Wesley. \r
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
+ "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
+<refentry id="glGetBufferParameteriv">
+ <refmeta>
+ <refmetainfo>
+ <copyright>
+ <year>2005</year>
+ <holder>Sams Publishing</holder>
+ </copyright>
+ </refmetainfo>
+ <refentrytitle>glGetBufferParameteriv</refentrytitle>
+ <manvolnum>3G</manvolnum>
+ </refmeta>
+ <refnamediv>
+ <refname>glGetBufferParameteriv</refname>
+ <refpurpose>return parameters of a buffer object</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv><title>C Specification</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>glGetBufferParameteriv</function></funcdef>
+ <paramdef>GLenum <parameter>target</parameter></paramdef>
+ <paramdef>GLenum <parameter>value</parameter></paramdef>
+ <paramdef>GLint * <parameter>data</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>glGetBufferParameteri64v</function></funcdef>
+ <paramdef>GLenum <parameter>target</parameter></paramdef>
+ <paramdef>GLenum <parameter>value</parameter></paramdef>
+ <paramdef>GLint64 * <parameter>data</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+ <refsect1 id="parameters"><title>Parameters</title>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>target</parameter></term>
+ <listitem>
+ <para>
+ Specifies the target buffer object.
+ The symbolic constant must be <constant>GL_ARRAY_BUFFER</constant>,
+ <constant>GL_ELEMENT_ARRAY_BUFFER</constant>,
+ <constant>GL_PIXEL_PACK_BUFFER</constant>, or
+ <constant>GL_PIXEL_UNPACK_BUFFER</constant>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>value</parameter></term>
+ <listitem>
+ <para>
+ Specifies the symbolic name of a buffer object parameter.
+ Accepted values are <constant>GL_BUFFER_ACCESS</constant>, <constant>GL_BUFFER_MAPPED</constant>,
+ <constant>GL_BUFFER_SIZE</constant>, or <constant>GL_BUFFER_USAGE</constant>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>data</parameter></term>
+ <listitem>
+ <para>
+ Returns the requested parameter.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+ <refsect1 id="description"><title>Description</title>
+ <para>
+ <function>glGetBufferParameteriv</function> returns in <parameter>data</parameter> a selected parameter of the buffer object
+ specified by <parameter>target</parameter>.
+ </para>
+ <para>
+ <parameter>value</parameter> names a specific buffer object parameter, as follows:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><constant>GL_BUFFER_ACCESS</constant></term>
+ <listitem>
+ <para>
+ <parameter>params</parameter> returns the access policy set while mapping the buffer object.
+ The initial value is <constant>GL_READ_WRITE</constant>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><constant>GL_BUFFER_MAPPED</constant></term>
+ <listitem>
+ <para>
+ <parameter>params</parameter> returns a flag indicating whether the buffer object is currently
+ mapped. The initial value is <constant>GL_FALSE</constant>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><constant>GL_BUFFER_SIZE</constant></term>
+ <listitem>
+ <para>
+ <parameter>params</parameter> returns the size of the buffer object, measured in bytes.
+ The initial value is 0.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><constant>GL_BUFFER_USAGE</constant></term>
+ <listitem>
+ <para>
+ <parameter>params</parameter> returns the buffer object's usage pattern. The initial value is
+ <constant>GL_STATIC_DRAW</constant>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+ <refsect1 id="notes"><title>Notes</title>
+ <para>
+ If an error is generated,
+ no change is made to the contents of <parameter>data</parameter>.
+ </para>
+ </refsect1>
+ <refsect1 id="errors"><title>Errors</title>
+ <para>
+ <constant>GL_INVALID_ENUM</constant> is generated if <parameter>target</parameter> or <parameter>value</parameter> is not an
+ accepted value.
+ </para>
+ <para>
+ <constant>GL_INVALID_OPERATION</constant> is generated if the reserved buffer object name 0 is bound to <parameter>target</parameter>.
+ </para>
+ </refsect1>
+ <refsect1 id="seealso"><title>See Also</title>
+ <para>
+ <citerefentry><refentrytitle>glBindBuffer</refentrytitle></citerefentry>,
+ <citerefentry><refentrytitle>glBufferData</refentrytitle></citerefentry>,
+ <citerefentry><refentrytitle>glMapBuffer</refentrytitle></citerefentry>,
+ <citerefentry><refentrytitle>glUnmapBuffer</refentrytitle></citerefentry>
+ </para>
+ </refsect1>
+ <refsect1 id="Copyright"><title>Copyright</title>
+ <para>
+ Copyright <trademark class="copyright"></trademark> 2005 Addison-Wesley.
+ This material may be distributed subject to the terms and conditions set forth in
+ the Open Publication License, v 1.0, 8 June 1999.
+ <ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
+ </para>
+ </refsect1>
+</refentry>
<refsynopsisdiv><title>C Specification</title>\r
<funcsynopsis>\r
<funcprototype>\r
- <funcdef>void <function>glGetFramebufferAttachmentParameteriv</function></funcdef>\r
+ <funcdef>void <function>glGetFramebufferAttachmentParameter</function></funcdef>\r
<paramdef>GLenum <parameter>target</parameter></paramdef>\r
<paramdef>GLenum <parameter>attachment</parameter></paramdef>\r
<paramdef>GLenum <parameter>pname</parameter></paramdef>\r
</refsect1>\r
<refsect1 id="description"><title>Description</title>\r
<para>\r
- <function>glGetFramebufferAttachmentParameteriv</function> returns information about attachments of a bound framebuffer\r
+ <function>glGetFramebufferAttachmentParameter</function> returns information about attachments of a bound framebuffer\r
object. <parameter>target</parameter> specifies the framebuffer binding point and must be <constant>GL_DRAW_FRAMEBUFFER</constant>,\r
<constant>GL_READ_FRAMEBUFFER</constant> or <constant>GL_FRAMEBUFFER</constant>. <constant>GL_FRAMEBUFFER</constant> is equivalent\r
to <constant>GL_DRAW_FRAMEBUFFER</constant>.\r
</refsect1>\r
<refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group. \r
+ Copyright <trademark class="copyright"></trademark> 2010 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
<refmeta>
<refmetainfo>
<copyright>
- <year>2013</year>
- <holder>Khronos Group</holder>
+ <year>1991-2006</year>
+ <holder>Silicon Graphics, Inc.</holder>
</copyright>
</refmetainfo>
<refentrytitle>glGetTexLevelParameter</refentrytitle>
<constant>GL_TEXTURE_HEIGHT</constant>,
<constant>GL_TEXTURE_DEPTH</constant>,
<constant>GL_TEXTURE_INTERNAL_FORMAT</constant>,
+ <constant>GL_TEXTURE_BORDER</constant>,
<constant>GL_TEXTURE_RED_SIZE</constant>,
<constant>GL_TEXTURE_GREEN_SIZE</constant>,
<constant>GL_TEXTURE_BLUE_SIZE</constant>,
<constant>GL_MAX_TEXTURE_SIZE</constant>, and <constant>GL_MAX_3D_TEXTURE_SIZE</constant> are not really
descriptive enough.
It has to report the largest square texture image that can be
- accommodated with mipmaps
- but a long skinny texture, or a texture without mipmaps may
+ 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.
<para>
<parameter>params</parameter> returns a single value,
the width of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</para>
</listitem>
</varlistentry>
<para>
<parameter>params</parameter> returns a single value,
the height of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</para>
</listitem>
</varlistentry>
<para>
<parameter>params</parameter> returns a single value,
the depth of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</para>
</listitem>
</varlistentry>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006
- Silicon Graphics, Inc. Copyright <trademark class="copyright"></trademark> 2010-2013
+ Silicon Graphics, Inc. Copyright <trademark class="copyright"></trademark> 2010
Khronos Group. This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
<paramdef>GLuint<parameter>index</parameter></paramdef>\r
<paramdef>GLsizei<parameter>bufSize</parameter></paramdef>\r
<paramdef>GLsizei *<parameter>length</parameter></paramdef>\r
- <paramdef>GLsizei
*<parameter>size</parameter></paramdef>
\r+ <paramdef>GLsizei<parameter>size</parameter></paramdef>\r
<paramdef>GLenum *<parameter>type</parameter></paramdef>\r
<paramdef>char *<parameter>name</parameter></paramdef>\r
</funcprototype>\r
variable selected by <parameter>index</parameter>. An <parameter>index</parameter> of 0 selects\r
the first varying variable specified in the <parameter>varyings</parameter> array passed\r
to <citerefentry><refentrytitle>glTransformFeedbackVaryings</refentrytitle></citerefentry>, and\r
- an <parameter>index</parameter> of <constant>GL_TRANSFORM_FEEDBACK_VARYINGS</constant> - 1 selects\r
+ an <parameter>index</parameter> of <constant>GL_TRANSFORM_FEEDBACK_VARYINGS-1</constant> selects\r
the last such variable.\r
</para>\r
<para>\r
</para>\r
</refsect1> <refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.\r
+ Copyright <trademark class="copyright"></trademark> 2010 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
</row>
<row>
<entry align="left">
- <constant>GL_TEXTURE_CUBE_MAP_SEAMLESS</constant>
+ <constant>GL_TEXTURE_CUBEMAP_SEAMLESS</constant>
</entry>
<entry align="left">
<citerefentry><refentrytitle>glEnable</refentrytitle></citerefentry>
<listitem>
<para>The total number of components to capture in any transform feedback varying variable
is greater than the constant <constant>GL_MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS</constant>
- and the buffer mode is <constant>GL_SEPARATE_ATTRIBS</constant>.</para>
+ and the buffer mode is <constant>SEPARATE_ATTRIBS</constant>.</para>
</listitem>
</itemizedlist>
<para>
<citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_POINT_SIZE</constant>
</para>
+ <para>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_POINT_SIZE_MIN</constant>
+ </para>
+ <para>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_POINT_SIZE_MAX</constant>
+ </para>
<para>
<citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_POINT_FADE_THRESHOLD_SIZE</constant>
</para>
<listitem>
<para>
Stencil values are read from the stencil buffer.
- Each index is converted to fixed point.
+ Each index is converted to fixed point,
+ shifted left or right depending on the value and sign of <constant>GL_INDEX_SHIFT</constant>,
+ and added to <constant>GL_INDEX_OFFSET</constant>.
+ If <constant>GL_MAP_STENCIL</constant> is <constant>GL_TRUE</constant>,
+ indices are replaced by their mappings in the table <constant>GL_PIXEL_MAP_S_TO_S</constant>.
</para>
</listitem>
</varlistentry>
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 clamped to the range
+ Each component is then multiplied by <constant>GL_DEPTH_SCALE</constant>,
+ added to <constant>GL_DEPTH_BIAS</constant>,
+ and finally clamped to the range
<inlineequation><mml:math>
<!-- eqn: [0,1]: -->
<mml:mfenced open="[" close="]">
</para>
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
+ <para>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_INDEX_MODE</constant>
+ </para>
<para>
<citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_PIXEL_PACK_BUFFER_BINDING</constant>
</para>
<funcdef>void <function>glTexBuffer</function></funcdef>\r
<paramdef>GLenum <parameter>target</parameter></paramdef>\r
<paramdef>GLenum <parameter>internalFormat</parameter></paramdef>\r
- <paramdef>G
Luint <parameter>buffer</parameter></paramdef>
\r+ <paramdef>G
luint<parameter>buffer</parameter></paramdef>
\r </funcprototype>\r
</funcsynopsis>\r
</refsynopsisdiv>\r
</refsect1>\r
<refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.\r
+ Copyright <trademark class="copyright"></trademark> 2010 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
Each element is a single red/green double
The GL converts it to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element is a single depth value.
- The GL converts it to floating point
+ The GL converts it to floating point, multiplies by the signed scale factor
+ <constant>GL_DEPTH_SCALE</constant>, adds the signed bias <constant>GL_DEPTH_BIAS</constant>,
and clamps to the range [0,1].
</para>
</listitem>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
Each element is a red/green double.
The GL converts it to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element is a single depth value.
- The GL converts it to floating point,
+ The GL converts it to floating point, multiplies by the signed scale factor
+ <constant>GL_DEPTH_SCALE</constant>, adds the signed bias <constant>GL_DEPTH_BIAS</constant>,
and clamps to the range [0,1].
</para>
</listitem>
<constant>GL_RGBA8UI</constant>,
<constant>GL_SRGB8_ALPHA8</constant>,
<constant>GL_RGB10_A2</constant>,
- <constant>GL_RGB10_A2UI</constant>,
- <constant>GL_R11F_G11F_B10F</constant>,
+ <constant>GL_RGBA10_A2UI</constant>,
+ <constant>GL_R11_G11_B10F</constant>,
<constant>GL_RG32F</constant>,
<constant>GL_RG32I</constant>,
<constant>GL_RG32UI</constant>,
<constant>GL_RG8</constant>,
<constant>GL_RG8I</constant>,
<constant>GL_RG8UI</constant>,
- <constant>GL_R32F</constant>,
+ <constant>GL_R23F</constant>,
<constant>GL_R32I</constant>,
<constant>GL_R32UI</constant>,
<constant>GL_R16F</constant>,
<constant>GL_R8</constant>,
<constant>GL_R8I</constant>,
<constant>GL_R8UI</constant>,
- <constant>GL_RGBA16_SNORM</constant>,
+ <constant>GL_RGBA16_UNORM</constant>,
<constant>GL_RGBA8_SNORM</constant>,
<constant>GL_RGB32F</constant>,
<constant>GL_RGB32I</constant>,
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
Each element is a red and green pair.
The GL converts each to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or if
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
where
<inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_WIDTH</constant>
+ is the <constant>GL_TEXTURE_WIDTH</constant>, and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">b</mml:mi></mml:math></inlineequation>
+ is
+ the width of the <constant>GL_TEXTURE_BORDER</constant>
of the texture image being modified.
+ Note that
+ <inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
+ includes twice the border width.
</para>
<para>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>width</parameter> is less than 0.
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
</mml:mrow>
+ </mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
<!-- eqn: (xoffset + width) > (w - b): -->
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
where
<inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_WIDTH</constant>, and
+ is the <constant>GL_TEXTURE_WIDTH</constant>,
<inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_HEIGHT</constant>
+ is the <constant>GL_TEXTURE_HEIGHT</constant>, and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">b</mml:mi></mml:math></inlineequation>
+ is the border width
of the texture image being modified.
+ Note that
+ <inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>
+ include twice the border width.
</para>
<para>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>width</parameter> or <parameter>height</parameter> is less than 0.
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
or
<mml:mrow>
<mml:mi mathvariant="italic">zoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
where
<inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
is the <constant>GL_TEXTURE_WIDTH</constant>,
<inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_HEIGHT</constant>, and
+ is the <constant>GL_TEXTURE_HEIGHT</constant>,
<inlineequation><mml:math><mml:mi mathvariant="italic">d</mml:mi></mml:math></inlineequation>
is the <constant>GL_TEXTURE_DEPTH</constant>
- of the texture image being modified.
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">b</mml:mi></mml:math></inlineequation>
+ is the border width of the texture image being modified.
+ Note that
+ <inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>,
+ <inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>,
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">d</mml:mi></mml:math></inlineequation>
+ include twice the border width.
</para>
<para>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>width</parameter>, <parameter>height</parameter>, or <parameter>depth</parameter>
<funcprototype>
<funcdef>void <function>glVertexAttribI3ui</function></funcdef>
<paramdef>GLuint <parameter>index</parameter></paramdef>
- <paramdef>GL
uint <parameter>v0</parameter></paramdef>
- <paramdef>GL
uint <parameter>v1</parameter></paramdef>
- <paramdef>GL
uint <parameter>v2</parameter></paramdef>
+ <paramdef>GL
oint <parameter>v0</parameter></paramdef>
+ <paramdef>GL
oint <parameter>v1</parameter></paramdef>
+ <paramdef>GL
oint <parameter>v2</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>void <function>glVertexAttrib4f</function></funcdef>
<term><parameter>type</parameter></term>
<listitem>
<para>Type of packing used on the data. This parameter must be
- <constant>GL_INT_2_10_10_10_REV</constant> or <constant>GL_UNSIGNED_INT_2_10_10_10_REV</constant>
+ <constant>GL_INT_10_10_10_2</constant> or <constant>GL_UNSIGNED_INT_10_10_10_2</constant>
to specify signed or unsigned data, respectively.</para>
</listitem>
</varlistentry>
<para><constant>GL_INVALID_ENUM</constant> is generated if
<function>glVertexAttribP</function> is used with a
<parameter>type</parameter> other than
- <constant>GL_INT_2_10_10_10_REV</constant> or
- <constant>GL_UNSIGNED_INT_2_10_10_10_REV</constant>.</para>
+ <constant>GL_INT_10_10_10_2</constant> or
+ <constant>GL_UNSIGNED_INT_10_10_10_2</constant>.</para>
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
<para><citerefentry><refentrytitle>glGet</refentrytitle></citerefentry>
</refsect1>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
- Copyright <trademark class="copyright"></trademark> 2003-2005 3Dlabs Inc. Ltd.
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.
+ Copyright <trademark class="copyright"></trademark> 2003-2005 3Dlabs Inc. Ltd.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
is referred to as instanced if its <constant>GL_VERTEX_ATTRIB_ARRAY_DIVISOR</constant> value is non-zero.\r
</para>\r
<para>\r
- <parameter>index</parameter> must be less than the value of <constant>GL_MAX_VERTEX_ATTRIBS</constant>.\r
+ <parameter>index</parameter> must be less than the value of <constant>GL_MAX_VERTEX_ATTRIBUTES</constant>.\r
</para>\r
</refsect1>\r
<refsect1 id="notes"><title>Notes</title>\r
<refsect1 id="errors"><title>Errors</title>\r
<para>\r
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>index</parameter> is greater\r
- than or equal to the value of <constant>GL_MAX_VERTEX_ATTRIBS</constant>.\r
+ than or equal to the value of <constant>GL_MAX_VERTEX_ATTRIBUTES</constant>.\r
</para>\r
</refsect1>\r
<refsect1 id="seealso"><title>See Also</title>\r
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBindBuffer
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glBindBuffer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBindBuffer — bind a named buffer object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glBindBuffer</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">buffer</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBindBuffer
</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div class="refentry" title="glBindBuffer"><a id="glBindBuffer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBindBuffer — bind a named buffer object</p></div><div class="refsynopsisdiv" title="C Specification"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">glBindBuffer</b>(</code></td><td>GLenum <var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLuint <var class="pdparam">buffer</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Parameters"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target to which the buffer object is bound.
The symbolic constant must be
<code class="constant">GL_ARRAY_BUFFER</code>,
<code class="constant">GL_UNIFORM_BUFFER</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>buffer</code></em></span></dt><dd><p>
Specifies the name of a buffer object.
- </p></dd></dl></div></div><div class="refsect1"
lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
+ </p></dd></dl></div></div><div class="refsect1"
title="Description"><a id="description"></a><h2>Description</h2><p>
<code class="function">glBindBuffer</code> binds a buffer object to the specified buffer binding point. Calling <code class="function">glBindBuffer</code> with
<em class="parameter"><code>target</code></em> set to one of the accepted symbolic constants and <em class="parameter"><code>buffer</code></em> set to the name
of a buffer object binds that buffer object name to the target. If no buffer object with name <em class="parameter"><code>buffer</code></em>
two rendering contexts share buffer object names only if they
explicitly enable sharing between contexts through the appropriate GL windows interfaces functions.
</p><p>
- <a href="glGenBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glGenBuffers</span></span></a> must be used to generate a set of unused buffer object names.
+ <a class="citerefentry" href="glGenBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glGenBuffers</span></span></a> must be used to generate a set of unused buffer object names.
</p><p>
The state of a buffer object immediately after it is first bound is an unmapped zero-sized memory buffer with
<code class="constant">GL_READ_WRITE</code> access and <code class="constant">GL_STATIC_DRAW</code> usage.
buffer object measured in basic machine units.
</p><p>
While a non-zero buffer object is bound to the <code class="constant">GL_ELEMENT_ARRAY_BUFFER</code> target,
- the indices parameter of <a href="glDrawElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawElements</span></span></a>,
- <a href="glDrawElementsInstanced.xml"><span class="citerefentry"><span class="refentrytitle">glDrawElementsInstanced</span></span></a>,
- <a href="glDrawElementsBaseVertex.xml"><span class="citerefentry"><span class="refentrytitle">glDrawElementsBaseVertex</span></span></a>,
- <a href="glDrawRangeElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawRangeElements</span></span></a>,
- <a href="glDrawRangeElementsBaseVertex.xml"><span class="citerefentry"><span class="refentrytitle">glDrawRangeElementsBaseVertex</span></span></a>,
- <a href="glMultiDrawElements.xml"><span class="citerefentry"><span class="refentrytitle">glMultiDrawElements</span></span></a>, or
- <a href="glMultiDrawElementsBaseVertex.xml"><span class="citerefentry"><span class="refentrytitle">glMultiDrawElementsBaseVertex</span></span></a> is interpreted as an
+ the indices parameter of <a class="citerefentry" href="glDrawElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawElements</span></span></a>,
+ <a class="citerefentry" href="glDrawElementsInstanced.xml"><span class="citerefentry"><span class="refentrytitle">glDrawElementsInstanced</span></span></a>,
+ <a class="citerefentry" href="glDrawElementsBaseVertex.xml"><span class="citerefentry"><span class="refentrytitle">glDrawElementsBaseVertex</span></span></a>,
+ <a class="citerefentry" href="glDrawRangeElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawRangeElements</span></span></a>,
+ <a class="citerefentry" href="glDrawRangeElementsBaseVertex.xml"><span class="citerefentry"><span class="refentrytitle">glDrawRangeElementsBaseVertex</span></span></a>,
+ <a class="citerefentry" href="glMultiDrawElements.xml"><span class="citerefentry"><span class="refentrytitle">glMultiDrawElements</span></span></a>, or
+ <a class="citerefentry" href="glMultiDrawElementsBaseVertex.xml"><span class="citerefentry"><span class="refentrytitle">glMultiDrawElementsBaseVertex</span></span></a> is interpreted as an
offset within the buffer object measured in basic machine units.
</p><p>
While a non-zero buffer object is bound to the <code class="constant">GL_PIXEL_PACK_BUFFER</code> target,
- the following commands are affected: <a href="glGetCompressedTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetCompressedTexImage</span></span></a>,
- <a href="glGetTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexImage</span></span></a>, and
- <a href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>. The pointer parameter is
+ the following commands are affected: <a class="citerefentry" href="glGetCompressedTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetCompressedTexImage</span></span></a>,
+ <a class="citerefentry" href="glGetTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexImage</span></span></a>, and
+ <a class="citerefentry" href="glReadPixels.xml"><span class="citerefentry"><span class="refentrytitle">glReadPixels</span></span></a>. The pointer parameter is
interpreted as an offset within the buffer object measured in basic machine units.
</p><p>
While a non-zero buffer object is bound to the <code class="constant">GL_PIXEL_UNPACK_BUFFER</code> target,
the following commands are affected:
- <a href="glCompressedTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage1D</span></span></a>,
- <a href="glCompressedTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage2D</span></span></a>,
- <a href="glCompressedTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage3D</span></span></a>,
- <a href="glCompressedTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexSubImage1D</span></span></a>,
- <a href="glCompressedTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexSubImage2D</span></span></a>,
- <a href="glCompressedTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexSubImage3D</span></span></a>,
- <a href="glTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage1D</span></span></a>,
- <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>,
- <a href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a>,
- <a href="glTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage1D</span></span></a>,
- <a href="glTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage2D</span></span></a>, and
- <a href="glTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage3D</span></span></a>. The pointer parameter is
+ <a class="citerefentry" href="glCompressedTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage1D</span></span></a>,
+ <a class="citerefentry" href="glCompressedTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage2D</span></span></a>,
+ <a class="citerefentry" href="glCompressedTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexImage3D</span></span></a>,
+ <a class="citerefentry" href="glCompressedTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexSubImage1D</span></span></a>,
+ <a class="citerefentry" href="glCompressedTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexSubImage2D</span></span></a>,
+ <a class="citerefentry" href="glCompressedTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glCompressedTexSubImage3D</span></span></a>,
+ <a class="citerefentry" href="glTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage1D</span></span></a>,
+ <a class="citerefentry" href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>,
+ <a class="citerefentry" href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a>,
+ <a class="citerefentry" href="glTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage1D</span></span></a>,
+ <a class="citerefentry" href="glTexSubImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage2D</span></span></a>, and
+ <a class="citerefentry" href="glTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage3D</span></span></a>. The pointer parameter is
interpreted as an offset within the buffer object measured in basic machine units.
</p><p>
The buffer targets <code class="constant">GL_COPY_READ_BUFFER</code> and <code class="constant">GL_COPY_WRITE_BUFFER</code>
- are provided to allow <a href="glCopyBufferSubData.xml"><span class="citerefentry"><span class="refentrytitle">glCopyBufferSubData</span></span></a>
- to be used without disturbing the state of other bindings. However, <a href="glCopyBufferSubData.xml"><span class="citerefentry"><span class="refentrytitle">glCopyBufferSubData</span></span></a>
+ are provided to allow <a class="citerefentry" href="glCopyBufferSubData.xml"><span class="citerefentry"><span class="refentrytitle">glCopyBufferSubData</span></span></a>
+ to be used without disturbing the state of other bindings. However, <a class="citerefentry" href="glCopyBufferSubData.xml"><span class="citerefentry"><span class="refentrytitle">glCopyBufferSubData</span></span></a>
may be used with any pair of buffer binding points.
</p><p>
The <code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER</code> buffer binding point may be passed to <code class="function">glBindBuffer</code>,
but will not directly affect transform feedback state. Instead, the indexed <code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER</code>
- bindings must be used through a call to <a href="glBindBufferBase.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferBase</span></span></a>
- or <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. This will affect the generic
- <code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER</code> binding.
+ bindings must be used through a call to <a class="citerefentry" href="glBindBufferBase.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferBase</span></span></a>
+ or <a class="citerefentry" href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. This will affect the generic
+ <code class="constant">GL_TRANSFORM_FEEDABCK_BUFFER</code> binding.
</p><p>
Likewise, the <code class="constant">GL_UNIFORM_BUFFER</code> buffer binding point may be used, but does not directly affect
- uniform buffer state. <a href="glBindBufferBase.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferBase</span></span></a>
- or <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a> must be used to bind a buffer to
+ uniform buffer state. <a class="citerefentry" href="glBindBufferBase.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferBase</span></span></a>
+ or <a class="citerefentry" href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a> must be used to bind a buffer to
an indexed uniform buffer binding point.
</p><p>
A buffer object binding created with <code class="function">glBindBuffer</code> remains active until a different
buffer object name is bound to the same target, or until the bound buffer object is
- deleted with <a href="glDeleteBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteBuffers</span></span></a>.
+ deleted with <a class="citerefentry" href="glDeleteBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteBuffers</span></span></a>.
</p><p>
Once created, a named buffer object may be re-bound to any target as often as needed. However,
the GL implementation may make choices about how to optimize the storage of a buffer object based
on its initial binding target.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
+ </p></div><div class="refsect1"
title="Notes"><a id="notes"></a><h2>Notes</h2><p>
The <code class="constant">GL_COPY_READ_BUFFER</code>, <code class="constant">GL_UNIFORM_BUFFER</code> and
<code class="constant">GL_TEXTURE_BUFFER</code> targets are available only if the GL version is 3.1 or greater.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
+ </p></div><div class="refsect1"
title="Errors"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>target</code></em> is not one of the allowable
values.
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>buffer</code></em> is not a name previously returned
- from a call to <a href="glGenBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glGenBuffers</span></span></a>.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_ARRAY_BUFFER_BINDING</code>
+ from a call to <a class="citerefentry" href="glGenBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glGenBuffers</span></span></a>.
+ </p></div><div class="refsect1"
title="Associated Gets"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_ARRAY_BUFFER_BINDING</code>
</p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_COPY_READ_BUFFER_BINDING</code>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_COPY_READ_BUFFER_BINDING</code>
</p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_COPY_WRITE_BUFFER_BINDING</code>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_COPY_WRITE_BUFFER_BINDING</code>
</p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_ELEMENT_ARRAY_BUFFER_BINDING</code>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_ELEMENT_ARRAY_BUFFER_BINDING</code>
</p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_PIXEL_PACK_BUFFER_BINDING</code>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_PIXEL_PACK_BUFFER_BINDING</code>
</p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_PIXEL_UNPACK_BUFFER_BINDING</code>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_PIXEL_UNPACK_BUFFER_BINDING</code>
</p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER_BINDING</code>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER_BINDING</code>
</p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_UNIFORM_BUFFER_BINDING</code>
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
- <a href="glGenBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glGenBuffers</span></span></a>,
- <a href="glBindBufferBase.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferBase</span></span></a>,
- <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>,
- <a href="glMapBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glMapBuffer</span></span></a>,
- <a href="glUnmapBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glUnmapBuffer</span></span></a>,
- <a href="glDeleteBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteBuffers</span></span></a>,
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>,
- <a href="glIsBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glIsBuffer</span></span></a>
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_UNIFORM_BUFFER_BINDING</code>
+ </p></div><div class="refsect1"
title="See Also"><a id="seealso"></a><h2>See Also</h2><p>
+ <a class="citerefentry" href="glGenBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glGenBuffers</span></span></a>,
+ <a class="citerefentry" href="glBindBufferBase.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferBase</span></span></a>,
+ <a class="citerefentry" href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>,
+ <a class="citerefentry" href="glMapBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glMapBuffer</span></span></a>,
+ <a class="citerefentry" href="glUnmapBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glUnmapBuffer</span></span></a>,
+ <a class="citerefentry" href="glDeleteBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteBuffers</span></span></a>,
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>,
+ <a class="citerefentry" href="glIsBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glIsBuffer</span></span></a>
+ </p></div><div class="refsect1"
title="Copyright"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 2005 Addison-Wesley.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
- <a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
+ <a class="ulink" href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
</p></div></div></body></html>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBindFragDataLocationIndexed
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glBindFragDataLocationIndexed"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBindFragDataLocationIndexed — bind a user-defined varying out variable to a fragment shader color number and index</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glBindFragDataLocationIndexed</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">colorNumber</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>const char * </td><td><var class="pdparam">name</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBindFragDataLocationIndexed</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glBindFragDataLocationIndexed"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBindFragDataLocationIndexed — bind a user-defined varying out variable to a fragment shader color number and index</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glBindFragDataLocationIndexed</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">colorNumber</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>const char * </td><td><var class="pdparam">name</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
The name of the program containing varying out variable whose binding to modify
</p></dd><dt><span class="term"><em class="parameter"><code>colorNumber</code></em></span></dt><dd><p>
The color number to bind the user-defined varying out variable to
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>colorNumber</code></em> is greater than or equal to <code class="constant">GL_MAX_DRAW_BUFFERS</code>.
</p><p>
- <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>colorNumber</code></em> is greater than or equal to <code class="constant">GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</code>
- and <em class="parameter"><code>index</code></em> is greater than or equal to the value of <code class="constant">GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</code>.
+ <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>colorNumber</code></em> is greater than or equal to <code class="constant">GL_MAX_DUAL_SOURCE_DRAW_BUFERS</code>
+ and <em class="parameter"><code>index</code></em> is greater than or equal to one.
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>index</code></em> is greater than one.
</p><p>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBindSampler
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glBindSampler"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBindSampler — bind a named sampler to a texturing target</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glBindSampler</b>(</code></td><td>GLuint </td><td><var class="pdparam">unit</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">sampler</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>unit</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBindSampler</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glBindSampler"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBindSampler — bind a named sampler to a texturing target</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glBindSampler</b>(</code></td><td>GLuint </td><td><var class="pdparam">unit</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">sampler</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>unit</code></em></span></dt><dd><p>
Specifies the index of the texture unit to which the sampler is bound.
</p></dd><dt><span class="term"><em class="parameter"><code>sampler</code></em></span></dt><dd><p>
Specifies the name of a sampler.
<code class="function">glBindSampler</code> is available only if the GL version is 3.3 or higher.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>unit</code></em> is greater than or equal to the value of
- <code class="constant">GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS</code>.
+ <code class="constant">GL_MAX_COMBIED_TEXTURE_IMAGE_UNITS</code>.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if <em class="parameter"><code>sampler</code></em> is not zero or a name previously
returned from a call to <a href="glGenSamplers.xml"><span class="citerefentry"><span class="refentrytitle">glGenSamplers</span></span></a>, or if such a name has
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBlendFunc
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glBlendFunc"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBlendFunc — specify pixel arithmetic</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glBlendFunc</b>(</code></td><td>GLenum </td><td><var class="pdparam">sfactor</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">dfactor</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sfactor</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBlendFunc</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glBlendFunc"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBlendFunc — specify pixel arithmetic</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glBlendFunc</b>(</code></td><td>GLenum </td><td><var class="pdparam">sfactor</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">dfactor</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sfactor</code></em></span></dt><dd><p>
Specifies how the red, green, blue,
and alpha source blending factors are computed.
The initial value is <code class="constant">GL_ONE</code>.
<code class="constant">GL_INVALID_ENUM</code> is generated if either <em class="parameter"><code>sfactor</code></em>
or <em class="parameter"><code>dfactor</code></em> is not an accepted value.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_SRC_RGB</code>
+ <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_SRC</code>
</p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_SRC_ALPHA</code>
- </p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_DST_RGB</code>
- </p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_DST_ALPHA</code>
+ <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_DST</code>
</p><p>
<a href="glIsEnabled.xml"><span class="citerefentry"><span class="refentrytitle">glIsEnabled</span></span></a> with argument <code class="constant">GL_BLEND</code>
</p><p>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCheckFramebufferStatus
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCheckFramebufferStatus"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCheckFramebufferStatus — check the completeness status of a framebuffer</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">GLenum <b class="fsfunc">glCheckFramebufferStatus</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCheckFramebufferStatus</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCheckFramebufferStatus"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCheckFramebufferStatus — check the completeness status of a framebuffer</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">GLenum <b class="fsfunc">glCheckFramebufferStatus</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specify the target of the framebuffer completeness check.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glCheckFramebufferStatus</code> queries the completeness status of the framebuffer object currently bound to <em class="parameter"><code>target</code></em>.
<code class="constant">GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT</code> is returned if the framebuffer does not have at least one image attached to it.
</p></li><li><p>
<code class="constant">GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER</code> is returned if the value of <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</code>
- is <code class="constant">GL_NONE</code> for any color attachment point(s) named by <code class="constant">GL_DRAW_BUFFERi</code>.
+ is <code class="constant">GL_NONE</code> for any color attachment point(s) named by <code class="constant">GL_DRAWBUFFERi</code>.
</p></li><li><p>
<code class="constant">GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER</code> is returned if <code class="constant">GL_READ_BUFFER</code> is not <code class="constant">GL_NONE</code>
and the value of <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</code> is <code class="constant">GL_NONE</code> for the color attachment point named
The value to clear a stencil render buffer to.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glClearBuffer*</code> clears the specified buffer to the specified value(s). If <em class="parameter"><code>buffer</code></em> is
- <code class="constant">GL_COLOR</code>, a particular draw buffer <code class="constant">GL_DRAW_BUFFER<em class="parameter"><code>i</code></em></code> is specified
+ <code class="constant">GL_COLOR</code>, a particular draw buffer <code class="constant">GL_DRAWBUFFER<em class="parameter"><code>i</code></em></code> is specified
by passing <em class="parameter"><code>i</code></em> as <em class="parameter"><code>drawBuffer</code></em>. In this case, <em class="parameter"><code>value</code></em> points to
a four-element vector specifying the R, G, B and A color to clear that draw buffer to. If <em class="parameter"><code>buffer</code></em> is
one of <code class="constant">GL_FRONT</code>, <code class="constant">GL_BACK</code>, <code class="constant">GL_LEFT</code>, <code class="constant">GL_RIGHT</code>,
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCompressedTexImage2D
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCompressedTexImage2D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCompressedTexImage2D — specify a two-dimensional texture image in a compressed format</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCompressedTexImage2D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalformat</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">height</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">imageSize</var>, </td></tr><tr><td> </td><td>const GLvoid * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCompressedTexImage2D</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCompressedTexImage2D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCompressedTexImage2D — specify a two-dimensional texture image in a compressed format</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCompressedTexImage2D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalformat</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">height</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">imageSize</var>, </td></tr><tr><td> </td><td>const GLvoid * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target texture.
Must be <code class="constant">GL_TEXTURE_2D</code>, <code class="constant">GL_PROXY_TEXTURE_2D</code>,
<code class="constant">GL_TEXTURE_1D_ARRAY</code>, <code class="constant">GL_PROXY_TEXTURE_1D_ARRAY</code>,
is treated as an array of compressed 1D textures.
</p><p>
If <em class="parameter"><code>target</code></em> is <code class="constant">GL_PROXY_TEXTURE_2D</code>, <code class="constant">GL_PROXY_TEXTURE_1D_ARRAY</code>
- or <code class="constant">GL_PROXY_TEXTURE_CUBE_MAP</code>, no data is read from <em class="parameter"><code>data</code></em>, but
+ or <code class="constant">GL_PROXY_CUBE_MAP</code>, no data is read from <em class="parameter"><code>data</code></em>, 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
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCopyTexImage1D
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCopyTexImage1D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCopyTexImage1D — copy pixels into a 1D texture image</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCopyTexImage1D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalformat</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCopyTexImage1D</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCopyTexImage1D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCopyTexImage1D — copy pixels into a 1D texture image</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCopyTexImage1D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalformat</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target texture.
Must be <code class="constant">GL_TEXTURE_1D</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>level</code></em></span></dt><dd><p>
of the row of pixels to be copied.
</p></dd><dt><span class="term"><em class="parameter"><code>width</code></em></span></dt><dd><p>
Specifies the width of the texture image.
+ Must be 0 or
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">n</mml:mi></mml:math>.
The height of the texture image is 1.
</p></dd><dt><span class="term"><em class="parameter"><code>border</code></em></span></dt><dd><p>
- Must be 0.
+ Specifies the width of the border.
+ Must be either 0 or 1.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glCopyTexImage1D</code> defines a one-dimensional texture image with pixels from the current
<code class="constant">GL_READ_BUFFER</code>.
<mml:mrow>
<mml:mi mathvariant="italic">width</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
</mml:mrow>
</mml:math>
defines the texture array
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em> is less than 0 or greater than
<code class="constant">GL_MAX_TEXTURE_SIZE</code>.
</p><p>
- <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0.
+ <code class="constant">GL_INVALID_VALUE</code> is generated if non-power-of-two textures are not supported and the <em class="parameter"><code>width</code></em> cannot be represented as
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer value of <span class="emphasis"><em>n</em></span>.
+ </p><p>
+ <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0 or 1.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if <em class="parameter"><code>internalformat</code></em> is
<code class="constant">GL_DEPTH_COMPONENT</code>, <code class="constant">GL_DEPTH_COMPONENT16</code>,
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCopyTexImage2D
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCopyTexImage2D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCopyTexImage2D — copy pixels into a 2D texture image</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCopyTexImage2D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalformat</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">height</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCopyTexImage2D</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCopyTexImage2D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCopyTexImage2D — copy pixels into a 2D texture image</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCopyTexImage2D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalformat</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">height</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target texture.
Must be <code class="constant">GL_TEXTURE_2D</code>,
<code class="constant">GL_TEXTURE_CUBE_MAP_POSITIVE_X</code>,
of the rectangular region of pixels to be copied.
</p></dd><dt><span class="term"><em class="parameter"><code>width</code></em></span></dt><dd><p>
Specifies the width of the texture image.
+ Must be 0 or
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">n</mml:mi></mml:math>.
</p></dd><dt><span class="term"><em class="parameter"><code>height</code></em></span></dt><dd><p>
Specifies the height of the texture image.
+ Must be 0 or
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">m</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">m</mml:mi></mml:math>.
</p></dd><dt><span class="term"><em class="parameter"><code>border</code></em></span></dt><dd><p>
- Must be 0.
+ Specifies the width of the border.
+ Must be either 0 or 1.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glCopyTexImage2D</code> defines a two-dimensional texture image, or cube-map texture image
with pixels from the current
<mml:mrow>
<mml:mi mathvariant="italic">width</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
</mml:mrow>
</mml:math>
and a height of
<mml:mrow>
<mml:mi mathvariant="italic">height</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
</mml:mrow>
</mml:math>
defines the texture array
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">max</mml:mi></mml:math>
is the returned value of <code class="constant">GL_MAX_TEXTURE_SIZE</code>.
</p><p>
- <code class="constant">GL_INVALID_VALUE</code> is generated if either <em class="parameter"><code>width</code></em> or <em class="parameter"><code>height</code></em> is less than 0
+ <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em> is less than 0
or greater than
<code class="constant">GL_MAX_TEXTURE_SIZE</code>.
</p><p>
- <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0.
+ <code class="constant">GL_INVALID_VALUE</code> is generated if non-power-of-two textures are not supported and the <em class="parameter"><code>width</code></em> or <em class="parameter"><code>depth</code></em> cannot be represented as
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">k</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">k</mml:mi></mml:math>.
+ </p><p>
+ <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0 or 1.
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>internalformat</code></em> is not an
accepted format.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCopyTexSubImage1D
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCopyTexSubImage1D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCopyTexSubImage1D — copy a one-dimensional texture subimage</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCopyTexSubImage1D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">xoffset</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var><code>)</code>;</td></tr></table></div></div><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCopyTexSubImage1D</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCopyTexSubImage1D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCopyTexSubImage1D — copy a one-dimensional texture subimage</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCopyTexSubImage1D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">xoffset</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var><code>)</code>;</td></tr></table></div></div><p>
</p><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target texture.
Must be <code class="constant">GL_TEXTURE_1D</code>.
texture image with pixels from the current <code class="constant">GL_READ_BUFFER</code> (rather
than from main memory, as is the case for <a href="glTexSubImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage1D</span></span></a>).
</p><p>
- The screen-aligned pixel row with left corner at (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>), and with
+ The screen-aligned pixel row with left corner at (<em class="parameter"><code>x</code></em>,\ <em class="parameter"><code>y</code></em>), and with
length <em class="parameter"><code>width</code></em> replaces the portion of the
texture array with x indices <em class="parameter"><code>xoffset</code></em> through
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<code class="constant">GL_READ_BUFFER</code> are outside the read window associated with the current
rendering context, then the values obtained for those pixels are undefined.
</p><p>
- No change is made to the <span class="emphasis"><em>internalformat</em></span> or <span class="emphasis"><em>width</em></span> parameters of the specified texture
+ No change is made to the <span class="emphasis"><em>internalformat</em></span>, <span class="emphasis"><em>width</em></span>,
+ or <span class="emphasis"><em>border</em></span> parameters of the specified texture
array or to texel values outside the specified subregion.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
The <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a> mode affects texture images.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
- <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>target</code></em> is not <code class="constant">GL_TEXTURE_1D</code>.
+ <code class="constant">GL_INVALID_ENUM</code> is generated if /<em class="parameter"><code>target</code></em> is not <code class="constant">GL_TEXTURE_1D</code>.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if the texture array has not
been defined by a previous <a href="glTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage1D</span></span></a> or <a href="glCopyTexImage1D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage1D</span></span></a> operation.
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_WIDTH</code>
+ is the <code class="constant">GL_TEXTURE_WIDTH</code> and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">b</mml:mi></mml:math>
+ is the <code class="constant">GL_TEXTURE_BORDER</code>
of the texture image being modified.
+ Note that
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
+ includes twice the border width.
+ </p><p>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
<a href="glGetTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexImage</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCopyTexSubImage2D
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCopyTexSubImage2D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCopyTexSubImage2D — copy a two-dimensional texture subimage</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCopyTexSubImage2D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">xoffset</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">yoffset</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">height</var><code>)</code>;</td></tr></table></div></div><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glCopyTexSubImage2D</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glCopyTexSubImage2D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glCopyTexSubImage2D — copy a two-dimensional texture subimage</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glCopyTexSubImage2D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">xoffset</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">yoffset</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">height</var><code>)</code>;</td></tr></table></div></div><p>
</p><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target texture.
Must be <code class="constant">GL_TEXTURE_2D</code>,
<code class="constant">GL_READ_BUFFER</code> are outside the read window associated with the current
rendering context, then the values obtained for those pixels are undefined.
</p><p>
- No change is made to the <span class="emphasis"><em>internalformat</em></span>, <span class="emphasis"><em>width</em></span> or
- <span class="emphasis"><em>height</em></span> parameters of the specified texture
+ No change is made to the <span class="emphasis"><em>internalformat</em></span>, <span class="emphasis"><em>width</em></span>,
+ <span class="emphasis"><em>height</em></span>, or <span class="emphasis"><em>border</em></span> parameters of the specified texture
array or to texel values outside the specified subregion.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
<a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a> modes affect texture images.
<code class="constant">GL_TEXTURE_CUBE_MAP_NEGATIVE_X</code>,
<code class="constant">GL_TEXTURE_CUBE_MAP_POSITIVE_Y</code>,
<code class="constant">GL_TEXTURE_CUBE_MAP_NEGATIVE_Y</code>,
- <code class="constant">GL_TEXTURE_CUBE_MAP_POSITIVE_Z</code>,
- <code class="constant">GL_TEXTURE_CUBE_MAP_NEGATIVE_Z</code>, or
- <code class="constant">GL_TEXTURE_1D_ARRAY</code>.
+ <code class="constant">GL_TEXTURE_CUBE_MAP_POSITIVE_Z</code>, or
+ <code class="constant">GL_TEXTURE_CUBE_MAP_NEGATIVE_Z</code>.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if the texture array has not been
defined by a previous <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a> or <a href="glCopyTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glCopyTexImage2D</span></span></a> operation.
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mrow>
- <mml:mi mathvariant="italic">w</mml:mi>
- </mml:mrow>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_WIDTH</code>, and
+ is the <code class="constant">GL_TEXTURE_WIDTH</code>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_HEIGHT</code>
+ is the <code class="constant">GL_TEXTURE_HEIGHT</code>,
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">b</mml:mi></mml:math>
+ is the <code class="constant">GL_TEXTURE_BORDER</code>
of the texture image being modified.
+ Note that
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>
+ include twice the border width.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
<a href="glGetTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexImage</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
rendering context, then the values obtained for those pixels are undefined.
</p><p>
No change is made to the <span class="emphasis"><em>internalformat</em></span>, <span class="emphasis"><em>width</em></span>,
- <span class="emphasis"><em>height</em></span>, or <span class="emphasis"><em>depth</em></span> parameters of the specified texture
+ <span class="emphasis"><em>height</em></span>, <span class="emphasis"><em>depth</em></span>, or <span class="emphasis"><em>border</em></span> parameters of the specified texture
array or to texel values outside the specified subregion.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
<a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a> modes affect texture images.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
- <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>target</code></em> is not <code class="constant">GL_TEXTURE_3D</code> or <code class="constant">GL_TEXTURE_2D_ARRAY</code>.
+ <code class="constant">GL_INVALID_ENUM</code> is generated if /<em class="parameter"><code>target</code></em> is not <code class="constant">GL_TEXTURE_3D</code>.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if the texture array has not
been defined by a previous <a href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a> operation.
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mrow>
<mml:mi mathvariant="italic">zoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
is the <code class="constant">GL_TEXTURE_WIDTH</code>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_HEIGHT</code>, and
+ is the <code class="constant">GL_TEXTURE_HEIGHT</code>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">d</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_DEPTH</code>
+ is the <code class="constant">GL_TEXTURE_DEPTH</code>,
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">b</mml:mi></mml:math>
+ is the <code class="constant">GL_TEXTURE_BORDER</code>
of the texture image being modified.
+ Note that
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>,
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>,
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">d</mml:mi></mml:math>
+ include twice the border width.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
<a href="glGetTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexImage</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glDrawBuffers
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glDrawBuffers"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glDrawBuffers — Specifies a list of color buffers to be drawn into</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glDrawBuffers</b>(</code></td><td>GLsizei </td><td><var class="pdparam">n</var>, </td></tr><tr><td> </td><td>const GLenum * </td><td><var class="pdparam">bufs</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>Specifies the number of buffers in
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glDrawBuffers</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glDrawBuffers"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glDrawBuffers — Specifies a list of color buffers to be drawn into</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glDrawBuffers</b>(</code></td><td>GLsizei </td><td><var class="pdparam">n</var>, </td></tr><tr><td> </td><td>const GLenum * </td><td><var class="pdparam">bufs</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>Specifies the number of buffers in
<em class="parameter"><code>bufs</code></em>.</p></dd><dt><span class="term"><em class="parameter"><code>bufs</code></em></span></dt><dd><p>Points to an array of symbolic constants
specifying the buffers into which fragment colors or
data values will be written.</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p><code class="function">glDrawBuffers</code> defines an array of
tokens.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if the GL is bound
to a framebuffer object and one or more of the values in <em class="parameter"><code>bufs</code></em>
is anything other than <code class="constant">GL_NONE</code> or one of the
- <code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>n</em></span></code> tokens.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if
+ <code class="constant">GL_COLOR_ATTACHMENT
S<span class="emphasis"><em>n</em></span></code> tokens.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if
<em class="parameter"><code>n</code></em> is less than 0.</p><p><code class="constant">GL_INVALID_OPERATION</code> is generated if a
symbolic constant other than <code class="constant">GL_NONE</code>
appears more than once in <em class="parameter"><code>bufs</code></em>.</p><p><code class="constant">GL_INVALID_OPERATION</code> is generated if any of
Specifies the length of the buffer subrange, in basic machine units.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glFlushMappedBufferRange</code> indicates that modifications have been made to a range of a mapped buffer.
- The buffer must previously have been mapped with the <code class="constant">GL_MAP_FLUSH_EXPLICIT_BIT</code> flag. <em class="parameter"><code>offset</code></em>
+ The buffer must previously have been mapped with the <code class="constant">GL_MAP_FLUSH_EXPLICIT</code> flag. <em class="parameter"><code>offset</code></em>
and <em class="parameter"><code>length</code></em> indicate the modified subrange of the mapping, in basic units. The specified subrange to flush
is relative to the start of the currently mapped range of the buffer. <code class="function">glFlushMappedBufferRange</code> may be called
multiple times to indicate distinct subranges of the mapping which require flushing.
<code class="constant">GL_INVALID_OPERATION</code> is generated if zero is bound to <em class="parameter"><code>target</code></em>.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if the buffer bound to <em class="parameter"><code>target</code></em> is not
- mapped, or is mapped without the <code class="constant">GL_MAP_FLUSH_EXPLICIT_BIT</code> flag.
+ mapped, or is mapped without the <code class="constant">GL_MAP_FLUSH_EXPLICIT</code> flag.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<a href="glMapBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glMapBufferRange</span></span></a>,
<a href="glMapBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glMapBuffer</span></span></a>,
</p></dd><dt><span class="term"><em class="parameter"><code>attachment</code></em></span></dt><dd><p>
Specifies the attachment point of the framebuffer. <em class="parameter"><code>attachment</code></em> must be
<code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>i</em></span></code>, <code class="constant">GL_DEPTH_ATTACHMENT</code>,
- <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMENT</code>.
+ <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMMENT</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>textarget</code></em></span></dt><dd><p>
For <code class="function">glFramebufferTexture1D</code>, <code class="function">glFramebufferTexture2D</code> and
<code class="function">glFramebufferTexture3D</code>, specifies what type of texture is expected
</p><p>
<em class="parameter"><code>attachment</code></em> specifies the logical attachment of the framebuffer and must be
<code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>i</em></span></code>, <code class="constant">GL_DEPTH_ATTACHMENT</code>,
- <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMENT</code>.
+ <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMMENT</code>.
<span class="emphasis"><em>i</em></span> in <code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>i</em></span></code> may range from zero to
the value of <code class="constant">GL_MAX_COLOR_ATTACHMENTS</code> - 1. Attaching a level of a texture to
<code class="constant">GL_DEPTH_STENCIL_ATTACHMENT</code> is equivalent to attaching that level to both the
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glFramebufferTextureLayer
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glFramebufferTextureLayer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glFramebufferTextureLayer — attach a single layer of a texture to a framebuffer</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glFramebufferTextureLayer</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">attachment</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">texture</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">layer</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glFramebufferTextureLayer</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glFramebufferTextureLayer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glFramebufferTextureLayer — attach a single layer of a texture to a framebuffer</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glFramebufferTextureLayer</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">attachment</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">texture</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">layer</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the framebuffer target. <em class="parameter"><code>target</code></em> must be <code class="constant">GL_DRAW_FRAMEBUFFER</code>,
<code class="constant">GL_READ_FRAMEBUFFER</code>, or <code class="constant">GL_FRAMEBUFFER</code>. <code class="constant">GL_FRAMEBUFFER</code>
is equivalent to <code class="constant">GL_DRAW_FRAMEBUFFER</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>attachment</code></em></span></dt><dd><p>
Specifies the attachment point of the framebuffer. <em class="parameter"><code>attachment</code></em> must be
<code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>i</em></span></code>, <code class="constant">GL_DEPTH_ATTACHMENT</code>,
- <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMENT</code>.
+ <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMMENT</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>texture</code></em></span></dt><dd><p>
Specifies the texture object to attach to the framebuffer attachment point named by <em class="parameter"><code>attachment</code></em>.
</p></dd><dt><span class="term"><em class="parameter"><code>level</code></em></span></dt><dd><p>
<em class="parameter"><code>params</code></em> returns one value,
the line width as specified with <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>. The initial value is
1.
+ </p></dd><dt><span class="term"><code class="constant">GL_LINE_WIDTH_GRANULARITY</code></span></dt><dd><p>
+ </p><p>
+ <em class="parameter"><code>params</code></em> returns one value,
+ the width difference between adjacent supported widths for antialiased lines.
+ See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>.
+ </p></dd><dt><span class="term"><code class="constant">GL_LINE_WIDTH_RANGE</code></span></dt><dd><p>
+ </p><p>
+ <em class="parameter"><code>params</code></em> returns two values:
+ the smallest and largest supported widths for antialiased
+ lines.
+ See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>.
</p></dd><dt><span class="term"><code class="constant">GL_LOGIC_OP_MODE</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns one value,
of simultaneous outputs that may be written in a fragment shader.
The value must be at least 8.
See <a href="glDrawBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDrawBuffers</span></span></a>.
- </p></dd><dt><span class="term"><code class="constant">GL_MAX_DUAL
_SOURCE_DRAW_BUFFERS</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="constant">GL_MAX_DUALSOURCE_DRAW_BUFFERS</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns one value, the maximum number
of active draw buffers when using dual-source blending. The value must be at least 1.
<em class="parameter"><code>params</code></em> returns one value.
The value gives a rough estimate of the largest rectangular texture that
the GL can handle. The value must be at least 1024.
- Use <code class="constant">GL_PROXY_TEXTURE_RECTANGLE</code>
+ Use <code class="constant">GL_PROXY_RECTANGLE_TEXTURE</code>
to determine if a texture is too large.
See <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>.
</p></dd><dt><span class="term"><code class="constant">GL_MAX_TEXTURE_IMAGE_UNITS</code></span></dt><dd><p>
<em class="parameter"><code>params</code></em> returns one value,
the current primitive restart index. The initial value is 0.
See <a href="glPrimitiveRestartIndex.xml"><span class="citerefentry"><span class="refentrytitle">glPrimitiveRestartIndex</span></span></a>.
- </p></dd><dt><span class="term"><code class="constant">GL_PROGRAM_POINT_SIZE</code></span></dt><dd><p>
- </p><p>
- <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether vertex
- program point size mode is enabled. If enabled, then the
- point size is taken from the shader built-in <code class="code">gl_PointSize</code>. If disabled,
- then the point size is taken from the point state as specified
- by <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>.
- The initial value is <code class="constant">GL_FALSE</code>.
</p></dd><dt><span class="term"><code class="constant">GL_PROVOKING_VERTEX</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns one value,
</p><p>
<em class="parameter"><code>params</code></em> returns a single value indicating the mode of the texture
compression hint. The initial value is <code class="constant">GL_DONT_CARE</code>.
- </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_B
INDING_BUFFER</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_B
UFFER_BINDING</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns a single value, the name of the texture buffer object
currently bound. The initial value is 0.
</p><p>
<em class="parameter"><code>params</code></em> returns one value,
the flags with which the context was created (such as debugging functionality).
+ </p></dd><dt><span class="term"><code class="constant">GL_VERTEX_PROGRAM_POINT_SIZE</code></span></dt><dd><p>
+ </p><p>
+ <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether vertex
+ program point size mode is enabled. If enabled, and a vertex shader is active, then the
+ point size is taken from the shader built-in <code class="code">gl_PointSize</code>. If disabled,
+ and a vertex shader is active, then the point size is taken from the point state as specified
+ by <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>.
+ The initial value is <code class="constant">GL_FALSE</code>.
</p></dd><dt><span class="term"><code class="constant">GL_VIEWPORT</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns four values:
<code class="constant">GL_TEXTURE_3D</code> and <code class="constant">GL_TEXTURE_BINDING_3D</code>.
</p><p>
<code class="constant">GL_MAX_RECTANGLE_TEXTURE_SIZE</code>, <code class="constant">GL_MAX_TEXTURE_BUFFER_SIZE</code>,
- <code class="constant">GL_UNIFORM_BUFFER_BINDING</code>, <code class="constant">GL_TEXTURE_BINDING_BUFFER</code>,
+ <code class="constant">GL_UNIFORM_BUFFER_BINDING</code>, <code class="constant">GL_TEXTURE_BUFFER_BINDING</code>,
<code class="constant">GL_MAX_VERTEX_UNIFORM_BLOCKS</code>, <code class="constant">GL_MAX_FRAGMENT_UNIFORM_BLOCKS</code>,
<code class="constant">GL_MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS</code>, <code class="constant">GL_MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS</code>
<code class="constant">GL_MAX_COMBINED_UNIFORM_BLOCKS</code>, <code class="constant">GL_MAX_UNIFORM_BLOCK_SIZE</code>,
<code class="function">glGetInteger64v</code> and <code class="function">glGetInteger64i_v</code> are available only if
the GL version is 3.2 or greater.
</p><p>
- <code class="constant">GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</code>, <code class="constant">GL_SAMPLER_BINDING</code>, and
+ <code class="constant">GL_MAX_DUALSOURCE_DRAW_BUFFERS</code>, <code class="constant">GL_SAMPLER_BINDING</code>, and
<code class="constant">GL_TIMESTAMP</code> are available only if the GL version is 3.3 or greater.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>pname</code></em> is not an accepted value.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetActiveAttrib
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetActiveAttrib"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetActiveAttrib — Returns information about an active attribute variable for the specified program object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetActiveAttrib</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">bufSize</var>, </td></tr><tr><td> </td><td>GLsizei * </td><td><var class="pdparam">length</var>, </td></tr><tr><td> </td><td>GLint * </td><td><var class="pdparam">size</var>, </td></tr><tr><td> </td><td>GLenum * </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLchar * </td><td><var class="pdparam">name</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>Specifies the program object to be
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetActiveAttrib</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetActiveAttrib"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetActiveAttrib — Returns information about an active attribute variable for the specified program object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetActiveAttrib</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">bufSize</var>, </td></tr><tr><td> </td><td>GLsizei * </td><td><var class="pdparam">length</var>, </td></tr><tr><td> </td><td>GLint * </td><td><var class="pdparam">size</var>, </td></tr><tr><td> </td><td>GLenum * </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLchar * </td><td><var class="pdparam">name</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>Specifies the program object to be
queried.</p></dd><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>Specifies the index of the attribute variable
to be queried.</p></dd><dt><span class="term"><em class="parameter"><code>bufSize</code></em></span></dt><dd><p>Specifies the maximum number of characters
OpenGL is allowed to write in the character buffer
<code class="constant">GL_INT_VEC2</code>,
<code class="constant">GL_INT_VEC3</code>,
<code class="constant">GL_INT_VEC4</code>,
- <code class="constant">GL_UNSIGNED_INT</code>,
+ <code class="constant">GL_UNSIGNED_INT_VEC</code>,
<code class="constant">GL_UNSIGNED_INT_VEC2</code>,
<code class="constant">GL_UNSIGNED_INT_VEC3</code>, or
<code class="constant">GL_UNSIGNED_INT_VEC4</code> may be returned. The
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetActiveUniform
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetActiveUniform"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetActiveUniform — Returns information about an active uniform variable for the specified program object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetActiveUniform</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">bufSize</var>, </td></tr><tr><td> </td><td>GLsizei * </td><td><var class="pdparam">length</var>, </td></tr><tr><td> </td><td>GLint * </td><td><var class="pdparam">size</var>, </td></tr><tr><td> </td><td>GLenum * </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLchar * </td><td><var class="pdparam">name</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>Specifies the program object to be
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetActiveUniform
</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div class="refentry" title="glGetActiveUniform"><a id="glGetActiveUniform"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetActiveUniform — Returns information about an active uniform variable for the specified program object</p></div><div class="refsynopsisdiv" title="C Specification"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">glGetActiveUniform</b>(</code></td><td>GLuint <var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint <var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLsizei <var class="pdparam">bufSize</var>, </td></tr><tr><td> </td><td>GLsizei *<var class="pdparam">length</var>, </td></tr><tr><td> </td><td>GLint *<var class="pdparam">size</var>, </td></tr><tr><td> </td><td>GLenum *<var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLchar *<var class="pdparam">name</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Parameters"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>Specifies the program object to be
queried.</p></dd><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>Specifies the index of the uniform variable to
be queried.</p></dd><dt><span class="term"><em class="parameter"><code>bufSize</code></em></span></dt><dd><p>Specifies the maximum number of characters
OpenGL is allowed to write in the character buffer
<code class="constant">NULL</code> is passed.</p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>Returns the size of the uniform
variable.</p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>Returns the data type of the uniform
variable.</p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>Returns a null terminated string containing
- the name of the uniform variable.</p></dd></dl></div></div><div class="refsect1"
lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p><code class="function">glGetActiveUniform</code> returns
+ the name of the uniform variable.</p></dd></dl></div></div><div class="refsect1"
title="Description"><a id="description"></a><h2>Description</h2><p><code class="function">glGetActiveUniform</code> returns
information about an active uniform variable in the program
object specified by <em class="parameter"><code>program</code></em>. The number
of active uniform variables can be obtained by calling
- <a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
+ <a class="citerefentry" href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
with the value <code class="constant">GL_ACTIVE_UNIFORMS</code>. A value
of 0 for <em class="parameter"><code>index</code></em> selects the first active
uniform variable. Permissible values for
Shading Language specification for a complete list.)
User-defined uniform variables have arbitrary names and obtain
their values from the application through calls to
- <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>.
+ <a class="citerefentry" href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>.
A uniform variable (either built-in or user-defined) is
considered active if it is determined during the link operation
that it may be accessed during program execution. Therefore,
<em class="parameter"><code>program</code></em> should have previously been the
target of a call to
- <a href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a>,
+ <a class="citerefentry" href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a>,
but it is not necessary for it to have been linked
successfully.</p><p>The size of the character buffer required to store the
longest uniform variable name in <em class="parameter"><code>program</code></em>
can be obtained by calling
- <a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
+ <a class="citerefentry" href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
with the value
<code class="constant">GL_ACTIVE_UNIFORM_MAX_LENGTH</code>. This value
should be used to allocate a buffer of sufficient size to store
reduced to its fundamental components containing the
"." and "[]" operators such that each of the
names is valid as an argument to
- <a href="glGetUniformLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformLocation</span></span></a>.
+ <a class="citerefentry" href="glGetUniformLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformLocation</span></span></a>.
Each of these reduced uniform variables is counted as one active
uniform variable and is assigned an index. A valid name cannot
be a structure, an array of structures, or a subcomponent of a
operation that failed. If an error occurs, the return values
<em class="parameter"><code>length</code></em>, <em class="parameter"><code>size</code></em>,
<em class="parameter"><code>type</code></em>, and <em class="parameter"><code>name</code></em>
- will be unmodified.</p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p><code class="constant">GL_INVALID_VALUE</code> is generated if
+ will be unmodified.</p></div><div class="refsect1"
title="Errors"><a id="errors"></a><h2>Errors</h2><p><code class="constant">GL_INVALID_VALUE</code> is generated if
<em class="parameter"><code>program</code></em> is not a value generated by
OpenGL.</p><p><code class="constant">GL_INVALID_OPERATION</code> is generated if
<em class="parameter"><code>program</code></em> is not a program object.</p><p><code class="constant">GL_INVALID_VALUE</code> is generated if
<em class="parameter"><code>index</code></em> is greater than or equal to the
number of active uniform variables in
<em class="parameter"><code>program</code></em>.</p><p><code class="constant">GL_INVALID_VALUE</code> is generated if
- <em class="parameter"><code>bufSize</code></em> is less than 0.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p><a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
- with argument
- <code class="constant">GL_MAX_VERTEX_UNIFORM_COMPONENTS</code>,
+ <em class="parameter"><code>bufSize</code></em> is less than 0.</p></div><div class="refsect1" title="Associated Gets"><a id="associatedgets"></a><h2>Associated Gets</h2><p><a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
+ with argument <code class="constant">GL_MAX_VERTEX_UNIFORM_COMPONENTS</code>,
<code class="constant">GL_MAX_GEOMETRY_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_COMBINED_GEOMETRY_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS</code>.</p><p><a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
+ <code class="constant">GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</code>, or
+ <code class="constant">GL_MAX_COMBINED_UNIFORM_COMPONENTS</code>.</p><p><a class="citerefentry" href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
with argument <code class="constant">GL_ACTIVE_UNIFORMS</code> or
- <code class="constant">GL_ACTIVE_UNIFORM_MAX_LENGTH</code>.</p><p><a href="glIsProgram.xml"><span class="citerefentry"><span class="refentrytitle">glIsProgram</span></span></a></p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p><a href="glGetUniform.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniform</span></span></a>,
- <a href="glGetUniformLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformLocation</span></span></a>,
- <a href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a>,
- <a href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>,
- <a
href="glUseProgram.xml"><span class="citerefentry"><span class="refentrytitle">glUseProgram</span></span></a></p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
+ <code class="constant">GL_ACTIVE_UNIFORM_MAX_LENGTH</code>.</p><p><a class="citerefentry" href="glIsProgram.xml"><span class="citerefentry"><span class="refentrytitle">glIsProgram</span></span></a></p></div><div class="refsect1" title="See Also"><a id="seealso"></a><h2>See Also</h2><p><a class="citerefentry" href="glGetUniform.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniform</span></span></a>,
+ <a class="citerefentry" href="glGetUniformLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformLocation</span></span></a>,
+ <a class="citerefentry" href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a>,
+ <a class="citerefentry" href="glUniform.xml"><span class="citerefentry"><span class="refentrytitle">glUniform</span></span></a>,
+ <a
class="citerefentry" href="glUseProgram.xml"><span class="citerefentry"><span class="refentrytitle">glUseProgram</span></span></a></p></div><div class="refsect1" title="Copyright"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 2003-2005 3Dlabs Inc. Ltd.
Copyright <span class="trademark"></span>© 2010 Khronos Group
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
- <a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
+ <a class="ulink" href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
</p></div></div></body></html>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetActiveUniformBlock
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetActiveUniformBlock"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetActiveUniformBlock — query information about an active uniform block</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetActiveUniformBlockiv</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">uniformBlockIndex</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint * </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetActiveUniformBlock
</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div class="refentry" title="glGetActiveUniformBlock"><a id="glGetActiveUniformBlock"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetActiveUniformBlock — query information about an active uniform block</p></div><div class="refsynopsisdiv" title="C Specification"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">glGetActiveUniformBlockiv</b>(</code></td><td>GLuint <var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint <var class="pdparam">uniformBlockIndex</var>, </td></tr><tr><td> </td><td>GLenum <var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint <var class="pdparam">params</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Parameters"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
Specifies the name of a program containing the uniform block.
</p></dd><dt><span class="term"><em class="parameter"><code>uniformBlockIndex</code></em></span></dt><dd><p>
Specifies the index of the uniform block within <em class="parameter"><code>program</code></em>.
Specifies the name of the parameter to query.
</p></dd><dt><span class="term"><em class="parameter"><code>params</code></em></span></dt><dd><p>
Specifies the address of a variable to receive the result of the query.
- </p></dd></dl></div></div><div class="refsect1"
lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
+ </p></dd></dl></div></div><div class="refsect1"
title="Description"><a id="description"></a><h2>Description</h2><p>
<code class="function">glGetActiveUniformBlockiv</code> retrieves information about an active uniform block within <em class="parameter"><code>program</code></em>.
</p><p>
<em class="parameter"><code>program</code></em> must be the name of a program object for which the command
- <a href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a> must have been called in the past, although it is not required that
- <a href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a> must have succeeded. The link could have failed because the number
+ <a class="citerefentry" href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a> must have been called in the past, although it is not required that
+ <a class="citerefentry" href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a> must have succeeded. The link could have failed because the number
of active uniforms exceeded the limit.
</p><p>
<em class="parameter"><code>uniformBlockIndex</code></em> is an active uniform block index of <em class="parameter"><code>program</code></em>, and must be less than the value
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_UNIFORM_BLOCK_REFERENCED_BY_VERTEX_SHADER</code>, <code class="constant">GL_UNIFORM_BLOCK_REFERENCED_BY_GEOMETRY_SHADER</code>,
or <code class="constant">GL_UNIFORM_BLOCK_REFERENCED_BY_FRAGMENT_SHADER</code>, then a boolean value indicating whether the uniform block identified by
<em class="parameter"><code>uniformBlockIndex</code></em> is referenced by the vertex, geometry, or fragment programming stages of program, respectively, is returned.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
+ </p></div><div class="refsect1"
title="Errors"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>uniformBlockIndex</code></em> is greater than or equal to the value
of <code class="constant">GL_ACTIVE_UNIFORM_BLOCKS</code> or is not the index of an active uniform block in <em class="parameter"><code>program</code></em>.
</p><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>pname</code></em> is not one of the accepted tokens.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if <em class="parameter"><code>program</code></em> is not the name of a program object for which
- <a href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a> has been called in the past.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
+ <a class="citerefentry" href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a> has been called in the past.
+ </p></div><div class="refsect1"
title="Notes"><a id="notes"></a><h2>Notes</h2><p>
<code class="function">glGetActiveUniformBlockiv</code> is available only if the GL version is 3.1 or greater.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
- <a href="glGetActiveUniformBlockName.xml"><span class="citerefentry"><span class="refentrytitle">glGetActiveUniformBlockName</span></span></a>,
- <a href="glGetUniformBlockIndex.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformBlockIndex</span></span></a>,
- <a href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a>
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ </p></div><div class="refsect1"
title="See Also"><a id="seealso"></a><h2>See Also</h2><p>
+ <a class="citerefentry" href="glGetActiveUniformBlockName.xml"><span class="citerefentry"><span class="refentrytitle">glGetActiveUniformBlockName</span></span></a>,
+ <a class="citerefentry" href="glGetUniformBlockIndex.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformBlockIndex</span></span></a>,
+ <a class="citerefentry" href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a>
+ </p></div><div class="refsect1"
title="Copyright"><a id="Copyright"></a><h2>Copyright</h2><p>
+ Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
- <a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
+ <a class="ulink" href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
</p></div></div></body></html>
is not an accepted token.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p><a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
with argument <code class="constant">GL_MAX_VERTEX_UNIFORM_COMPONENTS</code>,
<code class="constant">GL_MAX_GEOMETRY_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_COMBINED_GEOMETRY_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS</code>.</p><p><a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
+ <code class="constant">GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</code>, or
+ <code class="constant">GL_MAX_COMBINED_UNIFORM_COMPONENTS</code>.</p><p><a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
with argument <code class="constant">GL_ACTIVE_UNIFORMS</code> or
<code class="constant">GL_ACTIVE_UNIFORM_MAX_LENGTH</code>.</p><p><a href="glIsProgram.xml"><span class="citerefentry"><span class="refentrytitle">glIsProgram</span></span></a></p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p><a href="glGetUniform.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniform</span></span></a>,
<a href="glGetActiveUniform.xml"><span class="citerefentry"><span class="refentrytitle">glGetActiveUniform</span></span></a>,
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetBufferParameteriv
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetBufferParameter"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetBufferParameteriv — return parameters of a buffer object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetBufferParameteriv</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">value</var>, </td></tr><tr><td> </td><td>GLint * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetBufferParameteri64v</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">value</var>, </td></tr><tr><td> </td><td>GLint64 * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetBufferParameteriv
</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetBufferParameteriv"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetBufferParameteriv — return parameters of a buffer object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetBufferParameteriv</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">value</var>, </td></tr><tr><td> </td><td>GLint * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target buffer object.
The symbolic constant must be <code class="constant">GL_ARRAY_BUFFER</code>,
<code class="constant">GL_COPY_READ_BUFFER</code>,
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
If an error is generated,
no change is made to the contents of <em class="parameter"><code>data</code></em>.
- </p><p>
- <code class="function">glGetBufferParameteri64v</code> is available only if the GL version is 3.2 or higher.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>target</code></em> or <em class="parameter"><code>value</code></em> is not an
accepted value.
<a href="glUnmapBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glUnmapBuffer</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 2005 Addison-Wesley.
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetFramebufferAttachmentParameteriv
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetFramebufferAttachmentParameter"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetFramebufferAttachmentParameteriv — retrieve information about attachments of a bound framebuffer object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetFramebufferAttachmentParameteriv</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">attachment</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint * </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetFramebufferAttachmentParameteriv
</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div class="refentry" title="glGetFramebufferAttachmentParameteriv"><a id="glGetFramebufferAttachmentParameter"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetFramebufferAttachmentParameteriv — retrieve information about attachments of a bound framebuffer object</p></div><div class="refsynopsisdiv" title="C Specification"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">glGetFramebufferAttachmentParameter</b>(</code></td><td>GLenum <var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum <var class="pdparam">attachment</var>, </td></tr><tr><td> </td><td>GLenum <var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint *<var class="pdparam">params</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Parameters"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target of the query operation.
</p></dd><dt><span class="term"><em class="parameter"><code>attachment</code></em></span></dt><dd><p>
Specifies the attachment within <em class="parameter"><code>target</code></em>
Specifies the parameter of <em class="parameter"><code>attachment</code></em> to query.
</p></dd><dt><span class="term"><em class="parameter"><code>params</code></em></span></dt><dd><p>
Specifies the address of a variable receive the value of <em class="parameter"><code>pname</code></em> for <em class="parameter"><code>attachment</code></em>.
- </p></dd></dl></div></div><div class="refsect1"
lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
- <code class="function">glGetFramebufferAttachmentParameteriv</code> returns information about attachments of a bound framebuffer
+ </p></dd></dl></div></div><div class="refsect1"
title="Description"><a id="description"></a><h2>Description</h2><p>
+ <code class="function">glGetFramebufferAttachmentParameter</code> returns information about attachments of a bound framebuffer
object. <em class="parameter"><code>target</code></em> specifies the framebuffer binding point and must be <code class="constant">GL_DRAW_FRAMEBUFFER</code>,
<code class="constant">GL_READ_FRAMEBUFFER</code> or <code class="constant">GL_FRAMEBUFFER</code>. <code class="constant">GL_FRAMEBUFFER</code> is equivalent
to <code class="constant">GL_DRAW_FRAMEBUFFER</code>.
</p><p>
If the value of <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</code> is not <code class="constant">GL_NONE</code>, these queries apply to all other
framebuffer types:
- </p><div class="itemizedlist"><ul
type="disc"><li><p>
+ </p><div class="itemizedlist"><ul
class="itemizedlist" type="disc"><li class="listitem"><p>
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE</code>,
<code class="constant">GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE</code>, <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE</code>,
<code class="constant">GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE</code>, <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE</code>,
or <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE</code>, then <em class="parameter"><code>params</code></em> will contain the number
of bits in the corresponding red, green, blue, alpha, depth, or stencil component of the specified attachment. Zero is returned
if the requested component is not present in <em class="parameter"><code>attachment</code></em>.
- </p></li><li><p>
+ </p></li><li
class="listitem"><p>
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE</code>, <em class="parameter"><code>params</code></em> will
contain the format of components of the specified attachment, one of <code class="constant">GL_FLOAT</code>, <em class="parameter"><code>GL_INT</code></em>,
<em class="parameter"><code>GL_UNSIGNED_INT</code></em>, <em class="parameter"><code>GL_SIGNED_NORMALIZED</code></em>, or <em class="parameter"><code>GL_UNSIGNED_NORMALIZED</code></em>
for floating-point, signed integer, unsigned integer, signed normalized fixed-point, or unsigned normalized fixed-point components
respectively. Only color buffers may have integer components.
- </p></li><li><p>
+ </p></li><li
class="listitem"><p>
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING</code>, <em class="parameter"><code>param</code></em> will
contain the encoding of components of the specified attachment, one of <code class="constant">GL_LINEAR</code> or <code class="constant">GL_SRGB</code>
for linear or sRGB-encoded components, respectively. Only color buffer components may be sRGB-encoded; such components
formats.
</p></li></ul></div><p>
If the value of <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</code> is <code class="constant">GL_RENDERBUFFER</code>, then:
- </p><div class="itemizedlist"><ul
type="disc"><li><p>
+ </p><div class="itemizedlist"><ul
class="itemizedlist" type="disc"><li class="listitem"><p>
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME</code>, <em class="parameter"><code>params</code></em> will contain
the name of the renderbuffer object which contains the attached image.
</p></li></ul></div><p>
If the value of <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</code> is <code class="constant">GL_TEXTURE</code>, then:
- </p><div class="itemizedlist"><ul
type="disc"><li><p>
+ </p><div class="itemizedlist"><ul
class="itemizedlist" type="disc"><li class="listitem"><p>
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME</code>, then <em class="parameter"><code>params</code></em> will
contain the name of the texture object which contains the attached image.
- </p></li><li><p>
+ </p></li><li
class="listitem"><p>
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL</code>, then <em class="parameter"><code>params</code></em>
will contain the mipmap level of the texture object which contains the attached image.
- </p></li><li><p>
+ </p></li><li
class="listitem"><p>
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE</code> and the texture object named
<code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME</code> is a cube map texture, then <em class="parameter"><code>params</code></em> will contain the cube map
face of the cubemap texture object which contains the attached image. Otherwise <em class="parameter"><code>params</code></em> will contain the value
zero.
- </p></li><li><p>
+ </p></li><li
class="listitem"><p>
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LAYER</code> and the texture object named
<code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME</code> is a layer of a three-dimensional texture or a one-or two-dimensional
array texture, then <em class="parameter"><code>params</code></em> will contain the number of the texture layer which contains the attached image.
Otherwise <em class="parameter"><code>params</code></em> will contain the value zero.
- </p></li><li><p>
+ </p></li><li
class="listitem"><p>
If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_LAYERED</code>, then <em class="parameter"><code>params</code></em> will
contain <code class="constant">GL_TRUE</code> if an entire level of a three-dimesional texture, cube map texture, or one-or two-dimensional
array texture is attached. Otherwise, <em class="parameter"><code>params</code></em> will contain <code class="constant">GL_FALSE</code>.
</p></li></ul></div><p>
Any combinations of framebuffer type and <em class="parameter"><code>pname</code></em> not described above will generate an error.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
+ </p></div><div class="refsect1"
title="Errors"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>target</code></em> is not one of the accepted tokens.
</p><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>pname</code></em> is not valid for the value of
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if the value of <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</code> is
<code class="constant">GL_NONE</code> and <em class="parameter"><code>pname</code></em> is not <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME</code>.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
- <a href="glGenFramebuffers.xml"><span class="citerefentry"><span class="refentrytitle">glGenFramebuffers</span></span></a>,
- <a href="glBindFramebuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindFramebuffer</span></span></a>
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ </p></div><div class="refsect1"
title="See Also"><a id="seealso"></a><h2>See Also</h2><p>
+ <a class="citerefentry" href="glGenFramebuffers.xml"><span class="citerefentry"><span class="refentrytitle">glGenFramebuffers</span></span></a>,
+ <a class="citerefentry" href="glBindFramebuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindFramebuffer</span></span></a>
+ </p></div><div class="refsect1"
title="Copyright"><a id="Copyright"></a><h2>Copyright</h2><p>
+ Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
- <a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
+ <a class="ulink" href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
</p></div></div></body></html>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetTexLevelParameter
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetTexLevelParameter"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetTexLevelParameter — return texture parameter values for a specific level of detail</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetTexLevelParameterfv</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLfloat * </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetTexLevelParameteriv</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint * </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetTexLevelParameter</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetTexLevelParameter"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetTexLevelParameter — return texture parameter values for a specific level of detail</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetTexLevelParameterfv</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLfloat * </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetTexLevelParameteriv</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint * </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the symbolic name of the target texture,
one of
<code class="constant">GL_TEXTURE_1D</code>,
<code class="constant">GL_TEXTURE_HEIGHT</code>,
<code class="constant">GL_TEXTURE_DEPTH</code>,
<code class="constant">GL_TEXTURE_INTERNAL_FORMAT</code>,
+ <code class="constant">GL_TEXTURE_BORDER</code>,
<code class="constant">GL_TEXTURE_RED_SIZE</code>,
<code class="constant">GL_TEXTURE_GREEN_SIZE</code>,
<code class="constant">GL_TEXTURE_BLUE_SIZE</code>,
<code class="constant">GL_MAX_TEXTURE_SIZE</code>, and <code class="constant">GL_MAX_3D_TEXTURE_SIZE</code> are not really
descriptive enough.
It has to report the largest square texture image that can be
- accommodated with mipmaps
- but a long skinny texture, or a texture without mipmaps may
+ 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.
</p><p>
<em class="parameter"><code>params</code></em> returns a single value,
the width of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_HEIGHT</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns a single value,
the height of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_DEPTH</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns a single value,
the depth of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_INTERNAL_FORMAT</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns a single value,
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetTransformFeedbackVarying
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetTransformFeedbackVarying"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetTransformFeedbackVarying — retrieve information about varying variables selected for transform feedback</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetTransformFeedbackVarying</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">bufSize</var>, </td></tr><tr><td> </td><td>GLsizei * </td><td><var class="pdparam">length</var>, </td></tr><tr><td> </td><td>GLsizei * </td><td><var class="pdparam">size</var>, </td></tr><tr><td> </td><td>GLenum * </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>char * </td><td><var class="pdparam">name</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetTransformFeedbackVarying
</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetTransformFeedbackVarying"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetTransformFeedbackVarying — retrieve information about varying variables selected for transform feedback</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetTransformFeedbackVarying</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">bufSize</var>, </td></tr><tr><td> </td><td>GLsizei * </td><td><var class="pdparam">length</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">size</var>, </td></tr><tr><td> </td><td>GLenum * </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>char * </td><td><var class="pdparam">name</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
The name of the target program object.
</p></dd><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>
The index of the varying variable whose information to retrieve.
variable selected by <em class="parameter"><code>index</code></em>. An <em class="parameter"><code>index</code></em> of 0 selects
the first varying variable specified in the <em class="parameter"><code>varyings</code></em> array passed
to <a href="glTransformFeedbackVaryings.xml"><span class="citerefentry"><span class="refentrytitle">glTransformFeedbackVaryings</span></span></a>, and
- an <em class="parameter"><code>index</code></em> of <code class="constant">GL_TRANSFORM_FEEDBACK_VARYINGS</code> - 1 selects
+ an <em class="parameter"><code>index</code></em> of <code class="constant">GL_TRANSFORM_FEEDBACK_VARYINGS-1</code> selects
the last such variable.
</p><p>
The name of the selected varying is returned as a null-terminated string in
<a href="glTransformFeedbackVaryings.xml"><span class="citerefentry"><span class="refentrytitle">glTransformFeedbackVaryings</span></span></a>,
<a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
</td><td align="left">
<a href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a>, <a href="glStencilOp.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOp</span></span></a>
</td></tr><tr><td align="left">
- <code class="constant">GL_TEXTURE_CUBE_MAP_SEAMLESS</code>
+ <code class="constant">GL_TEXTURE_CUBEMAP_SEAMLESS</code>
</td><td align="left">
<a href="glEnable.xml"><span class="citerefentry"><span class="refentrytitle">glEnable</span></span></a>
</td></tr></tbody></table></div><p>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glLinkProgram
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glLinkProgram"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glLinkProgram — Links a program object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><p><code class="funcdef">void <b class="fsfunc">glLinkProgram</b>(</code>GLuint <var class="pdparam">program</var><code>)</code>;</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>Specifies the handle of the program object to be linked.</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p><code class="function">glLinkProgram</code> links the program
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glLinkProgram</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glLinkProgram"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glLinkProgram — Links a program object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><p><code class="funcdef">void <b class="fsfunc">glLinkProgram</b>(</code>GLuint <var class="pdparam">program</var><code>)</code>;</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>Specifies the handle of the program object to be linked.</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p><code class="function">glLinkProgram</code> links the program
object specified by <em class="parameter"><code>program</code></em>. If any
shader objects of type <code class="constant">GL_VERTEX_SHADER</code> are
attached to <em class="parameter"><code>program</code></em>, they will be used to
<a href="glTransformFeedbackVaryings.xml"><span class="citerefentry"><span class="refentrytitle">glTransformFeedbackVaryings</span></span></a>
specify the same varying variable.</p></li><li><p>The total number of components to capture in any transform feedback varying variable
is greater than the constant <code class="constant">GL_MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS</code>
- and the buffer mode is <code class="constant">
GL_SEPARATE_ATTRIBS</code>.</p></li></ul></div><p>When a program object has been successfully linked, the
+ and the buffer mode is <code class="constant">SEPARATE_ATTRIBS</code>.</p></li></ul></div><p>When a program object has been successfully linked, the
program object can be made part of current state by calling
<a href="glUseProgram.xml"><span class="citerefentry"><span class="refentrytitle">glUseProgram</span></span></a>.
Whether or not the link operation was successful, the program
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glPointSize
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glPointSize"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glPointSize — specify the diameter of rasterized points</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><p><code class="funcdef">void <b class="fsfunc">glPointSize</b>(</code>GLfloat <var class="pdparam">size</var><code>)</code>;</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glPointSize</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glPointSize"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glPointSize — specify the diameter of rasterized points</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><p><code class="funcdef">void <b class="fsfunc">glPointSize</b>(</code>GLfloat <var class="pdparam">size</var><code>)</code>;</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
Specifies the diameter of rasterized points.
The initial value is 1.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_SIZE_GRANULARITY</code>
</p><p>
<a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_SIZE</code>
+ </p><p>
+ <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_SIZE_MIN</code>
+ </p><p>
+ <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_SIZE_MAX</code>
</p><p>
<a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_FADE_THRESHOLD_SIZE</code>
</p><p>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glReadPixels
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glReadPixels"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glReadPixels — read a block of pixels from the frame buffer</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glReadPixels</b>(</code></td><td>GLint </td><td><var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">height</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">format</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLvoid * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em>, </span><span class="term"><em class="parameter"><code>y</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glReadPixels
</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div class="refentry" title="glReadPixels"><a id="glReadPixels"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glReadPixels — read a block of pixels from the frame buffer</p></div><div class="refsynopsisdiv" title="C Specification"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">glReadPixels</b>(</code></td><td>GLint <var class="pdparam">x</var>, </td></tr><tr><td> </td><td>GLint <var class="pdparam">y</var>, </td></tr><tr><td> </td><td>GLsizei <var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei <var class="pdparam">height</var>, </td></tr><tr><td> </td><td>GLenum <var class="pdparam">format</var>, </td></tr><tr><td> </td><td>GLenum <var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLvoid * <var class="pdparam">data</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Parameters"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em>, </span><span class="term"><em class="parameter"><code>y</code></em></span></dt><dd><p>
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.
<code class="constant">GL_FLOAT_32_UNSIGNED_INT_24_8_REV</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>data</code></em></span></dt><dd><p>
Returns the pixel data.
- </p></dd></dl></div></div><div class="refsect1"
lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
+ </p></dd></dl></div></div><div class="refsect1"
title="Description"><a id="description"></a><h2>Description</h2><p>
<code class="function">glReadPixels</code> returns pixel data from the frame buffer,
starting with the pixel whose lower left corner
is at location (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>),
into client memory starting at location <em class="parameter"><code>data</code></em>.
Several parameters control the processing of the pixel data before
it is placed into client memory.
- These parameters are set with <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
+ These parameters are set with <a class="citerefentry" href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
This reference page describes the effects on <code class="function">glReadPixels</code> of most,
but not all of the parameters specified by these three commands.
</p><p>
If a non-zero named buffer object is bound to the <code class="constant">GL_PIXEL_PACK_BUFFER</code> target
- (see <a href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>) while a block of pixels is
+ (see <a class="citerefentry" href="glBindBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindBuffer</span></span></a>) while a block of pixels is
requested, <em class="parameter"><code>data</code></em> is treated as a byte offset into the buffer object's data store
rather than a pointer to client memory.
</p><p>
accepted values are:
</p><div class="variablelist"><dl><dt><span class="term"><code class="constant">GL_STENCIL_INDEX</code></span></dt><dd><p>
Stencil values are read from the stencil buffer.
- Each index is converted to fixed point.
+ Each index is converted to fixed point,
+ shifted left or right depending on the value and sign of <code class="constant">GL_INDEX_SHIFT</code>,
+ and added to <code class="constant">GL_INDEX_OFFSET</code>.
+ If <code class="constant">GL_MAP_STENCIL</code> is <code class="constant">GL_TRUE</code>,
+ indices are replaced by their mappings in the table <code class="constant">GL_PIXEL_MAP_S_TO_S</code>.
</p></dd><dt><span class="term"><code class="constant">GL_DEPTH_COMPONENT</code></span></dt><dd><p>
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 clamped to the range
+ Each component is then multiplied by <code class="constant">GL_DEPTH_SCALE</code>,
+ added to <code class="constant">GL_DEPTH_BIAS</code>,
+ and finally clamped to the range
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mfenced open="[" close="]">
<code class="constant">GL_RGBA</code> and <code class="constant">GL_BGRA</code> return four values for each pixel,
with all values corresponding to a single pixel occupying contiguous space
in <em class="parameter"><code>data</code></em>.
- Storage parameters set by <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>,
+ Storage parameters set by <a class="citerefentry" href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>,
such as <code class="constant">GL_PACK_LSB_FIRST</code> and <code class="constant">GL_PACK_SWAP_BYTES</code>,
affect the way that data is written into memory.
- See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a> for a description.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
+ See <a class="citerefentry" href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a> for a description.
+ </p></div><div class="refsect1"
title="Notes"><a id="notes"></a><h2>Notes</h2><p>
Values for pixels that lie outside the window
connected to the current GL context are undefined.
</p><p>
If an error is generated,
no change is made to the contents of <em class="parameter"><code>data</code></em>.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
+ </p></div><div class="refsect1"
title="Errors"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>format</code></em> or <em class="parameter"><code>type</code></em> is not an
accepted value.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if <code class="constant">GL_READ_FRAMEBUFFER_BINDING</code>
is non-zero, the read framebuffer is complete, and the value of <code class="constant">GL_SAMPLE_BUFFERS</code>
for the read framebuffer is greater than zero.
- </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_PIXEL_PACK_BUFFER_BINDING</code>
- </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
- <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>,
- <a href="glReadBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glReadBuffer</span></span></a>
- </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
+ </p></div><div class="refsect1" title="Associated Gets"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_INDEX_MODE</code>
+ </p><p>
+ <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_PIXEL_PACK_BUFFER_BINDING</code>
+ </p></div><div class="refsect1" title="See Also"><a id="seealso"></a><h2>See Also</h2><p>
+ <a class="citerefentry" href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>,
+ <a class="citerefentry" href="glReadBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glReadBuffer</span></span></a>
+ </p></div><div class="refsect1" title="Copyright"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006
Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
- <a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
+ <a class="ulink" href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
</p></div></div></body></html>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexBuffer
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexBuffer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexBuffer — attach the storage for a buffer object to the active buffer texture</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexBuffer</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalFormat</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">buffer</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexBuffer
</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexBuffer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexBuffer — attach the storage for a buffer object to the active buffer texture</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexBuffer</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalFormat</var>, </td></tr><tr><td> </td><td>Gluint </td><td><var class="pdparam">buffer</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target of the operation and must be <code class="constant">GL_TEXTURE_BUFFER</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>internalFormat</code></em></span></dt><dd><p>
Specifies the internal format of the data in the store belonging to <em class="parameter"><code>buffer</code></em>.
<a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>,
<a href="glDeleteTextures.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteTextures</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexImage1D
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexImage1D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexImage1D — specify a one-dimensional texture image</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexImage1D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">internalFormat</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">format</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>const GLvoid * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexImage1D</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexImage1D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexImage1D — specify a one-dimensional texture image</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexImage1D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">internalFormat</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">format</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>const GLvoid * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><p>
</p><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target texture.
Must be <code class="constant">GL_TEXTURE_1D</code> or <code class="constant">GL_PROXY_TEXTURE_1D</code>.
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RG</code></span></dt><dd><p>
Each element is a single red/green double
The GL converts it to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGB</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGR</code></span></dt><dd><p>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGBA</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGRA</code></span></dt><dd><p>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_DEPTH_COMPONENT</code></span></dt><dd><p>
Each element is a single depth value.
- The GL converts it to floating point
+ The GL converts it to floating point, multiplies by the signed scale factor
+ <code class="constant">GL_DEPTH_SCALE</code>, adds the signed bias <code class="constant">GL_DEPTH_BIAS</code>,
and clamps to the range [0,1].
</p></dd></dl></div><p>
If an application wants to store the texture at a certain
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RG</code></span></dt><dd><p>
Each element is a red/green double.
The GL converts it to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGB</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGR</code></span></dt><dd><p>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGBA</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGRA</code></span></dt><dd><p>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_DEPTH_COMPONENT</code></span></dt><dd><p>
Each element is a single depth value.
- The GL converts it to floating point,
+ The GL converts it to floating point, multiplies by the signed scale factor
+ <code class="constant">GL_DEPTH_SCALE</code>, adds the signed bias <code class="constant">GL_DEPTH_BIAS</code>,
and clamps to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_DEPTH_STENCIL</code></span></dt><dd><p>
Each element is a pair of depth and stencil values. The depth component of
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexImage3D
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexImage3D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexImage3D — specify a three-dimensional texture image</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexImage3D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">internalFormat</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">height</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">depth</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">format</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>const GLvoid * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexImage3D</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexImage3D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexImage3D — specify a three-dimensional texture image</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexImage3D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">internalFormat</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">height</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">depth</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">border</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">format</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>const GLvoid * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><p>
</p><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target texture.
Must be one of <code class="constant">GL_TEXTURE_3D</code>, <code class="constant">GL_PROXY_TEXTURE_3D</code>,
<code class="constant">GL_RGBA8UI</code>,
<code class="constant">GL_SRGB8_ALPHA8</code>,
<code class="constant">GL_RGB10_A2</code>,
- <code class="constant">GL_RGB10_A2UI</code>,
- <code class="constant">GL_R11F_G11F_B10F</code>,
+ <code class="constant">GL_RGBA10_A2UI</code>,
+ <code class="constant">GL_R11_G11_B10F</code>,
<code class="constant">GL_RG32F</code>,
<code class="constant">GL_RG32I</code>,
<code class="constant">GL_RG32UI</code>,
<code class="constant">GL_RG8</code>,
<code class="constant">GL_RG8I</code>,
<code class="constant">GL_RG8UI</code>,
- <code class="constant">GL_R32F</code>,
+ <code class="constant">GL_R23F</code>,
<code class="constant">GL_R32I</code>,
<code class="constant">GL_R32UI</code>,
<code class="constant">GL_R16F</code>,
<code class="constant">GL_R8</code>,
<code class="constant">GL_R8I</code>,
<code class="constant">GL_R8UI</code>,
- <code class="constant">GL_RGBA16_SNORM</code>,
+ <code class="constant">GL_RGBA16_UNORM</code>,
<code class="constant">GL_RGBA8_SNORM</code>,
<code class="constant">GL_RGB32F</code>,
<code class="constant">GL_RGB32I</code>,
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RG</code></span></dt><dd><p>
Each element is a red and green pair.
The GL converts each to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGB</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGR</code></span></dt><dd><p>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGBA</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGRA</code></span></dt><dd><p>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd></dl></div><p>
If an application wants to store the texture at a certain
resolution or in a certain format, it can request the resolution
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexSubImage1D
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexSubImage1D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexSubImage1D — specify a one-dimensional texture subimage</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexSubImage1D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">xoffset</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">format</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>const GLvoid * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexSubImage1D</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexSubImage1D"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexSubImage1D — specify a one-dimensional texture subimage</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexSubImage1D</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">level</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">xoffset</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">width</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">format</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>const GLvoid * </td><td><var class="pdparam">data</var><code>)</code>;</td></tr></table></div></div><p>
</p><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target texture.
Must be <code class="constant">GL_TEXTURE_1D</code>.
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or if
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_WIDTH</code>
+ is the <code class="constant">GL_TEXTURE_WIDTH</code>, and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">b</mml:mi></mml:math>
+ is
+ the width of the <code class="constant">GL_TEXTURE_BORDER</code>
of the texture image being modified.
+ Note that
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
+ includes twice the border width.
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em> is less than 0.
</p><p>
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
</mml:mrow>
+ </mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_WIDTH</code>, and
+ is the <code class="constant">GL_TEXTURE_WIDTH</code>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_HEIGHT</code>
+ is the <code class="constant">GL_TEXTURE_HEIGHT</code>, and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">b</mml:mi></mml:math>
+ is the border width
of the texture image being modified.
+ Note that
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>
+ include twice the border width.
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em> or <em class="parameter"><code>height</code></em> is less than 0.
</p><p>
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
or
<mml:mrow>
<mml:mi mathvariant="italic">zoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
is the <code class="constant">GL_TEXTURE_WIDTH</code>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_HEIGHT</code>, and
+ is the <code class="constant">GL_TEXTURE_HEIGHT</code>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">d</mml:mi></mml:math>
is the <code class="constant">GL_TEXTURE_DEPTH</code>
- of the texture image being modified.
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">b</mml:mi></mml:math>
+ is the border width of the texture image being modified.
+ Note that
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>,
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>,
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">d</mml:mi></mml:math>
+ include twice the border width.
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em>, <em class="parameter"><code>height</code></em>, or <em class="parameter"><code>depth</code></em>
is less than 0.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glVertexAttrib
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glVertexAttrib"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glVertexAttrib — Specifies the value of a generic vertex attribute</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib1f</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib1s</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib1d</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI1i</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI1ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib2f</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib2s</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib2d</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI2i</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI2ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib3f</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib3s</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib3d</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI3i</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI3ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib4f</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib4s</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib4d</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib4Nub</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLubyte </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLubyte </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLubyte </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLubyte </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI4i</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI4ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>Specifies the index of the generic vertex
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glVertexAttrib
</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glVertexAttrib"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glVertexAttrib — Specifies the value of a generic vertex attribute</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib1f</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib1s</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib1d</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI1i</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI1ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v0</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib2f</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib2s</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib2d</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI2i</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI2ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v1</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib3f</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib3s</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib3d</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI3i</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI3ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLoint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLoint </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLoint </td><td><var class="pdparam">v2</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib4f</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLfloat </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib4s</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLshort </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib4d</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLdouble </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttrib4Nub</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLubyte </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLubyte </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLubyte </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLubyte </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI4i</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribI4ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v0</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v1</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v2</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">v3</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>Specifies the index of the generic vertex
attribute to be modified.</p></dd><dt><span class="term">
<em class="parameter"><code>v0</code></em>,
<em class="parameter"><code>v1</code></em>,
attribute to be modified.</p></dd><dt><span class="term"><em class="parameter"><code>v</code></em></span></dt><dd><p>Specifies a pointer to an array of values to
be used for the generic vertex attribute.</p></dd></dl></div></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribP1ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLboolean </td><td><var class="pdparam">normalized</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">value</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribP2ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLboolean </td><td><var class="pdparam">normalized</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">value</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribP3ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLboolean </td><td><var class="pdparam">normalized</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">value</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribP4ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLboolean </td><td><var class="pdparam">normalized</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">value</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters3"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>Specifies the index of the generic vertex
attribute to be modified.</p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>Type of packing used on the data. This parameter must be
- <code class="constant">GL_INT_2_10_10_10_REV</code> or <code class="constant">GL_UNSIGNED_INT_2_10_10_10_REV</code>
+ <code class="constant">GL_INT_10_10_10_2</code> or <code class="constant">GL_UNSIGNED_INT_10_10_10_2</code>
to specify signed or unsigned data, respectively.</p></dd><dt><span class="term"><em class="parameter"><code>normalized</code></em></span></dt><dd><p>If <code class="constant">GL_TRUE</code>, then the values are to be
converted to floating point values by normalizing. Otherwise,
they are converted directly to floating point values.</p></dd><dt><span class="term">
<code class="constant">GL_MAX_VERTEX_ATTRIBS</code>.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if
<code class="function">glVertexAttribP</code> is used with a
<em class="parameter"><code>type</code></em> other than
- <code class="constant">GL_INT_2_10_10_10_REV</code> or
- <code class="constant">GL_UNSIGNED_INT_
2_10_10_10_REV</code>.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p><a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
+ <code class="constant">GL_INT_10_10_10_2</code> or
+ <code class="constant">GL_UNSIGNED_INT_
10_10_10_2</code>.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p><a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
with the argument <code class="constant">GL_CURRENT_PROGRAM</code></p><p><a href="glGetActiveAttrib.xml"><span class="citerefentry"><span class="refentrytitle">glGetActiveAttrib</span></span></a>
with argument <em class="parameter"><code>program</code></em> and the index of an active
attribute variable</p><p><a href="glGetAttribLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetAttribLocation</span></span></a>
with arguments <code class="constant">GL_CURRENT_VERTEX_ATTRIB</code> and
<em class="parameter"><code>index</code></em></p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p><a href="glBindAttribLocation.xml"><span class="citerefentry"><span class="refentrytitle">glBindAttribLocation</span></span></a>,
<a href="glVertexAttribPointer.xml"><span class="citerefentry"><span class="refentrytitle">glVertexAttribPointer</span></span></a></p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2003-2005 3Dlabs Inc. Ltd.
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2003-2005 3Dlabs Inc. Ltd.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glVertexAttribDivisor
- OpenGL 3.3 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glVertexAttribDivisor"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glVertexAttribDivisor — modify the rate at which generic vertex attributes advance during instanced rendering</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribDivisor</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">divisor</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glVertexAttribDivisor
</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div class="refentry" title="glVertexAttribDivisor"><a id="glVertexAttribDivisor"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glVertexAttribDivisor — modify the rate at which generic vertex attributes advance during instanced rendering</p></div><div class="refsynopsisdiv" title="C Specification"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribDivisor</b>(</code></td><td>GLuint <var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLuint <var class="pdparam">divisor</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Parameters"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>
Specify the index of the generic vertex attribute.
</p></dd><dt><span class="term"><em class="parameter"><code>divisor</code></em></span></dt><dd><p>
Specify the number of instances that will pass between updates of the generic attribute at slot <em class="parameter"><code>index</code></em>.
- </p></dd></dl></div></div><div class="refsect1"
lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
+ </p></dd></dl></div></div><div class="refsect1"
title="Description"><a id="description"></a><h2>Description</h2><p>
<code class="function">glVertexAttribDivisor</code> modifies the rate at which generic vertex attributes advance when rendering
multiple instances of primitives in a single draw call. If <em class="parameter"><code>divisor</code></em> is zero, the attribute at slot
<em class="parameter"><code>index</code></em> advances once per vertex. If <em class="parameter"><code>divisor</code></em> is non-zero, the attribute advances
once per <em class="parameter"><code>divisor</code></em> instances of the set(s) of vertices being rendered. An attribute
is referred to as instanced if its <code class="constant">GL_VERTEX_ATTRIB_ARRAY_DIVISOR</code> value is non-zero.
</p><p>
- <em class="parameter"><code>index</code></em> must be less than the value of <code class="constant">GL_MAX_VERTEX_ATTRIBS</code>.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
+ <em class="parameter"><code>index</code></em> must be less than the value of <code class="constant">GL_MAX_VERTEX_ATTRIBUTES</code>.
+ </p></div><div class="refsect1"
title="Notes"><a id="notes"></a><h2>Notes</h2><p>
<code class="function">glVertexAttribDivisor</code> is available only if the GL version is 3.3 or higher.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
+ </p></div><div class="refsect1"
title="Errors"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>index</code></em> is greater
- than or equal to the value of <code class="constant">GL_MAX_VERTEX_ATTRIBS</code>.
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
- <a href="glVertexAttribPointer.xml"><span class="citerefentry"><span class="refentrytitle">glVertexAttribPointer</span></span></a>,
- <a href="glEnableVertexAttribArray.xml"><span class="citerefentry"><span class="refentrytitle">glEnableVertexAttribArray</span></span></a>,
- <a href="glDisableVertexAttribArray.xml"><span class="citerefentry"><span class="refentrytitle">glDisableVertexAttribArray</span></span></a>
- </p></div><div class="refsect1"
lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
+ than or equal to the value of <code class="constant">GL_MAX_VERTEX_ATTRIBUTES</code>.
+ </p></div><div class="refsect1"
title="See Also"><a id="seealso"></a><h2>See Also</h2><p>
+ <a class="citerefentry" href="glVertexAttribPointer.xml"><span class="citerefentry"><span class="refentrytitle">glVertexAttribPointer</span></span></a>,
+ <a class="citerefentry" href="glEnableVertexAttribArray.xml"><span class="citerefentry"><span class="refentrytitle">glEnableVertexAttribArray</span></span></a>,
+ <a class="citerefentry" href="glDisableVertexAttribArray.xml"><span class="citerefentry"><span class="refentrytitle">glDisableVertexAttribArray</span></span></a>
+ </p></div><div class="refsect1"
title="Copyright"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
- <a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
+ <a class="ulink" href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
</p></div></div></body></html>
but will not directly affect transform feedback state. Instead, the indexed <constant>GL_TRANSFORM_FEEDBACK_BUFFER</constant>
bindings must be used through a call to <citerefentry><refentrytitle>glBindBufferBase</refentrytitle></citerefentry>
or <citerefentry><refentrytitle>glBindBufferRange</refentrytitle></citerefentry>. This will affect the generic
- <constant>GL_TRANSFORM_FEEDBACK_BUFFER</constant> binding.
+ <constant>GL_TRANSFORM_FEEDABCK_BUFFER</constant> binding.
</para>
<para>
Likewise, the <constant>GL_UNIFORM_BUFFER</constant>, <constant>GL_ATOMIC_COUNTER_BUFFER</constant> and <constant>GL_SHADER_STORAGE_BUFFER</constant>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>colorNumber</parameter> is greater than or equal to <constant>GL_MAX_DRAW_BUFFERS</constant>.
</para>
<para>
- <constant>GL_INVALID_VALUE</constant> is generated if <parameter>colorNumber</parameter> is greater than or equal to <constant>GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</constant>
+ <constant>GL_INVALID_VALUE</constant> is generated if <parameter>colorNumber</parameter> is greater than or equal to <constant>GL_MAX_DUAL_SOURCE_DRAW_BUFERS</constant>
and <parameter>index</parameter> is greater than or equal to one.
</para>
<para>
<refsect1 id="errors"><title>Errors</title>
<para>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>unit</parameter> is greater than or equal to the value of
- <constant>GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS</constant>.
+ <constant>GL_MAX_COMBIED_TEXTURE_IMAGE_UNITS</constant>.
</para>
<para>
<constant>GL_INVALID_OPERATION</constant> is generated if <parameter>sampler</parameter> is not zero or a name previously
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
<para>
- <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_SRC_RGB</constant>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_SRC</constant>
</para>
<para>
- <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_SRC_ALPHA</constant>
- </para>
- <para>
- <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_DST_RGB</constant>
- </para>
- <para>
- <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_DST_ALPHA</constant>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_BLEND_DST</constant>
</para>
<para>
<citerefentry><refentrytitle>glIsEnabled</refentrytitle></citerefentry> with argument <constant>GL_BLEND</constant>
<listitem>
<para>
<constant>GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER</constant> is returned if the value of <constant>GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</constant>
- is <constant>GL_NONE</constant> for any color attachment point(s) named by <constant>GL_DRAW_BUFFERi</constant>.
+ is <constant>GL_NONE</constant> for any color attachment point(s) named by <constant>GL_DRAWBUFFERi</constant>.
</para>
</listitem>
<listitem>
<refsect1 id="description"><title>Description</title>
<para>
<function>glClearBuffer*</function> clears the specified buffer to the specified value(s). If <parameter>buffer</parameter> is
- <constant>GL_COLOR</constant>, a particular draw buffer <constant>GL_DRAW
_BUFFER<parameter>i</parameter></constant> is specified
+ <constant>GL_COLOR</constant>, a particular draw buffer <constant>GL_DRAWBUFFER<parameter>i</parameter></constant> is specified
by passing <parameter>i</parameter> as <parameter>drawBuffer</parameter>. In this case, <parameter>value</parameter> points to
a four-element vector specifying the R, G, B and A color to clear that draw buffer to. If <parameter>buffer</parameter> is
one of <constant>GL_FRONT</constant>, <constant>GL_BACK</constant>, <constant>GL_LEFT</constant>, <constant>GL_RIGHT</constant>,
</para>
<para>
If <parameter>target</parameter> is <constant>GL_PROXY_TEXTURE_2D</constant>, <constant>GL_PROXY_TEXTURE_1D_ARRAY</constant>
- or <constant>GL_PROXY_
TEXTURE_CUBE_MAP</constant>, no data is read from <parameter>data</parameter>, but
+ or <constant>GL_PROXY_CUBE_MAP</constant>, no data is read from <parameter>data</parameter>, 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
<refmeta>
<refmetainfo>
<copyright>
- <year>2013</year>
- <holder>Khronos Group</holder>
+ <year>1991-2006</year>
+ <holder>Silicon Graphics, Inc.</holder>
</copyright>
</refmetainfo>
<refentrytitle>glCopyTexImage1D</refentrytitle>
<listitem>
<para>
Specifies the width of the texture image.
+ Must be 0 or
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup n + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer
+ <inlineequation><mml:math><mml:mi mathvariant="italic">n</mml:mi></mml:math></inlineequation>.
The height of the texture image is 1.
</para>
</listitem>
<term><parameter>border</parameter></term>
<listitem>
<para>
- Must be 0.
+ Specifies the width of the border.
+ Must be either 0 or 1.
</para>
</listitem>
</varlistentry>
</mml:math></inlineequation>
and with a length of
<inlineequation><mml:math>
- <mml:mi mathvariant="italic">width</mml:mi>
+ <!-- eqn: width + 2 ( border ): -->
+ <mml:mrow>
+ <mml:mi mathvariant="italic">width</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
</mml:math></inlineequation>
defines the texture array
at the mipmap level specified by <parameter>level</parameter>.
<constant>GL_MAX_TEXTURE_SIZE</constant>.
</para>
<para>
- <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0.
+ <constant>GL_INVALID_VALUE</constant> is generated if non-power-of-two textures are not supported and the <parameter>width</parameter> cannot be represented as
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup n + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer value of <emphasis>n</emphasis>.
+ </para>
+ <para>
+ <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0 or 1.
</para>
<para>
<constant>GL_INVALID_OPERATION</constant> is generated if <parameter>internalformat</parameter> is
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006
- Silicon Graphics, Inc.
- Copyright <trademark class="copyright"></trademark> 2012-2013 Khronos Group.
- This document is licensed under the SGI
+ Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
</para>
<refmeta>
<refmetainfo>
<copyright>
- <year>2013</year>
- <holder>Khronos Group</holder>
+ <year>1991-2006</year>
+ <holder>Silicon Graphics, Inc.</holder>
</copyright>
</refmetainfo>
<refentrytitle>glCopyTexImage2D</refentrytitle>
<listitem>
<para>
Specifies the width of the texture image.
+ Must be 0 or
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup n + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer
+ <inlineequation><mml:math><mml:mi mathvariant="italic">n</mml:mi></mml:math></inlineequation>.
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Specifies the height of the texture image.
+ Must be 0 or
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup m + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">m</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer
+ <inlineequation><mml:math><mml:mi mathvariant="italic">m</mml:mi></mml:math></inlineequation>.
</para>
</listitem>
</varlistentry>
<term><parameter>border</parameter></term>
<listitem>
<para>
- Must be 0.
+ Specifies the width of the border.
+ Must be either 0 or 1.
</para>
</listitem>
</varlistentry>
The screen-aligned pixel rectangle with lower left corner at (<parameter>x</parameter>,
<parameter>y</parameter>) and with a width of
<inlineequation><mml:math>
- <mml:mi mathvariant="italic">width</mml:mi>
+ <!-- eqn: width + 2 ( border ): -->
+ <mml:mrow>
+ <mml:mi mathvariant="italic">width</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
</mml:math></inlineequation>
and a height of
<inlineequation><mml:math>
- <mml:mi mathvariant="italic">height</mml:mi>
+ <!-- eqn: height + 2 ( border ): -->
+ <mml:mrow>
+ <mml:mi mathvariant="italic">height</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
</mml:math></inlineequation>
defines the texture array
at the mipmap level specified by <parameter>level</parameter>.
<constant>GL_MAX_TEXTURE_SIZE</constant>.
</para>
<para>
- <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0.
+ <constant>GL_INVALID_VALUE</constant> is generated if non-power-of-two textures are not supported and the <parameter>width</parameter> or <parameter>depth</parameter> cannot be represented as
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup k + 2 ( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">k</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer
+ <inlineequation><mml:math><mml:mi mathvariant="italic">k</mml:mi></mml:math></inlineequation>.
+ </para>
+ <para>
+ <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0 or 1.
</para>
<para>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>internalformat</parameter> is not an
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006
- Silicon Graphics, Inc.
- Copyright <trademark class="copyright"></trademark> 2012-2013 Khronos Group.
- This document is licensed under the SGI
+ Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
</para>
<refmeta>
<refmetainfo>
<copyright>
- <year>2013</year>
- <holder>Khronos Group</holder>
+ <year>1991-2006</year>
+ <holder>Silicon Graphics, Inc.</holder>
</copyright>
</refmetainfo>
<refentrytitle>glCopyTexSubImage1D</refentrytitle>
rendering context, then the values obtained for those pixels are undefined.
</para>
<para>
- No change is made to the <emphasis>internalformat</emphasis> or <emphasis>width</emphasis> parameters of the specified texture
+ No change is made to the <emphasis>internalformat</emphasis>, <emphasis>width</emphasis>,
+ or <emphasis>border</emphasis> parameters of the specified texture
array or to texel values outside the specified subregion.
</para>
</refsect1>
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
where
<inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_WIDTH</constant>
+ is the <constant>GL_TEXTURE_WIDTH</constant> and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">b</mml:mi></mml:math></inlineequation>
+ is the <constant>GL_TEXTURE_BORDER</constant>
of the texture image being modified.
+ Note that
+ <inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
+ includes twice the border width.
</para>
<para>
</para>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006
- Silicon Graphics, Inc.
- Copyright <trademark class="copyright"></trademark> 2012-2013 Khronos Group.
- This document is licensed under the SGI
+ Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
</para>
<refmeta>
<refmetainfo>
<copyright>
- <year>2013</year>
- <holder>Khronos Group</holder>
+ <year>1991-2006</year>
+ <holder>Silicon Graphics, Inc.</holder>
</copyright>
</refmetainfo>
<refentrytitle>glCopyTexSubImage2D</refentrytitle>
rendering context, then the values obtained for those pixels are undefined.
</para>
<para>
- No change is made to the <emphasis>internalformat</emphasis>, <emphasis>width</emphasis>, or
- <emphasis>height</emphasis>, parameters of the specified texture
+ No change is made to the <emphasis>internalformat</emphasis>, <emphasis>width</emphasis>,
+ <emphasis>height</emphasis>, or <emphasis>border</emphasis> parameters of the specified texture
array or to texel values outside the specified subregion.
</para>
</refsect1>
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
where
<inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
is the <constant>GL_TEXTURE_WIDTH</constant>,
<inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_HEIGHT</constant> and
+ is the <constant>GL_TEXTURE_HEIGHT</constant>,
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">b</mml:mi></mml:math></inlineequation>
+ is the <constant>GL_TEXTURE_BORDER</constant>
of the texture image being modified.
+ Note that
+ <inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>
+ include twice the border width.
</para>
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006
- Silicon Graphics, Inc. Copyright <trademark class="copyright"></trademark> 2012-2013 Khronos Group.
+ Silicon Graphics, Inc. Copyright <trademark class="copyright"></trademark> 2012 Khronos Group.
This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
<refmeta>
<refmetainfo>
<copyright>
- <year>2013</year>
- <holder>Khronos Group</holder>
+ <year>1991-2006</year>
+ <holder>Silicon Graphics, Inc.</holder>
</copyright>
</refmetainfo>
<refentrytitle>glCopyTexSubImage3D</refentrytitle>
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
<inlineequation><mml:math>
<mml:mrow>
<mml:mi mathvariant="italic">zoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math></inlineequation>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math></inlineequation>,
where
<inlineequation><mml:math><mml:mi mathvariant="italic">h</mml:mi></mml:math></inlineequation>
is the <constant>GL_TEXTURE_HEIGHT</constant>,
<inlineequation><mml:math><mml:mi mathvariant="italic">d</mml:mi></mml:math></inlineequation>
- is the <constant>GL_TEXTURE_DEPTH</constant> and
+ is the <constant>GL_TEXTURE_DEPTH</constant>,
+ and
+ <inlineequation><mml:math><mml:mi mathvariant="italic">b</mml:mi></mml:math></inlineequation>
+ is the <constant>GL_TEXTURE_BORDER</constant>
of the texture image being modified.
Note that
<inlineequation><mml:math><mml:mi mathvariant="italic">w</mml:mi></mml:math></inlineequation>,
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006
- Silicon Graphics, Inc.
- Copyright <trademark class="copyright"></trademark> 2012-2013 Khronos Group.
- This document is licensed under the SGI
+ Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
</para>
<para>\r
<parameter>type</parameter> may be one of <constant>GL_DEBUG_TYPE_ERROR</constant>, <constant>GL_DEBUG_TYPE_DEPRECATED_BEHAVIOR</constant>,\r
<constant>GL_DEBUG_TYPE_UNDEFINED_BEHAVIOR</constant>, <constant>GL_DEBUG_TYPE_PORTABILITY</constant>,\r
- <constant>GL_DEBUG_TYPE_PERFORMANCE</constant>, <constant>GL_DEBUG_TYPE_MARKER</constant>, <constant>GL_DEBUG_TYPE_PUSH_GROUP</constant>,\r
- <constant>GL_DEBUG_TYPE_POP_GROUP</constant>, or <constant>GL_DEBUG_TYPE_OTHER</constant> to indicate the type of messages describing\r
- GL errors, attempted use of deprecated features, triggering of undefined behavior, portability issues, performance notifications, markers,\r
- group push and pop events, and other\r
- types of messages, respectively. It may also take the value <constant>GL_DONT_CARE</constant>. If <parameter>type</parameter> is not <constant>GL_DONT_CARE</constant>\r
+ <constant>GL_DEBUG_TYPE_PERFORMANCE</constant>, <constant>GL_DEBUG_TYPE_OTHER</constant> to indicate the type of messages describing\r
+ GL errors, attempted use of deprecated features, triggering of undefined behavior, portability issues, performance notifications and other\r
+ types of messages. It may also take the value <constant>GL_DONT_CARE</constant>. If <parameter>type</parameter> is not <constant>GL_DONT_CARE</constant>\r
then only messages whose type matches <parameter>type</parameter> will be referenced.\r
</para>\r
<para>\r
<parameter>severity</parameter> may be one of <constant>GL_DEBUG_SEVERITY_LOW</constant>, <constant>GL_DEBUG_SEVERITY_MEDIUM</constant>,\r
- or <constant>GL_DEBUG_SEVERITY_HIGH</constant> to select messages of low, medium or high severity messages or to\r
- <constant>GL_DEBUG_SEVERITY_NOTIFICATION</constant> for notifications. It may also take the\r
+ or <constant>GL_DEBUG_SEVERITY_HIGH</constant> to select messages of low, medium or high severity messages. It may also take the\r
value <constant>GL_DONT_CARE</constant>. If <parameter>severity</parameter> is not <constant>GL_DONT_CARE</constant> then only\r
messages whose severity matches <parameter>severity</parameter> will be referenced.\r
</para>\r
inferior to those in a debug context. In particular, a valid implementation of the debug message queue in a non-debug context\r
may produce no messages at all.\r
</para>\r
- <para>\r
- <constant>GL_DEBUG_TYPE_MARKER</constant>, <constant>GL_DEBUG_TYPE_PUSH_GROUP</constant>, <constant>GL_DEBUG_TYPE_POP_GROUP</constant>, and <constant>GL_DEBUG_SEVERITY_NOTIFICATION</constant>\r
- are available only if the GL version is 4.3 or higher.\r
- </para>\r
</refsect1>\r
<refsect1 id="errors"><title>Errors</title>\r
<para>\r
use by the GL implementation. <parameter>type</parameter> indicates the type of the message\r
to be inserted and may be one of <constant>GL_DEBUG_TYPE_ERROR</constant>, <constant>GL_DEBUG_TYPE_DEPRECATED_BEHAVIOR</constant>,\r
<constant>GL_DEBUG_TYPE_UNDEFINED_BEHAVIOR</constant>, <constant>GL_DEBUG_TYPE_PORTABILITY</constant>,\r
- <constant>GL_DEBUG_TYPE_PERFORMANCE</constant>, <constant>GL_DEBUG_TYPE_MARKER</constant>, <constant>GL_DEBUG_TYPE_PUSH_GROUP</constant>, <constant>GL_DEBUG_TYPE_POP_GROUP</constant>, or <constant>GL_DEBUG_TYPE_OTHER</constant>.\r
+ <constant>GL_DEBUG_TYPE_PERFORMANCE</constant>, or <constant>GL_DEBUG_TYPE_OTHER</constant>.\r
<parameter>severity</parameter> indicates the severity of the message and may be <constant>GL_DEBUG_SEVERITY_LOW</constant>,\r
- <constant>GL_DEBUG_SEVERITY_MEDIUM</constant>, <constant>GL_DEBUG_SEVERITY_HIGH</constant> or <constant>GL_DEBUG_SEVERITY_NOTIFICATION</constant>.\r
+ <constant>GL_DEBUG_SEVERITY_MEDIUM</constant>, or <constant>GL_DEBUG_SEVERITY_HIGH</constant>.\r
<parameter>id</parameter> is available for application defined use and may be any value. This value\r
will be recorded and used to identify the message.\r
</para>\r
or equal to the implementation defined constant <constant>GL_MAX_DEBUG_MESSAGE_LENGTH</constant>.\r
</para>\r
</refsect1>\r
- <refsect1 id="notes"><title>Notes</title>\r
- <para>\r
- <constant>GL_DEBUG_TYPE_MARKER</constant>, <constant>GL_DEBUG_TYPE_PUSH_GROUP</constant>, <constant>GL_DEBUG_TYPE_POP_GROUP</constant>, and <constant>GL_DEBUG_SEVERITY_NOTIFICATION</constant>\r
- are available only if the GL version is 4.3 or higher.\r
- </para>\r
- </refsect1>\r
<refsect1 id="errors"><title>Errors</title>\r
<para>\r
<constant>GL_INVALID_ENUM</constant> is generated if any of <parameter>source</parameter>, <parameter>type</parameter>\r
<para><constant>GL_INVALID_ENUM</constant> is generated if the GL is bound
to a framebuffer object and one or more of the values in <parameter>bufs</parameter>
is anything other than <constant>GL_NONE</constant> or one of the
- <constant>GL_COLOR_ATTACHMENT<emphasis>n</emphasis></constant> tokens.</para>
+ <constant>GL_COLOR_ATTACHMENTS<emphasis>n</emphasis></constant> tokens.</para>
<para><constant>GL_INVALID_ENUM</constant> is generated if
<parameter>n</parameter> is less than 0.</para>
<refsect1 id="description"><title>Description</title>
<para>
<function>glFlushMappedBufferRange</function> indicates that modifications have been made to a range of a mapped buffer.
- The buffer must previously have been mapped with the <constant>GL_MAP_FLUSH_EXPLICIT
_BIT</constant> flag. <parameter>offset</parameter>
+ The buffer must previously have been mapped with the <constant>GL_MAP_FLUSH_EXPLICIT</constant> flag. <parameter>offset</parameter>
and <parameter>length</parameter> indicate the modified subrange of the mapping, in basic units. The specified subrange to flush
is relative to the start of the currently mapped range of the buffer. <function>glFlushMappedBufferRange</function> may be called
multiple times to indicate distinct subranges of the mapping which require flushing.
</para>
<para>
<constant>GL_INVALID_OPERATION</constant> is generated if the buffer bound to <parameter>target</parameter> is not
- mapped, or is mapped without the <constant>GL_MAP_FLUSH_EXPLICIT_BIT</constant> flag.
+ mapped, or is mapped without the <constant>GL_MAP_FLUSH_EXPLICIT</constant> flag.
</para>
</refsect1>
<refsect1 id="seealso"><title>See Also</title>
<para>
Specifies the attachment point of the framebuffer. <parameter>attachment</parameter> must be
<constant>GL_COLOR_ATTACHMENT<emphasis>i</emphasis></constant>, <constant>GL_DEPTH_ATTACHMENT</constant>,
- <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMENT</constant>.
+ <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMMENT</constant>.
</para>
</listitem>
</varlistentry>
<para>
<parameter>attachment</parameter> specifies the logical attachment of the framebuffer and must be
<constant>GL_COLOR_ATTACHMENT<emphasis>i</emphasis></constant>, <constant>GL_DEPTH_ATTACHMENT</constant>,
- <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMENT</constant>.
+ <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMMENT</constant>.
<emphasis>i</emphasis> in <constant>GL_COLOR_ATTACHMENT<emphasis>i</emphasis></constant> may range from zero to
the value of <constant>GL_MAX_COLOR_ATTACHMENTS</constant> - 1. Attaching a level of a texture to
<constant>GL_DEPTH_STENCIL_ATTACHMENT</constant> is equivalent to attaching that level to both the
<para>
Specifies the attachment point of the framebuffer. <parameter>attachment</parameter> must be
<constant>GL_COLOR_ATTACHMENT<emphasis>i</emphasis></constant>, <constant>GL_DEPTH_ATTACHMENT</constant>,
- <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMENT</constant>.
+ <constant>GL_STENCIL_ATTACHMENT</constant> or <constant>GL_DEPTH_STENCIL_ATTACHMMENT</constant>.
</para>
</listitem>
</varlistentry>
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><constant>GL_LINE_WIDTH_GRANULARITY</constant></term>
+ <listitem>
+ <para>
+ </para>
+ <para>
+ <parameter>params</parameter> returns one value,
+ the width difference between adjacent supported widths for antialiased lines.
+ See <citerefentry><refentrytitle>glLineWidth</refentrytitle></citerefentry>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><constant>GL_LINE_WIDTH_RANGE</constant></term>
+ <listitem>
+ <para>
+ </para>
+ <para>
+ <parameter>params</parameter> returns two values:
+ the smallest and largest supported widths for antialiased
+ lines.
+ See <citerefentry><refentrytitle>glLineWidth</refentrytitle></citerefentry>.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><constant>GL_LOGIC_OP_MODE</constant></term>
<listitem>
</listitem>
</varlistentry>
<varlistentry>
- <term><constant>GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</constant></term>
+ <term><constant>GL_MAX_DUALSOURCE_DRAW_BUFFERS</constant></term>
<listitem>
<para>
</para>
<parameter>params</parameter> returns one value.
The value gives a rough estimate of the largest rectangular texture that
the GL can handle. The value must be at least 1024.
- Use <constant>GL_PROXY_TEXTURE_RECTANGLE</constant>
+ Use <constant>GL_PROXY_RECTANGLE_TEXTURE</constant>
to determine if a texture is too large.
See <citerefentry><refentrytitle>glTexImage2D</refentrytitle></citerefentry>.
</para>
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><constant>GL_PROGRAM_POINT_SIZE</constant></term>
- <listitem>
- <para>
- </para>
- <para>
- <parameter>params</parameter> returns a single boolean value indicating whether vertex
- program point size mode is enabled. If enabled, then the
- point size is taken from the shader built-in <code>gl_PointSize</code>. If disabled,
- then the point size is taken from the point state as specified
- by <citerefentry><refentrytitle>glPointSize</refentrytitle></citerefentry>.
- The initial value is <constant>GL_FALSE</constant>.
- </para>
- </listitem>
- </varlistentry>
<varlistentry>
<term><constant>GL_PROVOKING_VERTEX</constant></term>
<listitem>
</listitem>
</varlistentry>
<varlistentry>
- <term><constant>GL_TEXTURE_BINDING_BUFFER</constant></term>
+ <term><constant>GL_TEXTURE_BUFFER_BINDING</constant></term>
<listitem>
<para>
</para>
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><constant>GL_VERTEX_PROGRAM_POINT_SIZE</constant></term>
+ <listitem>
+ <para>
+ </para>
+ <para>
+ <parameter>params</parameter> returns a single boolean value indicating whether vertex
+ program point size mode is enabled. If enabled, and a vertex shader is active, then the
+ point size is taken from the shader built-in <code>gl_PointSize</code>. If disabled,
+ and a vertex shader is active, then the point size is taken from the point state as specified
+ by <citerefentry><refentrytitle>glPointSize</refentrytitle></citerefentry>.
+ The initial value is <constant>GL_FALSE</constant>.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><constant>GL_VERTEX_BINDING_DIVISOR</constant></term>
<listitem>
<constant>GL_INT_VEC2</constant>,
<constant>GL_INT_VEC3</constant>,
<constant>GL_INT_VEC4</constant>,
- <constant>GL_UNSIGNED_INT</constant>,
+ <constant>GL_UNSIGNED_INT_VEC</constant>,
<constant>GL_UNSIGNED_INT_VEC2</constant>,
<constant>GL_UNSIGNED_INT_VEC3</constant>,
<constant>GL_UNSIGNED_INT_VEC4</constant>,
<para><citerefentry><refentrytitle>glGet</refentrytitle></citerefentry>
with argument <constant>GL_MAX_VERTEX_UNIFORM_COMPONENTS</constant>,
<constant>GL_MAX_GEOMETRY_UNIFORM_COMPONENTS</constant>,
- <constant>GL_MAX_TESS_CONTROL_UNIFORM_COMPONENTS</constant>,
- <constant>GL_MAX_TESS_EVALUATION_UNIFORM_COMPONENTS</constant>,
- <constant>GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</constant>.</para>
+ <constant>GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</constant>, or
+ <constant>GL_MAX_COMBINED_UNIFORM_COMPONENTS</constant>.</para>
<para><citerefentry><refentrytitle>glGetProgram</refentrytitle></citerefentry>
with argument <constant>GL_ACTIVE_UNIFORMS</constant> or
<paramdef>GLuint <parameter>program</parameter></paramdef>
<paramdef>GLuint <parameter>uniformBlockIndex</parameter></paramdef>
<paramdef>GLenum <parameter>pname</parameter></paramdef>
- <paramdef>GLint
*<parameter>params</parameter></paramdef>
+ <paramdef>GLint <parameter>params</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
</refsect1>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.
+ Copyright <trademark class="copyright"></trademark> 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 2005 Addison-Wesley.
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
</refsect1>
<refsect1 id="description"><title>Description</title>
<para>
- <function>glGetFramebufferAttachmentParameteriv</function> returns information about attachments of a bound framebuffer
+ <function>glGetFramebufferAttachmentParameter</function> returns information about attachments of a bound framebuffer
object. <parameter>target</parameter> specifies the framebuffer binding point and must be <constant>GL_DRAW_FRAMEBUFFER</constant>,
<constant>GL_READ_FRAMEBUFFER</constant> or <constant>GL_FRAMEBUFFER</constant>. <constant>GL_FRAMEBUFFER</constant> is equivalent
to <constant>GL_DRAW_FRAMEBUFFER</constant>.
</refsect1>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.
+ Copyright <trademark class="copyright"></trademark> 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
<refmeta>
<refmetainfo>
<copyright>
- <year>2013</year>
- <holder>Khronos Group</holder>
+ <year>1991-2006</year>
+ <holder>Silicon Graphics, Inc.</holder>
</copyright>
</refmetainfo>
<refentrytitle>glGetTexLevelParameter</refentrytitle>
<constant>GL_TEXTURE_HEIGHT</constant>,
<constant>GL_TEXTURE_DEPTH</constant>,
<constant>GL_TEXTURE_INTERNAL_FORMAT</constant>,
+ <constant>GL_TEXTURE_BORDER</constant>,
<constant>GL_TEXTURE_RED_SIZE</constant>,
<constant>GL_TEXTURE_GREEN_SIZE</constant>,
<constant>GL_TEXTURE_BLUE_SIZE</constant>,
<constant>GL_MAX_TEXTURE_SIZE</constant>, and <constant>GL_MAX_3D_TEXTURE_SIZE</constant> are not really
descriptive enough.
It has to report the largest square texture image that can be
- accommodated with mipmaps
- but a long skinny texture, or a texture without mipmaps may
+ 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.
<para>
<parameter>params</parameter> returns a single value,
the width of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</para>
</listitem>
</varlistentry>
<para>
<parameter>params</parameter> returns a single value,
the height of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</para>
</listitem>
</varlistentry>
<para>
<parameter>params</parameter> returns a single value,
the depth of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</para>
</listitem>
</varlistentry>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006
- Silicon Graphics, Inc. Copyright <trademark class="copyright"></trademark> 2010-2013
+ Silicon Graphics, Inc. Copyright <trademark class="copyright"></trademark> 2010-2012
Khronos Group. This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
<paramdef>GLuint<parameter>index</parameter></paramdef>
<paramdef>GLsizei<parameter>bufSize</parameter></paramdef>
<paramdef>GLsizei *<parameter>length</parameter></paramdef>
- <paramdef>GLsizei
*<parameter>size</parameter></paramdef>
+ <paramdef>GLsizei<parameter>size</parameter></paramdef>
<paramdef>GLenum *<parameter>type</parameter></paramdef>
<paramdef>char *<parameter>name</parameter></paramdef>
</funcprototype>
variable selected by <parameter>index</parameter>. An <parameter>index</parameter> of 0 selects
the first varying variable specified in the <parameter>varyings</parameter> array passed
to <citerefentry><refentrytitle>glTransformFeedbackVaryings</refentrytitle></citerefentry>, and
- an <parameter>index</parameter> of <constant>GL_TRANSFORM_FEEDBACK_VARYINGS</constant> - 1 selects
+ an <parameter>index</parameter> of <constant>GL_TRANSFORM_FEEDBACK_VARYINGS-1</constant> selects
the last such variable.
</para>
<para>
</para>
</refsect1> <refsect1 id="Copyright"><title>Copyright</title>
<para>
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.
+ Copyright <trademark class="copyright"></trademark> 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
</row>
<row>
<entry align="left">
- <constant>GL_TEXTURE_CUBE_MAP_SEAMLESS</constant>
+ <constant>GL_TEXTURE_CUBEMAP_SEAMLESS</constant>
</entry>
<entry align="left">
<citerefentry><refentrytitle>glEnable</refentrytitle></citerefentry>
<listitem>
<para>The total number of components to capture in any transform feedback varying variable
is greater than the constant <constant>GL_MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS</constant>
- and the buffer mode is <constant>GL_SEPARATE_ATTRIBS</constant>.</para>
+ and the buffer mode is <constant>SEPARATE_ATTRIBS</constant>.</para>
</listitem>
</itemizedlist>
<para>
<citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_POINT_SIZE</constant>
</para>
+ <para>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_POINT_SIZE_MIN</constant>
+ </para>
+ <para>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_POINT_SIZE_MAX</constant>
+ </para>
<para>
<citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_POINT_FADE_THRESHOLD_SIZE</constant>
</para>
<listitem>
<para>
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 <constant>GL_INDEX_SHIFT</constant>,
+ and added to <constant>GL_INDEX_OFFSET</constant>.
+ If <constant>GL_MAP_STENCIL</constant> is <constant>GL_TRUE</constant>,
+ indices are replaced by their mappings in the table <constant>GL_PIXEL_MAP_S_TO_S</constant>.
</para>
</listitem>
</varlistentry>
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 clamped to the range
+ Each component is then multiplied by <constant>GL_DEPTH_SCALE</constant>,
+ added to <constant>GL_DEPTH_BIAS</constant>,
+ and finally clamped to the range
<inlineequation><mml:math>
<!-- eqn: [0,1]: -->
<mml:mfenced open="[" close="]">
</para>
</refsect1>
<refsect1 id="associatedgets"><title>Associated Gets</title>
+ <para>
+ <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_INDEX_MODE</constant>
+ </para>
<para>
<citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_PIXEL_PACK_BUFFER_BINDING</constant>
</para>
<funcdef>void <function>glTexBuffer</function></funcdef>
<paramdef>GLenum <parameter>target</parameter></paramdef>
<paramdef>GLenum <parameter>internalFormat</parameter></paramdef>
- <paramdef>G
Luint <parameter>buffer</parameter></paramdef>
+ <paramdef>G
luint<parameter>buffer</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
</refsect1>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.
+ Copyright <trademark class="copyright"></trademark> 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
Each element is a single red/green double
The GL converts it to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element contains all four components.
- Each component clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element is a single depth value.
- The GL converts it to floating point and clamps to the range [0,1].
+ The GL converts it to floating point, multiplies by the signed scale factor
+ <constant>GL_DEPTH_SCALE</constant>, adds the signed bias <constant>GL_DEPTH_BIAS</constant>,
+ and clamps to the range [0,1].
</para>
</listitem>
</varlistentry>
or greater than <constant>GL_MAX_TEXTURE_SIZE</constant>.
</para>
<para>
- <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0.
+ <constant>GL_INVALID_VALUE</constant> is generated if non-power-of-two textures are not supported and the <parameter>width</parameter> cannot be represented as
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup n + 2(border): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some integer value of <emphasis>n</emphasis>.
+ </para>
+ <para>
+ <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0 or 1.
</para>
<para>
<constant>GL_INVALID_OPERATION</constant> is generated if <parameter>type</parameter> is one of
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006 Silicon Graphics, Inc.
- Copyright <trademark class="copyright"></trademark> 2011-2013 Khronos Group.
+ Copyright <trademark class="copyright"></trademark> 2011 Khronos Group.
This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
Each element is a red/green double.
The GL converts it to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element is a single depth value.
- The GL converts it to floating point and clamps to the range [0,1].
+ The GL converts it to floating point, multiplies by the signed scale factor
+ <constant>GL_DEPTH_SCALE</constant>, adds the signed bias <constant>GL_DEPTH_BIAS</constant>,
+ and clamps to the range [0,1].
</para>
</listitem>
</varlistentry>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>width</parameter> or <parameter>height</parameter> is less than 0
or greater than <constant>GL_MAX_TEXTURE_SIZE</constant>.
</para>
+ <para>
+ <constant>GL_INVALID_VALUE</constant> is generated if non-power-of-two textures are not supported and the <parameter>width</parameter> or <parameter>height</parameter> cannot be represented as
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup k + 2(border): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">k</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some
+ integer value of <emphasis>k</emphasis>.
+ </para>
<para>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0.
</para>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006 Silicon Graphics, Inc.
- Copyright <trademark class="copyright"></trademark> 2011-2013 Khronos Group.
+ Copyright <trademark class="copyright"></trademark> 2011 Khronos Group.
This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
<refmeta>
<refmetainfo>
<copyright>
- <year>2013</year>
+ <year>2010</year>
<holder>Khronos Group</holder>
</copyright>
</refmetainfo>
</refsect1>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
- Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.
+ Copyright <trademark class="copyright"></trademark> 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
<refmeta>
<refmetainfo>
<copyright>
- <year>2013</year>
- <holder>Khronos Group</holder>
+ <year>1991-2006</year>
+ <holder>Silicon Graphics, Inc.</holder>
</copyright>
</refmetainfo>
<refentrytitle>glTexImage3D</refentrytitle>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
Each element is a red and green pair.
The GL converts each to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<listitem>
<para>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <constant>GL_c_SCALE</constant>,
+ added to the signed bias <constant>GL_c_BIAS</constant>,
+ and clamped to the range [0,1].
</para>
</listitem>
</varlistentry>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>width</parameter>, <parameter>height</parameter>, or <parameter>depth</parameter> is less than 0 or greater than <constant>GL_MAX_TEXTURE_SIZE</constant>.
</para>
<para>
- <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0.
+ <constant>GL_INVALID_VALUE</constant> is generated if non-power-of-two textures are not supported and the <parameter>width</parameter>, <parameter>height</parameter>, or <parameter>depth</parameter> cannot be represented as
+ <inlineequation><mml:math>
+ <!-- eqn: 2 sup k + 2( border ): -->
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">k</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo>⁡</mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math></inlineequation>
+ for some
+ integer value of <emphasis>k</emphasis>.
+ </para>
+ <para>
+ <constant>GL_INVALID_VALUE</constant> is generated if <parameter>border</parameter> is not 0 or 1.
</para>
<para>
<constant>GL_INVALID_OPERATION</constant> is generated if <parameter>type</parameter> is one of
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006 Silicon Graphics, Inc.
- Copyright <trademark class="copyright"></trademark> 2011-2013 Khronos Group.
+ Copyright <trademark class="copyright"></trademark> 2011 Khronos Group.
This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
<term><parameter>type</parameter></term>
<listitem>
<para>Type of packing used on the data. This parameter must be
- <constant>GL_INT_2_10_10_10_REV</constant> or <constant>GL_UNSIGNED_INT_2_10_10_10_REV</constant>
+ <constant>GL_INT_10_10_10_2</constant> or <constant>GL_UNSIGNED_INT_10_10_10_2</constant>
to specify signed or unsigned data, respectively.</para>
</listitem>
</varlistentry>
<para><constant>GL_INVALID_ENUM</constant> is generated if
<function>glVertexAttribP</function> is used with a
<parameter>type</parameter> other than
- <constant>GL_INT_2_10_10_10_REV</constant> or
- <constant>GL_UNSIGNED_INT_2_10_10_10_REV</constant>.</para>
+ <constant>GL_INT_10_10_10_2</constant> or
+ <constant>GL_UNSIGNED_INT_10_10_10_2</constant>.</para>
<para><constant>GL_INVALID_ENUM</constant> is generated if
<function>glVertexAttribL</function> is used with a
is referred to as instanced if its <constant>GL_VERTEX_ATTRIB_ARRAY_DIVISOR</constant> value is non-zero.
</para>
<para>
- <parameter>index</parameter> must be less than the value of <constant>GL_MAX_VERTEX_ATTRIBS</constant>.
+ <parameter>index</parameter> must be less than the value of <constant>GL_MAX_VERTEX_ATTRIBUTES</constant>.
</para>
</refsect1>
<refsect1 id="notes"><title>Notes</title>
<refsect1 id="errors"><title>Errors</title>
<para>
<constant>GL_INVALID_VALUE</constant> is generated if <parameter>index</parameter> is greater
- than or equal to the value of <constant>GL_MAX_VERTEX_ATTRIBS</constant>.
+ than or equal to the value of <constant>GL_MAX_VERTEX_ATTRIBUTES</constant>.
</para>
</refsect1>
<refsect1 id="seealso"><title>See Also</title>
but will not directly affect transform feedback state. Instead, the indexed <code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER</code>
bindings must be used through a call to <a href="glBindBufferBase.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferBase</span></span></a>
or <a href="glBindBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glBindBufferRange</span></span></a>. This will affect the generic
- <code class="constant">GL_TRANSFORM_FEEDBACK_BUFFER</code> binding.
+ <code class="constant">GL_TRANSFORM_FEEDABCK_BUFFER</code> binding.
</p><p>
Likewise, the <code class="constant">GL_UNIFORM_BUFFER</code>, <code class="constant">GL_ATOMIC_COUNTER_BUFFER</code> and <code class="constant">GL_SHADER_STORAGE_BUFFER</code>
buffer binding points may
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>colorNumber</code></em> is greater than or equal to <code class="constant">GL_MAX_DRAW_BUFFERS</code>.
</p><p>
- <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>colorNumber</code></em> is greater than or equal to <code class="constant">GL_MAX_DUAL_SOURCE_DRAW_BUFFERS</code>
+ <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>colorNumber</code></em> is greater than or equal to <code class="constant">GL_MAX_DUAL_SOURCE_DRAW_BUFERS</code>
and <em class="parameter"><code>index</code></em> is greater than or equal to one.
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>index</code></em> is greater than one.
<code class="function">glBindSampler</code> is available only if the GL version is 3.3 or higher.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>unit</code></em> is greater than or equal to the value of
- <code class="constant">GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS</code>.
+ <code class="constant">GL_MAX_COMBIED_TEXTURE_IMAGE_UNITS</code>.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if <em class="parameter"><code>sampler</code></em> is not zero or a name previously
returned from a call to <a href="glGenSamplers.xml"><span class="citerefentry"><span class="refentrytitle">glGenSamplers</span></span></a>, or if such a name has
<code class="constant">GL_INVALID_VALUE</code> is generated by <code class="function">glBlendFunci</code> if <em class="parameter"><code>buf</code></em> is greater
than or equal to the value of <code class="constant">GL_MAX_DRAW_BUFFERS</code>.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_SRC_RGB</code>
+ <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_SRC</code>
</p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_SRC_ALPHA</code>
- </p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_DST_RGB</code>
- </p><p>
- <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_DST_ALPHA</code>
+ <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_BLEND_DST</code>
</p><p>
<a href="glIsEnabled.xml"><span class="citerefentry"><span class="refentrytitle">glIsEnabled</span></span></a> with argument <code class="constant">GL_BLEND</code>
</p><p>
<code class="constant">GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT</code> is returned if the framebuffer does not have at least one image attached to it.
</p></li><li><p>
<code class="constant">GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER</code> is returned if the value of <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</code>
- is <code class="constant">GL_NONE</code> for any color attachment point(s) named by <code class="constant">GL_DRAW_BUFFERi</code>.
+ is <code class="constant">GL_NONE</code> for any color attachment point(s) named by <code class="constant">GL_DRAWBUFFERi</code>.
</p></li><li><p>
<code class="constant">GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER</code> is returned if <code class="constant">GL_READ_BUFFER</code> is not <code class="constant">GL_NONE</code>
and the value of <code class="constant">GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE</code> is <code class="constant">GL_NONE</code> for the color attachment point named
The value to clear a stencil render buffer to.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glClearBuffer*</code> clears the specified buffer to the specified value(s). If <em class="parameter"><code>buffer</code></em> is
- <code class="constant">GL_COLOR</code>, a particular draw buffer <code class="constant">GL_DRAW_BUFFER<em class="parameter"><code>i</code></em></code> is specified
+ <code class="constant">GL_COLOR</code>, a particular draw buffer <code class="constant">GL_DRAWBUFFER<em class="parameter"><code>i</code></em></code> is specified
by passing <em class="parameter"><code>i</code></em> as <em class="parameter"><code>drawBuffer</code></em>. In this case, <em class="parameter"><code>value</code></em> points to
a four-element vector specifying the R, G, B and A color to clear that draw buffer to. If <em class="parameter"><code>buffer</code></em> is
one of <code class="constant">GL_FRONT</code>, <code class="constant">GL_BACK</code>, <code class="constant">GL_LEFT</code>, <code class="constant">GL_RIGHT</code>,
is treated as an array of compressed 1D textures.
</p><p>
If <em class="parameter"><code>target</code></em> is <code class="constant">GL_PROXY_TEXTURE_2D</code>, <code class="constant">GL_PROXY_TEXTURE_1D_ARRAY</code>
- or <code class="constant">GL_PROXY_TEXTURE_CUBE_MAP</code>, no data is read from <em class="parameter"><code>data</code></em>, but
+ or <code class="constant">GL_PROXY_CUBE_MAP</code>, no data is read from <em class="parameter"><code>data</code></em>, 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
of the row of pixels to be copied.
</p></dd><dt><span class="term"><em class="parameter"><code>width</code></em></span></dt><dd><p>
Specifies the width of the texture image.
+ Must be 0 or
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">n</mml:mi></mml:math>.
The height of the texture image is 1.
</p></dd><dt><span class="term"><em class="parameter"><code>border</code></em></span></dt><dd><p>
- Must be 0.
+ Specifies the width of the border.
+ Must be either 0 or 1.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glCopyTexImage1D</code> defines a one-dimensional texture image with pixels from the current
<code class="constant">GL_READ_BUFFER</code>.
</mml:math>
and with a length of
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
- <mml:mi mathvariant="italic">width</mml:mi>
+
+ <mml:mrow>
+ <mml:mi mathvariant="italic">width</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
</mml:math>
defines the texture array
at the mipmap level specified by <em class="parameter"><code>level</code></em>.
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em> is less than 0 or greater than
<code class="constant">GL_MAX_TEXTURE_SIZE</code>.
</p><p>
- <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0.
+ <code class="constant">GL_INVALID_VALUE</code> is generated if non-power-of-two textures are not supported and the <em class="parameter"><code>width</code></em> cannot be represented as
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer value of <span class="emphasis"><em>n</em></span>.
+ </p><p>
+ <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0 or 1.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if <em class="parameter"><code>internalformat</code></em> is
<code class="constant">GL_DEPTH_COMPONENT</code>, <code class="constant">GL_DEPTH_COMPONENT16</code>,
<a href="glTexParameter.xml"><span class="citerefentry"><span class="refentrytitle">glTexParameter</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006
- Silicon Graphics, Inc.
- Copyright <span class="trademark"></span>© 2012-2013 Khronos Group.
- This document is licensed under the SGI
+ Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
</p></div></div></body></html>
of the rectangular region of pixels to be copied.
</p></dd><dt><span class="term"><em class="parameter"><code>width</code></em></span></dt><dd><p>
Specifies the width of the texture image.
+ Must be 0 or
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">n</mml:mi></mml:math>.
</p></dd><dt><span class="term"><em class="parameter"><code>height</code></em></span></dt><dd><p>
Specifies the height of the texture image.
+ Must be 0 or
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">m</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">m</mml:mi></mml:math>.
</p></dd><dt><span class="term"><em class="parameter"><code>border</code></em></span></dt><dd><p>
- Must be 0.
+ Specifies the width of the border.
+ Must be either 0 or 1.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glCopyTexImage2D</code> defines a two-dimensional texture image, or cube-map texture image
with pixels from the current
The screen-aligned pixel rectangle with lower left corner at (<em class="parameter"><code>x</code></em>,
<em class="parameter"><code>y</code></em>) and with a width of
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
- <mml:mi mathvariant="italic">width</mml:mi>
+
+ <mml:mrow>
+ <mml:mi mathvariant="italic">width</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
</mml:math>
and a height of
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
- <mml:mi mathvariant="italic">height</mml:mi>
+
+ <mml:mrow>
+ <mml:mi mathvariant="italic">height</mml:mi>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
</mml:math>
defines the texture array
at the mipmap level specified by <em class="parameter"><code>level</code></em>.
or greater than
<code class="constant">GL_MAX_TEXTURE_SIZE</code>.
</p><p>
- <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0.
+ <code class="constant">GL_INVALID_VALUE</code> is generated if non-power-of-two textures are not supported and the <em class="parameter"><code>width</code></em> or <em class="parameter"><code>depth</code></em> cannot be represented as
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">k</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">k</mml:mi></mml:math>.
+ </p><p>
+ <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0 or 1.
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>internalformat</code></em> is not an
accepted format.
<a href="glTexParameter.xml"><span class="citerefentry"><span class="refentrytitle">glTexParameter</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006
- Silicon Graphics, Inc.
- Copyright <span class="trademark"></span>© 2012-2013 Khronos Group.
- This document is licensed under the SGI
+ Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
</p></div></div></body></html>
<code class="constant">GL_READ_BUFFER</code> are outside the read window associated with the current
rendering context, then the values obtained for those pixels are undefined.
</p><p>
- No change is made to the <span class="emphasis"><em>internalformat</em></span> or <span class="emphasis"><em>width</em></span> parameters of the specified texture
+ No change is made to the <span class="emphasis"><em>internalformat</em></span>, <span class="emphasis"><em>width</em></span>,
+ or <span class="emphasis"><em>border</em></span> parameters of the specified texture
array or to texel values outside the specified subregion.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
The <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a> mode affects texture images.
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_WIDTH</code>
+ is the <code class="constant">GL_TEXTURE_WIDTH</code> and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">b</mml:mi></mml:math>
+ is the <code class="constant">GL_TEXTURE_BORDER</code>
of the texture image being modified.
+ Note that
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
+ includes twice the border width.
</p><p>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
<a href="glGetTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexImage</span></span></a>
<a href="glTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage3D</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006
- Silicon Graphics, Inc.
- Copyright <span class="trademark"></span>© 2012-2013 Khronos Group.
- This document is licensed under the SGI
+ Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
</p></div></div></body></html>
<code class="constant">GL_READ_BUFFER</code> are outside the read window associated with the current
rendering context, then the values obtained for those pixels are undefined.
</p><p>
- No change is made to the <span class="emphasis"><em>internalformat</em></span>, <span class="emphasis"><em>width</em></span>, or
- <span class="emphasis"><em>height</em></span>, parameters of the specified texture
+ No change is made to the <span class="emphasis"><em>internalformat</em></span>, <span class="emphasis"><em>width</em></span>,
+ <span class="emphasis"><em>height</em></span>, or <span class="emphasis"><em>border</em></span> parameters of the specified texture
array or to texel values outside the specified subregion.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
<a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a> modes affect texture images.
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
is the <code class="constant">GL_TEXTURE_WIDTH</code>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_HEIGHT</code> and
+ is the <code class="constant">GL_TEXTURE_HEIGHT</code>,
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">b</mml:mi></mml:math>
+ is the <code class="constant">GL_TEXTURE_BORDER</code>
of the texture image being modified.
+ Note that
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>
+ include twice the border width.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
<a href="glGetTexImage.xml"><span class="citerefentry"><span class="refentrytitle">glGetTexImage</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<a href="glTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage3D</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006
- Silicon Graphics, Inc. Copyright <span class="trademark"></span>© 2012-2013 Khronos Group.
+ Silicon Graphics, Inc. Copyright <span class="trademark"></span>© 2012 Khronos Group.
This document is licensed under the SGI
Free Software B License. For details, see
<a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
<mml:mrow>
<mml:mi mathvariant="italic">xoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">w</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mrow>
<mml:mi mathvariant="italic">yoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">h</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mrow>
<mml:mi mathvariant="italic">zoffset</mml:mi>
<mml:mo><</mml:mo>
- <mml:mn>0</mml:mn>
+ <mml:mrow>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
</mml:mrow>
</mml:math>,
or
</mml:mrow>
</mml:mfenced>
<mml:mo>></mml:mo>
- <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mfenced open="(" close=")">
+ <mml:mrow>
+ <mml:mi mathvariant="italic">d</mml:mi>
+ <mml:mo>-</mml:mo>
+ <mml:mi mathvariant="italic">b</mml:mi>
+ </mml:mrow>
+ </mml:mfenced>
</mml:mrow>
</mml:math>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">h</mml:mi></mml:math>
is the <code class="constant">GL_TEXTURE_HEIGHT</code>,
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">d</mml:mi></mml:math>
- is the <code class="constant">GL_TEXTURE_DEPTH</code> and
+ is the <code class="constant">GL_TEXTURE_DEPTH</code>,
+ and
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">b</mml:mi></mml:math>
+ is the <code class="constant">GL_TEXTURE_BORDER</code>
of the texture image being modified.
Note that
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">w</mml:mi></mml:math>,
<a href="glTexSubImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexSubImage3D</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006
- Silicon Graphics, Inc.
- Copyright <span class="trademark"></span>© 2012-2013 Khronos Group.
- This document is licensed under the SGI
+ Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
</p></div></div></body></html>
</p><p>
<em class="parameter"><code>type</code></em> may be one of <code class="constant">GL_DEBUG_TYPE_ERROR</code>, <code class="constant">GL_DEBUG_TYPE_DEPRECATED_BEHAVIOR</code>,
<code class="constant">GL_DEBUG_TYPE_UNDEFINED_BEHAVIOR</code>, <code class="constant">GL_DEBUG_TYPE_PORTABILITY</code>,
- <code class="constant">GL_DEBUG_TYPE_PERFORMANCE</code>, <code class="constant">GL_DEBUG_TYPE_MARKER</code>, <code class="constant">GL_DEBUG_TYPE_PUSH_GROUP</code>,
- <code class="constant">GL_DEBUG_TYPE_POP_GROUP</code>, or <code class="constant">GL_DEBUG_TYPE_OTHER</code> to indicate the type of messages describing
- GL errors, attempted use of deprecated features, triggering of undefined behavior, portability issues, performance notifications, markers,
- group push and pop events, and other
- types of messages, respectively. It may also take the value <code class="constant">GL_DONT_CARE</code>. If <em class="parameter"><code>type</code></em> is not <code class="constant">GL_DONT_CARE</code>
+ <code class="constant">GL_DEBUG_TYPE_PERFORMANCE</code>, <code class="constant">GL_DEBUG_TYPE_OTHER</code> to indicate the type of messages describing
+ GL errors, attempted use of deprecated features, triggering of undefined behavior, portability issues, performance notifications and other
+ types of messages. It may also take the value <code class="constant">GL_DONT_CARE</code>. If <em class="parameter"><code>type</code></em> is not <code class="constant">GL_DONT_CARE</code>
then only messages whose type matches <em class="parameter"><code>type</code></em> will be referenced.
</p><p>
<em class="parameter"><code>severity</code></em> may be one of <code class="constant">GL_DEBUG_SEVERITY_LOW</code>, <code class="constant">GL_DEBUG_SEVERITY_MEDIUM</code>,
- or <code class="constant">GL_DEBUG_SEVERITY_HIGH</code> to select messages of low, medium or high severity messages or to
- <code class="constant">GL_DEBUG_SEVERITY_NOTIFICATION</code> for notifications. It may also take the
+ or <code class="constant">GL_DEBUG_SEVERITY_HIGH</code> to select messages of low, medium or high severity messages. It may also take the
value <code class="constant">GL_DONT_CARE</code>. If <em class="parameter"><code>severity</code></em> is not <code class="constant">GL_DONT_CARE</code> then only
messages whose severity matches <em class="parameter"><code>severity</code></em> will be referenced.
</p><p>
Although debug messages may be enabled in a non-debug context, the quantity and detail of such messages may be substantially
inferior to those in a debug context. In particular, a valid implementation of the debug message queue in a non-debug context
may produce no messages at all.
- </p><p>
- <code class="constant">GL_DEBUG_TYPE_MARKER</code>, <code class="constant">GL_DEBUG_TYPE_PUSH_GROUP</code>, <code class="constant">GL_DEBUG_TYPE_POP_GROUP</code>, and <code class="constant">GL_DEBUG_SEVERITY_NOTIFICATION</code>
- are available only if the GL version is 4.3 or higher.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>count</code></em> is negative.
</p><p>
use by the GL implementation. <em class="parameter"><code>type</code></em> indicates the type of the message
to be inserted and may be one of <code class="constant">GL_DEBUG_TYPE_ERROR</code>, <code class="constant">GL_DEBUG_TYPE_DEPRECATED_BEHAVIOR</code>,
<code class="constant">GL_DEBUG_TYPE_UNDEFINED_BEHAVIOR</code>, <code class="constant">GL_DEBUG_TYPE_PORTABILITY</code>,
- <code class="constant">GL_DEBUG_TYPE_PERFORMANCE</code>, <code class="constant">GL_DEBUG_TYPE_MARKER</code>, <code class="constant">GL_DEBUG_TYPE_PUSH_GROUP</code>, <code class="constant">GL_DEBUG_TYPE_POP_GROUP</code>, or <code class="constant">GL_DEBUG_TYPE_OTHER</code>.
+ <code class="constant">GL_DEBUG_TYPE_PERFORMANCE</code>, or <code class="constant">GL_DEBUG_TYPE_OTHER</code>.
<em class="parameter"><code>severity</code></em> indicates the severity of the message and may be <code class="constant">GL_DEBUG_SEVERITY_LOW</code>,
- <code class="constant">GL_DEBUG_SEVERITY_MEDIUM</code>, <code class="constant">GL_DEBUG_SEVERITY_HIGH</code> or <code class="constant">GL_DEBUG_SEVERITY_NOTIFICATION</code>.
+ <code class="constant">GL_DEBUG_SEVERITY_MEDIUM</code>, or <code class="constant">GL_DEBUG_SEVERITY_HIGH</code>.
<em class="parameter"><code>id</code></em> is available for application defined use and may be any value. This value
will be recorded and used to identify the message.
</p><p>
is negative then <em class="parameter"><code>message</code></em> is treated as a null-terminated string.
The length of the message, whether specified explicitly or implicitly, must be less than
or equal to the implementation defined constant <code class="constant">GL_MAX_DEBUG_MESSAGE_LENGTH</code>.
- </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
- <code class="constant">GL_DEBUG_TYPE_MARKER</code>, <code class="constant">GL_DEBUG_TYPE_PUSH_GROUP</code>, <code class="constant">GL_DEBUG_TYPE_POP_GROUP</code>, and <code class="constant">GL_DEBUG_SEVERITY_NOTIFICATION</code>
- are available only if the GL version is 4.3 or higher.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if any of <em class="parameter"><code>source</code></em>, <em class="parameter"><code>type</code></em>
or <em class="parameter"><code>severity</code></em> is not one of the accepted interface types.
<?xml-stylesheet type="text/xsl" href="mathml.xsl"?>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
-<meta http-equiv="Refresh" content="0;URL=../../man4/xhtml/glEnableVertexAttribArray.xml" />
+<meta http-equiv="Refresh" content="0;URL=../../man3/xhtml/glDisableVertexAttribArray.xml" />
<title>glDisableVertexAttribArray</title>
</head>
<body>
tokens.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if the GL is bound
to a framebuffer object and one or more of the values in <em class="parameter"><code>bufs</code></em>
is anything other than <code class="constant">GL_NONE</code> or one of the
- <code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>n</em></span></code> tokens.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if
+ <code class="constant">GL_COLOR_ATTACHMENT
S<span class="emphasis"><em>n</em></span></code> tokens.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if
<em class="parameter"><code>n</code></em> is less than 0.</p><p><code class="constant">GL_INVALID_OPERATION</code> is generated if a
symbolic constant other than <code class="constant">GL_NONE</code>
appears more than once in <em class="parameter"><code>bufs</code></em>.</p><p><code class="constant">GL_INVALID_OPERATION</code> is generated if any of
<?xml-stylesheet type="text/xsl" href="mathml.xsl"?>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
-<meta http-equiv="Refresh" content="0;URL=../../man4/xhtml/glBeginConditionalRender.xml" />
+<meta http-equiv="Refresh" content="0;URL=../../man3/xhtml/glEndConditionalRender.xml" />
<title>glEndConditionalRender</title>
</head>
<body>
<?xml-stylesheet type="text/xsl" href="mathml.xsl"?>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
-<meta http-equiv="Refresh" content="0;URL=../../man4/xhtml/glBeginQuery.xml" />
+<meta http-equiv="Refresh" content="0;URL=../../man3/xhtml/glEndQuery.xml" />
<title>glEndQuery</title>
</head>
<body>
<?xml-stylesheet type="text/xsl" href="mathml.xsl"?>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
-<meta http-equiv="Refresh" content="0;URL=../../man4/xhtml/glBeginTransformFeedback.xml" />
+<meta http-equiv="Refresh" content="0;URL=../../man3/xhtml/glEndTransformFeedback.xml" />
<title>glEndTransformFeedback</title>
</head>
<body>
Specifies the length of the buffer subrange, in basic machine units.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glFlushMappedBufferRange</code> indicates that modifications have been made to a range of a mapped buffer.
- The buffer must previously have been mapped with the <code class="constant">GL_MAP_FLUSH_EXPLICIT_BIT</code> flag. <em class="parameter"><code>offset</code></em>
+ The buffer must previously have been mapped with the <code class="constant">GL_MAP_FLUSH_EXPLICIT</code> flag. <em class="parameter"><code>offset</code></em>
and <em class="parameter"><code>length</code></em> indicate the modified subrange of the mapping, in basic units. The specified subrange to flush
is relative to the start of the currently mapped range of the buffer. <code class="function">glFlushMappedBufferRange</code> may be called
multiple times to indicate distinct subranges of the mapping which require flushing.
<code class="constant">GL_INVALID_OPERATION</code> is generated if zero is bound to <em class="parameter"><code>target</code></em>.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if the buffer bound to <em class="parameter"><code>target</code></em> is not
- mapped, or is mapped without the <code class="constant">GL_MAP_FLUSH_EXPLICIT_BIT</code> flag.
+ mapped, or is mapped without the <code class="constant">GL_MAP_FLUSH_EXPLICIT</code> flag.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<a href="glMapBufferRange.xml"><span class="citerefentry"><span class="refentrytitle">glMapBufferRange</span></span></a>,
<a href="glMapBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glMapBuffer</span></span></a>,
</p></dd><dt><span class="term"><em class="parameter"><code>attachment</code></em></span></dt><dd><p>
Specifies the attachment point of the framebuffer. <em class="parameter"><code>attachment</code></em> must be
<code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>i</em></span></code>, <code class="constant">GL_DEPTH_ATTACHMENT</code>,
- <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMENT</code>.
+ <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMMENT</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>textarget</code></em></span></dt><dd><p>
For <code class="function">glFramebufferTexture1D</code>, <code class="function">glFramebufferTexture2D</code> and
<code class="function">glFramebufferTexture3D</code>, specifies what type of texture is expected
</p><p>
<em class="parameter"><code>attachment</code></em> specifies the logical attachment of the framebuffer and must be
<code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>i</em></span></code>, <code class="constant">GL_DEPTH_ATTACHMENT</code>,
- <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMENT</code>.
+ <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMMENT</code>.
<span class="emphasis"><em>i</em></span> in <code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>i</em></span></code> may range from zero to
the value of <code class="constant">GL_MAX_COLOR_ATTACHMENTS</code> - 1. Attaching a level of a texture to
<code class="constant">GL_DEPTH_STENCIL_ATTACHMENT</code> is equivalent to attaching that level to both the
</p></dd><dt><span class="term"><em class="parameter"><code>attachment</code></em></span></dt><dd><p>
Specifies the attachment point of the framebuffer. <em class="parameter"><code>attachment</code></em> must be
<code class="constant">GL_COLOR_ATTACHMENT<span class="emphasis"><em>i</em></span></code>, <code class="constant">GL_DEPTH_ATTACHMENT</code>,
- <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMENT</code>.
+ <code class="constant">GL_STENCIL_ATTACHMENT</code> or <code class="constant">GL_DEPTH_STENCIL_ATTACHMMENT</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>texture</code></em></span></dt><dd><p>
Specifies the texture object to attach to the framebuffer attachment point named by <em class="parameter"><code>attachment</code></em>.
</p></dd><dt><span class="term"><em class="parameter"><code>level</code></em></span></dt><dd><p>
selection is always taken from the last vertex in the primitive.
If the value returned is equivalent to <code class="constant">GL_UNDEFINED_VERTEX</code>, then the
selection is not guaranteed to be taken from any specific vertex in the primitive.
+ </p></dd><dt><span class="term"><code class="constant">GL_LINE_WIDTH_GRANULARITY</code></span></dt><dd><p>
+ </p><p>
+ <em class="parameter"><code>params</code></em> returns one value,
+ the width difference between adjacent supported widths for antialiased lines.
+ See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>.
+ </p></dd><dt><span class="term"><code class="constant">GL_LINE_WIDTH_RANGE</code></span></dt><dd><p>
+ </p><p>
+ <em class="parameter"><code>params</code></em> returns two values:
+ the smallest and largest supported widths for antialiased
+ lines.
+ See <a href="glLineWidth.xml"><span class="citerefentry"><span class="refentrytitle">glLineWidth</span></span></a>.
</p></dd><dt><span class="term"><code class="constant">GL_LOGIC_OP_MODE</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns one value,
of simultaneous outputs that may be written in a fragment shader.
The value must be at least 8.
See <a href="glDrawBuffers.xml"><span class="citerefentry"><span class="refentrytitle">glDrawBuffers</span></span></a>.
- </p></dd><dt><span class="term"><code class="constant">GL_MAX_DUAL
_SOURCE_DRAW_BUFFERS</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="constant">GL_MAX_DUALSOURCE_DRAW_BUFFERS</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns one value, the maximum number
of active draw buffers when using dual-source blending. The value must be at least 1.
<em class="parameter"><code>params</code></em> returns one value.
The value gives a rough estimate of the largest rectangular texture that
the GL can handle. The value must be at least 1024.
- Use <code class="constant">GL_PROXY_TEXTURE_RECTANGLE</code>
+ Use <code class="constant">GL_PROXY_RECTANGLE_TEXTURE</code>
to determine if a texture is too large.
See <a href="glTexImage2D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2D</span></span></a>.
</p></dd><dt><span class="term"><code class="constant">GL_MAX_RENDERBUFFER_SIZE</code></span></dt><dd><p>
<em class="parameter"><code>params</code></em> a single value, the name of the currently bound program pipeline
object, or zero if no program pipeline object is bound.
See <a href="glBindProgramPipeline.xml"><span class="citerefentry"><span class="refentrytitle">glBindProgramPipeline</span></span></a>.
- </p></dd><dt><span class="term"><code class="constant">GL_PROGRAM_POINT_SIZE</code></span></dt><dd><p>
- </p><p>
- <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether vertex
- program point size mode is enabled. If enabled, then the
- point size is taken from the shader built-in <code class="code">gl_PointSize</code>. If disabled,
- then the point size is taken from the point state as specified
- by <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>.
- The initial value is <code class="constant">GL_FALSE</code>.
</p></dd><dt><span class="term"><code class="constant">GL_PROVOKING_VERTEX</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns one value,
</p><p>
<em class="parameter"><code>params</code></em> returns a single value indicating the mode of the texture
compression hint. The initial value is <code class="constant">GL_DONT_CARE</code>.
- </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_B
INDING_BUFFER</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_B
UFFER_BINDING</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns a single value, the name of the buffer object
currently bound to the <code class="constant">GL_TEXTURE_BUFFER</code> buffer binding point. The initial value is 0.
two-byte and four-byte pixel indices and components are swapped after being
read from memory. The initial value is <code class="constant">GL_FALSE</code>.
See <a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>.
+ </p></dd><dt><span class="term"><code class="constant">GL_VERTEX_PROGRAM_POINT_SIZE</code></span></dt><dd><p>
+ </p><p>
+ <em class="parameter"><code>params</code></em> returns a single boolean value indicating whether vertex
+ program point size mode is enabled. If enabled, and a vertex shader is active, then the
+ point size is taken from the shader built-in <code class="code">gl_PointSize</code>. If disabled,
+ and a vertex shader is active, then the point size is taken from the point state as specified
+ by <a href="glPointSize.xml"><span class="citerefentry"><span class="refentrytitle">glPointSize</span></span></a>.
+ The initial value is <code class="constant">GL_FALSE</code>.
</p></dd><dt><span class="term"><code class="constant">GL_VERTEX_BINDING_DIVISOR</code></span></dt><dd><p>
</p><p>
Accepted by the indexed forms. <em class="parameter"><code>params</code></em> returns a single integer value representing the instance step
<code class="constant">GL_INT_VEC2</code>,
<code class="constant">GL_INT_VEC3</code>,
<code class="constant">GL_INT_VEC4</code>,
- <code class="constant">GL_UNSIGNED_INT</code>,
+ <code class="constant">GL_UNSIGNED_INT_VEC</code>,
<code class="constant">GL_UNSIGNED_INT_VEC2</code>,
<code class="constant">GL_UNSIGNED_INT_VEC3</code>,
<code class="constant">GL_UNSIGNED_INT_VEC4</code>,
<em class="parameter"><code>bufSize</code></em> is less than 0.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p><a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
with argument <code class="constant">GL_MAX_VERTEX_UNIFORM_COMPONENTS</code>,
<code class="constant">GL_MAX_GEOMETRY_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_TESS_CONTROL_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_TESS_EVALUATION_UNIFORM_COMPONENTS</code>,
- <code class="constant">GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</code>.</p><p><a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
+ <code class="constant">GL_MAX_FRAGMENT_UNIFORM_COMPONENTS</code>, or
+ <code class="constant">GL_MAX_COMBINED_UNIFORM_COMPONENTS</code>.</p><p><a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
with argument <code class="constant">GL_ACTIVE_UNIFORMS</code> or
<code class="constant">GL_ACTIVE_UNIFORM_MAX_LENGTH</code>.</p><p><a href="glIsProgram.xml"><span class="citerefentry"><span class="refentrytitle">glIsProgram</span></span></a></p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p><a href="glGetUniform.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniform</span></span></a>,
<a href="glGetUniformLocation.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformLocation</span></span></a>,
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetActiveUniformBlock - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetActiveUniformBlock"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetActiveUniformBlock — query information about an active uniform block</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetActiveUniformBlockiv</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">uniformBlockIndex</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint
* </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetActiveUniformBlock - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetActiveUniformBlock"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetActiveUniformBlock — query information about an active uniform block</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetActiveUniformBlockiv</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">uniformBlockIndex</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">pname</var>, </td></tr><tr><td> </td><td>GLint </td><td><var class="pdparam">params</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
Specifies the name of a program containing the uniform block.
</p></dd><dt><span class="term"><em class="parameter"><code>uniformBlockIndex</code></em></span></dt><dd><p>
Specifies the index of the uniform block within <em class="parameter"><code>program</code></em>.
<a href="glGetUniformBlockIndex.xml"><span class="citerefentry"><span class="refentrytitle">glGetUniformBlockIndex</span></span></a>,
<a href="glLinkProgram.xml"><span class="citerefentry"><span class="refentrytitle">glLinkProgram</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
<a href="glUnmapBuffer.xml"><span class="citerefentry"><span class="refentrytitle">glUnmapBuffer</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 2005 Addison-Wesley.
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
</p></dd><dt><span class="term"><em class="parameter"><code>params</code></em></span></dt><dd><p>
Specifies the address of a variable receive the value of <em class="parameter"><code>pname</code></em> for <em class="parameter"><code>attachment</code></em>.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
- <code class="function">glGetFramebufferAttachmentParameteriv</code> returns information about attachments of a bound framebuffer
+ <code class="function">glGetFramebufferAttachmentParameter</code> returns information about attachments of a bound framebuffer
object. <em class="parameter"><code>target</code></em> specifies the framebuffer binding point and must be <code class="constant">GL_DRAW_FRAMEBUFFER</code>,
<code class="constant">GL_READ_FRAMEBUFFER</code> or <code class="constant">GL_FRAMEBUFFER</code>. <code class="constant">GL_FRAMEBUFFER</code> is equivalent
to <code class="constant">GL_DRAW_FRAMEBUFFER</code>.
<a href="glGenFramebuffers.xml"><span class="citerefentry"><span class="refentrytitle">glGenFramebuffers</span></span></a>,
<a href="glBindFramebuffer.xml"><span class="citerefentry"><span class="refentrytitle">glBindFramebuffer</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
<code class="constant">GL_TEXTURE_HEIGHT</code>,
<code class="constant">GL_TEXTURE_DEPTH</code>,
<code class="constant">GL_TEXTURE_INTERNAL_FORMAT</code>,
+ <code class="constant">GL_TEXTURE_BORDER</code>,
<code class="constant">GL_TEXTURE_RED_SIZE</code>,
<code class="constant">GL_TEXTURE_GREEN_SIZE</code>,
<code class="constant">GL_TEXTURE_BLUE_SIZE</code>,
<code class="constant">GL_MAX_TEXTURE_SIZE</code>, and <code class="constant">GL_MAX_3D_TEXTURE_SIZE</code> are not really
descriptive enough.
It has to report the largest square texture image that can be
- accommodated with mipmaps
- but a long skinny texture, or a texture without mipmaps may
+ 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.
</p><p>
<em class="parameter"><code>params</code></em> returns a single value,
the width of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_HEIGHT</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns a single value,
the height of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_DEPTH</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns a single value,
the depth of the texture image.
- The initial value is 0.
+ This value includes the border of the texture image. The initial value is
+ 0.
</p></dd><dt><span class="term"><code class="constant">GL_TEXTURE_INTERNAL_FORMAT</code></span></dt><dd><p>
</p><p>
<em class="parameter"><code>params</code></em> returns a single value,
<a href="glTexParameter.xml"><span class="citerefentry"><span class="refentrytitle">glTexParameter</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006
- Silicon Graphics, Inc. Copyright <span class="trademark"></span>© 2010-2013
+ Silicon Graphics, Inc. Copyright <span class="trademark"></span>© 2010-2012
Khronos Group. This document is licensed under the SGI
Free Software B License. For details, see
<a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetTransformFeedbackVarying - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetTransformFeedbackVarying"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetTransformFeedbackVarying — retrieve information about varying variables selected for transform feedback</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetTransformFeedbackVarying</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">bufSize</var>, </td></tr><tr><td> </td><td>GLsizei * </td><td><var class="pdparam">length</var>, </td></tr><tr><td> </td><td>GLsizei
* </td><td><var class="pdparam">size</var>, </td></tr><tr><td> </td><td>GLenum * </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>char * </td><td><var class="pdparam">name</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glGetTransformFeedbackVarying - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glGetTransformFeedbackVarying"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glGetTransformFeedbackVarying — retrieve information about varying variables selected for transform feedback</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glGetTransformFeedbackVarying</b>(</code></td><td>GLuint </td><td><var class="pdparam">program</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">bufSize</var>, </td></tr><tr><td> </td><td>GLsizei * </td><td><var class="pdparam">length</var>, </td></tr><tr><td> </td><td>GLsizei </td><td><var class="pdparam">size</var>, </td></tr><tr><td> </td><td>GLenum * </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>char * </td><td><var class="pdparam">name</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>program</code></em></span></dt><dd><p>
The name of the target program object.
</p></dd><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>
The index of the varying variable whose information to retrieve.
variable selected by <em class="parameter"><code>index</code></em>. An <em class="parameter"><code>index</code></em> of 0 selects
the first varying variable specified in the <em class="parameter"><code>varyings</code></em> array passed
to <a href="glTransformFeedbackVaryings.xml"><span class="citerefentry"><span class="refentrytitle">glTransformFeedbackVaryings</span></span></a>, and
- an <em class="parameter"><code>index</code></em> of <code class="constant">GL_TRANSFORM_FEEDBACK_VARYINGS</code> - 1 selects
+ an <em class="parameter"><code>index</code></em> of <code class="constant">GL_TRANSFORM_FEEDBACK_VARYINGS-1</code> selects
the last such variable.
</p><p>
The name of the selected varying is returned as a null-terminated string in
<a href="glTransformFeedbackVaryings.xml"><span class="citerefentry"><span class="refentrytitle">glTransformFeedbackVaryings</span></span></a>,
<a href="glGetProgram.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgram</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
</td><td align="left">
<a href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a>, <a href="glStencilOp.xml"><span class="citerefentry"><span class="refentrytitle">glStencilOp</span></span></a>
</td></tr><tr><td align="left">
- <code class="constant">GL_TEXTURE_CUBE_MAP_SEAMLESS</code>
+ <code class="constant">GL_TEXTURE_CUBEMAP_SEAMLESS</code>
</td><td align="left">
<a href="glEnable.xml"><span class="citerefentry"><span class="refentrytitle">glEnable</span></span></a>
</td></tr></tbody></table></div><p>
<a href="glTransformFeedbackVaryings.xml"><span class="citerefentry"><span class="refentrytitle">glTransformFeedbackVaryings</span></span></a>
specify the same varying variable.</p></li><li><p>The total number of components to capture in any transform feedback varying variable
is greater than the constant <code class="constant">GL_MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS</code>
- and the buffer mode is <code class="constant">
GL_SEPARATE_ATTRIBS</code>.</p></li></ul></div><p>When a program object has been successfully linked, the
+ and the buffer mode is <code class="constant">SEPARATE_ATTRIBS</code>.</p></li></ul></div><p>When a program object has been successfully linked, the
program object can be made part of current state by calling
<a href="glUseProgram.xml"><span class="citerefentry"><span class="refentrytitle">glUseProgram</span></span></a>.
Whether or not the link operation was successful, the program
<a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_SIZE_GRANULARITY</code>
</p><p>
<a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_SIZE</code>
+ </p><p>
+ <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_SIZE_MIN</code>
+ </p><p>
+ <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_SIZE_MAX</code>
</p><p>
<a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_POINT_FADE_THRESHOLD_SIZE</code>
</p><p>
accepted values are:
</p><div class="variablelist"><dl><dt><span class="term"><code class="constant">GL_STENCIL_INDEX</code></span></dt><dd><p>
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 <code class="constant">GL_INDEX_SHIFT</code>,
+ and added to <code class="constant">GL_INDEX_OFFSET</code>.
+ If <code class="constant">GL_MAP_STENCIL</code> is <code class="constant">GL_TRUE</code>,
+ indices are replaced by their mappings in the table <code class="constant">GL_PIXEL_MAP_S_TO_S</code>.
</p></dd><dt><span class="term"><code class="constant">GL_DEPTH_COMPONENT</code></span></dt><dd><p>
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 clamped to the range
+ Each component is then multiplied by <code class="constant">GL_DEPTH_SCALE</code>,
+ added to <code class="constant">GL_DEPTH_BIAS</code>,
+ and finally clamped to the range
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mfenced open="[" close="]">
is non-zero, the read framebuffer is complete, and the value of <code class="constant">GL_SAMPLE_BUFFERS</code>
for the read framebuffer is greater than zero.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
+ <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_INDEX_MODE</code>
+ </p><p>
<a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_PIXEL_PACK_BUFFER_BINDING</code>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<a href="glPixelStore.xml"><span class="citerefentry"><span class="refentrytitle">glPixelStore</span></span></a>,
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
-<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexBuffer - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexBuffer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexBuffer — attach the storage for a buffer object to the active buffer texture</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexBuffer</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalFormat</var>, </td></tr><tr><td> </td><td>G
Luint </td><td><var class="pdparam">buffer</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
+<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glTexBuffer - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glTexBuffer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glTexBuffer — attach the storage for a buffer object to the active buffer texture</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glTexBuffer</b>(</code></td><td>GLenum </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">internalFormat</var>, </td></tr><tr><td> </td><td>G
luint </td><td><var class="pdparam">buffer</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
Specifies the target of the operation and must be <code class="constant">GL_TEXTURE_BUFFER</code>.
</p></dd><dt><span class="term"><em class="parameter"><code>internalFormat</code></em></span></dt><dd><p>
Specifies the internal format of the data in the store belonging to <em class="parameter"><code>buffer</code></em>.
<a href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>,
<a href="glDeleteTextures.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteTextures</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RG</code></span></dt><dd><p>
Each element is a single red/green double
The GL converts it to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGB</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGR</code></span></dt><dd><p>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGBA</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGRA</code></span></dt><dd><p>
Each element contains all four components.
- Each component clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_DEPTH_COMPONENT</code></span></dt><dd><p>
Each element is a single depth value.
- The GL converts it to floating point and clamps to the range [0,1].
+ The GL converts it to floating point, multiplies by the signed scale factor
+ <code class="constant">GL_DEPTH_SCALE</code>, adds the signed bias <code class="constant">GL_DEPTH_BIAS</code>,
+ and clamps to the range [0,1].
</p></dd></dl></div><p>
If an application wants to store the texture at a certain
resolution or in a certain format, it can request the resolution
<em class="parameter"><code>internalFormat</code></em> may be one of the base internal formats shown in
Table 1, below
</p><p>
- </p><div class="table"><a id="id48
79508"></a><p class="title"><b>Table 1. Base Internal Formats</b></p><table summary="Base Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ </p><div class="table"><a id="id48
69699"></a><p class="title"><b>Table 1. Base Internal Formats</b></p><table summary="Base Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
Base Internal Format
</strong></span></th><th align="left"><span class="bold"><strong>
RGBA, Depth and Stencil Values
<em class="parameter"><code>internalFormat</code></em> may also be one of the sized internal formats
shown in Table 2, below
</p><p>
- </p><div class="table"><a id="id48
75278"></a><p class="title"><b>Table 2. Sized Internal Formats</b></p><table summary="Sized Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ </p><div class="table"><a id="id48
56514"></a><p class="title"><b>Table 2. Sized Internal Formats</b></p><table summary="Sized Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
Sized Internal Format
</strong></span></th><th align="left"><span class="bold"><strong>
Base Internal Format
Finally, <em class="parameter"><code>internalFormat</code></em> may also be one of the generic or compressed
compressed texture formats shown in Table 3 below
</p><p>
- </p><div class="table"><a id="id48
67162"></a><p class="title"><b>Table 3. Compressed Internal Formats</b></p><table summary="Compressed Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ </p><div class="table"><a id="id48
76999"></a><p class="title"><b>Table 3. Compressed Internal Formats</b></p><table summary="Compressed Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
Compressed Internal Format
</strong></span></th><th align="left"><span class="bold"><strong>
Base Internal Format
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em> is less than 0
or greater than <code class="constant">GL_MAX_TEXTURE_SIZE</code>.
</p><p>
- <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0.
+ <code class="constant">GL_INVALID_VALUE</code> is generated if non-power-of-two textures are not supported and the <em class="parameter"><code>width</code></em> cannot be represented as
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">n</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some integer value of <span class="emphasis"><em>n</em></span>.
+ </p><p>
+ <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0 or 1.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if <em class="parameter"><code>type</code></em> is one of
<code class="constant">GL_UNSIGNED_BYTE_3_3_2</code>,
<a href="glTexParameter.xml"><span class="citerefentry"><span class="refentrytitle">glTexParameter</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006 Silicon Graphics, Inc.
- Copyright <span class="trademark"></span>© 2011-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2011 Khronos Group.
This document is licensed under the SGI
Free Software B License. For details, see
<a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RG</code></span></dt><dd><p>
Each element is a red/green double.
The GL converts it to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGB</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGR</code></span></dt><dd><p>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGBA</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGRA</code></span></dt><dd><p>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_DEPTH_COMPONENT</code></span></dt><dd><p>
Each element is a single depth value.
- The GL converts it to floating point and clamps to the range [0,1].
+ The GL converts it to floating point, multiplies by the signed scale factor
+ <code class="constant">GL_DEPTH_SCALE</code>, adds the signed bias <code class="constant">GL_DEPTH_BIAS</code>,
+ and clamps to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_DEPTH_STENCIL</code></span></dt><dd><p>
Each element is a pair of depth and stencil values. The depth component of
the pair is interpreted as in <code class="constant">GL_DEPTH_COMPONENT</code>. The stencil
<em class="parameter"><code>internalFormat</code></em> may be one of the base internal formats shown in
Table 1, below
</p><p>
- </p><div class="table"><a id="id4865
593"></a><p class="title"><b>Table 1. Base Internal Formats</b></p><table summary="Base Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ </p><div class="table"><a id="id4865
719"></a><p class="title"><b>Table 1. Base Internal Formats</b></p><table summary="Base Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
Base Internal Format
</strong></span></th><th align="left"><span class="bold"><strong>
RGBA, Depth and Stencil Values
<em class="parameter"><code>internalFormat</code></em> may also be one of the sized internal formats
shown in Table 2, below
</p><p>
- </p><div class="table"><a id="id48
37909"></a><p class="title"><b>Table 2. Sized Internal Formats</b></p><table summary="Sized Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ </p><div class="table"><a id="id48
40913"></a><p class="title"><b>Table 2. Sized Internal Formats</b></p><table summary="Sized Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
Sized Internal Format
</strong></span></th><th align="left"><span class="bold"><strong>
Base Internal Format
Finally, <em class="parameter"><code>internalFormat</code></em> may also be one of the generic or compressed
compressed texture formats shown in Table 3 below
</p><p>
- </p><div class="table"><a id="id48
57450"></a><p class="title"><b>Table 3. Compressed Internal Formats</b></p><table summary="Compressed Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ </p><div class="table"><a id="id48
65100"></a><p class="title"><b>Table 3. Compressed Internal Formats</b></p><table summary="Compressed Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
Compressed Internal Format
</strong></span></th><th align="left"><span class="bold"><strong>
Base Internal Format
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em> or <em class="parameter"><code>height</code></em> is less than 0
or greater than <code class="constant">GL_MAX_TEXTURE_SIZE</code>.
+ </p><p>
+ <code class="constant">GL_INVALID_VALUE</code> is generated if non-power-of-two textures are not supported and the <em class="parameter"><code>width</code></em> or <em class="parameter"><code>height</code></em> cannot be represented as
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">k</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some
+ integer value of <span class="emphasis"><em>k</em></span>.
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0.
</p><p>
<a href="glTexParameter.xml"><span class="citerefentry"><span class="refentrytitle">glTexParameter</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006 Silicon Graphics, Inc.
- Copyright <span class="trademark"></span>© 2011-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2011 Khronos Group.
This document is licensed under the SGI
Free Software B License. For details, see
<a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
<a href="glTexImage3D.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage3D</span></span></a>,
<a href="glTexImage2DMultisample.xml"><span class="citerefentry"><span class="refentrytitle">glTexImage2DMultisample</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2010-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2010 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RG</code></span></dt><dd><p>
Each element is a red and green pair.
The GL converts each to floating point and assembles it into an RGBA element
by attaching 0 for blue, and 1 for alpha.
- Each component is clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGB</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGR</code></span></dt><dd><p>
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 clamped to the range [0,1].
+ Each component is then multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd><dt><span class="term"><code class="constant">GL_RGBA</code></span></dt><dd></dd><dt><span class="term"><code class="constant">GL_BGRA</code></span></dt><dd><p>
Each element contains all four components.
- Each component is clamped to the range [0,1].
+ Each component is multiplied by the signed scale factor <code class="constant">GL_c_SCALE</code>,
+ added to the signed bias <code class="constant">GL_c_BIAS</code>,
+ and clamped to the range [0,1].
</p></dd></dl></div><p>
If an application wants to store the texture at a certain
resolution or in a certain format, it can request the resolution
<em class="parameter"><code>internalFormat</code></em> may be one of the base internal formats shown in
Table 1, below
</p><p>
- </p><div class="table"><a id="id48
76051"></a><p class="title"><b>Table 1. Base Internal Formats</b></p><table summary="Base Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ </p><div class="table"><a id="id48
85343"></a><p class="title"><b>Table 1. Base Internal Formats</b></p><table summary="Base Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
Base Internal Format
</strong></span></th><th align="left"><span class="bold"><strong>
RGBA, Depth and Stencil Values
<em class="parameter"><code>internalFormat</code></em> may also be one of the sized internal formats
shown in Table 2, below
</p><p>
- </p><div class="table"><a id="id4
758319"></a><p class="title"><b>Table 2. Sized Internal Formats</b></p><table summary="Sized Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ </p><div class="table"><a id="id4
853651"></a><p class="title"><b>Table 2. Sized Internal Formats</b></p><table summary="Sized Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
Sized Internal Format
</strong></span></th><th align="left"><span class="bold"><strong>
Base Internal Format
Finally, <em class="parameter"><code>internalFormat</code></em> may also be one of the generic or compressed
compressed texture formats shown in Table 3 below
</p><p>
- </p><div class="table"><a id="id48
73158"></a><p class="title"><b>Table 3. Compressed Internal Formats</b></p><table summary="Compressed Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ </p><div class="table"><a id="id48
40264"></a><p class="title"><b>Table 3. Compressed Internal Formats</b></p><table summary="Compressed Internal Formats" border="1"><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
Compressed Internal Format
</strong></span></th><th align="left"><span class="bold"><strong>
Base Internal Format
</p><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>width</code></em>, <em class="parameter"><code>height</code></em>, or <em class="parameter"><code>depth</code></em> is less than 0 or greater than <code class="constant">GL_MAX_TEXTURE_SIZE</code>.
</p><p>
- <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0.
+ <code class="constant">GL_INVALID_VALUE</code> is generated if non-power-of-two textures are not supported and the <em class="parameter"><code>width</code></em>, <em class="parameter"><code>height</code></em>, or <em class="parameter"><code>depth</code></em> cannot be represented as
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
+
+ <mml:mrow>
+ <mml:msup><mml:mn>2</mml:mn>
+ <mml:mi mathvariant="italic">k</mml:mi>
+ </mml:msup>
+ <mml:mo>+</mml:mo>
+ <mml:mrow>
+ <mml:mn>2</mml:mn>
+ <mml:mo></mml:mo>
+ <mml:mfenced open="(" close=")">
+ <mml:mi mathvariant="italic">border</mml:mi>
+ </mml:mfenced>
+ </mml:mrow>
+ </mml:mrow>
+ </mml:math>
+ for some
+ integer value of <span class="emphasis"><em>k</em></span>.
+ </p><p>
+ <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>border</code></em> is not 0 or 1.
</p><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if <em class="parameter"><code>type</code></em> is one of
<code class="constant">GL_UNSIGNED_BYTE_3_3_2</code>,
<a href="glTexParameter.xml"><span class="citerefentry"><span class="refentrytitle">glTexParameter</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 1991-2006 Silicon Graphics, Inc.
- Copyright <span class="trademark"></span>© 2011-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2011 Khronos Group.
This document is licensed under the SGI
Free Software B License. For details, see
<a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
<?xml-stylesheet type="text/xsl" href="mathml.xsl"?>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
-<meta http-equiv="Refresh" content="0;URL=../../man4/xhtml/glMapBuffer.xml" />
+<meta http-equiv="Refresh" content="0;URL=../../man3/xhtml/glUnmapBuffer.xml" />
<title>glUnmapBuffer</title>
</head>
<body>
attribute to be modified.</p></dd><dt><span class="term"><em class="parameter"><code>v</code></em></span></dt><dd><p>Specifies a pointer to an array of values to
be used for the generic vertex attribute.</p></dd></dl></div></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribP1ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLboolean </td><td><var class="pdparam">normalized</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">value</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribP2ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLboolean </td><td><var class="pdparam">normalized</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">value</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribP3ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLboolean </td><td><var class="pdparam">normalized</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">value</var><code>)</code>;</td></tr></table><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glVertexAttribP4ui</b>(</code></td><td>GLuint </td><td><var class="pdparam">index</var>, </td></tr><tr><td> </td><td>GLenum </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>GLboolean </td><td><var class="pdparam">normalized</var>, </td></tr><tr><td> </td><td>GLuint </td><td><var class="pdparam">value</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters3"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>Specifies the index of the generic vertex
attribute to be modified.</p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>Type of packing used on the data. This parameter must be
- <code class="constant">GL_INT_2_10_10_10_REV</code> or <code class="constant">GL_UNSIGNED_INT_2_10_10_10_REV</code>
+ <code class="constant">GL_INT_10_10_10_2</code> or <code class="constant">GL_UNSIGNED_INT_10_10_10_2</code>
to specify signed or unsigned data, respectively.</p></dd><dt><span class="term"><em class="parameter"><code>normalized</code></em></span></dt><dd><p>If <code class="constant">GL_TRUE</code>, then the values are to be
converted to floating point values by normalizing. Otherwise,
they are converted directly to floating point values.</p></dd><dt><span class="term">
<code class="constant">GL_MAX_VERTEX_ATTRIBS</code>.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if
<code class="function">glVertexAttribP</code> is used with a
<em class="parameter"><code>type</code></em> other than
- <code class="constant">GL_INT_2_10_10_10_REV</code> or
- <code class="constant">GL_UNSIGNED_INT_
2_10_10_10_REV</code>.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if
+ <code class="constant">GL_INT_10_10_10_2</code> or
+ <code class="constant">GL_UNSIGNED_INT_
10_10_10_2</code>.</p><p><code class="constant">GL_INVALID_ENUM</code> is generated if
<code class="function">glVertexAttribL</code> is used with a
<em class="parameter"><code>type</code></em> other than
<code class="constant">GL_DOUBLE</code>.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p><a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
once per <em class="parameter"><code>divisor</code></em> instances of the set(s) of vertices being rendered. An attribute
is referred to as instanced if its <code class="constant">GL_VERTEX_ATTRIB_ARRAY_DIVISOR</code> value is non-zero.
</p><p>
- <em class="parameter"><code>index</code></em> must be less than the value of <code class="constant">GL_MAX_VERTEX_ATTRIBS</code>.
+ <em class="parameter"><code>index</code></em> must be less than the value of <code class="constant">GL_MAX_VERTEX_ATTRIBUTES</code>.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
<code class="function">glVertexAttribDivisor</code> is available only if the GL version is 3.3 or higher.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>index</code></em> is greater
- than or equal to the value of <code class="constant">GL_MAX_VERTEX_ATTRIBS</code>.
+ than or equal to the value of <code class="constant">GL_MAX_VERTEX_ATTRIBUTES</code>.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<a href="glVertexAttribPointer.xml"><span class="citerefentry"><span class="refentrytitle">glVertexAttribPointer</span></span></a>,
<a href="glEnableVertexAttribArray.xml"><span class="citerefentry"><span class="refentrytitle">glEnableVertexAttribArray</span></span></a>,
<refmeta>\r
<refmetainfo>\r
<copyright>\r
- <year>2013</year>\r
+ <year>2011</year>\r
<holder>Khronos Group</holder>\r
</copyright>\r
</refmetainfo>\r
{\r
bool result = true;\r
int i;\r
- for (i = 0; i < x.length(); ++i)\r
+ for (i = 0; i < x.length(); ++x)\r
{\r
result &= x[i];\r
}\r
</refsect1>\r
<refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
- Copyright <trademark class="copyright"></trademark> 2011-2013 Khronos Group. \r
+ Copyright <trademark class="copyright"></trademark> 2011 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
<refmeta>\r
<refmetainfo>\r
<copyright>\r
- <year>2013</year>\r
+ <year>2011</year>\r
<holder>Khronos Group</holder>\r
</copyright>\r
</refmetainfo>\r
{\r
bool result = false;\r
int i;\r
- for (i = 0; i < x.length(); ++i)\r
+ for (i = 0; i < x.length(); ++x)\r
{\r
result |= x[i];\r
}\r
</refsect1>\r
<refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
- Copyright <trademark class="copyright"></trademark> 2011-2013 Khronos Group. \r
+ Copyright <trademark class="copyright"></trademark> 2011 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
<thead>\r
#FUNCTABLEHEADER#\r
<row>\r
- <entry>fma (genType)</entry>#newin40#\r
+ <entry>fma (genType)</entry>#newin11#\r
</row>\r
<row>\r
<entry>fma (genDType)</entry>#newin40#\r
</refsect1>\r
<refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
- Copyright <trademark class="copyright"></trademark> 2011-2013 Khronos Group. \r
+ Copyright <trademark class="copyright"></trademark> 2011 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
<refmeta>\r
<refmetainfo>\r
<copyright>\r
- <year>2013</year>\r
+ <year>2011</year>\r
<holder>Khronos Group</holder>\r
</copyright>\r
</refmetainfo>\r
</refsynopsisdiv>\r
<refsect1 id="description"><title>Description</title>\r
<para>\r
- In the vertex, tessellation evaluation and geometry languages, a single\r
+ In the vertex, tessellation evaluation and geoemtry languages, a single\r
global instance of the <function>gl_PerVertex</function> named block is available and\r
its <function>gl_PointSize</function> member is an output that receives the\r
intended size of the point to be rasterized, in pixels. It may be written at any time\r
(or hasn't written it at all).\r
</para>\r
<para>\r
- In the tessellation control, tessellation evaluation and geometry languages,\r
+ In the tessellation control, tessellation evaluation and geoemetry languages,\r
the <function>gl_PerVertex</function> named block is used to construct an array, <function>gl_in[]</function>\r
of per-vertex or per-control point inputs whose content represents the corresponding\r
outputs written by the previous stage.\r
<row>\r
<entry>gl_PointSize (geometry shader)</entry>#newin15#\r
</row>\r
- <row>\r
- <entry>gl_PointSize (tessellation evaluation shader)</entry>#newin40#\r
- </row>\r
</thead>\r
</tgroup>\r
</informaltable>\r
</refsect1>\r
<refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
- Copyright <trademark class="copyright"></trademark> 2011-2013 Khronos Group. \r
+ Copyright <trademark class="copyright"></trademark> 2011 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
</refsect1>\r
<refsect1 id="versions"><title>Version Support</title>\r
<informaltable frame="topbot">\r
- #VARTABLECOLS#\r
+ <tgroup cols="3" align="left">\r
+ <colspec colwidth="1.1*" />\r
+ <colspec colwidth="1*" align="center" />\r
+ <colspec colwidth="1*" align="center" />\r
+ <colspec colwidth="1*" align="center" />\r
+ <colspec colwidth="1*" align="center" />\r
+ <colspec colwidth="1*" align="center" />\r
+ <colspec colwidth="1*" align="center" />\r
+ <colspec colwidth="1*" align="center" />\r
+ <colspec colwidth="1*" align="center" />\r
<thead>\r
- #FUNCTABLEHEADER#\r
<row>\r
- <entry><function>gl_PrimitiveID</function> (Fragment and Geometry Languages)</entry>#newin15#\r
+ <entry rowsep="1" align="left"><emphasis role="bold">\r
+ Variable\r
+ </emphasis></entry>\r
+ <entry rowsep="1" align="left"><emphasis role="bold">\r
+ Version 1.10\r
+ </emphasis></entry>\r
+ <entry rowsep="1" align="left"><emphasis role="bold">\r
+ Version 1.20\r
+ </emphasis></entry>\r
+ <entry rowsep="1" align="left"><emphasis role="bold">\r
+ Version 1.30\r
+ </emphasis></entry>\r
+ <entry rowsep="1" align="left"><emphasis role="bold">\r
+ Version 1.40\r
+ </emphasis></entry>\r
+ <entry rowsep="1" align="left"><emphasis role="bold">\r
+ Version 1.50\r
+ </emphasis></entry>\r
+ <entry rowsep="1" align="left"><emphasis role="bold">\r
+ Version 3.30\r
+ </emphasis></entry>\r
+ <entry rowsep="1" align="left"><emphasis role="bold">\r
+ Version 4.00\r
+ </emphasis></entry>\r
+ <entry rowsep="1" align="left"><emphasis role="bold">\r
+ Version 4.10\r
+ </emphasis></entry>\r
</row>\r
<row>\r
- <entry><function>gl_PrimitiveID</function> (Tessellation Control and Evaluation Languages)</entry>#newin40#\r
+ <entry>\r
+ gl_PrimitiveID\r
+ </entry>\r
+ <entry>\r
+ <emphasis>Y</emphasis> <!-- 1.10, OpenGL 2.0 -->\r
+ </entry>\r
+ <entry>\r
+ <emphasis>Y</emphasis> <!-- 1.20, OpenGL 2.1 -->\r
+ </entry>\r
+ <entry>\r
+ <emphasis>Y</emphasis> <!-- 1.30, OpenGL 3.0 -->\r
+ </entry>\r
+ <entry>\r
+ <emphasis>Y</emphasis> <!-- 1.40, OpenGL 3.1 -->\r
+ </entry>\r
+ <entry>\r
+ <emphasis>Y</emphasis> <!-- 1.50, OpenGL 3.2 -->\r
+ </entry>\r
+ <entry>\r
+ <emphasis>Y</emphasis> <!-- 3.30, OpenGL 3.3 -->\r
+ </entry>\r
+ <entry>\r
+ <emphasis>Y</emphasis> <!-- 4.00, OpenGL 4.0 -->\r
+ </entry>\r
+ <entry>\r
+ <emphasis>Y</emphasis> <!-- 4.10, OpenGL 4.1 -->\r
+ </entry>\r
</row>\r
</thead>\r
</tgroup>\r
</refsect1>\r
<refsect1 id="description"><title>Description</title>\r
<para>\r
- <function>sign</function> returns -1.0 if <parameter>x</parameter> is less than 0.0, 0.0 if <parameter>x</parameter>\r
- is equal to 0.0, and +1.0 if <parameter>x</parameter> is greater than 0.0.\r
+ <function>abs</function> returns 1.0 if\r
+ <inlineequation><mml:math><mml:apply><mml:lt /><mml:mi>x</mml:mi><mml:mn>0.0</mml:mn></mml:apply></mml:math></inlineequation>,\r
+ 0.0 if\r
+ <inlineequation><mml:math><mml:apply><mml:eq /><mml:mi>x</mml:mi><mml:mn>0.0</mml:mn></mml:apply></mml:math></inlineequation> and\r
+ 1.0 if\r
+ <inlineequation><mml:math><mml:apply><mml:gt /><mml:mi>x</mml:mi><mml:mn>0.0</mml:mn></mml:apply></mml:math></inlineequation>.\r
</para>\r
</refsect1>\r
<refsect1 id="versions"><title>Version Support</title>\r
</refsect1>\r
<refsect1 id="seealso"><title>See Also</title>\r
<para>\r
- <citerefentry><refentrytitle>abs</refentrytitle></citerefentry>\r
+ <citerefentry><refentrytitle>sign</refentrytitle></citerefentry>\r
</para>\r
</refsect1>\r
<refsect1 id="Copyright"><title>Copyright</title>\r
<para>\r
- Copyright <trademark class="copyright"></trademark> 2011-2013 Khronos Group. \r
+ Copyright <trademark class="copyright"></trademark> 2011 Khronos Group. \r
This material may be distributed subject to the terms and conditions set forth in \r
the Open Publication License, v 1.0, 8 June 1999.\r
<ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.\r
{
bool result = true;
int i;
- for (i = 0; i < x.length(); ++i)
+ for (i = 0; i < x.length(); ++x)
{
result &= x[i];
}
<a href="any.xml"><span class="citerefentry"><span class="refentrytitle">any</span></span></a>,
<a href="not.xml"><span class="citerefentry"><span class="refentrytitle">not</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2011-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2011 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
{
bool result = false;
int i;
- for (i = 0; i < x.length(); ++i)
+ for (i = 0; i < x.length(); ++x)
{
result |= x[i];
}
<a href="all.xml"><span class="citerefentry"><span class="refentrytitle">all</span></span></a>,
<a href="not.xml"><span class="citerefentry"><span class="refentrytitle">not</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2011-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2011 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
Otherwise, in the absense of <code class="code">precise</code> consumption, there are no
special constraints on the number of operations or difference in precision between
<code class="function">fma</code>() and the expression <code class="code">a * b + c</code>.
- </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="versions"></a><h2>Version Support</h2><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>Function</strong></span></th><th align="left"><span class="bold"><strong>Version 1.10</strong></span></th><th align="left"><span class="bold"><strong>Version 1.20</strong></span></th><th align="left"><span class="bold"><strong>Version 1.30</strong></span></th><th align="left"><span class="bold"><strong>Version 1.40</strong></span></th><th align="left"><span class="bold"><strong>Version 1.50</strong></span></th><th align="left"><span class="bold"><strong>Version 3.30</strong></span></th><th align="left"><span class="bold"><strong>Version 4.00</strong></span></th><th align="left"><span class="bold"><strong>Version 4.10</strong></span></th><th align="left"><span class="bold"><strong>Version 4.20</strong></span></th><th align="center"><span class="bold"><strong>Version 4.30</strong></span></th></tr><tr><th align="left">fma (genType)</th><th align="center"><span class="emphasis"><em>
-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr><tr><th align="left">fma (genDType)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr></thead></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2011-2013 Khronos Group.
+ </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="versions"></a><h2>Version Support</h2><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>Function</strong></span></th><th align="left"><span class="bold"><strong>Version 1.10</strong></span></th><th align="left"><span class="bold"><strong>Version 1.20</strong></span></th><th align="left"><span class="bold"><strong>Version 1.30</strong></span></th><th align="left"><span class="bold"><strong>Version 1.40</strong></span></th><th align="left"><span class="bold"><strong>Version 1.50</strong></span></th><th align="left"><span class="bold"><strong>Version 3.30</strong></span></th><th align="left"><span class="bold"><strong>Version 4.00</strong></span></th><th align="left"><span class="bold"><strong>Version 4.10</strong></span></th><th align="left"><span class="bold"><strong>Version 4.20</strong></span></th><th align="center"><span class="bold"><strong>Version 4.30</strong></span></th></tr><tr><th align="left">fma (genType)</th><th align="center"><span class="emphasis"><em>
Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr><tr><th align="left">fma (genDType)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr></thead></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
+ Copyright <span class="trademark"></span>© 2011 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
float gl_PointSize;
float gl_ClipDistance[];
};</pre></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
- In the vertex, tessellation evaluation and geometry languages, a single
+ In the vertex, tessellation evaluation and geoemtry languages, a single
global instance of the <code class="function">gl_PerVertex</code> named block is available and
its <code class="function">gl_PointSize</code> member is an output that receives the
intended size of the point to be rasterized, in pixels. It may be written at any time
written <code class="function">gl_PointSize</code> since the last call to <a href="EmitVertex.xml"><span class="citerefentry"><span class="refentrytitle">EmitVertex</span></span></a>
(or hasn't written it at all).
</p><p>
- In the tessellation control, tessellation evaluation and geometry languages,
+ In the tessellation control, tessellation evaluation and geoemetry languages,
the <code class="function">gl_PerVertex</code> named block is used to construct an array, <code class="function">gl_in[]</code>
of per-vertex or per-control point inputs whose content represents the corresponding
outputs written by the previous stage.
- </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="versions"></a><h2>Version Support</h2><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>Variable</strong></span></th><th align="left"><span class="bold"><strong>Version 1.10</strong></span></th><th align="left"><span class="bold"><strong>Version 1.20</strong></span></th><th align="left"><span class="bold"><strong>Version 1.30</strong></span></th><th align="left"><span class="bold"><strong>Version 1.40</strong></span></th><th align="left"><span class="bold"><strong>Version 1.50</strong></span></th><th align="left"><span class="bold"><strong>Version 3.30</strong></span></th><th align="left"><span class="bold"><strong>Version 4.00</strong></span></th><th align="left"><span class="bold"><strong>Version 4.10</strong></span></th><th align="left"><span class="bold"><strong>Version 4.20</strong></span></th><th align="center"><span class="bold"><strong>Version 4.30</strong></span></th></tr><tr><th align="left">gl_PointSize (vertex shader)</th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr><tr><th align="left">gl_PointSize (geometry shader)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr><
tr><th align="left">gl_PointSize (tessellation evaluation shader)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr></thead></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
+ </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="versions"></a><h2>Version Support</h2><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>Variable</strong></span></th><th align="left"><span class="bold"><strong>Version 1.10</strong></span></th><th align="left"><span class="bold"><strong>Version 1.20</strong></span></th><th align="left"><span class="bold"><strong>Version 1.30</strong></span></th><th align="left"><span class="bold"><strong>Version 1.40</strong></span></th><th align="left"><span class="bold"><strong>Version 1.50</strong></span></th><th align="left"><span class="bold"><strong>Version 3.30</strong></span></th><th align="left"><span class="bold"><strong>Version 4.00</strong></span></th><th align="left"><span class="bold"><strong>Version 4.10</strong></span></th><th align="left"><span class="bold"><strong>Version 4.20</strong></span></th><th align="center"><span class="bold"><strong>Version 4.30</strong></span></th></tr><tr><th align="left">gl_PointSize (vertex shader)</th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr><tr><th align="left">gl_PointSize (geometry shader)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr></thead></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<a href="gl_Position.xml"><span class="citerefentry"><span class="refentrytitle">gl_Position</span></span></a>, <a href="gl_ClipDistance.xml"><span class="citerefentry"><span class="refentrytitle">gl_ClipDistance</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2011-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2011 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
in the fragment language behaves identically as it would in the tessellation control and evaluation
languages. If a geometry shader is present but does not write to <code class="function">gl_PrimitiveID</code>,
the value of <code class="function">gl_PrimitiveID</code> in the fragment shader is undefined.
- </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="versions"></a><h2>Version Support</h2><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>Function</strong></span></th><th align="left"><span class="bold"><strong>Version 1.10</strong></span></th><th align="left"><span class="bold"><strong>Version 1.20</strong></span></th><th align="left"><span class="bold"><strong>Version 1.30</strong></span></th><th align="left"><span class="bold"><strong>Version 1.40</strong></span></th><th align="left"><span class="bold"><strong>Version 1.50</strong></span></th><th align="left"><span class="bold"><strong>Version 3.30</strong></span></th><th align="left"><span class="bold"><strong>Version 4.00</strong></span></th><th align="left"><span class="bold"><strong>Version 4.10</strong></span></th><th align="left"><span class="bold"><strong>Version 4.20</strong></span></th><th align="center"><span class="bold"><strong>Version 4.30</strong></span></th></tr><tr><th align="left"><code class="function">gl_PrimitiveID</code> (Fragment and Geometry Languages)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr><tr><th align="left"><code class="function">gl_PrimitiveID</code> (Tessellation Control and Evaluation Languages)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr></thead></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
+ </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="versions"></a><h2>Version Support</h2><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>
+ Variable
+ </strong></span></th><th align="left"><span class="bold"><strong>
+ Version 1.10
+ </strong></span></th><th align="left"><span class="bold"><strong>
+ Version 1.20
+ </strong></span></th><th align="left"><span class="bold"><strong>
+ Version 1.30
+ </strong></span></th><th align="left"><span class="bold"><strong>
+ Version 1.40
+ </strong></span></th><th align="left"><span class="bold"><strong>
+ Version 1.50
+ </strong></span></th><th align="left"><span class="bold"><strong>
+ Version 3.30
+ </strong></span></th><th align="left"><span class="bold"><strong>
+ Version 4.00
+ </strong></span></th><th align="left"><span class="bold"><strong>
+ Version 4.10
+ </strong></span></th></tr><tr><th align="left">
+ gl_PrimitiveID
+ </th><th align="center">
+ <span class="emphasis"><em>Y</em></span>
+ </th><th align="center">
+ <span class="emphasis"><em>Y</em></span>
+ </th><th align="center">
+ <span class="emphasis"><em>Y</em></span>
+ </th><th align="center">
+ <span class="emphasis"><em>Y</em></span>
+ </th><th align="center">
+ <span class="emphasis"><em>Y</em></span>
+ </th><th align="center">
+ <span class="emphasis"><em>Y</em></span>
+ </th><th align="center">
+ <span class="emphasis"><em>Y</em></span>
+ </th><th align="center">
+ <span class="emphasis"><em>Y</em></span>
+ </th></tr></thead></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<a href="gl_InstanceID.xml"><span class="citerefentry"><span class="refentrytitle">gl_InstanceID</span></span></a>,
<a href="gl_VertexID.xml"><span class="citerefentry"><span class="refentrytitle">gl_VertexID</span></span></a>,
<a href="gl_PrimitiveIDIn.xml"><span class="citerefentry"><span class="refentrytitle">gl_PrimitiveIDIn</span></span></a>
<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>sign - OpenGL Shading Language (GLSL)</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="sign"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sign — extract the sign of the parameter</p></div><div class="refsynopsisdiv"><h2>Declaration</h2><div class="funcsynopsis"><p><code class="funcdef">genType <b class="fsfunc">sign</b>(</code>genType <var class="pdparam">x</var><code>)</code>;</p></div><div class="funcsynopsis"><p><code class="funcdef">genIType <b class="fsfunc">sign</b>(</code>genIType <var class="pdparam">x</var><code>)</code>;</p></div><div class="funcsynopsis"><p><code class="funcdef">genDType <b class="fsfunc">sign</b>(</code>genDType <var class="pdparam">x</var><code>)</code>;</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em></span></dt><dd><p>
Specify the value from which to extract the sign.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
- <code class="function">sign</code> returns -1.0 if <em class="parameter"><code>x</code></em> is less than 0.0, 0.0 if <em class="parameter"><code>x</code></em>
- is equal to 0.0, and +1.0 if <em class="parameter"><code>x</code></em> is greater than 0.0.
+ <code class="function">abs</code> returns 1.0 if
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:apply><mml:lt definitionURL="" encoding=""></mml:lt><mml:mi>x</mml:mi><mml:mn>0.0</mml:mn></mml:apply></mml:math>,
+ 0.0 if
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:apply><mml:eq definitionURL="" encoding=""></mml:eq><mml:mi>x</mml:mi><mml:mn>0.0</mml:mn></mml:apply></mml:math> and
+ 1.0 if
+ <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:apply><mml:gt definitionURL="" encoding=""></mml:gt><mml:mi>x</mml:mi><mml:mn>0.0</mml:mn></mml:apply></mml:math>.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="versions"></a><h2>Version Support</h2><div class="informaltable"><table border="1"><colgroup><col align="left" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /><col align="center" /></colgroup><thead><tr><th align="left"><span class="bold"><strong>Function</strong></span></th><th align="left"><span class="bold"><strong>Version 1.10</strong></span></th><th align="left"><span class="bold"><strong>Version 1.20</strong></span></th><th align="left"><span class="bold"><strong>Version 1.30</strong></span></th><th align="left"><span class="bold"><strong>Version 1.40</strong></span></th><th align="left"><span class="bold"><strong>Version 1.50</strong></span></th><th align="left"><span class="bold"><strong>Version 3.30</strong></span></th><th align="left"><span class="bold"><strong>Version 4.00</strong></span></th><th align="left"><span class="bold"><strong>Version 4.10</strong></span></th><th align="left"><span class="bold"><strong>Version 4.20</strong></span></th><th align="center"><span class="bold"><strong>Version 4.30</strong></span></th></tr><tr><th align="left">sign (genType)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr><tr><th align="left">sign (genIType)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr><tr><th align="left">sign (genDType)</th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>-</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th><th align="center"><span class="emphasis"><em>Y</em></span></th></tr></thead></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
- <a href="abs.xml"><span class="citerefentry"><span class="refentrytitle">abs</span></span></a>
+ <a href="sign.xml"><span class="citerefentry"><span class="refentrytitle">sign</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
- Copyright <span class="trademark"></span>© 2011-2013 Khronos Group.
+ Copyright <span class="trademark"></span>© 2011 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
-# THIS FILE IS OBSOLETE. Please migrate away from using the
-# ".spec" files to the XML Registry. See
-# http://www.opengl.org/registry/api/README.txt
-# for more information.
-
-# This is the old (no longer canonical) OpenGL and OpenGL ES enumerant
-# registry. It is no longer maintained or used for current header file
-# generation.
+# This is the OpenGL and OpenGL ES enumerant registry.
+#
+# It is an extremely important file. Do not mess with it unless
+# you know what you're doing and have permission to do so.
+#
+# $Revision: 20466 $ on $Date: 2013-02-06 04:09:36 -0800 (Wed, 06 Feb 2013) $
-# $Revision: 22136 $ on $Date: 2013-06-24 04:04:33 -0700 (Mon, 24 Jun 2013) $
+###############################################################################
+#
+# Before modifying this file, read the following:
+#
+# ONLY the Khronos API Registrar (Jon Leech, jon 'at' alumni.caltech.edu)
+# may allocate new enumerants outside the 'experimental' range described
+# below. Any modifications to this file not performed by the Registrar
+# are incompatible with the OpenGL API. The master copy of the registry,
+# showing up-to-date enumerant allocations, is maintained in the
+# OpenGL registry at
+#
+# http://www.opengl.org/registry/
+#
+# The following guidelines are thus only for reference purposes
+# (unless you're the Registrar)
+#
+# Enumerant values for extensions CANNOT be chosen arbitrarily, since
+# the enumerant value space is shared by all GL implementations. It is
+# therefore imperative that the procedures described in this file be
+# followed carefully when allocating extension enum values.
+#
+# - Use tabs, not spaces.
+#
+# - When adding enum values for a new extension, use existing extensions
+# as a guide.
+#
+# - When a vendor has committed to releasing a new extension and needs to
+# allocate enum values for that extension, the vendor may request that the
+# ARB allocate a previously unallocated block of 16 enum values, in the
+# range 0x8000-0xFFFF, for the vendor's exclusive use.
+#
+# - The vendor that introduces an extension will allocate enum values for
+# it as if it is a single-vendor extension, even if it is a multi-vendor
+# (EXT) extension.
+#
+# - The file enum.spec is primarily a reference. The file enumext.spec
+# contains enumerants for all OpenGL 1.2 and OpenGL extensions in a form
+# used to generate <GL/glext.h>.
+#
+# - If a vendor hasn't yet released an extension, just add a comment to
+# enum.spec that contains the name of the extension and the range of enum
+# values used by the extension. When the vendor releases the extension,
+# put the actual enum assignments in enum.spec and enumext.spec.
+#
+# - Allocate all of the enum values for an extension in a single contiguous
+# block.
+#
+# - If an extension is experimental, allocate temporary enum values in the
+# range 0x6000-0x8000 during development work. When the vendor commits to
+# releasing the extension, allocate permanent enum values (see below).
+# There are two reasons for this policy:
+#
+# 1. It is desirable to keep extension enum values tightly packed and to
+# make all of the enum values for an extension be contiguous. This is
+# possible only if permanent enum values for a new extension are not
+# allocated until the extension spec is stable and the number of new
+# enum values needed by the extension has therefore stopped changing.
+#
+# 2. OpenGL ARB policy is that a vendor may allocate a new block of 16
+# extension enum values only if it has committed to releasing an
+# extension that will use values in that block.
+#
+# - To allocate a new block of permanent enum values for an extension, do the
+# following:
+#
+# 1. Start at the top of enum.spec and choose the first future_use
+# range that is not allocated to another vendor and is large enough
+# to contain the new block. This will almost certainly be the
+# 'Any_vendor_future_use' range near the end of enum.spec. This
+# process helps keep allocated enum values tightly packed into
+# the start of the 0x8000-0xFFFF range.
+#
+# 2. Allocate a block of enum values at the start of this range. If
+# the enum definitions are going into enumfuture.spec, add a comment
+# to enum.spec that contains the name of the extension and the range
+# of values in the new block. Use existing extensions as a guide.
+#
+# 3. Add the size of the block you just allocated to the start of the
+# chosen future_use range. If you have allocated the entire range,
+# eliminate its future_use entry.
+#
+# 4. Note that there are historical enum allocations above 0xFFFF, but
+# no new allocations will be made there in the forseeable future.
+#
+###############################################################################
Extensions define:
VERSION_1_1 = 1
###############################################################################
-PrimitiveType enum:
+BeginMode enum:
POINTS = 0x0000
LINES = 0x0001
LINE_LOOP = 0x0002
NV_gpu_shader5 enum:
use ARB_tessellation_shader PATCHES
-# PrimitiveType_future_use: 0x000F
+# BeginMode_future_use: 0x000F
###############################################################################
use SGI_texture_color_table TEXTURE_COLOR_TABLE_SGI
# Aliases OpenGL 1.0 core enums above
-EXT_vertex_weighting enum: (additional)
- MODELVIEW0_STACK_DEPTH_EXT = 0x0BA3 # GL_MODELVIEW_STACK_DEPTH
- MODELVIEW0_MATRIX_EXT = 0x0BA6 # GL_MODELVIEW_MATRIX
-
QCOM_alpha_test enum: (OpenGL ES only)
ALPHA_TEST_QCOM = 0x0BC0
ALPHA_TEST_FUNC_QCOM = 0x0BC1
PROJECTION = 0x1701
TEXTURE = 0x1702
-# Aliases OpenGL 1.0 core enums above
-EXT_vertex_weighting enum: (additional)
- MODELVIEW0_EXT = 0x1700 # GL_MODELVIEW
-
###############################################################################
MeshMode1 enum:
###############################################################################
PixelFormat enum:
+ COLOR_INDEX = 0x1900
+ STENCIL_INDEX = 0x1901
+ DEPTH_COMPONENT = 0x1902
+ RED = 0x1903
+ GREEN = 0x1904
+ BLUE = 0x1905
+ ALPHA = 0x1906
+ RGB = 0x1907
+ RGBA = 0x1908
+ LUMINANCE = 0x1909
+ LUMINANCE_ALPHA = 0x190A
+ use EXT_abgr ABGR_EXT
+ use EXT_cmyka CMYK_EXT
+ use EXT_cmyka CMYKA_EXT
+ use SGIX_icc_texture R5_G6_B5_ICC_SGIX
+ use SGIX_icc_texture R5_G6_B5_A8_ICC_SGIX
+ use SGIX_icc_texture ALPHA16_ICC_SGIX
+ use SGIX_icc_texture LUMINANCE16_ICC_SGIX
+ use SGIX_icc_texture LUMINANCE16_ALPHA8_ICC_SGIX
+ use SGIX_ycrcb YCRCB_422_SGIX
+ use SGIX_ycrcb YCRCB_444_SGIX
OES_depth_texture enum: (OpenGL ES only)
# use DataType UNSIGNED_SHORT
RGBA4_OES = 0x8056
RGB5_A1_OES = 0x8057
-# Aliases EXT_texture enums above
-ARM_rgba8 enum: (OpenGL ES only)
- RGBA8_OES = 0x8058
-
###############################################################################
EXT_texture_object enum:
SAMPLE_PATTERN_EXT = 0x80AC # 1 I
MULTISAMPLE_BIT_EXT = 0x20000000
+# Reuses SAMPLES enum as COVERAGE_SAMPLES
+NV_multisample_coverage enum: (additional; see below)
+ COVERAGE_SAMPLES_NV = 0x80A9
+
###############################################################################
SGIS_sharpen_texture enum:
###############################################################################
-ARB_shadow_ambient enum:
- TEXTURE_COMPARE_FAIL_VALUE_ARB = 0x80BF
-
SGIX_shadow_ambient enum:
SHADOW_AMBIENT_SGIX = 0x80BF
###############################################################################
-# Microsoft: 0x80E0-0x810F
-
VERSION_1_2 enum: (Promoted for OpenGL 1.2)
BGR = 0x80E0
BGRA = 0x80E1
BGR_EXT = 0x80E0
BGRA_EXT = 0x80E1
-EXT_paletted_texture enum:
- COLOR_INDEX1_EXT = 0x80E2
- COLOR_INDEX2_EXT = 0x80E3
- COLOR_INDEX4_EXT = 0x80E4
- COLOR_INDEX8_EXT = 0x80E5
- COLOR_INDEX12_EXT = 0x80E6
- COLOR_INDEX16_EXT = 0x80E7
+###############################################################################
+
+# Microsoft: 0x80E2-0x80E7
+
+###############################################################################
VERSION_1_2 enum:
MAX_ELEMENTS_VERTICES = 0x80E8
MAX_ELEMENTS_INDICES = 0x80E9
-EXT_draw_range_elements enum:
- MAX_ELEMENTS_VERTICES_EXT = 0x80E8
- MAX_ELEMENTS_INDICES_EXT = 0x80E9
-
-WIN_phong_shading enum:
- PHONG_WIN = 0x80EA
- PHONG_HINT_WIN = 0x80EB
-
-WIN_specular_fog enum:
- FOG_SPECULAR_TEXTURE_WIN = 0x80EC
-
-EXT_paletted_texture enum:
- TEXTURE_INDEX_SIZE_EXT = 0x80ED
-
-# MS_future_use: 0x80EE-0x80EF
-
-EXT_clip_volume_hint enum:
- CLIP_VOLUME_CLIPPING_HINT_EXT = 0x80F0
+###############################################################################
-# MS_future_use: 0x80F1-0x810F
+# Microsoft: 0x80EA-0x810F
###############################################################################
-# SGI: 0x8110-0x814F
-
SGIS_texture_select enum:
DUAL_ALPHA4_SGIS = 0x8110
DUAL_ALPHA8_SGIS = 0x8111
REPLICATE_BORDER = 0x8153
CONVOLUTION_BORDER_COLOR = 0x8154
-###############################################################################
-
-# HP: 0x8150-0x816F
-
HP_convolution_border_modes enum:
IGNORE_BORDER_HP = 0x8150 # Not promoted
CONSTANT_BORDER_HP = 0x8151
REPLICATE_BORDER_HP = 0x8153
CONVOLUTION_BORDER_COLOR_HP = 0x8154
-HP_image_transform enum:
- IMAGE_SCALE_X_HP = 0x8155
- IMAGE_SCALE_Y_HP = 0x8156
- IMAGE_TRANSLATE_X_HP = 0x8157
- IMAGE_TRANSLATE_Y_HP = 0x8158
- IMAGE_ROTATE_ANGLE_HP = 0x8159
- IMAGE_ROTATE_ORIGIN_X_HP = 0x815A
- IMAGE_ROTATE_ORIGIN_Y_HP = 0x815B
- IMAGE_MAG_FILTER_HP = 0x815C
- IMAGE_MIN_FILTER_HP = 0x815D
- IMAGE_CUBIC_WEIGHT_HP = 0x815E
- CUBIC_HP = 0x815F
- AVERAGE_HP = 0x8160
- IMAGE_TRANSFORM_2D_HP = 0x8161
- POST_IMAGE_TRANSFORM_COLOR_TABLE_HP = 0x8162
- PROXY_POST_IMAGE_TRANSFORM_COLOR_TABLE_HP = 0x8163
-
-# HP_future_use: 0x8164
-
-HP_occlusion_test enum:
- OCCLUSION_TEST_HP = 0x8165
- OCCLUSION_TEST_RESULT_HP = 0x8166
-
-HP_texture_lighting enum:
- TEXTURE_LIGHTING_MODE_HP = 0x8167
- TEXTURE_POST_SPECULAR_HP = 0x8168
- TEXTURE_PRE_SPECULAR_HP = 0x8169
+###############################################################################
-# HP_future_use: 0x816A-0x816F
+# HP: 0x8155-0x816F
###############################################################################
-# SGI: 0x8170-0x81CF
-
SGIX_clipmap enum:
LINEAR_CLIPMAP_LINEAR_SGIX = 0x8170
TEXTURE_CLIPMAP_CENTER_SGIX = 0x8171
###############################################################################
-# Incomplete extension
+# Incomplete extension, not in enumext.spec
# SGIX_fog_scale: 0x81FC-0x81FD
-# FOG_SCALE_SGIX = 0x81FC # 1 I
-# FOG_SCALE_VALUE_SGIX = 0x81FD # 1 F
+# FOG_SCALE_SGIX = 0x81FC # 1 I
+# FOG_SCALE_VALUE_SGIX = 0x81FD # 1 F
###############################################################################
-# Incomplete extension
-# SGIX_fog_blend:
-# FOG_BLEND_ALPHA_SGIX = 0x81FE # 1 I
-# FOG_BLEND_COLOR_SGIX = 0x81FF # 1 I
+# Incomplete extension, not in enumext.spec
+# SGIX_fog_blend: 0x81FE-0x81FF
+# FOG_BLEND_ALPHA_SGIX = 0x81FE # 1 I
+# FOG_BLEND_COLOR_SGIX = 0x81FF # 1 I
###############################################################################
PROGRAM_PIPELINE_BINDING = 0x825A
# Aliases ARB_separate_shader_objects enum above
-# Used to list ACTIVE_PROGRAM_EXT = 0x8259 but this was a bogus
-# redefinition and never shipped in the Khronos header.
EXT_separate_shader_objects enum: (OpenGL ES only)
PROGRAM_SEPARABLE_EXT = 0x8258
+ ACTIVE_PROGRAM_EXT = 0x8259
PROGRAM_PIPELINE_BINDING_EXT = 0x825A
ARB_viewport_array enum:
###############################################################################
-# SGI: 0x8310-0x832F
-
SGIX_depth_pass_instrument enum: 0x8310-0x8312
DEPTH_PASS_INSTRUMENT_SGIX = 0x8310
DEPTH_PASS_INSTRUMENT_COUNTERS_SGIX = 0x8311
###############################################################################
-# SUN: 0x8330-0x833F
-
EXT_pixel_transform enum:
PIXEL_TRANSFORM_2D_EXT = 0x8330
PIXEL_MAG_FILTER_EXT = 0x8331
###############################################################################
-# SGI: 0x8340-0x836F
# Incomplete extension, not in enumext.spec
# SGIX_cube_map: 0x8340-0x8348
# ENV_MAP_SGIX = 0x8340
# Incomplete extension, not in enumext.spec
# SGIX_fog_factor_to_alpha: 0x836F
-# FOG_FACTOR_TO_ALPHA_SGIX = 0x836F
+ FOG_FACTOR_TO_ALPHA_SGIX = 0x836F
###############################################################################
###############################################################################
-# SGI: 0x8400-0x846F
-
SGIX_fragment_lighting enum:
FRAGMENT_LIGHTING_SGIX = 0x8400 # 1 I
FRAGMENT_COLOR_MATERIAL_SGIX = 0x8401 # 1 I
###############################################################################
-# Incomplete extension
-# SGIX_fragment_lighting_space enum:
-# EYE_SPACE_SGIX = 0x8436
-# TANGENT_SPACE_SGIX = 0x8437
-# OBJECT_SPACE_SGIX = 0x8438
-# TANGENT_ARRAY_SGIX = 0x8439
-# BINORMAL_ARRAY_SGIX = 0x843A
-# CURRENT_TANGENT_SGIX = 0x843B 3 F
-# CURRENT_BINORMAL_SGIX = 0x843C 3 F
-# FRAGMENT_LIGHT_SPACE_SGIX = 0x843D 1 I
-# TANGENT_ARRAY_TYPE_SGIX = 0x843E
-# TANGENT_ARRAY_STRIDE_SGIX = 0x843F
-# TANGENT_ARRAY_COUNT_SGIX = 0x8440
-# BINORMAL_ARRAY_TYPE_SGIX = 0x8441
-# BINORMAL_ARRAY_STRIDE_SGIX = 0x8442
-# BINORMAL_ARRAY_COUNT_SGIX = 0x8443
-# TANGENT_ARRAY_POINTER_SGIX = 0x8444
-# BINORMAL_ARRAY_POINTER_SGIX = 0x8445
-# MAP1_TANGENT_SGIX = 0x8446
-# MAP2_TANGENT_SGIX = 0x8447
-# MAP1_BINORMAL_SGIX = 0x8448
-# MAP2_BINORMAL_SGIX = 0x8449
-
-EXT_coordinate_frame enum:
- TANGENT_ARRAY_EXT = 0x8439
- BINORMAL_ARRAY_EXT = 0x843A
- CURRENT_TANGENT_EXT = 0x843B
- CURRENT_BINORMAL_EXT = 0x843C
- TANGENT_ARRAY_TYPE_EXT = 0x843E
- TANGENT_ARRAY_STRIDE_EXT = 0x843F
- BINORMAL_ARRAY_TYPE_EXT = 0x8440
- BINORMAL_ARRAY_STRIDE_EXT = 0x8441
- TANGENT_ARRAY_POINTER_EXT = 0x8442
- BINORMAL_ARRAY_POINTER_EXT = 0x8443
- MAP1_TANGENT_EXT = 0x8444
- MAP2_TANGENT_EXT = 0x8445
- MAP1_BINORMAL_EXT = 0x8446
- MAP2_BINORMAL_EXT = 0x8447
-
-###############################################################################
-
-# Incomplete extension
+# Incomplete extension, not in enumext.spec
+# SGIX_fragment_lighting_space: 0x8436-0x8449
+# EYE_SPACE_SGIX = 0x8436
+# TANGENT_SPACE_SGIX = 0x8437
+# OBJECT_SPACE_SGIX = 0x8438
+# TANGENT_ARRAY_SGIX = 0x8439
+# BINORMAL_ARRAY_SGIX = 0x843A
+# CURRENT_TANGENT_SGIX = 0x843B # 3 F
+# CURRENT_BINORMAL_SGIX = 0x843C # 3 F
+# FRAGMENT_LIGHT_SPACE_SGIX = 0x843D # 1 I
+# TANGENT_ARRAY_TYPE_SGIX = 0x843E
+# TANGENT_ARRAY_STRIDE_SGIX = 0x843F
+# TANGENT_ARRAY_COUNT_SGIX = 0x8440
+# BINORMAL_ARRAY_TYPE_SGIX = 0x8441
+# BINORMAL_ARRAY_STRIDE_SGIX = 0x8442
+# BINORMAL_ARRAY_COUNT_SGIX = 0x8443
+# TANGENT_ARRAY_POINTER_SGIX = 0x8444
+# BINORMAL_ARRAY_POINTER_SGIX = 0x8445
+# MAP1_TANGENT_SGIX = 0x8446
+# MAP2_TANGENT_SGIX = 0x8447
+# MAP1_BINORMAL_SGIX = 0x8448
+# MAP2_BINORMAL_SGIX = 0x8449
+
+###############################################################################
+
+# Incomplete extension, not in enumext.spec
# SGIX_bali_timer_instruments: 0x844A-0x844C
# BALI_GEOM_TIMER_INSTRUMENT_SGIX = 0x844A # 1 I
# BALI_RASTER_TIMER_INSTRUMENT_SGIX = 0x844B # 1 I
###############################################################################
# Incomplete extension, not in enumext.spec
-# SGIX_icc_texture enum:
+SGIX_icc_texture enum:
# RGB_ICC_SGIX = 0x8460
# RGBA_ICC_SGIX = 0x8461
# ALPHA_ICC_SGIX = 0x8462
EXT_vertex_weighting enum:
MODELVIEW1_STACK_DEPTH_EXT = 0x8502
-NV_texture_env_combine4 enum: (additional; see below):
- COMBINE4_NV = 0x8503
+# NV_texture_env_combine4 (additional; see below): 0x8503
NV_light_max_exponent enum:
MAX_SHININESS_NV = 0x8504
MAX_SPOT_EXPONENT_NV = 0x8505
EXT_vertex_weighting enum:
- MODELVIEW1_MATRIX_EXT = 0x8506
+ MODELVIEW_MATRIX1_EXT = 0x8506
VERSION_1_4 enum: (Promoted for OpenGL 1.4)
INCR_WRAP = 0x8507
MAX_CUBE_MAP_TEXTURE_SIZE_EXT = 0x851C
NV_texgen_reflection enum:
- NORMAL_MAP_NV = 0x8511
- REFLECTION_MAP_NV = 0x8512
+ NORMAL_MAP = 0x8511
+ REFLECTION_MAP = 0x8512
ARB_texture_cube_map enum:
NORMAL_MAP_ARB = 0x8511
HALF_BIAS_NORMAL_NV = 0x853A
HALF_BIAS_NEGATE_NV = 0x853B
SIGNED_IDENTITY_NV = 0x853C
- SIGNED_NEGATE_NV = 0x853D
+ UNSIGNED_NEGATE_NV = 0x853D
SCALE_BY_TWO_NV = 0x853E
SCALE_BY_FOUR_NV = 0x853F
SCALE_BY_ONE_HALF_NV = 0x8540
PRIMITIVE_RESTART_INDEX_NV = 0x8559
NV_fog_distance enum:
- FOG_DISTANCE_MODE_NV = 0x855A
+ FOG_GEN_MODE_NV = 0x855A
EYE_RADIAL_NV = 0x855B
EYE_PLANE_ABSOLUTE_NV = 0x855C
OPERAND1_ALPHA = 0x8599
OPERAND2_ALPHA = 0x859A
-ARB_texture_env_combine enum:
- COMBINE_ARB = 0x8570
- COMBINE_RGB_ARB = 0x8571
- COMBINE_ALPHA_ARB = 0x8572
- RGB_SCALE_ARB = 0x8573
- ADD_SIGNED_ARB = 0x8574
- INTERPOLATE_ARB = 0x8575
- CONSTANT_ARB = 0x8576
- PRIMARY_COLOR_ARB = 0x8577
- PREVIOUS_ARB = 0x8578
- SOURCE0_RGB_ARB = 0x8580
- SOURCE1_RGB_ARB = 0x8581
- SOURCE2_RGB_ARB = 0x8582
- SOURCE0_ALPHA_ARB = 0x8588
- SOURCE1_ALPHA_ARB = 0x8589
- SOURCE2_ALPHA_ARB = 0x858A
- OPERAND0_RGB_ARB = 0x8590
- OPERAND1_RGB_ARB = 0x8591
- OPERAND2_RGB_ARB = 0x8592
- OPERAND0_ALPHA_ARB = 0x8598
- OPERAND1_ALPHA_ARB = 0x8599
- OPERAND2_ALPHA_ARB = 0x859A
- SUBTRACT_ARB = 0x84E7
-
EXT_texture_env_combine enum:
COMBINE_EXT = 0x8570
COMBINE_RGB_EXT = 0x8571
OPERAND2_ALPHA_EXT = 0x859A
NV_texture_env_combine4 enum:
+ COMBINE4_NV = 0x8503
SOURCE3_RGB_NV = 0x8583
SOURCE3_ALPHA_NV = 0x858B
OPERAND3_RGB_NV = 0x8593
OPERAND3_ALPHA_NV = 0x859B
# "Future use" => "additional combiner input/output enums" only
-# ATI/NVIDIA_future_use: 0x8579-0x857F
# ATI/NVIDIA_future_use: 0x8584-0x8587
# ATI/NVIDIA_future_use: 0x858C-0x858F
# ATI/NVIDIA_future_use: 0x8594-0x8597
###############################################################################
-# SGI: 0x85A0-0x85AF
-
SGIX_subsample enum:
PACK_SUBSAMPLE_RATE_SGIX = 0x85A0
UNPACK_SUBSAMPLE_RATE_SGIX = 0x85A1
MAP_ATTRIB_U_ORDER_NV = 0x86C3
MAP_ATTRIB_V_ORDER_NV = 0x86C4
EVAL_FRACTIONAL_TESSELLATION_NV = 0x86C5
- EVAL_VERTEX_ATTRIB0_NV = 0x86C6
- EVAL_VERTEX_ATTRIB1_NV = 0x86C7
- EVAL_VERTEX_ATTRIB2_NV = 0x86C8
- EVAL_VERTEX_ATTRIB3_NV = 0x86C9
- EVAL_VERTEX_ATTRIB4_NV = 0x86CA
- EVAL_VERTEX_ATTRIB5_NV = 0x86CB
- EVAL_VERTEX_ATTRIB6_NV = 0x86CC
- EVAL_VERTEX_ATTRIB7_NV = 0x86CD
- EVAL_VERTEX_ATTRIB8_NV = 0x86CE
- EVAL_VERTEX_ATTRIB9_NV = 0x86CF
- EVAL_VERTEX_ATTRIB10_NV = 0x86D0
- EVAL_VERTEX_ATTRIB11_NV = 0x86D1
- EVAL_VERTEX_ATTRIB12_NV = 0x86D2
- EVAL_VERTEX_ATTRIB13_NV = 0x86D3
- EVAL_VERTEX_ATTRIB14_NV = 0x86D4
- EVAL_VERTEX_ATTRIB15_NV = 0x86D5
+ EVAL_VERTEX_ATRRIB0_NV = 0x86C6
+ EVAL_VERTEX_ATRRIB1_NV = 0x86C7
+ EVAL_VERTEX_ATRRIB2_NV = 0x86C8
+ EVAL_VERTEX_ATRRIB3_NV = 0x86C9
+ EVAL_VERTEX_ATRRIB4_NV = 0x86CA
+ EVAL_VERTEX_ATRRIB5_NV = 0x86CB
+ EVAL_VERTEX_ATRRIB6_NV = 0x86CC
+ EVAL_VERTEX_ATRRIB7_NV = 0x86CD
+ EVAL_VERTEX_ATRRIB8_NV = 0x86CE
+ EVAL_VERTEX_ATRRIB9_NV = 0x86CF
+ EVAL_VERTEX_ATRRIB10_NV = 0x86D0
+ EVAL_VERTEX_ATRRIB11_NV = 0x86D1
+ EVAL_VERTEX_ATRRIB12_NV = 0x86D2
+ EVAL_VERTEX_ATRRIB13_NV = 0x86D3
+ EVAL_VERTEX_ATRRIB14_NV = 0x86D4
+ EVAL_VERTEX_ATRRIB15_NV = 0x86D5
MAX_MAP_TESSELLATION_NV = 0x86D6
MAX_RATIONAL_EVAL_ORDER_NV = 0x86D7
SHADER_OPERATION_NV = 0x86DF
CULL_MODES_NV = 0x86E0
OFFSET_TEXTURE_MATRIX_NV = 0x86E1
- OFFSET_TEXTURE_2D_MATRIX_NV = 0x86E1 # alias OFFSET_TEXTURE_MATRIX_NV
OFFSET_TEXTURE_SCALE_NV = 0x86E2
- OFFSET_TEXTURE_2D_SCALE_NV = 0x86E2 # alias OFFSET_TEXTURE_SCALE_NV
OFFSET_TEXTURE_BIAS_NV = 0x86E3
- OFFSET_TEXTURE_2D_BIAS_NV = 0x86E3 # alias OFFSET_TEXTURE_BIAS_NV
+ OFFSET_TEXTURE_2D_MATRIX_NV = GL_OFFSET_TEXTURE_MATRIX_NV
+ OFFSET_TEXTURE_2D_SCALE_NV = GL_OFFSET_TEXTURE_SCALE_NV
+ OFFSET_TEXTURE_2D_BIAS_NV = GL_OFFSET_TEXTURE_BIAS_NV
PREVIOUS_TEXTURE_INPUT_NV = 0x86E4
CONST_EYE_NV = 0x86E5
PASS_THROUGH_NV = 0x86E6
RGB16F_EXT = 0x881B
ARB_color_buffer_float enum:
- RGBA_FLOAT_MODE_ARB = 0x8820
+ RGBA_FLOAT_MODE_ARB = 0x8820 # Equivalent to TYPE_RGBA_FLOAT_ATI
-ATI_pixel_format_float enum:
- RGBA_FLOAT_MODE_ATI = 0x8820
+ATI_pixel_format_float enum: (really WGL_ATI_pixel_format_float)
+ TYPE_RGBA_FLOAT_ATI = 0x8820
# AMD_future_use: 0x8821-0x8822
DRAW_BUFFER14_NV = 0x8833
DRAW_BUFFER15_NV = 0x8834
-ATI_pixel_format_float enum: (additional; see above)
+ATI_pixel_format_float enum: (really WGL_ATI_pixel_format_float) (additional; see above)
COLOR_CLEAR_UNCLAMPED_VALUE_ATI = 0x8835
# AMD_future_use: 0x8836-0x883C
ARB_transform_feedback2 enum:
TRANSFORM_FEEDBACK = 0x8E22
TRANSFORM_FEEDBACK_PAUSED = 0x8E23
- TRANSFORM_FEEDBACK_BUFFER_PAUSED = 0x8E23 # alias TRANSFORM_FEEDBACK_PAUSED
+ TRANSFORM_FEEDBACK_BUFFER_PAUSED = GL_TRANSFORM_FEEDBACK_PAUSED
TRANSFORM_FEEDBACK_ACTIVE = 0x8E24
- TRANSFORM_FEEDBACK_BUFFER_ACTIVE = 0x8E24 # alias TRANSFORM_FEEDBACK_ACTIVE
+ TRANSFORM_FEEDBACK_BUFFER_ACTIVE = GL_TRANSFORM_FEEDBACK_ACTIVE
TRANSFORM_FEEDBACK_BINDING = 0x8E25
NV_transform_feedback2 enum:
MAX_FRAGMENT_INTERPOLATION_OFFSET_NV = 0x8E5C
FRAGMENT_PROGRAM_INTERPOLATION_OFFSET_BITS_NV = 0x8E5D
-VERSION_4_0 enum:
+ARB_texture_gather enum:
MIN_PROGRAM_TEXTURE_GATHER_OFFSET = 0x8E5E
MAX_PROGRAM_TEXTURE_GATHER_OFFSET = 0x8E5F
-
-ARB_texture_gather enum:
- MIN_PROGRAM_TEXTURE_GATHER_OFFSET_ARB = 0x8E5E
- MAX_PROGRAM_TEXTURE_GATHER_OFFSET_ARB = 0x8E5F
+ MAX_PROGRAM_TEXTURE_GATHER_COMPONENTS_ARB = 0x8F9F
NV_gpu_program5 enum:
MIN_PROGRAM_TEXTURE_GATHER_OFFSET_NV = 0x8E5E
ARB_copy_buffer enum:
COPY_READ_BUFFER_BINDING = 0x8F36
- COPY_READ_BUFFER = 0x8F36 # alias COPY_READ_BUFFER_BINDING
+ COPY_READ_BUFFER = GL_COPY_READ_BUFFER_BINDING
COPY_WRITE_BUFFER_BINDING = 0x8F37
- COPY_WRITE_BUFFER = 0x8F37 # alias COPY_WRITE_BUFFER_BINDING
+ COPY_WRITE_BUFFER = GL_COPY_WRITE_BUFFER_BINDING
VERSION_3_1 enum:
use ARB_copy_buffer COPY_READ_BUFFER
ARM_mali_shader_binary enum: (OpenGL ES only)
MALI_SHADER_BINARY_ARM = 0x8F60
-ARM_mali_program_binary enum: (OpenGL ES only)
- MALI_PROGRAM_BINARY_ARM = 0x8F61
-
-# ARM_future_use: 0x8F62-0x8F6F
+# ARM_future_use: 0x8F61-0x8F6F
###############################################################################
PRIMITIVE_RESTART_INDEX = 0x8F9E # Different from NV_primitive_restart value
ARB_texture_gather enum: (additional; see above)
- MAX_PROGRAM_TEXTURE_GATHER_COMPONENTS_ARB = 0x8F9F
+ MAX_PROGRAM_TEXTURE_GATHER_COMPONENTS = 0x8F9F
###############################################################################
# AMD: 0x9000-0x901F
# Assigned for Bill Licea-Kane
-AMD_vertex_shader_tessellator enum:
+AMD_vertex_shader_tesselator enum:
SAMPLER_BUFFER_AMD = 0x9001
INT_SAMPLER_BUFFER_AMD = 0x9002
UNSIGNED_INT_SAMPLER_BUFFER_AMD = 0x9003
# AMD_future_use: 0x9008
-VERSION_4_0 enum:
- TEXTURE_CUBE_MAP_ARRAY = 0x9009
- TEXTURE_BINDING_CUBE_MAP_ARRAY = 0x900A
- PROXY_TEXTURE_CUBE_MAP_ARRAY = 0x900B
- SAMPLER_CUBE_MAP_ARRAY = 0x900C
- SAMPLER_CUBE_MAP_ARRAY_SHADOW = 0x900D
- INT_SAMPLER_CUBE_MAP_ARRAY = 0x900E
- UNSIGNED_INT_SAMPLER_CUBE_MAP_ARRAY = 0x900F
-
ARB_texture_cube_map_array enum:
TEXTURE_CUBE_MAP_ARRAY = 0x9009
TEXTURE_BINDING_CUBE_MAP_ARRAY = 0x900A
CIRCULAR_TANGENT_ARC_TO_NV = 0xFC
ARC_TO_NV = 0xFE
RELATIVE_ARC_TO_NV = 0xFF
-# Bitfield values for this extension
BOLD_BIT_NV = 0x01
ITALIC_BIT_NV = 0x02
GLYPH_WIDTH_BIT_NV = 0x01
MAX_SHADER_STORAGE_BUFFER_BINDINGS = 0x90DD
MAX_SHADER_STORAGE_BLOCK_SIZE = 0x90DE
SHADER_STORAGE_BUFFER_OFFSET_ALIGNMENT = 0x90DF
- MAX_COMBINED_SHADER_OUTPUT_RESOURCES = 0x8F39 # alias MAX_COMBINED_IMAGE_UNITS_AND_FRAGMENT_OUTPUTS
+ MAX_COMBINED_SHADER_OUTPUT_RESOURCES = GL_MAX_COMBINED_IMAGE_UNITS_AND_FRAGMENT_OUTPUTS
use ARB_shader_image_load_store MAX_COMBINED_IMAGE_UNITS_AND_FRAGMENT_OUTPUTS
# NV_future_use: 0x90E0
MAX_FRAGMENT_ATOMIC_COUNTERS = 0x92D6
MAX_COMBINED_ATOMIC_COUNTERS = 0x92D7
MAX_ATOMIC_COUNTER_BUFFER_SIZE = 0x92D8
+ MAX_ATOMIC_COUNTER_BUFFER_BINDINGS = 0x92DC
ACTIVE_ATOMIC_COUNTER_BUFFERS = 0x92D9
UNIFORM_ATOMIC_COUNTER_BUFFER_INDEX = 0x92DA
UNSIGNED_INT_ATOMIC_COUNTER = 0x92DB
- MAX_ATOMIC_COUNTER_BUFFER_BINDINGS = 0x92DC
-# NV_future_use: 0x92DD-0x92DF
+# NV_future_use: 0x92DC-0x92DF
# Also VERSION_4_3
KHR_debug enum: (additional; see above)
###############################################################################
-# IBM: 103000-103999 (0x19258-0x1963F)
-
-IBM_rasterpos_clip enum:
- RASTER_POSITION_UNCLIPPED_IBM = 0x19262
-
-IBM_cull_vertex enum:
- CULL_VERTEX_IBM = 103050
-
-IBM_static_data enum:
- ALL_STATIC_DATA_IBM = 103060
- STATIC_VERTEX_ARRAY_IBM = 103061
- VERTEX_ARRAY_LIST_IBM = 103070
- NORMAL_ARRAY_LIST_IBM = 103071
- COLOR_ARRAY_LIST_IBM = 103072
- INDEX_ARRAY_LIST_IBM = 103073
- TEXTURE_COORD_ARRAY_LIST_IBM = 103074
- EDGE_FLAG_ARRAY_LIST_IBM = 103075
- FOG_COORDINATE_ARRAY_LIST_IBM = 103076
- SECONDARY_COLOR_ARRAY_LIST_IBM = 103077
- VERTEX_ARRAY_LIST_STRIDE_IBM = 103080
- NORMAL_ARRAY_LIST_STRIDE_IBM = 103081
- COLOR_ARRAY_LIST_STRIDE_IBM = 103082
- INDEX_ARRAY_LIST_STRIDE_IBM = 103083
- TEXTURE_COORD_ARRAY_LIST_STRIDE_IBM = 103084
- EDGE_FLAG_ARRAY_LIST_STRIDE_IBM = 103085
- FOG_COORDINATE_ARRAY_LIST_STRIDE_IBM = 103086
- SECONDARY_COLOR_ARRAY_LIST_STRIDE_IBM = 103087
-
-# Most of this range is available, but calculating IBM_future_use figures is
-# tedious and pointless since they're no longer building graphics hardware
-IBM_future_use: lots
+# IBM: 103000-103999
+# CULL_VERTEX_IBM = 103050
+# VERTEX_ARRAY_LIST_IBM = 103070
+# NORMAL_ARRAY_LIST_IBM = 103071
+# COLOR_ARRAY_LIST_IBM = 103072
+# INDEX_ARRAY_LIST_IBM = 103073
+# TEXTURE_COORD_ARRAY_LIST_IBM = 103074
+# EDGE_FLAG_ARRAY_LIST_IBM = 103075
+# FOG_COORDINATE_ARRAY_LIST_IBM = 103076
+# SECONDARY_COLOR_ARRAY_LIST_IBM = 103077
+# VERTEX_ARRAY_LIST_STRIDE_IBM = 103080
+# NORMAL_ARRAY_LIST_STRIDE_IBM = 103081
+# COLOR_ARRAY_LIST_STRIDE_IBM = 103082
+# INDEX_ARRAY_LIST_STRIDE_IBM = 103083
+# TEXTURE_COORD_ARRAY_LIST_STRIDE_IBM = 103084
+# EDGE_FLAG_ARRAY_LIST_STRIDE_IBM = 103085
+# FOG_COORDINATE_ARRAY_LIST_STRIDE_IBM = 103086
+# SECONDARY_COLOR_ARRAY_LIST_STRIDE_IBM = 103087
###############################################################################
# NEC: 104000-104999
# Compaq: 105000-105999 (Compaq was acquired by HP)
# KPC: 106000-106999 (Kubota is out of business)
-
-###############################################################################
-
-# PGI: 107000-107999 (0x1A1F8-0x1A5DF) (Portable was acquired by Template Graphics)
-
-PGI_misc_hints enum:
- PREFER_DOUBLEBUFFER_HINT_PGI = 0x1A1F8
- CONSERVE_MEMORY_HINT_PGI = 0x1A1FD
- RECLAIM_MEMORY_HINT_PGI = 0x1A1FE
- NATIVE_GRAPHICS_HANDLE_PGI = 0x1A202
- NATIVE_GRAPHICS_BEGIN_HINT_PGI = 0x1A203
- NATIVE_GRAPHICS_END_HINT_PGI = 0x1A204
- ALWAYS_FAST_HINT_PGI = 0x1A20C
- ALWAYS_SOFT_HINT_PGI = 0x1A20D
- ALLOW_DRAW_OBJ_HINT_PGI = 0x1A20E
- ALLOW_DRAW_WIN_HINT_PGI = 0x1A20F
- ALLOW_DRAW_FRG_HINT_PGI = 0x1A210
- ALLOW_DRAW_MEM_HINT_PGI = 0x1A211
- STRICT_DEPTHFUNC_HINT_PGI = 0x1A216
- STRICT_LIGHTING_HINT_PGI = 0x1A217
- STRICT_SCISSOR_HINT_PGI = 0x1A218
- FULL_STIPPLE_HINT_PGI = 0x1A219
- CLIP_NEAR_HINT_PGI = 0x1A220
- CLIP_FAR_HINT_PGI = 0x1A221
- WIDE_LINE_HINT_PGI = 0x1A222
- BACK_NORMALS_HINT_PGI = 0x1A223
-
-PGI_vertex_hints enum:
- VERTEX_DATA_HINT_PGI = 0x1A22A
- VERTEX_CONSISTENT_HINT_PGI = 0x1A22B
- MATERIAL_SIDE_HINT_PGI = 0x1A22C
- MAX_VERTEX_HINT_PGI = 0x1A22D
-# Bitfield values for HintPGI <mode>
- VERTEX23_BIT_PGI = 0x00000004
- VERTEX4_BIT_PGI = 0x00000008
- COLOR3_BIT_PGI = 0x00010000
- COLOR4_BIT_PGI = 0x00020000
- EDGEFLAG_BIT_PGI = 0x00040000
- INDEX_BIT_PGI = 0x00080000
- MAT_AMBIENT_BIT_PGI = 0x00100000
- MAT_AMBIENT_AND_DIFFUSE_BIT_PGI = 0x00200000
- MAT_DIFFUSE_BIT_PGI = 0x00400000
- MAT_EMISSION_BIT_PGI = 0x00800000
- MAT_COLOR_INDEXES_BIT_PGI = 0x01000000
- MAT_SHININESS_BIT_PGI = 0x02000000
- MAT_SPECULAR_BIT_PGI = 0x04000000
- NORMAL_BIT_PGI = 0x08000000
- TEXCOORD1_BIT_PGI = 0x10000000
- TEXCOORD2_BIT_PGI = 0x20000000
- TEXCOORD3_BIT_PGI = 0x40000000
- TEXCOORD4_BIT_PGI = 0x80000000
-
-# Most of this range is available, but calculating PGI_future_use
-# figures is tedious and pointless since they're out of business.
-PGI_future_use: lots
-
-###############################################################################
-
+# PGI: 107000-107999 (Portable was acquired by Template Graphics)
# E&S: 108000-108999
###############################################################################
-# THIS FILE IS OBSOLETE. Please migrate away from using the
-# ".spec" files to the XML Registry. See
-# http://www.opengl.org/registry/api/README.txt
-# for more information.
-
# enumext.spec - list of GL enumerants for glext.h header
#
-# $Revision: 22136 $ on $Date: 2013-06-24 04:04:33 -0700 (Mon, 24 Jun 2013) $
+# $Revision: 20495 $ on $Date: 2013-02-06 13:01:10 -0800 (Wed, 06 Feb 2013) $
-# This is derived from the deprecated GL enumerant registry (enum.spec).
+# This is derived from the master GL enumerant registry (enum.spec).
#
# Unlike enum.spec, enumext.spec is
# (1) Grouped by GL core version or extension number
passthru: /* Boolean */
FALSE = 0 # Boolean
TRUE = 1 # Boolean
-passthru: /* PrimitiveType */
- POINTS = 0x0000 # PrimitiveType
- LINES = 0x0001 # PrimitiveType
- LINE_LOOP = 0x0002 # PrimitiveType
- LINE_STRIP = 0x0003 # PrimitiveType
- TRIANGLES = 0x0004 # PrimitiveType
- TRIANGLE_STRIP = 0x0005 # PrimitiveType
- TRIANGLE_FAN = 0x0006 # PrimitiveType
- QUADS = 0x0007 # PrimitiveType
+passthru: /* BeginMode */
+ POINTS = 0x0000 # BeginMode
+ LINES = 0x0001 # BeginMode
+ LINE_LOOP = 0x0002 # BeginMode
+ LINE_STRIP = 0x0003 # BeginMode
+ TRIANGLES = 0x0004 # BeginMode
+ TRIANGLE_STRIP = 0x0005 # BeginMode
+ TRIANGLE_FAN = 0x0006 # BeginMode
+ QUADS = 0x0007 # BeginMode
passthru: /* AlphaFunction */
NEVER = 0x0200 # AlphaFunction
LESS = 0x0201 # AlphaFunction
CLIENT_PIXEL_STORE_BIT = 0x00000001 # ClientAttribMask
CLIENT_VERTEX_ARRAY_BIT = 0x00000002 # ClientAttribMask
CLIENT_ALL_ATTRIB_BITS = 0xFFFFFFFF # ClientAttribMask
-passthru: /* PrimitiveType */
- QUAD_STRIP = 0x0008 # PrimitiveType
- POLYGON = 0x0009 # PrimitiveType
+passthru: /* BeginMode */
+ QUAD_STRIP = 0x0008 # BeginMode
+ POLYGON = 0x0009 # BeginMode
passthru: /* AccumOp */
ACCUM = 0x0100 # AccumOp
LOAD = 0x0101 # AccumOp
CONTEXT_FLAGS = 0x821E
COMPRESSED_RED = 0x8225
COMPRESSED_RG = 0x8226
- CONTEXT_FLAG_FORWARD_COMPATIBLE_BIT = 0x00000001
+ CONTEXT_FLAG_FORWARD_COMPATIBLE_BIT = 0x0001
RGBA32F = 0x8814
RGB32F = 0x8815
RGBA16F = 0x881A
use ARB_gpu_shader5 MIN_FRAGMENT_INTERPOLATION_OFFSET
use ARB_gpu_shader5 MAX_FRAGMENT_INTERPOLATION_OFFSET
use ARB_gpu_shader5 FRAGMENT_INTERPOLATION_OFFSET_BITS
+ use ARB_gpu_shader5 MAX_VERTEX_STREAMS
passthru: /* Reuse tokens from ARB_gpu_shader_fp64 */
use ARB_gpu_shader_fp64 DOUBLE_VEC2
use ARB_gpu_shader_fp64 DOUBLE_VEC3
TEXTURE_DEPTH_TYPE = 0x8C16
UNSIGNED_NORMALIZED = 0x8C17
FRAMEBUFFER_BINDING = 0x8CA6
- DRAW_FRAMEBUFFER_BINDING = 0x8CA6 # alias FRAMEBUFFER_BINDING
+ DRAW_FRAMEBUFFER_BINDING = GL_FRAMEBUFFER_BINDING
RENDERBUFFER_BINDING = 0x8CA7
READ_FRAMEBUFFER = 0x8CA8
DRAW_FRAMEBUFFER = 0x8CA9
# ARB Extension #59
ARB_copy_buffer enum:
COPY_READ_BUFFER_BINDING = 0x8F36
- COPY_READ_BUFFER = 0x8F36 # alias COPY_READ_BUFFER_BINDING
+ COPY_READ_BUFFER = GL_COPY_READ_BUFFER_BINDING
COPY_WRITE_BUFFER_BINDING = 0x8F37
- COPY_WRITE_BUFFER = 0x8F37 # alias COPY_WRITE_BUFFER_BINDING
+ COPY_WRITE_BUFFER = GL_COPY_WRITE_BUFFER_BINDING
###############################################################################
MIN_FRAGMENT_INTERPOLATION_OFFSET = 0x8E5B
MAX_FRAGMENT_INTERPOLATION_OFFSET = 0x8E5C
FRAGMENT_INTERPOLATION_OFFSET_BITS = 0x8E5D
- use ARB_transform_feedback3 MAX_VERTEX_STREAMS
+ use ARB_texture_multisample MAX_VERTEX_STREAMS
###############################################################################
ARB_transform_feedback2 enum:
TRANSFORM_FEEDBACK = 0x8E22
TRANSFORM_FEEDBACK_PAUSED = 0x8E23
- TRANSFORM_FEEDBACK_BUFFER_PAUSED = 0x8E23 # alias TRANSFORM_FEEDBACK_PAUSED
+ TRANSFORM_FEEDBACK_BUFFER_PAUSED = GL_TRANSFORM_FEEDBACK_PAUSED
TRANSFORM_FEEDBACK_ACTIVE = 0x8E24
- TRANSFORM_FEEDBACK_BUFFER_ACTIVE = 0x8E24 # alias TRANSFORM_FEEDBACK_ACTIVE
+ TRANSFORM_FEEDBACK_BUFFER_ACTIVE = GL_TRANSFORM_FEEDBACK_ACTIVE
TRANSFORM_FEEDBACK_BINDING = 0x8E25
###############################################################################
MAX_SHADER_STORAGE_BUFFER_BINDINGS = 0x90DD
MAX_SHADER_STORAGE_BLOCK_SIZE = 0x90DE
SHADER_STORAGE_BUFFER_OFFSET_ALIGNMENT = 0x90DF
- SHADER_STORAGE_BARRIER_BIT = 0x00002000
- MAX_COMBINED_SHADER_OUTPUT_RESOURCES = 0x8F39 # alias MAX_COMBINED_IMAGE_UNITS_AND_FRAGMENT_OUTPUTS
+ SHADER_STORAGE_BARRIER_BIT = 0x2000
+ MAX_COMBINED_SHADER_OUTPUT_RESOURCES = GL_MAX_COMBINED_IMAGE_UNITS_AND_FRAGMENT_OUTPUTS
use ARB_shader_image_load_store MAX_COMBINED_IMAGE_UNITS_AND_FRAGMENT_OUTPUTS
###############################################################################
###############################################################################
# Extension #59
-SGIX_polynomial_ffd enum:
+FfdMaskSGIX enum:
TEXTURE_DEFORMATION_BIT_SGIX = 0x00000001
GEOMETRY_DEFORMATION_BIT_SGIX = 0x00000002
+SGIX_polynomial_ffd enum:
GEOMETRY_DEFORMATION_SGIX = 0x8194
TEXTURE_DEFORMATION_SGIX = 0x8195
DEFORMATIONS_MASK_SGIX = 0x8196 # 1 I
VERTEX_CONSISTENT_HINT_PGI = 0x1A22B
MATERIAL_SIDE_HINT_PGI = 0x1A22C
MAX_VERTEX_HINT_PGI = 0x1A22D
- VERTEX23_BIT_PGI = 0x00000004
- VERTEX4_BIT_PGI = 0x00000008
COLOR3_BIT_PGI = 0x00010000
COLOR4_BIT_PGI = 0x00020000
EDGEFLAG_BIT_PGI = 0x00040000
TEXCOORD2_BIT_PGI = 0x20000000
TEXCOORD3_BIT_PGI = 0x40000000
TEXCOORD4_BIT_PGI = 0x80000000
+ VERTEX23_BIT_PGI = 0x00000004
+ VERTEX4_BIT_PGI = 0x00000008
###############################################################################
# Extension #123 - skipped
# Extension #124 - skipped
# Extension #125 - skipped
-# Extension #126 - skipped (some enums used to be in glext.h, but this
-# was an incomplete SGI extension that never actually shipped).
+
+###############################################################################
+
+# Extension #126
+SGIX_impact_pixel_texture enum:
+ PIXEL_TEX_GEN_Q_CEILING_SGIX = 0x8184
+ PIXEL_TEX_GEN_Q_ROUND_SGIX = 0x8185
+ PIXEL_TEX_GEN_Q_FLOOR_SGIX = 0x8186
+ PIXEL_TEX_GEN_ALPHA_REPLACE_SGIX = 0x8187
+ PIXEL_TEX_GEN_ALPHA_NO_REPLACE_SGIX = 0x8188
+ PIXEL_TEX_GEN_ALPHA_LS_SGIX = 0x8189
+ PIXEL_TEX_GEN_ALPHA_MS_SGIX = 0x818A
+
+###############################################################################
+
# Extension #127 - skipped
# Extension #128 - skipped
###############################################################################
-# Extension #161 - skipped
+# Extension #161
+SGIX_fog_scale enum:
+ FOG_SCALE_SGIX = 0x81FC
+ FOG_SCALE_VALUE_SGIX = 0x81FD
+
+###############################################################################
+
# Extension #162 - skipped
-# (some enums used to be in glext.h, but these were incomplete SGI
-# extensions that never actually shipped).
###############################################################################
# Extension #188
EXT_vertex_weighting enum:
- MODELVIEW0_STACK_DEPTH_EXT = 0x0BA3 # GL_MODELVIEW_STACK_DEPTH
+ MODELVIEW0_STACK_DEPTH_EXT = GL_MODELVIEW_STACK_DEPTH
MODELVIEW1_STACK_DEPTH_EXT = 0x8502
- MODELVIEW0_MATRIX_EXT = 0x0BA6 # GL_MODELVIEW_MATRIX
+ MODELVIEW0_MATRIX_EXT = GL_MODELVIEW_MATRIX
MODELVIEW1_MATRIX_EXT = 0x8506
VERTEX_WEIGHTING_EXT = 0x8509
- MODELVIEW0_EXT = 0x1700 # GL_MODELVIEW
+ MODELVIEW0_EXT = GL_MODELVIEW
MODELVIEW1_EXT = 0x850A
CURRENT_VERTEX_WEIGHT_EXT = 0x850B
VERTEX_WEIGHT_ARRAY_EXT = 0x850C
###############################################################################
-# Extension #205 - skipped (some enums used to be in glext.h, but this
-# was an incomplete SGI extension that never actually shipped).
+# Extension #205
+SGI_depth_pass_instrument enum:
+ DEPTH_PASS_INSTRUMENT_SGIX = 0x8310
+ DEPTH_PASS_INSTRUMENT_COUNTERS_SGIX = 0x8311
+ DEPTH_PASS_INSTRUMENT_MAX_SGIX = 0x8312
###############################################################################
###############################################################################
-# Extension #223
-IBM_static_data enum:
- ALL_STATIC_DATA_IBM = 103060
- STATIC_VERTEX_ARRAY_IBM = 103061
-
-###############################################################################
-
# Extension #224
IBM_texture_mirrored_repeat enum:
MIRRORED_REPEAT_IBM = 0x8370
SHADER_OPERATION_NV = 0x86DF
CULL_MODES_NV = 0x86E0
OFFSET_TEXTURE_MATRIX_NV = 0x86E1
- OFFSET_TEXTURE_2D_MATRIX_NV = 0x86E1 # alias OFFSET_TEXTURE_MATRIX_NV
OFFSET_TEXTURE_SCALE_NV = 0x86E2
- OFFSET_TEXTURE_2D_SCALE_NV = 0x86E2 # alias OFFSET_TEXTURE_SCALE_NV
OFFSET_TEXTURE_BIAS_NV = 0x86E3
- OFFSET_TEXTURE_2D_BIAS_NV = 0x86E3 # alias OFFSET_TEXTURE_BIAS_NV
+ OFFSET_TEXTURE_2D_MATRIX_NV = GL_OFFSET_TEXTURE_MATRIX_NV
+ OFFSET_TEXTURE_2D_SCALE_NV = GL_OFFSET_TEXTURE_SCALE_NV
+ OFFSET_TEXTURE_2D_BIAS_NV = GL_OFFSET_TEXTURE_BIAS_NV
PREVIOUS_TEXTURE_INPUT_NV = 0x86E4
CONST_EYE_NV = 0x86E5
PASS_THROUGH_NV = 0x86E6
EXT_framebuffer_blit enum:
READ_FRAMEBUFFER_EXT = 0x8CA8
DRAW_FRAMEBUFFER_EXT = 0x8CA9
- DRAW_FRAMEBUFFER_BINDING_EXT = 0x8CA6 # alias FRAMEBUFFER_BINDING_EXT
+ DRAW_FRAMEBUFFER_BINDING_EXT = GL_FRAMEBUFFER_BINDING_EXT
READ_FRAMEBUFFER_BINDING_EXT = 0x8CAA
###############################################################################
###############################################################################
# Extension #363
-AMD_vertex_shader_tessellator enum:
+AMD_vertex_shader_tesselator enum:
SAMPLER_BUFFER_AMD = 0x9001
INT_SAMPLER_BUFFER_AMD = 0x9002
UNSIGNED_INT_SAMPLER_BUFFER_AMD = 0x9003
###############################################################################
# Extension #393
-# Revision 4 removed COVERAGE_SAMPLES_NV, which was an alias for
-# SAMPLES_ARB, due to a collision with the GL_NV_coverage_sample
-# OpenGL ES extension.
+# Reuses SAMPLES enum as COVERAGE_SAMPLES
NV_multisample_coverage enum:
+ COVERAGE_SAMPLES_NV = 0x80A9
COLOR_SAMPLES_NV = 0x8E20
- use ARB_multisample SAMPLES_ARB
###############################################################################
# gl.spec file
# DON'T REMOVE PREVIOUS LINE!!! libspec depends on it!
#
-# THIS FILE IS OBSOLETE. Please migrate away from using the
-# ".spec" files to the XML Registry. See
-# http://www.opengl.org/registry/api/README.txt
-# for more information.
-#
# Copyright (c) 1991-2005 Silicon Graphics, Inc. All Rights Reserved.
# Copyright (c) 2006-2013 The Khronos Group Inc.
#
# This document is licensed under the SGI Free Software B License Version
# 2.0. For details, see http://oss.sgi.com/projects/FreeB/ .
#
-# $Revision: 22136 $ on $Date: 2013-06-24 04:04:33 -0700 (Mon, 24 Jun 2013) $
+# $Revision: 20495 $ on $Date: 2013-02-06 13:01:10 -0800 (Wed, 06 Feb 2013) $
required-props:
# Description of a parameter
category: display-list drawing drawing-control feedback framebuf misc modeling pixel-op pixel-rw state-req xform
category: VERSION_1_0 VERSION_1_1 VERSION_1_2 VERSION_1_3 VERSION_1_4 VERSION_1_5 VERSION_2_0 VERSION_2_1 VERSION_3_0 VERSION_3_1 VERSION_3_2 VERSION_3_3 VERSION_4_0 VERSION_4_1 VERSION_4_2 VERSION_4_3
category: 3DFX_tbuffer
-category: AMD_conservative_depth AMD_debug_output AMD_draw_buffers_blend AMD_multi_draw_indirect AMD_name_gen_delete AMD_performance_monitor AMD_sample_positions AMD_sparse_texture AMD_stencil_operation_extended AMD_vertex_shader_tessellator
+category: AMD_conservative_depth AMD_debug_output AMD_draw_buffers_blend AMD_multi_draw_indirect AMD_name_gen_delete AMD_performance_monitor AMD_sample_positions AMD_sparse_texture AMD_stencil_operation_extended AMD_vertex_shader_tesselator
category: APPLE_aux_depth_stencil APPLE_element_array APPLE_fence APPLE_float_pixels APPLE_flush_buffer_range APPLE_object_purgeable APPLE_row_bytes APPLE_texture_range APPLE_vertex_array_object APPLE_vertex_array_range APPLE_vertex_program_evaluators
category: ARB_ES2_compatibility ARB_base_instance ARB_blend_func_extended ARB_cl_event ARB_color_buffer_float ARB_copy_buffer ARB_debug_output ARB_depth_buffer_float ARB_draw_buffers ARB_draw_buffers_blend ARB_draw_elements_base_vertex ARB_draw_indirect ARB_draw_instanced ARB_fragment_program ARB_fragment_shader ARB_framebuffer_object ARB_framebuffer_sRGB ARB_geometry_shader4 ARB_get_program_binary ARB_gpu_shader_fp64 ARB_half_float_vertex ARB_instanced_arrays ARB_internalformat_query ARB_map_buffer_range ARB_matrix_palette ARB_multisample ARB_multitexture ARB_occlusion_query ARB_point_parameters ARB_provoking_vertex ARB_robustness ARB_sample_shading ARB_sampler_objects ARB_separate_shader_objects ARB_shader_atomic_counters ARB_shader_image_load_store ARB_shader_objects ARB_shader_subroutine ARB_shading_language_include ARB_sync ARB_tessellation_shader ARB_texture_buffer_object ARB_texture_compression ARB_texture_compression_rgtc ARB_texture_multisample ARB_texture_rectangle ARB_texture_rg ARB_texture_storage ARB_timer_query ARB_transform_feedback2 ARB_transform_feedback3 ARB_transform_feedback_instanced ARB_transpose_matrix ARB_uniform_buffer_object ARB_vertex_array_object ARB_vertex_attrib_64bit ARB_vertex_blend ARB_vertex_buffer_object ARB_vertex_program ARB_vertex_shader ARB_vertex_type_2_10_10_10_rev ARB_viewport_array ARB_window_pos
category: ARB_clear_buffer_object ARB_compute_shader ARB_copy_image ARB_framebuffer_no_attachments ARB_internalformat_query2 ARB_invalidate_subdata ARB_multi_draw_indirect ARB_program_interface_query ARB_shader_storage_buffer_object ARB_texture_buffer_range ARB_texture_storage_multisample ARB_texture_view ARB_vertex_attrib_binding
category: EXT_bindable_uniform EXT_blend_color EXT_blend_equation_separate EXT_blend_func_separate EXT_blend_minmax EXT_color_subtable EXT_compiled_vertex_array EXT_convolution EXT_coordinate_frame EXT_copy_texture EXT_cull_vertex EXT_depth_bounds_test EXT_direct_state_access EXT_draw_buffers2 EXT_draw_instanced EXT_draw_range_elements EXT_fog_coord EXT_framebuffer_blit EXT_framebuffer_multisample EXT_framebuffer_object EXT_geometry_shader4 EXT_gpu_program_parameters EXT_gpu_shader4 EXT_histogram EXT_index_func EXT_index_material EXT_light_texture EXT_multi_draw_arrays EXT_multisample EXT_paletted_texture EXT_pixel_transform EXT_point_parameters EXT_polygon_offset EXT_provoking_vertex EXT_secondary_color EXT_separate_shader_objects EXT_shader_image_load_store EXT_stencil_clear_tag EXT_stencil_two_side EXT_subtexture EXT_texture3D EXT_texture_buffer_object EXT_texture_integer EXT_texture_object EXT_texture_perturb_normal EXT_texture_snorm EXT_texture_swizzle EXT_timer_query EXT_transform_feedback EXT_vertex_array EXT_vertex_array_bgra EXT_vertex_attrib_64bit EXT_vertex_shader EXT_vertex_weighting EXT_x11_sync_object
category: GREMEDY_frame_terminator GREMEDY_string_marker
category: HP_image_transform
-category: IBM_multimode_draw_arrays IBM_static_data IBM_vertex_array_lists
+category: IBM_multimode_draw_arrays IBM_vertex_array_lists
category: INGR_blend_func_separate
category: INTEL_parallel_arrays INTEL_map_texture
category: KHR_debug
Begin(mode)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
category VERSION_1_0 # old: drawing
profile compatibility
version 1.0
DrawArrays(mode, first, count)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param first Int32 in value
param count SizeI in value
category VERSION_1_1
DrawElements(mode, count, type, indices)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param count SizeI in value
param type DrawElementsType in value
param indices Void in array [COMPSIZE(count/type)]
DrawRangeElements(mode, start, end, count, type, indices)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param start UInt32 in value
param end UInt32 in value
param count SizeI in value
dlflags handcode
glxflags client-handcode server-handcode EXT
version 1.2
+ deprecated 3.1
glxropcode 4114
offset 371
# first and count are really 'in'
MultiDrawArrays(mode, first, count, drawcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param first Int32 in array [COMPSIZE(count)]
param count SizeI in array [COMPSIZE(drawcount)]
param drawcount SizeI in value
MultiDrawElements(mode, count, type, indices, drawcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param count SizeI in array [COMPSIZE(drawcount)]
param type DrawElementsType in value
param indices ConstVoidPointer in array [COMPSIZE(drawcount)]
DrawArraysInstanced(mode, first, count, instancecount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param first Int32 in value
param count SizeI in value
param instancecount SizeI in value
DrawElementsInstanced(mode, count, type, indices, instancecount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param count SizeI in value
param type DrawElementsType in value
param indices Void in array [COMPSIZE(count/type)]
DrawArraysInstancedARB(mode, first, count, primcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param first Int32 in value
param count SizeI in value
param primcount SizeI in value
DrawElementsInstancedARB(mode, count, type, indices, primcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param count SizeI in value
param type DrawElementsType in value
param indices Void in array [COMPSIZE(count/type)]
DrawArraysEXT(mode, first, count)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param first Int32 in value
param count SizeI in value
category EXT_vertex_array
###############################################################################
#
# Extension #51
-# SGIS_texture_select commands
-#
-# This used to be SGIX_texture_select, which was inconsistent with
-# enumext.spec and wrong according to the SGI extension spec.
+# SGIX_texture_select commands
#
###############################################################################
# (none)
-newcategory: SGIS_texture_select
-passthru: /* This used to be SGIX prefix, which was an error in the header */
+newcategory: SGIX_texture_select
###############################################################################
#
# Spec entries to be written
DrawRangeElementsEXT(mode, start, end, count, type, indices)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param start UInt32 in value
param end UInt32 in value
param count SizeI in value
# first and count are really 'in'
MultiDrawArraysEXT(mode, first, count, primcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param first Int32 in array [COMPSIZE(primcount)]
param count SizeI in array [COMPSIZE(primcount)]
param primcount SizeI in value
MultiDrawElementsEXT(mode, count, type, indices, primcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param count SizeI in array [COMPSIZE(primcount)]
param type DrawElementsType in value
param indices VoidPointer in array [COMPSIZE(primcount)]
#
###############################################################################
-newcategory: EXT_texture_compression_s3tc
+#@@ (none yet)
###############################################################################
#
MultiModeDrawArraysIBM(mode, first, count, primcount, modestride)
return void
- param mode PrimitiveType in array [COMPSIZE(primcount)]
+ param mode BeginMode in array [COMPSIZE(primcount)]
param first Int32 in array [COMPSIZE(primcount)]
param count SizeI in array [COMPSIZE(primcount)]
param primcount SizeI in value
MultiModeDrawElementsIBM(mode, count, type, indices, primcount, modestride)
return void
- param mode PrimitiveType in array [COMPSIZE(primcount)]
+ param mode BeginMode in array [COMPSIZE(primcount)]
param count SizeI in array [COMPSIZE(primcount)]
param type DrawElementsType in value
param indices ConstVoidPointer in array [COMPSIZE(primcount)]
glxflags ignore
offset 653
-###############################################################################
-#
-# Extension #223
-# IBM_static_data commands
-#
-###############################################################################
-
-FlushStaticDataIBM(target)
- return void
- param target GLenum in value
- category IBM_static_data
- version 1.0
- glxflags ignore
-
-###############################################################################
-#
-# Extension #224
-# IBM_texture_mirrored_repeat commands
-#
-###############################################################################
-# (none)
-newcategory: IBM_texture_mirrored_repeat
-
###############################################################################
#
# Extension #225
DrawElementArrayATI(mode, count)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param count SizeI in value
category ATI_element_array
dlflags handcode
DrawRangeElementArrayATI(mode, start, end, count)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param start UInt32 in value
param end UInt32 in value
param count SizeI in value
DrawMeshArraysSUN(mode, first, count, width)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param first Int32 in value
param count SizeI in value
param width SizeI in value
DrawElementArrayAPPLE(mode, first, count)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param first Int32 in value
param count SizeI in value
category APPLE_element_array
DrawRangeElementArrayAPPLE(mode, start, end, first, count)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param start UInt32 in value
param end UInt32 in value
param first Int32 in value
MultiDrawElementArrayAPPLE(mode, first, count, primcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param first Int32 in array [primcount]
param count SizeI in array [primcount]
param primcount SizeI in value
MultiDrawRangeElementArrayAPPLE(mode, start, end, first, count, primcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param start UInt32 in value
param end UInt32 in value
param first Int32 in array [primcount]
ClearDepthfOES(depth)
return void
- param depth ClampedFloat32 in value
+ param depth ClampedFloat64 in value
category OES_single_precision
version 4.3
extension
QueryMatrixxOES(mantissa, exponent)
return GLbitfield
- param mantissa Fixed out array [16]
- param exponent Int32 out array [16]
+ param mantissa ConstFixed in array [16]
+ param exponent ConstInt32 in array [16]
category OES_query_matrix
version 4.3
extension
DrawArraysInstancedEXT(mode, start, count, primcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param start Int32 in value
param count SizeI in value
param primcount SizeI in value
DrawElementsInstancedEXT(mode, count, type, indices, primcount)
return void
- param mode PrimitiveType in value
+ param mode BeginMode in value
param count SizeI in value
param type DrawElementsType in value
param indices Void in array [COMPSIZE(count/type)]
param params Int32 out array [COMPSIZE(pname)]
category EXT_texture_integer
dlflags notlistable
+ version 1.0
version 2.0
extension soft WINSOFT NV50
glfflags ignore
param params UInt32 out array [COMPSIZE(pname)]
category EXT_texture_integer
dlflags notlistable
+ version 1.0
version 2.0
extension soft WINSOFT NV50
glfflags ignore
param program UInt32 in value
param location Int32 in value
param count SizeI in value
- param value Float64 in array [count*2]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param program UInt32 in value
param location Int32 in value
param count SizeI in value
- param value Float64 in array [count*3]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param program UInt32 in value
param location Int32 in value
param count SizeI in value
- param value Float64 in array [count*4]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param location Int32 in value
param count SizeI in value
param transpose Boolean in value
- param value Float64 in array [count*4]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param location Int32 in value
param count SizeI in value
param transpose Boolean in value
- param value Float64 in array [count*9]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param location Int32 in value
param count SizeI in value
param transpose Boolean in value
- param value Float64 in array [count*16]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param location Int32 in value
param count SizeI in value
param transpose Boolean in value
- param value Float64 in array [count*6]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param location Int32 in value
param count SizeI in value
param transpose Boolean in value
- param value Float64 in array [count*8]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param location Int32 in value
param count SizeI in value
param transpose Boolean in value
- param value Float64 in array [count*6]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param location Int32 in value
param count SizeI in value
param transpose Boolean in value
- param value Float64 in array [count*12]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param location Int32 in value
param count SizeI in value
param transpose Boolean in value
- param value Float64 in array [count*8]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
param location Int32 in value
param count SizeI in value
param transpose Boolean in value
- param value Float64 in array [count*12]
+ param value Float64 in array [count]
category EXT_direct_state_access
subcategory ARB_gpu_shader_fp64
version 1.2
###############################################################################
#
# Extension #363
-# AMD_vertex_shader_tessellator commands
+# AMD_vertex_shader_tesselator commands
#
###############################################################################
TessellationFactorAMD(factor)
return void
param factor Float32 in value
- category AMD_vertex_shader_tessellator
+ category AMD_vertex_shader_tesselator
version 2.0
glxsingle ?
glxflags ignore
TessellationModeAMD(mode)
return void
param mode GLenum in value
- category AMD_vertex_shader_tessellator
+ category AMD_vertex_shader_tesselator
version 2.0
glxsingle ?
glxflags ignore
AccumOp,*,*, GLenum,*,*
AlphaFunction,*,*, GLenum,*,*
AttribMask,*,*, GLbitfield,*,*
+BeginMode,*,*, GLenum,*,*
BinormalPointerTypeEXT,*,*, GLenum,*,*
BlendEquationMode,*,*, GLenum,*,*
BlendEquationModeEXT,*,*, GLenum,*,*
CheckedInt32,*,*, GLint,*,*
ClampColorTargetARB,*,*, GLenum,*,*
ClampColorModeARB,*,*, GLenum,*,*
+ClampedColorF,*,*, GLclampf,*,*
ClampedFixed,*,*, GLfixed,*,*
ClampedFloat32,*,*, GLclampf,*,*
ClampedFloat64,*,*, GLclampd,*,*
CombinerStageNV,*,*, GLenum,*,*
CombinerVariableNV,*,*, GLenum,*,*
CompressedTextureARB,*,*, GLvoid,*,*
+ControlPointNV,*,*, GLvoid,*,*
+ControlPointTypeNV,*,*, GLenum,*,*
ConvolutionParameter,*,*, GLenum,*,*
ConvolutionParameterEXT,*,*, GLenum,*,*
ConvolutionTarget,*,*, GLenum,*,*
FragmentLightNameSGIX,*,*, GLenum,*,*
FragmentLightParameterSGIX,*,*, GLenum,*,*
FramebufferAttachment,*,*, GLenum,*,*
-FramebufferStatus,*,*, GLenum,*,*
FramebufferTarget,*,*, GLenum,*,*
FrontFaceDirection,*,*, GLenum,*,*
FunctionPointer,*,*, _GLfuncptr,*,*
MapAttribParameterNV,*,*, GLenum,*,*
MapParameterNV,*,*, GLenum,*,*
MapTarget,*,*, GLenum,*,*
+MapTargetNV,*,*, GLenum,*,*
MapTypeNV,*,*, GLenum,*,*
MaskedColorIndexValueF,*,*, GLfloat,*,*
MaskedColorIndexValueI,*,*, GLuint,*,*
MaterialParameter,*,*, GLenum,*,*
MatrixIndexPointerTypeARB,*,*, GLenum,*,*
MatrixMode,*,*, GLenum,*,*
+MatrixTransformNV,*,*, GLenum,*,*
MeshMode1,*,*, GLenum,*,*
MeshMode2,*,*, GLenum,*,*
MinmaxTarget,*,*, GLenum,*,*
MinmaxTargetEXT,*,*, GLenum,*,*
NormalPointerType,*,*, GLenum,*,*
+NurbsCallback,*,*, GLenum,*,*
+NurbsObj,*,*, GLUnurbs*,*,*
+NurbsProperty,*,*, GLenum,*,*
+NurbsTrim,*,*, GLenum,*,*
OcclusionQueryParameterNameNV,*,*, GLenum,*,*
PixelCopyType,*,*, GLenum,*,*
PixelFormat,*,*, GLenum,*,*
PixelType,*,*, GLenum,*,*
PointParameterNameARB,*,*, GLenum,*,*
PolygonMode,*,*, GLenum,*,*
-PrimitiveType,*,*, GLenum,*,*
+ProgramNV,*,*, GLuint,*,*
ProgramCharacterNV,*,*, GLubyte,*,*
+ProgramParameterNV,*,*, GLenum,*,*
ProgramParameterPName,*,*, GLenum,*,*
+QuadricCallback,*,*, GLenum,*,*
+QuadricDrawStyle,*,*, GLenum,*,*
+QuadricNormal,*,*, GLenum,*,*
+QuadricObj,*,*, GLUquadric*,*,*
+QuadricOrientation,*,*, GLenum,*,*
ReadBufferMode,*,*, GLenum,*,*
RenderbufferTarget,*,*, GLenum,*,*
RenderingMode,*,*, GLenum,*,*
ReplacementCodeSUN,*,*, GLuint,*,*
ReplacementCodeTypeSUN,*,*, GLenum,*,*
+SamplePassARB,*,*, GLenum,*,*
SamplePatternEXT,*,*, GLenum,*,*
SamplePatternSGIS,*,*, GLenum,*,*
SecondaryColorPointerTypeIBM,*,*, GLenum,*,*
String,*,*, const GLubyte *,*,*
StringName,*,*, GLenum,*,*
TangentPointerTypeEXT,*,*, GLenum,*,*
+TessCallback,*,*, GLenum,*,*
+TessContour,*,*, GLenum,*,*
+TessProperty,*,*, GLenum,*,*
+TesselatorObj,*,*, GLUtesselator*,*,*
TexCoordPointerType,*,*, GLenum,*,*
Texture,*,*, GLuint,*,*
TextureComponentCount,*,*, GLint,*,*
UInt8,*,*, GLubyte,*,*
VertexAttribEnum,*,*, GLenum,*,*
VertexAttribEnumNV,*,*, GLenum,*,*
+VertexAttribPointerTypeNV,*,*, GLenum,*,*
VertexPointerType,*,*, GLenum,*,*
VertexWeightPointerTypeEXT,*,*, GLenum,*,*
Void,*,*, GLvoid,*,*
WinCoord,*,*, GLint,*,*
void,*,*, *,*,*
ArrayObjectPNameATI,*,*, GLenum,*,*
-ArrayObjectUsageATI,*,*, GLenum,*,*
+ArrayObjectUsageATI,*,*, GLenum,*,*,
ConstByte,*,*, GLbyte,*,*
ConstUByte,*,*, GLubyte,*,*
ConstFloat32,*,*, GLfloat,*,*
handleARB,*,*, GLhandleARB,*,*
charARB,*,*, GLcharARB,*,*
charPointerARB,*,*, GLcharARB*,*,*
-sync,*,*, GLsync,*,*
+sync,*,*, GLsync,*,*,
# EXT_timer_query
Int64EXT,*,*, GLint64EXT,*,*
UInt64EXT,*,*, GLuint64EXT,*,*
# EXT_direct_state_access
FramebufferAttachmentParameterName,*,*, GLenum,*,*
Framebuffer,*,*, GLuint,*,*
+FramebufferStatus,*,*, GLenum,*,*
GetFramebufferParameter,*,*, GLenum,*,*
Intptr,*,*, GLintptr,*,*
ProgramFormat,*,*, GLenum,*,*
# AMD_debug_output
GLDEBUGPROCAMD,*,*, GLDEBUGPROCAMD,*,*
# NV_vdpau_interop
-vdpauSurfaceNV,*,*, GLvdpauSurfaceNV,*,*
+vdpauSurfaceNV,*,*, GLvdpauSurfaceNV,*,*,
# External API types
cl_context,*,*, struct _cl_context *,*,*
cl_event,*,*, struct _cl_event *,*,*
PathStringFormat,*,*, GLenum,*,*
PathTransformType,*,*, GLenum,*,*
PathHandleMissingGlyphs,*,*, GLenum,*,*
-
-# No longer used in gl.spec
-# ClampedColorF,*,*, GLclampf,*,*
-# ControlPointNV,*,*, GLvoid,*,*
-# ControlPointTypeNV,*,*, GLenum,*,*
-# MapTargetNV,*,*, GLenum,*,*
-# MatrixTransformNV,*,*, GLenum,*,*
-# ProgramNV,*,*, GLuint,*,*
-# ProgramParameterNV,*,*, GLenum,*,*
-# SamplePassARB,*,*, GLenum,*,*
-# VertexAttribPointerTypeNV,*,*, GLenum,*,*
-
-# Used only in glu.spec
-# NurbsCallback,*,*, GLenum,*,*
-# NurbsObj,*,*, GLUnurbs*,*,*
-# NurbsProperty,*,*, GLenum,*,*
-# NurbsTrim,*,*, GLenum,*,*
-# QuadricCallback,*,*, GLenum,*,*
-# QuadricDrawStyle,*,*, GLenum,*,*
-# QuadricNormal,*,*, GLenum,*,*
-# QuadricObj,*,*, GLUquadric*,*,*
-# QuadricOrientation,*,*, GLenum,*,*
-# TessCallback,*,*, GLenum,*,*
-# TessContour,*,*, GLenum,*,*
-# TessProperty,*,*, GLenum,*,*
-# TesselatorObj,*,*, GLUtesselator*,*,*
-# THIS FILE IS OBSOLETE. Please migrate away from using the
-# ".spec" files to the XML Registry. See
-# http://www.opengl.org/registry/api/README.txt
-# for more information.
-
# Copyright (c) 1991-2005 Silicon Graphics, Inc. All Rights Reserved.
-# Copyright (c) 2006-2013 The Khronos Group, Inc.
+# Copyright (c) 2006-2010 The Khronos Group, Inc.
#
# This document is licensed under the SGI Free Software B License Version
# 2.0. For details, see http://oss.sgi.com/projects/FreeB/ .
#
-# $Revision: 21963 $ on $Date: 2013-06-13 02:52:31 -0700 (Thu, 13 Jun 2013) $
+# $Revision: 17025 $ on $Date: 2012-03-05 03:01:59 -0800 (Mon, 05 Mar 2012) $
required-props:
param: retval retained
-# THIS FILE IS OBSOLETE. Please migrate away from using the
-# ".spec" files to the XML Registry. See
-# http://www.opengl.org/registry/api/README.txt
-# for more information.
-
-# This is the old (no longer canonical) GLX enumerant registry. It is
-# no longer maintained or used for current header file generation.
-
# Copyright (c) 1991-2005 Silicon Graphics, Inc. All Rights Reserved.
-# Copyright (c) 2006-2013 The Khronos Group, Inc.
+# Copyright (c) 2006-2010 The Khronos Group, Inc.
#
# This document is licensed under the SGI Free Software B License Version
# 2.0. For details, see http://oss.sgi.com/projects/FreeB/ .
#
-# $Revision: 21963 $ on $Date: 2013-06-13 02:52:31 -0700 (Thu, 13 Jun 2013) $
+# $Revision: 20030 $ on $Date: 2013-01-02 02:39:38 -0800 (Wed, 02 Jan 2013) $
+
+# This is the GLX enumerant registry.
+#
+# It is an extremely important file. Do not mess with it unless
+# you know what you're doing and have permission to do so.
+#
+# Rules for modification are the same as the rules for the OpenGL
+# enumerant registry (gl.spec). Basically, don't modify this
+# file unless you're the Khronos API Registrar.
Extensions define:
VERSION_1_1 = 1
-# THIS FILE IS OBSOLETE. Please migrate away from using the
-# ".spec" files to the XML Registry. See
-# http://www.opengl.org/registry/api/README.txt
-# for more information.
-
# Copyright (c) 1991-2005 Silicon Graphics, Inc. All Rights Reserved.
-# Copyright (c) 2006-2013 The Khronos Group, Inc.
+# Copyright (c) 2006-2010 The Khronos Group, Inc.
#
# This document is licensed under the SGI Free Software B License Version
# 2.0. For details, see http://oss.sgi.com/projects/FreeB/ .
#
-# $Revision: 21963 $ on $Date: 2013-06-13 02:52:31 -0700 (Thu, 13 Jun 2013) $
+# $Revision: 20030 $ on $Date: 2013-01-02 02:39:38 -0800 (Wed, 02 Jan 2013) $
# List of GLX enumerants for glxext.h header
#
-# This is derived from the deprecated GLX enumerant registry (glxenum.spec).
+# This is NOT the master GLX enumerant registry (glxenum.spec).
#
# Unlike glxenum.spec, glxenumext.spec is
# (1) In order by extension number.
passthru:
passthru: /* Header file version number, required by OpenGL ABI for Linux */
-passthru: /* glxext.h last updated 2013/06/10 */
+passthru: /* glxext.h last updated 2013/01/02 */
passthru: /* Current version at http://www.opengl.org/registry/ */
-passthru: #define GLX_GLXEXT_VERSION 36
+passthru: #define GLX_GLXEXT_VERSION 34
###############################################################################
#
-# THIS FILE IS OBSOLETE. Please migrate away from using the
-# ".spec" files to the XML Registry. See
-# http://www.opengl.org/registry/api/README.txt
-# for more information.
-#
-
# Copyright (c) 1991-2002 Silicon Graphics, Inc. All Rights Reserved.
-# Copyright (c) 2006-2013 The Khronos Group, Inc.
+# Copyright (c) 2006-2010 The Khronos Group, Inc.
#
# This document is licensed under the SGI Free Software B License Version
# 2.0. For details, see http://oss.sgi.com/projects/FreeB/ .
#
-# $Revision: 21963 $ on $Date: 2013-06-13 02:52:31 -0700 (Thu, 13 Jun 2013) $
+# $Revision: 10796 $ on $Date: 2010-03-19 17:31:10 -0700 (Fri, 19 Mar 2010) $
required-props:
param: retval retained
param ipfd int in value
param cjpfd UINT in value
param ppfd PIXELFORMATDESCRIPTOR in reference
- category wgl
GetCurrentDC( )
return HDC
-# THIS FILE IS OBSOLETE. Please migrate away from using the
-# ".spec" files to the XML Registry. See
-# http://www.opengl.org/registry/api/README.txt
-# for more information.
-
# Copyright (c) 1991-2005 Silicon Graphics, Inc. All Rights Reserved.
-# Copyright (c) 2006-2013 The Khronos Group, Inc.
+# Copyright (c) 2006-2010 The Khronos Group, Inc.
#
# This document is licensed under the SGI Free Software B License Version
# 2.0. For details, see http://oss.sgi.com/projects/FreeB/ .
#
-# $Revision: 21963 $ on $Date: 2013-06-13 02:52:31 -0700 (Thu, 13 Jun 2013) $
-
-# This is the old (no longer canonical) WGL enumerant registry. It is
-# no longer maintained or used for current header file generation.
+# $Revision: 17770 $ on $Date: 2012-05-10 14:18:27 -0700 (Thu, 10 May 2012) $
-# Note that this registry does not currently include
+# This is the master WGL enumerant registry.
+#
+# It is an extremely important file. Do not mess with it unless
+# you know what you're doing and have permission to do so.
+#
+# Rules for modification are similar to the rules for the OpenGL
+# enumerant registry (gl.spec). Basically, don't modify this file
+# unless you're Khronos API Registrar. In principle Microsoft owns
+# the WGL registry, but they have for practical purposes ceded
+# administration of it to Khronos.
+#
+# Finally, note that this registry does not currently include
# any core WGL enumerants - only enumerants defined by WGL
# extensions.
WGL_UNIQUE_ID_NV = 0x20CE
WGL_NUM_VIDEO_CAPTURE_SLOTS_NV = 0x20CF
-WGL_NV_gpu_affinity enum:
- ERROR_INCOMPATIBLE_AFFINITY_MASKS_NV = 0x20D0
- ERROR_MISSING_AFFINITY_MASK_NV = 0x20D1
+WGL_NV_gpu_affinity:
+ WGL_ERROR_INCOMPATIBLE_AFFINITY_MASKS_NV = 0x20D0
+ WGL_ERROR_MISSING_AFFINITY_MASK_NV = 0x20D1
# NV_future_use: 0x20D2-0x20EF
# Also includes a bitmask - see ContextFlags above
# All values are shared with GLX and GL
-WGL_ARB_create_context_robustness enum:
+WGL_ARB_create_context_robustness:
WGL_LOSE_CONTEXT_ON_RESET_ARB = 0x8252 # shared with GLX and GL
WGL_CONTEXT_RESET_NOTIFICATION_STRATEGY_ARB = 0x8256 # shared with GLX and GL
WGL_NO_RESET_NOTIFICATION_ARB = 0x8261 # shared with GLX and GL
-# THIS FILE IS OBSOLETE. Please migrate away from using the
-# ".spec" files to the XML Registry. See
-# http://www.opengl.org/registry/api/README.txt
-# for more information.
-
# Copyright (c) 1991-2005 Silicon Graphics, Inc. All Rights Reserved.
-# Copyright (c) 2006-2013 The Khronos Group, Inc.
+# Copyright (c) 2006-2010 The Khronos Group, Inc.
#
# This document is licensed under the SGI Free Software B License Version
# 2.0. For details, see http://oss.sgi.com/projects/FreeB/ .
#
-# $Revision: 21963 $ on $Date: 2013-06-13 02:52:31 -0700 (Thu, 13 Jun 2013) $
+# $Revision: 17027 $ on $Date: 2012-03-05 11:19:50 -0800 (Mon, 05 Mar 2012) $
# List of WGL enumerants for wglext.h header
#
-# This is derived from the deprecated WGL enumerant registry (wglenum.spec).
+# This is not the master WGL enumerant registry. Microsoft used
+# to maintain that, but given their limited interest in OpenGL, the
+# Khronos API Registrar maintains the registry in wglenum.spec.
#
# Unlike wglenum.spec, wglenumext.spec is
# (1) In order by extension number
passthru:
passthru: /* Header file version number */
-passthru: /* wglext.h last updated 2013/06/10 */
+passthru: /* wglext.h last updated 2012/01/04 */
passthru: /* Current version at http://www.opengl.org/registry/ */
-passthru: #define WGL_WGLEXT_VERSION 26
+passthru: #define WGL_WGLEXT_VERSION 24
###############################################################################
#
# Extension #355
WGL_NV_gpu_affinity enum:
- ERROR_INCOMPATIBLE_AFFINITY_MASKS_NV = 0x20D0
- ERROR_MISSING_AFFINITY_MASK_NV = 0x20D1
+ WGL_ERROR_INCOMPATIBLE_AFFINITY_MASKS_NV = 0x20D0
+ WGL_ERROR_MISSING_AFFINITY_MASK_NV = 0x20D1
###############################################################################
HCoop / clinton / guile-figl.git / commitdiff