Gambas Documentation
Application Repository
Code Snippets
Compilation & Installation
Components
gb
gb.args
gb.cairo
gb.chart
gb.clipper
gb.complex
gb.compress
gb.crypt
gb.data
gb.db
gb.db.form
gb.db.mysql
gb.db.odbc
gb.db.postgresql
gb.db.sqlite2
gb.db.sqlite3
gb.dbus
gb.dbus.trayicon
gb.debug
gb.desktop
gb.desktop.gnome.keyring
gb.desktop.x11
gb.eval
gb.eval.highlight
gb.form
gb.form.dialog
gb.form.editor
gb.form.htmlview
gb.form.mdi
gb.form.print
gb.form.stock
gb.form.terminal
gb.gmp
gb.gsl
gb.gtk
gb.gtk.opengl
gb.gtk3
gb.gtk3.opengl
gb.gtk3.webview
gb.gui
gb.gui.opengl
gb.gui.qt
gb.gui.qt.ext
gb.gui.qt.opengl
gb.gui.qt.webkit
gb.gui.trayicon
gb.gui.webview
gb.hash
gb.highlight
gb.image
gb.image.effect
gb.image.imlib
gb.image.io
gb.inotify
gb.jit
gb.libxml
gb.logging
gb.map
gb.markdown
gb.media
gb.media.form
gb.memcached
gb.mime
gb.mysql
gb.ncurses
gb.net
gb.net.curl
gb.net.pop3
gb.net.smtp
gb.openal
gb.opengl
gears.png
Gl
Accum
ACCUM_
ACCUM_ALPHA_BITS
ACCUM_BLUE_BITS
ACCUM_BUFFER_BIT
ACCUM_CLEAR_VALUE
ACCUM_GREEN_BITS
ACCUM_RED_BITS
ActiveTexture
ADD
ADD_SIGNED_ARB
ALL_ATTRIB_BITS
ALPHA
ALPHA_BIAS
ALPHA_BITS
ALPHA_SCALE
ALPHA_TEST
ALPHA_TEST_FUNC
ALPHA_TEST_REF
AlphaFunc
ALWAYS
AMBIENT
AMBIENT_AND_DIFFUSE
AND
AND_INVERTED
AND_REVERSE
ARRAY_BUFFER
ATTRIB_STACK_DEPTH
AUTO_NORMAL
AUX0
AUX1
AUX2
AUX3
AUX_BUFFERS
BACK
BACK_LEFT
BACK_RIGHT
Begin
BGR
BGRA
BindFramebufferEXT
BindRenderbufferEXT
BindTexture
BITMAP_
BITMAP_TOKEN
BLEND
BLEND_DST
BLEND_SRC
BlendFunc
BLUE
BLUE_BIAS
BLUE_BITS
BLUE_SCALE
CallList
CallLists
CCW
CheckExtensions
CheckFramebufferStatusEXT
CLAMP
Clear
CLEAR_
ClearAccum
ClearColor
ClearDepth
ClearIndex
ClearStencil
CLIENT_ATTRIB_STACK_DEPTH
CLIP_PLANE0
CLIP_PLANE1
CLIP_PLANE2
CLIP_PLANE3
CLIP_PLANE4
CLIP_PLANE5
ClipPlane
COEFF
COLOR
Color3f
Color3i
Color4f
Color4i
COLOR_ARRAY
COLOR_ATTACHMENT0_EXT
COLOR_ATTACHMENT1_EXT
COLOR_ATTACHMENT2_EXT
COLOR_ATTACHMENT3_EXT
COLOR_ATTACHMENT4_EXT
COLOR_ATTACHMENT5_EXT
COLOR_ATTACHMENT6_EXT
COLOR_ATTACHMENT7_EXT
COLOR_ATTACHMENT8_EXT
COLOR_ATTACHMENT9_EXT
COLOR_ATTACHMENT10_EXT
COLOR_ATTACHMENT11_EXT
COLOR_ATTACHMENT12_EXT
COLOR_ATTACHMENT13_EXT
COLOR_ATTACHMENT14_EXT
COLOR_ATTACHMENT15_EXT
COLOR_BUFFER_BIT
COLOR_CLEAR_VALUE
COLOR_INDEX
COLOR_INDEXES
COLOR_LOGIC_OP
COLOR_MATERIAL
COLOR_MATERIAL_FACE
COLOR_MATERIAL_PARAMETER
COLOR_WRITEMASK
Colorf
Colorfv
Colori
Coloriv
ColorMask
ColorMaterial
COMBINE
COMBINE_ALPHA
COMBINE_ALPHA_ARB
COMBINE_ALPHA_EXT
COMBINE_ARB
COMBINE_EXT
COMBINE_RGB
COMBINE_RGB_ARB
COMBINE_RGB_EXT
COMPILE
COMPILE_AND_EXECUTE
COMPRESSED_RGBA
COMPRESSED_RGBA_S3TC_DXT1_EXT
COMPRESSED_RGBA_S3TC_DXT3_EXT
COMPRESSED_RGBA_S3TC_DXT5_EXT
CONSTANT_ARB
CONSTANT_ATTENUATION
COPY
COPY_INVERTED
COPY_PIXEL_TOKEN
CopyPixels
CopyTexImage1D
CopyTexImage2D
CULL_FACE
CULL_FACE_MODE
CullFace
CURRENT_BIT
CURRENT_COLOR
CURRENT_INDEX
CURRENT_NORMAL
CURRENT_QUERY
CURRENT_RASTER_COLOR
CURRENT_RASTER_DISTANCE
CURRENT_RASTER_INDEX
CURRENT_RASTER_POSITION
CURRENT_RASTER_POSITION_VALID
CURRENT_RASTER_TEXTURE_COORDS
CURRENT_TEXTURE_COORDS
CW
DECAL
DECR
DeleteFramebuffersEXT
DeleteLists
DeleteRenderbuffersEXT
DeleteTextures
DEPTH
DEPTH_ATTACHMENT_EXT
DEPTH_BIAS
DEPTH_BITS
DEPTH_BUFFER_BIT
DEPTH_CLEAR_VALUE
DEPTH_COMPONENT
DEPTH_FUNC
DEPTH_RANGE
DEPTH_SCALE
DEPTH_TEST
DEPTH_WRITEMASK
DepthFunc
DepthMask
DepthRange
DIFFUSE
Disable
DITHER
DOMAIN
DONT_CARE
DOUBLE
DOUBLEBUFFER
DRAW_BUFFER
DRAW_PIXEL_TOKEN
DrawBuffer
DrawPixels
DST_ALPHA
DST_COLOR
EDGE_FLAG
EdgeFlag
ELEMENT_ARRAY_BUFFER
EMISSION
Enable
ENABLE_BIT
End
EndList
EQUAL
EQUIV
EVAL_BIT
EvalCoord1f
EvalCoord2f
EvalCoord2fv
EvalMesh1
EvalMesh2
EvalPoint1
EvalPoint2
EXP
EXP2
EXTENSIONS
EYE_LINEAR
EYE_PLANE
FALSE
FASTEST
FEEDBACK
FEEDBACK_BUFFER_POINTER
FEEDBACK_BUFFER_SIZE
FEEDBACK_BUFFER_TYPE
FeedbackBuffer
FILL
Finish
FLAT
FLOAT
Flush
FOG
FOG_BIT
FOG_COLOR
FOG_DENSITY
FOG_END
FOG_HINT
FOG_INDEX
FOG_MODE
FOG_START
Fogf
Fogfv
Fogi
Fogiv
FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_EXT
FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_EXT
FRAMEBUFFER_ATTACHMENT_TEXTURE_3D_ZOFFSET_EXT
FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE_EXT
FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL_EXT
FRAMEBUFFER_BINDING_EXT
FRAMEBUFFER_COMPLETE_EXT
FRAMEBUFFER_EXT
FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT
FRAMEBUFFER_INCOMPLETE_DIMENSIONS_EXT
FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER_EXT
FRAMEBUFFER_INCOMPLETE_FORMATS_EXT
FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT_EXT
FRAMEBUFFER_INCOMPLETE_READ_BUFFER_EXT
FRAMEBUFFER_UNSUPPORTED_EXT
FramebufferRenderbufferEXT
FramebufferTexture1DEXT
FramebufferTexture2DEXT
FramebufferTexture3DEXT
FRONT
FRONT_AND_BACK
FRONT_FACE
FRONT_LEFT
FRONT_RIGHT
FrontFace
Frustum
GENERATE_MIPMAP
GenerateMipmapEXT
GenFramebuffersEXT
GenLists
GenRenderbuffersEXT
GenTextures
GEQUAL
GetBooleanv
GetClipPlane
GetError
GetFloatv
GetFramebufferAttachmentParameterivEXT
GetIntegerv
GetLightfv
GetLightiv
GetMaterialfv
GetMaterialiv
GetRenderbufferParameterivEXT
GetString
GREATER
GREEN
GREEN_BIAS
GREEN_BITS
GREEN_SCALE
Hint
HINT_BIT
INCR
INDEX_BITS
INDEX_CLEAR_VALUE
INDEX_LOGIC_OP
INDEX_MODE
INDEX_OFFSET
INDEX_SHIFT
INDEX_WRITEMASK
Indexf
Indexi
IndexMask
InitNames
INTEGER
INTERPOLATE_ARB
INVALID_ENUM
INVALID_FRAMEBUFFER_OPERATION_EXT
INVALID_OPERATION
INVALID_VALUE
INVERT
IsEnabled
IsFramebufferEXT
IsList
IsRenderbufferEXT
IsTexture
KEEP
LEFT
LEQUAL
LESS
LIGHT0
LIGHT1
LIGHT2
LIGHT3
LIGHT4
LIGHT5
LIGHT6
LIGHT7
LIGHT_MODEL_AMBIENT
LIGHT_MODEL_LOCAL_VIEWER
LIGHT_MODEL_TWO_SIDE
Lightf
Lightfv
Lighti
LIGHTING
LIGHTING_BIT
Lightiv
LightModelf
LightModelfv
LightModeli
LightModeliv
LINE
LINE_BIT
LINE_LOOP
LINE_RESET_TOKEN
LINE_SMOOTH
LINE_SMOOTH_HINT
LINE_STIPPLE
LINE_STIPPLE_PATTERN
LINE_STIPPLE_REPEAT
LINE_STRIP
LINE_TOKEN
LINE_WIDTH
LINEAR
LINEAR_ATTENUATION
LINEAR_MIPMAP_LINEAR
LINEAR_MIPMAP_NEAREST
LINES
LineStipple
LineWidth
LIST_BASE
LIST_BIT
LIST_INDEX
LIST_MODE
ListBase
LOAD
LoadIdentity
LoadMatrixf
LoadName
LOGIC_OP
LOGIC_OP_MODE
LogicOp
LUMINANCE
LUMINANCE_ALPHA
MAP1_COLOR_4
MAP1_GRID_DOMAIN
MAP1_GRID_SEGMENTS
MAP1_INDEX
MAP1_NORMAL
MAP1_TEXTURE_COORD_1
MAP1_TEXTURE_COORD_2
MAP1_TEXTURE_COORD_3
MAP1_TEXTURE_COORD_4
MAP1_VERTEX_3
MAP1_VERTEX_4
Map1f
MAP2_COLOR_4
MAP2_GRID_DOMAIN
MAP2_GRID_SEGMENTS
MAP2_INDEX
MAP2_NORMAL
MAP2_TEXTURE_COORD_1
MAP2_TEXTURE_COORD_2
MAP2_TEXTURE_COORD_3
MAP2_TEXTURE_COORD_4
MAP2_VERTEX_3
MAP2_VERTEX_4
Map2f
MAP_COLOR
MAP_STENCIL
MapGrid1f
MapGrid2f
Materialf
Materialfv
Materiali
Materialiv
MATRIX_MODE
MatrixMode
MAX_ATTRIB_STACK_DEPTH
MAX_CLIENT_ATTRIB_STACK_DEPTH
MAX_CLIP_PLANES
MAX_COLOR_ATTACHMENTS_EXT
MAX_EVAL_ORDER
MAX_LIGHTS
MAX_LIST_NESTING
MAX_MODELVIEW_STACK_DEPTH
MAX_NAME_STACK_DEPTH
MAX_PIXEL_MAP_TABLE
MAX_PROJECTION_STACK_DEPTH
MAX_RECTANGLE_TEXTURE_SIZE_ARB
MAX_RENDERBUFFER_SIZE_EXT
MAX_TEXTURE_SIZE
MAX_TEXTURE_STACK_DEPTH
MAX_VIEWPORT_DIMS
MODELVIEW
MODELVIEW_MATRIX
MODELVIEW_STACK_DEPTH
MODULATE
MULT
MultiTexCoord2f
MultMatrixf
NAME_STACK_DEPTH
NAND
NEAREST
NEAREST_MIPMAP_LINEAR
NEAREST_MIPMAP_NEAREST
NEVER
NewList
NICEST
NO_ERROR
NONE
NOOP
NOR
Normal3f
Normal3fv
Normal3i
Normal3iv
NORMAL_ARRAY
NORMALIZE
NOTEQUAL
OBJECT_LINEAR
OBJECT_PLANE
ONE
ONE_MINUS_DST_ALPHA
ONE_MINUS_DST_COLOR
ONE_MINUS_SRC_ALPHA
ONE_MINUS_SRC_COLOR
OPERAND0_ALPHA_ARB
OPERAND0_RGB_ARB
OPERAND1_ALPHA_ARB
OPERAND1_RGB_ARB
OPERAND2_ALPHA_ARB
OPERAND2_RGB_ARB
OR
OR_INVERTED
OR_REVERSE
ORDER
Ortho
OUT_OF_MEMORY
PACK_ALIGNMENT
PACK_LSB_FIRST
PACK_ROW_LENGTH
PACK_SKIP_PIXELS
PACK_SKIP_ROWS
PACK_SWAP_BYTES
PASS_THROUGH_TOKEN
PassThrough
PERSPECTIVE_CORRECTION_HINT
PIXEL_MAP_A_TO_A
PIXEL_MAP_A_TO_A_SIZE
PIXEL_MAP_B_TO_B
PIXEL_MAP_B_TO_B_SIZE
PIXEL_MAP_G_TO_G
PIXEL_MAP_G_TO_G_SIZE
PIXEL_MAP_I_TO_A
PIXEL_MAP_I_TO_A_SIZE
PIXEL_MAP_I_TO_B
PIXEL_MAP_I_TO_B_SIZE
PIXEL_MAP_I_TO_G
PIXEL_MAP_I_TO_G_SIZE
PIXEL_MAP_I_TO_I
PIXEL_MAP_I_TO_I_SIZE
PIXEL_MAP_I_TO_R
PIXEL_MAP_I_TO_R_SIZE
PIXEL_MAP_R_TO_R
PIXEL_MAP_R_TO_R_SIZE
PIXEL_MAP_S_TO_S
PIXEL_MAP_S_TO_S_SIZE
PIXEL_MODE_BIT
PixelStoref
PixelStorei
PixelTransferf
PixelTransferi
POINT
POINT_BIT
POINT_SIZE
POINT_SMOOTH
POINT_SMOOTH_HINT
POINT_TOKEN
POINTS
PointSize
POLYGON
POLYGON_BIT
POLYGON_MODE
POLYGON_OFFSET_FACTOR
POLYGON_OFFSET_FILL
POLYGON_OFFSET_LINE
POLYGON_OFFSET_POINT
POLYGON_OFFSET_UNITS
POLYGON_SMOOTH
POLYGON_SMOOTH_HINT
POLYGON_STIPPLE
POLYGON_STIPPLE_BIT
POLYGON_TOKEN
PolygonMode
PolygonOffset
PopMatrix
PopName
POSITION
PREVIOUS_ARB
PRIMARY_COLOR_ARB
PRIMITIVES_GENERATED
PROJECTION
PROJECTION_MATRIX
PROJECTION_STACK_DEPTH
PROXY_TEXTURE_RECTANGLE_ARB
PushMatrix
PushName
Q
QUAD_STRIP
QUADRATIC_ATTENUATION
QUADS
QUERY_COUNTER_BITS
QUERY_RESULT
R
RasterPos2f
RasterPos2i
RasterPos3f
RasterPos3i
RasterPos4f
RasterPos4i
RasterPosf
RasterPosfv
RasterPosi
RasterPosiv
READ_BUFFER
ReadBuffer
Rectf
Recti
RED
RED_BIAS
RED_BITS
RED_SCALE
RENDER
RENDER_MODE
RENDERBUFFER_ALPHA_SIZE_EXT
RENDERBUFFER_BINDING_EXT
RENDERBUFFER_BLUE_SIZE_EXT
RENDERBUFFER_DEPTH_SIZE_EXT
RENDERBUFFER_EXT
RENDERBUFFER_GREEN_SIZE_EXT
RENDERBUFFER_HEIGHT_EXT
RENDERBUFFER_INTERNAL_FORMAT_EXT
RENDERBUFFER_RED_SIZE_EXT
RENDERBUFFER_STENCIL_SIZE_EXT
RENDERBUFFER_WIDTH_EXT
RenderbufferStorageEXT
RENDERER
RenderMode
REPEAT
REPLACE
RETURN
RGB
RGB_SCALE_ARB
RGBA
RGBA_MODE
RIGHT
Rotatef
S
SAMPLER_2D_RECT_ARB
SAMPLER_2D_RECT_SHADOW_ARB
SAMPLES_PASSED
Scalef
Scissor
SCISSOR_BIT
SCISSOR_BOX
SCISSOR_TEST
SELECT
SelectBuffer
SELECTION_BUFFER_POINTER
SELECTION_BUFFER_SIZE
SET
SHADE_MODEL
ShadeModel
SHADING_LANGUAGE_VERSION
SHININESS
SMOOTH
SMOOTH_LINE_WIDTH_GRANULARITY
SMOOTH_LINE_WIDTH_RANGE
SMOOTH_POINT_SIZE_GRANULARITY
SMOOTH_POINT_SIZE_RANGE
SOURCE0_ALPHA_ARB
SOURCE0_RGB_ARB
SOURCE1_ALPHA_ARB
SOURCE1_RGB_ARB
SOURCE2_ALPHA_ARB
SOURCE2_RGB_ARB
SPECULAR
SPHERE_MAP
SPOT_CUTTOFF
SPOT_DIRECTION
SPOT_EXPONENT
SRC_ALPHA
SRC_ALPHA_SATURATE
SRC_COLOR
STACK_OVERFLOW
STACK_UNDERFLOW
STATIC_DRAW
STENCIL
STENCIL_ATTACHMENT_EXT
STENCIL_BITS
STENCIL_BUFFER_BIT
STENCIL_CLEAR_VALUE
STENCIL_FAIL
STENCIL_FUNC
STENCIL_INDEX
STENCIL_INDEX1_EXT
STENCIL_INDEX4_EXT
STENCIL_INDEX8_EXT
STENCIL_INDEX16_EXT
STENCIL_PASS_DEPTH_FAIL
STENCIL_PASS_DEPTH_PASS
STENCIL_REF
STENCIL_TEST
STENCIL_VALUE_MASK
STENCIL_WRITEMASK
StencilFunc
StencilMask
StencilOp
STEREO
SUBPIXEL_BITS
SUBTRACT_ARB
T
TexCoord1f
TexCoord1i
TexCoord2f
TexCoord2i
TexCoord3f
TexCoord3i
TexCoord4f
TexCoord4i
TexCoordf
TexCoordi
TexEnvf
TexEnvfv
TexEnvi
TexEnviv
TexGeni
TexImage1D
TexImage2D
TexParameterf
TexParameterfv
TexParameteri
TexParameteriv
TexSubImage1D
TexSubImage2D
TEXTURE
TEXTURE0
TEXTURE0_ARB
TEXTURE1
TEXTURE1_ARB
TEXTURE2
TEXTURE2_ARB
TEXTURE3
TEXTURE3_ARB
TEXTURE4
TEXTURE4_ARB
TEXTURE_1D
TEXTURE_2D
TEXTURE_ALPHA_SIZE
TEXTURE_BINDING_RECTANGLE_ARB
TEXTURE_BIT
TEXTURE_BLUE_SIZE
TEXTURE_BORDER
TEXTURE_BORDER_COLOR
TEXTURE_COMPONENTS
TEXTURE_COORD_ARRAY
TEXTURE_ENV
TEXTURE_ENV_COLOR
TEXTURE_ENV_MODE
TEXTURE_GEN_MODE
TEXTURE_GEN_Q
TEXTURE_GEN_R
TEXTURE_GEN_S
TEXTURE_GEN_T
TEXTURE_GREEN_SIZE
TEXTURE_HEIGHT
TEXTURE_INTENSITY_SIZE
TEXTURE_LUMINANCE_SIZE
TEXTURE_MAG_FILTER
TEXTURE_MATRIX
TEXTURE_MAX_LEVEL
TEXTURE_MIN_FILTER
TEXTURE_RECTANGLE_ARB
TEXTURE_RED_SIZE
TEXTURE_STACK_DEPTH
TEXTURE_WIDTH
TEXTURE_WRAP_S
TEXTURE_WRAP_T
TRANSFORM_BIT
TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN
Translatef
TRIANGLE_FAN
TRIANGLE_STRIP
TRIANGLES
TRUE
UNPACK_ALIGNMENT
UNPACK_LSB_FIRST
UNPACK_ROW_LENGTH
UNPACK_SKIP_PIXELS
UNPACK_SKIP_ROWS
UNPACK_SWAP_BYTES
UNSIGNED_BYTE
UNSIGNED_INT
VENDOR
VERSION
Vertex2f
Vertex2i
Vertex3f
Vertex3i
Vertex4f
Vertex4i
VERTEX_ARRAY
Vertexf
Vertexfv
Vertexi
Vertexiv
Viewport
VIEWPORT_
VIEWPORT_BIT
XOR
ZERO
ZOOM_X
ZOOM_Y
gb.opengl.glsl
gb.opengl.glu
gb.opengl.sge
gb.openssl
gb.option
gb.pcre
gb.pdf
gb.poppler
gb.qt4
gb.qt4.ext
gb.qt4.opengl
gb.qt4.webkit
gb.qt4.webview
gb.qt5
gb.qt5.ext
gb.qt5.opengl
gb.qt5.webkit
gb.qt5.webview
gb.qt6
gb.qt6.ext
gb.qt6.opengl
gb.qt6.webview
gb.report
gb.report2
gb.scanner
gb.sdl
gb.sdl.sound
gb.sdl2
gb.sdl2.audio
gb.settings
gb.signal
gb.term
gb.test
gb.util
gb.util.web
gb.v4l
gb.vb
gb.web
gb.web.feed
gb.web.form
gb.web.gui
gb.xml
gb.xml.html
gb.xml.rpc
gb.xml.xslt
Controls pictures
Deprecated components
Developer Documentation
Development Environment Documentation
Documents
Error Messages
Gambas Playground
How To's
Language Index
Language Overviews
Last Changes
Lexicon
README
Search the wiki
To Do
Topics
Tutorials
Wiki License
Wiki Manual

Gl.Lightfv (gb.opengl)

Static Sub Lightfv ( Light As Integer, Pname As Integer, Params As Float[] )

Set light source parameters.

Parameters

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 Gl.LIGHT i, where i ranges from 0 to the value of Gl.MAX_LIGHTS - 1.
pname

Specifies a single-valued light source parameter for light. Gl.SPOT_EXPONENT, Gl.SPOT_CUTOFF, Gl.CONSTANT_ATTENUATION, Gl.LINEAR_ATTENUATION, and Gl.QUADRATIC_ATTENUATION are accepted.
param

Specifies the value that parameter pname of light source light will be set to.

Parameters

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 Gl.LIGHT i, where i ranges from 0 to the value of Gl.MAX_LIGHTS - 1.
pname

Specifies a light source parameter for light. Gl.AMBIENT, Gl.DIFFUSE, Gl.SPECULAR, Gl.POSITION, Gl.SPOT_CUTOFF, Gl.SPOT_DIRECTION, Gl.SPOT_EXPONENT, Gl.CONSTANT_ATTENUATION, Gl.LINEAR_ATTENUATION, and Gl.QUADRATIC_ATTENUATION are accepted.
params

Specifies a pointer to the value or values that parameter pname of light source light will be set to.

Description

Gl.Light 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.

To enable and disable lighting calculation, call Gl.Enable and Gl.Disable 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 Gl.Enable and Gl.Disable 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 linearly such that the most positive representable value maps to 1.0, and the most negative representable value maps to -1.0 . Floating-point values are mapped directly. Neither integer nor floating-point values are clamped. The initial ambient light intensity is (0, 0, 0, 1).
Gl.DIFFUSE

params contains four integer or floating-point values that specify the diffuse RGBA intensity of the light. Integer values are mapped linearly such that the most positive representable value maps to 1.0, and the most negative representable value maps to -1.0 . Floating-point values are mapped directly. Neither integer nor floating-point values are clamped. The initial value for 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 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 integer nor floating-point values are clamped.

The position is transformed by the modelview matrix when Gl.Light is called (just as if it were a point), and it is stored in eye coordinates. If the w component of the position is 0, the light is treated as a directional source. Diffuse and specular lighting calculations take the light's direction, but not its actual position, into account, and attenuation is disabled. Otherwise, diffuse and specular lighting calculations are based on the actual location of the light in eye coordinates, and attenuation is enabled. The initial position is (0, 0, 1, 0); thus, the initial light source is directional, parallel to, and in the direction of the - z axis.
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 integer nor floating-point values are clamped.

The spot direction is transformed by the upper 3x3 of the modelview matrix when Gl.Light 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 .
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.

Effective light intensity is attenuated by the cosine of the angle between the direction of the light and the direction from the light to the vertex being lighted, raised to the power of the spot exponent. Thus, higher spot exponents result in a more focused light source, regardless of the spot cutoff angle (see 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.
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, its intensity is attenuated by the reciprocal of the sum of the constant factor, the linear factor times the distance between the light and the vertex being lighted, and the quadratic factor times the square of the same distance. The initial attenuation factors are (1, 0, 0), resulting in no attenuation.

Notes

It is always the case that Gl.LIGHT i = Gl.LIGHT0 + i.

Errors

Gl.INVALID_ENUM is generated if either light or pname is not an accepted value.

Gl.INVALID_VALUE is generated if a spot exponent value is specified outside the range 0 128 , or if spot cutoff is specified outside the range 0 90 (except for the special value 180), or if a negative attenuation factor is specified.

Gl.INVALID_OPERATION is generated if Gl.Light is executed between the execution of Gl.Begin and the corresponding execution of Gl.End.

Associated Gets

Gl.GetLight

Gl.IsEnabled with argument Gl.LIGHTING

See also

Gl.LightModel, Gl.Material

See original documentation on OpenGL website