当前位置:   article > 正文

Unity 编辑器篇|(四)编辑器拓展GUI类 (全面总结 | 建议收藏)_unity节点编辑器扩展

unity节点编辑器扩展

1. 前言

  • GUI 类是 Unity GUI 的接口,并且具有手动定位功能。
  • “即时模式”GUI 系统(也称为 IMGUI)是一个完全独立的功能系统,不同于 Unity 基于游戏对象的主 UI 系统。IMGUI 是一个代码驱动的 GUI 系统,主要用作程序员的工具。为了驱动该系统,需在实现脚本上调用 OnGUI 函数
  • 即时模式 GUI 系统常用于:
    • 创建游戏内调试显示和工具。
    • 为脚本组件创建自定义检视面板。
    • 创建新的编辑器窗口和工具以扩展 Unity 本身。

2. 参数

2.1 静态变量

属性描述
backgroundColor用于 GUI 渲染的所有背景元素的全局着色颜色。
changed如果任何控件更改了输入数据的值,则返回 true。
colorGUI 的全局着色颜色。
contentColor为 GUI 渲染的所有文本着色。
depth当前正在执行的 GUI 行为的排序深度。
enabled是否启用了 GUI?
matrixGUI 变换矩阵。
skin要使用的全局皮肤。
tooltip鼠标指针当前悬停在其上或具有键盘焦点的控件的工具提示。(只读)

2.2 静态函数

属性描述
BeginGroup开始一个组。必须与 EndGroup 调用配对使用。
BeginScrollView在 GUI 内开始一个滚动视图。
Box在 GUI 层上创建一个框。
BringWindowToBack将特定窗口放置到该浮动窗口的后方。
BringWindowToFront将特定窗口放置到该浮动窗口的前方。
Button创建一个单击按钮。当用户点击该按钮时,立即执行一些操作。
DragWindow使窗口可被拖动。
DrawTexture在一个矩形内绘制纹理。
DrawTextureWithTexCoords使用给定的纹理坐标在矩形内绘制纹理。
EndGroup结束组。
EndScrollView结束使用 BeginScrollView 调用开始的滚动视图。
FocusControl将键盘焦点移动到某个命名控件。
FocusWindow使某个窗口成为激活窗口。
GetNameOfFocusedControl获取具有焦点的命名控件的名称。
HorizontalScrollbar创建一个水平滚动条。滚动条是用于滚动文档的控件。大多数情况下,您需要的可能是滚动视图。
HorizontalSlider用户可以拖动的水平滑动条,用于在最小值和最大值之间更改某值。
Label在屏幕上创建一个文本或纹理标签。
ModalWindow显示一个模态窗口。
PasswordField创建一个可让用户输入密码的文本字段。
RepeatButton创建一个只要用户按住就一直处于激活状态的按钮。
ScrollTo滚动包含的所有滚动视图,让它们尝试使 position 可见。
SelectionGrid创建一个按钮网格。
SetNextControlName设置下一个控件的名称。
TextArea创建一个可供用户编辑字符串的多行文本区域。
TextField创建一个可供用户编辑字符串的单行文本字段。
Toggle创建一个打开/关闭的开关按钮。
Toolbar创建一个工具栏。
UnfocusWindow从所有窗口移除焦点。
VerticalScrollbar创建一个垂直滚动条。滚动条是用于滚动文档的控件。大多数情况下,您需要的可能是滚动视图。
VerticalSlider用户可以拖动的垂直滑动条,用于在最小值和最大值之间更改某值。
Window创建一个弹出窗口。

2.3 委托

属性描述
WindowFunction开在窗口中绘制 GUI 的回调(与 GUI.Window 配合使用)。

3. 功能

3.1 按钮:Button、RepeatButton

  • Button:点击该按钮时,立即执行一些操作。
  • RepeatButton:用户按住就一直处于激活状态。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    void OnGUI()
    {
        if (GUI.Button(new Rect(10, 70, 50, 30), "Button"))
        {
            Debug.Log("Button");
        }

        if (GUI.RepeatButton(new Rect(80, 70, 100, 30), "RepeatButton"))
        {
            Debug.Log("RepeatButton");
        }
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17

1

3.2 文本:Label 、TextField 、TextArea 、PasswordField

  • Label:在屏幕上创建一个文本或纹理标签。
  • TextField:创建一个可供用户编辑字符串的单行文本字段。
  • TextArea:创建一个可供用户编辑字符串的多行文本区域。
  • PasswordField:创建一个可让用户输入密码的文本字段。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    public Texture2D textureToDisplay;
    public string fieldToEdit = "Hello World";
    public string areaToEdit = "Hello World\nI've got 2 lines...";
    public string passwordToEdit = "My Password";
    void OnGUI()
    {
        //Label
        GUI.Label(new Rect(10, 10, 100, 20), "Hello World!");
        GUI.Label(new Rect(140, 10, textureToDisplay.width, textureToDisplay.height), textureToDisplay);

        //TextField
        fieldToEdit = GUI.TextField(new Rect(10, 80, 200, 20), fieldToEdit, 25);

        //TextArea
        areaToEdit = GUI.TextArea(new Rect(10, 120, 200, 100), areaToEdit, 200);

        //PasswordField
        passwordToEdit = GUI.PasswordField(new Rect(10, 250, 200, 20), passwordToEdit, "*"[0], 25);
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24

2

3.3 滑动条:HorizontalScrollbar 、VerticalScrollbar

  • HorizontalScrollbar :创建一个水平滚动条。滚动条是用于滚动文档的控件。大多数情况下,您需要的可能是滚动视图。
  • VerticalScrollbar:创建一个垂直滚动条。滚动条是用于滚动文档的控件。大多数情况下,您需要的可能是滚动视图。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    public float hSbarValue;
    public float vSbarValue;
    void OnGUI()
    {
        hSbarValue = GUI.HorizontalScrollbar(new Rect(50, 25, 100, 30), hSbarValue, 1.0F, 0.0F, 10.0F);
        vSbarValue = GUI.VerticalScrollbar(new Rect(25, 25, 30, 100), vSbarValue, 1.0F, 10.0F, 0.0F);
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

在这里插入图片描述

3.4 滑条:VerticalSlider 、HorizontalSlider

  • VerticalSlider:用户可以拖动的垂直滑动条,用于在最小值和最大值之间更改某值。
  • HorizontalSlider :用户可以拖动的水平滑动条,用于在最小值和最大值之间更改某值。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    public float hSliderValue = 0.0F;
    public float vSliderValue = 0.0f;
    void OnGUI()
    {
        hSliderValue = GUI.HorizontalSlider(new Rect(50, 25, 100, 30), hSliderValue, 0.0F, 10.0F);
        vSliderValue = GUI.VerticalSlider(new Rect(25, 25, 30, 100), vSliderValue, 10.0f, 0.0f);
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

6

3.5 切换框:Toggle

  • Toggle:创建一个打开/关闭的开关按钮。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    public Texture aTexture;

    private bool toggleTxt = false;
    private bool toggleImg = false;
    void OnGUI()
    {
        toggleTxt = GUI.Toggle(new Rect(10, 10, 100, 30), toggleTxt, "A Toggle text");
        toggleImg = GUI.Toggle(new Rect(10, 50, 50, 50), toggleImg, aTexture);
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14

6

3.6 工具栏:Toolbar

  • Toolbar:创建一个工具栏。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    public int toolbarInt = 0;
    public string[] toolbarStrings = new string[] { "Toolbar1", "Toolbar2", "Toolbar3" };
    void OnGUI()
    {
        toolbarInt = GUI.Toolbar(new Rect(25, 25, 250, 30), toolbarInt, toolbarStrings);
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11

7

3.7 自动布局框:Box

  • Box:在 GUI 层上创建一个框。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    void OnGUI()
    {
        GUI.Box(new Rect(0, 0, Screen.width, Screen.height), "This is a box");
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

8

3.8 按钮网格:SelectionGrid

  • SelectionGrid:创建一个按钮网格。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    public int selGridInt = 0;
    public string[] selStrings = new string[] { "Grid 1", "Grid 2", "Grid 3", "Grid 4" };

    void OnGUI()
    {
        selGridInt = GUI.SelectionGrid(new Rect(50, 40, 100, 50), selGridInt, selStrings, 2);
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

9

3.9 窗口:Window 、ModalWindow

  • Window :创建一个弹出窗口。
  • ModalWindow:模态窗口与 Window 类似,但它将始终位于所有其他 GUI 的上方,并且在显示期间,保证是所有 GUI 输入和事件的唯一接收者。显示 ModalWindow 期间,其他控件将不处理输入。注意,一次只能显示一个 ModalWindow。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    public Rect windowRect = new Rect(20, 20, 120, 50);
    public Rect modalWindowRect = new Rect(150, 20, 120, 50);

    void OnGUI()
    {
        windowRect = GUI.Window(0, windowRect, DoMyWindow, "My Window");
        modalWindowRect = GUI.ModalWindow(1, modalWindowRect, DoMyWindow, "My ModalWindow");
    }
    void DoMyWindow(int windowID)
    {
        if (GUI.Button(new Rect(10, 20, 100, 20), "Hello World"))
        {
            print("Got a click");
        }
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20

10

3.10 绘制纹理:DrawTexture

  • DrawTexture:在一个矩形内绘制纹理。
属性描述
position要在其中绘制纹理的屏幕矩形。
image要显示的 Texture。
scaleMode当图像的宽高比不适合要绘制的宽高比时,如何缩放图像。
alphaBlend绘制图像时是否应用 Alpha 混合(默认启用)。
imageAspect用于源图像的宽高比。如果为 0(默认值),则使用图像的宽高比。传入 w/h 来指定所需的宽高比。这让您能够在不改变像素宽度和高度的情况下调整源图像的宽高比。
using UnityEngine;

public class GUIExample : MonoBehaviour
{
    public Texture aTexture;

    void OnGUI()
    {
        if (!aTexture)
        {
            return;
        }

        GUI.DrawTexture(new Rect(10, 10, 60, 60), aTexture, ScaleMode.StretchToFill, true, 10.0F);
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16

11

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/菜鸟追梦旅行/article/detail/115332
推荐阅读
相关标签
  

闽ICP备14008679号