SDL_gfx: SDL_framerate.c File Reference

# SDL_framerate.c File Reference

`#include "SDL_framerate.h"`

Go to the source code of this file.

## Functions
void | SDL_initFramerate (FPSmanager *manager)
| Initialize the framerate manager.
int | SDL_setFramerate (FPSmanager *manager, int rate)
| Set the framerate in Hz.
int | SDL_getFramerate (FPSmanager *manager)
| Return the current target framerate in Hz.
int | SDL_getFramecount (FPSmanager *manager)
| Return the current framecount.
void | SDL_framerateDelay (FPSmanager *manager)
| Delay execution to maintain a constant framerate and calculate fps.

## Function Documentation

void SDL_framerateDelay | ( | FPSmanager * | manager | ) |

Delay execution to maintain a constant framerate and calculate fps.

Generate a delay to accomodate currently set framerate. Call once in the graphics/rendering loop. If the computer cannot keep up with the rate (i.e. drawing too slow), the delay is zero and the delay interpolation is reset.

Parameters:

  | manager | Pointer to the framerate manager.

Definition at line 99 of file SDL_framerate.c.

int SDL_getFramecount | ( | FPSmanager * | manager | ) |

Return the current framecount.

Get the current framecount from the framerate manager. A frame is counted each time SDL_framerateDelay is called.

Parameters:

  | manager | Pointer to the framerate manager.

Returns:
  Current frame count or -1 for error.

Definition at line 81 of file SDL_framerate.c.

int SDL_getFramerate | ( | FPSmanager * | manager | ) |

Return the current target framerate in Hz.

Get the currently set framerate of the manager.

Parameters:

  | manager | Pointer to the framerate manager.

Returns:
  Current framerate in Hz or -1 for error.

Definition at line 62 of file SDL_framerate.c.

void SDL_initFramerate | ( | FPSmanager * | manager | ) |

Initialize the framerate manager.

Initialize the framerate manager, set default framerate of 30Hz and reset delay interpolation.

Parameters:

  | manager | Pointer to the framerate manager.

Definition at line 19 of file SDL_framerate.c.

int SDL_setFramerate | ( | FPSmanager * | manager,
|  | int | rate |
| ) |  |  |

Set the framerate in Hz.

Sets a new framerate for the manager and reset delay interpolation. Rate values must be between FPS_LOWER_LIMIT and FPS_UPPER_LIMIT inclusive to be accepted.

Parameters:

  | manager | Pointer to the framerate manager.
  | rate | The new framerate in Hz (frames per second).

Returns:
  0 for sucess and -1 for error.

Definition at line 41 of file SDL_framerate.c.