Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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]

Header

D2D1EffectAuthor.h

Library

D2D1.lib

See also

ID2D1EffectContext

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.