远漫反射光效果

使用远射漫射照明效果创建一个图像,该图像看起来是非反射表面,其中光源似乎来自远距离 (如太阳或头顶灯) ,并且光线散射到所有方向。 此效果使用 alpha 通道作为高度贴图,并使用远处的光源照亮图像。

输出位图的颜色是浅色、光位置和图像表面几何图形的结果。 具有漫射照明的每个像素的 alpha 通道输出始终为 1.0。

此效果的 CLSID 是CLSID_D2D1DistantDiffuse。

示例图

此处的示例显示了远射漫射照明效果的输入和输出图像。

效果示例屏幕截图:远程漫射照明效果的输入和输出图像。

效果属性

显示名称和索引枚举 说明
方位角
D2D1_DISTANTDIFFUSE_PROP_AZIMUTH
XY 平面中光源相对于逆时钟方向上的 X 轴的方向角。 单位以度为单位,必须介于 0 到 360 度之间。
类型为 FLOAT。
默认值为 0.0f。
Elevation
D2D1_DISTANTDIFFUSE_PROP_ELEVATION
YZ 平面中光源相对于逆时钟方向的 Y 轴的方向角。 单位以度为单位,必须介于 0 到 360 度之间。
类型为 FLOAT。
默认值为 0.0f。
DiffuseConstant
D2D1_DISTANTDIFFUSE_PROP_DIFFUSE_CONSTANT
漫射反射与入射光量的比率。 此属性必须介于 0 和 10,000 之间,并且是无单位的。
类型为 FLOAT。
默认值为 1.0f。
SurfaceScale
D2D1_DISTANTDIFFUSE_PROP_SURFACE_SCALE
Z 方向的比例因子。 表面刻度是无单位的,必须介于 0 到 10,000 之间。
类型为 FLOAT。
默认值为 1.0f。
Color
D2D1_DISTANTDIFFUSE_PROP_COLOR
传入光的颜色。 此属性公开为D2D1_VECTOR_3F (R、G、B) ,用于计算 LR、LG、LB
类型为D2D1_VECTOR_3F。
默认值为 {1.0f, 1.0f, 1.0f}。
KernelUnitLength
D2D1_DISTANTDIFFUSE_PROP_KERNEL_UNIT_LENGTH
Sobel 内核中用于在 X 和 Y 方向上生成图面法线的元素的大小。 此属性映射到 Sobel 渐变中的 dx 和 dy 值。 此属性是D2D1_VECTOR_2F (内核单元长度 X、内核单位长度 Y) ,在 /Kernel Unit) ) (DIP (设备无关像素中定义。 该效果使用双线性内插来缩放位图,以匹配内核元素的大小。
类型为D2D1_VECTOR_2F。
默认值为 {1.0f, 1.0f}。
ScaleMode
D2D1_DISTANTDIFFUSE_PROP_SCALE_MODE
效果用于将图像缩放到相应的内核单元长度的内插模式。 有六种缩放模式在质量和速度方面都有范围。
类型为D2D1_DISTANTDIFFUSE_SCALE_MODE。
默认值为 D2D1_DISTANTDIFFUSE_SCALE_MODE_LINEAR。

缩放模式

枚举 描述
D2D1_DISTANTDIFFUSE_SCALE_MODE_NEAREST_NEIGHBOR 对最近的单个点进行采样并使用它。 此模式使用的处理时间较少,但输出质量最低的图像。
D2D1_DISTANTDIFFUSE_SCALE_MODE_LINEAR 使用四点样本和线性内插。 此模式输出的质量高于最近邻居的图像。
D2D1_DISTANTDIFFUSE_SCALE_MODE_CUBIC 使用 16 个示例立方内核进行内插。 此模式使用的处理时间最多,但会输出更高质量的图像。
D2D1_DISTANTDIFFUSE_SCALE_MODE_MULTI_SAMPLE_LINEAR 在单个像素内使用 4 个线性样本,以便进行良好的边缘抗锯齿。 此模式适用于在像素较少的图像上按少量纵向缩减。
D2D1_DISTANTDIFFUSE_SCALE_MODE_ANISOTROPIC 使用各向异性筛选根据位图的转换形状对图案进行采样。
D2D1_DISTANTDIFFUSE_SCALE_MODE_HIGH_QUALITY_CUBIC 如果转换矩阵中涉及降级,则使用可变大小的高质量立方内核对图像执行预缩减。 然后将三次内插模式用于最终输出。

注意

如果未选择模式,则效果默认为D2D1_DISTANTDIFFUSE_SCALE_MODE_LINEAR。

要求

要求
最低受支持的客户端 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |Windows 应用商店应用]
最低受支持的服务器 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |Windows 应用商店应用]
标头 d2d1effects.h
d2d1.lib、dxguid.lib

ID2D1Effect