Main Content

insertMarker

영상 또는 비디오에 마커 삽입

설명

예제

RGB = insertMarker(I,position)은 트루컬러 또는 회색조 영상 I에 플러스(+) 마커를 삽입합니다. 이 함수는 지정된 위치의 픽셀 값을 덮어써서 마커를 그립니다. 출력 영상 RGB는 항상 트루컬러 영상입니다.

RGB = insertMarker(I,position,marker)는 지정된 마커 유형 marker의 마커를 삽입합니다.

RGB = insertMarker(___,Name=Value)는 위에 열거된 구문의 입력 인수의 조합 외에 하나 이상의 이름-값 인수를 사용하여 옵션을 지정합니다. 예를 들어 MarkerColor="red"는 삽입된 위치 마커를 빨간색으로 렌더링하도록 지정합니다.

예제

모두 축소

영상을 작업 공간으로 읽어 들입니다.

I = imread("peppers.png");

영상의 지정된 위치에 플러스(+) 마커를 삽입합니다.

RGB = insertMarker(I,[147 279]);

4개의 십자(x) 마커마다 위치, 색, 크기를 지정해서 영상에 삽입합니다.

pos = [120 248; 195 246; 195 312; 120 312];
color = {"red","white","green","magenta"};
RGB = insertMarker(RGB,pos,"x",MarkerColor=color,Size=10);

영상을 표시합니다.

imshow(RGB)

Figure contains an axes object. The axes object contains an object of type image.

입력 인수

모두 축소

입력 영상으로, M×N×3 트루컬러 영상 또는 M×N 회색조 영상으로 지정됩니다.

데이터형: single | double | int16 | uint8 | uint16

마커 위치로, 각 행이 [x y] 형식의 영상 좌표 쌍인 M×2 행렬 또는 Point Feature Types 페이지에 나열된 점 객체로 구성된 요소를 M개 가진 벡터로 지정됩니다. M은 영상에 삽입할 마커 개수입니다. 함수는 각 마커의 위치를 행렬의 [x y] 좌표 쌍 또는 대응하는 특징점 객체의 Location 속성값으로 정의합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

마커 유형으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 전체 텍스트 이름 또는 대응하는 기호를 사용하여 마커 유형을 지정할 수 있습니다.

전체 텍스트 이름기호
"circle""o"
"x-mark""x"
"plus""+"
"star""*"
"square""s"

데이터형: char | string

이름-값 인수

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

예: insertMarker(I,position,Color="yellow")는 마커 색을 노란색으로 설정합니다.

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

예: insertMarker(I,position,"Color","yellow")는 마커 색을 노란색으로 설정합니다.

마커 크기(단위: 픽셀)로, [1,Inf) 범위의 스칼라로 지정됩니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

마커 색으로, 짧은 색 이름, 색 이름, 색 이름으로 구성된 벡터 또는 RGB 3색으로 구성된 3열 행렬로 지정됩니다.

지원되는 색이 나열된 아래 표에는 RGB 농도의 범위가 [0, 1]로 되어 있지만, 선택된 데이터형에 해당하는 범위 내에서 RGB 3색을 지정해야 합니다. 예를 들어, 이 인수를 uint8형 값으로 구성된 행렬로 지정하는 경우 각 농도값을 [0, 255] 범위로 변환해야 합니다. 나열된 농도값을 uint8 데이터형으로 변환하려면 코드 uint8(255*intensity)를 사용합니다. 여기서 농도는 표에 나열된 RGB 3색 값입니다.

각 마커에 서로 다른 색을 지정하거나 모든 마커에 하나의 색을 지정할 수 있습니다. 모든 마커에 대해 하나의 색을 지정하려면 MarkerColor를 색 이름 또는 [R G B] 벡터로 지정하십시오.

사양형식
모든 형태(또는 마커)에 하나의 색 지정

짧은 색 이름 또는 색 이름

"r"

"red"

RGB 3색

[1 0 0]1-by-3 grid, with columns labeled r,g,b respectively.

각 형태(또는 마커)마다 색 지정

색 이름으로 구성된 벡터

["red","yellow","blue"]

RGB 3색으로 구성된 3열 행렬

[1 0 0
 0 1 1
 1 0 1
 1 1 1]
M-by-3 grid, with columns labeled r,g,b respectively.

다음 표에는 지원되는 마커 색이 나와 있습니다.

색 이름짧은 이름RGB 3색실제 표시 색
"red""r"[1 0 0]

Sample of the color red

"green""g"[0 1 0]

Sample of the color green

"blue""b"[0 0 1]

Sample of the color blue

"cyan" "c"[0 1 1]

Sample of the color cyan

"magenta""m"[1 0 1]

Sample of the color magenta

"yellow""y"[1 1 0]

Sample of the color yellow

"black""k"[0 0 0]

Sample of the color black

"white""w"[1 1 1]

Sample of the color white

데이터형: logical | uint8 | uint16 | int16 | double | single | cell

출력 인수

모두 축소

출력 영상으로, M×N×3 트루컬러 영상으로 반환됩니다.

확장 기능

버전 내역

R2013a에 개발됨

모두 확장