xil_sync(3)

NAME

xil_sync, xil_get_synchronize, xil_set_synchronize, xil_state_get_synchronize, xil_state_set_synchronize − force computation of the value of an image when it would otherwise have been deferred

SYNOPSIS

#include <xil/xil.h>

void xil_sync ( XilImage image);

Xil_boolean xil_get_synchronize (XilImage image);

void xil_set_synchronize (XilImage image,

Xil_boolean onoff);

Xil_boolean xil_state_get_synchronize (XilSystemState State);

void xil_state_set_synchronize (XilSystemState State,

Xil_boolean onoff);

DESCRIPTION

xil_sync () forces the computation of the value of an image in cases in which that operation might otherwise have been deferred. This prevents deferred execution from attempting to optimize beyond the point at which the xil_sync (3) call is made.

xil_get_synchronize () and xil_set_synchronize () set and get the synchronization status of an image. If an image is synchronous, operations on that image are never deferred.

xil_state_get_synchronize () and xil_state_set_synchronize () turn synchronization on or off for State. The default synchronization for State is FALSE, which means that deferred execution is used. If the synchronization status of State is set to TRUE, then all operations are executed immediately -- no deferral occurs.

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 an image rotate operation with bilinear interpolation:

starttime= timelocal(NULL);/∗ get the start time ∗/
xil_rotate(src,dst,"bilinear",0.5);/∗ make dst a rotation of source ∗/
xil_sync(dst);/∗ force the rotate to actually happen ∗/
endtime= timelocal(NULL);/∗ get the finish time ∗/

NOTES

None of these functions produces any semantic differences in the execution of the program. These functions are only useful for debugging, performance measurement, and performance tuning.

Museum

Related Articles