AxolotlClient Rendering

AxolotlClient Rendering

Эта библиотека позволяет отрисовывать некоторые скруглённые фигуры (например, прямоугольники), статические SVG и шрифты TrueType с помощью шейдеров.

Для SVG включена библиотека Apache Batik, для шрифтов используется Freetype¹.

Для игроков

Это библиотека, вам не нужно устанавливать её вручную. (Если только кто-то неправильно не указал свои зависимости или забыл включить её)

Для разработчиков модов

Включение в ваш проект

Эта библиотека опубликована на https://maven.axolotlclient.com.

dependencies {
  modImplementation(include("io.github.axolotlclient.rendering:AxolotlClient-rendering:VERSION+MINECRAFT_VERSION")!!)
}

Примечание: вы можете опустить include, если не хотите встраивать эту библиотеку в свой мод. В таком случае обязательно правильно укажите свои зависимости, чтобы лаунчеры могли скачать библиотеку.

Совет: замените modImplementation на modApi, если вы пишете библиотеку, использующую эту!

Общее использование

Большинство методов этой библиотеки доступны через класс GuiGraphics из Minecraft с помощью внедрённого интерфейса GuiGraphicsExtension. На 1.8.9, поскольку класса GuiGraphics нет, вам следует получить GuiGraphicsExtension с помощью DrawUtil.get(). Все методы, доступные таким образом, имеют префикс axolotlclient_rendering.

Шрифты можно загружать с помощью Font.read(...). Если вы используете вариант шрифта, это автоматически прочитает варианты и соответствующим образом их использует, однако возможности шрифтов, поддерживаемые FreeType напрямую, довольно ограничены. Если какая-то конкретная возможность предоставляется отдельным файлом шрифта (например, курсивным или жирным вариантом), их можно добавить с помощью Font#addSubFont, указав, при каких условиях его следует использовать (некоторые теги и значения можно найти как статические определения в классе Font).

Проекты, использующие эту библиотеку

• AxolotlClientConfig
• AxolotlClient

Ваш проект использует эту библиотеку и вы хотели бы, чтобы он появился здесь? Дайте нам знать!

FAQ

• Я использую эту библиотеку на 1.20.1, и шрифт выглядит плохо

  О: Поскольку Minecraft 1.20.1 использует lwjgl 3.3.1, в котором ещё не было привязок Freetype, эта библиотека использует STB_Truetype, который не поддерживает хинтинг (также могут быть другие баги, о которых мы не знаем).

• Но разве 1.8.9 не использует lwjgl2, который тоже ниже 3.3.2?

  О: Действительно, однако с legacy-lwjgl3 мы можем запустить её на lwjgl 3.3.6, где у нас есть привязки к Freetype.

• Разве нельзя было бы использовать более новый lwjgl и на 1.20.1?

  О: Да, но это сложнее, ещё больше увеличивает размер jar-файла и вызовет несовместимости с такими модами, как sodium, которые проверяют, на какой версии lwjgl они запущены.

¹См. FAQ, ответ №1