Hex Artifact Content
Not logged in

Artifact 89c24ff0128bb6c26ea8cd1abaeb82c9fc669112:

Wiki page [jsmpeg SDL Video Driver] by chw 2019-11-16 11:18:51.
0000: 44 20 32 30 31 39 2d 31 31 2d 31 36 54 31 31 3a  D 2019-11-16T11:
0010: 31 38 3a 35 31 2e 36 35 33 0a 4c 20 6a 73 6d 70  18:51.653.L jsmp
0020: 65 67 5c 73 53 44 4c 5c 73 56 69 64 65 6f 5c 73  eg\sSDL\sVideo\s
0030: 44 72 69 76 65 72 0a 50 20 36 64 33 38 30 64 34  Driver.P 6d380d4
0040: 30 61 37 33 64 61 31 39 39 63 36 37 63 35 66 65  0a73da199c67c5fe
0050: 64 65 32 32 63 62 61 32 33 63 62 63 66 34 63 37  de22cba23cbcf4c7
0060: 63 0a 55 20 63 68 77 0a 57 20 35 36 35 33 0a 3c  c.U chw.W 5653.<
0070: 68 32 3e 6a 73 6d 70 65 67 20 53 44 4c 20 56 69  h2>jsmpeg SDL Vi
0080: 64 65 6f 20 44 72 69 76 65 72 3c 2f 68 32 3e 0d  deo Driver</h2>.
0090: 0a 0d 0a 41 6e 20 65 78 70 65 72 69 6d 65 6e 74  ...An experiment
00a0: 61 6c 20 53 44 4c 20 76 69 64 65 6f 20 64 72 69  al SDL video dri
00b0: 76 65 72 20 6e 61 6d 65 64 20 3c 62 3e 6a 73 6d  ver named <b>jsm
00c0: 70 65 67 3c 2f 62 3e 20 69 73 20 70 72 6f 76 69  peg</b> is provi
00d0: 64 65 64 20 73 69 6e 63 65 20 56 61 6c 65 6e 74  ded since Valent
00e0: 69 6e 65 27 73 20 44 61 79 20 32 30 31 39 2e 20  ine's Day 2019. 
00f0: 49 74 20 75 73 65 73 20 74 68 65 20 74 65 63 68  It uses the tech
0100: 6e 69 71 75 65 20 64 65 73 63 72 69 62 65 64 20  nique described 
0110: 69 6e 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70  in <a href="http
0120: 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 70  s://github.com/p
0130: 68 6f 62 6f 73 6c 61 62 2f 6a 73 6d 70 65 67 22  hoboslab/jsmpeg"
0140: 3e 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e  >https://github.
0150: 63 6f 6d 2f 70 68 6f 62 6f 73 6c 61 62 2f 6a 73  com/phoboslab/js
0160: 6d 70 65 67 3c 2f 61 3e 20 61 6e 64 20 3c 61 20  mpeg</a> and <a 
0170: 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 67 69  href="https://gi
0180: 74 68 75 62 2e 63 6f 6d 2f 70 68 6f 62 6f 73 6c  thub.com/phobosl
0190: 61 62 2f 6a 73 6d 70 65 67 2d 76 6e 63 22 3e 68  ab/jsmpeg-vnc">h
01a0: 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f  ttps://github.co
01b0: 6d 2f 70 68 6f 62 6f 73 6c 61 62 2f 6a 73 6d 70  m/phoboslab/jsmp
01c0: 65 67 2d 76 6e 63 3c 2f 61 3e 20 69 6e 20 63 6f  eg-vnc</a> in co
01d0: 6d 62 69 6e 61 74 69 6f 6e 20 77 69 74 68 20 48  mbination with H
01e0: 54 4d 4c 35 20 61 6e 64 20 57 65 62 47 4c 20 69  TML5 and WebGL i
01f0: 6e 20 61 20 6d 6f 64 65 72 6e 20 62 72 6f 77 73  n a modern brows
0200: 65 72 20 74 6f 20 70 72 6f 76 69 64 65 20 64 69  er to provide di
0210: 73 70 6c 61 79 2c 20 6d 6f 75 73 65 2c 20 61 6e  splay, mouse, an
0220: 64 20 6b 65 79 62 6f 61 72 64 20 74 6f 20 61 20  d keyboard to a 
0230: 6e 6f 72 6d 61 6c 20 5b 75 6e 64 72 6f 69 64 77  normal [undroidw
0240: 69 73 68 5d 2e 20 0d 0a 0d 0a 54 68 69 73 20 6d  ish]. ....This m
0250: 65 61 6e 73 2c 20 74 68 61 74 20 74 68 65 20 72  eans, that the r
0260: 65 6e 64 65 72 69 6e 67 20 69 73 20 70 65 72 66  endering is perf
0270: 6f 72 6d 65 64 20 69 6e 74 6f 20 61 20 6d 65 6d  ormed into a mem
0280: 6f 72 79 20 62 75 66 66 65 72 2c 20 77 68 69 63  ory buffer, whic
0290: 68 20 69 73 20 65 6e 63 6f 64 65 64 20 69 6e 74  h is encoded int
02a0: 6f 20 61 20 6d 6f 64 69 66 69 65 64 20 4d 50 45  o a modified MPE
02b0: 47 2d 31 20 74 72 61 6e 73 70 6f 72 74 20 73 74  G-1 transport st
02c0: 72 65 61 6d 2c 20 73 65 6e 74 20 6f 76 65 72 20  ream, sent over 
02d0: 61 20 57 65 62 73 6f 63 6b 65 74 20 74 6f 20 61  a Websocket to a
02e0: 20 77 65 62 20 62 72 6f 77 73 65 72 2c 20 77 68   web browser, wh
02f0: 69 63 68 20 70 65 72 66 6f 72 6d 73 20 4d 50 45  ich performs MPE
0300: 47 2d 31 20 64 65 63 6f 64 69 6e 67 20 61 6e 64  G-1 decoding and
0310: 20 72 65 6e 64 65 72 69 6e 67 20 69 6e 74 6f 20   rendering into 
0320: 61 20 48 54 4d 4c 35 20 63 61 6e 76 61 73 20 6f  a HTML5 canvas o
0330: 70 74 69 6f 6e 61 6c 6c 79 20 75 73 69 6e 67 20  ptionally using 
0340: 57 65 62 47 4c 2e 20 4c 69 6b 65 77 69 73 65 2c  WebGL. Likewise,
0350: 20 6d 6f 75 73 65 20 61 6e 64 20 6b 65 79 62 6f   mouse and keybo
0360: 61 72 64 20 65 76 65 6e 74 73 20 61 72 65 20 73  ard events are s
0370: 65 6e 74 20 6f 6e 20 74 68 65 20 73 61 6d 65 20  ent on the same 
0380: 57 65 62 73 6f 63 6b 65 74 20 66 72 6f 6d 20 74  Websocket from t
0390: 68 65 20 62 72 6f 77 73 65 72 20 62 61 63 6b 20  he browser back 
03a0: 74 6f 20 74 68 65 20 3c 62 3e 6a 73 6d 70 65 67  to the <b>jsmpeg
03b0: 3c 2f 62 3e 20 64 72 69 76 65 72 2c 20 74 72 61  </b> driver, tra
03c0: 6e 73 66 6f 72 6d 65 64 20 74 6f 20 53 44 4c 20  nsformed to SDL 
03d0: 6d 6f 75 73 65 20 61 6e 64 20 6b 65 79 62 6f 61  mouse and keyboa
03e0: 72 64 20 65 76 65 6e 74 73 20 61 6e 64 20 66 75  rd events and fu
03f0: 72 74 68 65 72 20 70 72 6f 63 65 73 73 65 64 20  rther processed 
0400: 62 79 20 74 68 65 20 5b 75 6e 64 72 6f 69 64 77  by the [undroidw
0410: 69 73 68 5d 20 61 70 70 6c 69 63 61 74 69 6f 6e  ish] application
0420: 2e 0d 0a 0d 0a 46 72 61 6d 65 20 72 61 74 65 20  .....Frame rate 
0430: 61 6e 64 20 72 65 71 75 69 72 65 64 20 62 61 6e  and required ban
0440: 64 77 69 64 74 68 20 61 72 65 20 6d 6f 64 65 72  dwidth are moder
0450: 61 74 65 2e 20 43 75 72 72 65 6e 74 6c 79 2c 20  ate. Currently, 
0460: 32 35 20 66 72 61 6d 65 73 20 70 65 72 20 73 65  25 frames per se
0470: 63 6f 6e 64 73 20 61 72 65 20 73 65 6e 74 20 61  conds are sent a
0480: 74 20 6d 6f 73 74 2c 20 77 68 69 63 68 20 72 65  t most, which re
0490: 71 75 69 72 65 20 73 6f 6d 65 20 66 65 77 20 68  quire some few h
04a0: 75 6e 64 72 65 64 20 6b 69 6c 6f 62 69 74 73 20  undred kilobits 
04b0: 70 65 72 20 73 65 63 6f 6e 64 2e 20 53 69 6e 63  per second. Sinc
04c0: 65 20 41 70 72 69 6c 20 32 30 31 39 20 6c 69 6d  e April 2019 lim
04d0: 69 74 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72  ited support for
04e0: 20 4f 70 65 6e 47 4c 20 69 73 20 61 76 61 69 6c   OpenGL is avail
04f0: 61 62 6c 65 20 66 6f 72 20 74 68 65 20 43 61 6e  able for the Can
0500: 76 61 73 33 44 20 61 6e 64 20 74 6b 5a 69 6e 63  vas3D and tkZinc
0510: 20 77 69 64 67 65 74 73 2e 20 49 74 20 72 65 71   widgets. It req
0520: 75 69 72 65 73 20 61 20 77 6f 72 6b 69 6e 67 20  uires a working 
0530: 45 47 4c 2f 4f 70 65 6e 47 4c 20 69 6e 66 72 61  EGL/OpenGL infra
0540: 73 74 72 75 63 74 75 72 65 20 28 4c 69 6e 75 78  structure (Linux
0550: 20 65 74 63 2e 29 20 6f 72 20 57 69 6e 64 6f 77   etc.) or Window
0560: 73 20 4f 70 65 6e 47 4c 2e 20 4f 6e 20 4c 69 6e  s OpenGL. On Lin
0570: 75 78 20 74 68 69 73 20 6e 6f 72 6d 61 6c 6c 79  ux this normally
0580: 20 72 65 71 75 69 72 65 73 20 61 6e 20 58 31 31   requires an X11
0590: 20 64 69 73 70 6c 61 79 20 63 6f 6e 6e 65 63 74   display connect
05a0: 69 6f 6e 20 65 78 63 65 70 74 20 66 6f 72 20 76  ion except for v
05b0: 65 72 79 20 72 65 63 65 6e 74 20 76 65 72 73 69  ery recent versi
05c0: 6f 6e 73 20 6f 66 20 4d 65 73 61 20 61 6e 64 20  ons of Mesa and 
05d0: 47 50 55 20 64 72 69 76 65 72 73 2c 20 69 2e 65  GPU drivers, i.e
05e0: 2e 20 6f 6e 20 44 65 62 69 61 6e 20 31 30 20 61  . on Debian 10 a
05f0: 6e 64 20 46 65 64 6f 72 61 20 33 30 20 74 68 65  nd Fedora 30 the
0600: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
0610: 69 61 62 6c 65 20 3c 62 3e 45 47 4c 5f 44 49 53  iable <b>EGL_DIS
0620: 50 4c 41 59 3c 2f 62 3e 20 63 61 6e 20 62 65 20  PLAY</b> can be 
0630: 73 65 74 20 74 6f 20 3c 62 3e 73 75 72 66 61 63  set to <b>surfac
0640: 65 6c 65 73 73 3c 2f 62 3e 20 69 6e 20 6f 72 64  eless</b> in ord
0650: 65 72 20 74 6f 20 74 75 72 6e 20 6f 6e 20 68 65  er to turn on he
0660: 61 64 6c 65 73 73 20 47 50 55 20 6d 6f 64 65 2e  adless GPU mode.
0670: 0d 0a 0d 0a 46 6f 72 20 74 68 65 20 61 64 76 65  ....For the adve
0680: 6e 74 75 72 6f 75 73 2c 20 74 68 65 72 65 20 69  nturous, there i
0690: 73 20 61 20 74 65 73 74 20 76 65 72 73 69 6f 6e  s a test version
06a0: 20 66 6f 72 20 3c 61 20 68 72 65 66 3d 22 68 74   for <a href="ht
06b0: 74 70 3a 2f 2f 77 77 77 2e 63 68 2d 77 65 72 6e  tp://www.ch-wern
06c0: 65 72 2e 64 65 2f 41 6e 64 72 6f 57 69 73 68 2f  er.de/AndroWish/
06d0: 75 6e 64 72 6f 69 64 77 69 73 68 2d 78 38 36 5f  undroidwish-x86_
06e0: 36 34 2d 64 65 62 39 22 3e 4c 69 6e 75 78 20 78  64-deb9">Linux x
06f0: 38 36 5f 36 34 3c 2f 61 3e 20 28 44 65 62 69 61  86_64</a> (Debia
0700: 6e 20 39 2c 20 46 65 64 6f 72 61 20 33 30 2c 20  n 9, Fedora 30, 
0710: 43 65 6e 74 4f 53 20 37 29 2c 20 3c 61 20 68 72  CentOS 7), <a hr
0720: 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 63  ef="http://www.c
0730: 68 2d 77 65 72 6e 65 72 2e 64 65 2f 41 6e 64 72  h-werner.de/Andr
0740: 6f 57 69 73 68 2f 75 6e 64 72 6f 69 64 77 69 73  oWish/undroidwis
0750: 68 2d 77 69 6e 33 32 2e 65 78 65 22 3e 57 69 6e  h-win32.exe">Win
0760: 64 6f 77 73 20 33 32 20 62 69 74 3c 2f 61 3e 20  dows 32 bit</a> 
0770: 28 58 50 20 6f 72 20 6e 65 77 65 72 29 2c 20 3c  (XP or newer), <
0780: 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77  a href="http://w
0790: 77 77 2e 63 68 2d 77 65 72 6e 65 72 2e 64 65 2f  ww.ch-werner.de/
07a0: 41 6e 64 72 6f 57 69 73 68 2f 75 6e 64 72 6f 69  AndroWish/undroi
07b0: 64 77 69 73 68 2d 77 69 6e 36 34 2e 65 78 65 22  dwish-win64.exe"
07c0: 3e 57 69 6e 64 6f 77 73 20 36 34 20 62 69 74 3c  >Windows 64 bit<
07d0: 2f 61 3e 20 28 58 50 20 6f 72 20 6e 65 77 65 72  /a> (XP or newer
07e0: 29 2c 20 61 6e 64 20 3c 61 20 68 72 65 66 3d 22  ), and <a href="
07f0: 68 74 74 70 3a 2f 2f 77 77 77 2e 63 68 2d 77 65  http://www.ch-we
0800: 72 6e 65 72 2e 64 65 2f 41 6e 64 72 6f 57 69 73  rner.de/AndroWis
0810: 68 2f 75 6e 64 72 6f 69 64 77 69 73 68 2e 64 6d  h/undroidwish.dm
0820: 67 22 3e 4d 61 63 4f 53 58 3c 2f 61 3e 20 28 74  g">MacOSX</a> (t
0830: 65 73 74 65 64 20 6f 6e 20 48 69 67 68 20 53 69  ested on High Si
0840: 65 72 72 61 29 2e 20 41 6c 6c 20 63 61 6e 20 62  erra). All can b
0850: 65 20 72 75 6e 20 75 73 69 6e 67 20 74 68 65 20  e run using the 
0860: 3c 62 3e 6a 73 6d 70 65 67 3c 2f 62 3e 20 76 69  <b>jsmpeg</b> vi
0870: 64 65 6f 20 64 72 69 76 65 72 20 77 68 65 6e 20  deo driver when 
0880: 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20  the environment 
0890: 76 61 72 69 61 62 6c 65 20 3c 62 3e 53 44 4c 5f  variable <b>SDL_
08a0: 56 49 44 45 4f 44 52 49 56 45 52 3c 2f 62 3e 20  VIDEODRIVER</b> 
08b0: 68 61 73 20 74 68 65 20 76 61 6c 75 65 20 3c 62  has the value <b
08c0: 3e 6a 73 6d 70 65 67 3c 2f 62 3e 20 61 6e 64 20  >jsmpeg</b> and 
08d0: 74 68 65 20 72 65 71 75 69 72 65 64 20 3c 61 20  the required <a 
08e0: 68 72 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77 77  href="https://ww
08f0: 77 2e 66 66 6d 70 65 67 2e 6f 72 67 22 3e 46 46  w.ffmpeg.org">FF
0900: 4d 70 65 67 3c 2f 61 3e 20 44 4c 4c 73 2f 73 68  Mpeg</a> DLLs/sh
0910: 61 72 65 64 20 6c 69 62 72 61 72 69 65 73 20 61  ared libraries a
0920: 72 65 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20  re available on 
0930: 74 68 65 20 73 79 73 74 65 6d 2c 20 65 2e 67 2e  the system, e.g.
0940: 0d 0a 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a  ....<verbatim>..
0950: 20 20 20 20 23 20 50 4f 53 49 58 0d 0a 20 20 20      # POSIX..   
0960: 20 65 78 70 6f 72 74 20 53 44 4c 5f 56 49 44 45   export SDL_VIDE
0970: 4f 44 52 49 56 45 52 3d 6a 73 6d 70 65 67 20 0d  ODRIVER=jsmpeg .
0980: 0a 20 20 20 20 2e 2f 75 6e 64 72 6f 69 64 77 69  .    ./undroidwi
0990: 73 68 2d 78 38 36 5f 36 34 2d 64 65 62 39 20 62  sh-x86_64-deb9 b
09a0: 75 69 6c 74 69 6e 3a 77 69 64 67 65 74 20 2d 73  uiltin:widget -s
09b0: 64 6c 77 69 64 74 68 20 38 30 30 20 2d 73 64 6c  dlwidth 800 -sdl
09c0: 68 65 69 67 68 74 20 36 30 30 0d 0a 3c 2f 76 65  height 600..</ve
09d0: 72 62 61 74 69 6d 3e 0d 0a 0d 0a 3c 76 65 72 62  rbatim>....<verb
09e0: 61 74 69 6d 3e 0d 0a 20 20 20 20 52 45 4d 20 57  atim>..    REM W
09f0: 69 6e 64 6f 77 73 0d 0a 20 20 20 20 53 45 54 20  indows..    SET 
0a00: 53 44 4c 5f 56 49 44 45 4f 44 52 49 56 45 52 3d  SDL_VIDEODRIVER=
0a10: 6a 73 6d 70 65 67 0d 0a 20 20 20 20 75 6e 64 72  jsmpeg..    undr
0a20: 6f 69 64 77 69 73 68 2d 77 69 6e 33 32 2e 65 78  oidwish-win32.ex
0a30: 65 20 62 75 69 6c 74 69 6e 3a 77 69 64 67 65 74  e builtin:widget
0a40: 20 2d 73 64 6c 77 69 64 74 68 20 38 30 30 20 2d   -sdlwidth 800 -
0a50: 73 64 6c 68 65 69 67 68 74 20 36 30 30 0d 0a 3c  sdlheight 600..<
0a60: 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 0d 0a 0d 0a  /verbatim>......
0a70: 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 20 20 20 20  <verbatim>..    
0a80: 23 20 4d 61 63 20 4f 53 58 0d 0a 20 20 20 20 65  # Mac OSX..    e
0a90: 78 70 6f 72 74 20 53 44 4c 5f 56 49 44 45 4f 44  xport SDL_VIDEOD
0aa0: 52 49 56 45 52 3d 6a 73 6d 70 65 67 0d 0a 20 20  RIVER=jsmpeg..  
0ab0: 20 20 2f 41 70 70 6c 69 63 61 74 69 6f 6e 73 2f    /Applications/
0ac0: 75 6e 64 72 6f 69 64 77 69 73 68 2e 61 70 70 2f  undroidwish.app/
0ad0: 43 6f 6e 74 65 6e 74 73 2f 4d 61 63 4f 53 2f 75  Contents/MacOS/u
0ae0: 6e 64 72 6f 69 64 77 69 73 68 20 62 75 69 6c 74  ndroidwish built
0af0: 69 6e 3a 77 69 64 67 65 74 20 2d 73 64 6c 77 69  in:widget -sdlwi
0b00: 64 74 68 20 38 30 30 20 2d 73 64 6c 68 65 69 67  dth 800 -sdlheig
0b10: 68 74 20 36 30 30 0d 0a 3c 2f 76 65 72 62 61 74  ht 600..</verbat
0b20: 69 6d 3e 0d 0a 0d 0a 0d 0a 46 6f 72 20 57 69 6e  im>......For Win
0b30: 64 6f 77 73 2c 20 74 68 65 20 72 65 71 75 69 72  dows, the requir
0b40: 65 64 20 44 4c 4c 73 20 61 72 65 20 3c 62 3e 61  ed DLLs are <b>a
0b50: 76 75 74 69 6c 2d 35 36 2e 64 6c 6c 3c 2f 62 3e  vutil-56.dll</b>
0b60: 2c 20 3c 62 3e 61 76 63 6f 64 65 63 2d 35 38 2e  , <b>avcodec-58.
0b70: 64 6c 6c 3c 2f 62 3e 2c 20 3c 62 3e 73 77 72 65  dll</b>, <b>swre
0b80: 73 61 6d 70 6c 65 2d 33 2e 64 6c 6c 3c 2f 62 3e  sample-3.dll</b>
0b90: 2c 20 61 6e 64 20 3c 62 3e 73 77 73 63 61 6c 65  , and <b>swscale
0ba0: 2d 35 2e 64 6c 6c 3c 2f 62 3e 20 77 68 69 63 68  -5.dll</b> which
0bb0: 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 66   are available f
0bc0: 72 6f 6d 20 3c 61 20 68 72 65 66 3d 22 68 74 74  rom <a href="htt
0bd0: 70 73 3a 2f 2f 77 77 77 2e 66 66 6d 70 65 67 2e  ps://www.ffmpeg.
0be0: 6f 72 67 2f 64 6f 77 6e 6c 6f 61 64 2e 68 74 6d  org/download.htm
0bf0: 6c 22 3e 68 74 74 70 73 3a 2f 2f 77 77 77 2e 66  l">https://www.f
0c00: 66 6d 70 65 67 2e 6f 72 67 2f 64 6f 77 6e 6c 6f  fmpeg.org/downlo
0c10: 61 64 2e 68 74 6d 6c 3c 2f 61 3e 20 61 6e 64 20  ad.html</a> and 
0c20: 70 72 65 66 65 72 61 62 6c 79 20 6c 6f 61 64 65  preferably loade
0c30: 64 20 66 72 6f 6d 20 3c 62 3e 25 50 52 4f 47 52  d from <b>%PROGR
0c40: 41 4d 46 49 4c 45 53 25 5c 66 66 6d 70 65 67 5c  AMFILES%\ffmpeg\
0c50: 62 69 6e 3c 2f 62 3e 2e 20 46 6f 72 20 4c 69 6e  bin</b>. For Lin
0c60: 75 78 2c 20 74 68 65 20 73 68 61 72 65 64 20 6c  ux, the shared l
0c70: 69 62 72 61 72 69 65 73 20 61 72 65 20 61 76 61  ibraries are ava
0c80: 69 6c 61 62 6c 65 20 70 65 72 20 69 6e 73 74 61  ilable per insta
0c90: 6c 6c 69 6e 67 20 74 68 65 20 64 69 73 74 72 69  lling the distri
0ca0: 62 75 74 69 6f 6e 27 73 20 66 66 6d 70 65 67 20  bution's ffmpeg 
0cb0: 70 61 63 6b 61 67 65 28 73 29 2e 20 46 6f 72 20  package(s). For 
0cc0: 4d 61 63 4f 53 58 2c 20 74 68 65 20 68 6f 6d 65  MacOSX, the home
0cd0: 62 72 65 77 20 66 66 6d 70 65 67 20 70 61 63 6b  brew ffmpeg pack
0ce0: 61 67 65 20 70 72 6f 76 69 64 65 73 20 74 68 65  age provides the
0cf0: 20 6e 65 63 65 73 73 61 72 79 20 73 68 61 72 65   necessary share
0d00: 64 20 6c 69 62 72 61 72 69 65 73 2e 0d 0a 0d 0a  d libraries.....
0d10: 42 79 20 64 65 66 61 75 6c 74 2c 20 74 68 65 20  By default, the 
0d20: 48 54 54 50 2f 57 65 62 73 6f 63 6b 65 74 73 20  HTTP/Websockets 
0d30: 70 6f 72 74 20 69 73 20 38 30 38 30 20 77 68 69  port is 8080 whi
0d40: 63 68 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69  ch can be overri
0d50: 64 64 65 6e 20 77 69 74 68 20 74 68 65 20 65 6e  dden with the en
0d60: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62  vironment variab
0d70: 6c 65 20 3c 62 3e 53 44 4c 5f 56 49 44 45 4f 5f  le <b>SDL_VIDEO_
0d80: 4a 53 4d 50 45 47 5f 50 4f 52 54 3c 2f 62 3e 2e  JSMPEG_PORT</b>.
0d90: 20 54 68 75 73 2c 20 74 68 65 20 55 52 4c 0d 0a   Thus, the URL..
0da0: 0d 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 20 20  ..<verbatim>..  
0db0: 20 20 68 74 74 70 3a 2f 2f 6c 6f 63 61 6c 68 6f    http://localho
0dc0: 73 74 3a 38 30 38 30 0d 0a 3c 2f 76 65 72 62 61  st:8080..</verba
0dd0: 74 69 6d 3e 0d 0a 0d 0a 63 6f 6e 6e 65 63 74 73  tim>....connects
0de0: 20 74 68 65 20 62 72 6f 77 73 65 72 20 77 69 74   the browser wit
0df0: 68 20 74 68 65 20 3c 62 3e 6a 73 6d 70 65 67 3c  h the <b>jsmpeg<
0e00: 2f 62 3e 20 65 6e 61 62 6c 65 64 20 5b 75 6e 64  /b> enabled [und
0e10: 72 6f 69 64 77 69 73 68 5d 2e 20 49 66 20 74 68  roidwish]. If th
0e20: 65 20 62 72 6f 77 73 65 72 27 73 20 57 65 62 47  e browser's WebG
0e30: 4c 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  L implementation
0e40: 20 69 73 6e 27 74 20 73 75 69 74 61 62 6c 65 20   isn't suitable 
0e50: 66 6f 72 20 70 72 6f 70 65 72 20 64 69 73 70 6c  for proper displ
0e60: 61 79 69 6e 67 20 74 68 65 20 5b 75 6e 64 72 6f  aying the [undro
0e70: 69 64 77 69 73 68 5d 20 72 6f 6f 74 20 77 69 6e  idwish] root win
0e80: 64 6f 77 2c 20 74 68 65 20 61 6c 74 65 72 6e 61  dow, the alterna
0e90: 74 65 20 55 52 4c 0d 0a 0d 0a 3c 76 65 72 62 61  te URL....<verba
0ea0: 74 69 6d 3e 0d 0a 20 20 20 20 68 74 74 70 3a 2f  tim>..    http:/
0eb0: 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 38 30 2f  /localhost:8080/
0ec0: 3f 75 73 65 32 64 0d 0a 3c 2f 76 65 72 62 61 74  ?use2d..</verbat
0ed0: 69 6d 3e 0d 0a 0d 0a 74 75 72 6e 73 20 6f 66 66  im>....turns off
0ee0: 20 57 65 62 47 4c 20 75 73 61 67 65 2e 20 0d 0a   WebGL usage. ..
0ef0: 0d 0a 4e 6f 74 65 20 74 68 61 74 20 61 6c 6c 20  ..Note that all 
0f00: 6c 6f 63 61 6c 20 54 43 50 2f 49 50 20 61 64 64  local TCP/IP add
0f10: 72 65 73 73 65 73 20 61 72 65 20 62 6f 75 6e 64  resses are bound
0f20: 2c 20 6e 6f 74 20 6a 75 73 74 20 6c 6f 63 61 6c  , not just local
0f30: 68 6f 73 74 2e 20 20 54 68 75 73 2c 20 69 66 20  host.  Thus, if 
0f40: 79 6f 75 72 20 6c 6f 63 61 6c 20 54 43 50 2f 49  your local TCP/I
0f50: 50 20 61 64 64 72 65 73 73 20 69 73 20 31 39 32  P address is 192
0f60: 2e 31 36 38 2e 31 2e 39 2c 20 74 68 65 6e 20 68  .168.1.9, then h
0f70: 74 74 70 3a 2f 2f 31 39 32 2e 31 36 38 2e 31 2e  ttp://192.168.1.
0f80: 39 3a 38 30 38 30 20 77 69 6c 6c 20 77 6f 72 6b  9:8080 will work
0f90: 2c 20 61 6e 64 20 70 72 6f 76 69 64 65 73 20 61  , and provides a
0fa0: 63 63 65 73 73 20 74 6f 20 79 6f 75 72 20 61 70  ccess to your ap
0fb0: 70 20 76 69 61 20 6e 6f 6e 2d 6c 6f 63 61 6c 68  p via non-localh
0fc0: 6f 73 74 20 64 65 76 69 63 65 73 2e 0d 0a 0d 0a  ost devices.....
0fd0: 3c 68 33 3e 48 54 54 50 20 41 55 54 48 3c 2f 68  <h3>HTTP AUTH</h
0fe0: 33 3e 0d 0a 0d 0a 59 6f 75 20 63 61 6e 20 6f 70  3>....You can op
0ff0: 74 69 6f 6e 61 6c 6c 79 20 70 61 73 73 77 6f 72  tionally passwor
1000: 64 2d 70 72 6f 74 65 63 74 20 74 68 65 20 68 74  d-protect the ht
1010: 74 70 20 70 6f 72 74 20 73 65 72 76 69 6e 67 20  tp port serving 
1020: 79 6f 75 72 20 61 70 70 2c 20 62 79 20 64 65 66  your app, by def
1030: 69 6e 69 6e 67 20 74 68 65 20 3c 62 3e 53 44 4c  ining the <b>SDL
1040: 5f 56 49 44 45 4f 5f 4a 53 4d 50 45 47 5f 41 55  _VIDEO_JSMPEG_AU
1050: 54 48 3c 2f 62 3e 20 76 61 72 69 61 62 6c 65 20  TH</b> variable 
1060: 6c 69 6b 65 20 73 6f 3a 0d 0a 0d 0a 3c 76 65 72  like so:....<ver
1070: 62 61 74 69 6d 3e 65 78 70 6f 72 74 20 53 44 4c  batim>export SDL
1080: 5f 56 49 44 45 4f 5f 4a 53 4d 50 45 47 5f 41 55  _VIDEO_JSMPEG_AU
1090: 54 48 3d 24 28 65 63 68 6f 20 2d 6e 20 75 73 65  TH=$(echo -n use
10a0: 72 3a 70 61 73 73 20 7c 20 62 61 73 65 36 34 29  r:pass | base64)
10b0: 3c 2f 76 65 72 62 61 74 69 6d 3e 0d 0a 0d 0a 54  </verbatim>....T
10c0: 68 69 73 20 77 69 6c 6c 20 63 61 75 73 65 20 79  his will cause y
10d0: 6f 75 72 20 77 65 62 20 62 72 6f 77 73 65 72 20  our web browser 
10e0: 74 6f 20 72 65 71 75 69 72 65 20 61 20 75 73 65  to require a use
10f0: 72 6e 61 6d 65 2f 70 61 73 73 77 6f 72 64 20 63  rname/password c
1100: 6f 6d 62 69 6e 61 74 69 6f 6e 20 69 6e 20 6f 72  ombination in or
1110: 64 65 72 20 74 6f 20 64 69 73 70 6c 61 79 20 74  der to display t
1120: 68 65 20 70 61 67 65 2e 20 20 46 6f 72 20 6d 6f  he page.  For mo
1130: 72 65 20 69 6e 66 6f 20 61 62 6f 75 74 20 48 54  re info about HT
1140: 54 50 20 41 55 54 48 20 73 65 65 20 74 68 65 20  TP AUTH see the 
1150: 57 69 6b 69 70 65 64 69 61 20 61 72 74 69 63 6c  Wikipedia articl
1160: 65 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73  e <a href="https
1170: 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e  ://en.wikipedia.
1180: 6f 72 67 2f 77 69 6b 69 2f 42 61 73 69 63 5f 61  org/wiki/Basic_a
1190: 63 63 65 73 73 5f 61 75 74 68 65 6e 74 69 63 61  ccess_authentica
11a0: 74 69 6f 6e 22 3e 42 61 73 69 63 5f 61 63 63 65  tion">Basic_acce
11b0: 73 73 5f 61 75 74 68 65 6e 74 69 63 61 74 69 6f  ss_authenticatio
11c0: 6e 3c 2f 61 3e 2e 0d 0a 0d 0a 3c 68 33 3e 53 63  n</a>.....<h3>Sc
11d0: 72 65 65 6e 20 72 65 63 6f 72 64 69 6e 67 3c 2f  reen recording</
11e0: 68 33 3e 0d 0a 0d 0a 59 6f 75 20 63 61 6e 20 6f  h3>....You can o
11f0: 70 74 69 6f 6e 61 6c 6c 79 20 73 61 76 65 20 79  ptionally save y
1200: 6f 75 72 20 65 6e 74 69 72 65 20 54 6b 20 61 70  our entire Tk ap
1210: 70 27 73 20 72 75 6e 6e 69 6e 67 20 74 6f 20 61  p's running to a
1220: 20 4d 50 45 47 31 20 66 69 6c 65 2c 20 62 79 20   MPEG1 file, by 
1230: 64 65 66 69 6e 69 6e 67 20 74 68 65 20 3c 62 3e  defining the <b>
1240: 53 44 4c 5f 56 49 44 45 4f 5f 4a 53 4d 50 45 47  SDL_VIDEO_JSMPEG
1250: 5f 4f 55 54 46 49 4c 45 3c 2f 62 3e 20 6c 69 6b  _OUTFILE</b> lik
1260: 65 20 73 6f 3a 0d 0a 0d 0a 3c 76 65 72 62 61 74  e so:....<verbat
1270: 69 6d 3e 65 78 70 6f 72 74 20 53 44 4c 5f 56 49  im>export SDL_VI
1280: 44 45 4f 5f 4a 53 4d 50 45 47 5f 4f 55 54 46 49  DEO_JSMPEG_OUTFI
1290: 4c 45 3d 64 61 74 61 2e 6d 70 67 3c 2f 76 65 72  LE=data.mpg</ver
12a0: 62 61 74 69 6d 3e 0d 0a 0d 0a 3c 68 33 3e 48 54  batim>....<h3>HT
12b0: 4d 4c 20 50 61 67 65 20 54 69 74 6c 65 3c 2f 68  ML Page Title</h
12c0: 33 3e 0d 0a 0d 0a 54 68 65 20 48 54 4d 4c 20 67  3>....The HTML g
12d0: 65 6e 65 72 61 74 65 64 20 74 6f 20 73 75 70 70  enerated to supp
12e0: 6f 72 74 20 74 68 65 20 6a 73 6d 70 65 67 20 64  ort the jsmpeg d
12f0: 72 69 76 65 72 20 77 69 6c 6c 20 61 75 74 6f 6d  river will autom
1300: 61 74 69 63 61 6c 6c 79 20 75 73 65 20 74 68 65  atically use the
1310: 20 54 6b 20 77 69 6e 64 6f 77 20 6d 61 6e 61 67   Tk window manag
1320: 65 72 20 74 69 74 6c 65 20 74 6f 20 64 65 66 69  er title to defi
1330: 6e 65 20 79 6f 75 72 20 77 65 62 20 70 61 67 65  ne your web page
1340: 27 73 20 77 65 62 20 74 69 74 6c 65 2e 20 54 68  's web title. Th
1350: 75 73 2c 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64  us, this command
1360: 20 69 6e 20 79 6f 75 72 20 54 63 6c 2f 54 6b 20   in your Tcl/Tk 
1370: 70 72 6f 67 72 61 6d 3a 0d 0a 0d 0a 3c 76 65 72  program:....<ver
1380: 62 61 74 69 6d 3e 77 6d 20 74 69 74 6c 65 20 2e  batim>wm title .
1390: 20 22 48 65 6c 6c 6f 20 57 6f 72 6c 64 20 5c 55   "Hello World \U
13a0: 31 46 36 30 31 22 3c 2f 76 65 72 62 61 74 69 6d  1F601"</verbatim
13b0: 3e 0d 0a 0d 0a 77 69 6c 6c 20 72 65 73 75 6c 74  >....will result
13c0: 20 69 6e 20 79 6f 75 72 20 77 65 62 20 62 72 6f   in your web bro
13d0: 77 73 65 72 20 74 69 74 6c 69 6e 67 20 74 68 69  wser titling thi
13e0: 73 20 70 61 67 65 20 74 61 62 20 61 73 20 22 48  s page tab as "H
13f0: 65 6c 6c 6f 20 57 6f 72 6c 64 20 26 23 31 32 38  ello World &#128
1400: 35 31 33 3b 22 2e 20 4f 6e 6c 79 20 74 68 65 20  513;". Only the 
1410: 61 70 70 6c 69 63 61 74 69 6f 6e 27 73 20 74 6f  application's to
1420: 70 6c 65 76 65 6c 20 77 69 6e 64 6f 77 20 28 74  plevel window (t
1430: 68 65 20 22 2e 22 20 69 6e 20 54 6b 20 70 61 72  he "." in Tk par
1440: 6c 61 6e 63 65 29 20 77 69 6c 6c 20 73 65 74 20  lance) will set 
1450: 74 68 65 20 62 72 6f 77 73 65 72 0d 0a 74 69 74  the browser..tit
1460: 6c 65 2e 0d 0a 0d 0a 3c 68 33 3e 41 20 6e 6f 74  le.....<h3>A not
1470: 65 20 61 62 6f 75 74 20 63 6f 6c 6f 72 73 3c 2f  e about colors</
1480: 68 33 3e 0d 0a 0d 0a 44 75 65 20 74 6f 20 52 47  h3>....Due to RG
1490: 42 2d 3e 59 43 62 43 72 2d 3e 52 47 42 20 20 63  B->YCbCr->RGB  c
14a0: 6f 6c 6f 72 20 63 6f 6e 76 65 72 73 69 6f 6e 73  olor conversions
14b0: 20 74 61 6b 69 6e 67 20 70 6c 61 63 65 20 77 68   taking place wh
14c0: 65 6e 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e  en using the <b>
14d0: 6a 73 6d 70 65 67 3c 2f 62 3e 20 64 72 69 76 65  jsmpeg</b> drive
14e0: 72 2c 20 74 68 65 20 6f 75 74 70 75 74 20 63 6f  r, the output co
14f0: 6c 6f 72 73 20 6f 66 20 79 6f 75 72 20 61 70 70  lors of your app
1500: 20 28 77 68 65 6e 20 76 69 65 77 65 64 20 69 6e   (when viewed in
1510: 20 61 20 77 65 62 20 62 72 6f 77 73 65 72 29 20   a web browser) 
1520: 61 72 65 20 6e 65 76 65 72 20 65 78 61 63 74 6c  are never exactl
1530: 79 20 77 68 61 74 20 74 68 65 79 20 77 6f 75 6c  y what they woul
1540: 64 20 62 65 20 69 6e 20 54 6b 2e 0d 0a 0d 0a 46  d be in Tk.....F
1550: 6f 72 20 65 78 61 6d 70 6c 65 2c 20 77 68 69 74  or example, whit
1560: 65 20 23 46 46 46 46 46 46 20 77 69 6c 6c 20 72  e #FFFFFF will r
1570: 65 6e 64 65 72 20 61 73 20 23 46 45 46 45 46 45  ender as #FEFEFE
1580: 2e 20 20 54 68 69 73 20 64 69 66 66 65 72 65 6e  .  This differen
1590: 63 65 20 69 73 20 76 65 72 79 20 73 6c 69 67 68  ce is very sligh
15a0: 74 2e 0d 0a 0d 0a 3c 6e 6f 77 69 6b 69 3e 0d 0a  t.....<nowiki>..
15b0: 3c 63 65 6e 74 65 72 3e 0d 0a 3c 62 72 3e 3c 62  <center>..<br><b
15c0: 72 3e 0d 0a 3c 69 6d 67 20 73 72 63 3d 22 2f 72  r>..<img src="/r
15d0: 61 77 2f 6d 69 73 63 2f 75 77 5f 6a 73 6d 70 65  aw/misc/uw_jsmpe
15e0: 67 2e 70 6e 67 3f 6e 61 6d 65 3d 31 39 38 37 66  g.png?name=1987f
15f0: 38 33 30 39 34 36 61 62 30 30 36 66 32 65 34 36  830946ab006f2e46
1600: 32 63 35 65 39 35 36 36 61 32 37 38 33 37 36 66  2c5e9566a278376f
1610: 36 33 33 22 0d 0a 61 6c 74 3d 22 53 63 72 65 65  633"..alt="Scree
1620: 6e 73 68 6f 74 20 77 69 64 67 65 74 20 64 65 6d  nshot widget dem
1630: 6f 22 3e 0d 0a 3c 62 72 3e 53 63 72 65 65 6e 73  o">..<br>Screens
1640: 68 6f 74 20 74 61 6b 65 6e 20 69 6e 20 61 20 47  hot taken in a G
1650: 4e 4f 4d 45 20 57 61 79 6c 61 6e 64 20 73 65 73  NOME Wayland ses
1660: 73 69 6f 6e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c 2f  sion<br><br>..</
1670: 63 65 6e 74 65 72 3e 0d 0a 3c 2f 6e 6f 77 69 6b  center>..</nowik
1680: 69 3e 0d 0a 0a 5a 20 38 36 38 65 32 62 61 36 64  i>...Z 868e2ba6d
1690: 34 35 34 64 61 63 31 37 65 65 34 64 35 34 65 62  454dac17ee4d54eb
16a0: 39 65 36 38 64 38 31 0a                          9e68d81.