Skip to content

NeoPixel

Jump to bottom
Robomation RnD Center edited this page Jul 8, 2026 · 1 revision

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)

시작하기에 앞서

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

지원 라이브러리

공통

로봇

AI 확장모듈

치즈스틱 확장모듈

Clone this wiki locally