DDF DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(70 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Kapitelüberschrift}} {{Inuse}}
{{Manual Header
 
| Type = DMXC3 DDFs
{{NavigationTop-Man3
| Version = 3.3.0
|zurückLink =
|zurückText =
|vorLink =  
|vorText =  
}}
}}
{{Start-LaTeX}}
==Überblick==
Ein [[Glossar_DMXC2#DDF|'''D'''evice '''D'''efinition '''F'''ile]] ist eine XML-Datei, welche einen beliebigen Punkt in der Signalkette beschreibt, der die gesendeten DMX-Daten auswerten und verarbeiten kann. Das sind meistens Geräte wie Dimmer, Movinglights oder LED-PARs. Es gibt aber auch Software und Plugins, die DMX-Daten erwarten und demzufolge ein DDF benötigen. Jedes dieser Devices mit eigener DMX-Belegung benötigt eine eigene Beschreibung. Das bedeutet, 20 gleiche Dimmer werden auf dasselbe DDF referenziert, hingegen benötigt ein Movinghead mit verschiedenen Modi<ref>Modus bedeutet hier: unterschiedliche Anzahl und Belegung der DMX-Kanäle, einstellbar am Gerät selbst.</ref> meist mehrere DDFs.


==Beschreibung==
DMXControl muss irgendwoher die Information nehmen, welche Bedeutung den einzelnen DMX-Kanälen eines Devices zugeordnet ist, damit es intelligent die Steuerelement des Property Grid zuordnen kann. Diese Informationen stellt das DDF bereit. Dort heißt es vereinfacht: Der Dimmer liegt auf Kanal 12 und der Strobe-Effekt auf Kanal 7 zwischen den DMX-Werten 7 und 84. Wird ein Device in '''DMXC3 oder scheibt Lumos oder DMXControl 3?''' zu einem Projekt hinzugefügt, so wird dessen DDF geladen und die Steuerelemente bereitgestellt, welche den Funktionen des Devices entsprechen. Bei fehlerhaften DDFs gibt der Kernel zum Teil hilfreiche Fehlermeldungen aus. Wird das gleiche Gerät nochmal hinzugefügt, so wird dasselbe (schon eingelesene) DDF verwendet. Änderungen am DDF wirken sich ab dem nächsten Einlesen (z.B. Neustart von DMXC3) auf alle Devices des selben Typs aus. Insbesondere bei Movinglights muss bei der Device- (und damit DDF-) Auswahl auf den richtigen Modus geachtet werden, da verschiedene Modi meist verschiedene DMX-Belegungen haben und somit verschiedene DDFs benötigen. <small>Das ist doppelt (siehe Fußnote), welche Beschreibung gefällt euch besser?</small>


Zur Nachvollziehbarkeit ist es ratsam, das DDF "Lightmaxx DMX-Strobe 750" im Verzeichnis kernel/devices in einem Texteditor oder einem Browser zu öffnen. Ein DDF besteht aus einem Informationsteil in dem Gerätetyp, Hersteller, Autor der Datei und weitere Angaben enthalten sind. Darauf folgt normalerweise der Funktions-Block, der alle zu beschreibenden Funktionen/Parameter und deren Wertebereiche enthält. In DMXC wird nicht direkt der DMX-Wert geändert, sondern ein Parameter mit beliebig festlegbaren Wertebereich. Anhand des DDFs wird der Parameter-Wert (Value) in einen DMX-Wert umgerechnet. Folgendes Beispiel soll die Zuweisung im DDF erklären:
DDF ist die Abkürzung für {{Manual Objectcaption|"Device Definition File"}}. DDFs werden von DMXControl verwendet, um Informationen über die verwendeten Geräte zu erhalten:
<source lang="xml">
* welche DMX-Kanäle werden überhaupt belegt?
<dimmer>
* welche Funktionen habe die verschiedenen DMX-Kanäle?
  <range  mindmx="127" maxdmx="0" minval="0" maxval="100" />
* wie sehen die Farben auf einem Farbrad bzw. die Gobo auf einem Goborad aus?
</dimmer>
* gibt es verschiedene Strobe-Funktionen und wenn ja, welche?
</source>
Dies und viele weitere Informationen sind in einem vollständigen DDF enthalten. DMXControl 3 benötigt die Informationen, um anhand dessen die Bedienoberfläche in Form der {{Manual Windowcaption|[[Device Control DMXC3|Gerätesteuerung (Device Control)]]}} und den {{Manual Windowcaption|[[Control Panel DMXC3|Steuerfenster (Control Panel)]]}} aufzubauen. Darüber hinaus ermöglicht DMXControl 3 unter Einbeziehung des {{Manual Windowcaption|[[Hardware Abstraction Layer (HAL) DMXC3|Hardware Abstraktions-Layers (HAL)]]}} auch das Ansteuern unterschiedlicher Geräte. Alle Informationen werden in der Datei in einer klassischen XML-Struktur beschrieben, sodass alle Angaben auch nur mit dem klassischen Editor von Windows oder Notepad++<ref>Notepad++ ist ein freier Text- und Quellcodeeditor. Weitere Informationen auf der Herstellerseite: https://notepad-plus-plus.org/</ref> und dem dort verfügbaren Plugin XML-Tools<ref> Installationsanleitung für das Plugin XML-Tools mit Hilfe des integrierten Pluginadministrator von Notepad++: https://community.notepad-plus-plus.org/topic/16983/xml-tools/2</ref> im Klartext lesbar sind.
{{Bild_mit_Unterschrift|Effekte_auf_RAW-Channel.png|X.1|Effekt auf selbst definierte Funktionen
für kontinuierliches Farbrad legen|right|300px}}
Es wird ein Dimmer-Property angelegt, welches in dem DMX-Bereich (range) von 127 (dunkel) bis 0 (hell) im Gerät implementiert ist. Der Parameterwertebereich erstreckt sich von minval bis maxval, also von 0 bis 100. Im Dimmer-Property? wird also die Intensität zwischen 0(%) und 100(%) eingestellt und DMXC rechnet diese dann proportional in die DMX-Werte um anhand der Zuordnung mindmx ≙ minval und maxdmx ≙ maxval.
Schon allein die Reihenfolge der Begriffe, also erst die Funktion "Dimmer" und danach der dazugehörige DMX-Kanal, macht deutlich, dass die Devices vor allem über ihre Eigenschaften und weniger über ihre Kanäle definiert werden. Durch die neue HAL in DMXC3 ist es nicht mehr nötig (und möglich), eine graphische Beschreibung des DDFs anzulegen. Alle Steuerelemente werden von der GUI erkannt und an den entsprechenden stellen automatisch dargestellt.


'''Artikel zu Speierorten anlegen! Ähnlich Mozilla-Wiki, dann kann man darauf im Forum verlinken und jeder weiß, wo er suchen muss nach Icons, Logs, DDFs etc.'''
Dieser Teil des Handbuchs über DMXControl 3 beschäftigt mit der Erstellung von DDFs. Die Unterteilung der Artikel orientiert sich dabei an den vorhandenen {{Manual Windowcaption|Steuerfenster}} in DMXControl 3 selbst. Der Teil des Handbuchs zu den DDFs in DMXControl 3 gliedert sich in vier Bereiche:
* [[Einführung (DDF-Syntax) DMXC3|'''Grundlagen''']] und wichtige Hinweise zur DDF-Erstellung
* [[Intensity (DDF-Syntax) DMXC3|'''Syntax''']] der unterstützten Funktionen
* [[Procedures (DDF-Syntax) DMXC3|'''Procedures''']] zum Aufrufen bestimmter Gerätefunktionen
* [[DDF-Tutorial LED-Scheinwerfer DMXC3|'''Beispiele''']] zur manuellen Programmierung von DDFs für DMXControl 3


===Syntax===
{{Manual Box | de | Important | Der aktuelle DDFCreator unterstützt auf Grund seines Alters nicht alle Funktionen, die in den DDFs für DMXControl 3 abgebildet werden können. Unter Umständen löscht der [[DDFCreator 3|DDFCreator]] Bestandteile im DDF, die dieser nicht kennt. Daher ist es empfehlenswert, den DDFCreator nicht mehr zu verwenden, sobald im DDF manuell zusätzliche Funktionen hinzugefügt wurden.}}
XML verwendet sogenannte Elemente mit öffnenden und schließenden Tags, die von spitzen Klammern begrenzt werden. Ein Element kann ein oder mehrere Attribute enthalten, deren Wert getrennt durch ein Gleichheitszeichen in Anführungszeichen stehen sollte.
{{Manual Box | de | Attention | DDFs für DMXControl 2 sind nicht mit den DDFs für DMXControl 3 kompatibel, da sich der interne Aufbau komplett unterscheidet. DMXControl 3 benötigt für den {{Manual Windowcaption|[[Hardware Abstraction Layer (HAL) DMXC3|Hardware Abstraktions-Layers (HAL)]]}} zusätzliche Informationen. Auch bringen die DDFs keine selbst gebaute Bedienoberfläche mit. Alle Steuerelemente generiert DMXControl 3 einheitlich über die GUI.}}
<source lang="xml"><blockquote class="wissenschaftlich">Und sie bewegt sich doch!</blockquote>
|           |     |               ||                        |          |
|          |    |--Attributwert--||                        |          |
|          |                      ||                        |          |
|          |-------Attribut-------||                        |          |
|                                  |                        |          |
|------------(Start-)Tag------------|------Elementinhalt------|-(End-)Tag-|
|                                                                        |
|---------------------------------Element---------------------------------|</source><ref>http://selfhtml.apsel-mv.de/tag-element/tag-element-attribut.html</ref>
Inhaltsleere Elemente werden in sich geschlossen: <code>&lt;element attribut="wert" /&gt;</code>
Zur Vertiefung der Syntax siehe [http://wiki.selfhtml.org/wiki/Doku:XML#Elemente XML (selfHTML)]. Die Datei beschreibt eine Baumstruktur und es gibt zwingende Eltern-Kind-Beziehungen. Das heißt vereinfacht, dass ein <code>dimmer</code>-Element nur innerhalb des Funktionselement vorkommen darf.




* Erkläre Bezugssystem (step handler, step for)
= Grundlagen =
* Kommentare
{| class="wikitable toptextcells"
 
|-
===Elemente===
! style="height: 40px; width: 200px" | Kapitel !! style="width: 600px" | Zusammenfassung
jeweils Tabelle mit
|-
 
! [[Einführung (DDF-Syntax) DMXC3|Allgemeine Einführung]]
{| class="wikitable"
| Die allgemeine Einführung gibt einen groben Überblick, was DDFs im Kontext von DMXControl 3 sind, nach welchen Merkmalen die DDFs in DMXControl 3 zum Einsatz kommen und welche Verzeichnisse auf dem PC für die DDFs genutzt werden.
|-
|-
! Property !! Beschreibung !! Codebeispiel !! Attribute und erlaubte Kindelemente !! Kommentar
! [[Grundaufbau (DDF-Syntax) DMXC3|Grundaufbau]]
| Dieser Artikel beschreibt die grundlegende Struktur eines DDFs für DMXControl 3 sowie die Angaben wie Informationen zum Gerät, die im Informationsteil zu machen sind.
|-
|-
| '''cmy''' || Farbmischung über Cyan Magenta Yellow ||
! [[Funktionselemente (DDF-Syntax) DMXC3|Funktionselemente]]
<source lang="xml"><cmy>
| In diesem Artikel werden verschiedene Gemeinsamkeiten erläutert, die unabhängig von der verwendeten Funktion zu einer vollständigen Definition von insbesondere komplexeren DMX-Kanälen benötigt werden und daher in den meistern DDFs zu finden sind.
  <cyan dmxchannel="0"/>
  <magenta dmxchannel="1"/>
  <yellow dmxchannel="2"/>
<!-- <step type="color" val="#eedefe" caption="1/2 Minus Green" mindmx="128" maxdmx="128" /> -->
</cmy>
</source>
|| Kindelemente:
*cyan
*magenta
*yellow
Universalattribute, keine Kindelemnte
|| Subtraktive Farbmischung
|}
ist das zu technisch/formalistisch?
==== information-Teil ====
==== functions ====
==== procedures ====
===Attribute===
====Universalattribute====
====spezielle Attribute====
== Beispiele ==
== Tipp(s) ==
== Fehlersuche ==
== aus Tutorial ==
 
=== Lektion 20: Neue Gerätedefinitionen erstellen  ===
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
 
<DMXControl program path>\kernel\devices
<br>
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), d.h. 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.
<br>
Als erstes schauen wir uns ein sehr einfaches DDF an ("Generic RGB Par"):
 
----
 
{| cellspacing="1" cellpadding="1" border="0" align="center" width="200"
|-
|-
| <source lang="xml">
! [[Grundregeln (DDF-Syntax) DMXC3|Grundregeln]]
01 <?xml version="1.0" encoding="utf-8" ?>
| Die Grundregeln fassen zusammen, von welchen Einheiten der HAL beispielsweise bei der Festlegung der maximalen Strobefrequenz ausgeht.
02 <device image="bild" type="DMXDevice">
03  <information>
04    <modell>Generic RGB PAR</modell>
05    <vendor>Generic</vendor>
06    <author>Arne Luedtke</author>
07    <comment>KLEINER TEXT</comment>
08  </information>
09  <functions>
10    <rgb>
11      <red dmxchannel="0" />
12      <green dmxchannel="1" />
13      <blue dmxchannel="2" />
14    </rgb>
15  </functions>
16 </device>
</source>
|  
<br>[[Image:DeviceManegerInfoBox.jpg|DeviceManegerInfoBox.jpg]]
|}
|}


----
{{Manual Box | de | Hint | DMXControl 3.2 unterstützt noch keine Multibeam-Geräte (Geräte mit seperat gesteuerten Lampen). Dies kann mithilfe mehrerer einzelner DDFs, bzw. einem DDF und Generic RGB, Dimmer, etc. umgangen werden.}}
 
Zeile 01 ist zwingend notwendig für die Beschreibung der XML-Version. Zeile 02 ("bild" kann ersetzt werden durch z.B. "Light.gif" oder "Light.png") und 15 bilden den Rahmen für die Geräte-Definition, die aus zwei Teilen besteht:
 
*Informationsbereich (Zeile 03 bis 08), keine weitere Erklärung notwendig.  
*Funktionsbereich (Zeile 09 to 14)
 
Das Gerät in unserem Beispiel hat eine Eigenschaft: RGB color Modus. Die Zuordnung der DMX Kanäle wird in den Zeilen 11 bis 13 beschrieben.  
 
Das ist alles!


Folgende Tabelle zeigt die vorhandenen Eigenschaften<br>
= Funktionsübersicht =
In den DDFs werden folgende Funktionen direkt von der HAL unterstützt. Die Tabelle verweist euch auf die verschiedenen Artikel, in denen euch die jeweiligen Funktionen inklusive aller möglichen Varianten mit entsprechenden Beispielen erklärt werden.


{| class="wikitable"
{| class="wikitable toptextcells"
|-
|-
! scope="col" | Property
! style="height: 40px; width: 200px" | Bereich !! style="width: 600px" | Funktionen
! colspan="2" scope="col" | Description
! colspan="3" scope="col" | Comment
|-
|-
| switch
! [[Intensity (DDF-Syntax) DMXC3|Intensität]]
| colspan="2" | Fixture hat einen Switch-Kanal.<br>
| [[Intensity (DDF-Syntax) DMXC3#Dimmer|Dimmer]], [[Intensity (DDF-Syntax) DMXC3#Switch|Switch]], [[Intensity (DDF-Syntax) DMXC3#Shutter|Shutter]], [[Intensity (DDF-Syntax) DMXC3#Strobe|Strobe]]
| colspan="3" | <source lang="xml"><switch dmxchannel="0" /></source>
|-
|-
| dimmer
! [[Position (DDF-Syntax) DMXC3|Position]]
| colspan="2" | Fixture hat einen Dimmer-Kanal.<br>
| [[Position (DDF-Syntax) DMXC3#Position|Position]], [[Position (DDF-Syntax) DMXC3#Pan-Tilt-Geschwindigkeit|Pan-Tilt-Geschwindigkeit]]
| colspan="3" | <source lang="xml"><dimmer dmxchannel="0" /></source>
|-
|-
| matrix
! [[Color (DDF-Syntax) DMXC3|Farbe]]
| colspan="2" | Fixture ist ein Matrix-Gerät.<br>
| [[Color (DDF-Syntax) DMXC3#RGBx-Farbmischung|RGBx-Farbmischung]], [[Color (DDF-Syntax) DMXC3#CMY-Farbmischung|CMY-Farbmischung]], [[Color (DDF-Syntax) DMXC3#HSV-Farbmischung|HSV-Farbmischung]], [[Color (DDF-Syntax) DMXC3#Farbrad|Farbrad]], [[Color (DDF-Syntax) DMXC3#Farbtemperatur|Farbtemperatur]]
| colspan="3" | <source lang="xml"><matrix rows="2" columns="3">
  <rgb>
    <red dmxchannel="2" />
    <green dmxchannel="2" />
    <blue dmxchannel="2" />
  </rgb>
  <rgb>
    <red dmxchannel="2" />
    <green dmxchannel="2" />
    <blue dmxchannel="2" />
  </rgb>
  <rgb>
    <red dmxchannel="2" />
    <green dmxchannel="2" />
    <blue dmxchannel="2" />
  </rgb>
  <rgb>
    <red dmxchannel="2" />
    <green dmxchannel="2" />
    <blue dmxchannel="2" />
  </rgb>
  <rgb>
    <red dmxchannel="2" />
    <green dmxchannel="2" />
    <blue dmxchannel="2" />
  </rgb>
  <rgb>
    <red dmxchannel="2" />
    <green dmxchannel="2" />
    <blue dmxchannel="2" />
  </rgb>
</matrix>
</source>
|-
|-
| fog
! [[Matrix (DDF-Syntax) DMXC3|Pixel-Effekte]]
| colspan="2" | Nebel-Kanal<br>
| [[Matrix (DDF-Syntax) DMXC3#Matrix|Matrix]], [[Radix (DDF-Syntax) DMXC3#Radix|Radix]]
| colspan="3" | <source lang="xml"><fog dmxchannel="0" /></source>
|-
|-
| shutter
! [[Gobo (DDF-Syntax) DMXC3|Gobo]]
| colspan="2" | Fixture hat einen Shutter.<br>
| [[Gobo (DDF-Syntax) DMXC3#Goborad|Goborad]]
| colspan="3" | <source lang="xml"><shutter dmxchannel="0" /></source>
|-
|-
| strobe
! [[Beam (DDF-Syntax) DMXC3|Lichtstrahl]]
| colspan="2" | Fixture hat einen Strobe-Kanal.<br>
| [[Beam (DDF-Syntax) DMXC3#Fokus|Fokus]], [[Beam (DDF-Syntax) DMXC3#Frost|Frost]], [[Beam (DDF-Syntax) DMXC3#Iris|Iris]], [[Beam (DDF-Syntax) DMXC3#Zoom|Zoom]]
| colspan="3" | <source lang="xml"><strobe dmxchannel="0" /></source>
|-
|-
| iris<br>
! [[Blades (DDF-Syntax) DMXC3|Blendenschieber]]
| colspan="2" | Fixture hat einen Iris-Kanal.<br>
| [[Blades (DDF-Syntax) DMXC3|Blendenschieber]]
| colspan="3" | <source lang="xml"><iris dmxchannel="0"/></source>
|-
|-
| focus<br>
! [[Effectwheel (DDF-Syntax) DMXC3|Effektrad]]
| colspan="2" | Fixture hat einen Fokus-Kanal.<br>
| [[Effectwheel (DDF-Syntax) DMXC3#Prisma|Prisma]], [[Effectwheel (DDF-Syntax) DMXC3#Effektrad|Effektrad]]
| colspan="3" | <source lang="xml"><focus dmxchannel="0"/></source>
|-
|-
| zoom<br>
! [[Stage Effect (DDF-Syntax) DMXC3|Bühneneffekte]]
| colspan="2" | Fixture hat einen Zoom-Kanal.<br>
| [[Stage Effect (DDF-Syntax) DMXC3#Nebel|Nebel]], [[Stage Effect (DDF-Syntax) DMXC3#Ventilator|Ventilator]]
| colspan="3" | <source lang="xml"><zoom dmxchannel="0"/></source>
|-
|-
| rgb
! [[Open Function (DDF-Syntax) DMXC3|Allgemeine Funktionen]]
| colspan="2" | Fixture hat die RGB-Funktion.
| [[Open Function (DDF-Syntax) DMXC3#Index|Index]], [[Open Function (DDF-Syntax) DMXC3#Rotation|Rotation]], [[Open Function (DDF-Syntax) DMXC3#Cool|Cool]], [[Open Function (DDF-Syntax) DMXC3#Heat|Heat]]
| colspan="3" | <source lang="xml"><rgb>
  <red dmxchannel="0" />
  <green dmxchannel="1" />
  <blue dmxchannel="2" />
</rgb>
</source>
|-
|-
| cmy<br>
! [[Open Function (DDF-Syntax) DMXC3|Freie Funktionen]]
| colspan="2" | Fixture hat die CMY-Funktion.<br>
| [[Open Function (DDF-Syntax) DMXC3#rawstep|rawstep]], [[Open Function (DDF-Syntax) DMXC3#raw|raw]], [[Open Function (DDF-Syntax) DMXC3#rawranges|rawranges]], [[Open Function (DDF-Syntax) DMXC3#const|const]]
| colspan="3" | <source lang="xml"><cmy>
|}
  <cyan dmxchannel="0"/>
 
  <magenta dmxchannel="1"/>
= Procedures =
  <yellow dmxchannel="2"/>
{| class="wikitable toptextcells"
</cmy>
</source>
|-
|-
| position
! style="height: 40px; width: 200px" | Kapitel !! style="width: 600px" | Zusammenfassung
| colspan="2" | Fixture hat Pan und/ oder Tilt.
| nowrap="nowrap" colspan="3" | <source lang="xml"><position>
  <pan dmxchannel="0">
    <range range="540" />
  </pan>
  <tilt dmxchannel="1">
    <range range="246" />
  </tilt>
</position>
</source>
|-
|-
| color wheel
! [[Procedures (DDF-Syntax) DMXC3|Funktionen]]
| colspan="2" | Fixture mit Farbrad
| Dieser Artikel listet alle in DMXControl 3 verfügbaren Procedures auf.
| colspan="2" | <source lang="xml"><colorwheel dmxchannel="0">
  <step type="color" val="#ffffff" caption="Weiß" mindmx="0" maxdmx="0" />
  <step type="color" val="#00bd52" caption="Grün 203" mindmx="32" maxdmx="32" />
  <step type="color" val="#080094" caption="Blau 108" mindmx="64" maxdmx="64" />
  <step type="color" val="#8e10bc" caption="UV" mindmx="96" maxdmx="96" />
  <step type="color" val="#eedefe" caption="1/2 Minus Green" mindmx="128" maxdmx="128" />
  <step type="color" val="#ffffff" caption="Weiß" mindmx="160" maxdmx="160" />
</colorwheel>
</source>
|-
|-
| rowspan="3" | gobo wheel
! [[Procedures (DDF-Syntax examples) DMXC3|Beispiele]]
| rowspan="3" | Fixture mit Gobobrad
| Der Artikel zeigt ein paar Beispiele für vorgegebene, aber auch für eigene Procedures.
| valign="top" nowrap="nowrap" |
|}
<br>
 
Goborotation


| valign="top" nowrap="nowrap" rowspan="3" | <source lang="xml"><gobowheel dmxchannel="0">
= Tutorials =
  <goborotation dmxchannel="12" finedmxchannel="13">
{| class="wikitable toptextcells"
    <step type="stop" mindmx="0" maxdmx="2" />
    <step type="stop" mindmx="253" maxdmx="255" />
    <range type="cw" mindmx="3" maxdmx="127" minval="0,1" maxval="8" />
    <range type="ccw" mindmx="252" maxdmx="128" minval="0,1" maxval="8" />
  </goborotation>
  <goboindex dmxchannel="8" finedmxchannel="9">
    <range mindmx="0" maxdmx="255" range="395" />
  </goboindex>
  <goboshake dmxchannel="7" />
    <step type="open" caption="Open" mindmx="0" maxdmx="11" />
    <step type="gobo" caption="Gobo 1" mindmx="12" maxdmx="15" val="gobo1.png">
      <step for="goborotation" mindmx="36" maxdmx="39" />
      <range handler="shake" mindmx="60" maxdmx="71" minval="0,1" maxval="3" />
    </step>
  ...
</gobowheel></source>
|-
|-
| valign="top" |  
! style="height: 40px; width: 200px" | Kapitel !! style="width: 600px" | Zusammenfassung
Gobopositi
 
|-
|-
|  
! [[DDF-Tutorial LED-Scheinwerfer DMXC3|LED-Scheinwerfer]]
Rotation Gobo 1
| Im ersten von insgesamt drei Tutorials wird das DDF für einen einfachen LED-Scheinwerfer erstellt. Als Vorlage dient Cameo LED Mini Tri Par Can 3W.
 
Shake Gobo 1<br>
|-
|-
|| rawstep<br>
! [[DDF-Tutorial 4er-Bar DMXC3|4er-LED-Bar]]
| colspan="2" | Fixture hat undefinierte Funktionen.<br>
| Das zweite Tutorial behandelt die manuelle Erstellung eines DDFs für einer 4er-LED-Bar am Beispiel der Eurolite LED KLS-2500.
|| <source lang="xml"><rawstep dmxchannel="0" name="Macros">
<step caption="MACRO 15" mindmx="0" maxdmx="1" />
...
</rawstep> </source>
|-
|-
|| const<br>
! [[DDF-Tutorial Moving Head DMXC3|Moving Head]]
| colspan="2" | Fixture hat nichtbenutzten Kanal.<br>
| Das dritte Beispiel zeigt, wie das DDF für einen einfachen Moving Head erstellt wird. Als Vorlage dient hier der Showtec Indigo 150 LED, der teilweise auch unter anderen Marken vertrieben wurde.
|| <source lang="xml"><const dmxchannel="1" val="0" name="Macro"/> </source>
|}
|}


Wenn das Fixture über ein Farb-/Goborad verfügt, das sich kontinuierlich drehen kann, dann schreibt man das so:<br>
= Links und Referenzen =
<source lang="xml"><gobowheel dmxchannel="0">
== Links ==
  <step type="open" caption="Open" mindmx="0" maxdmx="0" />
  <step type="gobo" caption="Gobo 1" mindmx="11" maxdmx="11" />
  ...
  <wheelrotation>
    <range type="cw" mindmx="221" maxdmx="203" minval="0,1" maxval="2" />
    <range type="ccw" mindmx="222" maxdmx="240" minval="0,1" maxval="2" />
  </wheelrotation>
</gobowheel>
</source>
<br>
 
Wenn das Fixture über ein Farb-/Goborad verfügt, das sich auf zufällige Positionen drehen kann, dann schreibt man das so:<br>
<source lang="xml">
<gobowheel dmxchannel="0">
  <step type="open" caption="Open" mindmx="0" maxdmx="0" />
  ...
  <random>
    <step type="fast" mindmx="241" maxdmx="245" />
    <step type="medium" mindmx="246" maxdmx="250" />
    <step type="slow" mindmx="251" maxdmx="255" />
  </random>
</gobowheel>
</source>
<br>
 
Wenn ein Gerät über feine Kanäle für z.B Zoom verfügt, dann schreibt man das so:
<br>
<source lang="xml"><zoom dmxchannel="0" finedmxchannel="1"/></source>
 
Das funktioniert bei jedem Property.
<br>
Die verschiedenen Intervalle in einem DMX-Kanal werden von der „Step“ Variablen definiert:
 
<source lang="xml">
<step val="0" mindmx="0" maxdmx="127" />
<step val="100" mindmx="128" maxdmx="255" />
</source>
 
oder:
 
<source lang="xml">
<step type="color" val="#FFFFFF" caption="Weiß" mindmx="0" maxdmx="31" />
<step type="color" val="#FF0000" caption="Rot" mindmx="32" maxdmx="63" />
</source>
 
{{BoxHinweis
|Text=Ein [[DDFCreator3.0#DDFCreator3.x|DDFCreator]] für DMXControl 3 ist bereits in Arbeit, siehe [http://www.dmxcontrol.de/forum/index.php?page=Thread&threadID=7931&pageNo=1 Forum]. Ihr könnt mit diesem Prototype arbeiten oder die eigenen DDFs mit einem XML-Editor Eurer Wahl oder einfach mit einem Texteditor erstellen. Manchmal hilft es, ein bereits existierendes DDF zu kopieren und anzupassen.
Bitte sendet uns Eure neuen DDFs, damit wir sie in die Bibliothek aufnehmen können.
}}
 
==Links und Referenzen==
Links
<references/>
<references/>
{{End-LaTeX}}
{{NavigationTop-Man3
|zurückLink =
|zurückText =
|vorLink =
|vorText =
}}


== Videotutorials ==
Auf unserem {{DMXCWebLinks|YouTube}} findet ihr zu diesem Thema folgende Videos.
{|
{{DMXC3 Manual-Tableentry Videolink | rHtUIUjNfLQ | Spot on: Wir bauen uns DDFs}}
|}


[[en: DDF DMXC3]]
[[Kategorie: Handbuch DMXControl 3]]
[[Kategorie: Handbuch DMXControl 3]]

Aktuelle Version vom 10. November 2024, 15:06 Uhr

Blockdevice.png Artikel beschreibt
DMXControl 3.3.0		 DDF DMXC3
Inhaltsverzeichnis
Teil 1: Grundlagen
Teil 2: Funktionen
Teil 3: Procederes
Teil 4: Beispiele


DDF ist die Abkürzung für "Device Definition File". DDFs werden von DMXControl verwendet, um Informationen über die verwendeten Geräte zu erhalten:

  • welche DMX-Kanäle werden überhaupt belegt?
  • welche Funktionen habe die verschiedenen DMX-Kanäle?
  • wie sehen die Farben auf einem Farbrad bzw. die Gobo auf einem Goborad aus?
  • gibt es verschiedene Strobe-Funktionen und wenn ja, welche?

Dies und viele weitere Informationen sind in einem vollständigen DDF enthalten. DMXControl 3 benötigt die Informationen, um anhand dessen die Bedienoberfläche in Form der Gerätesteuerung (Device Control) und den Steuerfenster (Control Panel) aufzubauen. Darüber hinaus ermöglicht DMXControl 3 unter Einbeziehung des Hardware Abstraktions-Layers (HAL) auch das Ansteuern unterschiedlicher Geräte. Alle Informationen werden in der Datei in einer klassischen XML-Struktur beschrieben, sodass alle Angaben auch nur mit dem klassischen Editor von Windows oder Notepad++[1] und dem dort verfügbaren Plugin XML-Tools[2] im Klartext lesbar sind.

Dieser Teil des Handbuchs über DMXControl 3 beschäftigt mit der Erstellung von DDFs. Die Unterteilung der Artikel orientiert sich dabei an den vorhandenen Steuerfenster in DMXControl 3 selbst. Der Teil des Handbuchs zu den DDFs in DMXControl 3 gliedert sich in vier Bereiche:

  • Grundlagen und wichtige Hinweise zur DDF-Erstellung
  • Syntax der unterstützten Funktionen
  • Procedures zum Aufrufen bestimmter Gerätefunktionen
  • Beispiele zur manuellen Programmierung von DDFs für DMXControl 3


Wichtiger Hinweis Der aktuelle DDFCreator unterstützt auf Grund seines Alters nicht alle Funktionen, die in den DDFs für DMXControl 3 abgebildet werden können. Unter Umständen löscht der DDFCreator Bestandteile im DDF, die dieser nicht kennt. Daher ist es empfehlenswert, den DDFCreator nicht mehr zu verwenden, sobald im DDF manuell zusätzliche Funktionen hinzugefügt wurden.
Achtung, wichtiger Hinweis! DDFs für DMXControl 2 sind nicht mit den DDFs für DMXControl 3 kompatibel, da sich der interne Aufbau komplett unterscheidet. DMXControl 3 benötigt für den Hardware Abstraktions-Layers (HAL) zusätzliche Informationen. Auch bringen die DDFs keine selbst gebaute Bedienoberfläche mit. Alle Steuerelemente generiert DMXControl 3 einheitlich über die GUI.


Grundlagen

Kapitel Zusammenfassung
Allgemeine Einführung Die allgemeine Einführung gibt einen groben Überblick, was DDFs im Kontext von DMXControl 3 sind, nach welchen Merkmalen die DDFs in DMXControl 3 zum Einsatz kommen und welche Verzeichnisse auf dem PC für die DDFs genutzt werden.
Grundaufbau Dieser Artikel beschreibt die grundlegende Struktur eines DDFs für DMXControl 3 sowie die Angaben wie Informationen zum Gerät, die im Informationsteil zu machen sind.
Funktionselemente In diesem Artikel werden verschiedene Gemeinsamkeiten erläutert, die unabhängig von der verwendeten Funktion zu einer vollständigen Definition von insbesondere komplexeren DMX-Kanälen benötigt werden und daher in den meistern DDFs zu finden sind.
Grundregeln Die Grundregeln fassen zusammen, von welchen Einheiten der HAL beispielsweise bei der Festlegung der maximalen Strobefrequenz ausgeht.


Wichtiger Hinweis DMXControl 3.2 unterstützt noch keine Multibeam-Geräte (Geräte mit seperat gesteuerten Lampen). Dies kann mithilfe mehrerer einzelner DDFs, bzw. einem DDF und Generic RGB, Dimmer, etc. umgangen werden.

Funktionsübersicht

In den DDFs werden folgende Funktionen direkt von der HAL unterstützt. Die Tabelle verweist euch auf die verschiedenen Artikel, in denen euch die jeweiligen Funktionen inklusive aller möglichen Varianten mit entsprechenden Beispielen erklärt werden.

Bereich Funktionen
Intensität Dimmer, Switch, Shutter, Strobe
Position Position, Pan-Tilt-Geschwindigkeit
Farbe RGBx-Farbmischung, CMY-Farbmischung, HSV-Farbmischung, Farbrad, Farbtemperatur
Pixel-Effekte Matrix, Radix
Gobo Goborad
Lichtstrahl Fokus, Frost, Iris, Zoom
Blendenschieber Blendenschieber
Effektrad Prisma, Effektrad
Bühneneffekte Nebel, Ventilator
Allgemeine Funktionen Index, Rotation, Cool, Heat
Freie Funktionen rawstep, raw, rawranges, const

Procedures

Kapitel Zusammenfassung
Funktionen Dieser Artikel listet alle in DMXControl 3 verfügbaren Procedures auf.
Beispiele Der Artikel zeigt ein paar Beispiele für vorgegebene, aber auch für eigene Procedures.

Tutorials

Kapitel Zusammenfassung
LED-Scheinwerfer Im ersten von insgesamt drei Tutorials wird das DDF für einen einfachen LED-Scheinwerfer erstellt. Als Vorlage dient Cameo LED Mini Tri Par Can 3W.
4er-LED-Bar Das zweite Tutorial behandelt die manuelle Erstellung eines DDFs für einer 4er-LED-Bar am Beispiel der Eurolite LED KLS-2500.
Moving Head Das dritte Beispiel zeigt, wie das DDF für einen einfachen Moving Head erstellt wird. Als Vorlage dient hier der Showtec Indigo 150 LED, der teilweise auch unter anderen Marken vertrieben wurde.

Links und Referenzen

Links

  1. ↑ Notepad++ ist ein freier Text- und Quellcodeeditor. Weitere Informationen auf der Herstellerseite: https://notepad-plus-plus.org/
  2. ↑ Installationsanleitung für das Plugin XML-Tools mit Hilfe des integrierten Pluginadministrator von Notepad++: https://community.notepad-plus-plus.org/topic/16983/xml-tools/2

Videotutorials

Auf unserem YouTube-Kanal findet ihr zu diesem Thema folgende Videos.

Spot on: Wir bauen uns DDFs
Abgerufen von „https://wiki-de.dmxcontrol-projects.org/index.php?title=DDF_DMXC3&oldid=18406“