xil_cis_get_bits_ptr(3)

NAME

xil_cis_get_bits_ptr − get compressed data from a compressed image sequence

SYNOPSIS

#include <xil/xil.h>

void∗ xil_cis_get_bits_ptr (XilCis cis,

int ∗nbytes,
int ∗nframes);

DESCRIPTION

This function returns a generic pointer to data in a compressed image sequence.

cis is the compressed image sequence that contains the compressed data for which a pointer is needed.

nbytes is an output parameter indicating the number of bytes of data to which the generic pointer is pointing.

nframes is an output parameter indicating the number of frames the compressed data represents.

The data pointed to is valid until one of the following routines is called, xil_cis_get_bits_ptr (), xil_cis_reset(3), xil_compress(3), or until the compressed image sequence is destroyed.

ERRORS

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

EXAMPLES

Extract the current information from a CIS and put it in a file.

XilCis cis;
char ∗data;
int nframes;
int nbytes;
FILE ∗f;
while (xil_cis_has_frame(cis)) {
data = (char∗)xil_cis_get_bits_ptr(cis, &nbytes, &nframes);
fwrite(data, nbytes, 1, f);
}

Museum