NeoPixel

NeoPixel (네오픽셀)

CheeseStick 에 연결하는 네오픽셀(NeoPixel) 모듈입니다.
픽셀 한 개 또는 범위 단위로 색, 패턴, 밝기를 제어하고 시프트/회전 애니메이션을 줍니다.

인스턴스 선언

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()

함수

`start`

NeoPixel 을 초기화합니다. 다른 함수를 사용하기 전에 한 번 호출해야 합니다.

매개변수: 없음

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.start()

`mode`

NeoPixel 의 색 채널 모드를 설정합니다. GRBW 는 화이트 채널을 포함하고, GRB 는 RGB 만 사용합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
unit	드롭다운 옵션	색 채널 모드	GRB, GRBW	GRBW

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.mode('GRBW')

`set_one_color`

지정한 번호의 픽셀 한 개에 색을 설정합니다. 두 가지 호출 방식이 있습니다.

색 이름 문자열: 색상 팔레트에서 선택한 색 이름(영문 문자열) 하나를 넘깁니다.
색상 카테고리 블록 / [R, G, B] 배열: Utils.color_rgb(...) 등의 색상 블록 출력을 *(별표)로 언팩하여 R/G/B 세 값으로 넘깁니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
idx	입력값 (필드)	픽셀 번호 (1부터 시작)	1 이상 정수	-
r	색상	색 이름 문자열 (색상 팔레트에서 선택)	색 이름: `'black'`, `'red'`, `'yellow'`, `'green'`, `'cyan'`, `'blue'`, `'magenta'`, `'white'` 중 하나	-
r	입력값 (색상)	빨강 값 (색상 카테고리 블록의 `[R, G, B]` 출력을 풀어서 전달)	0 ~ 255 정수	-
g	입력값 (색상)	초록 값 (r 에 색 이름을 넣은 경우 생략)	0 ~ 255 정수	None
b	입력값 (색상)	파랑 값 (r 에 색 이름을 넣은 경우 생략)	0 ~ 255 정수	None

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()

# 색 이름으로 지정
neopixel.set_one_color(1, 'red')

# 색상 카테고리 블록 / [R, G, B] 배열로 지정
neopixel.set_one_color(1, *Utils.color_rgb(255, 0, 0))

`change_one_color`

지정한 한 픽셀의 현재 RGB 값에 변화량을 더해 새로운 색을 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
idx	입력값 (필드)	픽셀 번호 (1부터 시작)	1 이상 정수	-
r	입력값 (필드)	빨강 변화량	-255 ~ 255 정수	0
g	입력값 (필드)	초록 변화량	-255 ~ 255 정수	0
b	입력값 (필드)	파랑 변화량	-255 ~ 255 정수	0

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.change_one_color(1, 10, 0, 0)

`turn_off_one`

지정한 번호의 픽셀 한 개를 끕니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
idx	입력값 (필드)	픽셀 번호 (1부터 시작)	1 이상 정수	-

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.turn_off_one(1)

`set_range_pattern`

지정한 픽셀 범위에 미리 정의된 색 패턴을 적용합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
from_idx	입력값 (필드)	시작 픽셀 번호 (1부터 시작)	1 이상 정수	-
to_idx	입력값 (필드)	끝 픽셀 번호 (1부터 시작)	1 이상 정수	-
pattern	드롭다운 옵션	색 패턴 이름	`3_colors`, `6_colors`, `12_colors`, `red_green`, `red_blue`, `red_white`, `green_red`, `green_blue`, `green_white`, `blue_red`, `blue_green`, `blue_white`, `white_red`, `white_green`, `white_blue`, `black_red`, `black_green`, `black_blue`, `black_white`, `red_black`, `green_black`, `blue_black`, `white_black`	-

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.set_range_pattern(1, 10, '3_colors')

`set_range_color`

지정한 픽셀 범위 전체에 동일한 색을 설정합니다. 두 가지 호출 방식이 있습니다.

색 이름 문자열: 색상 팔레트에서 선택한 색 이름(영문 문자열) 하나를 넘깁니다.
색상 카테고리 블록 / [R, G, B] 배열: Utils.color_rgb(...) 등의 색상 블록 출력을 *(별표)로 언팩하여 R/G/B 세 값으로 넘깁니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
from_idx	입력값 (필드)	시작 픽셀 번호 (1부터 시작)	1 이상 정수	-
to_idx	입력값 (필드)	끝 픽셀 번호 (1부터 시작)	1 이상 정수	-
r	색상	색 이름 문자열 (색상 팔레트에서 선택)	색 이름: `'black'`, `'red'`, `'yellow'`, `'green'`, `'cyan'`, `'blue'`, `'magenta'`, `'white'` 중 하나	-
r	입력값 (색상)	빨강 값 (색상 카테고리 블록의 `[R, G, B]` 출력을 풀어서 전달)	0 ~ 255 정수	-
g	입력값 (색상)	초록 값 (r 에 색 이름을 넣은 경우 생략)	0 ~ 255 정수	None
b	입력값 (색상)	파랑 값 (r 에 색 이름을 넣은 경우 생략)	0 ~ 255 정수	None

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()

# 색 이름으로 지정
neopixel.set_range_color(1, 10, 'red')

# 색상 카테고리 블록 / [R, G, B] 배열로 지정
neopixel.set_range_color(1, 10, *Utils.color_rgb(255, 0, 0))

`change_range_color`

지정한 픽셀 범위의 현재 색에 RGB 변화량을 더해 새로운 색을 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
from_idx	입력값 (필드)	시작 픽셀 번호 (1부터 시작)	1 이상 정수	-
to_idx	입력값 (필드)	끝 픽셀 번호 (1부터 시작)	1 이상 정수	-
r	입력값 (필드)	빨강 변화량	-255 ~ 255 정수	0
g	입력값 (필드)	초록 변화량	-255 ~ 255 정수	0
b	입력값 (필드)	파랑 변화량	-255 ~ 255 정수	0

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.change_range_color(1, 10, 10, 0, 0)

`turn_off_range`

지정한 픽셀 범위 전체 색을 끕니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
from_idx	입력값 (필드)	시작 픽셀 번호 (1부터 시작)	1 이상 정수	-
to_idx	입력값 (필드)	끝 픽셀 번호 (1부터 시작)	1 이상 정수	-

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.turn_off_range(1, 10)

`set_range_increment_color`

지정한 픽셀 범위 안에서 increment 칸마다 색을 설정합니다. (예: 1, 3, 5, ... 칸만 켜기) 두 가지 호출 방식이 있습니다.

색 이름 문자열: 색상 팔레트에서 선택한 색 이름(영문 문자열) 하나를 넘깁니다.
색상 카테고리 블록 / [R, G, B] 배열: Utils.color_rgb(...) 등의 색상 블록 출력을 *(별표)로 언팩하여 R/G/B 세 값으로 넘깁니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
from_idx	입력값 (필드)	시작 픽셀 번호 (1부터 시작)	1 이상 정수	-
to_idx	입력값 (필드)	끝 픽셀 번호 (1부터 시작)	1 이상 정수	-
increment	입력값 (필드)	간격 (칸 수)	1 이상 정수	-
r	색상	색 이름 문자열 (색상 팔레트에서 선택)	색 이름: `'black'`, `'red'`, `'yellow'`, `'green'`, `'cyan'`, `'blue'`, `'magenta'`, `'white'` 중 하나	-
r	입력값 (색상)	빨강 값 (색상 카테고리 블록의 `[R, G, B]` 출력을 풀어서 전달)	0 ~ 255 정수	-
g	입력값 (색상)	초록 값 (r 에 색 이름을 넣은 경우 생략)	0 ~ 255 정수	None
b	입력값 (색상)	파랑 값 (r 에 색 이름을 넣은 경우 생략)	0 ~ 255 정수	None

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()

# 색 이름으로 지정
neopixel.set_range_increment_color(1, 10, 2, 'red')

# 색상 카테고리 블록 / [R, G, B] 배열로 지정
neopixel.set_range_increment_color(1, 10, 2, *Utils.color_rgb(255, 0, 0))

`change_range_increment_color`

n 칸마다 픽셀들의 현재 색에 RGB 변화량을 더해 새로운 색을 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
from_idx	입력값 (필드)	시작 픽셀 번호 (1부터 시작)	1 이상 정수	-
to_idx	입력값 (필드)	끝 픽셀 번호 (1부터 시작)	1 이상 정수	-
increment	입력값 (필드)	증분 간격 (칸 수)	1 이상 정수	-
r	입력값 (필드)	빨강 변화량	-255 ~ 255 정수	0
g	입력값 (필드)	초록 변화량	-255 ~ 255 정수	0
b	입력값 (필드)	파랑 변화량	-255 ~ 255 정수	0

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.change_range_increment_color(1, 10, 2, 10, 0, 0)

`turn_off_range_increment`

지정한 픽셀 범위 안에서 n 칸마다 색을 끕니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
from_idx	입력값 (필드)	시작 픽셀 번호 (1부터 시작)	1 이상 정수	-
to_idx	입력값 (필드)	끝 픽셀 번호 (1부터 시작)	1 이상 정수	-
increment	입력값 (필드)	증분 간격 (칸 수)	1 이상 정수	-

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.turn_off_range_increment(1, 10, 2)

`shift`

NeoPixel 의 픽셀 색 배열을 지정한 방향으로 밀어냅니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
direction	드롭다운 옵션	방향	left, right	-
pixel	입력값 (필드)	이동할 픽셀 수	1 이상 정수	-

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.shift('left', 1)

`rotate`

NeoPixel 의 픽셀 색 배열을 지정한 방향으로 순환 회전시킵니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
direction	드롭다운 옵션	방향	left, right	-
pixel	입력값 (필드)	이동할 픽셀 수	1 이상 정수	-

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.rotate('left', 1)

`set_brightness`

NeoPixel 전체 밝기를 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
value	입력값 (필드)	밝기	0 ~ 100 정수	-

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.set_brightness(50)

`change_brightness`

현재 NeoPixel 밝기에 입력한 변화량을 더해 새로운 밝기를 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
value	입력값 (필드)	밝기 변화량	-100 ~ 100 정수	-

예제

cheesestick = CheeseStick(0)
neopixel = cheesestick.NeoPixel()
neopixel.change_brightness(10)

NeoPixel

NeoPixel (네오픽셀)

인스턴스 선언

함수

start

mode

set_one_color

change_one_color

turn_off_one

set_range_pattern

set_range_color

change_range_color

turn_off_range

set_range_increment_color

change_range_increment_color

turn_off_range_increment

shift

rotate

set_brightness

change_brightness

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

시작하기에 앞서

초보자를 위한 파이썬 설치 가이드

지원 라이브러리

공통

로봇

AI 확장모듈

치즈스틱 확장모듈

Clone this wiki locally

`start`

`mode`

`set_one_color`

`change_one_color`

`turn_off_one`

`set_range_pattern`

`set_range_color`

`change_range_color`

`turn_off_range`

`set_range_increment_color`

`change_range_increment_color`

`turn_off_range_increment`

`shift`

`rotate`

`set_brightness`

`change_brightness`