summaryrefslogtreecommitdiffstats
path: root/ppapi/api/dev/ppb_gamepad_dev.idl
blob: 8e6a4a9263b85f362f43b406e37a297c183abdc2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
/* Copyright (c) 2012 The Chromium Authors. All rights reserved.
 * Use of this source code is governed by a BSD-style license that can be
 * found in the LICENSE file.
 */

/**
 * This file defines the <code>PPB_Gamepad_Dev</code> interface, which
 * provides access to gamepad devices.
 */

label Chrome {
  M18 = 0.1
};

#inline c
#pragma pack(push, 1)
#endinl

/**
 * The data for one gamepad device.
 */
struct PP_GamepadData_Dev {
    /**
     * Is there a gamepad connected at this index? If this is false, no other
     * data in this structure is valid.
     */
    char connected;

    /**
     * String identifier for the type of device/manufacturer.
     */
    uint16_t[128] id;

    /**
     * Monotonically increasing value that is incremented when the data have
     * been updated.
     */
    uint64_t timestamp;

    /**
     * Number of valid elements in the |axes| array.
     */
    uint32_t axes_length;

    /**
     * Normalized values for the axes, indices valid up to |axesLength|-1. Axis
     * values range from -1..1, and are in order of "importance".
     */
    float_t[16] axes;

    /**
     * Number of valid elements in the |buttons| array.
     */
    uint32_t buttons_length;

    /**
     * Normalized values for the buttons, indices valid up to |buttonsLength|
     * - 1. Button values range from 0..1, and are in order of importance.
     */
    float_t[32] buttons;
};

/**
 * The data for all gamepads connected to the system.
 */
struct PP_GamepadsData_Dev {
    /**
     * Number of valid elements in the |items| array.
     */
    uint32_t length;

    /**
     * Data for an individual gamepad device connected to the system.
     */
    PP_GamepadData_Dev[4] items;
};

#inline c
#pragma pack(pop)
#endinl

/**
 * The <code>PPB_Gamepad_Dev</code> interface allows retrieving data from
 * gamepad/joystick devices that are connected to the system.
 */
[version=0.1, macro="PPB_GAMEPAD_DEV_INTERFACE"]
interface PPB_Gamepad_Dev {
  /**
   * Samples the current state of the connected gamepads.
   */
  void SampleGamepads(
      [in] PP_Instance instance,
      [out] PP_GamepadsData_Dev data);

};