java.awt.font

クラス LayoutPath

java.lang.Object

java.awt.font.LayoutPath

public abstract class LayoutPath
extends Object

LayoutPath は、ベースラインを基準にした位置とユーザー空間内のポイントとのマッピングを提供します。位置は、ベースラインに沿った有効幅と、その有効幅でのベースラインに対する垂線に沿ったオフセットで構成されます。垂線に沿って正の値は、ベースラインベクトルから時計回りに 90 度の方向です。位置は Point2D として表され、その x 座標は有効幅、y 座標はオフセットです。

導入されたバージョン:

1.6

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
LayoutPath()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract void	pathToPoint(Point2D location, boolean preceding, Point2D point) パスを基準にした位置を、ユーザー座標内のポイントに変換します。
abstract boolean	pointToPath(Point2D point, Point2D location) ユーザー空間内のポイントを、パスを基準にした位置に変換します。

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

LayoutPath

public LayoutPath()

メソッドの詳細

pointToPath

public abstract boolean pointToPath(Point2D point,
                  Point2D location)

ユーザー空間内のポイントを、パスを基準にした位置に変換します。この位置は、ポイントからパスまでの距離が最小になるように選択されます (つまり、オフセットの絶対値が最小になる)。そのような位置が複数ある場合は、最小の有効幅を持つものが選択されます。

パラメータ:

point - 変換対象のポイント。location と同じオブジェクトでない場合、この呼び出しによってポイントは変更されない。

location - 返される位置を保持する Point2D。point と同じオブジェクトでもよい。

戻り値:

ポイントが、位置に先行するパスの部分に関連付けられている場合は true、後続の部分に関連付けられている場合は false。デフォルトでは、位置がパス内の分割点や急な屈曲点に当たらない場合、true を返す。

例外:

NullPointerException - point または location が null の場合

導入されたバージョン:

1.6

pathToPoint

public abstract void pathToPoint(Point2D location,
               boolean preceding,
               Point2D point)

パスを基準にした位置を、ユーザー座標内のポイントに変換します。その位置の有効幅に当たるところで、パスが急に屈曲している場合や、不連続になっている場合があります。この場合は、preceding の値によってパスの部分が明確に指定され、その位置と傾きによってオフセットが解釈されます。

パラメータ:

location - パスを基準にした位置の有効幅 (x 座標) とオフセット (y 座標) を表す Point2D。位置が point と同じオブジェクトでない場合、この呼び出しによって位置は変更されない。

preceding - true の場合は有効幅に先行するパスの部分を使用し、false の場合は後続の部分を使用する。有効幅に当たるところでパスが分割されたり急に屈曲したりしていない場合、この値は効果を持たない。

point - 返されるポイントを保持する Point2D。location と同じオブジェクトでもよい。

例外:

NullPointerException - location または point が null の場合

導入されたバージョン:

1.6