From f6181c1e145cb8c839fd27f44cae6b86ce5e0c2c Mon Sep 17 00:00:00 2001
From: Alexandre Prokoudine <alexandre.prokoudine@gmail.com>
Date: Mon, 18 Jul 2022 20:02:57 +0300
Subject: [PATCH] Cue: move the Clip Properties documentation...

... to ist own subchapter
---
 include/clip-properties.html | 44 ++++++++++++++++++++++++++++++++++++
 master-doc.txt               |  8 +++++++
 2 files changed, 52 insertions(+)
 create mode 100644 include/clip-properties.html

diff --git a/include/clip-properties.html b/include/clip-properties.html
new file mode 100644
index 0000000..5aef3ea
--- /dev/null
+++ b/include/clip-properties.html
@@ -0,0 +1,44 @@
+<p>
+	The contents of this options box partially depends on the type of data
+	in the clip, audio or MIDI. The common settings are:
+</p>
+
+<ul>
+	<li>
+		<dfn>Name</dfn>: the full name of the clip's file, usually visible in its
+		shortened form.
+	</li>
+	<li>
+		<dfn>Load</dfn>: this button allows loading a clip's file into
+		the selected trigger slot.
+	</li>
+	<li>
+		<dfn>Color</dfn>: here you can open a color chooser dialog to set
+		the color of the clip's title inside the trigger slot.
+	</li>
+</ul>
+
+<p>
+	The only audio-specific setting is <dfn>Gain (dB)</dfn> which adjusts
+	the output volume of a clip.
+</p>
+
+<p>
+	For MIDI clips, there are several specific options:
+</p>
+
+<ul>
+	<li>
+		<dfn>Velocity Adj</dfn>: this effectively adjusts the output volume
+		by increasing the velocity of MIDI notes.
+	</li>
+	<li>
+		<dfn>Send Patches</dfn>: this enables sending a control message
+		to load a particular patch. This is typically used for external
+		MIDI gear such a hardware synthesizers.
+	</li>
+	<li>
+		<dfn>MIDI Patches</dfn>: clicking this button will open a dialog
+		where you can select a patch to send when a MIDI clip is triggered.
+	</li>
+</ul>
\ No newline at end of file
diff --git a/master-doc.txt b/master-doc.txt
index 9263135..bd7af12 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1539,6 +1539,14 @@ uri: cue/setting-up-cues/playing-back-the-cues
 part: subchapter
 ---
 
+---
+title: Setting Up Clip Properties
+link: clip-properties
+include: clip-properties.html
+uri: cue/setting-up-cues/clip-properties
+part: subchapter
+---
+
 ---
 title: Setting Up Launch Options
 link: clip-launch-options
-- 
2.37.2