This page was saved using jaction on 2006-09-04 8:33:43.
Address: http://flexdocs.kr/docs/flex2/langref/flash/display/Graphics.html
Title: flash.display.Graphics (Flex™ 2 레퍼런스 가이드)  •  Size: 87238
Packageflash.display
Classpublic final class Graphics
InheritanceGraphics Inheritance Object

Graphics 클래스에는, 벡터 셰이프의 작성에 사용할 수 있는 일련의 Methods가 있습니다. 묘화를 지원(support)하는 표시 object에는, Sprite 및 Shape object가 있습니다. 이러한 각 클래스에는, Graphics object인 graphics property가 있습니다. 이하는, 간단하게 사용할 수 있도록(듯이) 준비되어 있는 헬퍼 함수의 일례입니다. drawRect(),drawRoundRect(),drawCircle(), 및 drawEllipse().

ActionScript 코드로부터 직접 Graphics object를 작성할 수 없습니다. new Graphics() 를 호출하면, 예외가 슬로우 됩니다.

Graphics 클래스는 final 클래스이기 (위해)때문에, 서브 클래스화할 수 없습니다.

View the examples

See also

벡터 그래픽의 묘화


Public property
 property정의
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
Public Methods
 Methods정의
  beginBitmapFill (bitmap:BitmapData , matrix:Matrix = null, repeat:Boolean = true, smooth:Boolean = false):void
묘화 area를 비트 맵 이미지로 전부 칠합니다.
Graphics
  beginFill (color:uint , alpha:Number = 1.0):void
object의 다른 Graphics Methods (lineTo()drawCircle() 등)에 대한 향후의 호출해에 사용하는 단순한 단색 칠을 지정합니다.
Graphics
  beginGradientFill (type:String , colors:Array , alphas:Array , ratios:Array , matrix:Matrix = null, spreadMethod:String = "pad", interpolationMethod:String = "rgb", focalPointRatio:Number = 0):void
object의 다른 Graphics Methods (lineTo()drawCircle() 등)에 대한 향후의 호출해에 사용하는 그라데이션 칠을 지정합니다.
Graphics
  clear ():void
이 Graphics object에 묘화 되고 있는 그래픽을 클리어 해, 칠과 선의 스타일의 설정을 리셋트 합니다.
Graphics
  curveTo (controlX:Number , controlY:Number , anchorX:Number , anchorY:Number ):void
(controlX, controlY)(으)로 지정된 컨트롤 포인트를 사용해, 현재의 묘화 위치로부터 (anchorX, anchorY)까지, 현재의 선의 스타일로 곡선을 묘화 합니다.
Graphics
  drawCircle (x:Number , y:Number , radius:Number ):void
엔을 묘화 합니다.
Graphics
  drawEllipse (x:Number , y:Number , width:Number , height:Number ):void
타원을 묘화 합니다.
Graphics
  drawRect (x:Number , y:Number , width:Number , height:Number ):void
구형을 묘화 합니다.
Graphics
  drawRoundRect (x:Number , y:Number , width:Number , height:Number , ellipseWidth:Number , ellipseHeight:Number ):void
각환구형을 묘화 합니다.
Graphics
  endFill ():void
beginFill(),beginGradientFill(), 또는 beginBitmapFill() Methods에의 마지막 호출해 이후에 추가된 선과 곡선에 칠을 적용합니다.
Graphics
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
  lineGradientStyle (type:String , colors:Array , alphas:Array , ratios:Array , matrix:Matrix = null, spreadMethod:String = "pad", interpolationMethod:String = "rgb", focalPointRatio:Number = 0):void
object의 다른 Graphics Methods (lineTo()drawCircle() 등)에 대한 향후의 호출해에 사용하는 선스타일의 그라데이션을 지정합니다.
Graphics
  lineStyle (thickness:Number , color:uint = 0, alpha:Number = 1.0, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = null, joints:String = null, miterLimit:Number = 3):void
object의 다른 Graphics Methods (lineTo()drawCircle() 등)에 대한 향후의 호출해에 사용하는 선의 스타일을 지정합니다.
Graphics
  lineTo (x:Number , y:Number ):void
현재의 묘화 위치로부터 (x, y)까지, 현재의 선의 스타일을 사용해 선을 묘화 합니다. 그 후로, 현재의 묘화 위치는 (x, y)으로 설정됩니다.
Graphics
  moveTo (x:Number , y:Number ):void
현재의 묘화 위치를 (x, y)로 이동합니다.
Graphics
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
Methods의 상세
beginBitmapFill()Methods
public function beginBitmapFill(bitmap:BitmapData , matrix:Matrix = null, repeat:Boolean = true, smooth:Boolean = false):void

묘화 area를 비트 맵 이미지로 전부 칠합니다. 비트 맵을 반복하는지, 타일링 표시해, area를 전부 칠할 수가 있습니다. beginFill(),beginBitmapFill(), 또는 beginGradientFill() Methods를 호출할 때까지, 칠은 유효인 채입니다. clear() Methods를 호출하면, 칠이 클리어 됩니다.

endFill() Methods가 불려 갈 때까지, 칠은 렌더링 되지 않습니다(drawCircle(),drawEllipse(),drawRect(), 및 drawRoundRect() Methods는, 자동적으로 endFill() Methods를 호출합니다).

Parameters
bitmap:BitmapData — 표시되는 비트를 포함한 투명 또는 불투명 비트 맵 이미지입니다.
 
matrix:Matrix (default = null) — flash.geom.Matrix 클래스의 매트릭스 object입니다. 이것을 사용해 비트 맵상에 변형을 정의할 수 있습니다. 예를 들어, 다음의 매트릭스를 사용하면, 비트 맵을 45 번 (π/4 라디안) 회전할 수 있습니다.
  matrix = new flash.geom.Matrix(); 
  matrix.rotate(Math.PI/4);
  
 
repeat:Boolean (default = true)true 의 경우, 비트 맵 이미지가 일정한 패턴으로 타일장에 표시됩니다. false 의 경우, 비트 맵 이미지는 반복해지지 않습니다. 비트 맵으로부터 초과하는 칠area에는 비트 맵의 엣지가 사용됩니다.

예를 들어, 다음의 비트 맵 (20 × 20 픽셀의 checker 보드의 패턴)을 생각합니다.

다음의 예의 같게 repeattrue 로 설정되어 있는 경우, 비트 맵의 칠로 비트 맵이 반복해집니다.

repeatfalse 로 설정되어 있는 경우, 엣지의 픽셀이 비트 맵의 외측의 칠area에 사용됩니다.

 
smooth:Boolean (default = false)false 의 경우, 확대 비트 맵 이미지는 최근옆알고리즘을 사용해 렌더링 되어 픽셀화 된 것처럼 보입니다. true 의 경우, 확대 비트 맵 이미지는 쌍선형 알고리즘을 사용해 렌더링 됩니다. 통상은, 최근옆알고리즘을 사용한 렌더링이 고속으로.

See also

beginFill()Methods 
public function beginFill(color:uint , alpha:Number = 1.0):void

object의 다른 Graphics Methods (lineTo()drawCircle() 등)에 대한 향후의 호출해에 사용하는 단순한 단색 칠을 지정합니다. beginFill(),beginBitmapFill(), 또는 beginGradientFill() Methods를 호출할 때까지, 칠은 유효인 채입니다. clear() Methods를 호출하면, 칠이 클리어 됩니다.

endFill() Methods가 불려 갈 때까지, 칠은 렌더링 되지 않습니다(drawCircle(),drawEllipse(),drawRect(), 및 drawRoundRect() Methods는, 자동적으로 endFill() Methods를 호출합니다).

Parameters
color:uint — 칠의 칼라입니다 (0xRRGGBB).
 
alpha:Number (default = 1.0) — 칠의 알파치입니다 (0.0 ~ 1.0).

See also

beginGradientFill()Methods 
public function beginGradientFill(type:String , colors:Array , alphas:Array , ratios:Array , matrix:Matrix = null, spreadMethod:String = "pad", interpolationMethod:String = "rgb", focalPointRatio:Number = 0):void

object의 다른 Graphics Methods (lineTo()drawCircle() 등)에 대한 향후의 호출해에 사용하는 그라데이션 칠을 지정합니다. beginFill(),beginBitmapFill(), 또는 beginGradientFill() Methods를 호출할 때까지, 칠은 유효인 채입니다. clear() Methods를 호출하면, 칠이 클리어 됩니다.

endFill() Methods가 불려 갈 때까지, 칠은 렌더링 되지 않습니다(drawCircle(),drawEllipse(),drawRect(), 및 drawRoundRect() Methods는, 자동적으로 endFill() Methods를 호출합니다).

Parameters
type:String — 사용하는 그라데이션의 타입을 지정하는 GradientType 클래스의 값은, 다음과 같습니다. GradientType.LINEAR 또는 GradientType.RADIAL.
 
colors:Array — 그라데이션으로 사용하는 RGB 16 진칼라치의 배열 (빨강 0 xFF0000, 파랑 0x0000FF 등). 최대 15 색까지 지정할 수 있습니다. 각 색에 대해, alphas Parameters와 ratios Parameters로 대응하는 값을 반드시 지정해 주세요.
 
alphas:Array — colors 배열내의 각 색에 대응하는 알파치의 배열. 유효한 값은 0 ~ 1 입니다. 0 미만의 값의 경우는, 디폴트로 0 이 적용됩니다. 1 보다 큰 값의 경우는, 디폴트로 1 이 적용됩니다.
 
ratios:Array — 색분포의 비율의 배열. 유효한 값은 0 ~ 255 입니다. 이 값은,100% 로 샘플링 되는 색의 폭의 비율을 퍼센트로 정의합니다. 값 0 은 그라데이션복스의 왼쪽의 위치를 나타내, 255 는 그라데이션복스의 오른쪽의 위치를 나타냅니다.

메모: 이 값은, 그라데이션복스내의 위치를 나타내서 , 최종 그라데이션의 좌표 공간을 나타내는 것이 아닙니다. 최종 그라데이션은, 그라데이션복스보다 넓어지거나 좁아지거나 하는 경우가 있습니다. colors Parameters의 값 마다, 값을 지정해 주세요.

예를 들어, 파랑과 초록의 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() Methods가 있습니다. 이 Methods를 사용하면,beginGradientFill() Methods로 사용할 수 있는 매트릭스를 용이하게 설정할 수 있습니다.
 
spreadMethod:String (default = "pad") — 사용하는 spread Methods를 지정하는 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 Methods에 SpreadMethod.PAD 를 사용하고 있기 (위해)때문에, 그라데이션의 칠은 다음과 같이 됩니다.

spread Methods에 SpreadMethod.REFLECT 를 사용하는 경우, 그라데이션의 칠은 다음과 같이 됩니다.

spread Methods에 SpreadMethod.REPEAT 를 사용하는 경우, 그라데이션의 칠은 다음과 같이 됩니다.

 
interpolationMethod:String (default = "rgb") — 사용하는 값을 지정하는 InterpolationMethod 클래스의 값은, 다음과 같습니다. InterpolationMethod.linearRGB 또는 InterpolationMethod.RGB

예를 들어, 2 개의 색의 사이에,spreadMethod Parameters가 SpreadMethod.REFLECT 로 설정된 간단한 선상 그라데이션이 있다고 합니다. 각각의 보간 방법으로, 외관에 다음과 같은 영향이 있습니다.

InterpolationMethod.LINEAR_RGB InterpolationMethod.RGB
 
focalPointRatio:Number (default = 0) — 그라데이션의 초점의 위치를 나타내는 수치입니다. 0 은 초점이 중앙에 있는 것, 1 은 초점이 그라데이션엔의 몇개의 경계에 있는 것,-1 은 초점이 그라데이션엔의 이제(벌써) 한편의 경계에 있는 것을 나타냅니다. -1 미만 또는 1 보다 큰 값은,-1 또는 1 에 말 수 있습니다. 예를 들어, 다음의 예에서는,focalPointRatio 가 0.75 로 설정되어 있습니다.


Throws
ArgumentError type Parameters가 유효하지 않은 경우

See also

clear()Methods 
public function clear():void

이 Graphics object에 묘화 되고 있는 그래픽을 클리어 해, 칠과 선의 스타일의 설정을 리셋트 합니다.

curveTo()Methods 
public function curveTo(controlX:Number , controlY:Number , anchorX:Number , anchorY:Number ):void

(controlX, controlY)(으)로 지정된 컨트롤 포인트를 사용해, 현재의 묘화 위치로부터 (anchorX, anchorY)까지, 현재의 선의 스타일로 곡선을 묘화 합니다. 그 후, 현재의 묘화 위치는 (anchorX, anchorY)으로 설정됩니다. 묘화처의 무비 클립에 Flash 의 묘화 툴로 작성한 컨텐츠가 포함되어 있는 경우는,curveTo() Methods에의 호출의 결과는 이 컨텐츠아래에 묘화 됩니다. moveTo() Methods를 호출하기 전에 curveTo() Methods를 호출하면, 현재의 묘화 위치는 디폴트로 (0,0)가 됩니다. 몇개의 Parameters를 생략 하면, 이 Methods는 실패해, 현재의 묘화 위치는 변경되지 않습니다.

묘화 되는 곡선은, 2차 베지에곡선입니다. 2차 베지에곡선은, 2 개의 엥커 포인트와 1 개의 컨트롤 포인트로 구성되어 있습니다. 곡선은, 2 개의 엥커 포인트를 보간 해, 컨트롤 포인트로 향합니다.

Parameters
controlX:Number — 친표시 object의 기준점으로부터의 상대적인 컨트롤 포인트의 수평 좌표를 지정하는 수치.
 
controlY:Number — 친표시 object의 기준점으로부터의 상대적인 컨트롤 포인트의 수직 좌표를 지정하는 수치.
 
anchorX:Number — 친표시 object의 기준점으로부터의 상대적인 다음의 엥커 포인트의 수평 좌표를 지정하는 수치.
 
anchorY:Number — 친표시 object의 기준점으로부터의 상대적인 다음의 엥커 포인트의 수직 좌표를 지정하는 수치.
drawCircle()Methods 
public function drawCircle(x:Number , y:Number , radius:Number ):void

엔을 묘화 합니다. drawCircle() Methods를 호출하기 전에,linestyle(),lineGradientStyle(),beginFill(),beginGradientFill(), 또는 beginBitmapFill() Methods를 호출해, 선의 스타일 또는 발라, 혹은 그 양쪽 모두를 설정할 필요가 있습니다.

Parameters
x:Number — 친표시 object의 기준점으로부터의 엔의 중심의 상대 x 좌표 (픽셀 단위).
 
y:Number — 친표시 object의 기준점으로부터의 엔의 중심의 상대 y 좌표 (픽셀 단위).
 
radius:Number — 엔의 반경 (픽셀 단위).

See also

drawEllipse()Methods 
public function drawEllipse(x:Number , y:Number , width:Number , height:Number ):void

타원을 묘화 합니다. drawEllipse() Methods를 호출하기 전에,linestyle(),lineGradientStyle(),beginFill(),beginGradientFill(), 또는 beginBitmapFill() Methods를 호출해, 선의 스타일 또는 발라, 혹은 그 양쪽 모두를 설정할 필요가 있습니다.

Parameters
x:Number — 친표시 object의 기준점으로부터의 상대적인 수평 좌표를 나타내는 수치 (픽셀 단위).
 
y:Number — 친표시 object의 기준점으로부터의 상대적인 수직 좌표를 나타내는 수치 (픽셀 단위).
 
width:Number — 타원의 폭 (픽셀 단위).
 
height:Number — 타원의 높이 (픽셀 단위).

See also

drawRect()Methods 
public function drawRect(x:Number , y:Number , width:Number , height:Number ):void

구형을 묘화 합니다. drawRect() Methods를 호출하기 전에,linestyle(),lineGradientStyle(),beginFill(),beginGradientFill(), 또는 beginBitmapFill() Methods를 호출해, 선의 스타일 또는 발라, 혹은 그 양쪽 모두를 설정할 필요가 있습니다.

Parameters
x:Number — 친표시 object의 기준점으로부터의 상대적인 수평 좌표를 나타내는 수치 (픽셀 단위).
 
y:Number — 친표시 object의 기준점으로부터의 상대적인 수직 좌표를 나타내는 수치 (픽셀 단위).
 
width:Number — 구형의 폭 (픽셀 단위).
 
height:Number — 구형의 높이 (픽셀 단위).

Throws
ArgumentError width 또는 height Parameters가 수치 (Number.NaN)가 아닌 경우

See also

drawRoundRect()Methods 
public function drawRoundRect(x:Number , y:Number , width:Number , height:Number , ellipseWidth:Number , ellipseHeight:Number ):void

각환구형을 묘화 합니다. drawRoundRect() Methods를 호출하기 전에,linestyle(),lineGradientStyle(),beginFill(),beginGradientFill(), 또는 beginBitmapFill() Methods를 호출해, 선의 스타일 또는 발라, 혹은 그 양쪽 모두를 설정할 필요가 있습니다.

Parameters
x:Number — 친표시 object의 기준점으로부터의 상대적인 수평 좌표를 나타내는 수치 (픽셀 단위).
 
y:Number — 친표시 object의 기준점으로부터의 상대적인 수직 좌표를 나타내는 수치 (픽셀 단위).
 
width:Number — 각 환구형의 폭 (픽셀 단위).
 
height:Number — 각 환구형의 높이 (픽셀 단위).
 
ellipseWidth:Number — 환각의 묘화에 사용되는 타원의 폭 (픽셀 단위).
 
ellipseHeight:Number — 환각의 묘화에 사용되는 타원의 높이 (픽셀 단위). (옵션) 값을 지정하지 않는 경우는,ellipseWidth Parameters로 지정된 값이 디폴트로 적용됩니다.

Throws
ArgumentError width,height,ellipseWidth, 또는 ellipseHeight Parameters가 수치 (Number.NaN)가 아닌 경우

See also

endFill()Methods 
public function endFill():void

beginFill(),beginGradientFill(), 또는 beginBitmapFill() Methods에의 마지막 호출해 이후에 추가된 선과 곡선에 칠을 적용합니다. 적용되는 칠은,beginFill(),beginGradientFill(), 또는 beginBitmapFill() Methods의 전회의 호출로 지정된 것입니다. 현재의 묘화 위치가 moveTo() Methods의 직전의 호출로 지정된 좌표와 동일하지 않은 경우, 칠이 정의되고 있으면, 패스가 선으로 닫혀진 후, 칠이 적용됩니다.

See also

lineGradientStyle()Methods 
public function lineGradientStyle(type:String , colors:Array , alphas:Array , ratios:Array , matrix:Matrix = null, spreadMethod:String = "pad", interpolationMethod:String = "rgb", focalPointRatio:Number = 0):void

object의 다른 Graphics Methods (lineTo()drawCircle() 등)에 대한 향후의 호출해에 사용하는 선스타일의 그라데이션을 지정합니다. 선의 스타일은,lineStyle() Methods 또는 lineGradientStyle() Methods를 다른 Parameters로 호출할 때까지 유효인 채입니다. 패스의 묘화중에 lineGradientStyle() Methods를 호출해, 패스내의 선의 세그먼트(segment) 마다 다른 스타일을 지정할 수 있습니다.

lineGradientStyle() 를 호출하기 전에 lineStyle() 를 호출해 선을 유효하게 합니다. 그렇게 하지 않으면 선의 스타일이 undefined 대로 됩니다.

clear() 를 호출하면, 선의 스타일이 undefined 에 돌아옵니다.

Parameters
type:String — 사용하는 그라데이션의 타입을 지정하는 GradientType 클래스의 값은, GradientType.LINEAR 또는 GradientType.RADIAL 의 머지않아인가입니다.
 
colors:Array — 그라데이션으로 사용하는 RGB 16 진칼라치의 배열 (빨강 0 xFF0000, 파랑 0x0000FF 등).
 
alphas:Array colors 배열내의 각 색에 대응하는 알파치의 배열. 유효한 값은 0 ~ 100 입니다. 0 미만의 값의 경우는 0 이, 100 을 넘는 값의 경우는 100 이 적용됩니다.
 
ratios:Array — 색분포의 비율의 배열. 유효한 값은 0 ~ 255 입니다. 이 값은,100% 로 샘플링 되는 색의 폭의 비율을 퍼센트로 정의합니다. 값 0 은 그라데이션복스의 왼쪽의 위치를 나타내, 255 는 그라데이션복스의 오른쪽의 위치를 나타냅니다. 이 값은, 그라데이션복스내의 위치를 나타내서 , 최종 그라데이션의 좌표 공간을 나타내는 것이 아닙니다. 최종 그라데이션은, 그라데이션복스보다 넓어지거나 좁아지거나 하는 경우가 있습니다. colors Parameters의 값 마다, 값을 지정해 주세요.

예를 들어, 파랑과 초록의 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() Methods가 있습니다. 이 Methods를 사용하면,lineGradientStyle() Methods로 사용할 수 있는 매트릭스를 용이하게 설정할 수 있습니다.
 
spreadMethod:String (default = "pad") — 사용하는 spread Methods를 지정하는 SpreadMethod 클래스의 값은, 다음과 같습니다.

SpreadMethod.PAD SpreadMethod.REFLECT SpreadMethod.REPEAT

 
interpolationMethod:String (default = "rgb") — 사용하는 값을 지정하는 InterpolationMethod 클래스의 값입니다. 예를 들어, 2 개의 색의 사이에,spreadMethod Parameters가 SpreadMethod.REFLECT 로 설정된 간단한 선상 그라데이션이 있다고 합니다. 각각의 보간 방법으로, 외관에 다음과 같은 영향이 있습니다.

InterpolationMethod.LINEAR_RGB InterpolationMethod.RGB

 
focalPointRatio:Number (default = 0) — 그라데이션의 초점의 위치를 나타내는 수치입니다. 0 은 초점이 중앙에 있는 것, 1 은 초점이 그라데이션엔의 몇개의 경계에 있는 것,-1 은 초점이 그라데이션엔의 이제(벌써) 한편의 경계에 있는 것을 나타냅니다. -1 미만의 값은 -1 에, 1 보다 큰 값은 1 에 말 수 있습니다. 다음의 이미지는,focalPointRatio 를 -0. 75 로 설정한 그라데이션을 나타내고 있습니다.

See also

lineStyle()Methods 
public function lineStyle(thickness:Number , color:uint = 0, alpha:Number = 1.0, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = null, joints:String = null, miterLimit:Number = 3):void

object의 다른 Graphics Methods (lineTo()drawCircle() 등)에 대한 향후의 호출해에 사용하는 선의 스타일을 지정합니다. 선의 스타일은,lineGradientStyle() Methods 또는 lineStyle() Methods를 다른 Parameters로 호출할 때까지 유효인 채입니다. 패스의 묘화중에 lineStyle() Methods를 호출해, 패스내의 선의 세그먼트(segment) 마다 다른 스타일을 지정할 수 있습니다.

메모 :clear() Methods를 호출하면, 선의 스타일이 undefined 에 돌아옵니다.

Parameters
thickness:Number — 선의 굵기를 포인트 단위로 가리키는 정수. 유효한 값은 0 ~ 255 입니다. 수치를 지정하지 않는지, Parameters가 undefined 인 경우는, 선은 묘화 되지 않습니다. 0 미만의 값을 지정했을 경우는, 디폴트로 0 이 적용됩니다. 0 은 극세선입니다. 최대의 굵기는 255 입니다. 255 를 넘는 값을 지정했을 경우는, 디폴트로 255 가 적용됩니다.
 
color:uint (default = 0) — 선의 색을 나타내는 16 진치. 예를 들어, 빨강은 0 xFF0000, 파랑은 0x0000FF 로 나타냅니다. 값을 지정하지 않는 경우는, 디폴트로 0x000000 (흑)가 적용됩니다. 옵션. -
 
alpha:Number (default = 1.0) — 선의 색의 알파치를 나타내는 수치. 유효한 값은 0 ~ 1 입니다. 값을 지정하지 않는 경우는, 디폴트로 1 (솔리드)이 적용됩니다. 0 미만의 값을 지정했을 경우, 디폴트로 0 이 적용됩니다. 1 보다 큰 값을 지정했을 경우, 디폴트로 1 이 적용됩니다.
 
pixelHinting:Boolean (default = false) — 픽셀 전체에 대해서 선을 힌팅 할지 어떨지를 지정하는 불리언 값. 이 값은, 곡선의 엥커의 위치와 선의 크기 자신의 양쪽 모두에 영향을 줍니다. pixelHintingtrue 로 설정하면, 전픽셀폭에 선폭이 힌팅 됩니다. pixelHintingfalse 로 설정하면, 곡선과 직선으로 비연속이 발생하는 일이 있습니다. 예를 들어, 다음의 그림은,lineStyle() Methods로 사용되는 pixelHinting Parameters의 설정이 다른 것만으로 외는 완전히 같은 2 개의 각환구형이 어떻게 렌더링 되는지를 나타낸 것입니다 (차이를 알 수 있도록(듯이) 이미지는 200% 에 확대되고 있습니다).

값을 지정하지 않는 경우, 선으로 픽셀의 힌팅이 사용되지 않습니다.

 
scaleMode:String (default = "normal") — 사용하는 확대·축소 모드를 지정하는 LineScaleMode 클래스의 값입니다.
  • LineScaleMode.NORMAL—object가 확대·축소되는 경우, 항상 선의 굵기가 확대·축소됩니다 (디폴트).
  • LineScaleMode.NONE—선의 굵기를 확대·축소하지 않습니다.
  • LineScaleMode.VERTICAL—object를 수직 방향으로만 확대·축소하는 경우는, 선의 굵기를 확대·축소하지 않습니다. 예를 들어, 다음에 나타내는 각 엔은, 1 픽셀의 선으로 묘화 되어 각각 scaleMode Parameters가 LineScaleMode.VERTICAL 로 설정되어 있습니다. 좌측의 엔은 수직 방향에게만 확대 또는 축소되어 우측의 엔은 수직과 수평의 양방향에 확대 또는 축소된 것입니다.

  • LineScaleMode.HORIZONTAL—object를 수평 방향으로만 확대·축소하는 경우는, 선의 굵기를 확대·축소하지 않습니다. 예를 들어, 다음에 나타내는 각 엔은, 1 픽셀의 선으로 묘화 되어 각각 scaleMode Parameters가 LineScaleMode.HORIZONTAL 로 설정되어 있습니다. 좌측의 엔은 수평 방향에게만 확대 또는 축소되어 우측의 엔은 수직과 수평의 양방향에 확대 또는 축소된 것입니다.

 
caps:String (default = null) — 선의 종단의 캡의 종류를 지정하는 CapsStyle 클래스의 값. 유효한 값은 다음과 같습니다. CapsStyle.NONE,CapsStyle.ROUND, 및 CapsStyle.SQUARE. 이 값을 지정하지 않는 경우는, 둥근 캡이 사용됩니다.

예를 들어, 다음의 그림은 capsStyle 의 다양한 설정을 나타냅니다. 각각의 설정으로, 그림의 푸른 선은 굵기 30 으로,capsStyle 가 적용되고 있습니다. 거듭해 맞춘 검은 선은 굵기 1 으로,capsStyle 는 적용되고 있지 않습니다.

 
joints:String (default = null) — 각으로 사용하는 접합점의 외관의 종류를 지정하는 JointStyle 클래스의 값. 유효한 값은 다음과 같습니다. JointStyle.BEVEL,JointStyle.MITER, 및 JointStyle.ROUND. 이 값을 지정하지 않으면 각환 ("round")의 접합점이 사용됩니다.

예를 들어, 다음의 그림은 joints 의 다양한 설정을 나타냅니다. 각각의 설정으로, 모퉁이가 있는 푸른 선은 굵기 30 으로,jointStyle 가 적용되고 있습니다. 거듭해 맞춘 검은 선은 굵기 1 으로,jointStyle 는 적용되고 있지 않습니다.

메모: jointsJointStyle.MITER 로 설정하면,miterLimit Parameters를 사용해, 마이타의 길이를 제한할 수 있습니다.

 
miterLimit:Number (default = 3) — 마이타가 잘라내지는 한도를 나타내는 수치입니다. 유효한 값은 1 에서 255 의 범위에서, 이 범위를 넘은 값은 1 또는 255 에 말 수 있습니다. 이 값은,jointStyle"miter" 로 설정했을 경우에게만 유효합니다. miterLimit 의 값에 의해, 선의 접합점을 넘어 마이타를 연장할 수 있는 길이가 결정됩니다. 마이타를 연장할 수 있는 길이는, 이 값과 선의 thickness 가 곱셈된 것입니다. 예를 들어,miterLimit 의 값이 2.5 로,thickness 가 10 픽셀의 경우, 마이타는 25 픽셀로 잘라내집니다.

예로서 다음과 같은 모퉁이가 있는 선을 생각합니다. 어느 선도 thickness 를 20 으로 설정해 묘화 되고 있습니다만,miterLimit 는 각각 1, 2, 4 로 설정되어 있습니다. 거듭해 합쳐진 흑의 기준선은, 접합점을 나타내고 있습니다.

miterLimit 의 각각의 값에는, 마이타가 잘라내지는 독자적인 최대 각도가 있습니다. 다음의 겉(표)에, 몇개의 예를 나타냅니다.

miterLimit 의 값 : 각도가 이하보다 작은 경우는 잘라내진다
1.414 90 번
2 60 번
4 30 번
8 15 번

See also

lineTo()Methods 
public function lineTo(x:Number , y:Number ):void

현재의 묘화 위치로부터 (x, y)까지, 현재의 선의 스타일을 사용해 선을 묘화 합니다. 그 후로, 현재의 묘화 위치는 (x, y)으로 설정됩니다. 묘화처 display object에 Flash 의 묘화 툴로 작성한 컨텐츠가 포함되어 있는 경우,lineTo() Methods에의 호출의 결과는 이 컨텐츠아래에 묘화 됩니다. moveTo() Methods를 호출하기 전에 lineTo() 를 호출하면, 현재의 묘화 위치는 디폴트로 (0,0)가 됩니다. 몇개의 Parameters를 생략 하면, 이 Methods는 실패해, 현재의 묘화 위치는 변경되지 않습니다.

Parameters
x:Number — 친표시 object의 기준점으로부터의 상대적인 수평 좌표를 나타내는 수치 (픽셀 단위).
 
y:Number — 친표시 object의 기준점으로부터의 상대적인 수직 좌표를 나타내는 수치 (픽셀 단위).
moveTo()Methods 
public function moveTo(x:Number , y:Number ):void

현재의 묘화 위치를 (x, y)로 이동합니다. 몇개의 Parameters를 생략 하면, 이 Methods는 실패해, 현재의 묘화 위치는 변경되지 않습니다.

Parameters
x:Number — 친표시 object의 기준점으로부터의 상대적인 수평 좌표를 나타내는 수치 (픽셀 단위).
 
y:Number — 친표시 object의 기준점으로부터의 상대적인 수직 좌표를 나타내는 수치 (픽셀 단위).
Examples

다음의 예에서는, GraphicsExample 클래스를 사용해, 엔, 각환구형, 및 사각형을 묘화 합니다. 이것을 실시하려면 , 이하의 순서를 실행합니다.
  1. 다음에 각 셰이프의 크기를 결정할 때에 사용하는 size property를 선언합니다.
  2. 배경색을 오렌지색, 경계선색을 진한 회색, 경계선의 크기를 0 픽셀, 각이 둥근 반경을 9 픽셀, 스테이지의 구석과 다른 object의 사이의 스페이스를 5 픽셀에, 각각 설정하는 property를 선언합니다.
  3. 상기의 순서로 선언한 property를 Graphics 클래스의 빌트인 Methods와 함께 사용해, 엔, 각환구형, 및 사각형을, 좌표 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);
        }
    }
}






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/flash/display/Graphics.html