Function sdl2_sys::SDL_VideoInit
source · pub unsafe extern "C" fn SDL_VideoInit(
driver_name: *const c_char,
) -> c_int
Expand description
Initialize the video subsystem, optionally specifying a video driver.
This function initializes the video subsystem, setting up a connection to the window manager, etc, and determines the available display modes and pixel formats, but does not initialize a window or graphics mode.
If you use this function and you haven’t used the SDL_INIT_VIDEO flag with either SDL_Init() or SDL_InitSubSystem(), you should call SDL_VideoQuit() before calling SDL_Quit().
It is safe to call this function multiple times. SDL_VideoInit() will call SDL_VideoQuit() itself if the video subsystem has already been initialized.
You can use SDL_GetNumVideoDrivers() and SDL_GetVideoDriver() to find a
specific driver_name
.
\param driver_name the name of a video driver to initialize, or NULL for the default driver \returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
\since This function is available since SDL 2.0.0.
\sa SDL_GetNumVideoDrivers \sa SDL_GetVideoDriver \sa SDL_InitSubSystem \sa SDL_VideoQuit