annotation

주석 생성

구문

annotation(lineType,x,y)

annotation(lineType)

annotation(shapeType,dim)

annotation(shapeType)

annotation(___,Name,Value)

annotation(container,___)

an = annotation(___)

설명

annotation(lineType,x,y)는 현재 Figure의 두 점 사이에서 연장되는 선 주석이나 화살표 주석을 만듭니다. lineType을 'line', 'arrow', 'doublearrow', 'textarrow' 중 하나로 지정합니다. x와 y를 각각 [x_begin x_end]와 [y_begin y_end] 형식의, 요소를 2개 가진 벡터로 지정합니다.

annotation(lineType)은 점 (0.3,0.3)과 (0.4,0.4) 사이의 디폴트 위치에 주석을 만듭니다.

annotation(shapeType,dim)은 현재 Figure에 특정 크기와 위치를 갖는 사각형, 타원 또는 텍스트 상자 주석을 만듭니다. shapeType을 'rectangle', 'ellipse', 'textbox' 중 하나로 지정합니다. dim을 [x y w h] 형식의, 요소를 4개 가진 벡터로 지정합니다. x와 y 요소는 위치를 지정하고, w와 h 요소는 크기를 지정합니다.

annotation(shapeType)은 왼쪽 아래 코너가 (0.3,0.3)에 오고 너비와 높이가 모두 0.1이 되도록 디폴트 위치에 주석을 만듭니다.

annotation(___,Name,Value)는 주석을 만들고 속성을 이름-값 쌍의 인수로 지정합니다. 주석의 유형마다 서로 다른 속성을 지원합니다. 위에 열거된 구문에 나와 있는 입력 인수를 조합하여 속성을 지정할 수 있습니다.

annotation(container,___)는 현재 Figure 대신, container로 지정된 Figure, uipanel 또는 uitab에 주석을 만듭니다.

an = annotation(___)은 annotation 객체를 반환합니다. 반환되는 객체 유형은 첫 번째 입력 인수에 따라 다릅니다. 객체 생성 후에 속성을 수정하려면 an을 사용하십시오. 위에 열거된 구문 중 하나와 함께 출력 인수를 지정할 수 있습니다.

예제

텍스트 화살표 주석 만들기

간단한 선 플롯을 생성하고 Figure에 텍스트 화살표를 추가합니다. 점 (0.3,0.6)에서 시작하고 (0.5,0.5)에서 끝나는 텍스트 화살표 위치를 정규화된 Figure 좌표값으로 지정합니다. String 속성을 설정하여 텍스트 설명을 지정합니다.

figure
plot(1:10)
x = [0.3 0.5];
y = [0.6 0.5];
annotation('textarrow',x,y,'String','y = x ')

텍스트 상자 주석 만들기

간단한 선 플롯을 생성하고 Figure에 텍스트 상자 주석을 추가합니다. String 속성을 설정하여 텍스트 설명을 지정합니다. FitBoxToText 속성을 'on'으로 설정하여 상자가 텍스트 둘레에 꼭 맞게 강제로 조정합니다.

figure
plot(1:10)
dim = [.2 .5 .3 .3];
str = 'Straight Line Plot from 1 to 10';
annotation('textbox',dim,'String',str,'FitBoxToText','on');

FitBoxToText 속성을 설정하지 않고 텍스트 상자 주석을 만듭니다. 지정된 너비와 높이가 텍스트 상자에 사용되고, 필요에 따라 텍스트가 줄 바꿈됩니다.

figure
plot(1:10)
dim = [.2 .5 .3 .3];
str = 'Straight Line Plot from 1 to 10';
annotation('textbox',dim,'String',str)

여러 줄로 된 텍스트를 포함하는 텍스트 상자 주석 만들기

String 속성을 셀형 배열로 설정하여 여러 줄로 된 텍스트를 포함하는 텍스트 상자 주석을 만듭니다. 셀형 배열 내 각 요소는 개별의 줄에 따로 표시됩니다. FitBoxToText 속성을 'on'으로 설정하여 상자가 텍스트 둘레에 꼭 맞게 강제로 조정합니다.

figure
plot(1:10)
dim = [0.2 0.5 0.3 0.3];
str = {'Straight Line Plot','from 1 to 10'};
annotation('textbox',dim,'String',str,'FitBoxToText','on');

사각형 주석 만들기

줄기 플롯을 생성하고 Figure에 사각형 주석을 추가합니다. Color 속성을 지정하여 사각형 윤곽선의 색을 변경합니다.

figure
data = [2 4 6 7 8 7 5 2];
stem(data)
dim = [.3 .68 .2 .2];
annotation('rectangle',dim,'Color','red')

Figure에 두 번째 사각형 주석을 추가합니다. FaceColor 속성을 설정하여 채우기 색을 지정합니다. FaceAlpha 속성을 0(완전 투명)과 1(완전 불투명) 사이의 값으로 설정하여 투명도를 추가합니다.

dim2 = [.74 .56 .1 .1];
annotation('rectangle',dim2,'FaceColor','blue','FaceAlpha',.2)

타원 주석 만들기

간단한 선 플롯을 생성하고 Figure에 타원 주석을 추가합니다. dim을 타원을 둘러싸는 가장 작은 사각형의 크기와 위치로 지정합니다.

figure
x = linspace(-4,4);
y = x.^3 - 12*x;
plot(x,y)

dim = [.2 .74 .25 .15];
annotation('ellipse',dim)

동일한 크기를 사용하여 빨간색 사각형을 그려서 타원이 사각형 영역을 채운 모습을 표시합니다.

annotation('rectangle',dim,'Color','red')

두 가지 유형의 주석 결합하기

단순한 선 플롯을 생성합니다. 그런 다음, 선 주석과 화살표 주석을 결합하여 그래프에 구부러진 화살표를 추가합니다.

figure
plot(1:10)

xl = [.3 .3];
yl = [.3 .4];
annotation('line',xl,yl)

xa = [.3 .4];
ya = [.4 .4];
annotation('arrow',xa,ya)

주석 생성 후에 수정하기

Figure에 텍스트 화살표를 추가하고 annotation text arrow 객체 a를 반환합니다.

figure
plot(1:10)
x = [0.3,0.5];
y = [0.6,0.5];
a = annotation('textarrow',x,y,'String','y = x ');

a를 사용하여 주석 텍스트 화살표의 속성을 수정합니다. 예를 들어, 색을 빨간색으로 변경하고 글꼴 크기를 14포인트로 변경합니다.

a.Color = 'red';
a.FontSize = 14;

각 주석 유형의 속성 목록을 보려면 annotation 속성 페이지를 참조하십시오.

입력 인수

lineType — 선 주석의 유형

'line' | 'arrow' | 'doublearrow' | 'textarrow'

선 주석의 유형으로, 다음 값 중 하나로 지정됩니다.

값	객체의 유형	예
'line'	주석 선	annotation('line',[.1 .2],[.1 .2])
'arrow'	주석 화살표	annotation('arrow',[.1 .2],[.1 .2])
'doublearrow'	주석 양방향 화살표	annotation('doublearrow',[.1 .2],[.1 .2])
'textarrow'	주석 텍스트 화살표. 텍스트 화살표의 뒤쪽 끝에 텍스트를 추가하려면 String 속성을 사용하십시오.	annotation('textarrow',[.1 .2],[.1 .2],'String','my text')

shapeType — 도형 주석의 유형

'rectangle' | 'ellipse' | 'textbox'

도형 주석의 유형으로, 다음 값 중 하나로 지정됩니다.

값	객체의 유형	예
'rectangle'	주석 사각형	annotation('rectangle',[.2 .3 .4 .5])
'ellipse'	주석 타원	annotation('ellipse',[.2 .3 .4 .5])
'textbox'	주석 텍스트 상자. 텍스트를 지정하려면 String 속성을 설정하십시오. 상자의 크기를 텍스트 둘레에 꼭 맞게 자동으로 조정하려면 FitBoxToText 속성을 'on'으로 설정하십시오.	annotation('textbox',[.2 .3 .4 .5],'String','my text','FitBoxToText','on')

x — 시작과 끝 x 좌표

[x_begin x_end] 형식의, 요소를 2개 가진 벡터

시작과 끝 x 좌표로, [x_begin x_end] 형식의, 요소를 2개 가진 벡터로 지정됩니다. x와 y 입력 인수가 함께 선 주석, 화살표 주석, 양방향 화살표 주석 또는 텍스트 화살표 주석의 끝점을 지정합니다. 주석은 점 (x_begin, y_begin)에서 (x_end, y_end)까지 연장됩니다.

기본적으로 단위는 Figure에 대해 정규화됩니다. Figure의 왼쪽 아래 코너는 (0,0)에 매핑되고 오른쪽 위 코너는 (1,1)에 매핑됩니다. 단위를 변경하려면 Units 속성을 사용하십시오.

예: x = [.3 .5]

y — 시작과 끝 y 좌표

[y_begin y_end] 형식의, 요소를 2개 가진 벡터

시작과 끝 y 좌표로, [y_begin y_end] 형식의, 요소를 2개 가진 벡터로 지정됩니다. x와 y 입력 인수가 함께 선 주석, 화살표 주석, 양방향 화살표 주석 또는 텍스트 화살표 주석의 끝점을 지정합니다. 주석은 점 (x_begin, y_begin)에서 (x_end, y_end)까지 연장됩니다.

기본적으로 단위는 Figure에 대해 정규화됩니다. Figure의 왼쪽 아래 코너는 (0,0)에 매핑되고 오른쪽 위 코너는 (1,1)에 매핑됩니다. 단위를 변경하려면 Units 속성을 사용하십시오.

예: y = [.3 .5]

dim — 크기와 위치

[x y w h] 형식의, 요소를 4개 가진 벡터

크기와 위치로, [x y w h] 형식의, 요소를 4개 가진 벡터로 지정됩니다. 처음 두 개의 요소는 Figure의 왼쪽 아래 코너를 기준으로 텍스트 상자, 사각형 또는 타원의 왼쪽 아래 코너 좌표를 지정합니다. 그 다음 두 개 요소는 각각 주석의 너비와 높이를 지정합니다.

타원을 만드는 경우 dim은 타원을 둘러싸는 가장 작은 사각형의 크기와 위치입니다.

기본적으로 단위는 Figure에 대해 정규화됩니다. Figure의 왼쪽 아래 코너는 (0,0)에 매핑되고 오른쪽 위 코너는 (1,1)에 매핑됩니다. 단위를 변경하려면 Units 속성을 사용하십시오.

예: dim = [.3 .4 .5 .6]

container — 주석의 대상

figure 객체 | uipanel 객체 | uitab 객체

주석의 대상으로, figure 객체, uipanel 객체, uitab 객체 중 하나로 지정됩니다. 예를 들어, 특정 Figure에 주석을 추가하려면 원하는 figure 객체를 함수에 대한 첫 번째 입력 인수로 지정하십시오.

f = figure;
annotation(f,'line',[.1 .2],[.2 .3])

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: annotation('rectangle',[.5 .5 .1 .1],'EdgeColor','r')은 빨간색 윤곽선을 갖는 사각형 주석을 만듭니다.

각 유형의 annotation 객체는 서로 다른 속성 모음을 지원합니다. 전체 속성 목록과 각 유형에 대한 설명을 보려면 관련 속성 페이지를 참조하십시오.

• Line 속성

• Arrow 속성

• DoubleEndArrow 속성

• TextArrow 속성

• TextBox 속성

• Rectangle 속성

• Ellipse 속성

출력 인수

an — annotation 객체

스칼라

annotation 객체로, 스칼라로 반환됩니다. 반환되는 annotation 객체 유형은 첫 번째 입력 인수에 따라 달라집니다.

첫 번째 입력 인수	반환되는 객체의 유형	속성 페이지
'line'	선	Line 속성
'arrow'	화살표	Arrow 속성
'doublearrow'	양방향 화살표	DoubleEndArrow 속성
'textarrow'	텍스트 화살표	TextArrow 속성
'textbox'	텍스트 상자	TextBox 속성
'rectangle'	사각형	Rectangle 속성
'ellipse'	타원	Ellipse 속성

세부 정보

호환성 관련 고려 사항

R2014b부터 주석이 uipanel 경계를 넘지 못하게 되었습니다. 대신, 넘어가는 주석은 경계에서 잘리게 됩니다. 이전 버전의 MATLAB^®에서는 주석이 경계 안(또는 바깥)으로 연장되는 것을 허용합니다. 특정 Figure, uipanel 또는 uitab 내에 주석을 표시하려면 container 입력 인수를 사용하십시오.

버전 내역

R2006a 이전에 개발됨

참고 항목

함수

• rectangle | text

속성

• Line 속성 | Arrow 속성 | DoubleEndArrow 속성 | TextArrow 속성 | TextBox 속성 | Rectangle 속성 | Ellipse 속성

도움말 항목

• 차트에 텍스트 추가하기