描画領域をビットマップイメージで塗りつぶします。ビットマップを繰り返すか、タイリング表示して、領域を塗りつぶすことができます。beginFill()、beginBitmapFill()、または beginGradientFill() メソッドを呼び出すまで、塗りは有効のままです。clear() メソッドを呼び出すと、塗りがクリアされます。

endFill() メソッドが呼び出されるまで、塗りはレンダリングされません(drawCircle()、drawEllipse()、drawRect()、および drawRoundRect() メソッドは、自動的に endFill() メソッドを呼び出します)。

  matrix = new flash.geom.Matrix(); 
  matrix.rotate(Math.PI/4);
  

関連項目

オブジェクトの他の Graphics メソッド (lineTo() や drawCircle() など) に対する今後の呼び出しに使用する単純な単色塗りを指定します。beginFill()、beginBitmapFill()、または beginGradientFill() メソッドを呼び出すまで、塗りは有効のままです。clear() メソッドを呼び出すと、塗りがクリアされます。

endFill() メソッドが呼び出されるまで、塗りはレンダリングされません(drawCircle()、drawEllipse()、drawRect()、および drawRoundRect() メソッドは、自動的に endFill() メソッドを呼び出します)。

関連項目

オブジェクトの他の Graphics メソッド (lineTo() や drawCircle() など) に対する今後の呼び出しに使用するグラデーション塗りを指定します。beginFill()、beginBitmapFill()、または beginGradientFill() メソッドを呼び出すまで、塗りは有効のままです。clear() メソッドを呼び出すと、塗りがクリアされます。

endFill() メソッドが呼び出されるまで、塗りはレンダリングされません(drawCircle()、drawEllipse()、drawRect()、および drawRoundRect() メソッドは、自動的に endFill() メソッドを呼び出します)。

	type:String — 使用するグラデーションのタイプを指定する GradientType クラスの値は、次のとおりです。GradientType.LINEAR または GradientType.RADIAL。
	colors:Array — グラデーションで使用する RGB 16 進カラー値の配列 (赤 0xFF0000、青 0x0000FF など)。最大 15 色まで指定できます。各色について、alphas パラメータと ratios パラメータで対応する値を必ず指定してください。
	alphas:Array — colors 配列内の各色に対応するアルファ値の配列。有効な値は 0 ～ 1 です。0 未満の値の場合は、デフォルトで 0 が適用されます。1 より大きい値の場合は、デフォルトで 1 が適用されます。
	ratios:Array — 色分布の比率の配列。有効な値は 0 ～ 255 です。この値は、100% でサンプリングされる色の幅の割合をパーセントで定義します。値 0 はグラデーションボックスの左の位置を表し、255 はグラデーションボックスの右の位置を表します。 メモ: この値は、グラデーションボックス内の位置を表すもので、最終グラデーションの座標空間を表すものではありません。最終グラデーションは、グラデーションボックスより広くなったり狭くなったりする場合があります。colors パラメータの値ごとに、値を指定してください。 たとえば、青と緑の 2 色を含む線状グラデーションの場合、次の例は、ratios 配列のさまざまな値に基づいて配置される色を示します。 ratios グラデーション [0, 127] [0, 255] [127, 255] 配列内の値は、[0, 63, 127, 190, 255] のように順に増やしていく必要があります。
	matrix:Matrix (default = null) — flash.geom.Matrix クラスで定義される変換マトリックスです。flash.geom.Matrix クラスには、createGradientBox() メソッドがあります。このメソッドを使用すると、beginGradientFill() メソッドで使用できるマトリックスを容易に設定できます。
	spreadMethod:String (default = "pad") — 使用する spread メソッドを指定する SpreadMethod クラスの値は、次のいずれかです。SpreadMethod.PAD、SpreadMethod.REFLECT、または SpreadMethod.REPEAT。 たとえば、2 つの色の間にシンプルな線状グラデーションがあるとします。 import flash.geom.* import flash.display.* var fillType:String = GradientType.LINEAR; var colors:Array = [0xFF0000, 0x0000FF]; var alphas:Array = [100, 100]; var ratios:Array = [0x00, 0xFF]; var matr:Matrix = new Matrix(); matr.createGradientBox(20, 20, 0, 0, 0); var spreadMethod:String = SpreadMethod.PAD; this.graphics.beginGradientFill(fillType, colors, alphas, ratios, matr, spreadMethod); this.graphics.drawRect(0,0,100,100); この例では spread メソッドに SpreadMethod.PAD を使用しているため、グラデーションの塗りは次のようになります。 spread メソッドに SpreadMethod.REFLECT を使用する場合、グラデーションの塗りは次のようになります。 spread メソッドに SpreadMethod.REPEAT を使用する場合、グラデーションの塗りは次のようになります。
	interpolationMethod:String (default = "rgb") — 使用する値を指定する InterpolationMethod クラスの値は、次のとおりです。InterpolationMethod.linearRGB または InterpolationMethod.RGB たとえば、2 つの色の間に、spreadMethod パラメータが SpreadMethod.REFLECT に設定されたシンプルな線状グラデーションがあるとします。それぞれの補間方法で、外観に次のような影響があります。 InterpolationMethod.LINEAR_RGB InterpolationMethod.RGB
	focalPointRatio:Number (default = 0) — グラデーションの焦点の位置を表す数値です。0 は焦点が中央にあること、1 は焦点がグラデーション円のいずれかの境界にあること、-1 は焦点がグラデーション円のもう一方の境界にあることを示します。-1 未満または 1 より大きい値は、-1 または 1 に丸められます。たとえば、次の例では、focalPointRatio が 0.75 に設定されています。

関連項目

この Graphics オブジェクトに描画されているグラフィックをクリアし、塗りと線のスタイルの設定をリセットします。

(controlX, controlY) で指定されたコントロールポイントを使用し、現在の描画位置から (anchorX, anchorY) まで、現在の線のスタイルで曲線を描画します。その後、現在の描画位置は (anchorX, anchorY) に設定されます。描画先のムービークリップに Flash の描画ツールで作成したコンテンツが含まれている場合は、curveTo() メソッドへの呼び出しの結果はこのコンテンツの下に描画されます。moveTo() メソッドを呼び出す前に curveTo() メソッドを呼び出すと、現在の描画位置はデフォルトで (0,0) になります。いずれかのパラメータを省略すると、このメソッドは失敗し、現在の描画位置は変更されません。

描画される曲線は、二次ベジェ曲線です。二次ベジェ曲線は、2 つのアンカーポイントと 1 つのコントロールポイントで構成されています。曲線は、2 つのアンカーポイントを補間し、コントロールポイントに向かいます。

円を描画します。drawCircle() メソッドを呼び出す前に、linestyle()、lineGradientStyle()、beginFill()、beginGradientFill()、または beginBitmapFill() メソッドを呼び出して、線のスタイルまたは塗り、あるいはその両方を設定する必要があります。

関連項目

楕円を描画します。drawEllipse() メソッドを呼び出す前に、linestyle()、lineGradientStyle()、beginFill()、beginGradientFill()、または beginBitmapFill() メソッドを呼び出して、線のスタイルまたは塗り、あるいはその両方を設定する必要があります。

関連項目

矩形を描画します。drawRect() メソッドを呼び出す前に、linestyle()、lineGradientStyle()、beginFill()、beginGradientFill()、または beginBitmapFill() メソッドを呼び出して、線のスタイルまたは塗り、あるいはその両方を設定する必要があります。

関連項目

角丸矩形を描画します。drawRoundRect() メソッドを呼び出す前に、linestyle()、lineGradientStyle()、beginFill()、beginGradientFill()、または beginBitmapFill() メソッドを呼び出して、線のスタイルまたは塗り、あるいはその両方を設定する必要があります。

関連項目

beginFill()、beginGradientFill()、または beginBitmapFill() メソッドへの最後の呼び出し以降に追加された線と曲線に塗りを適用します。適用される塗りは、beginFill()、beginGradientFill()、または beginBitmapFill() メソッドの前回の呼び出しで指定されたものです。現在の描画位置が moveTo() メソッドの直前の呼び出しで指定された座標と等しくない場合、塗りが定義されていれば、パスが線で閉じられた後、塗りが適用されます。

関連項目

オブジェクトの他の Graphics メソッド (lineTo() や drawCircle() など) に対する今後の呼び出しに使用する線スタイルのグラデーションを指定します。線のスタイルは、lineStyle() メソッドまたは lineGradientStyle() メソッドを異なるパラメータで呼び出すまで有効のままです。パスの描画中に lineGradientStyle() メソッドを呼び出し、パス内の線のセグメントごとに異なるスタイルを指定できます。

lineGradientStyle() を呼び出す前に lineStyle() を呼び出して線を有効にします。そうしないと、線のスタイルが undefined のままになります。

clear() を呼び出すと、線のスタイルが undefined に戻ります。

	type:String — 使用するグラデーションのタイプを指定する GradientType クラスの値は、GradientType.LINEAR または GradientType.RADIAL のいずれかです。
	colors:Array — グラデーションで使用する RGB 16 進カラー値の配列 (赤 0xFF0000、青 0x0000FF など)。
	alphas:Array — colors 配列内の各色に対応するアルファ値の配列。有効な値は 0 ～ 100 です。0 未満の値の場合は 0 が、100 を超える値の場合は 100 が適用されます。
	ratios:Array — 色分布の比率の配列。有効な値は 0 ～ 255 です。この値は、100% でサンプリングされる色の幅の割合をパーセントで定義します。値 0 はグラデーションボックスの左の位置を表し、255 はグラデーションボックスの右の位置を表します。この値は、グラデーションボックス内の位置を表すもので、最終グラデーションの座標空間を表すものではありません。最終グラデーションは、グラデーションボックスより広くなったり狭くなったりする場合があります。colors パラメータの値ごとに、値を指定してください。 たとえば、青と緑の 2 色を含む線状グラデーションの場合、次の図は、ratios 配列のさまざまな値に基づいて配置される色を示します。 ratios グラデーション [0, 127] [0, 255] [127, 255] 配列内の値は、[0, 63, 127, 190, 255] のように順に増やしていく必要があります。
	matrix:Matrix (default = null) — flash.geom.Matrix クラスで定義される変換マトリックスです。flash.geom.Matrix クラスには、createGradientBox() メソッドがあります。このメソッドを使用すると、lineGradientStyle() メソッドで使用できるマトリックスを容易に設定できます。
	spreadMethod:String (default = "pad") — 使用する spread メソッドを指定する SpreadMethod クラスの値は、次のとおりです。 SpreadMethod.PAD SpreadMethod.REFLECT SpreadMethod.REPEAT
	interpolationMethod:String (default = "rgb") — 使用する値を指定する InterpolationMethod クラスの値です。たとえば、2 つの色の間に、spreadMethod パラメータが SpreadMethod.REFLECT に設定されたシンプルな線状グラデーションがあるとします。それぞれの補間方法で、外観に次のような影響があります。 InterpolationMethod.LINEAR_RGB InterpolationMethod.RGB
	focalPointRatio:Number (default = 0) — グラデーションの焦点の位置を表す数値です。0 は焦点が中央にあること、1 は焦点がグラデーション円のいずれかの境界にあること、-1 は焦点がグラデーション円のもう一方の境界にあることを示します。-1 未満の値は -1 に、1 より大きい値は 1 に丸められます。次のイメージは、focalPointRatio を -0.75 に設定したグラデーションを示しています。

関連項目

オブジェクトの他の Graphics メソッド (lineTo() や drawCircle() など) に対する今後の呼び出しに使用する線のスタイルを指定します。線のスタイルは、lineGradientStyle() メソッドまたは lineStyle() メソッドを異なるパラメータで呼び出すまで有効のままです。パスの描画中に lineStyle() メソッドを呼び出し、パス内の線のセグメントごとに異なるスタイルを指定できます。

メモ :clear() メソッドを呼び出すと、線のスタイルが undefined に戻ります。

関連項目

現在の描画位置から (x, y) まで、現在の線のスタイルを使用して線を描画します。その後で、現在の描画位置は (x, y) に設定されます。描画先の表示オブジェクトに Flash の描画ツールで作成したコンテンツが含まれている場合、lineTo() メソッドへの呼び出しの結果はこのコンテンツの下に描画されます。moveTo() メソッドを呼び出す前に lineTo() を呼び出すと、現在の描画位置はデフォルトで (0,0) になります。いずれかのパラメータを省略すると、このメソッドは失敗し、現在の描画位置は変更されません。

現在の描画位置を (x, y) に移動します。いずれかのパラメータを省略すると、このメソッドは失敗し、現在の描画位置は変更されません。

1. 後で各シェイプのサイズを決定する際に使用する size プロパティを宣言します。
2. 背景色をオレンジ色、境界線色を 濃い灰色、境界線のサイズを 0 ピクセル、角丸の半径を 9 ピクセル、 ステージの端と他のオブジェクトの間のスペースを 5 ピクセルに、それぞれ設定するプロパティを宣言します。
3. 上記の手順で宣言したプロパティを Graphics クラスのビルトインメソッドとともに使用して、円、角丸矩形、および四角形を、座標 x = 0、y = 0 に描画します。
4. ステージの一番上に配置された各シェイプを、x = 5、y = 5 から、 シェイプ間のスペースを 5 ピクセルにして再描画します。

package {
    import flash.display.DisplayObject;
    import flash.display.Graphics;
    import flash.display.Shape;
    import flash.display.Sprite;

    public class GraphicsExample extends Sprite {
        private var size:uint         = 80;
        private var bgColor:uint      = 0xFFCC00;
        private var borderColor:uint  = 0x666666;
        private var borderSize:uint   = 0;
        private var cornerRadius:uint = 9;
        private var gutter:uint       = 5;

        public function GraphicsExample() {
            doDrawCircle();
            doDrawRoundRect();
            doDrawRect();
            refreshLayout();
        }

        private function refreshLayout():void {
            var ln:uint = numChildren;
            var child:DisplayObject;
            var lastChild:DisplayObject = getChildAt(0);
            lastChild.x = gutter;
            lastChild.y = gutter;
            for (var i:uint = 1; i < ln; i++) {
                child = getChildAt(i);
                child.x = gutter + lastChild.x + lastChild.width;
                child.y = gutter;
                lastChild = child;
            }
        }

        private function doDrawCircle():void {
            var child:Shape = new Shape();
            var halfSize:uint = Math.round(size / 2);
            child.graphics.beginFill(bgColor);
            child.graphics.lineStyle(borderSize, borderColor);
            child.graphics.drawCircle(halfSize, halfSize, halfSize);
            child.graphics.endFill();
            addChild(child);
        }

        private function doDrawRoundRect():void {
            var child:Shape = new Shape();
            child.graphics.beginFill(bgColor);
            child.graphics.lineStyle(borderSize, borderColor);
            child.graphics.drawRoundRect(0, 0, size, size, cornerRadius);
            child.graphics.endFill();
            addChild(child);
        }

        private function doDrawRect():void {
            var child:Shape = new Shape();
            child.graphics.beginFill(bgColor);
            child.graphics.lineStyle(borderSize, borderColor);
            child.graphics.drawRect(0, 0, size, size);
            child.graphics.endFill();
            addChild(child);
        }
    }
}