Skip to content

BodyDetection

Jump to bottom
Robomation RnD Center edited this page Jul 8, 2026 · 1 revision

BodyDetection (몸 찾기)

카메라 영상에서 사람의 몸(자세)을 찾아 신체 부위별 좌표를 제공하는 몸 찾기 AI 확장 모듈입니다.

인스턴스 선언

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

함수

device

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

매개변수

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

예제

body_detection = BodyDetection(0)

body_detection.device('')

load_model

몸 찾기 모델을 로드합니다. wait 가 True 이면 모델 로드가 완료될 때까지 최대 15초 동안 기다립니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
wait 체크박스 로드 완료 대기 여부 True / False True

예제

body_detection = BodyDetection(0)

body_detection.load_model(wait=True)

detect_once

몸을 한 번만 인식합니다.

매개변수: 없음

예제

body_detection = BodyDetection(0)

body_detection.detect_once()

detect_continuous

몸을 연속적으로 인식하기 시작합니다.

매개변수: 없음

예제

body_detection = BodyDetection(0)

body_detection.detect_continuous()

stop

연속 몸 인식을 정지합니다.

매개변수: 없음

예제

body_detection = BodyDetection(0)

body_detection.stop()

display

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

매개변수

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

예제

body_detection = BodyDetection(0)

body_detection.display(True)
body_detection.display(False)

nose

코의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.nose('x')

mouth

입의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.mouth('y')

left_eye

왼눈의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_eye('x')

right_eye

오른눈의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_eye('y')

left_ear

왼귀의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_ear('x')

right_ear

오른귀의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_ear('y')

left_shoulder

왼쪽 어깨의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_shoulder('x')

right_shoulder

오른쪽 어깨의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_shoulder('y')

left_elbow

왼쪽 팔꿈치의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_elbow('x')

right_elbow

오른쪽 팔꿈치의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_elbow('y')

left_wrist

왼쪽 손목의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_wrist('x')

right_wrist

오른쪽 손목의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_wrist('y')

left_hand

왼손의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_hand('x')

right_hand

오른손의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_hand('y')

left_hip

왼쪽 엉덩이의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_hip('x')

right_hip

오른쪽 엉덩이의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_hip('y')

left_knee

왼쪽 무릎의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_knee('x')

right_knee

오른쪽 무릎의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_knee('y')

left_ankle

왼쪽 발목의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_ankle('x')

right_ankle

오른쪽 발목의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_ankle('y')

left_foot

왼발의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.left_foot('x')

right_foot

오른발의 좌표를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
pos 드롭다운 옵션 좌표 종류 x, y -

반환값 — 지정한 좌표 값 (정수)

예제

body_detection = BodyDetection(0)

body_detection.right_foot('y')

get_distance

신체 부위 두 곳 사이의 거리를 반환합니다. type 을 생략하면 직선 거리를 반환합니다.

매개변수

이름 구분 설명 범위 / 종류 기본값
unit1 드롭다운 옵션 첫 번째 신체 부위 nose, mouth, left_eye, right_eye, left_ear, right_ear, left_shoulder, right_shoulder, left_elbow, right_elbow, left_wrist, right_wrist, left_hand, right_hand, left_hip, right_hip, left_knee, right_knee, left_ankle, right_ankle, left_foot, right_foot -
unit2 드롭다운 옵션 두 번째 신체 부위 (위 신체 부위와 동일) -
type 드롭다운 옵션 거리 종류 직선 거리(생략 또는 None), 수평 거리('horizontal'), 수직 거리('vertical') None

반환값 — 두 부위 사이의 거리 (실수)

예제

body_detection = BodyDetection(0)

body_detection.get_distance('left_shoulder', 'right_shoulder')
body_detection.get_distance('left_wrist', 'right_wrist', 'horizontal')
body_detection.get_distance('left_hip', 'left_knee', 'vertical')

model_state

몸 찾기 모델의 로드 상태를 정수로 반환합니다.

매개변수: 없음

반환값 — 모델 로드 상태 (정수, 로드 완료 시 2)

예제

body_detection = BodyDetection(0)

body_detection.model_state()

detected

현재 몸이 감지되었는지 여부를 반환합니다.

매개변수: 없음

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

예제

body_detection = BodyDetection(0)

if body_detection.detected():
    print("몸을 찾았습니다")

시작하기에 앞서

초보자를 위한 파이썬 설치 가이드

지원 라이브러리

공통

로봇

AI 확장모듈

치즈스틱 확장모듈

Clone this wiki locally