Hex Artifact Content
Not logged in

Artifact 5cd664389f79373c36d48fa1a28afb3089a866b3:

Wiki page [Beyond AndroWish] by chw 2019-02-17 11:40:44.
0000: 44 20 32 30 31 39 2d 30 32 2d 31 37 54 31 31 3a  D 2019-02-17T11:
0010: 34 30 3a 34 34 2e 30 34 38 0a 4c 20 42 65 79 6f  40:44.048.L Beyo
0020: 6e 64 5c 73 41 6e 64 72 6f 57 69 73 68 0a 50 20  nd\sAndroWish.P 
0030: 66 63 30 38 39 63 32 32 34 63 36 36 34 34 66 64  fc089c224c6644fd
0040: 63 36 39 30 35 62 39 65 37 61 39 33 38 33 31 63  c6905b9e7a93831c
0050: 36 63 38 66 39 63 62 39 0a 55 20 63 68 77 0a 57  6c8f9cb9.U chw.W
0060: 20 33 39 34 36 0a 53 6f 6d 65 20 73 75 62 64 69   3946.Some subdi
0070: 72 65 63 74 6f 72 69 65 73 20 6f 66 20 5b 41 6e  rectories of [An
0080: 64 72 6f 57 69 73 68 5d 20 68 61 76 65 20 61 20  droWish] have a 
0090: 72 65 61 64 79 2d 74 6f 2d 62 75 69 6c 64 2d 74  ready-to-build-t
00a0: 68 65 6e 2d 75 73 65 20 3c 61 20 68 72 65 66 3d  hen-use <a href=
00b0: 22 68 74 74 70 3a 2f 2f 77 77 77 2e 64 65 62 69  "http://www.debi
00c0: 61 6e 2e 6f 72 67 22 3e 44 65 62 69 61 6e 3c 2f  an.org">Debian</
00d0: 61 3e 20 69 6e 66 72 61 73 74 72 75 63 74 75 72  a> infrastructur
00e0: 65 20 62 75 69 6c 74 20 69 6e 2e 20 54 68 61 74  e built in. That
00f0: 20 61 6c 6c 6f 77 73 20 74 6f 20 62 75 69 6c 64   allows to build
0100: 20 44 65 62 69 61 6e 20 70 61 63 6b 61 67 65 73   Debian packages
0110: 20 65 61 73 69 6c 79 20 65 2e 67 2e 20 6f 6e 20   easily e.g. on 
0120: 61 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a  a <a href="http:
0130: 2f 2f 77 77 77 2e 72 61 73 70 62 69 61 6e 2e 6f  //www.raspbian.o
0140: 72 67 22 3e 52 61 73 70 62 69 61 6e 3c 2f 61 3e  rg">Raspbian</a>
0150: 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 72 75   distribution ru
0160: 6e 6e 69 6e 67 20 6f 6e 20 79 6f 75 72 20 52 61  nning on your Ra
0170: 73 70 62 65 72 72 79 20 50 69 3a 0d 0a 0d 0a 3c  spberry Pi:....<
0180: 76 65 72 62 61 74 69 6d 3e 0d 0a 20 20 20 20 63  verbatim>..    c
0190: 64 20 2e 2e 2e 2f 6a 6e 69 2f 53 44 4c 32 20 3b  d .../jni/SDL2 ;
01a0: 20 64 70 6b 67 2d 62 75 69 6c 64 70 61 63 6b 61   dpkg-buildpacka
01b0: 67 65 20 2d 74 63 20 2d 75 63 20 3b 20 64 70 6b  ge -tc -uc ; dpk
01c0: 67 20 2d 69 20 2e 2e 2f 6c 69 62 73 64 6c 32 2a  g -i ../libsdl2*
01d0: 2e 64 65 62 0d 0a 20 20 20 20 63 64 20 2e 2e 2e  .deb..    cd ...
01e0: 2f 6a 6e 69 2f 74 63 6c 20 3b 20 64 70 6b 67 2d  /jni/tcl ; dpkg-
01f0: 62 75 69 6c 64 70 61 63 6b 61 67 65 20 2d 74 63  buildpackage -tc
0200: 20 2d 75 63 20 3b 20 64 70 6b 67 20 2d 69 20 2e   -uc ; dpkg -i .
0210: 2e 2f 73 64 6c 74 63 6c 2a 2e 64 65 62 0d 0a 20  ./sdltcl*.deb.. 
0220: 20 20 20 63 64 20 2e 2e 2e 2f 6a 6e 69 2f 73 64     cd .../jni/sd
0230: 6c 32 74 6b 20 3b 20 64 70 6b 67 2d 62 75 69 6c  l2tk ; dpkg-buil
0240: 64 70 61 63 6b 61 67 65 20 2d 74 63 20 2d 75 63  dpackage -tc -uc
0250: 20 3b 20 64 70 6b 67 20 2d 69 20 2e 2e 2f 73 64   ; dpkg -i ../sd
0260: 6c 32 74 6b 2a 2e 64 65 62 0d 0a 20 20 20 20 2f  l2tk*.deb..    /
0270: 6f 70 74 2f 73 64 6c 74 6b 38 36 2f 62 69 6e 2f  opt/sdltk86/bin/
0280: 73 64 6c 32 77 69 73 68 38 2e 36 0d 0a 3c 2f 76  sdl2wish8.6..</v
0290: 65 72 62 61 74 69 6d 3e 0d 0a 0d 0a 42 75 69 6c  erbatim>....Buil
02a0: 64 69 6e 67 20 73 6f 6d 65 20 63 6f 6d 70 6f 6e  ding some compon
02b0: 65 6e 74 73 20 6f 66 20 5b 41 6e 64 72 6f 57 69  ents of [AndroWi
02c0: 73 68 5d 20 66 6f 72 20 74 68 65 20 57 69 6e 64  sh] for the Wind
02d0: 6f 77 73 20 4f 53 20 66 61 6d 69 6c 79 20 69 73  ows OS family is
02e0: 20 70 6f 73 73 69 62 6c 65 2c 20 74 6f 6f 2c 20   possible, too, 
02f0: 62 79 20 75 73 69 6e 67 20 63 72 6f 73 73 20 63  by using cross c
0300: 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 6e 20 61 20  ompilation on a 
0310: 4c 69 6e 75 78 20 73 79 73 74 65 6d 2e 20 4d 6f  Linux system. Mo
0320: 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63  re information c
0330: 61 6e 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 5b  an be found in [
0340: 75 6e 64 72 6f 69 64 77 69 73 68 5d 2e 0d 0a 0d  undroidwish]....
0350: 0a 54 68 65 20 72 65 73 75 6c 74 69 6e 67 20 3c  .The resulting <
0360: 74 74 3e 73 64 6c 32 77 69 73 68 38 2e 36 3c 2f  tt>sdl2wish8.6</
0370: 74 74 3e 2c 20 3c 74 74 3e 73 64 6c 32 77 69 73  tt>, <tt>sdl2wis
0380: 68 38 36 2e 65 78 65 3c 2f 74 74 3e 2c 20 6f 72  h86.exe</tt>, or
0390: 20 5b 75 6e 64 72 6f 69 64 77 69 73 68 5d 20 62   [undroidwish] b
03a0: 69 6e 61 72 69 65 73 20 73 75 70 70 6f 72 74 20  inaries support 
03b0: 61 64 64 69 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61  additional comma
03c0: 6e 64 20 6c 69 6e 65 20 6f 70 74 69 6f 6e 73 20  nd line options 
03d0: 74 6f 20 63 6f 6e 74 72 6f 6c 20 63 65 72 74 61  to control certa
03e0: 69 6e 20 53 44 4c 20 66 65 61 74 75 72 65 73 2e  in SDL features.
03f0: 20 49 6d 70 6f 72 74 61 6e 74 3a 20 74 68 65 73   Important: thes
0400: 65 20 6f 70 74 69 6f 6e 73 20 6d 75 73 74 20 62  e options must b
0410: 65 20 73 70 65 63 69 66 69 65 64 20 6f 6e 20 74  e specified on t
0420: 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20  he command line 
0430: 61 66 74 65 72 20 74 68 65 20 6f 70 74 69 6f 6e  after the option
0440: 61 6c 20 73 63 72 69 70 74 20 74 6f 20 62 65 20  al script to be 
0450: 65 78 65 63 75 74 65 64 3a 0d 0a 0d 0a 3c 74 74  executed:....<tt
0460: 3e 2d 73 64 6c 66 75 6c 6c 73 63 72 65 65 6e 3c  >-sdlfullscreen<
0470: 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 4d 61 6b 65  /tt>....    Make
0480: 20 74 68 65 20 53 44 4c 20 77 69 6e 64 6f 77 20   the SDL window 
0490: 28 74 68 65 20 72 6f 6f 74 20 77 69 6e 64 6f 77  (the root window
04a0: 20 66 6f 72 20 54 6b 29 20 69 6e 74 6f 20 61 20   for Tk) into a 
04b0: 66 75 6c 6c 73 63 72 65 65 6e 20 77 69 6e 64 6f  fullscreen windo
04c0: 77 2e 0d 0a 0d 0a 3c 74 74 3e 2d 73 64 6c 72 65  w.....<tt>-sdlre
04d0: 73 69 7a 61 62 6c 65 3c 2f 74 74 3e 0d 0a 0d 0a  sizable</tt>....
04e0: 20 20 20 20 41 6c 6c 6f 77 20 72 65 73 69 7a 69      Allow resizi
04f0: 6e 67 20 6f 66 20 74 68 65 20 53 44 4c 20 77 69  ng of the SDL wi
0500: 6e 64 6f 77 2e 0d 0a 0d 0a 3c 74 74 3e 2d 73 64  ndow.....<tt>-sd
0510: 6c 6e 6f 62 6f 72 64 65 72 3c 2f 74 74 3e 0d 0a  lnoborder</tt>..
0520: 0d 0a 20 20 20 20 4d 61 6b 65 20 74 68 65 20 53  ..    Make the S
0530: 44 4c 20 77 69 6e 64 6f 77 20 62 6f 72 64 65 72  DL window border
0540: 6c 65 73 73 2c 20 69 2e 65 2e 20 77 69 74 68 6f  less, i.e. witho
0550: 75 74 20 77 69 6e 64 6f 77 20 6d 61 6e 61 67 65  ut window manage
0560: 72 20 64 65 63 6f 72 61 74 69 6f 6e 73 2e 0d 0a  r decorations...
0570: 0d 0a 3c 74 74 3e 2d 73 64 6c 68 65 69 67 68 74  ..<tt>-sdlheight
0580: 20 3c 69 3e 70 69 78 65 6c 73 3c 2f 69 3e 3c 2f   <i>pixels</i></
0590: 74 74 3e 0d 0a 0d 0a 20 20 20 20 53 65 74 20 74  tt>....    Set t
05a0: 68 65 20 68 65 69 67 68 74 20 6f 66 20 74 68 65  he height of the
05b0: 20 53 44 4c 20 77 69 6e 64 6f 77 20 74 6f 20 3c   SDL window to <
05c0: 74 74 3e 3c 69 3e 70 69 78 65 6c 73 3c 2f 69 3e  tt><i>pixels</i>
05d0: 3c 2f 74 74 3e 2e 0d 0a 0d 0a 3c 74 74 3e 2d 73  </tt>.....<tt>-s
05e0: 64 6c 77 69 64 74 68 20 3c 69 3e 70 69 78 65 6c  dlwidth <i>pixel
05f0: 73 3c 2f 69 3e 3c 2f 74 74 3e 0d 0a 0d 0a 20 20  s</i></tt>....  
0600: 20 20 53 65 74 20 74 68 65 20 77 69 64 74 68 20    Set the width 
0610: 6f 66 20 74 68 65 20 53 44 4c 20 77 69 6e 64 6f  of the SDL windo
0620: 77 20 74 6f 20 3c 74 74 3e 3c 69 3e 70 69 78 65  w to <tt><i>pixe
0630: 6c 73 3c 2f 69 3e 3c 2f 74 74 3e 2e 0d 0a 0d 0a  ls</i></tt>.....
0640: 3c 74 74 3e 2d 73 64 6c 72 6f 6f 74 68 65 69 67  <tt>-sdlrootheig
0650: 68 74 20 3c 69 3e 70 69 78 65 6c 73 3c 2f 69 3e  ht <i>pixels</i>
0660: 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 53 65 74  </tt>....    Set
0670: 20 74 68 65 20 68 65 69 67 68 74 20 6f 66 20 74   the height of t
0680: 68 65 20 72 6f 6f 74 20 77 69 6e 64 6f 77 20 28  he root window (
0690: 61 73 20 73 65 65 6e 20 62 79 20 54 6b 29 20 74  as seen by Tk) t
06a0: 6f 20 3c 74 74 3e 3c 69 3e 70 69 78 65 6c 73 3c  o <tt><i>pixels<
06b0: 2f 69 3e 3c 2f 74 74 3e 2e 20 49 66 20 6e 6f 74  /i></tt>. If not
06c0: 20 73 65 74 2c 20 74 68 65 20 72 6f 6f 74 20 77   set, the root w
06d0: 69 6e 64 6f 77 27 73 20 73 69 7a 65 20 69 73 20  indow's size is 
06e0: 65 71 75 61 6c 20 74 6f 20 74 68 65 20 53 44 4c  equal to the SDL
06f0: 20 77 69 6e 64 6f 77 20 73 69 7a 65 2e 0d 0a 0d   window size....
0700: 0a 3c 74 74 3e 2d 73 64 6c 72 6f 6f 74 77 69 64  .<tt>-sdlrootwid
0710: 74 68 20 3c 69 3e 70 69 78 65 6c 73 3c 2f 69 3e  th <i>pixels</i>
0720: 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 53 65 74  </tt>....    Set
0730: 20 74 68 65 20 77 69 64 74 68 20 6f 66 20 74 68   the width of th
0740: 65 20 72 6f 6f 74 20 77 69 6e 64 6f 77 20 28 61  e root window (a
0750: 73 20 73 65 65 6e 20 62 79 20 54 6b 29 20 74 6f  s seen by Tk) to
0760: 20 3c 74 74 3e 3c 69 3e 70 69 78 65 6c 73 3c 2f   <tt><i>pixels</
0770: 69 3e 3c 2f 74 74 3e 2e 20 49 66 20 6e 6f 74 20  i></tt>. If not 
0780: 73 65 74 2c 20 74 68 65 20 72 6f 6f 74 20 77 69  set, the root wi
0790: 6e 64 6f 77 27 73 20 73 69 7a 65 20 69 73 20 65  ndow's size is e
07a0: 71 75 61 6c 20 74 6f 20 74 68 65 20 53 44 4c 20  qual to the SDL 
07b0: 77 69 6e 64 6f 77 20 73 69 7a 65 2e 0d 0a 0d 0a  window size.....
07c0: 3c 74 74 3e 2d 73 64 6c 78 64 70 69 20 3c 69 3e  <tt>-sdlxdpi <i>
07d0: 64 70 69 3c 2f 69 3e 3c 2f 74 74 3e 0d 0a 0d 0a  dpi</i></tt>....
07e0: 20 20 20 20 53 65 74 20 74 68 65 20 64 6f 74 73      Set the dots
07f0: 20 70 65 72 20 69 6e 63 68 20 72 61 74 69 6f 20   per inch ratio 
0800: 66 6f 72 20 74 68 65 20 58 20 64 69 6d 65 6e 73  for the X dimens
0810: 69 6f 6e 20 74 6f 20 3c 74 74 3e 3c 69 3e 64 70  ion to <tt><i>dp
0820: 69 3c 2f 69 3e 3c 2f 74 74 3e 2e 20 49 66 20 62  i</i></tt>. If b
0830: 6f 74 68 2c 20 3c 74 74 3e 2d 73 64 6c 78 64 70  oth, <tt>-sdlxdp
0840: 69 3c 2f 74 74 3e 20 61 6e 64 20 3c 74 74 3e 2d  i</tt> and <tt>-
0850: 73 64 6c 79 64 70 69 3c 2f 74 74 3e 20 61 72 65  sdlydpi</tt> are
0860: 20 6e 6f 74 20 73 65 74 2c 20 74 68 65 20 64 65   not set, the de
0870: 66 61 75 6c 74 20 69 73 20 61 70 70 72 6f 78 2e  fault is approx.
0880: 20 37 35 20 64 70 69 2e 20 49 66 20 6f 6e 6c 79   75 dpi. If only
0890: 20 6f 6e 65 20 64 69 6d 65 6e 73 69 6f 6e 20 69   one dimension i
08a0: 73 20 73 65 74 20 28 3c 74 74 3e 2d 73 64 6c 78  s set (<tt>-sdlx
08b0: 64 70 69 3c 2f 74 74 3e 20 6f 72 20 3c 74 74 3e  dpi</tt> or <tt>
08c0: 2d 73 64 6c 79 64 70 69 3c 2f 74 74 3e 29 2c 20  -sdlydpi</tt>), 
08d0: 74 68 61 74 20 76 61 6c 75 65 20 69 73 20 74 61  that value is ta
08e0: 6b 65 6e 20 61 73 20 6f 76 65 72 61 6c 6c 20 64  ken as overall d
08f0: 6f 74 73 20 70 65 72 20 69 6e 63 68 20 72 61 74  ots per inch rat
0900: 69 6f 2e 0d 0a 0d 0a 3c 74 74 3e 2d 73 64 6c 79  io.....<tt>-sdly
0910: 64 70 69 20 3c 69 3e 64 70 69 3c 2f 69 3e 3c 2f  dpi <i>dpi</i></
0920: 74 74 3e 0d 0a 0d 0a 20 20 20 20 53 65 74 20 74  tt>....    Set t
0930: 68 65 20 64 6f 74 73 20 70 65 72 20 69 6e 63 68  he dots per inch
0940: 20 72 61 74 69 6f 20 66 6f 72 20 74 68 65 20 59   ratio for the Y
0950: 20 64 69 6d 65 6e 73 69 6f 6e 20 74 6f 20 3c 74   dimension to <t
0960: 74 3e 3c 69 3e 64 70 69 3c 2f 69 3e 3c 2f 74 74  t><i>dpi</i></tt
0970: 3e 2e 20 49 66 20 62 6f 74 68 2c 20 3c 74 74 3e  >. If both, <tt>
0980: 2d 73 64 6c 78 64 70 69 3c 2f 74 74 3e 20 61 6e  -sdlxdpi</tt> an
0990: 64 20 3c 74 74 3e 2d 73 64 6c 79 64 70 69 3c 2f  d <tt>-sdlydpi</
09a0: 74 74 3e 20 61 72 65 20 6e 6f 74 20 73 65 74 2c  tt> are not set,
09b0: 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 20   the default is 
09c0: 61 70 70 72 6f 78 2e 20 37 35 20 64 70 69 2e 20  approx. 75 dpi. 
09d0: 49 66 20 6f 6e 6c 79 20 6f 6e 65 20 64 69 6d 65  If only one dime
09e0: 6e 73 69 6f 6e 20 69 73 20 73 65 74 20 28 3c 74  nsion is set (<t
09f0: 74 3e 2d 73 64 6c 78 64 70 69 3c 2f 74 74 3e 20  t>-sdlxdpi</tt> 
0a00: 6f 72 20 3c 74 74 3e 2d 73 64 6c 79 64 70 69 3c  or <tt>-sdlydpi<
0a10: 2f 74 74 3e 29 2c 20 74 68 61 74 20 76 61 6c 75  /tt>), that valu
0a20: 65 20 69 73 20 74 61 6b 65 6e 20 61 73 20 6f 76  e is taken as ov
0a30: 65 72 61 6c 6c 20 64 6f 74 73 20 70 65 72 20 69  erall dots per i
0a40: 6e 63 68 20 72 61 74 69 6f 2e 0d 0a 0d 0a 3c 74  nch ratio.....<t
0a50: 74 3e 2d 73 64 6c 6e 6f 67 6c 3c 2f 74 74 3e 0d  t>-sdlnogl</tt>.
0a60: 0a 0d 0a 20 20 20 20 46 6f 72 63 65 20 75 73 69  ...    Force usi
0a70: 6e 67 20 74 68 65 20 73 6f 66 74 77 61 72 65 20  ng the software 
0a80: 72 65 6e 64 65 72 65 72 2e 20 54 68 69 73 20 74  renderer. This t
0a90: 75 72 6e 73 20 4f 70 65 6e 47 4c 20 75 73 61 67  urns OpenGL usag
0aa0: 65 20 6f 66 66 2e 0d 0a 0d 0a 3c 74 74 3e 2d 73  e off.....<tt>-s
0ab0: 64 6c 6c 6f 67 20 3c 69 3e 6c 65 76 65 6c 3c 2f  dllog <i>level</
0ac0: 69 3e 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 53  i></tt>....    S
0ad0: 65 74 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20 6c  et the minimum l
0ae0: 6f 67 20 6c 65 76 65 6c 20 74 6f 20 62 65 20 73  og level to be s
0af0: 68 6f 77 6e 20 69 6e 20 53 44 4c 20 6c 6f 67 20  hown in SDL log 
0b00: 6d 65 73 73 61 67 65 2e 20 3c 74 74 3e 3c 69 3e  message. <tt><i>
0b10: 6c 65 76 65 6c 3c 2f 69 3e 3c 2f 74 74 3e 20 6d  level</i></tt> m
0b20: 75 73 74 20 62 65 20 61 20 70 6f 73 69 74 69 76  ust be a positiv
0b30: 65 20 69 6e 74 65 67 65 72 2e 0d 0a 0d 0a 3c 74  e integer.....<t
0b40: 74 3e 2d 73 64 6c 69 63 6f 6e 20 3c 69 3e 66 69  t>-sdlicon <i>fi
0b50: 6c 65 6e 61 6d 65 3c 2f 69 3e 3c 2f 74 74 3e 0d  lename</i></tt>.
0b60: 0a 0d 0a 20 20 20 20 53 65 74 20 74 68 65 20 53  ...    Set the S
0b70: 44 4c 20 72 6f 6f 74 20 77 69 6e 64 6f 77 20 69  DL root window i
0b80: 63 6f 6e 20 74 6f 20 74 68 65 20 42 4d 50 20 69  con to the BMP i
0b90: 6d 61 67 65 20 66 72 6f 6d 20 3c 74 74 3e 3c 69  mage from <tt><i
0ba0: 3e 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 3c 2f 74  >filename</i></t
0bb0: 74 3e 2e 0d 0a 0d 0a 3c 74 74 3e 2d 73 64 6c 6e  t>.....<tt>-sdln
0bc0: 6f 73 79 73 66 6f 6e 74 73 3c 2f 74 74 3e 0d 0a  osysfonts</tt>..
0bd0: 0d 0a 20 20 20 20 44 6f 6e 27 74 20 73 65 61 72  ..    Don't sear
0be0: 63 68 20 66 6f 72 20 61 6e 64 20 72 65 67 69 73  ch for and regis
0bf0: 74 65 72 20 73 79 73 74 65 6d 20 66 6f 6e 74 73  ter system fonts
0c00: 2e 20 54 68 69 73 20 63 61 6e 20 72 65 64 75 63  . This can reduc
0c10: 65 20 73 74 61 72 74 75 70 20 74 69 6d 65 20 73  e startup time s
0c20: 69 67 6e 69 66 69 63 61 6e 74 6c 79 2e 0d 0a 0d  ignificantly....
0c30: 0a 3c 74 74 3e 2d 73 64 6c 6f 70 61 63 69 74 79  .<tt>-sdlopacity
0c40: 20 3c 69 3e 76 61 6c 75 65 3c 2f 69 3e 3c 2f 74   <i>value</i></t
0c50: 74 3e 0d 0a 0d 0a 20 20 20 20 53 65 74 20 74 68  t>....    Set th
0c60: 65 20 69 6e 69 74 69 61 6c 20 6f 70 61 63 69 74  e initial opacit
0c70: 79 20 6f 66 20 74 68 65 20 53 44 4c 20 72 6f 6f  y of the SDL roo
0c80: 74 20 77 69 6e 64 6f 77 2e 20 3c 74 74 3e 3c 69  t window. <tt><i
0c90: 3e 76 61 6c 75 65 3c 2f 69 3e 3c 2f 74 74 3e 20  >value</i></tt> 
0ca0: 6d 75 73 74 20 62 65 20 67 69 76 65 6e 20 61 73  must be given as
0cb0: 20 70 6f 73 69 74 69 76 65 20 69 6e 74 65 67 65   positive intege
0cc0: 72 20 70 65 72 63 65 6e 74 61 67 65 2e 0d 0a 0d  r percentage....
0cd0: 0a 3c 74 74 3e 2d 73 64 6c 73 77 63 75 72 73 6f  .<tt>-sdlswcurso
0ce0: 72 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 46 6f  r</tt>....    Fo
0cf0: 72 63 65 20 75 73 65 20 6f 66 20 61 20 73 6f 66  rce use of a sof
0d00: 74 77 61 72 65 20 63 75 72 73 6f 72 20 74 65 78  tware cursor tex
0d10: 74 75 72 65 2e 20 55 73 65 66 75 6c 2c 20 77 68  ture. Useful, wh
0d20: 65 6e 20 6e 6f 20 70 72 6f 70 65 72 20 68 61 72  en no proper har
0d30: 64 77 61 72 65 20 63 75 72 73 6f 72 20 73 75 70  dware cursor sup
0d40: 70 6f 72 74 20 69 73 20 61 76 61 69 6c 61 62 6c  port is availabl
0d50: 65 2c 20 65 2e 67 2e 20 69 6e 20 48 61 69 6b 75  e, e.g. in Haiku
0d60: 20 75 73 69 6e 67 20 74 68 65 20 4f 70 65 6e 47   using the OpenG
0d70: 4c 20 72 65 6e 64 65 72 20 64 72 69 76 65 72 2e  L render driver.
0d80: 0d 0a 0d 0a 53 6f 6d 65 20 53 44 4c 20 72 75 6e  ....Some SDL run
0d90: 74 69 6d 65 20 73 77 69 74 63 68 65 73 20 6d 75  time switches mu
0da0: 73 74 20 62 65 20 73 70 65 63 69 66 69 65 64 20  st be specified 
0db0: 65 61 72 6c 79 20 62 79 20 73 65 74 74 69 6e 67  early by setting
0dc0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
0dd0: 69 61 62 6c 65 73 2e 20 41 6c 6c 20 74 68 65 73  iables. All thes
0de0: 65 20 73 77 69 74 63 68 65 73 20 61 72 65 20 64  e switches are d
0df0: 6f 63 75 6d 65 6e 74 65 64 20 69 6e 20 74 68 65  ocumented in the
0e00: 20 3c 62 3e 53 44 4c 5f 68 69 6e 74 73 2e 68 3c   <b>SDL_hints.h<
0e10: 2f 62 3e 20 68 65 61 64 65 72 20 66 69 6c 65 2e  /b> header file.
0e20: 20 54 68 65 20 6d 6f 73 74 20 69 6d 70 6f 72 74   The most import
0e30: 61 6e 74 20 61 72 65 3a 0d 0a 0d 0a 3c 74 74 3e  ant are:....<tt>
0e40: 53 44 4c 5f 56 49 44 45 4f 44 52 49 56 45 52 3c  SDL_VIDEODRIVER<
0e50: 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 41 20 73 74  /tt>....    A st
0e60: 72 69 6e 67 20 73 65 6c 65 63 74 69 6e 67 20 74  ring selecting t
0e70: 68 65 20 76 69 64 65 6f 20 64 72 69 76 65 72 2c  he video driver,
0e80: 20 75 73 65 20 69 74 20 74 6f 20 65 6e 61 62 6c   use it to enabl
0e90: 65 20 74 68 65 20 3c 62 3e 6a 73 6d 70 65 67 3c  e the <b>jsmpeg<
0ea0: 2f 62 3e 20 76 69 64 65 6f 20 64 72 69 76 65 72  /b> video driver
0eb0: 2e 0d 0a 0d 0a 3c 74 74 3e 53 44 4c 5f 52 45 4e  .....<tt>SDL_REN
0ec0: 44 45 52 5f 44 52 49 56 45 52 3c 2f 74 74 3e 0d  DER_DRIVER</tt>.
0ed0: 0a 0d 0a 20 20 20 20 41 20 73 74 72 69 6e 67 20  ...    A string 
0ee0: 73 65 6c 65 63 74 69 6e 67 20 74 68 65 20 53 44  selecting the SD
0ef0: 4c 20 72 65 6e 64 65 72 65 72 2e 20 4e 6f 72 6d  L renderer. Norm
0f00: 61 6c 6c 79 20 63 68 6f 73 65 6e 20 61 75 74 6f  ally chosen auto
0f10: 6d 61 74 69 63 61 6c 6c 79 20 62 75 74 20 73 6f  matically but so
0f20: 6d 65 74 69 6d 65 73 20 69 74 20 63 61 6e 20 62  metimes it can b
0f30: 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 65  e necessary to e
0f40: 78 70 6c 69 63 69 74 6c 79 20 74 75 72 6e 20 6f  xplicitly turn o
0f50: 6e 20 74 68 65 20 3c 62 3e 73 6f 66 74 77 61 72  n the <b>softwar
0f60: 65 3c 2f 62 3e 20 72 65 6e 64 65 72 65 72 2e 20  e</b> renderer. 
0f70: 4f 74 68 65 72 20 70 6f 73 73 69 62 6c 65 20 76  Other possible v
0f80: 61 6c 75 65 73 20 64 65 70 65 6e 64 20 6f 6e 20  alues depend on 
0f90: 68 6f 77 20 53 44 4c 20 77 61 73 20 62 75 69 6c  how SDL was buil
0fa0: 74 2c 20 65 2e 67 20 3c 62 3e 6f 70 65 6e 67 6c  t, e.g <b>opengl
0fb0: 3c 2f 62 3e 2c 20 3c 62 3e 6f 70 65 6e 67 6c 65  </b>, <b>opengle
0fc0: 73 32 3c 2f 62 3e 20 65 74 63 2e 0d 0a 0d 0a 20  s2</b> etc..... 
0fd0: 0a 5a 20 37 30 64 33 39 62 64 66 61 38 30 30 35  .Z 70d39bdfa8005
0fe0: 63 66 38 39 66 63 37 62 34 30 33 31 66 37 33 33  cf89fc7b4031f733
0ff0: 38 37 63 0a                                      87c.