Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

GenSobelKernel

Computes kernel for the Sobel filter.

Syntax

IppStatus ippiGenSobelKernel_16s(Ipp16s* pDst, int kernelSize, int dx, int sign);

IppStatus ippiGenSobelKernel_32f(Ipp32f* pDst, int kernelSize, int dx, int sign);

Include Files

ippcv.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h, ippi.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib

Parameters

pDst

Pointer to the destination vector.

kernelSize

Size of the Sobel kernel.

dx

Order of derivative.

sign

Specifies signs of kernel elements.

Description

This function computes the one-dimensional Sobel kernel. Kernel coefficients are equal to coefficients of the polynomial


If the sign parameter is negative, then signs of kernel coefficients are changed. Kernel calculated by this function can be used to filter images by a high order Sobel filter.

Return Values

ippStsNoErr

Indicates no error. Any other value indicates an error or a warning.

ippStsNullPtrErr

Indicates an error condition if the pDst pointer is NULL.

ippStsSizeErr

Indicates an error condition if kernelSize is less than 3 or is even.

ippStsBadArgErr

Indicates an error condition if dx is equal to or less than kernelSize, or dx is negative.