Niestandardowe kolory#

Wstęp#

Dron VEX AIR obsługuje niestandardowe kolory do rysowania i drukowania tekstu. Kolory niestandardowe można tworzyć za pomocą wartości RGB lub kodów szesnastkowych. Kolory niestandardowe obejmują również metody aktualizacji obiektów kolorów w trakcie projektu.

Poniżej znajduje się lista dostępnych konstruktorów:

Konstruktory – Utwórz nowy obiekt Color.

  • Color(value) – Tworzy kolor przy użyciu ciągu szesnastkowego (np. "#FFF700") lub liczby całkowitej szesnastkowej (np 0xFFF700).

  • Color(r, g, b) – Tworzy kolor przy użyciu wartości czerwonego, zielonego i niebieskiego.

Mutatory – aktualizują istniejący obiekt Color.

  • rgb – Ustawia utworzony obiekt koloru na nowy kolor przy użyciu wartości RGB.

  • hsv – Ustawia utworzony obiekt koloru na nowy kolor, używając wartości odcienia, nasycenia i jasności.

  • web – Ustawia utworzony obiekt koloru na nowy kolor, używając szesnastkowego ciągu kolorów (np. "#32C8B6").

Getter – zwraca wartość odcienia lub nasycenia obiektu koloru.

  • saturation – Zwraca wartość nasycenia dla niestandardowego koloru.

  • hue – Zwraca wartość odcienia dla niestandardowego koloru.

Tworzenie niestandardowego koloru#

Aby użyć niestandardowego koloru, należy najpierw utworzyć obiekt Color korzystając z jednego z następujących konstruktorów:

Hexadecimal String#

Tworzy kolor przy użyciu internetowego ciągu kolorów (kod szesnastkowy).

Usage:
Color(value)

Parametr

Opis

value

Sześciocyfrowy kod szesnastkowy w postaci ciągu znaków (np. “#FF700” dla koloru żółtego).

# Construct a yellow Color "yellow" using a
# hexadecimal string
yellow = Color("#FFF700")

controller.screen.set_pen_color(yellow)
controller.screen.print("My Yellow")

Hexadecimal Integer#

Tworzy kolor przy użyciu sześciocyfrowej liczby szesnastkowej.

Usage:
Color(value)

Parametr

Opis

value

Sześciocyfrowa liczba całkowita w formacie szesnastkowym (np. 0xFFF700 dla koloru żółtego).

# Construct a yellow Color "yellow" using a
# hexadecimal integer
yellow = Color(0xFFF700)

controller.screen.set_pen_color(yellow)
controller.screen.print("My Yellow")

RGB#

Tworzy kolor używając oddzielnych wartości czerwonego, zielonego i niebieskiego.

Usage:
Color(r, g, b)

Parametr

Opis

r

Liczba całkowita od 0 do 255 reprezentująca składnik czerwony.

g

Liczba całkowita od 0 do 255 reprezentująca składnik zielony.

b

Liczba całkowita od 0 do 255 reprezentująca składnik niebieski.

# Construct a yellow Color "yellow" using
# RGB values
yellow = Color(255, 247, 0)

controller.screen.set_pen_color(yellow)
controller.screen.print("My Yellow")

Mutatory#

Te metody aktualizują kolor istniejącego obiektu o wartości Color Aby z nich skorzystać, należy przypisać zmiennej wartość Color podczas jej tworzenia, a następnie wywołać metodę w celu zmiany jej koloru.

rgb#

rgb aktualizuje kolor istniejącego obiektu Color przy użyciu wartości RGB.

Usage:
variable_name.rgb(r, g, b)

Parametry

Opis

r

Liczba całkowita od 0 do 255 reprezentująca czerwoną składową koloru.

g

Liczba całkowita od 0 do 255 reprezentująca zieloną składową koloru.

b

Liczba całkowita od 0 do 255 reprezentująca niebieską składową koloru.

# Create a custom teal color
my_fill_color = Color(50, 200, 180)

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.rgb(170, 40, 150)
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

hsv#

hsv aktualizuje kolor istniejącego obiektu Color przy użyciu wartości HSV.

Uwaga: hsv można użyć tylko do zmiany obiektu Color , który został już utworzony. Nie można go użyć do utworzenia nowego obiektu Color.

Usage:
variable_name.hsv(h, s, v)

Parametry

Opis

h

Liczba całkowita od 0 do 359 określająca odcień koloru.

s

Liczba zmiennoprzecinkowa od 0,0 do 1,0 reprezentująca nasycenie koloru.

v

Liczba zmiennoprzecinkowa od 0,0 do 1,0 reprezentująca jasność koloru.

# Create a custom teal color
my_fill_color = Color(50, 200, 180)

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.hsv(300, 0.75, 0.78)
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

web#

web aktualizuje kolor istniejącego obiektu Color , używając koloru internetowego (kod szesnastkowy).

Usage:
variable_name.web(value)

Parametry

Opis

value

Kolor internetowy jako ciąg znaków (kod szesnastkowy) (np. “#FFF700”).

# Create a custom teal color
my_fill_color = Color("#32C8B6")

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.web("#AA2896")
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

Getters#

saturation#

saturation zwraca wartość nasycenia dla niestandardowego koloru jako liczbę zmiennoprzecinkową od 0 do 1.

Usage:
my_color.saturation()

Zastąp my_color nazwą obiektu niestandardowego koloru.

Parametry

Opis

Ta metoda nie ma żadnych parametrów.

# Create a custom teal color
color_teal = Color(50, 200, 180)

# Display the saturation value of teal
controller.screen.print(color_teal.saturation())

hue#

hue zwraca wartość odcienia dla niestandardowego koloru jako liczbę zmiennoprzecinkową od 0 do 359.

Usage:
my_color.hue()

Zastąp my_color nazwą obiektu niestandardowego koloru.

Parametry

Opis

Ta metoda nie ma żadnych parametrów.

# Create a custom teal color
color_teal = Color(50, 200, 180)

# Display the hue value of teal
controller.screen.print(color_teal.hue())