共用方式為

遠距擴散光源效果

  • 發行項

使用遠距擴散光源效果來建立看似非反射表面的影像，其中光源似乎來自遠距離 (，例如太陽或額外負荷光線) ，而光線會散佈在所有方向。 此效果使用 Alpha 色板做為高度地圖，並以遠距光源將影像亮起。

輸出點陣圖的色彩是淺色、淺色位置和影像表面幾何的結果。 每個具有擴散光源之圖元的 Alpha 色板輸出一律為 1.0。

此效果的 CLSID 是CLSID_D2D1DistantDiffuse。

範例影像

此處的範例顯示遠距擴散光源效果的輸入和輸出影像。

效果範例螢幕擷取畫面，顯示遠距擴散光源效果的輸入和輸出影像。

效果屬性

顯示名稱和索引列舉 Description
方位
D2D1_DISTANTDIFFUSE_PROP_AZIMUTH
 相對於逆時針方向之 X 軸的 XY 平面光源方向角度。 單位以度為單位，且必須介於 0 到 360 度之間。
此類型為 FLOAT。
預設值為 0.0f。
Elevation
D2D1_DISTANTDIFFUSE_PROP_ELE加值稅ION
 相對於逆時針方向 Y 軸的 Y 軸，YZ 平面中光源的方向角度。 單位以度為單位，且必須介於 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。
色彩
D2D1_DISTANTDIFFUSE_PROP_COLOR
 傳入光線的色彩。 此屬性會公開為 D2D1_VECTOR_3F (R、G、B、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) 。 效果會使用雙線性插補來調整點陣圖，以符合核心元素的大小。
此類型為 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