funzione glLightiv
La funzione glLightiv restituisce i valori dei parametri di origine luce.
void WINAPI glLightiv(
GLenum light,
GLenum pname,
const GLint *params
);
-
light
-
Identificatore di una luce. Il numero di luci possibili dipende dall'implementazione, ma sono supportate almeno otto luci. Sono identificati dai nomi simbolici del modulo GL_LIGHTi dove i è un valore: da 0 a GL_MAX_LIGHTS - 1.
-
Pname
-
Parametro della sorgente di luce per la luce. Vengono accettati i nomi simbolici seguenti.
Valore Significato - GL_AMBIENT
Il parametro params contiene quattro valori interi che specificano l'intensità RGBA ambientale della luce. I valori integer vengono mappati in modo lineare in modo che il valore rappresentabile più positivo sia mappato a 1,0 e che il valore rappresentabile più negativo sia mappato a -1,0. I valori a virgola mobile vengono mappati direttamente. I valori integer e a virgola mobile non sono bloccati. L'intensità di luce ambientale predefinita è (0,0, 0,0, 0,0, 1,0). - GL_DIFFUSE
Il parametro params contiene quattro valori interi che specificano l'intensità RGBA diffusa della luce. I valori integer vengono mappati in modo lineare in modo che il valore rappresentabile più positivo sia mappato a 1,0 e che il valore rappresentabile più negativo sia mappato a -1,0. I valori a virgola mobile vengono mappati direttamente. I valori integer e a virgola mobile non sono bloccati. L'intensità diffusa predefinita è (0,0, 0,0, 0,0, 1,0) per tutte le luci diverse da zero chiaro. L'intensità diffusa predefinita dello zero chiaro è (1,0, 1,0, 1,0, 1,0). - GL_SPECULAR
Il parametro params contiene quattro valori interi che specificano l'intensità RGBA speculare della luce. I valori interi vengono mappati in modo lineare in modo che il valore rappresentabile più positivo sia mappato a 1,0 e che il valore rappresentabile più negativo sia mappato a 1,0. I valori a virgola mobile vengono mappati direttamente. I valori integer e a virgola mobile non sono bloccati. L'intensità speculare predefinita è (0,0, 0,0, 0,0, 1,0) per tutte le luci diverse da zero chiaro. L'intensità speculare predefinita dello zero chiaro è (1,0, 1,0, 1,0, 1,0). - GL_POSITION
Il parametro params contiene quattro valori interi che specificano la posizione della luce nelle coordinate omogenee dell'oggetto. I valori integer e a virgola mobile vengono mappati direttamente. I valori integer e a virgola mobile non sono bloccati.
La posizione viene trasformata dalla matrice modelview quando viene chiamato glLightiv (esattamente come se fosse un punto) e viene archiviata nelle coordinate degli occhi. Se il componente w della posizione è 0,0, la luce viene considerata come fonte direzionale. I calcoli di illuminazione diffusa e speculare prendono la direzione della luce, ma non la sua posizione effettiva, in considerazione e l'attenuazione è disabilitata. In caso contrario, i calcoli di illuminazione diffusa e speculare si basano sulla posizione effettiva della luce nelle coordinate degli occhi e l'attenuazione è abilitata. La posizione predefinita è (0,0,1,0); pertanto, la sorgente di luce predefinita è direzionale, parallela a e nella direzione dell'asse -z .- GL_SPOT_DIRECTION
Il parametro params contiene tre valori interi che specificano la direzione della luce nelle coordinate omogenee dell'oggetto. I valori integer e a virgola mobile vengono mappati direttamente. I valori integer e a virgola mobile non sono bloccati.
La direzione spot viene trasformata dall'inverso della matrice modelview quando glLightiv viene chiamato (come se fosse normale) e viene archiviato nelle coordinate degli occhi. È significativo solo quando GL_SPOT_CUTOFF non è 180, che è per impostazione predefinita. La direzione predefinita è (0,0,1).- GL_SPOT_EXPONENT
Il parametro params è un singolo valore intero che specifica la distribuzione dell'intensità della luce. I valori integer e a virgola mobile vengono mappati direttamente. Vengono accettati solo i valori nell'intervallo [0, 128].
L'intensità effettiva della luce viene attenuata dal coseno dell'angolo tra la direzione della luce e la direzione dalla luce al vertice che viene illuminata, alzata alla potenza dell'esponente spot. Di conseguenza, gli esponenti spot più alti generano una sorgente di luce più evidenziata, indipendentemente dall'angolo di taglio spot. L'esponente spot predefinito è 0, con conseguente distribuzione uniforme della luce.- GL_SPOT_CUTOFF
Il parametro params è un singolo valore intero che specifica l'angolo di distribuzione massimo di una sorgente di luce. I valori integer e a virgola mobile vengono mappati direttamente. Vengono accettati solo i valori nell'intervallo [0, 90], e il valore speciale 180.
Se l'angolo tra la direzione della luce e la direzione dalla luce al vertice illuminato è maggiore dell'angolo di taglio spot, la luce viene completamente mascherata. In caso contrario, la sua intensità è controllata dall'esponente spot e dai fattori di attenuazione. Il cutoff spot predefinito è 180, con conseguente distribuzione uniforme della luce.- GL_CONSTANT_ATTENUATION, GL_LINEAR_ATTENUATION, GL_QUADRATIC_ATTENUATION
Il parametro params è un singolo valore intero che specifica uno dei tre fattori di attenuazione della luce. I valori integer e a virgola mobile vengono mappati direttamente. Vengono accettati solo valori non negativi.
Se la luce è posizionale, anziché direzionale, la sua intensità viene attenuata dal reciproco della somma di: il fattore costante, il fattore lineare moltiplicato per la distanza tra la luce e il vertice che viene illuminato e il fattore quadratico moltiplicato per il quadrato della stessa distanza. I fattori di attenuazione predefiniti sono (1.0.0), con conseguente assenza di attenuazione. -
params
-
Specifica il valore su cui verrà impostato il parametro pname della luce della sorgente luminosa.
Questa funzione non restituisce un valore.
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
Nome | Significato |
---|---|
|
light o pname non è un valore accettato. |
|
Un valore esponente spot è stato specificato al di fuori dell'intervallo [0, 128]o è stato specificato un cutoff spot al di fuori dell'intervallo [0, 90] (ad eccezione del valore speciale 180) o è stato specificato un fattore di attenuazione negativo. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
La funzione glLightiv imposta il valore o i valori dei singoli parametri della sorgente di luce. Il parametro light denomina la luce ed è un nome simbolico del formato GL_LIGHTi, dove 0 = i< GL_MAX_LIGHTS.
Il parametro pname specifica uno dei parametri della sorgente di luce, anche in base al nome simbolico. Il parametro params è un singolo valore o un puntatore a una matrice che contiene i nuovi valori.
Il calcolo dell'illuminazione è abilitato e disabilitato usando glEnable e glDisable con l'argomento GL_LIGHTING. Quando l'illuminazione è abilitata, le sorgenti di luce abilitate contribuiscono al calcolo dell'illuminazione. La sorgente luminosa i è abilitata e disabilitata usando glEnable e glDisable con l'argomento GL_LIGHTi.
È sempre il caso che GL_LIGHTi = GL_LIGHT0 + i.
Le funzioni seguenti recuperano informazioni correlate alla funzione glLightiv :
glIsEnabled con argomento GL_LIGHTING
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|
Libreria |
|
DLL |
|