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
|
/*
* Copyright (C) 2022 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.hardware.pixel.display;
import com.google.hardware.pixel.display.HistogramErrorCode;
import com.google.hardware.pixel.display.HbmState;
import com.google.hardware.pixel.display.LbeState;
import com.google.hardware.pixel.display.Weight;
import com.google.hardware.pixel.display.HistogramPos;
import com.google.hardware.pixel.display.PanelCalibrationStatus;
import com.google.hardware.pixel.display.Priority;
import android.hardware.common.NativeHandle;
import android.hardware.graphics.common.Rect;
@VintfStability
interface IDisplay {
/**
* Query Display High Brightness Mode Supported
*
* @return true if HBM is supported on this platform.
* If false, HBM is not supported.
*/
boolean isHbmSupported();
/**
* Set Display High Brightness Mode
*
* @param state to be queried.
*/
void setHbmState(in HbmState state);
/**
* Get Display High Brightness Mode State
*
* @return state of display high brightness mode
*/
HbmState getHbmState();
/**
* Query Display Local Brightness Enhancement Supported
*
* @return true if LBE is supported on this platform.
* If false, LBE is not supported.
*/
boolean isLbeSupported();
/**
* Set Display Local Brightness Enhancement
*
* @param state to be queried.
*/
void setLbeState(in LbeState state);
/**
* Set Display Local Brightness Enhancement Ambient Light
*
* @param ambientLux the proper ambient light in Lux.
* The value is equal to zero or above zero.
*/
void setLbeAmbientLight(in int ambientLux);
/**
* Get Display Local Brightness Enhancement State
*
* @return state of display local brightness enhancement
*/
LbeState getLbeState();
/**
* Query Display Local High Brightness Mode Supported
*
* @return true if LHBM is supported on this platform.
* If false, LHBM is not supported.
*/
boolean isLhbmSupported();
/**
* Set Display Local High Brightness Mode
*
* @param enabled true if LHBM should be enabled, false otherwise.
*/
void setLhbmState(in boolean enabled);
/**
* Get Display Local High Brightness Mode State
*
* @return true if LHBM is ON, false otherwise.
*/
boolean getLhbmState();
/**
* Set NativeHandle then server can fill the compensation
* image into the native handle
*
* @param native_handle share the NativeHandle from client.
* @param imageName the image name that define in client.
* @return errno of setCompensationImageHandle
*/
int setCompensationImageHandle(in NativeHandle native_handle, in String imageName);
/**
* Limit minimum idle display refresh rate. This is only relevant for displays
* that can idle to a lower refresh rate than what is set by the platform. That is,
* this API only controls kernel driver or panel self-driven refresh rate updates
* it does not enforce the platform selected refresh rate (via setActiveConfig).
*
* @param fps The lowest refresh rate allowed. Setting to -1 means display
* should not switch to lower refresh rate while idle.
* @return errno if there was a problem with the request, zero if successful
*/
int setMinIdleRefreshRate(in int fps);
/**
* Throttle refresh rate switching such that switches don't happen earlier
* than the provided delay in milliseconds
*
* @param delayMs Amount of time in milliseconds to wait before switching to
* a new refresh rate
* @return errno if there was a problem with the request, zero if successful
*/
int setRefreshRateThrottle(in int delayMs);
/**
* Collects the luma histograms of the content displayed on screen.
*
*
* @param roi input from client, is the regions of interest in the frames that
* should be sampled to collect the luma values of the roi
* The sample represents the most-recently posted frames
* @param weight input from client, the weights for red(weight_r), green(weight_g)
* and blue(weight_b) colors, which is used in luma calculation formula.
* The formula:
* luma = weight_r * red + weight_g * green + weight_b * blue
* The weight_r + weight_g + weight_b = 1024
* @param pos histogram sample position, could be PRE_DQE or POST_DQE
* @param priority input from client, is the priority of the call.
* Priority is a num with two values {normal, priority}
* @param histogrambuffer output from histogram server, is a 256 * 16 bits buffer to store the
* luma counts return by the histogram hardware
* @return error NONE = 0 upon success. Otherwise
* BAD_ROI = 1 when roi passed in is not in correct format
* BAD_WEIGHT = 2 when weight passed in is not in correct format
* BAD_POSITION = 3 when the histogram sampling position is incorrect
* BAD_PRIORITY = 4 when the priority input is not in correct format
* ENABLE_HIST_ERROR = 5 when enable histgoram property error
* DISABLE_HIST_ERROR = 6 when disable histgoram property error
* BAD_HIST_DATA = 7 when there is error to collect histogram data
* DRM_PLAYING = 8 when there is DRM content playing,
* for content protection, no histogram data sampled
* DISPLAY_POWEROFF = 9 when the display is power off,
* no histogram data is sampled
*/
HistogramErrorCode histogramSample(in Rect roi, in Weight weight, in HistogramPos pos,
in Priority pri, out char[] histogrambuffer);
/**
* Get the panel calibration status.
*
* @return status of panel calibration.
*/
PanelCalibrationStatus getPanelCalibrationStatus();
/**
* Query Dim Brightness Mode Supported. The dim brightness is a lower minimum brightness,
* which is not listed in the brightness table. This API is to query whether the dim
* brightness mode is supported or not.
*
* @return true if Dim Brightness Mode is supported on this platform, false otherwise.
*/
boolean isDbmSupported();
/**
* Set Dim Brightness Mode. If enabled, it will set the dim brightness when reaching the
* minimum brightness which can be different from the actual minimum brightness from the
* brightness table we can achieve.
*
* @param enabled true to enable, false to disable the mode.
*/
void setDbmState(in boolean enabled);
}
|
