This page has been translated automatically.
视频教程
界面
要领
高级
实用建议
专业(SIM)
UnigineEditor
界面概述
资源工作流程
版本控制
设置和首选项
项目开发
调整节点参数
Setting Up Materials
设置属性
照明
Sandworm
使用编辑器工具执行特定任务
如何擴展編輯器功能
嵌入式节点类型
Nodes
Objects
Effects
Decals
光源
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
编程
基本原理
搭建开发环境
使用范例
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
材质和着色器
Rebuilding the Engine Tools
GUI
双精度坐标
应用程序接口
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
创建内容
内容优化
材质
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials

Unigine::Plugins::Interface Class

Header: #include <plugins/Unigine/Interface/UnigineInterface.h>
Warning
Interface plugin is deprecated and no longer supported. We can't guarantee the stable work of the plugin.

This set of functions is available when the Interface plugin is loaded.

Interface Class

Members


int findWindow ( const Ptr<Gui> & gui ) #

Returns the number of the Interface window rendered by the given gui instance.

Arguments

  • const Ptr<Gui> & gui - Gui instance.

Return value

Window number, if it exists; otherwise, -1.

int getCenterPositionX ( int width ) #

Returns the coordinate along the X axis, at which the window of the given width will be positioned in the center of the screen.
Notice
The function won't return a value in the following cases:
  • If the parent flag of the interface window is set to 0.
  • If the window is hidden.
  • If the window is not focused.
  • If the window is not an instance of the WidgetWindow class.

Arguments

  • int width - Window width.

Return value

X coordinate of the window.

int getCenterPositionY ( int height ) #

Returns the coordinate along the Y axis, at which the window of the given height will be positioned in the center of the screen.
Notice
The function won't return a value in the following cases:
  • If the parent flag of the interface window is set to 0.
  • If the window is hidden.
  • If the window is not focused.
  • If the window is not an instance of the WidgetWindow class.

Arguments

  • int height - Window height.

Return value

Y coordinate of the window.

int getHeight ( ) #

Returns the screen space height. If there are two monitors arranged vertically, the height of two monitors is returned.

Return value

Screen height.

int getMouseX ( ) #

Returns the X-coordinate (in the screen space) of the mouse cursor.

Return value

X-coordinate of the mouse cursor.

int getMouseY ( ) #

Returns the Y-coordinate (in the screen space) of the mouse cursor.

Return value

Y-coordinate of the mouse cursor.

int getNumScreens ( ) #

Returns the number of available screens (monitors).

Return value

The number of screens.

int getNumWindows ( ) #

Returns the number of Interface windows.

Return value

Number of Interface windows.

int getPositionX ( ) #

Returns the X coordinate of the Interface window.

Return value

X coordinate of the window.

int getPositionY ( ) #

Returns the Y coordinate of the Interface window.

Return value

Y coordinate of the window.

int getScreenHeight ( int num ) #

Returns the height of the given screen (monitor).

Arguments

  • int num - Screen number.

Return value

Height of the screen.

int getScreenPositionX ( int num ) #

Returns the position of the given screen (monitor) in a horizontal row in the screen space. If there are two monitors arranged horizontally, the X-coordinate position of the first monitor is 0 and of the second one, for example, 1280.

Arguments

  • int num - Screen number.

Return value

X-coordinate position of the screen.

int getScreenPositionY ( int num ) #

Returns the position of the given screen (monitor) in a vertical column in the screen space. If there are two monitors arranged vertically, the Y-coordinate position of the first monitor is 0 and of the second one, for example, 1024.

Arguments

  • int num - Screen number.

Return value

Y-coordinate position of the screen.

int getScreenWidth ( int num ) #

Returns the width of the given screen (monitor).

Arguments

  • int num - Screen number.

Return value

Width of the screen.

int getVisiblePositionX ( int x, int width, int border = INTERFACE_BORDER ) #

Checks if the window of the given width is visible on a screen with the specified border at the given coordinate. If the window is visible, its position will remain the same. Otherwise, it will be updated in order to make the window visible (taking into account the size of the vertical border).

Arguments

  • int x - X coordinate in the screen space.
  • int width - Window width.
  • int border - Horizontal border size.

Return value

The given X coordinate if the window is visible; otherwise, the X coordinate, at which the window will be visible.

int getVisiblePositionY ( int y, int height, int border = INTERFACE_BORDER ) #

Checks if the window of the given height is visible on a screen with the specified border at the given coordinate. If the window is visible, its position will remain the same. Otherwise, it will be updated in order to make the window visible (taking into account the size of the vertical border).

Arguments

  • int y - Y coordinate in the screen space.
  • int height - Window height.
  • int border - Vertical border size.

Return value

The given Y coordinate if the window is visible; otherwise, the Y coordinate, at which the window will be visible.

int getWidth ( ) #

Returns the screen space width. If there are two monitors arranged horizontally, the width of two monitors is returned.

Return value

Screen width.

InterfaceWindowInterface * getWindow ( int num ) #

Returns an Interface window by its number.

Arguments

  • int num - Interface window number.

Return value

Interface window.

void setMouse ( int x, int y ) #

Sets position (in screen space coordinates) of the mouse.

Arguments

  • int x - X-coordinate of the mouse cursor.
  • int y - Y-coordinate of the mouse cursor.

InterfaceWindow * createWindow ( int flags, const char * name ) const#

Creates a new interface window with the specified name and flags.

Arguments

  • int flags - Interface Window flags combination.
  • const char * name - Name of the new interface window.

Return value

Interface window.

void releaseWindow ( InterfaceWindow * OUT_window ) const#

Releases the specified interface window and performs cleanup.

Arguments

  • InterfaceWindow * OUT_window - Interface window to be released.
    Notice
    This output buffer is to be filled by the Engine as a result of executing the method.
Last update: 2023-03-15
Build: ()