NAME

AG_DriverSDLFB — agar SDL1 frame-buffer driver

DESCRIPTION

The Agar sdlfb driver provides an interface to the Simple DirectMedia Layer (SDL) library version 1.2, and renders GUI elements directly to the frame-buffer. Using AG_InitVideoSDL(3) as opposed to AG_InitGraphics(3), it is possible to attach Agar to an existing SDL display surface.

INHERITANCE HIERARCHY

AG_Driver(3) -> AG_DriverSw(3) -> AG_DriverSDLFB.

EXAMPLES

AG_InitGraphics("sdlfb(width=640:height=480:joy)");
AG_InitGraphics("sdlfb(width=60%:height=80%)");
AG_InitGraphics("sdlgl(bgColor=0/120/120)");

AG_InitVideoSDL(an_existing_SDL_screen, 0);

OPTIONS

joy

Enable joystick input device support.

width

Width (in pixels, in % of desktop space or "auto").

height

Height (in pixels, in % of desktop space or "auto").

depth

Depth (in bits per pixel or "auto").

fpsMax

Limit refresh rate in frames/second (e.g., "60").

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

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_InitGraphics(3), AG_Intro(3)

Simple DirectMedia Layer

 

OpenGL

 

HISTORY

The sdlfb driver first appeared in Agar 1.4.0. The clampOnResize and joy options appeared in Agar 1.7.0.