Método ImageAttributes::ClearThreshold (gdiplusimageattributes.h)
El método ImageAttributes::ClearThreshold borra el valor de umbral de una categoría especificada.
Sintaxis
Status ClearThreshold(
[in, optional] ColorAdjustType type
);
Parámetros
[in, optional] type
Tipo: ColorAdjustType
Elemento de la enumeración ColorAdjustType que especifica la categoría para la que se borra el umbral. El valor predeterminado es ColorAdjustTypeDefault.
Valor devuelto
Tipo: Estado
Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .
Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .
Comentarios
El umbral es un valor comprendido entre 0 y 1 que especifica un punto de límite para cada componente de color. Por ejemplo, supongamos que el umbral se establece en 0,7 y que representa un color cuyos componentes rojo, verde y azul son 230, 50 y 220. El componente rojo, 230, es mayor que 0,7×255, por lo que el componente rojo se cambiará a 255 (intensidad completa). El componente verde, 50, es inferior a 0,7×255, por lo que el componente verde se cambiará a 0. El componente azul, 220, es mayor que 0,7×255, por lo que el componente azul se cambiará a 255.
Un objeto ImageAttributes mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar un umbral para la categoría predeterminada, un umbral diferente para la categoría de mapa de bits y un umbral diferente para la categoría de lápiz.
La configuración predeterminada de ajuste de escala de grises y color se aplica a todas las categorías que no tienen ajustes de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.
En cuanto especifique una configuración de ajuste de escala de colores o grises para una determinada categoría, la configuración de ajuste predeterminada ya no se aplica a esa categoría. Por ejemplo, supongamos que especifica un umbral y un valor gamma para la categoría predeterminada. Si establece el umbral para la categoría de lápiz llamando a ImageAttributes::SetThreshold, el umbral predeterminado no se aplicará a los lápices. Si más adelante borra el umbral del lápiz llamando a ImageAttributes::ClearThreshold, la categoría del lápiz no volverá al umbral predeterminado; en su lugar, la categoría de lápiz no tendrá ningún umbral. Del mismo modo, la categoría del lápiz no revertirá al valor gamma predeterminado; en su lugar, la categoría de lápiz no tendrá ningún valor gamma.
Requisitos
| Cliente mínimo compatible | Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | gdiplusimageattributes.h (incluya Gdiplus.h) |
| Library | Gdiplus.lib |
| Archivo DLL | Gdiplus.dll |