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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
// Copyright 2013 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.
// Use the <code>system.display</code> API to query display metadata.
namespace system.display {
dictionary Bounds {
// The x-coordinate of the upper-left corner.
long left;
// The y-coordinate of the upper-left corner.
long top;
// The width of the display in pixels.
long width;
// The height of the display in pixels.
long height;
};
dictionary Insets {
// The x-axis distance from the left bound.
long left;
// The y-axis distance from the top bound.
long top;
// The x-axis distance from the right bound.
long right;
// The y-axis distance from the bottom bound.
long bottom;
};
dictionary DisplayUnitInfo {
// The unique identifier of the display.
DOMString id;
// The user-friendly name (e.g. "HP LCD monitor").
DOMString name;
// Identifier of the display that is being mirrored on the display unit.
// If mirroring is not in progress, set to an empty string.
// Currently exposed only on ChromeOS. Will be empty string on other
// platforms.
DOMString mirroringSourceId;
// True if this is the primary display.
boolean isPrimary;
// True if this is an internal display.
boolean isInternal;
// True if this display is enabled.
boolean isEnabled;
// The number of pixels per inch along the x-axis.
double dpiX;
// The number of pixels per inch along the y-axis.
double dpiY;
// The display's clockwise rotation in degrees relative to the vertical
// position.
// Currently exposed only on ChromeOS. Will be set to 0 on other platforms.
long rotation;
// The display's logical bounds.
Bounds bounds;
// The display's insets within its screen's bounds.
// Currently exposed only on ChromeOS. Will be set to empty insets on
// other platforms.
Insets overscan;
// The usable work area of the display within the display bounds. The work
// area excludes areas of the display reserved for OS, for example taskbar
// and launcher.
Bounds workArea;
};
dictionary DisplayProperties {
// If set and not empty, starts mirroring between this and the display with
// the provided id (the system will determine which of the displays is
// actually mirrored).
// If set and not empty, stops mirroring between this and the display with
// the specified id (if mirroring is in progress).
// If set, no other parameter may be set.
DOMString? mirroringSourceId;
// If set to true, makes the display primary. No-op if set to false.
boolean? isPrimary;
// If set, sets the display's overscan insets to the provided values. Note
// that overscan values may not be negative or larger than a half of the
// screen's size. Overscan cannot be changed on the internal monitor.
// It's applied after <code>isPrimary</code> parameter.
Insets? overscan;
// If set, updates the display's rotation.
// Legal values are [0, 90, 180, 270]. The rotation is set clockwise,
// relative to the display's vertical position.
// It's applied after <code>overscan</code> paramter.
long? rotation;
// If set, updates the display's logical bounds origin along x-axis. Applied
// together with <code>boundsOriginY</code>, if <code>boundsOriginY</code>
// is set. Note that, when updating the display origin, some constraints
// will be applied, so the final bounds origin may be different than the one
// set. The final bounds can be retrieved using $(ref:getInfo).
// The bounds origin is applied after <code>rotation</code>.
// The bounds origin cannot be changed on the primary display. Note that is
// also invalid to set bounds origin values if <code>isPrimary</code> is
// also set (as <code>isPrimary</code> parameter is applied first).
long? boundsOriginX;
// If set, updates the display's logical bounds origin along y-axis.
// See documentation for <code>boundsOriginX</code> parameter.
long? boundsOriginY;
};
callback DisplayInfoCallback = void (DisplayUnitInfo[] displayInfo);
callback SetDisplayUnitInfoCallback = void();
interface Functions {
// Get the information of all attached display devices.
static void getInfo(DisplayInfoCallback callback);
// Updates the properties for the display specified by |id|, according to
// the information provided in |info|. On failure, $(ref:runtime.lastError)
// will be set.
// |id|: The display's unique identifier.
// |info|: The information about display properties that should be changed.
// A property will be changed only if a new value for it is specified in
// |info|.
// |callback|: Empty function called when the function finishes. To find out
// whether the function succeeded, $(ref:runtime.lastError) should be
// queried.
static void setDisplayProperties(
DOMString id,
DisplayProperties info,
optional SetDisplayUnitInfoCallback callback);
// Enables/disables the unified desktop feature. Note that this simply
// enables the feature, but will not change the actual desktop mode.
// (That is, if the desktop is in mirror mode, it will stay in mirror mode)
static void enableUnifiedDesktop(boolean enabled);
};
interface Events {
// Fired when anything changes to the display configuration.
static void onDisplayChanged();
};
};
|
