get_sketch_center

ZumiAI.get_sketch_center(name: str = 'Sketch') → list

스트리밍되는 카메라 영상에서 인식된 스케치의 중심 좌표를 가져옵니다.

이 함수는 sketch_detector_start() 로 스케치 인식이 활성화된 상태에서, 현재 영상에 지정된 name의 스케치가 인식되었다면 해당 스케치의 중심이 되는 x, y 좌표를 리스트 형태로 반환합니다. 이 좌표를 통해 주미가 스케치를 화면의 어느 위치에서 보고 있는지 알 수 있습니다.

매개변수:

name (str, optional) – 중심 좌표를 가져올 스케치의 이름. 기본값은 “Sketch”입니다.

반환:

인식된 스케치의 중심 x, y 좌표를 담은 리스트.

• [0] x축 위치 (int): 스케치의 중심 x 좌표.

• [1] y축 위치 (int): 스케치의 중심 y 좌표.

스케치가 인식되지 않았다면 [-1, -1]`을 반환합니다. 예시: `[0, 0] (스트리밍 화면의 중앙)

반환 형식:

list

예제

>>> zumiAI.camera_stream_start()  # 카메라 스트리밍 시작
>>> zumiAI.sketch_detector_init() # 스케치 인식 초기화
>>> zumiAI.sketch_detector_start() # 스케치 인식 시작

>>> while True:
>>>     center_x, center_y = zumiAI.get_sketch_center(name="my_drawing")
>>>     if center_x != -1 or center_y != -1: # 스케치가 감지되어 유효한 좌표가 반환된 경우
>>>         print(f"스케치 'my_drawing'의 중심 좌표: X={center_x}, Y={center_y}")
>>>     else:
>>>         print("'my_drawing' 스케치 감지 대기 중...")
>>>     time.sleep(1) # 1초 대기

>>> zumiAI.sketch_detector_stop() # 스케치 인식 중지

참고

• 이 함수를 사용하기 전에 camera_stream_start() 로 영상 스트리밍을 시작하고, sketch_detector_init() 로 스케치 인식 기능을 초기화한 후, sketch_detector_start() 를 호출하여 스케치 인식을 활성화해야 합니다.

• 반환되는 좌표는 스트리밍 영상 화면의 크기(해상도)에 따라 달라질 수 있습니다.

• 스케치 인식은 흰 종이에 검은 펜으로 사각형 테두리를 그리고, 그 안에 그린 그림을 보여줄 때 가장 잘 작동합니다.

• 이 기능은 주미 자체의 하드웨어 기능이 아니라, PC 기반 소프트웨어로 처리됩니다.