CreateStructuringElement

Creates a structuring element for the usage with morphological operators and allocate an appropriate data buffer. The initial reference count is set to one if a new image interface is created and kept, otherwise.

Syntax

Definition:

HRESULT CreateStructuringElement(
    HRESULT                      hrPrev,
    ITcVnImage*&                 ipStructuringElement,
    ETcVnStructuringElementShape eShape,
    ULONG                        nWidth,
    ULONG                        nHeight
)

Parameters

Name	Type	Description
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)
ipStructuringElement	ITcVnImage*&	Returns the created structuring element (Non-zero interface pointers are reused.)
eShape	ETcVnStructuringElementShape	Shape of the structuring element (rectangle, cross, or ellipse)
nWidth	ULONG	Width
nHeight	ULONG	Height

Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1. 4024.44 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision