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. 

In order to execute multiple operations as a molecule, XIL defers the operations until a results must be produced. Thus, if a call to xil_compress() is part of a molecule, the compression occurs when the deferred molecule is executed, not at the time that the xil_compress() function is called. Calling xil_cis_sync() ensures that the compression operation executes when it is called. Of course, this prevents the execution of any molecule of which the xil_compress() operation may have been a part.

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 5.6  —  Last change: 09 June 1993