User Tools

Site Tools


en:write_themes_for_emulationstation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
en:write_themes_for_emulationstation [2019/09/22 09:15]
lbrpdx
en:write_themes_for_emulationstation [2019/09/23 17:09] (current)
lbrpdx
Line 699: Line 699:
   * ''​pos''​ - type: NORMALIZED_PAIR.   * ''​pos''​ - type: NORMALIZED_PAIR.
   * ''​size''​ - type: NORMALIZED_PAIR.   * ''​size''​ - type: NORMALIZED_PAIR.
-  - Possible combinations:​ +    * Possible combinations:​ 
-  ​ - ​''​0 0''​ - automatically size so text fits on one line (expanding horizontally). +    ​*  ​''​0 0''​ - automatically size so text fits on one line (expanding horizontally). 
-  ​ - ​''​w 0''​ - automatically wrap text so it doesn'​t go beyond ''​w''​ (expanding vertically). +    ​*  ​''​w 0''​ - automatically wrap text so it doesn'​t go beyond ''​w''​ (expanding vertically). 
-  ​ - ​''​w h''​ - works like a "text box." ​ If ''​h''​ is non-zero and ''​h''​ <= ''​fontSize''​ (implying it should be a single line of text), text that goes beyond ''​w''​ will be truncated with an elipses (...).+    ​*  ​''​w h''​ - works like a "text box." ​ If ''​h''​ is non-zero and ''​h''​ <= ''​fontSize''​ (implying it should be a single line of text), text that goes beyond ''​w''​ will be truncated with an elipses (...).
   * ''​origin''​ - type: NORMALIZED_PAIR.   * ''​origin''​ - type: NORMALIZED_PAIR.
-  - 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. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.+    * 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. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.
   * ''​rotation''​ - type: FLOAT.   * ''​rotation''​ - type: FLOAT.
-  - angle in degrees that the text should be rotated. ​ Positive values will rotate clockwise, negative values will rotate counterclockwise.+    *  ​angle in degrees that the text should be rotated. ​ Positive values will rotate clockwise, negative values will rotate counterclockwise.
   * ''​rotationOrigin''​ - type: NORMALIZED_PAIR.   * ''​rotationOrigin''​ - type: NORMALIZED_PAIR.
-  - Point around which the text will be rotated. Defaults to ''​0.5 0.5''​.+    *  ​Point around which the text will be rotated. Defaults to ''​0.5 0.5''​.
   * ''​text''​ - type: STRING.   * ''​text''​ - type: STRING.
   * ''​color''​ - type: COLOR.   * ''​color''​ - type: COLOR.
   * ''​backgroundColor''​ - type: COLOR;   * ''​backgroundColor''​ - type: COLOR;
   * ''​fontPath''​ - type: PATH.   * ''​fontPath''​ - type: PATH.
-  - Path to a truetype font (.ttf).+    *  ​Path to a truetype font (.ttf).
   * ''​fontSize''​ - type: FLOAT.   * ''​fontSize''​ - type: FLOAT.
-  - Size of the font as a percentage of screen height (e.g. for a value of ''​0.1'',​ the text's height would be 10% of the screen height).+    *  ​Size of the font as a percentage of screen height (e.g. for a value of ''​0.1'',​ the text's height would be 10% of the screen height).
   * ''​alignment''​ - type: STRING.   * ''​alignment''​ - type: STRING.
-  - Valid values are "​left",​ "​center",​ or "​right"​. ​ Controls alignment on the X axis.  "​center"​ will also align vertically.+    *  ​Valid values are "​left",​ "​center",​ or "​right"​. ​ Controls alignment on the X axis.  "​center"​ will also align vertically.
   * ''​forceUppercase''​ - type: BOOLEAN. ​ Draw text in uppercase.   * ''​forceUppercase''​ - type: BOOLEAN. ​ Draw text in uppercase.
   * ''​lineSpacing''​ - type: FLOAT. ​ Controls the space between lines (as a multiple of font height). ​ Default is 1.5.   * ''​lineSpacing''​ - type: FLOAT. ​ Controls the space between lines (as a multiple of font height). ​ Default is 1.5.
   * ''​visible''​ - type: BOOLEAN.   * ''​visible''​ - type: BOOLEAN.
-      - If true, component will be rendered, otherwise rendering will be skipped. ​ Can be used to hide elements from a particular view.+    *  ​If true, component will be rendered, otherwise rendering will be skipped. ​ Can be used to hide elements from a particular view.
   * ''​zIndex''​ - type: FLOAT.   * ''​zIndex''​ - type: FLOAT.
-  - z-index value for component. ​ Components will be rendered in order of z-index value from low to high.+    *  ​z-index value for component. ​ Components will be rendered in order of z-index value from low to high.
   * ''​glowColor''​ - type: COLOR;   * ''​glowColor''​ - type: COLOR;
-  - NEW : Defines the color of the glow around the text.+    * NEW : Defines the color of the glow around the text.
   * ''​glowSize''​ - type: FLOAT.   * ''​glowSize''​ - type: FLOAT.
-  - NEW : Defines the size of the glow around the text.+    *  ​NEW : Defines the size of the glow around the text.
  
 ==textlist== ==textlist==
Line 734: Line 734:
   * ''​size''​ - type: NORMALIZED_PAIR.   * ''​size''​ - type: NORMALIZED_PAIR.
   * ''​origin''​ - type: NORMALIZED_PAIR.   * ''​origin''​ - type: NORMALIZED_PAIR.
-  - 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. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.+    *  ​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. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.
   * ''​selectorColor''​ - type: COLOR.   * ''​selectorColor''​ - type: COLOR.
-  - Color of the "​selector bar."+    *  ​Color of the "​selector bar."
   * ''​selectorColorEnd''​ - type: NORMALIZED_PAIR.   * ''​selectorColorEnd''​ - type: NORMALIZED_PAIR.
-      - NEW : Bottom color for the gradient of the "​selector bar."+    *  ​NEW : Bottom color for the gradient of the "​selector bar."
   * ''​selectorImagePath''​ - type: PATH.   * ''​selectorImagePath''​ - type: PATH.
-  - Path to image to render in place of "​selector bar."+    *  ​Path to image to render in place of "​selector bar."
   * ''​selectorImageTile''​ - type: BOOLEAN.   * ''​selectorImageTile''​ - type: BOOLEAN.
-  - If true, the selector image will be tiled instead of stretched to fit its size.+    *  ​If true, the selector image will be tiled instead of stretched to fit its size.
   * ''​selectorHeight''​ - type: FLOAT.   * ''​selectorHeight''​ - type: FLOAT.
-  - Height of the "​selector bar".+    *  ​Height of the "​selector bar".
   * ''​selectorOffsetY''​ - type: FLOAT.   * ''​selectorOffsetY''​ - type: FLOAT.
-  - Allows moving of the "​selector bar" up or down from its computed position. ​ Useful for fine tuning the position of the "​selector bar" relative to the text.+    *  ​Allows moving of the "​selector bar" up or down from its computed position. ​ Useful for fine tuning the position of the "​selector bar" relative to the text.
   * ''​selectedColor''​ - type: COLOR.   * ''​selectedColor''​ - type: COLOR.
-  - Color of the highlighted entry text.+    *  ​Color of the highlighted entry text.
   * ''​primaryColor''​ - type: COLOR.   * ''​primaryColor''​ - type: COLOR.
-  - Primary color; what this means depends on the text list.  For example, for game lists, it is the color of a game.+    *  ​Primary color; what this means depends on the text list.  For example, for game lists, it is the color of a game.
   * ''​secondaryColor''​ - type: COLOR.   * ''​secondaryColor''​ - type: COLOR.
-  - Secondary color; what this means depends on the text list.  For example, for game lists, it is the color of a folder.+    *  ​Secondary color; what this means depends on the text list.  For example, for game lists, it is the color of a folder.
   * ''​fontPath''​ - type: PATH.   * ''​fontPath''​ - type: PATH.
   * ''​fontSize''​ - type: FLOAT.   * ''​fontSize''​ - type: FLOAT.
   * ''​scrollSound''​ - type: PATH.   * ''​scrollSound''​ - type: PATH.
-  - Sound that is played when the list is scrolled.+    *  ​Sound that is played when the list is scrolled.
   * ''​alignment''​ - type: STRING.   * ''​alignment''​ - type: STRING.
-  - Valid values are "​left",​ "​center",​ or "​right"​. ​ Controls alignment on the X axis.+    *  ​Valid values are "​left",​ "​center",​ or "​right"​. ​ Controls alignment on the X axis.
   * ''​horizontalMargin''​ - type: FLOAT.   * ''​horizontalMargin''​ - type: FLOAT.
-  - Horizontal offset for text from the alignment point. ​ If ''​alignment''​ is "​left",​ offsets the text to the right. ​ If ''​alignment''​ is "​right",​ offsets text to the left.  No effect if ''​alignment''​ is "​center"​. ​ Given as a percentage of the element'​s parent'​s width (same unit as ''​size'''​s X value).+    *  ​Horizontal offset for text from the alignment point. ​ If ''​alignment''​ is "​left",​ offsets the text to the right. ​ If ''​alignment''​ is "​right",​ offsets text to the left.  No effect if ''​alignment''​ is "​center"​. ​ Given as a percentage of the element'​s parent'​s width (same unit as ''​size'''​s X value).
   * ''​forceUppercase''​ - type: BOOLEAN. ​ Draw text in uppercase.   * ''​forceUppercase''​ - type: BOOLEAN. ​ Draw text in uppercase.
   * ''​lineSpacing''​ - type: FLOAT. ​ Controls the space between lines (as a multiple of font height). ​ Default is 1.5.   * ''​lineSpacing''​ - type: FLOAT. ​ Controls the space between lines (as a multiple of font height). ​ Default is 1.5.
   * ''​zIndex''​ - type: FLOAT.   * ''​zIndex''​ - type: FLOAT.
-  - z-index value for component. ​ Components will be rendered in order of z-index value from low to high.+    *  ​z-index value for component. ​ Components will be rendered in order of z-index value from low to high.
  
 ==ninepatch== ==ninepatch==
Line 772: Line 772:
   * ''​path''​ - type: PATH.   * ''​path''​ - type: PATH.
   * ''​visible''​ - type: BOOLEAN.   * ''​visible''​ - type: BOOLEAN.
-      - If true, component will be rendered, otherwise rendering will be skipped. ​ Can be used to hide elements from a particular view.+    *  ​If true, component will be rendered, otherwise rendering will be skipped. ​ Can be used to hide elements from a particular view.
   * ''​zIndex''​ - type: FLOAT.   * ''​zIndex''​ - type: FLOAT.
-  - z-index value for component. ​ Components will be rendered in order of z-index value from low to high.+    *  ​z-index value for component. ​ Components will be rendered in order of z-index value from low to high.
  
 EmulationStation borrows the concept of "nine patches"​ from Android (or "​9-Slices"​). Currently the implementation is very simple and hard-coded to only use 48x48px images (16x16px for each "​patch"​). Check the ''​data/​resources''​ directory for some examples (button.png,​ frame.png). EmulationStation borrows the concept of "nine patches"​ from Android (or "​9-Slices"​). Currently the implementation is very simple and hard-coded to only use 48x48px images (16x16px for each "​patch"​). Check the ''​data/​resources''​ directory for some examples (button.png,​ frame.png).
Line 782: Line 782:
   * ''​pos''​ - type: NORMALIZED_PAIR.   * ''​pos''​ - type: NORMALIZED_PAIR.
   * ''​size''​ - type: NORMALIZED_PAIR.   * ''​size''​ - type: NORMALIZED_PAIR.
-  - Only one value is actually used. The other value should be zero.  (e.g. specify width OR height, but not both.  This is done to maintain the aspect ratio.)+    *  ​Only one value is actually used. The other value should be zero.  (e.g. specify width OR height, but not both.  This is done to maintain the aspect ratio.)
   * ''​origin''​ - type: NORMALIZED_PAIR.   * ''​origin''​ - type: NORMALIZED_PAIR.
-  - 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. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.+    *  ​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. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.
   * ''​rotation''​ - type: FLOAT.   * ''​rotation''​ - type: FLOAT.
-  - angle in degrees that the rating should be rotated. ​ Positive values will rotate clockwise, negative values will rotate counterclockwise.+    *  ​angle in degrees that the rating should be rotated. ​ Positive values will rotate clockwise, negative values will rotate counterclockwise.
   * ''​rotationOrigin''​ - type: NORMALIZED_PAIR.   * ''​rotationOrigin''​ - type: NORMALIZED_PAIR.
-  - Point around which the rating will be rotated. Defaults to ''​0.5 0.5''​.+    *  ​Point around which the rating will be rotated. Defaults to ''​0.5 0.5''​.
   * ''​filledPath''​ - type: PATH.   * ''​filledPath''​ - type: PATH.
-  - Path to the "​filled star" image. ​ Image must be square (width equals height).+    *  ​Path to the "​filled star" image. ​ Image must be square (width equals height).
   * ''​unfilledPath''​ - type: PATH.   * ''​unfilledPath''​ - type: PATH.
-  - Path to the "​unfilled star" image. ​ Image must be square (width equals height).+    *  ​Path to the "​unfilled star" image. ​ Image must be square (width equals height).
   * ''​color''​ - type: COLOR.   * ''​color''​ - type: COLOR.
-  - Multiply each pixel'​s color by this color. For example, an all-white image with ''<​color>​FF0000</​color>''​ would become completely red.  You can also control the transparency of an image with ''<​color>​FFFFFFAA</​color>''​ - keeping all the pixels their normal color and only affecting the alpha channel.+    *  ​Multiply each pixel'​s color by this color. For example, an all-white image with ''<​color>​FF0000</​color>''​ would become completely red.  You can also control the transparency of an image with ''<​color>​FFFFFFAA</​color>''​ - keeping all the pixels their normal color and only affecting the alpha channel.
   * ''​visible''​ - type: BOOLEAN.   * ''​visible''​ - type: BOOLEAN.
-      - If true, component will be rendered, otherwise rendering will be skipped. ​ Can be used to hide elements from a particular view.+    *  ​If true, component will be rendered, otherwise rendering will be skipped. ​ Can be used to hide elements from a particular view.
   * ''​zIndex''​ - type: FLOAT.   * ''​zIndex''​ - type: FLOAT.
-  - z-index value for component. ​ Components will be rendered in order of z-index value from low to high.+    *  ​z-index value for component. ​ Components will be rendered in order of z-index value from low to high.
  
 ==datetime== ==datetime==
Line 804: Line 804:
   * ''​pos''​ - type: NORMALIZED_PAIR.   * ''​pos''​ - type: NORMALIZED_PAIR.
   * ''​size''​ - type: NORMALIZED_PAIR.   * ''​size''​ - type: NORMALIZED_PAIR.
-  - Possible combinations:​ +    *  ​Possible combinations:​ 
-  ​ - ​''​0 0''​ - automatically size so text fits on one line (expanding horizontally). +      ​*  ​''​0 0''​ - automatically size so text fits on one line (expanding horizontally). 
-  ​ - ​''​w 0''​ - automatically wrap text so it doesn'​t go beyond ''​w''​ (expanding vertically). +      ​*  ​''​w 0''​ - automatically wrap text so it doesn'​t go beyond ''​w''​ (expanding vertically). 
-  ​ - ​''​w h''​ - works like a "text box." ​ If ''​h''​ is non-zero and ''​h''​ <= ''​fontSize''​ (implying it should be a single line of text), text that goes beyond ''​w''​ will be truncated with an elipses (...).+      ​*  ​''​w h''​ - works like a "text box." ​ If ''​h''​ is non-zero and ''​h''​ <= ''​fontSize''​ (implying it should be a single line of text), text that goes beyond ''​w''​ will be truncated with an elipses (...).
   * ''​origin''​ - type: NORMALIZED_PAIR.   * ''​origin''​ - type: NORMALIZED_PAIR.
-  - 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. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.+    *  ​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. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.
   * ''​rotation''​ - type: FLOAT.   * ''​rotation''​ - type: FLOAT.
-  - angle in degrees that the text should be rotated. ​ Positive values will rotate clockwise, negative values will rotate counterclockwise.+    *  ​angle in degrees that the text should be rotated. ​ Positive values will rotate clockwise, negative values will rotate counterclockwise.
   * ''​rotationOrigin''​ - type: NORMALIZED_PAIR.   * ''​rotationOrigin''​ - type: NORMALIZED_PAIR.
-  - Point around which the text will be rotated. Defaults to ''​0.5 0.5''​.+    *  ​Point around which the text will be rotated. Defaults to ''​0.5 0.5''​.
   * ''​color''​ - type: COLOR.   * ''​color''​ - type: COLOR.
   * ''​backgroundColor''​ - type: COLOR;   * ''​backgroundColor''​ - type: COLOR;
   * ''​fontPath''​ - type: PATH.   * ''​fontPath''​ - type: PATH.
-  - Path to a truetype font (.ttf).+    *  ​Path to a truetype font (.ttf).
   * ''​fontSize''​ - type: FLOAT.   * ''​fontSize''​ - type: FLOAT.
-  - Size of the font as a percentage of screen height (e.g. for a value of ''​0.1'',​ the text's height would be 10% of the screen height).+    *  ​Size of the font as a percentage of screen height (e.g. for a value of ''​0.1'',​ the text's height would be 10% of the screen height).
   * ''​alignment''​ - type: STRING.   * ''​alignment''​ - type: STRING.
-  - Valid values are "​left",​ "​center",​ or "​right"​. ​ Controls alignment on the X axis.  "​center"​ will also align vertically.+    *  ​Valid values are "​left",​ "​center",​ or "​right"​. ​ Controls alignment on the X axis.  "​center"​ will also align vertically.
   * ''​forceUppercase''​ - type: BOOLEAN. ​ Draw text in uppercase.   * ''​forceUppercase''​ - type: BOOLEAN. ​ Draw text in uppercase.
   * ''​lineSpacing''​ - type: FLOAT. ​ Controls the space between lines (as a multiple of font height). ​ Default is 1.5.   * ''​lineSpacing''​ - type: FLOAT. ​ Controls the space between lines (as a multiple of font height). ​ Default is 1.5.
   * ''​visible''​ - type: BOOLEAN.   * ''​visible''​ - type: BOOLEAN.
-      - If true, component will be rendered, otherwise rendering will be skipped. ​ Can be used to hide elements from a particular view. +    *  ​If true, component will be rendered, otherwise rendering will be skipped. ​ Can be used to hide elements from a particular view. 
-  * ''​zIndex''​ - type: FLOAT. +  * ''​zIndex''​ - type: FLOAT.  
-  ​ - ​z-index value for component. ​ Components will be rendered in order of z-index value from low to high.+    ​* ​z-index value for component. ​ Components will be rendered in order of z-index value from low to high.
   * ''​displayRelative''​ - type: BOOLEAN. ​ Renders the datetime as a a relative string (ex: 'x days ago')   * ''​displayRelative''​ - type: BOOLEAN. ​ Renders the datetime as a a relative string (ex: 'x days ago')
   * ''​format''​ - type: STRING. Specifies format for rendering datetime.   * ''​format''​ - type: STRING. Specifies format for rendering datetime.
-  - %Y: The year, including the century (1900) +    *  ​%Y: The year, including the century (1900) 
-  ​ - ​%m: The month number [01,12] +    ​*  ​%m: The month number [01,12] 
-  ​ - ​%d: The day of the month [01,31] +    ​*  ​%d: The day of the month [01,31] 
-  ​ - ​%H: The hour (24-hour clock) [00,23] +    ​*  ​%H: The hour (24-hour clock) [00,23] 
-  ​ - ​%M: The minute [00,59] +    ​*  ​%M: The minute [00,59] 
-  ​ - ​%S: The second [00,59]+    ​*  ​%S: The second [00,59]
  
 ==sound== ==sound==
  
   * ''​path''​ - type: PATH.   * ''​path''​ - type: PATH.
-  - Path to the sound file.  Only .wav files are currently supported.+    *  ​Path to the sound file.  Only .wav files are currently supported.
  
 ==helpsystem== ==helpsystem==
Line 846: Line 846:
   * ''​pos''​ - type: NORMALIZED_PAIR. ​ Default is "0.012 0.9515"​   * ''​pos''​ - type: NORMALIZED_PAIR. ​ Default is "0.012 0.9515"​
   * ''​origin''​ - type: NORMALIZED_PAIR.   * ''​origin''​ - type: NORMALIZED_PAIR.
-  - 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.+    *  ​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.
   * ''​textColor''​ - type: COLOR. ​ Default is 777777FF.   * ''​textColor''​ - type: COLOR. ​ Default is 777777FF.
   * ''​iconColor''​ - type: COLOR. ​ Default is 777777FF.   * ''​iconColor''​ - type: COLOR. ​ Default is 777777FF.
Line 855: Line 855:
  
   * ''​type''​ - type: STRING.   * ''​type''​ - type: STRING.
-  - Sets the scoll direction of the carousel. +    *  ​Sets the scoll direction of the carousel. 
-  ​ - ​Accepted values are "​horizontal",​ "​vertical",​ "​horizontal_wheel"​ or "​vertical_wheel"​. +    ​*  ​Accepted values are "​horizontal",​ "​vertical",​ "​horizontal_wheel"​ or "​vertical_wheel"​. 
-  ​ - ​Default is "​horizontal"​.+    ​*  ​Default is "​horizontal"​.
   * ''​size''​ - type: NORMALIZED_PAIR. Default is "1 0.2325"​   * ''​size''​ - type: NORMALIZED_PAIR. Default is "1 0.2325"​
   * ''​pos''​ - type: NORMALIZED_PAIR. ​ Default is "0 0.38375"​.   * ''​pos''​ - type: NORMALIZED_PAIR. ​ Default is "0 0.38375"​.
   * ''​origin''​ - type: NORMALIZED_PAIR.   * ''​origin''​ - type: NORMALIZED_PAIR.
-  - Where on the carousel ''​pos''​ refers to.  For example, an origin of ''​0.5 0.5''​ and a ''​pos''​ of ''​0.5 0.5''​ would place the carousel exactly in the middle of the screen. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.+    *  ​Where on the carousel ''​pos''​ refers to.  For example, an origin of ''​0.5 0.5''​ and a ''​pos''​ of ''​0.5 0.5''​ would place the carousel exactly in the middle of the screen. ​ If the "​POSITION"​ and "​SIZE"​ attributes are themable, "​ORIGIN"​ is implied.
   * ''​color''​ - type: COLOR.   * ''​color''​ - type: COLOR.
-  - Controls the color of the carousel background. +    *  ​Controls the color of the carousel background. 
-  ​ - ​Default is FFFFFFD8+    ​*  ​Default is FFFFFFD8
   * ''​colorEnd''​ - type: COLOR.   * ''​colorEnd''​ - type: COLOR.
-  - NEW : Color for the end of gradient+    *  ​NEW : Color for the end of gradient
   * ''​gradientType''​ - type: STRING.   * ''​gradientType''​ - type: STRING.
-  - NEW : Sets the gradient direction. Accepted values are "​horizontal"​ and "​vertical"​.+    *  ​NEW : Sets the gradient direction. Accepted values are "​horizontal"​ and "​vertical"​.
   * ''​logoSize''​ - type: NORMALIZED_PAIR. ​ Default is "0.25 0.155"   * ''​logoSize''​ - type: NORMALIZED_PAIR. ​ Default is "0.25 0.155"
   * ''​logoScale''​ - type: FLOAT.   * ''​logoScale''​ - type: FLOAT.
-  - Selected logo is increased in size by this scale +    *  ​Selected logo is increased in size by this scale 
-  ​ - ​Default is 1.2+    ​*  ​Default is 1.2
   * ''​logoRotation''​ - type: FLOAT.   * ''​logoRotation''​ - type: FLOAT.
-  - Angle in degrees that the logos should be rotated. ​ Value should be positive. +    *  ​Angle in degrees that the logos should be rotated. ​ Value should be positive. 
-  ​ - ​Default is 7.5 +    ​*  ​Default is 7.5 
-  ​ - ​This property only applies when ''​type''​ is "​horizontal_wheel"​ or "​vertical_wheel"​.+    ​*  ​This property only applies when ''​type''​ is "​horizontal_wheel"​ or "​vertical_wheel"​.
   * ''​logoRotationOrigin''​ - type: NORMALIZED_PAIR.   * ''​logoRotationOrigin''​ - type: NORMALIZED_PAIR.
-  - Point around which the logos will be rotated. Defaults to ''​-5 0.5''​. +    *  ​Point around which the logos will be rotated. Defaults to ''​-5 0.5''​. 
-  ​ - ​This property only applies when ''​type''​ is "​horizontal_wheel"​ or "​vertical_wheel"​.+    ​*  ​This property only applies when ''​type''​ is "​horizontal_wheel"​ or "​vertical_wheel"​.
   * ''​logoAlignment''​ - type: STRING.   * ''​logoAlignment''​ - type: STRING.
-  - Sets the alignment of the logos relative to the carousel. +    * Sets the alignment of the logos relative to the carousel. 
-  ​ - ​Accepted values are "​top",​ "​bottom"​ or "​center"​ when ''​type''​ is "​horizontal"​ or "​horizontal_wheel"​. +    ​*  ​Accepted values are "​top",​ "​bottom"​ or "​center"​ when ''​type''​ is "​horizontal"​ or "​horizontal_wheel"​. 
-  ​ - ​Accepted values are "​left",​ "​right"​ or "​center"​ when ''​type''​ is "​vertical"​ or "​vertical_wheel"​. +    ​*  ​Accepted values are "​left",​ "​right"​ or "​center"​ when ''​type''​ is "​vertical"​ or "​vertical_wheel"​. 
-  ​ - ​Default is "​center"​+    ​*  ​Default is "​center"​
   * ''​maxLogoCount''​ - type: FLOAT.   * ''​maxLogoCount''​ - type: FLOAT.
-  - Sets the number of logos to display in the carousel. +    *  ​Sets the number of logos to display in the carousel. 
-  ​ - ​Default is 3+    ​*  ​Default is 3
   * ''​zIndex''​ - type: FLOAT.   * ''​zIndex''​ - type: FLOAT.
-  - z-index value for component. ​ Components will be rendered in order of z-index value from low to high.+    *  ​z-index value for component. ​ Components will be rendered in order of z-index value from low to high.
   * ''​logoPos''​ - type: NORMALIZED_PAIR.   * ''​logoPos''​ - type: NORMALIZED_PAIR.
-  - NEW : Set the logo position if it is not centered.+    *  ​NEW : Set the logo position if it is not centered.
  
 ==menuText & menuTextSmall== ==menuText & menuTextSmall==
  
   * ''​color''​ - type: COLOR.   * ''​color''​ - type: COLOR.
-  - Default is 777777FF+    *  ​Default is 777777FF
   * ''​fontPath''​ - type: PATH.   * ''​fontPath''​ - type: PATH.
-  - Path to a truetype font (.ttf).+    *  ​Path to a truetype font (.ttf).
   * ''​fontSize''​ - type: FLOAT.   * ''​fontSize''​ - type: FLOAT.
-  - Size of the font as a percentage of screen height (e.g. for a value of ''​0.1'',​ the text's height would be 10% of the screen height). Default is 0.085 for menutitle, 0.045 for menutext and 0.035 for menufooter and menutextsmall.+    *  ​Size of the font as a percentage of screen height (e.g. for a value of ''​0.1'',​ the text's height would be 10% of the screen height). Default is 0.085 for menutitle, 0.045 for menutext and 0.035 for menufooter and menutextsmall.
   * ''​separatorColor''​ - type: COLOR.   * ''​separatorColor''​ - type: COLOR.
-  - Default is C6C7C6FF. Color of lines that separates menu entries.+    *  ​Default is C6C7C6FF. Color of lines that separates menu entries.
   * ''​selectedColor''​ - type: COLOR.   * ''​selectedColor''​ - type: COLOR.
-  - Default is FFFFFFFF. Color of text for selected menu entry.+    *  ​Default is FFFFFFFF. Color of text for selected menu entry.
   * ''​selectorColor''​ - type: COLOR.   * ''​selectorColor''​ - type: COLOR.
-  - Default is 878787FF. Color of the selector bar.+    *  ​Default is 878787FF. Color of the selector bar.
   * ''​selectorColorEnd''​ - type: NORMALIZED_PAIR.   * ''​selectorColorEnd''​ - type: NORMALIZED_PAIR.
-      - NEW : Bottom color for the gradient of the "​selector bar."+    *  ​NEW : Bottom color for the gradient of the "​selector bar."
  
 The help system is a special element that displays a context-sensitive list of actions the user can take at any time.  You should try and keep the position constant throughout every screen. ​ Keep in mind the "​default"​ settings (including position) are used whenever the user opens a menu. The help system is a special element that displays a context-sensitive list of actions the user can take at any time.  You should try and keep the position constant throughout every screen. ​ Keep in mind the "​default"​ settings (including position) are used whenever the user opens a menu.
  
-[*Check out the "​official"​ themes for some more examples!*](http://​aloshi.com/​emulationstation#​themes) 
  
-===Source===+===Sources===
 https://​github.com/​fabricecaruso/​EmulationStation/​blob/​master/​THEMES.md https://​github.com/​fabricecaruso/​EmulationStation/​blob/​master/​THEMES.md
 +
 +[*Check out the "​official"​ themes for some more examples!*](http://​aloshi.com/​emulationstation#​themes)
  
en/write_themes_for_emulationstation.txt · Last modified: 2019/09/23 17:09 by lbrpdx