LibArtNet

LibArtNet

LibArtNet — это Java-реализация протокола Art-Net 4, поддерживаемая Artistic License Ltd.

Имейте в виду, что LibArtNet все еще находится в стадии бета-тестирования.

Однако для получения дополнительной информации см. список функций, дорожную карту и информацию о том, как внести свой вклад. Если вы чувствуете, что чего-то не хватает, чего там нет, смело открывайте проблему.

Функции

• Базовый приемник Art-Net
• Базовый отправитель Art-Net

Поддерживаемые пакеты Art-Net

• АртDmx
  • Порядковый номер
  • 15-битная адресация вселенной
• АртОпрос
  • одноадресная передача
  • отправка ArtPollReply при изменении состояния
  • приоритеты диагностических данных
• ИскусствоОпросОтветить
  • макросы
  • пульты
  • OEM-коды (все OEM-коды встроены)
  • короткие/длинные имена
  • стили оборудования
  • гораздо больше
• АртВремеКод
  • 24/25/29,97/30 кадров в секунду

Дорожная карта

Планируемые функции

• Контроллер Art-Net, уровень абстракции, использующий существующие получатель и отправитель в качестве консоли.
• Узел Art-Net, уровень абстракции, использующий существующих получателя и отправителя в качестве узла.
• поддержка РДМ

Использование

Все классы документированы с использованием Javadoc. Однако, если чего-то не хватает или неясно, смело открывайте вопрос.

Требования

• Java 1.8 или выше
• Gradle, если вы хотите скомпилировать из исходного кода

Установка

LibArtNet доступен на Maven Central и на странице выпуска.

Мавен

Добавьте эту зависимость в pom.xml :

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

Градл

Добавьте это в build.gradle :

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

Компиляция из исходников

Чтобы создать файл .jar для использования в вашей IDE, запустите

./gradlew :lib:jar 

Примеры использования

Использование ресивера

Получателю необходимы обработчики приема, которые вызываются при получении соответствующего пакета:

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

receiver . start ();

// Do other stuff

receiver . stop ();

Использование отправителя

Отправителю для отправки нужны пакеты Art-Net, поэтому сначала нам нужен экземпляр компоновщика для нужных пакетов:

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

Способствовать

Ваш вклад более чем приветствуется!

Если вы хотите внести свой вклад, мы очень ценим любую помощь. Не стесняйтесь создавать форки, создавать запросы на включение и открывать проблемы для ошибок или запросов функций.

Для отчетов об ошибках, запросов на добавление функций и запросов на включение существуют шаблоны, которые вы можете просто заполнить, чтобы предоставить нам необходимую информацию.

Прежде чем внести свой вклад, ознакомьтесь с руководством по вкладам и кодексом поведения.

Лицензия

LibArtNet лицензируется по лицензии MIT. Подробности смотрите на LICENSE.md.