rounded_rect — ANNOTATE shape op

• 데이터 종류: image2d → image2d

• 호출: import fullseye as fs; fs.ledger.rounded_rect(img, rect, radius=8, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito')(구현을 직접 호출하려면 import annotate; annotate.rounded_rect(img, rect, radius=8, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito'), 원장에서 가져오려면 opsannotate.get("rounded_rect"))

사용법

모서리가 둥근 사각형(fill=True 면 칠하기). 밑판이나 둘러싸기에 씁니다.

Raises

ValueError

사각형이 영상 밖, radius가 음이거나 변의 절반을 넘음, alpha가 [0,1] 밖.

그리기: 화소 중심에서 "모서리를 둥글게 한 사각형"까지의 거리로 안쪽을 판정하며, fill=False 이면 외곽에서 max(1, width) px 폭의 띠만 얹는다(거리 판정 1단계, 안티에일리어싱 없음). 합성은 out = m*color + (1-m)*img에 alpha를곱한 것.

• img: (H, W) / (H, W, 1|3|4). float64로 변환하고 [0, 1]로 클립한 복제를 반환한다(입력은 바꾸지 않는다). NaN/Inf는 ValueError.

• rect: (x, y, w, h), x = 열·y = 행. 반올림하여 정수화하고, w, h > 0, 영상 안에 완전히 들어갈 것(삐져나옴은 잘라내지 않고 ValueError). 차지하는 화소는 x .. x+w-1, y .. y+h-1.

• radius: 모서리 반경 [px], 0 <= radius <= min(w, h)/2. 0이면 보통의 사각형.

• color: palette의 역할명("neutral" 등, scheme으로 해결) 또는 [0, 1]의 RGB. 그레이 영상에는 RGB의 평균을 사용한다.

• 반환값: 입력과 같은 형태의 float64.

text_box의 밑판이나 annotate_legend의 테두리와 같은 모양을 손으로 짤 때.

자세한 사용 가이드

• figure_annotation 패밀리 가이드

배경 지식 가이드(이 연산자 앞에 있는 물리·규약)

• dataset_conventions — 학습 데이터셋 규약 지식 — COCO / YOLO / VOC와 외관 검사의 함정

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• annotate_gallery — py -3.11 examples/annotate_gallery.py

• poc_machine_condition_fusion — py -3.11 examples/poc_machine_condition_fusion.py

타입이 이어지는 다음 연산자(image2d 를 입력으로 받는 것)

text_box · arrow · leader_line · label_points · crosshair · legend_box · color_bar · scale_bar

같은 카테고리(shape)

filled_polygon · arc · ellipse


*Provenance: annotate.py — ANNOTATE 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.