远漫反射光效果
使用远射漫射照明效果创建一个图像，该图像看起来是非反射表面，其中光源似乎来自远距离 (如太阳或头顶灯) ，并且光线散射到所有方向。 此效果使用 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 |