AG_DRIVERSDLGL(3)

NAME
AG_DriverSDLGL - agar SDL1 OpenGL driver

DESCRIPTION
The Agar sdlgl driver provides an interface to the Simple DirectMedia Layer (SDL) library version 1.2, and renders GUI elements as OpenGL primitives and managed 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:joy)");
    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.
joy Enable joystick input device support.
stereo
    Request a stereoscopic visual.
width
    Width (in pixels, in % of total desktop or "auto").
height
    Height (in pixels, in % of total desktop or "auto").
depth
    Depth (in bits per pixel or "auto").
fpsMax
    Limit refresh rate in frames/second (e.g., "60").
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", "ifast" or "float").
clampOnResize
    Whenever the display is resized, clamp Agar window positions and sizes to fit the new display size.

SEE ALSO
AG_DriverSDL2FB(3), AG_DriverSDL2GL(3), 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. The clampOnResize and joy options appeared in Agar 1.7.0.