insertMarker

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

구문

RGB = insertMarker(I,position)

RGB = insertMarker(I,position,marker)

RGB = insertMarker(___,Name=Value)

설명

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 hidden axes object contains an object of type image.

입력 인수

모두 축소

`I` — 입력 영상
M×N×3 트루컬러 영상 | M×N 회색조 영상

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

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

`position` — 마커 위치
M×2 행렬 | 점 객체로 구성된 요소를 M개 가진 벡터

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

`marker` — 마커 유형
`"plus"` (디폴트 값) | 문자형 벡터 | string형 스칼라

마커 유형으로, 문자형 벡터 또는 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")는 마커 색을 노란색으로 설정합니다.

`Size` — 마커 크기
`3` (디폴트 값) | 스칼라

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

`MarkerColor` — 마커 색
`"green"` (디폴트 값) | 짧은 색 이름 | 색 이름 | 색 이름으로 구성된 벡터 | RGB 3색으로 구성된 3열 행렬

마커 색으로, 짧은 색 이름, 색 이름, 색 이름으로 구성된 벡터 또는 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]`
각 형태(또는 마커)마다 색 지정	색 이름으로 구성된 벡터	`["red","yellow","blue"]`
각 형태(또는 마커)마다 색 지정	RGB 3색으로 구성된 3열 행렬	[1 0 0 0 1 1 1 0 1 1 1 1]

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

색 이름	짧은 이름	RGB 3색
`"red"`	`"r"`	`[1 0 0]`
`"green"`	`"g"`	`[0 1 0]`
`"blue"`	`"b"`	`[0 0 1]`
`"cyan"`	`"c"`	`[0 1 1]`
`"magenta"`	`"m"`	`[1 0 1]`
`"yellow"`	`"y"`	`[1 1 0]`
`"black"`	`"k"`	`[0 0 0]`
`"white"`	`"w"`	`[1 1 1]`