java.awt
클래스 BasicStroke

java.lang.Object 
  java.awt.BasicStroke

모든 구현된 인터페이스:

Stroke

public class BasicStroke
extends Object 
implements Stroke 

BasicStroke 클래스는 단순한 도형의 윤곽선을 렌더링 하는 속성의 기본 세트를 정의합니다. 이 렌더링는 Stroke 속성을 이 BasicStroke로 설정한 Graphics2D 객체에 의해 행해집니다. BasicStroke로 정의되는 렌더링 속성은, Shape 윤곽을 위를 덧써 펜으로 렌더링 되는 기호의 형상, 단부의 장식, 또는 Shape 윤곽선 세그먼트 (segment)의 접합을 기술합니다. 이러한 렌더링 속성에는 다음과 같은 것이 있습니다.

width

펜의 궤적에 대해서 수직 방향의 펜의 폭

첨단

닫혀지지 않은 부분 윤곽선 세그먼트 (segment)와 파선 세그먼트(segment)의 양단의 장식. 부분 윤곽선의 기점과 종점이 같은 경우에서도, CLOSE 세그먼트(segment)가 없는 경우는 닫지 않다고 보인다. CLOSE 세그먼트(segment)에 대해서는 SEG_CLOSE를 참조. CAP_BUTT, CAP_ROUND 및 CAP_SQUARE 3 종류의 장식이 있는

라인 접합

2개의 윤곽선 세그먼트 (segment)의 교점 및 SEG_CLOSE 로 닫혀지는 부분 윤곽선의 양단의 교점의 장식. JOIN_BEVEL, JOIN_MITER 및 JOIN_ROUND 3 종류의 장식이 있는

접합 제한치

JOIN_MITER 장식의 라인 접합의 트리밍을 실시하는 제한치. 라인 접합의 트리밍은 접합의 길이의 stroke폭에 대한 비율이, 접합 제한치를 넘었을 경우에 실행된다. 접합의 길이는 접합 부분의 대각선의 길이여, 교점의 안쪽의 모퉁이에서 외측의 모퉁이까지의 거리이다. 2개의 라인 세그먼트(segment)의 각도가 작아지면 과연, 접합 부분은 길어져, 교차 각도는 작아진다. 디폴트의 접합 제한치 10.0f 에서는 각도가 11번 보다 작아졌을 경우에 트리밍을 실시한다. 접합의 트리밍에서는 라인 접합의 장식이 사영에 변환되는

파선 속성

불투명 부분과 투명 부분이 교대로 되도록의해 파선을 작성하는 방법의 정의

리턴된 윤곽선의 형상을 제어하는 크기나 거리를 지정하는 모든 속성은 stroke가 없는 오리지날의 Shape인수와 같은 좌표계로 측정됩니다. Graphics2D 객체가 Stroke 객체를 사용해 draw 메서드의 1개를 실행하고 있는 경우에 윤곽선을 재정의하는 경우, Graphics2D 변환에 한 속성이 적용되기 전의 오리지날의 지오메트리?? 사용됩니다. 이 때문에 펜폭등의 속성은 Graphics2D 객체의 사용자 공간 좌표 시스템의 값으로 해서 해석되어 사용자 공간으로부터 디바이스 공간으로 변환하는 경우에 슬캘링 효과와 셔링 효과의 영향을 받습니다. 예를 들어 렌더링 되는 도형의 윤곽의 폭의 결정에는 이 BasicStroke 폭속성 뿐만이 아니라, Graphics2D 객체의 변환 속성도 영향을 줍니다. 아래의 코드를 참조하십시오.

// sets the Graphics2D object's Transform attirbute g2d.scale(10, 10); // sets the Graphics2D object's Storoke attribute g2d.setStroke(new BasicStroke(1.5f));

Graphics2D 객체에 다른 슬캘링 변환이 추가되어 있지 않은 경우, 생성되는 라인의 폭은 약 15 픽셀이 됩니다. 샘플 코드로 나타나고 있도록, 특히 Graphics2D 객체를 사용해 대규모 변환이 실행되는 경우는 부동 소수점 라인이 정밀도가 높아집니다. 대각선의 경우, 정확한 폭은 렌더링 파이프라인이 이론상의 폭의 윤곽을 위를 덧쓸 때에 어느 픽셀상에 렌더링 할까로 결정됩니다. 렌더링 대상 픽셀의 선택에는 anti-aliasing 속성도 영향을 줍니다. anti-aliasing 렌더링 파이프라인은 부분적으로 덮이는 픽셀도 렌더링 대상으로의해 선택할 수 있기 때문에입니다.

사용자 공간 좌표계와 렌더링 프로세스에 대해서는 Graphics2D 클래스의 설명을 참조하십시오.

관련 항목:

Graphics2D

필드 개요

static int	CAP_BUTT 장식을 붙이지 않고, 닫혀지지 않은 부분 윤곽선 및 파선 세그먼트(segment)를 종료합니다.
static int	CAP_ROUND 펜폭의 반의 길이를 반경으로 한 둥근 장식을 붙여, 닫혀지지 않은 부분 윤곽선 및 파선 세그먼트(segment)를 종료합니다.
static int	CAP_SQUARE 라인폭의 반의 길이에 동일한 거리만 세그먼트(segment)의 첨단을 연장하는 정방형을 붙여, 닫혀지지 않은 부분 윤곽선 및 파선 세그먼트(segment)를 종료합니다.
static int	JOIN_BEVEL 폭의 넓은 윤곽선의 외측의 모퉁이를 직선 세그먼트(segment)에 접합하도록의해 윤곽선 세그먼트 (segment)를 접합합니다.
static int	JOIN_MITER 라인 세그먼트(segment)의 외측의 구석이 겹칠 때까지 연장해 윤곽선 세그먼트 (segment)를 접합합니다.
static int	JOIN_ROUND 라인폭의 반의 길이를 반경으로서 모퉁이를 둥글게 잘라 떨어뜨려 윤곽선 세그먼트 (segment)를 접합합니다.

생성자 개요

BasicStroke ()
모든 속성에 설정값을 사용해 새로운 BasicStroke를 구축합니다.

BasicStroke (float width)
지정된 선폭과 첨단 및 라인 접합의 스타일의 설정값을 사용해, 실선으로 BasicStroke를 구축합니다.

BasicStroke (float width, int cap, int join)
지정된 속성을 가지는 실선의 BasicStroke를 구축합니다.

BasicStroke (float width, int cap, int join, float miterlimit)
지정된 속성을 가지는 실선의 BasicStroke를 구축합니다.

BasicStroke (float width, int cap, int join, float miterlimit, float[] dash, float dash_phase)
지정된 속성을 가지는 새로운 BasicStroke를 구축합니다.

메서드 개요

Shape	createStrokedShape (Shape s) 지정된 Shape를 stroke로 렌더링 한 윤곽을 나타내는 내부를 가지는 Shape를 리턴합니다.
boolean	equals (Object obj) 지정된 객체가 이 BasicStroke와 동일한지 어떤지를 판정합니다.
void	feedConsumer (sun.dc.path.PathConsumer consumer, PathIterator pi)
float[]	getDashArray () 파선 세그먼트(segment)의 길이를 나타내는 배열을 리턴합니다.
float	getDashPhase () 현재의 파선 국면을 리턴합니다.
int	getEndCap () 첨단의 스타일을 리턴합니다.
int	getLineJoin () 라인 접합의 스타일을 리턴합니다.
float	getLineWidth () 라인의 넓이를 리턴합니다.
float	getMiterLimit () 트리밍 제한치를 리턴합니다.
int	hashCode () 이 stroke의 해시 코드를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

필드의 상세

JOIN_MITER

public static final int JOIN_MITER

라인 세그먼트(segment)의 외측의 구석이 겹칠 때까지 연장해 윤곽선 세그먼트 (segment)를 접합합니다.

관련 항목:

정수 필드값

JOIN_ROUND

public static final int JOIN_ROUND

라인폭의 반의 길이를 반경으로서 모퉁이를 둥글게 잘라 떨어뜨려 윤곽선 세그먼트 (segment)를 접합합니다.

관련 항목:

정수 필드값

JOIN_BEVEL

public static final int JOIN_BEVEL

폭의 넓은 윤곽선의 외측의 모퉁이를 직선 세그먼트(segment)에 접합하도록의해 윤곽선 세그먼트 (segment)를 접합합니다.

관련 항목:

정수 필드값

CAP_BUTT

public static final int CAP_BUTT

장식을 붙이지 않고, 닫혀지지 않은 부분 윤곽선 및 파선 세그먼트(segment)를 종료합니다.

관련 항목:

정수 필드값

CAP_ROUND

public static final int CAP_ROUND

펜폭의 반의 길이를 반경으로 한 둥근 장식을 붙여, 닫혀지지 않은 부분 윤곽선 및 파선 세그먼트(segment)를 종료합니다.

관련 항목:

정수 필드값

CAP_SQUARE

public static final int CAP_SQUARE

라인폭의 반의 길이에 동일한 거리만 세그먼트(segment)의 첨단을 연장하는 정방형을 붙여, 닫혀지지 않은 부분 윤곽선 및 파선 세그먼트(segment)를 종료합니다.

관련 항목:

정수 필드값

생성자 상세

BasicStroke

public BasicStroke(float width,
                   int cap,
                   int join,
                   float miterlimit,
                   float[] dash,
                   float dash_phase)

지정된 속성을 가지는 새로운 BasicStroke를 구축합니다.

파라미터:

width - 이 BasicStroke 폭. 값은 0.0f 이상이 아니면 안된다. 폭이 0.0f 로 설정되어 있는 경우, stroke는 대상의 디바이스상의 가장 가는 라인으로서 렌더링 된다. 또, 이 때 에일리어징 제거 설정이 사용되는

cap - BasicStroke 양단의 장식

join - 윤곽선 세그먼트 (segment)의 접합부의 장식

miterlimit - 접합 트리밍의 제한치. 1.0f 이상이 아니면 안되는

dash - 파선 패턴을 나타내는 배열

dash_phase - 파선 패턴 개시 위치의 오프셋(offset)

예외:

IllegalArgumentException - width가 잘못된 값인 경우

IllegalArgumentException - cap가 CAP_BUTT, CAP_ROUND, 또는 CAP_SQUARE 어떤 것도 아닌 경우

IllegalArgumentException - miterlimit이 1 보다 작고, join가 JOIN_MITER인 경우

IllegalArgumentException - join가 JOIN_ROUND, JOIN_BEVEL, 또는 JOIN_MITER 어떤 것도 아닌 경우

IllegalArgumentException - dash_phase가 잘못된 값 으로dash가 null이 아닌 경우

IllegalArgumentException - dash 길이가 제로의 경우

IllegalArgumentException - 파선의 길이가 모두 제로의 경우

BasicStroke

public BasicStroke(float width,
                   int cap,
                   int join,
                   float miterlimit)

지정된 속성을 가지는 실선의 BasicStroke를 구축합니다.

파라미터:

width - BasicStroke 폭

cap - BasicStroke 양단의 장식

join - 윤곽선 세그먼트 (segment)의 접합부의 장식

miterlimit - 접합 트리밍의 제한치

예외:

IllegalArgumentException - width가 잘못된 값 의 경우

IllegalArgumentException - cap가 CAP_BUTT, CAP_ROUND, 또는 CAP_SQUARE 어떤 것도 아닌 경우

IllegalArgumentException - miterlimit이 1 보다 작고, join가 JOIN_MITER인 경우

IllegalArgumentException - join가 JOIN_ROUND, JOIN_BEVEL, 또는 JOIN_MITER 어떤 것도 아닌 경우

BasicStroke

public BasicStroke(float width,
                   int cap,
                   int join)

지정된 속성을 가지는 실선의 BasicStroke를 구축합니다. 기정치로 상관없는 경우나, 라인 접합이 JOIN_MITER 로 지정되어 있지 않은 경우는 miterlimit 파라미터는 불필요합니다.

파라미터:

width - BasicStroke 폭

cap - BasicStroke 양단의 장식

join - 윤곽선 세그먼트 (segment)의 접합부의 장식

예외:

IllegalArgumentException - width가 잘못된 값 의 경우

IllegalArgumentException - cap가 CAP_BUTT, CAP_ROUND, 또는 CAP_SQUARE 어떤 것도 아닌 경우

IllegalArgumentException - join가 JOIN_ROUND, JOIN_BEVEL, 또는 JOIN_MITER 어떤 것도 아닌 경우

BasicStroke

public BasicStroke(float width)

지정된 선폭과 첨단 및 라인 접합의 스타일의 설정값을 사용해, 실선으로 BasicStroke를 구축합니다.

파라미터:

width - BasicStroke 폭

예외:

IllegalArgumentException - width가 잘못된 값 의 경우

BasicStroke

public BasicStroke()

모든 속성에 설정값을 사용해 새로운 BasicStroke를 구축합니다. 디폴트의 속성은 실선의넓이 1.0, CAP_SQUARE, JOIN_MITER, 트리밍 제한치 10.0 입니다.

메서드의 상세

createStrokedShape

public Shape  createStrokedShape(Shape  s)

지정된 Shape를 stroke로 렌더링 한 윤곽을 나타내는 내부를 가지는 Shape를 리턴합니다.

정의:

인터페이스 Stroke 내의 createStrokedShape

파라미터:

s - stroke로 렌더링 되는 Shape 경계

반환값:

stroke로 렌더링 된 윤곽을 나타내는 Shape

feedConsumer

public void feedConsumer(sun.dc.path.PathConsumer consumer,
                         PathIterator  pi)

getLineWidth

public float getLineWidth()

라인의 넓이를 리턴합니다. Java 2D 로 디폴트의 좌표 공간으로서 사용되는 사용자 공간에서의 값이 리턴됩니다 . 사용자 공간의 좌표계에 대해서는 Graphics2D 클래스의 해설을 참조하십시오.

반환값:

이 BasicStroke 라인폭

관련 항목:

Graphics2D

getEndCap

public int getEndCap()

첨단의 스타일을 리턴합니다.

반환값:

이 BasicStroke 첨단의 스타일. 첨단의 스타일을 정의하는 static int 값으로 리턴된다

getLineJoin

public int getLineJoin()

라인 접합의 스타일을 리턴합니다.

반환값:

BasicStroke 라인 접합의 스타일. 라인 접합의 스타일을 정의하는 static int 값으로 리턴된다

getMiterLimit

public float getMiterLimit()

트리밍 제한치를 리턴합니다.

반환값:

BasicStroke 트리밍 제한치

getDashArray

public float[] getDashArray()

파선 세그먼트(segment)의 길이를 나타내는 배열을 리턴합니다. 배열내의 엔트리가 파선의 불투명 세그먼트(segment)와 투명 세그먼트(segment)의 사용자 공간에서의 길이를 교대로 나타냅니다. stroke로 렌더링 되는 Shape 윤곽에 따라 펜이 이동하는 것에 따라, 펜이 이동하는 사용자 공간의 거리가 누적됩니다. 거리의 값은 파선 배열의 인덱스에 사용됩니다. 현재의 누적 거리가 파선 배열의 짝수 번째의 요소에 매핑 되는 경우, 펜은 불투명하게 되어, 홀수 번째의 요소에 매핑 되는 경우는 투명하게 됩니다.

반환값:

파선 배열

getDashPhase

public float getDashPhase()

현재의 파선 국면을 리턴합니다. 파선 국면은 파선 패턴내에서의 오프셋(offset)를 나타내는 사용자 공간에서 지정된 거리입니다. 즉, 파선 국면은 stroke의 선두에 대응하는 파선 패턴내의 점을 정의합니다.

반환값:

float값의 파선 국면

hashCode

public int hashCode()

이 stroke의 해시 코드를 리턴합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 stroke의 해시 코드

관련 항목:

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object  obj)

지정된 객체가 이 BasicStroke와 동일한지 어떤지를 판정합니다. 최초로 객체가 BasicStroke인지를 판정해, 다음에 각각의 BasicStroke 객체의 폭, 접합, 첨단, 트리밍 제한치, 파선 및 파선 국면 속성을 비교합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 이 BasicStroke와 비교하는 객체

반환값:

2개의 객체의 폭, 접합, 첨단, 트리밍 제한치, 파선 및 파선 국면이 같은 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable