get_sketch_name

ZumiAI.get_sketch_name(name: str = 'Sketch') → str

스트리밍되는 카메라 영상에서 인식된 스케치의 이름을 가져옵니다.

이 함수는 sketch_detector_start() 로 스케치 인식이 활성화된 상태에서, 현재 영상에 스케치가 인식되었다면 해당 스케치의 이름을 문자열로 반환합니다. 이 이름을 통해 주미가 어떤 스케치를 보고 있는지 확인할 수 있습니다.

매개변수:

name (str, optional) – 이름을 가져올 스케치의 기준이 되는 이름. 기본값은 “Sketch”입니다. (참고: 이 인자는 주로 내부 처리에서 특정 스케치 데이터를 구분하는 데 사용될 수 있습니다.)

반환:

인식된 스케치의 이름.

스케치가 인식되지 않았거나, 지정된 name의 스케치 데이터가 없으면 “None” 반환합니다. 예시: “my_house” (인식된 스케치의 이름)

반환 형식:

str

예제

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

>>> while True:
>>>     detected_name = zumiAI.get_sketch_name(name="circle_drawing")
>>>     if detected_name != "None": # 스케치가 감지되어 유효한 이름이 반환된 경우
>>>         print(f"인식된 스케치 이름: {detected_name}")
>>>         if detected_name == "circle_drawing":
>>>             print("제가 그린 원이네요!")
>>>     else:
>>>         print("스케치 감지 대기 중...")
>>>     time.sleep(1) # 1초 대기

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

참고

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

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

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