HP ThinPro - Login Screen Customization

2
Overview
HP ThinPro Background Manager can be used to choose between several predefined background themes, but customization
is available. This white paper outlines the many options available and allows you to construct a desktop background and
login screen for your needs.
Themes
The directory /etc/hptc-zero-login/styles contains the configuration files for each of the themes shown in
Background Manager, with each style in its own subdirectory. For each connection type, there is one directory that specifies
the style elements of the connection’s background image and login dialog box style.
To create a custom theme, you can either modify the files in one of the theme directories or create a new directory to build
your own theme. If you create a new theme directory, it is added to the list of themes visible from Background Manager.
There are up to three relevant files in each theme directory. If any of these files is missing, the default settings are used.
• bgConfig.rtf specifies the desktop background
• desktop.qss specifies the appearance of the login window
• login.rtf specifies other details about the login window, such as its position, buttons, and so on
Desktop background configuration
Within a style directory, the file bgConfig.rtf specifies the desktop background. The syntax of a bgConfig.rtf file is in a
stylesheet-like format with some or all of the elements described as follows. Each element begins with the element type
and then a set of attributes surrounded by braces, such as the following example:
global {
color: 666666; # Dark gray
padding: 20; # 20 pixels
}
Any number of image, polygon, rectangle, or text elements can be specified. If any gradients are specified, only the last
gradient element is used to specify the color of the desktop background; otherwise, the color specified in the global section
is used. Any line that begins with a number sign (#) is considered a comment and is ignored, as are blank lines. Text that
follows a semicolon and begins with # is also treated as a comment, such as the previous example.
Each element is assigned a set of attributes such as size, color, and position. Each attribute is specified by the attribute
name followed by a colon, followed by its values, and then followed by a semicolon, all on a single line. Some of these
attributes are common to many element types. Those attributes are described in Common attributes
.
The advantage of building a desktop background from elements rather than using a single large, scaled image is that this
configuration method accommodates a wide variety of monitor sizes, aspect ratios, and configurations, so that it works on a
configuration with four 4K monitors at a 16:9 aspect ratio the same as it does on a single 1024×768 4:3 monitor.
Common attributes
name
Parameters: A string
Example: name: itemName;
Default: none
Use: Specifies a string to associate with the element. It is used only in debugging output, such as when a syntax or value
error is found in attribute parsing.
padding
Parameters: An absolute (pixel) or percentage value
Example: padding: 20;