Sonderfarben#

Einführung #

Die VEX AIR Drone unterstützt die Verwendung benutzerdefinierter Farben zum Zeichnen und Drucken von Text. Benutzerdefinierte Farben können mithilfe von RGB-Werten oder Hexadezimalcodes erstellt werden. Zudem bieten sie Methoden zum Aktualisieren von Farbobjekten während eines Projekts.

Nachfolgend finden Sie eine Liste der verfügbaren Konstruktoren:

Konstruktoren – Erzeugen Sie ein neues Objekt mit den Eigenschaften Color Farbe.

Color(value) – Erzeugt eine Farbe mithilfe einer Hexadezimalzeichenfolge (z. B. "#FFF700") oder einer Hexadezimalzahl (z. B. 0xFFF700).
Color(r, g, b) – Erzeugt eine Farbe unter Verwendung von Rot-, Grün- und Blauwerten.

Mutatoren – Aktualisieren ein bestehendes Color-Objekt.

rgb – Setzt ein erstelltes Farbobjekt auf eine neue Farbe unter Verwendung von RGB-Werten.
hsv – Setzt ein erstelltes Farbobjekt auf eine neue Farbe unter Verwendung von Farbton-, Sättigungs- und Helligkeitswerten.
web – Setzt ein erstelltes Farbobjekt auf eine neue Farbe mithilfe einer Web-Hex-Farbzeichenfolge (z. B. "#32C8B6").

Getter – Geben den Farbton- oder Sättigungswert eines Farbobjekts zurück.

saturation – Gibt den Sättigungswert für eine benutzerdefinierte Farbe zurück.
hue – Gibt den Farbtonwert für eine benutzerdefinierte Farbe zurück.

Erstellen einer benutzerdefinierten Farbe #

Um eine benutzerdefinierte Farbe zu verwenden, müssen Sie zuerst ein Color Objekt mit einem der folgenden Konstruktoren erstellen:

Hexadecimal String #

Erzeugt eine Farbe mithilfe einer Webfarbzeichenfolge (Hexadezimalcode).

Usage:
Color(value)

Parameter	Beschreibung
`value`	Ein sechsstelliger Hexadezimalcode als Zeichenkette (z. B. `“#FF700”` für gelb).

# 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 #

Erzeugt eine Farbe mithilfe einer sechsstelligen Hexadezimalzahl.

Usage:
Color(value)

Parameter	Beschreibung
`value`	Eine sechsstellige ganze Zahl im Hexadezimalformat (z. B. `0xFFF700` für Gelb).

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

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

RGB #

Erzeugt eine Farbe unter Verwendung separater Rot-, Grün- und Blauwerte.

Usage:
Color(r, g, b)

Parameter	Beschreibung
`r`	Eine ganze Zahl von 0 bis 255, die die Rotkomponente darstellt.
`g`	Eine ganze Zahl von 0 bis 255, die die grüne Komponente darstellt.
`b`	Eine ganze Zahl von 0 bis 255, die die blaue Komponente darstellt.

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

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

Mutatoren #

Diese Methoden aktualisieren die Farbe eines bestehenden Objekts vom Typ Color Um sie zu verwenden, weisen Sie einer Variablen beim Erstellen des Objekts den Wert Color zu und rufen Sie anschließend die Methode für diese Variable auf, um ihre Farbe zu ändern.

rgb #

rgb aktualisiert die Farbe eines vorhandenen Color Objekts unter Verwendung von RGB-Werten.

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

Parameter	Beschreibung
`r`	Eine ganze Zahl von 0 bis 255, die den Rotanteil der Farbe darstellt.
`g`	Eine ganze Zahl von 0 bis 255, die den Grünanteil der Farbe darstellt.
`b`	Eine ganze Zahl von 0 bis 255, die den Blauanteil der Farbe darstellt.

# 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 aktualisiert die Farbe eines vorhandenen Color Objekts unter Verwendung von HSV-Werten.

Hinweis: hsv kann nur ein bereits erstelltes Color -Objekt geändert werden. Es kann nicht verwendet werden, um ein neues Color -Objekt zu erstellen.

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

Parameter	Beschreibung
`h`	Eine ganze Zahl von 0 bis 359, die den Farbton angibt.
`s`	Ein Gleitkommawert zwischen 0,0 und 1,0, der die Farbsättigung angibt.
`v`	Ein Gleitkommawert zwischen 0,0 und 1,0, der die Helligkeit der Farbe angibt.

# 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 aktualisiert die Farbe eines vorhandenen Color Objekts mithilfe einer Webfarbe (Hex-Code).

Usage:
variable_name.web(value)

Parameter	Beschreibung
`value`	Eine Webfarbe als Zeichenkette (Hexadezimalcode) (z. B. `“#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)

Getter #

saturation #

saturation gibt den Sättigungswert für eine benutzerdefinierte Farbe als Gleitkommazahl von 0 bis 1 zurück.

Usage:
my_color.saturation()

Ersetzen Sie my_color durch den Namen des benutzerdefinierten Farbobjekts.

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

# 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 gibt den Farbtonwert für eine benutzerdefinierte Farbe als Gleitkommazahl von 0 bis 359 zurück.

Usage:
my_color.hue()

Ersetzen Sie my_color durch den Namen des benutzerdefinierten Farbobjekts.

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

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

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