Version: 2019.2
Creating Screen Transitions
IMGUI Basics

Immediate Mode GUI (IMGUI)

The “Immediate Mode” GUI system (also known as IMGUI) is an entirely separate feature to Unity’s main GameObject-based UI System. IMGUI is a code-driven GUI system, and is mainly intended as a tool for programmers. It is driven by calls to the OnGUI function on any script which implements it. For example, this code:

    void OnGUI() {
        if (GUILayout.Button("Press Me"))
            Debug.Log("Hello!");
    }

Would result in a button displayed like so:

The result of the above code example
The result of the above code example

The Immediate Mode GUI system is commonly used for:

  • Creating in-game debugging displays and tools.
  • Creating custom inspectors for script components.
  • Creating new editor windows and tools to extend Unity itself.

The IMGUI system is not generally intended to be used for normal in-game user interfaces that players might use and interact with. For that you should use Unity’s main GameObject-based UI system, which offers a GameObject-based approach for editing and positioning UI elements, and has far better tools to work with the visual design and layout of the UI.

“Immediate Mode” refers to the way the IMGUI is created and drawn. To create IMGUI elements, you must write code that goes into a special function named OnGUI. The code to display the interface is executed every frame, and drawn to the screen. There are no persistent gameobjects other than the object to which your OnGUI code is attached, or other types of objects in the hierarchy related to the visual elements that are drawn.

Устаревшая система GUI позволяет создавать широкий спектр пользовательских интерфейсов из кода. Вместо того, чтобы создавать объект GUI, вручную его позиционировать и писать скрипт, который управляет его функциями, вы можете сделать все это несколькими строками кода. Код создаёт элементы управления GUI (GUI controls), которые инстанциируются, позиционируются и управляются вызовом одной функции.

Этот раздел показывает как использовать GUI в вашей игре и в расширениях для редактора Unity.

Creating Screen Transitions
IMGUI Basics