NAME

xil_cis_get_attribute, xil_cis_set_attribute − get and set a compressor attribute

SYNOPSIS

#include <xil/xil.h>

int xil_cis_get_attribute (XilCis cis,

char ∗attribute,
void ∗∗value);

int xil_cis_set_attribute (XilCis cis,

char ∗attribute,
void ∗data);

DESCRIPTION

xil_cis_get_attribute () returns the value of the attribute of the cis (the specified compressed image sequence). 

xil_cis_set_attribute () sets attribute of cis to data, a generic pointer to the attribute value. 

Available attributes are described on the specific man pages for the compressors and decompressors available with the XIL library, including the following: Jpeg(3) (baseline JPEG), JpegLL(3) (lossless JPEG), Cell(3) (image compression technology developed by Sun), CellB(3) (video compression technology developed by Sun), faxG3(3) and faxG4(3) (for CCITT Group 3 and Group 4 facsimile devices), Mpeg1(3) (basic MPEG video compression), H261(3) (CCITT Recommendation H.261, Video Codec for Audiovisual Services at px64 kbits/s). 

ERRORS

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

EXAMPLES

This example sets a JPEG CIS attribute called ENCODE_INTERLEAVED to TRUE. 

XilCis cis;
xil_cis_set_attribute(cis,"ENCODE_INTERLEAVED", (void ∗) TRUE);

This example returns the value of a JPEG CIS attribute called ENCODE_INTERLEAVED. 

Xil_boolean encode_type;
XilCis cis;
xil_cis_get_attribute(cis, "ENCODE_INTERLEAVED", (void ∗∗) &encode_type);

NOTES

The xil_cis_set_attribute () and xil_cis_get_attribute () calls are used to modify the default behavior of a specific compressor.  Generic attributes of compressors are set by individual function calls.

SEE ALSO

xil_compress(3), xil_cis_create(3), xil_choose_colormap(3), xil_decompress(3), xil_open(3), xil_cis_get_bits_ptr(3), xil_cis_get_compression_type(3), xil_cis_get_compressor(3), xil_cis_get_input_type(3), xil_cis_get_max_frames(3), xil_cis_get_output_type(3), xil_cis_get_start_frame(3), xil_cis_has_data(3), xil_cis_put_bits(3), xil_cis_reset(3), Jpeg(3), JpegLL(3), Cell(3), CellB(3), faxG3(3), faxG4(3), Mpeg1(3), H261(3). 

SunOS   —  Last change: 18 August 1993