程序包 ohos.agp.colors

类 HsvColor

java.lang.Object

ohos.agp.colors.Color

ohos.agp.colors.HsvColor

public class HsvColor
extends Color

Defines Color objects using the HSV color model.

HSV stands for Hue, Saturation, and Value.

从以下版本开始:

1

构造器概要

构造器

构造器	说明
HsvColor()	Default constructor used to create an HsvColor instance with the HSV values all being 0.
HsvColor(float hue, float saturation, float value)	A constructor used to create an HsvColor instance by specifying HSV values.
HsvColor(float hue, float saturation, float value, int alpha)	A constructor used to create an HsvColor instance by specifying HSV values plus an alpha value.
HsvColor(HsvColor color)	Replicates an existing HsvColor instance to create a new instance.

方法概要

限定符和类型	方法	说明
HsvColor	assign(HsvColor color)	Replicates the attributes of an existing HsvColor 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 an HSV color.
float	getSaturation()	Obtains the saturation of an HSV color.
float	getValue()	Obtains the brightness of an HSV color.
int	hashCode()	Returns a hash code value for the object.
void	setHue(float hue)	Sets the hue of an HSV color.
void	setSaturation(float saturation)	Sets the saturation level of an HSV color.
void	setValue(float value)	Sets the brightness of an HSV color.
static int	toColor(int alpha, float hue, float saturation, float value)	Converts an HSV color to an integer representing the corresponding ARGB color.
static HsvColor	toHSV(int colorValue)	Converts the integer representation of an ARGB color to the corresponding HsvColor object.

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

assign, getAlpha, getSpec, setAlpha

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

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

构造器详细资料

HsvColor

public HsvColor()

Default constructor used to create an HsvColor instance with the HSV values all being 0.

HsvColor

public HsvColor(float hue,
                float saturation,
                float value)

A constructor used to create an HsvColor instance by specifying HSV values.

参数:

hue - Indicates the hue.

saturation - Indicates the saturation (percentage value).

value - Indicates the brightness (percentage value).

HsvColor

public HsvColor(float hue,
                float saturation,
                float value,
                int alpha)

A constructor used to create an HsvColor instance by specifying HSV values plus an alpha value.

参数:

hue - Indicates the hue.

saturation - Indicates the saturation (percentage value).

value - Indicates the brightness (percentage value).

alpha - Indicates the color transparency.

HsvColor

public HsvColor(HsvColor color)

Replicates an existing HsvColor instance to create a new instance.

参数:

color - Indicates the existing HsvColor instance to replicate.

方法详细资料

assign

public HsvColor assign(HsvColor color)

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

参数:

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

返回:

Indicates the current HsvColor instance that has been assigned new attributes.

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 an HSV color.

参数:

hue - Indicates the hue.

getHue

public float getHue()

Obtains the hue of an HSV color.

返回:

Returns the hue of an HSV color.

setValue

public void setValue(float value)

Sets the brightness of an HSV color.

参数:

value - Indicates the color brightness (percentage value) to set.

getValue

public float getValue()

Obtains the brightness of an HSV color.

返回:

Returns the brightness (percentage value) of the HSV color.

setSaturation

public void setSaturation(float saturation)

Sets the saturation level of an HSV color.

参数:

saturation - Indicates the saturation level (percentage value) of the color.

getSaturation

public float getSaturation()

Obtains the saturation of an HSV color.

返回:

Returns the saturation level (percentage value) of the color.

toColor

public static int toColor(int alpha,
                          float hue,
                          float saturation,
                          float value)

Converts an HSV color to an integer representing the corresponding ARGB color.

参数:

alpha - Indicates the alpha value of the color.

hue - Indicates the hue value of the HSV color, in percentage.

saturation - Indicates the saturation value of the HSV color, in percentage.

value - Indicates the brightness value of the HSV color, in percentage.

返回:

Returns the integer representation of the ARGB color.

从以下版本开始:

4

toHSV

public static HsvColor toHSV(int colorValue)

Converts the integer representation of an ARGB color to the corresponding HsvColor object.

参数:

colorValue - Indicates the integer representation of the ARGB color.

返回:

Returns the HsvColor object.

从以下版本开始:

4