Mover Control

Table of Contents

• Example
• Available tags
• Note on use of movingspeed tag
• Revision History
• See also

Used in the calibration screens.

The mover control is used for the screen calibration portions of Kodi. You can choose the size and look of the mover control.

---

Example

<control type="mover" id="3">
      <description>My first mover control</description>
      <posx>80</posx>
      <posy>60</posy>
      <width>250</width>
      <height>200</height>
      <texturefocus>mytexture.png</texturefocus>
      <texturenofocus>mytexture.png</texturenofocus>
      <pulseonselect>true</pulseonselect>
      <movingspeed acceleration="180" maxvelocity="300" resettimeout="200" delta="1">
            <eventconfig type="up">
            <eventconfig type="down">
            <eventconfig type="left" acceleration="100" maxvelocity="100" resettimeout="160" delta="1">
            <eventconfig type="right" acceleration="100" maxvelocity="100" resettimeout="160" delta="1">
      </movingspeed>
</control>

---

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
texturefocus	Specifies the image file which should be displayed when the mover has focus. See here for additional information about textures.
texturenofocus	Specifies the image file which should be displayed when the mover does not have focus.
movingspeed	Specifies the allowed directional movements and respective configurations. The <movingspeed> tag section can contain as many <eventconfig> tags as required.

---

Note on use of movingspeed tag

The movingspeed tag must be specified to allow the control to be moved via an input device such as keyboard. Each direction can be specified and configured to simulate the motion effect with the eventconfig tag.

The following attributes allow the motion effect of the control to be configured:

Attribute	Description
type	Specifies the direction of movement. Accepted values are: up, down, left, right. All directions are optional and do not have to be included.
acceleration	Specifies the acceleration in pixels per second (integer value).
maxvelocity	Specifies the maximum movement speed. This depends on the acceleration value, e.g. a suitable value could be (acceleration value)*3. Set to 0 to disable. (integer value).
resettimeout	Specifies the idle timeout before resetting the acceleration speed (in milliseconds, integer value).
delta	Specifies the minimal pixel increment step (integer value).

The attributes acceleration, maxvelocity, resettimeout, delta can be specified individually for each eventconfig tag, or globally in the movingspeed tag, or a mixture, as the following example:

<movingspeed acceleration="180" maxvelocity="300" resettimeout="200" delta="1">
    <eventconfig type="up">
    <eventconfig type="down">
    <eventconfig type="left" acceleration="100" maxvelocity="100" resettimeout="160">
    <eventconfig type="right" acceleration="100" maxvelocity="100" resettimeout="160">
</movingspeed>

---

Revision History

v20 Skinning engine changes

[movingspeed] New tag added.

---

See also

Development:

• Add-on development
• Skinning