鴻蒙OS Circle

Circle

java.lang.Object

|---ohos.agp.utils.Circle

public class Circle
extends Object

提供圓規(guī)格和 alpha 值。

Since:

5

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

構(gòu)造函數(shù)	描述
Circle(float x, float y, float radius)	用于創(chuàng)建具有指定中心坐標(biāo)和半徑的 Circle 實(shí)例的構(gòu)造函數(shù)。

方法總結(jié)

修飾符和類型	方法	描述
boolean	equals(Object object)	指示其他對(duì)象是否“等于”這個(gè)對(duì)象。
double	getArea()	獲取該圓的面積。
Point	getCenter()	獲得這個(gè)圓的中心。
float	getCenterX()	獲取圓心的 x 坐標(biāo)。
float	getCenterY()	獲取圓心的 y 坐標(biāo)。
float	getRadius()	獲取此圓的半徑。
int	hashCode()	返回對(duì)象的哈希碼值。
boolean	isEmpty()	檢查此圓的半徑是否小于零。
boolean	isInclude(float x, float y)	檢查指定點(diǎn) (x, y) 是否包含在此圓中。
boolean	isInclude(float x1, float y1, float r1)	檢查該圓中是否包含具有指定中心坐標(biāo)和半徑的圓。
boolean	isInclude(Circle circle)	檢查指定的圈子是否包含在此圈子中。
boolean	isInclude(Point point)	檢查指定的 Point 實(shí)例是否包含在此圓中。
boolean	isIntersect(float x1, float y1, float r1)	檢查具有指定中心坐標(biāo)和半徑的圓是否與該圓相交。
boolean	isIntersect(Circle circle)	檢查指定的圓是否與該圓相交。
void	set(float x, float y, float radius)	根據(jù)指定的中心坐標(biāo)和半徑設(shè)置此圓的屬性。
void	set(Circle circle)	根據(jù)指定的圓設(shè)置該圓的屬性。
void	set(Point point, float radius)	根據(jù)指定的 Point 實(shí)例和半徑設(shè)置此圓的屬性。
void	setCenter(float x, float y)	根據(jù)指定的坐標(biāo)設(shè)置此圓的中心。
void	setCenter(Point point)	設(shè)置此圓的中心。
void	setCenterX(float x)	設(shè)置圓心的 x 坐標(biāo)。
void	setCenterY(float y)	設(shè)置圓心的 y 坐標(biāo)。
void	setEmpty()	將圓的中心坐標(biāo)設(shè)置為 (0, 0) 并將半徑設(shè)置為零。
void	setRadius(float radius)	設(shè)置此圓的半徑。
void	shrink(float size)	縮小此圓的半徑。
void	stretch(float size)	拉伸這個(gè)圓的半徑。
String	toString()	返回對(duì)象的字符串表示形式。
void	translate(float dx, float dy)	將此圓平移指定距離。
void	translate(Point point)	平移這個(gè)圓，它在 x 軸和 y 軸上的偏移量由一個(gè)點(diǎn)指定。
void	zoom(float factor)	放大或縮小這個(gè)圓圈。

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

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

Circle

public Circle(float x, float y, float radius)

用于創(chuàng)建具有指定中心坐標(biāo)和半徑的 Circle 實(shí)例的構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x	表示圓心的指定 x 坐標(biāo)。
y	指示圓心的指定 y 坐標(biāo)。
radius	表示圓的指定半徑。

Since:

5

方法詳情

isEmpty

public boolean isEmpty()

檢查此圓的半徑是否小于零。

返回:

如果圓的半徑小于零，則返回 true； 否則返回 false。

Since:

5

set

public void set(float x, float y, float radius)

根據(jù)指定的中心坐標(biāo)和半徑設(shè)置此圓的屬性。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x	表示圓心的指定 x 坐標(biāo)。
y	指示圓心的指定 y 坐標(biāo)。
radius	表示指定的半徑。

Since:

5

setEmpty

public void setEmpty()

將圓的中心坐標(biāo)設(shè)置為 (0, 0) 并將半徑設(shè)置為零。

Since:

5

equals

public boolean equals(Object object)

從類復(fù)制的描述：對(duì)象

指示其他對(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，前提是沒有修改對(duì)象上 equals 比較中使用的信息。
• 對(duì)于任何非空引用值 x，x.equals(null) 應(yīng)該返回 false。

Object 類的 equals 方法實(shí)現(xiàn)了對(duì)象上最有區(qū)別的可能等價(jià)關(guān)系； 也就是說，對(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ù)描述
object	要與之比較的參考對(duì)象。

返回:

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

hashCode

public int hashCode()

從類復(fù)制的描述：對(duì)象

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

hashCode 的一般合約是：

• 每當(dāng)在 Java 應(yīng)用程序執(zhí)行期間對(duì)同一對(duì)象多次調(diào)用時(shí)，hashCode 方法必須始終返回相同的整數(shù)，前提是沒有修改對(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ù)。 （這通常通過將對(duì)象的內(nèi)部地址轉(zhuǎn)換為整數(shù)來實(shí)現(xiàn)，但 Java? 編程語言不需要這種實(shí)現(xiàn)技術(shù)。）

覆蓋：

類 Object 中的 hashCode

返回:

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

toString

public String toString()

從類復(fù)制的描述：對(duì)象

返回對(duì)象的字符串表示形式。 通常，toString 方法返回一個(gè)“以文本方式表示”該對(duì)象的字符串。 結(jié)果應(yīng)該是一個(gè)簡潔但信息豐富的表示，易于人們閱讀。 建議所有子類重寫此方法。

Object 類的 toString 方法返回一個(gè)字符串，該字符串由對(duì)象作為其實(shí)例的類的名稱、at 符號(hào)字符“@”和對(duì)象哈希碼的無符號(hào)十六進(jìn)制表示形式組成。 換句話說，此方法返回一個(gè)等于以下值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode()) 

覆蓋：

類 Object 中的 toString

返回:

對(duì)象的字符串表示形式。

set

public void set(Point point, float radius)

根據(jù)指定的 Point 實(shí)例和半徑設(shè)置此圓的屬性。

參數(shù)：

參數(shù)名稱	參數(shù)描述
point	指示要設(shè)置的圓的中心。
radius	指示要設(shè)置的圓的半徑。

Since:

5

set

public void set(Circle circle)

根據(jù)指定的圓設(shè)置該圓的屬性。

參數(shù)：

參數(shù)名稱	參數(shù)描述
circle	表示指定的圓。

Since:

5

getRadius

public float getRadius()

獲取此圓的半徑。

返回:

返回此圓的半徑。

Since:

5

setRadius

public void setRadius(float radius)

設(shè)置此圓的半徑。

參數(shù)：

參數(shù)名稱	參數(shù)描述
radius	表示要設(shè)置的半徑。

Since:

5

getCenter

public Point getCenter()

獲得這個(gè)圓的中心。

返回:

返回此圓的中心。

Since:

5

getCenterX

public float getCenterX()

獲取圓心的 x 坐標(biāo)。

返回:

返回圓心的 x 坐標(biāo)。

Since:

5

getCenterY

public float getCenterY()

獲取圓心的 y 坐標(biāo)。

返回:

返回圓心的 y 坐標(biāo)。

Since:

5

setCenter

public void setCenter(float x, float y)

根據(jù)指定的坐標(biāo)設(shè)置此圓的中心。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x	指示要設(shè)置的中心的 x 坐標(biāo)。
y	指示要設(shè)置的中心的 y 坐標(biāo)。

Since:

5

setCenter

public void setCenter(Point point)

設(shè)置此圓的中心。

參數(shù)：

參數(shù)名稱	參數(shù)描述
point	表示要設(shè)置的中心。

Since:

5

setCenterX

public void setCenterX(float x)

設(shè)置圓心的 x 坐標(biāo)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x	指示要設(shè)置的 x 坐標(biāo)。

Since:

5

setCenterY

public void setCenterY(float y)

設(shè)置圓心的 y 坐標(biāo)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
y	指示要設(shè)置的 y 坐標(biāo)。

Since:

5

isInclude

public boolean isInclude(float x, float y)

檢查指定點(diǎn) (x, y) 是否包含在此圓中。

參數(shù)：

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

返回:

如果指定的點(diǎn)包含在圓中，則返回 true； 否則返回 false。

Since:

5

isInclude

public boolean isInclude(Point point)

檢查指定的 Point 實(shí)例是否包含在此圓中。

參數(shù)：

參數(shù)名稱	參數(shù)描述
point	表示指定的 Point 實(shí)例。

返回:

如果指定的 Point 實(shí)例包含在此圓中，則返回 true； 否則返回 false。

Since:

5

isInclude

public boolean isInclude(float x1, float y1, float r1)

檢查該圓中是否包含具有指定中心坐標(biāo)和半徑的圓。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x1	表示指定圓心的 x 坐標(biāo)。
y1	指示指定圓心的 y 坐標(biāo)。
r1	表示指定圓的半徑。

返回:

如果指定的圓圈包含在此圓圈中，則返回 true； 否則返回 false。

Since:

5

isInclude

public boolean isInclude(Circle circle)

檢查指定的圈子是否包含在此圈子中。

參數(shù)：

參數(shù)名稱	參數(shù)描述
circle	表示指定的圓。

返回:

如果指定的圓圈包含在此圓圈中，則返回 true； 否則返回 false。

Since:

5

isIntersect

public boolean isIntersect(float x1, float y1, float r1)

檢查具有指定中心坐標(biāo)和半徑的圓是否與該圓相交。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x1	表示指定圓心的 x 坐標(biāo)。
y1	指示指定圓心的 y 坐標(biāo)。
r1	表示指定圓的半徑。

返回:

如果指定的圓與該圓相交，則返回 true； 否則返回 false。

Since:

5

isIntersect

public boolean isIntersect(Circle circle)

檢查指定的圓是否與該圓相交。

參數(shù)：

參數(shù)名稱	參數(shù)描述
circle	表示指定的圓。

返回:

如果指定的圓與該圓相交，則返回 true； 否則返回 false。

Since:

5

zoom

public void zoom(float factor)

放大或縮小這個(gè)圓圈。

參數(shù)：

參數(shù)名稱	參數(shù)描述
factor	表示縮放系數(shù)。

Since:

5

stretch

public void stretch(float size)

拉伸這個(gè)圓的半徑。

參數(shù)：

參數(shù)名稱	參數(shù)描述
size	表示延伸半徑的長度。

Since:

5

shrink

public void shrink(float size)

縮小此圓的半徑。

參數(shù)：

參數(shù)名稱	參數(shù)描述
size	指示要從原始半徑切開的長度。

Since:

5

translate

public void translate(float dx, float dy)

將此圓平移指定距離。

參數(shù)：

參數(shù)名稱	參數(shù)描述
dx	表示圓在 x 軸上的偏移量。
dy	表示圓在 y 軸上的偏移量。

Since:

5

translate

public void translate(Point point)

平移這個(gè)圓，它在 x 軸和 y 軸上的偏移量由一個(gè)點(diǎn)指定。

參數(shù)：

參數(shù)名稱	參數(shù)描述
point	指示指定圓在 x 軸和 y 軸上的偏移量的點(diǎn)。

Since:

5

getArea

public double getArea()

獲取該圓的面積。

返回:

返回此圓的面積。

Since:

5