パッケージflash.display
クラスpublic final class GraphicsStroke
継承GraphicsStroke Inheritance Object
実装 IGraphicsStroke, IGraphicsData

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

線のスタイルを定義します。

GraphicsStroke オブジェクトは、Graphics.drawGraphicsData() メソッドと共に使用します。GraphicsStroke オブジェクトの描画は、線スタイルを設定する Graphics クラスのメソッドの呼び出しに相当します。例えば、Graphics.lineStyle() メソッド、Graphics.lineBitmapStyle() メソッド、Graphics.lineGradientStyle() メソッドなどがあります。

関連項目

flash.display.Graphics.lineStyle()
flash.display.Graphics.lineBitmapStyle()
flash.display.Graphics.lineGradientStyle()
flash.display.Graphics.drawGraphicsData()


パブリックプロパティ
 プロパティ定義元
  caps : String
線の終端のキャップの種類を指定します。
GraphicsStroke
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  fill : IGraphicsFill
線を塗りつぶすためのデータを格納しているインスタンスを表します。
GraphicsStroke
  joints : String
角で使用する接合点の外観の種類を指定します。
GraphicsStroke
  miterLimit : Number
マイターが切り取られる限度を示します。
GraphicsStroke
  pixelHinting : Boolean
ピクセル全体に対して線をヒンティングするかどうかを指定します。
GraphicsStroke
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  scaleMode : String
線の太さの拡大 / 縮小を表します。
GraphicsStroke
  thickness : Number
線の太さをポイント単位で示します。有効な値は 0 ~ 255 です。
GraphicsStroke
パブリックメソッド
 メソッド定義元
  
GraphicsStroke(thickness:Number = NaN, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null)
新しい GraphicsStroke オブジェクトを作成します。
GraphicsStroke
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
capsプロパティ
caps:String

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

線の終端のキャップの種類を指定します。有効な値は次のとおりです。CapsStyle.NONECapsStyle.ROUND、および CapsStyle.SQUARE。この値を指定しない場合は、丸いキャップが使用されます。

例えば、次の図は capsStyle のさまざまな設定を示します。それぞれの設定で、図の青い線は太さ 30 で、capsStyle が適用されています。重ね合わせた黒い線は太さ 1 で、capsStyle は適用されていません。

NONE、ROUND、および SQUARE



実装
    public function get caps():String
    public function set caps(value:String):void

関連項目

fillプロパティ 
public var fill:IGraphicsFill

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

線を塗りつぶすためのデータを格納しているインスタンスを表します。IGraphicsFill インスタンスは、一連の塗りコマンドを表す場合があります。

関連項目

jointsプロパティ 
joints:String

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

角で使用する接合点の外観の種類を指定します。有効な値は次のとおりです。JointStyle.BEVELJointStyle.MITER、および JointStyle.ROUND。この値を指定しないと、角丸 ("round") の接合点が使用されます。

例えば、次の図は joints のさまざまな設定を示します。それぞれの設定で、角のある青い線は太さ 30 で、jointStyle が適用されています。重ね合わせた黒い線は太さ 1 で、jointStyle は適用されていません。

MITER、ROUND、および BEVEL

メモ : jointsJointStyle.MITER に設定すると、miterLimit パラメータを使用して、マイターの長さを制限できます。



実装
    public function get joints():String
    public function set joints(value:String):void

関連項目

miterLimitプロパティ 
public var miterLimit:Number

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

マイターが切り取られる限度を示します。有効な値の範囲は 1 ~ 255 で、この範囲を超えた値は 1 または 255 に丸められます。この値は、jointStyle"miter" に設定した場合にのみ有効です。miterLimit の値により、線の接合点を越えてマイターを延長できる長さが決定します。マイターを延長できる長さは、この値と線の thickness が乗算されたものです。たとえば、miterLimit の値が 2.5 で、thickness が 10 ピクセルの場合、マイターは 25 ピクセルで切り取られます。

例として、次のような角のある線を考えます。どの線も thickness を 20 に設定して描画されていますが、miterLimit はそれぞれ 1、2、4 に設定されています。重ね合わされた黒の基準線は、接合点を示しています。

miterLimit が 1、2、および 4 に設定されている線

miterLimit のそれぞれの値には、マイターが切り取られる独自の最大角度があります。次の表に、いくつかの例を示します。

miterLimit の値 : 角度が以下より小さい場合は切り取られる
1.41490 度
260 度
430 度
815 度

pixelHintingプロパティ 
public var pixelHinting:Boolean

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ピクセル全体に対して線をヒンティングするかどうかを指定します。この値は、曲線のアンカーの位置と線のサイズ自身の両方に影響を与えます。pixelHintingtrue に設定すると、全ピクセル幅に線幅がヒンティングされます。pixelHintingfalse に設定すると、曲線と直線で非連続が発生することがあります。例えば、次の図は、pixelHinting パラメータ (lineStyle() メソッドで使用) の設定が異なるだけで他はまったく同じ 2 つの角丸矩形がどのようにレンダリングされるかを示したものです (違いが分かるようにイメージは 200% に拡大されています)。

pixelHinting false および pixelHinting true

scaleModeプロパティ 
scaleMode:String

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

線の太さの拡大 / 縮小を表します。有効な値は次のとおりです。



実装
    public function get scaleMode():String
    public function set scaleMode(value:String):void

関連項目

thicknessプロパティ 
public var thickness:Number

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

線の太さをポイント単位で示します。有効な値は 0 ~ 255 です。パラメータが undefined である場合は、線は描画されません。0 未満の値を指定した場合は、デフォルトで 0 が適用されます。0 は極細線です。最大の太さは 255 です。255 を超える値を指定した場合は、デフォルトで 255 が適用されます。

コンストラクタの詳細
GraphicsStroke()コンストラクタ
public function GraphicsStroke(thickness:Number = NaN, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null)

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

新しい GraphicsStroke オブジェクトを作成します。

パラメータ
thickness:Number (default = NaN) — 線の太さをポイント単位で示す整数。有効な値は 0 ~ 255 です。パラメータが undefined である場合は、線は描画されません。0 未満の値を指定した場合は、デフォルトで 0 が適用されます。0 は極細線です。最大の太さは 255 です。255 を超える値を指定した場合は、デフォルトで 255 が適用されます。
 
pixelHinting:Boolean (default = false) — ピクセル全体に対して線をヒンティングするかどうかを指定するブール値。この値は、曲線のアンカーの位置と線のサイズ自身の両方に影響を与えます。pixelHintingtrue に設定すると、全ピクセル幅に線幅がヒンティングされます。pixelHintingfalse に設定すると、曲線と直線で非連続が発生することがあります。例えば、次の図は、pixelHinting パラメータ (lineStyle() メソッドで使用) の設定が異なるだけで他はまったく同じ 2 つの角丸矩形がどのようにレンダリングされるかを示したものです (違いが分かるようにイメージは 200% に拡大されています)。

pixelHinting false および pixelHinting true

値を指定しない場合、線でピクセルのヒンティングが使用されません。

 
scaleMode:String (default = "normal") — 使用する拡大・縮小モードを指定する LineScaleMode クラスの値です。
  • LineScaleMode.NORMAL — オブジェクトが拡大 / 縮小される場合、常に線の太さが拡大 / 縮小されます (デフォルト) 。
  • LineScaleMode.NONE — 線の太さを拡大 / 縮小しません。
  • LineScaleMode.VERTICAL — オブジェクトを垂直方向にのみ拡大 / 縮小する場合は、線の太さを拡大 / 縮小しません。たとえば、次に示す各円は、1 ピクセルの線で描画され、それぞれ scaleMode パラメータが LineScaleMode.VERTICAL に設定されているとします。左側の円は垂直方向にのみ拡大または縮小され、右側の円は垂直と水平の両方向に拡大または縮小されたものです。

    1 つの円は垂直方向に拡大または縮小され、もう 1 つの円は垂直と水平の両方向に拡大または縮小されています。

  • LineScaleMode.HORIZONTAL — オブジェクトを水平方向にのみ拡大 / 縮小する場合は、線の太さを拡大 / 縮小しません。たとえば、次に示す各円は、1 ピクセルの線で描画され、それぞれ scaleMode パラメータが LineScaleMode.HORIZONTAL に設定されているとします。左側の円は水平方向にのみ拡大または縮小され、右側の円は垂直と水平の両方向に拡大または縮小されたものです。

    1 つの円は水平方向に拡大または縮小され、もう 1 つの円は垂直と水平の両方向に拡大または縮小されています。

 
caps:String (default = "none") — 線の終端のキャップの種類を指定する CapsStyle クラスの値です。有効な値は次のとおりです。CapsStyle.NONECapsStyle.ROUND、および CapsStyle.SQUARE。この値を指定しない場合は、丸いキャップが使用されます。

例えば、次の図は capsStyle のさまざまな設定を示します。それぞれの設定で、図の青い線は太さ 30 で、capsStyle が適用されています。重ね合わせた黒い線は太さ 1 で、capsStyle は適用されていません。

NONE、ROUND、および SQUARE

 
joints:String (default = "round") — 角で使用する接合点の外観の種類を指定する JointStyle クラスの値です。有効な値は次のとおりです。JointStyle.BEVELJointStyle.MITER、および JointStyle.ROUND。この値を指定しないと、角丸 ("round") の接合点が使用されます。

例えば、次の図は joints のさまざまな設定を示します。それぞれの設定で、角のある青い線は太さ 30 で、jointStyle が適用されています。重ね合わせた黒い線は太さ 1 で、jointStyle は適用されていません。

MITER、ROUND、および BEVEL

メモ : jointsJointStyle.MITER に設定すると、miterLimit パラメータを使用して、マイターの長さを制限できます。

 
miterLimit:Number (default = 3.0) — マイターが切り取られる限度を示す数値です。有効な値の範囲は 1 ~ 255 で、この範囲を超えた値は 1 または 255 に丸められます。この値は、jointStyle"miter" に設定した場合にのみ有効です。miterLimit の値により、線の接合点を越えてマイターを延長できる長さが決定します。マイターを延長できる長さは、この値と線の thickness が乗算されたものです。たとえば、miterLimit の値が 2.5 で、thickness が 10 ピクセルの場合、マイターは 25 ピクセルで切り取られます。

例として、次のような角のある線を考えます。どの線も thickness を 20 に設定して描画されていますが、miterLimit はそれぞれ 1、2、4 に設定されています。重ね合わされた黒の基準線は、接合点を示しています。

miterLimit が 1、2、および 4 に設定されている線

miterLimit のそれぞれの値には、マイターが切り取られる独自の最大角度があります。次の表に、いくつかの例を示します。

miterLimit の値 : 角度が以下より小さい場合は切り取られる
1.41490 度
260 度
430 度
815 度
 
fill:IGraphicsFill (default = null) — 線を塗りつぶすためのデータを格納している IGraphicsFill インスタンス。IGraphicsFill インスタンスは、一連の塗りコマンドを表す場合があります。

関連項目





 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/display/GraphicsStroke.html