LibArtNet

LibArtNet

LibArtNet é uma implementação Java do protocolo Art-Net 4 mantido pela Artistic License Ltd.

Tenha em mente que o LibArtNet ainda está em versão beta.

No entanto, consulte a lista de recursos, o roteiro e como contribuir para obter mais informações. Se você sentir que falta algo que não está listado lá, sinta-se à vontade para abrir um problema.

Características

• Receptor Art-Net básico
• Remetente Art-Net básico

Pacotes Art-Net suportados

• ArteDmx
  • Número de sequência
  • Endereçamento do universo de 15 bits
• ArtPoll
  • unicast
  • enviando ArtPollReply sobre mudanças de estado
  • prioridades para dados de diagnóstico
• ArtPollResposta
  • macros
  • controles remotos
  • Códigos OEM (todos os códigos OEM integrados)
  • nomes curtos/longos
  • estilos de equipamento
  • muito mais
• ArtTimeCode
  • 24/25/29,97/30fps

Roteiro

Os recursos planejados são

• Controlador Art-Net, uma camada de abstração que usa o receptor e o remetente existentes para atuar como um console
• Nó Art-Net, uma camada de abstração que usa o receptor e o remetente existentes para atuar como um nó
• Suporte RDM

Uso

Todas as classes são documentadas usando Javadoc. No entanto, se houver algo faltando ou não estiver claro, sinta-se à vontade para abrir um problema.

Requisitos

• Java 1.8 ou superior
• Gradle se você deseja compilar a partir do código-fonte

Instalação

LibArtNet está disponível no Maven Central e na página de lançamento.

Maven

Adicione esta dependência ao pom.xml :

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

Gradle

Adicione isto ao build.gradle :

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

Compilando da fonte

Para construir um arquivo .jar para usar em seu IDE, execute

./gradlew :lib:jar 

Exemplos de uso

Usando o receptor

O receptor precisa de manipuladores de recepção que são chamados quando o pacote apropriado é recebido:

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

receiver . start ();

// Do other stuff

receiver . stop ();

Usando o remetente

O remetente precisa de pacotes Art-Net para enviar, portanto, primeiro precisamos de uma instância de construtor para os pacotes desejados:

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

Contribuir

Sua contribuição é mais que bem-vinda!

Se você quiser contribuir, toda ajuda será muito apreciada. Sinta-se à vontade para bifurcar, criar solicitações pull e abrir problemas para bugs ou solicitações de recursos.

Para relatórios de bugs, solicitações de recursos e solicitações pull, existem modelos que você pode simplesmente preencher para nos fornecer as informações necessárias.

Por favor, dê uma olhada no guia de contribuição e no código de conduta antes de contribuir.

Licença

LibArtNet está licenciado sob a licença MIT. Consulte LICENSE.md para obter detalhes.