ArucoMarker

ArucoMarker (ArUco 마커 찾기)

카메라 영상에서 ArUco 마커를 찾아 ID 별 위치, 크기, 회전, 감지 여부를 제공하는 ArUco 마커 찾기 AI 확장 모듈입니다.

인스턴스 선언

aruco_marker = ArucoMarker(0)

이름	구분	설명	범위 / 종류	기본값
index	드롭다운 옵션	인스턴스 번호 (0부터 시작)	0 이상 정수	0

함수

device

ArUco 마커 찾기에 사용할 카메라 장치를 선택합니다. 카메라 이름(문자열), 인덱스, 또는 Camera 객체를 전달할 수 있습니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
unit	드롭다운 옵션	카메라 지정 값	카메라 라벨(str) / 인덱스(int) / Camera 객체	-

예제

aruco_marker = ArucoMarker(0)

aruco_marker.device('')

---

max_count

동시에 인식할 ArUco 마커의 최대 개수를 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
data	입력값 (블록)	최대 마커 수	0 ~ 10 정수	-

예제

aruco_marker = ArucoMarker(0)

aruco_marker.max_count(5)

---

detect_once

ArUco 마커를 한 번만 인식합니다.

매개변수: 없음

예제

aruco_marker = ArucoMarker(0)

aruco_marker.detect_once()

---

detect_continuous

ArUco 마커를 연속적으로 인식하기 시작합니다.

매개변수: 없음

예제

aruco_marker = ArucoMarker(0)

aruco_marker.detect_continuous()

---

stop

연속 마커 인식을 정지합니다.

매개변수: 없음

예제

aruco_marker = ArucoMarker(0)

aruco_marker.stop()

---

display

마커 인식 결과를 카메라 화면에 표시할지 여부를 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
on	드롭다운 옵션	표시 ON / OFF	표시(True/1), 숨기기(False/0)	True

예제

aruco_marker = ArucoMarker(0)

aruco_marker.display(True)
aruco_marker.display(False)

---

marker

지정한 마커 ID 의 위치/크기/회전 값을 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
data	입력값 (블록)	마커 ID	0 이상 정수	-
unit	드롭다운 옵션	측정 종류	x, y, min_x, max_x, min_y, max_y, width, height, area, rotation	-

반환값 — 지정한 측정 값 (정수)

예제

aruco_marker = ArucoMarker(0)

aruco_marker.marker(0, 'x')
aruco_marker.marker(3, 'area')

---

get_distance

두 마커 사이의 거리를 반환합니다. type 을 생략하면 직선 거리를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
unit1	입력값 (블록)	첫 번째 마커 ID	0 이상 정수	-
unit2	입력값 (블록)	두 번째 마커 ID	0 이상 정수	-
type	드롭다운 옵션	거리 종류	직선 거리(생략 또는 None), 수평 거리('horizontal'), 수직 거리('vertical')	None

반환값 — 두 마커 사이의 거리 (실수)

예제

aruco_marker = ArucoMarker(0)

aruco_marker.get_distance(0, 1)
aruco_marker.get_distance(0, 2, 'horizontal')

---

marker_detected

지정한 ID 의 마커가 감지되었는지 여부를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
data	입력값 (블록)	마커 ID	0 이상 정수	-

반환값 — 감지되었으면 True, 아니면 False (bool)

예제

aruco_marker = ArucoMarker(0)

aruco_marker.marker_detected(0)

---