SelfDriving

SelfDriving (카메라 자율주행하기)

카메라 영상에서 차선 색(빨강/초록/파랑)을 찾아 차선과 색의 위치, 거리, 감지 여부를 제공하는 카메라 자율주행 AI 확장 모듈입니다.

인스턴스 선언

self_driving = SelfDriving(0)

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

함수

device

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

매개변수

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

예제

self_driving = SelfDriving(0)

self_driving.device('')

---

set_lane

왼쪽/오른쪽 차선의 색을 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
left	드롭다운 옵션	왼쪽 차선 색	빨강(red), 초록(green), 파랑(blue)	-
right	드롭다운 옵션	오른쪽 차선 색	빨강(red), 초록(green), 파랑(blue)	-

예제

self_driving = SelfDriving(0)

self_driving.set_lane('green', 'blue')

---

detect_once

차선/색을 한 번만 인식합니다.

매개변수: 없음

예제

self_driving = SelfDriving(0)

self_driving.detect_once()

---

detect_continuous

차선/색을 연속적으로 인식하기 시작합니다.

매개변수: 없음

예제

self_driving = SelfDriving(0)

self_driving.detect_continuous()

---

stop

연속 인식을 정지합니다.

매개변수: 없음

예제

self_driving = SelfDriving(0)

self_driving.stop()

---

display

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

매개변수

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

예제

self_driving = SelfDriving(0)

self_driving.display(True)
self_driving.display(False)

---

lane

지정한 차선의 위치 또는 거리 값을 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
lane	드롭다운 옵션	차선	왼쪽('left'), 오른쪽('right')	-
unit	드롭다운 옵션	측정 종류	x, 거리('distance')	-

반환값 — 지정한 측정 값 (정수)

예제

self_driving = SelfDriving(0)

self_driving.lane('left', 'x')
self_driving.lane('right', 'distance')

---

color

지정한 색의 위치/크기 값을 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
color	드롭다운 옵션	색깔 이름	빨강(red), 초록(green), 파랑(blue)	-
unit	드롭다운 옵션	좌표/크기 종류	x, y, min_x, max_x, min_y, max_y, width, height, area	-

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

예제

self_driving = SelfDriving(0)

self_driving.color('red', 'x')
self_driving.color('green', 'y')
self_driving.color('blue', 'area')

---

get_distance

두 색 사이의 거리를 반환합니다. type 을 생략하거나 'line' 으로 지정하면 직선 거리를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
unit1	드롭다운 옵션	첫 번째 색	빨강(red), 초록(green), 파랑(blue)	-
unit2	드롭다운 옵션	두 번째 색	빨강(red), 초록(green), 파랑(blue)	-
type	드롭다운 옵션	거리 종류	직선 거리(생략, None 또는 'line'), 수평 거리('horizontal'), 수직 거리('vertical')	None

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

예제

self_driving = SelfDriving(0)

self_driving.get_distance('red', 'blue', 'line')
self_driving.get_distance('green', 'blue', 'horizontal')

---

lane_detected

지정한 차선이 감지되었는지 여부를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
lane	드롭다운 옵션	차선	왼쪽('left'), 오른쪽('right'), 둘 다('both'), 어느 쪽이든('any')	'any'

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

예제

self_driving = SelfDriving(0)

self_driving.lane_detected('left')
self_driving.lane_detected('right')
self_driving.lane_detected('both')
self_driving.lane_detected('any')

---

color_detected

지정한 색이 감지되었는지 여부를 반환합니다. 'any' 를 지정하면 어떤 색이라도 감지되었는지 확인합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
color	드롭다운 옵션	색깔 이름 (또는 어느 색이든)	빨강(red), 초록(green), 파랑(blue), 어떤 색이든('any')	'any'

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

예제

self_driving = SelfDriving(0)

self_driving.color_detected('red')
self_driving.color_detected('green')
self_driving.color_detected('blue')
self_driving.color_detected('any')

---