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

 

OpenGL

 

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.