X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fosc58-using-the-setup-dialog.html;h=171321b06f161c1032072f769ca017d0918f1c98;hb=71afa472a61c8d63fb8932c06b3ab83bf3aecbda;hp=5c440d290520468dd5fa191e8d2f596312fc0ef2;hpb=042723be8949fe53bb488183a91e27c398d40ce4;p=ardour-manual

diff --git a/include/osc58-using-the-setup-dialog.html b/include/osc58-using-the-setup-dialog.html
index 5c440d2..171321b 100644
--- a/include/osc58-using-the-setup-dialog.html
+++ b/include/osc58-using-the-setup-dialog.html
@@ -12,11 +12,9 @@
   Many OSC devices get their IP from a DHCP making it difficult to set
   an IP in Ardour's OSC settings. Therefore, most of the settings are
   <em>default</em> settings. Values are set and the next OSC surface to
-  send an OSC message to Ardour will use those settings. An OSC
-  surface that has previously sent a message to Ardour will retain the
-  settings it already had. Any change to a setting will reset all
-  device settings. A <em>/refresh</em> message will set that device to
-  any new settings. The use of <em>/set_surface</em> will override all
+  send an OSC message to Ardour will use those settings. Any change to a
+  setting will reset all
+  device settings. The use of <em>/set_surface</em> will override all
   settings except <em>Port Mode</em>. <em>Port Mode</em> affects all
   connected surfaces and so all surfaces must use either the set manual
   port or send OSC messages from the same port they expect to receive
@@ -24,10 +22,14 @@
 </p>
 <h2>Dialog settings</h2>
 <h3>OSC setup tab</h3>
-<p>
-<img alt="the OSC configuration dialog"
-     src="/images/osc-dialog.png">
-</p>
+
+<figure>
+	<img alt="The OSC configuration dialog" src="/images/osc-dialog.png">
+	<figcaption>
+		The OSC configuration dialog
+	</figcaption>
+</figure>
+
 <h4>Connection:</h4>
 <p>
   This field is informational only. It shows where Ardour will receive
@@ -37,10 +39,14 @@
   port up and will keep trying up to 10 ports up.
 </p>
 <h4>Port Mode:</h4>
-<p>
-<img alt="Port Mode Dropdown"
-     src="/images/osc-portmode.png">
-</p>
+
+<figure>
+	<img alt="Port Mode Dropdown" src="/images/osc-portmode.png">
+	<figcaption>
+		Port Mode Dropdown
+	</figcaption>
+</figure>
+
 <p>
   This drop down allows the choice of Auto or Manual outbound port
   setting. The Auto port mode, will send OSC messages back to
@@ -82,32 +88,49 @@
 	controllable.
 </p>
 <h4>Gain Mode:</h4>
-<p>
-<img alt="Gain Mode Dropdown"
-     src="/images/osc-gainmode.png">
-</p>
+
+<figure>
+	<img alt="Gain Mode Dropdown" src="/images/osc-gainmode.png">
+	<figcaption>
+		Gain Mode Dropdown
+	</figcaption>
+</figure>
+
 <p>
   Sets the faders (and sends faders) feedback math to position where a
   value between 0 and 1 represents the fader position of the same fader
   in the mixer GUI or dB where the feedback from fader movement will be
-  returned as a dB value. When the Gain Mode is set to position, the
+  returned as a dB value. When the Gain Mode is set to position, there
+  are also options to send the gain in dB either to the channel name,
   /*/name feedback for the channel will show dB values in text while the
-  fader is being adjusted and then return the name text.
+  fader is being adjusted and then return the name text. It can also be
+  set to send both position and gain or just position.
 </p>
 <h4>Debug:</h4>
-<p>
-<img alt="Debug Mode Dropdown"
-     src="/images/osc-debug.png">
-</p>
+
+<figure>
+	<img alt="Debug Mode Dropdown" src="/images/osc-debug.png">
+	<figcaption>
+		Debug Mode Dropdown
+	</figcaption>
+</figure>
+
 <p>
   For debugging purposes this allows logging either all OSC messages
-  Ardour receives or invalid messages received or none.
+  Ardour receives or invalid messages received or none. The last option:
+  <kbd class="menu">Print surface information to Log window</kbd> prints
+  the internal information that Ardour uses to create feedback for all
+  surfaces Ardour knows about.
 </p>
 <h4>Preset:</h4>
-<p>
-<img alt="Preset Loader"
-     src="/images/osc-preset.png">
-</p>
+
+<figure>
+	<img alt="Preset Loader" src="/images/osc-preset.png">
+	<figcaption>
+		Preset Loader
+	</figcaption>
+</figure>
+
 <p>
   Ardour now allows the use of preset settings. The default settings
   used are the settings from the last session or the factory defaults
@@ -134,10 +157,14 @@
   so having correct defaults allows one "Connect" button rather than 4.
 </p>
 <h3>Default Strip Types tab</h3>
-<p>
-<img alt="the Default Strip Types tab"
-     src="/images/osc-strip-types.png">
-</p>
+
+<figure>
+	<img alt="The Default Strip Types tab" src="/images/osc-strip-types.png">
+	<figcaption>
+		The Default Strip Types tab
+	</figcaption>
+</figure>
+
 <p>
   This allows selecting which of Ardour's mixer strips will be available
   for control. The Factory default is all strips except master, monitor
@@ -150,10 +177,14 @@
   controlled by a VCA are hidden, but one of those tracks needs a tweak.
 </p>
 <h3>Default Feedback tab</h3>
-<p>
-<img alt="the Default Feedback tab"
-     src="/images/osc-feedbackdefault.png">
-</p>
+
+<figure>
+	<img alt="The Default Feedback tab" src="/images/osc-feedbackdefault.png">
+	<figcaption>
+		The Default Feedback tab
+	</figcaption>
+</figure>
+
 <p>
   This allows setting up which controls provide feedback. The Factory
   default is none. If the controller is unable to receive feedback, this