Intel IPP Integration Wrappers Developer Guide and Reference

ID 751823
Date 1/18/2023
Public
Document Table of Contents

iwiFilterCannyDeriv

Syntax

class IwiFilterCannyDerivParams: public ::IwiFilterCannyDerivParams
{
public:
    IW_BASE_PARAMS_CONSTRUCTORS(IwiFilterCannyDerivParams, iwiFilterCannyDeriv_SetDefaultParams)
    IwiFilterCannyDerivParams(IppNormType norm = ippNormL2)
};

IW_DECL_CPP(IppStatus) iwiFilterCannyDeriv(
    const IwiImage                  &srcImageDx,
    const IwiImage                  &srcImageDy,
    IwiImage                        &dstImage,
    Ipp32f                           treshLow   = 50,
    Ipp32f                           treshHigh  = 150
    const IwiFilterCannyDerivParams &auxParams  = IwiFilterCannyDerivParams()
);

Parameters

srcImageDx

Reference to the X derivative of the source image.

srcImageDy

Reference to the Y derivative of the source image.

dstImage

Pointer to the destination image.

treshLow

Lower threshold for edges detection.

treshHigh

Upper threshold for edges detection.

auxParams

Reference to the auxiliary parameters structure.

Auxiliary Arguments

Argument Default Value Description

norm

ippNormL2

Normalization mode. Supported values: ippNormL1 and ippNormL2.

Description

This function applies the Canny edge detector to the input image derivatives. For more information, refer to the iwiFilterCannyDeriv function description in C Reference.

Return Values

ippStsNoErr

No errors.

Exception Values

ippStsDataTypeErr

The dataType value is illegal.

ippStsNumChannelsErr

The channels value is illegal.

ippStsNotEvenStepErr

The srcStep and/or dstStep value is not divisible by size of elements.

ippStsNoMemErr

Failed to allocate memory.

ippStsSizeErr

Values of the size fields are illegal.

ippStsNullPtrErr

At least one of the pointers (except tile) is NULL.