Share via

ID2D1RenderTarget：：FillOpacityMask (ID2D1Bitmap*，ID2D1Brush*，D2D1_OPACITY_MASK_CONTENT，constD2D1_RECT_F&，constD2D1_RECT_F&) 方法 (d2d1.h)

  • 發行項

將指定位圖所描述的不透明度遮罩套用至筆刷，並使用該筆刷繪製轉譯目標的區域。

語法

void FillOpacityMask(
  [in]  ID2D1Bitmap               *opacityMask,
  [in]  ID2D1Brush                *brush,
        D2D1_OPACITY_MASK_CONTENT content,
  [ref] const D2D1_RECT_F &       destinationRectangle,
  [ref] const D2D1_RECT_F &       sourceRectangle
);

參數

[in] opacityMask

類型： ID2D1Bitmap*

要套用至筆刷的不透明度遮罩。 sourceRectangle 所指定區域中每個圖元的 Alpha 值會乘以筆刷的 Alpha 值，之後筆刷對應至 destinationRectangle 所定義的區域。

[in] brush

類型： ID2D1Brush*

筆刷，用來繪製 destinationRectangle 所指定之轉譯目標的區域。

content

類型： D2D1_OPACITY_MASK_CONTENT

不透明度遮罩包含的內容類型。 值是用來判斷混合不透明度遮罩的色彩空間。

注意從 Windows 8 開始，不需要D2D1_OPACITY_MASK_CONTENT。 請參閱沒有D2D1_OPACITY_MASK_CONTENT參數的ID2D1DeviceContext：：FillOpacityMask方法。
 

[ref] destinationRectangle

類型： const D2D1_RECT_F

要繪製的轉譯目標區域，以裝置無關的圖元為單位。

[ref] sourceRectangle

類型： const D2D1_RECT_F

要作為不透明度遮罩的點陣圖區域，以與裝置無關的圖元為單位。

傳回值

無

備註

若要讓這個方法正常運作，轉譯目標必須使用 D2D1_ANTIALIAS_MODE_ALIASED 反鋸齒模式。 您可以呼叫 ID2D1RenderTarget：：SetAntialiasMode 方法來設定反鋸齒模式 。

如果此方法失敗，此方法不會傳回錯誤碼。 若要判斷繪圖作業 (，例如 FillOpacityMask) 失敗，請檢查 ID2D1RenderTarget：：EndDraw 或 ID2D1RenderTarget：：Flush 方法傳回的結果。

規格需求

需求 值
最低支援的用戶端 適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1.h
程式庫 D2d1.lib
Dll D2d1.dll

另請參閱

ID2D1RenderTarget