Game Control - Revision history

Hitcher: /* Available tags */

2026-06-22T19:04:30Z

Available tags

← Older revision		Revision as of 19:04, 22 June 2026
Line 18:		Line 18:
	</syntaxhighlight>		</syntaxhighlight>
	=== Available tags ===		=== Available tags ===
	In addition to the [[~~Default_control_tags~~]] the following tags are available. Note that each tag is '''lower case''' only. This is important, as xml tags are case-sensitive.		In addition to the '''[[Default Control Tags]]''' the following tags are available. Note that each tag is '''lower case''' only. This is important, as xml tags are case-sensitive.
	{\| class="prettytable"		{\| class="prettytable"
	! Tag !! Description		! Tag !! Description
Line 34:		Line 34:
	\| A path to a v20 savestate, whose pixels will be rendered instead of the active game. A value of - will disable rendering of any pixels.		\| A path to a v20 savestate, whose pixels will be rendered instead of the active game. A value of - will disable rendering of any pixels.
	\|}		\|}

	=== List item info ===		=== List item info ===
	List item info can be used for all tag values. For example, if the control definition looks like:		List item info can be used for all tag values. For example, if the control definition looks like:

Hitcher at 15:33, 22 June 2026

2026-06-22T15:33:19Z

← Older revision		Revision as of 15:33, 22 June 2026
Line 1:		Line 1:
	~~__NOTOC__~~<section begin="main content" />		{{mininav\| [[Skinning]] \| [[Controls\|Available controls]] }}
			<section begin="main content" />
	'''Used to display the currently playing game, with optional effects, while playing a game.'''		'''Used to display the currently playing game, with optional effects, while playing a game.'''

Hitcher at 15:27, 22 June 2026

2026-06-22T15:27:07Z

← Older revision		Revision as of 15:27, 22 June 2026
Line 1:		Line 1:
	__NOTOC__		__NOTOC__<section begin="main content" />
	<section begin="main content" />
	'''Used to display the currently playing game, with optional effects, while playing a game.'''		'''Used to display the currently playing game, with optional effects, while playing a game.'''

Hitcher at 15:26, 22 June 2026

2026-06-22T15:26:47Z

← Older revision		Revision as of 15:26, 22 June 2026
Line 1:		Line 1:
			__NOTOC__
	<section begin="main content" />		<section begin="main content" />
	'''Used to display the currently playing game, with optional effects, while playing a game.'''		'''Used to display the currently playing game, with optional effects, while playing a game.'''

Hitcher: Created page with "
'''Used to display the currently playing game, with optional effects, while playing a game.''' The gamewindow control is used for displaying the currently playing game elsewhere in the Kodi GUI. You can choose the position, and size of the game displayed, as well as various effects. Note that the control is only rendered if game is being played. === Example === ..."

2026-06-22T15:24:46Z

Created page with "<section begin="main content" /> '''Used to display the currently playing game, with optional effects, while playing a game.''' The gamewindow control is used for displaying the currently playing game elsewhere in the Kodi GUI. You can choose the position, and size of the game displayed, as well as various effects. Note that the control is only rendered if game is being played. === Example === <syntaxhighlight lang="XML" enclose="div"> <control type="gamewindow" id="2">..."

New page

<section begin="main content" />
'''Used to display the currently playing game, with optional effects, while playing a game.'''

The gamewindow control is used for displaying the currently playing game elsewhere in the Kodi GUI. You can choose the position, and size of the game displayed, as well as various effects. Note that the control is only rendered if game is being played.
=== Example ===
<syntaxhighlight lang="XML" enclose="div">
<control type="gamewindow" id="2">
<description>My first game control</description>
<posx>80</posx>
<posy>60</posy>
<width>250</width>
<height>200</height>
<videofilter>nearest</videofilter>
<stretchmode>normal</stretchmode>
<rotation>0</rotation>
</control>
</syntaxhighlight>
=== Available tags ===
In addition to the [[Default_control_tags]] the following tags are available. Note that each tag is '''lower case''' only. This is important, as xml tags are case-sensitive.
{| class="prettytable"
! Tag !! Description
|-
| '''videofilter'''
| The filter to use, see [[InfoLabels#RetroPlayer|RetroPlayer.VideoFilter]] for supported values. If empty, the value of the [[InfoLabels#RetroPlayer|RetroPlayer.VideoFilter]] info label is used.
|-
| '''stretchmode'''
| The stretch mode, see [[InfoLabels#RetroPlayer|RetroPlayer.StretchMode]] for supported values. If empty, the value of the [[InfoLabels#RetroPlayer|RetroPlayer.StretchMode]] info label is used.
|-
| '''rotation'''
| The rotation, in degrees counter-clockwise, see [[InfoLabels#RetroPlayer|RetroPlayer.VideoRotation]] for supported values. If empty, the value of the [[InfoLabels#RetroPlayer|RetroPlayer.VideoRotation]] info label is used.
|-
| '''pixels'''
| A path to a v20 savestate, whose pixels will be rendered instead of the active game. A value of - will disable rendering of any pixels.
|}
=== List item info ===
List item info can be used for all tag values. For example, if the control definition looks like:
<syntaxhighlight lang="XML" enclose="div"><itemlayout width="444" height="250">
<control type="gamewindow">
<videofilter>$INFO[ListItem.Property(game.videofilter)]</videofilter>
<stretchmode>$INFO[ListItem.Property(game.stretchmode)]</stretchmode>
<rotation>$INFO[ListItem.Property(game.videorotation)]</rotation>
</control>
</itemlayout>
</syntaxhighlight>
Static list items can be provided. Each gamewindow will inherit the properties:
<syntaxhighlight lang="XML" enclose="div"><content>
<item>
<property name="game.videofilter">nearest</property>
<property name="game.stretchmode">normal</property>
<property name="game.videorotation">0</property>
</item>
</content>
</syntaxhighlight>
The in-game dialogs with a gamewindow control (<code>GameVideoFilter</code>, <code>GameStretchMode</code>, <code>GameVideoRotation</code> and <code>InGameSaves)</code> use a similar strategy with list items populated by core.
<section end="main content" />
== See also ==
'''Development:'''
* [[Add-on development]]
* [[Skinning]]

[[Category:Skin development]]