SDL output

disclaimer / info:

DISCLAIMER:
THIS IS EXPERIMENTAL SOFTWARE AND HARDWARE. USE AT YOUR OWN RISK. THE MAINTAINER(S) OF THESE PAGES AND THE DEVELOPER(S) OF SOFTWARE AND HARDWARE PRESENTED ON THESE PAGES CAN NOT BE HELD LIABLE UNDER ANY CIRCUMSTANCES FOR DAMAGE TO HARDWARE OR SOFTWARE, LOST DATA, OR OTHER DIRECT OR INDIRECT DAMAGE RESULTING FROM THE USE OF THIS SOFTWARE OR HARDWARE. IF YOU DO NOT AGREE TO THESE CONDITIONS, YOU ARE NOT PERMITTED TO USE OR FURTHER DISTRIBUTE THIS SOFTWARE OR TO USE ANY TEMPLATES FOR BUILDING HARDWARE PRESENTED HERE.

SDL output:

description

this driver outputs serdisplib generated content using libSDL and can be used for testing purposes and such.
specifications
resolution variable
colours monochrome; greyscale: 4,8,16,64; colour: 256, 4k, 64k, 16M (w/o and w/ alpha-channel)
supported since serdisplib version 1.97.9
name in serdisplib "SDL"       (example: serdisp_init(sdcd, "SDL", ""); )

some images

click on image to view full size ...
[sdl output graphlcd] [sdl output multidisplay]
test with graphlcd, resolution: 1024x768, depth: 32 test with multidisplay, resolution: 1024x768, depth: 32
(full size image has been scaled because of space requirement)
top ^

usage of SDL output:

NOTA BENE!

libSDL-support might not be enabled!

because SDL output requires libSDL it has to be enabled using

./configure --enable-libSDL

when compiling the library.

output device
examples
configuration in lcd4linux
 Display SerDispLib {
   Driver 'serdisplib'
   Port 'OUT:'
   Model 'SDL'
 }
configuration in graphlcd
 [serdisp]
 Driver=serdisp
 Device=OUT:
 Controller=sdl
calling test program testserdisp
  testserdisp -n sdl -p 'OUT:'
  testserdisp -n sdl -p 'OUT:' -o 'WIDTH=800;HEIGHT=600'
  testserdisp -n sdl -p 'OUT:' -o 'WIDTH=800;HEIGHT=600;DEPTH=16'
top ^

passing options through serdisp_init():

intro

using the third parameter of serdisp_init(), driver specific options and custom wiring can be set.
common information about passing options and customisable wiring can be found in a separate document.
    examples:

      serdisp_init(sdcd, "SDL", "DEPTH=8;WIDTH=800;HEIGHT=600");
      serdisp_init(sdcd, "SDL", "INVERT=YES;ROTATE=90");
    

options

identifiershortremarkdefault
ROTATEROTrotate display (1 == 180 degrees)0
INVERTINVinvert display0
WIDTHWwidth of display320
HEIGHTHheight of display240
DEPTHCOLS, COLOURScolour depth32

ranges, aliases

identifierrangealiases
ROTATE0, 1, 90, 180, 270YES=180, NO=0, TRUE=180, FALSE=0
INVERT0, 1YES=1, NO=0, TRUE=1, FALSE=0
WIDTH<= 1024 
HEIGHT<= 1024 
DEPTH1, 2, 4, 8, 12, 16, 24, 32 
top ^

history:

2010-02-21 merging SVN documentation to main documentation
2009-02-19 (SVN:) first release of documentation
top ^

design by wolfgang astleitner, (C) 1998 - 2010