artnet4j

ArtNet para Java e processamento

Biblioteca Art-Net DMX sobre IP para Java e Processamento. Esta biblioteca adiciona muitos recursos ao projeto artnet4j existente. Incluindo suporte para leitura de dados DMX.

Características

• Vincule o servidor a uma interface de rede personalizada
• Reutilização do endereço do soquete
• Adicionada capacidade de receber pacotes OpDmx
• Envie e receba via transmissão UDP.
• Suporte para pacotes Art-Ext.
• Suporte para pacotes OpTimeCode (graças a @MrExplode)
• Seleção de porta dos serviços UDP
• Suporta java versão 8 e 11 (oracle e openjdk)

Instalação

Eu recomendo instalá-lo no maven central. Caso contrário também é possível usar pacotes do github, jitpack.io ou apenas o download binário.

Maven

< dependency >
  < groupId >ch.bildspur</ groupId >
  < artifactId >artnet4j</ artifactId >
  < version >0.6.2</ version >
</ dependency >

Gradle

repositories {
    mavenCentral()
}

dependencies {
    compile ' ch.bildspur:artnet4j:0.6.2 '
}

Exemplos

A biblioteca adiciona uma nova classe chamada ArtNetClient , que contém acesso fácil à implementação subjacente do Art-Net.

Enviar dados Dmx

Para enviar dados DMX você precisa criar um novo cliente. É possível pular a criação do buffer passando null para o construtor.

 byte [] dmxData = new byte [ 512 ];
ArtNetClient artnet = new ArtNetClient ();
artnet . start ();

// set data
dmxData [ 0 ] = 128 ;

// send data to localhost on subnet 0 and universe 0
artnet . unicastDmx ( "127.0.0.1" , 0 , 0 , dmxData );

artnet . stop ();

Baseado em SendDmxData

Também é possível enviar os dados via broadcast.

 // to broad cast data
artnet . broadcastDmx ( 0 , 0 , dmxData );

Leia dados Dmx

Para ler dados você deve criar um novo cliente e ler os bytes do buffer. Esteja ciente de que você deve mascarar os bytes com 0xFF (porque eles estão assinados).

 ArtNetClient artnet = new ArtNetClient ();
artnet . start ();

byte [] data = artnet . readDmxData ( 0 , 0 );
System . out . println ( "First Byte: " + data [ 0 ] & 0xFF );
artnet . start . stop ();

Baseado em ReceiveDmxData

Selecione a porta

Ao criar o ArtNetClient , é possível selecionar as portas específicas para o servidor (entrada) e o cliente (saída).

 ArtNetClient artnet = new ArtNetClient ( new ArtNetBuffer (), 8000 , 8000 );

Baseado em SendOnSpecificPort

Vincular interface de rede personalizada

Também é possível definir uma interface de rede personalizada. Aqui você vê como vincular uma interface de rede personalizada en5 ao servidor ArtNet:

 NetworkInterface ni = NetworkInterface . getByName ( "en5" );
InetAddress address = ni . getInetAddresses (). nextElement ();

artnet . start ( address );

Receber eventos de pacote

Às vezes é necessário receber eventos quando um novo pacote foi recebido. Para este propósito, você pode obter o ArtNetServer subjacente e adicionar um novo ouvinte a ele.

 artnet = new ArtNetClient ();

// add packet listener to server
artnet . getArtNetServer (). addListener (
 new ArtNetServerEventAdapter () {
  @ Override public void artNetPacketReceived ( ArtNetPacket packet ) {
   println ( "new packet received!" );
  }
});

artnet . start ();

Sobre

A biblioteca é baseada no projeto artnet4j.

Art-Net da Artistic License permite a transmissão de dados DMX via IP/UDP. Esta biblioteca implementa o protocolo básico para aplicativos Java.

Os principais recursos atualmente suportados são:

• Descoberta de dispositivos/nó e atualização automática de configurações de nó
• Descritores digitados em Java de nós e propriedades de nós
• DmxUniverse abstraído permitindo acesso direto a pixel/canal sem ter que lidar com pacotes
• Suporte de configuração JAXB para armazenar descrições de universo/nó como XML
• Suporte ao ouvinte para vários eventos
• Envio de dados DMX512 via transmissão UDP ou unicast

Este projeto ainda está em fase pré-alfa, portanto atualmente apenas acesso à fonte via hg. Esteja ciente também de que grandes partes da base de código ainda estão passando por grandes mudanças.

Novos recursos são desenvolvidos por Florian.