Méthode IDirectDrawGammaControl ::SetGammaRamp (ddraw.h)
Définit les rampes gamma rouges, vertes et bleues pour la surface primaire.
Syntaxe
HRESULT SetGammaRamp(
[in] DWORD unnamedParam1,
[in] LPDDGAMMARAMP unnamedParam2
);
Paramètres
[in] unnamedParam1
Indicateur qui indique si l’étalonnage gamma est requis. Définissez ce paramètre sur DDSGR_CALIBRATE pour demander que l’étalonneur ajuste la rampe gamma en fonction des propriétés physiques de l’affichage, ce qui rend le résultat identique sur tous les ordinateurs. Si l’étalonnage n’est pas nécessaire, définissez ce paramètre sur 0.
[in] unnamedParam2
Pointeur vers une structure DDGAMMARAMP qui contient les nouvelles entrées de la rampe gamma rouge, verte et bleue. Chaque tableau mappe les valeurs de couleur dans la mémoire tampon de frame aux valeurs de couleur à transmettre au convertisseur numérique-analogique (DAC).
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :
- DDERR_EXCEPTION
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
Remarques
Tous les systèmes ne prennent pas en charge l’étalonnage gamma. Pour déterminer si l’étalonnage gamma est pris en charge, appelez IDirectDraw7 ::GetCaps et examinez le membre dwCaps2 de la structure DDCAPS associée une fois la méthode retournée. Si l’indicateur de fonctionnalité DDCAPS2_CANCALIBRATEGAMMA est présent, l’étalonnage gamma est pris en charge.
L’étalonnage des rampes gamma entraîne une certaine surcharge de traitement et ne doit pas être utilisé fréquemment.
L’inclusion de l’indicateur DDSGR_CALIBRATE dans le paramètre dwFlags lors de l’exécution sur des ordinateurs qui ne prennent pas en charge l’étalonnage gamma ne provoque pas l’échec de cette méthode. La méthode réussit et définit de nouvelles valeurs de rampe gamma sans étalonnage.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |