显示!

显示!

一个易于使用的基于小部件的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();
}