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)
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.
