java.awt
類別 GradientPaint

java.lang.Object
  java.awt.GradientPaint

所有已實作的介面：

Paint, Transparency

public class GradientPaint
extends Object
implements Paint

GradientPaint 類別提供了使用線性顏色漸變網要填充 Shape 的方法。如果在使用者空間指定了 Point P1 的 Color 為 C1，Point P2 的 Color 為 C2，則 P1、P2 連接線上的 Color 是逐漸地從 C1 變化到 C2 的。任何不在 P1、P2 延長線上的點 P 都具有點 P' 的顏色，P' 是 P1、P2 延長線上點 P 的垂直投影。P1、P2 段以外的延長線上的點可以按以下兩種方式之一進行著色。

• 如果漸變是週期性的，那麼 P1、P2 延長線上的點在顏色 C1 和 C2 之間來回循環。
• 如果漸變是非週期性的，那麼 P1 一邊的點有固定的 Color C1，而 P2 一邊的點有固定的 Color C2。

另請參見：

Paint, Graphics2D.setPaint(java.awt.Paint)

欄位摘要

從介面 java.awt.Transparency 繼承的欄位

BITMASK, OPAQUE, TRANSLUCENT

建構子摘要

GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2)
建構一個簡單的非週期性 GradientPaint 物件。

GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2, boolean cyclic)
根據 boolean 參數建構一個週期性或非週期性的 GradientPaint 物件。

GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2)
建構一個簡單的非週期性 GradientPaint 物件。

GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2, boolean cyclic)
根據 boolean 參數建構一個週期性或非週期性的 GradientPaint 物件。

方法摘要

PaintContext	createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints) 創建並返回用來產生顏色網要的上下文。
Color	getColor1() 返回點 P1 的顏色 C1。
Color	getColor2() 返回點 P2 的顏色 C2。
Point2D	getPoint1() 返回著第一種顏色的點 P1 的副本。
Point2D	getPoint2() 返回著第二種顏色的點 P2 的副本。
int	getTransparency() 返回此 GradientPaint 的透明度網要。
boolean	isCyclic() 如果漸變在兩種顏色 C1 和 C2 之間重複循環，則返回 true。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

GradientPaint

public GradientPaint(float x1,
                     float y1,
                     Color color1,
                     float x2,
                     float y2,
                     Color color2)

建構一個簡單的非週期性 GradientPaint 物件。

參數：

x1 - 使用者空間中第一個指定 Point 的 x 坐標

y1 - 使用者空間中第一個指定 Point 的 y 坐標

color1 - 第一個指定 Point 處的 Color

x2 - 使用者空間中第二個指定 Point 的 x 坐標

y2 - 使用者空間中第二個指定 Point 的 y 坐標

color2 - 第二個指定 Point 處的 Color

拋出：

NullPointerException - 如果任何一個 color 為 null

GradientPaint

public GradientPaint(Point2D pt1,
                     Color color1,
                     Point2D pt2,
                     Color color2)

建構一個簡單的非週期性 GradientPaint 物件。

參數：

pt1 - 使用者空間中第一個指定的 Point

color1 - 第一個指定 Point 處的 Color

pt2 - 使用者空間中第二個指定的 Point

color2 - 第二個指定 Point 處的 Color

拋出：

NullPointerException - 如果任何一個 color 或 point 為 null

GradientPaint

public GradientPaint(float x1,
                     float y1,
                     Color color1,
                     float x2,
                     float y2,
                     Color color2,
                     boolean cyclic)

根據 boolean 參數建構一個週期性或非週期性的 GradientPaint 物件。

參數：

x1 - 使用者空間中第一個指定 Point 的 x 坐標

y1 - 使用者空間中第一個指定 Point 的 y 坐標

color1 - 第一個指定 Point 處的 Color

x2 - 使用者空間中第二個指定 Point 的 x 坐標

y2 - 使用者空間中第二個指定 Point 的 y 坐標

color2 - 第二個指定 Point 處的 Color

cyclic - 如果漸變網要在兩種顏色之間重複循環，則為 true；否則為 false。

GradientPaint

public GradientPaint(Point2D pt1,
                     Color color1,
                     Point2D pt2,
                     Color color2,
                     boolean cyclic)

根據 boolean 參數建構一個週期性或非週期性的 GradientPaint 物件。

參數：

pt1 - 使用者空間中第一個指定的 Point

color1 - 第一個指定 Point 處的 Color

pt2 - 使用者空間中第二個指定的 Point

color2 - 第二個指定 Point 處的 Color

cyclic - 如果漸變網要在兩種顏色之間重複循環，則為 true；否則為 false。

方法詳細資訊

getPoint1

public Point2D getPoint1()

返回著第一種顏色的點 P1 的副本。

返回：

Point2D 物件，它是著 GradientPaint 的第一種顏色的點的副本。

getColor1

public Color getColor1()

返回點 P1 的顏色 C1。

返回：

Color 物件，P1 的顏色。

getPoint2

public Point2D getPoint2()

返回著第二種顏色的點 P2 的副本。

返回：

Point2D 物件，它是著 GradientPaint 的第二種顏色的點的副本。

getColor2

public Color getColor2()

返回點 P2 的顏色 C2。

返回：

Color 物件，P2 的顏色。

isCyclic

public boolean isCyclic()

如果漸變在兩種顏色 C1 和 C2 之間重複循環，則返回 true。

返回：

如果漸變在兩種顏色之間重複循環，則返回 true；否則返回 false。

createContext

public PaintContext createContext(ColorModel cm,
                                  Rectangle deviceBounds,
                                  Rectangle2D userBounds,
                                  AffineTransform xform,
                                  RenderingHints hints)

創建並返回用來產生顏色網要的上下文。

指定者：

介面 Paint 中的 createContext

參數：

cm - 接收 Paint 資料的 ColorModel。這僅作為提示使用。

deviceBounds - 正在呈現的圖形圖元的設備空間邊界框

userBounds - 正在呈現的圖形圖元的使用者空間邊界框

xform - 從使用者空間到設備空間的 AffineTransform

hints - context 物件用於選擇所呈現內容的提示

返回：

產生顏色網要的 PaintContext。

另請參見：

PaintContext

getTransparency

public int getTransparency()

返回此 GradientPaint 的透明度網要。

指定者：

介面 Transparency 中的 getTransparency

返回：

一個整數值，表示此 GradientPaint 物件的透明度網要。

另請參見：

Transparency