Visible to Intel only — GUID: GUID-E59BE270-4B03-4C9D-8D38-64B0A5A4594D
Visible to Intel only — GUID: GUID-E59BE270-4B03-4C9D-8D38-64B0A5A4594D
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
![](/content/dam/docs/us/en/developer-guide-reference/2021-12/DAB9EEBA-76A0-4A64-BEA2-5CD4A8EC15AC-low.jpg)
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. |