LibArtNet

LibArtNet

LibArtNet est une implémentation Java du protocole Art-Net 4 tel que maintenu par Artistic License Ltd.

N'oubliez pas que LibArtNet est toujours en version bêta.

Cependant, consultez la liste des fonctionnalités, la feuille de route et comment contribuer pour plus d'informations. Si vous pensez qu'il manque quelque chose qui n'y figure pas, n'hésitez pas à ouvrir un ticket.

Caractéristiques

• Récepteur Art-Net de base
• Expéditeur Art-Net de base

Paquets Art-Net pris en charge

• ArtDmx
  • Numéro de séquence
  • Adressage d'univers 15 bits
• Sondage artistique
  • monodiffusion
  • envoyer ArtPollReply sur les changements d'état
  • priorités pour les données de diagnostic
• ArtPollRépondre
  • macro
  • télécommandes
  • Codes OEM (tous les codes OEM intégrés)
  • noms courts/longs
  • styles d'équipement
  • bien plus
• ArtTimeCode
  • 24/25/29,97/30 ips

Feuille de route

Les fonctionnalités prévues sont

• Contrôleur Art-Net, une couche d'abstraction utilisant le récepteur et l'expéditeur existants pour agir comme une console
• Nœud Art-Net, une couche d'abstraction utilisant le récepteur et l'expéditeur existants pour agir en tant que nœud
• Prise en charge du GDR

Usage

Toutes les classes sont documentées à l'aide de Javadoc. Cependant, s'il manque quelque chose ou n'est pas clair, n'hésitez pas à ouvrir un ticket.

Exigences

• Java 1.8 ou supérieur
• Gradle si vous souhaitez compiler à partir des sources

Installation

LibArtNet est disponible sur Maven Central et sur la page de publication.

Maven

Ajoutez cette dépendance à pom.xml :

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

Graduation

Ajoutez ceci à build.gradle :

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

Compilation à partir des sources

Pour créer un fichier .jar à utiliser dans votre IDE, exécutez

./gradlew :lib:jar 

Exemples d'utilisation

Utilisation du récepteur

Le récepteur a besoin de gestionnaires de réception qui sont appelés lorsque le paquet approprié est reçu :

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

receiver . start ();

// Do other stuff

receiver . stop ();

Utilisation de l'expéditeur

L'expéditeur a besoin de paquets Art-Net pour envoyer, nous avons donc d'abord besoin d'une instance de constructeur pour les paquets souhaités :

 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 ();

Contribuer

Votre contribution est plus que bienvenue !

Si vous souhaitez contribuer, chaque aide est très appréciée. N'hésitez pas à créer des fork, à créer des pull request et à ouvrir des tickets pour des bugs ou des demandes de fonctionnalités.

Pour les rapports de bogues, les demandes de fonctionnalités et les demandes d'extraction, il existe des modèles que vous pouvez simplement remplir pour nous fournir les informations requises.

Veuillez consulter le guide de contribution et le code de conduite avant de contribuer.

Licence

LibArtNet est sous licence MIT. Voir LICENSE.md pour plus de détails.