Kodi Documentation 22.0
Kodi is an open source media player and entertainment hub.
No Matches
Game Control

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.


<control type="gamewindow" id="2">
<description>My first game control</description>
const char const uint8_t size_t unsigned int unsigned int * height
Definition kodi-dev-kit/include/kodi/c-api/addon-instance/imagedecoder.h:417
const char const uint8_t size_t unsigned int * width
Definition kodi-dev-kit/include/kodi/c-api/addon-instance/imagedecoder.h:416

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.

Tag Description
videofilter The filter to use, see RetroPlayer.VideoFilter for supported values. If empty, the value of the RetroPlayer.VideoFilter info label is used.
stretchmode The stretch mode, see RetroPlayer.StretchMode for supported values. If empty, the value of the RetroPlayer.StretchMode info label is used.
rotation The rotation, in degrees counter-clockwise, see RetroPlayer.VideoRotation for supported values. If empty, the value of the 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.
v20 Skinning engine changes
pixels New tag added for rendering savestate pixels. Requires savestate v3 schema, introduced with the Savestate Manager in v20.

List item info

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

<itemlayout width="444" height="250">
<control type="gamewindow">

Static list items can be provided. Each gamewindow will inherit the properties:

<property name="game.videofilter">nearest</property>
<property name="game.stretchmode">normal</property>
<property name="game.videorotation">0</property>
enum const char * name
Definition addon_base.h:203

The in-game dialogs with a gamewindow control (GameVideoFilter, GameStretchMode, GameVideoRotation and InGameSaves) use a similar strategy with list items populated by core.

See also