LibArtNet

LibArtNet

LibArtNet ist eine Java-Implementierung des Art-Net 4-Protokolls, das von Artistic License Ltd. verwaltet wird.

Bitte beachten Sie, dass sich LibArtNet noch in der Betaphase befindet.

Weitere Informationen finden Sie jedoch in der Funktionsliste, der Roadmap und den Beitragsmöglichkeiten. Wenn Sie das Gefühl haben, dass etwas fehlt, das dort nicht aufgeführt ist, können Sie gerne ein Problem eröffnen.

Merkmale

• Basis-Art-Net-Empfänger
• Grundlegender Art-Net-Sender

Unterstützte Art-Net-Pakete

• ArtDmx
  • Sequenznummer
  • 15-Bit-Universumsadressierung
• ArtPoll
  • Unicast
  • Senden von ArtPollReply bei Statusänderungen
  • Prioritäten für Diagnosedaten
• ArtPollReply
  • Makros
  • Fernbedienungen
  • OEM-Codes (alle OEM-Codes integriert)
  • kurze/lange Namen
  • Ausstattungsstile
  • viel mehr
• ArtTimeCode
  • 24/25/29,97/30 fps

Roadmap

Geplante Funktionen sind

• Art-Net-Controller, eine Abstraktionsschicht, die den vorhandenen Empfänger und Sender als Konsole nutzt
• Art-Net-Knoten, eine Abstraktionsschicht, die den vorhandenen Empfänger und Sender als Knoten nutzt
• RDM-Unterstützung

Verwendung

Alle Klassen werden mit Javadoc dokumentiert. Wenn jedoch etwas fehlt oder unklar ist, können Sie gerne ein Problem eröffnen.

Anforderungen

• Java 1.8 oder höher
• Gradle, wenn Sie aus dem Quellcode kompilieren möchten

Installation

LibArtNet ist auf Maven Central und auf der Release-Seite verfügbar.

Maven

Fügen Sie diese Abhängigkeit zu pom.xml hinzu:

< dependency >
  < groupId >de.deltaeight</ groupId >
  < artifactId >LibArtNet</ artifactId >
  < version >1.1.2-beta</ version >
</ dependency >

Gradle

Fügen Sie dies zu build.gradle hinzu:

dependencies {
    implementation ' de.deltaeight:LibArtNet:1.1.2-beta '
}

Kompilieren aus der Quelle

Führen Sie Folgendes aus, um eine .jar Datei zur Verwendung in Ihrer IDE zu erstellen

./gradlew :lib:jar 

Anwendungsbeispiele

Verwendung des Empfängers

Der Empfänger benötigt Empfangshandler, die aufgerufen werden, wenn das entsprechende Paket empfangen wird:

 ArtNetReceiver receiver = new ArtNetReceiver ()
    . withArtDmxReceiveHandler ( packet -> System . out . println ( "Channel 63 value: " + packet . getData ()[ 62 ]));

receiver . start ();

// Do other stuff

receiver . stop ();

Verwendung des Absenders

Der Absender benötigt zum Senden Art-Net-Pakete, daher benötigen wir zunächst eine Builder-Instanz für die gewünschten Pakete:

 ArtPollReplyBuilder builder = new ArtPollReplyBuilder ()
        // report as Robert Juliat Dalis Reference : 860
        . withProduct ( OemCode . getProductByOemCode ( "OemRobertJulDalis1" ))
        . withBindIp ( new byte []{ 127 , 0 , 0 , 1 });

ArtNetSender sender = new ArtNetSender ();
sender . start ();

sender . send ( InetAddress . getByName ( "127.0.0.1" ), builder . build ());

// Do other stuff

sender . stop ();

Beitragen

Ihr Beitrag ist mehr als willkommen!

Wenn Sie einen Beitrag leisten möchten, freuen wir uns über jede Hilfe. Fühlen Sie sich frei zu forken, Pull-Requests zu erstellen und Issues für Bugs oder Feature-Requests zu öffnen.

Für Fehlerberichte, Funktionsanfragen und Pull-Anfragen gibt es Vorlagen, die Sie einfach ausfüllen können, um uns die erforderlichen Informationen bereitzustellen.

Bitte werfen Sie einen Blick auf den Beitragsleitfaden und den Verhaltenskodex, bevor Sie einen Beitrag leisten.

Lizenz

LibArtNet ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie unter LICENSE.md.