revert documentation changes in THEMES.md

This commit is contained in:
Sophia Hadash 2021-08-23 14:57:33 +02:00 committed by SophiaHadash
parent ad080e7740
commit eb4a8d5fae

View file

@ -52,7 +52,7 @@ Here is a very simple theme that changes the description text's color:
```xml ```xml
<theme> <theme>
<formatVersion>7</formatVersion> <formatVersion>6</formatVersion>
<view name="detailed"> <view name="detailed">
<text name="description"> <text name="description">
<color>00FF00</color> <color>00FF00</color>
@ -72,18 +72,17 @@ Here is a very simple theme that changes the description text's color:
Everything must be inside a `<theme>` tag. Everything must be inside a `<theme>` tag.
**The `<formatVersion>` tag *must* be specified**. This is the version of the theming system the theme was designed for. **The `<formatVersion>` tag *must* be specified**. This is the version of the theming system the theme was designed for.
The current version is 7. The current version is 6.
A *view* can be thought of as a particular "screen" within EmulationStation. Views are defined like this: A *view* can be thought of as a particular "screen" within EmulationStation. Views are defined like this:
```xml ```xml
<view name="ViewNameHere"> <view name="ViewNameHere">
... define elements here ... ... define elements here ...
</view> </view>
``` ```
An *element* is a particular visual element, such as an image or a piece of text. You can either modify an element that already exists for a particular view (as is done in the "description" example), like this: An *element* is a particular visual element, such as an image or a piece of text. You can either modify an element that already exists for a particular view (as is done in the "description" example), like this:
```xml ```xml
@ -123,7 +122,7 @@ You can include theme files within theme files, similar to `#include` in C (thou
```xml ```xml
<theme> <theme>
<formatVersion>7</formatVersion> <formatVersion>6</formatVersion>
<view name="detailed"> <view name="detailed">
<text name="description"> <text name="description">
<fontPath>./all_themes/myfont.ttf</fontPath> <fontPath>./all_themes/myfont.ttf</fontPath>
@ -137,7 +136,7 @@ You can include theme files within theme files, similar to `#include` in C (thou
```xml ```xml
<theme> <theme>
<formatVersion>7</formatVersion> <formatVersion>6</formatVersion>
<include>./../all_themes.xml</include> <include>./../all_themes.xml</include>
<view name="detailed"> <view name="detailed">
<text name="description"> <text name="description">
@ -151,7 +150,7 @@ Is equivalent to this `snes/theme.xml`:
```xml ```xml
<theme> <theme>
<formatVersion>7</formatVersion> <formatVersion>6</formatVersion>
<view name="detailed"> <view name="detailed">
<text name="description"> <text name="description">
<fontPath>./all_themes/myfont.ttf</fontPath> <fontPath>./all_themes/myfont.ttf</fontPath>
@ -171,7 +170,7 @@ Sometimes you want to apply the same properties to the same elements across mult
```xml ```xml
<theme> <theme>
<formatVersion>7</formatVersion> <formatVersion>6</formatVersion>
<view name="basic, grid, system"> <view name="basic, grid, system">
<image name="logo"> <image name="logo">
<path>./snes_art/snes_header.png</path> <path>./snes_art/snes_header.png</path>
@ -189,7 +188,7 @@ This is equivalent to:
```xml ```xml
<theme> <theme>
<formatVersion>7</formatVersion> <formatVersion>6</formatVersion>
<view name="basic"> <view name="basic">
<image name="logo"> <image name="logo">
<path>./snes_art/snes_header.png</path> <path>./snes_art/snes_header.png</path>
@ -222,7 +221,7 @@ You can theme multiple elements *of the same type* simultaneously. The `name` a
```xml ```xml
<theme> <theme>
<formatVersion>7</formatVersion> <formatVersion>6</formatVersion>
<view name="detailed"> <view name="detailed">
<!-- Weird spaces/newline on purpose! --> <!-- Weird spaces/newline on purpose! -->
<text name="md_lbl_rating, md_lbl_releasedate, md_lbl_developer, md_lbl_publisher, <text name="md_lbl_rating, md_lbl_releasedate, md_lbl_developer, md_lbl_publisher,
@ -237,7 +236,7 @@ Which is equivalent to:
```xml ```xml
<theme> <theme>
<formatVersion>7</formatVersion> <formatVersion>6</formatVersion>
<view name="detailed"> <view name="detailed">
<text name="md_lbl_rating"> <text name="md_lbl_rating">
<color>48474D</color> <color>48474D</color>
@ -296,7 +295,7 @@ Example `navigationsounds.xml`, to be included from the main theme file:
```xml ```xml
<theme> <theme>
<formatVersion>7</formatVersion> <formatVersion>6</formatVersion>
<feature supported="navigationsounds"> <feature supported="navigationsounds">
<view name="all"> <view name="all">
<sound name="systembrowse"> <sound name="systembrowse">
@ -861,47 +860,9 @@ EmulationStation borrows the concept of "nine patches" from Android (or "9-Slice
- Where on the component `pos` refers to. For example, an origin of `0.5 0.5` and a `pos` of `0.5 0.5` would place - Where on the component `pos` refers to. For example, an origin of `0.5 0.5` and a `pos` of `0.5 0.5` would place
the component exactly in the middle of the screen. the component exactly in the middle of the screen.
* `textColor` - type: COLOR. Default is 777777FF. * `textColor` - type: COLOR. Default is 777777FF.
* `textColorDimmed` - type: COLOR. Default is 777777FF.
* `iconColor` - type: COLOR. Default is 777777FF. * `iconColor` - type: COLOR. Default is 777777FF.
* `iconColorDimmed` - type: COLOR. Default is 777777FF.
* `fontPath` - type: PATH. * `fontPath` - type: PATH.
* `fontSize` - type: FLOAT. * `fontSize` - type: FLOAT.
* `entrySpacing` - type: FLOAT. Default is 16.0f.
- Spacing in pixels between the help system components.
* `iconTextSpacing` - type: FLOAT. Default is 8.0f.
- Spacing in pixels within a help system component between it's icon and text.
* `textStyle` - type: STRING. Default is `uppercase`.
- The style of the text. Options: `uppercase`, `lowercase`, `camelcase`.
* `dpad_updown` - type: PATH.
* `dpad_leftright` - type: PATH.
* `dpad_all` - type: PATH.
* `thumbstick_click` - type: PATH.
* `button_l` - type: PATH.
* `button_r` - type: PATH.
* `button_lr` - type: PATH.
* `button_a_SNES` - type: PATH.
* `button_b_SNES` - type: PATH.
* `button_x_SNEs` - type: PATH.
* `button_y_SNES` - type: PATH.
* `button_back_SNES` - type: PATH.
* `button_start_SNES` - type: PATH.
* `button_a_PS` - type: PATH.
* `button_b_PS` - type: PATH.
* `button_x_PS` - type: PATH.
* `button_y_PS` - type: PATH.
* `button_back_PS4` - type: PATH.
* `button_start_PS4` - type: PATH.
* `button_back_PS5` - type: PATH.
* `button_start_PS5` - type: PATH.
* `button_a_XBOX` - type: PATH.
* `button_b_XBOX` - type: PATH.
* `button_x_XBOX` - type: PATH.
* `button_y_XBOX` - type: PATH.
* `button_back_XBOX` - type: PATH.
* `button_start_XBOX` - type: PATH.
* `button_back_XBOX360` - type: PATH.
* `button_start_XBOX360` - type: PATH.
- All options starting with `button_`: Path to custom button icon.
#### carousel #### carousel