Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AG_DRIVERSDLGL(3)	     Library Functions Manual	       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 argu-
		    ment).   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  in-
		    cludes, 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.

Agar 1.7			December 23, 2022	       AG_DRIVERSDLGL(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=AG_DriverSDLGL&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help