Edit

Share via

Morphology effect

  • Article

Use the morphology effect to thin or thicken edge boundaries in an image. This effect creates a kernel that is 2 times the Width and Height values you specify. This effect centers the kernel on the pixel it is calculating and returns the maximum value in the kernel (if dilating) or minimum value in the kernel (if eroding).

The CLSID for this effect is CLSID_D2D1Morphology.

Example images

This example shows the output of the effect when using the erode mode.

Before
the image before the effect.
After
the image after the transform. 
ComPtr<ID2D1Effect> morphologyEffect;
m_d2dContext->CreateEffect(CLSID_D2D1Morphology, &morphologyEffect);

morphologyEffect->SetInput(0, bitmap);

morphologyEffect->SetValue(D2D1_MORPHOLOGY_PROP_MODE, D2D1_MORPHOLOGY_MODE_ERODE);
morphologyEffect->SetValue(D2D1_MORPHOLOGY_PROP_WIDTH, 14);

m_d2dContext->BeginDraw();
m_d2dContext->DrawImage(morphologyEffect.Get());
m_d2dContext->EndDraw();

Effect properties

Display name and index enumeration Type and default value Description
Mode
D2D1_MORPHOLOGY_PROP_MODE
 D2D1_MORPHOLOGY_MODE
D2D1_MORPHOLOGY_MODE_ERODE
 The morphology mode. The available modes are erode (flatten) and dilate (thicken).
See Morphology modes for more info.
Width
D2D1_MORPHOLOGY_PROP_WIDTH
 UINT
1
 Size of the kernel in the X direction. The units are in DIPs. Values must be between 1 and 100 inclusive.
Height
D2D1_MORPHOLOGY_PROP_HEIGHT
 UINT
1
 Size of the kernel in the Y direction. The units are in DIPs. Values must be between 1 and 100 inclusive.

Morphology modes

Name Description
D2D1_MORPHOLOGY_MODE_ERODE The minimum value from each RGB channel in the kernel is used.
D2D1_MORPHOLOGY_MODE_DILATE The maximum value from each RGB channel in the kernel is used.

Output bitmap

For DILATE mode, the Output Bitmap size grows:

Requirement Value
Output Bitmap Growth X = INT(FLOAT(Width) * ((User DPI) / 96))
Output Bitmap Growth Y = INT(FLOAT(Height) * ((User DPI) / 96))

For ERODE mode, the Output Bitmap size shrinks:

Requirement Value
Output Bitmap Growth X = INT(FLOAT(-Width) * ((User DPI) / 96))
Output Bitmap Growth Y = INT(FLOAT(-Height) * ((User DPI) / 96))

Requirements

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]
Minimum supported server Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]
Header d2d1effects.h
Library d2d1.lib, dxguid.lib

ID2D1Effect