Couleurs personnalisées#

Introduction #

Le drone VEX AIR prend en charge l’utilisation de couleurs personnalisées pour le dessin et l’impression de texte. Ces couleurs peuvent être créées à l’aide de valeurs RVB ou de codes hexadécimaux. Elles incluent également des méthodes permettant de mettre à jour les objets de couleur au cours d’un projet.

Vous trouverez ci-dessous la liste des constructeurs disponibles :

Constructeurs – Créez un nouvel objet Color.

Color(value) – Crée une couleur à l’aide d’une chaîne hexadécimale (par exemple "#FFF700") ou d’un entier hexadécimal (par exemple 0xFFF700).
Color(r, g, b) – Crée une couleur en utilisant les valeurs rouge, verte et bleue.

Mutateurs – Mettre à jour un objet Color existant.

rgb – Définit un objet couleur créé sur une nouvelle couleur en utilisant les valeurs RGB.
hsv – Définit une nouvelle couleur pour un objet couleur créé en utilisant les valeurs de teinte, de saturation et de luminosité.
web – Définit un objet couleur créé sur une nouvelle couleur en utilisant une chaîne de couleur hexadécimale web (par exemple "#32C8B6").

Accesseurs – Renvoient la teinte ou la valeur de saturation d’un objet couleur.

saturation – Renvoie la valeur de saturation pour une couleur personnalisée.
hue – Renvoie la valeur de teinte pour une couleur personnalisée.

Création d’une couleur personnalisée #

Pour utiliser une couleur personnalisée, vous devez d’abord créer un objet Color en utilisant l’un des constructeurs suivants :

Hexadecimal String #

Crée une couleur à partir d’une chaîne de couleurs web (code hexadécimal).

Usage:
Color(value)

Paramètre	Description
`value`	Un code hexadécimal à six chiffres sous forme de chaîne de caractères (par exemple, `“#FF700”` pour jaune).

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

Crée une couleur à l’aide d’un entier hexadécimal à six chiffres.

Usage:
Color(value)

Paramètre	Description
`value`	Un entier à six chiffres au format hexadécimal (par exemple, `0xFFF700` pour jaune).

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

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

RGB #

Crée une couleur à partir de valeurs distinctes de rouge, de vert et de bleu.

Usage:
Color(r, g, b)

Paramètre	Description
`r`	Un entier compris entre 0 et 255 représentant la composante rouge.
`g`	Un entier compris entre 0 et 255 représentant la composante verte.
`b`	Un entier compris entre 0 et 255 représentant la composante bleue.

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

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

Mutateurs #

Ces méthodes mettent à jour la couleur d’un objet Color existant. Pour les utiliser, assignez une couleur Color à une variable lors de sa création, puis appelez la méthode sur cette variable pour modifier sa couleur.

rgb #

rgb met à jour la couleur d’un objet Color existant en utilisant les valeurs RGB.

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

Paramètres	Description
`r`	Un entier compris entre 0 et 255 représentant la composante rouge de la couleur.
`g`	Un entier compris entre 0 et 255 représentant la composante verte de la couleur.
`b`	Un entier compris entre 0 et 255 représentant la composante bleue de la couleur.

# 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 met à jour la couleur d’un objet Color existant en utilisant les valeurs HSV.

Remarque : hsv ne peut être utilisé que pour modifier un objet Color déjà créé. Il ne peut pas être utilisé pour créer un nouvel objet Color.

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

Paramètres	Description
`h`	Un entier compris entre 0 et 359 représentant la teinte de la couleur.
`s`	Un nombre flottant compris entre 0,0 et 1,0 représentant la saturation de la couleur.
`v`	Un nombre flottant compris entre 0,0 et 1,0 représentant la luminosité de la couleur.

# 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 met à jour la couleur d’un objet Color existant en utilisant une couleur web (code hexadécimal).

Usage:
variable_name.web(value)

Paramètres	Description
`value`	Une couleur web sous forme de chaîne (code hexadécimal) (par exemple, `“#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 #

La fonction saturation renvoie la valeur de saturation d’une couleur personnalisée sous forme de nombre flottant compris entre 0 et 1.

Usage:
my_color.saturation()

Remplacez my_color par le nom de l’objet de couleur personnalisée.

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

# 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 renvoie la valeur de teinte d’une couleur personnalisée sous forme de nombre flottant compris entre 0 et 359.

Usage:
my_color.hue()

Remplacez my_color par le nom de l’objet de couleur personnalisée.

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

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

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