gesture_detector_start
- ZumiAI.gesture_detector_start()
스트리밍되는 카메라 영상에서 손 제스처 인식 기능을 시작합니다.
이 함수를 호출하면 주미의 카메라 영상이 PC로 스트리밍될 때, 영상 내에서 인식된 손과 제스처 정보가 자동으로 감지되고 다음과 같이 화면에 표시됩니다:
손 랜드마크: 인식된 손 위에 여러 특징점(관절, 손가락 끝 등)이 표시됩니다.
손 중심점: 손의 중심 x, y 좌표가 표시됩니다.
손 크기: 손의 크기 정보가 표시됩니다.
손가락 상태: 각 손가락(엄지부터 새끼손가락까지)이 굽혀졌는지(0) 펴졌는지(1)를 나타내는 5개의 숫자로 된 리스트(예: [0, 1, 0, 0, 0])가 표시됩니다.
- 인식된 제스처: 인식된 손 모션에 따라 다음과 같은 제스처 이름이 화면에 표시됩니다:
fist (주먹): 모든 손가락이 굽혀진 상태 ([0, 0, 0, 0, 0])
point (가리키기): 검지 손가락만 펴진 상태 ([0, 1, 0, 0, 0])
open (손바닥 펴기): 모든 손가락이 펴진 상태 ([1, 1, 1, 1, 1])
peace (브이): 검지와 중지 손가락이 펴진 상태 ([0, 1, 1, 0, 0])
standby (엄지 제외 펴기): 엄지손가락만 굽혀진 상태 ([1, 1, 0, 0, 0])
thumbs_up (엄지척): 엄지손가락만 펴진 상태 ([1, 0, 0, 0, 0])
None (인식 불가): 위에 해당하지 않는 모든 제스처
이후
is_gesture_detected()
,get_gesture_center()
,get_gesture_size()
,get_gesture_finger()
,get_gesture_recognize()
와 같은 관련 함수를 사용하여 인식된 손 제스처의 다양한 정보를 프로그램 내에서 가져올 수도 있습니다.- 매개변수:
없음
- 반환:
이 함수는 값을 반환하지 않습니다.
예제
>>> zumiAI.camera_stream_start() # 카메라 스트리밍 시작 >>> zumiAI.gesture_detector_init() # 손 제스처 인식 기능 초기화 >>> zumiAI.gesture_detector_start() # PC 화면에서 손 제스처 인식 및 시각화 시작 # 이제 PC 화면의 스트리밍 영상에 인식된 손과 제스처 정보가 표시됩니다. >>> # ... 손 제스처 인식을 사용하는 로직 ... >>> zumiAI.gesture_detector_stop() # 손 제스처 인식 중지
참고
이 함수를 사용하기 전에
camera_stream_start()
로 영상 스트리밍을 시작하고,gesture_detector_init()
로 손 제스처 인식 기능을 초기화해야 합니다.이 기능은 주미 자체의 하드웨어에서 처리되는 기능과는 다릅니다.
한 번에 하나의 손만 인식하도록 설정되어 있습니다.