程序包 ohos.agp.colors

类 HslColor

java.lang.Object

ohos.agp.colors.Color

ohos.agp.colors.HslColor

public class HslColor
extends Color

Manipulates Hue, Saturation, and Lightness (HSL) values to create HslColor objects.

Hue means the color, saturation means the purity of the color (with respect to grey), and lightness means the brightness of the color (with respect to black and white).

从以下版本开始:

1

构造器概要

构造器

构造器	说明
HslColor()	Default constructor used to create a HslColor instance.
HslColor(float hue, float saturation, float lightness)	A constructor that creates a HslColor instance by specifying HSL values.
HslColor(float hue, float saturation, float lightness, int alpha)	A constructor that creates a HslColor instance by specifying HSL values plus an alpha value.
HslColor(HslColor color)	Replicates an existing HslColor instance to create a new one.

方法概要

限定符和类型	方法	说明
HslColor	assign(HslColor color)	Replicates the attributes of an existing HslColor instance and assigns them to the current instance.
boolean	equals(Object other)	Indicates whether some other object is "equal to" this one.
float	getHue()	Obtains the hue of a color.
float	getLightness()	Obtains the lightness of a color.
float	getSaturation()	Obtains the saturation of a color.
int	hashCode()	Returns a hash code value for the object.
void	setHue(float hue)	Sets the hue of a color.
void	setLightness(float lightness)	Sets the lightness of a color.
void	setSaturation(float saturation)	Sets the saturation of a color.

从类继承的方法 ohos.agp.colors.Color

assign, getAlpha, getSpec, setAlpha

从类继承的方法 java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

HslColor

public HslColor()

Default constructor used to create a HslColor instance.

从以下版本开始:

1

HslColor

public HslColor(float hue,
                float saturation,
                float lightness)

A constructor that creates a HslColor instance by specifying HSL values.

参数:

hue - Indicates the color, for example, yellow. The value range for Hue is 0-360.

saturation - Indicates the saturation level, in the range 0-100, where 100 is fully saturated and 0 approaches gray.

lightness - Indicates lightness, in the range 0-100, where 0 is black and 100 is white.

从以下版本开始:

1

HslColor

public HslColor(float hue,
                float saturation,
                float lightness,
                int alpha)

A constructor that creates a HslColor instance by specifying HSL values plus an alpha value.

参数:

hue - Indicates the color, for example, yellow. The value range for Hue is 0-360.

saturation - Indicates the saturation level, in the range 0-100, where 100 is fully saturated and 0 approaches gray.

lightness - Indicates lightness, in the range 0-100, where 0 is black and 100 is white.

alpha - Indicates the alpha value, in the range 0-255, meaning the level of transparency of the color. The smaller the value, the more transparent the color.

从以下版本开始:

1

HslColor

public HslColor(HslColor color)

Replicates an existing HslColor instance to create a new one.

参数:

color - Indicates the existing HslColor instance to replicate.

从以下版本开始:

1

方法详细资料

assign

public HslColor assign(HslColor color)

Replicates the attributes of an existing HslColor instance and assigns them to the current instance.

参数:

color - Indicates the existing HslColor instance to replicate attributes from.

返回:

Returns the current HslColor instance that has been assigned new attributes.

从以下版本开始:

1

equals

public boolean equals(Object other)

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

• It is reflexive: for any non-null reference value x, x.equals(x) should return true.
• It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
• It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
• It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
• For any non-null reference value x, x.equals(null) should return false.

The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any non-null reference values x and y, this method returns true if and only if x and y refer to the same object (x == y has the value true).

Note that it is generally necessary to override the hashCode method whenever this method is overridden, so as to maintain the general contract for the hashCode method, which states that equal objects must have equal hash codes.

覆盖:

equals 在类中 Color

参数:

other - the reference object with which to compare.

返回:

true if this object is the same as the obj argument; false otherwise.

另请参阅:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.

The general contract of hashCode is:

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the Java™ programming language.)

覆盖:

hashCode 在类中 Color

返回:

a hash code value for this object.

另请参阅:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

setHue

public void setHue(float hue)

Sets the hue of a color.

参数:

hue - Indicates the hue value, in the range 0-360.

从以下版本开始:

1

getHue

public float getHue()

Obtains the hue of a color.

返回:

Returns the hue of the color, in the range 0-360.

从以下版本开始:

1

setSaturation

public void setSaturation(float saturation)

Sets the saturation of a color.

参数:

saturation - Indicates the saturation, in the range 0-100.

从以下版本开始:

1

getSaturation

public float getSaturation()

Obtains the saturation of a color.

返回:

Returns the saturation of the color.

从以下版本开始:

1

setLightness

public void setLightness(float lightness)

Sets the lightness of a color.

参数:

lightness - Indicates the lightness, in the range 0-100.

从以下版本开始:

1

getLightness

public float getLightness()

Obtains the lightness of a color.

返回:

Returns the lightness of the color.

从以下版本开始:

1