AG_DRIVERSDLGL(3)

NAME
AG_DriverSDLGL - agar SDL OpenGL driver

DESCRIPTION
The Agar sdlgl driver provides an interface to the Simple DirectMedia Layer (SDL) library and renders GUI elements as OpenGL primitives and textures.

Using AG_InitVideoSDL(3) as opposed to AG_InitGraphics(3), it is possible to attach Agar to an existing SDL display surface. If the SDL surface has the SDL_OPENGL flag set, Agar selects the sdlgl driver automatically.

INHERITANCE HIERARCHY
AG_Driver(3) -> AG_DriverSw(3) -> AG_DriverSDLGL.

EXAMPLES

    AG_InitGraphics("sdlgl(width=640:height=480)");
    AG_InitGraphics("sdlgl(width=60%:height=80%)");
    AG_InitGraphics("sdlgl(bgColor=0/120/120)");
    AG_InitGraphics("sdlgl(out=%08d.jpg:outFirst=10)");
    AG_InitGraphics("sdlgl(depth=64:stereo)");
    AG_InitVideoSDL(an_existing_SDL_screen, 0);

OPTIONS
debug
    Capture GL_DEBUG_OUTPUT errors.
stereo
    Request a stereoscopic visual.
width
    Width in pixels, in % of available desktop space, or "auto".
height
    Height in pixels, in % of available desktop space, or "auto".
depth
    Depth in bits per pixel, or "auto".
fpsMax
    Limit GUI refresh rate in frames/second (default = 60fps).
out Dump video frames to JPEG or PNG image files. The filename path may include a printf-style (with frame number as argument). For example, ‘%08d.jpg’ will output frames to 00000001.jpg, 00000002.jpg, etc.
outFirst
    Override first frame number (default = 0).
outLast
    Terminate application after # frames have been rendered.
bgColor
    Solid background color specified as "R/G/B", from "0/0/0" (black) to "255/255/255" (white).
!bgPopup
    Disable the right-click background popup menu (which includes, notably the list of active windows).
jpegQual
    If exporting to JPEG, set quality factor (100% = best).
jpegDCT
    If exporting to JPEG, specify DCT method ("islow" for slow but accurate integer method, "ifast" for fast but less accurate integer method, or "float" for floating point method).

SEE ALSO
AG_Driver(3), AG_DriverSw(3), AG_GL(3), AG_InitGraphics(3), AG_Intro(3)

Simple_DirectMedia_Layer: https://libsdl.org/

OpenGL: https://www.opengl.org/

HISTORY
The sdlgl driver first appeared in Agar 1.4.0. The "debug" option appeared in Agar 1.6.0.