Frames and Frame Terminators

Computation Frame: A computation frame is a set of OpenCL API calls, typically the largest set of calls an OpenCL compute context performs that can be considered a single logical operation. A computation frame is comparable to a render frame in a graphics engine. It is recommended for applications rendering graphics to define the computation frame as the set of commands used to calculate the data for a single render frame. Having a notion and boundary of what comprises a frame permits measurements such as frame times and frame rates, as well as API call statistics, which are useful in debugging and profiling.

Frame Terminator: Frame terminators are the functions that end your application computation and render frames. CodeXL uses frame terminators for frame-per-second calculations, statistics analysis, and other measurements, as well as for determining when to stop the execution after you press the Step Out button (Shift+F11). When choosing frame terminators for your project, ensure that at least one of the functions you choose is called for each frame you render. If you are using the OpenGL debug engine, you must select at least one render (OpenGL) frame terminator. A typical selection of Frame Terminators is clFinish for OpenCL and the SwapBuffers option for OpenGL.