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