3.7. Display

<display> ‐ The elements controlling display appearance

3.7.1. Attributes

NameTypeDefaults
with_screen_time_displayBOOLEANfalse
with_splash_screenBOOLEANfalse
splash_screen_fileSTRINGEmpty string
splash_screen_encodingSTRINGpnga
success_screen_fileSTRINGEmpty string
success_screen_encodingSTRINGpnga
defeat_screen_fileSTRINGEmpty string
defeat_screen_encodingSTRINGpnga
full_screenBOOLEANtrue
echoFLOAT0.0

3.7.2. Description

This element defines the details about the visual appearance of the display.

The boolean value of the with_screen_time_display attribute defines whether a slide bar of the remaining time is displayed by VC and corresponds to a game mode. The boolean value of the with_splash_screen attribute defines whether a splash screen is displayed at the launching of VC. If this attribute is set to true, the string value of the attribute splash_screen_file defines the name of the bitmap that will be displayed when launching VC, and splash_screen_encoding indicate the file format (see texture encodings for a list of accepted values). Similarly the string value of the attributes success_screen_file, defeat_screen_file, success_screen_encoding, and defeat_screen_encoding define the names and encodings of the bitmaps that will be displayed at the end of a game in interactive mode (attribute with_screen_time_display set to true).

The boolean value of the full_screen attribute defines whether the scene is rendered through the full display or through a window. In the second case, the dimensions and layout of the window are defined by the window layout element attached to the main window.

The float value of the echo attribute defines the amount decay used to copy images in the accumulation buffer. If echo is not null, motion results in a trail of fading images, that is used to simulate motion blur.

3.7.3. Expected content

None.

3.7.4. Example

The example below enables splash screen, graphic display of remaining time, and full screen.

<display with_splash_screen="true" with_screen_time_display="true"
  full_screen="true"/>