funzione glGetLightfv

Le funzioni glGetLightfv e glGetLightiv restituiscono i valori dei parametri di origine luce.

Sintassi

void WINAPI glGetLightfv(
   GLenum  light,
   GLenum  pname,
   GLfloat *params
);

Parametri

light

Una fonte di luce. Il numero di luci possibili dipende dall'implementazione, ma almeno otto luci sono supportate. Sono identificati da nomi simbolici del modulo GL_LIGHT i dove 0 = i< GL_MAX_LIGHTS.

Pname

Parametro della sorgente luminosa per la luce. Vengono accettati i seguenti nomi simbolici.

Valore	Significato
GL_AMBIENT	Il parametro params restituisce quattro valori interi o a virgola mobile che rappresentano l'intensità ambientale della fonte di luce. I valori integer, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1.0 esegue il mapping al valore intero rappresentabile più positivo e -1.0 esegue il mapping al valore intero rappresentabile più negativo. Se il valore interno non è compreso nell'intervallo [-1,1], il valore restituito intero corrispondente non è definito.
GL_DIFFUSE	Il parametro params restituisce quattro valori interi o a virgola mobile che rappresentano l'intensità diffusa della fonte di luce. I valori integer, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1.0 esegue il mapping al valore intero rappresentabile più positivo e -1.0 esegue il mapping al valore intero rappresentabile più negativo. Se il valore interno non è compreso nell'intervallo [-1,1], il valore restituito intero corrispondente non è definito.
GL_SPECULAR	Il parametro params restituisce quattro valori interi o a virgola mobile che rappresentano l'intensità speculare della fonte di luce. I valori integer, se richiesti, vengono mappati in modo lineare dalla rappresentazione a virgola mobile interna, in modo che 1.0 esegue il mapping al valore intero rappresentabile più positivo e -1.0 esegue il mapping al valore intero rappresentabile più negativo. Se il valore interno non è compreso nell'intervallo [-1,1], il valore restituito intero corrispondente non è definito.
GL_POSITION	Il parametro params restituisce quattro valori interi o a virgola mobile che rappresentano la posizione della fonte di luce. I valori integer, quando richiesti, vengono calcolati arrotondando i valori a virgola mobile interna al valore intero più vicino. I valori restituiti sono quelli mantenuti nelle coordinate oculari. Non saranno uguali ai valori specificati usando glLight, a meno che non sia stata identificata la matrice modelview al momento in cui glLight è stato chiamato.
GL_SPOT_DIRECTION	Il parametro params restituisce tre valori integer o a virgola mobile che rappresentano la direzione della fonte di luce. I valori integer, quando richiesti, vengono calcolati arrotondando i valori a virgola mobile interna al valore intero più vicino. I valori restituiti sono quelli mantenuti nelle coordinate oculari. Non saranno uguali ai valori specificati usando glLight, a meno che non sia stata identificata la matrice modelview al momento in cui glLight è stato chiamato. Sebbene la direzione spot sia normalizzata prima di essere usata nell'equazione di illuminazione, i valori restituiti sono le versioni trasformate dei valori specificati prima della normalizzazione.
GL_SPOT_EXPONENT	Il parametro params restituisce un singolo valore intero o a virgola mobile che rappresenta l'esponente spot della luce. Un valore intero, quando richiesto, viene calcolato arrotondando la rappresentazione interna a virgola mobile al numero intero più vicino.
GL_SPOT_CUTOFF	Il parametro params restituisce un singolo valore intero o a virgola mobile che rappresenta l'angolo di taglio spot della luce. Un valore intero, quando richiesto, viene calcolato arrotondando la rappresentazione interna a virgola mobile al numero intero più vicino.
GL_CONSTANT_ATTENUATION	Il parametro params restituisce un singolo valore intero o a virgola mobile che rappresenta l'attenuazione costante (non correlata alla distanza) della luce. Un valore intero, quando richiesto, viene calcolato arrotondando la rappresentazione interna a virgola mobile al numero intero più vicino.
GL_LINEAR_ATTENUATION	Il parametro params restituisce un singolo valore intero o a virgola mobile che rappresenta l'attenuazione lineare della luce. Un valore intero, quando richiesto, viene calcolato arrotondando la rappresentazione interna a virgola mobile al numero intero più vicino.
GL_QUADRATIC_ATTENUATION	Il parametro params restituisce un singolo valore intero o a virgola mobile che rappresenta l'attenuazione quadratica della luce. Un valore intero, quando richiesto, viene calcolato arrotondando la rappresentazione interna a virgola mobile al numero intero più vicino.

params

Restituisce i dati richiesti.

Valore restituito

Questa funzione non restituisce un valore.

Commenti

La funzione glGetLight restituisce in params il valore o i valori di un parametro di origine luminosa. Il parametro chiaro chiama la luce ed è un nome simbolico del modulo GL_LIGHTi per 0 = i< GL_MAX_LIGHTS, dove GL_MAX_LIGHTS è una costante dipendente dall'implementazione maggiore o uguale a otto. Il parametro pname specifica uno dei dieci parametri di origine luminosa, di nuovo in base al nome simbolico.

È sempre il caso che GL_LIGHTi = GL_LIGHT0 + i.

Se viene generato un errore, non viene apportata alcuna modifica al contenuto di params.

Requisiti

Vedi anche

glBegin

glEnd

glLight