点光源漫反射效果

  • 项目

使用点漫射照明效果创建一个图像，该图像似乎是一个非反射表面，光散射到所有方向。 此效果使用 alpha 通道作为高度地图，并使用点光源照亮图像。

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

此效果的 CLSID CLSID_D2D1PointDiffuse。 若要使用此效果，请将 dxguid.lib 添加到链接器依赖项。

示例图

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

效果示例屏幕截图，显示点漫射照明效果的输入和输出图像。

漫射照明是指在多个方向反射的光，如下所示。

漫射照明光向所有方向散射。

该效果计算使用以下公式计算的最终输出像素值：

输出位图计算。

其中：

kd = 漫射照明常量。 由用户指定。
表面法线矢量符号。 = surface 法线单位矢量，x 和 y 的函数。
单位向量符号。 = 从图面指向光的单位矢量。
Lr、Lg、Lb = 以 RGB 分量表示的浅色。

效果属性

显示名称和索引枚举 说明
LightPosition
D2D1_POINTDIFFUSE_PROP_LIGHT_POSITION
 点光源的光位置。 属性是定义为 (x、y、z) 的D2D1_VECTOR_3F。 这些单位以与设备无关的像素为单位， (DIP) 且是无限的。
类型为D2D1_VECTOR_3F。
默认值为 {0.0f， 0.0f， 0.0f}。
DiffuseConstant
D2D1_POINTDIFFUSE_PROP_DIFFUSE_CONSTANT
 漫射反射与入射光量的比率。 此属性必须介于 0 和 10，000 之间，并且是无单位的。
类型为 FLOAT。
默认值为 1.0f。
SurfaceScale
D2D1_POINTDIFFUSE_PROP_SURFACE_SCALE
 Z 方向的比例因子。 表面刻度是无单位的，必须介于 0 到 10，000 之间。
类型为 FLOAT。
默认值为 1.0f。
Color
D2D1_POINTDIFFUSE_PROP_COLOR
 入射光的颜色。 此属性公开为向量 3 (R、G、B) ，用于计算 LR、LG、LB。
类型为D2D1_VECTOR_3F。
默认值为 {1.0f， 1.0f， 1.0f}。
KernelUnitLength
D2D1_POINTDIFFUSE_PROP_KERNEL_UNIT_LENGTH
 Sobel 内核中用于在 X 和 Y 方向生成图面法线的元素的大小。 此属性映射到 Sobel 渐变中的 dx 和 dy 值。 此属性是D2D1_VECTOR_2F (内核单元长度 X、内核单元长度 Y) ，在 (DIP/内核单元) 中定义。 该效果使用双线性内插来缩放位图以匹配内核元素的大小。
类型为D2D1_VECTOR_2F。
默认值为 {1.0f， 1.0f}。
ScaleMode
D2D1_POINTDIFFUSE_PROP_SCALE_MODE
 效果用于将图像缩放到相应的内核单元长度的内插模式。 有六种缩放模式在质量和速度方面有范围。 有关详细信息 ，请参阅缩放模式 。
类型为D2D1_POINTDIFFUSE_SCALE_MODE。
默认值为 D2D1_POINTDIFFUSE_SCALE_MODE_LINEAR。

缩放模式

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

注意

如果未选择模式，则效果默认为D2D1_POINTDIFFUSE_SCALE_MODE_LINEAR。

要求

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

ID2D1Effect