]> git.sesse.net Git - nageru-docs/blobdiff - html.rst
Document unsynchronized HDMI/SDI output.
[nageru-docs] / html.rst
index 644e9248656d764e2c3bf7e0735b2124a3f8fd3d..92eecdd9b6026443f67532135f43f57ad015e275 100644 (file)
--- a/html.rst
+++ b/html.rst
@@ -7,7 +7,7 @@ in full HTML5 (including JavaScript) by way of `Chromium Embedded Framework
 <https://bitbucket.org/chromiumembedded/cef/>`_ (CEF for short), a library that
 basically embeds a full copy of the Chromium web browser into Nageru.
 
 <https://bitbucket.org/chromiumembedded/cef/>`_ (CEF for short), a library that
 basically embeds a full copy of the Chromium web browser into Nageru.
 
-HTML inputs are available from Nageru 1.7.0 onwards, but note that they are an
+Note that HTML inputs are an
 optional component, since many distributions don't carry CEF. Thus, your copy
 of Nageru may not support them. See :ref:`compiling` for information on how to
 build Nageru with CEF.
 optional component, since many distributions don't carry CEF. Thus, your copy
 of Nageru may not support them. See :ref:`compiling` for information on how to
 build Nageru with CEF.
@@ -31,10 +31,16 @@ so that you can load remote resources from local files. (If you wish to locate
 your HTML path by way of the theme, the variable Nageru.THEME_PATH could prove
 useful, as it contains the absolute path to the theme in current use.)
 
 your HTML path by way of the theme, the variable Nageru.THEME_PATH could prove
 useful, as it contains the absolute path to the theme in current use.)
 
-You can then add this HTMLInput to a chain (or multiple chains if you'd like),
-using code like::
+You can then display HTMLInput or any input in your scene (that you created
+earlier with scene:add_input()), using code like::
 
 
-  local image = chain:add_html_input(html_input)
+  input:display(html_input)
+
+or, as described in :ref:`locking`, you can create an input that can *only*
+show HTML when you create it::
+
+  local scene = Scene.new(16, 9)
+  local input = scene:add_input(html_input)
 
 Like video inputs, you can call *get_signal_num()* on the HTML input to get
 its signal number, for getting its resolution etc. (see below for changing
 
 Like video inputs, you can call *get_signal_num()* on the HTML input to get
 its signal number, for getting its resolution etc. (see below for changing
@@ -54,7 +60,7 @@ however, this is normal even in a hardware chain, and most overlay graphics
 does not need to be timed to the input more than through a few frames.
 
 This, and the fact that the theme can not present a very detailed UI
 does not need to be timed to the input more than through a few frames.
 
 This, and the fact that the theme can not present a very detailed UI
-(short of :ref:`simple menus <menu>`), means that it can be hard to
+(short of :ref:`simple menus <menus>`), means that it can be hard to
 exert detailed control over the graphics using Nageru alone—you will
 probably want to have the theme contact some non-Nageru backend (possibly over
 WebSockets) from where it can take detailed instructions.
 exert detailed control over the graphics using Nageru alone—you will
 probably want to have the theme contact some non-Nageru backend (possibly over
 WebSockets) from where it can take detailed instructions.