Satin API Mod (1.20.4) - Помощь моддерам в использовании шейдеров.

Satin API Mod (1.20.4) - это простая библиотека, которая позволяет моддерам добавлять интересные графические эффекты в свои моды. Ее основная функция - значительно упростить использование шейдерной системы Minecraft, управляемой данными (как в Super Secret Settings, Mob Vision и Spectral Arrow) Это легкая библиотека для использования шейдеров OpenGL, и она предназначена для использования моддерами для добавления интересных графических эффектов в свои моды.

Особенности.

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

Простая установка Satin изменяет игру несколькими способами, в основном связанными с ShaderEffects

Исправление униформы: использование целочисленных векторов в качестве униформы приводит к тому, что копирование-вставка не работает и выводит игру из строя в Vanilla; Satin перенаправляет вызов для загрузки правильного буфера.

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

Читаемая глубина: Satin предоставлял доступ к текстурам глубины во фреймбуфере до того, как это стало круто (устарело в 1.16).

Satin не устанавливает шейдеры в GameRenderer, за исключением случаев, когда мод зарегистрировал PickEntityShaderCallback.

Управление шейдерами.

Основная функция Satin - управление шейдерными эффектами.

ShaderEffect - это класс Minecraft, который реализует управляемые данными шейдеры с постобработкой, но есть несколько оговорок. Во-первых, эти шейдерные эффекты инициализируются сразу во время сборки, но их следует инициализировать после завершения загрузки игры, чтобы избежать ошибок gl. Во-вторых, их нужно обновлять каждый раз, когда меняется разрешение игры. Наконец, нет возможности задать форму из внешнего кода.

Satin управляет шейдерными эффектами за вас и предоставляет вам объект ManagedShaderEffect. Этот шейдерный эффект можно инициализировать вручную в любое время, но он легко инициализируется. Инициализированные шейдерные эффекты автоматически перезагружаются при изменении разрешения игры и при перезагрузке ресурсов. Также есть несколько методов доступа для динамической установки формы.

Утилиты слоя рендеринга

Классы ManagedFramebuffer и ManagedShaderProgram имеют методы для получения клона существующего объекта RenderLayer. Эта цель позволяет рисовать в ManagedFramebuffer в первом случае и в шейдерной программе во втором. Это может быть использовано, в частности, для отрисовки пользовательских эффектов на сущностях и блоках.

Обычные блоки не поддерживают пользовательские слои рендеринга. При использовании продвинутых шейдерных материалов следует рассмотреть возможность использования альтернативного рендерера, например Canvas.

Шейдерные утилиты.

В Satin есть несколько классов-утилит и методов, облегчающих работу с шейдерами, а не только ShaderEffect: ShaderLoader предоставляет возможность загружать, создавать и связывать программы шейдеров OpenGL в одном вызове метода, а ShaderLoader предоставляет возможность загружать, создавать и связывать программы шейдеров OpenGL в одном вызове метода, GlPrograms предоставляет вспомогательные методы для работы с этими программами, а пакет matrix помогает получать матрицы и манипулировать ими.