Skip to main content

Windows Dev Center

ID2D1EffectContext::CreateBoundsAdjustmentTransform method

Creates and returns a bounds adjustment transform.

Syntax


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

Parameters

outputRectangle [in]

Type: const D2D1_RECT_L*

The initial output rectangle for the bounds adjustment transform.

transform [out]

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.

HRESULTDescription
S_OKNo error occurred.
E_OUTOFMEMORYDirect2D could not allocate sufficient memory to complete the call.
E_INVALIDARGAn 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

Minimum supported client

Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Header

D2D1EffectAuthor.h

Library

D2D1.lib

See also

ID2D1EffectContext