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

fill3

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

구문

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


설명

fill3 함수는 플랫 셰이딩(Flat Shading)된 다각형과 구로 셰이딩(Gouraud Shading)된 다각형을 만듭니다.

fill3(X,Y,Z,C)는 3차원 다각형을 채웁니다. X, Y, Z는 다각형 꼭짓점을 지정합니다. X, Y 또는 Z가 행렬인 경우 fill3은 n개 다각형을 만듭니다. 여기서 n은 행렬의 열 개수입니다. fill3은 필요한 경우 마지막 꼭짓점을 첫 번째 꼭짓점에 연결하여 다각형을 닫습니다. X, Y, Z의 값은 숫자형, datetime형, duration형 또는 categorical형 값일 수 있습니다.

C는 색을 지정합니다. C는 현재 컬러맵에 대한 인덱스 벡터 또는 행렬입니다. C가 행 벡터인 경우 length(C)는 size(X,2), size(Y,2)와 동일해야 합니다. C가 열 벡터인 경우 length(C)는 size(X,1), size(Y,1)과 동일해야 합니다.

fill3(X,Y,Z,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]은 연한 파란색을 지정합니다.

fill3(X1,Y1,Z1,C1,X2,Y2,Z2,C2,...)는 채워진 3차원 영역을 여러 개 지정합니다.

fill3(...,'PropertyName',PropertyValue)를 사용하면 특정 patch 속성의 값을 설정할 수 있습니다.

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

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

예제

채워진 3차원 다각형 생성

보간된 색으로 삼각형 4개를 만듭니다.

X = [0 1 1 2; 1 1 2 2; 0 0 1 1];
Y = [1 1 1 1; 1 0 1 0; 0 0 0 0];
Z = [1 1 1 1; 1 0 1 0; 0 0 0 0];
C = [0.5000 1.0000 1.0000 0.5000;
     1.0000 0.5000 0.5000 0.1667;
     0.3330 0.3330 0.5000 0.5000];

figure
fill3(X,Y,Z,C)

알고리즘

X, Y, Z가 동일한 크기의 행렬인 경우 fill3은 대응하는 X, Y, Z의 요소(동일한 행렬 위치에 있는 요소)로 꼭짓점을 만들고 각 열의 데이터별로 다각형 하나를 생성합니다.

X, Y 또는 Z가 행렬인 경우 fill3은 열 벡터 인수를 복제하여 필요한 크기의 행렬을 생성합니다.

ColorSpec 인수를 사용하여 색을 지정하는 경우 fill3은 플랫 셰이딩(Flat Shading)된 다각형을 생성하고 Patch 객체의 FaceColor 속성을 RGB 3색으로 설정합니다.

C를 사용하여 색을 지정하는 경우 fill3은 현재 컬러맵을 인덱싱하기 전에 색 축 스케일링 파라미터를 지정하는 axes 속성 CLim 값으로 CLim의 요소를 스케일링합니다.

C가 행 벡터인 경우 fill3은 플랫 셰이딩(Flat Shading)된 다각형을 생성하고 Patch 객체의 FaceColor 속성을 'flat'으로 설정합니다. 각 요소는 대응하는 각 Patch 객체의 CData 속성값이 됩니다.

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

호환성 관련 고려 사항

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

R2021a에서 동작이 변경됨

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

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

예를 들어, 다음 코드는 datetimte형 x 좌표를 사용하여 채워진 3차원 다각형을 만듭니다. 그런 다음 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];
z = [0 0 1 1];
h = fill3(x,y,z,'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) 항목을 참조하십시오.

참고 항목

함수

• fill | axis | colormap | caxis | patch

속성

• Patch 속성

도움말 항목

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

R2006a 이전에 개발됨

×

예제 열기

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

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