Jkuehn at 22:38, 3 March 2025

2025-03-03T22:38:30Z

← Older revision		Revision as of 00:38, 4 March 2025
Line 71:		Line 71:

	<noinclude>		<noinclude>
	[[Category: ~~Handbuch~~ DMXControl 3]]		[[Category: Manual DMXControl 3]]
	</noinclude>		</noinclude>

	[[de: Absolute_and_Relative_Values_DMXC3]]		[[de: Absolute_and_Relative_Values_DMXC3]]

Jkuehn: Created page with "{{Manual Header | Type = DMXC3 Main-Software | Version = 3.2.3}} In DMXControl 3, you can store values for device functions as both absolute and relative values within a scene. = Overview = It is possible in DMXControl 3.2.2 to store both absolute and relative values for individual device functions in {{Manual Windowcaption|Cues}}. A typical use case for relative values are the {{Manual Windowcaption|effects}}, such as fo..."

2025-03-03T22:37:49Z

Created page with "{{Manual Header | Type = DMXC3 Main-Software | Version = 3.2.3}} In DMXControl 3, you can store values for device functions as both absolute and relative values within a scene. = Overview = It is possible in DMXControl 3.2.2 to store both absolute and relative values for individual device functions in {{Manual Windowcaption|Cues}}. A typical use case for relative values are the {{Manual Windowcaption|effects}}, such as fo..."

New page

{{Manual Header
| Type = DMXC3 Main-Software
| Version = 3.2.3}}

In DMXControl 3, you can store values for device functions as both absolute and relative values within a scene.

= Overview =
It is possible in DMXControl 3.2.2 to store both absolute and relative values for individual device functions in {{Manual Windowcaption|[[Cuelist DMXC3|Cues]]}}. A typical use case for relative values are the {{Manual Windowcaption|[[Effects and Filters DMXC3|effects]]}}, such as for moving heads or scanners. This allows the center points of effects, stored relatively in the scene, to be moved live during runtime via separate {{Manual Windowcaption|[[Cuelist DMXC3|Cuelists]]}} with different position values.

= Important Features =
The display of whether a value is relative or absolute currently only occurs in the {{Manual Windowcaption|[[Device Control DMXC3|Device Control]]}}. To check this, the scene must be loaded into the {{Manual Windowcaption|[[Programmer DMXC3|Programmer]]}} and then the relevant {{Manual Windowcaption|[[Device DMXC3|device]]}} or {{Manual Windowcaption|[[Device Group DMXC3|device group]]}} must be selected.

= Usage =
The selection between absolute or relative values is made when preparing the light mood in the {{Manual Windowcaption|[[Device Control DMXC3|Device Control]]}}. Before the respective function, which supports saving absolute and relative values, there is a corresponding button. This button toggles between absolute values {{Manual Keyboard|ABS}} and relative values {{Manual Keyboard|REL}}. The input logic does not change. For example, relative values for position or dimmer are entered in the same way.

It is also possible to use both relative and absolute values for different functions in a scene simultaneously. That means you can, for example, set the dimmer to an absolute value while the position is stored as relative.

A switch between absolute and relative values is possible for all numerical values. However, color is an exception.

== Output Behavior ==
The output behavior differs whether you execute multiple cuelists with relative values simultaneously or work with relative values within a single cuelist. Additionally, priority also affects the output.

=== Using Multiple Cuelists ===
If you have stored different values as relative values in a {{Manual Windowcaption|scene}}, these will be added to or subtracted from already output values when the {{Manual Windowcaption|cuelist}} is played. This may also result in two cuelists with relative values cancelling each other out if the respective device functions, such as position, goborotation, or goboindex, allow negative values.

Multiple cuelists with relative values can also be executed simultaneously. DMXControl 3 adds the values contained in the scenes to the current absolute value. This is either the value for the base state, which the {{Manual Windowcaption|[[Hardware Abstraction Layer (HAL) DMXC3|Hardware Abstraction Layer (HAL)]]}} sets for devices not addressed by cuelists, or a cuelist whose scenes contain absolute values. In the latter case, the cuelist always provides the reference value for the relative values, which wins based on its priority and {{Manual Windowcaption|[[HTP-, LTP- and LoTP-Mixing (Cuelist) DMXC3|mixing modes (HTP, LTP, or LoTP)]]}}.

=== Relative Values Within a Cuelist ===
When using relative values within the same cuelist, the last set values are always considered. There is no accumulation over multiple scenes.

Accordingly, it is possible to remove the relative values by creating a scene with relative values for the respective device function and setting the relative value to 0. From this point on, the absolute values will correspond to the actual output.

=== Influence of Priorities ===
For relative values of a cuelist, only priority applies. The mixing mode (HTP, LTP, or LoTP) is not taken into account here. The priority of the cuelist determines when the relative values will interfere with the output, if cuelists with absolute values are running in parallel. The following definitions apply for the output:
* If only cuelists with relative values are executed, all of them are added together, regardless of the cuelist priorities. The reference value is the base value of the devices.
* If cuelists with absolute values are executed in addition to cuelists with relative values, the cuelist with absolute values that has the highest priority and was started last is used as the reference value. DMXControl 3 will then only add cuelists with relative values whose priority is equal to or greater than the priority of the cuelist with absolute values. Cuelists with a lower priority are "ignored," regardless of whether they contain absolute or relative values.

Based on these definitions, the following values are derived for the "Position" device function in the examples below:

* '''Example 1''': If only cuelists with relative values (cuelists 12, 13, 22, and 23) are executed, which are assigned priorities 0, 3, and 4, DMXControl 3 will add the values of all cuelists. The base value of the device will be used.
* '''Example 2''': If a cuelist (cuelist 21) with absolute values is started, whose priority is between 1 and 4, this cuelist will serve as the reference value for the addressed device function. DMXControl 3 will then only add the cuelists with relative values whose priority is equal to or greater than the priority of the cuelist with absolute values. Cuelists with a lower priority are "ignored," regardless of whether they contain absolute or relative values.
* '''Example 3''': Here, only cuelists 21 and 23 are executed. Since no cuelist with absolute values has a higher priority than 5, the absolute values of cuelist 21 will serve as the reference value for cuelist 23.
* '''Example 4''': If all cuelists from this example are executed, cuelist 31 with its absolute values will overwrite all cuelists with absolute and relative values with a lower priority, due to its priority of 32.

{| class="wikitable centered" style="text-align:center; vertical-align:middle;"
|- class="hintergrundfarbe10"
! colspan="4" | Input
| class="hintergrundfarbe1" style="width: 5px;" rowspan="11" |
! colspan="4" | Output
|-
! style="width: 200px;" | Value || style="width: 50px;" | Type || style="width: 50px;" | Prio. || style="width: 200px;" | Explanation || style="width: 100px;" | Ex. 1 || style="width: 100px;" | Ex. 2 || style="width: 100px;" | Ex. 3 || style="width: 100px;" | Ex. 4
|-
| <code>0; 0</code> || ABS || --- || Base value || class="hintergrundfarbe9" | '''''active''''' || class="hintergrundfarbe9" | '''''active''''' || class="hintergrundfarbe9" | '''''active''''' || class="hintergrundfarbe9" | '''''active'''''
|-
| <code>-30; +45 > +30; +45</code> || '''ABS''' || 0 || Cuelist 11 || off || off || off || class="hintergrundfarbe9" | '''''active'''''
|-
| <code>-10; +10 > +10; +10</code> || '''REL''' || 0 || Cuelist 12 || class="hintergrundfarbe9" | '''''active''''' || off || off || class="hintergrundfarbe9" | '''''active'''''
|-
| <code>+10; -10 > -10; -10</code> || '''REL''' || 0 || Cuelist 13 || class="hintergrundfarbe9" | '''''active''''' || class="hintergrundfarbe9" | '''''active''''' || off || class="hintergrundfarbe9" | '''''active'''''
|-
| <code>0; +80</code> || '''ABS''' || 3 || Cuelist 21 || off || class="hintergrundfarbe9" | '''''active''''' || class="hintergrundfarbe9" | '''''active''''' || class="hintergrundfarbe9" | '''''active'''''
|-
| <code>-45; -15 > +45; -15</code> || '''REL''' || 3 || Cuelist 22 || class="hintergrundfarbe9" | '''''active''''' || class="hintergrundfarbe9" | '''''active''''' || off || class="hintergrundfarbe9" | '''''active'''''
|-
| <code>-20; 0 > +20; 0</code> || '''REL''' || 4 || Cuelist 23 || class="hintergrundfarbe9" | '''''active''''' || off || class="hintergrundfarbe9" | '''''active''''' || class="hintergrundfarbe9" | '''''active'''''
|-
| <code>0; -35</code> || '''ABS''' || 32 || Cuelist 31 || off || off || off || class="hintergrundfarbe9" | '''''active'''''
|-
! colspan="4" | Result || <code>-65; -15 > +65; -15</code> || <code>-45; +65 > +45; +65</code> || <code>-20; +80 > +20; +80</code> || '''<code>0; -35</code>'''
|}

<noinclude>
[[Category: Handbuch DMXControl 3]]
</noinclude>

[[de: Absolute_and_Relative_Values_DMXC3]]

Absolute and Relative Values DMXC3 - Revision history

Jkuehn at 22:38, 3 March 2025