Método ImageAttributes::ClearThreshold (gdiplusimageattributes.h)

Artículo
08/24/2023

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