NAME

xil_cis_sync − force any outstanding call to xil_compress(3) to complete when it would otherwise have been deferred

SYNOPSIS

#include <xil/xil.h>

void xil_cis_sync ( XilCis cis);

DESCRIPTION

xil_cis_sync() forces any outstanding calls to xil_compress(3) to complete. This forces the actual capture and compress to occur immediately instead of being deferred as part of an XIL molecule. 

In order to execute multiple operations as a molecule, XIL defers the operations until they are needed. Thus, if a call to xil_compress() is part of a molecule, the capture and compression occurs when the deferred molecule is executed, not at the time that the xil_compress() function is called.

ERRORS

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

EXAMPLES

Measure the performance of a compress operation:

starttime= gmtime(NULL);/∗ get the start time ∗/
xil_compress(src,cis);          /∗ compress the image ∗/
xil_cis_sync(cis);/∗ force the compress to actually happen ∗/
endtime= gmtime(NULL);/∗ get the finish time ∗/

NOTES

This function does not produce any semantic differences in the execution of the program. 

SunOS   —  Last change: 09 June 1993