This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Basics
Rendering
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Version Control
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
Double Precision Coordinates
API
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
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials

RC Files

General Information#

Unigine GUI uses resource files, which define some global settings for GUI. These files are in the XML format and have an RC extension. The RC file should be accompanied by a font file named font.ttf, which will be used by default. The font file should be located in the same directory as the RC file, along with other GUI skin files. There can be only one RC file in a folder.

The default RC file for system GUI is data/core/gui/gui.rc.

Syntax#

As a correct XML file, an RC file must start with a standard declaration. The second required element is a root tag resource. This root element can contain zero or more other elements (tags) specifying the resources.

Source code (XML)
<?xml version="1.0" encoding="utf-8"?>
<resource version="1.0">
	<animation expose="6.0" fade_in="8.0" fade_out="4.0"/>
	<default size="14" color="#ddddffff" alpha="1.0"/>
	<focused color="#ffffffff" alpha="1.0"/>
	<disabled color="#869caaff" alpha="0.8"/>
	<transparent color="#869caaff" alpha="0.8"/>
	<tooltip size="13" color="#000000ff" alpha="0.95" time="0.4"/>
</resource>

If an RC file is not syntactically correct, Unigine will log the error to the console and the main log file.

Notice
All RC files are treated as having the UTF-8 encoding, even if you specify another one in the declaration.

Resources#

animation#

This tag handles windows animation.

Parameters:

  • expose
    Duration of animation played when the object appears. Measured in cycles per second, for example, expose="6" means that the duration is a 1/6 of a second.
  • fade_in
    Duration of fading in animation played when the object gets focused. Measured in cycles per second.
  • fade_out
    Duration of fading out animation played when the object loses focus. Measured in cycles per second.

default#

Default options for all widgets.

Parameters:

  • size
    Font size.
  • color
    Font color, in #RRGGBBAA format (hexadecimal).
  • alpha
    Alpha value, 0.0 means completely transparent.

focused#

Options for widgets in focus.

Parameters:

  • color
    Modulation color, in #RRGGBBAA format (hexadecimal).
  • alpha
    Alpha value, 0.0 means completely transparent.

disabled#

Options for disabled widgets.

Parameters:

  • color
    Modulation color, in #RRGGBBAA format (hexadecimal).
  • alpha
    Alpha value, 0.0 means completely transparent.

transparent#

Options for semi-transparent widgets like windows with blendable="yes" and comboboxes.

Parameters:

  • color
    Modulation color, in #RRGGBBAA format (hexadecimal).
  • alpha
    Alpha value, 0.0 means completely transparent.

tooltip#

Options for tooltips.

Parameters:

  • size
    Font size.
  • color
    Font color, in #RRGGBBAA format (hexadecimal).
  • alpha
    Alpha value, 0.0 means completely transparent.
  • time
    Delay before the tooltip appears. Measured in cycles per second.
Last update: 2024-08-16
Build: ()