鴻蒙OS Point

Point

java.lang.Object

|---ohos.agp.utils.Point

public class Point
extends Object

創(chuàng)建用于記錄像素的實(shí)例的實(shí)用程序類。

每個(gè)實(shí)例代表一個(gè)二維坐標(biāo)，可以用來(lái)表示一個(gè)像素。

Since:

1

字段摘要

修飾符和類型	字段	描述
float[]	position	表示一個(gè)點(diǎn)所代表的位置。

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
Point()	用于創(chuàng)建 Point 實(shí)例的無(wú)參數(shù)構(gòu)造函數(shù)。
Point(float x, float y)	根據(jù) (x,y) 坐標(biāo)在指定位置構(gòu)造一個(gè)點(diǎn)。
Point(Point point)	在指定位置構(gòu)造一個(gè)點(diǎn)。

方法總結(jié)

修飾符和類型	方法	描述
boolean	equals(float x, float y)	檢查此點(diǎn)是否等于具有給定坐標(biāo)的指定點(diǎn)。
boolean	equals(Object o)	指示其他對(duì)象是否“等于”這個(gè)對(duì)象。
float	getPointX()	獲取此 Point 的 x 坐標(biāo)的浮點(diǎn)表示。
int	getPointXToInt()	獲取此 Point 的 x 坐標(biāo)的整數(shù)表示。
float	getPointY()	獲取此 Point 的 y 坐標(biāo)的浮點(diǎn)表示。
int	getPointYToInt()	獲取此 Point 的 y 坐標(biāo)的整數(shù)表示。
int	hashCode()	返回對(duì)象的哈希碼值。
boolean	isInRect(Rect rect)	檢查此點(diǎn)是否在指定的矩形中。
void	modify(float x, float y)	根據(jù)指定點(diǎn)的坐標(biāo)修改此點(diǎn)。
void	modify(Point point)	根據(jù)指定點(diǎn)修改此點(diǎn)。
String	toString()	獲取點(diǎn)的字符串值。
void	translate(float dx, float dy)	翻譯這一點(diǎn)。

從類 java.lang.Object 繼承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段詳細(xì)信息

position

public final float[] position

表示一個(gè)點(diǎn)所代表的位置。

一維浮點(diǎn)數(shù)組用于表示該點(diǎn)的 X 和 Y 坐標(biāo)。

構(gòu)造函數(shù)詳細(xì)信息

Point

public Point()

用于創(chuàng)建 Point 實(shí)例的無(wú)參數(shù)構(gòu)造函數(shù)。

該方法用于在坐標(biāo)空間的原點(diǎn) (0,0) 處構(gòu)造一個(gè)點(diǎn)。

Point

public Point(Point point)

在指定位置構(gòu)造一個(gè)點(diǎn)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
point	表示初始化點(diǎn)

Since:

4

Point

public Point(float x, float y)

根據(jù) (x,y) 坐標(biāo)在指定位置構(gòu)造一個(gè)點(diǎn)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x	表示X坐標(biāo)，類型為float。
y	表示Y坐標(biāo)，類型為float。

方法詳情

getPointX

public float getPointX()

獲取此 Point 的 x 坐標(biāo)的浮點(diǎn)表示。

返回:

返回 x 坐標(biāo)。

Since:

3

getPointY

public float getPointY()

獲取此 Point 的 y 坐標(biāo)的浮點(diǎn)表示。

返回:

返回 y 坐標(biāo)。

Since:

4

getPointXToInt

public int getPointXToInt()

獲取此 Point 的 x 坐標(biāo)的整數(shù)表示。

返回:

返回 x 坐標(biāo)。

Since:

4

getPointYToInt

public int getPointYToInt()

獲取此 Point 的 y 坐標(biāo)的整數(shù)表示。

返回:

返回 y 坐標(biāo)。

Since:

4

equals

public final boolean equals(float x, float y)

檢查此點(diǎn)是否等于具有給定坐標(biāo)的指定點(diǎn)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x	表示指定點(diǎn)的X坐標(biāo)。
y	表示指定點(diǎn)的Y坐標(biāo)。

返回:

如果兩點(diǎn)相等則返回 true； 否則返回 false。

Since:

4

equals

public boolean equals(Object o)

指示其他對(duì)象是否“等于”這個(gè)對(duì)象。

equals 方法在非空對(duì)象引用上實(shí)現(xiàn)等價(jià)關(guān)系：

• 它是自反的：對(duì)于任何非空引用值 x，x.equals(x) 應(yīng)該返回 true。
• 它是對(duì)稱的：對(duì)于任何非空引用值 x 和 y，當(dāng)且僅當(dāng) y.equals(x) 返回 true 時(shí)，x.equals(y) 才應(yīng)該返回 true。
• 它是可傳遞的：對(duì)于任何非空引用值 x、y 和 z，如果 x.equals(y) 返回 true 并且 y.equals(z) 返回 true，則 x.equals(z) 應(yīng)該返回 true。
• 它是一致的：對(duì)于任何非空引用值 x 和 y，x.equals(y) 的多次調(diào)用始終返回 true 或始終返回 false，前提是沒(méi)有修改對(duì)象上 equals 比較中使用的信息。
• 對(duì)于任何非空引用值 x，x.equals(null) 應(yīng)該返回 false。

Object 類的 equals 方法實(shí)現(xiàn)了對(duì)象上最有區(qū)別的可能等價(jià)關(guān)系； 也就是說(shuō)，對(duì)于任何非空引用值 x 和 y，當(dāng)且僅當(dāng) x 和 y 引用同一個(gè)對(duì)象（x == y 的值為 true）時(shí)，此方法才返回 true。

請(qǐng)注意，每當(dāng)重寫該方法時(shí)，通常都需要重寫 hashCode 方法，以維護(hù) hashCode 方法的一般約定，即相等的對(duì)象必須具有相等的哈希碼。

覆蓋：

類 Object 中的等于

參數(shù)：

參數(shù)名稱	參數(shù)描述
o	要與之比較的參考對(duì)象。

返回:

如果此對(duì)象與 obj 參數(shù)相同，則為 true； 否則為 false。

hashCode

public int hashCode()

返回對(duì)象的哈希碼值。 支持這種方法是為了有利于哈希表，例如 HashMap 提供的那些。

hashCode 的一般合約是：

• 每當(dāng)在 Java 應(yīng)用程序執(zhí)行期間對(duì)同一對(duì)象多次調(diào)用時(shí)，hashCode 方法必須始終返回相同的整數(shù)，前提是沒(méi)有修改對(duì)象上相等比較中使用的信息。 該整數(shù)不需要從應(yīng)用程序的一次執(zhí)行到同一應(yīng)用程序的另一次執(zhí)行保持一致。
• 如果兩個(gè)對(duì)象根據(jù) equals(Object) 方法相等，則對(duì)兩個(gè)對(duì)象中的每一個(gè)調(diào)用 hashCode 方法必須產(chǎn)生相同的整數(shù)結(jié)果。
• 如果根據(jù) Object.equals(java.lang.Object) 方法，如果兩個(gè)對(duì)象不相等，則不要求對(duì)兩個(gè)對(duì)象中的每一個(gè)調(diào)用 hashCode 方法必須產(chǎn)生不同的整數(shù)結(jié)果。 但是，程序員應(yīng)該意識(shí)到，為不相等的對(duì)象生成不同的整數(shù)結(jié)果可能會(huì)提高哈希表的性能。

在合理可行的情況下，由 Object 類定義的 hashCode 方法確實(shí)為不同的對(duì)象返回不同的整數(shù)。 （這通常通過(guò)將對(duì)象的內(nèi)部地址轉(zhuǎn)換為整數(shù)來(lái)實(shí)現(xiàn)，但 Java? 編程語(yǔ)言不需要這種實(shí)現(xiàn)技術(shù)。）

覆蓋：

類 Object 中的 hashCode

返回:

此對(duì)象的哈希碼值。

modify

public final void modify(float x, float y)

根據(jù)指定點(diǎn)的坐標(biāo)修改此點(diǎn)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x	表示指定點(diǎn)的X坐標(biāo)。
y	表示指定點(diǎn)的Y坐標(biāo)。

Since:

4

modify

public final void modify(Point point)

根據(jù)指定點(diǎn)修改此點(diǎn)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
point	表示指定點(diǎn)。

Since:

4

translate

public final void translate(float dx, float dy)

翻譯這一點(diǎn)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
dx	指示要平移的 x 軸距離。
dy	指示要平移的 y 軸距離。

Since:

4

isInRect

public boolean isInRect(Rect rect)

檢查此點(diǎn)是否在指定的矩形中。

參數(shù)：

參數(shù)名稱	參數(shù)描述
rect	表示指定的矩形。

返回:

如果此 Point 在指定的矩形中，則為 true； 否則返回 false。

Since:

3

toString

public String toString()

獲取點(diǎn)的字符串值。

覆蓋：

類 Object 中的 toString

返回:

返回點(diǎn)的字符串值。

Since:

4