Metodo ImageAttributes::ClearThreshold (gdiplusimageattributes.h)

Articolo
08/24/2023

Il metodo ImageAttributes::ClearThreshold cancella il valore soglia per una categoria specificata.

Sintassi

Status ClearThreshold(
  [in, optional] ColorAdjustType type
);

Parametri

[in, optional] type

Tipo: ColorAdjustType

Elemento dell'enumerazione ColorAdjustType che specifica la categoria per cui viene cancellata la soglia. Il valore predefinito è ColorAdjustTypeDefault.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

La soglia è un valore compreso tra 0 e 1 che specifica un punto di ritaglio per ogni componente di colore. Si supponga, ad esempio, che la soglia sia impostata su 0,7 e si supponga di eseguire il rendering di un colore i cui componenti rosso, verde e blu sono 230, 50 e 220. Il componente rosso, 230, è maggiore di 0,7×255, quindi il componente rosso verrà modificato in 255 (intensità intera). Il componente verde, 50, è minore di 0,7×255, quindi il componente verde verrà modificato in 0. Il componente blu, 220, è maggiore di 0,7×255, quindi il componente blu verrà modificato in 255.

Un oggetto ImageAttributes mantiene le impostazioni di colore e gradazioni di grigio per cinque categorie di regolazione: default, bitmap, brush, pen e text. Ad esempio, è possibile specificare una soglia per la categoria predefinita, una soglia diversa per la categoria bitmap e ancora una soglia diversa per la categoria della penna.

Le impostazioni predefinite di regolazione del colore e della scala di grigio si applicano a tutte le categorie che non dispongono di impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria della penna, le impostazioni predefinite si applicano alla categoria della penna.

Non appena si specifica un'impostazione di regolazione del colore o della scala di grigi per una determinata categoria, le impostazioni di regolazione predefinite non si applicano più a tale categoria. Si supponga, ad esempio, di specificare una soglia e un valore gamma per la categoria predefinita. Se si imposta la soglia per la categoria della penna chiamando ImageAttributes::SetThreshold, la soglia predefinita non verrà applicata alle penne. Se successivamente si cancella la soglia della penna chiamando ImageAttributes::ClearThreshold, la categoria della penna non verrà ripristinata alla soglia predefinita; invece, la categoria della penna non avrà alcuna soglia. Analogamente, la categoria della penna non ripristina il valore gamma predefinito; invece, la categoria della penna non avrà alcun valore gamma.

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusimageattributes.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll