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
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
|
// Copyright (c) 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.
#ifndef ASH_DISPLAY_DISPLAY_INFO_H_
#define ASH_DISPLAY_DISPLAY_INFO_H_
#include <string>
#include <vector>
#include "ash/ash_export.h"
#include "ui/gfx/display.h"
#include "ui/gfx/insets.h"
#include "ui/gfx/rect.h"
namespace ash {
namespace internal {
// A struct that represents the display's mode info.
struct ASH_EXPORT DisplayMode {
DisplayMode();
DisplayMode(const gfx::Size& size,
float refresh_rate,
bool interlaced,
bool native);
gfx::Size size; // Physical pixel size of the display.
float refresh_rate; // Refresh rate of the display, in Hz.
bool interlaced; // True if mode is interlaced.
bool native; // True if mode is native mode of the display.
};
// DisplayInfo contains metadata for each display. This is used to
// create |gfx::Display| as well as to maintain extra infomation
// to manage displays in ash environment.
// This class is intentionally made copiable.
class ASH_EXPORT DisplayInfo {
public:
// Creates a DisplayInfo from string spec. 100+200-1440x800 creates display
// whose size is 1440x800 at the location (100, 200) in host coordinates.
// The format is
//
// [origin-]widthxheight[*device_scale_factor][#resolutions list]
// [/<properties>][@ui-scale]
//
// where [] are optional:
// - |origin| is given in x+y- format.
// - |device_scale_factor| is either 2 or 1 (or empty).
// - properties can combination of 'o', which adds default overscan insets
// (5%), and one rotation property where 'r' is 90 degree clock-wise
// (to the 'r'ight) 'u' is 180 degrees ('u'pside-down) and 'l' is
// 270 degrees (to the 'l'eft).
// - ui-scale is floating value, e.g. @1.5 or @1.25.
// - |resolution list| is the list of size that is given in
// |width x height [% refresh_rate]| separated by '|'.
//
// A couple of examples:
// "100x100"
// 100x100 window at 0,0 origin. 1x device scale factor. no overscan.
// no rotation. 1.0 ui scale.
// "5+5-300x200*2"
// 300x200 window at 5,5 origin. 2x device scale factor.
// no overscan, no rotation. 1.0 ui scale.
// "300x200/ol"
// 300x200 window at 0,0 origin. 1x device scale factor.
// with 5% overscan. rotated to left (90 degree counter clockwise).
// 1.0 ui scale.
// "10+20-300x200/u@1.5"
// 300x200 window at 10,20 origin. 1x device scale factor.
// no overscan. flipped upside-down (180 degree) and 1.5 ui scale.
// "200x100#300x200|200x100%59.0|100x100%60"
// 200x100 window at 0,0 origin, with 3 possible resolutions,
// 300x200, 200x100 at 59 Hz, and 100x100 at 60 Hz.
static DisplayInfo CreateFromSpec(const std::string& spec);
// Creates a DisplayInfo from string spec using given |id|.
static DisplayInfo CreateFromSpecWithID(const std::string& spec,
int64 id);
DisplayInfo();
DisplayInfo(int64 id, const std::string& name, bool has_overscan);
~DisplayInfo();
int64 id() const { return id_; }
// The name of the display.
const std::string& name() const { return name_; }
// True if the display EDID has the overscan flag. This does not create the
// actual overscan automatically, but used in the message.
bool has_overscan() const { return has_overscan_; }
void set_rotation(gfx::Display::Rotation rotation) { rotation_ = rotation; }
gfx::Display::Rotation rotation() const { return rotation_; }
void set_touch_support(gfx::Display::TouchSupport support) {
touch_support_ = support;
}
gfx::Display::TouchSupport touch_support() const { return touch_support_; }
// Gets/Sets the device scale factor of the display.
float device_scale_factor() const { return device_scale_factor_; }
void set_device_scale_factor(float scale) { device_scale_factor_ = scale; }
// The native bounds for the display. The size of this can be
// different from the |size_in_pixel| when overscan insets are set
// and/or |configured_ui_scale_| is set.
const gfx::Rect& bounds_in_native() const {
return bounds_in_native_;
}
// The size for the display in pixels.
const gfx::Size& size_in_pixel() const { return size_in_pixel_; }
// The overscan insets for the display in DIP.
const gfx::Insets& overscan_insets_in_dip() const {
return overscan_insets_in_dip_;
}
// Sets/gets configured ui scale. This can be different from the ui
// scale actually used when the scale is 2.0 and DSF is 2.0.
// (the effective ui scale is 1.0 in this case).
float configured_ui_scale() const { return configured_ui_scale_; }
void set_configured_ui_scale(float scale) { configured_ui_scale_ = scale; }
// Returns the ui scale used for the device scale factor. This
// return 1.0f if the ui scale and dsf are both set to 2.0.
float GetEffectiveUIScale() const;
// Copy the display info except for fields that can be modified by a
// user (|rotation_| and |configured_ui_scale_|). |rotation_| and
// |configured_ui_scale_| are copied when the |another_info| isn't native one.
void Copy(const DisplayInfo& another_info);
// Update the |bounds_in_native_| and |size_in_pixel_| using
// given |bounds_in_native|.
void SetBounds(const gfx::Rect& bounds_in_native);
// Update the |bounds_in_native| according to the current overscan
// and rotation settings.
void UpdateDisplaySize();
// Sets/Clears the overscan insets.
void SetOverscanInsets(const gfx::Insets& insets_in_dip);
gfx::Insets GetOverscanInsetsInPixel() const;
void set_native(bool native) { native_ = native; }
bool native() const { return native_; }
const std::vector<DisplayMode>& display_modes() const {
return display_modes_;
}
void set_display_modes(std::vector<DisplayMode>& display_modes) {
display_modes_.swap(display_modes);
}
// Returns a string representation of the DisplayInfo, excluding display
// modes.
std::string ToString() const;
// Returns a string representation of the DisplayInfo, including display
// modes.
std::string ToFullString() const;
private:
int64 id_;
std::string name_;
bool has_overscan_;
gfx::Display::Rotation rotation_;
gfx::Display::TouchSupport touch_support_;
// This specifies the device's pixel density. (For example, a
// display whose DPI is higher than the threshold is considered to have
// device_scale_factor = 2.0 on Chrome OS). This is used by the
// grapics layer to choose and draw appropriate images and scale
// layers properly.
float device_scale_factor_;
gfx::Rect bounds_in_native_;
// The size of the display in use. The size can be different from the size
// of |bounds_in_native_| if the display has overscan insets and/or rotation.
gfx::Size size_in_pixel_;
gfx::Insets overscan_insets_in_dip_;
// The pixel scale of the display. This is used to simply expand (or
// shrink) the desktop over the native display resolution (useful in
// HighDPI display). Note that this should not be confused with the
// device scale factor, which specifies the pixel density of the
// display. The actuall scale value to be used depends on the device
// scale factor. See |GetEffectiveScaleFactor()|.
float configured_ui_scale_;
// True if this comes from native platform (DisplayChangeObserver).
bool native_;
// The list of modes supported by this display.
std::vector<DisplayMode> display_modes_;
};
} // namespace internal
} // namespace ash
#endif // ASH_DISPLAY_DISPLAY_INFO_H_
|
