Lektion 20 Tut3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(75 dazwischenliegende Versionen von 13 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Inuse}}
{{Manual Header
{{Stub}}
| Type = DMXC3 Tutorials
{{Hinweis|Dieser Artikel soll eine Kurzanleitung zu DMXControl sein. Inhalt: Ausführung einer Show und 
| zurückLink = Lektion_19_Tut3
{{Wichtig|Dieser Artikel ist zm Teil eine 1:1 Kopie oder wurde mit Hilfe von FreeTranslation.com übersetzt und sehr viele Inhalte müssen noch angepasst werden, also ... jeder kann ja mal einen Satz übersetzen/korrigieren }}
| zurückText = Lektion 19
Erweiterungen }}
| vorLink = Lektion_21_Tut3
<h2 style="{{Style:Hauptseite:Überschrift}}" align="center">DMXControl 3 Lektion20</h2>
| vorText = Lektion 21
<div style="{{Style:Hauptseite:Box}} background-color:#f5faff">
}}
<!-- Rechte Spalte -->
<div class="floatright" style="width: 78%;  margin-top:-8px;">


= Überblick =
= Überblick =
In dieser Lektion lernst Du, wie das Erstellen und Hinzufügen neuer Gerätedefinitionen funktioniert. Du mußt diese Action nur machen, wenn Dein Gerät noch nicht als Standardgerät von DMXControl3 definiert ist.
In dieser Lektion lernst Du, wie das Erstellen und Hinzufügen neuer Gerätedefinitionen funktioniert. Du musst diese Aktion nur anwenden, wenn Dein Gerät noch nicht als Standardgerät von DMXControl 3 definiert ist.


= Lektion 20: Neue Gerätedefinitionen erstellen =
= Lektion 20: Neue Gerätedefinitionen erstellen =
== Kurzeinstieg ==
Eine Gerätedefinitionsdatei (kurz: DDF) wird verwendet, um DMXControl 3 über die Eigenschaften eines Gerätes zu informieren. Ein DDF ist in XML-Sprache geschrieben. Die Daten sind an verschiedenen Stellen auf dem PC gespeichert:
* '''UserDevices''' (vom Anwender erstellte DDFs): <code>[APPDATA]\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\</code>
* '''LibDevices''' (vom Installer ausgelieferte DDFs): <code>[PROGRAMMVERZEICHNIS]\Kernel\LibDevices\</code>


Eine Gerätedefinitionsdatei (kurz: DDF) wird verwendet, um DMXControl über die Eigenschaften eines Gerätes zu informieren. Ein DDF ist in XML-Sprache geschrieben und die Datei befindet sich im Ordner
Um DDFs für DMXControl 3 zu erstellen, gibt es zwei Wege. Entweder, du schreibst die DDFs in einem Texteditor, oder du nutzt den [[DDFCreator 3]]. Mit letzterem kannst du dir die DDFs mit Hilfe einer grafischen Oberfläche zusammenstellen. Auf der Wiki-Seite des DDFCreators wird beschrieben, wie man ihn bedient und damit DDFs erstellt.
<DMXControl program path>\kernel\devices


Im Folgenden konzentrieren wir uns auf die Erstellung eines DDFs im Texteditor. Wenn du mit DDFs von DMXControl 2 vertraut bist, dann kannst Du einige wichtige Unterschiede feststellen:
* Es gibt keine grafische Oberfläche (GUI), da DMXControl 3 kein Gerätekontextmenü unterstützt.
* Einige Syntaxelemente sind sehr ähnlich (speziell im Informations-Teil), das heißt du kannst die bestehenden DDFs wiederverwenden.
* Der Funktionsteil ist viel abstrakter: Du machst die Definition vor allem durch die Eigenschaften und nicht durch die DMX-Kanäle.


Wenn Du mit DDFs von DMXControl 2 vertraut bist, dann kannst Du einige wichtige Unterschiede feststellen:
In diesem Tutorial werden wir anhand von drei Beispielen, die von Mal zu Mal insbesondere umfangreicher und ein klein wenig schwieriger werden, die manuelle Erstellung eines DDFs Schritt für Schritt durchgehen. Für alle Beispiele beziehen wir uns real existierende Geräte, damit du das Tutorial im Nachgang für dich selbst besser nachvollziehen kannst. Die Geräte haben wir anhand ihrer Funktionen so ausgewählt, damit die Beispiele so umfangreich wie möglich ausfallen können.
* There is no GUI description part, because DMXControl 3 doesn't provide the device context menues
* Sone syntax elements are very similar (esp. in information part), i.e. you can reuse the existing DDFs
* The function part is much more abstract: You make the definition mainly by properties and not by DMX channels


Currently  there is no "DDF creator" available fpr DMXControl 3, we recommend to  use a text editor or XML editor tool. (Hint: We need support for  adaption of an existing DMXControl 2 php tool towards DMXControl 3)
Wir können in diesem Tutorial leider nicht alle Funktionen aufgreifen, die von DMXControl 3 unterstützt werden. Eine ausführliche Erläuterung der Funktionen findest du im Handbuch-Band [[DDF DMXC3]].


At first lets have a view to a very simple DDF ("Generic RGB Par"):
== Beispiele ==
Wir haben für euch mehrere Bespiele erstellt, wie ihr auf manuellem Wege DDFs programmiert:
* Beispiel 1: [[DDF-Tutorial_LED-Scheinwerfer_DMXC3|LED-Scheinwerfer]]
* Beispiel 2: [[DDF-Tutorial_4er-Bar_DMXC3|4er-LED-Bar (keine Leiste)]]
* Beispiel 3: [[DDF-Tutorial_Moving_Head_DMXC3|Moving Head]]


01 <?xml version="1.0" encoding="utf-8" ?>
02 <device image="bild" type="DMXDevice">
[[en: Lesson_20_Tut3]]
03  <information>
04    <modell>Generic RGB PAR</modell>
[[Kategorie: Tutorials DMXControl 3]]
05    <vendor>Generic</vendor>
06    <author>Arne Luedtke</author>
07  </information>
08  <functions>
09    <rgb>
10      <red dmxchannel="0" />
11      <green dmxchannel="1" />
12      <blue dmxchannel="2" />
13    </rgb>
14  </functions>
15 </device>
 
Line 01 is mandatory default line for describing the XML version.
Lines 02 and 15 provide the frame for the device definition that contains of two parts:
* information part (lines 03 to 07), no need for further explanation.
* function(property) specification part (lines 08 to 14)
 
The example device posesses one property: RGB colar mode. The mapping to DMX channels is described in lines 10 to 12.
 
Thats all!
 
Following table shows the existing properties:
 
{| class="wikitable"
! Property
! Description
! Comment
|-
| switch
| fixture has a switch channel
| <switch dmxchannel="0" />
|-
| dimmer
| fixture has a dimmer channel
| <dimmer dmxchannel="0" />
|-
| fog
| fod property
| <fog dmxchannel="0" />
|-
| shutter
| fixture has a shutter
| <shutter dmxchannel="4" />
|-
| strobe
| fixture has a strobe channel
| <strobe dmxchannel="7" />
|-
| rgb
| fixture uses RGB color mode
|<red dmxchannel="0" />
      <green dmxchannel="1" />
      <blue dmxchannel="2" />
|-
| position
| fixture has pan/tilt control
| <position>
      <pan dmxchannel="0" >
        <range range="170" />
      </pan>
      <tilt dmxchannel="1" >
        <range range="110" />
      </tilt> 
|-
| color wheel
| fixtures contains color wheel
| <colorwheel dmxchannel="2"/>
|-
| gobo wheel
| fixtures contains gobo wheel
| <gobowheel dmxchannel="2"/>
|-
|}
 
The different intervals in a DMX channel are defined by the "step" tag:
 
<step val="0" mindmx="0" maxdmx="127" />
<step val="100" mindmx="128" maxdmx="255" />
 
or:
 
<step type="color" val="#FFFFFF" caption="Weiß" mindmx="0" maxdmx="31" />
<step type="color" val="#FF0000" caption="Rot" mindmx="32" maxdmx="63" />
 
 
 
 
=== '''Zusätzliche Themen (von beta testern)''' ===
* Please complete the description
* During the beta test there is no upload capability for new DDFs. This topic must be updated.
 
 
==Übung==
* Have a look into several device definitions before creating your own DDF.
* Open the DDF for TS255. Separate the different properties by blank lines to get a better understanding.
* Create the DDF for your own device.
 
 
==Zusätzliche Links==
*
 
==Zertifikat==
Ich habe die Themen in dieser Lektion verstanden und möchte mit der nächsten Lektion weitermachen:
[http://www.dmxcontrol.de/mediawiki_beta/index.php?title=Einsteiger:Lesson21 Lektion21:]
 
 
 
</div>
 
<!-- Linke Spalte -->
<div style="{{Style:Hauptseite:Box}} width: 17%; background-color:#f5faff">
{{DMXC3_lesson}}
</div>
 
 
__NOTOC__
{{Languages|Einsteiger:lesson20}}

Aktuelle Version vom 10. November 2024, 14:27 Uhr

Im-aim.png Lektion 20 Tut3
Arrow back.png Lektion 19
Lektion 21 Arrow forw.png
Inhaltsverzeichnis

Überblick

In dieser Lektion lernst Du, wie das Erstellen und Hinzufügen neuer Gerätedefinitionen funktioniert. Du musst diese Aktion nur anwenden, wenn Dein Gerät noch nicht als Standardgerät von DMXControl 3 definiert ist.

Lektion 20: Neue Gerätedefinitionen erstellen

Kurzeinstieg

Eine Gerätedefinitionsdatei (kurz: DDF) wird verwendet, um DMXControl 3 über die Eigenschaften eines Gerätes zu informieren. Ein DDF ist in XML-Sprache geschrieben. Die Daten sind an verschiedenen Stellen auf dem PC gespeichert:

  • UserDevices (vom Anwender erstellte DDFs): [APPDATA]\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\
  • LibDevices (vom Installer ausgelieferte DDFs): [PROGRAMMVERZEICHNIS]\Kernel\LibDevices\

Um DDFs für DMXControl 3 zu erstellen, gibt es zwei Wege. Entweder, du schreibst die DDFs in einem Texteditor, oder du nutzt den DDFCreator 3. Mit letzterem kannst du dir die DDFs mit Hilfe einer grafischen Oberfläche zusammenstellen. Auf der Wiki-Seite des DDFCreators wird beschrieben, wie man ihn bedient und damit DDFs erstellt.

Im Folgenden konzentrieren wir uns auf die Erstellung eines DDFs im Texteditor. Wenn du mit DDFs von DMXControl 2 vertraut bist, dann kannst Du einige wichtige Unterschiede feststellen:

  • Es gibt keine grafische Oberfläche (GUI), da DMXControl 3 kein Gerätekontextmenü unterstützt.
  • Einige Syntaxelemente sind sehr ähnlich (speziell im Informations-Teil), das heißt du kannst die bestehenden DDFs wiederverwenden.
  • Der Funktionsteil ist viel abstrakter: Du machst die Definition vor allem durch die Eigenschaften und nicht durch die DMX-Kanäle.

In diesem Tutorial werden wir anhand von drei Beispielen, die von Mal zu Mal insbesondere umfangreicher und ein klein wenig schwieriger werden, die manuelle Erstellung eines DDFs Schritt für Schritt durchgehen. Für alle Beispiele beziehen wir uns real existierende Geräte, damit du das Tutorial im Nachgang für dich selbst besser nachvollziehen kannst. Die Geräte haben wir anhand ihrer Funktionen so ausgewählt, damit die Beispiele so umfangreich wie möglich ausfallen können.

Wir können in diesem Tutorial leider nicht alle Funktionen aufgreifen, die von DMXControl 3 unterstützt werden. Eine ausführliche Erläuterung der Funktionen findest du im Handbuch-Band DDF DMXC3.

Beispiele

Wir haben für euch mehrere Bespiele erstellt, wie ihr auf manuellem Wege DDFs programmiert:

Abgerufen von „https://wiki-de.dmxcontrol-projects.org/index.php?title=Lektion_20_Tut3&oldid=18376“