Edit

Share via

ID2D1EffectContext::CreateBoundsAdjustmentTransform method (d2d1effectauthor.h)

  • Article

Creates and returns a bounds adjustment transform.

Syntax

HRESULT CreateBoundsAdjustmentTransform(
  [in]  const D2D1_RECT_L              *outputRectangle,
  [out] ID2D1BoundsAdjustmentTransform **transform
);

Parameters

[in] outputRectangle

Type: const D2D1_RECT_L*

The initial output rectangle for the bounds adjustment transform.

[out] transform

Type: ID2D1BoundsAdjustmentTransform**

The returned bounds adjustment transform.

Return value

Type: HRESULT

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULT Description
S_OK No error occurred.
E_OUTOFMEMORY Direct2D could not allocate sufficient memory to complete the call.
E_INVALIDARG An invalid parameter was passed to the returning function.

Remarks

A support transform can be used for two different reasons.

  • To indicate that a region of its input image is already transparent black. This can increase efficiency for rendering bitmaps.
    Note  If the indicated region does NOT contain only transparent black pixels, then rendering results are undefined.
     
  • To increase the size of the input image. The expanded area will be treated as transparent black

Requirements

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1effectauthor.h
Library D2D1.lib

See also

ID2D1EffectContext