이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

fill

채워진 2차원 다각형(Filled 2-D Polygon)

구문

fill(X,Y,C)
fill(X,Y,ColorSpec)
fill(X1,Y1,C1,X2,Y2,C2,...)
fill(...,'PropertyName',PropertyValue)
fill(ax,...)
h = fill(...)


설명

fill 함수는 색으로 채워진 다각형을 만듭니다.

fill(X,Y,C)는 X와 Y의 데이터에서 C로 지정된 꼭짓점 색으로 채워진 다각형을 만듭니다. C는 컬러맵에 대한 인덱스로 사용되는 벡터 또는 행렬입니다. C가 행 벡터인 경우 length(C)는 size(X,2), size(Y,2)와 동일해야 합니다. C가 열 벡터인 경우 length(C)는 size(X,1), size(Y,1)과 동일해야 합니다. 필요한 경우 fill은 마지막 꼭짓점과 첫 번째 꼭짓점을 연결하여 다각형을 닫습니다. X와 Y의 값은 숫자형, datetime형, duration형 또는 categorical형 값일 수 있습니다.

fill(X,Y,ColorSpec)은 ColorSpec으로 지정된 색으로 다각형을 채웁니다. 색은 다음 값 중 하나일 수 있습니다.

• 색 이름 또는 짧은 이름: 'red'(또는 'r'), 'green'(또는 'g'), 'blue'(또는 'b'), 'cyan'(또는 'c'), 'magenta'(또는 'm'), 'yellow'(또는 'y'), 'black'(또는 'k'), 'white'(또는 'w').

• 각 요소가 색의 빨간색, 녹색, 파란색 성분의 농도를 지정하는, 1×3 벡터로 지정된 RGB 3색. 농도의 범위는 [0, 1]이어야 합니다. 예를 들어, [0.7 0.8 1]은 연한 파란색을 지정합니다.

fill(X1,Y1,C1,X2,Y2,C2,...)는 2차원의 채워진 영역을 여러 개 지정합니다.

fill(...,'PropertyName',PropertyValue)를 사용하면 패치 그래픽스 객체에 대한 속성 이름과 값을 지정할 수 있습니다.

fill(ax,...)는 현재 좌표축(gca) 대신 ax로 지정된 좌표축에 다각형을 생성합니다. 옵션 ax는 위에 열거된 구문의 입력 인수 조합보다 먼저 나올 수 있습니다.

h = fill(...)은 patch 객체로 구성된 벡터를 반환합니다.

예제

빨간색 팔각형(Octagon) 생성

데이터를 정의합니다.

t = (1/16:1/8:1)'*2*pi;
x = cos(t);
y = sin(t);

fill 함수를 사용하여 빨간색 팔각형을 생성합니다.

fill(x,y,'r')
axis square

팁

X나 Y 둘 중 하나는 행렬이고 다른 하나는 그 행렬의 행 개수와 동일한 요소를 가진 열 벡터인 경우 fill은 열 벡터 인수를 복제하여 필요한 크기의 행렬을 생성합니다. fill은 X와 Y의 대응 요소로 꼭짓점을 만들고 각 열의 데이터별로 다각형 하나를 생성합니다.

X 또는 Y에 하나 이상의 NaN 값이 있는 경우 fill은 다각형을 채우지 않습니다.

색 음영 유형은 인수 목록에서 색을 지정한 방식에 따라 달라집니다. ColorSpec 인수를 사용하여 색을 지정하는 경우 fill은 Patch 객체의 FaceColor 속성을 대응하는 RGB 3색으로 설정하여 플랫 셰이딩(Flat Shading)된 다각형을 생성합니다.

C를 사용하여 색을 지정하는 경우 fill은 axes 속성 CLim으로 지정된 값으로 C의 요소를 스케일링합니다. C를 스케일링하고 나면 C는 현재 컬러맵에 인덱싱됩니다.

C가 행 벡터인 경우 fill은 X와 Y 행렬의 요소에 대해 대응하는 C의 각 열에 따라 색을 지정해 플랫 셰이딩(Flat Shading)된 다각형을 생성합니다. 각 Patch 객체의 FaceColor 속성은 'flat'으로 설정됩니다. 각 행 요소는 n번째 Patch 객체에 대한 CData 속성값이 됩니다. 여기서 n은 X 또는 Y에 대응되는 열입니다.

C가 열 벡터 또는 행렬인 경우 fill은 꼭짓점 색의 선형 보간을 사용하여 보간된 색으로 다각형을 생성합니다. Patch 그래픽스 객체 FaceColor 속성은 'interp'로 설정되고 한 열의 요소들은 대응하는 각 Patch 객체의 CData 속성값이 됩니다. C가 열 벡터인 경우 fill은 열 벡터를 복제하여 필요한 크기의 행렬을 생성합니다.

호환성 관련 고려 사항

fill 및 fill3 함수로 만든 Patch 객체의 XData, YData, ZData 속성은 원래 데이터형의 값을 반환함

R2021a에서 동작이 변경됨

fill 또는 fill3 함수로 만든 Patch 객체의 XData, YData, ZData 속성은 좌표를 double형 값으로 반환하는 대신 원래 입력 데이터형을 사용하여 반환합니다.

이전 릴리스에서는 datetime형, duration형 및 categorical형 좌표가 XData, YData, ZData 속성에 저장되는 경우 double형 값으로 변환됩니다.

예를 들어, 다음 코드는 datetimte형 x 좌표를 사용하여 채워진 다각형을 만듭니다. 그런 다음 XData 속성에 저장된 값을 사용하여 x2를 계산합니다. R2020b에서 h.XData와 x2는 double형 배열입니다. R2021a에서 h.XData와 x2는 datetime형 배열입니다.

x = datetime('01-Jan-2018') + days([0 1 1 0]);
y = [0 0 1 1];
h = fill(x,y,'red');
x2 = h.XData + 1;

코드에서 double형 값을 유지하려면 Patch 객체의 Vertices 속성에서 double형 값을 가져오십시오. x, y, z 좌표는 Vertices 배열의 첫 번째, 두 번째, 세 번째 열에 double형 값으로 저장되어 있습니다.

x2 = h.Vertices(:,1) + 1;

또는 ruler2num 함수를 사용하십시오. 좌표값과 이에 대응하는 축 눈금자를 ruler2num 함수에 전달합니다.

ax = gca;
x2 = ruler2num(h.XData,ax.XAxis) + 1;

확장 기능

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 이 함수는 GPU 배열을 받지만 GPU에서 실행되지는 않습니다.

자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 이 함수는 분산 배열에 대해 연산을 수행하지만 클라이언트 측의 MATLAB^®에서 실행됩니다.

자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

참고 항목

함수

• axis | patch | fill3 | caxis | colormap

속성

• Patch 속성

도움말 항목

• 날짜와 기간 플로팅하기
• categorical형 데이터 플로팅하기

R2006a 이전에 개발됨

×

예제 열기

이 예제의 수정된 버전이 있습니다. 사용자가 편집한 내용을 반영하여 이 예제를 여시겠습니까?

아니요, 수정된 버전을 덮어씁니다. 예