NAME

xil_kernel_get_values - get the values stored internally in and XilKernel object. 

SYNOPSIS

#include <xil/xil.h>

void xil_kernel_get_values(XilKernel kernel,

float∗ data);

DESCRIPTION

xil_kernel_get_values () returns the values stored in kernel. The user must allocate the array of float data to hold the values of the kernel. The size of the data array will be the width of kernel ∗ height of kernel. The width and height can be retrieved by calling xil_kernel_get_width (3) and xil_kernel_get_height (3). 

ERRORS

For a complete list of XIL error messages by number, consult Appendix B of the XIL Programmer’s Guide. 

EXAMPLES

Get the values of a kernel object:

XilKernel kernel;
float∗ data;
unsigned int width;
unsigned int height;
 width = xil_kernel_get_width(kernel);
height = xil_kernel_get_height(kernel);
 data = malloc(width∗height∗sizeof(float));
if(data == NULL)
 /∗ cleanup and exit ∗/
 }
xil_kernel_get_values(kernel, data);

NOTES

If the XilKernel object represents a separable kernel, the horizontal and vertical kernels will be combined and returned as a two dimensional kernel. 

SEE ALSO

xil_kernel_create(3), xil_kernel_get_width(3), xil_kernel_get_height(3), xil_kernel_get_key_x(3), xil_kernel_get_key_y(3). 

SunOS 5.6  —  Last change: 10 February 1997