|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Objectjava.awt.Graphics
java.awt.Graphics2D
public abstract class Graphics2D
Graphics2D
クラスは、 Graphics
クラスを拡張して、ジオメトリ、座標変換、カラー管理、およびテキスト配置について高度な制御を行います。このクラスは、Java(TM) プラットフォームで 2D の図形、テキスト、およびイメージを描画するための基本クラスです。
Graphics2D
オブジェクトに渡されるすべての座標は、ユーザ空間 (アプリケーションによって使用される) と呼ばれる、デバイスに依存しない座標系で指定されます。Graphics2D
オブジェクトには、デバイス空間でユーザ空間の座標をデバイスに依存する座標に変換する方法を定義する AffineTransform
オブジェクトが、描画状態の一部として格納されます。
デバイス空間の座標は、通常、個別のデバイスピクセルを示し、これらのピクセル間に無限に細い間隔に並べられています。一部の Graphics2D
オブジェクトでは、描画操作を取り込むことができます。グラフィックスメタファイルとして取り込むことで、後に物理的な解像度が不明な具象デバイスを使用して再生することができます。描画操作を取り込む際には解像度が不明なので、Graphics2D
Transform
を設定してユーザ座標を仮想デバイス空間に変換するようにします。ターゲットデバイスの予想される解像度が概算されますが、その見積もりが正しくない場合には、再生時にさらに変換を適用する必要があります。
描画属性オブジェクトによって実行される一部の操作にはデバイス空間で処理されるものもありますが、Graphics2D
のメソッドはすべてユーザ空間座標を扱います。
すべての Graphics2D
オブジェクトは、描画の行われる位置を定義するターゲットと関連付けられています。GraphicsConfiguration
オブジェクトは、ピクセル形式および解像度といった描画ターゲットの特性を定義します。Graphics2D
オブジェクトでは、常に同じ描画ターゲットが使用されます。
Graphics2D
オブジェクトが作成されるとき、GraphicsConfiguration
は、Graphics2D
(Component
または Image
) のターゲットとしてデフォルト変換を指定します。このデフォルト変換では、ユーザ空間座標系を画面とプリンタのデバイス座標にマッピングして、原点をデバイスのターゲット領域の左上隅に、右方に拡張するには X 座標を、下方に拡張するには Y 座標を増やすようなマッピングを行います。スクリーンデバイスなどの 72 dpi に近いデバイスの場合、デフォルト変換のスケーリングはそれらのデバイスの識別情報に設定されます。プリンタなどの高解像度デバイスの場合、デフォルト変換のスケーリングは、1 平方インチあたり約 72 ユーザ空間座標に設定されます。イメージバッファでは、デフォルトの変換は Identity
変換です。
Graphics2D
描画属性によって制御される 4 つの段階に分けることができます。レンダリングではこうしたステップの多くを最適化できます。最適化は、将来の呼び出しにそなえて結果をキャッシュに格納しておいたり、複数の仮想ステップを実質的に 1 つの操作にまとめたり、さまざまな属性に関する単純な共通の問題点を、操作のほかの部分を変更することにより排除したりすること、などによって行われます。
描画プロセスの手順を以下に説明します。
Clip
はユーザ空間の Shape
によって指定され、Graphics
および Graphics2D
のさまざまなクリップ操作メソッドを使ってプログラムによって制御されます。この「ユーザクリップ」は、現在の Transform
によってデバイス空間に変換され、ウィンドウの可視性およびデバイスの大きさによって定義される「デバイスクリップ」と結合されます。ユーザクリップとデバイスクリップの結合によって、最終的なクリッピング領域を決める「複合クリップ」を定義します。レンダリングシステムは、ユーザクリップを変更して複合クリップの結果を反映することはできません。Graphics2D
コンテキストの現在の Composite
属性を使って、デスティネーションの描画表面に指定された色を塗るShape
の操作draw(Shape)
操作の場合、Graphics2D
コンテキストの現在の Stroke
属性で createStrokedShape
メソッドを使って、指定の Shape
の輪郭を格納する新しい Shape
オブジェクトが構築されます。Shape
は、Graphics2D
コンテキストの現在の Transform
を使ってユーザ空間からデバイス空間に変換されます。Shape
の輪郭は、Shape
の getPathIterator
メソッドを使って抽出されます。このメソッドは、Shape
の境界に沿って繰り返し処理を行う PathIterator
オブジェクトを返します。PathIterator
オブジェクトによって返される曲線セグメントを Graphics2D
オブジェクトが処理できない場合は、Shape
の平坦化を行う代替メソッド getPathIterator
を呼び出すことができます。Graphics2D
コンテキストの現在の Paint
が、デバイス空間で描画する色を指定する PaintContext
を取得するために照会されます。String
を描画するために必要なグリフのセットは、以下の手順で指定されます。String
の場合、フォントが実装する基本レイアウトおよび形状決定アルゴリズムに関係なくそれらを用いて表示するために、Graphics2D
コンテキストの現在の Font
は String
の Unicode 文字列をグリフのセットに変換するように要求されます。AttributedCharacterIterator
の場合、反復子は、埋め込みフォント属性を使って、それ自体を TextLayout
に変換するように要求されます。TextLayout
は、書き込み方向が異なる複数のフォントのために自動的に Unicode の双方向レイアウト調整を実行する、より高性能なグリフレイアウトアルゴリズムを実装できます。GlyphVector
の場合、GlyphVector
オブジェクトは、各グリフの位置を示す明示的な座標を持つフォント独自の適切なグリフコードをすでに格納しています。Font
を照会すると、指定されたグリフのアウトラインを取得できます。これらのアウトラインは、手順 1 で指定された各グリフの位置を基準にしたユーザ空間の形状として処理されます。Shape
の操作」で説明したように塗りつぶされます。Paint
が、デバイス空間で描画する色を指定する PaintContext
を取得するために照会されます。Image
の操作Image
のバウンディングボックスで定義されます。このバウンディングボックスは、Image
オブジェクトのローカルな座標系であるイメージ空間で指定されます。AffineTransform
が drawImage(Image, AffineTransform, ImageObserver)
に渡される場合は、イメージ空間からユーザ空間にバウンディングボックスを変換するために、その AffineTransform
が使われます。AffineTransform
が指定されない場合、バウンディングボックスはすでにユーザ空間にあるものとして扱われます。Image
のバウンディングボックスは、現在の Transform
を使ってユーザ空間からデバイス空間に変換されます。ただし、バウンディングボックスを変換した結果が、デバイス空間で矩形領域となるとは限りません。Image
オブジェクトは描画する色を指定します。色は、現在の Transform
とオプションのイメージ変換によって指定されたソースからデスティネーションへのマッピングに従ってサンプリングされます。 Graphics2D
描画属性の既定値を以下に示します。Paint
Component
の色Font
Component
の Font
Stroke
Transform
Component
の GraphicsConfiguration
用の getDefaultTransform
Composite
AlphaComposite.SRC_OVER
規則Clip
Clip
なし、出力は Component
にクリップされる
Java 2D(TM) (Java(TM) 2 プラットフォーム) API は、平滑化レンダリングをサポートしています。1 ピクセル幅のペンは、ピクセル N+1 と対比したピクセル N に完全に収まる必要はありません。ペンは、部分的に両方のピクセルにかかることができます。移動しているペンの縁が両方のピクセルにかかると、ペンのサブピクセル位置がユーザに表示されるため、幅広ペンのバイアス方向を選択する必要はありません。一方、KEY_ANTIALIASING
ヒントキーを VALUE_ANTIALIAS_OFF
ヒント値に設定することによって平滑化を無効にした場合は、デバイス空間で整数座標に沿って描画しているときなど、ペンがピクセル境界を越えようとしているときにどちらのピクセルを修正するか判断するために、レンダリングはバイアスを適用する必要があります。平滑化レンダリングの機能により、描画モデルはペンのバイアスを指定する必要性がなくなりましたが、画面上で 1 ピクセル幅の水平線および垂直線を描画する共通のケースでは、平滑化レンダリングと非平滑化レンダリングは同じように動作する必要があります。KEY_ANTIALIASING
ヒントキーを VALUE_ANTIALIAS_ON
に設定して平滑化を有効にしたために、この線幅が突然 2 倍になり不透明度が半分になることを防ぐには、そのような線の輪郭線をモデルで指定することによって、その線が特定のピクセルのセットを完全にカバーして輪郭が鮮明になるようにします。
Java 2D API は JDK 1.1 の描画動作との互換性を維持しており、Java 2D API では従来からの操作や既存のレンダリングの動作に変更はありません。一般的な draw
メソッドおよび fill
メソッドにマッピングされる従来のメソッドが定義されているため、Stroke
属性と Transform
属性の設定および描画ヒントに基づいて Graphics2D
が Graphics
をどのように拡張しているかが明確に示されています。その定義は、デフォルトの属性設定では同じように実行されます。たとえば、デフォルトの Stroke
は、幅 1 および破線なしの BasicStroke
であり、画面描画のデフォルトの Transform は恒等変換です。
次の 2 つの規則は、非アンチエイリアスまたはアンチエイリアスのどちらが使用されていても、予測可能な描画動作を提供します。
BasicStroke
オブジェクトを使ってストロークした線および図形の輪郭を「正規化」することで、描画可能なさまざまな位置で非アンチエイリアス描画またはアンチエイリアス描画するときに、一貫性のある輪郭を描画することができます。この正規化プロセスは、KEY_STROKE_CONTROL
ヒントによって制御されます。正確な正規化アルゴリズムは指定されませんが、この正規化の目標は、ピクセルグリッドに線がどのように収まるかに関わらず、視覚的に一貫性のある線を描画できるようにすること、およびアンチエイリアスモードでの水平線および垂直線をより緻密にして、アンチエイリアスされていない場合の線になるべく近づけることです。通常の正規化のステップでは、浮動小数点の線幅が同等の可能性で偶数または奇数のピクセル数に四捨五入できるように、アンチエイリアスされた線の終端をよりピクセルの中心にして重なる量を減らすか、あるいはアンチエイリアスされていない線のサブピクセルの位置決めを調整します。このプロセスでは、終端をピクセルの半分まで移動して (通常は両軸に沿って正の無限大方向)、これらの結果の一貫性を高めることができます。
次に示す一般的な従来のメソッドの定義は、デフォルト属性設定では以前に指定された動作と同じように実行されます。
fillRect
、fillRoundRect
、fillOval
、fillArc
、fillPolygon
、clearRect
などの fill
操作の場合は、目的の Shape
を指定して fill
を呼び出すことができます。たとえば矩形を塗りつぶす場合は、
fill(new Rectangle(x, y, w, h));を呼び出します。
drawLine
、drawRect
、drawRoundRect
、drawOval
、drawArc
、drawPolyline
、drawPolygon
などの描画操作の場合は、目的の Shape
を指定して draw
を呼び出すことができます。たとえば矩形を描画する場合は、
draw(new Rectangle(x, y, w, h));を呼び出します。
draw3DRect
メソッドと fill3DRect
メソッドは、Graphics
クラスでは drawLine
メソッドと fillRect
メソッドを使って実装されています。これらの動作は、Graphics2D
コンテキストの現在の Stroke
オブジェクトと Paint
オブジェクトに基づいて予測できます。Graphics2D
クラスは、現在の Paint
をオーバーライドし、これらの 2 つのオブジェクトの実装を現在の Color
を排他的に使うバージョンでオーバーライドします。このクラスは、既存のメソッドと完全に等しい動作を記述するために、Stroke
の現在の設定とは無関係に fillRect
を使用します。
Graphics
クラスは、ペイントされる色を制御するために setColor
メソッドだけを定義します。Java 2D API は、Color
オブジェクトを拡張して新しい Paint
インタフェースを実装するので、既存の setColor
メソッドは現在の Paint
属性を Color
オブジェクトに設定するための簡易メソッドになっています。setColor(c)
は setPaint(c)
に相当します。
Graphics
クラスは、色をデスティネーションに適用する方法を制御するために 2 つのメソッドを定義します。
setPaintMode
メソッドは、setComposite(new AlphaComposite.SrcOver)
に相当するデフォルトの Composite
を設定する簡易メソッドとして実装されます。setXORMode(Color xorcolor)
メソッドは、ソースカラーの Alpha
コンポーネントを無視し、デスティネーションカラーをその値に設定する特殊な Composite
オブジェクトを設定するための簡易メソッドとして実装されます。
dstpixel = (PixelOf(srccolor) ^ PixelOf(xorcolor) ^ dstpixel);
RenderingHints
コンストラクタの概要 | |
---|---|
protected |
Graphics2D()
新しい Graphics2D オブジェクトを構築します。 |
メソッドの概要 | |
---|---|
abstract void |
addRenderingHints(Map<?,?> hints)
描画アルゴリズムに関する任意の数の推奨設定の値を設定します。 |
abstract void |
clip(Shape s)
現在の Clip を指定された Shape の内部と交差させて、結果として生じた共通部分にその Clip を設定します。 |
abstract void |
draw(Shape s)
現在の Graphics2D コンテキストの設定を使うことにより、Shape の輪郭をストロークで描画します。 |
void |
draw3DRect(int x,
int y,
int width,
int height,
boolean raised)
指定された矩形の輪郭を 3D で強調表示して描画します。 |
abstract void |
drawGlyphVector(GlyphVector g,
float x,
float y)
Graphics2D コンテキストの描画属性を使うことにより、指定された GlyphVector のテキストを描画します。 |
abstract void |
drawImage(BufferedImage img,
BufferedImageOp op,
int x,
int y)
BufferedImageOp でフィルタ処理される BufferedImage を描画します。 |
abstract boolean |
drawImage(Image img,
AffineTransform xform,
ImageObserver obs)
イメージ空間からユーザ空間への変換を適用してから、イメージを描画します。 |
abstract void |
drawRenderableImage(RenderableImage img,
AffineTransform xform)
イメージ空間からユーザ空間への変換を適用してから、 RenderableImage を描画します。 |
abstract void |
drawRenderedImage(RenderedImage img,
AffineTransform xform)
イメージ空間からユーザ空間への変換を適用してから、 RenderedImage を描画します。 |
abstract void |
drawString(AttributedCharacterIterator iterator,
float x,
float y)
Graphics2D コンテキストの現在の Paint を使うことにより、指定された反復子のテキストを描画します。 |
abstract void |
drawString(AttributedCharacterIterator iterator,
int x,
int y)
Graphics2D コンテキストの現在の Paint を使うことにより、指定された反復子のテキストを描画します。 |
abstract void |
drawString(String s,
float x,
float y)
Graphics2D コンテキストの現在のテキスト属性状態を使うことにより、特定の String により指定されたテキストを描画します。 |
abstract void |
drawString(String str,
int x,
int y)
Graphics2D コンテキストの現在のテキスト属性状態を使うことにより、指定された String のテキストを描画します。 |
abstract void |
fill(Shape s)
Graphics2D コンテキストの設定を使うことにより、Shape の内部を塗りつぶします。 |
void |
fill3DRect(int x,
int y,
int width,
int height,
boolean raised)
現在の色で塗りつぶされている、3D で強調表示された矩形をペイントします。 |
abstract Color |
getBackground()
領域をクリアするのに使うバックグラウンドカラーを返します。 |
abstract Composite |
getComposite()
Graphics2D コンテキストでの現在の Composite を返します。 |
abstract GraphicsConfiguration |
getDeviceConfiguration()
この Graphics2D に関連したデバイス構成を返します。 |
abstract FontRenderContext |
getFontRenderContext()
この Graphics2D コンテキストでの Font の描画コンテキストを返します。 |
abstract Paint |
getPaint()
Graphics2D コンテキストでの現在の Paint を返します。 |
abstract Object |
getRenderingHint(RenderingHints.Key hintKey)
描画アルゴリズムの推奨設定の値を 1 つ返します。 |
abstract RenderingHints |
getRenderingHints()
描画アルゴリズムの推奨設定を返します。 |
abstract Stroke |
getStroke()
Graphics2D コンテキストでの現在の Stroke を返します。 |
abstract AffineTransform |
getTransform()
Graphics2D コンテキストでの現在の Transform のコピーを返します。 |
abstract boolean |
hit(Rectangle rect,
Shape s,
boolean onStroke)
指定された Shape が指定された Rectangle (デバイス空間にある) と交差するかどうかを判定します。 |
abstract void |
rotate(double theta)
現在の Graphics2D Transform を回転変換と連結します。 |
abstract void |
rotate(double theta,
double x,
double y)
現在の Graphics2D Transform を移動後の回転変換と連結します。 |
abstract void |
scale(double sx,
double sy)
現在の Graphics2D Transform をスケーリング変換と連結します。 |
abstract void |
setBackground(Color color)
Graphics2D コンテキストのバックグラウンドカラーを設定します。 |
abstract void |
setComposite(Composite comp)
Graphics2D コンテキストの Composite を設定します。 |
abstract void |
setPaint(Paint paint)
Graphics2D コンテキストに Paint 属性を設定します。 |
abstract void |
setRenderingHint(RenderingHints.Key hintKey,
Object hintValue)
描画アルゴリズムの推奨設定の値を 1 つ設定します。 |
abstract void |
setRenderingHints(Map<?,?> hints)
描画アルゴリズムのすべての推奨設定の値を、指定された hints に置き換えます。 |
abstract void |
setStroke(Stroke s)
Graphics2D コンテキストの Stroke を設定します。 |
abstract void |
setTransform(AffineTransform Tx)
Graphics2D コンテキストで Transform を上書きします。 |
abstract void |
shear(double shx,
double shy)
現在の Graphics2D Transform をシャーリング変換と連結します。 |
abstract void |
transform(AffineTransform Tx)
AffineTransform オブジェクトをこの Graphics2D での Transform を使って、後指定優先適用という規則に従って変換します。 |
abstract void |
translate(double tx,
double ty)
現在の Graphics2D Transform を移動変換と連結します。 |
abstract void |
translate(int x,
int y)
Graphics2D コンテキストの原点を、現在の座標系の点 (x, y) に移動します。 |
クラス java.awt.Graphics から継承されたメソッド |
---|
clearRect, clipRect, copyArea, create, create, dispose, drawArc, drawBytes, drawChars, drawImage, drawImage, drawImage, drawImage, drawImage, drawImage, drawLine, drawOval, drawPolygon, drawPolygon, drawPolyline, drawRect, drawRoundRect, fillArc, fillOval, fillPolygon, fillPolygon, fillRect, fillRoundRect, finalize, getClip, getClipBounds, getClipBounds, getClipRect, getColor, getFont, getFontMetrics, getFontMetrics, hitClip, setClip, setClip, setColor, setFont, setPaintMode, setXORMode, toString |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
---|
protected Graphics2D()
Graphics2D
オブジェクトを構築します。Graphics2D
は abstract クラスであり、さまざまな出力デバイスのためにサブクラスでカスタマイズされなければならないため、Graphics2D
オブジェクトを直接作成することはできません。代わりに、ほかの Graphics2D
オブジェクトから取得するか、Component
によって作成するか、あるいは BufferedImage
オブジェクトなどのイメージから取得しなければなりません。
Component.getGraphics()
,
Graphics.create()
メソッドの詳細 |
---|
public void draw3DRect(int x, int y, int width, int height, boolean raised)
強調表示効果に使われる色は、現在の色に基づいて指定されます。描画された矩形は、幅 width + 1
ピクセル、高さ height + 1
ピクセルの領域をカバーします。このメソッドは、現在の Color
だけを使い、現在の Paint
は無視します。
Graphics
内の draw3DRect
x
- 描画される矩形の x 座標y
- 描画される矩形の y 座標width
- 描画される矩形の幅height
- 描画される矩形の高さraised
- 矩形が表面から浮き出たように見えるか、表面に彫り込まれたように見えるかを指定する boolean 値Graphics.fill3DRect(int, int, int, int, boolean)
public void fill3DRect(int x, int y, int width, int height, boolean raised)
Color
によって指定されます。このメソッドは現在の Color
だけを使い、現在の Paint
は無視します。
Graphics
内の fill3DRect
x
- 塗りつぶされる矩形の x 座標y
- 塗りつぶされる矩形の y 座標width
- 塗りつぶされる矩形の幅height
- 塗りつぶされる矩形の高さraised
- 矩形が表面から浮き出たように見えるか、表面に彫り込まれたように見えるかを指定する boolean 値Graphics.draw3DRect(int, int, int, int, boolean)
public abstract void draw(Shape s)
Graphics2D
コンテキストの設定を使うことにより、Shape
の輪郭をストロークで描画します。適用される描画属性には、Clip
、Transform
、Paint
、Composite
、および Stroke
の各属性があります。
s
- 描画される Shape
setStroke(java.awt.Stroke)
,
setPaint(java.awt.Paint)
,
Graphics.setColor(java.awt.Color)
,
transform(java.awt.geom.AffineTransform)
,
setTransform(java.awt.geom.AffineTransform)
,
clip(java.awt.Shape)
,
Graphics.setClip(int, int, int, int)
,
setComposite(java.awt.Composite)
public abstract boolean drawImage(Image img, AffineTransform xform, ImageObserver obs)
Graphics2D
での現在の Transform
によって行われます。指定された変換は、Graphics2D
コンテキストの変換属性に適用される前にイメージに適用されます。適用される描画属性には、Clip
、Transform
、および Composite
の各属性があります。ただし、指定された変換が逆変換を持たない場合、描画は行われません。
img
- 描画される指定イメージ。img
が null の場合には何も行わないxform
- イメージ空間からユーザ空間への変換obs
- Image
のより多くの部分が変換されると通知される、ImageObserver
Image
がすべてロードされ、完全に描画された場合は true
、Image
がまだロード中の場合は false
transform(java.awt.geom.AffineTransform)
,
setTransform(java.awt.geom.AffineTransform)
,
setComposite(java.awt.Composite)
,
clip(java.awt.Shape)
,
Graphics.setClip(int, int, int, int)
public abstract void drawImage(BufferedImage img, BufferedImageOp op, int x, int y)
BufferedImageOp
でフィルタ処理される BufferedImage
を描画します。適用される描画属性には、Clip
、Transform
、および Composite
の各属性があります。これは、次の操作に相当します。
img1 = op.filter(img, null); drawImage(img1, new AffineTransform(1f,0f,0f,1f,x,y), null);
op
- 描画前にイメージに適用されるフィルタimg
- 描画される指定 BufferedImage
。img
が null の場合には何も行わないx
- イメージの左上隅が描画されるユーザ空間の位置の x 座標y
- イメージの左上隅が描画されるユーザ空間の位置の y 座標transform(java.awt.geom.AffineTransform)
,
setTransform(java.awt.geom.AffineTransform)
,
setComposite(java.awt.Composite)
,
clip(java.awt.Shape)
,
Graphics.setClip(int, int, int, int)
public abstract void drawRenderedImage(RenderedImage img, AffineTransform xform)
RenderedImage
を描画します。ユーザ空間からデバイス空間への変換は、Graphics2D
での現在の Transform
によって行われます。指定された変換は、Graphics2D
コンテキストの変換属性に適用される前にイメージに適用されます。適用される描画属性には、Clip
、Transform
、および Composite
の各属性があります。ただし、指定された変換が逆変換を持たない場合、描画は行われません。
img
- 描画されるイメージ。img
が null の場合には何も行わないxform
- イメージ空間からユーザ空間への変換transform(java.awt.geom.AffineTransform)
,
setTransform(java.awt.geom.AffineTransform)
,
setComposite(java.awt.Composite)
,
clip(java.awt.Shape)
,
Graphics.setClip(int, int, int, int)
public abstract void drawRenderableImage(RenderableImage img, AffineTransform xform)
RenderableImage
を描画します。ユーザ空間からデバイス空間への変換は、Graphics2D
での現在の Transform
によって行われます。指定された変換は、Graphics2D
コンテキストの変換属性に適用される前にイメージに適用されます。適用される描画属性には、Clip
、Transform
、および Composite
の各属性があります。ただし、指定された変換が逆変換を持たない場合、描画は行われません。 Graphics2D
オブジェクトに設定された描画ヒントは、RenderableImage
の描画に使用できます。特定の RenderableImage
によって認識された特定のヒントに明示的な制御が必要な場合や、どのヒントが使用されるかを知っておく必要がある場合には、RenderedImage
を RenderableImage
から直接取得し、(RenderedImage, AffineTransform) drawRenderedImage
を使って描画する必要があります。
img
- 描画されるイメージ。img
が null の場合には何も行わないxform
- イメージ空間からユーザ空間への変換transform(java.awt.geom.AffineTransform)
,
setTransform(java.awt.geom.AffineTransform)
,
setComposite(java.awt.Composite)
,
clip(java.awt.Shape)
,
Graphics.setClip(int, int, int, int)
,
drawRenderedImage(java.awt.image.RenderedImage, java.awt.geom.AffineTransform)
public abstract void drawString(String str, int x, int y)
Graphics2D
コンテキストの現在のテキスト属性状態を使うことにより、指定された String
のテキストを描画します。最初の文字のベースラインは、ユーザ空間の (x, y) に位置します。適用される描画属性には、Clip
、Transform
、Paint
、Font
、および Composite
の各属性があります。ヘブライ語やアラビア語などの筆記システムの文字では、グリフは右から左に描画されます。この場合、指定された座標はベースラインの左端の文字位置にあります。
Graphics
内の drawString
str
- 描画される文字列x
- String
が描画される位置の x 座標y
- String
が描画される位置の y 座標
NullPointerException
- str
が null
の場合Graphics.drawBytes(byte[], int, int, int, int)
,
Graphics.drawChars(char[], int, int, int, int)
public abstract void drawString(String s, float x, float y)
Graphics2D
コンテキストの現在のテキスト属性状態を使うことにより、特定の String
により指定されたテキストを描画します。最初の文字のベースラインは、ユーザ空間の (x, y) に位置します。適用される描画属性には、Clip
、Transform
、Paint
、Font
、および Composite
の各属性があります。ヘブライ語やアラビア語などの筆記システムの文字では、グリフは右から左に描画されます。この場合には、指定された座標はベースラインの左端の文字位置にあります。
s
- 描画される String
x
- String
が描画される位置の x 座標y
- String
が描画される位置の y 座標
NullPointerException
- str
が null
の場合setPaint(java.awt.Paint)
,
Graphics.setColor(java.awt.Color)
,
Graphics.setFont(java.awt.Font)
,
setTransform(java.awt.geom.AffineTransform)
,
setComposite(java.awt.Composite)
,
Graphics.setClip(int, int, int, int)
public abstract void drawString(AttributedCharacterIterator iterator, int x, int y)
Graphics2D
コンテキストの現在の Paint
を使うことにより、指定された反復子のテキストを描画します。反復子は、各文字のフォントを指定しなければなりません。最初の文字のベースラインは、ユーザ空間の (x, y) に位置します。適用される描画属性には、Clip
、Transform
、Paint
、および Composite
の各属性があります。ヘブライ語やアラビア語などの筆記システムの文字では、グリフは右から左に描画されます。この場合には、指定された座標はベースラインの左端の文字位置にあります。
Graphics
内の drawString
iterator
- 描画されるテキストを持つ反復子x
- 反復子のテキストが描画される x 座標y
- 反復子のテキストが描画される y 座標setPaint(java.awt.Paint)
,
Graphics.setColor(java.awt.Color)
,
setTransform(java.awt.geom.AffineTransform)
,
setComposite(java.awt.Composite)
,
Graphics.setClip(int, int, int, int)
public abstract void drawString(AttributedCharacterIterator iterator, float x, float y)
Graphics2D
コンテキストの現在の Paint
を使うことにより、指定された反復子のテキストを描画します。反復子は各文字のフォントを指定しなければなりません。最初の文字のベースラインは、ユーザ空間の (x, y) に位置します。適用される描画属性には、Clip
、Transform
、Paint
、および Composite
の各属性があります。ヘブライ語やアラビア語などの筆記システムの文字では、グリフは右から左に描画されます。この場合には、指定された座標はベースラインの左端の文字位置にあります。
iterator
- 描画されるテキストを持つ反復子x
- 反復子のテキストが描画される x 座標y
- 反復子のテキストが描画される y 座標setPaint(java.awt.Paint)
,
Graphics.setColor(java.awt.Color)
,
setTransform(java.awt.geom.AffineTransform)
,
setComposite(java.awt.Composite)
,
Graphics.setClip(int, int, int, int)
public abstract void drawGlyphVector(GlyphVector g, float x, float y)
Graphics2D
コンテキストの描画属性を使うことにより、指定された GlyphVector
のテキストを描画します。適用される描画属性には、Clip
、Transform
、Paint
、および Composite
の各属性があります。GlyphVector
は、個々のグリフを Font
から指定します。また、GlyphVector
は、グリフの位置も格納できます。このメソッドを使うと、画面に一連の文字列をもっとも速く描画できます。
g
- 描画される GlyphVector
x
- グリフが描画されるユーザ空間の x 位置y
- グリフが描画されるユーザ空間の y 位置Font.createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)
,
GlyphVector
,
setPaint(java.awt.Paint)
,
Graphics.setColor(java.awt.Color)
,
setTransform(java.awt.geom.AffineTransform)
,
setComposite(java.awt.Composite)
,
Graphics.setClip(int, int, int, int)
public abstract void fill(Shape s)
Graphics2D
コンテキストの設定を使うことにより、Shape
の内部を塗りつぶします。適用される描画属性には、Clip
、Transform
、Paint
、および Composite
の各属性があります。
s
- 塗りつぶされる Shape
setPaint(java.awt.Paint)
,
Graphics.setColor(java.awt.Color)
,
transform(java.awt.geom.AffineTransform)
,
setTransform(java.awt.geom.AffineTransform)
,
setComposite(java.awt.Composite)
,
clip(java.awt.Shape)
,
Graphics.setClip(int, int, int, int)
public abstract boolean hit(Rectangle rect, Shape s, boolean onStroke)
Shape
が指定された Rectangle
(デバイス空間にある) と交差するかどうかを判定します。onStroke
が false の場合、このメソッドは指定された Shape
の内部が指定された Rectangle
と交差するかどうかを調べます。onStroke
が true
の場合、このメソッドは指定された Shape
の輪郭の Stroke
が指定された Rectangle
と交差するかどうかを調べます。考慮される描画属性には、Clip
、Transform
、および Stroke
の各属性があります。
rect
- ヒットを調べるデバイス空間の領域s
- ヒットを調べる Shape
onStroke
- ストロークで描画された形状を調べるか塗りつぶされた形状を調べるかを選択するフラグ。フラグが true
の場合は、Stroke
の輪郭が調べられる。フラグが false
の場合は、塗りつぶされた Shape
が調べられる
true
、そうでない場合は false
setStroke(java.awt.Stroke)
,
fill(java.awt.Shape)
,
draw(java.awt.Shape)
,
transform(java.awt.geom.AffineTransform)
,
setTransform(java.awt.geom.AffineTransform)
,
clip(java.awt.Shape)
,
Graphics.setClip(int, int, int, int)
public abstract GraphicsConfiguration getDeviceConfiguration()
Graphics2D
に関連したデバイス構成を返します。
Graphics2D
属性のデバイス構成public abstract void setComposite(Composite comp)
Graphics2D
コンテキストの Composite
を設定します。Composite
は、drawImage
、drawString
、draw
、および fill
などのすべての描画メソッドで使用されます。Composite
は、グラフィックスデバイスでの描画処理中に新しいピクセルが既存のピクセルとどのように結合されるかを指定します。
この Graphics2D
コンテキストが表示画面の Component
に描画されている場合、Composite
は AlphaComposite
クラスのインスタンスではないカスタムオブジェクトです。セキュリティマネージャがある場合は、セキュリティマネージャの checkPermission
メソッドがアクセス権 AWTPermission("readDisplayPixels")
を指定して呼び出されます。
comp
- 描画に使われる Composite
オブジェクト
SecurityException
- 画面に描画するためにカスタム Composite
オブジェクトが使用されており、セキュリティマネージャが設定されている場合に、セキュリティマネージャの checkPermission
メソッドがこの操作を許可しないときGraphics.setXORMode(java.awt.Color)
,
Graphics.setPaintMode()
,
getComposite()
,
AlphaComposite
,
SecurityManager.checkPermission(java.security.Permission)
,
AWTPermission
public abstract void setPaint(Paint paint)
Graphics2D
コンテキストに Paint
属性を設定します。このメソッドを null
Paint
オブジェクトで呼び出しても、この Graphics2D
の現在の Paint
属性には影響しません。
paint
- 描画プロセスで色を生成するために使われる Paint
オブジェクト、または null
Graphics.setColor(java.awt.Color)
,
getPaint()
,
GradientPaint
,
TexturePaint
public abstract void setStroke(Stroke s)
Graphics2D
コンテキストの Stroke
を設定します。
s
- 描画プロセスで Shape
をストロークで描画するために使われる Stroke
オブジェクトBasicStroke
,
getStroke()
public abstract void setRenderingHint(RenderingHints.Key hintKey, Object hintValue)
RenderingHints
クラスで、共通のキーと値の定義の一部を参照できます。
hintKey
- 設定されるヒントのキーhintValue
- 指定されたヒントカテゴリの推奨設定を示す値getRenderingHint(RenderingHints.Key)
,
RenderingHints
public abstract Object getRenderingHint(RenderingHints.Key hintKey)
RenderingHints
クラスで、共通のキーと値の定義の一部を参照できます。
hintKey
- 取得するヒントに対応するキー
RenderingHints
クラスで定義されているRenderingHints
,
setRenderingHint(RenderingHints.Key, Object)
public abstract void setRenderingHints(Map<?,?> hints)
hints
に置き換えます。描画ヒントの既存の値はすべて破棄され、既知のヒントと値の新しいセットが指定された Map
オブジェクトから初期化されます。Hint カテゴリには、描画品質を制御することと、描画プロセスでの描画速度と描画品質との全体的な妥協点を制御することが含まれます。RenderingHints
クラスで、共通のキーと値の定義の一部を参照できます。
hints
- 設定される描画ヒントgetRenderingHints()
,
RenderingHints
public abstract void addRenderingHints(Map<?,?> hints)
Map
オブジェクトにある描画ヒントの値だけが変更されます。指定されたオブジェクトにない推奨設定は変更されません。Hint カテゴリには、描画品質を制御することと、描画プロセスでの描画速度と描画品質との全体的な妥協点を制御することが含まれます。RenderingHints
クラスで、共通のキーと値の定義の一部を参照できます。
hints
- 設定される描画ヒントRenderingHints
public abstract RenderingHints getRenderingHints()
RenderingHints
クラスで、共通のキーと値の定義の一部を参照できます。
RenderingHints
のインスタンスへの参照RenderingHints
,
setRenderingHints(Map)
public abstract void translate(int x, int y)
Graphics2D
コンテキストの原点を、現在の座標系の点 (x, y) に移動します。Graphics2D
コンテキストを修正して、新しい原点が Graphics2D
コンテキストの元の座標系の点 (x, y) に対応するようにします。このグラフィックスコンテキストでそれ以降の描画操作で使用される座標はすべて、この新しい原点を基準にします。
Graphics
内の translate
x
- 指定された x 座標y
- 指定された y 座標public abstract void translate(double tx, double ty)
Graphics2D
Transform
を移動変換と連結します。以降の描画は、以前の位置を基準に指定された距離で移動します。これは、transform(T) を呼び出すことに相当します。ただし、T は次の行列によって表現される AffineTransform
です。
[ 1 0 tx ] [ 0 1 ty ] [ 0 0 1 ]
tx
- x 軸に沿って移動する距離ty
- y 軸に沿って移動する距離public abstract void rotate(double theta)
Graphics2D
Transform
を回転変換と連結します。以降の描画は、以前の原点を基準に指定されたラジアンで回転します。これは、transform(R)
を呼び出すことに相当します。ただし、R は次の行列によって表現される AffineTransform
です。
[ cos(theta) -sin(theta) 0 ] [ sin(theta) cos(theta) 0 ] [ 0 0 1 ]正の角度 theta で回転すると、正の x 軸の点が正の y 軸に向かって回転されます。
theta
- ラジアンで表した回転角度public abstract void rotate(double theta, double x, double y)
Graphics2D
Transform
を移動後の回転変換と連結します。以降の描画は、指定された位置に移動し、指定されたラジアンで回転し、元の平行移動と同じ量で平行移動し直すことで作成される変換によって変換されます。これは、次の呼び出しシーケンスに相当します。
translate(x, y); rotate(theta); translate(-x, -y);正の角度 theta で回転すると、正の x 軸の点が正の y 軸に向かって回転されます。
theta
- ラジアンで表した回転角度x
- 回転の原点の x 座標y
- 回転の原点の y 座標public abstract void scale(double sx, double sy)
Graphics2D
Transform
をスケーリング変換と連結します。以降の描画は、以前のスケーリングを基準に指定されたスケーリング係数に従ってサイズ変更されます。これは、transform(S)
を呼び出すことに相当します。ただし、S は次の行列によって表現される AffineTransform
です。
[ sx 0 0 ] [ 0 sy 0 ] [ 0 0 1 ]
sx
- 以降の描画操作の X 座標が以前の描画操作を基準に乗算される量sy
- 以降の描画操作の Y 座標が以前の描画操作を基準に乗算される量public abstract void shear(double shx, double shy)
Graphics2D
Transform
をシャーリング変換と連結します。以降の描画は、以前の位置を基準に指定された乗数でシャーリングされます。これは、transform(SH)
を呼び出すことに相当します。ただし、SH は次の行列によって表現される AffineTransform
です。
[ 1 shx 0 ] [ shy 1 0 ] [ 0 0 1 ]
shx
- Y 座標の関数として、座標を正の X 軸方向にシフトするための乗数shy
- X 座標の関数として、座標を正の Y 軸方向にシフトするための乗数public abstract void transform(AffineTransform Tx)
AffineTransform
オブジェクトをこの Graphics2D
での Transform
を使って、後指定優先適用という規則に従って変換します。現在の Transform
が Cx である場合、Tx による変換の結果は新しい Transform
Cx' になります。Cx' は、この Graphics2D
用の現在の Transform
になります。更新された Transform
Cx' で点 p を変換することは、最初に Tx で p を変換してから、その結果を元の Transform
Cx で変換することに相当します。つまり、Cx'(p) = Cx(Tx(p)) です。必要に応じて Tx のコピーを行うと、Tx をそれ以上修正しても描画に影響しません。
Tx
- 現在の Transform
で変換される AffineTransform
オブジェクトsetTransform(java.awt.geom.AffineTransform)
,
AffineTransform
public abstract void setTransform(AffineTransform Tx)
Graphics2D
コンテキストで Transform を上書きします。警告: このメソッドは新しい座標変換を既存の変換上で適用する目的では使用しないでください。これは、Graphics2D
には、Swing コンポーネントの描画またはプリンタの解像度を調整するためのスケーリング変換の適用など、他の目的のために必要な変換がすでに含まれているからです。
座標変換を追加するために、transform
、rotate
、scale
、またはshear
メソッドを使用します。setTransform
は、この例で示されているとおり、描画終了後に元の Graphics2D
変換を復元するためだけに使用されます。
// Get the current transform AffineTransform saveAT = g2.getTransform(); // Perform transformation g2d.transform(...); // Render g2d.draw(...); // Restore original transform g2d.setTransform(saveAT);
Tx
- getTransform
メソッドから取得された AffineTransform
transform(java.awt.geom.AffineTransform)
,
getTransform()
,
AffineTransform
public abstract AffineTransform getTransform()
Graphics2D
コンテキストでの現在の Transform
のコピーを返します。
Graphics2D
コンテキストでの現在の AffineTransform
transform(java.awt.geom.AffineTransform)
,
setTransform(java.awt.geom.AffineTransform)
public abstract Paint getPaint()
Graphics2D
コンテキストでの現在の Paint
を返します。
Graphics2D
Paint
setPaint(java.awt.Paint)
,
Graphics.setColor(java.awt.Color)
public abstract Composite getComposite()
Graphics2D
コンテキストでの現在の Composite
を返します。
Graphics2D
Composite
setComposite(java.awt.Composite)
public abstract void setBackground(Color color)
Graphics2D
コンテキストのバックグラウンドカラーを設定します。バックグラウンドカラーは、領域をクリアするために使われます。Graphics2D
を Component
用に作成すると、バックグラウンドカラーが Component
から継承されます。Graphics2D
コンテキストでのバックグラウンドカラーを設定しても、それ以降の clearRect()
呼び出しに作用するだけで、Component
のバックグラウンドカラーには影響を及ぼしません。Component
のバックグラウンドを変更するには、Component
の適切なメソッドを使用します。
color
- 以降の clearRect()
の呼び出しで使用されるバックグラウンドカラーgetBackground()
,
Graphics.clearRect(int, int, int, int)
public abstract Color getBackground()
Graphics2D
Color
setBackground(java.awt.Color)
public abstract Stroke getStroke()
Graphics2D
コンテキストでの現在の Stroke
を返します。
Graphics2D
Stroke
setStroke(java.awt.Stroke)
public abstract void clip(Shape s)
Clip
を指定された Shape
の内部と交差させて、結果として生じた共通部分にその Clip
を設定します。指定された Shape
は、現在の Clip
と交差する前に、現在の Graphics2D
Transform
を使って変換されます。このメソッドを使うと、現在の Clip
を小さくできます。Clip
を大きくするには、setClip
メソッドを使います。このメソッドによって変更されたユーザクリップは、デバイスの境界および可視性と関連したクリッピングとは無関係です。これまでに設定されているクリップがない場合、または setClip
に null
引数を使ってクリップがクリアされている場合は、指定された Shape
が新しいユーザクリップになります。
s
- 現在の Clip
と交差する Shape
。s
が null
の場合、このメソッドは現在の Clip
をクリアするpublic abstract FontRenderContext getFontRenderContext()
Graphics2D
コンテキストでの Font
の描画コンテキストを返します。FontRenderContext
は、アンチエイリアスや部分メトリックスなどのアプリケーションヒントのほか、ターゲットデバイスに特有の解像度 (dpi) などの情報をカプセル化します。こうした情報は、Font
や TextLayout
などの文字体裁のフォーマットを実行するオブジェクトの使用時にアプリケーションによって提供されます。この情報はまた、各種描画ヒントがテキスト描画に適用されたときに、それ自体のレイアウトを実行し、有効幅や行の高さなど、グリフの各種特性の正確な計測を必要とするアプリケーションによって提供されなければなりません。
FontRenderContext
,
Font.createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)
,
TextLayout
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。