Contents

cp_frame_timing_get_optimal_input_time

Returns the optimal time to start the frame submission process.

Declaration

cp_time_t cp_frame_timing_get_optimal_input_time(cp_frame_timing_t frame_timing);

Parameters

  • frame_timing:

    The frame’s timing information. Fetch this information using the Cp_frame_predict_timing function. After you retrieve the frame’s drawable type, get the information using Frametiming instead.

Return Value

The Mach absolute time at which to query the input for your frame.

Discussion

The optimal input time is the time at which to call the startSubmission() function. Use the time before the input time to update your app’s data structures and prepare for rendering. Call cp_time_wait_until to suspend your app until the optimal time arrives. When it does, fetch the current device pose and finish rendering and the frame and commit your Metal command buffers.

See Also

Getting timing information