
显示!
一个易于使用的基于小部件的UI库!
Shown!
Shown! 是一个基于控件的 Minecraft UI 库,可以轻松创建各种用途的界面!
屏幕
就像 Minecraft 一样,你需要从一个屏幕(Screen)开始。屏幕是你创建和处理整个界面的地方。 最基本的屏幕可以按如下方式创建:
public class ExampleScreen extends ShownScreen {
public ExampleScreen() {
super();
}
@Override
protected void init() {
super.init();
}
}
在创建和添加控件时,你应该在 init() 中进行。你对 super.init() 的调用也应始终放在最后,因为它会为所有已添加的控件运行初始化,并更新每个控件的尺寸。
控件
添加控件非常简单,它们的工作方式也很简单。首先,我们应该介绍如何定位和缩放它们。
控件使用一个名为 UIVec 的自定义向量类来处理位置和缩放。UIVec 在每个轴上都有两个值:缩放(scale)和偏移(offset)。缩放是相对于父控件的轴值,而偏移是一个常量值。其工作原理的一个示例如下所示:

如上所示,面板的整个宽度为 100px,而盒子的高度仅为 80px。面板中包含的元素如下:
- 一个红色盒子,父控件为主面板。它的位置为 (0, 0, 0, 0),大小为 (0.5, 0.5, 0, 0),因此大小为 50x40px。
- 一个绿色盒子,父控件为主面板。它的位置为 (0.5, 0.25, 0, 0),大小为 (0.25, 0.75, 0, 0),因此大小为 25x60px,同时位于 (50, 20)。
- 一个蓝色盒子,父控件为红色盒子。它同样具有位置 (0, 0, 0, 0) 和大小 (0.5, 05, 0, 0),因此大小为 25x20px。
以这种方式定位和缩放控件,可以为所有屏幕尺寸提供精确的相对性,也可以实现特定尺寸的元素,例如 20px 高的标题栏。
利用这一理解,在屏幕中央放置一个简单面板控件,且每个轴上的大小为其一半,可以按如下方式完成:
@Override
protected void init() {
PanelWidget panel = new PanelWidget(
new UIVec(0.25, 0.25, 0, 0),
new UIVec(0.5, 0.5, 0, 0)
);
this.addWidget(panel);
super.init();
}
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。