Anpassade färger#

Introduktion#

VEX AIR Drone stöder användning av anpassade färger för att rita och skriva ut text. Anpassade färger kan skapas med hjälp av RGB-värden eller hex-koder. Anpassade färger inkluderar även metoder för att uppdatera färgobjekt under ett projekt.

Nedan följer en lista över tillgängliga konstruktörer:

Konstruktörer – Skapa ett nytt objekt med Color.

  • Color(value) – Skapar en färg med hjälp av en hexagonal sträng (t.ex. "#FFF700") eller ett hexagonalt heltal (t.ex. 0xFFF700).

  • Color(r, g, b) – Skapar en färg med hjälp av röda, gröna och blå värden.

Mutatorer – Uppdatera ett befintligt Color-objekt.

  • rgb – Ställer in ett skapat färgobjekt till en ny färg med hjälp av RGB-värden.

  • hsv – Ställer in ett skapat färgobjekt till en ny färg med hjälp av värden för nyans, mättnad och ljusstyrka.

  • web – Ställer in ett skapat färgobjekt till en ny färg med hjälp av en hexagonal färgsträng för webben (t.ex. "#32C8B6").

Getters – Returnerar ett färgobjekts nyans- eller mättnadsvärde.

  • saturation – Returnerar mättnadsvärdet för en anpassad färg.

  • hue – Returnerar nyansvärdet för en anpassad färg.

Skapa en anpassad färg#

För att använda en anpassad färg måste du först skapa ett Color objekt med hjälp av en av följande konstruktorer:

Hexadecimal String#

Skapar en färg med hjälp av en webbfärgssträng (hexkod).

Usage:
Color(value)

Parameter

Beskrivning

value

En sexsiffrig hexadecimal kod som en sträng (t.ex. “#FF700” för gul).

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

Skapar en färg med hjälp av ett sexsiffrigt hexadecimalt heltal.

Usage:
Color(value)

Parameter

Beskrivning

value

Ett sexsiffrigt heltal i hexadecimalt format (t.ex. 0xFFF700 för gult).

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

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

RGB#

Skapar en färg med separata värden för rött, grönt och blått.

Usage:
Color(r, g, b)

Parameter

Beskrivning

r

Ett heltal från 0 till 255 som representerar den röda komponenten.

g

Ett heltal från 0 till 255 som representerar den gröna komponenten.

b

Ett heltal från 0 till 255 som representerar den blå komponenten.

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

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

Mutatorer#

Dessa metoder uppdaterar färgen på ett befintligt objekt med Color För att använda dem, tilldela en variabel med Color när du skapar den och anropa sedan metoden på den variabeln för att ändra dess färg.

rgb#

rgb uppdaterar färgen på ett befintligt Color objekt med hjälp av RGB-värden.

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

Parametrar

Beskrivning

r

Ett heltal från 0 till 255 som representerar den röda komponenten av färgen.

g

Ett heltal från 0 till 255 som representerar den gröna komponenten av färgen.

b

Ett heltal från 0 till 255 som representerar den blå komponenten av färgen.

# 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 uppdaterar färgen på ett befintligt Color objekt med hjälp av HSV-värden.

Obs! hsv kan bara användas för att ändra ett Color -objekt som redan har skapats. Det kan inte användas för att skapa ett nytt Color -objekt.

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

Parametrar

Beskrivning

h

Ett heltal från 0 till 359 som representerar färgens nyans.

s

Ett flyttal från 0,0 till 1,0 som representerar färgens mättnad.

v

Ett flyttal från 0,0 till 1,0 som representerar färgens ljusstyrka.

# 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 uppdaterar färgen på ett befintligt Color objekt med hjälp av en webbfärg (hex-kod).

Usage:
variable_name.web(value)

Parametrar

Beskrivning

value

En webbfärg som en sträng (hexkod) (t.ex. “#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 returnerar mättnadsvärdet för en anpassad färg som ett flyttal från 0 till 1.

Usage:
my_color.saturation()

Ersätt my_color med namnet på det anpassade färgobjektet.

Parametrar

Beskrivning

Den här metoden har inga parametrar.

# 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 returnerar nyansvärdet för en anpassad färg som ett flyttal från 0 till 359.

Usage:
my_color.hue()

Ersätt my_color med namnet på det anpassade färgobjektet.

Parametrar

Beskrivning

Den här metoden har inga parametrar.

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

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