ImageAttributes::ClearThreshold 方法 (gdiplusimageattributes.h)
ImageAttributes::ClearThreshold 方法清除指定类别的阈值。
语法
Status ClearThreshold(
[in, optional] ColorAdjustType type
);
parameters
[in, optional] type
类型: ColorAdjustType
ColorAdjustType 枚举的元素,指定为其清除阈值的类别。 默认值为 ColorAdjustTypeDefault。
返回值
类型: 状态
如果方法成功,则返回 Ok,这是 Status 枚举的元素。
如果 方法失败,它将返回 Status 枚举的其他元素之一。
注解
阈值是一个介于 0 到 1 之间的值,该值指定每个颜色分量的截止点。 例如,假设阈值设置为 0.7,并假设要呈现其红色、绿色和蓝色分量为 230、50 和 220 的颜色。 红色分量 230 大于 0.7×255,因此红色分量将更改为 255, (全强度) 。 绿色分量 50 小于 0.7×255,因此绿色组件将更改为 0。 蓝色分量 220 大于 0.7×255,因此蓝色分量将更改为 255。
ImageAttributes 对象维护五个调整类别的颜色和灰度设置:默认、位图、画笔、笔和文本。 例如,可以为默认类别指定阈值,为位图类别指定不同的阈值,为笔类别指定不同的阈值。
默认颜色和灰度调整设置适用于没有自己调整设置的所有类别。 例如,如果从未为笔类别指定任何调整设置,则默认设置将应用于笔类别。
为特定类别指定颜色或灰度调整设置后,默认调整设置将不再应用于该类别。 例如,假设为默认类别指定阈值和 gamma 值。 如果通过调用 ImageAttributes::SetThreshold 设置笔类别的阈值,则默认阈值将不适用于笔。 如果稍后通过调用 ImageAttributes::ClearThreshold 清除笔阈值,则笔类别不会还原到默认阈值;而笔类别将没有阈值。 同样,笔类别不会还原默认的 gamma 值;相反,笔类别将没有伽玛值。
要求
最低受支持的客户端 | Windows XP、Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | gdiplusimageattributes.h (包括 Gdiplus.h) |
Library | Gdiplus.lib |
DLL | Gdiplus.dll |