406 lines
16 KiB
Java
406 lines
16 KiB
Java
|
/*
|
||
|
|
* Copyright 2017 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 android.hardware.display;
|
||
|
|
|
||
|
|
import android.annotation.NonNull;
|
||
|
|
import android.annotation.Nullable;
|
||
|
|
import android.annotation.SystemApi;
|
||
|
|
import android.os.Parcel;
|
||
|
|
import android.os.Parcelable;
|
||
|
|
|
||
|
|
import java.util.Arrays;
|
||
|
|
import java.util.Objects;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Data about a brightness settings change.
|
||
|
|
*
|
||
|
|
* {@see DisplayManager.getBrightnessEvents()}
|
||
|
|
* @hide
|
||
|
|
*/
|
||
|
|
@SystemApi
|
||
|
|
public final class BrightnessChangeEvent implements Parcelable {
|
||
|
|
/** Brightness in nits */
|
||
|
|
public final float brightness;
|
||
|
|
|
||
|
|
/** Timestamp of the change {@see System.currentTimeMillis()} */
|
||
|
|
public final long timeStamp;
|
||
|
|
|
||
|
|
/** Package name of focused activity when brightness was changed.
|
||
|
|
* This will be null if the caller of {@see DisplayManager.getBrightnessEvents()}
|
||
|
|
* does not have access to usage stats {@see UsageStatsManager} */
|
||
|
|
public final String packageName;
|
||
|
|
|
||
|
|
/** User id of of the user running when brightness was changed.
|
||
|
|
* @hide */
|
||
|
|
public final int userId;
|
||
|
|
|
||
|
|
/** The unique id of the screen on which the brightness was changed */
|
||
|
|
@NonNull
|
||
|
|
public final String uniqueDisplayId;
|
||
|
|
|
||
|
|
/** Lux values of recent sensor data */
|
||
|
|
public final float[] luxValues;
|
||
|
|
|
||
|
|
/** Timestamps of the lux sensor readings {@see System.currentTimeMillis()} */
|
||
|
|
public final long[] luxTimestamps;
|
||
|
|
|
||
|
|
/** Most recent battery level when brightness was changed or Float.NaN */
|
||
|
|
public final float batteryLevel;
|
||
|
|
|
||
|
|
/** Factor applied to brightness due to battery level, 0.0-1.0 */
|
||
|
|
public final float powerBrightnessFactor;
|
||
|
|
|
||
|
|
/** Color filter active to provide night mode */
|
||
|
|
public final boolean nightMode;
|
||
|
|
|
||
|
|
/** If night mode color filter is active this will be the temperature in kelvin */
|
||
|
|
public final int colorTemperature;
|
||
|
|
|
||
|
|
/** Whether the bright color reduction color transform is active */
|
||
|
|
public final boolean reduceBrightColors;
|
||
|
|
|
||
|
|
/** How strong the bright color reduction color transform is set (only applicable if active),
|
||
|
|
* specified as an integer from 0 - 100, inclusive. This value (scaled to 0-1, inclusive) is
|
||
|
|
* then used in Ynew = (a * scaledStrength^2 + b * scaledStrength + c) * Ycurrent, where a, b,
|
||
|
|
* and c are coefficients provided in the bright color reduction coefficient matrix, and
|
||
|
|
* Ycurrent is the current hardware brightness in nits.
|
||
|
|
*/
|
||
|
|
public final int reduceBrightColorsStrength;
|
||
|
|
|
||
|
|
/** Applied offset for the bright color reduction color transform (only applicable if active).
|
||
|
|
* The offset is computed by summing the coefficients a, b, and c, from the coefficient matrix
|
||
|
|
* and multiplying by the current brightness.
|
||
|
|
*/
|
||
|
|
public final float reduceBrightColorsOffset;
|
||
|
|
|
||
|
|
/** Brightness level before slider adjustment */
|
||
|
|
public final float lastBrightness;
|
||
|
|
|
||
|
|
/** Whether brightness configuration is default version */
|
||
|
|
public final boolean isDefaultBrightnessConfig;
|
||
|
|
|
||
|
|
/** Whether brightness curve includes a user brightness point */
|
||
|
|
public final boolean isUserSetBrightness;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Histogram counting how many times a pixel of a given value was displayed onscreen for the
|
||
|
|
* Value component of HSV if the device supports color sampling, if the device does not support
|
||
|
|
* color sampling or {@link BrightnessConfiguration#shouldCollectColorSamples()} is false the
|
||
|
|
* value will be null.
|
||
|
|
*
|
||
|
|
* The buckets of the histogram are evenly weighted, the number of buckets is device specific.
|
||
|
|
* The units are in pixels * milliseconds, with 1 pixel millisecond being 1 pixel displayed
|
||
|
|
* for 1 millisecond.
|
||
|
|
* For example if we had {100, 50, 30, 20}, value component was onscreen for 100 pixel
|
||
|
|
* milliseconds in range 0x00->0x3F, 30 pixel milliseconds in range 0x40->0x7F, etc.
|
||
|
|
*
|
||
|
|
* {@see #colorSampleDuration}
|
||
|
|
*/
|
||
|
|
@Nullable
|
||
|
|
public final long[] colorValueBuckets;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* How many milliseconds of data are contained in the colorValueBuckets, if the device does
|
||
|
|
* not support color sampling or {@link BrightnessConfiguration#shouldCollectColorSamples()} is
|
||
|
|
* false the value will be 0L.
|
||
|
|
*
|
||
|
|
* {@see #colorValueBuckets}
|
||
|
|
*/
|
||
|
|
public final long colorSampleDuration;
|
||
|
|
|
||
|
|
|
||
|
|
/** @hide */
|
||
|
|
private BrightnessChangeEvent(float brightness, long timeStamp, String packageName,
|
||
|
|
int userId, String uniqueDisplayId, float[] luxValues, long[] luxTimestamps,
|
||
|
|
float batteryLevel, float powerBrightnessFactor, boolean nightMode,
|
||
|
|
int colorTemperature, boolean reduceBrightColors, int reduceBrightColorsStrength,
|
||
|
|
float reduceBrightColorsOffset, float lastBrightness, boolean isDefaultBrightnessConfig,
|
||
|
|
boolean isUserSetBrightness, long[] colorValueBuckets, long colorSampleDuration) {
|
||
|
|
this.brightness = brightness;
|
||
|
|
this.timeStamp = timeStamp;
|
||
|
|
this.packageName = packageName;
|
||
|
|
this.userId = userId;
|
||
|
|
this.uniqueDisplayId = uniqueDisplayId;
|
||
|
|
this.luxValues = luxValues;
|
||
|
|
this.luxTimestamps = luxTimestamps;
|
||
|
|
this.batteryLevel = batteryLevel;
|
||
|
|
this.powerBrightnessFactor = powerBrightnessFactor;
|
||
|
|
this.nightMode = nightMode;
|
||
|
|
this.colorTemperature = colorTemperature;
|
||
|
|
this.reduceBrightColors = reduceBrightColors;
|
||
|
|
this.reduceBrightColorsStrength = reduceBrightColorsStrength;
|
||
|
|
this.reduceBrightColorsOffset = reduceBrightColorsOffset;
|
||
|
|
this.lastBrightness = lastBrightness;
|
||
|
|
this.isDefaultBrightnessConfig = isDefaultBrightnessConfig;
|
||
|
|
this.isUserSetBrightness = isUserSetBrightness;
|
||
|
|
this.colorValueBuckets = colorValueBuckets;
|
||
|
|
this.colorSampleDuration = colorSampleDuration;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @hide */
|
||
|
|
public BrightnessChangeEvent(BrightnessChangeEvent other, boolean redactPackage) {
|
||
|
|
this.brightness = other.brightness;
|
||
|
|
this.timeStamp = other.timeStamp;
|
||
|
|
this.packageName = redactPackage ? null : other.packageName;
|
||
|
|
this.userId = other.userId;
|
||
|
|
this.uniqueDisplayId = other.uniqueDisplayId;
|
||
|
|
this.luxValues = other.luxValues;
|
||
|
|
this.luxTimestamps = other.luxTimestamps;
|
||
|
|
this.batteryLevel = other.batteryLevel;
|
||
|
|
this.powerBrightnessFactor = other.powerBrightnessFactor;
|
||
|
|
this.nightMode = other.nightMode;
|
||
|
|
this.colorTemperature = other.colorTemperature;
|
||
|
|
this.reduceBrightColors = other.reduceBrightColors;
|
||
|
|
this.reduceBrightColorsStrength = other.reduceBrightColorsStrength;
|
||
|
|
this.reduceBrightColorsOffset = other.reduceBrightColorsOffset;
|
||
|
|
this.lastBrightness = other.lastBrightness;
|
||
|
|
this.isDefaultBrightnessConfig = other.isDefaultBrightnessConfig;
|
||
|
|
this.isUserSetBrightness = other.isUserSetBrightness;
|
||
|
|
this.colorValueBuckets = other.colorValueBuckets;
|
||
|
|
this.colorSampleDuration = other.colorSampleDuration;
|
||
|
|
}
|
||
|
|
|
||
|
|
private BrightnessChangeEvent(Parcel source) {
|
||
|
|
brightness = source.readFloat();
|
||
|
|
timeStamp = source.readLong();
|
||
|
|
packageName = source.readString();
|
||
|
|
userId = source.readInt();
|
||
|
|
uniqueDisplayId = source.readString();
|
||
|
|
luxValues = source.createFloatArray();
|
||
|
|
luxTimestamps = source.createLongArray();
|
||
|
|
batteryLevel = source.readFloat();
|
||
|
|
powerBrightnessFactor = source.readFloat();
|
||
|
|
nightMode = source.readBoolean();
|
||
|
|
colorTemperature = source.readInt();
|
||
|
|
reduceBrightColors = source.readBoolean();
|
||
|
|
reduceBrightColorsStrength = source.readInt();
|
||
|
|
reduceBrightColorsOffset = source.readFloat();
|
||
|
|
lastBrightness = source.readFloat();
|
||
|
|
isDefaultBrightnessConfig = source.readBoolean();
|
||
|
|
isUserSetBrightness = source.readBoolean();
|
||
|
|
colorValueBuckets = source.createLongArray();
|
||
|
|
colorSampleDuration = source.readLong();
|
||
|
|
}
|
||
|
|
|
||
|
|
public static final @android.annotation.NonNull Creator<BrightnessChangeEvent> CREATOR =
|
||
|
|
new Creator<BrightnessChangeEvent>() {
|
||
|
|
public BrightnessChangeEvent createFromParcel(Parcel source) {
|
||
|
|
return new BrightnessChangeEvent(source);
|
||
|
|
}
|
||
|
|
public BrightnessChangeEvent[] newArray(int size) {
|
||
|
|
return new BrightnessChangeEvent[size];
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
@Override
|
||
|
|
public int describeContents() {
|
||
|
|
return 0;
|
||
|
|
}
|
||
|
|
|
||
|
|
@Override
|
||
|
|
public void writeToParcel(Parcel dest, int flags) {
|
||
|
|
dest.writeFloat(brightness);
|
||
|
|
dest.writeLong(timeStamp);
|
||
|
|
dest.writeString(packageName);
|
||
|
|
dest.writeInt(userId);
|
||
|
|
dest.writeString(uniqueDisplayId);
|
||
|
|
dest.writeFloatArray(luxValues);
|
||
|
|
dest.writeLongArray(luxTimestamps);
|
||
|
|
dest.writeFloat(batteryLevel);
|
||
|
|
dest.writeFloat(powerBrightnessFactor);
|
||
|
|
dest.writeBoolean(nightMode);
|
||
|
|
dest.writeInt(colorTemperature);
|
||
|
|
dest.writeBoolean(reduceBrightColors);
|
||
|
|
dest.writeInt(reduceBrightColorsStrength);
|
||
|
|
dest.writeFloat(reduceBrightColorsOffset);
|
||
|
|
dest.writeFloat(lastBrightness);
|
||
|
|
dest.writeBoolean(isDefaultBrightnessConfig);
|
||
|
|
dest.writeBoolean(isUserSetBrightness);
|
||
|
|
dest.writeLongArray(colorValueBuckets);
|
||
|
|
dest.writeLong(colorSampleDuration);
|
||
|
|
}
|
||
|
|
|
||
|
|
@Override
|
||
|
|
public String toString() {
|
||
|
|
return "BrightnessChangeEvent{"
|
||
|
|
+ "brightness: " + brightness
|
||
|
|
+ ", timeStamp: " + timeStamp
|
||
|
|
+ ", packageName: " + packageName
|
||
|
|
+ ", userId: " + userId
|
||
|
|
+ ", uniqueDisplayId: " + uniqueDisplayId
|
||
|
|
+ ", luxValues: " + Arrays.toString(luxValues)
|
||
|
|
+ ", luxTimestamps: " + Arrays.toString(luxTimestamps)
|
||
|
|
+ ", batteryLevel: " + batteryLevel
|
||
|
|
+ ", powerBrightnessFactor: " + powerBrightnessFactor
|
||
|
|
+ ", nightMode: " + nightMode
|
||
|
|
+ ", colorTemperature: " + colorTemperature
|
||
|
|
+ ", reduceBrightColors: " + reduceBrightColors
|
||
|
|
+ ", reduceBrightColorsStrength: " + reduceBrightColorsStrength
|
||
|
|
+ ", reduceBrightColorsOffset: " + reduceBrightColorsOffset
|
||
|
|
+ ", lastBrightness: " + lastBrightness
|
||
|
|
+ ", isDefaultBrightnessConfig: " + isDefaultBrightnessConfig
|
||
|
|
+ ", isUserSetBrightness: " + isUserSetBrightness
|
||
|
|
+ ", colorValueBuckets: " + Arrays.toString(colorValueBuckets)
|
||
|
|
+ ", colorSampleDuration: " + colorSampleDuration
|
||
|
|
+ "}";
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @hide */
|
||
|
|
public static class Builder {
|
||
|
|
private float mBrightness;
|
||
|
|
private long mTimeStamp;
|
||
|
|
private String mPackageName;
|
||
|
|
private int mUserId;
|
||
|
|
private String mUniqueDisplayId;
|
||
|
|
private float[] mLuxValues;
|
||
|
|
private long[] mLuxTimestamps;
|
||
|
|
private float mBatteryLevel;
|
||
|
|
private float mPowerBrightnessFactor;
|
||
|
|
private boolean mNightMode;
|
||
|
|
private int mColorTemperature;
|
||
|
|
private boolean mReduceBrightColors;
|
||
|
|
private int mReduceBrightColorsStrength;
|
||
|
|
private float mReduceBrightColorsOffset;
|
||
|
|
private float mLastBrightness;
|
||
|
|
private boolean mIsDefaultBrightnessConfig;
|
||
|
|
private boolean mIsUserSetBrightness;
|
||
|
|
private long[] mColorValueBuckets;
|
||
|
|
private long mColorSampleDuration;
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#brightness} */
|
||
|
|
public Builder setBrightness(float brightness) {
|
||
|
|
mBrightness = brightness;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#timeStamp} */
|
||
|
|
public Builder setTimeStamp(long timeStamp) {
|
||
|
|
mTimeStamp = timeStamp;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#packageName} */
|
||
|
|
public Builder setPackageName(String packageName) {
|
||
|
|
mPackageName = packageName;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#userId} */
|
||
|
|
public Builder setUserId(int userId) {
|
||
|
|
mUserId = userId;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#uniqueScreenId} */
|
||
|
|
public Builder setUniqueDisplayId(String uniqueId) {
|
||
|
|
mUniqueDisplayId = uniqueId;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#luxValues} */
|
||
|
|
public Builder setLuxValues(float[] luxValues) {
|
||
|
|
mLuxValues = luxValues;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#luxTimestamps} */
|
||
|
|
public Builder setLuxTimestamps(long[] luxTimestamps) {
|
||
|
|
mLuxTimestamps = luxTimestamps;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#batteryLevel} */
|
||
|
|
public Builder setBatteryLevel(float batteryLevel) {
|
||
|
|
mBatteryLevel = batteryLevel;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#powerSaveBrightness} */
|
||
|
|
public Builder setPowerBrightnessFactor(float powerBrightnessFactor) {
|
||
|
|
mPowerBrightnessFactor = powerBrightnessFactor;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#nightMode} */
|
||
|
|
public Builder setNightMode(boolean nightMode) {
|
||
|
|
mNightMode = nightMode;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#colorTemperature} */
|
||
|
|
public Builder setColorTemperature(int colorTemperature) {
|
||
|
|
mColorTemperature = colorTemperature;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#reduceBrightColors} */
|
||
|
|
public Builder setReduceBrightColors(boolean reduceBrightColors) {
|
||
|
|
mReduceBrightColors = reduceBrightColors;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#reduceBrightColorsStrength} */
|
||
|
|
public Builder setReduceBrightColorsStrength(int strength) {
|
||
|
|
mReduceBrightColorsStrength = strength;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#reduceBrightColorsOffset} */
|
||
|
|
public Builder setReduceBrightColorsOffset(float offset) {
|
||
|
|
mReduceBrightColorsOffset = offset;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#lastBrightness} */
|
||
|
|
public Builder setLastBrightness(float lastBrightness) {
|
||
|
|
mLastBrightness = lastBrightness;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#isDefaultBrightnessConfig} */
|
||
|
|
public Builder setIsDefaultBrightnessConfig(boolean isDefaultBrightnessConfig) {
|
||
|
|
mIsDefaultBrightnessConfig = isDefaultBrightnessConfig;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#userBrightnessPoint} */
|
||
|
|
public Builder setUserBrightnessPoint(boolean isUserSetBrightness) {
|
||
|
|
mIsUserSetBrightness = isUserSetBrightness;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** {@see BrightnessChangeEvent#colorValueBuckets}
|
||
|
|
* {@see BrightnessChangeEvent#colorSampleDuration} */
|
||
|
|
public Builder setColorValues(@NonNull long[] colorValueBuckets, long colorSampleDuration) {
|
||
|
|
Objects.requireNonNull(colorValueBuckets);
|
||
|
|
mColorValueBuckets = colorValueBuckets;
|
||
|
|
mColorSampleDuration = colorSampleDuration;
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** Builds a BrightnessChangeEvent */
|
||
|
|
public BrightnessChangeEvent build() {
|
||
|
|
return new BrightnessChangeEvent(mBrightness, mTimeStamp,
|
||
|
|
mPackageName, mUserId, mUniqueDisplayId, mLuxValues, mLuxTimestamps,
|
||
|
|
mBatteryLevel, mPowerBrightnessFactor, mNightMode, mColorTemperature,
|
||
|
|
mReduceBrightColors, mReduceBrightColorsStrength, mReduceBrightColorsOffset,
|
||
|
|
mLastBrightness, mIsDefaultBrightnessConfig, mIsUserSetBrightness,
|
||
|
|
mColorValueBuckets, mColorSampleDuration);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|