AxolotlClient Rendering

模组

· 作者 AxolotlClient

AxolotlClient 的 GUI 渲染库。方便且简洁地渲染一些形状、静态 SVG 和 TrueType 字体。

0 本站下载 0 关注 更新于 1 个月前

需要前置:legacy-lwjgl3、Ornithe Standard Libraries

最新 0.0.12+1.8.9 · 1.8.9 · Ornithe

一键开服(送7天)

AxolotlClient Rendering

本库允许对某些圆角形状(例如矩形)、静态 SVG 和 TrueType 字体进行基于光影的渲染。

对于 SVG,包含了 Apache Batik 库;对于字体,使用了 Freetype¹。

对于玩家

这是一个库,你通常不需要手动安装它。(除非有人错误地声明了依赖关系或忘记将其包含在内)

对于模组开发者

在项目中的引入

本库发布在 。

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

注意:如果你不想将此库嵌入到你的模组中,可以省略 include 语句。在这种情况下,请确保正确声明你的依赖关系,以便启动器能够下载该库。

提示:如果你正在编写一个使用此库的库,请将 modImplementation 替换为 modApi!

一般用法

本库的大多数方法可以通过 Minecraft 的 GuiGraphics 类访问,具体是通过注入的 GuiGraphicsExtension 接口。 在 1.8.9 版本中,由于没有 GuiGraphics 类,你应该使用 DrawUtil.get() 获取 GuiGraphicsExtension。 所有通过这种方式暴露的方法都以 axolotlclient_rendering 为前缀。

可以使用 Font.read(...) 加载字体。如果你使用的是可变字体,这将自动读取变体并适当地利用它们, 然而 FreeType 直接支持的字体功能相当有限。 如果特定功能由单独的字体文件提供(例如 斜体 或 粗体 变体),则可以使用 Font#addSubFont 添加它们,并指定应在何种条件下使用这些变体 (一些标签和值可以在 Font 类中找到作为静态定义)。

使用此库的项目

你的项目使用了此库,并希望在此处显示?请告知我们!

常见问题解答

  • 我在 1.20.1 上使用此库,但字体看起来很糟糕

    答:因为 Minecraft 1.20.1 使用的是 lwjgl 3.3.1,当时还没有 Freetype 绑定,因此本库使用了 STB_Truetype,它不支持微调(可能还有其他我们不知道的 bug)。

  • 但是 1.8.9 不是使用 lwjgl2 吗?这也低于 3.3.2 吧?

    答:确实如此,不过借助 legacy-lwjgl3,我们可以在 lwjgl 3.3.6 上运行,在那里我们有 Freetype 的绑定。

  • 难道不能在 1.20.1 上也使用更新的 lwjgl 吗?

    答:可以,但这更加困难,会进一步增加 jar 包的大小,并且会与像 sodium 这样的模组产生不兼容,因为这些模组会检查它们运行的 lwjgl 版本。

¹见常见问题解答,答案 #1

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源