-
Notifications
You must be signed in to change notification settings - Fork 0
Turtle
터틀 로봇을 제어하기 위한 함수입니다.
터틀은 바퀴 주행, 선 따라가기, 머리 LED, 버저/사운드, 바닥 컬러 센서, 가속도/버튼 등 다양한 입출력을 제공합니다.
turtle = Turtle(0)| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| index | 입력값 | 인스턴스 번호 (0부터 시작) | 0 이상 정수 | 0 |
터틀의 바퀴 속도를 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 바퀴 종류 | 왼쪽(left), 오른쪽(right), 양쪽(both) | - |
| speed | 입력값 | 바퀴 속도 | -100 ~ 100 실수, 0: 정지 | - |
예제
turtle = Turtle(0)
turtle.set_wheel_speed('both', 50)터틀이 이동할 거리를 설정합니다. 기다리기를 체크하면, 이동이 완료될 때까지 기다립니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| data | 입력값 | 이동 거리 | 실수 | - |
| unit | 드롭다운 옵션 | 거리 단위 | cm, mm, 인치(inch) | cm |
| wait | 체크박스 | 완료 대기 여부 | True / False | True |
예제
turtle = Turtle(0)
turtle.move_distance(50, 'cm', wait=True)터틀이 이동할 시간을 설정합니다. 기다리기를 체크하면, 이동이 완료될 때까지 기다립니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| data | 입력값 | 이동 시간 (초) | 0 이상 실수 | - |
| wait | 체크박스 | 완료 대기 여부 | True / False | True |
예제
turtle = Turtle(0)
# wait = True
turtle.move_time(5, wait=True)
# wait = False
turtle.move_time(0.5, wait=False)터틀이 제자리에서 회전할 방향과 각도를 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| direction | 드롭다운 옵션 | 회전 방향 | 왼쪽(left), 오른쪽(right) | - |
| data | 입력값 | 회전 각도 (도) | 0 이상 실수 | - |
| wait | 체크박스 | 완료 대기 여부 | True / False | True |
예제
turtle = Turtle(0)
turtle.turn_degree('left', 90, wait=True)터틀의 바퀴 속도를 변경합니다. 현재의 바퀴 속도에 입력한 속도를 더한 값이 새로운 바퀴 속도가 됩니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 바퀴 종류 | 왼쪽(left), 오른쪽(right), 양쪽(both) | - |
| speed | 입력값 | 변경할 속도 차 | 실수 | - |
예제
turtle = Turtle(0)
turtle.change_wheel_speed('both', 10)터틀의 이동을 멈춥니다.
매개변수: 없음
예제
turtle = Turtle(0)
turtle.stop()터틀의 바퀴가 움직이고 있는지 아닌지 여부를 참(True) / 거짓(False)으로 반환합니다.
매개변수: 없음
반환값: 바퀴가 움직이는 중이면 True, 멈춰 있으면 False (bool)
예제
turtle = Turtle(0)
turtle.wheel_moving()터틀이 한쪽 바퀴를 기준으로 회전할 기준과 방향, 각도를 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| base | 드롭다운 옵션 | 회전 기준 | left_pen, right_pen, left_wheel, right_wheel | - |
| direction | 드롭다운 옵션 | 회전 방향 | 앞(forward), 뒤(backward) | - |
| degree | 입력값 | 회전 각도 (도) | 0 이상 실수 | - |
| wait | 체크박스 | 완료 대기 여부 | True / False | True |
예제
turtle = Turtle(0)
turtle.pivot('left_wheel', 'forward', 90, wait=True)터틀이 원을 그리며 회전합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| direction | 드롭다운 옵션 | 회전 방향 | 왼쪽 앞(left_forward), 왼쪽 뒤(left_backward), 오른쪽 앞(right_forward), 오른쪽 뒤(right_backward) | - |
| degree | 입력값 | 회전 각도 (도) | 0 이상 실수 | - |
| radius | 입력값 | 회전 반지름 | 0 이상 실수 | - |
| unit | 드롭다운 옵션 | 반지름 단위 | cm, mm, 인치(inch) | cm |
| wait | 체크박스 | 완료 대기 여부 | True / False | True |
예제
turtle = Turtle(0)
turtle.pivot_circle('left_forward', 90, 1, 'cm', wait=True)터틀이 바닥의 컬러 센서를 이용하여 특정한 색의 선을 따라갑니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| line | 드롭다운 옵션 | 따라갈 선 색 | 검정(black), 빨강(red), 초록(green), 파랑(blue), 모든 색(any) | black |
예제
turtle = Turtle(0)
turtle.trace_line('black')터틀이 지정한 색 선을 따라 이동하다가, 다른 색을 만나면 멈춥니다. 검정 선을 따라 빨강을 만날 때까지, 빨강 선을 따라 검정을 만날 때까지 등 다양한 조합을 사용할 수 있습니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| line | 드롭다운 옵션 | 따라갈 선 색 | 검정(black), 빨강(red), 초록(green), 파랑(blue), 모든 색(any) | - |
| color | 드롭다운 옵션 | 멈출 색 | 검정(black), 빨강(red), 초록(green), 청록(cyan), 파랑(blue), 자홍(magenta), 모든 색(any) | - |
| wait | 체크박스 | 완료 대기 여부 | True / False | True |
예제
turtle = Turtle(0)
turtle.trace_line_until_color('black', 'red', wait=True)터틀이 교차로를 인식하면 지정된 행동을 합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| direction | 드롭다운 옵션 | 교차로 행동 | 앞으로(forward), 왼쪽(left), 오른쪽(right), 유턴(uturn) | - |
| wait | 체크박스 | 완료 대기 여부 | True / False | True |
예제
turtle = Turtle(0)
turtle.trace_intersection('left', wait=True)터틀의 선 따라가기 속도를 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| data | 입력값 | 선 따라가기 속도 | 1 ~ 10 정수 | - |
예제
turtle = Turtle(0)
turtle.set_trace_speed(5)터틀의 선 따라가기 방향 변화량을 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| data | 입력값 | 방향 변화량 | 1 ~ 10 정수 | - |
예제
turtle = Turtle(0)
turtle.set_trace_gain(5)터틀의 선 따라가기 기능을 종료합니다.
매개변수: 없음
예제
turtle = Turtle(0)
turtle.stop_trace()터틀의 머리 LED 색을 설정합니다. 색 이름 문자열 하나를 전달하거나, R/G/B 세 값을 각각 전달할 수 있습니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| r | 입력값 (색상 또는 빨강) | 색 이름 문자열 또는 빨강(R) 값 | black, red, yellow, green, cyan, blue, magenta, white / 0 ~ 255 정수 | - |
| g | 입력값 | 초록(G) 값 (r이 숫자일 때 사용) | 0 ~ 255 정수 | None |
| b | 입력값 | 파랑(B) 값 (r이 숫자일 때 사용) | 0 ~ 255 정수 | None |
예제
turtle = Turtle(0)
# 색 이름으로 설정
turtle.set_led_color('red')
# R, G, B 값으로 설정
turtle.set_led_color(255, 128, 0)현재 머리 LED 색에 입력한 R, G, B 변화량을 더해 새로운 색을 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| r | 입력값 | 빨강 변화량 | -255 ~ 255 정수 | - |
| g | 입력값 | 초록 변화량 | -255 ~ 255 정수 | - |
| b | 입력값 | 파랑 변화량 | -255 ~ 255 정수 | - |
예제
turtle = Turtle(0)
turtle.change_led_color(10, 0, 0)터틀의 머리 LED 색을 없앱니다.
매개변수: 없음
예제
turtle = Turtle(0)
turtle.turn_off()지정된 주파수로 터틀의 버저음을 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| hz | 입력값 | 주파수 (Hz) | 0 ~ 6553.5 실수 | - |
예제
turtle = Turtle(0)
turtle.sound_buzz(440)터틀이 지정된 음계를 재생합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| note | 드롭다운 옵션 | 음계 | 도(C), 도#(C#), 레(D), 레#(D#), 미(E), 파(F), 파#(F#), 솔(G), 솔#(G#), 라(A), 라#(A#), 시(B) | - |
| octave | 드롭다운 옵션 | 옥타브 | 1 ~ 7 정수 | 4 |
예제
turtle = Turtle(0)
turtle.sound_note('D', 5)터틀이 특정 사운드 클립을 재생합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| clip | 드롭다운 옵션 | 사운드 클립 이름 | mute, beep, beep2, beep3, beep_repeat, beep_random, beep2_random, beep3_random, beep_random_repeat, siren, siren_repeat, engine, engine_repeat, noise_random, robot, march, birthday, dibidibidip, good_job | - |
| wait | 체크박스 | 완료 대기 여부 | True / False | True |
예제
turtle = Turtle(0)
turtle.sound_clip('siren', wait=True)터틀의 소리를 끕니다.
매개변수: 없음
예제
turtle = Turtle(0)
turtle.sound_off()터틀의 소리가 재생중인지 아닌지 여부를 참(True) / 거짓(False)으로 반환합니다.
매개변수: 없음
반환값: 소리가 재생 중이면 참, 아니면 거짓 (bool)
예제
turtle = Turtle(0)
turtle.sound_playing()터틀의 지정한 바퀴 속도 값을 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 대상 바퀴 | 왼쪽(left), 오른쪽(right) | - |
반환값: 지정한 바퀴의 속도 값 (int 또는 float)
예제
turtle = Turtle(0)
turtle.wheel_speed('left')터틀의 바닥 컬러 센서 값을 반환합니다. 바닥에 그려진 검정 또는 컬러 선을 인식합니다.
매개변수: 없음
반환값: 바닥 컬러 센서 값 (int 또는 float)
예제
turtle = Turtle(0)
turtle.floor()터틀 바닥의 컬러 센서를 통해 읽은 카드의 색깔 이름을 문자열로 반환합니다.
매개변수: 없음
반환값: 인식한 색깔 이름 문자열 (unknown, red, yellow, green, cyan, blue, magenta, white). 인식 실패 시 'unknown'
예제
turtle = Turtle(0)
turtle.card_color()터틀 머리 아래의 센서로 카드를 읽어 '색깔 패턴'을 문자열로 반환합니다.
매개변수: 없음
반환값: 인식한 색깔 패턴 이름 문자열 (예: 'red_yellow'). 인식 실패 시 'unknown'
예제
turtle = Turtle(0)
turtle.card_pattern()지정한 특정 색에 닿았는지 터틀 컬러 센서를 통해 측정하여 참(True) / 거짓(False)으로 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| color | 드롭다운 옵션 | 색깔 이름 | unknown, red, yellow, green, cyan, blue, magenta, white | - |
반환값: 인식한 카드 색이 지정한 색과 일치하면 참, 아니면 거짓 (bool)
예제
turtle = Turtle(0)
turtle.is_card_color('red')컬러센서에 인식된 카드 색깔의 패턴 일치 여부를 참(True) / 거짓(False)으로 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pattern | 드롭다운 옵션 | 카드 패턴 이름 |
red_yellow, red_green, red_cyan, red_blue, red_magenta, yellow_red, yellow_green, yellow_cyan, yellow_blue, yellow_magenta, green_red, green_yellow, green_cyan, green_blue, green_magenta, cyan_red, cyan_yellow, cyan_green, cyan_blue, cyan_magenta, blue_red, blue_yellow, blue_green, blue_cyan, blue_magenta, magenta_red, magenta_yellow, magenta_green, magenta_cyan, magenta_blue
|
- |
반환값: 인식한 카드 패턴이 지정한 패턴과 일치하면 참, 아니면 거짓 (bool)
예제
turtle = Turtle(0)
turtle.is_card_pattern('red_yellow')터틀의 특정 축의 중력 가속도 값을 반환합니다. 측정 범위는 -128 ~ +127 입니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 측정 축 | x, y, z | - |
반환값: 지정한 축의 중력 가속도 값 (-128 ~ +127, int 또는 float)
예제
turtle = Turtle(0)
turtle.acceleration('x')터틀의 내부 온도 센서 값을 반환합니다.
매개변수: 없음
반환값: 내부 온도 센서 값 (int 또는 float)
예제
turtle = Turtle(0)
turtle.temperature()터틀의 신호 세기 값을 반환합니다.
매개변수: 없음
반환값: 신호 세기 값 (int 또는 float)
예제
turtle = Turtle(0)
turtle.signal_strength()터틀의 배터리 전압 값을 반환합니다.
매개변수: 없음
반환값: 배터리 전압 값 (int 또는 float)
예제
turtle = Turtle(0)
turtle.battery()등 버튼의 상태를 확인합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| event | 드롭다운 옵션 | 버튼 상태 종류 | 눌려있는가(pressed), 클릭했는가(click), 길게 클릭했는가(long_click) | - |
반환값: 지정한 버튼 상태에 해당하면 참, 아니면 거짓 (bool)
예제
turtle = Turtle(0)
turtle.button('pressed')